alepha 0.19.3 → 0.19.5

package/dist/api/workflows/index.d.ts

@@ -0,0 +1,1618 @@
+import * as _$alepha from "alepha";
+import { Alepha, AlephaError, KIND, Primitive, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
+import { LockProvider } from "alepha/lock";
+import * as _$alepha_server0 from "alepha/server";
+import * as _$alepha_orm0 from "alepha/orm";
+import { DatabaseProvider } from "alepha/orm";
+import { DateTimeProvider, DurationLike } from "alepha/datetime";
+import * as _$alepha_logger0 from "alepha/logger";
+import { BuildExtraConfigColumns, SQL, SQLWrapper } from "drizzle-orm";
+import { PgColumnBuilderBase, PgSequenceOptions, PgTableExtraConfigValue, UpdateDeleteAction } from "drizzle-orm/pg-core";
+import * as _$typebox from "typebox";
+//#region ../../src/orm/core/schemas/insertSchema.d.ts
+/**
+ * Transforms a TObject schema for insert operations.
+ * All default properties at the root level are made optional.
+ * Generated columns are excluded entirely.
+ *
+ * @example
+ * Before: { name: string; age: number(default=0); fullName: generated }
+ * After:  { name: string; age?: number; }
+ */
+type TObjectInsert<T extends TObject> = TObject<{ [K in keyof T["properties"] as T["properties"][K] extends {
+  [PG_GENERATED]: any;
+} ? never : K]: T["properties"][K] extends {
+  [PG_DEFAULT]: any;
+} | {
+  "~optional": true;
+} ? TOptional<T["properties"][K]> : T["properties"][K] }>;
+//#endregion
+//#region ../../src/orm/core/schemas/updateSchema.d.ts
+/**
+ * Transforms a TObject schema for update operations.
+ * All optional properties at the root level are made nullable (i.e., `T | null`).
+ * Generated columns are excluded entirely.
+ *
+ * @example
+ * Before: { name?: string; age: number; fullName: generated }
+ * After:  { name?: string | null; age: number; }
+ */
+type TObjectUpdate<T extends TObject> = TObject<{ [K in keyof T["properties"] as T["properties"][K] extends {
+  [PG_GENERATED]: any;
+} ? never : K]: T["properties"][K] extends TOptional<infer U> ? TOptional<TUnion<[U, TNull]>> : T["properties"][K] }>;
+//#endregion
+//#region ../../src/orm/core/primitives/$entity.d.ts
+interface EntityPrimitiveOptions<T extends TObject, Keys = keyof Static<T>> {
+  /**
+   * The database table name that will be created for this entity.
+   * If not provided, name will be inferred from the $repository variable name.
+   */
+  name: string;
+  /**
+   * TypeBox schema defining the table structure and column types.
+   */
+  schema: T;
+  /**
+   * Database indexes to create for query optimization.
+   */
+  indexes?: (Keys | {
+    /**
+     * Single column to index.
+     */
+    column: Keys;
+    /**
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
+    unique?: boolean;
+    /**
+     * Custom name for the index. If not provided, generates name automatically.
+     */
+    name?: string;
+    /**
+     * Partial index condition. Only rows matching this SQL expression are indexed.
+     */
+    where?: SQL;
+  } | {
+    /**
+     * Multiple columns for composite index (order matters for query optimization).
+     */
+    columns: Keys[];
+    /**
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
+    unique?: boolean;
+    /**
+     * Custom name for the index. If not provided, generates name automatically.
+     */
+    name?: string;
+    /**
+     * Partial index condition. Only rows matching this SQL expression are indexed.
+     */
+    where?: SQL;
+  } | {
+    /**
+     * SQL expressions for expression-based indexes.
+     *
+     * Can include column references and SQL functions like `LOWER()`, `UPPER()`, etc.
+     * Columns and expressions can be mixed together.
+     *
+     * @example
+     * ```ts
+     * // Case-insensitive unique username per realm
+     * indexes: [{
+     *   expressions: (self) => [self.realm, sql`LOWER(${self.username})`],
+     *   unique: true,
+     *   name: "users_realm_username_lower_idx",
+     * }]
+     * ```
+     */
+    expressions: (self: Record<Keys & string, any>) => (SQL | any)[];
+    /**
+     * Whether this should be a unique index (enforces uniqueness constraint).
+     */
+    unique?: boolean;
+    /**
+     * Custom name for the index. If not provided, generates name automatically.
+     */
+    name: string;
+    /**
+     * Partial index condition. Only rows matching this SQL expression are indexed.
+     */
+    where?: SQL;
+  })[];
+  /**
+   * Foreign key constraints to maintain referential integrity.
+   */
+  foreignKeys?: Array<{
+    /**
+     * Optional name for the foreign key constraint.
+     */
+    name?: string;
+    /**
+     * Local columns that reference the foreign table.
+     */
+    columns: Array<keyof Static<T>>;
+    /**
+     * Referenced columns in the foreign table.
+     * Must be EntityColumn references from other entities.
+     */
+    foreignColumns: Array<() => EntityColumn<any>>;
+  }>;
+  /**
+   * Additional table constraints for data validation.
+   *
+   * Constraints enforce business rules at the database level, providing
+   * an additional layer of data integrity beyond application validation.
+   *
+   * **Constraint Types**:
+   * - **Unique constraints**: Prevent duplicate values across columns
+   * - **Check constraints**: Enforce custom validation rules with SQL expressions
+   *
+   * @example
+   * ```ts
+   * constraints: [
+   *   {
+   *     name: "unique_user_email",
+   *     columns: ["email"],
+   *     unique: true
+   *   },
+   *   {
+   *     name: "valid_age_range",
+   *     columns: ["age"],
+   *     check: sql`age >= 0 AND age <= 150`
+   *   },
+   *   {
+   *     name: "unique_user_username_per_tenant",
+   *     columns: ["tenantId", "username"],
+   *     unique: true
+   *   }
+   * ]
+   * ```
+   */
+  constraints?: Array<{
+    /**
+     * Columns involved in this constraint.
+     */
+    columns: Array<keyof Static<T>>;
+    /**
+     * Optional name for the constraint.
+     */
+    name?: string;
+    /**
+     * Whether this is a unique constraint.
+     */
+    unique?: boolean | {};
+    /**
+     * SQL expression for check constraint validation.
+     */
+    check?: SQL;
+  }>;
+  /**
+   * Advanced Drizzle ORM configuration for complex table setups.
+   */
+  config?: (self: BuildExtraConfigColumns<string, FromSchema<T>, "pg">) => PgTableExtraConfigValue[];
+}
+declare class EntityPrimitive<T extends TObject = TObject> {
+  readonly options: EntityPrimitiveOptions<T>;
+  constructor(options: EntityPrimitiveOptions<T>);
+  alias(alias: string): this;
+  get cols(): EntityColumns<T>;
+  get name(): string;
+  get schema(): T;
+  get insertSchema(): TObjectInsert<T>;
+  get updateSchema(): TObjectUpdate<T>;
+}
+/**
+ * Convert a schema to columns.
+ */
+type FromSchema<T extends TObject> = { [key in keyof T["properties"]]: PgColumnBuilderBase };
+type EntityColumn<T extends TObject> = {
+  name: string;
+  entity: EntityPrimitive<T>;
+};
+type EntityColumns<T extends TObject> = { [key in keyof T["properties"]]: EntityColumn<T> };
+//#endregion
+//#region ../../src/orm/core/constants/PG_SYMBOLS.d.ts
+declare const PG_DEFAULT: unique symbol;
+declare const PG_PRIMARY_KEY: unique symbol;
+declare const PG_CREATED_AT: unique symbol;
+declare const PG_UPDATED_AT: unique symbol;
+declare const PG_DELETED_AT: unique symbol;
+declare const PG_VERSION: unique symbol;
+declare const PG_IDENTITY: unique symbol;
+declare const PG_ENUM: unique symbol;
+declare const PG_REF: unique symbol;
+declare const PG_GENERATED: unique symbol;
+declare const PG_ORGANIZATION: unique symbol;
+/**
+ * @deprecated Use `PG_IDENTITY` instead.
+ */
+declare const PG_SERIAL: unique symbol;
+type PgSymbols = {
+  [PG_DEFAULT]: {};
+  [PG_PRIMARY_KEY]: {};
+  [PG_CREATED_AT]: {};
+  [PG_UPDATED_AT]: {};
+  [PG_DELETED_AT]: {};
+  [PG_VERSION]: {};
+  [PG_IDENTITY]: PgIdentityOptions;
+  [PG_REF]: PgRefOptions;
+  [PG_ENUM]: PgEnumOptions;
+  [PG_GENERATED]: PgGeneratedOptions;
+  [PG_ORGANIZATION]: {};
+  /**
+   * @deprecated Use `PG_IDENTITY` instead.
+   */
+  [PG_SERIAL]: {};
+};
+type PgSymbolKeys = keyof PgSymbols;
+type PgIdentityOptions = {
+  mode: "always" | "byDefault";
+} & PgSequenceOptions & {
+  name?: string;
+};
+interface PgEnumOptions {
+  name?: string;
+  description?: string;
+}
+interface PgGeneratedOptions {
+  /**
+   * SQL expression for the generated column.
+   */
+  expression: SQL;
+  /**
+   * Storage mode for the generated column.
+   * - `"stored"` — value is computed on write and stored on disk (default for PostgreSQL).
+   * - `"virtual"` — value is computed on read (default for SQLite).
+   */
+  mode?: "stored" | "virtual";
+}
+interface PgRefOptions {
+  ref: () => {
+    name: string;
+    entity: EntityPrimitive;
+  };
+  actions?: {
+    onUpdate?: UpdateDeleteAction;
+    onDelete?: UpdateDeleteAction;
+  };
+}
+//#endregion
+//#region ../../src/orm/core/interfaces/PgQuery.d.ts
+type PgStatic<T extends TObject, Relations extends PgRelationMap<T>> = Static<T> & { [K in keyof Relations]: Static<Relations[K]["join"]["schema"]> & (Relations[K]["with"] extends PgRelationMap<TObject> ? PgStatic<Relations[K]["join"]["schema"], Relations[K]["with"]> : {}) };
+type PgRelationMap<Base extends TObject> = Record<string, PgRelation<Base>>;
+type PgRelation<Base extends TObject> = {
+  type?: "left" | "inner" | "right";
+  join: {
+    schema: TObject;
+    name: string;
+  };
+  on: SQLWrapper | [keyof Static<Base>, {
+    name: string;
+  }];
+  with?: PgRelationMap<TObject>;
+};
+//#endregion
+//#region ../../src/orm/core/helpers/pgAttr.d.ts
+/**
+ * Type representation.
+ */
+type PgAttr<T extends TSchema, TAttr extends PgSymbolKeys> = T & { [K in TAttr]: PgSymbols[K] };
+//#endregion
+//#region ../../src/orm/core/schemas/databaseEnvSchema.d.ts
+/**
+ * Base database environment schema.
+ *
+ * Defines the `DATABASE_URL` connection string used by all ORM providers
+ * to determine the database driver and connection target.
+ *
+ * Supported URL formats:
+ * - `sqlite://:memory:` or `sqlite://./path/to/db` — SQLite (Node.js or Bun)
+ * - `postgres://user:password@host:port/database` — PostgreSQL (Node.js or Bun)
+ * - `pglite://:memory:` or `pglite://./path` — PGlite (embedded Postgres)
+ * - `d1://BINDING_NAME` — Cloudflare D1
+ * - `hyperdrive://BINDING_NAME` — Cloudflare Hyperdrive
+ */
+declare const databaseEnvSchema: _$alepha.TObject<{
+  DATABASE_URL: _$alepha.TOptional<_$alepha.TString>;
+  /**
+   * Enable or disable push-based schema synchronization (drizzle-kit push).
+   *
+   * Defaults to `true` in development and test, `false` in production.
+   * Set to `false` in development to skip automatic schema sync
+   * (e.g. when managing migrations manually).
+   */
+  DATABASE_SYNC: _$alepha.TOptional<_$alepha.TBoolean>;
+}>;
+declare module "alepha" {
+  interface Env extends Partial<Static<typeof databaseEnvSchema>> {}
+} //# sourceMappingURL=databaseEnvSchema.d.ts.map
+//#endregion
+//#region ../../src/api/workflows/entities/workflowExecutions.d.ts
+declare const workflowExecutions: _$alepha_orm0.EntityPrimitive<_$alepha.TObject<{
+  id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+  createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  workflowName: _$alepha.TString;
+  tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+  payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+  status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
+  currentStep: _$alepha.TOptional<_$alepha.TString>;
+  startedAt: _$alepha.TOptional<_$alepha.TString>;
+  completedAt: _$alepha.TOptional<_$alepha.TString>;
+  deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+  error: _$alepha.TOptional<_$alepha.TString>;
+  errorStep: _$alepha.TOptional<_$alepha.TString>;
+  triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+  triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+  cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+  cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+  key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+  priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+}>>;
+type WorkflowExecutionEntity = Static<typeof workflowExecutions.schema>;
+type WorkflowStatus = "pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled";
+//#endregion
+//#region ../../src/api/workflows/entities/workflowStepExecutions.d.ts
+declare const workflowStepExecutions: _$alepha_orm0.EntityPrimitive<_$alepha.TObject<{
+  id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+  createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+  workflowExecutionId: _$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_REF>;
+  stepName: _$alepha.TString;
+  stepIndex: _$alepha.TInteger;
+  stepType: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof _$alepha_orm0.PG_DEFAULT>;
+  parentStepId: _$alepha.TOptional<_$alepha.TString>;
+  branchName: _$alepha.TOptional<_$alepha.TString>;
+  status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof _$alepha_orm0.PG_DEFAULT>;
+  attempt: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+  maxAttempts: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+  result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+  error: _$alepha.TOptional<_$alepha.TString>;
+  startedAt: _$alepha.TOptional<_$alepha.TString>;
+  completedAt: _$alepha.TOptional<_$alepha.TString>;
+  deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+  signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+  signalledBy: _$alepha.TOptional<_$alepha.TString>;
+  signalledAt: _$alepha.TOptional<_$alepha.TString>;
+}>>;
+type WorkflowStepExecutionEntity = Static<typeof workflowStepExecutions.schema>;
+type WorkflowStepStatus = "pending" | "running" | "completed" | "failed" | "skipped" | "waiting" | "compensating" | "compensated" | "compensation_failed" | "cancelled";
+//#endregion
+//#region ../../src/api/workflows/primitives/$workflow.d.ts
+type WorkflowPriority = "critical" | "high" | "normal" | "low";
+interface WorkflowRetryOptions {
+  retries: number;
+  backoff?: DurationLike | WorkflowRetryBackoff;
+  when?: (error: Error) => boolean;
+}
+interface WorkflowRetryBackoff {
+  initial: DurationLike;
+  factor?: number;
+  max?: DurationLike;
+  jitter?: boolean;
+}
+interface StepHandlerArgs<TInput extends TSchema = TSchema> {
+  payload: Static<TInput>;
+  results: Record<string, unknown>;
+  context: {
+    workflowId: string;
+    executionId: string;
+    stepName: string;
+    attempt: number;
+  };
+  signal: AbortSignal;
+}
+interface StepCompensateArgs<TInput extends TSchema = TSchema> {
+  payload: Static<TInput>;
+  result: unknown;
+  results: Record<string, unknown>;
+  context: {
+    workflowId: string;
+    executionId: string;
+    stepName: string;
+    error: Error;
+  };
+}
+interface StepConditionArgs<TInput extends TSchema = TSchema> {
+  payload: Static<TInput>;
+  results: Record<string, unknown>;
+}
+interface HandlerStep<TInput extends TSchema = TSchema> {
+  name: string;
+  type?: "handler";
+  handler: (args: StepHandlerArgs<TInput>) => Promise<unknown>;
+  compensate?: (args: StepCompensateArgs<TInput>) => Promise<void>;
+  retry?: WorkflowRetryOptions;
+  timeout?: DurationLike;
+  when?: (args: StepConditionArgs<TInput>) => boolean | Promise<boolean>;
+}
+type WorkflowStep<TInput extends TSchema = TSchema> = HandlerStep<TInput>;
+interface WorkflowPrimitiveOptions<TInput extends TSchema = TSchema> {
+  /**
+   * TypeBox schema for the workflow input payload.
+   */
+  schema: TInput;
+  /**
+   * Ordered list of steps. Executed sequentially.
+   */
+  steps: Array<WorkflowStep<TInput>>;
+  /**
+   * Error strategy.
+   * - "compensate": Run compensate functions in reverse order (saga pattern).
+   * - "fail": Mark workflow as failed, no compensation.
+   * @default "compensate"
+   */
+  onError?: "compensate" | "fail";
+  /**
+   * Maximum total duration for the entire workflow.
+   */
+  timeout?: DurationLike;
+  /**
+   * Priority for the workflow's job dispatches.
+   * @default "normal"
+   */
+  priority?: WorkflowPriority;
+  /**
+   * Tags for filtering/grouping in admin UI.
+   */
+  tags?: string[];
+}
+interface WorkflowStartOptions {
+  key?: string;
+  priority?: WorkflowPriority;
+  delay?: DurationLike;
+  triggeredBy?: string;
+  triggeredByName?: string;
+  tags?: string[];
+}
+declare class WorkflowPrimitive<TInput extends TSchema = TSchema> extends Primitive<WorkflowPrimitiveOptions<TInput>> {
+  protected readonly workflowProvider: WorkflowProvider;
+  get name(): string;
+  protected onInit(): void;
+  /**
+   * Start a new workflow execution.
+   */
+  start(payload: Static<TInput>, options?: WorkflowStartOptions): Promise<string>;
+  /**
+   * Send a signal to a waiting step on a specific execution.
+   */
+  signal(executionId: string, stepName: string, payload?: unknown): Promise<void>;
+  /**
+   * Cancel a running execution.
+   */
+  cancel(executionId: string, options?: {
+    compensate?: boolean;
+  }): Promise<void>;
+  /**
+   * Retry a failed/timed-out execution from the failed step.
+   */
+  retry(executionId: string): Promise<void>;
+  /**
+   * Restart a terminal execution from the beginning (new execution).
+   */
+  restart(executionId: string): Promise<string>;
+  /**
+   * Get the status of an execution.
+   */
+  status(executionId: string): Promise<{
+    steps: PgStatic<_$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      workflowExecutionId: PgAttr<_$alepha.TString, typeof PG_REF>;
+      stepName: _$alepha.TString;
+      stepIndex: _$alepha.TInteger;
+      stepType: PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof PG_DEFAULT>;
+      parentStepId: _$alepha.TOptional<_$alepha.TString>;
+      branchName: _$alepha.TOptional<_$alepha.TString>;
+      status: PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof PG_DEFAULT>;
+      attempt: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+      maxAttempts: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+      result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      signalledBy: _$alepha.TOptional<_$alepha.TString>;
+      signalledAt: _$alepha.TOptional<_$alepha.TString>;
+    }>, PgRelationMap<_$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      workflowExecutionId: PgAttr<_$alepha.TString, typeof PG_REF>;
+      stepName: _$alepha.TString;
+      stepIndex: _$alepha.TInteger;
+      stepType: PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof PG_DEFAULT>;
+      parentStepId: _$alepha.TOptional<_$alepha.TString>;
+      branchName: _$alepha.TOptional<_$alepha.TString>;
+      status: PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof PG_DEFAULT>;
+      attempt: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+      maxAttempts: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+      result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      signalledBy: _$alepha.TOptional<_$alepha.TString>;
+      signalledAt: _$alepha.TOptional<_$alepha.TString>;
+    }>>>[];
+    tags?: string[] | undefined;
+    payload?: _$typebox.StaticRecord<[], "Decode", {}, {
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      workflowName: _$alepha.TString;
+      tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      status: PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof PG_DEFAULT>;
+      currentStep: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      errorStep: _$alepha.TOptional<_$alepha.TString>;
+      triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+      triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+      cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+      cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+      key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+      priority: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+    }, "^.*$", _$alepha.TAny> | undefined;
+    currentStep?: string | undefined;
+    startedAt?: string | undefined;
+    completedAt?: string | undefined;
+    deadlineAt?: string | undefined;
+    error?: string | undefined;
+    errorStep?: string | undefined;
+    triggeredBy?: string | undefined;
+    triggeredByName?: string | undefined;
+    cancelledBy?: string | undefined;
+    cancelledByName?: string | undefined;
+    key?: string | null | undefined;
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    workflowName: string;
+    status: "pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled";
+    priority: number;
+  }>;
+}
+declare const $workflow: {
+  <TInput extends TSchema>(options: WorkflowPrimitiveOptions<TInput>): WorkflowPrimitive<TInput>;
+  [KIND]: typeof WorkflowPrimitive;
+};
+//#endregion
+//#region ../../src/api/workflows/providers/WorkflowProvider.d.ts
+interface WorkflowRegistration$1 {
+  name: string;
+  options: WorkflowPrimitiveOptions;
+}
+interface CancelOptions {
+  compensate?: boolean;
+  cancelledBy?: string;
+  cancelledByName?: string;
+}
+declare class WorkflowProvider {
+  protected readonly alepha: Alepha;
+  protected readonly dt: DateTimeProvider;
+  protected readonly lockProvider: LockProvider;
+  protected readonly config: Readonly<{
+    recovery: {
+      staleThreshold: number;
+    };
+    logMaxEntries: number;
+    drainTimeout: number;
+    defaultStepTimeout: number;
+    retentionDays: number;
+    maxConcurrentWorkflows: number;
+    maxStepsPerWorkflow: number;
+  }>;
+  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly executions: _$alepha_orm0.Repository<_$alepha.TObject<{
+    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+    createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    workflowName: _$alepha.TString;
+    tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+    payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+    status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
+    currentStep: _$alepha.TOptional<_$alepha.TString>;
+    startedAt: _$alepha.TOptional<_$alepha.TString>;
+    completedAt: _$alepha.TOptional<_$alepha.TString>;
+    deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+    error: _$alepha.TOptional<_$alepha.TString>;
+    errorStep: _$alepha.TOptional<_$alepha.TString>;
+    triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+    triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+    cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+    cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+    key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+    priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+  }>>;
+  protected readonly stepExecutions: _$alepha_orm0.Repository<_$alepha.TObject<{
+    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+    createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    workflowExecutionId: _$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_REF>;
+    stepName: _$alepha.TString;
+    stepIndex: _$alepha.TInteger;
+    stepType: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof _$alepha_orm0.PG_DEFAULT>;
+    parentStepId: _$alepha.TOptional<_$alepha.TString>;
+    branchName: _$alepha.TOptional<_$alepha.TString>;
+    status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof _$alepha_orm0.PG_DEFAULT>;
+    attempt: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+    maxAttempts: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+    result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+    error: _$alepha.TOptional<_$alepha.TString>;
+    startedAt: _$alepha.TOptional<_$alepha.TString>;
+    completedAt: _$alepha.TOptional<_$alepha.TString>;
+    deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+    signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+    signalledBy: _$alepha.TOptional<_$alepha.TString>;
+    signalledAt: _$alepha.TOptional<_$alepha.TString>;
+  }>>;
+  protected readonly stepLogs: _$alepha_orm0.Repository<_$alepha.TObject<{
+    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+    logs: _$alepha.TArray<_$alepha.TObject<{
+      level: _$alepha.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
+      message: _$alepha.TString;
+      service: _$alepha.TString;
+      module: _$alepha.TString;
+      context: _$alepha.TOptional<_$alepha.TString>;
+      app: _$alepha.TOptional<_$alepha.TString>;
+      data: _$alepha.TOptional<_$alepha.TAny>;
+      timestamp: _$alepha.TNumber;
+    }>>;
+  }>>;
+  protected readonly workflows: Map<string, WorkflowRegistration$1>;
+  protected readonly pausedWorkflows: Set<string>;
+  protected readonly inFlight: Set<Promise<void>>;
+  protected readonly abortControllers: Map<string, AbortController>;
+  protected readonly logs: Map<string, {
+    data?: any;
+    context?: string | undefined;
+    app?: string | undefined;
+    level: "SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR";
+    message: string;
+    service: string;
+    module: string;
+    timestamp: number;
+  }[]>;
+  protected stopping: boolean;
+  /**
+   * When set, step dispatches go through a queue.
+   * Set by WorkflowJobs on start.
+   */
+  stepDispatch: ((workflowId: string, stepName: string, priority: number) => Promise<void>) | null;
+  register(primitive: WorkflowPrimitive<any>): void;
+  getRegisteredWorkflows(): Map<string, WorkflowRegistration$1>;
+  start(workflowName: string, payload: unknown, options?: WorkflowStartOptions): Promise<string>;
+  processStep(workflowId: string, stepName: string): Promise<void>;
+  protected processStepInner(workflowId: string, stepName: string): Promise<void>;
+  protected executeHandlerStep(workflow: WorkflowExecutionEntity, stepExec: WorkflowStepExecutionEntity, stepDef: HandlerStep): Promise<void>;
+  protected handleStepFailure(workflow: WorkflowExecutionEntity, stepExec: WorkflowStepExecutionEntity, stepDef: HandlerStep, error: Error, _context: string): Promise<void>;
+  protected advance(workflowId: string): Promise<void>;
+  compensate(workflowId: string, context?: {
+    failedStep?: string;
+    error?: Error;
+  }): Promise<void>;
+  cancel(workflowId: string, options?: CancelOptions): Promise<void>;
+  /**
+   * Send a signal to a waiting workflow step.
+   */
+  signal(workflowId: string, stepName: string, payload?: unknown, signalledBy?: string): Promise<void>;
+  retry(workflowId: string): Promise<void>;
+  restart(workflowId: string): Promise<string>;
+  getExecution(workflowId: string): Promise<{
+    steps: _$alepha_orm0.PgStatic<_$alepha.TObject<{
+      id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+      createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      workflowExecutionId: _$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_REF>;
+      stepName: _$alepha.TString;
+      stepIndex: _$alepha.TInteger;
+      stepType: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof _$alepha_orm0.PG_DEFAULT>;
+      parentStepId: _$alepha.TOptional<_$alepha.TString>;
+      branchName: _$alepha.TOptional<_$alepha.TString>;
+      status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof _$alepha_orm0.PG_DEFAULT>;
+      attempt: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+      maxAttempts: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+      result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      signalledBy: _$alepha.TOptional<_$alepha.TString>;
+      signalledAt: _$alepha.TOptional<_$alepha.TString>;
+    }>, _$alepha_orm0.PgRelationMap<_$alepha.TObject<{
+      id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+      createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      workflowExecutionId: _$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_REF>;
+      stepName: _$alepha.TString;
+      stepIndex: _$alepha.TInteger;
+      stepType: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof _$alepha_orm0.PG_DEFAULT>;
+      parentStepId: _$alepha.TOptional<_$alepha.TString>;
+      branchName: _$alepha.TOptional<_$alepha.TString>;
+      status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof _$alepha_orm0.PG_DEFAULT>;
+      attempt: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+      maxAttempts: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+      result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      signalledBy: _$alepha.TOptional<_$alepha.TString>;
+      signalledAt: _$alepha.TOptional<_$alepha.TString>;
+    }>>>[];
+    tags?: string[] | undefined;
+    payload?: _$typebox.StaticRecord<[], "Decode", {}, {
+      id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+      createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      workflowName: _$alepha.TString;
+      tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
+      currentStep: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      errorStep: _$alepha.TOptional<_$alepha.TString>;
+      triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+      triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+      cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+      cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+      key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+      priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+    }, "^.*$", _$alepha.TAny> | undefined;
+    currentStep?: string | undefined;
+    startedAt?: string | undefined;
+    completedAt?: string | undefined;
+    deadlineAt?: string | undefined;
+    error?: string | undefined;
+    errorStep?: string | undefined;
+    triggeredBy?: string | undefined;
+    triggeredByName?: string | undefined;
+    cancelledBy?: string | undefined;
+    cancelledByName?: string | undefined;
+    key?: string | null | undefined;
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    workflowName: string;
+    status: "pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled";
+    priority: number;
+  }>;
+  pauseWorkflow(name: string): void;
+  resumeWorkflow(name: string): Promise<void>;
+  isWorkflowPaused(name: string): boolean;
+  getPausedWorkflows(): string[];
+  protected dispatchStep(workflowId: string, stepName: string, priority: number): Promise<void>;
+  protected assembleResults(workflowId: string): Promise<Record<string, unknown>>;
+  protected findStepExecution(workflowId: string, stepName: string): Promise<WorkflowStepExecutionEntity | undefined>;
+  protected computeBackoff(retryOpts: WorkflowRetryOptions, attempt: number): string;
+  protected writeLogs(stepExecutionId: string, context: string): Promise<void>;
+  protected getRegistration(name: string): WorkflowRegistration$1;
+  recoverySweep(): Promise<void>;
+  timeoutSweep(): Promise<void>;
+  purge(): Promise<void>;
+  protected readonly onStart: _$alepha.HookPrimitive<"start">;
+  protected readonly onStop: _$alepha.HookPrimitive<"stop">;
+}
+//#endregion
+//#region ../../src/api/workflows/schemas/workflowActivitySchema.d.ts
+declare const workflowActivityPointSchema: _$alepha.TObject<{
+  date: _$alepha.TString;
+  completed: _$alepha.TInteger;
+  failed: _$alepha.TInteger;
+}>;
+type WorkflowActivityPoint = Static<typeof workflowActivityPointSchema>;
+declare const workflowActivityQuerySchema: _$alepha.TObject<{
+  days: _$alepha.TOptional<_$alepha.TInteger>;
+}>;
+type WorkflowActivityQuery = Static<typeof workflowActivityQuerySchema>;
+//#endregion
+//#region ../../src/api/workflows/schemas/workflowExecutionQuerySchema.d.ts
+declare const workflowExecutionQuerySchema: _$alepha.TObject<{
+  page: _$alepha.TOptional<_$alepha.TInteger>;
+  size: _$alepha.TOptional<_$alepha.TInteger>;
+  sort: _$alepha.TOptional<_$alepha.TString>;
+  workflow: _$alepha.TOptional<_$alepha.TString>;
+  status: _$alepha.TOptional<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">>;
+  from: _$alepha.TOptional<_$alepha.TString>;
+  to: _$alepha.TOptional<_$alepha.TString>;
+}>;
+type WorkflowExecutionQuery = Static<typeof workflowExecutionQuerySchema>;
+//#endregion
+//#region ../../src/api/workflows/schemas/workflowExecutionResourceSchema.d.ts
+declare const workflowExecutionCanSchema: _$alepha.TObject<{
+  retry: _$alepha.TBoolean;
+  cancel: _$alepha.TBoolean;
+  compensate: _$alepha.TBoolean;
+  restart: _$alepha.TBoolean;
+  signal: _$alepha.TOptional<_$alepha.TObject<{
+    stepName: _$alepha.TString;
+    schema: _$alepha.TOptional<_$alepha.TAny>;
+  }>>;
+}>;
+type WorkflowExecutionCan = Static<typeof workflowExecutionCanSchema>;
+declare const workflowExecutionResourceSchema: _$alepha.TObject<{
+  id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+  createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+  workflowName: _$alepha.TString;
+  tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+  payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+  status: PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof PG_DEFAULT>;
+  currentStep: _$alepha.TOptional<_$alepha.TString>;
+  startedAt: _$alepha.TOptional<_$alepha.TString>;
+  completedAt: _$alepha.TOptional<_$alepha.TString>;
+  deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+  error: _$alepha.TOptional<_$alepha.TString>;
+  errorStep: _$alepha.TOptional<_$alepha.TString>;
+  triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+  triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+  cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+  cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+  key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+  priority: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+  can: _$alepha.TObject<{
+    retry: _$alepha.TBoolean;
+    cancel: _$alepha.TBoolean;
+    compensate: _$alepha.TBoolean;
+    restart: _$alepha.TBoolean;
+    signal: _$alepha.TOptional<_$alepha.TObject<{
+      stepName: _$alepha.TString;
+      schema: _$alepha.TOptional<_$alepha.TAny>;
+    }>>;
+  }>;
+}>;
+type WorkflowExecutionResource = Static<typeof workflowExecutionResourceSchema>;
+//#endregion
+//#region ../../src/api/workflows/schemas/workflowRegistrationSchema.d.ts
+declare const workflowRegistrationSchema: _$alepha.TObject<{
+  name: _$alepha.TString;
+  stepCount: _$alepha.TInteger;
+  steps: _$alepha.TArray<_$alepha.TObject<{
+    name: _$alepha.TString;
+    type: _$alepha.TUnsafe<"handler" | "signal" | "parallel">;
+    hasCompensate: _$alepha.TBoolean;
+    hasRetry: _$alepha.TBoolean;
+    timeout: _$alepha.TOptional<_$alepha.TString>;
+  }>>;
+  onError: _$alepha.TUnsafe<"compensate" | "fail">;
+  timeout: _$alepha.TOptional<_$alepha.TString>;
+  priority: _$alepha.TString;
+  tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+  paused: _$alepha.TBoolean;
+  running: _$alepha.TInteger;
+  pending: _$alepha.TInteger;
+  waiting: _$alepha.TInteger;
+  failed: _$alepha.TInteger;
+}>;
+type WorkflowRegistration = Static<typeof workflowRegistrationSchema>;
+//#endregion
+//#region ../../src/api/workflows/schemas/workflowStatsSchema.d.ts
+declare const workflowStatsSchema: _$alepha.TObject<{
+  registered: _$alepha.TInteger;
+  running: _$alepha.TInteger;
+  pending: _$alepha.TInteger;
+  waiting: _$alepha.TInteger;
+  completed: _$alepha.TInteger;
+  failed: _$alepha.TInteger;
+  compensated: _$alepha.TInteger;
+  compensationFailed: _$alepha.TInteger;
+  cancelled: _$alepha.TInteger;
+  timedOut: _$alepha.TInteger;
+}>;
+type WorkflowStats = Static<typeof workflowStatsSchema>;
+//#endregion
+//#region ../../src/api/workflows/services/WorkflowService.d.ts
+declare class WorkflowService {
+  protected readonly alepha: Alepha;
+  protected readonly dt: DateTimeProvider;
+  protected readonly log: _$alepha_logger0.Logger;
+  protected readonly workflowProvider: WorkflowProvider;
+  protected readonly database: DatabaseProvider;
+  protected readonly executions: _$alepha_orm0.Repository<_$alepha.TObject<{
+    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+    createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    workflowName: _$alepha.TString;
+    tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+    payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+    status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
+    currentStep: _$alepha.TOptional<_$alepha.TString>;
+    startedAt: _$alepha.TOptional<_$alepha.TString>;
+    completedAt: _$alepha.TOptional<_$alepha.TString>;
+    deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+    error: _$alepha.TOptional<_$alepha.TString>;
+    errorStep: _$alepha.TOptional<_$alepha.TString>;
+    triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+    triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+    cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+    cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+    key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+    priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+  }>>;
+  protected readonly stepExecutions: _$alepha_orm0.Repository<_$alepha.TObject<{
+    id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+    createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+    workflowExecutionId: _$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_REF>;
+    stepName: _$alepha.TString;
+    stepIndex: _$alepha.TInteger;
+    stepType: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof _$alepha_orm0.PG_DEFAULT>;
+    parentStepId: _$alepha.TOptional<_$alepha.TString>;
+    branchName: _$alepha.TOptional<_$alepha.TString>;
+    status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof _$alepha_orm0.PG_DEFAULT>;
+    attempt: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+    maxAttempts: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+    result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+    error: _$alepha.TOptional<_$alepha.TString>;
+    startedAt: _$alepha.TOptional<_$alepha.TString>;
+    completedAt: _$alepha.TOptional<_$alepha.TString>;
+    deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+    signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+    signalledBy: _$alepha.TOptional<_$alepha.TString>;
+    signalledAt: _$alepha.TOptional<_$alepha.TString>;
+  }>>;
+  /**
+   * Compute available actions for a workflow execution based on its status.
+   */
+  protected computeCan(status: string, signalStepName?: string): WorkflowExecutionCan;
+  /**
+   * Convert an ISO date string to the raw SQL parameter format
+   * expected by the current database dialect.
+   *
+   * - PostgreSQL: ISO string (timestamp comparison)
+   * - SQLite: epoch milliseconds (integer comparison)
+   */
+  protected toRawDate(iso: string): string | number;
+  /**
+   * Get aggregate stats for the workflow engine.
+   */
+  getStats(days?: number): Promise<WorkflowStats>;
+  /**
+   * Get the full workflow registry with live counts.
+   */
+  getRegistry(): Promise<WorkflowRegistration[]>;
+  /**
+   * Paginated query for workflow executions.
+   */
+  findExecutions(query?: WorkflowExecutionQuery): Promise<{
+    content: {
+      can: {
+        signal?: {
+          schema?: any;
+          stepName: string;
+        } | undefined;
+        retry: boolean;
+        cancel: boolean;
+        compensate: boolean;
+        restart: boolean;
+      };
+      tags?: string[] | undefined;
+      payload?: _$typebox.StaticRecord<[], "Decode", {}, {
+        id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+        createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+        updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+        workflowName: _$alepha.TString;
+        tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+        payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+        status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
+        currentStep: _$alepha.TOptional<_$alepha.TString>;
+        startedAt: _$alepha.TOptional<_$alepha.TString>;
+        completedAt: _$alepha.TOptional<_$alepha.TString>;
+        deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+        error: _$alepha.TOptional<_$alepha.TString>;
+        errorStep: _$alepha.TOptional<_$alepha.TString>;
+        triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+        triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+        cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+        cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+        key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+        priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+      }, "^.*$", _$alepha.TAny> | undefined;
+      currentStep?: string | undefined;
+      startedAt?: string | undefined;
+      completedAt?: string | undefined;
+      deadlineAt?: string | undefined;
+      error?: string | undefined;
+      errorStep?: string | undefined;
+      triggeredBy?: string | undefined;
+      triggeredByName?: string | undefined;
+      cancelledBy?: string | undefined;
+      cancelledByName?: string | undefined;
+      key?: string | null | undefined;
+      id: string;
+      createdAt: string;
+      updatedAt: string;
+      workflowName: string;
+      status: "pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled";
+      priority: number;
+    }[];
+    page: _$alepha.StaticDecode<typeof _$alepha.pageMetadataSchema>;
+  }>;
+  /**
+   * Get a single workflow execution with step details.
+   */
+  getExecution(id: string): Promise<{
+    can: {
+      signal?: {
+        schema?: any;
+        stepName: string;
+      } | undefined;
+      retry: boolean;
+      cancel: boolean;
+      compensate: boolean;
+      restart: boolean;
+    };
+    steps: _$alepha_orm0.PgStatic<_$alepha.TObject<{
+      id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+      createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      workflowExecutionId: _$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_REF>;
+      stepName: _$alepha.TString;
+      stepIndex: _$alepha.TInteger;
+      stepType: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof _$alepha_orm0.PG_DEFAULT>;
+      parentStepId: _$alepha.TOptional<_$alepha.TString>;
+      branchName: _$alepha.TOptional<_$alepha.TString>;
+      status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof _$alepha_orm0.PG_DEFAULT>;
+      attempt: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+      maxAttempts: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+      result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      signalledBy: _$alepha.TOptional<_$alepha.TString>;
+      signalledAt: _$alepha.TOptional<_$alepha.TString>;
+    }>, _$alepha_orm0.PgRelationMap<_$alepha.TObject<{
+      id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+      createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      workflowExecutionId: _$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_REF>;
+      stepName: _$alepha.TString;
+      stepIndex: _$alepha.TInteger;
+      stepType: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof _$alepha_orm0.PG_DEFAULT>;
+      parentStepId: _$alepha.TOptional<_$alepha.TString>;
+      branchName: _$alepha.TOptional<_$alepha.TString>;
+      status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof _$alepha_orm0.PG_DEFAULT>;
+      attempt: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+      maxAttempts: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+      result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      signalledBy: _$alepha.TOptional<_$alepha.TString>;
+      signalledAt: _$alepha.TOptional<_$alepha.TString>;
+    }>>>[];
+    tags?: string[] | undefined;
+    payload?: _$typebox.StaticRecord<[], "Decode", {}, {
+      id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+      createdAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_CREATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
+      workflowName: _$alepha.TString;
+      tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
+      currentStep: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      errorStep: _$alepha.TOptional<_$alepha.TString>;
+      triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+      triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+      cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+      cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+      key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+      priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, typeof _$alepha_orm0.PG_DEFAULT>;
+    }, "^.*$", _$alepha.TAny> | undefined;
+    currentStep?: string | undefined;
+    startedAt?: string | undefined;
+    completedAt?: string | undefined;
+    deadlineAt?: string | undefined;
+    error?: string | undefined;
+    errorStep?: string | undefined;
+    triggeredBy?: string | undefined;
+    triggeredByName?: string | undefined;
+    cancelledBy?: string | undefined;
+    cancelledByName?: string | undefined;
+    key?: string | null | undefined;
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    workflowName: string;
+    status: "pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled";
+    priority: number;
+  }>;
+  /**
+   * Get daily activity (completed/failed) over a date range.
+   */
+  getActivity(days?: number): Promise<WorkflowActivityPoint[]>;
+  /**
+   * Start a new workflow execution by name.
+   */
+  triggerWorkflow(name: string, payload?: Record<string, unknown>, options?: {
+    key?: string;
+    tags?: string[];
+    triggeredBy?: string;
+    triggeredByName?: string;
+  }): Promise<{
+    id: string;
+  }>;
+  /**
+   * Cancel a running workflow execution.
+   */
+  cancelExecution(id: string, context?: {
+    compensate?: boolean;
+    cancelledBy?: string;
+    cancelledByName?: string;
+  }): Promise<{
+    ok: boolean;
+  }>;
+  /**
+   * Retry a failed/timed-out workflow from the failed step.
+   */
+  retryExecution(id: string): Promise<{
+    ok: boolean;
+  }>;
+  /**
+   * Restart a terminal workflow as a new execution.
+   */
+  restartExecution(id: string): Promise<{
+    id: string;
+  }>;
+  /**
+   * Trigger compensation on a failed/timed-out workflow.
+   */
+  compensateExecution(id: string): Promise<{
+    ok: boolean;
+  }>;
+  /**
+   * Send a signal to a waiting workflow step.
+   */
+  signalExecution(id: string, stepName: string, payload?: Record<string, unknown>, signalledBy?: string): Promise<{
+    ok: boolean;
+  }>;
+}
+//#endregion
+//#region ../../src/api/workflows/controllers/AdminWorkflowController.d.ts
+declare class AdminWorkflowController {
+  protected readonly url: string;
+  protected readonly group: string;
+  protected readonly workflowService: WorkflowService;
+  readonly getRegistry: _$alepha_server0.ActionPrimitiveFn<{
+    response: _$alepha.TArray<_$alepha.TObject<{
+      name: _$alepha.TString;
+      stepCount: _$alepha.TInteger;
+      steps: _$alepha.TArray<_$alepha.TObject<{
+        name: _$alepha.TString;
+        type: _$alepha.TUnsafe<"handler" | "signal" | "parallel">;
+        hasCompensate: _$alepha.TBoolean;
+        hasRetry: _$alepha.TBoolean;
+        timeout: _$alepha.TOptional<_$alepha.TString>;
+      }>>;
+      onError: _$alepha.TUnsafe<"compensate" | "fail">;
+      timeout: _$alepha.TOptional<_$alepha.TString>;
+      priority: _$alepha.TString;
+      tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+      paused: _$alepha.TBoolean;
+      running: _$alepha.TInteger;
+      pending: _$alepha.TInteger;
+      waiting: _$alepha.TInteger;
+      failed: _$alepha.TInteger;
+    }>>;
+  }>;
+  readonly getStats: _$alepha_server0.ActionPrimitiveFn<{
+    query: _$alepha.TObject<{
+      days: _$alepha.TOptional<_$alepha.TInteger>;
+    }>;
+    response: _$alepha.TObject<{
+      registered: _$alepha.TInteger;
+      running: _$alepha.TInteger;
+      pending: _$alepha.TInteger;
+      waiting: _$alepha.TInteger;
+      completed: _$alepha.TInteger;
+      failed: _$alepha.TInteger;
+      compensated: _$alepha.TInteger;
+      compensationFailed: _$alepha.TInteger;
+      cancelled: _$alepha.TInteger;
+      timedOut: _$alepha.TInteger;
+    }>;
+  }>;
+  readonly getActivity: _$alepha_server0.ActionPrimitiveFn<{
+    query: _$alepha.TObject<{
+      days: _$alepha.TOptional<_$alepha.TInteger>;
+    }>;
+    response: _$alepha.TArray<_$alepha.TObject<{
+      date: _$alepha.TString;
+      completed: _$alepha.TInteger;
+      failed: _$alepha.TInteger;
+    }>>;
+  }>;
+  readonly findExecutions: _$alepha_server0.ActionPrimitiveFn<{
+    query: _$alepha.TObject<{
+      page: _$alepha.TOptional<_$alepha.TInteger>;
+      size: _$alepha.TOptional<_$alepha.TInteger>;
+      sort: _$alepha.TOptional<_$alepha.TString>;
+      workflow: _$alepha.TOptional<_$alepha.TString>;
+      status: _$alepha.TOptional<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">>;
+      from: _$alepha.TOptional<_$alepha.TString>;
+      to: _$alepha.TOptional<_$alepha.TString>;
+    }>;
+    response: _$alepha.TPage<_$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      workflowName: _$alepha.TString;
+      tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      status: PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof PG_DEFAULT>;
+      currentStep: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      errorStep: _$alepha.TOptional<_$alepha.TString>;
+      triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+      triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+      cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+      cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+      key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+      priority: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+      can: _$alepha.TObject<{
+        retry: _$alepha.TBoolean;
+        cancel: _$alepha.TBoolean;
+        compensate: _$alepha.TBoolean;
+        restart: _$alepha.TBoolean;
+        signal: _$alepha.TOptional<_$alepha.TObject<{
+          stepName: _$alepha.TString;
+          schema: _$alepha.TOptional<_$alepha.TAny>;
+        }>>;
+      }>;
+    }>>;
+  }>;
+  readonly getExecution: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+      createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+      updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+      workflowName: _$alepha.TString;
+      tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      status: PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof PG_DEFAULT>;
+      currentStep: _$alepha.TOptional<_$alepha.TString>;
+      startedAt: _$alepha.TOptional<_$alepha.TString>;
+      completedAt: _$alepha.TOptional<_$alepha.TString>;
+      deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+      error: _$alepha.TOptional<_$alepha.TString>;
+      errorStep: _$alepha.TOptional<_$alepha.TString>;
+      triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+      triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+      cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+      cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+      key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+      priority: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+      can: _$alepha.TObject<{
+        retry: _$alepha.TBoolean;
+        cancel: _$alepha.TBoolean;
+        compensate: _$alepha.TBoolean;
+        restart: _$alepha.TBoolean;
+        signal: _$alepha.TOptional<_$alepha.TObject<{
+          stepName: _$alepha.TString;
+          schema: _$alepha.TOptional<_$alepha.TAny>;
+        }>>;
+      }>;
+      steps: _$alepha.TArray<_$alepha.TObject<{
+        id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+        createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+        updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+        workflowExecutionId: PgAttr<_$alepha.TString, typeof PG_REF>;
+        stepName: _$alepha.TString;
+        stepIndex: _$alepha.TInteger;
+        stepType: PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof PG_DEFAULT>;
+        parentStepId: _$alepha.TOptional<_$alepha.TString>;
+        branchName: _$alepha.TOptional<_$alepha.TString>;
+        status: PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof PG_DEFAULT>;
+        attempt: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+        maxAttempts: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+        result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+        error: _$alepha.TOptional<_$alepha.TString>;
+        startedAt: _$alepha.TOptional<_$alepha.TString>;
+        completedAt: _$alepha.TOptional<_$alepha.TString>;
+        deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+        signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+        signalledBy: _$alepha.TOptional<_$alepha.TString>;
+        signalledAt: _$alepha.TOptional<_$alepha.TString>;
+      }>>;
+    }>;
+  }>;
+  readonly startWorkflow: _$alepha_server0.ActionPrimitiveFn<{
+    body: _$alepha.TObject<{
+      name: _$alepha.TString;
+      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+      key: _$alepha.TOptional<_$alepha.TString>;
+      tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+    }>;
+    response: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+  }>;
+  readonly signalStep: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    body: _$alepha.TObject<{
+      stepName: _$alepha.TString;
+      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+    }>;
+    response: _$alepha.TObject<{
+      ok: _$alepha.TBoolean;
+      id: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TString, _$alepha.TInteger]>>;
+      count: _$alepha.TOptional<_$alepha.TNumber>;
+    }>;
+  }>;
+  readonly cancelExecution: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      ok: _$alepha.TBoolean;
+      id: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TString, _$alepha.TInteger]>>;
+      count: _$alepha.TOptional<_$alepha.TNumber>;
+    }>;
+  }>;
+  readonly retryExecution: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      ok: _$alepha.TBoolean;
+      id: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TString, _$alepha.TInteger]>>;
+      count: _$alepha.TOptional<_$alepha.TNumber>;
+    }>;
+  }>;
+  readonly restartExecution: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+  }>;
+  readonly compensateExecution: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      id: _$alepha.TString;
+    }>;
+    response: _$alepha.TObject<{
+      ok: _$alepha.TBoolean;
+      id: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TString, _$alepha.TInteger]>>;
+      count: _$alepha.TOptional<_$alepha.TNumber>;
+    }>;
+  }>;
+}
+//#endregion
+//#region ../../src/api/workflows/entities/workflowStepLogs.d.ts
+declare const workflowStepLogs: _$alepha_orm0.EntityPrimitive<_$alepha.TObject<{
+  id: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_PRIMARY_KEY>, typeof _$alepha_orm0.PG_DEFAULT>;
+  logs: _$alepha.TArray<_$alepha.TObject<{
+    level: _$alepha.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
+    message: _$alepha.TString;
+    service: _$alepha.TString;
+    module: _$alepha.TString;
+    context: _$alepha.TOptional<_$alepha.TString>;
+    app: _$alepha.TOptional<_$alepha.TString>;
+    data: _$alepha.TOptional<_$alepha.TAny>;
+    timestamp: _$alepha.TNumber;
+  }>>;
+}>>;
+type WorkflowStepLogEntity = Static<typeof workflowStepLogs.schema>;
+//#endregion
+//#region ../../src/api/workflows/schemas/workflowConfigAtom.d.ts
+declare const workflowConfig: _$alepha.Atom<_$alepha.TObject<{
+  defaultStepTimeout: _$alepha.TInteger;
+  retentionDays: _$alepha.TInteger;
+  recovery: _$alepha.TObject<{
+    staleThreshold: _$alepha.TInteger;
+  }>;
+  maxConcurrentWorkflows: _$alepha.TInteger;
+  maxStepsPerWorkflow: _$alepha.TInteger;
+  drainTimeout: _$alepha.TInteger;
+  logMaxEntries: _$alepha.TInteger;
+}>, "alepha.workflows">;
+type WorkflowConfig = Static<typeof workflowConfig.schema>;
+declare module "alepha" {
+  interface State {
+    [workflowConfig.key]: WorkflowConfig;
+  }
+} //# sourceMappingURL=workflowConfigAtom.d.ts.map
+//#endregion
+//#region ../../src/api/workflows/schemas/workflowExecutionDetailSchema.d.ts
+declare const workflowExecutionDetailSchema: _$alepha.TObject<{
+  id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+  createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+  workflowName: _$alepha.TString;
+  tags: _$alepha.TOptional<_$alepha.TArray<_$alepha.TString>>;
+  payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+  status: PgAttr<_$alepha.TUnsafe<"pending" | "running" | "waiting_for_signal" | "completed" | "failed" | "timed_out" | "compensating" | "compensated" | "compensation_failed" | "cancelled">, typeof PG_DEFAULT>;
+  currentStep: _$alepha.TOptional<_$alepha.TString>;
+  startedAt: _$alepha.TOptional<_$alepha.TString>;
+  completedAt: _$alepha.TOptional<_$alepha.TString>;
+  deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+  error: _$alepha.TOptional<_$alepha.TString>;
+  errorStep: _$alepha.TOptional<_$alepha.TString>;
+  triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+  triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+  cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+  cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+  key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
+  priority: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+  can: _$alepha.TObject<{
+    retry: _$alepha.TBoolean;
+    cancel: _$alepha.TBoolean;
+    compensate: _$alepha.TBoolean;
+    restart: _$alepha.TBoolean;
+    signal: _$alepha.TOptional<_$alepha.TObject<{
+      stepName: _$alepha.TString;
+      schema: _$alepha.TOptional<_$alepha.TAny>;
+    }>>;
+  }>;
+  steps: _$alepha.TArray<_$alepha.TObject<{
+    id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+    createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+    updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+    workflowExecutionId: PgAttr<_$alepha.TString, typeof PG_REF>;
+    stepName: _$alepha.TString;
+    stepIndex: _$alepha.TInteger;
+    stepType: PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof PG_DEFAULT>;
+    parentStepId: _$alepha.TOptional<_$alepha.TString>;
+    branchName: _$alepha.TOptional<_$alepha.TString>;
+    status: PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof PG_DEFAULT>;
+    attempt: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+    maxAttempts: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+    result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+    error: _$alepha.TOptional<_$alepha.TString>;
+    startedAt: _$alepha.TOptional<_$alepha.TString>;
+    completedAt: _$alepha.TOptional<_$alepha.TString>;
+    deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+    signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+    signalledBy: _$alepha.TOptional<_$alepha.TString>;
+    signalledAt: _$alepha.TOptional<_$alepha.TString>;
+  }>>;
+}>;
+type WorkflowExecutionDetail = Static<typeof workflowExecutionDetailSchema>;
+//#endregion
+//#region ../../src/api/workflows/schemas/workflowStepExecutionResourceSchema.d.ts
+declare const workflowStepExecutionResourceSchema: _$alepha.TObject<{
+  id: PgAttr<PgAttr<_$alepha.TString, typeof PG_PRIMARY_KEY>, typeof PG_DEFAULT>;
+  createdAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_CREATED_AT>, typeof PG_DEFAULT>;
+  updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
+  workflowExecutionId: PgAttr<_$alepha.TString, typeof PG_REF>;
+  stepName: _$alepha.TString;
+  stepIndex: _$alepha.TInteger;
+  stepType: PgAttr<_$alepha.TUnsafe<"handler" | "signal" | "parallel">, typeof PG_DEFAULT>;
+  parentStepId: _$alepha.TOptional<_$alepha.TString>;
+  branchName: _$alepha.TOptional<_$alepha.TString>;
+  status: PgAttr<_$alepha.TUnsafe<"pending" | "running" | "completed" | "failed" | "compensating" | "compensated" | "compensation_failed" | "cancelled" | "skipped" | "waiting">, typeof PG_DEFAULT>;
+  attempt: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+  maxAttempts: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+  result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+  error: _$alepha.TOptional<_$alepha.TString>;
+  startedAt: _$alepha.TOptional<_$alepha.TString>;
+  completedAt: _$alepha.TOptional<_$alepha.TString>;
+  deadlineAt: _$alepha.TOptional<_$alepha.TString>;
+  signalPayload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
+  signalledBy: _$alepha.TOptional<_$alepha.TString>;
+  signalledAt: _$alepha.TOptional<_$alepha.TString>;
+}>;
+type WorkflowStepExecutionResource = Static<typeof workflowStepExecutionResourceSchema>;
+//#endregion
+//#region ../../src/api/workflows/index.d.ts
+declare module "alepha" {
+  interface Hooks {
+    "workflow:started": {
+      workflowName: string;
+      workflowId: string;
+    };
+    "workflow:step:begin": {
+      workflowName: string;
+      workflowId: string;
+      stepName: string;
+    };
+    "workflow:step:completed": {
+      workflowName: string;
+      workflowId: string;
+      stepName: string;
+      result: unknown;
+    };
+    "workflow:step:failed": {
+      workflowName: string;
+      workflowId: string;
+      stepName: string;
+      error: Error;
+    };
+    "workflow:step:skipped": {
+      workflowName: string;
+      workflowId: string;
+      stepName: string;
+    };
+    "workflow:signal:received": {
+      workflowName: string;
+      workflowId: string;
+      stepName: string;
+      payload: unknown;
+    };
+    "workflow:signal:timeout": {
+      workflowName: string;
+      workflowId: string;
+      stepName: string;
+    };
+    "workflow:completed": {
+      workflowName: string;
+      workflowId: string;
+    };
+    "workflow:failed": {
+      workflowName: string;
+      workflowId: string;
+      error: Error;
+      stepName: string;
+    };
+    "workflow:compensating": {
+      workflowName: string;
+      workflowId: string;
+      stepName: string;
+    };
+    "workflow:compensated": {
+      workflowName: string;
+      workflowId: string;
+    };
+    "workflow:compensation:failed": {
+      workflowName: string;
+      workflowId: string;
+      stepName: string;
+      error: Error;
+    };
+    "workflow:cancelled": {
+      workflowName: string;
+      workflowId: string;
+    };
+    "workflow:timed_out": {
+      workflowName: string;
+      workflowId: string;
+    };
+  }
+}
+/**
+ * Durable workflow engine for long-running business processes.
+ *
+ * **Features:**
+ * - Declarative, multi-step workflows with typed payloads
+ * - Saga-pattern compensation for failure recovery
+ * - Per-step retry with exponential backoff
+ * - Workflow-level timeout and cancellation
+ * - Deduplication via unique keys
+ * - Per-execution log capture
+ *
+ * @module alepha.api.workflows
+ */
+declare const AlephaApiWorkflows: _$alepha.Service<_$alepha.Module>;
+//#endregion
+export { $workflow, AdminWorkflowController, AlephaApiWorkflows, CancelOptions, HandlerStep, StepCompensateArgs, StepConditionArgs, StepHandlerArgs, WorkflowActivityPoint, WorkflowActivityQuery, WorkflowConfig, WorkflowExecutionCan, WorkflowExecutionDetail, WorkflowExecutionEntity, WorkflowExecutionQuery, WorkflowExecutionResource, WorkflowPrimitive, WorkflowPrimitiveOptions, WorkflowPriority, WorkflowProvider, WorkflowRegistration, WorkflowRetryBackoff, WorkflowRetryOptions, WorkflowService, WorkflowStartOptions, WorkflowStats, WorkflowStatus, WorkflowStep, WorkflowStepExecutionEntity, WorkflowStepExecutionResource, WorkflowStepLogEntity, WorkflowStepStatus, workflowActivityPointSchema, workflowActivityQuerySchema, workflowConfig, workflowExecutionCanSchema, workflowExecutionDetailSchema, workflowExecutionQuerySchema, workflowExecutionResourceSchema, workflowExecutions, workflowRegistrationSchema, workflowStatsSchema, workflowStepExecutionResourceSchema, workflowStepExecutions, workflowStepLogs };
+//# sourceMappingURL=index.d.ts.map