@lostgradient/weft 0.9.0 → 0.10.0

package/README.md

@@ -1,6 +1,6 @@
 # Weft
 
-A Bun-native durable execution engine. Current release: `0.9.0`.
+A Bun-native durable execution engine. Current release: `0.10.0`.
 
 Install the library from npm as `@lostgradient/weft`:
 
@@ -63,7 +63,7 @@ Weft's durability promise is checkpoint-level and explicit:
 - Every `yield*` boundary is persisted before the workflow advances to the next durable step.
 - `Engine.create()` recovers by default after registering workflow definitions, so fresh processes resume persisted running workflows without a separate boot hook.
 - Recovery resumes from the last checkpoint position instead of replaying the workflow from the beginning.
-- External activity side effects still need idempotency keys, provider lookup, or verifier logic. Without that, a crash after the external side effect but before Weft commits the activity result can dispatch the activity again.
+- External activity side effects still need idempotency keys, provider lookup, verifier logic, or external write fencing. Without that, a crash after the external side effect but before Weft commits the activity result can dispatch the activity again. Weft exposes `workflowExecutionToken` and per-attempt `activityAttemptToken` values so databases you control can reject stale writes from older attempts or replaced runs.
 
 The full [Durability Guarantee](documentation/architecture/durability-guarantee.md) separates what is guaranteed today from the Tier-0 activity-reconciliation work that narrows the remaining crash window.
 
@@ -113,7 +113,7 @@ When a workflow needs a live host capability that cannot be checkpointed, pass i
 const handle = await engine.start('welcome', { name: 'Steve' }, { services: { crmClient } });
 ```
 
-Inside inline workflows, read that value from `ctx.services` and narrow it to your application type. Weft never writes the service object into checkpoints; it persists only a presence marker so `Engine.create({ resolveWorkflowServices })` can rebuild the service value during fresh-process recovery before the generator advances. Do not use `services` for durable data, and do not pass it in Worker execution mode — non-serializable values cannot cross to a Worker.
+Inside inline workflows, read that value from `ctx.services` and narrow it to your application type. Weft never writes the service object into checkpoints; it persists only a presence marker so `Engine.create({ resolveWorkflowServices })` can rebuild the service value during fresh-process recovery before the generator advances. Scheduled runs also carry `schedule.id` and, when the grid timestamp is retained, `schedule.occurrence` into the resolver across recovery, so host services can branch on schedule origin without duplicating that identity in workflow input. Do not use `services` for durable data, and do not pass it in Worker execution mode — non-serializable values cannot cross to a Worker.
 
 > [!NOTE]
 > The chained builder also accepts `.signals({...})`, `.updates({...})`, `.queries({...})`, and `.searchAttributes({...})`. Each can be called at most once before `.execute(fn)`; the type system flips a phantom flag so a duplicate call fails to typecheck, and the runtime mirrors the same invariant. These maps don't introduce new runtime gating — they're type hints that thread into `ctx.run()`, `ctx.waitForSignal()`, `ctx.waitForUpdate()`, and friends so your editor autocompletes and your code typechecks. The underlying dispatch paths are unchanged.

package/dist/alerting/alert-manager.d.ts

@@ -35,7 +35,9 @@ import type { AlertState, AlertingOptions } from './types';
  */
 export declare class AlertManager implements Disposable {
     #private;
-    constructor(target: EventTarget, options: AlertingOptions, getNow?: () => number);
+    constructor(target: EventTarget, options: AlertingOptions, getNow?: () => number, startBackgroundTick?: boolean);
+    /** Re-evaluate every rule once, for hosts that drive maintenance explicitly. */
+    tick(): void;
     /** Get current state of all alert rules (for debugging/testing). */
     get states(): readonly AlertState[];
     [Symbol.dispose](): void;

package/dist/alerting/alert-manager.js

@@ -18,7 +18,7 @@ export class AlertManager {
   #pendingWebhooks;
   #getNow;
   #tickInterval;
-  constructor(target, options, getNow = Date.now) {
+  constructor(target, options, getNow = Date.now, startBackgroundTick = !0) {
     this.#target = target;
     this.#options = options;
     this.#getNow = getNow;
@@ -41,7 +41,10 @@ export class AlertManager {
         this.#windows.set(i, new HistogramWindow(windowMs));
     }
     this.#subscribeToEvents();
-    this.#tickInterval = setInterval(this.#evaluateAll.bind(this), TICK_INTERVAL_MS);
+    this.#tickInterval = startBackgroundTick ? setInterval(this.#evaluateAll.bind(this), TICK_INTERVAL_MS) : null;
+  }
+  tick() {
+    this.#evaluateAll();
   }
   #evaluateAll() {
     for (let i = 0;i < this.#options.rules.length; i++)