@ultimat3/jobs 1.0.0

package/src/events.ts

@@ -0,0 +1,134 @@
+// The event bus `step.waitForEvent` consumes. Events are stored, not just broadcast: a step
+// that suspends at 12:00 and resumes at 12:00:30 must still see an event published at
+// 12:00:10, so a fire-and-forget emitter would silently strand every waiting run.
+
+import type { Clock } from '@ultimat3/core';
+import { logger, systemClock, uuid } from '@ultimat3/core';
+import type { DurationInput } from './clock';
+import { nowMs, toMs } from './clock';
+import type { EventLookup } from './steps';
+
+export interface JobEvent {
+  readonly id: string;
+  readonly name: string;
+  readonly payload: unknown;
+  /** Ties the event to one waiting run — usually an entity id. */
+  readonly correlationKey?: string;
+  readonly publishedAt: number;
+  readonly expiresAt: number;
+}
+
+export interface PublishOptions {
+  readonly correlationKey?: string;
+  /** How long the event stays matchable. Default 7d — longer than any sane wait. */
+  readonly ttl?: DurationInput;
+}
+
+export interface EventBus extends EventLookup {
+  publish(name: string, payload: unknown, options?: PublishOptions): Promise<JobEvent>;
+  list(name?: string): Promise<readonly JobEvent[]>;
+  purgeExpired(): number;
+  size(): number;
+}
+
+export interface MemoryEventBusOptions {
+  readonly clock?: Clock;
+  readonly defaultTtl?: DurationInput;
+  readonly maxEvents?: number;
+}
+
+export function createMemoryEventBus(options: MemoryEventBusOptions = {}): EventBus {
+  const clock = options.clock ?? systemClock;
+  const defaultTtl = options.defaultTtl ?? 604_800_000;
+  const maxEvents = options.maxEvents ?? 10_000;
+  const events = new Map<string, JobEvent>();
+
+  const purgeExpired = (): number => {
+    const at = nowMs(clock);
+    let removed = 0;
+    for (const [id, event] of events) {
+      if (event.expiresAt <= at) {
+        events.delete(id);
+        removed += 1;
+      }
+    }
+    return removed;
+  };
+
+  return {
+    publish(name, payload, publishOptions = {}) {
+      purgeExpired();
+      const at = nowMs(clock);
+      const event: JobEvent = {
+        id: uuid(),
+        name,
+        payload,
+        publishedAt: at,
+        expiresAt: at + toMs(publishOptions.ttl ?? defaultTtl),
+        ...(publishOptions.correlationKey === undefined
+          ? {}
+          : { correlationKey: publishOptions.correlationKey }),
+      };
+      events.set(event.id, event);
+      while (events.size > maxEvents) {
+        const oldest = events.keys().next();
+        if (oldest.done === true) break;
+        events.delete(oldest.value);
+      }
+      logger.debug('jobs.event.published', {
+        event: name,
+        correlationKey: publishOptions.correlationKey ?? null,
+      });
+      return Promise.resolve(event);
+    },
+
+    /**
+     * Earliest matching event at or after `afterMs`, so a resumed step consumes events in
+     * publication order rather than jumping to the newest one.
+     */
+    find(name, correlationKey, afterMs) {
+      const at = nowMs(clock);
+      let best: JobEvent | undefined;
+      for (const event of events.values()) {
+        if (event.name !== name) continue;
+        if (event.expiresAt <= at) continue;
+        if (event.publishedAt < afterMs) continue;
+        if (correlationKey !== undefined && event.correlationKey !== correlationKey) continue;
+        if (best === undefined || event.publishedAt < best.publishedAt) best = event;
+      }
+      return Promise.resolve(
+        best === undefined ? undefined : { payload: best.payload, publishedAt: best.publishedAt },
+      );
+    },
+
+    list(name) {
+      const all = [...events.values()]
+        .filter((event) => name === undefined || event.name === name)
+        .sort((a, b) => a.publishedAt - b.publishedAt);
+      return Promise.resolve(all);
+    },
+
+    purgeExpired,
+    size: () => events.size,
+  };
+}
+
+let ambientBus: EventBus = createMemoryEventBus();
+
+/** Swapped at boot for the NATS/Redis-streams bus in a multi-node deployment. */
+export function setEventBus(bus: EventBus): void {
+  ambientBus = bus;
+}
+
+export function eventBus(): EventBus {
+  return ambientBus;
+}
+
+/** The one function app code calls to unblock a waiting step. */
+export function publishEvent(
+  name: string,
+  payload: unknown,
+  options?: PublishOptions,
+): Promise<JobEvent> {
+  return ambientBus.publish(name, payload, options);
+}

package/src/index.d.ts

@@ -0,0 +1,32 @@
+export type { ClaimedJob, ClaimOptions, ConflictPolicy, EnqueueRequest, EnqueueResult, JobDriver, JobFilter, JobIntrospection, JobRecord, JobState, NackOptions, QueueStats, } from './driver';
+export { DEFAULT_QUEUE, DEFAULT_VISIBILITY_TIMEOUT_MS, jobDriver, setJobDriver, } from './driver';
+export type { MemoryDriverOptions } from './driver-memory';
+export { createMemoryDriver } from './driver-memory';
+export type { NatsDriverOptions } from './driver-nats';
+export { createNatsDriver } from './driver-nats';
+export type { PgDriverOptions, PgExecutor } from './driver-pg';
+export { createPgDriver, createPgLeader } from './driver-pg';
+export { SQL_ACK, SQL_ADVISORY_UNLOCK, SQL_CLAIM, SQL_ENQUEUE, SQL_HEARTBEAT, SQL_JOBS_TABLE, SQL_NACK, SQL_STATS, SQL_STEP_GET, SQL_STEP_PUT, SQL_TRY_ADVISORY_LOCK, } from './driver-pg-sql';
+export type { RedisDriverOptions } from './driver-redis';
+export { createRedisDriver } from './driver-redis';
+export type { JobErrorCode } from './errors';
+export { DriverUnavailableError, IdempotencyRequiredError, JOB_ERROR_CODES, JobDuplicateError, JobMaxAttemptsError, JobsNotImplementedError, JobTimeoutError, OutboxNoTxError, StepDuplicateError, } from './errors';
+export type { EventBus, JobEvent, MemoryEventBusOptions, PublishOptions } from './events';
+export { createMemoryEventBus, eventBus, publishEvent, setEventBus } from './events';
+export type { DeadLetterEntry, JobsManifest, JobTrace, QueueDepthReport, StepTrace, } from './inspect';
+export { inspectDeadLetters, inspectJob, inspectJobList, inspectManifest, inspectQueues, retryFromStep, } from './inspect';
+export type { AnyJobHandle, JobDefinition, JobHandle, JobRunArgs } from './job';
+export { describeJobs, getJob, job, nameJobs, registeredJobs, resetJobs } from './job';
+export type { Lease, LimitConfig, Limiter, LimitKey, LimitReason, LimitSnapshot, RateLimit, } from './limits';
+export { createLimiter, NO_TENANT, tenantKeyFrom } from './limits';
+export type { EnqueueOptions, JobsFacade, OutboxDeps, OutboxRecord, OutboxRelay, OutboxStore, RelayOptions, } from './outbox';
+export { createJobsFacade, createMemoryOutboxStore, createOutboxRelay, enqueueInTx, SQL_OUTBOX_CLAIM, SQL_OUTBOX_MARK_PUBLISHED, SQL_OUTBOX_STAGE, SQL_OUTBOX_TABLE, } from './outbox';
+export type { BackoffStrategy, Random, RetryDecision, RetryPolicy } from './retry';
+export { backoffDelayMs, DEFAULT_RETRY, nextRetry, retrySchedule } from './retry';
+export type { CatchUpPolicy, CronResolver, DispatchedOccurrence, LeaderElection, Scheduler, SchedulerOptions, SchedulerState, TaskDefinition, TaskEnqueueEntry, TaskHandle, } from './scheduler';
+export { createMemorySchedulerState, createScheduler, getTask, nameTasks, registeredTasks, resetTasks, soleLeader, task, } from './scheduler';
+export type { EventLookup, StepApi, StepRecord, StepRunner, StepRunnerOptions, StepStatus, StepStore, WaitForEventOptions, } from './steps';
+export { createMemoryStepStore, createStepRunner, isStepSuspension, StepSuspension, } from './steps';
+export type { ExecuteJobOptions, JobExecution, JobOutcome, Worker, WorkerOptions, WorkerStats, } from './worker';
+export { createWorker, executeJob } from './worker';
+//# sourceMappingURL=index.d.ts.map

package/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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"}

package/src/index.js

@@ -0,0 +1,18 @@
+// Public API of @ultimat3/jobs. Explicit, no `export *`.
+export { DEFAULT_QUEUE, DEFAULT_VISIBILITY_TIMEOUT_MS, jobDriver, setJobDriver, } from './driver';
+export { createMemoryDriver } from './driver-memory';
+export { createNatsDriver } from './driver-nats';
+export { createPgDriver, createPgLeader } from './driver-pg';
+export { SQL_ACK, SQL_ADVISORY_UNLOCK, SQL_CLAIM, SQL_ENQUEUE, SQL_HEARTBEAT, SQL_JOBS_TABLE, SQL_NACK, SQL_STATS, SQL_STEP_GET, SQL_STEP_PUT, SQL_TRY_ADVISORY_LOCK, } from './driver-pg-sql';
+export { createRedisDriver } from './driver-redis';
+export { DriverUnavailableError, IdempotencyRequiredError, JOB_ERROR_CODES, JobDuplicateError, JobMaxAttemptsError, JobsNotImplementedError, JobTimeoutError, OutboxNoTxError, StepDuplicateError, } from './errors';
+export { createMemoryEventBus, eventBus, publishEvent, setEventBus } from './events';
+export { inspectDeadLetters, inspectJob, inspectJobList, inspectManifest, inspectQueues, retryFromStep, } from './inspect';
+export { describeJobs, getJob, job, nameJobs, registeredJobs, resetJobs } from './job';
+export { createLimiter, NO_TENANT, tenantKeyFrom } from './limits';
+export { createJobsFacade, createMemoryOutboxStore, createOutboxRelay, enqueueInTx, SQL_OUTBOX_CLAIM, SQL_OUTBOX_MARK_PUBLISHED, SQL_OUTBOX_STAGE, SQL_OUTBOX_TABLE, } from './outbox';
+export { backoffDelayMs, DEFAULT_RETRY, nextRetry, retrySchedule } from './retry';
+export { createMemorySchedulerState, createScheduler, getTask, nameTasks, registeredTasks, resetTasks, soleLeader, task, } from './scheduler';
+export { createMemoryStepStore, createStepRunner, isStepSuspension, StepSuspension, } from './steps';
+export { createWorker, executeJob } from './worker';
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAgBzD,OAAO,EACL,aAAa,EACb,6BAA6B,EAC7B,SAAS,EACT,YAAY,GACb,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EACL,OAAO,EACP,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,aAAa,EACb,cAAc,EACd,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAQrF,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,aAAa,GACd,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvF,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAUnE,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAalF,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,OAAO,EACP,SAAS,EACT,eAAe,EACf,UAAU,EACV,UAAU,EACV,IAAI,GACL,MAAM,aAAa,CAAC;AAWrB,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,GACf,MAAM,SAAS,CAAC;AASjB,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/src/index.ts

@@ -0,0 +1,172 @@
+// Public API of @ultimat3/jobs. Explicit, no `export *`.
+//
+// `registerJob`/`registerJobs`/`registerTask`/`registerTasks`/`nameJobs`/`nameTasks` are
+// deliberately absent. `defineApi({ jobs, tasks })` is where a module is handed over and nothing
+// else registers (CLAUDE.md); it reaches them through core's registrar table, which the
+// side-effect import below fills. Exporting them would offer a second registration path that
+// bypasses `defineApi`'s own result — the ambiguity axiom 1 exists to refuse.
+import './register';
+
+/** Re-exported so a `job`/`task` file needs one import, not two. Same object as schema's. */
+export type { Infer } from '@ultimat3/schema';
+export { t } from '@ultimat3/schema';
+export type { JobDescriptor } from './describe';
+export type {
+  ClaimedJob,
+  ClaimOptions,
+  ConflictPolicy,
+  EnqueueRequest,
+  EnqueueResult,
+  JobDriver,
+  JobFilter,
+  JobIntrospection,
+  JobRecord,
+  JobState,
+  NackOptions,
+  QueueStats,
+} from './driver';
+export {
+  DEFAULT_QUEUE,
+  DEFAULT_VISIBILITY_TIMEOUT_MS,
+  jobDriver,
+  resetJobDriver,
+  setJobDriver,
+} from './driver';
+export type { MemoryDriverOptions } from './driver-memory';
+export { createMemoryDriver } from './driver-memory';
+export type { NatsDriverOptions } from './driver-nats';
+export { createNatsDriver } from './driver-nats';
+export type { PgDriverOptions, PgExecutor } from './driver-pg';
+export { createPgDriver, createPgLeader } from './driver-pg';
+export {
+  SQL_ACK,
+  SQL_ADVISORY_UNLOCK,
+  SQL_CLAIM,
+  SQL_ENQUEUE,
+  SQL_HEARTBEAT,
+  SQL_JOBS_TABLE,
+  SQL_NACK,
+  SQL_STATS,
+  SQL_STEP_GET,
+  SQL_STEP_PUT,
+  SQL_TRY_ADVISORY_LOCK,
+} from './driver-pg-sql';
+export type { RedisDriverOptions } from './driver-redis';
+export { createRedisDriver } from './driver-redis';
+export type { JobErrorCode } from './errors';
+export {
+  DriverUnavailableError,
+  IdempotencyRequiredError,
+  JOB_ERROR_CODES,
+  JOB_ERROR_TITLES,
+  JobDuplicateError,
+  JobMaxAttemptsError,
+  JobNameTakenError,
+  JobsNotImplementedError,
+  JobTimeoutError,
+  OutboxNoTxError,
+  StepDuplicateError,
+} from './errors';
+export type { EventBus, JobEvent, MemoryEventBusOptions, PublishOptions } from './events';
+export { createMemoryEventBus, eventBus, publishEvent, setEventBus } from './events';
+export type {
+  DeadLetterEntry,
+  JobsManifest,
+  JobTrace,
+  QueueDepthReport,
+  StepTrace,
+} from './inspect';
+export {
+  inspectDeadLetters,
+  inspectJob,
+  inspectJobList,
+  inspectManifest,
+  inspectQueues,
+  retryFromStep,
+} from './inspect';
+export type { AnyJobHandle, JobActor, JobDefinition, JobHandle, JobRunArgs } from './job';
+export { describeJobs, getJob, isJobHandle, job, registeredJobs, resetJobs } from './job';
+export type {
+  Lease,
+  LimitConfig,
+  Limiter,
+  LimitKey,
+  LimitReason,
+  LimitSnapshot,
+  RateLimit,
+} from './limits';
+export { createLimiter, NO_TENANT, tenantKeyFrom } from './limits';
+export type {
+  EnqueueOptions,
+  JobsFacade,
+  OutboxDeps,
+  OutboxRecord,
+  OutboxRelay,
+  OutboxStore,
+  RelayOptions,
+} from './outbox';
+export {
+  createJobsFacade,
+  createMemoryOutboxStore,
+  createOutboxRelay,
+  enqueueInTx,
+  jobsFacade,
+  resetJobsFacade,
+  SQL_OUTBOX_CLAIM,
+  SQL_OUTBOX_MARK_PUBLISHED,
+  SQL_OUTBOX_STAGE,
+  SQL_OUTBOX_TABLE,
+  setJobsFacade,
+} from './outbox';
+
+export type { BackoffStrategy, Random, RetryDecision, RetryPolicy } from './retry';
+export { backoffDelayMs, DEFAULT_RETRY, nextRetry, retrySchedule } from './retry';
+export type {
+  CatchUpPolicy,
+  CronResolver,
+  DispatchedOccurrence,
+  LeaderElection,
+  Scheduler,
+  SchedulerOptions,
+  SchedulerState,
+  TaskDefinition,
+  TaskDescriptor,
+  TaskEnqueueEntry,
+  TaskHandle,
+  TaskJobResult,
+} from './scheduler';
+export {
+  createMemorySchedulerState,
+  createScheduler,
+  getTask,
+  isTaskHandle,
+  registeredTasks,
+  resetTasks,
+  soleLeader,
+  task,
+} from './scheduler';
+export type {
+  EventLookup,
+  StepApi,
+  StepRecord,
+  StepRunner,
+  StepRunnerOptions,
+  StepStatus,
+  StepStore,
+  WaitForEventOptions,
+} from './steps';
+export {
+  createMemoryStepStore,
+  createStepRunner,
+  isStepSuspension,
+  StepSuspension,
+} from './steps';
+export type {
+  ExecuteJobOptions,
+  JobExecution,
+  JobOutcome,
+  Worker,
+  WorkerOptions,
+  WorkerStats,
+} from './worker';
+export { createWorker, executeJob } from './worker';

package/src/inspect.d.ts

@@ -0,0 +1,82 @@
+import type { JobDriver, JobFilter, JobRecord, QueueStats } from './driver';
+import type { Scheduler } from './scheduler';
+import type { StepRecord } from './steps';
+export interface QueueDepthReport {
+    readonly driver: string;
+    readonly queues: readonly QueueStats[];
+    readonly totals: {
+        readonly ready: number;
+        readonly delayed: number;
+        readonly running: number;
+        readonly suspended: number;
+        readonly dead: number;
+    };
+    /** Oldest claimable job across all queues, in ms. The autoscaling signal. */
+    readonly oldestReadyMs: number;
+}
+export declare function inspectQueues(driver: JobDriver): Promise<QueueDepthReport>;
+export interface StepTrace {
+    readonly name: string;
+    readonly status: StepRecord['status'];
+    readonly startedAt: string;
+    readonly completedAt: string | null;
+    readonly wakeAt: string | null;
+    readonly durationMs: number | null;
+    readonly attempts: number;
+    readonly error: string | null;
+}
+export interface JobTrace {
+    readonly id: string;
+    readonly name: string;
+    readonly queue: string;
+    readonly state: JobRecord['state'];
+    readonly attempt: number;
+    readonly maxAttempts: number;
+    readonly idempotencyKey: string;
+    readonly runId: string;
+    readonly runAt: string;
+    readonly lastError: string | null;
+    readonly tenantId: string | null;
+    readonly steps: readonly StepTrace[];
+    /** Remaining retry delays in ms, jitter excluded. */
+    readonly retryDelaysMs: readonly number[];
+}
+export declare function inspectJob(driver: JobDriver, jobId: string): Promise<JobTrace | undefined>;
+export declare function inspectJobList(driver: JobDriver, filter?: JobFilter): Promise<readonly JobRecord[]>;
+export interface DeadLetterEntry {
+    readonly id: string;
+    readonly name: string;
+    readonly queue: string;
+    readonly attempt: number;
+    readonly lastError: string | null;
+    readonly failedAt: string;
+    readonly retryCommand: string;
+}
+export declare function inspectDeadLetters(driver: JobDriver, limit?: number): Promise<readonly DeadLetterEntry[]>;
+/**
+ * Re-queue a job, optionally dropping one step's persisted result so it re-executes while
+ * everything before it replays from storage. This is why steps are stored, not just logged.
+ */
+export declare function retryFromStep(driver: JobDriver, jobId: string, stepName?: string): Promise<JobTrace | undefined>;
+export interface JobsManifest {
+    readonly jobs: readonly {
+        readonly name: string;
+        readonly queue: string;
+        readonly attempts: number;
+        readonly backoff: string;
+        readonly concurrency: number | null;
+        readonly timeoutMs: number | null;
+        readonly retryDelaysMs: readonly number[];
+    }[];
+    readonly tasks: readonly {
+        readonly name: string;
+        readonly cron: string;
+        readonly tz: string;
+        readonly catchUp: string;
+        readonly nextRun: string | null;
+        readonly enqueues: readonly string[];
+    }[];
+}
+/** Feeds `x.manifest.json` and the MCP `jobs.list` tool. Generated facts, never prose. */
+export declare function inspectManifest(scheduler?: Scheduler): JobsManifest;
+//# sourceMappingURL=inspect.d.ts.map

package/src/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["inspect.ts"],"names":[],"mappings":"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"}

package/src/inspect.js

@@ -0,0 +1,113 @@
+// Introspection for `/_x`, the CLI and MCP. Every function returns a plain JSON-serialisable
+// object so `x jobs ... --json` and the MCP tool share one shape — an agent debugging a stuck
+// queue reads exactly what the dashboard renders.
+import { JobsNotImplementedError } from './errors';
+import { registeredJobs } from './job';
+import { retrySchedule } from './retry';
+import { registeredTasks } from './scheduler';
+export async function inspectQueues(driver) {
+    const queues = [...(await driver.stats())];
+    const totals = queues.reduce((acc, queue) => ({
+        ready: acc.ready + queue.ready,
+        delayed: acc.delayed + queue.delayed,
+        running: acc.running + queue.running,
+        suspended: acc.suspended + queue.suspended,
+        dead: acc.dead + queue.dead,
+    }), { ready: 0, delayed: 0, running: 0, suspended: 0, dead: 0 });
+    return {
+        driver: driver.name,
+        queues,
+        totals,
+        oldestReadyMs: queues.reduce((max, queue) => Math.max(max, queue.oldestReadyMs), 0),
+    };
+}
+const iso = (ms) => ms === undefined ? null : new Date(ms).toISOString();
+function requireIntrospection(driver) {
+    if (driver.introspect === undefined) {
+        throw new JobsNotImplementedError({
+            feature: `introspection for the "${driver.name}" jobs driver`,
+            fix: 'use driver: "pg" (default) or "memory" — see docs/jobs/drivers.md',
+        });
+    }
+    return driver.introspect;
+}
+function toStepTrace(record) {
+    return {
+        name: record.name,
+        status: record.status,
+        startedAt: new Date(record.startedAt).toISOString(),
+        completedAt: iso(record.completedAt),
+        wakeAt: iso(record.wakeAt),
+        durationMs: record.completedAt === undefined ? null : record.completedAt - record.startedAt,
+        attempts: record.attempts,
+        error: record.error ?? null,
+    };
+}
+export async function inspectJob(driver, jobId) {
+    const record = await requireIntrospection(driver).job(jobId);
+    if (record === undefined)
+        return undefined;
+    const steps = await driver.steps.list(record.runId);
+    const handle = registeredJobs().find((candidate) => candidate.name === record.name);
+    return {
+        id: record.id,
+        name: record.name,
+        queue: record.queue,
+        state: record.state,
+        attempt: record.attempt,
+        maxAttempts: record.maxAttempts,
+        idempotencyKey: record.idempotencyKey,
+        runId: record.runId,
+        runAt: new Date(record.runAt).toISOString(),
+        lastError: record.lastError ?? null,
+        tenantId: record.tenantId ?? null,
+        steps: steps.map(toStepTrace),
+        retryDelaysMs: handle === undefined ? [] : [...retrySchedule(handle.retry)],
+    };
+}
+export function inspectJobList(driver, filter) {
+    return requireIntrospection(driver).list(filter);
+}
+export async function inspectDeadLetters(driver, limit = 100) {
+    const rows = await requireIntrospection(driver).deadLetters(limit);
+    return rows.map((record) => ({
+        id: record.id,
+        name: record.name,
+        queue: record.queue,
+        attempt: record.attempt,
+        lastError: record.lastError ?? null,
+        failedAt: new Date(record.updatedAt).toISOString(),
+        retryCommand: `x jobs retry ${record.id}`,
+    }));
+}
+/**
+ * Re-queue a job, optionally dropping one step's persisted result so it re-executes while
+ * everything before it replays from storage. This is why steps are stored, not just logged.
+ */
+export async function retryFromStep(driver, jobId, stepName) {
+    await requireIntrospection(driver).requeue(jobId, stepName === undefined ? undefined : { fromStep: stepName });
+    return inspectJob(driver, jobId);
+}
+/** Feeds `x.manifest.json` and the MCP `jobs.list` tool. Generated facts, never prose. */
+export function inspectManifest(scheduler) {
+    return {
+        jobs: registeredJobs().map((handle) => ({
+            name: handle.name,
+            queue: handle.queue,
+            attempts: handle.retry.attempts,
+            backoff: handle.retry.backoff ?? 'exponential',
+            concurrency: handle.concurrency ?? null,
+            timeoutMs: handle.timeoutMs ?? null,
+            retryDelaysMs: [...retrySchedule(handle.retry)],
+        })),
+        tasks: registeredTasks().map((handle) => ({
+            name: handle.name,
+            cron: handle.cron,
+            tz: handle.tz,
+            catchUp: handle.catchUp,
+            nextRun: scheduler === undefined ? null : scheduler.nextRunFor(handle).toISOString(),
+            enqueues: handle.entries().map(([job]) => job.name),
+        })),
+    };
+}
+//# sourceMappingURL=inspect.js.map

package/src/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["inspect.ts"],"names":[],"mappings":"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"}