@trigger.dev/core 4.4.6 → 4.5.0-rc.1

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

@@ -26,6 +26,11 @@ export declare class AuthenticationError extends ApiError {
 export declare class PermissionDeniedError extends ApiError {
     readonly status: 403;
 }
+/**
+ * True when `error` is a 401/403 from the Trigger API (e.g. expired run-scoped PAT on realtime streams).
+ * Uses structural checks so it works even if multiple copies of `@trigger.dev/core` are bundled (subclass `instanceof` can fail).
+ */
+export declare function isTriggerRealtimeAuthError(error: unknown): boolean;
 export declare class NotFoundError extends ApiError {
     readonly status: 404;
 }

package/dist/commonjs/v3/apiClient/errors.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BatchNotSealedError = exports.ApiSchemaValidationError = exports.InternalServerError = exports.RateLimitError = exports.UnprocessableEntityError = exports.ConflictError = exports.NotFoundError = exports.PermissionDeniedError = exports.AuthenticationError = exports.BadRequestError = exports.ApiConnectionError = exports.ApiError = void 0;
+exports.isTriggerRealtimeAuthError = isTriggerRealtimeAuthError;
 class ApiError extends Error {
     status;
     headers;
@@ -99,6 +100,17 @@ class PermissionDeniedError extends ApiError {
     status = 403;
 }
 exports.PermissionDeniedError = PermissionDeniedError;
+/**
+ * True when `error` is a 401/403 from the Trigger API (e.g. expired run-scoped PAT on realtime streams).
+ * Uses structural checks so it works even if multiple copies of `@trigger.dev/core` are bundled (subclass `instanceof` can fail).
+ */
+function isTriggerRealtimeAuthError(error) {
+    if (error === null || typeof error !== "object") {
+        return false;
+    }
+    const e = error;
+    return e.name === "TriggerApiError" && (e.status === 401 || e.status === 403);
+}
 class NotFoundError extends ApiError {
     status = 404;
 }

package/dist/commonjs/v3/apiClient/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/v3/apiClient/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/v3/apiClient/errors.ts"],"names":[],"mappings":"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"}

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

@@ -1,10 +1,11 @@
 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 { AddTagsRequestBody, ApiDeploymentListOptions, BatchItemNDJSON, BatchTaskRunExecutionResult, BatchTriggerTaskV3RequestBody, CloseSessionRequestBody, CompleteWaitpointTokenRequestBody, CreateSessionRequestBody, EndAndContinueSessionRequestBody, ListSessionsOptions, ListedSessionItem, UpdateSessionRequestBody, CreateBatchRequestBody, CreateBatchResponse, CreateEnvironmentVariableRequestBody, CreateInputStreamWaitpointRequestBody, CreateSessionStreamWaitpointRequestBody, 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 { type ControlEvent } from "../sessionStreams/wireProtocol.js";
 import { CreateEnvironmentVariableParams, ImportEnvironmentVariablesParams, ListProjectRunsQueryParams, ListRunsQueryParams, ListWaitpointTokensQueryParams, SubscribeToRunsQueryParams, UpdateEnvironmentVariableParams } from "./types.js";
 import { ApiClientConfiguration } from "../apiClientManager-api.js";
 export type CreateWaitpointTokenResponse = Prettify<CreateWaitpointTokenResponseBody & {
@@ -104,6 +105,16 @@ 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;
@@ -139,11 +150,13 @@ export declare class ApiClient {
                 startedAt?: Date | undefined;
                 idempotencyKey?: string | undefined;
                 version?: string | undefined;
+                region?: string | undefined;
                 ttl?: string | undefined;
                 batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
                 expiredAt?: Date | undefined;
+                taskKind?: string | undefined;
             } | undefined;
             parent?: {
                 status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
@@ -169,11 +182,13 @@ export declare class ApiClient {
                 startedAt?: Date | undefined;
                 idempotencyKey?: string | undefined;
                 version?: string | undefined;
+                region?: string | undefined;
                 ttl?: string | undefined;
                 batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
                 expiredAt?: Date | undefined;
+                taskKind?: string | undefined;
             } | undefined;
             children?: {
                 status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
@@ -199,11 +214,13 @@ export declare class ApiClient {
                 startedAt?: Date | undefined;
                 idempotencyKey?: string | undefined;
                 version?: string | undefined;
+                region?: string | undefined;
                 ttl?: string | undefined;
                 batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
                 expiredAt?: Date | undefined;
+                taskKind?: string | undefined;
             }[] | undefined;
         };
         depth: number;
@@ -227,6 +244,7 @@ export declare class ApiClient {
         startedAt?: Date | undefined;
         idempotencyKey?: string | undefined;
         version?: string | undefined;
+        region?: string | undefined;
         output?: any;
         ttl?: string | undefined;
         schedule?: {
@@ -245,6 +263,7 @@ export declare class ApiClient {
         finishedAt?: Date | undefined;
         delayedUntil?: Date | undefined;
         expiredAt?: Date | undefined;
+        taskKind?: string | undefined;
     }>;
     retrieveRunTrace(runId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         trace: {
@@ -360,11 +379,13 @@ export declare class ApiClient {
                 startedAt?: Date | undefined;
                 idempotencyKey?: string | undefined;
                 version?: string | undefined;
+                region?: string | undefined;
                 ttl?: string | undefined;
                 batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
                 expiredAt?: Date | undefined;
+                taskKind?: string | undefined;
             } | undefined;
             parent?: {
                 status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
@@ -390,11 +411,13 @@ export declare class ApiClient {
                 startedAt?: Date | undefined;
                 idempotencyKey?: string | undefined;
                 version?: string | undefined;
+                region?: string | undefined;
                 ttl?: string | undefined;
                 batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
                 expiredAt?: Date | undefined;
+                taskKind?: string | undefined;
             } | undefined;
             children?: {
                 status: "PENDING_VERSION" | "QUEUED" | "DEQUEUED" | "EXECUTING" | "WAITING" | "COMPLETED" | "CANCELED" | "FAILED" | "CRASHED" | "SYSTEM_FAILURE" | "DELAYED" | "EXPIRED" | "TIMED_OUT";
@@ -420,11 +443,13 @@ export declare class ApiClient {
                 startedAt?: Date | undefined;
                 idempotencyKey?: string | undefined;
                 version?: string | undefined;
+                region?: string | undefined;
                 ttl?: string | undefined;
                 batchId?: string | undefined;
                 finishedAt?: Date | undefined;
                 delayedUntil?: Date | undefined;
                 expiredAt?: Date | undefined;
+                taskKind?: string | undefined;
             }[] | undefined;
         };
         depth: number;
@@ -448,6 +473,7 @@ export declare class ApiClient {
         startedAt?: Date | undefined;
         idempotencyKey?: string | undefined;
         version?: string | undefined;
+        region?: string | undefined;
         output?: any;
         ttl?: string | undefined;
         schedule?: {
@@ -466,6 +492,7 @@ export declare class ApiClient {
         finishedAt?: Date | undefined;
         delayedUntil?: Date | undefined;
         expiredAt?: Date | undefined;
+        taskKind?: string | undefined;
     }>;
     listRunEvents(runId: string, requestOptions?: ZodFetchOptions): ApiPromise<any>;
     addTags(runId: string, body: AddTagsRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
@@ -702,6 +729,165 @@ export declare class ApiClient {
     }, requestOptions?: ZodFetchOptions): ApiPromise<{
         success: boolean;
     }>;
+    createSession(body: CreateSessionRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        type: string;
+        metadata: Record<string, unknown> | null;
+        id: string;
+        tags: string[];
+        createdAt: Date;
+        taskIdentifier: string;
+        externalId: string | null;
+        updatedAt: Date;
+        runId: string;
+        isCached: boolean;
+        expiresAt: Date | null;
+        closedAt: Date | null;
+        closedReason: string | null;
+        publicAccessToken: string;
+        triggerConfig?: {
+            basePayload: Record<string, unknown>;
+            tags?: string[] | undefined;
+            maxAttempts?: number | undefined;
+            maxDuration?: number | undefined;
+            region?: string | undefined;
+            queue?: string | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            lockToVersion?: string | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+    }>;
+    retrieveSession(sessionIdOrExternalId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
+        type: string;
+        metadata: Record<string, unknown> | null;
+        id: string;
+        tags: string[];
+        createdAt: Date;
+        taskIdentifier: string;
+        externalId: string | null;
+        updatedAt: Date;
+        expiresAt: Date | null;
+        closedAt: Date | null;
+        closedReason: string | null;
+        triggerConfig?: {
+            basePayload: Record<string, unknown>;
+            tags?: string[] | undefined;
+            maxAttempts?: number | undefined;
+            maxDuration?: number | undefined;
+            region?: string | undefined;
+            queue?: string | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            lockToVersion?: string | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+    }>;
+    updateSession(sessionIdOrExternalId: string, body: UpdateSessionRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        type: string;
+        metadata: Record<string, unknown> | null;
+        id: string;
+        tags: string[];
+        createdAt: Date;
+        taskIdentifier: string;
+        externalId: string | null;
+        updatedAt: Date;
+        expiresAt: Date | null;
+        closedAt: Date | null;
+        closedReason: string | null;
+        triggerConfig?: {
+            basePayload: Record<string, unknown>;
+            tags?: string[] | undefined;
+            maxAttempts?: number | undefined;
+            maxDuration?: number | undefined;
+            region?: string | undefined;
+            queue?: string | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            lockToVersion?: string | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+    }>;
+    closeSession(sessionIdOrExternalId: string, body?: CloseSessionRequestBody, requestOptions?: ZodFetchOptions): ApiPromise<{
+        type: string;
+        metadata: Record<string, unknown> | null;
+        id: string;
+        tags: string[];
+        createdAt: Date;
+        taskIdentifier: string;
+        externalId: string | null;
+        updatedAt: Date;
+        expiresAt: Date | null;
+        closedAt: Date | null;
+        closedReason: string | null;
+        triggerConfig?: {
+            basePayload: Record<string, unknown>;
+            tags?: string[] | undefined;
+            maxAttempts?: number | undefined;
+            maxDuration?: number | undefined;
+            region?: string | undefined;
+            queue?: string | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            lockToVersion?: string | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+    }>;
+    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<{
+        headers: {
+            [k: string]: string;
+        };
+        version: 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: {
+            id: string;
+            seqNum: number;
+            data?: unknown;
+        }[];
+    }>;
+    /**
+     * 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: {
@@ -907,6 +1093,23 @@ export declare class ApiClient {
         git?: Record<string, any> | undefined;
         deployedAt?: Date | undefined;
     }>>;
+    retrieveCurrentDeployment(requestOptions?: ZodFetchOptions): ApiPromise<{
+        status: "CANCELED" | "FAILED" | "TIMED_OUT" | "PENDING" | "BUILDING" | "DEPLOYING" | "DEPLOYED";
+        id: string;
+        createdAt: Date;
+        version: string;
+        shortCode: string;
+        runtime: string | null;
+        runtimeVersion: string | null;
+        error?: {
+            message: string;
+            name: string;
+            stack?: string | undefined;
+            stderr?: string | undefined;
+        } | undefined;
+        git?: Record<string, any> | undefined;
+        deployedAt?: Date | undefined;
+    }>;
     fetchStream<T>(runId: string, streamKey: string, options?: {
         signal?: AbortSignal;
         baseUrl?: string;
@@ -934,6 +1137,10 @@ export declare class ApiClient {
         isCached: boolean;
         waitpointId: string;
     }>;
+    createSessionStreamWaitpoint(runFriendlyId: string, body: CreateSessionStreamWaitpointRequestBody, requestOptions?: ZodFetchOptions): Promise<{
+        isCached: boolean;
+        waitpointId: string;
+    }>;
     generateJWTClaims(requestOptions?: ZodFetchOptions): Promise<Record<string, any>>;
     retrieveBatch(batchId: string, requestOptions?: ZodFetchOptions): ApiPromise<{
         status: "COMPLETED" | "PENDING" | "PROCESSING" | "PARTIAL_FAILED" | "ABORTED";

package/dist/commonjs/v3/apiClient/index.js

@@ -27,6 +27,7 @@ const errors_js_1 = require("./errors.js");
 const retries_js_1 = require("../utils/retries.js");
 const runStream_js_1 = require("./runStream.js");
 Object.defineProperty(exports, "SSEStreamSubscription", { enumerable: true, get: function () { return runStream_js_1.SSEStreamSubscription; } });
+const wireProtocol_js_1 = require("../sessionStreams/wireProtocol.js");
 const version_js_2 = require("./version.js");
 const getEnv_js_1 = require("../utils/getEnv.js");
 const DEFAULT_ZOD_FETCH_OPTIONS = {
@@ -328,6 +329,20 @@ class ApiClient {
             headers: this.#getHeaders(false),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    /** Presigned PUT URL for a `chat.agent` session snapshot. */
+    createChatSnapshotUploadUrl(sessionId, requestOptions) {
+        return (0, core_js_1.zodfetch)(index_js_1.CreateUploadPayloadUrlResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionId)}/snapshot-url`, {
+            method: "PUT",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    /** Presigned GET URL for a `chat.agent` session snapshot. */
+    getChatSnapshotUrl(sessionId, requestOptions) {
+        return (0, core_js_1.zodfetch)(index_js_1.CreateUploadPayloadUrlResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionId)}/snapshot-url`, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
     retrieveRun(runId, requestOptions) {
         return (0, core_js_1.zodfetch)(index_js_1.RetrieveRunResponse, `${this.baseUrl}/api/v3/runs/${runId}`, {
             method: "GET",
@@ -584,6 +599,152 @@ class ApiClient {
             headers: this.#getHeaders(false),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    // ========================================================================
+    // Sessions
+    // ========================================================================
+    createSession(body, requestOptions) {
+        return (0, core_js_1.zodfetch)(index_js_1.CreatedSessionResponseBody, `${this.baseUrl}/api/v1/sessions`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    retrieveSession(sessionIdOrExternalId, requestOptions) {
+        return (0, core_js_1.zodfetch)(index_js_1.RetrieveSessionResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}`, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    updateSession(sessionIdOrExternalId, body, requestOptions) {
+        return (0, core_js_1.zodfetch)(index_js_1.RetrieveSessionResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}`, {
+            method: "PATCH",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    closeSession(sessionIdOrExternalId, body, requestOptions) {
+        return (0, core_js_1.zodfetch)(index_js_1.RetrieveSessionResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/close`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body ?? {}),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    endAndContinueSession(sessionIdOrExternalId, body, requestOptions) {
+        return (0, core_js_1.zodfetch)(index_js_1.EndAndContinueSessionResponseBody, `${this.baseUrl}/api/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/end-and-continue`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    listSessions(options, requestOptions) {
+        const searchParams = createSearchQueryForListSessions(options);
+        return (0, core_js_1.zodfetchCursorPage)(index_js_1.ListedSessionItem, `${this.baseUrl}/api/v1/sessions`, {
+            query: searchParams,
+            limit: options?.limit,
+            after: options?.after,
+            before: options?.before,
+        }, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    // ========================================================================
+    // Session realtime channels
+    // ========================================================================
+    async initializeSessionStream(sessionIdOrExternalId, io, requestOptions) {
+        // The server returns S2 credentials in response headers alongside a tiny
+        // JSON body with the realtime version. Follow the same shape as
+        // `createStream` so downstream clients can feed them into
+        // `StreamsWriterV2`.
+        return (0, core_js_1.zodfetch)(index_js_1.CreateStreamResponseBody, `${this.baseUrl}/realtime/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/${io}`, {
+            method: "PUT",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions))
+            .withResponse()
+            .then(({ data, response }) => ({
+            ...data,
+            headers: Object.fromEntries(response.headers.entries()),
+        }));
+    }
+    async appendToSessionStream(sessionIdOrExternalId, io, part, requestOptions) {
+        return (0, core_js_1.zodfetch)(index_js_1.AppendToStreamResponseBody, `${this.baseUrl}/realtime/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/${io}/append`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: part,
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
+    /**
+     * 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.
+     */
+    async readSessionStreamRecords(sessionIdOrExternalId, io, options) {
+        const qs = new URLSearchParams();
+        if (options?.afterEventId !== undefined) {
+            qs.set("afterEventId", options.afterEventId);
+        }
+        const url = `${options?.baseUrl ?? this.baseUrl}/realtime/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/${io}/records${qs.toString() ? `?${qs.toString()}` : ""}`;
+        return (0, core_js_1.zodfetch)(index_js_1.ReadSessionStreamRecordsResponseBody, url, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, 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.
+     */
+    async subscribeToSessionStream(sessionIdOrExternalId, io, options) {
+        const url = `${options?.baseUrl ?? this.baseUrl}/realtime/v1/sessions/${encodeURIComponent(sessionIdOrExternalId)}/${io}`;
+        const subscription = new runStream_js_1.SSEStreamSubscription(url, {
+            headers: this.getHeaders(),
+            signal: options?.signal,
+            onComplete: options?.onComplete,
+            onError: options?.onError,
+            timeoutInSeconds: options?.timeoutInSeconds,
+            lastEventId: options?.lastEventId,
+        });
+        const stream = await subscription.subscribe();
+        const onPart = options?.onPart;
+        const onControl = options?.onControl;
+        return stream.pipeThrough(new TransformStream({
+            transform(part, controller) {
+                // Always surface the raw part via onPart so cursor tracking
+                // (lastSeqNum, lastEventId) stays correct for both data and
+                // control records.
+                onPart?.(part);
+                // Trigger control record — route to onControl, never enqueue.
+                const subtype = (0, wireProtocol_js_1.controlSubtype)(part.headers);
+                if (subtype) {
+                    // `part.id` is the S2 seq_num in decimal string form.
+                    // `parseInt` returns NaN if S2 ever surfaces a non-numeric
+                    // id (shouldn't happen, but `|| 0` would mask it as a real
+                    // seq 0). Drop the malformed event rather than fire
+                    // `onControl` with a misleading cursor — callers like
+                    // `findLatestSessionInCursor` and the dashboard rely on the
+                    // seqNum being meaningful for resume.
+                    const parsedSeqNum = Number.parseInt(part.id, 10);
+                    if (!Number.isFinite(parsedSeqNum)) {
+                        return;
+                    }
+                    onControl?.({
+                        subtype,
+                        headers: part.headers ?? [],
+                        seqNum: parsedSeqNum,
+                        timestamp: part.timestamp,
+                    });
+                    return;
+                }
+                controller.enqueue(part.chunk);
+            },
+        }));
+    }
     async waitForDuration(runId, body, requestOptions) {
         return (0, core_js_1.zodfetch)(index_js_1.WaitForDurationResponseBody, `${this.baseUrl}/engine/v1/runs/${runId}/wait/duration`, {
             method: "POST",
@@ -721,6 +882,12 @@ class ApiClient {
             headers: this.#getHeaders(false),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    retrieveCurrentDeployment(requestOptions) {
+        return (0, core_js_1.zodfetch)(index_js_1.RetrieveCurrentDeploymentResponseBody, `${this.baseUrl}/api/v1/deployments/current`, {
+            method: "GET",
+            headers: this.#getHeaders(false),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
     async fetchStream(runId, streamKey, options) {
         const streamFactory = new runStream_js_1.SSEStreamSubscriptionFactory(options?.baseUrl ?? this.baseUrl, {
             headers: this.getHeaders(),
@@ -776,6 +943,13 @@ class ApiClient {
             body: JSON.stringify(body),
         }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
     }
+    async createSessionStreamWaitpoint(runFriendlyId, body, requestOptions) {
+        return (0, core_js_1.zodfetch)(index_js_1.CreateSessionStreamWaitpointResponseBody, `${this.baseUrl}/api/v1/runs/${runFriendlyId}/session-streams/wait`, {
+            method: "POST",
+            headers: this.#getHeaders(false),
+            body: JSON.stringify(body),
+        }, mergeRequestOptions(this.defaultRequestOptions, requestOptions));
+    }
     async generateJWTClaims(requestOptions) {
         return (0, core_js_1.zodfetch)(zod_1.z.record(zod_1.z.any()), `${this.baseUrl}/api/v1/auth/jwt/claims`, {
             method: "POST",
@@ -968,6 +1142,9 @@ function createSearchQueryForListRuns(query) {
         if (query.machine) {
             searchParams.append("filter[machine]", Array.isArray(query.machine) ? query.machine.join(",") : query.machine);
         }
+        if (query.region) {
+            searchParams.append("filter[region]", Array.isArray(query.region) ? query.region.join(",") : query.region);
+        }
     }
     return searchParams;
 }
@@ -977,6 +1154,33 @@ function queueNameFromQueueTypeName(queue) {
     }
     return queue.name;
 }
+function createSearchQueryForListSessions(options) {
+    const searchParams = new URLSearchParams();
+    if (!options)
+        return searchParams;
+    const appendMany = (name, value) => {
+        if (value === undefined)
+            return;
+        searchParams.append(name, Array.isArray(value) ? value.join(",") : value);
+    };
+    appendMany("filter[type]", options.type);
+    appendMany("filter[tags]", options.tag);
+    appendMany("filter[taskIdentifier]", options.taskIdentifier);
+    if (options.externalId) {
+        searchParams.append("filter[externalId]", options.externalId);
+    }
+    appendMany("filter[status]", options.status);
+    if (options.period) {
+        searchParams.append("filter[createdAt][period]", options.period);
+    }
+    if (options.from !== undefined) {
+        searchParams.append("filter[createdAt][from]", options.from instanceof Date ? options.from.getTime().toString() : options.from.toString());
+    }
+    if (options.to !== undefined) {
+        searchParams.append("filter[createdAt][to]", options.to instanceof Date ? options.to.getTime().toString() : options.to.toString());
+    }
+    return searchParams;
+}
 function createSearchQueryForListWaitpointTokens(query) {
     const searchParams = new URLSearchParams();
     if (query) {