@discomedia/utils 1.0.60 → 1.0.62

package/dist/index.cjs

@@ -1150,6 +1150,8 @@ function isOpenRouterModel(model) {
         'openai/gpt-5-mini',
         'openai/gpt-5-nano',
         'openai/gpt-5.1',
+        'openai/gpt-5.4',
+        'openai/gpt-5.4-pro',
         'openai/gpt-5.2',
         'openai/gpt-5.2-pro',
         'openai/gpt-5.1-codex',
@@ -1614,7 +1616,7 @@ const safeJSON = (text) => {
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 
-const VERSION = '6.22.0'; // x-release-please-version
+const VERSION = '6.27.0'; // x-release-please-version
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 const isRunningInBrowser = () => {
@@ -2234,6 +2236,11 @@ function stringify(object, opts = {}) {
     return joined.length > 0 ? prefix + joined : '';
 }
 
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+function stringifyQuery(query) {
+    return stringify(query, { arrayFormat: 'brackets' });
+}
+
 function concatBytes(buffers) {
     let length = 0;
     for (const buffer of buffers) {
@@ -2452,7 +2459,7 @@ class Stream {
         this.controller = controller;
         __classPrivateFieldSet(this, _Stream_client, client);
     }
-    static fromSSEResponse(response, controller, client) {
+    static fromSSEResponse(response, controller, client, synthesizeEventData) {
         let consumed = false;
         const logger = client ? loggerFor(client) : console;
         async function* iterator() {
@@ -2482,7 +2489,7 @@ class Stream {
                         if (data && data.error) {
                             throw new APIError(undefined, data.error, undefined, response.headers);
                         }
-                        yield data;
+                        yield synthesizeEventData ? { event: sse.event, data } : data;
                     }
                     else {
                         let data;
@@ -2732,9 +2739,9 @@ async function defaultParseResponse(client, props) {
             // Note: there is an invariant here that isn't represented in the type system
             // that if you set `stream: true` the response type must also be `Stream<T>`
             if (props.options.__streamClass) {
-                return props.options.__streamClass.fromSSEResponse(response, props.controller, client);
+                return props.options.__streamClass.fromSSEResponse(response, props.controller, client, props.options.__synthesizeEventData);
             }
-            return Stream.fromSSEResponse(response, props.controller, client);
+            return Stream.fromSSEResponse(response, props.controller, client, props.options.__synthesizeEventData);
         }
         // fetch refuses to read the body when the status code is 204.
         if (response.status === 204) {
@@ -3287,6 +3294,9 @@ const createPathTagFunction = (pathEncoder = encodeURIPath) => function path(sta
 const path = /* @__PURE__ */ createPathTagFunction(encodeURIPath);
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Given a list of messages comprising a conversation, the model will return a response.
+ */
 let Messages$1 = class Messages extends APIResource {
     /**
      * Get the messages in a stored chat completion. Only Chat Completions that have
@@ -4649,6 +4659,9 @@ class ChatCompletionStreamingRunner extends ChatCompletionStream {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Given a list of messages comprising a conversation, the model will return a response.
+ */
 let Completions$1 = class Completions extends APIResource {
     constructor() {
         super(...arguments);
@@ -4819,10 +4832,15 @@ const buildHeaders = (newHeaders) => {
 };
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Turn audio into text or text into audio.
+ */
 class Speech extends APIResource {
     /**
      * Generates audio from the input text.
      *
+     * Returns the audio file content, or a stream of audio events.
+     *
      * @example
      * ```ts
      * const speech = await client.audio.speech.create({
@@ -4846,6 +4864,9 @@ class Speech extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Turn audio into text or text into audio.
+ */
 class Transcriptions extends APIResource {
     create(body, options) {
         return this._client.post('/audio/transcriptions', multipartFormRequestOptions({
@@ -4858,6 +4879,9 @@ class Transcriptions extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Turn audio into text or text into audio.
+ */
 class Translations extends APIResource {
     create(body, options) {
         return this._client.post('/audio/translations', multipartFormRequestOptions({ body, ...options, __metadata: { model: body.model } }, this._client));
@@ -4878,6 +4902,9 @@ Audio.Translations = Translations;
 Audio.Speech = Speech;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Create large batches of API requests to run asynchronously.
+ */
 class Batches extends APIResource {
     /**
      * Creates and executes a batch from an uploaded file of requests
@@ -4908,6 +4935,9 @@ class Batches extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Build Assistants that can call models and use tools.
+ */
 class Assistants extends APIResource {
     /**
      * Create an assistant with a model and instructions.
@@ -5038,7 +5068,7 @@ Realtime$1.TranscriptionSessions = TranscriptionSessions;
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 class Sessions extends APIResource {
     /**
-     * Create a ChatKit session
+     * Create a ChatKit session.
      *
      * @example
      * ```ts
@@ -5057,7 +5087,9 @@ class Sessions extends APIResource {
         });
     }
     /**
-     * Cancel a ChatKit session
+     * Cancel an active ChatKit session and return its most recent metadata.
+     *
+     * Cancelling prevents new requests from using the issued client secret.
      *
      * @example
      * ```ts
@@ -5076,7 +5108,7 @@ class Sessions extends APIResource {
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 let Threads$1 = class Threads extends APIResource {
     /**
-     * Retrieve a ChatKit thread
+     * Retrieve a ChatKit thread by its identifier.
      *
      * @example
      * ```ts
@@ -5091,7 +5123,7 @@ let Threads$1 = class Threads extends APIResource {
         });
     }
     /**
-     * List ChatKit threads
+     * List ChatKit threads with optional pagination and user filters.
      *
      * @example
      * ```ts
@@ -5109,7 +5141,7 @@ let Threads$1 = class Threads extends APIResource {
         });
     }
     /**
-     * Delete a ChatKit thread
+     * Delete a ChatKit thread along with its items and stored attachments.
      *
      * @example
      * ```ts
@@ -5125,7 +5157,7 @@ let Threads$1 = class Threads extends APIResource {
         });
     }
     /**
-     * List ChatKit thread items
+     * List items that belong to a ChatKit thread.
      *
      * @example
      * ```ts
@@ -5155,6 +5187,8 @@ ChatKit.Threads = Threads$1;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 /**
+ * Build Assistants that can call models and use tools.
+ *
  * @deprecated The Assistants API is deprecated in favor of the Responses API
  */
 class Messages extends APIResource {
@@ -5223,6 +5257,8 @@ class Messages extends APIResource {
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 /**
+ * Build Assistants that can call models and use tools.
+ *
  * @deprecated The Assistants API is deprecated in favor of the Responses API
  */
 class Steps extends APIResource {
@@ -5835,6 +5871,8 @@ _a$1 = AssistantStream, _AssistantStream_addEvent = function _AssistantStream_ad
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 /**
+ * Build Assistants that can call models and use tools.
+ *
  * @deprecated The Assistants API is deprecated in favor of the Responses API
  */
 let Runs$1 = class Runs extends APIResource {
@@ -5850,6 +5888,7 @@ let Runs$1 = class Runs extends APIResource {
             ...options,
             headers: buildHeaders([{ 'OpenAI-Beta': 'assistants=v2' }, options?.headers]),
             stream: params.stream ?? false,
+            __synthesizeEventData: true,
         });
     }
     /**
@@ -5980,6 +6019,7 @@ let Runs$1 = class Runs extends APIResource {
             ...options,
             headers: buildHeaders([{ 'OpenAI-Beta': 'assistants=v2' }, options?.headers]),
             stream: params.stream ?? false,
+            __synthesizeEventData: true,
         });
     }
     /**
@@ -6004,6 +6044,8 @@ Runs$1.Steps = Steps;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 /**
+ * Build Assistants that can call models and use tools.
+ *
  * @deprecated The Assistants API is deprecated in favor of the Responses API
  */
 class Threads extends APIResource {
@@ -6064,6 +6106,7 @@ class Threads extends APIResource {
             ...options,
             headers: buildHeaders([{ 'OpenAI-Beta': 'assistants=v2' }, options?.headers]),
             stream: body.stream ?? false,
+            __synthesizeEventData: true,
         });
     }
     /**
@@ -6101,6 +6144,9 @@ Beta.Assistants = Assistants;
 Beta.Threads = Threads;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Given a prompt, the model will return one or more predicted completions, and can also return the probabilities of alternative tokens at each position.
+ */
 class Completions extends APIResource {
     create(body, options) {
         return this._client.post('/completions', { body, ...options, stream: body.stream ?? false });
@@ -6203,6 +6249,9 @@ class Containers extends APIResource {
 Containers.Files = Files$2;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Manage conversations and conversation items.
+ */
 class Items extends APIResource {
     /**
      * Create items in a conversation with the given ID.
@@ -6238,6 +6287,9 @@ class Items extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Manage conversations and conversation items.
+ */
 class Conversations extends APIResource {
     constructor() {
         super(...arguments);
@@ -6271,6 +6323,9 @@ class Conversations extends APIResource {
 Conversations.Items = Items;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Get a vector representation of a given input that can be easily consumed by machine learning models and algorithms.
+ */
 class Embeddings extends APIResource {
     /**
      * Creates an embedding vector representing the input text.
@@ -6321,6 +6376,9 @@ class Embeddings extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Manage and run evals in the OpenAI platform.
+ */
 class OutputItems extends APIResource {
     /**
      * Get an evaluation run output item by ID.
@@ -6339,6 +6397,9 @@ class OutputItems extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Manage and run evals in the OpenAI platform.
+ */
 class Runs extends APIResource {
     constructor() {
         super(...arguments);
@@ -6386,6 +6447,9 @@ class Runs extends APIResource {
 Runs.OutputItems = OutputItems;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Manage and run evals in the OpenAI platform.
+ */
 class Evals extends APIResource {
     constructor() {
         super(...arguments);
@@ -6430,6 +6494,9 @@ class Evals extends APIResource {
 Evals.Runs = Runs;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Files are used to upload documents that can be used with features like Assistants and Fine-tuning.
+ */
 let Files$1 = class Files extends APIResource {
     /**
      * Upload a file that can be used across various endpoints. Individual files can be
@@ -6509,6 +6576,9 @@ class Methods extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Manage fine-tuning jobs to tailor a model to your specific training data.
+ */
 let Graders$1 = class Graders extends APIResource {
     /**
      * Run a grader.
@@ -6562,6 +6632,9 @@ class Alpha extends APIResource {
 Alpha.Graders = Graders$1;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Manage fine-tuning jobs to tailor a model to your specific training data.
+ */
 class Permissions extends APIResource {
     /**
      * **NOTE:** Calling this endpoint requires an [admin API key](../admin-api-keys).
@@ -6589,13 +6662,7 @@ class Permissions extends APIResource {
      * Organization owners can use this endpoint to view all permissions for a
      * fine-tuned model checkpoint.
      *
-     * @example
-     * ```ts
-     * const permission =
-     *   await client.fineTuning.checkpoints.permissions.retrieve(
-     *     'ft-AF1WoRqd3aJAHsqc9NY7iL8F',
-     *   );
-     * ```
+     * @deprecated Retrieve is deprecated. Please swap to the paginated list method instead.
      */
     retrieve(fineTunedModelCheckpoint, query = {}, options) {
         return this._client.get(path `/fine_tuning/checkpoints/${fineTunedModelCheckpoint}/permissions`, {
@@ -6603,6 +6670,25 @@ class Permissions extends APIResource {
             ...options,
         });
     }
+    /**
+     * **NOTE:** This endpoint requires an [admin API key](../admin-api-keys).
+     *
+     * Organization owners can use this endpoint to view all permissions for a
+     * fine-tuned model checkpoint.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const permissionListResponse of client.fineTuning.checkpoints.permissions.list(
+     *   'ft-AF1WoRqd3aJAHsqc9NY7iL8F',
+     * )) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(fineTunedModelCheckpoint, query = {}, options) {
+        return this._client.getAPIList(path `/fine_tuning/checkpoints/${fineTunedModelCheckpoint}/permissions`, (ConversationCursorPage), { query, ...options });
+    }
     /**
      * **NOTE:** This endpoint requires an [admin API key](../admin-api-keys).
      *
@@ -6637,6 +6723,9 @@ let Checkpoints$1 = class Checkpoints extends APIResource {
 Checkpoints$1.Permissions = Permissions;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Manage fine-tuning jobs to tailor a model to your specific training data.
+ */
 class Checkpoints extends APIResource {
     /**
      * List checkpoints for a fine-tuning job.
@@ -6657,6 +6746,9 @@ class Checkpoints extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Manage fine-tuning jobs to tailor a model to your specific training data.
+ */
 class Jobs extends APIResource {
     constructor() {
         super(...arguments);
@@ -6798,6 +6890,9 @@ class Graders extends APIResource {
 Graders.GraderModels = GraderModels;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Given a prompt and/or an input image, the model will generate a new image.
+ */
 class Images extends APIResource {
     /**
      * Creates a variation of a given image. This endpoint only supports `dall-e-2`.
@@ -6821,6 +6916,9 @@ class Images extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * List and describe the various models available in the API.
+ */
 class Models extends APIResource {
     /**
      * Retrieves a model instance, providing basic information about the model such as
@@ -6846,6 +6944,9 @@ class Models extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Given text and/or image inputs, classifies if those inputs are potentially harmful.
+ */
 class Moderations extends APIResource {
     /**
      * Classifies if text and/or image inputs are potentially harmful. Learn more in
@@ -6929,6 +7030,20 @@ class ClientSecrets extends APIResource {
     /**
      * Create a Realtime client secret with an associated session configuration.
      *
+     * Client secrets are short-lived tokens that can be passed to a client app, such
+     * as a web frontend or mobile client, which grants access to the Realtime API
+     * without leaking your main API key. You can configure a custom TTL for each
+     * client secret.
+     *
+     * You can also attach session configuration options to the client secret, which
+     * will be applied to any sessions created using that client secret, but these can
+     * also be overridden by the client connection.
+     *
+     * [Learn more about authentication with client secrets over WebRTC](https://platform.openai.com/docs/guides/realtime-webrtc).
+     *
+     * Returns the created client secret and the effective session object. The client
+     * secret is a string that looks like `ek_1234`.
+     *
      * @example
      * ```ts
      * const clientSecret =
@@ -7354,7 +7469,10 @@ class InputItems extends APIResource {
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 class InputTokens extends APIResource {
     /**
-     * Get input token counts
+     * Returns input token counts of the request.
+     *
+     * Returns an object with `object` set to `response.input_tokens` and an
+     * `input_tokens` count.
      *
      * @example
      * ```ts
@@ -7436,12 +7554,17 @@ class Responses extends APIResource {
         return this._client.post(path `/responses/${responseID}/cancel`, options);
     }
     /**
-     * Compact conversation
+     * Compact a conversation. Returns a compacted response object.
+     *
+     * Learn when and how to compact long-running conversations in the
+     * [conversation state guide](https://platform.openai.com/docs/guides/conversation-state#managing-the-context-window).
+     * For ZDR-compatible compaction details, see
+     * [Compaction (advanced)](https://platform.openai.com/docs/guides/conversation-state#compaction-advanced).
      *
      * @example
      * ```ts
      * const compactedResponse = await client.responses.compact({
-     *   model: 'gpt-5.2',
+     *   model: 'gpt-5.4',
      * });
      * ```
      */
@@ -7455,7 +7578,7 @@ Responses.InputTokens = InputTokens;
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 let Content$1 = class Content extends APIResource {
     /**
-     * Get Skill Content
+     * Download a skill zip bundle by its ID.
      */
     retrieve(skillID, options) {
         return this._client.get(path `/skills/${skillID}/content`, {
@@ -7469,7 +7592,7 @@ let Content$1 = class Content extends APIResource {
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 class Content extends APIResource {
     /**
-     * Get Skill Version Content
+     * Download a skill version zip bundle.
      */
     retrieve(version, params, options) {
         const { skill_id } = params;
@@ -7488,20 +7611,20 @@ class Versions extends APIResource {
         this.content = new Content(this._client);
     }
     /**
-     * Create Skill Version
+     * Create a new immutable skill version.
      */
     create(skillID, body = {}, options) {
         return this._client.post(path `/skills/${skillID}/versions`, maybeMultipartFormRequestOptions({ body, ...options }, this._client));
     }
     /**
-     * Get Skill Version
+     * Get a specific skill version.
      */
     retrieve(version, params, options) {
         const { skill_id } = params;
         return this._client.get(path `/skills/${skill_id}/versions/${version}`, options);
     }
     /**
-     * List Skill Versions
+     * List skill versions for a skill.
      */
     list(skillID, query = {}, options) {
         return this._client.getAPIList(path `/skills/${skillID}/versions`, (CursorPage), {
@@ -7510,7 +7633,7 @@ class Versions extends APIResource {
         });
     }
     /**
-     * Delete Skill Version
+     * Delete a skill version.
      */
     delete(version, params, options) {
         const { skill_id } = params;
@@ -7527,31 +7650,31 @@ class Skills extends APIResource {
         this.versions = new Versions(this._client);
     }
     /**
-     * Create Skill
+     * Create a new skill.
      */
     create(body = {}, options) {
         return this._client.post('/skills', maybeMultipartFormRequestOptions({ body, ...options }, this._client));
     }
     /**
-     * Get Skill
+     * Get a skill by its ID.
      */
     retrieve(skillID, options) {
         return this._client.get(path `/skills/${skillID}`, options);
     }
     /**
-     * Update Skill Default Version
+     * Update the default version pointer for a skill.
      */
     update(skillID, body, options) {
         return this._client.post(path `/skills/${skillID}`, { body, ...options });
     }
     /**
-     * List Skills
+     * List all skills for the current project.
      */
     list(query = {}, options) {
         return this._client.getAPIList('/skills', (CursorPage), { query, ...options });
     }
     /**
-     * Delete Skill
+     * Delete a skill by its ID.
      */
     delete(skillID, options) {
         return this._client.delete(path `/skills/${skillID}`, options);
@@ -7561,6 +7684,9 @@ Skills.Content = Content$1;
 Skills.Versions = Versions;
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Use Uploads to upload large files in multiple parts.
+ */
 class Parts extends APIResource {
     /**
      * Adds a
@@ -7581,6 +7707,9 @@ class Parts extends APIResource {
 }
 
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+/**
+ * Use Uploads to upload large files in multiple parts.
+ */
 class Uploads extends APIResource {
     constructor() {
         super(...arguments);
@@ -7606,12 +7735,16 @@ class Uploads extends APIResource {
      * For guidance on the proper filename extensions for each purpose, please follow
      * the documentation on
      * [creating a File](https://platform.openai.com/docs/api-reference/files/create).
+     *
+     * Returns the Upload object with status `pending`.
      */
     create(body, options) {
         return this._client.post('/uploads', { body, ...options });
     }
     /**
      * Cancels the Upload. No Parts may be added after an Upload is cancelled.
+     *
+     * Returns the Upload object with status `cancelled`.
      */
     cancel(uploadID, options) {
         return this._client.post(path `/uploads/${uploadID}/cancel`, options);
@@ -7629,7 +7762,9 @@ class Uploads extends APIResource {
      *
      * The number of bytes uploaded upon completion must match the number of bytes
      * initially specified when creating the Upload object. No Parts may be added after
-     * an Upload is completed.
+     * an Upload is completed. Returns the Upload object with status `completed`,
+     * including an additional `file` property containing the created usable File
+     * object.
      */
     complete(uploadID, body, options) {
         return this._client.post(path `/uploads/${uploadID}/complete`, { body, ...options });
@@ -7989,31 +8124,33 @@ VectorStores.FileBatches = FileBatches;
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 class Videos extends APIResource {
     /**
-     * Create a video
+     * Create a new video generation job from a prompt and optional reference assets.
      */
     create(body, options) {
         return this._client.post('/videos', maybeMultipartFormRequestOptions({ body, ...options }, this._client));
     }
     /**
-     * Retrieve a video
+     * Fetch the latest metadata for a generated video.
      */
     retrieve(videoID, options) {
         return this._client.get(path `/videos/${videoID}`, options);
     }
     /**
-     * List videos
+     * List recently generated videos for the current project.
      */
     list(query = {}, options) {
         return this._client.getAPIList('/videos', (ConversationCursorPage), { query, ...options });
     }
     /**
-     * Delete a video
+     * Permanently delete a completed or failed video and its stored assets.
      */
     delete(videoID, options) {
         return this._client.delete(path `/videos/${videoID}`, options);
     }
     /**
-     * Download video content
+     * Download the generated video bytes or a derived preview asset.
+     *
+     * Streams the rendered video content for the specified video job.
      */
     downloadContent(videoID, query = {}, options) {
         return this._client.get(path `/videos/${videoID}/content`, {
@@ -8024,7 +8161,7 @@ class Videos extends APIResource {
         });
     }
     /**
-     * Create a video remix
+     * Create a remix of a completed video using a refreshed prompt.
      */
     remix(videoID, body, options) {
         return this._client.post(path `/videos/${videoID}/remix`, maybeMultipartFormRequestOptions({ body, ...options }, this._client));
@@ -8149,24 +8286,54 @@ class OpenAI {
     constructor({ baseURL = readEnv('OPENAI_BASE_URL'), apiKey = readEnv('OPENAI_API_KEY'), organization = readEnv('OPENAI_ORG_ID') ?? null, project = readEnv('OPENAI_PROJECT_ID') ?? null, webhookSecret = readEnv('OPENAI_WEBHOOK_SECRET') ?? null, ...opts } = {}) {
         _OpenAI_instances.add(this);
         _OpenAI_encoder.set(this, void 0);
+        /**
+         * Given a prompt, the model will return one or more predicted completions, and can also return the probabilities of alternative tokens at each position.
+         */
         this.completions = new Completions(this);
         this.chat = new Chat(this);
+        /**
+         * Get a vector representation of a given input that can be easily consumed by machine learning models and algorithms.
+         */
         this.embeddings = new Embeddings(this);
+        /**
+         * Files are used to upload documents that can be used with features like Assistants and Fine-tuning.
+         */
         this.files = new Files$1(this);
+        /**
+         * Given a prompt and/or an input image, the model will generate a new image.
+         */
         this.images = new Images(this);
         this.audio = new Audio(this);
+        /**
+         * Given text and/or image inputs, classifies if those inputs are potentially harmful.
+         */
         this.moderations = new Moderations(this);
+        /**
+         * List and describe the various models available in the API.
+         */
         this.models = new Models(this);
         this.fineTuning = new FineTuning(this);
         this.graders = new Graders(this);
         this.vectorStores = new VectorStores(this);
         this.webhooks = new Webhooks(this);
         this.beta = new Beta(this);
+        /**
+         * Create large batches of API requests to run asynchronously.
+         */
         this.batches = new Batches(this);
+        /**
+         * Use Uploads to upload large files in multiple parts.
+         */
         this.uploads = new Uploads(this);
         this.responses = new Responses(this);
         this.realtime = new Realtime(this);
+        /**
+         * Manage conversations and conversation items.
+         */
         this.conversations = new Conversations(this);
+        /**
+         * Manage and run evals in the OpenAI platform.
+         */
         this.evals = new Evals(this);
         this.containers = new Containers(this);
         this.skills = new Skills(this);
@@ -8236,7 +8403,7 @@ class OpenAI {
         return buildHeaders([{ Authorization: `Bearer ${this.apiKey}` }]);
     }
     stringifyQuery(query) {
-        return stringify(query, { arrayFormat: 'brackets' });
+        return stringifyQuery(query);
     }
     getUserAgent() {
         return `${this.constructor.name}/JS ${VERSION}`;
@@ -8505,9 +8672,9 @@ class OpenAI {
                 timeoutMillis = Date.parse(retryAfterHeader) - Date.now();
             }
         }
-        // If the API asks us to wait a certain amount of time (and it's a reasonable amount),
-        // just do what it says, but otherwise calculate a default
-        if (!(timeoutMillis && 0 <= timeoutMillis && timeoutMillis < 60 * 1000)) {
+        // If the API asks us to wait a certain amount of time, just do what it
+        // says, but otherwise calculate a default
+        if (timeoutMillis === undefined) {
             const maxRetries = options.maxRetries ?? this.maxRetries;
             timeoutMillis = this.calculateDefaultRetryTimeoutMillis(retriesRemaining, maxRetries);
         }
@@ -8604,6 +8771,13 @@ class OpenAI {
                 (Symbol.iterator in body && 'next' in body && typeof body.next === 'function'))) {
             return { bodyHeaders: undefined, body: ReadableStreamFrom(body) };
         }
+        else if (typeof body === 'object' &&
+            headers.values.get('content-type') === 'application/x-www-form-urlencoded') {
+            return {
+                bodyHeaders: { 'content-type': 'application/x-www-form-urlencoded' },
+                body: this.stringifyQuery(body),
+            };
+        }
         else {
             return __classPrivateFieldGet(this, _OpenAI_encoder, "f").call(this, { body, headers });
         }
@@ -8654,78 +8828,107 @@ OpenAI.Videos = Videos;
 
 // llm-openai-config.ts
 const DEFAULT_MODEL = 'gpt-4.1-mini';
-/** Token costs in USD per 1M tokens. Last updated Feb 2025. */
+const GPT_5_4_HIGH_CONTEXT_THRESHOLD_TOKENS = 272_000;
+const GPT_5_4_HIGH_CONTEXT_INPUT_MULTIPLIER = 2;
+const GPT_5_4_HIGH_CONTEXT_OUTPUT_MULTIPLIER = 1.5;
+/** Token costs in USD per 1M tokens. Last updated Mar 2026. */
 const openAiModelCosts = {
     'gpt-4o': {
         inputCost: 2.5 / 1_000_000,
+        cacheHitCost: 1.25 / 1_000_000,
         outputCost: 10 / 1_000_000,
     },
     'gpt-4o-mini': {
         inputCost: 0.15 / 1_000_000,
+        cacheHitCost: 0.075 / 1_000_000,
         outputCost: 0.6 / 1_000_000,
     },
     'o1-mini': {
         inputCost: 1.1 / 1_000_000,
+        cacheHitCost: 0.55 / 1_000_000,
         outputCost: 4.4 / 1_000_000,
     },
     'o1': {
         inputCost: 15 / 1_000_000,
+        cacheHitCost: 7.5 / 1_000_000,
         outputCost: 60 / 1_000_000,
     },
     'o3-mini': {
         inputCost: 1.1 / 1_000_000,
+        cacheHitCost: 0.55 / 1_000_000,
         outputCost: 4.4 / 1_000_000,
     },
     'o3': {
         inputCost: 2 / 1_000_000,
+        cacheHitCost: 0.5 / 1_000_000,
         outputCost: 8 / 1_000_000,
     },
     'gpt-4.1': {
         inputCost: 2 / 1_000_000,
+        cacheHitCost: 0.5 / 1_000_000,
         outputCost: 8 / 1_000_000,
     },
     'gpt-4.1-mini': {
         inputCost: 0.4 / 1_000_000,
+        cacheHitCost: 0.1 / 1_000_000,
         outputCost: 1.6 / 1_000_000,
     },
     'gpt-4.1-nano': {
         inputCost: 0.1 / 1_000_000,
+        cacheHitCost: 0.025 / 1_000_000,
         outputCost: 0.4 / 1_000_000,
     },
     'gpt-5': {
         inputCost: 1.25 / 1_000_000,
+        cacheHitCost: 0.125 / 1_000_000,
         outputCost: 10 / 1_000_000,
     },
     'gpt-5-mini': {
         inputCost: 0.25 / 1_000_000,
+        cacheHitCost: 0.025 / 1_000_000,
         outputCost: 2 / 1_000_000,
     },
     'gpt-5-nano': {
         inputCost: 0.05 / 1_000_000,
+        cacheHitCost: 0.005 / 1_000_000,
         outputCost: 0.4 / 1_000_000,
     },
     'gpt-5.1': {
         inputCost: 1.25 / 1_000_000,
+        cacheHitCost: 0.125 / 1_000_000,
         outputCost: 10 / 1_000_000,
     },
+    'gpt-5.4': {
+        inputCost: 2.5 / 1_000_000,
+        cacheHitCost: 0.25 / 1_000_000,
+        outputCost: 15 / 1_000_000,
+    },
+    'gpt-5.4-pro': {
+        inputCost: 30 / 1_000_000,
+        outputCost: 180 / 1_000_000,
+    },
     'gpt-5.2': {
-        inputCost: 1.5 / 1_000_000,
-        outputCost: 12 / 1_000_000,
+        inputCost: 1.75 / 1_000_000,
+        cacheHitCost: 0.175 / 1_000_000,
+        outputCost: 14 / 1_000_000,
     },
     'gpt-5.2-pro': {
-        inputCost: 3 / 1_000_000,
-        outputCost: 24 / 1_000_000,
+        inputCost: 21 / 1_000_000,
+        outputCost: 168 / 1_000_000,
     },
     'gpt-5.1-codex': {
-        inputCost: 1.1 / 1_000_000,
-        outputCost: 8.8 / 1_000_000,
+        inputCost: 1.25 / 1_000_000,
+        cacheHitCost: 0.125 / 1_000_000,
+        outputCost: 10 / 1_000_000,
     },
     'gpt-5.1-codex-max': {
-        inputCost: 1.8 / 1_000_000,
-        outputCost: 14.4 / 1_000_000,
+        inputCost: 1.25 / 1_000_000,
+        cacheHitCost: 0.125 / 1_000_000,
+        outputCost: 10 / 1_000_000,
     },
     'o4-mini': {
         inputCost: 1.1 / 1_000_000,
+        cacheHitCost: 0.275 / 1_000_000,
         outputCost: 4.4 / 1_000_000,
     },
 };
@@ -8741,6 +8944,9 @@ const deepseekModelCosts = {
         outputCost: 2.19 / 1_000_000, // $2.19 per 1M tokens
     },
 };
+function shouldUseGPT54HighContextPricing(model, inputTokens) {
+    return (model === 'gpt-5.4' || model === 'gpt-5.4-pro') && inputTokens > GPT_5_4_HIGH_CONTEXT_THRESHOLD_TOKENS;
+}
 /** Image generation costs in USD per image. Based on OpenAI pricing as of Feb 2025. */
 const openAiImageCosts = {
     'gpt-image-1': 0.0075, // $0.0075 per image for gpt-image-1
@@ -8769,8 +8975,8 @@ function calculateImageCost(model, imageCount) {
  * @param model The name of the language model. Supported models are listed in the `openAiModelCosts` and `deepseekModelCosts` objects.
  * @param inputTokens The number of input tokens passed to the language model.
  * @param outputTokens The number of output tokens generated by the language model.
- * @param reasoningTokens The number of output tokens generated by the language model for reasoning. This is only used for Deepseek models.
- * @param cacheHitTokens The number of input tokens that were cache hits for Deepseek models.
+ * @param reasoningTokens The number of output tokens generated by the language model for reasoning.
+ * @param cacheHitTokens The number of input tokens billed at cached-input rates.
  * @returns The cost of calling the language model in USD.
  */
 function calculateCost(provider, model, inputTokens, outputTokens, reasoningTokens, cacheHitTokens) {
@@ -8785,12 +8991,18 @@ function calculateCost(provider, model, inputTokens, outputTokens, reasoningToke
     const modelCosts = provider === 'deepseek' ? deepseekModelCosts[model] : openAiModelCosts[model];
     if (!modelCosts)
         return 0;
-    // Calculate input cost based on cache hit/miss for Deepseek
-    const inputCost = provider === 'deepseek' && modelCosts.cacheHitCost
-        ? (cacheHitTokens || 0) * modelCosts.cacheHitCost + (inputTokens - (cacheHitTokens || 0)) * modelCosts.inputCost
-        : inputTokens * modelCosts.inputCost;
-    const outputCost = outputTokens * modelCosts.outputCost;
-    const reasoningCost = (reasoningTokens || 0) * modelCosts.outputCost;
+    const boundedCacheHitTokens = Math.min(Math.max(cacheHitTokens || 0, 0), inputTokens);
+    let inputCost = inputTokens * modelCosts.inputCost;
+    if (typeof modelCosts.cacheHitCost === 'number' && boundedCacheHitTokens > 0) {
+        inputCost = boundedCacheHitTokens * modelCosts.cacheHitCost + (inputTokens - boundedCacheHitTokens) * modelCosts.inputCost;
+    }
+    let outputCost = outputTokens * modelCosts.outputCost;
+    let reasoningCost = (reasoningTokens || 0) * modelCosts.outputCost;
+    if (provider === 'openai' && shouldUseGPT54HighContextPricing(model, inputTokens)) {
+        inputCost *= GPT_5_4_HIGH_CONTEXT_INPUT_MULTIPLIER;
+        outputCost *= GPT_5_4_HIGH_CONTEXT_OUTPUT_MULTIPLIER;
+        reasoningCost *= GPT_5_4_HIGH_CONTEXT_OUTPUT_MULTIPLIER;
+    }
     return inputCost + outputCost + reasoningCost;
 }
 
@@ -9188,6 +9400,8 @@ const isSupportedModel = (model) => {
         'gpt-5-mini',
         'gpt-5-nano',
         'gpt-5.1',
+        'gpt-5.4',
+        'gpt-5.4-pro',
         'gpt-5.2',
         'gpt-5.2-pro',
         'gpt-5.1-codex',
@@ -9214,6 +9428,8 @@ function supportsTemperature(model) {
         'gpt-5-mini',
         'gpt-5-nano',
         'gpt-5.1',
+        'gpt-5.4',
+        'gpt-5.4-pro',
         'gpt-5.2',
         'gpt-5.2-pro',
         'gpt-5.1-codex',
@@ -9241,6 +9457,8 @@ function isGPT5Model(model) {
         'gpt-5-mini',
         'gpt-5-nano',
         'gpt-5.1',
+        'gpt-5.4',
+        'gpt-5.4-pro',
         'gpt-5.2',
         'gpt-5.2-pro',
         'gpt-5.1-codex',
@@ -9248,6 +9466,12 @@ function isGPT5Model(model) {
     ];
     return gpt5Models.includes(model);
 }
+function supportsStructuredOutputs(model) {
+    return normalizeModelName(model) !== 'gpt-5.4-pro';
+}
+function supportsDistillation(model) {
+    return normalizeModelName(model) !== 'gpt-5.4-pro';
+}
 /**
  * Makes a call to OpenAI's Responses API for more advanced use cases with built-in tools.
  *
@@ -9290,8 +9514,15 @@ const makeResponsesAPICall = async (input, options = {}) => {
         input,
         ...cleanOptions,
     };
+    if (requestBody.text?.format?.type === 'json_schema' && !supportsStructuredOutputs(normalizedModel)) {
+        throw new Error(`Model ${normalizedModel} does not support structured outputs`);
+    }
+    if (requestBody.store && !supportsDistillation(normalizedModel)) {
+        throw new Error(`Model ${normalizedModel} does not support distillation`);
+    }
     // Make the API call to the Responses endpoint
     const response = await openai.responses.create(requestBody);
+    const cacheHitTokens = response.usage?.input_tokens_details?.cached_tokens || 0;
     // Extract tool calls from the output
     const toolCalls = response.output
         ?.filter((item) => item.type === 'function_call')
@@ -9331,7 +9562,8 @@ const makeResponsesAPICall = async (input, options = {}) => {
                 reasoning_tokens: response.usage?.output_tokens_details?.reasoning_tokens || 0,
                 provider: 'openai',
                 model: normalizedModel,
-                cost: calculateCost('openai', normalizedModel, response.usage?.input_tokens || 0, response.usage?.output_tokens || 0, response.usage?.output_tokens_details?.reasoning_tokens || 0),
+                cache_hit_tokens: cacheHitTokens,
+                cost: calculateCost('openai', normalizedModel, response.usage?.input_tokens || 0, response.usage?.output_tokens || 0, response.usage?.output_tokens_details?.reasoning_tokens || 0, cacheHitTokens),
             },
             tool_calls: toolCalls,
             ...(codeInterpreterOutputs ? { code_interpreter_outputs: codeInterpreterOutputs } : {}),
@@ -9363,7 +9595,8 @@ const makeResponsesAPICall = async (input, options = {}) => {
             reasoning_tokens: response.usage?.output_tokens_details?.reasoning_tokens || 0,
             provider: 'openai',
             model: normalizedModel,
-            cost: calculateCost('openai', normalizedModel, response.usage?.input_tokens || 0, response.usage?.output_tokens || 0, response.usage?.output_tokens_details?.reasoning_tokens || 0),
+            cache_hit_tokens: cacheHitTokens,
+            cost: calculateCost('openai', normalizedModel, response.usage?.input_tokens || 0, response.usage?.output_tokens || 0, response.usage?.output_tokens_details?.reasoning_tokens || 0, cacheHitTokens),
         },
         tool_calls: toolCalls,
         ...(codeInterpreterOutputs ? { code_interpreter_outputs: codeInterpreterOutputs } : {}),
@@ -9495,6 +9728,8 @@ const MULTIMODAL_VISION_MODELS = new Set([
     'gpt-5-mini',
     'gpt-5-nano',
     'gpt-5.1',
+    'gpt-5.4',
+    'gpt-5.4-pro',
     'gpt-5.2',
     'gpt-5.2-pro',
     'gpt-5.1-codex',