@hotmeshio/hotmesh 0.12.1 → 0.14.0

package/README.md

@@ -61,13 +61,11 @@ export async function notifyBackorder(itemId: string): Promise<void> {
 ```typescript
 // workflows.ts
 import { Durable } from '@hotmeshio/hotmesh';
-import * as activities from './activities';
+import type * as activities from './activities';
 
 export async function orderWorkflow(itemId: string, qty: number) {
   const { checkInventory, reserveItem, notifyBackorder } =
-    Durable.workflow.proxyActivities<typeof activities>({
-      taskQueue: 'inventory-tasks'
-    });
+    Durable.workflow.proxyActivities<typeof activities>();
 
   const available = await checkInventory(itemId);
 
@@ -80,20 +78,18 @@ export async function orderWorkflow(itemId: string, qty: number) {
 }
 
 // main.ts
+import * as activities from './activities';
+
 const connection = {
   class: Postgres,
   options: { connectionString: 'postgresql://localhost:5432/mydb' }
 };
 
-await Durable.registerActivityWorker({
-  connection,
-  taskQueue: 'inventory-tasks'
-}, activities, 'inventory-activities');
-
 await Durable.Worker.create({
   connection,
   taskQueue: 'orders',
-  workflow: orderWorkflow
+  workflow: orderWorkflow,
+  activities,
 });
 
 const client = new Durable.Client({ connection });
@@ -206,11 +202,11 @@ All snippets below run inside a workflow function (like `orderWorkflow` above).
 import { Durable } from '@hotmeshio/hotmesh';
 ```
 
-**Long-running workflows** — `sleepFor` is durable. The process can restart; the timer survives.
+**Long-running workflows** — `sleep` is durable. The process can restart; the timer survives.
 
 ```typescript
 // sendFollowUp is a proxied activity from proxyActivities()
-await Durable.workflow.sleepFor('30 days');
+await Durable.workflow.sleep('30 days');
 await sendFollowUp();
 ```
 
@@ -228,18 +224,18 @@ const [payment, inventory, shipment] = await Promise.all([
 **Child workflows** — compose workflows from other workflows.
 
 ```typescript
-const childHandle = await Durable.workflow.startChild(validateOrder, {
+const result = await Durable.workflow.executeChild({
   args: [orderId],
   taskQueue: 'validation',
-  workflowId: `validate-${orderId}`
+  workflowName: 'validateOrder',
+  workflowId: `validate-${orderId}`,
 });
-const validation = await childHandle.result();
 ```
 
 **Signals** — pause a workflow until an external event arrives.
 
 ```typescript
-const approval = await Durable.workflow.waitFor<{ approved: boolean }>('manager-approval');
+const approval = await Durable.workflow.condition<{ approved: boolean }>('manager-approval');
 if (!approval.approved) return 'rejected';
 ```
 
@@ -248,10 +244,9 @@ if (!approval.approved) return 'rejected';
 Activities retry automatically on failure. Configure the policy per activity or per worker:
 
 ```typescript
-// Durable: per-activity retry policy
+// Durable: per-activity retry policy (activities registered at Worker.create)
 const { reserveItem } = Durable.workflow.proxyActivities<typeof activities>({
-  taskQueue: 'inventory-tasks',
-  retryPolicy: {
+  retry: {
     maximumAttempts: 5,
     backoffCoefficient: 2,
     maximumInterval: '60s'
@@ -267,7 +262,7 @@ const hotMesh = await HotMesh.init({
   workers: [{
     topic: 'inventory.reserve',
     connection,
-    retryPolicy: {
+    retry: {
       maximumAttempts: 5,
       backoffCoefficient: 2,
       maximumInterval: '60s'
@@ -290,7 +285,8 @@ SELECT
   j.key          AS job_key,
   j.status       AS semaphore,
   j.entity       AS workflow,
-  a.field        AS attribute,
+  a.symbol       AS attribute,
+  a.dimension    AS dimension,
   a.value        AS value,
   j.created_at,
   j.updated_at
@@ -300,7 +296,7 @@ FROM
 WHERE
   j.key = 'order-456'
 ORDER BY
-  a.field;
+  a.symbol, a.dimension;
 ```
 
 What happened? Consult the database. What's still running? Query the semaphore. What failed? Read the row. The execution state isn't reconstructed from a log — it was committed transactionally as each step ran.

package/build/modules/enums.d.ts

@@ -4,7 +4,51 @@ import { LogLevel } from '../types/logger';
  */
 export declare const HMSH_LOGLEVEL: LogLevel;
 /**
- * Determines the log level for telemetry. The default is 'info' which emits worker and trigger spans. 'debug' emits all spans.
+ * Controls which OpenTelemetry spans are emitted. Spans are only
+ * captured when an OTel SDK (TracerProvider + exporter) is registered
+ * before workers start. Without an SDK, all span calls are no-ops.
+ *
+ * ## Modes
+ *
+ * | Value | Durable workflows | YAML flows |
+ * |-------|-------------------|------------|
+ * | `'info'` (default) | `WORKFLOW/START`, `WORKFLOW/COMPLETE`, `WORKFLOW/ERROR`, `ACTIVITY/{name}` | trigger + worker spans |
+ * | `'debug'` | All `info` spans + `DISPATCH/{type}/{name}/{idx}`, `RETURN/{type}/{name}/{idx}` + engine internals | All activity types + all stream hops |
+ *
+ * ## Setup
+ *
+ * Register an OpenTelemetry SDK with a trace exporter **before**
+ * calling `Durable.Worker.create()`. Any OTLP-compatible backend
+ * works (Honeycomb, Jaeger, Grafana Tempo, etc.):
+ *
+ * ```typescript
+ * import { NodeSDK } from '@opentelemetry/sdk-node';
+ * import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-proto';
+ * import { resourceFromAttributes } from '@opentelemetry/resources';
+ * import { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';
+ *
+ * const sdk = new NodeSDK({
+ *   resource: resourceFromAttributes({
+ *     [ATTR_SERVICE_NAME]: 'my-service',
+ *   }),
+ *   traceExporter: new OTLPTraceExporter({
+ *     url: 'https://api.honeycomb.io/v1/traces',
+ *     headers: { 'x-honeycomb-team': process.env.HONEYCOMB_API_KEY },
+ *   }),
+ * });
+ * sdk.start();
+ *
+ * // Then start workers — spans flow automatically
+ * await Durable.Worker.create({ ... });
+ * ```
+ *
+ * ```bash
+ * # Concise: workflow lifecycle + activity execution only
+ * HMSH_TELEMETRY=info node worker.js
+ *
+ * # Verbose: adds per-operation DISPATCH/RETURN spans + engine internals
+ * HMSH_TELEMETRY=debug node worker.js
+ * ```
  */
 export declare const HMSH_TELEMETRY: "debug" | "info";
 /**
@@ -34,6 +78,10 @@ export declare const HMSH_CODE_DURABLE_CHILD = 590;
  * This is thrown when a Durable has been interrupted by a proxyActivity call.
  */
 export declare const HMSH_CODE_DURABLE_PROXY = 591;
+/**
+ * This is thrown when a Durable has been interrupted by a continueAsNew call.
+ */
+export declare const HMSH_CODE_DURABLE_CONTINUE = 592;
 /**
  * This is thrown when a Durable has been interrupted by a waitForSignal call.
  */
@@ -83,9 +131,9 @@ export declare const HMSH_MAX_TIMEOUT_MS: number;
 export declare const HMSH_GRADUATED_INTERVAL_MS: number;
 /**
  * The maximum number of attempts to retry a Durable job before it is considered failed.
- * @default 3
+ * @default 50
  */
-export declare const HMSH_DURABLE_MAX_ATTEMPTS = 3;
+export declare const HMSH_DURABLE_MAX_ATTEMPTS = 50;
 /**
  * The maximum interval to wait before retrying a Durable job.
  * @default 120s
@@ -93,9 +141,16 @@ export declare const HMSH_DURABLE_MAX_ATTEMPTS = 3;
 export declare const HMSH_DURABLE_MAX_INTERVAL = "120s";
 /**
  * The exponential backoff factor to apply to the interval between retries.
- * @default 10
+ * @default 5
+ */
+export declare const HMSH_DURABLE_EXP_BACKOFF = 5;
+/**
+ * The initial interval (in seconds) before the first retry attempt.
+ * The retry formula is: initialInterval * backoffCoefficient^retryCount,
+ * clamped by maximumInterval.
+ * @default 1
  */
-export declare const HMSH_DURABLE_EXP_BACKOFF = 10;
+export declare const HMSH_DURABLE_INITIAL_INTERVAL = 1;
 export declare const HMSH_BLOCK_TIME_MS: number;
 export declare const HMSH_XCLAIM_DELAY_MS: number;
 export declare const HMSH_XCLAIM_COUNT: number;

package/build/modules/enums.js

@@ -1,13 +1,57 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HMSH_NOTIFY_PAYLOAD_LIMIT = exports.DEFAULT_TASK_QUEUE = exports.HMSH_GUID_SIZE = exports.HMSH_ROUTER_SCOUT_INTERVAL_MS = exports.HMSH_ROUTER_SCOUT_INTERVAL_SECONDS = exports.HMSH_SCOUT_INTERVAL_SECONDS = exports.HMSH_FIDELITY_SECONDS = exports.HMSH_EXPIRE_DURATION = exports.HMSH_XPENDING_COUNT = exports.HMSH_XCLAIM_COUNT = exports.HMSH_XCLAIM_DELAY_MS = exports.HMSH_BLOCK_TIME_MS = exports.HMSH_DURABLE_EXP_BACKOFF = exports.HMSH_DURABLE_MAX_INTERVAL = exports.HMSH_DURABLE_MAX_ATTEMPTS = exports.HMSH_GRADUATED_INTERVAL_MS = exports.HMSH_MAX_TIMEOUT_MS = exports.HMSH_POISON_MESSAGE_THRESHOLD = exports.HMSH_MAX_RETRIES = exports.MAX_DELAY = exports.MAX_STREAM_RETRIES = exports.INITIAL_STREAM_BACKOFF = exports.MAX_STREAM_BACKOFF = exports.HMSH_EXPIRE_JOB_SECONDS = exports.HMSH_OTT_WAIT_TIME = exports.HMSH_DEPLOYMENT_PAUSE = exports.HMSH_DEPLOYMENT_DELAY = exports.HMSH_ACTIVATION_MAX_RETRY = exports.HMSH_QUORUM_DELAY_MS = exports.HMSH_QUORUM_ROLLCALL_CYCLES = exports.HMSH_STATUS_UNKNOWN = exports.HMSH_CODE_DURABLE_RETRYABLE = exports.HMSH_CODE_DURABLE_FATAL = exports.HMSH_CODE_DURABLE_MAXED = exports.HMSH_CODE_DURABLE_TIMEOUT = exports.HMSH_CODE_DURABLE_WAIT = exports.HMSH_CODE_DURABLE_PROXY = exports.HMSH_CODE_DURABLE_CHILD = exports.HMSH_CODE_DURABLE_ALL = exports.HMSH_CODE_DURABLE_SLEEP = exports.HMSH_CODE_UNACKED = exports.HMSH_CODE_TIMEOUT = exports.HMSH_CODE_UNKNOWN = exports.HMSH_CODE_INTERRUPT = exports.HMSH_CODE_NOTFOUND = exports.HMSH_CODE_PENDING = exports.HMSH_CODE_SUCCESS = exports.HMSH_SIGNAL_EXPIRE = exports.HMSH_TELEMETRY = exports.HMSH_LOGLEVEL = void 0;
-exports.HMSH_ROUTER_POLL_FALLBACK_INTERVAL = void 0;
+exports.HMSH_GUID_SIZE = exports.HMSH_ROUTER_SCOUT_INTERVAL_MS = exports.HMSH_ROUTER_SCOUT_INTERVAL_SECONDS = exports.HMSH_SCOUT_INTERVAL_SECONDS = exports.HMSH_FIDELITY_SECONDS = exports.HMSH_EXPIRE_DURATION = exports.HMSH_XPENDING_COUNT = exports.HMSH_XCLAIM_COUNT = exports.HMSH_XCLAIM_DELAY_MS = exports.HMSH_BLOCK_TIME_MS = exports.HMSH_DURABLE_INITIAL_INTERVAL = exports.HMSH_DURABLE_EXP_BACKOFF = exports.HMSH_DURABLE_MAX_INTERVAL = exports.HMSH_DURABLE_MAX_ATTEMPTS = exports.HMSH_GRADUATED_INTERVAL_MS = exports.HMSH_MAX_TIMEOUT_MS = exports.HMSH_POISON_MESSAGE_THRESHOLD = exports.HMSH_MAX_RETRIES = exports.MAX_DELAY = exports.MAX_STREAM_RETRIES = exports.INITIAL_STREAM_BACKOFF = exports.MAX_STREAM_BACKOFF = exports.HMSH_EXPIRE_JOB_SECONDS = exports.HMSH_OTT_WAIT_TIME = exports.HMSH_DEPLOYMENT_PAUSE = exports.HMSH_DEPLOYMENT_DELAY = exports.HMSH_ACTIVATION_MAX_RETRY = exports.HMSH_QUORUM_DELAY_MS = exports.HMSH_QUORUM_ROLLCALL_CYCLES = exports.HMSH_STATUS_UNKNOWN = exports.HMSH_CODE_DURABLE_RETRYABLE = exports.HMSH_CODE_DURABLE_FATAL = exports.HMSH_CODE_DURABLE_MAXED = exports.HMSH_CODE_DURABLE_TIMEOUT = exports.HMSH_CODE_DURABLE_WAIT = exports.HMSH_CODE_DURABLE_CONTINUE = exports.HMSH_CODE_DURABLE_PROXY = exports.HMSH_CODE_DURABLE_CHILD = exports.HMSH_CODE_DURABLE_ALL = exports.HMSH_CODE_DURABLE_SLEEP = exports.HMSH_CODE_UNACKED = exports.HMSH_CODE_TIMEOUT = exports.HMSH_CODE_UNKNOWN = exports.HMSH_CODE_INTERRUPT = exports.HMSH_CODE_NOTFOUND = exports.HMSH_CODE_PENDING = exports.HMSH_CODE_SUCCESS = exports.HMSH_SIGNAL_EXPIRE = exports.HMSH_TELEMETRY = exports.HMSH_LOGLEVEL = void 0;
+exports.HMSH_ROUTER_POLL_FALLBACK_INTERVAL = exports.HMSH_NOTIFY_PAYLOAD_LIMIT = exports.DEFAULT_TASK_QUEUE = void 0;
 /**
  * Determines the log level for the application. The default is 'info'.
  */
 exports.HMSH_LOGLEVEL = process.env.HMSH_LOGLEVEL || 'info';
 /**
- * Determines the log level for telemetry. The default is 'info' which emits worker and trigger spans. 'debug' emits all spans.
+ * Controls which OpenTelemetry spans are emitted. Spans are only
+ * captured when an OTel SDK (TracerProvider + exporter) is registered
+ * before workers start. Without an SDK, all span calls are no-ops.
+ *
+ * ## Modes
+ *
+ * | Value | Durable workflows | YAML flows |
+ * |-------|-------------------|------------|
+ * | `'info'` (default) | `WORKFLOW/START`, `WORKFLOW/COMPLETE`, `WORKFLOW/ERROR`, `ACTIVITY/{name}` | trigger + worker spans |
+ * | `'debug'` | All `info` spans + `DISPATCH/{type}/{name}/{idx}`, `RETURN/{type}/{name}/{idx}` + engine internals | All activity types + all stream hops |
+ *
+ * ## Setup
+ *
+ * Register an OpenTelemetry SDK with a trace exporter **before**
+ * calling `Durable.Worker.create()`. Any OTLP-compatible backend
+ * works (Honeycomb, Jaeger, Grafana Tempo, etc.):
+ *
+ * ```typescript
+ * import { NodeSDK } from '@opentelemetry/sdk-node';
+ * import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-proto';
+ * import { resourceFromAttributes } from '@opentelemetry/resources';
+ * import { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions';
+ *
+ * const sdk = new NodeSDK({
+ *   resource: resourceFromAttributes({
+ *     [ATTR_SERVICE_NAME]: 'my-service',
+ *   }),
+ *   traceExporter: new OTLPTraceExporter({
+ *     url: 'https://api.honeycomb.io/v1/traces',
+ *     headers: { 'x-honeycomb-team': process.env.HONEYCOMB_API_KEY },
+ *   }),
+ * });
+ * sdk.start();
+ *
+ * // Then start workers — spans flow automatically
+ * await Durable.Worker.create({ ... });
+ * ```
+ *
+ * ```bash
+ * # Concise: workflow lifecycle + activity execution only
+ * HMSH_TELEMETRY=info node worker.js
+ *
+ * # Verbose: adds per-operation DISPATCH/RETURN spans + engine internals
+ * HMSH_TELEMETRY=debug node worker.js
+ * ```
  */
 exports.HMSH_TELEMETRY = process.env.HMSH_TELEMETRY || 'info';
 /**
@@ -39,6 +83,10 @@ exports.HMSH_CODE_DURABLE_CHILD = 590;
  * This is thrown when a Durable has been interrupted by a proxyActivity call.
  */
 exports.HMSH_CODE_DURABLE_PROXY = 591;
+/**
+ * This is thrown when a Durable has been interrupted by a continueAsNew call.
+ */
+exports.HMSH_CODE_DURABLE_CONTINUE = 592;
 /**
  * This is thrown when a Durable has been interrupted by a waitForSignal call.
  */
@@ -94,9 +142,9 @@ exports.HMSH_GRADUATED_INTERVAL_MS = parseInt(process.env.HMSH_GRADUATED_INTERVA
 // DURABLE
 /**
  * The maximum number of attempts to retry a Durable job before it is considered failed.
- * @default 3
+ * @default 50
  */
-exports.HMSH_DURABLE_MAX_ATTEMPTS = 3;
+exports.HMSH_DURABLE_MAX_ATTEMPTS = 50;
 /**
  * The maximum interval to wait before retrying a Durable job.
  * @default 120s
@@ -104,9 +152,16 @@ exports.HMSH_DURABLE_MAX_ATTEMPTS = 3;
 exports.HMSH_DURABLE_MAX_INTERVAL = '120s';
 /**
  * The exponential backoff factor to apply to the interval between retries.
- * @default 10
+ * @default 5
+ */
+exports.HMSH_DURABLE_EXP_BACKOFF = 5;
+/**
+ * The initial interval (in seconds) before the first retry attempt.
+ * The retry formula is: initialInterval * backoffCoefficient^retryCount,
+ * clamped by maximumInterval.
+ * @default 1
  */
-exports.HMSH_DURABLE_EXP_BACKOFF = 10;
+exports.HMSH_DURABLE_INITIAL_INTERVAL = 1;
 const BASE_BLOCK_DURATION = 10000;
 const TEST_BLOCK_DURATION = 1000;
 exports.HMSH_BLOCK_TIME_MS = process.env.HMSH_BLOCK_TIME_MS

package/build/modules/errors.d.ts

@@ -1,6 +1,6 @@
 import { ActivityDuplex } from '../types/activity';
 import { CollationFaultType, CollationStage } from '../types/collator';
-import { DurableChildErrorType, DurableProxyErrorType, DurableSleepErrorType, DurableWaitForAllErrorType, DurableWaitForErrorType } from '../types/error';
+import { DurableChildErrorType, DurableContinueAsNewErrorType, DurableProxyErrorType, DurableSleepErrorType, DurableWaitForAllErrorType, DurableWaitForErrorType } from '../types/error';
 declare class GetStateError extends Error {
     jobId: string;
     code: number;
@@ -21,14 +21,17 @@ declare class DurableWaitForError extends Error {
 declare class DurableProxyError extends Error {
     activityName: string;
     arguments: string[];
+    headers?: Record<string, any>;
     backoffCoefficient: number;
     code: number;
     index: number;
+    initialInterval: number;
     maximumAttempts: number;
     maximumInterval: number;
     originJobId: string | null;
     parentWorkflowId: string;
     expire: number;
+    startToCloseTimeout: number;
     workflowDimension: string;
     workflowId: string;
     workflowTopic: string;
@@ -42,6 +45,7 @@ declare class DurableChildError extends Error {
     backoffCoefficient: number;
     code: number;
     expire: number;
+    initialInterval: number;
     persistent: boolean;
     signalIn: boolean;
     workflowDimension: string;
@@ -79,6 +83,15 @@ declare class DurableSleepError extends Error {
     type: string;
     constructor(params: DurableSleepErrorType);
 }
+declare class DurableContinueAsNewError extends Error {
+    workflowId: string;
+    code: number;
+    arguments: any[];
+    index: number;
+    workflowDimension: string;
+    type: string;
+    constructor(params: DurableContinueAsNewErrorType);
+}
 declare class DurableTimeoutError extends Error {
     code: number;
     type: string;
@@ -133,4 +146,4 @@ declare class CollationError extends Error {
     fault: CollationFaultType;
     constructor(status: number, leg: ActivityDuplex, stage: CollationStage, fault?: CollationFaultType);
 }
-export { CollationError, DurableChildError, DurableFatalError, DurableMaxedError, DurableProxyError, DurableRetryError, DurableSleepError, DurableTimeoutError, DurableWaitForAllError, DurableWaitForError, DuplicateJobError, ExecActivityError, GenerationalError, GetStateError, InactiveJobError, MapDataError, RegisterTimeoutError, SetStateError, };
+export { CollationError, DurableChildError, DurableContinueAsNewError, DurableFatalError, DurableMaxedError, DurableProxyError, DurableRetryError, DurableSleepError, DurableTimeoutError, DurableWaitForAllError, DurableWaitForError, DuplicateJobError, ExecActivityError, GenerationalError, GetStateError, InactiveJobError, MapDataError, RegisterTimeoutError, SetStateError, };

package/build/modules/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SetStateError = exports.RegisterTimeoutError = exports.MapDataError = exports.InactiveJobError = exports.GetStateError = exports.GenerationalError = exports.ExecActivityError = exports.DuplicateJobError = exports.DurableWaitForError = exports.DurableWaitForAllError = exports.DurableTimeoutError = exports.DurableSleepError = exports.DurableRetryError = exports.DurableProxyError = exports.DurableMaxedError = exports.DurableFatalError = exports.DurableChildError = exports.CollationError = void 0;
+exports.SetStateError = exports.RegisterTimeoutError = exports.MapDataError = exports.InactiveJobError = exports.GetStateError = exports.GenerationalError = exports.ExecActivityError = exports.DuplicateJobError = exports.DurableWaitForError = exports.DurableWaitForAllError = exports.DurableTimeoutError = exports.DurableSleepError = exports.DurableRetryError = exports.DurableProxyError = exports.DurableMaxedError = exports.DurableFatalError = exports.DurableContinueAsNewError = exports.DurableChildError = exports.CollationError = void 0;
 const enums_1 = require("./enums");
 class GetStateError extends Error {
     constructor(jobId) {
@@ -32,6 +32,7 @@ class DurableProxyError extends Error {
         super(`ProxyActivity Interruption`);
         this.type = 'DurableProxyError';
         this.arguments = params.arguments;
+        this.headers = params.headers;
         this.workflowId = params.workflowId;
         this.workflowTopic = params.workflowTopic;
         this.parentWorkflowId = params.parentWorkflowId;
@@ -41,8 +42,10 @@ class DurableProxyError extends Error {
         this.activityName = params.activityName;
         this.workflowDimension = params.workflowDimension;
         this.backoffCoefficient = params.backoffCoefficient;
+        this.initialInterval = params.initialInterval;
         this.maximumAttempts = params.maximumAttempts;
         this.maximumInterval = params.maximumInterval;
+        this.startToCloseTimeout = params.startToCloseTimeout;
         this.code = enums_1.HMSH_CODE_DURABLE_PROXY;
     }
 }
@@ -67,6 +70,7 @@ class DurableChildError extends Error {
         this.code = enums_1.HMSH_CODE_DURABLE_CHILD;
         this.await = params.await;
         this.backoffCoefficient = params.backoffCoefficient;
+        this.initialInterval = params.initialInterval;
         this.maximumAttempts = params.maximumAttempts;
         this.maximumInterval = params.maximumInterval;
     }
@@ -100,6 +104,18 @@ class DurableSleepError extends Error {
     }
 }
 exports.DurableSleepError = DurableSleepError;
+class DurableContinueAsNewError extends Error {
+    constructor(params) {
+        super(`ContinueAsNew Interruption`);
+        this.type = 'DurableContinueAsNewError';
+        this.arguments = params.arguments;
+        this.workflowId = params.workflowId;
+        this.index = params.index;
+        this.workflowDimension = params.workflowDimension;
+        this.code = enums_1.HMSH_CODE_DURABLE_CONTINUE;
+    }
+}
+exports.DurableContinueAsNewError = DurableContinueAsNewError;
 class DurableTimeoutError extends Error {
     constructor(message, stack) {
         super(message);

package/build/modules/storage.d.ts

@@ -1,3 +1,4 @@
 /// <reference types="node" />
 import { AsyncLocalStorage } from 'async_hooks';
 export declare const asyncLocalStorage: AsyncLocalStorage<Map<string, any>>;
+export declare const activityAsyncLocalStorage: AsyncLocalStorage<Map<string, any>>;

package/build/modules/storage.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.asyncLocalStorage = void 0;
+exports.activityAsyncLocalStorage = exports.asyncLocalStorage = void 0;
 const async_hooks_1 = require("async_hooks");
 exports.asyncLocalStorage = new async_hooks_1.AsyncLocalStorage();
+exports.activityAsyncLocalStorage = new async_hooks_1.AsyncLocalStorage();

package/build/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@hotmeshio/hotmesh",
-    "version": "0.12.1",
-    "description": "Permanent-Memory Workflows & AI Agents",
+    "version": "0.14.0",
+    "description": "Durable Workflow",
     "main": "./build/index.js",
     "types": "./build/index.d.ts",
     "homepage": "https://github.com/hotmeshio/sdk-typescript/",
@@ -33,7 +33,9 @@
         "test:durable:fatal": "vitest run tests/durable/fatal",
         "test:durable:goodbye": "HMSH_LOGLEVEL=debug vitest run tests/durable/goodbye/postgres.test.ts",
         "test:durable:interceptor": "HMSH_LOGLEVEL=info vitest run tests/durable/interceptor/postgres.test.ts",
+        "test:durable:metadata": "HMSH_LOGLEVEL=info vitest run tests/durable/interceptor/postgres.test.ts -t 'argumentMetadata'",
         "test:durable:entity": "HMSH_LOGLEVEL=debug vitest run tests/durable/entity/postgres.test.ts",
+        "test:durable:config": "HMSH_LOGLEVEL=debug vitest run tests/durable/config-parity/postgres.test.ts",
         "test:durable:agent": "HMSH_LOGLEVEL=debug vitest run tests/durable/agent/postgres.test.ts",
         "test:durable:hello": "HMSH_TELEMETRY=debug HMSH_LOGLEVEL=info vitest run tests/durable/helloworld/postgres.test.ts",
         "test:durable:hook": "vitest run tests/durable/hook/postgres.test.ts",
@@ -48,11 +50,15 @@
         "test:durable:unknown": "vitest run tests/durable/unknown/postgres.test.ts",
         "test:durable:exporter": "HMSH_LOGLEVEL=info vitest run tests/durable/exporter",
         "test:durable:exporter:debug": "EXPORT_DEBUG=1 HMSH_LOGLEVEL=error vitest run tests/durable/basic/postgres.test.ts",
+        "test:durable:codec": "vitest run tests/durable/codec/postgres.test.ts",
+        "test:durable:credentials": "vitest run tests/durable/credentials/postgres.test.ts",
         "test:dba": "vitest run tests/dba",
         "test:cycle": "vitest run tests/functional/cycle",
         "test:functional": "vitest run tests/functional",
         "test:emit": "vitest run tests/functional/emit",
         "test:pending": "vitest run tests/functional/pending/index.test.ts",
+        "test:codec": "vitest run tests/functional/codec/postgres.test.ts",
+        "test:credentials": "vitest run tests/functional/credentials/postgres.test.ts",
         "test:hmsh": "vitest run tests/functional/postgres.test.ts",
         "test:hook": "vitest run tests/functional/hook/postgres.test.ts",
         "test:interrupt": "vitest run tests/functional/interrupt/postgres.test.ts",

package/build/services/activities/activity/context.d.ts

@@ -0,0 +1,22 @@
+import { ActivityData, ActivityMetadata, ActivityType } from '../../../types/activity';
+import { JobState } from '../../../types/job';
+import { StringAnyType } from '../../../types/serializer';
+import { StreamStatus } from '../../../types/stream';
+interface ContextInstance {
+    config: ActivityType;
+    context: JobState;
+    metadata: ActivityMetadata;
+    data: ActivityData;
+    status: StreamStatus;
+    adjacentIndex: number;
+}
+export declare function initSelf(instance: ContextInstance, context: StringAnyType): JobState;
+export declare function initPolicies(instance: ContextInstance, context: JobState): void;
+export declare function initDimensionalAddress(instance: ContextInstance, dad: string): void;
+export declare function assertGenerationalId(jobGID: string, msgGID: string, context: JobState): void;
+export declare function resolveDad(instance: ContextInstance): string;
+export declare function resolveAdjacentDad(instance: ContextInstance): string;
+export declare function bindActivityData(instance: ContextInstance, type: 'output' | 'hook'): void;
+export declare function bindActivityError(instance: ContextInstance, data: Record<string, unknown>): void;
+export declare function bindJobError(instance: ContextInstance, data: Record<string, unknown>): void;
+export {};

package/build/services/activities/activity/context.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bindJobError = exports.bindActivityError = exports.bindActivityData = exports.resolveAdjacentDad = exports.resolveDad = exports.assertGenerationalId = exports.initDimensionalAddress = exports.initPolicies = exports.initSelf = void 0;
+const enums_1 = require("../../../modules/enums");
+const errors_1 = require("../../../modules/errors");
+const utils_1 = require("../../../modules/utils");
+const collator_1 = require("../../collator");
+const pipe_1 = require("../../pipe");
+function initSelf(instance, context) {
+    const activityId = instance.metadata.aid;
+    if (!context[activityId]) {
+        context[activityId] = {};
+    }
+    const self = context[activityId];
+    if (!self.output)
+        self.output = {};
+    if (!self.input)
+        self.input = {};
+    if (!self.hook)
+        self.hook = {};
+    if (!self.output.metadata)
+        self.output.metadata = {};
+    self.output.metadata.au = (0, utils_1.formatISODate)(new Date());
+    context['$self'] = self;
+    context['$job'] = context; //NEVER call STRINGIFY! (now circular)
+    return context;
+}
+exports.initSelf = initSelf;
+function initPolicies(instance, context) {
+    const expire = pipe_1.Pipe.resolve(instance.config.expire ?? enums_1.HMSH_EXPIRE_DURATION, context);
+    context.metadata.expire = expire;
+    if (instance.config.persistent != undefined) {
+        const persistent = pipe_1.Pipe.resolve(instance.config.persistent ?? false, context);
+        context.metadata.persistent = persistent;
+    }
+}
+exports.initPolicies = initPolicies;
+function initDimensionalAddress(instance, dad) {
+    instance.metadata.dad = dad;
+}
+exports.initDimensionalAddress = initDimensionalAddress;
+function assertGenerationalId(jobGID, msgGID, context) {
+    if (msgGID !== jobGID) {
+        throw new errors_1.GenerationalError(jobGID, msgGID, context?.metadata?.jid ?? '', context?.metadata?.aid ?? '', context?.metadata?.dad ?? '');
+    }
+}
+exports.assertGenerationalId = assertGenerationalId;
+function resolveDad(instance) {
+    let dad = instance.metadata.dad;
+    if (instance.adjacentIndex > 0) {
+        dad = `${dad.substring(0, dad.lastIndexOf(','))},${instance.adjacentIndex}`;
+    }
+    return dad;
+}
+exports.resolveDad = resolveDad;
+function resolveAdjacentDad(instance) {
+    return `${resolveDad(instance)}${collator_1.CollatorService.getDimensionalSeed(0)}`;
+}
+exports.resolveAdjacentDad = resolveAdjacentDad;
+function bindActivityData(instance, type) {
+    instance.context[instance.metadata.aid][type].data = instance.data;
+}
+exports.bindActivityData = bindActivityData;
+function bindActivityError(instance, data) {
+    const md = instance.context[instance.metadata.aid].output.metadata;
+    md.err = JSON.stringify(instance.data);
+    md.$error = { ...data, is_stream_error: true };
+}
+exports.bindActivityError = bindActivityError;
+function bindJobError(instance, data) {
+    instance.context.metadata.err = JSON.stringify({
+        ...data,
+        is_stream_error: true,
+    });
+}
+exports.bindJobError = bindJobError;