@opencode/ai 2.0.15 → 2.0.16

package/dist/image.d.ts

@@ -1,47 +1,31 @@
 import { Effect, Schema, Stream } from "effect";
+import { Generation, type AwaitOptions } from "./generation.js";
 import { Media } from "./media.js";
-import { Endpoint } from "./route/endpoint.js";
+import { MediaModel } from "./media-model.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 { AIError, HttpOptions } 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;
-    readonly provider: ProviderID;
-    readonly route: ImageRoute<Options>;
-    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 type ImageRoute<Options extends ImageOptions = ImageOptions> = MediaRoute.AnyRoute<ImageRequestFor<Options>, ImageEvent, ImageResponse>;
+export declare class ImageModel<Options extends ImageOptions = ImageOptions> extends MediaModel<ImageRoute<Options>, Options> {
+    protected readonly _ImageModel: void;
+    static make<Options extends ImageOptions = ImageOptions>(input: MediaModel.Input<ImageRoute<Options>>): ImageModel<Options>;
+    /** The number of type arguments selects the kind: `<Options>`, `<Options, Frame, State>`, or `<Options, Token>`. */
+    static fromRoute<Options extends ImageOptions>(route: ImageModel.InlineRouteInput<Options>, input: MediaRoute.ModelInput): ImageModel<Options>;
+    static fromRoute<Options extends ImageOptions, Frame, State>(route: ImageModel.StreamRouteInput<Options, Frame, State>, input: MediaRoute.ModelInput): ImageModel<Options>;
+    static fromRoute<Options extends ImageOptions, Token>(route: ImageModel.QueuedRouteInput<Options, Token>, input: MediaRoute.ModelInput): ImageModel<Options>;
 }
 export declare namespace ImageModel {
-    interface Input<Options extends ImageOptions = ImageOptions> {
-        readonly id: ModelID;
-        readonly provider: ProviderID;
-        readonly route: ImageRoute<Options>;
-        readonly http?: HttpOptions;
-    }
-    interface MakeInput<Options extends ImageOptions = ImageOptions> extends Omit<Input<Options>, "id" | "provider"> {
-        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;
-    }
+    type InlineRouteInput<Options extends ImageOptions = ImageOptions> = MediaModel.RouteInput<ImageRequestFor<Options>, MediaProtocol.Inline<ImageRequestFor<Options>, ImageResponse>>;
+    type StreamRouteInput<Options extends ImageOptions = ImageOptions, Frame = unknown, State = unknown> = MediaModel.RouteInput<MediaProtocol.Addressed<ImageRequestFor<Options>>, MediaProtocol.Streamed<ImageRequestFor<Options>, ImageEvent, Frame, State>>;
+    type QueuedRouteInput<Options extends ImageOptions = ImageOptions, Token = unknown> = MediaModel.RouteInput<ImageRequestFor<Options>, MediaProtocol.Queued<ImageRequestFor<Options>, ImageResponse, Token>>;
+    type RouteInput<Options extends ImageOptions = ImageOptions, Frame = unknown, State = unknown, Token = unknown> = MediaModel.AnyRouteInput<ImageRequestFor<Options>, ImageEvent, ImageResponse, Frame, State, Token>;
 }
 export declare const ImageModelSchema: Schema.declare<ImageModel<ImageOptions>, ImageModel<ImageOptions>>;
 export type ImageSize = `${number}x${number}`;
 export declare const ImageSize: Schema.declare<`${number}x${number}`, `${number}x${number}`>;
-export type ImageAspectRatio = `${number}:${number}`;
+export type ImageAspectRatio = Media.AspectRatio;
 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<{
@@ -62,7 +46,6 @@ declare const ImageRequest_base: Schema.Class<ImageRequest, Schema.Struct<{
             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">;
@@ -95,7 +78,6 @@ declare const ImageRequest_base: Schema.Class<ImageRequest, Schema.Struct<{
             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">;
@@ -150,7 +132,6 @@ declare const ImageResponse_base: Schema.Class<ImageResponse, Schema.Struct<{
             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">;
@@ -197,6 +178,42 @@ declare const ImageResponse_base: Schema.Class<ImageResponse, Schema.Struct<{
 export declare class ImageResponse extends ImageResponse_base {
     get image(): Media.Asset;
 }
+/** The `index`-th lower-fidelity preview of an image still generating; the `image` event supersedes it. */
+export declare const ImagePartialEvent: Schema.Struct<{
+    readonly type: Schema.tag<"image-partial">;
+    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>;
+        }>, 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 ImageOutputEvent: Schema.Struct<{
     readonly type: Schema.tag<"image">;
     readonly index: Schema.Number;
@@ -214,7 +231,6 @@ export declare const ImageOutputEvent: Schema.Struct<{
             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">;
@@ -262,6 +278,48 @@ export declare const ImageFinishEvent: Schema.Struct<{
     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<"generation-queued">;
+    readonly id: Schema.String;
+    readonly position: Schema.optional<Schema.Number>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"generation-progress">;
+    readonly id: Schema.String;
+    readonly progress: Schema.optional<Schema.Number>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"image-partial">;
+    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>;
+        }>, 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<"image">;
     readonly index: Schema.Number;
     readonly image: Schema.decodeTo<Schema.declare<Media.Asset, Media.Asset>, Schema.Struct<{
@@ -278,7 +336,6 @@ declare const imageEventTagged: Schema.toTaggedUnion<"type", readonly [Schema.St
             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">;
@@ -325,6 +382,48 @@ declare const imageEventTagged: Schema.toTaggedUnion<"type", readonly [Schema.St
     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<"generation-queued">;
+    readonly id: Schema.String;
+    readonly position: Schema.optional<Schema.Number>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"generation-progress">;
+    readonly id: Schema.String;
+    readonly progress: Schema.optional<Schema.Number>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"image-partial">;
+    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>;
+        }>, 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<"image">;
     readonly index: Schema.Number;
     readonly image: Schema.decodeTo<Schema.declare<Media.Asset, Media.Asset>, Schema.Struct<{
@@ -341,7 +440,6 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
             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">;
@@ -387,8 +485,53 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
     }>>>;
     readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
 }>]> & {
-    readonly discriminants: readonly ["image", "finish"];
+    readonly discriminants: readonly ["generation-queued", "generation-progress", "image-partial", "image", "finish"];
     readonly cases: {
+        "generation-queued": Schema.Struct<{
+            readonly type: Schema.tag<"generation-queued">;
+            readonly id: Schema.String;
+            readonly position: Schema.optional<Schema.Number>;
+        }>;
+        "generation-progress": Schema.Struct<{
+            readonly type: Schema.tag<"generation-progress">;
+            readonly id: Schema.String;
+            readonly progress: Schema.optional<Schema.Number>;
+        }>;
+        "image-partial": Schema.Struct<{
+            readonly type: Schema.tag<"image-partial">;
+            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>;
+                }>, 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>;
+        }>;
         image: Schema.Struct<{
             readonly type: Schema.tag<"image">;
             readonly index: Schema.Number;
@@ -406,7 +549,6 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
                     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">;
@@ -455,6 +597,18 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
         }>;
     };
     readonly isAnyOf: <const Keys>(keys: readonly Keys[]) => (value: {
+        readonly id: string;
+        readonly type: "generation-queued";
+        readonly position?: number | undefined;
+    } | {
+        readonly id: string;
+        readonly type: "generation-progress";
+        readonly progress?: number | undefined;
+    } | {
+        readonly type: "image-partial";
+        readonly index: number;
+        readonly image: Media.Asset;
+    } | {
         readonly type: "image";
         readonly index: number;
         readonly image: Media.Asset;
@@ -496,6 +650,24 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
             } | undefined;
         }[] | undefined;
     }) => value is Extract<{
+        readonly id: string;
+        readonly type: "generation-queued";
+        readonly position?: number | undefined;
+    }, {
+        readonly type: Keys;
+    }> | Extract<{
+        readonly id: string;
+        readonly type: "generation-progress";
+        readonly progress?: number | undefined;
+    }, {
+        readonly type: Keys;
+    }> | Extract<{
+        readonly type: "image-partial";
+        readonly index: number;
+        readonly image: Media.Asset;
+    }, {
+        readonly type: Keys;
+    }> | Extract<{
         readonly type: "image";
         readonly index: number;
         readonly image: Media.Asset;
@@ -542,6 +714,21 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
         readonly type: Keys;
     }>;
     readonly guards: {
+        "generation-queued": (u: unknown) => u is {
+            readonly id: string;
+            readonly type: "generation-queued";
+            readonly position?: number | undefined;
+        };
+        "generation-progress": (u: unknown) => u is {
+            readonly id: string;
+            readonly type: "generation-progress";
+            readonly progress?: number | undefined;
+        };
+        "image-partial": (u: unknown) => u is {
+            readonly type: "image-partial";
+            readonly index: number;
+            readonly image: Media.Asset;
+        };
         image: (u: unknown) => u is {
             readonly type: "image";
             readonly index: number;
@@ -588,6 +775,21 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
     };
     readonly match: {
         <Cases extends {
+            "generation-queued": (value: {
+                readonly id: string;
+                readonly type: "generation-queued";
+                readonly position?: number | undefined;
+            }) => any;
+            "generation-progress": (value: {
+                readonly id: string;
+                readonly type: "generation-progress";
+                readonly progress?: number | undefined;
+            }) => any;
+            "image-partial": (value: {
+                readonly type: "image-partial";
+                readonly index: number;
+                readonly image: Media.Asset;
+            }) => any;
             image: (value: {
                 readonly type: "image";
                 readonly index: number;
@@ -632,6 +834,18 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
                 }[] | undefined;
             }) => any;
         }>(value: {
+            readonly id: string;
+            readonly type: "generation-queued";
+            readonly position?: number | undefined;
+        } | {
+            readonly id: string;
+            readonly type: "generation-progress";
+            readonly progress?: number | undefined;
+        } | {
+            readonly type: "image-partial";
+            readonly index: number;
+            readonly image: Media.Asset;
+        } | {
             readonly type: "image";
             readonly index: number;
             readonly image: Media.Asset;
@@ -674,6 +888,21 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
             }[] | undefined;
         }, cases: Cases): Cases[keyof Cases] extends (value: any) => infer R ? import("effect/Unify").Unify<R> : never;
         <Cases extends {
+            "generation-queued": (value: {
+                readonly id: string;
+                readonly type: "generation-queued";
+                readonly position?: number | undefined;
+            }) => any;
+            "generation-progress": (value: {
+                readonly id: string;
+                readonly type: "generation-progress";
+                readonly progress?: number | undefined;
+            }) => any;
+            "image-partial": (value: {
+                readonly type: "image-partial";
+                readonly index: number;
+                readonly image: Media.Asset;
+            }) => any;
             image: (value: {
                 readonly type: "image";
                 readonly index: number;
@@ -718,6 +947,18 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
                 }[] | undefined;
             }) => any;
         }>(cases: Cases): (value: {
+            readonly id: string;
+            readonly type: "generation-queued";
+            readonly position?: number | undefined;
+        } | {
+            readonly id: string;
+            readonly type: "generation-progress";
+            readonly progress?: number | undefined;
+        } | {
+            readonly type: "image-partial";
+            readonly index: number;
+            readonly image: Media.Asset;
+        } | {
             readonly type: "image";
             readonly index: number;
             readonly image: Media.Asset;
@@ -762,6 +1003,21 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
     };
     readonly matchOrElse: {
         <Cases extends {
+            "generation-queued"?: ((value: {
+                readonly id: string;
+                readonly type: "generation-queued";
+                readonly position?: number | undefined;
+            }) => any) | undefined;
+            "generation-progress"?: ((value: {
+                readonly id: string;
+                readonly type: "generation-progress";
+                readonly progress?: number | undefined;
+            }) => any) | undefined;
+            "image-partial"?: ((value: {
+                readonly type: "image-partial";
+                readonly index: number;
+                readonly image: Media.Asset;
+            }) => any) | undefined;
             image?: ((value: {
                 readonly type: "image";
                 readonly index: number;
@@ -805,7 +1061,25 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
                     } | undefined;
                 }[] | undefined;
             }) => any) | undefined;
-        } & { [K in Exclude<keyof Cases, "image" | "finish">]: never; }, OrElse extends (value: Exclude<{
+        } & { [K in Exclude<keyof Cases, "image" | "finish" | "generation-queued" | "generation-progress" | "image-partial">]: never; }, OrElse extends (value: Exclude<{
+            readonly id: string;
+            readonly type: "generation-queued";
+            readonly position?: number | undefined;
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly id: string;
+            readonly type: "generation-progress";
+            readonly progress?: number | undefined;
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly type: "image-partial";
+            readonly index: number;
+            readonly image: Media.Asset;
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
             readonly type: "image";
             readonly index: number;
             readonly image: Media.Asset;
@@ -851,6 +1125,18 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
         }, {
             readonly type: keyof Cases;
         }>) => any>(value: {
+            readonly id: string;
+            readonly type: "generation-queued";
+            readonly position?: number | undefined;
+        } | {
+            readonly id: string;
+            readonly type: "generation-progress";
+            readonly progress?: number | undefined;
+        } | {
+            readonly type: "image-partial";
+            readonly index: number;
+            readonly image: Media.Asset;
+        } | {
             readonly type: "image";
             readonly index: number;
             readonly image: Media.Asset;
@@ -893,6 +1179,21 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
             }[] | 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 {
+            "generation-queued"?: ((value: {
+                readonly id: string;
+                readonly type: "generation-queued";
+                readonly position?: number | undefined;
+            }) => any) | undefined;
+            "generation-progress"?: ((value: {
+                readonly id: string;
+                readonly type: "generation-progress";
+                readonly progress?: number | undefined;
+            }) => any) | undefined;
+            "image-partial"?: ((value: {
+                readonly type: "image-partial";
+                readonly index: number;
+                readonly image: Media.Asset;
+            }) => any) | undefined;
             image?: ((value: {
                 readonly type: "image";
                 readonly index: number;
@@ -936,7 +1237,25 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
                     } | undefined;
                 }[] | undefined;
             }) => any) | undefined;
-        } & { [K in Exclude<keyof Cases, "image" | "finish">]: never; }, OrElse extends (value: Exclude<{
+        } & { [K in Exclude<keyof Cases, "image" | "finish" | "generation-queued" | "generation-progress" | "image-partial">]: never; }, OrElse extends (value: Exclude<{
+            readonly id: string;
+            readonly type: "generation-queued";
+            readonly position?: number | undefined;
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly id: string;
+            readonly type: "generation-progress";
+            readonly progress?: number | undefined;
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly type: "image-partial";
+            readonly index: number;
+            readonly image: Media.Asset;
+        }, {
+            readonly type: keyof Cases;
+        }> | Exclude<{
             readonly type: "image";
             readonly index: number;
             readonly image: Media.Asset;
@@ -982,6 +1301,18 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
         }, {
             readonly type: keyof Cases;
         }>) => any>(cases: Cases, orElse: OrElse): (value: {
+            readonly id: string;
+            readonly type: "generation-queued";
+            readonly position?: number | undefined;
+        } | {
+            readonly id: string;
+            readonly type: "generation-progress";
+            readonly progress?: number | undefined;
+        } | {
+            readonly type: "image-partial";
+            readonly index: number;
+            readonly image: Media.Asset;
+        } | {
             readonly type: "image";
             readonly index: number;
             readonly image: Media.Asset;
@@ -1026,6 +1357,21 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
     };
 } & {
     is: {
+        generationQueued: (u: unknown) => u is {
+            readonly id: string;
+            readonly type: "generation-queued";
+            readonly position?: number | undefined;
+        };
+        generationProgress: (u: unknown) => u is {
+            readonly id: string;
+            readonly type: "generation-progress";
+            readonly progress?: number | undefined;
+        };
+        imagePartial: (u: unknown) => u is {
+            readonly type: "image-partial";
+            readonly index: number;
+            readonly image: Media.Asset;
+        };
         image: (u: unknown) => u is {
             readonly type: "image";
             readonly index: number;
@@ -1072,17 +1418,22 @@ export declare const ImageEvent: Schema.Union<readonly [Schema.Struct<{
     };
 };
 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 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 function generate<const Model extends ImageModel>(input: ImageRequestInput<Model>, options?: AwaitOptions): Effect.Effect<ImageResponse, AIError, Service>;
+export declare function generate(input: ImageRequest, options?: AwaitOptions): Effect.Effect<ImageResponse, AIError, Service>;
+export declare function stream<const Model extends ImageModel>(input: ImageRequestInput<Model>, options?: AwaitOptions): Stream.Stream<ImageEvent, AIError, Service>;
+export declare function stream(input: ImageRequest, options?: AwaitOptions): Stream.Stream<ImageEvent, AIError, Service>;
+/** Inline and streaming routes fail with `UnsupportedOperation`. */
+export declare function start<const Model extends ImageModel>(input: ImageRequestInput<Model>): Effect.Effect<Generation<ImageResponse>, AIError, Service>;
+export declare function start(input: ImageRequest): Effect.Effect<Generation<ImageResponse>, AIError, Service>;
+export declare const resume: <Options extends ImageOptions>(model: ImageModel<Options>, token: unknown) => Effect.Effect<Generation<ImageResponse>, AIError, Service>;
 export declare const Image: {
     readonly request: typeof request;
     readonly generate: typeof generate;
     readonly stream: typeof stream;
+    readonly start: typeof start;
+    readonly resume: <Options extends ImageOptions>(model: ImageModel<Options>, token: unknown) => Effect.Effect<Generation<ImageResponse>, AIError, Service>;
 };
 export {};