@trigger.dev/core 4.4.4 → 4.4.5

package/dist/commonjs/v3/schemas/api.d.ts

@@ -3998,6 +3998,7 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
             id: z.ZodString;
             friendlyId: z.ZodString;
             isTest: z.ZodBoolean;
+            isReplay: z.ZodDefault<z.ZodBoolean>;
             machine: z.ZodObject<{
                 name: z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>;
                 cpu: z.ZodNumber;
@@ -4036,6 +4037,7 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             id: string;
             isTest: boolean;
+            isReplay: boolean;
             machine: {
                 cpu: number;
                 memory: number;
@@ -4065,6 +4067,7 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
             friendlyId: string;
             attemptNumber: number;
             masterQueue: string;
+            isReplay?: boolean | undefined;
             annotations?: {
                 triggerSource: "schedule" | (string & {}) | "sdk" | "api" | "dashboard" | "cli" | "mcp";
                 triggerAction: "trigger" | (string & {}) | "replay" | "test";
@@ -4113,6 +4116,7 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
         run: {
             id: string;
             isTest: boolean;
+            isReplay: boolean;
             machine: {
                 cpu: number;
                 memory: number;
@@ -4211,6 +4215,7 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
             friendlyId: string;
             attemptNumber: number;
             masterQueue: string;
+            isReplay?: boolean | undefined;
             annotations?: {
                 triggerSource: "schedule" | (string & {}) | "sdk" | "api" | "dashboard" | "cli" | "mcp";
                 triggerAction: "trigger" | (string & {}) | "replay" | "test";
@@ -4291,6 +4296,7 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
         run: {
             id: string;
             isTest: boolean;
+            isReplay: boolean;
             machine: {
                 cpu: number;
                 memory: number;
@@ -4391,6 +4397,7 @@ export declare const DevDequeueResponseBody: z.ZodObject<{
             friendlyId: string;
             attemptNumber: number;
             masterQueue: string;
+            isReplay?: boolean | undefined;
             annotations?: {
                 triggerSource: "schedule" | (string & {}) | "sdk" | "api" | "dashboard" | "cli" | "mcp";
                 triggerAction: "trigger" | (string & {}) | "replay" | "test";
@@ -7058,6 +7065,54 @@ export declare const CreateInputStreamWaitpointResponseBody: z.ZodObject<{
     waitpointId: string;
 }>;
 export type CreateInputStreamWaitpointResponseBody = z.infer<typeof CreateInputStreamWaitpointResponseBody>;
+/**
+ * Create a run-scoped waitpoint that completes when the next record lands on
+ * a Session channel (`.in` or `.out`). Mirrors `CreateInputStreamWaitpointRequestBody`
+ * but keyed by `{sessionId, io}` instead of `{runId, streamId}`. The run is
+ * still the thing being suspended — Session only supplies the trigger source.
+ */
+export declare const CreateSessionStreamWaitpointRequestBody: z.ZodObject<{
+    /** Session friendlyId (`session_*`) or user-supplied externalId. */
+    session: z.ZodString;
+    io: z.ZodEnum<["out", "in"]>;
+    timeout: z.ZodOptional<z.ZodString>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+    idempotencyKeyTTL: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    /**
+     * Last S2 sequence number the client has seen on this session channel.
+     * Used to catch data that arrived before `.wait()` was called.
+     */
+    lastSeqNum: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    session: string;
+    io: "in" | "out";
+    tags?: string | string[] | undefined;
+    idempotencyKey?: string | undefined;
+    idempotencyKeyTTL?: string | undefined;
+    timeout?: string | undefined;
+    lastSeqNum?: number | undefined;
+}, {
+    session: string;
+    io: "in" | "out";
+    tags?: string | string[] | undefined;
+    idempotencyKey?: string | undefined;
+    idempotencyKeyTTL?: string | undefined;
+    timeout?: string | undefined;
+    lastSeqNum?: number | undefined;
+}>;
+export type CreateSessionStreamWaitpointRequestBody = z.infer<typeof CreateSessionStreamWaitpointRequestBody>;
+export declare const CreateSessionStreamWaitpointResponseBody: z.ZodObject<{
+    waitpointId: z.ZodString;
+    isCached: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    isCached: boolean;
+    waitpointId: string;
+}, {
+    isCached: boolean;
+    waitpointId: string;
+}>;
+export type CreateSessionStreamWaitpointResponseBody = z.infer<typeof CreateSessionStreamWaitpointResponseBody>;
 export declare const waitpointTokenStatuses: readonly ["WAITING", "COMPLETED", "TIMED_OUT"];
 export declare const WaitpointTokenStatus: z.ZodEnum<["WAITING", "COMPLETED", "TIMED_OUT"]>;
 export type WaitpointTokenStatus = z.infer<typeof WaitpointTokenStatus>;
@@ -7185,6 +7240,821 @@ export declare const CompleteWaitpointTokenRequestBody: z.ZodObject<{
     data?: any;
 }>;
 export type CompleteWaitpointTokenRequestBody = z.infer<typeof CompleteWaitpointTokenRequestBody>;
+/**
+ * Trigger config persisted on a Session. Drives every run the session
+ * schedules — `basePayload` is the customer's wire payload (for
+ * chat.agent: `{ chatId, ...clientData }`), runtime fields like
+ * `trigger: "preload" | "trigger"` are merged on top per-call by the
+ * server's trigger machinery.
+ */
+export declare const SessionTriggerConfig: z.ZodObject<{
+    basePayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
+    queue: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    maxAttempts: z.ZodOptional<z.ZodNumber>;
+    /** Convenience field surfaced to chat.agent via the wire payload. */
+    idleTimeoutInSeconds: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    basePayload: Record<string, unknown>;
+    tags?: string[] | undefined;
+    maxAttempts?: number | undefined;
+    queue?: string | undefined;
+    machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+    idleTimeoutInSeconds?: number | undefined;
+}, {
+    basePayload: Record<string, unknown>;
+    tags?: string[] | undefined;
+    maxAttempts?: number | undefined;
+    queue?: string | undefined;
+    machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+    idleTimeoutInSeconds?: number | undefined;
+}>;
+export type SessionTriggerConfig = z.infer<typeof SessionTriggerConfig>;
+/**
+ * Request body for `POST /api/v1/sessions`. Creates a Session and
+ * triggers its first run. Sessions are task-bound: `taskIdentifier` and
+ * `triggerConfig` are required, and re-runs scheduled by the server
+ * (after run termination, after `end-and-continue`) reuse the same
+ * config.
+ */
+export declare const CreateSessionRequestBody: z.ZodObject<{
+    /** Plain string discriminator — e.g. `"chat.agent"`. Not validated against an enum on the server. */
+    type: z.ZodString;
+    /** User-supplied idempotency key. Unique per environment. Empty strings are rejected. */
+    externalId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    /** Task this session triggers runs against. Required. */
+    taskIdentifier: z.ZodString;
+    /** Trigger config used for every run scheduled by this session. */
+    triggerConfig: z.ZodObject<{
+        basePayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
+        queue: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        /** Convenience field surfaced to chat.agent via the wire payload. */
+        idleTimeoutInSeconds: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    }, {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    }>;
+    /** Up to 10 tags for dashboard filtering. */
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Arbitrary JSON metadata. */
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /** Absolute expiry timestamp for retention. */
+    expiresAt: z.ZodOptional<z.ZodDate>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    taskIdentifier: string;
+    triggerConfig: {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    };
+    metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    externalId?: string | undefined;
+    expiresAt?: Date | undefined;
+}, {
+    type: string;
+    taskIdentifier: string;
+    triggerConfig: {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    };
+    metadata?: Record<string, unknown> | undefined;
+    tags?: string[] | undefined;
+    externalId?: string | undefined;
+    expiresAt?: Date | undefined;
+}>;
+export type CreateSessionRequestBody = z.infer<typeof CreateSessionRequestBody>;
+export declare const SessionItem: z.ZodObject<{
+    id: z.ZodString;
+    externalId: z.ZodNullable<z.ZodString>;
+    type: z.ZodString;
+    taskIdentifier: z.ZodString;
+    /**
+     * Optional on the wire because some surfaces (the list endpoint backed
+     * by ClickHouse, list-page rendering) don't carry triggerConfig.
+     * Always populated on `POST /sessions` and `GET /sessions/:id`.
+     */
+    triggerConfig: z.ZodOptional<z.ZodObject<{
+        basePayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
+        queue: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        /** Convenience field surfaced to chat.agent via the wire payload. */
+        idleTimeoutInSeconds: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    }, {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    }>>;
+    /**
+     * Friendly id of the live run for this session, if any. Optional on
+     * the wire — list surfaces may not include it. Routes that emit
+     * `SessionItem` are responsible for resolving the friendly form
+     * from the underlying cuid before returning.
+     */
+    currentRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tags: z.ZodArray<z.ZodString, "many">;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    closedAt: z.ZodNullable<z.ZodDate>;
+    closedReason: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodNullable<z.ZodDate>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    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;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    } | undefined;
+    currentRunId?: string | null | undefined;
+}, {
+    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;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    } | undefined;
+    currentRunId?: string | null | undefined;
+}>;
+export type SessionItem = z.infer<typeof SessionItem>;
+export declare const CreatedSessionResponseBody: z.ZodObject<{
+    id: z.ZodString;
+    externalId: z.ZodNullable<z.ZodString>;
+    type: z.ZodString;
+    taskIdentifier: z.ZodString;
+    /**
+     * Optional on the wire because some surfaces (the list endpoint backed
+     * by ClickHouse, list-page rendering) don't carry triggerConfig.
+     * Always populated on `POST /sessions` and `GET /sessions/:id`.
+     */
+    triggerConfig: z.ZodOptional<z.ZodObject<{
+        basePayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
+        queue: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        /** Convenience field surfaced to chat.agent via the wire payload. */
+        idleTimeoutInSeconds: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    }, {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    }>>;
+    /**
+     * Friendly id of the live run for this session, if any. Optional on
+     * the wire — list surfaces may not include it. Routes that emit
+     * `SessionItem` are responsible for resolving the friendly form
+     * from the underlying cuid before returning.
+     */
+    currentRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tags: z.ZodArray<z.ZodString, "many">;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    closedAt: z.ZodNullable<z.ZodDate>;
+    closedReason: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodNullable<z.ZodDate>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+} & {
+    /** Friendly id of the first run triggered alongside session create. */
+    runId: z.ZodString;
+    /** Session-scoped public access token: `read:sessions:{ext} + write:sessions:{ext}`. */
+    publicAccessToken: z.ZodString;
+    /** True if the session existed already (idempotent upsert), false if newly created. */
+    isCached: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    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;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    } | undefined;
+    currentRunId?: string | null | undefined;
+}, {
+    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;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    } | undefined;
+    currentRunId?: string | null | undefined;
+}>;
+export type CreatedSessionResponseBody = z.infer<typeof CreatedSessionResponseBody>;
+export declare const RetrieveSessionResponseBody: z.ZodObject<{
+    id: z.ZodString;
+    externalId: z.ZodNullable<z.ZodString>;
+    type: z.ZodString;
+    taskIdentifier: z.ZodString;
+    /**
+     * Optional on the wire because some surfaces (the list endpoint backed
+     * by ClickHouse, list-page rendering) don't carry triggerConfig.
+     * Always populated on `POST /sessions` and `GET /sessions/:id`.
+     */
+    triggerConfig: z.ZodOptional<z.ZodObject<{
+        basePayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
+        queue: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        /** Convenience field surfaced to chat.agent via the wire payload. */
+        idleTimeoutInSeconds: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    }, {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    }>>;
+    /**
+     * Friendly id of the live run for this session, if any. Optional on
+     * the wire — list surfaces may not include it. Routes that emit
+     * `SessionItem` are responsible for resolving the friendly form
+     * from the underlying cuid before returning.
+     */
+    currentRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tags: z.ZodArray<z.ZodString, "many">;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    closedAt: z.ZodNullable<z.ZodDate>;
+    closedReason: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodNullable<z.ZodDate>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    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;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    } | undefined;
+    currentRunId?: string | null | undefined;
+}, {
+    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;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    } | undefined;
+    currentRunId?: string | null | undefined;
+}>;
+export type RetrieveSessionResponseBody = z.infer<typeof RetrieveSessionResponseBody>;
+/**
+ * Body for `POST /api/v1/sessions/:session/end-and-continue`. Used by the
+ * running agent to request a clean handoff to a fresh run on the latest
+ * deployed version (typical use case: `chat.requestUpgrade`). The
+ * server triggers a new run, atomically swaps `currentRunId`, and the
+ * caller exits.
+ */
+export declare const EndAndContinueSessionRequestBody: z.ZodObject<{
+    /** The friendlyId of the run requesting the handoff. */
+    callingRunId: z.ZodString;
+    /** Free-form label for the SessionRun audit row. e.g. `"upgrade"`. */
+    reason: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    callingRunId: string;
+}, {
+    reason: string;
+    callingRunId: string;
+}>;
+export type EndAndContinueSessionRequestBody = z.infer<typeof EndAndContinueSessionRequestBody>;
+export declare const EndAndContinueSessionResponseBody: z.ZodObject<{
+    /** friendlyId of the run that has taken over the session. */
+    runId: z.ZodString;
+    /**
+     * False when the swap was preempted (a different run was already
+     * running by the time we tried to claim). The caller should treat
+     * this as "someone else moved on" — exit cleanly without expecting
+     * to drive the next run.
+     */
+    swapped: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    runId: string;
+    swapped: boolean;
+}, {
+    runId: string;
+    swapped: boolean;
+}>;
+export type EndAndContinueSessionResponseBody = z.infer<typeof EndAndContinueSessionResponseBody>;
+export declare const UpdateSessionRequestBody: z.ZodObject<{
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    externalId: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<null>, z.ZodEffects<z.ZodString, string, string>]>>;
+}, "strip", z.ZodTypeAny, {
+    metadata?: Record<string, unknown> | null | undefined;
+    tags?: string[] | undefined;
+    externalId?: string | null | undefined;
+}, {
+    metadata?: Record<string, unknown> | null | undefined;
+    tags?: string[] | undefined;
+    externalId?: string | null | undefined;
+}>;
+export type UpdateSessionRequestBody = z.infer<typeof UpdateSessionRequestBody>;
+export declare const CloseSessionRequestBody: z.ZodObject<{
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    reason?: string | undefined;
+}, {
+    reason?: string | undefined;
+}>;
+export type CloseSessionRequestBody = z.infer<typeof CloseSessionRequestBody>;
+export declare const SessionStatus: z.ZodEnum<["ACTIVE", "CLOSED", "EXPIRED"]>;
+export type SessionStatus = z.infer<typeof SessionStatus>;
+/**
+ * Server-side validation schema for `GET /api/v1/sessions`. Follows the same
+ * cursor-pagination convention as runs/waitpoints (`page[size]`,
+ * `page[after]`, `page[before]`) and uses the `filter[*]` prefix for
+ * narrowing fields — both produced automatically by `zodfetchCursorPage`
+ * and the matching client-side search-query helper.
+ */
+export declare const ListSessionsQueryParams: z.ZodEffects<z.ZodObject<{
+    "page[size]": z.ZodDefault<z.ZodNumber>;
+    "page[after]": z.ZodOptional<z.ZodString>;
+    "page[before]": z.ZodOptional<z.ZodString>;
+    "filter[type]": z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    "filter[tags]": z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    "filter[taskIdentifier]": z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    "filter[externalId]": z.ZodOptional<z.ZodString>;
+    "filter[status]": z.ZodOptional<z.ZodUnion<[z.ZodEnum<["ACTIVE", "CLOSED", "EXPIRED"]>, z.ZodArray<z.ZodEnum<["ACTIVE", "CLOSED", "EXPIRED"]>, "many">]>>;
+    "filter[createdAt][period]": z.ZodOptional<z.ZodString>;
+    "filter[createdAt][from]": z.ZodOptional<z.ZodNumber>;
+    "filter[createdAt][to]": z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    "page[size]": number;
+    "page[after]"?: string | undefined;
+    "page[before]"?: string | undefined;
+    "filter[type]"?: string | string[] | undefined;
+    "filter[tags]"?: string | string[] | undefined;
+    "filter[taskIdentifier]"?: string | string[] | undefined;
+    "filter[externalId]"?: string | undefined;
+    "filter[status]"?: "EXPIRED" | "ACTIVE" | "CLOSED" | ("EXPIRED" | "ACTIVE" | "CLOSED")[] | undefined;
+    "filter[createdAt][period]"?: string | undefined;
+    "filter[createdAt][from]"?: number | undefined;
+    "filter[createdAt][to]"?: number | undefined;
+}, {
+    "page[size]"?: number | undefined;
+    "page[after]"?: string | undefined;
+    "page[before]"?: string | undefined;
+    "filter[type]"?: string | string[] | undefined;
+    "filter[tags]"?: string | string[] | undefined;
+    "filter[taskIdentifier]"?: string | string[] | undefined;
+    "filter[externalId]"?: string | undefined;
+    "filter[status]"?: "EXPIRED" | "ACTIVE" | "CLOSED" | ("EXPIRED" | "ACTIVE" | "CLOSED")[] | undefined;
+    "filter[createdAt][period]"?: string | undefined;
+    "filter[createdAt][from]"?: number | undefined;
+    "filter[createdAt][to]"?: number | undefined;
+}>, {
+    "page[size]": number;
+    "page[after]"?: string | undefined;
+    "page[before]"?: string | undefined;
+    "filter[type]"?: string | string[] | undefined;
+    "filter[tags]"?: string | string[] | undefined;
+    "filter[taskIdentifier]"?: string | string[] | undefined;
+    "filter[externalId]"?: string | undefined;
+    "filter[status]"?: "EXPIRED" | "ACTIVE" | "CLOSED" | ("EXPIRED" | "ACTIVE" | "CLOSED")[] | undefined;
+    "filter[createdAt][period]"?: string | undefined;
+    "filter[createdAt][from]"?: number | undefined;
+    "filter[createdAt][to]"?: number | undefined;
+}, {
+    "page[size]"?: number | undefined;
+    "page[after]"?: string | undefined;
+    "page[before]"?: string | undefined;
+    "filter[type]"?: string | string[] | undefined;
+    "filter[tags]"?: string | string[] | undefined;
+    "filter[taskIdentifier]"?: string | string[] | undefined;
+    "filter[externalId]"?: string | undefined;
+    "filter[status]"?: "EXPIRED" | "ACTIVE" | "CLOSED" | ("EXPIRED" | "ACTIVE" | "CLOSED")[] | undefined;
+    "filter[createdAt][period]"?: string | undefined;
+    "filter[createdAt][from]"?: number | undefined;
+    "filter[createdAt][to]"?: number | undefined;
+}>;
+export type ListSessionsQueryParams = z.infer<typeof ListSessionsQueryParams>;
+/**
+ * Client-facing list options — flattened shape that
+ * {@link ApiClient.listSessions} converts into the `filter[*]` / `page[*]`
+ * query string before sending.
+ */
+export declare const ListSessionsOptions: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    after: z.ZodOptional<z.ZodString>;
+    before: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    tag: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    taskIdentifier: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    externalId: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["ACTIVE", "CLOSED", "EXPIRED"]>, z.ZodArray<z.ZodEnum<["ACTIVE", "CLOSED", "EXPIRED"]>, "many">]>>;
+    period: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    to: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+}, "strip", z.ZodTypeAny, {
+    type?: string | string[] | undefined;
+    status?: "EXPIRED" | "ACTIVE" | "CLOSED" | ("EXPIRED" | "ACTIVE" | "CLOSED")[] | undefined;
+    taskIdentifier?: string | string[] | undefined;
+    externalId?: string | undefined;
+    limit?: number | undefined;
+    after?: string | undefined;
+    before?: string | undefined;
+    tag?: string | string[] | undefined;
+    period?: string | undefined;
+    from?: number | Date | undefined;
+    to?: number | Date | undefined;
+}, {
+    type?: string | string[] | undefined;
+    status?: "EXPIRED" | "ACTIVE" | "CLOSED" | ("EXPIRED" | "ACTIVE" | "CLOSED")[] | undefined;
+    taskIdentifier?: string | string[] | undefined;
+    externalId?: string | undefined;
+    limit?: number | undefined;
+    after?: string | undefined;
+    before?: string | undefined;
+    tag?: string | string[] | undefined;
+    period?: string | undefined;
+    from?: number | Date | undefined;
+    to?: number | Date | undefined;
+}>;
+export type ListSessionsOptions = z.infer<typeof ListSessionsOptions>;
+export declare const ListedSessionItem: z.ZodObject<{
+    id: z.ZodString;
+    externalId: z.ZodNullable<z.ZodString>;
+    type: z.ZodString;
+    taskIdentifier: z.ZodString;
+    /**
+     * Optional on the wire because some surfaces (the list endpoint backed
+     * by ClickHouse, list-page rendering) don't carry triggerConfig.
+     * Always populated on `POST /sessions` and `GET /sessions/:id`.
+     */
+    triggerConfig: z.ZodOptional<z.ZodObject<{
+        basePayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
+        queue: z.ZodOptional<z.ZodString>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        maxAttempts: z.ZodOptional<z.ZodNumber>;
+        /** Convenience field surfaced to chat.agent via the wire payload. */
+        idleTimeoutInSeconds: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    }, {
+        basePayload: Record<string, unknown>;
+        tags?: string[] | undefined;
+        maxAttempts?: number | undefined;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    }>>;
+    /**
+     * Friendly id of the live run for this session, if any. Optional on
+     * the wire — list surfaces may not include it. Routes that emit
+     * `SessionItem` are responsible for resolving the friendly form
+     * from the underlying cuid before returning.
+     */
+    currentRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tags: z.ZodArray<z.ZodString, "many">;
+    metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    closedAt: z.ZodNullable<z.ZodDate>;
+    closedReason: z.ZodNullable<z.ZodString>;
+    expiresAt: z.ZodNullable<z.ZodDate>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, "strip", z.ZodTypeAny, {
+    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;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    } | undefined;
+    currentRunId?: string | null | undefined;
+}, {
+    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;
+        queue?: string | undefined;
+        machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+        idleTimeoutInSeconds?: number | undefined;
+    } | undefined;
+    currentRunId?: string | null | undefined;
+}>;
+export type ListedSessionItem = z.infer<typeof ListedSessionItem>;
+export declare const ListSessionsResponseBody: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        externalId: z.ZodNullable<z.ZodString>;
+        type: z.ZodString;
+        taskIdentifier: z.ZodString;
+        /**
+         * Optional on the wire because some surfaces (the list endpoint backed
+         * by ClickHouse, list-page rendering) don't carry triggerConfig.
+         * Always populated on `POST /sessions` and `GET /sessions/:id`.
+         */
+        triggerConfig: z.ZodOptional<z.ZodObject<{
+            basePayload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            machine: z.ZodOptional<z.ZodEnum<["micro", "small-1x", "small-2x", "medium-1x", "medium-2x", "large-1x", "large-2x"]>>;
+            queue: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            maxAttempts: z.ZodOptional<z.ZodNumber>;
+            /** Convenience field surfaced to chat.agent via the wire payload. */
+            idleTimeoutInSeconds: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            basePayload: Record<string, unknown>;
+            tags?: string[] | undefined;
+            maxAttempts?: number | undefined;
+            queue?: string | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        }, {
+            basePayload: Record<string, unknown>;
+            tags?: string[] | undefined;
+            maxAttempts?: number | undefined;
+            queue?: string | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        }>>;
+        /**
+         * Friendly id of the live run for this session, if any. Optional on
+         * the wire — list surfaces may not include it. Routes that emit
+         * `SessionItem` are responsible for resolving the friendly form
+         * from the underlying cuid before returning.
+         */
+        currentRunId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        tags: z.ZodArray<z.ZodString, "many">;
+        metadata: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        closedAt: z.ZodNullable<z.ZodDate>;
+        closedReason: z.ZodNullable<z.ZodString>;
+        expiresAt: z.ZodNullable<z.ZodDate>;
+        createdAt: z.ZodDate;
+        updatedAt: z.ZodDate;
+    }, "strip", z.ZodTypeAny, {
+        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;
+            queue?: string | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+    }, {
+        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;
+            queue?: string | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+    }>, "many">;
+    pagination: z.ZodObject<{
+        next: z.ZodOptional<z.ZodString>;
+        previous: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        next?: string | undefined;
+        previous?: string | undefined;
+    }, {
+        next?: string | undefined;
+        previous?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        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;
+            queue?: string | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+    }[];
+    pagination: {
+        next?: string | undefined;
+        previous?: string | undefined;
+    };
+}, {
+    data: {
+        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;
+            queue?: string | undefined;
+            machine?: "micro" | "small-1x" | "small-2x" | "medium-1x" | "medium-2x" | "large-1x" | "large-2x" | undefined;
+            idleTimeoutInSeconds?: number | undefined;
+        } | undefined;
+        currentRunId?: string | null | undefined;
+    }[];
+    pagination: {
+        next?: string | undefined;
+        previous?: string | undefined;
+    };
+}>;
+export type ListSessionsResponseBody = z.infer<typeof ListSessionsResponseBody>;
 export declare const CompleteWaitpointTokenResponseBody: z.ZodObject<{
     success: z.ZodLiteral<true>;
 }, "strip", z.ZodTypeAny, {
@@ -7276,17 +8146,17 @@ export declare const ApiDeploymentListOptions: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     status?: "CANCELED" | "FAILED" | "TIMED_OUT" | "PENDING" | "BUILDING" | "DEPLOYING" | "DEPLOYED" | undefined;
     limit?: number | undefined;
-    cursor?: string | undefined;
+    period?: string | undefined;
     from?: string | undefined;
     to?: string | undefined;
-    period?: string | undefined;
+    cursor?: string | undefined;
 }, {
     status?: "CANCELED" | "FAILED" | "TIMED_OUT" | "PENDING" | "BUILDING" | "DEPLOYING" | "DEPLOYED" | undefined;
     limit?: number | undefined;
-    cursor?: string | undefined;
+    period?: string | undefined;
     from?: string | undefined;
     to?: string | undefined;
-    period?: string | undefined;
+    cursor?: string | undefined;
 }>;
 export type ApiDeploymentListOptions = z.infer<typeof ApiDeploymentListOptions>;
 export declare const ApiDeploymentListSearchParams: z.ZodObject<{
@@ -7298,18 +8168,18 @@ export declare const ApiDeploymentListSearchParams: z.ZodObject<{
     status: z.ZodOptional<z.ZodEnum<["PENDING", "BUILDING", "DEPLOYING", "DEPLOYED", "FAILED", "CANCELED", "TIMED_OUT"]>>;
 }, "strip", z.ZodTypeAny, {
     status?: "CANCELED" | "FAILED" | "TIMED_OUT" | "PENDING" | "BUILDING" | "DEPLOYING" | "DEPLOYED" | undefined;
+    "page[size]"?: number | undefined;
+    "page[after]"?: string | undefined;
+    period?: string | undefined;
     from?: string | undefined;
     to?: string | undefined;
-    period?: string | undefined;
-    "page[after]"?: string | undefined;
-    "page[size]"?: number | undefined;
 }, {
     status?: "CANCELED" | "FAILED" | "TIMED_OUT" | "PENDING" | "BUILDING" | "DEPLOYING" | "DEPLOYED" | undefined;
+    "page[size]"?: number | undefined;
+    "page[after]"?: string | undefined;
+    period?: string | undefined;
     from?: string | undefined;
     to?: string | undefined;
-    period?: string | undefined;
-    "page[after]"?: string | undefined;
-    "page[size]"?: number | undefined;
 }>;
 export type ApiDeploymentListSearchParams = z.infer<typeof ApiDeploymentListSearchParams>;
 export declare const ApiDeploymentListResponseItem: z.ZodObject<{