@nodetool-ai/execution 0.8.1

package/dist/app-debug/script-operation.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Script operations for the app simulator.
+ *
+ * The contract itself — the synthesized message stream and the port surface
+ * that stands in for a graph — lives in `@nodetool-ai/app-runtime`
+ * (`script-run.ts`), because the browser runs script operations too and cannot
+ * depend on this package. What is left here is the part that needs a parser:
+ * binding the pinned Zod document and deciding, from the body, whether the
+ * mapped values are staged as streams.
+ */
+import { type ScriptRunResult } from "@nodetool-ai/app-runtime";
+import { type JsScriptDocument } from "@nodetool-ai/protocol/api-schemas/js-scripts.js";
+import type { AppIO } from "./types.js";
+/** What one script run returned — the shape `POST /api/js-scripts/:id/run` answers with. */
+export type JsScriptRunResult = ScriptRunResult;
+/** Run one pinned script's document with the given inputs. */
+export type JsScriptOperationRunner = (input: {
+    scriptId: string;
+    scriptVersion: number;
+    name: string;
+    document: JsScriptDocument;
+    inputs: Record<string, unknown>;
+    /** Items staged per handle for a body that reads `stream`. */
+    inputStreams?: Record<string, unknown[]>;
+    timeoutMs?: number;
+}) => Promise<JsScriptRunResult>;
+/** How one invocation's mapped values reach the body. */
+interface JsScriptInvocation {
+    inputs: Record<string, unknown>;
+    inputStreams?: Record<string, unknown[]>;
+}
+/**
+ * Split an operation's mapped values the way the body reads them — staged as
+ * one-item streams when the body reads `stream`, untouched otherwise.
+ */
+export declare function scriptOperationInvocation(document: JsScriptDocument, inputs: Record<string, unknown>): JsScriptInvocation;
+/** Resolve a pinned script target to its document. */
+export type JsScriptOperationLoader = (scriptId: string, scriptVersion: number) => Promise<{
+    name: string;
+    document: JsScriptDocument;
+} | null>;
+/**
+ * Parse a document carried loosely (a bundle's structural shape) into the
+ * pinned contract, or null when it is not one. A bundle is untrusted input.
+ */
+export declare function parseCarriedScriptDocument(value: unknown): JsScriptDocument | null;
+/**
+ * A script's bindable surface. Port names stand in for node ids: a script
+ * declares no nodes, and its port names are what every mapping already keys on.
+ */
+export declare function scriptAppIO(document: JsScriptDocument): AppIO;
+/**
+ * The message stream a script run would have produced: its emits in order,
+ * then its final outputs, then the job's terminal status.
+ */
+export declare function jsScriptRunMessages(result: JsScriptRunResult): Array<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=script-operation.d.ts.map

package/dist/app-debug/script-operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-operation.d.ts","sourceRoot":"","sources":["../../src/app-debug/script-operation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,iDAAiD,CAAC;AAEzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,4FAA4F;AAC5F,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD,8DAA8D;AAC9D,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEjC,yDAAyD;AACzD,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,kBAAkB,CAEpB;AAED,sDAAsD;AACtD,MAAM,MAAM,uBAAuB,GAAG,CACpC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,KAClB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,gBAAgB,CAAA;CAAE,GAAG,IAAI,CAAC,CAAC;AAElE;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,GACb,gBAAgB,GAAG,IAAI,CAGzB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,KAAK,CAG7D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,GACxB,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhC"}

package/dist/app-debug/script-operation.js

@@ -0,0 +1,44 @@
+/**
+ * Script operations for the app simulator.
+ *
+ * The contract itself — the synthesized message stream and the port surface
+ * that stands in for a graph — lives in `@nodetool-ai/app-runtime`
+ * (`script-run.ts`), because the browser runs script operations too and cannot
+ * depend on this package. What is left here is the part that needs a parser:
+ * binding the pinned Zod document and deciding, from the body, whether the
+ * mapped values are staged as streams.
+ */
+import { scriptInvocationInput, scriptPortIO, scriptRunMessages } from "@nodetool-ai/app-runtime";
+import { jsScriptDocument } from "@nodetool-ai/protocol/api-schemas/js-scripts.js";
+import { usesStreamInputContract } from "@nodetool-ai/node-sdk/code-body";
+/**
+ * Split an operation's mapped values the way the body reads them — staged as
+ * one-item streams when the body reads `stream`, untouched otherwise.
+ */
+export function scriptOperationInvocation(document, inputs) {
+    return scriptInvocationInput(inputs, usesStreamInputContract(document.code));
+}
+/**
+ * Parse a document carried loosely (a bundle's structural shape) into the
+ * pinned contract, or null when it is not one. A bundle is untrusted input.
+ */
+export function parseCarriedScriptDocument(value) {
+    const parsed = jsScriptDocument.safeParse(value);
+    return parsed.success ? parsed.data : null;
+}
+/**
+ * A script's bindable surface. Port names stand in for node ids: a script
+ * declares no nodes, and its port names are what every mapping already keys on.
+ */
+export function scriptAppIO(document) {
+    const io = scriptPortIO(document);
+    return { ...io, variables: [] };
+}
+/**
+ * The message stream a script run would have produced: its emits in order,
+ * then its final outputs, then the job's terminal status.
+ */
+export function jsScriptRunMessages(result) {
+    return scriptRunMessages(result);
+}
+//# sourceMappingURL=script-operation.js.map

package/dist/app-debug/script-operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"script-operation.js","sourceRoot":"","sources":["../../src/app-debug/script-operation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAEjB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAwB1E;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAA0B,EAC1B,MAA+B;IAE/B,OAAO,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAc;IAEd,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAA0B;IACpD,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAClC,OAAO,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAyB;IAEzB,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,85 @@
+/**
+ * The app simulator: runs a resolved mini app headlessly.
+ *
+ * Parses the app document into a widget spec and a set of operations,
+ * statically validates the wiring, then simulates the app the way the web and
+ * mobile runtimes do: seed input and variable defaults, apply params, attach
+ * the resource collections the script seeds, execute the interaction script
+ * (each `run` action is a full workflow run on the injected server runner,
+ * subject to the operation's policy and timeout), fold the message stream into
+ * the app's reactive values, and re-evaluate every widget's conditions — a step
+ * no user could perform, because the widget is hidden or disabled, fails.
+ *
+ * Nothing here touches a database or a filesystem. The host resolves the target
+ * (`ResolvedAppTarget`), supplies the workflow runner, and writes whatever
+ * bundle it wants; the returned `AppDebugReport` is the whole result.
+ */
+import type { ProcessingMessage } from "@nodetool-ai/protocol";
+import type { DebugGraph, ServerRunReport } from "../debug/types.js";
+import { type InputSlot } from "@nodetool-ai/app-runtime";
+import { type JsScriptOperationLoader, type JsScriptOperationRunner } from "./script-operation.js";
+import type { AppDebugOptions, AppDebugReport, AppSpec, InteractionStep, ResolvedAppTarget } from "./types.js";
+/** What the simulator hands a host's workflow runner. */
+export interface AppServerRunInput {
+    graph: DebugGraph;
+    workflowId: string | null;
+    params: Record<string, unknown>;
+    timeoutMs?: number;
+}
+/** What it needs back: the run's report and the raw stream to fold. */
+export interface AppServerRunOutcome {
+    report: ServerRunReport;
+    rawMessages: ProcessingMessage[];
+}
+export interface AppSimulationDeps {
+    /** Load a workflow by DB id — an operation may name one the target lacks. */
+    loadFromDb: (id: string) => Promise<{
+        graph: DebugGraph;
+        app_doc?: unknown;
+    } | null>;
+    /** Execute one operation's workflow. */
+    runOnServer: (input: AppServerRunInput) => Promise<AppServerRunOutcome>;
+    /**
+     * Resolve a pinned script version a script operation targets and the target
+     * itself does not carry. Absent on a host with no script store, where such an
+     * operation reports as unresolvable instead of running something else.
+     */
+    loadScript?: JsScriptOperationLoader;
+    /**
+     * Execute one script operation. Absent on a host that cannot run a sandbox
+     * body, with the same consequence.
+     */
+    runScript?: JsScriptOperationRunner;
+    /** Progress/log sink. */
+    onLog?: (line: string) => void;
+    /**
+     * Persist one run's raw message stream, returning the path to record on the
+     * run report. Hosts that write no bundle omit it.
+     */
+    onRunMessages?: (runIndex: number, messages: ProcessingMessage[]) => Promise<string | null>;
+}
+/**
+ * The app's natural run trigger, mirroring what a user would do first: click
+ * the first `click`→`run` widget (a Run button), else touch the first
+ * `change`→`run` write widget.
+ */
+export declare function defaultInteractions(spec: AppSpec): InteractionStep[];
+/**
+ * Overlay the live values of node-property bindings onto the graph, the way the
+ * web runtime does before every run (`collectNodePropertyOverlays` →
+ * `withNodeProperties` in `web/src/components/appbuilder/nodeBinding.ts`).
+ *
+ * A widget bound `op:main/prop:node7#strength` writes an input slot keyed by
+ * node and property, which no input node reads — the value only reaches the run
+ * as a property of the node it names. The web helpers take ReactFlow nodes, so
+ * the mapping is repeated here against the kernel shape (`node.properties`);
+ * `parseInputStateKey` — the shared inverse of the state key — is what both
+ * sides actually agree on.
+ *
+ * Only the running operation's slots apply: two operations can bind the same
+ * node id in different workflows, so an unscoped merge would let one
+ * operation's slider drive the other's run.
+ */
+export declare function withNodePropertyOverlays(graph: DebugGraph, inputs: Record<string, InputSlot>, operationId: string): DebugGraph;
+export declare function simulateApp(resolved: ResolvedAppTarget, options: AppDebugOptions, deps: AppSimulationDeps): Promise<AppDebugReport>;
+//# sourceMappingURL=simulate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../../src/app-debug/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EACV,UAAU,EAEV,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAQL,KAAK,SAAS,EAGf,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAIL,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAgB/B,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEd,OAAO,EAGP,eAAe,EACf,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAUpB,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,CAAC;IACxB,WAAW,EAAE,iBAAiB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,UAAU,EAAE,CACV,EAAE,EAAE,MAAM,KACP,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC9D,wCAAwC;IACxC,WAAW,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxE;;;;OAIG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,yBAAyB;IACzB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,CACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,iBAAiB,EAAE,KAC1B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC7B;AAqCD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE,CAYpE;AAoDD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACjC,WAAW,EAAE,MAAM,GAClB,UAAU,CAyBZ;AA8WD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,cAAc,CAAC,CAspBzB"}