@nodetool-ai/execution 0.8.1 → 0.8.2

package/dist/service/app-debug-service.js

@@ -18,9 +18,12 @@
  * or `done`.
  */
 import { randomUUID } from "node:crypto";
-import { createLogger } from "@nodetool-ai/config";
-import { Application, Workflow, createJsScriptResolver } from "@nodetool-ai/models";
-import { applicationTarget, inlineDocumentTarget, simulateApp, summarizeAppReport } from "../app-debug/index.js";
+import { createLogger, getDefaultAssetsPath } from "@nodetool-ai/config";
+import { FileStorageAdapter } from "@nodetool-ai/storage";
+import { parseApplicationBundle } from "@nodetool-ai/app-runtime";
+import { Application, AppRunError, Workflow, WorkflowVersion, getSecret, resolveAppInstanceApplicationId, createJsScriptResolver } from "@nodetool-ai/models";
+import { ProcessingContext } from "@nodetool-ai/runtime";
+import { applicationTarget, bundleTarget, createAppDebugRunRecording, inlineDocumentTarget, simulateApp, summarizeAppReport } from "../app-debug/index.js";
 import { createAppServerRunner } from "./app-run-server.js";
 import { debugSessions, InteractiveEscalationHandle } from "./debug-sessions.js";
 import { isNonEmptyString, isPositiveFiniteNumber } from "../predicates.js";
@@ -44,14 +47,34 @@ async function loadUserJsScript(userId, scriptId, scriptVersion) {
     return resolved ? { name: resolved.name, document: resolved.document } : null;
 }
 /** A workflow the user can read, in the shape the simulator wants. */
-async function loadUserWorkflow(userId, id) {
+async function loadUserWorkflow(userId, id, version) {
     const workflow = await Workflow.find(userId, id);
-    const graph = workflow?.getGraph();
+    if (!workflow) {
+        return null;
+    }
+    const pinned = version === undefined ? null : await WorkflowVersion.findByVersion(workflow.id, version);
+    if (version !== undefined && (!pinned || pinned.user_id !== workflow.user_id)) {
+        return null;
+    }
+    const graph = pinned?.graph ?? workflow.getGraph();
     return graph ? { graph } : null;
 }
 /** An application the user owns, with its document still unparsed. */
 async function loadUserApplication(userId, id) {
-    const application = await Application.findById(id);
+    let fullId;
+    try {
+        fullId = await resolveAppInstanceApplicationId(userId, id);
+    }
+    catch (error) {
+        if (error instanceof AppRunError && error.code === "not_found") {
+            return null;
+        }
+        if (error instanceof AppRunError) {
+            throw new AppServiceError("invalid_input", error.message);
+        }
+        throw error;
+    }
+    const application = await Application.findById(fullId);
     if (!application || application.user_id !== userId)
         return null;
     return {
@@ -97,7 +120,7 @@ async function resolveTarget(userId, body, deps) {
         throw new AppServiceError("invalid_input", "Pass either application_id or document, not both — a saved row and a " +
             "live draft are different apps the moment the draft changes.");
     }
-    const loadFromDb = (id) => (deps.loadWorkflow ?? loadUserWorkflow)(userId, id);
+    const loadFromDb = (id, version) => (deps.loadWorkflow ?? loadUserWorkflow)(userId, id, version);
     if (hasId) {
         const id = body.application_id;
         const application = await (deps.loadApplication ?? loadUserApplication)(userId, id);
@@ -107,6 +130,10 @@ async function resolveTarget(userId, body, deps) {
         return applicationTarget(id, application, loadFromDb);
     }
     if (hasDocument) {
+        const bundle = parseApplicationBundle(body.document);
+        if (bundle) {
+            return bundleTarget(bundle, "inline");
+        }
         return inlineDocumentTarget(body.document, loadFromDb);
     }
     throw new AppServiceError("invalid_input", "An app debug run needs either an application_id or a document.");
@@ -120,14 +147,14 @@ export async function runApplicationDebug(userId, body, defaultRegistry, deps =
     const resolved = await resolveTarget(userId, body, deps);
     const registry = deps.registry ?? defaultRegistry;
     const timeoutMs = positive(body.timeout_ms);
-    // Cancelling a simulation settles its session with a failed report; the runs
-    // already in flight finish in the background, since `simulateApp` takes no
-    // signal. Nothing they touch is persisted, so a finished orphan run is spend,
-    // not state.
-    let cancelled = null;
-    const abandoned = new Promise((resolve) => {
-        cancelled = resolve;
-    });
+    const controller = new AbortController();
+    const context = deps.context
+        ? deps.context.copy({ jobId: debugId })
+        : new ProcessingContext({ userId, jobId: debugId,
+            secretResolver: (key) => getSecret(key, userId),
+            storage: new FileStorageAdapter(getDefaultAssetsPath()), assetStorage: deps.assetStorage ?? null });
+    context.signal = deps.context ? AbortSignal.any([deps.context.signal, controller.signal]) : controller.signal;
+    const runIds = new Set();
     // The promise a session fronts must never reject: a rejected run would leave
     // the session parked forever with no report to hand back.
     const simulation = (async () => {
@@ -146,24 +173,47 @@ export async function runApplicationDebug(userId, body, defaultRegistry, deps =
                 simulateOptions.timeoutMs = timeoutMs;
             }
             const simulateDeps = {
-                loadFromDb: (id) => (deps.loadWorkflow ?? loadUserWorkflow)(userId, id),
+                loadFromDb: (id, version) => (deps.loadWorkflow ?? loadUserWorkflow)(userId, id, version),
                 runOnServer: createAppServerRunner(userId, registry, {
                     jobPrefix: "app-debug-run",
                     assetStorage: deps.assetStorage ?? null
                 }),
                 loadScript: (scriptId, scriptVersion) => loadUserJsScript(userId, scriptId, scriptVersion)
             };
-            if (deps.runScript) {
-                simulateDeps.runScript = deps.runScript;
+            const scriptRunner = deps.scriptRunner;
+            const runScript = scriptRunner
+                ? (input) => scriptRunner(context, input)
+                : deps.runScript;
+            if (runScript) {
+                simulateDeps.runScript = runScript;
             }
+            const recording = createAppDebugRunRecording({ userId, target: resolved, registry, context,
+                onRunCreated: (id) => { runIds.add(id); },
+                loadWorkflow: simulateDeps.loadFromDb, loadScript: simulateDeps.loadScript,
+                applicationId: body.application_id,
+                runWorkflow: (parent, input) => createAppServerRunner(userId, registry, { context: parent })(input),
+                runScript: (parent, input) => {
+                    if (deps.scriptRunner) {
+                        return deps.scriptRunner(parent, input);
+                    }
+                    if (deps.runScript) {
+                        return deps.runScript(input);
+                    }
+                    throw new Error("Host does not provide script execution");
+                }
+            });
+            Object.assign(simulateDeps, recording);
             const report = await simulateApp(resolved, simulateOptions, simulateDeps);
-            return debugPayload(report, debugId);
+            report.run_ids = [...runIds];
+            const payload = debugPayload(report, debugId);
+            return controller.signal.aborted ? { ...payload, status: "failed", error: "cancelled" } : payload;
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
             log.error("app debug failed outside the report", { debugId, message });
             return {
                 debug_id: debugId,
+                run_ids: [...runIds],
                 status: "failed",
                 error: message,
                 verdict: {
@@ -175,24 +225,16 @@ export async function runApplicationDebug(userId, body, defaultRegistry, deps =
             };
         }
     })();
-    const done = Promise.race([simulation, abandoned]);
+    const done = simulation;
     const session = debugSessions.create({
         userId,
         workflowId: resolved.info.workflowId,
         jobId: debugId,
         handle: new InteractiveEscalationHandle(),
         done,
-        cancel: () => cancelled?.({
-            debug_id: debugId,
-            status: "failed",
-            error: "cancelled",
-            verdict: {
-                ok: false,
-                headline: "App debug cancelled before it finished.",
-                issues: ["cancelled"],
-                warnings: []
-            }
-        })
+        cancel: () => {
+            controller.abort();
+        }
     });
     if (body.poll === true)
         return runningPayload(session, debugId);

package/dist/service/app-debug-service.js.map

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

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

@@ -0,0 +1,38 @@
+import { type ResourceRef, type ScriptRunResult } from "@nodetool-ai/app-runtime";
+import type { AppRunRecord } from "@nodetool-ai/protocol/api-schemas/app-runs.js";
+import { ProcessingContext } from "@nodetool-ai/runtime";
+import type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import { type AppServerRunInput, type AppServerRunOutcome, type JsScriptOperationRunner } from "../app-debug/index.js";
+export interface ExecuteAppOperationOptions {
+    readonly userId: string;
+    readonly instanceId: string;
+    readonly operationId: string;
+    readonly invocationId: string;
+    readonly origin: AppRunRecord["origin"];
+    readonly context: ProcessingContext;
+    readonly registry: NodeRegistry;
+    /** Already reserved by a trusted host. */
+    readonly runId?: string;
+    readonly estimatedUsd?: number;
+    readonly runnerInstance?: string | null;
+    readonly requireFiniteBudget?: boolean;
+    readonly inputValues?: Readonly<Record<string, unknown>>;
+    /** Inputs already resolved by the headless app runtime against its interaction state. */
+    readonly resolvedInputs?: Record<string, unknown>;
+    /** Effective workflow property bindings alongside its operation parameters. */
+    readonly inputSnapshot?: Record<string, unknown>;
+    readonly onReserved?: (run: AppRunRecord) => void;
+    readonly resourceRef?: (id: string) => ResourceRef | undefined;
+    readonly scriptRunner?: (context: ProcessingContext, input: Parameters<JsScriptOperationRunner>[0]) => Promise<ScriptRunResult>;
+    readonly workflowRunner?: (context: ProcessingContext, input: AppServerRunInput) => Promise<AppServerRunOutcome>;
+}
+export interface AppOperationOutcome {
+    /** Deleted history returns a content-free terminal snapshot that is not persisted. */
+    readonly run: AppRunRecord;
+    readonly variables: Readonly<Record<string, unknown>>;
+    readonly messages: ReadonlyArray<Record<string, unknown>>;
+    readonly reused: boolean;
+}
+/** Reserve before resolving bindings, secrets, or executable targets. */
+export declare function executeAppOperation(options: ExecuteAppOperationOptions): Promise<AppOperationOutcome>;
+//# sourceMappingURL=app-operation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"app-operation.d.ts","sourceRoot":"","sources":["../../src/service/app-operation.ts"],"names":[],"mappings":"AACA,OAAO,EASL,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAWlC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAuB,MAAM,sBAAsB,CAAC;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAOL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAM/B,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,yFAAyF;IACzF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,+EAA+E;IAC/E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjD,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,CACtB,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,KAC1C,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9B,QAAQ,CAAC,cAAc,CAAC,EAAE,CACxB,OAAO,EAAE,iBAAiB,EAC1B,KAAK,EAAE,iBAAiB,KACrB,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,yEAAyE;AACzE,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,mBAAmB,CAAC,CAoQ9B"}

package/dist/service/app-operation.js

@@ -0,0 +1,269 @@
+import { registerAppRunTrace, withRegisteredRunTrace, settleRegisteredRunTrace } from "./run-trace-lifecycle.js";
+import { applyEvents, createInstanceState, messagesToEvents, operationTarget, parseApplicationDocument, outputVariableTargets, resolveOperationParams, stateKey } from "@nodetool-ai/app-runtime";
+import { AppRunError, getAppRun, claimAppRun, reconcileAppRunCost, getAppInstance, reserveAppRun, setAppRunInputs, settleAppRun } from "@nodetool-ai/models";
+import { inAppRunCostAccount } from "@nodetool-ai/runtime";
+import { debugGraphOf, documentOperations, extractAppIO, jsScriptRunMessages, scriptAppIO, scriptOperationInvocation } from "../app-debug/index.js";
+import { isRecord } from "../predicates.js";
+import { attachRunCostLedger } from "../cost-ledger.js";
+import { createFalGenerationLifecycleHooks } from "../generation-lifecycle.js";
+import { createAppServerRunner } from "./app-run-server.js";
+/** Reserve before resolving bindings, secrets, or executable targets. */
+export async function executeAppOperation(options) {
+    let run;
+    if (options.runId) {
+        const existing = await getAppRun(options.userId, options.runId);
+        if (!existing ||
+            existing.instance_id !== options.instanceId ||
+            existing.operation_id !== options.operationId) {
+            throw new Error("App run does not match the requested operation");
+        }
+        run = existing;
+    }
+    else {
+        const reservation = await reserveAppRun({
+            userId: options.userId,
+            instanceId: options.instanceId,
+            operationId: options.operationId,
+            invocationId: options.invocationId,
+            origin: options.origin,
+            estimatedUsd: options.estimatedUsd,
+            requireFiniteBudget: options.requireFiniteBudget
+        });
+        if (!reservation.allowed) {
+            throw new Error(reservation.reason);
+        }
+        run = reservation.run;
+        if (!reservation.created) {
+            return { run, variables: {}, messages: [], reused: true };
+        }
+    }
+    options.onReserved?.(run);
+    if (run.status !== "running" ||
+        !(await claimAppRun(options.userId, run.id, options.runnerInstance))) {
+        return { run, variables: {}, messages: [], reused: true };
+    }
+    const identity = {
+        userId: options.userId,
+        instanceId: run.instance_id,
+        appRunId: run.id,
+        traceId: run.trace_id,
+        origin: run.origin
+    };
+    const context = options.context.copy({
+        jobId: run.id,
+        appRunContext: identity,
+        generationLifecycle: createFalGenerationLifecycleHooks({
+            userId: options.userId,
+            jobId: run.id,
+            appRunContext: identity,
+            publicUrl: process.env["NODETOOL_PUBLIC_URL"] ?? null
+        })
+    });
+    try {
+        await registerAppRunTrace(context, run);
+    }
+    catch (error) {
+        await settleOperationRun(options.userId, run, { status: "failed", actualUsd: 0, knownLlmUsd: 0, error: error instanceof Error ? error.message : String(error), secretValues: [...context.getResolvedSecretValues()] });
+        throw error;
+    }
+    return withRegisteredRunTrace(context, "app.run", async () => {
+        const messages = [];
+        let variableChanges = {};
+        try {
+            context.signal.throwIfAborted();
+            const instance = await getAppInstance(options.userId, run.instance_id);
+            if (!instance) {
+                throw new Error("App instance was deleted before execution");
+            }
+            if (instance.version !== run.version ||
+                (run.snapshot !== null && JSON.stringify(instance.snapshot) !== JSON.stringify(run.snapshot))) {
+                const error = "App instance snapshot changed before execution. Start a new run.";
+                run = await settleOperationRun(options.userId, run, {
+                    status: "failed", actualUsd: 0, knownLlmUsd: 0, updateInstance: false, error
+                });
+                throw new Error(error);
+            }
+            const snapshot = run.snapshot ?? instance.snapshot;
+            const document = parseApplicationDocument(snapshot.document);
+            if (!document) {
+                throw new Error("Pinned application document is invalid");
+            }
+            const operation = documentOperations(document).find((candidate) => candidate.id === run.operation_id);
+            if (!operation) {
+                throw new Error("Operation is missing from the pinned application");
+            }
+            const target = operationTarget(operation);
+            const carriedScript = target.kind === "script"
+                ? snapshot.script_documents[`${target.scriptId}@${target.scriptVersion}`] ?? snapshot.script_documents[target.scriptId]
+                : undefined;
+            const graph = target.kind === "workflow"
+                ? debugGraphOf(snapshot.workflow_graphs[`${target.workflowId}@${target.workflowVersion ?? "latest"}`] ?? snapshot.workflow_graphs[target.workflowId])
+                : null;
+            const io = carriedScript
+                ? scriptAppIO(carriedScript)
+                : graph
+                    ? extractAppIO(graph)
+                    : null;
+            if (!io) {
+                throw new Error("Execution target is missing from the pinned application");
+            }
+            let state = createInstanceState();
+            state.variables = run.origin === "public" ? {} : { ...instance.variables };
+            const cachedInputs = state.variables["__app_inputs"];
+            const inputValues = options.inputValues ?? (isRecord(cachedInputs) ? cachedInputs : {});
+            for (const input of io.inputs) {
+                const key = stateKey({
+                    kind: "input",
+                    operationId: operation.id,
+                    nodeId: input.nodeId
+                });
+                const stored = inputValues[key];
+                const value = stored && typeof stored === "object" && "value" in stored
+                    ? stored.value
+                    : (stored ?? input.defaultValue);
+                state.inputs[key] = { value, dirty: stored !== undefined, revision: 0 };
+            }
+            const params = options.resolvedInputs ?? resolveOperationParams({
+                operation,
+                state,
+                inputNodeIds: io.inputs.map((input) => input.nodeId),
+                inputName: (id) => io.inputs.find((input) => input.nodeId === id)?.name,
+                resourceRef: options.resourceRef
+            });
+            await setAppRunInputs(options.userId, run.id, options.inputSnapshot ?? params, [
+                ...context.getResolvedSecretValues()
+            ]);
+            const variableTargets = new Map(outputVariableTargets(operation).map((target) => [
+                target.nodeId,
+                target.variableId
+            ]));
+            state = applyEvents(state, [
+                {
+                    type: "runStarted",
+                    invocation: {
+                        id: run.id,
+                        operationId: operation.id,
+                        status: "running",
+                        startedAt: Date.parse(run.created_at)
+                    },
+                    outputKeys: io.outputs.map((output) => `${operation.id}:${output.nodeId}`),
+                    variableKeys: [...variableTargets.values()]
+                }
+            ]);
+            let status = "completed";
+            let error = null;
+            if (target.kind === "script" && carriedScript) {
+                if (!options.scriptRunner) {
+                    throw new Error("Host does not provide script execution");
+                }
+                const ledger = attachRunCostLedger(context, {
+                    userId: options.userId,
+                    workflowId: null,
+                    appRunContext: identity
+                });
+                try {
+                    const scriptRunner = options.scriptRunner;
+                    const result = await inAppRunCostAccount(context.appRunCostAccount, () => scriptRunner(context, {
+                        scriptId: target.scriptId,
+                        scriptVersion: target.scriptVersion,
+                        name: operation.name,
+                        document: carriedScript,
+                        ...scriptOperationInvocation(carriedScript, params),
+                        timeoutMs: operation.timeoutMs
+                    }));
+                    messages.push(...jsScriptRunMessages(result));
+                    if (!result.ok) {
+                        status = context.signal.aborted ? "cancelled" : "failed";
+                        error = result.error ?? "Script operation failed";
+                    }
+                }
+                finally {
+                    await ledger.settled();
+                    ledger();
+                }
+            }
+            else if (target.kind === "workflow" && graph) {
+                const runner = options.workflowRunner ??
+                    ((parent, input) => createAppServerRunner(options.userId, options.registry, {
+                        context: parent
+                    })(input));
+                const outcome = await runner(context, {
+                    graph,
+                    workflowId: target.workflowId,
+                    params,
+                    timeoutMs: operation.timeoutMs
+                });
+                messages.push(...outcome.rawMessages);
+                status = outcome.report.ok
+                    ? "completed"
+                    : outcome.report.status === "cancelled"
+                        ? "cancelled"
+                        : "failed";
+                error = outcome.report.error;
+            }
+            state = applyEvents(state, messagesToEvents(messages, {
+                resolveInvocation: () => state.invocations[run.id] ?? null,
+                outputKey: (_, nodeId) => `${operation.id}:${nodeId}`,
+                outputVariable: (_, nodeId) => variableTargets.get(nodeId) ?? null
+            }));
+            variableChanges = Object.fromEntries([...variableTargets.values()]
+                .filter((id) => id in state.variables)
+                .map((id) => [id, state.variables[id]]));
+            variableChanges["__app_outputs"] = Object.fromEntries(Object.entries(state.outputs).map(([key, slot]) => [key, slot.value]));
+            const settlement = {
+                status,
+                error: context.runTraceContext?.policy.contentSuppressed && error ? "Execution failed" : error,
+                outputs: variableChanges,
+                documents: context.getAppRunDocuments(),
+                expectedRevision: run.instance_revision,
+                contentSuppressed: context.runTraceContext?.policy.contentSuppressed,
+                secretValues: [...context.getResolvedSecretValues()]
+            };
+            const knownLlmUsd = context.getAppRunLlmCost();
+            if (knownLlmUsd !== null) {
+                settlement.knownLlmUsd = knownLlmUsd;
+            }
+            run = await settleOperationRun(options.userId, run, settlement);
+        }
+        catch (error) {
+            const settlement = {
+                status: context.signal.aborted ? "cancelled" : "failed",
+                error: context.runTraceContext?.policy.contentSuppressed ? "Execution failed" : error instanceof Error ? error.message : String(error),
+                contentSuppressed: context.runTraceContext?.policy.contentSuppressed,
+                secretValues: [...context.getResolvedSecretValues()],
+                documents: context.getAppRunDocuments()
+            };
+            const knownLlmUsd = context.getAppRunLlmCost();
+            if (knownLlmUsd !== null) {
+                settlement.knownLlmUsd = knownLlmUsd;
+            }
+            run = await settleOperationRun(options.userId, run, settlement);
+        }
+        await reconcileAppRunCost(options.userId, run.id);
+        run = (await getAppRun(options.userId, run.id)) ?? run;
+        await settleRegisteredRunTrace(context, run.status === "running" ? "failed" : run.status, run.error, run.actual_usd);
+        return { run, variables: variableChanges, messages, reused: false };
+    });
+}
+async function settleOperationRun(userId, run, settlement) {
+    try {
+        return await settleAppRun(userId, run.id, settlement);
+    }
+    catch (error) {
+        if (!(error instanceof AppRunError) || error.code !== "not_found") {
+            throw error;
+        }
+        return {
+            ...run,
+            status: settlement.status,
+            snapshot: null,
+            inputs: null,
+            outputs: null,
+            documents: null,
+            error: null,
+            content_expired: 1,
+            settled_at: new Date().toISOString()
+        };
+    }
+}
+//# sourceMappingURL=app-operation.js.map

package/dist/service/app-operation.js.map

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

package/dist/service/app-run-server.d.ts

@@ -13,10 +13,12 @@
  */
 import type { AppServerRunInput, AppServerRunOutcome } from "../app-debug/index.js";
 import type { NodeRegistry } from "@nodetool-ai/node-sdk";
-import { type StorageAdapter } from "@nodetool-ai/runtime";
+import { ProcessingContext, type StorageAdapter } from "@nodetool-ai/runtime";
 export interface AppServerRunnerOptions {
     /** Job-id prefix, so a run is attributable to the surface that started it. */
     jobPrefix?: string;
+    /** Operation context inherited by this workflow child. */
+    context?: ProcessingContext;
     /**
      * The store `asset://<id>` inputs resolve through. Only the local assets dir
      * on a `file` backend, so a host on S3/Supabase must pass its own or the

package/dist/service/app-run-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-run-server.d.ts","sourceRoot":"","sources":["../../src/service/app-run-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG9E,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,YAAY,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,sBAA2B,GACnC,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CA8E5D"}
+{"version":3,"file":"app-run-server.d.ts","sourceRoot":"","sources":["../../src/service/app-run-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG9E,MAAM,WAAW,sBAAsB;IACrC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,YAAY,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACtC;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,sBAA2B,GACnC,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAqF5D"}

package/dist/service/app-run-server.js

@@ -25,20 +25,22 @@ export function createAppServerRunner(userId, registry, options = {}) {
     return async (input) => {
         const startedAt = Date.now();
         const jobId = `${jobPrefix}-${randomUUID()}`;
-        const context = new ProcessingContext({
-            jobId,
-            workflowId: input.workflowId,
-            userId,
-            secretResolver: (key) => getSecret(key, userId),
-            storage: new FileStorageAdapter(getDefaultAssetsPath()),
-            assetStorage: options.assetStorage ?? null,
-            generationLifecycle: createFalGenerationLifecycleHooks({
-                userId,
+        const context = options.context
+            ? options.context.copy({ jobId, workflowId: input.workflowId })
+            : new ProcessingContext({
                 jobId,
-                projectId: null,
-                publicUrl: process.env["NODETOOL_PUBLIC_URL"] ?? null
-            })
-        });
+                workflowId: input.workflowId,
+                userId,
+                secretResolver: (key) => getSecret(key, userId),
+                storage: new FileStorageAdapter(getDefaultAssetsPath()),
+                assetStorage: options.assetStorage ?? null,
+                generationLifecycle: createFalGenerationLifecycleHooks({
+                    userId,
+                    jobId,
+                    projectId: null,
+                    publicUrl: process.env["NODETOOL_PUBLIC_URL"] ?? null
+                })
+            });
         const sessionOptions = {
             graph: input.graph,
             registry,
@@ -78,7 +80,13 @@ export function createAppServerRunner(userId, registry, options = {}) {
         }
         // `session.result` never rejects: a kernel failure resolves as
         // `status: "failed"`, which the simulator turns into a complaint.
-        const result = await session.result;
+        const cancel = () => session.cancel("cancelled");
+        options.context?.signal.addEventListener("abort", cancel, { once: true });
+        if (options.context?.signal.aborted)
+            cancel();
+        const result = await session.result.finally(() => {
+            options.context?.signal.removeEventListener("abort", cancel);
+        });
         const messages = result.messages ?? [];
         const summary = collectExecutionSummary(messages);
         summary.status = result.status ?? summary.status;