@inhuman.tools/harness 0.0.0-stage → 0.2.0

package/dist/server/testkit/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Integration-test host surface. Not the product daemon API.
+ */
+export { applyAckAnswer, applyAskAnswer, type AckAnswer, type AskAnswer } from "../ask-answer.js";
+export { HarnessDaemon } from "../daemon/server/HarnessDaemon.js";
+export { defaultCommands } from "../defaults/index.js";
+export { listenCompat as listenCompat } from "./compat-server.js";
+export * from "./sequence-provider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/testkit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/testkit/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClE,cAAc,wBAAwB,CAAC"}

package/dist/server/testkit/index.js

@@ -0,0 +1,9 @@
+/**
+ * Integration-test host surface. Not the product daemon API.
+ */
+export { applyAckAnswer, applyAskAnswer } from "../ask-answer.js";
+export { HarnessDaemon } from "../daemon/server/HarnessDaemon.js";
+export { defaultCommands } from "../defaults/index.js";
+export { listenCompat as listenCompat } from "./compat-server.js";
+export * from "./sequence-provider.js";
+//# sourceMappingURL=index.js.map

package/dist/server/testkit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/testkit/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAkC,MAAM,kBAAkB,CAAC;AAClG,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,YAAY,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClE,cAAc,wBAAwB,CAAC"}

package/dist/server/testkit/scripted-model.d.ts

@@ -0,0 +1,40 @@
+import type { ResponseCall } from "@inhuman.tools/harness-model";
+import type { CompleteResult, ConnectionCompleteRequest } from "@inhuman.tools/harness-provider-sdk";
+import { PEWDriver, type ExpectationActor } from "@inhuman.tools/plexus-expectations/driver";
+import type { KernelDaemon } from "../daemon/kernel/KernelDaemon.js";
+/**
+ * Config reflection drops connections that are not in `config.json`.
+ * A `__prv_` id is kept, so a reload cannot pull the scripted row out
+ * from under a later round.
+ */
+export declare function scriptedConnectionId(connectionId?: string): string;
+export type ModelReply = {
+    readonly text?: string;
+    readonly calls?: readonly ResponseCall[];
+    readonly thought?: string;
+    /** Fail the round. The loop sees a crashed completion, not a hang. */
+    readonly fail?: string;
+};
+export type ModelScript = {
+    reply(reply: ModelReply): void;
+};
+export declare class ScriptedCompletionConnection extends PEWDriver {
+    #private;
+    constructor(connectionId: string, settings: unknown, secrets?: ConstructorParameters<typeof PEWDriver>[2]);
+    bootstrap(): Promise<void>;
+    protected resolve(): ExpectationActor<never>;
+    complete(req: ConnectionCompleteRequest): Promise<CompleteResult>;
+}
+/** Register `connectionId` on the kernel. Replies are delivered by `complete()`. */
+export declare function installScriptedModel(kernel: KernelDaemon, connectionId?: string): ModelScript;
+/** Install `connectionId` and remember the script on `session`. */
+export declare function attachScriptedModel(kernel: KernelDaemon, session: object, connectionId?: string): ModelScript;
+export declare function modelOf(session: object): ModelScript;
+/**
+ * Point the kernel's compaction at the keep-first program. Integration tests
+ * that script the loop have no summarizer model to answer the shipped
+ * strategy; keep-first is the deterministic stand-in. (In the product it is
+ * only the failsafe.)
+ */
+export declare function useKeepFirstCompact(kernel: KernelDaemon, kernelRoot: string): void;
+//# sourceMappingURL=scripted-model.d.ts.map

package/dist/server/testkit/scripted-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted-model.d.ts","sourceRoot":"","sources":["../../../src/server/testkit/scripted-model.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAErG,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAI7F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAGrE;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,SAAO,GAAG,MAAM,CAEhE;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAChC,CAAC;AAmCF,qBAAa,4BAA6B,SAAQ,SAAS;;gBAG7C,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,qBAAqB,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;IAQ1F,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;cAEtB,OAAO,IAAI,gBAAgB,CAAC,KAAK,CAAC;IAI/C,QAAQ,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,cAAc,CAAC;CA8BxE;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,SAAO,GAAG,WAAW,CAwC3F;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,SAAO,GAAG,WAAW,CAI3G;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAIpD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CASlF"}

package/dist/server/testkit/scripted-model.js

@@ -0,0 +1,166 @@
+/**
+ * Test model. The session asks `c1` through the normal completion port.
+ * Each `reply` is one round: text, tool calls, or a crash.
+ */
+import { randomUUID } from "node:crypto";
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { ConnectionSpec, DriverSpec } from "@inhuman.tools/plexus-expectations";
+import { PEWDriver } from "@inhuman.tools/plexus-expectations/driver";
+import { normalizeMessage } from "@inhuman.tools/tool-call-normalize";
+import { reaction } from "mobx";
+import { responseCallsFromToolCalls, toolCallFromResponse } from "../util/tool-call-json.js";
+/**
+ * Config reflection drops connections that are not in `config.json`.
+ * A `__prv_` id is kept, so a reload cannot pull the scripted row out
+ * from under a later round.
+ */
+export function scriptedConnectionId(connectionId = "c1") {
+    return connectionId.startsWith("__prv_") ? connectionId : `__prv_${connectionId}`;
+}
+const queues = new Map();
+const attached = new WeakMap();
+class ReplyQueue {
+    #pending = [];
+    #waiters = [];
+    reply(reply) {
+        const waiter = this.#waiters.shift();
+        if (waiter != null)
+            waiter(reply);
+        else
+            this.#pending.push(reply);
+    }
+    take(signal) {
+        if (signal?.aborted)
+            return Promise.reject(signal.reason ?? new Error("aborted"));
+        const queued = this.#pending.shift();
+        if (queued != null)
+            return Promise.resolve(queued);
+        return new Promise((resolve, reject) => {
+            const finish = (reply) => {
+                signal?.removeEventListener("abort", onAbort);
+                resolve(reply);
+            };
+            const onAbort = () => {
+                const index = this.#waiters.indexOf(finish);
+                if (index !== -1)
+                    this.#waiters.splice(index, 1);
+                reject(signal?.reason ?? new Error("aborted"));
+            };
+            this.#waiters.push(finish);
+            signal?.addEventListener("abort", onAbort, { once: true });
+        });
+    }
+}
+export class ScriptedCompletionConnection extends PEWDriver {
+    #queue;
+    constructor(connectionId, settings, secrets) {
+        super(connectionId, settings, secrets);
+        const scriptId = this.settings.scriptId;
+        const queue = typeof scriptId === "string" ? queues.get(scriptId) : undefined;
+        if (queue == null)
+            throw new Error("scripted model: missing queue");
+        this.#queue = queue;
+    }
+    async bootstrap() { }
+    resolve() {
+        throw new Error("scripted model does not honor expectations");
+    }
+    async complete(req) {
+        // Ambient compact and an unstubbed judge share this connection. They must
+        // not take the actor's next reply.
+        if (req.round.completionMode === "isolated") {
+            const text = req.responseSchemaJson == null ? "" : JSON.stringify({ intent: false, awaiting_user: false });
+            req.round.stampAnswer({ calls: [], text });
+            req.round.succeed("settled", "", "null", { result: { text } });
+            return { text };
+        }
+        const reply = await this.#queue.take(req.signal);
+        if (reply.fail != null) {
+            req.round.fail("crash", reply.fail, "null");
+            return { text: "" };
+        }
+        // The provider actor normalizes once, at the producer. The loop admits what is stored.
+        const normalized = normalizeMessage({
+            content: reply.text ?? "",
+            tool_calls: (reply.calls ?? []).map(toolCallFromResponse),
+            reasoning_content: reply.thought || null,
+        });
+        const text = normalized.content ?? "";
+        const thought = normalized.reasoning_content ?? "";
+        req.round.stampAnswer({
+            calls: responseCallsFromToolCalls(normalized.tool_calls),
+            text,
+            ...(thought !== "" ? { thought } : {}),
+        });
+        req.round.succeed("settled", "", "null", { result: { text } });
+        return { text, ...(thought !== "" ? { thought } : {}) };
+    }
+}
+/** Register `connectionId` on the kernel. Replies are delivered by `complete()`. */
+export function installScriptedModel(kernel, connectionId = "c1") {
+    const id = scriptedConnectionId(connectionId);
+    const scriptId = randomUUID();
+    const queue = new ReplyQueue();
+    queues.set(scriptId, queue);
+    const driver = new DriverSpec({
+        name: "scripted",
+        description: "scripted test model",
+        importPath: "scripted",
+        abilityClaim: ["completion"],
+        multiplicity: "add-by-default",
+    });
+    const connection = new ConnectionSpec({ driver, name: id });
+    connection.configuration = { scriptId };
+    const root = kernel.plexus.root;
+    const keep = () => {
+        if (root.drivers.scripted !== driver)
+            root.drivers = { ...root.drivers, scripted: driver };
+        if (root.connections[id] !== connection)
+            root.connections = { ...root.connections, [id]: connection };
+    };
+    keep();
+    const stopKeep = reaction(() => root.drivers.scripted !== driver || root.connections[id] !== connection, (missing) => {
+        if (missing)
+            keep();
+    });
+    const priorDispose = kernel[Symbol.dispose].bind(kernel);
+    kernel[Symbol.dispose] = () => {
+        stopKeep();
+        priorDispose();
+    };
+    const runtime = kernel.runtime;
+    const load = runtime.loadDriver.bind(runtime);
+    runtime.loadDriver = (spec, purpose) => spec.name === "scripted" ? ScriptedCompletionConnection : load(spec, purpose);
+    return {
+        reply(reply) {
+            queue.reply(reply);
+        },
+    };
+}
+/** Install `connectionId` and remember the script on `session`. */
+export function attachScriptedModel(kernel, session, connectionId = "c1") {
+    const model = installScriptedModel(kernel, connectionId);
+    attached.set(session, model);
+    return model;
+}
+export function modelOf(session) {
+    const model = attached.get(session);
+    if (model == null)
+        throw new Error("scripted model missing");
+    return model;
+}
+/**
+ * Point the kernel's compaction at the keep-first program. Integration tests
+ * that script the loop have no summarizer model to answer the shipped
+ * strategy; keep-first is the deterministic stand-in. (In the product it is
+ * only the failsafe.)
+ */
+export function useKeepFirstCompact(kernel, kernelRoot) {
+    const path = join(kernelRoot, "keep-first.scm");
+    writeFileSync(path, "(define (compact compact-transcript full-transcript)\n  (let ((xs (transcript/cells compact-transcript)))\n    (if (null? xs) xs (list (car xs)))))\n");
+    kernel.adjustConfig((config) => {
+        config.compact = path;
+    });
+}
+//# sourceMappingURL=scripted-model.js.map

package/dist/server/testkit/scripted-model.js.map

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

package/dist/server/testkit/sequence-provider.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Scripted session model. Every completion says `this is assistant message #n`.
+ * The user prompt is `this is user prompt.` plus an optional second sentence
+ * `execute tools sequence: [4,3,5]`. Each number is how many `scheme_repl`
+ * calls that round emits (`tool call i, round n`), so the transcript can tell
+ * them apart. No second sentence, or an empty array, means speech only.
+ * `n` counts scripted assistant lines after the latest such user prompt.
+ */
+import type { CompatReply } from "./compat-server.js";
+export declare function sequenceReply(post: unknown): CompatReply;
+//# sourceMappingURL=sequence-provider.d.ts.map

package/dist/server/testkit/sequence-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence-provider.d.ts","sourceRoot":"","sources":["../../../src/server/testkit/sequence-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQtD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAcxD"}

package/dist/server/testkit/sequence-provider.js

@@ -0,0 +1,105 @@
+import { asRecord, readField } from "../util/read-field.js";
+const USER_MARK = "this is user prompt.";
+const ASSISTANT_MARK = /^this is assistant message #\d+$/;
+export function sequenceReply(post) {
+    const lines = linesOf(post);
+    const planAt = lastPlanIndex(lines);
+    const plan = planAt === -1 ? null : toolPlan(lines[planAt].text);
+    const prior = lines.slice(planAt + 1).filter((line) => line.role === "assistant" && ASSISTANT_MARK.test(line.text));
+    const round = prior.length + 1;
+    const content = `this is assistant message #${round}`;
+    const count = plan != null && plan.length > 0 ? plan[round - 1] : undefined;
+    if (count == null || count < 1)
+        return { content, finish_reason: "stop" };
+    return {
+        content,
+        finish_reason: "tool_calls",
+        tool_calls: Array.from({ length: count }, (_, index) => schemeCall(round, index + 1)),
+    };
+}
+function schemeCall(round, index) {
+    const phrase = `tool call ${index}, round ${round}`;
+    return {
+        id: `call_r${round}_${index}`,
+        type: "function",
+        function: {
+            name: "scheme_repl",
+            // A Scheme string, so the phrase is the value and stays visible in the message.
+            arguments: JSON.stringify({ expr: `"${phrase}"`, description: phrase }),
+        },
+    };
+}
+/** Numbers after the second sentence. `[]` is no tools. `null` is not this prompt. */
+function toolPlan(text) {
+    const at = text.indexOf(USER_MARK);
+    if (at === -1)
+        return null;
+    const rest = text.slice(at + USER_MARK.length).trim();
+    if (rest === "")
+        return [];
+    const match = /^execute tools sequence:\s*\[([^\]]*)]/.exec(rest);
+    if (match == null)
+        return [];
+    const body = match[1].trim();
+    if (body === "")
+        return [];
+    const nums = [];
+    for (const piece of body.split(",")) {
+        const trimmed = piece.trim();
+        if (!/^\d+$/.test(trimmed))
+            return [];
+        nums.push(Number(trimmed));
+    }
+    return nums;
+}
+function lastPlanIndex(lines) {
+    for (let i = lines.length - 1; i >= 0; i -= 1) {
+        const line = lines[i];
+        if (line.role === "user" && toolPlan(line.text) !== null)
+            return i;
+    }
+    return -1;
+}
+function linesOf(post) {
+    const record = asRecord(post);
+    if (record == null)
+        return [];
+    const messages = readField(record, "messages");
+    const input = readField(record, "input");
+    const rows = Array.isArray(messages) ? messages : Array.isArray(input) ? input : [];
+    const lines = [];
+    for (const row of rows) {
+        const rec = asRecord(row);
+        if (rec == null)
+            continue;
+        const role = readField(rec, "role");
+        if (role !== "user" && role !== "assistant")
+            continue;
+        const text = textOf(readField(rec, "content"));
+        if (text === "")
+            continue;
+        lines.push({ role, text });
+    }
+    return lines;
+}
+function textOf(content) {
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    const parts = [];
+    for (const part of content) {
+        if (typeof part === "string") {
+            parts.push(part);
+            continue;
+        }
+        const rec = asRecord(part);
+        if (rec == null)
+            continue;
+        const text = readField(rec, "text");
+        if (typeof text === "string")
+            parts.push(text);
+    }
+    return parts.join("");
+}
+//# sourceMappingURL=sequence-provider.js.map

package/dist/server/testkit/sequence-provider.js.map

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

package/dist/server/toolkit/actor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pack catalog load. Tools run as Job executors, not PEW honor.
+ * Wire prefixes `mcp__`, `call__`, `agent__` are reserved — colliding pack
+ * tools are skipped, they do not overlay.
+ */
+import { type KernelRoot, type PluginProjectionRegistry } from "@inhuman.tools/harness-model";
+import { type PluginModuleRow } from "./plugin-tools.js";
+import { type KernelToolCatalog } from "./tool-table.js";
+/** Daemon pack dataflow writes through here. Host plugins re-seed inside replacePack. */
+export declare function applyPackPlugins(catalog: KernelToolCatalog, rows: readonly PluginModuleRow[], kernel?: KernelRoot, projections?: PluginProjectionRegistry): Promise<{
+    loaded: number;
+    errors: readonly string[];
+}>;
+export declare function parseArgs(argumentsJson: string): Record<string, unknown> | null;
+//# sourceMappingURL=actor.d.ts.map

package/dist/server/toolkit/actor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actor.d.ts","sourceRoot":"","sources":["../../../src/server/toolkit/actor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAqB,KAAK,UAAU,EAAE,KAAK,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAKjH,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAUzD,yFAAyF;AACzF,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,SAAS,eAAe,EAAE,EAChC,MAAM,CAAC,EAAE,UAAU,EACnB,WAAW,CAAC,EAAE,wBAAwB,GACrC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,CAqDxD;AAoED,wBAAgB,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAG/E"}

package/dist/server/toolkit/actor.js

@@ -0,0 +1,133 @@
+/**
+ * Pack catalog load. Tools run as Job executors, not PEW honor.
+ * Wire prefixes `mcp__`, `call__`, `agent__` are reserved — colliding pack
+ * tools are skipped, they do not overlay.
+ */
+import { projectPluginSpec } from "@inhuman.tools/harness-model";
+import { normalizeDefinitions, resolveReferences } from "@inhuman.tools/plugin-sdk";
+import { setPackToolCatalog } from "./pack-catalog.js";
+import { compilePluginInstall, mergePluginInstallState } from "./plugin-registry.js";
+import { parametersFromZod } from "./tool-entry.js";
+import { argsJsonValue, unknownRecordSchema } from "../schemas/json-record.js";
+import { HOST_PLUGINS, projectHostPluginSpecs, SYSTEM_PLUGIN_NAMES, SYSTEM_WIRE_NAMES, } from "../system-plugins/index.js";
+import { namedAgentsInstall } from "../system-plugins/named-agents/agent-stdlib.js";
+/** Daemon pack dataflow writes through here. Host plugins re-seed inside replacePack. */
+export async function applyPackPlugins(catalog, rows, kernel, projections) {
+    const errors = [];
+    const merged = [];
+    const seen = new Map();
+    const installed = [namedAgentsInstall];
+    for (const row of rows) {
+        if (SYSTEM_PLUGIN_NAMES.has(row.pluginName)) {
+            errors.push(`${row.pluginName}: plugin name reserved for host registration — skipped`);
+            continue;
+        }
+        try {
+            const definition = resolveReferences(normalizeDefinitions(row.module, row.pluginName), row.pluginName);
+            installed.push(compilePluginInstall(row.pluginName, definition));
+            for (const handle of handlesFromDefinition(row.pluginName, definition)) {
+                if (SYSTEM_WIRE_NAMES.has(handle.name)) {
+                    errors.push(`${row.pluginName}: tool "${handle.name}" collides with a registered tool — skipped`);
+                    continue;
+                }
+                if (handle.name.startsWith("mcp__")) {
+                    errors.push(`${row.pluginName}: tool name reserved for connection expand: ${handle.name} — skipped`);
+                    continue;
+                }
+                if (handle.name.startsWith("call__") || handle.name.startsWith("agent__")) {
+                    errors.push(`${row.pluginName}: tool name reserved for named agents: ${handle.name} — skipped`);
+                    continue;
+                }
+                const prior = seen.get(handle.name);
+                if (prior !== undefined) {
+                    errors.push(`${row.pluginName}: tool "${handle.name}" collides with plugin "${prior}" — skipped`);
+                    continue;
+                }
+                seen.set(handle.name, row.pluginName);
+                merged.push(handle);
+            }
+        }
+        catch (error) {
+            errors.push(`${row.pluginName}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    try {
+        catalog.replaceCompiledPlugins(mergePluginInstallState(installed));
+    }
+    catch (error) {
+        errors.push(error instanceof Error ? error.message : String(error));
+        catalog.replaceCompiledPlugins(mergePluginInstallState([namedAgentsInstall]));
+    }
+    setPackToolCatalog(catalog, merged);
+    if (kernel != null)
+        projectPackPluginSpecs(kernel, installed);
+    projections?.install({
+        ...HOST_PLUGINS,
+        ...Object.fromEntries(installed.map((record) => [record.pluginName, record.definition])),
+    });
+    return { loaded: merged.length, errors };
+}
+function projectPackPluginSpecs(kernel, installed) {
+    projectHostPluginSpecs(kernel);
+    const keep = new Set(Object.keys(kernel.pluginSpecs));
+    for (const record of installed) {
+        if (SYSTEM_PLUGIN_NAMES.has(record.pluginName))
+            continue;
+        projectPluginSpec(kernel, record.pluginName, record.definition.tools);
+        keep.add(record.pluginName);
+    }
+    for (const name of Object.keys(kernel.pluginSpecs)) {
+        if (!keep.has(name))
+            delete kernel.pluginSpecs[name];
+    }
+}
+function handlesFromDefinition(pluginName, definition) {
+    return definition.tools.map((tool) => handleFromTool(pluginName, tool));
+}
+function handleFromTool(pluginName, tool) {
+    const className = tool.class ?? "effect";
+    if (tool.type === "bot-call") {
+        return {
+            pluginName,
+            name: tool.name,
+            description: tool.description ?? tool.name,
+            class: className,
+            representation: tool.representation,
+            parameters: parametersFromZod(tool.input),
+            tool,
+            meta: {
+                kind: "bot-call",
+                pluginName,
+                target: tool.target,
+                background: tool.background === true,
+                lifetime: tool.lifetime ?? "turn",
+                show: tool.show ?? "result",
+                deadlineMs: tool.deadlineMs,
+                supportsNotify: tool.supportsNotify === true,
+            },
+            triggersReactLoop: tool.triggersReactLoop,
+            isSideChannel: tool.isSideChannel,
+            tapeHidden: tool.tapeHidden,
+        };
+    }
+    return {
+        pluginName,
+        name: tool.name,
+        description: tool.description ?? tool.name,
+        class: className,
+        representation: tool.representation,
+        parameters: parametersFromZod(tool.input),
+        tool,
+        meta: { kind: "function" },
+        execute: async (raw, ctx) => tool.run(tool.input.parse(raw), ctx),
+        triggersReactLoop: tool.triggersReactLoop,
+        isSideChannel: tool.isSideChannel,
+        tapeHidden: tool.tapeHidden,
+        exam: tool.exam,
+    };
+}
+export function parseArgs(argumentsJson) {
+    const parsed = unknownRecordSchema.safeParse(argsJsonValue(argumentsJson.trim() === "" ? "{}" : argumentsJson));
+    return parsed.success ? parsed.data : null;
+}
+//# sourceMappingURL=actor.js.map

package/dist/server/toolkit/actor.js.map

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

package/dist/server/toolkit/catalog.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Toolkit wire projection over a kernel tool catalog.
+ * Catalog class is `read` | `write` | `effect` | `meta`. Approval is the orchestrator
+ * hook, not this file.
+ */
+import type { KernelToolCatalog } from "./tool-table.js";
+/** Wire name. Catalog class is `effect`. */
+export declare const SHELL_TOOL_NAME = "shell";
+export interface OpenAiTool {
+    readonly type: "function";
+    readonly function: {
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: Record<string, unknown>;
+    };
+}
+export declare function openAiTools(catalog: KernelToolCatalog): readonly OpenAiTool[];
+/** Every alias target is a real catalog property (reverse mapping broke tools). */
+export declare const ARG_ALIASES: Readonly<Record<string, Readonly<Record<string, string>>>>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/server/toolkit/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/server/toolkit/catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,4CAA4C;AAC5C,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC9C,CAAC;CACH;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,SAAS,UAAU,EAAE,CAY7E;AAED,mFAAmF;AACnF,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CA+ElF,CAAC"}