@tanstack/ai-gemini 0.11.0 → 0.12.0

package/dist/esm/experimental/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @experimental Gemini's Interactions API is in Beta per Google. Shapes and
+ * behavior may change between minor releases of `@tanstack/ai-gemini`.
+ */
+export { GeminiTextInteractionsAdapter, createGeminiTextInteractions, geminiTextInteractions, type GeminiTextInteractionsConfig, type GeminiTextInteractionsProviderOptions, type GeminiInteractionsStream, } from './text-interactions/adapter.js';
+export type { GeminiInteractionsCustomEvent, GeminiInteractionsCustomEventName, GeminiInteractionsCustomEventValue, } from './text-interactions/events.js';

package/dist/esm/experimental/index.js

@@ -0,0 +1,7 @@
+import { GeminiTextInteractionsAdapter, createGeminiTextInteractions, geminiTextInteractions } from "./text-interactions/adapter.js";
+export {
+  GeminiTextInteractionsAdapter,
+  createGeminiTextInteractions,
+  geminiTextInteractions
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/experimental/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/esm/experimental/text-interactions/adapter.d.ts

@@ -0,0 +1,75 @@
+import { BaseTextAdapter, StructuredOutputOptions, StructuredOutputResult } from '@tanstack/ai/adapters';
+import { GeminiChatModelToolCapabilitiesByName, GeminiModelInputModalitiesByName, GeminiModels } from '../../model-meta.js';
+import { Modality, StreamChunk, TextOptions } from '@tanstack/ai';
+import { GeminiInteractionsStream } from './events.js';
+import { ExternalTextInteractionsProviderOptions } from './provider-options.js';
+import { GeminiMessageMetadataByModality } from '../../message-types.js';
+import { GeminiClientConfig } from '../../utils.js';
+export type GeminiTextInteractionsConfig = GeminiClientConfig;
+export type GeminiTextInteractionsProviderOptions = ExternalTextInteractionsProviderOptions;
+/**
+ * Resolve provider options for a specific model. The Interactions API's
+ * request shape is the same across all chat-capable Gemini models — the
+ * SDK doesn't expose a per-model param union — so this currently falls
+ * through to the flat `GeminiTextInteractionsProviderOptions` for every
+ * model. The alias exists for parity with `GeminiTextAdapter`, so a
+ * per-model map can be slotted in later without changing the adapter
+ * signature.
+ */
+type ResolveProviderOptions = GeminiTextInteractionsProviderOptions;
+/**
+ * Resolve input modalities for a specific model. Reuses the chat-model
+ * modality map from `model-meta.ts`: passing a `document` content block
+ * to a model that doesn't support it is a compile error, matching the
+ * sibling `GeminiTextAdapter`.
+ */
+type ResolveInputModalities<TModel extends string> = TModel extends keyof GeminiModelInputModalitiesByName ? GeminiModelInputModalitiesByName[TModel] : readonly ['text', 'image', 'audio', 'video', 'document'];
+/**
+ * Resolve tool capabilities for a specific model. Reuses the chat-model
+ * capability map: `google_maps` / `google_search_retrieval` /
+ * `mcp_server` are rejected at runtime by `convertToolsToInteractionsFormat`,
+ * but per-model gating happens here at compile time.
+ */
+type ResolveToolCapabilities<TModel extends string> = TModel extends keyof GeminiChatModelToolCapabilitiesByName ? NonNullable<GeminiChatModelToolCapabilitiesByName[TModel]> : readonly [];
+/**
+ * Tree-shakeable adapter for Gemini's stateful Interactions API. Routes
+ * through `client.interactions.create` and surfaces the server-assigned
+ * `interactionId` via an AG-UI `CUSTOM` event with
+ * `name: 'gemini.interactionId'` emitted just before `RUN_FINISHED`; pass
+ * that id back on the next turn via `modelOptions.previous_interaction_id`
+ * to continue the conversation without resending history.
+ *
+ * The Interactions API does NOT support stateless multi-turn replay —
+ * passing more than one message in `messages` without a
+ * `previous_interaction_id` throws. For a chat UI that maintains local
+ * history (e.g. `useChat`), see the "Wiring with `useChat`" section of
+ * `docs/adapters/gemini.md` for the canonical client/server pattern.
+ *
+ * Supports user-defined function tools and the built-in tools
+ * `google_search`, `code_execution`, `url_context`, `file_search`, and
+ * `computer_use`. Built-in tool *activity* for the four search/exec
+ * variants is surfaced via `CUSTOM` events
+ * (`gemini.googleSearchCall` / `gemini.googleSearchResult` and the
+ * corresponding per-tool variants) carrying the raw Interactions delta;
+ * see {@link GeminiInteractionsCustomEvent}. `computer_use` is accepted
+ * in the request but the Interactions API does not currently stream
+ * per-delta CUSTOM events for it. `google_search_retrieval`,
+ * `google_maps`, and `mcp_server` are not supported on this adapter.
+ *
+ * @experimental Interactions API is in Beta per Google; shapes may change.
+ * @see https://ai.google.dev/gemini-api/docs/interactions
+ */
+export declare class GeminiTextInteractionsAdapter<TModel extends GeminiModels, TProviderOptions extends Record<string, any> = ResolveProviderOptions, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends BaseTextAdapter<TModel, TProviderOptions, TInputModalities, GeminiMessageMetadataByModality, TToolCapabilities> {
+    readonly kind: "text";
+    readonly name: "gemini-text-interactions";
+    private readonly client;
+    private readonly interactionIdByThread;
+    constructor(config: GeminiTextInteractionsConfig, model: TModel);
+    chatStream(options: TextOptions<GeminiTextInteractionsProviderOptions>): AsyncIterable<StreamChunk>;
+    structuredOutput(options: StructuredOutputOptions<GeminiTextInteractionsProviderOptions>): Promise<StructuredOutputResult<unknown>>;
+}
+/** @experimental Interactions API is in Beta. */
+export declare function createGeminiTextInteractions<TModel extends GeminiModels>(model: TModel, apiKey: string, config?: Omit<GeminiTextInteractionsConfig, 'apiKey'>): GeminiTextInteractionsAdapter<TModel, ResolveProviderOptions, ResolveInputModalities<TModel>, ResolveToolCapabilities<TModel>>;
+/** @experimental Interactions API is in Beta. */
+export declare function geminiTextInteractions<TModel extends GeminiModels>(model: TModel, config?: Omit<GeminiTextInteractionsConfig, 'apiKey'>): GeminiTextInteractionsAdapter<TModel, ResolveProviderOptions, ResolveInputModalities<TModel>, ResolveToolCapabilities<TModel>>;
+export type { GeminiInteractionsStream };