llama-stack-client 0.3.4 → 0.4.0-rc1

package/src/resources/responses/input-items.ts

@@ -3,7 +3,7 @@
 //
 // This source code is licensed under the terms described in the LICENSE file in
 // the root directory of this source tree.
-
+//
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../resource';
@@ -12,7 +12,7 @@ import * as Core from '../../core';
 
 export class InputItems extends APIResource {
   /**
-   * List input items for a given OpenAI response.
+   * List input items.
    */
   list(
     responseId: string,
@@ -28,7 +28,7 @@ export class InputItems extends APIResource {
     if (isRequestOptions(query)) {
       return this.list(responseId, {}, query);
     }
-    return this._client.get(`/v1/openai/v1/responses/${responseId}/input_items`, { query, ...options });
+    return this._client.get(`/v1/responses/${responseId}/input_items`, { query, ...options });
   }
 }
 
@@ -36,72 +36,187 @@ export class InputItems extends APIResource {
  * List container for OpenAI response input items.
  */
 export interface InputItemListResponse {
-  /**
-   * List of input items
-   */
   data: Array<
+    | InputItemListResponse.OpenAIResponseMessageOutput
     | InputItemListResponse.OpenAIResponseOutputMessageWebSearchToolCall
     | InputItemListResponse.OpenAIResponseOutputMessageFileSearchToolCall
     | InputItemListResponse.OpenAIResponseOutputMessageFunctionToolCall
+    | InputItemListResponse.OpenAIResponseOutputMessageMcpCall
+    | InputItemListResponse.OpenAIResponseOutputMessageMcpListTools
+    | InputItemListResponse.OpenAIResponseMcpApprovalRequest
     | InputItemListResponse.OpenAIResponseInputFunctionToolCallOutput
-    | InputItemListResponse.OpenAIResponseMessage
+    | InputItemListResponse.OpenAIResponseMcpApprovalResponse
+    | InputItemListResponse.OpenAIResponseMessageOutput
   >;
 
-  /**
-   * Object type identifier, always "list"
-   */
-  object: 'list';
+  object?: 'list';
 }
 
 export namespace InputItemListResponse {
   /**
-   * Web search tool call output message for OpenAI responses.
+   * 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 OpenAIResponseOutputMessageWebSearchToolCall {
+  export interface OpenAIResponseMessageOutput {
+    content:
+      | string
+      | Array<
+          | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentText
+          | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentImage
+          | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentFile
+        >
+      | Array<
+          | OpenAIResponseMessageOutput.OpenAIResponseOutputMessageContentOutputText
+          | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal
+        >;
+
+    role: 'system' | 'developer' | 'user' | 'assistant';
+
+    id?: string | null;
+
+    status?: string | null;
+
+    type?: 'message';
+  }
+
+  export namespace OpenAIResponseMessageOutput {
     /**
-     * Unique identifier for this tool call
+     * Text content for input messages in OpenAI response format.
      */
-    id: string;
+    export interface OpenAIResponseInputMessageContentText {
+      text: string;
+
+      type?: 'input_text';
+    }
 
     /**
-     * Current status of the web search operation
+     * Image content for input messages in OpenAI response format.
      */
-    status: string;
+    export interface OpenAIResponseInputMessageContentImage {
+      detail?: 'low' | 'high' | 'auto';
+
+      file_id?: string | null;
+
+      image_url?: string | null;
+
+      type?: 'input_image';
+    }
 
     /**
-     * Tool call type identifier, always "web_search_call"
+     * File content for input messages in OpenAI response format.
      */
-    type: 'web_search_call';
+    export interface OpenAIResponseInputMessageContentFile {
+      file_data?: string | null;
+
+      file_id?: string | null;
+
+      file_url?: string | null;
+
+      filename?: string | null;
+
+      type?: 'input_file';
+    }
+
+    export interface OpenAIResponseOutputMessageContentOutputText {
+      text: string;
+
+      annotations?: Array<
+        | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation
+        | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation
+        | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation
+        | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath
+      >;
+
+      type?: 'output_text';
+    }
+
+    export namespace OpenAIResponseOutputMessageContentOutputText {
+      /**
+       * File citation annotation for referencing specific files in response content.
+       */
+      export interface OpenAIResponseAnnotationFileCitation {
+        file_id: string;
+
+        filename: string;
+
+        index: number;
+
+        type?: 'file_citation';
+      }
+
+      /**
+       * URL citation annotation for referencing external web resources.
+       */
+      export interface OpenAIResponseAnnotationCitation {
+        end_index: number;
+
+        start_index: number;
+
+        title: string;
+
+        url: string;
+
+        type?: 'url_citation';
+      }
+
+      export interface OpenAIResponseAnnotationContainerFileCitation {
+        container_id: string;
+
+        end_index: number;
+
+        file_id: string;
+
+        filename: string;
+
+        start_index: number;
+
+        type?: 'container_file_citation';
+      }
+
+      export interface OpenAIResponseAnnotationFilePath {
+        file_id: string;
+
+        index: number;
+
+        type?: 'file_path';
+      }
+    }
+
+    /**
+     * Refusal content within a streamed response part.
+     */
+    export interface OpenAIResponseContentPartRefusal {
+      refusal: string;
+
+      type?: 'refusal';
+    }
+  }
+
+  /**
+   * Web search tool call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageWebSearchToolCall {
+    id: string;
+
+    status: string;
+
+    type?: 'web_search_call';
   }
 
   /**
    * File search tool call output message for OpenAI responses.
    */
   export 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';
+    results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
 
-    /**
-     * (Optional) Search results returned by the file search operation
-     */
-    results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result>;
+    type?: 'file_search_call';
   }
 
   export namespace OpenAIResponseOutputMessageFileSearchToolCall {
@@ -109,29 +224,14 @@ export namespace InputItemListResponse {
      * 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 };
+      attributes: { [key: string]: unknown };
 
-      /**
-       * 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;
     }
   }
@@ -140,35 +240,77 @@ export namespace InputItemListResponse {
    * 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';
+    id?: string | null;
 
-    /**
-     * (Optional) Additional identifier for the tool call
-     */
-    id?: string;
+    status?: string | null;
 
+    type?: 'function_call';
+  }
+
+  /**
+   * Model Context Protocol (MCP) call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageMcpCall {
+    id: string;
+
+    arguments: string;
+
+    name: string;
+
+    server_label: string;
+
+    error?: string | null;
+
+    output?: string | null;
+
+    type?: 'mcp_call';
+  }
+
+  /**
+   * MCP list tools output message containing available tools from an MCP server.
+   */
+  export interface OpenAIResponseOutputMessageMcpListTools {
+    id: string;
+
+    server_label: string;
+
+    tools: Array<OpenAIResponseOutputMessageMcpListTools.Tool>;
+
+    type?: 'mcp_list_tools';
+  }
+
+  export namespace OpenAIResponseOutputMessageMcpListTools {
     /**
-     * (Optional) Current status of the function call execution
+     * Tool definition returned by MCP list tools operation.
      */
-    status?: string;
+    export interface Tool {
+      input_schema: { [key: string]: unknown };
+
+      name: string;
+
+      description?: string | null;
+    }
+  }
+
+  /**
+   * A request for human approval of a tool invocation.
+   */
+  export interface OpenAIResponseMcpApprovalRequest {
+    id: string;
+
+    arguments: string;
+
+    name: string;
+
+    server_label: string;
+
+    type?: 'mcp_approval_request';
   }
 
   /**
@@ -180,11 +322,26 @@ export namespace InputItemListResponse {
 
     output: string;
 
-    type: 'function_call_output';
+    id?: string | null;
+
+    status?: string | null;
+
+    type?: 'function_call_output';
+  }
+
+  /**
+   * A response to an MCP approval request.
+   */
+  export interface OpenAIResponseMcpApprovalResponse {
+    approval_request_id: string;
+
+    approve: boolean;
+
+    id?: string | null;
 
-    id?: string;
+    reason?: string | null;
 
-    status?: string;
+    type?: 'mcp_approval_response';
   }
 
   /**
@@ -192,127 +349,106 @@ export namespace InputItemListResponse {
    * 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 {
+  export interface OpenAIResponseMessageOutput {
     content:
       | string
       | Array<
-          | OpenAIResponseMessage.OpenAIResponseInputMessageContentText
-          | OpenAIResponseMessage.OpenAIResponseInputMessageContentImage
+          | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentText
+          | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentImage
+          | OpenAIResponseMessageOutput.OpenAIResponseInputMessageContentFile
         >
-      | Array<OpenAIResponseMessage.UnionMember2>;
+      | Array<
+          | OpenAIResponseMessageOutput.OpenAIResponseOutputMessageContentOutputText
+          | OpenAIResponseMessageOutput.OpenAIResponseContentPartRefusal
+        >;
 
     role: 'system' | 'developer' | 'user' | 'assistant';
 
-    type: 'message';
+    id?: string | null;
 
-    id?: string;
+    status?: string | null;
 
-    status?: string;
+    type?: 'message';
   }
 
-  export namespace OpenAIResponseMessage {
+  export namespace OpenAIResponseMessageOutput {
     /**
      * Text content for input messages in OpenAI response format.
      */
     export interface OpenAIResponseInputMessageContentText {
-      /**
-       * The text content of the input message
-       */
       text: string;
 
-      /**
-       * Content type identifier, always "input_text"
-       */
-      type: 'input_text';
+      type?: 'input_text';
     }
 
     /**
      * 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';
+      detail?: 'low' | 'high' | 'auto';
 
-      /**
-       * Content type identifier, always "input_image"
-       */
-      type: 'input_image';
+      file_id?: string | null;
 
-      /**
-       * (Optional) URL of the image content
-       */
-      image_url?: string;
+      image_url?: string | null;
+
+      type?: 'input_image';
     }
 
-    export interface UnionMember2 {
-      annotations: Array<
-        | UnionMember2.OpenAIResponseAnnotationFileCitation
-        | UnionMember2.OpenAIResponseAnnotationCitation
-        | UnionMember2.OpenAIResponseAnnotationContainerFileCitation
-        | UnionMember2.OpenAIResponseAnnotationFilePath
-      >;
+    /**
+     * File content for input messages in OpenAI response format.
+     */
+    export interface OpenAIResponseInputMessageContentFile {
+      file_data?: string | null;
+
+      file_id?: string | null;
+
+      file_url?: string | null;
 
+      filename?: string | null;
+
+      type?: 'input_file';
+    }
+
+    export interface OpenAIResponseOutputMessageContentOutputText {
       text: string;
 
-      type: 'output_text';
+      annotations?: Array<
+        | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFileCitation
+        | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationCitation
+        | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationContainerFileCitation
+        | OpenAIResponseOutputMessageContentOutputText.OpenAIResponseAnnotationFilePath
+      >;
+
+      type?: 'output_text';
     }
 
-    export namespace UnionMember2 {
+    export namespace OpenAIResponseOutputMessageContentOutputText {
       /**
        * File citation annotation for referencing specific files in response content.
        */
       export 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?: 'file_citation';
       }
 
       /**
        * URL citation annotation for referencing external web resources.
        */
       export 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;
+
+        type?: 'url_citation';
       }
 
       export interface OpenAIResponseAnnotationContainerFileCitation {
@@ -326,7 +462,7 @@ export namespace InputItemListResponse {
 
         start_index: number;
 
-        type: 'container_file_citation';
+        type?: 'container_file_citation';
       }
 
       export interface OpenAIResponseAnnotationFilePath {
@@ -334,38 +470,34 @@ export namespace InputItemListResponse {
 
         index: number;
 
-        type: 'file_path';
+        type?: 'file_path';
       }
     }
+
+    /**
+     * Refusal content within a streamed response part.
+     */
+    export interface OpenAIResponseContentPartRefusal {
+      refusal: string;
+
+      type?: 'refusal';
+    }
   }
 }
 
 export interface InputItemListParams {
-  /**
-   * An item ID to list items after, used for pagination.
-   */
-  after?: string;
+  after?: string | null;
 
-  /**
-   * An item ID to list items before, used for pagination.
-   */
-  before?: string;
+  before?: string | null;
 
-  /**
-   * Additional fields to include in the response.
-   */
-  include?: Array<string>;
+  include?: Array<string> | null;
 
-  /**
-   * A limit on the number of objects to be returned. Limit can range between 1 and
-   * 100, and the default is 20.
-   */
-  limit?: number;
+  limit?: number | null;
 
   /**
-   * The order to return the input items in. Default is desc.
+   * Sort order for paginated responses.
    */
-  order?: 'asc' | 'desc';
+  order?: 'asc' | 'desc' | null;
 }
 
 export declare namespace InputItems {