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

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

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.")