@t4h.framework/core 0.11.0 → 0.13.0

package/.ai/skills/framework-core/SKILL.md

@@ -36,8 +36,7 @@ Node `>=22`. Schemas use TypeBox (`typebox`). See [README.md](../../../README.md
 
 - **Workflow** — an orchestration entrypoint: a plain async function wrapped in `new Workflow(...)`. It coordinates steps; it does not implement the steps.
 - **App** — registers workflows so the runtime can discover and run them.
-- **Replay & determinism** — the runtime re-runs a workflow from its recorded history on every tick, so the body must reach the same state every time. Branch on inputs, on the results of the steps you call, and on the values the framework makes deterministic (see below); never on other ambient state (`process.env`, module-level mutable variables).
-- **Time & randomness** — inside a workflow, `Date.now()`, `new Date()`, `Math.random()` and `crypto.randomUUID()` are deterministic and safe to use. The clock follows the history: it starts when the run was created and only moves forward as steps are recorded (a step's request time, or the moment an awaited step settled), so it stands still between two steps. Randomness is seeded by the run id. `setTimeout`/`setInterval` throw `TimerNotAllowedException` — use `sleep` to wait.
+- **Replay & determinism** — the runtime may re-run a workflow from its recorded history. Keep the body deterministic: branch on inputs and on the results of the steps you call, never on `Date.now()`, `Math.random()`, or ambient state. Use framework primitives (e.g. `sleep`) when you need time to pass.
 - **env** — configuration values supplied by the runtime; the single source for URLs, tokens, and tenants.
 - **Composition** — external work is performed by calling primitives from the other framework packages inside the workflow body.
 
@@ -168,7 +167,7 @@ const output = await env.execute(workflow, input, {
 
 | Option | Default | Purpose |
 |--------|---------|---------|
-| `now` | `0` | Virtual host time at run start. It becomes the run's start time and stamps every recorded step; `Date.now()` inside the workflow reads those stamps |
+| `now` | `0` | Pins `Date.now()` to this value at run start |
 | `resolveActivityTimeouts` | `true` | Auto-advances the clock through time-based steps (e.g. `sleep`) and resolves them |
 
 `execute()` options:
@@ -202,8 +201,7 @@ Do **not** import `@t4h.framework/core/testing` in production app code.
 - Reading `process.env` directly, or reading the raw `env` proxy when the project should declare an `EnvDesign` in `constants/environments.ts`.
 - Inlining URLs/secrets/tenants in workflow code instead of pulling them from the shared `EnvDesign`.
 - Accessing an `EnvDesign` key at module top level (throws — no env storage outside a run); read keys inside the workflow body/functions.
-- `setTimeout` / `setInterval` inside a workflow body — throws `TimerNotAllowedException`; wait with `sleep`.
-- Branching on ambient state (`process.env`, module-level mutable variables) or measuring elapsed time between steps — the workflow clock stands still between steps, so such measurements are always `0`.
+- Non-deterministic workflow bodies (`Date.now()`, `Math.random()`, ambient state) — they break replay.
 - Non-`Serializable` workflow input, output, or step values.
 - Duplicate `workflow.id` within an `App`.
 - Importing `@t4h.framework/core/testing` from production code.
@@ -213,8 +211,8 @@ Do **not** import `@t4h.framework/core/testing` in production app code.
 
 ## Exports
 
-**Main (`@t4h.framework/core`):** `Workflow`, `App`, `startWorkflow`, `WorkflowRef`, `env`, `EnvDesign`, `Authorization`, `Binary`, `Serializable`, `TimerNotAllowedException`.
+**Main (`@t4h.framework/core`):** `Workflow`, `App`, `startWorkflow`, `WorkflowRef`, `env`, `EnvDesign`, `Authorization`, `Binary`, `Serializable`.
 
 **Testing (`@t4h.framework/core/testing`):** `TestWorkflowEnvironment`, `TestClock`, `createTestEnv`, `createTestEnvEntries`, `NonDeterministicWorkflowError`.
 
-> Core also exports lower-level building blocks used to **author framework packages** themselves. Those are out of scope for building workflows and are not covered here — reach for the primitives above and the companion packages instead.
+> Core also exports lower-level building blocks used to **author framework packages** and **hosts** themselves (e.g. the `AsyncActivityCallback` namespace with the callbacks route helpers `deriveToken`, `isTokenValid`, `authorize`, `parseBody`, `toEvent`, `flattenHeaders`; `pending({ correlationKey })` plus the optional `toCorrelationKey(event)` on `AsyncActivity` for third parties that emit to a fixed URL). Those are out of scope for building workflows and are not covered here — reach for the primitives above and the companion packages instead.

package/.ai/skills/framework-workflow-creation/SKILL.md

@@ -39,7 +39,7 @@ Create workflows that:
 | Configuration | `environments.MY_KEY` from a shared `EnvDesign` | `@t4h.framework/core` |
 | Branching / mapping | plain TypeScript | — |
 
-Keep the body **deterministic** so it replays safely: branch on inputs and step results, never on ambient state (`process.env`, module-level mutable variables). `Date.now()`, `new Date()`, `Math.random()` and `crypto.randomUUID()` are made deterministic by the framework and are safe to use — the clock follows the recorded history and stands still between steps, randomness is seeded by the run. `setTimeout`/`setInterval` throw `TimerNotAllowedException`; use `sleep` when you need time to pass.
+Keep the body **deterministic** so it replays safely: branch on inputs and step results, never on `Date.now()`, `Math.random()`, or ambient state. Use `sleep` when you need time to pass.
 
 ## Expected project shape
 
@@ -106,7 +106,7 @@ One `environments` object is the single source of configuration for the whole pr
 3. Define workflow metadata with a stable `id`.
 4. Add a `schema` when input validation is needed.
 5. Import all configuration from the shared `EnvDesign` in `constants/environments.ts` — never raw `env` or `process.env`.
-6. Keep the body deterministic so replay produces the same result. `Date.now()` / `Math.random()` are safe; timers are not — use `sleep`.
+6. Keep the body deterministic so replay produces the same result.
 7. Obtain a `Binary` from the framework — an HTTP response body, `sftp.get`, `write`, `join` — never by implementing one.
 
 ## Hard constraints
@@ -114,9 +114,7 @@ One `environments` object is the single source of configuration for the whole pr
 - Do not hardcode URLs, client IDs, client secrets, API keys, tenants, or tokens.
 - Do not initialize third-party clients with inline credentials inside workflow files.
 - Do not read `process.env` or the raw `env` proxy directly — declare configuration in the shared `EnvDesign` (`constants/environments.ts`).
-- Do not call `fetch`/`axios` or other non-framework I/O directly — that breaks replay safety, and their internal timers throw `TimerNotAllowedException`.
-- Do not call `setTimeout` / `setInterval` inside a workflow — it throws `TimerNotAllowedException`. Wait with `sleep` from `@t4h.framework/sleep`.
-- Do not measure elapsed time between steps with `Date.now()` — the workflow clock only moves when a step is recorded, so the difference is always `0`.
+- Do not call `fetch`/`axios` or other non-framework I/O directly — that breaks replay safety.
 - **Do not declare a class that extends `Binary`** (`BufferBinary`, `StringBinary`, `stringToBinary` helpers, …). To hand content to a primitive that takes a `Binary` — `sftp.put`, `sftp.append`, an HTTP body — build it with `write` from `@t4h.framework/fs`:
 
   ```ts
@@ -153,7 +151,7 @@ Required keys declared in the `EnvDesign` fail fast automatically: accessing an
 
 ### Step 4: make it test-friendly
 
-- Keep outputs deterministic (`Date.now()` and `Math.random()` are fine; they replay identically).
+- Keep outputs deterministic.
 - Avoid hidden global state.
 - Drive external effects through package primitives so tests can supply their providers (see **framework-core** testing and each package's skill).
 

package/.ai/skills/framework-workflow-testing/SKILL.md

@@ -66,7 +66,7 @@ env.clock.set(now)     // set pinned clock to a Date | number
 
 | Option | Default | Purpose |
 |--------|---------|---------|
-| `now` | `0` | Virtual host time at start. It becomes the run's start time and stamps every recorded step; `Date.now()` inside the workflow reads those stamps |
+| `now` | `0` | Pins `Date.now()` to this value at start |
 | `resolveActivityTimeouts` | `true` | Auto-advances clock to each activity's `timeoutAt` and resolves it via `onTimeout` |
 
 `execute()` options:
@@ -80,14 +80,6 @@ env.clock.set(now)     // set pinned clock to a Date | number
 After `execute()` returns, the clock is advanced to wherever the run left it.
 Subsequent `env.clock.advance()` calls build on that value between tests.
 
-Inside the workflow, `Date.now()` is the history clock, not the virtual clock
-directly: it equals `now` until the first step is recorded, then moves to each
-step's stamp (request time, or settle time for an awaited async step). It never
-moves backwards and stands still between steps. `Math.random()` and
-`crypto.randomUUID()` are seeded by the run and replay identically, so asserting
-on them is safe. A workflow that calls `setTimeout` / `setInterval` rejects with
-`TimerNotAllowedException`.
-
 Async activities are resolved in tests through `mockAsyncActivity` (which returns
 a final outcome directly). Workflow tests never drive an activity's internal
 `advance` method — you only assert the workflow's observable output and effects.

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # @t4h.framework/core
 
+## 0.13.0
+
+### Minor Changes
+
+- [#167](https://github.com/tech4humans-brasil/framework/pull/167) [`1b1509f`](https://github.com/tech4humans-brasil/framework/commit/1b1509f9b6d2554dfab1f7633c3d022249e4fa01) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Lets a third party that emits to a fixed URL advance a waiting async activity,
+  without the callback URL the activity would otherwise hand out.
+
+  **core**: `pending({ correlationKey })` declares the key a wait answers to, and
+  the optional `toCorrelationKey(event)` on `AsyncActivity` maps an incoming event
+  (`AsyncActivityCallback.Event`: method, flattened headers, parsed body, raw body)
+  to that key, or `undefined` when the event is not for the activity. It runs on a
+  bare instance, outside any run. `AsyncActivityCallback.toEvent(request)` builds
+  the event for hosts.
+
+  **dev**: new public route `POST /projects/:projectId/workflows/:workflowId/events`.
+  Every registered activity implementing `toCorrelationKey` is asked for a key;
+  the pending of that type waiting on the key inside the workflow has its `auth`
+  verified and receives the event as a callback, through the same path as the
+  callback URL route. Answers `202 { id, activity }` with the stored callback,
+  `202` with an empty body when no activity claims the event or nothing is
+  waiting, `401` when the matched pending refused the auth, and `409` when the key
+  matches more than one pending, since a correlation key must identify one wait.
+
+- [#167](https://github.com/tech4humans-brasil/framework/pull/167) [`1b1509f`](https://github.com/tech4humans-brasil/framework/commit/1b1509f9b6d2554dfab1f7633c3d022249e4fa01) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Moves the callbacks route helpers from `@t4h.framework/webhook` to
+  `@t4h.framework/core`. The route advances any pending async activity, not only
+  `webhook()`, and the core already owned its contract (`AsyncActivityCallbackAuth`,
+  `GetActivityCallbackUrlClaim`, `AsyncActivityAdvanceContext`).
+
+  **core**: new `AsyncActivityCallback` namespace with `deriveToken`, `isTokenValid`,
+  `parseBody`, `getHeader`, `getBearerToken`, `flattenHeaders`, `authorize` and
+  the types `AsyncActivityCallback.Delivery`, `AsyncActivityCallback.Headers`, `AsyncActivityCallback.Json`,
+  `AsyncActivityCallback.AuthType`, `AsyncActivityCallback.Authorizer`, `AsyncActivityCallback.Authorizers`.
+  `AsyncActivityCallback.authorize(auth, request, authorizers?)` ships `basic`, `header` and
+  `bearer`; `hmac` and `jwt` are authorizers the host passes in, so the core does not
+  depend on `@t4h.framework/hmac` or `@t4h.framework/jwks`. A declared type without
+  a authorizer throws `AsyncActivityCallbackAuthorizerMissingException`; an unknown type throws
+  `AsyncActivityCallbackAuthUnsupportedException`.
+
+  **hmac**: new `@t4h.framework/hmac/callback` entry whose default export is the
+  `hmac` callback authorizer, `hmacCallback`.
+
+  **jwks**: new `@t4h.framework/jwks/callback` entry whose default export is the
+  `jwt` callback authorizer, `jwksCallback`.
+
+  **webhook**: no longer exports `deriveCallbackToken`, `isCallbackTokenValid`,
+  `verifyCallbackAuth`, `parseCallbackBody`, `getHeader`, `flattenHeaders` nor
+  `CallbackRequest`/`CallbackHeaders`, and no longer depends on `hmac` and `jwks`;
+  `WebhookJson` is now an alias of the core `AsyncActivityCallback.Json`. Hosts import the
+  helpers from the core `AsyncActivityCallback` namespace and the authorizers from the two entries.
+
+  **dev**: `@t4h.framework/webhook` becomes an optional peer like the other
+  integrations. Only `@t4h.framework/core` is required again, which fixes
+  `ERR_MODULE_NOT_FOUND: Cannot find package '@t4h.framework/webhook'` on
+  projects that never call `webhook()`. `hmac` and `jwt` callback authorizers are
+  loaded from the project when `@t4h.framework/hmac` / `@t4h.framework/jwks` are
+  installed; a callback whose declared `auth` needs a missing package answers 500
+  naming the package to install.
+
+## 0.12.0
+
+### Minor Changes
+
+- [#165](https://github.com/tech4humans-brasil/framework/pull/165) [`72e08ff`](https://github.com/tech4humans-brasil/framework/commit/72e08ff86e0ce735ef73ccdf33b0dc01cdb8b6f5) Thanks [@gusteycamargo](https://github.com/gusteycamargo)! - Revert deterministic time, randomness and timers in workflow code ([#155](https://github.com/tech4humans-brasil/framework/issues/155)).
+  - `Date`, `Math.random`, `crypto.randomUUID` and the timer functions are no longer patched. Workflow code must not call `Date.now()` / `Math.random()`; wait with `@t4h.framework/sleep`.
+  - `TimerNotAllowedException` is removed.
+  - **Hosts:** `Internals.runWorkflow` no longer takes `id` / `createdAt`, and `HistoryItem` no longer carries `createdAt` / `settledAt`.
+  - Testing: `runWorkflow` no longer accepts or returns `seed` / `createdAt`; `TestClock` patches `Date` itself again.
+
 ## 0.11.0
 
 ### Minor Changes

package/README.md

@@ -256,6 +256,83 @@ class WaitForApprovalActivity extends AsyncActivity<
 }
 ```
 
+### Callbacks (host side)
+
+Every pending async activity can be advanced from outside through the host's
+callbacks route (`POST .../activities/:activityId/callbacks?token=…`). The
+route is the host's, but the pieces are core exports so every host behaves the
+same:
+
+| Export                                           | What it's for                                                                 |
+| ------------------------------------------------ | ----------------------------------------------------------------------------- |
+| `AsyncActivityCallback.deriveToken`                           | `HMAC-SHA256(secret, activityId)` as base64url: the token of a callback URL.  |
+| `AsyncActivityCallback.isTokenValid`                          | Constant-time check of a token against the derived one.                       |
+| `AsyncActivityCallback.authorize`                            | Checks a delivery against the `auth` declared in `pending({ auth })`.         |
+| `AsyncActivityCallback.parseBody`                             | Turns content type + raw body into the payload `advance` receives.            |
+| `AsyncActivityCallback.getHeader` / `AsyncActivityCallback.flattenHeaders` | Case-insensitive lookup; lower-cased, joined headers for the advance context. |
+| `GetActivityCallbackUrlClaim`                    | The claim an activity uses to learn its own callback URL.                     |
+
+The namespace also carries the types `AsyncActivityCallback.Delivery`, `AsyncActivityCallback.Headers`,
+`AsyncActivityCallback.Json`, `AsyncActivityCallback.Authorizer` and `AsyncActivityCallback.Authorizers`.
+
+`AsyncActivityCallback.authorize` ships `basic`, `header` and `bearer`. `hmac` and `jwt`
+are authorizers the host passes in, so the core never depends on the packages
+that implement them:
+
+```typescript
+import { AsyncActivityCallback } from '@t4h.framework/core'
+import hmac from '@t4h.framework/hmac/callback'
+import jwt from '@t4h.framework/jwks/callback'
+
+const ok = await AsyncActivityCallback.authorize(
+  pending.auth,
+  { method, headers, rawBody },
+  { hmac, jwt },
+)
+```
+
+A declared type without a authorizer throws `AsyncActivityCallbackAuthorizerMissingException`.
+
+### Correlating events from a fixed URL
+
+Some third parties cannot call a URL handed to them per request: they emit
+every event to one URL configured on their side. For those, the host exposes a
+fixed events route per workflow (`POST .../projects/:projectId/workflows/:workflowId/events`)
+and the activity tells the host how to match an event to a wait:
+
+```typescript
+class TransferTicketActivity extends AsyncActivity<...> {
+  public async bootstrap(input: { ticketId: string }) {
+    // ...asks the partner to transfer the ticket...
+    return this.pending({
+      schema,
+      correlationKey: input.ticketId,
+      auth: { type: 'hmac', secret: input.secret, header: 'x-signature' },
+    })
+  }
+
+  public override toCorrelationKey(event: AsyncActivityCallback.Event) {
+    const body = event.body as { type?: string; ticket?: { id?: string } }
+
+    if (body?.type !== 'ticket.transferred') return undefined
+
+    return body.ticket?.id
+  }
+
+  // toInput, advance, toOutput as usual
+}
+```
+
+On every event the host calls `toCorrelationKey` on each registered activity
+that implements it, then looks up the pending of that activity type waiting on
+the returned key inside the workflow, verifies its `auth` and delivers the
+event as a callback, exactly as the callback URL route would. An event no
+activity claims, or that nothing is waiting for, is accepted and dropped. A key
+must identify one wait: when it matches more than one pending the host refuses
+the event (409) and delivers to none, so compose the key (`ticketId:transferId`)
+when one external id can have several waits. `toCorrelationKey` runs on a bare
+instance, outside any run: no claims, no history, only the event.
+
 ### Activities with Claims (dependencies)
 
 A Claim is an abstract dependency that an Activity declares. For example, an activity that saves files declares it needs a "file storage" claim -- it doesn't know whether the implementation uses S3, local disk, or anything else. The runtime must provide a concrete implementation for each declared claim via `ClaimProvider`. This decouples the activity definition from the infrastructure.
@@ -302,8 +379,6 @@ The runtime is responsible for executing workflows and activities by providing t
 import { Internals } from '@t4h.framework/core'
 
 Internals.runWorkflow(myWorkflow, {
-  id: run.id, // seeds Math.random / randomUUID inside the workflow
-  createdAt: run.createdAt.getTime(), // where the workflow clock starts
   input: { userId: '123', amount: 100 },
   env: { API_URL: 'https://api.example.com' },
   claims: [
@@ -346,8 +421,6 @@ Env.run → Claim.run → fn(activity)
 
 **History** handles reconciliation: when an activity has been executed before, the previous result is returned directly (deterministic replay). When there is no history, the activity runs and the result is stored.
 
-**History** also owns the workflow clock. Each `HistoryItem` carries `createdAt` (when the activity was requested) and async items `settledAt` (when they settled); `Date.now()` inside the workflow reads the last of those the replay walked past, starting from the run's `createdAt`. `History.run` also patches `Date`, `Math.random` and `randomUUID` for workflow code and forbids `setTimeout` / `setInterval` there (`TimerNotAllowedException`). Hosts must stamp those fields when building the history.
-
 ---
 
 ## Testing
@@ -482,10 +555,6 @@ await TestClock.run({ now: 0 }, async () => {
 })
 ```
 
-`TestClock` acts as the host clock: activities are stamped with it and the
-workflow reads those stamps back through `Date.now()`, exactly as in
-production.
-
 ### Activity-level tests
 
 The real `advance` logic is intentionally **not** exercised by `execute()`.

package/dist/core.d.ts

@@ -1,7 +1,7 @@
 export * from './activities/StartWorkflowActivity.js';
 export * from './exceptions/ActivityException.js';
+export * from './exceptions/AsyncActivityCallbackException.js';
 export * from './exceptions/ClaimException.js';
-export * from './exceptions/TimerNotAllowedException.js';
 export * from './models/Activity.js';
 export * from './models/Authorization.js';
 export * from './models/App.js';
@@ -23,6 +23,7 @@ export * from './models/Workflow.js';
 export * from './models/WorkflowBatchClaim.js';
 export * from './models/WorkflowBatchRef.js';
 export * from './models/WorkflowRef.js';
+export * from './tools/AsyncActivityCallback.js';
 export * from './tools/Internals.js';
 export * from './typings/PromiseLikeType.js';
 export * from './typings/Serializable.js';

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AAErD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0CAA0C,CAAA;AAExD,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wCAAwC,CAAA;AACtD,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,uCAAuC,CAAA;AACrD,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,yBAAyB,CAAA;AAEvC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AAErD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gDAAgD,CAAA;AAC9D,cAAc,gCAAgC,CAAA;AAE9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wCAAwC,CAAA;AACtD,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,uCAAuC,CAAA;AACrD,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,yBAAyB,CAAA;AAEvC,cAAc,kCAAkC,CAAA;AAChD,cAAc,sBAAsB,CAAA;AAEpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}

package/dist/core.js

@@ -1,7 +1,7 @@
 export * from './activities/StartWorkflowActivity.js';
 export * from './exceptions/ActivityException.js';
+export * from './exceptions/AsyncActivityCallbackException.js';
 export * from './exceptions/ClaimException.js';
-export * from './exceptions/TimerNotAllowedException.js';
 export * from './models/Activity.js';
 export * from './models/Authorization.js';
 export * from './models/App.js';
@@ -23,6 +23,7 @@ export * from './models/Workflow.js';
 export * from './models/WorkflowBatchClaim.js';
 export * from './models/WorkflowBatchRef.js';
 export * from './models/WorkflowRef.js';
+export * from './tools/AsyncActivityCallback.js';
 export * from './tools/Internals.js';
 export * from './typings/PromiseLikeType.js';
 export * from './typings/Serializable.js';

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AAErD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0CAA0C,CAAA;AAExD,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wCAAwC,CAAA;AACtD,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,uCAAuC,CAAA;AACrD,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,yBAAyB,CAAA;AAEvC,cAAc,sBAAsB,CAAA;AAEpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AAErD,cAAc,mCAAmC,CAAA;AACjD,cAAc,gDAAgD,CAAA;AAC9D,cAAc,gCAAgC,CAAA;AAE9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA;AACzC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,2BAA2B,CAAA;AACzC,cAAc,wCAAwC,CAAA;AACtD,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,uCAAuC,CAAA;AACrD,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mCAAmC,CAAA;AACjD,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,sBAAsB,CAAA;AACpC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,yBAAyB,CAAA;AAEvC,cAAc,kCAAkC,CAAA;AAChD,cAAc,sBAAsB,CAAA;AAEpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,2BAA2B,CAAA"}

package/dist/exceptions/AsyncActivityCallbackException.d.ts

@@ -0,0 +1,13 @@
+import type { AsyncActivityCallbackAuth } from '../models/AsyncActivityCallbackAuth.js';
+export declare class AsyncActivityCallbackException extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export declare class AsyncActivityCallbackAuthorizerMissingException extends AsyncActivityCallbackException {
+    readonly type: AsyncActivityCallbackAuth['type'];
+    constructor(type: AsyncActivityCallbackAuth['type']);
+}
+export declare class AsyncActivityCallbackAuthUnsupportedException extends AsyncActivityCallbackException {
+    readonly type: string;
+    constructor(type: string);
+}
+//# sourceMappingURL=AsyncActivityCallbackException.d.ts.map

package/dist/exceptions/AsyncActivityCallbackException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncActivityCallbackException.d.ts","sourceRoot":"","sources":["../../src/exceptions/AsyncActivityCallbackException.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAA;AAEvF,qBAAa,8BAA+B,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAG3D;AAED,qBAAa,+CAAgD,SAAQ,8BAA8B;IACjG,SAAgB,IAAI,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAA;gBAEpC,IAAI,EAAE,yBAAyB,CAAC,MAAM,CAAC;CAI3D;AAED,qBAAa,6CAA8C,SAAQ,8BAA8B;IAC/F,SAAgB,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM;CAIhC"}

package/dist/exceptions/AsyncActivityCallbackException.js

@@ -0,0 +1,20 @@
+export class AsyncActivityCallbackException extends Error {
+    constructor(message, options) {
+        super(message, options);
+    }
+}
+export class AsyncActivityCallbackAuthorizerMissingException extends AsyncActivityCallbackException {
+    type;
+    constructor(type) {
+        super(`No authorizer registered for callback auth type "${type}"`);
+        this.type = type;
+    }
+}
+export class AsyncActivityCallbackAuthUnsupportedException extends AsyncActivityCallbackException {
+    type;
+    constructor(type) {
+        super(`Unsupported callback auth type: ${type}`);
+        this.type = type;
+    }
+}
+//# sourceMappingURL=AsyncActivityCallbackException.js.map

package/dist/exceptions/AsyncActivityCallbackException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncActivityCallbackException.js","sourceRoot":"","sources":["../../src/exceptions/AsyncActivityCallbackException.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IACvD,YAAmB,OAAe,EAAE,OAAsB;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;CACF;AAED,MAAM,OAAO,+CAAgD,SAAQ,8BAA8B;IACjF,IAAI,CAAmC;IAEvD,YAAmB,IAAuC;QACxD,KAAK,CAAC,oDAAoD,IAAI,GAAG,CAAC,CAAA;QAClE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,6CAA8C,SAAQ,8BAA8B;IAC/E,IAAI,CAAQ;IAE5B,YAAmB,IAAY;QAC7B,KAAK,CAAC,mCAAmC,IAAI,EAAE,CAAC,CAAA;QAChD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}

package/dist/models/AsyncActivity.d.ts

@@ -2,6 +2,7 @@ import type Type from 'typebox';
 import { AsyncActivityResultFulfilled, AsyncActivityResultPending, AsyncActivityResultRejected, type AsyncActivityResult, type AsyncActivityResultPendingOptions } from './AsyncActivityAdvanceResult.js';
 import { AsyncActivityAwaitable } from './AsyncActivityAwaitable.js';
 import type { IHistoryItemAsync } from './History.js';
+import type { AsyncActivityCallback } from '../tools/AsyncActivityCallback.js';
 import type { Serializable } from '../typings/Serializable.js';
 export type AsyncActivityAdvanceContext = {
     method: string;
@@ -14,6 +15,7 @@ export declare abstract class AsyncActivity<TArgs extends readonly any[], TInput
     abstract bootstrap(input: TInput): AsyncActivityResult<TBootstrap, TSchema, TSerializableOutput> | Promise<AsyncActivityResult<TBootstrap, TSchema, TSerializableOutput>>;
     abstract advance(payload: Type.Static<TSchema>, bootstrap: AsyncActivityResultPending, context?: AsyncActivityAdvanceContext): AsyncActivityResult<Serializable, TSchema, TSerializableOutput> | Promise<AsyncActivityResult<Serializable, TSchema, TSerializableOutput>>;
     abstract toOutput(output: TSerializableOutput, ...args: TArgs): TOutput;
+    toCorrelationKey?(event: AsyncActivityCallback.Event): string | undefined | Promise<string | undefined>;
     onTimeout?(payload: AsyncActivityResultPending): AsyncActivityResult<Serializable, TSchema, TSerializableOutput> | Promise<AsyncActivityResult<Serializable, TSchema, TSerializableOutput>>;
     protected pending(options?: AsyncActivityResultPendingOptions<TBootstrap, TSchema>): AsyncActivityResultPending<TBootstrap, TSchema>;
     protected done(payload?: TSerializableOutput): AsyncActivityResultFulfilled<TSerializableOutput | undefined>;

package/dist/models/AsyncActivity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncActivity.d.ts","sourceRoot":"","sources":["../../src/models/AsyncActivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,SAAS,CAAA;AAE/B,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,iCAAiC,EACvC,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAC1C,SAAS,GAAG,EAAE,EACd,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,CACJ,CAAA;AAED,8BAAsB,aAAa,CACjC,KAAK,SAAS,SAAS,GAAG,EAAE,EAC5B,MAAM,SAAS,YAAY,EAC3B,mBAAmB,SAAS,YAAY,GAAG,IAAI,EAC/C,OAAO,EACP,UAAU,SAAS,YAAY,EAC/B,OAAO,SAAS,IAAI,CAAC,OAAO;IAErB,EAAE,EAAG,MAAM,CAAA;aAEF,OAAO,CAAC,GAAG,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;aAEjD,SAAS,CACvB,KAAK,EAAE,MAAM,GAEX,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,GAC7D,OAAO,CAAC,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;aAE1D,OAAO,CACrB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAC7B,SAAS,EAAE,0BAA0B,EACrC,OAAO,CAAC,EAAE,2BAA2B,GAEnC,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,GAC/D,OAAO,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;aAE5D,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO;IAEvE,SAAS,CAAC,CAEf,OAAO,EAAE,0BAA0B,GAEjC,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,GAC/D,OAAO,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAM5E,SAAS,CAAC,OAAO,CACf,OAAO,CAAC,EAAE,iCAAiC,CAAC,UAAU,EAAE,OAAO,CAAC;IAKlE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB;IAI5C,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAIzC,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,EAAE;CAGjE"}
+{"version":3,"file":"AsyncActivity.d.ts","sourceRoot":"","sources":["../../src/models/AsyncActivity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,SAAS,CAAA;AAE/B,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,EAC3B,KAAK,mBAAmB,EACxB,KAAK,iCAAiC,EACvC,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAC1C,SAAS,GAAG,EAAE,EACd,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,EACH,GAAG,CACJ,CAAA;AAED,8BAAsB,aAAa,CACjC,KAAK,SAAS,SAAS,GAAG,EAAE,EAC5B,MAAM,SAAS,YAAY,EAC3B,mBAAmB,SAAS,YAAY,GAAG,IAAI,EAC/C,OAAO,EACP,UAAU,SAAS,YAAY,EAC/B,OAAO,SAAS,IAAI,CAAC,OAAO;IAErB,EAAE,EAAG,MAAM,CAAA;aAEF,OAAO,CAAC,GAAG,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;aAEjD,SAAS,CACvB,KAAK,EAAE,MAAM,GAEX,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,GAC7D,OAAO,CAAC,mBAAmB,CAAC,UAAU,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;aAE1D,OAAO,CACrB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAC7B,SAAS,EAAE,0BAA0B,EACrC,OAAO,CAAC,EAAE,2BAA2B,GAEnC,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,GAC/D,OAAO,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;aAE5D,QAAQ,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,KAAK,GAAG,OAAO;IACvE,gBAAgB,CAAC,CACtB,KAAK,EAAE,qBAAqB,CAAC,KAAK,GACjC,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAE5C,SAAS,CAAC,CAEf,OAAO,EAAE,0BAA0B,GAEjC,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,GAC/D,OAAO,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAM5E,SAAS,CAAC,OAAO,CACf,OAAO,CAAC,EAAE,iCAAiC,CAAC,UAAU,EAAE,OAAO,CAAC;IAKlE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,mBAAmB;IAI5C,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAIzC,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,GAAG,EAAE;CAGjE"}

package/dist/models/AsyncActivity.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncActivity.js","sourceRoot":"","sources":["../../src/models/AsyncActivity.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,GAG5B,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAkBpE,MAAM,OAAgB,aAAa;IAQ1B,EAAE,CAAS;IAoBX,SAAS;IACd,6DAA6D;IAC7D,OAAmC;QAInC,OAAO,IAAI,CAAC,QAAQ,CAAC;YACnB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAA;IACJ,CAAC;IAES,OAAO,CACf,OAAgE;QAEhE,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC;IAES,IAAI,CAAC,OAA6B;QAC1C,OAAO,IAAI,4BAA4B,CAAC,OAAO,CAAC,CAAA;IAClD,CAAC;IAES,QAAQ,CAAC,OAA6B;QAC9C,OAAO,IAAI,2BAA2B,CAAC,OAAO,CAAC,CAAA;IACjD,CAAC;IAEM,WAAW,CAAC,IAAuB,EAAE,IAAoB;QAC9D,OAAO,IAAI,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACrD,CAAC;CACF"}
+{"version":3,"file":"AsyncActivity.js","sourceRoot":"","sources":["../../src/models/AsyncActivity.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,GAG5B,MAAM,iCAAiC,CAAA;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAmBpE,MAAM,OAAgB,aAAa;IAQ1B,EAAE,CAAS;IAuBX,SAAS;IACd,6DAA6D;IAC7D,OAAmC;QAInC,OAAO,IAAI,CAAC,QAAQ,CAAC;YACnB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAA;IACJ,CAAC;IAES,OAAO,CACf,OAAgE;QAEhE,OAAO,IAAI,0BAA0B,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC;IAES,IAAI,CAAC,OAA6B;QAC1C,OAAO,IAAI,4BAA4B,CAAC,OAAO,CAAC,CAAA;IAClD,CAAC;IAES,QAAQ,CAAC,OAA6B;QAC9C,OAAO,IAAI,2BAA2B,CAAC,OAAO,CAAC,CAAA;IACjD,CAAC;IAEM,WAAW,CAAC,IAAuB,EAAE,IAAoB;QAC9D,OAAO,IAAI,sBAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACrD,CAAC;CACF"}

package/dist/models/AsyncActivityAdvanceResult.d.ts

@@ -6,6 +6,7 @@ export interface AsyncActivityResultPendingOptions<TPayload extends Serializable
     schema?: TSchema;
     timeoutAt?: Date | undefined;
     auth?: AsyncActivityCallbackAuth;
+    correlationKey?: string;
 }
 export type AsyncActivityResult<P extends Serializable, S extends Type.TSchema, O extends Serializable | void> = AsyncActivityResultPending<P, S> | AsyncActivityResultFulfilled<O> | AsyncActivityResultRejected<Serializable | void>;
 export declare class AsyncActivityResultPending<TPayload extends Serializable = Serializable, TSchema extends Type.TSchema = Type.TSchema> {
@@ -13,7 +14,8 @@ export declare class AsyncActivityResultPending<TPayload extends Serializable =
     readonly schema?: TSchema;
     readonly timeoutAt?: Date | undefined;
     readonly auth?: AsyncActivityCallbackAuth;
-    constructor({ payload, schema, timeoutAt, auth, }?: AsyncActivityResultPendingOptions<TPayload, TSchema>);
+    readonly correlationKey?: string;
+    constructor({ payload, schema, timeoutAt, auth, correlationKey, }?: AsyncActivityResultPendingOptions<TPayload, TSchema>);
 }
 export declare class AsyncActivityResultFulfilled<T extends Serializable | void = void> {
     readonly payload: T;

package/dist/models/AsyncActivityAdvanceResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncActivityAdvanceResult.d.ts","sourceRoot":"","sources":["../../src/models/AsyncActivityAdvanceResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,SAAS,CAAA;AAE/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,WAAW,iCAAiC,CAChD,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,OAAO,SAAS,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;IAE3C,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;IAC5B,IAAI,CAAC,EAAE,yBAAyB,CAAA;CACjC;AAED,MAAM,MAAM,mBAAmB,CAC7B,CAAC,SAAS,YAAY,EACtB,CAAC,SAAS,IAAI,CAAC,OAAO,EACtB,CAAC,SAAS,YAAY,GAAG,IAAI,IAE3B,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,4BAA4B,CAAC,CAAC,CAAC,GAC/B,2BAA2B,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;AAEpD,qBAAa,0BAA0B,CACrC,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,OAAO,SAAS,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;IAE3C,SAAgB,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClC,SAAgB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChC,SAAgB,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;IAC5C,SAAgB,IAAI,CAAC,EAAE,yBAAyB,CAAA;gBAEpC,EACV,OAAO,EACP,MAAM,EACN,SAAS,EACT,IAAI,GACL,GAAE,iCAAiC,CAAC,QAAQ,EAAE,OAAO,CAAM;CAM7D;AAED,qBAAa,4BAA4B,CACvC,CAAC,SAAS,YAAY,GAAG,IAAI,GAAG,IAAI;aAER,OAAO,EAAE,CAAC;gBAAV,OAAO,EAAE,CAAC;CACvC;AAED,qBAAa,2BAA2B,CAAC,CAAC,SAAS,YAAY,GAAG,IAAI,GAAG,IAAI;aAC/C,OAAO,EAAE,CAAC;gBAAV,OAAO,EAAE,CAAC;CACvC"}
+{"version":3,"file":"AsyncActivityAdvanceResult.d.ts","sourceRoot":"","sources":["../../src/models/AsyncActivityAdvanceResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,SAAS,CAAA;AAE/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,WAAW,iCAAiC,CAChD,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,OAAO,SAAS,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;IAE3C,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;IAC5B,IAAI,CAAC,EAAE,yBAAyB,CAAA;IAChC,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,MAAM,mBAAmB,CAC7B,CAAC,SAAS,YAAY,EACtB,CAAC,SAAS,IAAI,CAAC,OAAO,EACtB,CAAC,SAAS,YAAY,GAAG,IAAI,IAE3B,0BAA0B,CAAC,CAAC,EAAE,CAAC,CAAC,GAChC,4BAA4B,CAAC,CAAC,CAAC,GAC/B,2BAA2B,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;AAEpD,qBAAa,0BAA0B,CACrC,QAAQ,SAAS,YAAY,GAAG,YAAY,EAC5C,OAAO,SAAS,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO;IAE3C,SAAgB,OAAO,CAAC,EAAE,QAAQ,CAAA;IAClC,SAAgB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChC,SAAgB,SAAS,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;IAC5C,SAAgB,IAAI,CAAC,EAAE,yBAAyB,CAAA;IAChD,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAA;gBAE3B,EACV,OAAO,EACP,MAAM,EACN,SAAS,EACT,IAAI,EACJ,cAAc,GACf,GAAE,iCAAiC,CAAC,QAAQ,EAAE,OAAO,CAAM;CAO7D;AAED,qBAAa,4BAA4B,CACvC,CAAC,SAAS,YAAY,GAAG,IAAI,GAAG,IAAI;aAER,OAAO,EAAE,CAAC;gBAAV,OAAO,EAAE,CAAC;CACvC;AAED,qBAAa,2BAA2B,CAAC,CAAC,SAAS,YAAY,GAAG,IAAI,GAAG,IAAI;aAC/C,OAAO,EAAE,CAAC;gBAAV,OAAO,EAAE,CAAC;CACvC"}

package/dist/models/AsyncActivityAdvanceResult.js

@@ -3,11 +3,13 @@ export class AsyncActivityResultPending {
     schema;
     timeoutAt;
     auth;
-    constructor({ payload, schema, timeoutAt, auth, } = {}) {
+    correlationKey;
+    constructor({ payload, schema, timeoutAt, auth, correlationKey, } = {}) {
         this.payload = payload;
         this.schema = schema;
         this.timeoutAt = timeoutAt;
         this.auth = auth;
+        this.correlationKey = correlationKey;
     }
 }
 export class AsyncActivityResultFulfilled {

package/dist/models/AsyncActivityAdvanceResult.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncActivityAdvanceResult.js","sourceRoot":"","sources":["../../src/models/AsyncActivityAdvanceResult.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,0BAA0B;IAIrB,OAAO,CAAW;IAClB,MAAM,CAAU;IAChB,SAAS,CAAmB;IAC5B,IAAI,CAA4B;IAEhD,YAAY,EACV,OAAO,EACP,MAAM,EACN,SAAS,EACT,IAAI,MACoD,EAAE;QAC1D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,4BAA4B;IAGX;IAA5B,YAA4B,OAAU;QAAV,YAAO,GAAP,OAAO,CAAG;IAAG,CAAC;CAC3C;AAED,MAAM,OAAO,2BAA2B;IACV;IAA5B,YAA4B,OAAU;QAAV,YAAO,GAAP,OAAO,CAAG;IAAG,CAAC;CAC3C"}
+{"version":3,"file":"AsyncActivityAdvanceResult.js","sourceRoot":"","sources":["../../src/models/AsyncActivityAdvanceResult.ts"],"names":[],"mappings":"AAyBA,MAAM,OAAO,0BAA0B;IAIrB,OAAO,CAAW;IAClB,MAAM,CAAU;IAChB,SAAS,CAAmB;IAC5B,IAAI,CAA4B;IAChC,cAAc,CAAS;IAEvC,YAAY,EACV,OAAO,EACP,MAAM,EACN,SAAS,EACT,IAAI,EACJ,cAAc,MAC0C,EAAE;QAC1D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAA;IACtC,CAAC;CACF;AAED,MAAM,OAAO,4BAA4B;IAGX;IAA5B,YAA4B,OAAU;QAAV,YAAO,GAAP,OAAO,CAAG;IAAG,CAAC;CAC3C;AAED,MAAM,OAAO,2BAA2B;IACV;IAA5B,YAA4B,OAAU;QAAV,YAAO,GAAP,OAAO,CAAG;IAAG,CAAC;CAC3C"}

package/dist/models/AsyncActivityAwaitable.d.ts

@@ -1,6 +1,6 @@
 import { type Activity } from './Activity.js';
 import type { AnyAsyncActivity } from './AsyncActivity.js';
-import { type IHistoryItemAsync } from './History.js';
+import type { IHistoryItemAsync } from './History.js';
 export declare class AsyncActivityAwaitable<T extends AnyAsyncActivity> {
     private readonly activity;
     private readonly item;

package/dist/models/AsyncActivityAwaitable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncActivityAwaitable.d.ts","sourceRoot":"","sources":["../../src/models/AsyncActivityAwaitable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAW,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAG9D,qBAAa,sBAAsB,CAAC,CAAC,SAAS,gBAAgB;IAE1D,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFJ,QAAQ,EAAE,CAAC,EACX,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,SAAS,GAAG,EAAE;IAG1B,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAQjD"}
+{"version":3,"file":"AsyncActivityAwaitable.d.ts","sourceRoot":"","sources":["../../src/models/AsyncActivityAwaitable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAGrD,qBAAa,sBAAsB,CAAC,CAAC,SAAS,gBAAgB;IAE1D,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFJ,QAAQ,EAAE,CAAC,EACX,IAAI,EAAE,iBAAiB,EACvB,IAAI,EAAE,SAAS,GAAG,EAAE;IAG1B,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;CAMjD"}

package/dist/models/AsyncActivityAwaitable.js

@@ -1,5 +1,4 @@
 import {} from './Activity.js';
-import { History } from './History.js';
 import { PushWaitAsyncActivity } from './PushWaitAsyncActivity.js';
 export class AsyncActivityAwaitable {
     activity;
@@ -13,7 +12,6 @@ export class AsyncActivityAwaitable {
     async wait() {
         if (this.item.status === 'pending')
             throw new PushWaitAsyncActivity(this.activity, this.item.timeoutAt);
-        History.advanceClock(this.item.settledAt);
         return this.activity.toOutput(this.item.output, ...this.args);
     }
 }

package/dist/models/AsyncActivityAwaitable.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncActivityAwaitable.js","sourceRoot":"","sources":["../../src/models/AsyncActivityAwaitable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,MAAM,eAAe,CAAA;AAE7C,OAAO,EAAE,OAAO,EAA0B,MAAM,cAAc,CAAA;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE,MAAM,OAAO,sBAAsB;IAEd;IACA;IACA;IAHnB,YACmB,QAAW,EACX,IAAuB,EACvB,IAAoB;QAFpB,aAAQ,GAAR,QAAQ,CAAG;QACX,SAAI,GAAJ,IAAI,CAAmB;QACvB,SAAI,GAAJ,IAAI,CAAgB;IACpC,CAAC;IAEG,KAAK,CAAC,IAAI;QACf,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS;YAChC,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAErE,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAEzC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/D,CAAC;CACF"}
+{"version":3,"file":"AsyncActivityAwaitable.js","sourceRoot":"","sources":["../../src/models/AsyncActivityAwaitable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,MAAM,eAAe,CAAA;AAG7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAElE,MAAM,OAAO,sBAAsB;IAEd;IACA;IACA;IAHnB,YACmB,QAAW,EACX,IAAuB,EACvB,IAAoB;QAFpB,aAAQ,GAAR,QAAQ,CAAG;QACX,SAAI,GAAJ,IAAI,CAAmB;QACvB,SAAI,GAAJ,IAAI,CAAgB;IACpC,CAAC;IAEG,KAAK,CAAC,IAAI;QACf,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS;YAChC,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAErE,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/D,CAAC;CACF"}

package/dist/models/History.d.ts

@@ -1,40 +1,25 @@
 import { type Activity } from './Activity.js';
 import { type AnyAsyncActivity } from './AsyncActivity.js';
-import type { AsyncActivityAwaitable } from './AsyncActivityAwaitable.js';
+import { AsyncActivityAwaitable } from './AsyncActivityAwaitable.js';
 export type HistoryItemType = 'sync' | 'async';
 interface IHistoryItem<T extends HistoryItemType> {
     id: string;
     type: T;
     output: any;
-    createdAt: number;
 }
 export interface IHistoryItemSync extends IHistoryItem<'sync'> {
 }
 export interface IHistoryItemAsync extends IHistoryItem<'async'> {
     status: 'pending' | 'fulfilled' | 'rejected';
     timeoutAt?: Date | null;
-    settledAt?: number;
 }
 export type HistoryItem = IHistoryItemSync | IHistoryItemAsync;
-export interface HistoryRunOptions {
-    history: readonly HistoryItem[];
-    seed: string;
-    createdAt: number;
-}
-export interface HistoryStore {
-    readonly items: HistoryItem[];
-    readonly seed: string;
-    clock: number;
-    randomCalls: number;
-}
 export declare namespace History {
     type ReconcilerOutput<T extends Activity> = T extends AnyAsyncActivity ? AsyncActivityAwaitable<T> : Activity.Output<T>;
     function bind<T extends Activity>(Activity: new () => T): (...args: Activity.Args<T>) => Promise<ReconcilerOutput<T>>;
     function reconciler<T extends Activity>(Activity: new () => T, ...args: Activity.Args<T>): Promise<ReconcilerOutput<T>>;
     function isReplaying(): boolean;
-    function peek(): HistoryStore | undefined;
-    function advanceClock(at: number | undefined): void;
-    function run<T>(options: HistoryRunOptions, fn: () => T): T;
+    function run<T>(history: readonly HistoryItem[], fn: () => T): T;
 }
 export {};
 //# sourceMappingURL=History.d.ts.map

package/dist/models/History.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"History.d.ts","sourceRoot":"","sources":["../../src/models/History.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAIzE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,CAAA;AAE9C,UAAU,YAAY,CAAC,CAAC,SAAS,eAAe;IAC9C,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,CAAC,CAAA;IACP,MAAM,EAAE,GAAG,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;CAClB;AAGD,MAAM,WAAW,gBAAiB,SAAQ,YAAY,CAAC,MAAM,CAAC;CAAG;AAEjE,MAAM,WAAW,iBAAkB,SAAQ,YAAY,CAAC,OAAO,CAAC;IAC9D,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAA;IAC5C,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;AAE9D,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,yBAAiB,OAAO,CAAC;IACvB,KAAY,gBAAgB,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,SAAS,gBAAgB,GACzE,sBAAsB,CAAC,CAAC,CAAC,GACzB,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAItB,SAAgB,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,IACpD,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,kCAClC;IAED,SAAsB,UAAU,CAAC,CAAC,SAAS,QAAQ,EACjD,QAAQ,EAAE,UAAU,CAAC,EACrB,GAAG,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CA8B9B;IAED,SAAgB,WAAW,IAAI,OAAO,CAMrC;IAED,SAAgB,IAAI,IAAI,YAAY,GAAG,SAAS,CAE/C;IAED,SAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,QAMlD;IAED,SAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAYjE;CACF"}
+{"version":3,"file":"History.d.ts","sourceRoot":"","sources":["../../src/models/History.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAGpE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,CAAA;AAE9C,UAAU,YAAY,CAAC,CAAC,SAAS,eAAe;IAC9C,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,CAAC,CAAA;IACP,MAAM,EAAE,GAAG,CAAA;CACZ;AAGD,MAAM,WAAW,gBAAiB,SAAQ,YAAY,CAAC,MAAM,CAAC;CAAG;AAEjE,MAAM,WAAW,iBAAkB,SAAQ,YAAY,CAAC,OAAO,CAAC;IAC9D,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAA;IAC5C,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,MAAM,WAAW,GAAG,gBAAgB,GAAG,iBAAiB,CAAA;AAE9D,yBAAiB,OAAO,CAAC;IACvB,KAAY,gBAAgB,CAAC,CAAC,SAAS,QAAQ,IAAI,CAAC,SAAS,gBAAgB,GACzE,sBAAsB,CAAC,CAAC,CAAC,GACzB,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAItB,SAAgB,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,IACpD,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,kCAClC;IAED,SAAsB,UAAU,CAAC,CAAC,SAAS,QAAQ,EACjD,QAAQ,EAAE,UAAU,CAAC,EACrB,GAAG,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CA4B9B;IAED,SAAgB,WAAW,IAAI,OAAO,CAMrC;IAED,SAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,KAElE;CACF"}