llama-stack-client 0.2.18-rc1 → 0.2.19-rc1

package/src/resources/responses/responses.ts

@@ -7,6 +7,7 @@ import * as Core from '../../core';
 import * as ResponsesAPI from './responses';
 import * as InputItemsAPI from './input-items';
 import { InputItemListParams, InputItemListResponse, InputItems } from './input-items';
+import { OpenAICursorPage, type OpenAICursorPageParams } from '../../pagination';
 import { Stream } from '../../streaming';
 
 export class Responses extends APIResource {
@@ -45,19 +46,29 @@ export class Responses extends APIResource {
   /**
    * List all OpenAI responses.
    */
-  list(query?: ResponseListParams, options?: Core.RequestOptions): Core.APIPromise<ResponseListResponse>;
-  list(options?: Core.RequestOptions): Core.APIPromise<ResponseListResponse>;
+  list(
+    query?: ResponseListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ResponseListResponsesOpenAICursorPage, ResponseListResponse>;
+  list(
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ResponseListResponsesOpenAICursorPage, ResponseListResponse>;
   list(
     query: ResponseListParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Core.APIPromise<ResponseListResponse> {
+  ): Core.PagePromise<ResponseListResponsesOpenAICursorPage, ResponseListResponse> {
     if (isRequestOptions(query)) {
       return this.list({}, query);
     }
-    return this._client.get('/v1/openai/v1/responses', { query, ...options });
+    return this._client.getAPIList('/v1/openai/v1/responses', ResponseListResponsesOpenAICursorPage, {
+      query,
+      ...options,
+    });
   }
 }
 
+export class ResponseListResponsesOpenAICursorPage extends OpenAICursorPage<ResponseListResponse> {}
+
 /**
  * Complete OpenAI response object containing generation results and metadata.
  */
@@ -340,7 +351,39 @@ export namespace ResponseObject {
     /**
      * (Optional) Search results returned by the file search operation
      */
-    results?: Array<{ [key: string]: boolean | number | string | Array<unknown> | unknown | null }>;
+    results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+  }
+
+  export namespace OpenAIResponseOutputMessageFileSearchToolCall {
+    /**
+     * Search results returned by the file search operation.
+     */
+    export interface Result {
+      /**
+       * (Optional) Key-value attributes associated with the file
+       */
+      attributes: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+
+      /**
+       * Unique identifier of the file containing the result
+       */
+      file_id: string;
+
+      /**
+       * Name of the file containing the result
+       */
+      filename: string;
+
+      /**
+       * Relevance score for this search result (between 0 and 1)
+       */
+      score: number;
+
+      /**
+       * Text content of the search result
+       */
+      text: string;
+    }
   }
 
   /**
@@ -803,7 +846,39 @@ export namespace ResponseObjectStream {
       /**
        * (Optional) Search results returned by the file search operation
        */
-      results?: Array<{ [key: string]: boolean | number | string | Array<unknown> | unknown | null }>;
+      results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+    }
+
+    export namespace OpenAIResponseOutputMessageFileSearchToolCall {
+      /**
+       * Search results returned by the file search operation.
+       */
+      export interface Result {
+        /**
+         * (Optional) Key-value attributes associated with the file
+         */
+        attributes: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+
+        /**
+         * Unique identifier of the file containing the result
+         */
+        file_id: string;
+
+        /**
+         * Name of the file containing the result
+         */
+        filename: string;
+
+        /**
+         * Relevance score for this search result (between 0 and 1)
+         */
+        score: number;
+
+        /**
+         * Text content of the search result
+         */
+        text: string;
+      }
     }
 
     /**
@@ -1165,7 +1240,39 @@ export namespace ResponseObjectStream {
       /**
        * (Optional) Search results returned by the file search operation
        */
-      results?: Array<{ [key: string]: boolean | number | string | Array<unknown> | unknown | null }>;
+      results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+    }
+
+    export namespace OpenAIResponseOutputMessageFileSearchToolCall {
+      /**
+       * Search results returned by the file search operation.
+       */
+      export interface Result {
+        /**
+         * (Optional) Key-value attributes associated with the file
+         */
+        attributes: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+
+        /**
+         * Unique identifier of the file containing the result
+         */
+        file_id: string;
+
+        /**
+         * Name of the file containing the result
+         */
+        filename: string;
+
+        /**
+         * Relevance score for this search result (between 0 and 1)
+         */
+        score: number;
+
+        /**
+         * Text content of the search result
+         */
+        text: string;
+      }
     }
 
     /**
@@ -1687,765 +1794,797 @@ export namespace ResponseObjectStream {
 }
 
 /**
- * Paginated list of OpenAI response objects with navigation metadata.
+ * OpenAI response object extended with input context information.
  */
 export interface ResponseListResponse {
   /**
-   * List of response objects with their input context
+   * Unique identifier for this response
+   */
+  id: string;
+
+  /**
+   * Unix timestamp when the response was created
+   */
+  created_at: number;
+
+  /**
+   * List of input items that led to this response
+   */
+  input: Array<
+    | ResponseListResponse.OpenAIResponseOutputMessageWebSearchToolCall
+    | ResponseListResponse.OpenAIResponseOutputMessageFileSearchToolCall
+    | ResponseListResponse.OpenAIResponseOutputMessageFunctionToolCall
+    | ResponseListResponse.OpenAIResponseInputFunctionToolCallOutput
+    | ResponseListResponse.OpenAIResponseMessage
+  >;
+
+  /**
+   * Model identifier used for generation
+   */
+  model: string;
+
+  /**
+   * Object type identifier, always "response"
+   */
+  object: 'response';
+
+  /**
+   * List of generated output items (messages, tool calls, etc.)
+   */
+  output: Array<
+    | ResponseListResponse.OpenAIResponseMessage
+    | ResponseListResponse.OpenAIResponseOutputMessageWebSearchToolCall
+    | ResponseListResponse.OpenAIResponseOutputMessageFileSearchToolCall
+    | ResponseListResponse.OpenAIResponseOutputMessageFunctionToolCall
+    | ResponseListResponse.OpenAIResponseOutputMessageMcpCall
+    | ResponseListResponse.OpenAIResponseOutputMessageMcpListTools
+  >;
+
+  /**
+   * Whether tool calls can be executed in parallel
+   */
+  parallel_tool_calls: boolean;
+
+  /**
+   * Current status of the response generation
+   */
+  status: string;
+
+  /**
+   * Text formatting configuration for the response
+   */
+  text: ResponseListResponse.Text;
+
+  /**
+   * (Optional) Error details if the response generation failed
+   */
+  error?: ResponseListResponse.Error;
+
+  /**
+   * (Optional) ID of the previous response in a conversation
    */
-  data: Array<ResponseListResponse.Data>;
+  previous_response_id?: string;
 
   /**
-   * Identifier of the first item in this page
+   * (Optional) Sampling temperature used for generation
    */
-  first_id: string;
+  temperature?: number;
 
   /**
-   * Whether there are more results available beyond this page
+   * (Optional) Nucleus sampling parameter used for generation
    */
-  has_more: boolean;
+  top_p?: number;
 
   /**
-   * Identifier of the last item in this page
+   * (Optional) Truncation strategy applied to the response
    */
-  last_id: string;
+  truncation?: string;
 
   /**
-   * Object type identifier, always "list"
+   * (Optional) User identifier associated with the request
    */
-  object: 'list';
+  user?: string;
 }
 
 export namespace ResponseListResponse {
   /**
-   * OpenAI response object extended with input context information.
+   * Web search tool call output message for OpenAI responses.
    */
-  export interface Data {
+  export interface OpenAIResponseOutputMessageWebSearchToolCall {
     /**
-     * Unique identifier for this response
+     * Unique identifier for this tool call
      */
     id: string;
 
     /**
-     * Unix timestamp when the response was created
+     * Current status of the web search operation
      */
-    created_at: number;
+    status: string;
 
     /**
-     * List of input items that led to this response
+     * Tool call type identifier, always "web_search_call"
      */
-    input: Array<
-      | Data.OpenAIResponseOutputMessageWebSearchToolCall
-      | Data.OpenAIResponseOutputMessageFileSearchToolCall
-      | Data.OpenAIResponseOutputMessageFunctionToolCall
-      | Data.OpenAIResponseInputFunctionToolCallOutput
-      | Data.OpenAIResponseMessage
-    >;
+    type: 'web_search_call';
+  }
 
+  /**
+   * File search tool call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageFileSearchToolCall {
     /**
-     * Model identifier used for generation
+     * Unique identifier for this tool call
      */
-    model: string;
+    id: string;
 
     /**
-     * Object type identifier, always "response"
+     * List of search queries executed
      */
-    object: 'response';
+    queries: Array<string>;
 
     /**
-     * List of generated output items (messages, tool calls, etc.)
+     * Current status of the file search operation
      */
-    output: Array<
-      | Data.OpenAIResponseMessage
-      | Data.OpenAIResponseOutputMessageWebSearchToolCall
-      | Data.OpenAIResponseOutputMessageFileSearchToolCall
-      | Data.OpenAIResponseOutputMessageFunctionToolCall
-      | Data.OpenAIResponseOutputMessageMcpCall
-      | Data.OpenAIResponseOutputMessageMcpListTools
-    >;
+    status: string;
 
     /**
-     * Whether tool calls can be executed in parallel
+     * Tool call type identifier, always "file_search_call"
      */
-    parallel_tool_calls: boolean;
+    type: 'file_search_call';
 
     /**
-     * Current status of the response generation
+     * (Optional) Search results returned by the file search operation
      */
-    status: string;
+    results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+  }
 
+  export namespace OpenAIResponseOutputMessageFileSearchToolCall {
     /**
-     * Text formatting configuration for the response
+     * Search results returned by the file search operation.
      */
-    text: Data.Text;
+    export interface Result {
+      /**
+       * (Optional) Key-value attributes associated with the file
+       */
+      attributes: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+
+      /**
+       * Unique identifier of the file containing the result
+       */
+      file_id: string;
+
+      /**
+       * Name of the file containing the result
+       */
+      filename: string;
+
+      /**
+       * Relevance score for this search result (between 0 and 1)
+       */
+      score: number;
+
+      /**
+       * Text content of the search result
+       */
+      text: string;
+    }
+  }
 
+  /**
+   * Function tool call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageFunctionToolCall {
     /**
-     * (Optional) Error details if the response generation failed
+     * JSON string containing the function arguments
      */
-    error?: Data.Error;
+    arguments: string;
 
     /**
-     * (Optional) ID of the previous response in a conversation
+     * Unique identifier for the function call
      */
-    previous_response_id?: string;
+    call_id: string;
 
     /**
-     * (Optional) Sampling temperature used for generation
+     * Name of the function being called
      */
-    temperature?: number;
+    name: string;
 
     /**
-     * (Optional) Nucleus sampling parameter used for generation
+     * Tool call type identifier, always "function_call"
      */
-    top_p?: number;
+    type: 'function_call';
 
     /**
-     * (Optional) Truncation strategy applied to the response
+     * (Optional) Additional identifier for the tool call
      */
-    truncation?: string;
+    id?: string;
 
     /**
-     * (Optional) User identifier associated with the request
+     * (Optional) Current status of the function call execution
      */
-    user?: string;
+    status?: string;
+  }
+
+  /**
+   * This represents the output of a function call that gets passed back to the
+   * model.
+   */
+  export interface OpenAIResponseInputFunctionToolCallOutput {
+    call_id: string;
+
+    output: string;
+
+    type: 'function_call_output';
+
+    id?: string;
+
+    status?: string;
+  }
+
+  /**
+   * Corresponds to the various Message types in the Responses API. They are all
+   * under one type because the Responses API gives them all the same "type" value,
+   * and there is no way to tell them apart in certain scenarios.
+   */
+  export interface OpenAIResponseMessage {
+    content:
+      | string
+      | Array<
+          | OpenAIResponseMessage.OpenAIResponseInputMessageContentText
+          | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage
+        >
+      | Array<OpenAIResponseMessage.UnionMember2>;
+
+    role: 'system' | 'developer' | 'user' | 'assistant';
+
+    type: 'message';
+
+    id?: string;
+
+    status?: string;
   }
 
-  export namespace Data {
+  export namespace OpenAIResponseMessage {
     /**
-     * Web search tool call output message for OpenAI responses.
+     * Text content for input messages in OpenAI response format.
      */
-    export interface OpenAIResponseOutputMessageWebSearchToolCall {
-      /**
-       * Unique identifier for this tool call
-       */
-      id: string;
-
+    export interface OpenAIResponseInputMessageContentText {
       /**
-       * Current status of the web search operation
+       * The text content of the input message
        */
-      status: string;
+      text: string;
 
       /**
-       * Tool call type identifier, always "web_search_call"
+       * Content type identifier, always "input_text"
        */
-      type: 'web_search_call';
+      type: 'input_text';
     }
 
     /**
-     * File search tool call output message for OpenAI responses.
+     * Image content for input messages in OpenAI response format.
      */
-    export interface OpenAIResponseOutputMessageFileSearchToolCall {
+    export interface OpenAIResponseInputMessageContentImage {
       /**
-       * Unique identifier for this tool call
+       * Level of detail for image processing, can be "low", "high", or "auto"
        */
-      id: string;
+      detail: 'low' | 'high' | 'auto';
 
       /**
-       * List of search queries executed
+       * Content type identifier, always "input_image"
        */
-      queries: Array<string>;
+      type: 'input_image';
 
       /**
-       * Current status of the file search operation
+       * (Optional) URL of the image content
        */
-      status: string;
-
-      /**
-       * Tool call type identifier, always "file_search_call"
-       */
-      type: 'file_search_call';
-
-      /**
-       * (Optional) Search results returned by the file search operation
-       */
-      results?: Array<{ [key: string]: boolean | number | string | Array<unknown> | unknown | null }>;
+      image_url?: string;
     }
 
-    /**
-     * Function tool call output message for OpenAI responses.
-     */
-    export interface OpenAIResponseOutputMessageFunctionToolCall {
-      /**
-       * JSON string containing the function arguments
-       */
-      arguments: string;
-
-      /**
-       * Unique identifier for the function call
-       */
-      call_id: string;
-
-      /**
-       * Name of the function being called
-       */
-      name: string;
+    export interface UnionMember2 {
+      annotations: Array<
+        | UnionMember2.OpenAIResponseAnnotationFileCitation
+        | UnionMember2.OpenAIResponseAnnotationCitation
+        | UnionMember2.OpenAIResponseAnnotationContainerFileCitation
+        | UnionMember2.OpenAIResponseAnnotationFilePath
+      >;
 
-      /**
-       * Tool call type identifier, always "function_call"
-       */
-      type: 'function_call';
+      text: string;
 
-      /**
-       * (Optional) Additional identifier for the tool call
-       */
-      id?: string;
+      type: 'output_text';
+    }
 
+    export namespace UnionMember2 {
       /**
-       * (Optional) Current status of the function call execution
+       * File citation annotation for referencing specific files in response content.
        */
-      status?: string;
-    }
-
-    /**
-     * This represents the output of a function call that gets passed back to the
-     * model.
-     */
-    export interface OpenAIResponseInputFunctionToolCallOutput {
-      call_id: string;
-
-      output: string;
-
-      type: 'function_call_output';
-
-      id?: string;
-
-      status?: string;
-    }
-
-    /**
-     * Corresponds to the various Message types in the Responses API. They are all
-     * under one type because the Responses API gives them all the same "type" value,
-     * and there is no way to tell them apart in certain scenarios.
-     */
-    export interface OpenAIResponseMessage {
-      content:
-        | string
-        | Array<
-            | OpenAIResponseMessage.OpenAIResponseInputMessageContentText
-            | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage
-          >
-        | Array<OpenAIResponseMessage.UnionMember2>;
-
-      role: 'system' | 'developer' | 'user' | 'assistant';
-
-      type: 'message';
-
-      id?: string;
+      export interface OpenAIResponseAnnotationFileCitation {
+        /**
+         * Unique identifier of the referenced file
+         */
+        file_id: string;
 
-      status?: string;
-    }
+        /**
+         * Name of the referenced file
+         */
+        filename: string;
 
-    export namespace OpenAIResponseMessage {
-      /**
-       * Text content for input messages in OpenAI response format.
-       */
-      export interface OpenAIResponseInputMessageContentText {
         /**
-         * The text content of the input message
+         * Position index of the citation within the content
          */
-        text: string;
+        index: number;
 
         /**
-         * Content type identifier, always "input_text"
+         * Annotation type identifier, always "file_citation"
          */
-        type: 'input_text';
+        type: 'file_citation';
       }
 
       /**
-       * Image content for input messages in OpenAI response format.
+       * URL citation annotation for referencing external web resources.
        */
-      export interface OpenAIResponseInputMessageContentImage {
+      export interface OpenAIResponseAnnotationCitation {
         /**
-         * Level of detail for image processing, can be "low", "high", or "auto"
+         * End position of the citation span in the content
          */
-        detail: 'low' | 'high' | 'auto';
+        end_index: number;
 
         /**
-         * Content type identifier, always "input_image"
+         * Start position of the citation span in the content
          */
-        type: 'input_image';
+        start_index: number;
 
         /**
-         * (Optional) URL of the image content
+         * Title of the referenced web resource
          */
-        image_url?: string;
-      }
-
-      export interface UnionMember2 {
-        annotations: Array<
-          | UnionMember2.OpenAIResponseAnnotationFileCitation
-          | UnionMember2.OpenAIResponseAnnotationCitation
-          | UnionMember2.OpenAIResponseAnnotationContainerFileCitation
-          | UnionMember2.OpenAIResponseAnnotationFilePath
-        >;
-
-        text: string;
-
-        type: 'output_text';
-      }
+        title: string;
 
-      export namespace UnionMember2 {
         /**
-         * File citation annotation for referencing specific files in response content.
+         * Annotation type identifier, always "url_citation"
          */
-        export interface OpenAIResponseAnnotationFileCitation {
-          /**
-           * Unique identifier of the referenced file
-           */
-          file_id: string;
+        type: 'url_citation';
 
-          /**
-           * Name of the referenced file
-           */
-          filename: string;
+        /**
+         * URL of the referenced web resource
+         */
+        url: string;
+      }
 
-          /**
-           * Position index of the citation within the content
-           */
-          index: number;
+      export interface OpenAIResponseAnnotationContainerFileCitation {
+        container_id: string;
 
-          /**
-           * Annotation type identifier, always "file_citation"
-           */
-          type: 'file_citation';
-        }
+        end_index: number;
 
-        /**
-         * URL citation annotation for referencing external web resources.
-         */
-        export interface OpenAIResponseAnnotationCitation {
-          /**
-           * End position of the citation span in the content
-           */
-          end_index: number;
+        file_id: string;
 
-          /**
-           * Start position of the citation span in the content
-           */
-          start_index: number;
+        filename: string;
 
-          /**
-           * Title of the referenced web resource
-           */
-          title: string;
+        start_index: number;
 
-          /**
-           * Annotation type identifier, always "url_citation"
-           */
-          type: 'url_citation';
+        type: 'container_file_citation';
+      }
 
-          /**
-           * URL of the referenced web resource
-           */
-          url: string;
-        }
+      export interface OpenAIResponseAnnotationFilePath {
+        file_id: string;
 
-        export interface OpenAIResponseAnnotationContainerFileCitation {
-          container_id: string;
+        index: number;
 
-          end_index: number;
+        type: 'file_path';
+      }
+    }
+  }
 
-          file_id: string;
+  /**
+   * Corresponds to the various Message types in the Responses API. They are all
+   * under one type because the Responses API gives them all the same "type" value,
+   * and there is no way to tell them apart in certain scenarios.
+   */
+  export interface OpenAIResponseMessage {
+    content:
+      | string
+      | Array<
+          | OpenAIResponseMessage.OpenAIResponseInputMessageContentText
+          | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage
+        >
+      | Array<OpenAIResponseMessage.UnionMember2>;
 
-          filename: string;
+    role: 'system' | 'developer' | 'user' | 'assistant';
 
-          start_index: number;
+    type: 'message';
 
-          type: 'container_file_citation';
-        }
+    id?: string;
 
-        export interface OpenAIResponseAnnotationFilePath {
-          file_id: string;
+    status?: string;
+  }
 
-          index: number;
+  export namespace OpenAIResponseMessage {
+    /**
+     * Text content for input messages in OpenAI response format.
+     */
+    export interface OpenAIResponseInputMessageContentText {
+      /**
+       * The text content of the input message
+       */
+      text: string;
 
-          type: 'file_path';
-        }
-      }
+      /**
+       * Content type identifier, always "input_text"
+       */
+      type: 'input_text';
     }
 
     /**
-     * Corresponds to the various Message types in the Responses API. They are all
-     * under one type because the Responses API gives them all the same "type" value,
-     * and there is no way to tell them apart in certain scenarios.
-     */
-    export interface OpenAIResponseMessage {
-      content:
-        | string
-        | Array<
-            | OpenAIResponseMessage.OpenAIResponseInputMessageContentText
-            | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage
-          >
-        | Array<OpenAIResponseMessage.UnionMember2>;
+     * Image content for input messages in OpenAI response format.
+     */
+    export interface OpenAIResponseInputMessageContentImage {
+      /**
+       * Level of detail for image processing, can be "low", "high", or "auto"
+       */
+      detail: 'low' | 'high' | 'auto';
 
-      role: 'system' | 'developer' | 'user' | 'assistant';
+      /**
+       * Content type identifier, always "input_image"
+       */
+      type: 'input_image';
 
-      type: 'message';
+      /**
+       * (Optional) URL of the image content
+       */
+      image_url?: string;
+    }
 
-      id?: string;
+    export interface UnionMember2 {
+      annotations: Array<
+        | UnionMember2.OpenAIResponseAnnotationFileCitation
+        | UnionMember2.OpenAIResponseAnnotationCitation
+        | UnionMember2.OpenAIResponseAnnotationContainerFileCitation
+        | UnionMember2.OpenAIResponseAnnotationFilePath
+      >;
 
-      status?: string;
+      text: string;
+
+      type: 'output_text';
     }
 
-    export namespace OpenAIResponseMessage {
+    export namespace UnionMember2 {
       /**
-       * Text content for input messages in OpenAI response format.
+       * File citation annotation for referencing specific files in response content.
        */
-      export interface OpenAIResponseInputMessageContentText {
+      export interface OpenAIResponseAnnotationFileCitation {
         /**
-         * The text content of the input message
+         * Unique identifier of the referenced file
          */
-        text: string;
+        file_id: string;
 
         /**
-         * Content type identifier, always "input_text"
+         * Name of the referenced file
          */
-        type: 'input_text';
+        filename: string;
+
+        /**
+         * Position index of the citation within the content
+         */
+        index: number;
+
+        /**
+         * Annotation type identifier, always "file_citation"
+         */
+        type: 'file_citation';
       }
 
       /**
-       * Image content for input messages in OpenAI response format.
+       * URL citation annotation for referencing external web resources.
        */
-      export interface OpenAIResponseInputMessageContentImage {
+      export interface OpenAIResponseAnnotationCitation {
         /**
-         * Level of detail for image processing, can be "low", "high", or "auto"
+         * End position of the citation span in the content
          */
-        detail: 'low' | 'high' | 'auto';
+        end_index: number;
 
         /**
-         * Content type identifier, always "input_image"
+         * Start position of the citation span in the content
          */
-        type: 'input_image';
+        start_index: number;
 
         /**
-         * (Optional) URL of the image content
+         * Title of the referenced web resource
          */
-        image_url?: string;
-      }
-
-      export interface UnionMember2 {
-        annotations: Array<
-          | UnionMember2.OpenAIResponseAnnotationFileCitation
-          | UnionMember2.OpenAIResponseAnnotationCitation
-          | UnionMember2.OpenAIResponseAnnotationContainerFileCitation
-          | UnionMember2.OpenAIResponseAnnotationFilePath
-        >;
-
-        text: string;
+        title: string;
 
-        type: 'output_text';
-      }
+        /**
+         * Annotation type identifier, always "url_citation"
+         */
+        type: 'url_citation';
 
-      export namespace UnionMember2 {
         /**
-         * File citation annotation for referencing specific files in response content.
+         * URL of the referenced web resource
          */
-        export interface OpenAIResponseAnnotationFileCitation {
-          /**
-           * Unique identifier of the referenced file
-           */
-          file_id: string;
+        url: string;
+      }
 
-          /**
-           * Name of the referenced file
-           */
-          filename: string;
+      export interface OpenAIResponseAnnotationContainerFileCitation {
+        container_id: string;
 
-          /**
-           * Position index of the citation within the content
-           */
-          index: number;
+        end_index: number;
 
-          /**
-           * Annotation type identifier, always "file_citation"
-           */
-          type: 'file_citation';
-        }
+        file_id: string;
 
-        /**
-         * URL citation annotation for referencing external web resources.
-         */
-        export interface OpenAIResponseAnnotationCitation {
-          /**
-           * End position of the citation span in the content
-           */
-          end_index: number;
+        filename: string;
 
-          /**
-           * Start position of the citation span in the content
-           */
-          start_index: number;
+        start_index: number;
 
-          /**
-           * Title of the referenced web resource
-           */
-          title: string;
+        type: 'container_file_citation';
+      }
 
-          /**
-           * Annotation type identifier, always "url_citation"
-           */
-          type: 'url_citation';
+      export interface OpenAIResponseAnnotationFilePath {
+        file_id: string;
 
-          /**
-           * URL of the referenced web resource
-           */
-          url: string;
-        }
+        index: number;
 
-        export interface OpenAIResponseAnnotationContainerFileCitation {
-          container_id: string;
+        type: 'file_path';
+      }
+    }
+  }
 
-          end_index: number;
+  /**
+   * Web search tool call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageWebSearchToolCall {
+    /**
+     * Unique identifier for this tool call
+     */
+    id: string;
 
-          file_id: string;
+    /**
+     * Current status of the web search operation
+     */
+    status: string;
 
-          filename: string;
+    /**
+     * Tool call type identifier, always "web_search_call"
+     */
+    type: 'web_search_call';
+  }
 
-          start_index: number;
+  /**
+   * File search tool call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageFileSearchToolCall {
+    /**
+     * Unique identifier for this tool call
+     */
+    id: string;
 
-          type: 'container_file_citation';
-        }
+    /**
+     * List of search queries executed
+     */
+    queries: Array<string>;
 
-        export interface OpenAIResponseAnnotationFilePath {
-          file_id: string;
+    /**
+     * Current status of the file search operation
+     */
+    status: string;
 
-          index: number;
+    /**
+     * Tool call type identifier, always "file_search_call"
+     */
+    type: 'file_search_call';
 
-          type: 'file_path';
-        }
-      }
-    }
+    /**
+     * (Optional) Search results returned by the file search operation
+     */
+    results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+  }
 
+  export namespace OpenAIResponseOutputMessageFileSearchToolCall {
     /**
-     * Web search tool call output message for OpenAI responses.
+     * Search results returned by the file search operation.
      */
-    export interface OpenAIResponseOutputMessageWebSearchToolCall {
+    export interface Result {
       /**
-       * Unique identifier for this tool call
+       * (Optional) Key-value attributes associated with the file
        */
-      id: string;
+      attributes: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
 
       /**
-       * Current status of the web search operation
+       * Unique identifier of the file containing the result
        */
-      status: string;
+      file_id: string;
 
       /**
-       * Tool call type identifier, always "web_search_call"
+       * Name of the file containing the result
        */
-      type: 'web_search_call';
+      filename: string;
+
+      /**
+       * Relevance score for this search result (between 0 and 1)
+       */
+      score: number;
+
+      /**
+       * Text content of the search result
+       */
+      text: string;
     }
+  }
+
+  /**
+   * Function tool call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageFunctionToolCall {
+    /**
+     * JSON string containing the function arguments
+     */
+    arguments: string;
+
+    /**
+     * Unique identifier for the function call
+     */
+    call_id: string;
+
+    /**
+     * Name of the function being called
+     */
+    name: string;
+
+    /**
+     * Tool call type identifier, always "function_call"
+     */
+    type: 'function_call';
+
+    /**
+     * (Optional) Additional identifier for the tool call
+     */
+    id?: string;
+
+    /**
+     * (Optional) Current status of the function call execution
+     */
+    status?: string;
+  }
 
+  /**
+   * Model Context Protocol (MCP) call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageMcpCall {
     /**
-     * File search tool call output message for OpenAI responses.
+     * Unique identifier for this MCP call
      */
-    export interface OpenAIResponseOutputMessageFileSearchToolCall {
-      /**
-       * Unique identifier for this tool call
-       */
-      id: string;
-
-      /**
-       * List of search queries executed
-       */
-      queries: Array<string>;
+    id: string;
 
-      /**
-       * Current status of the file search operation
-       */
-      status: string;
+    /**
+     * JSON string containing the MCP call arguments
+     */
+    arguments: string;
 
-      /**
-       * Tool call type identifier, always "file_search_call"
-       */
-      type: 'file_search_call';
+    /**
+     * Name of the MCP method being called
+     */
+    name: string;
 
-      /**
-       * (Optional) Search results returned by the file search operation
-       */
-      results?: Array<{ [key: string]: boolean | number | string | Array<unknown> | unknown | null }>;
-    }
+    /**
+     * Label identifying the MCP server handling the call
+     */
+    server_label: string;
 
     /**
-     * Function tool call output message for OpenAI responses.
+     * Tool call type identifier, always "mcp_call"
      */
-    export interface OpenAIResponseOutputMessageFunctionToolCall {
-      /**
-       * JSON string containing the function arguments
-       */
-      arguments: string;
+    type: 'mcp_call';
 
-      /**
-       * Unique identifier for the function call
-       */
-      call_id: string;
+    /**
+     * (Optional) Error message if the MCP call failed
+     */
+    error?: string;
 
-      /**
-       * Name of the function being called
-       */
-      name: string;
+    /**
+     * (Optional) Output result from the successful MCP call
+     */
+    output?: string;
+  }
 
-      /**
-       * Tool call type identifier, always "function_call"
-       */
-      type: 'function_call';
+  /**
+   * MCP list tools output message containing available tools from an MCP server.
+   */
+  export interface OpenAIResponseOutputMessageMcpListTools {
+    /**
+     * Unique identifier for this MCP list tools operation
+     */
+    id: string;
 
-      /**
-       * (Optional) Additional identifier for the tool call
-       */
-      id?: string;
+    /**
+     * Label identifying the MCP server providing the tools
+     */
+    server_label: string;
 
-      /**
-       * (Optional) Current status of the function call execution
-       */
-      status?: string;
-    }
+    /**
+     * List of available tools provided by the MCP server
+     */
+    tools: Array<OpenAIResponseOutputMessageMcpListTools.Tool>;
 
     /**
-     * Model Context Protocol (MCP) call output message for OpenAI responses.
+     * Tool call type identifier, always "mcp_list_tools"
      */
-    export interface OpenAIResponseOutputMessageMcpCall {
-      /**
-       * Unique identifier for this MCP call
-       */
-      id: string;
+    type: 'mcp_list_tools';
+  }
 
+  export namespace OpenAIResponseOutputMessageMcpListTools {
+    /**
+     * Tool definition returned by MCP list tools operation.
+     */
+    export interface Tool {
       /**
-       * JSON string containing the MCP call arguments
+       * JSON schema defining the tool's input parameters
        */
-      arguments: string;
+      input_schema: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
 
       /**
-       * Name of the MCP method being called
+       * Name of the tool
        */
       name: string;
 
       /**
-       * Label identifying the MCP server handling the call
-       */
-      server_label: string;
-
-      /**
-       * Tool call type identifier, always "mcp_call"
-       */
-      type: 'mcp_call';
-
-      /**
-       * (Optional) Error message if the MCP call failed
-       */
-      error?: string;
-
-      /**
-       * (Optional) Output result from the successful MCP call
+       * (Optional) Description of what the tool does
        */
-      output?: string;
+      description?: string;
     }
+  }
 
+  /**
+   * Text formatting configuration for the response
+   */
+  export interface Text {
     /**
-     * MCP list tools output message containing available tools from an MCP server.
+     * (Optional) Text format configuration specifying output format requirements
      */
-    export interface OpenAIResponseOutputMessageMcpListTools {
+    format?: Text.Format;
+  }
+
+  export namespace Text {
+    /**
+     * (Optional) Text format configuration specifying output format requirements
+     */
+    export interface Format {
       /**
-       * Unique identifier for this MCP list tools operation
+       * Must be "text", "json_schema", or "json_object" to identify the format type
        */
-      id: string;
+      type: 'text' | 'json_schema' | 'json_object';
 
       /**
-       * Label identifying the MCP server providing the tools
+       * (Optional) A description of the response format. Only used for json_schema.
        */
-      server_label: string;
+      description?: string;
 
       /**
-       * List of available tools provided by the MCP server
+       * The name of the response format. Only used for json_schema.
        */
-      tools: Array<OpenAIResponseOutputMessageMcpListTools.Tool>;
+      name?: string;
 
       /**
-       * Tool call type identifier, always "mcp_list_tools"
+       * The JSON schema the response should conform to. In a Python SDK, this is often a
+       * `pydantic` model. Only used for json_schema.
        */
-      type: 'mcp_list_tools';
-    }
+      schema?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
 
-    export namespace OpenAIResponseOutputMessageMcpListTools {
       /**
-       * Tool definition returned by MCP list tools operation.
+       * (Optional) Whether to strictly enforce the JSON schema. If true, the response
+       * must match the schema exactly. Only used for json_schema.
        */
-      export interface Tool {
-        /**
-         * JSON schema defining the tool's input parameters
-         */
-        input_schema: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
-
-        /**
-         * Name of the tool
-         */
-        name: string;
-
-        /**
-         * (Optional) Description of what the tool does
-         */
-        description?: string;
-      }
+      strict?: boolean;
     }
+  }
 
+  /**
+   * (Optional) Error details if the response generation failed
+   */
+  export interface Error {
     /**
-     * Text formatting configuration for the response
+     * Error code identifying the type of failure
      */
-    export interface Text {
-      /**
-       * (Optional) Text format configuration specifying output format requirements
-       */
-      format?: Text.Format;
-    }
-
-    export namespace Text {
-      /**
-       * (Optional) Text format configuration specifying output format requirements
-       */
-      export interface Format {
-        /**
-         * Must be "text", "json_schema", or "json_object" to identify the format type
-         */
-        type: 'text' | 'json_schema' | 'json_object';
-
-        /**
-         * (Optional) A description of the response format. Only used for json_schema.
-         */
-        description?: string;
-
-        /**
-         * The name of the response format. Only used for json_schema.
-         */
-        name?: string;
-
-        /**
-         * The JSON schema the response should conform to. In a Python SDK, this is often a
-         * `pydantic` model. Only used for json_schema.
-         */
-        schema?: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
-
-        /**
-         * (Optional) Whether to strictly enforce the JSON schema. If true, the response
-         * must match the schema exactly. Only used for json_schema.
-         */
-        strict?: boolean;
-      }
-    }
+    code: string;
 
     /**
-     * (Optional) Error details if the response generation failed
+     * Human-readable error message describing the failure
      */
-    export interface Error {
-      /**
-       * Error code identifying the type of failure
-       */
-      code: string;
-
-      /**
-       * Human-readable error message describing the failure
-       */
-      message: string;
-    }
+    message: string;
   }
 }
 
@@ -2470,6 +2609,11 @@ export interface ResponseCreateParamsBase {
    */
   model: string;
 
+  /**
+   * (Optional) Additional fields to include in the response.
+   */
+  include?: Array<string>;
+
   instructions?: string;
 
   max_infer_iters?: number;
@@ -2548,7 +2692,39 @@ export namespace ResponseCreateParams {
     /**
      * (Optional) Search results returned by the file search operation
      */
-    results?: Array<{ [key: string]: boolean | number | string | Array<unknown> | unknown | null }>;
+    results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+  }
+
+  export namespace OpenAIResponseOutputMessageFileSearchToolCall {
+    /**
+     * Search results returned by the file search operation.
+     */
+    export interface Result {
+      /**
+       * (Optional) Key-value attributes associated with the file
+       */
+      attributes: { [key: string]: boolean | number | string | Array<unknown> | unknown | null };
+
+      /**
+       * Unique identifier of the file containing the result
+       */
+      file_id: string;
+
+      /**
+       * Name of the file containing the result
+       */
+      filename: string;
+
+      /**
+       * Relevance score for this search result (between 0 and 1)
+       */
+      score: number;
+
+      /**
+       * Text content of the search result
+       */
+      text: string;
+    }
   }
 
   /**
@@ -2964,17 +3140,7 @@ export interface ResponseCreateParamsStreaming extends ResponseCreateParamsBase
   stream: true;
 }
 
-export interface ResponseListParams {
-  /**
-   * The ID of the last response to return.
-   */
-  after?: string;
-
-  /**
-   * The number of responses to return.
-   */
-  limit?: number;
-
+export interface ResponseListParams extends OpenAICursorPageParams {
   /**
    * The model to filter responses by.
    */
@@ -2986,6 +3152,7 @@ export interface ResponseListParams {
   order?: 'asc' | 'desc';
 }
 
+Responses.ResponseListResponsesOpenAICursorPage = ResponseListResponsesOpenAICursorPage;
 Responses.InputItems = InputItems;
 
 export declare namespace Responses {
@@ -2993,6 +3160,7 @@ export declare namespace Responses {
     type ResponseObject as ResponseObject,
     type ResponseObjectStream as ResponseObjectStream,
     type ResponseListResponse as ResponseListResponse,
+    ResponseListResponsesOpenAICursorPage as ResponseListResponsesOpenAICursorPage,
     type ResponseCreateParams as ResponseCreateParams,
     type ResponseCreateParamsNonStreaming as ResponseCreateParamsNonStreaming,
     type ResponseCreateParamsStreaming as ResponseCreateParamsStreaming,