@enderfga/claw-orchestrator 3.5.6 → 3.7.0

package/README.md

@@ -12,7 +12,7 @@ It's a TypeScript runtime for orchestrating Claude Code, OpenAI Codex, Gemini, C
 
 > Claude Code, Codex, Gemini, Cursor Agent, OpenCode, or your own custom CLI — orchestrated as one runtime.
 >
-> **Runs standalone, with first-class OpenClaw plugin support and a path to other claw-style agent platforms.**
+> **Runs standalone, as an OpenClaw plugin, or as a Model Context Protocol (MCP) server — drop it into Hermes Agent, Claude Desktop, Cursor, Cline, Continue, Zed, Windsurf, Goose, or any MCP-compatible host.**
 
 [![npm version](https://img.shields.io/npm/v/@enderfga/claw-orchestrator.svg)](https://www.npmjs.com/package/@enderfga/claw-orchestrator)
 [![CI](https://github.com/Enderfga/claw-orchestrator/actions/workflows/ci.yml/badge.svg)](https://github.com/Enderfga/claw-orchestrator/actions/workflows/ci.yml)
@@ -41,7 +41,8 @@ Claw Orchestrator is the control layer for that.
 - Run Claude Code or Codex as a headless coding agent
 - Keep persistent AI coding sessions alive across requests
 - Build multi-agent coding teams with isolated git worktrees
-- Expose coding agents as tools to OpenClaw, MCP servers, bots, dashboards, or custom runtimes
+- Expose coding agents as MCP tools so Hermes Agent, Claude Desktop, Cursor, Cline, Continue, Zed, Windsurf, Goose, and other MCP-capable hosts can drive them
+- Use the same toolset from OpenClaw, bots, dashboards, or custom runtimes
 - Route tasks across Claude Code, Codex, Gemini, Cursor Agent, OpenCode, and custom CLIs
 
 ---
@@ -156,6 +157,67 @@ curl -fsSL https://raw.githubusercontent.com/Enderfga/claw-orchestrator/main/ins
 
 This installs via npm, registers the plugin in `~/.openclaw/openclaw.json`, and restarts the gateway. See [`skills/references/getting-started.md`](./skills/references/getting-started.md) for the full setup.
 
+### As an MCP server (Hermes Agent, Claude Desktop, Cursor, Cline, Continue, Zed, Windsurf, Goose)
+
+Every host that speaks the [Model Context Protocol](https://modelcontextprotocol.io) can pick up the orchestrator's full toolset (41 tools — sessions, council, ultraplan, ultrareview, autoloop, codex, inbox) over stdio.
+
+```bash
+npm install -g @enderfga/claw-orchestrator
+# now `clawo-mcp` is on PATH
+```
+
+Register it with your host:
+
+<details>
+<summary><strong>Hermes Agent</strong> — <code>~/.hermes/config.yaml</code></summary>
+
+```yaml
+mcp_servers:
+  clawo:
+    command: clawo-mcp
+    env:
+      ANTHROPIC_API_KEY: "..."
+      OPENAI_API_KEY: "..."
+      GEMINI_API_KEY: "..."
+    # Optional: keep the model focused — Hermes will surface only these
+    tools:
+      include: [mcp_clawo_session_start, mcp_clawo_session_send, mcp_clawo_council_start]
+```
+</details>
+
+<details>
+<summary><strong>Claude Desktop / Claude Code</strong> — <code>claude_desktop_config.json</code></summary>
+
+```json
+{
+  "mcpServers": {
+    "clawo": {
+      "command": "clawo-mcp",
+      "env": {
+        "ANTHROPIC_API_KEY": "...",
+        "OPENAI_API_KEY": "...",
+        "CLAWO_MCP_TOOLS": "session_start,session_send,council_start,council_status,ultrareview_start"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Cursor / Cline / Continue / Zed / Windsurf / Goose</strong></summary>
+
+Every one of these hosts speaks the standard MCP stdio config. Add `clawo-mcp` as a server with the same `command + args + env` shape — refer to your host's MCP documentation for the exact file path.
+</details>
+
+**Notes**
+
+- Hosts prefix MCP tool names with the server slug (e.g. `mcp_clawo_session_start` in Hermes). The model sees the prefixed name; you don't need to call it manually.
+- `CLAWO_MCP_TOOLS` (comma-separated allowlist) keeps the exposed surface tight when the host has a tight tool budget. Without it, all 41 tools are advertised.
+- Hosts do not forward arbitrary shell env vars to MCP servers — list every API key your engines need (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`, etc.) explicitly under `env`.
+
+Full reference: [`skills/references/mcp.md`](./skills/references/mcp.md).
+
 ---
 
 ## Engine Compatibility

package/configs/autoloop-planner-prompt.md

@@ -49,7 +49,7 @@ turn. Anything outside the blocks is shown to the user as your chat reply.
 
 **Rules:**
 - **Never call `spawn_subagents` without explicit user approval** in the chat. Even if the plan looks done, ask "ready to spawn subagents?" first and wait for "go" / "ok" / "开干" / similar. Exception: if `plan.md` frontmatter contains `auto_proceed: true`, you may spawn directly after writing the plan.
-- **Sanity-check the plan before spawning.** `plan.md` must have a Goal section, ≥1 gate, and a Constraints block. `goal.json` must validate against v1 GoalSpec (see `src/autoloop/v1/types.ts`).
+- **Sanity-check the plan before spawning.** `plan.md` must have a Goal section, ≥1 gate, and a Constraints block. `goal.json` must contain `scalar` (or explicit `null`), `gates`, and `termination` — see the goal.json shape example in `skills/references/autoloop.md` (§ `goal.json` shape).
 - **Do not emit raw JSON outside an `autoloop` fence.** Anything outside is shown to the user verbatim.
 - The user CAN see your reply — including questions, summaries, file references — but **cannot** see the autoloop blocks you emit. Don't restate every block in prose; only narrate when the action matters to the human.
 
@@ -96,9 +96,10 @@ turn. Anything outside the blocks is shown to the user as your chat reply.
     eval set unchanged, flag", "no new flags toggled silently">
    ```
 
-4. **Write goal.json** as the machine-readable mirror of the success criteria
-   — the same shape as v1's GoalSpec (see `src/autoloop/v1/types.ts`). The
-   runner will validate this when subagents are spawned.
+4. **Write goal.json** as the machine-readable mirror of the success criteria.
+   The shape is `{ scalar: { name, direction, extract_cmd, target } | null,
+   gates: [{ name, cmd, must }], termination: { max_iters, scalar_target_hit? } }`
+   — see the worked example in `skills/references/autoloop.md`.
 
 5. **Confirm with the user.** When you believe the plan is solid, say so
    plainly and ask "ready to spawn subagents?". Do **not** spawn them
@@ -120,14 +121,15 @@ turn. Anything outside the blocks is shown to the user as your chat reply.
 - ❌ Run the evaluator yourself. The Coder runs eval, the Reviewer audits it.
 - ❌ Promise outcomes ("this will get loss to 0.1"). State assumptions and
   gates instead.
-- ❌ Push the user out-of-band. In S2 there is no `notify_user` tool. Speak
-  through chat only.
+- ❌ Spam the user out-of-band. `notify_user` works, but the 5-minute dedup
+  doesn't make spam OK. Use it when something needs the user's attention
+  (decision, regression, stall, target hit), not for routine progress.
 
 ## Format
 
-Free-form chat is fine. If you need to emit something machine-readable for
-later phases, fence it as JSON in a labeled code block — but in S2 nothing
-parses your output for structured signals, so prefer prose.
+Free-form chat is fine. Autoloop control tools are parsed out of your reply
+as fenced ` ```autoloop ` JSON blocks (see the tool table above). Anything
+outside those blocks is shown to the user verbatim.
 
 ---
 

package/configs/autoloop-reviewer-prompt.md

@@ -9,8 +9,12 @@ independently verify whether each iteration actually moved toward the goal.
   that contains only the artifacts the orchestrator hands you for the iter
   under review — not the live workspace, not unrelated history.
 - You persist across iterations. Your accumulating mental model of "how
-  Coder cheats / cuts corners" is your most valuable asset. Save what you
-  learn into `reviewer_memory.md` after each review.
+  Coder cheats / cuts corners" is your most valuable asset. **The current
+  contents of `reviewer_memory.md` are injected as a frozen snapshot in
+  your system prompt at the start of this session**, so you do not need to
+  re-read the file each iter. Append fresh observations to it during
+  reviews; those edits become visible on the next Reviewer reset, not
+  mid-session.
 - You report only to the runner (which forwards your verdict to Planner).
   You do **not** chat with the user or with the Coder.
 

package/dist/bin/mcp-server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/mcp-server.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+/**
+ * claw-orchestrator MCP server
+ *
+ * Exposes the orchestrator's tool surface over the Model Context Protocol
+ * (stdio transport). Drop into any MCP-compatible host (Hermes Agent, Claude
+ * Desktop, Cursor, Cline, Continue, Zed, Windsurf, Goose, …) by adding it
+ * to that host's MCP server config.
+ *
+ * Implementation: feed `plugin.register()` a capturing PluginAPI shim, then
+ * translate each captured tool into MCP `tools/list` + `tools/call`. This
+ * keeps a single tool definition site (`src/index.ts`) shared between the
+ * OpenClaw plugin entry and the MCP entry — no schema drift between them.
+ *
+ * Stdout is reserved for the MCP protocol — every log line goes to stderr.
+ *
+ * Environment variables read at startup:
+ *   CLAWO_MCP_TOOLS         comma-separated allowlist of tool names. Unlisted
+ *                            tools are not exposed. Useful when the host has a
+ *                            tight tool budget (default: expose everything).
+ *   CLAWO_NO_EMBEDDED_SERVER set automatically; suppresses the plugin's HTTP
+ *                            control-plane (port 18796) which is dead weight
+ *                            for MCP-only deployments.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+// The plugin lazily starts EmbeddedServer on first tool call unless this is
+// set. Set before importing so the env is seen on the very first invocation.
+process.env.CLAWO_NO_EMBEDDED_SERVER ??= '1';
+const { default: plugin } = await import('../src/index.js');
+// Hand-curated hints. MCP hosts surface these to the model so it can pick
+// safer tools first (Hermes / Cursor / Claude Desktop all read them).
+//
+//   readOnly      — does not mutate workspace, sessions, files, or branches
+//   destructive   — irreversible side-effects (delete worktree, drop branch, kill process)
+//   openWorld     — touches things outside the local machine (model APIs)
+const ANNOTATIONS = {
+    // pure reads
+    session_list: { readOnlyHint: true, idempotentHint: true },
+    sessions_overview: { readOnlyHint: true, idempotentHint: true },
+    coding_session_status: { readOnlyHint: true, idempotentHint: true },
+    session_grep: { readOnlyHint: true, idempotentHint: true },
+    session_inbox: { readOnlyHint: true, idempotentHint: true },
+    coding_agents_list: { readOnlyHint: true, idempotentHint: true },
+    team_list: { readOnlyHint: true, idempotentHint: true },
+    council_status: { readOnlyHint: true, idempotentHint: true },
+    council_review: { readOnlyHint: true, idempotentHint: true },
+    ultraplan_status: { readOnlyHint: true, idempotentHint: true },
+    ultrareview_status: { readOnlyHint: true, idempotentHint: true },
+    autoloop_status: { readOnlyHint: true, idempotentHint: true },
+    autoloop_list: { readOnlyHint: true, idempotentHint: true },
+    codex_goal_get: { readOnlyHint: true, idempotentHint: true },
+    // destructive
+    session_stop: { destructiveHint: true },
+    council_abort: { destructiveHint: true },
+    council_accept: { destructiveHint: true },
+    council_reject: { destructiveHint: true },
+    autoloop_stop: { destructiveHint: true },
+    project_purge: { destructiveHint: true },
+    // mutating + open-world (call external model APIs)
+    session_start: { openWorldHint: true },
+    session_send: { openWorldHint: true },
+    team_send: { openWorldHint: true },
+    session_send_to: { openWorldHint: true },
+    session_deliver_inbox: { openWorldHint: true },
+    council_start: { openWorldHint: true },
+    council_inject: { openWorldHint: true },
+    ultraplan_start: { openWorldHint: true },
+    ultrareview_start: { openWorldHint: true },
+    autoloop_start: { openWorldHint: true },
+    autoloop_chat: { openWorldHint: true },
+    autoloop_reset_agent: {},
+    codex_resume: { openWorldHint: true },
+    codex_review: { openWorldHint: true },
+    codex_goal_set: { openWorldHint: true },
+    codex_goal_pause: {},
+    codex_goal_resume: { openWorldHint: true },
+    codex_goal_clear: {},
+    session_compact: { openWorldHint: true },
+    session_update_tools: {},
+    session_switch_model: {},
+};
+const log = {
+    info: (...args) => console.error('[clawo-mcp]', ...args),
+    warn: (...args) => console.error('[clawo-mcp]', ...args),
+    error: (...args) => console.error('[clawo-mcp]', ...args),
+};
+const captured = [];
+const shim = {
+    pluginConfig: {},
+    logger: log,
+    registerTool: (def) => {
+        captured.push(def);
+    },
+    on: () => { },
+    registerHttpRoute: () => { },
+    registerService: () => { },
+};
+plugin.register(shim);
+const allowlist = (process.env.CLAWO_MCP_TOOLS ?? '').trim();
+const allowed = allowlist
+    ? new Set(allowlist
+        .split(',')
+        .map((s) => s.trim())
+        .filter(Boolean))
+    : null;
+const tools = allowed ? captured.filter((t) => allowed.has(t.name)) : captured;
+if (allowed && tools.length === 0) {
+    log.warn(`CLAWO_MCP_TOOLS filter matched 0 tools. Captured: ${captured.map((t) => t.name).join(', ')}`);
+}
+const PKG_VERSION = process.env.npm_package_version ?? '3.7.0';
+const server = new Server({ name: 'claw-orchestrator', version: PKG_VERSION }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        inputSchema: t.parameters,
+        ...(ANNOTATIONS[t.name] ? { annotations: ANNOTATIONS[t.name] } : {}),
+    })),
+}));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const tool = tools.find((t) => t.name === req.params.name);
+    if (!tool) {
+        return {
+            isError: true,
+            content: [{ type: 'text', text: `Unknown tool: ${req.params.name}` }],
+        };
+    }
+    try {
+        const result = await tool.execute(`mcp-${Date.now()}`, (req.params.arguments ?? {}));
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            isError: true,
+            content: [{ type: 'text', text: msg }],
+        };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+log.info(`mcp server ready — exposing ${tools.length} of ${captured.length} tools over stdio`);
+//# sourceMappingURL=mcp-server.js.map

package/dist/bin/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../../bin/mcp-server.ts"],"names":[],"mappings":"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"}

package/dist/src/autoloop/dispatcher.d.ts

@@ -22,7 +22,7 @@ import { EventEmitter } from 'node:events';
 import type { SessionManager } from '../session-manager.js';
 import type { Logger } from '../logger.js';
 import { type AnyAutoloopMessage } from './messages.js';
-import type { AgentDispatcher, AutoloopState, PushPolicy } from './types.js';
+import { type AgentDispatcher, type AutoloopState, type PushPolicy } from './types.js';
 import { type SpawnSubagentsArgs } from './planner-tools.js';
 export interface ClaudeAgentDispatcherConfig {
     manager: SessionManager;
@@ -115,6 +115,13 @@ export declare class ClaudeAgentDispatcher extends EventEmitter implements Agent
      * deliverToCoder / deliverToReviewer to recover from subprocess deaths.
      */
     private sendWithRecovery;
+    /**
+     * Append a structured audit row to `<ledger>/decisions.jsonl`. Best-effort:
+     * any I/O failure is logged but never thrown. Captures terminate, reset,
+     * push-policy mutations, compact triggers, subagent spawns, phase-error
+     * passes, and policy-silence attempts that we rejected.
+     */
+    private appendDecisionLog;
     private lastCompactAt;
     private compactSummaryFor;
     private maybeCompact;
@@ -122,6 +129,13 @@ export declare class ClaudeAgentDispatcher extends EventEmitter implements Agent
     private deliverToPlanner;
     private ensureCoder;
     private deliverToCoder;
+    /**
+     * Compose the Reviewer's system prompt with a frozen snapshot of
+     * `reviewer_memory.md` appended. Read once at session start; mid-session
+     * edits to the file do NOT take effect until the next Reviewer reset. This
+     * keeps the per-iter prompt prefix stable so Claude's prefix cache hits.
+     */
+    private buildReviewerSystemPrompt;
     private ensureReviewer;
     /**
      * Stage the iter's artifacts into the Reviewer sandbox cwd. Reviewer is a