@standardagents/google 0.0.1-dev.ffffff → 0.14.0

package/LICENSE.txt

@@ -0,0 +1,48 @@
+PROPRIETARY SOFTWARE LICENSE
+
+Copyright (c) 2024-2025 FormKit Inc. All Rights Reserved.
+
+UNLICENSED - DO NOT USE
+
+This software and associated documentation files (the "Software") are the sole
+and exclusive property of FormKit Inc. ("FormKit").
+
+USE RESTRICTIONS
+
+The Software is UNLICENSED and proprietary. NO PERMISSION is granted to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, or to permit persons to whom the Software is furnished to do so,
+under any circumstances, without prior written authorization from FormKit Inc.
+
+UNAUTHORIZED USE PROHIBITED
+
+Any use of this Software without a valid, written license agreement signed by
+authorized officers of FormKit Inc. is strictly prohibited and constitutes
+unauthorized use and infringement of FormKit's intellectual property rights.
+
+LICENSING INQUIRIES
+
+Organizations interested in licensing this Software should contact:
+enterprise@formkit.com
+
+A written license agreement must be executed before any use of this Software
+is authorized.
+
+NO WARRANTY
+
+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
+FORMKIT INC. 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.
+
+GOVERNING LAW
+
+This license shall be governed by and construed in accordance with the laws
+of the jurisdiction in which FormKit Inc. is incorporated, without regard to
+its conflict of law provisions.
+
+FormKit Inc.
+https://formkit.com
+enterprise@formkit.com

package/README.md

@@ -1,7 +1,142 @@
 # @standardagents/google
 
-Stub prerelease package for Standard Agents Google/Gemini provider publishing setup.
+Google Gemini and Imagen provider for Standard Agents.
 
-Current bootstrap version: `0.0.1-dev.ffffff`
+This package exports a Standard Agents provider factory for Google's Gemini chat/multimodal models and Imagen image models. It handles:
 
-This package will be wired into the normal monorepo release flow after trusted publishing is configured.
+- model discovery via the Google model list API
+- Standard Agents message and tool translation to Google `generateContent` requests
+- Gemini text, JSON, tools, and multimodal inputs
+- Imagen generation and image-edit style requests
+- usage and cost calculation from Google usage metadata
+
+## Install
+
+```bash
+npm install @standardagents/google @standardagents/spec
+```
+
+## Usage
+
+```ts
+import { google } from '@standardagents/google';
+
+const provider = google({
+  apiKey: process.env.GOOGLE_API_KEY!,
+});
+
+const result = await provider.generate({
+  model: 'gemini-2.5-flash',
+  messages: [
+    {
+      role: 'user',
+      content: 'Write a one sentence summary of Saturn.',
+    },
+  ],
+});
+
+console.log(result.content);
+console.log(result.usage?.cost);
+```
+
+## Factory
+
+The package exports:
+
+- `google(config)` - provider factory
+- `GoogleProvider` - provider class
+- `googleProviderOptions` - Zod schema for provider-specific options
+
+Factory config follows `ProviderFactoryConfig` from `@standardagents/spec`:
+
+```ts
+type ProviderFactoryConfig = {
+  apiKey: string;
+  baseUrl?: string;
+  timeout?: number;
+};
+```
+
+## Supported Features
+
+The provider exposes capabilities per model where available. In practice:
+
+- Gemini models support text generation, streaming, tool calling, and multimodal input
+- Gemma hosted models support text and selected multimodal inputs, with more limited tool support
+- Imagen models support image generation/edit-style requests and are handled as non-streaming image models
+
+Use `getModels()` and `getModelCapabilities()` to inspect the currently available surface:
+
+```ts
+const models = await provider.getModels?.();
+const capabilities = await provider.getModelCapabilities?.('gemini-2.5-pro');
+```
+
+## Provider Options
+
+This package validates Google-specific provider options through `google.providerOptions`.
+
+Common options:
+
+- `candidateCount`
+- `responseModalities`
+- `safetySettings`
+- `thinkingConfig`
+- `imageConfig`
+- `numberOfImages`
+- `aspectRatio`
+- `negativePrompt`
+- `guidanceScale`
+- `outputMimeType`
+- `language`
+- `editMode`
+
+Example:
+
+```ts
+const result = await provider.generate({
+  model: 'gemini-2.5-pro',
+  messages: [
+    { role: 'user', content: 'Return valid JSON with a title and summary.' },
+  ],
+  responseFormat: {
+    type: 'json',
+    schema: {
+      type: 'object',
+      properties: {
+        title: { type: 'string' },
+        summary: { type: 'string' },
+      },
+      required: ['title', 'summary'],
+    },
+  },
+  providerOptions: {
+    candidateCount: 1,
+    safetySettings: [
+      { category: 'HARM_CATEGORY_HARASSMENT', threshold: 'BLOCK_ONLY_HIGH' },
+    ],
+  },
+});
+```
+
+## Images
+
+For multimodal Gemini requests, pass Standard Agents image parts or image attachments and the provider will translate them to Google inline parts. For Imagen requests, the provider will route through the image generation path automatically when the target model is an Imagen model.
+
+## Debugging
+
+Use `inspectRequest()` to view the transformed Google-native request body:
+
+```ts
+const inspected = await provider.inspectRequest?.({
+  model: 'gemini-2.5-flash',
+  messages: [{ role: 'user', content: 'hello' }],
+});
+
+console.log(inspected?.body);
+```
+
+## Notes
+
+- Model IDs are normalized so variants like `google/...`, `models/...`, and `publishers/google/models/...` resolve to the same pricing and capability entries where possible.
+- Cost is computed from Google usage metadata and pricing tables when available; Google does not currently return a direct monetary cost field for Gemini requests.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@standardagents/google",
-  "version": "0.0.1-dev.ffffff",
+  "version": "0.14.0",
   "private": false,
   "publishConfig": {
     "access": "restricted",
@@ -20,13 +20,6 @@
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "cd ../.. && vitest --dir packages/google",
-    "test:run": "cd ../.. && vitest run --dir packages/google"
-  },
   "dependencies": {
     "@google/genai": "^1.47.0",
     "zod": "^4.3.5"
@@ -35,9 +28,9 @@
     "@standardagents/spec": "^0.10.0"
   },
   "devDependencies": {
-    "@standardagents/spec": "workspace:*",
     "tsup": "^8.3.5",
-    "typescript": "^5.9.0"
+    "typescript": "^5.9.0",
+    "@standardagents/spec": "0.14.0"
   },
   "keywords": [
     "standardagents",
@@ -48,5 +41,12 @@
     "llm"
   ],
   "author": "FormKit Inc.",
-  "license": "UNLICENSED"
-}
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "cd ../.. && vitest --dir packages/google",
+    "test:run": "cd ../.. && vitest run --dir packages/google"
+  }
+}