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

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

@@ -1,11 +1,11 @@
 /**
- * QuickJS WASM workflow VM.
+ * QuickJS WebAssembly (WASM) workflow VM.
  *
  * An alternative engine for the event-replay execution model: the workflow
  * code runs inside a QuickJS WASM VM (via quickjs-wasi) instead of a
  * `node:vm` context. Every invocation creates a fresh VM, re-executes the
  * workflow function from the top, and replays the recorded event log to
- * resolve awaited primitives — the same replay semantics as the `node:vm`
+ * resolve awaited primitives: the same replay semantics as the `node:vm`
  * engine.
  *
  * The workflow primitives (useStep, sleep, createHook) are implemented as
@@ -14,11 +14,11 @@
  * resolve/reject promises.
  *
  * The VM bootstrap is deliberately split into two phases:
- *   1. Static initialization (`initWorkflowVM`) — run-independent setup:
+ *   1. Static initialization (`initWorkflowVM`): run-independent setup:
  *      VM creation and the workflow primitives. (Serialization lives on
- *      the host — see quickjs-serde.ts — so no serde code is evaluated
+ *      the host (see quickjs-serde.ts) so no serde code is evaluated
  *      in the VM.)
- *   2. Per-run initialization (inline in `runQuickJSWorkflow`) — seeded
+ *   2. Per-run initialization (inline in `runQuickJSWorkflow`): seeded
  *      PRNG/ULID host functions, workflow bundle evaluation, run metadata,
  *      workflow input, and start.
  * Keeping the phases separate is groundwork for VM-memory snapshotting:
@@ -28,17 +28,33 @@
  * module-scope user code observes the seeded `Math.random`, matching the
  * `node:vm` engine's replay determinism.
  */
-import type { Event, RunInput, WorkflowRun, WorldCapabilities } from '@workflow/world';
+import { SerializationError } from '@workflow/errors';
+import { type Event, type RunInput, type WorkflowRun, type WorldCapabilities } from '@workflow/world';
 import { type Snapshot } from 'quickjs-wasi';
 import type { DecryptionKey } from '../serialization/encryption.js';
 export interface PendingStep {
     type: 'step';
     correlationId: string;
     stepId: string;
-    /** Format-prefixed devalue-serialized step input (args + closureVars) */
-    input: Uint8Array;
+    /**
+     * Format-prefixed devalue-serialized step input (args + closureVars).
+     * Absent when {@link serializationError} is set: the input is precisely
+     * what refused to serialize.
+     */
+    input?: Uint8Array;
     /** Whether a step_created event already exists for this step */
     hasCreatedEvent: boolean;
+    /**
+     * Set when host-side serialization of the step's raw input failed while
+     * dumping the VM's pending ops (see `dumpPendingOps`). The failure is
+     * deterministic (replaying re-derives the same unserializable value), so
+     * instead of failing the whole collection the op is surfaced with the
+     * reframed error and no `input`; the entrypoint finalizes the step as
+     * `step_created` (placeholder input) + `step_failed`, mirroring the
+     * node:vm engine's `finalizeUnserializableStep`, so a try/catch around
+     * the step call observes the SerializationError.
+     */
+    serializationError?: SerializationError;
 }
 export interface PendingWait {
     type: 'wait';
@@ -100,7 +116,7 @@ export interface PendingHookDispose {
 }
 export type PendingOperation = PendingStep | PendingWait | PendingHook | PendingAttribute | PendingHookDispose;
 export interface QuickJSRuntimeResult {
-    /** The workflow completed — result is format-prefixed devalue bytes */
+    /** The workflow completed: result is format-prefixed devalue bytes */
     completed?: {
         result: Uint8Array;
         /**
@@ -121,7 +137,7 @@ export interface QuickJSRuntimeResult {
         message: string;
         stack?: string;
         name?: string;
-        /** See completed.drainOperations — same semantics on failure. */
+        /** See completed.drainOperations: same semantics on failure. */
         drainOperations?: PendingOperation[];
         /**
          * Format-prefixed devalue bytes of the original thrown value
@@ -155,8 +171,8 @@ export interface QuickJSRuntimeOptions {
     /**
      * The local port the workflow server is listening on, used to populate
      * `workflowMetadata.url`. Resolved at call time on the host side so the
-     * VM doesn't have to probe the filesystem. Ignored on Vercel — VERCEL_URL
-     * takes precedence there.
+     * VM doesn't have to probe the filesystem. Ignored on Vercel, where
+     * VERCEL_URL takes precedence.
      */
     port?: number;
     /**
@@ -170,7 +186,7 @@ export interface QuickJSRuntimeOptions {
  * Eval filename used when hydrating the baseline VM. The baseline is
  * shared by EVERY workflow in the bundle, so the filename baked into
  * its compiled code (and therefore into snapshot-path stack frames)
- * must be workflow-independent — hydrating under the first caller's
+ * must be workflow-independent: hydrating under the first caller's
  * workflowId would break `remapErrorStack`'s filename matching for
  * every other workflow in the bundle. Remap call sites match this
  * constant IN ADDITION to the run's module specifier (which covers
@@ -185,7 +201,7 @@ type BaselineEntry = {
      * bundle evaluated (see captureSerdeRoot). The box lives in the
      * snapshot's memory image at this offset; every restored VM
      * re-adopts it so serde initialization executes no guest code
-     * after user code has run — capture-before-user-code semantics,
+     * after user code has run: capture-before-user-code semantics,
      * identical to the fresh path.
      */
     serdeRootPtr: number;
@@ -201,7 +217,7 @@ export declare function __peekBaselineEntryForTests(workflowCode: string): Promi
  * A live QuickJS workflow invocation. When the initial `result` is
  * `suspended`, the VM is kept alive so the caller can feed newly recorded
  * events (e.g. terminal events of inline-executed steps) into the SAME VM
- * via `continueWithEvents` — resuming execution exactly where it left off
+ * via `continueWithEvents`, resuming execution exactly where it left off
  * without a fresh-VM re-replay. Terminal results dispose the VM
  * automatically; `dispose()` must be called when abandoning a suspended
  * session (idempotent).

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

@@ -1 +1 @@
-{"version":3,"file":"quickjs-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/quickjs-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"quickjs-runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/quickjs-runtime.ts"],"names":[],"mappings":"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"}