@opencode/ai 2.0.13 → 2.0.15

package/dist/schema/events.d.ts

@@ -1,9 +1,10 @@
 import { Schema } from "effect";
 import { ContentBlockID, ToolCallID } from "./ids.js";
-import { Message, CompactionPart, ProviderMetadata, ToolOutput, ToolResultValue } from "./messages.js";
+import { Message, CompactionPart, ToolOutput, ToolResultValue } from "./messages.js";
+import { ProviderMetadata } from "./options.js";
+import { Media } from "../media.js";
 export declare const FinishReason: Schema.Literals<readonly ["stop", "length", "tool-calls", "content-filter", "error", "unknown"]>;
 export type FinishReason = Schema.Schema.Type<typeof FinishReason>;
-export { ProviderMetadata } from "./messages.js";
 declare const Usage_base: Schema.Class<Usage, Schema.Struct<{
     /** Effective input size of the final message iteration, when reported; not billed totals. */
     readonly contextTokens: Schema.optional<Schema.Number>;
@@ -72,6 +73,30 @@ export declare class Usage extends Usage_base {
     static from(input: UsageInput): Usage;
 }
 export type UsageInput = Usage | ConstructorParameters<typeof Usage>[0];
+/**
+ * Usage reported by media routes. Providers bill images, video, speech, and transcription in different units, so
+ * each response carries the unit it was actually metered in instead of forcing everything into tokens.
+ */
+export declare const MediaUsage: 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;
+}>]>;
+export type MediaUsage = Schema.Schema.Type<typeof MediaUsage>;
 declare const CompactionResponse_base: Schema.Class<CompactionResponse, Schema.Struct<{
     readonly replacement: Schema.$Array<typeof Message>;
     readonly usage: Schema.optional<typeof Usage>;
@@ -323,6 +348,44 @@ export declare const Finish: Schema.Struct<{
     readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
 }>;
 export type Finish = Schema.Schema.Type<typeof Finish>;
+/** A generated media asset (image, audio, …) emitted by the model as first-class output rather than a tool result. */
+export declare const MediaEvent: Schema.Struct<{
+    readonly type: Schema.tag<"media">;
+    readonly media: 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 providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+}>;
+export type MediaEvent = Schema.Schema.Type<typeof MediaEvent>;
 export declare const ProviderErrorEvent: Schema.Struct<{
     readonly type: Schema.tag<"provider-error">;
     readonly message: Schema.String;
@@ -499,6 +562,41 @@ declare const llmEventTagged: Schema.toTaggedUnion<"type", readonly [Schema.refi
     readonly message: Schema.String;
     readonly error: Schema.optional<Schema.Defect>;
     readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"media">;
+    readonly media: 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 providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
 }>, Schema.Struct<{
     readonly type: Schema.tag<"step-finish">;
     readonly index: Schema.Number;
@@ -706,6 +804,41 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
     readonly message: Schema.String;
     readonly error: Schema.optional<Schema.Defect>;
     readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+}>, Schema.Struct<{
+    readonly type: Schema.tag<"media">;
+    readonly media: 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 providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
 }>, Schema.Struct<{
     readonly type: Schema.tag<"step-finish">;
     readonly index: Schema.Number;
@@ -729,7 +862,7 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
     readonly classification: Schema.optional<Schema.Literals<readonly ["context-overflow", "payload-too-large"]>>;
     readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
 }>]> & {
-    readonly discriminants: readonly ["compaction", "step-start", "text-start", "text-delta", "text-end", "reasoning-start", "reasoning-delta", "reasoning-end", "tool-input-start", "tool-input-delta", "tool-input-end", "tool-input-error", "tool-call", "tool-result", "tool-error", "step-finish", "finish", "provider-error"];
+    readonly discriminants: readonly ["compaction", "step-start", "text-start", "text-delta", "text-end", "reasoning-start", "reasoning-delta", "reasoning-end", "tool-input-start", "tool-input-delta", "tool-input-end", "tool-input-error", "tool-call", "tool-result", "tool-error", "media", "step-finish", "finish", "provider-error"];
     readonly cases: {
         compaction: Schema.refine<{
             readonly type: "compaction";
@@ -915,6 +1048,42 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
             readonly error: Schema.optional<Schema.Defect>;
             readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
         }>;
+        media: Schema.Struct<{
+            readonly type: Schema.tag<"media">;
+            readonly media: 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 providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+        }>;
         "step-finish": Schema.Struct<{
             readonly type: Schema.tag<"step-finish">;
             readonly index: Schema.Number;
@@ -1110,6 +1279,14 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
             };
         } | undefined;
         readonly namespace?: string | undefined;
+    } | {
+        readonly type: "media";
+        readonly media: Media.Asset;
+        readonly providerMetadata?: {
+            readonly [x: string]: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined;
     } | {
         readonly type: "step-finish";
         readonly reason: {
@@ -1138,12 +1315,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
     } | {
         readonly type: "provider-error";
         readonly message: string;
+        readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         readonly providerMetadata?: {
             readonly [x: string]: {
                 readonly [x: string]: unknown;
             };
         } | undefined;
-        readonly classification?: "context-overflow" | "payload-too-large" | undefined;
     }) => value is Extract<{
         readonly type: "compaction";
         readonly provider: string & import("effect/Brand").Brand<"AI.ProviderID">;
@@ -1351,6 +1528,16 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
         readonly namespace?: string | undefined;
     }, {
         readonly type: Keys;
+    }> | Extract<{
+        readonly type: "media";
+        readonly media: Media.Asset;
+        readonly providerMetadata?: {
+            readonly [x: string]: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined;
+    }, {
+        readonly type: Keys;
     }> | Extract<{
         readonly type: "step-finish";
         readonly reason: {
@@ -1383,12 +1570,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
     }> | Extract<{
         readonly type: "provider-error";
         readonly message: string;
+        readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         readonly providerMetadata?: {
             readonly [x: string]: {
                 readonly [x: string]: unknown;
             };
         } | undefined;
-        readonly classification?: "context-overflow" | "payload-too-large" | undefined;
     }, {
         readonly type: Keys;
     }>;
@@ -1577,6 +1764,15 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
             } | undefined;
             readonly namespace?: string | undefined;
         };
+        media: (u: unknown) => u is {
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+        };
         "step-finish": (u: unknown) => u is {
             readonly type: "step-finish";
             readonly reason: {
@@ -1607,12 +1803,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
         "provider-error": (u: unknown) => u is {
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         };
     };
     readonly match: {
@@ -1801,6 +1997,15 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
                 } | undefined;
                 readonly namespace?: string | undefined;
             }) => any;
+            media: (value: {
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }) => any;
             "step-finish": (value: {
                 readonly type: "step-finish";
                 readonly reason: {
@@ -1831,12 +2036,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
             "provider-error": (value: {
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             }) => any;
         }>(value: ({
             readonly type: "compaction";
@@ -2007,6 +2212,14 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
                 };
             } | undefined;
             readonly namespace?: string | undefined;
+        } | {
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
         } | {
             readonly type: "step-finish";
             readonly reason: {
@@ -2035,12 +2248,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
         } | {
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         }, cases: Cases): Cases[keyof Cases] extends (value: any) => infer R ? import("effect/Unify").Unify<R> : never;
         <Cases extends {
             compaction: (value: {
@@ -2227,6 +2440,15 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
                 } | undefined;
                 readonly namespace?: string | undefined;
             }) => any;
+            media: (value: {
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }) => any;
             "step-finish": (value: {
                 readonly type: "step-finish";
                 readonly reason: {
@@ -2257,12 +2479,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
             "provider-error": (value: {
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             }) => any;
         }>(cases: Cases): (value: ({
             readonly type: "compaction";
@@ -2433,6 +2655,14 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
                 };
             } | undefined;
             readonly namespace?: string | undefined;
+        } | {
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
         } | {
             readonly type: "step-finish";
             readonly reason: {
@@ -2461,12 +2691,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
         } | {
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         }) => Cases[keyof Cases] extends (value: any) => infer R ? import("effect/Unify").Unify<R> : never;
     };
     readonly matchOrElse: {
@@ -2655,6 +2885,15 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
                 } | undefined;
                 readonly namespace?: string | undefined;
             }) => any) | undefined;
+            media?: ((value: {
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }) => any) | undefined;
             "step-finish"?: ((value: {
                 readonly type: "step-finish";
                 readonly reason: {
@@ -2685,14 +2924,14 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
             "provider-error"?: ((value: {
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             }) => any) | undefined;
-        } & { [K in Exclude<keyof Cases, "compaction" | "finish" | "tool-call" | "tool-result" | "step-start" | "text-start" | "text-delta" | "text-end" | "reasoning-start" | "reasoning-delta" | "reasoning-end" | "tool-input-start" | "tool-input-delta" | "tool-input-end" | "tool-input-error" | "tool-error" | "step-finish" | "provider-error">]: never; }, OrElse extends (value: Exclude<{
+        } & { [K in Exclude<keyof Cases, "compaction" | "finish" | "media" | "tool-call" | "tool-result" | "step-start" | "text-start" | "text-delta" | "text-end" | "reasoning-start" | "reasoning-delta" | "reasoning-end" | "tool-input-start" | "tool-input-delta" | "tool-input-end" | "tool-input-error" | "tool-error" | "step-finish" | "provider-error">]: never; }, OrElse extends (value: Exclude<{
             readonly type: "compaction";
             readonly provider: string & import("effect/Brand").Brand<"AI.ProviderID">;
             readonly id?: string | undefined;
@@ -2899,6 +3138,16 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
             readonly namespace?: string | undefined;
         }, {
             readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+        }, {
+            readonly type: keyof Cases;
         }> | Exclude<{
             readonly type: "step-finish";
             readonly reason: {
@@ -2931,12 +3180,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
         }> | Exclude<{
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         }, {
             readonly type: keyof Cases;
         }>) => any>(value: ({
@@ -3108,6 +3357,14 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
                 };
             } | undefined;
             readonly namespace?: string | undefined;
+        } | {
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
         } | {
             readonly type: "step-finish";
             readonly reason: {
@@ -3136,12 +3393,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
         } | {
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | 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 {
             compaction?: ((value: {
@@ -3328,6 +3585,15 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
                 } | undefined;
                 readonly namespace?: string | undefined;
             }) => any) | undefined;
+            media?: ((value: {
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }) => any) | undefined;
             "step-finish"?: ((value: {
                 readonly type: "step-finish";
                 readonly reason: {
@@ -3358,14 +3624,14 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
             "provider-error"?: ((value: {
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             }) => any) | undefined;
-        } & { [K in Exclude<keyof Cases, "compaction" | "finish" | "tool-call" | "tool-result" | "step-start" | "text-start" | "text-delta" | "text-end" | "reasoning-start" | "reasoning-delta" | "reasoning-end" | "tool-input-start" | "tool-input-delta" | "tool-input-end" | "tool-input-error" | "tool-error" | "step-finish" | "provider-error">]: never; }, OrElse extends (value: Exclude<{
+        } & { [K in Exclude<keyof Cases, "compaction" | "finish" | "media" | "tool-call" | "tool-result" | "step-start" | "text-start" | "text-delta" | "text-end" | "reasoning-start" | "reasoning-delta" | "reasoning-end" | "tool-input-start" | "tool-input-delta" | "tool-input-end" | "tool-input-error" | "tool-error" | "step-finish" | "provider-error">]: never; }, OrElse extends (value: Exclude<{
             readonly type: "compaction";
             readonly provider: string & import("effect/Brand").Brand<"AI.ProviderID">;
             readonly id?: string | undefined;
@@ -3572,6 +3838,16 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
             readonly namespace?: string | undefined;
         }, {
             readonly type: keyof Cases;
+        }> | Exclude<{
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+        }, {
+            readonly type: keyof Cases;
         }> | Exclude<{
             readonly type: "step-finish";
             readonly reason: {
@@ -3604,12 +3880,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
         }> | Exclude<{
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         }, {
             readonly type: keyof Cases;
         }>) => any>(cases: Cases, orElse: OrElse): (value: ({
@@ -3781,6 +4057,14 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
                 };
             } | undefined;
             readonly namespace?: string | undefined;
+        } | {
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
         } | {
             readonly type: "step-finish";
             readonly reason: {
@@ -3809,12 +4093,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
         } | {
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | 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>>;
     };
 } & {
@@ -4017,6 +4301,23 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
         } | undefined;
         readonly namespace?: string | undefined;
     };
+    media: (input: {
+        readonly media: Media.Asset;
+        readonly type?: "media" | undefined;
+        readonly providerMetadata?: {
+            readonly [x: string]: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined;
+    }, options?: Schema.MakeOptions) => {
+        readonly type: "media";
+        readonly media: Media.Asset;
+        readonly providerMetadata?: {
+            readonly [x: string]: {
+                readonly [x: string]: unknown;
+            };
+        } | undefined;
+    };
     stepFinish: (input: WithUsage<StepFinish>) => {
         readonly type: "step-finish";
         readonly reason: {
@@ -4047,21 +4348,21 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
     providerError: (input: {
         readonly message: string;
         readonly type?: "provider-error" | undefined;
+        readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         readonly providerMetadata?: {
             readonly [x: string]: {
                 readonly [x: string]: unknown;
             };
         } | undefined;
-        readonly classification?: "context-overflow" | "payload-too-large" | undefined;
     }, options?: Schema.MakeOptions) => {
         readonly type: "provider-error";
         readonly message: string;
+        readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         readonly providerMetadata?: {
             readonly [x: string]: {
                 readonly [x: string]: unknown;
             };
         } | undefined;
-        readonly classification?: "context-overflow" | "payload-too-large" | undefined;
     };
     is: {
         compaction: (u: unknown) => u is {
@@ -4248,6 +4549,15 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
             } | undefined;
             readonly namespace?: string | undefined;
         };
+        media: (u: unknown) => u is {
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+        };
         stepFinish: (u: unknown) => u is {
             readonly type: "step-finish";
             readonly reason: {
@@ -4278,12 +4588,12 @@ export declare const LLMEvent: Schema.Union<readonly [Schema.refine<{
         providerError: (u: unknown) => u is {
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         };
     };
 };
@@ -4479,6 +4789,41 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
         readonly message: Schema.String;
         readonly error: Schema.optional<Schema.Defect>;
         readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"media">;
+        readonly media: 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 providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
     }>, Schema.Struct<{
         readonly type: Schema.tag<"step-finish">;
         readonly index: Schema.Number;
@@ -4502,7 +4847,7 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
         readonly classification: Schema.optional<Schema.Literals<readonly ["context-overflow", "payload-too-large"]>>;
         readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
     }>]> & {
-        readonly discriminants: readonly ["compaction", "step-start", "text-start", "text-delta", "text-end", "reasoning-start", "reasoning-delta", "reasoning-end", "tool-input-start", "tool-input-delta", "tool-input-end", "tool-input-error", "tool-call", "tool-result", "tool-error", "step-finish", "finish", "provider-error"];
+        readonly discriminants: readonly ["compaction", "step-start", "text-start", "text-delta", "text-end", "reasoning-start", "reasoning-delta", "reasoning-end", "tool-input-start", "tool-input-delta", "tool-input-end", "tool-input-error", "tool-call", "tool-result", "tool-error", "media", "step-finish", "finish", "provider-error"];
         readonly cases: {
             compaction: Schema.refine<{
                 readonly type: "compaction";
@@ -4688,6 +5033,42 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                 readonly error: Schema.optional<Schema.Defect>;
                 readonly providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
             }>;
+            media: Schema.Struct<{
+                readonly type: Schema.tag<"media">;
+                readonly media: 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 providerMetadata: Schema.optional<Schema.$Record<Schema.String, Schema.$Record<Schema.String, Schema.Unknown>>>;
+            }>;
             "step-finish": Schema.Struct<{
                 readonly type: Schema.tag<"step-finish">;
                 readonly index: Schema.Number;
@@ -4883,6 +5264,14 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                 };
             } | undefined;
             readonly namespace?: string | undefined;
+        } | {
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
         } | {
             readonly type: "step-finish";
             readonly reason: {
@@ -4911,12 +5300,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
         } | {
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         }) => value is Extract<{
             readonly type: "compaction";
             readonly provider: string & import("effect/Brand").Brand<"AI.ProviderID">;
@@ -5124,6 +5513,16 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
             readonly namespace?: string | undefined;
         }, {
             readonly type: Keys;
+        }> | Extract<{
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+        }, {
+            readonly type: Keys;
         }> | Extract<{
             readonly type: "step-finish";
             readonly reason: {
@@ -5156,12 +5555,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
         }> | Extract<{
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         }, {
             readonly type: Keys;
         }>;
@@ -5350,6 +5749,15 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                 } | undefined;
                 readonly namespace?: string | undefined;
             };
+            media: (u: unknown) => u is {
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            };
             "step-finish": (u: unknown) => u is {
                 readonly type: "step-finish";
                 readonly reason: {
@@ -5380,12 +5788,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
             "provider-error": (u: unknown) => u is {
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             };
         };
         readonly match: {
@@ -5574,6 +5982,15 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                     } | undefined;
                     readonly namespace?: string | undefined;
                 }) => any;
+                media: (value: {
+                    readonly type: "media";
+                    readonly media: Media.Asset;
+                    readonly providerMetadata?: {
+                        readonly [x: string]: {
+                            readonly [x: string]: unknown;
+                        };
+                    } | undefined;
+                }) => any;
                 "step-finish": (value: {
                     readonly type: "step-finish";
                     readonly reason: {
@@ -5604,12 +6021,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                 "provider-error": (value: {
                     readonly type: "provider-error";
                     readonly message: string;
+                    readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                     readonly providerMetadata?: {
                         readonly [x: string]: {
                             readonly [x: string]: unknown;
                         };
                     } | undefined;
-                    readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 }) => any;
             }>(value: ({
                 readonly type: "compaction";
@@ -5780,6 +6197,14 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                     };
                 } | undefined;
                 readonly namespace?: string | undefined;
+            } | {
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
             } | {
                 readonly type: "step-finish";
                 readonly reason: {
@@ -5808,12 +6233,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
             } | {
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             }, cases: Cases): Cases[keyof Cases] extends (value: any) => infer R ? import("effect/Unify").Unify<R> : never;
             <Cases extends {
                 compaction: (value: {
@@ -6000,6 +6425,15 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                     } | undefined;
                     readonly namespace?: string | undefined;
                 }) => any;
+                media: (value: {
+                    readonly type: "media";
+                    readonly media: Media.Asset;
+                    readonly providerMetadata?: {
+                        readonly [x: string]: {
+                            readonly [x: string]: unknown;
+                        };
+                    } | undefined;
+                }) => any;
                 "step-finish": (value: {
                     readonly type: "step-finish";
                     readonly reason: {
@@ -6030,12 +6464,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                 "provider-error": (value: {
                     readonly type: "provider-error";
                     readonly message: string;
+                    readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                     readonly providerMetadata?: {
                         readonly [x: string]: {
                             readonly [x: string]: unknown;
                         };
                     } | undefined;
-                    readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 }) => any;
             }>(cases: Cases): (value: ({
                 readonly type: "compaction";
@@ -6206,6 +6640,14 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                     };
                 } | undefined;
                 readonly namespace?: string | undefined;
+            } | {
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
             } | {
                 readonly type: "step-finish";
                 readonly reason: {
@@ -6234,12 +6676,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
             } | {
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             }) => Cases[keyof Cases] extends (value: any) => infer R ? import("effect/Unify").Unify<R> : never;
         };
         readonly matchOrElse: {
@@ -6428,6 +6870,15 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                     } | undefined;
                     readonly namespace?: string | undefined;
                 }) => any) | undefined;
+                media?: ((value: {
+                    readonly type: "media";
+                    readonly media: Media.Asset;
+                    readonly providerMetadata?: {
+                        readonly [x: string]: {
+                            readonly [x: string]: unknown;
+                        };
+                    } | undefined;
+                }) => any) | undefined;
                 "step-finish"?: ((value: {
                     readonly type: "step-finish";
                     readonly reason: {
@@ -6458,14 +6909,14 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                 "provider-error"?: ((value: {
                     readonly type: "provider-error";
                     readonly message: string;
+                    readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                     readonly providerMetadata?: {
                         readonly [x: string]: {
                             readonly [x: string]: unknown;
                         };
                     } | undefined;
-                    readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 }) => any) | undefined;
-            } & { [K in Exclude<keyof Cases, "compaction" | "finish" | "tool-call" | "tool-result" | "step-start" | "text-start" | "text-delta" | "text-end" | "reasoning-start" | "reasoning-delta" | "reasoning-end" | "tool-input-start" | "tool-input-delta" | "tool-input-end" | "tool-input-error" | "tool-error" | "step-finish" | "provider-error">]: never; }, OrElse extends (value: Exclude<{
+            } & { [K in Exclude<keyof Cases, "compaction" | "finish" | "media" | "tool-call" | "tool-result" | "step-start" | "text-start" | "text-delta" | "text-end" | "reasoning-start" | "reasoning-delta" | "reasoning-end" | "tool-input-start" | "tool-input-delta" | "tool-input-end" | "tool-input-error" | "tool-error" | "step-finish" | "provider-error">]: never; }, OrElse extends (value: Exclude<{
                 readonly type: "compaction";
                 readonly provider: string & import("effect/Brand").Brand<"AI.ProviderID">;
                 readonly id?: string | undefined;
@@ -6672,6 +7123,16 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                 readonly namespace?: string | undefined;
             }, {
                 readonly type: keyof Cases;
+            }> | Exclude<{
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }, {
+                readonly type: keyof Cases;
             }> | Exclude<{
                 readonly type: "step-finish";
                 readonly reason: {
@@ -6704,12 +7165,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
             }> | Exclude<{
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             }, {
                 readonly type: keyof Cases;
             }>) => any>(value: ({
@@ -6881,6 +7342,14 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                     };
                 } | undefined;
                 readonly namespace?: string | undefined;
+            } | {
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
             } | {
                 readonly type: "step-finish";
                 readonly reason: {
@@ -6909,12 +7378,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
             } | {
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | 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 {
                 compaction?: ((value: {
@@ -7101,6 +7570,15 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                     } | undefined;
                     readonly namespace?: string | undefined;
                 }) => any) | undefined;
+                media?: ((value: {
+                    readonly type: "media";
+                    readonly media: Media.Asset;
+                    readonly providerMetadata?: {
+                        readonly [x: string]: {
+                            readonly [x: string]: unknown;
+                        };
+                    } | undefined;
+                }) => any) | undefined;
                 "step-finish"?: ((value: {
                     readonly type: "step-finish";
                     readonly reason: {
@@ -7131,14 +7609,14 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                 "provider-error"?: ((value: {
                     readonly type: "provider-error";
                     readonly message: string;
+                    readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                     readonly providerMetadata?: {
                         readonly [x: string]: {
                             readonly [x: string]: unknown;
                         };
                     } | undefined;
-                    readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 }) => any) | undefined;
-            } & { [K in Exclude<keyof Cases, "compaction" | "finish" | "tool-call" | "tool-result" | "step-start" | "text-start" | "text-delta" | "text-end" | "reasoning-start" | "reasoning-delta" | "reasoning-end" | "tool-input-start" | "tool-input-delta" | "tool-input-end" | "tool-input-error" | "tool-error" | "step-finish" | "provider-error">]: never; }, OrElse extends (value: Exclude<{
+            } & { [K in Exclude<keyof Cases, "compaction" | "finish" | "media" | "tool-call" | "tool-result" | "step-start" | "text-start" | "text-delta" | "text-end" | "reasoning-start" | "reasoning-delta" | "reasoning-end" | "tool-input-start" | "tool-input-delta" | "tool-input-end" | "tool-input-error" | "tool-error" | "step-finish" | "provider-error">]: never; }, OrElse extends (value: Exclude<{
                 readonly type: "compaction";
                 readonly provider: string & import("effect/Brand").Brand<"AI.ProviderID">;
                 readonly id?: string | undefined;
@@ -7345,6 +7823,16 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                 readonly namespace?: string | undefined;
             }, {
                 readonly type: keyof Cases;
+            }> | Exclude<{
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            }, {
+                readonly type: keyof Cases;
             }> | Exclude<{
                 readonly type: "step-finish";
                 readonly reason: {
@@ -7377,12 +7865,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
             }> | Exclude<{
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             }, {
                 readonly type: keyof Cases;
             }>) => any>(cases: Cases, orElse: OrElse): (value: ({
@@ -7554,6 +8042,14 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                     };
                 } | undefined;
                 readonly namespace?: string | undefined;
+            } | {
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
             } | {
                 readonly type: "step-finish";
                 readonly reason: {
@@ -7582,12 +8078,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
             } | {
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | 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>>;
         };
     } & {
@@ -7790,6 +8286,23 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
             } | undefined;
             readonly namespace?: string | undefined;
         };
+        media: (input: {
+            readonly media: Media.Asset;
+            readonly type?: "media" | undefined;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+        }, options?: Schema.MakeOptions) => {
+            readonly type: "media";
+            readonly media: Media.Asset;
+            readonly providerMetadata?: {
+                readonly [x: string]: {
+                    readonly [x: string]: unknown;
+                };
+            } | undefined;
+        };
         stepFinish: (input: WithUsage<StepFinish>) => {
             readonly type: "step-finish";
             readonly reason: {
@@ -7820,21 +8333,21 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
         providerError: (input: {
             readonly message: string;
             readonly type?: "provider-error" | undefined;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         }, options?: Schema.MakeOptions) => {
             readonly type: "provider-error";
             readonly message: string;
+            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             readonly providerMetadata?: {
                 readonly [x: string]: {
                     readonly [x: string]: unknown;
                 };
             } | undefined;
-            readonly classification?: "context-overflow" | "payload-too-large" | undefined;
         };
         is: {
             compaction: (u: unknown) => u is {
@@ -8021,6 +8534,15 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
                 } | undefined;
                 readonly namespace?: string | undefined;
             };
+            media: (u: unknown) => u is {
+                readonly type: "media";
+                readonly media: Media.Asset;
+                readonly providerMetadata?: {
+                    readonly [x: string]: {
+                        readonly [x: string]: unknown;
+                    };
+                } | undefined;
+            };
             stepFinish: (u: unknown) => u is {
                 readonly type: "step-finish";
                 readonly reason: {
@@ -8051,12 +8573,12 @@ declare const LLMResponse_base: Schema.Class<LLMResponse, Schema.Struct<{
             providerError: (u: unknown) => u is {
                 readonly type: "provider-error";
                 readonly message: string;
+                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
                 readonly providerMetadata?: {
                     readonly [x: string]: {
                         readonly [x: string]: unknown;
                     };
                 } | undefined;
-                readonly classification?: "context-overflow" | "payload-too-large" | undefined;
             };
         };
     }>;
@@ -8121,3 +8643,4 @@ export declare namespace LLMResponse {
     /** Concatenate reasoning text from a response or collected event list. */
     const reasoning: (response: Output) => string;
 }
+export {};