@google/genai 2.6.0 → 2.7.0

package/dist/vertex_internal/index.d.ts

@@ -462,6 +462,32 @@ declare interface AutomaticFunctionCallingConfig {
     ignoreCallHistory?: boolean;
 }
 
+/** Autorater config used for evaluation. */
+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. */
 declare interface AvatarConfig {
     /** Pre-built avatar id. */
@@ -886,6 +912,18 @@ declare interface CompletionStats {
     successfulForecastPointCount?: string;
 }
 
+/** Composite reinforcement tuning reward config. */
+declare interface CompositeReinforcementTuningRewardConfig {
+    weightedRewardConfigs?: CompositeReinforcementTuningRewardConfigWeightedRewardConfig[];
+}
+
+/** Composite reinforcement tuning reward config weighted reward config. */
+declare interface CompositeReinforcementTuningRewardConfigWeightedRewardConfig {
+    rewardConfig?: SingleReinforcementTuningRewardConfig;
+    /** How much this single reward contributes to the total overall reward. */
+    weight?: number;
+}
+
 /** Tool to support computer use. */
 declare interface ComputerUse {
     /** Required. The environment being operated. */
@@ -1394,7 +1432,7 @@ 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;
@@ -1434,6 +1472,18 @@ 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. */
@@ -2484,10 +2534,9 @@ declare interface FullFineTuningSpec {
     validationDatasetUri?: 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>;
@@ -4308,16 +4357,11 @@ 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. */
 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;
 }
 
@@ -6073,6 +6117,12 @@ declare class RegisterFilesResponse {
     files?: File_2[];
 }
 
+/** Reinforcement tuning autorater scorer. */
+declare interface ReinforcementTuningAutoraterScorer {
+    /** Autorater config for evaluation. */
+    autoraterConfig?: AutoraterConfig;
+}
+
 /** Represents a recorded session. */
 declare interface ReplayFile {
     replayId?: string;
@@ -6138,10 +6188,9 @@ declare interface Retrieval {
     vertexRagStore?: VertexRagStore;
 }
 
-/** Retrieval config.
- */
+/** Retrieval config. */
 declare interface RetrievalConfig {
-    /** Optional. The location of the user. */
+    /** The location of the user. */
     latLng?: LatLng;
     /** The language code of the user. */
     languageCode?: string;
@@ -6498,6 +6547,11 @@ declare class SingleEmbedContentResponse {
     tokenCount?: string;
 }
 
+/** Single reinforcement tuning reward config. */
+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
@@ -6848,15 +6902,13 @@ declare interface ToolCall {
 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. */
 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;
 }
 
@@ -7137,7 +7189,11 @@ 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. */
@@ -7409,13 +7465,13 @@ declare namespace types {
         PhishBlockThreshold,
         Behavior,
         DynamicRetrievalConfigMode,
-        FunctionCallingConfigMode,
         ThinkingLevel,
         PersonGeneration,
         ProminentPeople,
         HarmCategory,
         HarmBlockMethod,
         HarmBlockThreshold,
+        FunctionCallingConfigMode,
         FinishReason,
         HarmProbability,
         HarmSeverity,
@@ -7526,10 +7582,6 @@ declare namespace types {
         StreamableHttpTransport,
         McpServer,
         Tool,
-        LatLng,
-        RetrievalConfig,
-        FunctionCallingConfig,
-        ToolConfig,
         ReplicatedVoiceConfig,
         PrebuiltVoiceConfig,
         VoiceConfig,
@@ -7544,6 +7596,10 @@ declare namespace types {
         GenerationConfigRoutingConfigManualRoutingMode,
         GenerationConfigRoutingConfig,
         SafetySetting,
+        LatLng,
+        RetrievalConfig,
+        FunctionCallingConfig,
+        ToolConfig,
         ModelArmorConfig,
         GenerateContentConfig,
         GenerateContentParameters,
@@ -7706,6 +7762,11 @@ declare namespace types {
         TuningExample,
         TuningDataset,
         TuningValidationDataset,
+        AutoraterConfig,
+        ReinforcementTuningAutoraterScorer,
+        SingleReinforcementTuningRewardConfig,
+        CompositeReinforcementTuningRewardConfigWeightedRewardConfig,
+        CompositeReinforcementTuningRewardConfig,
         CreateTuningJobConfig,
         CreateTuningJobParametersPrivate,
         TuningOperation,

package/dist/vertex_internal/index.js

@@ -566,30 +566,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) {
@@ -738,6 +714,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. */
@@ -1571,6 +1571,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;
@@ -2090,7 +2094,7 @@ const CONTENT_TYPE_HEADER = 'Content-Type';
 const SERVER_TIMEOUT_HEADER = 'X-Server-Timeout';
 const USER_AGENT_HEADER = 'User-Agent';
 const GOOGLE_API_CLIENT_HEADER = 'x-goog-api-client';
-const SDK_VERSION = '2.6.0'; // x-release-please-version
+const SDK_VERSION = '2.7.0'; // x-release-please-version
 const LIBRARY_LABEL = `google-genai-sdk/${SDK_VERSION}`;
 const VERTEX_AI_API_DEFAULT_VERSION = 'v1beta1';
 const GOOGLE_AI_API_DEFAULT_VERSION = 'v1beta';