@google/genai 2.6.0 → 2.7.0

package/dist/node/node.d.ts

@@ -875,6 +875,32 @@ export declare interface AutomaticFunctionCallingConfig {
     ignoreCallHistory?: boolean;
 }
 
+/** Autorater config used for evaluation. */
+export declare interface AutoraterConfig {
+    /** Number of samples for each instance in the dataset.
+     If not specified, the default is 4. Minimum value is 1, maximum value
+     is 32. */
+    samplingCount?: number;
+    /** Optional. Default is true. Whether to flip the candidate and baseline
+     responses. This is only applicable to the pairwise metric. If enabled, also
+     provide PairwiseMetricSpec.candidate_response_field_name and
+     PairwiseMetricSpec.baseline_response_field_name. When rendering
+     PairwiseMetricSpec.metric_prompt_template, the candidate and baseline
+     fields will be flipped for half of the samples to reduce bias. */
+    flipEnabled?: boolean;
+    /** The fully qualified name of the publisher model or tuned autorater
+     endpoint to use.
+
+     Publisher model format:
+     `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`
+
+     Tuned model endpoint format:
+     `projects/{project}/locations/{location}/endpoints/{endpoint}` */
+    autoraterModel?: string;
+    /** Configuration options for model generation and outputs. */
+    generationConfig?: GenerationConfig;
+}
+
 /** Configures the avatar to be used in the session. */
 export declare interface AvatarConfig {
     /** Pre-built avatar id. */
@@ -2124,6 +2150,18 @@ export declare interface CompletionStats {
     successfulForecastPointCount?: string;
 }
 
+/** Composite reinforcement tuning reward config. */
+export declare interface CompositeReinforcementTuningRewardConfig {
+    weightedRewardConfigs?: CompositeReinforcementTuningRewardConfigWeightedRewardConfig[];
+}
+
+/** Composite reinforcement tuning reward config weighted reward config. */
+export declare interface CompositeReinforcementTuningRewardConfigWeightedRewardConfig {
+    rewardConfig?: SingleReinforcementTuningRewardConfig;
+    /** How much this single reward contributes to the total overall reward. */
+    weight?: number;
+}
+
 /** Tool to support computer use. */
 export declare interface ComputerUse {
     /** Required. The environment being operated. */
@@ -2672,7 +2710,7 @@ export declare interface CreateTuningJobConfig {
      be charged usage for any applicable operations.
      */
     abortSignal?: AbortSignal;
-    /** The method to use for tuning (SUPERVISED_FINE_TUNING or PREFERENCE_TUNING or DISTILLATION). If not set, the default method (SFT) will be used. */
+    /** The method to use for tuning (SUPERVISED_FINE_TUNING or PREFERENCE_TUNING or DISTILLATION or REINFORCEMENT_TUNING). If not set, the default method (SFT) will be used. */
     method?: TuningMethod;
     /** Validation dataset for tuning. The dataset must be formatted as a JSONL file. */
     validationDataset?: TuningValidationDataset;
@@ -2712,6 +2750,18 @@ export declare interface CreateTuningJobConfig {
     outputUri?: string;
     /** The encryption spec of the tuning job. Customer-managed encryption key options for a TuningJob. If this is set, then all resources created by the TuningJob will be encrypted with provided encryption key. */
     encryptionSpec?: EncryptionSpec;
+    /** Reward function configuration for reinforcement tuning. Reinforcement tuning only. */
+    rewardConfig?: SingleReinforcementTuningRewardConfig;
+    /** Composite reward function configuration for reinforcement tuning. Reinforcement tuning only. */
+    compositeRewardConfig?: CompositeReinforcementTuningRewardConfig;
+    /** Number of different responses to generate per prompt during tuning. Reinforcement tuning only. */
+    samplesPerPrompt?: number;
+    /** How often at steps to evaluate the tuning job during training. Reinforcement tuning only. */
+    evaluateInterval?: number;
+    /** How often at steps to save checkpoints during training. Reinforcement tuning only. */
+    checkpointInterval?: number;
+    /** The maximum number of tokens to generate per prompt. Reinforcement tuning only. */
+    maxOutputTokens?: number;
 }
 
 /** Fine-tuning job creation parameters - optional fields. */
@@ -2840,6 +2890,10 @@ declare interface DeepResearchAgentConfig {
      * will then proceed only if the user confirms the plan in the next turn.
      */
     collaborative_planning?: boolean;
+    /**
+     * Enables bigquery tool for the Deep Research agent.
+     */
+    enable_bigquery_tool?: boolean;
     /**
      * Whether to include thought summaries in the response.
      */
@@ -3119,7 +3173,7 @@ declare interface DocumentContent {
     /**
      * The mime type of the document.
      */
-    mime_type?: 'application/pdf';
+    mime_type?: 'application/pdf' | 'text/csv';
     /**
      * The URI of the document.
      */
@@ -3621,6 +3675,10 @@ declare interface ErrorEvent_2 {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: ErrorEvent_2.Metadata;
 }
 
 declare namespace ErrorEvent_2 {
@@ -3637,6 +3695,15 @@ declare namespace ErrorEvent_2 {
          */
         message?: string;
     }
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare namespace Errors {
@@ -4293,10 +4360,9 @@ declare interface Function_2 {
     parameters?: unknown;
 }
 
-/** A function call. */
+/** 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. */
 export declare interface FunctionCall {
-    /** The unique id of the function call. If populated, the client to execute the
-     `function_call` and return the response with the matching `id`. */
+    /** Optional. The unique id of the function call. If populated, the client to execute the `function_call` and return the response with the matching `id`. */
     id?: string;
     /** Optional. The function parameters and values in JSON object format. See FunctionDeclaration.parameters for parameter details. */
     args?: Record<string, unknown>;
@@ -6725,6 +6791,22 @@ declare interface InteractionCompletedEvent {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: InteractionCompletedEvent.Metadata;
+}
+
+declare namespace InteractionCompletedEvent {
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare interface InteractionCreatedEvent {
@@ -6737,6 +6819,22 @@ declare interface InteractionCreatedEvent {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: InteractionCreatedEvent.Metadata;
+}
+
+declare namespace InteractionCreatedEvent {
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare type InteractionCreateParams = CreateModelInteractionParamsNonStreaming | CreateModelInteractionParamsStreaming | CreateAgentInteractionParamsNonStreaming | CreateAgentInteractionParamsStreaming;
@@ -6895,6 +6993,22 @@ declare interface InteractionStatusUpdate {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: InteractionStatusUpdate.Metadata;
+}
+
+declare namespace InteractionStatusUpdate {
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 /** Parameters for the private _Register method. */
@@ -6990,16 +7104,11 @@ export declare enum Language {
     PYTHON = "PYTHON"
 }
 
-/** An object that represents a latitude/longitude pair.
-
- This is expressed as a pair of doubles to represent degrees latitude and
- degrees longitude. Unless specified otherwise, this object must conform to the
- <a href="https://en.wikipedia.org/wiki/World_Geodetic_System#1984_version">
- WGS84 standard</a>. Values must be within normalized ranges. */
+/** An object that represents a latitude/longitude pair. This is expressed as a pair of doubles to represent degrees latitude and degrees longitude. Unless specified otherwise, this object must conform to the WGS84 standard. Values must be within normalized ranges. */
 export declare interface LatLng {
     /** The latitude in degrees. It must be in the range [-90.0, +90.0]. */
     latitude?: number;
-    /** The longitude in degrees. It must be in the range [-180.0, +180.0] */
+    /** The longitude in degrees. It must be in the range [-180.0, +180.0]. */
     longitude?: number;
 }
 
@@ -8926,7 +9035,8 @@ export declare enum PagedItem {
     PAGED_ITEM_FILES = "files",
     PAGED_ITEM_CACHED_CONTENTS = "cachedContents",
     PAGED_ITEM_FILE_SEARCH_STORES = "fileSearchStores",
-    PAGED_ITEM_DOCUMENTS = "documents"
+    PAGED_ITEM_DOCUMENTS = "documents",
+    PAGED_ITEM_SKILLS = "skills"
 }
 
 declare interface PagedItemConfig {
@@ -8947,6 +9057,7 @@ declare interface PagedItemResponse<T> {
     cachedContents?: T[];
     fileSearchStores?: T[];
     documents?: T[];
+    skills?: T[];
 }
 
 /**
@@ -9628,6 +9739,12 @@ export declare class RegisterFilesResponse {
     files?: File_2[];
 }
 
+/** Reinforcement tuning autorater scorer. */
+export declare interface ReinforcementTuningAutoraterScorer {
+    /** Autorater config for evaluation. */
+    autoraterConfig?: AutoraterConfig;
+}
+
 /** Represents a recorded session. */
 export declare interface ReplayFile {
     replayId?: string;
@@ -9769,10 +9886,9 @@ export declare interface Retrieval {
     vertexRagStore?: VertexRagStore;
 }
 
-/** Retrieval config.
- */
+/** Retrieval config. */
 export declare interface RetrievalConfig {
-    /** Optional. The location of the user. */
+    /** The location of the user. */
     latLng?: LatLng;
     /** The language code of the user. */
     languageCode?: string;
@@ -10288,6 +10404,11 @@ export declare class SingleEmbedContentResponse {
     tokenCount?: string;
 }
 
+/** Single reinforcement tuning reward config. */
+export declare interface SingleReinforcementTuningRewardConfig {
+    autoraterScorer?: ReinforcementTuningAutoraterScorer;
+}
+
 /** Context window will be truncated by keeping only suffix of it.
 
  Context window will always be cut at start of USER role turn. System
@@ -10366,6 +10487,10 @@ declare interface StepDelta {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: StepDelta.Metadata;
 }
 
 declare namespace StepDelta {
@@ -10404,7 +10529,7 @@ declare namespace StepDelta {
     interface Document {
         type: 'document';
         data?: string;
-        mime_type?: 'application/pdf';
+        mime_type?: 'application/pdf' | 'text/csv';
         uri?: string;
     }
     interface Video {
@@ -10571,6 +10696,15 @@ declare namespace StepDelta {
         is_error?: boolean;
         name?: string;
     }
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare interface StepStart {
@@ -10584,6 +10718,22 @@ declare interface StepStart {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: StepStart.Metadata;
+}
+
+declare namespace StepStart {
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare interface StepStop {
@@ -10593,6 +10743,22 @@ declare interface StepStop {
      * The event_id token to be used to resume the interaction stream, from this event.
      */
     event_id?: string;
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    metadata?: StepStop.Metadata;
+}
+
+declare namespace StepStop {
+    /**
+     * Optional metadata accompanying ANY streamed event.
+     */
+    interface Metadata {
+        /**
+         * Statistics on the interaction request's token usage.
+         */
+        usage?: InteractionsAPI.Usage;
+    }
 }
 
 declare class Stream<Item> implements AsyncIterable<Item> {
@@ -11208,15 +11374,13 @@ declare type ToolChoiceType = 'auto' | 'any' | 'none' | 'validated';
 export declare interface ToolCodeExecution {
 }
 
-/** Tool config.
-
- This config is shared for all tools provided in the request. */
+/** Tool config. This config is shared for all tools provided in the request. */
 export declare interface ToolConfig {
     /** Optional. Retrieval config. */
     retrievalConfig?: RetrievalConfig;
     /** Optional. Function calling config. */
     functionCallingConfig?: FunctionCallingConfig;
-    /** If true, the API response will include the server-side tool calls and responses within the `Content` message. This allows clients to observe the server's tool invocations. */
+    /** Optional. If true, the API response will include the server-side tool calls and responses within the `Content` message. This allows clients to observe the server's tool interactions. This field is not supported in Vertex AI. */
     includeServerSideToolInvocations?: boolean;
 }
 
@@ -11497,7 +11661,11 @@ export declare enum TuningMethod {
     /**
      * Distillation tuning.
      */
-    DISTILLATION = "DISTILLATION"
+    DISTILLATION = "DISTILLATION",
+    /**
+     * Reinforcement tuning.
+     */
+    REINFORCEMENT_TUNING = "REINFORCEMENT_TUNING"
 }
 
 /** Tuning mode. This enum is not supported in Gemini API. */
@@ -11825,13 +11993,13 @@ declare namespace types {
         PhishBlockThreshold,
         Behavior,
         DynamicRetrievalConfigMode,
-        FunctionCallingConfigMode,
         ThinkingLevel,
         PersonGeneration,
         ProminentPeople,
         HarmCategory,
         HarmBlockMethod,
         HarmBlockThreshold,
+        FunctionCallingConfigMode,
         FinishReason,
         HarmProbability,
         HarmSeverity,
@@ -11942,10 +12110,6 @@ declare namespace types {
         StreamableHttpTransport,
         McpServer,
         Tool,
-        LatLng,
-        RetrievalConfig,
-        FunctionCallingConfig,
-        ToolConfig,
         ReplicatedVoiceConfig,
         PrebuiltVoiceConfig,
         VoiceConfig,
@@ -11960,6 +12124,10 @@ declare namespace types {
         GenerationConfigRoutingConfigManualRoutingMode,
         GenerationConfigRoutingConfig,
         SafetySetting,
+        LatLng,
+        RetrievalConfig,
+        FunctionCallingConfig,
+        ToolConfig,
         ModelArmorConfig,
         GenerateContentConfig,
         GenerateContentParameters,
@@ -12122,6 +12290,11 @@ declare namespace types {
         TuningExample,
         TuningDataset,
         TuningValidationDataset,
+        AutoraterConfig,
+        ReinforcementTuningAutoraterScorer,
+        SingleReinforcementTuningRewardConfig,
+        CompositeReinforcementTuningRewardConfigWeightedRewardConfig,
+        CompositeReinforcementTuningRewardConfig,
         CreateTuningJobConfig,
         CreateTuningJobParametersPrivate,
         TuningOperation,

package/dist/tokenizer/node.cjs

@@ -271,30 +271,6 @@ var DynamicRetrievalConfigMode;
      */
     DynamicRetrievalConfigMode["MODE_DYNAMIC"] = "MODE_DYNAMIC";
 })(DynamicRetrievalConfigMode || (DynamicRetrievalConfigMode = {}));
-/** Function calling mode. */
-var FunctionCallingConfigMode;
-(function (FunctionCallingConfigMode) {
-    /**
-     * Unspecified function calling mode. This value should not be used.
-     */
-    FunctionCallingConfigMode["MODE_UNSPECIFIED"] = "MODE_UNSPECIFIED";
-    /**
-     * Default model behavior, model decides to predict either function calls or natural language response.
-     */
-    FunctionCallingConfigMode["AUTO"] = "AUTO";
-    /**
-     * Model is constrained to always predicting function calls only. If "allowed_function_names" are set, the predicted function calls will be limited to any one of "allowed_function_names", else the predicted function calls will be any one of the provided "function_declarations".
-     */
-    FunctionCallingConfigMode["ANY"] = "ANY";
-    /**
-     * Model will not predict any function calls. Model behavior is same as when not passing any function declarations.
-     */
-    FunctionCallingConfigMode["NONE"] = "NONE";
-    /**
-     * Model is constrained to predict either function calls or natural language response. If "allowed_function_names" are set, the predicted function calls will be limited to any one of "allowed_function_names", else the predicted function calls will be any one of the provided "function_declarations".
-     */
-    FunctionCallingConfigMode["VALIDATED"] = "VALIDATED";
-})(FunctionCallingConfigMode || (FunctionCallingConfigMode = {}));
 /** The number of thoughts tokens that the model should generate. */
 var ThinkingLevel;
 (function (ThinkingLevel) {
@@ -443,6 +419,30 @@ var HarmBlockThreshold;
      */
     HarmBlockThreshold["OFF"] = "OFF";
 })(HarmBlockThreshold || (HarmBlockThreshold = {}));
+/** Function calling mode. */
+var FunctionCallingConfigMode;
+(function (FunctionCallingConfigMode) {
+    /**
+     * Unspecified function calling mode. This value should not be used.
+     */
+    FunctionCallingConfigMode["MODE_UNSPECIFIED"] = "MODE_UNSPECIFIED";
+    /**
+     * Default model behavior, model decides to predict either function calls or natural language response.
+     */
+    FunctionCallingConfigMode["AUTO"] = "AUTO";
+    /**
+     * Model is constrained to always predicting function calls only. If "allowed_function_names" are set, the predicted function calls will be limited to any one of "allowed_function_names", else the predicted function calls will be any one of the provided "function_declarations".
+     */
+    FunctionCallingConfigMode["ANY"] = "ANY";
+    /**
+     * Model will not predict any function calls. Model behavior is same as when not passing any function declarations.
+     */
+    FunctionCallingConfigMode["NONE"] = "NONE";
+    /**
+     * Model is constrained to predict either function calls or natural language response. If "allowed_function_names" are set, the predicted function calls will be limited to any one of "allowed_function_names", else the predicted function calls will be any one of the provided "function_declarations".
+     */
+    FunctionCallingConfigMode["VALIDATED"] = "VALIDATED";
+})(FunctionCallingConfigMode || (FunctionCallingConfigMode = {}));
 /** Output only. The reason why the model stopped generating tokens.
 
 If empty, the model has not stopped generating the tokens. */
@@ -1276,6 +1276,10 @@ var TuningMethod;
      * Distillation tuning.
      */
     TuningMethod["DISTILLATION"] = "DISTILLATION";
+    /**
+     * Reinforcement tuning.
+     */
+    TuningMethod["REINFORCEMENT_TUNING"] = "REINFORCEMENT_TUNING";
 })(TuningMethod || (TuningMethod = {}));
 /** State for the lifecycle of a File. */
 var FileState;

package/dist/tokenizer/node.d.ts

@@ -332,10 +332,9 @@ declare interface FileSearch {
     metadataFilter?: string;
 }
 
-/** A function call. */
+/** 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. */
 declare interface FunctionCall {
-    /** The unique id of the function call. If populated, the client to execute the
-     `function_call` and return the response with the matching `id`. */
+    /** Optional. The unique id of the function call. If populated, the client to execute the `function_call` and return the response with the matching `id`. */
     id?: string;
     /** Optional. The function parameters and values in JSON object format. See FunctionDeclaration.parameters for parameter details. */
     args?: Record<string, unknown>;

package/dist/tokenizer/node.mjs

@@ -247,30 +247,6 @@ var DynamicRetrievalConfigMode;
      */
     DynamicRetrievalConfigMode["MODE_DYNAMIC"] = "MODE_DYNAMIC";
 })(DynamicRetrievalConfigMode || (DynamicRetrievalConfigMode = {}));
-/** Function calling mode. */
-var FunctionCallingConfigMode;
-(function (FunctionCallingConfigMode) {
-    /**
-     * Unspecified function calling mode. This value should not be used.
-     */
-    FunctionCallingConfigMode["MODE_UNSPECIFIED"] = "MODE_UNSPECIFIED";
-    /**
-     * Default model behavior, model decides to predict either function calls or natural language response.
-     */
-    FunctionCallingConfigMode["AUTO"] = "AUTO";
-    /**
-     * Model is constrained to always predicting function calls only. If "allowed_function_names" are set, the predicted function calls will be limited to any one of "allowed_function_names", else the predicted function calls will be any one of the provided "function_declarations".
-     */
-    FunctionCallingConfigMode["ANY"] = "ANY";
-    /**
-     * Model will not predict any function calls. Model behavior is same as when not passing any function declarations.
-     */
-    FunctionCallingConfigMode["NONE"] = "NONE";
-    /**
-     * Model is constrained to predict either function calls or natural language response. If "allowed_function_names" are set, the predicted function calls will be limited to any one of "allowed_function_names", else the predicted function calls will be any one of the provided "function_declarations".
-     */
-    FunctionCallingConfigMode["VALIDATED"] = "VALIDATED";
-})(FunctionCallingConfigMode || (FunctionCallingConfigMode = {}));
 /** The number of thoughts tokens that the model should generate. */
 var ThinkingLevel;
 (function (ThinkingLevel) {
@@ -419,6 +395,30 @@ var HarmBlockThreshold;
      */
     HarmBlockThreshold["OFF"] = "OFF";
 })(HarmBlockThreshold || (HarmBlockThreshold = {}));
+/** Function calling mode. */
+var FunctionCallingConfigMode;
+(function (FunctionCallingConfigMode) {
+    /**
+     * Unspecified function calling mode. This value should not be used.
+     */
+    FunctionCallingConfigMode["MODE_UNSPECIFIED"] = "MODE_UNSPECIFIED";
+    /**
+     * Default model behavior, model decides to predict either function calls or natural language response.
+     */
+    FunctionCallingConfigMode["AUTO"] = "AUTO";
+    /**
+     * Model is constrained to always predicting function calls only. If "allowed_function_names" are set, the predicted function calls will be limited to any one of "allowed_function_names", else the predicted function calls will be any one of the provided "function_declarations".
+     */
+    FunctionCallingConfigMode["ANY"] = "ANY";
+    /**
+     * Model will not predict any function calls. Model behavior is same as when not passing any function declarations.
+     */
+    FunctionCallingConfigMode["NONE"] = "NONE";
+    /**
+     * Model is constrained to predict either function calls or natural language response. If "allowed_function_names" are set, the predicted function calls will be limited to any one of "allowed_function_names", else the predicted function calls will be any one of the provided "function_declarations".
+     */
+    FunctionCallingConfigMode["VALIDATED"] = "VALIDATED";
+})(FunctionCallingConfigMode || (FunctionCallingConfigMode = {}));
 /** Output only. The reason why the model stopped generating tokens.
 
 If empty, the model has not stopped generating the tokens. */
@@ -1252,6 +1252,10 @@ var TuningMethod;
      * Distillation tuning.
      */
     TuningMethod["DISTILLATION"] = "DISTILLATION";
+    /**
+     * Reinforcement tuning.
+     */
+    TuningMethod["REINFORCEMENT_TUNING"] = "REINFORCEMENT_TUNING";
 })(TuningMethod || (TuningMethod = {}));
 /** State for the lifecycle of a File. */
 var FileState;