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

package/dist/js-script-debug/harness.d.ts

@@ -0,0 +1,124 @@
+import type { JsScriptDebugReport, JsScriptInteractionRecord, JsScriptValidation } from "@nodetool-ai/execution/js-script-debug";
+import type { JsScriptBridgeFinalState } from "@nodetool-ai/agents";
+import type { JsScriptDocument } from "@nodetool-ai/protocol/api-schemas/js-scripts.js";
+import type { JsScriptInteractionStep } from "./interactions.js";
+import { type ResolvedJsScriptTarget, type JsScriptTargetDeps } from "./target.js";
+/** What one sandboxed run reports. Mirrors the agents `HarnessRunResult`. */
+export interface JsScriptRunResult {
+    ok: boolean;
+    outputs?: Record<string, unknown>;
+    streamed?: unknown[];
+    logs: string[];
+    error?: string;
+    duration_ms: number;
+}
+/** One graded case, as `test_code`/`test_js_script` report it. */
+export interface JsScriptCaseResult {
+    name: string;
+    ok: boolean;
+    outputs?: Record<string, unknown>;
+    streamed?: unknown[];
+    logs: string[];
+    error?: string;
+    mismatches: {
+        output: string;
+        expected: unknown;
+        actual: unknown;
+    }[];
+}
+export interface JsScriptTestReport {
+    ok: boolean;
+    passed: number;
+    failed: number;
+    results: JsScriptCaseResult[];
+}
+/** The pieces of the shared core this host calls. */
+export interface JsScriptDebugCore {
+    validateJsScriptDoc: (raw: unknown, options?: {
+        knownSecrets?: readonly string[];
+        packDtsSources?: ReadonlyMap<string, string>;
+    }) => Promise<JsScriptValidation>;
+    buildJsScriptDebugReport: (input: {
+        target: JsScriptDebugReport["target"];
+        document: unknown;
+        interactions?: JsScriptInteractionRecord[];
+        finalState?: unknown;
+        finalDocument?: unknown;
+    }) => Promise<JsScriptDebugReport>;
+    renderJsScriptReportMarkdown: (report: JsScriptDebugReport) => string;
+}
+/** Executes a script body in the sandbox. */
+export type JsScriptExecutor = (document: JsScriptDocument, inputs: Record<string, unknown>, inputStreams?: Record<string, unknown[]>, 
+/**
+ * The script's own row id, for a target loaded from the database. Seeds
+ * the run's context with the same call-chain key `run_js_script` sets
+ * (`JS_SCRIPT_CHAIN_KEY`, via `enterJsScript`), so a body that runs
+ * another JS script sees this run in the chain the same way it would
+ * through the capability path — a cycle or the depth cap is refused the
+ * same way. Absent for a file target, which has no row to chain from.
+ */
+scriptId?: string) => Promise<JsScriptRunResult>;
+/** The bridge surface this host drives — one tool per `ui_jsscript_*` name. */
+export interface JsScriptBridgeTool {
+    name: string;
+    /**
+     * HOLDOUT (anti-slop/no-unknown-returns): a `ui_jsscript_*` tool answers in
+     * the open tool-result domain, and the bridge that implements this lives in
+     * `@nodetool-ai/agents`.
+     */
+    execute: (args: Record<string, unknown>) => Promise<unknown>;
+}
+export interface JsScriptBridge {
+    tools: JsScriptBridgeTool[];
+    document: () => JsScriptDocument;
+    finalState: () => JsScriptBridgeFinalState;
+}
+export type CreateJsScriptBridge = (initial: {
+    name?: string;
+    document?: Partial<JsScriptDocument>;
+}) => JsScriptBridge;
+export interface JsScriptDebugDeps extends JsScriptTargetDeps {
+    /** Defaults to `@nodetool-ai/execution/js-script-debug`. */
+    core?: JsScriptDebugCore;
+    /** Defaults to `runCodeBody` from `@nodetool-ai/agents`. */
+    execute?: JsScriptExecutor;
+    /** Defaults to `createJsScriptToolBridge` from `@nodetool-ai/agents`. */
+    createBridge?: CreateJsScriptBridge;
+    /** Grades saved cases; defaults to `gradeCodeCases` from `@nodetool-ai/agents`. */
+    grade?: (document: JsScriptDocument, execute: JsScriptExecutor) => Promise<JsScriptTestReport>;
+    onLog?: (line: string) => void;
+}
+export interface JsScriptValidateResult {
+    target: ResolvedJsScriptTarget["target"];
+    validation: JsScriptValidation;
+}
+export interface JsScriptDebugResult {
+    report: JsScriptDebugReport;
+    bundleDir: string;
+}
+/** Load a script and validate it — no sandbox, no bundle. */
+export declare function runJsScriptValidate(ref: string, deps: JsScriptDebugDeps): Promise<JsScriptValidateResult>;
+export interface JsScriptRunOutcome {
+    target: ResolvedJsScriptTarget["target"];
+    result: JsScriptRunResult;
+}
+/** Run a script once with the given inputs. */
+export declare function runJsScriptOnce(ref: string, inputs: Record<string, unknown>, deps: JsScriptDebugDeps, inputStreams?: Record<string, unknown[]>): Promise<JsScriptRunOutcome>;
+export interface JsScriptTestOutcome {
+    target: ResolvedJsScriptTarget["target"];
+    report: JsScriptTestReport;
+}
+/** Run a script's saved cases and grade them. */
+export declare function runJsScriptTests(ref: string, deps: JsScriptDebugDeps): Promise<JsScriptTestOutcome>;
+/**
+ * Replay `--interact` against the headless bridge and write the bundle.
+ *
+ * A failing step is recorded and the script continues: a run that stops at the
+ * first error hides every problem behind it, and the report is what the caller
+ * came for.
+ */
+export declare function runJsScriptDebug(ref: string, options: {
+    interact?: JsScriptInteractionStep[];
+    outDir?: string;
+}, deps: JsScriptDebugDeps): Promise<JsScriptDebugResult>;
+//# sourceMappingURL=harness.d.ts.map

package/dist/js-script-debug/harness.d.ts.map

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

package/dist/js-script-debug/harness.js

@@ -0,0 +1,230 @@
+/**
+ * The JS-script harness: the CLI host around the shared validator and the
+ * sandbox.
+ *
+ * `runJsScriptValidate` is the cheap pre-flight — load a document, check it,
+ * report. `runJsScriptRun` and `runJsScriptTest` execute the body through
+ * `runCodeBody`, the same core the `run_js_script` capability and the run
+ * endpoint use. `runJsScriptDebug` additionally replays a scripted session
+ * against the headless `ui_jsscript_*` bridge (the one the tool-loop eval
+ * drives), validates the document the session left behind, and writes a
+ * self-contained bundle.
+ *
+ * Everything heavy is injected with a lazy default: the validator core
+ * (`@nodetool-ai/execution/js-script-debug`), the sandbox runner and the bridge
+ * factory (`@nodetool-ai/agents`). Tests supply their own and load neither.
+ */
+import { mkdir, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { runInteractionSteps } from "../interaction-script.js";
+import { resolveJsScriptTarget } from "./target.js";
+async function loadCore() {
+    const core = await import("@nodetool-ai/execution/js-script-debug");
+    return {
+        validateJsScriptDoc: (raw, options) => core.validateJsScriptDoc(raw, options),
+        buildJsScriptDebugReport: (input) => core.buildJsScriptDebugReport(input),
+        renderJsScriptReportMarkdown: (report) => core.renderJsScriptReportMarkdown(report)
+    };
+}
+/**
+ * The default executor: one `ProcessingContext` per run, the document's own
+ * packages, secrets and timeout, and the Code-node toolbelt — the same
+ * envelope the `run_js_script` capability applies.
+ *
+ * The secret store is opened only when the document declares secrets, so a
+ * file target with none stays database-free.
+ */
+async function loadExecutor() {
+    const { runCodeBody } = await import("@nodetool-ai/agents");
+    const { PERMISSION_GATE_CONTEXT_KEY, ProcessingContext, headlessGate } = await import("@nodetool-ai/runtime");
+    const { FileStorageAdapter } = await import("@nodetool-ai/storage");
+    const { getDefaultAssetsPath } = await import("@nodetool-ai/config");
+    const { JS_SCRIPT_MAX_TIMEOUT_SECONDS } = await import("@nodetool-ai/protocol/api-schemas/js-scripts.js");
+    // The toolbelt's `nodetool.*` modules read and write the database, so a
+    // body that saves a timeline needs it even when it declares no secrets.
+    const { initDb, getSecret } = await import("@nodetool-ai/models");
+    const { getDefaultDbPath } = await import("@nodetool-ai/config");
+    initDb(getDefaultDbPath());
+    // A body imports installed sandbox packs by name, as it does on the server.
+    const { installSandboxCatalog } = await import("../sandbox-catalog.js");
+    installSandboxCatalog();
+    let seq = 0;
+    return async (document, inputs, inputStreams, scriptId) => {
+        let secretResolver;
+        if (document.secrets.length > 0) {
+            secretResolver = getSecret;
+        }
+        const contextInit = {
+            jobId: `jsscript-cli-${++seq}`,
+            userId: "1",
+            storage: new FileStorageAdapter(getDefaultAssetsPath())
+        };
+        if (secretResolver) {
+            contextInit.secretResolver = secretResolver;
+        }
+        const context = new ProcessingContext(contextInit);
+        context.set(PERMISSION_GATE_CONTEXT_KEY, headlessGate("JS script debug"));
+        if (scriptId) {
+            // Mirrors `enterJsScript` in the `run_js_script` capability: the same
+            // chain key, so a script this run invokes sees this CLI run as part
+            // of the call chain the way it would through the capability path.
+            const { JS_SCRIPT_CHAIN_KEY } = await import("@nodetool-ai/agents");
+            context.set(JS_SCRIPT_CHAIN_KEY, [scriptId]);
+        }
+        const runOptions = {
+            code: document.code,
+            inputs,
+            secrets: document.secrets,
+            timeoutSeconds: Math.min(document.timeoutSeconds, JS_SCRIPT_MAX_TIMEOUT_SECONDS),
+            withToolbelt: true
+        };
+        if (inputStreams) {
+            runOptions.inputStreams = inputStreams;
+        }
+        return runCodeBody(context, runOptions);
+    };
+}
+async function loadGrader() {
+    const { gradeCodeCases } = await import("@nodetool-ai/agents");
+    return async (document, execute) => {
+        const report = await gradeCodeCases(document.tests.map((testCase, index) => {
+            const graded = {
+                name: testCase.name.trim() !== "" ? testCase.name : `case ${index + 1}`,
+                inputs: testCase.inputs ?? {}
+            };
+            if (testCase.inputStreams) {
+                graded.inputStreams = testCase.inputStreams;
+            }
+            if (testCase.expect) {
+                graded.expect = testCase.expect;
+            }
+            if (testCase.expectedStreamed) {
+                graded.expectedStreamed = testCase.expectedStreamed;
+            }
+            return graded;
+        }), (testCase) => execute(document, testCase.inputs, testCase.inputStreams));
+        return report;
+    };
+}
+async function loadBridgeFactory() {
+    const { createJsScriptToolBridge } = await import("@nodetool-ai/agents");
+    return (initial) => 
+    // SAFETY: the eval-surface bridge in @nodetool-ai/agents implements this
+    // exact tool list and snapshot — it is the bridge this type describes. The
+    // two packages declare the script document types independently, and that
+    // duplication is the only reason the structures do not line up.
+    createJsScriptToolBridge(initial);
+}
+function defaultOutDir(ref) {
+    const slug = ref
+        .replace(/[^a-zA-Z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40) || "jsscript";
+    const stamp = new Date().toISOString().replace(/[:.]/g, "-");
+    return resolve(`nodetool-debug/jsscript-${slug}-${stamp}`);
+}
+/**
+ * The document a target carries, parsed against the schema so the executor
+ * gets defaults for anything the file left out. A document that does not parse
+ * has already been reported by validation, so this is only reached on a sound
+ * one.
+ */
+async function asDocument(raw) {
+    const { jsScriptDocument } = await import("@nodetool-ai/protocol/api-schemas/js-scripts.js");
+    const parsed = jsScriptDocument.safeParse(raw);
+    if (!parsed.success) {
+        throw new Error(`The document does not parse: ${parsed.error.issues
+            .map((issue) => `${issue.path.join(".") || "document"}: ${issue.message}`)
+            .join("; ")}`);
+    }
+    return parsed.data;
+}
+/** Load a script and validate it — no sandbox, no bundle. */
+export async function runJsScriptValidate(ref, deps) {
+    const resolved = await resolveJsScriptTarget(ref, deps);
+    const core = deps.core ?? (await loadCore());
+    const { discoverPackDtsSources } = await import("../sandbox-catalog.js");
+    const validation = await core.validateJsScriptDoc(resolved.raw, {
+        packDtsSources: discoverPackDtsSources()
+    });
+    return { target: resolved.target, validation };
+}
+/** Run a script once with the given inputs. */
+export async function runJsScriptOnce(ref, inputs, deps, inputStreams) {
+    const resolved = await resolveJsScriptTarget(ref, deps);
+    const document = await asDocument(resolved.raw);
+    if (inputStreams) {
+        const declared = new Set(document.inputs.map((port) => port.name));
+        const undeclared = Object.keys(inputStreams).filter((handle) => !declared.has(handle));
+        if (undeclared.length > 0) {
+            throw new Error(`--input-streams names ${undeclared.join(", ")}, which the script does ` +
+                `not declare as inputs (declared: ${[...declared].join(", ") || "none"}).`);
+        }
+    }
+    const execute = deps.execute ?? (await loadExecutor());
+    const scriptId = resolved.target.kind === "id" ? resolved.target.ref : undefined;
+    return {
+        target: resolved.target,
+        result: await execute(document, inputs, inputStreams, scriptId)
+    };
+}
+/** Run a script's saved cases and grade them. */
+export async function runJsScriptTests(ref, deps) {
+    const resolved = await resolveJsScriptTarget(ref, deps);
+    const document = await asDocument(resolved.raw);
+    if (document.tests.length === 0) {
+        throw new Error(`${ref} has no saved test cases; there is nothing to run. Add some to the document's \`tests\`.`);
+    }
+    const execute = deps.execute ?? (await loadExecutor());
+    const grade = deps.grade ?? (await loadGrader());
+    return { target: resolved.target, report: await grade(document, execute) };
+}
+/**
+ * Replay `--interact` against the headless bridge and write the bundle.
+ *
+ * A failing step is recorded and the script continues: a run that stops at the
+ * first error hides every problem behind it, and the report is what the caller
+ * came for.
+ */
+export async function runJsScriptDebug(ref, options, deps) {
+    const resolved = await resolveJsScriptTarget(ref, deps);
+    const core = deps.core ?? (await loadCore());
+    const steps = options.interact ?? [];
+    const interactions = [];
+    let snapshot;
+    let finalDocument;
+    if (steps.length > 0) {
+        const createBridge = deps.createBridge ?? (await loadBridgeFactory());
+        const bridgeInit = {
+            document: await asDocument(resolved.raw)
+        };
+        if (resolved.target.name) {
+            bridgeInit.name = resolved.target.name;
+        }
+        const bridge = createBridge(bridgeInit);
+        interactions.push(...(await runInteractionSteps(steps, bridge.tools, "JS script", deps.onLog)));
+        snapshot = bridge.finalState();
+        finalDocument = bridge.document();
+    }
+    const reportInput = {
+        target: resolved.target,
+        document: resolved.raw,
+        interactions
+    };
+    if (snapshot !== undefined) {
+        reportInput.finalState = snapshot;
+    }
+    if (finalDocument !== undefined) {
+        reportInput.finalDocument = finalDocument;
+    }
+    const report = await core.buildJsScriptDebugReport(reportInput);
+    const bundleDir = options.outDir
+        ? resolve(options.outDir)
+        : defaultOutDir(ref);
+    await mkdir(bundleDir, { recursive: true });
+    await writeFile(join(bundleDir, "jsscript.json"), JSON.stringify(resolved.raw, null, 2), "utf8");
+    await writeFile(join(bundleDir, "report.json"), JSON.stringify(report, null, 2), "utf8");
+    await writeFile(join(bundleDir, "report.md"), core.renderJsScriptReportMarkdown(report), "utf8");
+    return { report, bundleDir };
+}
+//# sourceMappingURL=harness.js.map

package/dist/js-script-debug/harness.js.map

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

package/dist/js-script-debug/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The CLI host for the JS-script harness: target resolution, the `--interact`
+ * script, sandbox execution, and the bundle writer. The rules themselves live
+ * in `@nodetool-ai/execution/js-script-debug`.
+ */
+export { runJsScriptValidate, runJsScriptOnce, runJsScriptTests, runJsScriptDebug, type CreateJsScriptBridge, type JsScriptBridge, type JsScriptBridgeTool, type JsScriptCaseResult, type JsScriptDebugCore, type JsScriptDebugDeps, type JsScriptDebugResult, type JsScriptExecutor, type JsScriptRunOutcome, type JsScriptRunResult, type JsScriptTestOutcome, type JsScriptTestReport, type JsScriptValidateResult } from "./harness.js";
+export { normalizeToolName, parseInteractionScript, type JsScriptInteractionStep } from "./interactions.js";
+export { resolveJsScriptTarget, type JsScriptRecord, type JsScriptTargetDeps, type ResolvedJsScriptTarget } from "./target.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/js-script-debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/js-script-debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,uBAAuB,EAC7B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC5B,MAAM,aAAa,CAAC"}

package/dist/js-script-debug/index.js

@@ -0,0 +1,9 @@
+/**
+ * The CLI host for the JS-script harness: target resolution, the `--interact`
+ * script, sandbox execution, and the bundle writer. The rules themselves live
+ * in `@nodetool-ai/execution/js-script-debug`.
+ */
+export { runJsScriptValidate, runJsScriptOnce, runJsScriptTests, runJsScriptDebug } from "./harness.js";
+export { normalizeToolName, parseInteractionScript } from "./interactions.js";
+export { resolveJsScriptTarget } from "./target.js";
+//# sourceMappingURL=index.js.map

package/dist/js-script-debug/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/js-script-debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAcjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EAEvB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EAItB,MAAM,aAAa,CAAC"}

package/dist/js-script-debug/interactions.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The `--interact` script for `nodetool jsscript debug`.
+ *
+ * A step names one JS-script tool and the input to call it with:
+ *
+ * ```json
+ * [{"tool": "set_ports", "input": {"outputs": [{"name": "total", "type": "int"}]}},
+ *  {"tool": "ui_jsscript_set_code",
+ *   "input": {"code": "await output(\"total\", 1);"}}]
+ * ```
+ *
+ * Both spellings resolve to the same tool: the `ui_jsscript_` prefix is what
+ * the bridge and the browser call it, and typing it for every step is noise.
+ */
+import { type InteractionStep } from "../interaction-script.js";
+/** One parsed step, with the tool name in its canonical `ui_jsscript_*` form. */
+export type JsScriptInteractionStep = InteractionStep;
+export declare const normalizeToolName: (name: string) => string, parseInteractionScript: (json: string) => InteractionStep[];
+//# sourceMappingURL=interactions.d.ts.map

package/dist/js-script-debug/interactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.d.ts","sourceRoot":"","sources":["../../src/js-script-debug/interactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAElC,iFAAiF;AACjF,MAAM,MAAM,uBAAuB,GAAG,eAAe,CAAC;AAEtD,eAAO,MAAQ,iBAAiB,4BAAE,sBAAsB,qCAIrD,CAAC"}

package/dist/js-script-debug/interactions.js

@@ -0,0 +1,17 @@
+/**
+ * The `--interact` script for `nodetool jsscript debug`.
+ *
+ * A step names one JS-script tool and the input to call it with:
+ *
+ * ```json
+ * [{"tool": "set_ports", "input": {"outputs": [{"name": "total", "type": "int"}]}},
+ *  {"tool": "ui_jsscript_set_code",
+ *   "input": {"code": "await output(\"total\", 1);"}}]
+ * ```
+ *
+ * Both spellings resolve to the same tool: the `ui_jsscript_` prefix is what
+ * the bridge and the browser call it, and typing it for every step is noise.
+ */
+import { createInteractionScript } from "../interaction-script.js";
+export const { normalizeToolName, parseInteractionScript } = createInteractionScript("ui_jsscript_", '{"tool":"set_code","input":{"code":"..."}}');
+//# sourceMappingURL=interactions.js.map

package/dist/js-script-debug/interactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactions.js","sourceRoot":"","sources":["../../src/js-script-debug/interactions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,uBAAuB,EAExB,MAAM,0BAA0B,CAAC;AAKlC,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,GACxD,uBAAuB,CACrB,cAAc,EACd,4CAA4C,CAC7C,CAAC"}

package/dist/js-script-debug/target.d.ts

@@ -0,0 +1,20 @@
+import type { JsScriptDebugTarget } from "@nodetool-ai/execution/js-script-debug";
+/** A `js_scripts` row as the harness needs it. */
+export interface JsScriptRecord {
+    id: string;
+    name?: string | null;
+    /** The stored document — a JSON string or an already-parsed object. */
+    document: unknown;
+}
+export interface JsScriptTargetDeps {
+    /** Load a script by DB id. */
+    loadScript: (id: string) => Promise<JsScriptRecord | null>;
+}
+export interface ResolvedJsScriptTarget {
+    target: JsScriptDebugTarget;
+    /** The document exactly as loaded — validation's input, unrepaired. */
+    raw: unknown;
+}
+/** Resolve a JS-script target: a JSON file path or a `js_scripts` row id. */
+export declare function resolveJsScriptTarget(ref: string, deps: JsScriptTargetDeps): Promise<ResolvedJsScriptTarget>;
+//# sourceMappingURL=target.d.ts.map

package/dist/js-script-debug/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/js-script-debug/target.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAelF,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC5D;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,uEAAuE;IACvE,GAAG,EAAE,OAAO,CAAC;CACd;AA8BD,6EAA6E;AAC7E,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAkCjC"}

package/dist/js-script-debug/target.js

@@ -0,0 +1,78 @@
+/**
+ * Resolves a JS-script debug target into a document plus its name.
+ *
+ * A script is named two ways, and both end up in the same shape:
+ *
+ * - a **JSON file** — either a bare `JsScriptDocument` or a wrapper carrying
+ *   one under `document`, as the `js_scripts` row and the `jsScripts.get`
+ *   response do;
+ * - a **`js_scripts` row id**, read through an injected loader so this module
+ *   needs no database.
+ *
+ * A path that exists on disk wins over an id, so a file named like an id is
+ * still readable.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { isRecord, isString } from "../predicates.js";
+/**
+ * The document a target carries, unwrapping a `document` field (string or
+ * object) when there is one. Never throws — an unreadable document is a
+ * validation finding, not a crash.
+ */
+function documentOf(raw) {
+    // SAFETY: a target is read from a JSON file or a json column, so every
+    // branch below carries decoded JSON.
+    if (!isRecord(raw))
+        return raw;
+    const inner = raw.document;
+    if (isString(inner)) {
+        try {
+            return JSON.parse(inner);
+        }
+        catch {
+            return inner;
+        }
+    }
+    // SAFETY: same JSON provenance as the branch above.
+    if (inner !== undefined)
+        return inner;
+    return raw;
+}
+/** A document is anything carrying a `code` string and a `schemaVersion`. */
+const looksLikeDocument = (value) => isRecord(value) &&
+    isString(value.code) &&
+    value.schemaVersion !== undefined;
+/** Resolve a JS-script target: a JSON file path or a `js_scripts` row id. */
+export async function resolveJsScriptTarget(ref, deps) {
+    if (existsSync(ref)) {
+        let parsed;
+        try {
+            parsed = JSON.parse(readFileSync(ref, "utf8"));
+        }
+        catch (e) {
+            throw new Error(`${ref} is not valid JSON: ${e.message}`);
+        }
+        const raw = documentOf(parsed);
+        if (!looksLikeDocument(raw)) {
+            throw new Error(`${ref} is not a JS script document (no \`schemaVersion\`/\`code\`, and no \`document\` field carrying them).`);
+        }
+        const name = isRecord(parsed) && isString(parsed.name)
+            ? parsed.name
+            : undefined;
+        const target = { kind: "file", ref };
+        if (name) {
+            target.name = name;
+        }
+        return { target, raw };
+    }
+    const record = await deps.loadScript(ref);
+    if (!record) {
+        throw new Error(`JS script not found: ${ref}`);
+    }
+    const target = { kind: "id", ref };
+    if (record.name) {
+        target.name = record.name;
+    }
+    return { target, raw: documentOf(record) };
+}
+//# sourceMappingURL=target.js.map

package/dist/js-script-debug/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../src/js-script-debug/target.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,EACL,QAAQ,EACR,QAAQ,EACT,MAAM,kBAAkB,CAAC;AA8B1B;;;;GAIG;AACH,SAAS,UAAU,CAAC,GAAY;IAC9B,uEAAuE;IACvE,qCAAqC;IACrC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAgB,CAAC;IAC5C,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC3B,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,oDAAoD;IACpD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAkB,CAAC;IACnD,OAAO,GAAgB,CAAC;AAC1B,CAAC;AAED,6EAA6E;AAC7E,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAW,EAAE,CACpD,QAAQ,CAAC,KAAK,CAAC;IACf,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;IACpB,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC;AAEpC,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAW,EACX,IAAwB;IAExB,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,uBAAwB,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,GAAG,GAAG,wGAAwG,CAC/G,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GACR,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;YACvC,CAAC,CAAC,MAAM,CAAC,IAAI;YACb,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,MAAM,GAAwB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QAC1D,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,MAAM,GAAwB,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACxD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;AAC7C,CAAC"}

package/dist/local-model-interfaces.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The persistence a local (no-server) run gets: assets and timeline sequences,
+ * against the same database `setupDb()` opens.
+ *
+ * Installed process-wide by each command that runs a graph, so every context
+ * built downstream answers the same way. Wiring it per-entrance is what let
+ * `nodetool debug` and `nodetool workflows run` disagree: a workflow that
+ * saved an image ran under one and threw "ProcessingContext model interface
+ * 'createAsset' is not configured" under the other.
+ *
+ * `createAsset` is the server's own implementation, imported rather than
+ * rewritten — the local copy this replaced wrote no thumbnail and left
+ * `parent_id` null, so a CLI-generated asset was invisible in every
+ * folder-scoped listing in the UI.
+ */
+import type { ProcessingContextModelInterfaces } from "@nodetool-ai/runtime";
+export declare function localModelInterfaces(): Promise<ProcessingContextModelInterfaces>;
+/** Install them as this process's default, once. */
+export declare function installLocalModelInterfaces(): Promise<void>;
+//# sourceMappingURL=local-model-interfaces.d.ts.map

package/dist/local-model-interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-model-interfaces.d.ts","sourceRoot":"","sources":["../src/local-model-interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAG7E,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,gCAAgC,CAAC,CAgBtF;AAID,oDAAoD;AACpD,wBAAgB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAO3D"}

package/dist/local-model-interfaces.js

@@ -0,0 +1,41 @@
+/**
+ * The persistence a local (no-server) run gets: assets and timeline sequences,
+ * against the same database `setupDb()` opens.
+ *
+ * Installed process-wide by each command that runs a graph, so every context
+ * built downstream answers the same way. Wiring it per-entrance is what let
+ * `nodetool debug` and `nodetool workflows run` disagree: a workflow that
+ * saved an image ran under one and threw "ProcessingContext model interface
+ * 'createAsset' is not configured" under the other.
+ *
+ * `createAsset` is the server's own implementation, imported rather than
+ * rewritten — the local copy this replaced wrote no thumbnail and left
+ * `parent_id` null, so a CLI-generated asset was invisible in every
+ * folder-scoped listing in the UI.
+ */
+import { setDefaultModelInterfaces } from "@nodetool-ai/runtime";
+export async function localModelInterfaces() {
+    // The `/assets` subpath, not the package root: the root entry pulls in the
+    // WebSocket runner and the HTTP server, which a local run does not need.
+    const { createAssetModelInterface, updateAssetBytesModelInterface } = await import("@nodetool-ai/websocket/assets");
+    // Storyboards, the entity library and the game templates, from the same
+    // module the server installs — a harness run has to write the rows a server
+    // run writes, or it proves nothing about the server.
+    const { documentModelInterfaces } = await import("@nodetool-ai/websocket/documents");
+    return {
+        createAsset: createAssetModelInterface,
+        updateAssetBytes: updateAssetBytesModelInterface,
+        ...documentModelInterfaces()
+    };
+}
+let installed = null;
+/** Install them as this process's default, once. */
+export function installLocalModelInterfaces() {
+    if (!installed) {
+        installed = localModelInterfaces().then((interfaces) => {
+            setDefaultModelInterfaces(interfaces);
+        });
+    }
+    return installed;
+}
+//# sourceMappingURL=local-model-interfaces.js.map

package/dist/local-model-interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-model-interfaces.js","sourceRoot":"","sources":["../src/local-model-interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,2EAA2E;IAC3E,yEAAyE;IACzE,MAAM,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,GACjE,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;IAChD,wEAAwE;IACxE,4EAA4E;IAC5E,qDAAqD;IACrD,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAC9C,kCAAkC,CACnC,CAAC;IACF,OAAO;QACL,WAAW,EAAE,yBAAyB;QACtC,gBAAgB,EAAE,8BAA8B;QAChD,GAAG,uBAAuB,EAAE;KAC7B,CAAC;AACJ,CAAC;AAED,IAAI,SAAS,GAAyB,IAAI,CAAC;AAE3C,oDAAoD;AACpD,MAAM,UAAU,2BAA2B;IACzC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,oBAAoB,EAAE,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;YACrD,yBAAyB,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/local-secrets.d.ts

@@ -0,0 +1,3 @@
+/** Resolve a secret for the local user: encrypted store first, then env. */
+export declare function resolveLocalSecret(key: string): Promise<string | null>;
+//# sourceMappingURL=local-secrets.d.ts.map

package/dist/local-secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-secrets.d.ts","sourceRoot":"","sources":["../src/local-secrets.ts"],"names":[],"mappings":"AAaA,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEtE"}