yieldstar 0.4.6 → 0.6.0

package/README.md

@@ -4,7 +4,7 @@ JavaScript‑native distributed workflows.
 
 Write workflows as async generator functions that yield steps. Use first‑class primitives for retries, delays, and polling. .
 
-Currently supports running on Bun and Sqlite. Postgres support will be added next.
+The resident-process runtime runs on Bun and Node with native SQLite connectors.
 
 ## Install
 
@@ -16,18 +16,19 @@ bun add yieldstar
 
 Depending on how you run workflows, also install:
 
-- Local (recommended): `@yieldstar/bun-worker-invoker` and `@yieldstar/bun-sqlite-runtime`
-- HTTP server (Bun): `@yieldstar/bun-http-server` and `@yieldstar/bun-worker-invoker`
+- Local (recommended): `@yieldstar/worker-invoker` and `@yieldstar/sqlite-runtime`
+- HTTP server: `@yieldstar/http-server` and `@yieldstar/worker-invoker`
 
 Note: `@yieldstar/test-utils` is an internal testing helper used by this repository. For local application use, prefer the SQLite runtime.
 
 ## Quick Start: Local (SQLite)
 
-Run a workflow locally with persistence and timers using a Bun worker and the SQLite runtime.
+Run a workflow locally with persistence and timers using a subprocess worker and the SQLite runtime. The example uses the Bun connector; Node applications use `@yieldstar/sqlite-runtime/node` with otherwise identical runtime wiring.
 
 ```ts
-// router.ts
+// shared.ts
 import { workflow, createWorkflowRouter } from "yieldstar";
+import { SqliteRuntime, createSqliteDb } from "@yieldstar/sqlite-runtime/bun";
 
 export const simple = workflow(async function* (step, event, logger) {
   const n = yield* step.run(() => 1);
@@ -37,28 +38,19 @@ export const simple = workflow(async function* (step, event, logger) {
 
 export const router = createWorkflowRouter({ "simple-workflow": simple });
 export type Router = typeof router;
+
+export const runtime = new SqliteRuntime(createSqliteDb({ path: "./.db/local.sqlite" }));
 ```
 
 ```ts
 // worker.ts
 import pino from "pino";
 import { WorkflowRunner } from "@yieldstar/core";
-import { createWorkflowWorker } from "@yieldstar/bun-worker-invoker";
-import { SqliteHeapClient, SqliteTimersClient, SqliteTaskQueueClient, SqliteSchedulerClient, createSqliteDb } from "@yieldstar/bun-sqlite-runtime";
-import { router } from "./router";
+import { createWorkflowWorker } from "@yieldstar/worker-invoker";
+import { router, runtime } from "./shared";
 
 const logger = pino();
-const db = createSqliteDb({ path: "./.db/local.sqlite" });
-
-const runner = new WorkflowRunner({
-  router,
-  heapClient: new SqliteHeapClient(db),
-  schedulerClient: new SqliteSchedulerClient({
-    taskQueueClient: new SqliteTaskQueueClient(db),
-    timersClient: new SqliteTimersClient(db),
-  }),
-  logger,
-});
+const runner = new WorkflowRunner(runtime, { router, logger });
 
 createWorkflowWorker(runner, logger).listen();
 ```
@@ -66,33 +58,39 @@ createWorkflowWorker(runner, logger).listen();
 ```ts
 // app.ts
 import pino from "pino";
-import { createWorkflowInvoker } from "@yieldstar/bun-worker-invoker";
+import { ExecutionDispatcher } from "@yieldstar/core";
+import { createWorkflowInvoker } from "@yieldstar/worker-invoker";
 import { createLocalSdk } from "yieldstar";
-import { SqliteEventLoop, createSqliteDb } from "@yieldstar/bun-sqlite-runtime";
+import { runtime, type Router } from "./shared";
 
 const logger = pino();
 const workerPath = new URL("./worker.ts", import.meta.url).href;
 const invoker = createWorkflowInvoker({ workerPath, logger });
 
-const db = createSqliteDb({ path: "./.db/local.sqlite" });
-const loop = new SqliteEventLoop(db);
-loop.start({ onNewEvent: invoker.execute, logger });
+// The dispatcher delivers due executions to workers; the SDK only admits them.
+const dispatcher = new ExecutionDispatcher(runtime, { invoker, logger });
+dispatcher.start();
 
-const sdk = createLocalSdk<import("./router").Router>(invoker);
+const sdk = createLocalSdk<Router>(runtime, { invoker });
 const result = await sdk.triggerAndWait({ workflowId: "simple-workflow" });
 console.log(result); // 2
+await dispatcher.stop();
 ```
 
+TypeScript worker paths require Node 22.6 or newer for built-in type stripping. Use compiled JavaScript workers on older Node versions.
+
 ## Pick Your Runtime
 
 ### Option A: Local Worker + SQLite (single process)
 
-Use a Bun worker to execute steps and a SQLite‑backed runtime for persistence, timers, and a task queue.
+Use a subprocess worker to execute steps and a SQLite-backed runtime for execution records, step results, and stores.
 
-1) Define workflows and a router:
+1) Define workflows, a router, and the runtime:
 
 ```ts
+// shared.ts
 import { workflow, createWorkflowRouter } from "yieldstar";
+import { SqliteRuntime, createSqliteDb } from "@yieldstar/sqlite-runtime/bun";
 
 export const dynamic = workflow<{ msg: string }, void>(async function* (step, event, logger) {
   const n = yield* step.run(() => Math.random());
@@ -101,78 +99,69 @@ export const dynamic = workflow<{ msg: string }, void>(async function* (step, ev
 });
 
 export const router = createWorkflowRouter({ "dynamic-workflow": dynamic });
+export type Router = typeof router;
+
+export const runtime = new SqliteRuntime(createSqliteDb({ path: "./.db/local.sqlite" }));
 ```
 
-2) Create worker and runtime wiring (worker thread):
+2) Create the worker (a forked subprocess):
 
 ```ts
 // worker.ts
 import pino from "pino";
 import { WorkflowRunner } from "@yieldstar/core";
-import { createWorkflowWorker } from "@yieldstar/bun-worker-invoker";
-import { SqliteHeapClient, SqliteTimersClient, SqliteTaskQueueClient, SqliteSchedulerClient } from "@yieldstar/bun-sqlite-runtime";
-import { router } from "./router";
-import { createSqliteDb } from "@yieldstar/bun-sqlite-runtime";
+import { createWorkflowWorker } from "@yieldstar/worker-invoker";
+import { router, runtime } from "./shared";
 
 const logger = pino();
-const db = createSqliteDb({ path: "./.db/local.sqlite" });
-
-const runner = new WorkflowRunner({
-  router,
-  heapClient: new SqliteHeapClient(db),
-  schedulerClient: new SqliteSchedulerClient({
-    taskQueueClient: new SqliteTaskQueueClient(db),
-    timersClient: new SqliteTimersClient(db),
-  }),
-  logger,
-});
+const runner = new WorkflowRunner(runtime, { router, logger });
 
 createWorkflowWorker(runner, logger).listen();
 ```
 
-3) Drive the worker from your app and call workflows locally:
+3) Run a dispatcher in your app and trigger workflows locally:
 
 ```ts
 // app.ts
 import pino from "pino";
-import { createWorkflowInvoker } from "@yieldstar/bun-worker-invoker";
+import { ExecutionDispatcher } from "@yieldstar/core";
+import { createWorkflowInvoker } from "@yieldstar/worker-invoker";
 import { createLocalSdk } from "yieldstar";
-import { SqliteEventLoop, createSqliteDb } from "@yieldstar/bun-sqlite-runtime";
+import { runtime, type Router } from "./shared";
 
 const logger = pino();
 const workerPath = new URL("./worker.ts", import.meta.url).href;
 const invoker = createWorkflowInvoker({ workerPath, logger });
 
-const db = createSqliteDb({ path: "./.db/local.sqlite" });
-const eventLoop = new SqliteEventLoop(db);
-eventLoop.start({ onNewEvent: invoker.execute, logger });
+const dispatcher = new ExecutionDispatcher(runtime, { invoker, logger });
+dispatcher.start();
 
-const sdk = createLocalSdk<{ "dynamic-workflow": any }>(invoker);
+const sdk = createLocalSdk<Router>(runtime, { invoker });
 const res = await sdk.triggerAndWait({ workflowId: "dynamic-workflow", params: { msg: "hello" } });
 console.log(res);
+await dispatcher.stop();
 ```
 
 See a working reference in `examples/local-execution/`.
 
 ### Option B: HTTP Server (Bun)
 
-Expose routes to trigger and await workflow results. Use the HTTP SDK as a client.
+Expose routes to admit executions and await their outcomes. Use the HTTP SDK as a client. `/trigger` responds `202 { executionId }` once the execution is admitted, and `409` when the supplied `executionId` is already in use.
 
 Server:
 
 ```ts
 import pino from "pino";
-import { createRoutes, createMiddleware } from "@yieldstar/bun-http-server";
-import { createWorkflowInvoker } from "@yieldstar/bun-worker-invoker";
-import { SqliteEventLoop, createSqliteDb } from "@yieldstar/bun-sqlite-runtime";
-import { router } from "./router";
+import { ExecutionDispatcher } from "@yieldstar/core";
+import { createRoutes, createMiddleware } from "@yieldstar/http-server";
+import { createWorkflowInvoker } from "@yieldstar/worker-invoker";
+import { runtime } from "./shared";
 
 const logger = pino();
 const workerPath = new URL("./worker.ts", import.meta.url).href;
 const invoker = createWorkflowInvoker({ workerPath, logger });
 
-const db = createSqliteDb({ path: "./.db/http.sqlite" });
-new SqliteEventLoop(db).start({ onNewEvent: invoker.execute, logger });
+new ExecutionDispatcher(runtime, { invoker, logger }).start();
 
 const auth = createMiddleware(async (req, event, next) => {
   if (!req.headers.get("Authorization")) return new Response("Unauthorized", { status: 401 });
@@ -181,7 +170,7 @@ const auth = createMiddleware(async (req, event, next) => {
 
 Bun.serve({
   port: 8080,
-  routes: { "/status": new Response("OK"), ...createRoutes({ invoker, logger, middleware: [auth] }) },
+  routes: { "/status": new Response("OK"), ...createRoutes({ runtime, invoker, logger, middleware: [auth] }) },
 });
 ```
 
@@ -289,7 +278,7 @@ Top‑level exports from `yieldstar`:
 export { createLocalSdk } from "yieldstar";
 export { createHttpSdkFactory } from "yieldstar";
 export { createWorkflowRouter } from "yieldstar";
-export { RetryableError } from "yieldstar";
+export { RetryableError, ExecutionAdmissionError } from "yieldstar";
 export { createWorkflow, workflow } from "yieldstar";
 export type { WorkflowFn } from "yieldstar";
 ```
@@ -334,13 +323,16 @@ new RetryableError(message, { maxAttempts: number, retryInterval: number });
 
 ### Local SDK
 
-Create a client that triggers workflows using an in‑process `WorkflowInvoker`.
+Create a client that admits executions directly into a runtime. A running `ExecutionDispatcher` delivers them.
 
 ```ts
-const sdk = createLocalSdk<Router>(invoker);
+const sdk = createLocalSdk<Router>(runtime, { invoker?, pollInterval? });
+const { executionId } = await sdk.trigger({ workflowId, params?, context?, executionId? });
 await sdk.triggerAndWait({ workflowId, params? });
 ```
 
+`trigger` resolves once admission commits. `triggerAndWait` resolves with the result recorded on the execution record, or rejects with the recorded error. Both throw `ExecutionAdmissionError` when the `executionId` is already in use (`EXECUTION_ID_CONFLICT`) or `params`/`context` are not durable values (`INVALID_EXECUTION_EVENT`).
+
 ### HTTP SDK
 
 Factory returning a client bound to a base URL.
@@ -370,7 +362,7 @@ Use `Router` to type your SDKs so `workflowId` and `params` are enforced.
 For repository development we use an in‑memory runtime driven by `@yieldstar/test-utils` to `triggerAndWait` in tests. This package is internal; application users should test against the same runtime they use in production where possible. Example (internal):
 
 ```ts
-import { test, expect } from "bun:test";
+import { test, expect } from "vitest";
 import { createTestSdkFactory } from "@yieldstar/test-utils";
 import { createWorkflow } from "yieldstar";
 
@@ -392,7 +384,8 @@ See more examples in `test/*.test.ts`.
 
 - In loops, always add cache keys. Missing keys trigger loop detection.
 - `logger` is a Pino logger passed into workflows for observability.
-- HTTP middleware can read/set `event.context` before invoking your workflow.
+- HTTP middleware can read/set `event.context` before the execution is admitted.
+- Execution IDs are never reused. Triggering with an ID that was already admitted throws `ExecutionAdmissionError`.
 
 ## Contributing
 
@@ -405,4 +398,4 @@ MIT
 
 ## Author
 
-[Daniel Grant](danielgrant.co)
+[Daniel Grant](https://danielgrant.co)

package/dist/exports/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/exports/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;CAOvD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/exports/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,cAAe,SAAQ,KAAK;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;gBAEpB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;CAOvD"}

package/dist/exports/sdk-http.d.ts

@@ -11,6 +11,14 @@ export declare function createHttpSdkFactory<W extends WorkflowRouter>(): (param
     url: string;
     fetchOptions?: Omit<RequestInit, "body" | "method">;
 }) => {
+    /**
+     * Admits an execution through the trigger route. When `executionId` is
+     * omitted the runtime chooses one, which the response carries. The body
+     * is encoded with the durable value codec, so params and context reach
+     * the runtime unchanged.
+     * @throws {ExecutionAdmissionError} on `409 Conflict` or an invalid event,
+     * including params or context the codec rejects, before any request
+     */
     trigger<K extends string & keyof W>(event: TriggerEvent<K, EventParamsOf<W[K]>>): Promise<TriggerResponse<W, K>>;
     waitForResult<K extends string & keyof W>(ack: TriggerAck): Promise<WorkflowGeneratorReturnType<W[K]>>;
 };

package/dist/exports/sdk-http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-http.d.ts","sourceRoot":"","sources":["../../src/exports/sdk-http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,YAAY,EAEZ,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AAKzB,KAAK,UAAU,GAAG;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,eAAe,CAAC,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,IAAI;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B,aAAa,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACjE,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,cAAc,MACnD,QAAQ;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CACrD;YAEiB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,SAC/B,YAAY,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;kBA2Bb,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,OACvC,UAAU,GACd,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;EAoBlD"}
+{"version":3,"file":"sdk-http.d.ts","sourceRoot":"","sources":["../../src/exports/sdk-http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,2BAA2B,EAE5B,MAAM,iBAAiB,CAAC;AAMzB,KAAK,UAAU,GAAG;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,eAAe,CAAC,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,IAAI;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/B,aAAa,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACjE,CAAC;AAOF,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,cAAc,MACnD,QAAQ;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC;CACrD;IAEG;;;;;;;OAOG;YACW,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,SAC/B,YAAY,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;kBAoCb,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,OACvC,UAAU,GACd,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;EA8BlD"}

package/dist/exports/sdk-local.d.ts

@@ -1,9 +1,26 @@
-import type { EventParamsOf, WorkflowRouter, WorkflowInvoker, TriggerEvent, WorkflowGeneratorReturnType } from "@yieldstar/core";
+import type { EventParamsOf, ExecutionClient, WorkflowRouter, WorkflowInvoker, TriggerEvent, WorkflowGeneratorReturnType } from "@yieldstar/core";
 type TriggerAck = {
     executionId: string;
 };
-export declare function createLocalSdk<W extends WorkflowRouter>(invoker: WorkflowInvoker): {
+export declare function createLocalSdk<W extends WorkflowRouter>(runtime: {
+    executions: ExecutionClient;
+}, options?: {
+    /** Lets `triggerAndWait` settle as soon as the dispatcher acknowledges. */
+    invoker?: WorkflowInvoker;
+    /** Milliseconds between reads of the execution record. @default 25 */
+    pollInterval?: number;
+}): {
+    /**
+     * Admits an execution and resolves once admission commits. A dispatcher
+     * delivers it; this does not wait for a worker to start.
+     * @throws {ExecutionAdmissionError} when the ID is already in use or the
+     * event cannot be stored without loss
+     */
     trigger<K extends string & keyof W>(event: TriggerEvent<K, EventParamsOf<W[K]>>): Promise<TriggerAck>;
+    /**
+     * Admits an execution and waits for its record to reach a terminal
+     * status. Resolves with the result, or rejects with the recorded error.
+     */
     triggerAndWait<K extends string & keyof W>(event: TriggerEvent<K, EventParamsOf<W[K]>>): Promise<WorkflowGeneratorReturnType<W[K]>>;
 };
 export {};

package/dist/exports/sdk-local.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-local.d.ts","sourceRoot":"","sources":["../../src/exports/sdk-local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EAEZ,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AAGzB,KAAK,UAAU,GAAG;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,SAAS,cAAc,EACrD,OAAO,EAAE,eAAe;YAGR,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,SAC/B,YAAY,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,UAAU,CAAC;mBASD,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,SACtC,YAAY,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;EAWhD"}
+{"version":3,"file":"sdk-local.d.ts","sourceRoot":"","sources":["../../src/exports/sdk-local.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,EACZ,2BAA2B,EAC5B,MAAM,iBAAiB,CAAC;AAMzB,KAAK,UAAU,GAAG;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,cAAc,CAAC,CAAC,SAAS,cAAc,EACrD,OAAO,EAAE;IAAE,UAAU,EAAE,eAAe,CAAA;CAAE,EACxC,OAAO,CAAC,EAAE;IACR,2EAA2E;IAC3E,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;IAKC;;;;;OAKG;YACW,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,SAC/B,YAAY,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,UAAU,CAAC;IAYtB;;;OAGG;mBACkB,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,SACtC,YAAY,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;EAahD"}

package/dist/exports/workflow.d.ts

@@ -1,7 +1,19 @@
 import type { Logger } from "pino";
-import type { WorkflowEvent, WorkflowGenerator, EventParams, EventContext } from "@yieldstar/core";
+import type { Durable, WorkflowEvent, WorkflowGenerator, EventParams, EventContext, IfDurable } from "@yieldstar/core";
 import type { StepRunner } from "../internal/step-runner";
 export type WorkflowFn<Params extends EventParams, Result, Context extends EventContext> = (step: StepRunner, event: WorkflowEvent<Params, Context>, logger: Logger) => AsyncGenerator<any, Result>;
-export declare function workflow<Params extends EventParams, Result, Context extends EventContext>(workflowFn: WorkflowFn<Params, Result, Context>): WorkflowGenerator<Params, Result, Context>;
+/**
+ * A workflow function whose params and result are durable values. Params are
+ * an input, so a function type cannot check them; a missing property named
+ * for the problem does instead.
+ */
+export type DurableWorkflowFn<Params, Result> = IfDurable<Params, {
+    "Workflow params must be durable values": Durable<Params>;
+}> & IfDurable<Result, (step: any, event: any, logger: any) => AsyncGenerator<any, Durable<Result>>>;
+/**
+ * Wraps a workflow function in a generator that advances its steps and yields
+ * control to the executor whenever a step needs async work.
+ */
+export declare function workflow<Params extends EventParams, Result, Context extends EventContext>(workflowFn: WorkflowFn<Params, Result, Context> & DurableWorkflowFn<Params, Result>): WorkflowGenerator<Params, Result, Context>;
 export declare const createWorkflow: typeof workflow;
 //# sourceMappingURL=workflow.d.ts.map

package/dist/exports/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/exports/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAkB1D,MAAM,MAAM,UAAU,CACpB,MAAM,SAAS,WAAW,EAC1B,MAAM,EACN,OAAO,SAAS,YAAY,IAC1B,CACF,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,MAAM,EAAE,MAAM,KACX,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAEjC,wBAAgB,QAAQ,CACtB,MAAM,SAAS,WAAW,EAC1B,MAAM,EACN,OAAO,SAAS,YAAY,EAE5B,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAC9C,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAuM5C;AAED,eAAO,MAAM,cAAc,iBAAW,CAAC"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/exports/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,SAAS,EACV,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA4B1D,MAAM,MAAM,UAAU,CACpB,MAAM,SAAS,WAAW,EAC1B,MAAM,EACN,OAAO,SAAS,YAAY,IAC1B,CACF,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,MAAM,EAAE,MAAM,KACX,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAEjC;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,MAAM,EAAE,MAAM,IAAI,SAAS,CACvD,MAAM,EACN;IAAE,wCAAwC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAC9D,GACC,SAAS,CACP,MAAM,EACN,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAC7E,CAAC;AAEJ;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,MAAM,SAAS,WAAW,EAC1B,MAAM,EACN,OAAO,SAAS,YAAY,EAE5B,UAAU,EAAE,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAC7C,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,GAClC,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CA2N5C;AAED,eAAO,MAAM,cAAc,iBAAW,CAAC"}

package/dist/index.d.ts

@@ -2,6 +2,10 @@ export { createLocalSdk } from "./exports/sdk-local";
 export { createHttpSdkFactory } from "./exports/sdk-http";
 export { createWorkflowRouter } from "./exports/router";
 export { RetryableError } from "./exports/errors";
+export { EffectClientInvariantError, EffectDeliveryError, ExecutionAdmissionError, WORKFLOW_RESULT_STEP_KEY, WorkflowEffectError, WorkflowStartError, WorkflowValueError, registerErrorClass, } from "@yieldstar/core";
 export { createWorkflow, workflow } from "./exports/workflow";
-export type { WorkflowFn } from "./exports/workflow";
+export type { DurableWorkflowFn, WorkflowFn } from "./exports/workflow";
+export { defineStore } from "./internal/step-runner";
+export type { DurableStepFn, EffectDescriptor, EffectLookup, StepRunner, StepRunOptions, WorkflowStore, } from "./internal/step-runner";
+export type { Draft, RuntimeStore, StandardSchemaV1, StoreDefinition, StoreDeleteFromResult, StoreKey, StorePath, StoreSelector, StoreSnapshot, StoreState, DurableStoreSchema, StoreUpdateFromResult, StoreUpdateResult, StoreVersion, WorkflowEvent, ExecutionAdmissionErrorCode, ExecutionOutcome, ExecutionRecord, ExecutionStatus, ExecutionParent, Durable, DurableObject, DurableValue, ErrorClass, WorkflowValueErrorCode, WorkflowStartErrorCode, EffectDeliveryErrorCode, EffectRecord, WorkflowEffectErrorCode, } from "@yieldstar/core";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,KAAK,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,2BAA2B,EAC3B,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,OAAO,EACP,aAAa,EACb,YAAY,EACZ,UAAU,EACV,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,YAAY,EACZ,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}