@core-ai/google-vertex 0.14.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Omnifact (https://omnifact.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# @core-ai/google-vertex
+
+[![npm](https://img.shields.io/npm/v/@core-ai/google-vertex.svg)](https://www.npmjs.com/package/@core-ai/google-vertex)
+
+Google on Vertex AI provider package for `@core-ai/core-ai`. It uses the [`@google/genai`](https://www.npmjs.com/package/@google/genai) client in Vertex AI mode and shares chat, embedding, image generation, structured-output, and reasoning behavior with `@core-ai/google-genai`.
+
+## Installation
+
+```bash
+npm install @core-ai/core-ai @core-ai/google-vertex zod
+```
+
+## Usage
+
+```ts
+import { generate } from '@core-ai/core-ai';
+import { createGoogleVertex } from '@core-ai/google-vertex';
+
+const googleVertex = createGoogleVertex({
+    projectId: process.env.GOOGLE_VERTEX_PROJECT,
+    region: 'europe-west1',
+});
+const model = googleVertex.chatModel('gemini-2.5-flash');
+
+const result = await generate({
+    model,
+    messages: [{ role: 'user', content: 'Hello!' }],
+});
+
+console.log(result.content);
+```
+
+## Authentication
+
+By default, the provider uses [Google Application Default Credentials (ADC)](https://cloud.google.com/docs/authentication/application-default-credentials):
+
+```ts
+const googleVertex = createGoogleVertex({
+    projectId: process.env.GOOGLE_VERTEX_PROJECT,
+    region: 'europe-west1',
+});
+```
+
+To authenticate with an explicit service account, parse its JSON key and pass it as `credentials`:
+
+```ts
+const rawCredentials = process.env.GOOGLE_APPLICATION_CREDENTIALS_JSON;
+const credentialsJson = rawCredentials?.trim().startsWith('{')
+    ? rawCredentials
+    : Buffer.from(rawCredentials ?? '', 'base64').toString('utf8');
+
+const googleVertex = createGoogleVertex({
+    projectId: process.env.GOOGLE_VERTEX_PROJECT,
+    region: 'europe-west1',
+    credentials: JSON.parse(credentialsJson),
+});
+```
+
+You can also inject a preconfigured `GoogleGenAI` client:
+
+```ts
+import { GoogleGenAI } from '@google/genai';
+
+const googleVertex = createGoogleVertex({
+    client: new GoogleGenAI({
+        vertexai: true,
+        project: 'my-project',
+        location: 'europe-west1',
+    }),
+});
+```
+
+## Models and regions
+
+Pass Vertex AI model IDs to the corresponding model factory:
+
+```ts
+const chat = googleVertex.chatModel('gemini-2.5-flash');
+const embeddings = googleVertex.embeddingModel('gemini-embedding-001');
+const image = googleVertex.imageModel('gemini-2.5-flash-image');
+```
+
+Model availability varies by region. A provider instance targets one region, so create separate providers when models are hosted in different locations.
+
+## Image generation
+
+```ts
+import { generateImage } from '@core-ai/core-ai';
+
+const result = await generateImage({
+    model: googleVertex.imageModel('gemini-2.5-flash-image'),
+    prompt: 'A watercolor robot in a mountain cabin at sunrise',
+    size: '1024x1024',
+});
+
+console.log(result.images[0]?.base64);
+```
+
+Gemini image models use native multimodal generation. Imagen models such as
+`imagen-4.0-generate-001` remain available through the same `imageModel()`
+factory when the selected Vertex AI region and project support them.
+
+## Provider options and capabilities
+
+This provider shares its model behavior with `@core-ai/google-genai`. Provider options remain namespaced under `google`. `@core-ai/google-vertex` re-exports the applicable provider-option schemas, capability helpers, and reasoning metadata types.

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { GoogleGenAIOptions } from '@google/genai';
+import { GoogleGenAIProvider, GoogleGenAIClient } from '@core-ai/google-genai';
+export { GoogleEmbedProviderOptions, GoogleGenAIClient, GoogleGenerateProviderOptions, GoogleImageProviderOptions, GoogleModelCapabilities, GoogleModelProviderOptions, GoogleReasoningMetadata, getGoogleModelCapabilities, googleEmbedProviderOptionsSchema, googleGenerateProviderOptionsSchema, googleImageProviderOptionsSchema, googleProviderOptionsSchema } from '@core-ai/google-genai';
+
+type GoogleVertexServiceAccountCredentials = NonNullable<NonNullable<GoogleGenAIOptions['googleAuthOptions']>['credentials']>;
+type GoogleVertexProviderOptions = {
+    projectId?: string;
+    region?: string;
+    credentials?: GoogleVertexServiceAccountCredentials;
+    client?: GoogleGenAIClient;
+};
+type GoogleVertexProvider = GoogleGenAIProvider;
+declare function createGoogleVertex(options?: GoogleVertexProviderOptions): GoogleVertexProvider;
+
+export { type GoogleVertexProvider, type GoogleVertexProviderOptions, type GoogleVertexServiceAccountCredentials, createGoogleVertex };

package/dist/index.js

@@ -0,0 +1,49 @@
+// src/provider.ts
+import { GoogleGenAI } from "@google/genai";
+import {
+  createGoogleGenAIProvider
+} from "@core-ai/google-genai";
+var PROVIDER_ID = "google-vertex";
+function createGoogleVertex(options = {}) {
+  const client = options.client ?? createGoogleVertexClient(options);
+  return createGoogleGenAIProvider(
+    { client },
+    {
+      providerId: PROVIDER_ID
+    }
+  );
+}
+function createGoogleVertexClient(options) {
+  if (!options.projectId) {
+    throw new Error("createGoogleVertex: projectId is required.");
+  }
+  if (!options.region) {
+    throw new Error("createGoogleVertex: region is required.");
+  }
+  const googleAuthOptions = options.credentials ? {
+    credentials: options.credentials
+  } : void 0;
+  return new GoogleGenAI({
+    vertexai: true,
+    project: options.projectId,
+    location: options.region,
+    ...googleAuthOptions ? { googleAuthOptions } : {}
+  });
+}
+
+// src/index.ts
+import {
+  getGoogleModelCapabilities,
+  googleEmbedProviderOptionsSchema,
+  googleGenerateProviderOptionsSchema,
+  googleImageProviderOptionsSchema,
+  googleProviderOptionsSchema
+} from "@core-ai/google-genai";
+export {
+  createGoogleVertex,
+  getGoogleModelCapabilities,
+  googleEmbedProviderOptionsSchema,
+  googleGenerateProviderOptionsSchema,
+  googleImageProviderOptionsSchema,
+  googleProviderOptionsSchema
+};

package/package.json

@@ -0,0 +1,65 @@
+{
+    "name": "@core-ai/google-vertex",
+    "version": "0.14.0",
+    "description": "Vertex AI Google provider package for @core-ai/core-ai",
+    "license": "MIT",
+    "author": "Omnifact (https://omnifact.ai)",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/agdevhq/core-ai.git",
+        "directory": "packages/google-vertex"
+    },
+    "keywords": [
+        "llm",
+        "ai",
+        "google",
+        "gemini",
+        "imagen",
+        "vertex",
+        "vertex-ai",
+        "google-cloud",
+        "provider",
+        "sdk"
+    ],
+    "type": "module",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "README.md",
+        "LICENSE"
+    ],
+    "publishConfig": {
+        "access": "public",
+        "provenance": true
+    },
+    "scripts": {
+        "build": "tsup",
+        "lint": "eslint src/ --max-warnings 0",
+        "check-types": "tsc --noEmit",
+        "test": "vitest run",
+        "test:watch": "vitest"
+    },
+    "dependencies": {
+        "@core-ai/core-ai": "^0.14.0",
+        "@core-ai/google-genai": "^0.14.0",
+        "@google/genai": "^1.42.0"
+    },
+    "peerDependencies": {
+        "zod": "^4.0.0"
+    },
+    "devDependencies": {
+        "@core-ai/eslint-config": "*",
+        "@core-ai/typescript-config": "*",
+        "typescript": "^5.7.3",
+        "vitest": "^3.2.4"
+    }
+}