@opencode/ai 0.0.0-dev-20498 → 0.0.0-dev-20501

package/README.md

@@ -27,6 +27,31 @@ Run `LLM.stream(...)` instead of `generate` when you want incremental `LLMEvent`
 `LLM.request(...)`. The event stream is provider-neutral — same shape across OpenAI Chat, OpenAI Responses,
 Anthropic Messages, Gemini, Bedrock Converse, and any OpenAI-compatible deployment.
 
+### Google Interactions
+
+`Google.configure({ apiKey }).interactions(modelID)` selects the Interactions API; `.model(modelID)` still selects
+GenerateContent. The package entrypoint is `@opencode/ai/providers/google/interactions`.
+
+```ts
+const model = Google.configure({ apiKey }).interactions("gemini-3.8-flash")
+const response = yield* LLM.generate({
+  model,
+  prompt: "Say hello.",
+  providerOptions: { thinkingLevel: "low", thinkingSummaries: "auto", store: true },
+})
+```
+
+Interactions supports text output, streamed function calls, native tool results, thought signatures, and multimodal
+input. Full-history replay is the default (`store: false`); implicit caching works without retained interactions.
+For server-side continuation, set `store: true` on the predecessor, read `interactionId` from the final event's
+`providerMetadata.google`, and pass `previousInteractionId` on the next request with **only new messages**. Repeat
+the system instructions and tool declarations on each request. Set `store: true` on each response you intend to
+continue from. The package does not automatically select or persist continuation IDs.
+
+Raw usage is preserved in `usage.providerMetadata.google`. `inputTokens` follows Google's top-level accounting;
+`contextTokens` uses its full `raw_prompt_token` count when supplied. These can differ substantially with server-side
+continuation. Explicit caches, hosted tools, and generated media are not supported by this initial protocol.
+
 The same configured facade names image, video, speech, and transcription models. `Image.generate` resolves the
 provider's image route from the model and returns `Media.Asset`s with lazily decoded bytes:
 

package/dist/protocols/alibaba-chat.d.ts

@@ -152,10 +152,10 @@ export declare const protocol: Protocol<{
     readonly top_k?: number | undefined;
     readonly frequency_penalty?: number | undefined;
     readonly presence_penalty?: number | undefined;
+    readonly store?: boolean | undefined;
     readonly prompt_cache_key?: string | undefined;
     readonly parallel_tool_calls?: boolean | undefined;
     readonly reasoning_effort?: OpenResponsesOptions.ReasoningEffort | undefined;
-    readonly store?: boolean | undefined;
     readonly stream_options?: {
         readonly include_usage: boolean;
     } | undefined;
@@ -188,9 +188,9 @@ export declare const protocol: Protocol<{
         readonly [x: string]: unknown;
         readonly cache_read_input_tokens?: number | null | undefined;
         readonly cached_tokens?: number | null | undefined;
+        readonly total_tokens?: number | null | undefined;
         readonly prompt_tokens?: number | null | undefined;
         readonly completion_tokens?: number | null | undefined;
-        readonly total_tokens?: number | null | undefined;
         readonly prompt_tokens_details?: {
             readonly [x: string]: unknown;
             readonly cached_tokens?: number | null | undefined;
@@ -229,9 +229,9 @@ export declare const protocol: Protocol<{
             readonly [x: string]: unknown;
             readonly cache_read_input_tokens?: number | null | undefined;
             readonly cached_tokens?: number | null | undefined;
+            readonly total_tokens?: number | null | undefined;
             readonly prompt_tokens?: number | null | undefined;
             readonly completion_tokens?: number | null | undefined;
-            readonly total_tokens?: number | null | undefined;
             readonly prompt_tokens_details?: {
                 readonly [x: string]: unknown;
                 readonly cached_tokens?: number | null | undefined;

package/dist/protocols/alibaba-responses.d.ts

@@ -48,6 +48,15 @@ export declare const protocol: Protocol<{
         readonly error?: unknown;
         readonly arguments?: string | undefined;
         readonly server_label?: string | undefined;
+    } | {
+        readonly type: "configuration_update";
+        readonly reasoning: {
+            readonly effort: OpenResponsesOptions.ReasoningEffort;
+        };
+    } | {
+        readonly [x: string]: unknown;
+        readonly type: string;
+        readonly id: string;
     } | {
         readonly type: "reasoning";
         readonly summary: readonly {
@@ -124,12 +133,6 @@ export declare const protocol: Protocol<{
             readonly type: "input_video";
             readonly video_url: string;
         })[];
-    } | {
-        readonly [x: string]: unknown;
-        readonly id: string;
-        readonly type: "web_extractor_call";
-        readonly urls?: readonly string[] | undefined;
-        readonly goal?: string | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -142,6 +145,9 @@ export declare const protocol: Protocol<{
         readonly effort?: OpenResponsesOptions.ReasoningEffort | undefined;
     } | undefined;
     readonly tools?: readonly ({
+        readonly [x: string]: unknown;
+        readonly type: string;
+    } | {
         readonly type: "function";
         readonly description: string;
         readonly name: string;
@@ -149,8 +155,6 @@ export declare const protocol: Protocol<{
             readonly [x: string]: unknown;
         };
         readonly strict?: boolean | undefined;
-    } | {
-        readonly type: "web_search" | "code_interpreter" | "web_extractor";
     })[] | undefined;
     readonly text?: {
         readonly verbosity?: OpenResponsesOptions.TextVerbosity | undefined;
@@ -171,9 +175,10 @@ export declare const protocol: Protocol<{
     readonly top_p?: number | undefined;
     readonly frequency_penalty?: number | undefined;
     readonly presence_penalty?: number | undefined;
+    readonly store?: boolean | undefined;
+    readonly max_output_tokens?: number | undefined;
     readonly prompt_cache_key?: string | undefined;
     readonly parallel_tool_calls?: boolean | undefined;
-    readonly store?: boolean | undefined;
     readonly include?: readonly OpenResponsesOptions.ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
     readonly stream_options?: {
@@ -181,7 +186,6 @@ export declare const protocol: Protocol<{
     } | undefined;
     readonly safety_identifier?: string | undefined;
     readonly top_logprobs?: number | undefined;
-    readonly max_output_tokens?: number | undefined;
     readonly max_tool_calls?: number | undefined;
     readonly previous_response_id?: string | undefined;
     readonly conversation?: string | undefined;
@@ -204,8 +208,8 @@ export declare const protocol: Protocol<{
             readonly name?: string | undefined;
             readonly namespace?: string | undefined;
             readonly arguments?: string | undefined;
-            readonly encrypted_content?: string | null | undefined;
             readonly call_id?: string | undefined;
+            readonly encrypted_content?: string | null | undefined;
         }[] | undefined;
         readonly error?: unknown;
         readonly usage?: {
@@ -232,8 +236,8 @@ export declare const protocol: Protocol<{
         readonly name?: string | undefined;
         readonly namespace?: string | undefined;
         readonly arguments?: string | undefined;
-        readonly encrypted_content?: string | null | undefined;
         readonly call_id?: string | undefined;
+        readonly encrypted_content?: string | null | undefined;
     } | null | undefined;
     readonly delta?: string | undefined;
     readonly arguments?: string | undefined;

package/dist/protocols/alibaba-responses.js

@@ -1,7 +1,7 @@
 import { Effect, Schema } from "effect";
 import { Protocol } from "../route/protocol.js";
 import { OpenResponses } from "./open-responses.js";
-import { JsonObject, optionalArray, ProviderShared } from "./shared.js";
+import { JsonObject, ProviderShared } from "./shared.js";
 import { OpenResponsesOptions } from "./utils/open-responses-options.js";
 import { ResponsesHostedTools } from "./utils/responses-hosted-tools.js";
 const Options = Schema.Struct({
@@ -20,8 +20,6 @@ const WebExtractorItem = Schema.StructWithRest(Schema.Struct({
 }), [JsonObject]);
 const Body = Schema.Struct({
     ...OpenResponses.coreFields,
-    input: Schema.Array(Schema.Union([OpenResponses.InputItem, WebExtractorItem])),
-    tools: optionalArray(Schema.Union([OpenResponses.Tool, NativeTool])),
     enable_thinking: Options.fields.enableThinking,
     previous_response_id: Options.fields.previousResponseId,
     conversation: Options.fields.conversation,
@@ -45,7 +43,7 @@ export const protocol = Protocol.make({
             const opts = yield* ProviderShared.validateWith(Schema.decodeUnknownEffect(Options))(req.providerOptions ?? {});
             const body = yield* OpenResponses.fromRequestWithAdapter(req, adapter);
             const choice = body.tool_choice;
-            return yield* ProviderShared.validateWith(Schema.decodeUnknownEffect(Body))({
+            return {
                 ...body,
                 enable_thinking: opts.enableThinking,
                 previous_response_id: opts.previousResponseId,
@@ -54,7 +52,7 @@ export const protocol = Protocol.make({
                 tool_choice: typeof choice === "object" && choice.type === "function"
                     ? { type: "allowed_tools", mode: "required", tools: [choice] }
                     : choice,
-            });
+            };
         }),
     },
     stream: {

package/dist/protocols/google-interactions.d.ts

@@ -0,0 +1,236 @@
+import { Schema } from "effect";
+import { Route } from "../route/client.js";
+import { Protocol } from "../route/protocol.js";
+import { Lifecycle } from "./utils/lifecycle.js";
+import { ToolStream } from "./utils/tool-stream.js";
+export declare const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
+declare const Options: Schema.Struct<{
+    readonly previousInteractionId: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.String>, never>>;
+    readonly store: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.Boolean>, never>>;
+    readonly thinkingLevel: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.declare<import("../schema/options.js").OpenString<"minimal" | "low" | "medium" | "high">, import("../schema/options.js").OpenString<"minimal" | "low" | "medium" | "high">>>, never>>;
+    readonly thinkingSummaries: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.declare<import("../schema/options.js").OpenString<"auto" | "none">, import("../schema/options.js").OpenString<"auto" | "none">>>, never>>;
+    readonly serviceTier: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.declare<import("../schema/options.js").OpenString<"standard" | "flex" | "priority">, import("../schema/options.js").OpenString<"standard" | "flex" | "priority">>>, never>>;
+}>;
+export type OptionsInput = typeof Options.Encoded;
+export type ProviderOptionsInput = OptionsInput;
+declare const OutputStep: Schema.Struct<{
+    readonly type: Schema.String;
+    readonly id: Schema.optional<Schema.String>;
+    readonly name: Schema.optional<Schema.String>;
+    readonly arguments: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly signature: Schema.optional<Schema.String>;
+    readonly summary: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly type: Schema.Literal<"text">;
+        readonly text: Schema.String;
+    }>>>;
+    readonly content: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly type: Schema.String;
+        readonly text: Schema.optional<Schema.String>;
+    }>>>;
+}>;
+type OutputStep = typeof OutputStep.Type;
+interface ParserState {
+    readonly route: string;
+    readonly metadataKey: string;
+    readonly lifecycle: Lifecycle.State;
+    readonly steps: Partial<Record<number, OutputStep>>;
+    readonly tools: ToolStream.State<number>;
+    readonly completed: boolean;
+}
+export declare const protocol: Protocol<{
+    readonly input: readonly ({
+        readonly type: "user_input" | "model_output";
+        readonly content: readonly ({
+            readonly type: "text";
+            readonly text: string;
+        } | {
+            readonly type: "image" | "document" | "video" | "audio";
+            readonly mime_type: string;
+            readonly data?: string | undefined;
+            readonly uri?: string | undefined;
+        })[];
+    } | {
+        readonly type: "thought";
+        readonly summary?: readonly {
+            readonly type: "text";
+            readonly text: string;
+        }[] | undefined;
+        readonly signature?: string | undefined;
+    } | {
+        readonly id: string;
+        readonly type: "function_call";
+        readonly name: string;
+        readonly arguments: unknown;
+        readonly signature?: string | undefined;
+    } | {
+        readonly type: "function_result";
+        readonly name: string;
+        readonly result: unknown;
+        readonly call_id: string;
+        readonly is_error?: boolean | undefined;
+    })[];
+    readonly model: string;
+    readonly stream: true;
+    readonly store: boolean;
+    readonly generation_config: {
+        readonly temperature?: number | undefined;
+        readonly seed?: number | undefined;
+        readonly tool_choice?: "auto" | "none" | "any" | {
+            readonly allowed_tools: {
+                readonly mode: "any";
+                readonly tools: readonly string[];
+            };
+        } | undefined;
+        readonly top_p?: number | undefined;
+        readonly stop_sequences?: readonly string[] | undefined;
+        readonly max_output_tokens?: number | undefined;
+        readonly thinking_level?: import("../schema/options.js").OpenString<"minimal" | "low" | "medium" | "high"> | undefined;
+        readonly thinking_summaries?: string | undefined;
+    };
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+    }[] | undefined;
+    readonly service_tier?: string | undefined;
+    readonly previous_interaction_id?: string | undefined;
+    readonly system_instruction?: string | undefined;
+}, string, {
+    readonly event_type: "step.start";
+    readonly index: number;
+    readonly step: {
+        readonly type: string;
+        readonly id?: string | undefined;
+        readonly name?: string | undefined;
+        readonly summary?: readonly {
+            readonly type: "text";
+            readonly text: string;
+        }[] | undefined;
+        readonly content?: readonly {
+            readonly type: string;
+            readonly text?: string | undefined;
+        }[] | undefined;
+        readonly signature?: string | undefined;
+        readonly arguments?: {
+            readonly [x: string]: unknown;
+        } | undefined;
+    };
+} | {
+    readonly event_type: "step.delta";
+    readonly index: number;
+    readonly delta: {
+        readonly type: "text";
+        readonly text: string;
+    } | {
+        readonly type: "arguments_delta";
+        readonly arguments: string;
+    } | {
+        readonly type: "thought_signature";
+        readonly signature: string;
+    } | {
+        readonly type: "thought_summary";
+        readonly content: {
+            readonly type: "text";
+            readonly text: string;
+        };
+    } | {
+        readonly type: string;
+    };
+} | {
+    readonly event_type: "step.stop";
+    readonly index: number;
+} | {
+    readonly event_type: "interaction.created";
+    readonly interaction: {
+        readonly id?: string | undefined;
+    };
+} | {
+    readonly status: string;
+    readonly event_type: "interaction.status_update";
+    readonly interaction_id?: string | undefined;
+} | {
+    readonly event_type: "interaction.completed";
+    readonly interaction: {
+        readonly [x: string]: unknown;
+        readonly status: string;
+        readonly id?: string | undefined;
+        readonly usage?: {
+            readonly [x: string]: unknown;
+            readonly total_input_tokens?: number | null | undefined;
+            readonly total_cached_tokens?: number | null | undefined;
+            readonly total_output_tokens?: number | null | undefined;
+            readonly total_thought_tokens?: number | null | undefined;
+            readonly total_tokens?: number | null | undefined;
+            readonly raw_prompt_token?: number | null | undefined;
+        } | undefined;
+    };
+} | {
+    readonly event_type: "error";
+    readonly error: unknown;
+}, ParserState>;
+export declare const route: Route<{
+    readonly input: readonly ({
+        readonly type: "user_input" | "model_output";
+        readonly content: readonly ({
+            readonly type: "text";
+            readonly text: string;
+        } | {
+            readonly type: "image" | "document" | "video" | "audio";
+            readonly mime_type: string;
+            readonly data?: string | undefined;
+            readonly uri?: string | undefined;
+        })[];
+    } | {
+        readonly type: "thought";
+        readonly summary?: readonly {
+            readonly type: "text";
+            readonly text: string;
+        }[] | undefined;
+        readonly signature?: string | undefined;
+    } | {
+        readonly id: string;
+        readonly type: "function_call";
+        readonly name: string;
+        readonly arguments: unknown;
+        readonly signature?: string | undefined;
+    } | {
+        readonly type: "function_result";
+        readonly name: string;
+        readonly result: unknown;
+        readonly call_id: string;
+        readonly is_error?: boolean | undefined;
+    })[];
+    readonly model: string;
+    readonly stream: true;
+    readonly store: boolean;
+    readonly generation_config: {
+        readonly temperature?: number | undefined;
+        readonly seed?: number | undefined;
+        readonly tool_choice?: "auto" | "none" | "any" | {
+            readonly allowed_tools: {
+                readonly mode: "any";
+                readonly tools: readonly string[];
+            };
+        } | undefined;
+        readonly top_p?: number | undefined;
+        readonly stop_sequences?: readonly string[] | undefined;
+        readonly max_output_tokens?: number | undefined;
+        readonly thinking_level?: import("../schema/options.js").OpenString<"minimal" | "low" | "medium" | "high"> | undefined;
+        readonly thinking_summaries?: string | undefined;
+    };
+    readonly tools?: readonly {
+        readonly type: "function";
+        readonly name: string;
+        readonly description: string;
+        readonly parameters: {
+            readonly [x: string]: unknown;
+        };
+    }[] | undefined;
+    readonly service_tier?: string | undefined;
+    readonly previous_interaction_id?: string | undefined;
+    readonly system_instruction?: string | undefined;
+}, import("../route/transport/http.js").HttpPrepared<string>, import("../route/client.js").CompactionOperations | undefined>;
+export * as GoogleInteractions from "./google-interactions.js";