@inhuman.tools/turn 0.0.0-stage → 0.2.0

package/dist/tool-runtime/plugin-context.js

@@ -0,0 +1,55 @@
+/**
+ * Build plugin call context from live session entities. Graph objects stay
+ * host-side. Storage is the prefix projection; propose is applied onto this job after run.
+ */
+import { CompletionExpectation, hostingTurnOf, projectionsOf, reactChunks, SessionTurn, storageBefore, tapeCompletion, } from "@inhuman.tools/harness-model";
+export const pendingPropose = new WeakMap();
+function completionHosting(job) {
+    const turn = job.parent instanceof SessionTurn ? job.parent : null;
+    if (turn == null)
+        return null;
+    const tape = reactChunks(turn);
+    for (let i = 0; i < tape.length; i += 1) {
+        const pew = tapeCompletion(tape[i]);
+        if (pew == null)
+            continue;
+        if (pew.messages.includes(job))
+            return pew;
+        for (let index = i + 1; index < tape.length; index += 1) {
+            const cell = tape[index];
+            if (tapeCompletion(cell) != null)
+                break;
+            if (cell === job)
+                return pew;
+        }
+    }
+    return null;
+}
+export function pluginCallContextOf(root, job, signal, pluginId = "") {
+    const turn = hostingTurnOf(root, job) ?? (job.parent instanceof SessionTurn ? job.parent : null);
+    const completion = completionHosting(job);
+    const prefix = storageBefore(root, job);
+    const projection = pluginId === "" ? undefined : projectionsOf(root).get(pluginId);
+    const initial = projection?.initial() ?? {};
+    return {
+        root: root.path.trim() === "" ? undefined : root.path,
+        callerSessionId: root.sessionId,
+        turn,
+        completion,
+        invocation: job,
+        signal,
+        storage: {
+            session: pluginId === "" ? prefix : (prefix[pluginId] ?? initial),
+            invocation: initial,
+            propose(action) {
+                if (pluginId === "")
+                    return;
+                pendingPropose.set(job, { pluginId, action });
+            },
+        },
+    };
+}
+export function isModelOriginContext(ctx) {
+    return ctx.completion instanceof CompletionExpectation;
+}
+//# sourceMappingURL=plugin-context.js.map

package/dist/tool-runtime/plugin-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-context.js","sourceRoot":"","sources":["../../src/tool-runtime/plugin-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,WAAW,EAEX,WAAW,EACX,aAAa,EACb,cAAc,GAEf,MAAM,8BAA8B,CAAC;AAGtC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,OAAO,EAAmE,CAAC;AAE7G,SAAS,iBAAiB,CAAC,GAAgB;IACzC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,YAAY,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,IAAI,IAAI,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,GAAG,IAAI,IAAI;YAAE,SAAS;QAC1B,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC;QAC3C,KAAK,IAAI,KAAK,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI;gBAAE,MAAM;YACxC,IAAI,IAAI,KAAK,GAAG;gBAAE,OAAO,GAAG,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,IAAiB,EACjB,GAAgB,EAChB,MAAoB,EACpB,QAAQ,GAAG,EAAE;IAEb,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,YAAY,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjG,MAAM,UAAU,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5C,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QACrD,eAAe,EAAE,IAAI,CAAC,SAAS;QAC/B,IAAI;QACJ,UAAU;QACV,UAAU,EAAE,GAAG;QACf,MAAM;QACN,OAAO,EAAE;YACP,OAAO,EAAE,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC;YACjE,UAAU,EAAE,OAAO;YACnB,OAAO,CAAC,MAAe;gBACrB,IAAI,QAAQ,KAAK,EAAE;oBAAE,OAAO;gBAC5B,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAChD,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAsB;IACzD,OAAO,GAAG,CAAC,UAAU,YAAY,qBAAqB,CAAC;AACzD,CAAC"}

package/dist/tool-runtime/recall.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `context_recall {ref}` — read a sealed result back from the graph, paged.
+ *
+ * It re-exposes only what the model already saw in this session, so it needs
+ * no policy floor beyond read-only. Refs resolve against turns reachable from
+ * the live head (`turnTail` chain); an abandoned branch or another session
+ * cannot be read.
+ */
+import { ProgrammaticJob, SessionRoot, ToolCallJob } from "@inhuman.tools/harness-model";
+import type { ToolOutcomeSnap } from "@inhuman.tools/harness-model/schemas";
+export declare const CONTEXT_RECALL_TOOL_NAME = "context_recall";
+export declare function sealedJobText(job: ToolCallJob | ProgrammaticJob): string;
+export declare function recallContext(root: SessionRoot, args: {
+    readonly ref?: unknown;
+    readonly offset?: unknown;
+    readonly length?: unknown;
+}): ToolOutcomeSnap;
+//# sourceMappingURL=recall.d.ts.map

package/dist/tool-runtime/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/tool-runtime/recall.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAe,WAAW,EAAe,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACnH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAI5E,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAyBzD,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,eAAe,GAAG,MAAM,CAIxE;AAMD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACrF,eAAe,CAoDjB"}

package/dist/tool-runtime/recall.js

@@ -0,0 +1,100 @@
+/**
+ * `context_recall {ref}` — read a sealed result back from the graph, paged.
+ *
+ * It re-exposes only what the model already saw in this session, so it needs
+ * no policy floor beyond read-only. Refs resolve against turns reachable from
+ * the live head (`turnTail` chain); an abandoned branch or another session
+ * cannot be read.
+ */
+import { ProgrammaticJob, reactChunks, SessionTurn, ToolCallJob } from "@inhuman.tools/harness-model";
+import { SQUEEZE_COMPACT_CHARS, liftToolImages, paintObservation } from "../context/squeeze.js";
+export const CONTEXT_RECALL_TOOL_NAME = "context_recall";
+const MIN_PREFIX = 4;
+function reachableTurns(root) {
+    const out = [];
+    for (let cell = root.head; cell instanceof SessionTurn && !out.includes(cell); cell = cell.turnTail) {
+        out.push(cell);
+    }
+    return out;
+}
+function reachableJobs(root) {
+    const out = [];
+    for (const turn of reachableTurns(root)) {
+        for (const cell of reactChunks(turn)) {
+            if (cell instanceof ToolCallJob)
+                out.push(cell);
+            else if (cell instanceof ProgrammaticJob) {
+                out.push(cell, ...cell.toolCalls);
+            }
+        }
+    }
+    return out;
+}
+export function sealedJobText(job) {
+    if (job instanceof ToolCallJob)
+        return paintObservation(liftToolImages(job.observationPayload()).payload);
+    const text = job.resultText();
+    return text !== "" ? text : (job.receiptJson ?? "");
+}
+function nameOf(job) {
+    return job instanceof ToolCallJob ? job.name : job.toolName;
+}
+export function recallContext(root, args) {
+    const refused = (text) => ({ ok: false, text: `context_recall: ${text}` });
+    let ref = typeof args.ref === "string" ? args.ref.trim() : "";
+    if (ref === "")
+        return refused("ref is required (job:<id> or visual:<id>)");
+    const offset = typeof args.offset === "number" && args.offset > 0 ? Math.floor(args.offset) : 0;
+    const length = typeof args.length === "number" && args.length > 0
+        ? Math.min(Math.floor(args.length), SQUEEZE_COMPACT_CHARS)
+        : SQUEEZE_COMPACT_CHARS;
+    if (ref.startsWith("visual:")) {
+        const id = ref.slice("visual:".length);
+        for (const turn of reachableTurns(root)) {
+            const visual = turn.visuals.find((v) => v.id === id);
+            if (visual === undefined)
+                continue;
+            return {
+                ok: true,
+                value: `[recall ${ref}] [Image attached: ${visual.mime}, ${visual.width}x${visual.height}${visual.sourcePath ? `, ${visual.sourcePath}` : ""}]`,
+                json: { visualId: visual.id },
+            };
+        }
+        return refused(`unknown or unreachable ref ${ref}`);
+    }
+    for (let hop = 0; hop < 4; hop += 1) {
+        if (!ref.startsWith("job:"))
+            return refused(`unknown ref ${ref} (use job:<id> or visual:<id>)`);
+        const wantArgs = ref.endsWith("#args");
+        const prefix = ref.slice("job:".length).replace(/#args$/, "");
+        if (prefix.length < MIN_PREFIX)
+            return refused(`ref ${ref} is too short`);
+        const hits = reachableJobs(root).filter((job) => job.uuid.startsWith(prefix));
+        if (hits.length === 0)
+            return refused(`unknown or unreachable ref ${ref}`);
+        if (hits.length > 1)
+            return refused(`ref ${ref} is ambiguous`);
+        const job = hits[0];
+        if (nameOf(job) === CONTEXT_RECALL_TOOL_NAME) {
+            // A recall of a recall resolves to the original.
+            const inner = job.args?.ref;
+            if (typeof inner !== "string")
+                return refused(`ref ${ref} names an unreadable recall`);
+            ref = inner;
+            if (ref.startsWith("visual:"))
+                return recallContext(root, { ref, offset, length });
+            continue;
+        }
+        if (!wantArgs && !job.completed)
+            return refused(`${ref} has no sealed result yet`);
+        const text = wantArgs ? JSON.stringify(job.args ?? {}) : sealedJobText(job);
+        const total = text.length;
+        const pages = Math.max(1, Math.ceil(total / length));
+        const end = Math.min(total, offset + length);
+        const note = !wantArgs && job instanceof ToolCallJob && job.regenerateable ? "; as observed, re-read for current" : "";
+        const header = `[recall ${ref} ${nameOf(job)}${wantArgs ? " args" : ""}: chars ${offset}-${end} of ${total}, page ${Math.floor(offset / length) + 1}/${pages}${end < total ? `; next offset ${end}` : ""}${note}]`;
+        return { ok: true, value: `${header}\n${text.slice(offset, end)}` };
+    }
+    return refused("ref chain too deep");
+}
+//# sourceMappingURL=recall.js.map

package/dist/tool-runtime/recall.js.map

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

package/dist/tool-runtime/run-system-tool.d.ts

@@ -0,0 +1,13 @@
+/**
+ * System-tool BODY. Claimed after an allow-side guard. Outcome lives on
+ * the job. This run does not vote. Effect bodies are catalog.execute.
+ */
+import { type JobStopReport, SystemToolJob } from "@inhuman.tools/harness-model";
+import type { ToolOutcomeSnap } from "@inhuman.tools/harness-model/schemas";
+export declare function sealToolCall(job: SystemToolJob, outcome: ToolOutcomeSnap): void;
+export declare function executeSystemTool(job: SystemToolJob, signal: AbortSignal, opts?: {
+    readonly shellTailBytes?: number;
+    /** Host list/stop for `job_stop`. The tool body has no job table of its own. */
+    readonly stopJob?: (jobId: string) => JobStopReport | Promise<JobStopReport>;
+}): Promise<void>;
+//# sourceMappingURL=run-system-tool.d.ts.map

package/dist/tool-runtime/run-system-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-system-tool.d.ts","sourceRoot":"","sources":["../../src/tool-runtime/run-system-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAOL,KAAK,aAAa,EASlB,aAAa,EAEd,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAuE5E,wBAAgB,YAAY,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAI/E;AAgCD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE;IACL,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC9E,GACA,OAAO,CAAC,IAAI,CAAC,CAsIf"}

package/dist/tool-runtime/run-system-tool.js

@@ -0,0 +1,230 @@
+/**
+ * System-tool BODY. Claimed after an allow-side guard. Outcome lives on
+ * the job. This run does not vote. Effect bodies are catalog.execute.
+ */
+import { cancelOutcomeText, DEFAULT_SHELL_TAIL_BYTES, documentRoot, FileMutateToolJob, isAbortError, isTimeoutAbortReason, parseShellTailBytes, outcomeText, projectionsOf, rememberJobResult, RESULT_NOTE_CHARS, reportShellTail, retractShellTail, SessionRoot, writePluginMeta, } from "@inhuman.tools/harness-model";
+import { z } from "zod";
+import { externalizePrior } from "./blob-port.js";
+import { runWithExtraRoot } from "./extra-root.js";
+import { pendingPropose, pluginCallContextOf } from "./plugin-context.js";
+import { CONTEXT_RECALL_TOOL_NAME, recallContext } from "./recall.js";
+import { ToolError } from "./tool-error.js";
+import { workerToolAllowed } from "./worker-tools.js";
+import { lineStartOfSpan } from "./write-admit.js";
+import { behaviorEntriesOf, catalogOf, requireCatalog } from "../tool-catalog/index.js";
+function cancelledSnap(signal) {
+    return { ok: false, text: cancelOutcomeText(signal.reason) };
+}
+const TAIL_MS = 50;
+function tailPublisher(job) {
+    let lastAt = 0;
+    let timer;
+    let latest;
+    const send = (frame) => {
+        if (job.receiptJson != null && job.receiptJson !== "")
+            return;
+        latest = undefined;
+        lastAt = Date.now();
+        reportShellTail(job, frame);
+    };
+    return {
+        push(frame) {
+            const now = Date.now();
+            if (now - lastAt >= TAIL_MS) {
+                if (timer !== undefined)
+                    clearTimeout(timer);
+                timer = undefined;
+                send(frame);
+                return;
+            }
+            latest = frame;
+            timer ??= setTimeout(() => {
+                timer = undefined;
+                if (latest !== undefined)
+                    send(latest);
+            }, TAIL_MS);
+        },
+        flush() {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            timer = undefined;
+            if (latest !== undefined)
+                send(latest);
+        },
+    };
+}
+/** The captured prior text lands inline or by reference; the other field is cleared, so at most one is set. */
+function stampPrior(job, text) {
+    if (text === null) {
+        job.priorContent = null;
+        job.priorBlobJson = null;
+        return;
+    }
+    const stamp = externalizePrior(text);
+    if ("priorBlobJson" in stamp) {
+        job.priorContent = null;
+        job.priorBlobJson = stamp.priorBlobJson;
+    }
+    else {
+        job.priorContent = stamp.priorContent;
+        job.priorBlobJson = null;
+    }
+}
+export function sealToolCall(job, outcome) {
+    rememberJobResult(job, outcomeText(outcome), RESULT_NOTE_CHARS);
+    job.outcomeSnap ??= outcome;
+    retractShellTail(job);
+}
+function asToolResult(out) {
+    if (out != null && typeof out === "object" && "ok" in out) {
+        const row = out;
+        if (typeof row.ok === "boolean") {
+            return {
+                ok: row.ok,
+                ...(typeof row.text === "string" ? { text: row.text } : {}),
+                ...("value" in row ? { value: row.value } : {}),
+                ...(row.truncated === true ? { truncated: true } : {}),
+            };
+        }
+    }
+    return { ok: true, value: out };
+}
+function doorText(error) {
+    if (error instanceof z.ZodError) {
+        const issue = error.issues[0];
+        const path = issue.path.map(String).join(".");
+        return path === "" ? issue.message : `${path}: ${issue.message}`;
+    }
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+export async function executeSystemTool(job, signal, opts) {
+    const seal = (outcome) => {
+        sealToolCall(job, outcome);
+    };
+    try {
+        if (signal.aborted) {
+            seal(cancelledSnap(signal));
+            return;
+        }
+        const { toolCallId, name } = job;
+        if (toolCallId === "") {
+            seal({ ok: false, text: "tool_call snapshot missing toolCallId" });
+            return;
+        }
+        const session = documentRoot(job);
+        if (!(session instanceof SessionRoot)) {
+            seal({ ok: false, text: "tool_call missing session" });
+            return;
+        }
+        const catalog = requireCatalog(catalogOf(session), name);
+        const entry = catalog.catalogEntry(name) ?? behaviorEntriesOf(session).find((row) => row.wireName === name);
+        if (session.agent.spec.name !== "" && !workerToolAllowed(catalog, session.agent.spec.name, name, session)) {
+            seal({ ok: false, text: "outside worker tool ceiling" });
+            return;
+        }
+        job.regenerateable = entry?.class === "read";
+        if (signal.aborted) {
+            seal(cancelledSnap(signal));
+            return;
+        }
+        const raw = job.invocation();
+        const args = job.args ?? (raw === "" ? {} : null);
+        if (args == null) {
+            seal({
+                ok: false,
+                text: `${name}: arguments were not valid JSON — ${raw.slice(0, 200)}`,
+            });
+            return;
+        }
+        if (name === CONTEXT_RECALL_TOOL_NAME) {
+            seal(recallContext(session, args));
+            return;
+        }
+        if (name === "job_stop") {
+            const jobIdRaw = args.job_id;
+            const jobId = typeof jobIdRaw === "string" ? jobIdRaw : "";
+            const report = await (opts?.stopJob?.(jobId) ?? {
+                ok: false,
+                text: "job_stop is not available on this host",
+            });
+            seal(report);
+            return;
+        }
+        const root = session.path.trim() === "" ? process.cwd() : session.path;
+        // Extra-root follows the license, not the human bit. Yolo and auto
+        // remainder leave approved null; writing it here would derive HITL.
+        // block never licenses. A folder the human said to treat as part of the session is a floor approve for
+        // reads under it (a session read root), so it opens the same door through `licenseAllows`; nothing is remembered
+        // from a single outside read.
+        const tailBytes = parseShellTailBytes(opts?.shellTailBytes ?? DEFAULT_SHELL_TAIL_BYTES);
+        const live = name === "shell" && tailBytes > 0 ? tailPublisher(job) : undefined;
+        let dispatched;
+        try {
+            ToolError.invariant(entry?.execute, () => name.startsWith("mcp__")
+                ? `unknown MCP tool "${name}" — connection missing, disabled, or not expanded`
+                : `unknown tool "${name}" — available: ${catalog.catalogWireNames().join(", ")}`);
+            try {
+                dispatched = await runWithExtraRoot(job.licenseAllows, () => entry.execute(args, {
+                    root,
+                    catalog,
+                    signal,
+                    sessionId: session.sessionId,
+                    onPriorContent: job instanceof FileMutateToolJob
+                        ? (text) => {
+                            stampPrior(job, text);
+                            if (typeof text === "string" && name === "edit_file") {
+                                const old = typeof args.old_string === "string" ? args.old_string : "";
+                                const line = lineStartOfSpan(text, old);
+                                if (line != null)
+                                    job.priorLineStart = line;
+                            }
+                        }
+                        : undefined,
+                    shellTailBytes: tailBytes,
+                    onTail: live?.push,
+                    ...pluginCallContextOf(session, job, signal, entry.source.kind === "pack" ? entry.source.pluginName : ""),
+                }));
+            }
+            catch (error) {
+                if (error instanceof ToolError)
+                    throw error;
+                dispatched = {
+                    ok: false,
+                    text: error instanceof z.ZodError ? doorText(error) : `${name}: ${doorText(error)}`,
+                };
+            }
+        }
+        finally {
+            live?.flush();
+        }
+        const proposed = pendingPropose.get(job);
+        pendingPropose.delete(job);
+        if (proposed != null) {
+            const projection = projectionsOf(job).get(proposed.pluginId);
+            if (projection?.hostOnly?.(proposed.action) === true) {
+                seal({ ok: false, text: `${proposed.pluginId}: host-only metadata` });
+                return;
+            }
+            writePluginMeta(job, proposed.pluginId, proposed.action, false);
+        }
+        seal(asToolResult(dispatched));
+    }
+    catch (error) {
+        if (signal.aborted) {
+            seal(cancelledSnap(signal));
+            return;
+        }
+        if (error instanceof ToolError) {
+            seal({ ok: false, text: error.message });
+            return;
+        }
+        if (isAbortError(error) && !isTimeoutAbortReason(error)) {
+            seal({ ok: false, text: cancelOutcomeText(error) });
+            return;
+        }
+        seal({ ok: false, text: `error: ${error instanceof Error ? error.message : String(error)}` });
+    }
+}
+//# sourceMappingURL=run-system-tool.js.map

package/dist/tool-runtime/run-system-tool.js.map

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

package/dist/tool-runtime/tool-error.d.ts

@@ -0,0 +1,6 @@
+import { ErrorWithInvariant } from "@inhuman.tools/error-with-invariant";
+/** Failure the model is meant to read and correct — never a turn-killer. */
+export declare class ToolError extends ErrorWithInvariant {
+    readonly name = "ToolError";
+}
+//# sourceMappingURL=tool-error.d.ts.map

package/dist/tool-runtime/tool-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.d.ts","sourceRoot":"","sources":["../../src/tool-runtime/tool-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,4EAA4E;AAC5E,qBAAa,SAAU,SAAQ,kBAAkB;IAC/C,QAAQ,CAAC,IAAI,eAAe;CAC7B"}

package/dist/tool-runtime/tool-error.js

@@ -0,0 +1,6 @@
+import { ErrorWithInvariant } from "@inhuman.tools/error-with-invariant";
+/** Failure the model is meant to read and correct — never a turn-killer. */
+export class ToolError extends ErrorWithInvariant {
+    name = "ToolError";
+}
+//# sourceMappingURL=tool-error.js.map

package/dist/tool-runtime/tool-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.js","sourceRoot":"","sources":["../../src/tool-runtime/tool-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,4EAA4E;AAC5E,MAAM,OAAO,SAAU,SAAQ,kBAAkB;IACtC,IAAI,GAAG,WAAW,CAAC;CAC7B"}

package/dist/tool-runtime/worker-tools.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Worker tool ceiling. The one implementation: the session view and admit/execute both call it.
+ * Bot-granted MCP and private plugin MCP are answered by the catalog's `workerHost`.
+ */
+import { SessionRoot } from "@inhuman.tools/harness-model";
+import { type KernelToolCatalog } from "../tool-catalog/index.js";
+export declare function workerToolAllowed(catalog: KernelToolCatalog, recipeName: string, wire: string, sessionRoot?: SessionRoot): boolean;
+//# sourceMappingURL=worker-tools.d.ts.map

package/dist/tool-runtime/worker-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-tools.d.ts","sourceRoot":"","sources":["../../src/tool-runtime/worker-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAUL,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAA+C,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAuB/G,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CA8BT"}

package/dist/tool-runtime/worker-tools.js

@@ -0,0 +1,65 @@
+/**
+ * Worker tool ceiling. The one implementation: the session view and admit/execute both call it.
+ * Bot-granted MCP and private plugin MCP are answered by the catalog's `workerHost`.
+ */
+import { AGENT_ASK, AGENT_MESSAGE, AGENT_NOTIFY, AGENT_RESPOND, AGENT_SEND, AGENT_VOID, AskAgentSpec, SCHEME_REPL_TOOL_NAME, SCHEME_WATCH_TOOL_NAME, } from "@inhuman.tools/harness-model";
+import { behaviorEntriesOf, catalogTriggersReactLoop } from "../tool-catalog/index.js";
+function isAgentComms(wire) {
+    return (wire === AGENT_RESPOND ||
+        wire === AGENT_VOID ||
+        wire === AGENT_NOTIFY ||
+        wire === AGENT_MESSAGE ||
+        wire === AGENT_SEND ||
+        wire === AGENT_ASK);
+}
+function askWorkerToolAllowed(catalog, wire) {
+    if (wire === AGENT_VOID)
+        return false;
+    return (wire === SCHEME_REPL_TOOL_NAME ||
+        wire === SCHEME_WATCH_TOOL_NAME ||
+        catalog.catalogEntry(wire)?.isSideChannel === true ||
+        isAgentComms(wire));
+}
+export function workerToolAllowed(catalog, recipeName, wire, sessionRoot) {
+    const spec = sessionRoot?.agent.spec;
+    if (spec instanceof AskAgentSpec) {
+        if (wire === AGENT_VOID)
+            return spec.voidLegal === true;
+        if (behaviorEntriesOf(sessionRoot).some((entry) => entry.wireName === wire))
+            return true;
+        if (spec.inheritCallerTools)
+            return true;
+        if (askWorkerToolAllowed(catalog, wire))
+            return true;
+        if (spec.tools?.includes(wire) === true)
+            return true;
+        if (spec.name === "" || spec.toolsOnly)
+            return false;
+        const named = catalog.recipe(spec.name);
+        if (named == null)
+            return false;
+        return catalog.workerHost.recipeGrantsWire(catalog, named.spec, wire, sessionRoot?.path ?? "");
+    }
+    if (wire === AGENT_VOID && spec?.voidLegal === false)
+        return false;
+    if (recipeName === "")
+        return true;
+    if (behaviorEntriesOf(sessionRoot).some((entry) => entry.wireName === wire))
+        return true;
+    const recipe = catalog.recipe(recipeName);
+    if (recipe == null)
+        return false;
+    if (catalog.privateWorkerEntries.some((row) => row.wireName === wire))
+        return true;
+    const entry = catalog.catalogEntry(wire);
+    if (entry == null)
+        return catalog.workerHost.privateWireAllowed(recipeName, wire, sessionRoot);
+    if (wire === SCHEME_REPL_TOOL_NAME ||
+        wire === SCHEME_WATCH_TOOL_NAME ||
+        !catalogTriggersReactLoop(catalog, wire) ||
+        isAgentComms(wire)) {
+        return true;
+    }
+    return catalog.workerHost.recipeGrantsWire(catalog, recipe.spec, wire, sessionRoot?.path ?? "");
+}
+//# sourceMappingURL=worker-tools.js.map

package/dist/tool-runtime/worker-tools.js.map

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

package/dist/tool-runtime/write-admit.d.ts

@@ -0,0 +1,21 @@
+export declare function overwriteExistingDoor(pathText: string): string;
+/** True only for boolean true or the string "true". Missing / false → door on exist. */
+export declare function overwriteExistingOf(args: unknown): boolean;
+/** Tape line annotation. Line 1 is omitted. */
+export declare function lineStartOfSpan(file: string | null | undefined, span: string): number | null;
+/** NUL-free UTF-8 under the read budget. Empty file is "". */
+export declare function priorTextSync(target: string): string | null;
+type WriteAdmitSnap = {
+    /** `null` means we could not tell — not a definite miss. */
+    readonly existed: boolean | null;
+    readonly priorContent: string | null;
+    readonly refuse: string | null;
+};
+/**
+ * Admit runs before any license. Only a path that stays inside the workspace, links resolved, may
+ * be read or probed here; anything else is left to the licensed body, which captures prior content
+ * after approval and keeps the overwrite door.
+ */
+export declare function writeFileAdmitSnap(root: string, argsJson: string): WriteAdmitSnap;
+export {};
+//# sourceMappingURL=write-admit.d.ts.map

package/dist/tool-runtime/write-admit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-admit.d.ts","sourceRoot":"","sources":["../../src/tool-runtime/write-admit.ts"],"names":[],"mappings":"AAcA,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAK1D;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY5F;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU3D;AAED,KAAK,cAAc,GAAG;IACpB,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,CAAC;AAOF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,CAkBjF"}