feat(api): add new Response completed_at prop

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 136
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-75926226b642ebb2cb415694da9dff35e8ab40145ac1b791cefb82a83809db4d.yml
-openapi_spec_hash: 6a0e391b0ba5747b6b4a3e5fe21de4da
-config_hash: adcf23ecf5f84d3cadf1d71e82ec636a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-9442fa9212dd61aac2bb0edd19744bee381e75888712f9098bc6ebb92c52b557.yml
+openapi_spec_hash: f87823d164b7a8f72a42eba04e482a99
+config_hash: ad7136f7366fddec432ec378939e58a7

src/resources/audio/speech.ts

@@ -46,9 +46,10 @@ export interface SpeechCreateParams {
   model: (string & {}) | SpeechModel;
 
   /**
-   * The voice to use when generating the audio. Supported voices are `alloy`, `ash`,
-   * `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`, `shimmer`, and
-   * `verse`. Previews of the voices are available in the
+   * The voice to use when generating the audio. Supported built-in voices are
+   * `alloy`, `ash`, `ballad`, `coral`, `echo`, `fable`, `onyx`, `nova`, `sage`,
+   * `shimmer`, `verse`, `marin`, and `cedar`. Previews of the voices are available
+   * in the
    * [Text to speech guide](https://platform.openai.com/docs/guides/text-to-speech#voice-options).
    */
   voice:

src/resources/chat/completions/completions.ts

@@ -486,8 +486,9 @@ export interface ChatCompletionAudioParam {
   format: 'wav' | 'aac' | 'mp3' | 'flac' | 'opus' | 'pcm16';
 
   /**
-   * The voice the model uses to respond. Supported voices are `alloy`, `ash`,
-   * `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, and `shimmer`.
+   * The voice the model uses to respond. Supported built-in voices are `alloy`,
+   * `ash`, `ballad`, `coral`, `echo`, `fable`, `nova`, `onyx`, `sage`, `shimmer`,
+   * `marin`, and `cedar`.
    */
   voice:
     | (string & {})

src/resources/images.ts

@@ -28,7 +28,8 @@ export class Images extends APIResource {
 
   /**
    * Creates an edited or extended image given one or more source images and a
-   * prompt. This endpoint only supports `gpt-image-1` and `dall-e-2`.
+   * prompt. This endpoint supports GPT Image models (`gpt-image-1.5`, `gpt-image-1`,
+   * and `gpt-image-1-mini`) and `dall-e-2`.
    *
    * @example
    * ```ts

src/resources/realtime/realtime.ts

@@ -1256,10 +1256,10 @@ export interface RealtimeAudioConfigOutput {
   speed?: number;
 
   /**
-   * The voice the model uses to respond. Voice cannot be changed during the session
-   * once the model has responded with audio at least once. Current voice options are
-   * `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-   * and `cedar`. We recommend `marin` and `cedar` for best quality.
+   * The voice the model uses to respond. Supported built-in voices are `alloy`,
+   * `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+   * `cedar`. Voice cannot be changed during the session once the model has responded
+   * with audio at least once. We recommend `marin` and `cedar` for best quality.
    */
   voice?:
     | (string & {})
@@ -2121,10 +2121,10 @@ export namespace RealtimeResponseCreateAudioOutput {
     format?: RealtimeAPI.RealtimeAudioFormats;
 
     /**
-     * The voice the model uses to respond. Voice cannot be changed during the session
-     * once the model has responded with audio at least once. Current voice options are
-     * `alloy`, `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`,
-     * and `cedar`. We recommend `marin` and `cedar` for best quality.
+     * The voice the model uses to respond. Supported built-in voices are `alloy`,
+     * `ash`, `ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, and
+     * `cedar`. Voice cannot be changed during the session once the model has responded
+     * with audio at least once.
      */
     voice?:
       | (string & {})

src/resources/responses/input-tokens.ts

@@ -89,9 +89,7 @@ export interface InputTokenCountParams {
   text?: InputTokenCountParams.Text | null;
 
   /**
-   * How the model should select which tool (or tools) to use when generating a
-   * response. See the `tools` parameter to see how to specify which tools the model
-   * can call.
+   * Controls which tool the model should use, if any.
    */
   tool_choice?:
     | ResponsesAPI.ToolChoiceOptions

src/resources/responses/responses.ts

@@ -595,8 +595,14 @@ export interface Response {
   background?: boolean | null;
 
   /**
-   * The conversation that this response belongs to. Input items and output items
-   * from this response are automatically added to this conversation.
+   * Unix timestamp (in seconds) of when this Response was completed. Only present
+   * when the status is `completed`.
+   */
+  completed_at?: number | null;
+
+  /**
+   * The conversation that this response belonged to. Input items and output items
+   * from this response were automatically added to this conversation.
    */
   conversation?: Response.Conversation | null;
 
@@ -727,12 +733,12 @@ export namespace Response {
   }
 
   /**
-   * The conversation that this response belongs to. Input items and output items
-   * from this response are automatically added to this conversation.
+   * The conversation that this response belonged to. Input items and output items
+   * from this response were automatically added to this conversation.
    */
   export interface Conversation {
     /**
-     * The unique ID of the conversation.
+     * The unique ID of the conversation that this response was associated with.
      */
     id: string;
   }
@@ -1159,13 +1165,19 @@ export interface ResponseCompactionItem {
    */
   id: string;
 
+  /**
+   * The encrypted content that was produced by compaction.
+   */
   encrypted_content: string;
 
   /**
    * The type of the item. Always `compaction`.
    */
   type: 'compaction';
 
+  /**
+   * The identifier of the actor that created the item.
+   */
   created_by?: string;
 }
 
@@ -1174,6 +1186,9 @@ export interface ResponseCompactionItem {
  * [`v1/responses/compact` API](https://platform.openai.com/docs/api-reference/responses/compact).
  */
 export interface ResponseCompactionItemParam {
+  /**
+   * The encrypted content of the compaction summary.
+   */
   encrypted_content: string;
 
   /**
@@ -2172,13 +2187,16 @@ export interface ResponseFunctionCallArgumentsDoneEvent {
 }
 
 /**
- * A text input to the model.
+ * A piece of message content, such as text, an image, or a file.
  */
 export type ResponseFunctionCallOutputItem =
   | ResponseInputTextContent
   | ResponseInputImageContent
   | ResponseInputFileContent;
 
+/**
+ * An array of content outputs (text, image, file) for the function tool call.
+ */
 export type ResponseFunctionCallOutputItemList = Array<ResponseFunctionCallOutputItem>;
 
 /**
@@ -2285,7 +2303,7 @@ export namespace ResponseFunctionShellToolCall {
 }
 
 /**
- * The output of a shell tool call.
+ * The output of a shell tool call that was emitted.
  */
 export interface ResponseFunctionShellToolCallOutput {
   /**
@@ -2315,12 +2333,15 @@ export interface ResponseFunctionShellToolCallOutput {
    */
   type: 'shell_call_output';
 
+  /**
+   * The identifier of the actor that created the item.
+   */
   created_by?: string;
 }
 
 export namespace ResponseFunctionShellToolCallOutput {
   /**
-   * The content of a shell call output.
+   * The content of a shell tool call output that was emitted.
    */
   export interface Output {
     /**
@@ -2329,10 +2350,19 @@ export namespace ResponseFunctionShellToolCallOutput {
      */
     outcome: Output.Timeout | Output.Exit;
 
+    /**
+     * The standard error output that was captured.
+     */
     stderr: string;
 
+    /**
+     * The standard output that was captured.
+     */
     stdout: string;
 
+    /**
+     * The identifier of the actor that created the item.
+     */
     created_by?: string;
   }
 
@@ -2471,7 +2501,7 @@ export namespace ResponseFunctionWebSearch {
    */
   export interface Search {
     /**
-     * The search query.
+     * [DEPRECATED] The search query.
      */
     query: string;
 
@@ -2480,6 +2510,11 @@ export namespace ResponseFunctionWebSearch {
      */
     type: 'search';
 
+    /**
+     * The search queries.
+     */
+    queries?: Array<string>;
+
     /**
      * The sources used in the search.
      */
@@ -5731,6 +5766,9 @@ export namespace Tool {
        */
       file_ids?: Array<string>;
 
+      /**
+       * The memory limit for the code interpreter container.
+       */
       memory_limit?: '1g' | '4g' | '16g' | '64g' | null;
     }
   }

src/resources/videos.ts

@@ -140,9 +140,18 @@ export interface Video {
   status: 'queued' | 'in_progress' | 'completed' | 'failed';
 }
 
+/**
+ * An error that occurred while generating the response.
+ */
 export interface VideoCreateError {
+  /**
+   * A machine-readable error code that was returned.
+   */
   code: string;
 
+  /**
+   * A human-readable description of the error that was returned.
+   */
   message: string;
 }