@warlock.js/ai-google 5.34.0 → 5.34.2

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@warlock.js/ai-google` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 5.34.2 - 2026-10-19
+
+### Fixed
+
+- Replace the loose skill catalog with a package index that points to the provider setup topic, and include orientation in generated LLM projections.
+
 ## 5.32.0 - 2026-10-18
 
 ### Changed

package/llms-full.txt

@@ -4,6 +4,19 @@
 
 > Generated artifact. Concatenates every SKILL.md and reference file under `@warlock.js/ai-google/skills/`. Re-run `node scripts/generate-llms.mjs` after any change.
 
+## Package orientation
+
+---
+description: "Provider adapter for Google Gemini API and Vertex AI in Warlock AI applications. Exports `GoogleSDK` with model and provider configuration for the shared AI contracts. Use when connecting this provider, configuring API keys or Vertex project settings, reasoning and embeddings, or diagnosing provider requests and usage. Read `setup-google` for construction and examples using GOOGLE_API_KEY or Vertex credentials. Not this package: agent loops, tools and workflows → @warlock.js/ai; HTTP and MCP tools → @warlock.js/ai-tools."
+---
+
+# @warlock.js/ai-google
+
+This adapter supplies provider-backed models for `@warlock.js/ai`. Read `setup-google.md` to construct `GoogleSDK`, configure API keys or Vertex project settings, reasoning and embeddings, and understand provider-specific behavior.
+
+For agent composition, read the `run-ai-agent` topic of the `@warlock.js/ai` package. Keep provider configuration here and application orchestration in that package.
+
+
 ## setup-google  `@warlock.js/ai-google/setup-google/SKILL.md`
 
 ---

package/llms.txt

@@ -6,4 +6,5 @@
 
 ## Skills
 
+- [Package orientation](@warlock.js/ai-google/skills/index.md): Provider adapter for Google Gemini API and Vertex AI in Warlock AI applications. Exports `GoogleSDK` with model and provider configuration for the shared AI contracts. Use when connecting this provider, configuring API keys or Vertex project settings, reasoning and embeddings, or diagnosing provider requests and usage. Read `setup-google` for construction and examples using GOOGLE_API_KEY or Vertex credentials. Not this package: agent loops, tools and workflows → @warlock.js/ai; HTTP and MCP tools → @warlock.js/ai-tools.
 - [setup-google](@warlock.js/ai-google/setup-google/SKILL.md): Wire @warlock.js/ai-google — new GoogleSDK({apiKey} | {vertexai, project, location}) for Gemini API + Vertex AI. generateContent / embedContent + thoughtSignature round-trip for thinking models, batched embeddings. .model({name, vision?, reasoning?, audio?, pdf?}) with cost-truth capabilities (PDF + audio input map to Gemini inlineData), .image({name, pricing?}) for image generation via ai.image — the id picks the transport: gemini-* → generateContent + responseModalities IMAGE (usage passed through; generateImages is deprecated by Google), everything else → generateImages (Imagen, per-image, zero usage) — extended thinking via options.reasoning → thinkingConfig.thinkingBudget, usage reasoningTokens (thoughtsTokenCount) / cachedTokens (cachedContentTokenCount). Triggers: `providerOptions`, `GoogleCallOptions`, `countTokens`, `GoogleSDK`, `google.model`, `google.embedder`, `google.image`, `imagen`, `generateImages`, `gemini image`, `nano banana`, `responseModalities`, `imageConfig`, `ai.image`, `inlineData`, `pdf input`, `audio input`, `thoughtSignature`, `responseJsonSchema`, `ai.providerTool`, `googleSearch`, `includeThoughts`, `streamChunks`, `vertexai`, `reasoning`, `thinkingConfig`, `thinkingBudget`, `thoughtsTokenCount`, `reasoningTokens`, `cachedTokens`, `inputIncludesCache`, `GOOGLE_MODEL_PRICING`, `googlePricingFor`, `ProviderOverloadedError`, `promptCaching`, `cacheControl`; "use gemini", "wire Vertex AI", "gemini embeddings", "gemini thinking tool calls", "gemini 2.5 thinking budget", "gemini cached content cost", "generate images with imagen", "generate an image with gemini", "gemini image model 404 not supported for predict", "send a pdf / audio to gemini"; import `import { GoogleSDK } from "@warlock.js/ai-google"`. Skip: the ai.image verb surface — the `generate-images` topic of the `warlock-js-ai` skill; agent loop the `run-ai-agent` topic of the `warlock-js-ai` skill; provider picking the `pick-ai-provider` topic of the `warlock-js-ai` skill; embedder usage the `embed-text` topic of the `warlock-js-ai` skill; siblings `@warlock.js/ai-openai`, `@warlock.js/ai-anthropic`, `@warlock.js/ai-bedrock`, `@warlock.js/ai-ollama`; raw `@google/genai`, `@google-cloud/vertexai`, Vercel `@ai-sdk/google`.

package/package.json

@@ -15,13 +15,13 @@
     "directory": "packages/ai-google"
   },
   "peerDependencies": {
-    "@warlock.js/ai": "5.34.0"
+    "@warlock.js/ai": "5.34.2"
   },
   "dependencies": {
     "@google/genai": "^2.17.1",
-    "@warlock.js/logger": "5.34.0"
+    "@warlock.js/logger": "5.34.2"
   },
-  "version": "5.34.0",
+  "version": "5.34.2",
   "main": "./cjs/index.cjs",
   "module": "./esm/index.mjs",
   "types": "./esm/index.d.mts",

package/skills/index.md

@@ -0,0 +1,9 @@
+---
+description: "Provider adapter for Google Gemini API and Vertex AI in Warlock AI applications. Exports `GoogleSDK` with model and provider configuration for the shared AI contracts. Use when connecting this provider, configuring API keys or Vertex project settings, reasoning and embeddings, or diagnosing provider requests and usage. Read `setup-google` for construction and examples using GOOGLE_API_KEY or Vertex credentials. Not this package: agent loops, tools and workflows → @warlock.js/ai; HTTP and MCP tools → @warlock.js/ai-tools."
+---
+
+# @warlock.js/ai-google
+
+This adapter supplies provider-backed models for `@warlock.js/ai`. Read `setup-google.md` to construct `GoogleSDK`, configure API keys or Vertex project settings, reasoning and embeddings, and understand provider-specific behavior.
+
+For agent composition, read the `run-ai-agent` topic of the `@warlock.js/ai` package. Keep provider configuration here and application orchestration in that package.

package/skills/README.md

@@ -1,9 +0,0 @@
-# `@warlock.js/ai-google` — skills index
-
-Per-task skills. Cross-references name the topic ("the `<topic>` topic"), and for another package add its skill ("the `<topic>` topic of the `warlock-js-<pkg>` skill").
-
-## Skills
-
-### `setup-google`
-
-Wire @warlock.js/ai-google — new GoogleSDK({apiKey} | {vertexai, project, location}) for Gemini API + Vertex AI. generateContent / embedContent + thoughtSignature round-trip for thinking models, batched embeddings. Load when wiring a Gemini-backed model into a @warlock.js agent or running on Vertex AI.