rivetkit 2.1.4 → 2.1.6-rc.1

package/dist/tsup/{config-iPj5l1bL.d.cts → config-ehT-_3BB.d.cts}

@@ -1,15 +1,15 @@
 import { z as z$1 } from 'zod/v4';
 import { UniversalWebSocket } from '@rivetkit/virtual-websocket';
-import { A as AnyDatabaseProvider, D as DatabaseProvider, a as RawDatabaseClient } from './config-BiNoIHRs.cjs';
+import { A as AnyDatabaseProvider, D as DatabaseProvider, a as RawDatabaseClient, b as ActorMetrics } from './config-DROwzBLT.cjs';
 import { Traces, OtlpExportTraceServiceRequestJson, SpanHandle, SpanStatusInput } from '@rivetkit/traces';
 import { Env, Context, Hono } from 'hono';
 import { VersionedDataHandler } from 'vbare';
-import { Logger } from 'pino';
 import { GetUpgradeWebSocket } from './utils.cjs';
-import { SqliteVfs } from '@rivetkit/sqlite-vfs';
+import { StandardSchemaV1 } from '@standard-schema/spec';
+import { ISqliteVfs } from '@rivetkit/sqlite-vfs';
 import { BaseSQLiteDatabase } from 'drizzle-orm/sqlite-core';
 import { z } from 'zod';
-import { StandardSchemaV1 } from '@standard-schema/spec';
+import { Logger } from 'pino';
 import * as nanoevents from 'nanoevents';
 import { W as WorkflowHistory, k as QueueStatus } from './v3-DnYObHH3.cjs';
 
@@ -98,8 +98,18 @@ interface ActorDriver {
     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): Promise<[Uint8Array, Uint8Array][]>;
+    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>;
     /**
@@ -118,13 +128,12 @@ interface ActorDriver {
      * 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.
+     * 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?(): SqliteVfs | Promise<SqliteVfs>;
+    createSqliteVfs?(actorId: string): ISqliteVfs | Promise<ISqliteVfs>;
     /**
      * Requests the actor to go to sleep.
      *
@@ -171,6 +180,10 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         autoStartActorDriver: z.ZodBoolean;
     }, z.core.$strip>>;
     storagePath: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+    sqlitePool: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        actorsPerInstance: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        idleDestroyMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    }, z.core.$strip>>>;
     maxIncomingMessageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     maxOutgoingMessageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     noWelcome: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -191,6 +204,7 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
     namespace: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
     headers: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
     serveManager: z.ZodOptional<z.ZodBoolean>;
+    publicDir: z.ZodOptional<z.ZodString>;
     managerBasePath: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     managerPort: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     managerHost: z.ZodOptional<z.ZodString>;
@@ -222,7 +236,7 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
     runner: z.ZodDefault<z.ZodOptional<z.ZodObject<{
         totalSlots: z.ZodDefault<z.ZodNumber>;
         runnerName: z.ZodDefault<z.ZodString>;
-        runnerKey: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
+        runnerKey: z.ZodOptional<z.ZodString>;
         version: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>, z.ZodTransform<{
@@ -270,6 +284,10 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         enabled: boolean;
     };
     storagePath: string | undefined;
+    sqlitePool: {
+        actorsPerInstance: number;
+        idleDestroyMs: number;
+    };
     maxIncomingMessageSize: number;
     maxOutgoingMessageSize: number;
     noWelcome: boolean;
@@ -283,8 +301,8 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
     runner: {
         totalSlots: number;
         runnerName: string;
-        runnerKey: string | undefined;
         version: number;
+        runnerKey?: string | undefined;
     };
     driver?: {
         name: string;
@@ -293,6 +311,7 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         actor: ActorDriverBuilder;
         autoStartActorDriver: boolean;
     } | undefined;
+    publicDir?: string | undefined;
     managerHost?: string | undefined;
 }, {
     use: Record<string, AnyActorDefinition>;
@@ -300,6 +319,10 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         enabled: boolean;
     };
     storagePath: string | undefined;
+    sqlitePool: {
+        actorsPerInstance: number;
+        idleDestroyMs: number;
+    };
     maxIncomingMessageSize: number;
     maxOutgoingMessageSize: number;
     noWelcome: boolean;
@@ -341,8 +364,8 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
     runner: {
         totalSlots: number;
         runnerName: string;
-        runnerKey: string | undefined;
         version: number;
+        runnerKey?: string | undefined;
     };
     driver?: {
         name: string;
@@ -352,6 +375,7 @@ declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
         autoStartActorDriver: boolean;
     } | undefined;
     serveManager?: boolean | undefined;
+    publicDir?: string | undefined;
     managerHost?: string | undefined;
 }>>;
 type RegistryConfig = z.infer<typeof RegistryConfigSchema>;
@@ -406,6 +430,10 @@ declare const DocRunnerConfigSchema: z.ZodObject<{
 declare const DocRegistryConfigSchema: z.ZodObject<{
     use: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     storagePath: z.ZodOptional<z.ZodString>;
+    sqlitePool: z.ZodOptional<z.ZodObject<{
+        actorsPerInstance: z.ZodOptional<z.ZodNumber>;
+        idleDestroyMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
     maxIncomingMessageSize: z.ZodOptional<z.ZodNumber>;
     maxOutgoingMessageSize: z.ZodOptional<z.ZodNumber>;
     noWelcome: z.ZodOptional<z.ZodBoolean>;
@@ -425,6 +453,7 @@ declare const DocRegistryConfigSchema: z.ZodObject<{
     namespace: z.ZodOptional<z.ZodString>;
     headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     serveManager: z.ZodOptional<z.ZodBoolean>;
+    publicDir: z.ZodOptional<z.ZodString>;
     managerBasePath: z.ZodOptional<z.ZodString>;
     managerPort: z.ZodOptional<z.ZodNumber>;
     inspector: z.ZodOptional<z.ZodObject<{
@@ -540,175 +569,10 @@ declare class CachedSerializer<TBare, TJson, T = TBare> {
     serialize(encoding: Encoding): OutputData;
 }
 
-declare const LegacyRunnerConfigSchema: z$1.ZodDefault<z$1.ZodPipe<z$1.ZodObject<{
-    driver: z$1.ZodOptional<z$1.ZodObject<{
-        name: z$1.ZodString;
-        manager: z$1.ZodCustom<ManagerDriverBuilder, ManagerDriverBuilder>;
-        actor: z$1.ZodCustom<ActorDriverBuilder, ActorDriverBuilder>;
-    }, z$1.core.$strip>>;
-    maxIncomingMessageSize: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodNumber>>;
-    maxOutgoingMessageSize: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodNumber>>;
-    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>>>;
-    disableDefaultServer: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodBoolean>>;
-    defaultServerPort: z$1.ZodDefault<z$1.ZodNumber>;
-    runEngine: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodBoolean>>;
-    runEngineVersion: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodString>>;
-    overrideServerAddress: z$1.ZodOptional<z$1.ZodString>;
-    disableActorDriver: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodBoolean>>;
-    runnerKind: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodEnum<{
-        serverless: "serverless";
-        normal: "normal";
-    }>>>;
-    basePath: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodString>>;
-    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>>>;
-    autoConfigureServerless: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodBoolean, z$1.ZodObject<{
-        url: z$1.ZodOptional<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>>;
-    }, z$1.core.$strip>]>>;
-    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$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>;
-    runnerKey: z$1.ZodPipe<z$1.ZodOptional<z$1.ZodString>, z$1.ZodTransform<string | undefined, string | undefined>>;
-    totalSlots: z$1.ZodDefault<z$1.ZodNumber>;
-}, z$1.core.$strip>, z$1.ZodTransform<{
-    runnerKey: string | undefined;
-    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;
-    inspector: {
-        enabled: boolean;
-        token: () => string;
-        defaultEndpoint?: string | undefined;
-    };
-    disableDefaultServer: boolean;
-    defaultServerPort: number;
-    runEngine: boolean;
-    runEngineVersion: string;
-    disableActorDriver: boolean;
-    runnerKind: "serverless" | "normal";
-    basePath: string;
-    noWelcome: boolean;
-    logging: {
-        baseLogger?: Logger | undefined;
-        level?: "error" | "trace" | "fatal" | "warn" | "info" | "debug" | "silent" | undefined;
-    };
-    totalSlots: number;
-    driver?: {
-        name: string;
-        manager: ManagerDriverBuilder;
-        actor: ActorDriverBuilder;
-    } | 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;
-}, {
-    maxIncomingMessageSize: number;
-    maxOutgoingMessageSize: number;
-    inspector: {
-        enabled: boolean;
-        token: () => string;
-        defaultEndpoint?: string | undefined;
-    };
-    disableDefaultServer: boolean;
-    defaultServerPort: number;
-    runEngine: boolean;
-    runEngineVersion: string;
-    disableActorDriver: boolean;
-    runnerKind: "serverless" | "normal";
-    basePath: string;
-    noWelcome: boolean;
-    logging: {
-        baseLogger?: Logger | undefined;
-        level?: "error" | "trace" | "fatal" | "warn" | "info" | "debug" | "silent" | undefined;
-    };
-    endpoint: string;
-    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;
-    driver?: {
-        name: string;
-        manager: ManagerDriverBuilder;
-        actor: ActorDriverBuilder;
-    } | 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$1.input<typeof LegacyRunnerConfigSchema>;
-
 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>;
@@ -739,11 +603,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.
      *
-     * @deprecated Use {@link Registry.startRunner} for long-running servers or {@link Registry.handler} for serverless deployments.
+     * 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.
+     *
+     * @example
+     * ```ts
+     * const registry = setup({ use: { counter } });
+     * registry.start();
+     * ```
      */
-    start(inputConfig?: LegacyRunnerConfigInput): LegacyStartServerOutput<this>;
+    start(): void;
 }
 declare function setup<A extends RegistryActors>(input: RegistryConfigInput<A>): Registry<A>;
 
@@ -786,6 +661,21 @@ type ActorQuery = z$1.infer<typeof ActorQuerySchema>;
  */
 type CreateRequest = z$1.infer<typeof CreateRequestSchema>;
 
+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.
  *
@@ -802,6 +692,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 {
 }
@@ -824,21 +731,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.
  *
@@ -887,7 +779,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>;
     /**
@@ -1002,7 +894,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.
@@ -1019,7 +911,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>;
     /**
@@ -1075,10 +967,10 @@ 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>;
 
 /** Extract the actor registry from the registry definition. */
 type ExtractActorsFromRegistry<A extends Registry<any>> = A extends Registry<infer Actors> ? Actors : never;
@@ -1136,6 +1028,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;
 }
@@ -1303,6 +1200,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;
@@ -1352,6 +1251,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;
@@ -1380,11 +1281,19 @@ 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]][]>;
 }
 
 interface QueueMessage {
@@ -1572,7 +1481,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.
      *
@@ -1590,16 +1499,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>;
     /**
@@ -2068,6 +1994,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;
@@ -2076,6 +2003,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>;
@@ -2128,6 +2056,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;
@@ -2422,19 +2351,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>;
     /**
@@ -2602,4 +2536,4 @@ declare const DocActorConfigSchema: z$1.ZodObject<{
     }, z$1.core.$strip>>;
 }, z$1.core.$strip>;
 
-export { DocRunnerConfigSchema as $, type ActorDriver as A, BeforeActionResponseContext as B, type Client as C, ConnContext as D, type Encoding as E, type ConnContextOf as F, ConnInitContext as G, type ConnInitContextOf as H, ConnectContext as I, type ConnectContextOf as J, CreateConnStateContext as K, type CreateConnStateContextOf as L, CreateContext as M, type CreateContextOf as N, CreateVarsContext as O, type CreateVarsContextOf as P, type QueueSchemaConfig as Q, type RegistryConfig as R, DestroyContext as S, type DestroyContextOf as T, DisconnectContext as U, type DisconnectContextOf as V, DocActorConfigSchema as W, DocActorOptionsSchema as X, DocConfigureRunnerPoolSchema as Y, DocInspectorConfigSchema as Z, DocRegistryConfigSchema as _, type AnyConn as a, ActorInstance as a$, DocServerlessConfigSchema as a0, type FetchHandler as a1, type InspectorUnsubscribe as a2, type LegacyStartServerOutput as a3, RUN_FUNCTION_CONFIG_SYMBOL as a4, Registry as a5, type RegistryActors as a6, type RegistryConfigInput as a7, RegistryConfigSchema as a8, RequestContext as a9, test as aA, type ActorAccessor as aB, type ActorActionFunction as aC, ActorClientError as aD, type ActorConn as aE, ActorConnDisposed as aF, ActorConnRaw as aG, type ActorConnStatus as aH, ActorError as aI, type ActorHandle as aJ, ActorHandleRaw as aK, ClientRaw as aL, type ConnectionStateCallback as aM, type CreateOptions as aN, type CreateRequest as aO, type EventUnsubscribe as aP, type ExtractActorsFromRegistry as aQ, type ExtractRegistryFromClient as aR, type GetOptions as aS, type GetWithIdOptions as aT, InternalError as aU, MalformedResponseMessage as aV, ManagerError as aW, type QueryOptions as aX, type Region as aY, type StatusChangeCallback as aZ, type ManagerDriver as a_, type RequestContextOf as aa, type RunConfig as ab, RunConfigSchema as ac, RunContext as ad, type RunContextOf as ae, type RunInspectorConfig as af, type ServerlessHandler as ag, SleepContext as ah, type SleepContextOf as ai, StateChangeContext as aj, type StateChangeContextOf as ak, type TestConfig as al, TestConfigSchema as am, type Type as an, WakeContext as ao, type WakeContextOf as ap, WebSocketContext as aq, type WebSocketContextOf as ar, type WorkflowInspectorConfig as as, buildActorNames as at, createClientWithDriver as au, getRunFunction as av, getRunInspectorConfig as aw, getRunMetadata as ax, lookupInRegistry as ay, setup as az, type AnyActorInstance as b, type ActorOutput as b0, type CreateInput as b1, type GetForIdInput as b2, type GetOrCreateWithKeyInput as b3, type GetWithKeyInput as b4, type ListActorsInput as b5, type ManagerDisplayInformation as b6, type ManagerDriverBuilder as b7, type ActorDriverBuilder as b8, type QueueFilterName as b9, type QueueNextOptions as ba, type QueueResultMessageForName as bb, type QueueNextBatchOptions as bc, type InferSchemaMap as bd, type InferDatabaseClient as be, type InferEventArgs as bf, type EventSchemaConfig as c, type Actions as d, type ActorConfigInput as e, ActorDefinition as f, event as g, ActionContext as h, type ActionContextOf as i, type ActorConfig as j, ActorConfigSchema as k, ActorContext as l, type ActorContextOf as m, type ActorKey as n, ActorKv as o, type ActorQuery as p, queue as q, type ActorTypes as r, ActorsSchema as s, type AnyActorDefinition as t, type AnyClient as u, type AuthIntent as v, type BeforeActionResponseContextOf as w, BeforeConnectContext as x, type BeforeConnectContextOf as y, Conn as z };
+export { type ManagerDisplayInformation as $, type ActorDriverBuilder as A, type ExtractRegistryFromClient as B, type Client as C, type GetWithIdOptions as D, type Encoding as E, InternalError as F, type GetOptions as G, MalformedResponseMessage as H, type InferSchemaMap as I, ManagerError as J, type QueryOptions as K, type Region as L, type ManagerDriverBuilder as M, type RegistryConfig as N, type ManagerDriver as O, type ActorDriver as P, type QueueSchemaConfig as Q, Registry as R, type StatusChangeCallback as S, ActorInstance as T, type ActorOutput as U, type AnyActorInstance as V, type CreateInput as W, type GetForIdInput as X, type GetOrCreateWithKeyInput as Y, type GetWithKeyInput as Z, type ListActorsInput as _, type EventSchemaConfig as a, type TestConfig as a$, ActionContext as a0, BeforeConnectContext as a1, ActorContext as a2, type Actions as a3, type AnyConn as a4, type ActorConfigInput as a5, event as a6, queue as a7, type ActionContextOf as a8, type ActorConfig as a9, type DestroyContextOf as aA, DisconnectContext as aB, type DisconnectContextOf as aC, DocActorConfigSchema as aD, DocActorOptionsSchema as aE, DocConfigureRunnerPoolSchema as aF, DocInspectorConfigSchema as aG, DocRegistryConfigSchema as aH, DocRunnerConfigSchema as aI, DocServerlessConfigSchema as aJ, type FetchHandler as aK, type InspectorUnsubscribe as aL, RUN_FUNCTION_CONFIG_SYMBOL as aM, type RegistryActors as aN, type RegistryConfigInput as aO, RegistryConfigSchema as aP, RequestContext as aQ, type RequestContextOf as aR, type RunConfig as aS, RunConfigSchema as aT, type RunContextOf as aU, type RunInspectorConfig as aV, type ServerlessHandler as aW, SleepContext as aX, type SleepContextOf as aY, StateChangeContext as aZ, type StateChangeContextOf as a_, ActorConfigSchema as aa, type ActorContextOf as ab, type ActorKey as ac, ActorKv as ad, type ActorQuery as ae, type ActorTypes as af, ActorsSchema as ag, type AnyClient as ah, type AuthIntent as ai, BeforeActionResponseContext as aj, type BeforeActionResponseContextOf as ak, type BeforeConnectContextOf as al, Conn as am, ConnContext as an, type ConnContextOf as ao, ConnInitContext as ap, type ConnInitContextOf as aq, ConnectContext as ar, type ConnectContextOf as as, CreateConnStateContext as at, type CreateConnStateContextOf as au, CreateContext as av, type CreateContextOf as aw, CreateVarsContext as ax, type CreateVarsContextOf as ay, DestroyContext as az, RunContext as b, TestConfigSchema as b0, type Type as b1, WakeContext as b2, type WakeContextOf as b3, WebSocketContext as b4, type WebSocketContextOf as b5, type WorkflowInspectorConfig as b6, buildActorNames as b7, createClientWithDriver as b8, getRunFunction as b9, getRunInspectorConfig as ba, getRunMetadata as bb, lookupInRegistry as bc, setup as bd, test as be, type AnyActorDefinition as c, ActorDefinition as d, type QueueFilterName as e, type QueueNextOptions as f, type QueueResultMessageForName as g, type QueueNextBatchOptions as h, type InferDatabaseClient as i, type InferEventArgs as j, type ActorAccessor as k, type ActorActionFunction as l, ActorClientError as m, type ActorConn as n, ActorConnDisposed as o, ActorConnRaw as p, type ActorConnStatus as q, ActorError as r, type ActorHandle as s, ActorHandleRaw as t, ClientRaw as u, type ConnectionStateCallback as v, type CreateOptions as w, type CreateRequest as x, type EventUnsubscribe as y, type ExtractActorsFromRegistry as z };