rivetkit 2.3.0-rc.8 → 2.3.0

package/dist/browser/client.js

@@ -1,3 +1,10 @@
+// src/common/log.ts
+import {
+  pino,
+  stdTimeFunctions
+} from "pino";
+import { z } from "zod/v4";
+
 // src/actor/errors.ts
 var INTERNAL_ERROR_CODE = "internal_error";
 var INTERNAL_ERROR_DESCRIPTION = "An internal error occurred";
@@ -75,19 +82,6 @@ function actorNotFound(identifier) {
   );
 }
 
-// src/utils/env-vars.ts
-var getRivetEngine = () => getEnvUniversal("RIVET_ENGINE");
-var getRivetEndpoint = () => getEnvUniversal("RIVET_ENDPOINT");
-var getRivetToken = () => getEnvUniversal("RIVET_TOKEN");
-var getRivetNamespace = () => getEnvUniversal("RIVET_NAMESPACE");
-var getRivetPool = () => getEnvUniversal("RIVET_POOL");
-var getLogLevel = () => getEnvUniversal("RIVET_LOG_LEVEL") ?? getEnvUniversal("LOG_LEVEL");
-var getLogTarget = () => getEnvUniversal("RIVET_LOG_TARGET") === "1";
-var getLogTimestamp = () => getEnvUniversal("RIVET_LOG_TIMESTAMP") === "1";
-var getLogMessage = () => getEnvUniversal("RIVET_LOG_MESSAGE") === "1";
-var getLogErrorStack = () => getEnvUniversal("RIVET_LOG_ERROR_STACK") === "1";
-var getNextPhase = () => getEnvUniversal("NEXT_PHASE");
-
 // src/common/utils.ts
 function assertUnreachable(x) {
   throw new Error(`Unreachable case: ${x}`);
@@ -145,7 +139,7 @@ function deconstructError(error, exposeInternalError = false) {
       actor = error.actor;
     }
     metadata = {
-      //url: `https://hub.rivet.dev/projects/${actorMetadata.project.slug}/environments/${actorMetadata.environment.slug}/actors?actorId=${actorMetadata.actor.id}`,
+      //url: `https://dashboard.rivet.dev/projects/${actorMetadata.project.slug}/environments/${actorMetadata.environment.slug}/actors?actorId=${actorMetadata.actor.id}`,
     };
   }
   return {
@@ -200,7 +194,7 @@ function noopNext() {
 // package.json
 var package_default = {
   name: "rivetkit",
-  version: "2.3.0-rc.8",
+  version: "2.3.0",
   description: "Lightweight libraries for building stateful actors on edge platforms",
   license: "Apache-2.0",
   keywords: [
@@ -272,6 +266,16 @@ var package_default = {
         default: "./dist/tsup/db/drizzle.cjs"
       }
     },
+    "./dynamic": {
+      import: {
+        types: "./dist/tsup/dynamic/mod.d.ts",
+        default: "./dist/tsup/dynamic/mod.js"
+      },
+      require: {
+        types: "./dist/tsup/dynamic/mod.d.cts",
+        default: "./dist/tsup/dynamic/mod.cjs"
+      }
+    },
     "./client": {
       import: {
         browser: {
@@ -316,6 +320,16 @@ var package_default = {
         default: "./dist/tsup/inspector/mod.cjs"
       }
     },
+    "./inspector-tab": {
+      import: {
+        types: "./dist/tsup/inspector-tab/mod.d.ts",
+        default: "./dist/tsup/inspector-tab/mod.js"
+      },
+      require: {
+        types: "./dist/tsup/inspector-tab/mod.d.cts",
+        default: "./dist/tsup/inspector-tab/mod.cjs"
+      }
+    },
     "./inspector/client": {
       import: {
         types: "./dist/browser/inspector/client.d.ts",
@@ -351,7 +365,7 @@ var package_default = {
     "./dist/tsup/chunk-*.cjs"
   ],
   scripts: {
-    build: "tsup src/mod.ts src/client/mod.ts src/common/log.ts src/common/websocket.ts src/actor/errors.ts src/utils.ts src/workflow/mod.ts src/test/mod.ts src/inspector/mod.ts src/db/mod.ts src/db/drizzle.ts && tsup src/agent-os/index.ts --no-clean --out-dir dist/tsup/agent-os",
+    build: "tsup src/mod.ts src/client/mod.ts src/common/log.ts src/common/websocket.ts src/actor/errors.ts src/utils.ts src/workflow/mod.ts src/test/mod.ts src/inspector/mod.ts src/inspector-tab/mod.ts src/db/mod.ts src/db/drizzle.ts src/dynamic/mod.ts && tsup src/agent-os/index.ts --no-clean --out-dir dist/tsup/agent-os",
     "build:browser": "tsup --config tsup.browser.config.ts",
     "check-types": "tsc --noEmit",
     lint: "biome check . && pnpm run check:test-skips && pnpm run check:wait-for-comments",
@@ -427,12 +441,81 @@ var package_default = {
   stableVersion: "0.8.0"
 };
 
+// src/utils.ts
+var VERSION = package_default.version;
+var _userAgent;
+function httpUserAgent() {
+  if (_userAgent !== void 0) {
+    return _userAgent;
+  }
+  let userAgent = `RivetKit/${VERSION}`;
+  const navigatorObj = typeof navigator !== "undefined" ? navigator : void 0;
+  if (navigatorObj?.userAgent) userAgent += ` ${navigatorObj.userAgent}`;
+  _userAgent = userAgent;
+  return userAgent;
+}
+function getEnvUniversal(key) {
+  if (typeof Deno !== "undefined") {
+    return Deno.env.get(key);
+  } else if (typeof process !== "undefined") {
+    return process.env[key];
+  }
+}
+function promiseWithResolvers(onReject) {
+  let resolve;
+  let reject;
+  const promise = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  promise.catch(onReject);
+  return { promise, resolve, reject };
+}
+function bufferToArrayBuffer(buf) {
+  return buf.buffer.slice(
+    buf.byteOffset,
+    buf.byteOffset + buf.byteLength
+  );
+}
+function combineUrlPath(endpoint, path, queryParams) {
+  const baseUrl = new URL(endpoint);
+  const pathParts = path.split("?");
+  const pathOnly = pathParts[0];
+  const existingQuery = pathParts[1] || "";
+  const basePath = baseUrl.pathname.replace(/\/$/, "");
+  const cleanPath = pathOnly.startsWith("/") ? pathOnly : `/${pathOnly}`;
+  const fullPath = (basePath + cleanPath).replace(/\/\//g, "/");
+  const queryParts = [];
+  if (existingQuery) {
+    queryParts.push(existingQuery);
+  }
+  if (queryParams) {
+    for (const [key, value] of Object.entries(queryParams)) {
+      if (value !== void 0) {
+        queryParts.push(
+          `${encodeURIComponent(key)}=${encodeURIComponent(value)}`
+        );
+      }
+    }
+  }
+  const fullQuery = queryParts.length > 0 ? `?${queryParts.join("&")}` : "";
+  return `${baseUrl.protocol}//${baseUrl.host}${fullPath}${fullQuery}`;
+}
+
+// src/utils/env-vars.ts
+var getRivetEngine = () => getEnvUniversal("RIVET_ENGINE");
+var getRivetEndpoint = () => getEnvUniversal("RIVET_ENDPOINT");
+var getRivetToken = () => getEnvUniversal("RIVET_TOKEN");
+var getRivetNamespace = () => getEnvUniversal("RIVET_NAMESPACE");
+var getRivetPool = () => getEnvUniversal("RIVET_POOL");
+var getLogLevel = () => getEnvUniversal("RIVET_LOG_LEVEL") ?? getEnvUniversal("LOG_LEVEL");
+var getLogTarget = () => getEnvUniversal("RIVET_LOG_TARGET") === "1";
+var getLogTimestamp = () => getEnvUniversal("RIVET_LOG_TIMESTAMP") === "1";
+var getLogMessage = () => getEnvUniversal("RIVET_LOG_MESSAGE") === "1";
+var getLogErrorStack = () => getEnvUniversal("RIVET_LOG_ERROR_STACK") === "1";
+var getNextPhase = () => getEnvUniversal("NEXT_PHASE");
+
 // src/common/log.ts
-import {
-  pino,
-  stdTimeFunctions
-} from "pino";
-import { z } from "zod/v4";
 var baseLogger;
 var configuredLogLevel;
 var loggerCache = /* @__PURE__ */ new Map();
@@ -577,74 +660,12 @@ function quoteLogfmtString(value) {
   return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"').replace(/\n/g, "\\n")}"`;
 }
 
-// src/utils.ts
-var VERSION = package_default.version;
-var _userAgent;
-function httpUserAgent() {
-  if (_userAgent !== void 0) {
-    return _userAgent;
-  }
-  let userAgent = `RivetKit/${VERSION}`;
-  const navigatorObj = typeof navigator !== "undefined" ? navigator : void 0;
-  if (navigatorObj?.userAgent) userAgent += ` ${navigatorObj.userAgent}`;
-  _userAgent = userAgent;
-  return userAgent;
-}
-function getEnvUniversal(key) {
-  if (typeof Deno !== "undefined") {
-    return Deno.env.get(key);
-  } else if (typeof process !== "undefined") {
-    return process.env[key];
-  }
-}
-function promiseWithResolvers(onReject) {
-  let resolve;
-  let reject;
-  const promise = new Promise((res, rej) => {
-    resolve = res;
-    reject = rej;
-  });
-  promise.catch(onReject);
-  return { promise, resolve, reject };
-}
-function bufferToArrayBuffer(buf) {
-  return buf.buffer.slice(
-    buf.byteOffset,
-    buf.byteOffset + buf.byteLength
-  );
-}
-function combineUrlPath(endpoint, path, queryParams) {
-  const baseUrl = new URL(endpoint);
-  const pathParts = path.split("?");
-  const pathOnly = pathParts[0];
-  const existingQuery = pathParts[1] || "";
-  const basePath = baseUrl.pathname.replace(/\/$/, "");
-  const cleanPath = pathOnly.startsWith("/") ? pathOnly : `/${pathOnly}`;
-  const fullPath = (basePath + cleanPath).replace(/\/\//g, "/");
-  const queryParts = [];
-  if (existingQuery) {
-    queryParts.push(existingQuery);
-  }
-  if (queryParams) {
-    for (const [key, value] of Object.entries(queryParams)) {
-      if (value !== void 0) {
-        queryParts.push(
-          `${encodeURIComponent(key)}=${encodeURIComponent(value)}`
-        );
-      }
-    }
-  }
-  const fullQuery = queryParts.length > 0 ? `?${queryParts.join("&")}` : "";
-  return `${baseUrl.protocol}//${baseUrl.host}${fullPath}${fullQuery}`;
-}
-
 // src/devtools-loader/log.ts
 function logger() {
   return getLogger("devtools");
 }
 
 // src/devtools-loader/index.ts
-var DEFAULT_DEVTOOLS_URL = (version = VERSION) => `https://releases.rivet.dev/rivet/latest/devtools/mod.js?v=${version}`;
 var scriptId = "rivetkit-devtools-script";
 function injectDevtools(config) {
   if (!window) {
@@ -652,9 +673,10 @@ function injectDevtools(config) {
     return;
   }
   if (!document.getElementById(scriptId)) {
+    const src = `${config.endpoint?.replace(/\/$/, "")}/devtools/mod.js`;
     const script = document.createElement("script");
     script.id = scriptId;
-    script.src = DEFAULT_DEVTOOLS_URL();
+    script.src = src;
     script.async = true;
     document.head.appendChild(script);
   }
@@ -764,7 +786,7 @@ function deserializeActorKey(keyString) {
     }
   }
   if (escaping) {
-    parts.push(currentPart + "\\");
+    parts.push(`${currentPart}\\`);
   } else if (isEmptyStringMarker) {
     parts.push("");
   } else if (currentPart !== "" || parts.length > 0) {
@@ -890,7 +912,7 @@ function encodeJsonCompatValue(input) {
       (value) => encodeJsonCompatValue(value)
     );
     if (encoded.length === 2 && typeof encoded[0] === "string" && encoded[0].startsWith("$")) {
-      return ["$" + encoded[0], encoded[1]];
+      return [`$${encoded[0]}`, encoded[1]];
     }
     return encoded;
   }
@@ -902,9 +924,7 @@ function encodeJsonCompatValue(input) {
     return encoded;
   }
   const typeName = typeof input === "object" && input !== null ? input.constructor?.name ?? typeof input : typeof input;
-  throw new TypeError(
-    `Value of type "${typeName}" is not CBOR serializable`
-  );
+  throw new TypeError(`Value of type "${typeName}" is not CBOR serializable`);
 }
 function reviveJsonCompatValue(input, options = {}) {
   if (typeof input === "bigint") {
@@ -984,19 +1004,13 @@ function jsonStringifyCompat(input) {
       return [JSON_COMPAT_BIGINT, value.toString()];
     }
     if (value instanceof ArrayBuffer) {
-      return [
-        JSON_COMPAT_ARRAY_BUFFER,
-        base64EncodeArrayBuffer(value)
-      ];
+      return [JSON_COMPAT_ARRAY_BUFFER, base64EncodeArrayBuffer(value)];
     }
     if (value instanceof Uint8Array) {
-      return [
-        JSON_COMPAT_UINT8_ARRAY,
-        base64EncodeUint8Array(value)
-      ];
+      return [JSON_COMPAT_UINT8_ARRAY, base64EncodeUint8Array(value)];
     }
     if (Array.isArray(value) && value.length === 2 && typeof value[0] === "string" && value[0].startsWith("$")) {
-      return ["$" + value[0], value[1]];
+      return [`$${value[0]}`, value[1]];
     }
     return value;
   });
@@ -1108,7 +1122,7 @@ async function sendHttpRequestToGateway(runConfig, gatewayUrl, actorRequest, opt
     if (reqBody.byteLength !== 0) {
       bodyToSend = reqBody;
       guardHeaders.delete("transfer-encoding");
-      guardHeaders.set("content-length", String(bodyToSend.byteLength));
+      guardHeaders.delete("content-length");
     }
   }
   const guardRequest = new Request(gatewayUrl, {
@@ -3960,11 +3974,11 @@ async function lookupMetadataCached(config) {
 }
 
 // src/engine-client/ws-proxy.ts
-async function createWebSocketProxy(c, targetUrl, protocols) {
+async function createWebSocketProxy(_c, targetUrl, protocols) {
   const WebSocket2 = await importWebSocket();
   const state = {};
   return {
-    onOpen: async (event, clientWs) => {
+    onOpen: async (_event, clientWs) => {
       logger3().debug({ msg: "client websocket connected", targetUrl });
       if (clientWs.readyState !== 1) {
         logger3().warn({
@@ -4002,23 +4016,25 @@ async function createWebSocketProxy(c, targetUrl, protocols) {
           reject(error);
         });
       });
-      state.targetWs.addEventListener("message", (event2) => {
-        if (typeof event2.data === "string" || event2.data instanceof ArrayBuffer) {
-          clientWs.send(event2.data);
-        } else if (event2.data instanceof Blob) {
-          event2.data.arrayBuffer().then((buffer) => {
+      state.connectPromise.catch(() => {
+      });
+      state.targetWs.addEventListener("message", (event) => {
+        if (typeof event.data === "string" || event.data instanceof ArrayBuffer) {
+          clientWs.send(event.data);
+        } else if (event.data instanceof Blob) {
+          event.data.arrayBuffer().then((buffer) => {
             clientWs.send(buffer);
           });
         }
       });
-      state.targetWs.addEventListener("close", (event2) => {
+      state.targetWs.addEventListener("close", (event) => {
         logger3().debug({
           msg: "target websocket closed",
           targetUrl,
-          code: event2.code,
-          reason: event2.reason
+          code: event.code,
+          reason: event.reason
         });
-        closeWebSocketIfOpen(clientWs, event2.code, event2.reason);
+        closeWebSocketIfOpen(clientWs, event.code, event.reason);
       });
       state.targetWs.addEventListener("error", (error) => {
         logger3().error({
@@ -4061,7 +4077,7 @@ async function createWebSocketProxy(c, targetUrl, protocols) {
         );
       }
     },
-    onClose: (event, clientWs) => {
+    onClose: (event, _clientWs) => {
       logger3().debug({
         msg: "client websocket closed",
         targetUrl,
@@ -4078,7 +4094,7 @@ async function createWebSocketProxy(c, targetUrl, protocols) {
         }
       }
     },
-    onError: (event, clientWs) => {
+    onError: (event, _clientWs) => {
       logger3().error({ msg: "client websocket error", targetUrl, event });
       if (state.targetWs) {
         if (state.targetWs.readyState === WebSocket2.OPEN) {
@@ -4194,7 +4210,9 @@ var RemoteEngineControlClient = class {
       name,
       key: serializeActorKey(key),
       runner_name_selector: this.#config.poolName,
-      input: actorInput ? uint8ArrayToBase64(encodeCborCompat(actorInput)) : void 0,
+      input: actorInput ? uint8ArrayToBase64(
+        encodeCborCompat(actorInput)
+      ) : void 0,
       crash_policy: crashPolicy ?? "sleep"
     });
     logger3().info({
@@ -4585,7 +4603,7 @@ function classifyActorError(error) {
   return void 0;
 }
 function isRetryableGuardGatewayHttpError(code) {
-  return code === "service_unavailable" || code === "actor_stopped_while_waiting" || code === "tunnel_request_aborted" || code === "tunnel_message_timeout" || code === "tunnel_response_closed" || code === "gateway_response_start_timeout";
+  return code === "service_unavailable" || code === "actor_wake_retries_exceeded" || code === "actor_stopped_while_waiting" || code === "tunnel_request_aborted" || code === "tunnel_message_timeout" || code === "tunnel_response_closed" || code === "gateway_response_start_timeout";
 }
 function classifyTransportError(error) {
   if (error.message.includes("database accessed after actor stopped")) {
@@ -4674,10 +4692,7 @@ async function retryOnLifecycleBoundary(run, opts) {
       if (attempt === maxAttempts - 1) {
         break;
       }
-      const delayMs = Math.min(
-        initialDelayMs * 2 ** attempt,
-        maxDelayMs
-      );
+      const delayMs = Math.min(initialDelayMs * 2 ** attempt, maxDelayMs);
       await waitWithSignal(delayMs, opts?.signal);
     }
   }
@@ -4716,7 +4731,9 @@ function createQueueSender(senderOptions) {
       }),
       requestToBare: (value) => ({
         name: value.name ?? name,
-        body: bufferToArrayBuffer(encodeCborCompat(value.body)),
+        body: bufferToArrayBuffer(
+          encodeCborCompat(value.body)
+        ),
         wait: value.wait ?? false,
         timeout: value.timeout !== void 0 ? BigInt(value.timeout) : null
       }),
@@ -4801,6 +4818,9 @@ var ActorConnRaw = class {
     this.#encoding = encoding;
     this.#actorResolutionState = actorResolutionState;
     this.#gatewayOptions = resolveActorGatewayOptions(gatewayOptions);
+    if ("getForId" in actorResolutionState) {
+      this.#actorId = actorResolutionState.getForId.actorId;
+    }
     this.#readyPromise = promiseWithResolvers(
       (reason) => logger2().warn({
         msg: "unhandled ready promise rejection",
@@ -4818,9 +4838,7 @@ var ActorConnRaw = class {
         );
       }
     });
-    this.#keepNodeAliveInterval = setInterval(() => {
-    }, 6e4);
-    this.#keepNodeAliveInterval.unref?.();
+    this.#keepNodeAliveInterval = setInterval(() => 6e4);
   }
   #clearResolvedActorIdentity() {
     this.#actorId = void 0;
@@ -5227,12 +5245,10 @@ var ActorConnRaw = class {
           );
           return;
         }
-        let errorToThrow = new RivetError(
-          group,
-          code,
-          message,
-          { metadata, actor }
-        );
+        let errorToThrow = new RivetError(group, code, message, {
+          metadata,
+          actor
+        });
         if (isSchedulingError(group, code) && this.#actorId) {
           const schedulingError = await checkForSchedulingError(
             group,
@@ -6053,10 +6069,7 @@ var ActorHandleRaw = class {
             }
           }).send(name, body, options);
         } catch (err) {
-          const { group, code, message, metadata, actor } = deconstructError(
-            err,
-            true
-          );
+          const { group, code, message, metadata, actor } = deconstructError(err, true);
           if (this.#shouldRetryQueueDispatchOverload(
             group,
             code,
@@ -6089,7 +6102,10 @@ var ActorHandleRaw = class {
             await this.#waitForRetryWindow();
             continue;
           }
-          const invalidated = this.#invalidateResolvedActorId(group, code);
+          const invalidated = this.#invalidateResolvedActorId(
+            group,
+            code
+          );
           if (invalidated && attempt < maxAttempts - 1) {
             useQueryTarget = code === "starting" || code === "stopping" || code.startsWith("destroyed_");
             if (useQueryTarget) {
@@ -6097,7 +6113,10 @@ var ActorHandleRaw = class {
             }
             continue;
           }
-          throw new RivetError(group, code, message, { metadata, actor });
+          throw new RivetError(group, code, message, {
+            metadata,
+            actor
+          });
         }
       }
       throw new Error("unreachable queue retry state");
@@ -6177,7 +6196,9 @@ var ActorHandleRaw = class {
             args
           }),
           requestToBare: (args) => ({
-            args: bufferToArrayBuffer(encodeCborCompat(args))
+            args: bufferToArrayBuffer(
+              encodeCborCompat(args)
+            )
           }),
           responseFromJson: (json) => json.output,
           responseFromBare: (bare5) => decodeCborCompat(new Uint8Array(bare5.output))
@@ -6187,10 +6208,7 @@ var ActorHandleRaw = class {
         }
         return output;
       } catch (err) {
-        const { group, code, message, metadata, actor } = deconstructError(
-          err,
-          true
-        );
+        const { group, code, message, metadata, actor } = deconstructError(err, true);
         if (await this.#shouldRetrySchedulingError(
           group,
           code,
@@ -6221,11 +6239,16 @@ var ActorHandleRaw = class {
             { metadata, actor }
           );
         }
-        const invalidated = this.#invalidateResolvedActorId(group, code);
+        const invalidated = this.#invalidateResolvedActorId(
+          group,
+          code
+        );
         if (invalidated && attempt < maxAttempts - 1) {
           if (group === "actor" && (code === "starting" || code === "stopping")) {
             useQueryTarget = true;
-            await new Promise((resolve) => setTimeout(resolve, 100));
+            await new Promise(
+              (resolve) => setTimeout(resolve, 100)
+            );
           }
           continue;
         }
@@ -6402,10 +6425,7 @@ var ActorHandleRaw = class {
         }
         return response;
       } catch (err) {
-        const { group, code, message, metadata, actor } = deconstructError(
-          err,
-          true
-        );
+        const { group, code, message, metadata, actor } = deconstructError(err, true);
         if (await this.#shouldRetrySchedulingError(
           group,
           code,
@@ -6428,7 +6448,10 @@ var ActorHandleRaw = class {
           await this.#waitForRetryWindow();
           continue;
         }
-        const invalidated = this.#invalidateResolvedActorId(group, code);
+        const invalidated = this.#invalidateResolvedActorId(
+          group,
+          code
+        );
         if (invalidated && attempt < maxAttempts - 1) {
           useQueryTarget = code === "starting" || code === "stopping" || code.startsWith("destroyed_");
           if (useQueryTarget) {
@@ -6528,8 +6551,9 @@ var ActorHandleRaw = class {
       this.#gatewayOptions,
       options
     );
+    const useQueryTarget = isDynamicActorQuery(this.#actorResolutionState);
     const target = await this.#resolveGatewayRequestTarget(
-      false,
+      useQueryTarget,
       gatewayOptions
     );
     return await rawWebSocket(
@@ -6552,7 +6576,9 @@ var ActorHandleRaw = class {
     if ("directId" in target) {
       return target.directId;
     }
-    throw new Error("dynamic actor resolution did not produce a direct actor id");
+    throw new Error(
+      "dynamic actor resolution did not produce a direct actor id"
+    );
   }
   /**
    * Returns the raw URL for routing traffic to the actor.