rivetkit 2.1.5 → 2.1.6-rc.1

package/dist/browser/client.d.ts

@@ -1,17 +1,90 @@
-import z$2, { z } from 'zod/v4';
+import { Context, Handler, Env, Hono } from 'hono';
+import z$1, { z } from 'zod/v4';
 import { UniversalWebSocket } from '@rivetkit/virtual-websocket';
-import { SqliteVfs } from '@rivetkit/sqlite-vfs';
+import { ISqliteVfs } from '@rivetkit/sqlite-vfs';
 import { Traces, OtlpExportTraceServiceRequestJson, SpanHandle, SpanStatusInput } from '@rivetkit/traces';
-import { Context, Handler, Env, Hono } from 'hono';
-import { z as z$1 } from 'zod';
 import { Logger } from 'pino';
-import { VersionedDataHandler } from 'vbare';
-import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
 import * as nanoevents from 'nanoevents';
 import { W as WorkflowHistory, k as QueueStatus } from './v3-DnYObHH3.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
+import { VersionedDataHandler } from 'vbare';
+import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
+import { z as z$2 } from 'zod';
 import '@rivetkit/bare-ts';
 
+/**
+ * Lightweight in-memory metrics for actor instances.
+ *
+ * Metrics are collected per actor wake cycle and are NOT persisted. They reset
+ * when the actor sleeps and wakes again.
+ */
+interface CounterMetric {
+    type: "counter";
+    help: string;
+    value: number;
+}
+interface GaugeMetric {
+    type: "gauge";
+    help: string;
+    value: number;
+}
+interface LabeledCounterMetric {
+    type: "labeled_counter";
+    help: string;
+    values: Record<string, number>;
+}
+interface LabeledTimingMetric {
+    type: "labeled_timing";
+    help: string;
+    values: Record<string, {
+        calls: number;
+        totalMs: number;
+        keys: number;
+    }>;
+}
+type Metric = CounterMetric | GaugeMetric | LabeledCounterMetric | LabeledTimingMetric;
+type MetricsSnapshot = Record<string, Metric>;
+declare class ActorMetrics {
+    kvGet: {
+        calls: number;
+        keys: number;
+        totalMs: number;
+    };
+    kvGetBatch: {
+        calls: number;
+        keys: number;
+        totalMs: number;
+    };
+    kvPut: {
+        calls: number;
+        keys: number;
+        totalMs: number;
+    };
+    kvPutBatch: {
+        calls: number;
+        keys: number;
+        totalMs: number;
+    };
+    kvDeleteBatch: {
+        calls: number;
+        keys: number;
+        totalMs: number;
+    };
+    sqlSelects: number;
+    sqlInserts: number;
+    sqlUpdates: number;
+    sqlDeletes: number;
+    sqlOther: number;
+    sqlTotalMs: number;
+    actionCalls: number;
+    actionErrors: number;
+    actionTotalMs: number;
+    connectionsOpened: number;
+    connectionsClosed: number;
+    trackSql(query: string, durationMs: number): void;
+    snapshot(): MetricsSnapshot;
+}
+
 type AnyDatabaseProvider = DatabaseProvider<any> | undefined;
 /**
  * Context provided to database providers for creating database clients
@@ -40,11 +113,14 @@ interface DatabaseProviderContext {
         batchDelete: (keys: Uint8Array[]) => Promise<void>;
     };
     /**
-     * SQLite VFS instance for creating KV-backed databases.
-     * This should be actor-scoped because @rivetkit/sqlite is not re-entrant per
-     * module instance.
+     * SQLite VFS handle for creating KV-backed databases.
+     * May be a standalone VFS or a pooled handle from SqliteVfsPool.
+     */
+    sqliteVfs?: ISqliteVfs;
+    /**
+     * Actor metrics instance. When provided, KV and SQL operations are tracked.
      */
-    sqliteVfs?: SqliteVfs;
+    metrics?: ActorMetrics;
 }
 type DatabaseProvider<DB extends RawAccess> = {
     /**
@@ -129,6 +205,77 @@ type InferQueueCompleteMap<T extends QueueSchemaConfig> = {
 };
 type InferEventArgs<T> = T extends readonly unknown[] ? number extends T["length"] ? [T] : T : [T];
 
+/** Data that's been serialized. */
+type OutputData = string | Uint8Array;
+declare const EncodingSchema: z.ZodEnum<{
+    json: "json";
+    cbor: "cbor";
+    bare: "bare";
+}>;
+/**
+ * Encoding used to communicate between the client & actor.
+ */
+type Encoding = z.infer<typeof EncodingSchema>;
+/**
+ * Helper class that helps serialize data without re-serializing for the same encoding.
+ */
+declare class CachedSerializer<TBare, TJson, T = TBare> {
+    #private;
+    constructor(data: T, versionedDataHandler: VersionedDataHandler<TBare>, version: number, zodSchema: z.ZodType<TJson>, toJson: (value: T) => TJson, toBare: (value: T) => TBare);
+    get rawData(): T;
+    serialize(encoding: Encoding): OutputData;
+}
+
+declare const ActorKeySchema: z.ZodArray<z.ZodString>;
+type ActorKey = z.infer<typeof ActorKeySchema>;
+declare const CreateRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    key: z.ZodArray<z.ZodString>;
+    input: z.ZodOptional<z.ZodUnknown>;
+    region: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const ActorQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
+    getForId: z.ZodObject<{
+        name: z.ZodString;
+        actorId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    getForKey: z.ZodObject<{
+        name: z.ZodString;
+        key: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    getOrCreateForKey: z.ZodObject<{
+        name: z.ZodString;
+        key: z.ZodArray<z.ZodString>;
+        input: z.ZodOptional<z.ZodUnknown>;
+        region: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    create: z.ZodObject<{
+        name: z.ZodString;
+        key: z.ZodArray<z.ZodString>;
+        input: z.ZodOptional<z.ZodUnknown>;
+        region: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>]>;
+type ActorQuery = z.infer<typeof ActorQuerySchema>;
+/**
+ * Interface representing a request to create a actor.
+ */
+type CreateRequest = z.infer<typeof CreateRequestSchema>;
+
+declare const KEYS: {
+    PERSIST_DATA: Uint8Array<ArrayBuffer>;
+    CONN_PREFIX: Uint8Array<ArrayBuffer>;
+    INSPECTOR_TOKEN: Uint8Array<ArrayBuffer>;
+    KV: Uint8Array<ArrayBuffer>;
+    QUEUE_PREFIX: Uint8Array<ArrayBuffer>;
+    WORKFLOW_PREFIX: Uint8Array<ArrayBuffer>;
+    TRACES_PREFIX: Uint8Array<ArrayBuffer>;
+    SQLITE_PREFIX: Uint8Array<ArrayBuffer>;
+};
+
 /**
  * User-facing KV storage interface exposed on ActorContext.
  */
@@ -149,6 +296,8 @@ type KvValueOptions<T extends KvValueType = "text"> = {
 };
 type KvListOptions<T extends KvValueType = "text", K extends KvKeyType = "text"> = KvValueOptions<T> & {
     keyType?: K;
+    reverse?: boolean;
+    limit?: number;
 };
 declare class ActorKv {
     #private;
@@ -177,13 +326,24 @@ declare class ActorKv {
      * Delete multiple keys.
      */
     deleteBatch(keys: KvKey[]): Promise<void>;
+    /**
+     * Delete all keys in the half-open range [start, end).
+     */
+    deleteRange(start: KvKey, end: KvKey): Promise<void>;
     /**
      * List all keys with a given prefix.
      * Returns key-value pairs where keys have the user prefix removed.
      */
     list<T extends KvValueType = "text", K extends KvKeyType = "text">(prefix: KvKeyTypeMap[K], options?: KvListOptions<T, K>): Promise<[KvKeyTypeMap[K], KvValueTypeMap[T]][]>;
+    /**
+     * List all key-value pairs in the half-open range [start, end).
+     */
+    listRange<T extends KvValueType = "text", K extends KvKeyType = "text">(start: KvKeyTypeMap[K], end: KvKeyTypeMap[K], options?: KvListOptions<T, K>): Promise<[KvKeyTypeMap[K], KvValueTypeMap[T]][]>;
 }
 
+type UpgradeWebSocket = (createEvents: (c: Context) => any) => Handler;
+type GetUpgradeWebSocket = () => UpgradeWebSocket;
+
 interface QueueMessage {
     id: bigint;
     name: string;
@@ -369,7 +529,7 @@ declare class ActorContext<TState, TConnParams, TConnState, TVars, TInput, TData
     /**
      * Returns the client for the given registry.
      */
-    client<R extends Registry<any>>(): Client<R>;
+    client<R extends Registry<any> = Registry<any>>(): Client<R>;
     /**
      * Gets the database.
      *
@@ -387,16 +547,33 @@ declare class ActorContext<TState, TConnParams, TConnState, TVars, TInput, TData
     saveState(opts: SaveStateOptions): Promise<void>;
     /**
      * Prevents the actor from sleeping until promise is complete.
+     *
+     * @deprecated Use `onSleep` for shutdown or flush work, or
+     * `c.setPreventSleep(true)` while work is active if the actor must stay
+     * awake until it finishes.
      */
     waitUntil(promise: Promise<void>): void;
     /**
-     * Prevents the actor from sleeping while the given promise is running.
+     * Prevents the actor from automatically sleeping until cleared.
      *
-     * Use this when performing async operations in the `run` handler or other
-     * background contexts where you need to ensure the actor stays awake.
+     * @experimental
+     */
+    setPreventSleep(prevent: boolean): void;
+    /**
+     * True when the actor is explicitly blocking automatic sleep.
+     *
+     * @experimental
+     */
+    get preventSleep(): boolean;
+    /**
+     * Prevents the actor from sleeping while the given promise is running.
      *
      * Returns the resolved value and resets the sleep timer on completion.
      * Errors are propagated to the caller.
+     *
+     * @deprecated Use `c.setPreventSleep(true)` while work is active, or move
+     * shutdown and flush work to `onSleep` if it can wait until the actor is
+     * sleeping.
      */
     keepAwake<T>(promise: Promise<T>): Promise<T>;
     /**
@@ -553,79 +730,78 @@ declare class WebSocketContext<TState, TConnParams, TConnState, TVars, TInput, T
     readonly request: Request | undefined;
 }
 
-/** Data that's been serialized. */
-type OutputData = string | Uint8Array;
-declare const EncodingSchema: z.ZodEnum<{
-    json: "json";
-    cbor: "cbor";
-    bare: "bare";
-}>;
-/**
- * Encoding used to communicate between the client & actor.
- */
-type Encoding = z.infer<typeof EncodingSchema>;
-/**
- * Helper class that helps serialize data without re-serializing for the same encoding.
- */
-declare class CachedSerializer<TBare, TJson, T = TBare> {
-    #private;
-    constructor(data: T, versionedDataHandler: VersionedDataHandler<TBare>, version: number, zodSchema: z.ZodType<TJson>, toJson: (value: T) => TJson, toBare: (value: T) => TBare);
-    get rawData(): T;
-    serialize(encoding: Encoding): OutputData;
+type ManagerDriverBuilder = (config: RegistryConfig) => ManagerDriver;
+interface ManagerDriver {
+    getForId(input: GetForIdInput): Promise<ActorOutput | undefined>;
+    getWithKey(input: GetWithKeyInput): Promise<ActorOutput | undefined>;
+    getOrCreateWithKey(input: GetOrCreateWithKeyInput): Promise<ActorOutput>;
+    createActor(input: CreateInput): Promise<ActorOutput>;
+    listActors(input: ListActorsInput): Promise<ActorOutput[]>;
+    sendRequest(actorId: string, actorRequest: Request): Promise<Response>;
+    openWebSocket(path: string, actorId: string, encoding: Encoding, params: unknown): Promise<UniversalWebSocket>;
+    proxyRequest(c: Context, actorRequest: Request, actorId: string): Promise<Response>;
+    proxyWebSocket(c: Context, path: string, actorId: string, encoding: Encoding, params: unknown): Promise<Response>;
+    /**
+     * Build a public gateway URL for a specific actor.
+     *
+     * This lives on the driver because the base endpoint varies by runtime.
+     */
+    buildGatewayUrl(actorId: string): Promise<string>;
+    displayInformation(): ManagerDisplayInformation;
+    extraStartupLog?: () => Record<string, unknown>;
+    modifyManagerRouter?: (config: RegistryConfig, router: Hono) => void;
+    /**
+     * Allows lazily setting getUpgradeWebSocket after the manager router has
+     * been initialized.
+     **/
+    setGetUpgradeWebSocket(getUpgradeWebSocket: GetUpgradeWebSocket): void;
+    /** Read a key. Returns null if the key doesn't exist. */
+    kvGet(actorId: string, key: Uint8Array): Promise<string | null>;
+}
+interface ManagerDisplayInformation {
+    properties: Record<string, string>;
+}
+interface GetForIdInput<E extends Env = any> {
+    c?: Context | undefined;
+    name: string;
+    actorId: string;
+}
+interface GetWithKeyInput<E extends Env = any> {
+    c?: Context | undefined;
+    name: string;
+    key: ActorKey;
+}
+interface GetOrCreateWithKeyInput<E extends Env = any> {
+    c?: Context | undefined;
+    name: string;
+    key: ActorKey;
+    input?: unknown;
+    region?: string;
+}
+interface CreateInput<E extends Env = any> {
+    c?: Context | undefined;
+    name: string;
+    key: ActorKey;
+    input?: unknown;
+    region?: string;
+}
+interface ListActorsInput<E extends Env = any> {
+    c?: Context | undefined;
+    name: string;
+    key?: string;
+    includeDestroyed?: boolean;
+}
+interface ActorOutput {
+    actorId: string;
+    name: string;
+    key: ActorKey;
+    createTs?: number;
+    startTs?: number | null;
+    connectableTs?: number | null;
+    sleepTs?: number | null;
+    destroyTs?: number | null;
+    error?: unknown;
 }
-
-type UpgradeWebSocket = (createEvents: (c: Context) => any) => Handler;
-type GetUpgradeWebSocket = () => UpgradeWebSocket;
-
-declare const KEYS: {
-    PERSIST_DATA: Uint8Array<ArrayBuffer>;
-    CONN_PREFIX: Uint8Array<ArrayBuffer>;
-    INSPECTOR_TOKEN: Uint8Array<ArrayBuffer>;
-    KV: Uint8Array<ArrayBuffer>;
-    QUEUE_PREFIX: Uint8Array<ArrayBuffer>;
-    WORKFLOW_PREFIX: Uint8Array<ArrayBuffer>;
-    TRACES_PREFIX: Uint8Array<ArrayBuffer>;
-    SQLITE_PREFIX: Uint8Array<ArrayBuffer>;
-};
-
-declare const ActorKeySchema: z.ZodArray<z.ZodString>;
-type ActorKey = z.infer<typeof ActorKeySchema>;
-declare const CreateRequestSchema: z.ZodObject<{
-    name: z.ZodString;
-    key: z.ZodArray<z.ZodString>;
-    input: z.ZodOptional<z.ZodUnknown>;
-    region: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-declare const ActorQuerySchema: z.ZodUnion<readonly [z.ZodObject<{
-    getForId: z.ZodObject<{
-        name: z.ZodString;
-        actorId: z.ZodString;
-    }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    getForKey: z.ZodObject<{
-        name: z.ZodString;
-        key: z.ZodArray<z.ZodString>;
-    }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    getOrCreateForKey: z.ZodObject<{
-        name: z.ZodString;
-        key: z.ZodArray<z.ZodString>;
-        input: z.ZodOptional<z.ZodUnknown>;
-        region: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    create: z.ZodObject<{
-        name: z.ZodString;
-        key: z.ZodArray<z.ZodString>;
-        input: z.ZodOptional<z.ZodUnknown>;
-        region: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-}, z.core.$strip>]>;
-type ActorQuery = z.infer<typeof ActorQuerySchema>;
-/**
- * Interface representing a request to create a actor.
- */
-type CreateRequest = z.infer<typeof CreateRequestSchema>;
 
 interface ActorInspectorEmitterEvents {
     stateUpdated: (state: unknown) => void;
@@ -661,6 +837,8 @@ declare class ActorInspector {
     executeAction(name: string, params: ArrayBuffer): Promise<ArrayBuffer>;
     getStateJson(): unknown;
     setStateJson(state: unknown): Promise<void>;
+    getDatabaseSchemaJson(): Promise<unknown>;
+    getDatabaseTableRowsJson(table: string, limit: number, offset: number): Promise<unknown[]>;
     getConnectionsJson(): {
         id: string;
         details: unknown;
@@ -981,6 +1159,7 @@ declare class ActorInstance<S, CP, CS, V, I, DB extends AnyDatabaseProvider, E e
     get inspector(): ActorInspector;
     get traces(): Traces<OtlpExportTraceServiceRequestJson>;
     get inspectorToken(): string | undefined;
+    get metrics(): ActorMetrics;
     getCurrentTraceSpan(): SpanHandle | null;
     startTraceSpan(name: string, attributes?: Record<string, unknown>): SpanHandle;
     endTraceSpan(handle: SpanHandle, status?: SpanStatusInput): void;
@@ -989,6 +1168,7 @@ declare class ActorInstance<S, CP, CS, V, I, DB extends AnyDatabaseProvider, E e
     get conns(): Map<ConnId, Conn<S, CP, CS, V, I, DB, E, Q>>;
     get schedule(): Schedule;
     get abortSignal(): AbortSignal;
+    get preventSleep(): boolean;
     get actions(): string[];
     get config(): ActorConfig<S, CP, CS, V, I, DB, E, Q>;
     get persist(): PersistedActor<S, I>;
@@ -1041,6 +1221,7 @@ declare class ActorInstance<S, CP, CS, V, I, DB extends AnyDatabaseProvider, E e
      * Errors are propagated to the caller.
      */
     keepAwake<T>(promise: Promise<T>): Promise<T>;
+    setPreventSleep(prevent: boolean): void;
     beginQueueWait(): void;
     endQueueWait(): void;
     resetSleepTimer(): void;
@@ -1305,19 +1486,24 @@ interface BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatab
      * - Custom workflow logic
      *
      * **Important:** The actor may go to sleep at any time during the `run`
-     * handler. Use `c.keepAwake(promise)` to wrap async operations that should
-     * not be interrupted by sleep.
+     * handler. Use `c.setPreventSleep(true)` while work is active, then clear
+     * it with `c.setPreventSleep(false)` once the actor can sleep again.
      *
      * The handler receives an abort signal via `c.abortSignal` and a
      * `c.aborted` alias for loop checks. Use these to gracefully exit.
      *
-     * If this handler exits or throws, the actor will crash and reschedule.
+     * If this handler exits, the actor will follow the normal idle sleep timeout
+     * once it becomes idle.
+     * If this handler throws, the actor logs the error and then sleeps once it
+     * becomes idle.
+     * Call `c.destroy()` explicitly if a run handler should destroy the actor.
+     *
      * On shutdown, the actor waits for this handler to complete with a
      * configurable timeout (options.runStopTimeout, default 15s).
      *
      * Can be either a function or a RunConfig object with optional name/icon metadata.
      *
-     * @returns Void or a Promise. If the promise exits, the actor crashes.
+     * @returns Void or a Promise.
      */
     run?: ((c: RunContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>) => void | Promise<void>) | RunConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
     /**
@@ -1417,346 +1603,6 @@ type ActorDatabaseConfig<TDatabase extends AnyDatabaseProvider> = {
 } | Record<never, never>;
 type ActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = Omit<z.infer<typeof ActorConfigSchema>, "actions" | "events" | "queues" | "onCreate" | "onDestroy" | "onWake" | "onSleep" | "run" | "onStateChange" | "onBeforeConnect" | "onConnect" | "onDisconnect" | "onBeforeActionResponse" | "onRequest" | "onWebSocket" | "state" | "createState" | "connState" | "createConnState" | "vars" | "createVars" | "db"> & BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues, Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>> & CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues> & CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues> & CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues> & ActorDatabaseConfig<TDatabase>;
 
-type ManagerDriverBuilder = (config: RegistryConfig) => ManagerDriver;
-interface ManagerDriver {
-    getForId(input: GetForIdInput): Promise<ActorOutput | undefined>;
-    getWithKey(input: GetWithKeyInput): Promise<ActorOutput | undefined>;
-    getOrCreateWithKey(input: GetOrCreateWithKeyInput): Promise<ActorOutput>;
-    createActor(input: CreateInput): Promise<ActorOutput>;
-    listActors(input: ListActorsInput): Promise<ActorOutput[]>;
-    sendRequest(actorId: string, actorRequest: Request): Promise<Response>;
-    openWebSocket(path: string, actorId: string, encoding: Encoding, params: unknown): Promise<UniversalWebSocket>;
-    proxyRequest(c: Context, actorRequest: Request, actorId: string): Promise<Response>;
-    proxyWebSocket(c: Context, path: string, actorId: string, encoding: Encoding, params: unknown): Promise<Response>;
-    /**
-     * Build a public gateway URL for a specific actor.
-     *
-     * This lives on the driver because the base endpoint varies by runtime.
-     */
-    buildGatewayUrl(actorId: string): Promise<string>;
-    displayInformation(): ManagerDisplayInformation;
-    extraStartupLog?: () => Record<string, unknown>;
-    modifyManagerRouter?: (config: RegistryConfig, router: Hono) => void;
-    /**
-     * Allows lazily setting getUpgradeWebSocket after the manager router has
-     * been initialized.
-     **/
-    setGetUpgradeWebSocket(getUpgradeWebSocket: GetUpgradeWebSocket): void;
-    /** Read a key. Returns null if the key doesn't exist. */
-    kvGet(actorId: string, key: Uint8Array): Promise<string | null>;
-}
-interface ManagerDisplayInformation {
-    properties: Record<string, string>;
-}
-interface GetForIdInput<E extends Env = any> {
-    c?: Context | undefined;
-    name: string;
-    actorId: string;
-}
-interface GetWithKeyInput<E extends Env = any> {
-    c?: Context | undefined;
-    name: string;
-    key: ActorKey;
-}
-interface GetOrCreateWithKeyInput<E extends Env = any> {
-    c?: Context | undefined;
-    name: string;
-    key: ActorKey;
-    input?: unknown;
-    region?: string;
-}
-interface CreateInput<E extends Env = any> {
-    c?: Context | undefined;
-    name: string;
-    key: ActorKey;
-    input?: unknown;
-    region?: string;
-}
-interface ListActorsInput<E extends Env = any> {
-    c?: Context | undefined;
-    name: string;
-    key?: string;
-    includeDestroyed?: boolean;
-}
-interface ActorOutput {
-    actorId: string;
-    name: string;
-    key: ActorKey;
-    createTs?: number;
-    startTs?: number | null;
-    connectableTs?: number | null;
-    sleepTs?: number | null;
-    destroyTs?: number | null;
-    error?: unknown;
-}
-
-type ActorDriverBuilder = (config: RegistryConfig, managerDriver: ManagerDriver, inlineClient: AnyClient) => ActorDriver;
-interface ActorDriver {
-    loadActor(actorId: string): Promise<AnyActorInstance>;
-    getContext(actorId: string): unknown;
-    /** Batch write multiple key-value pairs. Keys and values are Uint8Arrays. */
-    kvBatchPut(actorId: string, entries: [Uint8Array, Uint8Array][]): Promise<void>;
-    /** Batch read multiple keys. Returns null for keys that don't exist. */
-    kvBatchGet(actorId: string, keys: Uint8Array[]): Promise<(Uint8Array | null)[]>;
-    /** Batch delete multiple keys. */
-    kvBatchDelete(actorId: string, keys: Uint8Array[]): Promise<void>;
-    /** List all keys with a given prefix. */
-    kvListPrefix(actorId: string, prefix: Uint8Array): Promise<[Uint8Array, Uint8Array][]>;
-    /** ActorInstance ensure that only one instance of setAlarm is called in parallel at a time. */
-    setAlarm(actor: AnyActorInstance, timestamp: number): Promise<void>;
-    /**
-     * Override the default raw database client for the actor.
-     * If not provided, rivetkit will construct a KV-backed SQLite client.
-     * @experimental
-     */
-    overrideRawDatabaseClient?(actorId: string): Promise<RawDatabaseClient | undefined>;
-    /**
-     * Override the default Drizzle database client for the actor.
-     * If not provided, rivetkit will construct a KV-backed Drizzle client.
-     * @experimental
-     */
-    overrideDrizzleDatabaseClient?(actorId: string): Promise<BaseSQLiteDatabase<any, any, any, any> | undefined>;
-    /**
-     * Creates a SQLite VFS instance for creating KV-backed databases.
-     * If not provided, the database provider will need an override.
-     *
-     * @rivetkit/sqlite's async build is not re-entrant per module instance. Drivers
-     * should return a new instance per call for actor-level isolation.
-     *
-     * This is a method (not a property) so drivers can use dynamic imports,
-     * keeping the core driver tree-shakeable from @rivetkit/sqlite.
-     */
-    createSqliteVfs?(): SqliteVfs | Promise<SqliteVfs>;
-    /**
-     * Requests the actor to go to sleep.
-     *
-     * This will call `ActorInstance.onStop` independently.
-     */
-    startSleep?(actorId: string): void;
-    /**
-     * Destroys the actor and its associated data.
-     *
-     * This will call `ActorInstance.onStop` independently.
-     */
-    startDestroy(actorId: string): void;
-    /**
-     * Shuts down the actor runner.
-     */
-    shutdownRunner?(immediate: boolean): Promise<void>;
-    /** This handles the serverless start request. This should manage the lifecycle of the runner tied to the request lifecycle. */
-    serverlessHandleStart?(c: Context): Promise<Response>;
-    /** Extra properties to add to logs for each actor. */
-    getExtraActorLogParams?(): Record<string, string>;
-    onBeforeActorStart?(actor: AnyActorInstance): Promise<void>;
-    onCreateConn?(conn: AnyConn): void;
-    onDestroyConn?(conn: AnyConn): void;
-    onBeforePersistConn?(conn: AnyConn): void;
-    onAfterPersistConn?(conn: AnyConn): void;
-}
-
-declare const ActorsSchema: z$1.ZodRecord<z$1.ZodString, z$1.ZodCustom<ActorDefinition<any, any, any, any, any, any, any, any, any>, ActorDefinition<any, any, any, any, any, any, any, any, any>>>;
-type RegistryActors = z$1.infer<typeof ActorsSchema>;
-declare const RegistryConfigSchema: z$1.ZodPipe<z$1.ZodObject<{
-    use: z$1.ZodRecord<z$1.ZodString, z$1.ZodCustom<AnyActorDefinition, AnyActorDefinition>>;
-    test: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodObject<{
-        enabled: z$1.ZodBoolean;
-    }, z$1.core.$strip>>>;
-    driver: z$1.ZodOptional<z$1.ZodObject<{
-        name: z$1.ZodString;
-        displayName: z$1.ZodString;
-        manager: z$1.ZodCustom<ManagerDriverBuilder, ManagerDriverBuilder>;
-        actor: z$1.ZodCustom<ActorDriverBuilder, ActorDriverBuilder>;
-        autoStartActorDriver: z$1.ZodBoolean;
-    }, z$1.core.$strip>>;
-    storagePath: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string | undefined, string | undefined>>;
-    maxIncomingMessageSize: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodNumber>>;
-    maxOutgoingMessageSize: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodNumber>>;
-    noWelcome: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodBoolean>>;
-    logging: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodObject<{
-        baseLogger: z$1.ZodOptional<z$1.ZodCustom<Logger, Logger>>;
-        level: z$1.ZodOptional<z$1.ZodEnum<{
-            error: "error";
-            trace: "trace";
-            fatal: "fatal";
-            warn: "warn";
-            info: "info";
-            debug: "debug";
-            silent: "silent";
-        }>>;
-    }, z$1.core.$strip>>>;
-    endpoint: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string | undefined, string | undefined>>;
-    token: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string | undefined, string | undefined>>;
-    namespace: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string | undefined, string | undefined>>;
-    headers: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>>;
-    serveManager: z$1.ZodOptional<z$1.ZodBoolean>;
-    managerBasePath: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodString>>;
-    managerPort: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodNumber>>;
-    managerHost: z$1.ZodOptional<z$1.ZodString>;
-    inspector: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodObject<{
-        enabled: z$1.ZodDefault<z$1.ZodBoolean>;
-        token: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodCustom<() => string, () => string>>>;
-        defaultEndpoint: z$1.ZodOptional<z$1.ZodString>;
-    }, z$1.core.$strip>>>;
-    serverless: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodObject<{
-        spawnEngine: z$1.ZodDefault<z$1.ZodBoolean>;
-        engineVersion: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodString>>;
-        configureRunnerPool: z$1.ZodOptional<z$1.ZodOptional<z$1.ZodObject<{
-            name: z$1.ZodOptional<z$1.ZodString>;
-            url: z$1.ZodString;
-            headers: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>;
-            maxRunners: z$1.ZodOptional<z$1.ZodNumber>;
-            minRunners: z$1.ZodOptional<z$1.ZodNumber>;
-            requestLifespan: z$1.ZodOptional<z$1.ZodNumber>;
-            runnersMargin: z$1.ZodOptional<z$1.ZodNumber>;
-            slotsPerRunner: z$1.ZodOptional<z$1.ZodNumber>;
-            metadata: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodUnknown>>;
-            metadataPollInterval: z$1.ZodOptional<z$1.ZodNumber>;
-            drainOnVersionUpgrade: z$1.ZodOptional<z$1.ZodBoolean>;
-        }, z$1.core.$strip>>>;
-        basePath: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodString>>;
-        publicEndpoint: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string | undefined, string | undefined>>;
-        publicToken: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string | undefined, string | undefined>>;
-    }, z$1.core.$strip>>>;
-    runner: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodObject<{
-        totalSlots: z$1.ZodDefault<z$1.ZodNumber>;
-        runnerName: z$1.ZodDefault<z$1.ZodString>;
-        runnerKey: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string | undefined, string | undefined>>;
-        version: z$1.ZodDefault<z$1.ZodNumber>;
-    }, z$1.core.$strip>>>;
-}, z$1.core.$strip>, z$1.ZodTransform<{
-    endpoint: string | undefined;
-    namespace: string;
-    token: string | undefined;
-    serveManager: boolean;
-    publicEndpoint: string | undefined;
-    publicNamespace: string | undefined;
-    publicToken: string | undefined;
-    inspector: {
-        enabled: boolean;
-        token: () => string;
-        defaultEndpoint?: string | undefined;
-    } | {
-        enabled: {
-            manager: boolean;
-            actor: boolean;
-        };
-        token: () => string;
-        defaultEndpoint?: string | undefined;
-    };
-    serverless: {
-        publicEndpoint: string | undefined;
-        spawnEngine: boolean;
-        engineVersion: string;
-        basePath: string;
-        publicToken: string | undefined;
-        configureRunnerPool?: {
-            url: string;
-            name?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxRunners?: number | undefined;
-            minRunners?: number | undefined;
-            requestLifespan?: number | undefined;
-            runnersMargin?: number | undefined;
-            slotsPerRunner?: number | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            metadataPollInterval?: number | undefined;
-            drainOnVersionUpgrade?: boolean | undefined;
-        } | undefined;
-    };
-    use: Record<string, AnyActorDefinition>;
-    test: {
-        enabled: boolean;
-    };
-    storagePath: string | undefined;
-    maxIncomingMessageSize: number;
-    maxOutgoingMessageSize: number;
-    noWelcome: boolean;
-    logging: {
-        baseLogger?: Logger | undefined;
-        level?: "error" | "trace" | "fatal" | "warn" | "info" | "debug" | "silent" | undefined;
-    };
-    headers: Record<string, string>;
-    managerBasePath: string;
-    managerPort: number;
-    runner: {
-        totalSlots: number;
-        runnerName: string;
-        runnerKey: string | undefined;
-        version: number;
-    };
-    driver?: {
-        name: string;
-        displayName: string;
-        manager: ManagerDriverBuilder;
-        actor: ActorDriverBuilder;
-        autoStartActorDriver: boolean;
-    } | undefined;
-    managerHost?: string | undefined;
-}, {
-    use: Record<string, AnyActorDefinition>;
-    test: {
-        enabled: boolean;
-    };
-    storagePath: string | undefined;
-    maxIncomingMessageSize: number;
-    maxOutgoingMessageSize: number;
-    noWelcome: boolean;
-    logging: {
-        baseLogger?: Logger | undefined;
-        level?: "error" | "trace" | "fatal" | "warn" | "info" | "debug" | "silent" | undefined;
-    };
-    endpoint: string | undefined;
-    token: string | undefined;
-    namespace: string | undefined;
-    headers: Record<string, string>;
-    managerBasePath: string;
-    managerPort: number;
-    inspector: {
-        enabled: boolean;
-        token: () => string;
-        defaultEndpoint?: string | undefined;
-    };
-    serverless: {
-        spawnEngine: boolean;
-        engineVersion: string;
-        basePath: string;
-        publicEndpoint: string | undefined;
-        publicToken: string | undefined;
-        configureRunnerPool?: {
-            url: string;
-            name?: string | undefined;
-            headers?: Record<string, string> | undefined;
-            maxRunners?: number | undefined;
-            minRunners?: number | undefined;
-            requestLifespan?: number | undefined;
-            runnersMargin?: number | undefined;
-            slotsPerRunner?: number | undefined;
-            metadata?: Record<string, unknown> | undefined;
-            metadataPollInterval?: number | undefined;
-            drainOnVersionUpgrade?: boolean | undefined;
-        } | undefined;
-    };
-    runner: {
-        totalSlots: number;
-        runnerName: string;
-        runnerKey: string | undefined;
-        version: number;
-    };
-    driver?: {
-        name: string;
-        displayName: string;
-        manager: ManagerDriverBuilder;
-        actor: ActorDriverBuilder;
-        autoStartActorDriver: boolean;
-    } | undefined;
-    serveManager?: boolean | undefined;
-    managerHost?: string | undefined;
-}>>;
-type RegistryConfig = z$1.infer<typeof RegistryConfigSchema>;
-type RegistryConfigInput<A extends RegistryActors> = Omit<z$1.input<typeof RegistryConfigSchema>, "use"> & {
-    use: A;
-};
-
 type AnyActorDefinition = ActorDefinition<any, any, any, any, any, any, any, any, any>;
 declare class ActorDefinition<S, CP, CS, V, I, DB extends AnyDatabaseProvider, E extends EventSchemaConfig = Record<never, never>, Q extends QueueSchemaConfig = Record<never, never>, R extends Actions<S, CP, CS, V, I, DB, E, Q> = Actions<S, CP, CS, V, I, DB, E, Q>> {
     #private;
@@ -1765,6 +1611,21 @@ declare class ActorDefinition<S, CP, CS, V, I, DB extends AnyDatabaseProvider, E
     instantiate(): ActorInstance<S, CP, CS, V, I, DB, E, Q>;
 }
 
+interface QueueSendWaitOptions {
+    wait: true;
+    timeout?: number;
+    signal?: AbortSignal;
+}
+interface QueueSendNoWaitOptions {
+    wait?: false;
+    timeout?: never;
+    signal?: AbortSignal;
+}
+interface QueueSendResult<TResponse = unknown> {
+    status: "completed" | "timedOut";
+    response?: TResponse;
+}
+
 /**
  * Action function returned by Actor connections and handles.
  *
@@ -1781,6 +1642,23 @@ type ActorActionFunction<Args extends Array<unknown> = unknown[], Response = unk
 type ActorDefinitionActions<AD extends AnyActorDefinition> = AD extends ActorDefinition<any, any, any, any, any, any, any, any, infer R> ? {
     [K in keyof R]: R[K] extends (...args: infer Args) => infer Return ? ActorActionFunction<Args, Return> : never;
 } : never;
+type ActorQueueSend<TQueues extends QueueSchemaConfig> = {
+    <K extends keyof TQueues & string>(name: K, body: InferSchemaMap<TQueues>[K], options: QueueSendWaitOptions): Promise<QueueSendResult<InferQueueCompleteMap<TQueues>[K]>>;
+    <K extends keyof TQueues & string>(name: K, body: InferSchemaMap<TQueues>[K], options?: QueueSendNoWaitOptions): Promise<void>;
+    (name: keyof TQueues extends never ? string : never, body: unknown, options: QueueSendWaitOptions): Promise<QueueSendResult>;
+    (name: keyof TQueues extends never ? string : never, body: unknown, options?: QueueSendNoWaitOptions): Promise<void>;
+};
+type ActorEventSubscribe<TEvents extends EventSchemaConfig> = {
+    <K extends keyof TEvents & string>(eventName: K, callback: (...args: InferEventArgs<InferSchemaMap<TEvents>[K]>) => void): () => void;
+    (eventName: keyof TEvents extends never ? string : never, callback: (...args: any[]) => void): () => void;
+};
+type ActorDefinitionQueueSend<AD extends AnyActorDefinition> = AD extends ActorDefinition<any, any, any, any, any, any, any, infer Q, any> ? Q extends QueueSchemaConfig ? {
+    send: ActorQueueSend<Q>;
+} : never : never;
+type ActorDefinitionEventSubscriptions<AD extends AnyActorDefinition> = AD extends ActorDefinition<any, any, any, any, any, any, infer E, any, any> ? E extends EventSchemaConfig ? {
+    on: ActorEventSubscribe<E>;
+    once: ActorEventSubscribe<E>;
+} : never : never;
 
 declare class ActorClientError extends Error {
 }
@@ -1803,21 +1681,6 @@ declare class ActorConnDisposed extends ActorClientError {
     constructor();
 }
 
-interface QueueSendWaitOptions {
-    wait: true;
-    timeout?: number;
-    signal?: AbortSignal;
-}
-interface QueueSendNoWaitOptions {
-    wait?: false;
-    timeout?: never;
-    signal?: AbortSignal;
-}
-interface QueueSendResult {
-    status: "completed" | "timedOut";
-    response?: unknown;
-}
-
 /**
  * Connection status for an actor connection.
  *
@@ -1866,7 +1729,7 @@ declare class ActorConnRaw {
      *
      * @protected
      */
-    constructor(client: ClientRaw, driver: ManagerDriver, params: unknown, encoding: Encoding, actorQuery: ActorQuery);
+    constructor(client: ClientRaw, driver: ManagerDriver, params: unknown, getParams: (() => Promise<unknown>) | undefined, encoding: Encoding, actorQuery: ActorQuery);
     send(name: string, body: unknown, options: QueueSendWaitOptions): Promise<QueueSendResult>;
     send(name: string, body: unknown, options?: QueueSendNoWaitOptions): Promise<void>;
     /**
@@ -1981,7 +1844,7 @@ declare class ActorConnRaw {
  * @template AD The actor class that this connection is for.
  * @see {@link ActorConnRaw}
  */
-type ActorConn<AD extends AnyActorDefinition> = ActorConnRaw & ActorDefinitionActions<AD>;
+type ActorConn<AD extends AnyActorDefinition> = Omit<ActorConnRaw, "send" | "on" | "once"> & ActorDefinitionQueueSend<AD> & ActorDefinitionEventSubscriptions<AD> & ActorDefinitionActions<AD>;
 
 /**
  * Provides underlying functions for stateless {@link ActorHandle} for action calls.
@@ -1998,7 +1861,7 @@ declare class ActorHandleRaw {
      *
      * @protected
      */
-    constructor(client: any, driver: ManagerDriver, params: unknown, encoding: Encoding, actorQuery: ActorQuery);
+    constructor(client: any, driver: ManagerDriver, params: unknown, getParams: (() => Promise<unknown>) | undefined, encoding: Encoding, actorQuery: ActorQuery);
     send(name: string, body: unknown, options: QueueSendWaitOptions): Promise<QueueSendResult>;
     send(name: string, body: unknown, options?: QueueSendNoWaitOptions): Promise<void>;
     /**
@@ -2054,26 +1917,26 @@ declare class ActorHandleRaw {
  * @template AD The actor class that this handle is for.
  * @see {@link ActorHandleRaw}
  */
-type ActorHandle<AD extends AnyActorDefinition> = Omit<ActorHandleRaw, "connect"> & {
+type ActorHandle<AD extends AnyActorDefinition> = Omit<ActorHandleRaw, "connect" | "send"> & {
     connect(): ActorConn<AD>;
     resolve(): Promise<string>;
-} & ActorDefinitionActions<AD>;
+} & ActorDefinitionQueueSend<AD> & ActorDefinitionActions<AD>;
 
-declare const ClientConfigSchema: z$2.ZodPipe<z$2.ZodObject<{
-    endpoint: z$2.ZodPipe<z$2.ZodOptional<z$2.ZodString>, z$2.ZodTransform<string, string | undefined>>;
-    token: z$2.ZodPipe<z$2.ZodOptional<z$2.ZodString>, z$2.ZodTransform<string | undefined, string | undefined>>;
-    namespace: z$2.ZodPipe<z$2.ZodOptional<z$2.ZodString>, z$2.ZodTransform<string | undefined, string | undefined>>;
-    runnerName: z$2.ZodDefault<z$2.ZodString>;
-    encoding: z$2.ZodDefault<z$2.ZodEnum<{
+declare const ClientConfigSchema: z$1.ZodPipe<z$1.ZodObject<{
+    endpoint: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string, string | undefined>>;
+    token: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string | undefined, string | undefined>>;
+    namespace: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string | undefined, string | undefined>>;
+    runnerName: z$1.ZodDefault<z$1.ZodString>;
+    encoding: z$1.ZodDefault<z$1.ZodEnum<{
         json: "json";
         cbor: "cbor";
         bare: "bare";
     }>>;
-    headers: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodRecord<z$2.ZodString, z$2.ZodString>>>;
-    getUpgradeWebSocket: z$2.ZodOptional<z$2.ZodCustom<GetUpgradeWebSocket, GetUpgradeWebSocket>>;
-    disableMetadataLookup: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodBoolean>>;
-    devtools: z$2.ZodDefault<z$2.ZodBoolean>;
-}, z$2.core.$strip>, z$2.ZodTransform<{
+    headers: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>>;
+    getUpgradeWebSocket: z$1.ZodOptional<z$1.ZodCustom<GetUpgradeWebSocket, GetUpgradeWebSocket>>;
+    disableMetadataLookup: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodBoolean>>;
+    devtools: z$1.ZodDefault<z$1.ZodBoolean>;
+}, z$1.core.$strip>, z$1.ZodTransform<{
     endpoint: string | undefined;
     namespace: string;
     token: string | undefined;
@@ -2094,7 +1957,7 @@ declare const ClientConfigSchema: z$2.ZodPipe<z$2.ZodObject<{
     devtools: boolean;
     getUpgradeWebSocket?: GetUpgradeWebSocket | undefined;
 }>>;
-type ClientConfigInput = z$2.input<typeof ClientConfigSchema>;
+type ClientConfigInput = z$1.input<typeof ClientConfigSchema>;
 
 /** Extract the actor registry from the registry definition. */
 type ExtractActorsFromRegistry<A extends Registry<any>> = A extends Registry<infer Actors> ? Actors : never;
@@ -2152,6 +2015,11 @@ interface ActorAccessor<AD extends AnyActorDefinition> {
 interface QueryOptions {
     /** Parameters to pass to the connection. */
     params?: unknown;
+    /**
+     * Lazily resolves connection parameters for `.connect()` and `.webSocket()`.
+     * This is called each time a new connection is opened.
+     */
+    getParams?: () => Promise<unknown>;
     /** Signal to abort the request. */
     signal?: AbortSignal;
 }
@@ -2282,34 +2150,104 @@ type Client<A extends Registry<any>> = ClientRaw & {
 };
 type AnyClient = Client<Registry<any>>;
 
-declare const LegacyRunnerConfigSchema: z.ZodDefault<z.ZodPipe<z.ZodObject<{
-    driver: z.ZodOptional<z.ZodObject<{
-        name: z.ZodString;
-        manager: z.ZodCustom<ManagerDriverBuilder, ManagerDriverBuilder>;
-        actor: z.ZodCustom<ActorDriverBuilder, ActorDriverBuilder>;
-    }, z.core.$strip>>;
-    maxIncomingMessageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    maxOutgoingMessageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    inspector: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        token: z.ZodDefault<z.ZodOptional<z.ZodCustom<() => string, () => string>>>;
-        defaultEndpoint: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    disableDefaultServer: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    defaultServerPort: z.ZodDefault<z.ZodNumber>;
-    runEngine: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    runEngineVersion: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    overrideServerAddress: z.ZodOptional<z.ZodString>;
-    disableActorDriver: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    runnerKind: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        serverless: "serverless";
-        normal: "normal";
-    }>>>;
-    basePath: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    noWelcome: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    logging: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        baseLogger: z.ZodOptional<z.ZodCustom<Logger, Logger>>;
-        level: z.ZodOptional<z.ZodEnum<{
+type ActorDriverBuilder = (config: RegistryConfig, managerDriver: ManagerDriver, inlineClient: AnyClient) => ActorDriver;
+interface ActorDriver {
+    loadActor(actorId: string): Promise<AnyActorInstance>;
+    getContext(actorId: string): unknown;
+    /** Batch write multiple key-value pairs. Keys and values are Uint8Arrays. */
+    kvBatchPut(actorId: string, entries: [Uint8Array, Uint8Array][]): Promise<void>;
+    /** Batch read multiple keys. Returns null for keys that don't exist. */
+    kvBatchGet(actorId: string, keys: Uint8Array[]): Promise<(Uint8Array | null)[]>;
+    /** Batch delete multiple keys. */
+    kvBatchDelete(actorId: string, keys: Uint8Array[]): Promise<void>;
+    /** Delete all keys in the half-open range [start, end). */
+    kvDeleteRange(actorId: string, start: Uint8Array, end: Uint8Array): Promise<void>;
+    /** List all keys with a given prefix. */
+    kvListPrefix(actorId: string, prefix: Uint8Array, options?: {
+        reverse?: boolean;
+        limit?: number;
+    }): Promise<[Uint8Array, Uint8Array][]>;
+    /** List all keys in the half-open range [start, end). */
+    kvListRange(actorId: string, start: Uint8Array, end: Uint8Array, options?: {
+        reverse?: boolean;
+        limit?: number;
+    }): Promise<[Uint8Array, Uint8Array][]>;
+    /** ActorInstance ensure that only one instance of setAlarm is called in parallel at a time. */
+    setAlarm(actor: AnyActorInstance, timestamp: number): Promise<void>;
+    /**
+     * Override the default raw database client for the actor.
+     * If not provided, rivetkit will construct a KV-backed SQLite client.
+     * @experimental
+     */
+    overrideRawDatabaseClient?(actorId: string): Promise<RawDatabaseClient | undefined>;
+    /**
+     * Override the default Drizzle database client for the actor.
+     * If not provided, rivetkit will construct a KV-backed Drizzle client.
+     * @experimental
+     */
+    overrideDrizzleDatabaseClient?(actorId: string): Promise<BaseSQLiteDatabase<any, any, any, any> | undefined>;
+    /**
+     * Creates a SQLite VFS instance for creating KV-backed databases.
+     * If not provided, the database provider will need an override.
+     *
+     * Drivers may use the actorId for pool-based instance assignment.
+     *
+     * This is a method (not a property) so drivers can use dynamic imports,
+     * keeping the core driver tree-shakeable from @rivetkit/sqlite.
+     */
+    createSqliteVfs?(actorId: string): ISqliteVfs | Promise<ISqliteVfs>;
+    /**
+     * Requests the actor to go to sleep.
+     *
+     * This will call `ActorInstance.onStop` independently.
+     */
+    startSleep?(actorId: string): void;
+    /**
+     * Destroys the actor and its associated data.
+     *
+     * This will call `ActorInstance.onStop` independently.
+     */
+    startDestroy(actorId: string): void;
+    /**
+     * Shuts down the actor runner.
+     */
+    shutdownRunner?(immediate: boolean): Promise<void>;
+    /** This handles the serverless start request. This should manage the lifecycle of the runner tied to the request lifecycle. */
+    serverlessHandleStart?(c: Context): Promise<Response>;
+    /** Extra properties to add to logs for each actor. */
+    getExtraActorLogParams?(): Record<string, string>;
+    onBeforeActorStart?(actor: AnyActorInstance): Promise<void>;
+    onCreateConn?(conn: AnyConn): void;
+    onDestroyConn?(conn: AnyConn): void;
+    onBeforePersistConn?(conn: AnyConn): void;
+    onAfterPersistConn?(conn: AnyConn): void;
+}
+
+declare const ActorsSchema: z$2.ZodRecord<z$2.ZodString, z$2.ZodCustom<ActorDefinition<any, any, any, any, any, any, any, any, any>, ActorDefinition<any, any, any, any, any, any, any, any, any>>>;
+type RegistryActors = z$2.infer<typeof ActorsSchema>;
+declare const RegistryConfigSchema: z$2.ZodPipe<z$2.ZodObject<{
+    use: z$2.ZodRecord<z$2.ZodString, z$2.ZodCustom<AnyActorDefinition, AnyActorDefinition>>;
+    test: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodObject<{
+        enabled: z$2.ZodBoolean;
+    }, z$2.core.$strip>>>;
+    driver: z$2.ZodOptional<z$2.ZodObject<{
+        name: z$2.ZodString;
+        displayName: z$2.ZodString;
+        manager: z$2.ZodCustom<ManagerDriverBuilder, ManagerDriverBuilder>;
+        actor: z$2.ZodCustom<ActorDriverBuilder, ActorDriverBuilder>;
+        autoStartActorDriver: z$2.ZodBoolean;
+    }, z$2.core.$strip>>;
+    storagePath: z$2.ZodPipe<z$2.ZodOptional<z$2.ZodString>, z$2.ZodTransform<string | undefined, string | undefined>>;
+    sqlitePool: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodObject<{
+        actorsPerInstance: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodNumber>>;
+        idleDestroyMs: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodNumber>>;
+    }, z$2.core.$strip>>>;
+    maxIncomingMessageSize: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodNumber>>;
+    maxOutgoingMessageSize: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodNumber>>;
+    noWelcome: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodBoolean>>;
+    logging: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodObject<{
+        baseLogger: z$2.ZodOptional<z$2.ZodCustom<Logger, Logger>>;
+        level: z$2.ZodOptional<z$2.ZodEnum<{
             error: "error";
             trace: "trace";
             fatal: "fatal";
@@ -2318,139 +2256,195 @@ declare const LegacyRunnerConfigSchema: z.ZodDefault<z.ZodPipe<z.ZodObject<{
             debug: "debug";
             silent: "silent";
         }>>;
-    }, z.core.$strip>>>;
-    autoConfigureServerless: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
-        url: z.ZodOptional<z.ZodString>;
-        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        maxRunners: z.ZodOptional<z.ZodNumber>;
-        minRunners: z.ZodOptional<z.ZodNumber>;
-        requestLifespan: z.ZodOptional<z.ZodNumber>;
-        runnersMargin: z.ZodOptional<z.ZodNumber>;
-        slotsPerRunner: z.ZodOptional<z.ZodNumber>;
-        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>]>>;
-    endpoint: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string, string | undefined>>;
-    token: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
-    namespace: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
-    runnerName: z.ZodDefault<z.ZodString>;
-    encoding: z.ZodDefault<z.ZodEnum<{
-        json: "json";
-        cbor: "cbor";
-        bare: "bare";
-    }>>;
-    headers: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
-    getUpgradeWebSocket: z.ZodOptional<z.ZodCustom<GetUpgradeWebSocket, GetUpgradeWebSocket>>;
-    disableMetadataLookup: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    devtools: z.ZodDefault<z.ZodBoolean>;
-    runnerKey: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
-    totalSlots: z.ZodDefault<z.ZodNumber>;
-}, z.core.$strip>, z.ZodTransform<{
-    runnerKey: string | undefined;
+    }, z$2.core.$strip>>>;
+    endpoint: z$2.ZodPipe<z$2.ZodOptional<z$2.ZodString>, z$2.ZodTransform<string | undefined, string | undefined>>;
+    token: z$2.ZodPipe<z$2.ZodOptional<z$2.ZodString>, z$2.ZodTransform<string | undefined, string | undefined>>;
+    namespace: z$2.ZodPipe<z$2.ZodOptional<z$2.ZodString>, z$2.ZodTransform<string | undefined, string | undefined>>;
+    headers: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodRecord<z$2.ZodString, z$2.ZodString>>>;
+    serveManager: z$2.ZodOptional<z$2.ZodBoolean>;
+    publicDir: z$2.ZodOptional<z$2.ZodString>;
+    managerBasePath: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodString>>;
+    managerPort: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodNumber>>;
+    managerHost: z$2.ZodOptional<z$2.ZodString>;
+    inspector: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodObject<{
+        enabled: z$2.ZodDefault<z$2.ZodBoolean>;
+        token: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodCustom<() => string, () => string>>>;
+        defaultEndpoint: z$2.ZodOptional<z$2.ZodString>;
+    }, z$2.core.$strip>>>;
+    serverless: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodObject<{
+        spawnEngine: z$2.ZodDefault<z$2.ZodBoolean>;
+        engineVersion: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodString>>;
+        configureRunnerPool: z$2.ZodOptional<z$2.ZodOptional<z$2.ZodObject<{
+            name: z$2.ZodOptional<z$2.ZodString>;
+            url: z$2.ZodString;
+            headers: z$2.ZodOptional<z$2.ZodRecord<z$2.ZodString, z$2.ZodString>>;
+            maxRunners: z$2.ZodOptional<z$2.ZodNumber>;
+            minRunners: z$2.ZodOptional<z$2.ZodNumber>;
+            requestLifespan: z$2.ZodOptional<z$2.ZodNumber>;
+            runnersMargin: z$2.ZodOptional<z$2.ZodNumber>;
+            slotsPerRunner: z$2.ZodOptional<z$2.ZodNumber>;
+            metadata: z$2.ZodOptional<z$2.ZodRecord<z$2.ZodString, z$2.ZodUnknown>>;
+            metadataPollInterval: z$2.ZodOptional<z$2.ZodNumber>;
+            drainOnVersionUpgrade: z$2.ZodOptional<z$2.ZodBoolean>;
+        }, z$2.core.$strip>>>;
+        basePath: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodString>>;
+        publicEndpoint: z$2.ZodPipe<z$2.ZodOptional<z$2.ZodString>, z$2.ZodTransform<string | undefined, string | undefined>>;
+        publicToken: z$2.ZodPipe<z$2.ZodOptional<z$2.ZodString>, z$2.ZodTransform<string | undefined, string | undefined>>;
+    }, z$2.core.$strip>>>;
+    runner: z$2.ZodDefault<z$2.ZodOptional<z$2.ZodObject<{
+        totalSlots: z$2.ZodDefault<z$2.ZodNumber>;
+        runnerName: z$2.ZodDefault<z$2.ZodString>;
+        runnerKey: z$2.ZodOptional<z$2.ZodString>;
+        version: z$2.ZodDefault<z$2.ZodNumber>;
+    }, z$2.core.$strip>>>;
+}, z$2.core.$strip>, z$2.ZodTransform<{
     endpoint: string | undefined;
     namespace: string;
     token: string | undefined;
-    runnerName: string;
-    encoding: "json" | "cbor" | "bare";
-    headers: Record<string, string>;
-    disableMetadataLookup: boolean;
-    devtools: boolean;
-    getUpgradeWebSocket?: GetUpgradeWebSocket | undefined;
-    maxIncomingMessageSize: number;
-    maxOutgoingMessageSize: number;
+    serveManager: boolean;
+    publicEndpoint: string | undefined;
+    publicNamespace: string | undefined;
+    publicToken: string | undefined;
     inspector: {
         enabled: boolean;
         token: () => string;
         defaultEndpoint?: string | undefined;
+    } | {
+        enabled: {
+            manager: boolean;
+            actor: boolean;
+        };
+        token: () => string;
+        defaultEndpoint?: string | undefined;
     };
-    disableDefaultServer: boolean;
-    defaultServerPort: number;
-    runEngine: boolean;
-    runEngineVersion: string;
-    disableActorDriver: boolean;
-    runnerKind: "serverless" | "normal";
-    basePath: string;
+    serverless: {
+        publicEndpoint: string | undefined;
+        spawnEngine: boolean;
+        engineVersion: string;
+        basePath: string;
+        publicToken: string | undefined;
+        configureRunnerPool?: {
+            url: string;
+            name?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            maxRunners?: number | undefined;
+            minRunners?: number | undefined;
+            requestLifespan?: number | undefined;
+            runnersMargin?: number | undefined;
+            slotsPerRunner?: number | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            metadataPollInterval?: number | undefined;
+            drainOnVersionUpgrade?: boolean | undefined;
+        } | undefined;
+    };
+    use: Record<string, AnyActorDefinition>;
+    test: {
+        enabled: boolean;
+    };
+    storagePath: string | undefined;
+    sqlitePool: {
+        actorsPerInstance: number;
+        idleDestroyMs: number;
+    };
+    maxIncomingMessageSize: number;
+    maxOutgoingMessageSize: number;
     noWelcome: boolean;
     logging: {
         baseLogger?: Logger | undefined;
         level?: "error" | "trace" | "fatal" | "warn" | "info" | "debug" | "silent" | undefined;
     };
-    totalSlots: number;
+    headers: Record<string, string>;
+    managerBasePath: string;
+    managerPort: number;
+    runner: {
+        totalSlots: number;
+        runnerName: string;
+        version: number;
+        runnerKey?: string | undefined;
+    };
     driver?: {
         name: string;
+        displayName: string;
         manager: ManagerDriverBuilder;
         actor: ActorDriverBuilder;
+        autoStartActorDriver: boolean;
     } | undefined;
-    overrideServerAddress?: string | undefined;
-    autoConfigureServerless?: boolean | {
-        url?: string | undefined;
-        headers?: Record<string, string> | undefined;
-        maxRunners?: number | undefined;
-        minRunners?: number | undefined;
-        requestLifespan?: number | undefined;
-        runnersMargin?: number | undefined;
-        slotsPerRunner?: number | undefined;
-        metadata?: Record<string, unknown> | undefined;
-    } | undefined;
+    publicDir?: string | undefined;
+    managerHost?: string | undefined;
 }, {
-    maxIncomingMessageSize: number;
-    maxOutgoingMessageSize: number;
-    inspector: {
+    use: Record<string, AnyActorDefinition>;
+    test: {
         enabled: boolean;
-        token: () => string;
-        defaultEndpoint?: string | undefined;
     };
-    disableDefaultServer: boolean;
-    defaultServerPort: number;
-    runEngine: boolean;
-    runEngineVersion: string;
-    disableActorDriver: boolean;
-    runnerKind: "serverless" | "normal";
-    basePath: string;
+    storagePath: string | undefined;
+    sqlitePool: {
+        actorsPerInstance: number;
+        idleDestroyMs: number;
+    };
+    maxIncomingMessageSize: number;
+    maxOutgoingMessageSize: number;
     noWelcome: boolean;
     logging: {
         baseLogger?: Logger | undefined;
         level?: "error" | "trace" | "fatal" | "warn" | "info" | "debug" | "silent" | undefined;
     };
-    endpoint: string;
+    endpoint: string | undefined;
     token: string | undefined;
     namespace: string | undefined;
-    runnerName: string;
-    encoding: "json" | "cbor" | "bare";
     headers: Record<string, string>;
-    disableMetadataLookup: boolean;
-    devtools: boolean;
-    runnerKey: string | undefined;
-    totalSlots: number;
+    managerBasePath: string;
+    managerPort: number;
+    inspector: {
+        enabled: boolean;
+        token: () => string;
+        defaultEndpoint?: string | undefined;
+    };
+    serverless: {
+        spawnEngine: boolean;
+        engineVersion: string;
+        basePath: string;
+        publicEndpoint: string | undefined;
+        publicToken: string | undefined;
+        configureRunnerPool?: {
+            url: string;
+            name?: string | undefined;
+            headers?: Record<string, string> | undefined;
+            maxRunners?: number | undefined;
+            minRunners?: number | undefined;
+            requestLifespan?: number | undefined;
+            runnersMargin?: number | undefined;
+            slotsPerRunner?: number | undefined;
+            metadata?: Record<string, unknown> | undefined;
+            metadataPollInterval?: number | undefined;
+            drainOnVersionUpgrade?: boolean | undefined;
+        } | undefined;
+    };
+    runner: {
+        totalSlots: number;
+        runnerName: string;
+        version: number;
+        runnerKey?: string | undefined;
+    };
     driver?: {
         name: string;
+        displayName: string;
         manager: ManagerDriverBuilder;
         actor: ActorDriverBuilder;
+        autoStartActorDriver: boolean;
     } | undefined;
-    overrideServerAddress?: string | undefined;
-    autoConfigureServerless?: boolean | {
-        url?: string | undefined;
-        headers?: Record<string, string> | undefined;
-        maxRunners?: number | undefined;
-        minRunners?: number | undefined;
-        requestLifespan?: number | undefined;
-        runnersMargin?: number | undefined;
-        slotsPerRunner?: number | undefined;
-        metadata?: Record<string, unknown> | undefined;
-    } | undefined;
-    getUpgradeWebSocket?: GetUpgradeWebSocket | undefined;
-}>>>;
-type LegacyRunnerConfigInput = z.input<typeof LegacyRunnerConfigSchema>;
+    serveManager?: boolean | undefined;
+    publicDir?: string | undefined;
+    managerHost?: string | undefined;
+}>>;
+type RegistryConfig = z$2.infer<typeof RegistryConfigSchema>;
+type RegistryConfigInput<A extends RegistryActors> = Omit<z$2.input<typeof RegistryConfigSchema>, "use"> & {
+    use: A;
+};
 
 type FetchHandler = (request: Request, ...args: any) => Response | Promise<Response>;
 interface ServerlessHandler {
     fetch: FetchHandler;
 }
-interface LegacyStartServerOutput<A extends Registry<any>> {
-    /** Client to communicate with the actors. */
-    client: Client<A>;
-    /** Fetch handler to manually route requests to the Rivet manager API. */
-    fetch: FetchHandler;
-}
 declare class Registry<A extends RegistryActors> {
     #private;
     get config(): RegistryConfigInput<A>;
@@ -2481,11 +2475,22 @@ declare class Registry<A extends RegistryActors> {
      */
     startRunner(): void;
     /**
-     * Runs the registry for a server.
+     * Starts the server, serving both the actor API and static files.
+     *
+     * This is the simplest way to run RivetKit. It starts a local manager
+     * server, serves static files from the configured `publicDir` (default
+     * `"public"`), and starts the actor runner.
+     *
+     * When an endpoint is configured (via config or RIVET_ENDPOINT env var),
+     * operates in serverless mode connected to the remote engine instead.
      *
-     * @deprecated Use {@link Registry.startRunner} for long-running servers or {@link Registry.handler} for serverless deployments.
+     * @example
+     * ```ts
+     * const registry = setup({ use: { counter } });
+     * registry.start();
+     * ```
      */
-    start(inputConfig?: LegacyRunnerConfigInput): LegacyStartServerOutput<this>;
+    start(): void;
 }
 
 /**
@@ -2493,4 +2498,4 @@ declare class Registry<A extends RegistryActors> {
  */
 declare function createClient<A extends Registry<any>>(endpointOrConfig?: string | ClientConfigInput): Client<A>;
 
-export { type ActorAccessor, type ActorActionFunction, ActorClientError, type ActorConn, ActorConnDisposed, ActorConnRaw, type ActorConnStatus, ActorDefinition, ActorError, type ActorHandle, ActorHandleRaw, type AnyActorDefinition, type Client, ClientRaw, type ConnectionStateCallback, type CreateOptions, type CreateRequest, type Encoding, type EventUnsubscribe, type ExtractActorsFromRegistry, type ExtractRegistryFromClient, type GetOptions, type GetWithIdOptions, InternalError, KEYS as KV_KEYS, MalformedResponseMessage, ManagerError, type QueryOptions, type Region, type StatusChangeCallback, createClient };
+export { type ActorAccessor, type ActorActionFunction, ActorClientError, type ActorConn, ActorConnDisposed, ActorConnRaw, type ActorConnStatus, ActorDefinition, ActorError, type ActorHandle, ActorHandleRaw, type AnyActorDefinition, type Client, type ClientConfigInput, ClientRaw, type ConnectionStateCallback, type CreateOptions, type CreateRequest, type Encoding, type EventUnsubscribe, type ExtractActorsFromRegistry, type ExtractRegistryFromClient, type GetOptions, type GetWithIdOptions, InternalError, KEYS as KV_KEYS, MalformedResponseMessage, ManagerError, type QueryOptions, type Region, type StatusChangeCallback, createClient };