clawborrator-mcp 0.0.1

package/README.md

@@ -0,0 +1,110 @@
+# clawborrator-mcp (channel_v1)
+
+MCP server that connects each running Claude Code instance to a
+[`hub_v1`](https://github.com/clawborrator/hub_v1) over WebSocket.
+Companion to the hub. Designed to be invoked by Claude Code via
+`.mcp.json`; runs as both a long-lived stdio MCP server AND a
+short-lived hook spawn (selected by the `--hook=<HookName>` CLI flag).
+
+> **Status: dev-mode-only.** Connect to a local hub at `ws://localhost:8787`.
+> Production deployment is a future concern.
+>
+> Design context: [`hub/design/IMPL-PLAN-1-CHANNEL-V1-FRESH-START.md`](https://github.com/clawborrator/hub/blob/main/design/IMPL-PLAN-1-CHANNEL-V1-FRESH-START.md).
+
+---
+
+## Configuration
+
+Set in your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "clawborrator": {
+      "command": "npx",
+      "args": ["-y", "clawborrator-mcp"],
+      "env": {
+        "CLAWBORRATOR_HUB_URL": "ws://localhost:8787",
+        "CLAWBORRATOR_TOKEN":   "ck_live_…"
+      }
+    }
+  }
+}
+```
+
+| Env var | Required | Notes |
+|---|---|---|
+| `CLAWBORRATOR_HUB_URL` | yes | `ws://…` or `wss://…`; no trailing slash |
+| `CLAWBORRATOR_TOKEN` | yes | Channel token (`ck_live_…`) minted via `claw token mint --kind=channel` |
+| `CLAWBORRATOR_REUSE_SESSION_ID` | no | Opt-in: reconnect rebinds to a known session id rather than creating a fresh one |
+| `CLAWBORRATOR_LOG_LEVEL` | no | `debug`, `info`, `warn`, `error`; default `info` |
+
+Get the snippet pre-filled with the right URL + token via:
+
+```bash
+claw token mint --kind=channel --name=mbp --mcp-snippet
+```
+
+---
+
+## What it does
+
+**Long-lived MCP path** (default invocation):
+1. Reads env config; loads channel token.
+2. Opens WSS to `<HUB_URL>/channel` with `Authorization: Bearer <CHANNEL_TOKEN>`.
+3. Sends `register` with host / cwd / pid / version; receives `welcome` with sessionId + routingName.
+4. Writes `<cwd>/.claude/clawborrator.session.json` (mode 0600) so per-event hook spawns can find the active session.
+5. Maintains the WS with heartbeat ping/pong; reconnects with exponential backoff (1s/2s/5s/15s/30s/60s).
+6. Listens for hub-side messages: `prompt` (cross-session route), `permission_response`, `peers_update`, `bye`, `error`.
+7. On clean shutdown (SIGINT/SIGTERM/exit), deletes the sidecar.
+
+**Short-lived hook path** (`--hook=<HookName>` flag):
+1. Reads JSON payload from stdin (Claude Code's hook protocol).
+2. Locates the active sidecar (walks up from cwd looking for `.claude/clawborrator.session.json`).
+3. Maps the hook name to a clawborrator event (e.g. `PreToolUse` → `tail/PreToolUse`, `UserPromptSubmit` → `chat/prompt`).
+4. POSTs to `<HUB_URL>/api/channel/event` with the channel token from the sidecar.
+5. Echoes stdin to stdout so Claude's hook chain stays intact.
+6. Exits cleanly even if the hub is unreachable — never breaks the operator's actual Claude flow.
+
+Hooks are installed with `claw session init` from inside a project — see hub_v1 README.
+
+---
+
+## Tools exposed to Claude
+
+v1 ships an empty MCP tool list. The hooks-based event firehose
+covers chat + tail event capture without any Claude-side tool calls.
+
+Phase D adds these:
+- `reply({ chat_id, text })` — Claude posts a tagged final reply
+- `list_peers()` — Claude discovers other operator sessions
+- `route_to_peer({ peer, prompt, mode })` — Claude routes a question
+- `probe_peers({ prompt, peers? })` — Claude fan-out probes
+
+For now, operators initiate routing via `claw route` / `claw probe`.
+
+---
+
+## Phases
+
+- **Phase A** (✓): connect / register / heartbeat / reconnect
+- **Phase B** (✓): hooks + event forwarding via sidecar
+- **Phase C** (✓): bidirectional permission relay protocol (channel
+  → hub → operator → back). Hook IPC for actually delivering decisions
+  into a blocked PreToolUse hook is upcoming.
+- **Phase D**: MCP tools (above)
+
+---
+
+## Local dev (linked to a sibling hub_v1 checkout)
+
+```bash
+npm install
+npm run build
+npm link
+
+# verify the binary is on PATH
+clawborrator-mcp --hook=PreToolUse < /dev/null   # exits cleanly with no sidecar
+```
+
+When `claude` runs in a folder whose `.mcp.json` references `clawborrator-mcp`, npm/npx resolves it to your linked build.

package/bin/clawborrator-mcp

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import('../dist/index.js').catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+export interface ChannelConfig {
+    hubUrl: string;
+    token: string;
+    reuseSessionId: string | null;
+}
+export declare function loadConfig(): ChannelConfig;

package/dist/config.js

@@ -0,0 +1,22 @@
+// Read + validate the env-var configuration the MCP needs to connect.
+// Mirrors the shape documented in the channel_v1 design doc §3.
+export function loadConfig() {
+    const hubUrl = process.env.CLAWBORRATOR_HUB_URL?.trim();
+    const token = process.env.CLAWBORRATOR_TOKEN?.trim();
+    if (!hubUrl)
+        throw new Error('CLAWBORRATOR_HUB_URL is required');
+    if (!token)
+        throw new Error('CLAWBORRATOR_TOKEN is required');
+    if (!hubUrl.startsWith('ws://') && !hubUrl.startsWith('wss://')) {
+        throw new Error(`CLAWBORRATOR_HUB_URL must be ws:// or wss://, got: ${hubUrl}`);
+    }
+    if (!token.startsWith('ck_live_')) {
+        throw new Error(`CLAWBORRATOR_TOKEN must start with ck_live_`);
+    }
+    return {
+        hubUrl: hubUrl.replace(/\/$/, ''),
+        token,
+        reuseSessionId: process.env.CLAWBORRATOR_REUSE_SESSION_ID?.trim() || null,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,gEAAgE;AAQhE,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC;IACxD,MAAM,KAAK,GAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACtD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK;QAAG,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,sDAAsD,MAAM,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACjC,KAAK;QACL,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,6BAA6B,EAAE,IAAI,EAAE,IAAI,IAAI;KAC1E,CAAC;AACJ,CAAC"}

package/dist/hook.d.ts

@@ -0,0 +1 @@
+export declare function runHook(hookName: string): Promise<void>;

package/dist/hook.js

@@ -0,0 +1,250 @@
+// Hook entry point. Spawned by Claude Code per `.claude/settings.json`
+// like:
+//
+//   { "type": "command", "command": "npx clawborrator-mcp --hook=PreToolUse" }
+//
+// The hook receives the JSON payload on stdin. We:
+//   1. Read stdin to EOF
+//   2. Locate the sidecar in the cwd (or walk up parents)
+//   3. Map the hook name to a clawborrator event kind+type
+//   4. Enrich Stop / SubagentStop with assistant_text (final answer)
+//      from the transcript JSONL
+//   5. For PreToolUse, ship 0..N chat/assistant_text events for any
+//      "let me check X" running commentary Claude wrote in the same
+//      assistant message before this tool_use, plus a placeholder
+//      when extended thinking happened but the plaintext was stripped
+//      from disk
+//   6. POST /api/channel/event with the channel token from the sidecar
+//   7. Echo stdin to stdout so Claude's hook chain stays intact
+import { findSidecar } from './sidecar.js';
+import { log } from './log.js';
+import { readTranscriptMessages, messageContainsToolUse, extractTextBlocksBeforeToolUse, hasThinkingBlocksBeforeToolUse, extractFromLastAssistantMessage, extractFinalAnswerFromTranscript, DEFAULT_TAIL_BYTES, } from './transcript.js';
+// Mirrors the install-hooks set from the old clawborrator-channel
+// package so the remote viewer has the same coverage of Claude Code's
+// hook surface.
+const HOOK_TO_EVENT = {
+    UserPromptSubmit: { kind: 'chat', type: 'prompt' },
+    PreToolUse: { kind: 'tail', type: 'PreToolUse' },
+    PostToolUse: { kind: 'tail', type: 'PostToolUse' },
+    PostToolUseFailure: { kind: 'tail', type: 'PostToolUseFailure' },
+    Stop: { kind: 'tail', type: 'Stop' },
+    Notification: { kind: 'tail', type: 'Notification' },
+    SessionStart: { kind: 'tail', type: 'SessionStart' },
+    SessionEnd: { kind: 'tail', type: 'SessionEnd' },
+    TaskCreated: { kind: 'tail', type: 'TaskCreated' },
+    SubagentStart: { kind: 'tail', type: 'SubagentStart' },
+    SubagentStop: { kind: 'tail', type: 'SubagentStop' },
+    TaskCompleted: { kind: 'tail', type: 'TaskCompleted' },
+};
+// Tools whose pre-text we DON'T ship as AssistantText. The clawborrator
+// reply tool already routes the user-facing answer over the WS — pre-
+// reply text from the model is nearly identical and would render as a
+// duplicate row in chat.
+const TOOLS_SKIPPED_FOR_PRE_TEXT = new Set([
+    'mcp__clawborrator__reply',
+]);
+async function readStdin() {
+    return new Promise((res) => {
+        let buf = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (chunk) => { buf += chunk; });
+        process.stdin.on('end', () => res(buf));
+        process.stdin.on('close', () => res(buf));
+    });
+}
+async function postEvent(sidecar, body, timeoutMs) {
+    const ctl = new AbortController();
+    const timer = setTimeout(() => ctl.abort(), timeoutMs);
+    try {
+        const res = await fetch(`${sidecar.hubUrl}/api/channel/event`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${sidecar.channelToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+            signal: ctl.signal,
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            log.warn('hub rejected event', { kind: body.kind, type: body.type, status: res.status, body: text.slice(0, 240) });
+            return false;
+        }
+        return true;
+    }
+    catch (e) {
+        log.warn('event POST failed', { kind: body.kind, type: body.type, error: e?.message ?? String(e) });
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// Stop / SubagentStop: try to populate payload.assistant_text from
+// (in order) last_assistant_message → existing payload fields →
+// transcript tail. Mutates payload in place.
+async function enrichStopAssistantText(payload, hookName) {
+    if (typeof payload.assistant_text === 'string' && payload.assistant_text.trim())
+        return;
+    const fromLAM = extractFromLastAssistantMessage(payload.last_assistant_message);
+    if (fromLAM) {
+        payload.assistant_text = fromLAM;
+        log.debug('stop: assistant_text from last_assistant_message', { chars: fromLAM.length });
+        return;
+    }
+    if (typeof payload.text === 'string' && payload.text.trim() ||
+        typeof payload.response === 'string' && payload.response.trim()) {
+        return; // a string-shaped variant is already there; let downstream use it
+    }
+    const transcriptPath = typeof payload.transcript_path === 'string' ? payload.transcript_path : '';
+    if (!transcriptPath) {
+        log.debug('stop: no transcript_path on payload, no assistant_text recoverable', { hookName });
+        return;
+    }
+    // Sleep so CC has time to flush the just-finished assistant message
+    // to disk before we tail-read. Without this, on some CC versions the
+    // read returns the PRIOR turn's text, which would render the wrong
+    // reply on attached operators' TUI.
+    await new Promise((r) => setTimeout(r, 500));
+    const text = extractFinalAnswerFromTranscript(transcriptPath, DEFAULT_TAIL_BYTES);
+    if (text) {
+        payload.assistant_text = text;
+        log.info('stop: assistant_text extracted from transcript', { chars: text.length });
+    }
+    else {
+        log.debug('stop: transcript had no assistant-text block in tail window', { hookName, path: transcriptPath });
+    }
+}
+// PreToolUse: ship every text block Claude wrote in the same
+// assistant message BEFORE this tool_use as its own chat/assistant_text
+// event. If no text blocks but extended-thinking blocks were present
+// (CC strips thinking plaintext on disk; only the signature survives),
+// ship a single placeholder so the operator sees a "claude was
+// thinking here" marker.
+async function shipPreToolAssistantText(sidecar, payload) {
+    const transcriptPath = typeof payload.transcript_path === 'string' ? payload.transcript_path : '';
+    const toolUseId = String(payload.tool_use_id ?? payload.toolUseId ?? '');
+    const toolName = String(payload.tool_name ?? payload.toolName ?? '');
+    if (!transcriptPath || !toolUseId)
+        return;
+    if (TOOLS_SKIPPED_FOR_PRE_TEXT.has(toolName))
+        return;
+    // Race-retry: CC writes the assistant message that DECIDED the
+    // tool_use to the transcript ASYNC, so a fresh read right after the
+    // hook fires can miss it. Retry up to 4 times with 80ms delays.
+    let messages = readTranscriptMessages(transcriptPath, DEFAULT_TAIL_BYTES);
+    let foundTarget = messageContainsToolUse(messages, toolUseId);
+    let retries = 0;
+    while (!foundTarget && retries < 4) {
+        await new Promise((r) => setTimeout(r, 80));
+        messages = readTranscriptMessages(transcriptPath, DEFAULT_TAIL_BYTES);
+        foundTarget = messageContainsToolUse(messages, toolUseId);
+        retries++;
+    }
+    const blocks = extractTextBlocksBeforeToolUse(messages, toolUseId);
+    const hasThinking = blocks.length === 0 ? hasThinkingBlocksBeforeToolUse(messages, toolUseId) : false;
+    log.debug('PreToolUse extract', {
+        toolUseId: toolUseId.slice(0, 24),
+        messages: messages.length,
+        targetFound: foundTarget,
+        retries,
+        blocks: blocks.length,
+        placeholder: hasThinking,
+    });
+    // Monotonic timestamps so events sort chronologically on the hub
+    // (chat_events orders by ts; ties broken by id, but ts ordering is
+    // the human signal). We use ms epoch then convert to ISO.
+    const baseMs = Date.now();
+    const tsAt = (i) => new Date(baseMs + i).toISOString();
+    if (blocks.length > 0) {
+        // Fire all AssistantText POSTs in parallel — sequential with 600ms
+        // each could exceed CC's hook timeout on multi-block turns.
+        await Promise.all(blocks.map((text, i) => postEvent(sidecar, {
+            sessionId: sidecar.sessionId,
+            kind: 'chat',
+            type: 'assistant_text',
+            payload: { text, toolUseId },
+            ts: tsAt(i),
+        }, 800)));
+    }
+    else if (hasThinking) {
+        await postEvent(sidecar, {
+            sessionId: sidecar.sessionId,
+            kind: 'chat',
+            type: 'assistant_text',
+            payload: {
+                text: '(extended thinking — content not in transcript)',
+                toolUseId,
+                placeholder: true,
+            },
+            ts: tsAt(0),
+        }, 800);
+    }
+}
+export async function runHook(hookName) {
+    const map = HOOK_TO_EVENT[hookName];
+    if (!map) {
+        log.warn('unknown hook name; skipping', { hookName });
+        process.exit(0);
+    }
+    const stdinRaw = await readStdin();
+    // Always echo stdin so Claude's hook chain sees the original payload.
+    if (stdinRaw)
+        process.stdout.write(stdinRaw);
+    let payload = {};
+    try {
+        if (stdinRaw.trim())
+            payload = JSON.parse(stdinRaw);
+    }
+    catch {
+        payload = { rawStdin: stdinRaw.slice(0, 2000) };
+    }
+    const sidecar = findSidecar(process.cwd());
+    if (!sidecar) {
+        log.warn('hook fired but no sidecar found — channel must not be running', { cwd: process.cwd() });
+        process.exit(0);
+    }
+    try {
+        if (hookName === 'Stop') {
+            // Real turn end — extract final answer + ship chat/reply so
+            // attached operators see Claude's response in the chat lane.
+            // The tail Stop event below marks the boundary.
+            await enrichStopAssistantText(payload, hookName);
+            const reply = typeof payload.assistant_text === 'string' ? payload.assistant_text.trim() : '';
+            if (reply) {
+                await postEvent(sidecar, {
+                    sessionId: sidecar.sessionId,
+                    kind: 'chat',
+                    type: 'reply',
+                    payload: { text: reply },
+                    ts: new Date().toISOString(),
+                }, 2000);
+            }
+        }
+        else if (hookName === 'SubagentStop') {
+            // A Task-tool subagent finished. NOT a final-answer event — the
+            // parent agent is still running and will fire its own Stop later.
+            // Some CC versions populate `last_assistant_message` with the
+            // subagent's INPUT prompt rather than its reply, which previously
+            // surfaced as a misleading chat/reply row. We still record the
+            // tail event below for activity-lane visibility, but skip the
+            // chat/reply ship entirely.
+        }
+        else if (hookName === 'PreToolUse') {
+            await shipPreToolAssistantText(sidecar, payload);
+        }
+    }
+    catch (e) {
+        log.warn('pre-event enrichment threw', { error: e?.message ?? String(e), hookName });
+    }
+    // Main hook event POST.
+    await postEvent(sidecar, {
+        sessionId: sidecar.sessionId,
+        kind: map.kind,
+        type: map.type,
+        payload,
+        ts: new Date().toISOString(),
+    }, 5000);
+    process.exit(0);
+}
+//# sourceMappingURL=hook.js.map

package/dist/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../src/hook.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,QAAQ;AACR,EAAE;AACF,+EAA+E;AAC/E,EAAE;AACF,mDAAmD;AACnD,yBAAyB;AACzB,0DAA0D;AAC1D,2DAA2D;AAC3D,qEAAqE;AACrE,iCAAiC;AACjC,oEAAoE;AACpE,oEAAoE;AACpE,kEAAkE;AAClE,sEAAsE;AACtE,iBAAiB;AACjB,uEAAuE;AACvE,gEAAgE;AAEhE,OAAO,EAAE,WAAW,EAAuB,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,8BAA8B,EAC9B,8BAA8B,EAC9B,+BAA+B,EAC/B,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,kEAAkE;AAClE,sEAAsE;AACtE,gBAAgB;AAChB,MAAM,aAAa,GAA4D;IAC7E,gBAAgB,EAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;IACrD,UAAU,EAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE;IACzD,WAAW,EAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE;IAC1D,kBAAkB,EAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,EAAE;IACjE,IAAI,EAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IACnD,YAAY,EAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE;IAC3D,YAAY,EAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE;IAC3D,UAAU,EAAW,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE;IACzD,WAAW,EAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE;IAC1D,aAAa,EAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE;IAC5D,YAAY,EAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE;IAC3D,aAAa,EAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE;CAC7D,CAAC;AAEF,wEAAwE;AACxE,sEAAsE;AACtE,sEAAsE;AACtE,yBAAyB;AACzB,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IACzC,0BAA0B;CAC3B,CAAC,CAAC;AAEH,KAAK,UAAU,SAAS;IACtB,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QACzB,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAG,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAUD,KAAK,UAAU,SAAS,CAAC,OAAuB,EAAE,IAAc,EAAE,SAAiB;IACjF,MAAM,GAAG,GAAG,IAAI,eAAe,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,CAAC,MAAM,oBAAoB,EAAE;YAC7D,MAAM,EAAG,MAAM;YACf,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,OAAO,CAAC,YAAY,EAAE;gBACjD,cAAc,EAAG,kBAAkB;aACpC;YACD,IAAI,EAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC5B,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACnH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpG,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,gEAAgE;AAChE,6CAA6C;AAC7C,KAAK,UAAU,uBAAuB,CAAC,OAAgC,EAAE,QAAgB;IACvF,IAAI,OAAO,OAAO,CAAC,cAAc,KAAK,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE;QAAE,OAAO;IAExF,MAAM,OAAO,GAAG,+BAA+B,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAChF,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC;QACjC,GAAG,CAAC,KAAK,CAAC,kDAAkD,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACzF,OAAO;IACT,CAAC;IAED,IACE,OAAO,OAAO,CAAC,IAAI,KAAS,QAAQ,IAAK,OAAO,CAAC,IAAmB,CAAC,IAAI,EAAE;QAC3E,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAK,OAAO,CAAC,QAAmB,CAAC,IAAI,EAAE,EAC3E,CAAC;QACD,OAAO,CAAC,kEAAkE;IAC5E,CAAC;IAED,MAAM,cAAc,GAAG,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAClG,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,GAAG,CAAC,KAAK,CAAC,oEAAoE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9F,OAAO;IACT,CAAC;IAED,oEAAoE;IACpE,qEAAqE;IACrE,mEAAmE;IACnE,oCAAoC;IACpC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAE7C,MAAM,IAAI,GAAG,gCAAgC,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAClF,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,gDAAgD,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrF,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,KAAK,CAAC,6DAA6D,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;IAC/G,CAAC;AACH,CAAC;AAED,6DAA6D;AAC7D,wEAAwE;AACxE,qEAAqE;AACrE,uEAAuE;AACvE,+DAA+D;AAC/D,yBAAyB;AACzB,KAAK,UAAU,wBAAwB,CACrC,OAAuB,EACvB,OAAgC;IAEhC,MAAM,cAAc,GAAG,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAClG,MAAM,SAAS,GAAQ,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAS,MAAM,CAAC,OAAO,CAAC,SAAS,IAAM,OAAO,CAAC,QAAQ,IAAK,EAAE,CAAC,CAAC;IAC9E,IAAI,CAAC,cAAc,IAAI,CAAC,SAAS;QAAE,OAAO;IAC1C,IAAI,0BAA0B,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO;IAErD,+DAA+D;IAC/D,oEAAoE;IACpE,gEAAgE;IAChE,IAAI,QAAQ,GAAG,sBAAsB,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IAC1E,IAAI,WAAW,GAAG,sBAAsB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,CAAC,WAAW,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5C,QAAQ,GAAG,sBAAsB,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACtE,WAAW,GAAG,sBAAsB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC1D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,8BAA8B,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,8BAA8B,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEtG,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE;QAC9B,SAAS,EAAK,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACpC,QAAQ,EAAM,QAAQ,CAAC,MAAM;QAC7B,WAAW,EAAG,WAAW;QACzB,OAAO;QACP,MAAM,EAAQ,MAAM,CAAC,MAAM;QAC3B,WAAW,EAAG,WAAW;KAC1B,CAAC,CAAC;IAEH,iEAAiE;IACjE,mEAAmE;IACnE,0DAA0D;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAE/D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,mEAAmE;QACnE,4DAA4D;QAC5D,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACvC,SAAS,CAAC,OAAO,EAAE;YACjB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI,EAAO,MAAM;YACjB,IAAI,EAAO,gBAAgB;YAC3B,OAAO,EAAI,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9B,EAAE,EAAS,IAAI,CAAC,CAAC,CAAC;SACnB,EAAE,GAAG,CAAC,CACR,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,WAAW,EAAE,CAAC;QACvB,MAAM,SAAS,CAAC,OAAO,EAAE;YACvB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI,EAAO,MAAM;YACjB,IAAI,EAAO,gBAAgB;YAC3B,OAAO,EAAI;gBACT,IAAI,EAAS,iDAAiD;gBAC9D,SAAS;gBACT,WAAW,EAAE,IAAI;aAClB;YACD,EAAE,EAAS,IAAI,CAAC,CAAC,CAAC;SACnB,EAAE,GAAG,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAgB;IAC5C,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,SAAS,EAAE,CAAC;IACnC,sEAAsE;IACtE,IAAI,QAAQ;QAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,OAAO,GAA4B,EAAE,CAAC;IAC1C,IAAI,CAAC;QACH,IAAI,QAAQ,CAAC,IAAI,EAAE;YAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,EAAE,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,OAAO,GAA0B,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAClE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,GAAG,CAAC,IAAI,CAAC,+DAA+D,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAClG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YACxB,4DAA4D;YAC5D,6DAA6D;YAC7D,gDAAgD;YAChD,MAAM,uBAAuB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9F,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,SAAS,CAAC,OAAO,EAAE;oBACvB,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,IAAI,EAAO,MAAM;oBACjB,IAAI,EAAO,OAAO;oBAClB,OAAO,EAAI,EAAE,IAAI,EAAE,KAAK,EAAE;oBAC1B,EAAE,EAAS,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,EAAE,IAAI,CAAC,CAAC;YACX,CAAC;QACH,CAAC;aAAM,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YACvC,gEAAgE;YAChE,kEAAkE;YAClE,8DAA8D;YAC9D,kEAAkE;YAClE,+DAA+D;YAC/D,8DAA8D;YAC9D,4BAA4B;QAC9B,CAAC;aAAM,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YACrC,MAAM,wBAAwB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,wBAAwB;IACxB,MAAM,SAAS,CAAC,OAAO,EAAE;QACvB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,IAAI,EAAO,GAAG,CAAC,IAAI;QACnB,IAAI,EAAO,GAAG,CAAC,IAAI;QACnB,OAAO;QACP,EAAE,EAAS,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,EAAE,IAAI,CAAC,CAAC;IAET,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/inbox.d.ts

@@ -0,0 +1,9 @@
+interface InboxEntry {
+    chatId: string;
+    text: string;
+}
+export declare function enqueueRoutedPrompt(entry: InboxEntry): void;
+export declare function tryDequeue(): InboxEntry | null;
+export declare function awaitDequeue(maxWaitMs: number): Promise<InboxEntry | null>;
+export declare function inboxSize(): number;
+export {};

package/dist/inbox.js

@@ -0,0 +1,55 @@
+// In-memory inbox for routed prompts arriving from the hub. The
+// `await_routed_prompt` MCP tool reads from here.
+//
+// Why a queue rather than callback-driven: Claude Code can only see
+// "messages" the operator types (or that the MCP returns from a tool
+// call). To inject a routed prompt, the only mechanism we have today
+// is for Claude to CALL a tool that returns the pending prompt as
+// its result — Claude then treats the result as the next thing to
+// answer.
+//
+// The convention in CLAUDE.md / the tool description is: at the
+// start of each turn, Claude calls `await_routed_prompt({maxWaitMs:0})`.
+// If the result has a non-null prompt, Claude answers by calling
+// `reply({chat_id, text})` and skips its normal user-facing reply.
+const queue = [];
+let waiters = [];
+export function enqueueRoutedPrompt(entry) {
+    // If a waiter is parked, hand off directly.
+    const w = waiters.shift();
+    if (w) {
+        w(entry);
+        return;
+    }
+    queue.push(entry);
+}
+export function tryDequeue() {
+    return queue.shift() ?? null;
+}
+export function awaitDequeue(maxWaitMs) {
+    const immediate = tryDequeue();
+    if (immediate || maxWaitMs <= 0) {
+        return Promise.resolve(immediate);
+    }
+    return new Promise((resolve) => {
+        let resolved = false;
+        let timer = null;
+        const settle = (entry) => {
+            if (resolved)
+                return;
+            resolved = true;
+            const i = waiters.indexOf(settle);
+            if (i >= 0)
+                waiters.splice(i, 1);
+            if (timer)
+                clearTimeout(timer);
+            resolve(entry);
+        };
+        waiters.push(settle);
+        timer = setTimeout(() => settle(null), maxWaitMs);
+    });
+}
+export function inboxSize() {
+    return queue.length;
+}
+//# sourceMappingURL=inbox.js.map

package/dist/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../src/inbox.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,kDAAkD;AAClD,EAAE;AACF,oEAAoE;AACpE,qEAAqE;AACrE,qEAAqE;AACrE,kEAAkE;AAClE,kEAAkE;AAClE,UAAU;AACV,EAAE;AACF,gEAAgE;AAChE,yEAAyE;AACzE,iEAAiE;AACjE,mEAAmE;AAOnE,MAAM,KAAK,GAAiB,EAAE,CAAC;AAC/B,IAAI,OAAO,GAA2C,EAAE,CAAC;AAEzD,MAAM,UAAU,mBAAmB,CAAC,KAAiB;IACnD,4CAA4C;IAC5C,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,CAAC;QAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAAC,OAAO;IAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,KAAK,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB;IAC5C,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;IAC/B,IAAI,SAAS,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,KAAK,GAA0B,IAAI,CAAC;QACxC,MAAM,MAAM,GAAG,CAAC,KAAwB,EAAE,EAAE;YAC1C,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjC,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,140 @@
+// MCP entrypoint. Phase A: open the WS to hub, register, log every
+// inbound message to stderr. Subsequent phases will:
+//   - install hooks (Phase B) that turn into chat_event/tail_event sends
+//   - wire permission relay (Phase C)
+//   - register MCP tools (reply, list_peers, route_to_peer, probe_peers)
+//     for Claude to call (Phase D)
+//
+// In Phase A we still need the MCP transport open so Claude Code's
+// MCP-discovery handshake succeeds; otherwise the user sees "MCP
+// server failed to start." We register a no-op tool list — Claude
+// gets an empty tools/list response and the WS work proceeds in the
+// background.
+import { hostname } from 'node:os';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { loadConfig } from './config.js';
+import { ChannelClient } from './ws-client.js';
+import { log } from './log.js';
+import { runHook } from './hook.js';
+import { writeSidecar, deleteSidecar } from './sidecar.js';
+import { TOOL_DEFINITIONS, callTool } from './tools/index.js';
+import { enqueueRoutedPrompt } from './inbox.js';
+// Dispatch on --hook=<HookName> first; that's the short-lived spawn
+// path Claude Code's hook system uses. Without it, fall through to
+// the long-lived MCP stdio server.
+const hookFlag = process.argv.find((a) => a.startsWith('--hook='));
+if (hookFlag) {
+    const name = hookFlag.slice('--hook='.length);
+    runHook(name).catch((err) => {
+        log.error('hook fatal', { error: String(err) });
+        process.exit(0); // never fail the operator's actual Claude flow
+    });
+}
+else {
+    main().catch((err) => {
+        log.error('fatal', { error: String(err), stack: err?.stack });
+        process.exit(1);
+    });
+}
+async function main() {
+    let config;
+    try {
+        config = loadConfig();
+    }
+    catch (e) {
+        log.error('config invalid', { error: String(e) });
+        process.exit(2);
+    }
+    log.info('clawborrator-mcp starting', { hubUrl: config.hubUrl });
+    const cwd = process.cwd();
+    const host = hostname();
+    // Open the channel-side WS to hub.
+    const client = new ChannelClient(config, {
+        onWelcome: (m) => {
+            log.info('session ready', {
+                sessionId: m.sessionId,
+                routingName: m.routingName,
+                channelToken: m.channelTokenName,
+            });
+            // Sidecar — Phase B hooks read this. The hub URL on the sidecar
+            // is the HTTP form (hooks POST over HTTPS, not WS).
+            const httpHubUrl = config.hubUrl.replace(/^ws/i, 'http');
+            writeSidecar({
+                sessionId: m.sessionId,
+                routingName: m.routingName,
+                hubUrl: httpHubUrl,
+                channelToken: config.token,
+                host,
+                cwd,
+                writtenAt: new Date().toISOString(),
+            });
+        },
+        onPrompt: (m) => {
+            // A peer session routed a prompt to us. Push to the inbox so
+            // the next `await_routed_prompt` tool call can pick it up.
+            log.info('prompt received', { chatId: m.chatId, text: m.text });
+            enqueueRoutedPrompt({ chatId: m.chatId, text: m.text });
+        },
+        onPermissionResponse: (m) => {
+            // Phase C: the operator (or auto-expire) resolved a permission.
+            // We surface it in the log so operators running with
+            // CLAWBORRATOR_LOG_LEVEL=info can see decisions land. Real
+            // hook integration (where this decision routes back to a
+            // pending hook spawn) is a follow-on once we wire IPC between
+            // the long-lived MCP and the short-lived hook process.
+            log.info('permission resolved', {
+                requestId: m.requestId,
+                decision: m.decision,
+                message: m.message ?? null,
+            });
+        },
+        onError: (m) => {
+            log.error('hub rejected', { code: m.code, message: m.message });
+        },
+    });
+    client.connect();
+    // MCP stdio transport. Phase D ships the four routing tools.
+    const server = new Server({
+        name: 'clawborrator',
+        version: '0.0.1',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Track our session id so tools (and future use) can reference it.
+    // Set by the onWelcome handler above.
+    let toolCtxSessionId = null;
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: TOOL_DEFINITIONS.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const args = (req.params.arguments ?? {});
+        return await callTool({ client, sessionId: toolCtxSessionId }, req.params.name, args);
+    });
+    void toolCtxSessionId;
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log.info('mcp transport connected');
+    // Clean shutdown on common signals so the WS goes away cleanly +
+    // sidecar gets removed so a stale file doesn't mislead future hooks.
+    for (const sig of ['SIGINT', 'SIGTERM']) {
+        process.on(sig, () => {
+            log.info('shutting down', { signal: sig });
+            client.stop();
+            deleteSidecar(cwd);
+            transport.close().catch(() => { });
+            setTimeout(() => process.exit(0), 200);
+        });
+    }
+    // Last-ditch sidecar cleanup. Even on uncaught exceptions, we'd
+    // rather not leave a stale file pointing at a dead WS.
+    process.on('exit', () => deleteSidecar(cwd));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/log.d.ts

@@ -0,0 +1,6 @@
+export declare const log: {
+    debug: (msg: string, fields?: Record<string, unknown>) => void;
+    info: (msg: string, fields?: Record<string, unknown>) => void;
+    warn: (msg: string, fields?: Record<string, unknown>) => void;
+    error: (msg: string, fields?: Record<string, unknown>) => void;
+};