rivetkit 2.0.6 → 2.0.7-rc.1

package/dist/tsup/{connection-CpDIydXf.d.cts → conn-DdzHTm2E.d.cts}

@@ -1,12 +1,12 @@
+import { SSEStreamingApi } from 'hono/streaming';
+import { WSContext } from 'hono/ws';
+import { UpgradeWebSocket, promiseWithResolvers } from './utils.cjs';
 import z$1, { z } from 'zod';
 import { Logger } from 'pino';
 import * as hono from 'hono';
 import { Env, Context, Hono } from 'hono';
-import { UpgradeWebSocket } from './utils.cjs';
 import * as nanoevents from 'nanoevents';
-import { g as Connection, h as RealtimeEvent } from './common-CXCe7s6i.cjs';
-import { SSEStreamingApi } from 'hono/streaming';
-import { WSContext } from 'hono/ws';
+import z__default from 'zod/v4';
 
 type uint = bigint;
 type Init = {
@@ -65,60 +65,43 @@ type ToServer = {
     readonly body: ToServerBody;
 };
 
-type InferDatabaseClient<DBProvider extends AnyDatabaseProvider> = DBProvider extends DatabaseProvider<any> ? Awaited<ReturnType<DBProvider["createClient"]>> : never;
-type AnyDatabaseProvider = DatabaseProvider<any> | undefined;
-type DatabaseProvider<DB extends {
-    execute: (query: string) => any;
-}> = {
-    /**
-     * Creates a new database client for the actor.
-     * The result is passed to the actor context as `c.db`.
-     * @experimental
-     */
-    createClient: (ctx: {
-        getDatabase: () => Promise<string | unknown>;
-    }) => Promise<DB>;
-    /**
-     * Runs before the actor has started.
-     * Use this to run migrations or other setup tasks.
-     * @experimental
-     */
-    onMigrate: (client: DB) => void | Promise<void>;
-};
-
-type MigrationFn<TFrom, TTo> = (data: TFrom) => TTo;
-interface VersionedDataConfig<T> {
-    currentVersion: number;
-    migrations: Map<number, MigrationFn<any, any>>;
-    serializeVersion: (data: T) => Uint8Array;
-    deserializeVersion: (bytes: Uint8Array) => T;
+interface RivetEvent {
+    type: string;
+    target?: any;
+    currentTarget?: any;
 }
-declare class VersionedDataHandler<T> {
-    private config;
-    constructor(config: VersionedDataConfig<T>);
-    serializeWithEmbeddedVersion(data: T): Uint8Array;
-    deserializeWithEmbeddedVersion(bytes: Uint8Array): T;
-    serialize(data: T, version: number): Uint8Array;
-    deserialize(bytes: Uint8Array, version: number): T;
-    private embedVersion;
-    private extractVersion;
+interface RivetMessageEvent extends RivetEvent {
+    data: any;
+}
+interface RivetCloseEvent extends RivetEvent {
+    code: number;
+    reason: string;
+    wasClean: boolean;
 }
-
-/** Data that's been serialized. */
-type OutputData = string | Uint8Array;
-declare const EncodingSchema: z.ZodEnum<["json", "cbor", "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.
+ * Common WebSocket interface that can be implemented by different WebSocket-like classes
+ * This is compatible with the standard WebSocket API but allows for custom implementations
  */
-declare class CachedSerializer<T> {
-    #private;
-    constructor(data: T, versionedDataHandler: VersionedDataHandler<T>);
-    get rawData(): T;
-    serialize(encoding: Encoding): OutputData;
+interface UniversalWebSocket {
+    readonly CONNECTING: 0;
+    readonly OPEN: 1;
+    readonly CLOSING: 2;
+    readonly CLOSED: 3;
+    readonly readyState: 0 | 1 | 2 | 3;
+    binaryType: "arraybuffer" | "blob";
+    readonly bufferedAmount: number;
+    readonly extensions: string;
+    readonly protocol: string;
+    readonly url: string;
+    send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;
+    close(code?: number, reason?: string): void;
+    addEventListener(type: string, listener: (event: any) => void): void;
+    removeEventListener(type: string, listener: (event: any) => void): void;
+    dispatchEvent(event: RivetEvent): boolean;
+    onopen?: ((event: RivetEvent) => void) | null;
+    onclose?: ((event: RivetCloseEvent) => void) | null;
+    onerror?: ((event: RivetEvent) => void) | null;
+    onmessage?: ((event: RivetMessageEvent) => void) | null;
 }
 
 declare const ActorsSchema: z.ZodRecord<z.ZodString, z.ZodType<ActorDefinition<any, any, any, any, any, any, any>, z.ZodTypeDef, ActorDefinition<any, any, any, any, any, any, any>>>;
@@ -155,45 +138,6 @@ type RegistryConfigInput<A extends RegistryActors> = Omit<z.input<typeof Registr
     use: A;
 };
 
-interface RivetEvent {
-    type: string;
-    target?: any;
-    currentTarget?: any;
-}
-interface RivetMessageEvent extends RivetEvent {
-    data: any;
-}
-interface RivetCloseEvent extends RivetEvent {
-    code: number;
-    reason: string;
-    wasClean: boolean;
-}
-/**
- * Common WebSocket interface that can be implemented by different WebSocket-like classes
- * This is compatible with the standard WebSocket API but allows for custom implementations
- */
-interface UniversalWebSocket {
-    readonly CONNECTING: 0;
-    readonly OPEN: 1;
-    readonly CLOSING: 2;
-    readonly CLOSED: 3;
-    readonly readyState: 0 | 1 | 2 | 3;
-    binaryType: "arraybuffer" | "blob";
-    readonly bufferedAmount: number;
-    readonly extensions: string;
-    readonly protocol: string;
-    readonly url: string;
-    send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void;
-    close(code?: number, reason?: string): void;
-    addEventListener(type: string, listener: (event: any) => void): void;
-    removeEventListener(type: string, listener: (event: any) => void): void;
-    dispatchEvent(event: RivetEvent): boolean;
-    onopen?: ((event: RivetEvent) => void) | null;
-    onclose?: ((event: RivetCloseEvent) => void) | null;
-    onerror?: ((event: RivetEvent) => void) | null;
-    onmessage?: ((event: RivetMessageEvent) => void) | null;
-}
-
 type GetUpgradeWebSocket = () => UpgradeWebSocket;
 declare const ClientConfigSchema: z$1.ZodObject<{
     /** Configure serving the API */
@@ -207,6 +151,8 @@ declare const ClientConfigSchema: z$1.ZodObject<{
         host?: string | undefined;
         port?: number | undefined;
     }>>;
+    token: z$1.ZodEffects<z$1.ZodOptional<z$1.ZodString>, string | undefined, string | undefined>;
+    headers: z$1.ZodDefault<z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodString>>>;
     /** Endpoint to connect to the Rivet engine. Can be configured via RIVET_ENGINE env var. */
     endpoint: z$1.ZodDefault<z$1.ZodNullable<z$1.ZodString>>;
     namespace: z$1.ZodDefault<z$1.ZodString>;
@@ -220,10 +166,12 @@ declare const ClientConfigSchema: z$1.ZodObject<{
         host: string;
         port: number;
     };
+    headers: Record<string, string>;
     endpoint: string | null;
     namespace: string;
     runnerName: string;
     transport: "websocket" | "sse";
+    token?: string | undefined;
     getUpgradeWebSocket?: GetUpgradeWebSocket | undefined;
 }, {
     encoding?: "json" | "cbor" | "bare" | undefined;
@@ -231,6 +179,8 @@ declare const ClientConfigSchema: z$1.ZodObject<{
         host?: string | undefined;
         port?: number | undefined;
     } | undefined;
+    token?: string | undefined;
+    headers?: Record<string, string> | undefined;
     endpoint?: string | null | undefined;
     namespace?: string | undefined;
     runnerName?: string | undefined;
@@ -247,9 +197,9 @@ interface ManagerDriver {
     getOrCreateWithKey(input: GetOrCreateWithKeyInput): Promise<ActorOutput>;
     createActor(input: CreateInput): Promise<ActorOutput>;
     sendRequest(actorId: string, actorRequest: Request): Promise<Response>;
-    openWebSocket(path: string, actorId: string, encoding: Encoding, params: unknown): Promise<UniversalWebSocket>;
+    openWebSocket(path: string, actorId: string, encoding: Encoding, params: unknown, connId?: string, connToken?: string): Promise<UniversalWebSocket>;
     proxyRequest(c: Context, actorRequest: Request, actorId: string): Promise<Response>;
-    proxyWebSocket(c: Context, path: string, actorId: string, encoding: Encoding, params: unknown, authData: unknown): Promise<Response>;
+    proxyWebSocket(c: Context, path: string, actorId: string, encoding: Encoding, params: unknown, connId?: string, connToken?: string): Promise<Response>;
     displayInformation(): ManagerDisplayInformation;
     extraStartupLog?: () => Record<string, unknown>;
     modifyManagerRouter?: (registryConfig: RegistryConfig, router: Hono) => void;
@@ -288,6 +238,26 @@ interface ActorOutput {
     key: ActorKey;
 }
 
+type ActorDriverBuilder = (registryConfig: RegistryConfig, runConfig: RunConfig, managerDriver: ManagerDriver, inlineClient: AnyClient) => ActorDriver;
+interface ActorDriver {
+    loadActor(actorId: string): Promise<AnyActorInstance>;
+    getContext(actorId: string): unknown;
+    readPersistedData(actorId: string): Promise<Uint8Array | undefined>;
+    /** ActorInstance ensure that only one instance of writePersistedData is called in parallel at a time. */
+    writePersistedData(actorId: string, data: Uint8Array): Promise<void>;
+    /** ActorInstance ensure that only one instance of setAlarm is called in parallel at a time. */
+    setAlarm(actor: AnyActorInstance, timestamp: number): Promise<void>;
+    /**
+     * @experimental
+     * This is an experimental API that may change in the future.
+     */
+    getDatabase(actorId: string): Promise<unknown | undefined>;
+    sleep?(actorId: string): Promise<void>;
+    shutdown?(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>;
+}
+
 declare const DriverConfigSchema: z.ZodObject<{
     /** Machine-readable name to identify this driver by. */
     name: z.ZodString;
@@ -315,6 +285,8 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
         host?: string | undefined;
         port?: number | undefined;
     }>>;
+    token: z.ZodEffects<z.ZodOptional<z.ZodString>, string | undefined, string | undefined>;
+    headers: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
     endpoint: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     namespace: z.ZodDefault<z.ZodString>;
     runnerName: z.ZodDefault<z.ZodString>;
@@ -338,15 +310,15 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
     }>>;
     /** CORS configuration for the router. Uses Hono's CORS middleware options. */
     cors: z.ZodOptional<z.ZodType<{
-        origin: string | string[] | ((origin: string, c: hono.Context) => string | undefined | null);
-        allowMethods?: string[] | ((origin: string, c: hono.Context) => string[]);
+        origin: string | string[] | ((origin: string, c: hono.Context) => Promise<string | undefined | null> | string | undefined | null);
+        allowMethods?: string[] | ((origin: string, c: hono.Context) => Promise<string[]> | string[]);
         allowHeaders?: string[];
         maxAge?: number;
         credentials?: boolean;
         exposeHeaders?: string[];
     }, z.ZodTypeDef, {
-        origin: string | string[] | ((origin: string, c: hono.Context) => string | undefined | null);
-        allowMethods?: string[] | ((origin: string, c: hono.Context) => string[]);
+        origin: string | string[] | ((origin: string, c: hono.Context) => Promise<string | undefined | null> | string | undefined | null);
+        allowMethods?: string[] | ((origin: string, c: hono.Context) => Promise<string[]> | string[]);
         allowHeaders?: string[];
         maxAge?: number;
         credentials?: boolean;
@@ -354,17 +326,26 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
     }>>;
     maxIncomingMessageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     inspector: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodBoolean, z.ZodObject<{
+            actor: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            manager: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            actor: boolean;
+            manager: boolean;
+        }, {
+            actor?: boolean | undefined;
+            manager?: boolean | undefined;
+        }>]>>>;
         cors: z.ZodDefault<z.ZodOptional<z.ZodType<{
-            origin: string | string[] | ((origin: string, c: hono.Context) => string | undefined | null);
-            allowMethods?: string[] | ((origin: string, c: hono.Context) => string[]);
+            origin: string | string[] | ((origin: string, c: hono.Context) => Promise<string | undefined | null> | string | undefined | null);
+            allowMethods?: string[] | ((origin: string, c: hono.Context) => Promise<string[]> | string[]);
             allowHeaders?: string[];
             maxAge?: number;
             credentials?: boolean;
             exposeHeaders?: string[];
         }, z.ZodTypeDef, {
-            origin: string | string[] | ((origin: string, c: hono.Context) => string | undefined | null);
-            allowMethods?: string[] | ((origin: string, c: hono.Context) => string[]);
+            origin: string | string[] | ((origin: string, c: hono.Context) => Promise<string | undefined | null> | string | undefined | null);
+            allowMethods?: string[] | ((origin: string, c: hono.Context) => Promise<string[]> | string[]);
             allowHeaders?: string[];
             maxAge?: number;
             credentials?: boolean;
@@ -373,10 +354,13 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
         token: z.ZodDefault<z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodString>>>;
         defaultEndpoint: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        enabled: boolean;
+        enabled: boolean | {
+            actor: boolean;
+            manager: boolean;
+        };
         cors: {
-            origin: string | string[] | ((origin: string, c: hono.Context) => string | undefined | null);
-            allowMethods?: string[] | ((origin: string, c: hono.Context) => string[]);
+            origin: string | string[] | ((origin: string, c: hono.Context) => Promise<string | undefined | null> | string | undefined | null);
+            allowMethods?: string[] | ((origin: string, c: hono.Context) => Promise<string[]> | string[]);
             allowHeaders?: string[];
             maxAge?: number;
             credentials?: boolean;
@@ -385,10 +369,13 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
         token: (...args: unknown[]) => string;
         defaultEndpoint?: string | undefined;
     }, {
-        enabled?: boolean | undefined;
+        enabled?: boolean | {
+            actor?: boolean | undefined;
+            manager?: boolean | undefined;
+        } | undefined;
         cors?: {
-            origin: string | string[] | ((origin: string, c: hono.Context) => string | undefined | null);
-            allowMethods?: string[] | ((origin: string, c: hono.Context) => string[]);
+            origin: string | string[] | ((origin: string, c: hono.Context) => Promise<string | undefined | null> | string | undefined | null);
+            allowMethods?: string[] | ((origin: string, c: hono.Context) => Promise<string[]> | string[]);
             allowHeaders?: string[];
             maxAge?: number;
             credentials?: boolean;
@@ -431,10 +418,13 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     encoding: "json" | "cbor" | "bare";
     inspector: {
-        enabled: boolean;
+        enabled: boolean | {
+            actor: boolean;
+            manager: boolean;
+        };
         cors: {
-            origin: string | string[] | ((origin: string, c: hono.Context) => string | undefined | null);
-            allowMethods?: string[] | ((origin: string, c: hono.Context) => string[]);
+            origin: string | string[] | ((origin: string, c: hono.Context) => Promise<string | undefined | null> | string | undefined | null);
+            allowMethods?: string[] | ((origin: string, c: hono.Context) => Promise<string[]> | string[]);
             allowHeaders?: string[];
             maxAge?: number;
             credentials?: boolean;
@@ -447,6 +437,7 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
         host: string;
         port: number;
     };
+    headers: Record<string, string>;
     endpoint: string | null;
     namespace: string;
     runnerName: string;
@@ -466,13 +457,14 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
         manager: ManagerDriverBuilder;
     } | undefined;
     cors?: {
-        origin: string | string[] | ((origin: string, c: hono.Context) => string | undefined | null);
-        allowMethods?: string[] | ((origin: string, c: hono.Context) => string[]);
+        origin: string | string[] | ((origin: string, c: hono.Context) => Promise<string | undefined | null> | string | undefined | null);
+        allowMethods?: string[] | ((origin: string, c: hono.Context) => Promise<string[]> | string[]);
         allowHeaders?: string[];
         maxAge?: number;
         credentials?: boolean;
         exposeHeaders?: string[];
     } | undefined;
+    token?: string | undefined;
     getUpgradeWebSocket?: GetUpgradeWebSocket | undefined;
 }, {
     encoding?: "json" | "cbor" | "bare" | undefined;
@@ -482,10 +474,13 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
         manager: ManagerDriverBuilder;
     } | undefined;
     inspector?: {
-        enabled?: boolean | undefined;
+        enabled?: boolean | {
+            actor?: boolean | undefined;
+            manager?: boolean | undefined;
+        } | undefined;
         cors?: {
-            origin: string | string[] | ((origin: string, c: hono.Context) => string | undefined | null);
-            allowMethods?: string[] | ((origin: string, c: hono.Context) => string[]);
+            origin: string | string[] | ((origin: string, c: hono.Context) => Promise<string | undefined | null> | string | undefined | null);
+            allowMethods?: string[] | ((origin: string, c: hono.Context) => Promise<string[]> | string[]);
             allowHeaders?: string[];
             maxAge?: number;
             credentials?: boolean;
@@ -495,8 +490,8 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
         defaultEndpoint?: string | undefined;
     } | undefined;
     cors?: {
-        origin: string | string[] | ((origin: string, c: hono.Context) => string | undefined | null);
-        allowMethods?: string[] | ((origin: string, c: hono.Context) => string[]);
+        origin: string | string[] | ((origin: string, c: hono.Context) => Promise<string | undefined | null> | string | undefined | null);
+        allowMethods?: string[] | ((origin: string, c: hono.Context) => Promise<string[]> | string[]);
         allowHeaders?: string[];
         maxAge?: number;
         credentials?: boolean;
@@ -506,6 +501,8 @@ declare const RunConfigSchema: z.ZodDefault<z.ZodObject<{
         host?: string | undefined;
         port?: number | undefined;
     } | undefined;
+    token?: string | undefined;
+    headers?: Record<string, string> | undefined;
     endpoint?: string | null | undefined;
     namespace?: string | undefined;
     runnerName?: string | undefined;
@@ -538,58 +535,30 @@ declare class Registry<A extends RegistryActors> {
      * Runs the registry for a server.
      */
     start(inputConfig?: RunConfigInput): ServerOutput<this>;
+    startServerless(inputConfig?: RunConfigInput): ServerOutput<this>;
 }
 declare function setup<A extends RegistryActors>(input: RegistryConfigInput<A>): Registry<A>;
 
-interface ActorInspectorAccessors {
-    isStateEnabled: () => Promise<boolean>;
-    getState: () => Promise<unknown>;
-    setState: (state: unknown) => Promise<void>;
-    isDbEnabled: () => Promise<boolean>;
-    getDb: () => Promise<InferDatabaseClient<AnyDatabaseProvider>>;
-    getRpcs: () => Promise<string[]>;
-    getConnections: () => Promise<Connection[]>;
-}
-interface ActorInspectorEmitterEvents {
-    stateUpdated: (state: unknown) => void;
-    connectionUpdated: () => void;
-    eventFired: (event: RealtimeEvent) => void;
-}
-/**
- * Provides a unified interface for inspecting actor external and internal state.
- */
-declare class ActorInspector {
-    #private;
-    readonly accessors: ActorInspectorAccessors;
-    readonly emitter: nanoevents.Emitter<ActorInspectorEmitterEvents>;
-    get lastRealtimeEvents(): (({
-        type: "action";
-        name: string;
-        args: any[];
-        connId: string;
-    } | {
-        type: "broadcast";
-        eventName: string;
-        args: any[];
-    } | {
-        type: "subscribe";
-        eventName: string;
-        connId: string;
-    } | {
-        type: "unsubscribe";
-        eventName: string;
-        connId: string;
-    } | {
-        type: "event";
-        eventName: string;
-        args: any[];
-        connId: string;
-    }) & {
-        id: string;
-        timestamp: number;
-    })[];
-    constructor(accessors: () => ActorInspectorAccessors);
-}
+type InferDatabaseClient<DBProvider extends AnyDatabaseProvider> = DBProvider extends DatabaseProvider<any> ? Awaited<ReturnType<DBProvider["createClient"]>> : never;
+type AnyDatabaseProvider = DatabaseProvider<any> | undefined;
+type DatabaseProvider<DB extends {
+    execute: (query: string) => any;
+}> = {
+    /**
+     * Creates a new database client for the actor.
+     * The result is passed to the actor context as `c.db`.
+     * @experimental
+     */
+    createClient: (ctx: {
+        getDatabase: () => Promise<string | unknown>;
+    }) => Promise<DB>;
+    /**
+     * Runs before the actor has started.
+     * Use this to run migrations or other setup tasks.
+     * @experimental
+     */
+    onMigrate: (client: DB) => void | Promise<void>;
+};
 
 declare class Schedule {
     #private;
@@ -599,157 +568,23 @@ declare class Schedule {
 }
 
 /**
- * Options for the `_saveState` method.
+ * ActorContext class that provides access to actor methods and state
  */
-interface SaveStateOptions {
-    /**
-     * Forces the state to be saved immediately. This function will return when the state has saved successfully.
-     */
-    immediate?: boolean;
-    /** Bypass ready check for stopping. */
-    allowStoppingState?: boolean;
-}
-/** Actor type alias with all `any` types. Used for `extends` in classes referencing this actor. */
-type AnyActorInstance = ActorInstance<any, any, any, any, any, any>;
-declare class ActorInstance<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
+declare class ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
     #private;
-    actorContext: ActorContext<S, CP, CS, V, I, DB>;
-    get isStopping(): boolean;
-    get id(): string;
-    get inlineClient(): Client<Registry<any>>;
-    get inspector(): ActorInspector;
+    constructor(actor: ActorInstance<TState, TConnParams, TConnState, TVars, TInput, TDatabase>);
     /**
-     * This constructor should never be used directly.
-     *
-     * Constructed in {@link ActorInstance.start}.
-     *
-     * @private
+     * Get the actor state
      */
-    constructor(config: ActorConfig<S, CP, CS, V, I, DB>);
-    start(connectionDrivers: ConnectionDriversMap, actorDriver: ActorDriver, inlineClient: Client<Registry<any>>, actorId: string, name: string, key: ActorKey, region: string): Promise<void>;
-    _onAlarm(): Promise<void>;
-    scheduleEvent(timestamp: number, action: string, args: unknown[]): Promise<void>;
-    get stateEnabled(): boolean;
-    __getConnForId(id: string): Conn<S, CP, CS, V, I, DB> | undefined;
+    get state(): TState;
     /**
-     * Removes a connection and cleans up its resources.
+     * Get the actor variables
      */
-    __removeConn(conn: Conn<S, CP, CS, V, I, DB> | undefined): void;
-    prepareConn(params: any, request?: Request): Promise<CS>;
-    __getConnDriver(driverId: ConnectionDriver): ConnDriver;
+    get vars(): TVars;
     /**
-     * Called after establishing a connection handshake.
-     */
-    createConn(connectionId: string, connectionToken: string, params: CP, state: CS, driverId: ConnectionDriver, driverState: unknown, authData: unknown): Promise<Conn<S, CP, CS, V, I, DB>>;
-    processMessage(message: ToServer, conn: Conn<S, CP, CS, V, I, DB>): Promise<void>;
-    /**
-     * Check if the actor is ready to handle requests.
-     */
-    isReady(): boolean;
-    /**
-     * Returns a list of action methods available on this actor.
-     */
-    get actions(): string[];
-    /**
-     * Handles raw HTTP requests to the actor.
-     */
-    handleFetch(request: Request, opts: {}): Promise<Response>;
-    /**
-     * Handles raw WebSocket connections to the actor.
-     */
-    handleWebSocket(websocket: UniversalWebSocket, opts: {
-        request: Request;
-    }): Promise<void>;
-    get log(): Logger;
-    get rLog(): Logger;
-    /**
-     * Gets the name.
-     */
-    get name(): string;
-    /**
-     * Gets the key.
-     */
-    get key(): ActorKey;
-    /**
-     * Gets the region.
-     */
-    get region(): string;
-    /**
-     * Gets the scheduler.
-     */
-    get schedule(): Schedule;
-    /**
-     * Gets the map of connections.
-     */
-    get conns(): Map<ConnId, Conn<S, CP, CS, V, I, DB>>;
-    /**
-     * Gets the current state.
-     *
-     * Changing properties of this value will automatically be persisted.
-     */
-    get state(): S;
-    /**
-     * Gets the database.
-     * @experimental
-     * @throws {DatabaseNotEnabled} If the database is not enabled.
-     */
-    get db(): InferDatabaseClient<DB>;
-    /**
-     * Sets the current state.
-     *
-     * This property will automatically be persisted.
-     */
-    set state(value: S);
-    get vars(): V;
-    /**
-     * Broadcasts an event to all connected clients.
-     * @param name - The name of the event.
-     * @param args - The arguments to send with the event.
-     */
-    _broadcast<Args extends Array<unknown>>(name: string, ...args: Args): void;
-    /**
-     * Prevents the actor from sleeping until promise is complete.
-     *
-     * This allows the actor runtime to ensure that a promise completes while
-     * returning from an action request early.
-     *
-     * @param promise - The promise to run in the background.
-     */
-    _waitUntil(promise: Promise<void>): void;
-    /**
-     * Forces the state to get saved.
-     *
-     * This is helpful if running a long task that may fail later or when
-     * running a background job that updates the state.
-     *
-     * @param opts - Options for saving the state.
-     */
-    saveState(opts: SaveStateOptions): Promise<void>;
-    /** Puts an actor to sleep. This should just start the sleep sequence, most shutdown logic should be in _stop (which is called by the ActorDriver when sleeping). */
-    _sleep(): Promise<void>;
-    _stop(): Promise<void>;
-    /** Abort signal that fires when the actor is stopping. */
-    get abortSignal(): AbortSignal;
-}
-
-/**
- * ActorContext class that provides access to actor methods and state
- */
-declare class ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
-    #private;
-    constructor(actor: ActorInstance<TState, TConnParams, TConnState, TVars, TInput, TDatabase>);
-    /**
-     * Get the actor state
-     */
-    get state(): TState;
-    /**
-     * Get the actor variables
-     */
-    get vars(): TVars;
-    /**
-     * Broadcasts an event to all connected clients.
-     * @param name - The name of the event.
-     * @param args - The arguments to send with the event.
+     * Broadcasts an event to all connected clients.
+     * @param name - The name of the event.
+     * @param args - The arguments to send with the event.
      */
     broadcast<Args extends Array<unknown>>(name: string, ...args: Args): void;
     /**
@@ -814,624 +649,603 @@ declare class ActorContext<TState, TConnParams, TConnState, TVars, TInput, TData
     sleep(): void;
 }
 
-type InitContext = ActorContext<undefined, undefined, undefined, undefined, undefined, undefined>;
-interface ActorTypes<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
-    state?: TState;
-    connParams?: TConnParams;
-    connState?: TConnState;
-    vars?: TVars;
-    input?: TInput;
-    database?: TDatabase;
+type AnyActorDefinition = ActorDefinition<any, any, any, any, any, any, any>;
+/**
+ * Extracts the context type from an ActorDefinition
+ */
+type ActorContextOf<AD extends AnyActorDefinition> = AD extends ActorDefinition<infer S, infer CP, infer CS, infer V, infer I, infer DB, any> ? ActorContext<S, CP, CS, V, I, DB> : never;
+/**
+ * Extracts the context type from an ActorDefinition
+ */
+type ActionContextOf<AD extends AnyActorDefinition> = AD extends ActorDefinition<infer S, infer CP, infer CS, infer V, infer I, infer DB, any> ? ActionContext<S, CP, CS, V, I, DB> : never;
+declare class ActorDefinition<S, CP, CS, V, I, DB extends AnyDatabaseProvider, R extends Actions<S, CP, CS, V, I, DB>> {
+    #private;
+    constructor(config: ActorConfig<S, CP, CS, V, I, DB>);
+    get config(): ActorConfig<S, CP, CS, V, I, DB>;
+    instantiate(): ActorInstance<S, CP, CS, V, I, DB>;
 }
-declare const ActorConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
-    onCreate: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onStart: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onStop: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onStateChange: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onBeforeConnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onConnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onDisconnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onBeforeActionResponse: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onFetch: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    onWebSocket: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    actions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>>;
-    state: z.ZodOptional<z.ZodAny>;
-    createState: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    connState: z.ZodOptional<z.ZodAny>;
-    createConnState: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    vars: z.ZodOptional<z.ZodAny>;
-    db: z.ZodOptional<z.ZodAny>;
-    createVars: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
-    options: z.ZodDefault<z.ZodObject<{
-        createVarsTimeout: z.ZodDefault<z.ZodNumber>;
-        createConnStateTimeout: z.ZodDefault<z.ZodNumber>;
-        onConnectTimeout: z.ZodDefault<z.ZodNumber>;
-        onStopTimeout: z.ZodDefault<z.ZodNumber>;
-        stateSaveInterval: z.ZodDefault<z.ZodNumber>;
-        actionTimeout: z.ZodDefault<z.ZodNumber>;
-        waitUntilTimeout: z.ZodDefault<z.ZodNumber>;
-        connectionLivenessTimeout: z.ZodDefault<z.ZodNumber>;
-        connectionLivenessInterval: z.ZodDefault<z.ZodNumber>;
-        noSleep: z.ZodDefault<z.ZodBoolean>;
-        sleepTimeout: z.ZodDefault<z.ZodNumber>;
-    }, "strict", z.ZodTypeAny, {
-        createVarsTimeout: number;
-        createConnStateTimeout: number;
-        onConnectTimeout: number;
-        onStopTimeout: number;
-        stateSaveInterval: number;
-        actionTimeout: number;
-        waitUntilTimeout: number;
-        connectionLivenessTimeout: number;
-        connectionLivenessInterval: number;
-        noSleep: boolean;
-        sleepTimeout: number;
+declare function lookupInRegistry(registryConfig: RegistryConfig, name: string): AnyActorDefinition;
+
+type MigrationFn<TFrom, TTo> = (data: TFrom) => TTo;
+interface VersionedDataConfig<T> {
+    currentVersion: number;
+    migrations: Map<number, MigrationFn<any, any>>;
+    serializeVersion: (data: T) => Uint8Array;
+    deserializeVersion: (bytes: Uint8Array) => T;
+}
+declare class VersionedDataHandler<T> {
+    private config;
+    constructor(config: VersionedDataConfig<T>);
+    serializeWithEmbeddedVersion(data: T): Uint8Array;
+    deserializeWithEmbeddedVersion(bytes: Uint8Array): T;
+    serialize(data: T, version: number): Uint8Array;
+    deserialize(bytes: Uint8Array, version: number): T;
+    private embedVersion;
+    private extractVersion;
+}
+
+/** Data that's been serialized. */
+type OutputData = string | Uint8Array;
+declare const EncodingSchema: z.ZodEnum<["json", "cbor", "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<T> {
+    #private;
+    constructor(data: T, versionedDataHandler: VersionedDataHandler<T>);
+    get rawData(): T;
+    serialize(encoding: Encoding): OutputData;
+}
+
+declare const TransportSchema: z.ZodEnum<["websocket", "sse"]>;
+/**
+ * Transport mechanism used to communicate between client & actor.
+ */
+type Transport = z.infer<typeof TransportSchema>;
+
+declare const ActorKeySchema: z.ZodArray<z.ZodString, "many">;
+type ActorKey = z.infer<typeof ActorKeySchema>;
+declare const CreateRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    key: z.ZodArray<z.ZodString, "many">;
+    input: z.ZodOptional<z.ZodUnknown>;
+    region: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    key: string[];
+    name: string;
+    input?: unknown;
+    region?: string | undefined;
+}, {
+    key: string[];
+    name: string;
+    input?: unknown;
+    region?: string | undefined;
+}>;
+declare const ActorQuerySchema: z.ZodUnion<[z.ZodObject<{
+    getForId: z.ZodObject<{
+        name: z.ZodString;
+        actorId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        actorId: string;
     }, {
-        createVarsTimeout?: number | undefined;
-        createConnStateTimeout?: number | undefined;
-        onConnectTimeout?: number | undefined;
-        onStopTimeout?: number | undefined;
-        stateSaveInterval?: number | undefined;
-        actionTimeout?: number | undefined;
-        waitUntilTimeout?: number | undefined;
-        connectionLivenessTimeout?: number | undefined;
-        connectionLivenessInterval?: number | undefined;
-        noSleep?: boolean | undefined;
-        sleepTimeout?: number | undefined;
-    }>>;
-}, "strict", z.ZodTypeAny, {
-    options: {
-        createVarsTimeout: number;
-        createConnStateTimeout: number;
-        onConnectTimeout: number;
-        onStopTimeout: number;
-        stateSaveInterval: number;
-        actionTimeout: number;
-        waitUntilTimeout: number;
-        connectionLivenessTimeout: number;
-        connectionLivenessInterval: number;
-        noSleep: boolean;
-        sleepTimeout: number;
+        name: string;
+        actorId: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    getForId: {
+        name: string;
+        actorId: string;
     };
-    actions: Record<string, (...args: unknown[]) => unknown>;
-    state?: any;
-    db?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
 }, {
-    state?: any;
-    options?: {
-        createVarsTimeout?: number | undefined;
-        createConnStateTimeout?: number | undefined;
-        onConnectTimeout?: number | undefined;
-        onStopTimeout?: number | undefined;
-        stateSaveInterval?: number | undefined;
-        actionTimeout?: number | undefined;
-        waitUntilTimeout?: number | undefined;
-        connectionLivenessTimeout?: number | undefined;
-        connectionLivenessInterval?: number | undefined;
-        noSleep?: boolean | undefined;
-        sleepTimeout?: number | undefined;
-    } | undefined;
-    db?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}>, {
-    options: {
-        createVarsTimeout: number;
-        createConnStateTimeout: number;
-        onConnectTimeout: number;
-        onStopTimeout: number;
-        stateSaveInterval: number;
-        actionTimeout: number;
-        waitUntilTimeout: number;
-        connectionLivenessTimeout: number;
-        connectionLivenessInterval: number;
-        noSleep: boolean;
-        sleepTimeout: number;
+    getForId: {
+        name: string;
+        actorId: string;
+    };
+}>, z.ZodObject<{
+    getForKey: z.ZodObject<{
+        name: z.ZodString;
+        key: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        key: string[];
+        name: string;
+    }, {
+        key: string[];
+        name: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    getForKey: {
+        key: string[];
+        name: string;
     };
-    actions: Record<string, (...args: unknown[]) => unknown>;
-    state?: any;
-    db?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
 }, {
-    state?: any;
-    options?: {
-        createVarsTimeout?: number | undefined;
-        createConnStateTimeout?: number | undefined;
-        onConnectTimeout?: number | undefined;
-        onStopTimeout?: number | undefined;
-        stateSaveInterval?: number | undefined;
-        actionTimeout?: number | undefined;
-        waitUntilTimeout?: number | undefined;
-        connectionLivenessTimeout?: number | undefined;
-        connectionLivenessInterval?: number | undefined;
-        noSleep?: boolean | undefined;
-        sleepTimeout?: number | undefined;
-    } | undefined;
-    db?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}>, {
-    options: {
-        createVarsTimeout: number;
-        createConnStateTimeout: number;
-        onConnectTimeout: number;
-        onStopTimeout: number;
-        stateSaveInterval: number;
-        actionTimeout: number;
-        waitUntilTimeout: number;
-        connectionLivenessTimeout: number;
-        connectionLivenessInterval: number;
-        noSleep: boolean;
-        sleepTimeout: number;
+    getForKey: {
+        key: string[];
+        name: string;
+    };
+}>, z.ZodObject<{
+    getOrCreateForKey: z.ZodObject<{
+        name: z.ZodString;
+        key: z.ZodArray<z.ZodString, "many">;
+        input: z.ZodOptional<z.ZodUnknown>;
+        region: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        key: string[];
+        name: string;
+        input?: unknown;
+        region?: string | undefined;
+    }, {
+        key: string[];
+        name: string;
+        input?: unknown;
+        region?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    getOrCreateForKey: {
+        key: string[];
+        name: string;
+        input?: unknown;
+        region?: string | undefined;
     };
-    actions: Record<string, (...args: unknown[]) => unknown>;
-    state?: any;
-    db?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
 }, {
-    state?: any;
-    options?: {
-        createVarsTimeout?: number | undefined;
-        createConnStateTimeout?: number | undefined;
-        onConnectTimeout?: number | undefined;
-        onStopTimeout?: number | undefined;
-        stateSaveInterval?: number | undefined;
-        actionTimeout?: number | undefined;
-        waitUntilTimeout?: number | undefined;
-        connectionLivenessTimeout?: number | undefined;
-        connectionLivenessInterval?: number | undefined;
-        noSleep?: boolean | undefined;
-        sleepTimeout?: number | undefined;
-    } | undefined;
-    db?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}>, {
-    options: {
-        createVarsTimeout: number;
-        createConnStateTimeout: number;
-        onConnectTimeout: number;
-        onStopTimeout: number;
-        stateSaveInterval: number;
-        actionTimeout: number;
-        waitUntilTimeout: number;
-        connectionLivenessTimeout: number;
-        connectionLivenessInterval: number;
-        noSleep: boolean;
-        sleepTimeout: number;
+    getOrCreateForKey: {
+        key: string[];
+        name: string;
+        input?: unknown;
+        region?: string | undefined;
+    };
+}>, z.ZodObject<{
+    create: z.ZodObject<{
+        name: z.ZodString;
+        key: z.ZodArray<z.ZodString, "many">;
+        input: z.ZodOptional<z.ZodUnknown>;
+        region: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        key: string[];
+        name: string;
+        input?: unknown;
+        region?: string | undefined;
+    }, {
+        key: string[];
+        name: string;
+        input?: unknown;
+        region?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    create: {
+        key: string[];
+        name: string;
+        input?: unknown;
+        region?: string | undefined;
     };
-    actions: Record<string, (...args: unknown[]) => unknown>;
-    state?: any;
-    db?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
 }, {
-    state?: any;
-    options?: {
-        createVarsTimeout?: number | undefined;
-        createConnStateTimeout?: number | undefined;
-        onConnectTimeout?: number | undefined;
-        onStopTimeout?: number | undefined;
-        stateSaveInterval?: number | undefined;
-        actionTimeout?: number | undefined;
-        waitUntilTimeout?: number | undefined;
-        connectionLivenessTimeout?: number | undefined;
-        connectionLivenessInterval?: number | undefined;
-        noSleep?: boolean | undefined;
-        sleepTimeout?: number | undefined;
-    } | undefined;
-    db?: any;
-    onCreate?: ((...args: unknown[]) => unknown) | undefined;
-    onStart?: ((...args: unknown[]) => unknown) | undefined;
-    onStop?: ((...args: unknown[]) => unknown) | undefined;
-    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onConnect?: ((...args: unknown[]) => unknown) | undefined;
-    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
-    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
-    onFetch?: ((...args: unknown[]) => unknown) | undefined;
-    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
-    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
-    createState?: ((...args: unknown[]) => unknown) | undefined;
-    connState?: any;
-    createConnState?: ((...args: unknown[]) => unknown) | undefined;
-    vars?: any;
-    createVars?: ((...args: unknown[]) => unknown) | undefined;
-}>;
-interface OnConnectOptions {
-    /**
-     * The request object associated with the connection.
-     *
-     * @experimental
-     */
-    request?: Request;
-}
-type CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
-    state: TState;
-} | {
-    createState: (c: InitContext, input: TInput) => TState | Promise<TState>;
-} | Record<never, never>;
-type CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
-    connState: TConnState;
-} | {
-    createConnState: (c: InitContext, opts: OnConnectOptions, params: TConnParams) => TConnState | Promise<TConnState>;
-} | Record<never, never>;
+    create: {
+        key: string[];
+        name: string;
+        input?: unknown;
+        region?: string | undefined;
+    };
+}>]>;
+type ActorQuery = z.infer<typeof ActorQuerySchema>;
 /**
- * @experimental
+ * Interface representing a request to create a actor.
  */
-type CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
-    /**
-     * @experimental
-     */
-    vars: TVars;
-} | {
-    /**
-     * @experimental
-     */
-    createVars: (c: InitContext, driverCtx: any) => TVars | Promise<TVars>;
-} | Record<never, never>;
-interface Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
-    [Action: string]: (c: ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, ...args: any[]) => any;
+type CreateRequest = z.infer<typeof CreateRequestSchema>;
+
+/**
+ * Action function returned by Actor connections and handles.
+ *
+ * @typedef {Function} ActorActionFunction
+ * @template Args
+ * @template Response
+ * @param {...Args} args - Arguments for the action function.
+ * @returns {Promise<Response>}
+ */
+type ActorActionFunction<Args extends Array<unknown> = unknown[], Response = unknown> = (...args: Args extends [unknown, ...infer Rest] ? Rest : Args) => Promise<Response>;
+/**
+ * Maps action methods from actor definition to typed function signatures.
+ */
+type ActorDefinitionActions<AD extends AnyActorDefinition> = AD extends ActorDefinition<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;
+
+declare class ActorClientError extends Error {
+}
+declare class InternalError extends ActorClientError {
+}
+declare class ManagerError extends ActorClientError {
+    constructor(error: string, opts?: ErrorOptions);
+}
+declare class MalformedResponseMessage extends ActorClientError {
+    constructor(cause?: unknown);
+}
+declare class ActorError extends ActorClientError {
+    readonly group: string;
+    readonly code: string;
+    readonly metadata?: unknown | undefined;
+    __type: string;
+    constructor(group: string, code: string, message: string, metadata?: unknown | undefined);
 }
+
 /**
- * @experimental
+ * A function that unsubscribes from an event.
+ *
+ * @typedef {Function} EventUnsubscribe
  */
-type AuthIntent = "get" | "create" | "connect" | "action" | "message";
-interface BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>> {
+type EventUnsubscribe = () => void;
+/**
+ * A function that handles connection errors.
+ *
+ * @typedef {Function} ActorErrorCallback
+ */
+type ActorErrorCallback = (error: ActorError) => void;
+declare const CONNECT_SYMBOL: unique symbol;
+/**
+ * Provides underlying functions for {@link ActorConn}. See {@link ActorConn} for using type-safe remote procedure calls.
+ *
+ * @see {@link ActorConn}
+ */
+declare class ActorConnRaw {
+    #private;
     /**
-     * Called when the actor is first initialized.
+     * Do not call this directly.
      *
-     * Use this hook to initialize your actor's state.
-     * This is called before any other lifecycle hooks.
+     * Creates an instance of ActorConnRaw.
+     *
+     * @protected
      */
-    onCreate?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, input: TInput) => void | Promise<void>;
+    constructor(client: ClientRaw, driver: ManagerDriver, params: unknown, encoding: Encoding, actorQuery: ActorQuery);
     /**
-     * Called when the actor is started and ready to receive connections and action.
-     *
-     * Use this hook to initialize resources needed for the actor's operation
-     * (timers, external connections, etc.)
+     * Call a raw action connection. See {@link ActorConn} for type-safe action calls.
      *
-     * @returns Void or a Promise that resolves when startup is complete
+     * @see {@link ActorConn}
+     * @template Args - The type of arguments to pass to the action function.
+     * @template Response - The type of the response returned by the action function.
+     * @param {string} name - The name of the action function to call.
+     * @param {...Args} args - The arguments to pass to the action function.
+     * @returns {Promise<Response>} - A promise that resolves to the response of the action function.
      */
-    onStart?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
+    action<Args extends Array<unknown> = unknown[], Response = unknown>(opts: {
+        name: string;
+        args: Args;
+        signal?: AbortSignal;
+    }): Promise<Response>;
     /**
-     * Called when the actor is stopping or sleeping.
-     *
-     * Use this hook to clean up resources, save state, or perform
-     * any shutdown operations before the actor sleeps or stops.
-     *
-     * Not supported on all platforms.
+     * Do not call this directly.
+enc
+     * Establishes a connection to the server using the specified endpoint & encoding & driver.
      *
-     * @returns Void or a Promise that resolves when shutdown is complete
+     * @protected
      */
-    onStop?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
+    [CONNECT_SYMBOL](): void;
     /**
-     * Called when the actor's state changes.
-     *
-     * Use this hook to react to state changes, such as updating
-     * external systems or triggering events.
-     *
-     * State changes made within this hook will NOT trigger
-     * another onStateChange call, preventing infinite recursion.
+     * Subscribes to an event that will happen repeatedly.
      *
-     * @param newState The updated state
+     * @template Args - The type of arguments the event callback will receive.
+     * @param {string} eventName - The name of the event to subscribe to.
+     * @param {(...args: Args) => void} callback - The callback function to execute when the event is triggered.
+     * @returns {EventUnsubscribe} - A function to unsubscribe from the event.
+     * @see {@link https://rivet.dev/docs/events|Events Documentation}
      */
-    onStateChange?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, newState: TState) => void;
+    on<Args extends Array<unknown> = unknown[]>(eventName: string, callback: (...args: Args) => void): EventUnsubscribe;
     /**
-     * Called before a client connects to the actor.
-     *
-     * Use this hook to determine if a connection should be accepted
-     * and to initialize connection-specific state.
+     * Subscribes to an event that will be triggered only once.
      *
-     * @param opts Connection parameters including client-provided data
-     * @returns The initial connection state or a Promise that resolves to it
-     * @throws Throw an error to reject the connection
+     * @template Args - The type of arguments the event callback will receive.
+     * @param {string} eventName - The name of the event to subscribe to.
+     * @param {(...args: Args) => void} callback - The callback function to execute when the event is triggered.
+     * @returns {EventUnsubscribe} - A function to unsubscribe from the event.
+     * @see {@link https://rivet.dev/docs/events|Events Documentation}
      */
-    onBeforeConnect?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, opts: OnConnectOptions, params: TConnParams) => void | Promise<void>;
+    once<Args extends Array<unknown> = unknown[]>(eventName: string, callback: (...args: Args) => void): EventUnsubscribe;
     /**
-     * Called when a client successfully connects to the actor.
-     *
-     * Use this hook to perform actions when a connection is established,
-     * such as sending initial data or updating the actor's state.
+     * Subscribes to connection errors.
      *
-     * @param conn The connection object
-     * @returns Void or a Promise that resolves when connection handling is complete
+     * @param {ActorErrorCallback} callback - The callback function to execute when a connection error occurs.
+     * @returns {() => void} - A function to unsubscribe from the error handler.
      */
-    onConnect?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
+    onError(callback: ActorErrorCallback): () => void;
     /**
-     * Called when a client disconnects from the actor.
+     * Disconnects from the actor.
      *
-     * Use this hook to clean up resources associated with the connection
-     * or update the actor's state.
-     *
-     * @param conn The connection that is being closed
-     * @returns Void or a Promise that resolves when disconnect handling is complete
+     * @returns {Promise<void>} A promise that resolves when the socket is gracefully closed.
      */
-    onDisconnect?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
+    dispose(): Promise<void>;
+}
+/**
+ * Connection to a actor. Allows calling actor's remote procedure calls with inferred types. See {@link ActorConnRaw} for underlying methods.
+ *
+ * @example
+ * ```
+ * const room = client.connect<ChatRoom>(...etc...);
+ * // This calls the action named `sendMessage` on the `ChatRoom` actor.
+ * await room.sendMessage('Hello, world!');
+ * ```
+ *
+ * Private methods (e.g. those starting with `_`) are automatically excluded.
+ *
+ * @template AD The actor class that this connection is for.
+ * @see {@link ActorConnRaw}
+ */
+type ActorConn<AD extends AnyActorDefinition> = ActorConnRaw & ActorDefinitionActions<AD>;
+
+/**
+ * Provides underlying functions for stateless {@link ActorHandle} for action calls.
+ * Similar to ActorConnRaw but doesn't maintain a connection.
+ *
+ * @see {@link ActorHandle}
+ */
+declare class ActorHandleRaw {
+    #private;
     /**
-     * Called before sending an action response to the client.
+     * Do not call this directly.
      *
-     * Use this hook to modify or transform the output of an action before it's sent
-     * to the client. This is useful for formatting responses, adding metadata,
-     * or applying transformations to the output.
+     * Creates an instance of ActorHandleRaw.
      *
-     * @param name The name of the action that was called
-     * @param args The arguments that were passed to the action
-     * @param output The output that will be sent to the client
-     * @returns The modified output to send to the client
+     * @protected
      */
-    onBeforeActionResponse?: <Out>(c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, name: string, args: unknown[], output: Out) => Out | Promise<Out>;
+    constructor(client: any, driver: ManagerDriver, params: unknown, encoding: Encoding, actorQuery: ActorQuery);
     /**
-     * Called when a raw HTTP request is made to the actor.
+     * Call a raw action. This method sends an HTTP request to invoke the named action.
      *
-     * This handler receives raw HTTP requests made to `/actors/{actorName}/http/*` endpoints.
-     * Use this hook to handle custom HTTP patterns, REST APIs, or other HTTP-based protocols.
+     * @see {@link ActorHandle}
+     * @template Args - The type of arguments to pass to the action function.
+     * @template Response - The type of the response returned by the action function.
+     */
+    action<Args extends Array<unknown> = unknown[], Response = unknown>(opts: {
+        name: string;
+        args: Args;
+        signal?: AbortSignal;
+    }): Promise<Response>;
+    /**
+     * Establishes a persistent connection to the actor.
      *
-     * @param request The raw HTTP request object
-     * @returns A Response object to send back, or void to continue with default routing
+     * @template AD The actor class that this connection is for.
+     * @returns {ActorConn<AD>} A connection to the actor.
      */
-    onFetch?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, request: Request, opts: {}) => Response | Promise<Response>;
+    connect(): ActorConn<AnyActorDefinition>;
     /**
-     * Called when a raw WebSocket connection is established to the actor.
+     * Makes a raw HTTP request to the actor.
      *
-     * This handler receives WebSocket connections made to `/actors/{actorName}/websocket/*` endpoints.
-     * Use this hook to handle custom WebSocket protocols, binary streams, or other WebSocket-based communication.
+     * @param input - The URL, path, or Request object
+     * @param init - Standard fetch RequestInit options
+     * @returns Promise<Response> - The raw HTTP response
+     */
+    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+    /**
+     * Creates a raw WebSocket connection to the actor.
      *
-     * @param websocket The raw WebSocket connection
-     * @param request The original HTTP upgrade request
+     * @param path - The path for the WebSocket connection (e.g., "stream")
+     * @param protocols - Optional WebSocket subprotocols
+     * @returns WebSocket - A raw WebSocket connection
      */
-    onWebSocket?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, websocket: UniversalWebSocket, opts: {
-        request: Request;
-    }) => void | Promise<void>;
-    actions: TActions;
-}
-type ActorDatabaseConfig<TDatabase extends AnyDatabaseProvider> = {
+    websocket(path?: string, protocols?: string | string[]): Promise<WebSocket>;
     /**
-     * @experimental
+     * Resolves the actor to get its unique actor ID
+     *
+     * @returns {Promise<string>} - A promise that resolves to the actor's ID
      */
-    db: TDatabase;
-} | Record<never, never>;
-type ActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> = Omit<z.infer<typeof ActorConfigSchema>, "actions" | "onCreate" | "onStart" | "onStateChange" | "onBeforeConnect" | "onConnect" | "onDisconnect" | "onBeforeActionResponse" | "onFetch" | "onWebSocket" | "state" | "createState" | "connState" | "createConnState" | "vars" | "createVars" | "db"> & BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>> & CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & ActorDatabaseConfig<TDatabase>;
-type ActorConfigInput<TState = undefined, TConnParams = undefined, TConnState = undefined, TVars = undefined, TInput = undefined, TDatabase extends AnyDatabaseProvider = undefined, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = Record<never, never>> = {
-    types?: ActorTypes<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
-} & Omit<z.input<typeof ActorConfigSchema>, "actions" | "onCreate" | "onStart" | "onStop" | "onStateChange" | "onBeforeConnect" | "onConnect" | "onDisconnect" | "onBeforeActionResponse" | "onFetch" | "onWebSocket" | "state" | "createState" | "connState" | "createConnState" | "vars" | "createVars" | "db"> & BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TActions> & CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & ActorDatabaseConfig<TDatabase>;
-declare function test<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>>(input: ActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TActions>): ActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
-
-declare const ActorKeySchema: z.ZodArray<z.ZodString, "many">;
-type ActorKey = z.infer<typeof ActorKeySchema>;
-declare const CreateRequestSchema: z.ZodObject<{
-    name: z.ZodString;
-    key: z.ZodArray<z.ZodString, "many">;
-    input: z.ZodOptional<z.ZodUnknown>;
-    region: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    key: string[];
-    name: string;
-    input?: unknown;
-    region?: string | undefined;
-}, {
-    key: string[];
-    name: string;
-    input?: unknown;
-    region?: string | undefined;
-}>;
-declare const ActorQuerySchema: z.ZodUnion<[z.ZodObject<{
-    getForId: z.ZodObject<{
-        name: z.ZodString;
-        actorId: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-        actorId: string;
-    }, {
-        name: string;
-        actorId: string;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    getForId: {
-        name: string;
-        actorId: string;
-    };
-}, {
-    getForId: {
-        name: string;
-        actorId: string;
-    };
-}>, z.ZodObject<{
-    getForKey: z.ZodObject<{
-        name: z.ZodString;
-        key: z.ZodArray<z.ZodString, "many">;
-    }, "strip", z.ZodTypeAny, {
-        key: string[];
-        name: string;
-    }, {
-        key: string[];
-        name: string;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    getForKey: {
-        key: string[];
-        name: string;
-    };
-}, {
-    getForKey: {
-        key: string[];
-        name: string;
-    };
-}>, z.ZodObject<{
-    getOrCreateForKey: z.ZodObject<{
-        name: z.ZodString;
-        key: z.ZodArray<z.ZodString, "many">;
-        input: z.ZodOptional<z.ZodUnknown>;
-        region: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        key: string[];
-        name: string;
-        input?: unknown;
-        region?: string | undefined;
-    }, {
-        key: string[];
-        name: string;
-        input?: unknown;
-        region?: string | undefined;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    getOrCreateForKey: {
-        key: string[];
-        name: string;
-        input?: unknown;
-        region?: string | undefined;
-    };
-}, {
-    getOrCreateForKey: {
-        key: string[];
-        name: string;
-        input?: unknown;
-        region?: string | undefined;
-    };
-}>, z.ZodObject<{
-    create: z.ZodObject<{
-        name: z.ZodString;
-        key: z.ZodArray<z.ZodString, "many">;
-        input: z.ZodOptional<z.ZodUnknown>;
-        region: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        key: string[];
-        name: string;
-        input?: unknown;
-        region?: string | undefined;
-    }, {
-        key: string[];
-        name: string;
-        input?: unknown;
-        region?: string | undefined;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    create: {
-        key: string[];
-        name: string;
-        input?: unknown;
-        region?: string | undefined;
-    };
-}, {
-    create: {
-        key: string[];
-        name: string;
-        input?: unknown;
-        region?: string | undefined;
-    };
-}>]>;
-type ActorQuery = z.infer<typeof ActorQuerySchema>;
-/**
- * Interface representing a request to create a actor.
- */
-type CreateRequest = z.infer<typeof CreateRequestSchema>;
-
-declare class GenericConnGlobalState {
-    websockets: Map<string, WSContext<unknown>>;
-    sseStreams: Map<string, SSEStreamingApi>;
+    resolve({ signal }?: {
+        signal?: AbortSignal;
+    }): Promise<string>;
 }
 /**
- * Exposes connection drivers for platforms that support vanilla WebSocket, SSE, and HTTP.
+ * Stateless handle to a actor. Allows calling actor's remote procedure calls with inferred types
+ * without establishing a persistent connection.
+ *
+ * @example
+ * ```
+ * const room = client.get<ChatRoom>(...etc...);
+ * // This calls the action named `sendMessage` on the `ChatRoom` actor without a connection.
+ * await room.sendMessage('Hello, world!');
+ * ```
+ *
+ * Private methods (e.g. those starting with `_`) are automatically excluded.
+ *
+ * @template AD The actor class that this handle is for.
+ * @see {@link ActorHandleRaw}
  */
-declare function createGenericConnDrivers(globalState: GenericConnGlobalState): ConnectionDriversMap;
+type ActorHandle<AD extends AnyActorDefinition> = Omit<ActorHandleRaw, "connect"> & {
+    connect(): ActorConn<AD>;
+    resolve(): Promise<string>;
+} & ActorDefinitionActions<AD>;
+
+/** Extract the actor registry from the registry definition. */
+type ExtractActorsFromRegistry<A extends Registry<any>> = A extends Registry<infer Actors> ? Actors : never;
+/** Extract the registry definition from the client. */
+type ExtractRegistryFromClient<C extends Client<Registry<{}>>> = C extends Client<infer A> ? A : never;
+/**
+ * Represents a actor accessor that provides methods to interact with a specific actor.
+ */
+interface ActorAccessor<AD extends AnyActorDefinition> {
+    /**
+     * Gets a stateless handle to a actor by its key, but does not create the actor if it doesn't exist.
+     * The actor name is automatically injected from the property accessor.
+     *
+     * @template AD The actor class that this handle is for.
+     * @param {string | string[]} [key=[]] - The key to identify the actor. Can be a single string or an array of strings.
+     * @param {GetWithIdOptions} [opts] - Options for getting the actor.
+     * @returns {ActorHandle<AD>} - A handle to the actor.
+     */
+    get(key?: string | string[], opts?: GetWithIdOptions): ActorHandle<AD>;
+    /**
+     * Gets a stateless handle to a actor by its key, creating it if necessary.
+     * The actor name is automatically injected from the property accessor.
+     *
+     * @template AD The actor class that this handle is for.
+     * @param {string | string[]} [key=[]] - The key to identify the actor. Can be a single string or an array of strings.
+     * @param {GetOptions} [opts] - Options for getting the actor.
+     * @returns {ActorHandle<AD>} - A handle to the actor.
+     */
+    getOrCreate(key?: string | string[], opts?: GetOrCreateOptions): ActorHandle<AD>;
+    /**
+     * Gets a stateless handle to a actor by its ID.
+     *
+     * @template AD The actor class that this handle is for.
+     * @param {string} actorId - The ID of the actor.
+     * @param {GetWithIdOptions} [opts] - Options for getting the actor.
+     * @returns {ActorHandle<AD>} - A handle to the actor.
+     */
+    getForId(actorId: string, opts?: GetWithIdOptions): ActorHandle<AD>;
+    /**
+     * Creates a new actor with the name automatically injected from the property accessor,
+     * and returns a stateless handle to it with the actor ID resolved.
+     *
+     * @template AD The actor class that this handle is for.
+     * @param {string | string[]} key - The key to identify the actor. Can be a single string or an array of strings.
+     * @param {CreateOptions} [opts] - Options for creating the actor (excluding name and key).
+     * @returns {Promise<ActorHandle<AD>>} - A promise that resolves to a handle to the actor.
+     */
+    create(key?: string | string[], opts?: CreateOptions): Promise<ActorHandle<AD>>;
+}
+/**
+ * Options for querying actors.
+ * @typedef {Object} QueryOptions
+ * @property {unknown} [parameters] - Parameters to pass to the connection.
+ */
+interface QueryOptions {
+    /** Parameters to pass to the connection. */
+    params?: unknown;
+    /** Signal to abort the request. */
+    signal?: AbortSignal;
+}
+/**
+ * Options for getting a actor by ID.
+ * @typedef {QueryOptions} GetWithIdOptions
+ */
+interface GetWithIdOptions extends QueryOptions {
+}
+/**
+ * Options for getting a actor.
+ * @typedef {QueryOptions} GetOptions
+ */
+interface GetOptions extends QueryOptions {
+}
+/**
+ * Options for getting or creating a actor.
+ * @typedef {QueryOptions} GetOrCreateOptions
+ * @property {string} [createInRegion] - Region to create the actor in if it doesn't exist.
+ */
+interface GetOrCreateOptions extends QueryOptions {
+    /** Region to create the actor in if it doesn't exist. */
+    createInRegion?: string;
+    /** Input data to pass to the actor. */
+    createWithInput?: unknown;
+}
+/**
+ * Options for creating a actor.
+ * @typedef {QueryOptions} CreateOptions
+ * @property {string} [region] - The region to create the actor in.
+ */
+interface CreateOptions extends QueryOptions {
+    /** The region to create the actor in. */
+    region?: string;
+    /** Input data to pass to the actor. */
+    input?: unknown;
+}
+/**
+ * Represents a region to connect to.
+ * @typedef {Object} Region
+ * @property {string} id - The region ID.
+ * @property {string} name - The region name.
+ * @see {@link https://rivet.dev/docs/edge|Edge Networking}
+ * @see {@link https://rivet.dev/docs/regions|Available Regions}
+ */
+interface Region {
+    /**
+     * The region slug.
+     */
+    id: string;
+    /**
+     * The human-friendly region name.
+     */
+    name: string;
+}
+declare const ACTOR_CONNS_SYMBOL: unique symbol;
+declare const CREATE_ACTOR_CONN_PROXY: unique symbol;
+declare const TRANSPORT_SYMBOL: unique symbol;
+/**
+ * Client for managing & connecting to actors.
+ *
+ * @template A The actors map type that defines the available actors.
+ * @see {@link https://rivet.dev/docs/manage|Create & Manage Actors}
+ */
+declare class ClientRaw {
+    #private;
+    [ACTOR_CONNS_SYMBOL]: Set<ActorConnRaw>;
+    [TRANSPORT_SYMBOL]: Transport;
+    /**
+     * Creates an instance of Client.
+     *
+     * @param {string} managerEndpoint - The manager endpoint. See {@link https://rivet.dev/docs/setup|Initial Setup} for instructions on getting the manager endpoint.
+     * @param {ClientConfig} [opts] - Options for configuring the client.
+     * @see {@link https://rivet.dev/docs/setup|Initial Setup}
+     */
+    constructor(driver: ManagerDriver, opts?: ClientConfig);
+    /**
+     * Gets a stateless handle to a actor by its ID.
+     *
+     * @template AD The actor class that this handle is for.
+     * @param {string} name - The name of the actor.
+     * @param {string} actorId - The ID of the actor.
+     * @param {GetWithIdOptions} [opts] - Options for getting the actor.
+     * @returns {ActorHandle<AD>} - A handle to the actor.
+     */
+    getForId<AD extends AnyActorDefinition>(name: string, actorId: string, opts?: GetWithIdOptions): ActorHandle<AD>;
+    /**
+     * Gets a stateless handle to a actor by its key, but does not create the actor if it doesn't exist.
+     *
+     * @template AD The actor class that this handle is for.
+     * @param {string} name - The name of the actor.
+     * @param {string | string[]} [key=[]] - The key to identify the actor. Can be a single string or an array of strings.
+     * @param {GetWithIdOptions} [opts] - Options for getting the actor.
+     * @returns {ActorHandle<AD>} - A handle to the actor.
+     */
+    get<AD extends AnyActorDefinition>(name: string, key?: string | string[], opts?: GetWithIdOptions): ActorHandle<AD>;
+    /**
+     * Gets a stateless handle to a actor by its key, creating it if necessary.
+     *
+     * @template AD The actor class that this handle is for.
+     * @param {string} name - The name of the actor.
+     * @param {string | string[]} [key=[]] - The key to identify the actor. Can be a single string or an array of strings.
+     * @param {GetOptions} [opts] - Options for getting the actor.
+     * @returns {ActorHandle<AD>} - A handle to the actor.
+     */
+    getOrCreate<AD extends AnyActorDefinition>(name: string, key?: string | string[], opts?: GetOrCreateOptions): ActorHandle<AD>;
+    /**
+     * Creates a new actor with the provided key and returns a stateless handle to it.
+     * Resolves the actor ID and returns a handle with getForId query.
+     *
+     * @template AD The actor class that this handle is for.
+     * @param {string} name - The name of the actor.
+     * @param {string | string[]} key - The key to identify the actor. Can be a single string or an array of strings.
+     * @param {CreateOptions} [opts] - Options for creating the actor (excluding name and key).
+     * @returns {Promise<ActorHandle<AD>>} - A promise that resolves to a handle to the actor.
+     */
+    create<AD extends AnyActorDefinition>(name: string, key?: string | string[], opts?: CreateOptions): Promise<ActorHandle<AD>>;
+    [CREATE_ACTOR_CONN_PROXY]<AD extends AnyActorDefinition>(conn: ActorConnRaw): ActorConn<AD>;
+    /**
+     * Disconnects from all actors.
+     *
+     * @returns {Promise<void>} A promise that resolves when all connections are closed.
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Client type with actor accessors.
+ * This adds property accessors for actor names to the ClientRaw base class.
+ *
+ * @template A The actor registry type.
+ */
+type Client<A extends Registry<any>> = ClientRaw & {
+    [K in keyof ExtractActorsFromRegistry<A>]: ActorAccessor<ExtractActorsFromRegistry<A>[K]>;
+};
+type AnyClient = Client<Registry<any>>;
+declare function createClientWithDriver<A extends Registry<any>>(driver: ManagerDriver, config?: ClientConfig): Client<A>;
 
 /**
  * Context for a remote procedure call.
@@ -1442,565 +1256,1001 @@ declare class ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDat
     #private;
     readonly conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
     /**
-     * Should not be called directly.
+     * Should not be called directly.
+     *
+     * @param actorContext - The actor context
+     * @param conn - The connection associated with the action
+     */
+    constructor(actorContext: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>);
+    /**
+     * Get the actor state
+     */
+    get state(): TState;
+    /**
+     * Get the actor variables
+     */
+    get vars(): TVars;
+    /**
+     * Broadcasts an event to all connected clients.
+     */
+    broadcast(name: string, ...args: any[]): void;
+    /**
+     * Gets the logger instance.
+     */
+    get log(): Logger;
+    /**
+     * Gets actor ID.
+     */
+    get actorId(): string;
+    /**
+     * Gets the actor name.
+     */
+    get name(): string;
+    /**
+     * Gets the actor key.
+     */
+    get key(): ActorKey;
+    /**
+     * Gets the region.
+     */
+    get region(): string;
+    /**
+     * Gets the scheduler.
+     */
+    get schedule(): Schedule;
+    /**
+     * Gets the map of connections.
+     */
+    get conns(): Map<ConnId, Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>>;
+    /**
+     * Returns the client for the given registry.
+     */
+    client<R extends Registry<any>>(): Client<R>;
+    /**
+     * @experimental
+     */
+    get db(): InferDatabaseClient<TDatabase>;
+    /**
+     * Forces the state to get saved.
+     */
+    saveState(opts: SaveStateOptions): Promise<void>;
+    /**
+     * Prevents the actor from sleeping until promise is complete.
+     */
+    waitUntil(promise: Promise<void>): void;
+    /**
+     * AbortSignal that fires when the actor is stopping.
+     */
+    get abortSignal(): AbortSignal;
+    /**
+     * Forces the actor to sleep.
+     *
+     * Not supported on all drivers.
+     *
+     * @experimental
+     */
+    sleep(): void;
+}
+
+type InitContext = ActorContext<undefined, undefined, undefined, undefined, undefined, undefined>;
+interface ActorTypes<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
+    state?: TState;
+    connParams?: TConnParams;
+    connState?: TConnState;
+    vars?: TVars;
+    input?: TInput;
+    database?: TDatabase;
+}
+declare const ActorConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+    onCreate: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onStart: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onStop: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onStateChange: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onBeforeConnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onConnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onDisconnect: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onBeforeActionResponse: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onFetch: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    onWebSocket: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    actions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>>;
+    state: z.ZodOptional<z.ZodAny>;
+    createState: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    connState: z.ZodOptional<z.ZodAny>;
+    createConnState: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    vars: z.ZodOptional<z.ZodAny>;
+    db: z.ZodOptional<z.ZodAny>;
+    createVars: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
+    options: z.ZodDefault<z.ZodObject<{
+        createVarsTimeout: z.ZodDefault<z.ZodNumber>;
+        createConnStateTimeout: z.ZodDefault<z.ZodNumber>;
+        onConnectTimeout: z.ZodDefault<z.ZodNumber>;
+        onStopTimeout: z.ZodDefault<z.ZodNumber>;
+        stateSaveInterval: z.ZodDefault<z.ZodNumber>;
+        actionTimeout: z.ZodDefault<z.ZodNumber>;
+        waitUntilTimeout: z.ZodDefault<z.ZodNumber>;
+        connectionLivenessTimeout: z.ZodDefault<z.ZodNumber>;
+        connectionLivenessInterval: z.ZodDefault<z.ZodNumber>;
+        noSleep: z.ZodDefault<z.ZodBoolean>;
+        sleepTimeout: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        createVarsTimeout: number;
+        createConnStateTimeout: number;
+        onConnectTimeout: number;
+        onStopTimeout: number;
+        stateSaveInterval: number;
+        actionTimeout: number;
+        waitUntilTimeout: number;
+        connectionLivenessTimeout: number;
+        connectionLivenessInterval: number;
+        noSleep: boolean;
+        sleepTimeout: number;
+    }, {
+        createVarsTimeout?: number | undefined;
+        createConnStateTimeout?: number | undefined;
+        onConnectTimeout?: number | undefined;
+        onStopTimeout?: number | undefined;
+        stateSaveInterval?: number | undefined;
+        actionTimeout?: number | undefined;
+        waitUntilTimeout?: number | undefined;
+        connectionLivenessTimeout?: number | undefined;
+        connectionLivenessInterval?: number | undefined;
+        noSleep?: boolean | undefined;
+        sleepTimeout?: number | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    options: {
+        createVarsTimeout: number;
+        createConnStateTimeout: number;
+        onConnectTimeout: number;
+        onStopTimeout: number;
+        stateSaveInterval: number;
+        actionTimeout: number;
+        waitUntilTimeout: number;
+        connectionLivenessTimeout: number;
+        connectionLivenessInterval: number;
+        noSleep: boolean;
+        sleepTimeout: number;
+    };
+    actions: Record<string, (...args: unknown[]) => unknown>;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onStart?: ((...args: unknown[]) => unknown) | undefined;
+    onStop?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onFetch?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}, {
+    state?: any;
+    options?: {
+        createVarsTimeout?: number | undefined;
+        createConnStateTimeout?: number | undefined;
+        onConnectTimeout?: number | undefined;
+        onStopTimeout?: number | undefined;
+        stateSaveInterval?: number | undefined;
+        actionTimeout?: number | undefined;
+        waitUntilTimeout?: number | undefined;
+        connectionLivenessTimeout?: number | undefined;
+        connectionLivenessInterval?: number | undefined;
+        noSleep?: boolean | undefined;
+        sleepTimeout?: number | undefined;
+    } | undefined;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onStart?: ((...args: unknown[]) => unknown) | undefined;
+    onStop?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onFetch?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}>, {
+    options: {
+        createVarsTimeout: number;
+        createConnStateTimeout: number;
+        onConnectTimeout: number;
+        onStopTimeout: number;
+        stateSaveInterval: number;
+        actionTimeout: number;
+        waitUntilTimeout: number;
+        connectionLivenessTimeout: number;
+        connectionLivenessInterval: number;
+        noSleep: boolean;
+        sleepTimeout: number;
+    };
+    actions: Record<string, (...args: unknown[]) => unknown>;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onStart?: ((...args: unknown[]) => unknown) | undefined;
+    onStop?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onFetch?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}, {
+    state?: any;
+    options?: {
+        createVarsTimeout?: number | undefined;
+        createConnStateTimeout?: number | undefined;
+        onConnectTimeout?: number | undefined;
+        onStopTimeout?: number | undefined;
+        stateSaveInterval?: number | undefined;
+        actionTimeout?: number | undefined;
+        waitUntilTimeout?: number | undefined;
+        connectionLivenessTimeout?: number | undefined;
+        connectionLivenessInterval?: number | undefined;
+        noSleep?: boolean | undefined;
+        sleepTimeout?: number | undefined;
+    } | undefined;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onStart?: ((...args: unknown[]) => unknown) | undefined;
+    onStop?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onFetch?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}>, {
+    options: {
+        createVarsTimeout: number;
+        createConnStateTimeout: number;
+        onConnectTimeout: number;
+        onStopTimeout: number;
+        stateSaveInterval: number;
+        actionTimeout: number;
+        waitUntilTimeout: number;
+        connectionLivenessTimeout: number;
+        connectionLivenessInterval: number;
+        noSleep: boolean;
+        sleepTimeout: number;
+    };
+    actions: Record<string, (...args: unknown[]) => unknown>;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onStart?: ((...args: unknown[]) => unknown) | undefined;
+    onStop?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onFetch?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}, {
+    state?: any;
+    options?: {
+        createVarsTimeout?: number | undefined;
+        createConnStateTimeout?: number | undefined;
+        onConnectTimeout?: number | undefined;
+        onStopTimeout?: number | undefined;
+        stateSaveInterval?: number | undefined;
+        actionTimeout?: number | undefined;
+        waitUntilTimeout?: number | undefined;
+        connectionLivenessTimeout?: number | undefined;
+        connectionLivenessInterval?: number | undefined;
+        noSleep?: boolean | undefined;
+        sleepTimeout?: number | undefined;
+    } | undefined;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onStart?: ((...args: unknown[]) => unknown) | undefined;
+    onStop?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onFetch?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}>, {
+    options: {
+        createVarsTimeout: number;
+        createConnStateTimeout: number;
+        onConnectTimeout: number;
+        onStopTimeout: number;
+        stateSaveInterval: number;
+        actionTimeout: number;
+        waitUntilTimeout: number;
+        connectionLivenessTimeout: number;
+        connectionLivenessInterval: number;
+        noSleep: boolean;
+        sleepTimeout: number;
+    };
+    actions: Record<string, (...args: unknown[]) => unknown>;
+    state?: any;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onStart?: ((...args: unknown[]) => unknown) | undefined;
+    onStop?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onFetch?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}, {
+    state?: any;
+    options?: {
+        createVarsTimeout?: number | undefined;
+        createConnStateTimeout?: number | undefined;
+        onConnectTimeout?: number | undefined;
+        onStopTimeout?: number | undefined;
+        stateSaveInterval?: number | undefined;
+        actionTimeout?: number | undefined;
+        waitUntilTimeout?: number | undefined;
+        connectionLivenessTimeout?: number | undefined;
+        connectionLivenessInterval?: number | undefined;
+        noSleep?: boolean | undefined;
+        sleepTimeout?: number | undefined;
+    } | undefined;
+    onCreate?: ((...args: unknown[]) => unknown) | undefined;
+    onStart?: ((...args: unknown[]) => unknown) | undefined;
+    onStop?: ((...args: unknown[]) => unknown) | undefined;
+    onStateChange?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onConnect?: ((...args: unknown[]) => unknown) | undefined;
+    onDisconnect?: ((...args: unknown[]) => unknown) | undefined;
+    onBeforeActionResponse?: ((...args: unknown[]) => unknown) | undefined;
+    onFetch?: ((...args: unknown[]) => unknown) | undefined;
+    onWebSocket?: ((...args: unknown[]) => unknown) | undefined;
+    actions?: Record<string, (...args: unknown[]) => unknown> | undefined;
+    createState?: ((...args: unknown[]) => unknown) | undefined;
+    connState?: any;
+    createConnState?: ((...args: unknown[]) => unknown) | undefined;
+    vars?: any;
+    db?: any;
+    createVars?: ((...args: unknown[]) => unknown) | undefined;
+}>;
+interface OnConnectOptions {
+    /**
+     * The request object associated with the connection.
      *
-     * @param actorContext - The actor context
-     * @param conn - The connection associated with the action
-     */
-    constructor(actorContext: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>);
-    /**
-     * Get the actor state
-     */
-    get state(): TState;
-    /**
-     * Get the actor variables
-     */
-    get vars(): TVars;
-    /**
-     * Broadcasts an event to all connected clients.
-     */
-    broadcast(name: string, ...args: any[]): void;
-    /**
-     * Gets the logger instance.
-     */
-    get log(): Logger;
-    /**
-     * Gets actor ID.
-     */
-    get actorId(): string;
-    /**
-     * Gets the actor name.
-     */
-    get name(): string;
-    /**
-     * Gets the actor key.
-     */
-    get key(): ActorKey;
-    /**
-     * Gets the region.
-     */
-    get region(): string;
-    /**
-     * Gets the scheduler.
-     */
-    get schedule(): Schedule;
-    /**
-     * Gets the map of connections.
-     */
-    get conns(): Map<ConnId, Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>>;
-    /**
-     * Returns the client for the given registry.
-     */
-    client<R extends Registry<any>>(): Client<R>;
-    /**
      * @experimental
      */
-    get db(): InferDatabaseClient<TDatabase>;
-    /**
-     * Forces the state to get saved.
-     */
-    saveState(opts: SaveStateOptions): Promise<void>;
-    /**
-     * Prevents the actor from sleeping until promise is complete.
-     */
-    waitUntil(promise: Promise<void>): void;
+    request?: Request;
+}
+type CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
+    state: TState;
+} | {
+    createState: (c: InitContext, input: TInput) => TState | Promise<TState>;
+} | Record<never, never>;
+type CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
+    connState: TConnState;
+} | {
+    createConnState: (c: InitContext, opts: OnConnectOptions, params: TConnParams) => TConnState | Promise<TConnState>;
+} | Record<never, never>;
+/**
+ * @experimental
+ */
+type CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = {
     /**
-     * AbortSignal that fires when the actor is stopping.
+     * @experimental
      */
-    get abortSignal(): AbortSignal;
+    vars: TVars;
+} | {
     /**
-     * Forces the actor to sleep.
-     *
-     * Not supported on all drivers.
-     *
      * @experimental
      */
-    sleep(): void;
-}
-
-type AnyActorDefinition = ActorDefinition<any, any, any, any, any, any, any>;
-/**
- * Extracts the context type from an ActorDefinition
- */
-type ActorContextOf<AD extends AnyActorDefinition> = AD extends ActorDefinition<infer S, infer CP, infer CS, infer V, infer I, infer DB, any> ? ActorContext<S, CP, CS, V, I, DB> : never;
-/**
- * Extracts the context type from an ActorDefinition
- */
-type ActionContextOf<AD extends AnyActorDefinition> = AD extends ActorDefinition<infer S, infer CP, infer CS, infer V, infer I, infer DB, any> ? ActionContext<S, CP, CS, V, I, DB> : never;
-declare class ActorDefinition<S, CP, CS, V, I, DB extends AnyDatabaseProvider, R extends Actions<S, CP, CS, V, I, DB>> {
-    #private;
-    constructor(config: ActorConfig<S, CP, CS, V, I, DB>);
-    get config(): ActorConfig<S, CP, CS, V, I, DB>;
-    instantiate(): ActorInstance<S, CP, CS, V, I, DB>;
-}
-declare function lookupInRegistry(registryConfig: RegistryConfig, name: string): AnyActorDefinition;
-
-declare const TransportSchema: z.ZodEnum<["websocket", "sse"]>;
-/**
- * Transport mechanism used to communicate between client & actor.
- */
-type Transport = z.infer<typeof TransportSchema>;
-
-/**
- * Action function returned by Actor connections and handles.
- *
- * @typedef {Function} ActorActionFunction
- * @template Args
- * @template Response
- * @param {...Args} args - Arguments for the action function.
- * @returns {Promise<Response>}
- */
-type ActorActionFunction<Args extends Array<unknown> = unknown[], Response = unknown> = (...args: Args extends [unknown, ...infer Rest] ? Rest : Args) => Promise<Response>;
-/**
- * Maps action methods from actor definition to typed function signatures.
- */
-type ActorDefinitionActions<AD extends AnyActorDefinition> = AD extends ActorDefinition<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;
-
-declare class ActorClientError extends Error {
-}
-declare class InternalError extends ActorClientError {
-}
-declare class ManagerError extends ActorClientError {
-    constructor(error: string, opts?: ErrorOptions);
-}
-declare class MalformedResponseMessage extends ActorClientError {
-    constructor(cause?: unknown);
-}
-declare class ActorError extends ActorClientError {
-    readonly group: string;
-    readonly code: string;
-    readonly metadata?: unknown | undefined;
-    __type: string;
-    constructor(group: string, code: string, message: string, metadata?: unknown | undefined);
+    createVars: (c: InitContext, driverCtx: any) => TVars | Promise<TVars>;
+} | Record<never, never>;
+interface Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> {
+    [Action: string]: (c: ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, ...args: any[]) => any;
 }
-
-/**
- * A function that unsubscribes from an event.
- *
- * @typedef {Function} EventUnsubscribe
- */
-type EventUnsubscribe = () => void;
-/**
- * A function that handles connection errors.
- *
- * @typedef {Function} ActorErrorCallback
- */
-type ActorErrorCallback = (error: ActorError) => void;
-declare const CONNECT_SYMBOL: unique symbol;
 /**
- * Provides underlying functions for {@link ActorConn}. See {@link ActorConn} for using type-safe remote procedure calls.
- *
- * @see {@link ActorConn}
+ * @experimental
  */
-declare class ActorConnRaw {
-    #private;
-    /**
-     * Do not call this directly.
-     *
-     * Creates an instance of ActorConnRaw.
-     *
-     * @protected
-     */
-    constructor(client: ClientRaw, driver: ManagerDriver, params: unknown, encoding: Encoding, actorQuery: ActorQuery);
-    /**
-     * Call a raw action connection. See {@link ActorConn} for type-safe action calls.
-     *
-     * @see {@link ActorConn}
-     * @template Args - The type of arguments to pass to the action function.
-     * @template Response - The type of the response returned by the action function.
-     * @param {string} name - The name of the action function to call.
-     * @param {...Args} args - The arguments to pass to the action function.
-     * @returns {Promise<Response>} - A promise that resolves to the response of the action function.
-     */
-    action<Args extends Array<unknown> = unknown[], Response = unknown>(opts: {
-        name: string;
-        args: Args;
-        signal?: AbortSignal;
-    }): Promise<Response>;
+type AuthIntent = "get" | "create" | "connect" | "action" | "message";
+interface BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>> {
     /**
-     * Do not call this directly.
-enc
-     * Establishes a connection to the server using the specified endpoint & encoding & driver.
+     * Called when the actor is first initialized.
      *
-     * @protected
+     * Use this hook to initialize your actor's state.
+     * This is called before any other lifecycle hooks.
      */
-    [CONNECT_SYMBOL](): void;
+    onCreate?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, input: TInput) => void | Promise<void>;
     /**
-     * Subscribes to an event that will happen repeatedly.
+     * Called when the actor is started and ready to receive connections and action.
      *
-     * @template Args - The type of arguments the event callback will receive.
-     * @param {string} eventName - The name of the event to subscribe to.
-     * @param {(...args: Args) => void} callback - The callback function to execute when the event is triggered.
-     * @returns {EventUnsubscribe} - A function to unsubscribe from the event.
-     * @see {@link https://rivet.dev/docs/events|Events Documentation}
+     * Use this hook to initialize resources needed for the actor's operation
+     * (timers, external connections, etc.)
+     *
+     * @returns Void or a Promise that resolves when startup is complete
      */
-    on<Args extends Array<unknown> = unknown[]>(eventName: string, callback: (...args: Args) => void): EventUnsubscribe;
+    onStart?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
     /**
-     * Subscribes to an event that will be triggered only once.
+     * Called when the actor is stopping or sleeping.
      *
-     * @template Args - The type of arguments the event callback will receive.
-     * @param {string} eventName - The name of the event to subscribe to.
-     * @param {(...args: Args) => void} callback - The callback function to execute when the event is triggered.
-     * @returns {EventUnsubscribe} - A function to unsubscribe from the event.
-     * @see {@link https://rivet.dev/docs/events|Events Documentation}
+     * Use this hook to clean up resources, save state, or perform
+     * any shutdown operations before the actor sleeps or stops.
+     *
+     * Not supported on all platforms.
+     *
+     * @returns Void or a Promise that resolves when shutdown is complete
      */
-    once<Args extends Array<unknown> = unknown[]>(eventName: string, callback: (...args: Args) => void): EventUnsubscribe;
+    onStop?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
     /**
-     * Subscribes to connection errors.
+     * Called when the actor's state changes.
      *
-     * @param {ActorErrorCallback} callback - The callback function to execute when a connection error occurs.
-     * @returns {() => void} - A function to unsubscribe from the error handler.
+     * Use this hook to react to state changes, such as updating
+     * external systems or triggering events.
+     *
+     * State changes made within this hook will NOT trigger
+     * another onStateChange call, preventing infinite recursion.
+     *
+     * @param newState The updated state
      */
-    onError(callback: ActorErrorCallback): () => void;
+    onStateChange?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, newState: TState) => void;
     /**
-     * Disconnects from the actor.
+     * Called before a client connects to the actor.
      *
-     * @returns {Promise<void>} A promise that resolves when the socket is gracefully closed.
+     * Use this hook to determine if a connection should be accepted
+     * and to initialize connection-specific state.
+     *
+     * @param opts Connection parameters including client-provided data
+     * @returns The initial connection state or a Promise that resolves to it
+     * @throws Throw an error to reject the connection
      */
-    dispose(): Promise<void>;
-}
-/**
- * Connection to a actor. Allows calling actor's remote procedure calls with inferred types. See {@link ActorConnRaw} for underlying methods.
- *
- * @example
- * ```
- * const room = client.connect<ChatRoom>(...etc...);
- * // This calls the action named `sendMessage` on the `ChatRoom` actor.
- * await room.sendMessage('Hello, world!');
- * ```
- *
- * Private methods (e.g. those starting with `_`) are automatically excluded.
- *
- * @template AD The actor class that this connection is for.
- * @see {@link ActorConnRaw}
- */
-type ActorConn<AD extends AnyActorDefinition> = ActorConnRaw & ActorDefinitionActions<AD>;
-
-/**
- * Provides underlying functions for stateless {@link ActorHandle} for action calls.
- * Similar to ActorConnRaw but doesn't maintain a connection.
- *
- * @see {@link ActorHandle}
- */
-declare class ActorHandleRaw {
-    #private;
+    onBeforeConnect?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, opts: OnConnectOptions, params: TConnParams) => void | Promise<void>;
     /**
-     * Do not call this directly.
+     * Called when a client successfully connects to the actor.
      *
-     * Creates an instance of ActorHandleRaw.
+     * Use this hook to perform actions when a connection is established,
+     * such as sending initial data or updating the actor's state.
      *
-     * @protected
+     * @param conn The connection object
+     * @returns Void or a Promise that resolves when connection handling is complete
      */
-    constructor(client: any, driver: ManagerDriver, params: unknown, encoding: Encoding, actorQuery: ActorQuery);
+    onConnect?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
     /**
-     * Call a raw action. This method sends an HTTP request to invoke the named action.
+     * Called when a client disconnects from the actor.
      *
-     * @see {@link ActorHandle}
-     * @template Args - The type of arguments to pass to the action function.
-     * @template Response - The type of the response returned by the action function.
+     * Use this hook to clean up resources associated with the connection
+     * or update the actor's state.
+     *
+     * @param conn The connection that is being closed
+     * @returns Void or a Promise that resolves when disconnect handling is complete
      */
-    action<Args extends Array<unknown> = unknown[], Response = unknown>(opts: {
-        name: string;
-        args: Args;
-        signal?: AbortSignal;
-    }): Promise<Response>;
+    onDisconnect?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase>) => void | Promise<void>;
     /**
-     * Establishes a persistent connection to the actor.
+     * Called before sending an action response to the client.
      *
-     * @template AD The actor class that this connection is for.
-     * @returns {ActorConn<AD>} A connection to the actor.
+     * Use this hook to modify or transform the output of an action before it's sent
+     * to the client. This is useful for formatting responses, adding metadata,
+     * or applying transformations to the output.
+     *
+     * @param name The name of the action that was called
+     * @param args The arguments that were passed to the action
+     * @param output The output that will be sent to the client
+     * @returns The modified output to send to the client
      */
-    connect(): ActorConn<AnyActorDefinition>;
+    onBeforeActionResponse?: <Out>(c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, name: string, args: unknown[], output: Out) => Out | Promise<Out>;
     /**
-     * Makes a raw HTTP request to the actor.
+     * Called when a raw HTTP request is made to the actor.
      *
-     * @param input - The URL, path, or Request object
-     * @param init - Standard fetch RequestInit options
-     * @returns Promise<Response> - The raw HTTP response
+     * This handler receives raw HTTP requests made to `/actors/{actorName}/http/*` endpoints.
+     * Use this hook to handle custom HTTP patterns, REST APIs, or other HTTP-based protocols.
+     *
+     * @param request The raw HTTP request object
+     * @returns A Response object to send back, or void to continue with default routing
      */
-    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+    onFetch?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, request: Request, opts: {}) => Response | Promise<Response>;
     /**
-     * Creates a raw WebSocket connection to the actor.
+     * Called when a raw WebSocket connection is established to the actor.
      *
-     * @param path - The path for the WebSocket connection (e.g., "stream")
-     * @param protocols - Optional WebSocket subprotocols
-     * @returns WebSocket - A raw WebSocket connection
+     * This handler receives WebSocket connections made to `/actors/{actorName}/websocket/*` endpoints.
+     * Use this hook to handle custom WebSocket protocols, binary streams, or other WebSocket-based communication.
+     *
+     * @param websocket The raw WebSocket connection
+     * @param request The original HTTP upgrade request
      */
-    websocket(path?: string, protocols?: string | string[]): Promise<WebSocket>;
+    onWebSocket?: (c: ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase>, websocket: UniversalWebSocket, opts: {
+        request: Request;
+    }) => void | Promise<void>;
+    actions: TActions;
+}
+type ActorDatabaseConfig<TDatabase extends AnyDatabaseProvider> = {
     /**
-     * Resolves the actor to get its unique actor ID
-     *
-     * @returns {Promise<string>} - A promise that resolves to the actor's ID
+     * @experimental
      */
-    resolve({ signal }?: {
-        signal?: AbortSignal;
-    }): Promise<string>;
+    db: TDatabase;
+} | Record<never, never>;
+type ActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider> = Omit<z.infer<typeof ActorConfigSchema>, "actions" | "onCreate" | "onStart" | "onStateChange" | "onBeforeConnect" | "onConnect" | "onDisconnect" | "onBeforeActionResponse" | "onFetch" | "onWebSocket" | "state" | "createState" | "connState" | "createConnState" | "vars" | "createVars" | "db"> & BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>> & CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & ActorDatabaseConfig<TDatabase>;
+type ActorConfigInput<TState = undefined, TConnParams = undefined, TConnState = undefined, TVars = undefined, TInput = undefined, TDatabase extends AnyDatabaseProvider = undefined, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase> = Record<never, never>> = {
+    types?: ActorTypes<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
+} & Omit<z.input<typeof ActorConfigSchema>, "actions" | "onCreate" | "onStart" | "onStop" | "onStateChange" | "onBeforeConnect" | "onConnect" | "onDisconnect" | "onBeforeActionResponse" | "onFetch" | "onWebSocket" | "state" | "createState" | "connState" | "createConnState" | "vars" | "createVars" | "db"> & BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TActions> & CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase> & ActorDatabaseConfig<TDatabase>;
+declare function test<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase>>(input: ActorConfigInput<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TActions>): ActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase>;
+
+declare const ActorId: z__default.core.$ZodBranded<z__default.ZodString, "ActorId">;
+type ActorId = z__default.infer<typeof ActorId>;
+declare enum ActorFeature {
+    Logs = "logs",
+    Config = "config",
+    Connections = "connections",
+    State = "state",
+    Console = "console",
+    Runtime = "runtime",
+    Metrics = "metrics",
+    EventsMonitoring = "events-monitoring",
+    Database = "database"
+}
+declare const ActorSchema: z__default.ZodObject<{
+    id: z__default.core.$ZodBranded<z__default.ZodString, "ActorId">;
+    name: z__default.ZodString;
+    key: z__default.ZodArray<z__default.ZodString>;
+    tags: z__default.ZodOptional<z__default.ZodRecord<z__default.ZodString, z__default.ZodString>>;
+    region: z__default.ZodOptional<z__default.ZodString>;
+    createdAt: z__default.ZodOptional<z__default.ZodString>;
+    startedAt: z__default.ZodOptional<z__default.ZodString>;
+    destroyedAt: z__default.ZodOptional<z__default.ZodString>;
+    features: z__default.ZodOptional<z__default.ZodArray<z__default.ZodEnum<typeof ActorFeature>>>;
+}, z__default.core.$strip>;
+type Actor = z__default.infer<typeof ActorSchema>;
+declare const ActorLogEntry: z__default.ZodObject<{
+    level: z__default.ZodString;
+    message: z__default.ZodString;
+    timestamp: z__default.ZodString;
+    metadata: z__default.ZodOptional<z__default.ZodRecord<z__default.ZodString, z__default.ZodAny>>;
+}, z__default.core.$strip>;
+type ActorLogEntry = z__default.infer<typeof ActorLogEntry>;
+declare const OperationSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObject<{
+    op: z__default.ZodLiteral<"remove">;
+    path: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    op: z__default.ZodLiteral<"add">;
+    path: z__default.ZodString;
+    value: z__default.ZodUnknown;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    op: z__default.ZodLiteral<"replace">;
+    path: z__default.ZodString;
+    value: z__default.ZodUnknown;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    op: z__default.ZodLiteral<"move">;
+    path: z__default.ZodString;
+    from: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    op: z__default.ZodLiteral<"copy">;
+    path: z__default.ZodString;
+    from: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    op: z__default.ZodLiteral<"test">;
+    path: z__default.ZodString;
+    value: z__default.ZodUnknown;
+}, z__default.core.$strip>]>;
+type Operation = z__default.infer<typeof OperationSchema>;
+declare const PatchSchema: z__default.ZodArray<z__default.ZodDiscriminatedUnion<[z__default.ZodObject<{
+    op: z__default.ZodLiteral<"remove">;
+    path: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    op: z__default.ZodLiteral<"add">;
+    path: z__default.ZodString;
+    value: z__default.ZodUnknown;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    op: z__default.ZodLiteral<"replace">;
+    path: z__default.ZodString;
+    value: z__default.ZodUnknown;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    op: z__default.ZodLiteral<"move">;
+    path: z__default.ZodString;
+    from: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    op: z__default.ZodLiteral<"copy">;
+    path: z__default.ZodString;
+    from: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    op: z__default.ZodLiteral<"test">;
+    path: z__default.ZodString;
+    value: z__default.ZodUnknown;
+}, z__default.core.$strip>]>>;
+type Patch = z__default.infer<typeof PatchSchema>;
+declare const ConnectionSchema: z__default.ZodObject<{
+    params: z__default.ZodOptional<z__default.ZodRecord<z__default.ZodString, z__default.ZodAny>>;
+    id: z__default.ZodString;
+    stateEnabled: z__default.ZodOptional<z__default.ZodBoolean>;
+    state: z__default.ZodOptional<z__default.ZodAny>;
+    auth: z__default.ZodOptional<z__default.ZodRecord<z__default.ZodString, z__default.ZodAny>>;
+}, z__default.core.$strip>;
+type Connection = z__default.infer<typeof ConnectionSchema>;
+declare const RealtimeEventSchema: z__default.ZodDiscriminatedUnion<[z__default.ZodObject<{
+    type: z__default.ZodLiteral<"action">;
+    name: z__default.ZodString;
+    args: z__default.ZodArray<z__default.ZodAny>;
+    connId: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"broadcast">;
+    eventName: z__default.ZodString;
+    args: z__default.ZodArray<z__default.ZodAny>;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"subscribe">;
+    eventName: z__default.ZodString;
+    connId: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"unsubscribe">;
+    eventName: z__default.ZodString;
+    connId: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"event">;
+    eventName: z__default.ZodString;
+    args: z__default.ZodArray<z__default.ZodAny>;
+    connId: z__default.ZodString;
+}, z__default.core.$strip>]>;
+type RealtimeEvent = z__default.infer<typeof RealtimeEventSchema>;
+declare const RecordedRealtimeEventSchema: z__default.ZodIntersection<z__default.ZodDiscriminatedUnion<[z__default.ZodObject<{
+    type: z__default.ZodLiteral<"action">;
+    name: z__default.ZodString;
+    args: z__default.ZodArray<z__default.ZodAny>;
+    connId: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"broadcast">;
+    eventName: z__default.ZodString;
+    args: z__default.ZodArray<z__default.ZodAny>;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"subscribe">;
+    eventName: z__default.ZodString;
+    connId: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"unsubscribe">;
+    eventName: z__default.ZodString;
+    connId: z__default.ZodString;
+}, z__default.core.$strip>, z__default.ZodObject<{
+    type: z__default.ZodLiteral<"event">;
+    eventName: z__default.ZodString;
+    args: z__default.ZodArray<z__default.ZodAny>;
+    connId: z__default.ZodString;
+}, z__default.core.$strip>]>, z__default.ZodObject<{
+    id: z__default.ZodString;
+    timestamp: z__default.ZodNumber;
+}, z__default.core.$strip>>;
+type RecordedRealtimeEvent = z__default.infer<typeof RecordedRealtimeEventSchema>;
+declare const DatabaseQuerySchema: z__default.ZodObject<{
+    sql: z__default.ZodString;
+    args: z__default.ZodArray<z__default.ZodUnion<[z__default.ZodString, z__default.ZodNumber]>>;
+}, z__default.core.$strip>;
+type DatabaseQuery = z__default.infer<typeof DatabaseQuerySchema>;
+declare const TableSchema: z__default.ZodObject<{
+    schema: z__default.ZodString;
+    name: z__default.ZodString;
+    type: z__default.ZodEnum<{
+        table: "table";
+        view: "view";
+    }>;
+}, z__default.core.$strip>;
+type Table = z__default.infer<typeof TableSchema>;
+declare const TablesSchema: z__default.ZodArray<z__default.ZodObject<{
+    schema: z__default.ZodString;
+    name: z__default.ZodString;
+    type: z__default.ZodEnum<{
+        table: "table";
+        view: "view";
+    }>;
+}, z__default.core.$strip>>;
+type Tables = z__default.infer<typeof TablesSchema>;
+declare const ColumnSchema: z__default.ZodObject<{
+    cid: z__default.ZodNumber;
+    name: z__default.ZodString;
+    type: z__default.ZodPipe<z__default.ZodString, z__default.ZodTransform<"integer" | "blob" | "text" | "real" | "numeric" | "serial", string>>;
+    notnull: z__default.ZodCoercedBoolean<unknown>;
+    dflt_value: z__default.ZodNullable<z__default.ZodString>;
+    pk: z__default.ZodNullable<z__default.ZodCoercedBoolean<unknown>>;
+}, z__default.core.$strip>;
+type Column = z__default.infer<typeof ColumnSchema>;
+declare const ColumnsSchema: z__default.ZodArray<z__default.ZodObject<{
+    cid: z__default.ZodNumber;
+    name: z__default.ZodString;
+    type: z__default.ZodPipe<z__default.ZodString, z__default.ZodTransform<"integer" | "blob" | "text" | "real" | "numeric" | "serial", string>>;
+    notnull: z__default.ZodCoercedBoolean<unknown>;
+    dflt_value: z__default.ZodNullable<z__default.ZodString>;
+    pk: z__default.ZodNullable<z__default.ZodCoercedBoolean<unknown>>;
+}, z__default.core.$strip>>;
+type Columns = z__default.infer<typeof ColumnsSchema>;
+declare const ForeignKeySchema: z__default.ZodObject<{
+    id: z__default.ZodNumber;
+    table: z__default.ZodString;
+    from: z__default.ZodString;
+    to: z__default.ZodString;
+}, z__default.core.$strip>;
+type ForeignKey = z__default.infer<typeof ForeignKeySchema>;
+declare const ForeignKeysSchema: z__default.ZodArray<z__default.ZodObject<{
+    id: z__default.ZodNumber;
+    table: z__default.ZodString;
+    from: z__default.ZodString;
+    to: z__default.ZodString;
+}, z__default.core.$strip>>;
+type ForeignKeys = z__default.infer<typeof ForeignKeysSchema>;
+declare const BuildSchema: z__default.ZodObject<{
+    name: z__default.ZodString;
+    createdAt: z__default.ZodOptional<z__default.ZodString>;
+    tags: z__default.ZodOptional<z__default.ZodRecord<z__default.ZodString, z__default.ZodString>>;
+}, z__default.core.$strip>;
+type Build = z__default.infer<typeof BuildSchema>;
+declare const BuildsSchema: z__default.ZodArray<z__default.ZodObject<{
+    name: z__default.ZodString;
+    createdAt: z__default.ZodOptional<z__default.ZodString>;
+    tags: z__default.ZodOptional<z__default.ZodRecord<z__default.ZodString, z__default.ZodString>>;
+}, z__default.core.$strip>>;
+type Builds = z__default.infer<typeof BuildsSchema>;
+declare const CreateActorSchema: z__default.ZodObject<{
+    name: z__default.ZodString;
+    key: z__default.ZodArray<z__default.ZodString>;
+    input: z__default.ZodAny;
+}, z__default.core.$strip>;
+type CreateActor = z__default.infer<typeof CreateActorSchema>;
+
+interface ActorInspectorAccessors {
+    isStateEnabled: () => Promise<boolean>;
+    getState: () => Promise<unknown>;
+    setState: (state: unknown) => Promise<void>;
+    isDbEnabled: () => Promise<boolean>;
+    getDb: () => Promise<InferDatabaseClient<AnyDatabaseProvider>>;
+    getRpcs: () => Promise<string[]>;
+    getConnections: () => Promise<Connection[]>;
+}
+interface ActorInspectorEmitterEvents {
+    stateUpdated: (state: unknown) => void;
+    connectionUpdated: () => void;
+    eventFired: (event: RealtimeEvent) => void;
 }
 /**
- * Stateless handle to a actor. Allows calling actor's remote procedure calls with inferred types
- * without establishing a persistent connection.
- *
- * @example
- * ```
- * const room = client.get<ChatRoom>(...etc...);
- * // This calls the action named `sendMessage` on the `ChatRoom` actor without a connection.
- * await room.sendMessage('Hello, world!');
- * ```
- *
- * Private methods (e.g. those starting with `_`) are automatically excluded.
- *
- * @template AD The actor class that this handle is for.
- * @see {@link ActorHandleRaw}
+ * Provides a unified interface for inspecting actor external and internal state.
  */
-type ActorHandle<AD extends AnyActorDefinition> = Omit<ActorHandleRaw, "connect"> & {
-    connect(): ActorConn<AD>;
-    resolve(): Promise<string>;
-} & ActorDefinitionActions<AD>;
+declare class ActorInspector {
+    #private;
+    readonly accessors: ActorInspectorAccessors;
+    readonly emitter: nanoevents.Emitter<ActorInspectorEmitterEvents>;
+    get lastRealtimeEvents(): (({
+        type: "action";
+        name: string;
+        args: any[];
+        connId: string;
+    } | {
+        type: "broadcast";
+        eventName: string;
+        args: any[];
+    } | {
+        type: "subscribe";
+        eventName: string;
+        connId: string;
+    } | {
+        type: "unsubscribe";
+        eventName: string;
+        connId: string;
+    } | {
+        type: "event";
+        eventName: string;
+        args: any[];
+        connId: string;
+    }) & {
+        id: string;
+        timestamp: number;
+    })[];
+    constructor(accessors: () => ActorInspectorAccessors);
+}
+
+interface ConnSocket {
+    socketId: string;
+    driverState: ConnDriverState;
+}
 
-/** Extract the actor registry from the registry definition. */
-type ExtractActorsFromRegistry<A extends Registry<any>> = A extends Registry<infer Actors> ? Actors : never;
-/** Extract the registry definition from the client. */
-type ExtractRegistryFromClient<C extends Client<Registry<{}>>> = C extends Client<infer A> ? A : never;
 /**
- * Represents a actor accessor that provides methods to interact with a specific actor.
+ * Options for the `_saveState` method.
  */
-interface ActorAccessor<AD extends AnyActorDefinition> {
+interface SaveStateOptions {
+    /**
+     * Forces the state to be saved immediately. This function will return when the state has saved successfully.
+     */
+    immediate?: boolean;
+    /** Bypass ready check for stopping. */
+    allowStoppingState?: boolean;
+}
+/** Actor type alias with all `any` types. Used for `extends` in classes referencing this actor. */
+type AnyActorInstance = ActorInstance<any, any, any, any, any, any>;
+declare class ActorInstance<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
+    #private;
+    actorContext: ActorContext<S, CP, CS, V, I, DB>;
+    get isStopping(): boolean;
+    get id(): string;
+    get inlineClient(): Client<Registry<any>>;
+    get inspector(): ActorInspector;
     /**
-     * Gets a stateless handle to a actor by its key, but does not create the actor if it doesn't exist.
-     * The actor name is automatically injected from the property accessor.
+     * This constructor should never be used directly.
      *
-     * @template AD The actor class that this handle is for.
-     * @param {string | string[]} [key=[]] - The key to identify the actor. Can be a single string or an array of strings.
-     * @param {GetWithIdOptions} [opts] - Options for getting the actor.
-     * @returns {ActorHandle<AD>} - A handle to the actor.
+     * Constructed in {@link ActorInstance.start}.
+     *
+     * @private
      */
-    get(key?: string | string[], opts?: GetWithIdOptions): ActorHandle<AD>;
+    constructor(config: ActorConfig<S, CP, CS, V, I, DB>);
+    start(actorDriver: ActorDriver, inlineClient: Client<Registry<any>>, actorId: string, name: string, key: ActorKey, region: string): Promise<void>;
+    _onAlarm(): Promise<void>;
+    scheduleEvent(timestamp: number, action: string, args: unknown[]): Promise<void>;
+    get stateEnabled(): boolean;
+    get connStateEnabled(): boolean;
+    __getConnForId(id: string): Conn<S, CP, CS, V, I, DB> | undefined;
     /**
-     * Gets a stateless handle to a actor by its key, creating it if necessary.
-     * The actor name is automatically injected from the property accessor.
+     * Connection disconnected.
      *
-     * @template AD The actor class that this handle is for.
-     * @param {string | string[]} [key=[]] - The key to identify the actor. Can be a single string or an array of strings.
-     * @param {GetOptions} [opts] - Options for getting the actor.
-     * @returns {ActorHandle<AD>} - A handle to the actor.
+     * If a clean diconnect, will be removed immediately.
+     *
+     * If not a clean disconnect, will keep the connection alive for a given interval to wait for reconnect.
      */
-    getOrCreate(key?: string | string[], opts?: GetOrCreateOptions): ActorHandle<AD>;
+    __connDisconnected(conn: Conn<S, CP, CS, V, I, DB>, wasClean: boolean, socketId: string): void;
     /**
-     * Gets a stateless handle to a actor by its ID.
-     *
-     * @template AD The actor class that this handle is for.
-     * @param {string} actorId - The ID of the actor.
-     * @param {GetWithIdOptions} [opts] - Options for getting the actor.
-     * @returns {ActorHandle<AD>} - A handle to the actor.
+     * Called to create a new connection or reconnect an existing one.
      */
-    getForId(actorId: string, opts?: GetWithIdOptions): ActorHandle<AD>;
+    createConn(socket: ConnSocket, params: any, request?: Request, connectionId?: string, connectionToken?: string): Promise<Conn<S, CP, CS, V, I, DB>>;
+    processMessage(message: ToServer, conn: Conn<S, CP, CS, V, I, DB>): Promise<void>;
     /**
-     * Creates a new actor with the name automatically injected from the property accessor,
-     * and returns a stateless handle to it with the actor ID resolved.
-     *
-     * @template AD The actor class that this handle is for.
-     * @param {string | string[]} key - The key to identify the actor. Can be a single string or an array of strings.
-     * @param {CreateOptions} [opts] - Options for creating the actor (excluding name and key).
-     * @returns {Promise<ActorHandle<AD>>} - A promise that resolves to a handle to the actor.
+     * Check if the actor is ready to handle requests.
      */
-    create(key?: string | string[], opts?: CreateOptions): Promise<ActorHandle<AD>>;
-}
-/**
- * Options for querying actors.
- * @typedef {Object} QueryOptions
- * @property {unknown} [parameters] - Parameters to pass to the connection.
- */
-interface QueryOptions {
-    /** Parameters to pass to the connection. */
-    params?: unknown;
-    /** Signal to abort the request. */
-    signal?: AbortSignal;
-}
-/**
- * Options for getting a actor by ID.
- * @typedef {QueryOptions} GetWithIdOptions
- */
-interface GetWithIdOptions extends QueryOptions {
-}
-/**
- * Options for getting a actor.
- * @typedef {QueryOptions} GetOptions
- */
-interface GetOptions extends QueryOptions {
-}
-/**
- * Options for getting or creating a actor.
- * @typedef {QueryOptions} GetOrCreateOptions
- * @property {string} [createInRegion] - Region to create the actor in if it doesn't exist.
- */
-interface GetOrCreateOptions extends QueryOptions {
-    /** Region to create the actor in if it doesn't exist. */
-    createInRegion?: string;
-    /** Input data to pass to the actor. */
-    createWithInput?: unknown;
-}
-/**
- * Options for creating a actor.
- * @typedef {QueryOptions} CreateOptions
- * @property {string} [region] - The region to create the actor in.
- */
-interface CreateOptions extends QueryOptions {
-    /** The region to create the actor in. */
-    region?: string;
-    /** Input data to pass to the actor. */
-    input?: unknown;
-}
-/**
- * Represents a region to connect to.
- * @typedef {Object} Region
- * @property {string} id - The region ID.
- * @property {string} name - The region name.
- * @see {@link https://rivet.dev/docs/edge|Edge Networking}
- * @see {@link https://rivet.dev/docs/regions|Available Regions}
- */
-interface Region {
+    isReady(): boolean;
     /**
-     * The region slug.
+     * Returns a list of action methods available on this actor.
      */
-    id: string;
+    get actions(): string[];
     /**
-     * The human-friendly region name.
+     * Handles raw HTTP requests to the actor.
      */
-    name: string;
-}
-declare const ACTOR_CONNS_SYMBOL: unique symbol;
-declare const CREATE_ACTOR_CONN_PROXY: unique symbol;
-declare const TRANSPORT_SYMBOL: unique symbol;
-/**
- * Client for managing & connecting to actors.
- *
- * @template A The actors map type that defines the available actors.
- * @see {@link https://rivet.dev/docs/manage|Create & Manage Actors}
- */
-declare class ClientRaw {
-    #private;
-    [ACTOR_CONNS_SYMBOL]: Set<ActorConnRaw>;
-    [TRANSPORT_SYMBOL]: Transport;
+    handleFetch(request: Request, opts: Record<never, never>): Promise<Response>;
     /**
-     * Creates an instance of Client.
-     *
-     * @param {string} managerEndpoint - The manager endpoint. See {@link https://rivet.dev/docs/setup|Initial Setup} for instructions on getting the manager endpoint.
-     * @param {ClientConfig} [opts] - Options for configuring the client.
-     * @see {@link https://rivet.dev/docs/setup|Initial Setup}
+     * Handles raw WebSocket connections to the actor.
      */
-    constructor(driver: ManagerDriver, opts?: ClientConfig);
+    handleWebSocket(websocket: UniversalWebSocket, opts: {
+        request: Request;
+    }): Promise<void>;
+    get log(): Logger;
+    get rLog(): Logger;
     /**
-     * Gets a stateless handle to a actor by its ID.
-     *
-     * @template AD The actor class that this handle is for.
-     * @param {string} name - The name of the actor.
-     * @param {string} actorId - The ID of the actor.
-     * @param {GetWithIdOptions} [opts] - Options for getting the actor.
-     * @returns {ActorHandle<AD>} - A handle to the actor.
+     * Gets the name.
      */
-    getForId<AD extends AnyActorDefinition>(name: string, actorId: string, opts?: GetWithIdOptions): ActorHandle<AD>;
+    get name(): string;
     /**
-     * Gets a stateless handle to a actor by its key, but does not create the actor if it doesn't exist.
-     *
-     * @template AD The actor class that this handle is for.
-     * @param {string} name - The name of the actor.
-     * @param {string | string[]} [key=[]] - The key to identify the actor. Can be a single string or an array of strings.
-     * @param {GetWithIdOptions} [opts] - Options for getting the actor.
-     * @returns {ActorHandle<AD>} - A handle to the actor.
+     * Gets the key.
      */
-    get<AD extends AnyActorDefinition>(name: string, key?: string | string[], opts?: GetWithIdOptions): ActorHandle<AD>;
+    get key(): ActorKey;
     /**
-     * Gets a stateless handle to a actor by its key, creating it if necessary.
-     *
-     * @template AD The actor class that this handle is for.
-     * @param {string} name - The name of the actor.
-     * @param {string | string[]} [key=[]] - The key to identify the actor. Can be a single string or an array of strings.
-     * @param {GetOptions} [opts] - Options for getting the actor.
-     * @returns {ActorHandle<AD>} - A handle to the actor.
+     * Gets the region.
      */
-    getOrCreate<AD extends AnyActorDefinition>(name: string, key?: string | string[], opts?: GetOrCreateOptions): ActorHandle<AD>;
+    get region(): string;
     /**
-     * Creates a new actor with the provided key and returns a stateless handle to it.
-     * Resolves the actor ID and returns a handle with getForId query.
-     *
-     * @template AD The actor class that this handle is for.
-     * @param {string} name - The name of the actor.
-     * @param {string | string[]} key - The key to identify the actor. Can be a single string or an array of strings.
-     * @param {CreateOptions} [opts] - Options for creating the actor (excluding name and key).
-     * @returns {Promise<ActorHandle<AD>>} - A promise that resolves to a handle to the actor.
+     * Gets the scheduler.
      */
-    create<AD extends AnyActorDefinition>(name: string, key?: string | string[], opts?: CreateOptions): Promise<ActorHandle<AD>>;
-    [CREATE_ACTOR_CONN_PROXY]<AD extends AnyActorDefinition>(conn: ActorConnRaw): ActorConn<AD>;
+    get schedule(): Schedule;
     /**
-     * Disconnects from all actors.
+     * Gets the map of connections.
+     */
+    get conns(): Map<ConnId, Conn<S, CP, CS, V, I, DB>>;
+    /**
+     * Gets the current state.
      *
-     * @returns {Promise<void>} A promise that resolves when all connections are closed.
+     * Changing properties of this value will automatically be persisted.
      */
-    dispose(): Promise<void>;
-}
-/**
- * Client type with actor accessors.
- * This adds property accessors for actor names to the ClientRaw base class.
- *
- * @template A The actor registry type.
- */
-type Client<A extends Registry<any>> = ClientRaw & {
-    [K in keyof ExtractActorsFromRegistry<A>]: ActorAccessor<ExtractActorsFromRegistry<A>[K]>;
-};
-type AnyClient = Client<Registry<any>>;
-declare function createClientWithDriver<A extends Registry<any>>(driver: ManagerDriver, config?: ClientConfig): Client<A>;
-
-type ConnectionDriversMap = Record<ConnectionDriver, ConnDriver>;
-type ActorDriverBuilder = (registryConfig: RegistryConfig, runConfig: RunConfig, managerDriver: ManagerDriver, inlineClient: AnyClient) => ActorDriver;
-interface ActorDriver {
-    loadActor(actorId: string): Promise<AnyActorInstance>;
-    getGenericConnGlobalState(actorId: string): GenericConnGlobalState;
-    getContext(actorId: string): unknown;
-    readPersistedData(actorId: string): Promise<Uint8Array | undefined>;
-    /** ActorInstance ensure that only one instance of writePersistedData is called in parallel at a time. */
-    writePersistedData(actorId: string, data: Uint8Array): Promise<void>;
-    /** ActorInstance ensure that only one instance of setAlarm is called in parallel at a time. */
-    setAlarm(actor: AnyActorInstance, timestamp: number): Promise<void>;
+    get state(): S;
     /**
+     * Gets the database.
      * @experimental
-     * This is an experimental API that may change in the future.
+     * @throws {DatabaseNotEnabled} If the database is not enabled.
      */
-    getDatabase(actorId: string): Promise<unknown | undefined>;
-    sleep?(actorId: string): Promise<void>;
-    shutdown?(immediate: boolean): Promise<void>;
-}
-declare enum ConnectionReadyState {
-    UNKNOWN = -1,
-    CONNECTING = 0,
-    OPEN = 1,
-    CLOSING = 2,
-    CLOSED = 3
-}
-interface ConnDriver<ConnDriverState = unknown> {
-    sendMessage?(actor: AnyActorInstance, conn: AnyConn, state: ConnDriverState, message: CachedSerializer<ToClient>): void;
+    get db(): InferDatabaseClient<DB>;
+    /**
+     * Sets the current state.
+     *
+     * This property will automatically be persisted.
+     */
+    set state(value: S);
+    get vars(): V;
+    /**
+     * Broadcasts an event to all connected clients.
+     * @param name - The name of the event.
+     * @param args - The arguments to send with the event.
+     */
+    _broadcast<Args extends Array<unknown>>(name: string, ...args: Args): void;
     /**
-     * This returns a promise since we commonly disconnect at the end of a program, and not waiting will cause the socket to not close cleanly.
+     * Prevents the actor from sleeping until promise is complete.
+     *
+     * This allows the actor runtime to ensure that a promise completes while
+     * returning from an action request early.
+     *
+     * @param promise - The promise to run in the background.
      */
-    disconnect(actor: AnyActorInstance, conn: AnyConn, state: ConnDriverState, reason?: string): Promise<void>;
+    _waitUntil(promise: Promise<void>): void;
     /**
-     * Returns the ready state of the connection.
-     * This is used to determine if the connection is ready to send messages, or if the connection is stale.
+     * Forces the state to get saved.
+     *
+     * This is helpful if running a long task that may fail later or when
+     * running a background job that updates the state.
+     *
+     * @param opts - Options for saving the state.
      */
-    getConnectionReadyState(actor: AnyActorInstance, conn: AnyConn): ConnectionReadyState | undefined;
+    saveState(opts: SaveStateOptions): Promise<void>;
+    /** Puts an actor to sleep. This should just start the sleep sequence, most shutdown logic should be in _stop (which is called by the ActorDriver when sleeping). */
+    _sleep(): Promise<void>;
+    _stop(): Promise<void>;
+    /** Abort signal that fires when the actor is stopping. */
+    get abortSignal(): AbortSignal;
+}
+
+declare enum ConnDriverKind {
+    WEBSOCKET = 0,
+    SSE = 1,
+    HTTP = 2
 }
+interface ConnDriverWebSocketState {
+    encoding: Encoding;
+    websocket: WSContext;
+    closePromise: ReturnType<typeof promiseWithResolvers<void>>;
+}
+interface ConnDriverSseState {
+    encoding: Encoding;
+    stream: SSEStreamingApi;
+}
+type ConnDriverHttpState = Record<never, never>;
+type ConnDriverState = {
+    [ConnDriverKind.WEBSOCKET]: ConnDriverWebSocketState;
+} | {
+    [ConnDriverKind.SSE]: ConnDriverSseState;
+} | {
+    [ConnDriverKind.HTTP]: ConnDriverHttpState;
+};
 
 /** Object representing connection that gets persisted to storage. */
 interface PersistedConn<CP, CS> {
     connId: string;
     token: string;
-    connDriver: ConnectionDriver;
-    connDriverState: unknown;
     params: CP;
     state: CS;
-    authData?: unknown;
     subscriptions: PersistedSubscription[];
+    /** Last time the socket was seen. This is set when disconencted so we can determine when we need to clean this up. */
     lastSeen: number;
 }
 interface PersistedSubscription {
@@ -2010,11 +2260,6 @@ interface PersistedSubscription {
 declare function generateConnId(): string;
 declare function generateConnToken(): string;
 type ConnId = string;
-type AnyConn = Conn<any, any, any, any, any, any>;
-declare const CONNECTION_DRIVER_WEBSOCKET = "webSocket";
-declare const CONNECTION_DRIVER_SSE = "sse";
-declare const CONNECTION_DRIVER_HTTP = "http";
-type ConnectionDriver = typeof CONNECTION_DRIVER_WEBSOCKET | typeof CONNECTION_DRIVER_SSE | typeof CONNECTION_DRIVER_HTTP;
 type ConnectionStatus = "connected" | "reconnecting";
 /**
  * Represents a client connection to a actor.
@@ -2032,9 +2277,16 @@ declare class Conn<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
      * Any data that should be stored indefinitely should be held within this object.
      */
     __persist: PersistedConn<CP, CS>;
+    get __driverState(): ConnDriverState | undefined;
+    /**
+     * Socket connected to this connection.
+     *
+     * If undefined, then nothing is connected to this.
+     */
+    __socket?: ConnSocket;
+    get __status(): ConnectionStatus;
     get params(): CP;
-    get driver(): ConnectionDriver;
-    get _stateEnabled(): boolean;
+    get __stateEnabled(): boolean;
     /**
      * Gets the current state of the connection.
      *
@@ -2070,7 +2322,7 @@ declare class Conn<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
      *
      * @protected
      */
-    constructor(actor: ActorInstance<S, CP, CS, V, I, DB>, persist: PersistedConn<CP, CS>, driver: ConnDriver, stateEnabled: boolean);
+    constructor(actor: ActorInstance<S, CP, CS, V, I, DB>, persist: PersistedConn<CP, CS>);
     /**
      * Sends a WebSocket message to the client.
      *
@@ -2095,4 +2347,4 @@ declare class Conn<S, CP, CS, V, I, DB extends AnyDatabaseProvider> {
     disconnect(reason?: string): Promise<void>;
 }
 
-export { ManagerError as $, type ActorDriver as A, type AnyActorInstance as B, type Client as C, type DriverConfig as D, type Encoding as E, type ActorTypes as F, GenericConnGlobalState as G, ActorConfigSchema as H, type InitContext as I, type AuthIntent as J, type ActorConfig as K, test as L, type RegistryConfig as M, type RegistryActors as N, type OnConnectOptions as O, type RunConfigInput as P, RegistryConfigSchema as Q, type RivetEvent as R, Registry as S, setup as T, type UniversalWebSocket as U, type ClientConfigInput as V, type Transport as W, ActorClientError as X, ActorError as Y, InternalError as Z, MalformedResponseMessage as _, type RivetCloseEvent as a, type CreateRequest as a0, type ActorActionFunction as a1, type ActorConn as a2, type EventUnsubscribe as a3, ActorConnRaw as a4, type ActorHandle as a5, ActorHandleRaw as a6, type ActorAccessor as a7, ClientRaw as a8, type CreateOptions as a9, type ExtractActorsFromRegistry as aa, type ExtractRegistryFromClient as ab, type GetOptions as ac, type GetWithIdOptions as ad, type QueryOptions as ae, type Region as af, ActorInstance as ag, type ActorOutput as ah, type CreateInput as ai, type GetForIdInput as aj, type GetOrCreateWithKeyInput as ak, type GetWithKeyInput as al, type ManagerDisplayInformation as am, type ManagerDriver as an, DriverConfigSchema as ao, RunConfigSchema as ap, type RivetMessageEvent as b, type RunConfig as c, type AnyDatabaseProvider as d, type Actions as e, type ActorConfigInput as f, ActorDefinition as g, generateConnId as h, generateConnToken as i, type AnyClient as j, createClientWithDriver as k, type ActorQuery as l, type ActorKey as m, ActionContext as n, Conn as o, type ConnectionDriver as p, type ConnectionStatus as q, CONNECTION_DRIVER_HTTP as r, CONNECTION_DRIVER_SSE as s, CONNECTION_DRIVER_WEBSOCKET as t, ActorContext as u, type ActionContextOf as v, type ActorContextOf as w, type AnyActorDefinition as x, lookupInRegistry as y, createGenericConnDrivers as z };
+export { type ActorHandle as $, type ActorDriver as A, test as B, type Client as C, type DriverConfig as D, type Encoding as E, type RegistryConfig as F, type RegistryActors as G, type RunConfigInput as H, type InitContext as I, RegistryConfigSchema as J, Registry as K, setup as L, type ClientConfigInput as M, ActorClientError as N, type OnConnectOptions as O, ActorError as P, InternalError as Q, type RivetEvent as R, MalformedResponseMessage as S, type Transport as T, type UniversalWebSocket as U, ManagerError as V, type CreateRequest as W, type ActorActionFunction as X, type ActorConn as Y, type EventUnsubscribe as Z, ActorConnRaw as _, type RivetCloseEvent as a, ActorHandleRaw as a0, type ActorAccessor as a1, ClientRaw as a2, type CreateOptions as a3, type ExtractActorsFromRegistry as a4, type ExtractRegistryFromClient as a5, type GetOptions as a6, type GetWithIdOptions as a7, type QueryOptions as a8, type Region as a9, type DatabaseQuery as aA, TableSchema as aB, type Table as aC, TablesSchema as aD, type Tables as aE, ColumnSchema as aF, type Column as aG, ColumnsSchema as aH, type Columns as aI, ForeignKeySchema as aJ, type ForeignKey as aK, ForeignKeysSchema as aL, type ForeignKeys as aM, BuildSchema as aN, type Build as aO, BuildsSchema as aP, type Builds as aQ, CreateActorSchema as aR, type CreateActor as aS, ActorInstance as aa, type ActorOutput as ab, type CreateInput as ac, type GetForIdInput as ad, type GetOrCreateWithKeyInput as ae, type GetWithKeyInput as af, type ManagerDisplayInformation as ag, type ManagerDriver as ah, DriverConfigSchema as ai, RunConfigSchema as aj, ActorFeature as ak, ActorId as al, ActorLogEntry as am, ActorSchema as an, type Actor as ao, OperationSchema as ap, type Operation as aq, PatchSchema as ar, type Patch as as, ConnectionSchema as at, type Connection as au, RealtimeEventSchema as av, type RealtimeEvent as aw, RecordedRealtimeEventSchema as ax, type RecordedRealtimeEvent as ay, DatabaseQuerySchema as az, type RivetMessageEvent as b, type RunConfig as c, type AnyDatabaseProvider as d, type Actions as e, type ActorConfigInput as f, ActorDefinition as g, generateConnId as h, generateConnToken as i, type AnyClient as j, createClientWithDriver as k, type ActorQuery as l, type ActorKey as m, ActionContext as n, Conn as o, type ConnectionStatus as p, ActorContext as q, type ActionContextOf as r, type ActorContextOf as s, type AnyActorDefinition as t, lookupInRegistry as u, type AnyActorInstance as v, type ActorTypes as w, ActorConfigSchema as x, type AuthIntent as y, type ActorConfig as z };