rivetkit 2.3.27 → 2.3.29

package/dist/tsup/agent-os/index.d.cts

@@ -1,2718 +1,2 @@
-import * as _rivet_dev_agent_os_core from '@rivet-dev/agent-os-core';
-import { AgentOs, JsonRpcNotification, PermissionRequest, CronEvent, AgentCapabilities, AgentInfo, JsonRpcResponse, AgentOsOptions, BatchReadResult, BatchWriteEntry, BatchWriteResult, ReaddirRecursiveOptions, DirEntry, AgentRegistryEntry, SpawnedProcessInfo, ProcessInfo, ProcessTreeNode, SessionModeState, SessionConfigOption, GetEventsOptions, SequencedEvent, PermissionReply, AgentType, CreateSessionOptions, SessionInfo, OpenShellOptions } from '@rivet-dev/agent-os-core';
-import { z as z$1 } from 'zod/v4';
-import { StandardSchemaV1 } from '@standard-schema/spec';
-import { Rivet } from '@rivetkit/engine-api-full';
-import { Context, Handler, Hono } from 'hono';
-import { UniversalWebSocket } from '@rivetkit/virtual-websocket';
-import * as _rivetkit_rivetkit_wasm from '@rivetkit/rivetkit-wasm';
-import { z } from 'zod';
-import { Logger } from 'pino';
-import { ContentfulStatusCode } from 'hono/utils/http-status';
 
-type AnyDatabaseProvider = DatabaseProvider<any> | undefined;
-interface ActorMetricsLike {
-    totalKvReads: number;
-    totalKvWrites: number;
-    trackSql(query: string, durationMs: number): void;
-}
-type InferDatabaseClient<DBProvider extends AnyDatabaseProvider> = DBProvider extends DatabaseProvider<any> ? Awaited<ReturnType<DBProvider["createClient"]>> : RawAccess;
-type SqliteBindings = unknown[] | Record<string, unknown>;
-interface SqliteQueryResult {
-    columns: string[];
-    rows: unknown[][];
-}
-interface SqliteExecuteResult extends SqliteQueryResult {
-    changes: number;
-    lastInsertRowId?: number | null;
-}
-interface SqliteBatchStatement {
-    sql: string;
-    params?: SqliteBindings;
-}
-interface SqliteTransactionOptions {
-    /** Static operation name used to aggregate transaction performance. */
-    name?: string;
-    /** Deadlock-safety timeout in milliseconds. */
-    timeout?: number;
-    /** @experimental */
-    experimental?: {
-        /**
-         * Atomically includes actor and hibernatable connection state.
-         * Only single-statement `execute` calls are supported in the transaction.
-         * Concurrent actions that try to mutate state while the transaction is
-         * active fail with `actor.state_transaction_conflict`.
-         */
-        includeState?: boolean;
-    };
-}
-/**
- * SQLite profiling configuration.
- *
- * @experimental This entire configuration surface is experimental and subject
- * to change without notice.
- */
-interface SqliteProfilingOptions {
-    enabled?: boolean;
-    maxTrackedStatementFingerprints?: number;
-    maxTrackedTransactionFingerprints?: number;
-    maxPrometheusSeries?: number;
-    maxStatementsPerTransactionTrace?: number;
-    maxGetPagesRequestsPerTrace?: number;
-    maxTransactionNameBytes?: number;
-    slowOperationThresholdMs?: number;
-    baselineSampleRate?: number;
-    maxDiagnosticEventsPerMinute?: number;
-    diagnosticEventQueueCapacity?: number;
-}
-interface SqliteNativeMetrics {
-    requestBuildNs: number;
-    serializeNs: number;
-    transportNs: number;
-    stateUpdateNs: number;
-    totalNs: number;
-    commitCount: number;
-    pageCacheEntries: number;
-    pageCacheWeightedSize: number;
-    pageCacheCapacityPages: number;
-    writeBufferDirtyPages: number;
-    dbSizePages: number;
-}
-interface SqliteDatabase {
-    exec(sql: string, callback?: (row: unknown[], columns: string[]) => void): Promise<void>;
-    execute(sql: string, params?: SqliteBindings): Promise<SqliteExecuteResult>;
-    executeBatch(statements: SqliteBatchStatement[]): Promise<SqliteExecuteResult[]>;
-    beginTransaction(timeoutMs?: number, name?: string): Promise<SqliteTransactionDatabase>;
-    run(sql: string, params?: SqliteBindings): Promise<void>;
-    query(sql: string, params?: SqliteBindings): Promise<SqliteQueryResult>;
-    nativeMetrics?(): SqliteNativeMetrics | Promise<SqliteNativeMetrics | null> | null;
-    close(): Promise<void>;
-}
-interface SqliteTransactionDatabase {
-    exec(sql: string, callback?: (row: unknown[], columns: string[]) => void): Promise<void>;
-    execute(sql: string, params?: SqliteBindings): Promise<SqliteExecuteResult>;
-    commit(): Promise<void>;
-    rollback(): Promise<void>;
-}
-/**
- * Provider for opening native databases from the active runtime.
- */
-interface NativeDatabaseProvider {
-    open(actorId: string): Promise<SqliteDatabase>;
-}
-/**
- * Context provided to database providers for creating database clients
- */
-interface DatabaseProviderContext {
-    /**
-     * Actor ID
-     */
-    actorId: string;
-    /**
-     * Override the default Drizzle database client (optional).
-     * If not provided, a KV-backed client will be constructed.
-     */
-    overrideDrizzleDatabaseClient?: () => Promise<DrizzleDatabaseClient | undefined>;
-    /** KV operations exposed for custom database providers. */
-    kv: {
-        batchPut: (entries: [Uint8Array, Uint8Array][]) => Promise<void>;
-        batchGet: (keys: Uint8Array[]) => Promise<(Uint8Array | null)[]>;
-        batchDelete: (keys: Uint8Array[]) => Promise<void>;
-        deleteRange: (start: Uint8Array, end: Uint8Array) => Promise<void>;
-    };
-    /**
-     * Actor metrics instance. When provided, KV and SQL operations are tracked.
-     */
-    metrics?: ActorMetricsLike;
-    /**
-     * Logger for debug output. When provided, SQL queries are logged with
-     * duration and KV call count.
-     */
-    log?: {
-        debug(obj: Record<string, unknown>): void;
-    };
-    /**
-     * Provider for opening native databases from the active runtime.
-     */
-    nativeDatabaseProvider?: NativeDatabaseProvider;
-}
-type DatabaseProvider<DB extends RawAccess> = {
-    /**
-     * Local SQLite profiling controls consumed by the actor runtime.
-     *
-     * @experimental This entire configuration surface is experimental and
-     * subject to change without notice.
-     */
-    sqliteProfiling?: SqliteProfilingOptions;
-    /**
-     * Creates a new database client for the actor.
-     * The result is passed to the actor context as `c.db`.
-     * @experimental
-     */
-    createClient: (ctx: DatabaseProviderContext) => Promise<DB>;
-    /**
-     * Runs before the actor has started.
-     * Use this to run migrations or other setup tasks.
-     * @experimental
-     */
-    onMigrate: (client: DB) => void | Promise<void>;
-};
-/**
- * Drizzle database client interface (will be extended by drizzle-orm types)
- */
-type DrizzleDatabaseClient = {};
-type ExecuteFunction = <TRow extends Record<string, unknown> = Record<string, unknown>>(query: string, ...args: unknown[]) => Promise<TRow[]>;
-type RawAccess = {
-    /**
-     * Executes a raw SQL query.
-     */
-    execute: ExecuteFunction;
-    /** Runs a callback in an isolated SQLite transaction. */
-    transaction: <T>(callback: (tx: RawAccess) => Promise<T> | T, options?: SqliteTransactionOptions) => Promise<T>;
-    /**
-     * Returns native SQLite metrics when the active runtime supports them.
-     */
-    nativeMetrics?: () => SqliteNativeMetrics | Promise<SqliteNativeMetrics | null> | null;
-    /**
-     * Closes the database connection and releases resources.
-     */
-    close: () => Promise<void>;
-};
-
-declare const ActorsSchema: z.ZodRecord<z.ZodString, z.ZodCustom<AnyActorDefinition, AnyActorDefinition>>;
-type RegistryActors = z.infer<typeof ActorsSchema>;
-declare const RegistryConfigSchema: z.ZodPipe<z.ZodObject<{
-    use: z.ZodRecord<z.ZodString, z.ZodCustom<AnyActorDefinition, AnyActorDefinition>>;
-    test: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-        sqliteBackend: z.ZodOptional<z.ZodEnum<{
-            local: "local";
-            remote: "remote";
-        }>>;
-    }, z.core.$strip>>>;
-    maxIncomingMessageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    maxOutgoingMessageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    runtime: z.ZodPipe<z.ZodOptional<z.ZodEnum<{
-        auto: "auto";
-        native: "native";
-        wasm: "wasm";
-    }>>, z.ZodTransform<"auto" | "native" | "wasm", "auto" | "native" | "wasm" | undefined>>;
-    wasm: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        bindings: z.ZodOptional<z.ZodCustom<typeof _rivetkit_rivetkit_wasm, typeof _rivetkit_rivetkit_wasm>>;
-        initInput: z.ZodOptional<z.ZodCustom<any, any>>;
-    }, z.core.$strip>>>;
-    sqlite: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
-        local: "local";
-        remote: "remote";
-    }>, z.ZodObject<{
-        backend: z.ZodEnum<{
-            local: "local";
-            remote: "remote";
-        }>;
-    }, z.core.$strip>]>>, z.ZodTransform<{
-        backend: "local" | "remote";
-    } | undefined, "local" | "remote" | {
-        backend: "local" | "remote";
-    } | undefined>>;
-    noWelcome: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    logging: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        baseLogger: z.ZodOptional<z.ZodCustom<Logger, Logger>>;
-        level: z.ZodOptional<z.ZodEnum<{
-            fatal: "fatal";
-            error: "error";
-            warn: "warn";
-            info: "info";
-            debug: "debug";
-            trace: "trace";
-            silent: "silent";
-        }>>;
-    }, z.core.$strip>>>;
-    endpoint: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
-    token: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
-    namespace: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
-    headers: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>>;
-    staticDir: z.ZodOptional<z.ZodString>;
-    httpBasePath: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    httpPort: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    httpHost: z.ZodOptional<z.ZodString>;
-    startEngine: z.ZodDefault<z.ZodBoolean>;
-    engineHost: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    enginePort: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    engineVersion: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    startServices: z.ZodOptional<z.ZodBoolean>;
-    configurePool: z.ZodOptional<z.ZodOptional<z.ZodObject<{
-        name: z.ZodOptional<z.ZodString>;
-        url: z.ZodString;
-        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        requestLifespan: z.ZodOptional<z.ZodNumber>;
-        drainGracePeriod: z.ZodOptional<z.ZodNumber>;
-        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        metadataPollInterval: z.ZodOptional<z.ZodNumber>;
-        drainOnVersionUpgrade: z.ZodOptional<z.ZodBoolean>;
-    }, z.core.$strip>>>;
-    serverless: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        basePath: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-        maxStartPayloadBytes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-        publicEndpoint: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
-        publicToken: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
-    }, z.core.$strip>>>;
-    envoy: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        poolName: z.ZodDefault<z.ZodString>;
-        version: z.ZodDefault<z.ZodNumber>;
-        totalSlots: z.ZodDefault<z.ZodNumber>;
-        envoyKey: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>>;
-    shutdown: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        gracePeriodMs: z.ZodOptional<z.ZodNumber>;
-        disableSignalHandlers: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>, z.ZodTransform<{
-    sqlite: {
-        backend: "local" | "remote";
-    } | undefined;
-    endpoint: string | undefined;
-    startServices: boolean;
-    namespace: string;
-    token: string | undefined;
-    publicEndpoint: string | undefined;
-    publicNamespace: string | undefined;
-    publicToken: string | undefined;
-    validateServerlessEndpoint: boolean;
-    serverless: {
-        publicEndpoint: string | undefined;
-        basePath: string;
-        maxStartPayloadBytes: number;
-        publicToken: string | undefined;
-    };
-    use: Record<string, AnyActorDefinition>;
-    test: {
-        enabled: boolean;
-        sqliteBackend?: "local" | "remote" | undefined;
-    };
-    maxIncomingMessageSize: number;
-    maxOutgoingMessageSize: number;
-    runtime: "auto" | "native" | "wasm";
-    wasm: {
-        bindings?: typeof _rivetkit_rivetkit_wasm | undefined;
-        initInput?: any;
-    };
-    noWelcome: boolean;
-    logging: {
-        baseLogger?: Logger | undefined;
-        level?: "fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent" | undefined;
-    };
-    headers: Record<string, string>;
-    httpBasePath: string;
-    httpPort: number;
-    startEngine: boolean;
-    engineHost: string;
-    enginePort: number;
-    engineVersion: string;
-    envoy: {
-        poolName: string;
-        version: number;
-        totalSlots: number;
-        envoyKey?: string | undefined;
-    };
-    shutdown: {
-        disableSignalHandlers: boolean;
-        gracePeriodMs?: number | undefined;
-    };
-    staticDir?: string | undefined;
-    httpHost?: string | undefined;
-    configurePool?: {
-        url: string;
-        name?: string | undefined;
-        headers?: Record<string, string> | undefined;
-        requestLifespan?: number | undefined;
-        drainGracePeriod?: number | undefined;
-        metadata?: Record<string, unknown> | undefined;
-        metadataPollInterval?: number | undefined;
-        drainOnVersionUpgrade?: boolean | undefined;
-    } | undefined;
-}, {
-    use: Record<string, AnyActorDefinition>;
-    test: {
-        enabled: boolean;
-        sqliteBackend?: "local" | "remote" | undefined;
-    };
-    maxIncomingMessageSize: number;
-    maxOutgoingMessageSize: number;
-    runtime: "auto" | "native" | "wasm";
-    wasm: {
-        bindings?: typeof _rivetkit_rivetkit_wasm | undefined;
-        initInput?: any;
-    };
-    sqlite: {
-        backend: "local" | "remote";
-    } | undefined;
-    noWelcome: boolean;
-    logging: {
-        baseLogger?: Logger | undefined;
-        level?: "fatal" | "error" | "warn" | "info" | "debug" | "trace" | "silent" | undefined;
-    };
-    endpoint: string | undefined;
-    token: string | undefined;
-    namespace: string | undefined;
-    headers: Record<string, string>;
-    httpBasePath: string;
-    httpPort: number;
-    startEngine: boolean;
-    engineHost: string;
-    enginePort: number;
-    engineVersion: string;
-    serverless: {
-        basePath: string;
-        maxStartPayloadBytes: number;
-        publicEndpoint: string | undefined;
-        publicToken: string | undefined;
-    };
-    envoy: {
-        poolName: string;
-        version: number;
-        totalSlots: number;
-        envoyKey?: string | undefined;
-    };
-    shutdown: {
-        disableSignalHandlers: boolean;
-        gracePeriodMs?: number | undefined;
-    };
-    staticDir?: string | undefined;
-    httpHost?: string | undefined;
-    startServices?: boolean | undefined;
-    configurePool?: {
-        url: string;
-        name?: string | undefined;
-        headers?: Record<string, string> | undefined;
-        requestLifespan?: number | undefined;
-        drainGracePeriod?: number | undefined;
-        metadata?: Record<string, unknown> | undefined;
-        metadataPollInterval?: number | undefined;
-        drainOnVersionUpgrade?: boolean | undefined;
-    } | undefined;
-}>>;
-type RegistryConfig = z.infer<typeof RegistryConfigSchema>;
-type RegistryConfigInput<A extends RegistryActors> = Omit<z.input<typeof RegistryConfigSchema>, "use"> & {
-    use: A;
-};
-
-type SchemaHookResult = boolean | Promise<boolean>;
-type SchemaHook<TContext = any> = (ctx: TContext) => SchemaHookResult;
-interface EventTypeToken<T, TContext = any> {
-    readonly _eventType?: T;
-    readonly canSubscribe?: SchemaHook<TContext>;
-    readonly schema?: PrimitiveSchema;
-}
-interface QueueTypeToken<TMessage, TComplete = never, TContext = any> {
-    readonly _queueMessage?: TMessage;
-    readonly _queueComplete?: TComplete;
-    readonly canPublish?: SchemaHook<TContext>;
-    readonly message?: PrimitiveSchema;
-    readonly complete?: PrimitiveSchema;
-}
-type PrimitiveSchema = StandardSchemaV1 | EventTypeToken<unknown, any>;
-interface EventSchemaDefinition<TContext = any> {
-    schema: PrimitiveSchema;
-    canSubscribe?: SchemaHook<TContext>;
-}
-interface QueueSchemaDefinition<TContext = any> {
-    message: PrimitiveSchema;
-    complete?: PrimitiveSchema;
-    canPublish?: SchemaHook<TContext>;
-}
-type EventSchema<TContext = any> = PrimitiveSchema | EventSchemaDefinition<TContext>;
-type QueueSchema = PrimitiveSchema | QueueSchemaDefinition<any> | QueueTypeToken<unknown, unknown, any>;
-type EventSchemaConfig<TContext = any> = Record<string, EventSchema<TContext>>;
-type QueueSchemaConfig<_TContext = any> = Record<string, QueueSchema>;
-type InferSchema<T> = T extends QueueSchemaDefinition<any> ? InferSchema<T["message"]> : T extends QueueTypeToken<infer M, unknown, any> ? M : T extends EventSchemaDefinition<any> ? InferSchema<T["schema"]> : T extends StandardSchemaV1<any, infer O> ? O : T extends EventTypeToken<infer R, any> ? R : never;
-type InferSchemaMap<T extends Record<string, unknown>> = {
-    [K in keyof T]: InferSchema<T[K]>;
-};
-type InferQueueComplete<T> = T extends QueueTypeToken<unknown, infer C, any> ? [C] extends [never] ? never : C : T extends QueueSchemaDefinition<any> ? T["complete"] extends PrimitiveSchema ? InferSchema<T["complete"]> : never : never;
-type InferQueueCompleteMap<T extends QueueSchemaConfig> = {
-    [K in keyof T]: InferQueueComplete<T[K]>;
-};
-type InferEventArgs<T> = T extends readonly unknown[] ? number extends T["length"] ? [T] : T : [T];
-
-interface BaseActorDefinition<S, CP, CS, V, I, DB extends AnyDatabaseProvider, E extends EventSchemaConfig = Record<never, never>, Q extends QueueSchemaConfig = Record<never, never>, _R extends Actions<S, CP, CS, V, I, DB, E, Q> = Actions<S, CP, CS, V, I, DB, E, Q>> {
-    readonly config: ActorConfig<S, CP, CS, V, I, DB, E, Q, _R>;
-}
-interface AnyActorDefinition {
-    readonly config: any;
-}
-declare class ActorDefinition<S, CP, CS, V, I, DB extends AnyDatabaseProvider, E extends EventSchemaConfig = Record<never, never>, Q extends QueueSchemaConfig = Record<never, never>, R extends Actions<S, CP, CS, V, I, DB, E, Q> = Actions<S, CP, CS, V, I, DB, E, Q>> implements BaseActorDefinition<S, CP, CS, V, I, DB, E, Q, R> {
-    #private;
-    constructor(config: ActorConfig<S, CP, CS, V, I, DB, E, Q, R>);
-    get config(): ActorConfig<S, CP, CS, V, I, DB, E, Q, R>;
-}
-
-/** Options for `client.auth.issueToken()`. `expiresIn` is in seconds. */
-type IssueTokenOptions = Pick<Rivet.AuthTokenCreateRequest, "subject" | "grants"> & {
-    expiresIn?: Rivet.AuthTokenCreateRequest["duration"];
-};
-/** Token timestamps are Unix milliseconds. */
-interface IssuedToken {
-    token: Rivet.AuthTokenCreateResponse["token"];
-    issuedAt: Rivet.AuthTokenCreateResponse["issuedTs"];
-    expiresAt: Rivet.AuthTokenCreateResponse["expiresTs"];
-}
-/** Resources that can be scoped to a single actor ID. */
-type ActorTokenResource = Extract<Rivet.AuthTokenGrant["resource"], "actor_gateway" | "actor" | "actor_kv">;
-type ActorTokenPermissions = Partial<Record<ActorTokenResource, Rivet.AuthTokenGrant["operations"]>>;
-/** Options for `actor.issueToken()`. Omit permissions for gateway read access only. */
-type ActorIssueTokenOptions = Pick<IssueTokenOptions, "subject" | "expiresIn"> & {
-    permissions?: ActorTokenPermissions;
-};
-
-declare const EncodingSchema: z$1.ZodEnum<{
-    json: "json";
-    cbor: "cbor";
-    bare: "bare";
-}>;
-/**
- * Encoding used to communicate between the client & actor.
- */
-type Encoding = z$1.infer<typeof EncodingSchema>;
-
-declare const ActorKeySchema: z$1.ZodArray<z$1.ZodString>;
-type ActorKey = z$1.infer<typeof ActorKeySchema>;
-/**
- * Crash policy for actor lifecycle management.
- *
- * This schema is only used by the engine driver for actor creation. The manager
- * driver ignores crash policy and passes it through to the engine unchanged.
- */
-declare const CrashPolicySchema: z$1.ZodEnum<{
-    restart: "restart";
-    sleep: "sleep";
-    destroy: "destroy";
-}>;
-type CrashPolicy = z$1.infer<typeof CrashPolicySchema>;
-declare const ActorQuerySchema: z$1.ZodUnion<readonly [z$1.ZodObject<{
-    getForId: z$1.ZodObject<{
-        name: z$1.ZodString;
-        actorId: z$1.ZodString;
-    }, z$1.core.$strip>;
-}, z$1.core.$strip>, z$1.ZodObject<{
-    getForKey: z$1.ZodObject<{
-        name: z$1.ZodString;
-        key: z$1.ZodArray<z$1.ZodString>;
-    }, z$1.core.$strip>;
-}, z$1.core.$strip>, z$1.ZodObject<{
-    getOrCreateForKey: z$1.ZodObject<{
-        name: z$1.ZodString;
-        key: z$1.ZodArray<z$1.ZodString>;
-        input: z$1.ZodOptional<z$1.ZodUnknown>;
-        region: z$1.ZodOptional<z$1.ZodString>;
-        poolName: z$1.ZodOptional<z$1.ZodString>;
-    }, z$1.core.$strip>;
-}, z$1.core.$strip>, z$1.ZodObject<{
-    create: z$1.ZodObject<{
-        name: z$1.ZodString;
-        key: z$1.ZodArray<z$1.ZodString>;
-        input: z$1.ZodOptional<z$1.ZodUnknown>;
-        region: z$1.ZodOptional<z$1.ZodString>;
-        poolName: z$1.ZodOptional<z$1.ZodString>;
-    }, z$1.core.$strip>;
-}, z$1.core.$strip>]>;
-type ActorQuery = z$1.infer<typeof ActorQuerySchema>;
-
-interface DeconstructedError {
-    __type: "ActorError";
-    statusCode: ContentfulStatusCode;
-    public: boolean;
-    group: string;
-    code: string;
-    message: string;
-    metadata?: unknown;
-    rayId?: string;
-    actor?: ActorSpecifier;
-}
-
-interface RivetErrorOptions extends ErrorOptions {
-    /** Error data can safely be serialized in a response to the client. */
-    public?: boolean;
-    /** Metadata associated with this error. */
-    metadata?: unknown;
-    /** Request identifier used to correlate this error with engine logs. */
-    rayId?: string;
-    /** Explicit HTTP status override for router responses. */
-    statusCode?: number;
-    /** Actor context associated with this error. */
-    actor?: ActorSpecifier;
-}
-/** Identifies the actor that was handling work when an error was produced. */
-interface ActorSpecifier {
-    actorId: string;
-    generation: number;
-    key?: string;
-}
-declare class RivetError extends Error {
-    __type: "RivetError";
-    public: boolean;
-    metadata?: unknown;
-    readonly rayId?: string;
-    statusCode: number;
-    actor?: ActorSpecifier;
-    readonly group: string;
-    readonly code: string;
-    static isRivetError(error: unknown): error is RivetError | DeconstructedError;
-    static isActorError(error: unknown): error is RivetError | DeconstructedError;
-    constructor(group: string, code: string, message: string, options?: RivetErrorOptions | unknown);
-    toString(): string;
-}
-
-/** Sample rates keyed by action name, nested like the actor's action groups. */
-interface ActionSampleRates {
-    readonly [name: string]: number | ActionSampleRates;
-}
-/**
- * {@link ActionSampleRates} limited to the actions of one actor, so a rate for
- * an action that does not exist is a compile error.
- */
-type ActionTraceSamplers<TActions> = {
-    readonly [K in keyof TActions]?: TActions[K] extends (...args: never[]) => unknown ? number : ActionTraceSamplers<TActions[K]>;
-};
-/** Trace sampling for one actor definition. */
-interface ActorTracingOptions<TActions> {
-    /**
-     * Share of this actor's invocations that are recorded, from 0 to 1. A rate
-     * lowers what is recorded and never raises it, so an invocation inside a
-     * trace the caller did not record is not recorded at any rate.
-     */
-    readonly sampler?: number;
-    /** Rates that replace `sampler` for single actions. */
-    readonly actions?: ActionTraceSamplers<TActions>;
-}
-
-type UpgradeWebSocket = (createEvents: (c: Context) => any) => Handler;
-type GetUpgradeWebSocket = () => UpgradeWebSocket;
-
-type GatewayTarget = {
-    directId: string;
-} | ActorQuery;
-interface GatewayRequestOptions {
-    skipReadyWait?: boolean;
-}
-interface EngineControlClient {
-    issueToken(options: IssueTokenOptions): Promise<IssuedToken>;
-    getForId(input: GetForIdInput): Promise<ActorOutput | undefined>;
-    getWithKey(input: GetWithKeyInput): Promise<ActorOutput | undefined>;
-    getOrCreateWithKey(input: GetOrCreateWithKeyInput): Promise<ActorOutput>;
-    createActor(input: CreateInput): Promise<ActorOutput>;
-    listActors(input: ListActorsInput): Promise<ActorOutput[]>;
-    sendRequest(target: GatewayTarget, actorRequest: Request, options?: GatewayRequestOptions): Promise<Response>;
-    openWebSocket(path: string, target: GatewayTarget, encoding: Encoding, params: unknown, options?: GatewayRequestOptions): Promise<UniversalWebSocket>;
-    /** Refresh a credential rejected during this WebSocket handshake, if supported. */
-    refreshAuthToken?(ws: UniversalWebSocket): Promise<boolean>;
-    proxyRequest(c: Context, actorRequest: Request, actorId: string): Promise<Response>;
-    proxyWebSocket(c: Context, path: string, actorId: string, encoding: Encoding, params: unknown): Promise<Response>;
-    buildGatewayUrl(target: GatewayTarget, options?: GatewayRequestOptions): Promise<string>;
-    displayInformation(): RuntimeDisplayInformation;
-    extraStartupLog?: () => Record<string, unknown>;
-    modifyRuntimeRouter?: (config: RegistryConfig, router: Hono) => void;
-    setGetUpgradeWebSocket(getUpgradeWebSocket: GetUpgradeWebSocket): void;
-    shutdown?(): void;
-    /**
-     * Test-only helper that simulates an abrupt actor crash.
-     */
-    hardCrashActor?(actorId: string): Promise<void>;
-}
-interface RuntimeDisplayInformation {
-    properties: Record<string, string>;
-}
-interface GetForIdInput {
-    c?: Context | undefined;
-    name: string;
-    actorId: string;
-}
-interface GetWithKeyInput {
-    c?: Context | undefined;
-    name: string;
-    key: ActorKey;
-}
-interface GetOrCreateWithKeyInput {
-    c?: Context | undefined;
-    name: string;
-    key: ActorKey;
-    input?: unknown;
-    region?: string;
-    crashPolicy?: CrashPolicy;
-    /** Overrides the client's configured pool name for this actor. */
-    poolName?: string;
-}
-interface CreateInput {
-    c?: Context | undefined;
-    name: string;
-    key: ActorKey;
-    input?: unknown;
-    region?: string;
-    crashPolicy?: CrashPolicy;
-    /** Overrides the client's configured pool name for this actor. */
-    poolName?: string;
-}
-interface ListActorsInput {
-    c?: Context | undefined;
-    name: string;
-    key?: string;
-    includeDestroyed?: boolean;
-}
-interface ActorOutput {
-    actorId: string;
-    name: string;
-    key: ActorKey;
-    createTs?: number;
-    startTs?: number | null;
-    connectableTs?: number | null;
-    sleepTs?: number | null;
-    destroyTs?: number | null;
-    error?: unknown;
-}
-
-/** Correlation owned by the currently executing Core actor invocation. */
-interface ActorInvocationTraceContext {
-    /** Ray ID the invocation received, absent when nothing upstream supplied one. */
-    readonly rayId?: string;
-    /** Core-owned invocation span context, absent when tracing is disabled. */
-    readonly span?: ActorInvocationSpanContext;
-}
-/** W3C span context of the Core invocation span. */
-interface ActorInvocationSpanContext {
-    /** W3C trace identifier. */
-    readonly traceId: string;
-    /** W3C span identifier for the Core invocation. */
-    readonly spanId: string;
-    /** OpenTelemetry trace flags encoded as an integer. */
-    readonly traceFlags: number;
-    /** Optional vendor trace state inherited by the Core invocation. */
-    readonly tracestate?: string;
-}
-
-declare const handleBrand: unique symbol;
-type OpaqueHandle<Name extends string> = {
-    readonly [handleBrand]: Name;
-};
-type RegistryHandle = OpaqueHandle<"registry">;
-type ActorFactoryHandle = OpaqueHandle<"actorFactory">;
-type ActorContextHandle = OpaqueHandle<"actorContext">;
-type ConnHandle = OpaqueHandle<"conn">;
-type WebSocketHandle = OpaqueHandle<"webSocket">;
-type CancellationTokenHandle = OpaqueHandle<"cancellationToken">;
-type ActorStateTransactionHandle = OpaqueHandle<"actorStateTransaction">;
-type SqliteTransactionHandle = OpaqueHandle<"sqliteTransaction">;
-type RuntimeBytes = Uint8Array;
-interface RuntimeActorKeySegment {
-    kind: string;
-    stringValue?: string;
-    numberValue?: number;
-}
-/** Resolves correlation at operation time so retained clients cannot freeze stale context. */
-type CurrentActorInvocation = () => ActorInvocationTraceContext | undefined;
-/** One open call from an actor out to another actor. */
-interface RuntimeOutboundCall {
-    /**
-     * W3C context of the call's own span, to send to the callee so it parents to
-     * the call. Absent when tracing is disabled.
-     */
-    readonly span?: ActorInvocationSpanContext;
-    /**
-     * Records the call's outcome. `error` is the failure encoded the way the
-     * bridge encodes errors, so a structured error keeps its group and code.
-     */
-    finish(error?: string): void;
-}
-/**
- * Opens the span covering one call out to another actor, or returns `undefined`
- * outside an invocation or on a runtime without invocation telemetry. Callers
- * send their own context when it returns nothing.
- */
-type StartCallSpan = (actorName: string, actionName: string) => RuntimeOutboundCall | undefined;
-interface RuntimeHttpRequest {
-    method: string;
-    uri: string;
-    headers?: Record<string, string>;
-    body?: RuntimeBytes;
-}
-interface RuntimeHttpResponseBodyStream {
-    cancelled(): Promise<void>;
-    write(chunk: Uint8Array): Promise<void>;
-    end(): Promise<void>;
-    error(message: string): Promise<void>;
-}
-interface RuntimeStateDeltaPayload {
-    state?: RuntimeBytes;
-    connHibernation: Array<{
-        connId: string;
-        bytes: RuntimeBytes;
-    }>;
-    connHibernationRemoved: string[];
-}
-interface RuntimeWorkflowKvWrite {
-    key: RuntimeBytes;
-    value: RuntimeBytes;
-}
-interface RuntimeRequestSaveOpts {
-    immediate?: boolean;
-    maxWaitMs?: number;
-}
-interface RuntimeInspectorSnapshot {
-    stateRevision: number;
-    connectionsRevision: number;
-    queueRevision: number;
-    activeConnections: number;
-    queueSize: number;
-    connectedClients: number;
-}
-interface RuntimeQueueMessage {
-    id(): bigint;
-    name(): string;
-    body(): RuntimeBytes;
-    createdAt(): number;
-    isCompletable(): boolean;
-    complete(response?: RuntimeBytes | undefined | null): Promise<void>;
-}
-interface RuntimeQueueInspectMessage {
-    id: number;
-    name: string;
-    createdAtMs: number;
-}
-interface RuntimeScheduledEventInfo {
-    id: string;
-    action: string;
-    args: RuntimeBytes;
-    runAt: number;
-}
-interface RuntimeCronJobInfo {
-    name: string;
-    kind: "cron" | "every";
-    action: string;
-    args: RuntimeBytes;
-    nextRunAt: number;
-    lastRunAt?: number;
-    expression?: string;
-    timezone?: string;
-    intervalMs?: number;
-    maxHistory: number;
-}
-interface RuntimeScheduleErrorInfo {
-    group: string;
-    code: string;
-    message: string;
-    metadata?: unknown;
-}
-interface RuntimeCronFire {
-    action: string;
-    scheduledAt: number;
-    firedAt: number;
-    finishedAt?: number;
-    result: "running" | "ok" | "error" | "skipped";
-    error?: RuntimeScheduleErrorInfo;
-}
-interface RuntimeQueueNextBatchOptions {
-    names?: string[];
-    count?: number;
-    timeoutMs?: number;
-    completable?: boolean;
-}
-interface RuntimeQueueWaitOptions {
-    timeoutMs?: number;
-    completable?: boolean;
-}
-interface RuntimeQueueEnqueueAndWaitOptions {
-    timeoutMs?: number;
-}
-interface RuntimeQueueTryNextBatchOptions {
-    names?: string[];
-    count?: number;
-    completable?: boolean;
-}
-interface RuntimeKvListOptions {
-    reverse?: boolean;
-    limit?: number;
-}
-interface RuntimeKvEntry {
-    key: RuntimeBytes;
-    value: RuntimeBytes;
-}
-type RuntimeSqlBindNoValues = {
-    intValue?: never;
-    floatValue?: never;
-    textValue?: never;
-    blobValue?: never;
-};
-type RuntimeSqlBindParam = ({
-    kind: "null";
-} & RuntimeSqlBindNoValues) | {
-    kind: "int";
-    intValue: number;
-    floatValue?: never;
-    textValue?: never;
-    blobValue?: never;
-} | {
-    kind: "float";
-    intValue?: never;
-    floatValue: number;
-    textValue?: never;
-    blobValue?: never;
-} | {
-    kind: "text";
-    intValue?: never;
-    floatValue?: never;
-    textValue: string;
-    blobValue?: never;
-} | {
-    kind: "blob";
-    intValue?: never;
-    floatValue?: never;
-    textValue?: never;
-    blobValue: RuntimeBytes;
-};
-type RuntimeSqlBindParams = RuntimeSqlBindParam[] | null;
-interface RuntimeActorRuntimeSocketEndpointInfo {
-    path: string;
-}
-interface RuntimeSqlQueryResult {
-    columns: string[];
-    rows: unknown[][];
-}
-type RuntimeSqlExecResult = RuntimeSqlQueryResult;
-interface RuntimeSqlExecuteResult extends RuntimeSqlQueryResult {
-    changes: number;
-    lastInsertRowId?: number | null;
-}
-interface RuntimeSqlBatchStatement {
-    sql: string;
-    params?: RuntimeSqlBindParams;
-}
-interface RuntimeSqlRunResult {
-    changes: number;
-}
-/** Sample rates for the traces an actor starts, in the shape core takes. */
-interface RuntimeActorTracingConfig {
-    sampler?: number;
-    /** Keyed by flattened, dot-separated action name. */
-    actions?: Record<string, number>;
-}
-interface RuntimeActorConfig {
-    name?: string;
-    icon?: string;
-    hasDatabase?: boolean;
-    remoteSqlite?: boolean;
-    sqliteProfiling?: SqliteProfilingOptions;
-    tracing?: RuntimeActorTracingConfig;
-    enableActorRuntimeSocket?: boolean;
-    hasState?: boolean;
-    canHibernateWebsocket?: boolean;
-    stateSaveIntervalMs?: number;
-    createStateTimeoutMs?: number;
-    onCreateTimeoutMs?: number;
-    createVarsTimeoutMs?: number;
-    createConnStateTimeoutMs?: number;
-    onBeforeConnectTimeoutMs?: number;
-    onConnectTimeoutMs?: number;
-    onMigrateTimeoutMs?: number;
-    onWakeTimeoutMs?: number;
-    onBeforeActorStartTimeoutMs?: number;
-    actionTimeoutMs?: number;
-    onRequestTimeoutMs?: number;
-    sleepTimeoutMs?: number;
-    noSleep?: boolean;
-    sleepGracePeriodMs?: number;
-    connectionLivenessTimeoutMs?: number;
-    connectionLivenessIntervalMs?: number;
-    maxQueueSize?: number;
-    maxSchedules?: number;
-    maxQueueMessageSize?: number;
-    maxIncomingMessageSize?: number;
-    maxOutgoingMessageSize?: number;
-    preloadMaxWorkflowBytes?: number;
-    preloadMaxConnectionsBytes?: number;
-    actions?: Array<{
-        name: string;
-    }>;
-    inspectorTabs?: Array<RuntimeInspectorTabEntry>;
-}
-interface RuntimeInspectorTabEntry {
-    id: string;
-    /** Required for custom entries; omitted for built-in hides. */
-    label?: string;
-    /**
-     * Required for custom entries — absolute path to the source directory.
-     * Resolved on the TS side before being handed to the runtime.
-     */
-    source?: string;
-    /** Optional icon id for custom entries. */
-    icon?: string;
-    /** Set to true for built-in hide entries. */
-    hidden?: boolean;
-}
-interface RuntimeServeConfig {
-    version: number;
-    endpoint: string;
-    token?: string;
-    namespace: string;
-    poolName: string;
-    engineBinaryPath?: string;
-    startServices?: boolean;
-    servicesBinaryPath?: string;
-    engineHost?: string;
-    enginePort?: number;
-    handleInspectorHttpInRuntime?: boolean;
-    inspectorTestToken?: string;
-    serverlessBasePath?: string;
-    serverlessPackageVersion: string;
-    serverlessClientEndpoint?: string;
-    serverlessClientNamespace?: string;
-    serverlessClientToken?: string;
-    serverlessValidateEndpoint: boolean;
-    serverlessMaxStartPayloadBytes: number;
-}
-interface RuntimeListenerConfig {
-    port: number;
-    host?: string;
-    publicDir?: string;
-    application?: RuntimeApplicationFetch;
-}
-interface RuntimeServerlessRequest {
-    method: string;
-    url: string;
-    headers: Record<string, string>;
-    body: RuntimeBytes;
-}
-interface RuntimeApplicationRequest extends RuntimeServerlessRequest {
-    cancelToken?: CancellationTokenHandle;
-}
-interface RuntimeApplicationResponse {
-    status: number;
-    headers: Record<string, string>;
-    body?: RuntimeBytes;
-    stream?: boolean;
-}
-type RuntimeApplicationFetch = (request: RuntimeApplicationRequest, responseBodyStream?: RuntimeHttpResponseBodyStream) => Promise<RuntimeApplicationResponse>;
-interface RuntimeApplicationListenerConfig extends RuntimeListenerConfig {
-    application: RuntimeApplicationFetch;
-}
-interface RuntimeServerlessResponseHead {
-    status: number;
-    headers: Record<string, string>;
-}
-interface RuntimeRegistryRouteResponse {
-    status: number;
-    headers: Record<string, string>;
-    body: RuntimeBytes;
-}
-type RuntimeServerlessStreamEvent = {
-    kind: "chunk";
-    chunk?: RuntimeBytes;
-} | {
-    kind: "end";
-    error?: {
-        group: string;
-        code: string;
-        message: string;
-    };
-};
-type RuntimeServerlessStreamCallback = (error: unknown, event?: RuntimeServerlessStreamEvent) => unknown;
-type RuntimeWebSocketEvent = {
-    kind: "message";
-    data: string | RuntimeBytes;
-    binary: boolean;
-    messageIndex?: number;
-} | {
-    kind: "close";
-    code: number;
-    reason: string;
-    wasClean: boolean;
-};
-interface CoreRuntime {
-    readonly kind: "napi" | "wasm";
-    createRegistry(): RegistryHandle;
-    registerActor(registry: RegistryHandle, name: string, factory: ActorFactoryHandle): void;
-    serveRegistry(registry: RegistryHandle, config: RuntimeServeConfig): Promise<void>;
-    waitRegistryReady(registry: RegistryHandle): Promise<void>;
-    shutdownRegistry(registry: RegistryHandle): Promise<void>;
-    shutdownTelemetry?(): Promise<void>;
-    registryActorStopThresholdMs?(registry: RegistryHandle): Promise<number | undefined>;
-    handleServerlessRequest(registry: RegistryHandle, req: RuntimeServerlessRequest, onStreamEvent: RuntimeServerlessStreamCallback, cancelToken: CancellationTokenHandle, config: RuntimeServeConfig): Promise<RuntimeServerlessResponseHead>;
-    serveListener(registry: RegistryHandle, listener: RuntimeListenerConfig, config: RuntimeServeConfig): Promise<void>;
-    serveApplicationListener(registry: RegistryHandle, listener: RuntimeApplicationListenerConfig, config: RuntimeServeConfig): Promise<void>;
-    registryHealth?(registry: RegistryHandle): Promise<RuntimeRegistryRouteResponse>;
-    registryMetadata?(registry: RegistryHandle): Promise<RuntimeRegistryRouteResponse>;
-    registryMetrics?(registry: RegistryHandle): Promise<RuntimeRegistryRouteResponse>;
-    createActorFactory(callbacks: object, config?: RuntimeActorConfig | undefined | null): ActorFactoryHandle;
-    createCancellationToken(): CancellationTokenHandle;
-    cancellationTokenAborted(token: CancellationTokenHandle): boolean;
-    cancelCancellationToken(token: CancellationTokenHandle): void;
-    onCancellationTokenCancelled(token: CancellationTokenHandle, callback: (...args: unknown[]) => unknown): void;
-    actorState(ctx: ActorContextHandle): RuntimeBytes;
-    actorBeginOnStateChange(ctx: ActorContextHandle): void;
-    actorEndOnStateChange(ctx: ActorContextHandle): void;
-    actorSetAlarm(ctx: ActorContextHandle, timestampMs?: number | undefined | null): void;
-    actorSetRunWakeAt(ctx: ActorContextHandle, timestampMs?: number | undefined | null): Promise<void>;
-    actorRequestSave(ctx: ActorContextHandle, opts?: RuntimeRequestSaveOpts | undefined | null): void;
-    actorRequestSaveAndWait(ctx: ActorContextHandle, opts?: RuntimeRequestSaveOpts | undefined | null): Promise<void>;
-    actorInspectorSnapshot(ctx: ActorContextHandle): RuntimeInspectorSnapshot;
-    actorDecodeInspectorRequest(ctx: ActorContextHandle, bytes: RuntimeBytes, advertisedVersion: number): RuntimeBytes;
-    actorEncodeInspectorResponse(ctx: ActorContextHandle, bytes: RuntimeBytes, targetVersion: number): RuntimeBytes;
-    actorVerifyInspectorAuth(ctx: ActorContextHandle, bearerToken?: string | undefined | null): Promise<void>;
-    actorQueueHibernationRemoval(ctx: ActorContextHandle, connId: string): void;
-    actorTakePendingHibernationChanges(ctx: ActorContextHandle): string[];
-    actorDirtyHibernatableConns(ctx: ActorContextHandle): ConnHandle[];
-    actorSaveState(ctx: ActorContextHandle, payload: RuntimeStateDeltaPayload): Promise<void>;
-    actorSaveStateAndWorkflowBatch(ctx: ActorContextHandle, writes: RuntimeWorkflowKvWrite[]): Promise<void>;
-    actorId(ctx: ActorContextHandle): string;
-    /**
-     * Runs one actor callback with `ctx` as the current invocation: operations
-     * on retained handles for the same actor resolve to it, and its Core span
-     * is the active OpenTelemetry span for the duration of `run`. Only actions,
-     * raw requests, and queue dispatch run this way; other callbacks have no
-     * invocation span.
-     */
-    runWithActorInvocationContext<T>(ctx: ActorContextHandle, run: () => T): T;
-    /**
-     * Correlation of the invocation currently executing for this actor, or
-     * `undefined` outside an invocation or after it finished. A sampled-out
-     * invocation can still expose valid span context for propagation.
-     */
-    actorInvocationTraceContext(ctx: ActorContextHandle): ActorInvocationTraceContext | undefined;
-    /**
-     * Opens the span covering one call this actor makes to another actor. See
-     * `StartCallSpan` for when this returns nothing.
-     */
-    startCallSpan(ctx: ActorContextHandle, actorName: string, actionName: string): RuntimeOutboundCall | undefined;
-    /** Backs `ActorRun.startWorkflowSpan`. */
-    startWorkflowSpan(ctx: ActorContextHandle): Promise<WorkflowSpan>;
-    /** Backs `ActorRun.runOutsideWorkflowSpan`. */
-    runOutsideActorInvocationContext<T>(run: () => T): T;
-    /** Identity of the invocation the caller runs in, usable as a cache key. */
-    currentInvocationScope(): object | undefined;
-    actorName(ctx: ActorContextHandle): string;
-    actorKey(ctx: ActorContextHandle): RuntimeActorKeySegment[];
-    actorRegion(ctx: ActorContextHandle): string;
-    actorSleep(ctx: ActorContextHandle): void;
-    actorDestroy(ctx: ActorContextHandle): void;
-    actorAbortSignal(ctx: ActorContextHandle): AbortSignal;
-    actorConns(ctx: ActorContextHandle): ConnHandle[];
-    actorConnectConn(ctx: ActorContextHandle, params: RuntimeBytes, request?: RuntimeHttpRequest | undefined | null): Promise<ConnHandle>;
-    actorBroadcast(ctx: ActorContextHandle, name: string, args: RuntimeBytes): void;
-    actorWaitUntil(ctx: ActorContextHandle, promise: Promise<unknown>): void;
-    actorWaitForTrackedShutdownWork(ctx: ActorContextHandle): Promise<boolean>;
-    actorWaitForTrackedShutdownWorkUnbounded(ctx: ActorContextHandle): Promise<void>;
-    actorKeepAwake(ctx: ActorContextHandle, promise: Promise<unknown>): void;
-    actorBeginKeepAwake(ctx: ActorContextHandle): number;
-    actorEndKeepAwake(ctx: ActorContextHandle, regionId: number): void;
-    actorRegisterTask(ctx: ActorContextHandle, promise: Promise<unknown>): void;
-    actorRuntimeState(ctx: ActorContextHandle): object;
-    actorClearRuntimeState(ctx: ActorContextHandle): void;
-    actorRestartRunHandler(ctx: ActorContextHandle): void;
-    actorBeginWebsocketCallback(ctx: ActorContextHandle): number;
-    actorEndWebsocketCallback(ctx: ActorContextHandle, regionId: number): void;
-    actorKvGet(ctx: ActorContextHandle, key: RuntimeBytes): Promise<RuntimeBytes | null>;
-    actorKvPut(ctx: ActorContextHandle, key: RuntimeBytes, value: RuntimeBytes): Promise<void>;
-    actorKvDelete(ctx: ActorContextHandle, key: RuntimeBytes): Promise<void>;
-    actorKvDeleteRange(ctx: ActorContextHandle, start: RuntimeBytes, end: RuntimeBytes): Promise<void>;
-    actorKvListPrefix(ctx: ActorContextHandle, prefix: RuntimeBytes, options?: RuntimeKvListOptions | undefined | null): Promise<RuntimeKvEntry[]>;
-    actorKvListRange(ctx: ActorContextHandle, start: RuntimeBytes, end: RuntimeBytes, options?: RuntimeKvListOptions | undefined | null): Promise<RuntimeKvEntry[]>;
-    actorKvBatchGet(ctx: ActorContextHandle, keys: RuntimeBytes[]): Promise<Array<RuntimeBytes | undefined | null>>;
-    actorKvBatchPut(ctx: ActorContextHandle, entries: RuntimeKvEntry[]): Promise<void>;
-    actorKvBatchDelete(ctx: ActorContextHandle, keys: RuntimeBytes[]): Promise<void>;
-    actorSqlExec(ctx: ActorContextHandle, sql: string): Promise<RuntimeSqlExecResult>;
-    actorSqlExecute(ctx: ActorContextHandle, sql: string, params?: RuntimeSqlBindParams): Promise<RuntimeSqlExecuteResult>;
-    actorSqlExecuteBatch(ctx: ActorContextHandle, statements: RuntimeSqlBatchStatement[]): Promise<RuntimeSqlExecuteResult[]>;
-    actorSqlBeginTransaction(ctx: ActorContextHandle, timeoutMs?: number, name?: string): Promise<SqliteTransactionHandle>;
-    actorSqlTransactionExec(transaction: SqliteTransactionHandle, sql: string): Promise<RuntimeSqlExecResult>;
-    actorSqlTransactionExecute(transaction: SqliteTransactionHandle, sql: string, params?: RuntimeSqlBindParams): Promise<RuntimeSqlExecuteResult>;
-    actorSqlTransactionCommit(transaction: SqliteTransactionHandle): Promise<void>;
-    actorSqlTransactionRollback(transaction: SqliteTransactionHandle): Promise<void>;
-    actorBeginStateTransaction(ctx: ActorContextHandle, timeoutMs?: number): Promise<ActorStateTransactionHandle>;
-    actorStateTransactionExecute(transaction: ActorStateTransactionHandle, sql: string, params?: RuntimeSqlBindParams): Promise<RuntimeSqlExecuteResult>;
-    actorStateTransactionCommit(transaction: ActorStateTransactionHandle, payload: RuntimeStateDeltaPayload): Promise<void>;
-    actorStateTransactionRollback(transaction: ActorStateTransactionHandle): Promise<void>;
-    actorSqlQuery(ctx: ActorContextHandle, sql: string, params?: RuntimeSqlBindParams): Promise<RuntimeSqlQueryResult>;
-    actorSqlRun(ctx: ActorContextHandle, sql: string, params?: RuntimeSqlBindParams): Promise<RuntimeSqlRunResult>;
-    actorSqlMetrics(ctx: ActorContextHandle): SqliteNativeMetrics | null;
-    actorSqlTakeLastKvError(ctx: ActorContextHandle): string | null;
-    actorSqlClose(ctx: ActorContextHandle): Promise<void>;
-    actorRuntimeSocketProvision(ctx: ActorContextHandle): Promise<RuntimeActorRuntimeSocketEndpointInfo>;
-    actorQueueSend(ctx: ActorContextHandle, name: string, body: RuntimeBytes): Promise<RuntimeQueueMessage>;
-    actorQueueNextBatch(ctx: ActorContextHandle, options?: RuntimeQueueNextBatchOptions | undefined | null, signal?: CancellationTokenHandle | undefined | null): Promise<RuntimeQueueMessage[]>;
-    actorQueueWaitForNames(ctx: ActorContextHandle, names: string[], options?: RuntimeQueueWaitOptions | undefined | null, signal?: CancellationTokenHandle | undefined | null): Promise<RuntimeQueueMessage>;
-    actorQueueWaitForNamesAvailable(ctx: ActorContextHandle, names: string[], options?: RuntimeQueueWaitOptions | undefined | null, signal?: CancellationTokenHandle | undefined | null): Promise<void>;
-    actorQueueCompletePersisted(ctx: ActorContextHandle, messageId: bigint, expectedName: string, response?: RuntimeBytes | undefined | null): Promise<boolean>;
-    actorQueueEnqueueAndWait(ctx: ActorContextHandle, name: string, body: RuntimeBytes, options?: RuntimeQueueEnqueueAndWaitOptions | undefined | null, signal?: CancellationTokenHandle | undefined | null): Promise<RuntimeBytes | null>;
-    actorQueueTryNextBatch(ctx: ActorContextHandle, options?: RuntimeQueueTryNextBatchOptions | undefined | null): RuntimeQueueMessage[];
-    actorQueueMaxSize(ctx: ActorContextHandle): number;
-    actorQueueInspectMessages(ctx: ActorContextHandle): Promise<RuntimeQueueInspectMessage[]>;
-    actorQueueReset(ctx: ActorContextHandle): Promise<void>;
-    actorScheduleAfter(ctx: ActorContextHandle, durationMs: number, actionName: string, args: RuntimeBytes): Promise<string>;
-    actorScheduleAt(ctx: ActorContextHandle, timestampMs: number, actionName: string, args: RuntimeBytes): Promise<string>;
-    actorScheduleCancel(ctx: ActorContextHandle, id: string): Promise<boolean>;
-    actorScheduleGet(ctx: ActorContextHandle, id: string): Promise<RuntimeScheduledEventInfo | undefined>;
-    actorScheduleList(ctx: ActorContextHandle): Promise<RuntimeScheduledEventInfo[]>;
-    actorCronSet(ctx: ActorContextHandle, name: string, expression: string, timezone: string | undefined, actionName: string, args: RuntimeBytes, maxHistory: number | undefined): Promise<void>;
-    actorCronEvery(ctx: ActorContextHandle, name: string, intervalMs: number, actionName: string, args: RuntimeBytes, maxHistory: number | undefined): Promise<void>;
-    actorCronGet(ctx: ActorContextHandle, name: string): Promise<RuntimeCronJobInfo | undefined>;
-    actorCronList(ctx: ActorContextHandle): Promise<RuntimeCronJobInfo[]>;
-    actorCronDelete(ctx: ActorContextHandle, name: string): Promise<boolean>;
-    actorCronHistory(ctx: ActorContextHandle, name: string, limit: number | undefined): Promise<RuntimeCronFire[]>;
-    connId(conn: ConnHandle): string;
-    connParams(conn: ConnHandle): RuntimeBytes;
-    connState(conn: ConnHandle): RuntimeBytes;
-    connSetState(conn: ConnHandle, state: RuntimeBytes): void;
-    connIsHibernatable(conn: ConnHandle): boolean;
-    connSend(conn: ConnHandle, name: string, args: RuntimeBytes): void;
-    connDisconnect(conn: ConnHandle, reason?: string | undefined | null): Promise<void>;
-    webSocketSend(ws: WebSocketHandle, data: RuntimeBytes, binary: boolean): void;
-    webSocketClose(ws: WebSocketHandle, code?: number | undefined | null, reason?: string | undefined | null): Promise<void>;
-    webSocketSetEventCallback(ws: WebSocketHandle, callback: (event: RuntimeWebSocketEvent) => void): void;
-}
-
-declare function buildConfiguredRegistry(config: RegistryConfig): Promise<{
-    runtime: CoreRuntime;
-    registry: RegistryHandle;
-    serveConfig: RuntimeServeConfig;
-}>;
-
-type FetchHandler = (request: Request, ...args: any) => Response | Promise<Response>;
-interface ServerlessHandler {
-    fetch: FetchHandler;
-}
-interface RegistryApplication {
-    fetch: FetchHandler;
-}
-interface RegistryListenOptions {
-    port?: number;
-    host?: string;
-    publicDir?: string;
-    application?: RegistryApplication;
-}
-interface RegistryRoutes {
-    health(): Promise<Response>;
-    metadata(): Promise<Response>;
-    prometheusMetrics(request?: Request): Promise<Response>;
-}
-/**
- * Injectable dependencies for {@link Registry}. Production code uses the
- * defaults. Tests override `buildConfiguredRegistry` to drive lifecycle
- * orchestration against a fake `CoreRuntime` without an engine.
- */
-interface RegistryDeps {
-    buildConfiguredRegistry: typeof buildConfiguredRegistry;
-}
-declare class Registry<A extends RegistryActors> {
-    #private;
-    readonly routes: RegistryRoutes;
-    get config(): RegistryConfigInput<A>;
-    parseConfig(): RegistryConfig;
-    constructor(config: RegistryConfigInput<A>, deps?: Partial<RegistryDeps>);
-    /**
-     * Handle an incoming HTTP request for serverless deployments.
-     *
-     * @example
-     * ```ts
-     * const app = new Hono();
-     * app.all("/api/rivet/*", (c) => registry.handler(c.req.raw));
-     * export default app;
-     * ```
-     */
-    handler(request: Request): Promise<Response>;
-    /**
-     * Returns a fetch handler for serverless deployments.
-     *
-     * @example
-     * ```ts
-     * export default registry.serve();
-     * ```
-     */
-    serve(): ServerlessHandler;
-    /**
-     * Bind an HTTP listener provided by the native (Rust) runtime and serve
-     * the registry's serverless endpoints over it. Resolves only after the
-     * registry is shut down (SIGINT/SIGTERM or `nativeRegistry.shutdown()`).
-     *
-     * @param opts.port      Port to listen on. Defaults to `process.env.RIVET_PORT`
-     *                       if set, otherwise 3000.
-     * @param opts.host      Address to bind. Defaults to `0.0.0.0`.
-     * @param opts.publicDir If set, serves static files from this directory
-     *                       as a fallback below the framework routes.
-     * @param opts.application If set, handles requests that do not match a
-     *                         framework route.
-     *
-     * @example
-     * ```ts
-     * await registry.listen();
-     * await registry.listen({ application: app });
-     * ```
-     */
-    listen(opts?: RegistryListenOptions): Promise<void>;
-    /**
-     * Gracefully drains all live registries.
-     *
-     * Programmatic counterpart to the SIGINT/SIGTERM handlers: tears down
-     * every live `CoreRegistry` (both `start()` and `handler()` modes) and
-     * waits for the serve promise to resolve, all bounded by the shutdown
-     * grace period. Unlike a signal-driven shutdown, this does not re-raise a
-     * signal or exit the process. The caller owns process lifetime.
-     *
-     * Idempotent: concurrent or repeated calls share a single drain. Safe to
-     * call even if nothing has been started.
-     *
-     * @example
-     * ```ts
-     * const registry = setup({ use: { counter } });
-     * registry.start();
-     * // ...later, on your own shutdown trigger:
-     * await registry.shutdown();
-     * ```
-     */
-    shutdown(): Promise<void>;
-    startEnvoy(): void;
-    /**
-     * Starts the serverful registry if needed and waits until its envoy has
-     * registered with the Engine. Repeated and concurrent calls share one
-     * startup lifecycle and readiness promise.
-     *
-     * Unlike {@link start}, this reports startup failures and does not resolve
-     * merely because an HTTP health endpoint is listening.
-     */
-    startAndWait(): Promise<void>;
-    /**
-     * Starts the actor envoy for standalone server deployments.
-     *
-     * Set `RIVETKIT_RUNTIME_MODE=serverless` to instead bind an HTTP listener
-     * via `listen()` (Mode B). Mode A (envoy) and Mode B (listener) are
-     * mutually exclusive per registry instance.
-     *
-     * @example
-     * ```ts
-     * const registry = setup({ use: { counter } });
-     * registry.start();
-     * ```
-     */
-    start(): void;
-}
-
-interface QueueSendWaitOptions {
-    wait: true;
-    timeout?: number;
-    signal?: AbortSignal;
-}
-interface QueueSendNoWaitOptions {
-    wait?: false;
-    timeout?: never;
-    signal?: AbortSignal;
-}
-interface QueueSendResult<TResponse = unknown> {
-    status: "completed" | "timedOut";
-    response?: TResponse;
-}
-
-/**
- * Action function returned by Actor connections and handles.
- *
- * @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>;
-type IsAny<T> = 0 extends 1 & T ? true : false;
-type LooseEventSubscribe = (eventName: string, callback: (...args: any[]) => void) => () => void;
-type ActorActionMap<R> = {
-    [K in keyof NonNullable<R>]: NonNullable<R>[K] extends (...args: infer Args) => infer Return ? ActorActionFunction<Args, Awaited<Return>> : NonNullable<R>[K] extends Record<string, unknown> ? ActorActionMap<NonNullable<R>[K]> : never;
-};
-type ActionsOf<AD extends AnyActorDefinition> = AD["config"] extends {
-    actions?: infer R;
-} ? R : never;
-interface ActorGatewayOptions {
-    skipReadyWait?: boolean;
-}
-interface ActorActionOptions extends ActorGatewayOptions {
-    signal?: AbortSignal;
-}
-type ActorConnectOptions = ActorGatewayOptions;
-type ActorFetchInit = RequestInit & ActorGatewayOptions;
-type ActorWebSocketOptions = ActorGatewayOptions;
-/**
- * Maps action methods from actor definition to typed function signatures.
- */
-type ActorDefinitionActions<AD extends AnyActorDefinition> = IsAny<AD> extends true ? Record<string, ActorActionFunction<any[], any>> : ActorActionMap<ActionsOf<AD>>;
-type ActorQueueSend<TQueues extends QueueSchemaConfig> = {
-    <K extends keyof TQueues & string>(name: K, body: InferSchemaMap<TQueues>[K], options: QueueSendWaitOptions): Promise<QueueSendResult<InferQueueCompleteMap<TQueues>[K]>>;
-    <K extends keyof TQueues & string>(name: K, body: InferSchemaMap<TQueues>[K], options?: QueueSendNoWaitOptions): Promise<void>;
-    (name: keyof TQueues extends never ? string : never, body: unknown, options: QueueSendWaitOptions): Promise<QueueSendResult>;
-    (name: keyof TQueues extends never ? string : never, body: unknown, options?: QueueSendNoWaitOptions): Promise<void>;
-};
-type ActorEventSubscribe<TEvents extends EventSchemaConfig> = {
-    <K extends keyof TEvents & string>(eventName: K, callback: (...args: InferEventArgs<InferSchemaMap<TEvents>[K]>) => void): () => void;
-    (eventName: keyof TEvents extends never ? string : never, callback: (...args: any[]) => void): () => void;
-};
-type ActorDefinitionQueueSend<AD extends AnyActorDefinition> = IsAny<AD> extends true ? {
-    send: ActorQueueSend<Record<string, any>>;
-} : AD extends {
-    config: {
-        queues?: infer Q;
-    };
-} ? Q extends QueueSchemaConfig ? {
-    send: ActorQueueSend<Q>;
-} : {} : AD extends BaseActorDefinition<any, any, any, any, any, any, any, infer Q, any> ? Q extends QueueSchemaConfig ? {
-    send: ActorQueueSend<Q>;
-} : {} : {};
-type ActorDefinitionEventSubscriptions<AD extends AnyActorDefinition> = IsAny<AD> extends true ? {
-    on: LooseEventSubscribe;
-    once: LooseEventSubscribe;
-} : AD extends {
-    config: {
-        events?: infer E;
-    };
-} ? E extends EventSchemaConfig ? {
-    on: ActorEventSubscribe<E>;
-    once: ActorEventSubscribe<E>;
-} : {} : AD extends BaseActorDefinition<any, any, any, any, any, any, infer E, any, any> ? E extends EventSchemaConfig ? {
-    on: ActorEventSubscribe<E>;
-    once: ActorEventSubscribe<E>;
-} : {} : {};
-
-type ActorResolutionState = ActorQuery;
-
-/**
- * Connection status for an actor connection.
- *
- * - `"idle"`: Not connected, no auto-reconnect (initial state, after dispose, or disabled)
- * - `"connecting"`: Attempting to establish connection
- * - `"connected"`: Connection is active
- * - `"disconnected"`: Connection was lost, will auto-reconnect
- */
-type ActorConnStatus = "idle" | "connecting" | "connected" | "disconnected";
-/**
- * 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: RivetError) => void;
-/**
- * A callback for connection state changes.
- *
- * @typedef {Function} ConnectionStateCallback
- */
-type ConnectionStateCallback = () => void;
-/**
- * A callback for connection status changes.
- *
- * @typedef {Function} StatusChangeCallback
- */
-type StatusChangeCallback = (status: ActorConnStatus) => 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;
-    /**
-     * Do not call this directly.
-     *
-     * Creates an instance of ActorConnRaw.
-     *
-     * @protected
-     */
-    constructor(client: ClientRaw, driver: EngineControlClient, params: unknown, getParams: (() => Promise<unknown>) | undefined, encoding: Encoding, actorResolutionState: ActorResolutionState, gatewayOptions?: ActorGatewayOptions, currentActorInvocation?: CurrentActorInvocation);
-    send(name: string, body: unknown, options: QueueSendWaitOptions): Promise<QueueSendResult>;
-    send(name: string, body: unknown, options?: QueueSendNoWaitOptions): Promise<void>;
-    /**
-     * 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>;
-    /**
-     * Do not call this directly.
-     * Establishes a connection to the server using the specified endpoint & encoding & driver.
-     *
-     * @protected
-     */
-    [CONNECT_SYMBOL](): void;
-    /**
-     * Subscribes to an event that will happen repeatedly.
-     *
-     * @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}
-     */
-    on<Args extends Array<unknown> = unknown[]>(eventName: string, callback: (...args: Args) => void): EventUnsubscribe;
-    /**
-     * Subscribes to an event that will be triggered only once.
-     *
-     * @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}
-     */
-    once<Args extends Array<unknown> = unknown[]>(eventName: string, callback: (...args: Args) => void): EventUnsubscribe;
-    /**
-     * Subscribes to connection errors.
-     *
-     * @param {ActorErrorCallback} callback - The callback function to execute when a connection error occurs.
-     * @returns {() => void} - A function to unsubscribe from the error handler.
-     */
-    onError(callback: ActorErrorCallback): () => void;
-    /**
-     * Returns the current connection status.
-     *
-     * @returns {ActorConnStatus} - The current connection status.
-     */
-    get connStatus(): ActorConnStatus;
-    /**
-     * Returns whether the connection is currently open.
-     *
-     * @deprecated Use `connStatus` instead.
-     * @returns {boolean} - True if the connection is open, false otherwise.
-     */
-    get isConnected(): boolean;
-    /**
-     * Resolves when this connection first reaches the connected state.
-     */
-    get ready(): Promise<void>;
-    /**
-     * Subscribes to connection open events.
-     *
-     * This is called when the WebSocket connection is established and the Init message is received.
-     *
-     * @param {ConnectionStateCallback} callback - The callback function to execute when the connection opens.
-     * @returns {() => void} - A function to unsubscribe from the open handler.
-     */
-    onOpen(callback: ConnectionStateCallback): () => void;
-    /**
-     * Subscribes to connection close events.
-     *
-     * This is called when the WebSocket connection is closed. The connection will automatically
-     * attempt to reconnect unless disposed.
-     *
-     * @param {ConnectionStateCallback} callback - The callback function to execute when the connection closes.
-     * @returns {() => void} - A function to unsubscribe from the close handler.
-     */
-    onClose(callback: ConnectionStateCallback): () => void;
-    /**
-     * Subscribes to connection status changes.
-     *
-     * This is called whenever the connection status changes between Disconnected, Connecting, and Connected.
-     *
-     * @param {StatusChangeCallback} callback - The callback function to execute when the status changes.
-     * @returns {() => void} - A function to unsubscribe from the status change handler.
-     */
-    onStatusChange(callback: StatusChangeCallback): () => void;
-    /**
-     * Disconnects from the actor.
-     *
-     * @returns {Promise<void>} A promise that resolves when the socket is gracefully closed.
-     */
-    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> = Omit<ActorConnRaw, "send" | "on" | "once"> & ActorDefinitionQueueSend<AD> & ActorDefinitionEventSubscriptions<AD> & 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;
-    /**
-     * Do not call this directly.
-     *
-     * Creates an instance of ActorHandleRaw.
-     *
-     * @protected
-     */
-    constructor(client: any, driver: EngineControlClient, params: unknown, getParams: (() => Promise<unknown>) | undefined, encoding: Encoding, actorResolutionState: ActorResolutionState, gatewayOptions?: ActorGatewayOptions, signal?: AbortSignal, currentActorInvocation?: CurrentActorInvocation, startCallSpan?: StartCallSpan);
-    send(name: string, body: unknown, options: QueueSendWaitOptions): Promise<QueueSendResult>;
-    send(name: string, body: unknown, options?: QueueSendNoWaitOptions): Promise<void>;
-    /**
-     * Call a raw action. This method sends an HTTP request to invoke the named action.
-     *
-     * @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;
-    } & ActorActionOptions): Promise<Response>;
-    /**
-     * Establishes a persistent connection to the actor.
-     *
-     * @template AD The actor class that this connection is for.
-     * @returns {ActorConn<AD>} A connection to the actor.
-     */
-    connect(params?: unknown, options?: ActorConnectOptions): ActorConn<AnyActorDefinition>;
-    /**
-     * Fetches a resource from this actor via the /request endpoint. This is a
-     * convenience wrapper around the raw HTTP API.
-     */
-    fetch(input: string | URL | Request, init?: ActorFetchInit): Promise<Response>;
-    /**
-     * Opens a raw WebSocket connection to this actor.
-     */
-    webSocket(path?: string, protocols?: string | string[], options?: ActorWebSocketOptions): Promise<any>;
-    /**
-     * Resolves the actor to get its unique actor ID.
-     */
-    resolve(): Promise<string>;
-    /** Issue a token scoped to this actor. Defaults to actor gateway read access. */
-    issueToken(options?: ActorIssueTokenOptions): Promise<IssuedToken>;
-    /**
-     * Returns the raw URL for routing traffic to the actor.
-     */
-    getGatewayUrl(): Promise<string>;
-    reload(): Promise<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}
- */
-type ActorHandle<AD extends AnyActorDefinition> = Omit<ActorHandleRaw, "connect" | "send"> & {
-    connect(params?: unknown, options?: ActorConnectOptions): ActorConn<AD>;
-    resolve(): Promise<string>;
-} & ActorDefinitionQueueSend<AD> & Omit<ActorDefinitionActions<AD>, keyof ActorHandleRaw>;
-
-/** Extract the actor registry from the registry definition. */
-type ExtractActorsFromRegistry<A extends Registry<any>> = A extends Registry<infer Actors> ? Actors : 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.
-     *
-     * Each operation resolves the current actor for the key before sending the
-     * request.
-     *
-     * @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.
-     *
-     * Each operation resolves the current actor for the key before sending the
-     * request.
-     *
-     * @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.
-     *
-     * If the actor is destroyed, operations will throw without retrying since
-     * there is no key to re-resolve.
-     *
-     * @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.
-     *
-     * If the actor is destroyed, operations will throw without retrying since
-     * creation is a one-shot operation.
-     *
-     * @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;
-    /**
-     * Lazily resolves connection parameters for `.connect()` and `.webSocket()`.
-     * This is called each time a new connection is opened.
-     */
-    getParams?: () => Promise<unknown>;
-    /** Signal to abort the request. */
-    signal?: AbortSignal;
-}
-/**
- * Options for getting a actor by ID.
- * @typedef {QueryOptions} GetWithIdOptions
- */
-interface GetWithIdOptions 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;
-    /**
-     * Name of the envoy pool to select for this actor if it is created.
-     * Overrides the client's configured `poolName` for this call.
-     */
-    poolName?: string;
-}
-/**
- * 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;
-    /**
-     * Name of the envoy pool to select for this actor.
-     * Overrides the client's configured `poolName` for this call.
-     */
-    poolName?: string;
-}
-declare const ACTOR_CONNS_SYMBOL: unique symbol;
-declare const CREATE_ACTOR_CONN_PROXY: unique symbol;
-/** Options for constructing a raw actor client. */
-interface ClientRawOptions {
-    encoding?: Encoding;
-    gateway?: ActorGatewayOptions;
-}
-/** Runtime-supplied wiring for clients created inside an actor. Set only by the native runtime. */
-interface ActorClientRuntimeOptions {
-    /** Supplies the calling actor's invocation so actor-to-actor clients propagate its trace and ray ID. */
-    currentActorInvocation?: CurrentActorInvocation;
-    /** Opens and finishes the Core span covering an actor-to-actor call. */
-    startCallSpan?: StartCallSpan;
-}
-/**
- * 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;
-    /** Issue namespace-scoped tokens with an explicit grant list. */
-    readonly auth: {
-        issueToken(options: IssueTokenOptions): Promise<IssuedToken>;
-    };
-    [ACTOR_CONNS_SYMBOL]: Set<ActorConnRaw>;
-    /**
-     * Creates an instance of Client.
-     */
-    constructor(driver: EngineControlClient, options?: ClientRawOptions & ActorClientRuntimeOptions);
-    /**
-     * 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 & Omit<{
-    [K in keyof ExtractActorsFromRegistry<A>]: ActorAccessor<ExtractActorsFromRegistry<A>[K]>;
-}, keyof ClientRaw>;
-
-/** @experimental State exposed by a durable workflow run handler to the Inspector. */
-type WorkflowState = "pending" | "running" | "sleeping" | "failed" | "completed" | "cancelled" | "rolling_back";
-
-declare const ACTOR_CONTEXT_INTERNAL_SYMBOL: unique symbol;
-declare const RAW_STATE_SYMBOL: unique symbol;
-interface ActorLogger {
-    level: any;
-    fatal: any;
-    trace: any;
-    silent: any;
-    msgPrefix: any;
-    debug: any;
-    info: any;
-    warn: any;
-    error: any;
-    [key: string]: any;
-}
-type ActorKvValueType = "text" | "arrayBuffer" | "binary";
-type ActorKvKeyType = "text" | "binary";
-type ActorKvValueTypeMap = {
-    text: string;
-    arrayBuffer: ArrayBuffer;
-    binary: Uint8Array;
-};
-type ActorKvKeyTypeMap = {
-    text: string;
-    binary: Uint8Array;
-};
-type ActorKvValueOptions<T extends ActorKvValueType = "text"> = {
-    type?: T;
-};
-type ActorKvListOptions<T extends ActorKvValueType = "text", K extends ActorKvKeyType = "text"> = ActorKvValueOptions<T> & {
-    keyType?: K;
-    reverse?: boolean;
-    limit?: number;
-};
-type ActorClientFor<T> = T extends Registry<any> ? Client<T> : T;
-/**
- * @deprecated Actor KV is deprecated. Use embedded SQLite (`c.db`)
- * or actor state instead.
- */
-interface ActorKv {
-    get<T extends ActorKvValueType = "text">(key: Uint8Array | string, options?: ActorKvValueOptions<T>): Promise<ActorKvValueTypeMap[T] | null>;
-    put<T extends ActorKvValueType = "text">(key: Uint8Array | string, value: Uint8Array | string | ArrayBuffer, options?: ActorKvValueOptions<T>): Promise<void>;
-    delete(key: Uint8Array | string): Promise<void>;
-    batchPut(entries: [Uint8Array, Uint8Array][]): Promise<void>;
-    batchGet(keys: Uint8Array[]): Promise<(Uint8Array | null)[]>;
-    batchDelete(keys: Uint8Array[]): Promise<void>;
-    deleteRange(start: Uint8Array, end: Uint8Array): Promise<void>;
-    listPrefix<T extends ActorKvValueType = "text", K extends ActorKvKeyType = "text">(prefix: Uint8Array | string, options?: ActorKvListOptions<T, K>): Promise<Array<[ActorKvKeyTypeMap[K], ActorKvValueTypeMap[T]]>>;
-    listRange<T extends ActorKvValueType = "text", K extends ActorKvKeyType = "text">(start: Uint8Array | string, end: Uint8Array | string, options?: ActorKvListOptions<T, K>): Promise<Array<[ActorKvKeyTypeMap[K], ActorKvValueTypeMap[T]]>>;
-    list<T extends ActorKvValueType = "text", K extends ActorKvKeyType = "text">(prefix: Uint8Array | string, options?: ActorKvListOptions<T, K>): Promise<Array<[ActorKvKeyTypeMap[K], ActorKvValueTypeMap[T]]>>;
-    [key: string]: any;
-}
-interface ActorSchedule {
-    after(duration: number, action: string, ...args: unknown[]): Promise<string>;
-    at(timestamp: number, action: string, ...args: unknown[]): Promise<string>;
-    cancel(id: string): Promise<boolean>;
-    get(id: string): Promise<ScheduledEventInfo | undefined>;
-    list(): Promise<ScheduledEventInfo[]>;
-    [key: string]: any;
-}
-interface ActorCronSetOptions {
-    name: string;
-    expression: string;
-    action: string;
-    args?: unknown[];
-    timezone?: string;
-    /** Defaults to 100. Set to 0 to disable and clear history. Maximum 1,000. */
-    maxHistory?: number;
-}
-interface ActorCronEveryOptions {
-    name: string;
-    /** Fixed interval in milliseconds. Minimum 5,000. */
-    interval: number;
-    action: string;
-    args?: unknown[];
-    /** Defaults to 100. Set to 0 to disable and clear history. Maximum 1,000. */
-    maxHistory?: number;
-}
-interface ActorCron {
-    set(options: ActorCronSetOptions): Promise<void>;
-    every(options: ActorCronEveryOptions): Promise<void>;
-    get(name: string): Promise<CronJobInfo | undefined>;
-    list(): Promise<CronJobInfo[]>;
-    delete(name: string): Promise<boolean>;
-    history(name: string, options?: {
-        limit?: number;
-    }): Promise<CronFire[]>;
-    [key: string]: any;
-}
-interface ScheduledEventInfo {
-    id: string;
-    action: string;
-    args: unknown[];
-    runAt: number;
-}
-type CronJobInfo = {
-    name: string;
-    action: string;
-    args: unknown[];
-    nextRunAt: number;
-    lastRunAt?: number;
-    maxHistory: number;
-} & ({
-    kind: "cron";
-    expression: string;
-    timezone: string;
-} | {
-    kind: "every";
-    interval: number;
-});
-interface CronFire {
-    action: string;
-    scheduledAt: number;
-    firedAt: number;
-    finishedAt?: number;
-    result: "running" | "ok" | "error" | "skipped";
-    error?: {
-        group: string;
-        code: string;
-        message: string;
-        metadata?: unknown;
-    };
-}
-type QueueMessageOf<Name extends string, Body> = {
-    id: number | bigint;
-    name: Name;
-    body: Body;
-    createdAt: number;
-    [key: string]: unknown;
-};
-type QueueName<TQueues extends QueueSchemaConfig> = keyof TQueues & string;
-type QueueFilterName<TQueues extends QueueSchemaConfig> = keyof TQueues extends never ? string : QueueName<TQueues>;
-type QueueMessageForName<TQueues extends QueueSchemaConfig, TName extends QueueFilterName<TQueues>> = keyof TQueues extends never ? QueueMessageOf<string, unknown> : TName extends QueueName<TQueues> ? QueueMessageOf<TName, InferSchemaMap<TQueues>[TName]> : never;
-type QueueCompleteArgs<T> = undefined extends T ? [response?: T] : [response: T];
-type QueueCompleteArgsForName<TQueues extends QueueSchemaConfig, TName extends QueueFilterName<TQueues>> = keyof TQueues extends never ? [response?: unknown] : TName extends QueueName<TQueues> ? [InferQueueCompleteMap<TQueues>[TName]] extends [never] ? [response?: unknown] : QueueCompleteArgs<InferQueueCompleteMap<TQueues>[TName]> : [response?: unknown];
-type QueueCompletionResultForName<TQueues extends QueueSchemaConfig, TName extends QueueFilterName<TQueues>> = keyof TQueues extends never ? unknown | undefined : TName extends QueueName<TQueues> ? InferQueueCompleteMap<TQueues>[TName] | undefined : unknown | undefined;
-interface QueueNextOptions<TName extends string = string, TCompletable extends boolean = boolean> {
-    names?: readonly TName[];
-    timeout?: number;
-    signal?: AbortSignal;
-    completable?: TCompletable;
-}
-interface QueueNextBatchOptions<TName extends string = string, TCompletable extends boolean = boolean> {
-    names?: readonly TName[];
-    count?: number;
-    timeout?: number;
-    signal?: AbortSignal;
-    completable?: TCompletable;
-}
-interface QueueWaitOptions<TCompletable extends boolean = boolean> {
-    timeout?: number;
-    signal?: AbortSignal;
-    completable?: TCompletable;
-}
-interface QueueEnqueueAndWaitOptions {
-    timeout?: number;
-    signal?: AbortSignal;
-}
-interface QueueTryNextOptions<TName extends string = string, TCompletable extends boolean = boolean> {
-    names?: readonly TName[];
-    completable?: TCompletable;
-}
-interface QueueTryNextBatchOptions<TName extends string = string, TCompletable extends boolean = boolean> {
-    names?: readonly TName[];
-    count?: number;
-    completable?: TCompletable;
-}
-interface QueueIterOptions<TName extends string = string, TCompletable extends boolean = boolean> {
-    names?: readonly TName[];
-    signal?: AbortSignal;
-    completable?: TCompletable;
-}
-interface ActorQueue<TQueues extends QueueSchemaConfig = Record<never, never>> {
-    send<TName extends QueueFilterName<TQueues>>(name: TName, body: QueueMessageForName<TQueues, TName>["body"]): Promise<any>;
-    next<const TName extends QueueFilterName<TQueues>, const TCompletable extends boolean = false>(opts?: QueueNextOptions<TName, TCompletable>): Promise<any>;
-    nextBatch<const TName extends QueueFilterName<TQueues>, const TCompletable extends boolean = false>(opts?: QueueNextBatchOptions<TName, TCompletable>): Promise<any[]>;
-    waitForNames<const TName extends QueueFilterName<TQueues>, const TCompletable extends boolean = false>(names: readonly TName[], opts?: QueueWaitOptions<TCompletable>): Promise<any>;
-    /** @experimental */
-    waitForAvailable<const TName extends QueueFilterName<TQueues>>(names?: readonly TName[], opts?: Omit<QueueWaitOptions<false>, "completable">): Promise<void>;
-    /** @experimental */
-    complete<const TName extends QueueFilterName<TQueues>>(message: {
-        id: number | bigint;
-        name: TName;
-    }, ...args: QueueCompleteArgsForName<TQueues, TName>): Promise<void>;
-    enqueueAndWait<const TName extends QueueFilterName<TQueues>>(name: TName, body: QueueMessageForName<TQueues, TName>["body"], opts?: QueueEnqueueAndWaitOptions): Promise<QueueCompletionResultForName<TQueues, TName>>;
-    tryNext<const TName extends QueueFilterName<TQueues>, const TCompletable extends boolean = false>(opts?: QueueTryNextOptions<TName, TCompletable>): Promise<any>;
-    tryNextBatch<const TName extends QueueFilterName<TQueues>, const TCompletable extends boolean = false>(opts?: QueueTryNextBatchOptions<TName, TCompletable>): Promise<any[]>;
-    iter<const TName extends QueueFilterName<TQueues>, const TCompletable extends boolean = false>(opts?: QueueIterOptions<TName, TCompletable>): AsyncIterable<any>;
-    [key: string]: any;
-}
-interface Conn<_TState = unknown, TConnParams = unknown, TConnState = unknown, _TVars = unknown, _TInput = unknown, _TDatabase extends AnyDatabaseProvider = AnyDatabaseProvider, _TEvents extends EventSchemaConfig = Record<never, never>, _TQueues extends QueueSchemaConfig = Record<never, never>> {
-    id: string;
-    params: TConnParams;
-    state: TConnState;
-    isHibernatable: boolean;
-    send(name: string, ...args: any[]): void;
-    disconnect(reason?: string): Promise<void>;
-    [key: string]: any;
-}
-interface ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> {
-    [ACTOR_CONTEXT_INTERNAL_SYMBOL]?: unknown;
-    /** Returns the raw unwrapped state without the write-through proxy. */
-    [RAW_STATE_SYMBOL](): TState;
-    state: TState;
-    vars: TVars;
-    /**
-     * @deprecated Actor KV is deprecated. Use embedded SQLite (`c.db`)
-     * or actor state instead.
-     */
-    readonly kv: ActorKv;
-    readonly db: InferDatabaseClient<TDatabase>;
-    readonly schedule: ActorSchedule;
-    readonly cron: ActorCron;
-    readonly queue: ActorQueue<TQueues>;
-    /** @experimental */
-    readonly run: ActorRun;
-    readonly actorId: string;
-    readonly name: string;
-    readonly key: string[];
-    readonly region: string;
-    /** Provisions the experimental Actor Runtime Socket for this actor generation. */
-    actorRuntimeSocket(): Promise<{
-        path: string;
-    }>;
-    readonly conns: Map<string, Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>>;
-    readonly log: ActorLogger;
-    readonly abortSignal: AbortSignal;
-    readonly aborted: boolean;
-    readonly request?: Request;
-    /** @deprecated No-op. Always returns `false`. Use `keepAwake(promise)` or `waitUntil(promise)` instead. Will be removed in 2.2.0. */
-    readonly preventSleep: boolean;
-    broadcast(name: string, ...args: any[]): void;
-    saveState(opts?: {
-        immediate?: boolean;
-        maxWait?: number;
-    }): Promise<void>;
-    keepAwake<T>(promise: Promise<T>): Promise<T>;
-    waitUntil(promise: Promise<unknown>): void;
-    /** @deprecated No-op. Use `keepAwake(promise)` to hold the actor awake for a specific promise. Will be removed in 2.2.0. */
-    setPreventSleep(preventSleep: boolean): void;
-    sleep(): void;
-    destroy(): void;
-    client<T = any>(): ActorClientFor<T>;
-    [key: string]: any;
-}
-/** @experimental How one run of a workflow function ended. */
-type WorkflowOutcome = "completed" | "sleeping" | "evicted" | "failed" | "cancelled";
-/** @experimental How one workflow step attempt ended. `retry` will be tried again, `failed` will not. */
-type WorkflowStepOutcome = "ok" | "retry" | "failed";
-/** @experimental One open run of a workflow function, traced as its own invocation. */
-interface WorkflowSpan {
-    /** Runs `body` attributed to this run. */
-    run<T>(body: () => Promise<T>): Promise<T>;
-    /**
-     * Called by a workflow engine before each attempt at a step. Returns
-     * nothing when tracing is off.
-     */
-    startStep(name: string, attempt: number): WorkflowStepSpan | undefined;
-    finish(outcome: WorkflowOutcome): Promise<void>;
-}
-/** @experimental One open attempt at one workflow step. */
-interface WorkflowStepSpan {
-    /** Runs `body` attributed to this attempt. */
-    run<T>(body: () => Promise<T>): Promise<T>;
-    /** `error` is what the step callback threw. */
-    finish(outcome: WorkflowStepOutcome, error?: unknown): void;
-}
-/** @experimental */
-interface ActorRun {
-    /**
-     * @experimental Sets or clears the durable Unix-millisecond deadline that
-     * ensures this actor's run handler is active, starting it if inactive.
-     */
-    setWakeAt(timestamp: number | null): Promise<void>;
-    /** @experimental Called by a workflow engine each time it runs the workflow function. */
-    startWorkflowSpan(): Promise<WorkflowSpan>;
-    /**
-     * @experimental Runs `body` outside the current workflow run, so a workflow
-     * engine's own history storage stays out of the trace.
-     */
-    runOutsideWorkflowSpan<T>(body: () => T): T;
-}
-type ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues> & {
-    conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-};
-type BeforeActionResponseContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type BeforeConnectContext<TState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActorContext<TState, unknown, unknown, TVars, TInput, TDatabase, TEvents, TQueues>;
-type ConnectContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type CreateConnStateContext<TState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActorContext<TState, unknown, unknown, TVars, TInput, TDatabase, TEvents, TQueues>;
-type CreateContext<TState, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActorContext<TState, unknown, unknown, unknown, TInput, TDatabase, TEvents, TQueues>;
-type CreateVarsContext<TState, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = CreateContext<TState, TInput, TDatabase, TEvents, TQueues>;
-type DestroyContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type DisconnectContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type RequestContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type RunContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type SleepContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = RunContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type StateChangeContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = RunContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type WakeContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = RunContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type MigrateContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = WakeContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type WebSocketContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-type InspectorUnsubscribe = () => void;
-declare const RunConfigSchema: z$1.ZodObject<{
-    name: z$1.ZodOptional<z$1.ZodString>;
-    icon: z$1.ZodOptional<z$1.ZodString>;
-    run: z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-    inspector: z$1.ZodOptional<z$1.ZodOptional<z$1.ZodObject<{
-        workflow: z$1.ZodOptional<z$1.ZodObject<{
-            getHistory: z$1.ZodCustom<() => unknown, () => unknown>;
-            getState: z$1.ZodOptional<z$1.ZodCustom<() => Promise<WorkflowState | null>, () => Promise<WorkflowState | null>>>;
-            onHistoryUpdated: z$1.ZodOptional<z$1.ZodCustom<(listener: (history: unknown) => void) => InspectorUnsubscribe, (listener: (history: unknown) => void) => InspectorUnsubscribe>>;
-            replayFromStep: z$1.ZodOptional<z$1.ZodCustom<(entryId?: string) => Promise<unknown>, (entryId?: string) => Promise<unknown>>>;
-        }, z$1.core.$strip>>;
-    }, z$1.core.$strip>>>;
-}, z$1.core.$strip>;
-type RunConfigRuntime = z$1.infer<typeof RunConfigSchema>;
-type RunConfig<TState = unknown, TConnParams = unknown, TConnState = unknown, TVars = unknown, TInput = unknown, TDatabase extends AnyDatabaseProvider = AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> = Omit<RunConfigRuntime, "run"> & {
-    run: (c: RunContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>) => void | Promise<void>;
-};
-declare const ActorConfigSchema: z$1.ZodObject<{
-    onCreate: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onDestroy: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onMigrate: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onWake: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onSleep: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    run: z$1.ZodOptional<z$1.ZodUnion<readonly [z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>, z$1.ZodObject<{
-        name: z$1.ZodOptional<z$1.ZodString>;
-        icon: z$1.ZodOptional<z$1.ZodString>;
-        run: z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>;
-        inspector: z$1.ZodOptional<z$1.ZodOptional<z$1.ZodObject<{
-            workflow: z$1.ZodOptional<z$1.ZodObject<{
-                getHistory: z$1.ZodCustom<() => unknown, () => unknown>;
-                getState: z$1.ZodOptional<z$1.ZodCustom<() => Promise<WorkflowState | null>, () => Promise<WorkflowState | null>>>;
-                onHistoryUpdated: z$1.ZodOptional<z$1.ZodCustom<(listener: (history: unknown) => void) => InspectorUnsubscribe, (listener: (history: unknown) => void) => InspectorUnsubscribe>>;
-                replayFromStep: z$1.ZodOptional<z$1.ZodCustom<(entryId?: string) => Promise<unknown>, (entryId?: string) => Promise<unknown>>>;
-            }, z$1.core.$strip>>;
-        }, z$1.core.$strip>>>;
-    }, z$1.core.$strip>]>>;
-    onStateChange: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onBeforeConnect: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onConnect: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onDisconnect: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onBeforeActionResponse: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onRequest: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onWebSocket: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    actions: z$1.ZodDefault<z$1.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
-    actionInputSchemas: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodAny>>;
-    tracing: z$1.ZodOptional<z$1.ZodObject<{
-        sampler: z$1.ZodOptional<z$1.ZodNumber>;
-        actions: z$1.ZodOptional<z$1.ZodType<ActionSampleRates, unknown, z$1.core.$ZodTypeInternals<ActionSampleRates, unknown>>>;
-    }, z$1.core.$strict>>;
-    connParamsSchema: z$1.ZodOptional<z$1.ZodAny>;
-    events: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodAny>>;
-    queues: z$1.ZodOptional<z$1.ZodRecord<z$1.ZodString, z$1.ZodAny>>;
-    state: z$1.ZodOptional<z$1.ZodAny>;
-    createState: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    connState: z$1.ZodOptional<z$1.ZodAny>;
-    createConnState: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    vars: z$1.ZodOptional<z$1.ZodAny>;
-    db: z$1.ZodOptional<z$1.ZodAny>;
-    createVars: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    options: z$1.ZodPrefault<z$1.ZodObject<{
-        name: z$1.ZodOptional<z$1.ZodString>;
-        icon: z$1.ZodOptional<z$1.ZodString>;
-        enableActorRuntimeSocket: z$1.ZodDefault<z$1.ZodBoolean>;
-        canHibernateWebSocket: z$1.ZodDefault<z$1.ZodUnion<readonly [z$1.ZodBoolean, z$1.ZodCustom<(request: Request) => boolean, (request: Request) => boolean>]>>;
-        createVarsTimeout: z$1.ZodDefault<z$1.ZodNumber>;
-        createConnStateTimeout: z$1.ZodDefault<z$1.ZodNumber>;
-        onBeforeConnectTimeout: z$1.ZodDefault<z$1.ZodNumber>;
-        onConnectTimeout: z$1.ZodDefault<z$1.ZodNumber>;
-        onMigrateTimeout: z$1.ZodDefault<z$1.ZodNumber>;
-        sleepGracePeriod: z$1.ZodDefault<z$1.ZodNumber>;
-        onDestroyTimeout: z$1.ZodOptional<z$1.ZodNumber>;
-        waitUntilTimeout: z$1.ZodOptional<z$1.ZodNumber>;
-        stateSaveInterval: z$1.ZodDefault<z$1.ZodNumber>;
-        actionTimeout: z$1.ZodDefault<z$1.ZodNumber>;
-        connectionLivenessTimeout: z$1.ZodDefault<z$1.ZodNumber>;
-        connectionLivenessInterval: z$1.ZodDefault<z$1.ZodNumber>;
-        noSleep: z$1.ZodDefault<z$1.ZodBoolean>;
-        sleepTimeout: z$1.ZodDefault<z$1.ZodNumber>;
-        maxQueueSize: z$1.ZodDefault<z$1.ZodNumber>;
-        maxSchedules: z$1.ZodDefault<z$1.ZodNumber>;
-        maxQueueMessageSize: z$1.ZodDefault<z$1.ZodNumber>;
-        preloadMaxWorkflowBytes: z$1.ZodOptional<z$1.ZodNumber>;
-        preloadMaxConnectionsBytes: z$1.ZodOptional<z$1.ZodNumber>;
-    }, z$1.core.$strict>>;
-    inspector: z$1.ZodOptional<z$1.ZodObject<{
-        tabs: z$1.ZodDefault<z$1.ZodArray<z$1.ZodUnion<readonly [z$1.ZodObject<{
-            id: z$1.ZodString;
-            label: z$1.ZodString;
-            source: z$1.ZodString;
-            icon: z$1.ZodOptional<z$1.ZodString>;
-            hidden: z$1.ZodOptional<z$1.ZodLiteral<false>>;
-        }, z$1.core.$strict>, z$1.ZodObject<{
-            id: z$1.ZodEnum<{
-                workflow: "workflow";
-                state: "state";
-                database: "database";
-                queue: "queue";
-                schedules: "schedules";
-                connections: "connections";
-                console: "console";
-            }>;
-            hidden: z$1.ZodLiteral<true>;
-        }, z$1.core.$strict>]>>>;
-    }, z$1.core.$strict>>;
-}, z$1.core.$strict>;
-type CreateState<TState, _TConnParams, _TConnState, _TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig> = {
-    state: TState;
-} | {
-    createState: (c: CreateContext<TState, TInput, TDatabase, TEvents, TQueues>, input: TInput) => TState | Promise<TState>;
-} | Record<never, never>;
-type CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig> = {
-    connState: TConnState;
-} | {
-    createConnState: (c: CreateConnStateContext<TState, TVars, TInput, TDatabase, TEvents, TQueues>, params: TConnParams) => TConnState | Promise<TConnState>;
-} | Record<never, never>;
-/**
- * @experimental
- */
-type CreateVars<TState, _TConnParams, _TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig> = {
-    /**
-     * @experimental
-     */
-    vars: TVars;
-} | {
-    /**
-     * @experimental
-     */
-    createVars: (c: CreateVarsContext<TState, TInput, TDatabase, TEvents, TQueues>, driverCtx: any) => TVars | Promise<TVars>;
-} | Record<never, never>;
-interface Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>> {
-    [Action: string]: ((c: ActionContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>, ...args: any[]) => any) | Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-}
-interface ActionInputSchemas {
-    [Action: string]: PrimitiveSchema | ActionInputSchemas;
-}
-interface BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig, TQueues extends QueueSchemaConfig, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>> {
-    /**
-     * Called when the actor is first initialized.
-     *
-     * Use this hook to initialize your actor's state.
-     * This is called before any other lifecycle hooks.
-     */
-    onCreate?: (c: CreateContext<TState, TInput, TDatabase, TEvents, TQueues>, input: TInput) => void | Promise<void>;
-    /**
-     * Called when the actor is destroyed.
-     */
-    onDestroy?: (c: DestroyContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>) => void | Promise<void>;
-    /**
-     * Called on every actor start after persisted state loads and before onWake.
-     *
-     * Use this hook for repeatable schema migrations or other startup work that
-     * must run on both first boot and wake.
-     */
-    onMigrate?: (c: MigrateContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>, isNew: boolean) => void | Promise<void>;
-    /**
-     * 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.)
-     *
-     * @returns Void or a Promise that resolves when startup is complete
-     */
-    onWake?: (c: WakeContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>) => void | Promise<void>;
-    /**
-     * 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.
-     *
-     * @returns Void or a Promise that resolves when shutdown is complete
-     */
-    onSleep?: (c: SleepContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>) => void | Promise<void>;
-    /**
-     * Called after the actor starts up. Does not block actor startup.
-     *
-     * Use this for background tasks like:
-     * - Reading from queues in a loop
-     * - Tick loops for periodic work
-     * - Custom workflow logic
-     *
-     * **Important:** The actor may go to sleep at any time during the `run`
-     * handler. Wrap work that must keep the actor awake with
-     * `c.keepAwake(promise)` to block idle sleep and shutdown finalize until
-     * the promise settles, or use `c.waitUntil(promise)` to let the graceful
-     * shutdown window (`sleepGracePeriod`) cover deferred work.
-     *
-     * The handler receives an abort signal via `c.abortSignal` and a
-     * `c.aborted` alias. Use these to gracefully exit when shutdown starts.
-     *
-     * If this handler exits, the actor will follow the normal idle sleep timeout
-     * once it becomes idle.
-     * If this handler throws, the actor logs the error and then sleeps once it
-     * becomes idle.
-     * Call `c.destroy()` explicitly if a run handler should destroy the actor.
-     *
-     * Can be either a function or a RunConfig object with optional name/icon metadata.
-     *
-     * @returns Void or a Promise.
-     */
-    run?: ((c: RunContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>) => void | Promise<void>) | RunConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>;
-    /**
-     * 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.
-     *
-     * @param newState The updated state
-     */
-    onStateChange?: (c: StateChangeContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>, newState: TState) => void;
-    /**
-     * Called before a client connects to the actor.
-     *
-     * Use this hook to determine if a connection should be accepted
-     * and to validate client-provided parameters. The pending connection
-     * is not visible in `c.conns` while this hook runs.
-     *
-     * @param opts Connection parameters including client-provided data
-     * @returns Void or a Promise.
-     * @throws Throw an error to reject the connection
-     */
-    onBeforeConnect?: (c: BeforeConnectContext<TState, TVars, TInput, TDatabase, TEvents, TQueues>, params: TConnParams) => void | Promise<void>;
-    /**
-     * 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. The
-     * connection is visible in `c.conns` before this hook runs.
-     *
-     * @param conn The connection object
-     * @returns Void or a Promise that resolves when connection handling is complete
-     */
-    onConnect?: (c: ConnectContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>) => void | Promise<void>;
-    /**
-     * Called when a client 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
-     */
-    onDisconnect?: (c: DisconnectContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>, conn: Conn<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>) => void | Promise<void>;
-    /**
-     * Called before sending an action response to the client.
-     *
-     * 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
-     */
-    onBeforeActionResponse?: <Out>(c: BeforeActionResponseContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>, name: string, args: unknown[], output: Out) => Out | Promise<Out>;
-    /**
-     * Called when a raw HTTP request is made to the actor.
-     *
-     * 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 c The request context with access to the connection
-     * @param request The raw HTTP request object
-     * @param opts Additional options
-     * @returns A Response object to send back, or void to continue with default routing
-     */
-    onRequest?: (c: RequestContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>, request: Request) => Response | Promise<Response>;
-    /**
-     * Called when a raw WebSocket connection is established 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 c The WebSocket context with access to the connection
-     * @param websocket The actor-facing raw WebSocket connection
-     * @param opts Additional options including the original HTTP upgrade request
-     */
-    onWebSocket?: (c: WebSocketContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>, websocket: UniversalWebSocket) => void | Promise<void>;
-    actions?: TActions;
-    /**
-     * Optional schemas for validating action argument tuples in native runtimes.
-     * May mirror nested action groups or use dot-separated low-level action names.
-     */
-    actionInputSchemas?: ActionInputSchemas;
-    /**
-     * How much of this actor's work is recorded in traces. Defaults to the
-     * process sampler from `OTEL_TRACES_SAMPLER`.
-     */
-    tracing?: ActorTracingOptions<TActions>;
-    /**
-     * Optional schema for validating connection params in native runtimes.
-     */
-    connParamsSchema?: PrimitiveSchema;
-    /**
-     * Schema map for events broadcasted by this actor.
-     */
-    events?: TEvents;
-    /**
-     * Schema map for queue payloads sent by this actor.
-     */
-    queues?: TQueues;
-}
-type ActorDatabaseConfig<TDatabase extends AnyDatabaseProvider> = {
-    /**
-     * @experimental
-     */
-    db: TDatabase;
-} | Record<never, never>;
-type ActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase extends AnyDatabaseProvider, TEvents extends EventSchemaConfig = Record<never, never>, TQueues extends QueueSchemaConfig = Record<never, never>, TActions extends Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues> = Actions<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues>> = Omit<z$1.infer<typeof ActorConfigSchema>, "actions" | "events" | "queues" | "onCreate" | "onDestroy" | "onMigrate" | "onWake" | "onSleep" | "run" | "onStateChange" | "onBeforeConnect" | "onConnect" | "onDisconnect" | "onBeforeActionResponse" | "onRequest" | "onWebSocket" | "state" | "createState" | "connState" | "createConnState" | "vars" | "createVars" | "db"> & BaseActorConfig<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues, TActions> & CreateState<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues> & CreateConnState<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues> & CreateVars<TState, TConnParams, TConnState, TVars, TInput, TDatabase, TEvents, TQueues> & ActorDatabaseConfig<TDatabase>;
-
-type AgentOsActorState = {};
-interface AgentOsActorVars {
-    agentOs: AgentOs | null;
-    activeSessionIds: Set<string>;
-    activeProcesses: Set<number>;
-    activeHooks: Set<Promise<void>>;
-    activeShells: Set<string>;
-    sessions: Set<string>;
-}
-interface SessionEventPayload {
-    sessionId: string;
-    event: JsonRpcNotification;
-}
-interface PermissionRequestPayload {
-    sessionId: string;
-    request: PermissionRequest;
-}
-type VmBootedPayload = Record<string, never>;
-interface VmShutdownPayload {
-    reason: "sleep" | "destroy" | "error";
-}
-interface ProcessOutputPayload {
-    pid: number;
-    stream: "stdout" | "stderr";
-    data: Uint8Array;
-}
-interface ProcessExitPayload {
-    pid: number;
-    exitCode: number;
-}
-interface ShellDataPayload {
-    shellId: string;
-    data: Uint8Array;
-}
-interface CronEventPayload {
-    event: CronEvent;
-}
-interface AgentOsEvents {
-    sessionEvent: SessionEventPayload;
-    permissionRequest: PermissionRequestPayload;
-    vmBooted: VmBootedPayload;
-    vmShutdown: VmShutdownPayload;
-    processOutput: ProcessOutputPayload;
-    processExit: ProcessExitPayload;
-    shellData: ShellDataPayload;
-    cronEvent: CronEventPayload;
-}
-/** Result from sendPrompt. */
-interface PromptResult {
-    /** Raw JSON-RPC response from the ACP adapter. */
-    response: JsonRpcResponse;
-    /** Accumulated agent text output from streamed message chunks. */
-    text: string;
-}
-interface SessionRecord {
-    sessionId: string;
-    agentType: string;
-    capabilities: AgentCapabilities;
-    agentInfo: AgentInfo | null;
-}
-interface PersistedSessionRecord {
-    sessionId: string;
-    agentType: string;
-    capabilities: AgentCapabilities;
-    agentInfo: AgentInfo | null;
-    createdAt: number;
-}
-interface PersistedSessionEvent {
-    sessionId: string;
-    seq: number;
-    event: JsonRpcNotification;
-    createdAt: number;
-}
-type SerializableCronAction = {
-    type: "session";
-    agentType: string;
-    prompt: string;
-    cwd?: string;
-} | {
-    type: "exec";
-    command: string;
-    args?: string[];
-};
-interface SerializableCronJobOptions {
-    id?: string;
-    schedule: string;
-    action: SerializableCronAction;
-    overlap?: "allow" | "skip" | "queue";
-}
-interface SerializableCronJobInfo {
-    id: string;
-    schedule: string;
-    action: SerializableCronAction;
-    overlap: "allow" | "skip" | "queue";
-    lastRun?: string;
-    nextRun?: string;
-    runCount: number;
-    running: boolean;
-}
-type AgentOsActionContext<TConnParams = undefined> = ActionContext<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, any>;
-
-declare const agentOsActorConfigSchema: z$1.ZodObject<{
-    options: z$1.ZodOptional<z$1.ZodCustom<AgentOsOptions, AgentOsOptions>>;
-    preview: z$1.ZodPrefault<z$1.ZodObject<{
-        defaultExpiresInSeconds: z$1.ZodDefault<z$1.ZodNumber>;
-        maxExpiresInSeconds: z$1.ZodDefault<z$1.ZodNumber>;
-    }, z$1.core.$strict>>;
-    onBeforeConnect: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onSessionEvent: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-    onPermissionRequest: z$1.ZodOptional<z$1.ZodCustom<(...args: unknown[]) => unknown, (...args: unknown[]) => unknown>>;
-}, z$1.core.$strict>;
-type AgentOsActorContext<TConnParams> = ActorContext<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, any>;
-interface AgentOsActorConfigCallbacks<TConnParams> {
-    onBeforeConnect?: (c: BeforeConnectContext<AgentOsActorState, AgentOsActorVars, undefined, any>, params: TConnParams) => void | Promise<void>;
-    onSessionEvent?: (c: AgentOsActorContext<TConnParams>, sessionId: string, event: JsonRpcNotification) => void | Promise<void>;
-    onPermissionRequest?: (c: AgentOsActorContext<TConnParams>, sessionId: string, request: PermissionRequest) => void | Promise<void>;
-}
-type AgentOsActorConfig<TConnParams = undefined> = Omit<z$1.infer<typeof agentOsActorConfigSchema>, "onBeforeConnect" | "onSessionEvent" | "onPermissionRequest"> & AgentOsActorConfigCallbacks<TConnParams>;
-type AgentOsActorConfigInput<TConnParams = undefined> = Omit<z$1.input<typeof agentOsActorConfigSchema>, "onBeforeConnect" | "onSessionEvent" | "onPermissionRequest"> & AgentOsActorConfigCallbacks<TConnParams>;
-
-declare function buildCronActions<TConnParams>(config: AgentOsActorConfig<TConnParams>): {
-    scheduleCron: (c: AgentOsActionContext<TConnParams>, options: SerializableCronJobOptions) => Promise<{
-        id: string;
-    }>;
-    listCronJobs: (c: AgentOsActionContext<TConnParams>) => Promise<SerializableCronJobInfo[]>;
-    cancelCronJob: (c: AgentOsActionContext<TConnParams>, id: string) => Promise<void>;
-};
-
-declare function migrateAgentOsTables(db: RawAccess): Promise<void>;
-
-type VirtualStat = Awaited<ReturnType<_rivet_dev_agent_os_core.AgentOs["stat"]>>;
-type DeleteOptions = Parameters<_rivet_dev_agent_os_core.AgentOs["delete"]>[1];
-declare function buildFilesystemActions<TConnParams>(config: AgentOsActorConfig<TConnParams>): {
-    readFile: (c: AgentOsActionContext<TConnParams>, path: string) => Promise<Uint8Array>;
-    writeFile: (c: AgentOsActionContext<TConnParams>, path: string, content: string | Uint8Array) => Promise<void>;
-    readFiles: (c: AgentOsActionContext<TConnParams>, paths: string[]) => Promise<BatchReadResult[]>;
-    writeFiles: (c: AgentOsActionContext<TConnParams>, entries: BatchWriteEntry[]) => Promise<BatchWriteResult[]>;
-    mkdir: (c: AgentOsActionContext<TConnParams>, path: string, options?: {
-        recursive?: boolean;
-    }) => Promise<void>;
-    readdir: (c: AgentOsActionContext<TConnParams>, path: string) => Promise<string[]>;
-    readdirRecursive: (c: AgentOsActionContext<TConnParams>, path: string, options?: ReaddirRecursiveOptions) => Promise<DirEntry[]>;
-    stat: (c: AgentOsActionContext<TConnParams>, path: string) => Promise<VirtualStat>;
-    exists: (c: AgentOsActionContext<TConnParams>, path: string) => Promise<boolean>;
-    move: (c: AgentOsActionContext<TConnParams>, from: string, to: string) => Promise<void>;
-    deleteFile: (c: AgentOsActionContext<TConnParams>, path: string, options?: DeleteOptions) => Promise<void>;
-    listAgents: (c: AgentOsActionContext<TConnParams>) => Promise<AgentRegistryEntry[]>;
-};
-
-declare function ensureVm<TConnParams>(c: AgentOsActionContext<TConnParams>, config: AgentOsActorConfig<TConnParams>): Promise<AgentOs>;
-declare function syncPreventSleep<TConnParams>(c: AgentOsActionContext<TConnParams>): void;
-declare function runHook<TConnParams>(c: AgentOsActionContext<TConnParams>, name: string, callback: () => void | Promise<void>): void;
-declare function agentOs<TConnParams = undefined>(config: AgentOsActorConfigInput<TConnParams>): ActorDefinition<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, DatabaseProvider<RawAccess>, {
-    sessionEvent: typeof sessionEventToken;
-    permissionRequest: typeof permissionRequestToken;
-    vmBooted: typeof vmBootedToken;
-    vmShutdown: typeof vmShutdownToken;
-    processOutput: typeof processOutputToken;
-    processExit: typeof processExitToken;
-    shellData: typeof shellDataToken;
-    cronEvent: typeof cronEventToken;
-}, Record<never, never>, any>;
-declare const sessionEventToken: EventTypeToken<SessionEventPayload, any>;
-declare const permissionRequestToken: EventTypeToken<PermissionRequestPayload, any>;
-declare const vmBootedToken: EventTypeToken<VmBootedPayload, any>;
-declare const vmShutdownToken: EventTypeToken<VmShutdownPayload, any>;
-declare const processOutputToken: EventTypeToken<ProcessOutputPayload, any>;
-declare const processExitToken: EventTypeToken<ProcessExitPayload, any>;
-declare const shellDataToken: EventTypeToken<ShellDataPayload, any>;
-declare const cronEventToken: EventTypeToken<CronEventPayload, any>;
-
-interface VmFetchOptions {
-    method?: string;
-    headers?: Record<string, string>;
-    body?: string | Uint8Array;
-}
-interface VmFetchResult {
-    status: number;
-    statusText: string;
-    headers: Record<string, string>;
-    body: Uint8Array;
-}
-declare function buildNetworkActions<TConnParams>(config: AgentOsActorConfig<TConnParams>): {
-    vmFetch: (c: AgentOsActionContext<TConnParams>, port: number, url: string, options?: VmFetchOptions) => Promise<VmFetchResult>;
-};
-
-declare function generateToken(): string;
-type AgentOsRequestContext<TConnParams> = RequestContext<AgentOsActorState, TConnParams, undefined, AgentOsActorVars, undefined, DatabaseProvider<RawAccess>>;
-declare function buildOnRequestHandler<TConnParams>(config: AgentOsActorConfig<TConnParams>): (c: AgentOsRequestContext<TConnParams>, request: Request) => Promise<Response>;
-declare function buildPreviewActions<TConnParams>(config: AgentOsActorConfig<TConnParams>): {
-    createSignedPreviewUrl: (c: AgentOsActionContext<TConnParams>, port: number, expiresInSeconds?: number) => Promise<{
-        path: string;
-        token: string;
-        port: number;
-        expiresAt: number;
-    }>;
-    expireSignedPreviewUrl: (c: AgentOsActionContext<TConnParams>, token: string) => Promise<void>;
-};
-
-type ExecResult = Awaited<ReturnType<_rivet_dev_agent_os_core.AgentOs["exec"]>>;
-type ExecOptions = Parameters<_rivet_dev_agent_os_core.AgentOs["exec"]>[1];
-type SpawnOptions = Parameters<_rivet_dev_agent_os_core.AgentOs["spawn"]>[2];
-declare function buildProcessActions<TConnParams>(config: AgentOsActorConfig<TConnParams>): {
-    exec: (c: AgentOsActionContext<TConnParams>, command: string, options?: ExecOptions) => Promise<ExecResult>;
-    spawn: (c: AgentOsActionContext<TConnParams>, command: string, args: string[], options?: SpawnOptions) => Promise<{
-        pid: number;
-    }>;
-    writeProcessStdin: (c: AgentOsActionContext<TConnParams>, pid: number, data: string | Uint8Array) => Promise<void>;
-    closeProcessStdin: (c: AgentOsActionContext<TConnParams>, pid: number) => Promise<void>;
-    waitProcess: (c: AgentOsActionContext<TConnParams>, pid: number) => Promise<number>;
-    listProcesses: (c: AgentOsActionContext<TConnParams>) => Promise<SpawnedProcessInfo[]>;
-    allProcesses: (c: AgentOsActionContext<TConnParams>) => Promise<ProcessInfo[]>;
-    processTree: (c: AgentOsActionContext<TConnParams>) => Promise<ProcessTreeNode[]>;
-    getProcess: (c: AgentOsActionContext<TConnParams>, pid: number) => Promise<SpawnedProcessInfo>;
-    stopProcess: (c: AgentOsActionContext<TConnParams>, pid: number) => Promise<void>;
-    killProcess: (c: AgentOsActionContext<TConnParams>, pid: number) => Promise<void>;
-};
-
-declare function subscribeToSession<TConnParams>(c: AgentOsActionContext<TConnParams>, agentOs: AgentOs, sessionId: string, parsedConfig: AgentOsActorConfig<TConnParams>): void;
-declare function buildSessionActions<TConnParams>(config: AgentOsActorConfig<TConnParams>): {
-    createSession: (c: AgentOsActionContext<TConnParams>, agentType: AgentType, options?: CreateSessionOptions) => Promise<SessionRecord>;
-    listSessions: (c: AgentOsActionContext<TConnParams>) => Promise<SessionInfo[]>;
-    getSession: (c: AgentOsActionContext<TConnParams>, sessionId: string) => Promise<SessionRecord>;
-    destroySession: (c: AgentOsActionContext<TConnParams>, sessionId: string) => Promise<void>;
-    resumeSession: (c: AgentOsActionContext<TConnParams>, sessionId: string) => Promise<{
-        sessionId: string;
-    }>;
-    closeSession: (c: AgentOsActionContext<TConnParams>, sessionId: string) => Promise<void>;
-};
-declare function buildPromptActions<TConnParams>(_config: AgentOsActorConfig<TConnParams>): {
-    sendPrompt: (c: AgentOsActionContext<TConnParams>, sessionId: string, text: string) => Promise<PromptResult>;
-    cancelPrompt: (c: AgentOsActionContext<TConnParams>, sessionId: string) => Promise<JsonRpcResponse>;
-    respondPermission: (c: AgentOsActionContext<TConnParams>, sessionId: string, permissionId: string, reply: PermissionReply) => Promise<JsonRpcResponse>;
-};
-declare function buildConfigActions<TConnParams>(_config: AgentOsActorConfig<TConnParams>): {
-    setMode: (c: AgentOsActionContext<TConnParams>, sessionId: string, modeId: string) => Promise<JsonRpcResponse>;
-    getModes: (c: AgentOsActionContext<TConnParams>, sessionId: string) => Promise<SessionModeState | null>;
-    setModel: (c: AgentOsActionContext<TConnParams>, sessionId: string, model: string) => Promise<JsonRpcResponse>;
-    setThoughtLevel: (c: AgentOsActionContext<TConnParams>, sessionId: string, level: string) => Promise<JsonRpcResponse>;
-    getConfigOptions: (c: AgentOsActionContext<TConnParams>, sessionId: string) => Promise<SessionConfigOption[]>;
-    getEvents: (c: AgentOsActionContext<TConnParams>, sessionId: string, options?: GetEventsOptions) => Promise<JsonRpcNotification[]>;
-    getSequencedEvents: (c: AgentOsActionContext<TConnParams>, sessionId: string, options?: GetEventsOptions) => Promise<SequencedEvent[]>;
-    rawSend: (c: AgentOsActionContext<TConnParams>, sessionId: string, method: string, params?: Record<string, unknown>) => Promise<JsonRpcResponse>;
-};
-declare function buildSessionPersistenceActions<TConnParams>(_config: AgentOsActorConfig<TConnParams>): {
-    listPersistedSessions: (c: AgentOsActionContext<TConnParams>) => Promise<PersistedSessionRecord[]>;
-    getSessionEvents: (c: AgentOsActionContext<TConnParams>, sessionId: string) => Promise<PersistedSessionEvent[]>;
-};
-
-declare function buildShellActions<TConnParams>(config: AgentOsActorConfig<TConnParams>): {
-    openShell: (c: AgentOsActionContext<TConnParams>, options?: OpenShellOptions) => Promise<{
-        shellId: string;
-    }>;
-    writeShell: (c: AgentOsActionContext<TConnParams>, shellId: string, data: string | Uint8Array) => Promise<void>;
-    resizeShell: (c: AgentOsActionContext<TConnParams>, shellId: string, cols: number, rows: number) => Promise<void>;
-    closeShell: (c: AgentOsActionContext<TConnParams>, shellId: string) => Promise<void>;
-};
-
-type VirtualFileSystem = _rivet_dev_agent_os_core.PlainMountConfig["driver"];
-interface DatabaseVfsOptions {
-    /** The RawAccess database handle from the actor's db provider. */
-    db: RawAccess;
-}
-/**
- * Create a VirtualFileSystem backed by SQLite.
- *
- * The returned filesystem stores all content and metadata in the
- * `agent_os_fs_entries` table. The table must be created beforehand
- * via `migrateAgentOsTables()`.
- */
-declare function createDatabaseVfs(options: DatabaseVfsOptions): VirtualFileSystem;
-
-export { type AgentOsActionContext, type AgentOsActorConfig, type AgentOsActorConfigInput, type AgentOsActorState, type AgentOsActorVars, type AgentOsEvents, type CronEventPayload, type DatabaseVfsOptions, type PermissionRequestPayload, type PersistedSessionEvent, type PersistedSessionRecord, type ProcessExitPayload, type ProcessOutputPayload, type PromptResult, type SerializableCronAction, type SerializableCronJobOptions, type SessionEventPayload, type SessionRecord, type ShellDataPayload, type VmBootedPayload, type VmFetchOptions, type VmFetchResult, type VmShutdownPayload, agentOs, agentOsActorConfigSchema, buildConfigActions, buildCronActions, buildFilesystemActions, buildNetworkActions, buildOnRequestHandler, buildPreviewActions, buildProcessActions, buildPromptActions, buildSessionActions, buildSessionPersistenceActions, buildShellActions, createDatabaseVfs, ensureVm, generateToken, migrateAgentOsTables, runHook, subscribeToSession, syncPreventSleep };
+export {  }