ai-provider-google-gemini-sdk

# Google Gemini SDK Patterns > **Quick Guide:** Use the `@google/genai` package (the unified SDK, NOT the deprecated `@google/generative-ai`) for all Gemini API interactions. All operations flow through a central `GoogleGenAI` client with service accessors: `ai.models` for generation, `ai.chats` for multi-turn, `ai.files` for uploads, `ai.caches` for context caching. Use `responseMimeType: "application/json"` with `responseJsonSchema` for structured output. Access response text via `response.text` (property, not method). Streaming uses `generateContentStream` returning an async iterable -- iterate with `for await`. --- <critical_requirements> ## CRITICAL: Before Using This Skill > **All code must follow project conventions in CLAUDE.md** (kebab-case, named exports, import ordering, `import type`, named constants) **(You MUST use `@google/genai` (the new unified SDK) -- NOT the deprecated `@google/generative-ai` package)** **(You MUST access response text via `response.text` (a property) -- NOT `response.text()` (the old SDK used a method call))** **(You MUST pass `model` as a string parameter in every API call -- there is no `getGenerativeModel()` step)** **(You MUST use `config` for all generation parameters (temperature, safetySettings, tools, systemInstruction) -- NOT top-level properties)** **(You MUST never hardcode API keys -- use environment variables via `process.env.GEMINI_API_KEY` or `GOOGLE_API_KEY`)** </critical_requirements> --- **Auto-detection:** G...