cookbook-bridge 0.1.4 → 0.1.6

package/bridge.mjs

@@ -48,12 +48,14 @@ let createLocalServer, toolsForMode, modeForTools, vendorOf;
 let connectAgentsProgrammatic, detectClis;
 let serveCalls, describeCall, hostingMode;
 let fetchHands, claimHandsCall, reportHandsResult;
+let callsFromStreamLine, foldCallEvent, wireCalls;
 
 async function loadRuntime() {
   ({ createLocalServer, toolsForMode, modeForTools, vendorOf } = await import("./local.mjs"));
   ({ connectAgentsProgrammatic, detectClis } = await import("./device.mjs"));
   ({ listWorkspaces, listTasks, listOpenWork, getTask, threadResumeContext, completeTaskApi, resolveDelegation, reportTaskUsage, reportTaskProgress, volunteerClaim, dispatchClaim, abandonTask, recallMemories, recallAcrossWorkspaces, creditRecall, getVolunteerSettings, fetchHands, claimHandsCall, reportHandsResult, agentsQuery } = await import("./cookbook.mjs"));
   ({ serveCalls, describeCall, hostingMode } = await import("./hands.mjs"));
+  ({ callsFromStreamLine, foldCallEvent, wireCalls } = await import("./live.mjs"));
   ({ agentEnv, checkGeminiVersion, isGeminiCommand, GEMINI_MIN_VERSION, checkAgyVersion, isAgyCommand, AGY_MIN_VERSION, withCookbookMcp, isClaudeCommand } = await import("./harden.mjs"));
   ({ extractUsage, displayText } = await import("./usage.mjs"));
   ({ volunteeringEnabled, volunteerCandidates, decisionPrompt, parseDecision, MAX_DECISIONS_PER_POLL, mergeVolunteerSettings, effectiveCapabilities } = await import("./volunteer.mjs"));
@@ -229,6 +231,19 @@ export function allowedByPolicy(cfg, agent, task) {
 }
 
 
+/**
+ * IDENTITY PINNING for the persistent runner. spawnAgent rewrites a claude command
+ * with --strict-mcp-config + the agent's own Cookbook token; the thread runner
+ * builds its argv from agent.command directly, so without this an agent with its
+ * own token (Chef) ran as whoever the machine's Claude was logged in as — seen
+ * 2026-08-28: Chef saw diego's workspaces and "No such grant". Same rewrite, once.
+ */
+function pinnedAgent(cfg, agent) {
+  if (!agent || !agent.token || !Array.isArray(agent.command)) return agent;
+  const { command } = withCookbookMcp(agent.command, { token: agent.token, cookbookUrl: agent.cookbookUrl ?? cfg.cookbookUrl });
+  return command === agent.command ? agent : { ...agent, command };
+}
+
 /** Spawn the agent's headless CLI with the prompt substituted into its argv.
  *  `env` (from agentEnv) strips vendor API-billing keys unless the user opted in —
  *  a task must never silently bill an API account instead of the owner's subscription. */
@@ -370,6 +385,8 @@ function spawnAgent(agent, prompt, timeoutSeconds, env, onProgress, opts = {}) {
     // deltas. A completed turn REPLACES its partials (same text arrives both ways).
     let turnsText = "";
     let partialText = "";
+    // Live CALLS (show the work): tool_use/tool_result folded into a capped list.
+    let calls = [];
     const liveText = () => {
       const full = partialText ? `${turnsText}${turnsText ? "\n\n" : ""}${partialText}` : turnsText;
       return full.length > LIVE_TEXT_CAP ? "…" + full.slice(-LIVE_TEXT_CAP) : full;
@@ -383,7 +400,7 @@ function spawnAgent(agent, prompt, timeoutSeconds, env, onProgress, opts = {}) {
       // Bridge restarts (local retryCtx state is trimmed; the task row isn't).
       // Progress needs a token field to pass the server's substance check, so a
       // text-only tick sends output_tokens as-is (0 is fine once input>0 arrives).
-      try { onProgress({ ...acc, runner: agent.name, ...(text ? { live_text: text } : {}), ...(sessionId ? { session_ref: sessionId } : {}) }); } catch { /* progress is best-effort */ }
+      try { onProgress({ ...acc, runner: agent.name, ...(text ? { live_text: text } : {}), ...(calls.length ? { live_calls: wireCalls(calls) } : {}), ...(sessionId ? { session_ref: sessionId } : {}) }); } catch { /* progress is best-effort */ }
     };
 
     let sessionId = null;
@@ -407,10 +424,14 @@ function spawnAgent(agent, prompt, timeoutSeconds, env, onProgress, opts = {}) {
             partialText = "";
           }
         }
+        // A tool call is a discrete event people are watching for — it jumps the
+        // text throttle (still ≥300ms apart so a burst of reads is one tick).
+        let touched = false;
+        for (const ev of callsFromStreamLine(line)) { calls = foldCallEvent(calls, ev); touched = true; }
         const r = foldStreamLine(line, acc);
         acc = r.acc;
         if (r.resultLine) resultLine = r.resultLine;
-        else if (Date.now() - lastEmit > (agent.progressThrottleMs ?? 1200)) emit();
+        else if (Date.now() - lastEmit > (touched ? 300 : (agent.progressThrottleMs ?? 1200))) emit();
       }
     });
     child.stderr.on("data", (d) => { lastActivityAt = Date.now(); err += d; });
@@ -980,7 +1001,7 @@ async function processTask(cfg, ws, task, agent) {
         const live = cfg.liveTokens !== false && agent.liveTokens !== false;
         const r = warmRunner ?? runnerFor({
           threadId: threadKey,
-          agent,
+          agent: pinnedAgent(cfg, agent),
           env: agentEnv(cfg).env,
           resumeSessionId: canResumeThread ? threadSession : null,
           helpers: { fold: foldStreamLine, textFrom: textFromStreamLine, sessionFrom: sessionIdFrom },
@@ -1359,7 +1380,7 @@ async function dispatchWorkInner(cfg, work, warmHints) {
       if (!agent || agent.runner === "app-server" || agent.runner === "robot") continue;
       warmUp({
         poolKey: `warm::${h.workspace_id}::${agent.name}`,
-        agent,
+        agent: pinnedAgent(cfg, agent),
         env: agentEnv(cfg).env,
         helpers: { fold: foldStreamLine, textFrom: textFromStreamLine, sessionFrom: sessionIdFrom },
         log,

package/codex-runner.mjs

@@ -23,6 +23,7 @@ import os from "node:os";
 import path from "node:path";
 import fs from "node:fs";
 import { spawn } from "node:child_process";
+import { codexCallEvent, foldCallEvent, wireCalls } from "./live.mjs";
 
 const IDLE_MS = 15 * 60_000;
 const LIVE_TEXT_CAP = 1800;
@@ -150,6 +151,8 @@ class CodexServer {
         t.text += m.params.delta;
         t.emit();
       }
+      const callEv = codexCallEvent(meth, m.params);
+      if (callEv) { t.calls = foldCallEvent(t.calls, callEv); t.emit(true); }
       if (m.params) {
         const u = m.params.usage ?? m.params.tokenUsage ?? m.params.token_usage ?? (m.params.turn && m.params.turn.usage);
         if (u && typeof u === "object") t.usage = u;
@@ -189,13 +192,14 @@ class CodexServer {
         const startedAt = Date.now();
         const t = {
           resolve, reject,
-          text: "", usage: null,
+          text: "", usage: null, calls: [],
           lastEmit: 0, lastActivityAt: startedAt,
-          emit: () => {
-            if (!onProgress || Date.now() - t.lastEmit < 1200) return;
+          // `event` = a tool call started/finished: jumps the text throttle (≥300ms).
+          emit: (event = false) => {
+            if (!onProgress || Date.now() - t.lastEmit < (event ? 300 : 1200)) return;
             t.lastEmit = Date.now();
             const tail = t.text.length > LIVE_TEXT_CAP ? "…" + t.text.slice(-LIVE_TEXT_CAP) : t.text;
-            try { onProgress({ input_tokens: 0, output_tokens: 0, runner: this.agent.name, ...(tail ? { live_text: tail } : {}) }); } catch { /* best-effort */ }
+            try { onProgress({ input_tokens: 0, output_tokens: 0, runner: this.agent.name, ...(tail ? { live_text: tail } : {}), ...(t.calls.length ? { live_calls: wireCalls(t.calls) } : {}) }); } catch { /* best-effort */ }
           },
           watchdog: setInterval(() => {
             if (Date.now() - startedAt < timeoutSeconds * 1000) return;

package/live.mjs

@@ -0,0 +1,173 @@
+/**
+ * LIVE CALLS — "show the work, not just the words" (Diego, 2026-08-26).
+ *
+ * The Bridge already streams what an agent is SAYING (live_text). This streams what
+ * it is DOING: every tool call, as a short human line — `read_file notes/plan.md`,
+ * `bash npm test`, `search "canvas ics feed"` — with a running/ok/err state. The
+ * thread shows it as a work log, the stage shows the current line, the chat
+ * sidebar shows it under the conversation. Same progress tick, one more field.
+ *
+ * Pure parsers over the vendors' own streams (no network, no fs) so they're
+ * testable: claude stream-json (`tool_use` / `tool_result` blocks), gemini
+ * stream-json (`tool_use` / `tool_result` events), codex app-server item
+ * notifications (`item/started` / `item/completed`).
+ *
+ * Shape on the wire (progress.live_calls, ≤ LIVE_CALLS_CAP entries, oldest first):
+ *   { n: "read_file", a: "notes/plan.md", s: "run" | "ok" | "err", at: <epoch ms> }
+ * The server re-validates every field (src/lib/workspaces/live-calls.ts).
+ */
+
+export const LIVE_CALLS_CAP = 12;
+const NAME_CAP = 60;
+const ARG_CAP = 120;
+
+/** Claude Code's built-in tools → the verb a teammate would say. MCP tools keep their
+ *  own name (`read_file`); other servers' tools are prefixed (`github:create_issue`). */
+const BUILTIN = {
+  read: "read", edit: "edit", multiedit: "edit", write: "write", notebookedit: "edit",
+  bash: "bash", grep: "grep", glob: "glob", ls: "ls",
+  webfetch: "fetch", websearch: "search", task: "agent", todowrite: "todo",
+  // gemini-cli built-ins
+  read_file: "read", write_file: "write", replace: "edit", run_shell_command: "bash",
+  list_directory: "ls", search_file_content: "grep", glob_files: "glob", web_fetch: "fetch", google_web_search: "search",
+};
+
+/** Harness plumbing nobody wants in a work log (Claude Code loads deferred tool
+ *  schemas through ToolSearch before the real call). */
+const SKIP = new Set(["toolsearch"]);
+
+export function shortTool(name) {
+  const raw = String(name ?? "").trim();
+  if (!raw) return "tool";
+  const m = /^mcp__([^_]+(?:_[^_]+)*)__(.+)$/.exec(raw);
+  if (m) {
+    const server = m[1].toLowerCase();
+    const tool = m[2];
+    return (server === "cookbook" ? tool : `${server}:${tool}`).slice(0, NAME_CAP);
+  }
+  const key = raw.toLowerCase();
+  if (BUILTIN[key]) return BUILTIN[key];
+  return raw.slice(0, NAME_CAP);
+}
+
+const ARG_KEYS = [
+  "path", "file_path", "filePath", "notebook_path", "absolute_path", "dir_path", "directory",
+  "command", "cmd", "query", "pattern", "url", "title", "verb", "name", "folder", "from", "to", "src", "dest",
+  "description", "prompt",
+];
+
+/** One short, safe argument for the line. Paths and commands are what people want to
+ *  see; ids and prose are last resort. Whitespace collapsed, capped. */
+export function argFor(input) {
+  if (input == null) return "";
+  if (typeof input === "string") return clip(input);
+  if (typeof input !== "object") return clip(String(input));
+  for (const k of ARG_KEYS) {
+    const v = input[k];
+    if (typeof v === "string" && v.trim()) return clip(v);
+    if (Array.isArray(v) && v.length && typeof v[0] === "string") return clip(v.slice(0, 3).join(", "));
+  }
+  return "";
+}
+
+function clip(s) {
+  const one = String(s).replace(/\s+/g, " ").trim();
+  return one.length > ARG_CAP ? one.slice(0, ARG_CAP - 1) + "…" : one;
+}
+
+/**
+ * Pull tool events out of one stream-json line. Returns an array (a claude turn can
+ * carry several tool_use blocks; a user line several tool_results), empty when the
+ * line is prose/usage/init. Event: {kind:'call', id, name, arg} | {kind:'result', id, err}.
+ */
+export function callsFromStreamLine(line) {
+  let j;
+  try { j = JSON.parse(line); } catch { return []; }
+  if (!j || typeof j !== "object") return [];
+  const out = [];
+  // claude stream-json: assistant turn with tool_use blocks / user turn with tool_result blocks
+  if ((j.type === "assistant" || j.type === "user") && Array.isArray(j.message?.content)) {
+    for (const b of j.message.content) {
+      if (!b || typeof b !== "object") continue;
+      if (b.type === "tool_use") {
+        if (SKIP.has(String(b.name ?? "").toLowerCase())) continue;
+        out.push({ kind: "call", id: String(b.id ?? ""), name: shortTool(b.name), arg: argFor(b.input) });
+      } else if (b.type === "tool_result") out.push({ kind: "result", id: String(b.tool_use_id ?? ""), err: b.is_error === true });
+    }
+    return out;
+  }
+  // gemini stream-json: flat tool_use / tool_result events
+  if (j.type === "tool_use" && (j.tool_name || j.name)) {
+    out.push({ kind: "call", id: String(j.tool_id ?? j.id ?? ""), name: shortTool(j.tool_name ?? j.name), arg: argFor(j.parameters ?? j.input) });
+  } else if (j.type === "tool_result") {
+    const st = String(j.status ?? "").toLowerCase();
+    out.push({ kind: "result", id: String(j.tool_id ?? j.tool_use_id ?? ""), err: st === "error" || st === "failed" || j.is_error === true });
+  }
+  return out;
+}
+
+/**
+ * Codex app-server: `item/started` + `item/completed` notifications carry a typed
+ * item. Defensive about naming (camel/snake, slash/dot) — the protocol is young.
+ * Returns one event or null.
+ */
+export function codexCallEvent(method, params) {
+  const meth = String(method ?? "");
+  const started = /item[/.]started$/.test(meth);
+  const completed = /item[/.]completed$/.test(meth);
+  if (!started && !completed) return null;
+  const item = params?.item;
+  if (!item || typeof item !== "object") return null;
+  const type = String(item.type ?? item.item_type ?? "").replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+  const id = String(item.id ?? "");
+  let name = null;
+  let arg = "";
+  if (type === "commandExecution") { name = "bash"; arg = argFor(item.command ?? item.cmd); }
+  else if (type === "fileChange") {
+    name = "edit";
+    const ch = Array.isArray(item.changes) ? item.changes : [];
+    arg = clip(ch.map((c) => c?.path).filter(Boolean).slice(0, 3).join(", "));
+  }
+  else if (type === "mcpToolCall") {
+    const server = String(item.server ?? "").toLowerCase();
+    const tool = String(item.tool ?? item.name ?? "tool");
+    name = server && server !== "cookbook" ? `${server}:${tool}`.slice(0, NAME_CAP) : tool.slice(0, NAME_CAP);
+    arg = argFor(item.arguments ?? item.input ?? item.params);
+  }
+  else if (type === "webSearch") { name = "search"; arg = argFor(item.query ?? item); }
+  else return null; // agentMessage, reasoning, etc. are not calls
+  if (started) return { kind: "call", id, name, arg };
+  const st = String(item.status ?? "").toLowerCase();
+  const err = st === "failed" || st === "error" || st === "declined" || (typeof item.exit_code === "number" && item.exit_code !== 0) || (typeof item.exitCode === "number" && item.exitCode !== 0);
+  return { kind: "result", id, err };
+}
+
+/**
+ * Fold one event into the running list (pure; returns a new array). A result closes
+ * the matching call by id — or, when the vendor gave no id, the oldest still-running
+ * one. Capped to the newest LIVE_CALLS_CAP so the tick stays small.
+ */
+export function foldCallEvent(list, ev, now = Date.now()) {
+  const cur = Array.isArray(list) ? list : [];
+  if (!ev) return cur;
+  if (ev.kind === "call") {
+    const next = [...cur, { id: ev.id || "", n: ev.name, a: ev.arg || "", s: "run", at: now }];
+    return next.length > LIVE_CALLS_CAP ? next.slice(next.length - LIVE_CALLS_CAP) : next;
+  }
+  if (ev.kind === "result") {
+    // Close by id; fall back to the oldest running call ONLY for id-less vendors.
+    // A known-but-unmatched id (e.g. a skipped ToolSearch) must not close a peer.
+    let i = ev.id ? cur.findIndex((c) => c.id === ev.id && c.s === "run") : -1;
+    if (i < 0 && !ev.id) i = cur.findIndex((c) => c.s === "run");
+    if (i < 0) return cur;
+    const next = cur.slice();
+    next[i] = { ...next[i], s: ev.err ? "err" : "ok" };
+    return next;
+  }
+  return cur;
+}
+
+/** Wire shape: drop the vendor id, keep what the UI renders. */
+export function wireCalls(list) {
+  return (Array.isArray(list) ? list : []).map((c) => ({ n: c.n, ...(c.a ? { a: c.a } : {}), s: c.s, at: c.at }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cookbook-bridge",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Run your own Claude, Codex and Gemini subscriptions against your Cookbook workspaces. One approval connects every agent CLI on your machine, with a receipt for every run.",
   "type": "module",
   "bin": {
@@ -18,6 +18,7 @@
     "device.mjs",
     "hands.mjs",
     "harden.mjs",
+    "live.mjs",
     "local.mjs",
     "openclaw-runner.mjs",
     "prompt.mjs",

package/thread-runner.mjs

@@ -18,6 +18,7 @@
  *    module must not import it back).
  */
 import { spawn } from "node:child_process";
+import { callsFromStreamLine, foldCallEvent, wireCalls } from "./live.mjs";
 
 const IDLE_MS = 10 * 60_000;
 const runners = new Map(); // threadRootId -> Runner
@@ -91,6 +92,8 @@ class Runner {
         if (spoke.kind === "delta") t.partialText += spoke.text;
         else { t.turnsText += (t.turnsText && spoke.text ? "\n\n" : "") + spoke.text; t.partialText = ""; }
       }
+      let touched = false;
+      for (const ev of callsFromStreamLine(line)) { t.calls = foldCallEvent(t.calls, ev); touched = true; }
       const r = this.helpers.fold(line, t.acc);
       t.acc = r.acc;
       if (r.resultLine) {
@@ -100,7 +103,7 @@ class Runner {
         this.lastUsedAt = Date.now();
         t.resolve({ code: 0, out: r.resultLine, err: "", sessionId: this.sessionId });
       } else {
-        t.emit();
+        t.emit(touched);
       }
     }
   }
@@ -118,15 +121,17 @@ class Runner {
         resolve, reject,
         acc: { input_tokens: 0, output_tokens: 0, cache_read_input_tokens: 0, num_turns: 0 },
         turnsText: "", partialText: "",
+        calls: [], // live CALLS (bridge/live.mjs): the work log
         lastEmit: 0, lastActivityAt: startedAt,
-        emit: () => {
-          if (!onProgress || Date.now() - t.lastEmit < 1200) return;
+        // `event` = a tool call started/finished: jumps the text throttle (≥300ms).
+        emit: (event = false) => {
+          if (!onProgress || Date.now() - t.lastEmit < (event ? 300 : 1200)) return;
           t.lastEmit = Date.now();
           const full = t.partialText ? `${t.turnsText}${t.turnsText ? "\n\n" : ""}${t.partialText}` : t.turnsText;
           const live_text = full.length > 1800 ? "…" + full.slice(-1800) : full;
-          if (t.acc.input_tokens === 0 && t.acc.output_tokens === 0 && !live_text) return;
+          if (t.acc.input_tokens === 0 && t.acc.output_tokens === 0 && !live_text && !t.calls.length) return;
           try {
-            onProgress({ ...t.acc, runner: this.agent.name, ...(live_text ? { live_text } : {}), ...(this.sessionId ? { session_ref: this.sessionId } : {}) });
+            onProgress({ ...t.acc, runner: this.agent.name, ...(live_text ? { live_text } : {}), ...(t.calls.length ? { live_calls: wireCalls(t.calls) } : {}), ...(this.sessionId ? { session_ref: this.sessionId } : {}) });
           } catch { /* best-effort */ }
         },
         watchdog: setInterval(() => {