@nodetool-ai/agents 0.7.0-rc.22 → 0.8.1

package/dist/host-modules/csv.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@nodetool-ai/sandbox-csv` — papaparse, on the host.
+ *
+ * papaparse imports `node:stream`, so the sandbox compiler cannot admit it as a
+ * guest module. It runs here instead, behind the generated facade, and the
+ * guest sees plain arrays.
+ */
+/**
+ * CSV text to records keyed by the header row, or raw rows with `header: false`.
+ *
+ * Values stay strings — no `dynamicTyping` — so a column never changes shape
+ * between runs; guest code converts what it needs with `Number()`/`Date`.
+ */
+export declare function parse(text: unknown, options?: unknown): Promise<unknown[]>;
+/** Records or row arrays back out as CSV text — the inverse of {@link parse}. */
+export declare function stringify(rows: unknown, options?: unknown): Promise<string>;
+//# sourceMappingURL=csv.d.ts.map

package/dist/host-modules/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../src/host-modules/csv.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH;;;;;GAKG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,EAAE,CAAC,CAwBpB;AAED,iFAAiF;AACjF,wBAAsB,SAAS,CAC7B,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/host-modules/csv.js

@@ -0,0 +1,64 @@
+/**
+ * `@nodetool-ai/sandbox-csv` — papaparse, on the host.
+ *
+ * papaparse imports `node:stream`, so the sandbox compiler cannot admit it as a
+ * guest module. It runs here instead, behind the generated facade, and the
+ * guest sees plain arrays.
+ */
+import { optionsOf, requireText, unwrapLibrary } from "./limits.js";
+import { isFunction, isObjectLike } from "../utils/type-guards.js";
+async function loadPapaparse(where) {
+    const mod = await import("papaparse");
+    return unwrapLibrary(mod, where, "papaparse", (v) => isFunction(v?.parse));
+}
+/**
+ * CSV text to records keyed by the header row, or raw rows with `header: false`.
+ *
+ * Values stay strings — no `dynamicTyping` — so a column never changes shape
+ * between runs; guest code converts what it needs with `Number()`/`Date`.
+ */
+export async function parse(text, options) {
+    const where = "csv.parse";
+    const input = requireText(where, text);
+    const opts = optionsOf(options);
+    const header = opts.header === undefined ? true : Boolean(opts.header);
+    // papaparse treats "" as auto-detect.
+    const delimiter = opts.delimiter === undefined || opts.delimiter === null
+        ? ""
+        : String(opts.delimiter);
+    if (delimiter.length > 1) {
+        throw new Error(`${where}: delimiter must be a single character`);
+    }
+    const papa = await loadPapaparse(where);
+    const parsed = papa.parse(input, {
+        header,
+        delimiter,
+        dynamicTyping: false,
+        skipEmptyLines: true
+    });
+    const rows = Array.isArray(parsed.data) ? parsed.data : [];
+    return header
+        ? rows.filter((row) => isObjectLike(row))
+        : rows.filter((row) => Array.isArray(row));
+}
+/** Records or row arrays back out as CSV text — the inverse of {@link parse}. */
+export async function stringify(rows, options) {
+    const where = "csv.stringify";
+    if (!Array.isArray(rows)) {
+        throw new Error(`${where}: rows must be an array of records or arrays`);
+    }
+    const opts = optionsOf(options);
+    const delimiter = opts.delimiter === undefined || opts.delimiter === null
+        ? ","
+        : String(opts.delimiter);
+    if (delimiter.length !== 1) {
+        throw new Error(`${where}: delimiter must be a single character`);
+    }
+    const papa = await loadPapaparse(where);
+    return papa.unparse(rows, {
+        delimiter,
+        header: opts.header === undefined ? true : Boolean(opts.header),
+        newline: "\n"
+    });
+}
+//# sourceMappingURL=csv.js.map

package/dist/host-modules/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../src/host-modules/csv.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAUnE,KAAK,UAAU,aAAa,CAAC,KAAa;IACxC,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,aAAa,CAClB,GAAG,EACH,KAAK,EACL,WAAW,EACX,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAE,CAA+B,EAAE,KAAK,CAAC,CAC3D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,IAAa,EACb,OAAiB;IAEjB,MAAM,KAAK,GAAG,WAAW,CAAC;IAC1B,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvE,sCAAsC;IACtC,MAAM,SAAS,GACb,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;QACrD,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wCAAwC,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;QAC/B,MAAM;QACN,SAAS;QACT,aAAa,EAAE,KAAK;QACpB,cAAc,EAAE,IAAI;KACrB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,OAAO,MAAM;QACX,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAa,EACb,OAAiB;IAEjB,MAAM,KAAK,GAAG,eAAe,CAAC;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8CAA8C,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,SAAS,GACb,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI;QACrD,CAAC,CAAC,GAAG;QACL,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wCAAwC,CAAC,CAAC;IACpE,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;QACxB,SAAS;QACT,MAAM,EAAE,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;QAC/D,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/host-modules/diff.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `@nodetool-ai/sandbox-diff` — the `diff` library, on the host.
+ *
+ * It schedules with `setTimeout`, which the guest does not have, so the
+ * compiler refuses it as a guest module. It runs here instead.
+ */
+/** Unified diff of two texts — empty hunks mean identical. */
+export declare function unified(a: unknown, b: unknown, options?: unknown): Promise<string>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/host-modules/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/host-modules/diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2BH,8DAA8D;AAC9D,wBAAsB,OAAO,CAC3B,CAAC,EAAE,OAAO,EACV,CAAC,EAAE,OAAO,EACV,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/host-modules/diff.js

@@ -0,0 +1,26 @@
+/**
+ * `@nodetool-ai/sandbox-diff` — the `diff` library, on the host.
+ *
+ * It schedules with `setTimeout`, which the guest does not have, so the
+ * compiler refuses it as a guest module. It runs here instead.
+ */
+import { optionsOf, requireText, unwrapLibrary } from "./limits.js";
+import { isFunction } from "../utils/type-guards.js";
+async function loadDiff(where) {
+    const mod = await import("diff");
+    return unwrapLibrary(mod, where, "diff", (v) => isFunction(v?.createTwoFilesPatch));
+}
+/** Unified diff of two texts — empty hunks mean identical. */
+export async function unified(a, b, options) {
+    const where = "diff.unified";
+    const left = requireText(where, a, "a");
+    const right = requireText(where, b, "b");
+    const opts = optionsOf(options);
+    const rawContext = Number(opts.context ?? 3);
+    const context = Number.isFinite(rawContext)
+        ? Math.min(Math.max(Math.floor(rawContext), 0), 100)
+        : 3;
+    const diffLib = await loadDiff(where);
+    return diffLib.createTwoFilesPatch(String(opts.oldName ?? "a"), String(opts.newName ?? "b"), left, right, undefined, undefined, { context });
+}
+//# sourceMappingURL=diff.js.map

package/dist/host-modules/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/host-modules/diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAcrD,KAAK,UAAU,QAAQ,CAAC,KAAa;IACnC,MAAM,GAAG,GAAY,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,aAAa,CAClB,GAAG,EACH,KAAK,EACL,MAAM,EACN,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAE,CAA0B,EAAE,mBAAmB,CAAC,CACpE,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,CAAU,EACV,CAAU,EACV,OAAiB;IAEjB,MAAM,KAAK,GAAG,cAAc,CAAC;IAC7B,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC;QACzC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC;QACpD,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtC,OAAO,OAAO,CAAC,mBAAmB,CAChC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,EAC3B,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,EAC3B,IAAI,EACJ,KAAK,EACL,SAAS,EACT,SAAS,EACT,EAAE,OAAO,EAAE,CACZ,CAAC;AACJ,CAAC"}

package/dist/host-modules/dispatcher.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The per-run dispatcher for host modules — the security boundary of the
+ * host-JS import path, and the exact analog of the WASM dispatcher next door.
+ *
+ * A generated facade is a convenience; it is not what holds the line. Every
+ * call arrives here with three untrusted values — the module key, the export
+ * name, and the argument list — and every one is checked before an
+ * implementation runs:
+ *
+ * - the module key must be a specifier **this run declared**;
+ * - that specifier's host id must be one the protocol registry lists, and the
+ *   registry's `packName` for it must be the pack the specifier belongs to, so
+ *   a forged resolution cannot borrow another pack's implementation;
+ * - the export name must be one the registry lists for that id;
+ * - the arguments must be an array.
+ *
+ * Guest code that gets hold of a dispatcher some other way gains nothing beyond
+ * the run's own declared surface.
+ */
+import { type ResolvedSandboxModule } from "@nodetool-ai/protocol";
+/** Raised when a call breaks the host module contract. */
+export declare class SandboxHostModuleError extends Error {
+    constructor(message: string);
+}
+export interface SandboxHostDispatcher {
+    /** Specifiers this run may call, in declaration order. */
+    readonly specifiers: readonly string[];
+    /**
+     * The one entry point guest code reaches. Every argument is untrusted and
+     * validated here before an implementation is loaded, let alone called.
+     */
+    call(moduleKey: unknown, exportName: unknown, args: unknown): Promise<unknown>;
+}
+/**
+ * Build the dispatcher for one invocation, or `undefined` when the run declares
+ * no host modules.
+ */
+export declare function createSandboxHostDispatcher(modules: readonly ResolvedSandboxModule[], options?: {
+    signal?: AbortSignal;
+}): SandboxHostDispatcher | undefined;
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/host-modules/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/host-modules/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAM/B,0DAA0D;AAC1D,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAQD,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChF;AAWD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GACrC,qBAAqB,GAAG,SAAS,CAkEnC"}

package/dist/host-modules/dispatcher.js

@@ -0,0 +1,99 @@
+/**
+ * The per-run dispatcher for host modules — the security boundary of the
+ * host-JS import path, and the exact analog of the WASM dispatcher next door.
+ *
+ * A generated facade is a convenience; it is not what holds the line. Every
+ * call arrives here with three untrusted values — the module key, the export
+ * name, and the argument list — and every one is checked before an
+ * implementation runs:
+ *
+ * - the module key must be a specifier **this run declared**;
+ * - that specifier's host id must be one the protocol registry lists, and the
+ *   registry's `packName` for it must be the pack the specifier belongs to, so
+ *   a forged resolution cannot borrow another pack's implementation;
+ * - the export name must be one the registry lists for that id;
+ * - the arguments must be an array.
+ *
+ * Guest code that gets hold of a dispatcher some other way gains nothing beyond
+ * the run's own declared surface.
+ */
+import { sandboxHostModule } from "@nodetool-ai/protocol";
+import { toGuestBytesDeep } from "../sandbox-bytes.js";
+import { loadSandboxHostModule } from "./registry.js";
+import { isFunction, isString } from "../utils/type-guards.js";
+/** Raised when a call breaks the host module contract. */
+export class SandboxHostModuleError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SandboxHostModuleError";
+    }
+}
+/** The pack name a specifier belongs to (`@scope/pack` or `pack`). */
+function packNameOf(specifier) {
+    if (specifier.startsWith("@")) {
+        const [scope, name] = specifier.split("/");
+        return name === undefined ? specifier : `${scope}/${name}`;
+    }
+    return specifier.split("/")[0] ?? specifier;
+}
+/**
+ * Build the dispatcher for one invocation, or `undefined` when the run declares
+ * no host modules.
+ */
+export function createSandboxHostDispatcher(modules, options = {}) {
+    const hostModules = modules.filter((module) => module.kind === "host");
+    if (hostModules.length === 0)
+        return undefined;
+    const byKey = new Map();
+    for (const module of hostModules) {
+        const spec = sandboxHostModule(module.hostId);
+        if (spec === undefined) {
+            throw new SandboxHostModuleError(`${module.specifier}: "${module.hostId}" is not a host module NodeTool implements`);
+        }
+        // Discovery already refused a foreign claim; the dispatcher refuses it
+        // again, because a resolution can reach here from a catalog this process
+        // did not build (the browser fetches one over HTTP).
+        if (spec.packName !== packNameOf(module.specifier)) {
+            throw new SandboxHostModuleError(`${module.specifier}: host module "${module.hostId}" belongs to ${spec.packName}`);
+        }
+        byKey.set(module.specifier, {
+            specifier: module.specifier,
+            hostId: module.hostId,
+            exports: new Set(spec.exports)
+        });
+    }
+    return {
+        specifiers: hostModules.map((module) => module.specifier),
+        async call(moduleKey, exportName, args) {
+            if (options.signal?.aborted === true) {
+                throw new SandboxHostModuleError("the run was cancelled");
+            }
+            const runModule = isString(moduleKey) ? byKey.get(moduleKey) : undefined;
+            if (runModule === undefined) {
+                throw new SandboxHostModuleError(`${describe(moduleKey)} is not a host sandbox module declared by this node`);
+            }
+            if (!isString(exportName) || !runModule.exports.has(exportName)) {
+                throw new SandboxHostModuleError(`${runModule.specifier} has no export named ${describe(exportName)}`);
+            }
+            if (!Array.isArray(args)) {
+                throw new SandboxHostModuleError(`${runModule.specifier}: ${exportName} was called with a non-list argument`);
+            }
+            const implementation = await loadSandboxHostModule(runModule.hostId);
+            const fn = Object.hasOwn(implementation, exportName)
+                ? implementation[exportName]
+                : undefined;
+            if (!isFunction(fn)) {
+                throw new SandboxHostModuleError(`${runModule.specifier}: ${exportName} has no implementation in this runtime`);
+            }
+            // Plain data out, with bytes tagged at any depth for the guest prelude to
+            // revive — the marshaling rule every bridge follows.
+            return toGuestBytesDeep(await fn(...args));
+        }
+    };
+}
+function describe(value) {
+    if (isString(value))
+        return JSON.stringify(value);
+    return `a ${value === null ? "null" : typeof value} value`;
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/host-modules/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/host-modules/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACL,iBAAiB,EAElB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE/D,0DAA0D;AAC1D,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAkBD,sEAAsE;AACtE,SAAS,UAAU,CAAC,SAAiB;IACnC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;IAC7D,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAAyC,EACzC,OAAO,GAA6B,EAAE;IAEtC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAChC,CAAC,MAAM,EAA8D,EAAE,CACrE,MAAM,CAAC,IAAI,KAAK,MAAM,CACzB,CAAC;IACF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC/C,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,sBAAsB,CAC9B,GAAG,MAAM,CAAC,SAAS,MAAM,MAAM,CAAC,MAAM,4CAA4C,CACnF,CAAC;QACJ,CAAC;QACD,uEAAuE;QACvE,yEAAyE;QACzE,qDAAqD;QACrD,IAAI,IAAI,CAAC,QAAQ,KAAK,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,sBAAsB,CAC9B,GAAG,MAAM,CAAC,SAAS,kBAAkB,MAAM,CAAC,MAAM,gBAAgB,IAAI,CAAC,QAAQ,EAAE,CAClF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE;YAC1B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,UAAU,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI;YACpC,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;gBACrC,MAAM,IAAI,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACzE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,IAAI,sBAAsB,CAC9B,GAAG,QAAQ,CAAC,SAAS,CAAC,qDAAqD,CAC5E,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAChE,MAAM,IAAI,sBAAsB,CAC9B,GAAG,SAAS,CAAC,SAAS,wBAAwB,QAAQ,CAAC,UAAU,CAAC,EAAE,CACrE,CAAC;YACJ,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,sBAAsB,CAC9B,GAAG,SAAS,CAAC,SAAS,KAAK,UAAU,sCAAsC,CAC5E,CAAC;YACJ,CAAC;YACD,MAAM,cAAc,GAAG,MAAM,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC;gBAClD,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC;gBAC5B,CAAC,CAAC,SAAS,CAAC;YACd,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,sBAAsB,CAC9B,GAAG,SAAS,CAAC,SAAS,KAAK,UAAU,wCAAwC,CAC9E,CAAC;YACJ,CAAC;YACD,0EAA0E;YAC1E,qDAAqD;YACrD,OAAO,gBAAgB,CAAC,MAAM,EAAE,CAAC,GAAI,IAAkB,CAAC,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC;AAC7D,CAAC"}

package/dist/host-modules/docx.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@nodetool-ai/sandbox-docx` — the `docx` library, on the host.
+ *
+ * `docx` builds a document out of class instances (`Paragraph`, `TextRun`,
+ * `Table`, …), which the plain-data bridge contract cannot carry across the
+ * guest boundary. The guest instead describes the document as a JSON element
+ * list — the same shape the deleted `lib.docx.*` builder nodes accumulated —
+ * and this module turns that into real docx bytes.
+ */
+import { type GuestBytes } from "../sandbox-bytes.js";
+/**
+ * Build a `.docx` file from a plain-JSON element list.
+ *
+ * `spec.elements` accepts `{type: "heading"|"paragraph"|"table"|"image"|"pageBreak", ...}`
+ * entries — the same shape a Code node accumulates while composing a document
+ * before writing it out.
+ */
+export declare function build(spec: unknown): Promise<GuestBytes>;
+//# sourceMappingURL=docx.d.ts.map

package/dist/host-modules/docx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docx.d.ts","sourceRoot":"","sources":["../../src/host-modules/docx.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAgHpE;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CA+F9D"}

package/dist/host-modules/docx.js

@@ -0,0 +1,120 @@
+/**
+ * `@nodetool-ai/sandbox-docx` — the `docx` library, on the host.
+ *
+ * `docx` builds a document out of class instances (`Paragraph`, `TextRun`,
+ * `Table`, …), which the plain-data bridge contract cannot carry across the
+ * guest boundary. The guest instead describes the document as a JSON element
+ * list — the same shape the deleted `lib.docx.*` builder nodes accumulated —
+ * and this module turns that into real docx bytes.
+ */
+import { toGuestBytes } from "../sandbox-bytes.js";
+import { optionsOf, requireBytes, unwrapLibrary } from "./limits.js";
+import { isFunction } from "../utils/type-guards.js";
+async function loadDocx(where) {
+    const mod = await import("docx");
+    return unwrapLibrary(mod, where, "docx", (v) => isFunction(v?.Document));
+}
+const HEADING_LEVELS = [
+    "HEADING_1",
+    "HEADING_2",
+    "HEADING_3",
+    "HEADING_4",
+    "HEADING_5",
+    "HEADING_6"
+];
+function isElement(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        typeof value.type === "string");
+}
+/**
+ * Build a `.docx` file from a plain-JSON element list.
+ *
+ * `spec.elements` accepts `{type: "heading"|"paragraph"|"table"|"image"|"pageBreak", ...}`
+ * entries — the same shape a Code node accumulates while composing a document
+ * before writing it out.
+ */
+export async function build(spec) {
+    const where = "docx.build";
+    const input = optionsOf(spec);
+    const elements = Array.isArray(input.elements) ? input.elements : [];
+    const docx = await loadDocx(where);
+    const children = elements.map((raw, index) => {
+        if (!isElement(raw)) {
+            throw new Error(`${where}: elements[${index}] is missing a "type"`);
+        }
+        switch (raw.type) {
+            case "heading": {
+                const level = Math.min(6, Math.max(1, Number(raw.level ?? 1)));
+                return new docx.Paragraph({
+                    children: [new docx.TextRun({ text: String(raw.text ?? "") })],
+                    heading: docx.HeadingLevel[HEADING_LEVELS[level - 1]]
+                });
+            }
+            case "paragraph": {
+                const fontSize = Number(raw.fontSize ?? 12);
+                return new docx.Paragraph({
+                    children: [
+                        new docx.TextRun({
+                            text: String(raw.text ?? ""),
+                            bold: Boolean(raw.bold),
+                            italics: Boolean(raw.italic),
+                            size: fontSize * 2 // docx sizes are half-points
+                        })
+                    ],
+                    alignment: docx.AlignmentType[raw.alignment ?? "LEFT"]
+                });
+            }
+            case "table": {
+                const rows = Array.isArray(raw.rows) ? raw.rows : [];
+                return new docx.Table({
+                    rows: rows.map((row) => new docx.TableRow({
+                        children: (Array.isArray(row) ? row : []).map((cell) => new docx.TableCell({
+                            children: [
+                                new docx.Paragraph({
+                                    children: [new docx.TextRun(String(cell ?? ""))]
+                                })
+                            ],
+                            width: { size: 100, type: docx.WidthType.AUTO }
+                        }))
+                    }))
+                });
+            }
+            case "image": {
+                const data = requireBytes(`${where}: elements[${index}]`, raw.data, "data");
+                const width = Number(raw.width ?? 0);
+                const height = Number(raw.height ?? 0);
+                return new docx.Paragraph({
+                    children: [
+                        new docx.ImageRun({
+                            data: Buffer.from(data),
+                            transformation: {
+                                width: width ? width * 96 : 200, // inches to pixels, approx
+                                height: height ? height * 96 : 200
+                            },
+                            type: "buf"
+                        })
+                    ]
+                });
+            }
+            case "pageBreak":
+                return new docx.Paragraph({ children: [new docx.PageBreak()] });
+            default:
+                throw new Error(`${where}: elements[${index}] has unknown type "${raw.type}"`);
+        }
+    });
+    const properties = input.properties ?? {};
+    const documentOptions = { sections: [{ children }] };
+    if (properties.title)
+        documentOptions.title = properties.title;
+    if (properties.author)
+        documentOptions.creator = properties.author;
+    if (properties.subject)
+        documentOptions.subject = properties.subject;
+    if (properties.keywords)
+        documentOptions.keywords = properties.keywords;
+    const document = new docx.Document(documentOptions);
+    const buffer = await docx.Packer.toBuffer(document);
+    return toGuestBytes(buffer instanceof Uint8Array ? buffer : Buffer.from(buffer));
+}
+//# sourceMappingURL=docx.js.map

package/dist/host-modules/docx.js.map

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

package/dist/host-modules/epub.d.ts

@@ -0,0 +1,48 @@
+/**
+ * `@nodetool-ai/sandbox-epub` — epub2, on the host.
+ *
+ * epub2 reads from a file path, not bytes, so this module stages the input in
+ * a temp file for the duration of one call and always removes it afterward.
+ */
+/**
+ * An EPUB's OPF metadata, mirroring the fields epub2 parses out of the package
+ * document. A book may declare further keys; they ride along as strings.
+ */
+interface EpubMetadata {
+    title?: string;
+    creator?: string;
+    creatorFileAs?: string;
+    publisher?: string;
+    language?: string;
+    subject?: string[];
+    description?: string;
+    date?: string;
+    ISBN?: string;
+    UUID?: string;
+    cover?: string;
+    readonly [key: string]: string | string[] | undefined;
+}
+/** One table-of-contents entry, as `tableOfContents` reports it. */
+interface EpubTocItem {
+    id: string | undefined;
+    title: string | undefined;
+    href: string | undefined;
+    order: number | undefined;
+}
+/** One chapter's text, as `extractChapters` reports it. */
+interface EpubChapter {
+    id: string;
+    title: string;
+    href: string;
+    text: string;
+}
+/** An EPUB's metadata: title, creator, language, publisher, and the rest. */
+export declare function metadata(bytes: unknown): Promise<EpubMetadata>;
+/** The table of contents, in reading order. */
+export declare function tableOfContents(bytes: unknown): Promise<EpubTocItem[]>;
+/** All chapters concatenated to plain text, joined by `options.chapterSeparator`. */
+export declare function extractText(bytes: unknown, options?: unknown): Promise<string>;
+/** Each chapter as its own item, with the title the table of contents gives it. */
+export declare function extractChapters(bytes: unknown): Promise<EpubChapter[]>;
+export {};
+//# sourceMappingURL=epub.d.ts.map

package/dist/host-modules/epub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epub.d.ts","sourceRoot":"","sources":["../../src/host-modules/epub.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH;;;GAGG;AACH,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;CACvD;AAED,oEAAoE;AACpE,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,2DAA2D;AAC3D,UAAU,WAAW;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAsED,6EAA6E;AAC7E,wBAAsB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAEpE;AAED,+CAA+C;AAC/C,wBAAsB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAS5E;AAED,qFAAqF;AACrF,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAcpF;AAED,mFAAmF;AACnF,wBAAsB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAqB5E"}

package/dist/host-modules/epub.js

@@ -0,0 +1,100 @@
+/**
+ * `@nodetool-ai/sandbox-epub` — epub2, on the host.
+ *
+ * epub2 reads from a file path, not bytes, so this module stages the input in
+ * a temp file for the duration of one call and always removes it afterward.
+ */
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { optionsOf, requireBytes, unwrapLibrary } from "./limits.js";
+import { isFunction, isString } from "../utils/type-guards.js";
+async function loadEpub2(where) {
+    const mod = await import("epub2");
+    return unwrapLibrary(mod, where, "epub2", (v) => isFunction(v?.EPub?.createAsync));
+}
+function stripHtml(html) {
+    // & must decode last — decoding it first would turn a literal
+    // "&amp;lt;" into "<" instead of the "&lt;" it actually represents.
+    return html
+        .replace(/<style[\s\S]*?<\/style\b[^>]*>/gi, " ")
+        .replace(/<script[\s\S]*?<\/script\b[^>]*>/gi, " ")
+        .replace(/<[^>]+>/g, " ")
+        .replace(/&nbsp;/g, " ")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&amp;/g, "&")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/** Stage `bytes` in a temp file, load it with epub2, and always clean up. */
+async function withEpub(where, bytes, fn) {
+    const buffer = requireBytes(where, bytes);
+    const { EPub } = await loadEpub2(where);
+    const tmp = path.join(os.tmpdir(), `nodetool-sandbox-epub-${Date.now()}-${Math.random().toString(36).slice(2)}.epub`);
+    await fs.writeFile(tmp, buffer);
+    try {
+        const epub = await EPub.createAsync(tmp);
+        return await fn(epub);
+    }
+    finally {
+        await fs.unlink(tmp).catch(() => { });
+    }
+}
+/** An EPUB's metadata: title, creator, language, publisher, and the rest. */
+export async function metadata(bytes) {
+    return withEpub("epub.metadata", bytes, async (epub) => ({ ...epub.metadata }));
+}
+/** The table of contents, in reading order. */
+export async function tableOfContents(bytes) {
+    return withEpub("epub.tableOfContents", bytes, async (epub) => (epub.toc ?? []).map((entry) => ({
+        id: entry.id,
+        title: entry.title,
+        href: entry.href,
+        order: entry.order
+    })));
+}
+/** All chapters concatenated to plain text, joined by `options.chapterSeparator`. */
+export async function extractText(bytes, options) {
+    const opts = optionsOf(options);
+    const separator = isString(opts.chapterSeparator) ? opts.chapterSeparator : "\n\n";
+    return withEpub("epub.extractText", bytes, async (epub) => {
+        const parts = [];
+        for (const item of epub.flow ?? []) {
+            if (!item.id)
+                continue;
+            const html = await epub.getChapterAsync(item.id);
+            const text = stripHtml(html);
+            if (text)
+                parts.push(text);
+        }
+        return parts.join(separator);
+    });
+}
+/** Each chapter as its own item, with the title the table of contents gives it. */
+export async function extractChapters(bytes) {
+    return withEpub("epub.extractChapters", bytes, async (epub) => {
+        const titleById = new Map();
+        for (const entry of epub.toc ?? []) {
+            if (isString(entry.id) && isString(entry.title)) {
+                titleById.set(entry.id, entry.title);
+            }
+        }
+        const chapters = [];
+        for (const item of epub.flow ?? []) {
+            if (!item.id)
+                continue;
+            const html = await epub.getChapterAsync(item.id);
+            chapters.push({
+                id: item.id,
+                title: titleById.get(item.id) ?? "",
+                href: item.href ?? "",
+                text: stripHtml(html)
+            });
+        }
+        return chapters;
+    });
+}
+//# sourceMappingURL=epub.js.map

package/dist/host-modules/epub.js.map

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

package/dist/host-modules/exif.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `@nodetool-ai/sandbox-exif` — exifr, on the host.
+ *
+ * exifr reaches workers and DOM-ish globals the guest probe refuses.
+ * The guest sends image bytes; this module returns a plain tag object.
+ */
+export declare function parse(bytes: unknown): Promise<Record<string, unknown> | null>;
+//# sourceMappingURL=exif.d.ts.map

package/dist/host-modules/exif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exif.d.ts","sourceRoot":"","sources":["../../src/host-modules/exif.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,wBAAsB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAKnF"}

package/dist/host-modules/exif.js

@@ -0,0 +1,19 @@
+/**
+ * `@nodetool-ai/sandbox-exif` — exifr, on the host.
+ *
+ * exifr reaches workers and DOM-ish globals the guest probe refuses.
+ * The guest sends image bytes; this module returns a plain tag object.
+ */
+import { requireBytes, unwrapLibrary } from "./limits.js";
+import { isFunction } from "../utils/type-guards.js";
+async function loadExifr(where) {
+    const mod = await import("exifr");
+    return unwrapLibrary(mod, where, "exifr", (v) => isFunction(v?.parse));
+}
+export async function parse(bytes) {
+    const where = "exif.parse";
+    const exifr = await loadExifr(where);
+    const tags = await exifr.parse(requireBytes(where, bytes));
+    return tags ?? null;
+}
+//# sourceMappingURL=exif.js.map