rivetkit 2.3.12-rc.1 → 2.3.12-rc.3

package/dist/tsup/test/mod.cjs

@@ -1,14 +1,14 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-var _chunkDIHAXOB7cjs = require('../chunk-DIHAXOB7.cjs');
+var _chunkUBB32UOGcjs = require('../chunk-UBB32UOG.cjs');
 
 
-var _chunk6ETWXXAZcjs = require('../chunk-6ETWXXAZ.cjs');
+var _chunkPZBWSCQRcjs = require('../chunk-PZBWSCQR.cjs');
 require('../chunk-MYWZCDML.cjs');
 require('../chunk-KVFIONKQ.cjs');
-require('../chunk-VJ4KLJO5.cjs');
-require('../chunk-T4MKKCRF.cjs');
-require('../chunk-4FC7TVS6.cjs');
+require('../chunk-EQKSWDIH.cjs');
+require('../chunk-4ESGNS3Z.cjs');
+require('../chunk-SPJORZMM.cjs');
 
 // src/test/ready.ts
 var _pretry = require('p-retry'); var _pretry2 = _interopRequireDefault(_pretry);
@@ -36,8 +36,8 @@ async function setupTest(c, registry) {
   registry.config.noWelcome = true;
   registry.start();
   await waitForRegistryReady(registry);
-  const client = _chunkDIHAXOB7cjs.createClient.call(void 0, {
-    ..._chunk6ETWXXAZcjs.convertRegistryConfigToClientConfig.call(void 0, registry.parseConfig()),
+  const client = _chunkUBB32UOGcjs.createClient.call(void 0, {
+    ..._chunkPZBWSCQRcjs.convertRegistryConfigToClientConfig.call(void 0, registry.parseConfig()),
     disableMetadataLookup: false
   });
   c.onTestFinished(async () => {

package/dist/tsup/test/mod.d.cts

@@ -1,5 +1,5 @@
 import { TestContext } from 'vitest';
-import { aF as Registry, a3 as Client } from '../config-DTGoWdkG.cjs';
+import { aF as Registry, a3 as Client } from '../config-BXSV17G7.cjs';
 import 'zod/v4';
 import '../config-ey2I2zz5.cjs';
 import '@rivetkit/rivetkit-wasm';
@@ -8,9 +8,9 @@ import 'pino';
 import '@rivetkit/virtual-websocket';
 import '../inspector/workflow.cjs';
 import '@standard-schema/spec';
-import '../utils-DQDCphrl.cjs';
+import '../utils-Bbz-3411.cjs';
 import 'hono';
-import '../utils-CqDnC_PS.cjs';
+import '../utils-vvJQyygr.cjs';
 import 'hono/utils/http-status';
 
 interface SetupTestResult<A extends Registry<any>> {

package/dist/tsup/test/mod.d.ts

@@ -1,5 +1,5 @@
 import { TestContext } from 'vitest';
-import { aF as Registry, a3 as Client } from '../config-C4OSv0QP.js';
+import { aF as Registry, a3 as Client } from '../config-Bi1r6gI7.js';
 import 'zod/v4';
 import '../config-ey2I2zz5.js';
 import '@rivetkit/rivetkit-wasm';
@@ -8,9 +8,9 @@ import 'pino';
 import '@rivetkit/virtual-websocket';
 import '../inspector/workflow.js';
 import '@standard-schema/spec';
-import '../utils-CV0akuDD.js';
+import '../utils-BqdWVlzm.js';
 import 'hono';
-import '../utils-CqDnC_PS.js';
+import '../utils-vvJQyygr.js';
 import 'hono/utils/http-status';
 
 interface SetupTestResult<A extends Registry<any>> {

package/dist/tsup/test/mod.js

@@ -1,14 +1,14 @@
 import {
   createClient
-} from "../chunk-ZTPFJOBX.js";
+} from "../chunk-NHI5L7C7.js";
 import {
   convertRegistryConfigToClientConfig
-} from "../chunk-A5BZEQOG.js";
+} from "../chunk-YYIDQBBM.js";
 import "../chunk-JI6GZ2C2.js";
 import "../chunk-JTHHCZCZ.js";
-import "../chunk-JHHAMABO.js";
-import "../chunk-HVHDZDM2.js";
-import "../chunk-ZZ3WBRPD.js";
+import "../chunk-XI4MEUUI.js";
+import "../chunk-OLGQYFUW.js";
+import "../chunk-IXBD7BXC.js";
 
 // src/test/ready.ts
 import pRetry from "p-retry";

package/dist/tsup/{utils-DQDCphrl.d.cts → utils-Bbz-3411.d.cts}

@@ -1,5 +1,5 @@
 import { Context, Handler } from 'hono';
-import './utils-CqDnC_PS.cjs';
+import './utils-vvJQyygr.cjs';
 import { z } from 'zod/v4';
 
 declare const EncodingSchema: z.ZodEnum<{

package/dist/tsup/{utils-CV0akuDD.d.ts → utils-BqdWVlzm.d.ts}

@@ -1,5 +1,5 @@
 import { Context, Handler } from 'hono';
-import './utils-CqDnC_PS.js';
+import './utils-vvJQyygr.js';
 import { z } from 'zod/v4';
 
 declare const EncodingSchema: z.ZodEnum<{

package/dist/tsup/{utils-CqDnC_PS.d.cts → utils-vvJQyygr.d.cts}

@@ -11,6 +11,8 @@ interface RivetErrorOptions extends ErrorOptions {
     public?: boolean;
     /** Metadata associated with this error. */
     metadata?: unknown;
+    /** Request identifier used to correlate this error with engine logs. */
+    rayId?: string;
     /** Explicit HTTP status override for router responses. */
     statusCode?: number;
     /** Actor context associated with this error. */
@@ -28,6 +30,7 @@ interface RivetErrorLike {
     code: string;
     message: string;
     metadata?: unknown;
+    rayId?: string;
     public?: boolean;
     statusCode?: number;
     actor?: ActorSpecifier;
@@ -52,6 +55,7 @@ declare class RivetError extends Error {
     __type: "RivetError";
     public: boolean;
     metadata?: unknown;
+    readonly rayId?: string;
     statusCode: number;
     actor?: ActorSpecifier;
     readonly group: string;
@@ -95,6 +99,7 @@ interface DeconstructedError {
     code: string;
     message: string;
     metadata?: unknown;
+    rayId?: string;
     actor?: ActorSpecifier;
 }
 declare function stringifyError(error: unknown): string;

package/dist/tsup/{utils-CqDnC_PS.d.ts → utils-vvJQyygr.d.ts}

@@ -11,6 +11,8 @@ interface RivetErrorOptions extends ErrorOptions {
     public?: boolean;
     /** Metadata associated with this error. */
     metadata?: unknown;
+    /** Request identifier used to correlate this error with engine logs. */
+    rayId?: string;
     /** Explicit HTTP status override for router responses. */
     statusCode?: number;
     /** Actor context associated with this error. */
@@ -28,6 +30,7 @@ interface RivetErrorLike {
     code: string;
     message: string;
     metadata?: unknown;
+    rayId?: string;
     public?: boolean;
     statusCode?: number;
     actor?: ActorSpecifier;
@@ -52,6 +55,7 @@ declare class RivetError extends Error {
     __type: "RivetError";
     public: boolean;
     metadata?: unknown;
+    readonly rayId?: string;
     statusCode: number;
     actor?: ActorSpecifier;
     readonly group: string;
@@ -95,6 +99,7 @@ interface DeconstructedError {
     code: string;
     message: string;
     metadata?: unknown;
+    rayId?: string;
     actor?: ActorSpecifier;
 }
 declare function stringifyError(error: unknown): string;

package/dist/tsup/utils.cjs

@@ -19,8 +19,8 @@
 
 
 
-var _chunkT4MKKCRFcjs = require('./chunk-T4MKKCRF.cjs');
-require('./chunk-4FC7TVS6.cjs');
+var _chunk4ESGNS3Zcjs = require('./chunk-4ESGNS3Z.cjs');
+require('./chunk-SPJORZMM.cjs');
 
 
 
@@ -42,5 +42,5 @@ require('./chunk-4FC7TVS6.cjs');
 
 
 
-exports.EXTRA_ERROR_LOG = _chunkT4MKKCRFcjs.EXTRA_ERROR_LOG; exports.SinglePromiseQueue = _chunkT4MKKCRFcjs.SinglePromiseQueue; exports.VERSION = _chunkT4MKKCRFcjs.VERSION; exports.arrayBuffersEqual = _chunkT4MKKCRFcjs.arrayBuffersEqual; exports.assertUnreachable = _chunkT4MKKCRFcjs.assertUnreachable; exports.bufferToArrayBuffer = _chunkT4MKKCRFcjs.bufferToArrayBuffer; exports.combineUrlPath = _chunkT4MKKCRFcjs.combineUrlPath; exports.dbg = _chunkT4MKKCRFcjs.dbg; exports.detectRuntime = _chunkT4MKKCRFcjs.detectRuntime; exports.getEnvUniversal = _chunkT4MKKCRFcjs.getEnvUniversal; exports.httpUserAgent = _chunkT4MKKCRFcjs.httpUserAgent; exports.interval = _chunkT4MKKCRFcjs.interval; exports.joinSignals = _chunkT4MKKCRFcjs.joinSignals; exports.jsonParseCompat = _chunkT4MKKCRFcjs.jsonParseCompat; exports.jsonStringifyCompat = _chunkT4MKKCRFcjs.jsonStringifyCompat; exports.promiseWithResolvers = _chunkT4MKKCRFcjs.promiseWithResolvers; exports.setLongTimeout = _chunkT4MKKCRFcjs.setLongTimeout; exports.sleep = _chunkT4MKKCRFcjs.sleep; exports.stringifyError = _chunkT4MKKCRFcjs.stringifyError; exports.toUint8Array = _chunkT4MKKCRFcjs.toUint8Array;
+exports.EXTRA_ERROR_LOG = _chunk4ESGNS3Zcjs.EXTRA_ERROR_LOG; exports.SinglePromiseQueue = _chunk4ESGNS3Zcjs.SinglePromiseQueue; exports.VERSION = _chunk4ESGNS3Zcjs.VERSION; exports.arrayBuffersEqual = _chunk4ESGNS3Zcjs.arrayBuffersEqual; exports.assertUnreachable = _chunk4ESGNS3Zcjs.assertUnreachable; exports.bufferToArrayBuffer = _chunk4ESGNS3Zcjs.bufferToArrayBuffer; exports.combineUrlPath = _chunk4ESGNS3Zcjs.combineUrlPath; exports.dbg = _chunk4ESGNS3Zcjs.dbg; exports.detectRuntime = _chunk4ESGNS3Zcjs.detectRuntime; exports.getEnvUniversal = _chunk4ESGNS3Zcjs.getEnvUniversal; exports.httpUserAgent = _chunk4ESGNS3Zcjs.httpUserAgent; exports.interval = _chunk4ESGNS3Zcjs.interval; exports.joinSignals = _chunk4ESGNS3Zcjs.joinSignals; exports.jsonParseCompat = _chunk4ESGNS3Zcjs.jsonParseCompat; exports.jsonStringifyCompat = _chunk4ESGNS3Zcjs.jsonStringifyCompat; exports.promiseWithResolvers = _chunk4ESGNS3Zcjs.promiseWithResolvers; exports.setLongTimeout = _chunk4ESGNS3Zcjs.setLongTimeout; exports.sleep = _chunk4ESGNS3Zcjs.sleep; exports.stringifyError = _chunk4ESGNS3Zcjs.stringifyError; exports.toUint8Array = _chunk4ESGNS3Zcjs.toUint8Array;
 //# sourceMappingURL=utils.cjs.map

package/dist/tsup/utils.d.cts

@@ -1,5 +1,5 @@
 import 'hono';
-export { d as assertUnreachable, s as stringifyError } from './utils-CqDnC_PS.cjs';
-export { D as DeepMutable, a as DeepReadonly, b as EXTRA_ERROR_LOG, G as GetUpgradeWebSocket, L as LongTimeoutHandle, R as Runtime, S as SinglePromiseQueue, U as UpgradeWebSocket, V as VERSION, c as arrayBuffersEqual, d as bufferToArrayBuffer, e as combineUrlPath, f as dbg, g as detectRuntime, h as getEnvUniversal, i as httpUserAgent, j as interval, k as joinSignals, l as jsonParseCompat, m as jsonStringifyCompat, p as promiseWithResolvers, s as setLongTimeout, n as sleep, t as toUint8Array } from './utils-DQDCphrl.cjs';
+export { d as assertUnreachable, s as stringifyError } from './utils-vvJQyygr.cjs';
+export { D as DeepMutable, a as DeepReadonly, b as EXTRA_ERROR_LOG, G as GetUpgradeWebSocket, L as LongTimeoutHandle, R as Runtime, S as SinglePromiseQueue, U as UpgradeWebSocket, V as VERSION, c as arrayBuffersEqual, d as bufferToArrayBuffer, e as combineUrlPath, f as dbg, g as detectRuntime, h as getEnvUniversal, i as httpUserAgent, j as interval, k as joinSignals, l as jsonParseCompat, m as jsonStringifyCompat, p as promiseWithResolvers, s as setLongTimeout, n as sleep, t as toUint8Array } from './utils-Bbz-3411.cjs';
 import 'hono/utils/http-status';
 import 'zod/v4';

package/dist/tsup/utils.d.ts

@@ -1,5 +1,5 @@
 import 'hono';
-export { d as assertUnreachable, s as stringifyError } from './utils-CqDnC_PS.js';
-export { D as DeepMutable, a as DeepReadonly, b as EXTRA_ERROR_LOG, G as GetUpgradeWebSocket, L as LongTimeoutHandle, R as Runtime, S as SinglePromiseQueue, U as UpgradeWebSocket, V as VERSION, c as arrayBuffersEqual, d as bufferToArrayBuffer, e as combineUrlPath, f as dbg, g as detectRuntime, h as getEnvUniversal, i as httpUserAgent, j as interval, k as joinSignals, l as jsonParseCompat, m as jsonStringifyCompat, p as promiseWithResolvers, s as setLongTimeout, n as sleep, t as toUint8Array } from './utils-CV0akuDD.js';
+export { d as assertUnreachable, s as stringifyError } from './utils-vvJQyygr.js';
+export { D as DeepMutable, a as DeepReadonly, b as EXTRA_ERROR_LOG, G as GetUpgradeWebSocket, L as LongTimeoutHandle, R as Runtime, S as SinglePromiseQueue, U as UpgradeWebSocket, V as VERSION, c as arrayBuffersEqual, d as bufferToArrayBuffer, e as combineUrlPath, f as dbg, g as detectRuntime, h as getEnvUniversal, i as httpUserAgent, j as interval, k as joinSignals, l as jsonParseCompat, m as jsonStringifyCompat, p as promiseWithResolvers, s as setLongTimeout, n as sleep, t as toUint8Array } from './utils-BqdWVlzm.js';
 import 'hono/utils/http-status';
 import 'zod/v4';

package/dist/tsup/utils.js

@@ -19,8 +19,8 @@ import {
   sleep,
   stringifyError,
   toUint8Array
-} from "./chunk-HVHDZDM2.js";
-import "./chunk-ZZ3WBRPD.js";
+} from "./chunk-OLGQYFUW.js";
+import "./chunk-IXBD7BXC.js";
 export {
   EXTRA_ERROR_LOG,
   SinglePromiseQueue,

package/dist/tsup/workflow/mod.cjs

@@ -1,8 +1,8 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await rhsFn(); } } var _class; var _class2;
 
-var _chunkBEPAAID2cjs = require('../chunk-BEPAAID2.cjs');
-require('../chunk-BZX4LYYD.cjs');
-require('../chunk-2D5PNV5A.cjs');
+var _chunkOX6WVQE6cjs = require('../chunk-OX6WVQE6.cjs');
+require('../chunk-IJWTHKH6.cjs');
+require('../chunk-QLOBB27M.cjs');
 
 
 
@@ -13,11 +13,11 @@ var _chunk4KGXFC6Mcjs = require('../chunk-4KGXFC6M.cjs');
 var _chunkMYWZCDMLcjs = require('../chunk-MYWZCDML.cjs');
 
 
-var _chunkT4MKKCRFcjs = require('../chunk-T4MKKCRF.cjs');
+var _chunk4ESGNS3Zcjs = require('../chunk-4ESGNS3Z.cjs');
 
 
 
-var _chunk4FC7TVS6cjs = require('../chunk-4FC7TVS6.cjs');
+var _chunkSPJORZMMcjs = require('../chunk-SPJORZMM.cjs');
 
 // src/workflow/mod.ts
 
@@ -705,7 +705,7 @@ function shouldRethrowWorkflowError(error) {
   return true;
 }
 function workflowReplayInFlightError() {
-  return new (0, _chunk4FC7TVS6cjs.RivetError)(
+  return new (0, _chunkSPJORZMMcjs.RivetError)(
     "actor",
     "workflow_in_flight",
     "Workflow replay is unavailable while the workflow is currently in flight.",
@@ -719,7 +719,7 @@ function isWorkflowReplayBlockedByRunningEntry(error) {
   return error instanceof Error && error.message === "Cannot replay a workflow while a step is currently running";
 }
 function isRunHandlerUnavailable(error) {
-  return error instanceof _chunk4FC7TVS6cjs.RivetError && error.group === "actor" && error.code === "run_handler_unavailable";
+  return error instanceof _chunkSPJORZMMcjs.RivetError && error.group === "actor" && error.code === "run_handler_unavailable";
 }
 function workflow(fn, options = {}) {
   const onError = options.onError;
@@ -727,7 +727,7 @@ function workflow(fn, options = {}) {
   function getWorkflowInspector(actorId) {
     let workflowInspector = workflowInspectors.get(actorId);
     if (!workflowInspector) {
-      workflowInspector = _chunkBEPAAID2cjs.createWorkflowInspectorAdapter.call(void 0, );
+      workflowInspector = _chunkOX6WVQE6cjs.createWorkflowInspectorAdapter.call(void 0, );
       workflowInspectors.set(actorId, workflowInspector);
     }
     return workflowInspector;
@@ -794,19 +794,19 @@ function workflow(fn, options = {}) {
     try {
       await handle.result;
     } catch (error) {
-      if (runCtx.abortSignal.aborted || _chunk4FC7TVS6cjs.isActorAbortedError.call(void 0, error)) {
+      if (runCtx.abortSignal.aborted || _chunkSPJORZMMcjs.isActorAbortedError.call(void 0, error)) {
         return;
       }
       if (shouldRethrowWorkflowError(error)) {
         runCtx.log.error({
           msg: "workflow run failed",
-          error: _chunkT4MKKCRFcjs.stringifyError.call(void 0, error)
+          error: _chunk4ESGNS3Zcjs.stringifyError.call(void 0, error)
         });
         throw error;
       }
       runCtx.log.warn({
         msg: "workflow failed and will sleep until woken",
-        error: _chunkT4MKKCRFcjs.stringifyError.call(void 0, error)
+        error: _chunk4ESGNS3Zcjs.stringifyError.call(void 0, error)
       });
     } finally {
       runCtx.abortSignal.removeEventListener("abort", onAbort);

package/dist/tsup/workflow/mod.d.cts

@@ -1,9 +1,9 @@
 import { WorkflowErrorEvent } from '@rivetkit/workflow-engine';
 export { Loop, TryBlockCatchKind, TryBlockConfig, TryBlockFailure, TryBlockResult, TryStepCatchKind, TryStepConfig, TryStepFailure, TryStepResult, WorkflowError, WorkflowErrorEvent } from '@rivetkit/workflow-engine';
-import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-DTGoWdkG.cjs';
+import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-BXSV17G7.cjs';
 import { A as AnyDatabaseProvider } from '../config-ey2I2zz5.cjs';
-import { d as WorkflowContext } from '../context-C6cvDNyk.cjs';
-export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-C6cvDNyk.cjs';
+import { d as WorkflowContext } from '../context-4fJemY0D.cjs';
+export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-4fJemY0D.cjs';
 import 'zod/v4';
 import '@rivetkit/rivetkit-wasm';
 import 'zod';
@@ -11,9 +11,9 @@ import 'pino';
 import '@rivetkit/virtual-websocket';
 import '../inspector/workflow.cjs';
 import '@standard-schema/spec';
-import '../utils-DQDCphrl.cjs';
+import '../utils-Bbz-3411.cjs';
 import 'hono';
-import '../utils-CqDnC_PS.cjs';
+import '../utils-vvJQyygr.cjs';
 import 'hono/utils/http-status';
 
 interface WorkflowOptions<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> {

package/dist/tsup/workflow/mod.d.ts

@@ -1,9 +1,9 @@
 import { WorkflowErrorEvent } from '@rivetkit/workflow-engine';
 export { Loop, TryBlockCatchKind, TryBlockConfig, TryBlockFailure, TryBlockResult, TryStepCatchKind, TryStepConfig, TryStepFailure, TryStepResult, WorkflowError, WorkflowErrorEvent } from '@rivetkit/workflow-engine';
-import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-C4OSv0QP.js';
+import { E as EventSchemaConfig, Q as QueueSchemaConfig, h as RunContext } from '../config-Bi1r6gI7.js';
 import { A as AnyDatabaseProvider } from '../config-ey2I2zz5.js';
-import { d as WorkflowContext } from '../context-CMygeBxS.js';
-export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-CMygeBxS.js';
+import { d as WorkflowContext } from '../context-D4sNYboo.js';
+export { e as WorkflowBranchConfig, W as WorkflowBranchContextOf, a as WorkflowContextOf, f as WorkflowLoopConfig, b as WorkflowLoopContextOf, g as WorkflowStepConfig, h as WorkflowStepContext, c as WorkflowStepContextOf, i as WorkflowTryConfig, j as WorkflowTryStepConfig } from '../context-D4sNYboo.js';
 import 'zod/v4';
 import '@rivetkit/rivetkit-wasm';
 import 'zod';
@@ -11,9 +11,9 @@ import 'pino';
 import '@rivetkit/virtual-websocket';
 import '../inspector/workflow.js';
 import '@standard-schema/spec';
-import '../utils-CV0akuDD.js';
+import '../utils-BqdWVlzm.js';
 import 'hono';
-import '../utils-CqDnC_PS.js';
+import '../utils-vvJQyygr.js';
 import 'hono/utils/http-status';
 
 interface WorkflowOptions<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> {

package/dist/tsup/workflow/mod.js

@@ -1,8 +1,8 @@
 import {
   createWorkflowInspectorAdapter
-} from "../chunk-OZWVDFCA.js";
-import "../chunk-MT33DKU4.js";
-import "../chunk-5UYNV4W6.js";
+} from "../chunk-UN5JNDBT.js";
+import "../chunk-34Q4YVCX.js";
+import "../chunk-WVFTFWJL.js";
 import {
   ACTOR_CONTEXT_INTERNAL_SYMBOL,
   defineRunHandler
@@ -13,11 +13,11 @@ import {
 } from "../chunk-JI6GZ2C2.js";
 import {
   stringifyError
-} from "../chunk-HVHDZDM2.js";
+} from "../chunk-OLGQYFUW.js";
 import {
   RivetError,
   isActorAbortedError
-} from "../chunk-ZZ3WBRPD.js";
+} from "../chunk-IXBD7BXC.js";
 
 // src/workflow/mod.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "rivetkit",
-	"version": "2.3.12-rc.1",
+	"version": "2.3.12-rc.3",
 	"description": "Lightweight libraries for building stateful actors on edge platforms",
 	"license": "Apache-2.0",
 	"keywords": [
@@ -211,14 +211,14 @@
 		"@hono/zod-openapi": "^1.1.5",
 		"@rivet-dev/agent-os-core": "^0.1.1",
 		"@rivetkit/bare-ts": "^0.6.2",
-		"@rivetkit/engine-cli": "2.3.12-rc.1",
-		"@rivetkit/engine-envoy-protocol": "2.3.12-rc.1",
+		"@rivetkit/engine-cli": "2.3.12-rc.3",
+		"@rivetkit/engine-envoy-protocol": "2.3.12-rc.3",
 		"@rivetkit/on-change": "6.0.1",
-		"@rivetkit/rivetkit-napi": "2.3.12-rc.1",
-		"@rivetkit/rivetkit-wasm": "2.3.12-rc.1",
-		"@rivetkit/traces": "2.3.12-rc.1",
-		"@rivetkit/virtual-websocket": "2.3.12-rc.1",
-		"@rivetkit/workflow-engine": "2.3.12-rc.1",
+		"@rivetkit/rivetkit-napi": "2.3.12-rc.3",
+		"@rivetkit/rivetkit-wasm": "2.3.12-rc.3",
+		"@rivetkit/traces": "2.3.12-rc.3",
+		"@rivetkit/virtual-websocket": "2.3.12-rc.3",
+		"@rivetkit/workflow-engine": "2.3.12-rc.3",
 		"cbor-x": "^1.6.0",
 		"drizzle-orm": "^0.44.2",
 		"hono": "^4.7.0",

package/src/actor/errors.ts

@@ -12,6 +12,8 @@ export interface RivetErrorOptions extends ErrorOptions {
 	public?: boolean;
 	/** Metadata associated with this error. */
 	metadata?: unknown;
+	/** Request identifier used to correlate this error with engine logs. */
+	rayId?: string;
 	/** Explicit HTTP status override for router responses. */
 	statusCode?: number;
 	/** Actor context associated with this error. */
@@ -31,6 +33,7 @@ export interface RivetErrorLike {
 	code: string;
 	message: string;
 	metadata?: unknown;
+	rayId?: string;
 	public?: boolean;
 	statusCode?: number;
 	actor?: ActorSpecifier;
@@ -38,6 +41,14 @@ export interface RivetErrorLike {
 
 export interface BridgeRivetErrorPayload extends RivetErrorLike {}
 
+/**
+ * Shape as it arrives from the native bridge, where an absent ray ID serializes
+ * to null. Normalized to a BridgeRivetErrorPayload before validation.
+ */
+interface NativeBridgeErrorPayload extends Omit<BridgeRivetErrorPayload, "rayId"> {
+	rayId?: string | null;
+}
+
 export interface UserErrorOptions extends ErrorOptions {
 	/**
 	 * Machine readable code for this error. Useful for catching different types of
@@ -59,6 +70,7 @@ function looksLikeRivetErrorOptions(
 		value !== null &&
 		("public" in value ||
 			"metadata" in value ||
+			"rayId" in value ||
 			"statusCode" in value ||
 			"actor" in value ||
 			"cause" in value)
@@ -94,6 +106,9 @@ export function isRivetErrorLike(
 		typeof error.code === "string" &&
 		"message" in error &&
 		typeof error.message === "string" &&
+		(!("rayId" in error) ||
+			error.rayId === undefined ||
+			typeof error.rayId === "string") &&
 		(!("__type" in error) || isTypedErrorTag(error.__type))
 	);
 }
@@ -128,6 +143,7 @@ export class RivetError extends Error {
 
 	public public: boolean;
 	public metadata?: unknown;
+	public readonly rayId?: string;
 	public statusCode: number;
 	public actor?: ActorSpecifier;
 	public readonly group: string;
@@ -161,6 +177,7 @@ export class RivetError extends Error {
 		this.code = code;
 		this.public = normalized.public ?? false;
 		this.metadata = normalized.metadata;
+		this.rayId = normalized.rayId ?? undefined;
 		this.statusCode = normalized.statusCode ?? (this.public ? 400 : 500);
 		this.actor = normalized.actor;
 	}
@@ -205,6 +222,7 @@ export function toRivetError(
 			public: error.public,
 			statusCode: error.statusCode,
 			metadata: error.metadata,
+			rayId: error.rayId,
 			actor: error.actor,
 			cause: error instanceof Error ? error.cause : undefined,
 		});
@@ -218,6 +236,7 @@ export function toRivetError(
 			public: fallback?.public,
 			statusCode: fallback?.statusCode,
 			metadata: fallback?.metadata,
+			rayId: fallback?.rayId,
 			actor: fallback?.actor,
 			cause: error instanceof Error ? error : undefined,
 		},
@@ -230,6 +249,7 @@ export function encodeBridgeRivetError(error: RivetErrorLike): string {
 		code: error.code,
 		message: error.message,
 		metadata: error.metadata,
+		rayId: error.rayId,
 		public: error.public,
 		statusCode: error.statusCode,
 		actor: error.actor,
@@ -244,9 +264,14 @@ export function decodeBridgeRivetErrorPayload(
 	}
 
 	try {
-		const payload = JSON.parse(
+		const raw = JSON.parse(
 			value.slice(BRIDGE_RIVET_ERROR_PREFIX.length),
-		) as BridgeRivetErrorPayload;
+		) as NativeBridgeErrorPayload;
+		// Coerce the native bridge's null ray ID to undefined before validation.
+		const payload: BridgeRivetErrorPayload = {
+			...raw,
+			rayId: raw.rayId ?? undefined,
+		};
 		if (!isRivetErrorLike(payload)) {
 			return undefined;
 		}
@@ -272,6 +297,7 @@ export function decodeBridgeRivetError(value: string): RivetError | undefined {
 
 	return new RivetError(payload.group, payload.code, payload.message, {
 		metadata: payload.metadata,
+		rayId: payload.rayId,
 		public: payload.public,
 		statusCode: payload.statusCode,
 		actor: payload.actor ?? undefined,
@@ -303,6 +329,7 @@ export function internalError(
 			public: options?.public,
 			statusCode: options?.statusCode,
 			metadata: options?.metadata,
+			rayId: options?.rayId,
 			actor: options?.actor,
 			cause: options?.cause,
 		},

package/src/client/actor-conn.ts

@@ -874,7 +874,7 @@ export class ActorConnRaw {
 			const parsed = parseWebSocketCloseReason(reason);
 
 			if (parsed) {
-				const { group, code } = parsed;
+				const { group, code, rayId } = parsed;
 
 				if (this.#shouldReconnectForStaleActor(group, code)) {
 					this.#clearResolvedActorIdentity();
@@ -883,7 +883,7 @@ export class ActorConnRaw {
 							group,
 							code,
 							`Connection closed: ${reason}`,
-							undefined,
+							{ rayId },
 						),
 					);
 					return;
@@ -897,6 +897,7 @@ export class ActorConnRaw {
 						this.#actorId,
 						this.#actorResolutionState,
 						this.#driver,
+						rayId,
 					);
 					if (schedulingError) {
 						error = schedulingError;
@@ -905,7 +906,7 @@ export class ActorConnRaw {
 							group,
 							code,
 							`Connection closed: ${reason}`,
-							undefined,
+							{ rayId },
 						);
 					}
 				} else {
@@ -913,7 +914,7 @@ export class ActorConnRaw {
 						group,
 						code,
 						`Connection closed: ${reason}`,
-						undefined,
+						{ rayId },
 					);
 				}