openai 4.87.3 → 4.87.4

package/src/resources/responses/index.ts

@@ -1,9 +1,4 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-export {
-  ResponseItemListDataPage,
-  InputItems,
-  type ResponseItemList,
-  type InputItemListParams,
-} from './input-items';
+export { InputItems, type ResponseItemList, type InputItemListParams } from './input-items';
 export { Responses } from './responses';

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

@@ -4,7 +4,8 @@ import { APIResource } from '../../resource';
 import { isRequestOptions } from '../../core';
 import * as Core from '../../core';
 import * as ResponsesAPI from './responses';
-import { CursorPage, type CursorPageParams } from '../../pagination';
+import { ResponseItemsPage } from './responses';
+import { type CursorPageParams } from '../../pagination';
 
 export class InputItems extends APIResource {
   /**
@@ -14,67 +15,26 @@ export class InputItems extends APIResource {
     responseId: string,
     query?: InputItemListParams,
     options?: Core.RequestOptions,
-  ): Core.PagePromise<
-    ResponseItemListDataPage,
-    | ResponseItemList.Message
-    | ResponsesAPI.ResponseOutputMessage
-    | ResponsesAPI.ResponseFileSearchToolCall
-    | ResponsesAPI.ResponseComputerToolCall
-    | ResponseItemList.ComputerCallOutput
-    | ResponsesAPI.ResponseFunctionWebSearch
-    | ResponsesAPI.ResponseFunctionToolCall
-    | ResponseItemList.FunctionCallOutput
-  >;
+  ): Core.PagePromise<ResponseItemsPage, ResponsesAPI.ResponseItem>;
   list(
     responseId: string,
     options?: Core.RequestOptions,
-  ): Core.PagePromise<
-    ResponseItemListDataPage,
-    | ResponseItemList.Message
-    | ResponsesAPI.ResponseOutputMessage
-    | ResponsesAPI.ResponseFileSearchToolCall
-    | ResponsesAPI.ResponseComputerToolCall
-    | ResponseItemList.ComputerCallOutput
-    | ResponsesAPI.ResponseFunctionWebSearch
-    | ResponsesAPI.ResponseFunctionToolCall
-    | ResponseItemList.FunctionCallOutput
-  >;
+  ): Core.PagePromise<ResponseItemsPage, ResponsesAPI.ResponseItem>;
   list(
     responseId: string,
     query: InputItemListParams | Core.RequestOptions = {},
     options?: Core.RequestOptions,
-  ): Core.PagePromise<
-    ResponseItemListDataPage,
-    | ResponseItemList.Message
-    | ResponsesAPI.ResponseOutputMessage
-    | ResponsesAPI.ResponseFileSearchToolCall
-    | ResponsesAPI.ResponseComputerToolCall
-    | ResponseItemList.ComputerCallOutput
-    | ResponsesAPI.ResponseFunctionWebSearch
-    | ResponsesAPI.ResponseFunctionToolCall
-    | ResponseItemList.FunctionCallOutput
-  > {
+  ): Core.PagePromise<ResponseItemsPage, ResponsesAPI.ResponseItem> {
     if (isRequestOptions(query)) {
       return this.list(responseId, {}, query);
     }
-    return this._client.getAPIList(`/responses/${responseId}/input_items`, ResponseItemListDataPage, {
+    return this._client.getAPIList(`/responses/${responseId}/input_items`, ResponseItemsPage, {
       query,
       ...options,
     });
   }
 }
 
-export class ResponseItemListDataPage extends CursorPage<
-  | ResponseItemList.Message
-  | ResponsesAPI.ResponseOutputMessage
-  | ResponsesAPI.ResponseFileSearchToolCall
-  | ResponsesAPI.ResponseComputerToolCall
-  | ResponseItemList.ComputerCallOutput
-  | ResponsesAPI.ResponseFunctionWebSearch
-  | ResponsesAPI.ResponseFunctionToolCall
-  | ResponseItemList.FunctionCallOutput
-> {}
-
 /**
  * A list of Response items.
  */
@@ -82,16 +42,7 @@ export interface ResponseItemList {
   /**
    * A list of items used to generate this response.
    */
-  data: Array<
-    | ResponseItemList.Message
-    | ResponsesAPI.ResponseOutputMessage
-    | ResponsesAPI.ResponseFileSearchToolCall
-    | ResponsesAPI.ResponseComputerToolCall
-    | ResponseItemList.ComputerCallOutput
-    | ResponsesAPI.ResponseFunctionWebSearch
-    | ResponsesAPI.ResponseFunctionToolCall
-    | ResponseItemList.FunctionCallOutput
-  >;
+  data: Array<ResponsesAPI.ResponseItem>;
 
   /**
    * The ID of the first item in the list.
@@ -114,142 +65,6 @@ export interface ResponseItemList {
   object: 'list';
 }
 
-export namespace ResponseItemList {
-  export interface Message {
-    /**
-     * The unique ID of the message input.
-     */
-    id: string;
-
-    /**
-     * A list of one or many input items to the model, containing different content
-     * types.
-     */
-    content: ResponsesAPI.ResponseInputMessageContentList;
-
-    /**
-     * The role of the message input. One of `user`, `system`, or `developer`.
-     */
-    role: 'user' | 'system' | 'developer';
-
-    /**
-     * The status of item. One of `in_progress`, `completed`, or `incomplete`.
-     * Populated when items are returned via API.
-     */
-    status?: 'in_progress' | 'completed' | 'incomplete';
-
-    /**
-     * The type of the message input. Always set to `message`.
-     */
-    type?: 'message';
-  }
-
-  export interface ComputerCallOutput {
-    /**
-     * The unique ID of the computer call tool output.
-     */
-    id: string;
-
-    /**
-     * The ID of the computer tool call that produced the output.
-     */
-    call_id: string;
-
-    /**
-     * A computer screenshot image used with the computer use tool.
-     */
-    output: ComputerCallOutput.Output;
-
-    /**
-     * The type of the computer tool call output. Always `computer_call_output`.
-     */
-    type: 'computer_call_output';
-
-    /**
-     * The safety checks reported by the API that have been acknowledged by the
-     * developer.
-     */
-    acknowledged_safety_checks?: Array<ComputerCallOutput.AcknowledgedSafetyCheck>;
-
-    /**
-     * The status of the message input. One of `in_progress`, `completed`, or
-     * `incomplete`. Populated when input items are returned via API.
-     */
-    status?: 'in_progress' | 'completed' | 'incomplete';
-  }
-
-  export namespace ComputerCallOutput {
-    /**
-     * A computer screenshot image used with the computer use tool.
-     */
-    export interface Output {
-      /**
-       * Specifies the event type. For a computer screenshot, this property is always set
-       * to `computer_screenshot`.
-       */
-      type: 'computer_screenshot';
-
-      /**
-       * The identifier of an uploaded file that contains the screenshot.
-       */
-      file_id?: string;
-
-      /**
-       * The URL of the screenshot image.
-       */
-      image_url?: string;
-    }
-
-    /**
-     * A pending safety check for the computer call.
-     */
-    export interface AcknowledgedSafetyCheck {
-      /**
-       * The ID of the pending safety check.
-       */
-      id: string;
-
-      /**
-       * The type of the pending safety check.
-       */
-      code: string;
-
-      /**
-       * Details about the pending safety check.
-       */
-      message: string;
-    }
-  }
-
-  export interface FunctionCallOutput {
-    /**
-     * The unique ID of the function call tool output.
-     */
-    id: string;
-
-    /**
-     * The unique ID of the function tool call generated by the model.
-     */
-    call_id: string;
-
-    /**
-     * A JSON string of the output of the function tool call.
-     */
-    output: string;
-
-    /**
-     * The type of the function tool call output. Always `function_call_output`.
-     */
-    type: 'function_call_output';
-
-    /**
-     * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
-     * Populated when items are returned via API.
-     */
-    status?: 'in_progress' | 'completed' | 'incomplete';
-  }
-}
-
 export interface InputItemListParams extends CursorPageParams {
   /**
    * An item ID to list items before, used in pagination.
@@ -265,12 +80,8 @@ export interface InputItemListParams extends CursorPageParams {
   order?: 'asc' | 'desc';
 }
 
-InputItems.ResponseItemListDataPage = ResponseItemListDataPage;
-
 export declare namespace InputItems {
-  export {
-    type ResponseItemList as ResponseItemList,
-    ResponseItemListDataPage as ResponseItemListDataPage,
-    type InputItemListParams as InputItemListParams,
-  };
+  export { type ResponseItemList as ResponseItemList, type InputItemListParams as InputItemListParams };
 }
+
+export { ResponseItemsPage };

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

@@ -0,0 +1,114 @@
+// 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 * as ResponsesAPI from './responses';
+import { ResponseItemsPage } from './responses';
+import { type CursorPageParams } from '../../pagination';
+
+export class InputItems extends APIResource {
+  /**
+   * Returns a list of input items for a given response.
+   */
+  list(
+    responseId: string,
+    query?: InputItemListParams,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ResponseItemsPage, ResponsesAPI.ResponseItem>;
+  list(
+    responseId: string,
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ResponseItemsPage, ResponsesAPI.ResponseItem>;
+  list(
+    responseId: string,
+    query: InputItemListParams | Core.RequestOptions = {},
+    options?: Core.RequestOptions,
+  ): Core.PagePromise<ResponseItemsPage, ResponsesAPI.ResponseItem> {
+    if (isRequestOptions(query)) {
+      return this.list(responseId, {}, query);
+    }
+    return this._client.getAPIList(`/responses/${responseId}/input_items`, ResponseItemsPage, {
+      query,
+      ...options,
+    });
+  }
+}
+
+<<<<<<< HEAD
+export class ResponseItemListDataPage extends CursorPage<
+  // @ts-ignore some items don't necessarily have the `id` property
+  | ResponseItemList.Message
+  | ResponsesAPI.ResponseOutputMessage
+  | ResponsesAPI.ResponseFileSearchToolCall
+  | ResponsesAPI.ResponseComputerToolCall
+  | ResponseItemList.ComputerCallOutput
+  | ResponsesAPI.ResponseFunctionWebSearch
+  | ResponsesAPI.ResponseFunctionToolCall
+  | ResponseItemList.FunctionCallOutput
+> {}
+
+||||||| parent of e5ea4a71 (fix(types): improve responses type names (#1392))
+export class ResponseItemListDataPage extends CursorPage<
+  | ResponseItemList.Message
+  | ResponsesAPI.ResponseOutputMessage
+  | ResponsesAPI.ResponseFileSearchToolCall
+  | ResponsesAPI.ResponseComputerToolCall
+  | ResponseItemList.ComputerCallOutput
+  | ResponsesAPI.ResponseFunctionWebSearch
+  | ResponsesAPI.ResponseFunctionToolCall
+  | ResponseItemList.FunctionCallOutput
+> {}
+
+=======
+>>>>>>> e5ea4a71 (fix(types): improve responses type names (#1392))
+/**
+ * A list of Response items.
+ */
+export interface ResponseItemList {
+  /**
+   * A list of items used to generate this response.
+   */
+  data: Array<ResponsesAPI.ResponseItem>;
+
+  /**
+   * The ID of the first item in the list.
+   */
+  first_id: string;
+
+  /**
+   * Whether there are more items available.
+   */
+  has_more: boolean;
+
+  /**
+   * The ID of the last item in the list.
+   */
+  last_id: string;
+
+  /**
+   * The type of object returned, must be `list`.
+   */
+  object: 'list';
+}
+
+export interface InputItemListParams extends CursorPageParams {
+  /**
+   * An item ID to list items before, used in pagination.
+   */
+  before?: string;
+
+  /**
+   * The order to return the input items in. Default is `asc`.
+   *
+   * - `asc`: Return the input items in ascending order.
+   * - `desc`: Return the input items in descending order.
+   */
+  order?: 'asc' | 'desc';
+}
+
+export declare namespace InputItems {
+  export { type ResponseItemList as ResponseItemList, type InputItemListParams as InputItemListParams };
+}
+
+export { ResponseItemsPage };

package/src/resources/responses/responses.ts

@@ -9,12 +9,13 @@ import {
 import * as Core from '../../core';
 import { APIPromise, isRequestOptions } from '../../core';
 import { APIResource } from '../../resource';
-import { Stream } from '../../streaming';
 import * as Shared from '../shared';
 import * as InputItemsAPI from './input-items';
-import { InputItemListParams, InputItems, ResponseItemList, ResponseItemListDataPage } from './input-items';
+import { InputItemListParams, InputItems, ResponseItemList } from './input-items';
 import * as ResponsesAPI from './responses';
 import { ResponseStream, ResponseStreamParams } from '../../lib/responses/ResponseStream';
+import { CursorPage } from '../../pagination';
+import { Stream } from '../../streaming';
 
 export interface ParsedResponseOutputText<ParsedT> extends ResponseOutputText {
   parsed: ParsedT | null;
@@ -137,6 +138,8 @@ export class Responses extends APIResource {
   }
 }
 
+export class ResponseItemsPage extends CursorPage<ResponseItem> {}
+
 /**
  * A tool that controls a virtual computer. Learn more about the
  * [computer tool](https://platform.openai.com/docs/guides/tools-computer-use).
@@ -966,6 +969,83 @@ export namespace ResponseComputerToolCall {
   }
 }
 
+export interface ResponseComputerToolCallOutputItem {
+  /**
+   * The unique ID of the computer call tool output.
+   */
+  id: string;
+
+  /**
+   * The ID of the computer tool call that produced the output.
+   */
+  call_id: string;
+
+  /**
+   * A computer screenshot image used with the computer use tool.
+   */
+  output: ResponseComputerToolCallOutputScreenshot;
+
+  /**
+   * The type of the computer tool call output. Always `computer_call_output`.
+   */
+  type: 'computer_call_output';
+
+  /**
+   * The safety checks reported by the API that have been acknowledged by the
+   * developer.
+   */
+  acknowledged_safety_checks?: Array<ResponseComputerToolCallOutputItem.AcknowledgedSafetyCheck>;
+
+  /**
+   * The status of the message input. One of `in_progress`, `completed`, or
+   * `incomplete`. Populated when input items are returned via API.
+   */
+  status?: 'in_progress' | 'completed' | 'incomplete';
+}
+
+export namespace ResponseComputerToolCallOutputItem {
+  /**
+   * A pending safety check for the computer call.
+   */
+  export interface AcknowledgedSafetyCheck {
+    /**
+     * The ID of the pending safety check.
+     */
+    id: string;
+
+    /**
+     * The type of the pending safety check.
+     */
+    code: string;
+
+    /**
+     * Details about the pending safety check.
+     */
+    message: string;
+  }
+}
+
+/**
+ * A computer screenshot image used with the computer use tool.
+ */
+export interface ResponseComputerToolCallOutputScreenshot {
+  /**
+   * Specifies the event type. For a computer screenshot, this property is always set
+   * to `computer_screenshot`.
+   */
+  type: 'computer_screenshot';
+
+  /**
+   * The identifier of an uploaded file that contains the screenshot.
+   */
+  file_id?: string;
+
+  /**
+   * The URL of the screenshot image.
+   */
+  image_url?: string;
+}
+
 /**
  * Multi-modal input and output contents.
  */
@@ -1362,11 +1442,6 @@ export interface ResponseFunctionCallArgumentsDoneEvent {
  * for more information.
  */
 export interface ResponseFunctionToolCall {
-  /**
-   * The unique ID of the function tool call.
-   */
-  id: string;
-
   /**
    * A JSON string of the arguments to pass to the function.
    */
@@ -1387,6 +1462,51 @@ export interface ResponseFunctionToolCall {
    */
   type: 'function_call';
 
+  /**
+   * The unique ID of the function tool call.
+   */
+  id?: string;
+
+  /**
+   * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+   * Populated when items are returned via API.
+   */
+  status?: 'in_progress' | 'completed' | 'incomplete';
+}
+
+/**
+ * A tool call to run a function. See the
+ * [function calling guide](https://platform.openai.com/docs/guides/function-calling)
+ * for more information.
+ */
+export interface ResponseFunctionToolCallItem extends ResponseFunctionToolCall {
+  /**
+   * The unique ID of the function call tool output.
+   */
+  id: string;
+}
+
+export interface ResponseFunctionToolCallOutputItem {
+  /**
+   * The unique ID of the function call tool output.
+   */
+  id: string;
+
+  /**
+   * The unique ID of the function tool call generated by the model.
+   */
+  call_id: string;
+
+  /**
+   * A JSON string of the output of the function tool call.
+   */
+  output: string;
+
+  /**
+   * The type of the function tool call output. Always `function_call_output`.
+   */
+  type: 'function_call_output';
+
   /**
    * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
    * Populated when items are returned via API.
@@ -1607,7 +1727,7 @@ export namespace ResponseInputItem {
     /**
      * A computer screenshot image used with the computer use tool.
      */
-    output: ComputerCallOutput.Output;
+    output: ResponsesAPI.ResponseComputerToolCallOutputScreenshot;
 
     /**
      * The type of the computer tool call output. Always `computer_call_output`.
@@ -1633,27 +1753,6 @@ export namespace ResponseInputItem {
   }
 
   export namespace ComputerCallOutput {
-    /**
-     * A computer screenshot image used with the computer use tool.
-     */
-    export interface Output {
-      /**
-       * Specifies the event type. For a computer screenshot, this property is always set
-       * to `computer_screenshot`.
-       */
-      type: 'computer_screenshot';
-
-      /**
-       * The identifier of an uploaded file that contains the screenshot.
-       */
-      file_id?: string;
-
-      /**
-       * The URL of the screenshot image.
-       */
-      image_url?: string;
-    }
-
     /**
      * A pending safety check for the computer call.
      */
@@ -1729,6 +1828,35 @@ export namespace ResponseInputItem {
  */
 export type ResponseInputMessageContentList = Array<ResponseInputContent>;
 
+export interface ResponseInputMessageItem {
+  /**
+   * The unique ID of the message input.
+   */
+  id: string;
+
+  /**
+   * A list of one or many input items to the model, containing different content
+   * types.
+   */
+  content: ResponseInputMessageContentList;
+
+  /**
+   * The role of the message input. One of `user`, `system`, or `developer`.
+   */
+  role: 'user' | 'system' | 'developer';
+
+  /**
+   * The status of item. One of `in_progress`, `completed`, or `incomplete`.
+   * Populated when items are returned via API.
+   */
+  status?: 'in_progress' | 'completed' | 'incomplete';
+
+  /**
+   * The type of the message input. Always set to `message`.
+   */
+  type?: 'message';
+}
+
 /**
  * A text input to the model.
  */
@@ -1744,6 +1872,19 @@ export interface ResponseInputText {
   type: 'input_text';
 }
 
+/**
+ * Content item used to generate a response.
+ */
+export type ResponseItem =
+  | ResponseInputMessageItem
+  | ResponseOutputMessage
+  | ResponseFileSearchToolCall
+  | ResponseComputerToolCall
+  | ResponseComputerToolCallOutputItem
+  | ResponseFunctionWebSearch
+  | ResponseFunctionToolCallItem
+  | ResponseFunctionToolCallOutputItem;
+
 /**
  * An audio output from the model.
  */
@@ -2305,6 +2446,11 @@ export interface ResponseUsage {
    */
   input_tokens: number;
 
+  /**
+   * A detailed breakdown of the input tokens.
+   */
+  input_tokens_details: ResponseUsage.InputTokensDetails;
+
   /**
    * The number of output tokens.
    */
@@ -2322,6 +2468,17 @@ export interface ResponseUsage {
 }
 
 export namespace ResponseUsage {
+  /**
+   * A detailed breakdown of the input tokens.
+   */
+  export interface InputTokensDetails {
+    /**
+     * The number of tokens that were retrieved from the cache.
+     * [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
+     */
+    cached_tokens: number;
+  }
+
   /**
    * A detailed breakdown of the output tokens.
    */
@@ -2706,13 +2863,11 @@ export interface ResponseRetrieveParams {
 }
 
 Responses.InputItems = InputItems;
-Responses.ResponseItemListDataPage = ResponseItemListDataPage;
 
 export declare namespace Responses {
   export {
     InputItems as InputItems,
     type ResponseItemList as ResponseItemList,
-    ResponseItemListDataPage as ResponseItemListDataPage,
     type InputItemListParams as InputItemListParams,
   };
 }

package/src/resources/shared.ts

@@ -171,10 +171,10 @@ export interface Reasoning {
    * supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
    * result in faster responses and fewer tokens used on reasoning in a response.
    */
-  effort: ReasoningEffort | null;
+  effort?: ReasoningEffort | null;
 
   /**
-   * **o-series models only**
+   * **computer_use_preview only**
    *
    * A summary of the reasoning performed by the model. This can be useful for
    * debugging and understanding the model's reasoning process. One of `concise` or

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '4.87.3'; // x-release-please-version
+export const VERSION = '4.87.4'; // x-release-please-version

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "4.87.3";
+export declare const VERSION = "4.87.4";
 //# sourceMappingURL=version.d.ts.map