@economic/agents 2.3.0 → 2.3.2

package/README.md

@@ -27,6 +27,65 @@ npm install -D wrangler vite @cloudflare/vite-plugin @cloudflare/worker-bundler
 
 `@economic/agents` provides the agent runtime. Worker apps install the Cloudflare/Agents host packages they import directly, including the Vite plugin stack used by native skills.
 
+## Providers
+
+`@economic/agents/providers` ships two pre-configured AI SDK providers that route through **Cloudflare AI Gateway** to Google Vertex AI and Google AI Studio. Both providers require `@ai-sdk/anthropic` and `@ai-sdk/google` to be installed.
+
+### Anthropic via Vertex AI
+
+Routes Claude models through Cloudflare AI Gateway → Google Vertex AI.
+
+```typescript
+import { createAnthropicVertexProvider } from "@economic/agents/providers";
+
+const anthropic = createAnthropicVertexProvider({
+  cloudflareAccountId: env.CLOUDFLARE_ACCOUNT_ID,
+  cloudflareAiGatewayId: env.AI_GATEWAY_ID,
+  cloudflareApiToken: env.CLOUDFLARE_API_TOKEN,
+  googleCloudProjectId: env.GOOGLE_CLOUD_PROJECT_ID,
+  location: "europe-west1", // optional, defaults to "europe-west1"
+});
+
+getModel() {
+  return anthropic("claude-3-7-sonnet-20250219");
+}
+```
+
+### Gemini via Vertex AI
+
+Routes Gemini models through Cloudflare AI Gateway → Google Vertex AI.
+
+```typescript
+import { createGeminiProvider } from "@economic/agents/providers";
+
+const gemini = createGeminiProvider({
+  cloudflareAccountId: env.CLOUDFLARE_ACCOUNT_ID,
+  cloudflareAiGatewayId: env.AI_GATEWAY_ID,
+  cloudflareApiToken: env.CLOUDFLARE_API_TOKEN,
+  googleCloudProjectId: env.GOOGLE_CLOUD_PROJECT_ID,
+  location: "europe-west1", // optional, defaults to "europe-west1"
+});
+
+getModel() {
+  return gemini("gemini-2.0-flash");
+}
+```
+
+### Both together
+
+`createAiGatewayVertexProviders` returns both providers from a single options object:
+
+```typescript
+import { createAiGatewayVertexProviders } from "@economic/agents/providers";
+
+const { anthropic, gemini } = createAiGatewayVertexProviders({
+  cloudflareAccountId: env.CLOUDFLARE_ACCOUNT_ID,
+  cloudflareAiGatewayId: env.AI_GATEWAY_ID,
+  cloudflareApiToken: env.CLOUDFLARE_API_TOKEN,
+  googleCloudProjectId: env.GOOGLE_CLOUD_PROJECT_ID,
+});
+```
+
 ## Quick start: an agent
 
 Subclass `Agent` and implement `getModel` and `getSystemPrompt`. Add tools with `getTools`, skills with `getSkills`. Expose a `@callable` method to run a turn — `saveMessages` injects a message, runs the turn, and persists the result:

package/dist/index.d.mts

@@ -103,7 +103,7 @@ declare abstract class Agent<RequestContext extends Record<string, unknown> = Re
    * The user context for the session.
    * Define getUserContext to set a user context.
    */
-  private _userContext?;
+  protected userContext?: UserContext;
   /**
    * Returns the identity following verification of the JWT token - getJwtAuthConfig is required.
    * This method should not have side effects - return a single object from it.

package/dist/index.mjs

@@ -121,7 +121,7 @@ var Agent = class extends Think {
 				});
 				const token = extractTokenFromConnectRequest(ctx.request);
 				if (token && this.getUserContext) this._pendingUserContextRequest = this.getUserContext(token).then((userContext) => {
-					this._userContext = userContext;
+					this.userContext = userContext;
 				});
 			}
 		}
@@ -148,7 +148,7 @@ var Agent = class extends Think {
 		if (this._pendingUserContextRequest) await this._pendingUserContextRequest;
 		this._toolContextForCurrentTurn = {
 			...ctx.body ?? {},
-			_userContext: this._userContext
+			_userContext: this.userContext
 		};
 		await this.session.refreshSystemPrompt();
 		this._toolsForCurrentTurn = ctx.tools;
@@ -267,7 +267,7 @@ var Agent = class extends Think {
 	* The user context for the session.
 	* Define getUserContext to set a user context.
 	*/
-	_userContext;
+	userContext;
 	/**
 	* Self-registers this DO in the global `agent_registry`. Only top-level DOs
 	* are registered — facets are enumerable via their parent's own index, so

package/dist/providers.d.mts

@@ -22,7 +22,8 @@ interface GeminiProviderOptions {
   cloudflareAccountId: string;
   cloudflareAiGatewayId: string;
   cloudflareApiToken: string;
-  googleApiKey?: string;
+  googleCloudProjectId: string;
+  location?: string;
 }
 declare function createGeminiProvider(options: GeminiProviderOptions): GoogleGenerativeAIProvider;
 //#endregion

package/dist/providers.mjs

@@ -26,12 +26,12 @@ function createAnthropicVertexProvider(options) {
 //#endregion
 //#region src/providers/gemini.ts
 function createGeminiProvider(options) {
-	const { cloudflareAccountId, cloudflareAiGatewayId, cloudflareApiToken, googleApiKey } = options;
+	const { cloudflareAccountId, cloudflareAiGatewayId, cloudflareApiToken, googleCloudProjectId, location = "europe-west1" } = options;
 	return createGoogleGenerativeAI({
-		apiKey: googleApiKey ?? "unused",
-		baseURL: `https://gateway.ai.cloudflare.com/v1/${cloudflareAccountId}/${cloudflareAiGatewayId}/google-ai-studio/v1beta`,
+		apiKey: "unused",
+		baseURL: `https://gateway.ai.cloudflare.com/v1/${cloudflareAccountId}/${cloudflareAiGatewayId}/google-vertex-ai/v1/projects/${googleCloudProjectId}/locations/${location}/publishers/google/models`,
 		headers: { "cf-aig-authorization": `Bearer ${cloudflareApiToken}` },
-		name: "gateway.google.generative-ai"
+		name: "gateway.google.vertex-ai"
 	});
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@economic/agents",
-  "version": "2.3.0",
+  "version": "2.3.2",
   "description": "A starter for creating a TypeScript package.",
   "license": "MIT",
   "bin": {