yieldstar 0.4.6 → 0.5.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,14 +16,14 @@ 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
@@ -43,8 +43,8 @@ export type Router = typeof router;
 // 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 { createWorkflowWorker } from "@yieldstar/worker-invoker";
+import { SqliteHeapClient, SqliteTimersClient, SqliteTaskQueueClient, SqliteSchedulerClient, createSqliteDb } from "@yieldstar/sqlite-runtime/bun";
 import { router } from "./router";
 
 const logger = pino();
@@ -66,9 +66,9 @@ createWorkflowWorker(runner, logger).listen();
 ```ts
 // app.ts
 import pino from "pino";
-import { createWorkflowInvoker } from "@yieldstar/bun-worker-invoker";
+import { createWorkflowInvoker } from "@yieldstar/worker-invoker";
 import { createLocalSdk } from "yieldstar";
-import { SqliteEventLoop, createSqliteDb } from "@yieldstar/bun-sqlite-runtime";
+import { SqliteEventLoop, createSqliteDb } from "@yieldstar/sqlite-runtime/bun";
 
 const logger = pino();
 const workerPath = new URL("./worker.ts", import.meta.url).href;
@@ -83,11 +83,13 @@ const result = await sdk.triggerAndWait({ workflowId: "simple-workflow" });
 console.log(result); // 2
 ```
 
+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 persistence, timers, and a task queue.
 
 1) Define workflows and a router:
 
@@ -109,10 +111,10 @@ export const router = createWorkflowRouter({ "dynamic-workflow": dynamic });
 // 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 { createWorkflowWorker } from "@yieldstar/worker-invoker";
+import { SqliteHeapClient, SqliteTimersClient, SqliteTaskQueueClient, SqliteSchedulerClient } from "@yieldstar/sqlite-runtime/bun";
 import { router } from "./router";
-import { createSqliteDb } from "@yieldstar/bun-sqlite-runtime";
+import { createSqliteDb } from "@yieldstar/sqlite-runtime/bun";
 
 const logger = pino();
 const db = createSqliteDb({ path: "./.db/local.sqlite" });
@@ -135,9 +137,9 @@ createWorkflowWorker(runner, logger).listen();
 ```ts
 // app.ts
 import pino from "pino";
-import { createWorkflowInvoker } from "@yieldstar/bun-worker-invoker";
+import { createWorkflowInvoker } from "@yieldstar/worker-invoker";
 import { createLocalSdk } from "yieldstar";
-import { SqliteEventLoop, createSqliteDb } from "@yieldstar/bun-sqlite-runtime";
+import { SqliteEventLoop, createSqliteDb } from "@yieldstar/sqlite-runtime/bun";
 
 const logger = pino();
 const workerPath = new URL("./worker.ts", import.meta.url).href;
@@ -162,9 +164,9 @@ 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 { createRoutes, createMiddleware } from "@yieldstar/http-server";
+import { createWorkflowInvoker } from "@yieldstar/worker-invoker";
+import { SqliteEventLoop, createSqliteDb } from "@yieldstar/sqlite-runtime/bun";
 import { router } from "./router";
 
 const logger = pino();
@@ -370,7 +372,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";
 
@@ -405,4 +407,4 @@ MIT
 
 ## Author
 
-[Daniel Grant](danielgrant.co)
+[Daniel Grant](https://danielgrant.co)

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,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,YAAY,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAmB1D,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,CA0M5C;AAED,eAAO,MAAM,cAAc,iBAAW,CAAC"}

package/dist/index.d.ts

@@ -4,4 +4,7 @@ export { createWorkflowRouter } from "./exports/router";
 export { RetryableError } from "./exports/errors";
 export { createWorkflow, workflow } from "./exports/workflow";
 export type { WorkflowFn } from "./exports/workflow";
+export { defineStore } from "./internal/step-runner";
+export type { WorkflowStore } from "./internal/step-runner";
+export type { Draft, RuntimeStore, StandardSchemaV1, StoreDefinition, StoreDeleteFromResult, StoreKey, StorePath, StoreSelector, StoreSnapshot, StoreState, StoreUpdateFromResult, StoreUpdateResult, StoreVersion, WorkflowEvent, } 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,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EACV,KAAK,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,EACb,UAAU,EACV,qBAAqB,EACrB,iBAAiB,EACjB,YAAY,EACZ,aAAa,GACd,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,4 +1,3 @@
-// @bun
 // src/exports/sdk-local.ts
 import { nanoid } from "nanoid";
 function createLocalSdk(invoker) {
@@ -89,16 +88,15 @@ var isIterable = (i) => {
   return typeof i === "object" && i != null && Symbol.iterator in i;
 };
 function getCallSiteHash(stepFn) {
-  const originalStack = stepFn.stack;
-  Error.captureStackTrace(stepFn, getCallSiteHash);
-  const stack = stepFn.stack;
-  const stepFnCallSite = stack.split(")")[1];
-  if (originalStack === undefined) {
-    delete stepFn.stack;
-  } else {
-    stepFn.stack = originalStack;
+  const holder = {};
+  Error.captureStackTrace(holder, stepFn);
+  const frames = (holder.stack ?? "").split(`
+`).filter((line) => /^\s*at\s/.test(line));
+  const callSite = frames[0]?.trim();
+  if (!callSite) {
+    throw new Error("Could not derive a cache key from the call site. Pass an explicit key to this step.");
   }
-  return createHash("sha1").update(stepFnCallSite).digest("hex");
+  return createHash("sha1").update(callSite).digest("hex");
 }
 
 // src/internal/serialise.ts
@@ -106,6 +104,7 @@ import {
   StepDelay,
   StepError,
   StepResult,
+  StepStoreWait,
   WorkflowResult
 } from "@yieldstar/core";
 import { isErrorLike, serializeError, deserializeError as deserializeError2 } from "serialize-error";
@@ -134,6 +133,8 @@ function deserializeStepResponse(jsonString) {
       return new StepDelay(stepResponse.resumeIn);
     case "step-result":
       return new StepResult(stepResponse.result);
+    case "store-wait":
+      return new StepStoreWait;
     case "workflow-result":
       return new WorkflowResult(stepResponse.result);
     default:
@@ -143,24 +144,34 @@ function deserializeStepResponse(jsonString) {
 
 // src/internal/step-runner.ts
 import {
+  cloneStoreState,
+  defineStore,
   StepKey,
   StepError as StepError2,
   StepResult as StepResult2,
   StepDelay as StepDelay2,
-  StepCacheCheck
+  StepCacheCheck,
+  StepStoreWait as StepStoreWait2,
+  trackStoreSelector
 } from "@yieldstar/core";
-var stepRunner = { run, delay, poll };
-async function* run(arg1, arg2) {
-  let key = null;
-  let fn;
-  if (typeof arg1 === "string") {
-    key = arg1;
-    fn = arg2;
-  } else {
-    fn = arg1;
+function createStepRunner(params) {
+  const { event, storeClient } = params;
+  function store(definition, params2) {
+    const id = params2?.id ?? event.executionId;
+    const key = `store:${definition.name}:${id}`;
+    return storeStep({
+      key,
+      definition,
+      id,
+      event,
+      storeClient,
+      initial: params2?.initial
+    });
   }
-  if (!key)
-    key = getCallSiteHash(run);
+  return { run, delay, poll, store };
+}
+async function* storeStep(params) {
+  const { key, definition, id, event, storeClient, initial } = params;
   yield new StepKey(key);
   const cached = yield new StepCacheCheck;
   if (cached) {
@@ -168,25 +179,111 @@ async function* run(arg1, arg2) {
     if (cached instanceof StepError2) {
       throw cached.err;
     }
-    return cached.result;
+    return createWorkflowStore({
+      definition,
+      id,
+      event,
+      storeClient
+    });
   }
   try {
-    const result = await fn();
-    yield new StepResult2(result);
-    return result;
+    await storeClient.getOrCreateStore({
+      definition,
+      id,
+      initial
+    });
+    yield new StepResult2({ storeName: definition.name, storeId: id });
+    return createWorkflowStore({
+      definition,
+      id,
+      event,
+      storeClient
+    });
   } catch (err) {
-    if (err instanceof RetryableError) {
-      yield new StepError2(err, {
-        maxAttempts: err.maxAttempts,
-        retryInterval: err.retryInterval
+    yield new StepError2(err);
+    throw err;
+  }
+}
+function createWorkflowStore(params) {
+  const { definition, id, event, storeClient } = params;
+  const key = { storeName: definition.name, storeId: id };
+  return {
+    definition,
+    id,
+    key,
+    get(stepKey) {
+      return durableStep(stepKey ?? getCallSiteHash(this.get), async () => await storeClient.getStore({ definition, id }));
+    },
+    select(stepKey, selector) {
+      return durableStep(stepKey, async () => {
+        const snapshot = await storeClient.getStore({ definition, id });
+        return selector(cloneStoreState(snapshot.state));
+      });
+    },
+    update(stepKey, updater) {
+      return durableStep(stepKey, async () => await storeClient.updateStore({
+        definition,
+        id,
+        updater,
+        stepId: { executionId: event.executionId, stepKey }
+      }));
+    },
+    updateFrom(stepKey, snapshot, updater) {
+      return durableStep(stepKey, async () => await storeClient.updateStoreFrom({
+        definition,
+        id,
+        snapshot,
+        updater,
+        stepId: { executionId: event.executionId, stepKey }
+      }));
+    },
+    deleteFrom(stepKey, snapshot) {
+      return durableStep(stepKey, () => storeClient.deleteStoreFrom({
+        definition,
+        id,
+        snapshot,
+        stepId: { executionId: event.executionId, stepKey }
+      }));
+    },
+    when(arg1, arg2) {
+      const stepKey = typeof arg1 === "string" ? arg1 : getCallSiteHash(this.when);
+      const selector = typeof arg1 === "string" ? arg2 : arg1;
+      return whenStep({
+        definition,
+        id,
+        event,
+        storeClient,
+        stepKey,
+        selector
+      });
+    },
+    take(stepKey, selector, claim) {
+      return takeStep({
+        definition,
+        id,
+        event,
+        storeClient,
+        stepKey,
+        selector,
+        claim
       });
-    } else {
-      yield new StepError2(err);
     }
-    throw err;
+  };
+}
+function run(arg1, arg2) {
+  let key = null;
+  let fn;
+  if (typeof arg1 === "string") {
+    key = arg1;
+    fn = arg2;
+  } else {
+    fn = arg1;
   }
+  if (!key)
+    key = getCallSiteHash(run);
+  return durableStep(key, fn);
 }
-async function* delay(arg1, arg2) {
+function delay(arg1, arg2) {
   let key = null;
   let retryInterval;
   if (typeof arg1 === "string") {
@@ -197,6 +294,9 @@ async function* delay(arg1, arg2) {
   }
   if (!key)
     key = getCallSiteHash(delay);
+  return delayStep(key, retryInterval);
+}
+async function* delayStep(key, retryInterval) {
   yield new StepKey(key);
   const cached = yield new StepCacheCheck;
   if (cached) {
@@ -205,7 +305,7 @@ async function* delay(arg1, arg2) {
     yield new StepDelay2(Date.now() + retryInterval);
   }
 }
-async function* poll(arg1, arg2, arg3) {
+function poll(arg1, arg2, arg3) {
   let key = null;
   let opts;
   let predicate;
@@ -227,7 +327,107 @@ async function* poll(arg1, arg2, arg3) {
       });
     }
   };
-  yield* run(key, task);
+  return run(key, task);
+}
+async function* durableStep(key, fn) {
+  yield new StepKey(key);
+  const cached = yield new StepCacheCheck;
+  if (cached) {
+    yield cached;
+    if (cached instanceof StepError2) {
+      throw cached.err;
+    }
+    return cached.result;
+  }
+  try {
+    const result = await fn();
+    yield new StepResult2(result);
+    return result;
+  } catch (err) {
+    if (err instanceof RetryableError) {
+      yield new StepError2(err, {
+        maxAttempts: err.maxAttempts,
+        retryInterval: err.retryInterval
+      });
+    } else {
+      yield new StepError2(err);
+    }
+    throw err;
+  }
+}
+async function* whenStep(params) {
+  const { definition, id, event, storeClient, stepKey, selector } = params;
+  yield new StepKey(stepKey);
+  const cached = yield new StepCacheCheck;
+  if (cached) {
+    yield cached;
+    if (!(cached instanceof StepResult2)) {
+      throw new Error("Store wait step cache must resolve to a step result");
+    }
+    return cached.result;
+  }
+  const snapshot = await storeClient.getStore({ definition, id });
+  const { result, readPaths } = trackStoreSelector(cloneStoreState(snapshot.state), selector);
+  if (result !== undefined && result !== null && result !== false) {
+    const clonedResult = cloneStoreState(result);
+    yield new StepResult2(clonedResult);
+    return clonedResult;
+  }
+  await storeClient.registerWaiter({
+    workflowId: event.workflowId,
+    executionId: event.executionId,
+    stepKey,
+    event,
+    storeName: definition.name,
+    storeId: id,
+    instanceId: snapshot.instanceId,
+    sinceVersion: snapshot.version,
+    readPaths
+  });
+  yield new StepStoreWait2;
+  throw new Error("Store wait yielded control unexpectedly");
+}
+async function* takeStep(params) {
+  const { definition, id, event, storeClient, stepKey, selector, claim } = params;
+  yield new StepKey(stepKey);
+  const cached = yield new StepCacheCheck;
+  if (cached) {
+    yield cached;
+    if (!(cached instanceof StepResult2)) {
+      throw new Error("Store take step cache must resolve to a step result");
+    }
+    return cached.result;
+  }
+  let outcome;
+  try {
+    outcome = await storeClient.takeFromStore({
+      definition,
+      id,
+      selector,
+      claim,
+      stepId: { executionId: event.executionId, stepKey }
+    });
+  } catch (err) {
+    yield new StepError2(err);
+    throw err;
+  }
+  if (outcome.matched) {
+    yield new StepResult2(outcome.selected);
+    return outcome.selected;
+  }
+  await storeClient.registerWaiter({
+    workflowId: event.workflowId,
+    executionId: event.executionId,
+    stepKey,
+    event,
+    storeName: definition.name,
+    storeId: id,
+    instanceId: outcome.instanceId,
+    sinceVersion: outcome.version,
+    readPaths: outcome.readPaths
+  });
+  yield new StepStoreWait2;
+  throw new Error("Store take yielded control unexpectedly");
 }
 
 // src/exports/workflow.ts
@@ -239,10 +439,12 @@ import {
   StepDelay as StepDelay3,
   StepCacheCheck as StepCacheCheck2,
   StepInvalid,
+  StepStoreWait as StepStoreWait3,
   WorkflowResult as WorkflowResult2
 } from "@yieldstar/core";
 function workflow(workflowFn) {
-  return async function* workflowGenerator({ event, heapClient, logger }) {
+  return async function* workflowGenerator({ event, heapClient, storeClient, logger }) {
+    const stepRunner = createStepRunner({ event, storeClient });
     const workflowIterator = workflowFn(stepRunner, event, logger);
     const { executionId } = event;
     let iteratorResult = null;
@@ -303,12 +505,13 @@ function workflow(workflowFn) {
         stepResponse = new StepInvalid;
       }
       const needsRetry = !cached?.meta.done && stepResponse instanceof StepError3 && stepResponse.maxAttempts > stepAttempt + 1;
+      const needsWake = !cached?.meta.done && stepResponse instanceof StepStoreWait3;
       if (!cached) {
         await heapClient.writeStep({
           executionId,
           stepKey,
           stepAttempt,
-          stepDone: !needsRetry,
+          stepDone: !needsRetry && !needsWake,
           stepResponseJson: serializeStepResponse(stepResponse)
         });
       }
@@ -341,6 +544,7 @@ function workflow(workflowFn) {
 var createWorkflow = workflow;
 export {
   workflow,
+  defineStore,
   createWorkflowRouter,
   createWorkflow,
   createLocalSdk,

package/dist/internal/serialise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialise.d.ts","sourceRoot":"","sources":["../../src/internal/serialise.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,YAAY,EAEb,MAAM,iBAAiB,CAAC;AAGzB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAShE;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAuBxE"}
+{"version":3,"file":"serialise.d.ts","sourceRoot":"","sources":["../../src/internal/serialise.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,YAAY,EAGb,MAAM,iBAAiB,CAAC;AAGzB,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAShE;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAyBxE"}

package/dist/internal/step-runner.d.ts

@@ -1,4 +1,5 @@
-import { StepResponse, StepError, StepResult } from "@yieldstar/core";
+import { defineStore, type Draft, type StandardSchemaV1, StepResponse, StepError, StepResult, type StoreClient, type StoreDefinition, type StoreDeleteFromResult, type StoreKey, type StoreSelector, type StoreSnapshot, type StoreState, type StoreUpdateFromResult, type StoreUpdateResult } from "@yieldstar/core";
+import type { WorkflowEvent } from "@yieldstar/core";
 /**
  * @description A library of step generators, each of which:
  * @yields a StepResponse to workflow consumers
@@ -7,12 +8,33 @@ import { StepResponse, StepError, StepResult } from "@yieldstar/core";
  * @throws any error caught when running the user-defined function,
  * once retries have been exhausted, or if there are no retry semantics
  */
-export declare const stepRunner: {
+export { defineStore };
+export type WorkflowStore<T> = {
+    readonly definition: StoreDefinition<any>;
+    readonly id: string;
+    readonly key: StoreKey;
+    get(key?: string): AsyncGenerator<StepResponse, StoreSnapshot<T>>;
+    select<R>(key: string, selector: StoreSelector<T, R>): AsyncGenerator<StepResponse, R>;
+    update(key: string, updater: (draft: Draft<T>) => void | T): AsyncGenerator<StepResponse, StoreUpdateResult<T>>;
+    updateFrom(key: string, snapshot: StoreSnapshot<T>, updater: (draft: Draft<T>) => void | T): AsyncGenerator<StepResponse, StoreUpdateFromResult<T>>;
+    deleteFrom(key: string, snapshot: StoreSnapshot<T>): AsyncGenerator<StepResponse, StoreDeleteFromResult>;
+    when<R>(selector: StoreSelector<T, R | undefined | null | false>): AsyncGenerator<StepResponse, NonNullable<R>>;
+    when<R>(key: string, selector: StoreSelector<T, R | undefined | null | false>): AsyncGenerator<StepResponse, NonNullable<R>>;
+    take<R>(key: string, selector: StoreSelector<T, R | undefined | null | false>, claim: (draft: Draft<T>, selected: NonNullable<R>) => void): AsyncGenerator<StepResponse, NonNullable<R>>;
+};
+export type StepRunner = ReturnType<typeof createStepRunner>;
+export declare function createStepRunner(params: {
+    event: WorkflowEvent;
+    storeClient: StoreClient;
+}): {
     run: typeof run;
     delay: typeof delay;
     poll: typeof poll;
+    store: <Schema extends StandardSchemaV1>(definition: StoreDefinition<Schema>, params?: {
+        id?: string;
+        initial?: StoreState<Schema> | (() => StoreState<Schema> | Promise<StoreState<Schema>>);
+    }) => AsyncGenerator<StepResponse, WorkflowStore<StoreState<Schema>>>;
 };
-export type StepRunner = typeof stepRunner;
 declare function run<T extends any>(fn: () => T | Promise<T>): AsyncGenerator<StepResponse, T, StepResult | StepError>;
 declare function run<T extends any>(key: string, fn: () => T | Promise<T>): AsyncGenerator<StepResponse, T, StepResult | StepError>;
 declare function delay(retryInterval: number): any;
@@ -24,5 +46,4 @@ type PollOpts = {
 type PollPredicate = () => boolean | Promise<boolean>;
 declare function poll(opts: PollOpts, predicate: PollPredicate): any;
 declare function poll(key: string, opts: PollOpts, predicate: PollPredicate): any;
-export {};
 //# sourceMappingURL=step-runner.d.ts.map

package/dist/internal/step-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step-runner.d.ts","sourceRoot":"","sources":["../../src/internal/step-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAEZ,SAAS,EACT,UAAU,EAGX,MAAM,iBAAiB,CAAC;AAIzB;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;;;;CAAuB,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC;AAE3C,iBAAS,GAAG,CAAC,CAAC,SAAS,GAAG,EACxB,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,cAAc,CAAC,YAAY,EAAE,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;AAE3D,iBAAS,GAAG,CAAC,CAAC,SAAS,GAAG,EACxB,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACvB,cAAc,CAAC,YAAY,EAAE,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;AAiD3D,iBAAS,KAAK,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG,CAAC;AAC3C,iBAAS,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,GAAG,CAAC;AA6BxD,KAAK,QAAQ,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/D,KAAK,aAAa,GAAG,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtD,iBAAS,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,GAAG,GAAG,CAAC;AAC7D,iBAAS,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,GAAG,GAAG,CAAC"}
+{"version":3,"file":"step-runner.d.ts","sourceRoot":"","sources":["../../src/internal/step-runner.ts"],"names":[],"mappings":"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"}

package/dist/internal/utils.d.ts

@@ -1,3 +1,14 @@
 export declare const isIterable: <T>(i: T | Iterable<T>) => i is Iterable<T>;
+/**
+ * Derives a replay-stable cache key from the call site of a keyless step.
+ *
+ * IMPORTANT: `stepFn` must be the synchronously-executing function that the
+ * user called directly (e.g. the `step.run` wrapper) – NOT an async generator
+ * body. Async generator bodies don't run until the first `.next()`, by which
+ * point the user's frame is no longer on the stack. `Error.captureStackTrace`
+ * omits every frame above (and including) `stepFn`, so the first captured
+ * frame is the user's call site (file:line:column), which is deterministic
+ * across executions of the same workflow code.
+ */
 export declare function getCallSiteHash(stepFn: Function): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/internal/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/internal/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAIjE,CAAC;AAGF,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,UAe/C"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/internal/utils.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAIjE,CAAC;AAGF;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAkBxD"}

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "yieldstar",
-  "version": "0.4.6",
+  "version": "0.5.0",
   "license": "MIT",
   "author": "Daniel Grant",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/notationlabs/yieldstar.git",
+    "directory": "packages/yieldstar"
+  },
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,12 +15,12 @@
     "nanoid": "^5.1.5",
     "pino": "^9.9.0",
     "serialize-error": "^11.0.3",
-    "@yieldstar/core": "0.4.6"
+    "@yieldstar/core": "0.5.0"
   },
   "devDependencies": {
     "@types/node": "^22.18.0"
   },
   "scripts": {
-    "build": "bun build src/index.ts --outfile dist/index.js --target bun --packages=external"
+    "build": "bun build src/index.ts --outfile dist/index.js --target node --packages=external"
   }
 }