rivetkit 2.3.11-rc.8 → 2.3.11

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

@@ -15,7 +15,7 @@ interface ActorMetricsLike {
     totalKvWrites: number;
     trackSql(query: string, durationMs: number): void;
 }
-type InferDatabaseClient<DBProvider extends AnyDatabaseProvider> = DBProvider extends DatabaseProvider<any> ? Awaited<ReturnType<DBProvider["createClient"]>> : never;
+type InferDatabaseClient<DBProvider extends AnyDatabaseProvider> = DBProvider extends DatabaseProvider<any> ? Awaited<ReturnType<DBProvider["createClient"]>> : RawAccess;
 type SqliteBindings = unknown[] | Record<string, unknown>;
 interface SqliteQueryResult {
     columns: string[];
@@ -29,6 +29,41 @@ 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;
@@ -46,7 +81,7 @@ 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): Promise<SqliteTransactionDatabase>;
+    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;
@@ -101,6 +136,13 @@ interface DatabaseProviderContext {
     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`.
@@ -125,9 +167,7 @@ type RawAccess = {
      */
     execute: ExecuteFunction;
     /** Runs a callback in an isolated SQLite transaction. */
-    transaction: <T>(callback: (tx: RawAccess) => Promise<T> | T, options?: {
-        timeout?: number;
-    }) => Promise<T>;
+    transaction: <T>(callback: (tx: RawAccess) => Promise<T> | T, options?: SqliteTransactionOptions) => Promise<T>;
     /**
      * Returns native SQLite metrics when the active runtime supports them.
      */
@@ -587,6 +627,7 @@ 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 {
@@ -753,6 +794,7 @@ interface RuntimeActorConfig {
     icon?: string;
     hasDatabase?: boolean;
     remoteSqlite?: boolean;
+    sqliteProfiling?: SqliteProfilingOptions;
     enableActorRuntimeSocket?: boolean;
     hasState?: boolean;
     canHibernateWebsocket?: boolean;
@@ -894,6 +936,7 @@ interface CoreRuntime {
     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;
@@ -939,11 +982,15 @@ interface CoreRuntime {
     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): Promise<SqliteTransactionHandle>;
+    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;
@@ -954,6 +1001,7 @@ interface CoreRuntime {
     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;
@@ -1137,7 +1185,9 @@ type LooseEventSubscribe = (eventName: string, callback: (...args: any[]) => voi
 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 extends BaseActorDefinition<any, any, any, any, any, any, any, any, infer R> ? R : never;
+type ActionsOf<AD extends AnyActorDefinition> = AD["config"] extends {
+    actions?: infer R;
+} ? R : never;
 interface ActorGatewayOptions {
     skipReadyWait?: boolean;
 }
@@ -1620,6 +1670,9 @@ type Client<A extends Registry<any>> = ClientRaw & {
     [K in keyof ExtractActorsFromRegistry<A>]: ActorAccessor<ExtractActorsFromRegistry<A>[K]>;
 };
 
+/** @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 {
@@ -1655,7 +1708,7 @@ type ActorKvListOptions<T extends ActorKvValueType = "text", K extends ActorKvKe
 };
 type ActorClientFor<T> = T extends Registry<any> ? Client<T> : T;
 /**
- * @deprecated Actor KV is deprecated. Use embedded SQLite (`c.db` / `c.sql`)
+ * @deprecated Actor KV is deprecated. Use embedded SQLite (`c.db`)
  * or actor state instead.
  */
 interface ActorKv {
@@ -1752,6 +1805,8 @@ type QueueMessageOf<Name extends string, Body> = {
 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[];
@@ -1794,6 +1849,13 @@ interface ActorQueue<TQueues extends QueueSchemaConfig = Record<never, never>> {
     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[]>;
@@ -1816,7 +1878,7 @@ interface ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase
     state: TState;
     vars: TVars;
     /**
-     * @deprecated Actor KV is deprecated. Use embedded SQLite (`db` / `sql`)
+     * @deprecated Actor KV is deprecated. Use embedded SQLite (`c.db`)
      * or actor state instead.
      */
     readonly kv: ActorKv;
@@ -1824,6 +1886,8 @@ interface ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase
     readonly schedule: ActorSchedule;
     readonly cron: ActorCron;
     readonly queue: ActorQueue<TQueues>;
+    /** @experimental */
+    readonly run: ActorRun;
     readonly actorId: string;
     readonly name: string;
     readonly key: string[];
@@ -1853,6 +1917,14 @@ interface ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase
     client<T = any>(): ActorClientFor<T>;
     [key: string]: any;
 }
+/** @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>;
+}
 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>;
 };
@@ -1879,6 +1951,7 @@ declare const RunConfigSchema: z$1.ZodObject<{
     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>>;
@@ -1901,6 +1974,7 @@ declare const ActorConfigSchema: z$1.ZodObject<{
         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>>;

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

@@ -15,7 +15,7 @@ interface ActorMetricsLike {
     totalKvWrites: number;
     trackSql(query: string, durationMs: number): void;
 }
-type InferDatabaseClient<DBProvider extends AnyDatabaseProvider> = DBProvider extends DatabaseProvider<any> ? Awaited<ReturnType<DBProvider["createClient"]>> : never;
+type InferDatabaseClient<DBProvider extends AnyDatabaseProvider> = DBProvider extends DatabaseProvider<any> ? Awaited<ReturnType<DBProvider["createClient"]>> : RawAccess;
 type SqliteBindings = unknown[] | Record<string, unknown>;
 interface SqliteQueryResult {
     columns: string[];
@@ -29,6 +29,41 @@ 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;
@@ -46,7 +81,7 @@ 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): Promise<SqliteTransactionDatabase>;
+    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;
@@ -101,6 +136,13 @@ interface DatabaseProviderContext {
     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`.
@@ -125,9 +167,7 @@ type RawAccess = {
      */
     execute: ExecuteFunction;
     /** Runs a callback in an isolated SQLite transaction. */
-    transaction: <T>(callback: (tx: RawAccess) => Promise<T> | T, options?: {
-        timeout?: number;
-    }) => Promise<T>;
+    transaction: <T>(callback: (tx: RawAccess) => Promise<T> | T, options?: SqliteTransactionOptions) => Promise<T>;
     /**
      * Returns native SQLite metrics when the active runtime supports them.
      */
@@ -587,6 +627,7 @@ 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 {
@@ -753,6 +794,7 @@ interface RuntimeActorConfig {
     icon?: string;
     hasDatabase?: boolean;
     remoteSqlite?: boolean;
+    sqliteProfiling?: SqliteProfilingOptions;
     enableActorRuntimeSocket?: boolean;
     hasState?: boolean;
     canHibernateWebsocket?: boolean;
@@ -894,6 +936,7 @@ interface CoreRuntime {
     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;
@@ -939,11 +982,15 @@ interface CoreRuntime {
     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): Promise<SqliteTransactionHandle>;
+    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;
@@ -954,6 +1001,7 @@ interface CoreRuntime {
     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;
@@ -1137,7 +1185,9 @@ type LooseEventSubscribe = (eventName: string, callback: (...args: any[]) => voi
 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 extends BaseActorDefinition<any, any, any, any, any, any, any, any, infer R> ? R : never;
+type ActionsOf<AD extends AnyActorDefinition> = AD["config"] extends {
+    actions?: infer R;
+} ? R : never;
 interface ActorGatewayOptions {
     skipReadyWait?: boolean;
 }
@@ -1620,6 +1670,9 @@ type Client<A extends Registry<any>> = ClientRaw & {
     [K in keyof ExtractActorsFromRegistry<A>]: ActorAccessor<ExtractActorsFromRegistry<A>[K]>;
 };
 
+/** @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 {
@@ -1655,7 +1708,7 @@ type ActorKvListOptions<T extends ActorKvValueType = "text", K extends ActorKvKe
 };
 type ActorClientFor<T> = T extends Registry<any> ? Client<T> : T;
 /**
- * @deprecated Actor KV is deprecated. Use embedded SQLite (`c.db` / `c.sql`)
+ * @deprecated Actor KV is deprecated. Use embedded SQLite (`c.db`)
  * or actor state instead.
  */
 interface ActorKv {
@@ -1752,6 +1805,8 @@ type QueueMessageOf<Name extends string, Body> = {
 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[];
@@ -1794,6 +1849,13 @@ interface ActorQueue<TQueues extends QueueSchemaConfig = Record<never, never>> {
     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[]>;
@@ -1816,7 +1878,7 @@ interface ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase
     state: TState;
     vars: TVars;
     /**
-     * @deprecated Actor KV is deprecated. Use embedded SQLite (`db` / `sql`)
+     * @deprecated Actor KV is deprecated. Use embedded SQLite (`c.db`)
      * or actor state instead.
      */
     readonly kv: ActorKv;
@@ -1824,6 +1886,8 @@ interface ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase
     readonly schedule: ActorSchedule;
     readonly cron: ActorCron;
     readonly queue: ActorQueue<TQueues>;
+    /** @experimental */
+    readonly run: ActorRun;
     readonly actorId: string;
     readonly name: string;
     readonly key: string[];
@@ -1853,6 +1917,14 @@ interface ActorContext<TState, TConnParams, TConnState, TVars, TInput, TDatabase
     client<T = any>(): ActorClientFor<T>;
     [key: string]: any;
 }
+/** @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>;
+}
 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>;
 };
@@ -1879,6 +1951,7 @@ declare const RunConfigSchema: z$1.ZodObject<{
     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>>;
@@ -1901,6 +1974,7 @@ declare const ActorConfigSchema: z$1.ZodObject<{
         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>>;