@opencode-ai/ai 0.0.0-bootstrap.0 → 0.0.0-next-15617

package/dist/protocols/gemini.d.ts

@@ -0,0 +1,220 @@
+import { Schema } from "effect";
+import { Route } from "../route/client";
+import { Protocol } from "../route/protocol";
+import { Lifecycle } from "./utils/lifecycle";
+export declare const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
+declare const GeminiBody: Schema.Struct<{
+    contents: Schema.$Array<Schema.Struct<{
+        readonly role: Schema.Literals<readonly ["user", "model"]>;
+        readonly parts: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly text: Schema.String;
+            readonly thought: Schema.optional<Schema.Boolean>;
+            readonly thoughtSignature: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly inlineData: Schema.Struct<{
+                readonly mimeType: Schema.String;
+                readonly data: Schema.String;
+            }>;
+        }>, Schema.Struct<{
+            readonly functionCall: Schema.Struct<{
+                readonly name: Schema.String;
+                readonly args: Schema.Unknown;
+            }>;
+            readonly thoughtSignature: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly functionResponse: Schema.Struct<{
+                readonly name: Schema.String;
+                readonly response: Schema.Unknown;
+            }>;
+        }>]>>;
+    }>>;
+    systemInstruction: Schema.optional<Schema.Struct<{
+        readonly parts: Schema.$Array<Schema.Struct<{
+            readonly text: Schema.String;
+        }>>;
+    }>>;
+    tools: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly functionDeclarations: Schema.$Array<Schema.Struct<{
+            readonly name: Schema.String;
+            readonly description: Schema.String;
+            readonly parameters: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+        }>>;
+    }>>>;
+    toolConfig: Schema.optional<Schema.Struct<{
+        readonly functionCallingConfig: Schema.Struct<{
+            readonly mode: Schema.Literals<readonly ["AUTO", "NONE", "ANY"]>;
+            readonly allowedFunctionNames: Schema.optional<Schema.$Array<Schema.String>>;
+        }>;
+    }>>;
+    generationConfig: Schema.optional<Schema.Struct<{
+        readonly maxOutputTokens: Schema.optional<Schema.Number>;
+        readonly temperature: Schema.optional<Schema.Number>;
+        readonly topP: Schema.optional<Schema.Number>;
+        readonly topK: Schema.optional<Schema.Number>;
+        readonly stopSequences: Schema.optional<Schema.$Array<Schema.String>>;
+        readonly thinkingConfig: Schema.optional<Schema.Struct<{
+            readonly thinkingBudget: Schema.optional<Schema.Number>;
+            readonly includeThoughts: Schema.optional<Schema.Boolean>;
+        }>>;
+    }>>;
+}>;
+export type GeminiBody = Schema.Schema.Type<typeof GeminiBody>;
+/**
+ * The Gemini protocol — request body construction, body schema, and the
+ * streaming-event state machine. Used by Google AI Studio Gemini and (once
+ * registered) Vertex Gemini.
+ */
+export declare const protocol: Protocol<{
+    readonly contents: readonly {
+        readonly role: "user" | "model";
+        readonly parts: readonly ({
+            readonly text: string;
+            readonly thought?: boolean | undefined;
+            readonly thoughtSignature?: string | undefined;
+        } | {
+            readonly inlineData: {
+                readonly mimeType: string;
+                readonly data: string;
+            };
+        } | {
+            readonly functionCall: {
+                readonly name: string;
+                readonly args: unknown;
+            };
+            readonly thoughtSignature?: string | undefined;
+        } | {
+            readonly functionResponse: {
+                readonly name: string;
+                readonly response: unknown;
+            };
+        })[];
+    }[];
+    readonly systemInstruction?: {
+        readonly parts: readonly {
+            readonly text: string;
+        }[];
+    } | undefined;
+    readonly tools?: readonly {
+        readonly functionDeclarations: readonly {
+            readonly name: string;
+            readonly description: string;
+            readonly parameters?: {
+                readonly [x: string]: unknown;
+            } | undefined;
+        }[];
+    }[] | undefined;
+    readonly toolConfig?: {
+        readonly functionCallingConfig: {
+            readonly mode: "AUTO" | "NONE" | "ANY";
+            readonly allowedFunctionNames?: readonly string[] | undefined;
+        };
+    } | undefined;
+    readonly generationConfig?: {
+        readonly maxOutputTokens?: number | undefined;
+        readonly temperature?: number | undefined;
+        readonly topP?: number | undefined;
+        readonly topK?: number | undefined;
+        readonly stopSequences?: readonly string[] | undefined;
+        readonly thinkingConfig?: {
+            readonly thinkingBudget?: number | undefined;
+            readonly includeThoughts?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+}, string, {
+    readonly candidates?: readonly {
+        readonly content?: {
+            readonly role: "user" | "model";
+            readonly parts: readonly ({
+                readonly text: string;
+                readonly thought?: boolean | undefined;
+                readonly thoughtSignature?: string | undefined;
+            } | {
+                readonly inlineData: {
+                    readonly mimeType: string;
+                    readonly data: string;
+                };
+            } | {
+                readonly functionCall: {
+                    readonly name: string;
+                    readonly args: unknown;
+                };
+                readonly thoughtSignature?: string | undefined;
+            } | {
+                readonly functionResponse: {
+                    readonly name: string;
+                    readonly response: unknown;
+                };
+            })[];
+        } | undefined;
+        readonly finishReason?: string | undefined;
+    }[] | undefined;
+    readonly usageMetadata?: {
+        readonly cachedContentTokenCount?: number | undefined;
+        readonly thoughtsTokenCount?: number | undefined;
+        readonly promptTokenCount?: number | undefined;
+        readonly candidatesTokenCount?: number | undefined;
+        readonly totalTokenCount?: number | undefined;
+    } | undefined;
+}, {
+    hasToolCalls: boolean;
+    nextToolCallId: number;
+    lifecycle: Lifecycle.State;
+}>;
+export declare const route: Route<{
+    readonly contents: readonly {
+        readonly role: "user" | "model";
+        readonly parts: readonly ({
+            readonly text: string;
+            readonly thought?: boolean | undefined;
+            readonly thoughtSignature?: string | undefined;
+        } | {
+            readonly inlineData: {
+                readonly mimeType: string;
+                readonly data: string;
+            };
+        } | {
+            readonly functionCall: {
+                readonly name: string;
+                readonly args: unknown;
+            };
+            readonly thoughtSignature?: string | undefined;
+        } | {
+            readonly functionResponse: {
+                readonly name: string;
+                readonly response: unknown;
+            };
+        })[];
+    }[];
+    readonly systemInstruction?: {
+        readonly parts: readonly {
+            readonly text: string;
+        }[];
+    } | undefined;
+    readonly tools?: readonly {
+        readonly functionDeclarations: readonly {
+            readonly name: string;
+            readonly description: string;
+            readonly parameters?: {
+                readonly [x: string]: unknown;
+            } | undefined;
+        }[];
+    }[] | undefined;
+    readonly toolConfig?: {
+        readonly functionCallingConfig: {
+            readonly mode: "AUTO" | "NONE" | "ANY";
+            readonly allowedFunctionNames?: readonly string[] | undefined;
+        };
+    } | undefined;
+    readonly generationConfig?: {
+        readonly maxOutputTokens?: number | undefined;
+        readonly temperature?: number | undefined;
+        readonly topP?: number | undefined;
+        readonly topK?: number | undefined;
+        readonly stopSequences?: readonly string[] | undefined;
+        readonly thinkingConfig?: {
+            readonly thinkingBudget?: number | undefined;
+            readonly includeThoughts?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+}, import("../route/transport/http").HttpPrepared<string>>;
+export * as Gemini from "./gemini";

package/dist/protocols/gemini.js

@@ -0,0 +1,420 @@
+import { Effect, Schema } from "effect";
+import { Route } from "../route/client";
+import { Auth } from "../route/auth";
+import { Endpoint } from "../route/endpoint";
+import { Framing } from "../route/framing";
+import { Protocol } from "../route/protocol";
+import { LLMEvent, Usage, } from "../schema";
+import { JsonObject, optionalArray, ProviderShared } from "./shared";
+import { GeminiToolSchema } from "./utils/gemini-tool-schema";
+import { Lifecycle } from "./utils/lifecycle";
+import { ToolSchemaProjection } from "./utils/tool-schema";
+const ADAPTER = "gemini";
+const MEDIA_MIMES = new Set(ProviderShared.MEDIA_MIMES);
+export const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
+// =============================================================================
+// Request Body Schema
+// =============================================================================
+const GeminiTextPart = Schema.Struct({
+    text: Schema.String,
+    thought: Schema.optional(Schema.Boolean),
+    thoughtSignature: Schema.optional(Schema.String),
+});
+const GeminiInlineDataPart = Schema.Struct({
+    inlineData: Schema.Struct({
+        mimeType: Schema.String,
+        data: Schema.String,
+    }),
+});
+const GeminiFunctionCallPart = Schema.Struct({
+    functionCall: Schema.Struct({
+        name: Schema.String,
+        args: Schema.Unknown,
+    }),
+    thoughtSignature: Schema.optional(Schema.String),
+});
+const GeminiFunctionResponsePart = Schema.Struct({
+    functionResponse: Schema.Struct({
+        name: Schema.String,
+        response: Schema.Unknown,
+    }),
+});
+const GeminiContentPart = Schema.Union([
+    GeminiTextPart,
+    GeminiInlineDataPart,
+    GeminiFunctionCallPart,
+    GeminiFunctionResponsePart,
+]);
+const GeminiContent = Schema.Struct({
+    role: Schema.Literals(["user", "model"]),
+    parts: Schema.Array(GeminiContentPart),
+});
+const GeminiSystemInstruction = Schema.Struct({
+    parts: Schema.Array(Schema.Struct({ text: Schema.String })),
+});
+const GeminiFunctionDeclaration = Schema.Struct({
+    name: Schema.String,
+    description: Schema.String,
+    parameters: Schema.optional(JsonObject),
+});
+const GeminiTool = Schema.Struct({
+    functionDeclarations: Schema.Array(GeminiFunctionDeclaration),
+});
+const GeminiToolConfig = Schema.Struct({
+    functionCallingConfig: Schema.Struct({
+        mode: Schema.Literals(["AUTO", "NONE", "ANY"]),
+        allowedFunctionNames: optionalArray(Schema.String),
+    }),
+});
+const GeminiThinkingConfig = Schema.Struct({
+    thinkingBudget: Schema.optional(Schema.Number),
+    includeThoughts: Schema.optional(Schema.Boolean),
+});
+const GeminiGenerationConfig = Schema.Struct({
+    maxOutputTokens: Schema.optional(Schema.Number),
+    temperature: Schema.optional(Schema.Number),
+    topP: Schema.optional(Schema.Number),
+    topK: Schema.optional(Schema.Number),
+    stopSequences: optionalArray(Schema.String),
+    thinkingConfig: Schema.optional(GeminiThinkingConfig),
+});
+const GeminiBodyFields = {
+    contents: Schema.Array(GeminiContent),
+    systemInstruction: Schema.optional(GeminiSystemInstruction),
+    tools: optionalArray(GeminiTool),
+    toolConfig: Schema.optional(GeminiToolConfig),
+    generationConfig: Schema.optional(GeminiGenerationConfig),
+};
+const GeminiBody = Schema.Struct(GeminiBodyFields);
+const GeminiUsage = Schema.Struct({
+    cachedContentTokenCount: Schema.optional(Schema.Number),
+    thoughtsTokenCount: Schema.optional(Schema.Number),
+    promptTokenCount: Schema.optional(Schema.Number),
+    candidatesTokenCount: Schema.optional(Schema.Number),
+    totalTokenCount: Schema.optional(Schema.Number),
+});
+const GeminiCandidate = Schema.Struct({
+    content: Schema.optional(GeminiContent),
+    finishReason: Schema.optional(Schema.String),
+});
+const GeminiEvent = Schema.Struct({
+    candidates: optionalArray(GeminiCandidate),
+    usageMetadata: Schema.optional(GeminiUsage),
+});
+// =============================================================================
+// Tool Schema Conversion
+// =============================================================================
+// Tool-schema conversion has two distinct concerns:
+//
+// 1. Sanitize — fix common authoring mistakes Gemini rejects: integer/number
+//    enums (must be strings), `required` entries that don't match a property,
+//    untyped arrays (`items` must be present), and `properties`/`required`
+//    keys on non-object scalars. Mirrors OpenCode's historical Gemini rules.
+//
+// 2. Project — lossy mapping from JSON Schema to Gemini's schema dialect:
+//    drop empty objects, derive `nullable: true` from `type: [..., "null"]`,
+//    coerce `const` to `[const]` enum, recurse properties/items, propagate
+//    only an allowlisted set of keys (description, required, format, type,
+//    properties, items, allOf, anyOf, oneOf, minLength). Anything outside the
+//    allowlist (e.g. `additionalProperties`, `$ref`) is silently dropped.
+//
+// Sanitize runs first, then project. The implementation lives in
+// `utils/gemini-tool-schema` so this protocol keeps the same shape as the other
+// provider protocols.
+// =============================================================================
+// Request Lowering
+// =============================================================================
+const lowerTool = (tool, inputSchema) => ({
+    name: tool.name,
+    description: tool.description,
+    parameters: GeminiToolSchema.convert(inputSchema),
+});
+const lowerToolConfig = (toolChoice) => ProviderShared.matchToolChoice("Gemini", toolChoice, {
+    auto: () => ({ functionCallingConfig: { mode: "AUTO" } }),
+    none: () => ({ functionCallingConfig: { mode: "NONE" } }),
+    required: () => ({ functionCallingConfig: { mode: "ANY" } }),
+    tool: (name) => ({ functionCallingConfig: { mode: "ANY", allowedFunctionNames: [name] } }),
+});
+const lowerUserPart = Effect.fn("Gemini.lowerUserPart")(function* (part) {
+    if (part.type === "text")
+        return { text: part.text };
+    const media = yield* ProviderShared.validateMedia("Gemini", part, MEDIA_MIMES);
+    return { inlineData: { mimeType: media.mime, data: media.base64 } };
+});
+const googleMetadata = (metadata) => ({ google: metadata });
+const thoughtSignature = (providerMetadata) => {
+    const google = providerMetadata?.google;
+    return ProviderShared.isRecord(google) && typeof google.thoughtSignature === "string"
+        ? google.thoughtSignature
+        : undefined;
+};
+const lowerToolCall = (part) => ({
+    functionCall: { name: part.name, args: part.input },
+    thoughtSignature: thoughtSignature(part.providerMetadata),
+});
+const lowerMessages = Effect.fn("Gemini.lowerMessages")(function* (request) {
+    const contents = [];
+    for (const message of request.messages) {
+        if (message.role === "system") {
+            const part = yield* ProviderShared.wrappedSystemUpdate("Gemini", message);
+            const previous = contents.at(-1);
+            if (previous?.role === "user")
+                contents[contents.length - 1] = { role: "user", parts: [...previous.parts, { text: part.text }] };
+            else
+                contents.push({ role: "user", parts: [{ text: part.text }] });
+            continue;
+        }
+        if (message.role === "user") {
+            const parts = [];
+            for (const part of message.content) {
+                if (!ProviderShared.supportsContent(part, ["text", "media"]))
+                    return yield* ProviderShared.unsupportedContent("Gemini", "user", ["text", "media"]);
+                parts.push(yield* lowerUserPart(part));
+            }
+            contents.push({ role: "user", parts });
+            continue;
+        }
+        if (message.role === "assistant") {
+            const parts = [];
+            for (const part of message.content) {
+                if (!ProviderShared.supportsContent(part, ["text", "reasoning", "tool-call"]))
+                    return yield* ProviderShared.unsupportedContent("Gemini", "assistant", ["text", "reasoning", "tool-call"]);
+                if (part.type === "text") {
+                    parts.push({ text: part.text });
+                    continue;
+                }
+                if (part.type === "reasoning") {
+                    parts.push({ text: part.text, thought: true, thoughtSignature: thoughtSignature(part.providerMetadata) });
+                    continue;
+                }
+                if (part.type === "tool-call") {
+                    parts.push(lowerToolCall(part));
+                    continue;
+                }
+            }
+            contents.push({ role: "model", parts });
+            continue;
+        }
+        const parts = [];
+        for (const part of message.content) {
+            if (!ProviderShared.supportsContent(part, ["tool-result"]))
+                return yield* ProviderShared.unsupportedContent("Gemini", "tool", ["tool-result"]);
+            if (part.result.type !== "content") {
+                parts.push({
+                    functionResponse: {
+                        name: part.name,
+                        response: {
+                            name: part.name,
+                            content: ProviderShared.toolResultText(part),
+                        },
+                    },
+                });
+                continue;
+            }
+            const content = part.result.value;
+            const text = content.filter((item) => item.type === "text").map((item) => item.text);
+            parts.push({
+                functionResponse: {
+                    name: part.name,
+                    response: {
+                        name: part.name,
+                        content: text.join("\n"),
+                    },
+                },
+            });
+            for (const item of content) {
+                if (item.type === "text")
+                    continue;
+                const media = yield* ProviderShared.validateToolFile("Gemini", item, MEDIA_MIMES);
+                parts.push({ inlineData: { mimeType: media.mime, data: media.base64 } });
+            }
+        }
+        contents.push({ role: "user", parts });
+    }
+    return contents;
+});
+const geminiOptions = (request) => request.providerOptions?.gemini;
+const thinkingConfig = (request) => {
+    const value = geminiOptions(request)?.thinkingConfig;
+    if (!ProviderShared.isRecord(value))
+        return undefined;
+    const result = {
+        thinkingBudget: typeof value.thinkingBudget === "number" ? value.thinkingBudget : undefined,
+        includeThoughts: typeof value.includeThoughts === "boolean" ? value.includeThoughts : undefined,
+    };
+    return Object.values(result).some((item) => item !== undefined) ? result : undefined;
+};
+const fromRequest = Effect.fn("Gemini.fromRequest")(function* (request) {
+    const toolsEnabled = request.tools.length > 0 && request.toolChoice?.type !== "none";
+    const generation = request.generation;
+    const toolSchemaCompatibility = request.model.compatibility?.toolSchema;
+    const generationConfig = {
+        maxOutputTokens: generation?.maxTokens,
+        temperature: generation?.temperature,
+        topP: generation?.topP,
+        topK: generation?.topK,
+        stopSequences: generation?.stop,
+        thinkingConfig: thinkingConfig(request),
+    };
+    return {
+        contents: yield* lowerMessages(request),
+        systemInstruction: request.system.length === 0 ? undefined : { parts: [{ text: ProviderShared.joinText(request.system) }] },
+        tools: toolsEnabled
+            ? [
+                {
+                    functionDeclarations: request.tools.map((tool) => lowerTool(tool, ToolSchemaProjection.modelCompatibility(tool.inputSchema, toolSchemaCompatibility))),
+                },
+            ]
+            : undefined,
+        toolConfig: toolsEnabled && request.toolChoice ? yield* lowerToolConfig(request.toolChoice) : undefined,
+        generationConfig: Object.values(generationConfig).some((value) => value !== undefined)
+            ? generationConfig
+            : undefined,
+    };
+});
+// =============================================================================
+// Stream Parsing
+// =============================================================================
+// Gemini reports `promptTokenCount` (inclusive total) with a
+// `cachedContentTokenCount` subset. `candidatesTokenCount` is *exclusive*
+// of `thoughtsTokenCount` — visible-only, not a total — so we sum the two
+// to produce the inclusive `outputTokens` the rest of the contract expects.
+const mapUsage = (usage) => {
+    if (!usage)
+        return undefined;
+    const cached = usage.cachedContentTokenCount;
+    const nonCached = ProviderShared.subtractTokens(usage.promptTokenCount, cached);
+    // `candidatesTokenCount` is visible-only; sum with thoughts to produce the
+    // inclusive `outputTokens` the contract expects. Only compute the total
+    // when the visible component is reported — otherwise we'd fabricate an
+    // inclusive number from a partial breakdown.
+    const outputTokens = usage.candidatesTokenCount !== undefined ? usage.candidatesTokenCount + (usage.thoughtsTokenCount ?? 0) : undefined;
+    return new Usage({
+        inputTokens: usage.promptTokenCount,
+        outputTokens,
+        nonCachedInputTokens: nonCached,
+        cacheReadInputTokens: cached,
+        reasoningTokens: usage.thoughtsTokenCount,
+        totalTokens: ProviderShared.totalTokens(usage.promptTokenCount, outputTokens, usage.totalTokenCount),
+        providerMetadata: { google: usage },
+    });
+};
+const mapFinishReason = (finishReason, hasToolCalls) => {
+    if (finishReason === "STOP")
+        return hasToolCalls ? "tool-calls" : "stop";
+    if (finishReason === "MAX_TOKENS")
+        return "length";
+    if (finishReason === "IMAGE_SAFETY" ||
+        finishReason === "RECITATION" ||
+        finishReason === "SAFETY" ||
+        finishReason === "BLOCKLIST" ||
+        finishReason === "PROHIBITED_CONTENT" ||
+        finishReason === "SPII")
+        return "content-filter";
+    if (finishReason === "MALFORMED_FUNCTION_CALL")
+        return "error";
+    return "unknown";
+};
+const finish = (state) => state.finishReason || state.usage
+    ? (() => {
+        const events = [];
+        const lifecycle = state.reasoningSignature
+            ? Lifecycle.reasoningEnd(state.lifecycle, events, "reasoning-0", googleMetadata({ thoughtSignature: state.reasoningSignature }))
+            : state.lifecycle;
+        Lifecycle.finish(lifecycle, events, {
+            reason: mapFinishReason(state.finishReason, state.hasToolCalls),
+            usage: state.usage,
+        });
+        return events;
+    })()
+    : [];
+const step = (state, event) => {
+    const nextState = {
+        ...state,
+        usage: event.usageMetadata ? (mapUsage(event.usageMetadata) ?? state.usage) : state.usage,
+    };
+    const candidate = event.candidates?.[0];
+    if (!candidate?.content)
+        return Effect.succeed([
+            { ...nextState, finishReason: candidate?.finishReason ?? nextState.finishReason },
+            [],
+        ]);
+    const events = [];
+    let hasToolCalls = nextState.hasToolCalls;
+    let lifecycle = nextState.lifecycle;
+    let nextToolCallId = nextState.nextToolCallId;
+    let reasoningSignature = nextState.reasoningSignature;
+    for (const part of candidate.content.parts) {
+        if ("thoughtSignature" in part && part.thoughtSignature && "thought" in part && part.thought)
+            reasoningSignature = part.thoughtSignature;
+        if ("text" in part && part.text.length > 0) {
+            if (part.thought) {
+                lifecycle = Lifecycle.reasoningDelta(lifecycle, events, "reasoning-0", part.text, part.thoughtSignature ? googleMetadata({ thoughtSignature: part.thoughtSignature }) : undefined);
+                continue;
+            }
+            lifecycle = Lifecycle.reasoningEnd(lifecycle, events, "reasoning-0", reasoningSignature ? googleMetadata({ thoughtSignature: reasoningSignature }) : undefined);
+            lifecycle = Lifecycle.textDelta(lifecycle, events, "text-0", part.text);
+            continue;
+        }
+        if ("functionCall" in part) {
+            const input = part.functionCall.args;
+            const id = `tool_${nextToolCallId++}`;
+            lifecycle = Lifecycle.reasoningEnd(lifecycle, events, "reasoning-0", reasoningSignature ? googleMetadata({ thoughtSignature: reasoningSignature }) : undefined);
+            lifecycle = Lifecycle.stepStart(lifecycle, events);
+            events.push(LLMEvent.toolCall({
+                id,
+                name: part.functionCall.name,
+                input,
+                providerMetadata: part.thoughtSignature
+                    ? googleMetadata({ thoughtSignature: part.thoughtSignature })
+                    : undefined,
+            }));
+            hasToolCalls = true;
+        }
+    }
+    return Effect.succeed([
+        {
+            ...nextState,
+            hasToolCalls,
+            lifecycle,
+            nextToolCallId,
+            reasoningSignature,
+            finishReason: candidate.finishReason ?? nextState.finishReason,
+        },
+        events,
+    ]);
+};
+// =============================================================================
+// Protocol And Gemini Route
+// =============================================================================
+/**
+ * The Gemini protocol — request body construction, body schema, and the
+ * streaming-event state machine. Used by Google AI Studio Gemini and (once
+ * registered) Vertex Gemini.
+ */
+export const protocol = Protocol.make({
+    id: ADAPTER,
+    body: {
+        schema: GeminiBody,
+        from: fromRequest,
+    },
+    stream: {
+        event: Protocol.jsonEvent(GeminiEvent),
+        initial: () => ({ hasToolCalls: false, nextToolCallId: 0, lifecycle: Lifecycle.initial() }),
+        step,
+        onHalt: finish,
+    },
+});
+export const route = Route.make({
+    id: ADAPTER,
+    provider: "google",
+    providerMetadataKey: "google",
+    protocol,
+    // Gemini's path embeds the model id and pins SSE framing at the URL level.
+    endpoint: Endpoint.path(({ request }) => `/models/${request.model.id}:streamGenerateContent?alt=sse`, {
+        baseURL: DEFAULT_BASE_URL,
+    }),
+    auth: Auth.none,
+    framing: Framing.sse,
+});
+export * as Gemini from "./gemini";