@gobing-ai/ts-dual-workflow-engine 0.3.0 → 0.3.2

package/dist/schema.d.ts

@@ -3,6 +3,10 @@ import { z } from 'zod';
 export declare const ActionDefSchema: z.ZodObject<{
     kind: z.ZodString;
     options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    onError: z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        continue: "continue";
+    }>>;
 }, z.core.$strip>;
 /** Zod schema for workflow guard definitions. */
 export declare const GuardDefSchema: z.ZodObject<{
@@ -19,6 +23,10 @@ export declare const StateMachineWorkflowDefSchema: z.ZodObject<{
     initialState: z.ZodString;
     terminalStates: z.ZodOptional<z.ZodArray<z.ZodString>>;
     iterationBound: z.ZodOptional<z.ZodNumber>;
+    defaultOnError: z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        continue: "continue";
+    }>>;
     vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     env: z.ZodOptional<z.ZodObject<{
         allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -29,10 +37,18 @@ export declare const StateMachineWorkflowDefSchema: z.ZodObject<{
         onEnter: z.ZodOptional<z.ZodArray<z.ZodObject<{
             kind: z.ZodString;
             options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            onError: z.ZodOptional<z.ZodEnum<{
+                fail: "fail";
+                continue: "continue";
+            }>>;
         }, z.core.$strip>>>;
         onExit: z.ZodOptional<z.ZodArray<z.ZodObject<{
             kind: z.ZodString;
             options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            onError: z.ZodOptional<z.ZodEnum<{
+                fail: "fail";
+                continue: "continue";
+            }>>;
         }, z.core.$strip>>>;
     }, z.core.$strict>>;
     transitions: z.ZodArray<z.ZodObject<{
@@ -56,6 +72,10 @@ export declare const TransitionFlowWorkflowDefSchema: z.ZodObject<{
     initialNode: z.ZodString;
     terminalNodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     iterationBound: z.ZodOptional<z.ZodNumber>;
+    defaultOnError: z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        continue: "continue";
+    }>>;
     vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     env: z.ZodOptional<z.ZodObject<{
         allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -72,6 +92,10 @@ export declare const TransitionFlowWorkflowDefSchema: z.ZodObject<{
         action: z.ZodOptional<z.ZodObject<{
             kind: z.ZodString;
             options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            onError: z.ZodOptional<z.ZodEnum<{
+                fail: "fail";
+                continue: "continue";
+            }>>;
         }, z.core.$strip>>;
     }, z.core.$strict>>;
     edges: z.ZodArray<z.ZodObject<{
@@ -94,6 +118,10 @@ export declare const WorkflowDefSchema: z.ZodUnion<readonly [z.ZodObject<{
     initialState: z.ZodString;
     terminalStates: z.ZodOptional<z.ZodArray<z.ZodString>>;
     iterationBound: z.ZodOptional<z.ZodNumber>;
+    defaultOnError: z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        continue: "continue";
+    }>>;
     vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     env: z.ZodOptional<z.ZodObject<{
         allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -104,10 +132,18 @@ export declare const WorkflowDefSchema: z.ZodUnion<readonly [z.ZodObject<{
         onEnter: z.ZodOptional<z.ZodArray<z.ZodObject<{
             kind: z.ZodString;
             options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            onError: z.ZodOptional<z.ZodEnum<{
+                fail: "fail";
+                continue: "continue";
+            }>>;
         }, z.core.$strip>>>;
         onExit: z.ZodOptional<z.ZodArray<z.ZodObject<{
             kind: z.ZodString;
             options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            onError: z.ZodOptional<z.ZodEnum<{
+                fail: "fail";
+                continue: "continue";
+            }>>;
         }, z.core.$strip>>>;
     }, z.core.$strict>>;
     transitions: z.ZodArray<z.ZodObject<{
@@ -129,6 +165,10 @@ export declare const WorkflowDefSchema: z.ZodUnion<readonly [z.ZodObject<{
     initialNode: z.ZodString;
     terminalNodes: z.ZodOptional<z.ZodArray<z.ZodString>>;
     iterationBound: z.ZodOptional<z.ZodNumber>;
+    defaultOnError: z.ZodOptional<z.ZodEnum<{
+        fail: "fail";
+        continue: "continue";
+    }>>;
     vars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     env: z.ZodOptional<z.ZodObject<{
         allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -145,6 +185,10 @@ export declare const WorkflowDefSchema: z.ZodUnion<readonly [z.ZodObject<{
         action: z.ZodOptional<z.ZodObject<{
             kind: z.ZodString;
             options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            onError: z.ZodOptional<z.ZodEnum<{
+                fail: "fail";
+                continue: "continue";
+            }>>;
         }, z.core.$strip>>;
     }, z.core.$strict>>;
     edges: z.ZodArray<z.ZodObject<{

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,kDAAkD;AAClD,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,cAAc;;;iBAGzB,CAAC;AAEH,yDAAyD;AACzD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmC7B,CAAC;AAEd,2DAA2D;AAC3D,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkC/B,CAAC;AAEd,iEAAiE;AACjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAA4E,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,kDAAkD;AAClD,eAAO,MAAM,eAAe;;;;;;;iBAI1B,CAAC;AAEH,iDAAiD;AACjD,eAAO,MAAM,cAAc;;;iBAGzB,CAAC;AAEH,yDAAyD;AACzD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAoC7B,CAAC;AAEd,2DAA2D;AAC3D,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmC/B,CAAC;AAEd,iEAAiE;AACjE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAA4E,CAAC"}

package/dist/schema.js

@@ -22,6 +22,7 @@ const EnvSchema = z.object({
 export const ActionDefSchema = z.object({
     kind: z.string().min(1),
     options: z.record(z.string(), z.unknown()).optional(),
+    onError: z.enum(['fail', 'continue']).optional(),
 });
 /** Zod schema for workflow guard definitions. */
 export const GuardDefSchema = z.object({
@@ -40,6 +41,7 @@ export const StateMachineWorkflowDefSchema = z
     initialState: z.string().min(1),
     terminalStates: z.array(z.string().min(1)).optional(),
     iterationBound: z.number().int().positive().optional(),
+    defaultOnError: z.enum(['fail', 'continue']).optional(),
     vars: VarsSchema.optional(),
     env: EnvSchema.optional(),
     states: z.array(z
@@ -73,6 +75,7 @@ export const TransitionFlowWorkflowDefSchema = z
     initialNode: z.string().min(1),
     terminalNodes: z.array(z.string().min(1)).optional(),
     iterationBound: z.number().int().positive().optional(),
+    defaultOnError: z.enum(['fail', 'continue']).optional(),
     vars: VarsSchema.optional(),
     env: EnvSchema.optional(),
     nodes: z.array(z

package/dist/state-machine.d.ts

@@ -11,8 +11,13 @@ export declare class StateMachineDriver {
     constructor(options: StateMachineDriverOptions);
     /** Run a state-machine workflow to completion or failure. */
     run(workflow: StateMachineWorkflowDef, options?: WorkflowRunOptions): Promise<WorkflowRunResult>;
+    private loop;
+    /**
+     * Run a state's actions in order. Returns the last action result (retained even
+     * when a failure was continued past, so downstream guards can inspect it) plus an
+     * `outcome` discriminator: `terminal` (an action declared terminal success),
+     * `fail` (a failure under a 'fail' policy — caller must halt), or `completed`.
+     */
     private runActions;
-    private done;
-    private fail;
 }
 //# sourceMappingURL=state-machine.d.ts.map

package/dist/state-machine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,KAAK,EAGR,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAElB,iBAAiB,EACpB,MAAM,SAAS,CAAC;AAGjB,yDAAyD;AACzD,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;CACpD;AAED,wEAAwE;AACxE,qBAAa,kBAAkB;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,yBAAyB;IAE/D,6DAA6D;IACvD,GAAG,CAAC,QAAQ,EAAE,uBAAuB,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YA8G5F,UAAU;YA8BV,IAAI;YAYJ,IAAI;CAYrB"}
+{"version":3,"file":"state-machine.d.ts","sourceRoot":"","sources":["../src/state-machine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,OAAO,KAAK,EAIR,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACpB,MAAM,SAAS,CAAC;AAGjB,yDAAyD;AACzD,MAAM,WAAW,yBAAyB;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;CACpD;AAED,wEAAwE;AACxE,qBAAa,kBAAkB;IACf,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,yBAAyB;IAE/D,6DAA6D;IACvD,GAAG,CAAC,QAAQ,EAAE,uBAAuB,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAU5F,IAAI;IA6FlB;;;;;OAKG;YACW,UAAU;CA0C3B"}

package/dist/state-machine.js

@@ -1,6 +1,6 @@
-import { getProcessEnv } from '@gobing-ai/ts-runtime';
 import { FSMError } from './errors.js';
-import { mergeVars, resolveTemplates } from './variables.js';
+import { allowedEnv, RunLifecycle, runtimeBuiltins } from './run-lifecycle.js';
+import { mergeVars, resolveOnErrorPolicy, resolveTemplates } from './variables.js';
 /** State-machine workflow driver with an R7 single control function. */
 export class StateMachineDriver {
     options;
@@ -9,36 +9,43 @@ export class StateMachineDriver {
     }
     /** Run a state-machine workflow to completion or failure. */
     async run(workflow, options = {}) {
-        const runId = options.runId ?? crypto.randomUUID();
-        const startedAt = new Date().toISOString();
-        const mode = 'state-machine';
-        await this.options.persistence.createRun(runRecord(runId, workflow.name, mode, startedAt, options.metadata));
+        return await RunLifecycle.run(workflow.name, 'state-machine', { persistence: this.options.persistence, events: options.events }, options, (lifecycle) => this.loop(workflow, options, lifecycle));
+    }
+    async loop(workflow, options, lifecycle) {
+        const runId = lifecycle.runId;
         const states = new Map(workflow.states.map((state) => [state.id, state]));
         const terminal = new Set(workflow.terminalStates ?? []);
         const vars = mergeVars(workflow.vars, options.vars);
-        const env = allowedEnv(workflow.env?.allow ?? [], options.env ?? getProcessEnv());
+        const env = allowedEnv(workflow.env?.allow ?? [], options.env);
         let current = states.get(workflow.initialState);
         let transitionsTaken = 0;
         let lastActionResult;
         const iterationBound = workflow.iterationBound ?? 50;
+        const defaultOnError = workflow.defaultOnError;
         if (current === undefined)
             throw new FSMError(`Initial state "${workflow.initialState}" is not declared`);
         while (true) {
             // 1. Persist current state snapshot before work starts.
-            await this.options.persistence.saveWorkflowState(runId, current.id, { transitionsTaken });
-            await this.options.persistence.savePhase(runId, current.id, 'running');
+            await lifecycle.enter(current.id, transitionsTaken);
             // 2. Execute this state's on-enter actions in declaration order.
-            lastActionResult = await this.runActions(current.onEnter ?? [], workflow.name, current.id, runId, vars, env, options, transitionsTaken);
-            if (lastActionResult?.ok === false)
-                return await this.fail(runId, workflow.name, mode, current.id, transitionsTaken, lastActionResult.error);
+            const enter = await this.runActions(current.onEnter ?? [], workflow.name, current.id, runId, vars, env, options, transitionsTaken, lifecycle, defaultOnError);
+            // Retain the last action result (including failures the policy continued
+            // past) so downstream guards can inspect it — matching the transition-flow
+            // driver's `continue` semantics. A state with no enter actions must not
+            // erase the previous result.
+            if (enter.result !== undefined)
+                lastActionResult = enter.result;
             // 3. Stop immediately when an action explicitly declares terminal success.
-            if (lastActionResult?.terminal === true) {
-                return await this.done(runId, workflow.name, mode, current.id, transitionsTaken);
+            if (enter.outcome === 'terminal') {
+                return await lifecycle.done(current.id, transitionsTaken);
+            }
+            // 4. Halt only when an action failed under a 'fail' policy.
+            if (enter.outcome === 'fail') {
+                return await lifecycle.fail(current.id, transitionsTaken, lastActionResult?.error);
             }
-            // 4. Stop when the current state is terminal or has no outbound transitions.
             const outbound = workflow.transitions.filter((transition) => transition.from === current?.id);
             if (terminal.has(current.id) || outbound.length === 0) {
-                return await this.done(runId, workflow.name, mode, current.id, transitionsTaken);
+                return await lifecycle.done(current.id, transitionsTaken);
             }
             // 5. Evaluate transition guards in declaration order and pick the first passing transition.
             const nextTransition = await firstPassingTransition(outbound, this.options.host, {
@@ -48,17 +55,19 @@ export class StateMachineDriver {
                 lastActionResult,
             });
             if (nextTransition === undefined) {
-                return await this.fail(runId, workflow.name, mode, current.id, transitionsTaken, 'no-passing-transition');
+                return await lifecycle.fail(current.id, transitionsTaken, 'no-passing-transition');
             }
             // 6. Execute this state's on-exit actions before changing state.
-            const exitResult = await this.runActions(current.onExit ?? [], workflow.name, current.id, runId, vars, env, options, transitionsTaken);
-            if (exitResult?.ok === false)
-                return await this.fail(runId, workflow.name, mode, current.id, transitionsTaken, exitResult.error);
+            const exit = await this.runActions(current.onExit ?? [], workflow.name, current.id, runId, vars, env, options, transitionsTaken, lifecycle, defaultOnError);
+            if (exit.result !== undefined)
+                lastActionResult = exit.result;
+            if (exit.outcome === 'fail')
+                return await lifecycle.fail(current.id, transitionsTaken, exit.result?.error);
             // 7. Persist transition and move to the target state.
             transitionsTaken += 1;
-            await this.options.persistence.saveTransition(runId, current.id, nextTransition.to, nextTransition.trigger ?? null);
+            await lifecycle.recordTransition(current.id, nextTransition.to, nextTransition.trigger ?? null);
             if (transitionsTaken > iterationBound) {
-                return await this.fail(runId, workflow.name, mode, current.id, transitionsTaken, 'iteration-bound-exceeded');
+                return await lifecycle.fail(current.id, transitionsTaken, 'iteration-bound-exceeded');
             }
             const nextState = states.get(nextTransition.to);
             if (nextState === undefined)
@@ -66,51 +75,47 @@ export class StateMachineDriver {
             current = nextState;
         }
     }
-    async runActions(actions, workflowName, stateId, runId, vars, env, options, transitionsTaken) {
+    /**
+     * Run a state's actions in order. Returns the last action result (retained even
+     * when a failure was continued past, so downstream guards can inspect it) plus an
+     * `outcome` discriminator: `terminal` (an action declared terminal success),
+     * `fail` (a failure under a 'fail' policy — caller must halt), or `completed`.
+     */
+    async runActions(actions, workflowName, stateId, runId, vars, env, options, transitionsTaken, lifecycle, defaultOnError) {
         let last;
         for (const action of actions) {
             const resolved = resolveTemplates(action.options ?? {}, {
                 vars,
                 env,
-                builtins: runtimeBuiltins(workflowName, stateId, runId, transitionsTaken),
+                builtins: runtimeBuiltins(workflowName, stateId, runId, transitionsTaken, 'state-machine'),
             });
-            last = await this.options.host.runAction(action.kind, resolved, {
-                runId,
-                workdir: options.workdir,
-                stateOrNodeId: stateId,
-                vars,
-                env,
-                metadata: options.metadata,
-            });
-            if (!last.ok || last.terminal === true)
-                return last;
+            const actionStartMs = Date.now();
+            lifecycle.actionStart(stateId, action.kind);
+            try {
+                last = await this.options.host.runAction(action.kind, resolved, {
+                    runId,
+                    workdir: options.workdir,
+                    stateOrNodeId: stateId,
+                    vars,
+                    env,
+                    metadata: options.metadata,
+                });
+            }
+            finally {
+                lifecycle.actionDone(stateId, action.kind, Date.now() - actionStartMs, last?.ok ?? false);
+            }
+            if (last.terminal === true)
+                return { outcome: 'terminal', result: last };
+            if (!last.ok) {
+                const policy = resolveOnErrorPolicy(action.onError, defaultOnError, options.onError);
+                if (policy === 'fail')
+                    return { outcome: 'fail', result: last };
+                lifecycle.warnActionFailed(stateId, transitionsTaken, last.error);
+            }
         }
-        return last;
-    }
-    async done(runId, workflowName, mode, finalState, transitionsTaken) {
-        await this.options.persistence.savePhase(runId, finalState, 'done');
-        await this.options.persistence.finalizeRun(runId, 'done', new Date().toISOString());
-        return { runId, workflowName, mode, status: 'done', finalState, transitionsTaken };
-    }
-    async fail(runId, workflowName, mode, finalState, transitionsTaken, reason = 'failed') {
-        await this.options.persistence.savePhase(runId, finalState, 'failed');
-        await this.options.persistence.finalizeRun(runId, 'failed', new Date().toISOString());
-        return { runId, workflowName, mode, status: 'failed', finalState, transitionsTaken, reason };
+        return { outcome: 'completed', result: last };
     }
 }
-/** Built-in bare template values available to state-machine action options. */
-function runtimeBuiltins(workflowName, stateId, runId, transitionsTaken) {
-    return {
-        workflow: workflowName,
-        runId,
-        task: workflowName,
-        state: stateId,
-        node: stateId,
-        iteration: transitionsTaken,
-        run: runId,
-        runtime: 'state-machine',
-    };
-}
 async function firstPassingTransition(transitions, host, context) {
     for (const transition of transitions) {
         if (transition.guard === undefined)
@@ -120,17 +125,3 @@ async function firstPassingTransition(transitions, host, context) {
     }
     return undefined;
 }
-function allowedEnv(names, source) {
-    return Object.fromEntries(names.flatMap((name) => (source[name] === undefined ? [] : [[name, source[name]]])));
-}
-function runRecord(runId, workflowName, mode, startedAt, metadata) {
-    return {
-        id: runId,
-        workflow_name: workflowName,
-        mode,
-        status: 'running',
-        started_at: startedAt,
-        completed_at: null,
-        metadata_json: JSON.stringify(metadata ?? {}),
-    };
-}

package/dist/transition-flow.d.ts

@@ -11,7 +11,6 @@ export declare class TransitionFlowDriver {
     constructor(options: TransitionFlowDriverOptions);
     /** Run a transition-flow workflow to completion or failure. */
     run(workflow: TransitionFlowWorkflowDef, options?: WorkflowRunOptions): Promise<WorkflowRunResult>;
-    private done;
-    private fail;
+    private loop;
 }
 //# sourceMappingURL=transition-flow.d.ts.map

package/dist/transition-flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transition-flow.d.ts","sourceRoot":"","sources":["../src/transition-flow.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,KAAK,EAER,yBAAyB,EACzB,0BAA0B,EAC1B,kBAAkB,EAElB,iBAAiB,EACpB,MAAM,SAAS,CAAC;AAGjB,2DAA2D;AAC3D,MAAM,WAAW,2BAA2B;IACxC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;CACpD;AAED,0EAA0E;AAC1E,qBAAa,oBAAoB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,2BAA2B;IAEjE,+DAA+D;IACzD,GAAG,CAAC,QAAQ,EAAE,yBAAyB,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YA8F9F,IAAI;YAYJ,IAAI;CAYrB"}
+{"version":3,"file":"transition-flow.d.ts","sourceRoot":"","sources":["../src/transition-flow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,OAAO,KAAK,EAER,yBAAyB,EACzB,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACpB,MAAM,SAAS,CAAC;AAGjB,2DAA2D;AAC3D,MAAM,WAAW,2BAA2B;IACxC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,0BAA0B,CAAC;CACpD;AAED,0EAA0E;AAC1E,qBAAa,oBAAoB;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,2BAA2B;IAEjE,+DAA+D;IACzD,GAAG,CAAC,QAAQ,EAAE,yBAAyB,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAU9F,IAAI;CA8FrB"}

package/dist/transition-flow.js

@@ -1,6 +1,6 @@
-import { getProcessEnv } from '@gobing-ai/ts-runtime';
 import { FSMError } from './errors.js';
-import { mergeVars, resolveTemplates } from './variables.js';
+import { allowedEnv, RunLifecycle, runtimeBuiltins } from './run-lifecycle.js';
+import { mergeVars, resolveOnErrorPolicy, resolveTemplates } from './variables.js';
 /** Transition-flow workflow driver with an R7 single control function. */
 export class TransitionFlowDriver {
     options;
@@ -9,51 +9,62 @@ export class TransitionFlowDriver {
     }
     /** Run a transition-flow workflow to completion or failure. */
     async run(workflow, options = {}) {
-        const runId = options.runId ?? crypto.randomUUID();
-        const startedAt = new Date().toISOString();
-        const mode = 'transition-flow';
-        await this.options.persistence.createRun(runRecord(runId, workflow.name, mode, startedAt, options.metadata));
+        return await RunLifecycle.run(workflow.name, 'transition-flow', { persistence: this.options.persistence, events: options.events }, options, (lifecycle) => this.loop(workflow, options, lifecycle));
+    }
+    async loop(workflow, options, lifecycle) {
+        const runId = lifecycle.runId;
         const nodes = new Map(workflow.nodes.map((node) => [node.id, node]));
         const terminal = new Set(workflow.terminalNodes ?? []);
         const vars = mergeVars(workflow.vars, options.vars);
-        const env = allowedEnv(workflow.env?.allow ?? [], options.env ?? getProcessEnv());
+        const env = allowedEnv(workflow.env?.allow ?? [], options.env);
         let current = nodes.get(workflow.initialNode);
         let transitionsTaken = 0;
         let lastActionResult;
         const iterationBound = workflow.iterationBound ?? 50;
+        const defaultOnError = workflow.defaultOnError;
         if (current === undefined) {
             throw new FSMError(`Initial node "${workflow.initialNode}" is not declared`);
         }
         while (true) {
             // 1. Persist current node snapshot before action execution.
-            await this.options.persistence.saveWorkflowState(runId, current.id, { transitionsTaken });
-            await this.options.persistence.savePhase(runId, current.id, 'running');
+            await lifecycle.enter(current.id, transitionsTaken);
             // 2. Execute the node action when one is configured.
             if (current.action !== undefined) {
                 const resolved = resolveTemplates(current.action.options ?? {}, {
                     vars,
                     env,
-                    builtins: runtimeBuiltins(workflow.name, current.id, runId, transitionsTaken),
-                });
-                lastActionResult = await this.options.host.runAction(current.action.kind, resolved, {
-                    runId,
-                    workdir: options.workdir,
-                    stateOrNodeId: current.id,
-                    vars,
-                    env,
-                    metadata: options.metadata,
+                    builtins: runtimeBuiltins(workflow.name, current.id, runId, transitionsTaken, 'transition-flow'),
                 });
+                const actionStartMs = Date.now();
+                lifecycle.actionStart(current.id, current.action.kind);
+                try {
+                    lastActionResult = await this.options.host.runAction(current.action.kind, resolved, {
+                        runId,
+                        workdir: options.workdir,
+                        stateOrNodeId: current.id,
+                        vars,
+                        env,
+                        metadata: options.metadata,
+                    });
+                }
+                finally {
+                    lifecycle.actionDone(current.id, current.action.kind, Date.now() - actionStartMs, lastActionResult?.ok ?? false);
+                }
                 if (!lastActionResult.ok) {
-                    return await this.fail(runId, workflow.name, mode, current.id, transitionsTaken, lastActionResult.error);
+                    const policy = resolveOnErrorPolicy(current.action.onError, defaultOnError, options.onError);
+                    if (policy === 'fail') {
+                        return await lifecycle.fail(current.id, transitionsTaken, lastActionResult.error);
+                    }
+                    lifecycle.warnActionFailed(current.id, transitionsTaken, lastActionResult.error);
                 }
                 if (lastActionResult.terminal === true) {
-                    return await this.done(runId, workflow.name, mode, current.id, transitionsTaken);
+                    return await lifecycle.done(current.id, transitionsTaken);
                 }
             }
             // 3. Stop when the node is terminal or no outgoing edge exists.
             const outbound = workflow.edges.filter((edge) => edge.from === current?.id);
             if (terminal.has(current.id) || outbound.length === 0) {
-                return await this.done(runId, workflow.name, mode, current.id, transitionsTaken);
+                return await lifecycle.done(current.id, transitionsTaken);
             }
             // 4. Evaluate edge conditions in declaration order and pick the first passing edge.
             const edge = await firstPassingEdge(outbound, this.options.host, {
@@ -63,14 +74,14 @@ export class TransitionFlowDriver {
                 lastActionResult,
             });
             if (edge === undefined) {
-                return await this.fail(runId, workflow.name, mode, current.id, transitionsTaken, 'no-passing-edge');
+                return await lifecycle.fail(current.id, transitionsTaken, 'no-passing-edge');
             }
             // 5. Persist the edge transition.
             transitionsTaken += 1;
-            await this.options.persistence.saveTransition(runId, current.id, edge.to, edge.condition?.kind ?? null);
+            await lifecycle.recordTransition(current.id, edge.to, edge.condition?.kind ?? null);
             // 6. Enforce the iteration bound after taking the transition.
             if (transitionsTaken > iterationBound) {
-                return await this.fail(runId, workflow.name, mode, current.id, transitionsTaken, 'iteration-bound-exceeded');
+                return await lifecycle.fail(current.id, transitionsTaken, 'iteration-bound-exceeded');
             }
             // 7. Move to the target node and repeat.
             const nextNode = nodes.get(edge.to);
@@ -79,29 +90,6 @@ export class TransitionFlowDriver {
             current = nextNode;
         }
     }
-    async done(runId, workflowName, mode, finalState, transitionsTaken) {
-        await this.options.persistence.savePhase(runId, finalState, 'done');
-        await this.options.persistence.finalizeRun(runId, 'done', new Date().toISOString());
-        return { runId, workflowName, mode, status: 'done', finalState, transitionsTaken };
-    }
-    async fail(runId, workflowName, mode, finalState, transitionsTaken, reason = 'failed') {
-        await this.options.persistence.savePhase(runId, finalState, 'failed');
-        await this.options.persistence.finalizeRun(runId, 'failed', new Date().toISOString());
-        return { runId, workflowName, mode, status: 'failed', finalState, transitionsTaken, reason };
-    }
-}
-/** Built-in bare template values available to transition-flow action options. */
-function runtimeBuiltins(workflowName, nodeId, runId, transitionsTaken) {
-    return {
-        workflow: workflowName,
-        runId,
-        task: workflowName,
-        state: nodeId,
-        node: nodeId,
-        iteration: transitionsTaken,
-        run: runId,
-        runtime: 'transition-flow',
-    };
 }
 async function firstPassingEdge(edges, host, context) {
     for (const edge of edges) {
@@ -112,17 +100,3 @@ async function firstPassingEdge(edges, host, context) {
     }
     return undefined;
 }
-function allowedEnv(names, source) {
-    return Object.fromEntries(names.flatMap((name) => (source[name] === undefined ? [] : [[name, source[name]]])));
-}
-function runRecord(runId, workflowName, mode, startedAt, metadata) {
-    return {
-        id: runId,
-        workflow_name: workflowName,
-        mode,
-        status: 'running',
-        started_at: startedAt,
-        completed_at: null,
-        metadata_json: JSON.stringify(metadata ?? {}),
-    };
-}

package/dist/types.d.ts

@@ -1,3 +1,7 @@
+/** Action error handling policy: fail-fast or log-and-continue. */
+export type OnErrorPolicy = 'fail' | 'continue';
+import type { EventBus } from '@gobing-ai/ts-infra';
+import type { WorkflowEngineEvents } from './events';
 /** Workflow execution status persisted for runs and phases. */
 export type WorkflowStatus = 'running' | 'done' | 'failed';
 /** Runtime variables and user variables available to workflow definitions. */
@@ -10,6 +14,8 @@ export interface Env {
 export interface ActionDef {
     readonly kind: string;
     readonly options?: Record<string, unknown>;
+    /** Per-action error policy override. Falls back to workflow default then run-option then 'fail'. */
+    readonly onError?: OnErrorPolicy;
 }
 /** Guard predicate definition used by state-machine transitions and transition-flow edges. */
 export interface GuardDef {
@@ -44,6 +50,8 @@ export interface StateMachineWorkflowDef {
     readonly initialState: string;
     readonly terminalStates?: readonly string[];
     readonly iterationBound?: number;
+    /** Default error policy applied to actions that don't specify their own. Defaults to 'fail'. */
+    readonly defaultOnError?: OnErrorPolicy;
     readonly vars?: Vars;
     readonly env?: Env;
     readonly states: readonly StateDef[];
@@ -76,6 +84,8 @@ export interface TransitionFlowWorkflowDef {
     readonly initialNode: string;
     readonly terminalNodes?: readonly string[];
     readonly iterationBound?: number;
+    /** Default error policy applied to actions that don't specify their own. Defaults to 'fail'. */
+    readonly defaultOnError?: OnErrorPolicy;
     readonly vars?: Vars;
     readonly env?: Env;
     readonly nodes: readonly FlowNodeDef[];
@@ -123,6 +133,10 @@ export interface WorkflowRunOptions {
     readonly vars?: Vars;
     readonly env?: Record<string, string | undefined>;
     readonly metadata?: Record<string, unknown>;
+    /** Optional event bus for structured run observability. */
+    readonly events?: EventBus<WorkflowEngineEvents>;
+    /** Run-level error policy override. Lowest precedence; action-level wins. */
+    readonly onError?: OnErrorPolicy;
 }
 /** Result returned by both driver loops. */
 export interface WorkflowRunResult {

package/dist/types.d.ts.map

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

package/dist/variables.d.ts

@@ -1,4 +1,4 @@
-import type { Vars } from './types';
+import type { OnErrorPolicy, Vars } from './types';
 /** Runtime context used for workflow variable interpolation. */
 export interface VariableContext {
     readonly vars: Vars;
@@ -11,4 +11,9 @@ export declare function mergeVars(workflowVars?: Vars, overrideVars?: Vars): Var
 export declare function resolveTemplates<T>(value: T, context: VariableContext): T;
 /** Resolve a single template string. */
 export declare function resolveTemplateString(value: string, context: VariableContext): string;
+/**
+ * Resolve the effective error policy via fixed precedence:
+ * `action.onError ?? workflow.defaultOnError ?? runOptions.onError ?? 'fail'`.
+ */
+export declare function resolveOnErrorPolicy(actionOnError: OnErrorPolicy | undefined, workflowDefault: OnErrorPolicy | undefined, runOptionOverride: OnErrorPolicy | undefined): OnErrorPolicy;
 //# sourceMappingURL=variables.d.ts.map

package/dist/variables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../src/variables.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAIpC,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CACnE;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,YAAY,GAAE,IAAS,EAAE,YAAY,GAAE,IAAS,GAAG,IAAI,CAEhF;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,CAAC,CAgBzE;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAmBrF"}
+{"version":3,"file":"variables.d.ts","sourceRoot":"","sources":["../src/variables.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAInD,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CACnE;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,YAAY,GAAE,IAAS,EAAE,YAAY,GAAE,IAAS,GAAG,IAAI,CAEhF;AAED,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,eAAe,GAAG,CAAC,CAgBzE;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,CAmBrF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,aAAa,EAAE,aAAa,GAAG,SAAS,EACxC,eAAe,EAAE,aAAa,GAAG,SAAS,EAC1C,iBAAiB,EAAE,aAAa,GAAG,SAAS,GAC7C,aAAa,CAEf"}

package/dist/variables.js

@@ -43,3 +43,10 @@ export function resolveTemplateString(value, context) {
         return String(resolved);
     });
 }
+/**
+ * Resolve the effective error policy via fixed precedence:
+ * `action.onError ?? workflow.defaultOnError ?? runOptions.onError ?? 'fail'`.
+ */
+export function resolveOnErrorPolicy(actionOnError, workflowDefault, runOptionOverride) {
+    return actionOnError ?? workflowDefault ?? runOptionOverride ?? 'fail';
+}