@opencode/ai 0.0.0-dev-20180 → 0.0.0-dev-20183

package/README.md

@@ -621,8 +621,7 @@ persist the bytes promptly if they must remain available.
 ### Partial images
 
 OpenAI's GPT image models stream previews. `Image.stream` sends `stream: true` with `partialImages` (0–3, default 2)
-and emits `image-partial` events before each final `image`; `Image.generate` keeps the plain JSON request.
-`dall-e-*` models do not stream and fail typed:
+and emits `image-partial` events before each final `image`; `Image.generate` keeps the plain JSON request:
 
 ```ts
 import { Stream } from "effect"

package/dist/protocols/assemblyai-transcription.js

@@ -94,7 +94,7 @@ const decodeResult = Effect.fn("AssemblyAITranscription.decodeResult")(function*
     if (status === "failed")
         return yield* output.ended("failed", `${route.name} transcription failed${error === undefined ? "" : `: ${error}`}`);
     if (status !== "completed")
-        return yield* output.invalid(`${route.name} transcript ${context.token.transcriptID} has not finished`);
+        return yield* output.pending(context.token.transcriptID);
     const duration = transcript.audio_duration ?? undefined;
     return new TranscriptionResponse({
         text: transcript.text ?? "",

package/dist/protocols/bfl-images.js

@@ -121,7 +121,9 @@ const decodeResult = Effect.fn("BlackForestLabsImages.decodeResult")(function* (
         return yield* output.contentPolicy(`${route.name} moderated the generation`);
     if (status === "failed" || status === "expired")
         return yield* output.ended(status, `${route.name} generation ${context.token.id} ended with ${document.status}`);
-    if (status !== "completed" || document.result === undefined || document.result === null)
+    if (status !== "completed")
+        return yield* output.pending(context.token.id);
+    if (document.result === undefined || document.result === null)
         return yield* output.invalid(`${route.name} generation ${context.token.id} has no result`);
     const { sample, seed, prompt, ...rest } = document.result;
     // A settled `cost` on the result supersedes the submit-time cost carried on the token.

package/dist/protocols/google-images.js

@@ -61,7 +61,7 @@ const generationConfig = (request) => {
 };
 const fromRequest = Effect.fn("GoogleImages.fromRequest")(function* (request) {
     if (request.n !== undefined && request.n > 1)
-        return yield* route.unsupported("image.n", `${route.name} generates one image per request; call it once per image instead of n=${request.n}`);
+        return yield* route.unsupported("media.n", `${route.name} generates one image per request; call it once per image instead of n=${request.n}`);
     const parts = yield* Effect.forEach(request.images ?? [], (image) => GeminiGenerateContent.mediaPart(route.name, image));
     return MediaProtocol.json(mergeJsonRecords({
         contents: [{ role: "user", parts: [{ text: request.prompt }, ...parts] }],

package/dist/protocols/google-video.js

@@ -90,7 +90,7 @@ const decodeResult = Effect.fn("GoogleVideo.decodeResult")(function* (response,
     const operation = output.value;
     const status = statusOf(operation);
     if (status === "running")
-        return yield* output.invalid(`${route.name} operation ${context.token.operation} has not finished`);
+        return yield* output.pending(context.token.operation);
     if (status === "failed")
         return yield* output.ended("failed", `${route.name} operation failed${operation.error?.message === undefined ? "" : `: ${operation.error.message}`}`);
     const generated = operation.response?.generateVideoResponse;

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

@@ -24,6 +24,9 @@ type Frame = string | {
 interface State {
     readonly completed: number;
     readonly format?: string;
+    readonly size?: string;
+    readonly quality?: string;
+    readonly background?: string;
     readonly usage?: MediaUsage;
 }
 export declare const protocol: MediaProtocol.Streamed<Request, {

package/dist/protocols/openai-images.js

@@ -21,13 +21,16 @@ const Usage = Schema.Struct({
     input_tokens_details: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
     output_tokens_details: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
 });
-const OpenAIImageResponse = Schema.Struct({
-    data: Schema.Array(Schema.Struct({
-        b64_json: Schema.optional(Schema.String),
-        url: Schema.optional(Schema.String),
-        revised_prompt: Schema.optional(Schema.String),
-    })),
+/** What the provider actually rendered; it can differ from the request when `auto` or a default applied. */
+const Settings = {
     output_format: Schema.optional(Schema.String),
+    size: Schema.optional(Schema.String),
+    quality: Schema.optional(Schema.String),
+    background: Schema.optional(Schema.String),
+};
+const OpenAIImageResponse = Schema.Struct({
+    data: Schema.Array(Schema.Struct({ b64_json: Schema.String })),
+    ...Settings,
     usage: Schema.optional(Usage),
 });
 // ---------------------------------------------------------------------------
@@ -38,11 +41,13 @@ const StreamEvent = Schema.Union([
         type: Schema.Literals(["image_generation.partial_image", "image_edit.partial_image"]),
         b64_json: Schema.String,
         partial_image_index: Schema.Number,
+        ...Settings,
         output_format: Schema.String,
     }),
     Schema.Struct({
         type: Schema.Literals(["image_generation.completed", "image_edit.completed"]),
         b64_json: Schema.String,
+        ...Settings,
         output_format: Schema.String,
         usage: Schema.optional(Usage),
     }),
@@ -63,8 +68,6 @@ const nativeOptions = (options) => {
 const streamOptions = (request) => {
     if (request.mode !== "stream")
         return Effect.succeed(undefined);
-    if (request.model.id.startsWith("dall-e"))
-        return Effect.fail(route.unsupported("media.stream", `${request.model.id} does not stream; use Image.generate or a GPT image model`));
     if (request.n !== undefined && request.n > 1)
         return Effect.fail(route.unsupported("media.n", `${route.name} streams one image; use Image.generate for n=${request.n}`));
     return Effect.succeed({ stream: true, partial_images: request.providerOptions?.partialImages ?? 2 });
@@ -115,19 +118,31 @@ const usage = (value) => value === undefined
         total: value.total_tokens,
         details: { openai: value },
     };
-const eventImage = (frame, label, data, format) => MediaInput.decodedAsset((message, cause) => route.frameError(message, frame, cause), label, data, `image/${format}`, {
-    info: { format },
+/** `size` echoes the rendered `WIDTHxHEIGHT`; `auto` or any other value leaves the dimensions unknown. */
+const info = (format, size) => {
+    const match = size?.match(/^(\d+)x(\d+)$/);
+    return match ? { format, width: Number(match[1]), height: Number(match[2]) } : { format };
+};
+const eventImage = (frame, label, data, format, size) => MediaInput.decodedAsset((message, cause) => route.frameError(message, frame, cause), label, data, `image/${format}`, {
+    info: info(format, size),
 });
 const onEvent = Effect.fn("OpenAIImages.onEvent")(function* (state, frame) {
     const event = yield* decodeEvent(frame);
     const format = event.output_format;
     if ("partial_image_index" in event) {
-        const image = yield* eventImage(frame, `${route.name} partial image`, event.b64_json, format);
+        const image = yield* eventImage(frame, `${route.name} partial image`, event.b64_json, format, event.size);
         return [state, [ImagePartialEvent.make({ index: event.partial_image_index, image })]];
     }
-    const image = yield* eventImage(frame, `${route.name} result ${state.completed}`, event.b64_json, format);
+    const image = yield* eventImage(frame, `${route.name} result ${state.completed}`, event.b64_json, format, event.size);
     return [
-        { ...state, completed: state.completed + 1, format, usage: usage(event.usage) },
+        {
+            completed: state.completed + 1,
+            format,
+            size: event.size,
+            quality: event.quality,
+            background: event.background,
+            usage: usage(event.usage),
+        },
         [ImageOutputEvent.make({ index: state.completed, image })],
     ];
 });
@@ -135,14 +150,19 @@ const onDocument = Effect.fn("OpenAIImages.onDocument")(function* (frame) {
     const invalid = (message, cause) => route.frameError(message, frame.document, cause);
     const decoded = yield* decodeDocument(frame.document).pipe(Effect.mapError((cause) => invalid(`${route.name} returned an invalid response`, cause)));
     const format = decoded.output_format ?? frame.requested ?? "png";
-    const mediaType = `image/${format}`;
-    const images = yield* Effect.forEach(decoded.data, (item, index) => MediaInput.imageOutput(invalid, `${route.name} result ${index}`, item, mediaType, {
-        info: { format },
-        providerMetadata: item.revised_prompt === undefined ? undefined : { openai: { revisedPrompt: item.revised_prompt } },
+    const images = yield* Effect.forEach(decoded.data, (item, index) => MediaInput.decodedAsset(invalid, `${route.name} result ${index}`, item.b64_json, `image/${format}`, {
+        info: info(format, decoded.size),
     }));
     if (images.length === 0)
         return yield* invalid(`${route.name} returned no images`);
-    const state = { completed: images.length, format, usage: usage(decoded.usage) };
+    const state = {
+        completed: images.length,
+        format,
+        size: decoded.size,
+        quality: decoded.quality,
+        background: decoded.background,
+        usage: usage(decoded.usage),
+    };
     return [state, images.map((image, index) => ImageOutputEvent.make({ index, image }))];
 });
 const step = (state, frame) => (typeof frame === "string" ? onEvent(state, frame) : onDocument(frame));
@@ -150,7 +170,17 @@ const finish = (state) => {
     if (state.completed === 0)
         return Effect.fail(route.incomplete());
     return Effect.succeed([
-        ImageFinishEvent.make({ usage: state.usage, providerMetadata: { openai: { outputFormat: state.format } } }),
+        ImageFinishEvent.make({
+            usage: state.usage,
+            providerMetadata: {
+                openai: {
+                    outputFormat: state.format,
+                    size: state.size,
+                    quality: state.quality,
+                    background: state.background,
+                },
+            },
+        }),
     ]);
 };
 // ---------------------------------------------------------------------------

package/dist/protocols/openai-responses.d.ts

@@ -364,8 +364,8 @@ export declare const protocol: Protocol<{
         readonly type: "image_generation_call";
         readonly status?: string | undefined;
         readonly result?: string | null | undefined;
-        readonly revised_prompt?: string | null | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly revised_prompt?: string | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -390,9 +390,9 @@ export declare const protocol: Protocol<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly partial_images?: number | undefined;
         readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly partial_images?: number | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
     } | {
@@ -647,8 +647,8 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         readonly type: "image_generation_call";
         readonly status?: string | undefined;
         readonly result?: string | null | undefined;
-        readonly revised_prompt?: string | null | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly revised_prompt?: string | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -673,9 +673,9 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly partial_images?: number | undefined;
         readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly partial_images?: number | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
     } | {
@@ -875,8 +875,8 @@ export declare const channelTransport: (options: import("./open-responses-channe
         readonly type: "image_generation_call";
         readonly status?: string | undefined;
         readonly result?: string | null | undefined;
-        readonly revised_prompt?: string | null | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly revised_prompt?: string | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -901,9 +901,9 @@ export declare const channelTransport: (options: import("./open-responses-channe
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly partial_images?: number | undefined;
         readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly partial_images?: number | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
     } | {
@@ -1103,8 +1103,8 @@ export declare const transport: import("../route/transport/index.js").Transport<
         readonly type: "image_generation_call";
         readonly status?: string | undefined;
         readonly result?: string | null | undefined;
-        readonly revised_prompt?: string | null | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly revised_prompt?: string | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -1129,9 +1129,9 @@ export declare const transport: import("../route/transport/index.js").Transport<
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly partial_images?: number | undefined;
         readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly partial_images?: number | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
     } | {
@@ -1331,8 +1331,8 @@ export declare const route: Route<{
         readonly type: "image_generation_call";
         readonly status?: string | undefined;
         readonly result?: string | null | undefined;
-        readonly revised_prompt?: string | null | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly revised_prompt?: string | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -1357,9 +1357,9 @@ export declare const route: Route<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly partial_images?: number | undefined;
         readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly partial_images?: number | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
     } | {

package/dist/protocols/openai-transcription.d.ts

@@ -41,6 +41,10 @@ declare const Transcript: Schema.Struct<{
         readonly input_tokens: Schema.optional<Schema.Number>;
         readonly output_tokens: Schema.optional<Schema.Number>;
         readonly total_tokens: Schema.optional<Schema.Number>;
+        readonly input_token_details: Schema.optional<Schema.Struct<{
+            readonly audio_tokens: Schema.optional<Schema.Number>;
+            readonly text_tokens: Schema.optional<Schema.Number>;
+        }>>;
     }>, Schema.Struct<{
         readonly type: Schema.Literal<"duration">;
         readonly seconds: Schema.Number;

package/dist/protocols/openai-transcription.js

@@ -1,8 +1,9 @@
 import { Effect, Schema, Stream } from "effect";
+import { classifyProviderFailure } from "../provider-error.js";
 import { Framing } from "../route/framing.js";
 import { MediaProtocol } from "../route/media-protocol.js";
 import { MediaRoute } from "../route/media.js";
-import { mergeJsonRecords } from "../schema/index.js";
+import { AIError, mergeJsonRecords } from "../schema/index.js";
 import { TranscriptionFinishEvent, TranscriptionModel, TranscriptionSegmentEvent, TranscriptionTextDeltaEvent, } from "../transcription.js";
 import { mediaTypeExtension } from "../utils/media-type.js";
 import { ProviderShared } from "./shared.js";
@@ -25,6 +26,7 @@ const Usage = Schema.Union([
         input_tokens: Schema.optional(Schema.Number),
         output_tokens: Schema.optional(Schema.Number),
         total_tokens: Schema.optional(Schema.Number),
+        input_token_details: Schema.optional(Schema.Struct({ audio_tokens: Schema.optional(Schema.Number), text_tokens: Schema.optional(Schema.Number) })),
     }),
     Schema.Struct({ type: Schema.Literal("duration"), seconds: Schema.Number }),
 ]);
@@ -37,12 +39,21 @@ const transcriptFields = {
     words: Schema.optional(Schema.Array(Schema.Struct({ word: Schema.String, start: Schema.Number, end: Schema.Number }))),
     usage: Schema.optional(Usage),
 };
+/** OpenAI may add stream event types; frames outside `EVENT_TYPES` are ignored. */
+const EventType = Schema.Struct({ type: Schema.String });
 const Event = Schema.Union([
     Schema.Struct({ type: Schema.Literal("transcript.text.delta"), delta: Schema.String }),
     Schema.Struct({ type: Schema.Literal("transcript.text.segment"), ...Segment.fields }),
     Schema.Struct({ type: Schema.Literal("transcript.text.done"), ...transcriptFields }),
+    Schema.Struct({
+        type: Schema.Literal("error"),
+        message: Schema.optional(Schema.String),
+        error: Schema.optional(Schema.Struct({ message: Schema.optional(Schema.String) })),
+    }),
 ]);
+const EVENT_TYPES = new Set(["transcript.text.delta", "transcript.text.segment", "transcript.text.done", "error"]);
 const Transcript = Schema.Struct(transcriptFields);
+const decodeEventType = route.decodeFrame(EventType);
 const decodeEvent = route.decodeFrame(Event);
 const decodeTranscript = route.decodeFrame(Transcript);
 const TRANSCRIBE = { stream: true, timestamps: [], diarize: false, languageField: "language" };
@@ -56,10 +67,10 @@ const capabilities = (model) => {
         return { ...TRANSCRIBE, languageField: "languages" };
     return TRANSCRIBE;
 };
+/** whisper-1 ignores `stream`, so its `stream` mode sends a plain request and emits only `finish`. */
+const streamsEvents = (request) => request.mode === "stream" && capabilities(request.model.id).stream;
 const validate = (request, model) => {
     const id = request.model.id;
-    if (request.mode === "stream" && !model.stream)
-        return Effect.fail(route.unsupported("media.stream", `${id} does not stream; use Transcription.generate`));
     if (request.diarize === true && !model.diarize)
         return Effect.fail(route.unsupported("media.diarize", `${id} does not diarize; use gpt-4o-transcribe-diarize`));
     if (request.prompt !== undefined && model.diarize)
@@ -103,7 +114,7 @@ const fromRequest = Effect.fn("OpenAITranscription.fromRequest")(function* (requ
         timestamp_granularities: responseFormat === "verbose_json" ? [request.timestamps] : undefined,
         // Diarizing audio longer than 30 seconds requires a chunking strategy.
         chunking_strategy: model.diarize ? "auto" : undefined,
-        stream: request.mode === "stream" ? true : undefined,
+        stream: streamsEvents(request) ? true : undefined,
     }, {
         overlay: mergeJsonRecords(request.providerOptions, request.http?.body),
         reserved: RESERVED_FORM_FIELDS,
@@ -121,7 +132,16 @@ const segment = (value) => ({
     speaker: value.speaker,
 });
 const onEvent = Effect.fn("OpenAITranscription.onEvent")(function* (state, frame) {
+    if (!EVENT_TYPES.has((yield* decodeEventType(frame)).type))
+        return [state, []];
     const event = yield* decodeEvent(frame);
+    if (event.type === "error")
+        return yield* new AIError({
+            reason: classifyProviderFailure({
+                message: `${route.name} stream failed: ${event.message ?? event.error?.message ?? "unknown error"}`,
+                rawBody: frame,
+            }),
+        });
     if (event.type === "transcript.text.done")
         return [{ ...state, transcript: event }, []];
     if (event.type === "transcript.text.delta")
@@ -168,7 +188,7 @@ const finish = (state) => {
 export const protocol = MediaProtocol.stream(route, {
     unsupported: ["speakers"],
     body: { from: fromRequest },
-    frames: (bytes, context) => context.request.mode === "stream"
+    frames: (bytes, context) => streamsEvents(context.request)
         ? Framing.sse.frame(bytes)
         : Framing.document.frame(bytes).pipe(Stream.map((document) => ({ document }))),
     initial: () => ({ segments: [] }),

package/dist/protocols/replicate-images.js

@@ -88,7 +88,7 @@ const decodeResult = Effect.fn("ReplicateImages.decodeResult")(function* (respon
     if (status === "failed" || status === "cancelled" || status === "expired")
         return yield* output.ended(status, `${route.name} prediction ${context.token.id} ${prediction.status}${typeof prediction.error === "string" ? `: ${prediction.error}` : ""}`);
     if (status !== "completed")
-        return yield* output.invalid(`${route.name} prediction ${context.token.id} has not finished`);
+        return yield* output.pending(context.token.id);
     if (prediction.data_removed === true)
         return yield* output.ended("expired", `${route.name} removed the output of prediction ${context.token.id}`);
     if (!isOutput(prediction.output))

package/dist/protocols/runway-video.js

@@ -94,7 +94,7 @@ const decodeResult = Effect.fn("RunwayVideo.decodeResult")(function* (response,
     if (status === "cancelled")
         return yield* output.ended("cancelled", `${route.name} task ${context.token.taskID} was cancelled`);
     if (status !== "completed")
-        return yield* output.invalid(`${route.name} task ${context.token.taskID} has not finished`);
+        return yield* output.pending(context.token.taskID);
     const urls = task.output ?? [];
     if (urls.length === 0)
         return yield* output.invalid(`${route.name} task succeeded without any output`);

package/dist/protocols/stability-images.js

@@ -96,7 +96,7 @@ const decodeStatus = (response, context) => Effect.succeed({
 const decodeUpscaleResult = Effect.fn("StabilityImages.decodeUpscaleResult")(function* (response, context) {
     if (response.status === 202) {
         const output = yield* upscaleRoute.text(response);
-        return yield* output.invalid(`${upscaleRoute.name} upscale ${context.token.id} has not finished`);
+        return yield* output.pending(context.token.id);
     }
     return yield* decodeUpscaleImage(response);
 });

package/dist/protocols/xai-images.js

@@ -60,7 +60,8 @@ const decodeResponse = Effect.fn("XAIImages.decodeResponse")(function* (response
     if (images.length === 0)
         return yield* output.invalid(`${route.name} returned no images`);
     const usage = ProviderShared.isRecord(decoded.usage) ? decoded.usage : undefined;
-    // xAI reports image counts rather than tokens, seconds, or credits; the raw record stays in provider metadata.
+    // xAI reports a USD cost (`cost_in_usd_ticks`) rather than tokens, seconds, or credits; the raw record stays in
+    // provider metadata.
     return new ImageResponse({
         images,
         providerMetadata: usage === undefined ? undefined : { xai: { usage } },

package/dist/protocols/xai-video.js

@@ -84,7 +84,7 @@ const decodeResult = Effect.fn("XAIVideo.decodeResult")(function* (response, con
     const decoded = output.value;
     const status = yield* MediaProtocol.status(STATUS, decoded.status, output);
     if (status === "running")
-        return yield* output.invalid(`${route.name} request ${context.token.requestID} has not finished`);
+        return yield* output.pending(context.token.requestID);
     if (status === "failed") {
         const code = decoded.error?.code ?? undefined;
         const message = decoded.error?.message ?? undefined;

package/dist/protocols/zai-images.js

@@ -1,12 +1,12 @@
-import { Effect, Schema } from "effect";
+import { Duration, Effect, Schema } from "effect";
 import { ImageModel, ImageResponse } from "../image.js";
-import { Media } from "../media.js";
 import { MediaProtocol } from "../route/media-protocol.js";
 import { MediaRoute } from "../route/media.js";
 import { mergeJsonRecords } from "../schema/index.js";
 const route = MediaProtocol.identity({ id: "zai-images", name: "Z.ai Images", provider: "zai" });
 export const DEFAULT_BASE_URL = "https://api.z.ai/api/paas/v4";
 export const PATH = "/images/generations";
+const OUTPUT_RETENTION = Duration.days(30);
 // ---------------------------------------------------------------------------
 // 2. Response schema
 // ---------------------------------------------------------------------------
@@ -44,7 +44,7 @@ const decodeResponse = Effect.fn("ZAIImages.decodeResponse")(function* (response
     const filters = decoded.content_filter ?? [];
     return new ImageResponse({
         // Z.ai returns only URLs and no content type; the media type resolves when the asset is materialized.
-        images: decoded.data.map((item) => Media.url(item.url)),
+        images: yield* Effect.forEach(decoded.data, (item) => MediaProtocol.expiringUrl(item.url, OUTPUT_RETENTION)),
         // Z.ai reports applied content filters alongside a successful result; surface them instead of dropping them.
         notices: filters.length === 0
             ? undefined

package/dist/providers/azure.d.ts

@@ -166,8 +166,8 @@ declare const responsesRoute: Route<{
         readonly type: "image_generation_call";
         readonly status?: string | undefined;
         readonly result?: string | null | undefined;
-        readonly revised_prompt?: string | null | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly revised_prompt?: string | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -192,9 +192,9 @@ declare const responsesRoute: Route<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly partial_images?: number | undefined;
         readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly partial_images?: number | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
     } | {
@@ -506,8 +506,8 @@ export declare const routes: (Route<{
         readonly type: "image_generation_call";
         readonly status?: string | undefined;
         readonly result?: string | null | undefined;
-        readonly revised_prompt?: string | null | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly revised_prompt?: string | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -532,9 +532,9 @@ export declare const routes: (Route<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly partial_images?: number | undefined;
         readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly partial_images?: number | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
     } | {

package/dist/providers/cloudflare-ai-gateway.d.ts

@@ -172,8 +172,8 @@ export declare const responsesRoute: import("../route/client.js").Route<{
         readonly type: "image_generation_call";
         readonly status?: string | undefined;
         readonly result?: string | null | undefined;
-        readonly revised_prompt?: string | null | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly revised_prompt?: string | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -198,9 +198,9 @@ export declare const responsesRoute: import("../route/client.js").Route<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly partial_images?: number | undefined;
         readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly partial_images?: number | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
     } | {
@@ -1169,8 +1169,8 @@ export declare const routes: (import("../route/client.js").Route<{
         readonly type: "image_generation_call";
         readonly status?: string | undefined;
         readonly result?: string | null | undefined;
-        readonly revised_prompt?: string | null | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly revised_prompt?: string | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -1195,9 +1195,9 @@ export declare const routes: (import("../route/client.js").Route<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly partial_images?: number | undefined;
         readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly partial_images?: number | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
     } | {

package/dist/providers/openai.d.ts

@@ -264,8 +264,8 @@ export declare const routes: (Route<{
         readonly type: "image_generation_call";
         readonly status?: string | undefined;
         readonly result?: string | null | undefined;
-        readonly revised_prompt?: string | null | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
+        readonly revised_prompt?: string | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
@@ -290,9 +290,9 @@ export declare const routes: (Route<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly partial_images?: number | undefined;
         readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
+        readonly partial_images?: number | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
     } | {

package/dist/route/media-protocol.d.ts

@@ -142,6 +142,7 @@ export declare const identity: (input: {
         http: HttpContext;
         invalid: (message: string, cause?: unknown) => AIError;
         ended: (status: Exclude<Status, "queued" | "running" | "completed">, message: string) => AIError;
+        pending: (id: string) => AIError;
         contentPolicy: (message: string) => AIError;
     }, AIError, never>;
     decodeJson: <A>(schema: Schema.Codec<A, unknown>) => (response: HttpClientResponse.HttpClientResponse) => Effect.Effect<{
@@ -150,6 +151,7 @@ export declare const identity: (input: {
         http: HttpContext;
         invalid: (message: string, cause?: unknown) => AIError;
         ended: (status: Exclude<Status, "queued" | "running" | "completed">, message: string) => AIError;
+        pending: (id: string) => AIError;
         contentPolicy: (message: string) => AIError;
     }, AIError, never>;
     /** Decode a submission response into the token and first snapshot. */

package/dist/route/media-protocol.js

@@ -28,7 +28,8 @@ export const identity = (input) => {
     /**
      * Read a text body while retaining the original payload and HTTP context on every downstream error. `invalid` is a
      * malformed provider document; `ended` is a generation that reached a terminal status without output (`failed` is
-     * provider-side, `cancelled`/`expired` mean the result will never exist); `contentPolicy` is a moderated result.
+     * provider-side, `cancelled`/`expired` mean the result will never exist); `pending` is a `result()` read before the
+     * generation finished, which is caller misuse; `contentPolicy` is a moderated result.
      */
     const text = Effect.fn("MediaProtocol.text")(function* (response) {
         const http = context(response);
@@ -49,6 +50,13 @@ export const identity = (input) => {
                     ? new ProviderInternalError({ message, body, http })
                     : new InvalidRequestError({ message, body, http }),
             }),
+            pending: (id) => new AIError({
+                reason: new InvalidRequestError({
+                    message: `${input.name} generation ${id} has not finished; await it before reading the result`,
+                    body,
+                    http,
+                }),
+            }),
             contentPolicy: (message) => new AIError({ reason: new ContentPolicyError({ message, body, http }) }),
         };
     });
@@ -91,10 +99,9 @@ export const identity = (input) => {
 };
 /** Map a provider status string through the protocol's table; unknown values are an invalid provider document. */
 export const status = (table, raw, output) => {
-    const normalized = table[raw];
-    if (normalized === undefined)
+    if (!Object.hasOwn(table, raw))
         return Effect.fail(output.invalid(`Unknown generation status "${raw}"`));
-    return Effect.succeed(normalized);
+    return Effect.succeed(table[raw]);
 };
 /** A `url` asset whose provider-declared retention window starts now. */
 export const expiringUrl = (url, retention, options) => Clock.currentTimeMillis.pipe(Effect.map((now) => Media.url(url, { ...options, expiresAt: now + Duration.toMillis(retention) })));

package/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "0.0.0-dev-20180",
+  "version": "0.0.0-dev-20183",
   "name": "@opencode/ai",
   "type": "module",
   "license": "MIT",
@@ -34,7 +34,7 @@
   "devDependencies": {
     "@clack/prompts": "1.0.0-alpha.1",
     "@effect/platform-node": "4.0.0-rc.112",
-    "@opencode/http-recorder": "0.0.0-dev-20180",
+    "@opencode/http-recorder": "0.0.0-dev-20183",
     "@tsconfig/bun": "1.0.9",
     "@types/bun": "1.4.0",
     "@typescript/native-preview": "7.0.0-dev.20251207.1",
@@ -44,7 +44,7 @@
     "@aws-sdk/credential-providers": "3.1057.0",
     "@smithy/eventstream-codec": "4.2.14",
     "@smithy/util-utf8": "4.2.2",
-    "@opencode/schema": "0.0.0-dev-20180",
+    "@opencode/schema": "0.0.0-dev-20183",
     "aws4fetch": "1.0.20",
     "effect": "4.0.0-rc.112",
     "google-auth-library": "10.5.0"