Simulacra Google Provider

The Google provider allows Simulacra to use Google Gemini models via the Google GenAI SDK, with support for thinking and automatic handling of Gemini's tool call quirks.

Installation

npm install @simulacra-ai/core @simulacra-ai/google @google/genai

Usage

import { Conversation } from "@simulacra-ai/core";
import { GoogleProvider } from "@simulacra-ai/google";
import { GoogleGenAI } from "@google/genai";

// create a provider and conversation
const provider = new GoogleProvider(new GoogleGenAI({ apiKey: process.env.GOOGLE_API_KEY }), {
  model: MODEL_NAME,
});
using conversation = new Conversation(provider);

GoogleProviderConfig

interface GoogleProviderConfig {
  model: string;
  max_tokens?: number;
  thinking?: { enable: boolean; budget_tokens?: number };
}

Additional properties spread into the Gemini config object in the API request.

Thinking

Thinking captures the model's reasoning process as ThinkingMessageContent blocks in the conversation history.

const provider = new GoogleProvider(sdk, {
  model,
  max_tokens: 8192,
  thinking: { enable: true, budget_tokens: 10000 },
});

GoogleToolCodeContextTransformer

Gemini models sometimes emit tool calls as inline code blocks instead of structured function calls. GoogleToolCodeContextTransformer intercepts these and converts them to standard ToolContent entries so the workflow engine can execute them normally.

This transformer is bundled with GoogleProvider by default as a provider context transformer. To disable it, pass an empty array.

const provider = new GoogleProvider(sdk, config, []);

License

MIT