openai 7.19.0 → 7.21.0

package/resources/beta/responses/responses.d.ts

@@ -8,6 +8,9 @@ import { APIPromise } from "../../../core/api-promise.js";
 import { CursorPage } from "../../../core/pagination.js";
 import { Stream } from "../../../core/streaming.js";
 import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Create and manage model responses.
+ */
 export declare class Responses extends APIResource {
     inputItems: InputItemsAPI.InputItems;
     inputTokens: InputTokensAPI.InputTokens;
@@ -42,9 +45,20 @@ export declare class Responses extends APIResource {
      * );
      * ```
      */
-    retrieve(responseID: string, params?: ResponseRetrieveParamsNonStreaming, options?: RequestOptions): APIPromise<BetaResponse>;
-    retrieve(responseID: string, params: ResponseRetrieveParamsStreaming, options?: RequestOptions): APIPromise<Stream<BetaResponseStreamEvent>>;
-    retrieve(responseID: string, params?: ResponseRetrieveParamsBase | undefined, options?: RequestOptions): APIPromise<Stream<BetaResponseStreamEvent> | BetaResponse>;
+    retrieve(responseID: string, params?: ResponseRetrieveParamsNonStreaming & ({
+        [K in 'method' | 'path' | 'query' | 'body' | 'headers' | 'maxRetries' | 'timeout' | 'httpAgent' | 'fetchOptions' | 'signal' | 'idempotencyKey' | 'defaultBaseURL' | '__metadata' | '__binaryRequest' | '__binaryResponse' | '__streamClass' | '__security' | '__synthesizeEventData']?: never;
+    } | null | undefined), options?: RequestOptions): APIPromise<BetaResponse>;
+    retrieve(responseID: string, params: ResponseRetrieveParamsStreaming & ({
+        [K in 'method' | 'path' | 'query' | 'body' | 'headers' | 'maxRetries' | 'timeout' | 'httpAgent' | 'fetchOptions' | 'signal' | 'idempotencyKey' | 'defaultBaseURL' | '__metadata' | '__binaryRequest' | '__binaryResponse' | '__streamClass' | '__security' | '__synthesizeEventData']?: never;
+    } | null | undefined), options?: RequestOptions): APIPromise<Stream<BetaResponseStreamEvent>>;
+    retrieve(responseID: string, params?: (ResponseRetrieveParamsBase & ({
+        [K in 'method' | 'path' | 'query' | 'body' | 'headers' | 'maxRetries' | 'timeout' | 'httpAgent' | 'fetchOptions' | 'signal' | 'idempotencyKey' | 'defaultBaseURL' | '__metadata' | '__binaryRequest' | '__binaryResponse' | '__streamClass' | '__security' | '__synthesizeEventData']?: never;
+    } | null | undefined)) | undefined, options?: RequestOptions): APIPromise<Stream<BetaResponseStreamEvent> | BetaResponse>;
+    retrieve(responseID: string, options?: {
+        [K in 'headers' | 'maxRetries' | 'timeout' | 'signal' | 'idempotencyKey' | 'query']?: RequestOptions[K];
+    } & {
+        [K in 'method' | 'path' | 'body' | 'stream' | 'httpAgent' | 'fetchOptions' | 'defaultBaseURL' | '__metadata' | '__binaryRequest' | '__binaryResponse' | '__streamClass' | '__security' | '__synthesizeEventData']?: never;
+    }): APIPromise<BetaResponse>;
     /**
      * Deletes a model response with the given ID.
      *
@@ -7580,7 +7594,7 @@ export declare namespace BetaResponseOutputText {
  */
 export interface BetaResponseOutputTextAnnotationAddedEvent {
     /**
-     * An annotation that applies to a span of output text.
+     * The annotation object being added. (See annotation schema for details.)
      */
     annotation: BetaResponseOutputTextAnnotationAddedEvent.FileCitation | BetaResponseOutputTextAnnotationAddedEvent.URLCitation | BetaResponseOutputTextAnnotationAddedEvent.ContainerFileCitation | BetaResponseOutputTextAnnotationAddedEvent.FilePath | null;
     /**
@@ -10933,10 +10947,9 @@ export declare namespace BetaTool {
          */
         background?: 'transparent' | 'opaque' | 'auto';
         /**
-         * Control how much effort the model will exert to match the style and features,
-         * especially facial features, of input images. This parameter is only supported
-         * for `gpt-image-1` and `gpt-image-1.5` and later models, unsupported for
-         * `gpt-image-1-mini`. Supports `high` and `low`. Defaults to `low`.
+         * Controls fidelity to the original input image(s). This parameter is supported
+         * for GPT image models that support input fidelity. `gpt-image-2` and
+         * `gpt-image-2-2026-04-21` ignore this parameter.
          */
         input_fidelity?: 'high' | 'low' | null;
         /**