@core-ai/anthropic-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,87 @@
+# @core-ai/anthropic-vertex
+
+[![npm](https://img.shields.io/npm/v/@core-ai/anthropic-vertex.svg)](https://www.npmjs.com/package/@core-ai/anthropic-vertex)
+
+Vertex AI Anthropic (Claude) provider package for `@core-ai/core-ai`. It uses the [`@anthropic-ai/vertex-sdk`](https://www.npmjs.com/package/@anthropic-ai/vertex-sdk) client and shares its request, streaming, tool-calling, structured-output, and reasoning behavior with `@core-ai/anthropic`.
+
+## Installation
+
+```bash
+npm install @core-ai/core-ai @core-ai/anthropic-vertex zod
+```
+
+## Usage
+
+```ts
+import { generate } from '@core-ai/core-ai';
+import { createAnthropicVertex } from '@core-ai/anthropic-vertex';
+
+const anthropicVertex = createAnthropicVertex({
+    projectId: process.env.GOOGLE_VERTEX_PROJECT,
+    region: 'europe-west1',
+});
+const model = anthropicVertex.chatModel('claude-sonnet-4-6');
+
+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 anthropicVertex = createAnthropicVertex({
+    projectId: process.env.GOOGLE_VERTEX_PROJECT,
+    region: 'europe-west1',
+});
+```
+
+To authenticate with an explicit service account instead, parse its JSON key and pass it as `credentials`:
+
+```ts
+const anthropicVertex = createAnthropicVertex({
+    projectId: process.env.GOOGLE_VERTEX_PROJECT,
+    region: 'europe-west1',
+    credentials: JSON.parse(
+        process.env.GOOGLE_APPLICATION_CREDENTIALS_JSON ?? ''
+    ),
+});
+```
+
+You can also inject a preconfigured client (for example a custom `AnthropicVertex` instance, or one wired up for testing):
+
+```ts
+import { AnthropicVertex } from '@anthropic-ai/vertex-sdk';
+
+const anthropicVertex = createAnthropicVertex({
+    client: new AnthropicVertex({ projectId: 'my-project', region: 'eu' }),
+});
+```
+
+## Model IDs and regions
+
+Pass the Vertex model ID (as listed in the [Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/publishers/anthropic/model-garden)) to `chatModel()`. Model availability and naming vary by region — for example, some Claude models are only published to Vertex AI's `eu` multi-region while others are published to region-specific endpoints like `europe-west1`. Since a provider instance targets a single region, create separate providers if you need to reach models hosted in different regions:
+
+```ts
+const anthropicVertexEu = createAnthropicVertex({
+    projectId: process.env.GOOGLE_VERTEX_PROJECT,
+    region: 'eu',
+});
+const anthropicVertexEuWest1 = createAnthropicVertex({
+    projectId: process.env.GOOGLE_VERTEX_PROJECT,
+    region: 'europe-west1',
+});
+```
+
+This package supports chat models only.
+
+> **Caveat:** Pass the unversioned Vertex model id (e.g. `claude-sonnet-4-6`) rather than a version-pinned id (e.g. `claude-sonnet-4-6@20250929`). Reasoning-effort and sampling-restriction capability detection (`getAnthropicModelCapabilities` and friends in `@core-ai/anthropic`) only recognizes the unversioned form today, so a version-pinned id silently falls back to standard capabilities instead of the model's actual ones.
+
+## Provider options and model capabilities
+
+This provider shares its request, streaming, and reasoning behavior with `@core-ai/anthropic`. Provider-options schemas (`anthropicGenerateProviderOptionsSchema`), reasoning metadata types (`AnthropicReasoningMetadata`), and model capability helpers (`getAnthropicModelCapabilities`) are available from `@core-ai/anthropic` and apply equally to Vertex-hosted Claude models.

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { ChatModel } from '@core-ai/core-ai';
+import { AnthropicChatClient } from '@core-ai/anthropic';
+
+type AnthropicVertexServiceAccountCredentials = Record<string, unknown>;
+type AnthropicVertexProviderOptions = {
+    projectId?: string;
+    region?: string;
+    credentials?: AnthropicVertexServiceAccountCredentials;
+    client?: AnthropicChatClient;
+    defaultMaxTokens?: number;
+};
+type AnthropicVertexProvider = {
+    chatModel(modelId: string): ChatModel;
+};
+declare function createAnthropicVertex(options?: AnthropicVertexProviderOptions): AnthropicVertexProvider;
+
+export { type AnthropicVertexProvider, type AnthropicVertexProviderOptions, type AnthropicVertexServiceAccountCredentials, createAnthropicVertex };

package/dist/index.js

@@ -0,0 +1,43 @@
+// src/provider.ts
+import { AnthropicVertex } from "@anthropic-ai/vertex-sdk";
+import {
+  createAnthropicChatProvider
+} from "@core-ai/anthropic";
+import { GoogleAuth } from "google-auth-library";
+var PROVIDER_ID = "anthropic-vertex";
+var CLOUD_PLATFORM_AUTH_SCOPE = "https://www.googleapis.com/auth/cloud-platform";
+function createAnthropicVertex(options = {}) {
+  const client = options.client ?? createAnthropicVertexClient(options);
+  return createAnthropicChatProvider(
+    { client, defaultMaxTokens: options.defaultMaxTokens },
+    PROVIDER_ID
+  );
+}
+function createAnthropicVertexClient(options) {
+  if (!options.projectId) {
+    throw new Error("createAnthropicVertex: projectId is required.");
+  }
+  if (!options.region) {
+    throw new Error("createAnthropicVertex: region is required.");
+  }
+  const googleAuth = options.credentials ? new GoogleAuth({
+    credentials: options.credentials,
+    scopes: [CLOUD_PLATFORM_AUTH_SCOPE]
+  }) : void 0;
+  return new AnthropicVertex({
+    projectId: options.projectId,
+    region: options.region,
+    ...googleAuth ? {
+      // `@anthropic-ai/vertex-sdk` bundles its own
+      // `google-auth-library` dependency, so the SDK's `GoogleAuth`
+      // type is nominally incompatible with the workspace copy
+      // because of private fields. At runtime, the SDK only uses
+      // the public auth methods, so we cast at the package
+      // boundary.
+      googleAuth
+    } : {}
+  });
+}
+export {
+  createAnthropicVertex
+};

package/package.json

@@ -0,0 +1,66 @@
+{
+    "name": "@core-ai/anthropic-vertex",
+    "version": "0.14.0",
+    "description": "Vertex AI Anthropic (Claude) 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/anthropic-vertex"
+    },
+    "keywords": [
+        "llm",
+        "ai",
+        "anthropic",
+        "claude",
+        "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": {
+        "@anthropic-ai/vertex-sdk": "^0.19.0",
+        "@core-ai/anthropic": "^0.14.0",
+        "@core-ai/core-ai": "^0.14.0",
+        "google-auth-library": "^10.2.0"
+    },
+    "peerDependencies": {
+        "zod": "^4.0.0"
+    },
+    "devDependencies": {
+        "@core-ai/eslint-config": "*",
+        "@core-ai/testing": "*",
+        "@core-ai/typescript-config": "*",
+        "typescript": "^5.7.3",
+        "vitest": "^3.2.4"
+    }
+}