duron 0.3.0-beta.10 → 0.3.0-beta.11

package/dist/adapters/postgres/pglite.js

@@ -2,7 +2,19 @@ import { join } from 'node:path';
 import { drizzle } from 'drizzle-orm/pglite';
 import { migrate } from 'drizzle-orm/pglite/migrator';
 import { PostgresBaseAdapter } from './base.js';
+/**
+ * PGLite adapter implementation for Duron.
+ * Extends PostgresAdapter to work with PGLite (in-memory PostgreSQL).
+ *
+ * @template Options - The adapter options type
+ */
 export class PGLiteAdapter extends PostgresBaseAdapter {
+    /**
+     * Start the adapter.
+     * Runs migrations if enabled and sets up database listeners.
+     *
+     * @returns Promise resolving to `true` if started successfully, `false` otherwise
+     */
     async _start() {
         if (this.migrateOnStart) {
             await migrate(this.db, {
@@ -16,11 +28,23 @@ export class PGLiteAdapter extends PostgresBaseAdapter {
     async _stop() {
         await this.db?.$client.close();
     }
+    /**
+     * Map database query results to the expected format.
+     * PGLite returns results in a `rows` property, so we extract that.
+     *
+     * @param result - The raw database query result
+     * @returns The mapped result (result.rows)
+     */
     _map(result) {
         return result.rows;
     }
+    /**
+     * Initialize the PGLite database connection.
+     * Creates a new Drizzle instance without connection options.
+     */
     _initDb() {
         let connection = ':memory:';
+        // it means that the user is using a file path, so we need to use the file path
         if (typeof this.connection === 'string' && !this.connection.startsWith('postgres://')) {
             connection = this.connection;
         }
@@ -31,9 +55,23 @@ export class PGLiteAdapter extends PostgresBaseAdapter {
             this.db = drizzle(connection);
         }
     }
+    /**
+     * Send a PGLite notification.
+     *
+     * @param event - The event name
+     * @param data - The data to send
+     * @returns Promise resolving to `void`
+     */
     async _notify(event, data) {
         await this.db?.$client.query(`NOTIFY "${this.schema}.${event}", '${JSON.stringify(data)}'`);
     }
+    /**
+     * Listen for PGLite notifications.
+     *
+     * @param event - The event name to listen for
+     * @param callback - Callback function to handle notifications
+     * @returns Promise resolving to an object with an `unlisten` function
+     */
     async _listen(event, callback) {
         const unlisten = await this.db?.$client.listen(`"${this.schema}.${event}"`, (payload) => {
             callback(payload);

package/dist/adapters/postgres/postgres.d.ts

@@ -5,11 +5,46 @@ import type createSchema from './schema.js';
 type Schema = ReturnType<typeof createSchema>;
 export type { Job, JobStep } from '../adapter.js';
 export type DB = ReturnType<typeof drizzle<Schema>>;
+/**
+ * PostgreSQL adapter implementation for Duron.
+ * Uses Drizzle ORM to interact with PostgreSQL database.
+ *
+ * @template Options - The adapter options type
+ */
 export declare class PostgresAdapter extends PostgresBaseAdapter<DB, PostgresOptions<any> | string> {
+    /**
+     * Initialize the database connection and Drizzle instance.
+     */
     protected _initDb(): void;
+    /**
+     * Start the adapter.
+     * Runs migrations if enabled and sets up database listeners.
+     *
+     * @returns Promise resolving to `true` if started successfully, `false` otherwise
+     */
     protected _start(): Promise<void>;
+    /**
+     * Stop the adapter.
+     * Closes the database connection.
+     *
+     * @returns Promise resolving to `true` if stopped successfully, `false` otherwise
+     */
     protected _stop(): Promise<void>;
+    /**
+     * Send a PostgreSQL notification.
+     *
+     * @param event - The event name
+     * @param data - The data to send
+     * @returns Promise resolving to `void`
+     */
     protected _notify(event: string, data: any): Promise<void>;
+    /**
+     * Listen for PostgreSQL notifications.
+     *
+     * @param event - The event name to listen for
+     * @param callback - Callback function to handle notifications
+     * @returns Promise resolving to an object with an `unlisten` function
+     */
     protected _listen(event: string, callback: (payload: string) => void): Promise<{
         unlisten: () => void;
     }>;

package/dist/adapters/postgres/postgres.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/adapters/postgres/postgres.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAEjD,OAAO,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,UAAU,CAAA;AAE1D,OAAO,EAAE,KAAK,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,KAAK,YAAY,MAAM,aAAa,CAAA;AAE3C,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;AAG7C,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAMjD,MAAM,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;AAQnD,qBAAa,eAAgB,SAAQ,mBAAmB,CAAC,EAAE,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;cAItE,OAAO;cA8BD,MAAM;cAiBN,KAAK;cAiBL,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;cAchD,OAAO,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;CAKrC;AAED,eAAO,MAAM,eAAe,GAAI,SAAS,cAAc,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,oBAErF,CAAA"}
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/adapters/postgres/postgres.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAEjD,OAAO,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,UAAU,CAAA;AAE1D,OAAO,EAAE,KAAK,cAAc,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AACpE,OAAO,KAAK,YAAY,MAAM,aAAa,CAAA;AAE3C,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA;AAG7C,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAMjD,MAAM,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;AAEnD;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,mBAAmB,CAAC,EAAE,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;IACzF;;OAEG;cACgB,OAAO;IAwB1B;;;;;OAKG;cACsB,MAAM;IAW/B;;;;;OAKG;cACsB,KAAK;IAU9B;;;;;;OAMG;cACsB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzE;;;;;;OAMG;cACsB,OAAO,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAClC,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;CAKrC;AAED,eAAO,MAAM,eAAe,GAAI,SAAS,cAAc,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,oBAErF,CAAA"}

package/dist/adapters/postgres/postgres.js

@@ -3,8 +3,18 @@ import { drizzle } from 'drizzle-orm/postgres-js';
 import { migrate } from 'drizzle-orm/postgres-js/migrator';
 import { PostgresBaseAdapter } from './base.js';
 const noop = () => {
+    // do nothing
 };
+/**
+ * PostgreSQL adapter implementation for Duron.
+ * Uses Drizzle ORM to interact with PostgreSQL database.
+ *
+ * @template Options - The adapter options type
+ */
 export class PostgresAdapter extends PostgresBaseAdapter {
+    /**
+     * Initialize the database connection and Drizzle instance.
+     */
     _initDb() {
         const postgresConnection = typeof this.connection === 'string'
             ? {
@@ -22,6 +32,15 @@ export class PostgresAdapter extends PostgresBaseAdapter {
             schema: this.tables,
         });
     }
+    // ============================================================================
+    // Lifecycle Methods
+    // ============================================================================
+    /**
+     * Start the adapter.
+     * Runs migrations if enabled and sets up database listeners.
+     *
+     * @returns Promise resolving to `true` if started successfully, `false` otherwise
+     */
     async _start() {
         if (this.migrateOnStart) {
             await migrate(this.db, {
@@ -32,17 +51,40 @@ export class PostgresAdapter extends PostgresBaseAdapter {
         }
         await super._start();
     }
+    /**
+     * Stop the adapter.
+     * Closes the database connection.
+     *
+     * @returns Promise resolving to `true` if stopped successfully, `false` otherwise
+     */
     async _stop() {
         await this.db.$client.end({
             timeout: 5_000,
         });
     }
+    // ============================================================================
+    // Protected Methods
+    // ============================================================================
+    /**
+     * Send a PostgreSQL notification.
+     *
+     * @param event - The event name
+     * @param data - The data to send
+     * @returns Promise resolving to `void`
+     */
     async _notify(event, data) {
         this.logger?.debug({ event, data }, `[PostgresAdapter] Notify ${event}`);
         await this.db.$client.notify(`${this.schema}.${event}`, JSON.stringify(data)).catch((err) => {
             this.logger?.error({ err, data }, `[PostgresAdapter] Failed to notify ${event}`);
         });
     }
+    /**
+     * Listen for PostgreSQL notifications.
+     *
+     * @param event - The event name to listen for
+     * @param callback - Callback function to handle notifications
+     * @returns Promise resolving to an object with an `unlisten` function
+     */
     async _listen(event, callback) {
         return await this.db.$client.listen(`${this.schema}.${event}`, (payload) => {
             callback(payload);

package/dist/adapters/postgres/schema.js

@@ -26,6 +26,7 @@ export default function createSchema(schemaName) {
             toISOString: () => sql `now()`,
         })),
     }, (table) => [
+        // Single column indexes
         index('idx_jobs_action_name').on(table.action_name),
         index('idx_jobs_status').on(table.status),
         index('idx_jobs_group_key').on(table.group_key),
@@ -35,8 +36,10 @@ export default function createSchema(schemaName) {
         index('idx_jobs_client_id').on(table.client_id),
         index('idx_jobs_checksum').on(table.checksum),
         index('idx_jobs_concurrency_limit').on(table.concurrency_limit),
+        // Composite indexes
         index('idx_jobs_action_status').on(table.action_name, table.status),
         index('idx_jobs_action_group').on(table.action_name, table.group_key),
+        // GIN indexes for full-text search
         index('idx_jobs_input_fts').using('gin', sql `to_tsvector('english', ${table.input}::text)`),
         index('idx_jobs_output_fts').using('gin', sql `to_tsvector('english', ${table.output}::text)`),
         check('jobs_status_check', sql `${table.status} IN ${sql.raw(`(${JOB_STATUSES.map((s) => `'${s}'`).join(',')})`)}`),
@@ -47,7 +50,7 @@ export default function createSchema(schemaName) {
             .notNull()
             .references(() => jobsTable.id, { onDelete: 'cascade' }),
         parent_step_id: uuid('parent_step_id'),
-        parallel: boolean('branch').notNull().default(false),
+        parallel: boolean('branch').notNull().default(false), // DB column is 'branch', TypeScript uses 'parallel'
         name: text('name').notNull(),
         status: text('status').$type().notNull().default(STEP_STATUS_ACTIVE),
         output: jsonb('output'),
@@ -71,14 +74,18 @@ export default function createSchema(schemaName) {
             toISOString: () => sql `now()`,
         })),
     }, (table) => [
+        // Single column indexes
         index('idx_job_steps_job_id').on(table.job_id),
         index('idx_job_steps_status').on(table.status),
         index('idx_job_steps_name').on(table.name),
         index('idx_job_steps_expires_at').on(table.expires_at),
         index('idx_job_steps_parent_step_id').on(table.parent_step_id),
+        // Composite indexes
         index('idx_job_steps_job_status').on(table.job_id, table.status),
         index('idx_job_steps_job_name').on(table.job_id, table.name),
         index('idx_job_steps_output_fts').using('gin', sql `to_tsvector('english', ${table.output}::text)`),
+        // Unique constraint - step name is unique within a parent (name + parentStepId)
+        // nullsNotDistinct ensures NULL parent_step_id values are treated as equal for uniqueness
         unique('unique_job_step_name_parent')
             .on(table.job_id, table.name, table.parent_step_id)
             .nullsNotDistinct(),
@@ -97,14 +104,17 @@ export default function createSchema(schemaName) {
         timestamp: timestamp('timestamp', { withTimezone: true }).notNull().defaultNow(),
         created_at: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
     }, (table) => [
+        // Single column indexes
         index('idx_metrics_job_id').on(table.job_id),
         index('idx_metrics_step_id').on(table.step_id),
         index('idx_metrics_name').on(table.name),
         index('idx_metrics_type').on(table.type),
         index('idx_metrics_timestamp').on(table.timestamp),
+        // Composite indexes
         index('idx_metrics_job_step').on(table.job_id, table.step_id),
         index('idx_metrics_job_name').on(table.job_id, table.name),
         index('idx_metrics_job_type').on(table.job_id, table.type),
+        // GIN index for JSONB attributes filtering
         index('idx_metrics_attributes').using('gin', table.attributes),
         check('metrics_type_check', sql `${table.type} IN ('metric', 'span_event', 'span_attribute')`),
     ]);

package/dist/adapters/schemas.d.ts

@@ -40,6 +40,7 @@ export declare const JobSchema: z.ZodObject<{
     updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<Date, number>>]>;
     concurrencyLimit: z.ZodCoercedNumber<unknown>;
     clientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    durationMs: z.ZodDefault<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
 }, z.core.$strip>;
 export declare const JobStepSchema: z.ZodObject<{
     id: z.ZodString;
@@ -119,6 +120,7 @@ export declare const JobSortFieldSchema: z.ZodEnum<{
     expiresAt: "expiresAt";
     startedAt: "startedAt";
     finishedAt: "finishedAt";
+    duration: "duration";
 }>;
 export declare const JobSortSchema: z.ZodObject<{
     field: z.ZodEnum<{
@@ -128,6 +130,7 @@ export declare const JobSortSchema: z.ZodObject<{
         expiresAt: "expiresAt";
         startedAt: "startedAt";
         finishedAt: "finishedAt";
+        duration: "duration";
     }>;
     order: z.ZodEnum<{
         asc: "asc";
@@ -195,6 +198,7 @@ export declare const GetJobsOptionsSchema: z.ZodObject<{
             expiresAt: "expiresAt";
             startedAt: "startedAt";
             finishedAt: "finishedAt";
+            duration: "duration";
         }>;
         order: z.ZodEnum<{
             asc: "asc";
@@ -208,6 +212,7 @@ export declare const GetJobsOptionsSchema: z.ZodObject<{
             expiresAt: "expiresAt";
             startedAt: "startedAt";
             finishedAt: "finishedAt";
+            duration: "duration";
         }>;
         order: z.ZodEnum<{
             asc: "asc";
@@ -289,6 +294,7 @@ export declare const DeleteJobsOptionsSchema: z.ZodOptional<z.ZodObject<{
             expiresAt: "expiresAt";
             startedAt: "startedAt";
             finishedAt: "finishedAt";
+            duration: "duration";
         }>;
         order: z.ZodEnum<{
             asc: "asc";
@@ -302,6 +308,7 @@ export declare const DeleteJobsOptionsSchema: z.ZodOptional<z.ZodObject<{
             expiresAt: "expiresAt";
             startedAt: "startedAt";
             finishedAt: "finishedAt";
+            duration: "duration";
         }>;
         order: z.ZodEnum<{
             asc: "asc";
@@ -377,6 +384,7 @@ export declare const JobsArrayResultSchema: z.ZodArray<z.ZodObject<{
     updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<Date, number>>]>;
     concurrencyLimit: z.ZodCoercedNumber<unknown>;
     clientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    durationMs: z.ZodDefault<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
 }, z.core.$strip>>;
 export declare const CreateOrRecoverJobStepResultNullableSchema: z.ZodUnion<readonly [z.ZodObject<{
     id: z.ZodString;
@@ -416,6 +424,7 @@ export declare const GetJobsResultSchema: z.ZodObject<{
         updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodString, z.ZodTransform<Date, string>>, z.ZodPipe<z.ZodNumber, z.ZodTransform<Date, number>>]>;
         concurrencyLimit: z.ZodCoercedNumber<unknown>;
         clientId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        durationMs: z.ZodDefault<z.ZodNullable<z.ZodCoercedNumber<unknown>>>;
     }, z.core.$strip>>;
     total: z.ZodNumber;
     page: z.ZodNumber;

package/dist/adapters/schemas.d.ts.map

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

package/dist/adapters/schemas.js

@@ -1,7 +1,13 @@
 import { z } from 'zod';
 import { JOB_STATUSES, STEP_STATUSES } from '../constants.js';
+// ============================================================================
+// Status Enums
+// ============================================================================
 export const JobStatusSchema = z.enum(JOB_STATUSES);
 export const StepStatusSchema = z.enum(STEP_STATUSES);
+// ============================================================================
+// Date Schema
+// ============================================================================
 const DateSchema = z.union([
     z.date(),
     z.string().transform((str) => new Date(str)),
@@ -13,6 +19,9 @@ export const SerializableErrorSchema = z.object({
     cause: z.any().optional(),
     stack: z.string().optional(),
 });
+// ============================================================================
+// Job Schema
+// ============================================================================
 export const JobSchema = z.object({
     id: z.string(),
     actionName: z.string(),
@@ -29,7 +38,12 @@ export const JobSchema = z.object({
     updatedAt: DateSchema,
     concurrencyLimit: z.coerce.number(),
     clientId: z.string().nullable().optional(),
+    /** Duration in milliseconds (finishedAt - startedAt). Null if job hasn't finished. */
+    durationMs: z.coerce.number().nullable().default(null),
 });
+// ============================================================================
+// JobStep Schema
+// ============================================================================
 export const JobStepSchema = z.object({
     id: z.string(),
     jobId: z.string(),
@@ -50,9 +64,21 @@ export const JobStepSchema = z.object({
     createdAt: DateSchema,
     updatedAt: DateSchema,
 });
+// JobStep without output (for getJobSteps)
 export const JobStepWithoutOutputSchema = JobStepSchema.omit({ output: true });
+// ============================================================================
+// Query Option Schemas
+// ============================================================================
 export const SortOrderSchema = z.enum(['asc', 'desc']);
-export const JobSortFieldSchema = z.enum(['createdAt', 'startedAt', 'finishedAt', 'status', 'actionName', 'expiresAt']);
+export const JobSortFieldSchema = z.enum([
+    'createdAt',
+    'startedAt',
+    'finishedAt',
+    'status',
+    'actionName',
+    'expiresAt',
+    'duration',
+]);
 export const JobSortSchema = z.object({
     field: JobSortFieldSchema,
     order: SortOrderSchema,
@@ -81,66 +107,105 @@ export const GetJobStepsOptionsSchema = z.object({
     search: z.string().optional(),
     updatedAfter: DateSchema.optional(),
 });
+// ============================================================================
+// Job Option Schemas
+// ============================================================================
 export const CreateJobOptionsSchema = z.object({
+    /** The queue name (action name) */
     queue: z.string(),
+    /** The group key for concurrency control */
     groupKey: z.string(),
+    /** The checksum of the action */
     checksum: z.string(),
+    /** The job input data */
     input: z.any(),
+    /** Timeout in milliseconds for the job */
     timeoutMs: z.number(),
+    /** The concurrency limit for this job's group */
     concurrencyLimit: z.number(),
 });
 export const RecoverJobsOptionsSchema = z.object({
+    /** The action checksums to recover jobs for */
     checksums: z.array(z.string()),
+    /** Whether to ping other processes before recovering their jobs */
     multiProcessMode: z.boolean().optional(),
+    /** Timeout in milliseconds to wait for process ping responses */
     processTimeout: z.number().optional(),
 });
 export const FetchOptionsSchema = z.object({
+    /** Maximum number of jobs to fetch in this batch */
     batch: z.number(),
 });
 export const CompleteJobOptionsSchema = z.object({
+    /** The ID of the job to complete */
     jobId: z.string(),
+    /** The job output data */
     output: z.any(),
 });
 export const FailJobOptionsSchema = z.object({
+    /** The ID of the job to fail */
     jobId: z.string(),
+    /** The error data */
     error: z.any(),
 });
 export const CancelJobOptionsSchema = z.object({
+    /** The ID of the job to cancel */
     jobId: z.string(),
 });
 export const RetryJobOptionsSchema = z.object({
+    /** The ID of the job to retry */
     jobId: z.string(),
 });
 export const DeleteJobOptionsSchema = z.object({
+    /** The ID of the job to delete */
     jobId: z.string(),
 });
 export const DeleteJobsOptionsSchema = GetJobsOptionsSchema.optional();
 export const TimeTravelJobOptionsSchema = z.object({
+    /** The ID of the job to time travel */
     jobId: z.string(),
+    /** The ID of the step to restart from */
     stepId: z.string(),
 });
+// ============================================================================
+// Step Option Schemas
+// ============================================================================
 export const CreateOrRecoverJobStepOptionsSchema = z.object({
+    /** The ID of the job this step belongs to */
     jobId: z.string(),
+    /** The ID of the parent step (null for root steps) */
     parentStepId: z.string().nullable().default(null),
+    /** Whether this step runs in parallel (independent from siblings during time travel) */
     parallel: z.boolean().default(false),
+    /** The name of the step */
     name: z.string(),
+    /** Timeout in milliseconds for the step */
     timeoutMs: z.number(),
+    /** Maximum number of retries for the step */
     retriesLimit: z.number(),
 });
 export const CompleteJobStepOptionsSchema = z.object({
+    /** The ID of the step to complete */
     stepId: z.string(),
+    /** The step output data */
     output: z.any(),
 });
 export const FailJobStepOptionsSchema = z.object({
+    /** The ID of the step to fail */
     stepId: z.string(),
+    /** The error data */
     error: z.any(),
 });
 export const DelayJobStepOptionsSchema = z.object({
+    /** The ID of the step to delay */
     stepId: z.string(),
+    /** The delay in milliseconds */
     delayMs: z.number(),
+    /** The error data */
     error: z.any(),
 });
 export const CancelJobStepOptionsSchema = z.object({
+    /** The ID of the step to cancel */
     stepId: z.string(),
 });
 export const CreateOrRecoverJobStepResultSchema = z.object({
@@ -153,6 +218,10 @@ export const CreateOrRecoverJobStepResultSchema = z.object({
     output: z.any().nullable(),
     isNew: z.boolean(),
 });
+// ============================================================================
+// Response Schemas
+// ============================================================================
+// Simple response schemas
 export const JobIdResultSchema = z.union([z.string(), z.null()]);
 export const BooleanResultSchema = z.boolean();
 export const NumberResultSchema = z.number();
@@ -187,6 +256,9 @@ export const JobStepStatusResultSchema = z.object({
     status: StepStatusSchema,
     updatedAt: DateSchema,
 });
+// ============================================================================
+// Metrics Schemas
+// ============================================================================
 export const MetricTypeSchema = z.enum(['metric', 'span_event', 'span_attribute']);
 export const MetricSchema = z.object({
     id: z.string(),