@deepraxis/sdk 0.1.1-dev.eb022f5 → 0.1.1-dev.ec2a9a1

package/dist/generated/types.gen.d.ts

@@ -1020,9 +1020,9 @@ export type OwnFileCreateFileRequest = {
      */
     file: Blob | File;
     /**
-     * Purpose label stored with the file: user_data or vision. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data.
+     * Purpose label stored with the file: user_data, assistants or vision. The label is stored and returned unchanged; assistants follows the same rules as user_data. The vision purpose accepts only PNG, JPEG, GIF and WebP images. Conversation image references require user_data.
      */
-    purpose: 'user_data' | 'vision';
+    purpose: 'user_data' | 'assistants' | 'vision';
     expires_after?: OwnFileFileExpirationAfter;
 };
 /**
@@ -1058,7 +1058,7 @@ export type OwnFileOpenAiFile = {
     /**
      * Upload purpose. Image references in conversations require user_data.
      */
-    purpose: 'user_data' | 'vision';
+    purpose: 'user_data' | 'assistants' | 'vision';
     /**
      * Deprecated. The current status of the file, which can be either `uploaded`, `processed`, or `error`.
      *
@@ -1156,9 +1156,9 @@ export type OwnFilePraxisCreateUpload = {
      */
     mime_type: string;
     /**
-     * Use user_data for conversation attachments, or vision for PNG, JPEG, GIF and WebP images.
+     * Use user_data for conversation attachments, assistants for assistant files, or vision for PNG, JPEG, GIF and WebP images.
      */
-    purpose: 'user_data' | 'vision';
+    purpose: 'user_data' | 'assistants' | 'vision';
     /**
      * Optional expiry policy for the resulting file; omission retains the file until deletion.
      */
@@ -1203,9 +1203,9 @@ export type OwnFilePraxisUpload = {
      */
     filename: string;
     /**
-     * File purpose: user_data for conversation attachments, vision for images.
+     * File purpose: user_data for conversation attachments, assistants for assistant files, vision for images.
      */
-    purpose: 'user_data' | 'vision';
+    purpose: 'user_data' | 'assistants' | 'vision';
     /**
      * Upload state: pending accepts parts; completed has a file; cancelled was cancelled; expired exceeded its one-hour lifetime.
      */
@@ -1282,9 +1282,9 @@ export type OwnFileSignedUploadRequest = {
      */
     content_type: string;
     /**
-     * user_data stores ordinary files and conversation images; vision accepts PNG, JPEG, GIF or WebP images only. Omitted means user_data.
+     * user_data and assistants store ordinary files and conversation images with their original purpose label; vision accepts PNG, JPEG, GIF or WebP images only. Omitted means user_data.
      */
-    purpose?: 'user_data' | 'vision';
+    purpose?: 'user_data' | 'assistants' | 'vision';
     /**
      * Lifetime in seconds, from 1 through 604800: defaults to 900 for single PUT or 3600 for multipart. All part URLs and the completion URL share one expiry. This does not set the resulting file's lifetime.
      */
@@ -12774,6 +12774,10 @@ export type CutFramesResult = {
     images: {
         [key: string]: CutRenderRef;
     };
+    /**
+     * Frame delivery warnings; empty when every requested source frame was available.
+     */
+    warnings: Array<CutFrameWarning>;
 };
 /**
  * Analysis status and available ranges for each source asset and kind.
@@ -12789,13 +12793,17 @@ export type CutAnalysisResult = {
          */
         version: number;
         /**
-         * silence identifies quiet spans; filler identifies filler-word spans; scenes identifies scene ranges.
+         * silence identifies transcript-based speech pauses, not music or loudness; filler identifies filler-word spans; scenes identifies scene ranges.
          */
         kind: 'silence' | 'filler' | 'scenes';
         /**
-         * pending means analysis is still running; ready means segments are available; unsupported means this asset or analysis kind is inapplicable; failed means analysis did not complete.
+         * pending means analysis is still running; ready means analysis completed, including an empty no_speech result; unsupported means no usable transcript or this analysis kind is inapplicable; failed means analysis did not complete.
          */
         status: 'pending' | 'ready' | 'unsupported' | 'failed';
+        /**
+         * no_speech means a completed current-version transcript contains no words (ready with empty segments); no_transcript means no completed current-version transcript is available (unsupported). Failed transcriptions remain failed.
+         */
+        reason?: 'no_speech' | 'no_transcript';
         /**
          * Detected source ranges in seconds, available when status is ready.
          */
@@ -12988,6 +12996,14 @@ export type CutExport = {
          * Destination media library identifier.
          */
         library_id: string;
+        /**
+         * Frozen destination path within the library, when supplied.
+         */
+        folder?: string;
+        /**
+         * Frozen sanitized display name, when supplied.
+         */
+        name?: string;
     };
     /**
      * Rendering progress; partial progress is not successful completion.
@@ -13006,6 +13022,27 @@ export type CutExport = {
          */
         audio: 'pending' | 'done';
     };
+    /**
+     * Present when normalization was requested; contains requested targets and measured output levels.
+     */
+    loudness?: {
+        /**
+         * Requested integrated loudness target in LUFS.
+         */
+        target_lufs: number;
+        /**
+         * Requested maximum true peak in dBTP.
+         */
+        true_peak_dbtp: number;
+        /**
+         * Measured integrated loudness of the rendered export in LUFS.
+         */
+        integrated_lufs: number;
+        /**
+         * Measured maximum true peak of the rendered export in dBTP.
+         */
+        measured_true_peak_dbtp: number;
+    };
     /**
      * Output media reference, available after the export reaches done.
      */
@@ -13027,9 +13064,22 @@ export type CutExport = {
          */
         chunk?: number;
         /**
-         * Optional lower-level explanation of the render failure.
+         * Safe structured downstream failure information; older jobs may contain a string.
+         */
+        cause?: string | {
+            /**
+             * Export stage that failed.
+             */
+            stage: string;
+            /**
+             * Downstream service error code, when available.
+             */
+            code?: string;
+        };
+        /**
+         * Downstream request identifier, when supplied by the service error.
          */
-        cause?: string;
+        request_id?: string;
     };
     /**
      * ISO 8601 timestamp when this export was accepted.
@@ -13048,6 +13098,14 @@ export type CutExport = {
  * Start an export from a project revision into a bound library.
  */
 export type CutExportInput = {
+    /**
+     * Optional destination path within the bound media library; omitted uses its default folder.
+     */
+    folder?: string;
+    /**
+     * Nonempty display name, frozen with the export. Path separators and control characters become hyphens; limited to 200 characters. Omitted uses project name and timestamp.
+     */
+    name?: string;
     /**
      * Optional render settings; omitted fields use the project export defaults.
      */
@@ -13057,6 +13115,19 @@ export type CutExportInput = {
      */
     binding?: string;
     revision?: CutRevision;
+    /**
+     * Optional loudness normalization target; normalization adds analysis and rendering work.
+     */
+    loudness?: {
+        /**
+         * Integrated loudness target in LUFS.
+         */
+        target_lufs: number;
+        /**
+         * Maximum true peak in dBTP.
+         */
+        true_peak_dbtp: number;
+    };
 };
 /**
  * One page of organization-accessible exports.
@@ -13583,7 +13654,7 @@ export type KnowledgeNativeCreateVectorStore = {
      * Existing File IDs to attach; the store allows up to 10,000 files.
      */
     file_ids?: Array<string>;
-    chunking_strategy?: KnowledgeChunkingInput;
+    chunking_strategy?: KnowledgeNativeChunkingInput;
     /**
      * Accepted but not saved or returned; its type is not validated.
      */
@@ -13747,7 +13818,7 @@ export type KnowledgeNativeVectorStoreFile = {
      * Unix timestamp in seconds.
      */
     created_at: number;
-    chunking_strategy: KnowledgeChunking;
+    chunking_strategy: KnowledgeNativeChunking;
     /**
      * File attributes used for search filtering; null means no attributes are set.
      */
@@ -13757,7 +13828,7 @@ export type KnowledgeNativeVectorStoreFile = {
      */
     praxis?: {
         /**
-         * Specific ingestion failure: file_too_large exceeds 50 MiB; encrypted requires an unencrypted source; empty has no extractable text; unsupported_type needs a supported format; token_limit exceeds 5000000 estimated tokens; recognition_unavailable exhausted OCR retries; deadline_exceeded reached the ingestion or conversion deadline; internal is an unexpected provider or processing error. last_error retains the compatible code and an actionable message.
+         * Specific ingestion failure: file_too_large exceeds 512 MiB for PDFs or 50 MiB for other formats (the Router conversion limit); encrypted requires an unencrypted source; empty has no extractable text; unsupported_type needs a supported format; token_limit exceeds 5000000 estimated tokens; recognition_unavailable exhausted OCR retries; deadline_exceeded reached the ingestion or conversion deadline; internal is an unexpected provider or processing error. last_error retains the compatible code and an actionable message.
          */
         failure_reason?: 'file_too_large' | 'encrypted' | 'empty' | 'unsupported_type' | 'token_limit' | 'recognition_unavailable' | 'deadline_exceeded' | 'internal';
         /**
@@ -13794,7 +13865,7 @@ export type KnowledgeNativeVectorStoreFile = {
         chunk_count: number;
     };
 };
-export type KnowledgeAttachFile = {
+export type KnowledgeNativeAttachFile = {
     /**
      * Existing source File ID returned by file upload; the file must be visible to the caller.
      */
@@ -13803,7 +13874,7 @@ export type KnowledgeAttachFile = {
      * Search-filter attributes for a newly attached file; omission or null leaves attributes unset. Reattaching an existing file does not change them.
      */
     attributes?: KnowledgeAttributes | null;
-    chunking_strategy?: KnowledgeChunkingInput;
+    chunking_strategy?: KnowledgeNativeChunkingInput;
 };
 export type KnowledgeNativeVectorStoreFileList = {
     /**
@@ -13900,7 +13971,7 @@ export type KnowledgeFileBatch = {
 /**
  * Provide exactly one of file_ids or files. Already attached files are reused without changing their attributes or chunking.
  */
-export type KnowledgeCreateBatch = {
+export type KnowledgeNativeCreateBatch = {
     /**
      * Existing File IDs to attach with shared attributes and chunking settings. Supply file_ids or files, never both.
      */
@@ -13909,7 +13980,7 @@ export type KnowledgeCreateBatch = {
      * Search-filter attributes applied to each newly attached file; omission or null leaves them unset.
      */
     attributes?: KnowledgeAttributes | null;
-    chunking_strategy?: KnowledgeChunkingInput;
+    chunking_strategy?: KnowledgeNativeChunkingInput;
 } | {
     /**
      * Files to attach with individual attributes and chunking settings; top-level attributes and chunking_strategy are ignored.
@@ -13920,7 +13991,7 @@ export type KnowledgeCreateBatch = {
          */
         file_id: string;
         attributes?: KnowledgeAttributes;
-        chunking_strategy?: KnowledgeChunkingInput;
+        chunking_strategy?: KnowledgeNativeChunkingInput;
     }>;
     /**
      * Ignored when files is supplied.
@@ -14039,6 +14110,10 @@ export type KnowledgeEventList = {
  * A caller-owned media library with lifecycle, usage, understanding settings and model selections.
  */
 export type MediaLibrary = {
+    /**
+     * Correction vocabulary, at most 200 nonblank terms of at most 32 Unicode characters each. Omitted on an unconfigured library: correction derives up to 200 distinct names from the library name and every folder level, excluding generic names such as 原始素材 and 混剪成品. An explicit empty array disables this vocabulary. Updating affects subsequent understanding and explicit reprocessing, not existing results.
+     */
+    readonly hotwords?: Array<string>;
     /**
      * Current understanding progress for active and deleting libraries. Counts exclude deleted assets; migration_complete is false until historical assets have been counted.
      */
@@ -14105,7 +14180,7 @@ export type MediaLibrary = {
 };
 export type MediaMediaError = {
     error: {
-        code: 'LIBRARY_NOT_FOUND' | 'ASSET_NOT_FOUND' | 'JOB_NOT_FOUND' | 'UNDERSTANDING_NOT_FOUND' | 'ASSET_VERSION_CHANGED' | 'LIBRARY_INVALID_STATE' | 'INVALID_PARAMS' | 'INVALID_EXPRESSION' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'FILE_TOO_LARGE' | 'FILE_EMPTY' | 'UNSUPPORTED_MEDIA' | 'FETCH_FAILED' | 'LIMIT_EXCEEDED' | 'CHUNK_INVALID' | 'RATE_LIMITED' | 'CAPACITY' | 'UPSTREAM_FAILED' | 'BINDING_READ_ONLY';
+        code: 'LIBRARY_NOT_FOUND' | 'ASSET_NOT_FOUND' | 'JOB_NOT_FOUND' | 'UNDERSTANDING_NOT_FOUND' | 'ASSET_VERSION_CHANGED' | 'LIBRARY_INVALID_STATE' | 'INVALID_PARAMS' | 'INVALID_EXPRESSION' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'FILE_TOO_LARGE' | 'FILE_EMPTY' | 'UNSUPPORTED_MEDIA' | 'FETCH_FAILED' | 'LIMIT_EXCEEDED' | 'CHUNK_INVALID' | 'RATE_LIMITED' | 'CAPACITY' | 'UPSTREAM_FAILED' | 'CONTENT_REJECTED' | 'GENERATION_FAILED' | 'CANDIDATE_EXPIRED' | 'BINDING_READ_ONLY';
         message: string;
         details: string | null;
     };
@@ -14123,9 +14198,21 @@ export type MediaMediaModelsInput = {
      */
     embedding?: string | null;
     /**
-     * Model call ID for speech transcription. Null restores the default for this role.
+     * Model call ID for speech transcription. Null restores the default for this role. Defaults to fun-asr with whisper-large-v3-turbo fallback.
      */
     transcription?: string | null;
+    /**
+     * Model call ID for conservative transcript spelling correction; defaults to qwen3.8-flash. The model must support chat completions. Null restores this role’s default.
+     */
+    correction?: string | null;
+    /**
+     * Model call ID for optional full-text reference ASR; defaults to qwen3-asr-flash. Reference failures do not block correction. Null restores this role’s default.
+     */
+    reference_transcription?: string | null;
+    /**
+     * Model call ID for audio understanding; defaults to qwen3.8-omni-flash. Analyzes at most the first 120 seconds in up to three windows of at most 40 seconds, with at most three metered model calls per asset. BPM is an estimate; has_music=false only means no music was detected in the analyzed ranges. Null restores this role’s default.
+     */
+    audio?: string | null;
 } | null;
 /**
  * Libraries in this page, ordered by creation time descending.
@@ -14140,6 +14227,25 @@ export type MediaLibraryPage = MediaPage & {
      */
     next_cursor: string | null;
 };
+export type MediaFrameUrls = {
+    /**
+     * Frame links in the same order as the requested timestamps, including duplicates.
+     */
+    frames: Array<{
+        /**
+         * Requested time in microseconds from the start of the video.
+         */
+        at_micros: number;
+        /**
+         * JPEG delivery URL. Fetch it to extract the frame; authenticated links carry a bearer token and must not be shared beyond intended readers.
+         */
+        url: string;
+        /**
+         * UTC expiry for authenticated frame links, 300 seconds after issuance. Upload asset links remain public and permanent; this timestamp does not expire those URLs.
+         */
+        expires_at: string;
+    }>;
+};
 /**
  * Receipt confirming permanent removal of a previously deleted library.
  */
@@ -14299,7 +14405,7 @@ export type MediaAsset = {
      */
     url: string;
     /**
-     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the server includes a signature, so the original URL is ready to use. Request a delivery_tokens token for transformed URLs.
+     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the URL carries a single-file token that expires after 15 minutes, so it is ready to use but must not be stored; keep asset_id and read the asset again. Request a delivery_tokens token for transformed URLs.
      */
     secure_url: string;
     /**
@@ -14382,6 +14488,27 @@ export type MediaAsset = {
             };
         };
     };
+    /**
+     * Source details for the video-generation job that created this asset.
+     */
+    generation?: {
+        /**
+         * Job id that generated this asset.
+         */
+        job_id: MediaJobId;
+        /**
+         * Generation intent used to create the asset; v1 supports video.generate.
+         */
+        intent: string;
+        /**
+         * Text prompt submitted for the generation job.
+         */
+        prompt: string;
+        /**
+         * Router video-generation model that produced the asset.
+         */
+        model: string;
+    };
 };
 /**
  * Receipt confirming that the asset was deleted.
@@ -14408,6 +14535,10 @@ export type MediaUnderstandingPage = MediaPage & {
      * Opaque token to pass as cursor to listUnderstandings; null means no further page.
      */
     next_cursor: string | null;
+    /**
+     * Current-version video shots, repeated on every understanding page. Absent on legacy records, images and audio. New video processing with image-capable embedding samples at 1 fps, at most 600 frames, and produces at most 60 shots. Long clips increase the interval and merge adjacent short shots; sub-second cuts may be missed. Each shot uses one to three keyframes in one vision call. Text-only legacy embedding profiles retain frame-based processing.
+     */
+    readonly shots?: Array<MediaUnderstoodShot>;
 };
 /**
  * Expression-search page with match counts, elapsed time and optional facet counts.
@@ -14491,7 +14622,19 @@ export type MediaFolders = {
          * Number of assets in this folder and all descendant folders.
          */
         asset_count: number;
+        /**
+         * Active ready and partial assets in this folder and every descendant folder.
+         */
+        understood_count: number;
+        /**
+         * Active failed assets in this folder and every descendant folder.
+         */
+        failed_count: number;
     }>;
+    /**
+     * False while historical folder and failure counts are being populated; refresh after backfill completes.
+     */
+    counts_complete: boolean;
 };
 /**
  * Asynchronous batch job with successful and failed item counts.
@@ -14506,19 +14649,19 @@ export type MediaJob = {
      */
     library_id: MediaLibraryId;
     /**
-     * Batch operation: tag adds labels, untag removes labels, set_context replaces custom metadata, move changes asset_folder, and delete removes selected assets.
+     * Batch operation: tag adds labels, untag removes labels, set_context replaces custom metadata, move changes asset_folder, and delete removes selected assets. reprocess starts fenced understanding Workflows for retryable failed steps and legacy source-size unsupported steps; kinds narrows the selection. Other unsupported and permanent steps remain unchanged.
      */
-    action: 'tag' | 'untag' | 'set_context' | 'move' | 'delete';
+    action: 'tag' | 'untag' | 'set_context' | 'move' | 'delete' | 'reprocess' | 'generate';
     /**
      * Job status: queued awaits execution; running is processing items; completed means all items succeeded; completed_with_errors means some succeeded and some failed; failed means all selected items failed. An empty job completes successfully.
      */
-    status: 'queued' | 'running' | 'completed' | 'completed_with_errors' | 'failed';
+    status: MediaJobStatus;
     /**
      * Number of distinct assets selected when the job was created.
      */
     total: number;
     /**
-     * Number of items successfully processed; failed items are counted separately.
+     * Number of items successfully processed; failed items are counted separately. For reprocess, this counts accepted launches; inspect asset progress for model completion.
      */
     done: number;
     /**
@@ -14532,12 +14675,66 @@ export type MediaJob = {
         /**
          * Identifier supplied for the failed item; it may identify a missing asset.
          */
-        asset_id: MediaAssetId;
+        asset_id?: MediaAssetId;
+        /**
+         * Zero-based output index for a failed video-generation item.
+         */
+        index?: number;
         /**
          * Domain error code explaining the individual item failure.
          */
         code: MediaMediaErrorCode;
     }>;
+    /**
+     * Generation intent used by this job; v1 supports video.generate.
+     */
+    intent?: string;
+    /**
+     * Router video-generation model used for the outputs.
+     */
+    model?: string;
+    /**
+     * Per-video results in index order; save a successful candidate before expires_at.
+     */
+    outputs?: Array<{
+        /**
+         * Zero-based position of this video in the requested count.
+         */
+        index: number;
+        /**
+         * State of this requested video output.
+         */
+        status: MediaGenerationOutputStatus;
+        /**
+         * Short-lived signed URL for previewing this candidate; read the Job again to obtain a fresh URL.
+         */
+        preview_url?: string;
+        /**
+         * Router seed for this video, when returned; it may be absent.
+         */
+        seed?: number | null;
+        /**
+         * Candidate expiry time; after expiry, save returns CANDIDATE_EXPIRED.
+         */
+        expires_at?: MediaIsoTimestamp;
+        /**
+         * Library asset identifier after this candidate has been saved, or when the job requested save=library.
+         */
+        asset_id?: MediaAssetId;
+    }>;
+    /**
+     * Router-reported generation charge for the job.
+     */
+    usage?: {
+        /**
+         * Decimal amount in the currency named by currency; this is not a floating-point value.
+         */
+        amount: string;
+        /**
+         * Currency code for amount.
+         */
+        currency: string;
+    };
     /**
      * Time the batch job was created, in UTC.
      */
@@ -14584,6 +14781,15 @@ export type MediaBatchAction = {
      * Batch operation: tag adds labels, untag removes labels, set_context replaces custom metadata, move changes asset_folder, and delete removes selected assets.
      */
     action: 'delete';
+} | {
+    /**
+     * reprocess retries recoverable failed steps and legacy source-size unsupported steps; kinds narrows the selection. Other unsupported, permanent and completed steps remain unchanged.
+     */
+    action: 'reprocess';
+    /**
+     * Optional subset of processing kinds to inspect. Only retryable failed steps and legacy source-size unsupported steps run. Other unsupported, permanent and completed steps remain unchanged. Omit to inspect all recoverable steps.
+     */
+    kinds?: Array<MediaProcessingKind>;
 };
 /**
  * Select assets by ids or by expression, never both. Expression results and exclusions are resolved when the job is created.
@@ -14629,6 +14835,91 @@ export type MediaDeliveryToken = {
      */
     expires_at: string;
 };
+export type MediaFailureSummary = {
+    /**
+     * Number of current failed understanding entries, excluding deleted assets and superseded versions.
+     */
+    total: number;
+    /**
+     * Failure entries grouped by code, output kind and producer model. Each group includes up to five distinct example asset IDs.
+     */
+    groups: Array<MediaFailureGroup>;
+    /**
+     * False while historical failure and folder statistics are being populated. Counts include current writes immediately.
+     */
+    counts_complete: boolean;
+};
+/**
+ * Current state of a batch or video-generation job.
+ */
+export type MediaJobStatus = 'queued' | 'running' | 'completed' | 'completed_with_errors' | 'failed' | 'cancelled';
+/**
+ * Identifier returned when a batch job is created.
+ */
+export type MediaJobId = string;
+/**
+ * A page of jobs in a library.
+ */
+export type MediaJobPage = {
+    /**
+     * Jobs returned in this page.
+     */
+    data: Array<MediaJob>;
+    /**
+     * Cursor for the next page, or null when there are no more jobs.
+     */
+    next_cursor: MediaJobId | null;
+};
+/**
+ * Current text-to-video options, concurrency and candidate retention. Generation is charged per second; unsaved candidates expire after 7 days.
+ */
+export type MediaGenerationCapabilities = {
+    /**
+     * Text-to-video intents currently supported by Media.
+     */
+    intents: Array<string>;
+    /**
+     * Model selected when model is omitted from a generation request.
+     */
+    default_model: string;
+    /**
+     * Allowed number of videos per generation job.
+     */
+    count: {
+        /**
+         * Minimum number of videos in one generation job.
+         */
+        minimum: number;
+        /**
+         * Maximum number of videos in one generation job.
+         */
+        maximum: number;
+    };
+    /**
+     * Durations in seconds supported by the default video model.
+     */
+    duration_seconds: Array<number>;
+    /**
+     * Aspect ratios supported by the default video model.
+     */
+    aspect_ratios: Array<string>;
+    /**
+     * Aspect ratio used when aspect_ratio is omitted.
+     */
+    default_aspect_ratio: string;
+    /**
+     * Maximum number of queued or running generation jobs per library.
+     */
+    concurrency_per_library: number;
+    /**
+     * Unit used to charge video generation; generated duration is billed per second by Router.
+     */
+    price_unit: 'per second';
+    /**
+     * Days an unsaved candidate is retained before its File is deleted.
+     */
+    candidate_retention_days: number;
+};
 /**
  * Sandbox creation request. All system communication with the sandbox is always secured; the template's envd version must support secured access.
  */
@@ -15071,6 +15362,10 @@ export type SandboxTemplateBuildInfo = {
     reason?: SandboxBuildStatusReason;
 };
 export type SandboxTemplateWithBuilds = {
+    /**
+     * Lifecycle classes this template can run as. ephemeral: cannot pause, snapshot or mount volumes and is deleted when it stops; persistent: can pause, resume and snapshot.
+     */
+    lifecycles?: Array<'ephemeral' | 'persistent'>;
     /**
      * Identifier of the template
      */
@@ -24979,6 +25274,10 @@ export type CutTimeline = {
      * Ordered tracks, topmost visual layer first.
      */
     tracks: Array<CutTrack>;
+    /**
+     * Clip-to-clip transitions selected by track and overlap window; lengths are seconds and effect fields use snake_case on HTTP.
+     */
+    joins?: Array<CutJoin>;
     /**
      * Named points on the timeline.
      */
@@ -25071,6 +25370,20 @@ export type CutTrackSummary = {
      */
     items: number;
 };
+export type CutFrameWarning = {
+    /**
+     * FRAME_UNAVAILABLE means a source image could not be fetched for this preview.
+     */
+    code: 'FRAME_UNAVAILABLE';
+    /**
+     * Identifier of the clip whose source frame could not be fetched.
+     */
+    clip_id?: string;
+    /**
+     * Actionable safe explanation; source URLs and credentials are omitted.
+     */
+    message: string;
+};
 /**
  * Reference to an asset in a bound library; follows asset overwrites to the latest version rather than pinning a version.
  */
@@ -25293,7 +25606,7 @@ export type KnowledgeKnowledgeModels = {
      */
     query_rewrite: string;
     /**
-     * Extracts text from scanned PDF pages. Default: glm-ocr, falling back to qwen3.8-flash. A custom model precedes the platform defaults.
+     * Extracts text from scanned PDF pages through the OCR API. Default: qwen-vl-ocr-2025-11-20, falling back to glm-ocr and qwen3.8-flash. A custom model precedes these defaults. OCR is billed by pages processed.
      */
     ocr: string;
     /**
@@ -25302,14 +25615,9 @@ export type KnowledgeKnowledgeModels = {
     vision: string;
 };
 /**
- * auto resolves to static with 800 estimated tokens and 400 overlap tokens. Unlike OpenAI vector stores, token counts are estimates; each Han character counts as one, and other whitespace-delimited words count as their UTF-16 length divided by four, rounded up.
+ * Native attachment strategy. auto uses static chunks of 800 estimated tokens with 400 overlap; static supplies explicit chunk sizes; hierarchical indexes child chunks and supplies bounded parent context. Existing attachments are reused unchanged; remove and reattach a file to change its strategy.
  */
-export type KnowledgeChunkingInput = {
-    /**
-     * auto uses the default static chunk size of 800 estimated tokens with 400 overlap tokens.
-     */
-    type: 'auto';
-} | KnowledgeStaticChunking;
+export type KnowledgeNativeChunkingInput = KnowledgeChunkingInput | KnowledgeHierarchicalChunking;
 /**
  * Model roles to set. The model must exist in the model catalog and serve the role (embedding → openai.embeddings, rerank → cohere.rerank, query_rewrite → openai.chat.completions, ocr → mistral.ocr or pdf_input capability, vision → vision capability). The embedding model must output 1024-dimension vectors. Omitted roles stay unchanged; null restores all defaults. Unknown roles or empty IDs return 400 INVALID_PARAMS. The OpenAI-compatible API rejects this field with 400.
  */
@@ -25327,7 +25635,7 @@ export type KnowledgeKnowledgeModelsInput = {
      */
     query_rewrite?: string | null;
     /**
-     * Scanned PDF text extraction model; requires mistral.ocr or pdf_input capability. null restores glm-ocr. The preference leads the fallback chain glm-ocr, qwen3.8-flash with duplicates removed.
+     * Scanned PDF text extraction model; requires mistral.ocr or pdf_input capability. null restores qwen-vl-ocr-2025-11-20. The preference leads the OCR API fallback chain qwen-vl-ocr-2025-11-20, glm-ocr, qwen3.8-flash with duplicates removed.
      */
     ocr?: string | null;
     /**
@@ -25364,6 +25672,10 @@ export type KnowledgeNativeSearchResult = {
          * Extracted text of the matched chunk, which may overlap neighboring chunks.
          */
         text: string;
+        /**
+         * Optional source image File ID for this matched chunk. Use the File service to read the image; absent for chunks without an image source and omitted by the OpenAI-compatible URL.
+         */
+        readonly image_file_id?: string;
         /**
          * Resource ID.
          */
@@ -25427,14 +25739,9 @@ export type KnowledgeFilter = {
     filters: Array<KnowledgeFilter>;
 };
 /**
- * Stored chunking strategy for this attachment; auto input is returned as static settings.
+ * Native stored strategy, including hierarchical parent and child settings. auto input resolves to static; the OpenAI-compatible URL projects hierarchical as other.
  */
-export type KnowledgeChunking = KnowledgeStaticChunking | {
-    /**
-     * other identifies a stored strategy whose chunk-size settings are unavailable.
-     */
-    type: 'other';
-};
+export type KnowledgeNativeChunking = KnowledgeChunking | KnowledgeHierarchicalChunking;
 /**
  * File attributes used by search filters. Up to 16 keys of 64 characters; string values up to 512 characters.
  */
@@ -25546,7 +25853,7 @@ export type MediaUnderstandingProgress = {
     readonly migration_complete: boolean;
 };
 /**
- * Resolved model call IDs for the library’s vision, embedding and transcription roles.
+ * Resolved model call IDs for vision, embedding, timestamped transcription, reference transcription and correction.
  */
 export type MediaMediaModels = {
     /**
@@ -25558,9 +25865,21 @@ export type MediaMediaModels = {
      */
     embedding: string;
     /**
-     * Model call ID for speech transcription.
+     * Model call ID for speech transcription. Defaults to fun-asr; failed default ASR requests fall back to whisper-large-v3-turbo. Speaker and word availability depend on the actual producer.
      */
     transcription: string;
+    /**
+     * Model call ID for conservative transcript spelling correction; defaults to qwen3.8-flash. The model must support chat completions.
+     */
+    readonly correction: string;
+    /**
+     * Model call ID for optional full-text reference ASR; defaults to qwen3-asr-flash. Reference failures do not block correction.
+     */
+    readonly reference_transcription: string;
+    /**
+     * Model call ID for audio understanding; defaults to qwen3.8-omni-flash. Analyzes at most the first 120 seconds in up to three windows of at most 40 seconds, with at most three metered model calls per asset. BPM is an estimate; has_music=false only means no music was detected in the analyzed ranges.
+     */
+    readonly audio: string;
 };
 /**
  * Identifier of a library belonging to the caller.
@@ -25721,7 +26040,7 @@ export type MediaCloudinaryResource = {
      */
     url: string;
     /**
-     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the server includes a signature, so the original URL is ready to use. Request a delivery_tokens token for transformed URLs.
+     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the URL carries a single-file token that expires after 15 minutes, so it is ready to use but must not be stored; keep asset_id and read the asset again. Request a delivery_tokens token for transformed URLs.
      */
     secure_url: string;
     /**
@@ -25757,13 +26076,13 @@ export type MediaChunkComplete = MediaCloudinaryResource & {
     done: true;
 };
 /**
- * Per-task processing progress and its aggregate state for the asset.
+ * Per-task processing progress and its aggregate state for the asset. For understanding, Media generates proxies for video sources of 25 MB or more and audio-only sources of 100 MB or more; originals remain available unchanged. The duration limit is 10 minutes. A video proxy still above 95 MB after recompression, or a source exceeding the duration limit, is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.
  */
 export type MediaProcessing = {
     /**
-     * Current understanding stage: probe, frames, visual, transcript, embedding or finalize. Null after finalization; omitted on assets not yet dispatched.
+     * Current understanding stage: probe, frames, shots, visual, transcript, transcript_reference, transcript_correction, audio_profile, overview, embedding or finalize. Null after finalization; omitted on assets not yet dispatched.
      */
-    readonly stage?: 'probe' | 'frames' | 'visual' | 'transcript' | 'embedding' | 'finalize' | null;
+    readonly stage?: 'probe' | 'frames' | 'shots' | 'visual' | 'transcript' | 'transcript_reference' | 'transcript_correction' | 'audio_profile' | 'overview' | 'embedding' | 'finalize' | null;
     state: MediaProcessingState;
     /**
      * Processing states by kind. tagging is present when auto_tagging was requested and follows visual understanding.
@@ -25805,6 +26124,18 @@ export type MediaStoryboard = {
  * An immutable understanding result for an asset version, including superseded history when requested.
  */
 export type MediaUnderstanding = {
+    /**
+     * Original hallucination-filtered ASR text before correction, present on correction-enabled transcript records. Omitted on legacy records and other kinds.
+     */
+    readonly text_original?: string;
+    /**
+     * Corrected transcript, also returned as content and used for subtitles and search. Equals text_original when correction fails. Original segment timestamps remain unchanged.
+     */
+    readonly text?: string;
+    /**
+     * Transcript correction audit, accepted edits and optional reference ASR. Present on correction-enabled transcript records, including failed corrections.
+     */
+    readonly correction?: MediaTranscriptCorrection;
     /**
      * Generated identifier of this understanding result.
      */
@@ -25818,7 +26149,7 @@ export type MediaUnderstanding = {
      */
     asset_version: number;
     /**
-     * Result kind: caption is a visual description, tags are recognized labels, ocr is text recognized in the image, transcript is speech text, and frame is a description of a video segment.
+     * Result kind: caption is a visual description, tags are recognized labels, ocr is text recognized in the image, transcript is speech text, and frame is a description of a video segment. audio describes sampled speech, music, ambient sound and silence; overview is a full-video summary with chapters, IAB categories and an unverified location; embedding reports a failed embedding step.
      */
     kind: MediaUnderstandingKind;
     /**
@@ -25842,7 +26173,7 @@ export type MediaUnderstanding = {
      */
     content: string | null;
     /**
-     * Structured producer output, such as recognized labels or frame details; null when absent.
+     * Structured producer output; null when absent. Transcript data retains a timed-segment array with corrected text and text_original on each segment; its first segment also carries the correction audit. Silent transcripts use an object with filtered_segments and correction. Legacy transcript arrays retain their original shape. Transcript segments may contain speaker (a diarization label, not a verified identity), words (text, start_ms and end_ms in source-media milliseconds) and producer (the actual fallback model when different from the record producer). Overview data contains chapters (first_shot, title, summary, start_ms, end_ms), iab (tier1, optional tier2, confidence from 0 to 1), and location (an unverified place guess or null); content is the full-video summary. Audio data contains segments (start_s and end_s in source-media seconds; type is speech, music, ambient or silence), has_music, genre, mood, bpm_estimate (nullable), bpm_is_estimate=true and analyzed_ranges (start_s, end_s in seconds). Genre and mood are nullable model labels. Audio understanding samples only the first 120 seconds in at most three windows of at most 40 seconds, with at most three metered model calls per asset. BPM is an estimate, not an exact tempo; has_music=false only means no music was detected within analyzed_ranges.
      */
     data: unknown | null;
     /**
@@ -25871,6 +26202,36 @@ export type MediaUnderstanding = {
      */
     created_at: MediaIsoTimestamp;
 };
+export type MediaUnderstoodShot = {
+    /**
+     * Inclusive shot start in milliseconds.
+     */
+    readonly start_ms: number;
+    /**
+     * Exclusive shot end in milliseconds.
+     */
+    readonly end_ms: number;
+    /**
+     * Zero-based shot index in timeline order.
+     */
+    readonly index: number;
+    /**
+     * One to three sampled frame timestamps in milliseconds within this shot.
+     */
+    readonly keyframes_ms: Array<number>;
+    /**
+     * Structured interpretation, present after this shot completes visual processing.
+     */
+    readonly visual?: MediaShotVisual;
+    /**
+     * Lexical location hint: true if the leaf folder and location guess share no place-name token. Unknown locations abstain; this is not a verified geolocation.
+     */
+    readonly folder_mismatch?: boolean;
+    /**
+     * Vision model that generated this shot interpretation.
+     */
+    readonly producer?: string;
+};
 /**
  * A native asset returned by expression search; tags and context are included only when requested in with_field.
  */
@@ -25988,7 +26349,7 @@ export type MediaSearchAsset = {
      */
     url: string;
     /**
-     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the server includes a signature, so the original URL is ready to use. Request a delivery_tokens token for transformed URLs.
+     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the URL carries a single-file token that expires after 15 minutes, so it is ready to use but must not be stored; keep asset_id and read the asset again. Request a delivery_tokens token for transformed URLs.
      */
     secure_url: string;
     /**
@@ -26071,6 +26432,27 @@ export type MediaSearchAsset = {
             };
         };
     };
+    /**
+     * Source details for the video-generation job that created this asset.
+     */
+    generation?: {
+        /**
+         * Job id that generated this asset.
+         */
+        job_id: MediaJobId;
+        /**
+         * Generation intent used to create the asset; v1 supports video.generate.
+         */
+        intent: string;
+        /**
+         * Text prompt submitted for the generation job.
+         */
+        prompt: string;
+        /**
+         * Router video-generation model that produced the asset.
+         */
+        model: string;
+    };
 };
 /**
  * A matching asset with its ranking score and supporting matches.
@@ -26093,11 +26475,11 @@ export type MediaSemanticHit = {
      */
     matches: Array<MediaSemanticMatch>;
 };
+export type MediaMediaErrorCode = 'LIBRARY_NOT_FOUND' | 'ASSET_NOT_FOUND' | 'JOB_NOT_FOUND' | 'UNDERSTANDING_NOT_FOUND' | 'ASSET_VERSION_CHANGED' | 'LIBRARY_INVALID_STATE' | 'INVALID_PARAMS' | 'INVALID_EXPRESSION' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'FILE_TOO_LARGE' | 'FILE_EMPTY' | 'UNSUPPORTED_MEDIA' | 'FETCH_FAILED' | 'LIMIT_EXCEEDED' | 'CHUNK_INVALID' | 'RATE_LIMITED' | 'CAPACITY' | 'UPSTREAM_FAILED' | 'CONTENT_REJECTED' | 'GENERATION_FAILED' | 'CANDIDATE_EXPIRED' | 'BINDING_READ_ONLY';
 /**
- * Identifier returned when a batch job is created.
+ * State of a requested video output.
  */
-export type MediaJobId = string;
-export type MediaMediaErrorCode = 'LIBRARY_NOT_FOUND' | 'ASSET_NOT_FOUND' | 'JOB_NOT_FOUND' | 'UNDERSTANDING_NOT_FOUND' | 'ASSET_VERSION_CHANGED' | 'LIBRARY_INVALID_STATE' | 'INVALID_PARAMS' | 'INVALID_EXPRESSION' | 'UNSUPPORTED' | 'NOT_IMPLEMENTED' | 'FILE_TOO_LARGE' | 'FILE_EMPTY' | 'UNSUPPORTED_MEDIA' | 'FETCH_FAILED' | 'LIMIT_EXCEEDED' | 'CHUNK_INVALID' | 'RATE_LIMITED' | 'CAPACITY' | 'UPSTREAM_FAILED' | 'BINDING_READ_ONLY';
+export type MediaGenerationOutputStatus = 'pending' | 'succeeded' | 'failed';
 /**
  * A recorded library event with a monotonically increasing sequence within that library.
  */
@@ -26141,6 +26523,36 @@ export type MediaMediaEvent = {
         [key: string]: unknown;
     };
 };
+export type MediaFailureGroup = {
+    /**
+     * Failure reason code. Unknown codes are retryable.
+     */
+    code: string;
+    /**
+     * Understanding output kind that failed, such as caption, frame, transcript or embedding.
+     */
+    kind: string;
+    /**
+     * Producer model that reported this failure; unknown when historical provenance was unavailable.
+     */
+    model: string;
+    /**
+     * Number of current failed entries in this group; several entries can belong to one asset.
+     */
+    count: number;
+    /**
+     * True for a rollup of additional code, kind and model combinations after 1024 detailed groups. OTHER_RETRYABLE and OTHER_UNRECOVERABLE preserve retryability; original codes remain on each understanding and match failure_code expressions.
+     */
+    overflow: boolean;
+    /**
+     * True when a repeated attempt may recover, including unknown error codes. False for unsupported media, limits, missing or corrupt source files.
+     */
+    retryable: boolean;
+    /**
+     * Up to five distinct asset identifiers from this group, for inspecting original error details.
+     */
+    sample_asset_ids: Array<MediaAssetId>;
+};
 /**
  * Auto-resume configuration for paused sandboxes.
  */
@@ -30467,6 +30879,32 @@ export type CutTrack = {
      */
     items: Array<CutItem>;
 };
+/**
+ * Overlap between adjacent visual clips on the same track; creating it shifts the right clip and same-track followers left by its length.
+ */
+export type CutJoin = {
+    /**
+     * Join identifier returned by Join; reuse as the id argument to UpdateJoin or DeleteJoin inside execute.
+     */
+    id: string;
+    /**
+     * Visual track containing both endpoints, from AddTrack or the timeline track id.
+     */
+    track: string;
+    /**
+     * Outgoing clip identifier, from Insert or the timeline items.
+     */
+    left: string;
+    /**
+     * Incoming clip identifier, from Insert or the timeline items.
+     */
+    right: string;
+    /**
+     * Overlap duration in seconds, positive and shorter than each endpoint; incoming plus outgoing lengths may not exceed a clip length.
+     */
+    length: number;
+    effect: CutJoinEffect;
+};
 /**
  * A named point on the project timeline.
  */
@@ -30484,23 +30922,39 @@ export type CutMarker = {
      */
     label: string;
 };
-export type KnowledgeStaticChunking = {
+/**
+ * auto resolves to static with 800 estimated tokens and 400 overlap tokens. Unlike OpenAI vector stores, token counts are estimates; each Han character counts as one, and other whitespace-delimited words count as their UTF-16 length divided by four, rounded up.
+ */
+export type KnowledgeChunkingInput = {
     /**
-     * static selects explicit chunk-size and overlap settings.
+     * auto uses the default static chunk size of 800 estimated tokens with 400 overlap tokens.
      */
-    type: 'static';
+    type: 'auto';
+} | KnowledgeStaticChunking;
+/**
+ * Native strategy that indexes small child chunks and returns bounded parent context for retrieval. Unlike OpenAI vector stores, this strategy is available only through /knowledge/v1; compatible writes reject it and compatible reads project its type as other.
+ */
+export type KnowledgeHierarchicalChunking = {
     /**
-     * Chunk-size and overlap limits in estimated tokens.
+     * hierarchical selects smaller child chunks for matching and larger parent chunks for context.
      */
-    static: {
+    type: 'hierarchical';
+    /**
+     * Required parent, child and overlap sizes in estimated tokens. All three values must be integers.
+     */
+    hierarchical: {
         /**
-         * Estimated tokens per chunk.
+         * Maximum estimated tokens per parent chunk, from 101 through 4096; must exceed child_max_tokens.
          */
-        max_chunk_size_tokens: number;
+        parent_max_tokens: number;
         /**
-         * Must not exceed half of max_chunk_size_tokens.
+         * Maximum estimated tokens per child chunk, at least 100 and strictly smaller than parent_max_tokens.
          */
-        chunk_overlap_tokens: number;
+        child_max_tokens: number;
+        /**
+         * Estimated tokens shared by adjacent children, from zero through floor(child_max_tokens / 2).
+         */
+        child_overlap_tokens: number;
     };
 };
 /**
@@ -30540,6 +30994,15 @@ export type KnowledgeSearchExplain = {
      */
     matched_terms: Array<string>;
 };
+/**
+ * Stored chunking strategy for this attachment; auto input is returned as static settings.
+ */
+export type KnowledgeChunking = KnowledgeStaticChunking | {
+    /**
+     * other identifies a stored strategy whose chunk-size settings are unavailable.
+     */
+    type: 'other';
+};
 /**
  * Aggregate processing state across the asset processing tasks.
  */
@@ -30548,14 +31011,66 @@ export type MediaProcessingState = 'pending' | 'processing' | 'ready' | 'partial
  * Task state: pending awaits execution; running is executing; ready succeeded; failed terminated unsuccessfully; unsupported cannot process this input; skipped was disabled or does not apply.
  */
 export type MediaKindState = 'pending' | 'running' | 'ready' | 'failed' | 'unsupported' | 'skipped';
+export type MediaTranscriptCorrection = {
+    /**
+     * Accepted local edits, including deterministic Arabic quantity normalization. Unsupported model edits are discarded.
+     */
+    readonly edits: Array<MediaTranscriptEdit>;
+    /**
+     * ready means correction and validation completed; failed means text is exactly the ASR original, with no accepted edits.
+     */
+    readonly correction_status: 'ready' | 'failed';
+    /**
+     * Configured correction model call ID; defaults to qwen3.8-flash.
+     */
+    readonly correction_model: string;
+    /**
+     * ready means reference ASR supplied text; missing means reference failed or was unavailable and correction proceeded without it.
+     */
+    readonly reference_status: 'ready' | 'missing';
+    /**
+     * Full reference ASR text, present when reference_status is ready. It supplies spelling evidence and has no timestamps.
+     */
+    readonly reference_text?: string;
+    /**
+     * Model call ID that supplied the reference text; defaults to qwen3-asr-flash.
+     */
+    readonly reference_model?: string;
+    /**
+     * Correction failure that caused verbatim fallback to the ASR original.
+     */
+    readonly correction_error?: {
+        /**
+         * Failure code for the optional transcript enhancement step.
+         */
+        code: string;
+        /**
+         * Failure detail; use reprocess to retry with the library’s current configuration.
+         */
+        message: string;
+    };
+    /**
+     * Reference failure; it does not block correction.
+     */
+    readonly reference_error?: {
+        /**
+         * Failure code for the optional transcript enhancement step.
+         */
+        code: string;
+        /**
+         * Failure detail; use reprocess to retry with the library’s current configuration.
+         */
+        message: string;
+    };
+};
 /**
  * Identifier of an immutable understanding result.
  */
 export type MediaUnderstandingId = string;
 /**
- * Result kind: caption is a visual description, tags are recognized labels, ocr is text recognized in the image, transcript is speech text, and frame is a description of a video segment.
+ * Result kind: caption is a visual description, tags are recognized labels, ocr is text recognized in the image, transcript is speech text, and frame is a description of a video segment. audio describes sampled speech, music, ambient sound and silence; overview is a full-video summary with chapters, IAB categories and an unverified location; embedding reports a failed embedding step.
  */
-export type MediaUnderstandingKind = 'caption' | 'tags' | 'ocr' | 'transcript' | 'frame';
+export type MediaUnderstandingKind = 'caption' | 'tags' | 'ocr' | 'transcript' | 'frame' | 'overview' | 'audio' | 'embedding';
 /**
  * Time range within the source media, expressed in milliseconds.
  */
@@ -30569,6 +31084,28 @@ export type MediaSegment = {
      */
     end_ms: number;
 };
+export type MediaShotVisual = {
+    /**
+     * Chinese summary of the entire shot using its keyframes together.
+     */
+    readonly caption: string;
+    /**
+     * Chinese description of the scene and shooting context.
+     */
+    readonly scene: string;
+    /**
+     * Location inferred from recognizable landmarks or readable place names; null without evidence.
+     */
+    readonly location_guess: string | null;
+    /**
+     * Visible text in reading order, preserving the source language.
+     */
+    readonly on_screen_text: Array<string>;
+    /**
+     * Quality and editing characteristics with confidence for every judgment.
+     */
+    readonly flags: MediaShotFlags;
+};
 /**
  * Evidence contributing to a search hit, optionally linked to an understanding and a source-media segment.
  */
@@ -30593,7 +31130,7 @@ export type MediaSemanticMatch = {
 /**
  * Type of change recorded for a library, asset, processing task, search index or batch.
  */
-export type MediaMediaEventType = 'library.status_provisioning' | 'library.status_active' | 'library.status_deleting' | 'library.status_deleted' | 'library.status_failed' | 'library.restored' | 'library.updated' | 'asset.created' | 'asset.updated' | 'asset.overwritten' | 'asset.renamed' | 'asset.deleted' | 'understanding.status_ready' | 'understanding.status_failed' | 'understanding.status_unsupported' | 'search.indexed' | 'batch.succeeded' | 'batch.failed';
+export type MediaMediaEventType = 'library.status_provisioning' | 'library.status_active' | 'library.status_deleting' | 'library.status_deleted' | 'library.status_failed' | 'library.restored' | 'library.updated' | 'asset.created' | 'asset.updated' | 'asset.overwritten' | 'asset.renamed' | 'asset.deleted' | 'understanding.status_ready' | 'understanding.status_failed' | 'understanding.status_unsupported' | 'search.indexed' | 'batch.succeeded' | 'batch.failed' | 'library.understanding_drained' | 'batch.created' | 'generation.created' | 'generation.succeeded' | 'generation.failed' | 'generation.cancelled';
 /**
  * Auto-resume enabled flag for paused sandboxes. Default false.
  */
@@ -31225,21 +31762,25 @@ export type AnthropicToolReferenceBlock = {
  */
 export type CutTextStyle = {
     /**
-     * Geist is the Latin typeface; Noto Sans SC is the simplified Chinese typeface.
+     * Canonical font family name; call ListFonts() in the Cut script API to retrieve the available font families.
      */
-    font_family?: 'Geist' | 'Noto Sans SC';
+    font_family?: string;
     /**
      * Text size in output pixels.
      */
     font_size?: number;
     /**
-     * Font weight: 400 is regular, 500 is medium and 700 is bold.
+     * Positive requested font weight; each family has its own available catalog weights, and unsupported values resolve to the nearest available weight, preferring the heavier weight on a tie.
      */
-    font_weight?: 400 | 500 | 700;
+    font_weight?: number;
     /**
      * Text color in #RRGGBB or #RRGGBBAA notation.
      */
     color?: string;
+    /**
+     * Optional solid or gradient glyph fill; gradients span the text box.
+     */
+    fill?: CutFill;
     /**
      * Optional text outline.
      */
@@ -31249,10 +31790,61 @@ export type CutTextStyle = {
          */
         color?: string;
         /**
-         * Outline width in output pixels.
+         * Outline width in output pixels; must be non-negative and at most 40 pixels.
          */
         width?: number;
     };
+    /**
+     * Additional outlines, painted from outermost to innermost; at most 4 strokes.
+     */
+    strokes?: Array<{
+        /**
+         * Outline color in #RRGGBB or #RRGGBBAA notation.
+         */
+        color?: string;
+        /**
+         * Outline width in output pixels, from 0 to 40.
+         */
+        width?: number;
+    }>;
+    /**
+     * Offset text shadows; at most 4 shadows. Offsets are non-negative output pixels; blur is 0 to 100 output pixels.
+     */
+    shadows?: Array<{
+        /**
+         * Shadow color in #RRGGBB or #RRGGBBAA notation.
+         */
+        color?: string;
+        /**
+         * Non-negative horizontal offset in output pixels.
+         */
+        x?: number;
+        /**
+         * Non-negative vertical offset in output pixels.
+         */
+        y?: number;
+        /**
+         * Blur radius in output pixels, from 0 to 100.
+         */
+        blur?: number;
+    }>;
+    /**
+     * Colored glow around glyphs; radius is in output pixels, from 0 to 100, and strength is from 0 to 1.
+     */
+    glow?: {
+        /**
+         * Glow color in #RRGGBB or #RRGGBBAA notation.
+         */
+        color?: string;
+        /**
+         * Glow blur radius in output pixels, from 0 to 100.
+         */
+        radius?: number;
+        /**
+         * Glow opacity multiplier from 0 to 1.
+         */
+        strength?: number;
+    };
     /**
      * Optional text background color as hexadecimal RGB or RGBA.
      */
@@ -31266,9 +31858,13 @@ export type CutTextStyle = {
      */
     max_width?: number;
     /**
-     * Caption placement: top is near the upper edge, middle is centered, bottom is near the lower edge.
+     * Text or caption placement: top/middle/bottom center the box at 12%/50%/85% of height without margin; omitted text position preserves its transform.
      */
     position?: 'top' | 'middle' | 'bottom';
+    /**
+     * Box edge distance from the top or bottom as a fraction of canvas height; middle ignores it.
+     */
+    margin?: number;
     /**
      * Optional color applied to the currently spoken caption word.
      */
@@ -31380,6 +31976,200 @@ export type CutItem = {
      */
     words?: Array<CutCaptionWord>;
 };
+/**
+ * Transition between two joined visual clips. The kind identifies an effect from ListTransitions; omitted parameters use that effect's defaults. Unknown fields and invalid values are rejected.
+ */
+export type CutJoinEffect = {
+    /**
+     * Dissolve: Blend the outgoing shot into the incoming shot.
+     */
+    kind: 'dissolve';
+} | {
+    /**
+     * Dip: Fade through a solid color between the two shots.
+     */
+    kind: 'dip';
+    /**
+     * Solid color shown between shots.
+     */
+    color?: 'black' | 'white';
+} | {
+    /**
+     * Push: Slide the incoming shot into view as it pushes the outgoing shot away.
+     */
+    kind: 'push';
+    /**
+     * Direction in which the transition moves across the frame.
+     */
+    direction?: 'left' | 'right' | 'up' | 'down';
+} | {
+    /**
+     * Wipe: Reveal the incoming shot behind an edge moving across the outgoing shot.
+     */
+    kind: 'wipe';
+    /**
+     * Direction in which the transition moves across the frame.
+     */
+    direction?: 'left' | 'right' | 'up' | 'down';
+    /**
+     * Edge softness from a sharp boundary to a fully softened blend.
+     */
+    softness?: number;
+} | {
+    /**
+     * Iris: Reveal the incoming shot through an expanding circular opening.
+     */
+    kind: 'iris';
+    /**
+     * Horizontal opening center from the left edge to the right edge.
+     */
+    center_x?: number;
+    /**
+     * Vertical opening center from the top edge to the bottom edge.
+     */
+    center_y?: number;
+} | {
+    /**
+     * Blinds: Reveal the incoming shot through a set of parallel strips.
+     */
+    kind: 'blinds';
+    /**
+     * Number of strips revealing the incoming shot.
+     */
+    count?: number;
+    /**
+     * Orientation of the revealing strips.
+     */
+    orientation?: 'vertical' | 'horizontal';
+} | {
+    /**
+     * Blur: Blur the outgoing shot into the incoming shot before returning to focus.
+     */
+    kind: 'blur';
+    /**
+     * Blur radius in pixels at a reference frame height of 1080 pixels.
+     */
+    radius?: number;
+} | {
+    /**
+     * Zoom transition.
+     */
+    kind: 'zoom';
+    /**
+     * Zoom in or out.
+     */
+    direction?: 'in' | 'out';
+    /**
+     * Peak scale increase as a multiple of the original scale.
+     */
+    amount?: number;
+    /**
+     * Radial blur strength; zero disables blur sampling.
+     */
+    blur?: number;
+} | {
+    /**
+     * Clock transition.
+     */
+    kind: 'clock';
+    /**
+     * Sweep direction.
+     */
+    direction?: 'clockwise' | 'counterclockwise';
+    /**
+     * Start angle in degrees, with zero at twelve o'clock.
+     */
+    start_angle?: number;
+    /**
+     * Angular feather width.
+     */
+    softness?: number;
+} | {
+    /**
+     * Flash transition.
+     */
+    kind: 'flash';
+    /**
+     * Flash color.
+     */
+    color?: 'white' | 'black';
+    /**
+     * Flash strength.
+     */
+    intensity?: number;
+} | {
+    /**
+     * Luma transition.
+     */
+    kind: 'luma';
+    /**
+     * Built-in map. User maps are not available yet.
+     */
+    map?: 'radial' | 'diagonal' | 'clouds' | 'spiral' | 'honeycomb' | 'bars';
+    /**
+     * Edge feather width.
+     */
+    softness?: number;
+    /**
+     * Reveal order.
+     */
+    invert?: 'normal' | 'inverted';
+};
+export type KnowledgeStaticChunking = {
+    /**
+     * static selects explicit chunk-size and overlap settings.
+     */
+    type: 'static';
+    /**
+     * Chunk-size and overlap limits in estimated tokens.
+     */
+    static: {
+        /**
+         * Estimated tokens per chunk.
+         */
+        max_chunk_size_tokens: number;
+        /**
+         * Must not exceed half of max_chunk_size_tokens.
+         */
+        chunk_overlap_tokens: number;
+    };
+};
+export type MediaTranscriptEdit = {
+    /**
+     * Original literal text replaced by this accepted edit.
+     */
+    readonly from: string;
+    /**
+     * Replacement text. Model edits require a length difference of at most two Unicode characters, or a target present in hotwords or the reference transcript. Arabic quantity normalization is deterministic.
+     */
+    readonly to: string;
+    /**
+     * Zero-based index in the assembled, hallucination-filtered ASR segments. Segment timestamps do not change.
+     */
+    readonly segment_id: number;
+};
+export type MediaShotFlags = {
+    /**
+     * Slide or screen-recorded picture/text sequence rather than live footage.
+     */
+    readonly slideshow: MediaShotFlag;
+    /**
+     * Visible watermark.
+     */
+    readonly watermark: MediaShotFlag;
+    /**
+     * Fingers or hands framing the scene.
+     */
+    readonly hand_frame: MediaShotFlag;
+    /**
+     * Added text sticker or overlay.
+     */
+    readonly text_sticker: MediaShotFlag;
+    /**
+     * Blur, severe camera shake, bad exposure or another visible quality defect.
+     */
+    readonly low_quality: MediaShotFlag;
+};
 export type SandboxSandboxIamToken = {
     /**
      * Audience of the workload token, stored exactly as provided.
@@ -31565,6 +32355,51 @@ export type AnthropicCitationsConfig = {
      */
     enabled: boolean;
 };
+/**
+ * Solid color or a gradient over the styled text box.
+ */
+export type CutFill = string | {
+    /**
+     * Linear gradient; angle is in degrees and stop positions range from 0 to 1.
+     */
+    linear?: {
+        /**
+         * Gradient angle in degrees; 0 runs left to right.
+         */
+        angle?: number;
+        /**
+         * Gradient color stops; each position is a fraction from 0 to 1.
+         */
+        stops?: Array<{
+            /**
+             * Stop position as a fraction from 0 to 1.
+             */
+            at?: number;
+            /**
+             * Stop color in #RRGGBB or #RRGGBBAA notation.
+             */
+            color?: string;
+        }>;
+    };
+    /**
+     * Radial gradient with stop positions as fractions from 0 to 1.
+     */
+    radial?: {
+        /**
+         * Gradient color stops; each position is a fraction from 0 to 1.
+         */
+        stops?: Array<{
+            /**
+             * Stop position as a fraction from 0 to 1.
+             */
+            at?: number;
+            /**
+             * Stop color in #RRGGBB or #RRGGBBAA notation.
+             */
+            color?: string;
+        }>;
+    };
+};
 /**
  * Visual placement; coordinates are normalized canvas centers.
  */
@@ -31641,6 +32476,16 @@ export type CutCaptionWord = {
      */
     length: number;
 };
+export type MediaShotFlag = {
+    /**
+     * True when this visual characteristic is present.
+     */
+    readonly value: boolean;
+    /**
+     * Confidence in this true or false judgment, from 0 to 1.
+     */
+    readonly confidence: number;
+};
 export type PraxisSdkSseGetBrowserV1SessionsSessionIdStream = BrowserStreamMessage;
 /**
  * One decoded SSE event. The data field contains the decoded JSON payload, or a documented string sentinel. SSE comments are keepalives, not events. Optional id/event fields are absent when the server does not send them.
@@ -31936,6 +32781,28 @@ export type AutomationJsonValueWritable = null | string | number | boolean | Aut
 export type AutomationJsonObjectWritable = {
     [key: string]: AutomationJsonValueWritable;
 };
+export type KnowledgeNativeSearchPageWritable = {
+    /**
+     * Object discriminator; vector_store.search_results.page identifies a search result page.
+     */
+    object: 'vector_store.search_results.page';
+    /**
+     * The queries used for retrieval, one per input query; rewritten when rewrite_query is true, otherwise the input as sent.
+     */
+    search_query: Array<string>;
+    /**
+     * One result per matched chunk; the same file_id can occur more than once.
+     */
+    data: Array<KnowledgeNativeSearchResultWritable>;
+    /**
+     * True when filtered chunks exceed max_num_results; next_page remains null.
+     */
+    has_more: boolean;
+    /**
+     * Always null; no next search page.
+     */
+    next_page: null;
+};
 /**
  * A caller-owned media library with lifecycle, usage, understanding settings and model selections.
  */
@@ -31943,7 +32810,7 @@ export type MediaLibraryWritable = {
     /**
      * Resolved model call IDs used for new uploads and reprocessing.
      */
-    models: MediaMediaModels;
+    models: MediaMediaModelsWritable;
     /**
      * Generated library identifier: lib_ followed by 32 lowercase hexadecimal characters.
      */
@@ -32138,7 +33005,7 @@ export type MediaAssetWritable = {
      */
     url: string;
     /**
-     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the server includes a signature, so the original URL is ready to use. Request a delivery_tokens token for transformed URLs.
+     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the URL carries a single-file token that expires after 15 minutes, so it is ready to use but must not be stored; keep asset_id and read the asset again. Request a delivery_tokens token for transformed URLs.
      */
     secure_url: string;
     /**
@@ -32221,6 +33088,40 @@ export type MediaAssetWritable = {
             };
         };
     };
+    /**
+     * Source details for the video-generation job that created this asset.
+     */
+    generation?: {
+        /**
+         * Job id that generated this asset.
+         */
+        job_id: MediaJobId;
+        /**
+         * Generation intent used to create the asset; v1 supports video.generate.
+         */
+        intent: string;
+        /**
+         * Text prompt submitted for the generation job.
+         */
+        prompt: string;
+        /**
+         * Router video-generation model that produced the asset.
+         */
+        model: string;
+    };
+};
+/**
+ * Understanding results in this page, ordered by creation time ascending.
+ */
+export type MediaUnderstandingPageWritable = MediaPage & {
+    /**
+     * Understanding results in this page, ordered by creation time ascending.
+     */
+    data: Array<MediaUnderstandingWritable>;
+    /**
+     * Opaque token to pass as cursor to listUnderstandings; null means no further page.
+     */
+    next_cursor: string | null;
 };
 /**
  * Expression-search page with match counts, elapsed time and optional facet counts.
@@ -32315,6 +33216,75 @@ export type AgentManaged193Writable = {
 export type AgentManaged143Writable = {
     [key: string]: string;
 };
+export type KnowledgeNativeSearchResultWritable = {
+    /**
+     * Resource ID.
+     */
+    file_id: string;
+    /**
+     * Original source filename for the matched file.
+     */
+    filename: string;
+    /**
+     * Relevance ranking score for this chunk, clamped to the range 0 to 1; not a probability.
+     */
+    score: number;
+    /**
+     * Current file attributes used for filtering; null when unset.
+     */
+    attributes: KnowledgeAttributes | null;
+    /**
+     * Matched chunk text and its source coordinates; one chunk per native result.
+     */
+    content: Array<{
+        /**
+         * text identifies an extracted text chunk.
+         */
+        type: 'text';
+        /**
+         * Extracted text of the matched chunk, which may overlap neighboring chunks.
+         */
+        text: string;
+        /**
+         * Resource ID.
+         */
+        chunk_id?: string;
+        /**
+         * One-based source page containing the start of this chunk; null when no page mapping is available.
+         */
+        page?: number | null;
+        /**
+         * Start and end offsets in UTF-16 code units.
+         */
+        span?: [
+            number,
+            number
+        ];
+    }>;
+    /**
+     * Native search explanation, included only when praxis.explain is requested.
+     */
+    praxis?: {
+        explain: KnowledgeSearchExplain;
+    };
+};
+/**
+ * Resolved model call IDs for vision, embedding, timestamped transcription, reference transcription and correction.
+ */
+export type MediaMediaModelsWritable = {
+    /**
+     * Model call ID for visual descriptions; the model must support image input.
+     */
+    vision: string;
+    /**
+     * Model call ID for search embeddings; must produce compatible vectors and cannot change while assets exist.
+     */
+    embedding: string;
+    /**
+     * Model call ID for speech transcription. Defaults to fun-asr; failed default ASR requests fall back to whisper-large-v3-turbo. Speaker and word availability depend on the actual producer.
+     */
+    transcription: string;
+};
 /**
  * Cloudinary-compatible resource. processing is present when the asset was uploaded with auto_tagging; otherwise it is omitted. Native Asset responses always include processing.
  */
@@ -32432,7 +33402,7 @@ export type MediaCloudinaryResourceWritable = {
      */
     url: string;
     /**
-     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the server includes a signature, so the original URL is ready to use. Request a delivery_tokens token for transformed URLs.
+     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the URL carries a single-file token that expires after 15 minutes, so it is ready to use but must not be stored; keep asset_id and read the asset again. Request a delivery_tokens token for transformed URLs.
      */
     secure_url: string;
     /**
@@ -32455,7 +33425,7 @@ export type MediaChunkCompleteWritable = MediaCloudinaryResourceWritable & {
     done: true;
 };
 /**
- * Per-task processing progress and its aggregate state for the asset.
+ * Per-task processing progress and its aggregate state for the asset. For understanding, Media generates proxies for video sources of 25 MB or more and audio-only sources of 100 MB or more; originals remain available unchanged. The duration limit is 10 minutes. A video proxy still above 95 MB after recompression, or a source exceeding the duration limit, is reported as UNSUPPORTED with the limit in the failure message. Proxy preparation uses the organization’s metered sandbox resources.
  */
 export type MediaProcessingWritable = {
     state: MediaProcessingState;
@@ -32470,6 +33440,76 @@ export type MediaProcessingWritable = {
      */
     updated_at: MediaIsoTimestamp;
 };
+/**
+ * An immutable understanding result for an asset version, including superseded history when requested.
+ */
+export type MediaUnderstandingWritable = {
+    /**
+     * Generated identifier of this understanding result.
+     */
+    id: MediaUnderstandingId;
+    /**
+     * Identifier of the asset from which this result was produced.
+     */
+    asset_id: MediaAssetId;
+    /**
+     * Asset version processed to produce this result; compare with the asset’s current version.
+     */
+    asset_version: number;
+    /**
+     * Result kind: caption is a visual description, tags are recognized labels, ocr is text recognized in the image, transcript is speech text, and frame is a description of a video segment. audio describes sampled speech, music, ambient sound and silence; overview is a full-video summary with chapters, IAB categories and an unverified location; embedding reports a failed embedding step.
+     */
+    kind: MediaUnderstandingKind;
+    /**
+     * Producer model identifier; a failure may use the configured model when no model response is available.
+     */
+    producer: string;
+    /**
+     * Version of the producer that generated this understanding result.
+     */
+    producer_version: string;
+    /**
+     * Source-media time range for a frame or transcript segment; null for results without a segment.
+     */
+    segment: MediaSegment | null;
+    /**
+     * Result status: ready contains completed output; failed records an error.
+     */
+    status: 'ready' | 'failed';
+    /**
+     * Text output, such as a caption, recognized text or transcript; null for structured-only or failed results.
+     */
+    content: string | null;
+    /**
+     * Structured producer output; null when absent. Transcript data retains a timed-segment array with corrected text and text_original on each segment; its first segment also carries the correction audit. Silent transcripts use an object with filtered_segments and correction. Legacy transcript arrays retain their original shape. Transcript segments may contain speaker (a diarization label, not a verified identity), words (text, start_ms and end_ms in source-media milliseconds) and producer (the actual fallback model when different from the record producer). Overview data contains chapters (first_shot, title, summary, start_ms, end_ms), iab (tier1, optional tier2, confidence from 0 to 1), and location (an unverified place guess or null); content is the full-video summary. Audio data contains segments (start_s and end_s in source-media seconds; type is speech, music, ambient or silence), has_music, genre, mood, bpm_estimate (nullable), bpm_is_estimate=true and analyzed_ranges (start_s, end_s in seconds). Genre and mood are nullable model labels. Audio understanding samples only the first 120 seconds in at most three windows of at most 40 seconds, with at most three metered model calls per asset. BPM is an estimate, not an exact tempo; has_music=false only means no music was detected within analyzed_ranges.
+     */
+    data: unknown | null;
+    /**
+     * Confidence value recorded by the producer; null when no confidence value is recorded.
+     */
+    confidence: number | null;
+    /**
+     * Failure code and message, or null for a successful result.
+     */
+    error: {
+        /**
+         * Failure code identifying why understanding could not complete.
+         */
+        code: string;
+        /**
+         * Human-readable explanation of the understanding failure.
+         */
+        message: string;
+    } | null;
+    /**
+     * Whether a newer result or asset version has replaced this result. Excluded from listing unless include_superseded is true.
+     */
+    superseded: boolean;
+    /**
+     * Time this immutable result was recorded, in UTC.
+     */
+    created_at: MediaIsoTimestamp;
+};
 /**
  * A native asset returned by expression search; tags and context are included only when requested in with_field.
  */
@@ -32587,7 +33627,7 @@ export type MediaSearchAssetWritable = {
      */
     url: string;
     /**
-     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the server includes a signature, so the original URL is ready to use. Request a delivery_tokens token for transformed URLs.
+     * HTTPS delivery URL for this asset version; equal to url. For authenticated assets the URL carries a single-file token that expires after 15 minutes, so it is ready to use but must not be stored; keep asset_id and read the asset again. Request a delivery_tokens token for transformed URLs.
      */
     secure_url: string;
     /**
@@ -32670,6 +33710,27 @@ export type MediaSearchAssetWritable = {
             };
         };
     };
+    /**
+     * Source details for the video-generation job that created this asset.
+     */
+    generation?: {
+        /**
+         * Job id that generated this asset.
+         */
+        job_id: MediaJobId;
+        /**
+         * Generation intent used to create the asset; v1 supports video.generate.
+         */
+        intent: string;
+        /**
+         * Text prompt submitted for the generation job.
+         */
+        prompt: string;
+        /**
+         * Router video-generation model that produced the asset.
+         */
+        model: string;
+    };
 };
 /**
  * A matching asset with its ranking score and supporting matches.
@@ -32695,6 +33756,9 @@ export type MediaSemanticHitWritable = {
 export type AgentManaged34Writable = {
     [key: string]: unknown;
 };
+export type MediaTranscriptCorrectionWritable = {
+    [key: string]: unknown;
+};
 /**
  * Id of the sandbox, the `sandboxID` returned by the create call (or listed by listSandboxes). Another team's sandbox and an unknown id both answer 404.
  */
@@ -32912,7 +33976,7 @@ export type ApplyAgentVersionResponses = {
          */
         note: string | null;
         /**
-         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
+         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
          */
         bindings: Array<{
             /**
@@ -32943,7 +34007,7 @@ export type ApplyAgentVersionResponses = {
             /**
              * Service type. Opens the whole service to codemode; there is no per-resource id.
              */
-            type: 'search' | 'browser';
+            type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
             /**
              * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
              */
@@ -34129,7 +35193,7 @@ export type UnarchiveAgentResponses = {
          */
         note: string | null;
         /**
-         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
+         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
          */
         bindings: Array<{
             /**
@@ -34160,7 +35224,7 @@ export type UnarchiveAgentResponses = {
             /**
              * Service type. Opens the whole service to codemode; there is no per-resource id.
              */
-            type: 'search' | 'browser';
+            type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
             /**
              * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
              */
@@ -43297,7 +44361,7 @@ export type FileCreateSignedUploadResponse = FileCreateSignedUploadResponses[key
 export type FileCreateContentUrlData = {
     body?: {
         /**
-         * Download link lifetime in seconds, from 1 through 604800; omitted means 3600. This does not change the file's own expiry.
+         * Download link lifetime in seconds, from 1 through 604800; omitted means 900. This does not change the file's own expiry.
          */
         ttl_seconds?: number;
     };
@@ -44843,31 +45907,29 @@ export type CreateSystemoneResponse = CreateSystemoneResponses[keyof CreateSyste
 export type CreateAudioTranscriptionData = {
     body: {
         /**
-         * Transcription model id, for example `whisper-large-v3-turbo` or `qwen3-asr-flash`; list candidates with listModels?type=transcription. Router support (supported): Verified to take effect.
+         * Model catalog identifier declaring openai.audio.transcriptions; use it unchanged, including any creator prefix.
          */
         model: string;
         /**
-         * Audio file to transcribe, uploaded as multipart/form-data. Router support (supported): Verified to take effect.
+         * Audio bytes uploaded as a multipart file; supported formats and input limits depend on the selected model.
          */
         file: Blob | File;
         /**
-         * Language of the audio as an ISO-639-1 code such as `en` or `zh`. Router support (partial): Both models accept ISO language codes. qwen3-asr-flash may translate output to that language; whisper-large-v3-turbo treats it as an input hint. Non-ISO names may return 502.
+         * Source language code when known; omit to let the model detect the language.
          */
         language?: string;
         /**
-         * Text that primes the model with vocabulary or context. Router support (partial): Vocabulary hints work on whisper-large-v3-turbo only; qwen3-asr-flash returns 400.
+         * Optional vocabulary or contextual guidance for recognizing the audio; support depends on the selected model.
          */
         prompt?: string;
         /**
-         * Format of the response body. `json` and `text` are the commonly supported formats. Router support (partial): json/text work on both; verbose_json works only on whisper-large-v3-turbo. srt/vtt return 400.
+         * Output format: json returns text in JSON; text returns plain text; verbose_json includes requested timestamps; diarized_json includes speaker-labelled segments when supported. Defaults to json.
          */
-        response_format?: 'json' | 'text' | 'verbose_json';
+        response_format?: 'json' | 'text' | 'verbose_json' | 'diarized_json';
         /**
-         * Timestamp levels to include with `verbose_json`; only `segment` exists in this schema. Router support (partial): Only whisper-large-v3-turbo supports segment with verbose_json. word returns 400; qwen3-asr-flash does not support timestamps.
+         * Timestamp levels to request as repeated multipart fields: word returns per-word times; segment returns segment times. Omit for the model default. Use verbose_json, or diarized_json on supporting models.
          */
-        'timestamp_granularities[]'?: [
-            'segment'
-        ];
+        'timestamp_granularities[]'?: Array<'word' | 'segment'>;
         /**
          * Both whisper-large-v3-turbo and qwen3-asr-flash return 400.
          */
@@ -44879,11 +45941,11 @@ export type CreateAudioTranscriptionData = {
 };
 export type CreateAudioTranscriptionErrors = {
     /**
-     * Unsupported or unrepresentable parameter.
+     * A field
      */
     400: unknown;
     /**
-     * No eligible model route.
+     * No provider route supports this request; select an available model and its declared transcription features.
      */
     503: unknown;
 };
@@ -44893,58 +45955,79 @@ export type CreateAudioTranscriptionResponses = {
      */
     200: {
         /**
-         * The transcribed text.
+         * Recognized speech text in the original language.
          */
         text: string;
         /**
-         * Task performed; always `transcribe`.
+         * transcribe identifies speech-to-text transcription.
          */
         task?: 'transcribe';
         /**
-         * Language of the audio as detected or as requested.
+         * Detected or requested source language code.
          */
         language?: string;
         /**
-         * Duration of the audio in seconds.
+         * Audio duration in seconds when provided by the model.
          */
         duration?: number;
         /**
-         * Segments with timestamps, returned with `verbose_json` on models that support it.
+         * Time-aligned speech segments when returned by the selected model and response format.
          */
         segments?: Array<{
             /**
-             * Zero-based index of the segment.
+             * Segment identifier within this transcription response.
              */
             id: number;
             /**
-             * Start time of the segment in seconds.
+             * Inclusive start time in seconds from the beginning of the audio.
              */
             start: number;
             /**
-             * End time of the segment in seconds.
+             * Exclusive end time in seconds from the beginning of the audio.
              */
             end: number;
             /**
-             * The transcribed text.
+             * Recognized speech text in the original language.
              */
             text: string;
             /**
-             * Sampling temperature used for the segment.
+             * Speaker label in diarized_json when supported; labels distinguish voices and are not verified identities.
+             */
+            speaker?: string;
+            /**
+             * Decoding temperature reported by the transcription model.
              */
             temperature?: number;
             /**
-             * Average log probability of the tokens of the segment; low values mean low confidence.
+             * Average segment token log probability when provided.
              */
             avg_logprob?: number;
             /**
-             * Gzip compression ratio of the segment text; high values indicate repetitive output.
+             * Text compression ratio reported for this segment.
              */
             compression_ratio?: number;
             /**
-             * Probability that the segment contains no speech.
+             * Probability of no speech reported for this segment.
              */
             no_speech_prob?: number;
         }>;
+        /**
+         * Per-word source-audio timestamps when word granularity is requested and supported.
+         */
+        words?: Array<{
+            /**
+             * Recognized word text in its original language.
+             */
+            word: string;
+            /**
+             * Inclusive word start in seconds from the beginning of the audio.
+             */
+            start: number;
+            /**
+             * Exclusive word end in seconds from the beginning of the audio.
+             */
+            end: number;
+        }>;
     };
 };
 export type CreateAudioTranscriptionResponse = CreateAudioTranscriptionResponses[keyof CreateAudioTranscriptionResponses];
@@ -50684,7 +51767,7 @@ export type AgentsListResponses = {
              */
             note: string | null;
             /**
-             * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
+             * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
              */
             bindings: Array<{
                 /**
@@ -50715,7 +51798,7 @@ export type AgentsListResponses = {
                 /**
                  * Service type. Opens the whole service to codemode; there is no per-resource id.
                  */
-                type: 'search' | 'browser';
+                type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
                 /**
                  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
                  */
@@ -51223,7 +52306,7 @@ export type AgentsCreateData = {
          */
         tools?: Array<AgentManaged15 | AgentManaged29 | AgentManaged32>;
         /**
-         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
+         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
          */
         bindings?: Array<{
             /**
@@ -51254,7 +52337,7 @@ export type AgentsCreateData = {
             /**
              * Service type. Opens the whole service to codemode; there is no per-resource id.
              */
-            type: 'search' | 'browser';
+            type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
             /**
              * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
              */
@@ -51824,7 +52907,7 @@ export type AgentsCreateResponses = {
          */
         note: string | null;
         /**
-         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
+         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
          */
         bindings: Array<{
             /**
@@ -51855,7 +52938,7 @@ export type AgentsCreateResponses = {
             /**
              * Service type. Opens the whole service to codemode; there is no per-resource id.
              */
-            type: 'search' | 'browser';
+            type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
             /**
              * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
              */
@@ -52452,7 +53535,7 @@ export type AgentsRetrieveResponses = {
          */
         note: string | null;
         /**
-         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
+         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
          */
         bindings: Array<{
             /**
@@ -52483,7 +53566,7 @@ export type AgentsRetrieveResponses = {
             /**
              * Service type. Opens the whole service to codemode; there is no per-resource id.
              */
-            type: 'search' | 'browser';
+            type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
             /**
              * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
              */
@@ -53031,7 +54114,7 @@ export type AgentsUpdateData = {
             /**
              * Service type. Opens the whole service to codemode; there is no per-resource id.
              */
-            type: 'search' | 'browser';
+            type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
             /**
              * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
              */
@@ -53614,7 +54697,7 @@ export type AgentsUpdateResponses = {
          */
         note: string | null;
         /**
-         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
+         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
          */
         bindings: Array<{
             /**
@@ -53645,7 +54728,7 @@ export type AgentsUpdateResponses = {
             /**
              * Service type. Opens the whole service to codemode; there is no per-resource id.
              */
-            type: 'search' | 'browser';
+            type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
             /**
              * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
              */
@@ -54228,7 +55311,7 @@ export type AgentsArchiveResponses = {
          */
         note: string | null;
         /**
-         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
+         * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
          */
         bindings: Array<{
             /**
@@ -54259,7 +55342,7 @@ export type AgentsArchiveResponses = {
             /**
              * Service type. Opens the whole service to codemode; there is no per-resource id.
              */
-            type: 'search' | 'browser';
+            type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
             /**
              * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
              */
@@ -54860,7 +55943,7 @@ export type AgentsVersionsListResponses = {
              */
             note: string | null;
             /**
-             * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search or browser. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
+             * Platform resources and services this service agent's codemode may reach, as one list of typed bindings. Only kind=service accepts a nonempty list; general and personal agents return 400. There are two kinds. A resource binding names one resource with id and access: database (id db_..., read_only or read_write), vector_store (id vs_..., read_only or read_write), file (id file- plus 24 letters or digits, as the File API returns it; read_only), media_library (any id without ':' or whitespace, read_only or read_write), model (a model catalog id, invoke), workflow and script (id <namespace>/<name>, invoke). A service binding opens a whole service and carries only enabled: search, browser, ticket, crm, canvas or cut. There is no binding by default; enabling one opens every public method of that service. At most 20 bindings per type, no repeated type and id, and each service type at most once. A session is authorized by the agent version it runs: newly added bindings apply only to new sessions, and a version saved with apply=false changes no access until it is applied. Applying a version that disables, removes or downgrades a binding revokes it immediately in running sessions on older versions. A resource that is not bound returns 404, a service that is not opened returns 403, and a write to a resource bound read_only returns 403 BINDING_READ_ONLY. Unknown types, fields on the wrong kind (id, access or instructions on a service binding), wrong access and malformed ids return 400. The former databases, vector_stores and files fields are removed and return 400. Omit on create for no bindings. Saving checks added or changed database, vector_store, media_library and file bindings in the organization: unknown or deleted ids return 400. If an owner is unavailable or takes more than 3 seconds, saving succeeds with verified=false for the affected bindings. Unchanged bindings keep their previous verification result and are not rechecked. workflow and script ids are not verified at save time.
              */
             bindings: Array<{
                 /**
@@ -54891,7 +55974,7 @@ export type AgentsVersionsListResponses = {
                 /**
                  * Service type. Opens the whole service to codemode; there is no per-resource id.
                  */
-                type: 'search' | 'browser';
+                type: 'search' | 'browser' | 'ticket' | 'crm' | 'canvas' | 'cut';
                 /**
                  * Save-time verification result. false means the resource owner was unavailable; saving still succeeded. Unchanged bindings retain their previous result. true is returned for other bindings, including workflow and script ids which are not verified at save time. Client values are ignored.
                  */
@@ -68652,7 +69735,7 @@ export type CutExecuteData = {
 };
 export type CutExecuteErrors = {
     /**
-     * SCRIPT_ERROR, SCRIPT_LIMIT or OPS_REJECTED means the script failed and its writes rolled back; correct the source using error.details.edit_id and edits when provided. EDIT_EXPIRED means the saved source is older than ten minutes; resubmit corrected script source.
+     * SCRIPT_ERROR, SCRIPT_LIMIT, OPS_REJECTED or INVALID_CAPTION_FILE means the script failed and its writes rolled back; correct the source using error.details.edit_id and edits when provided. EDIT_EXPIRED means the saved source is older than ten minutes; resubmit corrected script source.
      */
     400: CutCutError;
     /**
@@ -68817,7 +69900,7 @@ export type CutListFramesData = {
          */
         at: string;
         /**
-         * Positive image size multiplier; 0.5 renders at half the project dimensions.
+         * Image size multiplier, default 0.25, greater than zero and at most 0.5. Larger values return INVALID_PARAMS; pixel-area limits may reduce actual dimensions, reported as width and height.
          */
         scale?: number;
         /**
@@ -69159,7 +70242,7 @@ export type CutListExportsResponses = {
 export type CutListExportsResponse = CutListExportsResponses[keyof CutListExportsResponses];
 export type CutCreateExportData = {
     /**
-     * Start an export from a project revision into a bound library.
+     * Start an export from a project revision into a bound library. Output assets carry the cut-export tag and project_id, export_id and duration (seconds) context. Unavailable source metadata rejects creation with MEDIA_UNAVAILABLE and source clip and asset identities before rendering starts. Sources follow current asset versions; the current version is frozen at creation.
      */
     body: CutExportInput;
     path: {
@@ -70971,7 +72054,7 @@ export type KnowledgeListFilesResponses = {
 };
 export type KnowledgeListFilesResponse = KnowledgeListFilesResponses[keyof KnowledgeListFilesResponses];
 export type KnowledgeAttachFileData = {
-    body: KnowledgeAttachFile;
+    body: KnowledgeNativeAttachFile;
     path: {
         /**
          * Resource ID.
@@ -71272,7 +72355,7 @@ export type KnowledgeRetrieveFileContentResponses = {
 };
 export type KnowledgeRetrieveFileContentResponse = KnowledgeRetrieveFileContentResponses[keyof KnowledgeRetrieveFileContentResponses];
 export type KnowledgeCreateFileBatchData = {
-    body: KnowledgeCreateBatch;
+    body: KnowledgeNativeCreateBatch;
     path: {
         /**
          * Resource ID.
@@ -71960,6 +73043,10 @@ export type MediaListLibrariesErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72051,6 +73138,10 @@ export type MediaCreateLibraryErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72076,6 +73167,84 @@ export type MediaCreateLibraryResponses = {
     200: MediaLibrary;
 };
 export type MediaCreateLibraryResponse = MediaCreateLibraryResponses[keyof MediaCreateLibraryResponses];
+export type MediaCreateFrameUrlsData = {
+    body: {
+        /**
+         * One to twenty timestamps in microseconds from the start of the video. Each must be a nonnegative safe integer strictly below the video duration; order and duplicates are preserved.
+         */
+        at_micros: Array<number>;
+        /**
+         * Maximum JPEG width in pixels: 160 is a small thumbnail, 320 a preview and 640 a larger preview. Defaults to 640; larger widths are unavailable.
+         */
+        width?: 160 | 320 | 640;
+    };
+    path: {
+        /**
+         * Library identifier returned by library creation or listing; must be accessible to the current credential.
+         */
+        library_id: string;
+        /**
+         * Video asset identifier returned by asset upload or listing in this library; read its duration before choosing timestamps.
+         */
+        asset_id: string;
+    };
+    query?: never;
+    url: '/media/v1/libraries/{library_id}/assets/{asset_id}/frames';
+};
+export type MediaCreateFrameUrlsErrors = {
+    /**
+     * INVALID_PARAMS: supply 1–20 nonnegative integer timestamps below video duration and width 160, 320 or 640; images and audio cannot produce video frames.
+     */
+    400: MediaMediaError;
+    /**
+     * This credential has read-only access to the library; use a write-capable binding for mutations.
+     */
+    403: MediaMediaError;
+    /**
+     * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
+     */
+    404: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    409: MediaMediaError;
+    /**
+     * The file exceeds an input limit; provide a smaller source file.
+     */
+    413: MediaMediaError;
+    /**
+     * This media format is unsupported; provide a supported format.
+     */
+    415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
+    /**
+     * A rate limit was reached; wait before retrying.
+     */
+    429: MediaMediaError;
+    /**
+     * The requested operation is unsupported; choose a supported method.
+     */
+    501: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    502: MediaMediaError;
+    /**
+     * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
+     */
+    503: MediaMediaError;
+};
+export type MediaCreateFrameUrlsError = MediaCreateFrameUrlsErrors[keyof MediaCreateFrameUrlsErrors];
+export type MediaCreateFrameUrlsResponses = {
+    /**
+     * Successful response.
+     */
+    200: MediaFrameUrls;
+};
+export type MediaCreateFrameUrlsResponse = MediaCreateFrameUrlsResponses[keyof MediaCreateFrameUrlsResponses];
 export type MediaDeleteLibraryData = {
     body?: never;
     path: {
@@ -72112,6 +73281,10 @@ export type MediaDeleteLibraryErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72173,6 +73346,10 @@ export type MediaGetLibraryErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72203,6 +73380,10 @@ export type MediaUpdateLibraryData = {
      * Partial update of an active media library.
      */
     body: {
+        /**
+         * Correction vocabulary, at most 200 nonblank terms of at most 32 Unicode characters each. Omitted on an unconfigured library: correction derives up to 200 distinct names from the library name and every folder level, excluding generic names such as 原始素材 and 混剪成品. An explicit empty array disables this vocabulary. Updating affects subsequent understanding and explicit reprocessing, not existing results.
+         */
+        hotwords?: Array<string>;
         /**
          * Model role overrides. Omitted roles keep their current values on update and use defaults on creation; null restores all defaults, and a null role restores that role’s default. Changing embedding is rejected while the library contains assets.
          */
@@ -72269,6 +73450,10 @@ export type MediaUpdateLibraryErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72330,6 +73515,10 @@ export type MediaRestoreLibraryErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72391,6 +73580,10 @@ export type MediaPurgeLibraryErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72469,6 +73662,10 @@ export type MediaListAssetsErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72516,7 +73713,7 @@ export type MediaUploadAssetData = {
          */
         display_name?: string;
         /**
-         * Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected.
+         * Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out.
          */
         asset_folder?: string;
         /**
@@ -72558,7 +73755,7 @@ export type MediaUploadAssetData = {
          */
         resource_type?: 'image' | 'video' | 'raw' | 'auto';
         /**
-         * Asset delivery mode: upload is public; authenticated requires a signed URL or delivery token for originals and derivatives. private is unsupported. Defaults to upload.
+         * Asset delivery mode: upload is public; authenticated requires a signed URL or delivery token for originals and derivatives. private is unsupported. New assets default to authenticated. Omitting type on overwrite preserves the current type. Unlike Cloudinary, public delivery requires explicit type=upload.
          */
         type?: MediaDeliveryType;
     };
@@ -72606,6 +73803,10 @@ export type MediaUploadAssetErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72637,7 +73838,7 @@ export type MediaImportAssetData = {
      */
     body: {
         /**
-         * File ID to copy into this library instead of file bytes. This independent copy defaults to public delivery; set type=authenticated for private delivery. Deleting the source File does not delete this asset.
+         * File ID to copy into this library instead of file bytes. This independent copy defaults to organization-private delivery (type=authenticated); explicitly set type=upload for public delivery. Deleting the source File does not delete this asset.
          */
         file_id: string;
         /**
@@ -72653,7 +73854,7 @@ export type MediaImportAssetData = {
          */
         display_name?: string;
         /**
-         * Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected.
+         * Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out.
          */
         asset_folder?: string;
         /**
@@ -72695,7 +73896,7 @@ export type MediaImportAssetData = {
          */
         resource_type?: 'image' | 'video' | 'raw' | 'auto';
         /**
-         * Asset delivery mode: upload is public; authenticated requires a signed URL or delivery token for originals and derivatives. private is unsupported. Defaults to upload.
+         * Asset delivery mode: upload is public; authenticated requires a signed URL or delivery token for originals and derivatives. private is unsupported. New assets default to authenticated. Omitting type on overwrite preserves the current type. Unlike Cloudinary, public delivery requires explicit type=upload.
          */
         type?: MediaDeliveryType;
     };
@@ -72733,6 +73934,10 @@ export type MediaImportAssetErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72798,6 +74003,10 @@ export type MediaDeleteAssetErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72863,6 +74072,10 @@ export type MediaGetAssetErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72898,7 +74111,7 @@ export type MediaUpdateAssetData = {
          */
         display_name?: string;
         /**
-         * Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected.
+         * Organizational folder path, separate from public_id. Empty selects the root; leading or trailing slashes, empty path segments, and . or .. segments are rejected. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out.
          */
         asset_folder?: string;
         /**
@@ -72950,6 +74163,10 @@ export type MediaUpdateAssetErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -72981,7 +74198,7 @@ export type MediaReprocessAssetData = {
      */
     body: {
         /**
-         * Processing tasks to rerun. Omit to retry failed tasks only; explicit kinds rerun applicable ready, failed or unsupported tasks. Pending and running tasks are unchanged; an empty array does nothing.
+         * Processing tasks to rerun. Omit to retry failed tasks and legacy source-size unsupported tasks; explicit kinds rerun applicable ready or failed tasks and recoverable source-size unsupported tasks. Other unsupported causes remain unchanged. Pending and running tasks are unchanged; an empty array does nothing.
          */
         kinds?: Array<MediaProcessingKind>;
     };
@@ -73023,6 +74240,10 @@ export type MediaReprocessAssetErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -73066,9 +74287,9 @@ export type MediaListUnderstandingsData = {
          */
         include_superseded?: boolean;
         /**
-         * Result kind: caption is a visual description, tags are recognized labels, ocr is text recognized in the image, transcript is speech text, and frame is a description of a video segment.
+         * Return one output kind: caption is a visual description, tags are generated labels, ocr is visible text, transcript is speech, frame is a video shot, overview is a video summary, audio is sampled audio understanding, and embedding reports a failed embedding step.
          */
-        kind?: 'caption' | 'tags' | 'ocr' | 'transcript' | 'frame';
+        kind?: 'caption' | 'tags' | 'ocr' | 'transcript' | 'frame' | 'overview' | 'audio' | 'embedding';
         /**
          * Cursor from the previous next_cursor.
          */
@@ -73105,6 +74326,10 @@ export type MediaListUnderstandingsErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -73136,7 +74361,7 @@ export type MediaExpressionSearchData = {
      */
     body: {
         /**
-         * Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets. For business metadata use context.sku=KETTLE-RED AND context.revision=2; request with_field: ["context"] to include context.
+         * Asset filter expression supporting field comparisons, AND, OR, NOT, parentheses and suffix wildcards. An empty expression matches all assets. For business metadata use context.sku=KETTLE-RED AND context.revision=2; request with_field: ["context"] to include context. Quality filters: flags:watermark matches any current shot with a watermark; flags.watermark:false requires an assessed video with no positive watermark judgment. The same syntax supports slideshow, hand_frame, text_sticker and low_quality. folder_mismatch:true selects lexical folder/location hints. Geometry filters support width, height, resolution:1920x1080, numeric aspect_ratio (width/height), and orientation:landscape, portrait or square. Missing geometry or unassessed legacy flags do not match positive filters. has_music:true AND audio_genre:jazz AND audio_mood:calm selects current-version audio profiles with music and matching model labels; has_music:false applies only to sampled ranges, not the entire source. failure_code=UPSTREAM_FAILED selects assets with a current failed understanding carrying that code; combine with processing_state=failed or processing_state=partial.
          */
         expression?: string;
         /**
@@ -73196,6 +74421,10 @@ export type MediaExpressionSearchErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -73283,6 +74512,10 @@ export type MediaVisualSearchErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -73364,6 +74597,10 @@ export type MediaSemanticSearchErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -73445,6 +74682,10 @@ export type MediaSearchErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -73511,6 +74752,461 @@ export type MediaListFoldersErrors = {
      * Request failed; see the error code reference.
      */
     415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    429: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    501: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    502: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    503: MediaMediaError;
+};
+export type MediaListFoldersError = MediaListFoldersErrors[keyof MediaListFoldersErrors];
+export type MediaListFoldersResponses = {
+    /**
+     * Successful response.
+     */
+    200: MediaFolders;
+};
+export type MediaListFoldersResponse = MediaListFoldersResponses[keyof MediaListFoldersResponses];
+export type MediaCreateBatchData = {
+    /**
+     * Batch action and a selection frozen when the job is created.
+     */
+    body: MediaBatchAction & {
+        /**
+         * Select assets by ids or by expression, never both. Expression results and exclusions are resolved when the job is created.
+         */
+        selector: MediaBatchSelector;
+        /**
+         * Audit reason for the operation; required for staff Admin reprocessing and recorded with the initiating actor. Nonblank, at most 2000 characters.
+         */
+        reason?: string;
+    };
+    path: {
+        /**
+         * Library ID returned by creation.
+         */
+        library_id: string;
+    };
+    query?: never;
+    url: '/media/v1/libraries/{library_id}/batches';
+};
+export type MediaCreateBatchErrors = {
+    /**
+     * Request failed; see the error code reference.
+     */
+    400: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    403: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    404: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    409: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    413: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    429: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    501: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    502: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    503: MediaMediaError;
+};
+export type MediaCreateBatchError = MediaCreateBatchErrors[keyof MediaCreateBatchErrors];
+export type MediaCreateBatchResponses = {
+    /**
+     * Successful response.
+     */
+    200: MediaJob;
+};
+export type MediaCreateBatchResponse = MediaCreateBatchResponses[keyof MediaCreateBatchResponses];
+export type MediaGetBatchData = {
+    body?: never;
+    path: {
+        /**
+         * Library ID returned by creation.
+         */
+        library_id: string;
+        /**
+         * Batch identifier returned by createBatch or batchAssets; resolved within this library.
+         */
+        job_id: string;
+    };
+    query?: never;
+    url: '/media/v1/libraries/{library_id}/batches/{job_id}';
+};
+export type MediaGetBatchErrors = {
+    /**
+     * Request failed; see the error code reference.
+     */
+    400: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    403: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    404: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    409: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    413: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    429: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    501: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    502: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    503: MediaMediaError;
+};
+export type MediaGetBatchError = MediaGetBatchErrors[keyof MediaGetBatchErrors];
+export type MediaGetBatchResponses = {
+    /**
+     * Successful response.
+     */
+    200: MediaJob;
+};
+export type MediaGetBatchResponse = MediaGetBatchResponses[keyof MediaGetBatchResponses];
+export type MediaBatchAssetsData = {
+    /**
+     * Batch action and a selection frozen when the job is created.
+     */
+    body: MediaBatchAction & {
+        /**
+         * Select assets by ids or by expression, never both. Expression results and exclusions are resolved when the job is created.
+         */
+        selector: MediaBatchSelector;
+        /**
+         * Audit reason for the operation; required for staff Admin reprocessing and recorded with the initiating actor. Nonblank, at most 2000 characters.
+         */
+        reason?: string;
+    };
+    path: {
+        /**
+         * Library ID returned by creation.
+         */
+        library_id: string;
+    };
+    query?: never;
+    url: '/media/v1/libraries/{library_id}/assets:batch';
+};
+export type MediaBatchAssetsErrors = {
+    /**
+     * Request failed; see the error code reference.
+     */
+    400: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    403: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    404: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    409: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    413: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    429: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    501: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    502: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    503: MediaMediaError;
+};
+export type MediaBatchAssetsError = MediaBatchAssetsErrors[keyof MediaBatchAssetsErrors];
+export type MediaBatchAssetsResponses = {
+    /**
+     * Successful response.
+     */
+    200: MediaJob;
+};
+export type MediaBatchAssetsResponse = MediaBatchAssetsResponses[keyof MediaBatchAssetsResponses];
+export type MediaGetJobData = {
+    body?: never;
+    path: {
+        /**
+         * Library ID returned by creation.
+         */
+        library_id: string;
+        /**
+         * Job identifier returned by batch creation, video-generation creation or job listing; resolved within this library.
+         */
+        job_id: string;
+    };
+    query?: never;
+    url: '/media/v1/libraries/{library_id}/jobs/{job_id}';
+};
+export type MediaGetJobErrors = {
+    /**
+     * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
+     */
+    400: MediaMediaError;
+    /**
+     * This credential has read-only access to the library; use a write-capable binding for mutations.
+     */
+    403: MediaMediaError;
+    /**
+     * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
+     */
+    404: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    409: MediaMediaError;
+    /**
+     * The file exceeds an input limit; provide a smaller source file.
+     */
+    413: MediaMediaError;
+    /**
+     * This media format is unsupported; provide a supported format.
+     */
+    415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
+    /**
+     * A rate limit was reached; wait before retrying.
+     */
+    429: MediaMediaError;
+    /**
+     * The requested operation is unsupported; choose a supported method.
+     */
+    501: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    502: MediaMediaError;
+    /**
+     * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
+     */
+    503: MediaMediaError;
+};
+export type MediaGetJobError = MediaGetJobErrors[keyof MediaGetJobErrors];
+export type MediaGetJobResponses = {
+    /**
+     * Successful response.
+     */
+    200: MediaJob;
+};
+export type MediaGetJobResponse = MediaGetJobResponses[keyof MediaGetJobResponses];
+export type MediaListEventsData = {
+    body?: never;
+    path: {
+        /**
+         * Library ID returned by creation.
+         */
+        library_id: string;
+    };
+    query?: {
+        /**
+         * Events with a larger sequence. Use with asc; cannot combine with before_seq.
+         */
+        after_seq?: number;
+        /**
+         * Events with a smaller sequence. Use with desc; cannot combine with after_seq.
+         */
+        before_seq?: number;
+        /**
+         * Sequence order: asc is increasing; desc is decreasing.
+         */
+        order?: 'asc' | 'desc';
+        /**
+         * Maximum items per page, from 1 to 200; defaults to 50.
+         */
+        limit?: number;
+    };
+    url: '/media/v1/libraries/{library_id}/events';
+};
+export type MediaListEventsErrors = {
+    /**
+     * Request failed; see the error code reference.
+     */
+    400: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    403: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    404: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    409: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    413: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    429: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    501: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    502: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    503: MediaMediaError;
+};
+export type MediaListEventsError = MediaListEventsErrors[keyof MediaListEventsErrors];
+export type MediaListEventsResponses = {
+    /**
+     * Successful response.
+     */
+    200: MediaMediaEventPage;
+};
+export type MediaListEventsResponse = MediaListEventsResponses[keyof MediaListEventsResponses];
+export type MediaCreateDeliveryTokenData = {
+    /**
+     * Options for authorizing private asset delivery within one active library.
+     */
+    body: {
+        /**
+         * Delivery path glob restricted to the library path prefix (a slash, library_id, then a slash). Defaults to that prefix followed by *; * matches any path text. Tildes and control characters are rejected.
+         */
+        acl?: string;
+        /**
+         * Token lifetime in seconds, from 1 to 604800 inclusive; defaults to 900.
+         */
+        expires_in?: number;
+    };
+    path: {
+        /**
+         * Library ID returned by creation.
+         */
+        library_id: string;
+    };
+    query?: never;
+    url: '/media/v1/libraries/{library_id}/delivery_tokens';
+};
+export type MediaCreateDeliveryTokenErrors = {
+    /**
+     * Request failed; see the error code reference.
+     */
+    400: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    403: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    404: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    409: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    413: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
@@ -73528,24 +75224,16 @@ export type MediaListFoldersErrors = {
      */
     503: MediaMediaError;
 };
-export type MediaListFoldersError = MediaListFoldersErrors[keyof MediaListFoldersErrors];
-export type MediaListFoldersResponses = {
+export type MediaCreateDeliveryTokenError = MediaCreateDeliveryTokenErrors[keyof MediaCreateDeliveryTokenErrors];
+export type MediaCreateDeliveryTokenResponses = {
     /**
      * Successful response.
      */
-    200: MediaFolders;
+    200: MediaDeliveryToken;
 };
-export type MediaListFoldersResponse = MediaListFoldersResponses[keyof MediaListFoldersResponses];
-export type MediaCreateBatchData = {
-    /**
-     * Batch action and a selection frozen when the job is created.
-     */
-    body: MediaBatchAction & {
-        /**
-         * Select assets by ids or by expression, never both. Expression results and exclusions are resolved when the job is created.
-         */
-        selector: MediaBatchSelector;
-    };
+export type MediaCreateDeliveryTokenResponse = MediaCreateDeliveryTokenResponses[keyof MediaCreateDeliveryTokenResponses];
+export type MediaUnderstandingFailureSummaryData = {
+    body?: never;
     path: {
         /**
          * Library ID returned by creation.
@@ -73553,19 +75241,19 @@ export type MediaCreateBatchData = {
         library_id: string;
     };
     query?: never;
-    url: '/media/v1/libraries/{library_id}/batches';
+    url: '/media/v1/libraries/{library_id}/understandings/failure_summary';
 };
-export type MediaCreateBatchErrors = {
+export type MediaUnderstandingFailureSummaryErrors = {
     /**
-     * Request failed; see the error code reference.
+     * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
      */
     400: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This credential has read-only access to the library; use a write-capable binding for mutations.
      */
     403: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
      */
     404: MediaMediaError;
     /**
@@ -73573,19 +75261,23 @@ export type MediaCreateBatchErrors = {
      */
     409: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The file exceeds an input limit; provide a smaller source file.
      */
     413: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This media format is unsupported; provide a supported format.
      */
     415: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
+    422: MediaMediaError;
+    /**
+     * A rate limit was reached; wait before retrying.
+     */
     429: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The requested operation is unsupported; choose a supported method.
      */
     501: MediaMediaError;
     /**
@@ -73593,44 +75285,57 @@ export type MediaCreateBatchErrors = {
      */
     502: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
      */
     503: MediaMediaError;
 };
-export type MediaCreateBatchError = MediaCreateBatchErrors[keyof MediaCreateBatchErrors];
-export type MediaCreateBatchResponses = {
+export type MediaUnderstandingFailureSummaryError = MediaUnderstandingFailureSummaryErrors[keyof MediaUnderstandingFailureSummaryErrors];
+export type MediaUnderstandingFailureSummaryResponses = {
     /**
      * Successful response.
      */
-    200: MediaJob;
+    200: MediaFailureSummary;
 };
-export type MediaCreateBatchResponse = MediaCreateBatchResponses[keyof MediaCreateBatchResponses];
-export type MediaGetBatchData = {
+export type MediaUnderstandingFailureSummaryResponse = MediaUnderstandingFailureSummaryResponses[keyof MediaUnderstandingFailureSummaryResponses];
+export type MediaListUnderstandingsByLibraryData = {
     body?: never;
     path: {
         /**
          * Library ID returned by creation.
          */
         library_id: string;
+    };
+    query?: {
         /**
-         * Batch identifier returned by createBatch or batchAssets; resolved within this library.
+         * Folder path including all descendants; omitted or empty selects the entire library.
          */
-        job_id: string;
+        folder?: string;
+        /**
+         * Comma-separated output kinds: caption, tags, ocr, frame, transcript, overview, audio, embedding. Omit or empty to include every kind.
+         */
+        kinds?: string;
+        /**
+         * Cursor from the previous next_cursor.
+         */
+        cursor?: string;
+        /**
+         * Maximum entries in this page, from 1 through 100; defaults to 100.
+         */
+        limit?: number;
     };
-    query?: never;
-    url: '/media/v1/libraries/{library_id}/batches/{job_id}';
+    url: '/media/v1/libraries/{library_id}/understandings';
 };
-export type MediaGetBatchErrors = {
+export type MediaListUnderstandingsByLibraryErrors = {
     /**
-     * Request failed; see the error code reference.
+     * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
      */
     400: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This credential has read-only access to the library; use a write-capable binding for mutations.
      */
     403: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
      */
     404: MediaMediaError;
     /**
@@ -73638,19 +75343,23 @@ export type MediaGetBatchErrors = {
      */
     409: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The file exceeds an input limit; provide a smaller source file.
      */
     413: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This media format is unsupported; provide a supported format.
      */
     415: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
+    422: MediaMediaError;
+    /**
+     * A rate limit was reached; wait before retrying.
+     */
     429: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The requested operation is unsupported; choose a supported method.
      */
     501: MediaMediaError;
     /**
@@ -73658,27 +75367,73 @@ export type MediaGetBatchErrors = {
      */
     502: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
      */
     503: MediaMediaError;
 };
-export type MediaGetBatchError = MediaGetBatchErrors[keyof MediaGetBatchErrors];
-export type MediaGetBatchResponses = {
+export type MediaListUnderstandingsByLibraryError = MediaListUnderstandingsByLibraryErrors[keyof MediaListUnderstandingsByLibraryErrors];
+export type MediaListUnderstandingsByLibraryResponses = {
     /**
      * Successful response.
      */
-    200: MediaJob;
+    200: MediaUnderstandingPage;
 };
-export type MediaGetBatchResponse = MediaGetBatchResponses[keyof MediaGetBatchResponses];
-export type MediaBatchAssetsData = {
+export type MediaListUnderstandingsByLibraryResponse = MediaListUnderstandingsByLibraryResponses[keyof MediaListUnderstandingsByLibraryResponses];
+export type MediaCreateGenerationData = {
     /**
-     * Batch action and a selection frozen when the job is created.
+     * Text-to-video request. Generation is charged per second; unsaved candidates expire after 7 days.
      */
-    body: MediaBatchAction & {
+    body: {
         /**
-         * Select assets by ids or by expression, never both. Expression results and exclusions are resolved when the job is created.
+         * Generation operation; v1 accepts only video.generate text-to-video requests.
          */
-        selector: MediaBatchSelector;
+        intent: 'video.generate';
+        /**
+         * Text prompt describing the video to generate.
+         */
+        prompt: string;
+        /**
+         * Number of videos to generate; defaults to 1 and must be from 1 to 4.
+         */
+        count?: number;
+        /**
+         * Requested video duration in seconds; Router validates the model-specific supported durations.
+         */
+        duration_seconds?: number;
+        /**
+         * Requested output aspect ratio; defaults to 16:9 and Router validates model support.
+         */
+        aspect_ratio?: string;
+        /**
+         * Router model with video_generation capability; defaults to wan2.7-t2v.
+         */
+        model?: string;
+        /**
+         * candidate keeps outputs temporary for explicit save calls; library saves successful outputs automatically.
+         */
+        save?: 'candidate' | 'library';
+        /**
+         * Folder for assets saved automatically or by later save calls; defaults to the library root. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out.
+         */
+        asset_folder?: string;
+        /**
+         * Tags applied when an output becomes a library asset.
+         */
+        tags?: Array<string>;
+        /**
+         * Understanding behavior when a candidate is saved as an asset; defaults to auto.
+         */
+        understanding?: 'auto' | 'skip';
+        /**
+         * Not supported in v1; omit this field. Only text-to-video is currently available.
+         */
+        references?: Array<unknown>;
+    };
+    headers?: {
+        /**
+         * Stable key for retrying the same request without creating or charging for another job; reusing it with different request content is rejected.
+         */
+        'Idempotency-Key'?: string;
     };
     path: {
         /**
@@ -73687,19 +75442,19 @@ export type MediaBatchAssetsData = {
         library_id: string;
     };
     query?: never;
-    url: '/media/v1/libraries/{library_id}/assets:batch';
+    url: '/media/v1/libraries/{library_id}/generations';
 };
-export type MediaBatchAssetsErrors = {
+export type MediaCreateGenerationErrors = {
     /**
-     * Request failed; see the error code reference.
+     * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
      */
     400: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This credential has read-only access to the library; use a write-capable binding for mutations.
      */
     403: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
      */
     404: MediaMediaError;
     /**
@@ -73707,19 +75462,23 @@ export type MediaBatchAssetsErrors = {
      */
     409: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The file exceeds an input limit; provide a smaller source file.
      */
     413: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This media format is unsupported; provide a supported format.
      */
     415: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
+    422: MediaMediaError;
+    /**
+     * This library already has five queued or running generation jobs; wait until one finishes and retry.
+     */
     429: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The requested operation is unsupported; choose a supported method.
      */
     501: MediaMediaError;
     /**
@@ -73727,44 +75486,53 @@ export type MediaBatchAssetsErrors = {
      */
     502: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
      */
     503: MediaMediaError;
 };
-export type MediaBatchAssetsError = MediaBatchAssetsErrors[keyof MediaBatchAssetsErrors];
-export type MediaBatchAssetsResponses = {
+export type MediaCreateGenerationError = MediaCreateGenerationErrors[keyof MediaCreateGenerationErrors];
+export type MediaCreateGenerationResponses = {
     /**
      * Successful response.
      */
-    200: MediaJob;
+    202: MediaJob;
 };
-export type MediaBatchAssetsResponse = MediaBatchAssetsResponses[keyof MediaBatchAssetsResponses];
-export type MediaGetJobData = {
+export type MediaCreateGenerationResponse = MediaCreateGenerationResponses[keyof MediaCreateGenerationResponses];
+export type MediaListJobsData = {
     body?: never;
     path: {
         /**
          * Library ID returned by creation.
          */
         library_id: string;
+    };
+    query?: {
         /**
-         * Batch identifier returned by createBatch or batchAssets; resolved within this library.
+         * Filter jobs by their current status.
          */
-        job_id: string;
+        status?: MediaJobStatus;
+        /**
+         * Maximum entries in this page, from 1 through 100; defaults to 100.
+         */
+        limit?: number;
+        /**
+         * Job id from the previous page’s next_cursor; omit for the first page.
+         */
+        cursor?: MediaJobId;
     };
-    query?: never;
-    url: '/media/v1/libraries/{library_id}/jobs/{job_id}';
+    url: '/media/v1/libraries/{library_id}/jobs';
 };
-export type MediaGetJobErrors = {
+export type MediaListJobsErrors = {
     /**
-     * Request failed; see the error code reference.
+     * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
      */
     400: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This credential has read-only access to the library; use a write-capable binding for mutations.
      */
     403: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
      */
     404: MediaMediaError;
     /**
@@ -73772,19 +75540,23 @@ export type MediaGetJobErrors = {
      */
     409: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The file exceeds an input limit; provide a smaller source file.
      */
     413: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This media format is unsupported; provide a supported format.
      */
     415: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
+    422: MediaMediaError;
+    /**
+     * A rate limit was reached; wait before retrying.
+     */
     429: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The requested operation is unsupported; choose a supported method.
      */
     501: MediaMediaError;
     /**
@@ -73792,57 +75564,44 @@ export type MediaGetJobErrors = {
      */
     502: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
      */
     503: MediaMediaError;
 };
-export type MediaGetJobError = MediaGetJobErrors[keyof MediaGetJobErrors];
-export type MediaGetJobResponses = {
+export type MediaListJobsError = MediaListJobsErrors[keyof MediaListJobsErrors];
+export type MediaListJobsResponses = {
     /**
      * Successful response.
      */
-    200: MediaJob;
+    200: MediaJobPage;
 };
-export type MediaGetJobResponse = MediaGetJobResponses[keyof MediaGetJobResponses];
-export type MediaListEventsData = {
+export type MediaListJobsResponse = MediaListJobsResponses[keyof MediaListJobsResponses];
+export type MediaCancelJobData = {
     body?: never;
     path: {
         /**
          * Library ID returned by creation.
          */
         library_id: string;
-    };
-    query?: {
-        /**
-         * Events with a larger sequence. Use with asc; cannot combine with before_seq.
-         */
-        after_seq?: number;
-        /**
-         * Events with a smaller sequence. Use with desc; cannot combine with after_seq.
-         */
-        before_seq?: number;
-        /**
-         * Sequence order: asc is increasing; desc is decreasing.
-         */
-        order?: 'asc' | 'desc';
         /**
-         * Maximum items per page, from 1 to 200; defaults to 50.
+         * Job identifier returned by batch or generation creation; the job is resolved within the specified library.
          */
-        limit?: number;
+        job_id: string;
     };
-    url: '/media/v1/libraries/{library_id}/events';
+    query?: never;
+    url: '/media/v1/libraries/{library_id}/jobs/{job_id}/cancel';
 };
-export type MediaListEventsErrors = {
+export type MediaCancelJobErrors = {
     /**
-     * Request failed; see the error code reference.
+     * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
      */
     400: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This credential has read-only access to the library; use a write-capable binding for mutations.
      */
     403: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
      */
     404: MediaMediaError;
     /**
@@ -73850,19 +75609,23 @@ export type MediaListEventsErrors = {
      */
     409: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The file exceeds an input limit; provide a smaller source file.
      */
     413: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This media format is unsupported; provide a supported format.
      */
     415: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
+    422: MediaMediaError;
+    /**
+     * A rate limit was reached; wait before retrying.
+     */
     429: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The requested operation is unsupported; choose a supported method.
      */
     501: MediaMediaError;
     /**
@@ -73870,52 +75633,68 @@ export type MediaListEventsErrors = {
      */
     502: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
      */
     503: MediaMediaError;
 };
-export type MediaListEventsError = MediaListEventsErrors[keyof MediaListEventsErrors];
-export type MediaListEventsResponses = {
+export type MediaCancelJobError = MediaCancelJobErrors[keyof MediaCancelJobErrors];
+export type MediaCancelJobResponses = {
     /**
      * Successful response.
      */
-    200: MediaMediaEventPage;
+    200: MediaJob;
 };
-export type MediaListEventsResponse = MediaListEventsResponses[keyof MediaListEventsResponses];
-export type MediaCreateDeliveryTokenData = {
+export type MediaCancelJobResponse = MediaCancelJobResponses[keyof MediaCancelJobResponses];
+export type MediaSaveGenerationOutputData = {
     /**
-     * Options for authorizing private asset delivery within one active library.
+     * Optional asset metadata and understanding behavior for a successful candidate.
      */
-    body: {
+    body?: {
         /**
-         * Delivery path glob restricted to the library path prefix (a slash, library_id, then a slash). Defaults to that prefix followed by *; * matches any path text. Tildes and control characters are rejected.
+         * Delivery identifier for the saved asset; defaults to gen_<job_id>_<index> and is idempotent.
          */
-        acl?: string;
+        public_id?: string;
         /**
-         * Token lifetime in seconds, from 1 to 604800 inclusive; defaults to 3600.
+         * Destination folder for the saved asset; defaults to the library root. New path segments containing U+FFFD or consisting only of question marks are rejected with INVALID_PARAMS; send UTF-8 names. Existing affected folders remain readable and assets can be moved out.
          */
-        expires_in?: number;
+        asset_folder?: string;
+        /**
+         * Tags to apply to the saved asset.
+         */
+        tags?: Array<string>;
+        /**
+         * Understanding behavior for the saved asset; defaults to auto.
+         */
+        understanding?: 'auto' | 'skip';
     };
     path: {
         /**
          * Library ID returned by creation.
          */
         library_id: string;
+        /**
+         * Job identifier returned by batch or generation creation; the job is resolved within the specified library.
+         */
+        job_id: string;
+        /**
+         * Zero-based position of the candidate in the Job outputs array.
+         */
+        index: string;
     };
     query?: never;
-    url: '/media/v1/libraries/{library_id}/delivery_tokens';
+    url: '/media/v1/libraries/{library_id}/jobs/{job_id}/outputs/{index}/save';
 };
-export type MediaCreateDeliveryTokenErrors = {
+export type MediaSaveGenerationOutputErrors = {
     /**
-     * Request failed; see the error code reference.
+     * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
      */
     400: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This credential has read-only access to the library; use a write-capable binding for mutations.
      */
     403: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The job or output is inaccessible, missing, or the candidate has expired; verify library ownership and create a new job for an expired candidate.
      */
     404: MediaMediaError;
     /**
@@ -73923,38 +75702,102 @@ export type MediaCreateDeliveryTokenErrors = {
      */
     409: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The file exceeds an input limit; provide a smaller source file.
      */
     413: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * This media format is unsupported; provide a supported format.
      */
     415: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
+    422: MediaMediaError;
+    /**
+     * A rate limit was reached; wait before retrying.
+     */
     429: MediaMediaError;
     /**
-     * Request failed; see the error code reference.
+     * The requested operation is unsupported; choose a supported method.
      */
     501: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
     502: MediaMediaError;
+    /**
+     * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
+     */
+    503: MediaMediaError;
+};
+export type MediaSaveGenerationOutputError = MediaSaveGenerationOutputErrors[keyof MediaSaveGenerationOutputErrors];
+export type MediaSaveGenerationOutputResponses = {
+    /**
+     * Successful response.
+     */
+    200: MediaAsset;
+};
+export type MediaSaveGenerationOutputResponse = MediaSaveGenerationOutputResponses[keyof MediaSaveGenerationOutputResponses];
+export type MediaGetGenerationCapabilitiesData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: '/media/v1/generation/capabilities';
+};
+export type MediaGetGenerationCapabilitiesErrors = {
+    /**
+     * A selector, cursor, limit or other parameter is invalid; correct the reported field before retrying.
+     */
+    400: MediaMediaError;
+    /**
+     * This credential has read-only access to the library; use a write-capable binding for mutations.
+     */
+    403: MediaMediaError;
+    /**
+     * The library or asset is missing, deleted or belongs to another tenant; verify its identifier and owner.
+     */
+    404: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    409: MediaMediaError;
+    /**
+     * The file exceeds an input limit; provide a smaller source file.
+     */
+    413: MediaMediaError;
+    /**
+     * This media format is unsupported; provide a supported format.
+     */
+    415: MediaMediaError;
+    /**
+     * Request failed; see the error code reference.
+     */
+    422: MediaMediaError;
+    /**
+     * A rate limit was reached; wait before retrying.
+     */
+    429: MediaMediaError;
+    /**
+     * The requested operation is unsupported; choose a supported method.
+     */
+    501: MediaMediaError;
     /**
      * Request failed; see the error code reference.
      */
+    502: MediaMediaError;
+    /**
+     * Historical projections are still being initialized, or library storage is temporarily unavailable; retry shortly and check failureSummary counts_complete.
+     */
     503: MediaMediaError;
 };
-export type MediaCreateDeliveryTokenError = MediaCreateDeliveryTokenErrors[keyof MediaCreateDeliveryTokenErrors];
-export type MediaCreateDeliveryTokenResponses = {
+export type MediaGetGenerationCapabilitiesError = MediaGetGenerationCapabilitiesErrors[keyof MediaGetGenerationCapabilitiesErrors];
+export type MediaGetGenerationCapabilitiesResponses = {
     /**
      * Successful response.
      */
-    200: MediaDeliveryToken;
+    200: MediaGenerationCapabilities;
 };
-export type MediaCreateDeliveryTokenResponse = MediaCreateDeliveryTokenResponses[keyof MediaCreateDeliveryTokenResponses];
+export type MediaGetGenerationCapabilitiesResponse = MediaGetGenerationCapabilitiesResponses[keyof MediaGetGenerationCapabilitiesResponses];
 export type GetSandboxV1SandboxesData = {
     body?: never;
     path?: never;
@@ -74347,6 +76190,10 @@ export type ListSandboxTemplatesResponses = {
         buildCount: number;
         envdVersion: SandboxEnvdVersion;
         buildStatus: SandboxTemplateBuildStatus;
+        /**
+         * Lifecycle classes this template can run as. ephemeral: cannot pause, snapshot or mount volumes and is deleted when it stops; persistent: can pause, resume and snapshot.
+         */
+        lifecycles?: Array<'ephemeral' | 'persistent'>;
         /**
          * True for an official catalog template; false for your organization's custom templates.
          */
@@ -76550,7 +78397,7 @@ export type TicketGetTicketsData = {
          */
         page_token?: string;
         /**
-         * Filter expression.
+         * Filter expression using field:value qualifiers, such as is:open milestone:5.
          */
         filter?: string;
     };
@@ -78969,7 +80816,7 @@ export type TicketGetActivityData = {
          */
         page_token?: string;
         /**
-         * Filter expression.
+         * Activity filter expression.
          */
         filter?: string;
     };