alepha 0.19.3 → 0.19.4

package/dist/api/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/api/workflows/schemas/workflowActivitySchema.ts","../../../src/api/workflows/entities/workflowExecutions.ts","../../../src/api/workflows/schemas/workflowExecutionResourceSchema.ts","../../../src/api/workflows/entities/workflowStepExecutions.ts","../../../src/api/workflows/schemas/workflowStepExecutionResourceSchema.ts","../../../src/api/workflows/schemas/workflowExecutionDetailSchema.ts","../../../src/api/workflows/schemas/workflowExecutionQuerySchema.ts","../../../src/api/workflows/schemas/workflowRegistrationSchema.ts","../../../src/api/workflows/schemas/workflowStatsSchema.ts","../../../src/api/workflows/entities/workflowStepLogs.ts","../../../src/api/workflows/schemas/workflowConfigAtom.ts","../../../src/api/workflows/providers/WorkflowProvider.ts","../../../src/api/workflows/services/WorkflowService.ts","../../../src/api/workflows/controllers/AdminWorkflowController.ts","../../../src/api/workflows/jobs/WorkflowJobs.ts","../../../src/api/workflows/primitives/$workflow.ts","../../../src/api/workflows/index.ts"],"sourcesContent":["import { type Static, t } from \"alepha\";\n\nexport const workflowActivityPointSchema = t.object({\n  date: t.text(),\n  completed: t.integer(),\n  failed: t.integer(),\n});\n\nexport type WorkflowActivityPoint = Static<typeof workflowActivityPointSchema>;\n\nexport const workflowActivityQuerySchema = t.object({\n  days: t.optional(t.integer({ minimum: 1, maximum: 90 })),\n});\n\nexport type WorkflowActivityQuery = Static<typeof workflowActivityQuerySchema>;\n","import { type Static, t } from \"alepha\";\nimport { $entity, db, sql } from \"alepha/orm\";\n\nexport const workflowExecutions = $entity({\n  name: \"workflow_executions\",\n  schema: t.object({\n    id: db.primaryKey(t.uuid()),\n    createdAt: db.createdAt(),\n    updatedAt: db.updatedAt(),\n\n    workflowName: t.text(),\n    tags: t.optional(t.array(t.text())),\n\n    payload: t.optional(t.record(t.text(), t.any())),\n\n    status: db.default(\n      t.enum([\n        \"pending\",\n        \"running\",\n        \"waiting_for_signal\",\n        \"completed\",\n        \"failed\",\n        \"timed_out\",\n        \"compensating\",\n        \"compensated\",\n        \"compensation_failed\",\n        \"cancelled\",\n      ]),\n      \"pending\",\n    ),\n    currentStep: t.optional(t.text()),\n\n    startedAt: t.optional(t.datetime()),\n    completedAt: t.optional(t.datetime()),\n    deadlineAt: t.optional(t.datetime()),\n\n    error: t.optional(t.text()),\n    errorStep: t.optional(t.text()),\n\n    triggeredBy: t.optional(t.text()),\n    triggeredByName: t.optional(t.text()),\n    cancelledBy: t.optional(t.text()),\n    cancelledByName: t.optional(t.text()),\n\n    key: t.optional(t.nullable(t.text())),\n\n    priority: db.default(t.integer({ minimum: 0, maximum: 3 }), 2),\n  }),\n  indexes: [\n    { columns: [\"workflowName\", \"status\"] },\n    { columns: [\"workflowName\", \"status\", \"createdAt\"] },\n    {\n      columns: [\"workflowName\", \"key\"],\n      unique: true,\n      where: sql`status NOT IN ('completed', 'failed', 'compensated', 'compensation_failed', 'cancelled')`,\n    },\n    { columns: [\"status\", \"deadlineAt\"] },\n    { columns: [\"completedAt\"] },\n  ],\n});\n\nexport type WorkflowExecutionEntity = Static<typeof workflowExecutions.schema>;\n\nexport type WorkflowStatus =\n  | \"pending\"\n  | \"running\"\n  | \"waiting_for_signal\"\n  | \"completed\"\n  | \"failed\"\n  | \"timed_out\"\n  | \"compensating\"\n  | \"compensated\"\n  | \"compensation_failed\"\n  | \"cancelled\";\n","import { type Static, t } from \"alepha\";\nimport { workflowExecutions } from \"../entities/workflowExecutions.ts\";\n\nexport const workflowExecutionCanSchema = t.object({\n  retry: t.boolean(),\n  cancel: t.boolean(),\n  compensate: t.boolean(),\n  restart: t.boolean(),\n  signal: t.optional(\n    t.object({\n      stepName: t.text(),\n      schema: t.optional(t.any()),\n    }),\n  ),\n});\n\nexport type WorkflowExecutionCan = Static<typeof workflowExecutionCanSchema>;\n\nexport const workflowExecutionResourceSchema = t.extend(\n  workflowExecutions.schema,\n  { can: workflowExecutionCanSchema },\n  {\n    title: \"WorkflowExecutionResource\",\n    description: \"A workflow execution resource.\",\n  },\n);\n\nexport type WorkflowExecutionResource = Static<\n  typeof workflowExecutionResourceSchema\n>;\n","import { type Static, t } from \"alepha\";\nimport { $entity, db } from \"alepha/orm\";\nimport { workflowExecutions } from \"./workflowExecutions.ts\";\n\nexport const workflowStepExecutions = $entity({\n  name: \"workflow_step_executions\",\n  schema: t.object({\n    id: db.primaryKey(t.uuid()),\n    createdAt: db.createdAt(),\n    updatedAt: db.updatedAt(),\n\n    workflowExecutionId: db.ref(t.uuid(), () => workflowExecutions.cols.id, {\n      onDelete: \"cascade\",\n    }),\n\n    stepName: t.text(),\n    stepIndex: t.integer(),\n    stepType: db.default(t.enum([\"handler\", \"signal\", \"parallel\"]), \"handler\"),\n\n    parentStepId: t.optional(t.uuid()),\n    branchName: t.optional(t.text()),\n\n    status: db.default(\n      t.enum([\n        \"pending\",\n        \"running\",\n        \"completed\",\n        \"failed\",\n        \"skipped\",\n        \"waiting\",\n        \"compensating\",\n        \"compensated\",\n        \"compensation_failed\",\n        \"cancelled\",\n      ]),\n      \"pending\",\n    ),\n    attempt: db.default(t.integer(), 0),\n    maxAttempts: db.default(t.integer(), 1),\n\n    result: t.optional(t.record(t.text(), t.any())),\n    error: t.optional(t.text()),\n\n    startedAt: t.optional(t.datetime()),\n    completedAt: t.optional(t.datetime()),\n    deadlineAt: t.optional(t.datetime()),\n\n    signalPayload: t.optional(t.record(t.text(), t.any())),\n    signalledBy: t.optional(t.text()),\n    signalledAt: t.optional(t.datetime()),\n  }),\n  indexes: [\n    { columns: [\"workflowExecutionId\", \"stepName\"] },\n    { columns: [\"workflowExecutionId\", \"stepIndex\"] },\n    { columns: [\"workflowExecutionId\", \"status\"] },\n    { columns: [\"status\", \"deadlineAt\"] },\n  ],\n});\n\nexport type WorkflowStepExecutionEntity = Static<\n  typeof workflowStepExecutions.schema\n>;\n\nexport type WorkflowStepStatus =\n  | \"pending\"\n  | \"running\"\n  | \"completed\"\n  | \"failed\"\n  | \"skipped\"\n  | \"waiting\"\n  | \"compensating\"\n  | \"compensated\"\n  | \"compensation_failed\"\n  | \"cancelled\";\n","import { type Static, t } from \"alepha\";\nimport { workflowStepExecutions } from \"../entities/workflowStepExecutions.ts\";\n\nexport const workflowStepExecutionResourceSchema = t.extend(\n  workflowStepExecutions.schema,\n  {},\n  {\n    title: \"WorkflowStepExecutionResource\",\n    description: \"A workflow step execution resource.\",\n  },\n);\n\nexport type WorkflowStepExecutionResource = Static<\n  typeof workflowStepExecutionResourceSchema\n>;\n","import { type Static, t } from \"alepha\";\nimport { workflowExecutionResourceSchema } from \"./workflowExecutionResourceSchema.ts\";\nimport { workflowStepExecutionResourceSchema } from \"./workflowStepExecutionResourceSchema.ts\";\n\nexport const workflowExecutionDetailSchema = t.extend(\n  workflowExecutionResourceSchema,\n  {\n    steps: t.array(workflowStepExecutionResourceSchema),\n  },\n  {\n    title: \"WorkflowExecutionDetail\",\n    description: \"A workflow execution with step details.\",\n  },\n);\n\nexport type WorkflowExecutionDetail = Static<\n  typeof workflowExecutionDetailSchema\n>;\n","import { type Static, t } from \"alepha\";\nimport { pageQuerySchema } from \"alepha/orm\";\n\nexport const workflowExecutionQuerySchema = t.extend(pageQuerySchema, {\n  workflow: t.optional(t.text({ description: \"Filter by workflow name\" })),\n  status: t.optional(\n    t.enum([\n      \"pending\",\n      \"running\",\n      \"waiting_for_signal\",\n      \"completed\",\n      \"failed\",\n      \"timed_out\",\n      \"compensating\",\n      \"compensated\",\n      \"compensation_failed\",\n      \"cancelled\",\n    ]),\n  ),\n  from: t.optional(t.datetime({ description: \"From date (ISO)\" })),\n  to: t.optional(t.datetime({ description: \"To date (ISO)\" })),\n});\n\nexport type WorkflowExecutionQuery = Static<\n  typeof workflowExecutionQuerySchema\n>;\n","import { type Static, t } from \"alepha\";\n\nexport const workflowRegistrationSchema = t.object({\n  name: t.text(),\n  stepCount: t.integer(),\n  steps: t.array(\n    t.object({\n      name: t.text(),\n      type: t.enum([\"handler\", \"signal\", \"parallel\"]),\n      hasCompensate: t.boolean(),\n      hasRetry: t.boolean(),\n      timeout: t.optional(t.text()),\n    }),\n  ),\n  onError: t.enum([\"compensate\", \"fail\"]),\n  timeout: t.optional(t.text()),\n  priority: t.text(),\n  tags: t.optional(t.array(t.text())),\n  paused: t.boolean(),\n  running: t.integer(),\n  pending: t.integer(),\n  waiting: t.integer(),\n  failed: t.integer(),\n});\n\nexport type WorkflowRegistration = Static<typeof workflowRegistrationSchema>;\n","import { type Static, t } from \"alepha\";\n\nexport const workflowStatsSchema = t.object({\n  registered: t.integer(),\n  running: t.integer(),\n  pending: t.integer(),\n  waiting: t.integer(),\n  completed: t.integer(),\n  failed: t.integer(),\n  compensated: t.integer(),\n  compensationFailed: t.integer(),\n  cancelled: t.integer(),\n  timedOut: t.integer(),\n});\n\nexport type WorkflowStats = Static<typeof workflowStatsSchema>;\n","import { type Static, t } from \"alepha\";\nimport { logEntrySchema } from \"alepha/logger\";\nimport { $entity, db } from \"alepha/orm\";\n\nexport const workflowStepLogs = $entity({\n  name: \"workflow_step_logs\",\n  schema: t.object({\n    id: db.primaryKey(t.uuid()),\n    logs: t.array(logEntrySchema),\n  }),\n});\n\nexport type WorkflowStepLogEntity = Static<typeof workflowStepLogs.schema>;\n","import { $atom, type Static, t } from \"alepha\";\n\nexport const workflowConfig = $atom({\n  name: \"alepha.workflows\",\n  description: \"Configuration for the workflow engine.\",\n  schema: t.object({\n    defaultStepTimeout: t.integer({\n      description:\n        \"Default step timeout (ms). Used when no per-step timeout is set.\",\n    }),\n    retentionDays: t.integer({\n      description: \"Days to keep completed/failed workflow executions.\",\n    }),\n    recovery: t.object({\n      staleThreshold: t.integer({\n        description: \"Running step age (ms) before assumed crashed.\",\n      }),\n    }),\n    maxConcurrentWorkflows: t.integer({\n      description: \"Max concurrent running instances per workflow name.\",\n    }),\n    maxStepsPerWorkflow: t.integer({\n      description: \"Safety limit on step count.\",\n    }),\n    drainTimeout: t.integer({\n      description: \"Max time (ms) to wait for in-flight steps during shutdown.\",\n    }),\n    logMaxEntries: t.integer({\n      description: \"Max log entries captured per step execution.\",\n    }),\n  }),\n  default: {\n    defaultStepTimeout: 300_000,\n    retentionDays: 30,\n    recovery: {\n      staleThreshold: 1_800_000,\n    },\n    maxConcurrentWorkflows: 50,\n    maxStepsPerWorkflow: 100,\n    drainTimeout: 30_000,\n    logMaxEntries: 100,\n  },\n});\n\nexport type WorkflowConfig = Static<typeof workflowConfig.schema>;\n\ndeclare module \"alepha\" {\n  interface State {\n    [workflowConfig.key]: WorkflowConfig;\n  }\n}\n","import {\n  $hook,\n  $inject,\n  $state,\n  Alepha,\n  AlephaError,\n  type Static,\n  type TSchema,\n} from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { LockProvider } from \"alepha/lock\";\nimport type { LogEntry } from \"alepha/logger\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository } from \"alepha/orm\";\nimport {\n  type WorkflowExecutionEntity,\n  type WorkflowStatus,\n  workflowExecutions,\n} from \"../entities/workflowExecutions.ts\";\nimport {\n  type WorkflowStepExecutionEntity,\n  workflowStepExecutions,\n} from \"../entities/workflowStepExecutions.ts\";\nimport { workflowStepLogs } from \"../entities/workflowStepLogs.ts\";\nimport type {\n  HandlerStep,\n  WorkflowPrimitive,\n  WorkflowPrimitiveOptions,\n  WorkflowRetryBackoff,\n  WorkflowRetryOptions,\n  WorkflowStartOptions,\n} from \"../primitives/$workflow.ts\";\nimport { workflowConfig } from \"../schemas/workflowConfigAtom.ts\";\n\n// -----------------------------------------------------------------------------------------------------------------\n\nconst PRIORITY_MAP: Record<string, number> = {\n  critical: 0,\n  high: 1,\n  normal: 2,\n  low: 3,\n};\n\ninterface WorkflowRegistration {\n  name: string;\n  options: WorkflowPrimitiveOptions;\n}\n\nexport interface CancelOptions {\n  compensate?: boolean;\n  cancelledBy?: string;\n  cancelledByName?: string;\n}\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport class WorkflowProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly dt = $inject(DateTimeProvider);\n  protected readonly lockProvider = $inject(LockProvider);\n  protected readonly config = $state(workflowConfig);\n  protected readonly log = $logger();\n  protected readonly executions = $repository(workflowExecutions);\n  protected readonly stepExecutions = $repository(workflowStepExecutions);\n  protected readonly stepLogs = $repository(workflowStepLogs);\n\n  protected readonly workflows = new Map<string, WorkflowRegistration>();\n  protected readonly pausedWorkflows = new Set<string>();\n  protected readonly inFlight = new Set<Promise<void>>();\n  protected readonly abortControllers = new Map<string, AbortController>();\n  protected readonly logs = new Map<string, LogEntry[]>();\n  protected stopping = false;\n\n  /**\n   * When set, step dispatches go through a queue.\n   * Set by WorkflowJobs on start.\n   */\n  public stepDispatch:\n    | ((\n        workflowId: string,\n        stepName: string,\n        priority: number,\n      ) => Promise<void>)\n    | null = null;\n\n  // --- Registration ---\n\n  public register(primitive: WorkflowPrimitive<any>): void {\n    if (this.workflows.has(primitive.name)) {\n      throw new AlephaError(`Workflow already registered: ${primitive.name}`);\n    }\n    this.workflows.set(primitive.name, {\n      name: primitive.name,\n      options: primitive.options,\n    });\n    this.log.debug(`Registered workflow '${primitive.name}'`, {\n      steps: primitive.options.steps.length,\n    });\n  }\n\n  public getRegisteredWorkflows(): Map<string, WorkflowRegistration> {\n    return this.workflows;\n  }\n\n  // --- Start ---\n\n  public async start(\n    workflowName: string,\n    payload: unknown,\n    options?: WorkflowStartOptions,\n  ): Promise<string> {\n    const registration = this.getRegistration(workflowName);\n    const opts = registration.options;\n\n    // Validate payload\n    const validated = this.alepha.codec.validate(opts.schema, payload);\n\n    const priority =\n      PRIORITY_MAP[options?.priority ?? opts.priority ?? \"normal\"];\n    const status: WorkflowStatus = options?.delay ? \"pending\" : \"running\";\n\n    // Compute deadline\n    let deadlineAt: string | undefined;\n    if (opts.timeout) {\n      deadlineAt = this.dt\n        .now()\n        .add(this.dt.duration(opts.timeout))\n        .toISOString();\n    }\n\n    // Keyed deduplication\n    if (options?.key) {\n      const existing = await this.executions.findMany({\n        where: {\n          workflowName: { eq: workflowName },\n          key: { eq: options.key },\n          status: {\n            inArray: [\n              \"pending\",\n              \"running\",\n              \"waiting_for_signal\",\n              \"compensating\",\n            ],\n          },\n        },\n        limit: 1,\n      });\n      if (existing.length > 0) {\n        return existing[0].id;\n      }\n    }\n\n    // Create workflow execution\n    const execution = await this.executions.create({\n      workflowName,\n      payload: validated as Record<string, unknown>,\n      status,\n      priority,\n      deadlineAt,\n      key: options?.key,\n      triggeredBy: options?.triggeredBy,\n      triggeredByName: options?.triggeredByName,\n      tags: options?.tags ?? opts.tags,\n      startedAt: status === \"running\" ? this.dt.nowISOString() : undefined,\n    });\n\n    // Create step execution records\n    for (let i = 0; i < opts.steps.length; i++) {\n      const step = opts.steps[i];\n      const retryOpts = step.retry;\n      await this.stepExecutions.create({\n        workflowExecutionId: execution.id,\n        stepName: step.name,\n        stepIndex: i,\n        stepType: step.type ?? \"handler\",\n        status: \"pending\",\n        maxAttempts: (retryOpts?.retries ?? 0) + 1,\n      });\n    }\n\n    this.log.info(`Started workflow '${workflowName}'`, {\n      workflowId: execution.id,\n      steps: opts.steps.length,\n    });\n\n    await this.alepha.events.emit(\n      \"workflow:started\",\n      {\n        workflowName,\n        workflowId: execution.id,\n      },\n      { catch: true },\n    );\n\n    // Dispatch first step\n    if (status === \"running\" && !this.stopping) {\n      const firstStep = opts.steps[0];\n      if (firstStep) {\n        await this.dispatchStep(execution.id, firstStep.name, priority);\n      } else {\n        // No steps — complete immediately\n        await this.executions.updateById(execution.id, {\n          status: \"completed\",\n          completedAt: this.dt.nowISOString(),\n        });\n      }\n    }\n\n    return execution.id;\n  }\n\n  // --- Process Step ---\n\n  public async processStep(\n    workflowId: string,\n    stepName: string,\n  ): Promise<void> {\n    const promise = this.processStepInner(workflowId, stepName);\n    this.inFlight.add(promise);\n    try {\n      await promise;\n    } finally {\n      this.inFlight.delete(promise);\n    }\n  }\n\n  protected async processStepInner(\n    workflowId: string,\n    stepName: string,\n  ): Promise<void> {\n    // Acquire workflow-level lock\n    const lockKey = `workflow:${workflowId}`;\n    const lockValue = `${crypto.randomUUID()},${this.dt.nowISOString()}`;\n    const lockResult = await this.lockProvider.set(\n      lockKey,\n      lockValue,\n      true,\n      600_000,\n    );\n    const [lockId] = lockResult.split(\",\");\n    if (lockId !== lockValue.split(\",\")[0]) {\n      this.log.debug(\n        `Workflow ${workflowId} locked by another worker, skipping`,\n      );\n      return;\n    }\n\n    try {\n      const workflow = await this.executions.findById(workflowId);\n      if (!workflow) return;\n\n      if (workflow.status !== \"running\" && workflow.status !== \"pending\") {\n        return;\n      }\n\n      // Transition pending → running if needed\n      if (workflow.status === \"pending\") {\n        await this.executions.updateById(workflowId, {\n          status: \"running\",\n          startedAt: this.dt.nowISOString(),\n        });\n      }\n\n      const registration = this.getRegistration(workflow.workflowName);\n      const stepDef = registration.options.steps.find(\n        (s) => s.name === stepName,\n      );\n      if (!stepDef) return;\n\n      const stepExec = await this.findStepExecution(workflowId, stepName);\n      if (!stepExec) return;\n\n      if (stepExec.status !== \"pending\") return;\n\n      // Check when() condition\n      if (stepDef.when) {\n        const results = await this.assembleResults(workflowId);\n        const shouldRun = await stepDef.when({\n          payload: workflow.payload as Static<TSchema>,\n          results,\n        });\n        if (!shouldRun) {\n          await this.stepExecutions.updateById(stepExec.id, {\n            status: \"skipped\",\n            completedAt: this.dt.nowISOString(),\n          });\n          await this.alepha.events.emit(\n            \"workflow:step:skipped\",\n            {\n              workflowName: workflow.workflowName,\n              workflowId,\n              stepName,\n            },\n            { catch: true },\n          );\n          await this.advance(workflowId);\n          return;\n        }\n      }\n\n      // Handler step execution\n      await this.executeHandlerStep(workflow, stepExec, stepDef as HandlerStep);\n    } finally {\n      await this.lockProvider.del(lockKey);\n    }\n  }\n\n  protected async executeHandlerStep(\n    workflow: WorkflowExecutionEntity,\n    stepExec: WorkflowStepExecutionEntity,\n    stepDef: HandlerStep,\n  ): Promise<void> {\n    const workflowId = workflow.id;\n    const stepName = stepExec.stepName;\n\n    // Claim step\n    await this.stepExecutions.updateById(stepExec.id, {\n      status: \"running\",\n      attempt: stepExec.attempt + 1,\n      startedAt: this.dt.nowISOString(),\n    });\n\n    await this.executions.updateById(workflowId, {\n      currentStep: stepName,\n    });\n\n    await this.alepha.events.emit(\n      \"workflow:step:begin\",\n      {\n        workflowName: workflow.workflowName,\n        workflowId,\n        stepName,\n      },\n      { catch: true },\n    );\n\n    // Set up abort controller\n    const abortController = new AbortController();\n    const abortKey = `${workflowId}:${stepName}`;\n    this.abortControllers.set(abortKey, abortController);\n\n    // Set up timeout\n    const timeoutMs = stepDef.timeout\n      ? this.dt.duration(stepDef.timeout).as(\"milliseconds\")\n      : this.config.defaultStepTimeout;\n    const timeoutId = setTimeout(() => abortController.abort(), timeoutMs);\n\n    // Capture logs\n    const context = this.alepha.context.createContextId();\n    this.logs.set(context, []);\n\n    try {\n      await this.alepha.context.run(\n        async () => {\n          const results = await this.assembleResults(workflowId);\n\n          const handlerResult = await stepDef.handler({\n            payload: workflow.payload as Static<TSchema>,\n            results,\n            context: {\n              workflowId,\n              executionId: stepExec.id,\n              stepName,\n              attempt: stepExec.attempt + 1,\n            },\n            signal: abortController.signal,\n          });\n\n          // Success\n          await this.stepExecutions.updateById(stepExec.id, {\n            status: \"completed\",\n            result:\n              handlerResult != null\n                ? (handlerResult as Record<string, unknown>)\n                : undefined,\n            completedAt: this.dt.nowISOString(),\n          });\n\n          await this.writeLogs(stepExec.id, context);\n\n          this.log.info(`Workflow step '${stepName}' completed`, {\n            workflowId,\n          });\n\n          await this.alepha.events.emit(\n            \"workflow:step:completed\",\n            {\n              workflowName: workflow.workflowName,\n              workflowId,\n              stepName,\n              result: handlerResult,\n            },\n            { catch: true },\n          );\n\n          // Advance to next step\n          await this.advance(workflowId);\n        },\n        { context },\n      );\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error(String(error));\n\n      await this.writeLogs(stepExec.id, context);\n\n      if (abortController.signal.aborted) {\n        // Timeout — treat as failure\n        await this.handleStepFailure(\n          workflow,\n          stepExec,\n          stepDef,\n          new Error(\"Step timed out\"),\n          context,\n        );\n      } else {\n        await this.handleStepFailure(workflow, stepExec, stepDef, err, context);\n      }\n    } finally {\n      clearTimeout(timeoutId);\n      this.abortControllers.delete(abortKey);\n      this.logs.delete(context);\n    }\n  }\n\n  protected async handleStepFailure(\n    workflow: WorkflowExecutionEntity,\n    stepExec: WorkflowStepExecutionEntity,\n    stepDef: HandlerStep,\n    error: Error,\n    _context: string,\n  ): Promise<void> {\n    const retryOpts = stepDef.retry;\n    const canRetry =\n      retryOpts &&\n      stepExec.attempt + 1 < stepExec.maxAttempts &&\n      (retryOpts.when ? retryOpts.when(error) : true);\n\n    if (canRetry) {\n      const nextScheduledAt = this.computeBackoff(\n        retryOpts,\n        stepExec.attempt + 1,\n      );\n\n      this.log.info(\n        `Workflow step '${stepExec.stepName}' failed, scheduling retry`,\n        { workflowId: workflow.id, error: error.message },\n      );\n\n      await this.stepExecutions.updateById(stepExec.id, {\n        status: \"pending\",\n        error: error.message,\n        deadlineAt: nextScheduledAt,\n      });\n\n      // Schedule retry after backoff\n      const delayMs = Math.max(\n        0,\n        new Date(nextScheduledAt).getTime() - this.dt.nowMillis(),\n      );\n      this.dt.createTimeout(\n        () =>\n          void this.dispatchStep(\n            workflow.id,\n            stepExec.stepName,\n            workflow.priority,\n          ),\n        delayMs,\n      );\n    } else {\n      // Step exhausted — mark failed\n      this.log.info(`Workflow step '${stepExec.stepName}' failed permanently`, {\n        workflowId: workflow.id,\n        error: error.message,\n      });\n\n      await this.stepExecutions.updateById(stepExec.id, {\n        status: \"failed\",\n        error: error.message,\n        completedAt: this.dt.nowISOString(),\n      });\n\n      await this.alepha.events.emit(\n        \"workflow:step:failed\",\n        {\n          workflowName: workflow.workflowName,\n          workflowId: workflow.id,\n          stepName: stepExec.stepName,\n          error,\n        },\n        { catch: true },\n      );\n\n      // Determine error strategy\n      const registration = this.getRegistration(workflow.workflowName);\n      const onError = registration.options.onError ?? \"compensate\";\n\n      if (onError === \"compensate\") {\n        await this.compensate(workflow.id, {\n          failedStep: stepExec.stepName,\n          error,\n        });\n      } else {\n        await this.executions.updateById(workflow.id, {\n          status: \"failed\",\n          error: error.message,\n          errorStep: stepExec.stepName,\n          completedAt: this.dt.nowISOString(),\n        });\n\n        await this.alepha.events.emit(\n          \"workflow:failed\",\n          {\n            workflowName: workflow.workflowName,\n            workflowId: workflow.id,\n            error,\n            stepName: stepExec.stepName,\n          },\n          { catch: true },\n        );\n      }\n    }\n  }\n\n  // --- Advance ---\n\n  protected async advance(workflowId: string): Promise<void> {\n    const workflow = await this.executions.findById(workflowId);\n    if (!workflow || workflow.status !== \"running\") return;\n\n    const registration = this.getRegistration(workflow.workflowName);\n\n    // Find next pending step by index\n    const steps = await this.stepExecutions.findMany({\n      where: { workflowExecutionId: { eq: workflowId } },\n      orderBy: { column: \"stepIndex\", direction: \"asc\" },\n    });\n\n    const nextStep = steps.find((s) => s.status === \"pending\");\n\n    if (nextStep) {\n      await this.executions.updateById(workflowId, {\n        currentStep: nextStep.stepName,\n      });\n      await this.dispatchStep(workflowId, nextStep.stepName, workflow.priority);\n    } else {\n      // All steps done\n      await this.executions.updateById(workflowId, {\n        status: \"completed\",\n        currentStep: undefined,\n        completedAt: this.dt.nowISOString(),\n        key: null,\n      });\n\n      this.log.info(`Workflow '${workflow.workflowName}' completed`, {\n        workflowId,\n      });\n\n      await this.alepha.events.emit(\n        \"workflow:completed\",\n        {\n          workflowName: workflow.workflowName,\n          workflowId,\n        },\n        { catch: true },\n      );\n    }\n  }\n\n  // --- Compensate ---\n\n  public async compensate(\n    workflowId: string,\n    context?: { failedStep?: string; error?: Error },\n  ): Promise<void> {\n    const workflow = await this.executions.findById(workflowId);\n    if (!workflow) throw new AlephaError(`Workflow not found: ${workflowId}`);\n\n    const registration = this.getRegistration(workflow.workflowName);\n\n    await this.executions.updateById(workflowId, {\n      status: \"compensating\",\n      error: context?.error?.message,\n      errorStep: context?.failedStep,\n    });\n\n    await this.alepha.events.emit(\n      \"workflow:compensating\",\n      {\n        workflowName: workflow.workflowName,\n        workflowId,\n        stepName: context?.failedStep ?? \"\",\n      },\n      { catch: true },\n    );\n\n    // Get completed steps in reverse order\n    const completedSteps = await this.stepExecutions.findMany({\n      where: {\n        workflowExecutionId: { eq: workflowId },\n        status: { eq: \"completed\" },\n      },\n      orderBy: { column: \"stepIndex\", direction: \"desc\" },\n    });\n\n    const results = await this.assembleResults(workflowId);\n\n    for (const stepExec of completedSteps) {\n      const stepDef = registration.options.steps.find(\n        (s) => s.name === stepExec.stepName,\n      );\n      if (!stepDef?.compensate) continue;\n\n      await this.stepExecutions.updateById(stepExec.id, {\n        status: \"compensating\",\n      });\n\n      try {\n        await stepDef.compensate({\n          payload: workflow.payload as Static<TSchema>,\n          result: stepExec.result,\n          results,\n          context: {\n            workflowId,\n            executionId: stepExec.id,\n            stepName: stepExec.stepName,\n            error: context?.error ?? new Error(\"Compensation triggered\"),\n          },\n        });\n\n        await this.stepExecutions.updateById(stepExec.id, {\n          status: \"compensated\",\n          completedAt: this.dt.nowISOString(),\n        });\n      } catch (compError) {\n        const err =\n          compError instanceof Error ? compError : new Error(String(compError));\n\n        this.log.error(`Compensation failed for step '${stepExec.stepName}'`, {\n          workflowId,\n          error: err.message,\n        });\n\n        await this.stepExecutions.updateById(stepExec.id, {\n          status: \"compensation_failed\",\n          error: err.message,\n        });\n\n        await this.executions.updateById(workflowId, {\n          status: \"compensation_failed\",\n          completedAt: this.dt.nowISOString(),\n          key: null,\n        });\n\n        await this.alepha.events.emit(\n          \"workflow:compensation:failed\",\n          {\n            workflowName: workflow.workflowName,\n            workflowId,\n            stepName: stepExec.stepName,\n            error: err,\n          },\n          { catch: true },\n        );\n\n        return;\n      }\n    }\n\n    // All compensations succeeded\n    await this.executions.updateById(workflowId, {\n      status: \"compensated\",\n      completedAt: this.dt.nowISOString(),\n      key: null,\n    });\n\n    this.log.info(`Workflow '${workflow.workflowName}' compensated`, {\n      workflowId,\n    });\n\n    await this.alepha.events.emit(\n      \"workflow:compensated\",\n      {\n        workflowName: workflow.workflowName,\n        workflowId,\n      },\n      { catch: true },\n    );\n  }\n\n  // --- Cancel ---\n\n  public async cancel(\n    workflowId: string,\n    options?: CancelOptions,\n  ): Promise<void> {\n    const workflow = await this.executions.findById(workflowId);\n    if (!workflow) throw new AlephaError(`Workflow not found: ${workflowId}`);\n\n    if (\n      workflow.status !== \"pending\" &&\n      workflow.status !== \"running\" &&\n      workflow.status !== \"waiting_for_signal\"\n    ) {\n      throw new AlephaError(\n        `Cannot cancel workflow in '${workflow.status}' status`,\n      );\n    }\n\n    // Abort any running step\n    for (const [key, controller] of this.abortControllers) {\n      if (key.startsWith(`${workflowId}:`)) {\n        controller.abort();\n      }\n    }\n\n    // Cancel all pending/waiting steps\n    const pendingSteps = await this.stepExecutions.findMany({\n      where: {\n        workflowExecutionId: { eq: workflowId },\n        status: { inArray: [\"pending\", \"waiting\"] },\n      },\n    });\n    for (const step of pendingSteps) {\n      await this.stepExecutions.updateById(step.id, { status: \"cancelled\" });\n    }\n\n    if (options?.compensate) {\n      await this.compensate(workflowId, {\n        error: new Error(\"Cancelled with compensation\"),\n      });\n      // After compensation, mark as cancelled (override compensated status)\n      await this.executions.updateById(workflowId, {\n        status: \"cancelled\",\n        cancelledBy: options?.cancelledBy,\n        cancelledByName: options?.cancelledByName,\n      });\n    } else {\n      await this.executions.updateById(workflowId, {\n        status: \"cancelled\",\n        cancelledBy: options?.cancelledBy,\n        cancelledByName: options?.cancelledByName,\n        completedAt: this.dt.nowISOString(),\n        key: null,\n      });\n    }\n\n    this.log.info(`Workflow cancelled`, { workflowId });\n\n    await this.alepha.events.emit(\n      \"workflow:cancelled\",\n      {\n        workflowName: workflow.workflowName,\n        workflowId,\n      },\n      { catch: true },\n    );\n  }\n\n  // --- Signal ---\n\n  /**\n   * Send a signal to a waiting workflow step.\n   */\n  public async signal(\n    workflowId: string,\n    stepName: string,\n    payload?: unknown,\n    signalledBy?: string,\n  ): Promise<void> {\n    const workflow = await this.executions.findById(workflowId);\n    if (!workflow) throw new AlephaError(`Workflow not found: ${workflowId}`);\n\n    if (workflow.status !== \"waiting_for_signal\") {\n      throw new AlephaError(\n        `Cannot signal workflow in '${workflow.status}' status`,\n      );\n    }\n\n    const stepExec = await this.findStepExecution(workflowId, stepName);\n    if (!stepExec) {\n      throw new AlephaError(\n        `Step '${stepName}' not found on workflow ${workflowId}`,\n      );\n    }\n\n    if (stepExec.status !== \"waiting\") {\n      throw new AlephaError(\n        `Step '${stepName}' is in '${stepExec.status}' status, expected 'waiting'`,\n      );\n    }\n\n    await this.stepExecutions.updateById(stepExec.id, {\n      status: \"completed\",\n      signalPayload:\n        payload != null ? (payload as Record<string, unknown>) : undefined,\n      signalledBy,\n      signalledAt: this.dt.nowISOString(),\n      completedAt: this.dt.nowISOString(),\n    });\n\n    // Resume workflow\n    await this.executions.updateById(workflowId, {\n      status: \"running\",\n    });\n\n    this.log.info(`Workflow signalled step '${stepName}'`, { workflowId });\n\n    // Advance to next step\n    await this.advance(workflowId);\n  }\n\n  // --- Retry ---\n\n  public async retry(workflowId: string): Promise<void> {\n    const workflow = await this.executions.findById(workflowId);\n    if (!workflow) throw new AlephaError(`Workflow not found: ${workflowId}`);\n\n    if (workflow.status !== \"failed\" && workflow.status !== \"timed_out\") {\n      throw new AlephaError(\n        `Cannot retry workflow in '${workflow.status}' status. Use restart() for compensated workflows.`,\n      );\n    }\n\n    // Find the failed step\n    const failedStep = await this.stepExecutions.findMany({\n      where: {\n        workflowExecutionId: { eq: workflowId },\n        status: { eq: \"failed\" },\n      },\n      limit: 1,\n    });\n\n    if (failedStep.length === 0) {\n      throw new AlephaError(\"No failed step found to retry\");\n    }\n\n    // Reset the failed step\n    await this.stepExecutions.updateById(failedStep[0].id, {\n      status: \"pending\",\n      error: undefined,\n      startedAt: undefined,\n      completedAt: undefined,\n    });\n\n    // Resume workflow\n    await this.executions.updateById(workflowId, {\n      status: \"running\",\n      error: undefined,\n      errorStep: undefined,\n      completedAt: undefined,\n    });\n\n    await this.dispatchStep(\n      workflowId,\n      failedStep[0].stepName,\n      workflow.priority,\n    );\n  }\n\n  // --- Restart ---\n\n  public async restart(workflowId: string): Promise<string> {\n    const workflow = await this.executions.findById(workflowId);\n    if (!workflow) throw new AlephaError(`Workflow not found: ${workflowId}`);\n\n    if (\n      workflow.status !== \"compensated\" &&\n      workflow.status !== \"compensation_failed\" &&\n      workflow.status !== \"failed\"\n    ) {\n      throw new AlephaError(\n        `Cannot restart workflow in '${workflow.status}' status`,\n      );\n    }\n\n    return this.start(workflow.workflowName, workflow.payload);\n  }\n\n  // --- Query ---\n\n  public async getExecution(workflowId: string) {\n    const workflow = await this.executions.findById(workflowId);\n    if (!workflow) throw new AlephaError(`Workflow not found: ${workflowId}`);\n\n    const steps = await this.stepExecutions.findMany({\n      where: { workflowExecutionId: { eq: workflowId } },\n      orderBy: { column: \"stepIndex\", direction: \"asc\" },\n    });\n\n    return { ...workflow, steps };\n  }\n\n  // --- Pause / Resume ---\n\n  public pauseWorkflow(name: string): void {\n    this.getRegistration(name);\n    this.pausedWorkflows.add(name);\n    this.log.info(`Paused workflow '${name}'`);\n  }\n\n  public async resumeWorkflow(name: string): Promise<void> {\n    this.getRegistration(name);\n    this.pausedWorkflows.delete(name);\n    this.log.info(`Resumed workflow '${name}'`);\n  }\n\n  public isWorkflowPaused(name: string): boolean {\n    return this.pausedWorkflows.has(name);\n  }\n\n  public getPausedWorkflows(): string[] {\n    return [...this.pausedWorkflows];\n  }\n\n  // --- Internal dispatch ---\n\n  protected async dispatchStep(\n    workflowId: string,\n    stepName: string,\n    priority: number,\n  ): Promise<void> {\n    if (this.stopping) return;\n\n    if (this.stepDispatch) {\n      await this.stepDispatch(workflowId, stepName, priority);\n    } else {\n      await this.processStep(workflowId, stepName);\n    }\n  }\n\n  // --- Helpers ---\n\n  protected async assembleResults(\n    workflowId: string,\n  ): Promise<Record<string, unknown>> {\n    const completed = await this.stepExecutions.findMany({\n      where: {\n        workflowExecutionId: { eq: workflowId },\n        status: { eq: \"completed\" },\n      },\n      orderBy: { column: \"stepIndex\", direction: \"asc\" },\n    });\n    const results: Record<string, unknown> = {};\n    for (const step of completed) {\n      if (step.result) results[step.stepName] = step.result;\n    }\n    return results;\n  }\n\n  protected async findStepExecution(\n    workflowId: string,\n    stepName: string,\n  ): Promise<WorkflowStepExecutionEntity | undefined> {\n    const rows = await this.stepExecutions.findMany({\n      where: {\n        workflowExecutionId: { eq: workflowId },\n        stepName: { eq: stepName },\n      },\n      limit: 1,\n    });\n    return rows[0];\n  }\n\n  protected computeBackoff(\n    retryOpts: WorkflowRetryOptions,\n    attempt: number,\n  ): string {\n    const now = this.dt.now();\n\n    if (!retryOpts.backoff) {\n      return now.add(1, \"second\").toISOString();\n    }\n\n    if (Array.isArray(retryOpts.backoff)) {\n      const delay = this.dt.duration(retryOpts.backoff);\n      return now.add(delay).toISOString();\n    }\n\n    const backoff = retryOpts.backoff as WorkflowRetryBackoff;\n    const initial = this.dt.duration(backoff.initial).as(\"milliseconds\");\n    const factor = backoff.factor ?? 2;\n    let delayMs = initial * factor ** (attempt - 1);\n\n    if (backoff.max) {\n      const maxMs = this.dt.duration(backoff.max).as(\"milliseconds\");\n      delayMs = Math.min(delayMs, maxMs);\n    }\n\n    if (backoff.jitter) {\n      delayMs = delayMs * (0.75 + Math.random() * 0.5);\n    }\n\n    return now.add(delayMs, \"millisecond\").toISOString();\n  }\n\n  protected async writeLogs(\n    stepExecutionId: string,\n    context: string,\n  ): Promise<void> {\n    const entries = this.logs.get(context);\n    if (!entries || entries.length === 0) return;\n\n    const maxEntries = this.config.logMaxEntries;\n    if (maxEntries === 0) return;\n\n    let logs = entries;\n    if (logs.length > maxEntries) {\n      logs = logs.slice(0, maxEntries);\n      logs.push({\n        level: \"WARN\",\n        message: `Log entries truncated at ${maxEntries}`,\n        timestamp: this.dt.nowMillis(),\n        service: \"alepha.workflows\",\n        module: \"WorkflowProvider\",\n      } as LogEntry);\n    }\n\n    try {\n      await this.stepLogs.create({ id: stepExecutionId, logs });\n    } catch {\n      this.log.warn(`Failed to write logs for step ${stepExecutionId}`);\n    }\n  }\n\n  protected getRegistration(name: string): WorkflowRegistration {\n    const reg = this.workflows.get(name);\n    if (!reg) throw new AlephaError(`Workflow not registered: ${name}`);\n    return reg;\n  }\n\n  // --- Sweeps ---\n\n  public async recoverySweep(): Promise<void> {\n    if (this.stopping) return;\n\n    const lockValue = `${crypto.randomUUID()},${this.dt.nowISOString()}`;\n    const result = await this.lockProvider.set(\n      \"_alepha:workflows:recovery-lock\",\n      lockValue,\n      true,\n      300_000,\n    );\n    if (result.split(\",\")[0] !== lockValue.split(\",\")[0]) return;\n\n    try {\n      const staleThreshold = this.dt\n        .now()\n        .subtract(this.config.recovery.staleThreshold, \"millisecond\")\n        .toISOString();\n\n      // Find stale running steps\n      const staleSteps = await this.stepExecutions.findMany({\n        where: {\n          status: { eq: \"running\" },\n          startedAt: { lte: staleThreshold },\n        },\n      });\n\n      for (const step of staleSteps) {\n        if (\n          this.abortControllers.has(\n            `${step.workflowExecutionId}:${step.stepName}`,\n          )\n        ) {\n          continue;\n        }\n\n        this.log.warn(\n          `Recovery sweep: marking stale step '${step.stepName}' as failed`,\n          { workflowId: step.workflowExecutionId },\n        );\n\n        await this.stepExecutions.updateById(step.id, {\n          status: \"failed\",\n          error: \"Step assumed crashed (recovered by sweep)\",\n          completedAt: this.dt.nowISOString(),\n        });\n\n        const workflow = await this.executions.findById(\n          step.workflowExecutionId,\n        );\n        if (!workflow) continue;\n\n        const registration = this.workflows.get(workflow.workflowName);\n        if (!registration) continue;\n\n        const onError = registration.options.onError ?? \"compensate\";\n        if (onError === \"compensate\") {\n          await this.compensate(workflow.id, {\n            failedStep: step.stepName,\n            error: new Error(\"Step assumed crashed\"),\n          });\n        } else {\n          await this.executions.updateById(workflow.id, {\n            status: \"failed\",\n            error: \"Step assumed crashed\",\n            errorStep: step.stepName,\n            completedAt: this.dt.nowISOString(),\n          });\n        }\n      }\n\n      // Find inconsistent workflows (running but no active steps)\n      const runningWorkflows = await this.executions.findMany({\n        where: { status: { eq: \"running\" } },\n      });\n\n      for (const wf of runningWorkflows) {\n        const activeSteps = await this.stepExecutions.findMany({\n          where: {\n            workflowExecutionId: { eq: wf.id },\n            status: { inArray: [\"running\", \"pending\"] },\n          },\n          limit: 1,\n        });\n\n        if (activeSteps.length === 0) {\n          this.log.warn(\"Recovery sweep: re-advancing inconsistent workflow\", {\n            workflowId: wf.id,\n          });\n          await this.advance(wf.id);\n        }\n      }\n    } catch (e) {\n      this.log.error(\"Recovery sweep failed\", { error: e });\n    } finally {\n      await this.lockProvider.del(\"_alepha:workflows:recovery-lock\");\n    }\n  }\n\n  public async timeoutSweep(): Promise<void> {\n    if (this.stopping) return;\n\n    const lockValue = `${crypto.randomUUID()},${this.dt.nowISOString()}`;\n    const result = await this.lockProvider.set(\n      \"_alepha:workflows:timeout-lock\",\n      lockValue,\n      true,\n      60_000,\n    );\n    if (result.split(\",\")[0] !== lockValue.split(\",\")[0]) return;\n\n    try {\n      const now = this.dt.nowISOString();\n\n      // Workflow-level timeouts\n      const timedOutWorkflows = await this.executions.findMany({\n        where: {\n          status: { inArray: [\"running\", \"waiting_for_signal\"] },\n          deadlineAt: { lte: now },\n        },\n      });\n\n      for (const wf of timedOutWorkflows) {\n        this.log.warn(`Timeout sweep: workflow timed out`, {\n          workflowId: wf.id,\n        });\n\n        // Abort any running step\n        for (const [key, controller] of this.abortControllers) {\n          if (key.startsWith(`${wf.id}:`)) controller.abort();\n        }\n\n        // Mark running steps as failed\n        await this.stepExecutions.updateMany(\n          {\n            workflowExecutionId: { eq: wf.id },\n            status: { inArray: [\"running\", \"waiting\"] },\n          },\n          {\n            status: \"failed\",\n            error: \"Workflow timed out\",\n            completedAt: now,\n          },\n        );\n\n        await this.executions.updateById(wf.id, {\n          status: \"timed_out\",\n          completedAt: now,\n        });\n\n        await this.alepha.events.emit(\n          \"workflow:timed_out\",\n          {\n            workflowName: wf.workflowName,\n            workflowId: wf.id,\n          },\n          { catch: true },\n        );\n\n        const reg = this.workflows.get(wf.workflowName);\n        if (reg?.options.onError === \"compensate\") {\n          await this.compensate(wf.id, {\n            error: new Error(\"Workflow timed out\"),\n          });\n        }\n      }\n    } catch (e) {\n      this.log.error(\"Timeout sweep failed\", { error: e });\n    } finally {\n      await this.lockProvider.del(\"_alepha:workflows:timeout-lock\");\n    }\n  }\n\n  public async purge(): Promise<void> {\n    if (this.stopping) return;\n    try {\n      const cutoff = this.dt\n        .now()\n        .subtract(this.config.retentionDays, \"day\")\n        .toISOString();\n\n      const terminalStatuses: WorkflowStatus[] = [\n        \"completed\",\n        \"failed\",\n        \"compensated\",\n        \"compensation_failed\",\n        \"cancelled\",\n        \"timed_out\",\n      ];\n\n      const old = await this.executions.findMany({\n        where: {\n          status: { inArray: terminalStatuses },\n          completedAt: { lte: cutoff },\n        },\n      });\n\n      if (old.length > 0) {\n        const ids = old.map((e) => e.id);\n        // Step logs and step executions cascade-delete with the workflow\n        await this.executions.deleteMany({ id: { inArray: ids } });\n        this.log.info(`Purge: deleted ${ids.length} old workflow executions`);\n      }\n    } catch (e) {\n      this.log.error(\"Purge failed\", { error: e });\n    }\n  }\n\n  // --- Lifecycle ---\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      this.log.info(\"Workflow engine OK\", {\n        dispatch: this.stepDispatch ? \"queue\" : \"inline\",\n        workflows: this.workflows.size,\n      });\n\n      // Log capture listener\n      this.alepha.events.on(\"log\", ({ entry }) => {\n        const ctx = entry.context;\n        if (!ctx) return;\n        const entries = this.logs.get(ctx);\n        if (!entries) return;\n        entries.push(entry);\n      });\n    },\n  });\n\n  protected readonly onStop = $hook({\n    on: \"stop\",\n    handler: async () => {\n      this.stopping = true;\n\n      if (this.inFlight.size > 0) {\n        this.log.info(`Draining ${this.inFlight.size} in-flight step(s)...`);\n        await Promise.race([\n          Promise.allSettled([...this.inFlight]),\n          this.dt.wait([this.config.drainTimeout, \"millisecond\"]),\n        ]);\n      }\n\n      if (this.abortControllers.size > 0) {\n        this.log.warn(\n          `Aborting ${this.abortControllers.size} remaining step(s)`,\n        );\n        for (const controller of this.abortControllers.values()) {\n          controller.abort();\n        }\n      }\n    },\n  });\n}\n","import { $inject, Alepha, t } from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { $repository, DatabaseProvider, sql } from \"alepha/orm\";\nimport { NotFoundError } from \"alepha/server\";\nimport type { WorkflowExecutionEntity } from \"../entities/workflowExecutions.ts\";\nimport { workflowExecutions } from \"../entities/workflowExecutions.ts\";\nimport { workflowStepExecutions } from \"../entities/workflowStepExecutions.ts\";\nimport { WorkflowProvider } from \"../providers/WorkflowProvider.ts\";\nimport type { WorkflowActivityPoint } from \"../schemas/workflowActivitySchema.ts\";\nimport type { WorkflowExecutionQuery } from \"../schemas/workflowExecutionQuerySchema.ts\";\nimport type { WorkflowExecutionCan } from \"../schemas/workflowExecutionResourceSchema.ts\";\nimport type { WorkflowRegistration } from \"../schemas/workflowRegistrationSchema.ts\";\nimport type { WorkflowStats } from \"../schemas/workflowStatsSchema.ts\";\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport class WorkflowService {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly dt = $inject(DateTimeProvider);\n  protected readonly log = $logger();\n  protected readonly workflowProvider = $inject(WorkflowProvider);\n  protected readonly database = $inject(DatabaseProvider);\n  protected readonly executions = $repository(workflowExecutions);\n  protected readonly stepExecutions = $repository(workflowStepExecutions);\n\n  /**\n   * Compute available actions for a workflow execution based on its status.\n   */\n  protected computeCan(\n    status: string,\n    signalStepName?: string,\n  ): WorkflowExecutionCan {\n    return {\n      retry: status === \"failed\" || status === \"timed_out\",\n      cancel:\n        status === \"pending\" ||\n        status === \"running\" ||\n        status === \"waiting_for_signal\",\n      compensate: status === \"failed\" || status === \"timed_out\",\n      restart:\n        status === \"failed\" ||\n        status === \"compensated\" ||\n        status === \"compensation_failed\",\n      signal: signalStepName ? { stepName: signalStepName } : undefined,\n    };\n  }\n\n  /**\n   * Convert an ISO date string to the raw SQL parameter format\n   * expected by the current database dialect.\n   *\n   * - PostgreSQL: ISO string (timestamp comparison)\n   * - SQLite: epoch milliseconds (integer comparison)\n   */\n  protected toRawDate(iso: string): string | number {\n    return this.database.dialect === \"sqlite\" ? new Date(iso).getTime() : iso;\n  }\n\n  /**\n   * Get aggregate stats for the workflow engine.\n   */\n  public async getStats(days?: number): Promise<WorkflowStats> {\n    const workflows = this.workflowProvider.getRegisteredWorkflows();\n    const periodAgo = this.toRawDate(\n      this.dt\n        .now()\n        .subtract(days ?? 1, \"day\")\n        .toISOString(),\n    );\n\n    const rows = await this.executions.query(\n      (e) => sql`\n        SELECT\n          COUNT(*) FILTER (WHERE ${e.status} = 'running') AS running,\n          COUNT(*) FILTER (WHERE ${e.status} = 'pending') AS pending,\n          COUNT(*) FILTER (WHERE ${e.status} = 'waiting_for_signal') AS waiting,\n          COUNT(*) FILTER (WHERE ${e.status} = 'completed' AND ${e.completedAt} >= ${periodAgo}) AS completed,\n          COUNT(*) FILTER (WHERE ${e.status} = 'failed' AND ${e.completedAt} >= ${periodAgo}) AS failed,\n          COUNT(*) FILTER (WHERE ${e.status} = 'compensated' AND ${e.completedAt} >= ${periodAgo}) AS compensated,\n          COUNT(*) FILTER (WHERE ${e.status} = 'compensation_failed' AND ${e.completedAt} >= ${periodAgo}) AS compensation_failed,\n          COUNT(*) FILTER (WHERE ${e.status} = 'cancelled' AND ${e.completedAt} >= ${periodAgo}) AS cancelled,\n          COUNT(*) FILTER (WHERE ${e.status} = 'timed_out' AND ${e.completedAt} >= ${periodAgo}) AS timed_out\n        FROM ${e}\n      `,\n      t.object({\n        running: t.string(),\n        pending: t.string(),\n        waiting: t.string(),\n        completed: t.string(),\n        failed: t.string(),\n        compensated: t.string(),\n        compensation_failed: t.string(),\n        cancelled: t.string(),\n        timed_out: t.string(),\n      }),\n    );\n\n    const row = rows[0];\n    return {\n      registered: workflows.size,\n      running: Number(row.running),\n      pending: Number(row.pending),\n      waiting: Number(row.waiting),\n      completed: Number(row.completed),\n      failed: Number(row.failed),\n      compensated: Number(row.compensated),\n      compensationFailed: Number(row.compensation_failed),\n      cancelled: Number(row.cancelled),\n      timedOut: Number(row.timed_out),\n    };\n  }\n\n  /**\n   * Get the full workflow registry with live counts.\n   */\n  public async getRegistry(): Promise<WorkflowRegistration[]> {\n    const workflows = this.workflowProvider.getRegisteredWorkflows();\n    const names = [...workflows.keys()];\n\n    // Get live counts per workflow name\n    const countRows =\n      names.length > 0\n        ? await this.executions.query(\n            (e) => sql`\n              SELECT\n                ${e.workflowName} AS workflow_name,\n                COUNT(*) FILTER (WHERE ${e.status} = 'running') AS running,\n                COUNT(*) FILTER (WHERE ${e.status} = 'pending') AS pending,\n                COUNT(*) FILTER (WHERE ${e.status} = 'waiting_for_signal') AS waiting,\n                COUNT(*) FILTER (WHERE ${e.status} = 'failed') AS failed\n              FROM ${e}\n              WHERE ${e.workflowName} IN (${sql.join(\n                names.map((n) => sql`${n}`),\n                sql`, `,\n              )})\n              GROUP BY ${e.workflowName}\n            `,\n            t.object({\n              workflow_name: t.string(),\n              running: t.string(),\n              pending: t.string(),\n              waiting: t.string(),\n              failed: t.string(),\n            }),\n          )\n        : [];\n\n    const countsByName = new Map(countRows.map((r) => [r.workflow_name, r]));\n\n    const result: WorkflowRegistration[] = [];\n\n    for (const [name, reg] of workflows) {\n      const opts = reg.options;\n      const counts = countsByName.get(name);\n\n      result.push({\n        name,\n        stepCount: opts.steps.length,\n        steps: opts.steps.map((step) => ({\n          name: step.name,\n          type: step.type ?? \"handler\",\n          hasCompensate: Boolean(step.compensate),\n          hasRetry: Boolean(step.retry),\n          timeout: step.timeout ? String(step.timeout) : undefined,\n        })),\n        onError: opts.onError ?? \"compensate\",\n        timeout: opts.timeout ? String(opts.timeout) : undefined,\n        priority: opts.priority ?? \"normal\",\n        tags: opts.tags,\n        paused: this.workflowProvider.isWorkflowPaused(name),\n        running: Number(counts?.running ?? 0),\n        pending: Number(counts?.pending ?? 0),\n        waiting: Number(counts?.waiting ?? 0),\n        failed: Number(counts?.failed ?? 0),\n      });\n    }\n\n    return result;\n  }\n\n  /**\n   * Paginated query for workflow executions.\n   */\n  public async findExecutions(query: WorkflowExecutionQuery = {}) {\n    query.sort ??= \"-createdAt\";\n\n    const where = this.executions.createQueryWhere();\n\n    if (query.workflow) {\n      where.workflowName = { eq: query.workflow };\n    }\n\n    if (query.status) {\n      where.status = { eq: query.status };\n    }\n\n    if (query.from) {\n      where.createdAt = { gte: query.from };\n    }\n\n    if (query.to) {\n      where.createdAt = {\n        ...(where.createdAt as object),\n        lte: query.to,\n      };\n    }\n\n    const page = await this.executions.paginate(\n      query,\n      { where },\n      { count: true },\n    );\n    return {\n      ...page,\n      content: page.content.map((exec: WorkflowExecutionEntity) => ({\n        ...exec,\n        can: this.computeCan(exec.status),\n      })),\n    };\n  }\n\n  /**\n   * Get a single workflow execution with step details.\n   */\n  public async getExecution(id: string) {\n    const execution = await this.executions.findById(id);\n    if (!execution) {\n      throw new NotFoundError(`Workflow execution not found: ${id}`);\n    }\n\n    const steps = await this.stepExecutions.findMany({\n      where: { workflowExecutionId: { eq: id } },\n      orderBy: { column: \"stepIndex\", direction: \"asc\" },\n    });\n\n    // Determine signal step name if workflow is waiting\n    let signalStepName: string | undefined;\n    if (execution.status === \"waiting_for_signal\") {\n      const waitingStep = steps.find((s) => s.status === \"waiting\");\n      if (waitingStep) {\n        signalStepName = waitingStep.stepName;\n      }\n    }\n\n    return {\n      ...execution,\n      can: this.computeCan(execution.status, signalStepName),\n      steps,\n    };\n  }\n\n  /**\n   * Get daily activity (completed/failed) over a date range.\n   */\n  public async getActivity(days = 14): Promise<WorkflowActivityPoint[]> {\n    const rows = await this.executions.query(\n      (e) => sql`\n        WITH date_series AS (\n          SELECT generate_series(\n            CURRENT_DATE - ${days - 1}::int,\n            CURRENT_DATE,\n            '1 day'::interval\n          )::date AS date\n        )\n        SELECT\n          ds.date::text AS date,\n          COALESCE(COUNT(*) FILTER (WHERE ${e.status} = 'completed'), 0) AS completed,\n          COALESCE(COUNT(*) FILTER (WHERE ${e.status} = 'failed'), 0) AS failed\n        FROM date_series ds\n        LEFT JOIN ${e} ON DATE(${e.completedAt}) = ds.date\n          AND ${e.status} IN ('completed', 'failed')\n        GROUP BY ds.date\n        ORDER BY ds.date ASC\n      `,\n      t.object({\n        date: t.string(),\n        completed: t.string(),\n        failed: t.string(),\n      }),\n    );\n\n    return rows.map((row) => ({\n      date: row.date,\n      completed: Number(row.completed),\n      failed: Number(row.failed),\n    }));\n  }\n\n  /**\n   * Start a new workflow execution by name.\n   */\n  public async triggerWorkflow(\n    name: string,\n    payload?: Record<string, unknown>,\n    options?: {\n      key?: string;\n      tags?: string[];\n      triggeredBy?: string;\n      triggeredByName?: string;\n    },\n  ): Promise<{ id: string }> {\n    this.log.info(`Triggering workflow '${name}'`, {\n      triggeredBy: options?.triggeredByName ?? options?.triggeredBy,\n    });\n\n    const id = await this.workflowProvider.start(name, payload ?? {}, {\n      key: options?.key,\n      tags: options?.tags,\n      triggeredBy: options?.triggeredBy,\n      triggeredByName: options?.triggeredByName,\n    });\n\n    return { id };\n  }\n\n  /**\n   * Cancel a running workflow execution.\n   */\n  public async cancelExecution(\n    id: string,\n    context?: {\n      compensate?: boolean;\n      cancelledBy?: string;\n      cancelledByName?: string;\n    },\n  ): Promise<{ ok: boolean }> {\n    this.log.info(`Cancelling workflow execution ${id}`, {\n      cancelledBy: context?.cancelledByName ?? context?.cancelledBy,\n    });\n\n    await this.workflowProvider.cancel(id, {\n      compensate: context?.compensate,\n      cancelledBy: context?.cancelledBy,\n      cancelledByName: context?.cancelledByName,\n    });\n    return { ok: true };\n  }\n\n  /**\n   * Retry a failed/timed-out workflow from the failed step.\n   */\n  public async retryExecution(id: string): Promise<{ ok: boolean }> {\n    this.log.info(`Retrying workflow execution ${id}`);\n    await this.workflowProvider.retry(id);\n    return { ok: true };\n  }\n\n  /**\n   * Restart a terminal workflow as a new execution.\n   */\n  public async restartExecution(id: string): Promise<{ id: string }> {\n    this.log.info(`Restarting workflow execution ${id}`);\n    const newId = await this.workflowProvider.restart(id);\n    return { id: newId };\n  }\n\n  /**\n   * Trigger compensation on a failed/timed-out workflow.\n   */\n  public async compensateExecution(id: string): Promise<{ ok: boolean }> {\n    this.log.info(`Compensating workflow execution ${id}`);\n    await this.workflowProvider.compensate(id);\n    return { ok: true };\n  }\n\n  /**\n   * Send a signal to a waiting workflow step.\n   */\n  public async signalExecution(\n    id: string,\n    stepName: string,\n    payload?: Record<string, unknown>,\n    signalledBy?: string,\n  ): Promise<{ ok: boolean }> {\n    this.log.info(`Signalling workflow execution ${id} step '${stepName}'`, {\n      signalledBy,\n    });\n    await this.workflowProvider.signal(id, stepName, payload);\n    return { ok: true };\n  }\n}\n","import { $inject, t } from \"alepha\";\nimport { $secure } from \"alepha/security\";\nimport { $action, okSchema } from \"alepha/server\";\nimport {\n  workflowActivityPointSchema,\n  workflowActivityQuerySchema,\n} from \"../schemas/workflowActivitySchema.ts\";\nimport { workflowExecutionDetailSchema } from \"../schemas/workflowExecutionDetailSchema.ts\";\nimport { workflowExecutionQuerySchema } from \"../schemas/workflowExecutionQuerySchema.ts\";\nimport { workflowExecutionResourceSchema } from \"../schemas/workflowExecutionResourceSchema.ts\";\nimport { workflowRegistrationSchema } from \"../schemas/workflowRegistrationSchema.ts\";\nimport { workflowStatsSchema } from \"../schemas/workflowStatsSchema.ts\";\nimport { WorkflowService } from \"../services/WorkflowService.ts\";\n\nexport class AdminWorkflowController {\n  protected readonly url: string = \"/workflows\";\n  protected readonly group: string = \"admin:workflows\";\n  protected readonly workflowService = $inject(WorkflowService);\n\n  public readonly getRegistry = $action({\n    path: this.url,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:read\"] })],\n    schema: {\n      response: t.array(workflowRegistrationSchema),\n    },\n    handler: () => this.workflowService.getRegistry(),\n  });\n\n  public readonly getStats = $action({\n    path: `${this.url}/stats`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:read\"] })],\n    schema: {\n      query: workflowActivityQuerySchema,\n      response: workflowStatsSchema,\n    },\n    handler: ({ query }) => this.workflowService.getStats(query.days),\n  });\n\n  public readonly getActivity = $action({\n    path: `${this.url}/activity`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:read\"] })],\n    schema: {\n      query: workflowActivityQuerySchema,\n      response: t.array(workflowActivityPointSchema),\n    },\n    handler: ({ query }) => this.workflowService.getActivity(query.days),\n  });\n\n  public readonly findExecutions = $action({\n    path: `${this.url}/executions`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:read\"] })],\n    schema: {\n      query: workflowExecutionQuerySchema,\n      response: t.page(workflowExecutionResourceSchema),\n    },\n    handler: ({ query }) => this.workflowService.findExecutions(query),\n  });\n\n  public readonly getExecution = $action({\n    path: `${this.url}/executions/:id`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:read\"] })],\n    schema: {\n      params: t.object({\n        id: t.uuid(),\n      }),\n      response: workflowExecutionDetailSchema,\n    },\n    handler: ({ params }) => this.workflowService.getExecution(params.id),\n  });\n\n  public readonly startWorkflow = $action({\n    method: \"POST\",\n    path: `${this.url}/start`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:create\"] })],\n    schema: {\n      body: t.object({\n        name: t.text(),\n        payload: t.optional(t.record(t.text(), t.any())),\n        key: t.optional(t.text()),\n        tags: t.optional(t.array(t.text())),\n      }),\n      response: t.object({ id: t.uuid() }),\n    },\n    handler: async ({ body, user }) => {\n      return this.workflowService.triggerWorkflow(body.name, body.payload, {\n        key: body.key,\n        tags: body.tags,\n        triggeredBy: user?.id,\n        triggeredByName: user?.name,\n      });\n    },\n  });\n\n  public readonly signalStep = $action({\n    method: \"POST\",\n    path: `${this.url}/executions/:id/signal`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:update\"] })],\n    schema: {\n      params: t.object({\n        id: t.uuid(),\n      }),\n      body: t.object({\n        stepName: t.text(),\n        payload: t.optional(t.record(t.text(), t.any())),\n      }),\n      response: okSchema,\n    },\n    handler: async ({ params, body, user }) => {\n      return this.workflowService.signalExecution(\n        params.id,\n        body.stepName,\n        body.payload,\n        user?.id,\n      );\n    },\n  });\n\n  public readonly cancelExecution = $action({\n    method: \"POST\",\n    path: `${this.url}/executions/:id/cancel`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:update\"] })],\n    schema: {\n      params: t.object({\n        id: t.uuid(),\n      }),\n      response: okSchema,\n    },\n    handler: async ({ params, user }) => {\n      return this.workflowService.cancelExecution(params.id, {\n        cancelledBy: user?.id,\n        cancelledByName: user?.name,\n      });\n    },\n  });\n\n  public readonly retryExecution = $action({\n    method: \"POST\",\n    path: `${this.url}/executions/:id/retry`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:update\"] })],\n    schema: {\n      params: t.object({\n        id: t.uuid(),\n      }),\n      response: okSchema,\n    },\n    handler: async ({ params }) => {\n      return this.workflowService.retryExecution(params.id);\n    },\n  });\n\n  public readonly restartExecution = $action({\n    method: \"POST\",\n    path: `${this.url}/executions/:id/restart`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:create\"] })],\n    schema: {\n      params: t.object({\n        id: t.uuid(),\n      }),\n      response: t.object({ id: t.uuid() }),\n    },\n    handler: async ({ params }) => {\n      return this.workflowService.restartExecution(params.id);\n    },\n  });\n\n  public readonly compensateExecution = $action({\n    method: \"POST\",\n    path: `${this.url}/executions/:id/compensate`,\n    group: this.group,\n    use: [$secure({ permissions: [\"admin:workflow:update\"] })],\n    schema: {\n      params: t.object({\n        id: t.uuid(),\n      }),\n      response: okSchema,\n    },\n    handler: async ({ params }) => {\n      return this.workflowService.compensateExecution(params.id);\n    },\n  });\n}\n","import { $hook, $inject, t } from \"alepha\";\nimport { $job } from \"alepha/api/jobs\";\nimport { WorkflowProvider } from \"../providers/WorkflowProvider.ts\";\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport class WorkflowJobs {\n  protected readonly workflowProvider = $inject(WorkflowProvider);\n\n  protected readonly dispatchStep = $job({\n    schema: t.object({\n      workflowId: t.uuid(),\n      stepName: t.text(),\n    }),\n    retry: { retries: 2, backoff: [1, \"second\"] },\n    timeout: [10, \"minute\"],\n    concurrency: 10,\n    handler: async ({ items }) => {\n      for (const item of items) {\n        await this.workflowProvider.processStep(\n          item.payload.workflowId,\n          item.payload.stepName,\n        );\n      }\n    },\n  });\n\n  protected readonly timeoutSweep = $job({\n    cron: \"* * * * *\",\n    lock: true,\n    handler: async () => {\n      await this.workflowProvider.timeoutSweep();\n    },\n  });\n\n  protected readonly purge = $job({\n    cron: \"0 3 * * *\",\n    lock: true,\n    handler: async () => {\n      await this.workflowProvider.purge();\n    },\n  });\n\n  protected readonly recoverySweep = $job({\n    cron: \"*/5 * * * *\",\n    lock: true,\n    handler: async () => {\n      await this.workflowProvider.recoverySweep();\n    },\n  });\n\n  protected readonly onStart = $hook({\n    on: \"start\",\n    handler: async () => {\n      // Wire up queue dispatch\n      this.workflowProvider.stepDispatch = async (\n        workflowId,\n        stepName,\n        priority,\n      ) => {\n        const priorityMap: Record<\n          number,\n          \"critical\" | \"high\" | \"normal\" | \"low\"\n        > = {\n          0: \"critical\",\n          1: \"high\",\n          2: \"normal\",\n          3: \"low\",\n        };\n        await this.dispatchStep.push(\n          { workflowId, stepName },\n          { priority: priorityMap[priority] ?? \"normal\" },\n        );\n      };\n    },\n  });\n}\n","import {\n  $inject,\n  createPrimitive,\n  KIND,\n  Primitive,\n  type Static,\n  type TSchema,\n} from \"alepha\";\nimport type { DurationLike } from \"alepha/datetime\";\nimport { WorkflowProvider } from \"../providers/WorkflowProvider.ts\";\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport type WorkflowPriority = \"critical\" | \"high\" | \"normal\" | \"low\";\n\nexport interface WorkflowRetryOptions {\n  retries: number;\n  backoff?: DurationLike | WorkflowRetryBackoff;\n  when?: (error: Error) => boolean;\n}\n\nexport interface WorkflowRetryBackoff {\n  initial: DurationLike;\n  factor?: number;\n  max?: DurationLike;\n  jitter?: boolean;\n}\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport interface StepHandlerArgs<TInput extends TSchema = TSchema> {\n  payload: Static<TInput>;\n  results: Record<string, unknown>;\n  context: {\n    workflowId: string;\n    executionId: string;\n    stepName: string;\n    attempt: number;\n  };\n  signal: AbortSignal;\n}\n\nexport interface StepCompensateArgs<TInput extends TSchema = TSchema> {\n  payload: Static<TInput>;\n  result: unknown;\n  results: Record<string, unknown>;\n  context: {\n    workflowId: string;\n    executionId: string;\n    stepName: string;\n    error: Error;\n  };\n}\n\nexport interface StepConditionArgs<TInput extends TSchema = TSchema> {\n  payload: Static<TInput>;\n  results: Record<string, unknown>;\n}\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport interface HandlerStep<TInput extends TSchema = TSchema> {\n  name: string;\n  type?: \"handler\";\n  handler: (args: StepHandlerArgs<TInput>) => Promise<unknown>;\n  compensate?: (args: StepCompensateArgs<TInput>) => Promise<void>;\n  retry?: WorkflowRetryOptions;\n  timeout?: DurationLike;\n  when?: (args: StepConditionArgs<TInput>) => boolean | Promise<boolean>;\n}\n\nexport type WorkflowStep<TInput extends TSchema = TSchema> =\n  HandlerStep<TInput>;\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport interface WorkflowPrimitiveOptions<TInput extends TSchema = TSchema> {\n  /**\n   * TypeBox schema for the workflow input payload.\n   */\n  schema: TInput;\n\n  /**\n   * Ordered list of steps. Executed sequentially.\n   */\n  steps: Array<WorkflowStep<TInput>>;\n\n  /**\n   * Error strategy.\n   * - \"compensate\": Run compensate functions in reverse order (saga pattern).\n   * - \"fail\": Mark workflow as failed, no compensation.\n   * @default \"compensate\"\n   */\n  onError?: \"compensate\" | \"fail\";\n\n  /**\n   * Maximum total duration for the entire workflow.\n   */\n  timeout?: DurationLike;\n\n  /**\n   * Priority for the workflow's job dispatches.\n   * @default \"normal\"\n   */\n  priority?: WorkflowPriority;\n\n  /**\n   * Tags for filtering/grouping in admin UI.\n   */\n  tags?: string[];\n}\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport interface WorkflowStartOptions {\n  key?: string;\n  priority?: WorkflowPriority;\n  delay?: DurationLike;\n  triggeredBy?: string;\n  triggeredByName?: string;\n  tags?: string[];\n}\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport class WorkflowPrimitive<\n  TInput extends TSchema = TSchema,\n> extends Primitive<WorkflowPrimitiveOptions<TInput>> {\n  protected readonly workflowProvider = $inject(WorkflowProvider);\n\n  public get name(): string {\n    return `${this.config.service.name}.${this.config.propertyKey}`;\n  }\n\n  protected onInit() {\n    this.workflowProvider.register(this);\n  }\n\n  /**\n   * Start a new workflow execution.\n   */\n  public async start(\n    payload: Static<TInput>,\n    options?: WorkflowStartOptions,\n  ): Promise<string> {\n    return this.workflowProvider.start(this.name, payload, options);\n  }\n\n  /**\n   * Send a signal to a waiting step on a specific execution.\n   */\n  public async signal(\n    executionId: string,\n    stepName: string,\n    payload?: unknown,\n  ): Promise<void> {\n    return this.workflowProvider.signal(executionId, stepName, payload);\n  }\n\n  /**\n   * Cancel a running execution.\n   */\n  public async cancel(\n    executionId: string,\n    options?: { compensate?: boolean },\n  ): Promise<void> {\n    return this.workflowProvider.cancel(executionId, {\n      compensate: options?.compensate,\n    });\n  }\n\n  /**\n   * Retry a failed/timed-out execution from the failed step.\n   */\n  public async retry(executionId: string): Promise<void> {\n    return this.workflowProvider.retry(executionId);\n  }\n\n  /**\n   * Restart a terminal execution from the beginning (new execution).\n   */\n  public async restart(executionId: string): Promise<string> {\n    return this.workflowProvider.restart(executionId);\n  }\n\n  /**\n   * Get the status of an execution.\n   */\n  public async status(executionId: string) {\n    return this.workflowProvider.getExecution(executionId);\n  }\n}\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport const $workflow = <TInput extends TSchema>(\n  options: WorkflowPrimitiveOptions<TInput>,\n) => {\n  return createPrimitive(WorkflowPrimitive<TInput>, options);\n};\n\n$workflow[KIND] = WorkflowPrimitive;\n","import { $module, type Alepha } from \"alepha\";\nimport { AlephaApiJobs } from \"alepha/api/jobs\";\nimport { AlephaLock } from \"alepha/lock\";\nimport { AdminWorkflowController } from \"./controllers/AdminWorkflowController.ts\";\nimport { WorkflowJobs } from \"./jobs/WorkflowJobs.ts\";\nimport { $workflow } from \"./primitives/$workflow.ts\";\nimport { WorkflowProvider } from \"./providers/WorkflowProvider.ts\";\nimport { WorkflowService } from \"./services/WorkflowService.ts\";\n\n// -----------------------------------------------------------------------------------------------------------------\n\nexport * from \"./controllers/AdminWorkflowController.ts\";\nexport * from \"./entities/workflowExecutions.ts\";\nexport * from \"./entities/workflowStepExecutions.ts\";\nexport * from \"./entities/workflowStepLogs.ts\";\nexport * from \"./primitives/$workflow.ts\";\nexport * from \"./providers/WorkflowProvider.ts\";\nexport * from \"./schemas/workflowActivitySchema.ts\";\nexport * from \"./schemas/workflowConfigAtom.ts\";\nexport * from \"./schemas/workflowExecutionDetailSchema.ts\";\nexport * from \"./schemas/workflowExecutionQuerySchema.ts\";\nexport * from \"./schemas/workflowExecutionResourceSchema.ts\";\nexport * from \"./schemas/workflowRegistrationSchema.ts\";\nexport * from \"./schemas/workflowStatsSchema.ts\";\nexport * from \"./schemas/workflowStepExecutionResourceSchema.ts\";\nexport * from \"./services/WorkflowService.ts\";\n\n// -----------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"workflow:started\": { workflowName: string; workflowId: string };\n    \"workflow:step:begin\": {\n      workflowName: string;\n      workflowId: string;\n      stepName: string;\n    };\n    \"workflow:step:completed\": {\n      workflowName: string;\n      workflowId: string;\n      stepName: string;\n      result: unknown;\n    };\n    \"workflow:step:failed\": {\n      workflowName: string;\n      workflowId: string;\n      stepName: string;\n      error: Error;\n    };\n    \"workflow:step:skipped\": {\n      workflowName: string;\n      workflowId: string;\n      stepName: string;\n    };\n    \"workflow:signal:received\": {\n      workflowName: string;\n      workflowId: string;\n      stepName: string;\n      payload: unknown;\n    };\n    \"workflow:signal:timeout\": {\n      workflowName: string;\n      workflowId: string;\n      stepName: string;\n    };\n    \"workflow:completed\": { workflowName: string; workflowId: string };\n    \"workflow:failed\": {\n      workflowName: string;\n      workflowId: string;\n      error: Error;\n      stepName: string;\n    };\n    \"workflow:compensating\": {\n      workflowName: string;\n      workflowId: string;\n      stepName: string;\n    };\n    \"workflow:compensated\": { workflowName: string; workflowId: string };\n    \"workflow:compensation:failed\": {\n      workflowName: string;\n      workflowId: string;\n      stepName: string;\n      error: Error;\n    };\n    \"workflow:cancelled\": { workflowName: string; workflowId: string };\n    \"workflow:timed_out\": { workflowName: string; workflowId: string };\n  }\n}\n\n// -----------------------------------------------------------------------------------------------------------------\n\n/**\n * Durable workflow engine for long-running business processes.\n *\n * **Features:**\n * - Declarative, multi-step workflows with typed payloads\n * - Saga-pattern compensation for failure recovery\n * - Per-step retry with exponential backoff\n * - Workflow-level timeout and cancellation\n * - Deduplication via unique keys\n * - Per-execution log capture\n *\n * @module alepha.api.workflows\n */\nexport const AlephaApiWorkflows = $module({\n  name: \"alepha.api.workflows\",\n  primitives: [$workflow],\n  services: [\n    AlephaApiJobs,\n    AlephaLock,\n    WorkflowProvider,\n    WorkflowService,\n    WorkflowJobs,\n    AdminWorkflowController,\n  ],\n  register: (alepha: Alepha) => {\n    alepha.with(AlephaApiJobs);\n    alepha.with(AlephaLock);\n    alepha.with(WorkflowProvider);\n    alepha.with(WorkflowService);\n    alepha.with(WorkflowJobs);\n    alepha.with(AdminWorkflowController);\n  },\n});\n"],"mappings":"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"}

package/dist/cli/core/index.d.ts

@@ -371,34 +371,34 @@ interface FetchFunctionOptions {
 type FetchResult = CachedFetchResult | ExternalFetchResult | ViteFetchResult;
 interface CachedFetchResult {
   /**
-  * If module cached in the runner, we can just confirm
-  * it wasn't invalidated on the server side.
+  * If the module is cached in the runner, this confirms
+  * it was not invalidated on the server side.
   */
   cache: true;
 }
 interface ExternalFetchResult {
   /**
-  * The path to the externalized module starting with file://,
-  * by default this will be imported via a dynamic "import"
-  * instead of being transformed by vite and loaded with vite runner
+  * The path to the externalized module starting with file://.
+  * By default this will be imported via a dynamic "import"
+  * instead of being transformed by Vite and loaded with the Vite runner.
   */
   externalize: string;
   /**
-  * Type of the module. Will be used to determine if import statement is correct.
-  * For example, if Vite needs to throw an error if variable is not actually exported
+  * Type of the module. Used to determine if the import statement is correct.
+  * For example, if Vite needs to throw an error if a variable is not actually exported.
   */
   type: "module" | "commonjs" | "builtin" | "network";
 }
 interface ViteFetchResult {
   /**
-  * Code that will be evaluated by vite runner
-  * by default this will be wrapped in an async function
+  * Code that will be evaluated by the Vite runner.
+  * By default this will be wrapped in an async function.
   */
   code: string;
   /**
   * File path of the module on disk.
-  * This will be resolved as import.meta.url/filename
-  * Will be equal to `null` for virtual modules
+  * This will be resolved as import.meta.url/filename.
+  * Will be `null` for virtual modules.
   */
   file: string | null;
   /**
@@ -516,7 +516,7 @@ type InferCustomEventPayload<T extends string> = T extends keyof CustomEventMap
  */
 type CustomEventName = keyof CustomEventMap | (string & {});
 //#endregion
-//#region ../../../../node_modules/rolldown/dist/shared/logging-C6h4g8dA.d.mts
+//#region ../../../../node_modules/vite/node_modules/rolldown/dist/shared/logging-C6h4g8dA.d.mts
 //#region src/log/logging.d.ts
 /** @inline */
 type LogLevel$1 = "info" | "debug" | "warn";
@@ -1866,7 +1866,7 @@ type UnaryOperator = "+" | "-" | "!" | "~" | "typeof" | "void" | "delete";
 type UpdateOperator = "++" | "--";
 type Node$1 = Program | IdentifierName | IdentifierReference | BindingIdentifier | LabelIdentifier | ThisExpression | ArrayExpression | ObjectExpression | ObjectProperty | TemplateLiteral | TaggedTemplateExpression | TemplateElement | ComputedMemberExpression | StaticMemberExpression | PrivateFieldExpression | CallExpression | NewExpression | MetaProperty | SpreadElement | UpdateExpression | UnaryExpression | BinaryExpression | PrivateInExpression | LogicalExpression | ConditionalExpression | AssignmentExpression | ArrayAssignmentTarget | ObjectAssignmentTarget | AssignmentTargetRest | AssignmentTargetWithDefault | AssignmentTargetPropertyIdentifier | AssignmentTargetPropertyProperty | SequenceExpression | Super | AwaitExpression | ChainExpression | ParenthesizedExpression | Directive | Hashbang | BlockStatement | VariableDeclaration | VariableDeclarator | EmptyStatement | ExpressionStatement | IfStatement | DoWhileStatement | WhileStatement | ForStatement | ForInStatement | ForOfStatement | ContinueStatement | BreakStatement | ReturnStatement | WithStatement | SwitchStatement | SwitchCase | LabeledStatement | ThrowStatement | TryStatement | CatchClause | DebuggerStatement | AssignmentPattern | ObjectPattern | BindingProperty | ArrayPattern | BindingRestElement | Function$1 | FunctionBody | ArrowFunctionExpression | YieldExpression | Class | ClassBody | MethodDefinition | PropertyDefinition | PrivateIdentifier | StaticBlock | AccessorProperty | ImportExpression | ImportDeclaration | ImportSpecifier | ImportDefaultSpecifier | ImportNamespaceSpecifier | ImportAttribute | ExportNamedDeclaration | ExportDefaultDeclaration | ExportAllDeclaration | ExportSpecifier | V8IntrinsicExpression | BooleanLiteral | NullLiteral | NumericLiteral | StringLiteral | BigIntLiteral | RegExpLiteral | JSXElement | JSXOpeningElement | JSXClosingElement | JSXFragment | JSXOpeningFragment | JSXClosingFragment | JSXNamespacedName | JSXMemberExpression | JSXExpressionContainer | JSXEmptyExpression | JSXAttribute | JSXSpreadAttribute | JSXIdentifier | JSXSpreadChild | JSXText | TSThisParameter | TSEnumDeclaration | TSEnumBody | TSEnumMember | TSTypeAnnotation | TSLiteralType | TSConditionalType | TSUnionType | TSIntersectionType | TSParenthesizedType | TSTypeOperator | TSArrayType | TSIndexedAccessType | TSTupleType | TSNamedTupleMember | TSOptionalType | TSRestType | TSAnyKeyword | TSStringKeyword | TSBooleanKeyword | TSNumberKeyword | TSNeverKeyword | TSIntrinsicKeyword | TSUnknownKeyword | TSNullKeyword | TSUndefinedKeyword | TSVoidKeyword | TSSymbolKeyword | TSThisType | TSObjectKeyword | TSBigIntKeyword | TSTypeReference | TSQualifiedName | TSTypeParameterInstantiation | TSTypeParameter | TSTypeParameterDeclaration | TSTypeAliasDeclaration | TSClassImplements | TSInterfaceDeclaration | TSInterfaceBody | TSPropertySignature | TSIndexSignature | TSCallSignatureDeclaration | TSMethodSignature | TSConstructSignatureDeclaration | TSIndexSignatureName | TSInterfaceHeritage | TSTypePredicate | TSModuleDeclaration | TSGlobalDeclaration | TSModuleBlock | TSTypeLiteral | TSInferType | TSTypeQuery | TSImportType | TSImportTypeQualifiedName | TSFunctionType | TSConstructorType | TSMappedType | TSTemplateLiteralType | TSAsExpression | TSSatisfiesExpression | TSTypeAssertion | TSImportEqualsDeclaration | TSExternalModuleReference | TSNonNullExpression | Decorator | TSExportAssignment | TSNamespaceExportDeclaration | TSInstantiationExpression | JSDocNullableType | JSDocNonNullableType | JSDocUnknownType | ParamPattern;
 //#endregion
-//#region ../../../../node_modules/rolldown/dist/shared/binding-CYVfiOV3.d.mts
+//#region ../../../../node_modules/vite/node_modules/rolldown/dist/shared/binding-DUEnSb0A.d.mts
 type BindingStringOrRegex = string | RegExp;
 interface CodegenOptions {
   /**
@@ -2747,13 +2747,13 @@ declare class BindingMagicString {
   prependRight(index: number, content: string): this;
   appendLeft(index: number, content: string): this;
   appendRight(index: number, content: string): this;
-  overwrite(start: number, end: number, content: string): this;
+  overwrite(start: number, end: number, content: string, options?: BindingOverwriteOptions | undefined | null): this;
   toString(): string;
   hasChanged(): boolean;
   length(): number;
   isEmpty(): boolean;
   remove(start: number, end: number): this;
-  update(start: number, end: number, content: string): this;
+  update(start: number, end: number, content: string, options?: BindingUpdateOptions | undefined | null): this;
   relocate(start: number, end: number, to: number): this;
   /**
    * Alias for `relocate` to match the original magic-string API.
@@ -3025,6 +3025,9 @@ interface BindingModules {
   values: Array<BindingRenderedModule>;
   keys: Array<string>;
 }
+interface BindingOverwriteOptions {
+  contentOnly?: boolean;
+}
 interface BindingPluginContextResolveOptions {
   /**
    * - `import-statement`: `import { foo } from './lib.js';`
@@ -3096,6 +3099,9 @@ interface BindingTsconfigRawOptions {
   /** TypeScript compiler options. */
   compilerOptions?: BindingTsconfigCompilerOptions;
 }
+interface BindingUpdateOptions {
+  overwrite?: boolean;
+}
 interface BindingVitePluginCustom {
   'vite:import-glob'?: ViteImportGlobMeta;
 }
@@ -3134,7 +3140,7 @@ interface ViteImportGlobMeta {
   isSubImportsPattern?: boolean;
 } //#endregion
 //#endregion
-//#region ../../../../node_modules/@rolldown/pluginutils/dist/filter/composable-filters.d.ts
+//#region ../../../../node_modules/vite/node_modules/@rolldown/pluginutils/dist/filter/composable-filters.d.ts
 type StringOrRegExp$1 = string | RegExp;
 type PluginModuleType = 'js' | 'jsx' | 'ts' | 'tsx' | 'json' | 'text' | 'base64' | 'dataurl' | 'binary' | 'empty' | (string & {});
 type FilterExpression = And | Or | Not | Id | ImporterId | ModuleType$1 | Code | Query;
@@ -3196,7 +3202,7 @@ declare class Exclude$1 {
   constructor(expr: FilterExpression);
 }
 //#endregion
-//#region ../../../../node_modules/rolldown/dist/shared/define-config-BkRKRADp.d.mts
+//#region ../../../../node_modules/vite/node_modules/rolldown/dist/shared/define-config-DhJZwTRw.d.mts
 //#region src/types/misc.d.ts
 /** @inline */
 type SourcemapPathTransformOption = (relativeSourcePath: string, sourcemapPath: string) => string;
@@ -6952,7 +6958,7 @@ declare namespace index_d_exports$2 {
   export { AddonFunction, AdvancedChunksGroup, AdvancedChunksOptions, AsyncPluginHooks, BufferEncoding, BuildOptions$2 as BuildOptions, BundleError, ChecksOptions, ChunkFileNamesFunction, ChunkingContext, CodeSplittingGroup, CodeSplittingNameFunction, CodeSplittingOptions, CommentsOptions, ConfigExport, CustomPluginOptions, DefineParallelPluginResult, EmittedAsset, EmittedChunk, EmittedFile, EmittedPrebuiltChunk, ExistingRawSourceMap, ExternalOption, ExternalOptionFunction, FunctionPluginHooks, GeneralHookFilter, GeneratedCodeOptions, GeneratedCodePreset, GetModuleInfo, GlobalsFunction, HookFilter, HookFilterExtension, ImportKind, InputOption, InputOptions, InternalModuleFormat, LoadResult, LogLevel$1 as LogLevel, LogLevelOption, LogOrStringHandler, LoggingFunction, MinifyOptions$1 as MinifyOptions, MinimalPluginContext, ModuleFormat, ModuleInfo, ModuleOptions, ModuleType, ModuleTypeFilter, ModuleTypes, NormalizedInputOptions, NormalizedOutputOptions, ObjectHook, OptimizationOptions, OutputAsset, OutputBundle, OutputChunk, OutputOptions, ParallelPluginHooks, PartialNull, PartialResolvedId, Plugin$2 as Plugin, PluginContext, PluginContextMeta, PluginContextResolveOptions, PreRenderedAsset, PreRenderedChunk, RUNTIME_MODULE_ID, RenderedChunk, RenderedModule, ResolveIdExtraOptions, ResolveIdResult, ResolvedId, RolldownBuild, RolldownDirectoryEntry, RolldownError, RolldownFileStats, RolldownFsModule, RolldownLog, RolldownLogWithString, RolldownMagicString, RolldownOptions, RolldownOptionsFunction, RolldownOutput, RolldownPlugin, RolldownPluginOption, RolldownWatcher, RolldownWatcherEvent, RolldownWatcherWatcherEventMap, RolldownError as RollupError, RolldownLog as RollupLog, RolldownLogWithString as RollupLogWithString, SourceDescription, SourceMap$1 as SourceMap, SourceMapInput, SourcemapIgnoreListOption, TransformOptions$2 as TransformOptions, TransformPluginContext, TransformResult$2 as TransformResult, TreeshakingOptions, VERSION$1 as VERSION, WarningHandlerWithDefault, WatchOptions$1 as WatchOptions, WatcherFileWatcherOptions, WatcherOptions, build$1 as build, defineConfig$1 as defineConfig, rolldown, watch };
 }
 //#endregion
-//#region ../../../../node_modules/rolldown/dist/parse-ast-index.d.mts
+//#region ../../../../node_modules/vite/node_modules/rolldown/dist/parse-ast-index.d.mts
 /**
 * @hidden
 */
@@ -6993,7 +6999,7 @@ type RollupWatcher = RolldownWatcher;
 /** @deprecated use RollupWatcherEvent instead */
 type RollupWatcherEvent = RolldownWatcherEvent;
 //#endregion
-//#region ../../../../node_modules/rolldown/dist/shared/constructors-DRe7RuMC.d.mts
+//#region ../../../../node_modules/vite/node_modules/rolldown/dist/shared/constructors-DYemMpPL.d.mts
 /**
 * A plugin that converts CommonJS require() calls for external dependencies into ESM import statements.
 *
@@ -7002,7 +7008,7 @@ type RollupWatcherEvent = RolldownWatcherEvent;
 */
 declare function esmExternalRequirePlugin(config?: BindingEsmExternalRequirePluginConfig): BuiltinPlugin;
 //#endregion
-//#region ../../../../node_modules/rolldown/dist/shared/transform-C_gBfjMR.d.mts
+//#region ../../../../node_modules/vite/node_modules/rolldown/dist/shared/transform-Kz3D2LbX.d.mts
 //#endregion
 //#region src/utils/parse.d.ts
 /**
@@ -7112,8 +7118,8 @@ type TransformResult$1 = Omit<BindingEnhancedTransformResult, "errors" | "warnin
 * @experimental
 */
 //#endregion
-//#region ../../../../node_modules/rolldown/dist/utils-index.d.mts
-//#region ../../node_modules/.pnpm/oxc-parser@0.121.0/node_modules/oxc-parser/src-js/generated/visit/visitor.d.ts
+//#region ../../../../node_modules/vite/node_modules/rolldown/dist/utils-index.d.mts
+//#region ../../node_modules/.pnpm/oxc-parser@0.124.0_@emnapi+core@1.9.2_@emnapi+runtime@1.9.2/node_modules/oxc-parser/src-js/generated/visit/visitor.d.ts
 interface VisitorObject$1 {
   DebuggerStatement?: (node: DebuggerStatement) => void;
   "DebuggerStatement:exit"?: (node: DebuggerStatement) => void;
@@ -7959,7 +7965,7 @@ declare namespace index_d_exports {
 }
 //#region \0rolldown/runtime.js
 //#endregion
-//#region ../../node_modules/.pnpm/@vitejs+devtools@0.1.5_typescript@5.9.3_vite@packages+vite_vue@3.5.30_typescript@5.9.3_/node_modules/@vitejs/devtools/dist/cli-commands.d.ts
+//#region ../../node_modules/.pnpm/@vitejs+devtools@0.1.13_typescript@6.0.2_vite@packages+vite/node_modules/@vitejs/devtools/dist/cli-commands.d.ts
 //#region src/node/cli-commands.d.ts
 interface StartOptions {
   root?: string;
@@ -7968,7 +7974,7 @@ interface StartOptions {
   port?: string | number;
   open?: boolean;
 } //#endregion
-//#region ../../node_modules/.pnpm/@vitejs+devtools@0.1.5_typescript@5.9.3_vite@packages+vite_vue@3.5.30_typescript@5.9.3_/node_modules/@vitejs/devtools/dist/config.d.ts
+//#region ../../node_modules/.pnpm/@vitejs+devtools@0.1.13_typescript@6.0.2_vite@packages+vite/node_modules/@vitejs/devtools/dist/config.d.ts
 //#region src/node/config.d.ts
 interface DevToolsConfig extends Partial<StartOptions> {
   enabled: boolean;
@@ -8928,8 +8934,7 @@ interface TransformOptions {
   * @deprecated inferred from environment
   */
   ssr?: boolean;
-}
-interface TransformOptionsInternal {} //#endregion
+} //#endregion
 //#region src/node/server/moduleGraph.d.ts
 declare class EnvironmentModuleNode {
   environment: string;
@@ -9091,6 +9096,11 @@ interface HotChannelClient {
 }
 type HotChannelListener<T extends string = string> = (data: InferCustomEventPayload<T>, client: HotChannelClient) => void;
 interface HotChannel<Api = any> {
+  /**
+  * When true, the fs access check is skipped in fetchModule.
+  * Set this for transports that is not exposed over the network.
+  */
+  skipFsCheck?: boolean;
   /**
   * Broadcast events to all clients
   */
@@ -9513,9 +9523,15 @@ declare class DevEnvironment extends BaseEnvironment {
   * - new instance `listen`
   */
   listen(server: ViteDevServer): Promise<void>;
+  /**
+  * Called by the module runner to retrieve information about the specified
+  * module. Internally calls `transformRequest` and wraps the result in the
+  * format that the module runner understands.
+  * This method is not meant to be called manually.
+  */
   fetchModule(id: string, importer?: string, options?: FetchFunctionOptions): Promise<FetchResult>;
   reloadModule(module: EnvironmentModuleNode): Promise<void>;
-  transformRequest(url: string, options?: TransformOptionsInternal): Promise<TransformResult | null>;
+  transformRequest(url: string): Promise<TransformResult | null>;
   warmupRequest(url: string): Promise<void>;
   protected invalidateModule(m: {
     path: string;
@@ -11603,7 +11619,7 @@ interface FetchModuleOptions {
   startOffset?: number;
 }
 /**
-* Fetch module information for Vite runner.
+* Fetch module information for Vite module runner.
 * @experimental
 */
 declare function fetchModule(environment: DevEnvironment, url: string, importer?: string, options?: FetchModuleOptions): Promise<FetchResult>; //#endregion