@google/genai 1.20.0 → 1.21.0

package/dist/genai.d.ts

@@ -1137,6 +1137,23 @@ export declare interface ContentEmbeddingStatistics {
 
 export declare type ContentListUnion = Content | Content[] | PartUnion | PartUnion[];
 
+/** A content reference image.
+
+ A content reference image represents a subject to reference (ex. person,
+ product, animal) provided by the user. It can optionally be provided in
+ addition to a style reference image (ex. background, style reference).
+ */
+export declare class ContentReferenceImage {
+    /** The reference image for the editing operation. */
+    referenceImage?: Image_2;
+    /** The id of the reference image. */
+    referenceId?: number;
+    /** The type of the reference image. Only set by the SDK. */
+    referenceType?: string;
+    /** Internal method to convert to ReferenceImageAPIInternal. */
+    toReferenceImageAPI(): ReferenceImageAPIInternal;
+}
+
 export declare type ContentUnion = Content | PartUnion[] | PartUnion;
 
 /** Enables context window compression -- mechanism managing model context window so it does not exceed given length. */
@@ -2401,6 +2418,9 @@ export declare class FunctionResponse {
     willContinue?: boolean;
     /** Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. */
     scheduling?: FunctionResponseScheduling;
+    /** List of parts that constitute a function response. Each part may
+     have a different IANA MIME type. */
+    parts?: FunctionResponsePart[];
     /** Optional. The id of the function call this response is for. Populated by the client to match the corresponding function call `id`. */
     id?: string;
     /** Required. The name of the function to call. Matches [FunctionDeclaration.name] and [FunctionCall.name]. */
@@ -2409,6 +2429,44 @@ export declare class FunctionResponse {
     response?: Record<string, unknown>;
 }
 
+/** Raw media bytes for function response.
+
+ Text should not be sent as raw bytes, use the FunctionResponse.response
+ field.
+ */
+export declare class FunctionResponseBlob {
+    /** Required. The IANA standard MIME type of the source data. */
+    mimeType?: string;
+    /** Required. Inline media bytes.
+     * @remarks Encoded as base64 string. */
+    data?: string;
+}
+
+/** URI based data for function response. */
+export declare class FunctionResponseFileData {
+    /** Required. URI. */
+    fileUri?: string;
+    /** Required. The IANA standard MIME type of the source data. */
+    mimeType?: string;
+}
+
+/** A datatype containing media that is part of a `FunctionResponse` message.
+
+ A `FunctionResponsePart` consists of data which has an associated datatype. A
+ `FunctionResponsePart` can only contain one of the accepted types in
+ `FunctionResponsePart.data`.
+
+ A `FunctionResponsePart` must have a fixed IANA MIME type identifying the
+ type and subtype of the media if the `inline_data` field is filled with raw
+ bytes.
+ */
+export declare class FunctionResponsePart {
+    /** Optional. Inline media bytes. */
+    inlineData?: FunctionResponseBlob;
+    /** Optional. URI based data. */
+    fileData?: FunctionResponseFileData;
+}
+
 /** Specifies how the response should be scheduled in the conversation. */
 export declare enum FunctionResponseScheduling {
     /**
@@ -5873,7 +5931,7 @@ export declare interface RecontextImageSource {
     productImages?: ProductImage[];
 }
 
-export declare type ReferenceImage = RawReferenceImage | MaskReferenceImage | ControlReferenceImage | StyleReferenceImage | SubjectReferenceImage;
+export declare type ReferenceImage = RawReferenceImage | MaskReferenceImage | ControlReferenceImage | StyleReferenceImage | SubjectReferenceImage | ContentReferenceImage;
 
 /** Private class that represents a Reference image that is sent to API. */
 declare interface ReferenceImageAPIInternal {
@@ -6770,6 +6828,12 @@ export declare interface ToolCodeExecution {
 export declare interface ToolComputerUse {
     /** Required. The environment being operated. */
     environment?: Environment;
+    /** By default, predefined functions are included in the final model call.
+     Some of them can be explicitly excluded from being automatically included.
+     This can serve two purposes:
+     1. Using a more restricted / different action space.
+     2. Improving the definitions / instructions of predefined functions. */
+    excludedPredefinedFunctions?: string[];
 }
 
 /** Tool config.
@@ -7153,6 +7217,9 @@ declare namespace types {
         FunctionCall,
         CodeExecutionResult,
         ExecutableCode,
+        FunctionResponseBlob,
+        FunctionResponseFileData,
+        FunctionResponsePart,
         FunctionResponse,
         Part,
         Content,
@@ -7409,6 +7476,7 @@ declare namespace types {
         ControlReferenceImage,
         StyleReferenceImage,
         SubjectReferenceImage,
+        ContentReferenceImage,
         LiveServerSetupComplete,
         Transcription,
         LiveServerContent,