feat: initial bootstrap — structure, task_brief, blackboard, adapter bases, escalation, prompts

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

adapters/runtime/claude_code.py

@@ -0,0 +1,51 @@
+"""
+adapters/runtime/claude_code.py
+Claude Code agent runtime adapter — Phase 2 stub.
+
+TODO (Phase 2):
+  - Implement spawn() to launch a Claude Code sub-agent via the Agent SDK.
+  - Implement get_result() to await agent completion and parse the output.
+  - Implement kill() to terminate the sub-agent process or session.
+  - Map task brief context (files, constraints, artifacts) into the agent's
+    system prompt and tool context.
+  - Handle Claude Code tool-use responses and extract structured output.
+"""
+from __future__ import annotations
+
+from adapters.base.runtime import RuntimeAdapter
+
+
+class ClaudeCodeRuntimeAdapter(RuntimeAdapter):
+    """
+    Runtime adapter that spawns Claude Code sub-agents for coding tasks.
+
+    Used when a TaskBrief has preferred_runtime == "coding_agent".
+
+    Expects the Claude Code CLI / Agent SDK to be available in the environment.
+    Credentials are inherited from the environment (ANTHROPIC_API_KEY).
+    """
+
+    def __init__(self, config: dict) -> None:
+        # TODO (Phase 2): Accept loaded team.yaml config dict.
+        # Validate that Claude Code CLI or SDK is accessible.
+        # Initialise any agent session management state.
+        raise NotImplementedError("ClaudeCodeRuntimeAdapter.__init__ is not yet implemented.")
+
+    def spawn(self, task: str, capability: str, context: dict) -> str:
+        # TODO (Phase 2): Launch a Claude Code sub-agent.
+        # Compose a structured system prompt from task + context.
+        # Inject relevant files and constraints as tool context.
+        # Return an agent_id that maps to a running agent session.
+        raise NotImplementedError("ClaudeCodeRuntimeAdapter.spawn is not yet implemented.")
+
+    def get_result(self, agent_id: str, timeout_s: int) -> dict:
+        # TODO (Phase 2): Await the Claude Code agent session to complete.
+        # Parse the agent's final message for structured JSON output.
+        # Return dict with: {"status": ..., "output": ..., "artifacts": [...]}.
+        # Raise TimeoutError if timeout_s elapses.
+        raise NotImplementedError("ClaudeCodeRuntimeAdapter.get_result is not yet implemented.")
+
+    def kill(self, agent_id: str) -> None:
+        # TODO (Phase 2): Terminate the Claude Code agent session.
+        # Clean up any temporary files or session state.
+        raise NotImplementedError("ClaudeCodeRuntimeAdapter.kill is not yet implemented.")

adapters/runtime/openclaw.py

@@ -0,0 +1,48 @@
+"""
+adapters/runtime/openclaw.py
+OpenClaw agent runtime adapter — Phase 2 stub.
+
+TODO (Phase 2):
+  - Implement spawn() to submit a task to an OpenClaw worker pool.
+  - Implement get_result() to poll or subscribe for agent completion.
+  - Implement kill() to cancel a running OpenClaw agent job.
+  - Read endpoint and credentials from environment (OPENCLAW_API_KEY, OPENCLAW_URL).
+  - Map capability hint to an appropriate worker class/queue.
+"""
+from __future__ import annotations
+
+from adapters.base.runtime import RuntimeAdapter
+
+
+class OpenClawRuntimeAdapter(RuntimeAdapter):
+    """
+    Runtime adapter that dispatches agent tasks to OpenClaw workers.
+
+    Expects environment variables:
+        OPENCLAW_API_KEY  — authentication token
+        OPENCLAW_URL      — base URL for the OpenClaw API
+    """
+
+    def __init__(self, config: dict) -> None:
+        # TODO (Phase 2): Accept loaded team.yaml config dict.
+        # Extract OPENCLAW_API_KEY and OPENCLAW_URL from environment.
+        # Initialise HTTP client and any job-tracking state.
+        raise NotImplementedError("OpenClawRuntimeAdapter.__init__ is not yet implemented.")
+
+    def spawn(self, task: str, capability: str, context: dict) -> str:
+        # TODO (Phase 2): Submit task to OpenClaw worker pool.
+        # Map capability ("reasoning-heavy" | "capable" | "fast-cheap") to
+        # an appropriate worker queue or model hint.
+        # Return an agent_id string that can be used to poll for results.
+        raise NotImplementedError("OpenClawRuntimeAdapter.spawn is not yet implemented.")
+
+    def get_result(self, agent_id: str, timeout_s: int) -> dict:
+        # TODO (Phase 2): Poll or long-poll the OpenClaw API for job completion.
+        # Raise TimeoutError if timeout_s elapses before the job finishes.
+        # Return a dict with at minimum: {"status": ..., "output": ..., "artifacts": [...]}.
+        raise NotImplementedError("OpenClawRuntimeAdapter.get_result is not yet implemented.")
+
+    def kill(self, agent_id: str) -> None:
+        # TODO (Phase 2): Send a cancellation request to the OpenClaw API.
+        # Silently succeed if the agent has already finished.
+        raise NotImplementedError("OpenClawRuntimeAdapter.kill is not yet implemented.")