@trigger.dev/core 0.0.0-prerelease-20260508094307 → 0.0.0-prerelease-deployment-base-image-20260814120901

package/dist/commonjs/v3/apiClient/index.d.ts

@@ -1,19 +1,20 @@
 import { z } from "zod";
-import { AddTagsRequestBody, ApiDeploymentListOptions, BatchItemNDJSON, BatchTaskRunExecutionResult, BatchTriggerTaskV3RequestBody, CompleteWaitpointTokenRequestBody, CreateBatchRequestBody, CreateBatchResponse, CreateEnvironmentVariableRequestBody, CreateInputStreamWaitpointRequestBody, CreateScheduleOptions, CreateWaitpointTokenRequestBody, CreateWaitpointTokenResponseBody, ListQueueOptions, ListRunResponseItem, ListScheduleOptions, QueryExecuteResponseBody, QuerySchemaResponseBody, ListDashboardsResponseBody, RescheduleRunRequestBody, RetrieveQueueParam, ResolvePromptRequestBody, PromotePromptVersionRequestBody, CreatePromptOverrideRequestBody, UpdatePromptOverrideRequestBody, ReactivatePromptOverrideRequestBody, StreamBatchItemsResponse, TaskRunExecutionResult, TriggerTaskRequestBody, UpdateEnvironmentVariableRequestBody, UpdateMetadataRequestBody, UpdateScheduleOptions, WaitForDurationRequestBody, WaitpointTokenItem } from "../schemas/index.js";
-import { AsyncIterableStream } from "../streams/asyncIterableStream.js";
-import { AnyRunTypes, TriggerJwtOptions } from "../types/tasks.js";
-import { Prettify } from "../types/utils.js";
-import { AnyZodFetchOptions, ApiPromise, ApiRequestOptions, CursorPagePromise, ZodFetchOptions, isRequestOptions } from "./core.js";
-import { AnyRealtimeRun, AnyRunShape, RealtimeRun, RunShape, RunStreamCallback, RunSubscription, SSEStreamSubscription, TaskRunShape, RealtimeRunSkipColumns, type SSEStreamPart } from "./runStream.js";
-import { CreateEnvironmentVariableParams, ImportEnvironmentVariablesParams, ListProjectRunsQueryParams, ListRunsQueryParams, ListWaitpointTokensQueryParams, SubscribeToRunsQueryParams, UpdateEnvironmentVariableParams } from "./types.js";
-import { ApiClientConfiguration } from "../apiClientManager-api.js";
+import type { ApiClientConfiguration } from "../apiClientManager-api.js";
+import { type AddTagsRequestBody, type ApiDeploymentListOptions, type BatchItemNDJSON, type BatchTriggerTaskV3RequestBody, type CloseSessionRequestBody, type CompleteWaitpointTokenRequestBody, type CreateBatchRequestBody, type CreateEnvironmentVariableRequestBody, type CreateInputStreamWaitpointRequestBody, type CreatePromptOverrideRequestBody, type CreateScheduleOptions, type CreateSessionRequestBody, type CreateSessionStreamWaitpointRequestBody, type CreateWaitpointTokenRequestBody, type EndAndContinueSessionRequestBody, type ListQueueOptions, type ListScheduleOptions, type ListSessionsOptions, type PromotePromptVersionRequestBody, type ReactivatePromptOverrideRequestBody, type RescheduleRunRequestBody, type ResolvePromptRequestBody, type RetrieveQueueParam, type TriggerTaskRequestBody, type UpdateEnvironmentVariableRequestBody, type UpdateMetadataRequestBody, type UpdatePromptOverrideRequestBody, type UpdateScheduleOptions, type UpdateSessionRequestBody, type WaitForDurationRequestBody, BulkActionObject, BatchTaskRunExecutionResult, CreateBatchResponse, CreateWaitpointTokenResponseBody, ListDashboardsResponseBody, ListRunResponseItem, ListedSessionItem, QueryExecuteResponseBody, QuerySchemaResponseBody, type ReportViewModel, StreamBatchItemsResponse, TaskRunExecutionResult, WaitpointTokenItem } from "../schemas/index.js";
+import { type ControlEvent } from "../sessionStreams/wireProtocol.js";
+import type { AsyncIterableStream } from "../streams/asyncIterableStream.js";
+import type { AnyRunTypes, TriggerJwtOptions } from "../types/tasks.js";
+import type { Prettify } from "../types/utils.js";
+import { type AnyZodFetchOptions, type ApiPromise, type ApiRequestOptions, type CursorPagePromise, type ZodFetchOptions, isRequestOptions } from "./core.js";
+import { type AnyRealtimeRun, type AnyRunShape, type RealtimeRun, type RealtimeRunSkipColumns, type RunShape, type RunStreamCallback, type RunSubscription, type TaskRunShape, SSEStreamSubscription, type SSEStreamPart } from "./runStream.js";
+import type { CreateBulkActionOptions, CreateEnvironmentVariableParams, ImportEnvironmentVariablesParams, ListBulkActionsQueryParams, ListProjectRunsQueryParams, ListRunsQueryParams, ListWaitpointTokensQueryParams, SubscribeToRunsQueryParams, UpdateEnvironmentVariableParams } from "./types.js";
 export type CreateWaitpointTokenResponse = Prettify<CreateWaitpointTokenResponseBody & {
     publicAccessToken: string;
 }>;
 export type CreateBatchApiResponse = Prettify<CreateBatchResponse & {
     publicAccessToken: string;
 }>;
-export type { CreateEnvironmentVariableParams, ImportEnvironmentVariablesParams, SubscribeToRunsQueryParams, UpdateEnvironmentVariableParams, RealtimeRunSkipColumns, };
+export type { CreateBulkActionOptions, CreateEnvironmentVariableParams, ImportEnvironmentVariablesParams, RealtimeRunSkipColumns, ListBulkActionsQueryParams, SubscribeToRunsQueryParams, UpdateEnvironmentVariableParams, };
 export type ClientTriggerOptions = {
     spanParentAsLink?: boolean;
 };
@@ -30,9 +31,17 @@ export type TriggerApiRequestOptions = ApiRequestOptions & {
 export type ApiClientFutureFlags = {
     v2RealtimeStreams?: boolean;
 };
-export { isRequestOptions, SSEStreamSubscription };
-export type { AnyRealtimeRun, AnyRunShape, ApiRequestOptions, RealtimeRun, RunShape, RunStreamCallback, RunSubscription, TaskRunShape, SSEStreamPart, };
+export { SSEStreamSubscription, isRequestOptions };
+export type { AnyRealtimeRun, AnyRunShape, ApiRequestOptions, RealtimeRun, RunShape, RunStreamCallback, RunSubscription, SSEStreamPart, TaskRunShape, };
 export * from "./getBranch.js";
+export type CreatePublicTokenRequestBody = {
+    scopes: string[];
+    expirationTime?: string | number;
+    oneTimeUse?: boolean;
+    realtime?: {
+        skipColumns?: string[];
+    };
+};
 /**
  * Trigger.dev v3 API client
  */
@@ -50,14 +59,14 @@ export declare class ApiClient {
     getRunResult(runId: string, requestOptions?: ZodFetchOptions): Promise<TaskRunExecutionResult | undefined>;
     getBatchResults(batchId: string, requestOptions?: ZodFetchOptions): Promise<BatchTaskRunExecutionResult | undefined>;
     triggerTask(taskId: string, body: TriggerTaskRequestBody, clientOptions?: ClientTriggerOptions, requestOptions?: TriggerRequestOptions): Promise<{
-        publicAccessToken: string;
         id: string;
         isCached?: boolean | undefined;
+        publicAccessToken: string;
     }>;
     batchTriggerV3(body: BatchTriggerTaskV3RequestBody, clientOptions?: ClientBatchTriggerOptions, requestOptions?: TriggerRequestOptions): Promise<{
-        publicAccessToken: string;
         id: string;
         runCount: number;
+        publicAccessToken: string;
     }>;
     /**
      * Phase 1 of 2-phase batch API: Create a batch
@@ -72,11 +81,11 @@ export declare class ApiClient {
      * @returns The created batch with ID and metadata
      */
     createBatch(body: CreateBatchRequestBody, clientOptions?: ClientTriggerOptions, requestOptions?: TriggerRequestOptions): Promise<{
-        publicAccessToken: string;
         id: string;
-        isCached: boolean;
         runCount: number;
+        isCached: boolean;
         idempotencyKey?: string | undefined;
+        publicAccessToken: string;
     }>;
     /**
      * Phase 2 of 2-phase batch API: Stream batch items
@@ -104,29 +113,73 @@ export declare class ApiClient {
         presignedUrl: string;
         storagePath?: string | undefined;
     }>;
+    /** Presigned PUT URL for a `chat.agent` session snapshot. */
+    createChatSnapshotUploadUrl(sessionId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        presignedUrl: string;
+        storagePath?: string | undefined;
+    }>;
+    /** Presigned GET URL for a `chat.agent` session snapshot. */
+    getChatSnapshotUrl(sessionId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        presignedUrl: string;
+        storagePath?: string | undefined;
+    }>;
     retrieveRun(runId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
-        status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
         id: string;
-        tags: string[];
+        status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
+        taskIdentifier: string;
+        idempotencyKey?: string | undefined;
+        version?: string | undefined;
+        isQueued: boolean;
+        isExecuting: boolean;
+        isWaiting: boolean;
+        isCompleted: boolean;
+        isSuccess: boolean;
+        isFailed: boolean;
+        isCancelled: boolean;
         isTest: boolean;
         createdAt: Date;
+        updatedAt: Date;
+        startedAt?: Date | undefined;
+        finishedAt?: Date | undefined;
+        delayedUntil?: Date | undefined;
+        ttl?: string | undefined;
+        expiredAt?: Date | undefined;
+        tags: string[];
+        costInCents: number;
         baseCostInCents: number;
         durationMs: number;
-        costInCents: number;
-        taskIdentifier: string;
+        metadata?: Record<string, any> | undefined;
+        taskKind?: string | undefined;
+        region?: string | undefined;
+        depth: number;
+        triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+        batchId?: string | undefined;
+        payload?: any;
+        payloadPresignedUrl?: string | undefined;
+        output?: any;
+        outputPresignedUrl?: string | undefined;
+        error?: {
+            message: string;
+            name?: string | undefined;
+            stackTrace?: string | undefined;
+        } | undefined;
+        schedule?: {
+            id: string;
+            externalId?: string | undefined;
+            deduplicationKey?: string | undefined;
+            generator: {
+                type: "CRON";
+                expression: string;
+                description: string;
+            };
+        } | undefined;
         relatedRuns: {
             root?: {
-                status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
                 id: string;
-                tags: string[];
-                isTest: boolean;
-                createdAt: Date;
-                baseCostInCents: number;
-                durationMs: number;
-                costInCents: number;
+                status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
                 taskIdentifier: string;
-                depth: number;
-                triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
+                idempotencyKey?: string | undefined;
+                version?: string | undefined;
                 isQueued: boolean;
                 isExecuting: boolean;
                 isWaiting: boolean;
@@ -134,29 +187,31 @@ export declare class ApiClient {
                 isSuccess: boolean;
                 isFailed: boolean;
                 isCancelled: boolean;
+                isTest: boolean;
+                createdAt: Date;
                 updatedAt: Date;
-                metadata?: Record<string, any> | undefined;
                 startedAt?: Date | undefined;
-                idempotencyKey?: string | undefined;
-                version?: string | undefined;
-                ttl?: string | undefined;
-                batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
+                ttl?: string | undefined;
                 expiredAt?: Date | undefined;
-            } | undefined;
-            parent?: {
-                status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
-                id: string;
                 tags: string[];
-                isTest: boolean;
-                createdAt: Date;
+                costInCents: number;
                 baseCostInCents: number;
                 durationMs: number;
-                costInCents: number;
-                taskIdentifier: string;
+                metadata?: Record<string, any> | undefined;
+                taskKind?: string | undefined;
+                region?: string | undefined;
                 depth: number;
-                triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
+                triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+                batchId?: string | undefined;
+            } | undefined;
+            parent?: {
+                id: string;
+                status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
+                taskIdentifier: string;
+                idempotencyKey?: string | undefined;
+                version?: string | undefined;
                 isQueued: boolean;
                 isExecuting: boolean;
                 isWaiting: boolean;
@@ -164,29 +219,31 @@ export declare class ApiClient {
                 isSuccess: boolean;
                 isFailed: boolean;
                 isCancelled: boolean;
+                isTest: boolean;
+                createdAt: Date;
                 updatedAt: Date;
-                metadata?: Record<string, any> | undefined;
                 startedAt?: Date | undefined;
-                idempotencyKey?: string | undefined;
-                version?: string | undefined;
-                ttl?: string | undefined;
-                batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
+                ttl?: string | undefined;
                 expiredAt?: Date | undefined;
-            } | undefined;
-            children?: {
-                status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
-                id: string;
                 tags: string[];
-                isTest: boolean;
-                createdAt: Date;
+                costInCents: number;
                 baseCostInCents: number;
                 durationMs: number;
-                costInCents: number;
-                taskIdentifier: string;
+                metadata?: Record<string, any> | undefined;
+                taskKind?: string | undefined;
+                region?: string | undefined;
                 depth: number;
-                triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
+                triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+                batchId?: string | undefined;
+            } | undefined;
+            children?: {
+                id: string;
+                status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
+                taskIdentifier: string;
+                idempotencyKey?: string | undefined;
+                version?: string | undefined;
                 isQueued: boolean;
                 isExecuting: boolean;
                 isWaiting: boolean;
@@ -194,105 +251,74 @@ export declare class ApiClient {
                 isSuccess: boolean;
                 isFailed: boolean;
                 isCancelled: boolean;
+                isTest: boolean;
+                createdAt: Date;
                 updatedAt: Date;
-                metadata?: Record<string, any> | undefined;
                 startedAt?: Date | undefined;
-                idempotencyKey?: string | undefined;
-                version?: string | undefined;
-                ttl?: string | undefined;
-                batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
+                ttl?: string | undefined;
                 expiredAt?: Date | undefined;
+                tags: string[];
+                costInCents: number;
+                baseCostInCents: number;
+                durationMs: number;
+                metadata?: Record<string, any> | undefined;
+                taskKind?: string | undefined;
+                region?: string | undefined;
+                depth: number;
+                triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+                batchId?: string | undefined;
             }[] | undefined;
         };
-        depth: number;
-        triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
-        isQueued: boolean;
-        isExecuting: boolean;
-        isWaiting: boolean;
-        isCompleted: boolean;
-        isSuccess: boolean;
-        isFailed: boolean;
-        isCancelled: boolean;
-        updatedAt: Date;
         attemptCount: number;
-        payload?: any;
-        error?: {
-            message: string;
-            name?: string | undefined;
-            stackTrace?: string | undefined;
-        } | undefined;
-        metadata?: Record<string, any> | undefined;
-        startedAt?: Date | undefined;
-        idempotencyKey?: string | undefined;
-        version?: string | undefined;
-        output?: any;
-        ttl?: string | undefined;
-        schedule?: {
-            id: string;
-            generator: {
-                type: "CRON";
-                description: string;
-                expression: string;
-            };
-            externalId?: string | undefined;
-            deduplicationKey?: string | undefined;
-        } | undefined;
-        payloadPresignedUrl?: string | undefined;
-        outputPresignedUrl?: string | undefined;
-        batchId?: string | undefined;
-        finishedAt?: Date | undefined;
-        delayedUntil?: Date | undefined;
-        expiredAt?: Date | undefined;
     }>;
     retrieveRunTrace(runId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         trace: {
             traceId: string;
             rootSpan: {
                 id: string;
+                parentId?: string | undefined;
+                runId: string;
                 data: {
                     message: string;
-                    duration: number;
-                    isCancelled: boolean;
-                    level: string;
-                    startTime: Date;
-                    isError: boolean;
-                    isPartial: boolean;
-                    output?: unknown;
-                    properties?: Record<string, any> | undefined;
                     taskSlug?: string | undefined;
                     taskPath?: string | undefined;
                     events?: any[] | undefined;
+                    startTime: Date;
+                    duration: number;
+                    isError: boolean;
+                    isPartial: boolean;
+                    isCancelled: boolean;
+                    level: string;
                     workerVersion?: string | undefined;
                     queueName?: string | undefined;
                     machinePreset?: string | undefined;
+                    properties?: Record<string, any> | undefined;
+                    output?: unknown;
                 };
-                runId: string;
-                parentId?: string | undefined;
             } & {
                 children: Array<import("../schemas/api.js").RetrieveRunTraceSpan>;
             };
         };
     }>;
     retrieveSpan(runId: string, spanId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        spanId: string;
+        parentId: string | null;
+        runId: string;
         message: string;
-        durationMs: number;
+        isError: boolean;
+        isPartial: boolean;
         isCancelled: boolean;
-        runId: string;
         level: string;
-        parentId: string | null;
         startTime: Date;
-        isError: boolean;
-        isPartial: boolean;
-        spanId: string;
+        durationMs: number;
         properties?: Record<string, any> | undefined;
         events?: any[] | undefined;
         entityType?: string | undefined;
         ai?: {
-            durationMs: number;
-            provider: string;
             model: string;
+            provider: string;
             operationName: string;
             inputTokens: number;
             outputTokens: number;
@@ -302,16 +328,19 @@ export declare class ApiClient {
             inputCost?: number | undefined;
             outputCost?: number | undefined;
             totalCost?: number | undefined;
+            cachedCost?: number | undefined;
+            cacheCreationCost?: number | undefined;
             tokensPerSecond?: number | undefined;
             msToFirstChunk?: number | undefined;
+            durationMs: number;
             finishReason?: string | undefined;
             responseText?: string | undefined;
         } | undefined;
         triggeredRuns?: {
+            runId: string;
+            taskIdentifier: string;
             status: string;
             createdAt: Date;
-            taskIdentifier: string;
-            runId: string;
         }[] | undefined;
     }>;
     listRuns(query?: ListRunsQueryParams, requestOptions?: ZodFetchOptions): CursorPagePromise<typeof ListRunResponseItem>;
@@ -322,32 +351,86 @@ export declare class ApiClient {
     cancelRun(runId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         id: string;
     }>;
+    createBulkAction(options: CreateBulkActionOptions, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+    }>;
+    listBulkActions(query?: ListBulkActionsQueryParams, requestOptions?: ZodFetchOptions): CursorPagePromise<typeof BulkActionObject>;
+    retrieveBulkAction(bulkActionId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        name?: string | undefined;
+        type: "CANCEL" | "REPLAY";
+        status: "ABORTED" | "COMPLETED" | "PENDING";
+        counts: {
+            total: number;
+            success: number;
+            failure: number;
+        };
+        createdAt: Date;
+        completedAt?: Date | undefined;
+    }>;
+    abortBulkAction(bulkActionId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+    }>;
     resetIdempotencyKey(taskIdentifier: string, idempotencyKey: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         id: string;
     }>;
     rescheduleRun(runId: string, body: RescheduleRunRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
-        status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
         id: string;
-        tags: string[];
+        status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
+        taskIdentifier: string;
+        idempotencyKey?: string | undefined;
+        version?: string | undefined;
+        isQueued: boolean;
+        isExecuting: boolean;
+        isWaiting: boolean;
+        isCompleted: boolean;
+        isSuccess: boolean;
+        isFailed: boolean;
+        isCancelled: boolean;
         isTest: boolean;
         createdAt: Date;
+        updatedAt: Date;
+        startedAt?: Date | undefined;
+        finishedAt?: Date | undefined;
+        delayedUntil?: Date | undefined;
+        ttl?: string | undefined;
+        expiredAt?: Date | undefined;
+        tags: string[];
+        costInCents: number;
         baseCostInCents: number;
         durationMs: number;
-        costInCents: number;
-        taskIdentifier: string;
+        metadata?: Record<string, any> | undefined;
+        taskKind?: string | undefined;
+        region?: string | undefined;
+        depth: number;
+        triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+        batchId?: string | undefined;
+        payload?: any;
+        payloadPresignedUrl?: string | undefined;
+        output?: any;
+        outputPresignedUrl?: string | undefined;
+        error?: {
+            message: string;
+            name?: string | undefined;
+            stackTrace?: string | undefined;
+        } | undefined;
+        schedule?: {
+            id: string;
+            externalId?: string | undefined;
+            deduplicationKey?: string | undefined;
+            generator: {
+                type: "CRON";
+                expression: string;
+                description: string;
+            };
+        } | undefined;
         relatedRuns: {
             root?: {
-                status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
                 id: string;
-                tags: string[];
-                isTest: boolean;
-                createdAt: Date;
-                baseCostInCents: number;
-                durationMs: number;
-                costInCents: number;
+                status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
                 taskIdentifier: string;
-                depth: number;
-                triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
+                idempotencyKey?: string | undefined;
+                version?: string | undefined;
                 isQueued: boolean;
                 isExecuting: boolean;
                 isWaiting: boolean;
@@ -355,29 +438,31 @@ export declare class ApiClient {
                 isSuccess: boolean;
                 isFailed: boolean;
                 isCancelled: boolean;
+                isTest: boolean;
+                createdAt: Date;
                 updatedAt: Date;
-                metadata?: Record<string, any> | undefined;
                 startedAt?: Date | undefined;
-                idempotencyKey?: string | undefined;
-                version?: string | undefined;
-                ttl?: string | undefined;
-                batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
+                ttl?: string | undefined;
                 expiredAt?: Date | undefined;
-            } | undefined;
-            parent?: {
-                status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
-                id: string;
                 tags: string[];
-                isTest: boolean;
-                createdAt: Date;
+                costInCents: number;
                 baseCostInCents: number;
                 durationMs: number;
-                costInCents: number;
-                taskIdentifier: string;
+                metadata?: Record<string, any> | undefined;
+                taskKind?: string | undefined;
+                region?: string | undefined;
                 depth: number;
-                triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
+                triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+                batchId?: string | undefined;
+            } | undefined;
+            parent?: {
+                id: string;
+                status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
+                taskIdentifier: string;
+                idempotencyKey?: string | undefined;
+                version?: string | undefined;
                 isQueued: boolean;
                 isExecuting: boolean;
                 isWaiting: boolean;
@@ -385,29 +470,31 @@ export declare class ApiClient {
                 isSuccess: boolean;
                 isFailed: boolean;
                 isCancelled: boolean;
+                isTest: boolean;
+                createdAt: Date;
                 updatedAt: Date;
-                metadata?: Record<string, any> | undefined;
                 startedAt?: Date | undefined;
-                idempotencyKey?: string | undefined;
-                version?: string | undefined;
-                ttl?: string | undefined;
-                batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
+                ttl?: string | undefined;
                 expiredAt?: Date | undefined;
-            } | undefined;
-            children?: {
-                status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
-                id: string;
                 tags: string[];
-                isTest: boolean;
-                createdAt: Date;
+                costInCents: number;
                 baseCostInCents: number;
                 durationMs: number;
-                costInCents: number;
-                taskIdentifier: string;
+                metadata?: Record<string, any> | undefined;
+                taskKind?: string | undefined;
+                region?: string | undefined;
                 depth: number;
-                triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
+                triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+                batchId?: string | undefined;
+            } | undefined;
+            children?: {
+                id: string;
+                status: "CANCELED" | "COMPLETED" | "CRASHED" | "DELAYED" | "DEQUEUED" | "EXECUTING" | "EXPIRED" | "FAILED" | "PENDING_VERSION" | "QUEUED" | "SYSTEM_FAILURE" | "TIMED_OUT" | "WAITING";
+                taskIdentifier: string;
+                idempotencyKey?: string | undefined;
+                version?: string | undefined;
                 isQueued: boolean;
                 isExecuting: boolean;
                 isWaiting: boolean;
@@ -415,81 +502,53 @@ export declare class ApiClient {
                 isSuccess: boolean;
                 isFailed: boolean;
                 isCancelled: boolean;
+                isTest: boolean;
+                createdAt: Date;
                 updatedAt: Date;
-                metadata?: Record<string, any> | undefined;
                 startedAt?: Date | undefined;
-                idempotencyKey?: string | undefined;
-                version?: string | undefined;
-                ttl?: string | undefined;
-                batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
+                ttl?: string | undefined;
                 expiredAt?: Date | undefined;
+                tags: string[];
+                costInCents: number;
+                baseCostInCents: number;
+                durationMs: number;
+                metadata?: Record<string, any> | undefined;
+                taskKind?: string | undefined;
+                region?: string | undefined;
+                depth: number;
+                triggerFunction: "batchTrigger" | "batchTriggerAndWait" | "trigger" | "triggerAndWait";
+                batchId?: string | undefined;
             }[] | undefined;
         };
-        depth: number;
-        triggerFunction: "trigger" | "batchTrigger" | "triggerAndWait" | "batchTriggerAndWait";
-        isQueued: boolean;
-        isExecuting: boolean;
-        isWaiting: boolean;
-        isCompleted: boolean;
-        isSuccess: boolean;
-        isFailed: boolean;
-        isCancelled: boolean;
-        updatedAt: Date;
         attemptCount: number;
-        payload?: any;
-        error?: {
-            message: string;
-            name?: string | undefined;
-            stackTrace?: string | undefined;
-        } | undefined;
-        metadata?: Record<string, any> | undefined;
-        startedAt?: Date | undefined;
-        idempotencyKey?: string | undefined;
-        version?: string | undefined;
-        output?: any;
-        ttl?: string | undefined;
-        schedule?: {
-            id: string;
-            generator: {
-                type: "CRON";
-                description: string;
-                expression: string;
-            };
-            externalId?: string | undefined;
-            deduplicationKey?: string | undefined;
-        } | undefined;
-        payloadPresignedUrl?: string | undefined;
-        outputPresignedUrl?: string | undefined;
-        batchId?: string | undefined;
-        finishedAt?: Date | undefined;
-        delayedUntil?: Date | undefined;
-        expiredAt?: Date | undefined;
     }>;
     listRunEvents(runId: string, requestOptions?: ZodFetchOptions): ApiPromise<any>;
     addTags(runId: string, body: AddTagsRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
         message: string;
     }>;
     createSchedule(options: CreateScheduleOptions, requestOptions?: ZodFetchOptions): ApiPromise<{
-        type: "DECLARATIVE" | "IMPERATIVE";
         id: string;
+        type: "DECLARATIVE" | "IMPERATIVE";
         task: string;
-        timezone: string;
-        environments: {
-            type: string;
-            id: string;
-            userName?: string | null | undefined;
-        }[];
+        active: boolean;
+        deduplicationKey?: string | null | undefined;
+        externalId?: string | null | undefined;
         generator: {
             type: "CRON";
-            description: string;
             expression: string;
+            description: string;
         };
-        active: boolean;
-        externalId?: string | null | undefined;
-        deduplicationKey?: string | null | undefined;
+        timezone: string;
+        window?: string | undefined;
         nextRun?: Date | null | undefined;
+        nextRunEffectiveAt?: Date | null | undefined;
+        environments: {
+            id: string;
+            type: string;
+            userName?: string | null | undefined;
+        }[];
     }>;
     listSchedules(options?: ListScheduleOptions, requestOptions?: ZodFetchOptions): import("./core.js").OffsetLimitPagePromise<z.ZodObject<{
         id: z.ZodString;
@@ -504,161 +563,175 @@ export declare class ApiClient {
             description: z.ZodString;
         }, "strip", z.ZodTypeAny, {
             type: "CRON";
-            description: string;
             expression: string;
+            description: string;
         }, {
             type: "CRON";
-            description: string;
             expression: string;
+            description: string;
         }>;
         timezone: z.ZodString;
+        window: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
         nextRun: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
+        nextRunEffectiveAt: z.ZodOptional<z.ZodNullable<z.ZodDate>>;
         environments: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             type: z.ZodString;
             userName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            type: string;
             id: string;
+            type: string;
             userName?: string | null | undefined;
         }, {
-            type: string;
             id: string;
+            type: string;
             userName?: string | null | undefined;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
-        type: "DECLARATIVE" | "IMPERATIVE";
         id: string;
+        type: "DECLARATIVE" | "IMPERATIVE";
         task: string;
-        timezone: string;
-        environments: {
-            type: string;
-            id: string;
-            userName?: string | null | undefined;
-        }[];
+        active: boolean;
+        deduplicationKey?: string | null | undefined;
+        externalId?: string | null | undefined;
         generator: {
             type: "CRON";
-            description: string;
             expression: string;
+            description: string;
         };
-        active: boolean;
-        externalId?: string | null | undefined;
-        deduplicationKey?: string | null | undefined;
-        nextRun?: Date | null | undefined;
-    }, {
-        type: "DECLARATIVE" | "IMPERATIVE";
-        id: string;
-        task: string;
         timezone: string;
+        window?: string | undefined;
+        nextRun?: Date | null | undefined;
+        nextRunEffectiveAt?: Date | null | undefined;
         environments: {
-            type: string;
             id: string;
+            type: string;
             userName?: string | null | undefined;
         }[];
+    }, {
+        id: string;
+        type: "DECLARATIVE" | "IMPERATIVE";
+        task: string;
+        active: boolean;
+        deduplicationKey?: string | null | undefined;
+        externalId?: string | null | undefined;
         generator: {
             type: "CRON";
-            description: string;
             expression: string;
+            description: string;
         };
-        active: boolean;
-        externalId?: string | null | undefined;
-        deduplicationKey?: string | null | undefined;
-        nextRun?: Date | null | undefined;
-    }>>;
-    retrieveSchedule(scheduleId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
-        type: "DECLARATIVE" | "IMPERATIVE";
-        id: string;
-        task: string;
         timezone: string;
+        window?: string | undefined;
+        nextRun?: Date | null | undefined;
+        nextRunEffectiveAt?: Date | null | undefined;
         environments: {
-            type: string;
             id: string;
+            type: string;
             userName?: string | null | undefined;
         }[];
+    }>>;
+    retrieveSchedule(scheduleId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        type: "DECLARATIVE" | "IMPERATIVE";
+        task: string;
+        active: boolean;
+        deduplicationKey?: string | null | undefined;
+        externalId?: string | null | undefined;
         generator: {
             type: "CRON";
-            description: string;
             expression: string;
+            description: string;
         };
-        active: boolean;
-        externalId?: string | null | undefined;
-        deduplicationKey?: string | null | undefined;
-        nextRun?: Date | null | undefined;
-    }>;
-    updateSchedule(scheduleId: string, options: UpdateScheduleOptions, requestOptions?: ZodFetchOptions): ApiPromise<{
-        type: "DECLARATIVE" | "IMPERATIVE";
-        id: string;
-        task: string;
         timezone: string;
+        window?: string | undefined;
+        nextRun?: Date | null | undefined;
+        nextRunEffectiveAt?: Date | null | undefined;
         environments: {
-            type: string;
             id: string;
+            type: string;
             userName?: string | null | undefined;
         }[];
+    }>;
+    updateSchedule(scheduleId: string, options: UpdateScheduleOptions, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        type: "DECLARATIVE" | "IMPERATIVE";
+        task: string;
+        active: boolean;
+        deduplicationKey?: string | null | undefined;
+        externalId?: string | null | undefined;
         generator: {
             type: "CRON";
-            description: string;
             expression: string;
+            description: string;
         };
-        active: boolean;
-        externalId?: string | null | undefined;
-        deduplicationKey?: string | null | undefined;
-        nextRun?: Date | null | undefined;
-    }>;
-    deactivateSchedule(scheduleId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
-        type: "DECLARATIVE" | "IMPERATIVE";
-        id: string;
-        task: string;
         timezone: string;
+        window?: string | undefined;
+        nextRun?: Date | null | undefined;
+        nextRunEffectiveAt?: Date | null | undefined;
         environments: {
-            type: string;
             id: string;
+            type: string;
             userName?: string | null | undefined;
         }[];
+    }>;
+    deactivateSchedule(scheduleId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        type: "DECLARATIVE" | "IMPERATIVE";
+        task: string;
+        active: boolean;
+        deduplicationKey?: string | null | undefined;
+        externalId?: string | null | undefined;
         generator: {
             type: "CRON";
-            description: string;
             expression: string;
+            description: string;
         };
-        active: boolean;
-        externalId?: string | null | undefined;
-        deduplicationKey?: string | null | undefined;
-        nextRun?: Date | null | undefined;
-    }>;
-    activateSchedule(scheduleId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
-        type: "DECLARATIVE" | "IMPERATIVE";
-        id: string;
-        task: string;
         timezone: string;
+        window?: string | undefined;
+        nextRun?: Date | null | undefined;
+        nextRunEffectiveAt?: Date | null | undefined;
         environments: {
-            type: string;
             id: string;
+            type: string;
             userName?: string | null | undefined;
         }[];
+    }>;
+    activateSchedule(scheduleId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        type: "DECLARATIVE" | "IMPERATIVE";
+        task: string;
+        active: boolean;
+        deduplicationKey?: string | null | undefined;
+        externalId?: string | null | undefined;
         generator: {
             type: "CRON";
-            description: string;
             expression: string;
+            description: string;
         };
-        active: boolean;
-        externalId?: string | null | undefined;
-        deduplicationKey?: string | null | undefined;
+        timezone: string;
+        window?: string | undefined;
         nextRun?: Date | null | undefined;
+        nextRunEffectiveAt?: Date | null | undefined;
+        environments: {
+            id: string;
+            type: string;
+            userName?: string | null | undefined;
+        }[];
     }>;
     deleteSchedule(scheduleId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         id: string;
     }>;
     listEnvVars(projectRef: string, slug: string, requestOptions?: ZodFetchOptions): ApiPromise<{
-        value: string;
         name: string;
+        value: string;
         isSecret: boolean;
     }[]>;
     importEnvVars(projectRef: string, slug: string, body: ImportEnvironmentVariablesParams, requestOptions?: ZodFetchOptions): ApiPromise<{
         success: boolean;
     }>;
     retrieveEnvVar(projectRef: string, slug: string, key: string, requestOptions?: ZodFetchOptions): ApiPromise<{
-        value: string;
         name: string;
+        value: string;
         isSecret: boolean;
     }>;
     createEnvVar(projectRef: string, slug: string, body: CreateEnvironmentVariableRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
@@ -679,15 +752,15 @@ export declare class ApiClient {
     createWaitpointToken(options: CreateWaitpointTokenRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<CreateWaitpointTokenResponse>;
     listWaitpointTokens(params?: ListWaitpointTokensQueryParams, requestOptions?: ZodFetchOptions): CursorPagePromise<typeof WaitpointTokenItem>;
     retrieveWaitpointToken(friendlyId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
-        status: "WAITING" | "COMPLETED" | "TIMED_OUT";
-        url: string;
         id: string;
-        tags: string[];
-        createdAt: Date;
-        idempotencyKey?: string | undefined;
+        url: string;
+        status: "COMPLETED" | "TIMED_OUT" | "WAITING";
         completedAt?: Date | undefined;
         timeoutAt?: Date | undefined;
+        idempotencyKey?: string | undefined;
         idempotencyKeyExpiresAt?: Date | undefined;
+        tags: string[];
+        createdAt: Date;
     } & {
         output?: string | undefined;
         outputType?: string | undefined;
@@ -702,6 +775,166 @@ export declare class ApiClient {
     }, requestOptions?: ZodFetchOptions): ApiPromise<{
         success: boolean;
     }>;
+    createSession(body: CreateSessionRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        externalId: string | null;
+        type: string;
+        taskIdentifier: string;
+        triggerConfig?: {
+            basePayload: Record<string, unknown>;
+            machine?: "large-1x" | "large-2x" | "medium-1x" | "medium-2x" | "micro" | "small-1x" | "small-2x" | undefined;
+            queue?: string | undefined;
+            tags?: string[] | undefined;
+            maxAttempts?: number | undefined;
+            maxDuration?: number | undefined;
+            lockToVersion?: string | undefined;
+            region?: string | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+        tags: string[];
+        metadata: Record<string, unknown> | null;
+        closedAt: Date | null;
+        closedReason: string | null;
+        expiresAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+        runId: string;
+        publicAccessToken: string;
+        isCached: boolean;
+    }>;
+    retrieveSession(sessionIdOrExternalId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        externalId: string | null;
+        type: string;
+        taskIdentifier: string;
+        triggerConfig?: {
+            basePayload: Record<string, unknown>;
+            machine?: "large-1x" | "large-2x" | "medium-1x" | "medium-2x" | "micro" | "small-1x" | "small-2x" | undefined;
+            queue?: string | undefined;
+            tags?: string[] | undefined;
+            maxAttempts?: number | undefined;
+            maxDuration?: number | undefined;
+            lockToVersion?: string | undefined;
+            region?: string | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+        tags: string[];
+        metadata: Record<string, unknown> | null;
+        closedAt: Date | null;
+        closedReason: string | null;
+        expiresAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    updateSession(sessionIdOrExternalId: string, body: UpdateSessionRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        externalId: string | null;
+        type: string;
+        taskIdentifier: string;
+        triggerConfig?: {
+            basePayload: Record<string, unknown>;
+            machine?: "large-1x" | "large-2x" | "medium-1x" | "medium-2x" | "micro" | "small-1x" | "small-2x" | undefined;
+            queue?: string | undefined;
+            tags?: string[] | undefined;
+            maxAttempts?: number | undefined;
+            maxDuration?: number | undefined;
+            lockToVersion?: string | undefined;
+            region?: string | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+        tags: string[];
+        metadata: Record<string, unknown> | null;
+        closedAt: Date | null;
+        closedReason: string | null;
+        expiresAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    closeSession(sessionIdOrExternalId: string, body?: CloseSessionRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        externalId: string | null;
+        type: string;
+        taskIdentifier: string;
+        triggerConfig?: {
+            basePayload: Record<string, unknown>;
+            machine?: "large-1x" | "large-2x" | "medium-1x" | "medium-2x" | "micro" | "small-1x" | "small-2x" | undefined;
+            queue?: string | undefined;
+            tags?: string[] | undefined;
+            maxAttempts?: number | undefined;
+            maxDuration?: number | undefined;
+            lockToVersion?: string | undefined;
+            region?: string | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+        tags: string[];
+        metadata: Record<string, unknown> | null;
+        closedAt: Date | null;
+        closedReason: string | null;
+        expiresAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    endAndContinueSession(sessionIdOrExternalId: string, body: EndAndContinueSessionRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        runId: string;
+        swapped: boolean;
+    }>;
+    listSessions(options?: ListSessionsOptions, requestOptions?: ZodFetchOptions): CursorPagePromise<typeof ListedSessionItem>;
+    initializeSessionStream(sessionIdOrExternalId: string, io: "out" | "in", requestOptions?: ZodFetchOptions): Promise<{
+        version: string;
+        headers: {
+            [k: string]: string;
+        };
+    }>;
+    appendToSessionStream<TBody extends BodyInit>(sessionIdOrExternalId: string, io: "out" | "in", part: TBody, requestOptions?: ZodFetchOptions): Promise<{
+        ok: boolean;
+        message?: string | undefined;
+    }>;
+    /**
+     * Non-SSE drain of a Session channel's tail. Returns whatever records
+     * exist after `afterEventId` (or from the head of the stream) and closes
+     * — `wait=0` semantics, no long-poll. Used by `replaySessionOutTail` at
+     * run boot, where the SSE long-poll's ~1s tax on empty streams is the
+     * dominant cost on every fresh chat.
+     *
+     * `afterEventId` is the same cursor format as the SSE Last-Event-ID
+     * (the S2 sequence number, stringified) — pass `lastOutEventId` from a
+     * persisted snapshot to resume.
+     */
+    readSessionStreamRecords(sessionIdOrExternalId: string, io: "out" | "in", options?: {
+        afterEventId?: string;
+        baseUrl?: string;
+    }): Promise<{
+        records: {
+            data?: unknown;
+            id: string;
+            seqNum: number;
+            headers?: [string, string][] | undefined;
+        }[];
+    }>;
+    /**
+     * Subscribe to SSE records on a Session channel. Reuses the same
+     * {@link SSEStreamSubscription} plumbing as `readStream` for run-scoped
+     * realtime streams — auto-retry, Last-Event-ID resume, abort-on-cancel.
+     */
+    subscribeToSessionStream<T = unknown>(sessionIdOrExternalId: string, io: "out" | "in", options?: {
+        signal?: AbortSignal;
+        baseUrl?: string;
+        timeoutInSeconds?: number;
+        onComplete?: () => void;
+        onError?: (error: Error) => void;
+        lastEventId?: string;
+        onPart?: (part: SSEStreamPart<T>) => void;
+        /**
+         * Fires when a `trigger-control` record arrives on the stream (e.g.
+         * `turn-complete`, `upgrade-required`). The control record is never
+         * enqueued into the consumer stream — handle the event here.
+         */
+        onControl?: (event: ControlEvent) => void;
+    }): Promise<AsyncIterableStream<T>>;
     waitForDuration(runId: string, body: WaitForDurationRequestBody, requestOptions?: ZodFetchOptions): Promise<{
         waitUntil: Date;
         waitpoint: {
@@ -723,109 +956,109 @@ export declare class ApiClient {
             overriddenAt: z.ZodNullable<z.ZodDate>;
             overriddenBy: z.ZodNullable<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
+            current: number | null;
             base: number | null;
             override: number | null;
-            current: number | null;
             overriddenAt: Date | null;
             overriddenBy: string | null;
         }, {
+            current: number | null;
             base: number | null;
             override: number | null;
-            current: number | null;
             overriddenAt: Date | null;
             overriddenBy: string | null;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        type: "custom" | "task";
-        name: string;
         id: string;
-        concurrencyLimit: number | null;
+        name: string;
+        type: "custom" | "task";
         running: number;
         queued: number;
         paused: boolean;
+        concurrencyLimit: number | null;
         concurrency?: {
+            current: number | null;
             base: number | null;
             override: number | null;
-            current: number | null;
             overriddenAt: Date | null;
             overriddenBy: string | null;
         } | undefined;
     }, {
-        type: "custom" | "task";
-        name: string;
         id: string;
-        concurrencyLimit: number | null;
+        name: string;
+        type: "custom" | "task";
         running: number;
         queued: number;
         paused: boolean;
+        concurrencyLimit: number | null;
         concurrency?: {
+            current: number | null;
             base: number | null;
             override: number | null;
-            current: number | null;
             overriddenAt: Date | null;
             overriddenBy: string | null;
         } | undefined;
     }>>;
     retrieveQueue(queue: RetrieveQueueParam, requestOptions?: ZodFetchOptions): ApiPromise<{
-        type: "custom" | "task";
-        name: string;
         id: string;
-        concurrencyLimit: number | null;
+        name: string;
+        type: "custom" | "task";
         running: number;
         queued: number;
         paused: boolean;
+        concurrencyLimit: number | null;
         concurrency?: {
+            current: number | null;
             base: number | null;
             override: number | null;
-            current: number | null;
             overriddenAt: Date | null;
             overriddenBy: string | null;
         } | undefined;
     }>;
     pauseQueue(queue: RetrieveQueueParam, action: "pause" | "resume", requestOptions?: ZodFetchOptions): ApiPromise<{
-        type: "custom" | "task";
-        name: string;
         id: string;
-        concurrencyLimit: number | null;
+        name: string;
+        type: "custom" | "task";
         running: number;
         queued: number;
         paused: boolean;
+        concurrencyLimit: number | null;
         concurrency?: {
+            current: number | null;
             base: number | null;
             override: number | null;
-            current: number | null;
             overriddenAt: Date | null;
             overriddenBy: string | null;
         } | undefined;
     }>;
     overrideQueueConcurrencyLimit(queue: RetrieveQueueParam, concurrencyLimit: number, requestOptions?: ZodFetchOptions): ApiPromise<{
-        type: "custom" | "task";
-        name: string;
         id: string;
-        concurrencyLimit: number | null;
+        name: string;
+        type: "custom" | "task";
         running: number;
         queued: number;
         paused: boolean;
+        concurrencyLimit: number | null;
         concurrency?: {
+            current: number | null;
             base: number | null;
             override: number | null;
-            current: number | null;
             overriddenAt: Date | null;
             overriddenBy: string | null;
         } | undefined;
     }>;
     resetQueueConcurrencyLimit(queue: RetrieveQueueParam, requestOptions?: ZodFetchOptions): ApiPromise<{
-        type: "custom" | "task";
-        name: string;
         id: string;
-        concurrencyLimit: number | null;
+        name: string;
+        type: "custom" | "task";
         running: number;
         queued: number;
         paused: boolean;
+        concurrencyLimit: number | null;
         concurrency?: {
+            current: number | null;
             base: number | null;
             override: number | null;
-            current: number | null;
             overriddenAt: Date | null;
             overriddenBy: string | null;
         } | undefined;
@@ -864,49 +1097,66 @@ export declare class ApiClient {
             stack: z.ZodOptional<z.ZodString>;
             stderr: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            message: string;
             name: string;
+            message: string;
             stack?: string | undefined;
             stderr?: string | undefined;
         }, {
-            message: string;
             name: string;
+            message: string;
             stack?: string | undefined;
             stderr?: string | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        status: "CANCELED" | "FAILED" | "TIMED_OUT" | "PENDING" | "BUILDING" | "DEPLOYING" | "DEPLOYED";
         id: string;
         createdAt: Date;
-        version: string;
         shortCode: string;
+        version: string;
         runtime: string | null;
         runtimeVersion: string | null;
+        status: "BUILDING" | "CANCELED" | "DEPLOYED" | "DEPLOYING" | "FAILED" | "PENDING" | "TIMED_OUT";
+        deployedAt?: Date | undefined;
+        git?: Record<string, any> | undefined;
         error?: {
-            message: string;
             name: string;
+            message: string;
             stack?: string | undefined;
             stderr?: string | undefined;
         } | undefined;
-        git?: Record<string, any> | undefined;
-        deployedAt?: Date | undefined;
     }, {
-        status: "CANCELED" | "FAILED" | "TIMED_OUT" | "PENDING" | "BUILDING" | "DEPLOYING" | "DEPLOYED";
         id: string;
         createdAt: Date;
-        version: string;
         shortCode: string;
+        version: string;
         runtime: string | null;
         runtimeVersion: string | null;
+        status: "BUILDING" | "CANCELED" | "DEPLOYED" | "DEPLOYING" | "FAILED" | "PENDING" | "TIMED_OUT";
+        deployedAt?: Date | undefined;
+        git?: Record<string, any> | undefined;
         error?: {
-            message: string;
             name: string;
+            message: string;
             stack?: string | undefined;
             stderr?: string | undefined;
         } | undefined;
-        git?: Record<string, any> | undefined;
-        deployedAt?: Date | undefined;
     }>>;
+    retrieveCurrentDeployment(requestOptions?: ZodFetchOptions): ApiPromise<{
+        id: string;
+        createdAt: Date;
+        shortCode: string;
+        version: string;
+        runtime: string | null;
+        runtimeVersion: string | null;
+        status: "BUILDING" | "CANCELED" | "DEPLOYED" | "DEPLOYING" | "FAILED" | "PENDING" | "TIMED_OUT";
+        deployedAt?: Date | undefined;
+        git?: Record<string, any> | undefined;
+        error?: {
+            name: string;
+            message: string;
+            stack?: string | undefined;
+            stderr?: string | undefined;
+        } | undefined;
+    }>;
     fetchStream<T>(runId: string, streamKey: string, options?: {
         signal?: AbortSignal;
         baseUrl?: string;
@@ -918,10 +1168,10 @@ export declare class ApiClient {
         onPart?: (part: SSEStreamPart<T>) => void;
     }): Promise<AsyncIterableStream<T>>;
     createStream(runId: string, target: string, streamId: string, requestOptions?: ZodFetchOptions): Promise<{
+        version: string;
         headers: {
             [k: string]: string;
         };
-        version: string;
     }>;
     appendToStream<TBody extends BodyInit>(runId: string, target: string, streamId: string, part: TBody, requestOptions?: ZodFetchOptions): Promise<{
         ok: boolean;
@@ -931,27 +1181,34 @@ export declare class ApiClient {
         ok: boolean;
     }>;
     createInputStreamWaitpoint(runFriendlyId: string, body: CreateInputStreamWaitpointRequestBody, requestOptions?: ZodFetchOptions): Promise<{
+        waitpointId: string;
         isCached: boolean;
+    }>;
+    createSessionStreamWaitpoint(runFriendlyId: string, body: CreateSessionStreamWaitpointRequestBody, requestOptions?: ZodFetchOptions): Promise<{
         waitpointId: string;
+        isCached: boolean;
     }>;
     generateJWTClaims(requestOptions?: ZodFetchOptions): Promise<Record<string, any>>;
+    createPublicToken(body: CreatePublicTokenRequestBody, requestOptions?: ZodFetchOptions): Promise<{
+        token: string;
+    }>;
     retrieveBatch(batchId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
-        status: "COMPLETED" | "PENDING" | "PROCESSING" | "PARTIAL_FAILED" | "ABORTED";
         id: string;
+        status: "ABORTED" | "COMPLETED" | "PARTIAL_FAILED" | "PENDING" | "PROCESSING";
+        idempotencyKey?: string | undefined;
         createdAt: Date;
         updatedAt: Date;
-        runs: string[];
         runCount: number;
+        runs: string[];
         processing: {
+            completedAt?: Date | undefined;
             errors: {
-                error: string;
-                taskIdentifier: string;
                 index: number;
+                taskIdentifier: string;
+                error: string;
                 errorCode?: string | undefined;
             }[];
-            completedAt?: Date | undefined;
         };
-        idempotencyKey?: string | undefined;
     }>;
     executeQuery(query: string, options?: {
         scope?: "environment" | "project" | "organization";
@@ -962,41 +1219,53 @@ export declare class ApiClient {
     }, requestOptions?: ZodFetchOptions): Promise<QueryExecuteResponseBody>;
     getQuerySchema(requestOptions?: ZodFetchOptions): Promise<QuerySchemaResponseBody>;
     listDashboards(requestOptions?: ZodFetchOptions): Promise<ListDashboardsResponseBody>;
+    /**
+     * `format: "json"` returns a `ReportViewModel`; "markdown" (default) and "ansi" return a rendered
+     * string. `period` is a shorthand like "1h" or "7d", capped at 90d. Seconds are not accepted.
+     */
+    getReport(key: string, options: {
+        period?: string;
+        format: "json";
+    }): Promise<ReportViewModel>;
+    getReport(key: string, options?: {
+        period?: string;
+        format?: "markdown" | "ansi";
+    }): Promise<string>;
     resolvePrompt(slug: string, body: ResolvePromptRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
         data: {
-            version: number;
-            slug: string;
             promptId: string;
+            slug: string;
+            version: number;
             labels: string[];
-            model?: string | null | undefined;
-            config?: Record<string, unknown> | null | undefined;
             template?: string | undefined;
             text?: string | undefined;
+            model?: string | null | undefined;
+            config?: Record<string, unknown> | null | undefined;
         };
     }>;
     listPrompts(requestOptions?: ZodFetchOptions): ApiPromise<{
         data: {
-            tags: string[];
             slug: string;
-            description: string | null;
-            updatedAt: string;
             friendlyId: string;
+            description: string | null;
+            tags: string[];
             defaultModel: string | null;
             currentVersion: number | null;
             hasOverride: boolean;
+            updatedAt: string;
         }[];
     }>;
     listPromptVersions(slug: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         data: {
-            source: string;
             id: string;
-            createdAt: string;
             version: number;
-            commitMessage: string | null;
-            model: string | null;
-            contentHash: string;
             labels: string[];
+            source: string;
+            model: string | null;
             textContent: string | null;
+            commitMessage: string | null;
+            contentHash: string;
+            createdAt: string;
         }[];
     }>;
     promotePromptVersion(slug: string, body: PromotePromptVersionRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{