@google/genai 1.46.0 → 1.47.0

package/dist/tokenizer/node.cjs

@@ -121,38 +121,18 @@ var Type;
      */
     Type["NULL"] = "NULL";
 })(Type || (Type = {}));
-/** Sites with confidence level chosen & above this value will be blocked from the search results. This enum is not supported in Gemini API. */
-var PhishBlockThreshold;
-(function (PhishBlockThreshold) {
-    /**
-     * Defaults to unspecified.
-     */
-    PhishBlockThreshold["PHISH_BLOCK_THRESHOLD_UNSPECIFIED"] = "PHISH_BLOCK_THRESHOLD_UNSPECIFIED";
-    /**
-     * Blocks Low and above confidence URL that is risky.
-     */
-    PhishBlockThreshold["BLOCK_LOW_AND_ABOVE"] = "BLOCK_LOW_AND_ABOVE";
-    /**
-     * Blocks Medium and above confidence URL that is risky.
-     */
-    PhishBlockThreshold["BLOCK_MEDIUM_AND_ABOVE"] = "BLOCK_MEDIUM_AND_ABOVE";
-    /**
-     * Blocks High and above confidence URL that is risky.
-     */
-    PhishBlockThreshold["BLOCK_HIGH_AND_ABOVE"] = "BLOCK_HIGH_AND_ABOVE";
-    /**
-     * Blocks Higher and above confidence URL that is risky.
-     */
-    PhishBlockThreshold["BLOCK_HIGHER_AND_ABOVE"] = "BLOCK_HIGHER_AND_ABOVE";
+/** The environment being operated. */
+var Environment;
+(function (Environment) {
     /**
-     * Blocks Very high and above confidence URL that is risky.
+     * Defaults to browser.
      */
-    PhishBlockThreshold["BLOCK_VERY_HIGH_AND_ABOVE"] = "BLOCK_VERY_HIGH_AND_ABOVE";
+    Environment["ENVIRONMENT_UNSPECIFIED"] = "ENVIRONMENT_UNSPECIFIED";
     /**
-     * Blocks Extremely high confidence URL that is risky.
+     * Operates in a web browser.
      */
-    PhishBlockThreshold["BLOCK_ONLY_EXTREMELY_HIGH"] = "BLOCK_ONLY_EXTREMELY_HIGH";
-})(PhishBlockThreshold || (PhishBlockThreshold = {}));
+    Environment["ENVIRONMENT_BROWSER"] = "ENVIRONMENT_BROWSER";
+})(Environment || (Environment = {}));
 /** Type of auth scheme. This enum is not supported in Gemini API. */
 var AuthType;
 (function (AuthType) {
@@ -223,6 +203,38 @@ var ApiSpec;
      */
     ApiSpec["ELASTIC_SEARCH"] = "ELASTIC_SEARCH";
 })(ApiSpec || (ApiSpec = {}));
+/** Sites with confidence level chosen & above this value will be blocked from the search results. This enum is not supported in Gemini API. */
+var PhishBlockThreshold;
+(function (PhishBlockThreshold) {
+    /**
+     * Defaults to unspecified.
+     */
+    PhishBlockThreshold["PHISH_BLOCK_THRESHOLD_UNSPECIFIED"] = "PHISH_BLOCK_THRESHOLD_UNSPECIFIED";
+    /**
+     * Blocks Low and above confidence URL that is risky.
+     */
+    PhishBlockThreshold["BLOCK_LOW_AND_ABOVE"] = "BLOCK_LOW_AND_ABOVE";
+    /**
+     * Blocks Medium and above confidence URL that is risky.
+     */
+    PhishBlockThreshold["BLOCK_MEDIUM_AND_ABOVE"] = "BLOCK_MEDIUM_AND_ABOVE";
+    /**
+     * Blocks High and above confidence URL that is risky.
+     */
+    PhishBlockThreshold["BLOCK_HIGH_AND_ABOVE"] = "BLOCK_HIGH_AND_ABOVE";
+    /**
+     * Blocks Higher and above confidence URL that is risky.
+     */
+    PhishBlockThreshold["BLOCK_HIGHER_AND_ABOVE"] = "BLOCK_HIGHER_AND_ABOVE";
+    /**
+     * Blocks Very high and above confidence URL that is risky.
+     */
+    PhishBlockThreshold["BLOCK_VERY_HIGH_AND_ABOVE"] = "BLOCK_VERY_HIGH_AND_ABOVE";
+    /**
+     * Blocks Extremely high confidence URL that is risky.
+     */
+    PhishBlockThreshold["BLOCK_ONLY_EXTREMELY_HIGH"] = "BLOCK_ONLY_EXTREMELY_HIGH";
+})(PhishBlockThreshold || (PhishBlockThreshold = {}));
 /** Specifies the function Behavior. Currently only supported by the BidiGenerateContent method. This enum is not supported in Vertex AI. */
 var Behavior;
 (function (Behavior) {
@@ -282,6 +294,10 @@ var ThinkingLevel;
      * Unspecified thinking level.
      */
     ThinkingLevel["THINKING_LEVEL_UNSPECIFIED"] = "THINKING_LEVEL_UNSPECIFIED";
+    /**
+     * MINIMAL thinking level.
+     */
+    ThinkingLevel["MINIMAL"] = "MINIMAL";
     /**
      * Low thinking level.
      */
@@ -294,10 +310,6 @@ var ThinkingLevel;
      * High thinking level.
      */
     ThinkingLevel["HIGH"] = "HIGH";
-    /**
-     * MINIMAL thinking level.
-     */
-    ThinkingLevel["MINIMAL"] = "MINIMAL";
 })(ThinkingLevel || (ThinkingLevel = {}));
 /** Enum that controls the generation of people. */
 var PersonGeneration;
@@ -315,6 +327,22 @@ var PersonGeneration;
      */
     PersonGeneration["ALLOW_ALL"] = "ALLOW_ALL";
 })(PersonGeneration || (PersonGeneration = {}));
+/** Controls whether prominent people (celebrities) generation is allowed. If used with personGeneration, personGeneration enum would take precedence. For instance, if ALLOW_NONE is set, all person generation would be blocked. If this field is unspecified, the default behavior is to allow prominent people. This enum is not supported in Gemini API. */
+var ProminentPeople;
+(function (ProminentPeople) {
+    /**
+     * Unspecified value. The model will proceed with the default behavior, which is to allow generation of prominent people.
+     */
+    ProminentPeople["PROMINENT_PEOPLE_UNSPECIFIED"] = "PROMINENT_PEOPLE_UNSPECIFIED";
+    /**
+     * Allows the model to generate images of prominent people.
+     */
+    ProminentPeople["ALLOW_PROMINENT_PEOPLE"] = "ALLOW_PROMINENT_PEOPLE";
+    /**
+     * Prevents the model from generating images of prominent people.
+     */
+    ProminentPeople["BLOCK_PROMINENT_PEOPLE"] = "BLOCK_PROMINENT_PEOPLE";
+})(ProminentPeople || (ProminentPeople = {}));
 /** The harm category to be blocked. */
 var HarmCategory;
 (function (HarmCategory) {
@@ -633,6 +661,42 @@ var Modality;
      */
     Modality["AUDIO"] = "AUDIO";
 })(Modality || (Modality = {}));
+/** The stage of the underlying model. This enum is not supported in Vertex AI. */
+var ModelStage;
+(function (ModelStage) {
+    /**
+     * Unspecified model stage.
+     */
+    ModelStage["MODEL_STAGE_UNSPECIFIED"] = "MODEL_STAGE_UNSPECIFIED";
+    /**
+     * The underlying model is subject to lots of tunings.
+     */
+    ModelStage["UNSTABLE_EXPERIMENTAL"] = "UNSTABLE_EXPERIMENTAL";
+    /**
+     * Models in this stage are for experimental purposes only.
+     */
+    ModelStage["EXPERIMENTAL"] = "EXPERIMENTAL";
+    /**
+     * Models in this stage are more mature than experimental models.
+     */
+    ModelStage["PREVIEW"] = "PREVIEW";
+    /**
+     * Models in this stage are considered stable and ready for production use.
+     */
+    ModelStage["STABLE"] = "STABLE";
+    /**
+     * If the model is on this stage, it means that this model is on the path to deprecation in near future. Only existing customers can use this model.
+     */
+    ModelStage["LEGACY"] = "LEGACY";
+    /**
+     * Models in this stage are deprecated. These models cannot be used.
+     */
+    ModelStage["DEPRECATED"] = "DEPRECATED";
+    /**
+     * Models in this stage are retired. These models cannot be used.
+     */
+    ModelStage["RETIRED"] = "RETIRED";
+})(ModelStage || (ModelStage = {}));
 /** The media resolution to use. */
 var MediaResolution;
 (function (MediaResolution) {
@@ -869,6 +933,26 @@ var TuningTask;
      */
     TuningTask["TUNING_TASK_R2V"] = "TUNING_TASK_R2V";
 })(TuningTask || (TuningTask = {}));
+/** Output only. Current state of the `Document`. This enum is not supported in Vertex AI. */
+var DocumentState;
+(function (DocumentState) {
+    /**
+     * The default value. This value is used if the state is omitted.
+     */
+    DocumentState["STATE_UNSPECIFIED"] = "STATE_UNSPECIFIED";
+    /**
+     * Some `Chunks` of the `Document` are being processed (embedding and vector storage).
+     */
+    DocumentState["STATE_PENDING"] = "STATE_PENDING";
+    /**
+     * All `Chunks` of the `Document` is processed and available for querying.
+     */
+    DocumentState["STATE_ACTIVE"] = "STATE_ACTIVE";
+    /**
+     * Some `Chunks` of the `Document` failed processing.
+     */
+    DocumentState["STATE_FAILED"] = "STATE_FAILED";
+})(DocumentState || (DocumentState = {}));
 /** The tokenization quality used for given media. */
 var PartMediaResolutionLevel;
 (function (PartMediaResolutionLevel) {
@@ -933,42 +1017,34 @@ var ResourceScope;
      */
     ResourceScope["COLLECTION"] = "COLLECTION";
 })(ResourceScope || (ResourceScope = {}));
-/** Options for feature selection preference. */
-var FeatureSelectionPreference;
-(function (FeatureSelectionPreference) {
-    FeatureSelectionPreference["FEATURE_SELECTION_PREFERENCE_UNSPECIFIED"] = "FEATURE_SELECTION_PREFERENCE_UNSPECIFIED";
-    FeatureSelectionPreference["PRIORITIZE_QUALITY"] = "PRIORITIZE_QUALITY";
-    FeatureSelectionPreference["BALANCED"] = "BALANCED";
-    FeatureSelectionPreference["PRIORITIZE_COST"] = "PRIORITIZE_COST";
-})(FeatureSelectionPreference || (FeatureSelectionPreference = {}));
-/** The environment being operated. */
-var Environment;
-(function (Environment) {
+/** Pricing and performance service tier. */
+var ServiceTier;
+(function (ServiceTier) {
     /**
-     * Defaults to browser.
+     * Default service tier, which is standard.
      */
-    Environment["ENVIRONMENT_UNSPECIFIED"] = "ENVIRONMENT_UNSPECIFIED";
+    ServiceTier["SERVICE_TIER_UNSPECIFIED"] = "SERVICE_TIER_UNSPECIFIED";
     /**
-     * Operates in a web browser.
+     * Flex service tier.
      */
-    Environment["ENVIRONMENT_BROWSER"] = "ENVIRONMENT_BROWSER";
-})(Environment || (Environment = {}));
-/** Enum for controlling whether the model can generate images of prominent people (celebrities). */
-var ProminentPeople;
-(function (ProminentPeople) {
+    ServiceTier["SERVICE_TIER_FLEX"] = "SERVICE_TIER_FLEX";
     /**
-     * Unspecified value. The model will proceed with the default behavior, which is to allow generation of prominent people.
+     * Standard service tier.
      */
-    ProminentPeople["PROMINENT_PEOPLE_UNSPECIFIED"] = "PROMINENT_PEOPLE_UNSPECIFIED";
+    ServiceTier["SERVICE_TIER_STANDARD"] = "SERVICE_TIER_STANDARD";
     /**
-     * Allows the model to generate images of prominent people.
+     * Priority service tier.
      */
-    ProminentPeople["ALLOW_PROMINENT_PEOPLE"] = "ALLOW_PROMINENT_PEOPLE";
-    /**
-     * Prevents the model from generating images of prominent people.
-     */
-    ProminentPeople["BLOCK_PROMINENT_PEOPLE"] = "BLOCK_PROMINENT_PEOPLE";
-})(ProminentPeople || (ProminentPeople = {}));
+    ServiceTier["SERVICE_TIER_PRIORITY"] = "SERVICE_TIER_PRIORITY";
+})(ServiceTier || (ServiceTier = {}));
+/** Options for feature selection preference. */
+var FeatureSelectionPreference;
+(function (FeatureSelectionPreference) {
+    FeatureSelectionPreference["FEATURE_SELECTION_PREFERENCE_UNSPECIFIED"] = "FEATURE_SELECTION_PREFERENCE_UNSPECIFIED";
+    FeatureSelectionPreference["PRIORITIZE_QUALITY"] = "PRIORITIZE_QUALITY";
+    FeatureSelectionPreference["BALANCED"] = "BALANCED";
+    FeatureSelectionPreference["PRIORITIZE_COST"] = "PRIORITIZE_COST";
+})(FeatureSelectionPreference || (FeatureSelectionPreference = {}));
 /** Enum representing the Vertex embedding API to use. */
 var EmbeddingApiType;
 (function (EmbeddingApiType) {
@@ -1143,14 +1219,6 @@ var TuningMethod;
      */
     TuningMethod["DISTILLATION"] = "DISTILLATION";
 })(TuningMethod || (TuningMethod = {}));
-/** State for the lifecycle of a Document. */
-var DocumentState;
-(function (DocumentState) {
-    DocumentState["STATE_UNSPECIFIED"] = "STATE_UNSPECIFIED";
-    DocumentState["STATE_PENDING"] = "STATE_PENDING";
-    DocumentState["STATE_ACTIVE"] = "STATE_ACTIVE";
-    DocumentState["STATE_FAILED"] = "STATE_FAILED";
-})(DocumentState || (DocumentState = {}));
 /** State for the lifecycle of a File. */
 var FileState;
 (function (FileState) {
@@ -1310,6 +1378,10 @@ var TurnCoverage;
      * The users turn includes all realtime input since the last turn, including inactivity (e.g. silence on the audio stream).
      */
     TurnCoverage["TURN_INCLUDES_ALL_INPUT"] = "TURN_INCLUDES_ALL_INPUT";
+    /**
+     * Includes audio activity and all video since the last turn. With automatic activity detection, audio activity means speech and excludes silence.
+     */
+    TurnCoverage["TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO"] = "TURN_INCLUDES_AUDIO_ACTIVITY_AND_ALL_VIDEO";
 })(TurnCoverage || (TurnCoverage = {}));
 /** Scale of the generated music. */
 var Scale;

package/dist/tokenizer/node.d.ts

@@ -317,14 +317,13 @@ declare interface FileData {
     mimeType?: string;
 }
 
-/** Tool to retrieve knowledge from the File Search Stores. */
+/** The FileSearch tool that retrieves knowledge from Semantic Retrieval corpora. Files are imported to Semantic Retrieval corpora using the ImportFile API. This data type is not supported in Vertex AI. */
 declare interface FileSearch {
-    /** The names of the file_search_stores to retrieve from.
-     Example: `fileSearchStores/my-file-search-store-123` */
+    /** Required. The names of the file_search_stores to retrieve from. Example: `fileSearchStores/my-file-search-store-123` */
     fileSearchStoreNames?: string[];
-    /** The number of file search retrieval chunks to retrieve. */
+    /** Optional. The number of semantic retrieval chunks to retrieve. */
     topK?: number;
-    /** Metadata filter to apply to the file search retrieval documents. See https://google.aip.dev/160 for the syntax of the filter expression. */
+    /** Optional. Metadata filter to apply to the semantic retrieval documents and chunks. */
     metadataFilter?: string;
 }
 
@@ -520,9 +519,9 @@ declare interface GoogleMaps {
     enableWidget?: boolean;
 }
 
-/** Tool to support web search. */
+/** GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
 declare interface GoogleSearch {
-    /** Different types of search that can be enabled on the GoogleSearch tool. */
+    /** Optional. The set of search types to enable. If not set, web search is enabled by default. */
     searchTypes?: SearchTypes;
     /** Optional. Sites with confidence level chosen & above this value will be blocked from the search results. This field is not supported in Gemini API. */
     blockingConfidence?: PhishBlockThreshold;
@@ -771,6 +770,8 @@ declare interface Part {
     toolCall?: ToolCall;
     /** The output from a server-side ToolCall execution. This field is populated by the client with the results of executing the corresponding ToolCall. */
     toolResponse?: ToolResponse;
+    /** Custom metadata associated with the Part. Agents using genai.Part as content representation may need to keep track of the additional information. For example it can be name of a file/source from which the Part originates or a way to multiplex multiple Part streams. This field is not supported in Vertex AI. */
+    partMetadata?: Record<string, unknown>;
 }
 
 /** Partial argument value of the function call. This data type is not supported in Gemini API. */
@@ -911,12 +912,14 @@ declare interface RagRetrievalConfigRankingRankService {
     modelName?: string;
 }
 
-/** ReplicatedVoiceConfig is used to configure replicated voice. */
+/** The configuration for the replicated voice to use. */
 declare interface ReplicatedVoiceConfig {
-    /** The mime type of the replicated voice.
+    /** The mimetype of the voice sample. The only currently supported
+     value is `audio/wav`. This represents 16-bit signed little-endian wav
+     data, with a 24kHz sampling rate.
      */
     mimeType?: string;
-    /** The sample audio of the replicated voice.
+    /** The sample of the custom voice.
 
      * @remarks Encoded as base64 string. */
     voiceSampleAudio?: string;
@@ -956,7 +959,7 @@ declare interface Schema {
     anyOf?: Schema[];
     /** Optional. Default value to use if the field is not specified. */
     default?: unknown;
-    /** Optional. Description of the schema. */
+    /** Optional. Describes the data. The model uses this field to understand the purpose of the schema and how to use it. It is a best practice to provide a clear and descriptive explanation for the schema and its properties here, rather than in the prompt. */
     description?: string;
     /** Optional. Possible values of the field. This field can be used to restrict a value to a fixed set of values. To mark a field as an enum, set `format` to `enum` and provide the list of possible values in `enum`. For example: 1. To define directions: `{type:STRING, format:enum, enum:["EAST", "NORTH", "SOUTH", "WEST"]}` 2. To define apartment numbers: `{type:INTEGER, format:enum, enum:["101", "201", "301"]}` */
     enum?: string[];
@@ -998,12 +1001,11 @@ declare interface Schema {
     type?: Type;
 }
 
-/** Tool to support computer use. */
+/** Different types of search that can be enabled on the GoogleSearch tool. */
 declare interface SearchTypes {
-    /** Setting this field enables web search. Only text results are
-     returned. */
+    /** Optional. Setting this field enables web search. Only text results are returned. */
     webSearch?: WebSearch;
-    /** Setting this field enables image search. Image bytes are returned. */
+    /** Optional. Setting this field enables image search. Image bytes are returned. */
     imageSearch?: ImageSearch;
 }
 
@@ -1015,8 +1017,9 @@ declare interface SpeakerVoiceConfig {
     voiceConfig?: VoiceConfig;
 }
 
+/** Config for speech generation and transcription. */
 declare interface SpeechConfig {
-    /** Configuration for the voice of the response. */
+    /** The configuration in case of single-voice output. */
     voiceConfig?: VoiceConfig;
     /** Optional. The language code (ISO 639-1) for the speech synthesis. */
     languageCode?: string;
@@ -1056,6 +1059,10 @@ declare enum ThinkingLevel {
      * Unspecified thinking level.
      */
     THINKING_LEVEL_UNSPECIFIED = "THINKING_LEVEL_UNSPECIFIED",
+    /**
+     * MINIMAL thinking level.
+     */
+    MINIMAL = "MINIMAL",
     /**
      * Low thinking level.
      */
@@ -1067,11 +1074,7 @@ declare enum ThinkingLevel {
     /**
      * High thinking level.
      */
-    HIGH = "HIGH",
-    /**
-     * MINIMAL thinking level.
-     */
-    MINIMAL = "MINIMAL"
+    HIGH = "HIGH"
 }
 
 /** Tokens info with a list of tokens and the corresponding list of token ids. */
@@ -1093,9 +1096,9 @@ declare interface Tool {
      computer. If enabled, it automatically populates computer-use specific
      Function Declarations. */
     computerUse?: ComputerUse;
-    /** Optional. Tool to retrieve knowledge from the File Search Stores. */
+    /** Optional. FileSearch tool type. Tool to retrieve knowledge from Semantic Retrieval corpora. This field is not supported in Vertex AI. */
     fileSearch?: FileSearch;
-    /** Enables the model to execute Google Search as part of generation. */
+    /** Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google. */
     googleSearch?: GoogleSearch;
     /** Optional. Tool that allows grounding the model's response with
      geospatial context related to the user's query. */
@@ -1282,16 +1285,17 @@ declare interface VideoMetadata {
     startOffset?: string;
 }
 
+/** The configuration for the voice to use. */
 declare interface VoiceConfig {
-    /** If true, the model will use a replicated voice for the response. */
+    /** The configuration for a replicated voice, which is a clone of a
+     user's voice that can be used for speech synthesis. If this is unset, a
+     default voice is used. */
     replicatedVoiceConfig?: ReplicatedVoiceConfig;
     /** The configuration for a prebuilt voice. */
     prebuiltVoiceConfig?: PrebuiltVoiceConfig;
 }
 
-/** Standard web search for grounding and related configurations.
-
- Only text results are returned. */
+/** Standard web search for grounding and related configurations. Only text results are returned. */
 declare interface WebSearch {
 }