@google/genai 2.6.0 → 2.8.0

package/dist/tokenizer/node.cjs

@@ -65,7 +65,7 @@ var Language;
      */
     Language["PYTHON"] = "PYTHON";
 })(Language || (Language = {}));
-/** Specifies how the response should be scheduled in the conversation. */
+/** Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. */
 var FunctionResponseScheduling;
 (function (FunctionResponseScheduling) {
     /**
@@ -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. */
@@ -1261,6 +1261,58 @@ var ImageResizeMode;
      */
     ImageResizeMode["PAD"] = "PAD";
 })(ImageResizeMode || (ImageResizeMode = {}));
+/** Defines how to parse sample response. */
+var ResponseParseType;
+(function (ResponseParseType) {
+    /**
+     * Default value. This value is unused.
+     */
+    ResponseParseType["RESPONSE_PARSE_TYPE_UNSPECIFIED"] = "RESPONSE_PARSE_TYPE_UNSPECIFIED";
+    /**
+     * Use the sample response as is.
+     */
+    ResponseParseType["IDENTITY"] = "IDENTITY";
+    /**
+     * Use regex to extract the important part of sample response.
+     */
+    ResponseParseType["REGEX_EXTRACT"] = "REGEX_EXTRACT";
+})(ResponseParseType || (ResponseParseType = {}));
+/** Match operation to use for evaluation. */
+var MatchOperation;
+(function (MatchOperation) {
+    /**
+     * Default value. This value is unused.
+     */
+    MatchOperation["MATCH_OPERATION_UNSPECIFIED"] = "MATCH_OPERATION_UNSPECIFIED";
+    /**
+     * Equivalent to GoogleSQL `REGEX_CONTAINS(target, expression)`.
+     */
+    MatchOperation["REGEX_CONTAINS"] = "REGEX_CONTAINS";
+    /**
+     * `expression` is a substring of target.
+     */
+    MatchOperation["PARTIAL_MATCH"] = "PARTIAL_MATCH";
+    /**
+     * `expression` is an exact match of target.
+     */
+    MatchOperation["EXACT_MATCH"] = "EXACT_MATCH";
+})(MatchOperation || (MatchOperation = {}));
+/** Represents how much to think for the tuning job. */
+var ReinforcementTuningThinkingLevel;
+(function (ReinforcementTuningThinkingLevel) {
+    /**
+     * Unspecified thinking level.
+     */
+    ReinforcementTuningThinkingLevel["REINFORCEMENT_TUNING_THINKING_LEVEL_UNSPECIFIED"] = "REINFORCEMENT_TUNING_THINKING_LEVEL_UNSPECIFIED";
+    /**
+     * Little to no thinking.
+     */
+    ReinforcementTuningThinkingLevel["MINIMAL"] = "MINIMAL";
+    /**
+     * High thinking level.
+     */
+    ReinforcementTuningThinkingLevel["HIGH"] = "HIGH";
+})(ReinforcementTuningThinkingLevel || (ReinforcementTuningThinkingLevel = {}));
 /** Enum representing the tuning method. */
 var TuningMethod;
 (function (TuningMethod) {
@@ -1276,6 +1328,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>;
@@ -365,14 +364,13 @@ declare interface FunctionDeclaration {
     behavior?: Behavior;
 }
 
-/** A function response. */
+/** The result output from a FunctionCall that contains a string representing the FunctionDeclaration.name and a structured JSON object containing any output from the function is used as context to the model. This should contain the result of a `FunctionCall` made based on model prediction. */
 declare class FunctionResponse {
-    /** Signals that function call continues, and more responses will be returned, turning the function call into a generator. Is only applicable to NON_BLOCKING function calls (see FunctionDeclaration.behavior for details), ignored otherwise. If false, the default, future responses will not be considered. Is only applicable to NON_BLOCKING function calls, is ignored otherwise. If set to false, future responses will not be considered. It is allowed to return empty `response` with `will_continue=False` to signal that the function call is finished. */
+    /** Optional. Signals that function call continues, and more responses will be returned, turning the function call into a generator. Is only applicable to NON_BLOCKING function calls, is ignored otherwise. If set to false, future responses will not be considered. It is allowed to return empty `response` with `will_continue=False` to signal that the function call is finished. This may still trigger the model generation. To avoid triggering the generation and finish the function call, additionally set `scheduling` to `SILENT`. This field is not supported in Vertex AI. */
     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. */
+    /** Optional. 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. */
+    /** Optional. Ordered `Parts` that constitute a function response. Parts may have different IANA MIME types. */
     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;
@@ -382,49 +380,36 @@ 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. */
+/** Raw media bytes for function response. Text should not be sent as raw bytes, use the 'text' field. */
 declare class FunctionResponseBlob {
     /** Required. The IANA standard MIME type of the source data. */
     mimeType?: string;
-    /** Required. Inline media bytes.
+    /** Required. Raw bytes.
      * @remarks Encoded as base64 string. */
     data?: string;
-    /** Optional. Display name of the blob.
-     Used to provide a label or filename to distinguish blobs. */
+    /** Optional. Display name of the blob. Used to provide a label or filename to distinguish blobs. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. This field is not supported in Gemini API. */
     displayName?: string;
 }
 
-/** URI based data for function response. */
+/** URI based data for function response. This data type is not supported in Gemini API. */
 declare class FunctionResponseFileData {
     /** Required. URI. */
     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. */
+    /** Optional. Display name of the file data. Used to provide a label or filename to distinguish file datas. This field is only returned in PromptMessage for prompt management. It is currently used in the Gemini GenerateContent calls only when server side tools (code_execution, google_search, and url_context) are enabled. */
     displayName?: 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. */
+/** 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. */
 declare class FunctionResponsePart {
-    /** Optional. Inline media bytes. */
+    /** Inline media bytes. */
     inlineData?: FunctionResponseBlob;
-    /** Optional. URI based data. */
+    /** URI based data. This field is not supported in Gemini API. */
     fileData?: FunctionResponseFileData;
 }
 
-/** Specifies how the response should be scheduled in the conversation. */
+/** Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. */
 declare enum FunctionResponseScheduling {
     /**
      * This value is unused.
@@ -520,7 +505,7 @@ declare interface GenerationConfigRoutingConfigManualRoutingMode {
 declare interface GoogleMaps {
     /** The authentication config to access the API. Only API key is supported. This field is not supported in Gemini API. */
     authConfig?: AuthConfig;
-    /** Optional. Whether to return a widget context token in the GroundingMetadata of the response. Developers can use the widget context token to render a Google Maps widget with geospatial context related to the places that the model references in the response. */
+    /** Deprecated. The Google Maps contextual widget behavior in Grounding with Google Maps is being deprecated; this field is planned for removal and no longer has any effect once removed. Optional. Whether to return a widget context token in the GroundingMetadata of the response. */
     enableWidget?: boolean;
 }
 

package/dist/tokenizer/node.mjs

@@ -41,7 +41,7 @@ var Language;
      */
     Language["PYTHON"] = "PYTHON";
 })(Language || (Language = {}));
-/** Specifies how the response should be scheduled in the conversation. */
+/** Specifies how the response should be scheduled in the conversation. Only applicable to NON_BLOCKING function calls, is ignored otherwise. Defaults to WHEN_IDLE. */
 var FunctionResponseScheduling;
 (function (FunctionResponseScheduling) {
     /**
@@ -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. */
@@ -1237,6 +1237,58 @@ var ImageResizeMode;
      */
     ImageResizeMode["PAD"] = "PAD";
 })(ImageResizeMode || (ImageResizeMode = {}));
+/** Defines how to parse sample response. */
+var ResponseParseType;
+(function (ResponseParseType) {
+    /**
+     * Default value. This value is unused.
+     */
+    ResponseParseType["RESPONSE_PARSE_TYPE_UNSPECIFIED"] = "RESPONSE_PARSE_TYPE_UNSPECIFIED";
+    /**
+     * Use the sample response as is.
+     */
+    ResponseParseType["IDENTITY"] = "IDENTITY";
+    /**
+     * Use regex to extract the important part of sample response.
+     */
+    ResponseParseType["REGEX_EXTRACT"] = "REGEX_EXTRACT";
+})(ResponseParseType || (ResponseParseType = {}));
+/** Match operation to use for evaluation. */
+var MatchOperation;
+(function (MatchOperation) {
+    /**
+     * Default value. This value is unused.
+     */
+    MatchOperation["MATCH_OPERATION_UNSPECIFIED"] = "MATCH_OPERATION_UNSPECIFIED";
+    /**
+     * Equivalent to GoogleSQL `REGEX_CONTAINS(target, expression)`.
+     */
+    MatchOperation["REGEX_CONTAINS"] = "REGEX_CONTAINS";
+    /**
+     * `expression` is a substring of target.
+     */
+    MatchOperation["PARTIAL_MATCH"] = "PARTIAL_MATCH";
+    /**
+     * `expression` is an exact match of target.
+     */
+    MatchOperation["EXACT_MATCH"] = "EXACT_MATCH";
+})(MatchOperation || (MatchOperation = {}));
+/** Represents how much to think for the tuning job. */
+var ReinforcementTuningThinkingLevel;
+(function (ReinforcementTuningThinkingLevel) {
+    /**
+     * Unspecified thinking level.
+     */
+    ReinforcementTuningThinkingLevel["REINFORCEMENT_TUNING_THINKING_LEVEL_UNSPECIFIED"] = "REINFORCEMENT_TUNING_THINKING_LEVEL_UNSPECIFIED";
+    /**
+     * Little to no thinking.
+     */
+    ReinforcementTuningThinkingLevel["MINIMAL"] = "MINIMAL";
+    /**
+     * High thinking level.
+     */
+    ReinforcementTuningThinkingLevel["HIGH"] = "HIGH";
+})(ReinforcementTuningThinkingLevel || (ReinforcementTuningThinkingLevel = {}));
 /** Enum representing the tuning method. */
 var TuningMethod;
 (function (TuningMethod) {
@@ -1252,6 +1304,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;