fix(api): align SDK response types with expanded item schemas

stainless-app[bot] · stainless-app[bot] · commit 491cd5290c36 · 2026-03-25T20:32:53.000Z
Fixes a variety of missing Items on Responses.
OutputItem: add function_call_output, computer_tool_call_output, local_shell_call_output, mcp_approval_response, custom_tool_call_output

ItemResource: add reasoning,  compaction, custom_tool_call, custom_tool_call_output
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 151
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-13599f99dceef322e19171dcc63d90f638d225a445999442249e1ed7a4924c43.yml
-openapi_spec_hash: aac8cf8ec3c7dc6d14ecf5dbb289ee7c
-config_hash: 96fbf82cf74a44ccd513f5acf0956ffd
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-00994178cc8e20d71754b00c54b0e4f5b4128e1c1cce765e9b7d696bd8c80d33.yml
+openapi_spec_hash: 81f404053b663f987209b4fb2d08a230
+config_hash: 5635033cdc8c930255f8b529a78de722
diff --git a/src/resources/conversations/items.ts b/src/resources/conversations/items.ts
@@ -91,6 +91,7 @@ export type ConversationItem =
   | ResponsesAPI.ResponseToolSearchCall
   | ResponsesAPI.ResponseToolSearchOutputItem
   | ResponsesAPI.ResponseReasoningItem
+  | ResponsesAPI.ResponseCompactionItem
   | ResponsesAPI.ResponseCodeInterpreterToolCall
   | ConversationItem.LocalShellCall
   | ConversationItem.LocalShellCallOutput
diff --git a/src/resources/responses/api.md b/src/resources/responses/api.md
@@ -51,7 +51,9 @@ Types:
 - <code><a href="./src/resources/responses/responses.ts">ResponseCustomToolCall</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseCustomToolCallInputDeltaEvent</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseCustomToolCallInputDoneEvent</a></code>
+- <code><a href="./src/resources/responses/responses.ts">ResponseCustomToolCallItem</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseCustomToolCallOutput</a></code>
+- <code><a href="./src/resources/responses/responses.ts">ResponseCustomToolCallOutputItem</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseError</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseErrorEvent</a></code>
 - <code><a href="./src/resources/responses/responses.ts">ResponseFailedEvent</a></code>
diff --git a/src/resources/responses/responses.ts b/src/resources/responses/responses.ts
@@ -39,23 +39,28 @@ export type ParsedResponseOutputItem<ParsedT> =
   | ParsedResponseOutputMessage<ParsedT>
   | ParsedResponseFunctionToolCall
   | ResponseFileSearchToolCall
+  | ResponseFunctionToolCallOutputItem
   | ResponseFunctionWebSearch
   | ResponseComputerToolCall
+  | ResponseComputerToolCallOutputItem
   | ResponseToolSearchCall
   | ResponseToolSearchOutputItem
   | ResponseReasoningItem
   | ResponseCompactionItem
   | ResponseOutputItem.ImageGenerationCall
   | ResponseCodeInterpreterToolCall
   | ResponseOutputItem.LocalShellCall
+  | ResponseOutputItem.LocalShellCallOutput
   | ResponseFunctionShellToolCall
   | ResponseFunctionShellToolCallOutput
   | ResponseApplyPatchToolCall
   | ResponseApplyPatchToolCallOutput
   | ResponseOutputItem.McpCall
   | ResponseOutputItem.McpListTools
   | ResponseOutputItem.McpApprovalRequest
-  | ResponseCustomToolCall;
+  | ResponseOutputItem.McpApprovalResponse
+  | ResponseCustomToolCall
+  | ResponseCustomToolCallOutputItem;
 
 export interface ParsedResponse<ParsedT> extends Response {
   output: Array<ParsedResponseOutputItem<ParsedT>>;
@@ -2009,6 +2014,12 @@ export interface ResponseComputerToolCallOutputItem {
    */
   output: ResponseComputerToolCallOutputScreenshot;
 
+  /**
+   * The status of the message input. One of `in_progress`, `completed`, or
+   * `incomplete`. Populated when input items are returned via API.
+   */
+  status: 'completed' | 'incomplete' | 'failed' | 'in_progress';
+
   /**
    * The type of the computer tool call output. Always `computer_call_output`.
    */
@@ -2021,10 +2032,9 @@ export interface ResponseComputerToolCallOutputItem {
   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.
+   * The identifier of the actor that created the item.
    */
-  status?: 'in_progress' | 'completed' | 'incomplete';
+  created_by?: string;
 }
 
 export namespace ResponseComputerToolCallOutputItem {
@@ -2339,6 +2349,27 @@ export interface ResponseCustomToolCallInputDoneEvent {
   type: 'response.custom_tool_call_input.done';
 }
 
+/**
+ * A call to a custom tool created by the model.
+ */
+export interface ResponseCustomToolCallItem extends ResponseCustomToolCall {
+  /**
+   * The unique ID of the custom tool call item.
+   */
+  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';
+
+  /**
+   * The identifier of the actor that created the item.
+   */
+  created_by?: string;
+}
+
 /**
  * The output of a custom tool call from your code, being sent back to the model.
  */
@@ -2365,6 +2396,27 @@ export interface ResponseCustomToolCallOutput {
   id?: string;
 }
 
+/**
+ * The output of a custom tool call from your code, being sent back to the model.
+ */
+export interface ResponseCustomToolCallOutputItem extends ResponseCustomToolCallOutput {
+  /**
+   * The unique ID of the custom tool call output item.
+   */
+  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';
+
+  /**
+   * The identifier of the actor that created the item.
+   */
+  created_by?: string;
+}
+
 /**
  * An error object returned when the model fails to generate a Response.
  */
@@ -2982,6 +3034,17 @@ export interface ResponseFunctionToolCallItem extends ResponseFunctionToolCall {
    * 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';
+
+  /**
+   * The identifier of the actor that created the item.
+   */
+  created_by?: string;
 }
 
 export interface ResponseFunctionToolCallOutputItem {
@@ -3001,16 +3064,21 @@ export interface ResponseFunctionToolCallOutputItem {
    */
   output: string | Array<ResponseInputText | ResponseInputImage | ResponseInputFile>;
 
+  /**
+   * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+   * Populated when items are returned via API.
+   */
+  status: 'in_progress' | 'completed' | 'incomplete';
+
   /**
    * 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.
+   * The identifier of the actor that created the item.
    */
-  status?: 'in_progress' | 'completed' | 'incomplete';
+  created_by?: string;
 }
 
 /**
@@ -4254,6 +4322,8 @@ export type ResponseItem =
   | ResponseFunctionToolCallOutputItem
   | ResponseToolSearchCall
   | ResponseToolSearchOutputItem
+  | ResponseReasoningItem
+  | ResponseCompactionItem
   | ResponseItem.ImageGenerationCall
   | ResponseCodeInterpreterToolCall
   | ResponseItem.LocalShellCall
@@ -4265,7 +4335,9 @@ export type ResponseItem =
   | ResponseItem.McpListTools
   | ResponseItem.McpApprovalRequest
   | ResponseItem.McpApprovalResponse
-  | ResponseItem.McpCall;
+  | ResponseItem.McpCall
+  | ResponseCustomToolCallItem
+  | ResponseCustomToolCallOutputItem;
 
 export namespace ResponseItem {
   /**
@@ -4806,23 +4878,28 @@ export type ResponseOutputItem =
   | ResponseOutputMessage
   | ResponseFileSearchToolCall
   | ResponseFunctionToolCall
+  | ResponseFunctionToolCallOutputItem
   | ResponseFunctionWebSearch
   | ResponseComputerToolCall
+  | ResponseComputerToolCallOutputItem
   | ResponseReasoningItem
   | ResponseToolSearchCall
   | ResponseToolSearchOutputItem
   | ResponseCompactionItem
   | ResponseOutputItem.ImageGenerationCall
   | ResponseCodeInterpreterToolCall
   | ResponseOutputItem.LocalShellCall
+  | ResponseOutputItem.LocalShellCallOutput
   | ResponseFunctionShellToolCall
   | ResponseFunctionShellToolCallOutput
   | ResponseApplyPatchToolCall
   | ResponseApplyPatchToolCallOutput
   | ResponseOutputItem.McpCall
   | ResponseOutputItem.McpListTools
   | ResponseOutputItem.McpApprovalRequest
-  | ResponseCustomToolCall;
+  | ResponseOutputItem.McpApprovalResponse
+  | ResponseCustomToolCall
+  | ResponseCustomToolCallOutputItem;
 
 export namespace ResponseOutputItem {
   /**
@@ -4917,6 +4994,31 @@ export namespace ResponseOutputItem {
     }
   }
 
+  /**
+   * The output of a local shell tool call.
+   */
+  export interface LocalShellCallOutput {
+    /**
+     * The unique ID of the local shell tool call generated by the model.
+     */
+    id: string;
+
+    /**
+     * A JSON string of the output of the local shell tool call.
+     */
+    output: string;
+
+    /**
+     * The type of the local shell tool call output. Always `local_shell_call_output`.
+     */
+    type: 'local_shell_call_output';
+
+    /**
+     * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
+     */
+    status?: 'in_progress' | 'completed' | 'incomplete' | null;
+  }
+
   /**
    * An invocation of a tool on an MCP server.
    */
@@ -5056,6 +5158,36 @@ export namespace ResponseOutputItem {
      */
     type: 'mcp_approval_request';
   }
+
+  /**
+   * A response to an MCP approval request.
+   */
+  export interface McpApprovalResponse {
+    /**
+     * The unique ID of the approval response
+     */
+    id: string;
+
+    /**
+     * The ID of the approval request being answered.
+     */
+    approval_request_id: string;
+
+    /**
+     * Whether the request was approved.
+     */
+    approve: boolean;
+
+    /**
+     * The type of the item. Always `mcp_approval_response`.
+     */
+    type: 'mcp_approval_response';
+
+    /**
+     * Optional reason for the decision.
+     */
+    reason?: string | null;
+  }
 }
 
 /**
@@ -7889,7 +8021,9 @@ export declare namespace Responses {
     type ResponseCustomToolCall as ResponseCustomToolCall,
     type ResponseCustomToolCallInputDeltaEvent as ResponseCustomToolCallInputDeltaEvent,
     type ResponseCustomToolCallInputDoneEvent as ResponseCustomToolCallInputDoneEvent,
+    type ResponseCustomToolCallItem as ResponseCustomToolCallItem,
     type ResponseCustomToolCallOutput as ResponseCustomToolCallOutput,
+    type ResponseCustomToolCallOutputItem as ResponseCustomToolCallOutputItem,
     type ResponseError as ResponseError,
     type ResponseErrorEvent as ResponseErrorEvent,
     type ResponseFailedEvent as ResponseFailedEvent,
diff --git a/tests/responsesItems.test.ts b/tests/responsesItems.test.ts
@@ -1,6 +1,12 @@
 import OpenAI from 'openai/index';
 const openai = new OpenAI({ apiKey: 'example-api-key' });
 
+function isInputCompatibleOutputItem(
+  item: OpenAI.Responses.ResponseOutputItem,
+): item is Exclude<OpenAI.Responses.ResponseOutputItem, OpenAI.Responses.ResponseComputerToolCallOutputItem> {
+  return item.type !== 'computer_call_output';
+}
+
 describe('responses item types', () => {
   test('response output items are compatible with input items', async () => {
     expect(true).toBe(true);
@@ -15,7 +21,7 @@ const unused = async () => {
   await openai.responses.create({
     model: 'gpt-5.1',
     // check type compatibility
-    input: response.output,
+    input: response.output.filter(isInputCompatibleOutputItem),
   });
   expect(true).toBe(true);
 };
