clawborrator-mcp 0.0.1 → 0.0.3

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,12 @@ 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.
+import { installHooks } from './install-hooks.js';
+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 +38,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 });
@@ -50,6 +70,32 @@ async function main() {
     log.info('clawborrator-mcp starting', { hubUrl: config.hubUrl });
     const cwd = process.cwd();
     const host = hostname();
+    // Self-install / refresh project hooks in .claude/. Idempotent —
+    // touches files only when the desired state diverges from disk, so
+    // re-runs of `claude` cost nothing. Operators no longer need to
+    // run a separate `init` command — dropping a .mcp.json with a
+    // valid channel token is the only setup step.
+    try {
+        const r = installHooks(cwd);
+        if (r.hookFileWritten || r.settingsWritten) {
+            log.info('hooks installed', {
+                hookFile: r.hookFileWritten,
+                settings: r.settingsWritten,
+                added: r.added,
+                refreshed: r.refreshed,
+                alreadyOk: r.alreadyOk,
+                path: r.hookFilePath,
+            });
+        }
+        else {
+            log.debug('hooks already up-to-date', { added: r.added, refreshed: r.refreshed, alreadyOk: r.alreadyOk });
+        }
+    }
+    catch (e) {
+        // Don't fail boot — operator can still drive Claude; just log so
+        // they see hooks aren't capturing.
+        log.warn('install-hooks failed', { error: e?.message ?? String(e) });
+    }
     // Open the channel-side WS to hub.
     const client = new ChannelClient(config, {
         onWelcome: (m) => {

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/install-hooks.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Install/maintain .claude/settings.json + .claude/hooks/clawborrator-
+ * tail.mjs for the project at `cwd`. Returns a summary describing what
+ * changed; useful for boot-time logging.
+ */
+export declare function installHooks(cwd: string): {
+    hookFileWritten: boolean;
+    settingsWritten: boolean;
+    added: number;
+    refreshed: number;
+    alreadyOk: number;
+    hookFilePath: string;
+};

package/dist/install-hooks.js

@@ -0,0 +1,139 @@
+// Self-installer for Claude Code hook config + the bundled hook
+// entry. Called once per long-lived MCP startup. Idempotent —
+// touches files only when the desired state differs from what's on
+// disk, so re-launches don't churn mtimes or git diffs.
+//
+// Two artifacts maintained:
+//   1. <cwd>/.claude/hooks/clawborrator-tail.mjs — bytewise copy of
+//      this package's bundled dist-hook/clawborrator-tail.mjs. Hooks
+//      run `node` against this path so per-hook latency is just
+//      Node startup, not an npx + registry round-trip.
+//   2. <cwd>/.claude/settings.json — 12 hook entries (one per
+//      Claude-Code hook name), each invoking the local .mjs above.
+//      We tag every entry with a #clawborrator-hook sentinel so we
+//      can detect + refresh our own entries without disturbing
+//      anything else the operator added.
+import { readFileSync, writeFileSync, existsSync, mkdirSync, chmodSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { log } from './log.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const HOOK_NAMES = [
+    'SessionStart',
+    'SessionEnd',
+    'UserPromptSubmit',
+    'PreToolUse',
+    'PostToolUse',
+    'PostToolUseFailure',
+    'TaskCreated',
+    'SubagentStart',
+    'SubagentStop',
+    'TaskCompleted',
+    'Stop',
+    'Notification',
+];
+const TAG = 'clawborrator-hook';
+function isOurHook(h) {
+    return h.type === 'command' && h.command.includes(`#${TAG}`);
+}
+function hookCommand(name) {
+    // Hooks run with cwd = project root. Quoting the path keeps Windows
+    // paths with spaces working.
+    return `node ".claude/hooks/clawborrator-tail.mjs" ${name} #${TAG}`;
+}
+// Find the bundled dist-hook/clawborrator-tail.mjs that ships next
+// to this compiled module. Compiled __dirname is .../dist or
+// .../dist-bundled depending on the build flavor; the bundle lives
+// alongside at .../dist-hook/.
+function findBundledHookFile() {
+    const candidates = [
+        resolve(__dirname, '..', 'dist-hook', 'clawborrator-tail.mjs'),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+/**
+ * Install/maintain .claude/settings.json + .claude/hooks/clawborrator-
+ * tail.mjs for the project at `cwd`. Returns a summary describing what
+ * changed; useful for boot-time logging.
+ */
+export function installHooks(cwd) {
+    const claudeDir = resolve(cwd, '.claude');
+    const hooksDir = resolve(claudeDir, 'hooks');
+    const hookFile = resolve(hooksDir, 'clawborrator-tail.mjs');
+    const settings = resolve(claudeDir, 'settings.json');
+    const bundleSource = findBundledHookFile();
+    if (!bundleSource) {
+        log.warn('install-hooks: bundled hook file not found in this package; skipping');
+        return { hookFileWritten: false, settingsWritten: false, added: 0, refreshed: 0, alreadyOk: 0, hookFilePath: hookFile };
+    }
+    if (!existsSync(claudeDir))
+        mkdirSync(claudeDir, { recursive: true });
+    if (!existsSync(hooksDir))
+        mkdirSync(hooksDir, { recursive: true });
+    // 1) Copy the bundled .mjs only if its bytes differ from what's
+    //    already on disk. Compare exact bytes — cheaper than hashing
+    //    and good enough for files this small.
+    const bundleBytes = readFileSync(bundleSource);
+    let hookFileWritten = false;
+    if (!existsSync(hookFile) || !readFileSync(hookFile).equals(bundleBytes)) {
+        writeFileSync(hookFile, bundleBytes);
+        try {
+            chmodSync(hookFile, 0o755);
+        }
+        catch { /* Windows */ }
+        hookFileWritten = true;
+    }
+    // 2) Read existing settings.json (tolerate missing/empty).
+    let s = {};
+    let originalText = '';
+    if (existsSync(settings)) {
+        try {
+            originalText = readFileSync(settings, 'utf8');
+            if (originalText.trim())
+                s = JSON.parse(originalText);
+        }
+        catch (e) {
+            log.warn('install-hooks: settings.json unparseable, leaving alone', { error: e?.message ?? String(e) });
+            return { hookFileWritten, settingsWritten: false, added: 0, refreshed: 0, alreadyOk: 0, hookFilePath: hookFile };
+        }
+    }
+    if (!s.hooks)
+        s.hooks = {};
+    let added = 0, refreshed = 0, alreadyOk = 0;
+    for (const name of HOOK_NAMES) {
+        const arr = (s.hooks[name] ??= []);
+        let entry = arr.find((e) => (e.matcher ?? '.*') === '.*');
+        if (!entry) {
+            entry = { matcher: '.*', hooks: [] };
+            arr.push(entry);
+        }
+        const desiredCmd = hookCommand(name);
+        const existingIdx = entry.hooks.findIndex(isOurHook);
+        if (existingIdx >= 0) {
+            if (entry.hooks[existingIdx].command !== desiredCmd) {
+                entry.hooks[existingIdx] = { type: 'command', command: desiredCmd };
+                refreshed++;
+            }
+            else {
+                alreadyOk++;
+            }
+        }
+        else {
+            entry.hooks.push({ type: 'command', command: desiredCmd });
+            added++;
+        }
+    }
+    // 3) Write only if the serialized form changed.
+    const newText = JSON.stringify(s, null, 2) + '\n';
+    let settingsWritten = false;
+    if (newText !== originalText) {
+        writeFileSync(settings, newText);
+        settingsWritten = true;
+    }
+    return { hookFileWritten, settingsWritten, added, refreshed, alreadyOk, hookFilePath: hookFile };
+}
+//# sourceMappingURL=install-hooks.js.map

package/dist/install-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-hooks.js","sourceRoot":"","sources":["../src/install-hooks.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.3",
   "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"
   }