feat: add the hierarchical Execution engine on LangGraph

Increment 4 of .scratch/solution-architect-agent/spec.md, test-first.

- app/agents/runtime.py: framework-neutral AgentRuntime interface
  (RoleSpec, AgentTask, ToolSpec, outcomes); fake_runtime.py replays
  scripted tool calls through the real tools with step budgets.
- app/execution/graph.py: Orchestrator turn fans out to parallel
  Specialist tasks (Send), pauses with interrupt() for questions,
  Approvals and cloud-read permission, and finalizes or ends with
  warnings. Only the Orchestrator turn writes the Ledger.
- app/execution/tools.py: Orchestrator tools, Specialist submit and
  needs_input, and the cloud-read permission gate.
- app/execution/engine.py: ExecutionEngine.start/resume returning an
  Interaction; the single interface for A2A, /generate and eval.
- Recorders (in-memory, DatabaseManager), configurable checkpointer
  (memory, sqlite, postgres), engine settings, langgraph checkpoint
  dependencies.
- 19 new tests; full suite 121 passed.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-09-16 09:38:13 +01:00
parent c8410946b8
commit d9214c671a
15 changed files with 2143 additions and 1 deletions

View File

@@ -37,6 +37,14 @@ ADK_ENABLE_ARTIFACT_STORE=true
CLOUD_PROVIDER=gcp
MCP_ENABLE_PREVIEW=true
# Hierarchical Execution Engine
ORCHESTRATOR_BUDGET=40
SPECIALIST_BUDGET=15
MAX_REVISIONS=3
MAX_ORCHESTRATOR_TURNS=100
CHECKPOINTER=sqlite
CHECKPOINT_DB_PATH=checkpoints.db
# Google Developer Knowledge MCP Integration
DEVELOPER_KNOWLEDGE_MCP_URL=https://developerknowledge.googleapis.com/mcp
DEVELOPER_KNOWLEDGE_MCP_ENABLED=true