openai 6.44.0 → 6.46.0

package/resources/responses/responses.d.mts

@@ -21,7 +21,7 @@ export interface ParsedResponseOutputMessage<ParsedT> extends ResponseOutputMess
 export interface ParsedResponseFunctionToolCall extends ResponseFunctionToolCall {
     parsed_arguments: any;
 }
-export type ParsedResponseOutputItem<ParsedT> = ParsedResponseOutputMessage<ParsedT> | ParsedResponseFunctionToolCall | ResponseFileSearchToolCall | ResponseFunctionToolCallOutputItem | ResponseFunctionWebSearch | ResponseComputerToolCall | ResponseComputerToolCallOutputItem | ResponseToolSearchCall | ResponseToolSearchOutputItem | ResponseOutputItem.AdditionalTools | ResponseReasoningItem | ResponseCompactionItem | ResponseOutputItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseOutputItem.LocalShellCall | ResponseOutputItem.LocalShellCallOutput | ResponseFunctionShellToolCall | ResponseFunctionShellToolCallOutput | ResponseApplyPatchToolCall | ResponseApplyPatchToolCallOutput | ResponseOutputItem.McpCall | ResponseOutputItem.McpListTools | ResponseOutputItem.McpApprovalRequest | ResponseOutputItem.McpApprovalResponse | ResponseCustomToolCall | ResponseCustomToolCallOutputItem;
+export type ParsedResponseOutputItem<ParsedT> = ParsedResponseOutputMessage<ParsedT> | ParsedResponseFunctionToolCall | ResponseFileSearchToolCall | ResponseFunctionToolCallOutputItem | ResponseFunctionWebSearch | ResponseComputerToolCall | ResponseComputerToolCallOutputItem | ResponseOutputItem.Program | ResponseOutputItem.ProgramOutput | ResponseToolSearchCall | ResponseToolSearchOutputItem | ResponseOutputItem.AdditionalTools | ResponseReasoningItem | ResponseCompactionItem | ResponseOutputItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseOutputItem.LocalShellCall | ResponseOutputItem.LocalShellCallOutput | ResponseFunctionShellToolCall | ResponseFunctionShellToolCallOutput | ResponseApplyPatchToolCall | ResponseApplyPatchToolCallOutput | ResponseOutputItem.McpCall | ResponseOutputItem.McpListTools | ResponseOutputItem.McpApprovalRequest | ResponseOutputItem.McpApprovalResponse | ResponseCustomToolCall | ResponseCustomToolCallOutputItem;
 export interface ParsedResponse<ParsedT> extends Response {
     output: Array<ParsedResponseOutputItem<ParsedT>>;
     output_parsed: ParsedT | null;
@@ -104,7 +104,7 @@ export declare class Responses extends APIResource {
      * @example
      * ```ts
      * const compactedResponse = await client.responses.compact({
-     *   model: 'gpt-5.4',
+     *   model: 'gpt-5.6-sol',
      * });
      * ```
      */
@@ -119,6 +119,10 @@ export interface ApplyPatchTool {
      * The type of the tool. Always `apply_patch`.
      */
     type: 'apply_patch';
+    /**
+     * The tool invocation context(s).
+     */
+    allowed_callers?: Array<'direct' | 'programmatic'> | null;
 }
 export interface CompactedResponse {
     /**
@@ -456,6 +460,10 @@ export interface CustomTool {
      * The type of the custom tool. Always `custom`.
      */
     type: 'custom';
+    /**
+     * The tool invocation context(s).
+     */
+    allowed_callers?: Array<'direct' | 'programmatic'> | null;
     /**
      * Whether this tool should be deferred and discovered via tool search.
      */
@@ -573,6 +581,10 @@ export interface FunctionShellTool {
      * The type of the shell tool. Always `shell`.
      */
     type: 'shell';
+    /**
+     * The tool invocation context(s).
+     */
+    allowed_callers?: Array<'direct' | 'programmatic'> | null;
     environment?: ContainerAuto | LocalEnvironment | ContainerReference | null;
 }
 /**
@@ -592,13 +604,17 @@ export interface FunctionTool {
         [key: string]: unknown;
     } | null;
     /**
-     * Whether to enforce strict parameter validation. Default `true`.
+     * Whether strict parameter validation is enforced for this function tool.
      */
     strict: boolean | null;
     /**
      * The type of the function tool. Always `function`.
      */
     type: 'function';
+    /**
+     * The tool invocation context(s).
+     */
+    allowed_callers?: Array<'direct' | 'programmatic'> | null;
     /**
      * Whether this function is deferred and loaded via tool search.
      */
@@ -608,6 +624,13 @@ export interface FunctionTool {
      * call the function.
      */
     description?: string | null;
+    /**
+     * A JSON schema object describing the JSON value encoded in string outputs for
+     * this function.
+     */
+    output_schema?: {
+        [key: string]: unknown;
+    } | null;
 }
 export interface InlineSkill {
     /**
@@ -693,12 +716,28 @@ export declare namespace NamespaceTool {
     interface Function {
         name: string;
         type: 'function';
+        /**
+         * The tool invocation context(s).
+         */
+        allowed_callers?: Array<'direct' | 'programmatic'> | null;
         /**
          * Whether this function should be deferred and discovered via tool search.
          */
         defer_loading?: boolean;
         description?: string | null;
+        /**
+         * A JSON Schema describing the JSON value encoded in string outputs for this
+         * function tool. This does not describe content-array outputs.
+         */
+        output_schema?: {
+            [key: string]: unknown;
+        } | null;
         parameters?: unknown | null;
+        /**
+         * Whether to enforce strict parameter validation. If omitted, Responses attempts
+         * to use strict validation when the schema is compatible, and falls back to
+         * non-strict validation otherwise.
+         */
         strict?: boolean | null;
     }
 }
@@ -775,7 +814,7 @@ export interface Response {
      * response. See the `tools` parameter to see how to specify which tools the model
      * can call.
      */
-    tool_choice: ToolChoiceOptions | ToolChoiceAllowed | ToolChoiceTypes | ToolChoiceFunction | ToolChoiceMcp | ToolChoiceCustom | ToolChoiceApplyPatch | ToolChoiceShell;
+    tool_choice: ToolChoiceOptions | ToolChoiceAllowed | ToolChoiceTypes | ToolChoiceFunction | ToolChoiceMcp | ToolChoiceCustom | Response.SpecificProgrammaticToolCallingParam | ToolChoiceApplyPatch | ToolChoiceShell;
     /**
      * An array of tools the model may call while generating a response. You can
      * specify which tool to use by setting the `tool_choice` parameter.
@@ -851,11 +890,21 @@ export interface Response {
      */
     prompt_cache_key?: string;
     /**
+     * The prompt-caching options that were applied to the response. Supported for
+     * `gpt-5.6` and later models.
+     */
+    prompt_cache_options?: Response.PromptCacheOptions;
+    /**
+     * @deprecated Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
      * The retention policy for the prompt cache. Set to `24h` to enable extended
      * prompt caching, which keeps cached prefixes active for longer, up to a maximum
      * of 24 hours.
      * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+     * This field expresses a maximum retention policy, while
+     * `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
+     * are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
+     * models, only `24h` is supported.
      *
      * For older models that support both `in_memory` and `24h`, the default depends on
      * your organization's data retention policy:
@@ -953,6 +1002,12 @@ export declare namespace Response {
          */
         reason?: 'max_output_tokens' | 'content_filter';
     }
+    interface SpecificProgrammaticToolCallingParam {
+        /**
+         * The tool to call. Always `programmatic_tool_calling`.
+         */
+        type: 'programmatic_tool_calling';
+    }
     /**
      * The conversation that this response belonged to. Input items and output items
      * from this response were automatically added to this conversation.
@@ -1087,6 +1142,20 @@ export declare namespace Response {
             type: 'error';
         }
     }
+    /**
+     * The prompt-caching options that were applied to the response. Supported for
+     * `gpt-5.6` and later models.
+     */
+    interface PromptCacheOptions {
+        /**
+         * Whether implicit prompt-cache breakpoints were enabled.
+         */
+        mode: 'implicit' | 'explicit';
+        /**
+         * The minimum lifetime applied to each cache breakpoint.
+         */
+        ttl: '30m';
+    }
 }
 /**
  * A tool call that applies file diffs by creating, deleting, or updating files.
@@ -1114,6 +1183,10 @@ export interface ResponseApplyPatchToolCall {
      * The type of the item. Always `apply_patch_call`.
      */
     type: 'apply_patch_call';
+    /**
+     * The execution context that produced this tool call.
+     */
+    caller?: ResponseApplyPatchToolCall.Direct | ResponseApplyPatchToolCall.Program | null;
     /**
      * The ID of the entity that created this tool call.
      */
@@ -1167,6 +1240,16 @@ export declare namespace ResponseApplyPatchToolCall {
          */
         type: 'update_file';
     }
+    interface Direct {
+        type: 'direct';
+    }
+    interface Program {
+        /**
+         * The call ID of the program item that produced this tool call.
+         */
+        caller_id: string;
+        type: 'program';
+    }
 }
 /**
  * The output emitted by an apply patch tool call.
@@ -1189,6 +1272,10 @@ export interface ResponseApplyPatchToolCallOutput {
      * The type of the item. Always `apply_patch_call_output`.
      */
     type: 'apply_patch_call_output';
+    /**
+     * The execution context that produced this tool call.
+     */
+    caller?: ResponseApplyPatchToolCallOutput.Direct | ResponseApplyPatchToolCallOutput.Program | null;
     /**
      * The ID of the entity that created this tool call output.
      */
@@ -1198,6 +1285,18 @@ export interface ResponseApplyPatchToolCallOutput {
      */
     output?: string | null;
 }
+export declare namespace ResponseApplyPatchToolCallOutput {
+    interface Direct {
+        type: 'direct';
+    }
+    interface Program {
+        /**
+         * The call ID of the program item that produced this tool call.
+         */
+        caller_id: string;
+        type: 'program';
+    }
+}
 /**
  * Emitted when there is a partial audio response.
  */
@@ -1973,11 +2072,27 @@ export interface ResponseCustomToolCall {
      * The unique ID of the custom tool call in the OpenAI platform.
      */
     id?: string;
+    /**
+     * The execution context that produced this tool call.
+     */
+    caller?: ResponseCustomToolCall.Direct | ResponseCustomToolCall.Program | null;
     /**
      * The namespace of the custom tool being called.
      */
     namespace?: string;
 }
+export declare namespace ResponseCustomToolCall {
+    interface Direct {
+        type: 'direct';
+    }
+    interface Program {
+        /**
+         * The call ID of the program item that produced this tool call.
+         */
+        caller_id: string;
+        type: 'program';
+    }
+}
 /**
  * Event representing a delta (partial update) to the input of a custom tool call.
  */
@@ -2067,6 +2182,28 @@ export interface ResponseCustomToolCallOutput {
      * The unique ID of the custom tool call output in the OpenAI platform.
      */
     id?: string;
+    /**
+     * The execution context that produced this tool call.
+     */
+    caller?: ResponseCustomToolCallOutput.Direct | ResponseCustomToolCallOutput.Program | null;
+}
+export declare namespace ResponseCustomToolCallOutput {
+    interface Direct {
+        /**
+         * The caller type. Always `direct`.
+         */
+        type: 'direct';
+    }
+    interface Program {
+        /**
+         * The call ID of the program item that produced this tool call.
+         */
+        caller_id: string;
+        /**
+         * The caller type. Always `program`.
+         */
+        type: 'program';
+    }
 }
 /**
  * The output of a custom tool call from your code, being sent back to the model.
@@ -2093,7 +2230,7 @@ export interface ResponseError {
     /**
      * The error code for the response.
      */
-    code: 'server_error' | 'rate_limit_exceeded' | 'invalid_prompt' | 'vector_store_timeout' | 'invalid_image' | 'invalid_image_format' | 'invalid_base64_image' | 'invalid_image_url' | 'image_too_large' | 'image_too_small' | 'image_parse_error' | 'image_content_policy_violation' | 'invalid_image_mode' | 'image_file_too_large' | 'unsupported_image_media_type' | 'empty_image_file' | 'failed_to_download_image' | 'image_file_not_found';
+    code: 'server_error' | 'rate_limit_exceeded' | 'invalid_prompt' | 'bio_policy' | 'vector_store_timeout' | 'invalid_image' | 'invalid_image_format' | 'invalid_base64_image' | 'invalid_image_url' | 'image_too_large' | 'image_too_small' | 'image_parse_error' | 'image_content_policy_violation' | 'invalid_image_mode' | 'image_file_too_large' | 'unsupported_image_media_type' | 'empty_image_file' | 'failed_to_download_image' | 'image_file_not_found';
     /**
      * A human-readable description of the error.
      */
@@ -2444,6 +2581,10 @@ export interface ResponseFunctionShellToolCall {
      * The type of the item. Always `shell_call`.
      */
     type: 'shell_call';
+    /**
+     * The execution context that produced this tool call.
+     */
+    caller?: ResponseFunctionShellToolCall.Direct | ResponseFunctionShellToolCall.Program | null;
     /**
      * The ID of the entity that created this tool call.
      */
@@ -2464,6 +2605,16 @@ export declare namespace ResponseFunctionShellToolCall {
          */
         timeout_ms: number | null;
     }
+    interface Direct {
+        type: 'direct';
+    }
+    interface Program {
+        /**
+         * The call ID of the program item that produced this tool call.
+         */
+        caller_id: string;
+        type: 'program';
+    }
 }
 /**
  * The output of a shell tool call that was emitted.
@@ -2496,6 +2647,10 @@ export interface ResponseFunctionShellToolCallOutput {
      * The type of the shell call output. Always `shell_call_output`.
      */
     type: 'shell_call_output';
+    /**
+     * The execution context that produced this tool call.
+     */
+    caller?: ResponseFunctionShellToolCallOutput.Direct | ResponseFunctionShellToolCallOutput.Program | null;
     /**
      * The identifier of the actor that created the item.
      */
@@ -2548,6 +2703,16 @@ export declare namespace ResponseFunctionShellToolCallOutput {
             type: 'exit';
         }
     }
+    interface Direct {
+        type: 'direct';
+    }
+    interface Program {
+        /**
+         * The call ID of the program item that produced this tool call.
+         */
+        caller_id: string;
+        type: 'program';
+    }
 }
 /**
  * A tool call to run a function. See the
@@ -2575,6 +2740,10 @@ export interface ResponseFunctionToolCall {
      * The unique ID of the function tool call.
      */
     id?: string;
+    /**
+     * The execution context that produced this tool call.
+     */
+    caller?: ResponseFunctionToolCall.Direct | ResponseFunctionToolCall.Program | null;
     /**
      * The namespace of the function to run.
      */
@@ -2585,6 +2754,18 @@ export interface ResponseFunctionToolCall {
      */
     status?: 'in_progress' | 'completed' | 'incomplete';
 }
+export declare namespace ResponseFunctionToolCall {
+    interface Direct {
+        type: 'direct';
+    }
+    interface Program {
+        /**
+         * The call ID of the program item that produced this tool call.
+         */
+        caller_id: string;
+        type: 'program';
+    }
+}
 /**
  * A tool call to run a function. See the
  * [function calling guide](https://platform.openai.com/docs/guides/function-calling)
@@ -2628,11 +2809,33 @@ export interface ResponseFunctionToolCallOutputItem {
      * The type of the function tool call output. Always `function_call_output`.
      */
     type: 'function_call_output';
+    /**
+     * The execution context that produced this tool call.
+     */
+    caller?: ResponseFunctionToolCallOutputItem.Direct | ResponseFunctionToolCallOutputItem.Program | null;
     /**
      * The identifier of the actor that created the item.
      */
     created_by?: string;
 }
+export declare namespace ResponseFunctionToolCallOutputItem {
+    interface Direct {
+        /**
+         * The caller type. Always `direct`.
+         */
+        type: 'direct';
+    }
+    interface Program {
+        /**
+         * The call ID of the program item that produced this tool call.
+         */
+        caller_id: string;
+        /**
+         * The caller type. Always `program`.
+         */
+        type: 'program';
+    }
+}
 /**
  * The results of a web search tool call. See the
  * [web search guide](https://platform.openai.com/docs/guides/tools-web-search) for
@@ -2920,11 +3123,13 @@ export interface ResponseInputFile {
      */
     type: 'input_file';
     /**
-     * The detail level of the file to be sent to the model. Use `low` for the default
-     * rendering behavior, or `high` to render the file at higher quality. Defaults to
-     * `low`.
+     * The detail level of the file to be sent to the model. Use `auto` to let the
+     * system select the detail level; for GPT-5.6 and later models, `auto` uses
+     * high-quality rendering, which may increase input token usage. Use `low` for
+     * lower-cost rendering, or `high` to render the file at higher quality. Defaults
+     * to `auto`.
      */
-    detail?: 'low' | 'high';
+    detail?: 'auto' | 'low' | 'high';
     /**
      * The content of the file to be sent to the model.
      */
@@ -2941,6 +3146,25 @@ export interface ResponseInputFile {
      * The name of the file to be sent to the model.
      */
     filename?: string;
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    prompt_cache_breakpoint?: ResponseInputFile.PromptCacheBreakpoint;
+}
+export declare namespace ResponseInputFile {
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    interface PromptCacheBreakpoint {
+        /**
+         * The breakpoint mode. Always `explicit`.
+         */
+        mode: 'explicit';
+    }
 }
 /**
  * A file input to the model.
@@ -2951,11 +3175,13 @@ export interface ResponseInputFileContent {
      */
     type: 'input_file';
     /**
-     * The detail level of the file to be sent to the model. Use `low` for the default
-     * rendering behavior, or `high` to render the file at higher quality. Defaults to
-     * `low`.
+     * The detail level of the file to be sent to the model. Use `auto` to let the
+     * system select the detail level; for GPT-5.6 and later models, `auto` uses
+     * high-quality rendering, which may increase input token usage. Use `low` for
+     * lower-cost rendering, or `high` to render the file at higher quality. Defaults
+     * to `auto`.
      */
-    detail?: 'low' | 'high';
+    detail?: 'auto' | 'low' | 'high';
     /**
      * The base64-encoded data of the file to be sent to the model.
      */
@@ -2972,6 +3198,25 @@ export interface ResponseInputFileContent {
      * The name of the file to be sent to the model.
      */
     filename?: string | null;
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    prompt_cache_breakpoint?: ResponseInputFileContent.PromptCacheBreakpoint | null;
+}
+export declare namespace ResponseInputFileContent {
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    interface PromptCacheBreakpoint {
+        /**
+         * The breakpoint mode. Always `explicit`.
+         */
+        mode: 'explicit';
+    }
 }
 /**
  * An image input to the model. Learn about
@@ -2996,6 +3241,25 @@ export interface ResponseInputImage {
      * encoded image in a data URL.
      */
     image_url?: string | null;
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    prompt_cache_breakpoint?: ResponseInputImage.PromptCacheBreakpoint;
+}
+export declare namespace ResponseInputImage {
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    interface PromptCacheBreakpoint {
+        /**
+         * The breakpoint mode. Always `explicit`.
+         */
+        mode: 'explicit';
+    }
 }
 /**
  * An image input to the model. Learn about
@@ -3020,6 +3284,25 @@ export interface ResponseInputImageContent {
      * encoded image in a data URL.
      */
     image_url?: string | null;
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    prompt_cache_breakpoint?: ResponseInputImageContent.PromptCacheBreakpoint | null;
+}
+export declare namespace ResponseInputImageContent {
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    interface PromptCacheBreakpoint {
+        /**
+         * The breakpoint mode. Always `explicit`.
+         */
+        mode: 'explicit';
+    }
 }
 /**
  * A message input to the model with a role indicating instruction following
@@ -3028,7 +3311,7 @@ export interface ResponseInputImageContent {
  * `assistant` role are presumed to have been generated by the model in previous
  * interactions.
  */
-export type ResponseInputItem = EasyInputMessage | ResponseInputItem.Message | ResponseOutputMessage | ResponseFileSearchToolCall | ResponseComputerToolCall | ResponseInputItem.ComputerCallOutput | ResponseFunctionWebSearch | ResponseFunctionToolCall | ResponseInputItem.FunctionCallOutput | ResponseInputItem.ToolSearchCall | ResponseToolSearchOutputItemParam | ResponseInputItem.AdditionalTools | ResponseReasoningItem | ResponseCompactionItemParam | ResponseInputItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseInputItem.LocalShellCall | ResponseInputItem.LocalShellCallOutput | ResponseInputItem.ShellCall | ResponseInputItem.ShellCallOutput | ResponseInputItem.ApplyPatchCall | ResponseInputItem.ApplyPatchCallOutput | ResponseInputItem.McpListTools | ResponseInputItem.McpApprovalRequest | ResponseInputItem.McpApprovalResponse | ResponseInputItem.McpCall | ResponseCustomToolCallOutput | ResponseCustomToolCall | ResponseInputItem.CompactionTrigger | ResponseInputItem.ItemReference;
+export type ResponseInputItem = EasyInputMessage | ResponseInputItem.Message | ResponseOutputMessage | ResponseFileSearchToolCall | ResponseComputerToolCall | ResponseInputItem.ComputerCallOutput | ResponseFunctionWebSearch | ResponseFunctionToolCall | ResponseInputItem.FunctionCallOutput | ResponseInputItem.ToolSearchCall | ResponseToolSearchOutputItemParam | ResponseInputItem.AdditionalTools | ResponseReasoningItem | ResponseCompactionItemParam | ResponseInputItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseInputItem.LocalShellCall | ResponseInputItem.LocalShellCallOutput | ResponseInputItem.ShellCall | ResponseInputItem.ShellCallOutput | ResponseInputItem.ApplyPatchCall | ResponseInputItem.ApplyPatchCallOutput | ResponseInputItem.McpListTools | ResponseInputItem.McpApprovalRequest | ResponseInputItem.McpApprovalResponse | ResponseInputItem.McpCall | ResponseCustomToolCallOutput | ResponseCustomToolCall | ResponseInputItem.CompactionTrigger | ResponseInputItem.ItemReference | ResponseInputItem.Program | ResponseInputItem.ProgramOutput;
 export declare namespace ResponseInputItem {
     /**
      * A message input to the model with a role indicating instruction following
@@ -3126,12 +3409,34 @@ export declare namespace ResponseInputItem {
          * returned via API.
          */
         id?: string | null;
+        /**
+         * The execution context that produced this tool call.
+         */
+        caller?: FunctionCallOutput.Direct | FunctionCallOutput.Program | null;
         /**
          * The status of the item. One of `in_progress`, `completed`, or `incomplete`.
          * Populated when items are returned via API.
          */
         status?: 'in_progress' | 'completed' | 'incomplete' | null;
     }
+    namespace FunctionCallOutput {
+        interface Direct {
+            /**
+             * The caller type. Always `direct`.
+             */
+            type: 'direct';
+        }
+        interface Program {
+            /**
+             * The call ID of the program item that produced this tool call.
+             */
+            caller_id: string;
+            /**
+             * The caller type. Always `program`.
+             */
+            type: 'program';
+        }
+    }
     interface ToolSearchCall {
         /**
          * The arguments supplied to the tool search call.
@@ -3297,6 +3602,10 @@ export declare namespace ResponseInputItem {
          * API.
          */
         id?: string | null;
+        /**
+         * The execution context that produced this tool call.
+         */
+        caller?: ShellCall.Direct | ShellCall.Program | null;
         /**
          * The environment to execute the shell commands in.
          */
@@ -3326,6 +3635,22 @@ export declare namespace ResponseInputItem {
              */
             timeout_ms?: number | null;
         }
+        interface Direct {
+            /**
+             * The caller type. Always `direct`.
+             */
+            type: 'direct';
+        }
+        interface Program {
+            /**
+             * The call ID of the program item that produced this tool call.
+             */
+            caller_id: string;
+            /**
+             * The caller type. Always `program`.
+             */
+            type: 'program';
+        }
     }
     /**
      * The streamed output items emitted by a shell tool call.
@@ -3349,6 +3674,10 @@ export declare namespace ResponseInputItem {
          * returned via API.
          */
         id?: string | null;
+        /**
+         * The execution context that produced this tool call.
+         */
+        caller?: ShellCallOutput.Direct | ShellCallOutput.Program | null;
         /**
          * The maximum number of UTF-8 characters captured for this shell call's combined
          * output.
@@ -3359,6 +3688,24 @@ export declare namespace ResponseInputItem {
          */
         status?: 'in_progress' | 'completed' | 'incomplete' | null;
     }
+    namespace ShellCallOutput {
+        interface Direct {
+            /**
+             * The caller type. Always `direct`.
+             */
+            type: 'direct';
+        }
+        interface Program {
+            /**
+             * The call ID of the program item that produced this tool call.
+             */
+            caller_id: string;
+            /**
+             * The caller type. Always `program`.
+             */
+            type: 'program';
+        }
+    }
     /**
      * A tool call representing a request to create, delete, or update files using diff
      * patches.
@@ -3386,6 +3733,10 @@ export declare namespace ResponseInputItem {
          * via API.
          */
         id?: string | null;
+        /**
+         * The execution context that produced this tool call.
+         */
+        caller?: ApplyPatchCall.Direct | ApplyPatchCall.Program | null;
     }
     namespace ApplyPatchCall {
         /**
@@ -3435,6 +3786,22 @@ export declare namespace ResponseInputItem {
              */
             type: 'update_file';
         }
+        interface Direct {
+            /**
+             * The caller type. Always `direct`.
+             */
+            type: 'direct';
+        }
+        interface Program {
+            /**
+             * The call ID of the program item that produced this tool call.
+             */
+            caller_id: string;
+            /**
+             * The caller type. Always `program`.
+             */
+            type: 'program';
+        }
     }
     /**
      * The streamed output emitted by an apply patch tool call.
@@ -3457,12 +3824,34 @@ export declare namespace ResponseInputItem {
          * returned via API.
          */
         id?: string | null;
+        /**
+         * The execution context that produced this tool call.
+         */
+        caller?: ApplyPatchCallOutput.Direct | ApplyPatchCallOutput.Program | null;
         /**
          * Optional human-readable log text from the apply patch tool (e.g., patch results
          * or errors).
          */
         output?: string | null;
     }
+    namespace ApplyPatchCallOutput {
+        interface Direct {
+            /**
+             * The caller type. Always `direct`.
+             */
+            type: 'direct';
+        }
+        interface Program {
+            /**
+             * The call ID of the program item that produced this tool call.
+             */
+            caller_id: string;
+            /**
+             * The caller type. Always `program`.
+             */
+            type: 'program';
+        }
+    }
     /**
      * A list of tools available on an MCP server.
      */
@@ -3627,6 +4016,50 @@ export declare namespace ResponseInputItem {
          */
         type?: 'item_reference' | null;
     }
+    interface Program {
+        /**
+         * The unique ID of this program item.
+         */
+        id: string;
+        /**
+         * The stable call ID of the program item.
+         */
+        call_id: string;
+        /**
+         * The JavaScript source executed by programmatic tool calling.
+         */
+        code: string;
+        /**
+         * Opaque program replay fingerprint that must be round-tripped.
+         */
+        fingerprint: string;
+        /**
+         * The item type. Always `program`.
+         */
+        type: 'program';
+    }
+    interface ProgramOutput {
+        /**
+         * The unique ID of this program output item.
+         */
+        id: string;
+        /**
+         * The call ID of the program item.
+         */
+        call_id: string;
+        /**
+         * The result produced by the program item.
+         */
+        result: string;
+        /**
+         * The terminal status of the program output.
+         */
+        status: 'completed' | 'incomplete';
+        /**
+         * The item type. Always `program_output`.
+         */
+        type: 'program_output';
+    }
 }
 /**
  * A list of one or many input items to the model, containing different content
@@ -3669,6 +4102,25 @@ export interface ResponseInputText {
      * The type of the input item. Always `input_text`.
      */
     type: 'input_text';
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    prompt_cache_breakpoint?: ResponseInputText.PromptCacheBreakpoint;
+}
+export declare namespace ResponseInputText {
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    interface PromptCacheBreakpoint {
+        /**
+         * The breakpoint mode. Always `explicit`.
+         */
+        mode: 'explicit';
+    }
 }
 /**
  * A text input to the model.
@@ -3682,11 +4134,30 @@ export interface ResponseInputTextContent {
      * The type of the input item. Always `input_text`.
      */
     type: 'input_text';
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    prompt_cache_breakpoint?: ResponseInputTextContent.PromptCacheBreakpoint | null;
+}
+export declare namespace ResponseInputTextContent {
+    /**
+     * Marks the exact end of a reusable prompt prefix. The breakpoint inherits its TTL
+     * from the request's `prompt_cache_options.ttl`; the boundary is not rounded to a
+     * token block.
+     */
+    interface PromptCacheBreakpoint {
+        /**
+         * The breakpoint mode. Always `explicit`.
+         */
+        mode: 'explicit';
+    }
 }
 /**
  * Content item used to generate a response.
  */
-export type ResponseItem = ResponseInputMessageItem | ResponseOutputMessage | ResponseFileSearchToolCall | ResponseComputerToolCall | ResponseComputerToolCallOutputItem | ResponseFunctionWebSearch | ResponseFunctionToolCallItem | ResponseFunctionToolCallOutputItem | ResponseToolSearchCall | ResponseToolSearchOutputItem | ResponseItem.AdditionalTools | ResponseReasoningItem | ResponseCompactionItem | ResponseItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseItem.LocalShellCall | ResponseItem.LocalShellCallOutput | ResponseFunctionShellToolCall | ResponseFunctionShellToolCallOutput | ResponseApplyPatchToolCall | ResponseApplyPatchToolCallOutput | ResponseItem.McpListTools | ResponseItem.McpApprovalRequest | ResponseItem.McpApprovalResponse | ResponseItem.McpCall | ResponseCustomToolCallItem | ResponseCustomToolCallOutputItem;
+export type ResponseItem = ResponseInputMessageItem | ResponseOutputMessage | ResponseFileSearchToolCall | ResponseComputerToolCall | ResponseComputerToolCallOutputItem | ResponseFunctionWebSearch | ResponseFunctionToolCallItem | ResponseFunctionToolCallOutputItem | ResponseToolSearchCall | ResponseToolSearchOutputItem | ResponseItem.AdditionalTools | ResponseReasoningItem | ResponseItem.Program | ResponseItem.ProgramOutput | ResponseCompactionItem | ResponseItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseItem.LocalShellCall | ResponseItem.LocalShellCallOutput | ResponseFunctionShellToolCall | ResponseFunctionShellToolCallOutput | ResponseApplyPatchToolCall | ResponseApplyPatchToolCallOutput | ResponseItem.McpListTools | ResponseItem.McpApprovalRequest | ResponseItem.McpApprovalResponse | ResponseItem.McpCall | ResponseCustomToolCallItem | ResponseCustomToolCallOutputItem;
 export declare namespace ResponseItem {
     interface AdditionalTools {
         /**
@@ -3706,6 +4177,50 @@ export declare namespace ResponseItem {
          */
         type: 'additional_tools';
     }
+    interface Program {
+        /**
+         * The unique ID of the program item.
+         */
+        id: string;
+        /**
+         * The stable call ID of the program item.
+         */
+        call_id: string;
+        /**
+         * The JavaScript source executed by programmatic tool calling.
+         */
+        code: string;
+        /**
+         * Opaque program replay fingerprint that must be round-tripped.
+         */
+        fingerprint: string;
+        /**
+         * The type of the item. Always `program`.
+         */
+        type: 'program';
+    }
+    interface ProgramOutput {
+        /**
+         * The unique ID of the program output item.
+         */
+        id: string;
+        /**
+         * The call ID of the program item.
+         */
+        call_id: string;
+        /**
+         * The result produced by the program item.
+         */
+        result: string;
+        /**
+         * The terminal status of the program output item.
+         */
+        status: 'completed' | 'incomplete';
+        /**
+         * The type of the item. Always `program_output`.
+         */
+        type: 'program_output';
+    }
     /**
      * An image generation request made by the model.
      */
@@ -4157,8 +4672,52 @@ export interface ResponseOutputAudio {
 /**
  * An output message from the model.
  */
-export type ResponseOutputItem = ResponseOutputMessage | ResponseFileSearchToolCall | ResponseFunctionToolCall | ResponseFunctionToolCallOutputItem | ResponseFunctionWebSearch | ResponseComputerToolCall | ResponseComputerToolCallOutputItem | ResponseReasoningItem | ResponseToolSearchCall | ResponseToolSearchOutputItem | ResponseOutputItem.AdditionalTools | ResponseCompactionItem | ResponseOutputItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseOutputItem.LocalShellCall | ResponseOutputItem.LocalShellCallOutput | ResponseFunctionShellToolCall | ResponseFunctionShellToolCallOutput | ResponseApplyPatchToolCall | ResponseApplyPatchToolCallOutput | ResponseOutputItem.McpCall | ResponseOutputItem.McpListTools | ResponseOutputItem.McpApprovalRequest | ResponseOutputItem.McpApprovalResponse | ResponseCustomToolCall | ResponseCustomToolCallOutputItem;
+export type ResponseOutputItem = ResponseOutputMessage | ResponseFileSearchToolCall | ResponseFunctionToolCall | ResponseFunctionToolCallOutputItem | ResponseFunctionWebSearch | ResponseComputerToolCall | ResponseComputerToolCallOutputItem | ResponseReasoningItem | ResponseOutputItem.Program | ResponseOutputItem.ProgramOutput | ResponseToolSearchCall | ResponseToolSearchOutputItem | ResponseOutputItem.AdditionalTools | ResponseCompactionItem | ResponseOutputItem.ImageGenerationCall | ResponseCodeInterpreterToolCall | ResponseOutputItem.LocalShellCall | ResponseOutputItem.LocalShellCallOutput | ResponseFunctionShellToolCall | ResponseFunctionShellToolCallOutput | ResponseApplyPatchToolCall | ResponseApplyPatchToolCallOutput | ResponseOutputItem.McpCall | ResponseOutputItem.McpListTools | ResponseOutputItem.McpApprovalRequest | ResponseOutputItem.McpApprovalResponse | ResponseCustomToolCall | ResponseCustomToolCallOutputItem;
 export declare namespace ResponseOutputItem {
+    interface Program {
+        /**
+         * The unique ID of the program item.
+         */
+        id: string;
+        /**
+         * The stable call ID of the program item.
+         */
+        call_id: string;
+        /**
+         * The JavaScript source executed by programmatic tool calling.
+         */
+        code: string;
+        /**
+         * Opaque program replay fingerprint that must be round-tripped.
+         */
+        fingerprint: string;
+        /**
+         * The type of the item. Always `program`.
+         */
+        type: 'program';
+    }
+    interface ProgramOutput {
+        /**
+         * The unique ID of the program output item.
+         */
+        id: string;
+        /**
+         * The call ID of the program item.
+         */
+        call_id: string;
+        /**
+         * The result produced by the program item.
+         */
+        result: string;
+        /**
+         * The terminal status of the program output item.
+         */
+        status: 'completed' | 'incomplete';
+        /**
+         * The type of the item. Always `program_output`.
+         */
+        type: 'program_output';
+    }
     interface AdditionalTools {
         /**
          * The unique ID of the additional tools item.
@@ -4845,6 +5404,11 @@ export interface ResponseReasoningSummaryPartDoneEvent {
      * The type of the event. Always `response.reasoning_summary_part.done`.
      */
     type: 'response.reasoning_summary_part.done';
+    /**
+     * The completion status of the summary part. Omitted when the part completed
+     * normally and set to `incomplete` when generation was interrupted.
+     */
+    status?: 'incomplete';
 }
 export declare namespace ResponseReasoningSummaryPartDoneEvent {
     /**
@@ -5324,6 +5888,10 @@ export declare namespace ResponseUsage {
      * A detailed breakdown of the input tokens.
      */
     interface InputTokensDetails {
+        /**
+         * The number of input tokens that were written to the cache.
+         */
+        cache_write_tokens: number;
         /**
          * The number of tokens that were retrieved from the cache.
          * [More on prompt caching](https://platform.openai.com/docs/guides/prompt-caching).
@@ -5522,11 +6090,28 @@ export interface ResponsesClientEvent {
      */
     prompt_cache_key?: string;
     /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By
+     * default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+     * explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+     * request can write up to four breakpoints. For cache matching, OpenAI considers
+     * up to the latest 80 breakpoints in the conversation, without a content-block
+     * lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+     * `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+     * for current details.
+     */
+    prompt_cache_options?: ResponsesClientEvent.PromptCacheOptions;
+    /**
+     * @deprecated Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
      * The retention policy for the prompt cache. Set to `24h` to enable extended
      * prompt caching, which keeps cached prefixes active for longer, up to a maximum
      * of 24 hours.
      * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+     * This field expresses a maximum retention policy, while
+     * `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
+     * are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
+     * models, only `24h` is supported.
      *
      * For older models that support both `in_memory` and `24h`, the default depends on
      * your organization's data retention policy:
@@ -5608,7 +6193,7 @@ export interface ResponsesClientEvent {
      * response. See the `tools` parameter to see how to specify which tools the model
      * can call.
      */
-    tool_choice?: ToolChoiceOptions | ToolChoiceAllowed | ToolChoiceTypes | ToolChoiceFunction | ToolChoiceMcp | ToolChoiceCustom | ToolChoiceApplyPatch | ToolChoiceShell;
+    tool_choice?: ToolChoiceOptions | ToolChoiceAllowed | ToolChoiceTypes | ToolChoiceFunction | ToolChoiceMcp | ToolChoiceCustom | ResponsesClientEvent.SpecificProgrammaticToolCallingParam | ToolChoiceApplyPatch | ToolChoiceShell;
     /**
      * An array of tools the model may call while generating a response. You can
      * specify which tool to use by setting the `tool_choice` parameter.
@@ -5685,6 +6270,67 @@ export declare namespace ResponsesClientEvent {
          * 'omni-moderation-latest'.
          */
         model: string;
+        /**
+         * The policy to apply to moderated response input and output.
+         */
+        policy?: Moderation.Policy | null;
+    }
+    namespace Moderation {
+        /**
+         * The policy to apply to moderated response input and output.
+         */
+        interface Policy {
+            /**
+             * The moderation policy for the response input.
+             */
+            input?: Policy.Input | null;
+            /**
+             * The moderation policy for the response output.
+             */
+            output?: Policy.Output | null;
+        }
+        namespace Policy {
+            /**
+             * The moderation policy for the response input.
+             */
+            interface Input {
+                mode: 'score' | 'block';
+            }
+            /**
+             * The moderation policy for the response output.
+             */
+            interface Output {
+                mode: 'score' | 'block';
+            }
+        }
+    }
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By
+     * default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+     * explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+     * request can write up to four breakpoints. For cache matching, OpenAI considers
+     * up to the latest 80 breakpoints in the conversation, without a content-block
+     * lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+     * `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+     * for current details.
+     */
+    interface PromptCacheOptions {
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint.
+         * Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
+         * and writes up to the latest three explicit breakpoints in the request. With
+         * `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+         * latest four explicit breakpoints. If there are no explicit breakpoints, the
+         * request does not use prompt caching.
+         */
+        mode?: 'implicit' | 'explicit';
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint
+         * written by the request. Defaults to `30m`, which is currently the only supported
+         * value. The backend may retain cache entries for longer.
+         */
+        ttl?: '30m';
     }
     /**
      * Options for streaming responses. Only set this when you set `stream: true`.
@@ -5700,6 +6346,12 @@ export declare namespace ResponsesClientEvent {
          */
         include_obfuscation?: boolean;
     }
+    interface SpecificProgrammaticToolCallingParam {
+        /**
+         * The tool to call. Always `programmatic_tool_calling`.
+         */
+        type: 'programmatic_tool_calling';
+    }
 }
 /**
  * Server events emitted by the Responses WebSocket server.
@@ -5722,7 +6374,7 @@ export interface SkillReference {
 /**
  * A tool that can be used to generate a response.
  */
-export type Tool = FunctionTool | FileSearchTool | ComputerTool | ComputerUsePreviewTool | WebSearchTool | Tool.Mcp | Tool.CodeInterpreter | Tool.ImageGeneration | Tool.LocalShell | FunctionShellTool | CustomTool | NamespaceTool | ToolSearchTool | WebSearchPreviewTool | ApplyPatchTool;
+export type Tool = FunctionTool | FileSearchTool | ComputerTool | ComputerUsePreviewTool | WebSearchTool | Tool.Mcp | Tool.CodeInterpreter | Tool.ProgrammaticToolCalling | Tool.ImageGeneration | Tool.LocalShell | FunctionShellTool | CustomTool | NamespaceTool | ToolSearchTool | WebSearchPreviewTool | ApplyPatchTool;
 export declare namespace Tool {
     /**
      * Give the model access to additional tools via remote Model Context Protocol
@@ -5738,6 +6390,10 @@ export declare namespace Tool {
          * The type of the MCP tool. Always `mcp`.
          */
         type: 'mcp';
+        /**
+         * The tool invocation context(s).
+         */
+        allowed_callers?: Array<'direct' | 'programmatic'> | null;
         /**
          * List of allowed tool names or a filter object.
          */
@@ -5876,6 +6532,10 @@ export declare namespace Tool {
          * The type of the code interpreter tool. Always `code_interpreter`.
          */
         type: 'code_interpreter';
+        /**
+         * The tool invocation context(s).
+         */
+        allowed_callers?: Array<'direct' | 'programmatic'> | null;
     }
     namespace CodeInterpreter {
         /**
@@ -5901,6 +6561,12 @@ export declare namespace Tool {
             network_policy?: ResponsesAPI.ContainerNetworkPolicyDisabled | ResponsesAPI.ContainerNetworkPolicyAllowlist;
         }
     }
+    interface ProgrammaticToolCalling {
+        /**
+         * The type of the tool. Always `programmatic_tool_calling`.
+         */
+        type: 'programmatic_tool_calling';
+    }
     /**
      * A tool that generates images using the GPT image models.
      */
@@ -6385,11 +7051,28 @@ export interface ResponseCreateParamsBase {
      */
     prompt_cache_key?: string;
     /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By
+     * default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+     * explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+     * request can write up to four breakpoints. For cache matching, OpenAI considers
+     * up to the latest 80 breakpoints in the conversation, without a content-block
+     * lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+     * `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+     * for current details.
+     */
+    prompt_cache_options?: ResponseCreateParams.PromptCacheOptions;
+    /**
+     * @deprecated Deprecated. Use `prompt_cache_options.ttl` instead.
+     *
      * The retention policy for the prompt cache. Set to `24h` to enable extended
      * prompt caching, which keeps cached prefixes active for longer, up to a maximum
      * of 24 hours.
      * [Learn more](https://platform.openai.com/docs/guides/prompt-caching#prompt-cache-retention).
-     * For `gpt-5.5`, `gpt-5.5-pro`, and future models, only `24h` is supported.
+     * This field expresses a maximum retention policy, while
+     * `prompt_cache_options.ttl` expresses a minimum cache lifetime. The two fields
+     * are independent and do not interact. For `gpt-5.5`, `gpt-5.5-pro`, and future
+     * models, only `24h` is supported.
      *
      * For older models that support both `in_memory` and `24h`, the default depends on
      * your organization's data retention policy:
@@ -6470,7 +7153,7 @@ export interface ResponseCreateParamsBase {
      * response. See the `tools` parameter to see how to specify which tools the model
      * can call.
      */
-    tool_choice?: ToolChoiceOptions | ToolChoiceAllowed | ToolChoiceTypes | ToolChoiceFunction | ToolChoiceMcp | ToolChoiceCustom | ToolChoiceApplyPatch | ToolChoiceShell;
+    tool_choice?: ToolChoiceOptions | ToolChoiceAllowed | ToolChoiceTypes | ToolChoiceFunction | ToolChoiceMcp | ToolChoiceCustom | ResponseCreateParams.SpecificProgrammaticToolCallingParam | ToolChoiceApplyPatch | ToolChoiceShell;
     /**
      * An array of tools the model may call while generating a response. You can
      * specify which tool to use by setting the `tool_choice` parameter.
@@ -6547,6 +7230,67 @@ export declare namespace ResponseCreateParams {
          * 'omni-moderation-latest'.
          */
         model: string;
+        /**
+         * The policy to apply to moderated response input and output.
+         */
+        policy?: Moderation.Policy | null;
+    }
+    namespace Moderation {
+        /**
+         * The policy to apply to moderated response input and output.
+         */
+        interface Policy {
+            /**
+             * The moderation policy for the response input.
+             */
+            input?: Policy.Input | null;
+            /**
+             * The moderation policy for the response output.
+             */
+            output?: Policy.Output | null;
+        }
+        namespace Policy {
+            /**
+             * The moderation policy for the response input.
+             */
+            interface Input {
+                mode: 'score' | 'block';
+            }
+            /**
+             * The moderation policy for the response output.
+             */
+            interface Output {
+                mode: 'score' | 'block';
+            }
+        }
+    }
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By
+     * default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+     * explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+     * request can write up to four breakpoints. For cache matching, OpenAI considers
+     * up to the latest 80 breakpoints in the conversation, without a content-block
+     * lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+     * `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+     * for current details.
+     */
+    interface PromptCacheOptions {
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint.
+         * Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
+         * and writes up to the latest three explicit breakpoints in the request. With
+         * `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+         * latest four explicit breakpoints. If there are no explicit breakpoints, the
+         * request does not use prompt caching.
+         */
+        mode?: 'implicit' | 'explicit';
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint
+         * written by the request. Defaults to `30m`, which is currently the only supported
+         * value. The backend may retain cache entries for longer.
+         */
+        ttl?: '30m';
     }
     /**
      * Options for streaming responses. Only set this when you set `stream: true`.
@@ -6562,6 +7306,12 @@ export declare namespace ResponseCreateParams {
          */
         include_obfuscation?: boolean;
     }
+    interface SpecificProgrammaticToolCallingParam {
+        /**
+         * The tool to call. Always `programmatic_tool_calling`.
+         */
+        type: 'programmatic_tool_calling';
+    }
     type ResponseCreateParamsNonStreaming = ResponsesAPI.ResponseCreateParamsNonStreaming;
     type ResponseCreateParamsStreaming = ResponsesAPI.ResponseCreateParamsStreaming;
 }
@@ -6651,7 +7401,7 @@ export interface ResponseCompactParams {
      * [model guide](https://platform.openai.com/docs/models) to browse and compare
      * available models.
      */
-    model: 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.3-chat-latest' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o3-deep-research' | 'o3-deep-research-2025-06-26' | 'o4-mini-deep-research' | 'o4-mini-deep-research-2025-06-26' | 'computer-use-preview' | 'computer-use-preview-2025-03-11' | 'gpt-5-codex' | 'gpt-5-pro' | 'gpt-5-pro-2025-10-06' | 'gpt-5.1-codex-max' | (string & {}) | null;
+    model: 'gpt-5.6-sol' | 'gpt-5.6-terra' | 'gpt-5.6-luna' | 'gpt-5.4' | 'gpt-5.4-mini' | 'gpt-5.4-nano' | 'gpt-5.4-mini-2026-03-17' | 'gpt-5.4-nano-2026-03-17' | 'gpt-5.3-chat-latest' | 'gpt-5.2' | 'gpt-5.2-2025-12-11' | 'gpt-5.2-chat-latest' | 'gpt-5.2-pro' | 'gpt-5.2-pro-2025-12-11' | 'gpt-5.1' | 'gpt-5.1-2025-11-13' | 'gpt-5.1-codex' | 'gpt-5.1-mini' | 'gpt-5.1-chat-latest' | 'gpt-5' | 'gpt-5-mini' | 'gpt-5-nano' | 'gpt-5-2025-08-07' | 'gpt-5-mini-2025-08-07' | 'gpt-5-nano-2025-08-07' | 'gpt-5-chat-latest' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'gpt-4.1-2025-04-14' | 'gpt-4.1-mini-2025-04-14' | 'gpt-4.1-nano-2025-04-14' | 'o4-mini' | 'o4-mini-2025-04-16' | 'o3' | 'o3-2025-04-16' | 'o3-mini' | 'o3-mini-2025-01-31' | 'o1' | 'o1-2024-12-17' | 'o1-preview' | 'o1-preview-2024-09-12' | 'o1-mini' | 'o1-mini-2024-09-12' | 'gpt-4o' | 'gpt-4o-2024-11-20' | 'gpt-4o-2024-08-06' | 'gpt-4o-2024-05-13' | 'gpt-4o-audio-preview' | 'gpt-4o-audio-preview-2024-10-01' | 'gpt-4o-audio-preview-2024-12-17' | 'gpt-4o-audio-preview-2025-06-03' | 'gpt-4o-mini-audio-preview' | 'gpt-4o-mini-audio-preview-2024-12-17' | 'gpt-4o-search-preview' | 'gpt-4o-mini-search-preview' | 'gpt-4o-search-preview-2025-03-11' | 'gpt-4o-mini-search-preview-2025-03-11' | 'chatgpt-4o-latest' | 'codex-mini-latest' | 'gpt-4o-mini' | 'gpt-4o-mini-2024-07-18' | 'gpt-4-turbo' | 'gpt-4-turbo-2024-04-09' | 'gpt-4-0125-preview' | 'gpt-4-turbo-preview' | 'gpt-4-1106-preview' | 'gpt-4-vision-preview' | 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-1106' | 'gpt-3.5-turbo-0125' | 'gpt-3.5-turbo-16k-0613' | 'o1-pro' | 'o1-pro-2025-03-19' | 'o3-pro' | 'o3-pro-2025-06-10' | 'o3-deep-research' | 'o3-deep-research-2025-06-26' | 'o4-mini-deep-research' | 'o4-mini-deep-research-2025-06-26' | 'computer-use-preview' | 'computer-use-preview-2025-03-11' | 'gpt-5-codex' | 'gpt-5-pro' | 'gpt-5-pro-2025-10-06' | 'gpt-5.1-codex-max' | (string & {}) | null;
     /**
      * Text, image, or file inputs to the model, used to generate a response
      */
@@ -6675,7 +7425,19 @@ export interface ResponseCompactParams {
      */
     prompt_cache_key?: string | null;
     /**
-     * How long to retain a prompt cache entry created by this request.
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By
+     * default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+     * explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+     * request can write up to four breakpoints. For cache matching, OpenAI considers
+     * up to the latest 80 breakpoints in the conversation, without a content-block
+     * lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+     * `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+     * for current details.
+     */
+    prompt_cache_options?: ResponseCompactParams.PromptCacheOptions | null;
+    /**
+     * @deprecated How long to retain a prompt cache entry created by this request.
      */
     prompt_cache_retention?: 'in_memory' | '24h' | null;
     /**
@@ -6683,6 +7445,36 @@ export interface ResponseCompactParams {
      */
     service_tier?: 'auto' | 'default' | 'flex' | 'priority' | null;
 }
+export declare namespace ResponseCompactParams {
+    /**
+     * Options for prompt caching. Supported for `gpt-5.6` and later models. By
+     * default, OpenAI automatically chooses one implicit cache breakpoint. You can add
+     * explicit breakpoints to content blocks with `prompt_cache_breakpoint`. Each
+     * request can write up to four breakpoints. For cache matching, OpenAI considers
+     * up to the latest 80 breakpoints in the conversation, without a content-block
+     * lookback limit. Set `mode` to `explicit` to disable the implicit breakpoint. The
+     * `ttl` defaults to `30m`, which is currently the only supported value. See the
+     * [prompt caching guide](https://platform.openai.com/docs/guides/prompt-caching)
+     * for current details.
+     */
+    interface PromptCacheOptions {
+        /**
+         * Controls whether OpenAI automatically creates an implicit cache breakpoint.
+         * Defaults to `implicit`. With `implicit`, OpenAI creates one implicit breakpoint
+         * and writes up to the latest three explicit breakpoints in the request. With
+         * `explicit`, OpenAI does not create an implicit breakpoint and writes up to the
+         * latest four explicit breakpoints. If there are no explicit breakpoints, the
+         * request does not use prompt caching.
+         */
+        mode?: 'implicit' | 'explicit';
+        /**
+         * The minimum lifetime applied to every implicit and explicit cache breakpoint
+         * written by the request. Defaults to `30m`, which is currently the only supported
+         * value. The backend may retain cache entries for longer.
+         */
+        ttl?: '30m';
+    }
+}
 export declare namespace Responses {
     export { type ApplyPatchTool as ApplyPatchTool, type CompactedResponse as CompactedResponse, type ComputerAction as ComputerAction, type ComputerActionList as ComputerActionList, type ComputerTool as ComputerTool, type ComputerUsePreviewTool as ComputerUsePreviewTool, type ContainerAuto as ContainerAuto, type ContainerNetworkPolicyAllowlist as ContainerNetworkPolicyAllowlist, type ContainerNetworkPolicyDisabled as ContainerNetworkPolicyDisabled, type ContainerNetworkPolicyDomainSecret as ContainerNetworkPolicyDomainSecret, type ContainerReference as ContainerReference, type CustomTool as CustomTool, type EasyInputMessage as EasyInputMessage, type FileSearchTool as FileSearchTool, type FunctionShellTool as FunctionShellTool, type FunctionTool as FunctionTool, type InlineSkill as InlineSkill, type InlineSkillSource as InlineSkillSource, type LocalEnvironment as LocalEnvironment, type LocalSkill as LocalSkill, type NamespaceTool as NamespaceTool, type Response as Response, type ResponseApplyPatchToolCall as ResponseApplyPatchToolCall, type ResponseApplyPatchToolCallOutput as ResponseApplyPatchToolCallOutput, type ResponseAudioDeltaEvent as ResponseAudioDeltaEvent, type ResponseAudioDoneEvent as ResponseAudioDoneEvent, type ResponseAudioTranscriptDeltaEvent as ResponseAudioTranscriptDeltaEvent, type ResponseAudioTranscriptDoneEvent as ResponseAudioTranscriptDoneEvent, type ResponseCodeInterpreterCallCodeDeltaEvent as ResponseCodeInterpreterCallCodeDeltaEvent, type ResponseCodeInterpreterCallCodeDoneEvent as ResponseCodeInterpreterCallCodeDoneEvent, type ResponseCodeInterpreterCallCompletedEvent as ResponseCodeInterpreterCallCompletedEvent, type ResponseCodeInterpreterCallInProgressEvent as ResponseCodeInterpreterCallInProgressEvent, type ResponseCodeInterpreterCallInterpretingEvent as ResponseCodeInterpreterCallInterpretingEvent, type ResponseCodeInterpreterToolCall as ResponseCodeInterpreterToolCall, type ResponseCompactionItem as ResponseCompactionItem, type ResponseCompactionItemParam as ResponseCompactionItemParam, type ResponseCompletedEvent as ResponseCompletedEvent, type ResponseComputerToolCall as ResponseComputerToolCall, type ResponseComputerToolCallOutputItem as ResponseComputerToolCallOutputItem, type ResponseComputerToolCallOutputScreenshot as ResponseComputerToolCallOutputScreenshot, type ResponseContainerReference as ResponseContainerReference, type ResponseContent as ResponseContent, type ResponseContentPartAddedEvent as ResponseContentPartAddedEvent, type ResponseContentPartDoneEvent as ResponseContentPartDoneEvent, type ResponseConversationParam as ResponseConversationParam, type ResponseCreatedEvent as ResponseCreatedEvent, 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, type ResponseFileSearchCallCompletedEvent as ResponseFileSearchCallCompletedEvent, type ResponseFileSearchCallInProgressEvent as ResponseFileSearchCallInProgressEvent, type ResponseFileSearchCallSearchingEvent as ResponseFileSearchCallSearchingEvent, type ResponseFileSearchToolCall as ResponseFileSearchToolCall, type ResponseFormatTextConfig as ResponseFormatTextConfig, type ResponseFormatTextJSONSchemaConfig as ResponseFormatTextJSONSchemaConfig, type ResponseFunctionCallArgumentsDeltaEvent as ResponseFunctionCallArgumentsDeltaEvent, type ResponseFunctionCallArgumentsDoneEvent as ResponseFunctionCallArgumentsDoneEvent, type ResponseFunctionCallOutputItem as ResponseFunctionCallOutputItem, type ResponseFunctionCallOutputItemList as ResponseFunctionCallOutputItemList, type ResponseFunctionShellCallOutputContent as ResponseFunctionShellCallOutputContent, type ResponseFunctionShellToolCall as ResponseFunctionShellToolCall, type ResponseFunctionShellToolCallOutput as ResponseFunctionShellToolCallOutput, type ResponseFunctionToolCall as ResponseFunctionToolCall, type ResponseFunctionToolCallItem as ResponseFunctionToolCallItem, type ResponseFunctionToolCallOutputItem as ResponseFunctionToolCallOutputItem, type ResponseFunctionWebSearch as ResponseFunctionWebSearch, type ResponseImageGenCallCompletedEvent as ResponseImageGenCallCompletedEvent, type ResponseImageGenCallGeneratingEvent as ResponseImageGenCallGeneratingEvent, type ResponseImageGenCallInProgressEvent as ResponseImageGenCallInProgressEvent, type ResponseImageGenCallPartialImageEvent as ResponseImageGenCallPartialImageEvent, type ResponseInProgressEvent as ResponseInProgressEvent, type ResponseIncludable as ResponseIncludable, type ResponseIncompleteEvent as ResponseIncompleteEvent, type ResponseInput as ResponseInput, type ResponseInputAudio as ResponseInputAudio, type ResponseInputContent as ResponseInputContent, type ResponseInputFile as ResponseInputFile, type ResponseInputFileContent as ResponseInputFileContent, type ResponseInputImage as ResponseInputImage, type ResponseInputImageContent as ResponseInputImageContent, type ResponseInputItem as ResponseInputItem, type ResponseInputMessageContentList as ResponseInputMessageContentList, type ResponseInputMessageItem as ResponseInputMessageItem, type ResponseInputText as ResponseInputText, type ResponseInputTextContent as ResponseInputTextContent, type ResponseItem as ResponseItem, type ResponseLocalEnvironment as ResponseLocalEnvironment, type ResponseMcpCallArgumentsDeltaEvent as ResponseMcpCallArgumentsDeltaEvent, type ResponseMcpCallArgumentsDoneEvent as ResponseMcpCallArgumentsDoneEvent, type ResponseMcpCallCompletedEvent as ResponseMcpCallCompletedEvent, type ResponseMcpCallFailedEvent as ResponseMcpCallFailedEvent, type ResponseMcpCallInProgressEvent as ResponseMcpCallInProgressEvent, type ResponseMcpListToolsCompletedEvent as ResponseMcpListToolsCompletedEvent, type ResponseMcpListToolsFailedEvent as ResponseMcpListToolsFailedEvent, type ResponseMcpListToolsInProgressEvent as ResponseMcpListToolsInProgressEvent, type ResponseOutputAudio as ResponseOutputAudio, type ResponseOutputItem as ResponseOutputItem, type ResponseOutputItemAddedEvent as ResponseOutputItemAddedEvent, type ResponseOutputItemDoneEvent as ResponseOutputItemDoneEvent, type ResponseOutputMessage as ResponseOutputMessage, type ResponseOutputRefusal as ResponseOutputRefusal, type ResponseOutputText as ResponseOutputText, type ResponseOutputTextAnnotationAddedEvent as ResponseOutputTextAnnotationAddedEvent, type ResponsePrompt as ResponsePrompt, type ResponseQueuedEvent as ResponseQueuedEvent, type ResponseReasoningItem as ResponseReasoningItem, type ResponseReasoningSummaryPartAddedEvent as ResponseReasoningSummaryPartAddedEvent, type ResponseReasoningSummaryPartDoneEvent as ResponseReasoningSummaryPartDoneEvent, type ResponseReasoningSummaryTextDeltaEvent as ResponseReasoningSummaryTextDeltaEvent, type ResponseReasoningSummaryTextDoneEvent as ResponseReasoningSummaryTextDoneEvent, type ResponseReasoningTextDeltaEvent as ResponseReasoningTextDeltaEvent, type ResponseReasoningTextDoneEvent as ResponseReasoningTextDoneEvent, type ResponseRefusalDeltaEvent as ResponseRefusalDeltaEvent, type ResponseRefusalDoneEvent as ResponseRefusalDoneEvent, type ResponseStatus as ResponseStatus, type ResponseStreamEvent as ResponseStreamEvent, type ResponseTextConfig as ResponseTextConfig, type ResponseTextDeltaEvent as ResponseTextDeltaEvent, type ResponseTextDoneEvent as ResponseTextDoneEvent, type ResponseToolSearchCall as ResponseToolSearchCall, type ResponseToolSearchOutputItem as ResponseToolSearchOutputItem, type ResponseToolSearchOutputItemParam as ResponseToolSearchOutputItemParam, type ResponseUsage as ResponseUsage, type ResponseWebSearchCallCompletedEvent as ResponseWebSearchCallCompletedEvent, type ResponseWebSearchCallInProgressEvent as ResponseWebSearchCallInProgressEvent, type ResponseWebSearchCallSearchingEvent as ResponseWebSearchCallSearchingEvent, type ResponsesClientEvent as ResponsesClientEvent, type ResponsesServerEvent as ResponsesServerEvent, type SkillReference as SkillReference, type Tool as Tool, type ToolChoiceAllowed as ToolChoiceAllowed, type ToolChoiceApplyPatch as ToolChoiceApplyPatch, type ToolChoiceCustom as ToolChoiceCustom, type ToolChoiceFunction as ToolChoiceFunction, type ToolChoiceMcp as ToolChoiceMcp, type ToolChoiceOptions as ToolChoiceOptions, type ToolChoiceShell as ToolChoiceShell, type ToolChoiceTypes as ToolChoiceTypes, type ToolSearchTool as ToolSearchTool, type WebSearchPreviewTool as WebSearchPreviewTool, type WebSearchTool as WebSearchTool, type ResponseCreateParams as ResponseCreateParams, type ResponseCreateParamsNonStreaming as ResponseCreateParamsNonStreaming, type ResponseCreateParamsStreaming as ResponseCreateParamsStreaming, type ResponseRetrieveParams as ResponseRetrieveParams, type ResponseRetrieveParamsNonStreaming as ResponseRetrieveParamsNonStreaming, type ResponseRetrieveParamsStreaming as ResponseRetrieveParamsStreaming, type ResponseCompactParams as ResponseCompactParams, };
     export { InputItems as InputItems, type ResponseItemList as ResponseItemList, type InputItemListParams as InputItemListParams, };