llama-stack-client 0.3.4-rc3 → 0.4.0-rc1

package/src/resources/conversations/items.ts

@@ -0,0 +1,1221 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+// All rights reserved.
+//
+// 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';
+import { isRequestOptions } from '../../core';
+import * as Core from '../../core';
+import { OpenAICursorPage, type OpenAICursorPageParams } from '../../pagination';
+
+export class Items extends APIResource {
+  /**
+   * Create items.
+   *
+   * Create items in the conversation.
+   */
+  create(
+    conversationId: string,
+    body: ItemCreateParams,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ItemCreateResponse> {
+    return this._client.post(`/v1/conversations/${conversationId}/items`, { body, ...options });
+  }
+
+  /**
+   * List items.
+   *
+   * List items in the conversation.
+   */
+  list(
+    conversationId: string,
+    query?: ItemListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ItemListResponsesOpenAICursorPage, ItemListResponse>;
+  list(
+    conversationId: string,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ItemListResponsesOpenAICursorPage, ItemListResponse>;
+  list(
+    conversationId: string,
+    query: ItemListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ItemListResponsesOpenAICursorPage, ItemListResponse> {
+    if (isRequestOptions(query)) {
+      return this.list(conversationId, {}, query);
+    }
+    return this._client.getAPIList(
+      `/v1/conversations/${conversationId}/items`,
+      ItemListResponsesOpenAICursorPage,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Delete an item.
+   *
+   * Delete a conversation item.
+   */
+  delete(
+    conversationId: string,
+    itemId: string,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ItemDeleteResponse> {
+    return this._client.delete(`/v1/conversations/${conversationId}/items/${itemId}`, options);
+  }
+
+  /**
+   * Retrieve an item.
+   *
+   * Retrieve a conversation item.
+   */
+  get(
+    conversationId: string,
+    itemId: string,
+    options?: Core.RequestOptions,
+  ): Core.APIPromise<ItemGetResponse> {
+    return this._client.get(`/v1/conversations/${conversationId}/items/${itemId}`, options);
+  }
+}
+
+export class ItemListResponsesOpenAICursorPage extends OpenAICursorPage<ItemListResponse> {}
+
+/**
+ * List of conversation items with pagination.
+ */
+export interface ItemCreateResponse {
+  /**
+   * List of conversation items
+   */
+  data: Array<
+    | ItemCreateResponse.OpenAIResponseMessageOutput
+    | ItemCreateResponse.OpenAIResponseOutputMessageWebSearchToolCall
+    | ItemCreateResponse.OpenAIResponseOutputMessageFileSearchToolCall
+    | ItemCreateResponse.OpenAIResponseOutputMessageFunctionToolCall
+    | ItemCreateResponse.OpenAIResponseInputFunctionToolCallOutput
+    | ItemCreateResponse.OpenAIResponseMcpApprovalRequest
+    | ItemCreateResponse.OpenAIResponseMcpApprovalResponse
+    | ItemCreateResponse.OpenAIResponseOutputMessageMcpCall
+    | ItemCreateResponse.OpenAIResponseOutputMessageMcpListTools
+  >;
+
+  /**
+   * The ID of the first item in the list
+   */
+  first_id?: string | null;
+
+  /**
+   * Whether there are more items available
+   */
+  has_more?: boolean;
+
+  /**
+   * The ID of the last item in the list
+   */
+  last_id?: string | null;
+
+  /**
+   * Object type
+   */
+  object?: string;
+}
+
+export namespace ItemCreateResponse {
+  /**
+   * 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 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 {
+    /**
+     * Text content for input messages in OpenAI response format.
+     */
+    export interface OpenAIResponseInputMessageContentText {
+      text: string;
+
+      type?: 'input_text';
+    }
+
+    /**
+     * Image content for input messages in OpenAI response format.
+     */
+    export interface OpenAIResponseInputMessageContentImage {
+      detail?: 'low' | 'high' | 'auto';
+
+      file_id?: string | null;
+
+      image_url?: string | null;
+
+      type?: 'input_image';
+    }
+
+    /**
+     * 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;
+
+      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 {
+    id: string;
+
+    queries: Array<string>;
+
+    status: string;
+
+    results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+
+    type?: 'file_search_call';
+  }
+
+  export namespace OpenAIResponseOutputMessageFileSearchToolCall {
+    /**
+     * Search results returned by the file search operation.
+     */
+    export interface Result {
+      attributes: { [key: string]: unknown };
+
+      file_id: string;
+
+      filename: string;
+
+      score: number;
+
+      text: string;
+    }
+  }
+
+  /**
+   * Function tool call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageFunctionToolCall {
+    arguments: string;
+
+    call_id: string;
+
+    name: string;
+
+    id?: string | null;
+
+    status?: string | null;
+
+    type?: 'function_call';
+  }
+
+  /**
+   * This represents the output of a function call that gets passed back to the
+   * model.
+   */
+  export interface OpenAIResponseInputFunctionToolCallOutput {
+    call_id: string;
+
+    output: string;
+
+    id?: string | null;
+
+    status?: string | null;
+
+    type?: 'function_call_output';
+  }
+
+  /**
+   * 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';
+  }
+
+  /**
+   * A response to an MCP approval request.
+   */
+  export interface OpenAIResponseMcpApprovalResponse {
+    approval_request_id: string;
+
+    approve: boolean;
+
+    id?: string | null;
+
+    reason?: string | null;
+
+    type?: 'mcp_approval_response';
+  }
+
+  /**
+   * 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 {
+    /**
+     * Tool definition returned by MCP list tools operation.
+     */
+    export interface Tool {
+      input_schema: { [key: string]: unknown };
+
+      name: string;
+
+      description?: string | null;
+    }
+  }
+}
+
+/**
+ * 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 type ItemListResponse =
+  | ItemListResponse.OpenAIResponseMessageOutput
+  | ItemListResponse.OpenAIResponseOutputMessageWebSearchToolCall
+  | ItemListResponse.OpenAIResponseOutputMessageFileSearchToolCall
+  | ItemListResponse.OpenAIResponseOutputMessageFunctionToolCall
+  | ItemListResponse.OpenAIResponseInputFunctionToolCallOutput
+  | ItemListResponse.OpenAIResponseMcpApprovalRequest
+  | ItemListResponse.OpenAIResponseMcpApprovalResponse
+  | ItemListResponse.OpenAIResponseOutputMessageMcpCall
+  | ItemListResponse.OpenAIResponseOutputMessageMcpListTools;
+
+export namespace ItemListResponse {
+  /**
+   * 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 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 {
+    /**
+     * Text content for input messages in OpenAI response format.
+     */
+    export interface OpenAIResponseInputMessageContentText {
+      text: string;
+
+      type?: 'input_text';
+    }
+
+    /**
+     * Image content for input messages in OpenAI response format.
+     */
+    export interface OpenAIResponseInputMessageContentImage {
+      detail?: 'low' | 'high' | 'auto';
+
+      file_id?: string | null;
+
+      image_url?: string | null;
+
+      type?: 'input_image';
+    }
+
+    /**
+     * 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;
+
+      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 {
+    id: string;
+
+    queries: Array<string>;
+
+    status: string;
+
+    results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+
+    type?: 'file_search_call';
+  }
+
+  export namespace OpenAIResponseOutputMessageFileSearchToolCall {
+    /**
+     * Search results returned by the file search operation.
+     */
+    export interface Result {
+      attributes: { [key: string]: unknown };
+
+      file_id: string;
+
+      filename: string;
+
+      score: number;
+
+      text: string;
+    }
+  }
+
+  /**
+   * Function tool call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageFunctionToolCall {
+    arguments: string;
+
+    call_id: string;
+
+    name: string;
+
+    id?: string | null;
+
+    status?: string | null;
+
+    type?: 'function_call';
+  }
+
+  /**
+   * This represents the output of a function call that gets passed back to the
+   * model.
+   */
+  export interface OpenAIResponseInputFunctionToolCallOutput {
+    call_id: string;
+
+    output: string;
+
+    id?: string | null;
+
+    status?: string | null;
+
+    type?: 'function_call_output';
+  }
+
+  /**
+   * 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';
+  }
+
+  /**
+   * A response to an MCP approval request.
+   */
+  export interface OpenAIResponseMcpApprovalResponse {
+    approval_request_id: string;
+
+    approve: boolean;
+
+    id?: string | null;
+
+    reason?: string | null;
+
+    type?: 'mcp_approval_response';
+  }
+
+  /**
+   * 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 {
+    /**
+     * Tool definition returned by MCP list tools operation.
+     */
+    export interface Tool {
+      input_schema: { [key: string]: unknown };
+
+      name: string;
+
+      description?: string | null;
+    }
+  }
+}
+
+/**
+ * Response for deleted conversation item.
+ */
+export interface ItemDeleteResponse {
+  /**
+   * The deleted item identifier
+   */
+  id: string;
+
+  /**
+   * Whether the object was deleted
+   */
+  deleted?: boolean;
+
+  /**
+   * Object type
+   */
+  object?: 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 ItemGetResponse {
+  content:
+    | string
+    | Array<
+        | ItemGetResponse.OpenAIResponseInputMessageContentText
+        | ItemGetResponse.OpenAIResponseInputMessageContentImage
+        | ItemGetResponse.OpenAIResponseInputMessageContentFile
+      >
+    | Array<
+        | ItemGetResponse.OpenAIResponseOutputMessageContentOutputText
+        | ItemGetResponse.OpenAIResponseContentPartRefusal
+      >;
+
+  role: 'system' | 'developer' | 'user' | 'assistant';
+
+  id?: string | null;
+
+  status?: string | null;
+
+  type?: 'message';
+}
+
+export namespace ItemGetResponse {
+  /**
+   * Text content for input messages in OpenAI response format.
+   */
+  export interface OpenAIResponseInputMessageContentText {
+    text: string;
+
+    type?: 'input_text';
+  }
+
+  /**
+   * Image content for input messages in OpenAI response format.
+   */
+  export interface OpenAIResponseInputMessageContentImage {
+    detail?: 'low' | 'high' | 'auto';
+
+    file_id?: string | null;
+
+    image_url?: string | null;
+
+    type?: 'input_image';
+  }
+
+  /**
+   * 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;
+
+    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';
+  }
+}
+
+export interface ItemCreateParams {
+  items: Array<
+    | ItemCreateParams.OpenAIResponseMessageInput
+    | ItemCreateParams.OpenAIResponseOutputMessageWebSearchToolCall
+    | ItemCreateParams.OpenAIResponseOutputMessageFileSearchToolCall
+    | ItemCreateParams.OpenAIResponseOutputMessageFunctionToolCall
+    | ItemCreateParams.OpenAIResponseInputFunctionToolCallOutput
+    | ItemCreateParams.OpenAIResponseMcpApprovalRequest
+    | ItemCreateParams.OpenAIResponseMcpApprovalResponse
+    | ItemCreateParams.OpenAIResponseOutputMessageMcpCall
+    | ItemCreateParams.OpenAIResponseOutputMessageMcpListTools
+  >;
+}
+
+export namespace ItemCreateParams {
+  /**
+   * 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 OpenAIResponseMessageInput {
+    content:
+      | string
+      | Array<
+          | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentText
+          | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentImage
+          | OpenAIResponseMessageInput.OpenAIResponseInputMessageContentFile
+        >
+      | Array<
+          | OpenAIResponseMessageInput.OpenAIResponseOutputMessageContentOutputText
+          | OpenAIResponseMessageInput.OpenAIResponseContentPartRefusal
+        >;
+
+    role: 'system' | 'developer' | 'user' | 'assistant';
+
+    id?: string | null;
+
+    status?: string | null;
+
+    type?: 'message';
+  }
+
+  export namespace OpenAIResponseMessageInput {
+    /**
+     * Text content for input messages in OpenAI response format.
+     */
+    export interface OpenAIResponseInputMessageContentText {
+      text: string;
+
+      type?: 'input_text';
+    }
+
+    /**
+     * Image content for input messages in OpenAI response format.
+     */
+    export interface OpenAIResponseInputMessageContentImage {
+      detail?: 'low' | 'high' | 'auto';
+
+      file_id?: string | null;
+
+      image_url?: string | null;
+
+      type?: 'input_image';
+    }
+
+    /**
+     * 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;
+
+      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 {
+    id: string;
+
+    queries: Array<string>;
+
+    status: string;
+
+    results?: Array<OpenAIResponseOutputMessageFileSearchToolCall.Result> | null;
+
+    type?: 'file_search_call';
+  }
+
+  export namespace OpenAIResponseOutputMessageFileSearchToolCall {
+    /**
+     * Search results returned by the file search operation.
+     */
+    export interface Result {
+      attributes: { [key: string]: unknown };
+
+      file_id: string;
+
+      filename: string;
+
+      score: number;
+
+      text: string;
+    }
+  }
+
+  /**
+   * Function tool call output message for OpenAI responses.
+   */
+  export interface OpenAIResponseOutputMessageFunctionToolCall {
+    arguments: string;
+
+    call_id: string;
+
+    name: string;
+
+    id?: string | null;
+
+    status?: string | null;
+
+    type?: 'function_call';
+  }
+
+  /**
+   * This represents the output of a function call that gets passed back to the
+   * model.
+   */
+  export interface OpenAIResponseInputFunctionToolCallOutput {
+    call_id: string;
+
+    output: string;
+
+    id?: string | null;
+
+    status?: string | null;
+
+    type?: 'function_call_output';
+  }
+
+  /**
+   * 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';
+  }
+
+  /**
+   * A response to an MCP approval request.
+   */
+  export interface OpenAIResponseMcpApprovalResponse {
+    approval_request_id: string;
+
+    approve: boolean;
+
+    id?: string | null;
+
+    reason?: string | null;
+
+    type?: 'mcp_approval_response';
+  }
+
+  /**
+   * 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 {
+    /**
+     * Tool definition returned by MCP list tools operation.
+     */
+    export interface Tool {
+      input_schema: { [key: string]: unknown };
+
+      name: string;
+
+      description?: string | null;
+    }
+  }
+}
+
+export interface ItemListParams extends OpenAICursorPageParams {
+  include?: Array<
+    | 'web_search_call.action.sources'
+    | 'code_interpreter_call.outputs'
+    | 'computer_call_output.output.image_url'
+    | 'file_search_call.results'
+    | 'message.input_image.image_url'
+    | 'message.output_text.logprobs'
+    | 'reasoning.encrypted_content'
+  > | null;
+
+  order?: 'asc' | 'desc' | null;
+}
+
+Items.ItemListResponsesOpenAICursorPage = ItemListResponsesOpenAICursorPage;
+
+export declare namespace Items {
+  export {
+    type ItemCreateResponse as ItemCreateResponse,
+    type ItemListResponse as ItemListResponse,
+    type ItemDeleteResponse as ItemDeleteResponse,
+    type ItemGetResponse as ItemGetResponse,
+    ItemListResponsesOpenAICursorPage as ItemListResponsesOpenAICursorPage,
+    type ItemCreateParams as ItemCreateParams,
+    type ItemListParams as ItemListParams,
+  };
+}