@workflow/core 5.0.0-beta.42 → 5.0.0-beta.44

package/dist/runtime/quickjs-entrypoint.d.ts

@@ -1,9 +1,9 @@
 /**
- * QuickJS VM integration with the Workflow DevKit.
+ * QuickJS WebAssembly (WASM) VM integration with the Workflow DevKit.
  *
  * This module provides the entry point for running workflows in the
- * QuickJS WASM VM engine instead of the `node:vm` engine. Both engines
- * implement the same event-replay execution model — every invocation:
+ * QuickJS VM engine instead of the `node:vm` engine. Both engines
+ * implement the same event-replay execution model, where every invocation:
  *
  * 1. Loads the full event log for the run
  * 2. Runs the workflow function from the top in a fresh QuickJS VM,
@@ -16,7 +16,7 @@ import type { Span } from '@opentelemetry/api';
 import { type Event, type RunInput, type WorkflowRun } from '@workflow/world';
 /**
  * Returns true when the supplied preloaded events indicate this is the
- * first workflow handler invocation for the run — i.e. the log contains
+ * first workflow handler invocation for the run, i.e. the log contains
  * nothing beyond `run_created` / `run_started`. In that case the
  * preloaded events ARE the complete event log and the `events.list`
  * round-trips can be skipped entirely.
@@ -38,12 +38,12 @@ export declare function isFirstInvocation(preloadedEvents: readonly Event[] | un
  * This replaces the `node:vm` replay path (runWorkflow + EventsConsumer)
  * with a QuickJS VM invocation that performs the same full event replay.
  *
- * KNOWN GAP — slot snapshot: unlike the node:vm path, no event write in
+ * KNOWN GAP (slot snapshot): unlike the node:vm path, no event write in
  * this file carries {@link CreateEventParams.eventCount}, so a World never
  * learns which events the writer had not seen and never reports them back.
  * The engine currently relies on per-(runId, correlationId) event
  * uniqueness (EntityConflictError dedup) alone. This is a deliberate
- * simplification while the engine is experimental — wiring the snapshot is
+ * simplification while the engine is experimental: wiring the snapshot is
  * tracked follow-up work; anyone adding new write paths here should not
  * assume parity with the node engine on this axis.
  */
@@ -54,8 +54,8 @@ export declare function runWorkflowWithQuickJS(params: {
     /**
      * Events returned inline by `events.create('run_started', ...)` or by
      * the lazy hook fast path's `hook_received` preload. When they indicate
-     * a first invocation — or when `preloadedEventsComplete` attests they
-     * are the complete log — they are used as the event log instead of
+     * a first invocation, or when `preloadedEventsComplete` attests they
+     * are the complete log, they are used as the event log instead of
      * fetching via `events.list`, matching the node:vm engine's fast path.
      */
     preloadedEvents?: Event[];
@@ -101,11 +101,13 @@ export declare function runWorkflowWithQuickJS(params: {
      * the in-flight body instead of requeueing the step.
      */
     ownerMessageId?: string;
+    /** Request ID of the queue invocation, when the queue provides one. */
+    requestId?: string;
     /**
      * Queue namespace resolved at route registration (runtime.ts). Must be
      * threaded into every message publish: the builders bake the namespace
-     * into generated routes, so consumers listen on `__<ns>_wkf_workflow_*`
-     * — a publish without it lands on `__wkf_workflow_*` and is never
+     * into generated routes, so consumers listen on `__<ns>_wkf_workflow_*`.
+     * A publish without it lands on `__wkf_workflow_*` and is never
      * picked up.
      */
     namespace?: string;
@@ -117,6 +119,17 @@ export declare function runWorkflowWithQuickJS(params: {
      * invocations to each other and fragment the run view on async queues.
      */
     nextTraceCarrier?: () => Promise<Record<string, string>>;
+    /**
+     * The wait this invocation is the delayed continuation for, if it is one
+     * (`WorkflowInvokePayload.waitContinuation`). Read only to decide the next
+     * continuation's idempotency key: a continuation that finds its own wait
+     * still pending has spent its key, so the re-arm has to advance the attempt
+     * or the world's dedupe window drops it and the wait loses its only timer.
+     */
+    waitContinuation?: {
+        correlationId: string;
+        attempt: number;
+    };
 }): Promise<{
     timeoutSeconds?: number;
 } | void>;

package/dist/runtime/quickjs-entrypoint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quickjs-entrypoint.d.ts","sourceRoot":"","sources":["../../src/runtime/quickjs-entrypoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAS/C,OAAO,EACL,KAAK,KAAK,EAEV,KAAK,QAAQ,EAGb,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAiDzB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,GAC5C,OAAO,CAOT;AAsjBD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;IAC1B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1D,GAAG,OAAO,CAAC;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAgrC9C"}
+{"version":3,"file":"quickjs-entrypoint.d.ts","sourceRoot":"","sources":["../../src/runtime/quickjs-entrypoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAS/C,OAAO,EACL,KAAK,KAAK,EAEV,KAAK,QAAQ,EAIb,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAoDzB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,eAAe,EAAE,SAAS,KAAK,EAAE,GAAG,SAAS,GAC5C,OAAO,CAOT;AAgqBD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,WAAW,CAAC;IACzB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;IAC1B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D,GAAG,OAAO,CAAC;IAAE,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAsuC9C"}