@opencode/ai 2.0.14 → 2.0.16

package/dist/speech.d.ts

@@ -0,0 +1,1150 @@
+import { Effect, Schema, Stream } from "effect";
+import { Media } from "./media.js";
+import { MediaModel } from "./media-model.js";
+import { MediaRoute } from "./route/media.js";
+import type { MediaProtocol } from "./route/media-protocol.js";
+import { AIError, HttpOptions } from "./schema/index.js";
+import { Service } from "./speech-client.js";
+export type SpeechOptions = Record<string, unknown>;
+export type SpeechRoute<Options extends SpeechOptions = SpeechOptions> = MediaRoute.StreamRoute<SpeechRequestFor<Options>, SpeechEvent, SpeechResponse>;
+export declare class SpeechModel<Options extends SpeechOptions = SpeechOptions> extends MediaModel<SpeechRoute<Options>, Options> {
+    protected readonly _SpeechModel: void;
+    static make<Options extends SpeechOptions = SpeechOptions>(input: MediaModel.Input<SpeechRoute<Options>>): SpeechModel<Options>;
+    /** Compose a streaming speech protocol with its canonical path into a model for one deployment. */
+    static fromRoute<Options extends SpeechOptions = SpeechOptions, Frame = unknown, State = unknown>(route: SpeechModel.RouteInput<Options, Frame, State>, input: MediaRoute.ModelInput): SpeechModel<Options>;
+}
+export declare namespace SpeechModel {
+    type RouteInput<Options extends SpeechOptions = SpeechOptions, Frame = unknown, State = unknown> = MediaModel.RouteInput<MediaProtocol.Addressed<SpeechRequestFor<Options>>, MediaProtocol.Streamed<SpeechRequestFor<Options>, SpeechEvent, Frame, State>>;
+}
+export declare const SpeechModelSchema: Schema.declare<SpeechModel<SpeechOptions>, SpeechModel<SpeechOptions>>;
+/** Provider-native: a name on OpenAI and Gemini, a voice id on ElevenLabs and Cartesia; `{ id }` is an OpenAI custom voice. */
+export declare const SpeechVoice: Schema.Union<readonly [Schema.String, Schema.Struct<{
+    readonly id: Schema.String;
+}>]>;
+export type SpeechVoice = Schema.Schema.Type<typeof SpeechVoice>;
+export type SpeechFormat = "mp3" | "wav" | "pcm" | "opus" | "aac" | "flac" | (string & {});
+/** Granularity is provider-native: characters on ElevenLabs, words on Cartesia. */
+export declare const SpeechTimestamp: Schema.Struct<{
+    readonly text: Schema.String;
+    readonly startSeconds: Schema.Number;
+    readonly endSeconds: Schema.Number;
+}>;
+export type SpeechTimestamp = Schema.Schema.Type<typeof SpeechTimestamp>;
+declare const SpeechRequest_base: Schema.Class<SpeechRequest, Schema.Struct<{
+    readonly model: Schema.declare<SpeechModel<SpeechOptions>, SpeechModel<SpeechOptions>>;
+    readonly text: Schema.String;
+    readonly voice: Schema.optional<Schema.Union<readonly [Schema.String, Schema.Struct<{
+        readonly id: Schema.String;
+    }>]>>;
+    readonly format: Schema.optional<Schema.String>;
+    readonly speed: Schema.optional<Schema.Number>;
+    readonly language: Schema.optional<Schema.String>;
+    readonly instructions: Schema.optional<Schema.String>;
+    readonly timestamps: Schema.optional<Schema.Boolean>;
+    readonly providerOptions: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    readonly http: Schema.optional<typeof HttpOptions>;
+}>, {}>;
+export declare class SpeechRequest extends SpeechRequest_base {
+    protected readonly _SpeechRequest: void;
+}
+export type SpeechRequestFor<Options extends SpeechOptions = SpeechOptions> = Omit<SpeechRequest, "model" | "providerOptions"> & {
+    readonly model: SpeechModel<Options>;
+    readonly providerOptions?: Options;
+};
+export type SpeechModelOptions<Model> = Model extends SpeechModel<infer Options> ? Options : never;
+export type SpeechRequestInput<Model extends SpeechModel = SpeechModel> = Omit<ConstructorParameters<typeof SpeechRequest>[0], "model" | "providerOptions" | "http" | "format"> & {
+    readonly model: Model;
+    readonly format?: SpeechFormat;
+    readonly providerOptions?: NoInfer<SpeechModelOptions<Model>>;
+    readonly http?: HttpOptions.Input;
+};
+declare const SpeechResponse_base: Schema.Class<SpeechResponse, Schema.Struct<{
+    /** The complete audio. Headerless PCM carries `info.encoding`, `info.sampleRate`, and `info.channels`. */
+    readonly audio: Schema.decodeTo<Schema.declare<Media.Asset, Media.Asset>, Schema.Struct<{
+        readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.Literal<"bytes">;
+            readonly data: Schema.Uint8Array;
+            readonly mediaType: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"base64">;
+            readonly data: Schema.String;
+            readonly mediaType: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"url">;
+            readonly url: Schema.String;
+            readonly mediaType: Schema.optional<Schema.String>;
+            readonly expiresAt: Schema.optional<Schema.Number>;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"ref">;
+            readonly provider: Schema.brand<Schema.String, "AI.ProviderID">;
+            readonly id: Schema.String;
+            readonly mediaType: Schema.optional<Schema.String>;
+        }>]>;
+        readonly info: Schema.optional<Schema.Struct<{
+            readonly width: Schema.optional<Schema.Number>;
+            readonly height: Schema.optional<Schema.Number>;
+            readonly durationSeconds: Schema.optional<Schema.Number>;
+            readonly sampleRate: Schema.optional<Schema.Number>;
+            readonly channels: Schema.optional<Schema.Number>;
+            readonly encoding: Schema.optional<Schema.String>;
+            readonly format: Schema.optional<Schema.String>;
+        }>>;
+        readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+    }>, never, never>;
+    readonly timestamps: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly text: Schema.String;
+        readonly startSeconds: Schema.Number;
+        readonly endSeconds: Schema.Number;
+    }>>>;
+    readonly usage: Schema.optional<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"tokens">;
+        readonly input: Schema.optional<Schema.Number>;
+        readonly output: Schema.optional<Schema.Number>;
+        readonly total: Schema.optional<Schema.Number>;
+        readonly details: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"seconds">;
+        readonly seconds: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"characters">;
+        readonly characters: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"credits">;
+        readonly credits: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"compute">;
+        readonly seconds: Schema.Number;
+    }>]>>;
+    readonly notices: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly type: Schema.Literals<readonly ["moderated", "filtered", "other"]>;
+        readonly message: Schema.String;
+        readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+    }>>>;
+    readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+}>, {}>;
+export declare class SpeechResponse extends SpeechResponse_base {
+}
+export declare const SpeechAudioDeltaEvent: Schema.Struct<{
+    readonly type: Schema.tag<"audio-delta">;
+    readonly chunk: Schema.Uint8Array;
+}>;
+export declare const SpeechTimestampsEvent: Schema.Struct<{
+    readonly type: Schema.tag<"timestamps">;
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly text: Schema.String;
+        readonly startSeconds: Schema.Number;
+        readonly endSeconds: Schema.Number;
+    }>>;
+}>;
+/** `audio` is every `audio-delta` chunk concatenated, so the route holds the whole clip in memory until `finish`. */
+export declare const SpeechFinishEvent: Schema.Struct<{
+    readonly type: Schema.tag<"finish">;
+    readonly audio: Schema.decodeTo<Schema.declare<Media.Asset, Media.Asset>, Schema.Struct<{
+        readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.Literal<"bytes">;
+            readonly data: Schema.Uint8Array;
+            readonly mediaType: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"base64">;
+            readonly data: Schema.String;
+            readonly mediaType: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"url">;
+            readonly url: Schema.String;
+            readonly mediaType: Schema.optional<Schema.String>;
+            readonly expiresAt: Schema.optional<Schema.Number>;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"ref">;
+            readonly provider: Schema.brand<Schema.String, "AI.ProviderID">;
+            readonly id: Schema.String;
+            readonly mediaType: Schema.optional<Schema.String>;
+        }>]>;
+        readonly info: Schema.optional<Schema.Struct<{
+            readonly width: Schema.optional<Schema.Number>;
+            readonly height: Schema.optional<Schema.Number>;
+            readonly durationSeconds: Schema.optional<Schema.Number>;
+            readonly sampleRate: Schema.optional<Schema.Number>;
+            readonly channels: Schema.optional<Schema.Number>;
+            readonly encoding: Schema.optional<Schema.String>;
+            readonly format: Schema.optional<Schema.String>;
+        }>>;
+        readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+    }>, never, never>;
+    readonly usage: Schema.optional<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"tokens">;
+        readonly input: Schema.optional<Schema.Number>;
+        readonly output: Schema.optional<Schema.Number>;
+        readonly total: Schema.optional<Schema.Number>;
+        readonly details: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"seconds">;
+        readonly seconds: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"characters">;
+        readonly characters: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"credits">;
+        readonly credits: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"compute">;
+        readonly seconds: Schema.Number;
+    }>]>>;
+    readonly notices: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly type: Schema.Literals<readonly ["moderated", "filtered", "other"]>;
+        readonly message: Schema.String;
+        readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+    }>>>;
+    readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+}>;
+declare const speechEventTagged: Schema.toTaggedUnion<"type", readonly [Schema.Struct<{
+    readonly type: Schema.tag<"audio-delta">;
+    readonly chunk: Schema.Uint8Array;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"timestamps">;
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly text: Schema.String;
+        readonly startSeconds: Schema.Number;
+        readonly endSeconds: Schema.Number;
+    }>>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"finish">;
+    readonly audio: Schema.decodeTo<Schema.declare<Media.Asset, Media.Asset>, Schema.Struct<{
+        readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.Literal<"bytes">;
+            readonly data: Schema.Uint8Array;
+            readonly mediaType: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"base64">;
+            readonly data: Schema.String;
+            readonly mediaType: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"url">;
+            readonly url: Schema.String;
+            readonly mediaType: Schema.optional<Schema.String>;
+            readonly expiresAt: Schema.optional<Schema.Number>;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"ref">;
+            readonly provider: Schema.brand<Schema.String, "AI.ProviderID">;
+            readonly id: Schema.String;
+            readonly mediaType: Schema.optional<Schema.String>;
+        }>]>;
+        readonly info: Schema.optional<Schema.Struct<{
+            readonly width: Schema.optional<Schema.Number>;
+            readonly height: Schema.optional<Schema.Number>;
+            readonly durationSeconds: Schema.optional<Schema.Number>;
+            readonly sampleRate: Schema.optional<Schema.Number>;
+            readonly channels: Schema.optional<Schema.Number>;
+            readonly encoding: Schema.optional<Schema.String>;
+            readonly format: Schema.optional<Schema.String>;
+        }>>;
+        readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+    }>, never, never>;
+    readonly usage: Schema.optional<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"tokens">;
+        readonly input: Schema.optional<Schema.Number>;
+        readonly output: Schema.optional<Schema.Number>;
+        readonly total: Schema.optional<Schema.Number>;
+        readonly details: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"seconds">;
+        readonly seconds: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"characters">;
+        readonly characters: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"credits">;
+        readonly credits: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"compute">;
+        readonly seconds: Schema.Number;
+    }>]>>;
+    readonly notices: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly type: Schema.Literals<readonly ["moderated", "filtered", "other"]>;
+        readonly message: Schema.String;
+        readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+    }>>>;
+    readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+}>]>;
+export declare const SpeechEvent: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.tag<"audio-delta">;
+    readonly chunk: Schema.Uint8Array;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"timestamps">;
+    readonly items: Schema.$Array<Schema.Struct<{
+        readonly text: Schema.String;
+        readonly startSeconds: Schema.Number;
+        readonly endSeconds: Schema.Number;
+    }>>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"finish">;
+    readonly audio: Schema.decodeTo<Schema.declare<Media.Asset, Media.Asset>, Schema.Struct<{
+        readonly source: Schema.Union<readonly [Schema.Struct<{
+            readonly type: Schema.Literal<"bytes">;
+            readonly data: Schema.Uint8Array;
+            readonly mediaType: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"base64">;
+            readonly data: Schema.String;
+            readonly mediaType: Schema.String;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"url">;
+            readonly url: Schema.String;
+            readonly mediaType: Schema.optional<Schema.String>;
+            readonly expiresAt: Schema.optional<Schema.Number>;
+        }>, Schema.Struct<{
+            readonly type: Schema.Literal<"ref">;
+            readonly provider: Schema.brand<Schema.String, "AI.ProviderID">;
+            readonly id: Schema.String;
+            readonly mediaType: Schema.optional<Schema.String>;
+        }>]>;
+        readonly info: Schema.optional<Schema.Struct<{
+            readonly width: Schema.optional<Schema.Number>;
+            readonly height: Schema.optional<Schema.Number>;
+            readonly durationSeconds: Schema.optional<Schema.Number>;
+            readonly sampleRate: Schema.optional<Schema.Number>;
+            readonly channels: Schema.optional<Schema.Number>;
+            readonly encoding: Schema.optional<Schema.String>;
+            readonly format: Schema.optional<Schema.String>;
+        }>>;
+        readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+    }>, never, never>;
+    readonly usage: Schema.optional<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.Literal<"tokens">;
+        readonly input: Schema.optional<Schema.Number>;
+        readonly output: Schema.optional<Schema.Number>;
+        readonly total: Schema.optional<Schema.Number>;
+        readonly details: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"seconds">;
+        readonly seconds: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"characters">;
+        readonly characters: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"credits">;
+        readonly credits: Schema.Number;
+    }>, Schema.Struct<{
+        readonly type: Schema.Literal<"compute">;
+        readonly seconds: Schema.Number;
+    }>]>>;
+    readonly notices: Schema.optional<Schema.$Array<Schema.Struct<{
+        readonly type: Schema.Literals<readonly ["moderated", "filtered", "other"]>;
+        readonly message: Schema.String;
+        readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+    }>>>;
+    readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+}>]> & {
+    readonly discriminants: readonly ["audio-delta", "timestamps", "finish"];
+    readonly cases: {
+        "audio-delta": Schema.Struct<{
+            readonly type: Schema.tag<"audio-delta">;
+            readonly chunk: Schema.Uint8Array;
+        }>;
+        timestamps: Schema.Struct<{
+            readonly type: Schema.tag<"timestamps">;
+            readonly items: Schema.$Array<Schema.Struct<{
+                readonly text: Schema.String;
+                readonly startSeconds: Schema.Number;
+                readonly endSeconds: Schema.Number;
+            }>>;
+        }>;
+        finish: Schema.Struct<{
+            readonly type: Schema.tag<"finish">;
+            readonly audio: Schema.decodeTo<Schema.declare<Media.Asset, Media.Asset>, Schema.Struct<{
+                readonly source: Schema.Union<readonly [Schema.Struct<{
+                    readonly type: Schema.Literal<"bytes">;
+                    readonly data: Schema.Uint8Array;
+                    readonly mediaType: Schema.String;
+                }>, Schema.Struct<{
+                    readonly type: Schema.Literal<"base64">;
+                    readonly data: Schema.String;
+                    readonly mediaType: Schema.String;
+                }>, Schema.Struct<{
+                    readonly type: Schema.Literal<"url">;
+                    readonly url: Schema.String;
+                    readonly mediaType: Schema.optional<Schema.String>;
+                    readonly expiresAt: Schema.optional<Schema.Number>;
+                }>, Schema.Struct<{
+                    readonly type: Schema.Literal<"ref">;
+                    readonly provider: Schema.brand<Schema.String, "AI.ProviderID">;
+                    readonly id: Schema.String;
+                    readonly mediaType: Schema.optional<Schema.String>;
+                }>]>;
+                readonly info: Schema.optional<Schema.Struct<{
+                    readonly width: Schema.optional<Schema.Number>;
+                    readonly height: Schema.optional<Schema.Number>;
+                    readonly durationSeconds: Schema.optional<Schema.Number>;
+                    readonly sampleRate: Schema.optional<Schema.Number>;
+                    readonly channels: Schema.optional<Schema.Number>;
+                    readonly encoding: Schema.optional<Schema.String>;
+                    readonly format: Schema.optional<Schema.String>;
+                }>>;
+                readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+            }>, never, never>;
+            readonly usage: Schema.optional<Schema.Union<readonly [Schema.Struct<{
+                readonly type: Schema.Literal<"tokens">;
+                readonly input: Schema.optional<Schema.Number>;
+                readonly output: Schema.optional<Schema.Number>;
+                readonly total: Schema.optional<Schema.Number>;
+                readonly details: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+            }>, Schema.Struct<{
+                readonly type: Schema.Literal<"seconds">;
+                readonly seconds: Schema.Number;
+            }>, Schema.Struct<{
+                readonly type: Schema.Literal<"characters">;
+                readonly characters: Schema.Number;
+            }>, Schema.Struct<{
+                readonly type: Schema.Literal<"credits">;
+                readonly credits: Schema.Number;
+            }>, Schema.Struct<{
+                readonly type: Schema.Literal<"compute">;
+                readonly seconds: Schema.Number;
+            }>]>>;
+            readonly notices: Schema.optional<Schema.$Array<Schema.Struct<{
+                readonly type: Schema.Literals<readonly ["moderated", "filtered", "other"]>;
+                readonly message: Schema.String;
+                readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+            }>>>;
+            readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+        }>;
+    };
+    readonly isAnyOf: <const Keys>(keys: readonly Keys[]) => (value: {
+        readonly type: "audio-delta";
+        readonly chunk: Uint8Array<ArrayBufferLike>;
+    } | {
+        readonly type: "timestamps";
+        readonly items: readonly {
+            readonly text: string;
+            readonly startSeconds: number;
+            readonly endSeconds: number;
+        }[];
+    } | {
+        readonly type: "finish";
+        readonly audio: Media.Asset;
+        readonly providerMetadata?: {
+            readonly [x: string]: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined;
+        readonly usage?: {
+            readonly type: "tokens";
+            readonly input?: number | undefined;
+            readonly output?: number | undefined;
+            readonly total?: number | undefined;
+            readonly details?: {
+                readonly [x: string]: unknown;
+            } | undefined;
+        } | {
+            readonly type: "seconds";
+            readonly seconds: number;
+        } | {
+            readonly type: "characters";
+            readonly characters: number;
+        } | {
+            readonly type: "credits";
+            readonly credits: number;
+        } | {
+            readonly type: "compute";
+            readonly seconds: number;
+        } | undefined;
+        readonly notices?: readonly {
+            readonly type: "other" | "moderated" | "filtered";
+            readonly message: string;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+        }[] | undefined;
+    }) => value is Extract<{
+        readonly type: "audio-delta";
+        readonly chunk: Uint8Array<ArrayBufferLike>;
+    }, {
+        readonly type: Keys;
+    }> | Extract<{
+        readonly type: "timestamps";
+        readonly items: readonly {
+            readonly text: string;
+            readonly startSeconds: number;
+            readonly endSeconds: number;
+        }[];
+    }, {
+        readonly type: Keys;
+    }> | Extract<{
+        readonly type: "finish";
+        readonly audio: Media.Asset;
+        readonly providerMetadata?: {
+            readonly [x: string]: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined;
+        readonly usage?: {
+            readonly type: "tokens";
+            readonly input?: number | undefined;
+            readonly output?: number | undefined;
+            readonly total?: number | undefined;
+            readonly details?: {
+                readonly [x: string]: unknown;
+            } | undefined;
+        } | {
+            readonly type: "seconds";
+            readonly seconds: number;
+        } | {
+            readonly type: "characters";
+            readonly characters: number;
+        } | {
+            readonly type: "credits";
+            readonly credits: number;
+        } | {
+            readonly type: "compute";
+            readonly seconds: number;
+        } | undefined;
+        readonly notices?: readonly {
+            readonly type: "other" | "moderated" | "filtered";
+            readonly message: string;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+        }[] | undefined;
+    }, {
+        readonly type: Keys;
+    }>;
+    readonly guards: {
+        "audio-delta": (u: unknown) => u is {
+            readonly type: "audio-delta";
+            readonly chunk: Uint8Array<ArrayBufferLike>;
+        };
+        timestamps: (u: unknown) => u is {
+            readonly type: "timestamps";
+            readonly items: readonly {
+                readonly text: string;
+                readonly startSeconds: number;
+                readonly endSeconds: number;
+            }[];
+        };
+        finish: (u: unknown) => u is {
+            readonly type: "finish";
+            readonly audio: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+            readonly usage?: {
+                readonly type: "tokens";
+                readonly input?: number | undefined;
+                readonly output?: number | undefined;
+                readonly total?: number | undefined;
+                readonly details?: {
+                    readonly [x: string]: unknown;
+                } | undefined;
+            } | {
+                readonly type: "seconds";
+                readonly seconds: number;
+            } | {
+                readonly type: "characters";
+                readonly characters: number;
+            } | {
+                readonly type: "credits";
+                readonly credits: number;
+            } | {
+                readonly type: "compute";
+                readonly seconds: number;
+            } | undefined;
+            readonly notices?: readonly {
+                readonly type: "other" | "moderated" | "filtered";
+                readonly message: string;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }[] | undefined;
+        };
+    };
+    readonly match: {
+        <Cases extends {
+            "audio-delta": (value: {
+                readonly type: "audio-delta";
+                readonly chunk: Uint8Array<ArrayBufferLike>;
+            }) => any;
+            timestamps: (value: {
+                readonly type: "timestamps";
+                readonly items: readonly {
+                    readonly text: string;
+                    readonly startSeconds: number;
+                    readonly endSeconds: number;
+                }[];
+            }) => any;
+            finish: (value: {
+                readonly type: "finish";
+                readonly audio: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+                readonly usage?: {
+                    readonly type: "tokens";
+                    readonly input?: number | undefined;
+                    readonly output?: number | undefined;
+                    readonly total?: number | undefined;
+                    readonly details?: {
+                        readonly [x: string]: unknown;
+                    } | undefined;
+                } | {
+                    readonly type: "seconds";
+                    readonly seconds: number;
+                } | {
+                    readonly type: "characters";
+                    readonly characters: number;
+                } | {
+                    readonly type: "credits";
+                    readonly credits: number;
+                } | {
+                    readonly type: "compute";
+                    readonly seconds: number;
+                } | undefined;
+                readonly notices?: readonly {
+                    readonly type: "other" | "moderated" | "filtered";
+                    readonly message: string;
+                    readonly providerMetadata?: {
+                        readonly [x: string]: {
+                            readonly [x: string]: unknown;
+                        };
+                    } | undefined;
+                }[] | undefined;
+            }) => any;
+        }>(value: {
+            readonly type: "audio-delta";
+            readonly chunk: Uint8Array<ArrayBufferLike>;
+        } | {
+            readonly type: "timestamps";
+            readonly items: readonly {
+                readonly text: string;
+                readonly startSeconds: number;
+                readonly endSeconds: number;
+            }[];
+        } | {
+            readonly type: "finish";
+            readonly audio: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+            readonly usage?: {
+                readonly type: "tokens";
+                readonly input?: number | undefined;
+                readonly output?: number | undefined;
+                readonly total?: number | undefined;
+                readonly details?: {
+                    readonly [x: string]: unknown;
+                } | undefined;
+            } | {
+                readonly type: "seconds";
+                readonly seconds: number;
+            } | {
+                readonly type: "characters";
+                readonly characters: number;
+            } | {
+                readonly type: "credits";
+                readonly credits: number;
+            } | {
+                readonly type: "compute";
+                readonly seconds: number;
+            } | undefined;
+            readonly notices?: readonly {
+                readonly type: "other" | "moderated" | "filtered";
+                readonly message: string;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }[] | undefined;
+        }, cases: Cases): Cases[keyof Cases] extends (value: any) => infer R ? import("effect/Unify").Unify<R> : never;
+        <Cases extends {
+            "audio-delta": (value: {
+                readonly type: "audio-delta";
+                readonly chunk: Uint8Array<ArrayBufferLike>;
+            }) => any;
+            timestamps: (value: {
+                readonly type: "timestamps";
+                readonly items: readonly {
+                    readonly text: string;
+                    readonly startSeconds: number;
+                    readonly endSeconds: number;
+                }[];
+            }) => any;
+            finish: (value: {
+                readonly type: "finish";
+                readonly audio: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+                readonly usage?: {
+                    readonly type: "tokens";
+                    readonly input?: number | undefined;
+                    readonly output?: number | undefined;
+                    readonly total?: number | undefined;
+                    readonly details?: {
+                        readonly [x: string]: unknown;
+                    } | undefined;
+                } | {
+                    readonly type: "seconds";
+                    readonly seconds: number;
+                } | {
+                    readonly type: "characters";
+                    readonly characters: number;
+                } | {
+                    readonly type: "credits";
+                    readonly credits: number;
+                } | {
+                    readonly type: "compute";
+                    readonly seconds: number;
+                } | undefined;
+                readonly notices?: readonly {
+                    readonly type: "other" | "moderated" | "filtered";
+                    readonly message: string;
+                    readonly providerMetadata?: {
+                        readonly [x: string]: {
+                            readonly [x: string]: unknown;
+                        };
+                    } | undefined;
+                }[] | undefined;
+            }) => any;
+        }>(cases: Cases): (value: {
+            readonly type: "audio-delta";
+            readonly chunk: Uint8Array<ArrayBufferLike>;
+        } | {
+            readonly type: "timestamps";
+            readonly items: readonly {
+                readonly text: string;
+                readonly startSeconds: number;
+                readonly endSeconds: number;
+            }[];
+        } | {
+            readonly type: "finish";
+            readonly audio: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+            readonly usage?: {
+                readonly type: "tokens";
+                readonly input?: number | undefined;
+                readonly output?: number | undefined;
+                readonly total?: number | undefined;
+                readonly details?: {
+                    readonly [x: string]: unknown;
+                } | undefined;
+            } | {
+                readonly type: "seconds";
+                readonly seconds: number;
+            } | {
+                readonly type: "characters";
+                readonly characters: number;
+            } | {
+                readonly type: "credits";
+                readonly credits: number;
+            } | {
+                readonly type: "compute";
+                readonly seconds: number;
+            } | undefined;
+            readonly notices?: readonly {
+                readonly type: "other" | "moderated" | "filtered";
+                readonly message: string;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }[] | undefined;
+        }) => Cases[keyof Cases] extends (value: any) => infer R ? import("effect/Unify").Unify<R> : never;
+    };
+    readonly matchOrElse: {
+        <Cases extends {
+            "audio-delta"?: ((value: {
+                readonly type: "audio-delta";
+                readonly chunk: Uint8Array<ArrayBufferLike>;
+            }) => any) | undefined;
+            timestamps?: ((value: {
+                readonly type: "timestamps";
+                readonly items: readonly {
+                    readonly text: string;
+                    readonly startSeconds: number;
+                    readonly endSeconds: number;
+                }[];
+            }) => any) | undefined;
+            finish?: ((value: {
+                readonly type: "finish";
+                readonly audio: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+                readonly usage?: {
+                    readonly type: "tokens";
+                    readonly input?: number | undefined;
+                    readonly output?: number | undefined;
+                    readonly total?: number | undefined;
+                    readonly details?: {
+                        readonly [x: string]: unknown;
+                    } | undefined;
+                } | {
+                    readonly type: "seconds";
+                    readonly seconds: number;
+                } | {
+                    readonly type: "characters";
+                    readonly characters: number;
+                } | {
+                    readonly type: "credits";
+                    readonly credits: number;
+                } | {
+                    readonly type: "compute";
+                    readonly seconds: number;
+                } | undefined;
+                readonly notices?: readonly {
+                    readonly type: "other" | "moderated" | "filtered";
+                    readonly message: string;
+                    readonly providerMetadata?: {
+                        readonly [x: string]: {
+                            readonly [x: string]: unknown;
+                        };
+                    } | undefined;
+                }[] | undefined;
+            }) => any) | undefined;
+        } & { [K in Exclude<keyof Cases, "finish" | "timestamps" | "audio-delta">]: never; }, OrElse extends (value: Exclude<{
+            readonly type: "audio-delta";
+            readonly chunk: Uint8Array<ArrayBufferLike>;
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly type: "timestamps";
+            readonly items: readonly {
+                readonly text: string;
+                readonly startSeconds: number;
+                readonly endSeconds: number;
+            }[];
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly type: "finish";
+            readonly audio: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+            readonly usage?: {
+                readonly type: "tokens";
+                readonly input?: number | undefined;
+                readonly output?: number | undefined;
+                readonly total?: number | undefined;
+                readonly details?: {
+                    readonly [x: string]: unknown;
+                } | undefined;
+            } | {
+                readonly type: "seconds";
+                readonly seconds: number;
+            } | {
+                readonly type: "characters";
+                readonly characters: number;
+            } | {
+                readonly type: "credits";
+                readonly credits: number;
+            } | {
+                readonly type: "compute";
+                readonly seconds: number;
+            } | undefined;
+            readonly notices?: readonly {
+                readonly type: "other" | "moderated" | "filtered";
+                readonly message: string;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }[] | undefined;
+        }, {
+            readonly type: keyof Cases;
+        }>) => any>(value: {
+            readonly type: "audio-delta";
+            readonly chunk: Uint8Array<ArrayBufferLike>;
+        } | {
+            readonly type: "timestamps";
+            readonly items: readonly {
+                readonly text: string;
+                readonly startSeconds: number;
+                readonly endSeconds: number;
+            }[];
+        } | {
+            readonly type: "finish";
+            readonly audio: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+            readonly usage?: {
+                readonly type: "tokens";
+                readonly input?: number | undefined;
+                readonly output?: number | undefined;
+                readonly total?: number | undefined;
+                readonly details?: {
+                    readonly [x: string]: unknown;
+                } | undefined;
+            } | {
+                readonly type: "seconds";
+                readonly seconds: number;
+            } | {
+                readonly type: "characters";
+                readonly characters: number;
+            } | {
+                readonly type: "credits";
+                readonly credits: number;
+            } | {
+                readonly type: "compute";
+                readonly seconds: number;
+            } | undefined;
+            readonly notices?: readonly {
+                readonly type: "other" | "moderated" | "filtered";
+                readonly message: string;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }[] | undefined;
+        }, cases: Cases, orElse: OrElse): import("effect/Unify").Unify<{ [K_1 in keyof Cases]-?: NonNullable<Cases[K_1]> extends (...args: Array<any>) => infer R ? R : never; }[keyof Cases] | ReturnType<OrElse>>;
+        <Cases extends {
+            "audio-delta"?: ((value: {
+                readonly type: "audio-delta";
+                readonly chunk: Uint8Array<ArrayBufferLike>;
+            }) => any) | undefined;
+            timestamps?: ((value: {
+                readonly type: "timestamps";
+                readonly items: readonly {
+                    readonly text: string;
+                    readonly startSeconds: number;
+                    readonly endSeconds: number;
+                }[];
+            }) => any) | undefined;
+            finish?: ((value: {
+                readonly type: "finish";
+                readonly audio: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+                readonly usage?: {
+                    readonly type: "tokens";
+                    readonly input?: number | undefined;
+                    readonly output?: number | undefined;
+                    readonly total?: number | undefined;
+                    readonly details?: {
+                        readonly [x: string]: unknown;
+                    } | undefined;
+                } | {
+                    readonly type: "seconds";
+                    readonly seconds: number;
+                } | {
+                    readonly type: "characters";
+                    readonly characters: number;
+                } | {
+                    readonly type: "credits";
+                    readonly credits: number;
+                } | {
+                    readonly type: "compute";
+                    readonly seconds: number;
+                } | undefined;
+                readonly notices?: readonly {
+                    readonly type: "other" | "moderated" | "filtered";
+                    readonly message: string;
+                    readonly providerMetadata?: {
+                        readonly [x: string]: {
+                            readonly [x: string]: unknown;
+                        };
+                    } | undefined;
+                }[] | undefined;
+            }) => any) | undefined;
+        } & { [K in Exclude<keyof Cases, "finish" | "timestamps" | "audio-delta">]: never; }, OrElse extends (value: Exclude<{
+            readonly type: "audio-delta";
+            readonly chunk: Uint8Array<ArrayBufferLike>;
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly type: "timestamps";
+            readonly items: readonly {
+                readonly text: string;
+                readonly startSeconds: number;
+                readonly endSeconds: number;
+            }[];
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly type: "finish";
+            readonly audio: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+            readonly usage?: {
+                readonly type: "tokens";
+                readonly input?: number | undefined;
+                readonly output?: number | undefined;
+                readonly total?: number | undefined;
+                readonly details?: {
+                    readonly [x: string]: unknown;
+                } | undefined;
+            } | {
+                readonly type: "seconds";
+                readonly seconds: number;
+            } | {
+                readonly type: "characters";
+                readonly characters: number;
+            } | {
+                readonly type: "credits";
+                readonly credits: number;
+            } | {
+                readonly type: "compute";
+                readonly seconds: number;
+            } | undefined;
+            readonly notices?: readonly {
+                readonly type: "other" | "moderated" | "filtered";
+                readonly message: string;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }[] | undefined;
+        }, {
+            readonly type: keyof Cases;
+        }>) => any>(cases: Cases, orElse: OrElse): (value: {
+            readonly type: "audio-delta";
+            readonly chunk: Uint8Array<ArrayBufferLike>;
+        } | {
+            readonly type: "timestamps";
+            readonly items: readonly {
+                readonly text: string;
+                readonly startSeconds: number;
+                readonly endSeconds: number;
+            }[];
+        } | {
+            readonly type: "finish";
+            readonly audio: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+            readonly usage?: {
+                readonly type: "tokens";
+                readonly input?: number | undefined;
+                readonly output?: number | undefined;
+                readonly total?: number | undefined;
+                readonly details?: {
+                    readonly [x: string]: unknown;
+                } | undefined;
+            } | {
+                readonly type: "seconds";
+                readonly seconds: number;
+            } | {
+                readonly type: "characters";
+                readonly characters: number;
+            } | {
+                readonly type: "credits";
+                readonly credits: number;
+            } | {
+                readonly type: "compute";
+                readonly seconds: number;
+            } | undefined;
+            readonly notices?: readonly {
+                readonly type: "other" | "moderated" | "filtered";
+                readonly message: string;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }[] | undefined;
+        }) => import("effect/Unify").Unify<{ [K_1 in keyof Cases]-?: NonNullable<Cases[K_1]> extends (...args: Array<any>) => infer R ? R : never; }[keyof Cases] | ReturnType<OrElse>>;
+    };
+} & {
+    is: {
+        audioDelta: (u: unknown) => u is {
+            readonly type: "audio-delta";
+            readonly chunk: Uint8Array<ArrayBufferLike>;
+        };
+        timestamps: (u: unknown) => u is {
+            readonly type: "timestamps";
+            readonly items: readonly {
+                readonly text: string;
+                readonly startSeconds: number;
+                readonly endSeconds: number;
+            }[];
+        };
+        finish: (u: unknown) => u is {
+            readonly type: "finish";
+            readonly audio: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+            readonly usage?: {
+                readonly type: "tokens";
+                readonly input?: number | undefined;
+                readonly output?: number | undefined;
+                readonly total?: number | undefined;
+                readonly details?: {
+                    readonly [x: string]: unknown;
+                } | undefined;
+            } | {
+                readonly type: "seconds";
+                readonly seconds: number;
+            } | {
+                readonly type: "characters";
+                readonly characters: number;
+            } | {
+                readonly type: "credits";
+                readonly credits: number;
+            } | {
+                readonly type: "compute";
+                readonly seconds: number;
+            } | undefined;
+            readonly notices?: readonly {
+                readonly type: "other" | "moderated" | "filtered";
+                readonly message: string;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }[] | undefined;
+        };
+    };
+};
+export type SpeechEvent = Schema.Schema.Type<typeof speechEventTagged>;
+export declare function request<const Model extends SpeechModel>(input: SpeechRequestInput<Model>): SpeechRequestFor<SpeechModelOptions<Model>>;
+export declare function request(input: SpeechRequest): SpeechRequest;
+export declare function generate<const Model extends SpeechModel>(input: SpeechRequestInput<Model>): Effect.Effect<SpeechResponse, AIError, Service>;
+export declare function generate(input: SpeechRequest): Effect.Effect<SpeechResponse, AIError, Service>;
+export declare function stream<const Model extends SpeechModel>(input: SpeechRequestInput<Model>): Stream.Stream<SpeechEvent, AIError, Service>;
+export declare function stream(input: SpeechRequest): Stream.Stream<SpeechEvent, AIError, Service>;
+export declare const Speech: {
+    readonly request: typeof request;
+    readonly generate: typeof generate;
+    readonly stream: typeof stream;
+};
+export {};