@google/genai 1.29.0 → 1.30.0

package/dist/genai.d.ts

@@ -1,4 +1,3 @@
-// @ts-ignore
 import type { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { GoogleAuthOptions } from 'google-auth-library';
 
@@ -1558,7 +1557,7 @@ export declare function createModelContent(partOrString: PartListUnion | string)
 /**
  * Creates a `Part` object from a `base64` encoded `string`.
  */
-export declare function createPartFromBase64(data: string, mimeType: string): Part;
+export declare function createPartFromBase64(data: string, mimeType: string, mediaResolution?: PartMediaResolutionLevel): Part;
 
 /**
  * Creates a `Part` object from the `outcome` and `output` of a `CodeExecutionResult` object.
@@ -1588,7 +1587,7 @@ export declare function createPartFromText(text: string): Part;
 /**
  * Creates a `Part` object from a `URI` string.
  */
-export declare function createPartFromUri(uri: string, mimeType: string): Part;
+export declare function createPartFromUri(uri: string, mimeType: string, mediaResolution?: PartMediaResolutionLevel): Part;
 
 /** Fine-tuning job creation request - optional fields. */
 export declare interface CreateTuningJobConfig {
@@ -2719,6 +2718,10 @@ export declare interface FunctionCall {
     args?: Record<string, unknown>;
     /** Optional. The name of the function to call. Matches [FunctionDeclaration.name]. */
     name?: string;
+    /** Optional. The partial argument value of the function call. If provided, represents the arguments/fields that are streamed incrementally. This field is not supported in Gemini API. */
+    partialArgs?: PartialArg[];
+    /** Optional. Whether this is the last part of the FunctionCall. If true, another partial message for the current FunctionCall is expected to follow. This field is not supported in Gemini API. */
+    willContinue?: boolean;
 }
 
 /** Function calling config. */
@@ -2727,6 +2730,8 @@ export declare interface FunctionCallingConfig {
     mode?: FunctionCallingConfigMode;
     /** Optional. Function names to call. Only set when the Mode is ANY. Function names should match [FunctionDeclaration.name]. With mode set to ANY, model will predict a function call from the set of function names provided. */
     allowedFunctionNames?: string[];
+    /** Optional. When set to true, arguments of a single function call will be streamed out in multiple parts/contents/responses. Partial parameter results will be returned in the [FunctionCall.partial_args] field. This field is not supported in Gemini API. */
+    streamFunctionCallArguments?: boolean;
 }
 
 /** Config for the function calling config mode. */
@@ -2801,6 +2806,9 @@ export declare class FunctionResponseBlob {
     /** Required. Inline media bytes.
      * @remarks Encoded as base64 string. */
     data?: string;
+    /** Optional. Display name of the blob.
+     Used to provide a label or filename to distinguish blobs. */
+    displayName?: string;
 }
 
 /** URI based data for function response. */
@@ -2809,6 +2817,9 @@ export declare class FunctionResponseFileData {
     fileUri?: string;
     /** Required. The IANA standard MIME type of the source data. */
     mimeType?: string;
+    /** Optional. Display name of the file.
+     Used to provide a label or filename to distinguish files. */
+    displayName?: string;
 }
 
 /** A datatype containing media that is part of a `FunctionResponse` message.
@@ -4237,6 +4248,12 @@ export declare interface ImageConfig {
      values are `1K`, `2K`, `4K`. If not specified, the model will use default
      value `1K`. */
     imageSize?: string;
+    /** MIME type of the generated image. This field is not
+     supported in Gemini API. */
+    outputMimeType?: string;
+    /** Compression quality of the generated image (for
+     ``image/jpeg`` only). This field is not supported in Gemini API. */
+    outputCompressionQuality?: number;
 }
 
 /** Enum that specifies the language of the text in the prompt. */
@@ -5632,6 +5649,28 @@ export declare interface Model {
     defaultCheckpointId?: string;
     /** The checkpoints of the model. */
     checkpoints?: Checkpoint[];
+    /** Temperature value used for sampling set when the dataset was saved.
+     This value is used to tune the degree of randomness. */
+    temperature?: number;
+    /** The maximum temperature value used for sampling set when the
+     dataset was saved. This value is used to tune the degree of randomness. */
+    maxTemperature?: number;
+    /** Optional. Specifies the nucleus sampling threshold. The model
+     considers only the smallest set of tokens whose cumulative probability is
+     at least `top_p`. This helps generate more diverse and less repetitive
+     responses. For example, a `top_p` of 0.9 means the model considers tokens
+     until the cumulative probability of the tokens to select from reaches 0.9.
+     It's recommended to adjust either temperature or `top_p`, but not both. */
+    topP?: number;
+    /** Optional. Specifies the top-k sampling threshold. The model
+     considers only the top k most probable tokens for the next token. This can
+     be useful for generating more coherent and less random text. For example,
+     a `top_k` of 40 means the model will choose the next word from the 40 most
+     likely words. */
+    topK?: number;
+    /** Whether the model supports thinking features. If true, thoughts are
+     returned only if the model supports thought and thoughts are available. */
+    thinking?: boolean;
 }
 
 export declare class Models extends BaseModule {
@@ -6249,16 +6288,17 @@ export declare class Pager<T> implements AsyncIterable<T> {
  of content being conveyed. Using multiple fields within the same `Part`
  instance is considered invalid. */
 export declare interface Part {
-    /** A predicted [FunctionCall] returned from the model that contains a string
-     representing the [FunctionDeclaration.name] and a structured JSON object
-     containing the parameters and their values. */
-    functionCall?: FunctionCall;
+    /** Media resolution for the input media.
+     */
+    mediaResolution?: PartMediaResolution;
     /** Optional. Result of executing the [ExecutableCode]. */
     codeExecutionResult?: CodeExecutionResult;
     /** Optional. Code generated by the model that is meant to be executed. */
     executableCode?: ExecutableCode;
     /** Optional. URI based data. */
     fileData?: FileData;
+    /** Optional. A predicted [FunctionCall] returned from the model that contains a string representing the [FunctionDeclaration.name] with the parameters and their values. */
+    functionCall?: FunctionCall;
     /** Optional. The result output of a [FunctionCall] that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing any output from the function call. It is used as context to the model. */
     functionResponse?: FunctionResponse;
     /** Optional. Inlined bytes data. */
@@ -6274,8 +6314,54 @@ export declare interface Part {
     videoMetadata?: VideoMetadata;
 }
 
+/** Partial argument value of the function call. This data type is not supported in Gemini API. */
+export declare interface PartialArg {
+    /** Optional. Represents a null value. */
+    nullValue?: 'NULL_VALUE';
+    /** Optional. Represents a double value. */
+    numberValue?: number;
+    /** Optional. Represents a string value. */
+    stringValue?: string;
+    /** Optional. Represents a boolean value. */
+    boolValue?: boolean;
+    /** Required. A JSON Path (RFC 9535) to the argument being streamed. https://datatracker.ietf.org/doc/html/rfc9535. e.g. "$.foo.bar[0].data". */
+    jsonPath?: string;
+    /** Optional. Whether this is not the last part of the same json_path. If true, another PartialArg message for the current json_path is expected to follow. */
+    willContinue?: boolean;
+}
+
 export declare type PartListUnion = PartUnion[] | PartUnion;
 
+/** Media resolution for the input media. */
+export declare interface PartMediaResolution {
+    /** The tokenization quality used for given media.
+     */
+    level?: PartMediaResolutionLevel;
+    /** Specifies the required sequence length for media tokenization.
+     */
+    numTokens?: number;
+}
+
+/** The tokenization quality used for given media. */
+export declare enum PartMediaResolutionLevel {
+    /**
+     * Media resolution has not been set.
+     */
+    MEDIA_RESOLUTION_UNSPECIFIED = "MEDIA_RESOLUTION_UNSPECIFIED",
+    /**
+     * Media resolution set to low.
+     */
+    MEDIA_RESOLUTION_LOW = "MEDIA_RESOLUTION_LOW",
+    /**
+     * Media resolution set to medium.
+     */
+    MEDIA_RESOLUTION_MEDIUM = "MEDIA_RESOLUTION_MEDIUM",
+    /**
+     * Media resolution set to high.
+     */
+    MEDIA_RESOLUTION_HIGH = "MEDIA_RESOLUTION_HIGH"
+}
+
 /** Tuning spec for Partner models. This data type is not supported in Gemini API. */
 export declare interface PartnerModelTuningSpec {
     /** Hyperparameters for tuning. The accepted hyper_parameters and their valid range of values will differ depending on the base model. */
@@ -7325,6 +7411,24 @@ export declare interface ThinkingConfig {
     /** Indicates the thinking budget in tokens. 0 is DISABLED. -1 is AUTOMATIC. The default values and allowed ranges are model dependent.
      */
     thinkingBudget?: number;
+    /** Optional. The level of thoughts tokens that the model should generate. */
+    thinkingLevel?: ThinkingLevel;
+}
+
+/** The level of thoughts tokens that the model should generate. */
+export declare enum ThinkingLevel {
+    /**
+     * Default value.
+     */
+    THINKING_LEVEL_UNSPECIFIED = "THINKING_LEVEL_UNSPECIFIED",
+    /**
+     * Low thinking level.
+     */
+    LOW = "LOW",
+    /**
+     * High thinking level.
+     */
+    HIGH = "HIGH"
 }
 
 export declare class Tokens extends BaseModule {
@@ -7839,6 +7943,7 @@ declare namespace types {
         AuthType,
         HttpElementLocation,
         PhishBlockThreshold,
+        ThinkingLevel,
         HarmCategory,
         HarmBlockMethod,
         HarmBlockThreshold,
@@ -7854,6 +7959,7 @@ declare namespace types {
         AdapterSize,
         JobState,
         TuningTask,
+        PartMediaResolutionLevel,
         FeatureSelectionPreference,
         Behavior,
         DynamicRetrievalConfigMode,
@@ -7883,10 +7989,12 @@ declare namespace types {
         Scale,
         MusicGenerationMode,
         LiveMusicPlaybackControl,
-        FunctionCall,
+        PartMediaResolution,
         CodeExecutionResult,
         ExecutableCode,
         FileData,
+        PartialArg,
+        FunctionCall,
         FunctionResponseBlob,
         FunctionResponseFileData,
         FunctionResponsePart,