@google/genai 1.37.0 → 1.38.0

package/dist/node/node.d.ts

@@ -121,25 +121,12 @@ export declare interface ApiAuthApiKeyConfig {
  */
 declare class ApiClient implements GeminiNextGenAPIClientAdapter {
     readonly clientOptions: ApiClientInitOptions;
+    private readonly customBaseUrl?;
     constructor(opts: ApiClientInitOptions);
-    /**
-     * Determines the base URL for Vertex AI based on project and location.
-     * Uses the global endpoint if location is 'global' or if project/location
-     * are not specified (implying API key usage).
-     * @private
-     */
-    private baseUrlFromProjectLocation;
-    /**
-     * Normalizes authentication parameters for Vertex AI.
-     * If project and location are provided, API key is cleared.
-     * If project and location are not provided (implying API key usage),
-     * project and location are cleared.
-     * @private
-     */
-    private normalizeAuthParameters;
     isVertexAI(): boolean;
     getProject(): string | undefined;
     getLocation(): string | undefined;
+    getCustomBaseUrl(): string | undefined;
     getAuthHeaders(): Promise<Headers>;
     getApiVersion(): string;
     getBaseUrl(): string;
@@ -597,7 +584,7 @@ declare interface BaseCreateAgentInteractionParams {
      */
     agent_config?: DynamicAgentConfig | DeepResearchAgentConfig;
     /**
-     * Body param: Whether to run the model interaction in the background.
+     * Body param: Input only. Whether to run the model interaction in the background.
      */
     background?: boolean;
     /**
@@ -649,7 +636,7 @@ declare interface BaseCreateModelInteractionParams {
      */
     api_version?: string;
     /**
-     * Body param: Whether to run the model interaction in the background.
+     * Body param: Input only. Whether to run the model interaction in the background.
      */
     background?: boolean;
     /**
@@ -4115,6 +4102,10 @@ export declare interface GenerateContentConfig {
      models. This field is not supported in Vertex AI.
      */
     enableEnhancedCivicAnswers?: boolean;
+    /** Settings for prompt and response sanitization using the Model Armor
+     service. If supplied, safety_settings must not be supplied.
+     */
+    modelArmorConfig?: ModelArmorConfig;
 }
 
 /** Config for models.generate_content parameters. */
@@ -5381,6 +5372,8 @@ declare type HTTPMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
 export declare interface HttpOptions {
     /** The base URL for the AI platform service endpoint. */
     baseUrl?: string;
+    /** The resource scope used to constructing the resource name when base_url is set */
+    baseUrlResourceScope?: ResourceScope;
     /** Specifies the version of the API to use. */
     apiVersion?: string;
     /** Additional HTTP headers to be sent with the request. */
@@ -7229,6 +7222,14 @@ export declare interface Model {
  */
 declare type Model_2 = 'gemini-2.5-pro' | 'gemini-2.5-flash' | 'gemini-2.5-flash-preview-09-2025' | 'gemini-2.5-flash-lite' | 'gemini-2.5-flash-lite-preview-09-2025' | 'gemini-2.5-flash-preview-native-audio-dialog' | 'gemini-2.5-flash-image-preview' | 'gemini-2.5-pro-preview-tts' | 'gemini-3-pro-preview' | 'gemini-3-flash-preview' | (string & {});
 
+/** Configuration for Model Armor integrations of prompt and responses. This data type is not supported in Gemini API. */
+export declare interface ModelArmorConfig {
+    /** Optional. The name of the Model Armor template to use for prompt sanitization. */
+    promptTemplateName?: string;
+    /** Optional. The name of the Model Armor template to use for response sanitization. */
+    responseTemplateName?: string;
+}
+
 export declare class Models extends BaseModule {
     private readonly apiClient;
     constructor(apiClient: ApiClient);
@@ -8425,6 +8426,18 @@ declare type RequestOptions = {
     __streamClass?: typeof Stream;
 };
 
+/** Resource scope. */
+export declare enum ResourceScope {
+    /**
+     * When setting base_url, this value configures resource scope to be the collection.
+     The resource name will not include api version, project, or location.
+     For example, if base_url is set to "https://aiplatform.googleapis.com",
+     then the resource name for a Model would be
+     "https://aiplatform.googleapis.com/publishers/google/models/gemini-3-pro-preview
+     */
+    COLLECTION = "COLLECTION"
+}
+
 /** Defines a retrieval tool that model can call to access external knowledge. This data type is not supported in Gemini API. */
 export declare interface Retrieval {
     /** Optional. Deprecated. This option is no longer supported. */
@@ -9879,6 +9892,7 @@ declare namespace types {
         JobState,
         TuningTask,
         PartMediaResolutionLevel,
+        ResourceScope,
         FeatureSelectionPreference,
         Environment,
         SafetyFilterLevel,
@@ -9975,6 +9989,7 @@ declare namespace types {
         GenerationConfigRoutingConfigManualRoutingMode,
         GenerationConfigRoutingConfig,
         SafetySetting,
+        ModelArmorConfig,
         GenerateContentConfig,
         GenerateContentParameters,
         HttpResponse,

package/dist/tokenizer/node.cjs

@@ -773,6 +773,18 @@ var PartMediaResolutionLevel;
      */
     PartMediaResolutionLevel["MEDIA_RESOLUTION_ULTRA_HIGH"] = "MEDIA_RESOLUTION_ULTRA_HIGH";
 })(PartMediaResolutionLevel || (PartMediaResolutionLevel = {}));
+/** Resource scope. */
+var ResourceScope;
+(function (ResourceScope) {
+    /**
+     * When setting base_url, this value configures resource scope to be the collection.
+        The resource name will not include api version, project, or location.
+        For example, if base_url is set to "https://aiplatform.googleapis.com",
+        then the resource name for a Model would be
+        "https://aiplatform.googleapis.com/publishers/google/models/gemini-3-pro-preview
+     */
+    ResourceScope["COLLECTION"] = "COLLECTION";
+})(ResourceScope || (ResourceScope = {}));
 /** Options for feature selection preference. */
 var FeatureSelectionPreference;
 (function (FeatureSelectionPreference) {

package/dist/tokenizer/node.d.ts

@@ -553,6 +553,8 @@ declare enum HttpElementLocation {
 declare interface HttpOptions {
     /** The base URL for the AI platform service endpoint. */
     baseUrl?: string;
+    /** The resource scope used to constructing the resource name when base_url is set */
+    baseUrlResourceScope?: ResourceScope;
     /** Specifies the version of the API to use. */
     apiVersion?: string;
     /** Additional HTTP headers to be sent with the request. */
@@ -881,6 +883,18 @@ declare interface ReplicatedVoiceConfig {
     voiceSampleAudio?: string;
 }
 
+/** Resource scope. */
+declare enum ResourceScope {
+    /**
+     * When setting base_url, this value configures resource scope to be the collection.
+     The resource name will not include api version, project, or location.
+     For example, if base_url is set to "https://aiplatform.googleapis.com",
+     then the resource name for a Model would be
+     "https://aiplatform.googleapis.com/publishers/google/models/gemini-3-pro-preview
+     */
+    COLLECTION = "COLLECTION"
+}
+
 /** Defines a retrieval tool that model can call to access external knowledge. This data type is not supported in Gemini API. */
 declare interface Retrieval {
     /** Optional. Deprecated. This option is no longer supported. */

package/dist/tokenizer/node.mjs

@@ -749,6 +749,18 @@ var PartMediaResolutionLevel;
      */
     PartMediaResolutionLevel["MEDIA_RESOLUTION_ULTRA_HIGH"] = "MEDIA_RESOLUTION_ULTRA_HIGH";
 })(PartMediaResolutionLevel || (PartMediaResolutionLevel = {}));
+/** Resource scope. */
+var ResourceScope;
+(function (ResourceScope) {
+    /**
+     * When setting base_url, this value configures resource scope to be the collection.
+        The resource name will not include api version, project, or location.
+        For example, if base_url is set to "https://aiplatform.googleapis.com",
+        then the resource name for a Model would be
+        "https://aiplatform.googleapis.com/publishers/google/models/gemini-3-pro-preview
+     */
+    ResourceScope["COLLECTION"] = "COLLECTION";
+})(ResourceScope || (ResourceScope = {}));
 /** Options for feature selection preference. */
 var FeatureSelectionPreference;
 (function (FeatureSelectionPreference) {