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

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

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FailDeploymentRequestBody = exports.DeploymentErrorData = exports.GenerateRegistryCredentialsResponseBody = exports.RemoteBuildProviderStatusResponseBody = exports.InitializeDeploymentRequestBody = exports.InitializeDeploymentResponseBody = exports.CreateArtifactResponseBody = exports.CreateArtifactRequestBody = exports.UpsertBranchResponseBody = exports.UpsertBranchRequestBody = exports.DeploymentTriggeredVia = exports.ExternalBuildData = exports.CancelDeploymentRequestBody = exports.ProgressDeploymentRequestBody = exports.BuildServerMetadata = exports.FinalizeDeploymentRequestBody = exports.StartDeploymentIndexingResponseBody = exports.StartDeploymentIndexingRequestBody = exports.GetEnvironmentVariablesResponseBody = exports.RescheduleRunRequestBody = exports.AddTagsRequestBody = exports.GetBatchResponseBody = exports.BatchTriggerTaskResponse = exports.StreamBatchItemsResponse = exports.BatchItemNDJSON = exports.CreateBatchResponse = exports.CreateBatchRequestBody = exports.BatchTriggerTaskV3Response = exports.BatchTriggerTaskV3RequestBody = exports.BatchTriggerTaskV2Response = exports.BatchTriggerTaskV2RequestBody = exports.BatchTriggerTaskItem = exports.BatchTriggerTaskRequestBody = exports.TriggerTaskResponse = exports.TriggerTaskRequestBody = exports.IdempotencyKeyOptionsSchema = exports.RunTags = exports.CreateBackgroundWorkerResponse = exports.CreateBackgroundWorkerRequestBody = exports.GetJWTResponse = exports.GetJWTRequestBody = exports.GetWorkerByTagResponse = exports.GetWorkerTaskResponse = exports.GetProjectEnvResponse = exports.CreateProjectRequestBody = exports.GetOrgsResponseBody = exports.GetProjectsResponseBody = exports.GetProjectResponseBody = exports.WhoAmIResponseSchema = exports.RunEngineVersion = void 0;
-exports.SubscribeRunRawShape = exports.UpdateMetadataResponseBody = exports.UpdateMetadataRequestBody = exports.EnvironmentVariableWithSecret = exports.EnvironmentVariables = exports.EnvironmentVariable = exports.EnvironmentVariableValue = exports.EnvironmentVariableResponseBody = exports.ImportEnvironmentVariablesRequestBody = exports.UpdateEnvironmentVariableRequestBody = exports.CreateEnvironmentVariableRequestBody = exports.ListRunResponse = exports.ListRunResponseItem = exports.RetrieveRunResponse = exports.RelatedRunDetails = exports.TriggerFunction = exports.RunScheduleDetails = exports.RunEnvironmentDetails = exports.AttemptStatus = exports.RunStatus = exports.TimezonesResult = exports.ListScheduleOptions = exports.ListSchedulesResult = exports.DeletedScheduleObject = exports.ScheduleObject = exports.ScheduleGenerator = exports.UpdateScheduleOptions = exports.CreateScheduleOptions = exports.ScheduledTaskPayload = exports.ScheduleType = exports.ResetIdempotencyKeyResponse = exports.CanceledRunResponse = exports.ReplayRunResponse = exports.DevDisconnectResponseBody = exports.DevDisconnectRequestBody = exports.DevDequeueResponseBody = exports.DevDequeueRequestBody = exports.DevConfigResponseBody = exports.WorkersCreateResponseBody = exports.WorkersCreateRequestBody = exports.WorkersListResponseBody = exports.CreateUploadPayloadUrlResponseBody = exports.DeploymentEventFromString = exports.DeploymentEvent = exports.DeploymentFinalizedEvent = exports.DeploymentLogEvent = exports.GetLatestDeploymentResponseBody = exports.GetDeploymentResponseBody = exports.PromoteDeploymentResponseBody = exports.FailDeploymentResponseBody = void 0;
-exports.ListPromptsResponseBody = exports.ResolvePromptResponseBody = exports.ResolvePromptRequestBody = exports.SendInputStreamResponseBody = exports.AppendToStreamResponseBody = exports.CreateStreamResponseBody = exports.RetrieveSpanDetailResponseBody = exports.RetrieveRunTraceResponseBody = exports.RetrieveRunTraceSpan = exports.RetrieveRunTraceSpanSchema = exports.ApiBranchListResponseBody = exports.ApiDeploymentListResponseItem = exports.ApiDeploymentListSearchParams = exports.ApiDeploymentListOptions = exports.ApiDeploymentListParams = exports.WaitForDurationResponseBody = exports.WaitForDurationRequestBody = exports.WaitForWaitpointTokenResponseBody = exports.CompleteWaitpointTokenResponseBody = exports.ListSessionsResponseBody = exports.ListedSessionItem = exports.ListSessionsOptions = exports.ListSessionsQueryParams = exports.SessionStatus = exports.CloseSessionRequestBody = exports.UpdateSessionRequestBody = exports.EndAndContinueSessionResponseBody = exports.EndAndContinueSessionRequestBody = exports.RetrieveSessionResponseBody = exports.CreatedSessionResponseBody = exports.SessionItem = exports.CreateSessionRequestBody = exports.SessionTriggerConfig = exports.CompleteWaitpointTokenRequestBody = exports.WaitpointRetrieveTokenResponse = exports.WaitpointListTokenItem = exports.WaitpointTokenItem = exports.WaitpointTokenStatus = exports.waitpointTokenStatuses = exports.CreateSessionStreamWaitpointResponseBody = exports.CreateSessionStreamWaitpointRequestBody = exports.CreateInputStreamWaitpointResponseBody = exports.CreateInputStreamWaitpointRequestBody = exports.CreateWaitpointTokenResponseBody = exports.CreateWaitpointTokenRequestBody = exports.TimePeriod = exports.SubscribeRealtimeStreamChunkRawShape = exports.RetrieveBatchV2Response = exports.RetrieveBatchResponse = exports.BatchStatus = void 0;
-exports.PromptOverrideCreatedResponseBody = exports.PromptOkResponseBody = exports.ReactivatePromptOverrideRequestBody = exports.UpdatePromptOverrideRequestBody = exports.CreatePromptOverrideRequestBody = exports.PromotePromptVersionRequestBody = exports.ListPromptVersionsResponseBody = void 0;
+exports.InitializeDeploymentRequestBody = exports.InitializeDeploymentResponseBody = exports.CreateArtifactResponseBody = exports.CreateArtifactRequestBody = exports.UpsertBranchResponseBody = exports.UpsertBranchRequestBody = exports.DeploymentTriggeredVia = exports.ExternalBuildData = exports.CancelDeploymentRequestBody = exports.ProgressDeploymentRequestBody = exports.BuildServerMetadata = exports.FinalizeDeploymentRequestBody = exports.StartDeploymentIndexingResponseBody = exports.StartDeploymentIndexingRequestBody = exports.GetEnvironmentVariablesResponseBody = exports.RescheduleRunRequestBody = exports.AddTagsRequestBody = exports.GetBatchResponseBody = exports.BatchTriggerTaskResponse = exports.StreamBatchItemsResponse = exports.BatchItemNDJSON = exports.CreateBatchResponse = exports.CreateBatchRequestBody = exports.BatchTriggerTaskV3Response = exports.BatchTriggerTaskV3RequestBody = exports.BatchTriggerTaskV2Response = exports.BatchTriggerTaskV2RequestBody = exports.BatchTriggerTaskItem = exports.BatchTriggerTaskRequestBody = exports.TriggerTaskResponse = exports.TriggerTaskRequestBody = exports.IdempotencyKeyOptionsSchema = exports.RunTags = exports.CreateBackgroundWorkerResponse = exports.CreateBackgroundWorkerRequestBody = exports.GetJWTResponse = exports.GetJWTRequestBody = exports.GetWorkerByTagResponse = exports.GetWorkerTaskResponse = exports.GetProjectEnvironmentsResponseBody = exports.ProjectEnvironment = exports.GetProjectEnvResponse = exports.CreateProjectRequestBody = exports.CreateOrgResponseBody = exports.CreateOrgRequestBody = exports.GetOrgsResponseBody = exports.GetProjectsResponseBody = exports.GetProjectResponseBody = exports.WhoAmIResponseSchema = exports.RunEngineVersion = void 0;
+exports.ListBulkActionsResponseBody = exports.AbortBulkActionResponseBody = exports.CreateBulkActionResponseBody = exports.BulkActionObject = exports.BulkActionType = exports.BulkActionStatus = exports.CreateBulkActionRequestBody = exports.ListRunResponse = exports.ListRunResponseItem = exports.RetrieveRunResponse = exports.RelatedRunDetails = exports.TriggerFunction = exports.RunScheduleDetails = exports.RunEnvironmentDetails = exports.AttemptStatus = exports.RunStatus = exports.TimezonesResult = exports.ListScheduleOptions = exports.ListSchedulesResult = exports.DeletedScheduleObject = exports.ScheduleObject = exports.ScheduleGenerator = exports.UpdateScheduleOptions = exports.CreateScheduleOptions = exports.ScheduledTaskPayload = exports.ScheduleType = exports.ResetIdempotencyKeyResponse = exports.CanceledRunResponse = exports.ReplayRunResponse = exports.DevDisconnectResponseBody = exports.DevDisconnectRequestBody = exports.DevDequeueResponseBody = exports.DevDequeueRequestBody = exports.DevConfigResponseBody = exports.WorkersCreateResponseBody = exports.WorkersCreateRequestBody = exports.WorkersListResponseBody = exports.CreateUploadPayloadUrlResponseBody = exports.DeploymentEventFromString = exports.DeploymentEvent = exports.DeploymentFinalizedEvent = exports.DeploymentLogEvent = exports.GetLatestDeploymentResponseBody = exports.GetDeploymentResponseBody = exports.PromoteDeploymentResponseBody = exports.FailDeploymentResponseBody = exports.FailDeploymentRequestBody = exports.DeploymentErrorData = exports.GenerateRegistryCredentialsResponseBody = exports.RemoteBuildProviderStatusResponseBody = void 0;
+exports.ApiDeploymentListResponseItem = exports.ApiDeploymentListSearchParams = exports.ApiDeploymentListOptions = exports.ApiDeploymentListParams = exports.WaitForDurationResponseBody = exports.WaitForDurationRequestBody = exports.WaitForWaitpointTokenResponseBody = exports.CompleteWaitpointTokenResponseBody = exports.ListSessionsResponseBody = exports.ListedSessionItem = exports.ListSessionsOptions = exports.ListSessionsQueryParams = exports.SessionStatus = exports.CloseSessionRequestBody = exports.UpdateSessionRequestBody = exports.EndAndContinueSessionResponseBody = exports.EndAndContinueSessionRequestBody = exports.RetrieveSessionResponseBody = exports.CreatedSessionResponseBody = exports.SessionItem = exports.CreateSessionRequestBody = exports.SessionTriggerConfig = exports.CompleteWaitpointTokenRequestBody = exports.WaitpointRetrieveTokenResponse = exports.WaitpointListTokenItem = exports.WaitpointTokenItem = exports.WaitpointTokenStatus = exports.waitpointTokenStatuses = exports.CreateSessionStreamWaitpointResponseBody = exports.CreateSessionStreamWaitpointRequestBody = exports.CreateInputStreamWaitpointResponseBody = exports.CreateInputStreamWaitpointRequestBody = exports.CreateWaitpointTokenResponseBody = exports.CreateWaitpointTokenRequestBody = exports.TimePeriod = exports.SubscribeRealtimeStreamChunkRawShape = exports.RetrieveBatchV2Response = exports.RetrieveBatchResponse = exports.BatchStatus = exports.SubscribeRunRawShape = exports.UpdateMetadataResponseBody = exports.UpdateMetadataRequestBody = exports.EnvironmentVariableWithSecret = exports.EnvironmentVariables = exports.EnvironmentVariable = exports.EnvironmentVariableValue = exports.EnvironmentVariableResponseBody = exports.ImportEnvironmentVariablesRequestBody = exports.UpdateEnvironmentVariableRequestBody = exports.CreateEnvironmentVariableRequestBody = void 0;
+exports.PromptOverrideCreatedResponseBody = exports.PromptOkResponseBody = exports.ReactivatePromptOverrideRequestBody = exports.UpdatePromptOverrideRequestBody = exports.CreatePromptOverrideRequestBody = exports.PromotePromptVersionRequestBody = exports.ListPromptVersionsResponseBody = exports.ListPromptsResponseBody = exports.ResolvePromptResponseBody = exports.ResolvePromptRequestBody = exports.ReadSessionStreamRecordsResponseBody = exports.SendInputStreamResponseBody = exports.AppendToStreamResponseBody = exports.CreateStreamResponseBody = exports.RetrieveSpanDetailResponseBody = exports.RetrieveRunTraceResponseBody = exports.RetrieveRunTraceSpan = exports.RetrieveRunTraceSpanSchema = exports.ApiBranchListResponseBody = exports.RetrieveCurrentDeploymentResponseBody = void 0;
 exports.isWaitpointOutputTimeout = isWaitpointOutputTimeout;
 exports.timeoutError = timeoutError;
 const zod_1 = require("zod");
@@ -11,6 +11,8 @@ const json_js_1 = require("../../schemas/json.js");
 const common_js_1 = require("./common.js");
 const resources_js_1 = require("./resources.js");
 const runEngine_js_1 = require("./runEngine.js");
+const queues_js_1 = require("./queues.js");
+const schemas_js_1 = require("./schemas.js");
 exports.RunEngineVersion = zod_1.z.union([zod_1.z.literal("V1"), zod_1.z.literal("V2")]);
 exports.WhoAmIResponseSchema = zod_1.z.object({
     userId: zod_1.z.string(),
@@ -32,6 +34,10 @@ exports.GetProjectResponseBody = zod_1.z.object({
     name: zod_1.z.string(),
     slug: zod_1.z.string(),
     createdAt: zod_1.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: zod_1.z.string().nullable().optional(),
     organization: zod_1.z.object({
         id: zod_1.z.string(),
         title: zod_1.z.string(),
@@ -46,6 +52,17 @@ exports.GetOrgsResponseBody = zod_1.z.array(zod_1.z.object({
     slug: zod_1.z.string(),
     createdAt: zod_1.z.coerce.date(),
 }));
+exports.CreateOrgRequestBody = zod_1.z.object({
+    title: zod_1.z.string().trim().min(3).max(50),
+    companySize: zod_1.z.string().optional(),
+    companyUrl: zod_1.z.string().optional(),
+});
+exports.CreateOrgResponseBody = zod_1.z.object({
+    id: zod_1.z.string(),
+    title: zod_1.z.string(),
+    slug: zod_1.z.string(),
+    createdAt: zod_1.z.coerce.date(),
+});
 exports.CreateProjectRequestBody = zod_1.z.object({
     name: zod_1.z
         .string()
@@ -59,6 +76,17 @@ exports.GetProjectEnvResponse = zod_1.z.object({
     apiUrl: zod_1.z.string(),
     projectId: zod_1.z.string(),
 });
+exports.ProjectEnvironment = zod_1.z.object({
+    id: zod_1.z.string(),
+    /// The slug used as the environment identifier in env var endpoints (e.g. "dev", "stg", "prod", "preview")
+    slug: zod_1.z.string(),
+    type: zod_1.z.enum(["DEVELOPMENT", "STAGING", "PREVIEW", "PRODUCTION"]),
+    /// Whether this is the branchable parent (preview); individual branches are not returned
+    isBranchableEnvironment: zod_1.z.boolean(),
+    branchName: zod_1.z.string().nullable(),
+    paused: zod_1.z.boolean(),
+});
+exports.GetProjectEnvironmentsResponseBody = zod_1.z.array(exports.ProjectEnvironment);
 // Zod schema for the response body type
 exports.GetWorkerTaskResponse = zod_1.z.object({
     id: zod_1.z.string(),
@@ -67,6 +95,7 @@ exports.GetWorkerTaskResponse = zod_1.z.object({
     triggerSource: zod_1.z.string(),
     createdAt: zod_1.z.coerce.date(),
     payloadSchema: zod_1.z.any().nullish(),
+    queueConfig: zod_1.z.any().nullish(),
 });
 exports.GetWorkerByTagResponse = zod_1.z.object({
     worker: zod_1.z.object({
@@ -113,7 +142,13 @@ exports.IdempotencyKeyOptionsSchema = zod_1.z.object({
     key: zod_1.z.string(),
     scope: zod_1.z.enum(["run", "attempt", "global"]),
 });
-exports.TriggerTaskRequestBody = zod_1.z.object({
+// 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 = zod_1.z.union([zod_1.z.string(), zod_1.z.number()]).transform((value) => String(value));
+exports.TriggerTaskRequestBody = zod_1.z
+    .object({
     payload: zod_1.z.any(),
     context: zod_1.z.any(),
     options: zod_1.z
@@ -150,9 +185,15 @@ exports.TriggerTaskRequestBody = zod_1.z.object({
             concurrencyLimit: zod_1.z.number().int().optional(),
         })
             .optional(),
-        concurrencyKey: zod_1.z.string().optional(),
+        concurrencyKey: ConcurrencyKeySchema.optional(),
         delay: zod_1.z.string().or(zod_1.z.coerce.date()).optional(),
-        idempotencyKey: zod_1.z.string().optional(),
+        idempotencyKey: zod_1.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: zod_1.z.string().optional(),
         /** The original user-provided idempotency key and scope */
         idempotencyKeyOptions: exports.IdempotencyKeyOptionsSchema.optional(),
@@ -162,6 +203,12 @@ exports.TriggerTaskRequestBody = zod_1.z.object({
         metadata: zod_1.z.any(),
         metadataType: zod_1.z.string().optional(),
         payloadType: zod_1.z.string().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: zod_1.z.number().int().nonnegative().optional(),
         tags: exports.RunTags.optional(),
         test: zod_1.z.boolean().optional(),
         ttl: zod_1.z.string().or(zod_1.z.number().nonnegative().int()).optional(),
@@ -178,6 +225,18 @@ exports.TriggerTaskRequestBody = zod_1.z.object({
             .optional(),
     })
         .optional(),
+})
+    .superRefine((value, ctx) => {
+    if (value.options?.payloadType !== "application/store") {
+        return;
+    }
+    if (typeof value.payload !== "string" || value.payload.length === 0) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "payload must be a non-empty string when options.payloadType is application/store",
+            path: ["payload"],
+        });
+    }
 });
 exports.TriggerTaskResponse = zod_1.z.object({
     id: zod_1.z.string(),
@@ -193,9 +252,15 @@ exports.BatchTriggerTaskItem = zod_1.z.object({
     context: zod_1.z.any(),
     options: zod_1.z
         .object({
-        concurrencyKey: zod_1.z.string().optional(),
+        concurrencyKey: ConcurrencyKeySchema.optional(),
         delay: zod_1.z.string().or(zod_1.z.coerce.date()).optional(),
-        idempotencyKey: zod_1.z.string().optional(),
+        idempotencyKey: zod_1.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: zod_1.z.string().optional(),
         /** The original user-provided idempotency key and scope */
         idempotencyKeyOptions: exports.IdempotencyKeyOptionsSchema.optional(),
@@ -207,6 +272,8 @@ exports.BatchTriggerTaskItem = zod_1.z.object({
         metadataType: zod_1.z.string().optional(),
         parentAttempt: zod_1.z.string().optional(),
         payloadType: zod_1.z.string().optional(),
+        /** Byte size of the (pre-offload) serialized payload for this item. */
+        payloadSize: zod_1.z.number().int().nonnegative().optional(),
         queue: zod_1.z
             .object({
             name: zod_1.z.string(),
@@ -281,12 +348,20 @@ exports.BatchTriggerTaskV3Response = zod_1.z.object({
 exports.CreateBatchRequestBody = zod_1.z.object({
     /** Expected number of items in the batch */
     runCount: zod_1.z.number().int().positive(),
+    /** Distinct task identifiers expected in the item stream */
+    taskIdentifiers: zod_1.z.array(zod_1.z.string().min(1)).min(1).optional(),
     /** Parent run ID for batchTriggerAndWait (friendly ID) */
     parentRunId: zod_1.z.string().optional(),
     /** Whether to resume parent on completion (true for batchTriggerAndWait) */
     resumeParentOnCompletion: zod_1.z.boolean().optional(),
     /** Idempotency key for the batch */
-    idempotencyKey: zod_1.z.string().optional(),
+    idempotencyKey: zod_1.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: exports.IdempotencyKeyOptionsSchema.optional(),
 });
@@ -305,7 +380,12 @@ exports.CreateBatchResponse = zod_1.z.object({
 });
 /**
  * Phase 2: Individual item in the NDJSON stream
- * Each line in the NDJSON body should match this schema
+ * 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.unknown()) and
+ * let invalid values (e.g. numeric concurrencyKey) reach Prisma.
  */
 exports.BatchItemNDJSON = zod_1.z.object({
     /** Zero-based index of this item (used for idempotency and ordering) */
@@ -315,7 +395,7 @@ exports.BatchItemNDJSON = zod_1.z.object({
     /** The payload for this task run */
     payload: zod_1.z.unknown().optional(),
     /** Options for this specific item */
-    options: zod_1.z.record(zod_1.z.unknown()).optional(),
+    options: exports.BatchTriggerTaskItem.shape.options,
 });
 /**
  * Phase 2: Stream items response
@@ -414,7 +494,7 @@ exports.DeploymentTriggeredVia = zod_1.z
 // They are re-exported through the schemas barrel (index.ts)
 exports.UpsertBranchRequestBody = zod_1.z.object({
     git: common_js_1.GitMeta.optional(),
-    env: zod_1.z.enum(["preview"]),
+    env: zod_1.z.enum(["preview", "development"]),
     branch: zod_1.z.string(),
 });
 exports.UpsertBranchResponseBody = zod_1.z.object({
@@ -714,6 +794,13 @@ exports.CreateScheduleOptions = zod_1.z.object({
      *
      */
     timezone: zod_1.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: schemas_js_1.ScheduleWindow.optional(),
 });
 exports.UpdateScheduleOptions = exports.CreateScheduleOptions.omit({ deduplicationKey: true });
 exports.ScheduleGenerator = zod_1.z.object({
@@ -730,7 +817,11 @@ exports.ScheduleObject = zod_1.z.object({
     externalId: zod_1.z.string().nullish(),
     generator: exports.ScheduleGenerator,
     timezone: zod_1.z.string(),
+    window: schemas_js_1.ScheduleWindow.optional(),
+    /** The next nominal CRON time. */
     nextRun: zod_1.z.coerce.date().nullish(),
+    /** The stable assigned time for the next nominal CRON time. */
+    nextRunEffectiveAt: zod_1.z.coerce.date().nullish(),
     environments: zod_1.z.array(zod_1.z.object({
         id: zod_1.z.string(),
         type: zod_1.z.string(),
@@ -834,6 +925,8 @@ const CommonRunFields = {
     baseCostInCents: zod_1.z.number(),
     durationMs: zod_1.z.number(),
     metadata: zod_1.z.record(zod_1.z.any()).optional(),
+    taskKind: zod_1.z.string().optional(),
+    region: zod_1.z.string().optional(),
 };
 const RetrieveRunCommandFields = {
     ...CommonRunFields,
@@ -868,9 +961,97 @@ exports.ListRunResponse = zod_1.z.object({
         previous: zod_1.z.string().optional(),
     }),
 });
+const StringOrStringArray = zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]);
+const MachineOrMachineArray = zod_1.z.union([common_js_1.MachinePresetName, zod_1.z.array(common_js_1.MachinePresetName)]);
+const QueueOrQueueArray = zod_1.z.union([queues_js_1.QueueTypeName, zod_1.z.array(queues_js_1.QueueTypeName)]);
+const DateOrNumber = zod_1.z.union([zod_1.z.coerce.date(), zod_1.z.number()]);
+const BulkActionFilterRequestBody = zod_1.z
+    .object({
+    status: zod_1.z.union([exports.RunStatus, zod_1.z.array(exports.RunStatus)]).optional(),
+    taskIdentifier: StringOrStringArray.optional(),
+    version: StringOrStringArray.optional(),
+    from: DateOrNumber.optional(),
+    to: DateOrNumber.optional(),
+    period: zod_1.z.string().optional(),
+    bulkAction: zod_1.z.string().optional(),
+    tag: StringOrStringArray.optional(),
+    schedule: zod_1.z.string().optional(),
+    isTest: zod_1.z.boolean().optional(),
+    batch: zod_1.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: zod_1.z.array(zod_1.z.string()).min(1).optional(),
+    name: zod_1.z.string().max(255, "Name must be less than 255 characters").optional(),
+};
+exports.CreateBulkActionRequestBody = zod_1.z
+    .discriminatedUnion("action", [
+    zod_1.z.object({
+        action: zod_1.z.literal("cancel"),
+        targetRegion: zod_1.z.never().optional(),
+        ...BulkActionSelectionRequestBody,
+    }),
+    zod_1.z.object({
+        action: zod_1.z.literal("replay"),
+        targetRegion: zod_1.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",
+});
+exports.BulkActionStatus = zod_1.z.enum(["PENDING", "COMPLETED", "ABORTED"]);
+exports.BulkActionType = zod_1.z.enum(["CANCEL", "REPLAY"]);
+exports.BulkActionObject = zod_1.z.object({
+    id: zod_1.z.string(),
+    name: zod_1.z.string().optional(),
+    type: exports.BulkActionType,
+    status: exports.BulkActionStatus,
+    counts: zod_1.z.object({
+        total: zod_1.z.number(),
+        success: zod_1.z.number(),
+        failure: zod_1.z.number(),
+    }),
+    createdAt: zod_1.z.coerce.date(),
+    completedAt: zod_1.z.coerce.date().optional(),
+});
+exports.CreateBulkActionResponseBody = zod_1.z.object({
+    id: zod_1.z.string(),
+});
+exports.AbortBulkActionResponseBody = zod_1.z.object({
+    id: zod_1.z.string(),
+});
+exports.ListBulkActionsResponseBody = zod_1.z.object({
+    data: zod_1.z.array(exports.BulkActionObject),
+    pagination: zod_1.z.object({
+        next: zod_1.z.string().optional(),
+        previous: zod_1.z.string().optional(),
+    }),
+});
 exports.CreateEnvironmentVariableRequestBody = zod_1.z.object({
     name: zod_1.z.string(),
     value: zod_1.z.string(),
+    // When omitted, the variable defaults to non-secret (the DB default is false).
+    isSecret: zod_1.z.boolean().optional(),
 });
 exports.UpdateEnvironmentVariableRequestBody = zod_1.z.object({
     value: zod_1.z.string(),
@@ -879,6 +1060,8 @@ exports.ImportEnvironmentVariablesRequestBody = zod_1.z.object({
     variables: zod_1.z.record(zod_1.z.string()),
     parentVariables: zod_1.z.record(zod_1.z.string()).optional(),
     override: zod_1.z.boolean().optional(),
+    // When omitted, variables default to non-secret (the DB default is false).
+    isSecret: zod_1.z.boolean().optional(),
     source: zod_1.z
         .discriminatedUnion("type", [
         zod_1.z.object({ type: zod_1.z.literal("user"), userId: zod_1.z.string() }),
@@ -1002,7 +1185,13 @@ exports.CreateWaitpointTokenRequestBody = zod_1.z.object({
      *
      * Note: This waitpoint may already be complete, in which case when you wait for it, it will immediately continue.
      */
-    idempotencyKey: zod_1.z.string().optional(),
+    idempotencyKey: zod_1.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.
@@ -1037,7 +1226,13 @@ exports.CreateWaitpointTokenResponseBody = zod_1.z.object({
 exports.CreateInputStreamWaitpointRequestBody = zod_1.z.object({
     streamId: zod_1.z.string(),
     timeout: zod_1.z.string().optional(),
-    idempotencyKey: zod_1.z.string().optional(),
+    idempotencyKey: zod_1.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: zod_1.z.string().optional(),
     tags: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional(),
     /**
@@ -1062,7 +1257,13 @@ exports.CreateSessionStreamWaitpointRequestBody = zod_1.z.object({
     session: zod_1.z.string(),
     io: zod_1.z.enum(["out", "in"]),
     timeout: zod_1.z.string().optional(),
-    idempotencyKey: zod_1.z.string().optional(),
+    idempotencyKey: zod_1.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: zod_1.z.string().optional(),
     tags: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).optional(),
     /**
@@ -1114,6 +1315,12 @@ exports.SessionTriggerConfig = zod_1.z.object({
     queue: zod_1.z.string().max(128).optional(),
     tags: zod_1.z.array(zod_1.z.string().max(128)).max(5).optional(),
     maxAttempts: zod_1.z.number().int().positive().max(10).optional(),
+    /** Per-run wall-clock cap (seconds). Forwarded to `TaskRunOptions.maxDuration`. */
+    maxDuration: zod_1.z.number().int().positive().optional(),
+    /** Pin every run to a specific worker version. Forwarded to `TaskRunOptions.lockToVersion`. */
+    lockToVersion: zod_1.z.string().optional(),
+    /** Region to schedule runs in. Forwarded to `TaskRunOptions.region`. */
+    region: zod_1.z.string().optional(),
     /** Convenience field surfaced to chat.agent via the wire payload. */
     idleTimeoutInSeconds: zod_1.z.number().int().positive().max(3600).optional(),
 });
@@ -1293,7 +1500,13 @@ exports.WaitForDurationRequestBody = zod_1.z.object({
      *
      * Note: This waitpoint may already be complete, in which case when you wait for it, it will immediately continue.
      */
-    idempotencyKey: zod_1.z.string().optional(),
+    idempotencyKey: zod_1.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.
@@ -1320,7 +1533,7 @@ function isWaitpointOutputTimeout(output) {
         const json = JSON.parse(output);
         return json.code === WAITPOINT_TIMEOUT_ERROR_CODE;
     }
-    catch (e) {
+    catch (_e) {
         return false;
     }
 }
@@ -1380,6 +1593,7 @@ exports.ApiDeploymentListResponseItem = zod_1.z.object({
     git: zod_1.z.record(zod_1.z.any()).optional(),
     error: exports.DeploymentErrorData.optional(),
 });
+exports.RetrieveCurrentDeploymentResponseBody = exports.ApiDeploymentListResponseItem;
 exports.ApiBranchListResponseBody = zod_1.z.object({
     branches: zod_1.z.array(zod_1.z.object({
         id: zod_1.z.string(),
@@ -1448,6 +1662,8 @@ exports.RetrieveSpanDetailResponseBody = zod_1.z.object({
         inputCost: zod_1.z.number().optional(),
         outputCost: zod_1.z.number().optional(),
         totalCost: zod_1.z.number().optional(),
+        cachedCost: zod_1.z.number().optional(),
+        cacheCreationCost: zod_1.z.number().optional(),
         tokensPerSecond: zod_1.z.number().optional(),
         msToFirstChunk: zod_1.z.number().optional(),
         durationMs: zod_1.z.number(),
@@ -1474,6 +1690,33 @@ exports.AppendToStreamResponseBody = zod_1.z.object({
 exports.SendInputStreamResponseBody = zod_1.z.object({
     ok: zod_1.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.
+ */
+exports.ReadSessionStreamRecordsResponseBody = zod_1.z.object({
+    records: zod_1.z.array(zod_1.z.object({
+        data: zod_1.z.unknown(),
+        id: zod_1.z.string(),
+        seqNum: zod_1.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: zod_1.z.array(zod_1.z.tuple([zod_1.z.string(), zod_1.z.string()])).optional(),
+    })),
+});
 exports.ResolvePromptRequestBody = zod_1.z.object({
     variables: zod_1.z.record(zod_1.z.unknown()).default({}),
     label: zod_1.z.string().optional(),