@demicodes/provider-google 0.8.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,17 @@
+# @demicodes/provider-google
+
+A Demi provider for the Google Gemini API (`generateContent`). Exposes
+`createGoogleProvider()`.
+
+```ts
+import { createGoogleProvider } from '@demicodes/provider-google'
+```
+
+Reads `GOOGLE_API_KEY` / `GOOGLE_BASE_URL` by default (`envPrefix` changes the
+pair). Unlike the OpenAI-compatible route, this talks the native API, so video
+is a real inline part — the model reads the frames *and* the audio track — and
+thought summaries, thought signatures and thinking token counts all arrive as
+first-class fields instead of tags glued into the answer text.
+
+Implements the [`@demicodes/provider`](../provider/README.md) contract. Part of
+[Demi](../../README.md). Apache-2.0.

package/dist/index.d.mts

@@ -0,0 +1,57 @@
+import { Provider, ProviderModel, ProviderModelList } from "@demicodes/provider";
+//#region src/models.d.ts
+interface GoogleModelOptions {
+  id: string;
+  displayName?: string;
+  description?: string;
+  contextWindow: number;
+  outputLimit?: number | null;
+  supportsTools?: boolean | null;
+  supportsAttachments?: boolean | null;
+  /** Gemini takes video natively (inline `inlineData` parts), audio track included. */
+  supportsVideo?: boolean | null;
+  supportsReasoning?: boolean | null;
+  supportedThinkingEfforts?: string[] | null;
+  defaultThinkingEffort?: string | null;
+  canDisableThinking?: boolean | null;
+  serviceTiers?: ProviderModel['serviceTiers'];
+  defaultServiceTierId?: string | null;
+}
+declare function googleDefaultModels(providerId?: string): ProviderModelList;
+//#endregion
+//#region src/provider.d.ts
+type GoogleSecretResolver = () => string | Promise<string> | null | undefined;
+type GoogleHeadersResolver = () => Record<string, string> | Promise<Record<string, string>>;
+type GoogleFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+interface GoogleRequestOptions {
+  /** Overrides the derived maxOutputTokens (default: the model's outputLimit, else 32000). */
+  maxOutputTokens?: number;
+  /**
+   * Thinking budget used when an effort config is mapped onto Gemini's
+   * `thinkingBudget` knob. Merged over the built-in ladder
+   * (low 4k / medium 16k / high 32k / xhigh 64k / max 96k).
+   */
+  effortBudgetTokens?: Record<string, number>;
+  /**
+   * Ask the API to stream thought summaries. On by default: without it the model
+   * still thinks (and still bills `thoughtsTokenCount`) but the product has
+   * nothing to show for the pause.
+   */
+  includeThoughts?: boolean;
+  extraBody?: Record<string, unknown>;
+}
+interface GoogleProviderOptions {
+  id?: string;
+  displayName?: string;
+  envPrefix?: string;
+  baseUrl?: string;
+  apiKey?: GoogleSecretResolver;
+  headers?: GoogleHeadersResolver;
+  models?: GoogleModelOptions[];
+  defaultModelId?: string;
+  request?: GoogleRequestOptions;
+  fetch?: GoogleFetch;
+}
+declare function createGoogleProvider(options?: GoogleProviderOptions): Provider;
+//#endregion
+export { type GoogleHeadersResolver, type GoogleModelOptions, type GoogleProviderOptions, type GoogleRequestOptions, type GoogleSecretResolver, createGoogleProvider, googleDefaultModels };

package/dist/index.mjs

@@ -0,0 +1,497 @@
+import { Buffer } from "node:buffer";
+import process from "node:process";
+import { isAbortError, isRecord, normalizeBaseUrl, numberOrZero, parseJsonObject, stringOrNull } from "@demicodes/utils";
+import { zeroUsage } from "@demicodes/core";
+import { authStatusFromKey, defineProvider, httpRequestFailedEvent, normalizeErrorCode, providerErrorFromUnknown, withProviderId } from "@demicodes/provider";
+//#region src/models.ts
+const SOURCE_FETCHED_AT = "1970-01-01T00:00:00.000Z";
+const EFFORTS = [
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
+function googleDefaultModels(providerId = "google") {
+	return modelListFromGoogleModels([
+		{
+			id: "gemini-3.6-flash",
+			displayName: "Gemini 3.6 Flash",
+			contextWindow: 1048576,
+			outputLimit: 65536,
+			supportsTools: true,
+			supportsAttachments: true,
+			supportsVideo: true,
+			supportsReasoning: true,
+			supportedThinkingEfforts: EFFORTS,
+			defaultThinkingEffort: "medium"
+		},
+		{
+			id: "gemini-3.5-flash",
+			displayName: "Gemini 3.5 Flash",
+			contextWindow: 1048576,
+			outputLimit: 65536,
+			supportsTools: true,
+			supportsAttachments: true,
+			supportsVideo: true,
+			supportsReasoning: true,
+			supportedThinkingEfforts: EFFORTS,
+			defaultThinkingEffort: "medium"
+		},
+		{
+			id: "gemini-3.1-pro-preview",
+			displayName: "Gemini 3.1 Pro Preview",
+			contextWindow: 1048576,
+			outputLimit: 65536,
+			supportsTools: true,
+			supportsAttachments: true,
+			supportsVideo: true,
+			supportsReasoning: true,
+			supportedThinkingEfforts: EFFORTS,
+			defaultThinkingEffort: "medium"
+		},
+		{
+			id: "gemini-2.5-flash",
+			displayName: "Gemini 2.5 Flash",
+			contextWindow: 1048576,
+			outputLimit: 65536,
+			supportsTools: true,
+			supportsAttachments: true,
+			supportsVideo: true,
+			supportsReasoning: true,
+			supportedThinkingEfforts: EFFORTS,
+			defaultThinkingEffort: "medium"
+		}
+	], {
+		providerId,
+		defaultModelId: "gemini-3.6-flash",
+		sourceFetchedAt: SOURCE_FETCHED_AT
+	});
+}
+function modelListFromGoogleModels(models, options) {
+	const sourceFetchedAt = options.sourceFetchedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+	const stale = options.stale === true;
+	const mapped = models.map((model) => ({
+		providerId: options.providerId,
+		id: model.id,
+		displayName: model.displayName ?? model.id,
+		description: model.description,
+		contextWindow: positiveInteger(model.contextWindow, `models[${model.id}].contextWindow`),
+		outputLimit: model.outputLimit ?? null,
+		supportsTools: model.supportsTools ?? null,
+		supportsAttachments: model.supportsAttachments ?? null,
+		supportsVideo: model.supportsVideo ?? null,
+		supportsReasoning: model.supportsReasoning ?? null,
+		supportedThinkingEfforts: model.supportedThinkingEfforts ? [...model.supportedThinkingEfforts] : null,
+		defaultThinkingEffort: model.defaultThinkingEffort ?? null,
+		canDisableThinking: model.canDisableThinking ?? null,
+		serviceTiers: model.serviceTiers ? model.serviceTiers.map((tier) => ({ ...tier })) : model.serviceTiers,
+		defaultServiceTierId: model.defaultServiceTierId ?? null,
+		sourceFetchedAt,
+		stale
+	}));
+	return {
+		providerId: options.providerId,
+		models: mapped,
+		defaultModelId: options.defaultModelId && mapped.some((model) => model.id === options.defaultModelId) ? options.defaultModelId : mapped[0]?.id ?? null,
+		warnings: [],
+		sourceFetchedAt,
+		stale
+	};
+}
+function positiveInteger(value, field) {
+	if (!Number.isInteger(value) || value <= 0) throw new Error(`${field} must be a positive integer`);
+	return value;
+}
+//#endregion
+//#region src/provider.ts
+const DEFAULT_GOOGLE_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
+const DEFAULT_MAX_OUTPUT_TOKENS = 32e3;
+const DEFAULT_EFFORT_BUDGET_TOKENS = {
+	low: 4096,
+	medium: 16384,
+	high: 32768,
+	xhigh: 65536,
+	max: 98304
+};
+var GoogleProvider = class {
+	options;
+	constructor(options) {
+		this.options = options;
+	}
+	async *run(request) {
+		if (request.cancel.aborted) {
+			yield { type: "abort" };
+			return;
+		}
+		let apiKey;
+		let headers;
+		try {
+			apiKey = await this.options.apiKey();
+			headers = await this.buildHeaders(apiKey);
+			if (!apiKey && !headers.has("x-goog-api-key")) {
+				yield {
+					type: "error",
+					message: "Google API key is missing",
+					code: "auth_missing"
+				};
+				return;
+			}
+		} catch (error) {
+			yield providerErrorFromUnknown(error, apiKey);
+			return;
+		}
+		try {
+			const response = await this.options.fetch(googleStreamUrl(this.options.baseUrl, request.modelId), {
+				method: "POST",
+				headers,
+				body: JSON.stringify(buildGoogleGenerateContentBody(request, this.options.request)),
+				signal: request.cancel
+			});
+			if (!response.ok) {
+				yield await httpRequestFailedEvent(response, apiKey, "Google");
+				return;
+			}
+			yield* mapGoogleContentStream(readServerSentEvents(response.body, request.cancel), request.cancel);
+		} catch (error) {
+			if (request.cancel.aborted || isAbortError(error)) {
+				yield { type: "abort" };
+				return;
+			}
+			yield providerErrorFromUnknown(error, apiKey);
+		}
+	}
+	async buildHeaders(apiKey) {
+		const headers = new Headers(await this.options.headers?.());
+		headers.set("accept", "text/event-stream");
+		headers.set("content-type", "application/json");
+		if (apiKey) headers.set("x-goog-api-key", apiKey);
+		return headers;
+	}
+};
+function createGoogleProvider(options = {}) {
+	const id = options.id ?? "google";
+	const displayName = options.displayName ?? "Google Gemini";
+	const envPrefix = options.envPrefix ?? "GOOGLE";
+	const baseUrl = normalizeBaseUrl(options.baseUrl ?? process.env[`${envPrefix}_BASE_URL`] ?? DEFAULT_GOOGLE_BASE_URL);
+	const apiKey = options.apiKey ?? (() => process.env[`${envPrefix}_API_KEY`]);
+	const fetchImpl = options.fetch ?? fetch;
+	const modelList = () => options.models ? modelListFromGoogleModels(options.models, {
+		providerId: id,
+		defaultModelId: options.defaultModelId ?? null
+	}) : withProviderId(googleDefaultModels(id), id);
+	const runtimeOptions = {
+		baseUrl,
+		apiKey,
+		headers: options.headers,
+		request: options.request,
+		fetch: fetchImpl
+	};
+	return defineProvider({
+		id,
+		displayName,
+		auth: { status: () => authStatusFromKey(apiKey, options.headers, "x-goog-api-key", "Google") },
+		state: () => ({
+			status: "ready",
+			message: "Uses the Gemini generateContent API"
+		}),
+		listModels: modelList,
+		createRuntime: (selection) => {
+			const outputLimit = modelList().models.find((model) => model.id === selection.model.model.id)?.outputLimit ?? null;
+			const request = {
+				...options.request,
+				maxOutputTokens: options.request?.maxOutputTokens ?? outputLimit ?? void 0
+			};
+			return new GoogleProvider({
+				...runtimeOptions,
+				request
+			});
+		}
+	});
+}
+function buildGoogleGenerateContentBody(request, options) {
+	const body = { contents: inferenceItemsToGoogleContents(request.items) };
+	if (request.systemPrompt.trim()) body.systemInstruction = { parts: [{ text: request.systemPrompt }] };
+	if (request.tools.length > 0) body.tools = [{ functionDeclarations: request.tools.map(toolToGoogleFunctionDeclaration) }];
+	const generationConfig = {};
+	const maxOutputTokens = options?.maxOutputTokens ?? DEFAULT_MAX_OUTPUT_TOKENS;
+	if (maxOutputTokens > 0) generationConfig.maxOutputTokens = maxOutputTokens;
+	const thinkingConfig = googleThinkingConfig(request.thinking, options);
+	if (thinkingConfig) generationConfig.thinkingConfig = thinkingConfig;
+	if (Object.keys(generationConfig).length > 0) body.generationConfig = generationConfig;
+	if (options?.extraBody) Object.assign(body, options.extraBody);
+	return body;
+}
+/**
+* Maps any thinking config onto Gemini's `thinkingBudget`: budget configs pass
+* through, effort configs resolve through the ladder (caller-overridable),
+* disabled pins the budget to 0. `includeThoughts` defaults on — the model
+* thinks either way and bills for it, so hiding the summaries only costs the
+* product its "thinking…" surface.
+*/
+function googleThinkingConfig(thinking, options) {
+	const includeThoughts = options?.includeThoughts ?? true;
+	if (!thinking) return includeThoughts ? { includeThoughts: true } : null;
+	if (thinking.type === "disabled") return {
+		includeThoughts: false,
+		thinkingBudget: 0
+	};
+	const budget = thinking.type === "budget" ? thinking.budgetTokens : options?.effortBudgetTokens?.[thinking.effort] ?? DEFAULT_EFFORT_BUDGET_TOKENS[thinking.effort] ?? DEFAULT_EFFORT_BUDGET_TOKENS.medium;
+	return {
+		includeThoughts,
+		thinkingBudget: Math.max(0, budget)
+	};
+}
+/**
+* Rebuilds the conversation as Gemini `contents`.
+*
+* The subtle part is `thoughtSignature`. Gemini hands one back on every
+* `functionCall` part and REQUIRES it verbatim when that call is replayed —
+* without it the API rejects the whole request ("Function call is missing a
+* thought_signature in functionCall parts"), so an agent loop cannot survive
+* its own second turn. demi's item model has no signature slot on `tool_use`,
+* but it has one on `assistant_thinking`, and the transcript keeps items in
+* order: the provider emits `thinking_start` + `thinking_signature` right
+* before each `tool_call_requested`, so on replay the thinking item sitting
+* immediately in front of a `tool_use` carries that call's signature. That
+* keeps the signature in the persisted transcript (a runtime-local map would
+* evaporate on session resume and 400 forever after) without touching core.
+*/
+function inferenceItemsToGoogleContents(items) {
+	const contents = [];
+	const toolNames = /* @__PURE__ */ new Map();
+	let pendingSignature = null;
+	const append = (role, parts) => {
+		if (parts.length === 0) return;
+		const last = contents[contents.length - 1];
+		if (last?.role === role) {
+			last.parts.push(...parts);
+			return;
+		}
+		contents.push({
+			role,
+			parts
+		});
+	};
+	for (const item of items) switch (item.type) {
+		case "user_message":
+		case "user_steer":
+			append("user", userContentToGoogle(item.content));
+			pendingSignature = null;
+			break;
+		case "assistant_text":
+			append("model", [{ text: item.text }]);
+			pendingSignature = null;
+			break;
+		case "assistant_thinking":
+			pendingSignature = item.signature;
+			break;
+		case "assistant_redacted_thinking": break;
+		case "tool_use": {
+			toolNames.set(item.toolUseId, item.toolName);
+			const call = { functionCall: {
+				name: item.toolName,
+				args: item.input ?? {},
+				id: item.toolUseId
+			} };
+			if (pendingSignature) call.thoughtSignature = pendingSignature;
+			append("model", [call]);
+			pendingSignature = null;
+			break;
+		}
+		case "tool_result":
+			append("user", toolResultToGoogle(item.toolUseId, toolNames.get(item.toolUseId) ?? "tool", item.output));
+			pendingSignature = null;
+			break;
+	}
+	return contents;
+}
+function userContentToGoogle(content) {
+	return content.flatMap((block) => {
+		if (block.type === "text") return [{ text: block.text }];
+		if (block.type === "reference") return [{ text: block.reference }];
+		if (block.type === "document") return [inlinePart(block.source.mediaType, block.source.data)];
+		if (block.source.type === "url") return [{ fileData: { fileUri: block.source.url } }];
+		return [inlinePart(block.source.mediaType, block.source.data)];
+	});
+}
+function inlinePart(mimeType, data) {
+	return { inlineData: {
+		mimeType,
+		data: Buffer.from(data).toString("base64")
+	} };
+}
+/**
+* `functionResponse.response` is a JSON object, so images and video a tool
+* returns cannot ride inside it. They follow as sibling inline parts in the
+* same user content — which is how the model ends up actually seeing what a
+* command printed.
+*/
+function toolResultToGoogle(toolUseId, toolName, output) {
+	const text = output.filter((block) => block.type === "text").map((block) => block.text).join("\n");
+	const media = output.filter((block) => block.type !== "text").map((block) => ({ inlineData: {
+		mimeType: block.source.mediaType,
+		data: block.source.data
+	} }));
+	return [{ functionResponse: {
+		name: toolName,
+		id: toolUseId,
+		response: { output: text }
+	} }, ...media];
+}
+function toolToGoogleFunctionDeclaration(tool) {
+	return {
+		name: tool.name,
+		description: tool.description,
+		parameters: tool.inputSchema
+	};
+}
+async function* mapGoogleContentStream(events, signal) {
+	let usage = zeroUsage();
+	let thinkingOpen = false;
+	for await (const event of events) {
+		if (signal?.aborted) {
+			yield { type: "abort" };
+			return;
+		}
+		for (const data of event.data) {
+			const value = parseJsonObject(data);
+			if (!value) continue;
+			if (isRecord(value.error)) {
+				const message = stringOrNull(value.error.message) ?? "Google API stream error";
+				yield {
+					type: "error",
+					message,
+					code: normalizeErrorCode(stringOrNull(value.error.status), message)
+				};
+				return;
+			}
+			if (isRecord(value.usageMetadata)) usage = googleUsage(value.usageMetadata);
+			const candidates = Array.isArray(value.candidates) ? value.candidates : [];
+			for (const candidate of candidates) {
+				if (!isRecord(candidate)) continue;
+				const content = isRecord(candidate.content) ? candidate.content : null;
+				const parts = content && Array.isArray(content.parts) ? content.parts : [];
+				for (const part of parts) {
+					if (!isRecord(part)) continue;
+					const functionCall = isRecord(part.functionCall) ? part.functionCall : null;
+					if (functionCall) {
+						const signature = stringOrNull(part.thoughtSignature);
+						if (signature) {
+							if (!thinkingOpen) yield { type: "thinking_start" };
+							thinkingOpen = true;
+							yield {
+								type: "thinking_signature",
+								signature
+							};
+						}
+						yield {
+							type: "tool_call_requested",
+							toolUseId: stringOrNull(functionCall.id) ?? `${stringOrNull(functionCall.name) ?? "tool"}_${nextFallbackToolId()}`,
+							toolName: stringOrNull(functionCall.name) ?? "",
+							input: functionCall.args ?? {}
+						};
+						thinkingOpen = false;
+						continue;
+					}
+					const text = stringOrNull(part.text);
+					if (part.thought === true) {
+						if (!thinkingOpen) {
+							yield { type: "thinking_start" };
+							thinkingOpen = true;
+						}
+						if (text) yield {
+							type: "thinking_delta",
+							text
+						};
+						continue;
+					}
+					const signature = stringOrNull(part.thoughtSignature);
+					if (signature && thinkingOpen) yield {
+						type: "thinking_signature",
+						signature
+					};
+					if (text) {
+						thinkingOpen = false;
+						yield {
+							type: "text_delta",
+							text
+						};
+					}
+				}
+			}
+		}
+	}
+	yield {
+		type: "response",
+		usage
+	};
+}
+let sequence = 0;
+/** Fallback tool-call id when the API omits one; only needs to be unique per process. */
+function nextFallbackToolId() {
+	sequence += 1;
+	return String(sequence);
+}
+/**
+* Thinking is billed separately from the visible answer (`thoughtsTokenCount`
+* alongside `candidatesTokenCount`); both are output tokens, so the agent's
+* context estimate has to count them together.
+*/
+function googleUsage(usageMetadata) {
+	return {
+		inputTokens: numberOrZero(usageMetadata.promptTokenCount),
+		outputTokens: numberOrZero(usageMetadata.candidatesTokenCount) + numberOrZero(usageMetadata.thoughtsTokenCount),
+		cacheReadTokens: numberOrZero(usageMetadata.cachedContentTokenCount),
+		cacheWriteTokens: 0
+	};
+}
+async function* readServerSentEvents(body, signal) {
+	if (!body) return;
+	const reader = body.getReader();
+	const decoder = new TextDecoder();
+	let buffer = "";
+	let eventName = null;
+	let data = [];
+	const flush = function* () {
+		if (data.length === 0) return;
+		yield {
+			event: eventName,
+			data
+		};
+		eventName = null;
+		data = [];
+	};
+	try {
+		while (true) {
+			if (signal?.aborted) return;
+			const { value, done } = await reader.read();
+			if (done) break;
+			buffer += decoder.decode(value, { stream: true });
+			let newline = buffer.indexOf("\n");
+			while (newline !== -1) {
+				const raw = buffer.slice(0, newline);
+				buffer = buffer.slice(newline + 1);
+				const line = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
+				if (line === "") yield* flush();
+				else if (line.startsWith("event:")) eventName = line.slice(6).trim();
+				else if (line.startsWith("data:")) data.push(line.slice(5).trimStart());
+				newline = buffer.indexOf("\n");
+			}
+		}
+		buffer += decoder.decode();
+		if (buffer) {
+			const line = buffer.endsWith("\r") ? buffer.slice(0, -1) : buffer;
+			if (line.startsWith("data:")) data.push(line.slice(5).trimStart());
+			else if (line.startsWith("event:")) eventName = line.slice(6).trim();
+		}
+		yield* flush();
+	} finally {
+		reader.releaseLock();
+	}
+}
+function googleStreamUrl(baseUrl, modelId) {
+	return `${normalizeBaseUrl(baseUrl)}/models/${encodeURIComponent(modelId)}:streamGenerateContent?alt=sse`;
+}
+//#endregion
+export { createGoogleProvider, googleDefaultModels };

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@demicodes/provider-google",
+  "description": "Google Gemini API provider adapter for Demi.",
+  "version": "0.8.0",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "dependencies": {
+    "@demicodes/core": "^0.8.0",
+    "@demicodes/provider": "^0.8.0",
+    "@demicodes/utils": "^0.8.0"
+  },
+  "license": "Apache-2.0",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wspl/demi.git",
+    "directory": "packages/provider-google"
+  },
+  "homepage": "https://github.com/wspl/demi/tree/main/packages/provider-google#readme",
+  "bugs": "https://github.com/wspl/demi/issues"
+}