clawborrator-mcp 0.0.1 → 0.0.2

package/dist/hook-entry.d.ts

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

package/dist/hook-entry.js

@@ -0,0 +1,23 @@
+// Standalone bundled hook entry. esbuild rolls this + everything it
+// transitively imports (sidecar, transcript, log, hook) into a single
+// dist-hook/clawborrator-tail.mjs that gets copied into a project's
+// .claude/hooks/ at `claw session init` time.
+//
+// Hooks then run as plain `node .claude/hooks/clawborrator-tail.mjs
+// <HookName>` — no npx, no registry lookup, no install. Same shape
+// as the original clawborrator-channel package.
+//
+// Usage from .claude/settings.json:
+//   { "type": "command", "command": "node \".claude/hooks/clawborrator-tail.mjs\" PreToolUse" }
+import { runHook } from './hook.js';
+import { log } from './log.js';
+const hookName = process.argv[2];
+if (!hookName) {
+    log.error('hook entry invoked without a hook name argument');
+    process.exit(0); // never fail Claude's hook chain
+}
+runHook(hookName).catch((err) => {
+    log.error('hook fatal', { error: String(err) });
+    process.exit(0);
+});
+//# sourceMappingURL=hook-entry.js.map

package/dist/hook-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-entry.js","sourceRoot":"","sources":["../src/hook-entry.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,sEAAsE;AACtE,oEAAoE;AACpE,8CAA8C;AAC9C,EAAE;AACF,oEAAoE;AACpE,mEAAmE;AACnE,gDAAgD;AAChD,EAAE;AACF,oCAAoC;AACpC,gGAAgG;AAEhG,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjC,IAAI,CAAC,QAAQ,EAAE,CAAC;IACd,GAAG,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAE,iCAAiC;AACrD,CAAC;AAED,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACvC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.js

@@ -11,6 +11,9 @@
 // gets an empty tools/list response and the WS work proceeds in the
 // background.
 import { hostname } from 'node:os';
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { ListToolsRequestSchema, CallToolRequestSchema } from '@modelcontextprotocol/sdk/types.js';
@@ -21,9 +24,11 @@ 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 __dirname = dirname(fileURLToPath(import.meta.url));
+// Dispatch on top-level flags BEFORE booting the long-lived MCP.
+//   --hook=<HookName>     short-lived hook spawn (fast path)
+//   --print-hook-file     stream the bundled dist-hook/.mjs to stdout
+//   (none)                long-lived stdio MCP server
 const hookFlag = process.argv.find((a) => a.startsWith('--hook='));
 if (hookFlag) {
     const name = hookFlag.slice('--hook='.length);
@@ -32,6 +37,20 @@ if (hookFlag) {
         process.exit(0); // never fail the operator's actual Claude flow
     });
 }
+else if (process.argv.includes('--print-hook-file')) {
+    // Used by `claw session init` to materialize a local copy of the
+    // bundled hook entry into the project's .claude/hooks/ folder.
+    // dist-hook/clawborrator-tail.mjs is built by esbuild at publish
+    // time and shipped in the package's `files` allow-list.
+    // Compiled __dirname is dist/, so the bundle is at ../dist-hook.
+    const candidate = resolve(__dirname, '..', 'dist-hook', 'clawborrator-tail.mjs');
+    if (!existsSync(candidate)) {
+        process.stderr.write(`[clawborrator-mcp] bundled hook file missing at ${candidate}\n`);
+        process.exit(2);
+    }
+    process.stdout.write(readFileSync(candidate, 'utf8'));
+    process.exit(0);
+}
 else {
     main().catch((err) => {
         log.error('fatal', { error: String(err), stack: err?.stack });

package/dist/index.js.map

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

package/dist-hook/clawborrator-tail.mjs

@@ -0,0 +1,369 @@
+#!/usr/bin/env node
+
+// src/sidecar.ts
+import { resolve } from "node:path";
+import { mkdirSync, writeFileSync, readFileSync, unlinkSync, chmodSync, existsSync } from "node:fs";
+
+// src/log.ts
+var LEVELS = { debug: 10, info: 20, warn: 30, error: 40 };
+var MIN = LEVELS[process.env.CLAWBORRATOR_LOG_LEVEL || "info"] ?? LEVELS.info;
+function emit(level, msg, fields) {
+  if (LEVELS[level] < MIN) return;
+  const line = JSON.stringify({
+    ts: (/* @__PURE__ */ new Date()).toISOString(),
+    level,
+    msg,
+    ...fields
+  });
+  process.stderr.write(line + "\n");
+}
+var log = {
+  debug: (msg, fields) => emit("debug", msg, fields),
+  info: (msg, fields) => emit("info", msg, fields),
+  warn: (msg, fields) => emit("warn", msg, fields),
+  error: (msg, fields) => emit("error", msg, fields)
+};
+
+// src/sidecar.ts
+function sidecarPath(cwd) {
+  return resolve(cwd, ".claude", "clawborrator.session.json");
+}
+function readSidecar(cwd) {
+  try {
+    const raw = readFileSync(sidecarPath(cwd), "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function findSidecar(start) {
+  let dir = resolve(start);
+  for (let i = 0; i < 32; i++) {
+    const found = readSidecar(dir);
+    if (found) return found;
+    const parent = resolve(dir, "..");
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+// src/transcript.ts
+import { openSync, readSync, closeSync, statSync } from "node:fs";
+var DEFAULT_TAIL_BYTES = 256 * 1024;
+function readTranscriptMessages(path, tailBytes = DEFAULT_TAIL_BYTES) {
+  try {
+    const stat = statSync(path);
+    const start = Math.max(0, stat.size - tailBytes);
+    const fd = openSync(path, "r");
+    let raw;
+    try {
+      const buf = Buffer.alloc(stat.size - start);
+      readSync(fd, buf, 0, buf.length, start);
+      raw = buf.toString("utf8");
+    } finally {
+      closeSync(fd);
+    }
+    if (!raw) return [];
+    const lines = raw.split("\n").filter(Boolean);
+    if (start > 0 && lines.length > 0) lines.shift();
+    return lines.map((l) => {
+      try {
+        return JSON.parse(l);
+      } catch {
+        return null;
+      }
+    }).filter((m) => m !== null);
+  } catch {
+    return [];
+  }
+}
+function extractTextBlocksBeforeToolUse(messages, toolUseId) {
+  if (!toolUseId || !Array.isArray(messages)) return [];
+  let targetIdx = -1;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const m = messages[i];
+    if (m?.type !== "assistant") continue;
+    const content = m.message?.content;
+    if (!Array.isArray(content)) continue;
+    if (content.some((c) => c?.type === "tool_use" && c.id === toolUseId)) {
+      targetIdx = i;
+      break;
+    }
+  }
+  if (targetIdx < 0) return [];
+  const out = [];
+  for (let i = targetIdx - 1; i >= 0; i--) {
+    const m = messages[i];
+    if (m?.type === "user") break;
+    if (m?.type !== "assistant") continue;
+    const content = m.message?.content;
+    if (!Array.isArray(content)) continue;
+    for (let j = content.length - 1; j >= 0; j--) {
+      const c = content[j];
+      if (c?.type === "text" && typeof c.text === "string" && c.text.trim()) {
+        out.unshift(c.text);
+      }
+    }
+  }
+  return out;
+}
+function messageContainsToolUse(messages, toolUseId) {
+  if (!toolUseId || !Array.isArray(messages)) return false;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const m = messages[i];
+    if (m?.type !== "assistant") continue;
+    const content = m.message?.content;
+    if (!Array.isArray(content)) continue;
+    if (content.some((c) => c?.type === "tool_use" && c.id === toolUseId)) return true;
+  }
+  return false;
+}
+function hasThinkingBlocksBeforeToolUse(messages, toolUseId) {
+  if (!toolUseId || !Array.isArray(messages)) return false;
+  let targetIdx = -1;
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const m = messages[i];
+    if (m?.type !== "assistant") continue;
+    const content = m.message?.content;
+    if (!Array.isArray(content)) continue;
+    if (content.some((c) => c?.type === "tool_use" && c.id === toolUseId)) {
+      targetIdx = i;
+      break;
+    }
+  }
+  if (targetIdx < 0) return false;
+  for (let i = targetIdx - 1; i >= 0; i--) {
+    const m = messages[i];
+    if (m?.type === "user") break;
+    if (m?.type !== "assistant") continue;
+    const content = m.message?.content;
+    if (!Array.isArray(content)) continue;
+    if (content.some((c) => c?.type === "thinking")) return true;
+  }
+  return false;
+}
+function joinTextAfterLastToolUse(content) {
+  if (!Array.isArray(content)) return "";
+  let lastToolIdx = -1;
+  for (let j = content.length - 1; j >= 0; j--) {
+    if (content[j]?.type === "tool_use") {
+      lastToolIdx = j;
+      break;
+    }
+  }
+  const parts = content.slice(lastToolIdx + 1).filter((c) => c?.type === "text" && typeof c.text === "string").map((c) => c.text);
+  return parts.join("\n").trim();
+}
+function extractFromLastAssistantMessage(v) {
+  if (!v) return "";
+  if (typeof v === "string") return v.trim();
+  const obj = v;
+  const content = Array.isArray(obj.content) ? obj.content : obj.message && Array.isArray(obj.message.content) ? obj.message.content : null;
+  if (content) return joinTextAfterLastToolUse(content);
+  if (typeof obj.text === "string") return obj.text.trim();
+  return "";
+}
+function extractFinalAnswerFromTranscript(path, tailBytes = DEFAULT_TAIL_BYTES) {
+  const messages = readTranscriptMessages(path, tailBytes);
+  for (let i = messages.length - 1; i >= 0; i--) {
+    const m = messages[i];
+    if (m?.type !== "assistant") continue;
+    const content = m.message?.content;
+    if (!Array.isArray(content)) continue;
+    const joined = joinTextAfterLastToolUse(content);
+    if (joined) return joined;
+  }
+  return "";
+}
+
+// src/hook.ts
+var 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" }
+};
+var TOOLS_SKIPPED_FOR_PRE_TEXT = /* @__PURE__ */ 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);
+  }
+}
+async function enrichStopAssistantText(payload, hookName2) {
+  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;
+  }
+  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: hookName2 });
+    return;
+  }
+  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: hookName2, path: transcriptPath });
+  }
+}
+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;
+  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
+  });
+  const baseMs = Date.now();
+  const tsAt = (i) => new Date(baseMs + i).toISOString();
+  if (blocks.length > 0) {
+    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 \u2014 content not in transcript)",
+        toolUseId,
+        placeholder: true
+      },
+      ts: tsAt(0)
+    }, 800);
+  }
+}
+async function runHook(hookName2) {
+  const map = HOOK_TO_EVENT[hookName2];
+  if (!map) {
+    log.warn("unknown hook name; skipping", { hookName: hookName2 });
+    process.exit(0);
+  }
+  const stdinRaw = await readStdin();
+  if (stdinRaw) process.stdout.write(stdinRaw);
+  let payload = {};
+  try {
+    if (stdinRaw.trim()) payload = JSON.parse(stdinRaw);
+  } catch {
+    payload = { rawStdin: stdinRaw.slice(0, 2e3) };
+  }
+  const sidecar = findSidecar(process.cwd());
+  if (!sidecar) {
+    log.warn("hook fired but no sidecar found \u2014 channel must not be running", { cwd: process.cwd() });
+    process.exit(0);
+  }
+  try {
+    if (hookName2 === "Stop") {
+      await enrichStopAssistantText(payload, hookName2);
+      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: (/* @__PURE__ */ new Date()).toISOString()
+        }, 2e3);
+      }
+    } else if (hookName2 === "SubagentStop") {
+    } else if (hookName2 === "PreToolUse") {
+      await shipPreToolAssistantText(sidecar, payload);
+    }
+  } catch (e) {
+    log.warn("pre-event enrichment threw", { error: e?.message ?? String(e), hookName: hookName2 });
+  }
+  await postEvent(sidecar, {
+    sessionId: sidecar.sessionId,
+    kind: map.kind,
+    type: map.type,
+    payload,
+    ts: (/* @__PURE__ */ new Date()).toISOString()
+  }, 5e3);
+  process.exit(0);
+}
+
+// src/hook-entry.ts
+var hookName = process.argv[2];
+if (!hookName) {
+  log.error("hook entry invoked without a hook name argument");
+  process.exit(0);
+}
+runHook(hookName).catch((err) => {
+  log.error("hook fatal", { error: String(err) });
+  process.exit(0);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawborrator-mcp",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "type": "module",
   "description": "clawborrator channel for hub_v1 — MCP server that connects Claude Code to a hub over WebSocket, with hooks for activity capture and tools for cross-session routing.",
   "license": "MIT",
@@ -28,6 +28,7 @@
   },
   "files": [
     "dist",
+    "dist-hook",
     "bin",
     "README.md"
   ],
@@ -35,10 +36,12 @@
     "node": ">=20"
   },
   "scripts": {
-    "build":          "tsc -p tsconfig.json",
-    "dev":            "tsx watch src/index.ts",
-    "typecheck":      "tsc -p tsconfig.json --noEmit",
-    "start":          "node dist/index.js",
+    "build": "npm run build:tsc && npm run build:hook",
+    "build:tsc": "tsc -p tsconfig.json",
+    "build:hook": "esbuild src/hook-entry.ts --bundle --platform=node --format=esm --target=node20 --outfile=dist-hook/clawborrator-tail.mjs --banner:js=\"#!/usr/bin/env node\"",
+    "dev": "tsx watch src/index.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "start": "node dist/index.js",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
@@ -48,6 +51,7 @@
   "devDependencies": {
     "@types/node": "^22.7.5",
     "@types/ws": "^8.5.13",
+    "esbuild": "^0.24.2",
     "tsx": "^4.19.1",
     "typescript": "^5.6.2"
   }