@opencode/ai 2.0.16 → 2.0.18

package/dist/protocols/fal-images.js

@@ -3,13 +3,11 @@ import { ImageModel, ImageResponse } from "../image.js";
 import { Media } from "../media.js";
 import { MediaProtocol } from "../route/media-protocol.js";
 import { MediaRoute } from "../route/media.js";
-import { ProviderID, mergeJsonRecords } from "../schema/index.js";
+import { mergeJsonRecords } from "../schema/index.js";
 import { ProviderShared, optionalNull } from "./shared.js";
 import { FalQueue } from "./utils/fal-queue.js";
 import { MediaInput } from "./utils/media-input.js";
-const ADAPTER = "fal-images";
-const NAME = "fal Images";
-const PROVIDER = ProviderID.make("fal");
+const route = MediaProtocol.identity({ id: "fal-images", name: "fal Images", provider: "fal" });
 // ---------------------------------------------------------------------------
 // 2. Response schema
 // ---------------------------------------------------------------------------
@@ -27,37 +25,32 @@ const QueueResult = Schema.StructWithRest(Schema.Struct({
 // 5. Request body construction
 // ---------------------------------------------------------------------------
 const sizing = (model) => {
-    if (/^fal-ai\/(nano-banana|flux-pro\/v1\.1-ultra)/.test(model))
+    if (/^fal-ai\/(nano-banana|flux-pro\/(v1\.1-ultra|kontext))/.test(model))
         return "aspect_ratio";
     if (model.startsWith("fal-ai/flux"))
         return "image_size";
     return undefined;
 };
-const unsupported = (model, field, message) => ProviderShared.unsupportedOperation({
-    operation: `media.${field}`,
-    provider: PROVIDER,
-    route: ADAPTER,
-    message: `${model} ${message}`,
-});
 const validate = (request) => {
     const id = request.model.id;
     const field = sizing(id);
     if (request.size !== undefined && request.aspectRatio !== undefined)
-        return Effect.fail(ProviderShared.invalidRequest(`${NAME} accepts either size or aspectRatio, not both`));
+        return Effect.fail(ProviderShared.invalidRequest(`${route.name} accepts either size or aspectRatio, not both`));
     if (request.size !== undefined && field === "aspect_ratio")
-        return Effect.fail(unsupported(id, "size", "sizes by aspectRatio"));
+        return Effect.fail(route.unsupported("media.size", `${id} sizes by aspectRatio`));
     if (request.aspectRatio !== undefined && field === "image_size")
-        return Effect.fail(unsupported(id, "aspectRatio", "sizes by size (image_size)"));
-    if ((request.images?.length ?? 0) > 1 && !isEdit(id))
-        return Effect.fail(unsupported(id, "images", "takes one image_url; use an /edit endpoint for several images"));
+        return Effect.fail(route.unsupported("media.aspectRatio", `${id} sizes by size (image_size)`));
+    if ((request.images?.length ?? 0) > 1 && !takesImageList(id))
+        return Effect.fail(route.unsupported("media.images", `${id} takes one image_url; use an /edit or /multi endpoint for several images`));
     return Effect.void;
 };
-// `/edit` endpoints take an `image_urls` list; image-to-image, fill, and Ultra take one `image_url` (beside `mask_url`).
-const isEdit = (model) => model.endsWith("/edit");
+// `/edit` and `/multi` (Kontext) endpoints take an `image_urls` list; image-to-image, fill, and Ultra take one
+// `image_url` (beside `mask_url`).
+const takesImageList = (model) => model.endsWith("/edit") || model.endsWith("/multi");
 const fromRequest = Effect.fn("FalImages.fromRequest")(function* (request) {
     yield* validate(request);
-    const images = yield* Effect.forEach(request.images ?? [], (image) => FalQueue.mediaUrl(image, NAME));
-    const edit = isEdit(request.model.id);
+    const images = yield* Effect.forEach(request.images ?? [], (image) => FalQueue.mediaUrl(image, route.name));
+    const list = takesImageList(request.model.id);
     return MediaProtocol.json(mergeJsonRecords({
         prompt: request.prompt,
         num_images: request.n,
@@ -65,49 +58,46 @@ const fromRequest = Effect.fn("FalImages.fromRequest")(function* (request) {
         image_size: request.size === undefined ? undefined : MediaInput.dimensions(request.size),
         aspect_ratio: request.aspectRatio,
         output_format: request.format,
-        image_urls: edit && images.length > 0 ? images : undefined,
-        image_url: edit ? undefined : images[0],
-        mask_url: request.mask === undefined ? undefined : yield* FalQueue.mediaUrl(request.mask, NAME),
+        image_urls: list && images.length > 0 ? images : undefined,
+        image_url: list ? undefined : images[0],
+        mask_url: request.mask === undefined ? undefined : yield* FalQueue.mediaUrl(request.mask, route.name),
     }, request.providerOptions, request.http?.body) ?? {});
 });
 // ---------------------------------------------------------------------------
 // 6. Response decoding
 // ---------------------------------------------------------------------------
-const decodeQueueResult = MediaProtocol.decodeJson(ADAPTER, NAME, QueueResult);
+const decodeQueueResult = route.decodeJson(QueueResult);
 const decodeResult = Effect.fn("FalImages.decodeResult")(function* (response, context) {
     const output = yield* decodeQueueResult(response);
     const { images, seed, has_nsfw_concepts, ...rest } = output.value;
     if (images.length === 0)
-        return yield* output.invalid(`${NAME} returned no images`);
+        return yield* output.invalid(`${route.name} returned no images`);
     // With the safety checker on, flagged images come back blacked out rather than omitted.
     const flagged = (has_nsfw_concepts ?? []).flatMap((value, index) => (value ? [index] : []));
     return new ImageResponse({
-        images: images.map((image) => Media.url(image.url, {
-            mediaType: image.content_type ?? undefined,
-            info: { width: image.width ?? undefined, height: image.height ?? undefined },
-        })),
+        images: images.map((image) => {
+            const info = { width: image.width ?? undefined, height: image.height ?? undefined };
+            // `sync_mode: true` returns data URIs instead of hosted URLs.
+            return (Media.parseDataUrl(image.url, { info }) ??
+                Media.url(image.url, { mediaType: image.content_type ?? undefined, info }));
+        }),
         notices: flagged.length === 0
             ? undefined
-            : flagged.map((index) => ({ type: "moderated", message: `${NAME} flagged image ${index} as NSFW` })),
+            : flagged.map((index) => ({
+                type: "moderated",
+                message: `${route.name} flagged image ${index} as NSFW`,
+            })),
         providerMetadata: { fal: { requestId: context.token.requestID, seed: seed ?? undefined, ...rest } },
     });
 });
 // ---------------------------------------------------------------------------
 // 7. Protocol and route
 // ---------------------------------------------------------------------------
-export const protocol = FalQueue.protocol({
-    id: ADAPTER,
-    name: NAME,
+export const protocol = FalQueue.protocol(route, {
     from: fromRequest,
     decodeResult,
 });
-export const model = (input) => ImageModel.fromRoute({
-    id: ADAPTER,
-    provider: PROVIDER,
-    protocol,
-    baseURL: FalQueue.DEFAULT_BASE_URL,
-    path: ({ request }) => `/${request.model.id}`,
-}, input);
+export const model = (input) => ImageModel.fromRoute({ protocol, baseURL: FalQueue.DEFAULT_BASE_URL, path: ({ request }) => `/${request.model.id}` }, input);
 export const FalImages = {
     protocol,
     model,

package/dist/protocols/fal-video.d.ts

@@ -1,14 +1,14 @@
 import { MediaProtocol } from "../route/media-protocol.js";
 import { MediaRoute } from "../route/media.js";
+import { type OpenString } from "../schema/index.js";
 import { VideoModel, VideoResponse, type VideoRequestFor } from "../video.js";
-export type FalVideoString<Known extends string> = Known | (string & {});
 /**
  * Provider-native input. fal video endpoints are model-specific: `duration` is a string enum whose values differ per
  * model (`"8s"` for Veo, `"5"` for Kling), and last-frame fields are named per model (`end_image_url`,
  * `last_frame_url`, `tail_image_url`), so those pass through here instead of lowering from common fields.
  */
 export type FalVideoOptions = {
-    readonly duration?: FalVideoString<"4s" | "6s" | "8s" | "5" | "10">;
+    readonly duration?: OpenString<"4s" | "6s" | "8s" | "5" | "10">;
 } & Record<string, unknown>;
 export type Request = VideoRequestFor<FalVideoOptions>;
 export declare const protocol: MediaProtocol.Queued<Request, VideoResponse, {

package/dist/protocols/fal-video.js

@@ -2,13 +2,11 @@ import { Effect, Schema } from "effect";
 import { Media } from "../media.js";
 import { MediaProtocol } from "../route/media-protocol.js";
 import { MediaRoute } from "../route/media.js";
-import { ProviderID, mergeJsonRecords } from "../schema/index.js";
+import { mergeJsonRecords } from "../schema/index.js";
 import { VideoModel, VideoResponse } from "../video.js";
-import { ProviderShared, optionalNull } from "./shared.js";
+import { optionalNull } from "./shared.js";
 import { FalQueue } from "./utils/fal-queue.js";
-const ADAPTER = "fal-video";
-const NAME = "fal Video";
-const PROVIDER = ProviderID.make("fal");
+const route = MediaProtocol.identity({ id: "fal-video", name: "fal Video", provider: "fal" });
 // ---------------------------------------------------------------------------
 // 2. Response schema
 // ---------------------------------------------------------------------------
@@ -26,14 +24,9 @@ const QueueResult = Schema.StructWithRest(Schema.Struct({
 // ---------------------------------------------------------------------------
 const fromRequest = Effect.fn("FalVideo.fromRequest")(function* (request) {
     if (request.frames?.last !== undefined)
-        return yield* ProviderShared.unsupportedOperation({
-            operation: "video.frames.last",
-            provider: PROVIDER,
-            route: ADAPTER,
-            message: `${NAME} names the last frame per model; pass it through providerOptions (e.g. end_image_url) instead of frames.last`,
-        });
-    const imageUrl = request.frames?.first === undefined ? undefined : yield* FalQueue.mediaUrl(request.frames.first, NAME);
-    const videoUrl = request.video === undefined ? undefined : yield* FalQueue.mediaUrl(request.video, NAME);
+        return yield* route.unsupported("video.frames.last", `${route.name} names the last frame per model; pass it through providerOptions (e.g. end_image_url) instead of frames.last`);
+    const imageUrl = request.frames?.first === undefined ? undefined : yield* FalQueue.mediaUrl(request.frames.first, route.name);
+    const videoUrl = request.video === undefined ? undefined : yield* FalQueue.mediaUrl(request.video, route.name);
     return MediaProtocol.json(mergeJsonRecords({
         prompt: request.prompt,
         negative_prompt: request.negativePrompt,
@@ -48,7 +41,7 @@ const fromRequest = Effect.fn("FalVideo.fromRequest")(function* (request) {
 // ---------------------------------------------------------------------------
 // 6. Response decoding
 // ---------------------------------------------------------------------------
-const decodeQueueResult = MediaProtocol.decodeJson(ADAPTER, NAME, QueueResult);
+const decodeQueueResult = route.decodeJson(QueueResult);
 const decodeResult = Effect.fn("FalVideo.decodeResult")(function* (response, context) {
     const output = yield* decodeQueueResult(response);
     const { video, seed, ...rest } = output.value;
@@ -68,20 +61,12 @@ const decodeResult = Effect.fn("FalVideo.decodeResult")(function* (response, con
 // ---------------------------------------------------------------------------
 // 7. Protocol and route
 // ---------------------------------------------------------------------------
-export const protocol = FalQueue.protocol({
-    id: ADAPTER,
-    name: NAME,
+export const protocol = FalQueue.protocol(route, {
     unsupported: ["n", "durationSeconds", "references"],
     from: fromRequest,
     decodeResult,
 });
-export const model = (input) => VideoModel.fromRoute({
-    id: ADAPTER,
-    provider: PROVIDER,
-    protocol,
-    baseURL: FalQueue.DEFAULT_BASE_URL,
-    path: ({ request }) => `/${request.model.id}`,
-}, input);
+export const model = (input) => VideoModel.fromRoute({ protocol, baseURL: FalQueue.DEFAULT_BASE_URL, path: ({ request }) => `/${request.model.id}` }, input);
 export const FalVideo = {
     protocol,
     model,

package/dist/protocols/gemini.d.ts

@@ -10,14 +10,14 @@ export type ProviderOptionsInput = OptionsInput;
 declare const Options: Schema.Struct<{
     readonly cachedContent: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.String>, never>>;
     readonly safetySettings: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.$Array<Schema.Struct<{
-        readonly category: Schema.declare<(string & {}) | "HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY", (string & {}) | "HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY">;
-        readonly threshold: Schema.declare<(string & {}) | "HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF", (string & {}) | "HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF">;
+        readonly category: Schema.declare<import("../schema/options.js").OpenString<"HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY">, import("../schema/options.js").OpenString<"HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY">>;
+        readonly threshold: Schema.declare<import("../schema/options.js").OpenString<"HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF">, import("../schema/options.js").OpenString<"HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF">>;
     }>>>, never>>;
-    readonly serviceTier: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.declare<(string & {}) | "standard" | "flex" | "priority", (string & {}) | "standard" | "flex" | "priority">>, 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>>;
     readonly thinkingConfig: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.Struct<{
         readonly thinkingBudget: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.Number>, never>>;
         readonly includeThoughts: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.Boolean>, never>>;
-        readonly thinkingLevel: Schema.optionalKey<Schema.middlewareDecoding<Schema.UndefinedOr<Schema.declare<(string & {}) | "minimal" | "low" | "medium" | "high", (string & {}) | "minimal" | "low" | "medium" | "high">>, 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>>;
     }>>, never>>;
 }>;
 declare const GeminiBody: Schema.Struct<{
@@ -63,8 +63,8 @@ declare const GeminiBody: Schema.Struct<{
     }>>;
     labels: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
     safetySettings: Schema.optional<Schema.$Array<Schema.Struct<{
-        readonly category: Schema.declare<(string & {}) | "HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY", (string & {}) | "HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY">;
-        readonly threshold: Schema.declare<(string & {}) | "HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF", (string & {}) | "HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF">;
+        readonly category: Schema.declare<import("../schema/options.js").OpenString<"HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY">, import("../schema/options.js").OpenString<"HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY">>;
+        readonly threshold: Schema.declare<import("../schema/options.js").OpenString<"HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF">, import("../schema/options.js").OpenString<"HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF">>;
     }>>>;
     serviceTier: Schema.optional<Schema.String>;
     systemInstruction: Schema.optional<Schema.Struct<{
@@ -97,7 +97,7 @@ declare const GeminiBody: Schema.Struct<{
         readonly thinkingConfig: Schema.optional<Schema.Struct<{
             readonly thinkingBudget: Schema.optional<Schema.Number>;
             readonly includeThoughts: Schema.optional<Schema.Boolean>;
-            readonly thinkingLevel: Schema.optional<Schema.declare<(string & {}) | "minimal" | "low" | "medium" | "high", (string & {}) | "minimal" | "low" | "medium" | "high">>;
+            readonly thinkingLevel: Schema.optional<Schema.declare<import("../schema/options.js").OpenString<"minimal" | "low" | "medium" | "high">, import("../schema/options.js").OpenString<"minimal" | "low" | "medium" | "high">>>;
         }>>;
     }>>;
 }>;
@@ -164,8 +164,8 @@ export declare const protocol: Protocol<{
     } | undefined;
     readonly cachedContent?: string | undefined;
     readonly safetySettings?: readonly {
-        readonly category: (string & {}) | "HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY";
-        readonly threshold: (string & {}) | "HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF";
+        readonly category: import("../schema/options.js").OpenString<"HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY">;
+        readonly threshold: import("../schema/options.js").OpenString<"HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF">;
     }[] | undefined;
     readonly labels?: {
         readonly [x: string]: string;
@@ -186,7 +186,7 @@ export declare const protocol: Protocol<{
         readonly thinkingConfig?: {
             readonly thinkingBudget?: number | undefined;
             readonly includeThoughts?: boolean | undefined;
-            readonly thinkingLevel?: (string & {}) | "minimal" | "low" | "medium" | "high" | undefined;
+            readonly thinkingLevel?: import("../schema/options.js").OpenString<"minimal" | "low" | "medium" | "high"> | undefined;
         } | undefined;
         readonly maxOutputTokens?: number | undefined;
     } | undefined;
@@ -278,8 +278,8 @@ export declare const route: Route<{
     } | undefined;
     readonly cachedContent?: string | undefined;
     readonly safetySettings?: readonly {
-        readonly category: (string & {}) | "HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY";
-        readonly threshold: (string & {}) | "HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF";
+        readonly category: import("../schema/options.js").OpenString<"HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY">;
+        readonly threshold: import("../schema/options.js").OpenString<"HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF">;
     }[] | undefined;
     readonly labels?: {
         readonly [x: string]: string;
@@ -300,7 +300,7 @@ export declare const route: Route<{
         readonly thinkingConfig?: {
             readonly thinkingBudget?: number | undefined;
             readonly includeThoughts?: boolean | undefined;
-            readonly thinkingLevel?: (string & {}) | "minimal" | "low" | "medium" | "high" | undefined;
+            readonly thinkingLevel?: import("../schema/options.js").OpenString<"minimal" | "low" | "medium" | "high"> | undefined;
         } | undefined;
         readonly maxOutputTokens?: number | undefined;
     } | undefined;

package/dist/protocols/gemini.js

@@ -11,10 +11,11 @@ import { Media } from "../media.js";
 import { JsonObject, knownString, lenient, optionalArray, optionalNull, ProviderShared } from "./shared.js";
 import { GeminiGenerateContent } from "./utils/gemini-generate-content.js";
 import { Lifecycle } from "./utils/lifecycle.js";
-import { ToolSchemaProjection } from "./utils/tool-schema.js";
 const ADAPTER = "gemini";
 // Google documents this sentinel for replaying Gemini 3 function calls after their original signature was lost.
 const SKIP_THOUGHT_SIGNATURE_VALIDATOR = "skip_thought_signature_validator";
+// Gemini 2.5 rejects a budget under the model's minimum: 512 on Flash-Lite, the highest, and 128 on Pro.
+const MIN_THINKING_BUDGET = 512;
 export const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
 // Gemini 3 rejects replayed function calls without a thought signature. Google's SDKs avoid that in normal chats by
 // retaining complete model responses, but OpenCode reconstructs durable history and may encounter an unsigned call
@@ -188,12 +189,11 @@ const GeminiEvent = Schema.Struct({
 // =============================================================================
 // Request Lowering
 // =============================================================================
-// Tool schemas go in `parametersJsonSchema`, which accepts standard JSON Schema. Gemini's schema
-// rules are this API's default, including for tuned endpoints whose IDs do not name Gemini.
-const lowerTool = (tool, model) => ({
+// Tool schemas go in `parametersJsonSchema`, which accepts standard JSON Schema.
+const lowerTool = (tool) => ({
     name: tool.name,
     description: tool.description,
-    parametersJsonSchema: ToolSchemaProjection.modelCompatibility(tool.inputSchema, model, "gemini"),
+    parametersJsonSchema: tool.inputSchema,
 });
 const lowerToolConfig = (toolChoice) => ProviderShared.matchToolChoice("Gemini", toolChoice, {
     auto: () => ({ functionCallingConfig: { mode: "AUTO" } }),
@@ -366,9 +366,16 @@ const fromRequest = Effect.fn("Gemini.fromRequest")(function* (request) {
         presencePenalty: generation?.presencePenalty,
         seed: generation?.seed,
         stopSequences: generation?.stop,
+        // Gemini accepts a budget above `maxOutputTokens`, but thinking then leaves the answer empty.
         thinkingConfig: options.thinkingConfig === undefined
             ? undefined
-            : { ...options.thinkingConfig, includeThoughts: options.thinkingConfig.includeThoughts ?? true },
+            : {
+                ...options.thinkingConfig,
+                includeThoughts: options.thinkingConfig.includeThoughts ?? true,
+                thinkingBudget: options.thinkingConfig.thinkingBudget === undefined
+                    ? undefined
+                    : ProviderShared.fitThinkingBudget(options.thinkingConfig.thinkingBudget, generation?.maxTokens, MIN_THINKING_BUDGET),
+            },
     };
     return {
         cachedContent: options.cachedContent,
@@ -379,7 +386,7 @@ const fromRequest = Effect.fn("Gemini.fromRequest")(function* (request) {
         tools: hasTools
             ? [
                 {
-                    functionDeclarations: flattened.tools.map((tool) => lowerTool(tool, request.model)),
+                    functionDeclarations: flattened.tools.map(lowerTool),
                 },
             ]
             : undefined,
@@ -645,6 +652,8 @@ export const protocol = Protocol.make({
         schema: GeminiBody,
         from: fromRequest,
     },
+    // Gemini's schema rules are this API's default, including for tuned endpoints whose IDs do not name Gemini.
+    sanitizer: "gemini",
     stream: {
         event: Protocol.jsonEvent(GeminiEvent),
         initial: (request) => ({

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

@@ -1,12 +1,12 @@
 import { ImageModel, ImageResponse, type ImageRequestFor } from "../image.js";
 import { MediaProtocol } from "../route/media-protocol.js";
 import { MediaRoute } from "../route/media.js";
+import { type OpenString } from "../schema/index.js";
 export declare const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
-export type GoogleImageString<Known extends string> = Known | (string & {});
 /** Provider-native options. Common fields (`aspectRatio`, `seed`, `images`) live on the request. */
 export type GoogleImageOptions = {
-    readonly imageSize?: GoogleImageString<"1K" | "2K" | "4K">;
-    readonly thinkingLevel?: GoogleImageString<"MINIMAL" | "LOW" | "MEDIUM" | "HIGH">;
+    readonly imageSize?: OpenString<"1K" | "2K" | "4K">;
+    readonly thinkingLevel?: OpenString<"MINIMAL" | "LOW" | "MEDIUM" | "HIGH">;
     readonly includeThoughts?: boolean;
 } & Record<string, unknown>;
 export type Request = ImageRequestFor<GoogleImageOptions>;

package/dist/protocols/google-images.js

@@ -2,13 +2,11 @@ import { Effect, Schema } from "effect";
 import { ImageModel, ImageResponse } from "../image.js";
 import { MediaProtocol } from "../route/media-protocol.js";
 import { MediaRoute } from "../route/media.js";
-import { ProviderID, mergeJsonRecords } from "../schema/index.js";
+import { mergeJsonRecords } from "../schema/index.js";
 import { ProviderShared } from "./shared.js";
 import { GeminiGenerateContent } from "./utils/gemini-generate-content.js";
 import { MediaInput } from "./utils/media-input.js";
-const ADAPTER = "google-images";
-const NAME = "Google Images";
-const PROVIDER = ProviderID.make("google");
+const route = MediaProtocol.identity({ id: "google-images", name: "Google Images", provider: "google" });
 export const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
 // ---------------------------------------------------------------------------
 // 2. Response schema
@@ -63,13 +61,8 @@ const generationConfig = (request) => {
 };
 const fromRequest = Effect.fn("GoogleImages.fromRequest")(function* (request) {
     if (request.n !== undefined && request.n > 1)
-        return yield* ProviderShared.unsupportedOperation({
-            operation: "image.n",
-            provider: PROVIDER,
-            route: ADAPTER,
-            message: `${NAME} generates one image per request; call it once per image instead of n=${request.n}`,
-        });
-    const parts = yield* Effect.forEach(request.images ?? [], (image) => GeminiGenerateContent.mediaPart(NAME, image));
+        return yield* route.unsupported("media.n", `${route.name} generates one image per request; call it once per image instead of n=${request.n}`);
+    const parts = yield* Effect.forEach(request.images ?? [], (image) => GeminiGenerateContent.mediaPart(route.name, image));
     return MediaProtocol.json(mergeJsonRecords({
         contents: [{ role: "user", parts: [{ text: request.prompt }, ...parts] }],
         generationConfig: generationConfig(request),
@@ -78,8 +71,9 @@ const fromRequest = Effect.fn("GoogleImages.fromRequest")(function* (request) {
 // ---------------------------------------------------------------------------
 // 6. Response decoding
 // ---------------------------------------------------------------------------
+const decodeDocument = route.decodeJson(GoogleImageResponse);
 const decodeResponse = Effect.fn("GoogleImages.decodeResponse")(function* (response) {
-    const output = yield* MediaProtocol.decodeJson(ADAPTER, NAME, GoogleImageResponse)(response);
+    const output = yield* decodeDocument(response);
     const decoded = output.value;
     const candidates = decoded.candidates ?? [];
     const candidateMetadata = candidates.map((candidate, candidateIndex) => ({
@@ -110,7 +104,7 @@ const decodeResponse = Effect.fn("GoogleImages.decodeResponse")(function* (respo
                 thoughtSignature: part.thoughtSignature,
             },
         ]));
-    const images = yield* Effect.forEach(encoded, (item) => MediaInput.decodedAsset(output.invalid, `${NAME} candidate ${item.candidateIndex} part ${item.partIndex}`, item.inlineData.data, item.inlineData.mimeType, {
+    const images = yield* Effect.forEach(encoded, (item) => MediaInput.decodedAsset(output.invalid, `${route.name} candidate ${item.candidateIndex} part ${item.partIndex}`, item.inlineData.data, item.inlineData.mimeType, {
         providerMetadata: {
             google: {
                 candidateIndex: item.candidate.index ?? item.candidateIndex,
@@ -125,7 +119,7 @@ const decodeResponse = Effect.fn("GoogleImages.decodeResponse")(function* (respo
     }));
     if (images.length === 0) {
         const finishReasons = candidates.flatMap((candidate) => candidate.finishReason === undefined ? [] : [candidate.finishReason]);
-        return yield* output.invalid(`${NAME} returned no final images${finishReasons.length === 0 ? "" : ` (finish reasons: ${finishReasons.join(", ")})`}; inspect body for prompt feedback and candidate details`);
+        return yield* output.invalid(`${route.name} returned no final images${finishReasons.length === 0 ? "" : ` (finish reasons: ${finishReasons.join(", ")})`}; inspect body for prompt feedback and candidate details`);
     }
     // Candidates that stopped for a safety or policy reason are partial results, not a silent drop.
     const notices = [
@@ -134,7 +128,7 @@ const decodeResponse = Effect.fn("GoogleImages.decodeResponse")(function* (respo
             : [
                 {
                     type: "filtered",
-                    message: `${NAME} reported prompt feedback`,
+                    message: `${route.name} reported prompt feedback`,
                     providerMetadata: { google: { promptFeedback: decoded.promptFeedback } },
                 },
             ]),
@@ -143,7 +137,7 @@ const decodeResponse = Effect.fn("GoogleImages.decodeResponse")(function* (respo
             : [
                 {
                     type: "filtered",
-                    message: `${NAME} candidate ${candidate.index ?? index} finished with ${candidate.finishReason}${candidate.finishMessage === undefined ? "" : `: ${candidate.finishMessage}`}`,
+                    message: `${route.name} candidate ${candidate.index ?? index} finished with ${candidate.finishReason}${candidate.finishMessage === undefined ? "" : `: ${candidate.finishMessage}`}`,
                     providerMetadata: {
                         google: {
                             candidateIndex: candidate.index ?? index,
@@ -186,16 +180,12 @@ const decodeResponse = Effect.fn("GoogleImages.decodeResponse")(function* (respo
 // ---------------------------------------------------------------------------
 // 7. Protocol and route
 // ---------------------------------------------------------------------------
-export const protocol = MediaProtocol.inline({
-    id: ADAPTER,
-    name: NAME,
+export const protocol = MediaProtocol.inline(route, {
     unsupported: ["mask", "size", "format"],
     body: { from: fromRequest },
     response: { decode: decodeResponse },
 });
 export const model = (input) => ImageModel.fromRoute({
-    id: ADAPTER,
-    provider: PROVIDER,
     protocol,
     baseURL: DEFAULT_BASE_URL,
     path: ({ request }) => `/models/${request.model.id}:generateContent`,

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

@@ -26,6 +26,14 @@ interface State extends SpeechStream.Audio, GeminiGenerateContent.Metadata {
     readonly mimeType?: string;
 }
 export declare const protocol: MediaProtocol.Streamed<Request, {
+    readonly id: string;
+    readonly type: "generation-queued";
+    readonly position?: number | undefined;
+} | {
+    readonly id: string;
+    readonly type: "generation-progress";
+    readonly progress?: number | undefined;
+} | {
     readonly type: "audio-delta";
     readonly chunk: Uint8Array<ArrayBufferLike>;
 } | {
@@ -77,6 +85,14 @@ export declare const protocol: MediaProtocol.Streamed<Request, {
 export declare const model: (input: MediaRoute.ModelInput) => SpeechModel<GoogleSpeechOptions>;
 export declare const GoogleSpeech: {
     readonly protocol: MediaProtocol.Streamed<Request, {
+        readonly id: string;
+        readonly type: "generation-queued";
+        readonly position?: number | undefined;
+    } | {
+        readonly id: string;
+        readonly type: "generation-progress";
+        readonly progress?: number | undefined;
+    } | {
         readonly type: "audio-delta";
         readonly chunk: Uint8Array<ArrayBufferLike>;
     } | {

package/dist/protocols/google-speech.js

@@ -1,13 +1,11 @@
 import { Effect, Schema } from "effect";
 import { MediaProtocol } from "../route/media-protocol.js";
 import { MediaRoute } from "../route/media.js";
-import { ProviderID, mergeJsonRecords } from "../schema/index.js";
+import { mergeJsonRecords } from "../schema/index.js";
 import { SpeechModel } from "../speech.js";
 import { GeminiGenerateContent } from "./utils/gemini-generate-content.js";
 import { SpeechStream } from "./utils/speech-stream.js";
-const ADAPTER = "google-speech";
-const NAME = "Google Speech";
-const PROVIDER = ProviderID.make("google");
+const route = MediaProtocol.identity({ id: "google-speech", name: "Google Speech", provider: "google" });
 export const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
 const DEFAULT_SAMPLE_RATE = 24000;
 // ---------------------------------------------------------------------------
@@ -17,13 +15,18 @@ const GenerateContentChunk = GeminiGenerateContent.chunk(Schema.Struct({
     text: Schema.optional(Schema.String),
     inlineData: Schema.optional(Schema.Struct({ mimeType: Schema.String, data: Schema.Uint8ArrayFromBase64 })),
 }));
-const decodeChunk = MediaProtocol.decodeFrame(ADAPTER, NAME, GenerateContentChunk);
+const decodeChunk = route.decodeFrame(GenerateContentChunk);
 // ---------------------------------------------------------------------------
 // 5. Request body construction
 // ---------------------------------------------------------------------------
 const fromRequest = Effect.fn("GoogleSpeech.fromRequest")(function* (request) {
+    // Not in `unsupported`: that list would also reject `timestamps: false`, which asks for nothing.
+    if (request.timestamps === true)
+        return yield* route.unsupported("media.timestamps", `${route.name} does not return timestamps`);
+    if (request.format === "pcm" && request.mode === "generate" && /^gemini-3\.8-.*-tts(?:-|$)/.test(request.model.id))
+        return yield* route.unsupported("media.format", `${route.name} returns WAV by default for Gemini 3.8 TTS unary requests; omit the format to accept it`);
     if (request.format !== undefined && request.format !== "pcm")
-        return yield* SpeechStream.unsupportedFormat(PROVIDER, ADAPTER, `${NAME} only returns raw PCM; request format "pcm" or omit it, then wrap the samples yourself`);
+        return yield* route.unsupported("media.format", `${route.name} only accepts raw PCM as an explicit format; omit it to accept the provider's default output`);
     const voiceName = SpeechStream.voiceID(request.voice);
     return MediaProtocol.json(mergeJsonRecords({
         contents: [{ role: "user", parts: [{ text: request.text }] }],
@@ -41,17 +44,22 @@ const fromRequest = Effect.fn("GoogleSpeech.fromRequest")(function* (request) {
 // ---------------------------------------------------------------------------
 const step = Effect.fn("GoogleSpeech.step")(function* (state, frame) {
     const chunk = yield* decodeChunk(frame);
-    const blocked = GeminiGenerateContent.blocked(NAME, chunk, frame);
+    const blocked = GeminiGenerateContent.blocked(route.name, chunk, frame);
     if (blocked !== undefined)
         return yield* blocked;
     const audio = (chunk.candidates?.[0]?.content?.parts ?? []).flatMap((part) => part.inlineData === undefined ? [] : [part.inlineData]);
     const next = { ...GeminiGenerateContent.track(state, chunk), mimeType: state.mimeType ?? audio[0]?.mimeType };
     return [next, audio.flatMap((part) => SpeechStream.delta(next, part.data)[1])];
 });
-const finish = (state) => {
+const finish = (state, context) => {
     const sampleRate = SpeechStream.sampleRate(state.mimeType) ?? DEFAULT_SAMPLE_RATE;
-    return SpeechStream.finish(ADAPTER, state, {
-        ...SpeechStream.pcm("pcm_s16le", sampleRate, state.mimeType ?? `audio/L16;codec=pcm;rate=${sampleRate}`),
+    const output = state.mimeType?.split(";")[0]?.toLowerCase() === "audio/wav"
+        ? SpeechStream.container("wav", sampleRate)
+        : SpeechStream.pcm("pcm_s16le", sampleRate, state.mimeType ?? `audio/L16;codec=pcm;rate=${sampleRate}`);
+    if (context.request.format === "pcm" && output.info.format !== "pcm")
+        return Effect.fail(route.frameError(`Google Speech returned ${output.info.format} instead of the requested raw PCM`));
+    return SpeechStream.finish(route, state, {
+        ...output,
         usage: GeminiGenerateContent.usage(state.usage),
         providerMetadata: GeminiGenerateContent.providerMetadata(state),
         detail: state.finishReason === undefined ? undefined : `finish reason: ${state.finishReason}`,
@@ -60,10 +68,8 @@ const finish = (state) => {
 // ---------------------------------------------------------------------------
 // 7. Protocol and route
 // ---------------------------------------------------------------------------
-export const protocol = MediaProtocol.stream({
-    id: ADAPTER,
-    name: NAME,
-    unsupported: ["instructions", "speed", "timestamps"],
+export const protocol = MediaProtocol.stream(route, {
+    unsupported: ["instructions", "speed"],
     body: { from: fromRequest },
     frames: (bytes, context) => GeminiGenerateContent.frames(bytes, context.request.mode),
     initial: () => ({ chunks: [] }),
@@ -71,8 +77,6 @@ export const protocol = MediaProtocol.stream({
     finish,
 });
 export const model = (input) => SpeechModel.fromRoute({
-    id: ADAPTER,
-    provider: PROVIDER,
     protocol,
     baseURL: DEFAULT_BASE_URL,
     // Only `gemini-3.1-flash-tts-preview` and later stream; earlier TTS models reject `streamGenerateContent`.

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

@@ -1,5 +1,6 @@
 import { MediaProtocol } from "../route/media-protocol.js";
 import { MediaRoute } from "../route/media.js";
+import { type OpenString } from "../schema/index.js";
 import { TranscriptionModel, type TranscriptionRequestFor, type TranscriptionSegment, type TranscriptionWord } from "../transcription.js";
 import { GeminiGenerateContent } from "./utils/gemini-generate-content.js";
 export declare const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
@@ -9,7 +10,7 @@ export declare const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.c
  */
 export type GoogleTranscriptionOptions = {
     readonly audioTranscriptionConfig?: {
-        readonly mode?: "VERBATIM" | "SMART" | (string & {});
+        readonly mode?: OpenString<"VERBATIM" | "SMART">;
         readonly customVocabulary?: ReadonlyArray<string>;
         readonly languageCodes?: ReadonlyArray<string>;
     };