@langchain/google-vertexai 2.0.5-dev-1765433794876 → 2.1.0

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @langchain/google-vertexai
 
+## 2.1.0
+
+### Patch Changes
+
+- [#8951](https://github.com/langchain-ai/langchainjs/pull/8951) [`a2a0088`](https://github.com/langchain-ai/langchainjs/commit/a2a00880b80119eb926de05e9c556a44fd56632e) Thanks [@christian-bromann](https://github.com/christian-bromann)! - fix(google-common): handle unsupported Zod schema features for Gemini tools
+
+- Updated dependencies []:
+  - @langchain/google-gauth@2.1.0
+
 ## 2.0.4
 
 ### Patch Changes

package/README.md

@@ -8,17 +8,15 @@ environment it is running on.
 
 If you are running this on a platform where the credentials cannot
 be provided this way, consider using the @langchain/google-vertexai-web
-package *instead*. You do not need to use both packages. See the
+package _instead_. You do not need to use both packages. See the
 section on **Authorization** below.
 
-
 ## Installation
 
 ```bash
 $ pnpm install @langchain/google-vertexai
 ```
 
-
 ## Authorization
 
 Authorization is done through a Google Cloud Service Account.
@@ -32,9 +30,68 @@ credentials from the first of the following that apply:
 2. Credentials that are passed to the constructor using the `authInfo` attribute
 3. An API Key that is set in the environment variable `API_KEY`
 4. The Service Account credentials that are saved in a file. The path to
-   this file is set in the `GOOGLE_APPLICATION_CREDENTIALS` environment 
+   this file is set in the `GOOGLE_APPLICATION_CREDENTIALS` environment
    variable.
 5. If you are running on a Google Cloud Platform resource, or if you have
    logged in using `gcloud auth application-default login`, then the
    default credentials.
 
+## Tool Schema Limitations
+
+When using tools with Gemini models through Vertex AI, be aware of the following Zod schema limitations:
+
+### Unsupported Schema Features
+
+1. **Discriminated Unions** - `.discriminatedUnion()` is not supported
+
+   ```typescript
+   // ❌ This will throw an error
+   z.discriminatedUnion("type", [
+     z.object({ type: z.literal("a"), value: z.string() }),
+     z.object({ type: z.literal("b"), value: z.number() }),
+   ]);
+
+   // ✅ Use a flat object with optional fields instead
+   z.object({
+     type: z.enum(["a", "b"]),
+     stringValue: z.string().optional(),
+     numberValue: z.number().optional(),
+   });
+   ```
+
+2. **Union Types** - `z.union()` is not supported
+
+   ```typescript
+   // ❌ This will throw an error
+   z.union([z.string(), z.number()]);
+
+   // ✅ Consider using separate optional fields
+   z.object({
+     stringValue: z.string().optional(),
+     numberValue: z.number().optional(),
+   });
+   ```
+
+3. **Positive Refinement** - `.positive()` is automatically converted
+
+   ```typescript
+   // ⚠️ This is automatically converted to .min(0.01)
+   z.number().positive();
+
+   // ✅ Prefer using .min() directly
+   z.number().min(0.01);
+   ```
+
+### Error Messages
+
+If you use unsupported schema features, you'll receive descriptive error messages:
+
+- For union types: `"Gemini cannot handle union types (discriminatedUnion, anyOf, oneOf)"`
+- For tool conversion failures: `"Failed to convert tool '[toolName]' schema for Gemini"`
+
+### Best Practices
+
+1. Use simple, flat object structures when possible
+2. Replace discriminated unions with enums and optional fields
+3. Use `.min()` instead of `.positive()` for number constraints
+4. Test your tool schemas before deploying to production

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/google-vertexai",
-  "version": "2.0.5-dev-1765433794876",
+  "version": "2.1.0",
   "description": "LangChain.js support for Google Vertex AI",
   "author": "LangChain",
   "license": "MIT",
@@ -14,7 +14,7 @@
   },
   "homepage": "https://github.com/langchain-ai/langchainjs/tree/main/libs/langchain-google-vertexai/",
   "dependencies": {
-    "@langchain/google-gauth": "2.0.5-dev-1765433794876"
+    "@langchain/google-gauth": "2.1.0"
   },
   "devDependencies": {
     "@jest/globals": "^29.5.0",
@@ -32,8 +32,8 @@
     "typescript": "~5.8.3",
     "zod": "^3.25.76",
     "@langchain/eslint": "0.1.1",
-    "@langchain/google-common": "2.0.5-dev-1765433794876",
-    "@langchain/standard-tests": "0.0.8-dev-1765433794876",
+    "@langchain/google-common": "2.1.0",
+    "@langchain/standard-tests": "0.0.8",
     "@langchain/tsconfig": "0.0.1"
   },
   "publishConfig": {

package/types.cjs

@@ -0,0 +1 @@
+module.exports = require("./dist/types.cjs");

package/types.d.cts

@@ -0,0 +1 @@
+export * from "./dist/types.js";

package/types.d.ts

@@ -0,0 +1 @@
+export * from "./dist/types.js";

package/types.js

@@ -0,0 +1 @@
+export * from "./dist/types.js";

package/utils.cjs

@@ -0,0 +1 @@
+module.exports = require("./dist/utils.cjs");

package/utils.d.cts

@@ -0,0 +1 @@
+export * from "./dist/utils.js";

package/utils.d.ts

@@ -0,0 +1 @@
+export * from "./dist/utils.js";

package/utils.js

@@ -0,0 +1 @@
+export * from "./dist/utils.js";