@nodetool-ai/execution 0.8.1 → 0.8.3

package/dist/partial-run.js

@@ -0,0 +1,300 @@
+/**
+ * Narrow a runnable graph to the nodes a caller asked for, the server-side
+ * counterpart of the editor's "Run Node" and "Run selected".
+ *
+ * The run keeps the named nodes plus what they need upstream. Unrelated
+ * branches and downstream nodes are dropped. An upstream node that auto-saves
+ * its generations (`auto_save_asset`: image, video, audio and LLM generators,
+ * the nodes a provider bills) is not run again when it has a previous
+ * generation: its saved output is written into the consuming node's property
+ * in place of the edge, the way `buildRunSubgraph` in `web/src/utils` inlines
+ * a generation's output. Inputs mixing cached and live edges rerun every
+ * contributor so live values cannot overwrite cached ones. Everything else
+ * upstream runs.
+ */
+import { getAssetFileName } from "@nodetool-ai/protocol";
+/** The ids in `nodeIds` that name no node of `graph`. */
+export function unknownNodeIds(graph, nodeIds) {
+    const known = new Set(graph.nodes.map((n) => n.id));
+    return nodeIds.filter((id) => !known.has(id));
+}
+/**
+ * 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 function generationOutputFor(outputs, handle) {
+    if (handle && Object.hasOwn(outputs, handle))
+        return outputs[handle];
+    const keys = Object.keys(outputs);
+    return keys.length === 1 ? outputs[keys[0]] : undefined;
+}
+const isListType = (type) => type?.type === "list";
+/** Whether the target's input `handle` takes a list, so edges aggregate. */
+function inputIsList(node, handle, metadata) {
+    const declared = metadata?.properties.find((p) => p.name === handle)?.type;
+    if (declared)
+        return isListType(declared);
+    const slot = node.dynamic_inputs?.[handle];
+    return isListType(slot?.type);
+}
+/** Write inlined values into a node, keeping dynamic inputs dynamic. */
+function withInlinedInputs(node, values) {
+    const properties = { ...node.properties };
+    const dynamic = node.dynamic_properties
+        ? { ...node.dynamic_properties }
+        : undefined;
+    for (const [handle, value] of values) {
+        if (dynamic && Object.hasOwn(dynamic, handle)) {
+            dynamic[handle] = value;
+        }
+        else {
+            properties[handle] = value;
+        }
+    }
+    return dynamic
+        ? { ...node, properties, dynamic_properties: dynamic }
+        : { ...node, properties };
+}
+export async function planPartialRun(graph, nodeIds, deps) {
+    const unknown = unknownNodeIds(graph, nodeIds);
+    if (unknown.length > 0) {
+        return { kind: "unknown_nodes", ids: unknown };
+    }
+    const nodeById = new Map(graph.nodes.map((n) => [n.id, n]));
+    const inbound = new Map();
+    const outbound = new Map();
+    for (const edge of graph.edges) {
+        const list = inbound.get(edge.target);
+        if (list)
+            list.push(edge);
+        else
+            inbound.set(edge.target, [edge]);
+        const outgoing = outbound.get(edge.source);
+        if (outgoing)
+            outgoing.push(edge);
+        else
+            outbound.set(edge.source, [edge]);
+    }
+    const targets = new Set(nodeIds);
+    const keep = new Set(nodeIds);
+    const previous = new Map();
+    const previousOf = (node, metadata) => {
+        let pending = previous.get(node.id);
+        if (!pending) {
+            pending = deps.loadPreviousGeneration(node, metadata);
+            previous.set(node.id, pending);
+        }
+        return pending;
+    };
+    // Edges whose source is served from a previous generation. Only applied
+    // when the source does not end up running for another reason.
+    const inlined = [];
+    const stack = [...nodeIds];
+    const groups = new Map();
+    const groupOf = (edge) => {
+        const key = JSON.stringify([edge.target, edge.targetHandle]);
+        let group = groups.get(key);
+        if (!group) {
+            group = { live: false, cached: [] };
+            groups.set(key, group);
+        }
+        return group;
+    };
+    const requireRun = (id) => {
+        if (!keep.has(id)) {
+            keep.add(id);
+            stack.push(id);
+        }
+    };
+    const markLive = (edge) => {
+        if (edge.edge_type === "control" || !edge.targetHandle) {
+            return;
+        }
+        const group = groupOf(edge);
+        if (group.live) {
+            return;
+        }
+        group.live = true;
+        // Edge inputs replace properties in the kernel. A mixed input must run
+        // every contributor, otherwise a live edge discards the cached values.
+        for (const cached of group.cached) {
+            requireRun(cached.source);
+        }
+    };
+    while (stack.length > 0) {
+        const id = stack.pop();
+        for (const edge of outbound.get(id) ?? []) {
+            if (keep.has(edge.target)) {
+                markLive(edge);
+            }
+        }
+        for (const edge of inbound.get(id) ?? []) {
+            const source = nodeById.get(edge.source);
+            if (!source)
+                continue;
+            if (keep.has(source.id)) {
+                markLive(edge);
+                continue;
+            }
+            const metadata = deps.getMetadata(source.type);
+            if (deps.loadPreviousGeneration &&
+                metadata?.auto_save_asset &&
+                !targets.has(source.id) &&
+                edge.edge_type !== "control" &&
+                edge.targetHandle) {
+                const generation = await previousOf(source, metadata);
+                const value = generation
+                    ? generationOutputFor(generation.outputs, edge.sourceHandle)
+                    : undefined;
+                if (value !== undefined) {
+                    const group = groupOf(edge);
+                    if (!group.live) {
+                        group.cached.push(edge);
+                        inlined.push({ edge, value });
+                        continue;
+                    }
+                }
+            }
+            requireRun(source.id);
+            markLive(edge);
+        }
+    }
+    const valuesByTarget = new Map();
+    const reused = new Map();
+    for (const { edge, value } of inlined) {
+        // A source that runs anyway feeds this edge itself.
+        if (keep.has(edge.source))
+            continue;
+        const handle = edge.targetHandle;
+        let handles = valuesByTarget.get(edge.target);
+        if (!handles) {
+            handles = new Map();
+            valuesByTarget.set(edge.target, handles);
+        }
+        handles.set(handle, [...(handles.get(handle) ?? []), value]);
+        if (!reused.has(edge.source)) {
+            const generation = await previous.get(edge.source);
+            reused.set(edge.source, {
+                node_id: edge.source,
+                job_id: generation?.jobId ?? null,
+                asset_ids: generation?.assetIds ?? []
+            });
+        }
+    }
+    const nodes = graph.nodes
+        .filter((n) => keep.has(n.id))
+        .map((node) => {
+        const handles = valuesByTarget.get(node.id);
+        if (!handles)
+            return node;
+        const metadata = deps.getMetadata(node.type);
+        const values = new Map();
+        for (const [handle, list] of handles) {
+            // Several edges into a list input aggregate, as the kernel does;
+            // anywhere else the last edge wins.
+            values.set(handle, list.length > 1 && inputIsList(node, handle, metadata)
+                ? list
+                : list[list.length - 1]);
+        }
+        return withInlinedInputs(node, values);
+    });
+    return {
+        kind: "graph",
+        graph: {
+            nodes,
+            edges: graph.edges.filter((e) => keep.has(e.source) && keep.has(e.target))
+        },
+        ran: graph.nodes.filter((n) => keep.has(n.id)).map((n) => n.id),
+        reused: [...reused.values()]
+    };
+}
+const MEDIA_REF_TYPES = [
+    ["image/", "image"],
+    ["video/", "video"],
+    ["audio/", "audio"],
+    ["model/", "model_3d"]
+];
+function mediaRefType(contentType) {
+    return MEDIA_REF_TYPES.find(([prefix]) => contentType.startsWith(prefix))?.[1] ?? null;
+}
+function generationIndexOf(row) {
+    return row.metadata?.["generation_index"];
+}
+/** The node's primary output name: `primary_output`, else the first output. */
+function primaryOutputName(metadata) {
+    return metadata.primary_output ?? metadata.outputs[0]?.name ?? "output";
+}
+/**
+ * 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 function previousGenerationFromAssets(rows, metadata, pinnedId) {
+    const chosen = pinnedId ? rows.find((r) => r.id === pinnedId) : rows[0];
+    if (!chosen)
+        return null;
+    const members = (chosen.job_id
+        ? rows.filter((r) => r.job_id === chosen.job_id &&
+            generationIndexOf(r) === generationIndexOf(chosen))
+        : [chosen])
+        // Rows arrive newest first; a list output keeps the order it was saved in.
+        .slice()
+        .reverse();
+    const outputs = {};
+    const media = new Map();
+    for (const row of members) {
+        const ct = row.content_type ?? "";
+        const meta = row.metadata ?? {};
+        const refType = mediaRefType(ct);
+        if (refType) {
+            const handle = typeof meta["output_name"] === "string"
+                ? meta["output_name"]
+                : primaryOutputName(metadata);
+            media.set(handle, [
+                ...(media.get(handle) ?? []),
+                {
+                    type: refType,
+                    uri: `asset://${getAssetFileName(row.id, ct)}`,
+                    asset_id: row.id
+                }
+            ]);
+        }
+        else if (ct.startsWith("text/")) {
+            const text = meta["text"];
+            if (typeof text !== "string")
+                continue;
+            // The inline copy is capped; a truncated one is not the output.
+            const bytes = Buffer.byteLength(text, "utf8");
+            if (row.size !== null && row.size !== bytes)
+                continue;
+            outputs[primaryOutputName(metadata)] = text;
+        }
+        else if (ct.includes("json")) {
+            const json = meta["json"];
+            if (json && typeof json === "object" && !Array.isArray(json)) {
+                Object.assign(outputs, json);
+            }
+        }
+    }
+    for (const [handle, refs] of media) {
+        const declared = metadata.outputs.find((o) => o.name === handle)?.type;
+        outputs[handle] = isListType(declared) ? refs : refs[refs.length - 1];
+    }
+    if (Object.keys(outputs).length === 0)
+        return null;
+    return {
+        outputs,
+        jobId: chosen.job_id,
+        assetIds: members.map((r) => r.id)
+    };
+}
+//# sourceMappingURL=partial-run.js.map

package/dist/partial-run.js.map

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

package/dist/preflight.d.ts

@@ -1,3 +1,4 @@
+import { type NodeDescriptor } from "@nodetool-ai/protocol";
 /** Provider/model catalogs the preflight checks a graph's selections against. */
 export interface RunModelCatalogs {
     listProviderIds: () => readonly string[];
@@ -9,6 +10,26 @@ export declare const RUNTIME_CATALOGS: RunModelCatalogs;
 export declare function modelSelectionErrors(graph: {
     nodes?: unknown;
 }, catalogs?: RunModelCatalogs): string[];
+/** The part of a node registry the unset-model check reads. */
+export interface NodeModelValidator {
+    validateNode: (descriptor: NodeDescriptor, connectedHandles: ReadonlySet<string>) => ReadonlyArray<{
+        code?: string;
+        message: string;
+    }>;
+}
+/**
+ * Model properties a graph leaves unselected, one message each.
+ *
+ * A workflow may be saved with a generator whose model is not picked yet (a
+ * board that plans generations), so this is where an unpicked model is
+ * refused: before the run, instead of at the node after everything upstream
+ * of it ran and billed. A property fed by a data edge is supplied at run time,
+ * and a bypassed node never runs, so neither is reported.
+ */
+export declare function unsetModelErrors(graph: {
+    nodes?: unknown;
+    edges?: unknown;
+}, registry: NodeModelValidator): 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;
@@ -43,7 +64,7 @@ export type ProviderConfigurationChecker = (graph: {
 }, 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";
+export type PreflightIssueKind = "unset_model" | "model" | "credential";
 /** One reason a run was refused before it started. */
 export interface ExecutionPreflightIssue {
     kind: PreflightIssueKind;
@@ -64,14 +85,34 @@ export declare class ExecutionPreflightError extends Error {
 export declare function isExecutionPreflightError(value: unknown): value is ExecutionPreflightError;
 export interface PreflightOptions {
     catalogs?: RunModelCatalogs;
+    /**
+     * The run's params. An input node the run fills is checked with the value
+     * it receives, so a default the run replaces never refuses it.
+     */
+    params?: Record<string, unknown>;
     providerConfiguration?: ProviderConfigurationChecker;
     /** Resolves a credential the way the coming run will. */
     resolveSecret: CredentialResolver["resolveSecret"];
+    /**
+     * Node registry for the unset-model check. Without one, unpicked models are
+     * left to the kernel's own node validation.
+     */
+    registry?: NodeModelValidator;
 }
+/**
+ * `graph` with each input node's value replaced by the param the run passes
+ * for it, by the rule the kernel dispatches inputs with: a `nodetool.input.*`
+ * node takes the param under its `name`, and an undefined param keeps the
+ * default.
+ */
+export declare function withRunParams<G extends {
+    nodes?: unknown;
+    edges?: unknown;
+}>(graph: G, params: Record<string, unknown> | undefined): G;
 /**
  * Every reason to refuse `graph`, model selections first.
  *
- * A graph whose model selections are already unhonourable stops there: a
+ * A graph whose model selections are unset or 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.
  */

package/dist/preflight.d.ts.map

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

package/dist/preflight.js

@@ -14,6 +14,7 @@
  * model-selection check rather than guessed at.
  */
 import { rewriteBypassedNodes } from "@nodetool-ai/kernel";
+import { isDataEdge } from "@nodetool-ai/protocol";
 import { collectModelProviders, collectModelSelectionIssues } from "@nodetool-ai/node-sdk";
 import { getProviderSecretKey, isProviderConfigured, listOfflineModelIds, listRegisteredProviderIds } from "@nodetool-ai/runtime";
 import { normalizeGraph } from "./normalize-graph.js";
@@ -32,6 +33,42 @@ export function modelSelectionErrors(graph, catalogs = RUNTIME_CATALOGS) {
         .filter((issue) => issue.severity === "error")
         .map((issue) => `Node "${issue.nodeId}" (${issue.nodeType}): ${issue.message}`);
 }
+/**
+ * Model properties a graph leaves unselected, one message each.
+ *
+ * A workflow may be saved with a generator whose model is not picked yet (a
+ * board that plans generations), so this is where an unpicked model is
+ * refused: before the run, instead of at the node after everything upstream
+ * of it ran and billed. A property fed by a data edge is supplied at run time,
+ * and a bypassed node never runs, so neither is reported.
+ */
+export function unsetModelErrors(graph, registry) {
+    const nodes = graph.nodes;
+    if (!Array.isArray(nodes))
+        return [];
+    const effectiveGraph = rewriteBypassedNodes(normalizeGraph({
+        nodes: nodes.filter(isRecord),
+        edges: Array.isArray(graph.edges) ? graph.edges.filter(isRecord) : []
+    }));
+    const connected = new Map();
+    for (const edge of effectiveGraph.edges) {
+        if (!isDataEdge(edge))
+            continue;
+        const handles = connected.get(edge.target) ?? new Set();
+        handles.add(edge.targetHandle);
+        connected.set(edge.target, handles);
+    }
+    const errors = [];
+    for (const node of effectiveGraph.nodes) {
+        const issues = registry.validateNode(node, connected.get(node.id) ?? new Set());
+        for (const issue of issues) {
+            if (issue.code !== "unset_model")
+                continue;
+            errors.push(`Node "${node.id}" (${node.type}): ${issue.message}`);
+        }
+    }
+    return errors;
+}
 /**
  * Providers a graph selects whose required credentials this runtime cannot
  * resolve, one message each.
@@ -80,13 +117,14 @@ export function providerConfigurationChecker(providerIds) {
     return (graph, resolver) => unconfiguredProviderErrors(graph, resolver, providerIds);
 }
 const HEADINGS = {
+    unset_model: "Workflow leaves model properties unselected. Pick a model on each before running:",
     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"]) {
+    for (const kind of ["unset_model", "model", "credential"]) {
         const messages = issues
             .filter((issue) => issue.kind === kind)
             .map((issue) => issue.message);
@@ -112,17 +150,53 @@ export class ExecutionPreflightError extends Error {
 export function isExecutionPreflightError(value) {
     return value instanceof ExecutionPreflightError;
 }
+/**
+ * `graph` with each input node's value replaced by the param the run passes
+ * for it, by the rule the kernel dispatches inputs with: a `nodetool.input.*`
+ * node takes the param under its `name`, and an undefined param keeps the
+ * default.
+ */
+export function withRunParams(graph, params) {
+    const nodes = graph.nodes;
+    if (!params || !Array.isArray(nodes))
+        return graph;
+    return {
+        ...graph,
+        nodes: nodes.map((node) => {
+            if (!isRecord(node) ||
+                typeof node.type !== "string" ||
+                !node.type.startsWith("nodetool.input.")) {
+                return node;
+            }
+            const properties = isRecord(node.properties) ? node.properties : {};
+            const propertyName = typeof properties.name === "string" ? properties.name.trim() : "";
+            const name = propertyName ||
+                (typeof node.name === "string" ? node.name : String(node.id));
+            if (!Object.hasOwn(params, name) || params[name] === undefined) {
+                return node;
+            }
+            return { ...node, properties: { ...properties, value: params[name] } };
+        })
+    };
+}
 /**
  * Every reason to refuse `graph`, model selections first.
  *
- * A graph whose model selections are already unhonourable stops there: a
+ * A graph whose model selections are unset or 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) {
+    graph = withRunParams(graph, options.params);
+    const unset = options.registry
+        ? unsetModelErrors(graph, options.registry)
+        : [];
     const models = modelSelectionErrors(graph, options.catalogs);
-    if (models.length > 0) {
-        return models.map((message) => ({ kind: "model", message }));
+    if (unset.length > 0 || models.length > 0) {
+        return [
+            ...unset.map((message) => ({ kind: "unset_model", message })),
+            ...models.map((message) => ({ kind: "model", message }))
+        ];
     }
     const checker = options.providerConfiguration ?? unconfiguredProviderErrors;
     const credentials = await checker(graph, {

package/dist/preflight.js.map

@@ -1 +1 @@
-{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAW3C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,eAAe,EAAE,GAAG,EAAE,CAAC,yBAAyB,EAAE;IAClD,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,CACpC,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC3C,CAAC;AAEF,0EAA0E;AAC1E,MAAM,UAAU,oBAAoB,CAClC,KAA0B,EAC1B,QAAQ,GAAqB,gBAAgB;IAE7C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,2BAA2B,CAAC,EAAE,KAAK,EAAE,KAAgB,EAAE,EAAE,QAAQ,CAAC;SACtE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC;SAC7C,GAAG,CACF,CAAC,KAAK,EAAE,EAAE,CAAC,SAAS,KAAK,CAAC,MAAM,MAAM,KAAK,CAAC,QAAQ,MAAM,KAAK,CAAC,OAAO,EAAE,CAC1E,CAAC;AACN,CAAC;AASD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,KAA2C,EAC3C,QAA4B,EAC5B,WAAW,GAAsB,yBAAyB,EAAE;IAE5D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAC3C,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC9B,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,cAAc,GAAG,oBAAoB,CACzC,cAAc,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CACzD,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IACnC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,QAAQ,IAAI,qBAAqB,CAAC;QAC3C,KAAK,EAAE,cAAc,CAAC,KAAK;QAC3B,KAAK,EAAE,cAAc,CAAC,KAAK;KAC5B,CAAC,EAAE,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS;QACnC,IACE,MAAM,oBAAoB,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,EAC1E,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CACT,OAAO;YACL,CAAC,CAAC,aAAa,QAAQ,YAAY,OAAO,yBAAyB;gBAC/D,gCAAgC;gBAChC,IAAI,OAAO,sDAAsD;gBACjE,8CAA8C;YAClD,CAAC,CAAC,aAAa,QAAQ,0CAA0C;gBAC7D,0DAA0D;gBAC1D,sCAAsC,CAC7C,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAgBD,kFAAkF;AAClF,MAAM,UAAU,4BAA4B,CAC1C,WAA8B;IAE9B,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CACzB,0BAA0B,CAAC,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC7D,CAAC;AAUD,MAAM,QAAQ,GAAG;IACf,KAAK,EAAE,kEAAkE;IACzE,UAAU,EAAE,kEAAkE;CAClC,CAAC;AAE/C,uEAAuE;AACvE,MAAM,UAAU,qBAAqB,CACnC,MAA0C;IAE1C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,YAAY,CAAU,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,MAAM;aACpB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;aACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9B,IAAI,GAAG,yBAAyB,CAAC;IAC1C,MAAM,CAAqC;IAEpD,YAAY,MAA0C;QACpD,KAAK,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAc;IAEd,OAAO,KAAK,YAAY,uBAAuB,CAAC;AAClD,CAAC;AASD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,KAA2C,EAC3C,OAAyB;IAEzB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,qBAAqB,IAAI,0BAA0B,CAAC;IAC5E,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE;QACvC,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAC;IACH,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,oDAAoD;AACpD,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA2C,EAC3C,OAAyB;IAEzB,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,uBAAuB,CAAC,MAAM,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"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"}

package/dist/run-trace-store.d.ts

@@ -0,0 +1,9 @@
+import type { StoredRunTraceUpdate } from "@nodetool-ai/protocol";
+export type RunTraceUpdateListener = (userId: string, update: StoredRunTraceUpdate) => void;
+/** Subscribe to committed, sanitized snapshots. Transport hosts still enforce ownership. */
+export declare function subscribeRunTraceUpdates(listener: RunTraceUpdateListener): () => void;
+/** Publish only records already committed and sanitized by the run store. */
+export declare function publishCommittedRunTraceUpdate(userId: string, update: StoredRunTraceUpdate): void;
+/** Install the database bridge even if an external sink initialized telemetry first. */
+export declare function ensureRunTraceTelemetry(): Promise<void>;
+//# sourceMappingURL=run-trace-store.d.ts.map

package/dist/run-trace-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-trace-store.d.ts","sourceRoot":"","sources":["../src/run-trace-store.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,MAAM,MAAM,sBAAsB,GAAG,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,KACzB,IAAI,CAAC;AAKV,4FAA4F;AAC5F,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI,CAGrF;AAED,6EAA6E;AAC7E,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAKjG;AAoCD,wFAAwF;AACxF,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM7D"}

package/dist/run-trace-store.js

@@ -0,0 +1,57 @@
+import { getRegisteredTrace, getRunTrace, markRunTraceIncomplete, sanitizeRunTraceRecord, writeRunTraceUpdate } from "@nodetool-ai/models";
+import { configureRunTraceStore, initTelemetry } from "@nodetool-ai/runtime";
+const listeners = new Set();
+let configured = false;
+/** Subscribe to committed, sanitized snapshots. Transport hosts still enforce ownership. */
+export function subscribeRunTraceUpdates(listener) {
+    listeners.add(listener);
+    return () => { listeners.delete(listener); };
+}
+/** Publish only records already committed and sanitized by the run store. */
+export function publishCommittedRunTraceUpdate(userId, update) {
+    for (const listener of listeners) {
+        try {
+            listener(userId, update);
+        }
+        catch { /* A disconnected reader cannot fail durable recording. */ }
+    }
+}
+const adapter = {
+    lookup: getRegisteredTrace,
+    sanitize: sanitizeRunTraceRecord,
+    async write(updates) {
+        for (const write of updates) {
+            const registration = write.userId && write.runId
+                ? await getRunTrace(write.userId, write.runId)
+                : await getRegisteredTrace(write.update.record.trace_id);
+            if (!registration || registration.trace_id !== write.update.record.trace_id) {
+                continue;
+            }
+            const committed = await writeRunTraceUpdate(registration.user_id, registration.id, write.update, {
+                secretValues: write.secretValues,
+                contentSuppressed: write.contentSuppressed,
+                isRoot: write.isRoot
+            });
+            if (!committed) {
+                continue;
+            }
+            publishCommittedRunTraceUpdate(registration.user_id, committed);
+        }
+    },
+    async markIncomplete(traceId, reason) {
+        const registration = await getRegisteredTrace(traceId);
+        if (registration) {
+            await markRunTraceIncomplete(registration.user_id, traceId, reason);
+        }
+    },
+    async flush() { }
+};
+/** Install the database bridge even if an external sink initialized telemetry first. */
+export async function ensureRunTraceTelemetry() {
+    if (!configured) {
+        configureRunTraceStore(adapter);
+        configured = true;
+    }
+    await initTelemetry();
+}
+//# sourceMappingURL=run-trace-store.js.map

package/dist/run-trace-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-trace-store.js","sourceRoot":"","sources":["../src/run-trace-store.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,aAAa,EAEd,MAAM,sBAAsB,CAAC;AAQ9B,MAAM,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;AACpD,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,4FAA4F;AAC5F,MAAM,UAAU,wBAAwB,CAAC,QAAgC;IACvE,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,8BAA8B,CAAC,MAAc,EAAE,MAA4B;IACzF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QACjC,MAAM,CAAC,CAAC,0DAA0D,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAkB;IAC7B,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,sBAAsB;IAChC,KAAK,CAAC,KAAK,CAAC,OAAO;QACjB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK;gBAC9C,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC;gBAC9C,CAAC,CAAC,MAAM,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3D,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,QAAQ,KAAK,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBAC5E,SAAS;YACX,CAAC;YACD,MAAM,SAAS,GAAG,MAAM,mBAAmB,CACzC,YAAY,CAAC,OAAO,EACpB,YAAY,CAAC,EAAE,EACf,KAAK,CAAC,MAAM,EACZ;gBACE,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;gBAC1C,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CACF,CAAC;YACF,IAAI,CAAC,SAAS,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC7B,8BAA8B,CAAC,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IACD,KAAK,CAAC,cAAc,CAAC,OAAO,EAAE,MAAM;QAClC,MAAM,YAAY,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,sBAAsB,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IACD,KAAK,CAAC,KAAK,KAAiE,CAAC;CAC9E,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,sBAAsB,CAAC,OAAO,CAAC,CAAC;QAChC,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,MAAM,aAAa,EAAE,CAAC;AACxB,CAAC"}

package/dist/runs.d.ts

@@ -0,0 +1,16 @@
+import { type RunListOptions, type RunGetOptions, type RunTraceOptions, type RunLogsOptions, type RunAwaitOptions, type RunUpdatesOptions, type GetRunResult, type ListRunsResult, type GetRunTraceResult, type GetRunLogsResult, type RunUpdatesResult, type RunTraceRegistration } from "@nodetool-ai/protocol";
+export declare class RunsError extends Error {
+    readonly code: "not_found" | "ambiguous" | "invalid_input" | "timeout" | "aborted";
+    constructor(code: "not_found" | "ambiguous" | "invalid_input" | "timeout" | "aborted", message: string);
+}
+export declare function findRunForSource(userId: string, kind: RunTraceRegistration["kind"], sourceId: string): Promise<RunTraceRegistration | null>;
+export declare function listRuns(userId: string, options?: RunListOptions): Promise<ListRunsResult>;
+export declare function getRun(userId: string, id: string, options?: RunGetOptions): Promise<GetRunResult>;
+export declare function getRunTrace(userId: string, id: string, options?: RunTraceOptions): Promise<GetRunTraceResult>;
+export declare function getRunLogs(userId: string, id: string, options?: RunLogsOptions): Promise<GetRunLogsResult>;
+/** Polling reads latest snapshots. It deliberately never promises append-only replay. */
+export declare function readRunUpdates(userId: string, id: string, options?: RunUpdatesOptions): Promise<RunUpdatesResult>;
+export declare function awaitRun(userId: string, id: string, options?: RunAwaitOptions & {
+    signal?: AbortSignal;
+}): Promise<GetRunResult>;
+//# sourceMappingURL=runs.d.ts.map