@galdor/provider-google

The Google Gemini (Generative Language API) provider adapter for galdor. Implements the core Provider interface, so it drops into any graph, agent, or council.

Covers generate + streaming, function calling, structured output, vision, thinking, the typed error taxonomy with Retry-After (including safety-blocked prompts surfaced as errors), cancellation, and a stream-safe header timeout (60 s default).

Install

bun add @galdor/provider-google   # or: npm install @galdor/provider-google

Usage

import { newGoogle } from "@galdor/provider-google";
import { userMessage, messageText } from "@galdor/core/schema";

const provider = newGoogle({ apiKey: process.env.GOOGLE_API_KEY! });

const res = await provider.generate({
  model: "gemini-2.5-flash",
  messages: [userMessage("Explain MCP in one sentence.")],
});
console.log(messageText(res.message), res.usage);

Pass tools, toolChoice, responseFormat, and reasoning on the request. This package also re-exports a Gemini embedder (newEmbedder) for the memory stack.

License

Apache-2.0