@nodetool-ai/execution 0.8.1

package/dist/cost-ledger.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Provider-spend ledger — the write half of `nodetool costs`.
+ *
+ * `BaseProvider` accounts for chat and stream in tokens, and the host writes
+ * that row. Image, video and audio generation had no equivalent: the money went
+ * out and nothing reached the `predictions` table, so a render session read as
+ * free.
+ *
+ * Two kinds of generation reach a ledger row here:
+ *
+ * - A node that knows its own charge calls `context.setProviderCost()`, which
+ *   rides out on the completed `node_update` as `provider_cost`. FAL and kie do
+ *   this — the number comes from the provider, so it wins. When the provider
+ *   also exposes a request-keyed billing API, the estimate is reconciled to the
+ *   actual charge in the background.
+ * - Everything else goes through `ProcessingContext.runProviderPrediction` (and
+ *   its streaming/encoded siblings), which emits a `prediction` message
+ *   carrying provider, model, capability and the job's parameters. That is
+ *   priced here against `@nodetool-ai/model-pricing` — the same catalog the
+ *   editor's cost preview and the pre-run budget gate read.
+ *
+ * A model in no catalog still gets a row, with `cost` left null rather than set
+ * to zero: the call is visible in `nodetool costs`, and a null is countable as
+ * unpriced instead of summing as free. The units behind a price are recorded
+ * next to it (`billing_unit`, `quantity`, `unit_price`, `currency`, plus the
+ * catalog's own breakdown in `metadata`) so a per-second or per-megapixel row
+ * is auditable even when the estimate is imperfect.
+ */
+import { Prediction } from "@nodetool-ai/models";
+import type { ProcessingMessage, ProviderCost } from "@nodetool-ai/protocol";
+import { type GenerationTrackerState } from "./generation-tracker.js";
+/** Whether a capability is billed per unit of output (and so belongs here). */
+export declare function isUnitBilledCapability(capability: string | null | undefined): boolean;
+/** One generation to price and record. */
+export interface GenerationSpend {
+    userId: string;
+    provider: string;
+    model: string;
+    capability?: string | null;
+    /** Outputs produced — the multiplier on the catalog's per-run price. */
+    quantity?: number;
+    /** What the job stated, in provider parameter spelling (`duration_seconds`, `resolution`, …). */
+    params?: Record<string, unknown> | null;
+    nodeId?: string;
+    nodeType?: string;
+    workflowId?: string | null;
+    /** The project this run belongs to, when it has one. */
+    projectId?: string | null;
+    /** The project document this run is producing, when it names one. */
+    documentId?: string | null;
+    durationMs?: number | null;
+}
+/** What the catalog answered for a generation, or `null` when it knows no price. */
+export interface PricedGeneration {
+    cost: number;
+    unit_price: number;
+    quantity: number;
+    billing_unit: string;
+    currency: string;
+    /** The catalog's own reasoning, e.g. "5 s × $0.205/s at 720p". */
+    breakdown?: string;
+    /** What the catalog filled in because the job did not state it. */
+    assumptions?: string[];
+}
+/**
+ * Price a generation against the model catalogs. Returns `null` when no catalog
+ * carries the model, or when the catalog declines to extrapolate — a refusal is
+ * an answer, and inventing a number would be worse than recording none.
+ */
+export declare function priceGeneration(spend: GenerationSpend): PricedGeneration | null;
+/**
+ * Write one generation to the ledger. Best-effort: a host with no database
+ * (a hermetic run, an eval) must not fail because accounting could not be
+ * persisted — the generation already happened and was already billed.
+ */
+export declare function recordGenerationSpend(spend: GenerationSpend): Promise<Prediction | null>;
+/** A charge a node reported for itself, as it rides out on `node_update`. */
+export interface NodeCostSpend {
+    userId: string;
+    cost: ProviderCost;
+    nodeId: string;
+    nodeType: string;
+    workflowId: string | null;
+    /** The project this run belongs to, when it has one. */
+    projectId?: string | null;
+    /** The project document this run is producing, when it names one. */
+    documentId?: string | null;
+    /** Resolves the provider API key used to look the actual charge up, when one exists. */
+    resolveSecret?: (key: string) => Promise<string | null | undefined>;
+}
+/**
+ * Write a node-reported provider charge to the ledger, then refine it into the
+ * provider's actual billed amount in the background when that provider
+ * registered a reconciler. Best-effort throughout.
+ */
+export declare function recordNodeProviderCost(spend: NodeCostSpend): Promise<Prediction | null>;
+export interface RunCostLedgerOptions {
+    userId: string;
+    workflowId: string | null;
+    /**
+     * The project this run belongs to. Left unset outside a project, and the row
+     * then carries a null rather than being attributed to the loose bucket — a
+     * project's total counts only what named it.
+     */
+    projectId?: string | null;
+    /** The project document this run is producing, when the host names one. */
+    documentId?: string | null;
+    /** Node type for a node id, so a row names the node that spent the money. */
+    nodeType?: (nodeId: string) => string;
+    resolveSecret?: (key: string) => Promise<string | null | undefined>;
+}
+/**
+ * A `nodeType` lookup built once per run. Scanning the node list per message
+ * would be O(nodes × messages), which a 20 000-node graph feels.
+ */
+export declare function nodeTypeLookup(nodes: ReadonlyArray<{
+    id: string;
+    type: string;
+}>): (nodeId: string) => string;
+/** The slice of `ProcessingContext` the ledger listens on. */
+export interface CostLedgerSource {
+    addMessageListener(listener: (msg: ProcessingMessage) => void): () => void;
+}
+/**
+ * Record every generation a run pays for. Returns the detach function.
+ *
+ * Listens on the context rather than on a host's outbound message loop so each
+ * surface — CLI, ws server, app runtime, debug harness — records once, from the
+ * same seam, and cannot drift.
+ */
+export interface RunCostLedgerHandle {
+    /** Detach the listener. */
+    (): void;
+    /**
+     * Resolve once every write the listener has started so far has landed.
+     * The listener fires and forgets; a caller that reads the row right after
+     * the generation returned (a direct RPC answering its client) waits here.
+     */
+    settled(): Promise<void>;
+}
+export declare function attachRunCostLedger(context: CostLedgerSource, options: RunCostLedgerOptions): RunCostLedgerHandle;
+/**
+ * Ledger one run message: a node's self-reported charge, or a completed
+ * unit-billed prediction. Anything else is not spend and writes nothing.
+ */
+export declare function recordFromMessage(msg: ProcessingMessage, options: RunCostLedgerOptions, state?: GenerationTrackerState): Promise<void>;
+//# sourceMappingURL=cost-ledger.d.ts.map

package/dist/cost-ledger.d.ts.map

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

package/dist/cost-ledger.js

@@ -0,0 +1,288 @@
+/**
+ * Provider-spend ledger — the write half of `nodetool costs`.
+ *
+ * `BaseProvider` accounts for chat and stream in tokens, and the host writes
+ * that row. Image, video and audio generation had no equivalent: the money went
+ * out and nothing reached the `predictions` table, so a render session read as
+ * free.
+ *
+ * Two kinds of generation reach a ledger row here:
+ *
+ * - A node that knows its own charge calls `context.setProviderCost()`, which
+ *   rides out on the completed `node_update` as `provider_cost`. FAL and kie do
+ *   this — the number comes from the provider, so it wins. When the provider
+ *   also exposes a request-keyed billing API, the estimate is reconciled to the
+ *   actual charge in the background.
+ * - Everything else goes through `ProcessingContext.runProviderPrediction` (and
+ *   its streaming/encoded siblings), which emits a `prediction` message
+ *   carrying provider, model, capability and the job's parameters. That is
+ *   priced here against `@nodetool-ai/model-pricing` — the same catalog the
+ *   editor's cost preview and the pre-run budget gate read.
+ *
+ * A model in no catalog still gets a row, with `cost` left null rather than set
+ * to zero: the call is visible in `nodetool costs`, and a null is countable as
+ * unpriced instead of summing as free. The units behind a price are recorded
+ * next to it (`billing_unit`, `quantity`, `unit_price`, `currency`, plus the
+ * catalog's own breakdown in `metadata`) so a per-second or per-megapixel row
+ * is auditable even when the estimate is imperfect.
+ */
+import { createLogger } from "@nodetool-ai/config";
+import { Prediction } from "@nodetool-ai/models";
+import { getModelUnitPrice } from "@nodetool-ai/model-pricing";
+import { extractPricingParams } from "@nodetool-ai/node-sdk";
+import { getCostReconciler } from "@nodetool-ai/runtime";
+import { createTrackerState, trackPredictionMessage } from "./generation-tracker.js";
+import { providerBillingSecretKey } from "./provider-secret-key.js";
+const log = createLogger("nodetool.execution.cost-ledger");
+/**
+ * Capabilities a provider bills per output rather than per token. Chat,
+ * streaming chat and embeddings are absent on purpose: a token-billed call
+ * reaches this ledger by a different road, so admitting it here would book it
+ * twice. A chat turn writes the provider instance's running total through
+ * `ChatTurn._logProviderCall`; a workflow node reports its own delta through
+ * `meterProviderSpend` -> `setProviderCost` -> `recordNodeProviderCost`.
+ */
+const UNIT_BILLED_CAPABILITIES = new Set([
+    "text_to_image",
+    "image_to_image",
+    "inpainting",
+    "outpaint_image",
+    "text_to_video",
+    "image_to_video",
+    "reference_to_video",
+    "video_to_video",
+    "upscale_video",
+    "interpolate_video",
+    "outpaint_video",
+    "upscale_image",
+    "remove_background",
+    "relight_image",
+    "segment_image",
+    "vectorize_image",
+    "lip_sync",
+    "text_to_speech",
+    "text_to_music",
+    "audio_to_audio",
+    "video_to_audio",
+    "automatic_speech_recognition",
+    "text_to_3d",
+    "image_to_3d",
+    "render_model3d"
+]);
+/** Whether a capability is billed per unit of output (and so belongs here). */
+export function isUnitBilledCapability(capability) {
+    return capability != null && UNIT_BILLED_CAPABILITIES.has(capability);
+}
+/**
+ * Price a generation against the model catalogs. Returns `null` when no catalog
+ * carries the model, or when the catalog declines to extrapolate — a refusal is
+ * an answer, and inventing a number would be worse than recording none.
+ */
+export function priceGeneration(spend) {
+    const quantity = spend.quantity ?? 1;
+    if (!Number.isFinite(quantity) || quantity <= 0)
+        return null;
+    const price = getModelUnitPrice({ id: spend.model, provider: spend.provider }, extractPricingParams(spend.params));
+    if (!price || price.declined)
+        return null;
+    if (!Number.isFinite(price.unit_price))
+        return null;
+    const priced = {
+        cost: price.unit_price * quantity,
+        unit_price: price.unit_price,
+        quantity,
+        billing_unit: price.billing_unit || (spend.capability ?? "run"),
+        currency: price.currency || "USD"
+    };
+    if (price.breakdown)
+        priced.breakdown = price.breakdown;
+    if (price.assumptions?.length)
+        priced.assumptions = price.assumptions;
+    return priced;
+}
+/**
+ * Write one generation to the ledger. Best-effort: a host with no database
+ * (a hermetic run, an eval) must not fail because accounting could not be
+ * persisted — the generation already happened and was already billed.
+ */
+export async function recordGenerationSpend(spend) {
+    const priced = priceGeneration(spend);
+    const metadata = {
+        capability: spend.capability ?? null
+    };
+    if (priced) {
+        metadata.price_source = "model-catalog";
+        if (priced.breakdown)
+            metadata.price_breakdown = priced.breakdown;
+        if (priced.assumptions)
+            metadata.price_assumptions = priced.assumptions;
+    }
+    else {
+        metadata.unpriced_reason = `No unit price for ${spend.provider}/${spend.model} in the model catalogs`;
+    }
+    try {
+        return await Prediction.create({
+            user_id: spend.userId,
+            provider: spend.provider,
+            model: spend.model,
+            node_id: spend.nodeId ?? "",
+            node_type: spend.nodeType ?? "",
+            workflow_id: spend.workflowId ?? null,
+            project_id: spend.projectId ?? null,
+            document_id: spend.documentId ?? null,
+            status: "completed",
+            cost: priced ? priced.cost : null,
+            billing_unit: priced ? priced.billing_unit : (spend.capability ?? null),
+            quantity: priced ? priced.quantity : (spend.quantity ?? 1),
+            unit_price: priced ? priced.unit_price : null,
+            currency: priced ? priced.currency : null,
+            duration: spend.durationMs != null ? spend.durationMs / 1000 : null,
+            metadata
+        });
+    }
+    catch (err) {
+        log.debug("Generation spend not recorded", {
+            provider: spend.provider,
+            model: spend.model,
+            error: err instanceof Error ? err.message : String(err)
+        });
+        return null;
+    }
+}
+/**
+ * Write a node-reported provider charge to the ledger, then refine it into the
+ * provider's actual billed amount in the background when that provider
+ * registered a reconciler. Best-effort throughout.
+ */
+export async function recordNodeProviderCost(spend) {
+    const { cost } = spend;
+    // A NaN/Infinity amount from a buggy provider call can't be stored: SQLite
+    // has no representation for it and JSON turns it into `null`.
+    if (!Number.isFinite(cost.amount))
+        return null;
+    try {
+        const prediction = await Prediction.create({
+            user_id: spend.userId,
+            provider: cost.provider,
+            model: cost.model ?? spend.nodeType,
+            node_type: spend.nodeType,
+            node_id: spend.nodeId,
+            workflow_id: spend.workflowId,
+            project_id: spend.projectId ?? null,
+            document_id: spend.documentId ?? null,
+            status: "completed",
+            cost: cost.amount,
+            currency: cost.currency ?? cost.unit ?? null,
+            billing_unit: cost.billing_unit ?? null,
+            quantity: cost.quantity ?? null,
+            unit_price: cost.unit_price ?? null,
+            provider_request_id: cost.provider_request_id ?? null,
+            // Set by a token-billed call (an LLM node reporting a `generateLoop`
+            // delta), left null by a per-output generation that counts no tokens.
+            input_tokens: cost.input_tokens ?? null,
+            output_tokens: cost.output_tokens ?? null,
+            cached_tokens: cost.cached_tokens ?? null
+        });
+        if (cost.provider_request_id) {
+            void reconcileProviderCost(prediction, spend);
+        }
+        return prediction;
+    }
+    catch (err) {
+        log.debug("Node provider cost not recorded", {
+            provider: cost.provider,
+            error: err instanceof Error ? err.message : String(err)
+        });
+        return null;
+    }
+}
+/**
+ * Replace an estimated charge with the provider's actual billed amount, looked
+ * up by request id. Runs detached; leaves the estimate in place when no actual
+ * is available.
+ */
+async function reconcileProviderCost(prediction, spend) {
+    const reconciler = getCostReconciler(spend.cost.provider);
+    if (!reconciler || !spend.cost.provider_request_id)
+        return;
+    try {
+        const secretKey = providerBillingSecretKey(spend.cost.provider);
+        const apiKey = await spend.resolveSecret?.(secretKey);
+        const actual = await reconciler({
+            requestId: spend.cost.provider_request_id,
+            endpointId: spend.cost.model ?? null,
+            secrets: apiKey ? { [secretKey]: apiKey } : {}
+        });
+        if (!actual)
+            return;
+        await prediction.update({
+            cost: actual.cost,
+            currency: actual.currency ?? prediction.currency,
+            quantity: actual.quantity ?? prediction.quantity,
+            unit_price: actual.unit_price ?? prediction.unit_price
+        });
+    }
+    catch (err) {
+        log.warn("Failed to reconcile provider cost", {
+            provider: spend.cost.provider,
+            error: err instanceof Error ? err.message : String(err)
+        });
+    }
+}
+/**
+ * A `nodeType` lookup built once per run. Scanning the node list per message
+ * would be O(nodes × messages), which a 20 000-node graph feels.
+ */
+export function nodeTypeLookup(nodes) {
+    const types = new Map(nodes.map((node) => [node.id, node.type]));
+    return (nodeId) => types.get(nodeId) ?? "";
+}
+export function attachRunCostLedger(context, options) {
+    const state = createTrackerState();
+    const pending = new Set();
+    const detach = context.addMessageListener((msg) => {
+        const write = recordFromMessage(msg, options, state)
+            .catch(() => undefined)
+            .finally(() => pending.delete(write));
+        pending.add(write);
+    });
+    return Object.assign(detach, {
+        settled: async () => {
+            await Promise.all([...pending]);
+        }
+    });
+}
+/**
+ * Ledger one run message: a node's self-reported charge, or a completed
+ * unit-billed prediction. Anything else is not spend and writes nothing.
+ */
+export async function recordFromMessage(msg, options, state = createTrackerState()) {
+    if (msg.type === "node_update" && msg.status === "completed") {
+        if (!msg.provider_cost)
+            return;
+        // A node that went through the generation seam and whose provider stated
+        // its charge already has a row with that charge (design § 6.5). Its own
+        // `provider_cost` is the same money a second time.
+        if (state.receiptCostNodes.has(msg.node_id)) {
+            state.receiptCostNodes.delete(msg.node_id);
+            return;
+        }
+        await recordNodeProviderCost({
+            userId: options.userId,
+            cost: msg.provider_cost,
+            nodeId: msg.node_id,
+            nodeType: msg.node_type || options.nodeType?.(msg.node_id) || "",
+            workflowId: options.workflowId,
+            projectId: options.projectId,
+            documentId: options.documentId,
+            resolveSecret: options.resolveSecret
+        });
+        return;
+    }
+    if (msg.type !== "prediction")
+        return;
+    // The tracker opens the row on `running` and closes it on the terminal
+    // message, so every state of a generation is a row state.
+    await trackPredictionMessage(msg, options, state);
+}
+//# sourceMappingURL=cost-ledger.js.map

package/dist/cost-ledger.js.map

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

package/dist/debug/collector.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Folds a workflow run's processing-message stream into an `ExecutionSummary`.
+ *
+ * Pure and surface-agnostic: the same reducer distills the server runner's
+ * `RunResult.messages` and the browser harness's raw event log, so both surfaces
+ * report identically. Only `import type` is used here so the module stays free of
+ * runtime workspace dependencies (testable under the CLI vitest stub setup).
+ */
+import type { ProcessingMessage } from "@nodetool-ai/protocol";
+import type { ExecutionSummary } from "./types.js";
+/**
+ * Make a value safe to embed in a JSON debug report: truncate long strings,
+ * collapse binary and base64 blobs, and cap array/object fan-out. Keeps enough
+ * to debug (shape, prefixes, sizes) without dumping megabytes of media bytes.
+ */
+/** A value reduced to what a JSON debug report can carry. */
+export type PreviewValue = string | number | boolean | null | undefined | PreviewValue[] | {
+    [key: string]: PreviewValue;
+};
+export declare function previewValue(value: unknown, maxLen?: number): PreviewValue;
+/**
+ * Reduce a processing-message stream into a structured execution summary.
+ *
+ * Accepts loosely-typed messages (the browser harness decodes JSON into bags of
+ * unknown fields) and reads only the fields each `type` is known to carry.
+ */
+export declare function collectExecutionSummary(messages: ReadonlyArray<ProcessingMessage | Record<string, unknown>>): ExecutionSummary;
+//# sourceMappingURL=collector.d.ts.map

package/dist/debug/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/debug/collector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAgB,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAEV,gBAAgB,EAKjB,MAAM,YAAY,CAAC;AA6BpB;;;;GAIG;AACH,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,YAAY,EAAE,GACd;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAC;AAEpC,wBAAgB,YAAY,CAC1B,KAAK,EAAE,OAAO,EACd,MAAM,GAAE,MAA2B,GAClC,YAAY,CA+Bd;AAcD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,CAAC,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACnE,gBAAgB,CAiLlB"}