@open-mercato/core 0.7.1-develop.7193.1.910a5b0a1e → 0.7.1-develop.7194.1.ab4fc81f82

package/dist/modules/workflows/lib/step-handler.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/step-handler.ts"],
-  "sourcesContent": ["/**\n * Workflows Module - Step Handler Service\n *\n * Handles individual workflow step execution:\n * - Creating step instances when entering a step\n * - Executing step logic based on step type (START, END, AUTOMATED, USER_TASK)\n * - Completing step instances when exiting\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport {\n  WorkflowInstance,\n  WorkflowBranchInstance,\n  StepInstance,\n  UserTask,\n  WorkflowEvent,\n  type StepInstanceStatus,\n  type WorkflowStepType,\n} from '../data/entities'\nimport { parseDuration } from './duration'\nimport { logWorkflowEvent } from './event-logger'\nimport { findDefinitionForInstance } from './find-definition'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\n\nconst logger = createLogger('workflows')\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport interface StepExecutionContext {\n  workflowContext: Record<string, any>\n  userId?: string\n  triggerData?: any\n}\n\nexport interface StepExecutionResult {\n  status: 'COMPLETED' | 'WAITING' | 'FAILED'\n  outputData?: any\n  nextSteps?: string[] // For parallel forks (Phase 7)\n  waitReason?: 'USER_TASK' | 'SIGNAL' | 'TIMER' | 'FORK'\n  error?: string\n}\n\nexport class StepExecutionError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'StepExecutionError'\n  }\n}\n\n// ============================================================================\n// Main Step Execution Functions\n// ============================================================================\n\n/**\n * Enter a workflow step - create step instance and mark as ACTIVE\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepId - Step ID to enter\n * @param context - Execution context\n * @returns Created step instance\n */\nexport async function enterStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepId: string,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepInstance> {\n  // Load workflow definition to get step details\n  const definition = await findDefinitionForInstance(em, instance)\n\n  if (!definition) {\n    throw new StepExecutionError(\n      `Workflow definition not found: ${instance.definitionId}`,\n      'DEFINITION_NOT_FOUND',\n      { definitionId: instance.definitionId }\n    )\n  }\n\n  // Find step in definition\n  const stepDef = definition.definition.steps.find((s: any) => s.stepId === stepId)\n  if (!stepDef) {\n    throw new StepExecutionError(\n      `Step not found in workflow definition: ${stepId}`,\n      'STEP_NOT_FOUND',\n      { workflowId: definition.workflowId, stepId }\n    )\n  }\n\n  const now = new Date()\n\n  // Create step instance\n  const stepInstance = em.create(StepInstance, {\n    workflowInstanceId: instance.id,\n    branchInstanceId: branch ? branch.id : null,\n    stepId: stepDef.stepId,\n    stepName: stepDef.stepName,\n    stepType: stepDef.stepType,\n    status: 'ACTIVE',\n    inputData: context.triggerData || null,\n    enteredAt: now,\n    retryCount: 0,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  await em.persist(stepInstance).flush()\n\n  // Log STEP_ENTERED event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'STEP_ENTERED',\n    eventData: {\n      stepId: stepDef.stepId,\n      stepName: stepDef.stepName,\n      stepType: stepDef.stepType,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  return stepInstance\n}\n\n/**\n * Exit a workflow step - mark as completed and record timing\n *\n * @param em - Entity manager\n * @param stepInstance - Step instance to exit\n * @param outputData - Optional output data from step execution\n */\nexport async function exitStep(\n  em: EntityManager,\n  stepInstance: StepInstance,\n  outputData?: any\n): Promise<void> {\n  const now = new Date()\n\n  // Calculate execution time if we have enteredAt\n  let executionTimeMs: number | null = null\n  if (stepInstance.enteredAt) {\n    executionTimeMs = now.getTime() - stepInstance.enteredAt.getTime()\n  }\n\n  // Update step instance\n  stepInstance.status = 'COMPLETED'\n  stepInstance.outputData = outputData || null\n  stepInstance.exitedAt = now\n  stepInstance.executionTimeMs = executionTimeMs\n  stepInstance.updatedAt = now\n\n  await em.flush()\n\n  // Log STEP_EXITED event\n  await logStepEvent(em, {\n    workflowInstanceId: stepInstance.workflowInstanceId,\n    stepInstanceId: stepInstance.id,\n    eventType: 'STEP_EXITED',\n    eventData: {\n      stepId: stepInstance.stepId,\n      status: 'COMPLETED',\n      executionTimeMs,\n      hasOutput: !!outputData,\n    },\n    tenantId: stepInstance.tenantId,\n    organizationId: stepInstance.organizationId,\n  })\n}\n\n/**\n * Execute a workflow step based on its type\n *\n * Main entry point for step execution. Handles:\n * - START: Immediate completion\n * - END: Workflow completion\n * - AUTOMATED: Activity execution (MVP: immediate completion)\n * - USER_TASK: Create user task and wait\n * - SUB_WORKFLOW: Invoke child workflow\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepId - Step ID to execute\n * @param context - Execution context\n * @param container - DI container (required for SUB_WORKFLOW steps)\n * @returns Execution result with status and output\n */\nexport async function executeStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepId: string,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  try {\n    // Enter the step (create step instance)\n    const stepInstance = await enterStep(em, instance, stepId, context, branch)\n\n    // Load workflow definition to get step configuration\n    const definition = await findDefinitionForInstance(em, instance)\n\n    if (!definition) {\n      throw new StepExecutionError(\n        `Workflow definition not found: ${instance.definitionId}`,\n        'DEFINITION_NOT_FOUND',\n        { definitionId: instance.definitionId }\n      )\n    }\n\n    const stepDef = definition.definition.steps.find((s: any) => s.stepId === stepId)\n    if (!stepDef) {\n      throw new StepExecutionError(\n        `Step not found: ${stepId}`,\n        'STEP_NOT_FOUND',\n        { stepId }\n      )\n    }\n\n    // Execute based on step type\n    const result = await executeStepByType(\n      em,\n      instance,\n      stepInstance,\n      stepDef,\n      context,\n      container,\n      branch\n    )\n\n    // If step completed, exit it\n    if (result.status === 'COMPLETED') {\n      await exitStep(em, stepInstance, result.outputData)\n    }\n\n    return result\n  } catch (error) {\n    // Handle step execution errors\n    const errorMessage = error instanceof Error ? error.message : String(error)\n\n    // Try to mark step as failed if we have a step instance\n    try {\n      const failedStepInstance = await em.findOne(StepInstance, {\n        workflowInstanceId: instance.id,\n        stepId,\n        status: 'ACTIVE',\n      })\n\n      if (failedStepInstance) {\n        failedStepInstance.status = 'FAILED'\n        failedStepInstance.errorData = {\n          error: errorMessage,\n          details: error instanceof StepExecutionError ? error.details : undefined,\n        }\n        failedStepInstance.exitedAt = new Date()\n        failedStepInstance.updatedAt = new Date()\n        await em.flush()\n\n        await logStepEvent(em, {\n          workflowInstanceId: instance.id,\n          stepInstanceId: failedStepInstance.id,\n          eventType: 'STEP_FAILED',\n          eventData: { error: errorMessage },\n          tenantId: instance.tenantId,\n          organizationId: instance.organizationId,\n        })\n      }\n    } catch (updateError) {\n      // Swallow update errors to preserve original error\n      logger.error('Failed to update step instance with error', { err: updateError })\n    }\n\n    return {\n      status: 'FAILED',\n      error: errorMessage,\n    }\n  }\n}\n\n// ============================================================================\n// Step Type Handlers\n// ============================================================================\n\n/**\n * Execute step based on its type\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepInstance - Step instance\n * @param stepDef - Step definition from workflow\n * @param context - Execution context\n * @returns Execution result\n */\nasync function executeStepByType(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const stepType: WorkflowStepType = stepDef.stepType\n\n  switch (stepType) {\n    case 'START':\n      return handleStartStep(stepDef, context)\n\n    case 'END':\n      return handleEndStep(stepDef, context)\n\n    case 'AUTOMATED':\n      return await handleAutomatedStep(em, instance, stepInstance, stepDef, context, container, branch)\n\n    case 'USER_TASK':\n      return await handleUserTaskStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'SUB_WORKFLOW':\n      if (!container) {\n        throw new StepExecutionError(\n          'Container required for SUB_WORKFLOW execution',\n          'CONTAINER_REQUIRED',\n          { stepType }\n        )\n      }\n      return await handleSubWorkflowStep(em, container, instance, stepInstance, stepDef, context)\n\n    case 'WAIT_FOR_SIGNAL':\n      return await handleWaitForSignalStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'WAIT_FOR_TIMER':\n      return await handleWaitForTimerStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'PARALLEL_FORK': {\n      // Entering a fork opens branch tokens and parks the root token in the\n      // FORKED state; the interleaved loop in the executor drives the branches.\n      if (branch) {\n        // Nested forks are rejected by definition validation; fail closed.\n        throw new StepExecutionError(\n          'Nested PARALLEL_FORK is not supported',\n          'NESTED_FORK_NOT_SUPPORTED',\n          { stepType, stepId: stepDef.stepId }\n        )\n      }\n      const definition = await findDefinitionForInstance(em, instance)\n      if (!definition) {\n        throw new StepExecutionError(\n          `Workflow definition not found: ${instance.definitionId}`,\n          'DEFINITION_NOT_FOUND',\n          { definitionId: instance.definitionId }\n        )\n      }\n      const { openFork } = await import('./parallel-handler')\n      await openFork(em, instance, definition, stepDef)\n      return { status: 'WAITING', waitReason: 'FORK', outputData: { stepType: 'PARALLEL_FORK', forkStepId: stepDef.stepId } }\n    }\n\n    case 'PARALLEL_JOIN':\n      // The join is a synchronization point handled by the parallel loop\n      // (branches are marked COMPLETED on arrival; the loop fires the join).\n      // Executing the step itself is a no-op.\n      return { status: 'COMPLETED', outputData: { stepType: 'PARALLEL_JOIN', timestamp: new Date().toISOString() } }\n\n    default:\n      throw new StepExecutionError(\n        `Unknown step type: ${stepType}`,\n        'UNKNOWN_STEP_TYPE',\n        { stepType }\n      )\n  }\n}\n\n/**\n * Handle START step - no-op, immediately complete\n */\nfunction handleStartStep(\n  stepDef: any,\n  context: StepExecutionContext\n): StepExecutionResult {\n  return {\n    status: 'COMPLETED',\n    outputData: {\n      stepType: 'START',\n      timestamp: new Date().toISOString(),\n    },\n  }\n}\n\n/**\n * Handle END step - mark as complete\n */\nfunction handleEndStep(\n  stepDef: any,\n  context: StepExecutionContext\n): StepExecutionResult {\n  return {\n    status: 'COMPLETED',\n    outputData: {\n      stepType: 'END',\n      timestamp: new Date().toISOString(),\n      finalContext: context.workflowContext,\n    },\n  }\n}\n\n/**\n * Handle AUTOMATED step - execute activities\n *\n * Executes activities defined in step configuration.\n * Supports both sync and async activities.\n */\nasync function handleAutomatedStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  // Extract activities from step definition\n  const activities = stepDef.activities || []\n\n  if (activities.length === 0) {\n    // No activities defined - immediate completion (legacy behavior)\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'AUTOMATED',\n        timestamp: new Date().toISOString(),\n      },\n    }\n  }\n\n  // Import activity executor\n  const { executeActivities } = await import('./activity-executor')\n\n  try {\n    // Execute activities with proper context\n    const results = await executeActivities(em, container, activities, {\n      workflowInstance: instance,\n      workflowContext: context.workflowContext,\n      stepContext: { stepId: stepDef.stepId, stepName: stepDef.stepName },\n      stepInstanceId: stepInstance.id,\n      userId: context.userId,\n    })\n\n    // Check if there are pending async activities\n    const pendingActivities = results.filter(r => r.async && !r.success)\n    if (pendingActivities.length > 0) {\n      // Workflow should pause and wait for async activities\n      const now = new Date()\n      if (branch) {\n        branch.status = 'WAITING_FOR_ACTIVITIES'\n        branch.updatedAt = now\n      } else {\n        instance.status = 'WAITING_FOR_ACTIVITIES'\n        instance.pausedAt = now\n        instance.updatedAt = now\n      }\n      await em.flush()\n\n      return {\n        status: 'WAITING',\n        waitReason: 'SIGNAL', // Reuse SIGNAL wait reason (will be resumed by activity completion)\n        outputData: {\n          pendingActivities: pendingActivities.map(r => ({\n            activityId: r.activityId,\n            activityName: r.activityName,\n            jobId: r.jobId,\n          })),\n        },\n      }\n    }\n\n    // Check for failures in sync activities\n    const failures = results.filter(r => !r.success && !r.async)\n    if (failures.length > 0) {\n      const errorMessages = failures.map(f => `${f.activityName || f.activityId}: ${f.error}`).join('; ')\n      return {\n        status: 'FAILED',\n        error: `${failures.length} activity(ies) failed: ${errorMessages}`,\n        outputData: {\n          failures: failures.map(f => ({\n            activityId: f.activityId,\n            activityName: f.activityName,\n            error: f.error,\n            retryCount: f.retryCount,\n          })),\n        },\n      }\n    }\n\n    // All activities completed successfully\n    const activityOutputs = results.reduce((acc, r) => {\n      if (r.output) {\n        acc[r.activityId] = r.output\n      }\n      return acc\n    }, {} as Record<string, any>)\n\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'AUTOMATED',\n        timestamp: new Date().toISOString(),\n        activityResults: activityOutputs,\n        activityCount: results.length,\n      },\n    }\n  } catch (error: any) {\n    return {\n      status: 'FAILED',\n      error: `Activity execution failed: ${error.message}`,\n    }\n  }\n}\n\n/**\n * Handle USER_TASK step - create user task and enter waiting state\n *\n * Creates a UserTask entity and returns WAITING status.\n * The workflow will pause until the task is completed by a user.\n */\nasync function handleUserTaskStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const userTaskConfig = stepDef.userTaskConfig || {}\n\n  // Handle assignedTo - if it's an array, treat it as roles\n  let assignedTo = userTaskConfig.assignedTo || null\n  let assignedToRoles = userTaskConfig.assignedToRoles || null\n\n  if (Array.isArray(assignedTo)) {\n    assignedToRoles = assignedTo\n    assignedTo = null\n  }\n\n  // Create user task\n  const now = new Date()\n  const userTask = em.create(UserTask, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    branchInstanceId: branch ? branch.id : null,\n    taskName: stepDef.stepName,\n    description: stepDef.description || null,\n    status: 'PENDING',\n    formSchema: userTaskConfig.formSchema || null,\n    formData: null,\n    assignedTo: assignedTo,\n    assignedToRoles: assignedToRoles,\n    dueDate: userTaskConfig.slaDuration ? calculateDueDate(userTaskConfig.slaDuration) : null,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  await em.persist(userTask).flush()\n\n  // Log USER_TASK_CREATED event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'USER_TASK_CREATED',\n    eventData: {\n      userTaskId: userTask.id,\n      taskName: userTask.taskName,\n      assignedTo: userTask.assignedTo,\n      assignedToRoles: userTask.assignedToRoles,\n    },\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Pause execution - waits for user task completion. For a branch, only the\n  // branch pauses; sibling branches keep running.\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  return {\n    status: 'WAITING',\n    waitReason: 'USER_TASK',\n    outputData: {\n      userTaskId: userTask.id,\n    },\n  }\n}\n\n/**\n * Handle SUB_WORKFLOW step - invoke another workflow and wait for completion\n *\n * Creates a child workflow instance with mapped input data,\n * executes it synchronously, and returns mapped output data.\n */\nasync function handleSubWorkflowStep(\n  em: EntityManager,\n  container: any,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext\n): Promise<StepExecutionResult> {\n  const { subWorkflowId, inputMapping, outputMapping, version } = stepDef.config || {}\n\n  if (!subWorkflowId) {\n    return {\n      status: 'FAILED',\n      error: 'Sub-workflow ID not specified in step configuration'\n    }\n  }\n\n  // Map input data from parent context to child context\n  const childContext = mapInputData(instance.context, inputMapping || {})\n\n  // Import workflow executor functions\n  const { startWorkflow, executeWorkflow } = await import('./workflow-executor')\n\n  try {\n    // Start child workflow with parent metadata\n    const childInstance = await startWorkflow(em, {\n      workflowId: subWorkflowId,\n      version,\n      initialContext: childContext,\n      correlationKey: instance.correlationKey || undefined,\n      metadata: {\n        ...instance.metadata,\n        labels: {\n          ...instance.metadata?.labels,\n          parentInstanceId: instance.id,\n          parentStepId: stepDef.stepId,\n          parentStepInstanceId: stepInstance.id,\n        },\n      },\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    // Log sub-workflow invocation event\n    await logStepEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: stepInstance.id,\n      eventType: 'SUB_WORKFLOW_STARTED',\n      eventData: {\n        childInstanceId: childInstance.id,\n        subWorkflowId,\n        version,\n        inputData: childContext,\n      },\n      userId: context.userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    // Execute child workflow synchronously\n    const result = await executeWorkflow(em, container, childInstance.id, {\n      userId: context.userId,\n    })\n\n    // Handle child workflow result\n    if (result.status === 'COMPLETED') {\n      // Map output data from child context to parent context\n      const outputData = mapOutputData(result.context, outputMapping || {})\n\n      await logStepEvent(em, {\n        workflowInstanceId: instance.id,\n        stepInstanceId: stepInstance.id,\n        eventType: 'SUB_WORKFLOW_COMPLETED',\n        eventData: {\n          childInstanceId: childInstance.id,\n          outputData,\n        },\n        userId: context.userId,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return {\n        status: 'COMPLETED',\n        outputData,\n      }\n    } else if (result.status === 'FAILED') {\n      await logStepEvent(em, {\n        workflowInstanceId: instance.id,\n        stepInstanceId: stepInstance.id,\n        eventType: 'SUB_WORKFLOW_FAILED',\n        eventData: {\n          childInstanceId: childInstance.id,\n          error: result.errors?.join(', '),\n        },\n        userId: context.userId,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return {\n        status: 'FAILED',\n        error: `Sub-workflow failed: ${result.errors?.join(', ')}`,\n      }\n    } else {\n      // WAITING, PAUSED, etc. - For synchronous execution, treat as error\n      return {\n        status: 'FAILED',\n        error: `Sub-workflow ended in unexpected state: ${result.status}`,\n      }\n    }\n  } catch (error: any) {\n    await logStepEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: stepInstance.id,\n      eventType: 'SUB_WORKFLOW_FAILED',\n      eventData: {\n        subWorkflowId,\n        error: error.message,\n      },\n      userId: context.userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    return {\n      status: 'FAILED',\n      error: `Sub-workflow execution failed: ${error.message}`,\n    }\n  }\n}\n\n/**\n * Handle WAIT_FOR_SIGNAL step - pause workflow until signal received\n *\n * Creates a waiting state and pauses the workflow until an external signal\n * with the matching signal name is received. The signal payload will be merged\n * into the workflow context when received.\n */\nasync function handleWaitForSignalStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const signalConfig = stepDef.signalConfig || {}\n  const signalName = signalConfig.signalName || stepDef.stepId\n  const timeout = signalConfig.timeout ? parseDuration(signalConfig.timeout) : null\n\n  const now = new Date()\n\n  // Log signal awaiting event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'SIGNAL_AWAITING',\n    eventData: {\n      signalName,\n      timeout,\n      description: stepDef.description,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Pause execution (branch-scoped when running inside a parallel branch)\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.pausedAt = now\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  // Return WAITING status to halt executor\n  return {\n    status: 'WAITING',\n    waitReason: 'SIGNAL',\n    outputData: {\n      signalName,\n      timeout,\n      awaitingSince: now,\n    },\n  }\n}\n\n/**\n * Handle WAIT_FOR_TIMER step - pause workflow until a timer fires.\n *\n * Reads `duration` (relative, e.g. \"PT5M\") or `until` (ISO 8601 datetime) from\n * `stepDef.config` (preferred \u2014 matches StepsEditor) or `stepDef.timerConfig`.\n * Enqueues a delayed timer job on the workflow-activities queue; when the job\n * is processed by the activity worker, it calls `timerHandler.fireTimer` to\n * resume the workflow.\n */\nasync function handleWaitForTimerStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const timerConfig = stepDef.config || stepDef.timerConfig || {}\n  const duration: string | undefined = timerConfig.duration\n  const until: string | undefined = timerConfig.until\n\n  if (!duration && !until) {\n    throw new StepExecutionError(\n      'WAIT_FOR_TIMER requires either \"duration\" (e.g., \"PT5M\") or \"until\" (ISO 8601 datetime)',\n      'TIMER_CONFIG_MISSING',\n      { stepId: stepDef.stepId }\n    )\n  }\n\n  let fireAtMs: number\n  if (until) {\n    const targetDate = new Date(until)\n    if (isNaN(targetDate.getTime())) {\n      throw new StepExecutionError(\n        `WAIT_FOR_TIMER invalid \"until\" datetime: ${until}`,\n        'TIMER_CONFIG_INVALID',\n        { until }\n      )\n    }\n    fireAtMs = targetDate.getTime()\n  } else {\n    fireAtMs = Date.now() + parseDuration(duration as string)\n  }\n\n  const delayMs = fireAtMs - Date.now()\n  const fireAt = new Date(fireAtMs)\n\n  // Immediate-fire path: skip the queue round-trip if the timer is in the past\n  if (delayMs <= 0) {\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'WAIT_FOR_TIMER',\n        timerFiredImmediately: true,\n        fireAt,\n        duration,\n        until,\n      },\n    }\n  }\n\n  const now = new Date()\n\n  // Enqueue delayed timer job via the shared activity queue.\n  // Imported here to avoid a top-level cycle between step-handler and activity-executor.\n  const { enqueueTimerJob } = await import('./activity-executor')\n  const jobId = await enqueueTimerJob({\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    branchInstanceId: branch ? branch.id : undefined,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    userId: context.userId,\n    fireAt: fireAt.toISOString(),\n    delayMs,\n  })\n\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'TIMER_AWAITING',\n    eventData: {\n      fireAt: fireAt.toISOString(),\n      duration: duration || null,\n      until: until || null,\n      jobId,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.pausedAt = now\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  return {\n    status: 'WAITING',\n    waitReason: 'TIMER',\n    outputData: {\n      fireAt,\n      duration,\n      until,\n      jobId,\n    },\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n// parseDuration is imported from ./duration\n\n/**\n * Log step-related event to event sourcing table\n */\nasync function logStepEvent(\n  em: EntityManager,\n  event: {\n    workflowInstanceId: string\n    stepInstanceId: string\n    branchInstanceId?: string | null\n    eventType: string\n    eventData: any\n    userId?: string\n    tenantId: string\n    organizationId: string\n  }\n): Promise<WorkflowEvent> {\n  const workflowEvent = em.create(WorkflowEvent, {\n    ...event,\n    occurredAt: new Date(),\n  })\n\n  await em.persist(workflowEvent).flush()\n  return workflowEvent\n}\n\n/**\n * Calculate due date from ISO 8601 duration string\n *\n * @param duration - ISO 8601 duration (e.g., \"P1D\" for 1 day)\n * @returns Due date\n */\nfunction calculateDueDate(duration: string): Date {\n  // Simple implementation for MVP\n  // Supports: P1D (1 day), P1H (1 hour), P1W (1 week)\n  const now = new Date()\n\n  const daysMatch = duration.match(/P(\\d+)D/)\n  if (daysMatch) {\n    const days = parseInt(daysMatch[1], 10)\n    return new Date(now.getTime() + days * 24 * 60 * 60 * 1000)\n  }\n\n  const hoursMatch = duration.match(/PT(\\d+)H/)\n  if (hoursMatch) {\n    const hours = parseInt(hoursMatch[1], 10)\n    return new Date(now.getTime() + hours * 60 * 60 * 1000)\n  }\n\n  const weeksMatch = duration.match(/P(\\d+)W/)\n  if (weeksMatch) {\n    const weeks = parseInt(weeksMatch[1], 10)\n    return new Date(now.getTime() + weeks * 7 * 24 * 60 * 60 * 1000)\n  }\n\n  // Default: 1 day\n  return new Date(now.getTime() + 24 * 60 * 60 * 1000)\n}\n\n/**\n * Get nested value from object using dot notation\n *\n * @param obj - Source object\n * @param path - Dot-notation path (e.g., \"user.email\")\n * @returns Value at path or undefined\n */\nfunction getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current, key) => current?.[key], obj)\n}\n\n/**\n * Set nested value in object using dot notation\n *\n * @param obj - Target object\n * @param path - Dot-notation path (e.g., \"user.email\")\n * @param value - Value to set\n */\nfunction setNestedValue(obj: any, path: string, value: any): void {\n  const keys = path.split('.')\n  const lastKey = keys.pop()!\n  const target = keys.reduce((current, key) => {\n    if (!(key in current)) current[key] = {}\n    return current[key]\n  }, obj)\n  target[lastKey] = value\n}\n\n/**\n * Map data from source context using mapping configuration\n *\n * @param sourceContext - Source data object\n * @param mapping - Mapping configuration (targetKey -> sourcePath)\n * @returns Mapped data object\n */\nfunction mapInputData(\n  sourceContext: Record<string, any>,\n  mapping: Record<string, string>\n): Record<string, any> {\n  const result: Record<string, any> = {}\n\n  for (const [targetKey, sourcePath] of Object.entries(mapping)) {\n    const value = getNestedValue(sourceContext, sourcePath)\n    if (value !== undefined) {\n      setNestedValue(result, targetKey, value)\n    }\n  }\n\n  // If no mapping provided, pass entire context\n  return Object.keys(result).length > 0 ? result : sourceContext\n}\n\n/**\n * Map output data from child context back to parent\n *\n * @param childContext - Child workflow context\n * @param mapping - Mapping configuration (targetKey -> sourcePath)\n * @returns Mapped output data\n */\nfunction mapOutputData(\n  childContext: Record<string, any>,\n  mapping: Record<string, string>\n): Record<string, any> {\n  const result: Record<string, any> = {}\n\n  for (const [targetKey, sourcePath] of Object.entries(mapping)) {\n    const value = getNestedValue(childContext, sourcePath)\n    if (value !== undefined) {\n      setNestedValue(result, targetKey, value)\n    }\n  }\n\n  // If no mapping provided, pass entire child context\n  return Object.keys(result).length > 0 ? result : childContext\n}\n"],
-  "mappings": "AAYA;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,qBAAqB;AAC9B,SAAS,wBAAwB;AACjC,SAAS,iCAAiC;AAC1C,SAAS,oBAAoB;AAE7B,MAAM,SAAS,aAAa,WAAW;AAoBhC,MAAM,2BAA2B,MAAM;AAAA,EAC5C,YACE,SACO,MACA,SACP;AACA,UAAM,OAAO;AAHN;AACA;AAGP,SAAK,OAAO;AAAA,EACd;AACF;AAeA,eAAsB,UACpB,IACA,UACA,QACA,SACA,QACuB;AAEvB,QAAM,aAAa,MAAM,0BAA0B,IAAI,QAAQ;AAE/D,MAAI,CAAC,YAAY;AACf,UAAM,IAAI;AAAA,MACR,kCAAkC,SAAS,YAAY;AAAA,MACvD;AAAA,MACA,EAAE,cAAc,SAAS,aAAa;AAAA,IACxC;AAAA,EACF;AAGA,QAAM,UAAU,WAAW,WAAW,MAAM,KAAK,CAAC,MAAW,EAAE,WAAW,MAAM;AAChF,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR,0CAA0C,MAAM;AAAA,MAChD;AAAA,MACA,EAAE,YAAY,WAAW,YAAY,OAAO;AAAA,IAC9C;AAAA,EACF;AAEA,QAAM,MAAM,oBAAI,KAAK;AAGrB,QAAM,eAAe,GAAG,OAAO,cAAc;AAAA,IAC3C,oBAAoB,SAAS;AAAA,IAC7B,kBAAkB,SAAS,OAAO,KAAK;AAAA,IACvC,QAAQ,QAAQ;AAAA,IAChB,UAAU,QAAQ;AAAA,IAClB,UAAU,QAAQ;AAAA,IAClB,QAAQ;AAAA,IACR,WAAW,QAAQ,eAAe;AAAA,IAClC,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,UAAU,SAAS;AAAA,IACnB,gBAAgB,SAAS;AAAA,IACzB,WAAW;AAAA,IACX,WAAW;AAAA,EACb,CAAC;AAED,QAAM,GAAG,QAAQ,YAAY,EAAE,MAAM;AAGrC,QAAM,aAAa,IAAI;AAAA,IACrB,oBAAoB,SAAS;AAAA,IAC7B,gBAAgB,aAAa;AAAA,IAC7B,GAAI,SAAS,EAAE,kBAAkB,OAAO,GAAG,IAAI,CAAC;AAAA,IAChD,WAAW;AAAA,IACX,WAAW;AAAA,MACT,QAAQ,QAAQ;AAAA,MAChB,UAAU,QAAQ;AAAA,MAClB,UAAU,QAAQ;AAAA,IACpB;AAAA,IACA,QAAQ,QAAQ;AAAA,IAChB,UAAU,SAAS;AAAA,IACnB,gBAAgB,SAAS;AAAA,EAC3B,CAAC;AAED,SAAO;AACT;AASA,eAAsB,SACpB,IACA,cACA,YACe;AACf,QAAM,MAAM,oBAAI,KAAK;AAGrB,MAAI,kBAAiC;AACrC,MAAI,aAAa,WAAW;AAC1B,sBAAkB,IAAI,QAAQ,IAAI,aAAa,UAAU,QAAQ;AAAA,EACnE;AAGA,eAAa,SAAS;AACtB,eAAa,aAAa,cAAc;AACxC,eAAa,WAAW;AACxB,eAAa,kBAAkB;AAC/B,eAAa,YAAY;AAEzB,QAAM,GAAG,MAAM;AAGf,QAAM,aAAa,IAAI;AAAA,IACrB,oBAAoB,aAAa;AAAA,IACjC,gBAAgB,aAAa;AAAA,IAC7B,WAAW;AAAA,IACX,WAAW;AAAA,MACT,QAAQ,aAAa;AAAA,MACrB,QAAQ;AAAA,MACR;AAAA,MACA,WAAW,CAAC,CAAC;AAAA,IACf;AAAA,IACA,UAAU,aAAa;AAAA,IACvB,gBAAgB,aAAa;AAAA,EAC/B,CAAC;AACH;AAmBA,eAAsB,YACpB,IACA,UACA,QACA,SACA,WACA,QAC8B;AAC9B,MAAI;AAEF,UAAM,eAAe,MAAM,UAAU,IAAI,UAAU,QAAQ,SAAS,MAAM;AAG1E,UAAM,aAAa,MAAM,0BAA0B,IAAI,QAAQ;AAE/D,QAAI,CAAC,YAAY;AACf,YAAM,IAAI;AAAA,QACR,kCAAkC,SAAS,YAAY;AAAA,QACvD;AAAA,QACA,EAAE,cAAc,SAAS,aAAa;AAAA,MACxC;AAAA,IACF;AAEA,UAAM,UAAU,WAAW,WAAW,MAAM,KAAK,CAAC,MAAW,EAAE,WAAW,MAAM;AAChF,QAAI,CAAC,SAAS;AACZ,YAAM,IAAI;AAAA,QACR,mBAAmB,MAAM;AAAA,QACzB;AAAA,QACA,EAAE,OAAO;AAAA,MACX;AAAA,IACF;AAGA,UAAM,SAAS,MAAM;AAAA,MACnB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAGA,QAAI,OAAO,WAAW,aAAa;AACjC,YAAM,SAAS,IAAI,cAAc,OAAO,UAAU;AAAA,IACpD;AAEA,WAAO;AAAA,EACT,SAAS,OAAO;AAEd,UAAM,eAAe,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAG1E,QAAI;AACF,YAAM,qBAAqB,MAAM,GAAG,QAAQ,cAAc;AAAA,QACxD,oBAAoB,SAAS;AAAA,QAC7B;AAAA,QACA,QAAQ;AAAA,MACV,CAAC;AAED,UAAI,oBAAoB;AACtB,2BAAmB,SAAS;AAC5B,2BAAmB,YAAY;AAAA,UAC7B,OAAO;AAAA,UACP,SAAS,iBAAiB,qBAAqB,MAAM,UAAU;AAAA,QACjE;AACA,2BAAmB,WAAW,oBAAI,KAAK;AACvC,2BAAmB,YAAY,oBAAI,KAAK;AACxC,cAAM,GAAG,MAAM;AAEf,cAAM,aAAa,IAAI;AAAA,UACrB,oBAAoB,SAAS;AAAA,UAC7B,gBAAgB,mBAAmB;AAAA,UACnC,WAAW;AAAA,UACX,WAAW,EAAE,OAAO,aAAa;AAAA,UACjC,UAAU,SAAS;AAAA,UACnB,gBAAgB,SAAS;AAAA,QAC3B,CAAC;AAAA,MACH;AAAA,IACF,SAAS,aAAa;AAEpB,aAAO,MAAM,6CAA6C,EAAE,KAAK,YAAY,CAAC;AAAA,IAChF;AAEA,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO;AAAA,IACT;AAAA,EACF;AACF;AAgBA,eAAe,kBACb,IACA,UACA,cACA,SACA,SACA,WACA,QAC8B;AAC9B,QAAM,WAA6B,QAAQ;AAE3C,UAAQ,UAAU;AAAA,IAChB,KAAK;AACH,aAAO,gBAAgB,SAAS,OAAO;AAAA,IAEzC,KAAK;AACH,aAAO,cAAc,SAAS,OAAO;AAAA,IAEvC,KAAK;AACH,aAAO,MAAM,oBAAoB,IAAI,UAAU,cAAc,SAAS,SAAS,WAAW,MAAM;AAAA,IAElG,KAAK;AACH,aAAO,MAAM,mBAAmB,IAAI,UAAU,cAAc,SAAS,SAAS,MAAM;AAAA,IAEtF,KAAK;AACH,UAAI,CAAC,WAAW;AACd,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,UACA,EAAE,SAAS;AAAA,QACb;AAAA,MACF;AACA,aAAO,MAAM,sBAAsB,IAAI,WAAW,UAAU,cAAc,SAAS,OAAO;AAAA,IAE5F,KAAK;AACH,aAAO,MAAM,wBAAwB,IAAI,UAAU,cAAc,SAAS,SAAS,MAAM;AAAA,IAE3F,KAAK;AACH,aAAO,MAAM,uBAAuB,IAAI,UAAU,cAAc,SAAS,SAAS,MAAM;AAAA,IAE1F,KAAK,iBAAiB;AAGpB,UAAI,QAAQ;AAEV,cAAM,IAAI;AAAA,UACR;AAAA,UACA;AAAA,UACA,EAAE,UAAU,QAAQ,QAAQ,OAAO;AAAA,QACrC;AAAA,MACF;AACA,YAAM,aAAa,MAAM,0BAA0B,IAAI,QAAQ;AAC/D,UAAI,CAAC,YAAY;AACf,cAAM,IAAI;AAAA,UACR,kCAAkC,SAAS,YAAY;AAAA,UACvD;AAAA,UACA,EAAE,cAAc,SAAS,aAAa;AAAA,QACxC;AAAA,MACF;AACA,YAAM,EAAE,SAAS,IAAI,MAAM,OAAO,oBAAoB;AACtD,YAAM,SAAS,IAAI,UAAU,YAAY,OAAO;AAChD,aAAO,EAAE,QAAQ,WAAW,YAAY,QAAQ,YAAY,EAAE,UAAU,iBAAiB,YAAY,QAAQ,OAAO,EAAE;AAAA,IACxH;AAAA,IAEA,KAAK;AAIH,aAAO,EAAE,QAAQ,aAAa,YAAY,EAAE,UAAU,iBAAiB,YAAW,oBAAI,KAAK,GAAE,YAAY,EAAE,EAAE;AAAA,IAE/G;AACE,YAAM,IAAI;AAAA,QACR,sBAAsB,QAAQ;AAAA,QAC9B;AAAA,QACA,EAAE,SAAS;AAAA,MACb;AAAA,EACJ;AACF;AAKA,SAAS,gBACP,SACA,SACqB;AACrB,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,YAAY;AAAA,MACV,UAAU;AAAA,MACV,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC;AAAA,EACF;AACF;AAKA,SAAS,cACP,SACA,SACqB;AACrB,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,YAAY;AAAA,MACV,UAAU;AAAA,MACV,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC,cAAc,QAAQ;AAAA,IACxB;AAAA,EACF;AACF;AAQA,eAAe,oBACb,IACA,UACA,cACA,SACA,SACA,WACA,QAC8B;AAE9B,QAAM,aAAa,QAAQ,cAAc,CAAC;AAE1C,MAAI,WAAW,WAAW,GAAG;AAE3B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,YAAY;AAAA,QACV,UAAU;AAAA,QACV,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAGA,QAAM,EAAE,kBAAkB,IAAI,MAAM,OAAO,qBAAqB;AAEhE,MAAI;AAEF,UAAM,UAAU,MAAM,kBAAkB,IAAI,WAAW,YAAY;AAAA,MACjE,kBAAkB;AAAA,MAClB,iBAAiB,QAAQ;AAAA,MACzB,aAAa,EAAE,QAAQ,QAAQ,QAAQ,UAAU,QAAQ,SAAS;AAAA,MAClE,gBAAgB,aAAa;AAAA,MAC7B,QAAQ,QAAQ;AAAA,IAClB,CAAC;AAGD,UAAM,oBAAoB,QAAQ,OAAO,OAAK,EAAE,SAAS,CAAC,EAAE,OAAO;AACnE,QAAI,kBAAkB,SAAS,GAAG;AAEhC,YAAM,MAAM,oBAAI,KAAK;AACrB,UAAI,QAAQ;AACV,eAAO,SAAS;AAChB,eAAO,YAAY;AAAA,MACrB,OAAO;AACL,iBAAS,SAAS;AAClB,iBAAS,WAAW;AACpB,iBAAS,YAAY;AAAA,MACvB;AACA,YAAM,GAAG,MAAM;AAEf,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,YAAY;AAAA;AAAA,QACZ,YAAY;AAAA,UACV,mBAAmB,kBAAkB,IAAI,QAAM;AAAA,YAC7C,YAAY,EAAE;AAAA,YACd,cAAc,EAAE;AAAA,YAChB,OAAO,EAAE;AAAA,UACX,EAAE;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AAGA,UAAM,WAAW,QAAQ,OAAO,OAAK,CAAC,EAAE,WAAW,CAAC,EAAE,KAAK;AAC3D,QAAI,SAAS,SAAS,GAAG;AACvB,YAAM,gBAAgB,SAAS,IAAI,OAAK,GAAG,EAAE,gBAAgB,EAAE,UAAU,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,IAAI;AAClG,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,OAAO,GAAG,SAAS,MAAM,0BAA0B,aAAa;AAAA,QAChE,YAAY;AAAA,UACV,UAAU,SAAS,IAAI,QAAM;AAAA,YAC3B,YAAY,EAAE;AAAA,YACd,cAAc,EAAE;AAAA,YAChB,OAAO,EAAE;AAAA,YACT,YAAY,EAAE;AAAA,UAChB,EAAE;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AAGA,UAAM,kBAAkB,QAAQ,OAAO,CAAC,KAAK,MAAM;AACjD,UAAI,EAAE,QAAQ;AACZ,YAAI,EAAE,UAAU,IAAI,EAAE;AAAA,MACxB;AACA,aAAO;AAAA,IACT,GAAG,CAAC,CAAwB;AAE5B,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,YAAY;AAAA,QACV,UAAU;AAAA,QACV,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,QAClC,iBAAiB;AAAA,QACjB,eAAe,QAAQ;AAAA,MACzB;AAAA,IACF;AAAA,EACF,SAAS,OAAY;AACnB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO,8BAA8B,MAAM,OAAO;AAAA,IACpD;AAAA,EACF;AACF;AAQA,eAAe,mBACb,IACA,UACA,cACA,SACA,SACA,QAC8B;AAC9B,QAAM,iBAAiB,QAAQ,kBAAkB,CAAC;AAGlD,MAAI,aAAa,eAAe,cAAc;AAC9C,MAAI,kBAAkB,eAAe,mBAAmB;AAExD,MAAI,MAAM,QAAQ,UAAU,GAAG;AAC7B,sBAAkB;AAClB,iBAAa;AAAA,EACf;AAGA,QAAM,MAAM,oBAAI,KAAK;AACrB,QAAM,WAAW,GAAG,OAAO,UAAU;AAAA,IACnC,oBAAoB,SAAS;AAAA,IAC7B,gBAAgB,aAAa;AAAA,IAC7B,kBAAkB,SAAS,OAAO,KAAK;AAAA,IACvC,UAAU,QAAQ;AAAA,IAClB,aAAa,QAAQ,eAAe;AAAA,IACpC,QAAQ;AAAA,IACR,YAAY,eAAe,cAAc;AAAA,IACzC,UAAU;AAAA,IACV;AAAA,IACA;AAAA,IACA,SAAS,eAAe,cAAc,iBAAiB,eAAe,WAAW,IAAI;AAAA,IACrF,UAAU,SAAS;AAAA,IACnB,gBAAgB,SAAS;AAAA,IACzB,WAAW;AAAA,IACX,WAAW;AAAA,EACb,CAAC;AAED,QAAM,GAAG,QAAQ,QAAQ,EAAE,MAAM;AAGjC,QAAM,aAAa,IAAI;AAAA,IACrB,oBAAoB,SAAS;AAAA,IAC7B,gBAAgB,aAAa;AAAA,IAC7B,GAAI,SAAS,EAAE,kBAAkB,OAAO,GAAG,IAAI,CAAC;AAAA,IAChD,WAAW;AAAA,IACX,WAAW;AAAA,MACT,YAAY,SAAS;AAAA,MACrB,UAAU,SAAS;AAAA,MACnB,YAAY,SAAS;AAAA,MACrB,iBAAiB,SAAS;AAAA,IAC5B;AAAA,IACA,UAAU,SAAS;AAAA,IACnB,gBAAgB,SAAS;AAAA,EAC3B,CAAC;AAID,MAAI,QAAQ;AACV,WAAO,SAAS;AAChB,WAAO,YAAY;AAAA,EACrB,OAAO;AACL,aAAS,SAAS;AAClB,aAAS,YAAY;AAAA,EACvB;AACA,QAAM,GAAG,MAAM;AAEf,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,YAAY;AAAA,MACV,YAAY,SAAS;AAAA,IACvB;AAAA,EACF;AACF;AAQA,eAAe,sBACb,IACA,WACA,UACA,cACA,SACA,SAC8B;AAC9B,QAAM,EAAE,eAAe,cAAc,eAAe,QAAQ,IAAI,QAAQ,UAAU,CAAC;AAEnF,MAAI,CAAC,eAAe;AAClB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO;AAAA,IACT;AAAA,EACF;AAGA,QAAM,eAAe,aAAa,SAAS,SAAS,gBAAgB,CAAC,CAAC;AAGtE,QAAM,EAAE,eAAe,gBAAgB,IAAI,MAAM,OAAO,qBAAqB;AAE7E,MAAI;AAEF,UAAM,gBAAgB,MAAM,cAAc,IAAI;AAAA,MAC5C,YAAY;AAAA,MACZ;AAAA,MACA,gBAAgB;AAAA,MAChB,gBAAgB,SAAS,kBAAkB;AAAA,MAC3C,UAAU;AAAA,QACR,GAAG,SAAS;AAAA,QACZ,QAAQ;AAAA,UACN,GAAG,SAAS,UAAU;AAAA,UACtB,kBAAkB,SAAS;AAAA,UAC3B,cAAc,QAAQ;AAAA,UACtB,sBAAsB,aAAa;AAAA,QACrC;AAAA,MACF;AAAA,MACA,UAAU,SAAS;AAAA,MACnB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AAGD,UAAM,aAAa,IAAI;AAAA,MACrB,oBAAoB,SAAS;AAAA,MAC7B,gBAAgB,aAAa;AAAA,MAC7B,WAAW;AAAA,MACX,WAAW;AAAA,QACT,iBAAiB,cAAc;AAAA,QAC/B;AAAA,QACA;AAAA,QACA,WAAW;AAAA,MACb;AAAA,MACA,QAAQ,QAAQ;AAAA,MAChB,UAAU,SAAS;AAAA,MACnB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AAGD,UAAM,SAAS,MAAM,gBAAgB,IAAI,WAAW,cAAc,IAAI;AAAA,MACpE,QAAQ,QAAQ;AAAA,IAClB,CAAC;AAGD,QAAI,OAAO,WAAW,aAAa;AAEjC,YAAM,aAAa,cAAc,OAAO,SAAS,iBAAiB,CAAC,CAAC;AAEpE,YAAM,aAAa,IAAI;AAAA,QACrB,oBAAoB,SAAS;AAAA,QAC7B,gBAAgB,aAAa;AAAA,QAC7B,WAAW;AAAA,QACX,WAAW;AAAA,UACT,iBAAiB,cAAc;AAAA,UAC/B;AAAA,QACF;AAAA,QACA,QAAQ,QAAQ;AAAA,QAChB,UAAU,SAAS;AAAA,QACnB,gBAAgB,SAAS;AAAA,MAC3B,CAAC;AAED,aAAO;AAAA,QACL,QAAQ;AAAA,QACR;AAAA,MACF;AAAA,IACF,WAAW,OAAO,WAAW,UAAU;AACrC,YAAM,aAAa,IAAI;AAAA,QACrB,oBAAoB,SAAS;AAAA,QAC7B,gBAAgB,aAAa;AAAA,QAC7B,WAAW;AAAA,QACX,WAAW;AAAA,UACT,iBAAiB,cAAc;AAAA,UAC/B,OAAO,OAAO,QAAQ,KAAK,IAAI;AAAA,QACjC;AAAA,QACA,QAAQ,QAAQ;AAAA,QAChB,UAAU,SAAS;AAAA,QACnB,gBAAgB,SAAS;AAAA,MAC3B,CAAC;AAED,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,OAAO,wBAAwB,OAAO,QAAQ,KAAK,IAAI,CAAC;AAAA,MAC1D;AAAA,IACF,OAAO;AAEL,aAAO;AAAA,QACL,QAAQ;AAAA,QACR,OAAO,2CAA2C,OAAO,MAAM;AAAA,MACjE;AAAA,IACF;AAAA,EACF,SAAS,OAAY;AACnB,UAAM,aAAa,IAAI;AAAA,MACrB,oBAAoB,SAAS;AAAA,MAC7B,gBAAgB,aAAa;AAAA,MAC7B,WAAW;AAAA,MACX,WAAW;AAAA,QACT;AAAA,QACA,OAAO,MAAM;AAAA,MACf;AAAA,MACA,QAAQ,QAAQ;AAAA,MAChB,UAAU,SAAS;AAAA,MACnB,gBAAgB,SAAS;AAAA,IAC3B,CAAC;AAED,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,OAAO,kCAAkC,MAAM,OAAO;AAAA,IACxD;AAAA,EACF;AACF;AASA,eAAe,wBACb,IACA,UACA,cACA,SACA,SACA,QAC8B;AAC9B,QAAM,eAAe,QAAQ,gBAAgB,CAAC;AAC9C,QAAM,aAAa,aAAa,cAAc,QAAQ;AACtD,QAAM,UAAU,aAAa,UAAU,cAAc,aAAa,OAAO,IAAI;AAE7E,QAAM,MAAM,oBAAI,KAAK;AAGrB,QAAM,aAAa,IAAI;AAAA,IACrB,oBAAoB,SAAS;AAAA,IAC7B,gBAAgB,aAAa;AAAA,IAC7B,GAAI,SAAS,EAAE,kBAAkB,OAAO,GAAG,IAAI,CAAC;AAAA,IAChD,WAAW;AAAA,IACX,WAAW;AAAA,MACT;AAAA,MACA;AAAA,MACA,aAAa,QAAQ;AAAA,IACvB;AAAA,IACA,QAAQ,QAAQ;AAAA,IAChB,UAAU,SAAS;AAAA,IACnB,gBAAgB,SAAS;AAAA,EAC3B,CAAC;AAGD,MAAI,QAAQ;AACV,WAAO,SAAS;AAChB,WAAO,YAAY;AAAA,EACrB,OAAO;AACL,aAAS,SAAS;AAClB,aAAS,WAAW;AACpB,aAAS,YAAY;AAAA,EACvB;AACA,QAAM,GAAG,MAAM;AAGf,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,YAAY;AAAA,MACV;AAAA,MACA;AAAA,MACA,eAAe;AAAA,IACjB;AAAA,EACF;AACF;AAWA,eAAe,uBACb,IACA,UACA,cACA,SACA,SACA,QAC8B;AAC9B,QAAM,cAAc,QAAQ,UAAU,QAAQ,eAAe,CAAC;AAC9D,QAAM,WAA+B,YAAY;AACjD,QAAM,QAA4B,YAAY;AAE9C,MAAI,CAAC,YAAY,CAAC,OAAO;AACvB,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,MACA,EAAE,QAAQ,QAAQ,OAAO;AAAA,IAC3B;AAAA,EACF;AAEA,MAAI;AACJ,MAAI,OAAO;AACT,UAAM,aAAa,IAAI,KAAK,KAAK;AACjC,QAAI,MAAM,WAAW,QAAQ,CAAC,GAAG;AAC/B,YAAM,IAAI;AAAA,QACR,4CAA4C,KAAK;AAAA,QACjD;AAAA,QACA,EAAE,MAAM;AAAA,MACV;AAAA,IACF;AACA,eAAW,WAAW,QAAQ;AAAA,EAChC,OAAO;AACL,eAAW,KAAK,IAAI,IAAI,cAAc,QAAkB;AAAA,EAC1D;AAEA,QAAM,UAAU,WAAW,KAAK,IAAI;AACpC,QAAM,SAAS,IAAI,KAAK,QAAQ;AAGhC,MAAI,WAAW,GAAG;AAChB,WAAO;AAAA,MACL,QAAQ;AAAA,MACR,YAAY;AAAA,QACV,UAAU;AAAA,QACV,uBAAuB;AAAA,QACvB;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,QAAM,MAAM,oBAAI,KAAK;AAIrB,QAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,qBAAqB;AAC9D,QAAM,QAAQ,MAAM,gBAAgB;AAAA,IAClC,oBAAoB,SAAS;AAAA,IAC7B,gBAAgB,aAAa;AAAA,IAC7B,kBAAkB,SAAS,OAAO,KAAK;AAAA,IACvC,UAAU,SAAS;AAAA,IACnB,gBAAgB,SAAS;AAAA,IACzB,QAAQ,QAAQ;AAAA,IAChB,QAAQ,OAAO,YAAY;AAAA,IAC3B;AAAA,EACF,CAAC;AAED,QAAM,iBAAiB,IAAI;AAAA,IACzB,oBAAoB,SAAS;AAAA,IAC7B,gBAAgB,aAAa;AAAA,IAC7B,GAAI,SAAS,EAAE,kBAAkB,OAAO,GAAG,IAAI,CAAC;AAAA,IAChD,WAAW;AAAA,IACX,WAAW;AAAA,MACT,QAAQ,OAAO,YAAY;AAAA,MAC3B,UAAU,YAAY;AAAA,MACtB,OAAO,SAAS;AAAA,MAChB;AAAA,IACF;AAAA,IACA,QAAQ,QAAQ;AAAA,IAChB,UAAU,SAAS;AAAA,IACnB,gBAAgB,SAAS;AAAA,EAC3B,CAAC;AAED,MAAI,QAAQ;AACV,WAAO,SAAS;AAChB,WAAO,YAAY;AAAA,EACrB,OAAO;AACL,aAAS,SAAS;AAClB,aAAS,WAAW;AACpB,aAAS,YAAY;AAAA,EACvB;AACA,QAAM,GAAG,MAAM;AAEf,SAAO;AAAA,IACL,QAAQ;AAAA,IACR,YAAY;AAAA,IACZ,YAAY;AAAA,MACV;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAWA,eAAe,aACb,IACA,OAUwB;AACxB,QAAM,gBAAgB,GAAG,OAAO,eAAe;AAAA,IAC7C,GAAG;AAAA,IACH,YAAY,oBAAI,KAAK;AAAA,EACvB,CAAC;AAED,QAAM,GAAG,QAAQ,aAAa,EAAE,MAAM;AACtC,SAAO;AACT;AAQA,SAAS,iBAAiB,UAAwB;AAGhD,QAAM,MAAM,oBAAI,KAAK;AAErB,QAAM,YAAY,SAAS,MAAM,SAAS;AAC1C,MAAI,WAAW;AACb,UAAM,OAAO,SAAS,UAAU,CAAC,GAAG,EAAE;AACtC,WAAO,IAAI,KAAK,IAAI,QAAQ,IAAI,OAAO,KAAK,KAAK,KAAK,GAAI;AAAA,EAC5D;AAEA,QAAM,aAAa,SAAS,MAAM,UAAU;AAC5C,MAAI,YAAY;AACd,UAAM,QAAQ,SAAS,WAAW,CAAC,GAAG,EAAE;AACxC,WAAO,IAAI,KAAK,IAAI,QAAQ,IAAI,QAAQ,KAAK,KAAK,GAAI;AAAA,EACxD;AAEA,QAAM,aAAa,SAAS,MAAM,SAAS;AAC3C,MAAI,YAAY;AACd,UAAM,QAAQ,SAAS,WAAW,CAAC,GAAG,EAAE;AACxC,WAAO,IAAI,KAAK,IAAI,QAAQ,IAAI,QAAQ,IAAI,KAAK,KAAK,KAAK,GAAI;AAAA,EACjE;AAGA,SAAO,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK,KAAK,KAAK,GAAI;AACrD;AASA,SAAS,eAAe,KAAU,MAAmB;AACnD,SAAO,KAAK,MAAM,GAAG,EAAE,OAAO,CAAC,SAAS,QAAQ,UAAU,GAAG,GAAG,GAAG;AACrE;AASA,SAAS,eAAe,KAAU,MAAc,OAAkB;AAChE,QAAM,OAAO,KAAK,MAAM,GAAG;AAC3B,QAAM,UAAU,KAAK,IAAI;AACzB,QAAM,SAAS,KAAK,OAAO,CAAC,SAAS,QAAQ;AAC3C,QAAI,EAAE,OAAO,SAAU,SAAQ,GAAG,IAAI,CAAC;AACvC,WAAO,QAAQ,GAAG;AAAA,EACpB,GAAG,GAAG;AACN,SAAO,OAAO,IAAI;AACpB;AASA,SAAS,aACP,eACA,SACqB;AACrB,QAAM,SAA8B,CAAC;AAErC,aAAW,CAAC,WAAW,UAAU,KAAK,OAAO,QAAQ,OAAO,GAAG;AAC7D,UAAM,QAAQ,eAAe,eAAe,UAAU;AACtD,QAAI,UAAU,QAAW;AACvB,qBAAe,QAAQ,WAAW,KAAK;AAAA,IACzC;AAAA,EACF;AAGA,SAAO,OAAO,KAAK,MAAM,EAAE,SAAS,IAAI,SAAS;AACnD;AASA,SAAS,cACP,cACA,SACqB;AACrB,QAAM,SAA8B,CAAC;AAErC,aAAW,CAAC,WAAW,UAAU,KAAK,OAAO,QAAQ,OAAO,GAAG;AAC7D,UAAM,QAAQ,eAAe,cAAc,UAAU;AACrD,QAAI,UAAU,QAAW;AACvB,qBAAe,QAAQ,WAAW,KAAK;AAAA,IACzC;AAAA,EACF;AAGA,SAAO,OAAO,KAAK,MAAM,EAAE,SAAS,IAAI,SAAS;AACnD;",
-  "names": []
+  "sourcesContent": ["/**\n * Workflows Module - Step Handler Service\n *\n * Handles individual workflow step execution:\n * - Creating step instances when entering a step\n * - Executing step logic based on step type (START, END, AUTOMATED, USER_TASK)\n * - Completing step instances when exiting\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport {\n  WorkflowInstance,\n  WorkflowBranchInstance,\n  WorkflowDefinition,\n  StepInstance,\n  UserTask,\n  WorkflowEvent,\n  type StepInstanceStatus,\n  type WorkflowStepType,\n} from '../data/entities'\nimport { emitWorkflowsEvent } from '../events'\nimport { calculateDueDate, parseDuration } from './duration'\nimport {\n  CONDITION_STEP_TYPE,\n  conditionReadContext,\n  evaluateConditionExpression,\n  readWaitForConditionConfig,\n} from './condition-handler'\nimport { mapAgentResultToContext } from './agent-result-mapping'\nimport {\n  WORKFLOW_AGENT_OUTCOME_CONTEXT_KEY,\n  buildAgentOutcomeContextEntry,\n  mapDispositionToAgentOutcome,\n} from './outcome-routing'\nimport { logWorkflowEvent } from './event-logger'\nimport { DRY_RUN_EVENT_TYPES, isDryRunInstance } from './dry-run'\nimport { findDefinitionForInstance } from './find-definition'\nimport { resolveDefinitionInterpolationMode, type WorkflowInterpolationMode } from './interpolation-pipeline'\nimport {\n  collectResolvedEntityTypes,\n  flattenTaskText,\n  resolveTaskAssignment,\n  resolveTaskDeadlineDuration,\n  resolveTaskDecisions,\n  resolveTaskEntityBindings,\n  resolveTaskText,\n  type TaskInterpolate,\n} from './task-resolution'\nimport { scheduleUserTaskSla } from './task-sla'\nimport type { TaskQuickActionInput } from './task-quick-action'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { findWorkflowDefinition } from './find-definition'\nimport { validateAgainstPorts } from './port-contract'\nimport type { WorkflowIoContract } from '../data/validators'\n\nconst logger = createLogger('workflows')\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport interface StepExecutionContext {\n  workflowContext: Record<string, any>\n  userId?: string\n  triggerData?: any\n  // Populated by executeStep from the loaded definition; absent means lenient.\n  interpolationMode?: WorkflowInterpolationMode\n  // Populated by executeStep from the loaded definition so task notifications\n  // can name the workflow the way its author did.\n  workflowName?: string\n}\n\nexport interface StepExecutionResult {\n  status: 'COMPLETED' | 'WAITING' | 'FAILED'\n  outputData?: any\n  nextSteps?: string[] // For parallel forks (Phase 7)\n  waitReason?: 'USER_TASK' | 'SIGNAL' | 'TIMER' | 'FORK' | 'CONDITION'\n  error?: string\n}\n\nexport class StepExecutionError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'StepExecutionError'\n  }\n}\n\n// ============================================================================\n// Main Step Execution Functions\n// ============================================================================\n\n/**\n * Enter a workflow step - create step instance and mark as ACTIVE\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepId - Step ID to enter\n * @param context - Execution context\n * @returns Created step instance\n */\nexport async function enterStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepId: string,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepInstance> {\n  // Load workflow definition to get step details\n  const definition = await findDefinitionForInstance(em, instance)\n\n  if (!definition) {\n    throw new StepExecutionError(\n      `Workflow definition not found: ${instance.definitionId}`,\n      'DEFINITION_NOT_FOUND',\n      { definitionId: instance.definitionId }\n    )\n  }\n\n  // Find step in definition\n  const stepDef = definition.definition.steps.find((s: any) => s.stepId === stepId)\n  if (!stepDef) {\n    throw new StepExecutionError(\n      `Step not found in workflow definition: ${stepId}`,\n      'STEP_NOT_FOUND',\n      { workflowId: definition.workflowId, stepId }\n    )\n  }\n\n  const now = new Date()\n\n  // Create step instance\n  const stepInstance = em.create(StepInstance, {\n    workflowInstanceId: instance.id,\n    branchInstanceId: branch ? branch.id : null,\n    stepId: stepDef.stepId,\n    stepName: stepDef.stepName,\n    stepType: stepDef.stepType,\n    status: 'ACTIVE',\n    inputData: context.triggerData || null,\n    enteredAt: now,\n    retryCount: 0,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  await em.persist(stepInstance).flush()\n\n  // Log STEP_ENTERED event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'STEP_ENTERED',\n    eventData: {\n      stepId: stepDef.stepId,\n      stepName: stepDef.stepName,\n      stepType: stepDef.stepType,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  return stepInstance\n}\n\n/**\n * Exit a workflow step - mark as completed and record timing\n *\n * @param em - Entity manager\n * @param stepInstance - Step instance to exit\n * @param outputData - Optional output data from step execution\n */\n/**\n * Announces the BUSINESS milestone a completing step carries, if it carries one.\n *\n * Resolved here rather than plumbed through every `exitStep` caller because a\n * milestone must be announced from EVERY completion path \u2014 the inline advance,\n * a signal resume, a task completion, a timer, a condition wake, a parallel\n * branch \u2014 and a per-caller argument would silently miss whichever path was\n * added next. Both reads are by primary key and the executor already loaded both\n * rows, so in practice they resolve from the identity map rather than the\n * database.\n *\n * Best-effort by construction: a step that completed HAS completed, and a failure\n * to announce that fact must never undo it.\n */\nasync function emitStepMilestone(em: EntityManager, stepInstance: StepInstance): Promise<void> {\n  try {\n    const instance = await em.findOne(WorkflowInstance, { id: stepInstance.workflowInstanceId })\n    if (!instance) return\n    const definition = await em.findOne(WorkflowDefinition, { id: instance.definitionId })\n    const stepDef = definition?.definition?.steps?.find((step: any) => step.stepId === stepInstance.stepId)\n    const milestoneKey = typeof stepDef?.milestone === 'string' ? stepDef.milestone : null\n    if (!milestoneKey) return\n    await emitWorkflowsEvent(\n      'workflows.instance.milestone_reached',\n      {\n        instanceId: instance.id,\n        workflowId: instance.workflowId,\n        milestoneKey,\n        // For the trace only. A consumer matches on `milestoneKey`; matching on\n        // the step is exactly the coupling the milestone model removes.\n        stepId: stepInstance.stepId,\n        occurredAt: new Date().toISOString(),\n        data: stepInstance.outputData ?? null,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      },\n      { persistent: true },\n    )\n  } catch {\n    // ignore \u2014 announcing a milestone can never fail a step that completed\n  }\n}\n\nexport async function exitStep(\n  em: EntityManager,\n  stepInstance: StepInstance,\n  outputData?: any\n): Promise<void> {\n  const now = new Date()\n\n  // Calculate execution time if we have enteredAt\n  let executionTimeMs: number | null = null\n  if (stepInstance.enteredAt) {\n    executionTimeMs = now.getTime() - stepInstance.enteredAt.getTime()\n  }\n\n  // Update step instance\n  stepInstance.status = 'COMPLETED'\n  stepInstance.outputData = outputData || null\n  stepInstance.exitedAt = now\n  stepInstance.executionTimeMs = executionTimeMs\n  stepInstance.updatedAt = now\n\n  await em.flush()\n\n  // Log STEP_EXITED event\n  await logStepEvent(em, {\n    workflowInstanceId: stepInstance.workflowInstanceId,\n    stepInstanceId: stepInstance.id,\n    eventType: 'STEP_EXITED',\n    eventData: {\n      stepId: stepInstance.stepId,\n      status: 'COMPLETED',\n      executionTimeMs,\n      hasOutput: !!outputData,\n    },\n    tenantId: stepInstance.tenantId,\n    organizationId: stepInstance.organizationId,\n  })\n\n  await emitStepMilestone(em, stepInstance)\n}\n\n/**\n * Mark a step instance FAILED and log `STEP_FAILED`.\n *\n * The ONE place a step row becomes FAILED, so a failure the run went on to\n * tolerate leaves the same durable trace a fatal one does. Tolerating a failure\n * is a routing decision, not a reason to forget it happened: without the row and\n * the event there is nothing for the run verdict to be computed from, and\n * rerun-from-step refuses the step it exists for because its latest attempt\n * still reads ACTIVE.\n *\n * Idempotent \u2014 a second call on an already-FAILED row is a no-op, so a handler\n * that reported the failure itself never produces two `STEP_FAILED` rows.\n */\nexport async function markStepInstanceFailed(\n  em: EntityManager,\n  stepInstance: StepInstance,\n  failure: {\n    error: string\n    details?: unknown\n    branchInstanceId?: string | null\n    userId?: string\n  }\n): Promise<void> {\n  if (stepInstance.status === 'FAILED') return\n\n  const now = new Date()\n  stepInstance.status = 'FAILED'\n  stepInstance.errorData = {\n    error: failure.error,\n    details: failure.details ?? undefined,\n  }\n  stepInstance.exitedAt = now\n  stepInstance.updatedAt = now\n  await em.flush()\n\n  await logStepEvent(em, {\n    workflowInstanceId: stepInstance.workflowInstanceId,\n    stepInstanceId: stepInstance.id,\n    ...(failure.branchInstanceId ? { branchInstanceId: failure.branchInstanceId } : {}),\n    eventType: 'STEP_FAILED',\n    eventData: { stepId: stepInstance.stepId, error: failure.error },\n    ...(failure.userId ? { userId: failure.userId } : {}),\n    tenantId: stepInstance.tenantId,\n    organizationId: stepInstance.organizationId,\n  })\n}\n\n/**\n * Execute a workflow step based on its type\n *\n * Main entry point for step execution. Handles:\n * - START: Immediate completion\n * - END: Workflow completion\n * - AUTOMATED: Activity execution (MVP: immediate completion)\n * - USER_TASK: Create user task and wait\n * - SUB_WORKFLOW: Invoke child workflow\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepId - Step ID to execute\n * @param context - Execution context\n * @param container - DI container (required for SUB_WORKFLOW steps)\n * @returns Execution result with status and output\n */\nexport async function executeStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepId: string,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  try {\n    // Enter the step (create step instance)\n    const stepInstance = await enterStep(em, instance, stepId, context, branch)\n\n    // Load workflow definition to get step configuration\n    const definition = await findDefinitionForInstance(em, instance)\n\n    if (!definition) {\n      throw new StepExecutionError(\n        `Workflow definition not found: ${instance.definitionId}`,\n        'DEFINITION_NOT_FOUND',\n        { definitionId: instance.definitionId }\n      )\n    }\n\n    const stepDef = definition.definition.steps.find((s: any) => s.stepId === stepId)\n    if (!stepDef) {\n      throw new StepExecutionError(\n        `Step not found: ${stepId}`,\n        'STEP_NOT_FOUND',\n        { stepId }\n      )\n    }\n\n    // Execute based on step type\n    const result = await executeStepByType(\n      em,\n      instance,\n      stepInstance,\n      stepDef,\n      {\n        ...context,\n        interpolationMode: resolveDefinitionInterpolationMode(definition.definition),\n        workflowName: definition.workflowName,\n      },\n      container,\n      branch\n    )\n\n    // If step completed, exit it\n    if (result.status === 'COMPLETED') {\n      await exitStep(em, stepInstance, result.outputData)\n    } else if (result.status === 'FAILED') {\n      // A handler that REPORTS a failure (`handleAutomatedStep` returns\n      // `{status:'FAILED'}` for a failed sync activity) never reaches the catch\n      // below, so before this the row stayed ACTIVE for ever and no\n      // `STEP_FAILED` was logged \u2014 the failure existed only in a value the\n      // caller was free to tolerate. The row is now terminal on both paths.\n      await markStepInstanceFailed(em, stepInstance, {\n        error: result.error ?? 'Step execution failed',\n        details: result.outputData,\n        branchInstanceId: branch?.id ?? null,\n        userId: context.userId,\n      })\n    }\n\n    return result\n  } catch (error) {\n    // Handle step execution errors\n    const errorMessage = error instanceof Error ? error.message : String(error)\n\n    // Try to mark step as failed if we have a step instance\n    try {\n      const failedStepInstance = await em.findOne(StepInstance, {\n        workflowInstanceId: instance.id,\n        stepId,\n        status: 'ACTIVE',\n      })\n\n      if (failedStepInstance) {\n        await markStepInstanceFailed(em, failedStepInstance, {\n          error: errorMessage,\n          details: error instanceof StepExecutionError ? error.details : undefined,\n          branchInstanceId: branch?.id ?? null,\n          userId: context.userId,\n        })\n      }\n    } catch (updateError) {\n      // Swallow update errors to preserve original error\n      logger.error('Failed to update step instance with error', { err: updateError })\n    }\n\n    return {\n      status: 'FAILED',\n      error: errorMessage,\n    }\n  }\n}\n\n// ============================================================================\n// Step Type Handlers\n// ============================================================================\n\n/**\n * Execute step based on its type\n *\n * @param em - Entity manager\n * @param instance - Workflow instance\n * @param stepInstance - Step instance\n * @param stepDef - Step definition from workflow\n * @param context - Execution context\n * @returns Execution result\n */\nasync function executeStepByType(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const stepType: WorkflowStepType = stepDef.stepType\n\n  switch (stepType) {\n    case 'START':\n      return handleStartStep(stepDef, context)\n\n    case 'END':\n      return handleEndStep(stepDef, context)\n\n    case 'AUTOMATED':\n      return await handleAutomatedStep(em, instance, stepInstance, stepDef, context, container, branch)\n\n    case 'USER_TASK':\n      return await handleUserTaskStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'SUB_WORKFLOW':\n      if (!container) {\n        throw new StepExecutionError(\n          'Container required for SUB_WORKFLOW execution',\n          'CONTAINER_REQUIRED',\n          { stepType }\n        )\n      }\n      return await handleSubWorkflowStep(em, container, instance, stepInstance, stepDef, context)\n\n    case 'IF_ELSE':\n    case 'SWITCH':\n      return handleBranchingStep(stepType)\n\n    case 'WAIT_FOR_SIGNAL':\n      return await handleWaitForSignalStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'WAIT_FOR_TIMER':\n      return await handleWaitForTimerStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'WAIT_FOR_CONDITION':\n      return await handleWaitForConditionStep(em, instance, stepInstance, stepDef, context, branch)\n\n    case 'PARALLEL_FORK': {\n      // Entering a fork opens branch tokens and parks the root token in the\n      // FORKED state; the interleaved loop in the executor drives the branches.\n      if (branch) {\n        // Nested forks are rejected by definition validation; fail closed.\n        throw new StepExecutionError(\n          'Nested PARALLEL_FORK is not supported',\n          'NESTED_FORK_NOT_SUPPORTED',\n          { stepType, stepId: stepDef.stepId }\n        )\n      }\n      const definition = await findDefinitionForInstance(em, instance)\n      if (!definition) {\n        throw new StepExecutionError(\n          `Workflow definition not found: ${instance.definitionId}`,\n          'DEFINITION_NOT_FOUND',\n          { definitionId: instance.definitionId }\n        )\n      }\n      const { openFork } = await import('./parallel-handler')\n      await openFork(em, instance, definition, stepDef)\n      return { status: 'WAITING', waitReason: 'FORK', outputData: { stepType: 'PARALLEL_FORK', forkStepId: stepDef.stepId } }\n    }\n\n    case 'PARALLEL_JOIN':\n      // The join is a synchronization point handled by the parallel loop\n      // (branches are marked COMPLETED on arrival; the loop fires the join).\n      // Executing the step itself is a no-op.\n      return { status: 'COMPLETED', outputData: { stepType: 'PARALLEL_JOIN', timestamp: new Date().toISOString() } }\n\n    default:\n      throw new StepExecutionError(\n        `Unknown step type: ${stepType}`,\n        'UNKNOWN_STEP_TYPE',\n        { stepType }\n      )\n  }\n}\n\n/**\n * Handle START step - no-op, immediately complete\n */\nfunction handleStartStep(\n  stepDef: any,\n  context: StepExecutionContext\n): StepExecutionResult {\n  return {\n    status: 'COMPLETED',\n    outputData: {\n      stepType: 'START',\n      timestamp: new Date().toISOString(),\n    },\n  }\n}\n\n/**\n * Handle END step - mark as complete\n */\nfunction handleEndStep(\n  stepDef: any,\n  context: StepExecutionContext\n): StepExecutionResult {\n  return {\n    status: 'COMPLETED',\n    outputData: {\n      stepType: 'END',\n      timestamp: new Date().toISOString(),\n      finalContext: context.workflowContext,\n    },\n  }\n}\n\n/**\n * Handle IF_ELSE / SWITCH steps - pure transition sugar.\n *\n * Branching nodes carry NO runtime semantics of their own: they behave exactly\n * like an AUTOMATED step with no activities and complete immediately. Every\n * routing decision stays in `findValidTransitions`, which already evaluates the\n * business_rules condition language and orders candidates by priority, so the\n * unconditioned \"otherwise\" route wins only when no cased route matches.\n */\nfunction handleBranchingStep(stepType: 'IF_ELSE' | 'SWITCH'): StepExecutionResult {\n  return {\n    status: 'COMPLETED',\n    outputData: {\n      stepType,\n      timestamp: new Date().toISOString(),\n    },\n  }\n}\n\n/**\n * Handle AUTOMATED step - execute activities\n *\n * Executes activities defined in step configuration.\n * Supports both sync and async activities.\n */\nasync function handleAutomatedStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  container?: any,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  // Extract activities from step definition\n  const activities = stepDef.activities || []\n\n  if (activities.length === 0) {\n    // No activities defined - immediate completion (legacy behavior)\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'AUTOMATED',\n        timestamp: new Date().toISOString(),\n      },\n    }\n  }\n\n  // Import activity executor\n  const { executeActivities, interpolateVariables } = await import('./activity-executor')\n\n  // Persist the resolved INVOKE_AGENT input so the run inspector shows what this\n  // step actually received. `inputData` was seeded at step entry from the\n  // workflow trigger data (null for a manually-started run), never the agent's\n  // real, interpolated `config.input` \u2014 the same value the executor computes via\n  // `interpolateActivityConfig` (a thin wrapper over `interpolateVariables`), so\n  // re-interpolating the input field here yields exactly what the agent runs on.\n  const agentActivity = activities.find(\n    (activity: any) => activity.activityType === 'INVOKE_AGENT' && activity?.config?.input !== undefined,\n  )\n  if (agentActivity) {\n    try {\n      const resolvedInput = interpolateVariables(\n        (agentActivity as any).config.input,\n        context.workflowContext,\n        instance,\n        { mode: context.interpolationMode },\n      )\n      if (resolvedInput !== undefined) {\n        stepInstance.inputData = resolvedInput\n        stepInstance.updatedAt = new Date()\n        await em.flush()\n      }\n    } catch {\n      // Display-only capture: an interpolation error is surfaced by the actual\n      // activity run below, so it must never abort the step here.\n    }\n  }\n\n  try {\n    // Execute activities with proper context\n    const results = await executeActivities(em, container, activities, {\n      workflowInstance: instance,\n      workflowContext: context.workflowContext,\n      stepContext: { stepId: stepDef.stepId, stepName: stepDef.stepName },\n      stepInstanceId: stepInstance.id,\n      userId: context.userId,\n      interpolationMode: context.interpolationMode,\n    })\n\n    // Check if there are pending async activities\n    const pendingActivities = results.filter(r => r.async && !r.success)\n    if (pendingActivities.length > 0) {\n      // Workflow should pause and wait for async activities\n      const now = new Date()\n      if (branch) {\n        branch.status = 'WAITING_FOR_ACTIVITIES'\n        branch.updatedAt = now\n      } else {\n        instance.status = 'WAITING_FOR_ACTIVITIES'\n        instance.pausedAt = now\n        instance.updatedAt = now\n      }\n      await em.flush()\n\n      return {\n        status: 'WAITING',\n        waitReason: 'SIGNAL', // Reuse SIGNAL wait reason (will be resumed by activity completion)\n        outputData: {\n          pendingActivities: pendingActivities.map(r => ({\n            activityId: r.activityId,\n            activityName: r.activityName,\n            jobId: r.jobId,\n          })),\n        },\n      }\n    }\n\n    // Check for failures in sync activities\n    const failures = results.filter(r => !r.success && !r.async)\n    if (failures.length > 0) {\n      const errorMessages = failures.map(f => `${f.activityName || f.activityId}: ${f.error}`).join('; ')\n      return {\n        status: 'FAILED',\n        error: `${failures.length} activity(ies) failed: ${errorMessages}`,\n        outputData: {\n          failures: failures.map(f => ({\n            activityId: f.activityId,\n            activityName: f.activityName,\n            error: f.error,\n            retryCount: f.retryCount,\n          })),\n        },\n      }\n    }\n\n    // INVOKE_AGENT (agent_orchestrator) integration:\n    // A `__park` marker means the agent's proposal was routed to a human \u2014 park\n    // the instance on the signal exactly like handleWaitForSignalStep. The step\n    // declares `signalConfig.signalName`, so sendSignal (relaxed) resumes it when\n    // agent_orchestrator's dispose path fires `agent_orchestrator.proposal.ready`.\n    const parkResult = results.find((r) => r.output && (r.output as any).__park)\n    if (parkResult) {\n      const signalName = (parkResult.output as any).__park.signalName as string\n      const proposalId = (parkResult.output as any).proposalId\n      const now = new Date()\n      await logStepEvent(em, {\n        workflowInstanceId: instance.id,\n        stepInstanceId: stepInstance.id,\n        ...(branch ? { branchInstanceId: branch.id } : {}),\n        eventType: 'SIGNAL_AWAITING',\n        eventData: { signalName, proposalId, reason: 'INVOKE_AGENT' },\n        userId: context.userId,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n      if (branch) {\n        branch.status = 'PAUSED'\n        branch.updatedAt = now\n      } else {\n        instance.status = 'PAUSED'\n        instance.pausedAt = now\n        instance.updatedAt = now\n      }\n      await em.flush()\n      return {\n        status: 'WAITING',\n        waitReason: 'SIGNAL',\n        outputData: { signalName, proposalId, awaitingSince: now },\n      }\n    }\n\n    // Inline-resolved agent result (auto_approved / researcher / artifact):\n    // surface the disposition into context (top-level, matching the human-path\n    // signal merge) so the outgoing transition can branch (effector vs skip)\n    // uniformly.\n    const inlineAgent = results.find(\n      (r) => r.output && typeof (r.output as any).kind === 'string' && 'agentId' in (r.output as any),\n    )\n    if (inlineAgent && !branch) {\n      const out = inlineAgent.output as any\n      const agentActivity = activities.find(\n        (a: any) => a.activityType === 'INVOKE_AGENT' && a.activityId === inlineAgent.activityId,\n      )\n      const mappedPatch = mapAgentResultToContext(\n        {\n          kind: out.kind,\n          agentId: out.agentId,\n          proposalId: out.proposalId,\n          proposalPayload: out.proposalPayload,\n          data: out.data,\n          artifacts: out.artifacts,\n        },\n        agentActivity?.config?.outputMapping,\n      )\n      const contextPatch =\n        mappedPatch ??\n        (out.kind === 'auto_approved'\n          ? {\n              disposition: 'auto_approved',\n              agentProposalId: out.proposalId,\n              proposalPayload: out.proposalPayload,\n            }\n          : out.kind === 'artifact'\n            ? {\n                disposition: 'researcher',\n                [`${stepInstance.stepId}_agent`]: { artifacts: out.artifacts, summary: out.summary },\n              }\n            : null)\n      // Outcome routing (spec 7.2): record which of the five fixed disposition\n      // kinds this step resolved to under an ENGINE-OWNED context key. The\n      // executor routes on this marker alone \u2014 never on the author-visible\n      // `disposition` key \u2014 which is what makes branching on a disposition\n      // wiring rather than context string-matching.\n      const resolvedOutcome = mapDispositionToAgentOutcome(out.kind)\n      const outcomeMarker = resolvedOutcome\n        ? {\n            [WORKFLOW_AGENT_OUTCOME_CONTEXT_KEY]: buildAgentOutcomeContextEntry(\n              stepInstance.stepId,\n              resolvedOutcome,\n              out.proposalId,\n            ),\n          }\n        : null\n\n      const nextContext = { ...instance.context, ...(contextPatch ?? {}), ...(outcomeMarker ?? {}) }\n      if (contextPatch || outcomeMarker) {\n        instance.context = nextContext\n        instance.updatedAt = new Date()\n        await em.flush()\n      }\n    }\n\n    // All activities completed successfully\n    const activityOutputs = results.reduce((acc, r) => {\n      if (r.output) {\n        acc[r.activityId] = r.output\n      }\n      return acc\n    }, {} as Record<string, any>)\n\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'AUTOMATED',\n        timestamp: new Date().toISOString(),\n        activityResults: activityOutputs,\n        activityCount: results.length,\n      },\n    }\n  } catch (error: any) {\n    return {\n      status: 'FAILED',\n      error: `Activity execution failed: ${error.message}`,\n    }\n  }\n}\n\n/**\n * Resolve a user task's deadline from its authored duration.\n *\n * An unparseable duration fails the step with an actionable message instead of\n * quietly resolving to some default the author never asked for.\n */\nfunction resolveUserTaskDeadline(stepId: string, slaDuration: string): Date {\n  try {\n    return calculateDueDate(slaDuration)\n  } catch (error) {\n    throw new StepExecutionError(\n      `Invalid user task deadline \"${slaDuration}\": ${error instanceof Error ? error.message : String(error)}`,\n      'INVALID_USER_TASK_DEADLINE',\n      { stepId, slaDuration }\n    )\n  }\n}\n\n/**\n * Publish the declared `workflows.task.assigned` domain event for a freshly\n * created task, alongside (never instead of) the internal `USER_TASK_CREATED`\n * audit row. It carries both the individual assignee and the role queue so the\n * notification subscriber can reach role-assigned tasks too.\n *\n * Delivery is at-least-once and consumers must be idempotent; a bus failure\n * must never break workflow execution, so this is strictly best-effort.\n */\nasync function emitTaskAssignedEvent(\n  userTask: UserTask,\n  instance: WorkflowInstance,\n  context: StepExecutionContext,\n  quickAction?: TaskQuickActionInput\n): Promise<void> {\n  try {\n    await emitWorkflowsEvent(\n      'workflows.task.assigned',\n      {\n        // Everything the notification quick-action rule needs, and nothing more.\n        // ABSENT means \"unknown\", and the subscriber falls back to the deep\n        // link \u2014 a quick action must never be offered on a guess.\n        ...(quickAction ? { quickAction } : {}),\n        taskId: userTask.id,\n        taskName: userTask.taskName,\n        workflowInstanceId: instance.id,\n        workflowId: instance.workflowId,\n        workflowName: context.workflowName ?? instance.workflowId,\n        assignedUserId: userTask.assignedTo ?? null,\n        assignedToRoles: userTask.assignedToRoles ?? null,\n        dueDate: userTask.dueDate ? userTask.dueDate.toISOString() : null,\n        // Additive: the records the task is about. Modules that own those\n        // records subscribe and surface the task on their own turf \u2014 the\n        // customers module writes a `CustomerTodoLink` from this. Workflows\n        // never reaches into another module's tables to do it itself.\n        entityBindings: userTask.entityBindings ?? null,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId ?? null,\n      },\n      { persistent: true }\n    )\n  } catch (error) {\n    logger.error('Failed to emit workflows.task.assigned', {\n      component: 'step-handler',\n      taskId: userTask.id,\n      err: error,\n    })\n  }\n\n  if (userTask.assigneeKind !== 'customer' || !userTask.assignedTo) return\n\n  try {\n    // Addressed to ONE portal principal (`recipientUserId` is what narrows the\n    // SSE audience) and carrying an id and nothing else. The receiver asks the\n    // authorized portal API what the task is; the bridge never carries the\n    // answer, so a mis-scoped connection learns nothing from it.\n    await emitWorkflowsEvent(\n      'workflows.task.portal_assigned',\n      {\n        taskId: userTask.id,\n        recipientUserId: userTask.assignedTo,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId ?? null,\n      },\n      { persistent: false }\n    )\n  } catch (error) {\n    logger.error('Failed to emit workflows.task.portal_assigned', {\n      component: 'step-handler',\n      taskId: userTask.id,\n      err: error,\n    })\n  }\n}\n\n/**\n * Handle USER_TASK step - create user task and enter waiting state\n *\n * Creates a UserTask entity and returns WAITING status.\n * The workflow will pause until the task is completed by a user.\n */\nasync function handleUserTaskStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const userTaskConfig = stepDef.userTaskConfig || {}\n\n  // Everything an author can write on a task \u2014 its title, its instructions, its\n  // decision labels, its dynamic assignee and its entity bindings \u2014 is resolved\n  // HERE, once, against the context the run has at creation time. Resolving\n  // later would let a definition edit retro-change what a running task says.\n  // Lenient on purpose: an unresolved dynamic assignee is what the fallback role\n  // queue exists for, not a reason to fail the step.\n  //\n  // Imported dynamically like every other activity-executor use in this file, so\n  // the module graph stays acyclic.\n  const { interpolateVariables } = await import('./activity-executor')\n  const interpolate: TaskInterpolate = (value) =>\n    interpolateVariables(value, context.workflowContext, instance)\n\n  const assignment = resolveTaskAssignment(userTaskConfig, interpolate)\n  if (assignment.fellBackToRoles) {\n    logger.warn('Dynamic task assignee resolved to nothing; falling back to the role queue', {\n      component: 'step-handler',\n      stepId: stepDef.stepId,\n      workflowInstanceId: instance.id,\n      assignedToRoles: assignment.assignedToRoles,\n    })\n  }\n  if (assignment.fellBackFromCustomer) {\n    // The author addressed this to a portal principal and no id resolved, so it\n    // landed in the backoffice namespace instead. The work is still reachable,\n    // but by a different audience than intended \u2014 that is worth saying out loud.\n    logger.warn('Portal task assignee resolved to nothing; task created for the backoffice instead', {\n      component: 'step-handler',\n      stepId: stepDef.stepId,\n      workflowInstanceId: instance.id,\n    })\n  }\n\n  const { bindings, unresolved } = resolveTaskEntityBindings(userTaskConfig.entityBindings, interpolate)\n  if (unresolved.length) {\n    logger.warn('Task entity bindings skipped because their ids did not resolve', {\n      component: 'step-handler',\n      stepId: stepDef.stepId,\n      workflowInstanceId: instance.id,\n      unresolved,\n    })\n  }\n\n  const taskName = String(interpolate(stepDef.stepName) ?? stepDef.stepName)\n  const instructions = resolveTaskText(userTaskConfig.instructions, interpolate)\n  const decisions = resolveTaskDecisions(userTaskConfig.decisions, interpolate)\n  const deadlineDuration = resolveTaskDeadlineDuration(userTaskConfig)\n\n  // Create user task\n  const now = new Date()\n\n  // Dry run (spec section 8.2): a simulation raises NO real task. The row is\n  // what everything else hangs off \u2014 the `workflows.task.assigned` event and\n  // therefore the notification subscriber, the SLA reminder/breach queue jobs,\n  // and every Work Inbox and task-list query \u2014 so suppressing the row is what\n  // suppresses all of them, rather than a filter at each read site that a new\n  // reader could forget. Everything above still runs, so the report says\n  // exactly who the task WOULD have gone to. The step still WAITS: the author\n  // simulates the decision through step-through or the advance action.\n  if (isDryRunInstance(instance)) {\n    await logStepEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: stepInstance.id,\n      ...(branch ? { branchInstanceId: branch.id } : {}),\n      eventType: DRY_RUN_EVENT_TYPES.userTaskSimulated,\n      eventData: {\n        taskName,\n        assignedTo: assignment.assignedTo,\n        assignedToRoles: assignment.assignedToRoles,\n        assigneeKind: assignment.assigneeKind,\n        ...(bindings.length ? { entityBindings: bindings } : {}),\n        ...(decisions.length ? { decisions } : {}),\n        ...(deadlineDuration ? { deadlineDuration } : {}),\n      },\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    if (branch) {\n      branch.status = 'PAUSED'\n      branch.updatedAt = now\n    } else {\n      instance.status = 'PAUSED'\n      instance.updatedAt = now\n    }\n    await em.flush()\n\n    return {\n      status: 'WAITING',\n      waitReason: 'USER_TASK',\n      outputData: { simulated: true, wouldRaiseTask: taskName },\n    }\n  }\n\n  const userTask = em.create(UserTask, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    branchInstanceId: branch ? branch.id : null,\n    taskName,\n    description: flattenTaskText(instructions) ?? stepDef.description ?? null,\n    status: 'PENDING',\n    formSchema: userTaskConfig.formSchema || null,\n    formData: null,\n    assignedTo: assignment.assignedTo,\n    // Decided by `resolveTaskAssignment` from the authored `assigneeKind`, and\n    // `'customer'` only when an individual assignee actually resolved. Written\n    // explicitly rather than left to the column default so the discriminator is\n    // a decision at every creation site, not an accident.\n    assigneeKind: assignment.assigneeKind,\n    assignedToRoles: assignment.assignedToRoles,\n    entityBindings: bindings.length ? bindings : null,\n    // Denormalized from the SAME resolved bindings, so the two can never drift.\n    // Null for a task about nothing, which is what the vacuous-pass rule reads.\n    entityTypes: bindings.length ? collectResolvedEntityTypes(bindings) : null,\n    priority: userTaskConfig.priority ?? null,\n    dueDate: deadlineDuration\n      ? resolveUserTaskDeadline(stepDef.stepId, deadlineDuration)\n      : null,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    createdAt: now,\n    updatedAt: now,\n  })\n\n  await em.persist(userTask).flush()\n\n  // Log USER_TASK_CREATED event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'USER_TASK_CREATED',\n    eventData: {\n      userTaskId: userTask.id,\n      taskName: userTask.taskName,\n      assignedTo: userTask.assignedTo,\n      assignedToRoles: userTask.assignedToRoles,\n      ...(bindings.length ? { entityBindings: bindings } : {}),\n      ...(userTask.priority ? { priority: userTask.priority } : {}),\n      ...(decisions.length ? { decisions } : {}),\n      ...(assignment.fellBackToRoles ? { assignmentFallback: 'roles' } : {}),\n    },\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  await emitTaskAssignedEvent(userTask, instance, context, {\n    decisions: decisions.map((decision) => ({ id: decision.id })),\n    formSchema: userTask.formSchema ?? null,\n    editablePrefilled: userTaskConfig.editablePrefilled ?? null,\n  })\n\n  // Reminders and the deadline breach are scheduled HERE, once, with the\n  // deadline already absolute on each job payload \u2014 see `lib/task-sla.ts`. A\n  // task with no deadline schedules nothing at all.\n  await scheduleUserTaskSla({\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    branchInstanceId: branch ? branch.id : null,\n    userTaskId: userTask.id,\n    dueDate: userTask.dueDate ?? null,\n    reminders: userTaskConfig.reminders ?? null,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    userId: context.userId,\n    now,\n  })\n\n  // Pause execution - waits for user task completion. For a branch, only the\n  // branch pauses; sibling branches keep running.\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  return {\n    status: 'WAITING',\n    waitReason: 'USER_TASK',\n    outputData: {\n      userTaskId: userTask.id,\n    },\n  }\n}\n\n/**\n * Handle SUB_WORKFLOW step - invoke another workflow and wait for completion\n *\n * Creates a child workflow instance with mapped input data,\n * executes it synchronously, and returns mapped output data.\n */\nasync function handleSubWorkflowStep(\n  em: EntityManager,\n  container: any,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext\n): Promise<StepExecutionResult> {\n  const { subWorkflowId, inputMapping, outputMapping, version } = stepDef.config || {}\n\n  if (!subWorkflowId) {\n    return {\n      status: 'FAILED',\n      error: 'Sub-workflow ID not specified in step configuration'\n    }\n  }\n\n  // Map input data from parent context to child context\n  let childContext = mapInputData(instance.context, inputMapping || {})\n\n  // Import workflow executor functions\n  const { startWorkflow, executeWorkflow } = await import('./workflow-executor')\n\n  try {\n    // Resolve the child definition to read its declared port contract (if any).\n    // Validation is opt-in by contract presence: only children that declare\n    // `definition.io` ports are checked, so legacy untyped sub-workflows behave\n    // exactly as before.\n    const childDefinition = await findWorkflowDefinition(em, {\n      workflowId: subWorkflowId,\n      version,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n    const ioContract = (childDefinition?.definition as { io?: WorkflowIoContract } | undefined)?.io\n\n    // Validate/coerce mapped inputs against the child's declared input ports.\n    if (ioContract?.inputs?.length) {\n      const { coerced, errors } = validateAgainstPorts(childContext, ioContract.inputs)\n      if (errors.length > 0) {\n        const message = `Sub-workflow input validation failed: ${errors.map((e) => e.message).join('; ')}`\n        await logStepEvent(em, {\n          workflowInstanceId: instance.id,\n          stepInstanceId: stepInstance.id,\n          eventType: 'SUB_WORKFLOW_FAILED',\n          eventData: { subWorkflowId, reason: 'INPUT_VALIDATION', error: message },\n          userId: context.userId,\n          tenantId: instance.tenantId,\n          organizationId: instance.organizationId,\n        })\n        return { status: 'FAILED', error: message }\n      }\n      childContext = coerced\n    }\n\n    // Start child workflow with parent metadata\n    const childInstance = await startWorkflow(em, {\n      workflowId: subWorkflowId,\n      version,\n      initialContext: childContext,\n      correlationKey: instance.correlationKey || undefined,\n      metadata: {\n        ...instance.metadata,\n        labels: {\n          ...instance.metadata?.labels,\n          parentInstanceId: instance.id,\n          parentStepId: stepDef.stepId,\n          parentStepInstanceId: stepInstance.id,\n        },\n      },\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    // Log sub-workflow invocation event\n    await logStepEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: stepInstance.id,\n      eventType: 'SUB_WORKFLOW_STARTED',\n      eventData: {\n        childInstanceId: childInstance.id,\n        subWorkflowId,\n        version,\n        inputData: childContext,\n      },\n      userId: context.userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    // Execute child workflow synchronously\n    const result = await executeWorkflow(em, container, childInstance.id, {\n      userId: context.userId,\n    })\n\n    // Handle child workflow result\n    if (result.status === 'COMPLETED') {\n      // Map output data from child context to parent context (+ io-port\n      // validation). Shared with the async resume path so both apply identical\n      // mapping/validation rules.\n      const mapped = mapSubWorkflowOutput(result.context, outputMapping || {}, ioContract)\n      if (mapped.error) {\n        await logStepEvent(em, {\n          workflowInstanceId: instance.id,\n          stepInstanceId: stepInstance.id,\n          eventType: 'SUB_WORKFLOW_FAILED',\n          eventData: { childInstanceId: childInstance.id, reason: 'OUTPUT_VALIDATION', error: mapped.error },\n          userId: context.userId,\n          tenantId: instance.tenantId,\n          organizationId: instance.organizationId,\n        })\n        return { status: 'FAILED', error: mapped.error }\n      }\n      const outputData = mapped.outputData\n\n      await logStepEvent(em, {\n        workflowInstanceId: instance.id,\n        stepInstanceId: stepInstance.id,\n        eventType: 'SUB_WORKFLOW_COMPLETED',\n        eventData: {\n          childInstanceId: childInstance.id,\n          outputData,\n        },\n        userId: context.userId,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return {\n        status: 'COMPLETED',\n        outputData,\n      }\n    } else if (result.status === 'FAILED') {\n      await logStepEvent(em, {\n        workflowInstanceId: instance.id,\n        stepInstanceId: stepInstance.id,\n        eventType: 'SUB_WORKFLOW_FAILED',\n        eventData: {\n          childInstanceId: childInstance.id,\n          error: result.errors?.join(', '),\n        },\n        userId: context.userId,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n\n      return {\n        status: 'FAILED',\n        error: `Sub-workflow failed: ${result.errors?.join(', ')}`,\n      }\n    } else {\n      // The child parked at its first async/agent step (RUNNING / PAUSED /\n      // WAITING_FOR_ACTIVITIES). Make the SUB_WORKFLOW step suspendable: park the\n      // parent on SUB_WORKFLOW_SIGNAL_NAME. The child's terminal completeWorkflow\n      // enqueues a resume job that resumes this parent (mirrors the INVOKE_AGENT\n      // __park branch above).\n      const { SUB_WORKFLOW_SIGNAL_NAME } = await import('./activity-executor')\n      const now = new Date()\n      await logStepEvent(em, {\n        workflowInstanceId: instance.id,\n        stepInstanceId: stepInstance.id,\n        eventType: 'SIGNAL_AWAITING',\n        eventData: {\n          signalName: SUB_WORKFLOW_SIGNAL_NAME,\n          childInstanceId: childInstance.id,\n          reason: 'SUB_WORKFLOW',\n        },\n        userId: context.userId,\n        tenantId: instance.tenantId,\n        organizationId: instance.organizationId,\n      })\n      instance.status = 'PAUSED'\n      instance.pausedAt = now\n      instance.updatedAt = now\n      await em.flush()\n      return {\n        status: 'WAITING',\n        waitReason: 'SIGNAL',\n        outputData: { childInstanceId: childInstance.id },\n      }\n    }\n  } catch (error: any) {\n    await logStepEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: stepInstance.id,\n      eventType: 'SUB_WORKFLOW_FAILED',\n      eventData: {\n        subWorkflowId,\n        error: error.message,\n      },\n      userId: context.userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    return {\n      status: 'FAILED',\n      error: `Sub-workflow execution failed: ${error.message}`,\n    }\n  }\n}\n\n/**\n * Handle WAIT_FOR_SIGNAL step - pause workflow until signal received\n *\n * Creates a waiting state and pauses the workflow until an external signal\n * with the matching signal name is received. The signal payload will be merged\n * into the workflow context when received.\n */\nasync function handleWaitForSignalStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const signalConfig = stepDef.signalConfig || {}\n  const signalName = signalConfig.signalName || stepDef.stepId\n  const timeout = signalConfig.timeout ? parseDuration(signalConfig.timeout) : null\n\n  const now = new Date()\n\n  // Log signal awaiting event\n  await logStepEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'SIGNAL_AWAITING',\n    eventData: {\n      signalName,\n      timeout,\n      description: stepDef.description,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  // Pause execution (branch-scoped when running inside a parallel branch)\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.pausedAt = now\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  // Return WAITING status to halt executor\n  return {\n    status: 'WAITING',\n    waitReason: 'SIGNAL',\n    outputData: {\n      signalName,\n      timeout,\n      awaitingSince: now,\n    },\n  }\n}\n\n/**\n * Handle WAIT_FOR_TIMER step - pause workflow until a timer fires.\n *\n * Reads `duration` (relative, e.g. \"PT5M\") or `until` (ISO 8601 datetime) from\n * `stepDef.config` (preferred \u2014 matches StepsEditor) or `stepDef.timerConfig`.\n * Enqueues a delayed timer job on the workflow-activities queue; when the job\n * is processed by the activity worker, it calls `timerHandler.fireTimer` to\n * resume the workflow.\n */\nasync function handleWaitForTimerStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const timerConfig = stepDef.config || stepDef.timerConfig || {}\n  const duration: string | undefined = timerConfig.duration\n  const until: string | undefined = timerConfig.until\n\n  if (!duration && !until) {\n    throw new StepExecutionError(\n      'WAIT_FOR_TIMER requires either \"duration\" (e.g., \"PT5M\") or \"until\" (ISO 8601 datetime)',\n      'TIMER_CONFIG_MISSING',\n      { stepId: stepDef.stepId }\n    )\n  }\n\n  let fireAtMs: number\n  if (until) {\n    const targetDate = new Date(until)\n    if (isNaN(targetDate.getTime())) {\n      throw new StepExecutionError(\n        `WAIT_FOR_TIMER invalid \"until\" datetime: ${until}`,\n        'TIMER_CONFIG_INVALID',\n        { until }\n      )\n    }\n    fireAtMs = targetDate.getTime()\n  } else {\n    fireAtMs = Date.now() + parseDuration(duration as string)\n  }\n\n  const delayMs = fireAtMs - Date.now()\n  const fireAt = new Date(fireAtMs)\n\n  // Immediate-fire path: skip the queue round-trip if the timer is in the past\n  if (delayMs <= 0) {\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: 'WAIT_FOR_TIMER',\n        timerFiredImmediately: true,\n        fireAt,\n        duration,\n        until,\n      },\n    }\n  }\n\n  const now = new Date()\n\n  // Enqueue delayed timer job via the shared activity queue.\n  // Imported here to avoid a top-level cycle between step-handler and activity-executor.\n  const { enqueueTimerJob } = await import('./activity-executor')\n  const jobId = await enqueueTimerJob({\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    branchInstanceId: branch ? branch.id : undefined,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    userId: context.userId,\n    fireAt: fireAt.toISOString(),\n    delayMs,\n  })\n\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'TIMER_AWAITING',\n    eventData: {\n      fireAt: fireAt.toISOString(),\n      duration: duration || null,\n      until: until || null,\n      jobId,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.pausedAt = now\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  return {\n    status: 'WAITING',\n    waitReason: 'TIMER',\n    outputData: {\n      fireAt,\n      duration,\n      until,\n      jobId,\n    },\n  }\n}\n\n/**\n * Handle WAIT_FOR_CONDITION step - pause until a context predicate holds.\n *\n * Evaluates the step's ConditionExpression against the token read context. A\n * predicate that already holds completes the step inline with no queue job at\n * all. Otherwise the token parks and a delayed `kind: 'condition'` poll job is\n * enqueued carrying an ABSOLUTE `deadlineAt`, so neither a slow queue nor a\n * re-enqueue can extend the configured timeout. The event-driven wake\n * (`conditionHandler.wakeConditionWaiters`) is the fast path on top of it.\n */\nasync function handleWaitForConditionStep(\n  em: EntityManager,\n  instance: WorkflowInstance,\n  stepInstance: StepInstance,\n  stepDef: any,\n  context: StepExecutionContext,\n  branch?: WorkflowBranchInstance | null\n): Promise<StepExecutionResult> {\n  const config = readWaitForConditionConfig(stepDef)\n\n  const data = {\n    ...conditionReadContext(instance, branch ?? null),\n    ...(context.workflowContext || {}),\n  }\n\n  const met = await evaluateConditionExpression({\n    condition: config.condition,\n    data,\n    instanceId: instance.id,\n    userId: context.userId,\n  })\n\n  const now = new Date()\n\n  if (met) {\n    await logWorkflowEvent(em, {\n      workflowInstanceId: instance.id,\n      stepInstanceId: stepInstance.id,\n      ...(branch ? { branchInstanceId: branch.id } : {}),\n      eventType: 'CONDITION_MET',\n      eventData: { stepId: stepDef.stepId, attempts: 1, waitedMs: 0, wokenBy: 'immediate' },\n      userId: context.userId,\n      tenantId: instance.tenantId,\n      organizationId: instance.organizationId,\n    })\n\n    return {\n      status: 'COMPLETED',\n      outputData: {\n        stepType: CONDITION_STEP_TYPE,\n        conditionMet: true,\n        attempts: 1,\n        waitedMs: 0,\n        wokenBy: 'immediate',\n      },\n    }\n  }\n\n  const deadlineAt = new Date(now.getTime() + config.timeoutMs)\n\n  const { enqueueConditionCheckJob } = await import('./activity-executor')\n  const jobId = await enqueueConditionCheckJob({\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    branchInstanceId: branch ? branch.id : undefined,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n    userId: context.userId,\n    deadlineAt: deadlineAt.toISOString(),\n    attempt: 1,\n    delayMs: Math.min(config.pollIntervalMs, config.timeoutMs),\n  })\n\n  await logWorkflowEvent(em, {\n    workflowInstanceId: instance.id,\n    stepInstanceId: stepInstance.id,\n    ...(branch ? { branchInstanceId: branch.id } : {}),\n    eventType: 'CONDITION_AWAITING',\n    eventData: {\n      stepId: stepDef.stepId,\n      condition: config.condition,\n      deadlineAt: deadlineAt.toISOString(),\n      pollIntervalMs: config.pollIntervalMs,\n      onTimeout: config.onTimeout,\n      jobId,\n    },\n    userId: context.userId,\n    tenantId: instance.tenantId,\n    organizationId: instance.organizationId,\n  })\n\n  if (branch) {\n    branch.status = 'PAUSED'\n    branch.updatedAt = now\n  } else {\n    instance.status = 'PAUSED'\n    instance.pausedAt = now\n    instance.updatedAt = now\n  }\n  await em.flush()\n\n  return {\n    status: 'WAITING',\n    waitReason: 'CONDITION',\n    outputData: {\n      stepType: CONDITION_STEP_TYPE,\n      deadlineAt: deadlineAt.toISOString(),\n      pollIntervalMs: config.pollIntervalMs,\n      onTimeout: config.onTimeout,\n      jobId,\n    },\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n// parseDuration is imported from ./duration\n\n/**\n * Log step-related event to event sourcing table\n */\nasync function logStepEvent(\n  em: EntityManager,\n  event: {\n    workflowInstanceId: string\n    stepInstanceId: string\n    branchInstanceId?: string | null\n    eventType: string\n    eventData: any\n    userId?: string\n    tenantId: string\n    organizationId: string\n  }\n): Promise<WorkflowEvent> {\n  const workflowEvent = em.create(WorkflowEvent, {\n    ...event,\n    occurredAt: new Date(),\n  })\n\n  await em.persist(workflowEvent).flush()\n  return workflowEvent\n}\n\n/**\n * Get nested value from object using dot notation\n *\n * @param obj - Source object\n * @param path - Dot-notation path (e.g., \"user.email\")\n * @returns Value at path or undefined\n */\nfunction getNestedValue(obj: any, path: string): any {\n  return path.split('.').reduce((current, key) => current?.[key], obj)\n}\n\n/**\n * Set nested value in object using dot notation\n *\n * @param obj - Target object\n * @param path - Dot-notation path (e.g., \"user.email\")\n * @param value - Value to set\n */\nfunction setNestedValue(obj: any, path: string, value: any): void {\n  const keys = path.split('.')\n  const lastKey = keys.pop()!\n  const target = keys.reduce((current, key) => {\n    if (!(key in current)) current[key] = {}\n    return current[key]\n  }, obj)\n  target[lastKey] = value\n}\n\n/**\n * Map data from source context using mapping configuration\n *\n * @param sourceContext - Source data object\n * @param mapping - Mapping configuration (targetKey -> sourcePath)\n * @returns Mapped data object\n */\nfunction mapInputData(\n  sourceContext: Record<string, any>,\n  mapping: Record<string, string>\n): Record<string, any> {\n  const result: Record<string, any> = {}\n\n  for (const [targetKey, sourcePath] of Object.entries(mapping)) {\n    const value = getNestedValue(sourceContext, sourcePath)\n    if (value !== undefined) {\n      setNestedValue(result, targetKey, value)\n    }\n  }\n\n  // If no mapping provided, pass entire context\n  return Object.keys(result).length > 0 ? result : sourceContext\n}\n\n/**\n * Map output data from child context back to parent\n *\n * @param childContext - Child workflow context\n * @param mapping - Mapping configuration (targetKey -> sourcePath)\n * @returns Mapped output data\n */\nfunction mapOutputData(\n  childContext: Record<string, any>,\n  mapping: Record<string, string>\n): Record<string, any> {\n  const result: Record<string, any> = {}\n\n  for (const [targetKey, sourcePath] of Object.entries(mapping)) {\n    const value = getNestedValue(childContext, sourcePath)\n    if (value !== undefined) {\n      setNestedValue(result, targetKey, value)\n    }\n  }\n\n  // If no mapping provided, pass entire child context\n  return Object.keys(result).length > 0 ? result : childContext\n}\n\n/**\n * Map a completed sub-workflow's child context to parent output and validate it\n * against the child's declared output ports. Shared by the synchronous\n * (inline) completion branch in `handleSubWorkflowStep` and the async parent\n * resume path so both apply identical mapping/validation rules. Returns the\n * mapped `outputData` on success or an `error` message on port-validation\n * failure (never throws).\n */\nexport function mapSubWorkflowOutput(\n  childContext: Record<string, any>,\n  outputMapping: Record<string, string>,\n  ioContract?: WorkflowIoContract\n): { outputData: Record<string, any>; error?: undefined } | { outputData?: undefined; error: string } {\n  let outputData = mapOutputData(childContext, outputMapping || {})\n\n  if (ioContract?.outputs?.length) {\n    const { coerced, errors } = validateAgainstPorts(outputData, ioContract.outputs)\n    if (errors.length > 0) {\n      return { error: `Sub-workflow output validation failed: ${errors.map((e) => e.message).join('; ')}` }\n    }\n    outputData = coerced\n  }\n\n  return { outputData }\n}\n"],
+  "mappings": "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",
+  "names": ["agentActivity"]
 }

package/dist/modules/workflows/lib/step-presentation.js

@@ -0,0 +1,147 @@
+const WORKING_INSTANCE_STATUSES = /* @__PURE__ */ new Set(["WAITING_FOR_ACTIVITIES", "FORKED", "COMPENSATING"]);
+const TERMINAL_STEP_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "skipped"]);
+function agentName(agentId, options) {
+  const id = agentId ?? options.agentId ?? null;
+  if (!id) return null;
+  return options.agentLabels?.get(id) ?? id;
+}
+function reasonFromEvidence(evidence, options) {
+  switch (evidence.kind) {
+    case "asyncActivity":
+      return {
+        state: "working",
+        reason: evidence.activityName ? { key: "workflows.runState.reason.activityRunning", fallback: "Running {activity}\u2026", params: { activity: evidence.activityName } } : { key: "workflows.runState.reason.activityRunningUnnamed", fallback: "Running an activity\u2026" }
+      };
+    case "agentRunning": {
+      const agent = agentName(evidence.agentId, options);
+      return {
+        state: "working",
+        reason: agent ? { key: "workflows.runState.reason.agentRunning", fallback: "Agent {agent} is running\u2026", params: { agent } } : { key: "workflows.runState.reason.agentRunningUnnamed", fallback: "An agent is running\u2026" }
+      };
+    }
+    case "agentDisposition":
+      return {
+        state: "waiting",
+        reason: { key: "workflows.runState.reason.agentDisposition", fallback: "Waiting for a decision on the proposal" }
+      };
+    case "subWorkflow": {
+      const child = options.childWorkflowLabel ?? evidence.childInstanceId;
+      return {
+        state: "working",
+        reason: child ? { key: "workflows.runState.reason.subWorkflow", fallback: "Waiting for {workflow}", params: { workflow: child } } : { key: "workflows.runState.reason.subWorkflowUnnamed", fallback: "Waiting for a child workflow" }
+      };
+    }
+    case "signal":
+      return {
+        state: "waiting",
+        reason: evidence.signalName ? { key: "workflows.runState.reason.signal", fallback: "Waiting for signal {signal}", params: { signal: evidence.signalName } } : { key: "workflows.runState.reason.signalUnnamed", fallback: "Waiting for a signal" }
+      };
+    case "timer":
+      return {
+        state: "waiting",
+        reason: evidence.fireAt ? { key: "workflows.runState.reason.timer", fallback: "Waiting until {time}", params: { time: evidence.fireAt.toLocaleString() } } : { key: "workflows.runState.reason.timerUnnamed", fallback: "Waiting for a timer" }
+      };
+    case "condition":
+      return {
+        state: "waiting",
+        reason: evidence.deadlineAt ? { key: "workflows.runState.reason.conditionUntil", fallback: "Waiting for a condition, until {time}", params: { time: evidence.deadlineAt.toLocaleString() } } : { key: "workflows.runState.reason.condition", fallback: "Waiting for a condition" }
+      };
+    case "userTask":
+      return {
+        state: "waiting",
+        reason: evidence.roleQueue ? { key: "workflows.runState.reason.userTaskQueue", fallback: "Waiting for {queue}", params: { queue: evidence.roleQueue } } : evidence.hasAssignee ? { key: "workflows.runState.reason.userTaskAssignee", fallback: "Waiting for the assignee" } : { key: "workflows.runState.reason.userTask", fallback: "Waiting for a person" }
+      };
+    case "fork": {
+      const running = Math.max(evidence.branchTotal - evidence.branchesSettled, 0);
+      return {
+        state: "working",
+        reason: {
+          key: "workflows.runState.reason.fork",
+          fallback: "{running} of {total} branches still running",
+          params: { running, total: evidence.branchTotal }
+        }
+      };
+    }
+  }
+}
+function resolveStepPresentation(execution, node, options = {}) {
+  const state = execution.stepStates.get(node.id) ?? null;
+  const startedAt = state?.startedAt ?? null;
+  if (TERMINAL_STEP_STATUSES.has(node.status)) {
+    return { state: node.status, reason: null, startedAt, animated: false };
+  }
+  if (node.status === "pending") {
+    return { state: "not_started", reason: null, startedAt: null, animated: false };
+  }
+  const isCurrentStep = execution.currentStepId === node.id;
+  if (execution.attention && isCurrentStep) {
+    return {
+      state: "attention",
+      reason: { key: "workflows.runState.reason.attention", fallback: "Parked for attention" },
+      startedAt,
+      animated: false
+    };
+  }
+  const evidence = execution.waits.get(node.id);
+  if (evidence) {
+    const resolved = reasonFromEvidence(evidence, options);
+    return {
+      state: resolved.state,
+      reason: resolved.reason,
+      startedAt,
+      animated: resolved.state === "working"
+    };
+  }
+  const instanceStatus = execution.instanceStatus ?? null;
+  if (instanceStatus && WORKING_INSTANCE_STATUSES.has(instanceStatus)) {
+    return { state: "working", reason: null, startedAt, animated: true };
+  }
+  if (node.status === "paused") {
+    return { state: "waiting", reason: null, startedAt, animated: false };
+  }
+  return { state: "working", reason: null, startedAt, animated: true };
+}
+function readNodeAgentId(data) {
+  if (!data || typeof data !== "object") return null;
+  const record = data;
+  if (typeof record.agentId === "string" && record.agentId.length > 0) return record.agentId;
+  const activities = record.activities;
+  if (!Array.isArray(activities)) return null;
+  for (const activity of activities) {
+    if (!activity || typeof activity !== "object") continue;
+    const entry = activity;
+    if (entry.activityType !== "INVOKE_AGENT") continue;
+    const config = entry.config;
+    if (!config || typeof config !== "object") continue;
+    const agentId = config.agentId;
+    if (typeof agentId === "string" && agentId.length > 0) return agentId;
+  }
+  return null;
+}
+function presentationToWorkflowStatus(state) {
+  switch (state) {
+    case "working":
+      return "working";
+    case "waiting":
+      return "waiting";
+    case "attention":
+      return "needs_attention";
+    case "completed":
+      return "completed";
+    case "failed":
+      return "failed";
+    // Deliberately unchanged: `toWorkflowStatus` has always painted a skipped
+    // step as the resting state, and repainting it belongs to Part 1's verdict
+    // work, not to the working-vs-waiting split.
+    case "skipped":
+      return "not_started";
+    case "not_started":
+      return "not_started";
+  }
+}
+export {
+  presentationToWorkflowStatus,
+  readNodeAgentId,
+  resolveStepPresentation
+};
+//# sourceMappingURL=step-presentation.js.map

package/dist/modules/workflows/lib/step-presentation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/step-presentation.ts"],
+  "sourcesContent": ["/**\n * Step presentation model (spec `2026-07-30-workflow-run-outcomes.md`, Part 2) \u2014 PURE.\n *\n * The canvas used to paint the ENGINE's lifecycle vocabulary, which was built\n * for control flow rather than for reading. `WAITING_FOR_ACTIVITIES` means \"the\n * executor handed work to a queue and will resume when it returns\" \u2014 that is the\n * engine WORKING, and painting it as an amber pause was the single most\n * misleading thing on the run views.\n *\n * The rule this module encodes: **amber means blocked on the outside world. If\n * the system is doing work it is blue and it moves.**\n *\n * Derived, never stored. No new column, no new engine event: every input is\n * either a `StepInstance` row, a `WorkflowEvent` row, the instance status or the\n * engine-owned `metadata.attention` marker. `lib/run-execution.ts` collects the\n * evidence; this decides what it MEANS. No React, no ORM, no DI \u2014 the same rule\n * `lib/node-outcome-rows.ts` and `lib/breach-routing.ts` follow.\n */\n\nimport type { RunExecution, StepWaitEvidence } from './run-execution'\nimport type { WorkflowStatus } from './status-colors'\n\nexport type StepPresentationState =\n  /** The system is doing something right now. Blue, and it moves. */\n  | 'working'\n  /** Blocked on something OUTSIDE the system: a person, a timer, a signal. */\n  | 'waiting'\n  /** Parked in the failure queue or breached. Needs a human, unusually. */\n  | 'attention'\n  | 'completed'\n  | 'failed'\n  | 'skipped'\n  | 'not_started'\n\n/**\n * A translation descriptor rather than a string: this module is pure and has no\n * `useT`, and the caller is the only one that knows the viewer's locale.\n */\nexport type StepReason = {\n  key: string\n  fallback: string\n  params?: Record<string, string | number>\n}\n\nexport type StepPresentation = {\n  state: StepPresentationState\n  /** One line saying what the step is doing or waiting for. */\n  reason: StepReason | null\n  /**\n   * When the CURRENT attempt began, so a working step can say \"running for 4m\".\n   * `StepInstance.startedAt` already carries it, hence the spec's \"it is free\".\n   */\n  startedAt: Date | null\n  /** Whether this state deserves motion. Motion is still gated on `prefers-reduced-motion`. */\n  animated: boolean\n}\n\n/**\n * Instance statuses in which the ENGINE is working, whatever the step row says.\n *\n * - `WAITING_FOR_ACTIVITIES` \u2014 an async activity is executing in a worker.\n * - `FORKED` \u2014 `openFork` wrote the branch rows and `advanceBranches` drives\n *   them on the executor loop's next iteration. `FORK` is the one `waitReason`\n *   the engine itself does not treat as a park (`lib/transition-handler.ts`\n *   excludes it from `stepPaused`), and it is not an external park here either.\n * - `COMPENSATING` \u2014 the saga is unwinding, which is work.\n */\nconst WORKING_INSTANCE_STATUSES = new Set(['WAITING_FOR_ACTIVITIES', 'FORKED', 'COMPENSATING'])\n\nconst TERMINAL_STEP_STATUSES = new Set(['completed', 'failed', 'skipped'])\n\nexport type StepPresentationOptions = {\n  /**\n   * Agent id \u2192 author-facing label, from the OPTIONAL `agent_orchestrator`\n   * peer's registry. Use the agent's LABEL, never its definition key \u2014 an\n   * existing rule in this module. Absent (peer not installed, request failed)\n   * degrades to the id rather than inventing a name.\n   */\n  agentLabels?: ReadonlyMap<string, string>\n  /** The `INVOKE_AGENT` activity's configured agent id, read off the node. */\n  agentId?: string | null\n  /** Child-workflow label for the sub-workflow line, when the caller knows one. */\n  childWorkflowLabel?: string | null\n}\n\nfunction agentName(\n  agentId: string | null | undefined,\n  options: StepPresentationOptions,\n): string | null {\n  const id = agentId ?? options.agentId ?? null\n  if (!id) return null\n  return options.agentLabels?.get(id) ?? id\n}\n\nfunction reasonFromEvidence(\n  evidence: StepWaitEvidence,\n  options: StepPresentationOptions,\n): { state: StepPresentationState; reason: StepReason } {\n  switch (evidence.kind) {\n    case 'asyncActivity':\n      return {\n        state: 'working',\n        reason: evidence.activityName\n          ? { key: 'workflows.runState.reason.activityRunning', fallback: 'Running {activity}\u2026', params: { activity: evidence.activityName } }\n          : { key: 'workflows.runState.reason.activityRunningUnnamed', fallback: 'Running an activity\u2026' },\n      }\n    case 'agentRunning': {\n      // THE reported bug: an agent executing in its own worker is the system\n      // working, and it used to paint the same amber pause as a task nobody has\n      // opened since Tuesday.\n      const agent = agentName(evidence.agentId, options)\n      return {\n        state: 'working',\n        reason: agent\n          ? { key: 'workflows.runState.reason.agentRunning', fallback: 'Agent {agent} is running\u2026', params: { agent } }\n          : { key: 'workflows.runState.reason.agentRunningUnnamed', fallback: 'An agent is running\u2026' },\n      }\n    }\n    case 'agentDisposition':\n      return {\n        state: 'waiting',\n        reason: { key: 'workflows.runState.reason.agentDisposition', fallback: 'Waiting for a decision on the proposal' },\n      }\n    case 'subWorkflow': {\n      // A running child IS the system working (spec's Working row), even though\n      // the line says what it is waiting on.\n      const child = options.childWorkflowLabel ?? evidence.childInstanceId\n      return {\n        state: 'working',\n        reason: child\n          ? { key: 'workflows.runState.reason.subWorkflow', fallback: 'Waiting for {workflow}', params: { workflow: child } }\n          : { key: 'workflows.runState.reason.subWorkflowUnnamed', fallback: 'Waiting for a child workflow' },\n      }\n    }\n    case 'signal':\n      return {\n        state: 'waiting',\n        reason: evidence.signalName\n          ? { key: 'workflows.runState.reason.signal', fallback: 'Waiting for signal {signal}', params: { signal: evidence.signalName } }\n          : { key: 'workflows.runState.reason.signalUnnamed', fallback: 'Waiting for a signal' },\n      }\n    case 'timer':\n      return {\n        state: 'waiting',\n        reason: evidence.fireAt\n          ? { key: 'workflows.runState.reason.timer', fallback: 'Waiting until {time}', params: { time: evidence.fireAt.toLocaleString() } }\n          : { key: 'workflows.runState.reason.timerUnnamed', fallback: 'Waiting for a timer' },\n      }\n    case 'condition':\n      return {\n        state: 'waiting',\n        reason: evidence.deadlineAt\n          ? { key: 'workflows.runState.reason.conditionUntil', fallback: 'Waiting for a condition, until {time}', params: { time: evidence.deadlineAt.toLocaleString() } }\n          : { key: 'workflows.runState.reason.condition', fallback: 'Waiting for a condition' },\n      }\n    case 'userTask':\n      // The role queue is definition data every viewer of the run already reads\n      // off the canvas. An individual assignee is NEVER named here: \u00A76.4 owns\n      // that decision, and the run APIs expose an opaque user id with no display\n      // name, so there is nothing honest to render anyway.\n      return {\n        state: 'waiting',\n        reason: evidence.roleQueue\n          ? { key: 'workflows.runState.reason.userTaskQueue', fallback: 'Waiting for {queue}', params: { queue: evidence.roleQueue } }\n          : evidence.hasAssignee\n            ? { key: 'workflows.runState.reason.userTaskAssignee', fallback: 'Waiting for the assignee' }\n            : { key: 'workflows.runState.reason.userTask', fallback: 'Waiting for a person' },\n      }\n    case 'fork': {\n      const running = Math.max(evidence.branchTotal - evidence.branchesSettled, 0)\n      return {\n        state: 'working',\n        reason: {\n          key: 'workflows.runState.reason.fork',\n          fallback: '{running} of {total} branches still running',\n          params: { running, total: evidence.branchTotal },\n        },\n      }\n    }\n  }\n}\n\n/**\n * Resolve the presentation for one node of the run graph.\n *\n * `status` is the already-resolved `StepRunStatus` for the node (from\n * `resolveNodeRunStatus`), which keeps the START/END conventions in one place.\n */\nexport function resolveStepPresentation(\n  execution: RunExecution,\n  node: { id: string; status: string },\n  options: StepPresentationOptions = {},\n): StepPresentation {\n  const state = execution.stepStates.get(node.id) ?? null\n  const startedAt = state?.startedAt ?? null\n\n  if (TERMINAL_STEP_STATUSES.has(node.status)) {\n    return { state: node.status as StepPresentationState, reason: null, startedAt, animated: false }\n  }\n  if (node.status === 'pending') {\n    return { state: 'not_started', reason: null, startedAt: null, animated: false }\n  }\n\n  const isCurrentStep = execution.currentStepId === node.id\n\n  // Attention outranks everything non-terminal: it is the one state that says\n  // \"a human is needed, and not in the ordinary way\".\n  if (execution.attention && isCurrentStep) {\n    return {\n      state: 'attention',\n      reason: { key: 'workflows.runState.reason.attention', fallback: 'Parked for attention' },\n      startedAt,\n      animated: false,\n    }\n  }\n\n  const evidence = execution.waits.get(node.id)\n  if (evidence) {\n    const resolved = reasonFromEvidence(evidence, options)\n    return {\n      state: resolved.state,\n      reason: resolved.reason,\n      startedAt,\n      animated: resolved.state === 'working',\n    }\n  }\n\n  // No park evidence, so the instance status is the next-best witness. A queue\n  // hand-off, a fork or a compensation pass are the engine WORKING; anything\n  // else that parked the step is a wait we simply cannot name, and saying\n  // nothing is better than guessing a reason.\n  const instanceStatus = execution.instanceStatus ?? null\n  if (instanceStatus && WORKING_INSTANCE_STATUSES.has(instanceStatus)) {\n    return { state: 'working', reason: null, startedAt, animated: true }\n  }\n  // `node.status === 'paused'` is `applyLiveInstanceStatus` reporting that the\n  // engine parked THIS step. Without evidence there is nothing to name, but the\n  // park itself is real, so it is amber rather than optimistically blue.\n  if (node.status === 'paused') {\n    return { state: 'waiting', reason: null, startedAt, animated: false }\n  }\n  return { state: 'working', reason: null, startedAt, animated: true }\n}\n\n/**\n * The `INVOKE_AGENT` agent id as the canvas carries it. `invokeAgent` nodes hold\n * it either directly (the editor's display field) or inside the single\n * INVOKE_AGENT activity they compile to \u2014 `InvokeAgentNode` resolves it the same\n * two ways, so the reason line reads the same value the card already shows.\n */\nexport function readNodeAgentId(data: unknown): string | null {\n  if (!data || typeof data !== 'object') return null\n  const record = data as Record<string, unknown>\n  if (typeof record.agentId === 'string' && record.agentId.length > 0) return record.agentId\n  const activities = record.activities\n  if (!Array.isArray(activities)) return null\n  for (const activity of activities) {\n    if (!activity || typeof activity !== 'object') continue\n    const entry = activity as Record<string, unknown>\n    if (entry.activityType !== 'INVOKE_AGENT') continue\n    const config = entry.config\n    if (!config || typeof config !== 'object') continue\n    const agentId = (config as Record<string, unknown>).agentId\n    if (typeof agentId === 'string' && agentId.length > 0) return agentId\n  }\n  return null\n}\n\n/**\n * Map a presentation state onto the canvas paint vocabulary. Kept separate from\n * the resolver so the decision stays testable without a colour table, and so a\n * surface that paints differently (a list badge, a timeline bar) can reuse the\n * same states.\n */\nexport function presentationToWorkflowStatus(state: StepPresentationState): WorkflowStatus {\n  switch (state) {\n    case 'working':\n      return 'working'\n    case 'waiting':\n      return 'waiting'\n    case 'attention':\n      return 'needs_attention'\n    case 'completed':\n      return 'completed'\n    case 'failed':\n      return 'failed'\n    // Deliberately unchanged: `toWorkflowStatus` has always painted a skipped\n    // step as the resting state, and repainting it belongs to Part 1's verdict\n    // work, not to the working-vs-waiting split.\n    case 'skipped':\n      return 'not_started'\n    case 'not_started':\n      return 'not_started'\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/workflows/lib/step-through.js

@@ -0,0 +1,26 @@
+function isStepThroughArmed(instance) {
+  return instance?.metadata?.stepThrough?.enabled === true;
+}
+function shouldPauseForStepThrough(instance, stepId, stepType) {
+  if (!isStepThroughArmed(instance)) return false;
+  if (stepType === "END") return false;
+  if (!stepId) return false;
+  return instance?.metadata?.stepThrough?.releaseStepId !== stepId;
+}
+function consumeStepThroughRelease() {
+  return { enabled: true, releaseStepId: null };
+}
+function releaseStepThrough(stepId) {
+  return { enabled: true, releaseStepId: stepId };
+}
+const STEP_THROUGH_EVENT_TYPE = "STEP_THROUGH_PAUSED";
+const STEP_THROUGH_RELEASED_EVENT_TYPE = "STEP_THROUGH_RELEASED";
+export {
+  STEP_THROUGH_EVENT_TYPE,
+  STEP_THROUGH_RELEASED_EVENT_TYPE,
+  consumeStepThroughRelease,
+  isStepThroughArmed,
+  releaseStepThrough,
+  shouldPauseForStepThrough
+};
+//# sourceMappingURL=step-through.js.map

package/dist/modules/workflows/lib/step-through.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/step-through.ts"],
+  "sourcesContent": ["/**\n * Workflows Module \u2014 Step-through (spec section 8.2)\n *\n * *\"Pause at each step on test runs \u2014 inspect context, continue/abort, canvas\n * highlights the active node.\"*\n *\n * Deliberately implemented as an INSTANCE-level `PAUSED` between steps, using\n * the existing status and an engine-owned metadata marker \u2014 the same shape the\n * `failureQueue` directive already uses. It introduces NO new instance status\n * and NO new step status, so the workflow and step state machines are untouched\n * (`AGENTS.md` Ask-First).\n *\n * The marker is a RELEASE TOKEN, not a \"paused\" boolean: the author releases one\n * named step, the engine runs exactly that step, and the cursor landing anywhere\n * else pauses again. That makes the decision idempotent \u2014 replaying\n * `executeWorkflow` after a crash cannot run a step the author never released,\n * and a double-click on Continue cannot run two steps.\n *\n * PURE: no ORM, no DI, no React.\n */\n\nexport type WorkflowInstanceStepThrough = {\n  enabled: true\n  /**\n   * The one step the author has authorised to run. `null`/absent means the\n   * engine is parked before the current step and waiting for a Continue.\n   */\n  releaseStepId?: string | null\n}\n\ntype StepThroughAwareInstance = {\n  metadata?: { stepThrough?: WorkflowInstanceStepThrough | null } | null\n  currentStepId?: string | null\n}\n\nexport function isStepThroughArmed(instance: StepThroughAwareInstance | null | undefined): boolean {\n  return instance?.metadata?.stepThrough?.enabled === true\n}\n\n/**\n * Should the engine stop before executing `stepId`?\n *\n * END is deliberately exempt: it executes nothing, and holding a run one click\n * short of COMPLETED would leave every finished step-through looking parked.\n */\nexport function shouldPauseForStepThrough(\n  instance: StepThroughAwareInstance | null | undefined,\n  stepId: string | null | undefined,\n  stepType: string | null | undefined,\n): boolean {\n  if (!isStepThroughArmed(instance)) return false\n  if (stepType === 'END') return false\n  if (!stepId) return false\n  return instance?.metadata?.stepThrough?.releaseStepId !== stepId\n}\n\n/**\n * Consume the release token once the released step has been entered, so the\n * NEXT step pauses again. Returns the marker to persist.\n */\nexport function consumeStepThroughRelease(): WorkflowInstanceStepThrough {\n  return { enabled: true, releaseStepId: null }\n}\n\n/** Authorise exactly `stepId` to run. */\nexport function releaseStepThrough(stepId: string): WorkflowInstanceStepThrough {\n  return { enabled: true, releaseStepId: stepId }\n}\n\nexport const STEP_THROUGH_EVENT_TYPE = 'STEP_THROUGH_PAUSED'\nexport const STEP_THROUGH_RELEASED_EVENT_TYPE = 'STEP_THROUGH_RELEASED'\n"],
+  "mappings": "AAmCO,SAAS,mBAAmB,UAAgE;AACjG,SAAO,UAAU,UAAU,aAAa,YAAY;AACtD;AAQO,SAAS,0BACd,UACA,QACA,UACS;AACT,MAAI,CAAC,mBAAmB,QAAQ,EAAG,QAAO;AAC1C,MAAI,aAAa,MAAO,QAAO;AAC/B,MAAI,CAAC,OAAQ,QAAO;AACpB,SAAO,UAAU,UAAU,aAAa,kBAAkB;AAC5D;AAMO,SAAS,4BAAyD;AACvE,SAAO,EAAE,SAAS,MAAM,eAAe,KAAK;AAC9C;AAGO,SAAS,mBAAmB,QAA6C;AAC9E,SAAO,EAAE,SAAS,MAAM,eAAe,OAAO;AAChD;AAEO,MAAM,0BAA0B;AAChC,MAAM,mCAAmC;",
+  "names": []
+}