@temelj/workflow 0.0.0-alpha.3 → 0.0.0-alpha.4

package/dist/history/validator.mjs

@@ -1,8 +1,8 @@
 import { WorkflowStateError } from "../errors/base.mjs";
 import { WorkflowReplayDivergenceError } from "../errors/failures.mjs";
 import "../errors/mod.mjs";
-import { getEventDescriptor, getWorkflowEventStepAttempt, isWorkflowTerminalStepAttemptEvent } from "../events/descriptors.mjs";
-import { isWorkflowRecordedStepEvent, workflowRecordedStepEventType } from "./sequencer.mjs";
+import { eventFieldsMatch, getEventDescriptor, getWorkflowEventStepAttempt, isWorkflowTerminalStepAttemptEvent } from "../events/descriptors.mjs";
+import { isRecordedStepEvent, workflowRecordedStepEventType } from "./sequencer.mjs";
 //#region src/history/validator.ts
 function workflowStartedEventMatchesTerminalEvent(started, terminal) {
 	const descriptor = getEventDescriptor(terminal.kind);
@@ -20,10 +20,7 @@ function requireWorkflowTerminalEventsHaveStartedEvents(events) {
 		if (isStaleMessageWaitTerminalBeforeLaterStart(events, event)) continue;
 		const stepId = terminalStepEventId(event);
 		const type = terminalStepEventStepType(event);
-		WorkflowReplayDivergenceError.diverged(`recorded ${type} step ${stepId} has a terminal event without a started event`, {
-			expectedStepId: stepId,
-			actualStepId: stepId
-		});
+		WorkflowReplayDivergenceError.atStep(stepId, `recorded ${type} step ${stepId} has a terminal event without a started event`);
 	}
 }
 function requireWorkflowTerminalEventsAreUnique(events) {
@@ -38,16 +35,13 @@ function requireWorkflowTerminalEventsAreUnique(events) {
 		}
 		const stepId = terminalStepEventId(event);
 		const type = terminalStepEventStepType(event);
-		WorkflowReplayDivergenceError.diverged(`recorded ${type} step ${stepId} has multiple terminal events for attempt ${getTerminalStepEventAttempt(event)}`, {
-			expectedStepId: stepId,
-			actualStepId: stepId
-		});
+		WorkflowReplayDivergenceError.atStep(stepId, `recorded ${type} step ${stepId} has multiple terminal events for attempt ${getTerminalStepEventAttempt(event)}`);
 	}
 }
 function requireWorkflowStartedEventsAreUnique(events) {
 	const started = /* @__PURE__ */ new Map();
 	for (const event of events) {
-		if (!isWorkflowRecordedStepEvent(event)) continue;
+		if (!isRecordedStepEvent(event)) continue;
 		const key = startedStepAttemptIdentityKey(event);
 		if (key === void 0) continue;
 		if (started.get(key) === void 0) {
@@ -55,24 +49,15 @@ function requireWorkflowStartedEventsAreUnique(events) {
 			continue;
 		}
 		const type = workflowRecordedStepEventType(event);
-		WorkflowReplayDivergenceError.diverged(`recorded ${type} step ${event.stepId} has multiple started events for attempt ${getWorkflowEventStepAttempt(event)}`, {
-			expectedStepId: event.stepId,
-			actualStepId: event.stepId
-		});
+		WorkflowReplayDivergenceError.atStep(event.stepId, `recorded ${type} step ${event.stepId} has multiple started events for attempt ${getWorkflowEventStepAttempt(event)}`);
 	}
 }
 function isValidRecordedAttempt(attempt) {
-	return typeof attempt === "number" && Number.isSafeInteger(attempt) && attempt > 0;
+	return attempt !== void 0 && Number.isSafeInteger(attempt) && attempt > 0;
 }
 function recordedAttemptFieldsMatch(started, terminal, fields = []) {
 	if (!fields.includes("attempt")) return true;
-	return isValidRecordedAttempt(started.attempt) && isValidRecordedAttempt(terminal.attempt);
-}
-function eventFieldsMatch(left, right, fields = []) {
-	return fields.every((field) => getEventField(left, field) === getEventField(right, field));
-}
-function getEventField(event, field) {
-	return Reflect.get(event, field);
+	return "attempt" in started && isValidRecordedAttempt(started.attempt) && "attempt" in terminal && isValidRecordedAttempt(terminal.attempt);
 }
 function terminalStepEventId(event) {
 	if (isWorkflowTerminalStepAttemptEvent(event)) return event.stepId;
@@ -107,4 +92,4 @@ function isStaleMessageWaitTerminalBeforeLaterStart(events, event) {
 	return events.slice(terminalIndex + 1).some((started) => started.kind === "message_wait_started" && started.stepId === event.stepId && started.stepName === event.stepName && started.messageId === event.messageId);
 }
 //#endregion
-export { requireWorkflowStartedEventsAreUnique, requireWorkflowTerminalEventsAreUnique, requireWorkflowTerminalEventsHaveStartedEvents, workflowHistoryHasStartedEventBeforeTerminalEvent, workflowStartedEventMatchesTerminalEvent };
+export { requireWorkflowStartedEventsAreUnique, requireWorkflowTerminalEventsAreUnique, requireWorkflowTerminalEventsHaveStartedEvents, workflowStartedEventMatchesTerminalEvent };

package/dist/hook-token.d.mts

@@ -0,0 +1,7 @@
+import { HookTokenPayload } from "./types/hook.mjs";
+//#region src/hook-token.d.ts
+export declare const WORKFLOW_HOOK_TOKEN_PREFIX = "temelj-hook:";
+export declare const WORKFLOW_HOOK_TOKEN_VERSION = "v1";
+/** Decodes a hook or webhook token without resuming it, and throws WorkflowHookError when invalid. */
+export declare function parseHookToken(token: string): HookTokenPayload;
+//#endregion

package/dist/hook-token.mjs

@@ -0,0 +1,32 @@
+import { idSchema, nonBlankStringSchema } from "./schema/common.mjs";
+import { WorkflowHookError } from "./errors/hook.mjs";
+import "./errors/mod.mjs";
+import { persistedValueSchema } from "./schema/persisted-value.mjs";
+import { ss } from "@temelj/standard-schema";
+import { decodeBase64UrlString } from "@temelj/string";
+//#region src/hook-token.ts
+const WORKFLOW_HOOK_TOKEN_PREFIX = "temelj-hook:";
+const WORKFLOW_HOOK_TOKEN_VERSION = "v1";
+const hookTokenPayloadSchema = ss.object({
+	runId: idSchema,
+	name: nonBlankStringSchema,
+	messageId: idSchema,
+	kind: ss.picklist(["hook", "webhook"]),
+	metadata: ss.optional(persistedValueSchema)
+});
+/** Decodes a hook or webhook token without resuming it, and throws WorkflowHookError when invalid. */
+function parseHookToken(token) {
+	const versionPrefix = `${WORKFLOW_HOOK_TOKEN_PREFIX}v1:`;
+	if (!token.startsWith(versionPrefix)) WorkflowHookError.tokenInvalid();
+	let payload;
+	try {
+		payload = JSON.parse(decodeBase64UrlString(token.slice(versionPrefix.length)));
+	} catch {
+		WorkflowHookError.tokenInvalid();
+	}
+	const hook = ss.safeParseSync(hookTokenPayloadSchema, payload);
+	if (!hook.success) WorkflowHookError.tokenInvalid();
+	return hook.value;
+}
+//#endregion
+export { WORKFLOW_HOOK_TOKEN_PREFIX, WORKFLOW_HOOK_TOKEN_VERSION, parseHookToken };

package/dist/ids.d.mts

@@ -0,0 +1,8 @@
+import { WorkerId } from "./types/ids.mjs";
+import { RecordedIdContext } from "./types/engine-options.mjs";
+//#region src/ids.d.ts
+/** Creates a default worker identifier using the current time and a random suffix. */
+export declare function createDefaultWorkerId(): WorkerId;
+export declare function createDefaultRunIdFactory(now?: () => Temporal.Instant): () => string;
+export declare function createDefaultRecordedIdFactory(createRunId: () => string): (context: RecordedIdContext) => string;
+//#endregion

package/dist/ids.mjs

@@ -0,0 +1,21 @@
+//#region src/ids.ts
+/** Converts arbitrary command ID text into a stable segment safe for recorded IDs. */
+function sanitizeRecordedIdPart(value) {
+	const sanitized = value.replaceAll(/[^a-zA-Z0-9_-]/g, "_");
+	return sanitized === "" ? "run" : sanitized;
+}
+/** Creates a default worker identifier using the current time and a random suffix. */
+function createDefaultWorkerId() {
+	return `worker_${Temporal.Now.instant().epochMilliseconds.toString(36)}_${Math.random().toString(36).slice(2)}`;
+}
+function createDefaultRunIdFactory(now = Temporal.Now.instant) {
+	return () => `run_${now().epochMilliseconds.toString(36)}_${randomIdPart()}`;
+}
+function createDefaultRecordedIdFactory(createRunId) {
+	return (context) => `wf_${sanitizeRecordedIdPart(context.runId)}_${createRunId()}`;
+}
+function randomIdPart() {
+	return Math.random().toString(36).slice(2);
+}
+//#endregion
+export { createDefaultRecordedIdFactory, createDefaultRunIdFactory, createDefaultWorkerId };

package/dist/message-options.d.mts

@@ -1,8 +1,14 @@
-import { BroadcastMessageChannelOptions, BroadcastMessageInput, BroadcastMessageOptions, MessageChannel, SendMessageChannelOptions, SendMessageInput, SendMessageOptions, WaitForMessageChannelOptions, WaitForMessageInput, WaitForMessageOptions } from "./types/message.mjs";
+import { BroadcastMessageChannelOptions, BroadcastMessageInput, BroadcastMessageOptions, MessageChannel, SendMessageChannelOptions, SendMessageInput, SendMessageOptions, WaitForMessageOptions } from "./types/message.mjs";
+import { StepMessageApi } from "./types/step.mjs";
 import { Schema } from "@temelj/standard-schema";
+import { StorageValue } from "@temelj/storage";
 //#region src/message-options.d.ts
-declare function resolveSendMessageInput<TPayload, TKey>(messageInput: SendMessageInput | MessageChannel<TPayload, TKey>, channelOptions: SendMessageChannelOptions<TPayload, TKey> | undefined): Promise<SendMessageOptions>;
-declare function resolveBroadcastMessageInput<TPayload, TKey>(messageInput: BroadcastMessageInput | MessageChannel<TPayload, TKey>, channelOptions: BroadcastMessageChannelOptions<TPayload, TKey> | undefined): Promise<BroadcastMessageOptions>;
-declare function resolveWaitForMessageInput<TKey>(messageInput: WaitForMessageInput<Schema | undefined> | MessageChannel<unknown, TKey>, channelOptions: WaitForMessageChannelOptions<TKey> | undefined): WaitForMessageOptions<Schema | undefined>;
+export declare function resolveSendMessageInput<TPayload, TRawPayload>(messageInput: SendMessageInput | MessageChannel<TPayload, TRawPayload>, channelOptions: SendMessageChannelOptions<TRawPayload> | undefined): Promise<SendMessageOptions>;
+export declare function resolveBroadcastMessageInput<TPayload, TRawPayload>(messageInput: BroadcastMessageInput | MessageChannel<TPayload, TRawPayload>, channelOptions: BroadcastMessageChannelOptions<TRawPayload> | undefined): Promise<BroadcastMessageOptions>;
+interface MessageWaitExecutor {
+  <TPayload>(options: WaitForMessageOptions<Schema<unknown, TPayload> | undefined>): Promise<TPayload | StorageValue | undefined>;
+}
+/** Dispatches raw and schema-validated waits without erasing the schema output type. */
+export declare function createMessageWait(execute: MessageWaitExecutor): StepMessageApi["wait"];
 //#endregion
-export { resolveBroadcastMessageInput, resolveSendMessageInput, resolveWaitForMessageInput };
+export {};

package/dist/message-options.mjs

@@ -9,17 +9,19 @@ async function resolveBroadcastMessageInput(messageInput, channelOptions) {
 	if ("messageId" in messageInput) return messageInput;
 	if ("channel" in messageInput) return {
 		...await resolveMessageChannelSend(messageInput.channel, messageInput),
-		...messageInput.target === void 0 ? {} : { target: messageInput.target }
+		target: messageInput.target
 	};
 	return {
 		...await resolveMessageChannelSend(messageInput, channelOptions),
-		...channelOptions?.target === void 0 ? {} : { target: channelOptions.target }
+		target: channelOptions?.target
 	};
 }
-function resolveWaitForMessageInput(messageInput, channelOptions) {
-	if ("channel" in messageInput) return resolveMessageChannelWait(messageInput.channel, messageInput);
-	if ("messageId" in messageInput) return messageInput;
-	return resolveMessageChannelWait(messageInput, channelOptions);
+/** Dispatches raw and schema-validated waits without erasing the schema output type. */
+function createMessageWait(execute) {
+	async function wait(input, options) {
+		return await execute("messageId" in input ? input : resolveMessageChannelWait(input, options));
+	}
+	return wait;
 }
 //#endregion
-export { resolveBroadcastMessageInput, resolveSendMessageInput, resolveWaitForMessageInput };
+export { createMessageWait, resolveBroadcastMessageInput, resolveSendMessageInput };

package/dist/mod.d.mts

@@ -1,32 +1,32 @@
-import { WorkflowErrorCode, workflowErrorCodeSchema } from "./types/error-code.mjs";
-import { MessageId } from "./types/message-id.mjs";
-import { RunId } from "./types/run-id.mjs";
-import { StepId } from "./types/step-id.mjs";
-import { CleanupMarkerRecord, CleanupMode, CleanupRunResult, CleanupRunsOptions, CleanupRunsResult, CleanupStatusFilter, RetentionPolicyOptions, workflowCleanupMarkerRecordSchema, workflowCleanupModeSchema } from "./types/cleanup.mjs";
-import { Cursor, CursorKeyPart, CursorPayload, PageDirection, PageOptions, WorkflowPage, workflowCursorKeyPartSchema, workflowCursorPayloadSchema, workflowCursorSchema, workflowPageDirectionSchema } from "./types/pagination.mjs";
-import { ListSchedulesOptions, ListSchedulesPageOptions, ScheduleCatchUpPolicy, ScheduleConfig, ScheduleId, ScheduleOverlapPolicy, ScheduleRecord, ScheduleStatus, TickSchedulesOptions, TickSchedulesResult, scheduleIdSchema, workflowScheduleCatchUpPolicySchema, workflowScheduleOverlapPolicySchema, workflowSchedulePositiveDurationSchema, workflowScheduleRecordSchema, workflowScheduleStatusSchema } from "./types/schedule.mjs";
-import { WorkflowMissingImplementationRetryConfig, WorkflowRetryConfig, WorkflowStepRetryConfig } from "./types/retry.mjs";
-import { Registry, RegistryLike, WorkflowContext, WorkflowDefinition, WorkflowDefinitionConfig, WorkflowDefinitionTypes, WorkflowHandler, WorkflowImplementation, WorkflowInputFromSchema, WorkflowRawInputFromSchema, WorkflowRunContext, WorkflowStartTarget } from "./types/definition.mjs";
-import { CreateHookOptions, CreateWebhookOptions, Hook, HookCreator, HookInspection, HookInspectionStatus, HookKind, HookToken, HookTokenPayload, ParsedWorkflowHookToken, ParsedWorkflowWebhookToken, ResumeHookOptions, ResumeWebhookOptions, Webhook, WebhookCreator, WorkflowStepHookCreateApi } from "./types/hook.mjs";
-import { AcquireLockOptions, LockRecord, ReleaseLockOptions, ReleaseStaleLockOptions, WorkflowStepAcquireLockOptions, WorkflowStepReleaseLockOptions, workflowLockRecordSchema } from "./types/lock.mjs";
-import { WorkflowListRunsOptions, WorkflowListRunsPageOptions, WorkflowListStepAttemptsPageOptions } from "./types/run-list.mjs";
-import { BroadcastMessageChannelObject, BroadcastMessageChannelOptions, BroadcastMessageInput, BroadcastMessageOptions, BroadcastMessageResult, MessageChannel, MessageChannelConfig, MessageChannelKeyArgs, MessageChannelTypes, SendMessageChannelObject, SendMessageChannelOptions, SendMessageInput, SendMessageOptions, WaitForMessageChannelObject, WaitForMessageChannelOptions, WaitForMessageInput, WaitForMessageOptions } from "./types/message.mjs";
-import { CreateStreamOptions, FollowStreamOptions, ReadStreamOptions, ReadStreamPageOptions, Stream, StreamChunk, StreamChunkUpdate, StreamInfo, StreamPage, StreamState, StreamStatus, StreamTerminalUpdate, StreamUpdate, StreamUpdateBase, StreamUpdateKind, WaitStreamOptions } from "./types/stream.mjs";
-import { WorkflowChildWorkflowCancellationPolicy, WorkflowDeterministicApi, WorkflowStepApi, WorkflowStepContext, WorkflowStepDefinition, WorkflowStepDefinitionHandler, WorkflowStepDefinitionTypes, WorkflowStepDeterministicApi, WorkflowStepHookApi, WorkflowStepLockApi, WorkflowStepMessageApi, WorkflowStepMetadata, WorkflowStepRunConfig, WorkflowStepRunDataApi, WorkflowStepRunWorkflowOptions, WorkflowStepStartWorkflowOptions, WorkflowStepStreamApi, WorkflowStepTaskApi, WorkflowStepWorkflowApi, workflowChildWorkflowCancellationPolicySchema } from "./types/step.mjs";
-import { WorkflowRecoveryChildWorkflowWaitSummary, WorkflowRecoveryDueSummary, WorkflowRecoveryFailedSummary, WorkflowRecoveryLeaseSummary, WorkflowRecoveryLockSummary, WorkflowRecoveryMessageWaitSummary, WorkflowRecoveryMissingImplementationSummary, WorkflowRecoveryRetrySummary, WorkflowRecoveryScheduleSummary, WorkflowRecoverySleepWaitSummary, WorkflowRecoverySummary, WorkflowRecoverySummaryOptions, WorkflowRecoveryWaitSummary, WorkflowRunChildWorkflowSummary, WorkflowRunCleanupSummary, WorkflowRunFailureErrorSummary, WorkflowRunFailureSummary, WorkflowRunHookSummary, WorkflowRunLeaseSummary, WorkflowRunMessageSummary, WorkflowRunRetryReasonCounts, WorkflowRunRetrySummary, WorkflowRunSleepSummary, WorkflowRunStatusCounts, WorkflowRunStatusRunIds, WorkflowRunStreamSummary, WorkflowRunSummary, WorkflowRunSummaryOptions, WorkflowRunTransitionReasonCounts, WorkflowRunTransitionReasonRunIds, WorkflowRunTransitionSummary, WorkflowRunWorkflowCount, WorkflowRunWorkflowSummary, WorkflowTerminalRunStatusCounts, WorkflowTerminalRunStatusRunIds } from "./types/summary.mjs";
-import { WorkflowActiveChildWorkflowSummary, WorkflowActiveMessageWaitSummary, WorkflowListStepAttemptsOptions, WorkflowStepAttemptFailureErrorSummary, WorkflowStepAttemptFailureSummary, WorkflowStepAttemptKindAttemptKeys, WorkflowStepAttemptKindCounts, WorkflowStepAttemptKindStepIds, WorkflowStepAttemptRecord, WorkflowStepAttemptStatus, WorkflowStepAttemptStatusAttemptKeys, WorkflowStepAttemptStatusCounts, WorkflowStepAttemptStatusStepIds, WorkflowStepAttemptSummary, workflowStepAttemptRecordSchema, workflowStepAttemptStatusSchema } from "./types/step-attempts.mjs";
-import { ChildWorkflowStartedObservationEvent, CleanupObservationEvent, DurableEventObservationEvent, MessageObservationEvent, ObservationEmitter, ObservationEventHandler, ObservationEventMap, ObservationEventPattern, ObservationUnsubscribe, ResumeObservationEvent, RunObservationEvent, ScheduleRunCreatedObservationEvent, ScheduleTickObservationEvent, StepAttemptObservationEvent, StreamObservationEvent, WorkerOperationObservationEvent } from "./types/observation.mjs";
-import { Timeline, TimelineAttributesEntry, TimelineChildWorkflowEntry, TimelineChildWorkflowStatus, TimelineDeterministicEntry, TimelineEntry, TimelineEntryKind, TimelineEntryRecord, TimelineMessageEntry, TimelineMessageStatus, TimelineMetadataEntry, TimelineRecordedStatus, TimelineSetStatus, TimelineSleepEntry, TimelineSleepStatus, TimelineStepEntry, TimelineStepStatus, TimelineStreamEntry, TimelineStreamStatus, TimelineWorkflowEntry, TimelineWorkflowStatus } from "./types/timeline.mjs";
-import { CompletedResult, ExecutionResult, ExecutionResultBase, ExecutionResultKind, FailedResult, HandleOperations, ResultOptions, WaitingResult, WorkflowHandle } from "./types/result.mjs";
-import { RunTelemetryContext, RunTelemetryResultContext, StepTelemetryContext, StepTelemetryResultContext, StorageTelemetryContext, StorageTelemetryOperation, Telemetry, TelemetryContext, TelemetryEngine, workflowTelemetryContextSchema } from "./types/telemetry.mjs";
-import { WORKFLOW_ATTRIBUTE_MAX_COUNT, WORKFLOW_ATTRIBUTE_MAX_KEY_LENGTH, WORKFLOW_ATTRIBUTE_MAX_VALUE_BYTES, WORKFLOW_ATTRIBUTE_RESERVED_PREFIX, WorkflowAttributePatch, WorkflowAttributeValue, WorkflowLifecycleCallback, WorkflowLifecycleEvent, WorkflowMaterializedStepType, WorkflowRunAttributes, WorkflowRunRecord, WorkflowRunRetryReason, WorkflowRunStatus, WorkflowRunTransitionReason, WorkflowRunWorkflowName, WorkflowRunWorkflowVersion, WorkflowStepIdentity, WorkflowStepType, WorkflowTerminalRunStatus, WorkflowValueIssue, persistedValueIssue, workflowAttributeKeySchema, workflowAttributePatchSchema, workflowAttributePrimitiveValueSchema, workflowAttributeValueSchema, workflowMaterializedStepTypeSchema, workflowPersistedValueSchema, workflowRunAttributesSchema, workflowRunRecordSchema, workflowRunRetryReasonSchema, workflowRunStatusSchema, workflowRunTransitionReasonSchema, workflowStepTypeSchema, workflowTerminalRunStatusSchema } from "./types/run.mjs";
-import { WorkflowErrorOptions, WorkflowErrorRecord, WorkflowNonRetryableErrorOptions, WorkflowRetryableErrorOptions, workflowErrorRecordSchema } from "./types/error.mjs";
-import { AttributesSetEvent, ChildWorkflowCompletedEvent, ChildWorkflowEventKind, ChildWorkflowFailedEvent, ChildWorkflowStartedEvent, DataEventKind, DeterministicEventKind, DeterministicValueRecordedEvent, EventDescriptor, EventDescriptorCategory, EventDescriptorStepAttempt, EventKind, EventRecord, MessageEventKind, MessageSendCompletedEvent, MessageSendFailedEvent, MessageSendStartedEvent, MessageSentEvent, MessageSentPayload, MessageWaitCompletedEvent, MessageWaitFailedEvent, MessageWaitSource, MessageWaitStartedEvent, MetadataSetEvent, SleepCompletedEvent, SleepEventKind, SleepStartedEvent, StreamChunkEvent, StreamClosedEvent, StreamEventKind, StreamFailedError, StreamFailedEvent, StreamStartedEvent, WorkflowEvent, WorkflowRunEvent, WorkflowRunEventKind, WorkflowStepCompletedEvent, WorkflowStepEventKind, WorkflowStepFailedEvent, WorkflowStepStartedEvent, workflowAttributesSetEventSchema, workflowChildWorkflowCompletedEventSchema, workflowChildWorkflowEventKindSchema, workflowChildWorkflowFailedEventSchema, workflowChildWorkflowStartedEventSchema, workflowCompletedEventSchema, workflowDataEventKindSchema, workflowDeterministicEventKindSchema, workflowDeterministicValueRecordedEventSchema, workflowEventKindSchema, workflowEventRecordListSchema, workflowEventRecordSchema, workflowFailedEventSchema, workflowMessageEventKindSchema, workflowMessageSendCompletedEventSchema, workflowMessageSendFailedEventSchema, workflowMessageSendStartedEventSchema, workflowMessageSentEventSchema, workflowMessageWaitCompletedEventSchema, workflowMessageWaitFailedEventSchema, workflowMessageWaitSourceSchema, workflowMessageWaitStartedEventSchema, workflowMessageWaiterStepIdsSchema, workflowMetadataSetEventSchema, workflowRunEventKindSchema, workflowSleepCompletedEventSchema, workflowSleepEventKindSchema, workflowSleepStartedEventSchema, workflowStartedEventSchema, workflowStepCompletedEventSchema, workflowStepEventKindSchema, workflowStepFailedEventSchema, workflowStepStartedEventSchema, workflowStreamChunkEventSchema, workflowStreamClosedEventSchema, workflowStreamEventKindSchema, workflowStreamFailedEventSchema, workflowStreamStartedEventSchema } from "./types/events.mjs";
-import { WorkflowBundle, WorkflowBundleEntry, createWorkflowBundleRegistry, defineWorkflowBundle } from "./bundle.mjs";
-import { ScheduleNextOptions, WorkflowBatchStartItem, WorkflowMarkRunPermanentlyFailedOptions, WorkflowReleaseStaleLeaseOptions, WorkflowRerunOptions, WorkflowRescheduleRunOptions, WorkflowRetryFailedRunOptions, WorkflowRunArguments, WorkflowRunParentOptions, WorkflowStartOptions, WorkflowVersionResolver } from "./types/run-options.mjs";
-import { CreateWorkflowEngineOptions, WorkflowDeterministicBytesContext, WorkflowDeterministicValueContext, WorkflowEngineSerializationLimits, WorkflowExecutionLimits, WorkflowRecordedIdContext } from "./types/engine-options.mjs";
-import { CreateWorkflowWorkerOptions, WorkflowWakeDueRunsOptions, WorkflowWorker, WorkflowWorkerLeaseOptions, WorkflowWorkerRunFilterOptions, WorkflowWorkerRunOptions, WorkflowWorkerRunResult } from "./types/worker.mjs";
-import { CompiledWorkflowFunction, WorkflowClient, WorkflowClientAdminApi, WorkflowClientHooksApi, WorkflowClientLocksApi, WorkflowClientMessagesApi, WorkflowClientProcessRunOptions, WorkflowClientRunsApi, WorkflowClientSchedulesApi, WorkflowClientStreamsApi, WorkflowClientWorkerOptions, WorkflowClientWorkersApi, WorkflowRunHandle, WorkflowRunnable } from "./types/client.mjs";
+import { WorkflowErrorCode } from "./errors/codes.mjs";
+import { MessageId, RunId, StepId, StreamId, StreamIdOrName, WorkerId } from "./types/ids.mjs";
+import { RetryableErrorOptions, WorkflowErrorOptions, WorkflowErrorRecord } from "./types/error.mjs";
+import { CleanupMarkerRecord, CleanupMode, CleanupRunResult, CleanupRunsOptions, CleanupRunsResult, CleanupStatusFilter, RetentionPolicyOptions } from "./types/cleanup.mjs";
+import { CreateHookOptions, CreateWebhookOptions, Hook, HookInspection, HookInspectionStatus, HookKind, HookTokenPayload, ResumeHookOptions, StepHookCreateApi, Webhook } from "./types/hook.mjs";
+import { Cursor, PageOptions, WorkflowPage } from "./types/pagination.mjs";
+import { ListSchedulesOptions, ListSchedulesPageOptions, ScheduleCatchUpPolicy, ScheduleConfig, ScheduleId, ScheduleOverlapPolicy, ScheduleRecord, ScheduleStatus, TickSchedulesOptions, TickSchedulesResult } from "./types/schedule.mjs";
+import { MissingImplementationRetryConfig, RetryConfig } from "./types/retry.mjs";
+import { DefinitionConfig, DefinitionTypes, InputFromSchema, RawInputFromSchema, RegistryLike, RunContext, StartTarget, WorkflowContext, WorkflowDefinition, WorkflowHandler, WorkflowImplementation } from "./types/definition.mjs";
+import { AcquireLockOptions, LockRecord, ReleaseLockOptions, ReleaseStaleLockOptions, StepAcquireLockOptions, StepReleaseLockOptions } from "./types/lock.mjs";
+import { ListRunsOptions, ListRunsPageOptions, ListStepAttemptsPageOptions } from "./types/run-list.mjs";
+import { BroadcastMessageChannelObject, BroadcastMessageChannelOptions, BroadcastMessageInput, BroadcastMessageOptions, BroadcastMessageResult, MessageChannel, MessageChannelConfig, MessageSender, SendMessageChannelObject, SendMessageChannelOptions, SendMessageInput, SendMessageOptions, WaitForMessageChannelOptions, WaitForMessageOptions } from "./types/message.mjs";
+import { CreateStreamOptions, FollowStreamOptions, ReadStreamOptions, Stream, StreamChunk, StreamChunkUpdate, StreamInfo, StreamState, StreamStatus, StreamTerminalUpdate, StreamUpdate, StreamUpdateKind, WaitStreamOptions } from "./types/stream.mjs";
+import { ChildWorkflowCancellationPolicy, DeterministicApi, StepApi, StepDefinition, StepDefinitionHandler, StepDefinitionTypes, StepHookApi, StepLockApi, StepMessageApi, StepMetadata, StepRunConfig, StepRunDataApi, StepRunWorkflowOptions, StepStartWorkflowOptions, StepStreamApi, StepTaskApi, StepWorkflowApi, WorkflowStepContext } from "./types/step.mjs";
+import { NextLock, NextRun, NextSchedule, NextSleep, NextStep, RecoveryChildWorkflowWaitSummary, RecoveryDueSummary, RecoveryFailedSummary, RecoveryLeaseSummary, RecoveryLockSummary, RecoveryMessageWaitSummary, RecoveryRetrySummary, RecoveryScheduleSummary, RecoverySleepWaitSummary, RecoverySummary, RecoveryWaitSummary, RunChildWorkflowSummary, RunCleanupSummary, RunFailureErrorSummary, RunFailureSummary, RunHookSummary, RunLeaseSummary, RunMessageSummary, RunRetryReasonCounts, RunRetrySummary, RunSleepSummary, RunStatusCounts, RunStreamSummary, RunSummary, RunTransitionReasonCounts, RunTransitionSummary, RunWaitSummary, RunWorkflowCount, TerminalRunStatusCounts } from "./types/summary.mjs";
+import { ActiveChildWorkflowSummary, ActiveMessageWaitSummary, ActiveSleepSummary, ListStepAttemptsOptions, NextAttempt, NextAttemptSleep, StepAttemptFailureErrorSummary, StepAttemptFailureSummary, StepAttemptKindAttemptKeys, StepAttemptKindStepIds, StepAttemptRecord, StepAttemptStatus, StepAttemptStatusAttemptKeys, StepAttemptStatusStepIds, StepAttemptSummary } from "./types/step-attempts.mjs";
+import { ChildWorkflowStartedObservationEvent, CleanupObservationEvent, DurableEventObservationEvent, MessageObservationEvent, ObservationEventArgs, ObservationEventHandler, ObservationEventMap, ObservationEventPattern, ResumeObservationEvent, ScheduleRunCreatedObservationEvent, ScheduleTickObservationEvent, StepAttemptObservationEvent, StreamObservationEvent, WorkerOperationObservationEvent } from "./types/observation.mjs";
+import { CompletedResult, ExecutionResult, ExecutionResultKind, FailedResult, ResultOptions, WaitingResult } from "./types/result.mjs";
+import { RunTelemetryContext, RunTelemetryResultContext, StepTelemetryContext, StepTelemetryResultContext, StorageTelemetryContext, StorageTelemetryOperation, Telemetry, TelemetryContext, TelemetryEngine } from "./types/telemetry.mjs";
+import { AttributePatch, MaterializedStepType, RunAttributes, RunLinks, RunRecord, RunRetryReason, RunStatus, RunTransitionReason, StepType, TerminalRunStatus, WorkflowAttributeValue, WorkflowLifecycleCallback, WorkflowLifecycleEvent } from "./types/run.mjs";
+import { AttributesSetEvent, ChildWorkflowCompletedEvent, ChildWorkflowEventKind, ChildWorkflowFailedEvent, ChildWorkflowStartedEvent, DataEventKind, DeterministicEventKind, DeterministicValueRecordedEvent, EventKind, EventRecord, MessageEventKind, MessageSendCompletedEvent, MessageSendFailedEvent, MessageSendStartedEvent, MessageSentEvent, MessageWaitCompletedEvent, MessageWaitFailedEvent, MessageWaitSource, MessageWaitStartedEvent, MetadataSetEvent, RunEventKind, SleepCompletedEvent, SleepEventKind, SleepStartedEvent, StepCompletedEvent, StepEventKind, StepFailedEvent, StepStartedEvent, StreamChunkEvent, StreamClosedEvent, StreamEventKind, StreamFailedEvent, StreamStartedEvent } from "./types/events.mjs";
+import { WorkflowBundle, defineWorkflowBundle } from "./bundle.mjs";
+import { WakeDueRunsOptions, WorkerLeaseOptions, WorkerRunFilterOptions, WorkerRunOptions, WorkerRunResult, WorkflowWorker } from "./types/worker.mjs";
+import { CreateWorkflowEngineOptions, DeterministicBytesContext, ExecutionLimits, RecordedIdContext } from "./types/engine-options.mjs";
+import { BatchStartItem, MarkRunPermanentlyFailedOptions, ReleaseStaleLeaseOptions, RerunOptions, RescheduleRunOptions, RetryFailedRunOptions, RunArguments, RunParentOptions, ScheduleNextOptions, StartOptions, VersionResolver } from "./types/run-options.mjs";
+import { getWorkflowFunctionDefinition, getWorkflowStepFunctionDefinition, registerWorkflowFunctions } from "./compiled-function.mjs";
+import { RunHandle, RuntimeRunsApi, WorkflowRuntime } from "./types/runtime.mjs";
+import { Timeline, TimelineEntry } from "./types/timeline.mjs";
+import { ClientAdminApi, ClientHooksApi, ClientLocksApi, ClientMessagesApi, ClientProcessRunOptions, ClientRunsApi, ClientSchedulesApi, ClientStreamsApi, ClientWorkerOptions, ClientWorkersApi, CompiledWorkflowFunction, RunStreamsApi, WorkflowClient, WorkflowRunHandle } from "./types/client.mjs";
 import { CreateWorkflowClientOptions, createWorkflowClient } from "./client/create.mjs";
 import "./client/mod.mjs";
 import { defineMessageChannel, defineWorkflow, implementWorkflow } from "./definition.mjs";
@@ -39,15 +39,11 @@ import { WorkflowImplementationNotFoundError } from "./errors/implementation.mjs
 import { WorkflowLockError, WorkflowLockStateError } from "./errors/lock.mjs";
 import { WorkflowHookDisposedError, WorkflowMessageDeliveryError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError } from "./errors/message.mjs";
 import { WorkflowChildWorkflowTimeoutError, WorkflowResultTimeoutError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError } from "./errors/run.mjs";
-import { WorkflowRuntimeError } from "./errors/runtime.mjs";
 import { WorkflowScheduleAlreadyExistsError, WorkflowScheduleError } from "./errors/schedule.mjs";
 import { WorkflowStepAttemptLimitError, WorkflowStepExecutionError, WorkflowStepRetryLimitError, WorkflowStepTimeoutError } from "./errors/step.mjs";
 import { WorkflowStreamError, WorkflowStreamNotFoundError } from "./errors/stream.mjs";
-import { workflowErrorRecordView } from "./errors/record-view.mjs";
+import { matchesWorkflowError } from "./errors/records.mjs";
 import "./errors/mod.mjs";
-import { attachWorkflowDefinition, attachWorkflowStepDefinition, callWorkflowStepFunction, getCompiledWorkflowDefinition, getCompiledWorkflowStepDefinition, getWorkflowFunctionDefinition, getWorkflowStepFunctionDefinition, registerWorkflowFunctions, runWorkflowFunction } from "./compiled-function.mjs";
-import { CreateWorkflowRuntimeOptions, WorkflowRuntimeLocksApi, WorkflowRuntimeRunsApi, WorkflowRuntimeSchedulesApi, parseWorkflowRuntime, workflowRuntimeSchema } from "./types/runtime.mjs";
-import { WorkflowRuntime, createWorkflowRuntime, getWorkflowRuntimeRun, startWorkflowRuntimeRun } from "./runtime.mjs";
 import { defineWorkflowStep } from "./step-definition.mjs";
-import { WebhookResumer, parseWebhookToken, resumeWebhook } from "./webhook.mjs";
-export { type AcquireLockOptions, type AttributesSetEvent, type BroadcastMessageChannelObject, type BroadcastMessageChannelOptions, type BroadcastMessageInput, type BroadcastMessageOptions, type BroadcastMessageResult, type ChildWorkflowCompletedEvent, type ChildWorkflowEventKind, type ChildWorkflowFailedEvent, type ChildWorkflowStartedEvent, type ChildWorkflowStartedObservationEvent, type CleanupMarkerRecord, type CleanupMode, type CleanupObservationEvent, type CleanupRunResult, type CleanupRunsOptions, type CleanupRunsResult, type CleanupStatusFilter, type CompiledWorkflowFunction, type CompletedResult, type CreateHookOptions, type CreateStreamOptions, type CreateWebhookOptions, type CreateWorkflowClientOptions, type CreateWorkflowEngineOptions, type CreateWorkflowRuntimeOptions, type CreateWorkflowWorkerOptions, type Cursor, type CursorKeyPart, type CursorPayload, type DataEventKind, type DeterministicEventKind, type DeterministicValueRecordedEvent, type DurableEventObservationEvent, type EventDescriptor, type EventDescriptorCategory, type EventDescriptorStepAttempt, type EventKind, type EventRecord, type ExecutionResult, type ExecutionResultBase, type ExecutionResultKind, type FailedResult, type FollowStreamOptions, type HandleOperations, type Hook, type HookCreator, type HookInspection, type HookInspectionStatus, type HookKind, type HookToken, type HookTokenPayload, type ListSchedulesOptions, type ListSchedulesPageOptions, type LockRecord, type MessageChannel, type MessageChannelConfig, type MessageChannelKeyArgs, type MessageChannelTypes, type MessageEventKind, type MessageId, type MessageObservationEvent, type MessageSendCompletedEvent, type MessageSendFailedEvent, type MessageSendStartedEvent, type MessageSentEvent, type MessageSentPayload, type MessageWaitCompletedEvent, type MessageWaitFailedEvent, type MessageWaitSource, type MessageWaitStartedEvent, type MetadataSetEvent, type ObservationEmitter, type ObservationEventHandler, type ObservationEventMap, type ObservationEventPattern, type ObservationUnsubscribe, type PageDirection, type PageOptions, type ParsedWorkflowHookToken, type ParsedWorkflowWebhookToken, type ReadStreamOptions, type ReadStreamPageOptions, type Registry, type RegistryLike, type ReleaseLockOptions, type ReleaseStaleLockOptions, type ResultOptions, type ResumeHookOptions, type ResumeObservationEvent, type ResumeWebhookOptions, type RetentionPolicyOptions, type RunId, type RunObservationEvent, type RunTelemetryContext, type RunTelemetryResultContext, type ScheduleCatchUpPolicy, type ScheduleConfig, type ScheduleId, type ScheduleNextOptions, type ScheduleOverlapPolicy, type ScheduleRecord, type ScheduleRunCreatedObservationEvent, type ScheduleStatus, type ScheduleTickObservationEvent, type SendMessageChannelObject, type SendMessageChannelOptions, type SendMessageInput, type SendMessageOptions, type SleepCompletedEvent, type SleepEventKind, type SleepStartedEvent, type StepAttemptObservationEvent, type StepId, type StepTelemetryContext, type StepTelemetryResultContext, type StorageTelemetryContext, type StorageTelemetryOperation, type Stream, type StreamChunk, type StreamChunkEvent, type StreamChunkUpdate, type StreamClosedEvent, type StreamEventKind, type StreamFailedError, type StreamFailedEvent, type StreamInfo, type StreamObservationEvent, type StreamPage, type StreamStartedEvent, type StreamState, type StreamStatus, type StreamTerminalUpdate, type StreamUpdate, type StreamUpdateBase, type StreamUpdateKind, type Telemetry, type TelemetryContext, type TelemetryEngine, type TickSchedulesOptions, type TickSchedulesResult, type Timeline, type TimelineAttributesEntry, type TimelineChildWorkflowEntry, type TimelineChildWorkflowStatus, type TimelineDeterministicEntry, type TimelineEntry, type TimelineEntryKind, type TimelineEntryRecord, type TimelineMessageEntry, type TimelineMessageStatus, type TimelineMetadataEntry, type TimelineRecordedStatus, type TimelineSetStatus, type TimelineSleepEntry, type TimelineSleepStatus, type TimelineStepEntry, type TimelineStepStatus, type TimelineStreamEntry, type TimelineStreamStatus, type TimelineWorkflowEntry, type TimelineWorkflowStatus, type WORKFLOW_ATTRIBUTE_MAX_COUNT, type WORKFLOW_ATTRIBUTE_MAX_KEY_LENGTH, type WORKFLOW_ATTRIBUTE_MAX_VALUE_BYTES, type WORKFLOW_ATTRIBUTE_RESERVED_PREFIX, type WaitForMessageChannelObject, type WaitForMessageChannelOptions, type WaitForMessageInput, type WaitForMessageOptions, type WaitStreamOptions, type WaitingResult, type Webhook, type WebhookCreator, WebhookResumer, type WorkerOperationObservationEvent, type WorkflowActiveChildWorkflowSummary, type WorkflowActiveMessageWaitSummary, type WorkflowAttributePatch, type WorkflowAttributeValue, type WorkflowBatchStartItem, WorkflowBundle, WorkflowBundleEntry, WorkflowCapabilityError, type WorkflowChildWorkflowCancellationPolicy, WorkflowChildWorkflowTimeoutError, type WorkflowClient, type WorkflowClientAdminApi, type WorkflowClientHooksApi, type WorkflowClientLocksApi, type WorkflowClientMessagesApi, type WorkflowClientProcessRunOptions, type WorkflowClientRunsApi, type WorkflowClientSchedulesApi, type WorkflowClientStreamsApi, type WorkflowClientWorkerOptions, type WorkflowClientWorkersApi, type WorkflowContext, type WorkflowDefinition, type WorkflowDefinitionConfig, WorkflowDefinitionError, type WorkflowDefinitionTypes, type WorkflowDeterministicApi, type WorkflowDeterministicBytesContext, type WorkflowDeterministicValueContext, WorkflowDurationError, type WorkflowEngineSerializationLimits, WorkflowError, WorkflowErrorCode, type WorkflowErrorCode as WorkflowErrorCodeType, type WorkflowErrorOptions, type WorkflowErrorRecord, type WorkflowEvent, type WorkflowExecutionLimits, type WorkflowHandle, type WorkflowHandler, WorkflowHookDisposedError, WorkflowHookError, type WorkflowImplementation, WorkflowImplementationNotFoundError, type WorkflowInputFromSchema, type WorkflowLifecycleCallback, type WorkflowLifecycleEvent, type WorkflowListRunsOptions, type WorkflowListRunsPageOptions, type WorkflowListStepAttemptsOptions, type WorkflowListStepAttemptsPageOptions, WorkflowLockError, WorkflowLockStateError, type WorkflowMarkRunPermanentlyFailedOptions, type WorkflowMaterializedStepType, WorkflowMessageDeliveryError, WorkflowMessageError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError, type WorkflowMissingImplementationRetryConfig, WorkflowNonRetryableError, type WorkflowNonRetryableErrorOptions, WorkflowOptionsError, type WorkflowPage, WorkflowPermanentFailureError, type WorkflowRawInputFromSchema, type WorkflowRecordedIdContext, type WorkflowRecoveryChildWorkflowWaitSummary, type WorkflowRecoveryDueSummary, type WorkflowRecoveryFailedSummary, type WorkflowRecoveryLeaseSummary, type WorkflowRecoveryLockSummary, type WorkflowRecoveryMessageWaitSummary, type WorkflowRecoveryMissingImplementationSummary, type WorkflowRecoveryRetrySummary, type WorkflowRecoveryScheduleSummary, type WorkflowRecoverySleepWaitSummary, type WorkflowRecoverySummary, type WorkflowRecoverySummaryOptions, type WorkflowRecoveryWaitSummary, type WorkflowReleaseStaleLeaseOptions, WorkflowReplayDivergenceError, type WorkflowRerunOptions, type WorkflowRescheduleRunOptions, WorkflowResultTimeoutError, type WorkflowRetryConfig, type WorkflowRetryFailedRunOptions, WorkflowRetryableError, type WorkflowRetryableErrorOptions, type WorkflowRunArguments, type WorkflowRunAttributes, WorkflowRunCanceledError, WorkflowRunCancellationError, type WorkflowRunChildWorkflowSummary, type WorkflowRunCleanupSummary, type WorkflowRunContext, WorkflowRunDeadlineExceededError, WorkflowRunError, type WorkflowRunEvent, type WorkflowRunEventKind, type WorkflowRunFailureErrorSummary, type WorkflowRunFailureSummary, type WorkflowRunHandle, type WorkflowRunHookSummary, WorkflowRunInvalidError, type WorkflowRunLeaseSummary, type WorkflowRunMessageSummary, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, type WorkflowRunParentOptions, type WorkflowRunRecord, type WorkflowRunRetryReason, type WorkflowRunRetryReasonCounts, type WorkflowRunRetrySummary, type WorkflowRunSleepSummary, type WorkflowRunStatus, type WorkflowRunStatusCounts, type WorkflowRunStatusRunIds, type WorkflowRunStreamSummary, type WorkflowRunSummary, type WorkflowRunSummaryOptions, WorkflowRunTransitionError, type WorkflowRunTransitionReason, type WorkflowRunTransitionReasonCounts, type WorkflowRunTransitionReasonRunIds, type WorkflowRunTransitionSummary, type WorkflowRunWorkflowCount, type WorkflowRunWorkflowName, type WorkflowRunWorkflowSummary, type WorkflowRunWorkflowVersion, type WorkflowRunnable, WorkflowRuntime, WorkflowRuntimeError, type WorkflowRuntimeLocksApi, type WorkflowRuntimeRunsApi, type WorkflowRuntimeSchedulesApi, WorkflowScheduleAlreadyExistsError, WorkflowScheduleError, WorkflowSerializationError, type WorkflowStartOptions, type WorkflowStartTarget, WorkflowStateError, type WorkflowStepAcquireLockOptions, type WorkflowStepApi, type WorkflowStepAttemptFailureErrorSummary, type WorkflowStepAttemptFailureSummary, type WorkflowStepAttemptKindAttemptKeys, type WorkflowStepAttemptKindCounts, type WorkflowStepAttemptKindStepIds, WorkflowStepAttemptLimitError, type WorkflowStepAttemptRecord, type WorkflowStepAttemptStatus, type WorkflowStepAttemptStatusAttemptKeys, type WorkflowStepAttemptStatusCounts, type WorkflowStepAttemptStatusStepIds, type WorkflowStepAttemptSummary, type WorkflowStepCompletedEvent, type WorkflowStepContext, type WorkflowStepDefinition, type WorkflowStepDefinitionHandler, type WorkflowStepDefinitionTypes, type WorkflowStepDeterministicApi, WorkflowStepError, type WorkflowStepEventKind, WorkflowStepExecutionError, type WorkflowStepFailedEvent, type WorkflowStepHookApi, type WorkflowStepHookCreateApi, type WorkflowStepIdentity, type WorkflowStepLockApi, type WorkflowStepMessageApi, type WorkflowStepMetadata, type WorkflowStepReleaseLockOptions, type WorkflowStepRetryConfig, WorkflowStepRetryLimitError, type WorkflowStepRunConfig, type WorkflowStepRunDataApi, type WorkflowStepRunWorkflowOptions, type WorkflowStepStartWorkflowOptions, type WorkflowStepStartedEvent, type WorkflowStepStreamApi, type WorkflowStepTaskApi, WorkflowStepTimeoutError, type WorkflowStepType, type WorkflowStepWorkflowApi, WorkflowStreamError, WorkflowStreamNotFoundError, type WorkflowTerminalRunStatus, type WorkflowTerminalRunStatusCounts, type WorkflowTerminalRunStatusRunIds, type WorkflowValueIssue, type WorkflowVersionResolver, type WorkflowWakeDueRunsOptions, type WorkflowWorker, type WorkflowWorkerLeaseOptions, type WorkflowWorkerRunFilterOptions, type WorkflowWorkerRunOptions, type WorkflowWorkerRunResult, attachWorkflowDefinition, attachWorkflowStepDefinition, callWorkflowStepFunction, createWorkflowBundleRegistry, createWorkflowClient, createWorkflowRuntime, defineMessageChannel, defineWorkflow, defineWorkflowBundle, defineWorkflowStep, getCompiledWorkflowDefinition, getCompiledWorkflowStepDefinition, getWorkflowFunctionDefinition, getWorkflowRuntimeRun, getWorkflowStepFunctionDefinition, implementWorkflow, parseWebhookToken, parseWorkflowRuntime, type persistedValueIssue, registerWorkflowFunctions, resumeWebhook, runWorkflowFunction, type scheduleIdSchema, startWorkflowRuntimeRun, type workflowAttributeKeySchema, type workflowAttributePatchSchema, type workflowAttributePrimitiveValueSchema, type workflowAttributeValueSchema, type workflowAttributesSetEventSchema, type workflowChildWorkflowCancellationPolicySchema, type workflowChildWorkflowCompletedEventSchema, type workflowChildWorkflowEventKindSchema, type workflowChildWorkflowFailedEventSchema, type workflowChildWorkflowStartedEventSchema, type workflowCleanupMarkerRecordSchema, type workflowCleanupModeSchema, type workflowCompletedEventSchema, type workflowCursorKeyPartSchema, type workflowCursorPayloadSchema, type workflowCursorSchema, type workflowDataEventKindSchema, type workflowDeterministicEventKindSchema, type workflowDeterministicValueRecordedEventSchema, workflowErrorCodeSchema, workflowErrorRecordSchema, workflowErrorRecordView, type workflowEventKindSchema, type workflowEventRecordListSchema, type workflowEventRecordSchema, type workflowFailedEventSchema, type workflowLockRecordSchema, type workflowMaterializedStepTypeSchema, type workflowMessageEventKindSchema, type workflowMessageSendCompletedEventSchema, type workflowMessageSendFailedEventSchema, type workflowMessageSendStartedEventSchema, type workflowMessageSentEventSchema, type workflowMessageWaitCompletedEventSchema, type workflowMessageWaitFailedEventSchema, type workflowMessageWaitSourceSchema, type workflowMessageWaitStartedEventSchema, type workflowMessageWaiterStepIdsSchema, type workflowMetadataSetEventSchema, type workflowPageDirectionSchema, type workflowPersistedValueSchema, type workflowRunAttributesSchema, type workflowRunEventKindSchema, type workflowRunRecordSchema, type workflowRunRetryReasonSchema, type workflowRunStatusSchema, type workflowRunTransitionReasonSchema, workflowRuntimeSchema, type workflowScheduleCatchUpPolicySchema, type workflowScheduleOverlapPolicySchema, type workflowSchedulePositiveDurationSchema, type workflowScheduleRecordSchema, type workflowScheduleStatusSchema, type workflowSleepCompletedEventSchema, type workflowSleepEventKindSchema, type workflowSleepStartedEventSchema, type workflowStartedEventSchema, type workflowStepAttemptRecordSchema, type workflowStepAttemptStatusSchema, type workflowStepCompletedEventSchema, type workflowStepEventKindSchema, type workflowStepFailedEventSchema, type workflowStepStartedEventSchema, type workflowStepTypeSchema, type workflowStreamChunkEventSchema, type workflowStreamClosedEventSchema, type workflowStreamEventKindSchema, type workflowStreamFailedEventSchema, type workflowStreamStartedEventSchema, type workflowTelemetryContextSchema, type workflowTerminalRunStatusSchema };
+import { parseHookToken } from "./hook-token.mjs";
+export { type AcquireLockOptions, type ActiveChildWorkflowSummary, type ActiveMessageWaitSummary, type ActiveSleepSummary, type AttributePatch, type AttributesSetEvent, type BatchStartItem, type BroadcastMessageChannelObject, type BroadcastMessageChannelOptions, type BroadcastMessageInput, type BroadcastMessageOptions, type BroadcastMessageResult, type ChildWorkflowCancellationPolicy, type ChildWorkflowCompletedEvent, type ChildWorkflowEventKind, type ChildWorkflowFailedEvent, type ChildWorkflowStartedEvent, type ChildWorkflowStartedObservationEvent, type CleanupMarkerRecord, type CleanupMode, type CleanupObservationEvent, type CleanupRunResult, type CleanupRunsOptions, type CleanupRunsResult, type CleanupStatusFilter, type ClientAdminApi, type ClientHooksApi, type ClientLocksApi, type ClientMessagesApi, type ClientProcessRunOptions, type ClientRunsApi, type ClientSchedulesApi, type ClientStreamsApi, type ClientWorkerOptions, type ClientWorkersApi, type CompiledWorkflowFunction, type CompletedResult, type CreateHookOptions, type CreateStreamOptions, type CreateWebhookOptions, type CreateWorkflowClientOptions, type CreateWorkflowEngineOptions, type Cursor, type DataEventKind, type DefinitionConfig, type DefinitionTypes, type DeterministicApi, type DeterministicBytesContext, type DeterministicEventKind, type DeterministicValueRecordedEvent, type DurableEventObservationEvent, type EventKind, type EventRecord, type ExecutionLimits, type ExecutionResult, type ExecutionResultKind, type FailedResult, type FollowStreamOptions, type Hook, type HookInspection, type HookInspectionStatus, type HookKind, type HookTokenPayload, type InputFromSchema, type ListRunsOptions, type ListRunsPageOptions, type ListSchedulesOptions, type ListSchedulesPageOptions, type ListStepAttemptsOptions, type ListStepAttemptsPageOptions, type LockRecord, type MarkRunPermanentlyFailedOptions, type MaterializedStepType, type MessageChannel, type MessageChannelConfig, type MessageEventKind, type MessageId, type MessageObservationEvent, type MessageSendCompletedEvent, type MessageSendFailedEvent, type MessageSendStartedEvent, type MessageSender, type MessageSentEvent, type MessageWaitCompletedEvent, type MessageWaitFailedEvent, type MessageWaitSource, type MessageWaitStartedEvent, type MetadataSetEvent, type MissingImplementationRetryConfig, type NextAttempt, type NextAttemptSleep, type NextLock, type NextRun, type NextSchedule, type NextSleep, type NextStep, type ObservationEventArgs, type ObservationEventHandler, type ObservationEventMap, type ObservationEventPattern, type PageOptions, type RawInputFromSchema, type ReadStreamOptions, type RecordedIdContext, type RecoveryChildWorkflowWaitSummary, type RecoveryDueSummary, type RecoveryFailedSummary, type RecoveryLeaseSummary, type RecoveryLockSummary, type RecoveryMessageWaitSummary, type RecoveryRetrySummary, type RecoveryScheduleSummary, type RecoverySleepWaitSummary, type RecoverySummary, type RecoveryWaitSummary, type RegistryLike, type ReleaseLockOptions, type ReleaseStaleLeaseOptions, type ReleaseStaleLockOptions, type RerunOptions, type RescheduleRunOptions, type ResultOptions, type ResumeHookOptions, type ResumeObservationEvent, type RetentionPolicyOptions, type RetryConfig, type RetryFailedRunOptions, type RetryableErrorOptions, type RunArguments, type RunAttributes, type RunChildWorkflowSummary, type RunCleanupSummary, type RunContext, type RunEventKind, type RunFailureErrorSummary, type RunFailureSummary, type RunHandle, type RunHookSummary, type RunId, type RunLeaseSummary, type RunLinks, type RunMessageSummary, type RunParentOptions, type RunRecord, type RunRetryReason, type RunRetryReasonCounts, type RunRetrySummary, type RunSleepSummary, type RunStatus, type RunStatusCounts, type RunStreamSummary, type RunStreamsApi, type RunSummary, type RunTelemetryContext, type RunTelemetryResultContext, type RunTransitionReason, type RunTransitionReasonCounts, type RunTransitionSummary, type RunWaitSummary, type RunWorkflowCount, type RuntimeRunsApi, type ScheduleCatchUpPolicy, type ScheduleConfig, type ScheduleId, type ScheduleNextOptions, type ScheduleOverlapPolicy, type ScheduleRecord, type ScheduleRunCreatedObservationEvent, type ScheduleStatus, type ScheduleTickObservationEvent, type SendMessageChannelObject, type SendMessageChannelOptions, type SendMessageInput, type SendMessageOptions, type SleepCompletedEvent, type SleepEventKind, type SleepStartedEvent, type StartOptions, type StartTarget, type StepAcquireLockOptions, type StepApi, type StepAttemptFailureErrorSummary, type StepAttemptFailureSummary, type StepAttemptKindAttemptKeys, type StepAttemptKindStepIds, type StepAttemptObservationEvent, type StepAttemptRecord, type StepAttemptStatus, type StepAttemptStatusAttemptKeys, type StepAttemptStatusStepIds, type StepAttemptSummary, type StepCompletedEvent, type StepDefinition, type StepDefinitionHandler, type StepDefinitionTypes, type StepEventKind, type StepFailedEvent, type StepHookApi, type StepHookCreateApi, type StepId, type StepLockApi, type StepMessageApi, type StepMetadata, type StepReleaseLockOptions, type StepRunConfig, type StepRunDataApi, type StepRunWorkflowOptions, type StepStartWorkflowOptions, type StepStartedEvent, type StepStreamApi, type StepTaskApi, type StepTelemetryContext, type StepTelemetryResultContext, type StepType, type StepWorkflowApi, type StorageTelemetryContext, type StorageTelemetryOperation, type Stream, type StreamChunk, type StreamChunkEvent, type StreamChunkUpdate, type StreamClosedEvent, type StreamEventKind, type StreamFailedEvent, type StreamId, type StreamIdOrName, type StreamInfo, type StreamObservationEvent, type StreamStartedEvent, type StreamState, type StreamStatus, type StreamTerminalUpdate, type StreamUpdate, type StreamUpdateKind, type Telemetry, type TelemetryContext, type TelemetryEngine, type TerminalRunStatus, type TerminalRunStatusCounts, type TickSchedulesOptions, type TickSchedulesResult, type Timeline, type TimelineEntry, type VersionResolver, type WaitForMessageChannelOptions, type WaitForMessageOptions, type WaitStreamOptions, type WaitingResult, type WakeDueRunsOptions, type Webhook, type WorkerId, type WorkerLeaseOptions, type WorkerOperationObservationEvent, type WorkerRunFilterOptions, type WorkerRunOptions, type WorkerRunResult, type WorkflowAttributeValue, WorkflowBundle, WorkflowCapabilityError, WorkflowChildWorkflowTimeoutError, type WorkflowClient, type WorkflowContext, type WorkflowDefinition, WorkflowDefinitionError, WorkflowDurationError, WorkflowError, WorkflowErrorCode, type WorkflowErrorOptions, type WorkflowErrorRecord, type WorkflowHandler, WorkflowHookDisposedError, WorkflowHookError, type WorkflowImplementation, WorkflowImplementationNotFoundError, type WorkflowLifecycleCallback, type WorkflowLifecycleEvent, WorkflowLockError, WorkflowLockStateError, WorkflowMessageDeliveryError, WorkflowMessageError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError, WorkflowNonRetryableError, WorkflowOptionsError, type WorkflowPage, WorkflowPermanentFailureError, WorkflowReplayDivergenceError, WorkflowResultTimeoutError, WorkflowRetryableError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunError, type WorkflowRunHandle, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError, type WorkflowRuntime, WorkflowScheduleAlreadyExistsError, WorkflowScheduleError, WorkflowSerializationError, WorkflowStateError, WorkflowStepAttemptLimitError, type WorkflowStepContext, WorkflowStepError, WorkflowStepExecutionError, WorkflowStepRetryLimitError, WorkflowStepTimeoutError, WorkflowStreamError, WorkflowStreamNotFoundError, type WorkflowWorker, createWorkflowClient, defineMessageChannel, defineWorkflow, defineWorkflowBundle, defineWorkflowStep, getWorkflowFunctionDefinition, getWorkflowStepFunctionDefinition, implementWorkflow, matchesWorkflowError, parseHookToken, registerWorkflowFunctions };

package/dist/mod.mjs

@@ -1,27 +1,23 @@
-import { WorkflowErrorCode, workflowErrorCodeSchema } from "./types/error-code.mjs";
+import { WorkflowErrorCode } from "./errors/codes.mjs";
 import { WorkflowError, WorkflowMessageError, WorkflowOptionsError, WorkflowRunError, WorkflowStateError, WorkflowStepError } from "./errors/base.mjs";
-import { workflowErrorRecordView } from "./errors/record-view.mjs";
-import { WorkflowDurationError, WorkflowNonRetryableError, WorkflowPermanentFailureError, WorkflowReplayDivergenceError, WorkflowRetryableError, WorkflowSerializationError } from "./errors/failures.mjs";
-import { WorkflowChildWorkflowTimeoutError, WorkflowResultTimeoutError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError } from "./errors/run.mjs";
-import { workflowErrorRecordSchema } from "./types/error.mjs";
 import { WorkflowCapabilityError } from "./errors/capability.mjs";
 import { WorkflowDefinitionError } from "./errors/definition.mjs";
+import { WorkflowDurationError, WorkflowNonRetryableError, WorkflowPermanentFailureError, WorkflowReplayDivergenceError, WorkflowRetryableError, WorkflowSerializationError } from "./errors/failures.mjs";
 import { WorkflowHookError } from "./errors/hook.mjs";
 import { WorkflowImplementationNotFoundError } from "./errors/implementation.mjs";
 import { WorkflowLockError, WorkflowLockStateError } from "./errors/lock.mjs";
 import { WorkflowHookDisposedError, WorkflowMessageDeliveryError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError } from "./errors/message.mjs";
-import { WorkflowRuntimeError } from "./errors/runtime.mjs";
+import { WorkflowChildWorkflowTimeoutError, WorkflowResultTimeoutError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError } from "./errors/run.mjs";
 import { WorkflowScheduleAlreadyExistsError, WorkflowScheduleError } from "./errors/schedule.mjs";
 import { WorkflowStepAttemptLimitError, WorkflowStepExecutionError, WorkflowStepRetryLimitError, WorkflowStepTimeoutError } from "./errors/step.mjs";
 import { WorkflowStreamError, WorkflowStreamNotFoundError } from "./errors/stream.mjs";
+import { matchesWorkflowError } from "./errors/records.mjs";
 import "./errors/mod.mjs";
-import { attachWorkflowDefinition, attachWorkflowStepDefinition, callWorkflowStepFunction, getCompiledWorkflowDefinition, getCompiledWorkflowStepDefinition, getWorkflowFunctionDefinition, getWorkflowStepFunctionDefinition, registerWorkflowFunctions, runWorkflowFunction } from "./compiled-function.mjs";
-import { createWorkflowBundleRegistry, defineWorkflowBundle } from "./bundle.mjs";
+import { getWorkflowFunctionDefinition, getWorkflowStepFunctionDefinition, registerWorkflowFunctions } from "./compiled-function.mjs";
+import { defineWorkflowBundle } from "./bundle.mjs";
 import { defineMessageChannel, defineWorkflow, implementWorkflow } from "./definition.mjs";
+import { defineWorkflowStep } from "./step-definition.mjs";
+import { parseHookToken } from "./hook-token.mjs";
 import { createWorkflowClient } from "./client/create.mjs";
 import "./client/mod.mjs";
-import { parseWorkflowRuntime, workflowRuntimeSchema } from "./types/runtime.mjs";
-import { WorkflowRuntime, createWorkflowRuntime, getWorkflowRuntimeRun, startWorkflowRuntimeRun } from "./runtime.mjs";
-import { defineWorkflowStep } from "./step-definition.mjs";
-import { parseWebhookToken, resumeWebhook } from "./webhook.mjs";
-export { WorkflowCapabilityError, WorkflowChildWorkflowTimeoutError, WorkflowDefinitionError, WorkflowDurationError, WorkflowError, WorkflowErrorCode, WorkflowHookDisposedError, WorkflowHookError, WorkflowImplementationNotFoundError, WorkflowLockError, WorkflowLockStateError, WorkflowMessageDeliveryError, WorkflowMessageError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError, WorkflowNonRetryableError, WorkflowOptionsError, WorkflowPermanentFailureError, WorkflowReplayDivergenceError, WorkflowResultTimeoutError, WorkflowRetryableError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunError, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError, WorkflowRuntime, WorkflowRuntimeError, WorkflowScheduleAlreadyExistsError, WorkflowScheduleError, WorkflowSerializationError, WorkflowStateError, WorkflowStepAttemptLimitError, WorkflowStepError, WorkflowStepExecutionError, WorkflowStepRetryLimitError, WorkflowStepTimeoutError, WorkflowStreamError, WorkflowStreamNotFoundError, attachWorkflowDefinition, attachWorkflowStepDefinition, callWorkflowStepFunction, createWorkflowBundleRegistry, createWorkflowClient, createWorkflowRuntime, defineMessageChannel, defineWorkflow, defineWorkflowBundle, defineWorkflowStep, getCompiledWorkflowDefinition, getCompiledWorkflowStepDefinition, getWorkflowFunctionDefinition, getWorkflowRuntimeRun, getWorkflowStepFunctionDefinition, implementWorkflow, parseWebhookToken, parseWorkflowRuntime, registerWorkflowFunctions, resumeWebhook, runWorkflowFunction, startWorkflowRuntimeRun, workflowErrorCodeSchema, workflowErrorRecordSchema, workflowErrorRecordView, workflowRuntimeSchema };
+export { WorkflowCapabilityError, WorkflowChildWorkflowTimeoutError, WorkflowDefinitionError, WorkflowDurationError, WorkflowError, WorkflowErrorCode, WorkflowHookDisposedError, WorkflowHookError, WorkflowImplementationNotFoundError, WorkflowLockError, WorkflowLockStateError, WorkflowMessageDeliveryError, WorkflowMessageError, WorkflowMessageIdempotencyConflictError, WorkflowMessageWaitTimeoutError, WorkflowNonRetryableError, WorkflowOptionsError, WorkflowPermanentFailureError, WorkflowReplayDivergenceError, WorkflowResultTimeoutError, WorkflowRetryableError, WorkflowRunCanceledError, WorkflowRunCancellationError, WorkflowRunDeadlineExceededError, WorkflowRunError, WorkflowRunInvalidError, WorkflowRunMismatchError, WorkflowRunNotFoundError, WorkflowRunParentError, WorkflowRunTransitionError, WorkflowScheduleAlreadyExistsError, WorkflowScheduleError, WorkflowSerializationError, WorkflowStateError, WorkflowStepAttemptLimitError, WorkflowStepError, WorkflowStepExecutionError, WorkflowStepRetryLimitError, WorkflowStepTimeoutError, WorkflowStreamError, WorkflowStreamNotFoundError, createWorkflowClient, defineMessageChannel, defineWorkflow, defineWorkflowBundle, defineWorkflowStep, getWorkflowFunctionDefinition, getWorkflowStepFunctionDefinition, implementWorkflow, matchesWorkflowError, parseHookToken, registerWorkflowFunctions };

package/dist/otel/metrics.d.mts

@@ -0,0 +1,31 @@
+import { Meter } from "@opentelemetry/api";
+//#region src/otel/metrics.d.ts
+export type Instruments = ReturnType<typeof createInstruments>;
+/** The counters and histograms the OpenTelemetry adapter records. */
+export declare function createInstruments(meter: Meter): {
+  runTransitions: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  runDuration: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+  eventsAppended: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  stepAttempts: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  stepDuration: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+  messagesSent: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  messageWaitLatency: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+  hooksResumed: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  hookResumeLatency: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+  streamUpdates: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  cleanupDeletedRuns: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  workerClaims: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  workerClaimFailures: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  workerHeartbeatFailures: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  workerLeaseExtensions: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  workerLeaseReleases: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  pendingToClaimedLatency: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+  waitingToResumedLatency: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+  retryScheduled: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  retryExhausted: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+  retryDelay: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+  scheduleDueToRunCreatedLatency: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+  storageOperationDuration: import("@opentelemetry/api").Histogram<import("@opentelemetry/api").Attributes>;
+  storageOperationErrors: import("@opentelemetry/api").Counter<import("@opentelemetry/api").Attributes>;
+};
+//#endregion

package/dist/otel/metrics.mjs

@@ -0,0 +1,60 @@
+import { WORKFLOW_METRIC_NAMES } from "../telemetry.mjs";
+//#region src/otel/metrics.ts
+/** The counters and histograms the OpenTelemetry adapter records. */
+function createInstruments(meter) {
+	return {
+		runTransitions: meter.createCounter(WORKFLOW_METRIC_NAMES.runTransitions, { description: "Count of workflow run transitions." }),
+		runDuration: meter.createHistogram(WORKFLOW_METRIC_NAMES.runDuration, {
+			description: "Workflow run duration in milliseconds.",
+			unit: "ms"
+		}),
+		eventsAppended: meter.createCounter(WORKFLOW_METRIC_NAMES.eventsAppended, { description: "Count of durable workflow events appended." }),
+		stepAttempts: meter.createCounter(WORKFLOW_METRIC_NAMES.stepAttempts, { description: "Count of workflow step attempt updates." }),
+		stepDuration: meter.createHistogram(WORKFLOW_METRIC_NAMES.stepDuration, {
+			description: "Workflow step attempt duration in milliseconds.",
+			unit: "ms"
+		}),
+		messagesSent: meter.createCounter(WORKFLOW_METRIC_NAMES.messagesSent, { description: "Count of workflow messages sent." }),
+		messageWaitLatency: meter.createHistogram(WORKFLOW_METRIC_NAMES.messageWaitLatency, {
+			description: "Latency from workflow message wait creation to message receipt.",
+			unit: "ms"
+		}),
+		hooksResumed: meter.createCounter(WORKFLOW_METRIC_NAMES.hooksResumed, { description: "Count of workflow hooks resumed." }),
+		hookResumeLatency: meter.createHistogram(WORKFLOW_METRIC_NAMES.hookResumeLatency, {
+			description: "Latency from workflow hook wait creation to hook resume message receipt.",
+			unit: "ms"
+		}),
+		streamUpdates: meter.createCounter(WORKFLOW_METRIC_NAMES.streamUpdates, { description: "Count of workflow stream updates." }),
+		cleanupDeletedRuns: meter.createCounter(WORKFLOW_METRIC_NAMES.cleanupDeletedRuns, { description: "Count of workflow runs deleted by cleanup or retention operations." }),
+		workerClaims: meter.createCounter(WORKFLOW_METRIC_NAMES.workerClaims, { description: "Count of workflow run claims by workers." }),
+		workerClaimFailures: meter.createCounter(WORKFLOW_METRIC_NAMES.workerClaimFailures, { description: "Count of failed targeted workflow run claims by workers." }),
+		workerHeartbeatFailures: meter.createCounter(WORKFLOW_METRIC_NAMES.workerHeartbeatFailures, { description: "Count of failed workflow worker heartbeat lease extensions." }),
+		workerLeaseExtensions: meter.createCounter(WORKFLOW_METRIC_NAMES.workerLeaseExtensions, { description: "Count of workflow run lease extension attempts." }),
+		workerLeaseReleases: meter.createCounter(WORKFLOW_METRIC_NAMES.workerLeaseReleases, { description: "Count of workflow run lease releases." }),
+		pendingToClaimedLatency: meter.createHistogram(WORKFLOW_METRIC_NAMES.pendingToClaimedLatency, {
+			description: "Latency from workflow availability to worker claim in milliseconds.",
+			unit: "ms"
+		}),
+		waitingToResumedLatency: meter.createHistogram(WORKFLOW_METRIC_NAMES.runWaitingToResumedLatency, {
+			description: "Latency from workflow waiting state to resumed execution in milliseconds.",
+			unit: "ms"
+		}),
+		retryScheduled: meter.createCounter(WORKFLOW_METRIC_NAMES.retryScheduled, { description: "Count of workflow retries scheduled." }),
+		retryExhausted: meter.createCounter(WORKFLOW_METRIC_NAMES.retryExhausted, { description: "Count of workflow retries exhausted into permanent failure." }),
+		retryDelay: meter.createHistogram(WORKFLOW_METRIC_NAMES.retryDelay, {
+			description: "Delay until a scheduled workflow retry in milliseconds.",
+			unit: "ms"
+		}),
+		scheduleDueToRunCreatedLatency: meter.createHistogram(WORKFLOW_METRIC_NAMES.scheduleDueToRunCreatedLatency, {
+			description: "Latency from recurring schedule fire time to scheduled run creation.",
+			unit: "ms"
+		}),
+		storageOperationDuration: meter.createHistogram(WORKFLOW_METRIC_NAMES.storageOperationDuration, {
+			description: "Workflow storage/backend operation duration in milliseconds.",
+			unit: "ms"
+		}),
+		storageOperationErrors: meter.createCounter(WORKFLOW_METRIC_NAMES.storageOperationErrors, { description: "Count of workflow storage/backend operation failures." })
+	};
+}
+//#endregion
+export { createInstruments };

package/dist/otel/mod.d.mts

@@ -0,0 +1,3 @@
+import { OpenTelemetryWorkflowTelemetryOptions, createOpenTelemetryTelemetry } from "./telemetry.mjs";
+import { WORKFLOW_ATTRIBUTES, WORKFLOW_INSTRUMENTATION_NAME, WORKFLOW_INSTRUMENTATION_VERSION, WORKFLOW_MESSAGING_ATTRIBUTES, WORKFLOW_METRIC_NAMES, WORKFLOW_SPAN_NAMES, WORKFLOW_SYSTEM } from "../telemetry.mjs";
+export { type OpenTelemetryWorkflowTelemetryOptions, WORKFLOW_ATTRIBUTES, WORKFLOW_INSTRUMENTATION_NAME, WORKFLOW_INSTRUMENTATION_VERSION, WORKFLOW_MESSAGING_ATTRIBUTES, WORKFLOW_METRIC_NAMES, WORKFLOW_SPAN_NAMES, WORKFLOW_SYSTEM, createOpenTelemetryTelemetry };

package/dist/otel/mod.mjs

@@ -0,0 +1,3 @@
+import { WORKFLOW_ATTRIBUTES, WORKFLOW_INSTRUMENTATION_NAME, WORKFLOW_INSTRUMENTATION_VERSION, WORKFLOW_MESSAGING_ATTRIBUTES, WORKFLOW_METRIC_NAMES, WORKFLOW_SPAN_NAMES, WORKFLOW_SYSTEM } from "../telemetry.mjs";
+import { createOpenTelemetryTelemetry } from "./telemetry.mjs";
+export { WORKFLOW_ATTRIBUTES, WORKFLOW_INSTRUMENTATION_NAME, WORKFLOW_INSTRUMENTATION_VERSION, WORKFLOW_MESSAGING_ATTRIBUTES, WORKFLOW_METRIC_NAMES, WORKFLOW_SPAN_NAMES, WORKFLOW_SYSTEM, createOpenTelemetryTelemetry };

package/dist/otel/spans.d.mts

@@ -0,0 +1,24 @@
+import { ChildWorkflowStartedObservationEvent, CleanupObservationEvent, DurableEventObservationEvent, MessageObservationEvent, ResumeObservationEvent, ScheduleRunCreatedObservationEvent, ScheduleTickObservationEvent, StreamObservationEvent, WorkerOperationObservationEvent } from "../types/observation.mjs";
+import { MessageWaitCompletedEvent, MessageWaitStartedEvent } from "../types/events.mjs";
+import { History } from "../history/replay.mjs";
+import { Instruments } from "./metrics.mjs";
+import { Attributes, Tracer } from "@opentelemetry/api";
+//#region src/otel/spans.d.ts
+/** Records the spans for durable events, messages, hooks, schedules, workers, and streams. */
+export declare class SpanRecorder {
+  #private;
+  constructor(tracer: Tracer, metrics: Instruments, attributes: (attributes: Attributes) => Attributes);
+  recordDurableEventLatency(event: DurableEventObservationEvent, history: History): void;
+  recordDurableSleepSpan(event: DurableEventObservationEvent, history: History): void;
+  recordChildWorkflowOperationSpan(event: DurableEventObservationEvent, history: History): void;
+  recordChildWorkflowStartedSpan(event: ChildWorkflowStartedObservationEvent): void;
+  recordMessageSentSpan(event: MessageObservationEvent): void;
+  recordHookResumeSpan(kind: "hook" | "webhook", event: ResumeObservationEvent): void;
+  recordScheduleRunCreatedSpan(event: ScheduleRunCreatedObservationEvent): void;
+  recordScheduleTickSpan(event: ScheduleTickObservationEvent): void;
+  recordWorkerOperationSpan(event: WorkerOperationObservationEvent): void;
+  recordCleanupOperationSpan(source: "cleanup" | "retention", event: CleanupObservationEvent): void;
+  recordStreamOperationSpan(event: StreamObservationEvent): void;
+  recordMessageWaitSpan(completed: MessageWaitCompletedEvent, started: MessageWaitStartedEvent, history: History): void;
+}
+//#endregion