@ank1015/agents-provider-gemini

Runtime Gemini Interactions provider adapter for the @ank1015/agents packages.

This package uses Google's Interactions API through the @google/genai SDK. It streams Gemini interaction events into the normalized assistant event stream used by @ank1015/agents-contracts, while preserving Gemini native steps for stateless multi-turn replay.

Install

pnpm add @ank1015/agents-provider-gemini

Usage

import { createGeminiProviderAdapter } from '@ank1015/agents-provider-gemini';

const adapter = createGeminiProviderAdapter({
  provider: 'gemini',
  apiKey: {
    type: 'env',
    name: 'GEMINI_API_KEY',
  },
});

Pass baseUrl in provider config to override the SDK default Gemini endpoint. Values ending in an API version, such as https://generativelanguage.googleapis.com/v1beta, are split into SDK baseUrl and apiVersion.

Notes

• Runtime model support is catalog-only through @ank1015/agents-provider-gemini-spec.
• The adapter always sends stream: true and store: false.
• Gemini 3.1 Pro Preview uses whole-request pricing tiers above 200K total input tokens.
• Built-in Gemini tools are provided through providerOptions.built_in_tools; generic request tools only accepts function tools.
• Output image/audio generation is not normalized in v1, but native Gemini steps are preserved.