@opencode/ai 2.0.14 → 2.0.15

package/dist/image.d.ts

@@ -1,11 +1,12 @@
-import { Effect, Schema } from "effect";
-import { HttpOptions, AIError, ModelID, ProviderID, Usage } from "./schema/index.js";
-import { Service, type Execute as ImageExecute } from "./image-client.js";
-export interface ImageRoute<Options extends ImageOptions = ImageOptions> {
-    readonly id: string;
-    readonly generate: (request: ImageRequestFor<Options>, execute: ImageExecute) => Effect.Effect<ImageResponse, AIError>;
-}
+import { Effect, Schema, Stream } from "effect";
+import { Media } from "./media.js";
+import { Endpoint } from "./route/endpoint.js";
+import { MediaRoute } from "./route/media.js";
+import type { MediaProtocol } from "./route/media-protocol.js";
+import { AIError, HttpOptions, ModelID, ProviderID } from "./schema/index.js";
+import { Service } from "./image-client.js";
 export type ImageOptions = Record<string, unknown>;
+export type ImageRoute<Options extends ImageOptions = ImageOptions> = MediaRoute.Route<ImageRequestFor<Options>, ImageResponse>;
 export declare class ImageModel<Options extends ImageOptions = ImageOptions> {
     protected readonly _Options: (options: Options) => Options;
     readonly id: ModelID;
@@ -14,6 +15,8 @@ export declare class ImageModel<Options extends ImageOptions = ImageOptions> {
     readonly http?: HttpOptions;
     constructor(input: ImageModel.Input<Options>);
     static make<Options extends ImageOptions = ImageOptions>(input: ImageModel.MakeInput<Options>): ImageModel<Options>;
+    /** Compose an inline image protocol with its canonical path into a model for one deployment. */
+    static fromRoute<Options extends ImageOptions = ImageOptions>(route: ImageModel.RouteInput<Options>, input: MediaRoute.ModelInput): ImageModel<Options>;
 }
 export declare namespace ImageModel {
     interface Input<Options extends ImageOptions = ImageOptions> {
@@ -26,85 +29,1060 @@ export declare namespace ImageModel {
         readonly id: string | ModelID;
         readonly provider: string | ProviderID;
     }
+    interface RouteInput<Options extends ImageOptions = ImageOptions> {
+        readonly id: string;
+        readonly provider: string | ProviderID;
+        readonly protocol: MediaProtocol.Inline<ImageRequestFor<Options>, ImageResponse>;
+        readonly path: Endpoint.EndpointPart<MediaProtocol.Body, ImageRequestFor<Options>>;
+        /** Canonical base URL; `ModelInput.baseURL` overrides it per deployment. */
+        readonly baseURL?: string;
+    }
 }
 export declare const ImageModelSchema: Schema.declare<ImageModel<ImageOptions>, ImageModel<ImageOptions>>;
-export declare const ImageInputSchema: Schema.toTaggedUnion<"type", readonly [Schema.Struct<{
-    readonly type: Schema.Literal<"bytes">;
-    readonly data: Schema.Uint8Array;
-    readonly mediaType: Schema.String;
-}>, Schema.Struct<{
-    readonly type: Schema.Literal<"url">;
-    readonly url: Schema.String;
-}>, Schema.Struct<{
-    readonly type: Schema.Literal<"file-id">;
-    readonly id: Schema.String;
-}>, Schema.Struct<{
-    readonly type: Schema.Literal<"file-uri">;
-    readonly uri: Schema.String;
-    readonly mediaType: Schema.String;
-}>]>;
-export type ImageInput = Schema.Schema.Type<typeof ImageInputSchema>;
-export declare const ImageInput: {
-    readonly bytes: (data: Uint8Array, mediaType: string) => ImageInput;
-    readonly url: (url: string) => ImageInput;
-    readonly file: (id: string) => ImageInput;
-    readonly fileUri: (uri: string, mediaType: string) => ImageInput;
-};
+export type ImageSize = `${number}x${number}`;
+export declare const ImageSize: Schema.declare<`${number}x${number}`, `${number}x${number}`>;
+export type ImageAspectRatio = `${number}:${number}`;
+export declare const ImageAspectRatio: Schema.declare<`${number}:${number}`, `${number}:${number}`>;
+export type ImageFormat = "png" | "jpeg" | "webp" | (string & {});
 declare const ImageRequest_base: Schema.Class<ImageRequest, Schema.Struct<{
     readonly model: Schema.declare<ImageModel<ImageOptions>, ImageModel<ImageOptions>>;
     readonly prompt: Schema.String;
-    readonly images: Schema.optional<Schema.$Array<Schema.toTaggedUnion<"type", readonly [Schema.Struct<{
-        readonly type: Schema.Literal<"bytes">;
-        readonly data: Schema.Uint8Array;
-        readonly mediaType: Schema.String;
-    }>, Schema.Struct<{
-        readonly type: Schema.Literal<"url">;
-        readonly url: Schema.String;
-    }>, Schema.Struct<{
-        readonly type: Schema.Literal<"file-id">;
-        readonly id: Schema.String;
-    }>, Schema.Struct<{
-        readonly type: Schema.Literal<"file-uri">;
-        readonly uri: Schema.String;
-        readonly mediaType: Schema.String;
-    }>]>>>;
-    readonly options: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
+    /** Edit sources or style/subject references, in order. */
+    readonly images: Schema.optional<Schema.$Array<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>;
+            readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+        }>, 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>>>;
+    /** Inpainting mask; routes that cannot honor it fail with `UnsupportedOperation`. */
+    readonly mask: Schema.optional<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>;
+            readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+        }>, 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 n: Schema.optional<Schema.Int>;
+    readonly size: Schema.optional<Schema.declare<`${number}x${number}`, `${number}x${number}`>>;
+    readonly aspectRatio: Schema.optional<Schema.declare<`${number}:${number}`, `${number}:${number}`>>;
+    readonly seed: Schema.optional<Schema.Number>;
+    readonly format: Schema.optional<Schema.String>;
+    readonly providerOptions: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
     readonly http: Schema.optional<typeof HttpOptions>;
 }>, {}>;
 export declare class ImageRequest extends ImageRequest_base {
     protected readonly _ImageRequest: void;
 }
-export type ImageRequestFor<Options extends ImageOptions = ImageOptions> = Omit<ImageRequest, "model" | "options"> & {
+export type ImageRequestFor<Options extends ImageOptions = ImageOptions> = Omit<ImageRequest, "model" | "providerOptions"> & {
     readonly model: ImageModel<Options>;
-    readonly options?: Options;
+    readonly providerOptions?: Options;
 };
 export type ImageModelOptions<Model> = Model extends ImageModel<infer Options> ? Options : never;
-export type ImageRequestInput<Model extends object = ImageModel> = Omit<ConstructorParameters<typeof ImageRequest>[0], "model" | "options" | "http"> & {
+export type ImageRequestInput<Model extends ImageModel = ImageModel> = Omit<ConstructorParameters<typeof ImageRequest>[0], "model" | "providerOptions" | "http"> & {
     readonly model: Model;
-    readonly options?: NoInfer<ImageModelOptions<Model>>;
+    readonly format?: ImageFormat;
+    readonly providerOptions?: NoInfer<ImageModelOptions<Model>>;
     readonly http?: HttpOptions.Input;
-} & (Model extends ImageModel<ImageModelOptions<Model>> ? unknown : never);
-declare const GeneratedImage_base: Schema.Class<GeneratedImage, Schema.Struct<{
-    readonly mediaType: Schema.String;
-    readonly data: Schema.Union<readonly [Schema.String, Schema.Uint8Array]>;
-    readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
-}>, {}>;
-export declare class GeneratedImage extends GeneratedImage_base {
-}
+};
 declare const ImageResponse_base: Schema.Class<ImageResponse, Schema.Struct<{
-    readonly images: Schema.$Array<typeof GeneratedImage>;
-    readonly usage: Schema.optional<typeof Usage>;
+    readonly images: Schema.$Array<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>;
+            readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+        }>, 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 class ImageResponse extends ImageResponse_base {
-    get image(): GeneratedImage;
+    get image(): Media.Asset;
 }
-export declare function request<const Model extends object>(input: ImageRequestInput<Model>): ImageRequestFor<ImageModelOptions<Model>>;
+export declare const ImageOutputEvent: Schema.Struct<{
+    readonly type: Schema.tag<"image">;
+    readonly index: Schema.Number;
+    readonly image: 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>;
+            readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+        }>, 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>;
+}>;
+export declare const ImageFinishEvent: Schema.Struct<{
+    readonly type: Schema.tag<"finish">;
+    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 imageEventTagged: Schema.toTaggedUnion<"type", readonly [Schema.Struct<{
+    readonly type: Schema.tag<"image">;
+    readonly index: Schema.Number;
+    readonly image: 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>;
+            readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+        }>, 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>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"finish">;
+    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 ImageEvent: Schema.Union<readonly [Schema.Struct<{
+    readonly type: Schema.tag<"image">;
+    readonly index: Schema.Number;
+    readonly image: 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>;
+            readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+        }>, 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>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"finish">;
+    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 ["image", "finish"];
+    readonly cases: {
+        image: Schema.Struct<{
+            readonly type: Schema.tag<"image">;
+            readonly index: Schema.Number;
+            readonly image: 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>;
+                    readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+                }>, 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>;
+        }>;
+        finish: Schema.Struct<{
+            readonly type: Schema.tag<"finish">;
+            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: "image";
+        readonly index: number;
+        readonly image: Media.Asset;
+    } | {
+        readonly type: "finish";
+        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: "image";
+        readonly index: number;
+        readonly image: Media.Asset;
+    }, {
+        readonly type: Keys;
+    }> | Extract<{
+        readonly type: "finish";
+        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: {
+        image: (u: unknown) => u is {
+            readonly type: "image";
+            readonly index: number;
+            readonly image: Media.Asset;
+        };
+        finish: (u: unknown) => u is {
+            readonly type: "finish";
+            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 {
+            image: (value: {
+                readonly type: "image";
+                readonly index: number;
+                readonly image: Media.Asset;
+            }) => any;
+            finish: (value: {
+                readonly type: "finish";
+                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: "image";
+            readonly index: number;
+            readonly image: Media.Asset;
+        } | {
+            readonly type: "finish";
+            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 {
+            image: (value: {
+                readonly type: "image";
+                readonly index: number;
+                readonly image: Media.Asset;
+            }) => any;
+            finish: (value: {
+                readonly type: "finish";
+                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: "image";
+            readonly index: number;
+            readonly image: Media.Asset;
+        } | {
+            readonly type: "finish";
+            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 {
+            image?: ((value: {
+                readonly type: "image";
+                readonly index: number;
+                readonly image: Media.Asset;
+            }) => any) | undefined;
+            finish?: ((value: {
+                readonly type: "finish";
+                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, "image" | "finish">]: never; }, OrElse extends (value: Exclude<{
+            readonly type: "image";
+            readonly index: number;
+            readonly image: Media.Asset;
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly type: "finish";
+            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: "image";
+            readonly index: number;
+            readonly image: Media.Asset;
+        } | {
+            readonly type: "finish";
+            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 {
+            image?: ((value: {
+                readonly type: "image";
+                readonly index: number;
+                readonly image: Media.Asset;
+            }) => any) | undefined;
+            finish?: ((value: {
+                readonly type: "finish";
+                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, "image" | "finish">]: never; }, OrElse extends (value: Exclude<{
+            readonly type: "image";
+            readonly index: number;
+            readonly image: Media.Asset;
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly type: "finish";
+            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: "image";
+            readonly index: number;
+            readonly image: Media.Asset;
+        } | {
+            readonly type: "finish";
+            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: {
+        image: (u: unknown) => u is {
+            readonly type: "image";
+            readonly index: number;
+            readonly image: Media.Asset;
+        };
+        finish: (u: unknown) => u is {
+            readonly type: "finish";
+            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 ImageEvent = Schema.Schema.Type<typeof imageEventTagged>;
+/** Inline routes produce every image at once; expand the response into the streaming event shape. */
+export declare const responseEvents: (response: ImageResponse) => ReadonlyArray<ImageEvent>;
+export declare function request<const Model extends ImageModel>(input: ImageRequestInput<Model>): ImageRequestFor<ImageModelOptions<Model>>;
 export declare function request(input: ImageRequest): ImageRequest;
-export declare function generate<const Model extends object>(input: ImageRequestInput<Model>): Effect.Effect<ImageResponse, AIError, Service>;
+export declare function generate<const Model extends ImageModel>(input: ImageRequestInput<Model>): Effect.Effect<ImageResponse, AIError, Service>;
 export declare function generate(input: ImageRequest): Effect.Effect<ImageResponse, AIError, Service>;
+export declare function stream<const Model extends ImageModel>(input: ImageRequestInput<Model>): Stream.Stream<ImageEvent, AIError, Service>;
+export declare function stream(input: ImageRequest): Stream.Stream<ImageEvent, AIError, Service>;
 export declare const Image: {
     readonly request: typeof request;
     readonly generate: typeof generate;
+    readonly stream: typeof stream;
 };
 export {};