@opencode/ai 0.0.0-dev-20120 → 0.0.0-dev-20123

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/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("image.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.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,13 @@ 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) {
     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 returns raw PCM; request format "pcm" or omit it, then wrap the samples yourself`);
     const voiceName = SpeechStream.voiceID(request.voice);
     return MediaProtocol.json(mergeJsonRecords({
         contents: [{ role: "user", parts: [{ text: request.text }] }],
@@ -41,7 +39,7 @@ 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]);
@@ -50,7 +48,7 @@ const step = Effect.fn("GoogleSpeech.step")(function* (state, frame) {
 });
 const finish = (state) => {
     const sampleRate = SpeechStream.sampleRate(state.mimeType) ?? DEFAULT_SAMPLE_RATE;
-    return SpeechStream.finish(ADAPTER, state, {
+    return SpeechStream.finish(route, state, {
         ...SpeechStream.pcm("pcm_s16le", sampleRate, state.mimeType ?? `audio/L16;codec=pcm;rate=${sampleRate}`),
         usage: GeminiGenerateContent.usage(state.usage),
         providerMetadata: GeminiGenerateContent.providerMetadata(state),
@@ -60,9 +58,7 @@ const finish = (state) => {
 // ---------------------------------------------------------------------------
 // 7. Protocol and route
 // ---------------------------------------------------------------------------
-export const protocol = MediaProtocol.stream({
-    id: ADAPTER,
-    name: NAME,
+export const protocol = MediaProtocol.stream(route, {
     unsupported: ["instructions", "speed", "timestamps"],
     body: { from: fromRequest },
     frames: (bytes, context) => GeminiGenerateContent.frames(bytes, context.request.mode),
@@ -71,8 +67,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>;
     };

package/dist/protocols/google-transcription.js

@@ -1,13 +1,10 @@
 import { Effect, Schema, SchemaGetter } 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 { TranscriptionFinishEvent, TranscriptionModel, TranscriptionSegmentEvent, TranscriptionTextDeltaEvent, } from "../transcription.js";
-import { ProviderShared } from "./shared.js";
 import { GeminiGenerateContent } from "./utils/gemini-generate-content.js";
-const ADAPTER = "google-transcription";
-const NAME = "Google Transcription";
-const PROVIDER = ProviderID.make("google");
+const route = MediaProtocol.identity({ id: "google-transcription", name: "Google Transcription", provider: "google" });
 export const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
 // ---------------------------------------------------------------------------
 // 3. Streaming event schema
@@ -26,21 +23,16 @@ const AudioTranscription = Schema.Struct({
         speakerLabel: Schema.optional(Schema.String),
     }))),
 });
-const decodeChunk = MediaProtocol.decodeFrame(ADAPTER, NAME, GeminiGenerateContent.chunk(Schema.Struct({ audioTranscription: Schema.optional(AudioTranscription) })));
+const decodeChunk = route.decodeFrame(GeminiGenerateContent.chunk(Schema.Struct({ audioTranscription: Schema.optional(AudioTranscription) })));
 // ---------------------------------------------------------------------------
 // 5. Request body construction
 // ---------------------------------------------------------------------------
 const fromRequest = Effect.fn("GoogleTranscription.fromRequest")(function* (request) {
     // General Gemini models ignore `audioTranscriptionConfig` and answer the audio conversationally.
     if (!request.model.id.includes("transcribe"))
-        return yield* ProviderShared.unsupportedOperation({
-            operation: "transcription.model",
-            provider: PROVIDER,
-            route: ADAPTER,
-            message: `${request.model.id} is not a transcription model; use a transcribe model such as gemini-3.5-transcribe`,
-        });
+        return yield* route.unsupported("transcription.model", `${request.model.id} is not a transcription model; use a transcribe model such as gemini-3.5-transcribe`);
     return MediaProtocol.json(mergeJsonRecords({
-        contents: [{ role: "user", parts: [yield* GeminiGenerateContent.mediaPart(ADAPTER, request.audio)] }],
+        contents: [{ role: "user", parts: [yield* GeminiGenerateContent.mediaPart(route.id, request.audio)] }],
         generationConfig: mergeJsonRecords({
             audioTranscriptionConfig: {
                 languageCodes: request.language === undefined ? undefined : [request.language],
@@ -80,7 +72,7 @@ const turn = (part) => {
 };
 const step = Effect.fn("GoogleTranscription.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 turns = (chunk.candidates?.[0]?.content?.parts ?? []).flatMap((part) => part.audioTranscription === undefined ? [] : [turn(part.audioTranscription)]);
@@ -101,7 +93,7 @@ const step = Effect.fn("GoogleTranscription.step")(function* (state, frame) {
 });
 const finish = (state) => {
     if (state.finishReason === undefined)
-        return Effect.fail(MediaProtocol.incomplete(ADAPTER));
+        return Effect.fail(route.incomplete());
     return Effect.succeed([
         TranscriptionFinishEvent.make({
             text: state.text,
@@ -115,9 +107,7 @@ const finish = (state) => {
 // ---------------------------------------------------------------------------
 // 7. Protocol and route
 // ---------------------------------------------------------------------------
-export const protocol = MediaProtocol.stream({
-    id: ADAPTER,
-    name: NAME,
+export const protocol = MediaProtocol.stream(route, {
     unsupported: ["prompt", "speakers"],
     body: { from: fromRequest },
     frames: (bytes, context) => GeminiGenerateContent.frames(bytes, context.request.mode),
@@ -126,8 +116,6 @@ export const protocol = MediaProtocol.stream({
     finish,
 });
 export const model = (input) => TranscriptionModel.fromRoute({
-    id: ADAPTER,
-    provider: PROVIDER,
     protocol,
     baseURL: DEFAULT_BASE_URL,
     path: ({ request }) => GeminiGenerateContent.path(request.model.id, request.mode),

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

@@ -1,12 +1,12 @@
 import { Schema } from "effect";
 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 declare const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
-export type GoogleVideoString<Known extends string> = Known | (string & {});
 /** Provider-native `parameters`. Common fields (`aspectRatio`, `resolution`, `durationSeconds`, `seed`) live on the request. */
 export type GoogleVideoOptions = {
-    readonly personGeneration?: GoogleVideoString<"allow_all" | "allow_adult" | "dont_allow">;
+    readonly personGeneration?: OpenString<"allow_all" | "allow_adult" | "dont_allow">;
 } & Record<string, unknown>;
 export type Request = VideoRequestFor<GoogleVideoOptions>;
 /** The long-running operation name, e.g. `models/veo-3.1-generate-preview/operations/abc123`. */

package/dist/protocols/google-video.js

@@ -2,12 +2,10 @@ import { Duration, 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, optionalArray } from "./shared.js";
-const ADAPTER = "google-video";
-const NAME = "Google Veo";
-const PROVIDER = ProviderID.make("google");
+const route = MediaProtocol.identity({ id: "google-video", name: "Google Veo", provider: "google" });
 export const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
 /** Veo keeps generated files for two days; the asset carries that deadline so callers materialize in time. */
 const FILE_RETENTION = Duration.days(2);
@@ -38,24 +36,14 @@ const Operation = Schema.Struct({
 // 5. Request body construction
 // ---------------------------------------------------------------------------
 // Veo takes inline media only; a prior Veo output is `Media.url` with transient auth, so materialize it first.
-const inlineMedia = (asset) => ProviderShared.requireInlineMedia(NAME, asset).pipe(Effect.map((inline) => ({ inlineData: { mimeType: inline.mime, data: inline.base64 } })));
+const inlineMedia = (asset) => ProviderShared.requireInlineMedia(route.name, asset).pipe(Effect.map((inline) => ({ inlineData: { mimeType: inline.mime, data: inline.base64 } })));
 const fromRequest = Effect.fn("GoogleVideo.fromRequest")(function* (request) {
     if (request.n !== undefined && request.n > 1)
-        return yield* ProviderShared.unsupportedOperation({
-            operation: "video.n",
-            provider: PROVIDER,
-            route: ADAPTER,
-            message: `${NAME} generates one video per request; call it once per video instead of n=${request.n}`,
-        });
+        return yield* route.unsupported("video.n", `${route.name} generates one video per request; call it once per video instead of n=${request.n}`);
     if (request.audio === false)
-        return yield* ProviderShared.unsupportedOperation({
-            operation: "video.audio",
-            provider: PROVIDER,
-            route: ADAPTER,
-            message: `${NAME} always generates audio; audio: false cannot be honored`,
-        });
+        return yield* route.unsupported("video.audio", `${route.name} always generates audio; audio: false cannot be honored`);
     if (request.frames?.last !== undefined && request.frames.first === undefined)
-        return yield* ProviderShared.invalidRequest(`${NAME} requires frames.first when frames.last is set`);
+        return yield* ProviderShared.invalidRequest(`${route.name} requires frames.first when frames.last is set`);
     const image = request.frames?.first === undefined ? undefined : yield* inlineMedia(request.frames.first);
     const lastFrame = request.frames?.last === undefined ? undefined : yield* inlineMedia(request.frames.last);
     const video = request.video === undefined ? undefined : yield* inlineMedia(request.video);
@@ -82,7 +70,7 @@ const fromRequest = Effect.fn("GoogleVideo.fromRequest")(function* (request) {
 // ---------------------------------------------------------------------------
 // 6. Response decoding
 // ---------------------------------------------------------------------------
-const decodeStart = MediaProtocol.decodeStarted(ADAPTER, NAME, StartResponse, (value) => ({
+const decodeStart = route.decodeStarted(StartResponse, (value) => ({
     token: { operation: value.name },
     snapshot: { id: value.name, status: "running" },
 }));
@@ -92,7 +80,7 @@ const statusOf = (operation) => {
         return "running";
     return operation.error === undefined ? "completed" : "failed";
 };
-const decodeOperation = MediaProtocol.decodeJson(ADAPTER, NAME, Operation);
+const decodeOperation = route.decodeJson(Operation);
 const decodeStatus = Effect.fn("GoogleVideo.decodeStatus")(function* (response, context) {
     const output = yield* decodeOperation(response);
     return { id: context.token.operation, status: statusOf(output.value) };
@@ -102,9 +90,9 @@ const decodeResult = Effect.fn("GoogleVideo.decodeResult")(function* (response,
     const operation = output.value;
     const status = statusOf(operation);
     if (status === "running")
-        return yield* output.invalid(`${NAME} operation ${context.token.operation} has not finished`);
+        return yield* output.invalid(`${route.name} operation ${context.token.operation} has not finished`);
     if (status === "failed")
-        return yield* output.ended("failed", `${NAME} operation failed${operation.error?.message === undefined ? "" : `: ${operation.error.message}`}`);
+        return yield* output.ended("failed", `${route.name} operation failed${operation.error?.message === undefined ? "" : `: ${operation.error.message}`}`);
     const generated = operation.response?.generateVideoResponse;
     // Downloads require the same API key as the poll; the asset carries it transiently and follows the redirect.
     const videos = yield* Effect.forEach((generated?.generatedSamples ?? []).flatMap((sample) => sample.video?.uri === undefined ? [] : [{ uri: sample.video.uri, mimeType: sample.video.mimeType }]), (video) => MediaProtocol.expiringUrl(video.uri, FILE_RETENTION, {
@@ -114,13 +102,13 @@ const decodeResult = Effect.fn("GoogleVideo.decodeResult")(function* (response,
     const reasons = generated?.raiMediaFilteredReasons ?? [];
     const notices = reasons.map((reason) => ({
         type: "filtered",
-        message: `${NAME} filtered media: ${reason}`,
+        message: `${route.name} filtered media: ${reason}`,
         providerMetadata: { google: { raiMediaFilteredReason: reason } },
     }));
     if (videos.length === 0 && (reasons.length > 0 || (generated?.raiMediaFilteredCount ?? 0) > 0))
-        return yield* output.contentPolicy(`${NAME} filtered every video${reasons.length === 0 ? "" : `: ${reasons.join("; ")}`}`);
+        return yield* output.contentPolicy(`${route.name} filtered every video${reasons.length === 0 ? "" : `: ${reasons.join("; ")}`}`);
     if (videos.length === 0)
-        return yield* output.invalid(`${NAME} operation completed without any video`);
+        return yield* output.invalid(`${route.name} operation completed without any video`);
     return new VideoResponse({
         videos,
         notices: notices.length === 0 ? undefined : notices,
@@ -137,17 +125,13 @@ const decodeResult = Effect.fn("GoogleVideo.decodeResult")(function* (response,
 // 7. Protocol and route
 // ---------------------------------------------------------------------------
 const operationPath = (token) => `/${token.operation}`;
-export const protocol = MediaProtocol.queued({
-    id: ADAPTER,
-    name: NAME,
+export const protocol = MediaProtocol.queued(route, {
     token: Token,
     start: { body: { from: fromRequest }, decode: decodeStart },
     status: { path: operationPath, decode: decodeStatus },
     result: { path: operationPath, decode: decodeResult },
 });
 export const model = (input) => VideoModel.fromRoute({
-    id: ADAPTER,
-    provider: PROVIDER,
     protocol,
     baseURL: DEFAULT_BASE_URL,
     path: ({ request }) => `/models/${request.model.id}:predictLongRunning`,

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

@@ -1,7 +1,8 @@
 import { ImageModel, ImageResponse, type ImageRequestFor } from "../image.js";
 import { MediaProtocol } from "../route/media-protocol.js";
 import { MediaRoute } from "../route/media.js";
-type OpenString<Known extends string> = Known | (string & {});
+import { type OpenString } from "../schema/index.js";
+export declare const DEFAULT_BASE_URL = "https://api.meta.ai/v1";
 /** Provider-native options. Common fields (`n`, `size`, `format`, `images`) live on the request. */
 export type ImageOptions = {
     readonly responseFormat?: OpenString<"b64_json" | "url">;
@@ -15,7 +16,5 @@ export type ImageOptions = {
 };
 export type Request = ImageRequestFor<ImageOptions>;
 export declare const protocol: MediaProtocol.Inline<Request, ImageResponse>;
-export declare const model: (input: MediaRoute.ModelInput & {
-    readonly baseURL: string;
-}) => ImageModel<ImageOptions>;
+export declare const model: (input: MediaRoute.ModelInput) => ImageModel<ImageOptions>;
 export * as MetaImages from "./meta-images.js";

package/dist/protocols/meta-images.js

@@ -3,12 +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 { JsonObject, ProviderShared, optionalNull } from "./shared.js";
 import { MediaInput } from "./utils/media-input.js";
-const ADAPTER = "meta-images";
-const NAME = "Meta Images";
-const PROVIDER = ProviderID.make("meta");
+const route = MediaProtocol.identity({ id: "meta-images", name: "Meta Images", provider: "meta" });
+export const DEFAULT_BASE_URL = "https://api.meta.ai/v1";
 // ---------------------------------------------------------------------------
 // 2. Request body and response schemas
 // ---------------------------------------------------------------------------
@@ -38,7 +37,7 @@ const Response = Schema.Struct({
 // ---------------------------------------------------------------------------
 const isEdit = (request) => (request.images?.length ?? 0) > 0;
 // Meta has no file handles: refs are rejected even when they name this provider.
-const reference = (asset) => ProviderShared.mediaReference(asset, undefined, NAME).pipe(Effect.map((item) => ({ image_url: item.value })));
+const reference = (asset) => ProviderShared.mediaReference(asset, undefined, route.name).pipe(Effect.map((item) => ({ image_url: item.value })));
 const fromRequest = Effect.fn("MetaImages.fromRequest")(function* (request) {
     const images = yield* Effect.forEach(request.images ?? [], reference);
     const { responseFormat, reasoningStrength, toolEnablement, ...native } = request.providerOptions ?? {};
@@ -58,23 +57,18 @@ const fromRequest = Effect.fn("MetaImages.fromRequest")(function* (request) {
 // ---------------------------------------------------------------------------
 // 6. Response decoding
 // ---------------------------------------------------------------------------
+const decodeDocument = route.decodeJson(Response);
 const decodeResponse = Effect.fn("MetaImages.decodeResponse")(function* (response, context) {
-    const output = yield* MediaProtocol.decodeJson(ADAPTER, NAME, Response)(response);
+    const output = yield* decodeDocument(response);
     const decoded = output.value;
     const requested = context.body.type === "json" ? context.body.value.output_format : undefined;
     const format = decoded.output_format ?? (typeof requested === "string" ? requested : "webp");
     const mediaType = `image/${format}`;
-    const images = yield* Effect.forEach(decoded.data, (item, index) => {
-        if (item.b64_json)
-            return MediaInput.decodedAsset(output.invalid, `${NAME} result ${index}`, item.b64_json, mediaType, {
-                info: { format },
-            });
-        if (item.url)
-            return Effect.succeed(Media.url(item.url, { mediaType, info: { format } }));
-        return Effect.fail(output.invalid(`${NAME} result ${index} has neither image data nor a URL`));
-    });
+    const images = yield* Effect.forEach(decoded.data, (item, index) => MediaInput.imageOutput(output.invalid, `${route.name} result ${index}`, item, mediaType, {
+        info: { format },
+    }));
     if (images.length === 0)
-        return yield* output.invalid(`${NAME} returned no images`);
+        return yield* output.invalid(`${route.name} returned no images`);
     return new ImageResponse({
         images,
         usage: decoded.usage === undefined
@@ -92,17 +86,14 @@ const decodeResponse = Effect.fn("MetaImages.decodeResponse")(function* (respons
 // ---------------------------------------------------------------------------
 // 7. Protocol and route
 // ---------------------------------------------------------------------------
-export const protocol = MediaProtocol.inline({
-    id: ADAPTER,
-    name: NAME,
+export const protocol = MediaProtocol.inline(route, {
     unsupported: ["mask", "aspectRatio", "seed"],
     body: { from: fromRequest },
     response: { decode: decodeResponse },
 });
 export const model = (input) => ImageModel.fromRoute({
-    id: ADAPTER,
-    provider: PROVIDER,
     protocol,
+    baseURL: DEFAULT_BASE_URL,
     path: ({ request }) => `/images/${isEdit(request) ? "edits" : "generations"}`,
 }, input);
 export * as MetaImages from "./meta-images.js";

package/dist/protocols/meta-messages.d.ts

@@ -221,20 +221,20 @@ export declare const protocol: Protocol<{
     readonly thinking?: {
         readonly type: "enabled";
         readonly budget_tokens: number;
-        readonly display?: (string & {}) | "summarized" | "omitted" | undefined;
+        readonly display?: import("../schema/options.js").OpenString<"summarized" | "omitted"> | undefined;
         readonly block_binding?: {
-            readonly prefix_mismatch_behavior?: (string & {}) | "error" | "drop_block" | undefined;
+            readonly prefix_mismatch_behavior?: import("../schema/options.js").OpenString<"error" | "drop_block"> | undefined;
         } | undefined;
     } | {
         readonly type: "adaptive";
-        readonly display?: (string & {}) | "summarized" | "omitted" | undefined;
+        readonly display?: import("../schema/options.js").OpenString<"summarized" | "omitted"> | undefined;
         readonly block_binding?: {
-            readonly prefix_mismatch_behavior?: (string & {}) | "error" | "drop_block" | undefined;
+            readonly prefix_mismatch_behavior?: import("../schema/options.js").OpenString<"error" | "drop_block"> | undefined;
         } | undefined;
     } | {
         readonly type: "disabled";
     } | undefined;
-    readonly service_tier?: "auto" | (string & {}) | "standard_only" | undefined;
+    readonly service_tier?: import("../schema/options.js").OpenString<"auto" | "standard_only"> | undefined;
     readonly container?: string | {
         readonly id?: string | null | undefined;
         readonly skills?: readonly {