@rivetkit/supabase 2.3.11-rc.7 → 2.3.11-rc.8

package/dist/mod.js

@@ -334,6 +334,183 @@ __export(mod_exports, {
 module.exports = __toCommonJS(mod_exports);
 var wasmBindings = __toESM(require("@rivetkit/rivetkit-wasm"));
 
+// ../rivetkit/dist/tsup/chunk-ZZ3WBRPD.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 || "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" && (!("__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;
+  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.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,
+      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,
+      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,
+    public: error46.public,
+    statusCode: error46.statusCode,
+    actor: error46.actor
+  })}`;
+}
+function decodeBridgeRivetErrorPayload(value) {
+  if (!value.startsWith(BRIDGE_RIVET_ERROR_PREFIX)) {
+    return void 0;
+  }
+  try {
+    const payload = JSON.parse(
+      value.slice(BRIDGE_RIVET_ERROR_PREFIX.length)
+    );
+    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,
+    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-AGNBLCNJ.js
+var import_pino = require("pino");
+
 // ../../../node_modules/.pnpm/zod@4.1.13/node_modules/zod/v4/classic/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -13004,658 +13181,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-QWLJCP3X.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;
-    }
+// ../rivetkit/dist/tsup/chunk-AGNBLCNJ.js
+var cbor = __toESM(require("cbor-x"), 1);
+var import_invariant = __toESM(require_invariant(), 1);
+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 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(),
-  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"
-);
-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 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-ZZ3WBRPD.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 || "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" && (!("__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;
-  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.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,
-      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,
-      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,
-    public: error46.public,
-    statusCode: error46.statusCode,
-    actor: error46.actor
-  })}`;
-}
-function decodeBridgeRivetErrorPayload(value) {
-  if (!value.startsWith(BRIDGE_RIVET_ERROR_PREFIX)) {
-    return void 0;
-  }
-  try {
-    const payload = JSON.parse(
-      value.slice(BRIDGE_RIVET_ERROR_PREFIX.length)
-    );
-    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,
-    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-XAGDGH4O.js
-var import_pino = require("pino");
-var cbor = __toESM(require("cbor-x"), 1);
-var import_invariant = __toESM(require_invariant(), 1);
-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";
@@ -13774,7 +13346,7 @@ function noopNext() {
 }
 var package_default = {
   name: "rivetkit",
-  version: "2.3.11-rc.7",
+  version: "2.3.11-rc.8",
   description: "Lightweight libraries for building stateful actors on edge platforms",
   license: "Apache-2.0",
   keywords: [
@@ -15067,7 +14639,7 @@ function Config({ initialBufferLength = 1024, maxBufferLength = 1024 * 1024 * 32
   };
 }
 
-// ../rivetkit/dist/tsup/chunk-RZFEJKIS.js
+// ../rivetkit/dist/tsup/chunk-4EDGOGCB.js
 var config2 = /* @__PURE__ */ Config({});
 function readWorkflowCbor(bc) {
   return readData(bc);
@@ -15288,82 +14860,512 @@ function readWorkflowEntryKind(bc) {
     }
   }
 }
-function readWorkflowEntry(bc) {
-  return {
-    id: readString(bc),
-    location: readWorkflowLocation(bc),
-    kind: readWorkflowEntryKind(bc)
-  };
+function readWorkflowEntry(bc) {
+  return {
+    id: readString(bc),
+    location: readWorkflowLocation(bc),
+    kind: readWorkflowEntryKind(bc)
+  };
+}
+function read3(bc) {
+  return readBool(bc) ? readU64(bc) : null;
+}
+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 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 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++) {
+    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));
+  }
+  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-QWLJCP3X.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 read3(bc) {
-  return readBool(bc) ? readU64(bc) : null;
+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 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 formatActionPath(path2) {
+  return path2.length === 0 ? "actions" : `Action \`${path2.join(".")}\``;
 }
-function read4(bc) {
-  const len = readUintSafe(bc);
-  if (len === 0) {
-    return [];
+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 result = [readString(bc)];
-  for (let i = 1; i < len; i++) {
-    result[i] = readString(bc);
+  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"
+    });
   }
-  return result;
+});
+var WorkflowInspectorConfigSchema = external_exports.object({
+  getHistory: zFunction(),
+  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"
+);
+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 read5(bc) {
-  const len = readUintSafe(bc);
-  if (len === 0) {
-    return [];
+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 };
   }
-  const result = [readWorkflowEntry(bc)];
-  for (let i = 1; i < len; i++) {
-    result[i] = readWorkflowEntry(bc);
+  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 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"]
   }
-  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));
-}
+);
+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-JI6GZ2C2.js
 var EMPTY_KEY = "/";
@@ -15482,7 +15484,35 @@ function removePrefixFromKey(prefixedKey) {
   return prefixedKey.slice(KEYS.KV.length);
 }
 
-// ../rivetkit/dist/tsup/chunk-B7N2TMLF.js
+// ../rivetkit/dist/tsup/chunk-7AFZMFPQ.js
+var MIGRATION_TRANSACTION_TIMEOUT_MS = 5 * 6e4;
+var AsyncMutex = class {
+  #locked = false;
+  #waiting = [];
+  async acquire() {
+    while (this.#locked) {
+      await new Promise((resolve) => this.#waiting.push(resolve));
+    }
+    this.#locked = true;
+  }
+  release() {
+    this.#locked = false;
+    const next = this.#waiting.shift();
+    if (next) {
+      next();
+    }
+  }
+  async run(fn) {
+    await this.acquire();
+    try {
+      return await fn();
+    } finally {
+      this.release();
+    }
+  }
+};
+
+// ../rivetkit/dist/tsup/chunk-V6ANE6JM.js
 function logger() {
   return getLogger("actor-client");
 }
@@ -15520,35 +15550,7 @@ async function importWebSocket() {
   return webSocketPromise;
 }
 
-// ../rivetkit/dist/tsup/chunk-7AFZMFPQ.js
-var MIGRATION_TRANSACTION_TIMEOUT_MS = 5 * 6e4;
-var AsyncMutex = class {
-  #locked = false;
-  #waiting = [];
-  async acquire() {
-    while (this.#locked) {
-      await new Promise((resolve) => this.#waiting.push(resolve));
-    }
-    this.#locked = true;
-  }
-  release() {
-    this.#locked = false;
-    const next = this.#waiting.shift();
-    if (next) {
-      next();
-    }
-  }
-  async run(fn) {
-    await this.acquire();
-    try {
-      return await fn();
-    } finally {
-      this.release();
-    }
-  }
-};
-
-// ../rivetkit/dist/tsup/chunk-OISWZDAF.js
+// ../rivetkit/dist/tsup/chunk-JBQ63WSM.js
 var import_invariant2 = __toESM(require_invariant(), 1);
 
 // ../../../node_modules/.pnpm/p-retry@6.2.1/node_modules/p-retry/index.js
@@ -15726,7 +15728,7 @@ function createVersionedDataHandler(config3) {
   return new VersionedDataHandler(config3);
 }
 
-// ../rivetkit/dist/tsup/chunk-OISWZDAF.js
+// ../rivetkit/dist/tsup/chunk-JBQ63WSM.js
 var import_invariant3 = __toESM(require_invariant(), 1);
 var import_invariant4 = __toESM(require_invariant(), 1);
 var PATH_CONNECT = "/connect";