@deepraxis/sdk 0.1.1-dev.cc34a92 → 0.1.1-dev.d54e526

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.
      */
@@ -12789,13 +12789,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 +12992,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.
@@ -13027,9 +13039,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 +13073,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.
      */
@@ -13583,7 +13616,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 +13780,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 +13790,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 +13827,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 +13836,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 +13933,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 +13942,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 +13953,7 @@ export type KnowledgeCreateBatch = {
          */
         file_id: string;
         attributes?: KnowledgeAttributes;
-        chunking_strategy?: KnowledgeChunkingInput;
+        chunking_strategy?: KnowledgeNativeChunkingInput;
     }>;
     /**
      * Ignored when files is supplied.
@@ -14039,6 +14072,14 @@ 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.
+     */
+    readonly progress?: MediaUnderstandingProgress;
     /**
      * Search capabilities of this library’s embedding model.
      */
@@ -14119,9 +14160,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.
@@ -14136,6 +14189,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.
  */
@@ -14295,7 +14367,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;
     /**
@@ -14404,6 +14476,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.
@@ -14487,7 +14563,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.
@@ -14502,9 +14590,9 @@ 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';
     /**
      * 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.
      */
@@ -14514,7 +14602,7 @@ export type MediaJob = {
      */
     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;
     /**
@@ -14580,6 +14668,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.
@@ -14625,6 +14722,20 @@ 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;
+};
 /**
  * Sandbox creation request. All system communication with the sandbox is always secured; the template's envd version must support secured access.
  */
@@ -24975,6 +25086,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.
      */
@@ -25010,11 +25125,11 @@ export type CutSummary = {
     lines: Array<string>;
 };
 /**
- * Rendered image available until its signed URL expires.
+ * Rendered PNG image carried inline as a data URL.
  */
 export type CutRenderRef = {
     /**
-     * Fetchable image URL for this render result.
+     * Inline PNG data URL (data:image/png;base64,...); decode the base64 payload to save the image. This is not a hosted HTTP image link.
      */
     url: string;
     /**
@@ -25026,7 +25141,7 @@ export type CutRenderRef = {
      */
     height: number;
     /**
-     * ISO 8601 timestamp after which the image URL must be refreshed.
+     * ISO 8601 freshness timestamp for the render result; the inline data URL contains the image bytes and does not require a network refresh.
      */
     expires_at: string;
 };
@@ -25298,14 +25413,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.
  */
@@ -25360,6 +25470,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.
          */
@@ -25423,14 +25537,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.
  */
@@ -25515,7 +25624,34 @@ export type KnowledgeEvent = {
     };
 };
 /**
- * Resolved model call IDs for the library’s vision, embedding and transcription roles.
+ * Asset understanding progress. Completion rate counts assets reaching ready, partial or failed in the last 60 minute buckets, including reprocessing completions.
+ */
+export type MediaUnderstandingProgress = {
+    /**
+     * Number of active assets in each aggregate processing state: pending, processing, ready, partial and failed. Historical counts are complete when migration_complete is true.
+     */
+    readonly counts: {
+        [key: string]: number;
+    };
+    /**
+     * Assets reaching a terminal processing state in the last 60 minute buckets. Reprocessing can complete an asset again.
+     */
+    readonly completed_last_hour: number;
+    /**
+     * Observed completion rate in assets per hour, equal to completed_last_hour.
+     */
+    readonly completion_rate_per_hour: number;
+    /**
+     * Estimated UTC completion time: now plus pending and processing assets divided by the observed hourly rate. Null while historical counts are incomplete, no work remains, or the rate is zero.
+     */
+    readonly estimated_completion_at: MediaIsoTimestamp | null;
+    /**
+     * True after historical assets have been counted and their pending understanding instances dispatched.
+     */
+    readonly migration_complete: boolean;
+};
+/**
+ * Resolved model call IDs for vision, embedding, timestamped transcription, reference transcription and correction.
  */
 export type MediaMediaModels = {
     /**
@@ -25527,9 +25663,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.
@@ -25690,7 +25838,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;
     /**
@@ -25726,9 +25874,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, 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' | '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.
@@ -25770,6 +25922,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.
      */
@@ -25783,7 +25947,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;
     /**
@@ -25807,7 +25971,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;
     /**
@@ -25836,6 +26000,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.
  */
@@ -25953,7 +26147,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;
     /**
@@ -26106,6 +26300,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.
  */
@@ -30432,6 +30656,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.
  */
@@ -30449,23 +30699,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;
     };
 };
 /**
@@ -30505,6 +30771,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.
  */
@@ -30513,14 +30788,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.
  */
@@ -30534,6 +30861,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.
  */
@@ -30558,7 +30907,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';
 /**
  * Auto-resume enabled flag for paused sandboxes. Default false.
  */
@@ -31231,9 +31580,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.
      */
@@ -31345,6 +31698,136 @@ 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;
+};
+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.
@@ -31606,6 +32089,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.
@@ -31793,222 +32286,1048 @@ export type PraxisSdkSseGetAutomationV1RunsIdLogs = ({
     /**
      * Always an empty object for the end event.
      */
-    data?: {
-        [key: string]: unknown;
+    data?: {
+        [key: string]: unknown;
+    };
+}) & {
+    /**
+     * Resume cursor of this entry; send it back as Last-Event-ID, or as cursor on the JSON form, to continue after it. Absent on the end event.
+     */
+    id?: string;
+    /**
+     * SSE event name: log carries one log line in data; end is sent once when the run has reached a terminal status and closes the stream.
+     */
+    event: 'log' | 'end';
+    /**
+     * Decoded JSON of one log line; for the end event, an empty object.
+     */
+    data: AutomationLogLine | {
+        [key: string]: unknown;
+    };
+};
+/**
+ * Free-form string key/value pairs stored with the agent for your own bookkeeping.
+ */
+export type AgentManaged37Writable = {
+    [key: string]: string;
+};
+/**
+ * Models to use for completion
+ */
+export type OpenaiChatModelNamesWritable = Array<OpenaiModelName & unknown>;
+/**
+ * Free-form string key/value pairs stored with the session, changed through sessions.update patch semantics.
+ */
+export type AgentManaged173Writable = {
+    [key: string]: string;
+};
+export type AgentManaged183Writable = {
+    [key: string]: null | string;
+};
+/**
+ * Free-form string key/value pairs.
+ */
+export type AgentManaged8Writable = {
+    [key: string]: string;
+};
+export type AgentManaged58Writable = {
+    [key: string]: null | string;
+};
+/**
+ * Free-form string key/value pairs.
+ */
+export type AgentManaged168Writable = {
+    [key: string]: string;
+};
+/**
+ * Arguments the model passed to the tool.
+ */
+export type AgentManaged197Writable = {
+    [key: string]: unknown;
+};
+/**
+ * Arguments the model passed to the tool.
+ */
+export type AgentManaged206Writable = {
+    [key: string]: unknown;
+};
+/**
+ * Session metadata after the change.
+ */
+export type AgentManaged246Writable = {
+    [key: string]: string;
+};
+/**
+ * Free-form string key/value pairs.
+ */
+export type AgentManaged144Writable = {
+    [key: string]: null | string;
+};
+/**
+ * Free-form string key/value pairs.
+ */
+export type AgentManaged137Writable = {
+    [key: string]: string;
+};
+/**
+ * Free-form string key/value pairs.
+ */
+export type AgentManaged91Writable = {
+    [key: string]: string;
+};
+/**
+ * Free-form string key/value pairs.
+ */
+export type AgentManaged78Writable = {
+    [key: string]: string;
+};
+export type AgentManaged112Writable = {
+    [key: string]: null | string;
+};
+/**
+ * Any JSON value: null, boolean, number, string, array or object.
+ */
+export type AutomationJsonValueWritable = null | string | number | boolean | AutomationJsonObjectWritable | Array<AutomationJsonValueWritable>;
+/**
+ * Any JSON object whose keys are strings and whose values are any JSON value.
+ */
+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.
+ */
+export type MediaLibraryWritable = {
+    /**
+     * Resolved model call IDs used for new uploads and reprocessing.
+     */
+    models: MediaMediaModelsWritable;
+    /**
+     * Generated library identifier: lib_ followed by 32 lowercase hexadecimal characters.
+     */
+    id: MediaLibraryId;
+    /**
+     * Display name of the library; duplicate names are allowed.
+     */
+    name: string;
+    /**
+     * Caller-defined string labels used to organize and filter libraries.
+     */
+    labels: {
+        [key: string]: string;
+    };
+    /**
+     * Library lifecycle: provisioning initializes the library; active permits asset operations; deleting awaits purge and may be restored before purge_at; deleted has been purged; failed indicates initialization failure.
+     */
+    status: MediaLibraryStatus;
+    /**
+     * Number of assets currently stored in the library.
+     */
+    asset_count: number;
+    /**
+     * Total source-content size of the library’s assets, in bytes.
+     */
+    bytes: number;
+    /**
+     * Settings controlling understanding tasks for new uploads.
+     */
+    understanding: MediaUnderstandingSettings;
+    /**
+     * Time the library was created, in UTC.
+     */
+    created_at: MediaIsoTimestamp;
+    /**
+     * Time library settings, lifecycle or usage were last updated, in UTC.
+     */
+    updated_at: MediaIsoTimestamp;
+    /**
+     * Time the library entered deleting, or null when active or restored.
+     */
+    deleted_at: MediaIsoTimestamp | null;
+    /**
+     * Scheduled purge time while the library is deleting; null for an active or restored library.
+     */
+    purge_at: MediaIsoTimestamp | null;
+};
+/**
+ * Libraries in this page, ordered by creation time descending.
+ */
+export type MediaLibraryPageWritable = MediaPage & {
+    /**
+     * Libraries in this page, ordered by creation time descending.
+     */
+    data: Array<MediaLibraryWritable>;
+    /**
+     * Opaque token to pass as cursor to listLibraries; null means no further page.
+     */
+    next_cursor: string | null;
+};
+/**
+ * Assets in this page, ordered by creation time descending.
+ */
+export type MediaAssetPageWritable = MediaPage & {
+    /**
+     * Assets in this page, ordered by creation time descending.
+     */
+    data: Array<MediaAssetWritable>;
+    /**
+     * Opaque token to pass as cursor to listAssets; null means no further page.
+     */
+    next_cursor: string | null;
+};
+/**
+ * Upload response: a resource for a normal upload, an acknowledgement for an incomplete chunk, or a resource with done=true for the final chunk.
+ */
+export type MediaUploadResultWritable = MediaCloudinaryResourceWritable | MediaChunkPending | MediaChunkCompleteWritable;
+/**
+ * A media resource with its library, content hash, processing progress and semantic-search availability.
+ */
+export type MediaAssetWritable = {
+    /**
+     * Generated asset identifier: 32 lowercase hexadecimal characters, preserved across overwrites.
+     */
+    asset_id: MediaAssetId;
+    /**
+     * Delivery identifier unique within this library, used in asset URLs.
+     */
+    public_id: string;
+    /**
+     * Human-readable asset name, independent of its delivery identifier.
+     */
+    display_name: string;
+    /**
+     * Organizational folder path; the empty string denotes the root folder.
+     */
+    asset_folder: string;
+    /**
+     * Stored media category: image for images, video for video or audio, and raw for other files. Upload also accepts auto for detection.
+     */
+    resource_type: MediaResourceType;
+    /**
+     * Asset delivery mode: upload is public; authenticated requires a signed URL or delivery token for originals and derivatives. private is unsupported.
+     */
+    type: MediaDeliveryType;
+    /**
+     * Detected file format used as the delivery URL extension.
+     */
+    format: string;
+    /**
+     * Monotonically increasing asset version used in delivery URLs; based on upload time in Unix seconds and advanced on overwrite.
+     */
+    version: number;
+    /**
+     * Identifier for this asset version, regenerated on overwrite.
+     */
+    version_id: string;
+    /**
+     * Size of the original source content, in bytes.
+     */
+    bytes: number;
+    /**
+     * MD5 digest of the source bytes, as 32 lowercase hexadecimal characters.
+     */
+    etag: string;
+    /**
+     * Source image or video width in pixels, when known.
+     */
+    width?: number;
+    /**
+     * Source image or video height in pixels, when known.
+     */
+    height?: number;
+    /**
+     * Source audio or video duration in seconds, when known.
+     */
+    duration?: number;
+    /**
+     * Number of pages recorded for the asset; omitted when no page count is stored.
+     */
+    pages?: number;
+    /**
+     * True for audio-only media, which uses resource_type video.
+     */
+    is_audio?: boolean;
+    /**
+     * Detected audio track metadata, omitted when no audio track information is available.
+     */
+    audio?: {
+        /**
+         * Detected audio codec identifier, when known.
+         */
+        codec?: string;
+        /**
+         * Number of audio channels in the detected track, when known.
+         */
+        channels?: number;
+        /**
+         * Audio sampling frequency in hertz, when known.
+         */
+        frequency?: number;
+    };
+    /**
+     * False when the video is known to contain no audio track; omitted when audio presence is unknown or an audio track exists.
+     */
+    has_audio?: false;
+    /**
+     * Original or overridden source filename with its final extension removed.
+     */
+    original_filename?: string;
+    /**
+     * Labels attached to the asset.
+     */
+    tags: Array<string>;
+    /**
+     * Custom string metadata; omitted when empty or excluded by the search projection.
+     */
+    context?: {
+        /**
+         * Caller-supplied metadata entries with string values.
+         */
+        custom: {
+            [key: string]: string;
+        };
+    };
+    /**
+     * Time this asset identity was created, in UTC.
+     */
+    created_at: MediaIsoTimestamp;
+    /**
+     * URL for retrieving this version of the asset’s original content.
+     */
+    url: string;
+    /**
+     * 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;
+    /**
+     * False because this response represents stored source content.
+     */
+    placeholder: false;
+    /**
+     * True when overwrite is false and the public_id already exists; the existing resource is returned.
+     */
+    existing?: boolean;
+    /**
+     * Progress of understanding and embedding tasks for the asset.
+     */
+    processing: MediaProcessingWritable;
+    /**
+     * Identifier of the library containing this asset.
+     */
+    library_id: MediaLibraryId;
+    /**
+     * SHA-256 digest of the source bytes, as 64 lowercase hexadecimal characters.
+     */
+    sha256: string;
+    /**
+     * Resource status; active identifies an asset that has not been deleted.
+     */
+    status: 'active';
+    /**
+     * Search-vector status: pending awaits vector generation or reprocessing; ready has searchable vectors; unavailable indicates disabled, unsupported or failed embedding. Existing vectors may still serve searches while reprocessing is pending.
+     */
+    semantic: 'pending' | 'ready' | 'unavailable';
+    /**
+     * Generated video previews, present once preview generation succeeds.
+     */
+    preview?: {
+        /**
+         * Delivery URL of the video’s first-frame poster.
+         */
+        poster_url?: string;
+        /**
+         * Preview sprite sheet with tile dimensions and sample spacing.
+         */
+        storyboard?: MediaStoryboard;
+        /**
+         * Low-bitrate proxy renditions for smooth playback while editing; exports use the original source.
+         */
+        proxy?: {
+            /**
+             * Proxy audio rendition, present once it has been generated.
+             */
+            audio?: {
+                /**
+                 * Delivery URL of the proxy audio rendition.
+                 */
+                url: string;
+                /**
+                 * Proxy audio bitrate in bits per second.
+                 */
+                bitrate: number;
+            };
+            /**
+             * Proxy video rendition, present once it has been generated.
+             */
+            video?: {
+                /**
+                 * Delivery URL of the proxy video rendition.
+                 */
+                url: string;
+                /**
+                 * Proxy video bitrate in bits per second.
+                 */
+                bitrate: number;
+                /**
+                 * Proxy video frame width in pixels.
+                 */
+                width: number;
+                /**
+                 * Proxy video frame height in pixels.
+                 */
+                height: number;
+            };
+        };
+    };
+};
+/**
+ * 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.
+ */
+export type MediaExpressionSearchResultWritable = {
+    /**
+     * Number of matching assets across pages; a lower bound when total_count_exact is false.
+     */
+    total_count: number;
+    /**
+     * Elapsed search time in whole milliseconds.
+     */
+    time: number;
+    /**
+     * Continuation token for the next page; omitted when no further page is available.
+     */
+    next_cursor?: string;
+    /**
+     * Assets in this page, ordered by sort_by; tags and context follow with_field.
+     */
+    resources: Array<MediaSearchAssetWritable>;
+    /**
+     * Requested facet counts, keyed by facet name and then by field value.
+     */
+    aggregations?: {
+        [key: string]: {
+            [key: string]: number;
+        };
+    };
+    /**
+     * Whether total_count covers all matches; false indicates a bounded partial count.
+     */
+    total_count_exact?: boolean;
+    /**
+     * Whether the returned facet counts cover all matching assets.
+     */
+    aggregations_exact?: boolean;
+};
+/**
+ * Ranked search hits and the embedding producer used for the query.
+ */
+export type MediaSemanticSearchResultWritable = {
+    /**
+     * Ranked assets up to top_k; an empty array means no eligible matches were found.
+     */
+    hits: Array<MediaSemanticHitWritable>;
+    /**
+     * Embedding model identifier used for the query, or for the source asset embedding in an asset-based visual query.
+     */
+    embedding_producer: string;
+    /**
+     * Number of distinct candidate asset identifiers, or unresolved vector identifiers, excluded because their vectors or assets were missing, deleted or stale; not a count of all pending assets in the library.
+     */
+    not_ready_excluded: number;
+};
+/**
+ * Configuration for the openrouter:files server tool
+ */
+export type OpenaiFilesServerToolConfigWritable = {
+    [key: string]: unknown;
+};
+export type AnthropicAnonymousWritable = {
+    [key: string]: unknown;
+};
+export type AnthropicAnonymous140Writable = {
+    [key: string]: unknown;
+};
+export type AnthropicAnonymous142Writable = {
+    [key: string]: unknown;
+};
+export type AnthropicAnonymous181Writable = {
+    [key: string]: unknown;
+};
+export type AnthropicAnonymous202Writable = {
+    [key: string]: unknown;
+};
+export type AnthropicAnonymous204Writable = {
+    [key: string]: unknown;
+};
+export type AnthropicAnonymous206Writable = {
+    [key: string]: unknown;
+};
+/**
+ * Arguments the model passed to the tool.
+ */
+export type AgentManaged193Writable = {
+    [key: string]: unknown;
+};
+/**
+ * Free-form string key/value pairs.
+ */
+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.
+ */
+export type MediaCloudinaryResourceWritable = {
+    /**
+     * Generated asset identifier: 32 lowercase hexadecimal characters, preserved across overwrites.
+     */
+    asset_id: MediaAssetId;
+    /**
+     * Delivery identifier unique within this library, used in asset URLs.
+     */
+    public_id: string;
+    /**
+     * Human-readable asset name, independent of its delivery identifier.
+     */
+    display_name: string;
+    /**
+     * Organizational folder path; the empty string denotes the root folder.
+     */
+    asset_folder: string;
+    /**
+     * Stored media category: image for images, video for video or audio, and raw for other files. Upload also accepts auto for detection.
+     */
+    resource_type: MediaResourceType;
+    /**
+     * Asset delivery mode: upload is public; authenticated requires a signed URL or delivery token for originals and derivatives. private is unsupported.
+     */
+    type: MediaDeliveryType;
+    /**
+     * Detected file format used as the delivery URL extension.
+     */
+    format: string;
+    /**
+     * Monotonically increasing asset version used in delivery URLs; based on upload time in Unix seconds and advanced on overwrite.
+     */
+    version: number;
+    /**
+     * Identifier for this asset version, regenerated on overwrite.
+     */
+    version_id: string;
+    /**
+     * Size of the original source content, in bytes.
+     */
+    bytes: number;
+    /**
+     * MD5 digest of the source bytes, as 32 lowercase hexadecimal characters.
+     */
+    etag: string;
+    /**
+     * Source image or video width in pixels, when known.
+     */
+    width?: number;
+    /**
+     * Source image or video height in pixels, when known.
+     */
+    height?: number;
+    /**
+     * Source audio or video duration in seconds, when known.
+     */
+    duration?: number;
+    /**
+     * Number of pages recorded for the asset; omitted when no page count is stored.
+     */
+    pages?: number;
+    /**
+     * True for audio-only media, which uses resource_type video.
+     */
+    is_audio?: boolean;
+    /**
+     * Detected audio track metadata, omitted when no audio track information is available.
+     */
+    audio?: {
+        /**
+         * Detected audio codec identifier, when known.
+         */
+        codec?: string;
+        /**
+         * Number of audio channels in the detected track, when known.
+         */
+        channels?: number;
+        /**
+         * Audio sampling frequency in hertz, when known.
+         */
+        frequency?: number;
+    };
+    /**
+     * False when the video is known to contain no audio track; omitted when audio presence is unknown or an audio track exists.
+     */
+    has_audio?: false;
+    /**
+     * Original or overridden source filename with its final extension removed.
+     */
+    original_filename?: string;
+    /**
+     * Labels attached to the asset.
+     */
+    tags: Array<string>;
+    /**
+     * Custom string metadata; omitted when empty or excluded by the search projection.
+     */
+    context?: {
+        /**
+         * Caller-supplied metadata entries with string values.
+         */
+        custom: {
+            [key: string]: string;
+        };
+    };
+    /**
+     * Time this asset identity was created, in UTC.
+     */
+    created_at: MediaIsoTimestamp;
+    /**
+     * URL for retrieving this version of the asset’s original content.
+     */
+    url: string;
+    /**
+     * 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;
+    /**
+     * False because this response represents stored source content.
+     */
+    placeholder: false;
+    /**
+     * True when overwrite=false returns the asset already stored under the requested public_id.
+     */
+    existing?: boolean;
+    /**
+     * Processing progress, included when auto_tagging was requested.
+     */
+    processing?: MediaProcessingWritable;
+};
+export type MediaChunkCompleteWritable = MediaCloudinaryResourceWritable & {
+    /**
+     * True when the final chunk has completed the asset upload.
+     */
+    done: true;
+};
+/**
+ * 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;
+    /**
+     * Processing states by kind. tagging is present when auto_tagging was requested and follows visual understanding.
+     */
+    kinds: {
+        [key: string]: MediaKindState;
+    };
+    /**
+     * Time the processing state was last updated, in UTC.
+     */
+    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.
+ */
+export type MediaSearchAssetWritable = {
+    /**
+     * Generated asset identifier: 32 lowercase hexadecimal characters, preserved across overwrites.
+     */
+    asset_id: MediaAssetId;
+    /**
+     * Delivery identifier unique within this library, used in asset URLs.
+     */
+    public_id: string;
+    /**
+     * Human-readable asset name, independent of its delivery identifier.
+     */
+    display_name: string;
+    /**
+     * Organizational folder path; the empty string denotes the root folder.
+     */
+    asset_folder: string;
+    /**
+     * Stored media category: image for images, video for video or audio, and raw for other files. Upload also accepts auto for detection.
+     */
+    resource_type: MediaResourceType;
+    /**
+     * Asset delivery mode: upload is public; authenticated requires a signed URL or delivery token for originals and derivatives. private is unsupported.
+     */
+    type: MediaDeliveryType;
+    /**
+     * Detected file format used as the delivery URL extension.
+     */
+    format: string;
+    /**
+     * Monotonically increasing asset version used in delivery URLs; based on upload time in Unix seconds and advanced on overwrite.
+     */
+    version: number;
+    /**
+     * Identifier for this asset version, regenerated on overwrite.
+     */
+    version_id: string;
+    /**
+     * Size of the original source content, in bytes.
+     */
+    bytes: number;
+    /**
+     * MD5 digest of the source bytes, as 32 lowercase hexadecimal characters.
+     */
+    etag: string;
+    /**
+     * Source image or video width in pixels, when known.
+     */
+    width?: number;
+    /**
+     * Source image or video height in pixels, when known.
+     */
+    height?: number;
+    /**
+     * Source audio or video duration in seconds, when known.
+     */
+    duration?: number;
+    /**
+     * Number of pages recorded for the asset; omitted when no page count is stored.
+     */
+    pages?: number;
+    /**
+     * True for audio-only media, which uses resource_type video.
+     */
+    is_audio?: boolean;
+    /**
+     * Detected audio track metadata, omitted when no audio track information is available.
+     */
+    audio?: {
+        /**
+         * Detected audio codec identifier, when known.
+         */
+        codec?: string;
+        /**
+         * Number of audio channels in the detected track, when known.
+         */
+        channels?: number;
+        /**
+         * Audio sampling frequency in hertz, when known.
+         */
+        frequency?: number;
     };
-}) & {
     /**
-     * Resume cursor of this entry; send it back as Last-Event-ID, or as cursor on the JSON form, to continue after it. Absent on the end event.
+     * False when the video is known to contain no audio track; omitted when audio presence is unknown or an audio track exists.
      */
-    id?: string;
+    has_audio?: false;
     /**
-     * SSE event name: log carries one log line in data; end is sent once when the run has reached a terminal status and closes the stream.
+     * Original or overridden source filename with its final extension removed.
      */
-    event: 'log' | 'end';
+    original_filename?: string;
     /**
-     * Decoded JSON of one log line; for the end event, an empty object.
+     * Labels attached to the asset.
      */
-    data: AutomationLogLine | {
-        [key: string]: unknown;
-    };
-};
-/**
- * Free-form string key/value pairs stored with the agent for your own bookkeeping.
- */
-export type AgentManaged37Writable = {
-    [key: string]: string;
-};
-/**
- * Models to use for completion
- */
-export type OpenaiChatModelNamesWritable = Array<OpenaiModelName & unknown>;
-/**
- * Free-form string key/value pairs stored with the session, changed through sessions.update patch semantics.
- */
-export type AgentManaged173Writable = {
-    [key: string]: string;
-};
-export type AgentManaged183Writable = {
-    [key: string]: null | string;
-};
-/**
- * Free-form string key/value pairs.
- */
-export type AgentManaged8Writable = {
-    [key: string]: string;
-};
-export type AgentManaged58Writable = {
-    [key: string]: null | string;
-};
-/**
- * Free-form string key/value pairs.
- */
-export type AgentManaged168Writable = {
-    [key: string]: string;
-};
-/**
- * Arguments the model passed to the tool.
- */
-export type AgentManaged197Writable = {
-    [key: string]: unknown;
-};
-/**
- * Arguments the model passed to the tool.
- */
-export type AgentManaged206Writable = {
-    [key: string]: unknown;
-};
-/**
- * Session metadata after the change.
- */
-export type AgentManaged246Writable = {
-    [key: string]: string;
-};
-/**
- * Free-form string key/value pairs.
- */
-export type AgentManaged144Writable = {
-    [key: string]: null | string;
-};
-/**
- * Free-form string key/value pairs.
- */
-export type AgentManaged137Writable = {
-    [key: string]: string;
-};
-/**
- * Free-form string key/value pairs.
- */
-export type AgentManaged91Writable = {
-    [key: string]: string;
-};
-/**
- * Free-form string key/value pairs.
- */
-export type AgentManaged78Writable = {
-    [key: string]: string;
-};
-export type AgentManaged112Writable = {
-    [key: string]: null | string;
-};
-/**
- * Any JSON value: null, boolean, number, string, array or object.
- */
-export type AutomationJsonValueWritable = null | string | number | boolean | AutomationJsonObjectWritable | Array<AutomationJsonValueWritable>;
-/**
- * Any JSON object whose keys are strings and whose values are any JSON value.
- */
-export type AutomationJsonObjectWritable = {
-    [key: string]: AutomationJsonValueWritable;
-};
-/**
- * A caller-owned media library with lifecycle, usage, understanding settings and model selections.
- */
-export type MediaLibraryWritable = {
+    tags?: Array<string>;
     /**
-     * Resolved model call IDs used for new uploads and reprocessing.
+     * Custom string metadata; omitted when empty or excluded by the search projection.
      */
-    models: MediaMediaModels;
+    context?: {
+        /**
+         * Caller-supplied metadata entries with string values.
+         */
+        custom: {
+            [key: string]: string;
+        };
+    };
     /**
-     * Generated library identifier: lib_ followed by 32 lowercase hexadecimal characters.
+     * Time this asset identity was created, in UTC.
      */
-    id: MediaLibraryId;
+    created_at: MediaIsoTimestamp;
     /**
-     * Display name of the library; duplicate names are allowed.
+     * URL for retrieving this version of the asset’s original content.
      */
-    name: string;
+    url: string;
     /**
-     * Caller-defined string labels used to organize and filter libraries.
+     * 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.
      */
-    labels: {
-        [key: string]: string;
-    };
+    secure_url: string;
     /**
-     * Library lifecycle: provisioning initializes the library; active permits asset operations; deleting awaits purge and may be restored before purge_at; deleted has been purged; failed indicates initialization failure.
+     * False because this response represents stored source content.
      */
-    status: MediaLibraryStatus;
+    placeholder: false;
     /**
-     * Number of assets currently stored in the library.
+     * True when overwrite is false and the public_id already exists; the existing resource is returned.
      */
-    asset_count: number;
+    existing?: boolean;
     /**
-     * Total source-content size of the library’s assets, in bytes.
+     * Progress of understanding and embedding tasks for the asset.
      */
-    bytes: number;
+    processing: MediaProcessingWritable;
     /**
-     * Settings controlling understanding tasks for new uploads.
+     * Identifier of the library containing this asset.
      */
-    understanding: MediaUnderstandingSettings;
+    library_id: MediaLibraryId;
     /**
-     * Time the library was created, in UTC.
+     * SHA-256 digest of the source bytes, as 64 lowercase hexadecimal characters.
      */
-    created_at: MediaIsoTimestamp;
+    sha256: string;
     /**
-     * Time library settings, lifecycle or usage were last updated, in UTC.
+     * Resource status; active identifies an asset that has not been deleted.
      */
-    updated_at: MediaIsoTimestamp;
+    status: 'active';
     /**
-     * Time the library entered deleting, or null when active or restored.
+     * Search-vector status: pending awaits vector generation or reprocessing; ready has searchable vectors; unavailable indicates disabled, unsupported or failed embedding. Existing vectors may still serve searches while reprocessing is pending.
      */
-    deleted_at: MediaIsoTimestamp | null;
+    semantic: 'pending' | 'ready' | 'unavailable';
     /**
-     * Scheduled purge time while the library is deleting; null for an active or restored library.
+     * Generated video previews, present once preview generation succeeds.
      */
-    purge_at: MediaIsoTimestamp | null;
+    preview?: {
+        /**
+         * Delivery URL of the video’s first-frame poster.
+         */
+        poster_url?: string;
+        /**
+         * Preview sprite sheet with tile dimensions and sample spacing.
+         */
+        storyboard?: MediaStoryboard;
+        /**
+         * Low-bitrate proxy renditions for smooth playback while editing; exports use the original source.
+         */
+        proxy?: {
+            /**
+             * Proxy audio rendition, present once it has been generated.
+             */
+            audio?: {
+                /**
+                 * Delivery URL of the proxy audio rendition.
+                 */
+                url: string;
+                /**
+                 * Proxy audio bitrate in bits per second.
+                 */
+                bitrate: number;
+            };
+            /**
+             * Proxy video rendition, present once it has been generated.
+             */
+            video?: {
+                /**
+                 * Delivery URL of the proxy video rendition.
+                 */
+                url: string;
+                /**
+                 * Proxy video bitrate in bits per second.
+                 */
+                bitrate: number;
+                /**
+                 * Proxy video frame width in pixels.
+                 */
+                width: number;
+                /**
+                 * Proxy video frame height in pixels.
+                 */
+                height: number;
+            };
+        };
+    };
 };
 /**
- * Libraries in this page, ordered by creation time descending.
+ * A matching asset with its ranking score and supporting matches.
  */
-export type MediaLibraryPageWritable = MediaPage & {
+export type MediaSemanticHitWritable = {
     /**
-     * Libraries in this page, ordered by creation time descending.
+     * Asset matched by the query.
      */
-    data: Array<MediaLibraryWritable>;
+    asset: MediaAssetWritable;
     /**
-     * Opaque token to pass as cursor to listLibraries; null means no further page.
+     * Ranking score: cosine similarity for semantic or visual search; normalized rank-fusion score for hybrid search. Higher values rank first; hybrid scores are not probabilities or confidence.
      */
-    next_cursor: string | null;
-};
-/**
- * Configuration for the openrouter:files server tool
- */
-export type OpenaiFilesServerToolConfigWritable = {
-    [key: string]: unknown;
-};
-export type AnthropicAnonymousWritable = {
-    [key: string]: unknown;
-};
-export type AnthropicAnonymous140Writable = {
-    [key: string]: unknown;
-};
-export type AnthropicAnonymous142Writable = {
-    [key: string]: unknown;
-};
-export type AnthropicAnonymous181Writable = {
-    [key: string]: unknown;
-};
-export type AnthropicAnonymous202Writable = {
-    [key: string]: unknown;
-};
-export type AnthropicAnonymous204Writable = {
-    [key: string]: unknown;
-};
-export type AnthropicAnonymous206Writable = {
-    [key: string]: unknown;
+    score: number;
+    /**
+     * Cosine similarity for hybrid hits with a semantic match; null for keyword-only hybrid hits. Omitted outside hybrid mode.
+     */
+    semantic_score?: number | null;
+    /**
+     * Supporting content or metadata matches contributing to this asset’s hit.
+     */
+    matches: Array<MediaSemanticMatch>;
 };
-/**
- * Arguments the model passed to the tool.
- */
-export type AgentManaged193Writable = {
+export type AgentManaged34Writable = {
     [key: string]: unknown;
 };
-/**
- * Free-form string key/value pairs.
- */
-export type AgentManaged143Writable = {
-    [key: string]: string;
-};
-export type AgentManaged34Writable = {
+export type MediaTranscriptCorrectionWritable = {
     [key: string]: unknown;
 };
 /**
@@ -42613,7 +43932,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;
     };
@@ -44159,31 +45478,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.
          */
@@ -44195,11 +45512,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;
 };
@@ -44209,58 +45526,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];
@@ -47107,6 +48445,76 @@ export type CountResponseInputTokensResponses = {
     };
 };
 export type CountResponseInputTokensResponse = CountResponseInputTokensResponses[keyof CountResponseInputTokensResponses];
+export type ListOrganizationMembersData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Maximum members per page, from 1 to 100; defaults to 20.
+         */
+        limit?: number;
+        /**
+         * Opaque next_page cursor returned by the previous response; omit for the first page.
+         */
+        page?: string;
+    };
+    url: '/organization/v1/members';
+};
+export type ListOrganizationMembersErrors = {
+    /**
+     * Invalid limit or page cursor; use limit 1 to 100 and copy next_page from the previous response.
+     */
+    400: unknown;
+    /**
+     * Missing or invalid credentials; provide a valid organization API key or runtime token.
+     */
+    401: unknown;
+    /**
+     * Organization identity was refused; use a credential belonging to the organization.
+     */
+    403: unknown;
+};
+export type ListOrganizationMembersResponses = {
+    /**
+     * Members of the authenticated organization, earliest join first.
+     */
+    200: {
+        /**
+         * Organization members in ascending join order.
+         */
+        data: Array<{
+            /**
+             * User identifier (usr_...). Use this id to assign an approver to an approval task.
+             */
+            id: string;
+            /**
+             * Display name of the member; null when no name is set.
+             */
+            name: string | null;
+            /**
+             * Email address of a member of your organization.
+             */
+            email: string;
+            /**
+             * Organization role: owner owns the organization; admin manages it; member is a regular participant.
+             */
+            role: 'owner' | 'admin' | 'member';
+            /**
+             * UTC ISO 8601 instant when this user joined the organization.
+             */
+            joined_at: string;
+        }>;
+        /**
+         * Whether another page of members is available.
+         */
+        has_more: boolean;
+        /**
+         * Cursor to pass as page; null when no more members remain.
+         */
+        next_page: string | null;
+    };
+};
+export type ListOrganizationMembersResponse = ListOrganizationMembersResponses[keyof ListOrganizationMembersResponses];
 export type ListOrganizationFeedbackData = {
     body?: never;
     path?: never;
@@ -68063,7 +69471,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;
         /**
@@ -68405,7 +69813,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: {
@@ -70217,7 +71625,7 @@ export type KnowledgeListFilesResponses = {
 };
 export type KnowledgeListFilesResponse = KnowledgeListFilesResponses[keyof KnowledgeListFilesResponses];
 export type KnowledgeAttachFileData = {
-    body: KnowledgeAttachFile;
+    body: KnowledgeNativeAttachFile;
     path: {
         /**
          * Resource ID.
@@ -70518,7 +71926,7 @@ export type KnowledgeRetrieveFileContentResponses = {
 };
 export type KnowledgeRetrieveFileContentResponse = KnowledgeRetrieveFileContentResponses[keyof KnowledgeRetrieveFileContentResponses];
 export type KnowledgeCreateFileBatchData = {
-    body: KnowledgeCreateBatch;
+    body: KnowledgeNativeCreateBatch;
     path: {
         /**
          * Resource ID.
@@ -71322,6 +72730,80 @@ 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;
+    /**
+     * 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: {
@@ -71449,6 +72931,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.
          */
@@ -71762,7 +73248,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;
         /**
@@ -71804,7 +73290,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;
     };
@@ -71883,7 +73369,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;
         /**
@@ -71899,7 +73385,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;
         /**
@@ -71941,7 +73427,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;
     };
@@ -72144,7 +73630,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;
         /**
@@ -72227,7 +73713,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>;
     };
@@ -72312,9 +73798,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.
          */
@@ -72382,7 +73868,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;
         /**
@@ -72791,6 +74277,10 @@ export type MediaCreateBatchData = {
          * 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: {
         /**
@@ -72925,6 +74415,10 @@ export type MediaBatchAssetsData = {
          * 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: {
         /**
@@ -73138,7 +74632,7 @@ export type MediaCreateDeliveryTokenData = {
          */
         acl?: string;
         /**
-         * Token lifetime in seconds, from 1 to 604800 inclusive; defaults to 3600.
+         * Token lifetime in seconds, from 1 to 604800 inclusive; defaults to 900.
          */
         expires_in?: number;
     };
@@ -73201,6 +74695,145 @@ export type MediaCreateDeliveryTokenResponses = {
     200: MediaDeliveryToken;
 };
 export type MediaCreateDeliveryTokenResponse = MediaCreateDeliveryTokenResponses[keyof MediaCreateDeliveryTokenResponses];
+export type MediaUnderstandingFailureSummaryData = {
+    body?: never;
+    path: {
+        /**
+         * Library ID returned by creation.
+         */
+        library_id: string;
+    };
+    query?: never;
+    url: '/media/v1/libraries/{library_id}/understandings/failure_summary';
+};
+export type MediaUnderstandingFailureSummaryErrors = {
+    /**
+     * 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;
+    /**
+     * 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 MediaUnderstandingFailureSummaryError = MediaUnderstandingFailureSummaryErrors[keyof MediaUnderstandingFailureSummaryErrors];
+export type MediaUnderstandingFailureSummaryResponses = {
+    /**
+     * Successful response.
+     */
+    200: MediaFailureSummary;
+};
+export type MediaUnderstandingFailureSummaryResponse = MediaUnderstandingFailureSummaryResponses[keyof MediaUnderstandingFailureSummaryResponses];
+export type MediaListUnderstandingsByLibraryData = {
+    body?: never;
+    path: {
+        /**
+         * Library ID returned by creation.
+         */
+        library_id: string;
+    };
+    query?: {
+        /**
+         * Folder path including all descendants; omitted or empty selects the entire library.
+         */
+        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;
+    };
+    url: '/media/v1/libraries/{library_id}/understandings';
+};
+export type MediaListUnderstandingsByLibraryErrors = {
+    /**
+     * 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;
+    /**
+     * 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 MediaListUnderstandingsByLibraryError = MediaListUnderstandingsByLibraryErrors[keyof MediaListUnderstandingsByLibraryErrors];
+export type MediaListUnderstandingsByLibraryResponses = {
+    /**
+     * Successful response.
+     */
+    200: MediaUnderstandingPage;
+};
+export type MediaListUnderstandingsByLibraryResponse = MediaListUnderstandingsByLibraryResponses[keyof MediaListUnderstandingsByLibraryResponses];
 export type GetSandboxV1SandboxesData = {
     body?: never;
     path?: never;