@kindgi/adapter-model-gemini 0.0.0-bootstrap.0 → 0.1.0

package/dist/provider.js

@@ -0,0 +1,168 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { GoogleGenAI, } from '@google/genai';
+import { computeCostUsd, toFrameworkUsage } from './cost.js';
+import { fromGeminiResponse, toGeminiFunctions, toGeminiRequest } from './translate.js';
+/** The adapter id servers register `geminiAdapterFactory` under. */
+export const GEMINI_ADAPTER_ID = '@kindgi/adapter-model-gemini';
+const CLOUD_PLATFORM_SCOPE = 'https://www.googleapis.com/auth/cloud-platform';
+/**
+ * A Gemini `ModelProvider` on Vertex AI. Non-streaming, tool-use enabled:
+ * one `generateContent` call per `invoke`.
+ */
+export function createGeminiProvider(options) {
+    const { metadata } = options;
+    checkVertexTarget(metadata.id, options.vertex);
+    const modelsByName = new Map(metadata.models.map((m) => [m.name, m]));
+    // One client per credential: reused while the resolved key stays the
+    // same, rebuilt when it rotates. `''` stands for ADC.
+    let cached;
+    async function resolveClient() {
+        if (options.client !== undefined)
+            return options.client;
+        const key = options.credentials !== undefined ? await options.credentials() : '';
+        if (cached?.key === key)
+            return cached.client;
+        const client = new GoogleGenAI({
+            vertexai: true,
+            project: options.vertex.project,
+            location: options.vertex.location,
+            ...(key !== '' && {
+                googleAuthOptions: {
+                    credentials: parseServiceAccountKey(key),
+                    scopes: [CLOUD_PLATFORM_SCOPE],
+                },
+            }),
+        });
+        cached = { key, client };
+        return client;
+    }
+    return {
+        metadata,
+        async invoke(input) {
+            const model = modelsByName.get(input.model);
+            if (model === undefined) {
+                throw new Error(`${GEMINI_ADAPTER_ID}: provider "${metadata.id}" does not expose model "${input.model}". ` +
+                    `Available: ${[...modelsByName.keys()].join(', ') || '<none>'}.`);
+            }
+            const startedAt = Date.now();
+            const { systemInstruction, contents } = toGeminiRequest(input.messages);
+            const maxOutputTokens = input.maxOutputTokens ?? model.maxOutputTokens;
+            const config = {
+                ...(systemInstruction !== undefined && { systemInstruction }),
+                ...(input.tools !== undefined &&
+                    input.tools.length > 0 && {
+                    tools: [{ functionDeclarations: [...toGeminiFunctions(input.tools)] }],
+                }),
+                ...(input.structuredOutput !== undefined && {
+                    responseMimeType: 'application/json',
+                    responseJsonSchema: input.structuredOutput.schema,
+                }),
+                ...(input.temperature !== undefined && { temperature: input.temperature }),
+                ...(maxOutputTokens !== undefined && { maxOutputTokens }),
+                ...(input.abortSignal !== undefined && { abortSignal: input.abortSignal }),
+            };
+            const client = await resolveClient();
+            const response = await client.models.generateContent({
+                model: input.model,
+                contents: [...contents],
+                config,
+            });
+            const { message, finishReason } = fromGeminiResponse(response);
+            const usage = toFrameworkUsage(response.usageMetadata);
+            return {
+                message,
+                finishReason,
+                usage,
+                costUsd: computeCostUsd(usage, model.cost),
+                durationMs: Date.now() - startedAt,
+                provider: { id: metadata.id, model: input.model },
+            };
+        },
+    };
+}
+/**
+ * A service-account key's JSON, reduced to the fields a service-account
+ * key has. google-auth-library acts on a credential's `type`: an
+ * `external_account` fetches URLs it names (with its headers) and reads
+ * files it names, `token_uri` and `universe_domain` move the token
+ * exchange. A tenant writes this secret, so only `service_account` is
+ * accepted, and Google's own token endpoint is always used.
+ */
+export function parseServiceAccountKey(key) {
+    let parsed;
+    try {
+        parsed = JSON.parse(key);
+    }
+    catch {
+        throw new Error(`${GEMINI_ADAPTER_ID}: the credential isn't a service-account key (not JSON).`);
+    }
+    if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`${GEMINI_ADAPTER_ID}: the credential isn't a service-account key (not an object).`);
+    }
+    const fields = parsed;
+    if (fields.type !== 'service_account') {
+        throw new Error(`${GEMINI_ADAPTER_ID}: the credential must be a service-account key ("type": "service_account"); other credential types aren't accepted.`);
+    }
+    if (typeof fields.client_email !== 'string' || typeof fields.private_key !== 'string') {
+        throw new Error(`${GEMINI_ADAPTER_ID}: the credential isn't a service-account key (no client_email / private_key).`);
+    }
+    const reduced = {
+        type: 'service_account',
+        client_email: fields.client_email,
+        private_key: fields.private_key,
+    };
+    for (const optional of ['project_id', 'private_key_id', 'client_id']) {
+        const value = fields[optional];
+        if (typeof value === 'string')
+            reduced[optional] = value;
+    }
+    return reduced;
+}
+/**
+ * The adapter factory servers register under `GEMINI_ADAPTER_ID`. A
+ * provider registered with it carries:
+ *
+ *   - `adapter_config.project` — the Vertex AI project (required);
+ *   - `metadata.region` — the Vertex location (`global`, `us-central1`,
+ *     `northamerica-northeast1`, …); `'unspecified'` means `global`;
+ *   - `secret_ref` (optional) — a service-account key. Without one the
+ *     adapter uses Application Default Credentials.
+ */
+export const geminiAdapterFactory = (input) => createGeminiProvider({
+    metadata: input.metadata,
+    vertex: vertexTarget(input),
+    ...(input.resolveApiKey !== undefined && { credentials: input.resolveApiKey }),
+});
+/** The Vertex project and location a registration names (see `geminiAdapterFactory`). */
+export function vertexTarget(input) {
+    const project = input.config?.project;
+    if (typeof project !== 'string' || project.length === 0) {
+        throw new Error(`${GEMINI_ADAPTER_ID}: provider "${input.metadata.id}" needs adapter_config.project (the Vertex AI project).`);
+    }
+    const target = {
+        project,
+        location: input.metadata.region === 'unspecified' ? 'global' : input.metadata.region,
+    };
+    checkVertexTarget(input.metadata.id, target);
+    return target;
+}
+/**
+ * The SDK puts the project in the request path and builds the hostname
+ * from the location (`https://<location>-aiplatform.googleapis.com/`):
+ * anything but a project id and one DNS label could move the request,
+ * with the server's credentials, to another host.
+ */
+function checkVertexTarget(providerId, vertex) {
+    if (!VERTEX_PROJECT.test(vertex.project)) {
+        throw new Error(`${GEMINI_ADAPTER_ID}: provider "${providerId}" adapter_config.project must be a Google Cloud project id or number.`);
+    }
+    if (!VERTEX_LOCATION.test(vertex.location)) {
+        throw new Error(`${GEMINI_ADAPTER_ID}: provider "${providerId}" metadata.region must be a Vertex AI location (one DNS label, e.g. us-central1).`);
+    }
+}
+/** A Google Cloud project id (6–30: lowercase, digits, hyphens) or project number. */
+const VERTEX_PROJECT = /^(?:[a-z][a-z0-9-]{4,28}[a-z0-9]|[0-9]{1,20})$/;
+/** A Vertex AI location: one DNS label. */
+const VERTEX_LOCATION = /^[a-z][a-z0-9-]{0,62}$/;
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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"}

package/dist/translate.d.ts

@@ -0,0 +1,49 @@
+import type { Content, FunctionDeclaration, GenerateContentResponse } from '@google/genai';
+import type { ModelCallResult, ModelMessage, ModelToolDefinition } from '@kindgi/capabilities';
+export declare function checkFunctionName(name: string): string;
+/**
+ * The framework's message trail as a Gemini request:
+ *
+ *   - `system` messages lift into `systemInstruction` (several join with
+ *     a blank line, in order);
+ *   - `user` messages become `user` turns; `assistant` messages become
+ *     `model` turns — text, then one `functionCall` part per tool call,
+ *     carrying the call's thought signature back;
+ *   - `tool` messages become `functionResponse` parts in a `user` turn.
+ *     Gemini names the function it answers, so the name comes from the
+ *     assistant tool call with the same id. The tool's output goes under
+ *     `response.output` (parsed when it is JSON).
+ *
+ * Consecutive turns of the same role merge into one `Content`.
+ */
+export declare function toGeminiRequest(messages: readonly ModelMessage[]): {
+    readonly systemInstruction: string | undefined;
+    readonly contents: readonly Content[];
+};
+/**
+ * Tool definitions as Gemini function declarations. The input schema is
+ * full JSON Schema, which `parametersJsonSchema` takes as it is.
+ */
+export declare function toGeminiFunctions(tools: readonly ModelToolDefinition[]): readonly FunctionDeclaration[];
+/**
+ * A Gemini response as the framework's assistant message: the text of
+ * the first candidate (thinking parts left out), and a tool call per
+ * `functionCall` part, with its thought signature. Gemini may omit the
+ * call id; one is generated then, so the tool result can refer to it.
+ */
+export declare function fromGeminiResponse(response: GenerateContentResponse): {
+    readonly message: ModelMessage;
+    readonly finishReason: ModelCallResult['finishReason'];
+};
+/**
+ * Gemini's `finishReason` as the framework's:
+ *   - `STOP`, unspecified or absent → `stop` (a response with function
+ *     calls is `tool-use` before this is consulted);
+ *   - `MAX_TOKENS` → `length`;
+ *   - the safety, recitation, blocklist and sensitive-data stops →
+ *     `content-filter`;
+ *   - anything else (a malformed or unexpected function call, too many
+ *     tool calls, an unsupported language, `OTHER`) → `error`.
+ */
+export declare function mapFinishReason(reason: string | undefined): ModelCallResult['finishReason'];
+//# sourceMappingURL=translate.d.ts.map

package/dist/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,OAAO,EAEP,mBAAmB,EACnB,uBAAuB,EAExB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAEZ,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAS9B,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG;IAClE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CACvC,CAuBA;AAiDD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,SAAS,mBAAmB,EAAE,CAMhC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,uBAAuB,GAAG;IACrE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;CACxD,CA2BA;AAsBD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAAC,cAAc,CAAC,CAO3F"}

package/dist/translate.js

@@ -0,0 +1,179 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+import { randomUUID } from 'node:crypto';
+/**
+ * Gemini function names: a letter or `_` first, then letters, digits,
+ * `_ . : -`, at most 64 characters. The framework's `<pack>.<tool>` ids
+ * fit as they are, so names go over the wire unchanged.
+ */
+const FUNCTION_NAME = /^[A-Za-z_][A-Za-z0-9_.:-]{0,63}$/;
+export function checkFunctionName(name) {
+    if (!FUNCTION_NAME.test(name)) {
+        throw new Error(`@kindgi/adapter-model-gemini: tool "${name}" isn't a valid Gemini function name (a letter or _ first, then letters, digits, _ . : -, at most 64 characters).`);
+    }
+    return name;
+}
+/**
+ * The framework's message trail as a Gemini request:
+ *
+ *   - `system` messages lift into `systemInstruction` (several join with
+ *     a blank line, in order);
+ *   - `user` messages become `user` turns; `assistant` messages become
+ *     `model` turns — text, then one `functionCall` part per tool call,
+ *     carrying the call's thought signature back;
+ *   - `tool` messages become `functionResponse` parts in a `user` turn.
+ *     Gemini names the function it answers, so the name comes from the
+ *     assistant tool call with the same id. The tool's output goes under
+ *     `response.output` (parsed when it is JSON).
+ *
+ * Consecutive turns of the same role merge into one `Content`.
+ */
+export function toGeminiRequest(messages) {
+    const systemParts = [];
+    const contents = [];
+    const callNames = new Map();
+    for (const msg of messages) {
+        if (msg.role === 'system') {
+            if (msg.content.length > 0)
+                systemParts.push(msg.content);
+        }
+        else if (msg.role === 'user') {
+            append(contents, 'user', [{ text: msg.content }]);
+        }
+        else if (msg.role === 'assistant') {
+            const parts = modelParts(msg, callNames);
+            // An empty model turn is invalid; the agent loop never produces one.
+            if (parts.length > 0)
+                append(contents, 'model', parts);
+        }
+        else {
+            append(contents, 'user', [functionResponsePart(msg, callNames)]);
+        }
+    }
+    return {
+        systemInstruction: systemParts.length > 0 ? systemParts.join('\n\n') : undefined,
+        contents,
+    };
+}
+/** An assistant message's parts: its text, then a `functionCall` per tool call. */
+function modelParts(msg, callNames) {
+    const parts = msg.content.length > 0 ? [{ text: msg.content }] : [];
+    for (const call of msg.toolCalls ?? []) {
+        callNames.set(call.id, call.name);
+        parts.push({
+            functionCall: {
+                id: call.id,
+                name: checkFunctionName(call.name),
+                args: { ...call.arguments },
+            },
+            ...(call.signature !== undefined && { thoughtSignature: call.signature }),
+        });
+    }
+    return parts;
+}
+/** A tool result, named after the call it answers. */
+function functionResponsePart(msg, callNames) {
+    const id = msg.toolCallId ?? '';
+    const name = callNames.get(id);
+    if (name === undefined) {
+        throw new Error(`@kindgi/adapter-model-gemini: a tool result answers call "${id}", which no earlier assistant turn made.`);
+    }
+    return { functionResponse: { id, name, response: { output: parseOutput(msg.content) } } };
+}
+function append(contents, role, parts) {
+    const last = contents[contents.length - 1];
+    if (last !== undefined && last.role === role) {
+        last.parts = [...(last.parts ?? []), ...parts];
+        return;
+    }
+    contents.push({ role, parts: [...parts] });
+}
+/** A tool's output: its JSON value when it is JSON, else the text. */
+function parseOutput(content) {
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return content;
+    }
+}
+/**
+ * Tool definitions as Gemini function declarations. The input schema is
+ * full JSON Schema, which `parametersJsonSchema` takes as it is.
+ */
+export function toGeminiFunctions(tools) {
+    return tools.map((t) => ({
+        name: checkFunctionName(t.name),
+        description: t.description,
+        parametersJsonSchema: t.inputSchema,
+    }));
+}
+/**
+ * A Gemini response as the framework's assistant message: the text of
+ * the first candidate (thinking parts left out), and a tool call per
+ * `functionCall` part, with its thought signature. Gemini may omit the
+ * call id; one is generated then, so the tool result can refer to it.
+ */
+export function fromGeminiResponse(response) {
+    const candidate = response.candidates?.[0];
+    if (candidate === undefined) {
+        // No candidate: the prompt itself was blocked.
+        const blocked = response.promptFeedback?.blockReason !== undefined;
+        return {
+            message: { role: 'assistant', content: '' },
+            finishReason: blocked ? 'content-filter' : 'error',
+        };
+    }
+    const parts = candidate.content?.parts ?? [];
+    const text = parts
+        .filter((part) => part.functionCall === undefined && part.thought !== true)
+        .map((part) => part.text ?? '');
+    const toolCalls = parts.flatMap((part) => part.functionCall !== undefined ? [toToolCall(part.functionCall, part.thoughtSignature)] : []);
+    return {
+        message: {
+            role: 'assistant',
+            content: text.join(''),
+            ...(toolCalls.length > 0 && { toolCalls }),
+        },
+        finishReason: toolCalls.length > 0 ? 'tool-use' : mapFinishReason(candidate.finishReason),
+    };
+}
+function toToolCall(call, signature) {
+    return {
+        id: call.id ?? `gemini-call-${randomUUID()}`,
+        name: call.name ?? '',
+        arguments: (call.args ?? {}),
+        ...(signature !== undefined && { signature }),
+    };
+}
+const FILTERED = new Set([
+    'SAFETY',
+    'RECITATION',
+    'BLOCKLIST',
+    'PROHIBITED_CONTENT',
+    'SPII',
+    'IMAGE_SAFETY',
+    'IMAGE_PROHIBITED_CONTENT',
+    'IMAGE_RECITATION',
+]);
+/**
+ * Gemini's `finishReason` as the framework's:
+ *   - `STOP`, unspecified or absent → `stop` (a response with function
+ *     calls is `tool-use` before this is consulted);
+ *   - `MAX_TOKENS` → `length`;
+ *   - the safety, recitation, blocklist and sensitive-data stops →
+ *     `content-filter`;
+ *   - anything else (a malformed or unexpected function call, too many
+ *     tool calls, an unsupported language, `OTHER`) → `error`.
+ */
+export function mapFinishReason(reason) {
+    if (reason === undefined || reason === 'STOP' || reason === 'FINISH_REASON_UNSPECIFIED') {
+        return 'stop';
+    }
+    if (reason === 'MAX_TOKENS')
+        return 'length';
+    if (FILTERED.has(reason))
+        return 'content-filter';
+    return 'error';
+}
+//# sourceMappingURL=translate.js.map

package/dist/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,51 @@
 {
   "name": "@kindgi/adapter-model-gemini",
-  "version": "0.0.0-bootstrap.0",
-  "description": "Placeholder so a trusted publisher can be attached. Releases are published from https://github.com/kindgi/kindgi-sdk with provenance; use 0.1.0 or later.",
+  "version": "0.1.0",
+  "description": "Gemini ModelProvider for @kindgi/capabilities, on Vertex AI. Wraps @google/genai with the framework's provider-neutral interface: message-trail ↔ generateContent translation, function calling with thought signatures, token and cost accounting including thinking tokens, and Google Application Default Credentials (or a service-account key from the secret store). Non-streaming, tool-use enabled.",
   "license": "Apache-2.0",
-  "repository": { "type": "git", "url": "git+https://github.com/kindgi/kindgi-sdk.git" }
-}
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kindgi/kindgi-sdk.git",
+    "directory": "packages/adapters/model-gemini"
+  },
+  "homepage": "https://github.com/kindgi/kindgi-sdk/tree/main/packages/adapters/model-gemini#readme",
+  "bugs": {
+    "url": "https://github.com/kindgi/kindgi-sdk/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "dependencies": {
+    "@kindgi/capabilities": "0.1.0",
+    "@google/genai": "^2.24.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}

package/src/cost.ts

@@ -0,0 +1,73 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+
+import type { GenerateContentResponseUsageMetadata } from '@google/genai';
+import type { ModelInfo, UsageCounters } from '@kindgi/capabilities';
+
+/**
+ * Cached prompt tokens bill at this fraction of the prompt rate unless a
+ * model says otherwise — Gemini 2.5's implicit-cache discount (75% off).
+ */
+export const DEFAULT_CACHED_PROMPT_MULTIPLIER = 0.25;
+
+/** A model's rates, per 1K tokens, with Gemini's two pricing extras. */
+export interface GeminiCostRates {
+  readonly promptUsdPer1kTokens: number;
+  readonly completionUsdPer1kTokens: number;
+  /** Cached prompt tokens' share of the prompt rate. Default 0.25. */
+  readonly cachedPromptMultiplier?: number;
+  /**
+   * Long-context pricing: when a call's prompt exceeds `thresholdTokens`,
+   * the whole call bills at these rates (Gemini 2.5 Pro doubles above
+   * 200K prompt tokens, for example).
+   */
+  readonly longContext?: {
+    readonly thresholdTokens: number;
+    readonly promptUsdPer1kTokens: number;
+    readonly completionUsdPer1kTokens: number;
+  };
+}
+
+/** `ModelInfo` whose `cost` takes Gemini's cached-token and long-context rates. */
+export interface GeminiModelInfo extends ModelInfo {
+  readonly cost: ModelInfo['cost'] & Omit<GeminiCostRates, keyof ModelInfo['cost']>;
+}
+
+/**
+ * Gemini's usage as the framework's counters. Thinking tokens bill as
+ * output, so they count as completion tokens; the prompt count includes
+ * cached tokens and the tokens of built-in tool prompts.
+ */
+export function toFrameworkUsage(
+  usage: GenerateContentResponseUsageMetadata | undefined,
+): UsageCounters {
+  const cached = usage?.cachedContentTokenCount ?? 0;
+  return {
+    promptTokens: (usage?.promptTokenCount ?? 0) + (usage?.toolUsePromptTokenCount ?? 0),
+    completionTokens: (usage?.candidatesTokenCount ?? 0) + (usage?.thoughtsTokenCount ?? 0),
+    ...(cached > 0 && { cachedTokens: cached }),
+  };
+}
+
+/**
+ * A call's cost in USD: uncached prompt tokens at the prompt rate, cached
+ * ones at the cached share of it, completion (thinking included) at the
+ * completion rate — the long-context rates when the prompt is past the
+ * model's threshold.
+ */
+export function computeCostUsd(usage: UsageCounters, rates: GeminiCostRates): number {
+  const long =
+    rates.longContext !== undefined && usage.promptTokens > rates.longContext.thresholdTokens
+      ? rates.longContext
+      : undefined;
+  const promptRate = long?.promptUsdPer1kTokens ?? rates.promptUsdPer1kTokens;
+  const completionRate = long?.completionUsdPer1kTokens ?? rates.completionUsdPer1kTokens;
+  const cached = usage.cachedTokens ?? 0;
+  const multiplier = rates.cachedPromptMultiplier ?? DEFAULT_CACHED_PROMPT_MULTIPLIER;
+  return (
+    ((usage.promptTokens - cached) * promptRate +
+      cached * promptRate * multiplier +
+      usage.completionTokens * completionRate) /
+    1000
+  );
+}

package/src/index.ts

@@ -0,0 +1,20 @@
+// SPDX-License-Identifier: Apache-2.0
+// Copyright (C) 2026 Kindgi Inc.
+
+export {
+  GEMINI_ADAPTER_ID,
+  createGeminiProvider,
+  geminiAdapterFactory,
+  vertexTarget,
+} from './provider.js';
+export type { GeminiClient, GeminiProviderOptions } from './provider.js';
+export { DEFAULT_CACHED_PROMPT_MULTIPLIER, computeCostUsd, toFrameworkUsage } from './cost.js';
+export type { GeminiCostRates, GeminiModelInfo } from './cost.js';
+export {
+  checkFunctionName,
+  fromGeminiResponse,
+  mapFinishReason,
+  toGeminiFunctions,
+  toGeminiRequest,
+} from './translate.js';
+export type { ModelProvider } from '@kindgi/capabilities';