@hexabot-ai/agentic 3.1.2-alpha.15 → 3.1.2-alpha.17

package/dist/cjs/step-executors/task-executor.js

@@ -31,7 +31,7 @@ async function executeTaskStep(env, step, state, _path) {
         accumulator: state.accumulator,
     };
     const inputs = await (0, workflow_values_1.evaluateMapping)(task.inputs, scope);
-    env.recordStepExecution(stepInfo, {
+    const stepExecution = env.recordStepExecution(stepInfo, {
         action: task.actionName,
         status: 'running',
         startedAt: Date.now(),
@@ -41,7 +41,11 @@ async function executeTaskStep(env, step, state, _path) {
     env.beginStepExecution?.(stepInfo.id);
     env.setCurrentStep(stepInfo);
     env.markSnapshot(stepInfo, 'running');
-    env.emit('hook:step:start', { runId: env.runId, step: stepInfo });
+    env.emit('hook:step:start', {
+        runId: env.runId,
+        step: stepInfo,
+        stepExecution,
+    });
     try {
         const actionPromise = Promise.resolve().then(() => task.action.run(inputs, env.context, task.settings, task.bindings));
         const outcome = await waitForTaskProgress(env, stepInfo.id, actionPromise);
@@ -69,18 +73,22 @@ const waitForTaskProgress = async (env, stepId, actionPromise) => {
 };
 const completeTask = async (env, stepId, stepInfo, task, state, result) => {
     await env.captureTaskOutput(task, state, result);
-    env.recordStepExecution(stepInfo, {
+    const stepExecution = env.recordStepExecution(stepInfo, {
         status: 'completed',
         endedAt: Date.now(),
         output: result,
         context: { after: env.context.snapshot() },
     });
     env.markSnapshot(stepInfo, 'completed');
-    env.emit('hook:step:success', { runId: env.runId, step: stepInfo });
+    env.emit('hook:step:success', {
+        runId: env.runId,
+        step: stepInfo,
+        stepExecution,
+    });
     env.clearStepSuspensions(stepId);
 };
 const recordSuspension = (env, stepInfo, reason, data) => {
-    env.recordStepExecution(stepInfo, {
+    const stepExecution = env.recordStepExecution(stepInfo, {
         status: 'suspended',
         endedAt: Date.now(),
         reason,
@@ -90,6 +98,7 @@ const recordSuspension = (env, stepInfo, reason, data) => {
     env.emit('hook:step:suspended', {
         runId: env.runId,
         step: stepInfo,
+        stepExecution,
         reason,
         data,
     });
@@ -140,14 +149,20 @@ const buildSuspensionContinuation = (env, stepId, stepInfo, task, state, actionP
     };
 };
 const recordTaskFailure = (env, stepInfo, error) => {
-    env.recordStepExecution(stepInfo, {
+    const normalizedError = normalizeError(error);
+    const stepExecution = env.recordStepExecution(stepInfo, {
         status: 'failed',
         endedAt: Date.now(),
-        error: normalizeError(error),
+        error: normalizedError,
         context: { after: env.context.snapshot() },
     });
     env.markSnapshot(stepInfo, 'failed', normalizeErrorMessage(error));
-    env.emit('hook:step:error', { runId: env.runId, step: stepInfo, error });
+    env.emit('hook:step:error', {
+        runId: env.runId,
+        step: stepInfo,
+        stepExecution,
+        error,
+    });
 };
 const normalizeError = (error) => error instanceof Error
     ? { message: error.message, stack: error.stack }

package/dist/cjs/workflow-runner.js

@@ -316,7 +316,7 @@ class WorkflowRunner {
         const mergedContext = existing?.context || update.context
             ? { ...existing?.context, ...update.context }
             : undefined;
-        this.stepLog[step.id] = {
+        const nextRecord = {
             ...base,
             ...update,
             id: step.id,
@@ -324,6 +324,12 @@ class WorkflowRunner {
             status: update.status ?? base.status,
             context: mergedContext,
         };
+        this.stepLog[step.id] = nextRecord;
+        return {
+            ...nextRecord,
+            context: nextRecord.context ? { ...nextRecord.context } : undefined,
+            error: nextRecord.error ? { ...nextRecord.error } : undefined,
+        };
     }
     /**
      * Construct the environment object passed to step executors.

package/dist/esm/step-executors/task-executor.js

@@ -28,7 +28,7 @@ export async function executeTaskStep(env, step, state, _path) {
         accumulator: state.accumulator,
     };
     const inputs = await evaluateMapping(task.inputs, scope);
-    env.recordStepExecution(stepInfo, {
+    const stepExecution = env.recordStepExecution(stepInfo, {
         action: task.actionName,
         status: 'running',
         startedAt: Date.now(),
@@ -38,7 +38,11 @@ export async function executeTaskStep(env, step, state, _path) {
     env.beginStepExecution?.(stepInfo.id);
     env.setCurrentStep(stepInfo);
     env.markSnapshot(stepInfo, 'running');
-    env.emit('hook:step:start', { runId: env.runId, step: stepInfo });
+    env.emit('hook:step:start', {
+        runId: env.runId,
+        step: stepInfo,
+        stepExecution,
+    });
     try {
         const actionPromise = Promise.resolve().then(() => task.action.run(inputs, env.context, task.settings, task.bindings));
         const outcome = await waitForTaskProgress(env, stepInfo.id, actionPromise);
@@ -66,18 +70,22 @@ const waitForTaskProgress = async (env, stepId, actionPromise) => {
 };
 const completeTask = async (env, stepId, stepInfo, task, state, result) => {
     await env.captureTaskOutput(task, state, result);
-    env.recordStepExecution(stepInfo, {
+    const stepExecution = env.recordStepExecution(stepInfo, {
         status: 'completed',
         endedAt: Date.now(),
         output: result,
         context: { after: env.context.snapshot() },
     });
     env.markSnapshot(stepInfo, 'completed');
-    env.emit('hook:step:success', { runId: env.runId, step: stepInfo });
+    env.emit('hook:step:success', {
+        runId: env.runId,
+        step: stepInfo,
+        stepExecution,
+    });
     env.clearStepSuspensions(stepId);
 };
 const recordSuspension = (env, stepInfo, reason, data) => {
-    env.recordStepExecution(stepInfo, {
+    const stepExecution = env.recordStepExecution(stepInfo, {
         status: 'suspended',
         endedAt: Date.now(),
         reason,
@@ -87,6 +95,7 @@ const recordSuspension = (env, stepInfo, reason, data) => {
     env.emit('hook:step:suspended', {
         runId: env.runId,
         step: stepInfo,
+        stepExecution,
         reason,
         data,
     });
@@ -137,14 +146,20 @@ const buildSuspensionContinuation = (env, stepId, stepInfo, task, state, actionP
     };
 };
 const recordTaskFailure = (env, stepInfo, error) => {
-    env.recordStepExecution(stepInfo, {
+    const normalizedError = normalizeError(error);
+    const stepExecution = env.recordStepExecution(stepInfo, {
         status: 'failed',
         endedAt: Date.now(),
-        error: normalizeError(error),
+        error: normalizedError,
         context: { after: env.context.snapshot() },
     });
     env.markSnapshot(stepInfo, 'failed', normalizeErrorMessage(error));
-    env.emit('hook:step:error', { runId: env.runId, step: stepInfo, error });
+    env.emit('hook:step:error', {
+        runId: env.runId,
+        step: stepInfo,
+        stepExecution,
+        error,
+    });
 };
 const normalizeError = (error) => error instanceof Error
     ? { message: error.message, stack: error.stack }

package/dist/esm/workflow-runner.js

@@ -313,7 +313,7 @@ export class WorkflowRunner {
         const mergedContext = existing?.context || update.context
             ? { ...existing?.context, ...update.context }
             : undefined;
-        this.stepLog[step.id] = {
+        const nextRecord = {
             ...base,
             ...update,
             id: step.id,
@@ -321,6 +321,12 @@ export class WorkflowRunner {
             status: update.status ?? base.status,
             context: mergedContext,
         };
+        this.stepLog[step.id] = nextRecord;
+        return {
+            ...nextRecord,
+            context: nextRecord.context ? { ...nextRecord.context } : undefined,
+            error: nextRecord.error ? { ...nextRecord.error } : undefined,
+        };
     }
     /**
      * Construct the environment object passed to step executors.

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

@@ -1 +1 @@
-{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../../src/step-executors/task-executor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAGV,cAAc,EACd,UAAU,EACV,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAO/C;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAC5B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAiE5B"}
+{"version":3,"file":"task-executor.d.ts","sourceRoot":"","sources":["../../../src/step-executors/task-executor.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAGV,cAAc,EACd,UAAU,EACV,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAO/C;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAC5B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAqE5B"}

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

@@ -8,7 +8,7 @@ export type StepExecutorEnv = {
     runId?: string;
     buildInstanceStepInfo: (step: CompiledStep, iterationStack: number[]) => StepInfo;
     markSnapshot: (step: StepInfo, status: ActionSnapshot['status'], reason?: string) => void;
-    recordStepExecution: (step: StepInfo, update: Partial<StepExecutionRecord>) => void;
+    recordStepExecution: (step: StepInfo, update: Partial<StepExecutionRecord>) => StepExecutionRecord;
     emit: <K extends keyof WorkflowEventMap>(event: K, payload: WorkflowEventMap[K]) => void;
     setCurrentStep: (step?: StepInfo) => void;
     beginStepExecution?: (stepId: string) => string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/step-executors/types.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,CACrB,IAAI,EAAE,YAAY,EAClB,cAAc,EAAE,MAAM,EAAE,KACrB,QAAQ,CAAC;IACd,YAAY,EAAE,CACZ,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAChC,MAAM,CAAC,EAAE,MAAM,KACZ,IAAI,CAAC;IACV,mBAAmB,EAAE,CACnB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,KACjC,IAAI,CAAC;IACV,IAAI,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACrC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KACzB,IAAI,CAAC;IACV,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC1C,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,qBAAqB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC7E,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAChE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACnE,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC1D,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACtE,iBAAiB,EAAE,CACjB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,OAAO,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,EAAE,CACX,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAC5B,UAAU,CAAC,EAAE,MAAM,KAChB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAChC,WAAW,EAAE,CACX,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KACzB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CACjC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/step-executors/types.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,CACrB,IAAI,EAAE,YAAY,EAClB,cAAc,EAAE,MAAM,EAAE,KACrB,QAAQ,CAAC;IACd,YAAY,EAAE,CACZ,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAChC,MAAM,CAAC,EAAE,MAAM,KACZ,IAAI,CAAC;IACV,mBAAmB,EAAE,CACnB,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,KACjC,mBAAmB,CAAC;IACzB,IAAI,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACrC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KACzB,IAAI,CAAC;IACV,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC1C,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAChD,qBAAqB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC7E,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAChE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACnE,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC1D,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACtE,iBAAiB,EAAE,CACjB,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,OAAO,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,EAAE,CACX,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,EAC5B,UAAU,CAAC,EAAE,MAAM,KAChB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAChC,WAAW,EAAE,CACX,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KACzB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CACjC,CAAC"}

package/dist/types/workflow-event-emitter.d.ts

@@ -1,3 +1,4 @@
+import type { StepExecutionRecord } from './context';
 export declare enum StepType {
     Task = "task",
     Parallel = "parallel",
@@ -9,6 +10,11 @@ export type StepInfo = {
     name: string;
     type: StepType;
 };
+export type StepWorkflowEventPayload = {
+    runId?: string;
+    step: StepInfo;
+    stepExecution?: StepExecutionRecord;
+};
 export type WorkflowEventMap = {
     'hook:workflow:start': {
         runId?: string;
@@ -27,22 +33,12 @@ export type WorkflowEventMap = {
         reason?: string;
         data?: unknown;
     };
-    'hook:step:start': {
-        runId?: string;
-        step: StepInfo;
-    };
-    'hook:step:success': {
-        runId?: string;
-        step: StepInfo;
-    };
-    'hook:step:error': {
-        runId?: string;
-        step: StepInfo;
+    'hook:step:start': StepWorkflowEventPayload;
+    'hook:step:success': StepWorkflowEventPayload;
+    'hook:step:error': StepWorkflowEventPayload & {
         error: unknown;
     };
-    'hook:step:suspended': {
-        runId?: string;
-        step: StepInfo;
+    'hook:step:suspended': StepWorkflowEventPayload & {
         reason?: string;
         data?: unknown;
     };

package/dist/types/workflow-event-emitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-event-emitter.d.ts","sourceRoot":"","sources":["../../src/workflow-event-emitter.ts"],"names":[],"mappings":"AAMA,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,IAAI,SAAS;CACd;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qBAAqB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,sBAAsB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC5E,uBAAuB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5D,yBAAyB,EAAE;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,QAAQ,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,iBAAiB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;IACtD,mBAAmB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;IACxD,iBAAiB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IACtE,qBAAqB,EAAE;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,QAAQ,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,mBAAmB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACtD,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,gBAAgB,CAAC;AAKzE;;;;GAIG;AACH,qBAAa,oBACX,YAAW,wBAAwB,CAAC,oBAAoB,CAAC;IAEzD,OAAO,CAAC,SAAS,CAAyC;IAE1D,IAAI,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACnC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,OAAO;IAWV,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACjC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,IAAI;CAOR"}
+{"version":3,"file":"workflow-event-emitter.d.ts","sourceRoot":"","sources":["../../src/workflow-event-emitter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,oBAAY,QAAQ;IAClB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,IAAI,SAAS;CACd;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qBAAqB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,sBAAsB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAC5E,uBAAuB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5D,yBAAyB,EAAE;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,QAAQ,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,mBAAmB,EAAE,wBAAwB,CAAC;IAC9C,iBAAiB,EAAE,wBAAwB,GAAG;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IACjE,qBAAqB,EAAE,wBAAwB,GAAG;QAChD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,mBAAmB,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACtD,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,gBAAgB,CAAC;AAKzE;;;;GAIG;AACH,qBAAa,oBACX,YAAW,wBAAwB,CAAC,oBAAoB,CAAC;IAEzD,OAAO,CAAC,SAAS,CAAyC;IAE1D,IAAI,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACnC,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,OAAO;IAWV,EAAE,CAAC,CAAC,SAAS,MAAM,gBAAgB,EACjC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC/C,IAAI;CAOR"}

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;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"}
+{"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;IAkC3B;;;;;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.15",
+  "version": "3.1.2-alpha.17",
   "description": "Schemas and utilities for the Hexabot agentic workflow DSL.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/src/step-executors/task-executor.test.ts

@@ -5,7 +5,7 @@
  */
 
 import type { Action } from '../action/action.types';
-import { BaseWorkflowContext } from '../context';
+import { BaseWorkflowContext, type StepExecutionRecord } from '../context';
 import type { RuntimeSuspensionRequest } from '../runner-runtime-control';
 import { createDeferred } from '../utils/deferred';
 import {
@@ -72,26 +72,54 @@ const createCompiled = (task: CompiledTask): CompiledWorkflow =>
 const createEnv = (
   compiled: CompiledWorkflow,
   stepInfo: StepInfo,
-): StepExecutorEnv => ({
-  compiled,
-  context: new TestContext(),
-  runId: 'run-123',
-  buildInstanceStepInfo: jest.fn().mockReturnValue(stepInfo),
-  markSnapshot: jest.fn(),
-  recordStepExecution: jest.fn(),
-  emit: jest.fn(),
-  setCurrentStep: jest.fn(),
-  waitForStepSuspension: jest
-    .fn()
-    .mockImplementation(
-      () => new Promise<RuntimeSuspensionRequest>(() => undefined),
-    ),
-  clearStepSuspensions: jest.fn(),
-  primeStepResumeData: jest.fn(),
-  captureTaskOutput: jest.fn().mockResolvedValue(undefined),
-  executeFlow: jest.fn(),
-  executeStep: jest.fn(),
-});
+): StepExecutorEnv => {
+  const stepRecords: Record<string, StepExecutionRecord> = {};
+
+  return {
+    compiled,
+    context: new TestContext(),
+    runId: 'run-123',
+    buildInstanceStepInfo: jest.fn().mockReturnValue(stepInfo),
+    markSnapshot: jest.fn(),
+    recordStepExecution: jest.fn((step, update) => {
+      const existing =
+        stepRecords[step.id] ??
+        ({
+          id: step.id,
+          name: step.name,
+          status: 'pending',
+        } satisfies StepExecutionRecord);
+      const context =
+        existing.context || update.context
+          ? { ...existing.context, ...update.context }
+          : undefined;
+      const nextRecord = {
+        ...existing,
+        ...update,
+        id: step.id,
+        name: step.name,
+        status: update.status ?? existing.status,
+        context,
+      } satisfies StepExecutionRecord;
+
+      stepRecords[step.id] = nextRecord;
+
+      return nextRecord;
+    }),
+    emit: jest.fn(),
+    setCurrentStep: jest.fn(),
+    waitForStepSuspension: jest
+      .fn()
+      .mockImplementation(
+        () => new Promise<RuntimeSuspensionRequest>(() => undefined),
+      ),
+    clearStepSuspensions: jest.fn(),
+    primeStepResumeData: jest.fn(),
+    captureTaskOutput: jest.fn().mockResolvedValue(undefined),
+    executeFlow: jest.fn(),
+    executeStep: jest.fn(),
+  };
+};
 const step: TaskStep = {
   id: '0:test_task',
   type: StepType.Task,
@@ -153,10 +181,18 @@ describe('executeTaskStep', () => {
     expect(env.emit).toHaveBeenCalledWith('hook:step:start', {
       runId: 'run-123',
       step: stepInfo,
+      stepExecution: expect.objectContaining({
+        id: stepInfo.id,
+        status: 'running',
+      }),
     });
     expect(env.emit).toHaveBeenCalledWith('hook:step:success', {
       runId: 'run-123',
       step: stepInfo,
+      stepExecution: expect.objectContaining({
+        id: stepInfo.id,
+        status: 'completed',
+      }),
     });
     expect(env.setCurrentStep).toHaveBeenLastCalledWith(undefined);
   });
@@ -215,6 +251,16 @@ describe('executeTaskStep', () => {
       'suspended',
       'awaiting_user',
     );
+    expect(env.emit).toHaveBeenCalledWith('hook:step:suspended', {
+      runId: 'run-123',
+      step: stepInfo,
+      stepExecution: expect.objectContaining({
+        id: stepInfo.id,
+        status: 'suspended',
+      }),
+      reason: 'awaiting_user',
+      data: { channel: 'sms' },
+    });
 
     await suspension?.continue({ reply: 'Sure' });
 
@@ -228,6 +274,14 @@ describe('executeTaskStep', () => {
         output: { reply: 'SURE' },
       }),
     );
+    expect(env.emit).toHaveBeenCalledWith('hook:step:success', {
+      runId: 'run-123',
+      step: stepInfo,
+      stepExecution: expect.objectContaining({
+        id: stepInfo.id,
+        status: 'completed',
+      }),
+    });
   });
 
   it('marks failure and rethrows errors from the task', async () => {
@@ -250,6 +304,10 @@ describe('executeTaskStep', () => {
     expect(env.emit).toHaveBeenCalledWith('hook:step:error', {
       runId: 'run-123',
       step: stepInfo,
+      stepExecution: expect.objectContaining({
+        id: stepInfo.id,
+        status: 'failed',
+      }),
       error: expect.any(Error),
     });
     expect(env.setCurrentStep).toHaveBeenLastCalledWith(undefined);

package/src/step-executors/task-executor.ts

@@ -51,7 +51,7 @@ export async function executeTaskStep(
     accumulator: state.accumulator,
   };
   const inputs = await evaluateMapping(task.inputs, scope);
-  env.recordStepExecution(stepInfo, {
+  const stepExecution = env.recordStepExecution(stepInfo, {
     action: task.actionName,
     status: 'running',
     startedAt: Date.now(),
@@ -61,7 +61,11 @@ export async function executeTaskStep(
   env.beginStepExecution?.(stepInfo.id);
   env.setCurrentStep(stepInfo);
   env.markSnapshot(stepInfo, 'running');
-  env.emit('hook:step:start', { runId: env.runId, step: stepInfo });
+  env.emit('hook:step:start', {
+    runId: env.runId,
+    step: stepInfo,
+    stepExecution,
+  });
 
   try {
     const actionPromise = Promise.resolve().then(() =>
@@ -126,14 +130,18 @@ const completeTask = async (
   result: unknown,
 ) => {
   await env.captureTaskOutput(task, state, result);
-  env.recordStepExecution(stepInfo, {
+  const stepExecution = env.recordStepExecution(stepInfo, {
     status: 'completed',
     endedAt: Date.now(),
     output: result,
     context: { after: env.context.snapshot() },
   });
   env.markSnapshot(stepInfo, 'completed');
-  env.emit('hook:step:success', { runId: env.runId, step: stepInfo });
+  env.emit('hook:step:success', {
+    runId: env.runId,
+    step: stepInfo,
+    stepExecution,
+  });
   env.clearStepSuspensions(stepId);
 };
 const recordSuspension = (
@@ -142,7 +150,7 @@ const recordSuspension = (
   reason?: string,
   data?: unknown,
 ) => {
-  env.recordStepExecution(stepInfo, {
+  const stepExecution = env.recordStepExecution(stepInfo, {
     status: 'suspended',
     endedAt: Date.now(),
     reason,
@@ -152,6 +160,7 @@ const recordSuspension = (
   env.emit('hook:step:suspended', {
     runId: env.runId,
     step: stepInfo,
+    stepExecution,
     reason,
     data,
   });
@@ -231,14 +240,20 @@ const recordTaskFailure = (
   stepInfo: Suspension['step'],
   error: unknown,
 ) => {
-  env.recordStepExecution(stepInfo, {
+  const normalizedError = normalizeError(error);
+  const stepExecution = env.recordStepExecution(stepInfo, {
     status: 'failed',
     endedAt: Date.now(),
-    error: normalizeError(error),
+    error: normalizedError,
     context: { after: env.context.snapshot() },
   });
   env.markSnapshot(stepInfo, 'failed', normalizeErrorMessage(error));
-  env.emit('hook:step:error', { runId: env.runId, step: stepInfo, error });
+  env.emit('hook:step:error', {
+    runId: env.runId,
+    step: stepInfo,
+    stepExecution,
+    error,
+  });
 };
 const normalizeError = (error: unknown): { message: string; stack?: string } =>
   error instanceof Error

package/src/step-executors/types.ts

@@ -39,7 +39,7 @@ export type StepExecutorEnv = {
   recordStepExecution: (
     step: StepInfo,
     update: Partial<StepExecutionRecord>,
-  ) => void;
+  ) => StepExecutionRecord;
   emit: <K extends keyof WorkflowEventMap>(
     event: K,
     payload: WorkflowEventMap[K],

package/src/workflow-event-emitter.ts

@@ -4,6 +4,8 @@
  * Full terms: see LICENSE.md.
  */
 
+import type { StepExecutionRecord } from './context';
+
 export enum StepType {
   Task = 'task',
   Parallel = 'parallel',
@@ -17,6 +19,12 @@ export type StepInfo = {
   type: StepType;
 };
 
+export type StepWorkflowEventPayload = {
+  runId?: string;
+  step: StepInfo;
+  stepExecution?: StepExecutionRecord;
+};
+
 export type WorkflowEventMap = {
   'hook:workflow:start': { runId?: string };
   'hook:workflow:finish': { runId?: string; output: Record<string, unknown> };
@@ -27,12 +35,10 @@ export type WorkflowEventMap = {
     reason?: string;
     data?: unknown;
   };
-  'hook:step:start': { runId?: string; step: StepInfo };
-  'hook:step:success': { runId?: string; step: StepInfo };
-  'hook:step:error': { runId?: string; step: StepInfo; error: unknown };
-  'hook:step:suspended': {
-    runId?: string;
-    step: StepInfo;
+  'hook:step:start': StepWorkflowEventPayload;
+  'hook:step:success': StepWorkflowEventPayload;
+  'hook:step:error': StepWorkflowEventPayload & { error: unknown };
+  'hook:step:suspended': StepWorkflowEventPayload & {
     reason?: string;
     data?: unknown;
   };

package/src/workflow-runner.ts

@@ -425,7 +425,7 @@ export class WorkflowRunner {
   private recordStepExecution(
     step: StepInfo,
     update: Partial<StepExecutionRecord>,
-  ) {
+  ): StepExecutionRecord {
     const existing = this.stepLog[step.id];
     const base: StepExecutionRecord =
       existing ??
@@ -438,8 +438,7 @@ export class WorkflowRunner {
       existing?.context || update.context
         ? { ...existing?.context, ...update.context }
         : undefined;
-
-    this.stepLog[step.id] = {
+    const nextRecord: StepExecutionRecord = {
       ...base,
       ...update,
       id: step.id,
@@ -447,6 +446,14 @@ export class WorkflowRunner {
       status: update.status ?? base.status,
       context: mergedContext,
     };
+
+    this.stepLog[step.id] = nextRecord;
+
+    return {
+      ...nextRecord,
+      context: nextRecord.context ? { ...nextRecord.context } : undefined,
+      error: nextRecord.error ? { ...nextRecord.error } : undefined,
+    };
   }
 
   /**