@incodetech/core 2.0.1 → 2.1.0-rc.1

package/dist/workflow.d.ts

@@ -1,12 +1,13 @@
-import { t as Manager } from "./Manager-C8PrhBOx.js";
-import { t as AnyStateMachine } from "./StateMachine-BCQrZJhf.js";
-import "./camera-DBSxa6ML.js";
-import "./types-CFV9G_7j.js";
-import "./types-BP1m8VRw.js";
-import { n as GetFinishStatusFn, t as FinishStatus } from "./flowCompletionService-DhkT4SRY.js";
-import { o as FlowEventSubscribable } from "./index-BcRG8rtJ.js";
-import { a as WorkflowModuleRegistry, i as RunChildModuleInput, r as RunChildModuleEvent, t as ModuleConfigMappers } from "./types-B06Ypu2F.js";
-import * as xstate393 from "xstate";
+import { t as Manager } from "./Manager-BHn8wH8K.js";
+import { t as AnyStateMachine } from "./StateMachine-BC_nGvrc.js";
+import "./camera-SRBpPq2X.js";
+import "./types-Bj9hdFjU.js";
+import "./types-DvGZI7BF.js";
+import "./types-DOUhndhT.js";
+import { n as GetFinishStatusFn, t as FinishStatus } from "./flowCompletionService-BdR2cGgB.js";
+import { o as FlowEventSubscribable } from "./index-B5hPA0Bg.js";
+import { a as WorkflowModuleRegistry, i as RunChildModuleInput, r as RunChildModuleEvent, t as ModuleConfigMappers } from "./types-NuT8ftBV.js";
+import * as xstate0 from "xstate";
 
 //#region src/modules/workflow/types.d.ts
 /** Possible node types returned by the workflow server. */
@@ -141,10 +142,14 @@ declare function createWorkflowManager(options?: CreateWorkflowManagerOptions):
    */
   completeFlow(): void;
   /**
-   * Signal that the current module encountered an error.
-   * Transitions the workflow to a terminal error state.
+   * Signal that the current module encountered a terminal error, optionally
+   * with its machine-readable `moduleErrorCode`. The workflow machine decides
+   * what to do: an advanceable terminal error (e.g. `NONEXISTENT_CUSTOMER`,
+   * `HINT_NOT_PROVIDED`) advances via `processNode`; any other error
+   * transitions to the terminal error state. Callers always forward the code
+   * and let core classify — no per-module branching in the UI.
    */
-  errorModule(error: string): void;
+  errorModule(error: string, moduleErrorCode?: string): void;
   /**
    * Advance from the launch (home) screen into the first workflow node.
    * No-op when the workflow is not currently waiting on the home screen
@@ -205,6 +210,12 @@ type WorkflowContext = {
   resolvedMachine: AnyStateMachine | undefined;
   error: string | undefined;
   errorCode: number | undefined;
+  /**
+   * Machine-readable code of the module terminal error the workflow chose to
+   * advance past (an advanceable terminal error like NONEXISTENT_CUSTOMER).
+   * Retained for analytics only — it is not sent to the backend `processNode`.
+   */
+  moduleErrorCode: string | undefined;
   registeredModules: WorkflowModuleRegistry;
   configMappers: ModuleConfigMappers;
   finishStatus: FinishStatus | undefined;
@@ -230,94 +241,103 @@ type WorkflowInput = {
   /** Whether the device is a desktop. Determines desktop-to-mobile redirect injection. Defaults to true. */
   isDesktop?: boolean;
 };
-declare const workflowMachine: xstate393.StateMachine<WorkflowContext, {
+declare const workflowMachine: xstate0.StateMachine<WorkflowContext, {
   type: "LOAD";
 } | {
   type: "MODULE_COMPLETE";
 } | {
   type: "MODULE_ERROR";
   error: unknown;
+  moduleErrorCode?: string;
 } | {
   type: "COMPLETE_FLOW";
 } | {
   type: "HOME_CONTINUE";
 }, {
-  [x: string]: xstate393.ActorRefFromLogic<xstate393.CallbackActorLogic<RunChildModuleEvent, RunChildModuleInput, xstate393.EventObject>> | xstate393.ActorRefFromLogic<xstate393.PromiseActorLogic<LoadingResult, LoadWorkflowInput, xstate393.EventObject>> | xstate393.ActorRefFromLogic<xstate393.PromiseActorLogic<ProcessingResult, ProcessNextNodeInput, xstate393.EventObject>> | xstate393.ActorRefFromLogic<xstate393.PromiseActorLogic<WorkflowNode, HandleCustomModuleInput, xstate393.EventObject>> | xstate393.ActorRefFromLogic<xstate393.PromiseActorLogic<AnyStateMachine, ResolveModuleInput, xstate393.EventObject>> | xstate393.ActorRefFromLogic<xstate393.PromiseActorLogic<FinishStatus, {
+  [x: string]: xstate0.ActorRefFromLogic<xstate0.CallbackActorLogic<RunChildModuleEvent, RunChildModuleInput, xstate0.EventObject>> | xstate0.ActorRefFromLogic<xstate0.PromiseActorLogic<LoadingResult, LoadWorkflowInput, xstate0.EventObject>> | xstate0.ActorRefFromLogic<xstate0.PromiseActorLogic<ProcessingResult, ProcessNextNodeInput, xstate0.EventObject>> | xstate0.ActorRefFromLogic<xstate0.PromiseActorLogic<WorkflowNode, HandleCustomModuleInput, xstate0.EventObject>> | xstate0.ActorRefFromLogic<xstate0.PromiseActorLogic<AnyStateMachine, ResolveModuleInput, xstate0.EventObject>> | xstate0.ActorRefFromLogic<xstate0.PromiseActorLogic<FinishStatus, {
     getFinishStatus: GetFinishStatusFn;
     workflowId: string | undefined;
-  }, xstate393.EventObject>> | undefined;
-}, xstate393.Values<{
+  }, xstate0.EventObject>> | undefined;
+}, xstate0.Values<{
   runChildModule: {
     src: "runChildModule";
-    logic: xstate393.CallbackActorLogic<RunChildModuleEvent, RunChildModuleInput, xstate393.EventObject>;
+    logic: xstate0.CallbackActorLogic<RunChildModuleEvent, RunChildModuleInput, xstate0.EventObject>;
     id: string | undefined;
   };
   loadWorkflow: {
     src: "loadWorkflow";
-    logic: xstate393.PromiseActorLogic<LoadingResult, LoadWorkflowInput, xstate393.EventObject>;
+    logic: xstate0.PromiseActorLogic<LoadingResult, LoadWorkflowInput, xstate0.EventObject>;
     id: string | undefined;
   };
   processNextNode: {
     src: "processNextNode";
-    logic: xstate393.PromiseActorLogic<ProcessingResult, ProcessNextNodeInput, xstate393.EventObject>;
+    logic: xstate0.PromiseActorLogic<ProcessingResult, ProcessNextNodeInput, xstate0.EventObject>;
     id: string | undefined;
   };
   handleCustomModule: {
     src: "handleCustomModule";
-    logic: xstate393.PromiseActorLogic<WorkflowNode, HandleCustomModuleInput, xstate393.EventObject>;
+    logic: xstate0.PromiseActorLogic<WorkflowNode, HandleCustomModuleInput, xstate0.EventObject>;
     id: string | undefined;
   };
   resolveModule: {
     src: "resolveModule";
-    logic: xstate393.PromiseActorLogic<AnyStateMachine, ResolveModuleInput, xstate393.EventObject>;
+    logic: xstate0.PromiseActorLogic<AnyStateMachine, ResolveModuleInput, xstate0.EventObject>;
     id: string | undefined;
   };
   notifyBackend: {
     src: "notifyBackend";
-    logic: xstate393.PromiseActorLogic<FinishStatus, {
+    logic: xstate0.PromiseActorLogic<FinishStatus, {
       getFinishStatus: GetFinishStatusFn;
       workflowId: string | undefined;
-    }, xstate393.EventObject>;
+    }, xstate0.EventObject>;
     id: string | undefined;
   };
-}>, xstate393.Values<{
-  setError: {
-    type: "setError";
-    params: xstate393.NonReducibleUnknown;
-  };
+}>, xstate0.Values<{
   setLoadingResult: {
     type: "setLoadingResult";
-    params: xstate393.NonReducibleUnknown;
+    params: xstate0.NonReducibleUnknown;
   };
   setNextNode: {
     type: "setNextNode";
-    params: xstate393.NonReducibleUnknown;
+    params: xstate0.NonReducibleUnknown;
   };
   setCustomModuleResult: {
     type: "setCustomModuleResult";
-    params: xstate393.NonReducibleUnknown;
+    params: xstate0.NonReducibleUnknown;
   };
   setResolvedMachine: {
     type: "setResolvedMachine";
-    params: xstate393.NonReducibleUnknown;
+    params: xstate0.NonReducibleUnknown;
   };
   setFinishStatus: {
     type: "setFinishStatus";
-    params: xstate393.NonReducibleUnknown;
+    params: xstate0.NonReducibleUnknown;
+  };
+  setError: {
+    type: "setError";
+    params: xstate0.NonReducibleUnknown;
   };
   setModuleError: {
     type: "setModuleError";
-    params: xstate393.NonReducibleUnknown;
+    params: xstate0.NonReducibleUnknown;
+  };
+  setModuleErrorCode: {
+    type: "setModuleErrorCode";
+    params: xstate0.NonReducibleUnknown;
+  };
+  trackAdvanceableModuleError: {
+    type: "trackAdvanceableModuleError";
+    params: unknown;
   };
   setHomeContinueLoading: {
     type: "setHomeContinueLoading";
-    params: xstate393.NonReducibleUnknown;
+    params: xstate0.NonReducibleUnknown;
   };
   clearHomeContinueLoading: {
     type: "clearHomeContinueLoading";
-    params: xstate393.NonReducibleUnknown;
+    params: xstate0.NonReducibleUnknown;
   };
-}>, xstate393.Values<{
+}>, xstate0.Values<{
   isModuleNode: {
     type: "isModuleNode";
     params: unknown;
@@ -334,11 +354,15 @@ declare const workflowMachine: xstate393.StateMachine<WorkflowContext, {
     type: "isCustomModule";
     params: unknown;
   };
+  isAdvanceableModuleError: {
+    type: "isAdvanceableModuleError";
+    params: unknown;
+  };
   shouldEnterHome: {
     type: "shouldEnterHome";
     params: unknown;
   };
-}>, never, "error" | "idle" | "closed" | "finished" | "loading" | "home" | "resolvingModule" | "completing" | "asyncResolution" | "handlingCustomModule" | "runningModule" | "processingNode", string, WorkflowInput, xstate393.NonReducibleUnknown, xstate393.EventObject, xstate393.MetaObject, {
+}>, never, "error" | "idle" | "closed" | "finished" | "loading" | "home" | "resolvingModule" | "completing" | "asyncResolution" | "handlingCustomModule" | "runningModule" | "processingNode", string, WorkflowInput, xstate0.NonReducibleUnknown, xstate0.EventObject, xstate0.MetaObject, {
   readonly id: "workflow";
   readonly initial: "idle";
   readonly context: ({
@@ -347,166 +371,168 @@ declare const workflowMachine: xstate393.StateMachine<WorkflowContext, {
     spawn: {
       <TSrc extends "runChildModule" | "loadWorkflow" | "processNextNode" | "handleCustomModule" | "resolveModule" | "notifyBackend">(logic: TSrc, ...[options]: ({
         src: "runChildModule";
-        logic: xstate393.CallbackActorLogic<RunChildModuleEvent, RunChildModuleInput, xstate393.EventObject>;
+        logic: xstate0.CallbackActorLogic<RunChildModuleEvent, RunChildModuleInput, xstate0.EventObject>;
         id: string | undefined;
       } extends infer T ? T extends {
         src: "runChildModule";
-        logic: xstate393.CallbackActorLogic<RunChildModuleEvent, RunChildModuleInput, xstate393.EventObject>;
+        logic: xstate0.CallbackActorLogic<RunChildModuleEvent, RunChildModuleInput, xstate0.EventObject>;
         id: string | undefined;
       } ? T extends {
         src: TSrc;
-      } ? xstate393.ConditionalRequired<[options?: ({
+      } ? xstate0.ConditionalRequired<[options?: ({
         id?: T["id"] | undefined;
         systemId?: string;
-        input?: xstate393.InputFrom<T["logic"]> | undefined;
+        input?: xstate0.InputFrom<T["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate393.RequiredActorOptions<T>]: unknown }) | undefined], xstate393.IsNotNever<xstate393.RequiredActorOptions<T>>> : never : never : never) | ({
+      } & { [K in xstate0.RequiredActorOptions<T>]: unknown }) | undefined], xstate0.IsNotNever<xstate0.RequiredActorOptions<T>>> : never : never : never) | ({
         src: "loadWorkflow";
-        logic: xstate393.PromiseActorLogic<LoadingResult, LoadWorkflowInput, xstate393.EventObject>;
+        logic: xstate0.PromiseActorLogic<LoadingResult, LoadWorkflowInput, xstate0.EventObject>;
         id: string | undefined;
       } extends infer T_1 ? T_1 extends {
         src: "loadWorkflow";
-        logic: xstate393.PromiseActorLogic<LoadingResult, LoadWorkflowInput, xstate393.EventObject>;
+        logic: xstate0.PromiseActorLogic<LoadingResult, LoadWorkflowInput, xstate0.EventObject>;
         id: string | undefined;
       } ? T_1 extends {
         src: TSrc;
-      } ? xstate393.ConditionalRequired<[options?: ({
+      } ? xstate0.ConditionalRequired<[options?: ({
         id?: T_1["id"] | undefined;
         systemId?: string;
-        input?: xstate393.InputFrom<T_1["logic"]> | undefined;
+        input?: xstate0.InputFrom<T_1["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K_1 in xstate393.RequiredActorOptions<T_1>]: unknown }) | undefined], xstate393.IsNotNever<xstate393.RequiredActorOptions<T_1>>> : never : never : never) | ({
+      } & { [K_1 in xstate0.RequiredActorOptions<T_1>]: unknown }) | undefined], xstate0.IsNotNever<xstate0.RequiredActorOptions<T_1>>> : never : never : never) | ({
         src: "processNextNode";
-        logic: xstate393.PromiseActorLogic<ProcessingResult, ProcessNextNodeInput, xstate393.EventObject>;
+        logic: xstate0.PromiseActorLogic<ProcessingResult, ProcessNextNodeInput, xstate0.EventObject>;
         id: string | undefined;
       } extends infer T_2 ? T_2 extends {
         src: "processNextNode";
-        logic: xstate393.PromiseActorLogic<ProcessingResult, ProcessNextNodeInput, xstate393.EventObject>;
+        logic: xstate0.PromiseActorLogic<ProcessingResult, ProcessNextNodeInput, xstate0.EventObject>;
         id: string | undefined;
       } ? T_2 extends {
         src: TSrc;
-      } ? xstate393.ConditionalRequired<[options?: ({
+      } ? xstate0.ConditionalRequired<[options?: ({
         id?: T_2["id"] | undefined;
         systemId?: string;
-        input?: xstate393.InputFrom<T_2["logic"]> | undefined;
+        input?: xstate0.InputFrom<T_2["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K_2 in xstate393.RequiredActorOptions<T_2>]: unknown }) | undefined], xstate393.IsNotNever<xstate393.RequiredActorOptions<T_2>>> : never : never : never) | ({
+      } & { [K_2 in xstate0.RequiredActorOptions<T_2>]: unknown }) | undefined], xstate0.IsNotNever<xstate0.RequiredActorOptions<T_2>>> : never : never : never) | ({
         src: "handleCustomModule";
-        logic: xstate393.PromiseActorLogic<WorkflowNode, HandleCustomModuleInput, xstate393.EventObject>;
+        logic: xstate0.PromiseActorLogic<WorkflowNode, HandleCustomModuleInput, xstate0.EventObject>;
         id: string | undefined;
       } extends infer T_3 ? T_3 extends {
         src: "handleCustomModule";
-        logic: xstate393.PromiseActorLogic<WorkflowNode, HandleCustomModuleInput, xstate393.EventObject>;
+        logic: xstate0.PromiseActorLogic<WorkflowNode, HandleCustomModuleInput, xstate0.EventObject>;
         id: string | undefined;
       } ? T_3 extends {
         src: TSrc;
-      } ? xstate393.ConditionalRequired<[options?: ({
+      } ? xstate0.ConditionalRequired<[options?: ({
         id?: T_3["id"] | undefined;
         systemId?: string;
-        input?: xstate393.InputFrom<T_3["logic"]> | undefined;
+        input?: xstate0.InputFrom<T_3["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K_3 in xstate393.RequiredActorOptions<T_3>]: unknown }) | undefined], xstate393.IsNotNever<xstate393.RequiredActorOptions<T_3>>> : never : never : never) | ({
+      } & { [K_3 in xstate0.RequiredActorOptions<T_3>]: unknown }) | undefined], xstate0.IsNotNever<xstate0.RequiredActorOptions<T_3>>> : never : never : never) | ({
         src: "resolveModule";
-        logic: xstate393.PromiseActorLogic<AnyStateMachine, ResolveModuleInput, xstate393.EventObject>;
+        logic: xstate0.PromiseActorLogic<AnyStateMachine, ResolveModuleInput, xstate0.EventObject>;
         id: string | undefined;
       } extends infer T_4 ? T_4 extends {
         src: "resolveModule";
-        logic: xstate393.PromiseActorLogic<AnyStateMachine, ResolveModuleInput, xstate393.EventObject>;
+        logic: xstate0.PromiseActorLogic<AnyStateMachine, ResolveModuleInput, xstate0.EventObject>;
         id: string | undefined;
       } ? T_4 extends {
         src: TSrc;
-      } ? xstate393.ConditionalRequired<[options?: ({
+      } ? xstate0.ConditionalRequired<[options?: ({
         id?: T_4["id"] | undefined;
         systemId?: string;
-        input?: xstate393.InputFrom<T_4["logic"]> | undefined;
+        input?: xstate0.InputFrom<T_4["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K_4 in xstate393.RequiredActorOptions<T_4>]: unknown }) | undefined], xstate393.IsNotNever<xstate393.RequiredActorOptions<T_4>>> : never : never : never) | ({
+      } & { [K_4 in xstate0.RequiredActorOptions<T_4>]: unknown }) | undefined], xstate0.IsNotNever<xstate0.RequiredActorOptions<T_4>>> : never : never : never) | ({
         src: "notifyBackend";
-        logic: xstate393.PromiseActorLogic<FinishStatus, {
+        logic: xstate0.PromiseActorLogic<FinishStatus, {
           getFinishStatus: GetFinishStatusFn;
           workflowId: string | undefined;
-        }, xstate393.EventObject>;
+        }, xstate0.EventObject>;
         id: string | undefined;
       } extends infer T_5 ? T_5 extends {
         src: "notifyBackend";
-        logic: xstate393.PromiseActorLogic<FinishStatus, {
+        logic: xstate0.PromiseActorLogic<FinishStatus, {
           getFinishStatus: GetFinishStatusFn;
           workflowId: string | undefined;
-        }, xstate393.EventObject>;
+        }, xstate0.EventObject>;
         id: string | undefined;
       } ? T_5 extends {
         src: TSrc;
-      } ? xstate393.ConditionalRequired<[options?: ({
+      } ? xstate0.ConditionalRequired<[options?: ({
         id?: T_5["id"] | undefined;
         systemId?: string;
-        input?: xstate393.InputFrom<T_5["logic"]> | undefined;
+        input?: xstate0.InputFrom<T_5["logic"]> | undefined;
         syncSnapshot?: boolean;
-      } & { [K_5 in xstate393.RequiredActorOptions<T_5>]: unknown }) | undefined], xstate393.IsNotNever<xstate393.RequiredActorOptions<T_5>>> : never : never : never)): xstate393.ActorRefFromLogic<xstate393.GetConcreteByKey<xstate393.Values<{
+      } & { [K_5 in xstate0.RequiredActorOptions<T_5>]: unknown }) | undefined], xstate0.IsNotNever<xstate0.RequiredActorOptions<T_5>>> : never : never : never)): xstate0.ActorRefFromLogic<xstate0.GetConcreteByKey<xstate0.Values<{
         runChildModule: {
           src: "runChildModule";
-          logic: xstate393.CallbackActorLogic<RunChildModuleEvent, RunChildModuleInput, xstate393.EventObject>;
+          logic: xstate0.CallbackActorLogic<RunChildModuleEvent, RunChildModuleInput, xstate0.EventObject>;
           id: string | undefined;
         };
         loadWorkflow: {
           src: "loadWorkflow";
-          logic: xstate393.PromiseActorLogic<LoadingResult, LoadWorkflowInput, xstate393.EventObject>;
+          logic: xstate0.PromiseActorLogic<LoadingResult, LoadWorkflowInput, xstate0.EventObject>;
           id: string | undefined;
         };
         processNextNode: {
           src: "processNextNode";
-          logic: xstate393.PromiseActorLogic<ProcessingResult, ProcessNextNodeInput, xstate393.EventObject>;
+          logic: xstate0.PromiseActorLogic<ProcessingResult, ProcessNextNodeInput, xstate0.EventObject>;
           id: string | undefined;
         };
         handleCustomModule: {
           src: "handleCustomModule";
-          logic: xstate393.PromiseActorLogic<WorkflowNode, HandleCustomModuleInput, xstate393.EventObject>;
+          logic: xstate0.PromiseActorLogic<WorkflowNode, HandleCustomModuleInput, xstate0.EventObject>;
           id: string | undefined;
         };
         resolveModule: {
           src: "resolveModule";
-          logic: xstate393.PromiseActorLogic<AnyStateMachine, ResolveModuleInput, xstate393.EventObject>;
+          logic: xstate0.PromiseActorLogic<AnyStateMachine, ResolveModuleInput, xstate0.EventObject>;
           id: string | undefined;
         };
         notifyBackend: {
           src: "notifyBackend";
-          logic: xstate393.PromiseActorLogic<FinishStatus, {
+          logic: xstate0.PromiseActorLogic<FinishStatus, {
             getFinishStatus: GetFinishStatusFn;
             workflowId: string | undefined;
-          }, xstate393.EventObject>;
+          }, xstate0.EventObject>;
           id: string | undefined;
         };
       }>, "src", TSrc>["logic"]>;
-      <TLogic extends xstate393.AnyActorLogic>(src: TLogic, ...[options]: xstate393.ConditionalRequired<[options?: ({
+      <TLogic extends xstate0.AnyActorLogic>(src: TLogic, ...[options]: xstate0.ConditionalRequired<[options?: ({
         id?: never;
         systemId?: string;
-        input?: xstate393.InputFrom<TLogic> | undefined;
+        input?: xstate0.InputFrom<TLogic> | undefined;
         syncSnapshot?: boolean;
-      } & { [K in xstate393.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate393.IsNotNever<xstate393.RequiredLogicInput<TLogic>>>): xstate393.ActorRefFromLogic<TLogic>;
+      } & { [K in xstate0.RequiredLogicInput<TLogic>]: unknown }) | undefined], xstate0.IsNotNever<xstate0.RequiredLogicInput<TLogic>>>): xstate0.ActorRefFromLogic<TLogic>;
     };
     input: WorkflowInput;
-    self: xstate393.ActorRef<xstate393.MachineSnapshot<WorkflowContext, {
+    self: xstate0.ActorRef<xstate0.MachineSnapshot<WorkflowContext, {
       type: "LOAD";
     } | {
       type: "MODULE_COMPLETE";
     } | {
       type: "MODULE_ERROR";
       error: unknown;
+      moduleErrorCode?: string;
     } | {
       type: "COMPLETE_FLOW";
     } | {
       type: "HOME_CONTINUE";
-    }, Record<string, xstate393.AnyActorRef | undefined>, xstate393.StateValue, string, unknown, any, any>, {
+    }, Record<string, xstate0.AnyActorRef | undefined>, xstate0.StateValue, string, unknown, any, any>, {
       type: "LOAD";
     } | {
       type: "MODULE_COMPLETE";
     } | {
       type: "MODULE_ERROR";
       error: unknown;
+      moduleErrorCode?: string;
     } | {
       type: "COMPLETE_FLOW";
     } | {
       type: "HOME_CONTINUE";
-    }, xstate393.AnyEventObject>;
+    }, xstate0.AnyEventObject>;
   }) => {
     workflowConfig: undefined;
     currentNode: undefined;
@@ -514,6 +540,7 @@ declare const workflowMachine: xstate393.StateMachine<WorkflowContext, {
     resolvedMachine: undefined;
     error: undefined;
     errorCode: undefined;
+    moduleErrorCode: undefined;
     registeredModules: WorkflowModuleRegistry;
     configMappers: ModuleConfigMappers;
     finishStatus: undefined;
@@ -545,34 +572,37 @@ declare const workflowMachine: xstate393.StateMachine<WorkflowContext, {
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
           };
-          self: xstate393.ActorRef<xstate393.MachineSnapshot<WorkflowContext, {
+          self: xstate0.ActorRef<xstate0.MachineSnapshot<WorkflowContext, {
             type: "LOAD";
           } | {
             type: "MODULE_COMPLETE";
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
-          }, Record<string, xstate393.AnyActorRef>, xstate393.StateValue, string, unknown, any, any>, {
+          }, Record<string, xstate0.AnyActorRef>, xstate0.StateValue, string, unknown, any, any>, {
             type: "LOAD";
           } | {
             type: "MODULE_COMPLETE";
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
-          }, xstate393.AnyEventObject>;
+          }, xstate0.AnyEventObject>;
         }) => {
           isDesktop: boolean;
         };
@@ -626,34 +656,37 @@ declare const workflowMachine: xstate393.StateMachine<WorkflowContext, {
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
           };
-          self: xstate393.ActorRef<xstate393.MachineSnapshot<WorkflowContext, {
+          self: xstate0.ActorRef<xstate0.MachineSnapshot<WorkflowContext, {
             type: "LOAD";
           } | {
             type: "MODULE_COMPLETE";
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
-          }, Record<string, xstate393.AnyActorRef>, xstate393.StateValue, string, unknown, any, any>, {
+          }, Record<string, xstate0.AnyActorRef>, xstate0.StateValue, string, unknown, any, any>, {
             type: "LOAD";
           } | {
             type: "MODULE_COMPLETE";
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
-          }, xstate393.AnyEventObject>;
+          }, xstate0.AnyEventObject>;
         }) => {
           moduleKey: string;
           registeredModules: WorkflowModuleRegistry;
@@ -684,10 +717,14 @@ declare const workflowMachine: xstate393.StateMachine<WorkflowContext, {
       };
       readonly on: {
         readonly MODULE_COMPLETE: "processingNode";
-        readonly MODULE_ERROR: {
+        readonly MODULE_ERROR: readonly [{
+          readonly guard: "isAdvanceableModuleError";
+          readonly target: "processingNode";
+          readonly actions: readonly ["setModuleErrorCode", "trackAdvanceableModuleError"];
+        }, {
           readonly target: "error";
           readonly actions: "setModuleError";
-        };
+        }];
         readonly COMPLETE_FLOW: "completing";
       };
     };
@@ -706,34 +743,37 @@ declare const workflowMachine: xstate393.StateMachine<WorkflowContext, {
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
           };
-          self: xstate393.ActorRef<xstate393.MachineSnapshot<WorkflowContext, {
+          self: xstate0.ActorRef<xstate0.MachineSnapshot<WorkflowContext, {
             type: "LOAD";
           } | {
             type: "MODULE_COMPLETE";
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
-          }, Record<string, xstate393.AnyActorRef>, xstate393.StateValue, string, unknown, any, any>, {
+          }, Record<string, xstate0.AnyActorRef>, xstate0.StateValue, string, unknown, any, any>, {
             type: "LOAD";
           } | {
             type: "MODULE_COMPLETE";
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
-          }, xstate393.AnyEventObject>;
+          }, xstate0.AnyEventObject>;
         }) => {
           currentNode: WorkflowNode;
           interviewId: string;
@@ -773,34 +813,37 @@ declare const workflowMachine: xstate393.StateMachine<WorkflowContext, {
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
           };
-          self: xstate393.ActorRef<xstate393.MachineSnapshot<WorkflowContext, {
+          self: xstate0.ActorRef<xstate0.MachineSnapshot<WorkflowContext, {
             type: "LOAD";
           } | {
             type: "MODULE_COMPLETE";
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
-          }, Record<string, xstate393.AnyActorRef>, xstate393.StateValue, string, unknown, any, any>, {
+          }, Record<string, xstate0.AnyActorRef>, xstate0.StateValue, string, unknown, any, any>, {
             type: "LOAD";
           } | {
             type: "MODULE_COMPLETE";
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
-          }, xstate393.AnyEventObject>;
+          }, xstate0.AnyEventObject>;
         }) => {
           isInjectedNode: boolean;
           firstNode: WorkflowNode | undefined;
@@ -847,34 +890,37 @@ declare const workflowMachine: xstate393.StateMachine<WorkflowContext, {
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
           };
-          self: xstate393.ActorRef<xstate393.MachineSnapshot<WorkflowContext, {
+          self: xstate0.ActorRef<xstate0.MachineSnapshot<WorkflowContext, {
             type: "LOAD";
           } | {
             type: "MODULE_COMPLETE";
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
-          }, Record<string, xstate393.AnyActorRef>, xstate393.StateValue, string, unknown, any, any>, {
+          }, Record<string, xstate0.AnyActorRef>, xstate0.StateValue, string, unknown, any, any>, {
             type: "LOAD";
           } | {
             type: "MODULE_COMPLETE";
           } | {
             type: "MODULE_ERROR";
             error: unknown;
+            moduleErrorCode?: string;
           } | {
             type: "COMPLETE_FLOW";
           } | {
             type: "HOME_CONTINUE";
-          }, xstate393.AnyEventObject>;
+          }, xstate0.AnyEventObject>;
         }) => {
           getFinishStatus: GetFinishStatusFn;
           workflowId: string | undefined;