658c508925
agent_manager.py (new): - AgentRecord dataclass: agent_id, level (1/2/3), role, task, status, started, parent_id (lineage), finished, result, notify, _task_ref - register() / finish() / cancel_agent() / list_agents() / get() / set_task_ref() - Calls notification.notify() on completion when notify=True (same channel as reminders and cron completions) - 24-hour pruning of completed records on each new registration spawn_agent (tools/agents.py): - background=True: fires asyncio.create_task(), registers in agent_manager, returns agent_id string immediately — sync path unchanged (no regression) - notify=True: push/Talk notification when the background task completes - Level enforcement: _agent_level param tracks hierarchy depth; when spawning from Level 2, child automatically gets spawn_agent + aider_run denied so Level 3 agents cannot delegate further New lifecycle tools (tools/agents.py + __init__.py): - agent_status(agent_id) — status, role, level, elapsed, task, result preview; user-level - agent_list(status, limit) — all agents for current user, newest first; user-level - agent_cancel(agent_id) — kills background task; admin-only, confirm-required tests/test_agent_manager.py (new, 41 tests): - agent_manager CRUD, pruning, notification hook - spawn_agent background: returns immediately, completes async, timeout, failure - Level enforcement: L1→L2 permits spawn, L2→L3 auto-denies; explicit tool_list path - agent_status / agent_list / agent_cancel output formatting - aider_run background: returns agent_id, completes async, sync path unchanged - All tests run without browser or Cortex service (~2.5s total) Run: cd cortex && .venv/bin/python -m pytest tests/test_agent_manager.py -v Docs: ARCH__FUTURE.md §13 (full design), ROADMAP.md, TODO__Agents.md, MASTER.md, HELP.md (orchestrator description corrected, tool schema line updated to reflect keyword routing), CLAUDE.md tool count 66→69. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
4.3 KiB
4.3 KiB
Cortex — Roadmap
Phases and priorities. For active tasks see
TODO__Agents.md. Last updated: 2026-05-09
Phase 0 — Foundation ✅
- Syncthing fleet sync (
agents_sync/) operational - MCP tools (
ae_*) available in all Claude Code sessions - Fleet agents running independently on each machine
Phase 1 — Dispatcher Core ✅
- FastAPI service with streaming SSE responses
- Claude CLI and Gemini CLI subprocess backends
- Session context management (rolling window, file persistence)
- Nextcloud Talk bot (HMAC-signed webhook)
- Memory distiller (APScheduler — short/mid/long cycles)
- Local web UI (single-page, mobile-responsive)
- Auth status monitoring (
/auth/status, UI banner) - Session logging and file browser
Phase 2 — Identity & Multi-User ✅
- Inara persona formalized (
IDENTITY.md,SOUL.md,PROTOCOLS.md, context tiers) - Two-level user/persona layout (
home/{user}/persona/{name}/) - Session auth: bcrypt passwords, JWT cookies, invite tokens, Google OAuth
- Multi-user live: Scott, Holly, Brian
- Per-user channel config (
channels.json) - Per-user Gemini API key (settings UI)
- Help & Reference system (shared base + per-persona additions)
- Lucide icons, persona picker page, session persistence across navigation
Phase 3 — Intelligence Layer (In Progress)
- ✅ Gemini API orchestrator (tool loop → Claude responder)
- ✅ Tool suite: web search, AE Journal read/write, tasks, scratch, reminders, cron, system, email_send (+ per-user allowlist), nc_talk_send
- ✅ Agent mode in UI (async job, poll for result); role-based tool access + confirmation gate
- ✅ Local LLM backend (Open WebUI/Ollama, per-user multi-model config); inline model edit in registry UI
- ✅ Proactive cron (
message/briefjob types → NC Talk) - ✅ Session search (full-text across past session logs)
- ✅ Distill notifications (NC Talk after mid/long runs)
- ✅ Local backend for distillation (DISTILL_BACKEND_MID/LONG in .env)
- ✅ Local orchestrator — OpenAI-compatible ReAct loop; fires when orchestrator role → local model
- ✅ Web push notifications — VAPID;
web_pushtool; PWA-installable; subscribe via ☰ menu - ✅ Proactive notifications — daily reminder check (09:00);
notify()routes to any configured channel; dedicated settings page - ✅ Sub-agent spawning —
spawn_agenttool; per-host concurrency limit; Gemini API + local OpenAI backends - ✅ Web content extraction —
web_readvia trafilatura; strips ads/nav/boilerplate; 128K cap - ✅ Session log reader —
session_read(date)tool; complementssession_search - ✅
http_post— POST to external URLs with per-user URL prefix allowlist; admin-only, confirm-required - ✅
nc_talk_history— read recent NC Talk messages; requires nc_username + nc_app_password in channels.json - ✅ Local orchestrator retry — exponential backoff on 429/5xx/connection errors (3 attempts)
- ✅ Multi-level agent management —
agent_manager.py(registry + lifecycle), backgroundspawn_agent,agent_status/agent_list/agent_canceltools, 3-level hierarchy enforcement (seeARCH__FUTURE.md§13) - ✅
aider_runbackground mode — background task + push notification on completion; sync path unchanged - Knowledge import — markdown → AE Journals (import script)
- Dev agent pipeline — specialist agents + supervisor + approval gate
- Gitea webhook integration + Actions CI
Phase 4 — Channel Expansion
- ✅ Web UI
- ✅ Nextcloud Talk
- ✅ Google Chat
- WhatsApp (Business API or bridge — investigating)
- Webhook triggers from Aether platform events
Phase 5 — Routing Intelligence & Scale
- Intelligent model routing (by task type, privacy, context length)
- Agent-to-agent task delegation across fleet
Phase 6 — Infrastructure
- Server DMZ finalized
- WireGuard for all Cortex-accessing devices
- Camera/IoT VLAN segmentation
Deferred / Watching
- Speculative decoding — llama.cpp supports it (E4B + E2B draft ≈ 2x speed); Ollama does not yet
- RAG via Open WebUI — feed Nextcloud docs into local knowledge collections; possible complement to AE Journals search
- Multi-host local models — per-user config already supports multiple hosts; routing logic TBD
- WhatsApp — requires Business API account or a bridge; not started