@nodetool-ai/execution 0.8.1 → 0.8.3

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

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

package/dist/js-script-debug/type-check.d.ts

@@ -0,0 +1,16 @@
+import type { JsScriptDebugIssue } from "./types.js";
+/** `specifier -> absolute path to the pack's shipped .d.ts`, e.g. `"@nodetool-ai/sandbox-timeline" -> ".../sandbox/index.d.ts"`. */
+export type PackDtsSources = ReadonlyMap<string, string>;
+/**
+ * Type-check `code` (a script or Code-node body) as an ES module against the
+ * `.d.ts` files in `packDtsSources`, keyed by the specifier a script imports
+ * them under. Returns one `js_script_type_error` per diagnostic on the
+ * script's own file, each naming the message TypeScript gives — which names
+ * the offending property (`caret` on an object-literal type mismatch) the
+ * way every other check in this module names the identifier it complains
+ * about. Never throws: a `typescript` failure to load or a filesystem error
+ * is swallowed and reported as nothing found, since this check is additive
+ * on top of the AST-level one in `validateCodeNodeBody`.
+ */
+export declare function typeCheckAgainstPackDts(code: string, packDtsSources: PackDtsSources): Promise<JsScriptDebugIssue[]>;
+//# sourceMappingURL=type-check.d.ts.map

package/dist/js-script-debug/type-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-check.d.ts","sourceRoot":"","sources":["../../src/js-script-debug/type-check.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,oIAAoI;AACpI,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAkDzD;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CA+E/B"}

package/dist/js-script-debug/type-check.js

@@ -0,0 +1,150 @@
+/**
+ * Type-checks a JS script body against the `.d.ts` files installed sandbox
+ * packs ship, so an authoring mistake like `typewriter({ caret: true })`
+ * (`@nodetool-ai/sandbox-timeline`'s `caret` is an object, not a boolean)
+ * fails `nodetool jsscript validate` by name before the script ever runs.
+ *
+ * The body is not itself valid as a standalone module (it is the async
+ * function body `runCodeBody` wraps at execution time), but its own
+ * top-level `import` statements and any top-level `await` are ordinary ES
+ * module syntax, so writing it to a `.ts` file and type-checking that file
+ * as a module works without reconstructing the wrapper. Every sandbox
+ * global the body can read (`nodetool`, `emit`, `inputs`, `workspace`, …) is
+ * declared `any` in a a synthesized globals file so the checker never flags
+ * one as unknown — this only checks what an installed pack's own `.d.ts`
+ * commits to, nothing about the rest of the guest environment.
+ */
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/**
+ * Names the QuickJS sandbox and the Code/script node put in scope, loosely
+ * typed so the checker never reports one as undefined — mirrors
+ * `SANDBOX_GLOBALS` in `@nodetool-ai/node-sdk`'s `code-node-validation.ts`,
+ * which this package cannot import as a compile-time type (the dependency
+ * runs the other way). A name only needs to exist here, not match precisely:
+ * a wrong shape on a *sandbox* global is not this check's job, only a wrong
+ * shape passed to an *installed pack's* own declared API is.
+ */
+const SANDBOX_GLOBALS_DTS = `
+declare const nodetool: any;
+declare const tools: any;
+declare const inputs: any;
+declare const state: any;
+declare const workspace: any;
+declare function emit(name: string, value: unknown): Promise<void>;
+declare function output(name: string, value: unknown): Promise<void>;
+declare function stream(name: string): AsyncIterable<unknown> & { any: () => AsyncIterable<unknown> };
+declare function progress(message: string, fraction?: number): void;
+declare function getSecret(name: string): Promise<string | undefined>;
+declare function sleep(ms: number): Promise<void>;
+declare const format: any;
+declare const image: any;
+declare const audio: any;
+declare const video: any;
+declare const canvas: any;
+declare const media: any;
+declare function createCanvas(width: number, height: number): unknown;
+declare function parallelMap<T, R>(items: readonly T[], fn: (item: T) => Promise<R>): Promise<R[]>;
+declare function toBase64(bytes: Uint8Array): string;
+declare function fromBase64(text: string): Uint8Array;
+declare function toHex(bytes: Uint8Array): string;
+declare function fromHex(text: string): Uint8Array;
+declare function assetToSandbox(value: unknown): Promise<unknown>;
+declare function sandboxToAsset(value: unknown): Promise<unknown>;
+`;
+/**
+ * "Cannot find module" (a named import, then a side-effect import). Only packs
+ * that ship a `.d.ts` are on the paths here, so every other import — a pack
+ * with no types, a host-mounted `@nodetool-ai/sandbox-nodetool/*` facade —
+ * fails to resolve in this program while resolving fine in the sandbox.
+ * Whether a specifier exists is the catalog check's job
+ * (`code_package_unavailable`); this check only holds a typed pack to its
+ * own declarations, and an unresolved import is `any` to it.
+ */
+const UNRESOLVED_MODULE_CODES = new Set([2307, 2882]);
+/**
+ * Type-check `code` (a script or Code-node body) as an ES module against the
+ * `.d.ts` files in `packDtsSources`, keyed by the specifier a script imports
+ * them under. Returns one `js_script_type_error` per diagnostic on the
+ * script's own file, each naming the message TypeScript gives — which names
+ * the offending property (`caret` on an object-literal type mismatch) the
+ * way every other check in this module names the identifier it complains
+ * about. Never throws: a `typescript` failure to load or a filesystem error
+ * is swallowed and reported as nothing found, since this check is additive
+ * on top of the AST-level one in `validateCodeNodeBody`.
+ */
+export async function typeCheckAgainstPackDts(code, packDtsSources) {
+    if (code.trim() === "" || packDtsSources.size === 0)
+        return [];
+    let ts;
+    try {
+        ts = (await import("typescript")).default ?? (await import("typescript"));
+    }
+    catch (error) {
+        // `typescript` failing to load means this install cannot type-check at
+        // all — a warning, not an error, since that is not the script's fault and
+        // must not fail `validate` outright (the AST-level checks above already
+        // ran and still stand). `typescript` is only a runtime dependency of this
+        // package (`packages/execution/package.json`), and this dynamic import is
+        // the only place it is ever loaded — a validate call with no pack
+        // `.d.ts` sources, and every other caller of this package, never touches
+        // the module at all.
+        return [
+            {
+                severity: "warning",
+                code: "type_check_unavailable",
+                message: `Could not load the TypeScript compiler, so the script's imports were not type-checked against any installed pack's .d.ts: ${error instanceof Error ? error.message : String(error)}`
+            }
+        ];
+    }
+    const dir = await mkdtemp(join(tmpdir(), "nodetool-jsscript-types-"));
+    try {
+        const globalsPath = join(dir, "sandbox-globals.d.ts");
+        const scriptPath = join(dir, "script.ts");
+        await writeFile(globalsPath, SANDBOX_GLOBALS_DTS, "utf8");
+        await writeFile(scriptPath, code, "utf8");
+        const paths = {};
+        for (const [specifier, dtsPath] of packDtsSources) {
+            paths[specifier] = [dtsPath];
+        }
+        let program;
+        try {
+            program = ts.createProgram([globalsPath, scriptPath], {
+                allowJs: false,
+                checkJs: false,
+                noEmit: true,
+                skipLibCheck: true,
+                strict: false,
+                target: ts.ScriptTarget.ES2022,
+                module: ts.ModuleKind.ESNext,
+                moduleResolution: ts.ModuleResolutionKind.Bundler,
+                baseUrl: dir,
+                paths
+            });
+        }
+        catch {
+            return [];
+        }
+        const diagnostics = ts
+            .getPreEmitDiagnostics(program)
+            .filter((diagnostic) => diagnostic.file?.fileName === scriptPath &&
+            !UNRESOLVED_MODULE_CODES.has(diagnostic.code));
+        return diagnostics.map((diagnostic) => {
+            const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, " ");
+            if (diagnostic.file !== undefined && diagnostic.start !== undefined) {
+                const { line } = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);
+                return {
+                    severity: "error",
+                    code: "js_script_type_error",
+                    message: `line ${line + 1}: ${message}`
+                };
+            }
+            return { severity: "error", code: "js_script_type_error", message };
+        });
+    }
+    finally {
+        await rm(dir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=type-check.js.map

package/dist/js-script-debug/type-check.js.map

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

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

@@ -20,6 +20,7 @@
  */
 import type { SandboxModuleCatalog } from "@nodetool-ai/runtime";
 import type { JsScriptValidation } from "./types.js";
+import { type PackDtsSources } from "./type-check.js";
 export interface JsScriptValidationOptions {
     /**
      * Secret names this install carries. A declared secret missing from the list
@@ -29,6 +30,13 @@ export interface JsScriptValidationOptions {
     knownSecrets?: readonly string[];
     /** The installed sandbox catalog, when the caller has one. */
     sandboxModuleCatalog?: SandboxModuleCatalog | null;
+    /**
+     * `specifier -> absolute path to an installed pack's shipped .d.ts`, when
+     * the caller has resolved them. Given any, the body is type-checked as an
+     * ES module against those declarations — see `type-check.ts`. Omit to skip
+     * it entirely; an empty map is the same as omitting it.
+     */
+    packDtsSources?: PackDtsSources;
 }
 /**
  * Check a JS script document without running it. Returns findings rather than

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

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/js-script-debug/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;CACpD;AAsED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,kBAAkB,CAAC,CAgE7B"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/js-script-debug/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACzE,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE/E,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,8DAA8D;IAC9D,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACnD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAsED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,OAAO,EACjB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,kBAAkB,CAAC,CAoE7B"}

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

@@ -19,6 +19,7 @@
  * here, so a file target stays database-free.
  */
 import { jsScriptDocument, validateJsScriptDocument } from "@nodetool-ai/protocol/api-schemas/js-scripts.js";
+import { typeCheckAgainstPackDts } from "./type-check.js";
 function split(issues) {
     const errors = issues.filter((issue) => issue.severity === "error");
     const warnings = issues.filter((issue) => issue.severity === "warning");
@@ -111,6 +112,9 @@ export async function validateJsScriptDoc(document, options = {}) {
         message: issue.message
     }));
     const issues = [...shapeIssues, ...bodyIssues];
+    if (options.packDtsSources !== undefined && options.packDtsSources.size > 0) {
+        issues.push(...(await typeCheckAgainstPackDts(doc.code, options.packDtsSources)));
+    }
     const streaming = usesStreamInputContract(doc.code);
     // A streaming body on the return contract is already an error from the body
     // check (`code_stream_return_contract`), which says the same thing.

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

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

package/dist/message-stream.d.ts

@@ -1,33 +1,2 @@
-/**
- * Turns `ProcessingContext`'s push-based `addMessageListener` into a pull-based
- * `AsyncIterable<ProcessingMessage>`. Modeled on the queue/wake pattern in
- * `packages/workflow-runner/src/run.ts`'s `runWorkflow` generator — the one
- * other place in the repo already streams a kernel run as an async sequence.
- *
- * The queue is bounded. A caller that opts into capture (see
- * `ExecutionSessionOptions.captureMessages`) but never iterates would
- * otherwise retain every message of the run — including real-time audio
- * chunks, which the kernel's own message retention deliberately avoids
- * holding (roughly 25 MB/minute). Past the limit the stream stops queueing
- * and the iterator throws, so a non-draining consumer fails loudly instead of
- * growing until the run ends.
- */
-import type { ProcessingContext } from "@nodetool-ai/runtime";
-import type { ProcessingMessage } from "@nodetool-ai/protocol";
-/** Queued messages allowed to pile up before the stream gives up. */
-export declare const DEFAULT_MESSAGE_BUFFER_LIMIT = 10000;
-export declare class MessageStream implements AsyncIterable<ProcessingMessage> {
-    private readonly queue;
-    private waiter;
-    private closed;
-    private overflowedAt;
-    private readonly limit;
-    private readonly unsubscribe;
-    /** `limit` of 0 (or a negative number) means unbounded. */
-    constructor(context: ProcessingContext, limit?: number);
-    private wake;
-    /** Stop feeding new messages into the queue. Already-queued messages still drain. */
-    close(): void;
-    [Symbol.asyncIterator](): AsyncIterator<ProcessingMessage>;
-}
+export { MessageStream, DEFAULT_MESSAGE_BUFFER_LIMIT } from "@nodetool-ai/kernel";
 //# sourceMappingURL=message-stream.d.ts.map

package/dist/message-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-stream.d.ts","sourceRoot":"","sources":["../src/message-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,qEAAqE;AACrE,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD,qBAAa,aAAc,YAAW,aAAa,CAAC,iBAAiB,CAAC;IACpE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IAEzC,2DAA2D;IAC3D,YAAY,OAAO,EAAE,iBAAiB,EAAE,KAAK,SAA+B,EAa3E;IAED,OAAO,CAAC,IAAI;IAMZ,qFAAqF;IACrF,KAAK,IAAI,IAAI,CAKZ;IAEM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,iBAAiB,CAAC,CAmBhE;CACF"}
+{"version":3,"file":"message-stream.d.ts","sourceRoot":"","sources":["../src/message-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/message-stream.js

@@ -1,58 +1,2 @@
-/** Queued messages allowed to pile up before the stream gives up. */
-export const DEFAULT_MESSAGE_BUFFER_LIMIT = 10_000;
-export class MessageStream {
-    queue = [];
-    waiter = null;
-    closed = false;
-    overflowedAt = null;
-    limit;
-    unsubscribe;
-    /** `limit` of 0 (or a negative number) means unbounded. */
-    constructor(context, limit = DEFAULT_MESSAGE_BUFFER_LIMIT) {
-        this.limit = limit > 0 ? limit : Number.POSITIVE_INFINITY;
-        this.unsubscribe = context.addMessageListener((message) => {
-            if (this.queue.length >= this.limit) {
-                if (this.overflowedAt === null) {
-                    this.overflowedAt = this.queue.length;
-                    this.unsubscribe();
-                }
-                return;
-            }
-            this.queue.push(message);
-            this.wake();
-        });
-    }
-    wake() {
-        const w = this.waiter;
-        this.waiter = null;
-        w?.();
-    }
-    /** Stop feeding new messages into the queue. Already-queued messages still drain. */
-    close() {
-        if (this.closed)
-            return;
-        this.closed = true;
-        this.unsubscribe();
-        this.wake();
-    }
-    async *[Symbol.asyncIterator]() {
-        for (;;) {
-            while (this.queue.length > 0) {
-                yield this.queue.shift();
-            }
-            if (this.overflowedAt !== null) {
-                throw new Error(`ExecutionSession message stream overflowed after ${this.overflowedAt} ` +
-                    `queued messages (limit ${this.limit}) — the consumer fell behind, ` +
-                    "so messages past that point were dropped rather than retained. " +
-                    "Iterate `session.messages` as the run progresses, or raise " +
-                    "`limits.messageBufferLimit`.");
-            }
-            if (this.closed)
-                return;
-            await new Promise((resolve) => {
-                this.waiter = resolve;
-            });
-        }
-    }
-}
+export { MessageStream, DEFAULT_MESSAGE_BUFFER_LIMIT } from "@nodetool-ai/kernel";
 //# sourceMappingURL=message-stream.js.map

package/dist/message-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-stream.js","sourceRoot":"","sources":["../src/message-stream.ts"],"names":[],"mappings":"AAiBA,qEAAqE;AACrE,MAAM,CAAC,MAAM,4BAA4B,GAAG,MAAM,CAAC;AAEnD,MAAM,OAAO,aAAa;IACP,KAAK,GAAwB,EAAE,CAAC;IACzC,MAAM,GAAwB,IAAI,CAAC;IACnC,MAAM,GAAG,KAAK,CAAC;IACf,YAAY,GAAkB,IAAI,CAAC;IAC1B,KAAK,CAAS;IACd,WAAW,CAAa;IAEzC,2DAA2D;IAC3D,YAAY,OAA0B,EAAE,KAAK,GAAG,4BAA4B;QAC1E,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAC1D,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,OAAO,EAAE,EAAE;YACxD,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACpC,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;oBAC/B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;oBACtC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrB,CAAC;gBACD,OAAO;YACT,CAAC;YACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,IAAI;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,CAAC,EAAE,EAAE,CAAC;IACR,CAAC;IAED,qFAAqF;IACrF,KAAK;QACH,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,SAAS,CAAC;YACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;YAC5B,CAAC;YACD,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CACb,oDAAoD,IAAI,CAAC,YAAY,GAAG;oBACtE,0BAA0B,IAAI,CAAC,KAAK,gCAAgC;oBACpE,iEAAiE;oBACjE,6DAA6D;oBAC7D,8BAA8B,CACjC,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO;YACxB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC;YACxB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"message-stream.js","sourceRoot":"","sources":["../src/message-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/partial-run.d.ts

@@ -0,0 +1,65 @@
+import type { GraphData, NodeDescriptor } from "@nodetool-ai/protocol";
+import type { NodeMetadata } from "@nodetool-ai/node-sdk";
+/** A previous generation of one node, as the run reuses it. */
+export interface PreviousGeneration {
+    /** Output values keyed by output handle. */
+    outputs: Record<string, unknown>;
+    jobId: string | null;
+    assetIds: string[];
+}
+export interface PartialRunDeps {
+    getMetadata: (nodeType: string) => NodeMetadata | undefined;
+    /**
+     * The node's previous generation, or null when it has none. Omit to run
+     * every upstream node again.
+     */
+    loadPreviousGeneration?: (node: NodeDescriptor, metadata: NodeMetadata) => Promise<PreviousGeneration | null>;
+}
+/** One upstream node whose saved output replaced its run. */
+export interface ReusedNode {
+    node_id: string;
+    job_id: string | null;
+    asset_ids: string[];
+}
+export type PartialRunPlan = {
+    kind: "graph";
+    graph: GraphData;
+    /** Every node the narrowed graph runs. */
+    ran: string[];
+    reused: ReusedNode[];
+} | {
+    kind: "unknown_nodes";
+    ids: string[];
+};
+/** The ids in `nodeIds` that name no node of `graph`. */
+export declare function unknownNodeIds(graph: GraphData, nodeIds: readonly string[]): string[];
+/**
+ * A generation's value for one output handle: the named handle, else the sole
+ * value of a single-output generation. Mirrors `outputOf` in
+ * `web/src/utils/nodeGenerations.ts`, except that a generation with several
+ * other handles yields nothing rather than the whole record.
+ */
+export declare function generationOutputFor(outputs: Record<string, unknown>, handle: string | null | undefined): unknown;
+export declare function planPartialRun(graph: GraphData, nodeIds: readonly string[], deps: PartialRunDeps): Promise<PartialRunPlan>;
+/** The asset fields a generation is rebuilt from. */
+export interface GenerationAssetRow {
+    id: string;
+    job_id: string | null;
+    content_type: string;
+    size: number | null;
+    metadata: Record<string, unknown> | null;
+}
+/**
+ * Rebuild a node's previous generation from the assets its auto-save wrote
+ * (`autoSaveAssets` in the websocket package), newest first. One generation is
+ * every asset one `generation_complete` produced: the same job and the same
+ * `generation_index`. Returns null when nothing usable is saved, so the node
+ * runs again:
+ *
+ *  - `pinnedId` (the editor's `selected_generation`) names an asset not in
+ *    `rows`;
+ *  - a text generation was saved with a truncated inline copy;
+ *  - a structured generation was too large to keep inline.
+ */
+export declare function previousGenerationFromAssets(rows: readonly GenerationAssetRow[], metadata: NodeMetadata, pinnedId?: string): PreviousGeneration | null;
+//# sourceMappingURL=partial-run.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"partial-run.d.ts","sourceRoot":"","sources":["../src/partial-run.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAQ,SAAS,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,uBAAuB,CAAC;AAExE,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;IAC5D;;;OAGG;IACH,sBAAsB,CAAC,EAAE,CACvB,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,YAAY,KACnB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;CACzC;AAED,6DAA6D;AAC7D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GACtB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,GACD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE7C,yDAAyD;AACzD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,MAAM,EAAE,CAGV;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,OAAO,CAIT;AAwCD,wBAAsB,cAAc,CAClC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,cAAc,CAAC,CA8JzB;AAMD,qDAAqD;AACrD,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C;AAsBD;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,SAAS,kBAAkB,EAAE,EACnC,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB,kBAAkB,GAAG,IAAI,CA2D3B"}