@xyne/workflow-sdk 3.2.4 → 3.2.6

package/dist/agents/builtin/chat-tools.d.ts

@@ -8,17 +8,23 @@
  * {@link SandboxAdapter}, never a baked-in backend.
  */
 import type { AgentTool } from '@earendil-works/pi-agent-core';
-import type { SandboxAdapter } from '../../sandbox/types.js';
+import type { SandboxAdapter, SandboxFileUpload } from '../../sandbox/types.js';
 /**
  * Wrap the built-in `run_code` {@link WorkflowTool} as a pi-agent-core
  * {@link AgentTool}, driving a fresh sandbox per call (create → run → destroy)
  * so each invocation is isolated. Always executes inside the host sandbox.
+ *
+ * `preloadFiles` are written into every fresh sandbox before the model's code
+ * runs — the approval chat uses this to mount the execution JSON at
+ * /mnt/files/execution.json so the model can read run data on demand without it
+ * ever entering the prompt.
  */
-export declare function createRunCodeAgentTool(sandbox: SandboxAdapter): AgentTool;
+export declare function createRunCodeAgentTool(sandbox: SandboxAdapter, preloadFiles?: SandboxFileUpload[]): AgentTool;
 /**
  * The full tool set available to the Ask AI chat agents. Returns `run_code` when
  * a sandbox is configured, else an empty list (the chat still works, just without
- * code execution). One place to extend chat tooling in the future.
+ * code execution). `preloadFiles` (e.g. the execution JSON) are mounted into the
+ * sandbox on every call.
  */
-export declare function createChatAgentTools(sandbox: SandboxAdapter | undefined): AgentTool[];
+export declare function createChatAgentTools(sandbox: SandboxAdapter | undefined, preloadFiles?: SandboxFileUpload[]): AgentTool[];
 //# sourceMappingURL=chat-tools.d.ts.map

package/dist/agents/builtin/chat-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-tools.d.ts","sourceRoot":"","sources":["../../../src/agents/builtin/chat-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAK7D;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAqBzE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,SAAS,EAAE,CAErF"}
+{"version":3,"file":"chat-tools.d.ts","sourceRoot":"","sources":["../../../src/agents/builtin/chat-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAKhF;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,YAAY,CAAC,EAAE,iBAAiB,EAAE,GACjC,SAAS,CAyBX;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,GAAG,SAAS,EACnC,YAAY,CAAC,EAAE,iBAAiB,EAAE,GACjC,SAAS,EAAE,CAEb"}

package/dist/agents/builtin/chat-tools.js

@@ -14,8 +14,13 @@ import { runCodeTool } from './run-code-tool.js';
  * Wrap the built-in `run_code` {@link WorkflowTool} as a pi-agent-core
  * {@link AgentTool}, driving a fresh sandbox per call (create → run → destroy)
  * so each invocation is isolated. Always executes inside the host sandbox.
+ *
+ * `preloadFiles` are written into every fresh sandbox before the model's code
+ * runs — the approval chat uses this to mount the execution JSON at
+ * /mnt/files/execution.json so the model can read run data on demand without it
+ * ever entering the prompt.
  */
-export function createRunCodeAgentTool(sandbox) {
+export function createRunCodeAgentTool(sandbox, preloadFiles) {
     return {
         name: runCodeTool.name,
         label: 'Run code',
@@ -25,8 +30,12 @@ export function createRunCodeAgentTool(sandbox) {
             const sig = signal ?? new AbortController().signal;
             const handle = await sandbox.create({ signal: sig });
             try {
+                const session = bindSandboxSession(sandbox, handle);
+                if (preloadFiles && preloadFiles.length > 0) {
+                    await session.writeFiles(preloadFiles);
+                }
                 const result = await runCodeTool.execute(params, {
-                    sandbox: bindSandboxSession(sandbox, handle),
+                    sandbox: session,
                     signal: sig,
                     log: { info: () => { }, warn: () => { }, error: () => { } },
                 });
@@ -41,9 +50,10 @@ export function createRunCodeAgentTool(sandbox) {
 /**
  * The full tool set available to the Ask AI chat agents. Returns `run_code` when
  * a sandbox is configured, else an empty list (the chat still works, just without
- * code execution). One place to extend chat tooling in the future.
+ * code execution). `preloadFiles` (e.g. the execution JSON) are mounted into the
+ * sandbox on every call.
  */
-export function createChatAgentTools(sandbox) {
-    return sandbox ? [createRunCodeAgentTool(sandbox)] : [];
+export function createChatAgentTools(sandbox, preloadFiles) {
+    return sandbox ? [createRunCodeAgentTool(sandbox, preloadFiles)] : [];
 }
 //# sourceMappingURL=chat-tools.js.map

package/dist/agents/builtin/chat-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-tools.js","sourceRoot":"","sources":["../../../src/agents/builtin/chat-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAuB;IAC5D,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,UAAU,EAAE,qBAAqB,CAAC,WAAW,CAAC,WAAW,CAA4B;QACrF,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAe,EAAE,MAAoB,EAAE,EAAE;YAC5E,MAAM,GAAG,GAAG,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,MAAmD,EAAE;oBAC5F,OAAO,EAAE,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC;oBAC5C,MAAM,EAAE,GAAG;oBACX,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE;iBACzD,CAAC,CAAC;gBACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YACjG,CAAC;oBAAS,CAAC;gBACT,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAA8B,CAAC,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAmC;IACtE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"chat-tools.js","sourceRoot":"","sources":["../../../src/agents/builtin/chat-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAuB,EACvB,YAAkC;IAElC,OAAO;QACL,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,UAAU,EAAE,qBAAqB,CAAC,WAAW,CAAC,WAAW,CAA4B;QACrF,OAAO,EAAE,KAAK,EAAE,WAAmB,EAAE,MAAe,EAAE,MAAoB,EAAE,EAAE;YAC5E,MAAM,GAAG,GAAG,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC,MAAM,CAAC;YACnD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACrD,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBACpD,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5C,MAAM,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;gBACzC,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,MAAmD,EAAE;oBAC5F,OAAO,EAAE,OAAO;oBAChB,MAAM,EAAE,GAAG;oBACX,GAAG,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE;iBACzD,CAAC,CAAC;gBACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YACjG,CAAC;oBAAS,CAAC;gBACT,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAA8B,CAAC,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAmC,EACnC,YAAkC;IAElC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC"}

package/dist/ai-builder/client.d.ts

@@ -1,5 +1,4 @@
 import type { AiBuilderMessage, BuilderChatResponse, ApprovalChatResponse, ChatStreamHandlers, WorkflowConfig } from './types.js';
-import type { ExecutionDetail } from '../client/types.js';
 export interface AiBuilderClientOptions {
     /**
      * Workflow API base URL — the same value passed to `createWorkflowClient`
@@ -18,11 +17,11 @@ export declare class AiBuilderClient {
     readonly baseUrl: string;
     constructor(options: AiBuilderClientOptions);
     chat(messages: AiBuilderMessage[], currentConfig: WorkflowConfig): Promise<BuilderChatResponse>;
-    approvalChat(messages: AiBuilderMessage[], executionContext: ExecutionDetail, currentFormValues?: Record<string, unknown>): Promise<ApprovalChatResponse>;
+    approvalChat(messages: AiBuilderMessage[], executionId: string, currentFormValues?: Record<string, unknown>): Promise<ApprovalChatResponse>;
     /** Streaming builder chat — text snapshots + tool chips + final patch. */
     chatStream(messages: AiBuilderMessage[], currentConfig: WorkflowConfig, handlers: ChatStreamHandlers, signal?: AbortSignal): Promise<void>;
     /** Streaming approval chat — text snapshots + tool chips + final form-fill. */
-    approvalChatStream(messages: AiBuilderMessage[], executionContext: ExecutionDetail, handlers: ChatStreamHandlers, currentFormValues?: Record<string, unknown>, signal?: AbortSignal): Promise<void>;
+    approvalChatStream(messages: AiBuilderMessage[], executionId: string, handlers: ChatStreamHandlers, currentFormValues?: Record<string, unknown>, signal?: AbortSignal): Promise<void>;
     /** POST + consume an SSE response, dispatching frames to `handlers`. */
     private _postStream;
     private _post;

package/dist/ai-builder/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ai-builder/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEI,OAAO,EAAE,sBAAsB;IAItD,IAAI,CACR,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,aAAa,EAAE,cAAc,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAKzB,YAAY,CAChB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,gBAAgB,EAAE,eAAe,EACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,OAAO,CAAC,oBAAoB,CAAC;IAKhC,0EAA0E;IACpE,UAAU,CACd,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,aAAa,EAAE,cAAc,EAC7B,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAIhB,+EAA+E;IACzE,kBAAkB,CACtB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,gBAAgB,EAAE,eAAe,EACjC,QAAQ,EAAE,kBAAkB,EAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAQhB,wEAAwE;YAC1D,WAAW;YAiEX,KAAK;CAiBpB"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/ai-builder/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEhB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEI,OAAO,EAAE,sBAAsB;IAItD,IAAI,CACR,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,aAAa,EAAE,cAAc,GAC5B,OAAO,CAAC,mBAAmB,CAAC;IAKzB,YAAY,CAChB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,WAAW,EAAE,MAAM,EACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,OAAO,CAAC,oBAAoB,CAAC;IAKhC,0EAA0E;IACpE,UAAU,CACd,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,aAAa,EAAE,cAAc,EAC7B,QAAQ,EAAE,kBAAkB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAIhB,+EAA+E;IACzE,kBAAkB,CACtB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,kBAAkB,EAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC3C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAQhB,wEAAwE;YAC1D,WAAW;YAiEX,KAAK;CAiBpB"}

package/dist/ai-builder/client.js

@@ -13,8 +13,8 @@ export class AiBuilderClient {
         const body = { messages, currentConfig };
         return this._post(body);
     }
-    async approvalChat(messages, executionContext, currentFormValues) {
-        const body = { messages, mode: 'approval', executionContext, ...(currentFormValues ? { currentFormValues } : {}) };
+    async approvalChat(messages, executionId, currentFormValues) {
+        const body = { messages, mode: 'approval', executionId, ...(currentFormValues ? { currentFormValues } : {}) };
         return this._post(body);
     }
     /** Streaming builder chat — text snapshots + tool chips + final patch. */
@@ -22,8 +22,8 @@ export class AiBuilderClient {
         return this._postStream({ messages, currentConfig }, handlers, signal);
     }
     /** Streaming approval chat — text snapshots + tool chips + final form-fill. */
-    async approvalChatStream(messages, executionContext, handlers, currentFormValues, signal) {
-        return this._postStream({ messages, mode: 'approval', executionContext, ...(currentFormValues ? { currentFormValues } : {}) }, handlers, signal);
+    async approvalChatStream(messages, executionId, handlers, currentFormValues, signal) {
+        return this._postStream({ messages, mode: 'approval', executionId, ...(currentFormValues ? { currentFormValues } : {}) }, handlers, signal);
     }
     /** POST + consume an SSE response, dispatching frames to `handlers`. */
     async _postStream(body, handlers, signal) {

package/dist/ai-builder/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/ai-builder/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/ai-builder/client.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,MAAM,OAAO,eAAe;IAGG;IAFpB,OAAO,CAAS;IAEzB,YAA6B,OAA+B;QAA/B,YAAO,GAAP,OAAO,CAAwB;QAC1D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,QAA4B,EAC5B,aAA6B;QAE7B,MAAM,IAAI,GAAyB,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,QAA4B,EAC5B,WAAmB,EACnB,iBAA2C;QAE3C,MAAM,IAAI,GAAyB,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACpI,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkC,CAAC;IAC3D,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,UAAU,CACd,QAA4B,EAC5B,aAA6B,EAC7B,QAA4B,EAC5B,MAAoB;QAEpB,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzE,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,kBAAkB,CACtB,QAA4B,EAC5B,WAAmB,EACnB,QAA4B,EAC5B,iBAA2C,EAC3C,MAAoB;QAEpB,OAAO,IAAI,CAAC,WAAW,CACrB,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAChG,QAAQ,EACR,MAAM,CACP,CAAC;IACJ,CAAC;IAED,wEAAwE;IAChE,KAAK,CAAC,WAAW,CACvB,IAA0B,EAC1B,QAA4B,EAC5B,MAAoB;QAEpB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,kBAAkB,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,MAAM,EAAE,mBAAmB;gBAC3B,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE;aAC/B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,UAAU,GAAG,KAAK,CAAC;QAEvB,MAAM,QAAQ,GAAG,CAAC,SAAiB,EAAE,IAAY,EAAQ,EAAE;YACzD,IAAI,OAAO,GAA4B,EAAE,CAAC;YAC1C,IAAI,CAAC;gBAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC9F,QAAQ,SAAS,EAAE,CAAC;gBAClB,KAAK,MAAM;oBAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;oBAAC,MAAM;gBACrE,KAAK,MAAM;oBAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,OAA8F,CAAC,CAAC;oBAAC,MAAM;gBACtI,KAAK,UAAU;oBAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,UAAU,CAA4B,CAAC,CAAC;oBAAC,MAAM;gBAC9F,KAAK,OAAO;oBAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,eAAe,CAAmB,CAAC,CAAC;oBAAC,MAAM;gBACpF,KAAK,MAAM;oBAAE,UAAU,GAAG,IAAI,CAAC;oBAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;oBAAC,MAAM;gBAC3F,KAAK,OAAO;oBAAE,UAAU,GAAG,IAAI,CAAC;oBAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,CAAC,CAAC;oBAAC,MAAM;gBACxG,OAAO,CAAC,CAAC,MAAM;YACjB,CAAC;QACH,CAAC,CAAC;QAEF,mFAAmF;QACnF,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,IAAI,GAAW,CAAC;YAChB,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACjC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;gBAC/B,IAAI,SAAS,GAAG,SAAS,CAAC;gBAC1B,IAAI,IAAI,GAAG,EAAE,CAAC;gBACd,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;wBAAE,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;yBAC3D,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;wBAAE,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAClE,CAAC;gBACD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,+EAA+E;QAC/E,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QACtG,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,KAAK,CAAC,IAA0B;QAC5C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,kBAAkB,EAAE;YACzD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE;aAC/B;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC1D,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,GAAG,CAAC,IAAI,EAAyD,CAAC;IAC3E,CAAC;CACF"}

package/dist/ai-builder/types.d.ts

@@ -1,5 +1,4 @@
 import type { WorkflowConfig } from '../types/workflow-config.js';
-import type { ExecutionDetail } from '../client/types.js';
 export type { WorkflowConfig };
 export interface AiBuilderToolCall {
     name: string;
@@ -30,11 +29,11 @@ export interface BuilderChatRequest {
     mode?: 'builder';
     currentConfig: WorkflowConfig;
 }
-/** Approval mode — sends execution detail, may receive form fill. */
+/** Approval mode — identifies the execution, may receive form fill. */
 export interface ApprovalChatRequest {
     messages: AiBuilderMessage[];
     mode: 'approval';
-    executionContext: ExecutionDetail;
+    executionId: string;
     /** Live form values at the moment the message was sent. */
     currentFormValues?: Record<string, unknown>;
 }

package/dist/ai-builder/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai-builder/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAGD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAClG,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,mDAAmD;IACnD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,cAAc,CAAC;CAC/B;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,gBAAgB,EAAE,eAAe,CAAC;IAClC,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai-builder/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,YAAY,EAAE,cAAc,EAAE,CAAC;AAE/B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAGD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAClG,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACzD,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,mDAAmD;IACnD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,iEAAiE;AACjE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,cAAc,CAAC;CAC/B;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC"}

package/dist/engine/node-path.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Node-path addressing for durable pause/resume.
+ *
+ * Every executing step — top-level or nested inside any control-flow branch —
+ * has a stable, content-addressed key derived from the chain of branch frames
+ * that enclose it. This key is the step's persisted `stepName`, so a step's
+ * record is the single source of truth for its state (completed / parked /
+ * awaiting review). Resume routes a payload to a step by this key; the walk
+ * memoizes completed steps by this key. No positional indices, no separate
+ * pause cursor.
+ *
+ * Grammar:
+ *   record key   = stepId                              (top level)
+ *                | <framePrefix>/stepId                (inside a branch)
+ *   frame prefix = <controlStepKey>:<branchKey>#<iter>
+ *   controlStepKey = the record key of the enclosing control-flow step
+ *
+ * Examples:
+ *   "extract"                                  top-level step
+ *   "parallel_x:swot#0/inner1"                 step in PARALLEL branch "swot"
+ *   "loop_y:body#3/summarize"                  step in LOOP iteration 3
+ *   "parallel_x:swot#0/loop_z:body#2/deep"     arbitrarily nested
+ *
+ * Because the key is computed structurally from the workflow definition, it is
+ * identical on every walk — which is what makes memoized resume work at any
+ * depth, and lets two concurrent gates (different keys) resume independently.
+ */
+/** The record key (persisted `stepName`) for a step at the given scope prefix. */
+export declare function recordKey(prefix: string, stepId: string): string;
+/**
+ * The scope prefix for a branch frame: a `<branchKey>#<iter>` frame qualified by
+ * the enclosing control step's own record key. `iter` distinguishes LOOP
+ * iterations (always 0 for single-branch control steps).
+ */
+export declare function framePrefix(parentPrefix: string, controlStepId: string, branchKey: string, iter: number): string;
+/**
+ * The bare step id at the end of a record key — the last path segment, stripped
+ * of any frame qualifier. Used to map a paused record back to its config step
+ * (e.g. for the approvals queue display) and for SSE event keying.
+ *
+ *   "extract"                              -> "extract"
+ *   "parallel_x:swot#0/gate"               -> "gate"
+ *   "loop_y:body#3/agent_summarize"        -> "agent_summarize"
+ */
+export declare function leafStepId(recordName: string): string;
+//# sourceMappingURL=node-path.d.ts.map

package/dist/engine/node-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-path.d.ts","sourceRoot":"","sources":["../../src/engine/node-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,MAAM,CAER;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAMrD"}

package/dist/engine/node-path.js

@@ -0,0 +1,56 @@
+/**
+ * Node-path addressing for durable pause/resume.
+ *
+ * Every executing step — top-level or nested inside any control-flow branch —
+ * has a stable, content-addressed key derived from the chain of branch frames
+ * that enclose it. This key is the step's persisted `stepName`, so a step's
+ * record is the single source of truth for its state (completed / parked /
+ * awaiting review). Resume routes a payload to a step by this key; the walk
+ * memoizes completed steps by this key. No positional indices, no separate
+ * pause cursor.
+ *
+ * Grammar:
+ *   record key   = stepId                              (top level)
+ *                | <framePrefix>/stepId                (inside a branch)
+ *   frame prefix = <controlStepKey>:<branchKey>#<iter>
+ *   controlStepKey = the record key of the enclosing control-flow step
+ *
+ * Examples:
+ *   "extract"                                  top-level step
+ *   "parallel_x:swot#0/inner1"                 step in PARALLEL branch "swot"
+ *   "loop_y:body#3/summarize"                  step in LOOP iteration 3
+ *   "parallel_x:swot#0/loop_z:body#2/deep"     arbitrarily nested
+ *
+ * Because the key is computed structurally from the workflow definition, it is
+ * identical on every walk — which is what makes memoized resume work at any
+ * depth, and lets two concurrent gates (different keys) resume independently.
+ */
+/** The record key (persisted `stepName`) for a step at the given scope prefix. */
+export function recordKey(prefix, stepId) {
+    return prefix ? `${prefix}/${stepId}` : stepId;
+}
+/**
+ * The scope prefix for a branch frame: a `<branchKey>#<iter>` frame qualified by
+ * the enclosing control step's own record key. `iter` distinguishes LOOP
+ * iterations (always 0 for single-branch control steps).
+ */
+export function framePrefix(parentPrefix, controlStepId, branchKey, iter) {
+    return `${recordKey(parentPrefix, controlStepId)}:${branchKey}#${String(iter)}`;
+}
+/**
+ * The bare step id at the end of a record key — the last path segment, stripped
+ * of any frame qualifier. Used to map a paused record back to its config step
+ * (e.g. for the approvals queue display) and for SSE event keying.
+ *
+ *   "extract"                              -> "extract"
+ *   "parallel_x:swot#0/gate"               -> "gate"
+ *   "loop_y:body#3/agent_summarize"        -> "agent_summarize"
+ */
+export function leafStepId(recordName) {
+    const lastSegment = recordName.slice(recordName.lastIndexOf('/') + 1);
+    // A leaf segment is a bare step id; a frame segment (which never appears last)
+    // would contain ':'. Guard anyway by trimming a frame qualifier if present.
+    const colon = lastSegment.indexOf(':');
+    return colon >= 0 ? lastSegment.slice(0, colon) : lastSegment;
+}
+//# sourceMappingURL=node-path.js.map

package/dist/engine/node-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-path.js","sourceRoot":"","sources":["../../src/engine/node-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,MAAc;IACtD,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,YAAoB,EACpB,aAAqB,EACrB,SAAiB,EACjB,IAAY;IAEZ,OAAO,GAAG,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;AAClF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,UAAkB;IAC3C,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,+EAA+E;IAC/E,4EAA4E;IAC5E,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;AAChE,CAAC"}

package/dist/engine/workflow-executor.d.ts

@@ -30,9 +30,28 @@ export interface ExecutorLogger {
 /**
  * Core runtime engine for executing workflows.
  *
- * Orchestrates: step execution, variable resolution, pause/resume
- * (including inside branches), error handling (onError: continue),
- * retry, timeout, credential resolution, and state persistence.
+ * Orchestrates: step execution, variable resolution, durable pause/resume at
+ * any nesting depth (content-addressed step memoization + level-triggered
+ * reconciliation), error handling (onError: continue), retry, timeout,
+ * credential resolution, and state persistence.
+ *
+ * ## Pause/resume model
+ *
+ * Every step — top-level or nested in any control-flow branch — is keyed by a
+ * **node-path** (see `node-path.ts`). The walk always starts from the root and
+ * each step self-decides from its persisted record:
+ *
+ * - `COMPLETED` → restore output, skip (memoized; never re-executes).
+ * - `EXTERNAL_WAIT` leaf → resume via `onResume` if its record carries a
+ *   `resumePayload`, otherwise re-park (still waiting).
+ * - `REVIEW_WAIT` → apply the review decision (approve / retry / abort).
+ * - control step with `EXTERNAL_WAIT` → re-execute (re-enter its branches; the
+ *   completed branch steps memo-skip, the parked one resumes).
+ *
+ * Pausing throws to unwind — it carries no positional path, because the records
+ * hold the position. Resume = a payload written into the target node's record +
+ * re-enqueue; the next walk reconciles. N concurrent pauses, nested arbitrarily,
+ * fall out for free.
  *
  * Host provides: PersistenceAdapter, StepRegistry, TriggerRegistry,
  * ServiceRegistry, and an optional logger.
@@ -56,8 +75,9 @@ export declare class WorkflowExecutor<TServices extends Record<string, unknown>
     /**
      * Run or resume an execution by ID.
      *
-     * Loads the execution from persistence, determines if it's a fresh start
-     * or a resume, then walks through the steps.
+     * Loads the execution from persistence, preloads its step records into the
+     * memo map, then walks the steps from the root. Completed steps short-circuit
+     * from the memo; the one (or many) parked step(s) resume from their records.
      */
     runExecution(executionId: string): Promise<void>;
     /**
@@ -71,11 +91,10 @@ export declare class WorkflowExecutor<TServices extends Record<string, unknown>
      * Create a new execution that reruns from `fromStepId`, using the source
      * execution's cached outputs for all prior steps as the resolved context.
      *
-     * The new execution starts at `fromStepIndex` (not 0). Steps before that
-     * are pre-populated in `context.steps` so variable resolution finds them.
-     * The step at `fromStepIndex` receives the source row's data as
-     * `ctx.priorState` (when `inheritStepState` is true, the default), enabling
-     * agents and other stateful steps to continue from where they left off.
+     * Prior steps are written as COMPLETED records on the new execution, so the
+     * memoized walk skips them. The step at `fromStepId` receives the source
+     * row's data as `ctx.priorState` (when `inheritStepState` is true, the
+     * default), enabling agents and other stateful steps to continue.
      *
      * Returns the new execution ID. Caller is responsible for enqueueing it.
      */
@@ -83,22 +102,31 @@ export declare class WorkflowExecutor<TServices extends Record<string, unknown>
         configOverrides?: Record<string, unknown>;
         inheritStepState?: boolean;
     }): Promise<string>;
-    private runSteps;
-    private walkSteps;
-    private executeStepWithRetry;
-    private executeStep;
+    private runWorkflow;
     /**
-     * Walk steps inside a control-flow branch. Supports nested pause.
+     * Walk a scope of steps (the root scope, or one control-flow branch).
      *
-     * Each sub-step is persisted as its own row (keyed by config `id`) and
-     * emits SSE events, mirroring the top-level `walkSteps` behavior.
+     * `prefix` is the node-path prefix for this scope (`''` at the root, a frame
+     * prefix like `parallel_x:swot#0` inside a branch). Each step is addressed by
+     * `recordKey(prefix, step.id)`. The walk always starts from the first step;
+     * memoized records short-circuit completed steps so nothing re-executes.
      *
-     * When a step pauses inside a branch, the PauseStep error is enriched
-     * with branch path information and re-thrown so the top-level walkSteps
-     * can persist the full PausePath.
+     * Throws `PauseStep` to unwind when a step (leaf or control) is parked, and
+     * `AbortExecution` on a review-gate abort. Settings-driven retry / onError
+     * apply at the root only — inside a branch, errors propagate so the enclosing
+     * control step (e.g. PARALLEL) can record them.
      */
-    private walkBranchSteps;
-    private invokeResume;
+    private walkScope;
+    /** Persist a step record + mirror it into the in-memory memo for this run. */
+    private persistStep;
+    private executeStepWithRetry;
+    /**
+     * Execute one step. Control steps recurse into their branches via the
+     * `walkBranch` closure (which addresses each branch with a node-path frame).
+     * Action steps resolve config then either `execute()` fresh or `onResume()`
+     * when `resumeData` (the parked record) is supplied.
+     */
+    private executeStep;
     private buildStepContext;
 }
 //# sourceMappingURL=workflow-executor.d.ts.map

package/dist/engine/workflow-executor.d.ts.map

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