pg-workflows 0.10.0 → 0.12.0

package/dist/index.cjs

@@ -65,16 +65,13 @@ var __export = (target, all) => {
 var exports_src = {};
 __export(exports_src, {
   workflow: () => workflow,
-  validateWorkflowId: () => validateWorkflowId,
-  validateResourceId: () => validateResourceId,
-  parseDuration: () => parseDuration,
+  otelPlugin: () => otelPlugin,
   createWorkflowRef: () => createWorkflowRef,
   WorkflowStatus: () => WorkflowStatus,
   WorkflowRunNotFoundError: () => WorkflowRunNotFoundError,
   WorkflowEngineError: () => WorkflowEngineError,
   WorkflowEngine: () => WorkflowEngine,
-  WorkflowClient: () => WorkflowClient,
-  StepType: () => StepType
+  WorkflowClient: () => WorkflowClient
 });
 module.exports = __toCommonJS(exports_src);
 
@@ -543,16 +540,6 @@ var WorkflowStatus;
   WorkflowStatus2["FAILED"] = "failed";
   WorkflowStatus2["CANCELLED"] = "cancelled";
 })(WorkflowStatus ||= {});
-var StepType;
-((StepType2) => {
-  StepType2["PAUSE"] = "pause";
-  StepType2["RUN"] = "run";
-  StepType2["WAIT_FOR"] = "waitFor";
-  StepType2["WAIT_UNTIL"] = "waitUntil";
-  StepType2["DELAY"] = "delay";
-  StepType2["POLL"] = "poll";
-  StepType2["INVOKE_CHILD_WORKFLOW"] = "invokeChildWorkflow";
-})(StepType ||= {});
 
 // src/client.ts
 var LOG_PREFIX = "[WorkflowClient]";
@@ -892,31 +879,6 @@ function createWorkflowFactory(plugins = []) {
   return factory;
 }
 var workflow = createWorkflowFactory();
-// src/duration.ts
-var import_parse_duration = __toESM(require("parse-duration"));
-var MS_PER_SECOND = 1000;
-var MS_PER_MINUTE = 60 * MS_PER_SECOND;
-var MS_PER_HOUR = 60 * MS_PER_MINUTE;
-var MS_PER_DAY = 24 * MS_PER_HOUR;
-var MS_PER_WEEK = 7 * MS_PER_DAY;
-function parseDuration(duration) {
-  if (typeof duration === "string") {
-    if (duration.trim() === "") {
-      throw new WorkflowEngineError("Invalid duration: empty string");
-    }
-    const ms2 = import_parse_duration.default(duration);
-    if (ms2 == null || ms2 <= 0) {
-      throw new WorkflowEngineError(`Invalid duration: "${duration}"`);
-    }
-    return ms2;
-  }
-  const { weeks = 0, days = 0, hours = 0, minutes = 0, seconds = 0 } = duration;
-  const ms = weeks * MS_PER_WEEK + days * MS_PER_DAY + hours * MS_PER_HOUR + minutes * MS_PER_MINUTE + seconds * MS_PER_SECOND;
-  if (ms <= 0) {
-    throw new WorkflowEngineError("Invalid duration: must be a positive value");
-  }
-  return ms;
-}
 // src/engine.ts
 var import_es_toolkit2 = require("es-toolkit");
 var import_pg2 = __toESM(require("pg"));
@@ -992,6 +954,32 @@ function parseWorkflowHandler(handler) {
   return { steps: Array.from(steps.values()) };
 }
 
+// src/duration.ts
+var import_parse_duration = __toESM(require("parse-duration"));
+var MS_PER_SECOND = 1000;
+var MS_PER_MINUTE = 60 * MS_PER_SECOND;
+var MS_PER_HOUR = 60 * MS_PER_MINUTE;
+var MS_PER_DAY = 24 * MS_PER_HOUR;
+var MS_PER_WEEK = 7 * MS_PER_DAY;
+function parseDuration(duration) {
+  if (typeof duration === "string") {
+    if (duration.trim() === "") {
+      throw new WorkflowEngineError("Invalid duration: empty string");
+    }
+    const ms2 = import_parse_duration.default(duration);
+    if (ms2 == null || ms2 <= 0) {
+      throw new WorkflowEngineError(`Invalid duration: "${duration}"`);
+    }
+    return ms2;
+  }
+  const { weeks = 0, days = 0, hours = 0, minutes = 0, seconds = 0 } = duration;
+  const ms = weeks * MS_PER_WEEK + days * MS_PER_DAY + hours * MS_PER_HOUR + minutes * MS_PER_MINUTE + seconds * MS_PER_SECOND;
+  if (ms <= 0) {
+    throw new WorkflowEngineError("Invalid duration: must be a positive value");
+  }
+  return ms;
+}
+
 // src/engine.ts
 var LOG_PREFIX2 = "[WorkflowEngine]";
 var StepTypeToIcon = {
@@ -1141,7 +1129,7 @@ class WorkflowEngine {
   async startWorkflow(refOrParams, inputArg, optionsArg) {
     const { workflowId, input, resourceId, idempotencyKey, options } = this.resolveWorkflowRunParameters(refOrParams, inputArg, optionsArg);
     if (!this._started) {
-      await this.start(false, { batchSize: options?.batchSize ?? 1 });
+      await this.start(false);
     }
     const { run } = await this.createWorkflowRun({
       workflowId,
@@ -1602,19 +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,
-        timeline: run.timeline,
+        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;
@@ -1907,7 +1908,7 @@ class WorkflowEngine {
         if (output === undefined) {
           output = {};
         }
-        run = await this.updateRun({
+        const updated = await this.updateRun({
           runId: run.id,
           resourceId: run.resourceId ?? undefined,
           data: {
@@ -1919,6 +1920,7 @@ class WorkflowEngine {
             })
           }
         }, { db });
+        Object.assign(run, updated);
         return output;
       } catch (error) {
         this.logger.error(`Step ${stepId} failed:`, error, {
@@ -2146,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=8E8C82F1948B934364756E2164756E21
+//# debugId=BCF84547491115D464756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.d.cts

@@ -33,7 +33,6 @@ type DurationObject = {
 	seconds?: number;
 };
 type Duration = string | DurationObject;
-declare function parseDuration(duration: Duration): number;
 declare enum WorkflowStatus {
 	PENDING = "pending",
 	RUNNING = "running",
@@ -53,7 +52,7 @@ declare enum StepType {
 }
 type InputParameters = StandardSchemaV1;
 type InferInputParameters<P extends InputParameters> = StandardSchemaV1.InferOutput<P>;
-type WorkflowRunOptions = {
+type StartWorkflowOptions = {
 	resourceId?: string;
 	timeout?: number;
 	retries?: number;
@@ -107,13 +106,13 @@ type StepBaseContext = {
 		<
 			TInput extends InputParameters,
 			TOutput = unknown
-		>(stepId: string, ref: WorkflowRef<TInput, TOutput>, input: InferInputParameters<TInput>, options?: WorkflowRunOptions): Promise<TOutput>;
+		>(stepId: string, ref: WorkflowRef<TInput, TOutput>, input: InferInputParameters<TInput>, options?: StartWorkflowOptions): Promise<TOutput>;
 		<TOutput = unknown>(stepId: string, params: {
 			workflowId: string;
 			input: unknown;
 			resourceId?: string;
 			idempotencyKey?: string;
-			options?: WorkflowRunOptions;
+			options?: StartWorkflowOptions;
 		}): Promise<TOutput>;
 	};
 };
@@ -127,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,
@@ -137,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;
 };
@@ -197,14 +206,6 @@ interface WorkflowLogger {
 	log(message: string): void;
 	error(message: string, ...args: unknown[]): void;
 }
-type WorkflowInternalLoggerContext = {
-	runId?: string;
-	workflowId?: string;
-};
-interface WorkflowInternalLogger {
-	log(message: string, context?: WorkflowInternalLoggerContext): void;
-	error(message: string, error: Error, context?: WorkflowInternalLoggerContext): void;
-}
 type WorkflowClientOptions = {
 	logger?: WorkflowLogger;
 	/**
@@ -221,7 +222,6 @@ type WorkflowClientOptions = {
 	connectionString: string;
 	pool?: never;
 });
-type StartWorkflowOptions = WorkflowRunOptions;
 declare class WorkflowClient {
 	private boss;
 	private db;
@@ -306,9 +306,6 @@ declare function createWorkflowRef<
 declare const workflow: WorkflowFactory;
 import pg2 from "pg";
 import { Db, PgBoss as PgBoss2 } from "pg-boss";
-type StartWorkflowOptions2 = WorkflowRunOptions & {
-	batchSize?: number;
-};
 type WorkflowEngineOptions = {
 	workflows?: WorkflowDefinition[];
 	logger?: WorkflowLogger;
@@ -339,13 +336,13 @@ declare class WorkflowEngine {
 	unregisterWorkflow(workflowId: string): Promise<WorkflowEngine>;
 	unregisterAllWorkflows(): Promise<WorkflowEngine>;
 	private resolveWorkflowRunParameters;
-	startWorkflow<TInput extends InputParameters>(ref: WorkflowRef<TInput>, input: InferInputParameters<TInput>, options?: StartWorkflowOptions2): Promise<WorkflowRun>;
+	startWorkflow<TInput extends InputParameters>(ref: WorkflowRef<TInput>, input: InferInputParameters<TInput>, options?: StartWorkflowOptions): Promise<WorkflowRun>;
 	startWorkflow(params: {
 		resourceId?: string;
 		workflowId: string;
 		input: unknown;
 		idempotencyKey?: string;
-		options?: StartWorkflowOptions2;
+		options?: StartWorkflowOptions;
 	}): Promise<WorkflowRun>;
 	private createWorkflowRun;
 	private enqueueWorkflowRun;
@@ -455,8 +452,6 @@ declare class WorkflowEngine {
 	}>;
 }
 import { StandardSchemaV1 as StandardSchemaV12 } from "@standard-schema/spec";
-declare function validateWorkflowId(workflowId: string): void;
-declare function validateResourceId(resourceId: string | undefined | null): void;
 declare class WorkflowEngineError extends Error {
 	readonly workflowId?: string | undefined;
 	readonly runId?: string | undefined;
@@ -467,4 +462,14 @@ declare class WorkflowEngineError extends Error {
 declare class WorkflowRunNotFoundError extends WorkflowEngineError {
 	constructor(runId?: string, workflowId?: string);
 }
-export { workflow, validateWorkflowId, validateResourceId, parseDuration, createWorkflowRef, WorkflowStatus, WorkflowRunProgress, WorkflowRunOptions, WorkflowRunNotFoundError, WorkflowRef, WorkflowPlugin, WorkflowOptions, WorkflowLogger, WorkflowInternalLoggerContext, WorkflowInternalLogger, WorkflowInternalDefinition, WorkflowFactory, WorkflowEngineOptions, WorkflowEngineError, WorkflowEngine, WorkflowDefinition, WorkflowContext, WorkflowClientOptions, WorkflowClient, StepType, StepInternalDefinition, StepBaseContext, StartWorkflowOptions, InputParameters, InferInputParameters, DurationObject, 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

@@ -33,7 +33,6 @@ type DurationObject = {
 	seconds?: number;
 };
 type Duration = string | DurationObject;
-declare function parseDuration(duration: Duration): number;
 declare enum WorkflowStatus {
 	PENDING = "pending",
 	RUNNING = "running",
@@ -53,7 +52,7 @@ declare enum StepType {
 }
 type InputParameters = StandardSchemaV1;
 type InferInputParameters<P extends InputParameters> = StandardSchemaV1.InferOutput<P>;
-type WorkflowRunOptions = {
+type StartWorkflowOptions = {
 	resourceId?: string;
 	timeout?: number;
 	retries?: number;
@@ -107,13 +106,13 @@ type StepBaseContext = {
 		<
 			TInput extends InputParameters,
 			TOutput = unknown
-		>(stepId: string, ref: WorkflowRef<TInput, TOutput>, input: InferInputParameters<TInput>, options?: WorkflowRunOptions): Promise<TOutput>;
+		>(stepId: string, ref: WorkflowRef<TInput, TOutput>, input: InferInputParameters<TInput>, options?: StartWorkflowOptions): Promise<TOutput>;
 		<TOutput = unknown>(stepId: string, params: {
 			workflowId: string;
 			input: unknown;
 			resourceId?: string;
 			idempotencyKey?: string;
-			options?: WorkflowRunOptions;
+			options?: StartWorkflowOptions;
 		}): Promise<TOutput>;
 	};
 };
@@ -127,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,
@@ -137,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;
 };
@@ -197,14 +206,6 @@ interface WorkflowLogger {
 	log(message: string): void;
 	error(message: string, ...args: unknown[]): void;
 }
-type WorkflowInternalLoggerContext = {
-	runId?: string;
-	workflowId?: string;
-};
-interface WorkflowInternalLogger {
-	log(message: string, context?: WorkflowInternalLoggerContext): void;
-	error(message: string, error: Error, context?: WorkflowInternalLoggerContext): void;
-}
 type WorkflowClientOptions = {
 	logger?: WorkflowLogger;
 	/**
@@ -221,7 +222,6 @@ type WorkflowClientOptions = {
 	connectionString: string;
 	pool?: never;
 });
-type StartWorkflowOptions = WorkflowRunOptions;
 declare class WorkflowClient {
 	private boss;
 	private db;
@@ -306,9 +306,6 @@ declare function createWorkflowRef<
 declare const workflow: WorkflowFactory;
 import pg2 from "pg";
 import { Db, PgBoss as PgBoss2 } from "pg-boss";
-type StartWorkflowOptions2 = WorkflowRunOptions & {
-	batchSize?: number;
-};
 type WorkflowEngineOptions = {
 	workflows?: WorkflowDefinition[];
 	logger?: WorkflowLogger;
@@ -339,13 +336,13 @@ declare class WorkflowEngine {
 	unregisterWorkflow(workflowId: string): Promise<WorkflowEngine>;
 	unregisterAllWorkflows(): Promise<WorkflowEngine>;
 	private resolveWorkflowRunParameters;
-	startWorkflow<TInput extends InputParameters>(ref: WorkflowRef<TInput>, input: InferInputParameters<TInput>, options?: StartWorkflowOptions2): Promise<WorkflowRun>;
+	startWorkflow<TInput extends InputParameters>(ref: WorkflowRef<TInput>, input: InferInputParameters<TInput>, options?: StartWorkflowOptions): Promise<WorkflowRun>;
 	startWorkflow(params: {
 		resourceId?: string;
 		workflowId: string;
 		input: unknown;
 		idempotencyKey?: string;
-		options?: StartWorkflowOptions2;
+		options?: StartWorkflowOptions;
 	}): Promise<WorkflowRun>;
 	private createWorkflowRun;
 	private enqueueWorkflowRun;
@@ -455,8 +452,6 @@ declare class WorkflowEngine {
 	}>;
 }
 import { StandardSchemaV1 as StandardSchemaV12 } from "@standard-schema/spec";
-declare function validateWorkflowId(workflowId: string): void;
-declare function validateResourceId(resourceId: string | undefined | null): void;
 declare class WorkflowEngineError extends Error {
 	readonly workflowId?: string | undefined;
 	readonly runId?: string | undefined;
@@ -467,4 +462,14 @@ declare class WorkflowEngineError extends Error {
 declare class WorkflowRunNotFoundError extends WorkflowEngineError {
 	constructor(runId?: string, workflowId?: string);
 }
-export { workflow, validateWorkflowId, validateResourceId, parseDuration, createWorkflowRef, WorkflowStatus, WorkflowRunProgress, WorkflowRunOptions, WorkflowRunNotFoundError, WorkflowRef, WorkflowPlugin, WorkflowOptions, WorkflowLogger, WorkflowInternalLoggerContext, WorkflowInternalLogger, WorkflowInternalDefinition, WorkflowFactory, WorkflowEngineOptions, WorkflowEngineError, WorkflowEngine, WorkflowDefinition, WorkflowContext, WorkflowClientOptions, WorkflowClient, StepType, StepInternalDefinition, StepBaseContext, StartWorkflowOptions, InputParameters, InferInputParameters, DurationObject, 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 };