@langchain/google-common 0.2.15 → 0.2.16

package/dist/chat_models.cjs

@@ -242,6 +242,12 @@ class ChatGoogleBase extends chat_models_1.BaseChatModel {
             writable: true,
             value: false
         });
+        Object.defineProperty(this, "labels", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "connection", {
             enumerable: true,
             configurable: true,

package/dist/chat_models.d.ts

@@ -55,6 +55,7 @@ export declare abstract class ChatGoogleBase<AuthOptions> extends BaseChatModel<
     speechConfig: GoogleSpeechConfig;
     streamUsage: boolean;
     streaming: boolean;
+    labels?: Record<string, string>;
     protected connection: ChatConnection<AuthOptions>;
     protected streamedConnection: ChatConnection<AuthOptions>;
     constructor(fields?: ChatGoogleBaseInput<AuthOptions>);

package/dist/chat_models.js

@@ -238,6 +238,12 @@ export class ChatGoogleBase extends BaseChatModel {
             writable: true,
             value: false
         });
+        Object.defineProperty(this, "labels", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "connection", {
             enumerable: true,
             configurable: true,

package/dist/connection.cjs

@@ -282,12 +282,7 @@ class GoogleAIConnection extends GoogleHostConnection {
     get computedLocation() {
         switch (this.apiName) {
             case "google":
-                if (this.modelName.startsWith("gemini-2.5-flash-lite")) {
-                    return "global";
-                }
-                else {
-                    return super.computedLocation;
-                }
+                return super.computedLocation;
             case "anthropic":
                 return "us-east5";
             default:
@@ -375,7 +370,13 @@ class AbstractGoogleLLMConnection extends GoogleAIConnection {
         }
     }
     async formatData(input, parameters) {
-        return this.api.formatData(input, parameters);
+        // Filter out labels for non-Vertex AI platforms (labels are only supported on Vertex AI)
+        let filteredParameters = parameters;
+        if (parameters.labels && this.platform !== "gcp") {
+            const { labels, ...paramsWithoutLabels } = parameters;
+            filteredParameters = paramsWithoutLabels;
+        }
+        return this.api.formatData(input, filteredParameters);
     }
 }
 exports.AbstractGoogleLLMConnection = AbstractGoogleLLMConnection;

package/dist/connection.js

@@ -276,12 +276,7 @@ export class GoogleAIConnection extends GoogleHostConnection {
     get computedLocation() {
         switch (this.apiName) {
             case "google":
-                if (this.modelName.startsWith("gemini-2.5-flash-lite")) {
-                    return "global";
-                }
-                else {
-                    return super.computedLocation;
-                }
+                return super.computedLocation;
             case "anthropic":
                 return "us-east5";
             default:
@@ -368,7 +363,13 @@ export class AbstractGoogleLLMConnection extends GoogleAIConnection {
         }
     }
     async formatData(input, parameters) {
-        return this.api.formatData(input, parameters);
+        // Filter out labels for non-Vertex AI platforms (labels are only supported on Vertex AI)
+        let filteredParameters = parameters;
+        if (parameters.labels && this.platform !== "gcp") {
+            const { labels, ...paramsWithoutLabels } = parameters;
+            filteredParameters = paramsWithoutLabels;
+        }
+        return this.api.formatData(input, filteredParameters);
     }
 }
 export class GoogleRequestCallbackHandler extends BaseCallbackHandler {

package/dist/types.d.ts

@@ -263,6 +263,23 @@ export interface GoogleAIModelParams extends GoogleModelParams {
      * The modalities of the response.
      */
     responseModalities?: GoogleAIModelModality[];
+    /**
+     * Custom metadata labels to associate with the request.
+     * Only supported on Vertex AI (Google Cloud Platform).
+     * Labels are key-value pairs where both keys and values must be strings.
+     *
+     * Example:
+     * ```typescript
+     * {
+     *   labels: {
+     *     "team": "research",
+     *     "component": "frontend",
+     *     "environment": "production"
+     *   }
+     * }
+     * ```
+     */
+    labels?: Record<string, string>;
     /**
      * Speech generation configuration.
      * You can use either Google's definition of the speech configuration,
@@ -530,6 +547,10 @@ export interface GeminiRequest {
     safetySettings?: GeminiSafetySetting[];
     generationConfig?: GeminiGenerationConfig;
     cachedContent?: string;
+    /**
+     * Custom metadata labels to associate with the API call.
+     */
+    labels?: Record<string, string>;
 }
 export interface GeminiResponseCandidate {
     content: {

package/dist/utils/common.cjs

@@ -180,6 +180,7 @@ function copyAIModelParamsInto(params, options, target) {
     if (options?.cachedContent) {
         ret.cachedContent = options.cachedContent;
     }
+    ret.labels = options?.labels ?? params?.labels ?? target?.labels;
     return ret;
 }
 function modelToFamily(modelName) {

package/dist/utils/common.js

@@ -171,6 +171,7 @@ export function copyAIModelParamsInto(params, options, target) {
     if (options?.cachedContent) {
         ret.cachedContent = options.cachedContent;
     }
+    ret.labels = options?.labels ?? params?.labels ?? target?.labels;
     return ret;
 }
 export function modelToFamily(modelName) {

package/dist/utils/gemini.cjs

@@ -1408,6 +1408,9 @@ function getGeminiAPI(config) {
         if (parameters.cachedContent) {
             ret.cachedContent = parameters.cachedContent;
         }
+        if (parameters.labels && Object.keys(parameters.labels).length > 0) {
+            ret.labels = parameters.labels;
+        }
         return ret;
     }
     return {

package/dist/utils/gemini.js

@@ -1398,6 +1398,9 @@ export function getGeminiAPI(config) {
         if (parameters.cachedContent) {
             ret.cachedContent = parameters.cachedContent;
         }
+        if (parameters.labels && Object.keys(parameters.labels).length > 0) {
+            ret.labels = parameters.labels;
+        }
         return ret;
     }
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/google-common",
-  "version": "0.2.15",
+  "version": "0.2.16",
   "description": "Core types and classes for Google services.",
   "type": "module",
   "engines": {