@rivetkit/supabase 2.3.12-rc.2 → 2.3.12-rc.4

package/dist/mod.mjs

@@ -297,6 +297,196 @@ var require_retry2 = __commonJS({
 // src/mod.ts
 import * as wasmBindings from "@rivetkit/rivetkit-wasm";
 
+// ../rivetkit/dist/tsup/chunk-IXBD7BXC.js
+var INTERNAL_ERROR_CODE = "internal_error";
+var INTERNAL_ERROR_DESCRIPTION = "An internal error occurred";
+var USER_ERROR_CODE = "user_error";
+var BRIDGE_RIVET_ERROR_PREFIX = "__RIVET_ERROR_JSON__:";
+function looksLikeRivetErrorOptions(value) {
+  return typeof value === "object" && value !== null && ("public" in value || "metadata" in value || "rayId" in value || "statusCode" in value || "actor" in value || "cause" in value);
+}
+function isTypedErrorTag(value) {
+  return value === "ActorError" || value === "RivetError";
+}
+function errorMessage(error46, fallback = String(error46)) {
+  if (error46 && typeof error46 === "object" && "message" in error46 && typeof error46.message === "string") {
+    return error46.message;
+  }
+  return fallback;
+}
+function isRivetErrorLike(error46) {
+  return typeof error46 === "object" && error46 !== null && "group" in error46 && typeof error46.group === "string" && "code" in error46 && typeof error46.code === "string" && "message" in error46 && typeof error46.message === "string" && (!("rayId" in error46) || error46.rayId === void 0 || typeof error46.rayId === "string") && (!("__type" in error46) || isTypedErrorTag(error46.__type));
+}
+function isActorAbortedError(error46) {
+  return isRivetErrorLike(error46) && error46.group === "actor" && error46.code === "aborted";
+}
+function isActorSpecifier(value) {
+  return typeof value === "object" && value !== null && "actorId" in value && typeof value.actorId === "string" && "generation" in value && typeof value.generation === "number" && (!("key" in value) || value.key === void 0 || typeof value.key === "string");
+}
+var RivetError = class extends Error {
+  __type = "RivetError";
+  public;
+  metadata;
+  rayId;
+  statusCode;
+  actor;
+  group;
+  code;
+  static isRivetError(error46) {
+    return isRivetErrorLike(error46);
+  }
+  static isActorError(error46) {
+    return isRivetErrorLike(error46);
+  }
+  constructor(group, code, message, options) {
+    const normalized = looksLikeRivetErrorOptions(options) ? options : { metadata: options };
+    super(message, { cause: normalized.cause });
+    this.name = "RivetError";
+    this.group = group;
+    this.code = code;
+    this.public = normalized.public ?? false;
+    this.metadata = normalized.metadata;
+    this.rayId = normalized.rayId ?? void 0;
+    this.statusCode = normalized.statusCode ?? (this.public ? 400 : 500);
+    this.actor = normalized.actor;
+  }
+  toString() {
+    return this.message;
+  }
+};
+var UserError = class extends RivetError {
+  constructor(message, options) {
+    super("user", (options == null ? void 0 : options.code) ?? USER_ERROR_CODE, message, {
+      public: true,
+      metadata: options == null ? void 0 : options.metadata,
+      cause: options == null ? void 0 : options.cause
+    });
+  }
+};
+function toRivetError(error46, fallback) {
+  if (typeof error46 === "string") {
+    const bridged = decodeBridgeRivetError(error46);
+    if (bridged) {
+      return bridged;
+    }
+  }
+  if (error46 instanceof Error) {
+    const bridged = decodeBridgeRivetError(error46.message);
+    if (bridged) {
+      return bridged;
+    }
+  }
+  if (isRivetErrorLike(error46)) {
+    return new RivetError(error46.group, error46.code, error46.message, {
+      public: error46.public,
+      statusCode: error46.statusCode,
+      metadata: error46.metadata,
+      rayId: error46.rayId,
+      actor: error46.actor,
+      cause: error46 instanceof Error ? error46.cause : void 0
+    });
+  }
+  return new RivetError(
+    (fallback == null ? void 0 : fallback.group) ?? "actor",
+    (fallback == null ? void 0 : fallback.code) ?? INTERNAL_ERROR_CODE,
+    errorMessage(error46, (fallback == null ? void 0 : fallback.message) ?? "Unknown error"),
+    {
+      public: fallback == null ? void 0 : fallback.public,
+      statusCode: fallback == null ? void 0 : fallback.statusCode,
+      metadata: fallback == null ? void 0 : fallback.metadata,
+      rayId: fallback == null ? void 0 : fallback.rayId,
+      actor: fallback == null ? void 0 : fallback.actor,
+      cause: error46 instanceof Error ? error46 : void 0
+    }
+  );
+}
+function encodeBridgeRivetError(error46) {
+  return `${BRIDGE_RIVET_ERROR_PREFIX}${JSON.stringify({
+    group: error46.group,
+    code: error46.code,
+    message: error46.message,
+    metadata: error46.metadata,
+    rayId: error46.rayId,
+    public: error46.public,
+    statusCode: error46.statusCode,
+    actor: error46.actor
+  })}`;
+}
+function decodeBridgeRivetErrorPayload(value) {
+  if (!value.startsWith(BRIDGE_RIVET_ERROR_PREFIX)) {
+    return void 0;
+  }
+  try {
+    const raw = JSON.parse(
+      value.slice(BRIDGE_RIVET_ERROR_PREFIX.length)
+    );
+    const payload = {
+      ...raw,
+      rayId: raw.rayId ?? void 0
+    };
+    if (!isRivetErrorLike(payload)) {
+      return void 0;
+    }
+    if (payload.actor !== void 0 && payload.actor !== null && !isActorSpecifier(payload.actor)) {
+      return void 0;
+    }
+    return payload;
+  } catch {
+    return void 0;
+  }
+}
+function decodeBridgeRivetError(value) {
+  const payload = decodeBridgeRivetErrorPayload(value);
+  if (!payload) {
+    return void 0;
+  }
+  return new RivetError(payload.group, payload.code, payload.message, {
+    metadata: payload.metadata,
+    rayId: payload.rayId,
+    public: payload.public,
+    statusCode: payload.statusCode,
+    actor: payload.actor ?? void 0
+  });
+}
+function invalidRequest(error46) {
+  return new RivetError(
+    "request",
+    "invalid",
+    `Invalid request: ${errorMessage(error46, String(error46))}`,
+    {
+      public: true,
+      cause: error46 instanceof Error ? error46 : void 0
+    }
+  );
+}
+function actorNotFound(identifier) {
+  return new RivetError(
+    "actor",
+    "not_found",
+    identifier ? `Actor not found: ${identifier} (https://www.rivet.dev/docs/clients/javascript)` : "Actor not found (https://www.rivet.dev/docs/clients/javascript)",
+    { public: true }
+  );
+}
+function forbiddenError() {
+  return new RivetError("auth", "forbidden", "Forbidden", {
+    public: true,
+    statusCode: 403
+  });
+}
+function unsupportedFeature(feature) {
+  return new RivetError(
+    "feature",
+    "unsupported",
+    `Unsupported feature: ${feature}`
+  );
+}
+
+// ../rivetkit/dist/tsup/chunk-64DT44V2.js
+import {
+  pino,
+  stdTimeFunctions
+} from "pino";
+
 // ../../../node_modules/.pnpm/zod@4.1.13/node_modules/zod/v4/classic/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -12967,705 +13157,53 @@ var classic_default = external_exports;
 // ../../../node_modules/.pnpm/zod@4.1.13/node_modules/zod/v4/index.js
 var v4_default = classic_default;
 
-// ../rivetkit/dist/tsup/chunk-6W5VGLFT.js
-function flattenActionHandlers(actions) {
-  const flattened = /* @__PURE__ */ Object.create(null);
-  for (const { name, handler } of collectActionEntries(actions)) {
-    flattened[name] = handler;
+// ../rivetkit/dist/tsup/chunk-64DT44V2.js
+var import_invariant = __toESM(require_invariant(), 1);
+import * as cbor from "cbor-x";
+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 getRivetTotalSlots = () => {
+  const value = getEnvUniversal("RIVET_TOTAL_SLOTS");
+  return value !== void 0 ? parseInt(value, 10) : void 0;
+};
+var getRivetRunEngine = () => getEnvUniversal("RIVET_RUN_ENGINE") === "1";
+var getRivetRunEngineHost = () => getEnvUniversal("RIVET_RUN_ENGINE_HOST");
+var getRivetRunEnginePort = () => {
+  const value = getEnvUniversal("RIVET_RUN_ENGINE_PORT");
+  return value !== void 0 ? parseInt(value, 10) : void 0;
+};
+var getRivetRunEngineVersion = () => getEnvUniversal("RIVET_RUN_ENGINE_VERSION");
+var getRivetEnvoyVersion = () => {
+  const value = getEnvUniversal("RIVET_ENVOY_VERSION");
+  return value !== void 0 ? parseInt(value, 10) : void 0;
+};
+var getRivetPublicEndpoint = () => getEnvUniversal("RIVET_PUBLIC_ENDPOINT");
+var getRivetPublicToken = () => getEnvUniversal("RIVET_PUBLIC_TOKEN");
+var getRivetkitRuntime = () => getEnvUniversal("RIVETKIT_RUNTIME");
+var getRivetkitRuntimeMode = () => {
+  const value = getEnvUniversal("RIVETKIT_RUNTIME_MODE");
+  if (value === void 0) return "envoy";
+  if (value === "envoy" || value === "serverless") return value;
+  throw new Error(
+    `RIVETKIT_RUNTIME_MODE env var must be "envoy" or "serverless"; got "${value}"`
+  );
+};
+var getRivetkitPublicDir = () => {
+  const value = getEnvUniversal("RIVETKIT_PUBLIC_DIR");
+  return value === void 0 || value === "" ? void 0 : value;
+};
+function parsePortEnv(raw) {
+  if (raw === void 0 || raw === "") return void 0;
+  const parsed = Number.parseInt(raw, 10);
+  if (!Number.isFinite(parsed) || parsed < 1 || parsed > 65535 || String(parsed) !== raw.trim()) {
+    throw new Error(
+      `RIVET_PORT env var must be an integer between 1 and 65535; got "${raw}"`
+    );
   }
-  return flattened;
-}
-function flattenActionInputSchemas(actions, schemas) {
-  if (schemas === void 0) return void 0;
-  if (!isRecord(schemas)) {
-    throw new TypeError("actionInputSchemas must be an object");
-  }
-  const flattened = /* @__PURE__ */ Object.create(null);
-  for (const { name, path: path2 } of collectActionEntries(actions)) {
-    const nestedSchema = lookupNestedSchema(schemas, path2);
-    const flatSchema = schemas[name];
-    if (nestedSchema !== void 0 && flatSchema !== void 0 && nestedSchema !== flatSchema) {
-      throw new TypeError(
-        `Action input schema \`${name}\` is defined by both a nested path and a dotted key`
-      );
-    }
-    const schema = nestedSchema ?? flatSchema;
-    if (schema !== void 0) {
-      flattened[name] = schema;
-    }
-  }
-  return flattened;
-}
-function collectActionEntries(actions) {
-  const entries = [];
-  const names = /* @__PURE__ */ new Set();
-  visitActionGroup(actions ?? {}, [], entries, names);
-  return entries;
-}
-function visitActionGroup(value, path2, entries, names) {
-  if (!isRecord(value)) {
-    throw new TypeError(
-      `${formatActionPath(path2)} must be an action handler or group`
-    );
-  }
-  for (const [segment, child] of Object.entries(value)) {
-    const childPath = [...path2, segment];
-    if (typeof child === "function") {
-      const name = childPath.join(".");
-      if (names.has(name)) {
-        throw new TypeError(
-          `Multiple action definitions flatten to \`${name}\``
-        );
-      }
-      names.add(name);
-      entries.push({
-        name,
-        path: childPath,
-        handler: child
-      });
-    } else {
-      visitActionGroup(child, childPath, entries, names);
-    }
-  }
-}
-function lookupNestedSchema(schemas, path2) {
-  let value = schemas;
-  for (const segment of path2) {
-    if (!isRecord(value) || !Object.hasOwn(value, segment)) {
-      return void 0;
-    }
-    value = value[segment];
-  }
-  return value;
-}
-function isRecord(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return false;
-  }
-  const prototype = Object.getPrototypeOf(value);
-  return prototype === Object.prototype || prototype === null;
-}
-function formatActionPath(path2) {
-  return path2.length === 0 ? "actions" : `Action \`${path2.join(".")}\``;
-}
-var DEFAULT_SLEEP_GRACE_PERIOD = 15e3;
-var ACTOR_CONTEXT_INTERNAL_SYMBOL = /* @__PURE__ */ Symbol(
-  "rivetkit.actor_context_internal"
-);
-var RAW_STATE_SYMBOL = /* @__PURE__ */ Symbol("rivetkit.raw_state");
-var CONN_STATE_MANAGER_SYMBOL = /* @__PURE__ */ Symbol("rivetkit.conn_state_manager");
-var zFunction = () => external_exports.custom((val) => typeof val === "function");
-var zActionTree = external_exports.custom((value) => {
-  if (typeof value !== "object" || value === null || Array.isArray(value)) {
-    return false;
-  }
-  const prototype = Object.getPrototypeOf(value);
-  return prototype === Object.prototype || prototype === null;
-}).superRefine((actions, ctx) => {
-  try {
-    flattenActionHandlers(actions);
-  } catch (error46) {
-    ctx.addIssue({
-      code: "custom",
-      message: error46 instanceof Error ? error46.message : "Invalid action definition"
-    });
-  }
-});
-var WorkflowInspectorConfigSchema = external_exports.object({
-  getHistory: zFunction(),
-  getState: zFunction().optional(),
-  onHistoryUpdated: zFunction().optional(),
-  replayFromStep: zFunction().optional()
-});
-var RunInspectorConfigSchema = external_exports.object({
-  workflow: WorkflowInspectorConfigSchema.optional()
-}).optional();
-var BUILTIN_INSPECTOR_TAB_IDS = [
-  "workflow",
-  "database",
-  "state",
-  "queue",
-  "schedules",
-  "connections",
-  "console"
-];
-var BuiltinInspectorTabIdSchema = external_exports.enum(BUILTIN_INSPECTOR_TAB_IDS);
-var CUSTOM_INSPECTOR_TAB_ID_RE = /^[A-Za-z0-9_-]+$/;
-var CustomInspectorTabEntrySchema = external_exports.object({
-  id: external_exports.string().regex(
-    CUSTOM_INSPECTOR_TAB_ID_RE,
-    "inspector.tabs[].id must contain only letters, digits, underscore, or dash"
-  ),
-  label: external_exports.string().min(1),
-  source: external_exports.string().min(1),
-  /**
-   * Optional icon id. The dashboard maps strings to glyphs (see its
-   * icon registry); unknown ids fall back to a generic icon.
-   */
-  icon: external_exports.string().min(1).optional(),
-  hidden: external_exports.literal(false).optional()
-}).strict();
-var HideInspectorTabEntrySchema = external_exports.object({
-  id: BuiltinInspectorTabIdSchema,
-  hidden: external_exports.literal(true)
-}).strict();
-var InspectorTabEntrySchema = external_exports.union([
-  CustomInspectorTabEntrySchema,
-  HideInspectorTabEntrySchema
-]);
-var ActorInspectorConfigSchema = external_exports.object({
-  tabs: external_exports.array(InspectorTabEntrySchema).default(() => [])
-}).strict().refine(
-  (data) => {
-    const ids = data.tabs.map((t) => t.id);
-    return new Set(ids).size === ids.length;
-  },
-  { message: "Duplicate id in inspector.tabs", path: ["tabs"] }
-).refine(
-  (data) => {
-    const builtinSet = new Set(BUILTIN_INSPECTOR_TAB_IDS);
-    return data.tabs.every(
-      (t) => t.hidden === true || !builtinSet.has(t.id)
-    );
-  },
-  {
-    message: "Custom inspector tab id collides with a built-in (use hidden: true to hide a built-in)",
-    path: ["tabs"]
-  }
-);
-var RunConfigSchema = external_exports.object({
-  /** Display name for the actor in the Inspector UI. */
-  name: external_exports.string().optional(),
-  /** Icon for the actor in the Inspector UI. Can be an emoji or FontAwesome icon name. */
-  icon: external_exports.string().optional(),
-  /** The run handler function. */
-  run: zFunction(),
-  /** Inspector integration for long-running run handlers. */
-  inspector: RunInspectorConfigSchema.optional()
-});
-var RUN_FUNCTION_CONFIG_SYMBOL = /* @__PURE__ */ Symbol.for("rivetkit.run_function_config");
-function defineRunHandler(run, options) {
-  if (options.inspectorKind === void 0 !== (options.createInspector === void 0)) {
-    throw new TypeError(
-      "defineRunHandler requires inspectorKind and createInspector together"
-    );
-  }
-  Object.defineProperty(run, RUN_FUNCTION_CONFIG_SYMBOL, {
-    configurable: false,
-    enumerable: false,
-    writable: false,
-    value: {
-      name: options.name,
-      icon: options.icon,
-      inspectorKind: options.inspectorKind,
-      createInspector: options.createInspector
-    }
-  });
-  return run;
-}
-function getRunInspectorKind(run) {
-  var _a2;
-  if (!run || typeof run !== "function") return void 0;
-  return (_a2 = run[RUN_FUNCTION_CONFIG_SYMBOL]) == null ? void 0 : _a2.inspectorKind;
-}
-function createRunInspector(run, context) {
-  var _a2, _b;
-  if (!run || typeof run !== "function") return void 0;
-  return (_b = (_a2 = run[RUN_FUNCTION_CONFIG_SYMBOL]) == null ? void 0 : _a2.createInspector) == null ? void 0 : _b.call(_a2, context);
-}
-var zRunHandler = external_exports.union([zFunction(), RunConfigSchema]).optional();
-function getRunFunction(run) {
-  if (!run) return void 0;
-  if (typeof run === "function") return run;
-  return run.run;
-}
-function getRunMetadata(run) {
-  if (!run) return {};
-  if (typeof run === "function") {
-    const config3 = run[RUN_FUNCTION_CONFIG_SYMBOL];
-    if (!config3) return {};
-    return { name: config3.name, icon: config3.icon };
-  }
-  return { name: run.name, icon: run.icon };
-}
-function getRunInspectorConfig(run, actor2) {
-  if (!run) return void 0;
-  if (typeof run === "function") {
-    const config3 = run[RUN_FUNCTION_CONFIG_SYMBOL];
-    return (config3 == null ? void 0 : config3.inspectorFactory) ? config3.inspectorFactory(actor2) : config3 == null ? void 0 : config3.inspector;
-  }
-  return run.inspector;
-}
-function hasRunInspectorConfig(run) {
-  if (!run) return false;
-  if (typeof run !== "function") return run.inspector !== void 0;
-  const config3 = run[RUN_FUNCTION_CONFIG_SYMBOL];
-  return (config3 == null ? void 0 : config3.inspectorKind) !== void 0 || (config3 == null ? void 0 : config3.createInspector) !== void 0 || (config3 == null ? void 0 : config3.inspector) !== void 0 || (config3 == null ? void 0 : config3.inspectorFactory) !== void 0;
-}
-function disposeRunInspector(run, actorId) {
-  var _a2;
-  if (!run || typeof run !== "function") {
-    return;
-  }
-  const config3 = run[RUN_FUNCTION_CONFIG_SYMBOL];
-  (_a2 = config3 == null ? void 0 : config3.disposeInspector) == null ? void 0 : _a2.call(config3, actorId);
-}
-var GlobalActorOptionsBaseSchema = external_exports.object({
-  /** Display name for the actor in the Inspector UI. */
-  name: external_exports.string().optional(),
-  /** Icon for the actor in the Inspector UI. Can be an emoji or FontAwesome icon name. */
-  icon: external_exports.string().optional(),
-  /** Enables the experimental Actor Runtime Socket for this actor. */
-  enableActorRuntimeSocket: external_exports.boolean().default(false),
-  /**
-   * Can hibernate WebSockets for onWebSocket.
-   *
-   * WebSockets using actions/events are hibernatable by default.
-   *
-   * @experimental
-   **/
-  canHibernateWebSocket: external_exports.union([external_exports.boolean(), zFunction()]).default(false)
-}).strict();
-var GlobalActorOptionsSchema = GlobalActorOptionsBaseSchema.prefault(
-  () => ({})
-);
-var InstanceActorOptionsBaseSchema = external_exports.object({
-  createVarsTimeout: external_exports.number().positive().default(5e3),
-  createConnStateTimeout: external_exports.number().positive().default(5e3),
-  onBeforeConnectTimeout: external_exports.number().positive().default(5e3),
-  onConnectTimeout: external_exports.number().positive().default(5e3),
-  onMigrateTimeout: external_exports.number().positive().default(3e4),
-  sleepGracePeriod: external_exports.number().positive().default(DEFAULT_SLEEP_GRACE_PERIOD),
-  /** @deprecated `onDestroyTimeout` is folded into `sleepGracePeriod`, which now bounds the entire graceful shutdown window for both sleep and destroy. Will be removed in 2.2.0. */
-  onDestroyTimeout: external_exports.number().positive().optional(),
-  /** @deprecated `waitUntilTimeout` is folded into `sleepGracePeriod`, which now bounds the entire graceful shutdown window for both sleep and destroy. Will be removed in 2.2.0. */
-  waitUntilTimeout: external_exports.number().positive().optional(),
-  stateSaveInterval: external_exports.number().positive().default(1e3),
-  actionTimeout: external_exports.number().positive().default(6e4),
-  connectionLivenessTimeout: external_exports.number().positive().default(2500),
-  connectionLivenessInterval: external_exports.number().positive().default(5e3),
-  /** @deprecated Use `c.keepAwake(promise)` to scope keep-awake to a specific operation, or keep `noSleep` for actors that must stay awake indefinitely. Will be removed in 2.2.0. */
-  noSleep: external_exports.boolean().default(false),
-  sleepTimeout: external_exports.number().positive().default(3e4),
-  maxQueueSize: external_exports.number().positive().default(1e3),
-  /** Maximum pending one-shot and recurring schedules. */
-  maxSchedules: external_exports.number().int().nonnegative().default(1e3),
-  maxQueueMessageSize: external_exports.number().positive().default(64 * 1024),
-  /** @deprecated Internal storage moved to SQLite and no longer uses KV preloading, so this option is ignored. Will be removed in 2.2.0. */
-  preloadMaxWorkflowBytes: external_exports.number().nonnegative().optional(),
-  /** @deprecated Internal storage moved to SQLite and no longer uses KV preloading, so this option is ignored. Will be removed in 2.2.0. */
-  preloadMaxConnectionsBytes: external_exports.number().nonnegative().optional()
-}).strict();
-var InstanceActorOptionsSchema = InstanceActorOptionsBaseSchema.prefault(() => ({}));
-var ActorOptionsSchema = GlobalActorOptionsBaseSchema.extend(
-  InstanceActorOptionsBaseSchema.shape
-).strict().prefault(() => ({}));
-var ActorConfigSchema = external_exports.object({
-  onCreate: zFunction().optional(),
-  onDestroy: zFunction().optional(),
-  onMigrate: zFunction().optional(),
-  onWake: zFunction().optional(),
-  onSleep: zFunction().optional(),
-  run: zRunHandler,
-  onStateChange: zFunction().optional(),
-  onBeforeConnect: zFunction().optional(),
-  onConnect: zFunction().optional(),
-  onDisconnect: zFunction().optional(),
-  onBeforeActionResponse: zFunction().optional(),
-  onRequest: zFunction().optional(),
-  onWebSocket: zFunction().optional(),
-  actions: zActionTree.default(() => ({})),
-  actionInputSchemas: external_exports.record(external_exports.string(), external_exports.any()).optional(),
-  connParamsSchema: external_exports.any().optional(),
-  events: external_exports.record(external_exports.string(), external_exports.any()).optional(),
-  queues: external_exports.record(external_exports.string(), external_exports.any()).optional(),
-  state: external_exports.any().optional(),
-  createState: zFunction().optional(),
-  connState: external_exports.any().optional(),
-  createConnState: zFunction().optional(),
-  vars: external_exports.any().optional(),
-  db: external_exports.any().optional(),
-  createVars: zFunction().optional(),
-  options: ActorOptionsSchema,
-  inspector: ActorInspectorConfigSchema.optional()
-}).strict().refine(
-  (data) => !(data.state !== void 0 && data.createState !== void 0),
-  {
-    message: "Cannot define both 'state' and 'createState'",
-    path: ["state"]
-  }
-).refine(
-  (data) => !(data.connState !== void 0 && data.createConnState !== void 0),
-  {
-    message: "Cannot define both 'connState' and 'createConnState'",
-    path: ["connState"]
-  }
-).refine(
-  (data) => !(data.vars !== void 0 && data.createVars !== void 0),
-  {
-    message: "Cannot define both 'vars' and 'createVars'",
-    path: ["vars"]
-  }
-);
-var DocActorOptionsSchema = external_exports.object({
-  name: external_exports.string().optional().describe("Display name for the actor in the Inspector UI."),
-  icon: external_exports.string().optional().describe(
-    "Icon for the actor in the Inspector UI. Can be an emoji (e.g., '\u{1F680}') or FontAwesome icon name (e.g., 'rocket')."
-  ),
-  enableActorRuntimeSocket: external_exports.boolean().optional().describe(
-    "Enables the experimental Actor Runtime Socket for this actor. Default: false"
-  ),
-  createVarsTimeout: external_exports.number().optional().describe("Timeout in ms for createVars handler. Default: 5000"),
-  createConnStateTimeout: external_exports.number().optional().describe(
-    "Timeout in ms for createConnState handler. Default: 5000"
-  ),
-  onMigrateTimeout: external_exports.number().optional().describe("Timeout in ms for onMigrate handler. Default: 30000"),
-  onBeforeConnectTimeout: external_exports.number().optional().describe(
-    "Timeout in ms for onBeforeConnect handler. Default: 5000"
-  ),
-  onConnectTimeout: external_exports.number().optional().describe("Timeout in ms for onConnect handler. Default: 5000"),
-  sleepGracePeriod: external_exports.number().optional().describe(
-    `Max time in ms for the graceful shutdown window. Covers lifecycle hooks (onSleep, onDestroy), the run handler wait, async raw WebSocket handlers, disconnect callbacks, and final state serialization. Default: ${DEFAULT_SLEEP_GRACE_PERIOD}.`
-  ),
-  onDestroyTimeout: external_exports.number().optional().describe(
-    "Deprecated. Folded into sleepGracePeriod, which now bounds the entire graceful shutdown window for both sleep and destroy. Will be removed in 2.2.0."
-  ),
-  waitUntilTimeout: external_exports.number().optional().describe(
-    "Deprecated. Folded into sleepGracePeriod, which now bounds the entire graceful shutdown window for both sleep and destroy. Will be removed in 2.2.0."
-  ),
-  stateSaveInterval: external_exports.number().optional().describe(
-    "Interval in ms between automatic state saves. Default: 1000"
-  ),
-  actionTimeout: external_exports.number().optional().describe("Timeout in ms for action handlers. Default: 60000"),
-  connectionLivenessTimeout: external_exports.number().optional().describe(
-    "Timeout in ms for connection liveness checks. Default: 2500"
-  ),
-  connectionLivenessInterval: external_exports.number().optional().describe(
-    "Interval in ms between connection liveness checks. Default: 5000"
-  ),
-  noSleep: external_exports.boolean().optional().describe(
-    "Deprecated. If true, the actor will never sleep. Use c.keepAwake(promise) to scope keep-awake to a specific operation instead. Default: false"
-  ),
-  sleepTimeout: external_exports.number().optional().describe(
-    "Time in ms of inactivity before the actor sleeps. Default: 30000"
-  ),
-  maxQueueSize: external_exports.number().optional().describe(
-    "Maximum number of queue messages before rejecting new messages. Default: 1000"
-  ),
-  maxSchedules: external_exports.number().int().nonnegative().optional().describe(
-    "Maximum pending one-shot and recurring schedules before rejecting new schedules. Default: 1000"
-  ),
-  maxQueueMessageSize: external_exports.number().optional().describe(
-    "Maximum size of each queue message in bytes. Default: 65536"
-  ),
-  canHibernateWebSocket: external_exports.boolean().optional().describe(
-    "Whether WebSockets using onWebSocket can be hibernated. WebSockets using actions/events are hibernatable by default. Default: false"
-  )
-}).describe("Actor options for timeouts and behavior configuration.");
-var DocActorConfigSchema = external_exports.object({
-  state: external_exports.unknown().optional().describe(
-    "Initial state value for the actor. Cannot be used with createState."
-  ),
-  createState: external_exports.unknown().optional().describe(
-    "Function to create initial state. Receives context and input. Cannot be used with state."
-  ),
-  connState: external_exports.unknown().optional().describe(
-    "Initial connection state value. Cannot be used with createConnState."
-  ),
-  createConnState: external_exports.unknown().optional().describe(
-    "Function to create connection state. Receives context and connection params. The pending connection is not visible in c.conns until this succeeds. Cannot be used with connState."
-  ),
-  vars: external_exports.unknown().optional().describe(
-    "Initial ephemeral variables value. Cannot be used with createVars."
-  ),
-  createVars: external_exports.unknown().optional().describe(
-    "Function to create ephemeral variables. Receives context and driver context. Cannot be used with vars."
-  ),
-  db: external_exports.unknown().optional().describe("Database provider instance for the actor."),
-  onCreate: external_exports.unknown().optional().describe(
-    "Called when the actor is first initialized. Use to initialize state."
-  ),
-  onDestroy: external_exports.unknown().optional().describe("Called when the actor is destroyed."),
-  onMigrate: external_exports.unknown().optional().describe(
-    "Called on every actor start after persisted state loads and before onWake. Use for repeatable schema migrations."
-  ),
-  onWake: external_exports.unknown().optional().describe(
-    "Called when the actor wakes up and is ready to receive connections and actions."
-  ),
-  onSleep: external_exports.unknown().optional().describe(
-    "Called when the actor is stopping or sleeping. Use to clean up resources."
-  ),
-  run: external_exports.unknown().optional().describe(
-    "Called after actor starts. Does not block startup. Use for background tasks like queue processing or tick loops. If it exits, the actor follows the normal idle sleep timeout once idle. If it throws, the actor logs the error and then follows the normal idle sleep timeout once idle."
-  ),
-  onStateChange: external_exports.unknown().optional().describe(
-    "Called when the actor's state changes. State changes within this hook won't trigger recursion."
-  ),
-  onBeforeConnect: external_exports.unknown().optional().describe(
-    "Called before a client connects. Throw an error to reject the connection. The pending connection is not visible in c.conns while this runs."
-  ),
-  onConnect: external_exports.unknown().optional().describe(
-    "Called when a client successfully connects. The connection is visible in c.conns before this runs."
-  ),
-  onDisconnect: external_exports.unknown().optional().describe("Called when a client disconnects."),
-  onBeforeActionResponse: external_exports.unknown().optional().describe(
-    "Called before sending an action response. Use to transform output."
-  ),
-  onRequest: external_exports.unknown().optional().describe(
-    "Called for raw HTTP requests to /actors/{name}/http/* endpoints."
-  ),
-  onWebSocket: external_exports.unknown().optional().describe(
-    "Called for raw WebSocket connections to /actors/{name}/websocket/* endpoints."
-  ),
-  actions: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe(
-    "Tree of action names or nested groups to handler functions. Nested paths use dot-separated low-level action names. Defaults to an empty object."
-  ),
-  actionInputSchemas: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe(
-    "Optional schemas for validating action argument tuples in native runtimes. May mirror nested action groups or use dot-separated low-level action names."
-  ),
-  connParamsSchema: external_exports.unknown().optional().describe(
-    "Optional schema for validating connection params in native runtimes."
-  ),
-  events: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe("Map of event names to schemas."),
-  queues: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe("Map of queue names to schemas."),
-  options: DocActorOptionsSchema.optional()
-}).describe("Actor configuration passed to the actor() function.");
-
-// ../rivetkit/dist/tsup/chunk-IXBD7BXC.js
-var INTERNAL_ERROR_CODE = "internal_error";
-var INTERNAL_ERROR_DESCRIPTION = "An internal error occurred";
-var USER_ERROR_CODE = "user_error";
-var BRIDGE_RIVET_ERROR_PREFIX = "__RIVET_ERROR_JSON__:";
-function looksLikeRivetErrorOptions(value) {
-  return typeof value === "object" && value !== null && ("public" in value || "metadata" in value || "rayId" in value || "statusCode" in value || "actor" in value || "cause" in value);
-}
-function isTypedErrorTag(value) {
-  return value === "ActorError" || value === "RivetError";
-}
-function errorMessage(error46, fallback = String(error46)) {
-  if (error46 && typeof error46 === "object" && "message" in error46 && typeof error46.message === "string") {
-    return error46.message;
-  }
-  return fallback;
-}
-function isRivetErrorLike(error46) {
-  return typeof error46 === "object" && error46 !== null && "group" in error46 && typeof error46.group === "string" && "code" in error46 && typeof error46.code === "string" && "message" in error46 && typeof error46.message === "string" && (!("rayId" in error46) || error46.rayId === void 0 || typeof error46.rayId === "string") && (!("__type" in error46) || isTypedErrorTag(error46.__type));
-}
-function isActorAbortedError(error46) {
-  return isRivetErrorLike(error46) && error46.group === "actor" && error46.code === "aborted";
-}
-function isActorSpecifier(value) {
-  return typeof value === "object" && value !== null && "actorId" in value && typeof value.actorId === "string" && "generation" in value && typeof value.generation === "number" && (!("key" in value) || value.key === void 0 || typeof value.key === "string");
-}
-var RivetError = class extends Error {
-  __type = "RivetError";
-  public;
-  metadata;
-  rayId;
-  statusCode;
-  actor;
-  group;
-  code;
-  static isRivetError(error46) {
-    return isRivetErrorLike(error46);
-  }
-  static isActorError(error46) {
-    return isRivetErrorLike(error46);
-  }
-  constructor(group, code, message, options) {
-    const normalized = looksLikeRivetErrorOptions(options) ? options : { metadata: options };
-    super(message, { cause: normalized.cause });
-    this.name = "RivetError";
-    this.group = group;
-    this.code = code;
-    this.public = normalized.public ?? false;
-    this.metadata = normalized.metadata;
-    this.rayId = normalized.rayId ?? void 0;
-    this.statusCode = normalized.statusCode ?? (this.public ? 400 : 500);
-    this.actor = normalized.actor;
-  }
-  toString() {
-    return this.message;
-  }
-};
-var UserError = class extends RivetError {
-  constructor(message, options) {
-    super("user", (options == null ? void 0 : options.code) ?? USER_ERROR_CODE, message, {
-      public: true,
-      metadata: options == null ? void 0 : options.metadata,
-      cause: options == null ? void 0 : options.cause
-    });
-  }
-};
-function toRivetError(error46, fallback) {
-  if (typeof error46 === "string") {
-    const bridged = decodeBridgeRivetError(error46);
-    if (bridged) {
-      return bridged;
-    }
-  }
-  if (error46 instanceof Error) {
-    const bridged = decodeBridgeRivetError(error46.message);
-    if (bridged) {
-      return bridged;
-    }
-  }
-  if (isRivetErrorLike(error46)) {
-    return new RivetError(error46.group, error46.code, error46.message, {
-      public: error46.public,
-      statusCode: error46.statusCode,
-      metadata: error46.metadata,
-      rayId: error46.rayId,
-      actor: error46.actor,
-      cause: error46 instanceof Error ? error46.cause : void 0
-    });
-  }
-  return new RivetError(
-    (fallback == null ? void 0 : fallback.group) ?? "actor",
-    (fallback == null ? void 0 : fallback.code) ?? INTERNAL_ERROR_CODE,
-    errorMessage(error46, (fallback == null ? void 0 : fallback.message) ?? "Unknown error"),
-    {
-      public: fallback == null ? void 0 : fallback.public,
-      statusCode: fallback == null ? void 0 : fallback.statusCode,
-      metadata: fallback == null ? void 0 : fallback.metadata,
-      rayId: fallback == null ? void 0 : fallback.rayId,
-      actor: fallback == null ? void 0 : fallback.actor,
-      cause: error46 instanceof Error ? error46 : void 0
-    }
-  );
-}
-function encodeBridgeRivetError(error46) {
-  return `${BRIDGE_RIVET_ERROR_PREFIX}${JSON.stringify({
-    group: error46.group,
-    code: error46.code,
-    message: error46.message,
-    metadata: error46.metadata,
-    rayId: error46.rayId,
-    public: error46.public,
-    statusCode: error46.statusCode,
-    actor: error46.actor
-  })}`;
-}
-function decodeBridgeRivetErrorPayload(value) {
-  if (!value.startsWith(BRIDGE_RIVET_ERROR_PREFIX)) {
-    return void 0;
-  }
-  try {
-    const raw = JSON.parse(
-      value.slice(BRIDGE_RIVET_ERROR_PREFIX.length)
-    );
-    const payload = {
-      ...raw,
-      rayId: raw.rayId ?? void 0
-    };
-    if (!isRivetErrorLike(payload)) {
-      return void 0;
-    }
-    if (payload.actor !== void 0 && payload.actor !== null && !isActorSpecifier(payload.actor)) {
-      return void 0;
-    }
-    return payload;
-  } catch {
-    return void 0;
-  }
-}
-function decodeBridgeRivetError(value) {
-  const payload = decodeBridgeRivetErrorPayload(value);
-  if (!payload) {
-    return void 0;
-  }
-  return new RivetError(payload.group, payload.code, payload.message, {
-    metadata: payload.metadata,
-    rayId: payload.rayId,
-    public: payload.public,
-    statusCode: payload.statusCode,
-    actor: payload.actor ?? void 0
-  });
-}
-function invalidRequest(error46) {
-  return new RivetError(
-    "request",
-    "invalid",
-    `Invalid request: ${errorMessage(error46, String(error46))}`,
-    {
-      public: true,
-      cause: error46 instanceof Error ? error46 : void 0
-    }
-  );
-}
-function actorNotFound(identifier) {
-  return new RivetError(
-    "actor",
-    "not_found",
-    identifier ? `Actor not found: ${identifier} (https://www.rivet.dev/docs/clients/javascript)` : "Actor not found (https://www.rivet.dev/docs/clients/javascript)",
-    { public: true }
-  );
-}
-function forbiddenError() {
-  return new RivetError("auth", "forbidden", "Forbidden", {
-    public: true,
-    statusCode: 403
-  });
-}
-function unsupportedFeature(feature) {
-  return new RivetError(
-    "feature",
-    "unsupported",
-    `Unsupported feature: ${feature}`
-  );
-}
-
-// ../rivetkit/dist/tsup/chunk-YW75TS76.js
-import {
-  pino,
-  stdTimeFunctions
-} from "pino";
-var import_invariant = __toESM(require_invariant(), 1);
-import * as cbor from "cbor-x";
-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 getRivetTotalSlots = () => {
-  const value = getEnvUniversal("RIVET_TOTAL_SLOTS");
-  return value !== void 0 ? parseInt(value, 10) : void 0;
-};
-var getRivetRunEngine = () => getEnvUniversal("RIVET_RUN_ENGINE") === "1";
-var getRivetRunEngineHost = () => getEnvUniversal("RIVET_RUN_ENGINE_HOST");
-var getRivetRunEnginePort = () => {
-  const value = getEnvUniversal("RIVET_RUN_ENGINE_PORT");
-  return value !== void 0 ? parseInt(value, 10) : void 0;
-};
-var getRivetRunEngineVersion = () => getEnvUniversal("RIVET_RUN_ENGINE_VERSION");
-var getRivetEnvoyVersion = () => {
-  const value = getEnvUniversal("RIVET_ENVOY_VERSION");
-  return value !== void 0 ? parseInt(value, 10) : void 0;
-};
-var getRivetPublicEndpoint = () => getEnvUniversal("RIVET_PUBLIC_ENDPOINT");
-var getRivetPublicToken = () => getEnvUniversal("RIVET_PUBLIC_TOKEN");
-var getRivetkitRuntime = () => getEnvUniversal("RIVETKIT_RUNTIME");
-var getRivetkitRuntimeMode = () => {
-  const value = getEnvUniversal("RIVETKIT_RUNTIME_MODE");
-  if (value === void 0) return "envoy";
-  if (value === "envoy" || value === "serverless") return value;
-  throw new Error(
-    `RIVETKIT_RUNTIME_MODE env var must be "envoy" or "serverless"; got "${value}"`
-  );
-};
-var getRivetkitPublicDir = () => {
-  const value = getEnvUniversal("RIVETKIT_PUBLIC_DIR");
-  return value === void 0 || value === "" ? void 0 : value;
-};
-function parsePortEnv(raw) {
-  if (raw === void 0 || raw === "") return void 0;
-  const parsed = Number.parseInt(raw, 10);
-  if (!Number.isFinite(parsed) || parsed < 1 || parsed > 65535 || String(parsed) !== raw.trim()) {
-    throw new Error(
-      `RIVET_PORT env var must be an integer between 1 and 65535; got "${raw}"`
-    );
-  }
-  return parsed;
+  return parsed;
 }
 var getLogLevel = () => getEnvUniversal("RIVET_LOG_LEVEL") ?? getEnvUniversal("LOG_LEVEL");
 var getLogTarget = () => getEnvUniversal("RIVET_LOG_TARGET") === "1";
@@ -13789,7 +13327,7 @@ function noopNext() {
 }
 var package_default = {
   name: "rivetkit",
-  version: "2.3.12-rc.2",
+  version: "2.3.12-rc.4",
   description: "Lightweight libraries for building stateful actors on edge platforms",
   license: "Apache-2.0",
   keywords: [
@@ -15092,7 +14630,7 @@ function Config({ initialBufferLength = 1024, maxBufferLength = 1024 * 1024 * 32
   };
 }
 
-// ../rivetkit/dist/tsup/chunk-KPZQI3TG.js
+// ../rivetkit/dist/tsup/chunk-BQ7YJ3PG.js
 var config2 = /* @__PURE__ */ Config({});
 function readWorkflowCbor(bc) {
   return readData(bc);
@@ -15209,31 +14747,155 @@ function readWorkflowLoopEntry(bc) {
     output: read0(bc)
   };
 }
-function readWorkflowSleepEntry(bc) {
+function readWorkflowSleepEntry(bc) {
+  return {
+    deadline: readU64(bc),
+    state: readWorkflowSleepState(bc)
+  };
+}
+function readWorkflowMessageEntry(bc) {
+  return {
+    name: readString(bc),
+    messageData: readWorkflowCbor(bc)
+  };
+}
+function readWorkflowRollbackCheckpointEntry(bc) {
+  return {
+    name: readString(bc)
+  };
+}
+function readWorkflowBranchStatus(bc) {
+  return {
+    status: readWorkflowBranchStatusType(bc),
+    output: read0(bc),
+    error: read1(bc)
+  };
+}
+function read2(bc) {
+  const len = readUintSafe(bc);
+  const result = /* @__PURE__ */ new Map();
+  for (let i = 0; i < len; i++) {
+    const offset = bc.offset;
+    const key = readString(bc);
+    if (result.has(key)) {
+      bc.offset = offset;
+      throw new BareError(offset, "duplicated key");
+    }
+    result.set(key, readWorkflowBranchStatus(bc));
+  }
+  return result;
+}
+function readWorkflowJoinEntry(bc) {
+  return {
+    branches: read2(bc)
+  };
+}
+function readWorkflowRaceEntry(bc) {
+  return {
+    winner: read1(bc),
+    branches: read2(bc)
+  };
+}
+function readWorkflowRemovedEntry(bc) {
+  return {
+    originalType: readString(bc),
+    originalName: read1(bc)
+  };
+}
+function readWorkflowVersionCheckEntry(bc) {
+  return {
+    resolved: readU32(bc),
+    latest: readU32(bc)
+  };
+}
+function readWorkflowEntryKind(bc) {
+  const offset = bc.offset;
+  const tag = readU8(bc);
+  switch (tag) {
+    case 0:
+      return { tag: "WorkflowStepEntry", val: readWorkflowStepEntry(bc) };
+    case 1:
+      return { tag: "WorkflowLoopEntry", val: readWorkflowLoopEntry(bc) };
+    case 2:
+      return {
+        tag: "WorkflowSleepEntry",
+        val: readWorkflowSleepEntry(bc)
+      };
+    case 3:
+      return {
+        tag: "WorkflowMessageEntry",
+        val: readWorkflowMessageEntry(bc)
+      };
+    case 4:
+      return {
+        tag: "WorkflowRollbackCheckpointEntry",
+        val: readWorkflowRollbackCheckpointEntry(bc)
+      };
+    case 5:
+      return { tag: "WorkflowJoinEntry", val: readWorkflowJoinEntry(bc) };
+    case 6:
+      return { tag: "WorkflowRaceEntry", val: readWorkflowRaceEntry(bc) };
+    case 7:
+      return {
+        tag: "WorkflowRemovedEntry",
+        val: readWorkflowRemovedEntry(bc)
+      };
+    case 8:
+      return {
+        tag: "WorkflowVersionCheckEntry",
+        val: readWorkflowVersionCheckEntry(bc)
+      };
+    default: {
+      bc.offset = offset;
+      throw new BareError(offset, "invalid tag");
+    }
+  }
+}
+function readWorkflowEntry(bc) {
   return {
-    deadline: readU64(bc),
-    state: readWorkflowSleepState(bc)
+    id: readString(bc),
+    location: readWorkflowLocation(bc),
+    kind: readWorkflowEntryKind(bc)
   };
 }
-function readWorkflowMessageEntry(bc) {
-  return {
-    name: readString(bc),
-    messageData: readWorkflowCbor(bc)
-  };
+function read3(bc) {
+  return readBool(bc) ? readU64(bc) : null;
 }
-function readWorkflowRollbackCheckpointEntry(bc) {
+function readWorkflowEntryMetadata(bc) {
   return {
-    name: readString(bc)
+    status: readWorkflowEntryStatus(bc),
+    error: read1(bc),
+    attempts: readU32(bc),
+    lastAttemptAt: readU64(bc),
+    createdAt: readU64(bc),
+    completedAt: read3(bc),
+    rollbackCompletedAt: read3(bc),
+    rollbackError: read1(bc)
   };
 }
-function readWorkflowBranchStatus(bc) {
-  return {
-    status: readWorkflowBranchStatusType(bc),
-    output: read0(bc),
-    error: read1(bc)
-  };
+function read4(bc) {
+  const len = readUintSafe(bc);
+  if (len === 0) {
+    return [];
+  }
+  const result = [readString(bc)];
+  for (let i = 1; i < len; i++) {
+    result[i] = readString(bc);
+  }
+  return result;
 }
-function read2(bc) {
+function read5(bc) {
+  const len = readUintSafe(bc);
+  if (len === 0) {
+    return [];
+  }
+  const result = [readWorkflowEntry(bc)];
+  for (let i = 1; i < len; i++) {
+    result[i] = readWorkflowEntry(bc);
+  }
+  return result;
+}
+function read6(bc) {
   const len = readUintSafe(bc);
   const result = /* @__PURE__ */ new Map();
   for (let i = 0; i < len; i++) {
@@ -15243,152 +14905,509 @@ function read2(bc) {
       bc.offset = offset;
       throw new BareError(offset, "duplicated key");
     }
-    result.set(key, readWorkflowBranchStatus(bc));
+    result.set(key, readWorkflowEntryMetadata(bc));
+  }
+  return result;
+}
+function readWorkflowHistory(bc) {
+  return {
+    nameRegistry: read4(bc),
+    entries: read5(bc),
+    entryMetadata: read6(bc)
+  };
+}
+function decodeWorkflowHistory(bytes) {
+  const bc = new ByteCursor(bytes, config2);
+  const result = readWorkflowHistory(bc);
+  if (bc.offset < bc.view.byteLength) {
+    throw new BareError(bc.offset, "remaining bytes");
+  }
+  return result;
+}
+function decodeWorkflowHistoryTransport(data) {
+  return decodeWorkflowHistory(toUint8Array(data));
+}
+
+// ../rivetkit/dist/tsup/chunk-DLQSZ6Q7.js
+function flattenActionHandlers(actions) {
+  const flattened = /* @__PURE__ */ Object.create(null);
+  for (const { name, handler } of collectActionEntries(actions)) {
+    flattened[name] = handler;
+  }
+  return flattened;
+}
+function flattenActionInputSchemas(actions, schemas) {
+  if (schemas === void 0) return void 0;
+  if (!isRecord(schemas)) {
+    throw new TypeError("actionInputSchemas must be an object");
+  }
+  const flattened = /* @__PURE__ */ Object.create(null);
+  for (const { name, path: path2 } of collectActionEntries(actions)) {
+    const nestedSchema = lookupNestedSchema(schemas, path2);
+    const flatSchema = schemas[name];
+    if (nestedSchema !== void 0 && flatSchema !== void 0 && nestedSchema !== flatSchema) {
+      throw new TypeError(
+        `Action input schema \`${name}\` is defined by both a nested path and a dotted key`
+      );
+    }
+    const schema = nestedSchema ?? flatSchema;
+    if (schema !== void 0) {
+      flattened[name] = schema;
+    }
+  }
+  return flattened;
+}
+function collectActionEntries(actions) {
+  const entries = [];
+  const names = /* @__PURE__ */ new Set();
+  visitActionGroup(actions ?? {}, [], entries, names);
+  return entries;
+}
+function visitActionGroup(value, path2, entries, names) {
+  if (!isRecord(value)) {
+    throw new TypeError(
+      `${formatActionPath(path2)} must be an action handler or group`
+    );
+  }
+  for (const [segment, child] of Object.entries(value)) {
+    const childPath = [...path2, segment];
+    if (typeof child === "function") {
+      const name = childPath.join(".");
+      if (names.has(name)) {
+        throw new TypeError(
+          `Multiple action definitions flatten to \`${name}\``
+        );
+      }
+      names.add(name);
+      entries.push({
+        name,
+        path: childPath,
+        handler: child
+      });
+    } else {
+      visitActionGroup(child, childPath, entries, names);
+    }
+  }
+}
+function lookupNestedSchema(schemas, path2) {
+  let value = schemas;
+  for (const segment of path2) {
+    if (!isRecord(value) || !Object.hasOwn(value, segment)) {
+      return void 0;
+    }
+    value = value[segment];
+  }
+  return value;
+}
+function isRecord(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}
+function formatActionPath(path2) {
+  return path2.length === 0 ? "actions" : `Action \`${path2.join(".")}\``;
+}
+var DEFAULT_SLEEP_GRACE_PERIOD = 15e3;
+var DEFAULT_MAX_ACTIONS = 128;
+var ACTOR_CONTEXT_INTERNAL_SYMBOL = /* @__PURE__ */ Symbol(
+  "rivetkit.actor_context_internal"
+);
+var RAW_STATE_SYMBOL = /* @__PURE__ */ Symbol("rivetkit.raw_state");
+var CONN_STATE_MANAGER_SYMBOL = /* @__PURE__ */ Symbol("rivetkit.conn_state_manager");
+var zFunction = () => external_exports.custom((val) => typeof val === "function");
+var zActionTree = external_exports.custom((value) => {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(value);
+  return prototype === Object.prototype || prototype === null;
+}).superRefine((actions, ctx) => {
+  try {
+    flattenActionHandlers(actions);
+  } catch (error46) {
+    ctx.addIssue({
+      code: "custom",
+      message: error46 instanceof Error ? error46.message : "Invalid action definition"
+    });
+  }
+});
+var WorkflowInspectorConfigSchema = external_exports.object({
+  getHistory: zFunction(),
+  getState: zFunction().optional(),
+  onHistoryUpdated: zFunction().optional(),
+  replayFromStep: zFunction().optional()
+});
+var RunInspectorConfigSchema = external_exports.object({
+  workflow: WorkflowInspectorConfigSchema.optional()
+}).optional();
+var BUILTIN_INSPECTOR_TAB_IDS = [
+  "workflow",
+  "database",
+  "state",
+  "queue",
+  "schedules",
+  "connections",
+  "console"
+];
+var BuiltinInspectorTabIdSchema = external_exports.enum(BUILTIN_INSPECTOR_TAB_IDS);
+var CUSTOM_INSPECTOR_TAB_ID_RE = /^[A-Za-z0-9_-]+$/;
+var CustomInspectorTabEntrySchema = external_exports.object({
+  id: external_exports.string().regex(
+    CUSTOM_INSPECTOR_TAB_ID_RE,
+    "inspector.tabs[].id must contain only letters, digits, underscore, or dash"
+  ),
+  label: external_exports.string().min(1),
+  source: external_exports.string().min(1),
+  /**
+   * Optional icon id. The dashboard maps strings to glyphs (see its
+   * icon registry); unknown ids fall back to a generic icon.
+   */
+  icon: external_exports.string().min(1).optional(),
+  hidden: external_exports.literal(false).optional()
+}).strict();
+var HideInspectorTabEntrySchema = external_exports.object({
+  id: BuiltinInspectorTabIdSchema,
+  hidden: external_exports.literal(true)
+}).strict();
+var InspectorTabEntrySchema = external_exports.union([
+  CustomInspectorTabEntrySchema,
+  HideInspectorTabEntrySchema
+]);
+var ActorInspectorConfigSchema = external_exports.object({
+  tabs: external_exports.array(InspectorTabEntrySchema).default(() => [])
+}).strict().refine(
+  (data) => {
+    const ids = data.tabs.map((t) => t.id);
+    return new Set(ids).size === ids.length;
+  },
+  { message: "Duplicate id in inspector.tabs", path: ["tabs"] }
+).refine(
+  (data) => {
+    const builtinSet = new Set(BUILTIN_INSPECTOR_TAB_IDS);
+    return data.tabs.every(
+      (t) => t.hidden === true || !builtinSet.has(t.id)
+    );
+  },
+  {
+    message: "Custom inspector tab id collides with a built-in (use hidden: true to hide a built-in)",
+    path: ["tabs"]
+  }
+);
+var RunConfigSchema = external_exports.object({
+  /** Display name for the actor in the Inspector UI. */
+  name: external_exports.string().optional(),
+  /** Icon for the actor in the Inspector UI. Can be an emoji or FontAwesome icon name. */
+  icon: external_exports.string().optional(),
+  /** The run handler function. */
+  run: zFunction(),
+  /** Inspector integration for long-running run handlers. */
+  inspector: RunInspectorConfigSchema.optional()
+});
+var RUN_FUNCTION_CONFIG_SYMBOL = /* @__PURE__ */ Symbol.for("rivetkit.run_function_config");
+function defineRunHandler(run, options) {
+  if (options.inspectorKind === void 0 !== (options.createInspector === void 0)) {
+    throw new TypeError(
+      "defineRunHandler requires inspectorKind and createInspector together"
+    );
   }
-  return result;
-}
-function readWorkflowJoinEntry(bc) {
-  return {
-    branches: read2(bc)
-  };
+  Object.defineProperty(run, RUN_FUNCTION_CONFIG_SYMBOL, {
+    configurable: false,
+    enumerable: false,
+    writable: false,
+    value: {
+      name: options.name,
+      icon: options.icon,
+      inspectorKind: options.inspectorKind,
+      createInspector: options.createInspector
+    }
+  });
+  return run;
 }
-function readWorkflowRaceEntry(bc) {
-  return {
-    winner: read1(bc),
-    branches: read2(bc)
-  };
+function getRunInspectorKind(run) {
+  var _a2;
+  if (!run || typeof run !== "function") return void 0;
+  return (_a2 = run[RUN_FUNCTION_CONFIG_SYMBOL]) == null ? void 0 : _a2.inspectorKind;
 }
-function readWorkflowRemovedEntry(bc) {
-  return {
-    originalType: readString(bc),
-    originalName: read1(bc)
-  };
+function createRunInspector(run, context) {
+  var _a2, _b;
+  if (!run || typeof run !== "function") return void 0;
+  return (_b = (_a2 = run[RUN_FUNCTION_CONFIG_SYMBOL]) == null ? void 0 : _a2.createInspector) == null ? void 0 : _b.call(_a2, context);
 }
-function readWorkflowVersionCheckEntry(bc) {
-  return {
-    resolved: readU32(bc),
-    latest: readU32(bc)
-  };
+var zRunHandler = external_exports.union([zFunction(), RunConfigSchema]).optional();
+function getRunFunction(run) {
+  if (!run) return void 0;
+  if (typeof run === "function") return run;
+  return run.run;
 }
-function readWorkflowEntryKind(bc) {
-  const offset = bc.offset;
-  const tag = readU8(bc);
-  switch (tag) {
-    case 0:
-      return { tag: "WorkflowStepEntry", val: readWorkflowStepEntry(bc) };
-    case 1:
-      return { tag: "WorkflowLoopEntry", val: readWorkflowLoopEntry(bc) };
-    case 2:
-      return {
-        tag: "WorkflowSleepEntry",
-        val: readWorkflowSleepEntry(bc)
-      };
-    case 3:
-      return {
-        tag: "WorkflowMessageEntry",
-        val: readWorkflowMessageEntry(bc)
-      };
-    case 4:
-      return {
-        tag: "WorkflowRollbackCheckpointEntry",
-        val: readWorkflowRollbackCheckpointEntry(bc)
-      };
-    case 5:
-      return { tag: "WorkflowJoinEntry", val: readWorkflowJoinEntry(bc) };
-    case 6:
-      return { tag: "WorkflowRaceEntry", val: readWorkflowRaceEntry(bc) };
-    case 7:
-      return {
-        tag: "WorkflowRemovedEntry",
-        val: readWorkflowRemovedEntry(bc)
-      };
-    case 8:
-      return {
-        tag: "WorkflowVersionCheckEntry",
-        val: readWorkflowVersionCheckEntry(bc)
-      };
-    default: {
-      bc.offset = offset;
-      throw new BareError(offset, "invalid tag");
-    }
+function getRunMetadata(run) {
+  if (!run) return {};
+  if (typeof run === "function") {
+    const config3 = run[RUN_FUNCTION_CONFIG_SYMBOL];
+    if (!config3) return {};
+    return { name: config3.name, icon: config3.icon };
   }
+  return { name: run.name, icon: run.icon };
 }
-function readWorkflowEntry(bc) {
-  return {
-    id: readString(bc),
-    location: readWorkflowLocation(bc),
-    kind: readWorkflowEntryKind(bc)
-  };
-}
-function read3(bc) {
-  return readBool(bc) ? readU64(bc) : null;
+function getRunInspectorConfig(run, actor2) {
+  if (!run) return void 0;
+  if (typeof run === "function") {
+    const config3 = run[RUN_FUNCTION_CONFIG_SYMBOL];
+    return (config3 == null ? void 0 : config3.inspectorFactory) ? config3.inspectorFactory(actor2) : config3 == null ? void 0 : config3.inspector;
+  }
+  return run.inspector;
 }
-function readWorkflowEntryMetadata(bc) {
-  return {
-    status: readWorkflowEntryStatus(bc),
-    error: read1(bc),
-    attempts: readU32(bc),
-    lastAttemptAt: readU64(bc),
-    createdAt: readU64(bc),
-    completedAt: read3(bc),
-    rollbackCompletedAt: read3(bc),
-    rollbackError: read1(bc)
-  };
+function hasRunInspectorConfig(run) {
+  if (!run) return false;
+  if (typeof run !== "function") return run.inspector !== void 0;
+  const config3 = run[RUN_FUNCTION_CONFIG_SYMBOL];
+  return (config3 == null ? void 0 : config3.inspectorKind) !== void 0 || (config3 == null ? void 0 : config3.createInspector) !== void 0 || (config3 == null ? void 0 : config3.inspector) !== void 0 || (config3 == null ? void 0 : config3.inspectorFactory) !== void 0;
 }
-function read4(bc) {
-  const len = readUintSafe(bc);
-  if (len === 0) {
-    return [];
-  }
-  const result = [readString(bc)];
-  for (let i = 1; i < len; i++) {
-    result[i] = readString(bc);
+function disposeRunInspector(run, actorId) {
+  var _a2;
+  if (!run || typeof run !== "function") {
+    return;
   }
-  return result;
+  const config3 = run[RUN_FUNCTION_CONFIG_SYMBOL];
+  (_a2 = config3 == null ? void 0 : config3.disposeInspector) == null ? void 0 : _a2.call(config3, actorId);
 }
-function read5(bc) {
-  const len = readUintSafe(bc);
-  if (len === 0) {
-    return [];
-  }
-  const result = [readWorkflowEntry(bc)];
-  for (let i = 1; i < len; i++) {
-    result[i] = readWorkflowEntry(bc);
+var GlobalActorOptionsBaseSchema = external_exports.object({
+  /** Display name for the actor in the Inspector UI. */
+  name: external_exports.string().optional(),
+  /** Icon for the actor in the Inspector UI. Can be an emoji or FontAwesome icon name. */
+  icon: external_exports.string().optional(),
+  /** Maximum number of action handlers that may be defined on this actor. */
+  maxActions: external_exports.number().int().nonnegative().default(DEFAULT_MAX_ACTIONS),
+  /** Enables the experimental Actor Runtime Socket for this actor. */
+  enableActorRuntimeSocket: external_exports.boolean().default(false),
+  /**
+   * Can hibernate WebSockets for onWebSocket.
+   *
+   * WebSockets using actions/events are hibernatable by default.
+   *
+   * @experimental
+   **/
+  canHibernateWebSocket: external_exports.union([external_exports.boolean(), zFunction()]).default(false)
+}).strict();
+var GlobalActorOptionsSchema = GlobalActorOptionsBaseSchema.prefault(
+  () => ({})
+);
+var InstanceActorOptionsBaseSchema = external_exports.object({
+  createVarsTimeout: external_exports.number().positive().default(5e3),
+  createConnStateTimeout: external_exports.number().positive().default(5e3),
+  onBeforeConnectTimeout: external_exports.number().positive().default(5e3),
+  onConnectTimeout: external_exports.number().positive().default(5e3),
+  onMigrateTimeout: external_exports.number().positive().default(3e4),
+  sleepGracePeriod: external_exports.number().positive().default(DEFAULT_SLEEP_GRACE_PERIOD),
+  /** @deprecated `onDestroyTimeout` is folded into `sleepGracePeriod`, which now bounds the entire graceful shutdown window for both sleep and destroy. Will be removed in 2.2.0. */
+  onDestroyTimeout: external_exports.number().positive().optional(),
+  /** @deprecated `waitUntilTimeout` is folded into `sleepGracePeriod`, which now bounds the entire graceful shutdown window for both sleep and destroy. Will be removed in 2.2.0. */
+  waitUntilTimeout: external_exports.number().positive().optional(),
+  stateSaveInterval: external_exports.number().positive().default(1e3),
+  actionTimeout: external_exports.number().positive().default(6e4),
+  connectionLivenessTimeout: external_exports.number().positive().default(2500),
+  connectionLivenessInterval: external_exports.number().positive().default(5e3),
+  /** @deprecated Use `c.keepAwake(promise)` to scope keep-awake to a specific operation, or keep `noSleep` for actors that must stay awake indefinitely. Will be removed in 2.2.0. */
+  noSleep: external_exports.boolean().default(false),
+  sleepTimeout: external_exports.number().positive().default(3e4),
+  maxQueueSize: external_exports.number().positive().default(1e3),
+  /** Maximum pending one-shot and recurring schedules. */
+  maxSchedules: external_exports.number().int().nonnegative().default(1e3),
+  maxQueueMessageSize: external_exports.number().positive().default(64 * 1024),
+  /** @deprecated Internal storage moved to SQLite and no longer uses KV preloading, so this option is ignored. Will be removed in 2.2.0. */
+  preloadMaxWorkflowBytes: external_exports.number().nonnegative().optional(),
+  /** @deprecated Internal storage moved to SQLite and no longer uses KV preloading, so this option is ignored. Will be removed in 2.2.0. */
+  preloadMaxConnectionsBytes: external_exports.number().nonnegative().optional()
+}).strict();
+var InstanceActorOptionsSchema = InstanceActorOptionsBaseSchema.prefault(() => ({}));
+var ActorOptionsSchema = GlobalActorOptionsBaseSchema.extend(
+  InstanceActorOptionsBaseSchema.shape
+).strict().prefault(() => ({}));
+var ActorConfigSchema = external_exports.object({
+  onCreate: zFunction().optional(),
+  onDestroy: zFunction().optional(),
+  onMigrate: zFunction().optional(),
+  onWake: zFunction().optional(),
+  onSleep: zFunction().optional(),
+  run: zRunHandler,
+  onStateChange: zFunction().optional(),
+  onBeforeConnect: zFunction().optional(),
+  onConnect: zFunction().optional(),
+  onDisconnect: zFunction().optional(),
+  onBeforeActionResponse: zFunction().optional(),
+  onRequest: zFunction().optional(),
+  onWebSocket: zFunction().optional(),
+  actions: zActionTree.default(() => ({})),
+  actionInputSchemas: external_exports.record(external_exports.string(), external_exports.any()).optional(),
+  connParamsSchema: external_exports.any().optional(),
+  events: external_exports.record(external_exports.string(), external_exports.any()).optional(),
+  queues: external_exports.record(external_exports.string(), external_exports.any()).optional(),
+  state: external_exports.any().optional(),
+  createState: zFunction().optional(),
+  connState: external_exports.any().optional(),
+  createConnState: zFunction().optional(),
+  vars: external_exports.any().optional(),
+  db: external_exports.any().optional(),
+  createVars: zFunction().optional(),
+  options: ActorOptionsSchema,
+  inspector: ActorInspectorConfigSchema.optional()
+}).strict().refine(
+  (data) => !(data.state !== void 0 && data.createState !== void 0),
+  {
+    message: "Cannot define both 'state' and 'createState'",
+    path: ["state"]
   }
-  return result;
-}
-function read6(bc) {
-  const len = readUintSafe(bc);
-  const result = /* @__PURE__ */ new Map();
-  for (let i = 0; i < len; i++) {
-    const offset = bc.offset;
-    const key = readString(bc);
-    if (result.has(key)) {
-      bc.offset = offset;
-      throw new BareError(offset, "duplicated key");
-    }
-    result.set(key, readWorkflowEntryMetadata(bc));
+).refine(
+  (data) => !(data.connState !== void 0 && data.createConnState !== void 0),
+  {
+    message: "Cannot define both 'connState' and 'createConnState'",
+    path: ["connState"]
   }
-  return result;
-}
-function readWorkflowHistory(bc) {
-  return {
-    nameRegistry: read4(bc),
-    entries: read5(bc),
-    entryMetadata: read6(bc)
-  };
-}
-function decodeWorkflowHistory(bytes) {
-  const bc = new ByteCursor(bytes, config2);
-  const result = readWorkflowHistory(bc);
-  if (bc.offset < bc.view.byteLength) {
-    throw new BareError(bc.offset, "remaining bytes");
+).refine(
+  (data) => !(data.vars !== void 0 && data.createVars !== void 0),
+  {
+    message: "Cannot define both 'vars' and 'createVars'",
+    path: ["vars"]
   }
-  return result;
-}
-function decodeWorkflowHistoryTransport(data) {
-  return decodeWorkflowHistory(toUint8Array(data));
-}
+).superRefine((data, ctx) => {
+  const actionCount = Object.keys(
+    flattenActionHandlers(data.actions)
+  ).length;
+  if (actionCount > data.options.maxActions) {
+    ctx.addIssue({
+      code: "custom",
+      message: `Actor defines ${actionCount} actions, but maxActions is ${data.options.maxActions}`,
+      path: ["actions"]
+    });
+  }
+});
+var DocActorOptionsSchema = external_exports.object({
+  name: external_exports.string().optional().describe("Display name for the actor in the Inspector UI."),
+  icon: external_exports.string().optional().describe(
+    "Icon for the actor in the Inspector UI. Can be an emoji (e.g., '\u{1F680}') or FontAwesome icon name (e.g., 'rocket')."
+  ),
+  maxActions: external_exports.number().int().nonnegative().optional().describe(
+    `Maximum number of action handlers that may be defined on this actor. Default: ${DEFAULT_MAX_ACTIONS}`
+  ),
+  enableActorRuntimeSocket: external_exports.boolean().optional().describe(
+    "Enables the experimental Actor Runtime Socket for this actor. Default: false"
+  ),
+  createVarsTimeout: external_exports.number().optional().describe("Timeout in ms for createVars handler. Default: 5000"),
+  createConnStateTimeout: external_exports.number().optional().describe(
+    "Timeout in ms for createConnState handler. Default: 5000"
+  ),
+  onMigrateTimeout: external_exports.number().optional().describe("Timeout in ms for onMigrate handler. Default: 30000"),
+  onBeforeConnectTimeout: external_exports.number().optional().describe(
+    "Timeout in ms for onBeforeConnect handler. Default: 5000"
+  ),
+  onConnectTimeout: external_exports.number().optional().describe("Timeout in ms for onConnect handler. Default: 5000"),
+  sleepGracePeriod: external_exports.number().optional().describe(
+    `Max time in ms for the graceful shutdown window. Covers lifecycle hooks (onSleep, onDestroy), the run handler wait, async raw WebSocket handlers, disconnect callbacks, and final state serialization. Default: ${DEFAULT_SLEEP_GRACE_PERIOD}.`
+  ),
+  onDestroyTimeout: external_exports.number().optional().describe(
+    "Deprecated. Folded into sleepGracePeriod, which now bounds the entire graceful shutdown window for both sleep and destroy. Will be removed in 2.2.0."
+  ),
+  waitUntilTimeout: external_exports.number().optional().describe(
+    "Deprecated. Folded into sleepGracePeriod, which now bounds the entire graceful shutdown window for both sleep and destroy. Will be removed in 2.2.0."
+  ),
+  stateSaveInterval: external_exports.number().optional().describe(
+    "Interval in ms between automatic state saves. Default: 1000"
+  ),
+  actionTimeout: external_exports.number().optional().describe("Timeout in ms for action handlers. Default: 60000"),
+  connectionLivenessTimeout: external_exports.number().optional().describe(
+    "Timeout in ms for connection liveness checks. Default: 2500"
+  ),
+  connectionLivenessInterval: external_exports.number().optional().describe(
+    "Interval in ms between connection liveness checks. Default: 5000"
+  ),
+  noSleep: external_exports.boolean().optional().describe(
+    "Deprecated. If true, the actor will never sleep. Use c.keepAwake(promise) to scope keep-awake to a specific operation instead. Default: false"
+  ),
+  sleepTimeout: external_exports.number().optional().describe(
+    "Time in ms of inactivity before the actor sleeps. Default: 30000"
+  ),
+  maxQueueSize: external_exports.number().optional().describe(
+    "Maximum number of queue messages before rejecting new messages. Default: 1000"
+  ),
+  maxSchedules: external_exports.number().int().nonnegative().optional().describe(
+    "Maximum pending one-shot and recurring schedules before rejecting new schedules. Default: 1000"
+  ),
+  maxQueueMessageSize: external_exports.number().optional().describe(
+    "Maximum size of each queue message in bytes. Default: 65536"
+  ),
+  canHibernateWebSocket: external_exports.boolean().optional().describe(
+    "Whether WebSockets using onWebSocket can be hibernated. WebSockets using actions/events are hibernatable by default. Default: false"
+  )
+}).describe("Actor options for timeouts and behavior configuration.");
+var DocActorConfigSchema = external_exports.object({
+  state: external_exports.unknown().optional().describe(
+    "Initial state value for the actor. Cannot be used with createState."
+  ),
+  createState: external_exports.unknown().optional().describe(
+    "Function to create initial state. Receives context and input. Cannot be used with state."
+  ),
+  connState: external_exports.unknown().optional().describe(
+    "Initial connection state value. Cannot be used with createConnState."
+  ),
+  createConnState: external_exports.unknown().optional().describe(
+    "Function to create connection state. Receives context and connection params. The pending connection is not visible in c.conns until this succeeds. Cannot be used with connState."
+  ),
+  vars: external_exports.unknown().optional().describe(
+    "Initial ephemeral variables value. Cannot be used with createVars."
+  ),
+  createVars: external_exports.unknown().optional().describe(
+    "Function to create ephemeral variables. Receives context and driver context. Cannot be used with vars."
+  ),
+  db: external_exports.unknown().optional().describe("Database provider instance for the actor."),
+  onCreate: external_exports.unknown().optional().describe(
+    "Called when the actor is first initialized. Use to initialize state."
+  ),
+  onDestroy: external_exports.unknown().optional().describe("Called when the actor is destroyed."),
+  onMigrate: external_exports.unknown().optional().describe(
+    "Called on every actor start after persisted state loads and before onWake. Use for repeatable schema migrations."
+  ),
+  onWake: external_exports.unknown().optional().describe(
+    "Called when the actor wakes up and is ready to receive connections and actions."
+  ),
+  onSleep: external_exports.unknown().optional().describe(
+    "Called when the actor is stopping or sleeping. Use to clean up resources."
+  ),
+  run: external_exports.unknown().optional().describe(
+    "Called after actor starts. Does not block startup. Use for background tasks like queue processing or tick loops. If it exits, the actor follows the normal idle sleep timeout once idle. If it throws, the actor logs the error and then follows the normal idle sleep timeout once idle."
+  ),
+  onStateChange: external_exports.unknown().optional().describe(
+    "Called when the actor's state changes. State changes within this hook won't trigger recursion."
+  ),
+  onBeforeConnect: external_exports.unknown().optional().describe(
+    "Called before a client connects. Throw an error to reject the connection. The pending connection is not visible in c.conns while this runs."
+  ),
+  onConnect: external_exports.unknown().optional().describe(
+    "Called when a client successfully connects. The connection is visible in c.conns before this runs."
+  ),
+  onDisconnect: external_exports.unknown().optional().describe("Called when a client disconnects."),
+  onBeforeActionResponse: external_exports.unknown().optional().describe(
+    "Called before sending an action response. Use to transform output."
+  ),
+  onRequest: external_exports.unknown().optional().describe(
+    "Called for raw HTTP requests to /actors/{name}/http/* endpoints."
+  ),
+  onWebSocket: external_exports.unknown().optional().describe(
+    "Called for raw WebSocket connections to /actors/{name}/websocket/* endpoints."
+  ),
+  actions: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe(
+    "Tree of action names or nested groups to handler functions. Nested paths use dot-separated low-level action names. Defaults to an empty object."
+  ),
+  actionInputSchemas: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe(
+    "Optional schemas for validating action argument tuples in native runtimes. May mirror nested action groups or use dot-separated low-level action names."
+  ),
+  connParamsSchema: external_exports.unknown().optional().describe(
+    "Optional schema for validating connection params in native runtimes."
+  ),
+  events: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe("Map of event names to schemas."),
+  queues: external_exports.record(external_exports.string(), external_exports.unknown()).optional().describe("Map of queue names to schemas."),
+  options: DocActorOptionsSchema.optional()
+}).describe("Actor configuration passed to the actor() function.");
 
 // ../rivetkit/dist/tsup/chunk-JI6GZ2C2.js
 var EMPTY_KEY = "/";
@@ -15507,44 +15526,6 @@ function removePrefixFromKey(prefixedKey) {
   return prefixedKey.slice(KEYS.KV.length);
 }
 
-// ../rivetkit/dist/tsup/chunk-ZEIH7S4M.js
-function logger() {
-  return getLogger("actor-client");
-}
-var webSocketPromise = null;
-async function importWebSocket() {
-  if (webSocketPromise !== null) {
-    return webSocketPromise;
-  }
-  webSocketPromise = (async () => {
-    let _WebSocket;
-    if (typeof WebSocket !== "undefined") {
-      _WebSocket = WebSocket;
-    } else {
-      try {
-        const moduleName = "ws";
-        const ws = await import(
-          /* webpackIgnore: true */
-          moduleName
-        );
-        _WebSocket = ws.default;
-        logger().debug("using websocket from npm");
-      } catch {
-        _WebSocket = class MockWebSocket {
-          constructor() {
-            throw new Error(
-              'WebSocket support requires installing the "ws" peer dependency.'
-            );
-          }
-        };
-        logger().debug("using mock websocket");
-      }
-    }
-    return _WebSocket;
-  })();
-  return webSocketPromise;
-}
-
 // ../rivetkit/dist/tsup/chunk-JTHHCZCZ.js
 var MIGRATION_TRANSACTION_TIMEOUT_MS = 5 * 6e4;
 function isManualTransactionControl(query) {
@@ -15628,7 +15609,45 @@ var AsyncMutex = class {
   }
 };
 
-// ../rivetkit/dist/tsup/chunk-BK2JOGQQ.js
+// ../rivetkit/dist/tsup/chunk-NVMHEG5J.js
+function logger() {
+  return getLogger("actor-client");
+}
+var webSocketPromise = null;
+async function importWebSocket() {
+  if (webSocketPromise !== null) {
+    return webSocketPromise;
+  }
+  webSocketPromise = (async () => {
+    let _WebSocket;
+    if (typeof WebSocket !== "undefined") {
+      _WebSocket = WebSocket;
+    } else {
+      try {
+        const moduleName = "ws";
+        const ws = await import(
+          /* webpackIgnore: true */
+          moduleName
+        );
+        _WebSocket = ws.default;
+        logger().debug("using websocket from npm");
+      } catch {
+        _WebSocket = class MockWebSocket {
+          constructor() {
+            throw new Error(
+              'WebSocket support requires installing the "ws" peer dependency.'
+            );
+          }
+        };
+        logger().debug("using mock websocket");
+      }
+    }
+    return _WebSocket;
+  })();
+  return webSocketPromise;
+}
+
+// ../rivetkit/dist/tsup/chunk-O74736N5.js
 var import_invariant2 = __toESM(require_invariant(), 1);
 
 // ../../../node_modules/.pnpm/p-retry@6.2.1/node_modules/p-retry/index.js
@@ -15806,7 +15825,7 @@ function createVersionedDataHandler(config3) {
   return new VersionedDataHandler(config3);
 }
 
-// ../rivetkit/dist/tsup/chunk-BK2JOGQQ.js
+// ../rivetkit/dist/tsup/chunk-O74736N5.js
 var import_invariant3 = __toESM(require_invariant(), 1);
 var import_invariant4 = __toESM(require_invariant(), 1);
 var PATH_CONNECT = "/connect";
@@ -18486,7 +18505,7 @@ var ActorHandleRaw = class {
   async #sendQueueMessage(name, body, options) {
     return await this.#queueSendMutex.run(async () => {
       const maxAttempts = this.#getDynamicQueryMaxAttempts();
-      let useQueryTarget = false;
+      let useQueryTarget = isDynamicActorQuery(this.#actorResolutionState);
       for (let attempt = 0; attempt < maxAttempts; attempt++) {
         let actorId;
         try {
@@ -18549,8 +18568,9 @@ var ActorHandleRaw = class {
             code
           );
           if (invalidated && attempt < maxAttempts - 1) {
-            useQueryTarget = code === "starting" || code === "stopping" || code.startsWith("destroyed_");
-            if (useQueryTarget) {
+            const waitForReady = code === "starting" || code === "stopping" || code.startsWith("destroyed_");
+            useQueryTarget = useQueryTarget || waitForReady;
+            if (waitForReady) {
               await this.#waitForRetryWindow();
             }
             continue;
@@ -18586,7 +18606,7 @@ var ActorHandleRaw = class {
   }
   async #sendActionNow(opts) {
     const maxAttempts = this.#getDynamicQueryMaxAttempts();
-    let useQueryTarget = false;
+    let useQueryTarget = isDynamicActorQuery(this.#actorResolutionState);
     const gatewayOptions = resolveActorGatewayOptions(
       this.#gatewayOptions,
       opts
@@ -18835,7 +18855,7 @@ var ActorHandleRaw = class {
   }
   async #fetchWithResolvedActor(input, init) {
     const maxAttempts = this.#getDynamicQueryMaxAttempts();
-    let useQueryTarget = false;
+    let useQueryTarget = isDynamicActorQuery(this.#actorResolutionState);
     const { skipReadyWait, ...requestInit } = init ?? {};
     const gatewayOptions = resolveActorGatewayOptions(
       this.#gatewayOptions,
@@ -18903,8 +18923,9 @@ var ActorHandleRaw = class {
           code
         );
         if (invalidated && attempt < maxAttempts - 1) {
-          useQueryTarget = code === "starting" || code === "stopping" || code.startsWith("destroyed_");
-          if (useQueryTarget) {
+          const waitForReady = code === "starting" || code === "stopping" || code.startsWith("destroyed_");
+          useQueryTarget = useQueryTarget || waitForReady;
+          if (waitForReady) {
             await this.#waitForRetryWindow();
           }
           continue;
@@ -18954,10 +18975,10 @@ var ActorHandleRaw = class {
     }
     const invalidated = this.#invalidateResolvedActorId(group, code);
     if (invalidated && attempt < maxAttempts - 1) {
-      const useQueryTarget = code === "starting" || code === "stopping" || code.startsWith("destroyed_");
+      const waitForReady = code === "starting" || code === "stopping" || code.startsWith("destroyed_");
       return {
-        useQueryTarget,
-        waitForRetryWindow: useQueryTarget
+        useQueryTarget: true,
+        waitForRetryWindow: waitForReady
       };
     }
     return null;
@@ -21330,24 +21351,45 @@ var RemoteEngineControlClient = class {
       name,
       key
     });
-    const { actor: actor2, created } = await getOrCreateActor(this.#config, {
-      datacenter: region,
-      name,
-      key: serializeActorKey(key),
-      runner_name_selector: poolName ?? this.#config.poolName,
-      input: actorInput ? uint8ArrayToBase642(
-        encodeCborCompat(actorInput)
-      ) : void 0,
-      crash_policy: crashPolicy ?? "sleep"
-    });
-    logger2().info({
-      msg: "getOrCreateWithKey: actor ready",
-      actorId: actor2.actor_id,
-      name,
-      key,
-      created
-    });
-    return apiActorToOutput(actor2);
+    try {
+      const { actor: actor2, created } = await getOrCreateActor(this.#config, {
+        datacenter: region,
+        name,
+        key: serializeActorKey(key),
+        runner_name_selector: poolName ?? this.#config.poolName,
+        input: actorInput ? uint8ArrayToBase642(
+          encodeCborCompat(actorInput)
+        ) : void 0,
+        crash_policy: crashPolicy ?? "sleep"
+      });
+      logger2().info({
+        msg: "getOrCreateWithKey: actor ready",
+        actorId: actor2.actor_id,
+        name,
+        key,
+        created
+      });
+      return apiActorToOutput(actor2);
+    } catch (error46) {
+      if (error46 instanceof RivetError && error46.group === "actor" && error46.code === "key_reserved_in_different_datacenter") {
+        logger2().warn({
+          msg: "getOrCreateWithKey: key reserved in different datacenter, retrying as get",
+          name,
+          key
+        });
+        const response = await getActorByKey(this.#config, name, key);
+        const existing = response.actors[0];
+        if (!existing) throw error46;
+        logger2().info({
+          msg: "getOrCreateWithKey: resolved existing actor via get",
+          actorId: existing.actor_id,
+          name,
+          key
+        });
+        return apiActorToOutput(existing);
+      }
+      throw error46;
+    }
   }
   async createActor({
     name,
@@ -21548,7 +21590,7 @@ function apiActorToOutput(actor2) {
   };
 }
 
-// ../rivetkit/dist/tsup/chunk-KRQI5GXM.js
+// ../rivetkit/dist/tsup/chunk-AF2VKCFA.js
 var nativeStateTransactionOpeners = /* @__PURE__ */ new WeakMap();
 var nativeStateTransactionClientBinders = /* @__PURE__ */ new WeakMap();
 function registerNativeStateTransactionOpener(provider, opener) {
@@ -28632,6 +28674,7 @@ function buildActorConfig(definition, registryConfig, runtimeKind) {
   return {
     name: options.name,
     icon: options.icon,
+    maxActions: options.maxActions,
     hasDatabase: true,
     remoteSqlite: usesRemoteSqlite,
     sqliteProfiling,