@trigger.dev/core 0.0.0-python-preview-20250226140121 → 0.0.0-rc-4-8-0-20261021151928

package/dist/esm/v3/schemas/api.js

@@ -1,19 +1,39 @@
-import { z } from "zod";
+import { z } from "zod/v4";
+import { discriminatedUnion } from "../utils/zod.js";
 import { DeserializedJsonSchema } from "../../schemas/json.js";
-import { FlushedRunMetadata, MachinePresetName, SerializedError, TaskRunError, } from "./common.js";
+import { EXTERNAL_DEPLOYMENT_ID_MAX_LENGTH } from "../externalDeploymentId.js";
+import { FlushedRunMetadata, GitMeta, MachinePresetName, SerializedError, TaskRunError, } from "./common.js";
 import { BackgroundWorkerMetadata } from "./resources.js";
-import { QueueOptions } from "./schemas.js";
+import { DequeuedMessage, MachineResources } from "./runEngine.js";
+import { QueueTypeName } from "./queues.js";
+import { ScheduleWindow } from "./schemas.js";
+import { BuildRuntime } from "./build.js";
+export const RunEngineVersion = z.union([z.literal("V1"), z.literal("V2")]);
 export const WhoAmIResponseSchema = z.object({
     userId: z.string(),
     email: z.string().email(),
     dashboardUrl: z.string(),
+    project: z
+        .object({
+        name: z.string(),
+        url: z.string(),
+        orgTitle: z.string(),
+    })
+        .optional(),
 });
 export const GetProjectResponseBody = z.object({
     id: z.string(),
-    externalRef: z.string(),
+    externalRef: z
+        .string()
+        .describe("The external reference for the project, also known as the project ref, a unique identifier starting with proj_"),
     name: z.string(),
     slug: z.string(),
     createdAt: z.coerce.date(),
+    // Worker-group name of the project's default region, or null when unset
+    // (the project falls back to the global platform default). Optional so a
+    // newer client still parses responses from an older server that omits it.
+    defaultRegion: z.string().nullable().optional(),
+    defaultRuntime: BuildRuntime.nullable().optional(),
     organization: z.object({
         id: z.string(),
         title: z.string(),
@@ -22,54 +42,312 @@ export const GetProjectResponseBody = z.object({
     }),
 });
 export const GetProjectsResponseBody = z.array(GetProjectResponseBody);
+/** The Node.js major version currently targeted by the runtime update report. */
+export const NODE_RUNTIME_UPDATE_MAJOR = 21;
+/**
+ * Returns the observed Node.js major version for a deployment.
+ *
+ * `runtime: "node"` is an alias whose underlying Node.js version has changed over time, so the
+ * recorded runtimeVersion is deliberately the source of truth here.
+ */
+export function nodeMajor(runtime, runtimeVersion) {
+    if (!runtime?.startsWith("node"))
+        return undefined;
+    const match = runtimeVersion?.match(/^(\d+)(?:\.\d+){1,2}(?:[-+].*)?$/);
+    return match ? Number(match[1]) : undefined;
+}
+export function needsNodeRuntimeUpdate(runtime, runtimeVersion) {
+    if (runtime && !runtime.startsWith("node"))
+        return false;
+    const versionMatch = runtimeVersion?.match(/^(\d+)(?:\.\d+){1,2}(?:[-+].*)?$/);
+    if (versionMatch)
+        return Number(versionMatch[1]) === NODE_RUNTIME_UPDATE_MAJOR;
+    if (runtimeVersion)
+        return false;
+    if (!runtime || runtime === "node")
+        return true;
+    const configuredMajorMatch = runtime.match(/^node-(\d+)$/);
+    return configuredMajorMatch
+        ? Number(configuredMajorMatch[1]) === NODE_RUNTIME_UPDATE_MAJOR
+        : false;
+}
+export const GetProjectRuntimesResponseBody = z.array(z.object({
+    organization: z.object({
+        title: z.string(),
+        slug: z.string(),
+    }),
+    project: z.object({
+        name: z.string(),
+        slug: z.string(),
+        externalRef: z.string(),
+    }),
+    environment: z.object({
+        slug: z.string(),
+    }),
+    deployment: z
+        .object({
+        runtime: z.string().nullable(),
+        runtimeVersion: z.string().nullable(),
+        nodeMajor: z.number().int().positive().nullable(),
+        deployedAt: z.coerce.date().nullable(),
+        shortCode: z.string(),
+    })
+        .nullable(),
+}));
+export const GetOrgsResponseBody = z.array(z.object({
+    id: z.string(),
+    title: z.string(),
+    slug: z.string(),
+    createdAt: z.coerce.date(),
+}));
+export const CreateOrgRequestBody = z.object({
+    title: z.string().trim().min(3).max(50),
+    companySize: z.string().optional(),
+    companyUrl: z.string().optional(),
+});
+export const CreateOrgResponseBody = z.object({
+    id: z.string(),
+    title: z.string(),
+    slug: z.string(),
+    createdAt: z.coerce.date(),
+});
+export const ActivateFreePlanResponseBody = z.object({
+    plan: z.literal("free"),
+});
+export const CompleteProfileRequestBody = z.object({
+    name: z.string().trim().min(3).max(50),
+});
+export const CompleteProfileResponseBody = z.object({
+    updated: z.boolean(),
+});
+export const CreateProjectRequestBody = z.object({
+    name: z
+        .string()
+        .trim()
+        .min(1, "Name is required")
+        .max(255, "Name must be less than 255 characters"),
+});
 export const GetProjectEnvResponse = z.object({
     apiKey: z.string(),
     name: z.string(),
     apiUrl: z.string(),
     projectId: z.string(),
+    defaultRuntime: BuildRuntime.nullable().optional(),
+});
+export const ProjectEnvironment = z.object({
+    id: z.string(),
+    /// The slug used as the environment identifier in env var endpoints (e.g. "dev", "stg", "prod", "preview")
+    slug: z.string(),
+    type: z.enum(["DEVELOPMENT", "STAGING", "PREVIEW", "PRODUCTION"]),
+    /// Whether this is the branchable parent (preview); individual branches are not returned
+    isBranchableEnvironment: z.boolean(),
+    branchName: z.string().nullable(),
+    paused: z.boolean(),
+});
+export const GetProjectEnvironmentsResponseBody = z.array(ProjectEnvironment);
+// Zod schema for the response body type
+export const GetWorkerTaskResponse = z.object({
+    id: z.string(),
+    slug: z.string(),
+    filePath: z.string(),
+    triggerSource: z.string(),
+    createdAt: z.coerce.date(),
+    payloadSchema: z.any().nullish(),
+    queueConfig: z.any().nullish(),
+});
+export const GetWorkerByTagResponse = z.object({
+    worker: z.object({
+        id: z.string(),
+        version: z.string(),
+        engine: z.string().nullish(),
+        sdkVersion: z.string().nullish(),
+        cliVersion: z.string().nullish(),
+        tasks: z.array(GetWorkerTaskResponse),
+    }),
+    urls: z.object({
+        runs: z.string(),
+    }),
+});
+export const GetJWTRequestBody = z.object({
+    claims: z
+        .object({
+        scopes: z.array(z.string()).default([]),
+    })
+        .optional(),
+    expirationTime: z.union([z.number(), z.string()]).optional(),
+});
+export const GetJWTResponse = z.object({
+    token: z.string(),
+    // The environment the exchange resolved, so a caller that named a slug learns the id.
+    environmentId: z.string().optional(),
 });
 export const CreateBackgroundWorkerRequestBody = z.object({
     localOnly: z.boolean(),
     metadata: BackgroundWorkerMetadata,
+    engine: RunEngineVersion.optional(),
     supportsLazyAttempts: z.boolean().optional(),
+    buildPlatform: z.string().optional(),
+    targetPlatform: z.string().optional(),
+});
+export const BackgroundWorkerWarning = z.object({
+    code: z.enum(["schedule_default_window", "schedule_minimum_window"]),
+    message: z.string(),
 });
 export const CreateBackgroundWorkerResponse = z.object({
     id: z.string(),
     version: z.string(),
     contentHash: z.string(),
+    warnings: z.array(BackgroundWorkerWarning).optional(),
 });
 //an array of 1, 2, or 3 strings
 const RunTag = z.string().max(128, "Tags must be less than 128 characters");
 export const RunTags = z.union([RunTag, RunTag.array()]);
-export const TriggerTaskRequestBody = z.object({
-    payload: z.any(),
-    context: z.any(),
+/** Stores the original user-provided idempotency key and scope */
+export const IdempotencyKeyOptionsSchema = z.object({
+    key: z.string(),
+    scope: z.enum(["run", "attempt", "global"]),
+});
+// Coerces user-supplied concurrencyKey values to string. The downstream Prisma
+// column is String?, so passing a number (a common foot-gun when callers do
+// `concurrencyKey: payload.userId`) used to fail at `prisma.taskRun.create`
+// with PrismaClientValidationError. Accept the intent and stringify here.
+const ConcurrencyKeySchema = z.union([z.string(), z.number()]).transform((value) => String(value));
+/**
+ * Trigger-time named concurrency limits. The charset rule matches what the queue
+ * concern enforces, so a bad name is a uniform up-front 400 on every path instead
+ * of a late validation error after the request (or earlier batch items) succeeded.
+ */
+const TriggerConcurrencyLimitsSchema = z
+    .string()
+    .regex(/^[a-zA-Z0-9_-]{1,122}$/, {
+    message: "Concurrency limit names are 1-122 characters using only letters, numbers, underscores and hyphens",
+})
+    .array()
+    .max(2);
+const ExternalDeploymentId = z.preprocess((value) => {
+    // `null` is the opt-out sentinel callers write; treat it as absent, not a validation error.
+    if (value === null) {
+        return undefined;
+    }
+    if (typeof value !== "string") {
+        return value;
+    }
+    const trimmed = value.trim();
+    return trimmed === "" ? undefined : trimmed;
+}, z
+    .string()
+    .max(EXTERNAL_DEPLOYMENT_ID_MAX_LENGTH, `externalId must be at most ${EXTERNAL_DEPLOYMENT_ID_MAX_LENGTH} characters`)
+    .optional());
+export const TriggerTaskRequestBody = z
+    .object({
+    payload: z.any().optional(),
+    context: z.any().optional(),
     options: z
         .object({
-        concurrencyKey: z.string().optional(),
-        delay: z.string().or(z.coerce.date()).optional(),
+        /** @deprecated engine v1 only */
         dependentAttempt: z.string().optional(),
+        /** @deprecated engine v1 only */
+        parentAttempt: z.string().optional(),
+        /** @deprecated engine v1 only */
         dependentBatch: z.string().optional(),
-        idempotencyKey: z.string().optional(),
-        idempotencyKeyTTL: z.string().optional(),
+        /**
+         * If triggered in a batch, this is the BatchTaskRun id
+         */
+        parentBatch: z.string().optional(),
+        /**
+         * RunEngine v2
+         * If triggered inside another run, the parentRunId is the friendly ID of the parent run.
+         */
+        parentRunId: z.string().optional(),
+        /**
+         * RunEngine v2
+         * Should be `true` if `triggerAndWait` or `batchTriggerAndWait`
+         */
+        resumeParentOnCompletion: z.boolean().optional(),
+        /**
+         * Locks the version to the passed value.
+         * Automatically set when using `triggerAndWait` or `batchTriggerAndWait`
+         */
         lockToVersion: z.string().optional(),
+        /**
+         * The external deployment id the calling application belongs to — a commit SHA, a
+         * CI run id, a release tag. Independent of `lockToVersion`: the SDK reports every
+         * pinning signal it can see and the server decides which one governs, so a trigger
+         * carrying both sends both. Resolution is environment-scoped, and an id naming a
+         * deployment that has not landed yet parks the run rather than failing it.
+         */
+        externalDeploymentId: ExternalDeploymentId,
+        queue: z
+            .object({
+            name: z.string(),
+            // @deprecated, this is now specified on the queue
+            concurrencyLimit: z.number().int().optional(),
+        })
+            .optional(),
+        gates: z
+            .array(z.object({
+            queue: z.string().min(1).max(128),
+            concurrencyKey: z.string().min(1).max(128).optional(),
+        }))
+            .max(3)
+            .optional(),
+        concurrency: TriggerConcurrencyLimitsSchema.optional(),
+        concurrencyKey: ConcurrencyKeySchema.optional(),
+        delay: z.string().or(z.coerce.date()).optional(),
+        idempotencyKey: z
+            .string()
+            // Caps user-supplied keys before they reach the unique idempotency index
+            // on the underlying table — values past this fail at the database layer
+            // rather than returning a clean 400.
+            .max(2048, "idempotencyKey must be 2048 characters or less")
+            .optional(),
+        idempotencyKeyTTL: z.string().optional(),
+        /** The original user-provided idempotency key and scope */
+        idempotencyKeyOptions: IdempotencyKeyOptionsSchema.optional(),
         machine: MachinePresetName.optional(),
         maxAttempts: z.number().int().optional(),
         maxDuration: z.number().optional(),
-        metadata: z.any(),
+        metadata: z.any().optional(),
         metadataType: z.string().optional(),
-        parentAttempt: z.string().optional(),
-        parentBatch: z.string().optional(),
         payloadType: z.string().optional(),
-        queue: QueueOptions.optional(),
+        /**
+         * Byte size of the (pre-offload) serialized payload, measured by the caller
+         * before any object-store offload. Lets the pipeline know how large a payload
+         * is without downloading an "application/store" reference.
+         */
+        payloadSize: z.number().int().nonnegative().optional(),
         tags: RunTags.optional(),
         test: z.boolean().optional(),
         ttl: z.string().or(z.number().nonnegative().int()).optional(),
+        priority: z.number().optional(),
+        bulkActionId: z.string().optional(),
+        region: z.string().optional(),
+        debounce: z
+            .object({
+            key: z.string().max(512),
+            delay: z.string(),
+            mode: z.enum(["leading", "trailing"]).optional(),
+            maxDelay: z.string().optional(),
+        })
+            .optional(),
     })
         .optional(),
+})
+    .superRefine((value, ctx) => {
+    if (value.options?.payloadType !== "application/store") {
+        return;
+    }
+    if (typeof value.payload !== "string" || value.payload.length === 0) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "payload must be a non-empty string when options.payloadType is application/store",
+            path: ["payload"],
+        });
+    }
 });
 export const TriggerTaskResponse = z.object({
     id: z.string(),
+    isCached: z.boolean().optional(),
 });
 export const BatchTriggerTaskRequestBody = z.object({
     items: TriggerTaskRequestBody.array(),
@@ -77,32 +355,77 @@ export const BatchTriggerTaskRequestBody = z.object({
 });
 export const BatchTriggerTaskItem = z.object({
     task: z.string(),
-    payload: z.any(),
-    context: z.any(),
+    payload: z.any().optional(),
+    context: z.any().optional(),
     options: z
         .object({
-        concurrencyKey: z.string().optional(),
+        concurrencyKey: ConcurrencyKeySchema.optional(),
         delay: z.string().or(z.coerce.date()).optional(),
-        idempotencyKey: z.string().optional(),
+        idempotencyKey: z
+            .string()
+            // Caps user-supplied keys before they reach the unique idempotency index
+            // on the underlying table — values past this fail at the database layer
+            // rather than returning a clean 400.
+            .max(2048, "idempotencyKey must be 2048 characters or less")
+            .optional(),
         idempotencyKeyTTL: z.string().optional(),
+        /** The original user-provided idempotency key and scope */
+        idempotencyKeyOptions: IdempotencyKeyOptionsSchema.optional(),
         lockToVersion: z.string().optional(),
+        /** See `TriggerTaskRequestBody.options.externalDeploymentId`. */
+        externalDeploymentId: ExternalDeploymentId,
         machine: MachinePresetName.optional(),
         maxAttempts: z.number().int().optional(),
         maxDuration: z.number().optional(),
-        metadata: z.any(),
+        metadata: z.any().optional(),
         metadataType: z.string().optional(),
         parentAttempt: z.string().optional(),
         payloadType: z.string().optional(),
-        queue: QueueOptions.optional(),
+        /** Byte size of the (pre-offload) serialized payload for this item. */
+        payloadSize: z.number().int().nonnegative().optional(),
+        queue: z
+            .object({
+            name: z.string(),
+        })
+            .optional(),
+        gates: z
+            .array(z.object({
+            queue: z.string().min(1).max(128),
+            concurrencyKey: z.string().min(1).max(128).optional(),
+        }))
+            .max(3)
+            .optional(),
+        concurrency: TriggerConcurrencyLimitsSchema.optional(),
         tags: RunTags.optional(),
         test: z.boolean().optional(),
         ttl: z.string().or(z.number().nonnegative().int()).optional(),
+        priority: z.number().optional(),
+        region: z.string().optional(),
+        debounce: z
+            .object({
+            key: z.string().max(512),
+            delay: z.string(),
+            mode: z.enum(["leading", "trailing"]).optional(),
+            maxDelay: z.string().optional(),
+        })
+            .optional(),
     })
         .optional(),
 });
 export const BatchTriggerTaskV2RequestBody = z.object({
     items: BatchTriggerTaskItem.array(),
+    /** @deprecated engine v1 only */
     dependentAttempt: z.string().optional(),
+    /**
+     * RunEngine v2
+     * If triggered inside another run, the parentRunId is the friendly ID of the parent run.
+     */
+    parentRunId: z.string().optional(),
+    /**
+     * RunEngine v2
+     * Should be `true` if `triggerAndWait` or `batchTriggerAndWait`
+     */
+    resumeParentOnCompletion: z.boolean().optional(),
 });
 export const BatchTriggerTaskV2Response = z.object({
     id: z.string(),
@@ -115,6 +438,102 @@ export const BatchTriggerTaskV2Response = z.object({
         idempotencyKey: z.string().optional(),
     })),
 });
+export const BatchTriggerTaskV3RequestBody = z.object({
+    items: BatchTriggerTaskItem.array(),
+    /**
+     * RunEngine v2
+     * If triggered inside another run, the parentRunId is the friendly ID of the parent run.
+     */
+    parentRunId: z.string().optional(),
+    /**
+     * RunEngine v2
+     * Should be `true` if `triggerAndWait` or `batchTriggerAndWait`
+     */
+    resumeParentOnCompletion: z.boolean().optional(),
+});
+export const BatchTriggerTaskV3Response = z.object({
+    id: z.string(),
+    runCount: z.number(),
+});
+// ============================================================================
+// 2-Phase Batch API (v3) - Streaming NDJSON Support
+// ============================================================================
+/**
+ * Phase 1: Create batch request body
+ * Creates the batch record and optionally blocks parent run for batchTriggerAndWait
+ */
+export const CreateBatchRequestBody = z.object({
+    /** Expected number of items in the batch */
+    runCount: z.number().int().positive(),
+    /** Distinct task identifiers expected in the item stream */
+    taskIdentifiers: z.array(z.string().min(1)).min(1).optional(),
+    /** Parent run ID for batchTriggerAndWait (friendly ID) */
+    parentRunId: z.string().optional(),
+    /** Whether to resume parent on completion (true for batchTriggerAndWait) */
+    resumeParentOnCompletion: z.boolean().optional(),
+    /** Idempotency key for the batch */
+    idempotencyKey: z
+        .string()
+        // Caps user-supplied keys before they reach the unique idempotency index
+        // on the underlying table — values past this fail at the database layer
+        // rather than returning a clean 400.
+        .max(2048, "idempotencyKey must be 2048 characters or less")
+        .optional(),
+    /** The original user-provided idempotency key and scope */
+    idempotencyKeyOptions: IdempotencyKeyOptionsSchema.optional(),
+});
+/**
+ * Phase 1: Create batch response
+ */
+export const CreateBatchResponse = z.object({
+    /** The batch ID (friendly ID) */
+    id: z.string(),
+    /** The expected run count */
+    runCount: z.number(),
+    /** Whether this response came from a cached/idempotent batch */
+    isCached: z.boolean(),
+    /** The idempotency key if provided */
+    idempotencyKey: z.string().optional(),
+});
+/**
+ * Phase 2: Individual item in the NDJSON stream
+ * Each line in the NDJSON body should match this schema.
+ *
+ * `options` reuses the strict shape from BatchTriggerTaskItem so that the
+ * Phase-2 streaming path validates option fields identically to the V2/V3
+ * batch trigger endpoints — historically this used z.record(z.string(), z.unknown()) and
+ * let invalid values (e.g. numeric concurrencyKey) reach Prisma.
+ */
+export const BatchItemNDJSON = z.object({
+    /** Zero-based index of this item (used for idempotency and ordering) */
+    index: z.number().int().nonnegative(),
+    /** The task identifier to trigger */
+    task: z.string(),
+    /** The payload for this task run */
+    payload: z.unknown().optional(),
+    /** Options for this specific item */
+    options: BatchTriggerTaskItem.shape.options,
+});
+/**
+ * Phase 2: Stream items response
+ * Returned after the NDJSON stream completes
+ */
+export const StreamBatchItemsResponse = z.object({
+    /** The batch ID */
+    id: z.string(),
+    /** Number of items successfully accepted */
+    itemsAccepted: z.number(),
+    /** Number of items that were deduplicated (already enqueued) */
+    itemsDeduplicated: z.number(),
+    /** Whether the batch was sealed and is ready for processing.
+     * If false, the batch needs more items before processing can start.
+     * Clients should check this field and retry with missing items if needed. */
+    sealed: z.boolean(),
+    /** Total items currently enqueued (only present when sealed=false to help with retries) */
+    enqueuedCount: z.number().optional(),
+    /** Expected total item count (only present when sealed=false to help with retries) */
+    expectedCount: z.number().optional(),
+});
 export const BatchTriggerTaskResponse = z.object({
     batchId: z.string(),
     runs: z.string().array(),
@@ -134,7 +553,8 @@ export const RescheduleRunRequestBody = z.object({
     delay: z.string().or(z.coerce.date()),
 });
 export const GetEnvironmentVariablesResponseBody = z.object({
-    variables: z.record(z.string()),
+    allowEmptyEnvironmentVariableValues: z.boolean().optional(),
+    variables: z.record(z.string(), z.string()),
 });
 export const StartDeploymentIndexingRequestBody = z.object({
     imageReference: z.string(),
@@ -145,30 +565,166 @@ export const StartDeploymentIndexingResponseBody = z.object({
     contentHash: z.string(),
 });
 export const FinalizeDeploymentRequestBody = z.object({
-    imageReference: z.string(),
-    selfHosted: z.boolean().optional(),
-    skipRegistryProxy: z.boolean().optional(),
+    skipPromotion: z.boolean().optional(),
+    imageDigest: z.string().optional(),
+    skipPushToRegistry: z.boolean().optional(),
+});
+export const BuildServerMetadata = z.object({
+    buildId: z.string().optional(),
+    isNativeBuild: z.boolean().optional(),
+    artifactKey: z.string().optional(),
+    skipPromotion: z.boolean().optional(),
+    configFilePath: z.string().optional(),
+    skipEnqueue: z.boolean().optional(),
+    fromBundle: z.boolean().optional(),
+    // Short code of the deployment this one was redeployed from.
+    redeployOf: z.string().optional(),
+});
+export const GetDeploymentArtifactUrlResponseBody = z.object({
+    url: z.string().url(),
+    expiresAt: z.string().datetime(),
+});
+export const ProgressDeploymentRequestBody = z.object({
+    contentHash: z.string().optional(),
+    gitMeta: GitMeta.optional(),
+    runtime: z.string().optional(),
+    buildServerMetadata: BuildServerMetadata.optional(),
+});
+export const CancelDeploymentRequestBody = z.object({
+    reason: z.string().max(200, "Reason must be less than 200 characters").optional(),
 });
 export const ExternalBuildData = z.object({
     buildId: z.string(),
     buildToken: z.string(),
     projectId: z.string(),
 });
+const anyString = z.custom((v) => typeof v === "string");
+export const DeploymentTriggeredVia = z
+    .enum([
+    "cli:manual",
+    "cli:ci_other",
+    "cli:github_actions",
+    "cli:gitlab_ci",
+    "cli:circleci",
+    "cli:jenkins",
+    "cli:azure_pipelines",
+    "cli:bitbucket_pipelines",
+    "cli:travis_ci",
+    "cli:buildkite",
+    "git_integration:github",
+    "dashboard",
+])
+    .or(anyString);
+// TriggerSource, TriggerAction, and RunAnnotations are defined in runEngine.ts
+// They are re-exported through the schemas barrel (index.ts)
+export const UpsertBranchRequestBody = z.object({
+    git: GitMeta.optional(),
+    env: z.enum(["preview", "development"]),
+    branch: z.string(),
+});
+export const UpsertBranchResponseBody = z.object({
+    id: z.string(),
+    autoArchivedBranches: z
+        .array(z.object({
+        id: z.string(),
+        branchName: z.string(),
+    }))
+        .optional(),
+});
+export const CreateArtifactRequestBody = z.object({
+    type: z.enum(["deployment_context", "deployment_bundle"]).default("deployment_context"),
+    contentType: z.string().default("application/gzip"),
+    contentLength: z.number().optional(),
+});
+export const CreateArtifactResponseBody = z.object({
+    artifactKey: z.string(),
+    uploadUrl: z.string(),
+    uploadFields: z.record(z.string(), z.string()),
+    expiresAt: z.string().datetime(),
+});
+export const DeployBaseImageRef = z.string().regex(/^[^\s@]+@sha256:[a-f0-9]{64}$/);
+export const DeployBaseImages = z.object({
+    base: DeployBaseImageRef.optional(),
+    buildBase: DeployBaseImageRef.optional(),
+});
 export const InitializeDeploymentResponseBody = z.object({
     id: z.string(),
     contentHash: z.string(),
     shortCode: z.string(),
     version: z.string(),
     imageTag: z.string(),
+    imagePlatform: z.string(),
+    externalId: z.string().optional(),
+    outcome: z.enum(["created", "existing"]).optional(),
+    isPromoted: z.boolean().optional(),
     externalBuildData: ExternalBuildData.optional().nullable(),
-    registryHost: z.string().optional(),
+    baseImages: DeployBaseImages.optional(),
+    canceledDeployments: z.array(z.object({ version: z.string(), shortCode: z.string() })).optional(),
+    eventStream: z
+        .object({
+        s2: z.object({
+            basin: z.string(),
+            stream: z.string(),
+            accessToken: z.string(),
+        }),
+    })
+        .optional(),
 });
-export const InitializeDeploymentRequestBody = z.object({
+const InitializeDeploymentRequestBodyBase = z.object({
     contentHash: z.string(),
     userId: z.string().optional(),
-    registryHost: z.string().optional(),
+    /** @deprecated This is now determined by the webapp. This is only used to warn users with old CLI versions. */
     selfHosted: z.boolean().optional(),
-    namespace: z.string().optional(),
+    gitMeta: GitMeta.optional(),
+    type: z.enum(["MANAGED", "UNMANAGED", "V1"]).optional(),
+    runtime: z.string().optional(),
+    initialStatus: z.enum(["PENDING", "BUILDING"]).optional(),
+    isLocalBuild: z.boolean().optional(),
+    triggeredVia: DeploymentTriggeredVia.optional(),
+    buildId: z.string().optional(),
+    externalId: ExternalDeploymentId,
+    force: z.boolean().optional(),
+    supportsInstanceBaseImages: z.boolean().optional(),
+});
+const InitializeDeploymentRequestBodyFull = InitializeDeploymentRequestBodyBase.extend({
+    isNativeBuild: z.boolean().default(false),
+    skipPromotion: z.boolean().optional(),
+    artifactKey: z.string().optional(),
+    configFilePath: z.string().optional(),
+    skipEnqueue: z.boolean().optional().default(false),
+    // The artifact is a pre-built bundle; the build server only runs the container build
+    fromBundle: z.boolean().optional(),
+    // Build-time env var values for fromBundle deploys, stored encrypted on the deployment
+    buildEnvVars: z.record(z.string(), z.string()).optional(),
+}).superRefine((data, ctx) => {
+    if (data.force && !data.externalId) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            path: ["force"],
+            message: "force requires externalId",
+        });
+    }
+});
+export const InitializeDeploymentRequestBody = InitializeDeploymentRequestBodyFull.transform((data) => {
+    if (data.isNativeBuild) {
+        return { ...data, isNativeBuild: true };
+    }
+    const { skipPromotion, artifactKey, configFilePath, skipEnqueue, fromBundle, buildEnvVars, ...rest } = data;
+    return { ...rest, isNativeBuild: false };
+});
+export const DeployBuildPath = z.enum(["depot", "native", "native_local_bundle"]);
+export const GetDeploySettingsResponseBody = z.object({
+    build_path: DeployBuildPath,
+});
+export const RemoteBuildProviderStatusResponseBody = z.object({
+    status: z.enum(["operational", "degraded", "unknown"]),
+    message: z.string(),
+});
+export const GenerateRegistryCredentialsResponseBody = z.object({
+    username: z.string(),
+    password: z.string(),
+    expiresAt: z.string(),
+    repositoryUri: z.string(),
 });
 export const DeploymentErrorData = z.object({
     name: z.string(),
@@ -182,10 +738,16 @@ export const FailDeploymentRequestBody = z.object({
 export const FailDeploymentResponseBody = z.object({
     id: z.string(),
 });
+export const PromoteDeploymentResponseBody = z.object({
+    id: z.string(),
+    version: z.string(),
+    shortCode: z.string(),
+});
 export const GetDeploymentResponseBody = z.object({
     id: z.string(),
     status: z.enum([
         "PENDING",
+        "INSTALLING",
         "BUILDING",
         "DEPLOYING",
         "DEPLOYED",
@@ -197,7 +759,21 @@ export const GetDeploymentResponseBody = z.object({
     shortCode: z.string(),
     version: z.string(),
     imageReference: z.string().nullish(),
+    imagePlatform: z.string(),
+    commitSHA: z.string().nullish(),
+    /**
+     * The `--external-id` this deployment was deployed under, used by version skew
+     * protection to pin runs. Distinct from `commitSHA`, which is git metadata.
+     *
+     * `optional`, not `nullish`, to stay assignable to the CLI's narrower
+     * `InitializeDeploymentResponseBody` shape, which this is spread into on the
+     * attach-to-existing-deployment path (`cli-v3/src/commands/deploy.ts:1156`).
+     */
+    externalId: z.string().optional(),
+    externalBuildData: ExternalBuildData.optional().nullable(),
+    baseImages: DeployBaseImages.optional(),
     errorData: DeploymentErrorData.nullish(),
+    canceledReason: z.string().nullish(),
     worker: z
         .object({
         id: z.string(),
@@ -206,13 +782,153 @@ export const GetDeploymentResponseBody = z.object({
             id: z.string(),
             slug: z.string(),
             filePath: z.string(),
-            exportName: z.string(),
+            exportName: z.string().optional(),
         })),
     })
         .optional(),
+    integrationDeployments: z
+        .array(z.object({
+        id: z.string(),
+        integrationName: z.string(),
+        integrationDeploymentId: z.string(),
+        commitSHA: z.string(),
+        createdAt: z.coerce.date(),
+    }))
+        .nullish(),
+});
+// Secret material, deliberately kept off GetDeploymentResponseBody
+export const GetDeploymentBuildEnvVarsResponseBody = z.object({
+    variables: z.record(z.string(), z.string()),
+});
+export const GetLatestDeploymentResponseBody = GetDeploymentResponseBody.omit({
+    worker: true,
 });
+export const DeploymentLogEvent = z.object({
+    type: z.literal("log"),
+    data: z.object({
+        level: z.enum(["debug", "info", "warn", "error"]).optional().default("info"),
+        message: z.string(),
+    }),
+});
+export const DeploymentFinalizedEvent = z.object({
+    type: z.literal("finalized"),
+    data: z.object({
+        result: z.enum(["succeeded", "failed", "timed_out", "canceled"]).or(anyString),
+        message: z.string().optional(),
+    }),
+});
+export const DeploymentEvent = discriminatedUnion("type", [
+    DeploymentLogEvent,
+    DeploymentFinalizedEvent,
+]);
+export const DeploymentEventFromString = z
+    .string()
+    .transform((s, ctx) => {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: "Invalid JSON" });
+        return z.NEVER;
+    }
+})
+    .pipe(DeploymentEvent);
 export const CreateUploadPayloadUrlResponseBody = z.object({
     presignedUrl: z.string(),
+    /** Present on `/api/v2/packets` PUT (upload handshake); omitted on v1 GET download presign. */
+    storagePath: z.string().optional(),
+});
+/** One page of a `chat.agent` session transcript, from `GET /api/v1/sessions/{id}/transcript`. */
+export const SessionTranscriptResponseBody = z.object({
+    messages: z.array(z.unknown()),
+    cursors: z
+        .object({
+        lastOutEventId: z.string().optional(),
+        lastInEventId: z.string().optional(),
+    })
+        .optional(),
+    nextCursor: z.string().optional(),
+});
+export const WorkersListResponseBody = z
+    .object({
+    type: z.string(),
+    name: z.string(),
+    description: z.string().nullish(),
+    latestVersion: z.string().nullish(),
+    lastHeartbeatAt: z.string().nullish(),
+    isDefault: z.boolean(),
+    updatedAt: z.coerce.date(),
+})
+    .array();
+export const WorkersCreateRequestBody = z.object({
+    name: z.string().optional(),
+    description: z.string().optional(),
+});
+export const WorkersCreateResponseBody = z.object({
+    workerGroup: z.object({
+        name: z.string(),
+        description: z.string().nullish(),
+    }),
+    token: z.object({
+        plaintext: z.string(),
+    }),
+});
+export const DevConfigResponseBody = z.object({
+    environmentId: z.string(),
+    dequeueIntervalWithRun: z.number(),
+    dequeueIntervalWithoutRun: z.number(),
+    maxConcurrentRuns: z.number(),
+    engineUrl: z.string(),
+});
+export const DevDequeueRequestBody = z.object({
+    currentWorker: z.string(),
+    oldWorkers: z.string().array(),
+    maxResources: MachineResources.optional(),
+});
+export const DevDequeueResponseBody = z.object({
+    dequeuedMessages: DequeuedMessage.array(),
+});
+export const DevDisconnectRequestBody = z.object({
+    runFriendlyIds: z.string().array(),
+});
+export const DevDisconnectResponseBody = z.object({
+    cancelled: z.number(),
+    bulkActionId: z.string().optional(),
+});
+export const ReplayRunRequestBody = z
+    .strictObject({
+    payload: z.unknown().optional(),
+    /**
+     * How `payload` is encoded. `application/super+json` means `payload` is a SuperJSON
+     * string, which keeps types like `Date` and `BigInt`. Defaults to plain JSON.
+     */
+    payloadType: z.enum(["application/json", "application/super+json"]).optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+    tags: RunTags.optional(),
+    queue: z.string().optional(),
+    concurrencyKey: ConcurrencyKeySchema.optional(),
+    machine: MachinePresetName.optional(),
+    version: z.string().optional(),
+    region: z.string().optional(),
+    delay: z.string().or(z.coerce.date()).optional(),
+    ttl: z.string().or(z.number().nonnegative().int()).optional(),
+    idempotencyKey: z
+        .string()
+        .max(2048, "idempotencyKey must be 2048 characters or less")
+        .optional(),
+    idempotencyKeyTTL: z.string().optional(),
+    maxAttempts: z.number().int().min(1).optional(),
+    maxDuration: z.number().nonnegative().optional(),
+    priority: z.number().optional(),
+})
+    .superRefine((value, ctx) => {
+    if (value.payloadType === "application/super+json" && typeof value.payload !== "string") {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "payload must be a SuperJSON string when payloadType is application/super+json",
+            path: ["payload"],
+        });
+    }
 });
 export const ReplayRunResponse = z.object({
     id: z.string(),
@@ -220,6 +936,9 @@ export const ReplayRunResponse = z.object({
 export const CanceledRunResponse = z.object({
     id: z.string(),
 });
+export const ResetIdempotencyKeyResponse = z.object({
+    id: z.string(),
+});
 export const ScheduleType = z.union([z.literal("DECLARATIVE"), z.literal("IMPERATIVE")]);
 export const ScheduledTaskPayload = z.object({
     /** The schedule id associated with this run (you can have many schedules for the same task).
@@ -296,6 +1015,13 @@ export const CreateScheduleOptions = z.object({
      *
      */
     timezone: z.string().optional(),
+    /** Optionally delay each occurrence by a stable amount within this window.
+     * Absolute windows use whole minutes or hours up to 24 hours and are capped at the next
+     * nominal interval. Percentages are relative to each nominal interval.
+     *
+     * @example "30m", "2h", "24h", "30%", "100%"
+     */
+    window: ScheduleWindow.optional(),
 });
 export const UpdateScheduleOptions = CreateScheduleOptions.omit({ deduplicationKey: true });
 export const ScheduleGenerator = z.object({
@@ -312,7 +1038,22 @@ export const ScheduleObject = z.object({
     externalId: z.string().nullish(),
     generator: ScheduleGenerator,
     timezone: z.string(),
+    window: ScheduleWindow.optional(),
+    /** The next nominal CRON time. */
     nextRun: z.coerce.date().nullish(),
+    /** The stable assigned time for the next nominal CRON time. */
+    nextRunEffectiveAt: z.coerce.date().nullish(),
+    /**
+     * Present when a non-overridable plan policy applies a minimum window to this schedule (e.g.
+     * a free-plan schedule's 60-minute minimum). The configured `window` is returned separately
+     * and unchanged; this describes the floor applied on top of it.
+     */
+    appliedSchedulePolicy: z
+        .object({
+        minimumWindowSeconds: z.number(),
+        reason: z.literal("free_schedule"),
+    })
+        .optional(),
     environments: z.array(z.object({
         id: z.string(),
         type: z.string(),
@@ -338,16 +1079,16 @@ export const TimezonesResult = z.object({
     timezones: z.array(z.string()),
 });
 export const RunStatus = z.enum([
-    /// Task hasn't been deployed yet but is waiting to be executed
-    "WAITING_FOR_DEPLOY",
+    /// Task is waiting for a version update because it cannot execute without additional information (task, queue, etc.)
+    "PENDING_VERSION",
     /// Task is waiting to be executed by a worker
     "QUEUED",
+    /// Task is waiting to be executed by a worker
+    "DEQUEUED",
     /// Task is currently being executed by a worker
     "EXECUTING",
-    /// Task has failed and is waiting to be retried
-    "REATTEMPTING",
     /// Task has been paused by the system, and will be resumed by the system
-    "FROZEN",
+    "WAITING",
     /// Task has been completed successfully
     "COMPLETED",
     /// Task has been canceled by the user
@@ -356,8 +1097,6 @@ export const RunStatus = z.enum([
     "FAILED",
     /// Task has crashed and won't be retried, most likely the worker ran out of resources, e.g. memory or storage
     "CRASHED",
-    /// Task was interrupted during execution, mostly this happens in development environments
-    "INTERRUPTED",
     /// Task has failed to complete, due to an error in the system
     "SYSTEM_FAILURE",
     /// Task has been scheduled to run at a specific time
@@ -400,6 +1139,7 @@ const CommonRunFields = {
     version: z.string().optional(),
     isQueued: z.boolean(),
     isExecuting: z.boolean(),
+    isWaiting: z.boolean(),
     isCompleted: z.boolean(),
     isSuccess: z.boolean(),
     isFailed: z.boolean(),
@@ -416,7 +1156,9 @@ const CommonRunFields = {
     costInCents: z.number(),
     baseCostInCents: z.number(),
     durationMs: z.number(),
-    metadata: z.record(z.any()).optional(),
+    metadata: z.record(z.string(), z.any()).optional(),
+    taskKind: z.string().optional(),
+    region: z.string().optional(),
 };
 const RetrieveRunCommandFields = {
     ...CommonRunFields,
@@ -438,17 +1180,6 @@ export const RetrieveRunResponse = z.object({
         parent: RelatedRunDetails.optional(),
         children: z.array(RelatedRunDetails).optional(),
     }),
-    attempts: z.array(z
-        .object({
-        id: z.string(),
-        status: AttemptStatus,
-        createdAt: z.coerce.date(),
-        updatedAt: z.coerce.date(),
-        startedAt: z.coerce.date().optional(),
-        completedAt: z.coerce.date().optional(),
-        error: SerializedError.optional(),
-    })
-        .optional()),
     attemptCount: z.number().default(0),
 });
 export const ListRunResponseItem = z.object({
@@ -462,16 +1193,109 @@ export const ListRunResponse = z.object({
         previous: z.string().optional(),
     }),
 });
+const StringOrStringArray = z.union([z.string(), z.array(z.string())]);
+const MachineOrMachineArray = z.union([MachinePresetName, z.array(MachinePresetName)]);
+const QueueOrQueueArray = z.union([QueueTypeName, z.array(QueueTypeName)]);
+const DateOrNumber = z.union([z.coerce.date(), z.number()]);
+const BulkActionFilterRequestBody = z
+    .object({
+    status: z.union([RunStatus, z.array(RunStatus)]).optional(),
+    taskIdentifier: StringOrStringArray.optional(),
+    version: StringOrStringArray.optional(),
+    from: DateOrNumber.optional(),
+    to: DateOrNumber.optional(),
+    period: z.string().optional(),
+    bulkAction: z.string().optional(),
+    tag: StringOrStringArray.optional(),
+    schedule: z.string().optional(),
+    isTest: z.boolean().optional(),
+    batch: z.string().optional(),
+    queue: QueueOrQueueArray.optional(),
+    machine: MachineOrMachineArray.optional(),
+    region: StringOrStringArray.optional(),
+})
+    .refine((filter) => Object.values(filter).some(isNonEmptyBulkActionFilterValue), {
+    message: "At least one filter must be provided",
+});
+/** Recursively checks for at least one non-undefined, non-empty value. */
+function isNonEmptyBulkActionFilterValue(value) {
+    if (value === undefined) {
+        return false;
+    }
+    if (Array.isArray(value)) {
+        return value.some(isNonEmptyBulkActionFilterValue);
+    }
+    if (typeof value === "string") {
+        return value.trim().length > 0;
+    }
+    return true;
+}
+const BulkActionSelectionRequestBody = {
+    filter: BulkActionFilterRequestBody.optional(),
+    runIds: z.array(z.string()).min(1).optional(),
+    name: z.string().max(255, "Name must be less than 255 characters").optional(),
+};
+export const CreateBulkActionRequestBody = discriminatedUnion("action", [
+    z.object({
+        action: z.literal("cancel"),
+        targetRegion: z.never().optional(),
+        ...BulkActionSelectionRequestBody,
+    }),
+    z.object({
+        action: z.literal("replay"),
+        targetRegion: z.string().optional(),
+        ...BulkActionSelectionRequestBody,
+    }),
+]).refine((body) => (body.filter ? 1 : 0) + (body.runIds ? 1 : 0) === 1, {
+    message: "Exactly one of filter or runIds must be provided",
+});
+export const BulkActionStatus = z.enum(["PENDING", "COMPLETED", "ABORTED"]);
+export const BulkActionType = z.enum(["CANCEL", "REPLAY"]);
+export const BulkActionObject = z.object({
+    id: z.string(),
+    name: z.string().optional(),
+    type: BulkActionType,
+    status: BulkActionStatus,
+    counts: z.object({
+        total: z.number(),
+        success: z.number(),
+        failure: z.number(),
+    }),
+    createdAt: z.coerce.date(),
+    completedAt: z.coerce.date().optional(),
+});
+export const CreateBulkActionResponseBody = z.object({
+    id: z.string(),
+});
+export const AbortBulkActionResponseBody = z.object({
+    id: z.string(),
+});
+export const ListBulkActionsResponseBody = z.object({
+    data: z.array(BulkActionObject),
+    pagination: z.object({
+        next: z.string().optional(),
+        previous: z.string().optional(),
+    }),
+});
 export const CreateEnvironmentVariableRequestBody = z.object({
     name: z.string(),
     value: z.string(),
+    // When omitted, the variable defaults to non-secret (the DB default is false).
+    isSecret: z.boolean().optional(),
 });
 export const UpdateEnvironmentVariableRequestBody = z.object({
     value: z.string(),
 });
 export const ImportEnvironmentVariablesRequestBody = z.object({
-    variables: z.record(z.string()),
+    variables: z.record(z.string(), z.string()),
+    parentVariables: z.record(z.string(), z.string()).optional(),
     override: z.boolean().optional(),
+    // When omitted, variables default to non-secret (the DB default is false).
+    isSecret: z.boolean().optional(),
+    source: discriminatedUnion("type", [
+        z.object({ type: z.literal("user"), userId: z.string() }),
+        z.object({ type: z.literal("integration"), integration: z.string() }),
+    ]).optional(),
 });
 export const EnvironmentVariableResponseBody = z.object({
     success: z.boolean(),
@@ -484,9 +1308,23 @@ export const EnvironmentVariable = z.object({
     value: z.string(),
 });
 export const EnvironmentVariables = z.array(EnvironmentVariable);
+export const EnvironmentVariableWithSecret = z.object({
+    /** The name of the env var, e.g. `DATABASE_URL` */
+    name: z.string(),
+    /** The value of the env var. If it's a secret, this will be a redacted value, not the real value.  */
+    value: z.string(),
+    /**
+     * Whether the env var is a secret or not.
+     * When you create env vars you can mark them as secrets.
+     *
+     * You can't view the value of a secret env var after setting it initially.
+     * For a secret env var, the value will be redacted.
+     */
+    isSecret: z.boolean(),
+});
 export const UpdateMetadataRequestBody = FlushedRunMetadata;
 export const UpdateMetadataResponseBody = z.object({
-    metadata: z.record(DeserializedJsonSchema),
+    metadata: z.record(z.string(), DeserializedJsonSchema),
 });
 const RawShapeDate = z
     .string()
@@ -498,7 +1336,9 @@ const RawOptionalShapeDate = z
     .transform((val) => (val ? new Date(`${val}Z`) : val));
 export const SubscribeRunRawShape = z.object({
     id: z.string(),
-    idempotencyKey: z.string().nullish(),
+    taskIdentifier: z.string(),
+    friendlyId: z.string(),
+    status: z.string(),
     createdAt: RawShapeDate,
     updatedAt: RawShapeDate,
     startedAt: RawOptionalShapeDate,
@@ -506,14 +1346,12 @@ export const SubscribeRunRawShape = z.object({
     queuedAt: RawOptionalShapeDate,
     expiredAt: RawOptionalShapeDate,
     completedAt: RawOptionalShapeDate,
-    taskIdentifier: z.string(),
-    friendlyId: z.string(),
-    number: z.number(),
-    isTest: z.boolean(),
-    status: z.string(),
-    usageDurationMs: z.number(),
-    costInCents: z.number(),
-    baseCostInCents: z.number(),
+    idempotencyKey: z.string().nullish(),
+    number: z.number().default(0),
+    isTest: z.boolean().default(false),
+    usageDurationMs: z.number().default(0),
+    costInCents: z.number().default(0),
+    baseCostInCents: z.number().default(0),
     ttl: z.string().nullish(),
     payload: z.string().nullish(),
     payloadType: z.string().nullish(),
@@ -523,8 +1361,15 @@ export const SubscribeRunRawShape = z.object({
     outputType: z.string().nullish(),
     runTags: z.array(z.string()).nullish().default([]),
     error: TaskRunError.nullish(),
+    realtimeStreams: z.array(z.string()).nullish().default([]),
 });
-export const BatchStatus = z.enum(["PENDING", "COMPLETED"]);
+export const BatchStatus = z.enum([
+    "PENDING",
+    "PROCESSING",
+    "COMPLETED",
+    "PARTIAL_FAILED",
+    "ABORTED",
+]);
 export const RetrieveBatchResponse = z.object({
     id: z.string(),
     status: BatchStatus,
@@ -532,6 +1377,25 @@ export const RetrieveBatchResponse = z.object({
     createdAt: z.coerce.date(),
     updatedAt: z.coerce.date(),
     runCount: z.number(),
+    runs: z.array(z.string()),
+});
+export const RetrieveBatchV2Response = z.object({
+    id: z.string(),
+    status: BatchStatus,
+    idempotencyKey: z.string().optional(),
+    createdAt: z.coerce.date(),
+    updatedAt: z.coerce.date(),
+    runCount: z.number(),
+    runs: z.array(z.string()),
+    processing: z.object({
+        completedAt: z.coerce.date().optional(),
+        errors: z.array(z.object({
+            index: z.number(),
+            taskIdentifier: z.string(),
+            error: z.string(),
+            errorCode: z.string().optional(),
+        })),
+    }),
 });
 export const SubscribeRealtimeStreamChunkRawShape = z.object({
     id: z.string(),
@@ -541,4 +1405,678 @@ export const SubscribeRealtimeStreamChunkRawShape = z.object({
     value: z.string(),
     createdAt: z.coerce.date(),
 });
+export const TimePeriod = z.string().or(z.coerce.date());
+export const CreateWaitpointTokenRequestBody = z.object({
+    /**
+     * An optional idempotency key for the waitpoint.
+     * If you use the same key twice (and the key hasn't expired), you will get the original waitpoint back.
+     *
+     * Note: This waitpoint may already be complete, in which case when you wait for it, it will immediately continue.
+     */
+    idempotencyKey: z
+        .string()
+        // Caps user-supplied keys before they reach the unique idempotency index
+        // on the underlying table — values past this fail at the database layer
+        // rather than returning a clean 400.
+        .max(2048, "idempotencyKey must be 2048 characters or less")
+        .optional(),
+    /**
+     * When set, this means the passed in idempotency key will expire after this time.
+     * This means after that time if you pass the same idempotency key again, you will get a new waitpoint.
+     */
+    idempotencyKeyTTL: z.string().optional(),
+    /** The resume token will timeout after this time.
+     * If you are waiting for the token in a run, the token will return a result where `ok` is false.
+     *
+     * You can pass a `Date` object, or a string in this format: "30s", "1m", "2h", "3d", "4w".
+     */
+    timeout: TimePeriod.optional(),
+    /**
+     * Tags to attach to the waitpoint. Tags can be used to filter waitpoints in the dashboard.
+     *
+     * You can set up to 10 tags per waitpoint, they must be less than 128 characters each.
+     *
+     * We recommend prefixing tags with a namespace using an underscore or colon, like `user_1234567` or `org:9876543`.
+     *
+     * @example
+     *
+     * ```ts
+     * await wait.createToken({ tags: ["user:1234567", "org:9876543"] });
+     * ```
+     */
+    tags: RunTags.optional(),
+});
+export const CreateWaitpointTokenResponseBody = z.object({
+    id: z.string(),
+    isCached: z.boolean(),
+    url: z.string(),
+});
+export const CreateInputStreamWaitpointRequestBody = z.object({
+    streamId: z.string(),
+    timeout: z.string().optional(),
+    idempotencyKey: z
+        .string()
+        // Caps user-supplied keys before they reach the unique idempotency index
+        // on the underlying table — values past this fail at the database layer
+        // rather than returning a clean 400.
+        .max(2048, "idempotencyKey must be 2048 characters or less")
+        .optional(),
+    idempotencyKeyTTL: z.string().optional(),
+    tags: z.union([z.string(), z.array(z.string())]).optional(),
+    /**
+     * The last S2 sequence number the client has seen on this input stream.
+     * Used to check for data that arrived before .wait() was called.
+     * If undefined, the server checks from the beginning of the stream.
+     */
+    lastSeqNum: z.number().optional(),
+});
+export const CreateInputStreamWaitpointResponseBody = z.object({
+    waitpointId: z.string(),
+    isCached: z.boolean(),
+});
+/**
+ * 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 const CreateSessionStreamWaitpointRequestBody = z.object({
+    /** Session friendlyId (`session_*`) or user-supplied externalId. */
+    session: z.string(),
+    io: z.enum(["out", "in"]),
+    timeout: z.string().optional(),
+    idempotencyKey: z
+        .string()
+        // Caps user-supplied keys before they reach the unique idempotency index
+        // on the underlying table — values past this fail at the database layer
+        // rather than returning a clean 400.
+        .max(2048, "idempotencyKey must be 2048 characters or less")
+        .optional(),
+    idempotencyKeyTTL: z.string().optional(),
+    tags: z.union([z.string(), z.array(z.string())]).optional(),
+    /**
+     * Last S2 sequence number the client has seen on this session channel.
+     * Used to catch data that arrived before `.wait()` was called.
+     */
+    lastSeqNum: z.number().optional(),
+});
+export const CreateSessionStreamWaitpointResponseBody = z.object({
+    waitpointId: z.string(),
+    isCached: z.boolean(),
+});
+export const waitpointTokenStatuses = ["WAITING", "COMPLETED", "TIMED_OUT"];
+export const WaitpointTokenStatus = z.enum(waitpointTokenStatuses);
+export const WaitpointTokenItem = z.object({
+    id: z.string(),
+    /** If you make a POST request to this URL, it will complete the waitpoint. */
+    url: z.string(),
+    status: WaitpointTokenStatus,
+    completedAt: z.coerce.date().optional(),
+    completedAfter: z.coerce.date().optional(),
+    timeoutAt: z.coerce.date().optional(),
+    idempotencyKey: z.string().optional(),
+    idempotencyKeyExpiresAt: z.coerce.date().optional(),
+    tags: z.array(z.string()),
+    createdAt: z.coerce.date(),
+});
+export const WaitpointListTokenItem = WaitpointTokenItem.omit({
+    completedAfter: true,
+});
+export const WaitpointRetrieveTokenResponse = WaitpointListTokenItem.and(z.object({
+    output: z.string().optional(),
+    outputType: z.string().optional(),
+    outputIsError: z.boolean().optional(),
+}));
+export const CompleteWaitpointTokenRequestBody = z.object({
+    data: z.any().nullish(),
+});
+/**
+ * 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 const SessionTriggerConfig = z.object({
+    basePayload: z.record(z.string(), z.unknown()),
+    machine: MachinePresetName.optional(),
+    queue: z.string().max(128).optional(),
+    /** Named concurrency limits every run holds, replacing the task's declared named limits.
+     * The charset rule is enforced here so a bad name is rejected before the session row
+     * persists, instead of surfacing from the trigger after the session already exists. */
+    concurrency: TriggerConcurrencyLimitsSchema.optional(),
+    /** Scopes every run to its own pool under each `perKey` bound it holds. Never defaulted — a session without one shares the keyless pool. */
+    concurrencyKey: ConcurrencyKeySchema.optional(),
+    tags: z.array(z.string().max(128)).max(10).optional(),
+    maxAttempts: z.number().int().positive().max(10).optional(),
+    /** Per-run wall-clock cap (seconds). Forwarded to `TaskRunOptions.maxDuration`. */
+    maxDuration: z.number().int().positive().optional(),
+    /** Pin every run to a specific worker version. Forwarded to `TaskRunOptions.lockToVersion`. */
+    lockToVersion: z.string().optional(),
+    /**
+     * Pin every run the session schedules to the deployment carrying this id, refreshed by each
+     * `sessions.start`. Independent of `lockToVersion`, which wins.
+     */
+    externalDeploymentId: ExternalDeploymentId,
+    /** Region to schedule runs in. Forwarded to `TaskRunOptions.region`. */
+    region: z.string().optional(),
+    /** Convenience field surfaced to chat.agent via the wire payload. */
+    idleTimeoutInSeconds: z.number().int().positive().max(3600).optional(),
+    /** How long a run may sit undequeued before it expires. Forwarded to `TaskRunOptions.ttl`. */
+    ttl: z.string().or(z.number().nonnegative().int()).optional(),
+});
+/**
+ * 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 const CreateSessionRequestBody = z.object({
+    /** Plain string discriminator — e.g. `"chat.agent"`. Not validated against an enum on the server. */
+    type: z.string().min(1).max(64),
+    /** User-supplied idempotency key. Unique per environment. Empty strings are rejected. */
+    externalId: z
+        .string()
+        .trim()
+        .min(1)
+        .max(256)
+        .refine((v) => !v.startsWith("session_"), {
+        message: "externalId cannot start with 'session_' (reserved prefix for internal friendlyIds)",
+    })
+        .optional(),
+    /** Task this session triggers runs against. Required. */
+    taskIdentifier: z.string().min(1).max(128),
+    /** Trigger config used for every run scheduled by this session. */
+    triggerConfig: SessionTriggerConfig,
+    /** Up to 10 tags for dashboard filtering. */
+    tags: z.array(z.string().max(128)).max(10).optional(),
+    /** Arbitrary JSON metadata. */
+    metadata: z.record(z.string(), z.unknown()).optional(),
+    /** Absolute expiry timestamp for retention. */
+    expiresAt: z.coerce.date().optional(),
+});
+export const SessionItem = z.object({
+    id: z.string(),
+    externalId: z.string().nullable(),
+    type: z.string(),
+    taskIdentifier: z.string(),
+    /**
+     * 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: SessionTriggerConfig.optional(),
+    /**
+     * 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.string().nullable().optional(),
+    tags: z.array(z.string()),
+    metadata: z.record(z.string(), z.unknown()).nullable(),
+    closedAt: z.coerce.date().nullable(),
+    closedReason: z.string().nullable(),
+    expiresAt: z.coerce.date().nullable(),
+    createdAt: z.coerce.date(),
+    updatedAt: z.coerce.date(),
+});
+export const CreatedSessionResponseBody = SessionItem.extend({
+    /** Friendly id of the first run triggered alongside session create. */
+    runId: z.string(),
+    /** Session-scoped public access token: `read:sessions:{ext} + write:sessions:{ext}`. */
+    publicAccessToken: z.string(),
+    /** True if the session existed already (idempotent upsert), false if newly created. */
+    isCached: z.boolean(),
+    /**
+     * The session's live run is parked waiting for a deployment carrying its external deployment
+     * id. Messages sent meanwhile are durable. Optional, so older servers read as `false`.
+     */
+    pendingVersion: z.boolean().optional(),
+});
+export const RetrieveSessionResponseBody = SessionItem;
+/**
+ * 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 const EndAndContinueSessionRequestBody = z.object({
+    /** The friendlyId of the run requesting the handoff. */
+    callingRunId: z.string(),
+    /** Free-form label for the SessionRun audit row. e.g. `"upgrade"`. */
+    reason: z.string().max(64),
+    /**
+     * Re-pin the session to this id instead of clearing the pin. Only read when `reason` is
+     * `"upgrade"`. `lockToVersion` is never cleared.
+     */
+    externalDeploymentId: ExternalDeploymentId,
+});
+export const EndAndContinueSessionResponseBody = z.object({
+    /** friendlyId of the run that has taken over the session. */
+    runId: z.string(),
+    /**
+     * 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.boolean(),
+    /**
+     * The run that took over is parked waiting for its deployment. Surface this so a
+     * handoff onto a version that has not landed reads as a deploy in progress rather
+     * than a chat that went quiet.
+     */
+    pendingVersion: z.boolean().optional(),
+});
+export const UpdateSessionRequestBody = z.object({
+    tags: z.array(z.string().max(128)).max(10).optional(),
+    metadata: z.record(z.string(), z.unknown()).nullable().optional(),
+    // Null explicitly clears the externalId; non-null values must be non-empty.
+    externalId: z
+        .union([
+        z.literal(null),
+        z
+            .string()
+            .trim()
+            .min(1)
+            .max(256)
+            .refine((v) => !v.startsWith("session_"), {
+            message: "externalId cannot start with 'session_' (reserved prefix for internal friendlyIds)",
+        }),
+    ])
+        .optional(),
+});
+export const CloseSessionRequestBody = z.object({
+    reason: z.string().max(256).optional(),
+    /**
+     * The friendlyId of the run requesting the close, when the close comes
+     * from inside the session's own run (`chat.close()`). That run is already
+     * exiting, so the server skips appending the wake-up close record to `.in`
+     * for it. Omitted for an external close (dashboard, `sessions.close()`, MCP).
+     */
+    callingRunId: z.string().optional(),
+});
+export const SessionStatus = z.enum(["ACTIVE", "CLOSED", "EXPIRED"]);
+/**
+ * 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 const ListSessionsQueryParams = z
+    .object({
+    "page[size]": z.coerce.number().int().min(1).max(100).default(20),
+    "page[after]": z.string().optional(),
+    "page[before]": z.string().optional(),
+    "filter[type]": z.union([z.string(), z.array(z.string())]).optional(),
+    "filter[tags]": z.union([z.string(), z.array(z.string())]).optional(),
+    "filter[taskIdentifier]": z.union([z.string(), z.array(z.string())]).optional(),
+    "filter[externalId]": z.string().optional(),
+    "filter[status]": z.union([SessionStatus, z.array(SessionStatus)]).optional(),
+    "filter[createdAt][period]": z.string().optional(),
+    "filter[createdAt][from]": z.coerce.number().int().optional(),
+    "filter[createdAt][to]": z.coerce.number().int().optional(),
+})
+    .refine((value) => !(value["page[after]"] && value["page[before]"]), {
+    message: "Cannot pass both page[after] and page[before] on the same request",
+    path: ["page[before]"],
+});
+/**
+ * Client-facing list options — flattened shape that
+ * {@link ApiClient.listSessions} converts into the `filter[*]` / `page[*]`
+ * query string before sending.
+ */
+export const ListSessionsOptions = z.object({
+    limit: z.number().int().min(1).max(100).optional(),
+    after: z.string().optional(),
+    before: z.string().optional(),
+    type: z.union([z.string(), z.array(z.string())]).optional(),
+    tag: z.union([z.string(), z.array(z.string())]).optional(),
+    taskIdentifier: z.union([z.string(), z.array(z.string())]).optional(),
+    externalId: z.string().optional(),
+    status: z.union([SessionStatus, z.array(SessionStatus)]).optional(),
+    period: z.string().optional(),
+    from: z.union([z.number(), z.date()]).optional(),
+    to: z.union([z.number(), z.date()]).optional(),
+});
+export const ListedSessionItem = SessionItem;
+export const ListSessionsResponseBody = z.object({
+    data: z.array(ListedSessionItem),
+    pagination: z.object({
+        next: z.string().optional(),
+        previous: z.string().optional(),
+    }),
+});
+export const CompleteWaitpointTokenResponseBody = z.object({
+    success: z.literal(true),
+});
+export const WaitForWaitpointTokenResponseBody = z.object({
+    success: z.boolean(),
+});
+export const WaitForDurationRequestBody = z.object({
+    /**
+     * An optional idempotency key for the waitpoint.
+     * If you use the same key twice (and the key hasn't expired), you will get the original waitpoint back.
+     *
+     * Note: This waitpoint may already be complete, in which case when you wait for it, it will immediately continue.
+     */
+    idempotencyKey: z
+        .string()
+        // Caps user-supplied keys before they reach the unique idempotency index
+        // on the underlying table — values past this fail at the database layer
+        // rather than returning a clean 400.
+        .max(2048, "idempotencyKey must be 2048 characters or less")
+        .optional(),
+    /**
+     * When set, this means the passed in idempotency key will expire after this time.
+     * This means after that time if you pass the same idempotency key again, you will get a new waitpoint.
+     */
+    idempotencyKeyTTL: z.string().optional(),
+    /**
+     * The date that the waitpoint will complete.
+     */
+    date: z.coerce.date(),
+});
+export const WaitForDurationResponseBody = z.object({
+    /**
+        If you pass an idempotencyKey, you may actually not need to wait.
+        Use this date to determine when to continue.
+    */
+    waitUntil: z.coerce.date(),
+    waitpoint: z.object({
+        id: z.string(),
+    }),
+});
+const WAITPOINT_TIMEOUT_ERROR_CODE = "TRIGGER_WAITPOINT_TIMEOUT";
+export function isWaitpointOutputTimeout(output) {
+    try {
+        const json = JSON.parse(output);
+        return json.code === WAITPOINT_TIMEOUT_ERROR_CODE;
+    }
+    catch (_e) {
+        return false;
+    }
+}
+export function timeoutError(timeout) {
+    return {
+        code: WAITPOINT_TIMEOUT_ERROR_CODE,
+        message: `Waitpoint timed out at ${timeout.toISOString()}`,
+    };
+}
+const ApiDeploymentCommonShape = {
+    from: z.string().describe("The date to start the search from, in ISO 8601 format").optional(),
+    to: z.string().describe("The date to end the search, in ISO 8601 format").optional(),
+    period: z.string().describe("The period to search within (e.g. 1d, 7d, 3h, etc.)").optional(),
+    status: z
+        .enum(["PENDING", "BUILDING", "DEPLOYING", "DEPLOYED", "FAILED", "CANCELED", "TIMED_OUT"])
+        .describe("Filter deployments that are in this status")
+        .optional(),
+};
+const ApiDeploymentListPaginationCursor = z
+    .string()
+    .describe("The deployment ID to start the search from, to get the next page")
+    .optional();
+const ApiDeploymentListPaginationLimit = z.coerce
+    .number()
+    .describe("The number of deployments to return, defaults to 20 (max 100)")
+    .min(1, "Limit must be at least 1")
+    .max(100, "Limit must be less than 100")
+    .optional();
+export const ApiDeploymentListParams = {
+    ...ApiDeploymentCommonShape,
+    cursor: ApiDeploymentListPaginationCursor,
+    limit: ApiDeploymentListPaginationLimit,
+};
+export const ApiDeploymentListOptions = z.object(ApiDeploymentListParams);
+export const ApiDeploymentListSearchParams = z.object({
+    ...ApiDeploymentCommonShape,
+    "page[after]": ApiDeploymentListPaginationCursor,
+    "page[size]": ApiDeploymentListPaginationLimit,
+});
+export const ApiDeploymentListResponseItem = z.object({
+    id: z.string(),
+    createdAt: z.coerce.date(),
+    shortCode: z.string(),
+    version: z.string(),
+    runtime: z.string().nullable(),
+    runtimeVersion: z.string().nullable(),
+    status: z.enum([
+        "PENDING",
+        "BUILDING",
+        "DEPLOYING",
+        "DEPLOYED",
+        "FAILED",
+        "CANCELED",
+        "TIMED_OUT",
+    ]),
+    deployedAt: z.coerce.date().optional(),
+    git: z.record(z.string(), z.any()).optional(),
+    error: DeploymentErrorData.optional(),
+    /**
+     * The `--external-id` this deployment was deployed under, used by version skew
+     * protection to pin runs. Nullish on deployments created without one, and on
+     * servers older than this field.
+     */
+    externalId: z.string().nullish(),
+});
+export const RetrieveCurrentDeploymentResponseBody = ApiDeploymentListResponseItem;
+export const ApiBranchListResponseBody = z.object({
+    branches: z.array(z.object({
+        id: z.string(),
+        name: z.string(),
+        createdAt: z.coerce.date(),
+        updatedAt: z.coerce.date(),
+        git: z.record(z.string(), z.any()).optional(),
+        isPaused: z.boolean(),
+    })),
+});
+export const RetrieveRunTraceSpanSchema = z.object({
+    id: z.string(),
+    parentId: z.string().optional(),
+    runId: z.string(),
+    data: z.object({
+        message: z.string(),
+        taskSlug: z.string().optional(),
+        taskPath: z.string().optional(),
+        events: z.array(z.any()).optional(),
+        startTime: z.coerce.date(),
+        duration: z.number(),
+        isError: z.boolean(),
+        isPartial: z.boolean(),
+        isCancelled: z.boolean(),
+        level: z.string(),
+        workerVersion: z.string().optional(),
+        queueName: z.string().optional(),
+        machinePreset: z.string().optional(),
+        properties: z.record(z.string(), z.any()).optional(),
+        output: z.unknown().optional(),
+    }),
+});
+export const RetrieveRunTraceSpan = RetrieveRunTraceSpanSchema.extend({
+    children: z.lazy(() => RetrieveRunTraceSpan.array()),
+});
+export const RetrieveRunTraceResponseBody = z.object({
+    trace: z.object({
+        traceId: z.string(),
+        rootSpan: RetrieveRunTraceSpan,
+    }),
+});
+export const RetrieveRunTracePageSpan = z.object({
+    id: z.string(),
+    parentId: z.string().optional(),
+    runId: z.string(),
+    message: z.string(),
+    startTime: z.coerce.date(),
+    duration: z.number(),
+    isError: z.boolean(),
+    isPartial: z.boolean(),
+    isCancelled: z.boolean(),
+    level: z.string(),
+    attemptNumber: z.number().optional(),
+});
+export const RetrieveRunTraceAttemptFailure = z.object({
+    spanId: z.string(),
+    attemptNumber: z.number(),
+    runId: z.string(),
+});
+export const RetrieveRunTracePageResponseBody = z.object({
+    data: z.array(RetrieveRunTracePageSpan),
+    attemptFailures: z.array(RetrieveRunTraceAttemptFailure),
+    pagination: z.object({
+        next: z.string().optional(),
+        // Some spans or records were left out: paging stopped early (e.g. an emergency cap)
+        // or a span had more records than one read allows.
+        truncated: z.boolean().optional(),
+    }),
+});
+export const RetrieveSpanDetailResponseBody = z.object({
+    spanId: z.string(),
+    parentId: z.string().nullable(),
+    runId: z.string(),
+    message: z.string(),
+    isError: z.boolean(),
+    isPartial: z.boolean(),
+    isCancelled: z.boolean(),
+    level: z.string(),
+    startTime: z.coerce.date(),
+    durationMs: z.number(),
+    properties: z.record(z.string(), z.any()).optional(),
+    events: z.array(z.any()).optional(),
+    entityType: z.string().optional(),
+    ai: z
+        .object({
+        model: z.string(),
+        provider: z.string(),
+        operationName: z.string(),
+        inputTokens: z.number(),
+        outputTokens: z.number(),
+        totalTokens: z.number(),
+        cachedTokens: z.number().optional(),
+        reasoningTokens: z.number().optional(),
+        inputCost: z.number().optional(),
+        outputCost: z.number().optional(),
+        totalCost: z.number().optional(),
+        cachedCost: z.number().optional(),
+        cacheCreationCost: z.number().optional(),
+        tokensPerSecond: z.number().optional(),
+        msToFirstChunk: z.number().optional(),
+        durationMs: z.number(),
+        finishReason: z.string().optional(),
+        responseText: z.string().optional(),
+    })
+        .optional(),
+    triggeredRuns: z
+        .array(z.object({
+        runId: z.string(),
+        taskIdentifier: z.string(),
+        status: z.string(),
+        createdAt: z.coerce.date(),
+    }))
+        .optional(),
+});
+export const CreateStreamResponseBody = z.object({
+    version: z.string(),
+});
+export const AppendToStreamResponseBody = z.object({
+    ok: z.boolean(),
+    message: z.string().optional(),
+});
+export const SendInputStreamResponseBody = z.object({
+    ok: z.boolean(),
+});
+/**
+ * Response body for `GET /realtime/v1/sessions/:id/:io/records`. A non-SSE,
+ * `wait=0` drain of a session channel — used at run boot for snapshot
+ * replay where the SSE long-poll tax (~1s on empty streams) was the
+ * dominant cost.
+ *
+ * `data` is the parsed chunk body (the SDK writer puts the chunk object
+ * directly into the S2 record envelope; the route unwraps the envelope
+ * and forwards the inner object as-is). Callers use it directly — no
+ * additional JSON.parse step. Schema is `z.unknown()` because chunk
+ * shape varies by `chunk.type` (the AI SDK's `UIMessageChunk`
+ * discriminated union plus Trigger control records); consumers
+ * already runtime-check on the discriminator and tolerate malformed
+ * records by skipping them.
+ */
+export const ReadSessionStreamRecordsResponseBody = z.object({
+    records: z.array(z.object({
+        data: z.unknown(),
+        id: z.string(),
+        seqNum: z.number(),
+        // S2 record headers — present on Trigger control records (e.g.
+        // `trigger-control: turn-complete` plus sibling headers). The
+        // server has always serialized them; older schemas stripped them
+        // client-side, so treat as optional.
+        headers: z.array(z.tuple([z.string(), z.string()])).optional(),
+    })),
+});
+export const ResolvePromptRequestBody = z.object({
+    variables: z.record(z.string(), z.unknown()).default({}),
+    label: z.string().optional(),
+    version: z.number().optional(),
+});
+export const ResolvePromptResponseBody = z.object({
+    data: z.object({
+        promptId: z.string(),
+        slug: z.string(),
+        version: z.number(),
+        labels: z.array(z.string()),
+        template: z.string().optional(),
+        text: z.string().optional(),
+        model: z.string().optional().nullable(),
+        config: z.record(z.string(), z.unknown()).optional().nullable(),
+    }),
+});
+export const ListPromptsResponseBody = z.object({
+    data: z.array(z.object({
+        slug: z.string(),
+        friendlyId: z.string(),
+        description: z.string().nullable(),
+        tags: z.array(z.string()),
+        defaultModel: z.string().nullable(),
+        currentVersion: z.number().nullable(),
+        hasOverride: z.boolean(),
+        updatedAt: z.string(),
+    })),
+});
+export const ListPromptVersionsResponseBody = z.object({
+    data: z.array(z.object({
+        id: z.string(),
+        version: z.number(),
+        labels: z.array(z.string()),
+        source: z.string(),
+        model: z.string().nullable(),
+        textContent: z.string().nullable(),
+        commitMessage: z.string().nullable(),
+        contentHash: z.string(),
+        createdAt: z.string(),
+    })),
+});
+export const PromotePromptVersionRequestBody = z.object({
+    version: z.number().int().positive(),
+});
+export const CreatePromptOverrideRequestBody = z.object({
+    textContent: z.string(),
+    model: z.string().optional(),
+    commitMessage: z.string().optional(),
+    source: z.string().optional(),
+});
+export const UpdatePromptOverrideRequestBody = z.object({
+    textContent: z.string().optional(),
+    model: z.string().optional(),
+    commitMessage: z.string().optional(),
+});
+export const ReactivatePromptOverrideRequestBody = z.object({
+    version: z.number().int().positive(),
+});
+export const PromptOkResponseBody = z.object({ ok: z.boolean() });
+export const PromptOverrideCreatedResponseBody = z.object({
+    ok: z.boolean(),
+    version: z.number(),
+});
 //# sourceMappingURL=api.js.map