49 lines
2.2 KiB
Python
49 lines
2.2 KiB
Python
"""
|
|
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.")
|