pg-workflows 0.11.0 → 0.12.0

package/README.md

@@ -154,6 +154,49 @@ See [runnable examples](https://github.com/SokratisVidros/pg-workflows/tree/main
 - **[Examples](docs/examples.md)** - conditional steps, batch loops, scheduled reminders, retries, monitoring
 - **[API Reference](docs/api-reference.md)** - `WorkflowEngine`, `WorkflowClient`, `WorkflowRef`, types
 - **[Configuration](docs/configuration.md)** - env vars, database setup, requirements
+- **[Observability](docs/observability.md)** - OpenTelemetry tracing via `otelPlugin`
+
+---
+
+## Observability with OpenTelemetry
+
+pg-workflows ships a first-party plugin that emits OTel spans for workflow and step execution. `@opentelemetry/api` is an optional peer dependency — install it only if you want tracing.
+
+```bash
+npm install @opentelemetry/api @opentelemetry/sdk-node
+```
+
+```ts
+import { NodeSDK } from '@opentelemetry/sdk-node'
+import { trace } from '@opentelemetry/api'
+import { workflow, otelPlugin } from 'pg-workflows'
+
+// Initialize your OTel SDK however you normally do — for Node apps the
+// NodeSDK registers an AsyncHooks context manager, which is required for
+// hierarchical (parent/child) spans across async boundaries.
+new NodeSDK({ /* exporters, resource, ... */ }).start()
+
+const tracedWorkflow = workflow.use(otelPlugin())
+
+const myWorkflow = tracedWorkflow('checkout', async ({ step }) => {
+  await step.run('charge', async () => { /* ... */ })
+  await step.waitFor('await-shipment', { eventName: 'shipped' })
+})
+```
+
+The plugin emits a `pg_workflows.workflow.run` span per worker execution (one per resume cycle), with child spans per step kind (`pg_workflows.step.run`, `pg_workflows.step.waitFor`, etc.). Spans carry `workflow.id`, `workflow.run_id`, `workflow.attempt` and, where set, `workflow.resource_id`. Steps replayed from cache after a pause emit no spans.
+
+**Options:**
+
+```ts
+otelPlugin({
+  tracer: trace.getTracer('my-app'),                // default: trace.getTracer('pg-workflows')
+  spanNamePrefix: 'pg_workflows',                   // default shown
+  attributes: (ctx) => ({ tenant: ctx.resourceId }), // extra static attrs on workflow.run
+})
+```
+
+Metrics, distributed trace context propagation across child workflows, and HTTP-caller context propagation are not in v1 — see [the observability docs](docs/observability.md#not-in-v1) for the deferral rationale.
 
 ---
 

package/dist/client.entry.d.cts

@@ -117,7 +117,13 @@ interface WorkflowPlugin<
 	TStepExt = object
 > {
 	name: string;
-	methods: (step: TStepBase) => TStepExt;
+	methods: (step: TStepBase, context: WorkflowContext) => TStepExt;
+	/**
+	* Optional middleware around the workflow handler call. Composes in
+	* registration order — the first plugin passed to `.use()` wraps everything
+	* inside. Implementations MUST call `next()` exactly once.
+	*/
+	wrap?: (context: WorkflowContext, next: () => Promise<unknown>) => Promise<unknown>;
 }
 type WorkflowContext<
 	TInput extends InputParameters = InputParameters,
@@ -127,6 +133,10 @@ type WorkflowContext<
 	step: TStep;
 	workflowId: string;
 	runId: string;
+	/** Tenant/scope identifier set when the run was started, if any. */
+	resourceId?: string;
+	/** Zero-based retry attempt number (= `run.retryCount`). */
+	attempt: number;
 	timeline: Record<string, unknown>;
 	logger: WorkflowLogger;
 };

package/dist/client.entry.d.ts

@@ -117,7 +117,13 @@ interface WorkflowPlugin<
 	TStepExt = object
 > {
 	name: string;
-	methods: (step: TStepBase) => TStepExt;
+	methods: (step: TStepBase, context: WorkflowContext) => TStepExt;
+	/**
+	* Optional middleware around the workflow handler call. Composes in
+	* registration order — the first plugin passed to `.use()` wraps everything
+	* inside. Implementations MUST call `next()` exactly once.
+	*/
+	wrap?: (context: WorkflowContext, next: () => Promise<unknown>) => Promise<unknown>;
 }
 type WorkflowContext<
 	TInput extends InputParameters = InputParameters,
@@ -127,6 +133,10 @@ type WorkflowContext<
 	step: TStep;
 	workflowId: string;
 	runId: string;
+	/** Tenant/scope identifier set when the run was started, if any. */
+	resourceId?: string;
+	/** Zero-based retry attempt number (= `run.retryCount`). */
+	attempt: number;
 	timeline: Record<string, unknown>;
 	logger: WorkflowLogger;
 };

package/dist/client.entry.js.map

@@ -7,7 +7,7 @@
     "import type { Db } from 'pg-boss';\n\n// Arbitrary but stable lock ID for serializing migrations across processes\nexport const MIGRATION_LOCK_ID = 738291645;\n\n// Bump this when adding new migrations. The engine stores the current version\n// in a `workflow_schema_version` table so migrations only run once per version.\nconst CURRENT_SCHEMA_VERSION = 4;\n\nexport async function runMigrations(db: Db): Promise<void> {\n  // Fast path: skip the advisory lock if schema is already current.\n  // This is the common case - every engine.start() after initial setup.\n  if (await isSchemaUpToDate(db)) {\n    return;\n  }\n\n  // Slow path: build migration SQL based on current version, then execute\n  // everything in a single transaction with an advisory lock.\n  // This mirrors pg-boss's approach: one executeSql call ensures all DDL\n  // runs on a single connection inside BEGIN/COMMIT, and pg_advisory_xact_lock\n  // auto-releases on commit or rollback (no manual unlock needed).\n  const currentVersion = await getCurrentVersion(db);\n\n  const commands: string[] = [];\n\n  if (currentVersion < 1) {\n    commands.push(`\n      CREATE TABLE IF NOT EXISTS workflow_runs (\n        id varchar(32) PRIMARY KEY NOT NULL,\n        created_at timestamp with time zone DEFAULT now() NOT NULL,\n        updated_at timestamp with time zone DEFAULT now() NOT NULL,\n        resource_id varchar(256),\n        workflow_id varchar(256) NOT NULL,\n        status text DEFAULT 'pending' NOT NULL,\n        input jsonb NOT NULL,\n        output jsonb,\n        error text,\n        current_step_id varchar(256) NOT NULL,\n        timeline jsonb DEFAULT '{}'::jsonb NOT NULL,\n        paused_at timestamp with time zone,\n        resumed_at timestamp with time zone,\n        completed_at timestamp with time zone,\n        timeout_at timestamp with time zone,\n        retry_count integer DEFAULT 0 NOT NULL,\n        max_retries integer DEFAULT 0 NOT NULL,\n        job_id varchar(256)\n      )\n    `);\n    commands.push(`\n      CREATE INDEX IF NOT EXISTS workflow_runs_created_at_idx ON workflow_runs USING btree (created_at)\n    `);\n    commands.push(`\n      CREATE INDEX IF NOT EXISTS workflow_runs_resource_id_created_at_idx ON workflow_runs USING btree (resource_id, created_at DESC)\n    `);\n    commands.push(`\n      CREATE INDEX IF NOT EXISTS workflow_runs_status_created_at_idx ON workflow_runs USING btree (status, created_at DESC)\n    `);\n    commands.push(`\n      CREATE INDEX IF NOT EXISTS workflow_runs_workflow_id_created_at_idx ON workflow_runs USING btree (workflow_id, created_at DESC)\n    `);\n    commands.push(`\n      CREATE INDEX IF NOT EXISTS workflow_runs_resource_id_workflow_id_created_at_idx ON workflow_runs USING btree (resource_id, workflow_id, created_at DESC)\n    `);\n  }\n\n  if (currentVersion < 2) {\n    commands.push('DROP INDEX IF EXISTS workflow_runs_workflow_id_idx');\n    commands.push('DROP INDEX IF EXISTS workflow_runs_resource_id_idx');\n    commands.push(\n      'ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS idempotency_key varchar(256)',\n    );\n    commands.push(`\n      CREATE UNIQUE INDEX IF NOT EXISTS workflow_runs_idempotency_key_idx ON workflow_runs (idempotency_key) WHERE idempotency_key IS NOT NULL\n    `);\n  }\n\n  if (currentVersion < 3) {\n    commands.push('ALTER TABLE workflow_runs ALTER COLUMN resource_id TYPE varchar(256)');\n    commands.push('ALTER TABLE workflow_runs ALTER COLUMN workflow_id TYPE varchar(256)');\n  }\n\n  if (currentVersion < 4) {\n    commands.push('ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS parent_run_id varchar(32)');\n    commands.push('ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS parent_step_id varchar(256)');\n    commands.push(\n      'ALTER TABLE workflow_runs ADD COLUMN IF NOT EXISTS parent_resource_id varchar(256)',\n    );\n  }\n\n  // Upsert the schema version\n  if (currentVersion === 0) {\n    commands.push(\n      `INSERT INTO workflow_schema_version (version) VALUES (${CURRENT_SCHEMA_VERSION})`,\n    );\n  } else {\n    commands.push(`UPDATE workflow_schema_version SET version = ${CURRENT_SCHEMA_VERSION}`);\n  }\n\n  if (commands.length === 0) {\n    return;\n  }\n\n  const sql = [\n    'BEGIN',\n    \"SET LOCAL lock_timeout = '30s'\",\n    \"SET LOCAL idle_in_transaction_session_timeout = '30s'\",\n    `SELECT pg_advisory_xact_lock(${MIGRATION_LOCK_ID})`,\n    'CREATE TABLE IF NOT EXISTS workflow_schema_version (version integer NOT NULL)',\n    ...commands,\n    'COMMIT',\n  ].join(';\\n');\n\n  await db.executeSql(sql, []);\n}\n\nasync function isSchemaUpToDate(db: Db): Promise<boolean> {\n  try {\n    const result = await db.executeSql('SELECT version FROM workflow_schema_version LIMIT 1', []);\n    return (\n      ((result.rows[0] as { version: number } | undefined)?.version ?? 0) >= CURRENT_SCHEMA_VERSION\n    );\n  } catch {\n    // Table doesn't exist yet - needs migration\n    return false;\n  }\n}\n\nasync function getCurrentVersion(db: Db): Promise<number> {\n  try {\n    const result = await db.executeSql('SELECT version FROM workflow_schema_version LIMIT 1', []);\n    return (result.rows[0] as { version: number } | undefined)?.version ?? 0;\n  } catch {\n    return 0;\n  }\n}\n",
     "import ksuid from 'ksuid';\nimport type { Db } from 'pg-boss';\nimport type { WorkflowRun } from './types';\n\nexport function generateKSUID(prefix?: string): string {\n  return `${prefix ? `${prefix}_` : ''}${ksuid.randomSync().string}`;\n}\n\ntype WorkflowRunRow = {\n  id: string;\n  created_at: string | Date;\n  updated_at: string | Date;\n  resource_id: string | null;\n  workflow_id: string;\n  status: 'pending' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';\n  input: string | unknown;\n  output: string | unknown | null;\n  error: string | null;\n  current_step_id: string;\n  timeline: string | Record<string, unknown>;\n  paused_at: string | Date | null;\n  resumed_at: string | Date | null;\n  completed_at: string | Date | null;\n  timeout_at: string | Date | null;\n  retry_count: number;\n  max_retries: number;\n  job_id: string | null;\n  idempotency_key: string | null;\n  parent_run_id: string | null;\n  parent_step_id: string | null;\n  parent_resource_id: string | null;\n};\n\nfunction mapRowToWorkflowRun(row: WorkflowRunRow): WorkflowRun {\n  return {\n    id: row.id,\n    createdAt: new Date(row.created_at),\n    updatedAt: new Date(row.updated_at),\n    resourceId: row.resource_id,\n    workflowId: row.workflow_id,\n    status: row.status,\n    input: typeof row.input === 'string' ? JSON.parse(row.input) : row.input,\n    output:\n      typeof row.output === 'string'\n        ? row.output.trim().startsWith('{') || row.output.trim().startsWith('[')\n          ? JSON.parse(row.output)\n          : row.output\n        : (row.output ?? null),\n    error: row.error,\n    currentStepId: row.current_step_id,\n    timeline: typeof row.timeline === 'string' ? JSON.parse(row.timeline) : row.timeline,\n    pausedAt: row.paused_at ? new Date(row.paused_at) : null,\n    resumedAt: row.resumed_at ? new Date(row.resumed_at) : null,\n    completedAt: row.completed_at ? new Date(row.completed_at) : null,\n    timeoutAt: row.timeout_at ? new Date(row.timeout_at) : null,\n    retryCount: row.retry_count,\n    maxRetries: row.max_retries,\n    jobId: row.job_id,\n    idempotencyKey: row.idempotency_key,\n    parentRunId: row.parent_run_id,\n    parentStepId: row.parent_step_id,\n    parentResourceId: row.parent_resource_id,\n  };\n}\n\nexport async function insertWorkflowRun(\n  {\n    resourceId,\n    workflowId,\n    currentStepId,\n    status,\n    input,\n    maxRetries,\n    timeoutAt,\n    idempotencyKey,\n    parentRunId,\n    parentStepId,\n    parentResourceId,\n  }: {\n    resourceId?: string;\n    workflowId: string;\n    currentStepId: string;\n    status: string;\n    input: unknown;\n    maxRetries: number;\n    timeoutAt: Date | null;\n    idempotencyKey?: string;\n    parentRunId?: string;\n    parentStepId?: string;\n    parentResourceId?: string;\n  },\n  db: Db,\n): Promise<{ run: WorkflowRun; created: boolean }> {\n  const runId = generateKSUID('run');\n  const now = new Date();\n\n  const result = await db.executeSql(\n    `INSERT INTO workflow_runs (\n      id,\n      resource_id,\n      workflow_id,\n      current_step_id,\n      status,\n      input,\n      max_retries,\n      timeout_at,\n      created_at,\n      updated_at,\n      timeline,\n      retry_count,\n      idempotency_key,\n      parent_run_id,\n      parent_step_id,\n      parent_resource_id\n    )\n    VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16)\n    ON CONFLICT (idempotency_key) WHERE idempotency_key IS NOT NULL DO NOTHING\n    RETURNING *`,\n    [\n      runId,\n      resourceId ?? null,\n      workflowId,\n      currentStepId,\n      status,\n      JSON.stringify(input),\n      maxRetries,\n      timeoutAt,\n      now,\n      now,\n      '{}',\n      0,\n      idempotencyKey ?? null,\n      parentRunId ?? null,\n      parentStepId ?? null,\n      parentResourceId ?? null,\n    ],\n  );\n\n  if (result.rows[0]) {\n    return { run: mapRowToWorkflowRun(result.rows[0]), created: true };\n  }\n\n  // Conflict - fetch the existing row\n  const existing = await db.executeSql('SELECT * FROM workflow_runs WHERE idempotency_key = $1', [\n    idempotencyKey,\n  ]);\n\n  if (!existing.rows[0]) {\n    throw new Error(`Idempotency conflict: existing run not found for key \"${idempotencyKey}\"`);\n  }\n\n  return { run: mapRowToWorkflowRun(existing.rows[0]), created: false };\n}\n\nexport async function getWorkflowRun(\n  {\n    runId,\n    resourceId,\n  }: {\n    runId: string;\n    resourceId?: string;\n  },\n  { exclusiveLock = false, db }: { exclusiveLock?: boolean; db: Db },\n): Promise<WorkflowRun | null> {\n  const lockSuffix = exclusiveLock ? 'FOR UPDATE' : '';\n\n  const result = resourceId\n    ? await db.executeSql(\n        `SELECT * FROM workflow_runs \n        WHERE id = $1 AND resource_id = $2\n        ${lockSuffix}`,\n        [runId, resourceId],\n      )\n    : await db.executeSql(\n        `SELECT * FROM workflow_runs \n        WHERE id = $1\n        ${lockSuffix}`,\n        [runId],\n      );\n\n  const run = result.rows[0];\n\n  if (!run) {\n    return null;\n  }\n\n  return mapRowToWorkflowRun(run);\n}\n\nexport async function updateWorkflowRun(\n  {\n    runId,\n    resourceId,\n    data,\n    expectedStatuses,\n  }: {\n    runId: string;\n    resourceId?: string;\n    data: Partial<WorkflowRun>;\n    expectedStatuses?: string[];\n  },\n  db: Db,\n): Promise<WorkflowRun | null> {\n  const now = new Date();\n\n  const updates: string[] = ['updated_at = $1'];\n  const values: (string | number | Date | null | string[])[] = [now];\n  let paramIndex = 2;\n\n  if (data.status !== undefined) {\n    updates.push(`status = $${paramIndex}`);\n    values.push(data.status);\n    paramIndex++;\n  }\n  if (data.currentStepId !== undefined) {\n    updates.push(`current_step_id = $${paramIndex}`);\n    values.push(data.currentStepId);\n    paramIndex++;\n  }\n  if (data.timeline !== undefined) {\n    updates.push(`timeline = $${paramIndex}`);\n    values.push(JSON.stringify(data.timeline));\n    paramIndex++;\n  }\n  if (data.pausedAt !== undefined) {\n    updates.push(`paused_at = $${paramIndex}`);\n    values.push(data.pausedAt);\n    paramIndex++;\n  }\n  if (data.resumedAt !== undefined) {\n    updates.push(`resumed_at = $${paramIndex}`);\n    values.push(data.resumedAt);\n    paramIndex++;\n  }\n  if (data.completedAt !== undefined) {\n    updates.push(`completed_at = $${paramIndex}`);\n    values.push(data.completedAt);\n    paramIndex++;\n  }\n  if (data.output !== undefined) {\n    updates.push(`output = $${paramIndex}`);\n    values.push(JSON.stringify(data.output));\n    paramIndex++;\n  }\n  if (data.error !== undefined) {\n    updates.push(`error = $${paramIndex}`);\n    values.push(data.error);\n    paramIndex++;\n  }\n  if (data.retryCount !== undefined) {\n    updates.push(`retry_count = $${paramIndex}`);\n    values.push(data.retryCount);\n    paramIndex++;\n  }\n  if (data.jobId !== undefined) {\n    updates.push(`job_id = $${paramIndex}`);\n    values.push(data.jobId);\n    paramIndex++;\n  }\n\n  values.push(runId);\n  const idParam = paramIndex;\n  paramIndex++;\n\n  if (resourceId) {\n    values.push(resourceId);\n    paramIndex++;\n  }\n\n  if (expectedStatuses && expectedStatuses.length > 0) {\n    values.push(expectedStatuses);\n    paramIndex++;\n  }\n\n  let whereClause = resourceId\n    ? `WHERE id = $${idParam} AND resource_id = $${idParam + 1}`\n    : `WHERE id = $${idParam}`;\n\n  if (expectedStatuses && expectedStatuses.length > 0) {\n    whereClause += ` AND status = ANY($${paramIndex - 1})`;\n  }\n\n  const query = `\n    UPDATE workflow_runs \n    SET ${updates.join(', ')}\n    ${whereClause}\n    RETURNING *\n  `;\n\n  const result = await db.executeSql(query, values);\n  const run = result.rows[0];\n\n  if (!run) {\n    return null;\n  }\n\n  return mapRowToWorkflowRun(run);\n}\n\nexport async function getWorkflowRuns(\n  {\n    resourceId,\n    startingAfter,\n    endingBefore,\n    limit = 20,\n    statuses,\n    workflowId,\n  }: {\n    resourceId?: string;\n    startingAfter?: string | null;\n    endingBefore?: string | null;\n    limit?: number;\n    statuses?: string[];\n    workflowId?: string;\n  },\n  db: Db,\n): Promise<{\n  items: WorkflowRun[];\n  nextCursor: string | null;\n  prevCursor: string | null;\n  hasMore: boolean;\n  hasPrev: boolean;\n}> {\n  const conditions: string[] = [];\n  const values: (string | number | string[] | Date)[] = [];\n  let paramIndex = 1;\n\n  if (resourceId) {\n    conditions.push(`resource_id = $${paramIndex}`);\n    values.push(resourceId);\n    paramIndex++;\n  }\n\n  if (statuses && statuses.length > 0) {\n    conditions.push(`status = ANY($${paramIndex})`);\n    values.push(statuses);\n    paramIndex++;\n  }\n\n  if (workflowId) {\n    conditions.push(`workflow_id = $${paramIndex}`);\n    values.push(workflowId);\n    paramIndex++;\n  }\n\n  const cursorIds = [startingAfter, endingBefore].filter(Boolean) as string[];\n  if (cursorIds.length > 0) {\n    const cursorResult = await db.executeSql(\n      'SELECT id, created_at FROM workflow_runs WHERE id = ANY($1)',\n      [cursorIds],\n    );\n    const cursorMap = new Map<string, Date>();\n    for (const row of cursorResult.rows) {\n      cursorMap.set(\n        row.id,\n        typeof row.created_at === 'string' ? new Date(row.created_at) : row.created_at,\n      );\n    }\n\n    if (startingAfter) {\n      const cursor = cursorMap.get(startingAfter);\n      if (cursor) {\n        conditions.push(`created_at < $${paramIndex}`);\n        values.push(cursor);\n        paramIndex++;\n      }\n    }\n\n    if (endingBefore) {\n      const cursor = cursorMap.get(endingBefore);\n      if (cursor) {\n        conditions.push(`created_at > $${paramIndex}`);\n        values.push(cursor);\n        paramIndex++;\n      }\n    }\n  }\n\n  const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';\n  const actualLimit = Math.min(Math.max(limit, 1), 100) + 1;\n\n  const isBackward = !!endingBefore && !startingAfter;\n\n  const query = `\n    SELECT * FROM workflow_runs\n    ${whereClause}\n    ORDER BY created_at ${isBackward ? 'ASC' : 'DESC'}\n    LIMIT $${paramIndex}\n  `;\n  values.push(actualLimit);\n\n  const result = await db.executeSql(query, values);\n  const rows = result.rows;\n\n  const hasExtraRow = rows.length > (limit ?? 20);\n  const rawItems = hasExtraRow ? rows.slice(0, limit) : rows;\n\n  if (isBackward) {\n    rawItems.reverse();\n  }\n\n  const items = rawItems.map((row) => mapRowToWorkflowRun(row));\n\n  const hasMore = isBackward ? items.length > 0 : hasExtraRow;\n  const hasPrev = isBackward ? hasExtraRow : !!startingAfter && items.length > 0;\n\n  const nextCursor = hasMore && items.length > 0 ? (items[items.length - 1]?.id ?? null) : null;\n  const prevCursor = hasPrev && items.length > 0 ? (items[0]?.id ?? null) : null;\n\n  return { items, nextCursor, prevCursor, hasMore, hasPrev };\n}\n\n/**\n * Run a callback inside a PostgreSQL transaction using a dedicated client.\n *\n * When a `pool` is provided, a dedicated client is checked out so that\n * BEGIN / COMMIT / ROLLBACK all execute on the **same** connection.\n * This is critical for `SELECT … FOR UPDATE` locks and any work that\n * yields to the event-loop inside the transaction (e.g. async step handlers).\n *\n * Falls back to the pg-boss `Db` adapter when no pool is given (unit-test path).\n */\nexport async function withPostgresTransaction<T>(\n  db: Db,\n  callback: (db: Db) => Promise<T>,\n  pool?: {\n    connect: () => Promise<{\n      query: (text: string, values?: unknown[]) => Promise<unknown>;\n      release: () => void;\n    }>;\n  },\n): Promise<T> {\n  let txDb: Db;\n  let release: (() => void) | undefined;\n\n  if (pool) {\n    const client = await pool.connect();\n    txDb = {\n      executeSql: (text: string, values?: unknown[]) =>\n        client.query(text, values) as Promise<{ rows: unknown[] }>,\n    };\n    release = () => client.release();\n  } else {\n    txDb = db;\n  }\n\n  try {\n    await txDb.executeSql('BEGIN', []);\n    const result = await callback(txDb);\n    await txDb.executeSql('COMMIT', []);\n    return result;\n  } catch (error) {\n    await txDb.executeSql('ROLLBACK', []);\n    throw error;\n  } finally {\n    release?.();\n  }\n}\n",
     "import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { MAX_RESOURCE_ID_LENGTH, MAX_WORKFLOW_ID_LENGTH } from './constants';\n\nexport function validateWorkflowId(workflowId: string): void {\n  if (workflowId.length > MAX_WORKFLOW_ID_LENGTH) {\n    throw new WorkflowEngineError(\n      `workflowId exceeds maximum length of ${MAX_WORKFLOW_ID_LENGTH} characters (got ${workflowId.length})`,\n      workflowId,\n    );\n  }\n}\n\nexport function validateResourceId(resourceId: string | undefined | null): void {\n  if (resourceId != null && resourceId.length > MAX_RESOURCE_ID_LENGTH) {\n    throw new WorkflowEngineError(\n      `resourceId exceeds maximum length of ${MAX_RESOURCE_ID_LENGTH} characters (got ${resourceId.length})`,\n    );\n  }\n}\n\nexport class WorkflowEngineError extends Error {\n  constructor(\n    message: string,\n    public readonly workflowId?: string,\n    public readonly runId?: string,\n    public override readonly cause: Error | undefined = undefined,\n    public readonly issues?: StandardSchemaV1.FailureResult['issues'] | undefined,\n  ) {\n    super(message);\n    this.name = 'WorkflowEngineError';\n\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, WorkflowEngineError);\n    }\n  }\n}\n\nexport class WorkflowRunNotFoundError extends WorkflowEngineError {\n  constructor(runId?: string, workflowId?: string) {\n    super('Workflow run not found', workflowId, runId);\n    this.name = 'WorkflowRunNotFoundError';\n  }\n}\n",
-    "import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { WorkflowRun } from './db/types';\nimport type { Duration } from './duration';\n\nexport enum WorkflowStatus {\n  PENDING = 'pending',\n  RUNNING = 'running',\n  PAUSED = 'paused',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  CANCELLED = 'cancelled',\n}\n\nexport enum StepType {\n  PAUSE = 'pause',\n  RUN = 'run',\n  WAIT_FOR = 'waitFor',\n  WAIT_UNTIL = 'waitUntil',\n  DELAY = 'delay',\n  POLL = 'poll',\n  INVOKE_CHILD_WORKFLOW = 'invokeChildWorkflow',\n}\n\nexport type InputParameters = StandardSchemaV1;\nexport type InferInputParameters<P extends InputParameters> = StandardSchemaV1.InferOutput<P>;\n\nexport type StartWorkflowOptions = {\n  resourceId?: string;\n  timeout?: number;\n  retries?: number;\n  expireInSeconds?: number;\n  idempotencyKey?: string;\n};\n\nexport type WorkflowOptions<I extends InputParameters> = {\n  timeout?: number;\n  retries?: number;\n  inputSchema?: I;\n};\n\nexport type StepBaseContext = {\n  run: <T>(stepId: string, handler: () => Promise<T>) => Promise<T>;\n  waitFor: {\n    <T extends InputParameters>(\n      stepId: string,\n      options: { eventName: string; schema?: T },\n    ): Promise<InferInputParameters<T>>;\n    <T extends InputParameters>(\n      stepId: string,\n      options: { eventName: string; timeout: number; schema?: T },\n    ): Promise<InferInputParameters<T> | undefined>;\n  };\n  waitUntil: {\n    (stepId: string, date: Date): Promise<void>;\n    (stepId: string, dateString: string): Promise<void>;\n    (stepId: string, options: { date: Date | string }): Promise<void>;\n  };\n  /** Delay execution for a duration (sugar over waitUntil). Alias: sleep. */\n  delay: (stepId: string, duration: Duration) => Promise<void>;\n  /** Alias for delay. */\n  sleep: (stepId: string, duration: Duration) => Promise<void>;\n  pause: (stepId: string) => Promise<void>;\n  poll: <T>(\n    stepId: string,\n    conditionFn: () => Promise<T | false>,\n    options?: { interval?: Duration; timeout?: Duration },\n  ) => Promise<{ timedOut: false; data: T } | { timedOut: true }>;\n  /**\n   * Invoke a child workflow from inside the current workflow and pause until\n   * the child run reaches a terminal state.\n   */\n  invokeChildWorkflow: {\n    <TInput extends InputParameters, TOutput = unknown>(\n      stepId: string,\n      ref: WorkflowRef<TInput, TOutput>,\n      input: InferInputParameters<TInput>,\n      options?: StartWorkflowOptions,\n    ): Promise<TOutput>;\n    <TOutput = unknown>(\n      stepId: string,\n      params: {\n        workflowId: string;\n        input: unknown;\n        resourceId?: string;\n        idempotencyKey?: string;\n        options?: StartWorkflowOptions;\n      },\n    ): Promise<TOutput>;\n  };\n};\n\n/**\n * Plugin that extends the workflow step API with extra methods.\n * @template TStepBase - The step type this plugin receives (base + previous plugins).\n * @template TStepExt - The extra methods this plugin adds to step.\n */\nexport interface WorkflowPlugin<TStepBase = StepBaseContext, TStepExt = object> {\n  name: string;\n  methods: (step: TStepBase) => TStepExt;\n}\n\nexport type WorkflowContext<\n  TInput extends InputParameters = InputParameters,\n  TStep extends StepBaseContext = StepBaseContext,\n> = {\n  input: InferInputParameters<TInput>;\n  step: TStep;\n  workflowId: string;\n  runId: string;\n  timeline: Record<string, unknown>;\n  logger: WorkflowLogger;\n};\n\nexport type WorkflowDefinition<TInput extends InputParameters = InputParameters> = {\n  id: string;\n  /** Widest context avoids contravariance when collecting definitions; `workflow()` still types the handler narrowly. */\n  handler: (context: WorkflowContext<InputParameters, StepBaseContext>) => Promise<unknown>;\n  inputSchema?: TInput;\n  timeout?: number; // milliseconds\n  retries?: number;\n  plugins?: WorkflowPlugin[];\n};\n\nexport type StepInternalDefinition = {\n  id: string;\n  type: StepType;\n  conditional: boolean;\n  loop: boolean;\n  isDynamic: boolean;\n};\n\nexport type WorkflowInternalDefinition<TInput extends InputParameters = InputParameters> =\n  WorkflowDefinition<TInput> & {\n    steps: StepInternalDefinition[];\n  };\n\n/**\n * Chainable workflow factory: call as (id, handler, options) and/or use .use(plugin).\n * TStepExt is the accumulated step extension from all plugins (step = StepContext & TStepExt).\n */\nexport interface WorkflowFactory<TStepExt = object> {\n  <I extends InputParameters = InputParameters>(\n    id: string,\n    handler: (context: WorkflowContext<I, StepBaseContext & TStepExt>) => Promise<unknown>,\n    options?: WorkflowOptions<I>,\n  ): WorkflowDefinition<I>;\n  use<TNewExt>(\n    plugin: WorkflowPlugin<StepBaseContext & TStepExt, TNewExt>,\n  ): WorkflowFactory<TStepExt & TNewExt>;\n  ref<TInput extends InputParameters = InputParameters, TOutput = unknown>(\n    id: string,\n    options?: { inputSchema?: TInput },\n  ): WorkflowRef<TInput, TOutput>;\n}\n\n/**\n * Lightweight workflow reference - carries the workflow ID and input type\n * but no handler code. Safe to import in API services without pulling in\n * heavy worker dependencies.\n *\n * Callable: pass a handler to create a full WorkflowDefinition.\n */\nexport interface WorkflowRef<\n  TInput extends InputParameters = InputParameters,\n  // biome-ignore lint/correctness/noUnusedVariables: phantom type carried for typed return inference\n  TOutput = unknown,\n> {\n  (\n    handler: (context: WorkflowContext<TInput, StepBaseContext>) => Promise<unknown>,\n    options?: Omit<WorkflowOptions<TInput>, 'inputSchema'>,\n  ): WorkflowDefinition<TInput>;\n  readonly id: string;\n  readonly inputSchema?: TInput;\n}\n\nexport type WorkflowRunProgress = WorkflowRun & {\n  completionPercentage: number;\n  totalSteps: number;\n  completedSteps: number;\n};\n\nexport interface WorkflowLogger {\n  log(message: string): void;\n  error(message: string, ...args: unknown[]): void;\n}\n\nexport type WorkflowInternalLoggerContext = {\n  runId?: string;\n  workflowId?: string;\n};\nexport interface WorkflowInternalLogger {\n  log(message: string, context?: WorkflowInternalLoggerContext): void;\n  error(message: string, error: Error, context?: WorkflowInternalLoggerContext): void;\n}\n",
+    "import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { WorkflowRun } from './db/types';\nimport type { Duration } from './duration';\n\nexport enum WorkflowStatus {\n  PENDING = 'pending',\n  RUNNING = 'running',\n  PAUSED = 'paused',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  CANCELLED = 'cancelled',\n}\n\nexport enum StepType {\n  PAUSE = 'pause',\n  RUN = 'run',\n  WAIT_FOR = 'waitFor',\n  WAIT_UNTIL = 'waitUntil',\n  DELAY = 'delay',\n  POLL = 'poll',\n  INVOKE_CHILD_WORKFLOW = 'invokeChildWorkflow',\n}\n\nexport type InputParameters = StandardSchemaV1;\nexport type InferInputParameters<P extends InputParameters> = StandardSchemaV1.InferOutput<P>;\n\nexport type StartWorkflowOptions = {\n  resourceId?: string;\n  timeout?: number;\n  retries?: number;\n  expireInSeconds?: number;\n  idempotencyKey?: string;\n};\n\nexport type WorkflowOptions<I extends InputParameters> = {\n  timeout?: number;\n  retries?: number;\n  inputSchema?: I;\n};\n\nexport type StepBaseContext = {\n  run: <T>(stepId: string, handler: () => Promise<T>) => Promise<T>;\n  waitFor: {\n    <T extends InputParameters>(\n      stepId: string,\n      options: { eventName: string; schema?: T },\n    ): Promise<InferInputParameters<T>>;\n    <T extends InputParameters>(\n      stepId: string,\n      options: { eventName: string; timeout: number; schema?: T },\n    ): Promise<InferInputParameters<T> | undefined>;\n  };\n  waitUntil: {\n    (stepId: string, date: Date): Promise<void>;\n    (stepId: string, dateString: string): Promise<void>;\n    (stepId: string, options: { date: Date | string }): Promise<void>;\n  };\n  /** Delay execution for a duration (sugar over waitUntil). Alias: sleep. */\n  delay: (stepId: string, duration: Duration) => Promise<void>;\n  /** Alias for delay. */\n  sleep: (stepId: string, duration: Duration) => Promise<void>;\n  pause: (stepId: string) => Promise<void>;\n  poll: <T>(\n    stepId: string,\n    conditionFn: () => Promise<T | false>,\n    options?: { interval?: Duration; timeout?: Duration },\n  ) => Promise<{ timedOut: false; data: T } | { timedOut: true }>;\n  /**\n   * Invoke a child workflow from inside the current workflow and pause until\n   * the child run reaches a terminal state.\n   */\n  invokeChildWorkflow: {\n    <TInput extends InputParameters, TOutput = unknown>(\n      stepId: string,\n      ref: WorkflowRef<TInput, TOutput>,\n      input: InferInputParameters<TInput>,\n      options?: StartWorkflowOptions,\n    ): Promise<TOutput>;\n    <TOutput = unknown>(\n      stepId: string,\n      params: {\n        workflowId: string;\n        input: unknown;\n        resourceId?: string;\n        idempotencyKey?: string;\n        options?: StartWorkflowOptions;\n      },\n    ): Promise<TOutput>;\n  };\n};\n\n/**\n * Plugin that extends the workflow step API with extra methods.\n * @template TStepBase - The step type this plugin receives (base + previous plugins).\n * @template TStepExt - The extra methods this plugin adds to step.\n */\nexport interface WorkflowPlugin<TStepBase = StepBaseContext, TStepExt = object> {\n  name: string;\n  methods: (step: TStepBase, context: WorkflowContext) => TStepExt;\n  /**\n   * Optional middleware around the workflow handler call. Composes in\n   * registration order — the first plugin passed to `.use()` wraps everything\n   * inside. Implementations MUST call `next()` exactly once.\n   */\n  wrap?: (context: WorkflowContext, next: () => Promise<unknown>) => Promise<unknown>;\n}\n\nexport type WorkflowContext<\n  TInput extends InputParameters = InputParameters,\n  TStep extends StepBaseContext = StepBaseContext,\n> = {\n  input: InferInputParameters<TInput>;\n  step: TStep;\n  workflowId: string;\n  runId: string;\n  /** Tenant/scope identifier set when the run was started, if any. */\n  resourceId?: string;\n  /** Zero-based retry attempt number (= `run.retryCount`). */\n  attempt: number;\n  timeline: Record<string, unknown>;\n  logger: WorkflowLogger;\n};\n\nexport type WorkflowDefinition<TInput extends InputParameters = InputParameters> = {\n  id: string;\n  /** Widest context avoids contravariance when collecting definitions; `workflow()` still types the handler narrowly. */\n  handler: (context: WorkflowContext<InputParameters, StepBaseContext>) => Promise<unknown>;\n  inputSchema?: TInput;\n  timeout?: number; // milliseconds\n  retries?: number;\n  plugins?: WorkflowPlugin[];\n};\n\nexport type StepInternalDefinition = {\n  id: string;\n  type: StepType;\n  conditional: boolean;\n  loop: boolean;\n  isDynamic: boolean;\n};\n\nexport type WorkflowInternalDefinition<TInput extends InputParameters = InputParameters> =\n  WorkflowDefinition<TInput> & {\n    steps: StepInternalDefinition[];\n  };\n\n/**\n * Chainable workflow factory: call as (id, handler, options) and/or use .use(plugin).\n * TStepExt is the accumulated step extension from all plugins (step = StepContext & TStepExt).\n */\nexport interface WorkflowFactory<TStepExt = object> {\n  <I extends InputParameters = InputParameters>(\n    id: string,\n    handler: (context: WorkflowContext<I, StepBaseContext & TStepExt>) => Promise<unknown>,\n    options?: WorkflowOptions<I>,\n  ): WorkflowDefinition<I>;\n  use<TNewExt>(\n    plugin: WorkflowPlugin<StepBaseContext & TStepExt, TNewExt>,\n  ): WorkflowFactory<TStepExt & TNewExt>;\n  ref<TInput extends InputParameters = InputParameters, TOutput = unknown>(\n    id: string,\n    options?: { inputSchema?: TInput },\n  ): WorkflowRef<TInput, TOutput>;\n}\n\n/**\n * Lightweight workflow reference - carries the workflow ID and input type\n * but no handler code. Safe to import in API services without pulling in\n * heavy worker dependencies.\n *\n * Callable: pass a handler to create a full WorkflowDefinition.\n */\nexport interface WorkflowRef<\n  TInput extends InputParameters = InputParameters,\n  // biome-ignore lint/correctness/noUnusedVariables: phantom type carried for typed return inference\n  TOutput = unknown,\n> {\n  (\n    handler: (context: WorkflowContext<TInput, StepBaseContext>) => Promise<unknown>,\n    options?: Omit<WorkflowOptions<TInput>, 'inputSchema'>,\n  ): WorkflowDefinition<TInput>;\n  readonly id: string;\n  readonly inputSchema?: TInput;\n}\n\nexport type WorkflowRunProgress = WorkflowRun & {\n  completionPercentage: number;\n  totalSteps: number;\n  completedSteps: number;\n};\n\nexport interface WorkflowLogger {\n  log(message: string): void;\n  error(message: string, ...args: unknown[]): void;\n}\n\nexport type WorkflowInternalLoggerContext = {\n  runId?: string;\n  workflowId?: string;\n};\nexport interface WorkflowInternalLogger {\n  log(message: string, context?: WorkflowInternalLoggerContext): void;\n  error(message: string, error: Error, context?: WorkflowInternalLoggerContext): void;\n}\n",
     "import type {\n  InputParameters,\n  StepBaseContext,\n  WorkflowContext,\n  WorkflowDefinition,\n  WorkflowFactory,\n  WorkflowOptions,\n  WorkflowPlugin,\n  WorkflowRef,\n} from './types';\n\n/**\n * Create a lightweight workflow reference.\n * Safe to import from `pg-workflows/client` - no engine or handler code.\n */\nexport function createWorkflowRef<\n  TOutput = unknown,\n  TInput extends InputParameters = InputParameters,\n>(id: string, options?: { inputSchema?: TInput }): WorkflowRef<TInput, TOutput> {\n  const ref = ((\n    handler: (context: WorkflowContext<TInput, StepBaseContext>) => Promise<unknown>,\n    defineOptions?: Omit<WorkflowOptions<TInput>, 'inputSchema'>,\n  ): WorkflowDefinition<TInput> => ({\n    id,\n    handler: handler as (\n      context: WorkflowContext<InputParameters, StepBaseContext>,\n    ) => Promise<unknown>,\n    inputSchema: options?.inputSchema,\n    timeout: defineOptions?.timeout,\n    retries: defineOptions?.retries,\n  })) as WorkflowRef<TInput, TOutput>;\n\n  Object.defineProperty(ref, 'id', { value: id, enumerable: true });\n  Object.defineProperty(ref, 'inputSchema', {\n    value: options?.inputSchema,\n    enumerable: true,\n  });\n\n  return ref;\n}\n\nfunction createWorkflowFactory<TStepExt extends object = object>(\n  plugins: Array<WorkflowPlugin<unknown, object>> = [],\n): WorkflowFactory<TStepExt> {\n  const factory = (<I extends InputParameters>(\n    id: string,\n    handler: (context: WorkflowContext<I, StepBaseContext & TStepExt>) => Promise<unknown>,\n    { inputSchema, timeout, retries }: WorkflowOptions<I> = {},\n  ): WorkflowDefinition<I> => ({\n    id,\n    handler: handler as (\n      context: WorkflowContext<InputParameters, StepBaseContext>,\n    ) => Promise<unknown>,\n    inputSchema,\n    timeout,\n    retries,\n    plugins: plugins.length > 0 ? (plugins as WorkflowPlugin[]) : undefined,\n  })) as WorkflowFactory<TStepExt>;\n\n  factory.use = <TNewExt>(\n    plugin: WorkflowPlugin<StepBaseContext & TStepExt, TNewExt>,\n  ): WorkflowFactory<TStepExt & TNewExt> =>\n    createWorkflowFactory<TStepExt & TNewExt>([\n      ...plugins,\n      plugin as WorkflowPlugin<unknown, object>,\n    ]);\n\n  factory.ref = createWorkflowRef;\n\n  return factory;\n}\n\nexport const workflow: WorkflowFactory = createWorkflowFactory();\n"
   ],
   "mappings": "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",

package/dist/index.cjs

@@ -65,6 +65,7 @@ var __export = (target, all) => {
 var exports_src = {};
 __export(exports_src, {
   workflow: () => workflow,
+  otelPlugin: () => otelPlugin,
   createWorkflowRef: () => createWorkflowRef,
   WorkflowStatus: () => WorkflowStatus,
   WorkflowRunNotFoundError: () => WorkflowRunNotFoundError,
@@ -1589,21 +1590,32 @@ class WorkflowEngine {
       };
       let step = { ...baseStep };
       const plugins = workflow2.plugins ?? [];
-      for (const plugin of plugins) {
-        const extra = plugin.methods(step);
-        step = { ...step, ...extra };
-      }
       const context = {
         input: run.input,
         workflowId: run.workflowId,
         runId: run.id,
+        resourceId: run.resourceId ?? undefined,
+        attempt: run.retryCount,
         get timeline() {
           return run?.timeline ?? {};
         },
         logger: this.logger,
         step
       };
-      const result = await workflow2.handler(context);
+      for (const plugin of plugins) {
+        const extra = plugin.methods(step, context);
+        step = { ...step, ...extra };
+        context.step = step;
+      }
+      let next = () => workflow2.handler(context);
+      for (const plugin of [...plugins].reverse()) {
+        if (plugin.wrap) {
+          const inner = next;
+          const wrap = plugin.wrap;
+          next = () => wrap(context, inner);
+        }
+      }
+      const result = await next();
       run = await this.getRun({ runId, resourceId: scopedResourceId });
       const isLastParsedStep = run.currentStepId === workflow2.steps[workflow2.steps.length - 1]?.id;
       const hasPluginSteps = (workflow2.plugins?.length ?? 0) > 0;
@@ -2136,6 +2148,176 @@ ${error.stack}` : String(error)
     }, this.db);
   }
 }
+// src/plugins/otel.ts
+var import_api = require("@opentelemetry/api");
+var DEFAULT_PREFIX = "pg_workflows";
+function isCachedHit(timeline, stepId, kind) {
+  const entry = timeline[stepId];
+  if (entry && typeof entry === "object" && "output" in entry && entry.output !== undefined) {
+    return true;
+  }
+  if (kind === "invokeChildWorkflow" && timeline[invokeChildWorkflowTimelineKey(stepId)]) {
+    return true;
+  }
+  return false;
+}
+function otelPlugin(options = {}) {
+  const tracer = options.tracer ?? import_api.trace.getTracer("pg-workflows");
+  const prefix = options.spanNamePrefix ?? DEFAULT_PREFIX;
+  const extraAttrs = options.attributes;
+  return {
+    name: "opentelemetry",
+    methods: (step, context) => {
+      const wrapVoidish = (kind, base) => {
+        return async (stepId, ...args) => {
+          if (isCachedHit(context.timeline, stepId, kind)) {
+            return base(stepId, ...args);
+          }
+          const capturedCtx = import_api.context.active();
+          const startTime = new Date;
+          let result;
+          let originalErr;
+          let thrownError;
+          try {
+            result = await base(stepId, ...args);
+          } catch (err) {
+            originalErr = err;
+            thrownError = err instanceof Error ? err : new Error(String(err));
+          }
+          const span = tracer.startSpan(`${prefix}.step.${kind}`, {
+            startTime,
+            attributes: { "step.id": stepId, "step.type": kind }
+          }, capturedCtx);
+          if (thrownError) {
+            span.recordException(thrownError);
+            span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: thrownError.message });
+            span.end();
+            throw originalErr;
+          }
+          span.setStatus({ code: import_api.SpanStatusCode.OK });
+          span.end();
+          return result;
+        };
+      };
+      return {
+        run: async (stepId, handler) => {
+          if (isCachedHit(context.timeline, stepId, "run")) {
+            return step.run(stepId, handler);
+          }
+          const capturedCtx = import_api.context.active();
+          const startTime = new Date;
+          let result;
+          let originalErr;
+          let thrownError;
+          try {
+            result = await step.run(stepId, handler);
+          } catch (err) {
+            originalErr = err;
+            thrownError = err instanceof Error ? err : new Error(String(err));
+          }
+          if (result === undefined && !thrownError) {
+            return;
+          }
+          const span = tracer.startSpan(`${prefix}.step.run`, {
+            startTime,
+            attributes: { "step.id": stepId, "step.type": "run" }
+          }, capturedCtx);
+          if (thrownError) {
+            span.recordException(thrownError);
+            span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: thrownError.message });
+            span.end();
+            throw originalErr;
+          }
+          span.setStatus({ code: import_api.SpanStatusCode.OK });
+          span.end();
+          return result;
+        },
+        waitFor: wrapVoidish("waitFor", step.waitFor),
+        delay: wrapVoidish("delay", step.delay),
+        sleep: wrapVoidish("delay", step.delay),
+        waitUntil: wrapVoidish("waitUntil", step.waitUntil),
+        pause: wrapVoidish("pause", step.pause),
+        poll: async (stepId, conditionFn, pollOptions) => {
+          const capturedCtx = import_api.context.active();
+          const startTime = new Date;
+          let result;
+          let originalErr;
+          let thrownError;
+          try {
+            result = await step.poll(stepId, conditionFn, pollOptions);
+          } catch (err) {
+            originalErr = err;
+            thrownError = err instanceof Error ? err : new Error(String(err));
+          }
+          const span = tracer.startSpan(`${prefix}.step.poll`, {
+            startTime,
+            attributes: { "step.id": stepId, "step.type": "poll" }
+          }, capturedCtx);
+          if (thrownError) {
+            span.recordException(thrownError);
+            span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: thrownError.message });
+            span.end();
+            throw originalErr;
+          }
+          span.setStatus({ code: import_api.SpanStatusCode.OK });
+          span.end();
+          return result;
+        },
+        invokeChildWorkflow: async (stepId, refOrParams, inputArg, optionsArg) => {
+          if (isCachedHit(context.timeline, stepId, "invokeChildWorkflow")) {
+            return step.invokeChildWorkflow(stepId, refOrParams, inputArg, optionsArg);
+          }
+          const capturedCtx = import_api.context.active();
+          const startTime = new Date;
+          let result;
+          let originalErr;
+          let thrownError;
+          try {
+            result = await step.invokeChildWorkflow(stepId, refOrParams, inputArg, optionsArg);
+          } catch (err) {
+            originalErr = err;
+            thrownError = err instanceof Error ? err : new Error(String(err));
+          }
+          const span = tracer.startSpan(`${prefix}.step.invokeChildWorkflow`, {
+            startTime,
+            attributes: { "step.id": stepId, "step.type": "invokeChildWorkflow" }
+          }, capturedCtx);
+          if (thrownError) {
+            span.recordException(thrownError);
+            span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: thrownError.message });
+            span.end();
+            throw originalErr;
+          }
+          span.setStatus({ code: import_api.SpanStatusCode.OK });
+          span.end();
+          return result;
+        }
+      };
+    },
+    wrap: (context, next) => tracer.startActiveSpan(`${prefix}.workflow.run`, {
+      attributes: {
+        "workflow.id": context.workflowId,
+        "workflow.run_id": context.runId,
+        "workflow.attempt": context.attempt,
+        ...context.resourceId ? { "workflow.resource_id": context.resourceId } : {},
+        ...extraAttrs ? extraAttrs(context) : {}
+      }
+    }, async (span) => {
+      try {
+        const result = await next();
+        span.setStatus({ code: import_api.SpanStatusCode.OK });
+        return result;
+      } catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        span.recordException(error);
+        span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: error.message });
+        throw err;
+      } finally {
+        span.end();
+      }
+    })
+  };
+}
 
-//# debugId=B0870008EFFA04F064756E2164756E21
+//# debugId=BCF84547491115D464756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.d.cts

@@ -126,7 +126,13 @@ interface WorkflowPlugin<
 	TStepExt = object
 > {
 	name: string;
-	methods: (step: TStepBase) => TStepExt;
+	methods: (step: TStepBase, context: WorkflowContext) => TStepExt;
+	/**
+	* Optional middleware around the workflow handler call. Composes in
+	* registration order — the first plugin passed to `.use()` wraps everything
+	* inside. Implementations MUST call `next()` exactly once.
+	*/
+	wrap?: (context: WorkflowContext, next: () => Promise<unknown>) => Promise<unknown>;
 }
 type WorkflowContext<
 	TInput extends InputParameters = InputParameters,
@@ -136,6 +142,10 @@ type WorkflowContext<
 	step: TStep;
 	workflowId: string;
 	runId: string;
+	/** Tenant/scope identifier set when the run was started, if any. */
+	resourceId?: string;
+	/** Zero-based retry attempt number (= `run.retryCount`). */
+	attempt: number;
 	timeline: Record<string, unknown>;
 	logger: WorkflowLogger;
 };
@@ -452,4 +462,14 @@ declare class WorkflowEngineError extends Error {
 declare class WorkflowRunNotFoundError extends WorkflowEngineError {
 	constructor(runId?: string, workflowId?: string);
 }
-export { workflow, createWorkflowRef, WorkflowStatus, WorkflowRunProgress, WorkflowRunNotFoundError, WorkflowRun, WorkflowRef, WorkflowPlugin, WorkflowOptions, WorkflowLogger, WorkflowEngineOptions, WorkflowEngineError, WorkflowEngine, WorkflowDefinition, WorkflowContext, WorkflowClientOptions, WorkflowClient, StepBaseContext, StartWorkflowOptions, InputParameters, InferInputParameters, Duration };
+import { AttributeValue, Tracer } from "@opentelemetry/api";
+type OtelPluginOptions = {
+	/** Tracer to use. Defaults to `trace.getTracer('pg-workflows')`. */
+	tracer?: Tracer;
+	/** Prefix for all span names. Defaults to `pg_workflows`. */
+	spanNamePrefix?: string;
+	/** Extra attributes merged onto the workflow.run span. */
+	attributes?: (context: WorkflowContext) => Record<string, AttributeValue>;
+};
+declare function otelPlugin(options?: OtelPluginOptions): WorkflowPlugin<StepBaseContext, object>;
+export { workflow, otelPlugin, createWorkflowRef, WorkflowStatus, WorkflowRunProgress, WorkflowRunNotFoundError, WorkflowRun, WorkflowRef, WorkflowPlugin, WorkflowOptions, WorkflowLogger, WorkflowEngineOptions, WorkflowEngineError, WorkflowEngine, WorkflowDefinition, WorkflowContext, WorkflowClientOptions, WorkflowClient, StepBaseContext, StartWorkflowOptions, OtelPluginOptions, InputParameters, InferInputParameters, Duration };

package/dist/index.d.ts

@@ -126,7 +126,13 @@ interface WorkflowPlugin<
 	TStepExt = object
 > {
 	name: string;
-	methods: (step: TStepBase) => TStepExt;
+	methods: (step: TStepBase, context: WorkflowContext) => TStepExt;
+	/**
+	* Optional middleware around the workflow handler call. Composes in
+	* registration order — the first plugin passed to `.use()` wraps everything
+	* inside. Implementations MUST call `next()` exactly once.
+	*/
+	wrap?: (context: WorkflowContext, next: () => Promise<unknown>) => Promise<unknown>;
 }
 type WorkflowContext<
 	TInput extends InputParameters = InputParameters,
@@ -136,6 +142,10 @@ type WorkflowContext<
 	step: TStep;
 	workflowId: string;
 	runId: string;
+	/** Tenant/scope identifier set when the run was started, if any. */
+	resourceId?: string;
+	/** Zero-based retry attempt number (= `run.retryCount`). */
+	attempt: number;
 	timeline: Record<string, unknown>;
 	logger: WorkflowLogger;
 };
@@ -452,4 +462,14 @@ declare class WorkflowEngineError extends Error {
 declare class WorkflowRunNotFoundError extends WorkflowEngineError {
 	constructor(runId?: string, workflowId?: string);
 }
-export { workflow, createWorkflowRef, WorkflowStatus, WorkflowRunProgress, WorkflowRunNotFoundError, WorkflowRun, WorkflowRef, WorkflowPlugin, WorkflowOptions, WorkflowLogger, WorkflowEngineOptions, WorkflowEngineError, WorkflowEngine, WorkflowDefinition, WorkflowContext, WorkflowClientOptions, WorkflowClient, StepBaseContext, StartWorkflowOptions, InputParameters, InferInputParameters, Duration };
+import { AttributeValue, Tracer } from "@opentelemetry/api";
+type OtelPluginOptions = {
+	/** Tracer to use. Defaults to `trace.getTracer('pg-workflows')`. */
+	tracer?: Tracer;
+	/** Prefix for all span names. Defaults to `pg_workflows`. */
+	spanNamePrefix?: string;
+	/** Extra attributes merged onto the workflow.run span. */
+	attributes?: (context: WorkflowContext) => Record<string, AttributeValue>;
+};
+declare function otelPlugin(options?: OtelPluginOptions): WorkflowPlugin<StepBaseContext, object>;
+export { workflow, otelPlugin, createWorkflowRef, WorkflowStatus, WorkflowRunProgress, WorkflowRunNotFoundError, WorkflowRun, WorkflowRef, WorkflowPlugin, WorkflowOptions, WorkflowLogger, WorkflowEngineOptions, WorkflowEngineError, WorkflowEngine, WorkflowDefinition, WorkflowContext, WorkflowClientOptions, WorkflowClient, StepBaseContext, StartWorkflowOptions, OtelPluginOptions, InputParameters, InferInputParameters, Duration };