@tepa/provider-gemini

Google Gemini LLM provider for the Tepa agent pipeline. Uses the @google/genai SDK.

Install

npm install @tepa/provider-gemini

Setup

Set your Gemini API key as an environment variable:

export GEMINI_API_KEY=...

Or use GOOGLE_API_KEY, or pass it directly in the constructor.

Usage

import { Tepa } from "@tepa/core";
import { GeminiProvider } from "@tepa/provider-gemini";

const tepa = new Tepa({
  tools: [
    /* ... */
  ],
  provider: new GeminiProvider(),
});

Provider Options

const provider = new GeminiProvider({
  apiKey: "...", // Defaults to GEMINI_API_KEY or GOOGLE_API_KEY env var
  maxRetries: 3, // Default: 3
  retryBaseDelayMs: 1000, // Base delay for exponential backoff
});

Logging

Every LLM call is automatically logged to a JSONL file in .tepa/logs/. You can disable the default file logger, add custom log listeners, or send logs to external services like Prometheus, NewRelic, or Datadog using the onLog() method:

const provider = new GeminiProvider({ defaultLog: false });

provider.onLog((entry) => {
  externalLogger.send(entry);
});

See @tepa/provider-core for full logging documentation.

Native Tool Use

This provider supports native tool calling via Gemini's function calling API. When tool schemas are passed via options.tools, they are forwarded as function declarations. The LLM returns structured functionCall parts with pre-parsed parameters, eliminating text-based JSON parsing errors.