@nodetool-ai/execution 0.8.1

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,33 @@
+/**
+ * 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>;
+}
+//# sourceMappingURL=message-stream.d.ts.map

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

@@ -0,0 +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"}

package/dist/message-stream.js

@@ -0,0 +1,58 @@
+/** 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;
+            });
+        }
+    }
+}
+//# sourceMappingURL=message-stream.js.map

package/dist/message-stream.js.map

@@ -0,0 +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"}

package/dist/normalize-graph.d.ts

@@ -0,0 +1,13 @@
+import type { GraphData } from "@nodetool-ai/protocol";
+import type { RawGraphInput } from "./types.js";
+/**
+ * Present an already-typed graph as the facade's raw input.
+ *
+ * `RawGraphInput` describes saved-graph JSON, so its elements are indexable
+ * records; `NodeDescriptor` and `Edge` are not. A shallow copy per element
+ * bridges the two without asserting one is the other — the normalizer copies
+ * every element anyway, so nothing is paid twice.
+ */
+export declare function toRawGraphInput(graph: GraphData): RawGraphInput;
+export declare function normalizeGraph(graph: RawGraphInput): GraphData;
+//# sourceMappingURL=normalize-graph.d.ts.map

package/dist/normalize-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-graph.d.ts","sourceRoot":"","sources":["../src/normalize-graph.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAQ,SAAS,EAAkB,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CAK/D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CA4C9D"}

package/dist/normalize-graph.js

@@ -0,0 +1,63 @@
+/**
+ * Normalize a raw saved graph into the kernel's descriptor contract: node
+ * properties under `properties` (the editor stores them under `data`), edges
+ * carrying `edge_type`, and editor-only nodes (Comment/Group/Reroute) pruned
+ * the way the web editor prunes them at serialize time.
+ *
+ * Ported from `packages/websocket/src/headless-job-runner.ts`'s
+ * `normalizeRunnableGraph` / `packages/cli/src/debug/server-runner.ts`'s
+ * inline filter — the two call sites this logic drifted between before this
+ * package existed.
+ */
+import { isEditorOnlyType } from "@nodetool-ai/node-sdk";
+/**
+ * Present an already-typed graph as the facade's raw input.
+ *
+ * `RawGraphInput` describes saved-graph JSON, so its elements are indexable
+ * records; `NodeDescriptor` and `Edge` are not. A shallow copy per element
+ * bridges the two without asserting one is the other — the normalizer copies
+ * every element anyway, so nothing is paid twice.
+ */
+export function toRawGraphInput(graph) {
+    return {
+        nodes: graph.nodes.map((n) => Object.fromEntries(Object.entries(n))),
+        edges: graph.edges.map((e) => Object.fromEntries(Object.entries(e)))
+    };
+}
+export function normalizeGraph(graph) {
+    // `RawGraphInput` declares two arrays; the stored row or file behind it has
+    // never been checked against that, and a non-array used to reach `.filter()`.
+    if (!Array.isArray(graph?.nodes) || !Array.isArray(graph?.edges)) {
+        throw new Error("Invalid workflow: nodes and edges must be arrays");
+    }
+    const executable = graph.nodes.filter((n) => !isEditorOnlyType(String(n["type"] ?? "")));
+    const keep = new Set(executable.map((n) => String(n["id"] ?? "")));
+    const nodes = executable.map((n) => {
+        const record = { ...n };
+        if (record["properties"] === undefined && record["data"] !== undefined) {
+            const { data, ...rest } = record;
+            // SAFETY: the editor stores a node's inputs under `data` and the kernel
+            // reads them under `properties`; renaming that one key is the only
+            // difference between a saved node and a NodeDescriptor.
+            return { ...rest, properties: data };
+        }
+        // SAFETY: a saved node that already carries `properties` is a
+        // NodeDescriptor as stored — `id` and `type` are written on every save.
+        return record;
+    });
+    const edges = graph.edges
+        .filter((e) => keep.has(String(e["source"] ?? "")) &&
+        keep.has(String(e["target"] ?? "")))
+        .map((e) => {
+        const record = { ...e };
+        const rawEdgeType = record["edge_type"] ?? record["type"];
+        const edge_type = rawEdgeType === "control" ? "control" : "data";
+        const { type: _type, ...rest } = record;
+        // SAFETY: `keep` above already proved this edge's source and target are
+        // strings naming retained nodes; `edge_type` is normalized just above,
+        // and Edge carries an index signature for whatever else was saved.
+        return { ...rest, edge_type };
+    });
+    return { nodes, edges };
+}
+//# sourceMappingURL=normalize-graph.js.map

package/dist/normalize-graph.js.map

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

package/dist/output-names.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Renames terminal Output-node keys to their public `properties.name` before
+ * the run starts. The kernel keys terminal outputs by `node.name`; SDK/API
+ * callers that need `output_update`/terminal-result addressing to agree with
+ * their declared interface names set `requireTerminalResult`.
+ *
+ * Ported from `websocket-client-session.ts`'s `startJobInner`
+ * (`req.require_terminal_result` branch) — the only site that did this
+ * before this package existed.
+ */
+import type { HydratedGraphData } from "@nodetool-ai/protocol";
+export declare function rewriteOutputNames(graph: HydratedGraphData): void;
+//# sourceMappingURL=output-names.d.ts.map

package/dist/output-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-names.d.ts","sourceRoot":"","sources":["../src/output-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CASjE"}

package/dist/output-names.js

@@ -0,0 +1,13 @@
+import { isNonBlankString } from "./predicates.js";
+export function rewriteOutputNames(graph) {
+    for (const node of graph.nodes) {
+        if (!node.type.startsWith("nodetool.output."))
+            continue;
+        const properties = node.properties;
+        const publicName = properties?.["name"];
+        if (isNonBlankString(publicName)) {
+            node.name = publicName;
+        }
+    }
+}
+//# sourceMappingURL=output-names.js.map

package/dist/output-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-names.js","sourceRoot":"","sources":["../src/output-names.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IACzD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC;YAAE,SAAS;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,UAA4C,CAAC;QACrE,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACzB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/predicates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The workspace's named type predicates, re-exported for the debug harnesses'
+ * call sites. The definitions live in `@nodetool-ai/protocol`.
+ */
+export { isBoolean, isFiniteNumber, isNonBlankString, isNonEmptyString, isNumber, isObjectLike, isPositiveFiniteNumber, isRecord, isString, isCallable as isFunctionValue } from "@nodetool-ai/protocol";
+//# sourceMappingURL=predicates.d.ts.map

package/dist/predicates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../src/predicates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,sBAAsB,EACtB,QAAQ,EACR,QAAQ,EACR,UAAU,IAAI,eAAe,EAC9B,MAAM,uBAAuB,CAAC"}

package/dist/predicates.js

@@ -0,0 +1,6 @@
+/**
+ * The workspace's named type predicates, re-exported for the debug harnesses'
+ * call sites. The definitions live in `@nodetool-ai/protocol`.
+ */
+export { isBoolean, isFiniteNumber, isNonBlankString, isNonEmptyString, isNumber, isObjectLike, isPositiveFiniteNumber, isRecord, isString, isCallable as isFunctionValue } from "@nodetool-ai/protocol";
+//# sourceMappingURL=predicates.js.map

package/dist/predicates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.js","sourceRoot":"","sources":["../src/predicates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,sBAAsB,EACtB,QAAQ,EACR,QAAQ,EACR,UAAU,IAAI,eAAe,EAC9B,MAAM,uBAAuB,CAAC"}

package/dist/preflight.d.ts

@@ -0,0 +1,87 @@
+/** Provider/model catalogs the preflight checks a graph's selections against. */
+export interface RunModelCatalogs {
+    listProviderIds: () => readonly string[];
+    listModelIds: (provider: string, modelType: string) => readonly string[] | undefined;
+}
+/** The catalogs of the process-wide provider registry. */
+export declare const RUNTIME_CATALOGS: RunModelCatalogs;
+/** Model selections in a graph that no configured provider can honour. */
+export declare function modelSelectionErrors(graph: {
+    nodes?: unknown;
+}, catalogs?: RunModelCatalogs): string[];
+/** How the preflight resolves a credential — the way the coming run will. */
+export interface CredentialResolver {
+    resolveSecret: (key: string) => Promise<string | null | undefined> | string | null | undefined;
+}
+/**
+ * Providers a graph selects whose required credentials this runtime cannot
+ * resolve, one message each.
+ *
+ * The provider registry knows exactly which kwargs are load-bearing (an empty
+ * declaration means "resolve from store, then env"), and a provider built
+ * without one throws the `*_API_KEY is required` error mid-run that this check
+ * exists to front-run. Unregistered ids are skipped: the model-selection check
+ * already reports those as errors, and guessing at an unknown provider's
+ * credentials would be noise.
+ */
+export declare function unconfiguredProviderErrors(graph: {
+    nodes?: unknown;
+    edges?: unknown;
+}, resolver: CredentialResolver, providerIds?: readonly string[]): Promise<string[]>;
+/**
+ * How the preflight decides whether a provider a graph selects is configured.
+ *
+ * Defaults to {@link unconfiguredProviderErrors} over the process-wide
+ * provider registry. A host whose providers are not in that registry (a
+ * cassette, a fake, an in-process custom provider) supplies its own — together
+ * with its own {@link RunModelCatalogs}, since the two checks read the same
+ * registry.
+ */
+export type ProviderConfigurationChecker = (graph: {
+    nodes?: unknown;
+    edges?: unknown;
+}, resolver: CredentialResolver) => Promise<readonly string[]> | readonly string[];
+/** A checker over an explicit provider list, for a host with its own registry. */
+export declare function providerConfigurationChecker(providerIds: readonly string[]): ProviderConfigurationChecker;
+export type PreflightIssueKind = "model" | "credential";
+/** One reason a run was refused before it started. */
+export interface ExecutionPreflightIssue {
+    kind: PreflightIssueKind;
+    message: string;
+}
+/** The refusal text every host prints — one section per issue kind. */
+export declare function formatPreflightDetail(issues: readonly ExecutionPreflightIssue[]): string;
+/**
+ * The refusal contract shared by `ExecutionSession`, the run service, and the
+ * CLI adapters: a typed error whose `issues` are machine-readable and whose
+ * `message` is the text a host prints verbatim.
+ */
+export declare class ExecutionPreflightError extends Error {
+    readonly name = "ExecutionPreflightError";
+    readonly issues: readonly ExecutionPreflightIssue[];
+    constructor(issues: readonly ExecutionPreflightIssue[]);
+}
+export declare function isExecutionPreflightError(value: unknown): value is ExecutionPreflightError;
+export interface PreflightOptions {
+    catalogs?: RunModelCatalogs;
+    providerConfiguration?: ProviderConfigurationChecker;
+    /** Resolves a credential the way the coming run will. */
+    resolveSecret: CredentialResolver["resolveSecret"];
+}
+/**
+ * Every reason to refuse `graph`, model selections first.
+ *
+ * A graph whose model selections are already unhonourable stops there: a
+ * provider that is not registered has no credentials to check, so running the
+ * second check would only add noise to a refusal that is already decided.
+ */
+export declare function collectPreflightIssues(graph: {
+    nodes?: unknown;
+    edges?: unknown;
+}, options: PreflightOptions): Promise<ExecutionPreflightIssue[]>;
+/** {@link collectPreflightIssues}, as a refusal. */
+export declare function assertPreflight(graph: {
+    nodes?: unknown;
+    edges?: unknown;
+}, options: PreflightOptions): Promise<void>;
+//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AA6BA,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,SAAS,MAAM,EAAE,CAAC;IACzC,YAAY,EAAE,CACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,KACd,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;CACpC;AAED,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,EAAE,gBAI9B,CAAC;AAEF,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC1B,QAAQ,GAAE,gBAAmC,GAC5C,MAAM,EAAE,CAQV;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CACb,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACrE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3C,QAAQ,EAAE,kBAAkB,EAC5B,WAAW,GAAE,SAAS,MAAM,EAAgC,GAC3D,OAAO,CAAC,MAAM,EAAE,CAAC,CAmCnB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,4BAA4B,GAAG,CACzC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3C,QAAQ,EAAE,kBAAkB,KACzB,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,SAAS,MAAM,EAAE,CAAC;AAEpD,kFAAkF;AAClF,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B,4BAA4B,CAG9B;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,YAAY,CAAC;AAExD,sDAAsD;AACtD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD,uEAAuE;AACvE,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,uBAAuB,EAAE,GACzC,MAAM,CAWR;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAkB,IAAI,6BAA6B;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAEpD,YAAY,MAAM,EAAE,SAAS,uBAAuB,EAAE,EAGrD;CACF;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,uBAAuB,CAElC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,qBAAqB,CAAC,EAAE,4BAA4B,CAAC;IACrD,yDAAyD;IACzD,aAAa,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CACpD;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3C,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAUpC;AAED,oDAAoD;AACpD,wBAAsB,eAAe,CACnC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3C,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/preflight.js

@@ -0,0 +1,139 @@
+/**
+ * Run preflight — the checks that must refuse a graph *before* anything is
+ * paid for.
+ *
+ * A graph that names a provider this runtime does not have, or a model that
+ * provider does not offer, or a credential nobody stored, fails at the node
+ * that needs it — after the upstream half of the graph has already run and
+ * billed. Both checks front-run that failure, and both live here (rather than
+ * in the run service) so `ExecutionSession` can call them without importing
+ * the models database.
+ *
+ * Both fail toward silence: an empty provider registry means the registry
+ * could not be reached, and an unregistered provider id is left to the
+ * model-selection check rather than guessed at.
+ */
+import { rewriteBypassedNodes } from "@nodetool-ai/kernel";
+import { collectModelProviders, collectModelSelectionIssues } from "@nodetool-ai/node-sdk";
+import { getProviderSecretKey, isProviderConfigured, listOfflineModelIds, listRegisteredProviderIds } from "@nodetool-ai/runtime";
+import { normalizeGraph } from "./normalize-graph.js";
+import { isRecord } from "./predicates.js";
+/** The catalogs of the process-wide provider registry. */
+export const RUNTIME_CATALOGS = {
+    listProviderIds: () => listRegisteredProviderIds(),
+    listModelIds: (provider, modelType) => listOfflineModelIds(provider, modelType)
+};
+/** Model selections in a graph that no configured provider can honour. */
+export function modelSelectionErrors(graph, catalogs = RUNTIME_CATALOGS) {
+    const nodes = graph.nodes;
+    if (!Array.isArray(nodes))
+        return [];
+    return collectModelSelectionIssues({ nodes: nodes }, catalogs)
+        .filter((issue) => issue.severity === "error")
+        .map((issue) => `Node "${issue.nodeId}" (${issue.nodeType}): ${issue.message}`);
+}
+/**
+ * Providers a graph selects whose required credentials this runtime cannot
+ * resolve, one message each.
+ *
+ * The provider registry knows exactly which kwargs are load-bearing (an empty
+ * declaration means "resolve from store, then env"), and a provider built
+ * without one throws the `*_API_KEY is required` error mid-run that this check
+ * exists to front-run. Unregistered ids are skipped: the model-selection check
+ * already reports those as errors, and guessing at an unknown provider's
+ * credentials would be noise.
+ */
+export async function unconfiguredProviderErrors(graph, resolver, providerIds = listRegisteredProviderIds()) {
+    const nodes = graph.nodes;
+    if (!Array.isArray(nodes))
+        return [];
+    const graphNodes = nodes.filter(isRecord);
+    const graphEdges = Array.isArray(graph.edges)
+        ? graph.edges.filter(isRecord)
+        : [];
+    const effectiveGraph = rewriteBypassedNodes(normalizeGraph({ nodes: graphNodes, edges: graphEdges }));
+    const known = new Set(providerIds);
+    const errors = [];
+    for (const provider of collectModelProviders({
+        nodes: effectiveGraph.nodes,
+        edges: effectiveGraph.edges
+    })) {
+        if (!known.has(provider))
+            continue;
+        if (await isProviderConfigured(provider, (key) => resolver.resolveSecret(key))) {
+            continue;
+        }
+        const keyName = getProviderSecretKey(provider);
+        errors.push(keyName
+            ? `Provider "${provider}" needs "${keyName}", which is not set on ` +
+                "this server. Store the secret " +
+                `"${keyName}" for this user (Settings → Credentials), or switch ` +
+                "the model to a provider you have configured."
+            : `Provider "${provider}" is missing its required configuration ` +
+                "(base URL or credential) on this server. Complete it in " +
+                "Settings → Providers before running.");
+    }
+    return errors;
+}
+/** A checker over an explicit provider list, for a host with its own registry. */
+export function providerConfigurationChecker(providerIds) {
+    return (graph, resolver) => unconfiguredProviderErrors(graph, resolver, providerIds);
+}
+const HEADINGS = {
+    model: "Workflow selects providers or models this runtime cannot honour:",
+    credential: "Workflow selects providers whose credentials are not configured:"
+};
+/** The refusal text every host prints — one section per issue kind. */
+export function formatPreflightDetail(issues) {
+    const sections = [];
+    for (const kind of ["model", "credential"]) {
+        const messages = issues
+            .filter((issue) => issue.kind === kind)
+            .map((issue) => issue.message);
+        if (messages.length > 0) {
+            sections.push(`${HEADINGS[kind]}\n${messages.join("\n")}`);
+        }
+    }
+    return sections.join("\n\n");
+}
+/**
+ * The refusal contract shared by `ExecutionSession`, the run service, and the
+ * CLI adapters: a typed error whose `issues` are machine-readable and whose
+ * `message` is the text a host prints verbatim.
+ */
+export class ExecutionPreflightError extends Error {
+    name = "ExecutionPreflightError";
+    issues;
+    constructor(issues) {
+        super(formatPreflightDetail(issues));
+        this.issues = issues;
+    }
+}
+export function isExecutionPreflightError(value) {
+    return value instanceof ExecutionPreflightError;
+}
+/**
+ * Every reason to refuse `graph`, model selections first.
+ *
+ * A graph whose model selections are already unhonourable stops there: a
+ * provider that is not registered has no credentials to check, so running the
+ * second check would only add noise to a refusal that is already decided.
+ */
+export async function collectPreflightIssues(graph, options) {
+    const models = modelSelectionErrors(graph, options.catalogs);
+    if (models.length > 0) {
+        return models.map((message) => ({ kind: "model", message }));
+    }
+    const checker = options.providerConfiguration ?? unconfiguredProviderErrors;
+    const credentials = await checker(graph, {
+        resolveSecret: options.resolveSecret
+    });
+    return credentials.map((message) => ({ kind: "credential", message }));
+}
+/** {@link collectPreflightIssues}, as a refusal. */
+export async function assertPreflight(graph, options) {
+    const issues = await collectPreflightIssues(graph, options);
+    if (issues.length > 0)
+        throw new ExecutionPreflightError(issues);
+}
+//# sourceMappingURL=preflight.js.map

package/dist/preflight.js.map

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

package/dist/provider-secret-key.d.ts

@@ -0,0 +1,3 @@
+/** Resolve FAL's configured key for both its node and generic provider IDs. */
+export declare function providerBillingSecretKey(provider: string): string;
+//# sourceMappingURL=provider-secret-key.d.ts.map

package/dist/provider-secret-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-secret-key.d.ts","sourceRoot":"","sources":["../src/provider-secret-key.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIjE"}

package/dist/provider-secret-key.js

@@ -0,0 +1,7 @@
+/** Resolve FAL's configured key for both its node and generic provider IDs. */
+export function providerBillingSecretKey(provider) {
+    return provider === "fal_ai"
+        ? "FAL_API_KEY"
+        : `${provider.toUpperCase()}_API_KEY`;
+}
+//# sourceMappingURL=provider-secret-key.js.map

package/dist/provider-secret-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-secret-key.js","sourceRoot":"","sources":["../src/provider-secret-key.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,OAAO,QAAQ,KAAK,QAAQ;QAC1B,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,GAAG,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;AAC1C,CAAC"}

package/dist/service/app-debug-service.d.ts

@@ -0,0 +1,78 @@
+/**
+ * `nodetool app debug` as a service — the engine behind
+ * `POST /api/applications/debug` and the `debug_app` agent tool.
+ *
+ * The simulation itself is `simulateApp`, unchanged: this module supplies the
+ * three things it cannot get for itself — the target (an application row, or
+ * the document the caller posted inline), the workflow loader its operations
+ * resolve against, and a kernel runner for the runs.
+ *
+ * The inline `document` path is the one that matters for an editor assistant.
+ * A draft lives in the browser until the user saves, so anything keyed on
+ * `application_id` grades a stale row — a verdict that lies exactly when the
+ * assistant is mid-edit.
+ *
+ * A run with `run: true` executes real workflows, so it can take minutes:
+ * `poll: true` fronts it with the same session registry a build uses. A
+ * simulation parks no escalations, so its session only ever reports `running`
+ * or `done`.
+ */
+import type { JsScriptOperationRunner } from "../app-debug/script-operation.js";
+import type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import type { StorageAdapter } from "@nodetool-ai/runtime";
+import type { AppWorkflowRecord, InteractionStep } from "../app-debug/index.js";
+/**
+ * A refusal the caller turns into its own transport error. `code` is the
+ * vocabulary the HTTP layer maps onto `ApiErrorCode`; nothing here knows about
+ * Fastify or tRPC.
+ */
+export declare class AppServiceError extends Error {
+    readonly code: "invalid_input" | "not_found";
+    constructor(code: "invalid_input" | "not_found", message: string);
+}
+/** The request body of `POST /api/applications/debug`. */
+export interface AppDebugRequest {
+    /** A saved application, read from the row. Either this or `document`. */
+    application_id?: string;
+    /** The live draft, verbatim. Either this or `application_id`. */
+    document?: unknown;
+    /** Reactive values applied before the interactions, keyed by input name. */
+    params?: Record<string, unknown>;
+    /** The interaction script. Omitted, the app's natural run trigger fires. */
+    interact?: InteractionStep[];
+    /** Execute workflow runs (default true). false = static wiring check only. */
+    run?: boolean;
+    /** Per-run timeout, ms. */
+    timeout_ms?: number;
+    /**
+     * Return a session id as soon as the simulation starts instead of holding
+     * the request open for it. The caller then polls the debug-session endpoints.
+     */
+    poll?: boolean;
+}
+/** Test seams. Production passes none of these. */
+export interface AppDebugDeps {
+    registry?: NodeRegistry;
+    /** Load a workflow's graph by id, scoped to the user. */
+    loadWorkflow?: (userId: string, id: string) => Promise<AppWorkflowRecord | null>;
+    /** Load an application row by id. */
+    loadApplication?: (userId: string, id: string) => Promise<{
+        id: string;
+        name: string;
+        document: unknown;
+    } | null>;
+    /**
+     * Execute a script operation. Running a sandbox body lives above this
+     * package, so a host that wants script operations passes one in; without it
+     * such an operation reports as unexecutable instead of being skipped.
+     */
+    runScript?: JsScriptOperationRunner;
+    /** The store `asset://<id>` inputs in the app's workflows resolve through. */
+    assetStorage?: StorageAdapter | null;
+}
+/**
+ * Debug an app. Resolves with the compacted report (plus the session id), or —
+ * with `poll: true` — with the session id as soon as the run is under way.
+ */
+export declare function runApplicationDebug(userId: string, body: AppDebugRequest, defaultRegistry: NodeRegistry, deps?: AppDebugDeps): Promise<Record<string, unknown>>;
+//# sourceMappingURL=app-debug-service.d.ts.map

package/dist/service/app-debug-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-debug-service.d.ts","sourceRoot":"","sources":["../../src/service/app-debug-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAUH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAO3D,OAAO,KAAK,EAEV,iBAAiB,EACjB,eAAe,EAEhB,MAAM,uBAAuB,CAAC;AAc/B;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IAEtC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW;IAD9C,YACW,IAAI,EAAE,eAAe,GAAG,WAAW,EAC5C,OAAO,EAAE,MAAM,EAIhB;CACF;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,8EAA8E;IAC9E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,mDAAmD;AACnD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,yDAAyD;IACzD,YAAY,CAAC,EAAE,CACb,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,KACP,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACvC,qCAAqC;IACrC,eAAe,CAAC,EAAE,CAChB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,KACP,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACrE;;;;OAIG;IACH,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,8EAA8E;IAC9E,YAAY,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACtC;AAmHD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,eAAe,EACrB,eAAe,EAAE,YAAY,EAC7B,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwFlC"}