toga-ai 1.0.92 → 1.0.93

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/knowledge/2.0/apps/talos/INDEX.md +2 -2
  2. package/knowledge/2.0/apps/talos/architecture.md +5 -5
  3. package/knowledge/2.0/apps/talos/features/mcp-servers.md +2 -2
  4. package/knowledge/2.0/apps/talos/features/{react-agent.md → talos-agent.md} +37 -36
  5. package/package.json +1 -1
package/knowledge/2.0/apps/talos/INDEX.md CHANGED
@@ -2,9 +2,9 @@
2
2
 
3
3
  | Doc | Summary | Files |
4
4
  |-----|---------|-------|
5
- | [TOGa IQ (talos) Architecture](architecture.md) | **TOGa IQ** is TOGA Technology's AI agent platform. | talos/libs/aegra-api/src/aegra_api/main.py, talos/libs/aegra-api/src/aegra_api/settings.py, talos/libs/aegra-api/src/aegra_api/config.py, talos/libs/aegra-api/src/aegra_api/core/tenant_router.py, talos/libs/aegra-api/src/aegra_api/core/control_plane_db.py, talos/libs/aegra-api/src/aegra_api/core/auth_middleware.py, talos/libs/aegra-api/src/aegra_api/services/run_executor.py, talos/libs/aegra-api/src/aegra_api/services/langgraph_service.py, talos/libs/aegra-api/src/aegra_api/services/graph_factory.py, talos/libs/aegra-api/src/aegra_api/services/streaming_service.py, talos/examples/react_agent/graph.py, talos/docker-compose.yml, talos/deployments/docker/Dockerfile |
5
+ | [TOGa IQ (talos) Architecture](architecture.md) | **TOGa IQ** is TOGA Technology's AI agent platform. | talos/libs/aegra-api/src/aegra_api/main.py, talos/libs/aegra-api/src/aegra_api/settings.py, talos/libs/aegra-api/src/aegra_api/config.py, talos/libs/aegra-api/src/aegra_api/core/tenant_router.py, talos/libs/aegra-api/src/aegra_api/core/control_plane_db.py, talos/libs/aegra-api/src/aegra_api/core/auth_middleware.py, talos/libs/aegra-api/src/aegra_api/services/run_executor.py, talos/libs/aegra-api/src/aegra_api/services/langgraph_service.py, talos/libs/aegra-api/src/aegra_api/services/graph_factory.py, talos/libs/aegra-api/src/aegra_api/services/streaming_service.py, talos/agents/talos_agent/graph.py, talos/docker-compose.yml, talos/deployments/docker/Dockerfile |
6
6
  | [aegra-api — Agent Protocol HTTP + Execution Pipeline](features/aegra-api.md) | `aegra-api` is the **FastAPI Agent Protocol server** at the heart of TOGa IQ. | talos/libs/aegra-api/src/aegra_api/main.py, talos/libs/aegra-api/src/aegra_api/settings.py, talos/libs/aegra-api/src/aegra_api/config.py, talos/libs/aegra-api/src/aegra_api/api/assistants.py, talos/libs/aegra-api/src/aegra_api/api/threads.py, talos/libs/aegra-api/src/aegra_api/api/runs.py, talos/libs/aegra-api/src/aegra_api/api/store.py, talos/libs/aegra-api/src/aegra_api/api/mcp.py, talos/libs/aegra-api/src/aegra_api/api/knowledge_bases.py, talos/libs/aegra-api/src/aegra_api/core/auth_middleware.py, talos/libs/aegra-api/src/aegra_api/core/auth_deps.py, talos/libs/aegra-api/src/aegra_api/core/tenant_router.py, talos/libs/aegra-api/src/aegra_api/core/control_plane_db.py, talos/libs/aegra-api/src/aegra_api/core/redis_manager.py, talos/libs/aegra-api/src/aegra_api/core/encryption.py, talos/libs/aegra-api/src/aegra_api/middleware/content_type_fix.py, talos/libs/aegra-api/src/aegra_api/middleware/rate_limiter.py, talos/libs/aegra-api/src/aegra_api/middleware/logger_middleware.py, talos/libs/aegra-api/src/aegra_api/services/broker.py, talos/libs/aegra-api/src/aegra_api/services/redis_broker.py, talos/libs/aegra-api/src/aegra_api/services/executor.py, talos/libs/aegra-api/src/aegra_api/services/local_executor.py, talos/libs/aegra-api/src/aegra_api/services/worker_executor.py, talos/libs/aegra-api/src/aegra_api/services/run_executor.py, talos/libs/aegra-api/src/aegra_api/services/langgraph_service.py, talos/libs/aegra-api/src/aegra_api/services/graph_factory.py, talos/libs/aegra-api/src/aegra_api/services/graph_streaming.py, talos/libs/aegra-api/src/aegra_api/services/streaming_service.py, talos/libs/aegra-api/src/aegra_api/services/event_store.py, talos/libs/aegra-api/alembic/env.py |
7
7
  | [Deployment — Docker, Compose, Entrypoint, External PG/Redis](features/deployment.md) | TOGa IQ ships as a **single container** (`aegra` service) wrapping the `aegra-api` FastAPI server. | talos/docker-compose.yml, talos/deployments/docker/Dockerfile, talos/deployments/docker/entrypoint.sh |
8
8
  | [MCP Servers — clickup-mcp and toga-db-mcp](features/mcp-servers.md) | Two internal **FastMCP** servers exposed over **HTTP** with API-key auth and PM2 process management: - **`clickup-mcp`** — ClickUp workspace surface (spaces / f | talos/mcp-servers/clickup-mcp/src, talos/mcp-servers/clickup-mcp/ecosystem.config.js, talos/mcp-servers/clickup-mcp/ecosystem.dev.config.js, talos/mcp-servers/clickup-mcp/pyproject.toml, talos/mcp-servers/clickup-mcp/.env.example, talos/mcp-servers/toga-db-mcp/src, talos/mcp-servers/toga-db-mcp/clusters.yaml, talos/mcp-servers/toga-db-mcp/ecosystem.config.js, talos/mcp-servers/toga-db-mcp/pyproject.toml, talos/mcp-servers/toga-db-mcp/.env.example |
9
9
  | [Observability — Langfuse, OTEL, Prometheus, OneUptime](features/observability.md) | TOGa IQ uses **two complementary tracing planes** plus optional Prometheus metrics and external uptime monitoring: - **Langfuse (native v3 SDK)** — LLM-shaped t | talos/libs/aegra-api/src/aegra_api/observability/__init__.py, talos/libs/aegra-api/src/aegra_api/observability/setup.py, talos/libs/aegra-api/src/aegra_api/observability/base.py, talos/libs/aegra-api/src/aegra_api/observability/langfuse_provider.py, talos/libs/aegra-api/src/aegra_api/observability/langfuse_client.py, talos/libs/aegra-api/src/aegra_api/observability/otel.py, talos/libs/aegra-api/src/aegra_api/observability/metrics.py, talos/libs/aegra-api/src/aegra_api/observability/span_enrichment.py, talos/libs/aegra-api/src/aegra_api/observability/targets |
10
- | [react_agent — LangGraph ReAct Agent with Plan, BLP, MCP, Canvas](features/react-agent.md) | `react_agent` is the **reference LangGraph agent** shipped under `examples/react_agent/`. | talos/examples/react_agent/graph.py, talos/examples/react_agent/state.py, talos/examples/react_agent/context.py, talos/examples/react_agent/prompts.py, talos/examples/react_agent/tool_router.py, talos/examples/react_agent/model_helpers.py, talos/examples/react_agent/config/context.py, talos/examples/react_agent/config/model_config.py, talos/examples/react_agent/config/tool_config.py, talos/examples/react_agent/config/plan_config.py, talos/examples/react_agent/config/memory_config.py, talos/examples/react_agent/config/mcp_config.py, talos/examples/react_agent/config/blp_config.py, talos/examples/react_agent/config/interrupt_config.py, talos/examples/react_agent/config/artifact_config.py, talos/examples/react_agent/plan/planner.py, talos/examples/react_agent/plan/nodes.py, talos/examples/react_agent/llm/system_prompt.py, talos/examples/react_agent/llm/tool_binding.py, talos/examples/react_agent/llm/message_ops.py, talos/examples/react_agent/mcp/client.py, talos/examples/react_agent/mcp/security.py, talos/examples/react_agent/mcp/session_manager.py, talos/examples/react_agent/blp/registry.py, talos/examples/react_agent/blp/embedder.py, talos/examples/react_agent/blp/nodes.py, talos/examples/react_agent/tools/__init__.py, talos/examples/react_agent/tools/code_interpreter.py, talos/examples/react_agent/tools/canvas.py, talos/examples/react_agent/tools/knowledge_base.py, talos/examples/react_agent/tools/skill_injector.py, talos/examples/react_agent/thread_name/nodes.py |
10
+ | [talos_agent — LangGraph ReAct Agent with Plan, BLP, MCP, Canvas](features/talos-agent.md) | `talos_agent` is the **reference LangGraph agent** shipped under `agents/talos_agent/`. | talos/agents/talos_agent/graph.py, talos/agents/talos_agent/state.py, talos/agents/talos_agent/context.py, talos/agents/talos_agent/prompts.py, talos/agents/talos_agent/tool_router.py, talos/agents/talos_agent/model_helpers.py, talos/agents/talos_agent/config/context.py, talos/agents/talos_agent/config/model_config.py, talos/agents/talos_agent/config/tool_config.py, talos/agents/talos_agent/config/plan_config.py, talos/agents/talos_agent/config/memory_config.py, talos/agents/talos_agent/config/mcp_config.py, talos/agents/talos_agent/config/blp_config.py, talos/agents/talos_agent/config/interrupt_config.py, talos/agents/talos_agent/config/artifact_config.py, talos/agents/talos_agent/plan/planner.py, talos/agents/talos_agent/plan/nodes.py, talos/agents/talos_agent/llm/system_prompt.py, talos/agents/talos_agent/llm/tool_binding.py, talos/agents/talos_agent/llm/message_ops.py, talos/agents/talos_agent/mcp/client.py, talos/agents/talos_agent/mcp/security.py, talos/agents/talos_agent/mcp/session_manager.py, talos/agents/talos_agent/blp/registry.py, talos/agents/talos_agent/blp/embedder.py, talos/agents/talos_agent/blp/nodes.py, talos/agents/talos_agent/tools/__init__.py, talos/agents/talos_agent/tools/code_interpreter.py, talos/agents/talos_agent/tools/canvas.py, talos/agents/talos_agent/tools/knowledge_base.py, talos/agents/talos_agent/tools/skill_injector.py, talos/agents/talos_agent/thread_name/nodes.py |
package/knowledge/2.0/apps/talos/architecture.md CHANGED
@@ -19,12 +19,12 @@ files:
19
19
  - talos/libs/aegra-api/src/aegra_api/services/langgraph_service.py
20
20
  - talos/libs/aegra-api/src/aegra_api/services/graph_factory.py
21
21
  - talos/libs/aegra-api/src/aegra_api/services/streaming_service.py
22
- - talos/examples/react_agent/graph.py
22
+ - talos/agents/talos_agent/graph.py
23
23
  - talos/docker-compose.yml
24
24
  - talos/deployments/docker/Dockerfile
25
25
  related:
26
26
  - features/aegra-api.md
27
- - features/react-agent.md
27
+ - features/talos-agent.md
28
28
  - features/mcp-servers.md
29
29
  - features/observability.md
30
30
  - features/deployment.md
@@ -56,7 +56,7 @@ talos/
56
56
  │ │ ├── observability/ # Langfuse native + OTEL providers, Prometheus
57
57
  │ │ └── main.py # FastAPI app factory + lifespan
58
58
  │ └── alembic/ # 20 schema migrations (Jan 2025 → Mar 2026)
59
- ├── examples/react_agent/ # Reference LangGraph agent (graph, plan, tools, blp, mcp)
59
+ ├── agents/talos_agent/ # Reference LangGraph agent (graph, plan, tools, blp, mcp)
60
60
  ├── mcp-servers/
61
61
  │ ├── clickup-mcp/ # ClickUp HTTP MCP (PM2-managed, ports 8200/8201)
62
62
  │ └── toga-db-mcp/ # Multi-cluster MySQL read MCP (port 8000)
@@ -75,10 +75,10 @@ talos/
75
75
  Redis BLPOP worker queue with lease-based crash recovery. SSE replay is
76
76
  backed by an in-memory ring + Postgres `run_events` table. See
77
77
  `features/aegra-api.md`.
78
- 3. **Reference agent (LangGraph)** — `examples/react_agent`. A ReAct graph with
78
+ 3. **Reference agent (LangGraph)** — `agents/talos_agent`. A ReAct graph with
79
79
  optional planner gate, tool router, BLP semantic context selection,
80
80
  running-summary memory, canvas artifacts, code-interpreter offload, and MCP
81
- passthrough. See `features/react-agent.md`.
81
+ passthrough. See `features/talos-agent.md`.
82
82
  4. **MCP fleet** — `clickup-mcp` and `toga-db-mcp`. Both FastMCP servers
83
83
  exposed over HTTP, API-key gated, PM2-managed, with OneUptime heartbeats.
84
84
  `toga-db-mcp` is the canonical read-only data plane across 4 prod clusters
package/knowledge/2.0/apps/talos/features/mcp-servers.md CHANGED
@@ -21,7 +21,7 @@ files:
21
21
  - talos/mcp-servers/toga-db-mcp/.env.example
22
22
  related:
23
23
  - ../architecture.md
24
- - react-agent.md
24
+ - talos-agent.md
25
25
  - deployment.md
26
26
  ---
27
27
 
@@ -36,7 +36,7 @@ PM2 process management:
36
36
  legacy, and 16 non-prod environments. The **canonical** path for the agent
37
37
  to read TOGa data.
38
38
 
39
- Both are consumed by the `react_agent` via the standard MCP loader and by
39
+ Both are consumed by the `talos_agent` via the standard MCP loader and by
40
40
  external clients (Claude Desktop, internal tooling) via API-key auth.
41
41
 
42
42
  ## Key files / entry points
package/knowledge/2.0/apps/talos/features/{react-agent.md → talos-agent.md} RENAMED
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: react_agent — LangGraph ReAct Agent with Plan, BLP, MCP, Canvas
2
+ title: talos_agent — LangGraph ReAct Agent with Plan, BLP, MCP, Canvas
3
3
  framework: "2.0"
4
4
  repo: talos
5
5
  project: TOGa IQ
@@ -9,38 +9,38 @@ status: active
9
9
  updated: 2026-06-16
10
10
  owners: [akhokhani]
11
11
  files:
12
- - talos/examples/react_agent/graph.py
13
- - talos/examples/react_agent/state.py
14
- - talos/examples/react_agent/context.py
15
- - talos/examples/react_agent/prompts.py
16
- - talos/examples/react_agent/tool_router.py
17
- - talos/examples/react_agent/model_helpers.py
18
- - talos/examples/react_agent/config/context.py
19
- - talos/examples/react_agent/config/model_config.py
20
- - talos/examples/react_agent/config/tool_config.py
21
- - talos/examples/react_agent/config/plan_config.py
22
- - talos/examples/react_agent/config/memory_config.py
23
- - talos/examples/react_agent/config/mcp_config.py
24
- - talos/examples/react_agent/config/blp_config.py
25
- - talos/examples/react_agent/config/interrupt_config.py
26
- - talos/examples/react_agent/config/artifact_config.py
27
- - talos/examples/react_agent/plan/planner.py
28
- - talos/examples/react_agent/plan/nodes.py
29
- - talos/examples/react_agent/llm/system_prompt.py
30
- - talos/examples/react_agent/llm/tool_binding.py
31
- - talos/examples/react_agent/llm/message_ops.py
32
- - talos/examples/react_agent/mcp/client.py
33
- - talos/examples/react_agent/mcp/security.py
34
- - talos/examples/react_agent/mcp/session_manager.py
35
- - talos/examples/react_agent/blp/registry.py
36
- - talos/examples/react_agent/blp/embedder.py
37
- - talos/examples/react_agent/blp/nodes.py
38
- - talos/examples/react_agent/tools/__init__.py
39
- - talos/examples/react_agent/tools/code_interpreter.py
40
- - talos/examples/react_agent/tools/canvas.py
41
- - talos/examples/react_agent/tools/knowledge_base.py
42
- - talos/examples/react_agent/tools/skill_injector.py
43
- - talos/examples/react_agent/thread_name/nodes.py
12
+ - talos/agents/talos_agent/graph.py
13
+ - talos/agents/talos_agent/state.py
14
+ - talos/agents/talos_agent/context.py
15
+ - talos/agents/talos_agent/prompts.py
16
+ - talos/agents/talos_agent/tool_router.py
17
+ - talos/agents/talos_agent/model_helpers.py
18
+ - talos/agents/talos_agent/config/context.py
19
+ - talos/agents/talos_agent/config/model_config.py
20
+ - talos/agents/talos_agent/config/tool_config.py
21
+ - talos/agents/talos_agent/config/plan_config.py
22
+ - talos/agents/talos_agent/config/memory_config.py
23
+ - talos/agents/talos_agent/config/mcp_config.py
24
+ - talos/agents/talos_agent/config/blp_config.py
25
+ - talos/agents/talos_agent/config/interrupt_config.py
26
+ - talos/agents/talos_agent/config/artifact_config.py
27
+ - talos/agents/talos_agent/plan/planner.py
28
+ - talos/agents/talos_agent/plan/nodes.py
29
+ - talos/agents/talos_agent/llm/system_prompt.py
30
+ - talos/agents/talos_agent/llm/tool_binding.py
31
+ - talos/agents/talos_agent/llm/message_ops.py
32
+ - talos/agents/talos_agent/mcp/client.py
33
+ - talos/agents/talos_agent/mcp/security.py
34
+ - talos/agents/talos_agent/mcp/session_manager.py
35
+ - talos/agents/talos_agent/blp/registry.py
36
+ - talos/agents/talos_agent/blp/embedder.py
37
+ - talos/agents/talos_agent/blp/nodes.py
38
+ - talos/agents/talos_agent/tools/__init__.py
39
+ - talos/agents/talos_agent/tools/code_interpreter.py
40
+ - talos/agents/talos_agent/tools/canvas.py
41
+ - talos/agents/talos_agent/tools/knowledge_base.py
42
+ - talos/agents/talos_agent/tools/skill_injector.py
43
+ - talos/agents/talos_agent/thread_name/nodes.py
44
44
  related:
45
45
  - ../architecture.md
46
46
  - aegra-api.md
@@ -49,8 +49,8 @@ related:
49
49
 
50
50
  ## Summary
51
51
 
52
- `react_agent` is the **reference LangGraph agent** shipped under
53
- `examples/react_agent/`. It is a production-grade ReAct loop with an optional
52
+ `talos_agent` is the **reference LangGraph agent** shipped under
53
+ `agents/talos_agent/`. It is a production-grade ReAct loop with an optional
54
54
  **planner** gate, an LLM-driven **tool router**, **BLP** semantic context
55
55
  selection, running-summary memory compaction, a versioned **canvas** artifact,
56
56
  **code-interpreter** offload (Bedrock AgentCore), and transparent **MCP**
@@ -202,4 +202,5 @@ Add a client override by configuring its assistant, not by forking the graph.
202
202
  recursion limit. Raise the limit in graph build before raising expectations.
203
203
 
204
204
  ## Change history
205
- - 2026-06-16 — Initial react_agent feature doc. (akhokhani)
205
+ - 2026-06-16 — Renamed `examples/react_agent/` → `agents/talos_agent/`; sibling example dirs (`react_agent_hitl`, `subgraph_agent`, `subgraph_hitl_agent`) and example scripts removed. `aegra.json` now points `dependencies: ["./agents"]`; graph entry is `./agents/talos_agent/graph.py:graph`. Module import is `from talos_agent.graph import graph`. (akhokhani)
206
+ - 2026-06-16 — Initial feature doc. (akhokhani)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "toga-ai",
3
- "version": "1.0.92",
3
+ "version": "1.0.93",
4
4
  "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
5
5
  "keywords": [
6
6
  "claude",