@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/drivers/toolkit/executor.js

@@ -0,0 +1,60 @@
+/**
+ * Catalog dispatch. Registered tools work through CatalogEntry.execute
+ * (InhumanTool.execute). Failures are doors except ToolError containment throws.
+ */
+import { z } from "@inhuman.tools/plugin-sdk";
+import { createBackgroundHandle } from "./background.js";
+import { ToolError } from "./dist-tools.js";
+import { requireCatalog } from "./tool-table.js";
+export { ToolError, resolveInRoot, resolveWriteTarget } from "./dist-tools.js";
+function outcomeOf(out) {
+    if (out !== null && typeof out === "object" && !Array.isArray(out) && typeof out.ok === "boolean") {
+        const rec = out;
+        const hasText = typeof rec.text === "string";
+        const hasValue = "value" in rec;
+        if (hasText || hasValue || rec.ok === false) {
+            return {
+                ok: rec.ok,
+                ...(hasText ? { text: rec.text } : {}),
+                ...(hasValue ? { value: rec.value } : {}),
+            };
+        }
+    }
+    return { ok: true, value: out };
+}
+function doorText(error) {
+    if (error instanceof z.ZodError) {
+        return `Error: ${error.issues[0]?.message ?? "invalid arguments"}`;
+    }
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+/** Validate against catalog then run. Truncation is admit's bound, not here. */
+export async function runTool(name, rawArgs, context) {
+    const catalog = requireCatalog(context.catalog, name);
+    const entry = catalog.catalogEntry(name);
+    if (entry !== undefined && entry.execute !== undefined) {
+        try {
+            const out = await entry.execute(rawArgs, {
+                root: context.root,
+                signal: context.signal,
+                sessionId: context.sessionId,
+                background: createBackgroundHandle(context.origin),
+                catalog,
+            });
+            return outcomeOf(out);
+        }
+        catch (error) {
+            if (error instanceof ToolError)
+                throw error;
+            return { ok: false, text: error instanceof z.ZodError ? doorText(error) : `${name}: ${doorText(error)}` };
+        }
+    }
+    if (name.startsWith("mcp__")) {
+        throw new ToolError(`unknown MCP tool "${name}" — connection missing, disabled, or not expanded`);
+    }
+    const available = catalog.catalogWireNames().join(", ");
+    throw new ToolError(`unknown tool "${name}" — available: ${available}`);
+}
+//# sourceMappingURL=executor.js.map

package/dist/drivers/toolkit/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/drivers/toolkit/executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,2BAA2B,CAAC;AAG9C,OAAO,EAAE,sBAAsB,EAA6B,MAAM,iBAAiB,CAAC;AACpF,OAAO,EAAE,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAA0B,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAmB,MAAM,iBAAiB,CAAC;AAYhG,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,OAAQ,GAAwB,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QACxH,MAAM,GAAG,GAAG,GAAuD,CAAC;QACpE,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;QAC7C,MAAM,QAAQ,GAAG,OAAO,IAAI,GAAG,CAAC;QAChC,IAAI,OAAO,IAAI,QAAQ,IAAI,GAAG,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;YAC5C,OAAO;gBACL,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChC,OAAO,UAAU,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACrE,CAAC;IACD,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,OAAgB,EAAE,OAAoB;IAChF,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAEzC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;gBACvC,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,UAAU,EAAE,sBAAsB,CAAC,OAAO,CAAC,MAAM,CAAC;gBAClD,OAAO;aACR,CAAC,CAAC;YACH,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,SAAS;gBAAE,MAAM,KAAK,CAAC;YAC5C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QAC5G,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,SAAS,CAAC,qBAAqB,IAAI,mDAAmD,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,IAAI,SAAS,CAAC,iBAAiB,IAAI,kBAAkB,SAAS,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/dist/drivers/toolkit/finder.d.ts

@@ -0,0 +1,4 @@
+import { FileFinder } from "@ff-labs/fff-node";
+/** Process-local finder for `root`. Scan must finish before the first search. */
+export declare function finderFor(root: string, signal?: AbortSignal): Promise<FileFinder>;
+//# sourceMappingURL=finder.d.ts.map

package/dist/drivers/toolkit/finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"finder.d.ts","sourceRoot":"","sources":["../../../src/drivers/toolkit/finder.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAgB/C,iFAAiF;AACjF,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAkBvF"}

package/dist/drivers/toolkit/finder.js

@@ -0,0 +1,65 @@
+/**
+ * One FileFinder per workspace root. Observe tools (glob, fff_search, grep)
+ * share this index — not a second JS walker.
+ */
+import { realpath } from "node:fs/promises";
+import { FileFinder } from "@ff-labs/fff-node";
+const finders = new Map();
+const booting = new Map();
+async function rootKey(root) {
+    try {
+        return await realpath(root);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            throw new Error(`no such project root: ${root}`);
+        }
+        throw error;
+    }
+}
+/** Process-local finder for `root`. Scan must finish before the first search. */
+export async function finderFor(root, signal) {
+    if (!FileFinder.isAvailable()) {
+        throw new Error("fff native binary is not available on this platform");
+    }
+    const key = await rootKey(root);
+    const live = finders.get(key);
+    if (live !== undefined && !live.isDestroyed)
+        return live;
+    let pending = booting.get(key);
+    if (pending === undefined) {
+        pending = boot(key, signal);
+        booting.set(key, pending);
+    }
+    try {
+        return await pending;
+    }
+    finally {
+        booting.delete(key);
+    }
+}
+async function boot(key, signal) {
+    const created = FileFinder.create({
+        basePath: key,
+        aiMode: true,
+    });
+    if (!created.ok)
+        throw new Error(`fff: ${created.error}`);
+    const finder = created.value;
+    try {
+        if (signal?.aborted)
+            throw new Error("fff scan aborted");
+        const scanned = await finder.waitForScan(15_000);
+        if (signal?.aborted)
+            throw new Error("fff scan aborted");
+        if (!scanned.ok)
+            throw new Error(`fff scan: ${scanned.error}`);
+        finders.set(key, finder);
+        return finder;
+    }
+    catch (error) {
+        finder.destroy();
+        throw error;
+    }
+}
+//# sourceMappingURL=finder.js.map

package/dist/drivers/toolkit/finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finder.js","sourceRoot":"","sources":["../../../src/drivers/toolkit/finder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;AAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAA+B,CAAC;AAEvD,KAAK,UAAU,OAAO,CAAC,IAAY;IACjC,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,MAAoB;IAChE,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAEzD,IAAI,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,GAAW,EAAE,MAAoB;IACnD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,QAAQ,EAAE,GAAG;QACb,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/drivers/toolkit/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Standard toolkit — workspace FS stdlib for model-callable tools.
+ *
+ * Public surface:
+ * - default export {@link ToolCallDriverConnection} — the class is the driver
+ * - model exposure — schemas / aliases / system addendum
+ * - one catalog table per kernel (registered ∪ connection)
+ *
+ * `export *` never re-exports a default — forward it explicitly.
+ * Table storage errors are `tablePackLoadErrors`; the public query is
+ * pack-catalog's `packLoadErrors`.
+ */
+export { default } from "./actor.js";
+export * from "./actor.js";
+export * from "./catalog.js";
+export * from "./tool-entry.js";
+export * from "./tool-table.js";
+export * from "./pack-catalog.js";
+export * from "./plugin-tools.js";
+export * from "./pack-plugin-host.js";
+export * from "./connection-tools.js";
+export * from "./background.js";
+export * from "./executor.js";
+export * from "./shell-tool.js";
+export * from "./system-plugins.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/drivers/toolkit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/drivers/toolkit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/drivers/toolkit/index.js

@@ -0,0 +1,26 @@
+/**
+ * Standard toolkit — workspace FS stdlib for model-callable tools.
+ *
+ * Public surface:
+ * - default export {@link ToolCallDriverConnection} — the class is the driver
+ * - model exposure — schemas / aliases / system addendum
+ * - one catalog table per kernel (registered ∪ connection)
+ *
+ * `export *` never re-exports a default — forward it explicitly.
+ * Table storage errors are `tablePackLoadErrors`; the public query is
+ * pack-catalog's `packLoadErrors`.
+ */
+export { default } from "./actor.js";
+export * from "./actor.js";
+export * from "./catalog.js";
+export * from "./tool-entry.js";
+export * from "./tool-table.js";
+export * from "./pack-catalog.js";
+export * from "./plugin-tools.js";
+export * from "./pack-plugin-host.js";
+export * from "./connection-tools.js";
+export * from "./background.js";
+export * from "./executor.js";
+export * from "./shell-tool.js";
+export * from "./system-plugins.js";
+//# sourceMappingURL=index.js.map

package/dist/drivers/toolkit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/drivers/toolkit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/drivers/toolkit/pack-catalog.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Pack fill of the one tool table (enabled plugins).
+ * Types + set; storage is tool-table.ts.
+ */
+import { type KernelToolCatalog } from "./tool-table.js";
+export type PackToolHandle = {
+    readonly pluginName: string;
+    readonly name: string;
+    readonly description: string;
+    /** Catalog class: `read` | `write` | `effect`. */
+    readonly class: string;
+    readonly tolerances: Readonly<Record<string, readonly string[]>> | undefined;
+    /** JSON Schema for model tools[] parameters. */
+    readonly parameters: Record<string, unknown>;
+    readonly execute: (raw: unknown, ctx: {
+        root?: string;
+        signal?: AbortSignal;
+        sessionId?: string;
+        background?: unknown;
+    }) => Promise<unknown>;
+};
+/** Replace the user-pack half of the unified catalog. Host plugins re-seed. */
+export declare function setPackToolCatalog(catalog: KernelToolCatalog, handles: readonly PackToolHandle[], errors?: readonly string[]): void;
+/** Pack-owned cognition. The lane is generic; the tenant plugs this in. */
+export type MindProvider = {
+    readonly prompt: (input: {
+        readonly topic: string;
+        readonly transcript: string;
+    }) => string;
+    readonly consolidate: (input: {
+        readonly payload: string;
+        readonly sessionPath: string;
+    }) => void | Promise<void>;
+    /** `inject` iff the investigation is worth surfacing. */
+    readonly surface: (text: string) => "inject" | "silent";
+    readonly environment?: {
+        readonly constitution?: string;
+        readonly env?: Readonly<Record<string, string>>;
+    };
+};
+export declare function isMindProvider(value: unknown): value is MindProvider;
+export declare function setMindProvider(provider: MindProvider | null): void;
+export declare function mindProvider(): MindProvider | null;
+//# sourceMappingURL=pack-catalog.d.ts.map

package/dist/drivers/toolkit/pack-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-catalog.d.ts","sourceRoot":"","sources":["../../../src/drivers/toolkit/pack-catalog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE5E,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;IAC7E,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,CAChB,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,KACnF,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,MAAM,GAAE,SAAS,MAAM,EAAO,GAC7B,IAAI,CAWN;AAID,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IAC5F,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE;QAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,QAAQ,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;KACjD,CAAC;CACH,CAAC;AAEF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAQpE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAEnE;AAED,wBAAgB,YAAY,IAAI,YAAY,GAAG,IAAI,CAElD"}

package/dist/drivers/toolkit/pack-catalog.js

@@ -0,0 +1,29 @@
+/** Replace the user-pack half of the unified catalog. Host plugins re-seed. */
+export function setPackToolCatalog(catalog, handles, errors = []) {
+    const entries = handles.map((h) => ({
+        wireName: h.name,
+        description: h.description,
+        parameters: h.parameters,
+        class: h.class,
+        tolerances: h.tolerances,
+        source: { kind: "pack", pluginName: h.pluginName },
+        execute: h.execute,
+    }));
+    catalog.replacePack(entries, errors);
+}
+let currentMind = null;
+export function isMindProvider(value) {
+    if (value == null || typeof value !== "object")
+        return false;
+    const row = value;
+    return (typeof row.prompt === "function" &&
+        typeof row.consolidate === "function" &&
+        typeof row.surface === "function");
+}
+export function setMindProvider(provider) {
+    currentMind = provider;
+}
+export function mindProvider() {
+    return currentMind;
+}
+//# sourceMappingURL=pack-catalog.js.map

package/dist/drivers/toolkit/pack-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-catalog.js","sourceRoot":"","sources":["../../../src/drivers/toolkit/pack-catalog.ts"],"names":[],"mappings":"AAqBA,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAChC,OAA0B,EAC1B,OAAkC,EAClC,MAAM,GAAsB,EAAE;IAE9B,MAAM,OAAO,GAAmB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,QAAQ,EAAE,CAAC,CAAC,IAAI;QAChB,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAe,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE;QAC3D,OAAO,EAAE,CAAC,CAAC,OAAO;KACnB,CAAC,CAAC,CAAC;IACJ,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACvC,CAAC;AAED,IAAI,WAAW,GAAwB,IAAI,CAAC;AAiB5C,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC7D,MAAM,GAAG,GAAG,KAAuE,CAAC;IACpF,OAAO,CACL,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU;QAChC,OAAO,GAAG,CAAC,WAAW,KAAK,UAAU;QACrC,OAAO,GAAG,CAAC,OAAO,KAAK,UAAU,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAA6B;IAC3D,WAAW,GAAG,QAAQ,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/drivers/toolkit/pack-plugin-host.d.ts

@@ -0,0 +1,29 @@
+import { type PluginModuleRow } from "./plugin-tools.js";
+import type { KernelToolCatalog } from "./tool-table.js";
+export type PackPluginRow = {
+    readonly pluginName: string;
+    readonly enabled: boolean;
+    readonly rootPath: string;
+    readonly modules: readonly string[];
+};
+export type PackPluginApplyReport = {
+    readonly loaded: number;
+    readonly errors: readonly string[];
+};
+type PackPluginApply = (rows: readonly PluginModuleRow[]) => Promise<PackPluginApplyReport>;
+type PackPluginOps = {
+    readonly catalog: KernelToolCatalog;
+    readonly kernelRoot: string;
+    readonly importModule?: (pluginName: string, specifier: string, rootPath: string) => Promise<unknown>;
+    readonly apply?: PackPluginApply;
+    readonly onError?: (pluginName: string, error: unknown) => void;
+};
+export declare function resolvePluginModuleUrl(kernelRoot: string, pluginRoot: string, specifier: string): string;
+export declare class PackPluginCatalogHost implements Disposable {
+    #private;
+    constructor(ops: PackPluginOps);
+    sync(rows: readonly PackPluginRow[]): Promise<void>;
+    [Symbol.dispose](): void;
+}
+export {};
+//# sourceMappingURL=pack-plugin-host.d.ts.map

package/dist/drivers/toolkit/pack-plugin-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack-plugin-host.d.ts","sourceRoot":"","sources":["../../../src/drivers/toolkit/pack-plugin-host.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AAEF,KAAK,eAAe,GAAG,CACrB,IAAI,EAAE,SAAS,eAAe,EAAE,KAC7B,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEpC,KAAK,aAAa,GAAG;IACnB,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtG,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACjE,CAAC;AAUF,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAkBxG;AAQD,qBAAa,qBAAsB,YAAW,UAAU;;IAUtD,YAAY,GAAG,EAAE,aAAa,EAO7B;IAEK,IAAI,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCxD;IAED,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAMvB;CACF"}

package/dist/drivers/toolkit/pack-plugin-host.js

@@ -0,0 +1,119 @@
+/**
+ * Kernel-lifetime owner of the pack catalog fill.
+ *
+ * Plugin modules are already enumerated on `InstalledPlugin.modules`
+ * (`plugin.json` `plugins[].importPath`). This host imports them and writes
+ * through `ToolCallDriverConnection.applyPackPlugins`. Pack catalog has no
+ * per-plugin slices: the live owner's rows replace the fill; disposing
+ * restores the previous owner (or clears).
+ *
+ * Relative specifiers resolve inside the plugin root; package specifiers
+ * resolve from the kernel install (`node_modules` / shipped symlinks).
+ */
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { isAbsolute, join, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { ToolCallDriverConnection } from "./actor.js";
+function fingerprint(rows) {
+    return JSON.stringify([...rows]
+        .map((row) => [row.pluginName, row.enabled, row.rootPath, [...row.modules]])
+        .sort((a, b) => String(a[0]).localeCompare(String(b[0]))));
+}
+export function resolvePluginModuleUrl(kernelRoot, pluginRoot, specifier) {
+    if (specifier.startsWith("./") || specifier.startsWith("../") || isAbsolute(specifier)) {
+        if (pluginRoot.trim() === "") {
+            throw new Error(`importPath ${specifier}: plugin root is empty`);
+        }
+        const file = resolve(pluginRoot, specifier);
+        const inside = resolve(pluginRoot);
+        const prefix = inside.endsWith("/") ? inside : `${inside}/`;
+        if (file !== inside && !file.startsWith(prefix)) {
+            throw new Error(`importPath escapes plugin root: ${specifier}`);
+        }
+        if (!existsSync(file)) {
+            throw new Error(`importPath not found: ${specifier}`);
+        }
+        return pathToFileURL(file).href;
+    }
+    const parent = join(kernelRoot, "package.json");
+    return pathToFileURL(createRequire(parent).resolve(specifier)).href;
+}
+async function importPluginModule(kernelRoot, specifier, rootPath) {
+    const url = resolvePluginModuleUrl(kernelRoot, rootPath, specifier);
+    const mod = (await import(url));
+    return mod;
+}
+export class PackPluginCatalogHost {
+    #catalog;
+    #kernelRoot;
+    #importModule;
+    #apply;
+    #onError;
+    #fingerprint;
+    #generation = 0;
+    #disposed = false;
+    constructor(ops) {
+        this.#catalog = ops.catalog;
+        this.#kernelRoot = ops.kernelRoot;
+        this.#importModule =
+            ops.importModule ?? ((_pluginName, specifier, rootPath) => importPluginModule(this.#kernelRoot, specifier, rootPath));
+        this.#apply = ops.apply ?? ((rows) => ToolCallDriverConnection.applyPackPlugins(this.#catalog, rows));
+        this.#onError = ops.onError;
+    }
+    async sync(rows) {
+        if (this.#disposed)
+            return;
+        const nextFingerprint = fingerprint(rows);
+        if (this.#fingerprint === nextFingerprint)
+            return;
+        const generation = ++this.#generation;
+        const imported = [];
+        for (const row of rows) {
+            if (!row.enabled)
+                continue;
+            for (const specifier of row.modules) {
+                const trimmed = specifier.trim();
+                if (trimmed === "")
+                    continue;
+                try {
+                    const module = await this.#importModule(row.pluginName, trimmed, row.rootPath);
+                    if (this.#disposed || this.#generation !== generation)
+                        return;
+                    imported.push({ pluginName: row.pluginName, module });
+                }
+                catch (error) {
+                    if (this.#disposed || this.#generation !== generation)
+                        return;
+                    this.#onError?.(row.pluginName, error);
+                }
+            }
+        }
+        if (this.#disposed || this.#generation !== generation)
+            return;
+        try {
+            const report = await this.#apply(imported);
+            if (this.#disposed || this.#generation !== generation)
+                return;
+            for (const message of report.errors) {
+                this.#onError?.(imported[0]?.pluginName ?? "pack", new Error(message));
+            }
+            this.#fingerprint = nextFingerprint;
+        }
+        catch (error) {
+            if (this.#disposed || this.#generation !== generation)
+                return;
+            this.#fingerprint = undefined;
+            this.#onError?.("pack", error);
+        }
+    }
+    [Symbol.dispose]() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#generation += 1;
+        this.#fingerprint = undefined;
+        void this.#apply([]);
+    }
+}
+//# sourceMappingURL=pack-plugin-host.js.map

package/dist/drivers/toolkit/pack-plugin-host.js.map

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

package/dist/drivers/toolkit/plugin-tools.d.ts

@@ -0,0 +1,6 @@
+/** Already-imported plugin module row. Catalog apply lives on ToolCallDriverConnection. */
+export type PluginModuleRow = {
+    readonly pluginName: string;
+    readonly module: unknown;
+};
+//# sourceMappingURL=plugin-tools.d.ts.map

package/dist/drivers/toolkit/plugin-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-tools.d.ts","sourceRoot":"","sources":["../../../src/drivers/toolkit/plugin-tools.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,CAAC"}

package/dist/drivers/toolkit/plugin-tools.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-tools.js.map

package/dist/drivers/toolkit/plugin-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-tools.js","sourceRoot":"","sources":["../../../src/drivers/toolkit/plugin-tools.ts"],"names":[],"mappings":""}

package/dist/drivers/toolkit/shell-tool.d.ts

@@ -0,0 +1,19 @@
+import { InhumanTool } from "@inhuman.tools/plugin-sdk";
+export type ShellResult = {
+    readonly ok: boolean;
+    readonly value: {
+        readonly exitCode: number | null;
+        readonly stdout: string;
+        readonly stderr: string;
+    };
+};
+export declare const shellTool: InhumanTool<{
+    command: string;
+    cwd?: string | undefined;
+    timeoutMs?: number | undefined;
+}, {
+    ok: boolean;
+    text?: string | undefined;
+    value?: unknown;
+}>;
+//# sourceMappingURL=shell-tool.d.ts.map

package/dist/drivers/toolkit/shell-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-tool.d.ts","sourceRoot":"","sources":["../../../src/drivers/toolkit/shell-tool.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAK,MAAM,2BAA2B,CAAC;AAS3D,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB,CAAC;CACH,CAAC;AA6EF,eAAO,MAAM,SAAS;;;;;;;;EAmBpB,CAAC"}

package/dist/drivers/toolkit/shell-tool.js

@@ -0,0 +1,102 @@
+/**
+ * Host-registered `shell` tool. Same catalog path as the FS tools; catalog
+ * class is `effect`. Permission is name-keyed — not workspace auto-classes.
+ */
+import { spawn } from "node:child_process";
+import { stat } from "node:fs/promises";
+import { InhumanTool, z } from "@inhuman.tools/plugin-sdk";
+import { SHELL_TOOL_NAME } from "./catalog.js";
+import { resolveInRoot, ToolError, toolResultSchema } from "./dist-tools.js";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_TIMEOUT_MS = 600_000;
+const MAX_SHELL_OUTPUT_BYTES = 256 * 1024;
+function requireRoot(ctx) {
+    const root = ctx.root;
+    if (root == null || root === "")
+        throw new TypeError("ctx.root string required");
+    return root;
+}
+function clip(text, maxBytes, totalBytes) {
+    if (totalBytes <= maxBytes)
+        return text;
+    const buf = Buffer.from(text, "utf8").subarray(0, maxBytes);
+    return `${buf.toString("utf8")}\n…[truncated at ${maxBytes} bytes]`;
+}
+async function runShell(input, ctx) {
+    const cwd = input.cwd !== undefined ? await resolveInRoot(ctx.root, input.cwd) : ctx.root;
+    const st = await stat(cwd).catch((error) => {
+        if (error.code === "ENOENT")
+            throw new ToolError(`shell cwd does not exist: ${input.cwd ?? "."}`);
+        throw error;
+    });
+    if (!st.isDirectory())
+        throw new ToolError(`shell cwd is not a directory: ${input.cwd ?? "."}`);
+    const timeoutMs = Math.min(input.timeoutMs ?? DEFAULT_TIMEOUT_MS, MAX_TIMEOUT_MS);
+    const timeout = AbortSignal.timeout(timeoutMs);
+    const signal = ctx.signal !== undefined ? AbortSignal.any([ctx.signal, timeout]) : timeout;
+    return await new Promise((resolve, reject) => {
+        const child = spawn("/bin/sh", ["-c", input.command], {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"],
+            signal,
+        });
+        // Drain always (a full pipe blocks the child); retain only up to the cap.
+        const stdout = [];
+        const stderr = [];
+        let stdoutKept = 0;
+        let stderrKept = 0;
+        child.stdout?.on("data", (chunk) => {
+            if (stdoutKept < MAX_SHELL_OUTPUT_BYTES)
+                stdout.push(chunk);
+            stdoutKept += chunk.length;
+        });
+        child.stderr?.on("data", (chunk) => {
+            if (stderrKept < MAX_SHELL_OUTPUT_BYTES)
+                stderr.push(chunk);
+            stderrKept += chunk.length;
+        });
+        child.on("error", reject);
+        child.on("close", (exitCode) => {
+            if (signal.aborted) {
+                reject(signal.reason instanceof Error ? signal.reason : new Error("shell call cancelled"));
+                return;
+            }
+            const out = clip(Buffer.concat(stdout).toString("utf8"), MAX_SHELL_OUTPUT_BYTES, stdoutKept);
+            const err = clip(Buffer.concat(stderr).toString("utf8"), MAX_SHELL_OUTPUT_BYTES, stderrKept);
+            resolve({
+                ok: exitCode === 0,
+                value: { exitCode, stdout: out, stderr: err },
+            });
+        });
+    }).catch((error) => {
+        if (signal.aborted) {
+            const reason = signal.reason;
+            const timedOut = (reason instanceof DOMException && reason.name === "TimeoutError") ||
+                (reason instanceof Error && /timed out|Timeout/i.test(reason.message));
+            throw new ToolError(timedOut
+                ? `shell timed out after ${timeoutMs}ms`
+                : "shell call cancelled");
+        }
+        throw error;
+    });
+}
+export const shellTool = new InhumanTool({
+    name: SHELL_TOOL_NAME,
+    description: "Run a command in the project workspace through /bin/sh. Requires confirmation, separately from file writes.",
+    class: "effect",
+    input: z.object({
+        command: z.string().min(1).describe("The shell command to run."),
+        cwd: z
+            .preprocess((value) => (value === "" || value === null ? undefined : value), z.string().optional())
+            .describe("Working directory, relative to the project root."),
+        timeoutMs: z
+            .number()
+            .int()
+            .min(1)
+            .optional()
+            .describe("Optional per-call timeout in milliseconds. Defaults to 30000; capped at 600000."),
+    }),
+    output: toolResultSchema,
+    run: (input, ctx) => runShell(input, { root: requireRoot(ctx), signal: ctx.signal }),
+});
+//# sourceMappingURL=shell-tool.js.map

package/dist/drivers/toolkit/shell-tool.js.map

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

package/dist/drivers/toolkit/system-plugins.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Always-on host plugins. Same InhumanPlugin registration path as user packs.
+ * `replacePack` re-seeds these; packs cannot overlay their wire names.
+ */
+import { InhumanPlugin } from "@inhuman.tools/plugin-sdk";
+import type { CatalogEntry } from "./tool-table.js";
+export declare const TOOLKIT_PLUGIN_NAME = "toolkit";
+export declare const SHELL_PLUGIN_NAME = "shell";
+export declare const SCHEME_REPL_PLUGIN_NAME = "scheme-repl";
+export declare const SYSTEM_PLUGIN_NAMES: Set<string>;
+export declare const toolkitPlugin: InhumanPlugin;
+export declare const shellPlugin: InhumanPlugin;
+export declare const schemeReplPlugin: InhumanPlugin;
+export declare const SYSTEM_ENTRIES: readonly CatalogEntry[];
+export declare const SYSTEM_WIRE_NAMES: Set<string>;
+//# sourceMappingURL=system-plugins.d.ts.map

package/dist/drivers/toolkit/system-plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-plugins.d.ts","sourceRoot":"","sources":["../../../src/drivers/toolkit/system-plugins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,iBAAiB,UAAU,CAAC;AACzC,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AAErD,eAAO,MAAM,mBAAmB,aAI9B,CAAC;AAEH,eAAO,MAAM,aAAa,eAAgD,CAAC;AAC3E,eAAO,MAAM,WAAW,eAA4C,CAAC;AACrE,eAAO,MAAM,gBAAgB,eAAiD,CAAC;AAQ/E,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAOjD,CAAC;AAEF,eAAO,MAAM,iBAAiB,aAAyD,CAAC"}