@nodetool-ai/cli 0.7.0-rc.23 → 0.8.2

package/dist/run-dsl-supervised.js

@@ -0,0 +1,82 @@
+/**
+ * `nodetool run --supervise` — the DSL file path, executed under supervision.
+ *
+ * `@nodetool-ai/dsl`'s own `run()` constructs a `WorkflowRunner` directly: one
+ * of the grandfathered direct-construction sites that must not gain
+ * supervision ad hoc (docs/workflow-supervisor-implementation-plan.md, PR 4).
+ * So a supervised DSL run goes through `ExecutionSession` instead, and an
+ * unsupervised one keeps taking the untouched `runDslFile` path.
+ *
+ * Lives in its own module because it pulls the session facade, the node
+ * registries, and a provider — none of which an unsupervised `nodetool run`
+ * should load.
+ */
+import { getDefaultAssetsPath } from "@nodetool-ai/config";
+import { ExecutionSession } from "@nodetool-ai/execution";
+import { resolveLocalSecret } from "./local-secrets.js";
+import { createGraphNodeTypeResolver } from "@nodetool-ai/node-sdk";
+import { ProcessingContext } from "@nodetool-ai/runtime";
+import { FileStorageAdapter } from "@nodetool-ai/storage";
+import { buildFullRegistry } from "./node-registry.js";
+import { dslWorkflowToGraph, loadDslWorkflows } from "./run-dsl.js";
+import { createSupervisorHandle, printSupervisedSummary, recordSupervisorCost, streamInterventionLines } from "./supervisor.js";
+export async function runDslFileSupervised(filePath, config, jsonMode) {
+    const workflows = await loadDslWorkflows(filePath);
+    const registry = buildFullRegistry();
+    const results = {};
+    const allInterventions = [];
+    for (const [name, workflow] of Object.entries(workflows)) {
+        const jobId = `dsl-${Date.now()}-${name}`;
+        const context = new ProcessingContext({
+            jobId,
+            workflowId: null,
+            userId: "1",
+            secretResolver: resolveLocalSecret,
+            storage: new FileStorageAdapter(getDefaultAssetsPath())
+        });
+        const supervisor = await createSupervisorHandle({ config, context });
+        console.error(`Running ${name} supervised by ${supervisor.providerId}/${supervisor.model}...`);
+        const session = await ExecutionSession.create({
+            graph: dslWorkflowToGraph(workflow),
+            registry,
+            resolveNodeType: createGraphNodeTypeResolver(registry).resolveNodeType,
+            jobId,
+            params: {},
+            context,
+            supervisor: supervisor.handle,
+            captureMessages: true
+        });
+        const lines = streamInterventionLines(session.messages);
+        const result = await session.result;
+        await lines;
+        supervisor.handle.close();
+        const interventions = result.interventions ?? [];
+        allInterventions.push(...interventions);
+        if (interventions.length > 0) {
+            await recordSupervisorCost({
+                interventions,
+                jobId,
+                workflowId: null,
+                userId: "1",
+                providerId: supervisor.providerId,
+                model: supervisor.model
+            });
+            if (!jsonMode)
+                printSupervisedSummary(interventions, console.error);
+        }
+        // A node error the supervisor resolved is not a run failure — unlike the
+        // unsupervised DSL path, which rethrows the first node error it finds.
+        // Only the run's own terminal status decides.
+        if (result.status === "failed") {
+            throw new Error(result.error ?? `Workflow ${name} failed`);
+        }
+        const outputs = {};
+        for (const [outputName, values] of Object.entries(result.outputs)) {
+            if (values.length > 0)
+                outputs[outputName] = values[values.length - 1];
+        }
+        results[name] = outputs;
+    }
+    return { results, interventions: allInterventions };
+}
+//# sourceMappingURL=run-dsl-supervised.js.map

package/dist/run-dsl-supervised.js.map

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

package/dist/run-dsl.d.ts

@@ -7,5 +7,34 @@
  */
 import type { Workflow } from "@nodetool-ai/dsl";
 export declare function isWorkflow(value: unknown): value is Workflow;
+/** Every exported `Workflow` in the file, keyed by export name. */
+export declare function loadDslWorkflows(filePath: string): Promise<Record<string, Workflow>>;
 export declare function runDslFile(filePath: string): Promise<Record<string, Record<string, unknown>>>;
+/**
+ * The graph shape `ExecutionSession` takes, from a DSL workflow. `run()` in
+ * `@nodetool-ai/dsl` builds the same descriptors against its own
+ * `WorkflowRunner`; supervision goes through the session facade instead
+ * (docs/workflow-supervisor-design.md §7), so the mapping is needed here too.
+ */
+export declare function dslWorkflowToGraph(wf: Workflow): {
+    nodes: {
+        id: string;
+        type: string;
+        properties: Record<string, unknown>;
+        dynamic_outputs: Record<string, {
+            type: string;
+            type_args: never[];
+        }> | undefined;
+        output_correlation: Record<string, import("@nodetool-ai/protocol").OutputCorrelation> | undefined;
+        input_mode: import("@nodetool-ai/protocol").InputMode | undefined;
+        is_streaming_output: boolean;
+        is_streaming_input: boolean;
+    }[];
+    edges: {
+        source: string;
+        sourceHandle: string;
+        target: string;
+        targetHandle: string;
+    }[];
+};
 //# sourceMappingURL=run-dsl.d.ts.map

package/dist/run-dsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-dsl.d.ts","sourceRoot":"","sources":["../src/run-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGjD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAO5D;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAqBlD"}
+{"version":3,"file":"run-dsl.d.ts","sourceRoot":"","sources":["../src/run-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAIjD,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAO5D;AAED,mEAAmE;AACnE,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAgBnC;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAOlD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ;IAE3C,KAAK;;;;;;;;;;;;;IAUL,KAAK;;;;;;EAOR"}

package/dist/run-dsl.js

@@ -7,25 +7,59 @@
  */
 import { run as runWorkflow } from "@nodetool-ai/dsl";
 import { tsImport } from "tsx/esm/api";
+import { pathToFileURL } from "node:url";
 export function isWorkflow(value) {
-    return (typeof value === "object" &&
+    return ((typeof value === "object" || typeof value === "function") &&
         value !== null &&
         Array.isArray(value.nodes) &&
         Array.isArray(value.edges));
 }
-export async function runDslFile(filePath) {
-    const mod = (await tsImport(filePath, import.meta.url));
-    const results = {};
-    let found = false;
+/** Every exported `Workflow` in the file, keyed by export name. */
+export async function loadDslWorkflows(filePath) {
+    const moduleUrl = pathToFileURL(filePath).href;
+    const mod = (await tsImport(moduleUrl, import.meta.url));
+    const workflows = {};
     for (const [name, value] of Object.entries(mod)) {
-        if (isWorkflow(value)) {
-            found = true;
-            results[name] = await runWorkflow(value);
-        }
+        if (isWorkflow(value))
+            workflows[name] = value;
     }
-    if (!found) {
+    if (Object.keys(workflows).length === 0) {
         throw new Error(`No Workflow exports found in ${filePath}`);
     }
+    return workflows;
+}
+export async function runDslFile(filePath) {
+    const workflows = await loadDslWorkflows(filePath);
+    const results = {};
+    for (const [name, wf] of Object.entries(workflows)) {
+        results[name] = await runWorkflow(wf);
+    }
     return results;
 }
+/**
+ * The graph shape `ExecutionSession` takes, from a DSL workflow. `run()` in
+ * `@nodetool-ai/dsl` builds the same descriptors against its own
+ * `WorkflowRunner`; supervision goes through the session facade instead
+ * (docs/workflow-supervisor-design.md §7), so the mapping is needed here too.
+ */
+export function dslWorkflowToGraph(wf) {
+    return {
+        nodes: wf.nodes.map((n) => ({
+            id: n.id,
+            type: n.type,
+            properties: n.data,
+            dynamic_outputs: n.dynamic_outputs,
+            output_correlation: n.output_correlation,
+            input_mode: n.input_mode,
+            is_streaming_output: n.streaming,
+            is_streaming_input: n.streamingInput
+        })),
+        edges: wf.edges.map((e) => ({
+            source: e.source,
+            sourceHandle: e.sourceHandle,
+            target: e.target,
+            targetHandle: e.targetHandle
+        }))
+    };
+}
 //# sourceMappingURL=run-dsl.js.map

package/dist/run-dsl.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-dsl.js","sourceRoot":"","sources":["../src/run-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAE,KAAiC,CAAC,KAAK,CAAC;QACvD,KAAK,CAAC,OAAO,CAAE,KAAiC,CAAC,KAAK,CAAC,CACxD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB;IAEhB,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAGrD,CAAC;IAEF,MAAM,OAAO,GAA4C,EAAE,CAAC;IAC5D,IAAI,KAAK,GAAG,KAAK,CAAC;IAElB,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"run-dsl.js","sourceRoot":"","sources":["../src/run-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,CACL,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QAC1D,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,OAAO,CAAE,KAAiC,CAAC,KAAK,CAAC;QACvD,KAAK,CAAC,OAAO,CAAE,KAAiC,CAAC,KAAK,CAAC,CACxD,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB;IAEhB,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;IAC/C,MAAM,GAAG,GAAG,CAAC,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAGtD,CAAC;IAEF,MAAM,SAAS,GAA6B,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,UAAU,CAAC,KAAK,CAAC;YAAE,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACjD,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB;IAEhB,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,OAAO,GAA4C,EAAE,CAAC;IAC5D,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAY;IAC7C,OAAO;QACL,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,UAAU,EAAE,CAAC,CAAC,IAAI;YAClB,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,kBAAkB,EAAE,CAAC,CAAC,kBAAkB;YACxC,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,mBAAmB,EAAE,CAAC,CAAC,SAAS;YAChC,kBAAkB,EAAE,CAAC,CAAC,cAAc;SACrC,CAAC,CAAC;QACH,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,YAAY,EAAE,CAAC,CAAC,YAAY;SAC7B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/run-json.d.ts

@@ -0,0 +1,24 @@
+export interface RunJsonOptions {
+    /**
+     * Where oversized payloads are written, created on the first spill. Callers
+     * with a run id should scope this per run so a later run does not overwrite
+     * files the printed JSON still points at.
+     */
+    outputDir?: string;
+    /** Binary payloads of at least this many bytes go to disk instead. */
+    maxInlineBytes?: number;
+}
+/** The JSON text for a run result, plus every payload file it points at. */
+export declare function formatRunJson(value: unknown, opts?: RunJsonOptions): Promise<{
+    json: string;
+    files: string[];
+}>;
+/** Print a run result as JSON, noting on stderr where any payloads landed. */
+export declare function printRunJson(value: unknown, opts?: RunJsonOptions): Promise<void>;
+/**
+ * One-line rendering of a value for the human-readable output. Byte arrays are
+ * described rather than expanded, so a 4 MB frame does not cost tens of
+ * megabytes of text on its way to being truncated to `maxChars`.
+ */
+export declare function previewJson(value: unknown, maxChars?: number): string;
+//# sourceMappingURL=run-json.d.ts.map

package/dist/run-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-json.d.ts","sourceRoot":"","sources":["../src/run-json.ts"],"names":[],"mappings":"AAiCA,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA2FD,4EAA4E;AAC5E,wBAAsB,aAAa,CACjC,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAmB5C;AAED,8EAA8E;AAC9E,wBAAsB,YAAY,CAChC,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CASrE"}

package/dist/run-json.js

@@ -0,0 +1,132 @@
+/**
+ * JSON reporting for a finished run.
+ *
+ * A run that reaches here has already executed and been paid for, so reporting
+ * must not be able to fail it. Two things sit between a run result and a JSON
+ * string. GPU image nodes emit raw-RGBA bytes as their in-flight format so
+ * chained shader ops skip the codec, and every boundary that hands out a
+ * portable image encodes them first (`packages/runtime/src/image-codec.ts`) —
+ * this is that boundary for the CLI. And three 1024² frames in one
+ * `JSON.stringify(…, null, 2)` exceed what a single JS string can hold.
+ *
+ * So binary payloads at or over `maxInlineBytes` are written next to the run
+ * and replaced by a `$file` pointer, and a stringify that still overflows
+ * degrades to a summary instead of throwing.
+ */
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { isRawRgbaImage } from "@nodetool-ai/protocol";
+import { encodeRawImageRef } from "@nodetool-ai/runtime";
+import { isFunctionValue, isObjectLike, isRecord, isString } from "./predicates.js";
+/**
+ * Above this many bytes a payload is written to disk. A byte array in JSON is
+ * one number per byte, so even a modest buffer costs megabytes of text and is
+ * unusable to whatever reads it.
+ */
+const DEFAULT_MAX_INLINE_BYTES = 64 * 1024;
+/** The file extension for `mimeType`, or `bin` when it names nothing usable. */
+function extensionFor(mimeType) {
+    const subtype = mimeType?.split("/")[1]?.split(";")[0]?.replace(/\+.*$/, "");
+    return subtype && /^[a-z0-9.-]+$/i.test(subtype) ? subtype : "bin";
+}
+function writeBinary(data, mimeType, spill) {
+    if (spill.files.length === 0) {
+        mkdirSync(spill.dir, { recursive: true });
+    }
+    const file = join(spill.dir, `payload-${spill.files.length}.${extensionFor(mimeType)}`);
+    writeFileSync(file, data);
+    spill.files.push(file);
+    const pointer = { $file: file, bytes: data.byteLength };
+    if (mimeType) {
+        pointer.mimeType = mimeType;
+    }
+    return pointer;
+}
+async function encodeImage(ref) {
+    try {
+        const encoded = await encodeRawImageRef(ref);
+        return isObjectLike(encoded) ? encoded : ref;
+    }
+    catch {
+        // No codec on this install (sharp missing). Keep the raw ref: its bytes
+        // still spill to disk below rather than being dropped.
+        return ref;
+    }
+}
+/**
+ * Walk `value`, PNG-encoding raw-RGBA images and spilling large binaries.
+ * `mimeType` is the one declared by the nearest enclosing object, so a ref's
+ * `data` is named by its own `mimeType`.
+ */
+async function prepare(value, mimeType, spill) {
+    if (value instanceof Uint8Array) {
+        return value.byteLength >= spill.limit
+            ? writeBinary(value, mimeType, spill)
+            : value;
+    }
+    if (Array.isArray(value)) {
+        return Promise.all(value.map((item) => prepare(item, mimeType, spill)));
+    }
+    if (!isObjectLike(value)) {
+        return value;
+    }
+    // A value with its own serializer (a `Date`, say) decides its own JSON.
+    // Decomposing it into own enumerable properties turns a timestamp into `{}`.
+    if (isFunctionValue(value.toJSON)) {
+        return value;
+    }
+    const record = isRawRgbaImage(value) ? await encodeImage(value) : value;
+    const childMime = isString(record.mimeType) ? record.mimeType : mimeType;
+    const out = {};
+    for (const [key, item] of Object.entries(record)) {
+        out[key] = await prepare(item, childMime, spill);
+    }
+    return out;
+}
+/** The JSON text for a run result, plus every payload file it points at. */
+export async function formatRunJson(value, opts = {}) {
+    const spill = {
+        dir: opts.outputDir ?? resolve(process.cwd(), "nodetool-output"),
+        limit: opts.maxInlineBytes ?? DEFAULT_MAX_INLINE_BYTES,
+        files: []
+    };
+    try {
+        const prepared = await prepare(value, undefined, spill);
+        return { json: JSON.stringify(prepared, null, 2), files: spill.files };
+    }
+    catch (e) {
+        // Whatever went wrong here, the run itself is done. Report the failure as
+        // JSON on the JSON channel instead of raising it over a finished run.
+        const summary = {
+            error: `Result could not be serialized as JSON: ${String(e)}`,
+            keys: isRecord(value) ? Object.keys(value) : [],
+            files: spill.files
+        };
+        return { json: JSON.stringify(summary, null, 2), files: spill.files };
+    }
+}
+/** Print a run result as JSON, noting on stderr where any payloads landed. */
+export async function printRunJson(value, opts = {}) {
+    const { json, files } = await formatRunJson(value, opts);
+    console.log(json);
+    const first = files[0];
+    if (first) {
+        console.error(`Wrote ${files.length} payload file(s) to ${dirname(first)}`);
+    }
+}
+/**
+ * One-line rendering of a value for the human-readable output. Byte arrays are
+ * described rather than expanded, so a 4 MB frame does not cost tens of
+ * megabytes of text on its way to being truncated to `maxChars`.
+ */
+export function previewJson(value, maxChars) {
+    // `JSON.stringify` is typed `string` but returns undefined for an undefined
+    // or non-serializable root.
+    const text = JSON.stringify(value, (_key, item) => item instanceof Uint8Array ? `<${item.byteLength} bytes>` : item);
+    if (text === undefined)
+        return "undefined";
+    if (maxChars === undefined || text.length <= maxChars)
+        return text;
+    return `${text.slice(0, maxChars)}…`;
+}
+//# sourceMappingURL=run-json.js.map

package/dist/run-json.js.map

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

package/dist/sandbox-catalog.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Discover installed sandbox packs and make the catalog this process's default,
+ * so the CLI's validation and execution harnesses resolve sandbox modules
+ * through the same instance the server uses. Discovery executes no pack code.
+ * A failure leaves the CLI without a catalog rather than without a registry.
+ *
+ * This path never compiles. npm-backed modules resolve only from the cache,
+ * whose entries are re-verified against their inputs' current contents; a miss
+ * becomes the `pending-compile` diagnostic naming `nodetool packs compile`.
+ */
+export declare function installSandboxCatalog(): void;
+/**
+ * `specifier -> absolute path to that installed pack's shipped .d.ts`, read
+ * from each discovered pack's own `package.json` `types` field (a pack ships
+ * none by declaring no `types` field, which this simply leaves out). Used by
+ * `jsscript validate` to type-check a script's imports against the packs it
+ * actually has installed — see `@nodetool-ai/execution`'s `type-check.ts`.
+ * Runs discovery again rather than threading it through
+ * {@link installSandboxCatalog}, which only keeps the catalog; this stays a
+ * separate, cheap, synchronous call so a caller that does not need types
+ * pays nothing for them.
+ */
+export declare function discoverPackDtsSources(): ReadonlyMap<string, string>;
+//# sourceMappingURL=sandbox-catalog.d.ts.map

package/dist/sandbox-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-catalog.d.ts","sourceRoot":"","sources":["../src/sandbox-catalog.ts"],"names":[],"mappings":"AA6BA;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAa5C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAepE"}

package/dist/sandbox-catalog.js

@@ -0,0 +1,78 @@
+/**
+ * The CLI's sandbox pack catalog, apart from the node registry so a harness
+ * that runs sandbox code without node types does not load every node package.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { discoverSandboxCatalog } from "@nodetool-ai/node-sdk";
+import { setProcessSandboxModuleCatalog } from "@nodetool-ai/runtime";
+import { createCachedNpmLookup } from "@nodetool-ai/sandbox-compiler/cache";
+import { z } from "zod";
+/** The one field this module reads off a pack's `package.json`; everything else in the file is irrelevant here. */
+const packageJsonTypesField = z
+    .object({ types: z.string().trim().min(1).optional() })
+    .passthrough();
+/** The pack's declared `types` path, or `undefined` for any reason — missing file, invalid JSON, no `types` field. Never throws. */
+function readPackageJsonTypesField(packageJsonPath) {
+    if (!existsSync(packageJsonPath))
+        return undefined;
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+    const parsed = packageJsonTypesField.safeParse(raw);
+    return parsed.success ? parsed.data.types : undefined;
+}
+/**
+ * Discover installed sandbox packs and make the catalog this process's default,
+ * so the CLI's validation and execution harnesses resolve sandbox modules
+ * through the same instance the server uses. Discovery executes no pack code.
+ * A failure leaves the CLI without a catalog rather than without a registry.
+ *
+ * This path never compiles. npm-backed modules resolve only from the cache,
+ * whose entries are re-verified against their inputs' current contents; a miss
+ * becomes the `pending-compile` diagnostic naming `nodetool packs compile`.
+ */
+export function installSandboxCatalog() {
+    try {
+        setProcessSandboxModuleCatalog(discoverSandboxCatalog(undefined, { compiled: createCachedNpmLookup() })
+            .catalog);
+    }
+    catch (error) {
+        console.warn(`Sandbox module catalog unavailable: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * `specifier -> absolute path to that installed pack's shipped .d.ts`, read
+ * from each discovered pack's own `package.json` `types` field (a pack ships
+ * none by declaring no `types` field, which this simply leaves out). Used by
+ * `jsscript validate` to type-check a script's imports against the packs it
+ * actually has installed — see `@nodetool-ai/execution`'s `type-check.ts`.
+ * Runs discovery again rather than threading it through
+ * {@link installSandboxCatalog}, which only keeps the catalog; this stays a
+ * separate, cheap, synchronous call so a caller that does not need types
+ * pays nothing for them.
+ */
+export function discoverPackDtsSources() {
+    const sources = new Map();
+    try {
+        const { discoveries } = discoverSandboxCatalog();
+        for (const discovery of discoveries) {
+            const types = readPackageJsonTypesField(join(discovery.dir, "package.json"));
+            if (types === undefined)
+                continue;
+            const dtsPath = join(discovery.dir, types);
+            if (existsSync(dtsPath))
+                sources.set(discovery.name, dtsPath);
+        }
+    }
+    catch {
+        // Discovery failure here is the same non-fatal case installSandboxCatalog
+        // already warns about; a caller that wants types simply gets none.
+    }
+    return sources;
+}
+//# sourceMappingURL=sandbox-catalog.js.map

package/dist/sandbox-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-catalog.js","sourceRoot":"","sources":["../src/sandbox-catalog.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,mHAAmH;AACnH,MAAM,qBAAqB,GAAG,CAAC;KAC5B,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;KACtD,WAAW,EAAE,CAAC;AAEjB,oIAAoI;AACpI,SAAS,yBAAyB,CAAC,eAAuB;IACxD,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB;IACnC,IAAI,CAAC;QACH,8BAA8B,CAC5B,sBAAsB,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,qBAAqB,EAAE,EAAE,CAAC;aACrE,OAAO,CACX,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CACV,uCACE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,GAAG,sBAAsB,EAAE,CAAC;QACjD,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;YAC7E,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,UAAU,CAAC,OAAO,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0EAA0E;QAC1E,mEAAmE;IACrE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/settings.d.ts

@@ -1,18 +1,19 @@
-export interface ChatSettings {
+interface ChatSettings {
     provider: string;
     model: string;
-    agentMode: boolean;
-    /**
-     * Which planner to use when agent mode is on:
-     * - "graph" — GraphPlanner builds a workflow graph (default; uses
-     *   `nodetool.*` core nodes plus the `find_model` tool).
-     * - "multi" — TaskPlanner builds a parallel task DAG of LLM steps.
-     */
-    agentPlanner: "multi" | "graph";
     enabledTools: string[];
-    workspace: string;
 }
+/**
+ * Tools the chat turn is broken without, added to a settings file that predates
+ * them. The `nodetool.*` object model documents these namespaces, so a belt
+ * missing one turns a documented call into "tool not in this toolbelt" —
+ * which is what `nodetool.models.pick()` did until `find_model` landed here.
+ * They need no credential of their own: each resolves its provider from the
+ * model it is handed, or reports that none is configured.
+ */
+export declare const ALWAYS_ENABLED_TOOLS: readonly string[];
 export declare const DEFAULT_SETTINGS: ChatSettings;
 export declare function loadSettings(): Promise<ChatSettings>;
 export declare function saveSettings(settings: Partial<ChatSettings>): Promise<void>;
+export {};
 //# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,YAAY,EAAE,OAAO,GAAG,OAAO,CAAC;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,gBAAgB,EAAE,YAsC9B,CAAC;AA0BF,wBAAsB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAO1D;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAWf"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAIA,UAAU,YAAY;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAyCjD,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,YAiC9B,CAAC;AA4CF,wBAAsB,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,CAQ1D;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAWf"}