@tekmidian/pai 0.40.1 → 0.42.0

package/dist/browser-mcp/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["z.number","z.string","z.boolean"],"sources":["../../src/browser-mcp/bridge-client.ts","../../src/browser-mcp/tools.ts","../../src/browser-mcp/index.ts"],"sourcesContent":["/**\n * WebSocket client for the browser bridge.\n *\n * Talks to the native host's hand-rolled WS server (ws://127.0.0.1:8756) with\n * the global WebSocket — node >= 22, no external dependency. Requests carry an\n * id; replies are correlated by it. The socket is connected lazily per call\n * and reconnected on demand, so the server survives Chrome being closed.\n */\n\nexport const BRIDGE_PORT = Number(process.env.PAI_BROWSER_BRIDGE_PORT || 8756);\nexport const BRIDGE_URL = `ws://127.0.0.1:${BRIDGE_PORT}`;\n\nexport const NOT_CONNECTED_MESSAGE =\n  \"Chrome bridge not connected — start Chrome (the PAI browser-bridge extension must be running) and try again.\";\n\n/** Minimal shape of the pieces of WebSocket this client uses. */\nexport interface WebSocketLike {\n  readyState: number;\n  send(data: string): void;\n  close(): void;\n  onopen: (() => void) | null;\n  onclose: (() => void) | null;\n  onerror: (() => void) | null;\n  onmessage: ((ev: { data: string }) => void) | null;\n}\n\nexport type WebSocketFactory = (url: string) => WebSocketLike;\n\nexport const globalWebSocketFactory: WebSocketFactory = (url) => {\n  const WS = (globalThis as { WebSocket?: new (url: string) => WebSocketLike }).WebSocket;\n  if (!WS) {\n    throw new Error(\n      \"this node runtime has no global WebSocket — pai-browser-mcp needs node >= 22\"\n    );\n  }\n  return new WS(url);\n};\n\nexport class NotConnectedError extends Error {\n  constructor() {\n    super(NOT_CONNECTED_MESSAGE);\n    this.name = \"NotConnectedError\";\n  }\n}\n\nexport interface BridgeReply {\n  id: number;\n  ok: boolean;\n  result?: unknown;\n  error?: string;\n}\n\nconst CONNECT_TIMEOUT_MS = 5_000;\nconst REQUEST_TIMEOUT_MS = 5_000;\nconst OPEN = 1;\n\nexport class BridgeClient {\n  private socket: WebSocketLike | null = null;\n  private connecting: Promise<WebSocketLike> | null = null;\n  private nextId = 1;\n  private readonly pending = new Map<\n    number,\n    { resolve: (r: BridgeReply) => void; reject: (e: Error) => void; timer: NodeJS.Timeout }\n  >();\n\n  constructor(\n    private readonly url: string = BRIDGE_URL,\n    private readonly socketFactory: WebSocketFactory = globalWebSocketFactory\n  ) {}\n\n  /** True when the underlying socket is open. */\n  get connected(): boolean {\n    return this.socket !== null && this.socket.readyState === OPEN;\n  }\n\n  private ensureSocket(): Promise<WebSocketLike> {\n    if (this.socket && this.socket.readyState === OPEN) return Promise.resolve(this.socket);\n    if (this.connecting) return this.connecting; // concurrent sends share one socket\n    this.dropSocket();\n    const attempt = new Promise<WebSocketLike>((resolve, reject) => {\n      let socket: WebSocketLike;\n      try {\n        socket = this.socketFactory(this.url);\n      } catch (e) {\n        reject(e);\n        return;\n      }\n      const timer = setTimeout(() => {\n        reject(new NotConnectedError());\n        socket.onopen = null;\n        socket.onclose = null;\n        socket.onerror = null;\n        socket.onmessage = null;\n        try {\n          socket.close();\n        } catch {\n          /* already gone */\n        }\n      }, CONNECT_TIMEOUT_MS);\n      socket.onopen = () => {\n        clearTimeout(timer);\n        this.socket = socket;\n        resolve(socket);\n      };\n      socket.onclose = () => {\n        clearTimeout(timer);\n        this.dropSocket();\n        reject(new NotConnectedError());\n      };\n      socket.onerror = () => {\n        clearTimeout(timer);\n        this.dropSocket();\n        reject(new NotConnectedError());\n      };\n      socket.onmessage = (ev) => this.onMessage(ev);\n    });\n    this.connecting = attempt;\n    const clear = () => {\n      if (this.connecting === attempt) this.connecting = null;\n    };\n    attempt.then(clear, clear);\n    return attempt;\n  }\n\n  private dropSocket(): void {\n    if (this.socket) {\n      this.socket.onopen = null;\n      this.socket.onclose = null;\n      this.socket.onerror = null;\n      this.socket.onmessage = null;\n      try {\n        this.socket.close();\n      } catch {\n        /* already gone */\n      }\n      this.socket = null;\n    }\n    // Fail everything still waiting — the peer is gone.\n    for (const [, p] of this.pending) {\n      clearTimeout(p.timer);\n      p.reject(new NotConnectedError());\n    }\n    this.pending.clear();\n  }\n\n  private onMessage(ev: { data: string }): void {\n    let reply: BridgeReply;\n    try {\n      reply = JSON.parse(ev.data) as BridgeReply;\n    } catch {\n      return; // bridge noise (keepalive pings echo nothing back); ignore\n    }\n    const p = reply?.id !== undefined ? this.pending.get(reply.id) : undefined;\n    if (!p) return;\n    this.pending.delete(reply.id);\n    clearTimeout(p.timer);\n    p.resolve(reply);\n  }\n\n  /**\n   * Sends one command and awaits its correlated reply. Connection problems\n   * and timeouts both surface as NotConnectedError with the user-facing text.\n   */\n  async send(command: string, params: Record<string, unknown> = {}): Promise<unknown> {\n    await this.ensureSocket();\n    const id = this.nextId++;\n    const frame = JSON.stringify({ id, command, ...params });\n    return new Promise<unknown>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        this.pending.delete(id);\n        reject(new NotConnectedError());\n      }, REQUEST_TIMEOUT_MS);\n      this.pending.set(id, {\n        resolve: (reply) => (reply.ok ? resolve(reply.result) : reject(new Error(reply.error ?? \"bridge error\"))),\n        reject,\n        timer,\n      });\n      try {\n        this.socket!.send(frame);\n      } catch (e) {\n        this.pending.delete(id);\n        clearTimeout(timer);\n        reject(new NotConnectedError());\n      }\n    });\n  }\n\n  close(): void {\n    this.dropSocket();\n  }\n}\n","/**\n * pai-browser MCP tool table.\n *\n * One definition per tool: MCP-facing name/schema, the wire command it maps\n * to on the browser bridge, param translation, and result formatting. Kept as\n * a data table so tests can drive every mapping without a transport, and so\n * registerBrowserTools stays a five-line loop.\n */\n\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { NotConnectedError } from \"./bridge-client.js\";\n\nexport interface BridgeLike {\n  send(command: string, params?: Record<string, unknown>): Promise<unknown>;\n}\n\nexport interface BrowserToolDef {\n  name: string;\n  description: string;\n  /** zod raw shape for server.tool() */\n  shape: z.ZodRawShape;\n  /** wire command the extension handles */\n  command: string;\n  /** MCP args → wire params */\n  toParams: (args: Record<string, unknown>) => Record<string, unknown>;\n  /** wire result → text shown to the model */\n  format?: (result: unknown) => string;\n}\n\nconst tabSchema = z.number().int().describe(\"Tab id, as returned by tabs_list.\");\n\nfunction asRecord(v: unknown): Record<string, unknown> {\n  return (v ?? {}) as Record<string, unknown>;\n}\n\n// ---------------------------------------------------------------------------\n// Result formatters\n// ---------------------------------------------------------------------------\n\nfunction formatTabs(result: unknown): string {\n  const tabs = (Array.isArray(result) ? result : asRecord(result).tabs) as Array<\n    Record<string, unknown>\n  >;\n  if (!Array.isArray(tabs) || tabs.length === 0) return \"(no open tabs)\";\n  return tabs\n    .map(\n      (t) =>\n        `${t.id}${t.active ? \" *\" : \"  \"} ${String(t.title ?? \"\")}\\n     ${String(t.url ?? \"\")}`\n    )\n    .join(\"\\n\");\n}\n\nfunction formatSnapshot(result: unknown): string {\n  return String(asRecord(result).yaml ?? \"\");\n}\n\nfunction formatLogs(result: unknown): string {\n  const entries = asRecord(result).entries as Array<Record<string, unknown>>;\n  if (!Array.isArray(entries) || entries.length === 0) return \"(no console output captured)\";\n  return entries\n    .map((e) => {\n      const kind = e.source === \"console\" ? String(e.type ?? \"log\") : String(e.level ?? \"log\");\n      return `[${kind}] ${String(e.text ?? \"\")}`;\n    })\n    .join(\"\\n\");\n}\n\nfunction formatEval(result: unknown): string {\n  const value = asRecord(result).value;\n  return typeof value === \"string\" ? value : JSON.stringify(value, null, 2);\n}\n\nfunction formatScreenshot(result: unknown): string {\n  // Raw base64 PNG — the tool contract is \"base64 png\", not prose.\n  return String(asRecord(result).base64 ?? \"\");\n}\n\n// ---------------------------------------------------------------------------\n// Tool table: MCP name → wire command\n// ---------------------------------------------------------------------------\n\nexport const BROWSER_TOOLS: BrowserToolDef[] = [\n  {\n    name: \"tabs_list\",\n    description: \"List the tabs of the user's real running Chrome (id, title, url, active).\",\n    shape: {},\n    command: \"list_tabs\",\n    toParams: () => ({}),\n    format: formatTabs,\n  },\n  {\n    name: \"tab_open\",\n    description: \"Open a new tab in the user's Chrome and return its tab id.\",\n    shape: {\n      url: z.string().describe(\"URL to open.\"),\n      active: z.boolean().optional().describe(\"Focus the new tab (default true).\"),\n    },\n    command: \"open_tab\",\n    toParams: (a) => ({ url: a.url, ...(a.active !== undefined ? { active: a.active } : {}) }),\n  },\n  {\n    name: \"tab_select\",\n    description: \"Bring a tab to the front (activate it and focus its window).\",\n    shape: { tab: tabSchema },\n    command: \"select_tab\",\n    toParams: (a) => ({ tabId: a.tab }),\n  },\n  {\n    name: \"tab_close\",\n    description: \"Close a tab.\",\n    shape: { tab: tabSchema },\n    command: \"close_tab\",\n    toParams: (a) => ({ tabId: a.tab }),\n  },\n  {\n    name: \"dom_snapshot\",\n    description:\n      \"Snapshot a tab's DOM as an accessibility-tree YAML with [ref=sN] ids for interactive elements. \" +\n      \"Take a snapshot before dom_click/dom_type; refs stay valid until the next snapshot or navigation.\",\n    shape: { tab: tabSchema },\n    command: \"snapshot\",\n    toParams: (a) => ({ tabId: a.tab }),\n    format: formatSnapshot,\n  },\n  {\n    name: \"dom_click\",\n    description: \"Click an element by its [ref=sN] from the latest dom_snapshot (trusted CDP event).\",\n    shape: { tab: tabSchema, ref: z.string().describe(\"Ref id from dom_snapshot, e.g. s3.\") },\n    command: \"click\",\n    toParams: (a) => ({ tabId: a.tab, ref: a.ref }),\n  },\n  {\n    name: \"dom_type\",\n    description:\n      \"Focus an element by its [ref=sN] and type text into it (inserts at the caret, works in SPAs).\",\n    shape: {\n      tab: tabSchema,\n      ref: z.string().describe(\"Ref id from dom_snapshot, e.g. s5.\"),\n      text: z.string().describe(\"Text to type.\"),\n    },\n    command: \"type\",\n    toParams: (a) => ({ tabId: a.tab, ref: a.ref, text: a.text }),\n  },\n  {\n    name: \"page_text\",\n    description: \"Read a tab's visible text (document.body.innerText).\",\n    shape: { tab: tabSchema },\n    command: \"eval\",\n    toParams: () => ({ code: \"document.body.innerText\" }),\n    format: formatEval,\n  },\n  {\n    name: \"eval_js\",\n    description: \"Evaluate JavaScript in a tab and return the JSON-safe result. Awaits promises.\",\n    shape: {\n      tab: tabSchema,\n      code: z.string().describe(\"JavaScript expression to evaluate.\"),\n    },\n    command: \"eval\",\n    toParams: (a) => ({ code: a.code }),\n    format: formatEval,\n  },\n  {\n    name: \"tab_screenshot\",\n    description: \"Screenshot a tab (PNG, base64).\",\n    shape: { tab: tabSchema },\n    command: \"screenshot\",\n    toParams: (a) => ({ tabId: a.tab }),\n    format: formatScreenshot,\n  },\n  {\n    name: \"console_logs\",\n    description: \"Read the console output captured for a tab since its last snapshot.\",\n    shape: { tab: tabSchema },\n    command: \"console_logs\",\n    toParams: (a) => ({ tabId: a.tab }),\n    format: formatLogs,\n  },\n];\n\n/** Runs one tool against the bridge; returns MCP content + isError. */\nexport async function runBrowserTool(\n  def: BrowserToolDef,\n  args: Record<string, unknown>,\n  bridge: BridgeLike\n): Promise<{ content: Array<{ type: \"text\"; text: string }>; isError?: boolean }> {\n  try {\n    const result = await bridge.send(def.command, def.toParams(args));\n    return { content: [{ type: \"text\", text: def.format ? def.format(result) : JSON.stringify(result, null, 2) }] };\n  } catch (e) {\n    const msg =\n      e instanceof NotConnectedError\n        ? e.message\n        : e instanceof Error\n          ? e.message\n          : String(e);\n    return { content: [{ type: \"text\", text: msg }], isError: true };\n  }\n}\n\n/** Registers every browser tool on an MCP server. */\nexport function registerBrowserTools(server: McpServer, bridge: BridgeLike): void {\n  for (const def of BROWSER_TOOLS) {\n    server.tool(def.name, def.description, def.shape, (args) => runBrowserTool(def, args, bridge));\n  }\n}\n","#!/usr/bin/env node\n/**\n * pai-browser-mcp — stdio MCP server for the PAI browser bridge.\n *\n * The provider-independent claude-in-chrome replacement: drives the user's\n * real running Chrome (tabs + DOM) through the browser-bridge extension's\n * native messaging host, over ws://127.0.0.1:8756. Any MCP client works —\n * nothing here is Anthropic-specific.\n *\n *   provider → MCP (this server) → WebSocket → native host → extension → Chrome\n *\n * If Chrome is not running (or the extension is not loaded), every tool\n * returns a clear \"start Chrome\" error; the server itself stays alive and\n * reconnects lazily per call.\n */\n\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { BridgeClient, globalWebSocketFactory } from \"./bridge-client.js\";\nimport { registerBrowserTools } from \"./tools.js\";\n\nasync function main(): Promise<void> {\n  if (globalThis.WebSocket === undefined) {\n    // Node < 22 has no global WebSocket client; say so instead of crashing\n    // with an opaque TypeError when the first tool call connects.\n    process.stderr.write(\n      \"pai-browser-mcp: this node runtime has no global WebSocket — run with node >= 22\\n\"\n    );\n    process.exit(1);\n  }\n\n  const server = new McpServer({\n    name: \"pai-browser\",\n    version: \"0.1.0\",\n  });\n\n  const bridge = new BridgeClient(undefined, globalWebSocketFactory);\n  registerBrowserTools(server, bridge);\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n}\n\nmain().catch((e) => {\n  process.stderr.write(`pai-browser-mcp fatal error: ${String(e)}\\n`);\n  process.exit(1);\n});\n"],"mappings":"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"}

package/dist/{chain-DhVHVnmT.mjs → chain-DGXNoTwc.mjs}

@@ -1,93 +1,13 @@
-import { a as WorkersConfigError, h as resolveModelCapability, l as isModelCapability, m as readWorkersSection, o as assertProviderRunnable, p as providerKeyPath, s as classModelCapability } from "./config-Dl8lT4Lu.mjs";
-import { _ as workersLogDir, d as setCooldown, f as eventsPath, g as statusPath, h as panesDir, i as buildRunEnv, m as noMcpConfigPath, n as ensureProxyRunning, o as isQuotaFailure, p as ledgerPath, s as nextAutoProvider, t as DEFAULT_PROXY_PORT, u as resolveTarget } from "./server-BOuAOj9b.mjs";
-import { appendFileSync, closeSync, existsSync, mkdirSync, mkdtempSync, openSync, readFileSync, readdirSync, renameSync, rmSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
+import { a as WorkersConfigError, h as resolveModelCapability, l as isModelCapability, m as readWorkersSection, o as assertProviderRunnable, p as providerKeyPath, s as classModelCapability } from "./config-DgzR5sfb.mjs";
+import { _ as workersLogDir, d as setCooldown, f as eventsPath, g as statusPath, h as panesDir, i as buildRunEnv, m as noMcpConfigPath, n as ensureProxyRunning, o as isQuotaFailure, p as ledgerPath, s as nextAutoProvider, t as DEFAULT_PROXY_PORT, u as resolveTarget } from "./server-Cp7tNzNC.mjs";
+import { S as stripPromptValues, _ as newWorkerId, a as resolveSpawnerSession, b as parseRunnerArgs, d as alive, g as loadStatuses, h as loadStatus, i as resolveSession, l as UNLABELED, m as describeTool, o as scopeKey, r as itermUuid, v as nowStamp, x as shortText, y as saveStatus } from "./scope-NIwCGxRI.mjs";
+import { appendFileSync, closeSync, existsSync, mkdirSync, mkdtempSync, openSync, readFileSync, readdirSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
-import { dirname, join, relative } from "node:path";
+import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { connect, createServer } from "node:net";
 import { execFileSync, spawn } from "node:child_process";
 import { createInterface } from "node:readline";
 
-//#region src/workers/args.ts
-function parseRunnerArgs(argv) {
-	let prompt = null;
-	let outputFormat = "text";
-	const rest = [];
-	let headless = false;
-	let callerModel = false;
-	let callerMcpConfig = false;
-	let callerSystemPrompt = false;
-	const mcp = [];
-	let i = 0;
-	while (i < argv.length) {
-		const a = argv[i];
-		if (a === "-p" || a === "--print") {
-			headless = true;
-			rest.push(a);
-			if (i + 1 < argv.length && !argv[i + 1].startsWith("-")) {
-				prompt = argv[i + 1];
-				rest.push(prompt);
-				i += 1;
-			}
-		} else if (a === "--output-format") {
-			const v = argv[i + 1];
-			if (v === "json" || v === "stream-json") outputFormat = v;
-			i += 1;
-		} else if (a.startsWith("--output-format=")) {
-			const v = a.slice(16);
-			if (v === "json" || v === "stream-json") outputFormat = v;
-		} else if (a === "--verbose") {} else if (a === "--mcp") {
-			const v = argv[i + 1];
-			if (v !== void 0 && !v.startsWith("-")) {
-				mcp.push(v);
-				i += 1;
-			}
-		} else if (a.startsWith("--mcp=")) mcp.push(a.slice(6));
-		else {
-			if (a === "--model") callerModel = true;
-			if (a.startsWith("--model=")) callerModel = true;
-			if (a === "--mcp-config") callerMcpConfig = true;
-			if (a.startsWith("--mcp-config=")) callerMcpConfig = true;
-			if (a === "--append-system-prompt") callerSystemPrompt = true;
-			if (a.startsWith("--append-system-prompt=")) callerSystemPrompt = true;
-			if (prompt === null && !a.startsWith("-") && rest.length > 0 && (rest[rest.length - 1] === "-p" || rest[rest.length - 1] === "--print")) prompt = a;
-			rest.push(a);
-		}
-		i += 1;
-	}
-	return {
-		prompt,
-		outputFormat,
-		rest,
-		headless,
-		callerModel,
-		callerMcpConfig,
-		callerSystemPrompt,
-		mcp
-	};
-}
-/**
-* Turn `-p "<prompt>"` into bare `-p` (same for --print): for stream-json
-* stdin runs the prompt moves to the first user message on stdin, so the
-* value must not stay on the command line. Only prompt values directly
-* following the flag are touched; everything else passes through.
-*/
-function stripPromptValues(argv) {
-	const out = [];
-	for (let i = 0; i < argv.length; i++) {
-		const a = argv[i];
-		const isPrint = a === "-p" || a === "--print";
-		out.push(a);
-		if (isPrint && i + 1 < argv.length && !argv[i + 1].startsWith("-")) i += 1;
-	}
-	return out;
-}
-/** Collapse whitespace and cut to n chars with an ellipsis (label rendering). */
-function shortText(s, n) {
-	const t = String(s ?? "").split(/\s+/).filter(Boolean).join(" ");
-	return t.length <= n ? t : t.slice(0, n - 1) + "…";
-}
-
-//#endregion
 //#region src/workers/ledger.ts
 /**
 * ledger.ts — the routing ledger, one append-only log for every worker event.
@@ -157,231 +77,6 @@ function ledgerSummary(path, scope, lastN = 15, now = /* @__PURE__ */ new Date()
 	};
 }
 
-//#endregion
-//#region src/workers/status.ts
-/**
-* status.ts — the live per-worker status file.
-*
-* One JSON file per run, rewritten atomically on every turn, read by `ps`,
-* `follow`, the status line and the pane logic. Same field set the Python
-* runner wrote, plus `provider` (routing is multi-provider now) and `session`
-* (the AIBroker identity of the launching session, see scope.ts).
-*/
-/** Label a worker gets when launched with neither --label nor a prompt. */
-const UNLABELED = "unlabeled";
-/** Context-meter percentage 0–100, null when the numbers are missing. */
-function contextPercent(s) {
-	if (!s.contextTokens || !s.contextWindow) return null;
-	return Math.round(s.contextTokens / s.contextWindow * 100);
-}
-/** Compact token count: 84k, 200k, 900. */
-function fmtContextK(n) {
-	return n >= 1e3 ? `${Math.round(n / 1e3)}k` : String(n);
-}
-/**
-* The one context-meter label, shared by every renderer so identical
-* numbers always render identically: `ctx 84k/200k (42%)` — used-style
-* percent. Empty when the numbers are missing (callers drop the part).
-*/
-function contextLabel(s) {
-	const pct = contextPercent(s);
-	if (pct === null) return "";
-	return `ctx ${fmtContextK(s.contextTokens ?? 0)}/${fmtContextK(s.contextWindow ?? 0)} (${pct}%)`;
-}
-/** Timestamp format shared by status files and the ledger. */
-function nowStamp(d = /* @__PURE__ */ new Date()) {
-	const p = (n) => String(n).padStart(2, "0");
-	return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}`;
-}
-let lastId = "";
-let idSeq = 0;
-function newWorkerId(d = /* @__PURE__ */ new Date(), pid = process.pid) {
-	const p = (n) => String(n).padStart(2, "0");
-	const base = `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}-${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}-${pid}`;
-	if (base === lastId) {
-		idSeq += 1;
-		return `${base}-${String(idSeq).padStart(2, "0")}`;
-	}
-	lastId = base;
-	idSeq = 0;
-	return base;
-}
-/** Write status atomically (temp + rename) and stamp `updated`. */
-function saveStatus(logDir, status, d = /* @__PURE__ */ new Date()) {
-	status.updated = nowStamp(d);
-	const path = statusPath(logDir, status.id);
-	const tmp = `${path}.tmp`;
-	writeFileSync(tmp, JSON.stringify(status), "utf8");
-	renameSync(tmp, path);
-}
-/** Load every status file in the logDir, oldest id first, skipping damage. */
-function loadStatuses(logDir) {
-	if (!existsSync(logDir)) return [];
-	const out = [];
-	for (const name of readdirSync(logDir).sort()) {
-		if (!name.endsWith(".status")) continue;
-		try {
-			out.push(JSON.parse(readFileSync(join(logDir, name), "utf8")));
-		} catch {}
-	}
-	return out;
-}
-function loadStatus(logDir, id) {
-	const path = statusPath(logDir, id);
-	if (!existsSync(path)) return null;
-	try {
-		return JSON.parse(readFileSync(path, "utf8"));
-	} catch {
-		return null;
-	}
-}
-function alive(pid) {
-	if (!pid || pid <= 0) return false;
-	try {
-		process.kill(pid, 0);
-		return true;
-	} catch {
-		return false;
-	}
-}
-/** "42s" under 90s, "7m" above — the coarse age the table and bar show. */
-function ageOf(ts, now = /* @__PURE__ */ new Date()) {
-	const t = Date.parse(ts.replace(" ", "T"));
-	if (Number.isNaN(t)) return "?";
-	const s = Math.max(0, Math.floor((now.getTime() - t) / 1e3));
-	return s < 90 ? `${s}s` : `${Math.floor(s / 60)}m`;
-}
-/** One-line description of a tool call, e.g. "Bash: npm test". */
-function describeTool(name, inp) {
-	if (typeof inp !== "object" || inp === null) return name;
-	const i = inp;
-	const get = (k) => typeof i[k] === "string" ? i[k] : "";
-	if (name === "Bash") return `Bash: ${shortText(get("command"), 70)}`;
-	if (name === "Read" || name === "Edit" || name === "Write" || name === "MultiEdit") return `${name}: ${get("file_path").split("/").pop() ?? ""}`;
-	if (name === "Grep" || name === "Glob") return `${name}: ${shortText(get("pattern"), 50)}`;
-	if (name === "WebSearch") return `${name}: ${shortText(get("query"), 50)}`;
-	if (name === "WebFetch") return `${name}: ${shortText(get("url"), 60)}`;
-	return name;
-}
-
-//#endregion
-//#region src/workers/scope.ts
-/**
-* scope.ts — which workers "belong" to the terminal asking about them.
-*
-* Two identities, in priority order:
-*
-*   1. AIBroker's session registry (~/.aibroker/session-names.json): iTerm
-*      session UUID → session name. The launching session's UUID is stored in
-*      each worker's status file as `session.id`, so every pane of a named
-*      session sees its workers — regardless of tab layout.
-*   2. The iTerm tab key (`w<window>t<tab>` prefix of ITERM_SESSION_ID): the
-*      original heuristic, kept as the fallback when no registry entry
-*      matches (AIBroker absent, unnamed session, non-iTerm terminal).
-*
-* If neither is available, viewers fall back to "all workers".
-*
-* A third case: workers spawned from a Claude Code Bash tool (the
-* orchestrator pattern) have neither — Claude Code exports no terminal or
-* session identity to its Bash children. Those record `spawnerSession`, the
-* orchestrator's claude session id bridged through the status line's
-* session map (see below), so their tab still claims them.
-*/
-const AIBROKER_REGISTRY = join(homedir(), ".aibroker", "session-names.json");
-/**
-* `w<window>t<tab>` prefix of an iTerm session id, "" if empty or malformed.
-* Panes split from the same tab share this prefix and differ only in `p<n>`.
-*/
-function tabKey(term) {
-	if (!term) return "";
-	const head = term.split("p", 1)[0];
-	const parts = head.slice(1).split("t");
-	if (head.startsWith("w") && parts.length === 2 && parts.every((p) => /^\d+$/.test(p))) return head;
-	return "";
-}
-/** Tab key of the iTerm tab this process runs in, "" if not inside iTerm2. */
-function currentTabKey(env = process.env) {
-	return tabKey(env.ITERM_SESSION_ID ?? "");
-}
-/** The iTerm UUID part of an ITERM_SESSION_ID (after the last colon). */
-function itermUuid(term) {
-	if (!term) return "";
-	return term.split(":").pop() ?? "";
-}
-/**
-* Resolve the AIBroker session for an ITERM_SESSION_ID. Reads the persistent
-* name registry (the same store `aibroker_rename` writes); returns null when
-* AIBroker is absent or the session is not in it — callers then use the tab
-* key, which is the pre-AIBroker behaviour.
-*/
-function resolveSession(term, registryPath = AIBROKER_REGISTRY) {
-	const uuid = itermUuid(term);
-	if (!uuid) return null;
-	let names;
-	try {
-		if (!existsSync(registryPath)) return null;
-		names = JSON.parse(readFileSync(registryPath, "utf8"));
-	} catch {
-		return null;
-	}
-	const name = names[uuid];
-	if (typeof name !== "string" || !name) return null;
-	return {
-		id: uuid,
-		name
-	};
-}
-/**
-* True when `worker` was launched from `term` (the terminal asking about it).
-* Session-id match first; the tab key only when no registry entry matched —
-* a session without a name keeps the tab-scoped behaviour it always had.
-*/
-function workerInScope(worker, term) {
-	if (!term) return false;
-	const uuid = itermUuid(term);
-	if (worker.session?.id && uuid) return worker.session.id === uuid;
-	return tabKey(worker.term) === tabKey(term) && tabKey(term) !== "";
-}
-/**
-* Registry key for pane files: the session id when AIBroker knows this
-* terminal, else the tab key, else the raw iTerm UUID.
-*/
-function scopeKey(term) {
-	const session = resolveSession(term);
-	if (session) return session.id;
-	return currentTabKey() || itermUuid(term);
-}
-/** `[Name]` when the worker has an AIBroker session name, else "". */
-function sessionTag(worker) {
-	return worker.session?.name ? `[${worker.session.name}]` : "";
-}
-/** How old a map entry may be for a spawn to adopt it (status lines refresh constantly while a session lives). */
-const SPAWNER_SESSION_TTL_MS = 10 * 6e4;
-/** Map entries not refreshed within this window are pruned on write. */
-const SESSION_MAP_PRUNE_MS = 60 * 6e4;
-function sessionMapPath(logDir) {
-	return join(logDir, "claude-session-map.json");
-}
-/**
-* The claude session a new run was spawned by, when it can be known: a run
-* inside another worker inherits its spawner (chain stages keep the
-* orchestrator's tab that way); otherwise a fresh map entry for `cwd`.
-*/
-function resolveSpawnerSession(logDir, cwd, env = process.env, now = Date.now()) {
-	const parentId = env.PAI_WORKER_ID;
-	if (parentId) {
-		const inherited = loadStatus(logDir, parentId)?.spawnerSession;
-		if (inherited) return inherited;
-	}
-	const path = sessionMapPath(logDir);
-	if (!existsSync(path) || !cwd) return null;
-	try {
-		const entry = JSON.parse(readFileSync(path, "utf8"))[cwd];
-		if (entry && entry.session && now - entry.ts < SPAWNER_SESSION_TTL_MS) return entry.session;
-	} catch {}
-	return null;
-}
-
 //#endregion
 //#region src/workers/pane.ts
 /**
@@ -1219,6 +914,11 @@ function worktreeWanted(flag, opts) {
 * degrade to an in-place run.
 */
 function addWorktree(logDir, id, cwd) {
+	const swept = sweepOrphanWorktrees(logDir);
+	if (swept.length) appendLedger(ledgerPath(logDir), "WORKER-NOTE", {
+		id,
+		note: `swept orphan worktree(s): ${swept.join(", ")}`
+	});
 	const dir = worktreePath(logDir, id);
 	const branch = worktreeBranch(id);
 	const base = git(cwd, ["rev-parse", "HEAD"]);
@@ -1235,6 +935,46 @@ function addWorktree(logDir, id, cwd) {
 		base
 	};
 }
+/**
+* Remove worktrees (and their `worker/<id>` branches) whose worker no longer
+* exists — no status file left in the log dir. Killed and failed runs clean
+* up after themselves, but a `kill -9` or a crash strands a directory and a
+* branch; every worktree creation sweeps first so they cannot accumulate.
+* Directories younger than `minAgeMin` minutes are left alone: a run that is
+* just starting owns its worktree a moment before its status file exists.
+*/
+function sweepOrphanWorktrees(logDir, minAgeMin = 10) {
+	const root = worktreesDir(logDir);
+	if (!existsSync(root)) return [];
+	const swept = [];
+	for (const ent of readdirSync(root, { withFileTypes: true })) {
+		if (!ent.isDirectory()) continue;
+		const id = ent.name;
+		const dir = join(root, id);
+		if (existsSync(statusPath(logDir, id))) continue;
+		try {
+			if ((Date.now() - statSync(dir).mtimeMs) / 6e4 < minAgeMin) continue;
+		} catch {}
+		let gitDir = null;
+		try {
+			const raw = git(dir, ["rev-parse", "--git-common-dir"]);
+			gitDir = isAbsolute(raw) ? raw : resolve(dir, raw);
+		} catch {
+			gitDir = null;
+		}
+		removeWorktree(gitDir ?? dir, dir, true);
+		if (gitDir) try {
+			git(gitDir, ["worktree", "prune"]);
+			git(gitDir, [
+				"branch",
+				"-D",
+				worktreeBranch(id)
+			]);
+		} catch {}
+		swept.push(id);
+	}
+	return swept;
+}
 /** Commits the branch collected on top of its base. */
 function commitsSince(dir, base) {
 	try {
@@ -1520,6 +1260,9 @@ const WORKER_CONTRACT_PROMPT = [
 	"notes: one line, the headline a reviewer reads first.",
 	"Never write shell heredocs — write the script to a file with the Write tool, then run it",
 	"(heredocs fail silently or get swallowed).",
+	"Never inline code one-liners (python3 -c, node -e, ruby -e and friends) — the permission layer",
+	"denies them (\"ztk: command denied by permission rules\"); write the script to a file with the",
+	"Write tool and run it (python3 script.py), or use jq for JSON inspection.",
 	"",
 	`Operator messages: a user turn starting with ${OPERATOR_MARK} was typed by the operator while you`,
 	"run (the prompt of a resumed run is the operator's too). Answer it FIRST, in one or two plain lines —",
@@ -1607,9 +1350,11 @@ function relShort(p, cwd) {
 * Headless workers start with NO MCP servers: every server definition is a
 * prompt-time tool inventory the model pays to know, and a worker that only
 * reads and edits files needs none of it. A run may opt in with `--mcp
-* name[,name…]` (or a role carrying `"mcp": [...]`); names may be single
-* servers from ~/.claude.json's `mcpServers` or `workers.mcpSets` set names,
-* which expand to their member list. The filtered config lands in
+* name[,name…]`, a role carrying `"mcp": [...]`, or implicitly by naming
+* `mcp__server__tool` in --allowedTools (a grant without its server loaded is
+* a dead letter). Names may be single servers from ~/.claude.json's
+* `mcpServers` or `workers.mcpSets` set names, which expand to their member
+* list. The filtered config lands in
 * `<logDir>/<id>.mcp.json` and is passed with `--strict-mcp-config
 * --mcp-config` so exactly those servers load. MCP servers are chosen at
 * launch only — a mid-run `say` cannot add any.
@@ -1646,6 +1391,22 @@ function expandMcpNames(names, config, claudeJson = CLAUDE_JSON) {
 	}
 	return out;
 }
+/**
+* Derive server names from tool grants: every `mcp__<server>__<tool>` (or bare
+* `mcp__<server>`, or `mcp__<server>__*`) in an --allowedTools list names a
+* server the run expects to be loaded. A grant is a dead letter unless its
+* server is in the filtered config, so the runner treats these as implicit
+* --mcp names — and only these; non-mcp grants load nothing.
+*/
+function mcpServersFromToolGrants(tools) {
+	const out = [];
+	for (const entry of tools) for (const name of entry.split(",").map((s) => s.trim()).filter(Boolean)) {
+		if (!name.startsWith("mcp__")) continue;
+		const server = name.slice(5).split("__")[0];
+		if (server && !out.includes(server)) out.push(server);
+	}
+	return out;
+}
 /** Path of a run's filtered MCP config. */
 function runMcpConfigPath(logDir, id) {
 	return join(logDir, `${id}.mcp.json`);
@@ -1859,9 +1620,12 @@ function codexInstalled() {
 *   - env: ANTHROPIC_BASE_URL/AUTH_TOKEN from the provider (token from its
 *     key file, never from the environment), the three DEFAULT_*_MODEL vars,
 *     the provider's extra env, nonessential traffic off, and ANTHROPIC_API_KEY
-*     stripped so nothing can fall back to Anthropic billing. OpenAI-protocol
-*     providers point at the PAI proxy instead (started on demand, the
-*     provider name in the URL path); codex-engine providers run the Codex CLI.
+*     stripped so nothing can fall back to Anthropic billing. Headless runs
+*     also drop the spawner's session identity (messaging socket, session id,
+*     nesting markers) — inherited, a worktree child starts tool-blind.
+*     OpenAI-protocol providers point at the PAI proxy instead (started on
+*     demand, the provider name in the URL path); codex-engine providers run
+*     the Codex CLI.
 *   - headless (-p): strict empty MCP config unless the caller brings one or
 *     names servers via --mcp / a role (then a filtered <id>.mcp.json),
 *     PAI_WORKER=1 so PAI's per-session hooks leave it alone, the worker
@@ -1961,7 +1725,7 @@ async function runWorker(opts) {
 	const logDir = workersLogDir(config);
 	mkdirSync(logDir, { recursive: true });
 	if (opts.className === "plan" && !opts._planner) {
-		const { runPlanner } = await import("./planner-Cm3g6fWH.mjs");
+		const { runPlanner } = await import("./planner-BLDJt3ZS.mjs");
 		return runPlanner(opts);
 	}
 	const parent = launchParent(opts.parent);
@@ -2093,7 +1857,8 @@ async function executeRun(a) {
 		const wanted = [
 			...a.mcpFlag ? [a.mcpFlag] : [],
 			...parsed.mcp,
-			...target.classMcp ?? []
+			...target.classMcp ?? [],
+			...mcpServersFromToolGrants(parsed.allowedTools)
 		];
 		if (wanted.length) mcpArgs = [
 			"--strict-mcp-config",
@@ -2182,6 +1947,9 @@ async function executeRun(a) {
 			killed: 1,
 			label
 		});
+		if (worktree) try {
+			recordWorktree(logDir, status, worktree, false);
+		} catch {}
 		cleanup();
 		try {
 			proc.kill();
@@ -2190,6 +1958,7 @@ async function executeRun(a) {
 	};
 	process.once("SIGTERM", () => onSignal("SIGTERM"));
 	process.once("SIGINT", () => onSignal("SIGINT"));
+	process.once("SIGHUP", () => onSignal("SIGHUP"));
 	const ctx = {
 		resultEvent: null,
 		resultReport: null
@@ -2425,6 +2194,7 @@ async function executeCodexRun(a) {
 	let killed = false;
 	process.once("SIGTERM", onCodexSignal("SIGTERM"));
 	process.once("SIGINT", onCodexSignal("SIGINT"));
+	process.once("SIGHUP", onCodexSignal("SIGHUP"));
 	function onCodexSignal(sig) {
 		return () => {
 			killed = true;
@@ -2433,6 +2203,9 @@ async function executeCodexRun(a) {
 			status.secs = Math.floor((Date.now() - t0) / 1e3);
 			status.last = `killed by signal ${sig}`;
 			saveStatus(logDir, status);
+			if (worktree) try {
+				recordWorktree(logDir, status, worktree, false);
+			} catch {}
 			try {
 				proc.kill();
 			} catch {}
@@ -2793,5 +2566,5 @@ async function runChain(opts, deps = {}) {
 }
 
 //#endregion
-export { appendLedger as A, ageOf as C, loadStatus as D, contextPercent as E, parseRunnerArgs as M, shortText as N, loadStatuses as O, UNLABELED as S, contextLabel as T, openPaneForWorker as _, testProvider as a, sessionTag as b, renderReport as c, handoffFromInside as d, readInbox as f, openFollowPane as g, checkPaneForWorker as h, runWorker as i, ledgerSummary as j, newWorkerId as k, discardWorker as l, workerDepth as m, swapPromptArg as n, describeMcp as o, sayToWorker as p, printResult as r, parseWorkerReport as s, runChain as t, mergeWorker as u, currentTabKey as v, alive as w, workerInScope as x, resolveSession as y };
-//# sourceMappingURL=chain-DhVHVnmT.mjs.map
+export { openPaneForWorker as _, testProvider as a, renderReport as c, handoffFromInside as d, readInbox as f, openFollowPane as g, checkPaneForWorker as h, runWorker as i, discardWorker as l, workerDepth as m, swapPromptArg as n, describeMcp as o, sayToWorker as p, printResult as r, parseWorkerReport as s, runChain as t, mergeWorker as u, appendLedger as v, ledgerSummary as y };
+//# sourceMappingURL=chain-DGXNoTwc.mjs.map