@hexabot-ai/agentic 3.1.2-alpha.1 → 3.1.2-alpha.11

package/dist/esm/suspension-rebuilder.js

@@ -6,6 +6,7 @@
 import { executeLoop as runLoopExecutor, shouldStopLoop, updateAccumulator, } from './step-executors/loop-executor';
 import { executeParallel as runParallelExecutor } from './step-executors/parallel-executor';
 import { markStepsSkipped } from './step-executors/skip-helpers';
+import { wrapSuspensionContinuation } from './step-executors/suspension-continuation';
 import { StepType, } from './workflow-event-emitter';
 /**
  * Parse a suspended step id into its execution path and iteration stack.
@@ -149,16 +150,7 @@ export function buildSuspensionForPath(deps, steps, state, targetPath, pathPrefi
                     }
                     const resumed = await executeStep(step, state, currentPath);
                     if (resumed) {
-                        return {
-                            ...resumed,
-                            continue: async (nextResumeData) => {
-                                const next = await resumed.continue(nextResumeData);
-                                if (next) {
-                                    return next;
-                                }
-                                return deps.executeFlow(steps, state, pathPrefix, current + 1);
-                            },
-                        };
+                        return wrapSuspensionContinuation(resumed, () => deps.executeFlow(steps, state, pathPrefix, current + 1));
                     }
                     return deps.executeFlow(steps, state, pathPrefix, current + 1);
                 }
@@ -183,22 +175,19 @@ export function buildSuspensionForPath(deps, steps, state, targetPath, pathPrefi
             return null;
         }
         const childIndex = typeof childPath[0] === 'number' ? childPath[0] : 0;
-        return {
-            ...childSuspension,
-            continue: async (resumeData) => {
-                const next = await childSuspension.continue(resumeData);
-                if (next) {
-                    return next;
+        return wrapSuspensionContinuation(childSuspension, async () => {
+            if (step.strategy === 'wait_any') {
+                if (childIndex + 1 < step.steps.length) {
+                    markStepsSkipped(env, step.steps.slice(childIndex + 1), state.iterationStack ?? []);
                 }
-                if (step.strategy === 'wait_any') {
-                    if (childIndex + 1 < step.steps.length) {
-                        markStepsSkipped(env, step.steps.slice(childIndex + 1), state.iterationStack ?? []);
-                    }
-                    return undefined;
-                }
-                return runParallelExecutor(env, step, state, currentPath, childIndex + 1);
-            },
-        };
+                return deps.executeFlow(steps, state, pathPrefix, current + 1);
+            }
+            const next = await runParallelExecutor(env, step, state, currentPath, childIndex + 1);
+            if (next) {
+                return wrapSuspensionContinuation(next, () => deps.executeFlow(steps, state, pathPrefix, current + 1));
+            }
+            return deps.executeFlow(steps, state, pathPrefix, current + 1);
+        });
     }
     if (step.type === StepType.Conditional) {
         if (rest[0] !== 'branch' || typeof rest[1] !== 'number') {
@@ -214,16 +203,7 @@ export function buildSuspensionForPath(deps, steps, state, targetPath, pathPrefi
         if (!branchSuspension) {
             return null;
         }
-        return {
-            ...branchSuspension,
-            continue: async (resumeData) => {
-                const next = await branchSuspension.continue(resumeData);
-                if (next) {
-                    return next;
-                }
-                return deps.executeFlow(steps, state, pathPrefix, current + 1);
-            },
-        };
+        return wrapSuspensionContinuation(branchSuspension, () => deps.executeFlow(steps, state, pathPrefix, current + 1));
     }
     if (step.type === StepType.Loop) {
         if (rest.length < 1 || typeof rest[0] !== 'string') {
@@ -251,46 +231,53 @@ export function buildSuspensionForPath(deps, steps, state, targetPath, pathPrefi
             return null;
         }
         const accumulator = iterationState.accumulator ?? state.accumulator ?? undefined;
-        return {
-            ...childSuspension,
-            continue: async (resumeData) => {
-                const next = await childSuspension.continue(resumeData);
-                if (next) {
-                    return next;
-                }
-                const scope = {
-                    input: iterationState.input,
-                    context: env.context.state,
-                    output: iterationState.output,
-                    iteration: iterationState.iteration ?? {
-                        item: undefined,
-                        index: iterationIndex,
-                    },
-                    accumulator,
-                };
-                const updatedAccumulator = await updateAccumulator(step, scope, accumulator);
-                const shouldStop = await shouldStopLoop(step, scope);
-                state.output = iterationState.output;
-                if (step.accumulate && step.name) {
-                    state.output[step.name] = {
-                        [step.accumulate.as]: updatedAccumulator,
-                    };
-                }
-                if (step.accumulate) {
-                    state.accumulator = updatedAccumulator;
-                }
-                if (shouldStop) {
-                    return undefined;
-                }
-                const baseState = {
-                    ...iterationState,
-                    iterationStack: ancestorIterationStack,
-                    accumulator: updatedAccumulator,
-                    output: state.output,
+        return wrapSuspensionContinuation(childSuspension, async () => {
+            const scope = {
+                input: iterationState.input,
+                context: env.context.state,
+                output: iterationState.output,
+                iteration: iterationState.iteration ?? {
+                    item: undefined,
+                    index: iterationIndex,
+                },
+                accumulator,
+            };
+            const updatedAccumulator = await updateAccumulator(step, scope, accumulator);
+            const shouldStop = await shouldStopLoop(step, scope);
+            state.output = iterationState.output;
+            if (step.accumulate && step.name) {
+                state.output[step.name] = {
+                    [step.accumulate.as]: updatedAccumulator,
                 };
-                return runLoopExecutor(env, step, baseState, currentPath, iterationIndex + 1);
-            },
-        };
+            }
+            if (step.accumulate) {
+                state.accumulator = updatedAccumulator;
+            }
+            if (shouldStop) {
+                return deps.executeFlow(steps, state, pathPrefix, current + 1);
+            }
+            const baseState = {
+                ...iterationState,
+                iterationStack: ancestorIterationStack,
+                accumulator: updatedAccumulator,
+                output: state.output,
+            };
+            const next = await runLoopExecutor(env, step, baseState, currentPath, iterationIndex + 1);
+            state.output = baseState.output;
+            if (step.accumulate) {
+                state.accumulator = baseState.accumulator;
+            }
+            if (next) {
+                return wrapSuspensionContinuation(next, async () => {
+                    state.output = baseState.output;
+                    if (step.accumulate) {
+                        state.accumulator = baseState.accumulator;
+                    }
+                    return deps.executeFlow(steps, state, pathPrefix, current + 1);
+                });
+            }
+            return deps.executeFlow(steps, state, pathPrefix, current + 1);
+        });
     }
     return null;
 }

package/dist/esm/utils/workflow-definition-resources.js

@@ -0,0 +1,68 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2026 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+const getSettingsRef = (definition, settingsKey) => {
+    const settings = definition.settings;
+    if (!settings || typeof settings !== 'object') {
+        return null;
+    }
+    const value = settings[settingsKey];
+    return typeof value === 'string' && value.trim() ? value : null;
+};
+/**
+ * Collect external resource IDs referenced by workflow definition defs.
+ */
+export const collectWorkflowDefinitionResourceRefs = (definition, descriptors) => {
+    const result = Object.fromEntries(descriptors.map((descriptor) => [descriptor.kind, new Set()]));
+    for (const def of Object.values(definition.defs ?? {})) {
+        for (const descriptor of descriptors) {
+            if (def.kind !== descriptor.kind) {
+                continue;
+            }
+            const ref = getSettingsRef(def, descriptor.settingsKey);
+            if (ref) {
+                result[descriptor.kind].add(ref);
+            }
+        }
+    }
+    return Object.fromEntries(Object.entries(result).map(([kind, refs]) => [kind, Array.from(refs)]));
+};
+/**
+ * Rewrite external resource IDs referenced by workflow definition defs.
+ */
+export const remapWorkflowDefinitionResourceRefs = (definition, descriptors, idMaps) => {
+    let didChange = false;
+    const nextDefs = Object.fromEntries(Object.entries(definition.defs ?? {}).map(([defName, def]) => {
+        const descriptor = descriptors.find((item) => item.kind === def.kind);
+        if (!descriptor) {
+            return [defName, def];
+        }
+        const currentRef = getSettingsRef(def, descriptor.settingsKey);
+        const nextRef = currentRef
+            ? idMaps[descriptor.kind]?.[currentRef]
+            : undefined;
+        if (!currentRef || !nextRef || nextRef === currentRef) {
+            return [defName, def];
+        }
+        didChange = true;
+        return [
+            defName,
+            {
+                ...def,
+                settings: {
+                    ...(def.settings ?? {}),
+                    [descriptor.settingsKey]: nextRef,
+                },
+            },
+        ];
+    }));
+    if (!didChange) {
+        return definition;
+    }
+    return {
+        ...definition,
+        defs: nextDefs,
+    };
+};

package/dist/esm/workflow-runner.js

@@ -8,6 +8,7 @@ import { RunnerRuntimeControl } from './runner-runtime-control';
 import { executeConditional as runConditionalExecutor } from './step-executors/conditional-executor';
 import { executeLoop as runLoopExecutor } from './step-executors/loop-executor';
 import { executeParallel as runParallelExecutor } from './step-executors/parallel-executor';
+import { wrapSuspensionContinuation } from './step-executors/suspension-continuation';
 import { executeTaskStep as runTaskExecutor } from './step-executors/task-executor';
 import { rebuildSuspension, } from './suspension-rebuilder';
 import { StepType, } from './workflow-event-emitter';
@@ -405,16 +406,7 @@ export class WorkflowRunner {
             const stepPath = [...path, index];
             const suspension = await this.executeStep(step, state, stepPath);
             if (suspension) {
-                return {
-                    ...suspension,
-                    continue: async (resumeData) => {
-                        const next = await suspension.continue(resumeData);
-                        if (next) {
-                            return next;
-                        }
-                        return this.executeFlow(steps, state, path, index + 1);
-                    },
-                };
+                return wrapSuspensionContinuation(suspension, () => this.executeFlow(steps, state, path, index + 1));
             }
         }
         return undefined;

package/dist/types/index.d.ts

@@ -15,4 +15,5 @@ export { createDeferred } from './utils/deferred';
 export type { Deferred } from './utils/deferred';
 export { assertSnakeCaseName, isSnakeCaseName, toSnakeCase, } from './utils/naming';
 export { sleep, withTimeout } from './utils/timeout';
+export { collectWorkflowDefinitionResourceRefs, remapWorkflowDefinitionResourceRefs, type WorkflowDefinitionResourceDescriptor, type WorkflowDefinitionResourceIdMaps, type WorkflowDefinitionResourceRefs, } from './utils/workflow-definition-resources';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAEnB,cAAc,aAAa,CAAC;AAE5B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,YAAY,EACV,QAAQ,EACR,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,QAAQ,IAAI,gBAAgB,EAC5B,iBAAiB,IAAI,yBAAyB,EAC9C,eAAe,IAAI,uBAAuB,EAC1C,QAAQ,IAAI,gBAAgB,EAC5B,eAAe,EACf,YAAY,IAAI,oBAAoB,EACpC,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,QAAQ,IAAI,gBAAgB,EAC5B,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,IAAI,qBAAqB,EACrC,WAAW,IAAI,oBAAoB,GACpC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,YAAY,EACV,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAEnB,cAAc,aAAa,CAAC;AAE5B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,EAClB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,eAAe,EACf,QAAQ,EACR,oBAAoB,EACpB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,YAAY,EACV,QAAQ,EACR,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,QAAQ,IAAI,gBAAgB,EAC5B,iBAAiB,IAAI,yBAAyB,EAC9C,eAAe,IAAI,uBAAuB,EAC1C,QAAQ,IAAI,gBAAgB,EAC5B,eAAe,EACf,YAAY,IAAI,oBAAoB,EACpC,YAAY,EACZ,YAAY,EACZ,oBAAoB,EACpB,QAAQ,IAAI,gBAAgB,EAC5B,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,IAAI,qBAAqB,EACrC,WAAW,IAAI,oBAAoB,GACpC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAEzE,OAAO,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,YAAY,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EACL,qCAAqC,EACrC,mCAAmC,EACnC,KAAK,oCAAoC,EACzC,KAAK,gCAAgC,EACrC,KAAK,8BAA8B,GACpC,MAAM,uCAAuC,CAAC"}

package/dist/types/step-executors/loop-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-executor.d.ts","sourceRoot":"","sources":["../../../src/step-executors/loop-executor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEd,QAAQ,EACR,UAAU,EAEX,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,KAAK,SAAS,GAAG,eAAe,CAAC;AAEjC;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAM5B;AA+LD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,OAAO,CAAC,CAQlB"}
+{"version":3,"file":"loop-executor.d.ts","sourceRoot":"","sources":["../../../src/step-executors/loop-executor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EAEd,QAAQ,EACR,UAAU,EAEX,MAAM,mBAAmB,CAAC;AAI3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,KAAK,SAAS,GAAG,eAAe,CAAC;AAEjC;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAM5B;AA+KD;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/types/step-executors/parallel-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parallel-executor.d.ts","sourceRoot":"","sources":["../../../src/step-executors/parallel-executor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,UAAU,EACX,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA6C5B"}
+{"version":3,"file":"parallel-executor.d.ts","sourceRoot":"","sources":["../../../src/step-executors/parallel-executor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,UAAU,EACX,MAAM,mBAAmB,CAAC;AAI3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAC5B,UAAU,SAAI,GACb,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAqC5B"}

package/dist/types/step-executors/suspension-continuation.d.ts

@@ -0,0 +1,10 @@
+import type { Suspension } from '../workflow-types';
+/**
+ * Compose a suspension with the continuation that should run once it completes.
+ *
+ * When resuming a suspension yields another suspension from the same logical
+ * step, the follow-up suspension still needs to remember how to continue the
+ * surrounding flow after that step eventually finishes.
+ */
+export declare function wrapSuspensionContinuation(suspension: Suspension, onComplete: () => Promise<Suspension | void>): Suspension;
+//# sourceMappingURL=suspension-continuation.d.ts.map

package/dist/types/step-executors/suspension-continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspension-continuation.d.ts","sourceRoot":"","sources":["../../../src/step-executors/suspension-continuation.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,GAC3C,UAAU,CAYZ"}

package/dist/types/suspension-rebuilder.d.ts.map

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

package/dist/types/utils/workflow-definition-resources.d.ts

@@ -0,0 +1,16 @@
+import type { WorkflowDefinition } from '../dsl.types';
+export type WorkflowDefinitionResourceDescriptor = {
+    kind: string;
+    settingsKey: string;
+};
+export type WorkflowDefinitionResourceRefs = Record<string, string[]>;
+export type WorkflowDefinitionResourceIdMaps = Record<string, Record<string, string>>;
+/**
+ * Collect external resource IDs referenced by workflow definition defs.
+ */
+export declare const collectWorkflowDefinitionResourceRefs: (definition: WorkflowDefinition, descriptors: WorkflowDefinitionResourceDescriptor[]) => WorkflowDefinitionResourceRefs;
+/**
+ * Rewrite external resource IDs referenced by workflow definition defs.
+ */
+export declare const remapWorkflowDefinitionResourceRefs: (definition: WorkflowDefinition, descriptors: WorkflowDefinitionResourceDescriptor[], idMaps: WorkflowDefinitionResourceIdMaps) => WorkflowDefinition;
+//# sourceMappingURL=workflow-definition-resources.d.ts.map

package/dist/types/utils/workflow-definition-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-definition-resources.d.ts","sourceRoot":"","sources":["../../../src/utils/workflow-definition-resources.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAiB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEtE,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEtE,MAAM,MAAM,gCAAgC,GAAG,MAAM,CACnD,MAAM,EACN,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CACvB,CAAC;AAgBF;;GAEG;AACH,eAAO,MAAM,qCAAqC,GAChD,YAAY,kBAAkB,EAC9B,aAAa,oCAAoC,EAAE,KAClD,8BAqBF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mCAAmC,GAC9C,YAAY,kBAAkB,EAC9B,aAAa,oCAAoC,EAAE,EACnD,QAAQ,gCAAgC,KACvC,kBAwCF,CAAC"}

package/dist/types/workflow-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-runner.d.ts","sourceRoot":"","sources":["../../src/workflow-runner.ts"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAWnB,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAGV,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EAEX,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,qBAAa,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAG5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAGhC,OAAO,CAAC,MAAM,CAA8C;IAG5D,OAAO,CAAC,SAAS,CAAsC;IAGvD,OAAO,CAAC,OAAO,CAA2C;IAG1D,OAAO,CAAC,UAAU,CAAC,CAAa;IAGhC,OAAO,CAAC,cAAc,CAAC,CAAuB;IAG9C,OAAO,CAAC,WAAW,CAAC,CAAW;IAG/B,OAAO,CAAC,cAAc,CAAC,CAAU;IAGjC,OAAO,CAAC,KAAK,CAAC,CAAiB;IAG/B,OAAO,CAAC,OAAO,CAAC,CAAsB;IAEtC;;;;;OAKG;gBACS,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAKpE;;;;OAIG;IACH,QAAQ,IAAI,cAAc,GAAG,SAAS;IAItC;;;;OAIG;IACH,SAAS,IAAI,iBAAiB;IAI9B;;;;OAIG;IACH,WAAW,IAAI,gBAAgB;IAO/B;;;;OAIG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAajD;;;;OAIG;IACH,cAAc,IAAI,QAAQ,GAAG,SAAS;IAItC;;;;OAIG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BxD;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB3D;;;;;OAKG;YACW,YAAY;IA0D1B;;;;;;OAMG;WACU,kBAAkB,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE;QACP,KAAK,EAAE,cAAc,CAAC;QACtB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,UAAU,CAAC,EAAE,mBAAmB,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GACA,OAAO,CAAC,cAAc,CAAC;IAgD1B;;;;;OAKG;IACH,OAAO,CAAC,IAAI;IAOZ;;;;;;OAMG;YACW,uBAAuB;IAYrC;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAqDzB;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAkBrC;;;;;;;;OAQG;YACW,WAAW;IA8BzB;;;;;;;OAOG;YACW,WAAW;IAkBzB;;;;;;OAMG;YACW,iBAAiB;CAOhC"}
+{"version":3,"file":"workflow-runner.d.ts","sourceRoot":"","sources":["../../src/workflow-runner.ts"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAYnB,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAGV,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,WAAW,EAEX,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAG1B;;;GAGG;AACH,qBAAa,cAAc;IAEzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAG5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAGhC,OAAO,CAAC,MAAM,CAA8C;IAG5D,OAAO,CAAC,SAAS,CAAsC;IAGvD,OAAO,CAAC,OAAO,CAA2C;IAG1D,OAAO,CAAC,UAAU,CAAC,CAAa;IAGhC,OAAO,CAAC,cAAc,CAAC,CAAuB;IAG9C,OAAO,CAAC,WAAW,CAAC,CAAW;IAG/B,OAAO,CAAC,cAAc,CAAC,CAAU;IAGjC,OAAO,CAAC,KAAK,CAAC,CAAiB;IAG/B,OAAO,CAAC,OAAO,CAAC,CAAsB;IAEtC;;;;;OAKG;gBACS,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,kBAAkB;IAKpE;;;;OAIG;IACH,QAAQ,IAAI,cAAc,GAAG,SAAS;IAItC;;;;OAIG;IACH,SAAS,IAAI,iBAAiB;IAI9B;;;;OAIG;IACH,WAAW,IAAI,gBAAgB;IAO/B;;;;OAIG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAajD;;;;OAIG;IACH,cAAc,IAAI,QAAQ,GAAG,SAAS;IAItC;;;;OAIG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BxD;;;;;OAKG;IACG,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAiB3D;;;;;OAKG;YACW,YAAY;IA0D1B;;;;;;OAMG;WACU,kBAAkB,CAC7B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE;QACP,KAAK,EAAE,cAAc,CAAC;QACtB,OAAO,EAAE,mBAAmB,CAAC;QAC7B,QAAQ,EAAE,gBAAgB,CAAC;QAC3B,UAAU,CAAC,EAAE,mBAAmB,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,GACA,OAAO,CAAC,cAAc,CAAC;IAgD1B;;;;;OAKG;IACH,OAAO,CAAC,IAAI;IAOZ;;;;;;OAMG;YACW,uBAAuB;IAYrC;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAqDzB;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IAkBrC;;;;;;;;OAQG;YACW,WAAW;IAsBzB;;;;;;;OAOG;YACW,WAAW;IAkBzB;;;;;;OAMG;YACW,iBAAiB;CAOhC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hexabot-ai/agentic",
-  "version": "3.1.2-alpha.1",
+  "version": "3.1.2-alpha.11",
   "description": "Schemas and utilities for the Hexabot agentic workflow DSL.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -20,7 +20,7 @@
   ],
   "dependencies": {
     "jsonata": "^2.1.0",
-    "yaml": "^2.5.0",
+    "yaml": "^2.8.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/src/__tests__/suspension-rebuilder.test.ts

@@ -308,10 +308,15 @@ describe('rebuildSuspension', () => {
       state,
       stepId: '0.parallel.1:child_b',
     });
-
-    mockedRunParallelExecutor.mockResolvedValue(
-      'next-suspension' as unknown as void,
-    );
+    const nextSuspension = {
+      step: {
+        id: '0.parallel.2:child_c',
+        name: 'child_c',
+        type: StepType.Task,
+      },
+      continue: jest.fn().mockResolvedValue(undefined),
+    };
+    mockedRunParallelExecutor.mockResolvedValue(nextSuspension);
 
     const result = await suspension?.continue({ payload: true });
 
@@ -325,7 +330,17 @@ describe('rebuildSuspension', () => {
       [0],
       2,
     );
-    expect(result).toBe('next-suspension');
+    expect(result?.step.id).toBe(nextSuspension.step.id);
+
+    await result?.continue({ done: true });
+
+    expect(nextSuspension.continue).toHaveBeenCalledWith({ done: true });
+    expect(deps.executeFlow).toHaveBeenLastCalledWith(
+      compiled.flow,
+      state,
+      [],
+      1,
+    );
   });
 
   it('resumes a loop suspension, updating accumulators and continuing execution', async () => {
@@ -367,9 +382,15 @@ describe('rebuildSuspension', () => {
 
     mockedUpdateAccumulator.mockResolvedValue(5);
     mockedShouldStopLoop.mockResolvedValue(false);
-    mockedRunLoopExecutor.mockResolvedValue(
-      'loop-continued' as unknown as void,
-    );
+    const nextSuspension = {
+      step: {
+        id: '0.collector.0:loop_task[2]',
+        name: 'loop_task',
+        type: StepType.Task,
+      },
+      continue: jest.fn().mockResolvedValue(undefined),
+    };
+    mockedRunLoopExecutor.mockResolvedValue(nextSuspension);
 
     const suspension = rebuildSuspension(deps, {
       state,
@@ -404,6 +425,19 @@ describe('rebuildSuspension', () => {
     const loopState = mockedRunLoopExecutor.mock.calls[0]?.[2];
     expect(loopState?.accumulator).toBe(5);
     expect(loopState?.iterationStack).toEqual([]);
-    expect(result).toBe('loop-continued');
+    expect(result?.step.id).toBe(nextSuspension.step.id);
+
+    await result?.continue({ done: true });
+
+    expect(nextSuspension.continue).toHaveBeenCalledWith({ done: true });
+    expect(deps.executeFlow).toHaveBeenLastCalledWith(
+      compiled.flow,
+      expect.objectContaining({
+        accumulator: 5,
+        output: expect.objectContaining({ collector: { sum: 5 } }),
+      }),
+      [],
+      1,
+    );
   });
 });

package/src/__tests__/workflow-definition-resources.test.ts

@@ -0,0 +1,97 @@
+/*
+ * Hexabot — Fair Core License (FCL-1.0-ALv2)
+ * Copyright (c) 2026 Hexastack.
+ * Full terms: see LICENSE.md.
+ */
+
+import type { WorkflowDefinition } from '../dsl.types';
+import {
+  collectWorkflowDefinitionResourceRefs,
+  remapWorkflowDefinitionResourceRefs,
+  type WorkflowDefinitionResourceDescriptor,
+} from '../utils/workflow-definition-resources';
+
+const descriptors: WorkflowDefinitionResourceDescriptor[] = [
+  { kind: 'memory', settingsKey: 'definition_id' },
+  { kind: 'mcp', settingsKey: 'server_id' },
+];
+const definition: WorkflowDefinition = {
+  defs: {
+    profile_memory: {
+      kind: 'memory',
+      settings: {
+        definition_id: 'memory-1',
+      },
+    },
+    duplicate_profile_memory: {
+      kind: 'memory',
+      settings: {
+        definition_id: 'memory-1',
+      },
+    },
+    search_mcp: {
+      kind: 'mcp',
+      settings: {
+        server_id: 'mcp-1',
+      },
+    },
+    greet: {
+      kind: 'task',
+      action: 'send_message',
+      bindings: {
+        memory: ['profile_memory'],
+        mcp: ['search_mcp'],
+      },
+    },
+  },
+  flow: [{ do: 'greet' }],
+  outputs: { result: '=$output.greet' },
+};
+
+describe('workflow definition resource helpers', () => {
+  it('collects unique resource references by descriptor kind', () => {
+    expect(
+      collectWorkflowDefinitionResourceRefs(definition, descriptors),
+    ).toEqual({
+      memory: ['memory-1'],
+      mcp: ['mcp-1'],
+    });
+  });
+
+  it('remaps resource references without mutating the original definition', () => {
+    const updated = remapWorkflowDefinitionResourceRefs(
+      definition,
+      descriptors,
+      {
+        memory: { 'memory-1': 'memory-local' },
+        mcp: { 'mcp-1': 'mcp-local' },
+      },
+    );
+
+    expect(updated).not.toBe(definition);
+    expect(updated.defs.profile_memory.settings).toEqual({
+      definition_id: 'memory-local',
+    });
+    expect(updated.defs.duplicate_profile_memory.settings).toEqual({
+      definition_id: 'memory-local',
+    });
+    expect(updated.defs.search_mcp.settings).toEqual({
+      server_id: 'mcp-local',
+    });
+    expect(definition.defs.profile_memory.settings).toEqual({
+      definition_id: 'memory-1',
+    });
+    expect(definition.defs.search_mcp.settings).toEqual({
+      server_id: 'mcp-1',
+    });
+  });
+
+  it('returns the original definition when no refs change', () => {
+    expect(
+      remapWorkflowDefinitionResourceRefs(definition, descriptors, {
+        memory: {},
+        mcp: {},
+      }),
+    ).toBe(definition);
+  });
+});