@usehelical/workflows 0.0.1-alpha.15 → 0.0.1-alpha.16

package/README.md

@@ -10,114 +10,3 @@ Simple, typesafe durable workflows without bundler magic
 - simple & typesafe api
 - minimal deployment complexity (just postgres)
 - low latency (making it suitable for user-facing ai workflows)
-
-# Getting started
-
-## Writing workflows
-
-```ts
-import * as wf from 'helical-workflows/workflow';
-
-async function indexDocument(url: string) {
-  // idempotent retryable durable steps
-  const document = await wf.runStep(async () => fetchDocument(url), { maxRetries: 5 });
-  const parsedDocument = await wf.runStep(async () => parseDocument(document));
-  await wf.runStep(async () => upsertIntoDb(parsedDocument));
-}
-
-const indexDocumentWorkflow = defineWorkflow(indexDocument);
-
-const indexingQueue = defineQueue();
-
-async function processDocumentBatch(urls: string[]) {
-  const handles = [];
-
-  // enqueue all documents for indexing
-  for (const url of urls) {
-    const runHandle = await wf.enqueueWorkflow(indexingQueue, indexDocument, [url]);
-    handles.push(runHandle);
-  }
-
-  let successfulCount = 0;
-  let failedCount = 0;
-
-  // wait for all documents to be indexed
-  for (const handle of handles) {
-    try {
-      await handle.result();
-      successfulCount++;
-    } catch (error) {
-      failedCount++;
-    }
-  }
-
-  return { successfulCount, failedCount };
-}
-
-const processDocumentBatchWorkflow = defineWorkflow(processDocumentBatch);
-```
-
-## Running a workflow
-
-```ts
-// create instance and register workflows and queues
-const { runWorkflow } = createInstance({
-  workflows: { indexDocumentWorkflow, processDocumentBatchWorkflow },
-  queues: { indexingQueue },
-  options: { connectionString: 'dummy' },
-});
-
-const urls = ['a', 'b', 'c'];
-
-const run = await runWorkflow(processDocumentBatchWorkflow, urls);
-
-console.log(await run.result());
-```
-
-# Development roadmap
-
-## Messages
-
-Messages are a way of communicating with a workflow from the outside. This can be useful for human-in-the-loop workflows or for other signals. Messages are persisted in the database and atomically consumed adhering to once-and-only-once semantics.
-
-```ts
-const approvalMessage = defineMessage<ApprovalMessage>('approval');
-
-async function myWorkflowFunction() {
-  await wf.runStep(() => stageForApproval());
-  await wf.receiveMessage(approvalMessage);
-  await wf.runStep(() => publish());
-}
-```
-
-## State
-
-Workflow state is a way for workflows to expose state to the outside. The benefit of this state approach in comparison to other request handler approaches like in Temporal is that the workflow doesn’t have to be executing in order for the state to be retrievable. This makes it possible to retrieve state even if a workflow is already cancelled or finished.
-
-```ts
-async function myWorkflowFunction() {
-  await wf.setState({ progress: 50 });
-}
-```
-
-## Schedules
-
-Allow a workflow to be scheduled…
-
-## Streams
-
-Streams allow for publishing streaming data from workflows to the outside the primary use case for this is realtime streaming of LLM responses. I want to take a different approach to other workflow systems here and treat streams as side effects inside of workflows and not as durable outputs. Since LLM streaming responses can be quite quick persisting the token stream into the database is costly. My hypothesis is that stream persistence is not needed since resuming LLM streaming responses require [special handling](<[https://platform.claude.com/docs/en/build-with-claude/streaming#error-recovery](https://platform.claude.com/docs/en/build-with-claude/streaming#error-recovery)>) and in most cases it makes more sense to just regenerate the response. Usually non-idempotent side effects in workflows are prohibited to achieve durability guarantees. But in this case the correctness of the workflow doesn’t depend on the stream the stream is just a user experience optimisation.
-
-## Workflow suspension
-
-When implementing very long running workflows (days, months…) the workflow would still be the whole time in memory idling waiting for instance for a message or for a sleep() event. Workflow suspension would allow for workflows to be suspended when waiting and then replayed and continued when the event arrives. This happens at the cost of latency (since the workflow has to be replayed to reach its original state again after has been suspended) which is why I want to make this an optional feature.
-
-## Workflow version management
-
-A tricky topic. In production systems it is possible that workflows with old versions are still Pending or are Queued. I don’t know yet what is the best way to handle this but I’m leaning towards workflow versions that can be manually specified using a versionId or could be auto generated by creating a hash from the workflow code.
-
-## Chaos tests
-
-## OTEL Integration
-
-## CLI & Observability UI

package/dist/api.d.ts

@@ -0,0 +1,45 @@
+import { S as StateDefinition, M as MessageDefinition } from './state-DygxhGtl.js';
+export { Q as QueueDefinition, b as QueueOptions, c as QueueRateLimit, d as QueueSignature, R as RunStatus, T as TERMINAL_STATES, W as WorkflowDefinition, e as WorkflowFunction, a as WorkflowSignature, f as defineMessage, g as defineQueue, h as defineState, i as defineWorkflow } from './state-DygxhGtl.js';
+
+type RetryConfig = {
+    maxRetries?: number;
+    retryDelay?: number;
+    backOffRate?: number;
+};
+type RunStepOptions = RetryConfig & {
+    name?: string;
+};
+declare function runStep<TReturn>(stepFn: () => Promise<TReturn>, options?: RunStepOptions): Promise<TReturn | (TReturn extends void ? void : TReturn)>;
+declare function executeStepWithRetries<TReturn>(stepName: string, fn: () => Promise<TReturn>, retryConfig: RetryConfig): Promise<TReturn>;
+
+declare function setState<T = unknown>(state: StateDefinition<T> | string, value: T): Promise<void>;
+
+type ReceiveMessageOptions = {
+    timeout?: number;
+};
+declare function receiveMessage<T>(message: MessageDefinition<T> | string, options?: ReceiveMessageOptions): Promise<T>;
+
+/**
+ * Generates a stable, unique step ID based on the current run ID and sequence ID.
+ * This ID is deterministic and will remain the same across retries, making it
+ * suitable for use as an idempotency key with third-party systems.
+ *
+ * The step ID is a SHA-256 hash of the run ID and sequence ID, formatted as a
+ * hex string for easy use with external APIs.
+ *
+ * @returns A unique, stable identifier for the current step execution
+ */
+declare function getStepId(): string;
+
+declare function getAbortSignal(): AbortSignal;
+
+declare function getRunId(): string;
+
+declare function sleep(ms: number): Promise<void>;
+declare function cancellableSleep(ms: number, signal?: AbortSignal): Promise<void>;
+
+declare function randomUUID(): Promise<string>;
+
+declare function now(): Promise<number>;
+
+export { MessageDefinition, type ReceiveMessageOptions, type RetryConfig, StateDefinition, cancellableSleep, executeStepWithRetries, getAbortSignal, getRunId, getStepId, now, randomUUID, receiveMessage, runStep, setState, sleep };

package/dist/{workflows.js → api.js}

@@ -1,26 +1,26 @@
-import { getExecutionContext, returnOrThrowOperationResult, executeAndRecordOperation, FatalError, MaxRetriesExceededError, sleep, ErrorThatShouldNeverHappen, withDbRetry, serialize, WorkflowNotFoundError, deserializeError, deserialize, createRunHandle, insertPendingRun, executeWorkflow, insertMessage, QueueNotFoundError, enqueueRun, getState, StateNotAvailableError, waitForStateNotification, serializeError, OperationTimedOutError, RunCancelledError } from './chunk-TZSPUZQ3.js';
-export { MaxRecoveryAttemptsExceededError, QueueNotFoundError, TERMINAL_STATES, TimeoutError, WorkflowNotFoundError, defineWorkflow } from './chunk-TZSPUZQ3.js';
+import { getExecutionContext, returnOrThrowOperationResult, executeAndRecordOperation, FatalError, MaxRetriesExceededError, sleep, withDbRetry, serialize, OperationTimedOutError, serializeError, deserialize, RunCancelledError } from './chunk-HRDI7EOY.js';
+export { TERMINAL_STATES, defineWorkflow } from './chunk-HRDI7EOY.js';
 import { sql } from 'kysely';
-import crypto2, { createHash } from 'crypto';
+import crypto, { createHash } from 'crypto';
 
-// core/message.ts
+// src/api/message.ts
 function defineMessage(name) {
   return { name };
 }
 
-// core/queue.ts
-function defineQueue(options = {}) {
-  return () => options;
+// src/api/queue.ts
+function defineQueue(name, options = {}) {
+  return { name, ...options };
 }
 
-// core/state.ts
+// src/api/state.ts
 function defineState(name) {
   return {
     name
   };
 }
 
-// core/steps/run-step.ts
+// src/api/steps/run-step.ts
 async function runStep(stepFn, options = {}) {
   const { maxRetries, retryDelay, backOffRate } = options;
   const { operationManager } = getExecutionContext();
@@ -33,6 +33,11 @@ async function runStep(stepFn, options = {}) {
     return await executeStepWithRetries(stepName, stepFn, { maxRetries, retryDelay, backOffRate });
   });
 }
+var ErrorThatShouldNeverHappen = class extends Error {
+  constructor() {
+    super("This error should never happen");
+  }
+};
 async function executeStepWithRetries(stepName, fn, retryConfig) {
   const maxRetries = retryConfig.maxRetries ?? 0;
   const retryDelay = retryConfig.retryDelay ?? 0;
@@ -57,10 +62,10 @@ async function executeStepWithRetries(stepName, fn, retryConfig) {
       await sleep(delay);
     }
   }
-  throw new ErrorThatShouldNeverHappen(`Step "${stepName}" should never be reached`);
+  throw new ErrorThatShouldNeverHappen();
 }
 
-// core/internal/repository/insert-state.ts
+// src/internal/db/commands/insert-state.ts
 async function insertState(tx, options) {
   await tx.insertInto("state").values({
     run_id: options.runId,
@@ -79,7 +84,7 @@ async function insertState(tx, options) {
   }).execute();
 }
 
-// core/steps/set-state.ts
+// src/api/steps/set-state.ts
 var SET_STATE_OPERATION_NAME = "workflow::state::set";
 async function setState(state, value) {
   const stateKey = typeof state === "string" ? state : state.name;
@@ -116,7 +121,7 @@ async function readAndDeleteMessage(tx, runId, messageType) {
   } : void 0;
 }
 
-// core/internal/with-durable-deadline.ts
+// src/internal/with-durable-deadline.ts
 async function withDurableDeadline(timeoutMs, operationName, fn) {
   if (!timeoutMs) {
     return await fn(void 0);
@@ -135,7 +140,7 @@ async function withDurableDeadline(timeoutMs, operationName, fn) {
   return await fn(deadlineMs);
 }
 
-// core/steps/receive-message.ts
+// src/api/steps/receive-message.ts
 var RECEIVE_MESSAGE_OPERATION_NAME = "receiveMessage";
 var RECEIVE_MESSAGE_DURABLE_DEADLINE_OPERATION_NAME = "receiveMessageDurableDeadline";
 var MessageNotAvailableError = class extends Error {
@@ -229,18 +234,18 @@ function getStepId() {
   return hash.digest("hex");
 }
 
-// core/steps/helpers/get-abort-signal.ts
+// src/api/steps/helpers/get-abort-signal.ts
 function getAbortSignal() {
   return getExecutionContext().abortSignal;
 }
 
-// core/steps/helpers/get-run-id.ts
+// src/api/steps/helpers/get-run-id.ts
 function getRunId() {
   const { runId } = getExecutionContext();
   return runId;
 }
 
-// core/steps/sleep.ts
+// src/api/steps/sleep.ts
 var SLEEP_OPERATION_NAME = "_helical::sleep";
 async function sleep2(ms) {
   const { abortSignal } = getExecutionContext();
@@ -281,111 +286,12 @@ async function randomUUID() {
     return existingResult.result;
   } else {
     return await executeAndRecordOperation(operationManager, "randomUUID", async () => {
-      return crypto2.randomUUID();
-    });
-  }
-}
-async function runWorkflow(wf, args = [], options = {}) {
-  const ctx = getExecutionContext();
-  const { operationManager, runPath, workflowRegistry, db, executorId } = ctx;
-  const workflow = typeof wf === "string" ? workflowRegistry.getByName(wf) : workflowRegistry.getByWorkflowDefinition(wf);
-  if (!workflow) {
-    throw new WorkflowNotFoundError("Workflow not found");
-  }
-  const op = operationManager.getOperationResult();
-  if (op) {
-    if (op.error) {
-      throw deserializeError(op.error);
-    }
-    const newRun2 = deserialize(op.result);
-    return createRunHandle(ctx, newRun2.runId);
-  }
-  const newRun = await executeAndRecordOperation(operationManager, "runWorkflow", async () => {
-    const newRunId = options.id ?? crypto2.randomUUID();
-    const newRun2 = {
-      runId: newRunId,
-      runPath: [...runPath, newRunId],
-      workflowName: workflow.name
-    };
-    withDbRetry(async () => {
-      return await insertPendingRun(db, {
-        ...newRun2,
-        path: newRun2.runPath,
-        inputs: serialize(args),
-        executorId
-      });
+      return crypto.randomUUID();
     });
-    return newRun2;
-  });
-  await executeWorkflow(ctx, {
-    runId: newRun.runId,
-    runPath: newRun.runPath,
-    workflowName: newRun.workflowName,
-    fn: workflow.fn,
-    args,
-    options
-  });
-  return createRunHandle(ctx, newRun.runId);
-}
-
-// core/steps/send-message.ts
-var SEND_MESSAGE_OPERATION_NAME = "workflow::message::send";
-async function sendMessage(target, name, data) {
-  const { operationManager, db } = getExecutionContext();
-  const destinationWorkflowId = typeof target === "string" ? target : target.id;
-  const messageType = typeof name === "string" ? name : name.name;
-  const prevOp = operationManager.getOperationResult();
-  if (prevOp) {
-    return returnOrThrowOperationResult(prevOp);
-  }
-  const seqId = operationManager.reserveSequenceId();
-  const serializedData = serialize(data);
-  await withDbRetry(async () => {
-    return await db.transaction().execute(async (tx) => {
-      await insertMessage(tx, { destinationWorkflowId, messageType, data: serializedData });
-      await operationManager.recordResult(SEND_MESSAGE_OPERATION_NAME, seqId, null, tx);
-    });
-  });
-}
-
-// core/steps/queue-workflow.ts
-async function queueWorkflow(queue, wf, args, options) {
-  const ctx = getExecutionContext();
-  const { db, operationManager, queueRegistry, workflowRegistry, runPath, executorId } = ctx;
-  const workflowName = typeof wf === "string" ? wf : workflowRegistry.getByWorkflowDefinition(wf)?.name;
-  if (!workflowName) {
-    throw new WorkflowNotFoundError("Workflow name not specified");
-  }
-  const queueName = typeof queue === "string" ? queue : queueRegistry.getByQueueEntry(queue)?.name;
-  if (!queueName) {
-    throw new QueueNotFoundError("Queue name not specified");
   }
-  const op = operationManager.getOperationResult();
-  if (op) {
-    if (op.error) {
-      throw deserializeError(op.error);
-    }
-    const newRunId2 = deserialize(op.result);
-    return createRunHandle(ctx, newRunId2);
-  }
-  const newRunId = await executeAndRecordOperation(operationManager, "queueWorkflow", async () => {
-    const newRunId2 = options?.id ?? crypto.randomUUID();
-    const { runId } = await enqueueRun(db, {
-      runId: newRunId2,
-      path: [...runPath, newRunId2],
-      inputs: serialize(args),
-      executorId,
-      workflowName,
-      queueName,
-      timeout: options?.timeout,
-      deadline: options?.deadline
-    });
-    return runId;
-  });
-  return createRunHandle(ctx, newRunId);
 }
 
-// core/steps/now.ts
+// src/api/steps/now.ts
 async function now() {
   const { operationManager } = getExecutionContext();
   const op = operationManager.getOperationResult();
@@ -398,37 +304,6 @@ async function now() {
   }
 }
 
-// core/steps/get-state.ts
-async function getState2(target, key) {
-  const { operationManager, db, stateEventBus } = getExecutionContext();
-  const stateKey = typeof key === "string" ? key : key.name;
-  const targetId = typeof target === "string" ? target : target.id;
-  const op = operationManager.getOperationResult();
-  if (op) {
-    return returnOrThrowOperationResult(op);
-  }
-  const seqId = operationManager.reserveSequenceId();
-  while (true) {
-    try {
-      return await withDbRetry(async () => {
-        const state = await getState(db, targetId, stateKey);
-        if (!state) {
-          throw new StateNotAvailableError();
-        }
-        await operationManager.recordResult("getState", seqId, state);
-        return deserialize(state);
-      });
-    } catch (error) {
-      if (error instanceof StateNotAvailableError) {
-        await waitForStateNotification(stateEventBus, targetId, stateKey);
-        continue;
-      }
-      await operationManager.recordError("getState", seqId, serializeError(error));
-      throw error;
-    }
-  }
-}
-
-export { cancellableSleep, defineMessage, defineQueue, defineState, executeStepWithRetries, getAbortSignal, getRunId, getState2 as getState, getStepId, now, queueWorkflow, randomUUID, receiveMessage, runStep, runWorkflow, sendMessage, setState, sleep2 as sleep };
-//# sourceMappingURL=workflows.js.map
-//# sourceMappingURL=workflows.js.map
+export { cancellableSleep, defineMessage, defineQueue, defineState, executeStepWithRetries, getAbortSignal, getRunId, getStepId, now, randomUUID, receiveMessage, runStep, setState, sleep2 as sleep };
+//# sourceMappingURL=api.js.map
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api/message.ts","../src/api/queue.ts","../src/api/state.ts","../src/api/steps/run-step.ts","../src/internal/db/commands/insert-state.ts","../src/api/steps/set-state.ts","../src/internal/db/commands/read-and-delete-message.ts","../src/internal/with-durable-deadline.ts","../src/api/steps/receive-message.ts","../src/api/steps/helpers/get-step-id.ts","../src/api/steps/helpers/get-abort-signal.ts","../src/api/steps/helpers/get-run-id.ts","../src/api/steps/sleep.ts","../src/api/steps/random-uuid.ts","../src/api/steps/now.ts"],"names":["sleep"],"mappings":"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","file":"api.js","sourcesContent":["export type MessageDefinition<T> = {\n  name: string;\n  __data?: T;\n};\n\nexport function defineMessage<T>(name: string): MessageDefinition<T> {\n  return { name } as MessageDefinition<T>;\n}\n","export type QueueRateLimit = {\n  limitPerPeriod: number;\n  period: number;\n};\n\nexport type QueueOptions = {\n  workerConcurrency?: number;\n  concurrency?: number;\n  rateLimit?: QueueRateLimit;\n  priorityEnabled?: boolean;\n  partitioningEnabled?: boolean;\n};\n\nexport type QueueDefinition = QueueOptions & { name: string };\n\nexport type QueueSignature = {\n  name: string;\n};\n\nexport function defineQueue(name: string, options: QueueOptions = {}): QueueDefinition {\n  return { name, ...options };\n}\n","export interface StateDefinition<T> {\n  name: string;\n  data?: T;\n}\n\nexport function defineState<T>(name: string) {\n  return {\n    name,\n  } as StateDefinition<T>;\n}\n","import { FatalError, MaxRetriesExceededError } from '@internal/errors';\nimport { getExecutionContext } from '@internal/context/execution-context';\nimport { sleep } from '@internal/utils/sleep';\nimport {\n  executeAndRecordOperation,\n  returnOrThrowOperationResult,\n} from '@internal/context/operation-manager';\n\nexport type RetryConfig = {\n  maxRetries?: number;\n  retryDelay?: number;\n  backOffRate?: number;\n};\n\ntype RunStepOptions = RetryConfig & {\n  name?: string;\n};\n\nexport async function runStep<TReturn>(\n  stepFn: () => Promise<TReturn>,\n  options: RunStepOptions = {},\n) {\n  const { maxRetries, retryDelay, backOffRate } = options;\n  const { operationManager } = getExecutionContext();\n  const stepName = options.name || stepFn.name || '<unknown>';\n\n  const op = operationManager.getOperationResult();\n  if (op) {\n    return returnOrThrowOperationResult<TReturn>(op);\n  }\n  return await executeAndRecordOperation(operationManager, stepName, async () => {\n    return await executeStepWithRetries(stepName, stepFn, { maxRetries, retryDelay, backOffRate });\n  });\n}\n\nclass ErrorThatShouldNeverHappen extends Error {\n  constructor() {\n    super('This error should never happen');\n  }\n}\n\nexport async function executeStepWithRetries<TReturn>(\n  stepName: string,\n  fn: () => Promise<TReturn>,\n  retryConfig: RetryConfig,\n): Promise<TReturn> {\n  const maxRetries = retryConfig.maxRetries ?? 0;\n  const retryDelay = retryConfig.retryDelay ?? 0;\n  const backOffRate = retryConfig.backOffRate ?? 1;\n\n  const attemptErrors: Error[] = [];\n\n  for (let attempt = 0; attempt <= maxRetries; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      const err = error instanceof Error ? error : new Error(String(error));\n      attemptErrors.push(err);\n      if (err instanceof FatalError) {\n        throw err;\n      }\n      if (maxRetries === 0) {\n        throw err;\n      }\n      if (attempt >= maxRetries) {\n        throw new MaxRetriesExceededError(stepName, maxRetries, attemptErrors);\n      }\n      const delay = retryDelay * Math.pow(backOffRate, attempt);\n      await sleep(delay);\n    }\n  }\n  throw new ErrorThatShouldNeverHappen();\n}\n","import { Database, Transaction } from '../db';\n\ntype InsertStateOptions = {\n  runId: string;\n  key: string;\n  value: string;\n  sequenceId: number;\n};\n\nexport async function insertState(tx: Transaction | Database, options: InsertStateOptions) {\n  await tx\n    .insertInto('state')\n    .values({\n      run_id: options.runId,\n      key: options.key,\n      value: options.value,\n    })\n    .onConflict((oc) =>\n      oc.column('run_id').column('key').doUpdateSet({\n        value: options.value,\n      }),\n    )\n    .execute();\n\n  await tx\n    .insertInto('state_history')\n    .values({\n      run_id: options.runId,\n      sequence_id: options.sequenceId,\n      key: options.key,\n      value: options.value,\n    })\n    .execute();\n}\n","import { withDbRetry } from '@internal/db/retry';\nimport { getExecutionContext } from '@internal/context/execution-context';\nimport { returnOrThrowOperationResult } from '@internal/context/operation-manager';\nimport { insertState } from '@internal/db/commands/insert-state';\nimport { serialize } from '@internal/utils/serialization';\nimport { StateDefinition } from '@api/state';\n\nconst SET_STATE_OPERATION_NAME = 'workflow::state::set';\n\nexport async function setState<T = unknown>(state: StateDefinition<T> | string, value: T) {\n  const stateKey = typeof state === 'string' ? state : state.name;\n  const { operationManager, runId, db } = getExecutionContext();\n\n  const op = operationManager.getOperationResult();\n  if (op) {\n    return returnOrThrowOperationResult<void>(op);\n  }\n\n  const seqId = operationManager.reserveSequenceId();\n\n  await withDbRetry(async () => {\n    return await db.transaction().execute(async (tx) => {\n      await insertState(tx, { runId, key: stateKey, value: serialize(value), sequenceId: seqId });\n      await operationManager.recordResult(SET_STATE_OPERATION_NAME, seqId, null, tx);\n    });\n  });\n}\n","import { sql } from 'kysely';\nimport { Transaction } from '../db';\n\ntype Message = {\n  id: string;\n  payload?: string;\n  type?: string;\n};\n\nexport async function readAndDeleteMessage(\n  tx: Transaction,\n  runId: string,\n  messageType?: string,\n): Promise<Message | undefined> {\n  const results = await sql<Message>`\n    DELETE FROM messages\n    WHERE id IN (\n      SELECT id FROM messages\n      WHERE destination_run_id = ${runId}\n      ${messageType !== undefined ? sql`AND type = ${messageType}` : sql``}\n      ORDER BY created_at_epoch_ms ASC\n      LIMIT 1\n    )\n    RETURNING id, payload, type\n  `.execute(tx);\n\n  const result = results.rows[0];\n\n  return result\n    ? {\n        id: result.id,\n        payload: result.payload ?? undefined,\n        type: result.type ?? undefined,\n      }\n    : undefined;\n}\n","import { getExecutionContext } from './context/execution-context';\nimport { executeAndRecordOperation } from './context/operation-manager';\n\nexport async function withDurableDeadline<T>(\n  timeoutMs: number | undefined,\n  operationName: string,\n  fn: (deadlineMs: number | undefined) => Promise<T>,\n): Promise<T> {\n  if (!timeoutMs) {\n    return await fn(undefined);\n  }\n\n  const { operationManager } = getExecutionContext();\n\n  let deadlineMs: number;\n  const op = operationManager.getOperationResult();\n  if (op) {\n    deadlineMs = Number(op.result);\n  } else {\n    deadlineMs = Date.now() + timeoutMs;\n    await executeAndRecordOperation(operationManager, operationName, async () => {\n      return deadlineMs;\n    });\n  }\n\n  return await fn(deadlineMs);\n}\n","import { withDbRetry } from '@internal/db/retry';\nimport { OperationTimedOutError } from '@internal/errors';\nimport { MessageEventBus } from '@internal/events/message-event-bus';\nimport { getExecutionContext } from '@internal/context/execution-context';\nimport { returnOrThrowOperationResult } from '@internal/context/operation-manager';\nimport { readAndDeleteMessage } from '@internal/db/commands/read-and-delete-message';\nimport { deserialize, serialize, serializeError } from '@internal/utils/serialization';\nimport { withDurableDeadline } from '@internal/with-durable-deadline';\nimport { MessageDefinition } from '@api/message';\n\nconst RECEIVE_MESSAGE_OPERATION_NAME = 'receiveMessage';\n\nconst RECEIVE_MESSAGE_DURABLE_DEADLINE_OPERATION_NAME = 'receiveMessageDurableDeadline';\n\nclass MessageNotAvailableError extends Error {}\n\nexport type ReceiveMessageOptions = {\n  timeout?: number;\n};\n\nexport async function receiveMessage<T>(\n  message: MessageDefinition<T> | string,\n  options?: ReceiveMessageOptions,\n): Promise<T> {\n  const messageType = typeof message === 'string' ? message : message.name;\n  return await withDurableDeadline(\n    options?.timeout,\n    RECEIVE_MESSAGE_DURABLE_DEADLINE_OPERATION_NAME,\n    async (deadlineMs) => {\n      return await receiveMessageWithDeadline(messageType, deadlineMs);\n    },\n  );\n}\n\nasync function receiveMessageWithDeadline<T>(\n  messageType: string,\n  deadlineMs: number | undefined,\n): Promise<T> {\n  const { runId, operationManager, messageEventBus, db } = getExecutionContext();\n\n  const op = operationManager.getOperationResult();\n  if (op) {\n    return returnOrThrowOperationResult<T>(op) as T;\n  }\n\n  const seqId = operationManager.reserveSequenceId();\n\n  while (true) {\n    // Check if timeout expired\n    if (deadlineMs && Date.now() >= deadlineMs) {\n      const error = new OperationTimedOutError('receiveMessage');\n      await operationManager.recordError(\n        RECEIVE_MESSAGE_OPERATION_NAME,\n        seqId,\n        serializeError(error),\n      );\n      throw error;\n    }\n\n    try {\n      return await withDbRetry(async () => {\n        return await db.transaction().execute(async (tx) => {\n          const msg = await readAndDeleteMessage(tx, runId, messageType);\n          if (!msg) {\n            throw new MessageNotAvailableError();\n          }\n          await operationManager.recordResult(\n            RECEIVE_MESSAGE_OPERATION_NAME,\n            seqId,\n            serialize(msg.payload),\n            tx,\n          );\n          return deserialize(msg.payload!) as T;\n        });\n      });\n    } catch (error) {\n      if (error instanceof MessageNotAvailableError) {\n        const remainingMs = deadlineMs ? deadlineMs - Date.now() : undefined;\n        await waitForMessageNotification(messageEventBus, runId, messageType, remainingMs);\n        continue;\n      }\n      // Record and re-throw other errors\n      await operationManager.recordError(\n        RECEIVE_MESSAGE_OPERATION_NAME,\n        seqId,\n        serializeError(error as Error),\n      );\n      throw error;\n    }\n  }\n}\n\nasync function waitForMessageNotification(\n  messageEventBus: MessageEventBus,\n  runId: string,\n  messageType: string,\n  timeoutMs?: number,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    let timeoutId: NodeJS.Timeout | undefined;\n\n    if (timeoutMs !== undefined) {\n      if (timeoutMs <= 0) {\n        reject(new OperationTimedOutError('receiveMessageDurableDeadline'));\n        return;\n      }\n\n      timeoutId = setTimeout(() => {\n        unsubscribe();\n        reject(new OperationTimedOutError('waitForMessageNotification'));\n      }, timeoutMs);\n    }\n\n    const unsubscribe = messageEventBus.subscribe(runId, messageType, () => {\n      if (timeoutId) clearTimeout(timeoutId);\n      unsubscribe();\n      resolve();\n    });\n  });\n}\n","import { getExecutionContext } from '@internal/context/execution-context';\nimport { createHash } from 'node:crypto';\n\n/**\n * Generates a stable, unique step ID based on the current run ID and sequence ID.\n * This ID is deterministic and will remain the same across retries, making it\n * suitable for use as an idempotency key with third-party systems.\n *\n * The step ID is a SHA-256 hash of the run ID and sequence ID, formatted as a\n * hex string for easy use with external APIs.\n *\n * @returns A unique, stable identifier for the current step execution\n */\nexport function getStepId(): string {\n  const ctx = getExecutionContext();\n  const sequenceId = ctx.operationManager.getActiveSequenceId();\n\n  if (sequenceId === null) {\n    throw new Error('getStepId() can only be called from within a step function');\n  }\n\n  const hash = createHash('sha256');\n  hash.update(`${ctx.runId}:${sequenceId}`);\n  return hash.digest('hex');\n}\n","import { getExecutionContext } from '@internal/context/execution-context';\n\nexport function getAbortSignal() {\n  return getExecutionContext().abortSignal;\n}\n","import { getExecutionContext } from '@internal/context/execution-context';\n\nexport function getRunId() {\n  const { runId } = getExecutionContext();\n  return runId;\n}\n","import { RunCancelledError } from '@internal/errors';\nimport { getExecutionContext } from '@internal/context/execution-context';\nimport { withDurableDeadline } from '@internal/with-durable-deadline';\n\nconst SLEEP_OPERATION_NAME = '_helical::sleep';\n\nexport async function sleep(ms: number) {\n  const { abortSignal } = getExecutionContext();\n  return await withDurableDeadline(ms, SLEEP_OPERATION_NAME, async (deadlineMs) => {\n    const remainingMs = deadlineMs! - Date.now();\n    try {\n      await cancellableSleep(remainingMs, abortSignal);\n    } catch {\n      throw new RunCancelledError();\n    }\n  });\n}\n\nexport function cancellableSleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new Error('Sleep aborted'));\n      return;\n    }\n\n    const timeoutId = setTimeout(() => {\n      cleanup();\n      resolve();\n    }, ms);\n\n    const onAbort = () => {\n      cleanup();\n      reject(new Error('Sleep aborted'));\n    };\n\n    const cleanup = () => {\n      clearTimeout(timeoutId);\n      signal?.removeEventListener('abort', onAbort);\n    };\n\n    signal?.addEventListener('abort', onAbort);\n  });\n}\n","import crypto from 'node:crypto';\nimport { getExecutionContext } from '@internal/context/execution-context';\nimport { executeAndRecordOperation } from '@internal/context/operation-manager';\n\nexport async function randomUUID() {\n  const { operationManager } = getExecutionContext();\n  const existingResult = operationManager.getOperationResult();\n  if (existingResult) {\n    return existingResult.result as string;\n  } else {\n    return await executeAndRecordOperation(operationManager, 'randomUUID', async () => {\n      return crypto.randomUUID();\n    });\n  }\n}\n","import { getExecutionContext } from '@internal/context/execution-context';\nimport { executeAndRecordOperation } from '@internal/context/operation-manager';\n\nexport async function now() {\n  const { operationManager } = getExecutionContext();\n  const op = operationManager.getOperationResult();\n  if (op) {\n    return Number(op.result);\n  } else {\n    return await executeAndRecordOperation(operationManager, 'now', async () => {\n      return Date.now();\n    });\n  }\n}\n"]}