@open-mercato/core 0.6.5-develop.4516.1.88e6ab71a9 → 0.6.5-develop.4534.1.b459babe6d

package/dist/modules/workflows/lib/activity-executor.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/activity-executor.ts"],
-  "sourcesContent": ["/**\n * Workflows Module - Activity Executor Service\n *\n * Executes workflow activities (send email, call API, emit events, etc.)\n * - Supports multiple activity types\n * - Implements retry logic with exponential backoff\n * - Handles timeouts\n * - Variable interpolation from workflow context\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport type { EntityManager as PostgreSqlEntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport { WorkflowInstance } from '../data/entities'\nimport { createModuleQueue, Queue } from '@open-mercato/queue'\nimport { getRedisUrl } from '@open-mercato/shared/lib/redis/connection'\nimport {\n  safeOutboundFetch,\n  UnsafeOutboundUrlError,\n  type HostLookup,\n} from '@open-mercato/shared/lib/url-safety'\nimport { parseBooleanWithDefault } from '@open-mercato/shared/lib/boolean'\nimport { callWebhookConfigSchema } from '../data/validators'\nimport { WorkflowActivityJob, WORKFLOW_ACTIVITIES_QUEUE_NAME } from './activity-queue-types'\nimport { logWorkflowEvent } from './event-logger'\nimport { parseDuration } from './duration'\n\nexport { isPrivateUrl } from '@open-mercato/shared/lib/network'\n\nfunction isAllowPrivateWorkflowWebhookUrlsEnabled(): boolean {\n  if (parseBooleanWithDefault(process.env.OM_WORKFLOWS_ALLOW_PRIVATE_URLS, false)) {\n    return true\n  }\n\n  if (parseBooleanWithDefault(process.env.WORKFLOW_WEBHOOK_ALLOW_PRIVATE_URLS, false)) {\n    console.warn(\n      '[CALL_WEBHOOK] WORKFLOW_WEBHOOK_ALLOW_PRIVATE_URLS is deprecated. Use OM_WORKFLOWS_ALLOW_PRIVATE_URLS instead. SSRF protection is bypassed.'\n    )\n    return true\n  }\n\n  return false\n}\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport type ActivityType =\n  | 'SEND_EMAIL'\n  | 'CALL_API'\n  | 'EMIT_EVENT'\n  | 'UPDATE_ENTITY'\n  | 'CALL_WEBHOOK'\n  | 'EXECUTE_FUNCTION'\n  | 'WAIT'\n\nexport interface ActivityDefinition {\n  activityId: string // Unique identifier for activity\n  activityName?: string // Optional, for debugging/logging\n  activityType: ActivityType\n  config: any\n  async?: boolean // Flag to execute activity asynchronously via queue\n  retryPolicy?: RetryPolicy\n  timeoutMs?: number\n  compensate?: boolean // Flag to execute compensation on failure\n}\n\nexport interface RetryPolicy {\n  maxAttempts: number\n  initialIntervalMs: number\n  backoffCoefficient: number\n  maxIntervalMs: number\n}\n\nexport interface ActivityContext {\n  workflowInstance: WorkflowInstance\n  workflowContext: Record<string, any>\n  stepContext?: Record<string, any>\n  stepInstanceId?: string\n  transitionId?: string\n  userId?: string\n}\n\nexport interface ActivityExecutionResult {\n  activityId: string\n  activityName?: string\n  activityType: ActivityType\n  success: boolean\n  output?: any\n  error?: string\n  retryCount: number\n  executionTimeMs: number\n  async?: boolean // Marks activity as async (queued)\n  jobId?: string // Queue job ID for async activities\n}\n\nexport class ActivityExecutionError extends Error {\n  constructor(\n    message: string,\n    public activityType: ActivityType,\n    public activityName?: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'ActivityExecutionError'\n  }\n}\n\n// ============================================================================\n// Queue Integration for Async Activities\n// ============================================================================\n\nlet activityQueue: Queue<WorkflowActivityJob> | null = null\n\n/**\n * Get or create the activity queue (lazy initialization)\n */\nfunction getActivityQueue(): Queue<WorkflowActivityJob> {\n  if (!activityQueue) {\n    activityQueue = createModuleQueue<WorkflowActivityJob>(\n      WORKFLOW_ACTIVITIES_QUEUE_NAME,\n      { concurrency: parseInt(process.env.WORKFLOW_WORKER_CONCURRENCY || '5') },\n    )\n  }\n\n  return activityQueue\n}\n\n/**\n * Enqueue an activity for background execution\n *\n * @param em - Entity manager\n * @param activity - Activity definition\n * @param context - Execution context\n * @returns Job ID\n */\nexport async function enqueueActivity(\n  em: EntityManager,\n  activity: ActivityDefinition,\n  context: ActivityContext\n): Promise<string> {\n  const { workflowInstance, workflowContext, stepContext, transitionId, stepInstanceId } =\n    context\n\n  // Interpolate config variables NOW (before queuing)\n  const interpolatedConfig = interpolateVariables(activity.config, workflowContext, workflowInstance)\n\n  // Create job payload\n  const job: WorkflowActivityJob = {\n    workflowInstanceId: workflowInstance.id,\n    stepInstanceId,\n    transitionId,\n    activityId: activity.activityId,\n    activityName: activity.activityName || activity.activityType,\n    activityType: activity.activityType,\n    activityConfig: interpolatedConfig,\n    workflowContext,\n    stepContext,\n    retryPolicy: activity.retryPolicy,\n    timeoutMs: activity.timeoutMs,\n    tenantId: workflowInstance.tenantId,\n    organizationId: workflowInstance.organizationId,\n    userId: context.userId,\n  }\n\n  // Enqueue to queue (WAIT activities use delayMs for the actual delay)\n  const queue = getActivityQueue()\n  const enqueueOptions = activity.activityType === 'WAIT' && (interpolatedConfig.duration || interpolatedConfig.until)\n    ? { delayMs: calculateWaitDelayMs(interpolatedConfig) }\n    : undefined\n  const jobId = await queue.enqueue(job, enqueueOptions)\n\n  // Log event\n  await logWorkflowEvent(em, {\n    workflowInstanceId: workflowInstance.id,\n    stepInstanceId,\n    eventType: 'ACTIVITY_QUEUED',\n    eventData: {\n      activityId: activity.activityId,\n      activityName: activity.activityName,\n      activityType: activity.activityType,\n      async: true,\n      jobId,\n    },\n    tenantId: workflowInstance.tenantId,\n    organizationId: workflowInstance.organizationId,\n  })\n\n  return jobId\n}\n\n/**\n * Enqueue a delayed timer job for a WAIT_FOR_TIMER step.\n *\n * The activity worker handles `kind: 'timer'` jobs by calling\n * `timerHandler.fireTimer`, which resumes the paused workflow instance.\n */\nexport async function enqueueTimerJob(params: {\n  workflowInstanceId: string\n  stepInstanceId: string\n  tenantId: string\n  organizationId: string\n  userId?: string\n  fireAt: string\n  delayMs: number\n}): Promise<string> {\n  const { workflowInstanceId, stepInstanceId, tenantId, organizationId, userId, fireAt, delayMs } =\n    params\n\n  const queue = getActivityQueue()\n  const jobId = await queue.enqueue(\n    {\n      kind: 'timer',\n      workflowInstanceId,\n      stepInstanceId,\n      tenantId,\n      organizationId,\n      userId,\n      fireAt,\n    },\n    { delayMs: delayMs > 0 ? delayMs : undefined }\n  )\n\n  return jobId\n}\n\n// ============================================================================\n// Main Activity Execution Functions\n// ============================================================================\n\n/**\n * Execute a single activity with retry logic and timeout\n *\n * @param em - Entity manager\n * @param container - DI container\n * @param activity - Activity definition\n * @param context - Execution context\n * @returns Execution result\n */\nexport async function executeActivity(\n  em: EntityManager,\n  container: AwilixContainer,\n  activity: ActivityDefinition,\n  context: ActivityContext\n): Promise<ActivityExecutionResult> {\n  const retryPolicy = activity.retryPolicy || {\n    maxAttempts: 1,\n    initialIntervalMs: 0,\n    backoffCoefficient: 1,\n    maxIntervalMs: 0,\n  }\n\n  let lastError: any\n  let retryCount = 0\n\n  for (let attempt = 0; attempt < retryPolicy.maxAttempts; attempt++) {\n    try {\n      const startTime = Date.now()\n\n      // Execute with timeout if specified\n      const result = activity.timeoutMs\n        ? await executeWithTimeout(\n            () => executeActivityByType(em, container, activity, context),\n            activity.timeoutMs\n          )\n        : await executeActivityByType(em, container, activity, context)\n\n      const executionTimeMs = Date.now() - startTime\n\n      return {\n        activityId: activity.activityId,\n        activityName: activity.activityName,\n        activityType: activity.activityType,\n        success: true,\n        output: result,\n        retryCount: attempt,\n        executionTimeMs,\n        async: activity.async || false,\n      }\n    } catch (error) {\n      lastError = error\n      retryCount = attempt + 1\n\n      // Log activity retry attempt with context\n      if (attempt < retryPolicy.maxAttempts - 1) {\n        console.error(`[WORKFLOW] Activity ${activity.activityId} (${activity.activityType}) failed on attempt ${attempt + 1}/${retryPolicy.maxAttempts} (instance: ${context.workflowInstance.id}):`, error instanceof Error ? error.message : error)\n      }\n\n      // If not the last attempt, apply backoff and retry\n      if (attempt < retryPolicy.maxAttempts - 1) {\n        const backoff = calculateBackoff(\n          retryPolicy.initialIntervalMs,\n          retryPolicy.backoffCoefficient,\n          attempt,\n          retryPolicy.maxIntervalMs\n        )\n\n        await sleep(backoff)\n      }\n    }\n  }\n\n  // All retries exhausted\n  const errorMessage = lastError instanceof Error ? lastError.message : String(lastError)\n  console.error(`[WORKFLOW] Activity ${activity.activityId} (${activity.activityType}) failed after ${retryCount} attempts (instance: ${context.workflowInstance.id}): ${errorMessage}`)\n  if (lastError instanceof Error && lastError.stack) {\n    console.error('[WORKFLOW] Activity error stack:', lastError.stack)\n  }\n\n  return {\n    activityId: activity.activityId,\n    activityName: activity.activityName,\n    activityType: activity.activityType,\n    success: false,\n    error: `Activity failed after ${retryCount} attempts: ${errorMessage}`,\n    retryCount,\n    executionTimeMs: 0,\n    async: activity.async || false,\n  }\n}\n\n/**\n * Execute multiple activities in sequence\n * Supports both synchronous and asynchronous (queued) execution\n *\n * @param em - Entity manager\n * @param container - DI container\n * @param activities - Array of activity definitions\n * @param context - Execution context\n * @returns Array of execution results\n */\nexport async function executeActivities(\n  em: EntityManager,\n  container: AwilixContainer,\n  activities: ActivityDefinition[],\n  context: ActivityContext\n): Promise<ActivityExecutionResult[]> {\n  const results: ActivityExecutionResult[] = []\n\n  for (let i = 0; i < activities.length; i++) {\n    const activity = activities[i]\n\n    // Check if activity should run async\n    if (activity.async) {\n      // Enqueue for background execution\n      const jobId = await enqueueActivity(em, activity, context)\n\n      results.push({\n        activityId: activity.activityId,\n        activityName: activity.activityName,\n        activityType: activity.activityType,\n        success: true, // Queued successfully\n        async: true,\n        jobId,\n        retryCount: 0,\n        executionTimeMs: 0,\n      })\n    } else {\n      // Execute synchronously (existing logic)\n      const result = await executeActivity(em, container, activity, context)\n      results.push(result)\n\n      // Stop execution if activity fails (fail-fast)\n      if (!result.success) {\n        break\n      }\n\n      // Update workflow context with activity output\n      if (result.output && typeof result.output === 'object') {\n        const key = activity.activityName || activity.activityType\n        context.workflowContext = {\n          ...context.workflowContext,\n          [key]: result.output,\n        }\n      }\n    }\n  }\n\n  return results\n}\n\n// ============================================================================\n// Activity Type Handlers\n// ============================================================================\n\n/**\n * Execute activity based on its type\n */\nasync function executeActivityByType(\n  em: EntityManager,\n  container: AwilixContainer,\n  activity: ActivityDefinition,\n  context: ActivityContext\n): Promise<any> {\n  // Interpolate config variables from context (including workflow metadata)\n  const interpolatedConfig = interpolateVariables(activity.config, context.workflowContext, context.workflowInstance)\n\n  switch (activity.activityType) {\n    case 'SEND_EMAIL':\n      return await executeSendEmail(interpolatedConfig, context, container)\n\n    case 'CALL_API':\n      return await executeCallApi(em, interpolatedConfig, context, container)\n\n    case 'EMIT_EVENT':\n      return await executeEmitEvent(interpolatedConfig, context, container)\n\n    case 'UPDATE_ENTITY':\n      return await executeUpdateEntity(em, interpolatedConfig, context, container)\n\n    case 'CALL_WEBHOOK':\n      return await executeCallWebhook(interpolatedConfig, context)\n\n    case 'EXECUTE_FUNCTION':\n      return await executeFunction(interpolatedConfig, context, container)\n\n    case 'WAIT':\n      return await executeWait(interpolatedConfig)\n\n    default:\n      throw new ActivityExecutionError(\n        `Unknown activity type: ${activity.activityType}`,\n        activity.activityType,\n        activity.activityName\n      )\n  }\n}\n\n/**\n * SEND_EMAIL activity handler\n *\n * For MVP, this logs the email (actual email sending can be added later)\n */\nexport async function executeSendEmail(\n  config: any,\n  context: ActivityContext,\n  container: AwilixContainer\n): Promise<any> {\n  const { to, subject, template, templateData, body } = config\n\n  if (!to || !subject) {\n    throw new Error('SEND_EMAIL requires \"to\" and \"subject\" fields')\n  }\n\n  // For MVP: Log the email (actual email service integration can be added later)\n  console.log(`[Workflow Activity] Send email to ${to}: ${subject}`)\n\n  // Check if email service is available in container\n  try {\n    const emailService = container.resolve<{ send: (input: unknown) => Promise<unknown> | unknown }>('emailService')\n    if (emailService && typeof emailService.send === 'function') {\n      await emailService.send({\n        to,\n        subject,\n        template,\n        templateData,\n        body,\n      })\n      return { sent: true, to, subject, via: 'emailService' }\n    }\n  } catch (error) {\n    // Email service not available, just log\n  }\n\n  return { sent: true, to, subject, via: 'console' }\n}\n\n/**\n * EMIT_EVENT activity handler\n *\n * Publishes a domain event to the event bus\n */\nexport async function executeEmitEvent(\n  config: any,\n  context: ActivityContext,\n  container: AwilixContainer\n): Promise<any> {\n  const { eventName, payload } = config\n\n  if (!eventName) {\n    throw new Error('EMIT_EVENT requires \"eventName\" field')\n  }\n\n  // Get event bus from container\n  const eventBus = container.resolve<{ emitEvent: (event: string, payload: unknown, options?: unknown) => Promise<unknown> | unknown }>('eventBus')\n\n  if (!eventBus || typeof eventBus.emitEvent !== 'function') {\n    throw new Error('Event bus not available in container')\n  }\n\n  // Publish event with workflow metadata\n  const enrichedPayload = {\n    ...payload,\n    _workflow: {\n      workflowInstanceId: context.workflowInstance.id,\n      workflowId: context.workflowInstance.workflowId,\n      tenantId: context.workflowInstance.tenantId,\n      organizationId: context.workflowInstance.organizationId,\n    },\n  }\n\n  await eventBus.emitEvent(eventName, enrichedPayload, {\n    tenantId: context.workflowInstance.tenantId,\n    organizationId: context.workflowInstance.organizationId,\n  })\n\n  return { emitted: true, eventName, payload: enrichedPayload }\n}\n\n/**\n * UPDATE_ENTITY activity handler\n *\n * Updates an entity via CommandBus for proper audit logging, undo support, and side effects.\n *\n * Config format:\n * ```json\n * {\n *   \"commandId\": \"sales.documents.update\",\n *   \"input\": {\n *     \"id\": \"{{context.orderId}}\",\n *     \"statusEntryId\": \"{{context.approvedStatusId}}\"\n *   }\n * }\n * ```\n *\n * Alternative format with statusValue (auto-resolves to statusEntryId):\n * ```json\n * {\n *   \"commandId\": \"sales.orders.update\",\n *   \"statusDictionary\": \"sales.order_status\",\n *   \"input\": {\n *     \"id\": \"{{context.id}}\",\n *     \"statusValue\": \"pending_approval\"\n *   }\n * }\n * ```\n */\nexport async function executeUpdateEntity(\n  em: EntityManager,\n  config: any,\n  context: ActivityContext,\n  container: AwilixContainer\n): Promise<any> {\n  const { commandId, input, statusDictionary } = config\n\n  if (!commandId) {\n    throw new Error('UPDATE_ENTITY requires \"commandId\" field (e.g., \"sales.documents.update\")')\n  }\n\n  if (!input || typeof input !== 'object') {\n    throw new Error('UPDATE_ENTITY requires \"input\" object with entity data')\n  }\n\n  // Resolve CommandBus from container\n  const commandBus = container.resolve('commandBus') as any\n\n  if (!commandBus || typeof commandBus.execute !== 'function') {\n    throw new Error('CommandBus not available in container')\n  }\n\n  // Prepare final input, resolving statusValue if provided\n  let finalInput = { ...input }\n\n  // If statusValue is provided with a statusDictionary, resolve it to statusEntryId\n  if (finalInput.statusValue && statusDictionary) {\n    const statusEntryId = await resolveDictionaryEntryId(\n      em,\n      statusDictionary,\n      finalInput.statusValue,\n      context.workflowInstance.tenantId,\n      context.workflowInstance.organizationId\n    )\n    if (statusEntryId) {\n      finalInput.statusEntryId = statusEntryId\n    }\n    delete finalInput.statusValue\n  }\n\n  // Build synthetic CommandRuntimeContext for workflow execution\n  // Use nil UUID for system actions when no user context is available\n  const SYSTEM_USER_ID = '00000000-0000-0000-0000-000000000000'\n  const ctx = {\n    container,\n    auth: {\n      sub: context.userId || SYSTEM_USER_ID,\n      tenantId: context.workflowInstance.tenantId,\n      orgId: context.workflowInstance.organizationId,\n      isSuperAdmin: false,\n    },\n    organizationScope: null,\n    selectedOrganizationId: context.workflowInstance.organizationId,\n    organizationIds: context.workflowInstance.organizationId\n      ? [context.workflowInstance.organizationId]\n      : null,\n  }\n\n  // Execute the command\n  const { result, logEntry } = await commandBus.execute(commandId, {\n    input: finalInput,\n    ctx,\n  })\n\n  return {\n    executed: true,\n    commandId,\n    result,\n    logEntryId: logEntry?.id,\n  }\n}\n\n/**\n * Helper to resolve dictionary entry ID by value\n */\nasync function resolveDictionaryEntryId(\n  em: EntityManager,\n  dictionaryKey: string,\n  value: string,\n  tenantId: string,\n  organizationId: string\n): Promise<string | null> {\n  try {\n    // Import here to avoid circular dependencies\n    const { Dictionary, DictionaryEntry } = await import('@open-mercato/core/modules/dictionaries/data/entities')\n\n    // Find the dictionary\n    const dictionary = await em.findOne(Dictionary, {\n      key: dictionaryKey,\n      tenantId,\n      organizationId,\n      deletedAt: null,\n    })\n\n    if (!dictionary) {\n      console.warn(`[UPDATE_ENTITY] Dictionary not found: ${dictionaryKey}`)\n      return null\n    }\n\n    // Find the entry by normalized value\n    const normalizedValue = value.toLowerCase().trim()\n    const entry = await em.findOne(DictionaryEntry, {\n      dictionary: dictionary.id,\n      tenantId,\n      organizationId,\n      normalizedValue,\n    })\n\n    if (!entry) {\n      console.warn(`[UPDATE_ENTITY] Dictionary entry not found: ${dictionaryKey}/${value}`)\n      return null\n    }\n\n    return entry.id\n  } catch (error) {\n    console.error(`[UPDATE_ENTITY] Error resolving dictionary entry:`, error)\n    return null\n  }\n}\n\n/**\n * CALL_WEBHOOK activity handler\n *\n * Makes HTTP request to an external URL. Applies shared SSRF guard\n * (protocol / credentials / blocked host / private IP literal / DNS rebinding)\n * before issuing the request and rejects any 3xx redirect rather than following.\n */\nexport type CallWebhookDeps = {\n  lookupHost?: HostLookup\n  allowPrivate?: boolean\n  fetchImpl?: typeof fetch\n  signal?: AbortSignal\n}\n\nexport async function executeCallWebhook(\n  config: unknown,\n  context: ActivityContext,\n  deps: CallWebhookDeps = {}\n): Promise<any> {\n  const parsed = callWebhookConfigSchema.safeParse(config)\n  if (!parsed.success) {\n    const issues = parsed.error.issues\n      .map((issue) => `${issue.path.join('.') || 'config'}: ${issue.message}`)\n      .join('; ')\n    throw new Error(`CALL_WEBHOOK config invalid: ${issues}`)\n  }\n  const { url, method, headers: rawHeaders, body } = parsed.data\n  const headers = rawHeaders ?? {}\n\n  const allowPrivate = deps.allowPrivate ?? isAllowPrivateWorkflowWebhookUrlsEnabled()\n\n  let response: Response\n  try {\n    response = await safeOutboundFetch(\n      url,\n      {\n        method,\n        headers: {\n          'Content-Type': 'application/json',\n          ...headers,\n        },\n        body: body !== undefined && body !== null ? JSON.stringify(body) : undefined,\n        redirect: 'manual',\n        signal: deps.signal,\n      },\n      {\n        subject: 'Workflow webhook URL',\n        allowPrivate,\n        lookupHost: deps.lookupHost,\n        fetchImpl: deps.fetchImpl,\n      },\n    )\n  } catch (error) {\n    if (error instanceof UnsafeOutboundUrlError) {\n      throw new Error(\n        `CALL_WEBHOOK rejected unsafe URL (reason=${error.reason}): ${error.message}`\n      )\n    }\n    throw error\n  }\n\n  if (response.status >= 300 && response.status < 400) {\n    const location = response.headers.get('location')\n    throw new Error(\n      `CALL_WEBHOOK refused to follow redirect ${response.status} to ${\n        location ?? '(no Location header)'\n      }`\n    )\n  }\n\n  // Parse response\n  let result: any\n  const contentType = response.headers.get('content-type')\n\n  if (contentType && contentType.includes('application/json')) {\n    result = await response.json()\n  } else {\n    result = await response.text()\n  }\n\n  // Check for HTTP errors\n  if (!response.ok) {\n    throw new Error(\n      `Webhook request failed with status ${response.status}: ${JSON.stringify(result)}`\n    )\n  }\n\n  return {\n    status: response.status,\n    statusText: response.statusText,\n    result,\n  }\n}\n\n/**\n * EXECUTE_FUNCTION activity handler\n *\n * Calls a registered function from DI container\n */\nexport async function executeFunction(\n  config: any,\n  context: ActivityContext,\n  container: AwilixContainer\n): Promise<any> {\n  const { functionName, args = {} } = config\n\n  if (!functionName) {\n    throw new Error('EXECUTE_FUNCTION requires \"functionName\" field')\n  }\n\n  // Look up function in container\n  const fnKey = `workflowFunction:${functionName}`\n\n  try {\n    const fn = container.resolve(fnKey)\n\n    if (typeof fn !== 'function') {\n      throw new Error(`Registered workflow function \"${functionName}\" is not a function`)\n    }\n\n    // Call function with args and context\n    const result = await fn(args, context)\n\n    return { executed: true, functionName, result }\n  } catch (error) {\n    if (error instanceof Error && error.message.includes('not registered')) {\n      throw new Error(\n        `Workflow function \"${functionName}\" not registered in DI container (key: ${fnKey})`\n      )\n    }\n    throw error\n  }\n}\n\n/**\n * Calculate delay in milliseconds from a WAIT activity config.\n * Supports either `duration` (relative, e.g. \"PT5M\") or `until` (absolute ISO 8601 datetime).\n */\nfunction calculateWaitDelayMs(config: { duration?: string; until?: string }): number {\n  if (config.until) {\n    const targetDate = new Date(config.until)\n    if (isNaN(targetDate.getTime())) {\n      throw new Error(`WAIT activity: invalid \"until\" datetime: ${config.until}`)\n    }\n    const delayMs = targetDate.getTime() - Date.now()\n    return Math.max(0, delayMs)\n  }\n\n  if (config.duration) {\n    return parseDuration(config.duration)\n  }\n\n  throw new Error('WAIT activity requires \"duration\" (e.g., \"PT5M\", \"1h\") or \"until\" (ISO 8601 datetime)')\n}\n\n/**\n * WAIT activity handler\n *\n * Delays workflow execution for a configured duration or until a specific datetime.\n * - `duration`: relative delay (e.g. \"PT5M\", \"1h\", \"30s\")\n * - `until`: absolute datetime (e.g. \"2026-04-15T10:00:00Z\")\n * - Sync mode: blocks via sleep (suitable for short delays)\n * - Async mode: delay is handled by the queue's delayMs option;\n *   this handler returns immediately when called from the worker\n */\nasync function executeWait(config: any): Promise<any> {\n  const durationMs = calculateWaitDelayMs(config)\n\n  // In sync mode, actually sleep for the duration\n  // In async mode (called from worker), the delay already happened via queue scheduling\n  await sleep(durationMs)\n\n  return { waited: true, durationMs }\n}\n\n/**\n * CALL_API activity handler\n *\n * Makes authenticated HTTP request to internal Open Mercato APIs\n * - Automatically creates one-time API key for authentication\n * - Injects tenant/organization context headers\n * - Validates URL security (SSRF prevention)\n * - Classifies errors (retriable vs non-retriable)\n * - Deletes API key after request (no stored credentials!)\n */\nexport async function executeCallApi(\n  em: EntityManager,\n  config: any,\n  context: ActivityContext,\n  container: AwilixContainer,\n  signal?: AbortSignal\n): Promise<any> {\n  // 1. Interpolate variables in config (including {{workflow.*}}, {{context.*}}, {{env.*}}, {{now}})\n  const interpolatedConfig = interpolateVariables(config, context.workflowContext, context.workflowInstance)\n\n  const {\n    endpoint,\n    method = 'GET',\n    headers = {},\n    body,\n    validateTenantMatch = true,\n  } = interpolatedConfig\n\n\n  if (!endpoint) {\n    throw new Error('CALL_API requires \"endpoint\" field')\n  }\n\n  // 2. Build full URL (prepend APP_URL for relative paths)\n  const fullUrl = buildApiUrl(endpoint)\n\n  // 3. Import the one-time API key helper\n  const { withOnetimeApiKey } = await import('../../api_keys/services/apiKeyService')\n\n  // 4. Get EntityManager from container (for correct type)\n  const apiKeyEm = container.resolve<PostgreSqlEntityManager>('em')\n\n  // 5. Resolve the roles that the one-time API key will inherit.\n  //\n  // SECURITY: The key must never exceed the permissions of the human who\n  //   triggered (or authored) this workflow. Previously this code looked up\n  //   a role named \"admin\"/\"superadmin\" for the tenant and assigned it to\n  //   the key \u2014 which allowed any non-admin workflow author with\n  //   `workflows.definitions.edit` + `workflows.instances.create` to issue\n  //   arbitrary administrative API calls via a CALL_API activity. See the\n  //   SECURITY.md changelog entry for this fix.\n  //\n  //   The resolution strategy is:\n  //     1. Use the workflow instance's `metadata.initiatedBy` user (whoever\n  //        manually started the instance), when available. Only this user's\n  //        current active roles are used \u2014 we never fall back to the author\n  //        when the initiator is known, because that would escalate the\n  //        initiator's privileges.\n  //     2. Fall back to the workflow definition's `createdBy` (author) only\n  //        when the instance was started by an event trigger with no user.\n  //     3. If no traceable principal exists, the activity refuses to run \u2014\n  //        there is no \"system\" fallback that bypasses RBAC.\n  const resolvedRoleIds = await resolveCallApiRoleIds(apiKeyEm, context.workflowInstance)\n\n  if (resolvedRoleIds.length === 0) {\n    throw new Error(\n      `[CALL_API] Refusing to execute CALL_API for workflow instance ${context.workflowInstance.id}: ` +\n      `no traceable user roles could be resolved from the workflow instance or definition. ` +\n      `CALL_API activities must run under the identity of the user who triggered them.`\n    )\n  }\n\n  // 6. Execute request with one-time API key scoped to the resolved user's roles\n  return await withOnetimeApiKey(\n    apiKeyEm,\n    {\n      name: `__workflow_${context.workflowInstance.id}__`,\n      description: `One-time key for workflow ${context.workflowInstance.workflowId} instance ${context.workflowInstance.id}`,\n      tenantId: context.workflowInstance.tenantId,\n      organizationId: context.workflowInstance.organizationId,\n      roles: resolvedRoleIds,\n      expiresAt: null,\n    },\n    async (apiKeySecret) => {\n      // Build request headers (auth + context + custom)\n      const requestHeaders: Record<string, string> = {\n        'Content-Type': 'application/json',\n        'Authorization': `apikey ${apiKeySecret}`,\n        'X-Tenant-Id': context.workflowInstance.tenantId,\n        'X-Organization-Id': context.workflowInstance.organizationId,\n        'X-Workflow-Instance-Id': context.workflowInstance.id,\n        ...headers,\n      }\n\n      // Make HTTP request\n      const response = await fetch(fullUrl, {\n        method,\n        headers: requestHeaders,\n        body: body ? JSON.stringify(body) : undefined,\n        signal,\n      })\n\n      // Parse response body (JSON-safe)\n      let responseBody: any\n      const contentType = response.headers.get('content-type')\n\n      try {\n        if (contentType && contentType.includes('application/json')) {\n          responseBody = await response.json()\n        } else {\n          responseBody = await response.text()\n        }\n      } catch (error) {\n        responseBody = null\n      }\n\n      // Check for HTTP errors and classify\n      if (!response.ok) {\n        classifyAndThrowError(response.status, responseBody, fullUrl)\n      }\n\n      // Validate tenant match (security check)\n      if (validateTenantMatch && responseBody && typeof responseBody === 'object') {\n        if (responseBody.tenantId && responseBody.tenantId !== context.workflowInstance.tenantId) {\n          throw new Error(\n            `Tenant ID mismatch: workflow expects ${context.workflowInstance.tenantId} but API returned ${responseBody.tenantId}`\n          )\n        }\n      }\n\n      // Return structured result\n      return {\n        status: response.status,\n        statusText: response.statusText,\n        headers: Object.fromEntries(response.headers.entries()),\n        body: responseBody,\n        authenticated: true,\n        tenantId: context.workflowInstance.tenantId,\n        organizationId: context.workflowInstance.organizationId,\n      }\n    }\n  )\n}\n\n// ============================================================================\n// CALL_API Helper Functions\n// ============================================================================\n\nexport type CallApiInstanceLike = {\n  id: string\n  tenantId: string\n  organizationId: string\n  definitionId: string\n  metadata?: { initiatedBy?: string | null } | null\n}\n\nasync function resolveActiveRoleIdsForUser(\n  em: any,\n  userId: string,\n  scope: { tenantId: string; organizationId: string },\n): Promise<string[]> {\n  const { findOneWithDecryption, findWithDecryption } = await import('@open-mercato/shared/lib/encryption/find')\n  const { User, UserRole, Role } = await import('../../auth/data/entities')\n\n  const user = await findOneWithDecryption(em, User, {\n    id: userId,\n    tenantId: scope.tenantId,\n    deletedAt: null,\n  }, {}, scope)\n  if (!user) return []\n\n  const userRoles = await findWithDecryption(\n    em,\n    UserRole,\n    { user: user.id, deletedAt: null },\n    { populate: ['role'] },\n    scope,\n  )\n  const roleIds = userRoles\n    .map((ur: any) => (typeof ur.role === 'string' ? ur.role : ur.role?.id))\n    .filter((id: unknown): id is string => typeof id === 'string' && id.length > 0)\n\n  if (roleIds.length === 0) return []\n\n  const scopedRoles = await findWithDecryption(em, Role, {\n    id: { $in: roleIds },\n    tenantId: scope.tenantId,\n    deletedAt: null,\n  }, {}, scope)\n  return scopedRoles.map((r: any) => r.id as string)\n}\n\nexport async function resolveCallApiRoleIds(\n  em: any,\n  instance: CallApiInstanceLike\n): Promise<string[]> {\n  if (!instance.definitionId) return []\n\n  const { findOneWithDecryption } = await import('@open-mercato/shared/lib/encryption/find')\n  const { WorkflowDefinition } = await import('../data/entities')\n\n  const scope = { tenantId: instance.tenantId, organizationId: instance.organizationId }\n\n  // 1. Prefer the triggering user (whoever manually started this instance).\n  //    WorkflowInstance.metadata.initiatedBy is the canonical record of that\n  //    principal for user-started instances; use their current role set so\n  //    CALL_API never exceeds the initiator's permissions. Refuse if the\n  //    initiator has no active scoped roles \u2014 do not fall back to the\n  //    definition author, which would escalate the initiator's privileges.\n  const initiatorUserId = instance.metadata?.initiatedBy ?? null\n  if (initiatorUserId) {\n    return resolveActiveRoleIdsForUser(em, initiatorUserId, scope)\n  }\n\n  // 2. Event-triggered instance with no human initiator: fall back to the\n  //    definition author. Soft-deleted definitions must not mint keys.\n  const definition = await findOneWithDecryption(em, WorkflowDefinition, {\n    id: instance.definitionId,\n    tenantId: instance.tenantId,\n    deletedAt: null,\n  }, {}, scope)\n  const authorUserId = definition?.createdBy\n  if (!authorUserId) return []\n\n  return resolveActiveRoleIdsForUser(em, authorUserId, scope)\n}\n\n/**\n * Build full API URL from endpoint\n * - Relative paths (/api/...) \u2192 prepend APP_URL\n * - Absolute URLs \u2192 validate domain matches APP_URL (SSRF prevention)\n */\nfunction buildApiUrl(endpoint: string): string {\n  const appUrl = process.env.APP_URL || 'http://localhost:3000'\n\n  // Relative path - prepend APP_URL\n  if (endpoint.startsWith('/')) {\n    // Security: Only allow /api/* paths\n    if (!endpoint.startsWith('/api/')) {\n      throw new Error(`CALL_API only supports /api/* paths, got: ${endpoint}`)\n    }\n    return `${appUrl}${endpoint}`\n  }\n\n  // Absolute URL - validate domain matches APP_URL (SSRF prevention)\n  try {\n    const endpointUrl = new URL(endpoint)\n    const appUrlObj = new URL(appUrl)\n\n    if (endpointUrl.host !== appUrlObj.host) {\n      throw new Error(\n        `SSRF Prevention: CALL_API endpoint domain (${endpointUrl.host}) does not match APP_URL (${appUrlObj.host})`\n      )\n    }\n\n    return endpoint\n  } catch (error) {\n    if (error instanceof TypeError) {\n      throw new Error(`Invalid endpoint URL: ${endpoint}`)\n    }\n    throw error\n  }\n}\n\n/**\n * Classify HTTP error and throw appropriate error\n * - 400-499: Non-retriable (client error - validation/auth)\n * - 500-599: Retriable (server error)\n */\nfunction classifyAndThrowError(status: number, body: any, url: string): never {\n  const bodyStr = typeof body === 'string' ? body : JSON.stringify(body)\n\n  if (status >= 400 && status < 500) {\n    // Client errors - non-retriable\n    throw new Error(\n      `CALL_API request failed with status ${status} (non-retriable): ${bodyStr}`\n    )\n  }\n\n  if (status >= 500) {\n    // Server errors - retriable\n    const error: any = new Error(\n      `CALL_API request failed with status ${status} (retriable): ${bodyStr}`\n    )\n    error.retriable = true\n    throw error\n  }\n\n  // Other errors\n  throw new Error(`CALL_API request failed with status ${status}: ${bodyStr}`)\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Interpolate variables in config from workflow context\n *\n * Supports syntax:\n * - {{context.field}} or {{context.nested.field}} - from workflow context\n * - {{workflow.instanceId}} - workflow instance ID\n * - {{workflow.tenantId}} - tenant ID\n * - {{workflow.organizationId}} - organization ID\n * - {{workflow.currentStepId}} - current step ID\n * - {{env.VAR_NAME}} - environment variables\n * - {{now}} - current ISO timestamp\n */\nfunction interpolateVariables(\n  config: any,\n  context: Record<string, any>,\n  workflowInstance?: WorkflowInstance\n): any {\n  if (typeof config === 'string') {\n    // Check if this is a single variable reference (e.g., \"{{context.cart.items}}\")\n    // This preserves the original type (array, object, number, boolean)\n    const singleVarMatch = config.match(/^\\{\\{([^}]+)\\}\\}$/)\n\n    if (singleVarMatch) {\n      const trimmedPath = singleVarMatch[1].trim()\n\n      // Handle {{workflow.*}} variables\n      if (trimmedPath.startsWith('workflow.') && workflowInstance) {\n        const workflowKey = trimmedPath.substring('workflow.'.length)\n        switch (workflowKey) {\n          case 'instanceId':\n            return workflowInstance.id\n          case 'tenantId':\n            return workflowInstance.tenantId\n          case 'organizationId':\n            return workflowInstance.organizationId\n          case 'currentStepId':\n            return workflowInstance.currentStepId\n          case 'workflowId':\n            return workflowInstance.workflowId\n          case 'version':\n            return workflowInstance.version // Return as number\n          default:\n            return config // Return original if unknown\n        }\n      }\n\n      // Handle {{env.*}} variables\n      if (trimmedPath.startsWith('env.')) {\n        const envKey = trimmedPath.substring('env.'.length)\n        return process.env[envKey] ?? config\n      }\n\n      // Handle {{now}} - current timestamp\n      if (trimmedPath === 'now') {\n        return new Date().toISOString()\n      }\n\n      // Handle {{context.*}} variables (default behavior)\n      const contextPath = trimmedPath.startsWith('context.')\n        ? trimmedPath.substring('context.'.length)\n        : trimmedPath\n\n      const value = getNestedValue(context, contextPath)\n      return value !== undefined ? value : config // Return raw value to preserve type\n    }\n\n    // Multiple interpolations or mixed text - return string\n    return config.replace(/\\{\\{([^}]+)\\}\\}/g, (match, path) => {\n      const trimmedPath = path.trim()\n\n      // Handle {{workflow.*}} variables\n      if (trimmedPath.startsWith('workflow.') && workflowInstance) {\n        const workflowKey = trimmedPath.substring('workflow.'.length)\n        switch (workflowKey) {\n          case 'instanceId':\n            return workflowInstance.id\n          case 'tenantId':\n            return workflowInstance.tenantId\n          case 'organizationId':\n            return workflowInstance.organizationId\n          case 'currentStepId':\n            return workflowInstance.currentStepId\n          case 'workflowId':\n            return workflowInstance.workflowId\n          case 'version':\n            return String(workflowInstance.version)\n          default:\n            return match // Unknown workflow key\n        }\n      }\n\n      // Handle {{env.*}} variables\n      if (trimmedPath.startsWith('env.')) {\n        const envKey = trimmedPath.substring('env.'.length)\n        const envValue = process.env[envKey]\n        return envValue !== undefined ? envValue : match\n      }\n\n      // Handle {{now}} - current timestamp\n      if (trimmedPath === 'now') {\n        return new Date().toISOString()\n      }\n\n      // Handle {{context.*}} variables (default behavior)\n      const contextPath = trimmedPath.startsWith('context.')\n        ? trimmedPath.substring('context.'.length)\n        : trimmedPath\n\n      const value = getNestedValue(context, contextPath)\n      return value !== undefined ? String(value) : match\n    })\n  }\n\n  if (Array.isArray(config)) {\n    return config.map((item) => interpolateVariables(item, context, workflowInstance))\n  }\n\n  if (config && typeof config === 'object') {\n    const result: Record<string, any> = {}\n    for (const [key, value] of Object.entries(config)) {\n      result[key] = interpolateVariables(value, context, workflowInstance)\n    }\n    return result\n  }\n\n  return config\n}\n\n/**\n * Get nested value from object by path (e.g., \"user.email\")\n */\nfunction getNestedValue(obj: any, path: string): any {\n  const parts = path.split('.')\n  let value = obj\n\n  for (const part of parts) {\n    if (value && typeof value === 'object' && part in value) {\n      value = value[part]\n    } else {\n      return undefined\n    }\n  }\n\n  return value\n}\n\n/**\n * Calculate exponential backoff delay\n */\nfunction calculateBackoff(\n  initialIntervalMs: number,\n  backoffCoefficient: number,\n  attempt: number,\n  maxIntervalMs: number\n): number {\n  const backoff = initialIntervalMs * Math.pow(backoffCoefficient, attempt)\n  return Math.min(backoff, maxIntervalMs || Infinity)\n}\n\n/**\n * Sleep for specified milliseconds\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\n/**\n * Execute a promise with timeout\n */\nasync function executeWithTimeout<T>(\n  executor: () => Promise<T>,\n  timeoutMs: number\n): Promise<T> {\n  let timeoutId: NodeJS.Timeout\n\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeoutId = setTimeout(() => {\n      reject(new Error(`Activity execution timeout after ${timeoutMs}ms`))\n    }, timeoutMs)\n  })\n\n  try {\n    return await Promise.race([executor(), timeoutPromise])\n  } finally {\n    clearTimeout(timeoutId!)\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Workflows Module - Activity Executor Service\n *\n * Executes workflow activities (send email, call API, emit events, etc.)\n * - Supports multiple activity types\n * - Implements retry logic with exponential backoff\n * - Handles timeouts\n * - Variable interpolation from workflow context\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport type { EntityManager as PostgreSqlEntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport { WorkflowInstance } from '../data/entities'\nimport { createModuleQueue, Queue } from '@open-mercato/queue'\nimport { getRedisUrl } from '@open-mercato/shared/lib/redis/connection'\nimport {\n  safeOutboundFetch,\n  UnsafeOutboundUrlError,\n  type HostLookup,\n} from '@open-mercato/shared/lib/url-safety'\nimport { parseBooleanWithDefault } from '@open-mercato/shared/lib/boolean'\nimport { callWebhookConfigSchema } from '../data/validators'\nimport { WorkflowActivityJob, WORKFLOW_ACTIVITIES_QUEUE_NAME } from './activity-queue-types'\nimport { logWorkflowEvent } from './event-logger'\nimport { parseDuration } from './duration'\n\nexport { isPrivateUrl } from '@open-mercato/shared/lib/network'\n\nfunction isAllowPrivateWorkflowWebhookUrlsEnabled(): boolean {\n  if (parseBooleanWithDefault(process.env.OM_WORKFLOWS_ALLOW_PRIVATE_URLS, false)) {\n    return true\n  }\n\n  if (parseBooleanWithDefault(process.env.WORKFLOW_WEBHOOK_ALLOW_PRIVATE_URLS, false)) {\n    console.warn(\n      '[CALL_WEBHOOK] WORKFLOW_WEBHOOK_ALLOW_PRIVATE_URLS is deprecated. Use OM_WORKFLOWS_ALLOW_PRIVATE_URLS instead. SSRF protection is bypassed.'\n    )\n    return true\n  }\n\n  return false\n}\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport type ActivityType =\n  | 'SEND_EMAIL'\n  | 'CALL_API'\n  | 'EMIT_EVENT'\n  | 'UPDATE_ENTITY'\n  | 'CALL_WEBHOOK'\n  | 'EXECUTE_FUNCTION'\n  | 'WAIT'\n\nexport interface ActivityDefinition {\n  activityId: string // Unique identifier for activity\n  activityName?: string // Optional, for debugging/logging\n  activityType: ActivityType\n  config: any\n  async?: boolean // Flag to execute activity asynchronously via queue\n  retryPolicy?: RetryPolicy\n  timeoutMs?: number\n  compensate?: boolean // Flag to execute compensation on failure\n}\n\nexport interface RetryPolicy {\n  maxAttempts: number\n  initialIntervalMs: number\n  backoffCoefficient: number\n  maxIntervalMs: number\n}\n\nexport interface ActivityContext {\n  workflowInstance: WorkflowInstance\n  workflowContext: Record<string, any>\n  stepContext?: Record<string, any>\n  stepInstanceId?: string\n  // Set when the activity runs inside a parallel branch; carried on the queue\n  // payload so async resume targets the branch rather than the instance.\n  branchInstanceId?: string | null\n  transitionId?: string\n  userId?: string\n}\n\nexport interface ActivityExecutionResult {\n  activityId: string\n  activityName?: string\n  activityType: ActivityType\n  success: boolean\n  output?: any\n  error?: string\n  retryCount: number\n  executionTimeMs: number\n  async?: boolean // Marks activity as async (queued)\n  jobId?: string // Queue job ID for async activities\n}\n\nexport class ActivityExecutionError extends Error {\n  constructor(\n    message: string,\n    public activityType: ActivityType,\n    public activityName?: string,\n    public details?: any\n  ) {\n    super(message)\n    this.name = 'ActivityExecutionError'\n  }\n}\n\n// ============================================================================\n// Queue Integration for Async Activities\n// ============================================================================\n\nlet activityQueue: Queue<WorkflowActivityJob> | null = null\n\n/**\n * Get or create the activity queue (lazy initialization)\n */\nfunction getActivityQueue(): Queue<WorkflowActivityJob> {\n  if (!activityQueue) {\n    activityQueue = createModuleQueue<WorkflowActivityJob>(\n      WORKFLOW_ACTIVITIES_QUEUE_NAME,\n      { concurrency: parseInt(process.env.WORKFLOW_WORKER_CONCURRENCY || '5') },\n    )\n  }\n\n  return activityQueue\n}\n\n/**\n * Enqueue an activity for background execution\n *\n * @param em - Entity manager\n * @param activity - Activity definition\n * @param context - Execution context\n * @returns Job ID\n */\nexport async function enqueueActivity(\n  em: EntityManager,\n  activity: ActivityDefinition,\n  context: ActivityContext\n): Promise<string> {\n  const { workflowInstance, workflowContext, stepContext, transitionId, stepInstanceId, branchInstanceId } =\n    context\n\n  // Interpolate config variables NOW (before queuing)\n  const interpolatedConfig = interpolateVariables(activity.config, workflowContext, workflowInstance)\n\n  // Create job payload\n  const job: WorkflowActivityJob = {\n    workflowInstanceId: workflowInstance.id,\n    stepInstanceId,\n    branchInstanceId: branchInstanceId ?? undefined,\n    transitionId,\n    activityId: activity.activityId,\n    activityName: activity.activityName || activity.activityType,\n    activityType: activity.activityType,\n    activityConfig: interpolatedConfig,\n    workflowContext,\n    stepContext,\n    retryPolicy: activity.retryPolicy,\n    timeoutMs: activity.timeoutMs,\n    tenantId: workflowInstance.tenantId,\n    organizationId: workflowInstance.organizationId,\n    userId: context.userId,\n  }\n\n  // Enqueue to queue (WAIT activities use delayMs for the actual delay)\n  const queue = getActivityQueue()\n  const enqueueOptions = activity.activityType === 'WAIT' && (interpolatedConfig.duration || interpolatedConfig.until)\n    ? { delayMs: calculateWaitDelayMs(interpolatedConfig) }\n    : undefined\n  const jobId = await queue.enqueue(job, enqueueOptions)\n\n  // Log event\n  await logWorkflowEvent(em, {\n    workflowInstanceId: workflowInstance.id,\n    stepInstanceId,\n    eventType: 'ACTIVITY_QUEUED',\n    eventData: {\n      activityId: activity.activityId,\n      activityName: activity.activityName,\n      activityType: activity.activityType,\n      async: true,\n      jobId,\n    },\n    tenantId: workflowInstance.tenantId,\n    organizationId: workflowInstance.organizationId,\n  })\n\n  return jobId\n}\n\n/**\n * Enqueue a delayed timer job for a WAIT_FOR_TIMER step.\n *\n * The activity worker handles `kind: 'timer'` jobs by calling\n * `timerHandler.fireTimer`, which resumes the paused workflow instance.\n */\nexport async function enqueueTimerJob(params: {\n  workflowInstanceId: string\n  stepInstanceId: string\n  branchInstanceId?: string | null\n  tenantId: string\n  organizationId: string\n  userId?: string\n  fireAt: string\n  delayMs: number\n}): Promise<string> {\n  const { workflowInstanceId, stepInstanceId, branchInstanceId, tenantId, organizationId, userId, fireAt, delayMs } =\n    params\n\n  const queue = getActivityQueue()\n  const jobId = await queue.enqueue(\n    {\n      kind: 'timer',\n      workflowInstanceId,\n      stepInstanceId,\n      branchInstanceId: branchInstanceId ?? undefined,\n      tenantId,\n      organizationId,\n      userId,\n      fireAt,\n    },\n    { delayMs: delayMs > 0 ? delayMs : undefined }\n  )\n\n  return jobId\n}\n\n// ============================================================================\n// Main Activity Execution Functions\n// ============================================================================\n\n/**\n * Execute a single activity with retry logic and timeout\n *\n * @param em - Entity manager\n * @param container - DI container\n * @param activity - Activity definition\n * @param context - Execution context\n * @returns Execution result\n */\nexport async function executeActivity(\n  em: EntityManager,\n  container: AwilixContainer,\n  activity: ActivityDefinition,\n  context: ActivityContext\n): Promise<ActivityExecutionResult> {\n  const retryPolicy = activity.retryPolicy || {\n    maxAttempts: 1,\n    initialIntervalMs: 0,\n    backoffCoefficient: 1,\n    maxIntervalMs: 0,\n  }\n\n  let lastError: any\n  let retryCount = 0\n\n  for (let attempt = 0; attempt < retryPolicy.maxAttempts; attempt++) {\n    try {\n      const startTime = Date.now()\n\n      // Execute with timeout if specified\n      const result = activity.timeoutMs\n        ? await executeWithTimeout(\n            () => executeActivityByType(em, container, activity, context),\n            activity.timeoutMs\n          )\n        : await executeActivityByType(em, container, activity, context)\n\n      const executionTimeMs = Date.now() - startTime\n\n      return {\n        activityId: activity.activityId,\n        activityName: activity.activityName,\n        activityType: activity.activityType,\n        success: true,\n        output: result,\n        retryCount: attempt,\n        executionTimeMs,\n        async: activity.async || false,\n      }\n    } catch (error) {\n      lastError = error\n      retryCount = attempt + 1\n\n      // Log activity retry attempt with context\n      if (attempt < retryPolicy.maxAttempts - 1) {\n        console.error(`[WORKFLOW] Activity ${activity.activityId} (${activity.activityType}) failed on attempt ${attempt + 1}/${retryPolicy.maxAttempts} (instance: ${context.workflowInstance.id}):`, error instanceof Error ? error.message : error)\n      }\n\n      // If not the last attempt, apply backoff and retry\n      if (attempt < retryPolicy.maxAttempts - 1) {\n        const backoff = calculateBackoff(\n          retryPolicy.initialIntervalMs,\n          retryPolicy.backoffCoefficient,\n          attempt,\n          retryPolicy.maxIntervalMs\n        )\n\n        await sleep(backoff)\n      }\n    }\n  }\n\n  // All retries exhausted\n  const errorMessage = lastError instanceof Error ? lastError.message : String(lastError)\n  console.error(`[WORKFLOW] Activity ${activity.activityId} (${activity.activityType}) failed after ${retryCount} attempts (instance: ${context.workflowInstance.id}): ${errorMessage}`)\n  if (lastError instanceof Error && lastError.stack) {\n    console.error('[WORKFLOW] Activity error stack:', lastError.stack)\n  }\n\n  return {\n    activityId: activity.activityId,\n    activityName: activity.activityName,\n    activityType: activity.activityType,\n    success: false,\n    error: `Activity failed after ${retryCount} attempts: ${errorMessage}`,\n    retryCount,\n    executionTimeMs: 0,\n    async: activity.async || false,\n  }\n}\n\n/**\n * Execute multiple activities in sequence\n * Supports both synchronous and asynchronous (queued) execution\n *\n * @param em - Entity manager\n * @param container - DI container\n * @param activities - Array of activity definitions\n * @param context - Execution context\n * @returns Array of execution results\n */\nexport async function executeActivities(\n  em: EntityManager,\n  container: AwilixContainer,\n  activities: ActivityDefinition[],\n  context: ActivityContext\n): Promise<ActivityExecutionResult[]> {\n  const results: ActivityExecutionResult[] = []\n\n  for (let i = 0; i < activities.length; i++) {\n    const activity = activities[i]\n\n    // Check if activity should run async\n    if (activity.async) {\n      // Enqueue for background execution\n      const jobId = await enqueueActivity(em, activity, context)\n\n      results.push({\n        activityId: activity.activityId,\n        activityName: activity.activityName,\n        activityType: activity.activityType,\n        success: true, // Queued successfully\n        async: true,\n        jobId,\n        retryCount: 0,\n        executionTimeMs: 0,\n      })\n    } else {\n      // Execute synchronously (existing logic)\n      const result = await executeActivity(em, container, activity, context)\n      results.push(result)\n\n      // Stop execution if activity fails (fail-fast)\n      if (!result.success) {\n        break\n      }\n\n      // Update workflow context with activity output\n      if (result.output && typeof result.output === 'object') {\n        const key = activity.activityName || activity.activityType\n        context.workflowContext = {\n          ...context.workflowContext,\n          [key]: result.output,\n        }\n      }\n    }\n  }\n\n  return results\n}\n\n// ============================================================================\n// Activity Type Handlers\n// ============================================================================\n\n/**\n * Execute activity based on its type\n */\nasync function executeActivityByType(\n  em: EntityManager,\n  container: AwilixContainer,\n  activity: ActivityDefinition,\n  context: ActivityContext\n): Promise<any> {\n  // Interpolate config variables from context (including workflow metadata)\n  const interpolatedConfig = interpolateVariables(activity.config, context.workflowContext, context.workflowInstance)\n\n  switch (activity.activityType) {\n    case 'SEND_EMAIL':\n      return await executeSendEmail(interpolatedConfig, context, container)\n\n    case 'CALL_API':\n      return await executeCallApi(em, interpolatedConfig, context, container)\n\n    case 'EMIT_EVENT':\n      return await executeEmitEvent(interpolatedConfig, context, container)\n\n    case 'UPDATE_ENTITY':\n      return await executeUpdateEntity(em, interpolatedConfig, context, container)\n\n    case 'CALL_WEBHOOK':\n      return await executeCallWebhook(interpolatedConfig, context)\n\n    case 'EXECUTE_FUNCTION':\n      return await executeFunction(interpolatedConfig, context, container)\n\n    case 'WAIT':\n      return await executeWait(interpolatedConfig)\n\n    default:\n      throw new ActivityExecutionError(\n        `Unknown activity type: ${activity.activityType}`,\n        activity.activityType,\n        activity.activityName\n      )\n  }\n}\n\n/**\n * SEND_EMAIL activity handler\n *\n * For MVP, this logs the email (actual email sending can be added later)\n */\nexport async function executeSendEmail(\n  config: any,\n  context: ActivityContext,\n  container: AwilixContainer\n): Promise<any> {\n  const { to, subject, template, templateData, body } = config\n\n  if (!to || !subject) {\n    throw new Error('SEND_EMAIL requires \"to\" and \"subject\" fields')\n  }\n\n  // For MVP: Log the email (actual email service integration can be added later)\n  console.log(`[Workflow Activity] Send email to ${to}: ${subject}`)\n\n  // Check if email service is available in container\n  try {\n    const emailService = container.resolve<{ send: (input: unknown) => Promise<unknown> | unknown }>('emailService')\n    if (emailService && typeof emailService.send === 'function') {\n      await emailService.send({\n        to,\n        subject,\n        template,\n        templateData,\n        body,\n      })\n      return { sent: true, to, subject, via: 'emailService' }\n    }\n  } catch (error) {\n    // Email service not available, just log\n  }\n\n  return { sent: true, to, subject, via: 'console' }\n}\n\n/**\n * EMIT_EVENT activity handler\n *\n * Publishes a domain event to the event bus\n */\nexport async function executeEmitEvent(\n  config: any,\n  context: ActivityContext,\n  container: AwilixContainer\n): Promise<any> {\n  const { eventName, payload } = config\n\n  if (!eventName) {\n    throw new Error('EMIT_EVENT requires \"eventName\" field')\n  }\n\n  // Get event bus from container\n  const eventBus = container.resolve<{ emitEvent: (event: string, payload: unknown, options?: unknown) => Promise<unknown> | unknown }>('eventBus')\n\n  if (!eventBus || typeof eventBus.emitEvent !== 'function') {\n    throw new Error('Event bus not available in container')\n  }\n\n  // Publish event with workflow metadata\n  const enrichedPayload = {\n    ...payload,\n    _workflow: {\n      workflowInstanceId: context.workflowInstance.id,\n      workflowId: context.workflowInstance.workflowId,\n      tenantId: context.workflowInstance.tenantId,\n      organizationId: context.workflowInstance.organizationId,\n    },\n  }\n\n  await eventBus.emitEvent(eventName, enrichedPayload, {\n    tenantId: context.workflowInstance.tenantId,\n    organizationId: context.workflowInstance.organizationId,\n  })\n\n  return { emitted: true, eventName, payload: enrichedPayload }\n}\n\n/**\n * UPDATE_ENTITY activity handler\n *\n * Updates an entity via CommandBus for proper audit logging, undo support, and side effects.\n *\n * Config format:\n * ```json\n * {\n *   \"commandId\": \"sales.documents.update\",\n *   \"input\": {\n *     \"id\": \"{{context.orderId}}\",\n *     \"statusEntryId\": \"{{context.approvedStatusId}}\"\n *   }\n * }\n * ```\n *\n * Alternative format with statusValue (auto-resolves to statusEntryId):\n * ```json\n * {\n *   \"commandId\": \"sales.orders.update\",\n *   \"statusDictionary\": \"sales.order_status\",\n *   \"input\": {\n *     \"id\": \"{{context.id}}\",\n *     \"statusValue\": \"pending_approval\"\n *   }\n * }\n * ```\n */\nexport async function executeUpdateEntity(\n  em: EntityManager,\n  config: any,\n  context: ActivityContext,\n  container: AwilixContainer\n): Promise<any> {\n  const { commandId, input, statusDictionary } = config\n\n  if (!commandId) {\n    throw new Error('UPDATE_ENTITY requires \"commandId\" field (e.g., \"sales.documents.update\")')\n  }\n\n  if (!input || typeof input !== 'object') {\n    throw new Error('UPDATE_ENTITY requires \"input\" object with entity data')\n  }\n\n  // Resolve CommandBus from container\n  const commandBus = container.resolve('commandBus') as any\n\n  if (!commandBus || typeof commandBus.execute !== 'function') {\n    throw new Error('CommandBus not available in container')\n  }\n\n  // Prepare final input, resolving statusValue if provided\n  let finalInput = { ...input }\n\n  // If statusValue is provided with a statusDictionary, resolve it to statusEntryId\n  if (finalInput.statusValue && statusDictionary) {\n    const statusEntryId = await resolveDictionaryEntryId(\n      em,\n      statusDictionary,\n      finalInput.statusValue,\n      context.workflowInstance.tenantId,\n      context.workflowInstance.organizationId\n    )\n    if (statusEntryId) {\n      finalInput.statusEntryId = statusEntryId\n    }\n    delete finalInput.statusValue\n  }\n\n  // Build synthetic CommandRuntimeContext for workflow execution\n  // Use nil UUID for system actions when no user context is available\n  const SYSTEM_USER_ID = '00000000-0000-0000-0000-000000000000'\n  const ctx = {\n    container,\n    auth: {\n      sub: context.userId || SYSTEM_USER_ID,\n      tenantId: context.workflowInstance.tenantId,\n      orgId: context.workflowInstance.organizationId,\n      isSuperAdmin: false,\n    },\n    organizationScope: null,\n    selectedOrganizationId: context.workflowInstance.organizationId,\n    organizationIds: context.workflowInstance.organizationId\n      ? [context.workflowInstance.organizationId]\n      : null,\n  }\n\n  // Execute the command\n  const { result, logEntry } = await commandBus.execute(commandId, {\n    input: finalInput,\n    ctx,\n  })\n\n  return {\n    executed: true,\n    commandId,\n    result,\n    logEntryId: logEntry?.id,\n  }\n}\n\n/**\n * Helper to resolve dictionary entry ID by value\n */\nasync function resolveDictionaryEntryId(\n  em: EntityManager,\n  dictionaryKey: string,\n  value: string,\n  tenantId: string,\n  organizationId: string\n): Promise<string | null> {\n  try {\n    // Import here to avoid circular dependencies\n    const { Dictionary, DictionaryEntry } = await import('@open-mercato/core/modules/dictionaries/data/entities')\n\n    // Find the dictionary\n    const dictionary = await em.findOne(Dictionary, {\n      key: dictionaryKey,\n      tenantId,\n      organizationId,\n      deletedAt: null,\n    })\n\n    if (!dictionary) {\n      console.warn(`[UPDATE_ENTITY] Dictionary not found: ${dictionaryKey}`)\n      return null\n    }\n\n    // Find the entry by normalized value\n    const normalizedValue = value.toLowerCase().trim()\n    const entry = await em.findOne(DictionaryEntry, {\n      dictionary: dictionary.id,\n      tenantId,\n      organizationId,\n      normalizedValue,\n    })\n\n    if (!entry) {\n      console.warn(`[UPDATE_ENTITY] Dictionary entry not found: ${dictionaryKey}/${value}`)\n      return null\n    }\n\n    return entry.id\n  } catch (error) {\n    console.error(`[UPDATE_ENTITY] Error resolving dictionary entry:`, error)\n    return null\n  }\n}\n\n/**\n * CALL_WEBHOOK activity handler\n *\n * Makes HTTP request to an external URL. Applies shared SSRF guard\n * (protocol / credentials / blocked host / private IP literal / DNS rebinding)\n * before issuing the request and rejects any 3xx redirect rather than following.\n */\nexport type CallWebhookDeps = {\n  lookupHost?: HostLookup\n  allowPrivate?: boolean\n  fetchImpl?: typeof fetch\n  signal?: AbortSignal\n}\n\nexport async function executeCallWebhook(\n  config: unknown,\n  context: ActivityContext,\n  deps: CallWebhookDeps = {}\n): Promise<any> {\n  const parsed = callWebhookConfigSchema.safeParse(config)\n  if (!parsed.success) {\n    const issues = parsed.error.issues\n      .map((issue) => `${issue.path.join('.') || 'config'}: ${issue.message}`)\n      .join('; ')\n    throw new Error(`CALL_WEBHOOK config invalid: ${issues}`)\n  }\n  const { url, method, headers: rawHeaders, body } = parsed.data\n  const headers = rawHeaders ?? {}\n\n  const allowPrivate = deps.allowPrivate ?? isAllowPrivateWorkflowWebhookUrlsEnabled()\n\n  let response: Response\n  try {\n    response = await safeOutboundFetch(\n      url,\n      {\n        method,\n        headers: {\n          'Content-Type': 'application/json',\n          ...headers,\n        },\n        body: body !== undefined && body !== null ? JSON.stringify(body) : undefined,\n        redirect: 'manual',\n        signal: deps.signal,\n      },\n      {\n        subject: 'Workflow webhook URL',\n        allowPrivate,\n        lookupHost: deps.lookupHost,\n        fetchImpl: deps.fetchImpl,\n      },\n    )\n  } catch (error) {\n    if (error instanceof UnsafeOutboundUrlError) {\n      throw new Error(\n        `CALL_WEBHOOK rejected unsafe URL (reason=${error.reason}): ${error.message}`\n      )\n    }\n    throw error\n  }\n\n  if (response.status >= 300 && response.status < 400) {\n    const location = response.headers.get('location')\n    throw new Error(\n      `CALL_WEBHOOK refused to follow redirect ${response.status} to ${\n        location ?? '(no Location header)'\n      }`\n    )\n  }\n\n  // Parse response\n  let result: any\n  const contentType = response.headers.get('content-type')\n\n  if (contentType && contentType.includes('application/json')) {\n    result = await response.json()\n  } else {\n    result = await response.text()\n  }\n\n  // Check for HTTP errors\n  if (!response.ok) {\n    throw new Error(\n      `Webhook request failed with status ${response.status}: ${JSON.stringify(result)}`\n    )\n  }\n\n  return {\n    status: response.status,\n    statusText: response.statusText,\n    result,\n  }\n}\n\n/**\n * EXECUTE_FUNCTION activity handler\n *\n * Calls a registered function from DI container\n */\nexport async function executeFunction(\n  config: any,\n  context: ActivityContext,\n  container: AwilixContainer\n): Promise<any> {\n  const { functionName, args = {} } = config\n\n  if (!functionName) {\n    throw new Error('EXECUTE_FUNCTION requires \"functionName\" field')\n  }\n\n  // Look up function in container\n  const fnKey = `workflowFunction:${functionName}`\n\n  try {\n    const fn = container.resolve(fnKey)\n\n    if (typeof fn !== 'function') {\n      throw new Error(`Registered workflow function \"${functionName}\" is not a function`)\n    }\n\n    // Call function with args and context\n    const result = await fn(args, context)\n\n    return { executed: true, functionName, result }\n  } catch (error) {\n    if (error instanceof Error && error.message.includes('not registered')) {\n      throw new Error(\n        `Workflow function \"${functionName}\" not registered in DI container (key: ${fnKey})`\n      )\n    }\n    throw error\n  }\n}\n\n/**\n * Calculate delay in milliseconds from a WAIT activity config.\n * Supports either `duration` (relative, e.g. \"PT5M\") or `until` (absolute ISO 8601 datetime).\n */\nfunction calculateWaitDelayMs(config: { duration?: string; until?: string }): number {\n  if (config.until) {\n    const targetDate = new Date(config.until)\n    if (isNaN(targetDate.getTime())) {\n      throw new Error(`WAIT activity: invalid \"until\" datetime: ${config.until}`)\n    }\n    const delayMs = targetDate.getTime() - Date.now()\n    return Math.max(0, delayMs)\n  }\n\n  if (config.duration) {\n    return parseDuration(config.duration)\n  }\n\n  throw new Error('WAIT activity requires \"duration\" (e.g., \"PT5M\", \"1h\") or \"until\" (ISO 8601 datetime)')\n}\n\n/**\n * WAIT activity handler\n *\n * Delays workflow execution for a configured duration or until a specific datetime.\n * - `duration`: relative delay (e.g. \"PT5M\", \"1h\", \"30s\")\n * - `until`: absolute datetime (e.g. \"2026-04-15T10:00:00Z\")\n * - Sync mode: blocks via sleep (suitable for short delays)\n * - Async mode: delay is handled by the queue's delayMs option;\n *   this handler returns immediately when called from the worker\n */\nasync function executeWait(config: any): Promise<any> {\n  const durationMs = calculateWaitDelayMs(config)\n\n  // In sync mode, actually sleep for the duration\n  // In async mode (called from worker), the delay already happened via queue scheduling\n  await sleep(durationMs)\n\n  return { waited: true, durationMs }\n}\n\n/**\n * CALL_API activity handler\n *\n * Makes authenticated HTTP request to internal Open Mercato APIs\n * - Automatically creates one-time API key for authentication\n * - Injects tenant/organization context headers\n * - Validates URL security (SSRF prevention)\n * - Classifies errors (retriable vs non-retriable)\n * - Deletes API key after request (no stored credentials!)\n */\nexport async function executeCallApi(\n  em: EntityManager,\n  config: any,\n  context: ActivityContext,\n  container: AwilixContainer,\n  signal?: AbortSignal\n): Promise<any> {\n  // 1. Interpolate variables in config (including {{workflow.*}}, {{context.*}}, {{env.*}}, {{now}})\n  const interpolatedConfig = interpolateVariables(config, context.workflowContext, context.workflowInstance)\n\n  const {\n    endpoint,\n    method = 'GET',\n    headers = {},\n    body,\n    validateTenantMatch = true,\n  } = interpolatedConfig\n\n\n  if (!endpoint) {\n    throw new Error('CALL_API requires \"endpoint\" field')\n  }\n\n  // 2. Build full URL (prepend APP_URL for relative paths)\n  const fullUrl = buildApiUrl(endpoint)\n\n  // 3. Import the one-time API key helper\n  const { withOnetimeApiKey } = await import('../../api_keys/services/apiKeyService')\n\n  // 4. Get EntityManager from container (for correct type)\n  const apiKeyEm = container.resolve<PostgreSqlEntityManager>('em')\n\n  // 5. Resolve the roles that the one-time API key will inherit.\n  //\n  // SECURITY: The key must never exceed the permissions of the human who\n  //   triggered (or authored) this workflow. Previously this code looked up\n  //   a role named \"admin\"/\"superadmin\" for the tenant and assigned it to\n  //   the key \u2014 which allowed any non-admin workflow author with\n  //   `workflows.definitions.edit` + `workflows.instances.create` to issue\n  //   arbitrary administrative API calls via a CALL_API activity. See the\n  //   SECURITY.md changelog entry for this fix.\n  //\n  //   The resolution strategy is:\n  //     1. Use the workflow instance's `metadata.initiatedBy` user (whoever\n  //        manually started the instance), when available. Only this user's\n  //        current active roles are used \u2014 we never fall back to the author\n  //        when the initiator is known, because that would escalate the\n  //        initiator's privileges.\n  //     2. Fall back to the workflow definition's `createdBy` (author) only\n  //        when the instance was started by an event trigger with no user.\n  //     3. If no traceable principal exists, the activity refuses to run \u2014\n  //        there is no \"system\" fallback that bypasses RBAC.\n  const resolvedRoleIds = await resolveCallApiRoleIds(apiKeyEm, context.workflowInstance)\n\n  if (resolvedRoleIds.length === 0) {\n    throw new Error(\n      `[CALL_API] Refusing to execute CALL_API for workflow instance ${context.workflowInstance.id}: ` +\n      `no traceable user roles could be resolved from the workflow instance or definition. ` +\n      `CALL_API activities must run under the identity of the user who triggered them.`\n    )\n  }\n\n  // 6. Execute request with one-time API key scoped to the resolved user's roles\n  return await withOnetimeApiKey(\n    apiKeyEm,\n    {\n      name: `__workflow_${context.workflowInstance.id}__`,\n      description: `One-time key for workflow ${context.workflowInstance.workflowId} instance ${context.workflowInstance.id}`,\n      tenantId: context.workflowInstance.tenantId,\n      organizationId: context.workflowInstance.organizationId,\n      roles: resolvedRoleIds,\n      expiresAt: null,\n    },\n    async (apiKeySecret) => {\n      // Build request headers (auth + context + custom)\n      const requestHeaders: Record<string, string> = {\n        'Content-Type': 'application/json',\n        'Authorization': `apikey ${apiKeySecret}`,\n        'X-Tenant-Id': context.workflowInstance.tenantId,\n        'X-Organization-Id': context.workflowInstance.organizationId,\n        'X-Workflow-Instance-Id': context.workflowInstance.id,\n        ...headers,\n      }\n\n      // Make HTTP request\n      const response = await fetch(fullUrl, {\n        method,\n        headers: requestHeaders,\n        body: body ? JSON.stringify(body) : undefined,\n        signal,\n      })\n\n      // Parse response body (JSON-safe)\n      let responseBody: any\n      const contentType = response.headers.get('content-type')\n\n      try {\n        if (contentType && contentType.includes('application/json')) {\n          responseBody = await response.json()\n        } else {\n          responseBody = await response.text()\n        }\n      } catch (error) {\n        responseBody = null\n      }\n\n      // Check for HTTP errors and classify\n      if (!response.ok) {\n        classifyAndThrowError(response.status, responseBody, fullUrl)\n      }\n\n      // Validate tenant match (security check)\n      if (validateTenantMatch && responseBody && typeof responseBody === 'object') {\n        if (responseBody.tenantId && responseBody.tenantId !== context.workflowInstance.tenantId) {\n          throw new Error(\n            `Tenant ID mismatch: workflow expects ${context.workflowInstance.tenantId} but API returned ${responseBody.tenantId}`\n          )\n        }\n      }\n\n      // Return structured result\n      return {\n        status: response.status,\n        statusText: response.statusText,\n        headers: Object.fromEntries(response.headers.entries()),\n        body: responseBody,\n        authenticated: true,\n        tenantId: context.workflowInstance.tenantId,\n        organizationId: context.workflowInstance.organizationId,\n      }\n    }\n  )\n}\n\n// ============================================================================\n// CALL_API Helper Functions\n// ============================================================================\n\nexport type CallApiInstanceLike = {\n  id: string\n  tenantId: string\n  organizationId: string\n  definitionId: string\n  metadata?: { initiatedBy?: string | null } | null\n}\n\nasync function resolveActiveRoleIdsForUser(\n  em: any,\n  userId: string,\n  scope: { tenantId: string; organizationId: string },\n): Promise<string[]> {\n  const { findOneWithDecryption, findWithDecryption } = await import('@open-mercato/shared/lib/encryption/find')\n  const { User, UserRole, Role } = await import('../../auth/data/entities')\n\n  const user = await findOneWithDecryption(em, User, {\n    id: userId,\n    tenantId: scope.tenantId,\n    deletedAt: null,\n  }, {}, scope)\n  if (!user) return []\n\n  const userRoles = await findWithDecryption(\n    em,\n    UserRole,\n    { user: user.id, deletedAt: null },\n    { populate: ['role'] },\n    scope,\n  )\n  const roleIds = userRoles\n    .map((ur: any) => (typeof ur.role === 'string' ? ur.role : ur.role?.id))\n    .filter((id: unknown): id is string => typeof id === 'string' && id.length > 0)\n\n  if (roleIds.length === 0) return []\n\n  const scopedRoles = await findWithDecryption(em, Role, {\n    id: { $in: roleIds },\n    tenantId: scope.tenantId,\n    deletedAt: null,\n  }, {}, scope)\n  return scopedRoles.map((r: any) => r.id as string)\n}\n\nexport async function resolveCallApiRoleIds(\n  em: any,\n  instance: CallApiInstanceLike\n): Promise<string[]> {\n  if (!instance.definitionId) return []\n\n  const { findOneWithDecryption } = await import('@open-mercato/shared/lib/encryption/find')\n  const { WorkflowDefinition } = await import('../data/entities')\n\n  const scope = { tenantId: instance.tenantId, organizationId: instance.organizationId }\n\n  // 1. Prefer the triggering user (whoever manually started this instance).\n  //    WorkflowInstance.metadata.initiatedBy is the canonical record of that\n  //    principal for user-started instances; use their current role set so\n  //    CALL_API never exceeds the initiator's permissions. Refuse if the\n  //    initiator has no active scoped roles \u2014 do not fall back to the\n  //    definition author, which would escalate the initiator's privileges.\n  const initiatorUserId = instance.metadata?.initiatedBy ?? null\n  if (initiatorUserId) {\n    return resolveActiveRoleIdsForUser(em, initiatorUserId, scope)\n  }\n\n  // 2. Event-triggered instance with no human initiator: fall back to the\n  //    definition author. Soft-deleted definitions must not mint keys.\n  const definition = await findOneWithDecryption(em, WorkflowDefinition, {\n    id: instance.definitionId,\n    tenantId: instance.tenantId,\n    deletedAt: null,\n  }, {}, scope)\n  const authorUserId = definition?.createdBy\n  if (!authorUserId) return []\n\n  return resolveActiveRoleIdsForUser(em, authorUserId, scope)\n}\n\n/**\n * Build full API URL from endpoint\n * - Relative paths (/api/...) \u2192 prepend APP_URL\n * - Absolute URLs \u2192 validate domain matches APP_URL (SSRF prevention)\n */\nfunction buildApiUrl(endpoint: string): string {\n  const appUrl = process.env.APP_URL || 'http://localhost:3000'\n\n  // Relative path - prepend APP_URL\n  if (endpoint.startsWith('/')) {\n    // Security: Only allow /api/* paths\n    if (!endpoint.startsWith('/api/')) {\n      throw new Error(`CALL_API only supports /api/* paths, got: ${endpoint}`)\n    }\n    return `${appUrl}${endpoint}`\n  }\n\n  // Absolute URL - validate domain matches APP_URL (SSRF prevention)\n  try {\n    const endpointUrl = new URL(endpoint)\n    const appUrlObj = new URL(appUrl)\n\n    if (endpointUrl.host !== appUrlObj.host) {\n      throw new Error(\n        `SSRF Prevention: CALL_API endpoint domain (${endpointUrl.host}) does not match APP_URL (${appUrlObj.host})`\n      )\n    }\n\n    return endpoint\n  } catch (error) {\n    if (error instanceof TypeError) {\n      throw new Error(`Invalid endpoint URL: ${endpoint}`)\n    }\n    throw error\n  }\n}\n\n/**\n * Classify HTTP error and throw appropriate error\n * - 400-499: Non-retriable (client error - validation/auth)\n * - 500-599: Retriable (server error)\n */\nfunction classifyAndThrowError(status: number, body: any, url: string): never {\n  const bodyStr = typeof body === 'string' ? body : JSON.stringify(body)\n\n  if (status >= 400 && status < 500) {\n    // Client errors - non-retriable\n    throw new Error(\n      `CALL_API request failed with status ${status} (non-retriable): ${bodyStr}`\n    )\n  }\n\n  if (status >= 500) {\n    // Server errors - retriable\n    const error: any = new Error(\n      `CALL_API request failed with status ${status} (retriable): ${bodyStr}`\n    )\n    error.retriable = true\n    throw error\n  }\n\n  // Other errors\n  throw new Error(`CALL_API request failed with status ${status}: ${bodyStr}`)\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Interpolate variables in config from workflow context\n *\n * Supports syntax:\n * - {{context.field}} or {{context.nested.field}} - from workflow context\n * - {{workflow.instanceId}} - workflow instance ID\n * - {{workflow.tenantId}} - tenant ID\n * - {{workflow.organizationId}} - organization ID\n * - {{workflow.currentStepId}} - current step ID\n * - {{env.VAR_NAME}} - environment variables\n * - {{now}} - current ISO timestamp\n */\nfunction interpolateVariables(\n  config: any,\n  context: Record<string, any>,\n  workflowInstance?: WorkflowInstance\n): any {\n  if (typeof config === 'string') {\n    // Check if this is a single variable reference (e.g., \"{{context.cart.items}}\")\n    // This preserves the original type (array, object, number, boolean)\n    const singleVarMatch = config.match(/^\\{\\{([^}]+)\\}\\}$/)\n\n    if (singleVarMatch) {\n      const trimmedPath = singleVarMatch[1].trim()\n\n      // Handle {{workflow.*}} variables\n      if (trimmedPath.startsWith('workflow.') && workflowInstance) {\n        const workflowKey = trimmedPath.substring('workflow.'.length)\n        switch (workflowKey) {\n          case 'instanceId':\n            return workflowInstance.id\n          case 'tenantId':\n            return workflowInstance.tenantId\n          case 'organizationId':\n            return workflowInstance.organizationId\n          case 'currentStepId':\n            return workflowInstance.currentStepId\n          case 'workflowId':\n            return workflowInstance.workflowId\n          case 'version':\n            return workflowInstance.version // Return as number\n          default:\n            return config // Return original if unknown\n        }\n      }\n\n      // Handle {{env.*}} variables\n      if (trimmedPath.startsWith('env.')) {\n        const envKey = trimmedPath.substring('env.'.length)\n        return process.env[envKey] ?? config\n      }\n\n      // Handle {{now}} - current timestamp\n      if (trimmedPath === 'now') {\n        return new Date().toISOString()\n      }\n\n      // Handle {{context.*}} variables (default behavior)\n      const contextPath = trimmedPath.startsWith('context.')\n        ? trimmedPath.substring('context.'.length)\n        : trimmedPath\n\n      const value = getNestedValue(context, contextPath)\n      return value !== undefined ? value : config // Return raw value to preserve type\n    }\n\n    // Multiple interpolations or mixed text - return string\n    return config.replace(/\\{\\{([^}]+)\\}\\}/g, (match, path) => {\n      const trimmedPath = path.trim()\n\n      // Handle {{workflow.*}} variables\n      if (trimmedPath.startsWith('workflow.') && workflowInstance) {\n        const workflowKey = trimmedPath.substring('workflow.'.length)\n        switch (workflowKey) {\n          case 'instanceId':\n            return workflowInstance.id\n          case 'tenantId':\n            return workflowInstance.tenantId\n          case 'organizationId':\n            return workflowInstance.organizationId\n          case 'currentStepId':\n            return workflowInstance.currentStepId\n          case 'workflowId':\n            return workflowInstance.workflowId\n          case 'version':\n            return String(workflowInstance.version)\n          default:\n            return match // Unknown workflow key\n        }\n      }\n\n      // Handle {{env.*}} variables\n      if (trimmedPath.startsWith('env.')) {\n        const envKey = trimmedPath.substring('env.'.length)\n        const envValue = process.env[envKey]\n        return envValue !== undefined ? envValue : match\n      }\n\n      // Handle {{now}} - current timestamp\n      if (trimmedPath === 'now') {\n        return new Date().toISOString()\n      }\n\n      // Handle {{context.*}} variables (default behavior)\n      const contextPath = trimmedPath.startsWith('context.')\n        ? trimmedPath.substring('context.'.length)\n        : trimmedPath\n\n      const value = getNestedValue(context, contextPath)\n      return value !== undefined ? String(value) : match\n    })\n  }\n\n  if (Array.isArray(config)) {\n    return config.map((item) => interpolateVariables(item, context, workflowInstance))\n  }\n\n  if (config && typeof config === 'object') {\n    const result: Record<string, any> = {}\n    for (const [key, value] of Object.entries(config)) {\n      result[key] = interpolateVariables(value, context, workflowInstance)\n    }\n    return result\n  }\n\n  return config\n}\n\n/**\n * Get nested value from object by path (e.g., \"user.email\")\n */\nfunction getNestedValue(obj: any, path: string): any {\n  const parts = path.split('.')\n  let value = obj\n\n  for (const part of parts) {\n    if (value && typeof value === 'object' && part in value) {\n      value = value[part]\n    } else {\n      return undefined\n    }\n  }\n\n  return value\n}\n\n/**\n * Calculate exponential backoff delay\n */\nfunction calculateBackoff(\n  initialIntervalMs: number,\n  backoffCoefficient: number,\n  attempt: number,\n  maxIntervalMs: number\n): number {\n  const backoff = initialIntervalMs * Math.pow(backoffCoefficient, attempt)\n  return Math.min(backoff, maxIntervalMs || Infinity)\n}\n\n/**\n * Sleep for specified milliseconds\n */\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms))\n}\n\n/**\n * Execute a promise with timeout\n */\nasync function executeWithTimeout<T>(\n  executor: () => Promise<T>,\n  timeoutMs: number\n): Promise<T> {\n  let timeoutId: NodeJS.Timeout\n\n  const timeoutPromise = new Promise<never>((_, reject) => {\n    timeoutId = setTimeout(() => {\n      reject(new Error(`Activity execution timeout after ${timeoutMs}ms`))\n    }, timeoutMs)\n  })\n\n  try {\n    return await Promise.race([executor(), timeoutPromise])\n  } finally {\n    clearTimeout(timeoutId!)\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/workflows/lib/activity-queue-types.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/activity-queue-types.ts"],
-  "sourcesContent": ["/**\n * Workflow Activity Queue Types\n *\n * Type definitions for async activity execution via queue system.\n * Jobs are discriminated by the optional `kind` field:\n *   - `'activity'` (default, back-compat): background execution of a workflow activity\n *   - `'timer'`: delayed fire-timer job for a WAIT_FOR_TIMER step\n */\n\nexport interface WorkflowActivityJobBase {\n  workflowInstanceId: string\n  stepInstanceId?: string\n  tenantId: string\n  organizationId: string\n  userId?: string\n}\n\nexport interface WorkflowActivityJobActivity extends WorkflowActivityJobBase {\n  kind?: 'activity'\n  transitionId?: string\n\n  activityId: string\n  activityName: string\n  activityType: string\n  activityConfig: any\n\n  workflowContext: Record<string, any>\n  stepContext?: Record<string, any>\n\n  retryPolicy?: {\n    maxAttempts: number\n    initialIntervalMs: number\n    backoffCoefficient: number\n    maxIntervalMs: number\n  }\n  timeoutMs?: number\n}\n\nexport interface WorkflowActivityJobTimer extends WorkflowActivityJobBase {\n  kind: 'timer'\n  stepInstanceId: string\n  fireAt: string // ISO 8601 timestamp for when the timer should fire\n}\n\nexport type WorkflowActivityJob = WorkflowActivityJobActivity | WorkflowActivityJobTimer\n\nexport const WORKFLOW_ACTIVITIES_QUEUE_NAME = 'workflow-activities'\n"],
-  "mappings": "AA8CO,MAAM,iCAAiC;",
+  "sourcesContent": ["/**\n * Workflow Activity Queue Types\n *\n * Type definitions for async activity execution via queue system.\n * Jobs are discriminated by the optional `kind` field:\n *   - `'activity'` (default, back-compat): background execution of a workflow activity\n *   - `'timer'`: delayed fire-timer job for a WAIT_FOR_TIMER step\n */\n\nexport interface WorkflowActivityJobBase {\n  workflowInstanceId: string\n  stepInstanceId?: string\n  // Set when the job belongs to a parallel branch; resume targets that branch.\n  // Absent on jobs enqueued before parallel support shipped \u2192 instance-level resume.\n  branchInstanceId?: string | null\n  tenantId: string\n  organizationId: string\n  userId?: string\n}\n\nexport interface WorkflowActivityJobActivity extends WorkflowActivityJobBase {\n  kind?: 'activity'\n  transitionId?: string\n\n  activityId: string\n  activityName: string\n  activityType: string\n  activityConfig: any\n\n  workflowContext: Record<string, any>\n  stepContext?: Record<string, any>\n\n  retryPolicy?: {\n    maxAttempts: number\n    initialIntervalMs: number\n    backoffCoefficient: number\n    maxIntervalMs: number\n  }\n  timeoutMs?: number\n}\n\nexport interface WorkflowActivityJobTimer extends WorkflowActivityJobBase {\n  kind: 'timer'\n  stepInstanceId: string\n  fireAt: string // ISO 8601 timestamp for when the timer should fire\n}\n\nexport type WorkflowActivityJob = WorkflowActivityJobActivity | WorkflowActivityJobTimer\n\nexport const WORKFLOW_ACTIVITIES_QUEUE_NAME = 'workflow-activities'\n"],
+  "mappings": "AAiDO,MAAM,iCAAiC;",
   "names": []
 }

package/dist/modules/workflows/lib/event-logger.js

@@ -55,6 +55,7 @@ async function logWorkflowEvent(em, event) {
   const workflowEvent = em.create(WorkflowEvent, {
     workflowInstanceId: event.workflowInstanceId,
     stepInstanceId: event.stepInstanceId || null,
+    branchInstanceId: event.branchInstanceId ?? null,
     eventType: event.eventType,
     eventData: event.eventData || {},
     userId: event.userId || null,
@@ -70,6 +71,7 @@ async function logWorkflowEvents(em, events) {
     (event) => em.create(WorkflowEvent, {
       workflowInstanceId: event.workflowInstanceId,
       stepInstanceId: event.stepInstanceId || null,
+      branchInstanceId: event.branchInstanceId ?? null,
       eventType: event.eventType,
       eventData: event.eventData || {},
       userId: event.userId || null,

package/dist/modules/workflows/lib/event-logger.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/workflows/lib/event-logger.ts"],
-  "sourcesContent": ["/**\n * Workflows Module - Event Logger Service\n *\n * Consolidates workflow event logging for audit trail and replay:\n * - Log workflow lifecycle events\n * - Log step execution events\n * - Log transition events\n * - Query event history\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport { WorkflowEvent } from '../data/entities'\n\n// ============================================================================\n// Event Type Constants\n// ============================================================================\n\nexport const WorkflowEventTypes = {\n  // Workflow lifecycle\n  WORKFLOW_STARTED: 'WORKFLOW_STARTED',\n  WORKFLOW_COMPLETED: 'WORKFLOW_COMPLETED',\n  WORKFLOW_FAILED: 'WORKFLOW_FAILED',\n  WORKFLOW_CANCELLED: 'WORKFLOW_CANCELLED',\n  WORKFLOW_PAUSED: 'WORKFLOW_PAUSED',\n  WORKFLOW_RESUMED: 'WORKFLOW_RESUMED',\n\n  // Step lifecycle\n  STEP_ENTERED: 'STEP_ENTERED',\n  STEP_EXITED: 'STEP_EXITED',\n  STEP_FAILED: 'STEP_FAILED',\n  STEP_SKIPPED: 'STEP_SKIPPED',\n\n  // Transition events\n  TRANSITION_EXECUTED: 'TRANSITION_EXECUTED',\n  TRANSITION_REJECTED: 'TRANSITION_REJECTED',\n  TRANSITION_POST_CONDITION_FAILED: 'TRANSITION_POST_CONDITION_FAILED',\n  TRANSITION_FAILED: 'TRANSITION_FAILED',\n\n  // Activity events\n  ACTIVITY_SCHEDULED: 'ACTIVITY_SCHEDULED',\n  ACTIVITY_STARTED: 'ACTIVITY_STARTED',\n  ACTIVITY_COMPLETED: 'ACTIVITY_COMPLETED',\n  ACTIVITY_FAILED: 'ACTIVITY_FAILED',\n  ACTIVITY_RETRY: 'ACTIVITY_RETRY',\n\n  // User task events\n  USER_TASK_CREATED: 'USER_TASK_CREATED',\n  USER_TASK_ASSIGNED: 'USER_TASK_ASSIGNED',\n  USER_TASK_STARTED: 'USER_TASK_STARTED',\n  USER_TASK_COMPLETED: 'USER_TASK_COMPLETED',\n  USER_TASK_CANCELLED: 'USER_TASK_CANCELLED',\n  USER_TASK_ESCALATED: 'USER_TASK_ESCALATED',\n\n  // Sub-workflow events (Phase 8)\n  SUB_WORKFLOW_STARTED: 'SUB_WORKFLOW_STARTED',\n  SUB_WORKFLOW_COMPLETED: 'SUB_WORKFLOW_COMPLETED',\n  SUB_WORKFLOW_FAILED: 'SUB_WORKFLOW_FAILED',\n\n  // Compensation events (Phase 8)\n  COMPENSATION_STARTED: 'COMPENSATION_STARTED',\n  COMPENSATION_COMPLETED: 'COMPENSATION_COMPLETED',\n  COMPENSATION_PARTIAL: 'COMPENSATION_PARTIAL',\n  COMPENSATION_FAILED: 'COMPENSATION_FAILED',\n  COMPENSATION_ACTIVITY_STARTED: 'COMPENSATION_ACTIVITY_STARTED',\n  COMPENSATION_ACTIVITY_COMPLETED: 'COMPENSATION_ACTIVITY_COMPLETED',\n  COMPENSATION_ACTIVITY_FAILED: 'COMPENSATION_ACTIVITY_FAILED',\n\n  // Signal events (Phase 9)\n  SIGNAL_AWAITING: 'SIGNAL_AWAITING',\n  SIGNAL_RECEIVED: 'SIGNAL_RECEIVED',\n  SIGNAL_TIMEOUT: 'SIGNAL_TIMEOUT',\n\n  // Timer events (Phase 9)\n  TIMER_AWAITING: 'TIMER_AWAITING',\n  TIMER_FIRED: 'TIMER_FIRED',\n  TIMER_CANCELLED: 'TIMER_CANCELLED',\n} as const\n\nexport type WorkflowEventType = typeof WorkflowEventTypes[keyof typeof WorkflowEventTypes]\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport interface WorkflowEventInput {\n  workflowInstanceId: string\n  stepInstanceId?: string\n  eventType: WorkflowEventType | string\n  eventData: any\n  userId?: string\n  tenantId: string\n  organizationId: string\n}\n\nexport interface QueryOptions {\n  eventTypes?: Array<WorkflowEventType | string>\n  stepInstanceId?: string\n  fromDate?: Date\n  toDate?: Date\n  limit?: number\n  offset?: number\n}\n\nexport interface EventStatistics {\n  totalEvents: number\n  eventsByType: Record<string, number>\n  firstEvent?: Date\n  lastEvent?: Date\n}\n\n// ============================================================================\n// Main Event Logging Functions\n// ============================================================================\n\n/**\n * Log a workflow event to the event sourcing table\n *\n * @param em - Entity manager\n * @param event - Event input data\n * @returns Created event entity\n */\nexport async function logWorkflowEvent(\n  em: EntityManager,\n  event: WorkflowEventInput\n): Promise<WorkflowEvent> {\n  const workflowEvent = em.create(WorkflowEvent, {\n    workflowInstanceId: event.workflowInstanceId,\n    stepInstanceId: event.stepInstanceId || null,\n    eventType: event.eventType,\n    eventData: event.eventData || {},\n    userId: event.userId || null,\n    tenantId: event.tenantId,\n    organizationId: event.organizationId,\n    occurredAt: new Date(),\n  })\n\n  await em.persist(workflowEvent).flush()\n\n  return workflowEvent\n}\n\n/**\n * Log multiple workflow events in batch\n *\n * @param em - Entity manager\n * @param events - Array of event input data\n * @returns Array of created event entities\n */\nexport async function logWorkflowEvents(\n  em: EntityManager,\n  events: WorkflowEventInput[]\n): Promise<WorkflowEvent[]> {\n  const workflowEvents = events.map(event =>\n    em.create(WorkflowEvent, {\n      workflowInstanceId: event.workflowInstanceId,\n      stepInstanceId: event.stepInstanceId || null,\n      eventType: event.eventType,\n      eventData: event.eventData || {},\n      userId: event.userId || null,\n      tenantId: event.tenantId,\n      organizationId: event.organizationId,\n      occurredAt: new Date(),\n    })\n  )\n\n  await em.persist(workflowEvents).flush()\n\n  return workflowEvents\n}\n\n// ============================================================================\n// Event Query Functions\n// ============================================================================\n\n/**\n * Get all events for a workflow instance\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @param options - Query options (filters, pagination)\n * @returns Array of workflow events\n */\nexport async function getWorkflowEvents(\n  em: EntityManager,\n  instanceId: string,\n  options?: QueryOptions\n): Promise<WorkflowEvent[]> {\n  const where: any = {\n    workflowInstanceId: instanceId,\n  }\n\n  // Filter by event types\n  if (options?.eventTypes && options.eventTypes.length > 0) {\n    where.eventType = { $in: options.eventTypes }\n  }\n\n  // Filter by step instance\n  if (options?.stepInstanceId) {\n    where.stepInstanceId = options.stepInstanceId\n  }\n\n  // Filter by date range\n  if (options?.fromDate || options?.toDate) {\n    where.occurredAt = {}\n    if (options.fromDate) {\n      where.occurredAt.$gte = options.fromDate\n    }\n    if (options.toDate) {\n      where.occurredAt.$lte = options.toDate\n    }\n  }\n\n  const events = await em.find(\n    WorkflowEvent,\n    where,\n    {\n      orderBy: { occurredAt: 'ASC' },\n      limit: options?.limit,\n      offset: options?.offset,\n    }\n  )\n\n  return events\n}\n\n/**\n * Get events for a specific step instance\n *\n * @param em - Entity manager\n * @param stepInstanceId - Step instance ID\n * @returns Array of workflow events\n */\nexport async function getStepEvents(\n  em: EntityManager,\n  stepInstanceId: string\n): Promise<WorkflowEvent[]> {\n  const events = await em.find(\n    WorkflowEvent,\n    { stepInstanceId },\n    { orderBy: { occurredAt: 'ASC' } }\n  )\n\n  return events\n}\n\n/**\n * Get the latest event for a workflow instance\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @param eventType - Optional event type filter\n * @returns Latest workflow event or null\n */\nexport async function getLatestEvent(\n  em: EntityManager,\n  instanceId: string,\n  eventType?: WorkflowEventType | string\n): Promise<WorkflowEvent | null> {\n  const where: any = {\n    workflowInstanceId: instanceId,\n  }\n\n  if (eventType) {\n    where.eventType = eventType\n  }\n\n  const event = await em.findOne(\n    WorkflowEvent,\n    where,\n    { orderBy: { occurredAt: 'DESC' } }\n  )\n\n  return event\n}\n\n/**\n * Count events for a workflow instance\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @param eventType - Optional event type filter\n * @returns Count of events\n */\nexport async function countEvents(\n  em: EntityManager,\n  instanceId: string,\n  eventType?: WorkflowEventType | string\n): Promise<number> {\n  const where: any = {\n    workflowInstanceId: instanceId,\n  }\n\n  if (eventType) {\n    where.eventType = eventType\n  }\n\n  return await em.count(WorkflowEvent, where)\n}\n\n/**\n * Get event statistics for a workflow instance\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @returns Event statistics\n */\nexport async function getEventStatistics(\n  em: EntityManager,\n  instanceId: string\n): Promise<EventStatistics> {\n  const events = await em.find(\n    WorkflowEvent,\n    { workflowInstanceId: instanceId },\n    { orderBy: { occurredAt: 'ASC' } }\n  )\n\n  const eventsByType: Record<string, number> = {}\n\n  for (const event of events) {\n    eventsByType[event.eventType] = (eventsByType[event.eventType] || 0) + 1\n  }\n\n  return {\n    totalEvents: events.length,\n    eventsByType,\n    firstEvent: events.length > 0 ? events[0].occurredAt : undefined,\n    lastEvent: events.length > 0 ? events[events.length - 1].occurredAt : undefined,\n  }\n}\n\n/**\n * Check if a specific event type has occurred for a workflow instance\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @param eventType - Event type to check\n * @returns True if event has occurred\n */\nexport async function hasEventOccurred(\n  em: EntityManager,\n  instanceId: string,\n  eventType: WorkflowEventType | string\n): Promise<boolean> {\n  const count = await em.count(WorkflowEvent, {\n    workflowInstanceId: instanceId,\n    eventType,\n  })\n\n  return count > 0\n}\n\n/**\n * Get event timeline for a workflow instance (simplified view)\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @returns Array of simplified event objects\n */\nexport async function getEventTimeline(\n  em: EntityManager,\n  instanceId: string\n): Promise<Array<{\n  eventType: string\n  occurredAt: Date\n  stepInstanceId?: string\n  userId?: string\n  summary: string\n}>> {\n  const events = await em.find(\n    WorkflowEvent,\n    { workflowInstanceId: instanceId },\n    { orderBy: { occurredAt: 'ASC' } }\n  )\n\n  return events.map(event => ({\n    eventType: event.eventType,\n    occurredAt: event.occurredAt,\n    stepInstanceId: event.stepInstanceId || undefined,\n    userId: event.userId || undefined,\n    summary: generateEventSummary(event),\n  }))\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Generate human-readable summary for an event\n */\nfunction generateEventSummary(event: WorkflowEvent): string {\n  const data = event.eventData || {}\n\n  switch (event.eventType) {\n    case WorkflowEventTypes.WORKFLOW_STARTED:\n      return `Workflow started${data.workflowId ? ` (${data.workflowId})` : ''}`\n\n    case WorkflowEventTypes.WORKFLOW_COMPLETED:\n      return `Workflow completed${data.result ? ` with result` : ''}`\n\n    case WorkflowEventTypes.WORKFLOW_FAILED:\n      return `Workflow failed${data.error ? `: ${data.error}` : ''}`\n\n    case WorkflowEventTypes.STEP_ENTERED:\n      return `Entered step: ${data.stepName || data.stepId || 'unknown'}`\n\n    case WorkflowEventTypes.STEP_EXITED:\n      return `Exited step: ${data.stepName || data.stepId || 'unknown'}${\n        data.executionTimeMs ? ` (${data.executionTimeMs}ms)` : ''\n      }`\n\n    case WorkflowEventTypes.STEP_FAILED:\n      return `Step failed: ${data.stepName || data.stepId || 'unknown'}${\n        data.error ? ` - ${data.error}` : ''\n      }`\n\n    case WorkflowEventTypes.TRANSITION_EXECUTED:\n      return `Transition: ${data.fromStepId} \u2192 ${data.toStepId}`\n\n    case WorkflowEventTypes.TRANSITION_REJECTED:\n      return `Transition blocked: ${data.fromStepId} \u2192 ${data.toStepId}${\n        data.reason ? ` (${data.reason})` : ''\n      }`\n\n    case WorkflowEventTypes.USER_TASK_CREATED:\n      return `User task created: ${data.taskName || 'unnamed'}${\n        data.assignedTo ? ` (assigned to ${data.assignedTo})` : ''\n      }`\n\n    case WorkflowEventTypes.USER_TASK_COMPLETED:\n      return `User task completed: ${data.taskName || 'unnamed'}`\n\n    case WorkflowEventTypes.ACTIVITY_COMPLETED:\n      return `Activity completed: ${data.activityName || data.activityId || 'unknown'}`\n\n    case WorkflowEventTypes.ACTIVITY_FAILED:\n      return `Activity failed: ${data.activityName || data.activityId || 'unknown'}${\n        data.error ? ` - ${data.error}` : ''\n      }`\n\n    case WorkflowEventTypes.COMPENSATION_STARTED:\n      return `Compensation started${data.reason ? `: ${data.reason}` : ''}`\n\n    case WorkflowEventTypes.COMPENSATION_COMPLETED:\n      return `Compensation completed: ${data.compensatedActivities || 0}/${data.totalActivities || 0} activities`\n\n    case WorkflowEventTypes.COMPENSATION_PARTIAL:\n      return `Partial compensation: ${data.compensatedActivities || 0}/${data.totalActivities || 0} succeeded`\n\n    case WorkflowEventTypes.COMPENSATION_FAILED:\n      return `Compensation failed: ${data.failedCompensations?.length || 0} activities failed`\n\n    case WorkflowEventTypes.COMPENSATION_ACTIVITY_STARTED:\n      return `Compensating: ${data.compensationActivityName || data.compensationActivityId || 'unknown'}`\n\n    case WorkflowEventTypes.COMPENSATION_ACTIVITY_COMPLETED:\n      return `Compensated: ${data.compensationActivityName || data.compensationActivityId || 'unknown'}`\n\n    case WorkflowEventTypes.COMPENSATION_ACTIVITY_FAILED:\n      return `Compensation failed: ${data.compensationActivityName || data.compensationActivityId || 'unknown'}${\n        data.error ? ` - ${data.error}` : ''\n      }`\n\n    default:\n      return event.eventType\n  }\n}\n\n/**\n * Validate event type is a known type\n */\nexport function isValidEventType(eventType: string): eventType is WorkflowEventType {\n  return Object.values(WorkflowEventTypes).includes(eventType as WorkflowEventType)\n}\n\n/**\n * Get all known event types\n */\nexport function getAllEventTypes(): WorkflowEventType[] {\n  return Object.values(WorkflowEventTypes)\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Workflows Module - Event Logger Service\n *\n * Consolidates workflow event logging for audit trail and replay:\n * - Log workflow lifecycle events\n * - Log step execution events\n * - Log transition events\n * - Query event history\n *\n * Functional API (no classes) following Open Mercato conventions.\n */\n\nimport { EntityManager } from '@mikro-orm/core'\nimport { WorkflowEvent } from '../data/entities'\n\n// ============================================================================\n// Event Type Constants\n// ============================================================================\n\nexport const WorkflowEventTypes = {\n  // Workflow lifecycle\n  WORKFLOW_STARTED: 'WORKFLOW_STARTED',\n  WORKFLOW_COMPLETED: 'WORKFLOW_COMPLETED',\n  WORKFLOW_FAILED: 'WORKFLOW_FAILED',\n  WORKFLOW_CANCELLED: 'WORKFLOW_CANCELLED',\n  WORKFLOW_PAUSED: 'WORKFLOW_PAUSED',\n  WORKFLOW_RESUMED: 'WORKFLOW_RESUMED',\n\n  // Step lifecycle\n  STEP_ENTERED: 'STEP_ENTERED',\n  STEP_EXITED: 'STEP_EXITED',\n  STEP_FAILED: 'STEP_FAILED',\n  STEP_SKIPPED: 'STEP_SKIPPED',\n\n  // Transition events\n  TRANSITION_EXECUTED: 'TRANSITION_EXECUTED',\n  TRANSITION_REJECTED: 'TRANSITION_REJECTED',\n  TRANSITION_POST_CONDITION_FAILED: 'TRANSITION_POST_CONDITION_FAILED',\n  TRANSITION_FAILED: 'TRANSITION_FAILED',\n\n  // Activity events\n  ACTIVITY_SCHEDULED: 'ACTIVITY_SCHEDULED',\n  ACTIVITY_STARTED: 'ACTIVITY_STARTED',\n  ACTIVITY_COMPLETED: 'ACTIVITY_COMPLETED',\n  ACTIVITY_FAILED: 'ACTIVITY_FAILED',\n  ACTIVITY_RETRY: 'ACTIVITY_RETRY',\n\n  // User task events\n  USER_TASK_CREATED: 'USER_TASK_CREATED',\n  USER_TASK_ASSIGNED: 'USER_TASK_ASSIGNED',\n  USER_TASK_STARTED: 'USER_TASK_STARTED',\n  USER_TASK_COMPLETED: 'USER_TASK_COMPLETED',\n  USER_TASK_CANCELLED: 'USER_TASK_CANCELLED',\n  USER_TASK_ESCALATED: 'USER_TASK_ESCALATED',\n\n  // Sub-workflow events (Phase 8)\n  SUB_WORKFLOW_STARTED: 'SUB_WORKFLOW_STARTED',\n  SUB_WORKFLOW_COMPLETED: 'SUB_WORKFLOW_COMPLETED',\n  SUB_WORKFLOW_FAILED: 'SUB_WORKFLOW_FAILED',\n\n  // Compensation events (Phase 8)\n  COMPENSATION_STARTED: 'COMPENSATION_STARTED',\n  COMPENSATION_COMPLETED: 'COMPENSATION_COMPLETED',\n  COMPENSATION_PARTIAL: 'COMPENSATION_PARTIAL',\n  COMPENSATION_FAILED: 'COMPENSATION_FAILED',\n  COMPENSATION_ACTIVITY_STARTED: 'COMPENSATION_ACTIVITY_STARTED',\n  COMPENSATION_ACTIVITY_COMPLETED: 'COMPENSATION_ACTIVITY_COMPLETED',\n  COMPENSATION_ACTIVITY_FAILED: 'COMPENSATION_ACTIVITY_FAILED',\n\n  // Signal events (Phase 9)\n  SIGNAL_AWAITING: 'SIGNAL_AWAITING',\n  SIGNAL_RECEIVED: 'SIGNAL_RECEIVED',\n  SIGNAL_TIMEOUT: 'SIGNAL_TIMEOUT',\n\n  // Timer events (Phase 9)\n  TIMER_AWAITING: 'TIMER_AWAITING',\n  TIMER_FIRED: 'TIMER_FIRED',\n  TIMER_CANCELLED: 'TIMER_CANCELLED',\n} as const\n\nexport type WorkflowEventType = typeof WorkflowEventTypes[keyof typeof WorkflowEventTypes]\n\n// ============================================================================\n// Types and Interfaces\n// ============================================================================\n\nexport interface WorkflowEventInput {\n  workflowInstanceId: string\n  stepInstanceId?: string\n  branchInstanceId?: string | null\n  eventType: WorkflowEventType | string\n  eventData: any\n  userId?: string\n  tenantId: string\n  organizationId: string\n}\n\nexport interface QueryOptions {\n  eventTypes?: Array<WorkflowEventType | string>\n  stepInstanceId?: string\n  fromDate?: Date\n  toDate?: Date\n  limit?: number\n  offset?: number\n}\n\nexport interface EventStatistics {\n  totalEvents: number\n  eventsByType: Record<string, number>\n  firstEvent?: Date\n  lastEvent?: Date\n}\n\n// ============================================================================\n// Main Event Logging Functions\n// ============================================================================\n\n/**\n * Log a workflow event to the event sourcing table\n *\n * @param em - Entity manager\n * @param event - Event input data\n * @returns Created event entity\n */\nexport async function logWorkflowEvent(\n  em: EntityManager,\n  event: WorkflowEventInput\n): Promise<WorkflowEvent> {\n  const workflowEvent = em.create(WorkflowEvent, {\n    workflowInstanceId: event.workflowInstanceId,\n    stepInstanceId: event.stepInstanceId || null,\n    branchInstanceId: event.branchInstanceId ?? null,\n    eventType: event.eventType,\n    eventData: event.eventData || {},\n    userId: event.userId || null,\n    tenantId: event.tenantId,\n    organizationId: event.organizationId,\n    occurredAt: new Date(),\n  })\n\n  await em.persist(workflowEvent).flush()\n\n  return workflowEvent\n}\n\n/**\n * Log multiple workflow events in batch\n *\n * @param em - Entity manager\n * @param events - Array of event input data\n * @returns Array of created event entities\n */\nexport async function logWorkflowEvents(\n  em: EntityManager,\n  events: WorkflowEventInput[]\n): Promise<WorkflowEvent[]> {\n  const workflowEvents = events.map(event =>\n    em.create(WorkflowEvent, {\n      workflowInstanceId: event.workflowInstanceId,\n      stepInstanceId: event.stepInstanceId || null,\n      branchInstanceId: event.branchInstanceId ?? null,\n      eventType: event.eventType,\n      eventData: event.eventData || {},\n      userId: event.userId || null,\n      tenantId: event.tenantId,\n      organizationId: event.organizationId,\n      occurredAt: new Date(),\n    })\n  )\n\n  await em.persist(workflowEvents).flush()\n\n  return workflowEvents\n}\n\n// ============================================================================\n// Event Query Functions\n// ============================================================================\n\n/**\n * Get all events for a workflow instance\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @param options - Query options (filters, pagination)\n * @returns Array of workflow events\n */\nexport async function getWorkflowEvents(\n  em: EntityManager,\n  instanceId: string,\n  options?: QueryOptions\n): Promise<WorkflowEvent[]> {\n  const where: any = {\n    workflowInstanceId: instanceId,\n  }\n\n  // Filter by event types\n  if (options?.eventTypes && options.eventTypes.length > 0) {\n    where.eventType = { $in: options.eventTypes }\n  }\n\n  // Filter by step instance\n  if (options?.stepInstanceId) {\n    where.stepInstanceId = options.stepInstanceId\n  }\n\n  // Filter by date range\n  if (options?.fromDate || options?.toDate) {\n    where.occurredAt = {}\n    if (options.fromDate) {\n      where.occurredAt.$gte = options.fromDate\n    }\n    if (options.toDate) {\n      where.occurredAt.$lte = options.toDate\n    }\n  }\n\n  const events = await em.find(\n    WorkflowEvent,\n    where,\n    {\n      orderBy: { occurredAt: 'ASC' },\n      limit: options?.limit,\n      offset: options?.offset,\n    }\n  )\n\n  return events\n}\n\n/**\n * Get events for a specific step instance\n *\n * @param em - Entity manager\n * @param stepInstanceId - Step instance ID\n * @returns Array of workflow events\n */\nexport async function getStepEvents(\n  em: EntityManager,\n  stepInstanceId: string\n): Promise<WorkflowEvent[]> {\n  const events = await em.find(\n    WorkflowEvent,\n    { stepInstanceId },\n    { orderBy: { occurredAt: 'ASC' } }\n  )\n\n  return events\n}\n\n/**\n * Get the latest event for a workflow instance\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @param eventType - Optional event type filter\n * @returns Latest workflow event or null\n */\nexport async function getLatestEvent(\n  em: EntityManager,\n  instanceId: string,\n  eventType?: WorkflowEventType | string\n): Promise<WorkflowEvent | null> {\n  const where: any = {\n    workflowInstanceId: instanceId,\n  }\n\n  if (eventType) {\n    where.eventType = eventType\n  }\n\n  const event = await em.findOne(\n    WorkflowEvent,\n    where,\n    { orderBy: { occurredAt: 'DESC' } }\n  )\n\n  return event\n}\n\n/**\n * Count events for a workflow instance\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @param eventType - Optional event type filter\n * @returns Count of events\n */\nexport async function countEvents(\n  em: EntityManager,\n  instanceId: string,\n  eventType?: WorkflowEventType | string\n): Promise<number> {\n  const where: any = {\n    workflowInstanceId: instanceId,\n  }\n\n  if (eventType) {\n    where.eventType = eventType\n  }\n\n  return await em.count(WorkflowEvent, where)\n}\n\n/**\n * Get event statistics for a workflow instance\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @returns Event statistics\n */\nexport async function getEventStatistics(\n  em: EntityManager,\n  instanceId: string\n): Promise<EventStatistics> {\n  const events = await em.find(\n    WorkflowEvent,\n    { workflowInstanceId: instanceId },\n    { orderBy: { occurredAt: 'ASC' } }\n  )\n\n  const eventsByType: Record<string, number> = {}\n\n  for (const event of events) {\n    eventsByType[event.eventType] = (eventsByType[event.eventType] || 0) + 1\n  }\n\n  return {\n    totalEvents: events.length,\n    eventsByType,\n    firstEvent: events.length > 0 ? events[0].occurredAt : undefined,\n    lastEvent: events.length > 0 ? events[events.length - 1].occurredAt : undefined,\n  }\n}\n\n/**\n * Check if a specific event type has occurred for a workflow instance\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @param eventType - Event type to check\n * @returns True if event has occurred\n */\nexport async function hasEventOccurred(\n  em: EntityManager,\n  instanceId: string,\n  eventType: WorkflowEventType | string\n): Promise<boolean> {\n  const count = await em.count(WorkflowEvent, {\n    workflowInstanceId: instanceId,\n    eventType,\n  })\n\n  return count > 0\n}\n\n/**\n * Get event timeline for a workflow instance (simplified view)\n *\n * @param em - Entity manager\n * @param instanceId - Workflow instance ID\n * @returns Array of simplified event objects\n */\nexport async function getEventTimeline(\n  em: EntityManager,\n  instanceId: string\n): Promise<Array<{\n  eventType: string\n  occurredAt: Date\n  stepInstanceId?: string\n  userId?: string\n  summary: string\n}>> {\n  const events = await em.find(\n    WorkflowEvent,\n    { workflowInstanceId: instanceId },\n    { orderBy: { occurredAt: 'ASC' } }\n  )\n\n  return events.map(event => ({\n    eventType: event.eventType,\n    occurredAt: event.occurredAt,\n    stepInstanceId: event.stepInstanceId || undefined,\n    userId: event.userId || undefined,\n    summary: generateEventSummary(event),\n  }))\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Generate human-readable summary for an event\n */\nfunction generateEventSummary(event: WorkflowEvent): string {\n  const data = event.eventData || {}\n\n  switch (event.eventType) {\n    case WorkflowEventTypes.WORKFLOW_STARTED:\n      return `Workflow started${data.workflowId ? ` (${data.workflowId})` : ''}`\n\n    case WorkflowEventTypes.WORKFLOW_COMPLETED:\n      return `Workflow completed${data.result ? ` with result` : ''}`\n\n    case WorkflowEventTypes.WORKFLOW_FAILED:\n      return `Workflow failed${data.error ? `: ${data.error}` : ''}`\n\n    case WorkflowEventTypes.STEP_ENTERED:\n      return `Entered step: ${data.stepName || data.stepId || 'unknown'}`\n\n    case WorkflowEventTypes.STEP_EXITED:\n      return `Exited step: ${data.stepName || data.stepId || 'unknown'}${\n        data.executionTimeMs ? ` (${data.executionTimeMs}ms)` : ''\n      }`\n\n    case WorkflowEventTypes.STEP_FAILED:\n      return `Step failed: ${data.stepName || data.stepId || 'unknown'}${\n        data.error ? ` - ${data.error}` : ''\n      }`\n\n    case WorkflowEventTypes.TRANSITION_EXECUTED:\n      return `Transition: ${data.fromStepId} \u2192 ${data.toStepId}`\n\n    case WorkflowEventTypes.TRANSITION_REJECTED:\n      return `Transition blocked: ${data.fromStepId} \u2192 ${data.toStepId}${\n        data.reason ? ` (${data.reason})` : ''\n      }`\n\n    case WorkflowEventTypes.USER_TASK_CREATED:\n      return `User task created: ${data.taskName || 'unnamed'}${\n        data.assignedTo ? ` (assigned to ${data.assignedTo})` : ''\n      }`\n\n    case WorkflowEventTypes.USER_TASK_COMPLETED:\n      return `User task completed: ${data.taskName || 'unnamed'}`\n\n    case WorkflowEventTypes.ACTIVITY_COMPLETED:\n      return `Activity completed: ${data.activityName || data.activityId || 'unknown'}`\n\n    case WorkflowEventTypes.ACTIVITY_FAILED:\n      return `Activity failed: ${data.activityName || data.activityId || 'unknown'}${\n        data.error ? ` - ${data.error}` : ''\n      }`\n\n    case WorkflowEventTypes.COMPENSATION_STARTED:\n      return `Compensation started${data.reason ? `: ${data.reason}` : ''}`\n\n    case WorkflowEventTypes.COMPENSATION_COMPLETED:\n      return `Compensation completed: ${data.compensatedActivities || 0}/${data.totalActivities || 0} activities`\n\n    case WorkflowEventTypes.COMPENSATION_PARTIAL:\n      return `Partial compensation: ${data.compensatedActivities || 0}/${data.totalActivities || 0} succeeded`\n\n    case WorkflowEventTypes.COMPENSATION_FAILED:\n      return `Compensation failed: ${data.failedCompensations?.length || 0} activities failed`\n\n    case WorkflowEventTypes.COMPENSATION_ACTIVITY_STARTED:\n      return `Compensating: ${data.compensationActivityName || data.compensationActivityId || 'unknown'}`\n\n    case WorkflowEventTypes.COMPENSATION_ACTIVITY_COMPLETED:\n      return `Compensated: ${data.compensationActivityName || data.compensationActivityId || 'unknown'}`\n\n    case WorkflowEventTypes.COMPENSATION_ACTIVITY_FAILED:\n      return `Compensation failed: ${data.compensationActivityName || data.compensationActivityId || 'unknown'}${\n        data.error ? ` - ${data.error}` : ''\n      }`\n\n    default:\n      return event.eventType\n  }\n}\n\n/**\n * Validate event type is a known type\n */\nexport function isValidEventType(eventType: string): eventType is WorkflowEventType {\n  return Object.values(WorkflowEventTypes).includes(eventType as WorkflowEventType)\n}\n\n/**\n * Get all known event types\n */\nexport function getAllEventTypes(): WorkflowEventType[] {\n  return Object.values(WorkflowEventTypes)\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/workflows/lib/execution-token.js

@@ -0,0 +1,98 @@
+function rootToken(instance) {
+  return { kind: "root", instance };
+}
+function branchToken(instance, branch) {
+  return { kind: "branch", instance, branch };
+}
+function tokenInstanceId(token) {
+  return token.instance.id;
+}
+function tokenDefinitionId(token) {
+  return token.instance.definitionId;
+}
+function tokenTenantId(token) {
+  return token.instance.tenantId;
+}
+function tokenOrganizationId(token) {
+  return token.instance.organizationId;
+}
+function tokenBranchInstanceId(token) {
+  return token.kind === "branch" ? token.branch.id : null;
+}
+function tokenCurrentStepId(token) {
+  return token.kind === "branch" ? token.branch.currentStepId : token.instance.currentStepId;
+}
+function setTokenCurrentStepId(token, stepId) {
+  if (token.kind === "branch") token.branch.currentStepId = stepId;
+  else token.instance.currentStepId = stepId;
+}
+function tokenReadContext(token) {
+  if (token.kind === "branch") {
+    return { ...token.instance.context || {}, ...token.branch.contextNamespace || {} };
+  }
+  return token.instance.context || {};
+}
+function applyTokenContextWrites(token, workflowContext, activityOutputs) {
+  if (token.kind === "branch") {
+    token.branch.contextNamespace = {
+      ...token.branch.contextNamespace || {},
+      ...activityOutputs
+    };
+    return;
+  }
+  token.instance.context = {
+    ...token.instance.context || {},
+    ...workflowContext,
+    ...activityOutputs
+  };
+}
+function setTokenWaitingForActivities(token) {
+  if (token.kind === "branch") token.branch.status = "WAITING_FOR_ACTIVITIES";
+  else token.instance.status = "WAITING_FOR_ACTIVITIES";
+}
+function setTokenPaused(token, at) {
+  if (token.kind === "branch") {
+    token.branch.status = "PAUSED";
+  } else {
+    token.instance.status = "PAUSED";
+    token.instance.pausedAt = at;
+  }
+}
+function getTokenPendingTransition(token) {
+  return (token.kind === "branch" ? token.branch.pendingTransition : token.instance.pendingTransition) ?? null;
+}
+function setTokenPendingTransition(token, pending) {
+  if (token.kind === "branch") token.branch.pendingTransition = pending;
+  else token.instance.pendingTransition = pending;
+}
+function touchToken(token, now) {
+  if (token.kind === "branch") token.branch.updatedAt = now;
+  else token.instance.updatedAt = now;
+}
+function mergeTokenContext(token, patch) {
+  if (token.kind === "branch") {
+    token.branch.contextNamespace = { ...token.branch.contextNamespace || {}, ...patch };
+  } else {
+    token.instance.context = { ...token.instance.context || {}, ...patch };
+  }
+}
+export {
+  applyTokenContextWrites,
+  branchToken,
+  getTokenPendingTransition,
+  mergeTokenContext,
+  rootToken,
+  setTokenCurrentStepId,
+  setTokenPaused,
+  setTokenPendingTransition,
+  setTokenWaitingForActivities,
+  tokenBranchInstanceId,
+  tokenCurrentStepId,
+  tokenDefinitionId,
+  tokenInstanceId,
+  tokenOrganizationId,
+  tokenReadContext,
+  tokenTenantId,
+  touchToken
+};
+//# sourceMappingURL=execution-token.js.map

package/dist/modules/workflows/lib/execution-token.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/workflows/lib/execution-token.ts"],
+  "sourcesContent": ["/**\n * Workflows Module - Execution Token Abstraction\n *\n * An execution token is the cursor the engine advances: it holds a\n * `currentStepId`, a read/write context scope, a status, and an optional\n * pending async transition. Today there are two kinds:\n *\n *  - **root token** \u2014 backed directly by the `WorkflowInstance`. Used for all\n *    single-token (FORK-less) execution. Every accessor maps 1:1 onto the\n *    instance fields, so the legacy single-token path is behaviourally\n *    unchanged.\n *  - **branch token** \u2014 backed by a `WorkflowBranchInstance` created by a\n *    PARALLEL_FORK. The branch shares the parent instance's identity (id,\n *    definition, tenant/org) for step-instance/event scoping, but owns its own\n *    `currentStepId`, private context namespace, status and pending transition.\n *\n * The handlers operate on tokens via these functional accessors so the same\n * step/transition logic serves both kinds.\n */\n\nimport type {\n  WorkflowInstance,\n  WorkflowBranchInstance,\n} from '../data/entities'\n\nexport interface PendingTransitionState {\n  toStepId: string\n  activityResults: any[]\n  timestamp: Date\n}\n\nexport type ExecutionToken =\n  | { kind: 'root'; instance: WorkflowInstance }\n  | { kind: 'branch'; instance: WorkflowInstance; branch: WorkflowBranchInstance }\n\n/** Build a root token backed by the instance (single-token execution). */\nexport function rootToken(instance: WorkflowInstance): ExecutionToken {\n  return { kind: 'root', instance }\n}\n\n/** Build a branch token backed by a branch instance of the given parent. */\nexport function branchToken(\n  instance: WorkflowInstance,\n  branch: WorkflowBranchInstance,\n): ExecutionToken {\n  return { kind: 'branch', instance, branch }\n}\n\n// ---------------------------------------------------------------------------\n// Identity (shared between root and branch \u2014 step instances and events are\n// always scoped to the parent WorkflowInstance, tagged with branchInstanceId).\n// ---------------------------------------------------------------------------\n\nexport function tokenInstanceId(token: ExecutionToken): string {\n  return token.instance.id\n}\n\nexport function tokenDefinitionId(token: ExecutionToken): string {\n  return token.instance.definitionId\n}\n\nexport function tokenTenantId(token: ExecutionToken): string {\n  return token.instance.tenantId\n}\n\nexport function tokenOrganizationId(token: ExecutionToken): string {\n  return token.instance.organizationId\n}\n\n/** The branch id this token represents, or null for the root token. */\nexport function tokenBranchInstanceId(token: ExecutionToken): string | null {\n  return token.kind === 'branch' ? token.branch.id : null\n}\n\n// ---------------------------------------------------------------------------\n// Cursor + context\n// ---------------------------------------------------------------------------\n\nexport function tokenCurrentStepId(token: ExecutionToken): string {\n  return token.kind === 'branch' ? token.branch.currentStepId : token.instance.currentStepId\n}\n\nexport function setTokenCurrentStepId(token: ExecutionToken, stepId: string): void {\n  if (token.kind === 'branch') token.branch.currentStepId = stepId\n  else token.instance.currentStepId = stepId\n}\n\n/**\n * Effective read context: for a branch this is the instance context (snapshot)\n * overlaid with the branch's private namespace, so a branch sees fork-time\n * instance state plus its own writes. For the root it is the instance context.\n */\nexport function tokenReadContext(token: ExecutionToken): Record<string, any> {\n  if (token.kind === 'branch') {\n    return { ...(token.instance.context || {}), ...(token.branch.contextNamespace || {}) }\n  }\n  return token.instance.context || {}\n}\n\n/**\n * Apply context writes after a transition. The root path is identical to the\n * legacy behaviour: merge the passed workflowContext and activity outputs into\n * `instance.context`. A branch writes only activity outputs (and any explicit\n * deltas the caller already folded into its namespace) into its private\n * namespace, never the shared instance snapshot \u2014 this prevents cross-branch\n * key collisions.\n */\nexport function applyTokenContextWrites(\n  token: ExecutionToken,\n  workflowContext: Record<string, any>,\n  activityOutputs: Record<string, any>,\n): void {\n  if (token.kind === 'branch') {\n    token.branch.contextNamespace = {\n      ...(token.branch.contextNamespace || {}),\n      ...activityOutputs,\n    }\n    return\n  }\n  token.instance.context = {\n    ...(token.instance.context || {}),\n    ...workflowContext,\n    ...activityOutputs,\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Status / pause state machine\n// ---------------------------------------------------------------------------\n\nexport function setTokenWaitingForActivities(token: ExecutionToken): void {\n  if (token.kind === 'branch') token.branch.status = 'WAITING_FOR_ACTIVITIES'\n  else token.instance.status = 'WAITING_FOR_ACTIVITIES'\n}\n\nexport function setTokenPaused(token: ExecutionToken, at: Date): void {\n  if (token.kind === 'branch') {\n    token.branch.status = 'PAUSED'\n  } else {\n    token.instance.status = 'PAUSED'\n    token.instance.pausedAt = at\n  }\n}\n\nexport function getTokenPendingTransition(token: ExecutionToken): PendingTransitionState | null {\n  return (token.kind === 'branch' ? token.branch.pendingTransition : token.instance.pendingTransition) ?? null\n}\n\nexport function setTokenPendingTransition(token: ExecutionToken, pending: PendingTransitionState | null): void {\n  if (token.kind === 'branch') token.branch.pendingTransition = pending\n  else token.instance.pendingTransition = pending\n}\n\nexport function touchToken(token: ExecutionToken, now: Date): void {\n  if (token.kind === 'branch') token.branch.updatedAt = now\n  else token.instance.updatedAt = now\n}\n\n/** Merge a patch into the token's own write scope (instance.context or branch namespace). */\nexport function mergeTokenContext(token: ExecutionToken, patch: Record<string, any>): void {\n  if (token.kind === 'branch') {\n    token.branch.contextNamespace = { ...(token.branch.contextNamespace || {}), ...patch }\n  } else {\n    token.instance.context = { ...(token.instance.context || {}), ...patch }\n  }\n}\n"],
+  "mappings": "AAoCO,SAAS,UAAU,UAA4C;AACpE,SAAO,EAAE,MAAM,QAAQ,SAAS;AAClC;AAGO,SAAS,YACd,UACA,QACgB;AAChB,SAAO,EAAE,MAAM,UAAU,UAAU,OAAO;AAC5C;AAOO,SAAS,gBAAgB,OAA+B;AAC7D,SAAO,MAAM,SAAS;AACxB;AAEO,SAAS,kBAAkB,OAA+B;AAC/D,SAAO,MAAM,SAAS;AACxB;AAEO,SAAS,cAAc,OAA+B;AAC3D,SAAO,MAAM,SAAS;AACxB;AAEO,SAAS,oBAAoB,OAA+B;AACjE,SAAO,MAAM,SAAS;AACxB;AAGO,SAAS,sBAAsB,OAAsC;AAC1E,SAAO,MAAM,SAAS,WAAW,MAAM,OAAO,KAAK;AACrD;AAMO,SAAS,mBAAmB,OAA+B;AAChE,SAAO,MAAM,SAAS,WAAW,MAAM,OAAO,gBAAgB,MAAM,SAAS;AAC/E;AAEO,SAAS,sBAAsB,OAAuB,QAAsB;AACjF,MAAI,MAAM,SAAS,SAAU,OAAM,OAAO,gBAAgB;AAAA,MACrD,OAAM,SAAS,gBAAgB;AACtC;AAOO,SAAS,iBAAiB,OAA4C;AAC3E,MAAI,MAAM,SAAS,UAAU;AAC3B,WAAO,EAAE,GAAI,MAAM,SAAS,WAAW,CAAC,GAAI,GAAI,MAAM,OAAO,oBAAoB,CAAC,EAAG;AAAA,EACvF;AACA,SAAO,MAAM,SAAS,WAAW,CAAC;AACpC;AAUO,SAAS,wBACd,OACA,iBACA,iBACM;AACN,MAAI,MAAM,SAAS,UAAU;AAC3B,UAAM,OAAO,mBAAmB;AAAA,MAC9B,GAAI,MAAM,OAAO,oBAAoB,CAAC;AAAA,MACtC,GAAG;AAAA,IACL;AACA;AAAA,EACF;AACA,QAAM,SAAS,UAAU;AAAA,IACvB,GAAI,MAAM,SAAS,WAAW,CAAC;AAAA,IAC/B,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AACF;AAMO,SAAS,6BAA6B,OAA6B;AACxE,MAAI,MAAM,SAAS,SAAU,OAAM,OAAO,SAAS;AAAA,MAC9C,OAAM,SAAS,SAAS;AAC/B;AAEO,SAAS,eAAe,OAAuB,IAAgB;AACpE,MAAI,MAAM,SAAS,UAAU;AAC3B,UAAM,OAAO,SAAS;AAAA,EACxB,OAAO;AACL,UAAM,SAAS,SAAS;AACxB,UAAM,SAAS,WAAW;AAAA,EAC5B;AACF;AAEO,SAAS,0BAA0B,OAAsD;AAC9F,UAAQ,MAAM,SAAS,WAAW,MAAM,OAAO,oBAAoB,MAAM,SAAS,sBAAsB;AAC1G;AAEO,SAAS,0BAA0B,OAAuB,SAA8C;AAC7G,MAAI,MAAM,SAAS,SAAU,OAAM,OAAO,oBAAoB;AAAA,MACzD,OAAM,SAAS,oBAAoB;AAC1C;AAEO,SAAS,WAAW,OAAuB,KAAiB;AACjE,MAAI,MAAM,SAAS,SAAU,OAAM,OAAO,YAAY;AAAA,MACjD,OAAM,SAAS,YAAY;AAClC;AAGO,SAAS,kBAAkB,OAAuB,OAAkC;AACzF,MAAI,MAAM,SAAS,UAAU;AAC3B,UAAM,OAAO,mBAAmB,EAAE,GAAI,MAAM,OAAO,oBAAoB,CAAC,GAAI,GAAG,MAAM;AAAA,EACvF,OAAO;AACL,UAAM,SAAS,UAAU,EAAE,GAAI,MAAM,SAAS,WAAW,CAAC,GAAI,GAAG,MAAM;AAAA,EACzE;AACF;",
+  "names": []
+}

package/dist/modules/workflows/lib/node-type-icons.js

@@ -1,4 +1,4 @@
-import { CircleDot, CircleStop, User, Zap, Workflow, Clock, Timer } from "lucide-react";
+import { CircleDot, CircleStop, User, Zap, Workflow, Clock, Timer, Split, Merge } from "lucide-react";
 const NODE_TYPE_ICONS = {
   start: CircleDot,
   end: CircleStop,
@@ -6,7 +6,9 @@ const NODE_TYPE_ICONS = {
   automated: Zap,
   subWorkflow: Workflow,
   waitForSignal: Clock,
-  waitForTimer: Timer
+  waitForTimer: Timer,
+  parallelFork: Split,
+  parallelJoin: Merge
 };
 const NODE_TYPE_COLORS = {
   start: "text-emerald-500",
@@ -15,7 +17,10 @@ const NODE_TYPE_COLORS = {
   automated: "text-amber-500",
   subWorkflow: "text-purple-500",
   waitForSignal: "text-purple-500",
-  waitForTimer: "text-cyan-500"
+  waitForTimer: "text-cyan-500",
+  // New nodes use a semantic token (DS rule: no hardcoded color shades).
+  parallelFork: "text-primary",
+  parallelJoin: "text-primary"
 };
 const NODE_TYPE_LABELS = {
   start: { title: "START", description: "Workflow trigger" },
@@ -24,7 +29,9 @@ const NODE_TYPE_LABELS = {
   automated: { title: "AUTOMATED", description: "System task" },
   subWorkflow: { title: "SUB-WORKFLOW", description: "Invoke workflow" },
   waitForSignal: { title: "WAIT FOR SIGNAL", description: "Pause for external event" },
-  waitForTimer: { title: "WAIT FOR TIMER", description: "Pause for a duration" }
+  waitForTimer: { title: "WAIT FOR TIMER", description: "Pause for a duration" },
+  parallelFork: { title: "PARALLEL FORK", description: "Split into parallel branches" },
+  parallelJoin: { title: "PARALLEL JOIN", description: "Wait for all branches" }
 };
 const STEP_TYPE_TO_NODE_TYPE = {
   START: "start",
@@ -33,7 +40,9 @@ const STEP_TYPE_TO_NODE_TYPE = {
   AUTOMATED: "automated",
   SUB_WORKFLOW: "subWorkflow",
   WAIT_FOR_SIGNAL: "waitForSignal",
-  WAIT_FOR_TIMER: "waitForTimer"
+  WAIT_FOR_TIMER: "waitForTimer",
+  PARALLEL_FORK: "parallelFork",
+  PARALLEL_JOIN: "parallelJoin"
 };
 function stepTypeToNodeType(stepType) {
   return STEP_TYPE_TO_NODE_TYPE[stepType] || "automated";