alepha 0.20.1 → 0.20.3

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

@@ -1,16 +1,14 @@
 import * as _$alepha from "alepha";
 import { Alepha, AlephaError, Async, KIND, PipelinePrimitive, PipelinePrimitiveOptions, Static, TNull, TObject, TOptional, TSchema, TUnion } from "alepha";
-import { LockProvider } from "alepha/lock";
 import * as _$alepha_queue0 from "alepha/queue";
 import { CronProvider } from "alepha/scheduler";
 import * as _$alepha_server0 from "alepha/server";
 import * as _$alepha_logger0 from "alepha/logger";
+import { LogEntry } from "alepha/logger";
 import * as _$alepha_orm0 from "alepha/orm";
-import { DatabaseProvider } from "alepha/orm";
 import { DateTime, DateTimeProvider, DurationLike } from "alepha/datetime";
 import { BuildExtraConfigColumns, SQL } 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.
@@ -317,21 +315,23 @@ declare module "alepha" {
 //#endregion
 //#region ../../src/api/jobs/primitives/$job.d.ts
 /**
- * Job primitive for defining scheduled and on-demand tasks with payload validation and retry policies.
+ * Job primitive for defining scheduled (cron) or queued (push) tasks.
+ *
+ * A job must be either **cron-only** (pass `cron`) or **queue-only**
+ * (pass `schema`), never both. To run scheduled work that processes
+ * payloads, compose two jobs: a cron that pushes payloads, and a
+ * queue job that handles them.
  */
 declare const $job: {
   <T extends TSchema = TSchema>(options: JobPrimitiveOptions<T>): JobPrimitive<T>;
   [KIND]: typeof JobPrimitive;
 };
-interface JobItem<T extends TSchema = TSchema> {
-  id: string;
+interface JobHandlerArgs<T extends TSchema = TSchema> {
   payload: Static<T>;
   attempt: number;
-}
-interface JobHandlerArgs<T extends TSchema = TSchema> {
-  items: Array<JobItem<T>>;
   now: DateTime;
   signal: AbortSignal;
+  executionId: string;
 }
 interface JobRetryBackoff {
   initial: DurationLike;
@@ -347,38 +347,66 @@ interface JobRetryOptions {
 type JobPriority = "critical" | "high" | "normal" | "low";
 interface JobPrimitiveOptions<T extends TSchema = TSchema> extends PipelinePrimitiveOptions {
   /**
-   * Payload schema (TypeBox). Optional for cron-only jobs.
+   * Optional explicit job name. Defaults to `ClassName.propertyKey`.
+   * Recommended convention for framework-internal jobs: `api:module:jobName`.
    */
-  schema?: T;
+  name?: string;
   /**
-   * Cron expression for automatic scheduling.
+   * Human-readable description (shown in the admin UI).
    */
-  cron?: string;
+  description?: string;
   /**
-   * Whether to use a distributed lock for cron execution.
-   * @default true
+   * Payload schema (TypeBox). When set, the job is queue-mode.
+   * Must not be combined with `cron`.
    */
-  lock?: boolean;
+  schema?: T;
   /**
-   * Retry policy for failed executions.
+   * Cron expression for recurring execution. When set, the job is cron-mode.
+   * Must not be combined with `schema`.
    */
-  retry?: JobRetryOptions;
+  cron?: string;
   /**
-   * Max execution time per attempt.
+   * Retry policy for queue-mode jobs.
+   * Cron-mode jobs do not retry — the next tick re-runs.
    */
-  timeout?: DurationLike;
+  retry?: JobRetryOptions;
   /**
-   * Max parallel executions.
-   * @default 1
+   * Max execution time per attempt. Handler receives an `AbortSignal`.
    */
-  concurrency?: number;
+  timeout?: DurationLike;
   /**
-   * Default priority for pushed jobs.
+   * Default priority for pushed jobs. Used by the sweep to order
+   * dispatch when there is a backlog. Real-time queue consumption
+   * is FIFO.
    * @default "normal"
    */
   priority?: JobPriority;
   /**
-   * Handler function for job execution.
+   * Whether to record successful executions.
+   *
+   * - `"error"` (default for cron, default for queue): only error/cancelled rows kept
+   * - `"all"`: keep success rows too (bounded by `keepLastSuccess`)
+   * - `"none"`: fire-and-forget, no row even on error
+   *
+   * Note: queue-mode jobs always write a `pending` row at push time (outbox).
+   * This setting controls whether that row is kept on success.
+   */
+  record?: "error" | "all" | "none";
+  /**
+   * Override the global ring-buffer trim for this job.
+   *
+   * - `{ ok: 0, error: 0 }` — **keep forever** (no sweep trim). Useful for
+   *   audit-heavy jobs where retention is time-based (handled by a separate
+   *   cron) rather than count-based.
+   * - `{ ok: 50 }` — keep last 50 successes; fall back to global default for errors.
+   * - omitted — use global `keepLastSuccess` / `keepLastError` from `jobConfig`.
+   */
+  keep?: {
+    ok?: number;
+    error?: number;
+  };
+  /**
+   * Handler function. For cron-mode, `payload` is `undefined`.
    */
   handler: (args: JobHandlerArgs<T>) => Async<void>;
 }
@@ -387,41 +415,34 @@ declare class JobPrimitive<T extends TSchema = TSchema> extends PipelinePrimitiv
   get name(): string;
   protected onInit(): void;
   /**
-   * Push a single payload or an array of payloads.
+   * Push a single payload to the queue (queue-mode only).
    */
-  push(payload: Static<T> | Array<Static<T>>, options?: PushOptions): Promise<string | string[]>;
+  push(payload: Static<T>, options?: PushOptions): Promise<string>;
   /**
-   * Push multiple payloads with per-item options.
+   * Push multiple payloads at once (queue-mode only).
+   * Batched INSERT + batched queue send when supported.
    */
   pushMany(items: Array<PushManyItem<T>>): Promise<string[]>;
   /**
-   * Cancel a running or pending execution.
+   * Cancel a pending or running execution.
    */
   cancel(executionId: string): Promise<void>;
   /**
-   * Manually trigger the job (admin / CLI).
+   * Manually fire a cron-mode job, or trigger a queue-mode job with an explicit payload.
    */
-  trigger(context?: JobTriggerContext): Promise<void>;
-  /**
-   * Pause this job. Pushed items are still accepted but processing is held.
-   */
-  pause(): void;
-  /**
-   * Resume a paused job and dispatch any pending items.
-   */
-  resume(): Promise<void>;
-  /**
-   * Whether this job is currently paused.
-   */
-  get paused(): boolean;
+  trigger(context?: JobTriggerContext<T>): Promise<void>;
 }
 //#endregion
 //#region ../../src/api/jobs/providers/JobProvider.d.ts
+declare const PRIORITY_MAP: Record<JobPriority, number>;
+declare const PRIORITY_REVERSE: Record<number, JobPriority>;
 interface PushOptions {
   delay?: DurationLike;
   key?: string;
   priority?: JobPriority;
   scheduledAt?: Date;
+  triggeredBy?: string;
+  triggeredByName?: string;
 }
 interface PushManyItem<T extends TSchema = TSchema> {
   payload: Static<T>;
@@ -430,8 +451,8 @@ interface PushManyItem<T extends TSchema = TSchema> {
   priority?: JobPriority;
   scheduledAt?: Date;
 }
-interface JobTriggerContext {
-  payload?: Record<string, unknown>;
+interface JobTriggerContext<T extends TSchema = TSchema> {
+  payload?: Static<T>;
   triggeredBy?: string;
   triggeredByName?: string;
 }
@@ -439,25 +460,38 @@ interface CancelContext {
   cancelledBy?: string;
   cancelledByName?: string;
 }
-interface JobRegistration$1 {
+interface JobRuntimeRegistration {
   name: string;
   options: JobPrimitiveOptions;
+  type: "cron" | "queue";
 }
+/**
+ * Coordinates cron (scheduler) and queue (push) jobs with a durable outbox
+ * table and a single reconciliation sweep.
+ *
+ * Queue-mode flow:
+ *   push()  → INSERT row (pending) + queue.send({ executionId })
+ *   worker  → SELECT row → UPDATE running → handler → DELETE (ok) / UPDATE (error)
+ *
+ * Cron-mode flow:
+ *   scheduler tick → handler runs inline → INSERT row only on error
+ *
+ * Sweep responsibilities (every `sweepInterval`):
+ *   - re-enqueue pending rows older than `staleThreshold`
+ *   - fail running rows older than `max(timeout*2, runTimeout)`
+ *   - move `scheduled` rows with `scheduledAt <= now` to pending + enqueue
+ *   - trim per-job history beyond `keepLastSuccess` / `keepLastError`
+ */
 declare class JobProvider {
   protected readonly alepha: Alepha;
   protected readonly dt: DateTimeProvider;
   protected readonly cronProvider: CronProvider;
-  protected readonly lockProvider: LockProvider;
   protected readonly config: Readonly<{
-    recovery: {
-      interval: number;
-      staleThreshold: number;
-      runTimeout: number;
-    };
-    delayed: {
-      interval: number;
-    };
-    logRetentionDays: number;
+    sweepInterval: number;
+    staleThreshold: number;
+    runTimeout: number;
+    keepLastSuccess: number;
+    keepLastError: number;
     logMaxEntries: number;
     drainTimeout: number;
   }>;
@@ -468,26 +502,17 @@ declare class JobProvider {
     updatedAt: _$alepha_orm0.PgAttr<_$alepha_orm0.PgAttr<_$alepha.TString, typeof _$alepha_orm0.PG_UPDATED_AT>, typeof _$alepha_orm0.PG_DEFAULT>;
     jobName: _$alepha.TString;
     key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-    payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-    status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
+    status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"ok" | "error" | "pending" | "running" | "scheduled" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
     priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, 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>;
+    payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
     scheduledAt: _$alepha.TOptional<_$alepha.TString>;
     startedAt: _$alepha.TOptional<_$alepha.TString>;
     completedAt: _$alepha.TOptional<_$alepha.TString>;
-    result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
     error: _$alepha.TOptional<_$alepha.TString>;
-    workerId: _$alepha.TOptional<_$alepha.TString>;
-    triggeredBy: _$alepha.TOptional<_$alepha.TString>;
-    triggeredByName: _$alepha.TOptional<_$alepha.TString>;
-    cancelledBy: _$alepha.TOptional<_$alepha.TString>;
-    cancelledByName: _$alepha.TOptional<_$alepha.TString>;
-  }>>;
-  protected readonly executionLogs: _$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<"TRACE" | "SILENT" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
+    logs: _$alepha.TOptional<_$alepha.TArray<_$alepha.TObject<{
+      level: _$alepha.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
       message: _$alepha.TString;
       service: _$alepha.TString;
       module: _$alepha.TString;
@@ -495,214 +520,143 @@ declare class JobProvider {
       app: _$alepha.TOptional<_$alepha.TString>;
       data: _$alepha.TOptional<_$alepha.TAny>;
       timestamp: _$alepha.TNumber;
-    }>>;
+    }>>>;
+    triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+    triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+    cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+    cancelledByName: _$alepha.TOptional<_$alepha.TString>;
   }>>;
-  protected readonly jobs: Map<string, JobRegistration$1>;
-  protected readonly pausedJobs: Set<string>;
+  protected readonly jobs: Map<string, JobRuntimeRegistration>;
   protected readonly inFlight: Set<Promise<void>>;
-  /**
-   * When set, job executions are dispatched through a queue (e.g. `JobQueueProvider`).
-   * When null, jobs execute inline (fire-and-forget). Useful for serverless environments.
-   */
-  queueDispatch: ((jobName: string, executionId: string) => Promise<void>) | null;
-  protected readonly logs: Map<string, {
+  protected readonly abortControllers: Map<string, AbortController>;
+  protected readonly perExecutionLogs: Map<string, {
     context?: string | undefined;
     app?: string | undefined;
     data?: any;
-    level: "TRACE" | "SILENT" | "DEBUG" | "INFO" | "WARN" | "ERROR";
+    level: "SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR";
     message: string;
     service: string;
     module: string;
     timestamp: number;
   }[]>;
-  protected readonly abortControllers: Map<string, AbortController>;
-  protected static readonly SWEEP_CRON = "*/5 * * * *";
   protected stopping: boolean;
-  protected workerId: string;
+  /**
+   * Set by `JobQueueProvider` when `AlephaApiJobsQueue` is loaded.
+   * When null, queue-mode jobs cannot be pushed.
+   */
+  queueDispatch: ((jobName: string, executionId: string) => Promise<void>) | null;
   registerJob(name: string, options: JobPrimitiveOptions): void;
+  getRegisteredJobs(): Map<string, JobRuntimeRegistration>;
+  protected runCron(name: string): Promise<void>;
   /**
-   * Get all registered job definitions.
+   * Execute a cron handler inline. Records a row only on error (or always,
+   * when `record: 'all'`). No DB writes on the happy path by default.
    */
-  getRegisteredJobs(): Map<string, JobRegistration$1>;
+  protected executeInline(registration: JobRuntimeRegistration, executionId: string, ctx: {
+    payload: unknown;
+    attempt: number;
+    triggeredBy?: string;
+    triggeredByName?: string;
+  }): Promise<void>;
+  protected writeTerminalRow(executionId: string, jobName: string, status: "ok" | "error", fields: {
+    payload: unknown;
+    attempt: number;
+    startedAt: ReturnType<DateTimeProvider["now"]>;
+    error?: Error;
+    context: string;
+    triggeredBy?: string;
+    triggeredByName?: string;
+  }): Promise<void>;
   push(name: string, payload: unknown, options?: PushOptions): Promise<string>;
+  /**
+   * Fire a local setTimeout so delayed/retrying rows dispatch as close to
+   * `scheduledAt` as possible, rather than waiting for the next sweep tick.
+   * No-op on stateless runtimes where timers won't survive (the sweep
+   * handles those).
+   */
+  protected scheduleOptimisticDispatch(jobName: string, executionId: string, scheduledAt: string): void;
   pushMany(name: string, items: Array<PushManyItem>): Promise<string[]>;
+  protected dispatchToQueue(jobName: string, executionId: string): Promise<void>;
   trigger(name: string, context?: JobTriggerContext): Promise<void>;
   cancel(executionId: string, context?: CancelContext): Promise<void>;
-  protected scheduleProcessing(jobName: string, executionId: string): Promise<void>;
   processExecution(jobName: string, executionId: string): Promise<void>;
-  protected processExecutionInner(jobName: string, executionId: string): Promise<void>;
-  /**
-   * After a job finishes (success, failure, or cancel), dispatch any pending
-   * jobs that were deferred due to the concurrency limit.
-   */
-  protected dispatchNextPending(jobName: string): Promise<void>;
+  protected processQueueExecution(registration: JobRuntimeRegistration, executionId: string): Promise<void>;
   protected claim(executionId: string): Promise<boolean>;
-  protected handleFailure(executionId: string, jobName: string, error: Error, context: string): Promise<void>;
-  protected computeBackoff(retryOpts: JobRetryOptions, attempt: number): string;
-  protected writeLogs(executionId: string, context: string): Promise<void>;
-  protected dispatchRetrying(jobName: string, executionId: string): Promise<void>;
+  protected handleFailure(executionId: string, registration: JobRuntimeRegistration, currentAttempt: number, error: Error, contextId: string): Promise<void>;
+  protected computeBackoff(retry: JobRetryOptions, attempt: number): string;
+  protected snapshotLogs(contextId: string): LogEntry[] | undefined;
+  protected sweep(): Promise<void>;
+  protected dispatchToQueueSafe(jobName: string, executionId: string): Promise<void>;
   /**
-   * Recovery Sweep (Section 5.1)
-   *
-   * Runs every `recovery.interval` (default: 1 minute).
-   * - Stale `pending` jobs older than `staleThreshold` → re-dispatch.
-   * - Crashed `running` jobs older than `max(job.timeout * 2, recovery.runTimeout)` → mark failed, apply retry policy.
-   */
-  protected recoverySweep(): Promise<void>;
-  /**
-   * Delayed Dispatch Sweep (Section 5.2)
-   *
-   * Runs every `delayed.interval` (default: 30 seconds).
-   * Scans for `scheduled` and `retrying` jobs where `scheduledAt <= now`,
-   * moves them to `pending`, and dispatches to the queue layer.
-   */
-  protected delayedDispatchSweep(): Promise<void>;
-  /**
-   * Log Purge (Section 5.3)
-   *
-   * Runs daily at 03:00 via cron.
-   * Deletes completed/dead/cancelled execution records older than `logRetentionDays`.
+   * Move a row from `scheduled` → `pending` and dispatch it.
+   * Used by the optimistic retry/delay timer. If the sweep has already moved
+   * the row, or another worker has claimed it, the UPDATE guard fails silently.
    */
-  protected logPurge(): Promise<void>;
-  pauseJob(name: string): void;
-  resumeJob(name: string): Promise<void>;
-  isJobPaused(name: string): boolean;
-  getPausedJobs(): string[];
-  protected tryLock(key: string, ttlMs: number): Promise<boolean>;
-  protected releaseLock(key: string): Promise<void>;
+  protected dispatchScheduled(jobName: string, executionId: string): Promise<void>;
+  protected trimRingBuffers(): Promise<void>;
+  protected trimByStatus(jobName: string, status: "ok" | "error", keep: number): Promise<void>;
   protected readonly onStart: _$alepha.HookPrimitive<"start">;
   protected readonly onStop: _$alepha.HookPrimitive<"stop">;
-  protected getRegistration(name: string): JobRegistration$1;
+  protected getRegistration(name: string): JobRuntimeRegistration;
 }
 //#endregion
-//#region ../../src/api/jobs/schemas/jobActivitySchema.d.ts
-declare const jobActivityPointSchema: _$alepha.TObject<{
-  date: _$alepha.TString;
-  completed: _$alepha.TInteger;
-  failed: _$alepha.TInteger;
-}>;
-type JobActivityPoint = Static<typeof jobActivityPointSchema>;
-declare const jobActivityQuerySchema: _$alepha.TObject<{
-  days: _$alepha.TOptional<_$alepha.TInteger>;
-}>;
-type JobActivityQuery = Static<typeof jobActivityQuerySchema>;
-//#endregion
-//#region ../../src/api/jobs/schemas/jobCronInfoSchema.d.ts
-declare const jobCronInfoSchema: _$alepha.TObject<{
-  name: _$alepha.TString;
-  cron: _$alepha.TString;
-  lock: _$alepha.TBoolean;
-  priority: _$alepha.TUnsafe<"critical" | "high" | "normal" | "low">;
-  concurrency: _$alepha.TInteger;
-  hasSchema: _$alepha.TBoolean;
-  paused: _$alepha.TBoolean;
-  lastExecution: _$alepha.TOptional<_$alepha.TObject<{
-    id: _$alepha.TString;
-    status: _$alepha.TString;
-    startedAt: _$alepha.TOptional<_$alepha.TString>;
-    completedAt: _$alepha.TOptional<_$alepha.TString>;
-    error: _$alepha.TOptional<_$alepha.TString>;
-  }>>;
-}>;
-type JobCronInfo = Static<typeof jobCronInfoSchema>;
-//#endregion
 //#region ../../src/api/jobs/schemas/jobExecutionQuerySchema.d.ts
 declare const jobExecutionQuerySchema: _$alepha.TObject<{
-  page: _$alepha.TOptional<_$alepha.TInteger>;
-  size: _$alepha.TOptional<_$alepha.TInteger>;
-  sort: _$alepha.TOptional<_$alepha.TString>;
-  job: _$alepha.TOptional<_$alepha.TString>;
-  status: _$alepha.TOptional<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">>;
-  priority: _$alepha.TOptional<_$alepha.TUnsafe<"critical" | "high" | "normal" | "low">>;
-  from: _$alepha.TOptional<_$alepha.TString>;
-  to: _$alepha.TOptional<_$alepha.TString>;
+  status: _$alepha.TOptional<_$alepha.TUnsafe<"ok" | "error" | "pending" | "running" | "scheduled" | "cancelled">>;
+  limit: _$alepha.TOptional<_$alepha.TInteger>;
 }>;
 type JobExecutionQuery = Static<typeof jobExecutionQuerySchema>;
 //#endregion
-//#region ../../src/api/jobs/schemas/jobFailureSchema.d.ts
-declare const jobFailureSchema: _$alepha.TObject<{
-  jobName: _$alepha.TString;
-  failures: _$alepha.TInteger;
-  lastError: _$alepha.TOptional<_$alepha.TString>;
-}>;
-type JobFailure = Static<typeof jobFailureSchema>;
-//#endregion
-//#region ../../src/api/jobs/schemas/jobQueueDepthSchema.d.ts
-declare const jobQueueDepthSchema: _$alepha.TObject<{
-  jobName: _$alepha.TString;
-  pending: _$alepha.TInteger;
-  running: _$alepha.TInteger;
-  scheduled: _$alepha.TInteger;
-  retrying: _$alepha.TInteger;
-  dead: _$alepha.TInteger;
-  concurrency: _$alepha.TInteger;
-  paused: _$alepha.TBoolean;
-}>;
-type JobQueueDepth = Static<typeof jobQueueDepthSchema>;
-//#endregion
 //#region ../../src/api/jobs/schemas/jobRegistrationSchema.d.ts
 declare const jobRegistrationSchema: _$alepha.TObject<{
   name: _$alepha.TString;
-  type: _$alepha.TUnsafe<"push" | "cron" | "both">;
+  description: _$alepha.TOptional<_$alepha.TString>;
+  type: _$alepha.TUnsafe<"cron" | "queue">;
   priority: _$alepha.TUnsafe<"critical" | "high" | "normal" | "low">;
-  concurrency: _$alepha.TInteger;
-  hasSchema: _$alepha.TBoolean;
   cron: _$alepha.TOptional<_$alepha.TString>;
   timeout: _$alepha.TOptional<_$alepha.TString>;
   retry: _$alepha.TOptional<_$alepha.TObject<{
     retries: _$alepha.TInteger;
     hasBackoff: _$alepha.TBoolean;
   }>>;
-  paused: _$alepha.TBoolean;
+  recent: _$alepha.TObject<{
+    ok: _$alepha.TInteger;
+    error: _$alepha.TInteger;
+    lastRun: _$alepha.TOptional<_$alepha.TString>;
+  }>;
 }>;
 type JobRegistration = Static<typeof jobRegistrationSchema>;
 //#endregion
-//#region ../../src/api/jobs/schemas/jobStatsSchema.d.ts
-declare const jobStatsSchema: _$alepha.TObject<{
-  registered: _$alepha.TInteger;
-  running: _$alepha.TInteger;
-  pending: _$alepha.TInteger;
-  scheduled: _$alepha.TInteger;
-  retrying: _$alepha.TInteger;
-  dead: _$alepha.TInteger;
-  completed: _$alepha.TInteger;
-  failed: _$alepha.TInteger;
-}>;
-type JobStats = Static<typeof jobStatsSchema>;
-//#endregion
 //#region ../../src/api/jobs/services/JobService.d.ts
+/**
+ * Admin surface for the job system.
+ *
+ * Six methods: list jobs, list executions, get execution,
+ * trigger, retry, cancel. Everything else lives in events — any
+ * analytics/observability is an external concern that subscribes
+ * to `job:begin` / `job:success` / `job:error`.
+ */
 declare class JobService {
   protected readonly alepha: Alepha;
-  protected readonly dt: DateTimeProvider;
   protected readonly log: _$alepha_logger0.Logger;
   protected readonly jobProvider: JobProvider;
-  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>;
     jobName: _$alepha.TString;
     key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-    payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-    status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
+    status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"ok" | "error" | "pending" | "running" | "scheduled" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
     priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, 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>;
+    payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
     scheduledAt: _$alepha.TOptional<_$alepha.TString>;
     startedAt: _$alepha.TOptional<_$alepha.TString>;
     completedAt: _$alepha.TOptional<_$alepha.TString>;
-    result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
     error: _$alepha.TOptional<_$alepha.TString>;
-    workerId: _$alepha.TOptional<_$alepha.TString>;
-    triggeredBy: _$alepha.TOptional<_$alepha.TString>;
-    triggeredByName: _$alepha.TOptional<_$alepha.TString>;
-    cancelledBy: _$alepha.TOptional<_$alepha.TString>;
-    cancelledByName: _$alepha.TOptional<_$alepha.TString>;
-  }>>;
-  protected readonly executionLogs: _$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<"TRACE" | "SILENT" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
+    logs: _$alepha.TOptional<_$alepha.TArray<_$alepha.TObject<{
+      level: _$alepha.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
       message: _$alepha.TString;
       service: _$alepha.TString;
       module: _$alepha.TString;
@@ -710,164 +664,88 @@ declare class JobService {
       app: _$alepha.TOptional<_$alepha.TString>;
       data: _$alepha.TOptional<_$alepha.TAny>;
       timestamp: _$alepha.TNumber;
-    }>>;
+    }>>>;
+    triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+    triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+    cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+    cancelledByName: _$alepha.TOptional<_$alepha.TString>;
   }>>;
   protected computeCan(status: string): {
     retry: boolean;
     cancel: boolean;
   };
   /**
-   * 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)
+   * List every registered job with recent ok/error counts and lastRun.
+   * One aggregate query covers all jobs.
    */
-  protected toRawDate(iso: string): string | number;
-  getStats(days?: number): Promise<JobStats>;
-  getRegistry(): JobRegistration[];
-  findExecutions(query?: JobExecutionQuery): Promise<{
-    content: {
-      can: {
-        retry: boolean;
-        cancel: boolean;
-      };
-      key?: string | null | 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>;
-        jobName: _$alepha.TString;
-        key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-        payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-        status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
-        priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, 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>;
-        scheduledAt: _$alepha.TOptional<_$alepha.TString>;
-        startedAt: _$alepha.TOptional<_$alepha.TString>;
-        completedAt: _$alepha.TOptional<_$alepha.TString>;
-        result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-        error: _$alepha.TOptional<_$alepha.TString>;
-        workerId: _$alepha.TOptional<_$alepha.TString>;
-        triggeredBy: _$alepha.TOptional<_$alepha.TString>;
-        triggeredByName: _$alepha.TOptional<_$alepha.TString>;
-        cancelledBy: _$alepha.TOptional<_$alepha.TString>;
-        cancelledByName: _$alepha.TOptional<_$alepha.TString>;
-      }, "^.*$", _$alepha.TAny> | undefined;
-      scheduledAt?: string | undefined;
-      startedAt?: string | undefined;
-      completedAt?: string | undefined;
-      result?: _$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>;
-        jobName: _$alepha.TString;
-        key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-        payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-        status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
-        priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, 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>;
-        scheduledAt: _$alepha.TOptional<_$alepha.TString>;
-        startedAt: _$alepha.TOptional<_$alepha.TString>;
-        completedAt: _$alepha.TOptional<_$alepha.TString>;
-        result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-        error: _$alepha.TOptional<_$alepha.TString>;
-        workerId: _$alepha.TOptional<_$alepha.TString>;
-        triggeredBy: _$alepha.TOptional<_$alepha.TString>;
-        triggeredByName: _$alepha.TOptional<_$alepha.TString>;
-        cancelledBy: _$alepha.TOptional<_$alepha.TString>;
-        cancelledByName: _$alepha.TOptional<_$alepha.TString>;
-      }, "^.*$", _$alepha.TAny> | undefined;
-      error?: string | undefined;
-      workerId?: string | undefined;
-      triggeredBy?: string | undefined;
-      triggeredByName?: string | undefined;
-      cancelledBy?: string | undefined;
-      cancelledByName?: string | undefined;
-      priority: number;
-      status: "running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled";
-      id: string;
-      createdAt: string;
-      updatedAt: string;
-      jobName: string;
-      attempt: number;
-      maxAttempts: number;
-    }[];
-    page: _$alepha.StaticDecode<typeof _$alepha.pageMetadataSchema>;
-  }>;
-  getExecution(id: string): Promise<{
+  listJobs(): Promise<JobRegistration[]>;
+  /**
+   * Recent executions for a single job, ORDER BY startedAt DESC.
+   */
+  getExecutions(jobName: string, query?: JobExecutionQuery): Promise<{
     can: {
       retry: boolean;
       cancel: boolean;
     };
-    logs: {
+    error?: string | undefined;
+    key?: string | null | undefined;
+    payload?: Record<string, any> | undefined;
+    scheduledAt?: string | undefined;
+    startedAt?: string | undefined;
+    completedAt?: string | undefined;
+    logs?: {
       context?: string | undefined;
       app?: string | undefined;
       data?: any;
-      level: "TRACE" | "SILENT" | "DEBUG" | "INFO" | "WARN" | "ERROR";
+      level: "SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR";
       message: string;
       service: string;
       module: string;
       timestamp: number;
     }[] | undefined;
+    triggeredBy?: string | undefined;
+    triggeredByName?: string | undefined;
+    cancelledBy?: string | undefined;
+    cancelledByName?: string | undefined;
+    priority: number;
+    status: "ok" | "error" | "pending" | "running" | "scheduled" | "cancelled";
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+    jobName: string;
+    attempt: number;
+    maxAttempts: number;
+  }[]>;
+  /**
+   * Full execution detail (includes captured logs).
+   */
+  getExecution(id: string): Promise<{
+    can: {
+      retry: boolean;
+      cancel: boolean;
+    };
+    error?: string | undefined;
     key?: string | null | 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>;
-      jobName: _$alepha.TString;
-      key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-      status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
-      priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, 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>;
-      scheduledAt: _$alepha.TOptional<_$alepha.TString>;
-      startedAt: _$alepha.TOptional<_$alepha.TString>;
-      completedAt: _$alepha.TOptional<_$alepha.TString>;
-      result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-      error: _$alepha.TOptional<_$alepha.TString>;
-      workerId: _$alepha.TOptional<_$alepha.TString>;
-      triggeredBy: _$alepha.TOptional<_$alepha.TString>;
-      triggeredByName: _$alepha.TOptional<_$alepha.TString>;
-      cancelledBy: _$alepha.TOptional<_$alepha.TString>;
-      cancelledByName: _$alepha.TOptional<_$alepha.TString>;
-    }, "^.*$", _$alepha.TAny> | undefined;
+    payload?: Record<string, any> | undefined;
     scheduledAt?: string | undefined;
     startedAt?: string | undefined;
     completedAt?: string | undefined;
-    result?: _$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>;
-      jobName: _$alepha.TString;
-      key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-      status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
-      priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, 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>;
-      scheduledAt: _$alepha.TOptional<_$alepha.TString>;
-      startedAt: _$alepha.TOptional<_$alepha.TString>;
-      completedAt: _$alepha.TOptional<_$alepha.TString>;
-      result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-      error: _$alepha.TOptional<_$alepha.TString>;
-      workerId: _$alepha.TOptional<_$alepha.TString>;
-      triggeredBy: _$alepha.TOptional<_$alepha.TString>;
-      triggeredByName: _$alepha.TOptional<_$alepha.TString>;
-      cancelledBy: _$alepha.TOptional<_$alepha.TString>;
-      cancelledByName: _$alepha.TOptional<_$alepha.TString>;
-    }, "^.*$", _$alepha.TAny> | undefined;
-    error?: string | undefined;
-    workerId?: string | undefined;
+    logs?: {
+      context?: string | undefined;
+      app?: string | undefined;
+      data?: any;
+      level: "SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR";
+      message: string;
+      service: string;
+      module: string;
+      timestamp: number;
+    }[] | undefined;
     triggeredBy?: string | undefined;
     triggeredByName?: string | undefined;
     cancelledBy?: string | undefined;
     cancelledByName?: string | undefined;
     priority: number;
-    status: "running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled";
+    status: "ok" | "error" | "pending" | "running" | "scheduled" | "cancelled";
     id: string;
     createdAt: string;
     updatedAt: string;
@@ -875,9 +753,15 @@ declare class JobService {
     attempt: number;
     maxAttempts: number;
   }>;
+  /**
+   * Manual trigger (cron jobs) or push-with-payload (queue jobs).
+   */
   triggerJob(name: string, context?: JobTriggerContext): Promise<{
     ok: boolean;
   }>;
+  /**
+   * Retry a dead or cancelled execution by re-pushing with the original payload.
+   */
   retryExecution(id: string, context?: {
     triggeredBy?: string;
     triggeredByName?: string;
@@ -890,105 +774,68 @@ declare class JobService {
   }): Promise<{
     ok: boolean;
   }>;
-  pauseJob(name: string, context?: {
-    pausedBy?: string;
-    pausedByName?: string;
-  }): {
-    ok: boolean;
-  };
-  resumeJob(name: string, context?: {
-    resumedBy?: string;
-    resumedByName?: string;
-  }): Promise<{
-    ok: boolean;
-  }>;
-  getPausedJobs(): string[];
-  getCronJobs(): Promise<JobCronInfo[]>;
-  getQueueDepth(): Promise<JobQueueDepth[]>;
-  getActivity(days?: number): Promise<JobActivityPoint[]>;
-  protected getActivitySqlite(days?: number): Promise<JobActivityPoint[]>;
-  getTopFailures(days?: number): Promise<JobFailure[]>;
-  protected getTopFailuresSqlite(periodAgoIso: string): Promise<JobFailure[]>;
-  /**
-   * Fetch the most recent execution per job name.
-   *
-   * - PostgreSQL: uses `DISTINCT ON` for a single-pass query
-   * - SQLite: uses ORM queries (one per job name) since `DISTINCT ON` is not supported
-   */
-  protected getLastExecutionPerJob(jobNames: string[]): Promise<Map<string, {
-    id: string;
-    job_name: string;
-    status: string;
-    started_at?: string | null;
-    completed_at?: string | null;
-    error?: string | null;
-  }>>;
 }
 //#endregion
 //#region ../../src/api/jobs/controllers/AdminJobController.d.ts
+/**
+ * Minimal admin surface for the job system. Six endpoints.
+ */
 declare class AdminJobController {
   protected readonly url: string;
   protected readonly group: string;
   protected readonly jobService: JobService;
-  readonly getJobStats: _$alepha_server0.ActionPrimitiveFn<{
-    query: _$alepha.TObject<{
-      days: _$alepha.TOptional<_$alepha.TInteger>;
-    }>;
-    response: _$alepha.TObject<{
-      registered: _$alepha.TInteger;
-      running: _$alepha.TInteger;
-      pending: _$alepha.TInteger;
-      scheduled: _$alepha.TInteger;
-      retrying: _$alepha.TInteger;
-      dead: _$alepha.TInteger;
-      completed: _$alepha.TInteger;
-      failed: _$alepha.TInteger;
-    }>;
-  }>;
-  readonly getJobRegistry: _$alepha_server0.ActionPrimitiveFn<{
+  readonly listJobs: _$alepha_server0.ActionPrimitiveFn<{
     response: _$alepha.TArray<_$alepha.TObject<{
       name: _$alepha.TString;
-      type: _$alepha.TUnsafe<"push" | "cron" | "both">;
+      description: _$alepha.TOptional<_$alepha.TString>;
+      type: _$alepha.TUnsafe<"cron" | "queue">;
       priority: _$alepha.TUnsafe<"critical" | "high" | "normal" | "low">;
-      concurrency: _$alepha.TInteger;
-      hasSchema: _$alepha.TBoolean;
       cron: _$alepha.TOptional<_$alepha.TString>;
       timeout: _$alepha.TOptional<_$alepha.TString>;
       retry: _$alepha.TOptional<_$alepha.TObject<{
         retries: _$alepha.TInteger;
         hasBackoff: _$alepha.TBoolean;
       }>>;
-      paused: _$alepha.TBoolean;
+      recent: _$alepha.TObject<{
+        ok: _$alepha.TInteger;
+        error: _$alepha.TInteger;
+        lastRun: _$alepha.TOptional<_$alepha.TString>;
+      }>;
     }>>;
   }>;
-  readonly findJobExecutions: _$alepha_server0.ActionPrimitiveFn<{
+  readonly listExecutions: _$alepha_server0.ActionPrimitiveFn<{
+    params: _$alepha.TObject<{
+      name: _$alepha.TString;
+    }>;
     query: _$alepha.TObject<{
-      page: _$alepha.TOptional<_$alepha.TInteger>;
-      size: _$alepha.TOptional<_$alepha.TInteger>;
-      sort: _$alepha.TOptional<_$alepha.TString>;
-      job: _$alepha.TOptional<_$alepha.TString>;
-      status: _$alepha.TOptional<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">>;
-      priority: _$alepha.TOptional<_$alepha.TUnsafe<"critical" | "high" | "normal" | "low">>;
-      from: _$alepha.TOptional<_$alepha.TString>;
-      to: _$alepha.TOptional<_$alepha.TString>;
+      status: _$alepha.TOptional<_$alepha.TUnsafe<"ok" | "error" | "pending" | "running" | "scheduled" | "cancelled">>;
+      limit: _$alepha.TOptional<_$alepha.TInteger>;
     }>;
-    response: _$alepha.TPage<_$alepha.TObject<{
+    response: _$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>;
       jobName: _$alepha.TString;
       key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-      status: PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof PG_DEFAULT>;
+      status: PgAttr<_$alepha.TUnsafe<"ok" | "error" | "pending" | "running" | "scheduled" | "cancelled">, typeof PG_DEFAULT>;
       priority: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
       attempt: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
       maxAttempts: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
       scheduledAt: _$alepha.TOptional<_$alepha.TString>;
       startedAt: _$alepha.TOptional<_$alepha.TString>;
       completedAt: _$alepha.TOptional<_$alepha.TString>;
-      result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
       error: _$alepha.TOptional<_$alepha.TString>;
-      workerId: _$alepha.TOptional<_$alepha.TString>;
+      logs: _$alepha.TOptional<_$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;
+      }>>>;
       triggeredBy: _$alepha.TOptional<_$alepha.TString>;
       triggeredByName: _$alepha.TOptional<_$alepha.TString>;
       cancelledBy: _$alepha.TOptional<_$alepha.TString>;
@@ -999,7 +846,7 @@ declare class AdminJobController {
       }>;
     }>>;
   }>;
-  readonly getJobExecution: _$alepha_server0.ActionPrimitiveFn<{
+  readonly getExecution: _$alepha_server0.ActionPrimitiveFn<{
     params: _$alepha.TObject<{
       id: _$alepha.TString;
     }>;
@@ -1009,27 +856,17 @@ declare class AdminJobController {
       updatedAt: PgAttr<PgAttr<_$alepha.TString, typeof PG_UPDATED_AT>, typeof PG_DEFAULT>;
       jobName: _$alepha.TString;
       key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-      status: PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof PG_DEFAULT>;
+      status: PgAttr<_$alepha.TUnsafe<"ok" | "error" | "pending" | "running" | "scheduled" | "cancelled">, typeof PG_DEFAULT>;
       priority: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
       attempt: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
       maxAttempts: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+      payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
       scheduledAt: _$alepha.TOptional<_$alepha.TString>;
       startedAt: _$alepha.TOptional<_$alepha.TString>;
       completedAt: _$alepha.TOptional<_$alepha.TString>;
-      result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
       error: _$alepha.TOptional<_$alepha.TString>;
-      workerId: _$alepha.TOptional<_$alepha.TString>;
-      triggeredBy: _$alepha.TOptional<_$alepha.TString>;
-      triggeredByName: _$alepha.TOptional<_$alepha.TString>;
-      cancelledBy: _$alepha.TOptional<_$alepha.TString>;
-      cancelledByName: _$alepha.TOptional<_$alepha.TString>;
-      can: _$alepha.TObject<{
-        retry: _$alepha.TBoolean;
-        cancel: _$alepha.TBoolean;
-      }>;
       logs: _$alepha.TOptional<_$alepha.TArray<_$alepha.TObject<{
-        level: _$alepha.TUnsafe<"TRACE" | "SILENT" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
+        level: _$alepha.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
         message: _$alepha.TString;
         service: _$alepha.TString;
         module: _$alepha.TString;
@@ -1038,11 +875,21 @@ declare class AdminJobController {
         data: _$alepha.TOptional<_$alepha.TAny>;
         timestamp: _$alepha.TNumber;
       }>>>;
+      triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+      triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+      cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+      cancelledByName: _$alepha.TOptional<_$alepha.TString>;
+      can: _$alepha.TObject<{
+        retry: _$alepha.TBoolean;
+        cancel: _$alepha.TBoolean;
+      }>;
     }>;
   }>;
   readonly triggerJob: _$alepha_server0.ActionPrimitiveFn<{
-    body: _$alepha.TObject<{
+    params: _$alepha.TObject<{
       name: _$alepha.TString;
+    }>;
+    body: _$alepha.TObject<{
       payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
     }>;
     response: _$alepha.TObject<{
@@ -1051,7 +898,7 @@ declare class AdminJobController {
       count: _$alepha.TOptional<_$alepha.TNumber>;
     }>;
   }>;
-  readonly retryJobExecution: _$alepha_server0.ActionPrimitiveFn<{
+  readonly retryExecution: _$alepha_server0.ActionPrimitiveFn<{
     params: _$alepha.TObject<{
       id: _$alepha.TString;
     }>;
@@ -1061,7 +908,7 @@ declare class AdminJobController {
       count: _$alepha.TOptional<_$alepha.TNumber>;
     }>;
   }>;
-  readonly cancelJobExecution: _$alepha_server0.ActionPrimitiveFn<{
+  readonly cancelExecution: _$alepha_server0.ActionPrimitiveFn<{
     params: _$alepha.TObject<{
       id: _$alepha.TString;
     }>;
@@ -1071,112 +918,43 @@ declare class AdminJobController {
       count: _$alepha.TOptional<_$alepha.TNumber>;
     }>;
   }>;
-  readonly getJobActivity: _$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 getCronJobs: _$alepha_server0.ActionPrimitiveFn<{
-    response: _$alepha.TArray<_$alepha.TObject<{
-      name: _$alepha.TString;
-      cron: _$alepha.TString;
-      lock: _$alepha.TBoolean;
-      priority: _$alepha.TUnsafe<"critical" | "high" | "normal" | "low">;
-      concurrency: _$alepha.TInteger;
-      hasSchema: _$alepha.TBoolean;
-      paused: _$alepha.TBoolean;
-      lastExecution: _$alepha.TOptional<_$alepha.TObject<{
-        id: _$alepha.TString;
-        status: _$alepha.TString;
-        startedAt: _$alepha.TOptional<_$alepha.TString>;
-        completedAt: _$alepha.TOptional<_$alepha.TString>;
-        error: _$alepha.TOptional<_$alepha.TString>;
-      }>>;
-    }>>;
-  }>;
-  readonly getJobQueueDepth: _$alepha_server0.ActionPrimitiveFn<{
-    response: _$alepha.TArray<_$alepha.TObject<{
-      jobName: _$alepha.TString;
-      pending: _$alepha.TInteger;
-      running: _$alepha.TInteger;
-      scheduled: _$alepha.TInteger;
-      retrying: _$alepha.TInteger;
-      dead: _$alepha.TInteger;
-      concurrency: _$alepha.TInteger;
-      paused: _$alepha.TBoolean;
-    }>>;
-  }>;
-  readonly getJobTopFailures: _$alepha_server0.ActionPrimitiveFn<{
-    query: _$alepha.TObject<{
-      days: _$alepha.TOptional<_$alepha.TInteger>;
-    }>;
-    response: _$alepha.TArray<_$alepha.TObject<{
-      jobName: _$alepha.TString;
-      failures: _$alepha.TInteger;
-      lastError: _$alepha.TOptional<_$alepha.TString>;
-    }>>;
-  }>;
-  readonly pauseJob: _$alepha_server0.ActionPrimitiveFn<{
-    body: _$alepha.TObject<{
-      name: _$alepha.TString;
-    }>;
-    response: _$alepha.TObject<{
-      ok: _$alepha.TBoolean;
-      id: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TString, _$alepha.TInteger]>>;
-      count: _$alepha.TOptional<_$alepha.TNumber>;
-    }>;
-  }>;
-  readonly resumeJob: _$alepha_server0.ActionPrimitiveFn<{
-    body: _$alepha.TObject<{
-      name: _$alepha.TString;
-    }>;
-    response: _$alepha.TObject<{
-      ok: _$alepha.TBoolean;
-      id: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TString, _$alepha.TInteger]>>;
-      count: _$alepha.TOptional<_$alepha.TNumber>;
-    }>;
-  }>;
-  readonly getPausedJobs: _$alepha_server0.ActionPrimitiveFn<{
-    response: _$alepha.TArray<_$alepha.TString>;
-  }>;
 }
 //#endregion
 //#region ../../src/api/jobs/entities/jobExecutionEntity.d.ts
+/**
+ * Job execution record.
+ *
+ * Stores durable state for queue-mode jobs (outbox pattern) and error records
+ * for cron-mode jobs. Successful executions are trimmed by the sweep to keep
+ * the last N rows per job (configurable via `jobConfig.keepLastSuccess`).
+ *
+ * Status transitions:
+ * - queue push            → pending
+ * - worker claim          → running
+ * - success               → ok
+ * - terminal failure      → error
+ * - retry                 → scheduled (with scheduledAt = now + backoff)
+ * - delay                 → scheduled (with scheduledAt = now + delay)
+ * - sweep picks due ones  → pending
+ * - cancel                → cancelled
+ */
 declare const jobExecutionEntity: _$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>;
   jobName: _$alepha.TString;
   key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-  payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-  status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
+  status: _$alepha_orm0.PgAttr<_$alepha.TUnsafe<"ok" | "error" | "pending" | "running" | "scheduled" | "cancelled">, typeof _$alepha_orm0.PG_DEFAULT>;
   priority: _$alepha_orm0.PgAttr<_$alepha.TInteger, 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>;
+  payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
   scheduledAt: _$alepha.TOptional<_$alepha.TString>;
   startedAt: _$alepha.TOptional<_$alepha.TString>;
   completedAt: _$alepha.TOptional<_$alepha.TString>;
-  result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
   error: _$alepha.TOptional<_$alepha.TString>;
-  workerId: _$alepha.TOptional<_$alepha.TString>;
-  triggeredBy: _$alepha.TOptional<_$alepha.TString>;
-  triggeredByName: _$alepha.TOptional<_$alepha.TString>;
-  cancelledBy: _$alepha.TOptional<_$alepha.TString>;
-  cancelledByName: _$alepha.TOptional<_$alepha.TString>;
-}>>;
-type JobExecutionEntity = Static<typeof jobExecutionEntity.schema>;
-type JobStatus = "pending" | "scheduled" | "retrying" | "running" | "completed" | "dead" | "cancelled";
-//#endregion
-//#region ../../src/api/jobs/entities/jobExecutionLogEntity.d.ts
-declare const jobExecutionLogEntity: _$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<"TRACE" | "SILENT" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
+  logs: _$alepha.TOptional<_$alepha.TArray<_$alepha.TObject<{
+    level: _$alepha.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
     message: _$alepha.TString;
     service: _$alepha.TString;
     module: _$alepha.TString;
@@ -1184,18 +962,22 @@ declare const jobExecutionLogEntity: _$alepha_orm0.EntityPrimitive<_$alepha.TObj
     app: _$alepha.TOptional<_$alepha.TString>;
     data: _$alepha.TOptional<_$alepha.TAny>;
     timestamp: _$alepha.TNumber;
-  }>>;
+  }>>>;
+  triggeredBy: _$alepha.TOptional<_$alepha.TString>;
+  triggeredByName: _$alepha.TOptional<_$alepha.TString>;
+  cancelledBy: _$alepha.TOptional<_$alepha.TString>;
+  cancelledByName: _$alepha.TOptional<_$alepha.TString>;
 }>>;
-type JobExecutionLogEntity = Static<typeof jobExecutionLogEntity.schema>;
+type JobExecutionEntity = Static<typeof jobExecutionEntity.schema>;
+type JobStatus = "pending" | "running" | "scheduled" | "ok" | "error" | "cancelled";
 //#endregion
 //#region ../../src/api/jobs/providers/JobQueueProvider.d.ts
 /**
- * Optional queue-backed dispatch for the job system.
+ * Plumbs outbox-style dispatch through `AlephaQueue`.
  *
- * When registered, `JobProvider` will push work through this queue instead of
- * executing inline. This is the default for long-running (non-serverless) environments.
- * In serverless environments (Cloudflare Workers, Vercel), this provider is typically
- * omitted so jobs execute inline without requiring an external queue resource.
+ * Registered only when the app imports `AlephaApiJobsQueue`. Sets
+ * `JobProvider.queueDispatch` eagerly at instantiation so queue-mode jobs
+ * can dispatch regardless of start-hook ordering.
  */
 declare class JobQueueProvider {
   protected readonly jobProvider: JobProvider;
@@ -1203,24 +985,18 @@ declare class JobQueueProvider {
     jobName: _$alepha.TString;
     executionId: _$alepha.TString;
   }>>;
-  protected readonly onStart: _$alepha.HookPrimitive<"start">;
-  /**
-   * Push a job execution onto the queue for async processing.
-   */
+  constructor();
+  protected wireDispatcher(): void;
   push(jobName: string, executionId: string): Promise<void>;
 }
 //#endregion
 //#region ../../src/api/jobs/schemas/jobConfigAtom.d.ts
 declare const jobConfig: _$alepha.Atom<_$alepha.TObject<{
-  recovery: _$alepha.TObject<{
-    interval: _$alepha.TInteger;
-    staleThreshold: _$alepha.TInteger;
-    runTimeout: _$alepha.TInteger;
-  }>;
-  delayed: _$alepha.TObject<{
-    interval: _$alepha.TInteger;
-  }>;
-  logRetentionDays: _$alepha.TInteger;
+  sweepInterval: _$alepha.TInteger;
+  staleThreshold: _$alepha.TInteger;
+  runTimeout: _$alepha.TInteger;
+  keepLastSuccess: _$alepha.TInteger;
+  keepLastError: _$alepha.TInteger;
   logMaxEntries: _$alepha.TInteger;
   drainTimeout: _$alepha.TInteger;
 }>, "alepha.jobs">;
@@ -1231,34 +1007,24 @@ declare module "alepha" {
   }
 } //# sourceMappingURL=jobConfigAtom.d.ts.map
 //#endregion
-//#region ../../src/api/jobs/schemas/jobExecutionDetailResourceSchema.d.ts
-declare const jobExecutionDetailResourceSchema: _$alepha.TObject<{
+//#region ../../src/api/jobs/schemas/jobExecutionResourceSchema.d.ts
+declare const jobExecutionResourceSchema: _$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>;
   jobName: _$alepha.TString;
   key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-  payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-  status: PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof PG_DEFAULT>;
+  status: PgAttr<_$alepha.TUnsafe<"ok" | "error" | "pending" | "running" | "scheduled" | "cancelled">, typeof PG_DEFAULT>;
   priority: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
   attempt: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
   maxAttempts: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
+  payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
   scheduledAt: _$alepha.TOptional<_$alepha.TString>;
   startedAt: _$alepha.TOptional<_$alepha.TString>;
   completedAt: _$alepha.TOptional<_$alepha.TString>;
-  result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
   error: _$alepha.TOptional<_$alepha.TString>;
-  workerId: _$alepha.TOptional<_$alepha.TString>;
-  triggeredBy: _$alepha.TOptional<_$alepha.TString>;
-  triggeredByName: _$alepha.TOptional<_$alepha.TString>;
-  cancelledBy: _$alepha.TOptional<_$alepha.TString>;
-  cancelledByName: _$alepha.TOptional<_$alepha.TString>;
-  can: _$alepha.TObject<{
-    retry: _$alepha.TBoolean;
-    cancel: _$alepha.TBoolean;
-  }>;
   logs: _$alepha.TOptional<_$alepha.TArray<_$alepha.TObject<{
-    level: _$alepha.TUnsafe<"TRACE" | "SILENT" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
+    level: _$alepha.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
     message: _$alepha.TString;
     service: _$alepha.TString;
     module: _$alepha.TString;
@@ -1267,31 +1033,6 @@ declare const jobExecutionDetailResourceSchema: _$alepha.TObject<{
     data: _$alepha.TOptional<_$alepha.TAny>;
     timestamp: _$alepha.TNumber;
   }>>>;
-}>;
-type JobExecutionDetailResource = Static<typeof jobExecutionDetailResourceSchema>;
-//#endregion
-//#region ../../src/api/jobs/schemas/jobExecutionResourceSchema.d.ts
-declare const jobExecutionCanSchema: _$alepha.TObject<{
-  retry: _$alepha.TBoolean;
-  cancel: _$alepha.TBoolean;
-}>;
-declare const jobExecutionResourceSchema: _$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>;
-  jobName: _$alepha.TString;
-  key: _$alepha.TOptional<_$alepha.TUnion<[_$alepha.TNull, _$alepha.TString]>>;
-  payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-  status: PgAttr<_$alepha.TUnsafe<"running" | "pending" | "scheduled" | "retrying" | "dead" | "completed" | "cancelled">, typeof PG_DEFAULT>;
-  priority: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
-  attempt: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
-  maxAttempts: PgAttr<_$alepha.TInteger, typeof PG_DEFAULT>;
-  scheduledAt: _$alepha.TOptional<_$alepha.TString>;
-  startedAt: _$alepha.TOptional<_$alepha.TString>;
-  completedAt: _$alepha.TOptional<_$alepha.TString>;
-  result: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
-  error: _$alepha.TOptional<_$alepha.TString>;
-  workerId: _$alepha.TOptional<_$alepha.TString>;
   triggeredBy: _$alepha.TOptional<_$alepha.TString>;
   triggeredByName: _$alepha.TOptional<_$alepha.TString>;
   cancelledBy: _$alepha.TOptional<_$alepha.TString>;
@@ -1305,14 +1046,12 @@ type JobExecutionResource = Static<typeof jobExecutionResourceSchema>;
 //#endregion
 //#region ../../src/api/jobs/schemas/triggerJobSchema.d.ts
 declare const triggerJobSchema: _$alepha.TObject<{
-  name: _$alepha.TString;
   payload: _$alepha.TOptional<_$alepha.TRecord<"^.*$", _$alepha.TAny>>;
 }>;
 type TriggerJob = Static<typeof triggerJobSchema>;
 //#endregion
 //#region ../../src/api/jobs/index.d.ts
 declare module "alepha" {
-  interface Env extends Partial<Static<typeof jobEnvSchema>> {}
   interface Hooks {
     "job:begin": {
       name: string;
@@ -1338,30 +1077,30 @@ declare module "alepha" {
     };
   }
 }
-declare const jobEnvSchema: _$alepha.TObject<{
-  /**
-   * Controls whether the job system dispatches work through a queue or executes inline.
-   *
-   * - `1` — always use queue (force queue even in serverless)
-   * - `0` — never use queue (force inline, useful for testing)
-   * - not set — auto: use queue when NOT serverless (default)
-   */
-  ALEPHA_JOBS_QUEUE: _$alepha.TOptional<_$alepha.TInteger>;
-}>;
 /**
- * Job execution framework — unified primitive for deferred, scheduled, and queued work.
+ * Job execution framework — cron and durable queue work with a single primitive.
  *
- * **Features:**
- * - Push-based jobs with typed payloads
- * - Cron scheduling with execution tracking
- * - Retry with exponential backoff
- * - Priority, delay, cancellation
- * - Deduplication via unique keys
- * - Per-execution log capture
+ * A `$job` is either **cron-only** (declares `cron`) or **queue-only** (declares `schema`).
+ * Cron jobs run inline on their schedule and only record errors by default.
+ * Queue jobs use the outbox pattern: push commits to DB first, then notifies via queue.
+ *
+ * **This module provides cron support only.** To enable queue-mode jobs, also
+ * import {@link AlephaApiJobsQueue} — it brings in the queue layer and infrastructure
+ * binding (e.g. Cloudflare Queues). Cron-only deployments (Vercel, CF-without-Queues)
+ * do not need `AlephaApiJobsQueue`.
  *
  * @module alepha.api.jobs
  */
 declare const AlephaApiJobs: _$alepha.Service<_$alepha.Module>;
+/**
+ * Queue support for `$job`. Import alongside {@link AlephaApiJobs} when your
+ * app declares queue-mode jobs (any `$job` with a `schema`).
+ *
+ * Adds `JobQueueProvider` which plumbs the outbox dispatch through `AlephaQueue`.
+ *
+ * @module alepha.api.jobs.queue
+ */
+declare const AlephaApiJobsQueue: _$alepha.Service<_$alepha.Module>;
 //#endregion
-export { $job, AdminJobController, AlephaApiJobs, CancelContext, JobActivityPoint, JobActivityQuery, JobConfig, JobCronInfo, JobExecutionDetailResource, JobExecutionEntity, JobExecutionLogEntity, JobExecutionQuery, JobExecutionResource, JobFailure, JobHandlerArgs, JobItem, JobPrimitive, JobPrimitiveOptions, JobPriority, JobProvider, JobQueueDepth, JobQueueProvider, JobRegistration, JobRetryBackoff, JobRetryOptions, JobService, JobStats, JobStatus, JobTriggerContext, PushManyItem, PushOptions, TriggerJob, jobActivityPointSchema, jobActivityQuerySchema, jobConfig, jobCronInfoSchema, jobExecutionCanSchema, jobExecutionDetailResourceSchema, jobExecutionEntity, jobExecutionLogEntity, jobExecutionQuerySchema, jobExecutionResourceSchema, jobFailureSchema, jobQueueDepthSchema, jobRegistrationSchema, jobStatsSchema, triggerJobSchema };
+export { $job, AdminJobController, AlephaApiJobs, AlephaApiJobsQueue, CancelContext, JobConfig, JobExecutionEntity, JobExecutionQuery, JobExecutionResource, JobHandlerArgs, JobPrimitive, JobPrimitiveOptions, JobPriority, JobProvider, JobQueueProvider, JobRegistration, JobRetryBackoff, JobRetryOptions, JobService, JobStatus, JobTriggerContext, PRIORITY_MAP, PRIORITY_REVERSE, PushManyItem, PushOptions, TriggerJob, jobConfig, jobExecutionEntity, jobExecutionQuerySchema, jobExecutionResourceSchema, jobRegistrationSchema, triggerJobSchema };
 //# sourceMappingURL=index.d.ts.map