@opencode/ai 2.0.15 → 2.0.17

package/dist/protocols/fal-images.js

@@ -0,0 +1,104 @@
+import { Effect, Schema } from "effect";
+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 { 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 route = MediaProtocol.identity({ id: "fal-images", name: "fal Images", provider: "fal" });
+// ---------------------------------------------------------------------------
+// 2. Response schema
+// ---------------------------------------------------------------------------
+const QueueResult = Schema.StructWithRest(Schema.Struct({
+    images: Schema.Array(Schema.Struct({
+        url: Schema.String,
+        width: optionalNull(Schema.Number),
+        height: optionalNull(Schema.Number),
+        content_type: optionalNull(Schema.String),
+    })),
+    seed: optionalNull(Schema.Number),
+    has_nsfw_concepts: optionalNull(Schema.Array(Schema.Boolean)),
+}), [Schema.Record(Schema.String, Schema.Unknown)]);
+// ---------------------------------------------------------------------------
+// 5. Request body construction
+// ---------------------------------------------------------------------------
+const sizing = (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 validate = (request) => {
+    const id = request.model.id;
+    const field = sizing(id);
+    if (request.size !== undefined && request.aspectRatio !== undefined)
+        return Effect.fail(ProviderShared.invalidRequest(`${route.name} accepts either size or aspectRatio, not both`));
+    if (request.size !== undefined && field === "aspect_ratio")
+        return Effect.fail(route.unsupported("media.size", `${id} sizes by aspectRatio`));
+    if (request.aspectRatio !== undefined && field === "image_size")
+        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` 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, route.name));
+    const list = takesImageList(request.model.id);
+    return MediaProtocol.json(mergeJsonRecords({
+        prompt: request.prompt,
+        num_images: request.n,
+        seed: request.seed,
+        image_size: request.size === undefined ? undefined : MediaInput.dimensions(request.size),
+        aspect_ratio: request.aspectRatio,
+        output_format: request.format,
+        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 = 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(`${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) => {
+            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: `${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(route, {
+    from: fromRequest,
+    decodeResult,
+});
+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

@@ -0,0 +1,29 @@
+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";
+/**
+ * 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?: OpenString<"4s" | "6s" | "8s" | "5" | "10">;
+} & Record<string, unknown>;
+export type Request = VideoRequestFor<FalVideoOptions>;
+export declare const protocol: MediaProtocol.Queued<Request, VideoResponse, {
+    readonly requestID: string;
+    readonly statusURL: string;
+    readonly responseURL: string;
+    readonly cancelURL: string;
+}>;
+export declare const model: (input: MediaRoute.ModelInput) => VideoModel<FalVideoOptions>;
+export declare const FalVideo: {
+    readonly protocol: MediaProtocol.Queued<Request, VideoResponse, {
+        readonly requestID: string;
+        readonly statusURL: string;
+        readonly responseURL: string;
+        readonly cancelURL: string;
+    }>;
+    readonly model: (input: MediaRoute.ModelInput) => VideoModel<FalVideoOptions>;
+};

package/dist/protocols/fal-video.js

@@ -0,0 +1,73 @@
+import { Effect, Schema } from "effect";
+import { Media } from "../media.js";
+import { MediaProtocol } from "../route/media-protocol.js";
+import { MediaRoute } from "../route/media.js";
+import { mergeJsonRecords } from "../schema/index.js";
+import { VideoModel, VideoResponse } from "../video.js";
+import { optionalNull } from "./shared.js";
+import { FalQueue } from "./utils/fal-queue.js";
+const route = MediaProtocol.identity({ id: "fal-video", name: "fal Video", provider: "fal" });
+// ---------------------------------------------------------------------------
+// 2. Response schema
+// ---------------------------------------------------------------------------
+const QueueResult = Schema.StructWithRest(Schema.Struct({
+    video: Schema.Struct({
+        url: Schema.String,
+        content_type: optionalNull(Schema.String),
+        file_name: optionalNull(Schema.String),
+        file_size: optionalNull(Schema.Number),
+    }),
+    seed: optionalNull(Schema.Number),
+}), [Schema.Record(Schema.String, Schema.Unknown)]);
+// ---------------------------------------------------------------------------
+// 5. Request body construction
+// ---------------------------------------------------------------------------
+const fromRequest = Effect.fn("FalVideo.fromRequest")(function* (request) {
+    if (request.frames?.last !== undefined)
+        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,
+        seed: request.seed,
+        aspect_ratio: request.aspectRatio,
+        resolution: request.resolution,
+        generate_audio: request.audio,
+        image_url: imageUrl,
+        video_url: videoUrl,
+    }, request.providerOptions, request.http?.body) ?? {});
+});
+// ---------------------------------------------------------------------------
+// 6. Response decoding
+// ---------------------------------------------------------------------------
+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;
+    return new VideoResponse({
+        videos: [Media.url(video.url, { mediaType: video.content_type ?? "video/mp4" })],
+        providerMetadata: {
+            fal: {
+                requestId: context.token.requestID,
+                seed: seed ?? undefined,
+                fileName: video.file_name ?? undefined,
+                fileSize: video.file_size ?? undefined,
+                ...rest,
+            },
+        },
+    });
+});
+// ---------------------------------------------------------------------------
+// 7. Protocol and route
+// ---------------------------------------------------------------------------
+export const protocol = FalQueue.protocol(route, {
+    unsupported: ["n", "durationSeconds", "references"],
+    from: fromRequest,
+    decodeResult,
+});
+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<{
@@ -76,7 +76,7 @@ declare const GeminiBody: Schema.Struct<{
         readonly functionDeclarations: Schema.$Array<Schema.Struct<{
             readonly name: Schema.String;
             readonly description: Schema.String;
-            readonly parameters: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+            readonly parametersJsonSchema: Schema.$Record<Schema.String, Schema.Unknown>;
         }>>;
     }>>>;
     toolConfig: 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">>>;
         }>>;
     }>>;
 }>;
@@ -148,11 +148,11 @@ export declare const protocol: Protocol<{
     }[];
     readonly tools?: readonly {
         readonly functionDeclarations: readonly {
-            readonly description: string;
             readonly name: string;
-            readonly parameters?: {
+            readonly description: string;
+            readonly parametersJsonSchema: {
                 readonly [x: string]: unknown;
-            } | undefined;
+            };
         }[];
     }[] | undefined;
     readonly serviceTier?: string | undefined;
@@ -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;
@@ -206,11 +206,11 @@ export declare const protocol: Protocol<{
         readonly safetyRatings?: unknown;
     } | null | undefined;
     readonly usageMetadata?: {
-        readonly cachedContentTokenCount?: number | null | undefined;
-        readonly thoughtsTokenCount?: number | null | undefined;
         readonly promptTokenCount?: number | null | undefined;
         readonly candidatesTokenCount?: number | null | undefined;
         readonly totalTokenCount?: number | null | undefined;
+        readonly cachedContentTokenCount?: number | null | undefined;
+        readonly thoughtsTokenCount?: number | null | undefined;
     } | null | undefined;
 }, {
     route: string;
@@ -262,11 +262,11 @@ export declare const route: Route<{
     }[];
     readonly tools?: readonly {
         readonly functionDeclarations: readonly {
-            readonly description: string;
             readonly name: string;
-            readonly parameters?: {
+            readonly description: string;
+            readonly parametersJsonSchema: {
                 readonly [x: string]: unknown;
-            } | undefined;
+            };
         }[];
     }[] | undefined;
     readonly serviceTier?: string | 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

@@ -9,12 +9,13 @@ import { AIError, LLMEvent, Usage, } from "../schema/index.js";
 import { classifyProviderFailure } from "../provider-error.js";
 import { Media } from "../media.js";
 import { JsonObject, knownString, lenient, optionalArray, optionalNull, ProviderShared } from "./shared.js";
-import { GeminiToolSchema } from "./utils/gemini-tool-schema.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
@@ -102,7 +103,7 @@ const GeminiSystemInstruction = Schema.Struct({
 const GeminiFunctionDeclaration = Schema.Struct({
     name: Schema.String,
     description: Schema.String,
-    parameters: Schema.optional(JsonObject),
+    parametersJsonSchema: JsonObject,
 });
 const GeminiTool = Schema.Struct({
     functionDeclarations: Schema.Array(GeminiFunctionDeclaration),
@@ -186,34 +187,13 @@ const GeminiEvent = Schema.Struct({
     usageMetadata: optionalNull(GeminiUsage),
 });
 // =============================================================================
-// Tool Schema Conversion
-// =============================================================================
-// Tool-schema conversion has two distinct concerns:
-//
-// 1. Sanitize — fix common authoring mistakes Gemini rejects: integer/number
-//    enums (must be strings), `required` entries that don't match a property,
-//    untyped arrays (`items` must be present), and `properties`/`required`
-//    keys on non-object scalars. Mirrors OpenCode's historical Gemini rules.
-//
-// 2. Project — lossy mapping from JSON Schema to Gemini's schema dialect:
-//    drop empty root parameter schemas while preserving nested empty objects,
-//    expand type arrays into `anyOf`, derive `nullable: true` from null members,
-//    coerce `const` to `[const]` enum, recurse properties/items, and propagate
-//    only an allowlisted set of keys (description, required, format, type,
-//    nullable, enum, properties, items, allOf, anyOf, oneOf, minLength).
-//    Anything outside the allowlist (e.g. `additionalProperties`, `$ref`) is
-//    silently dropped.
-//
-// Sanitize runs first, then project. The implementation lives in
-// `utils/gemini-tool-schema` so this protocol keeps the same shape as the other
-// provider protocols.
-// =============================================================================
 // Request Lowering
 // =============================================================================
-const lowerTool = (tool, inputSchema) => ({
+// Tool schemas go in `parametersJsonSchema`, which accepts standard JSON Schema.
+const lowerTool = (tool) => ({
     name: tool.name,
     description: tool.description,
-    parameters: GeminiToolSchema.convert(inputSchema),
+    parametersJsonSchema: tool.inputSchema,
 });
 const lowerToolConfig = (toolChoice) => ProviderShared.matchToolChoice("Gemini", toolChoice, {
     auto: () => ({ functionCallingConfig: { mode: "AUTO" } }),
@@ -221,15 +201,10 @@ const lowerToolConfig = (toolChoice) => ProviderShared.matchToolChoice("Gemini",
     required: () => ({ functionCallingConfig: { mode: "ANY" } }),
     tool: (name) => ({ functionCallingConfig: { mode: "ANY", allowedFunctionNames: [name] } }),
 });
-// Gemini does not fetch public URLs; inline payloads and Gemini Files references are the accepted inputs.
 const lowerContentPart = Effect.fn("Gemini.lowerContentPart")(function* (part) {
     if (part.type === "text")
         return { text: part.text };
-    const source = part.media.source;
-    if (source.type === "ref" && source.provider === "google")
-        return { fileData: { mimeType: part.media.mediaType, fileUri: source.id } };
-    const media = yield* ProviderShared.requireInlineMedia("Gemini", part.media);
-    return { inlineData: { mimeType: media.mime, data: media.base64 } };
+    return yield* GeminiGenerateContent.mediaPart("Gemini", part.media);
 });
 const providerMetadata = (key, metadata) => ({ [key]: metadata });
 const thoughtSignature = (metadata, key) => {
@@ -382,7 +357,6 @@ const fromRequest = Effect.fn("Gemini.fromRequest")(function* (request) {
     const hasTools = flattened.tools.length > 0;
     const generation = request.generation;
     const options = yield* decodeOptions(request.providerOptions ?? {});
-    const toolSchemaCompatibility = request.model.compatibility?.toolSchema;
     const generationConfig = {
         maxOutputTokens: generation?.maxTokens,
         temperature: generation?.temperature,
@@ -392,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,
@@ -405,7 +386,7 @@ const fromRequest = Effect.fn("Gemini.fromRequest")(function* (request) {
         tools: hasTools
             ? [
                 {
-                    functionDeclarations: flattened.tools.map((tool) => lowerTool(tool, ToolSchemaProjection.modelCompatibility(tool.inputSchema, toolSchemaCompatibility))),
+                    functionDeclarations: flattened.tools.map(lowerTool),
                 },
             ]
             : undefined,
@@ -671,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

@@ -1,14 +1,12 @@
 import { Effect, Schema } from "effect";
 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 } 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
@@ -61,27 +59,10 @@ const generationConfig = (request) => {
         thinkingConfig: Object.values(thinkingConfig).some((value) => value !== undefined) ? thinkingConfig : undefined,
     }, native) ?? { responseModalities: ["IMAGE"] });
 };
-// Gemini does not fetch public URLs; inline payloads or Gemini Files references are the only accepted inputs.
-const imagePart = (asset) => {
-    const inline = asset.inline();
-    if (inline)
-        return Effect.succeed({ inlineData: { mimeType: inline.mime, data: inline.base64 } });
-    const id = MediaInput.refID(asset, PROVIDER);
-    if (id)
-        return Effect.succeed({ fileData: { mimeType: asset.mediaType, fileUri: id } });
-    if (asset.source.type === "ref")
-        return Effect.fail(ProviderShared.invalidRequest("Google generateContent requires Gemini file references rather than other providers' file IDs"));
-    return Effect.fail(ProviderShared.invalidRequest("Google generateContent does not fetch public image URLs; use bytes, a data URL, or a Gemini file reference"));
-};
 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 ?? [], imagePart);
+        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),
@@ -90,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) => ({
@@ -122,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,
@@ -137,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 = [
@@ -146,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 } },
                 },
             ]),
@@ -155,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,
@@ -198,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`,