llama-stack-client 0.2.18 → 0.2.19-rc2

package/resources/responses/responses.d.ts

@@ -4,6 +4,7 @@ import * as Core from "../../core.js";
 import * as ResponsesAPI from "./responses.js";
 import * as InputItemsAPI from "./input-items.js";
 import { InputItemListParams, InputItemListResponse, InputItems } from "./input-items.js";
+import { OpenAICursorPage, type OpenAICursorPageParams } from "../../pagination.js";
 import { Stream } from "../../streaming.js";
 export declare class Responses extends APIResource {
     inputItems: InputItemsAPI.InputItems;
@@ -20,8 +21,10 @@ export declare 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>;
+}
+export declare class ResponseListResponsesOpenAICursorPage extends OpenAICursorPage<ResponseListResponse> {
 }
 /**
  * Complete OpenAI response object containing generation results and metadata.
@@ -235,9 +238,36 @@ export declare 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>;
+    }
+    namespace OpenAIResponseOutputMessageFileSearchToolCall {
+        /**
+         * Search results returned by the file search operation.
+         */
+        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.
@@ -591,9 +621,36 @@ export declare 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>;
+        }
+        namespace OpenAIResponseOutputMessageFileSearchToolCall {
+            /**
+             * Search results returned by the file search operation.
+             */
+            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.
@@ -876,9 +933,36 @@ export declare 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>;
+        }
+        namespace OpenAIResponseOutputMessageFileSearchToolCall {
+            /**
+             * Search results returned by the file search operation.
+             */
+            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.
@@ -1299,602 +1383,629 @@ export declare 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
      */
-    data: Array<ResponseListResponse.Data>;
+    error?: ResponseListResponse.Error;
+    /**
+     * (Optional) ID of the previous response in a conversation
+     */
+    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 declare namespace ResponseListResponse {
     /**
-     * OpenAI response object extended with input context information.
+     * Web search tool call output message for OpenAI responses.
      */
-    interface Data {
+    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.
+     */
+    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>;
+    }
+    namespace OpenAIResponseOutputMessageFileSearchToolCall {
         /**
-         * Text formatting configuration for the response
+         * Search results returned by the file search operation.
          */
-        text: Data.Text;
+        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.
+     */
+    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.
+     */
+    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.
+     */
+    interface OpenAIResponseMessage {
+        content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage> | Array<OpenAIResponseMessage.UnionMember2>;
+        role: 'system' | 'developer' | 'user' | 'assistant';
+        type: 'message';
+        id?: string;
+        status?: string;
     }
-    namespace Data {
+    namespace OpenAIResponseMessage {
         /**
-         * Web search tool call output message for OpenAI responses.
+         * Text content for input messages in OpenAI response format.
          */
-        interface OpenAIResponseOutputMessageWebSearchToolCall {
-            /**
-             * Unique identifier for this tool call
-             */
-            id: string;
+        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.
          */
-        interface OpenAIResponseOutputMessageFileSearchToolCall {
-            /**
-             * Unique identifier for this tool call
-             */
-            id: string;
-            /**
-             * List of search queries executed
-             */
-            queries: Array<string>;
+        interface OpenAIResponseInputMessageContentImage {
             /**
-             * Current status of the file search operation
+             * Level of detail for image processing, can be "low", "high", or "auto"
              */
-            status: string;
+            detail: 'low' | 'high' | 'auto';
             /**
-             * Tool call type identifier, always "file_search_call"
+             * Content type identifier, always "input_image"
              */
-            type: 'file_search_call';
+            type: 'input_image';
             /**
-             * (Optional) Search results returned by the file search operation
+             * (Optional) URL of the image content
              */
-            results?: Array<{
-                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
-            }>;
+            image_url?: string;
         }
-        /**
-         * Function tool call output message for OpenAI responses.
-         */
-        interface OpenAIResponseOutputMessageFunctionToolCall {
+        interface UnionMember2 {
+            annotations: Array<UnionMember2.OpenAIResponseAnnotationFileCitation | UnionMember2.OpenAIResponseAnnotationCitation | UnionMember2.OpenAIResponseAnnotationContainerFileCitation | UnionMember2.OpenAIResponseAnnotationFilePath>;
+            text: string;
+            type: 'output_text';
+        }
+        namespace UnionMember2 {
             /**
-             * JSON string containing the function arguments
+             * File citation annotation for referencing specific files in response content.
              */
-            arguments: string;
+            interface OpenAIResponseAnnotationFileCitation {
+                /**
+                 * Unique identifier of the referenced file
+                 */
+                file_id: string;
+                /**
+                 * Name of the referenced file
+                 */
+                filename: string;
+                /**
+                 * Position index of the citation within the content
+                 */
+                index: number;
+                /**
+                 * Annotation type identifier, always "file_citation"
+                 */
+                type: 'file_citation';
+            }
             /**
-             * Unique identifier for the function call
+             * URL citation annotation for referencing external web resources.
              */
-            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;
-        }
-        /**
-         * This represents the output of a function call that gets passed back to the
-         * model.
-         */
-        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.
-         */
-        interface OpenAIResponseMessage {
-            content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage> | Array<OpenAIResponseMessage.UnionMember2>;
-            role: 'system' | 'developer' | 'user' | 'assistant';
-            type: 'message';
-            id?: string;
-            status?: string;
-        }
-        namespace OpenAIResponseMessage {
-            /**
-             * Text content for input messages in OpenAI response format.
-             */
-            interface OpenAIResponseInputMessageContentText {
+            interface OpenAIResponseAnnotationCitation {
                 /**
-                 * The text content of the input message
+                 * End position of the citation span in the content
                  */
-                text: string;
+                end_index: number;
                 /**
-                 * Content type identifier, always "input_text"
+                 * Start position of the citation span in the content
                  */
-                type: 'input_text';
-            }
-            /**
-             * Image content for input messages in OpenAI response format.
-             */
-            interface OpenAIResponseInputMessageContentImage {
+                start_index: number;
                 /**
-                 * Level of detail for image processing, can be "low", "high", or "auto"
+                 * Title of the referenced web resource
                  */
-                detail: 'low' | 'high' | 'auto';
+                title: string;
                 /**
-                 * Content type identifier, always "input_image"
+                 * Annotation type identifier, always "url_citation"
                  */
-                type: 'input_image';
+                type: 'url_citation';
                 /**
-                 * (Optional) URL of the image content
+                 * URL of the referenced web resource
                  */
-                image_url?: string;
+                url: string;
             }
-            interface UnionMember2 {
-                annotations: Array<UnionMember2.OpenAIResponseAnnotationFileCitation | UnionMember2.OpenAIResponseAnnotationCitation | UnionMember2.OpenAIResponseAnnotationContainerFileCitation | UnionMember2.OpenAIResponseAnnotationFilePath>;
-                text: string;
-                type: 'output_text';
+            interface OpenAIResponseAnnotationContainerFileCitation {
+                container_id: string;
+                end_index: number;
+                file_id: string;
+                filename: string;
+                start_index: number;
+                type: 'container_file_citation';
             }
-            namespace UnionMember2 {
-                /**
-                 * File citation annotation for referencing specific files in response content.
-                 */
-                interface OpenAIResponseAnnotationFileCitation {
-                    /**
-                     * Unique identifier of the referenced file
-                     */
-                    file_id: string;
-                    /**
-                     * Name of the referenced file
-                     */
-                    filename: string;
-                    /**
-                     * Position index of the citation within the content
-                     */
-                    index: number;
-                    /**
-                     * Annotation type identifier, always "file_citation"
-                     */
-                    type: 'file_citation';
-                }
-                /**
-                 * URL citation annotation for referencing external web resources.
-                 */
-                interface OpenAIResponseAnnotationCitation {
-                    /**
-                     * End position of the citation span in the content
-                     */
-                    end_index: number;
-                    /**
-                     * Start position of the citation span in the content
-                     */
-                    start_index: number;
-                    /**
-                     * Title of the referenced web resource
-                     */
-                    title: string;
-                    /**
-                     * Annotation type identifier, always "url_citation"
-                     */
-                    type: 'url_citation';
-                    /**
-                     * URL of the referenced web resource
-                     */
-                    url: string;
-                }
-                interface OpenAIResponseAnnotationContainerFileCitation {
-                    container_id: string;
-                    end_index: number;
-                    file_id: string;
-                    filename: string;
-                    start_index: number;
-                    type: 'container_file_citation';
-                }
-                interface OpenAIResponseAnnotationFilePath {
-                    file_id: string;
-                    index: number;
-                    type: 'file_path';
-                }
+            interface OpenAIResponseAnnotationFilePath {
+                file_id: string;
+                index: number;
+                type: 'file_path';
             }
         }
+    }
+    /**
+     * 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.
+     */
+    interface OpenAIResponseMessage {
+        content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage> | Array<OpenAIResponseMessage.UnionMember2>;
+        role: 'system' | 'developer' | 'user' | 'assistant';
+        type: 'message';
+        id?: string;
+        status?: string;
+    }
+    namespace OpenAIResponseMessage {
         /**
-         * 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.
+         * Text content for input messages in OpenAI response format.
          */
-        interface OpenAIResponseMessage {
-            content: string | Array<OpenAIResponseMessage.OpenAIResponseInputMessageContentText | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage> | Array<OpenAIResponseMessage.UnionMember2>;
-            role: 'system' | 'developer' | 'user' | 'assistant';
-            type: 'message';
-            id?: string;
-            status?: string;
+        interface OpenAIResponseInputMessageContentText {
+            /**
+             * The text content of the input message
+             */
+            text: string;
+            /**
+             * Content type identifier, always "input_text"
+             */
+            type: 'input_text';
         }
-        namespace OpenAIResponseMessage {
+        /**
+         * Image content for input messages in OpenAI response format.
+         */
+        interface OpenAIResponseInputMessageContentImage {
             /**
-             * Text content for input messages in OpenAI response format.
+             * Level of detail for image processing, can be "low", "high", or "auto"
              */
-            interface OpenAIResponseInputMessageContentText {
+            detail: 'low' | 'high' | 'auto';
+            /**
+             * Content type identifier, always "input_image"
+             */
+            type: 'input_image';
+            /**
+             * (Optional) URL of the image content
+             */
+            image_url?: string;
+        }
+        interface UnionMember2 {
+            annotations: Array<UnionMember2.OpenAIResponseAnnotationFileCitation | UnionMember2.OpenAIResponseAnnotationCitation | UnionMember2.OpenAIResponseAnnotationContainerFileCitation | UnionMember2.OpenAIResponseAnnotationFilePath>;
+            text: string;
+            type: 'output_text';
+        }
+        namespace UnionMember2 {
+            /**
+             * File citation annotation for referencing specific files in response content.
+             */
+            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.
              */
-            interface OpenAIResponseInputMessageContentImage {
+            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;
-            }
-            interface UnionMember2 {
-                annotations: Array<UnionMember2.OpenAIResponseAnnotationFileCitation | UnionMember2.OpenAIResponseAnnotationCitation | UnionMember2.OpenAIResponseAnnotationContainerFileCitation | UnionMember2.OpenAIResponseAnnotationFilePath>;
-                text: string;
-                type: 'output_text';
-            }
-            namespace UnionMember2 {
+                title: string;
                 /**
-                 * File citation annotation for referencing specific files in response content.
+                 * Annotation type identifier, always "url_citation"
                  */
-                interface OpenAIResponseAnnotationFileCitation {
-                    /**
-                     * Unique identifier of the referenced file
-                     */
-                    file_id: string;
-                    /**
-                     * Name of the referenced file
-                     */
-                    filename: string;
-                    /**
-                     * Position index of the citation within the content
-                     */
-                    index: number;
-                    /**
-                     * Annotation type identifier, always "file_citation"
-                     */
-                    type: 'file_citation';
-                }
+                type: 'url_citation';
                 /**
-                 * URL citation annotation for referencing external web resources.
+                 * URL of the referenced web resource
                  */
-                interface OpenAIResponseAnnotationCitation {
-                    /**
-                     * End position of the citation span in the content
-                     */
-                    end_index: number;
-                    /**
-                     * Start position of the citation span in the content
-                     */
-                    start_index: number;
-                    /**
-                     * Title of the referenced web resource
-                     */
-                    title: string;
-                    /**
-                     * Annotation type identifier, always "url_citation"
-                     */
-                    type: 'url_citation';
-                    /**
-                     * URL of the referenced web resource
-                     */
-                    url: string;
-                }
-                interface OpenAIResponseAnnotationContainerFileCitation {
-                    container_id: string;
-                    end_index: number;
-                    file_id: string;
-                    filename: string;
-                    start_index: number;
-                    type: 'container_file_citation';
-                }
-                interface OpenAIResponseAnnotationFilePath {
-                    file_id: string;
-                    index: number;
-                    type: 'file_path';
-                }
+                url: string;
+            }
+            interface OpenAIResponseAnnotationContainerFileCitation {
+                container_id: string;
+                end_index: number;
+                file_id: string;
+                filename: string;
+                start_index: number;
+                type: 'container_file_citation';
+            }
+            interface OpenAIResponseAnnotationFilePath {
+                file_id: string;
+                index: number;
+                type: 'file_path';
             }
         }
+    }
+    /**
+     * Web search tool call output message for OpenAI responses.
+     */
+    interface OpenAIResponseOutputMessageWebSearchToolCall {
         /**
-         * Web search tool call output message for OpenAI responses.
+         * Unique identifier for this tool call
          */
-        interface OpenAIResponseOutputMessageWebSearchToolCall {
-            /**
-             * Unique identifier for this tool call
-             */
-            id: string;
-            /**
-             * Current status of the web search operation
-             */
-            status: string;
-            /**
-             * Tool call type identifier, always "web_search_call"
-             */
-            type: 'web_search_call';
-        }
+        id: string;
         /**
-         * File search tool call output message for OpenAI responses.
+         * Current status of the web search operation
          */
-        interface OpenAIResponseOutputMessageFileSearchToolCall {
-            /**
-             * Unique identifier for this tool call
-             */
-            id: string;
-            /**
-             * List of search queries executed
-             */
-            queries: Array<string>;
-            /**
-             * Current status of the file search operation
-             */
-            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;
-            }>;
-        }
+        status: string;
+        /**
+         * Tool call type identifier, always "web_search_call"
+         */
+        type: 'web_search_call';
+    }
+    /**
+     * File search tool call output message for OpenAI responses.
+     */
+    interface OpenAIResponseOutputMessageFileSearchToolCall {
+        /**
+         * Unique identifier for this tool call
+         */
+        id: string;
+        /**
+         * List of search queries executed
+         */
+        queries: Array<string>;
+        /**
+         * Current status of the file search operation
+         */
+        status: string;
+        /**
+         * Tool call type identifier, always "file_search_call"
+         */
+        type: 'file_search_call';
         /**
-         * Function tool call output message for OpenAI responses.
+         * (Optional) Search results returned by the file search operation
          */
-        interface OpenAIResponseOutputMessageFunctionToolCall {
-            /**
-             * JSON string containing the function arguments
-             */
-            arguments: string;
+        results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+    }
+    namespace OpenAIResponseOutputMessageFileSearchToolCall {
+        /**
+         * Search results returned by the file search operation.
+         */
+        interface Result {
             /**
-             * Unique identifier for the function call
+             * (Optional) Key-value attributes associated with the file
              */
-            call_id: string;
+            attributes: {
+                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+            };
             /**
-             * Name of the function being called
+             * Unique identifier of the file containing the result
              */
-            name: string;
+            file_id: string;
             /**
-             * Tool call type identifier, always "function_call"
+             * Name of the file containing the result
              */
-            type: 'function_call';
+            filename: string;
             /**
-             * (Optional) Additional identifier for the tool call
+             * Relevance score for this search result (between 0 and 1)
              */
-            id?: string;
+            score: number;
             /**
-             * (Optional) Current status of the function call execution
+             * Text content of the search result
              */
-            status?: string;
+            text: string;
         }
+    }
+    /**
+     * Function tool call output message for OpenAI responses.
+     */
+    interface OpenAIResponseOutputMessageFunctionToolCall {
         /**
-         * Model Context Protocol (MCP) call output message for OpenAI responses.
+         * JSON string containing the function arguments
          */
-        interface OpenAIResponseOutputMessageMcpCall {
-            /**
-             * Unique identifier for this MCP call
-             */
-            id: string;
+        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.
+     */
+    interface OpenAIResponseOutputMessageMcpCall {
+        /**
+         * Unique identifier for this MCP call
+         */
+        id: string;
+        /**
+         * JSON string containing the MCP call arguments
+         */
+        arguments: string;
+        /**
+         * Name of the MCP method being called
+         */
+        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
+         */
+        output?: string;
+    }
+    /**
+     * MCP list tools output message containing available tools from an MCP server.
+     */
+    interface OpenAIResponseOutputMessageMcpListTools {
+        /**
+         * Unique identifier for this MCP list tools operation
+         */
+        id: string;
+        /**
+         * Label identifying the MCP server providing the tools
+         */
+        server_label: string;
+        /**
+         * List of available tools provided by the MCP server
+         */
+        tools: Array<OpenAIResponseOutputMessageMcpListTools.Tool>;
+        /**
+         * Tool call type identifier, always "mcp_list_tools"
+         */
+        type: 'mcp_list_tools';
+    }
+    namespace OpenAIResponseOutputMessageMcpListTools {
+        /**
+         * Tool definition returned by MCP list tools operation.
+         */
+        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
+     */
+    interface Text {
         /**
-         * MCP list tools output message containing available tools from an MCP server.
+         * (Optional) Text format configuration specifying output format requirements
          */
-        interface OpenAIResponseOutputMessageMcpListTools {
+        format?: Text.Format;
+    }
+    namespace Text {
+        /**
+         * (Optional) Text format configuration specifying output format requirements
+         */
+        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';
-        }
-        namespace OpenAIResponseOutputMessageMcpListTools {
+            schema?: {
+                [key: string]: boolean | number | string | Array<unknown> | unknown | null;
+            };
             /**
-             * 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.
              */
-            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
+     */
+    interface Error {
         /**
-         * Text formatting configuration for the response
+         * Error code identifying the type of failure
          */
-        interface Text {
-            /**
-             * (Optional) Text format configuration specifying output format requirements
-             */
-            format?: Text.Format;
-        }
-        namespace Text {
-            /**
-             * (Optional) Text format configuration specifying output format requirements
-             */
-            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
          */
-        interface Error {
-            /**
-             * Error code identifying the type of failure
-             */
-            code: string;
-            /**
-             * Human-readable error message describing the failure
-             */
-            message: string;
-        }
+        message: string;
     }
 }
 export type ResponseCreateParams = ResponseCreateParamsNonStreaming | ResponseCreateParamsStreaming;
@@ -1907,6 +2018,10 @@ export interface ResponseCreateParamsBase {
      * The underlying LLM used for completions.
      */
     model: string;
+    /**
+     * (Optional) Additional fields to include in the response.
+     */
+    include?: Array<string>;
     instructions?: string;
     max_infer_iters?: number;
     /**
@@ -1965,9 +2080,36 @@ export declare 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>;
+    }
+    namespace OpenAIResponseOutputMessageFileSearchToolCall {
+        /**
+         * Search results returned by the file search operation.
+         */
+        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.
@@ -2305,15 +2447,7 @@ export interface ResponseCreateParamsNonStreaming extends ResponseCreateParamsBa
 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.
      */
@@ -2324,7 +2458,7 @@ export interface ResponseListParams {
     order?: 'asc' | 'desc';
 }
 export declare namespace Responses {
-    export { type ResponseObject as ResponseObject, type ResponseObjectStream as ResponseObjectStream, type ResponseListResponse as ResponseListResponse, type ResponseCreateParams as ResponseCreateParams, type ResponseCreateParamsNonStreaming as ResponseCreateParamsNonStreaming, type ResponseCreateParamsStreaming as ResponseCreateParamsStreaming, type ResponseListParams as ResponseListParams, };
+    export { 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, type ResponseListParams as ResponseListParams, };
     export { InputItems as InputItems, type InputItemListResponse as InputItemListResponse, type InputItemListParams as InputItemListParams, };
 }
 //# sourceMappingURL=responses.d.ts.map