@opencode-ai/ai 0.0.0-dev-17929 → 0.0.0-dev-17944

package/dist/protocols/index.d.ts

@@ -8,3 +8,4 @@ export * as OpenAICompatibleResponses from "./openai-compatible-responses.js";
 export * as OpenAIResponses from "./openai-responses.js";
 export * as OpenResponses from "./open-responses.js";
 export * as OpenResponsesChannel from "./open-responses-channel.js";
+export * as XAIResponses from "./xai-responses.js";

package/dist/protocols/index.js

@@ -8,3 +8,4 @@ export * as OpenAICompatibleResponses from "./openai-compatible-responses.js";
 export * as OpenAIResponses from "./openai-responses.js";
 export * as OpenResponses from "./open-responses.js";
 export * as OpenResponsesChannel from "./open-responses-channel.js";
+export * as XAIResponses from "./xai-responses.js";

package/dist/protocols/open-responses-channel.d.ts

@@ -7,11 +7,6 @@ export interface Options {
     readonly enabled?: (url: string) => boolean;
     readonly url?: (url: string) => string;
     readonly headers?: (headers: Headers.Headers) => Headers.Headers;
-    readonly driver?: (input: {
-        readonly request: Readonly<Record<string, unknown>>;
-        readonly message: string;
-        readonly base: WebSocketChannelDriver;
-    }) => WebSocketChannelDriver;
 }
 export interface Prepared {
     readonly http: HttpTransport.HttpPrepared<string>;

package/dist/protocols/open-responses-channel.js

@@ -4,6 +4,7 @@ import { Framing } from "../route/framing.js";
 import { HttpTransport, WebSocketTransport, } from "../route/transport/index.js";
 import * as ProviderShared from "./shared.js";
 import { OpenResponses } from "./open-responses.js";
+import { OpenResponsesContinuation } from "./open-responses-continuation.js";
 const WebSocketResponseCreate = Schema.StructWithRest(Schema.Struct({ type: Schema.tag("response.create") }), [
     Schema.Record(Schema.String, Schema.Unknown),
 ]);
@@ -87,7 +88,13 @@ export const transport = (options) => {
                         url: yield* WebSocketTransport.toWebSocketUrl(options.url?.(parts.url) ?? parts.url),
                         headers,
                         rotateAfterMs: options.rotateAfterMs,
-                        driver: options.driver?.({ request: create.request, message: create.message, base }) ?? base,
+                        driver: OpenResponsesContinuation.driver({
+                            id: options.id,
+                            name: options.name,
+                            request: create.request,
+                            message: create.message,
+                            base,
+                        }),
                     };
                 })
                 : undefined;

package/dist/protocols/{openai-responses-channel.d.ts → open-responses-continuation.d.ts}

@@ -7,6 +7,6 @@ export interface DriverInput {
     readonly base: WebSocketChannelDriver;
 }
 export declare const driver: (input: DriverInput) => WebSocketChannelDriver;
-export declare const OpenAIResponsesChannel: {
+export declare const OpenResponsesContinuation: {
     readonly driver: (input: DriverInput) => WebSocketChannelDriver;
 };

package/dist/protocols/{openai-responses-channel.js → open-responses-continuation.js}

@@ -2,7 +2,7 @@ import { AIError, TransportReason } from "../schema/index.js";
 import { Effect, Option, Schema } from "effect";
 import * as ProviderShared from "./shared.js";
 import { OpenResponses } from "./open-responses.js";
-const PROTOCOL = "openai-responses.websocket.v1";
+const PROTOCOL = "open-responses.websocket.v1";
 const VERSION = 1;
 const decodeEvent = Schema.decodeUnknownEffect(OpenResponses.protocol.stream.event);
 const checkpointValue = (checkpoint) => {
@@ -139,4 +139,4 @@ export const driver = (input) => {
         }),
     };
 };
-export const OpenAIResponsesChannel = { driver };
+export const OpenResponsesContinuation = { driver };

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

@@ -13,11 +13,11 @@ declare const MediaInput: Schema.Union<readonly [Schema.Struct<{
 }>, Schema.Struct<{
     readonly type: Schema.tag<"input_file">;
     readonly filename: Schema.String;
-    readonly file_data: Schema.String;
-    readonly mime_type: Schema.optional<Schema.String>;
+    readonly file_data: Schema.optional<Schema.String>;
+    readonly file_url: Schema.optional<Schema.String>;
 }>]>;
 export type MediaInput = Schema.Schema.Type<typeof MediaInput>;
-export declare const MessagePhase: Schema.Literals<readonly ["commentary", "final_answer"]>;
+export declare const MessagePhase: Schema.NullOr<Schema.Literals<readonly ["commentary", "final_answer"]>>;
 type MessagePhase = Schema.Schema.Type<typeof MessagePhase>;
 export declare const InputItem: Schema.Union<readonly [Schema.Struct<{
     readonly role: Schema.tag<"system">;
@@ -36,8 +36,8 @@ export declare const InputItem: Schema.Union<readonly [Schema.Struct<{
     }>, Schema.Struct<{
         readonly type: Schema.tag<"input_file">;
         readonly filename: Schema.String;
-        readonly file_data: Schema.String;
-        readonly mime_type: Schema.optional<Schema.String>;
+        readonly file_data: Schema.optional<Schema.String>;
+        readonly file_url: Schema.optional<Schema.String>;
     }>]>]>>;
 }>, Schema.Struct<{
     readonly type: Schema.tag<"message">;
@@ -47,7 +47,7 @@ export declare const InputItem: Schema.Union<readonly [Schema.Struct<{
         readonly type: Schema.tag<"output_text">;
         readonly text: Schema.String;
     }>>;
-    readonly phase: Schema.optionalKey<Schema.Literals<readonly ["commentary", "final_answer"]>>;
+    readonly phase: Schema.optionalKey<Schema.NullOr<Schema.Literals<readonly ["commentary", "final_answer"]>>>;
 }>, Schema.Struct<{
     readonly type: Schema.tag<"reasoning">;
     readonly id: Schema.optionalKey<Schema.String>;
@@ -77,8 +77,11 @@ export declare const InputItem: Schema.Union<readonly [Schema.Struct<{
     }>, Schema.Struct<{
         readonly type: Schema.tag<"input_file">;
         readonly filename: Schema.String;
-        readonly file_data: Schema.String;
-        readonly mime_type: Schema.optional<Schema.String>;
+        readonly file_data: Schema.optional<Schema.String>;
+        readonly file_url: Schema.optional<Schema.String>;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"input_video">;
+        readonly video_url: Schema.String;
     }>]>>]>;
 }>]>;
 type OpenResponsesInputItem = Schema.Schema.Type<typeof InputItem>;
@@ -129,8 +132,8 @@ export declare const coreFields: {
         }>, Schema.Struct<{
             readonly type: Schema.tag<"input_file">;
             readonly filename: Schema.String;
-            readonly file_data: Schema.String;
-            readonly mime_type: Schema.optional<Schema.String>;
+            readonly file_data: Schema.optional<Schema.String>;
+            readonly file_url: Schema.optional<Schema.String>;
         }>]>]>>;
     }>, Schema.Struct<{
         readonly type: Schema.tag<"message">;
@@ -140,7 +143,7 @@ export declare const coreFields: {
             readonly type: Schema.tag<"output_text">;
             readonly text: Schema.String;
         }>>;
-        readonly phase: Schema.optionalKey<Schema.Literals<readonly ["commentary", "final_answer"]>>;
+        readonly phase: Schema.optionalKey<Schema.NullOr<Schema.Literals<readonly ["commentary", "final_answer"]>>>;
     }>, Schema.Struct<{
         readonly type: Schema.tag<"reasoning">;
         readonly id: Schema.optionalKey<Schema.String>;
@@ -170,8 +173,11 @@ export declare const coreFields: {
         }>, Schema.Struct<{
             readonly type: Schema.tag<"input_file">;
             readonly filename: Schema.String;
-            readonly file_data: Schema.String;
-            readonly mime_type: Schema.optional<Schema.String>;
+            readonly file_data: Schema.optional<Schema.String>;
+            readonly file_url: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly type: Schema.tag<"input_video">;
+            readonly video_url: Schema.String;
         }>]>>]>;
     }>]>>;
     instructions: Schema.optional<Schema.String>;
@@ -239,8 +245,8 @@ declare const OpenResponsesBody: Schema.Struct<{
         }>, Schema.Struct<{
             readonly type: Schema.tag<"input_file">;
             readonly filename: Schema.String;
-            readonly file_data: Schema.String;
-            readonly mime_type: Schema.optional<Schema.String>;
+            readonly file_data: Schema.optional<Schema.String>;
+            readonly file_url: Schema.optional<Schema.String>;
         }>]>]>>;
     }>, Schema.Struct<{
         readonly type: Schema.tag<"message">;
@@ -250,7 +256,7 @@ declare const OpenResponsesBody: Schema.Struct<{
             readonly type: Schema.tag<"output_text">;
             readonly text: Schema.String;
         }>>;
-        readonly phase: Schema.optionalKey<Schema.Literals<readonly ["commentary", "final_answer"]>>;
+        readonly phase: Schema.optionalKey<Schema.NullOr<Schema.Literals<readonly ["commentary", "final_answer"]>>>;
     }>, Schema.Struct<{
         readonly type: Schema.tag<"reasoning">;
         readonly id: Schema.optionalKey<Schema.String>;
@@ -280,8 +286,11 @@ declare const OpenResponsesBody: Schema.Struct<{
         }>, Schema.Struct<{
             readonly type: Schema.tag<"input_file">;
             readonly filename: Schema.String;
-            readonly file_data: Schema.String;
-            readonly mime_type: Schema.optional<Schema.String>;
+            readonly file_data: Schema.optional<Schema.String>;
+            readonly file_url: Schema.optional<Schema.String>;
+        }>, Schema.Struct<{
+            readonly type: Schema.tag<"input_video">;
+            readonly video_url: Schema.String;
         }>]>>]>;
     }>]>>;
     readonly instructions: Schema.optional<Schema.String>;
@@ -433,7 +442,6 @@ export interface Extension {
         readonly media: ProviderShared.NormalizedMedia;
         readonly request: LLMRequest;
     }) => MediaInput | undefined;
-    readonly messagePhase?: (value: unknown) => MessagePhase | null | undefined;
 }
 export interface ParserState {
     readonly id: string;
@@ -443,7 +451,6 @@ export interface ParserState {
     readonly hasFunctionCall: boolean;
     readonly lifecycle: Lifecycle.State;
     readonly messageItems: ReadonlySet<string>;
-    readonly messagePhase: (value: unknown) => MessagePhase | null | undefined;
     readonly messagePhases: Readonly<Record<string, MessagePhase | null>>;
     readonly reasoningItems: Readonly<Record<string, ReasoningStreamItem>>;
     readonly store: boolean | undefined;
@@ -547,8 +554,8 @@ export declare const fromRequest: (request: LLMRequest) => Effect.Effect<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data: string;
-            readonly mime_type?: string | undefined;
+            readonly file_data?: string | undefined;
+            readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
             readonly text: string;
@@ -561,7 +568,7 @@ export declare const fromRequest: (request: LLMRequest) => Effect.Effect<{
         }[];
         readonly role: "assistant";
         readonly id?: string | undefined;
-        readonly phase?: "commentary" | "final_answer" | undefined;
+        readonly phase?: "commentary" | "final_answer" | null | undefined;
     } | {
         readonly type: "function_call";
         readonly name: string;
@@ -577,11 +584,14 @@ export declare const fromRequest: (request: LLMRequest) => Effect.Effect<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data: string;
-            readonly mime_type?: string | undefined;
+            readonly file_data?: string | undefined;
+            readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
             readonly text: string;
+        } | {
+            readonly type: "input_video";
+            readonly video_url: string;
         })[];
     })[];
     readonly model: string;
@@ -854,8 +864,8 @@ export declare const protocol: Protocol<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data: string;
-            readonly mime_type?: string | undefined;
+            readonly file_data?: string | undefined;
+            readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
             readonly text: string;
@@ -868,7 +878,7 @@ export declare const protocol: Protocol<{
         }[];
         readonly role: "assistant";
         readonly id?: string | undefined;
-        readonly phase?: "commentary" | "final_answer" | undefined;
+        readonly phase?: "commentary" | "final_answer" | null | undefined;
     } | {
         readonly type: "function_call";
         readonly name: string;
@@ -884,11 +894,14 @@ export declare const protocol: Protocol<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data: string;
-            readonly mime_type?: string | undefined;
+            readonly file_data?: string | undefined;
+            readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
             readonly text: string;
+        } | {
+            readonly type: "input_video";
+            readonly video_url: string;
         })[];
     })[];
     readonly model: string;
@@ -1022,8 +1035,8 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data: string;
-            readonly mime_type?: string | undefined;
+            readonly file_data?: string | undefined;
+            readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
             readonly text: string;
@@ -1036,7 +1049,7 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         }[];
         readonly role: "assistant";
         readonly id?: string | undefined;
-        readonly phase?: "commentary" | "final_answer" | undefined;
+        readonly phase?: "commentary" | "final_answer" | null | undefined;
     } | {
         readonly type: "function_call";
         readonly name: string;
@@ -1052,11 +1065,14 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data: string;
-            readonly mime_type?: string | undefined;
+            readonly file_data?: string | undefined;
+            readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
             readonly text: string;
+        } | {
+            readonly type: "input_video";
+            readonly video_url: string;
         })[];
     })[];
     readonly model: string;

package/dist/protocols/open-responses.js

@@ -25,8 +25,12 @@ const OpenResponsesInputImage = Schema.Struct({
 const OpenResponsesInputFile = Schema.Struct({
     type: Schema.tag("input_file"),
     filename: Schema.String,
-    file_data: Schema.String,
-    mime_type: Schema.optional(Schema.String),
+    file_data: Schema.optional(Schema.String),
+    file_url: Schema.optional(Schema.String),
+});
+const OpenResponsesInputVideo = Schema.Struct({
+    type: Schema.tag("input_video"),
+    video_url: Schema.String,
 });
 const MediaInput = Schema.Union([OpenResponsesInputImage, OpenResponsesInputFile]);
 const OpenResponsesInputContent = Schema.Union([OpenResponsesInputText, MediaInput]);
@@ -34,7 +38,12 @@ const OpenResponsesOutputText = Schema.Struct({
     type: Schema.tag("output_text"),
     text: Schema.String,
 });
-export const MessagePhase = Schema.Literals(["commentary", "final_answer"]);
+export const MessagePhase = Schema.NullOr(Schema.Literals(["commentary", "final_answer"]));
+const messagePhase = (value) => {
+    if (value === null || value === "commentary" || value === "final_answer")
+        return value;
+    return undefined;
+};
 const OpenResponsesReasoningSummaryText = Schema.Struct({
     type: Schema.tag("summary_text"),
     text: Schema.String,
@@ -56,6 +65,7 @@ const OpenResponsesFunctionCallOutputContent = Schema.Union([
     OpenResponsesInputText,
     OpenResponsesInputImage,
     OpenResponsesInputFile,
+    OpenResponsesInputVideo,
 ]);
 const OpenResponsesFunctionCallOutput = Schema.Union([
     Schema.String,
@@ -213,19 +223,6 @@ export const Event = Schema.StructWithRest(Schema.Struct({
     status_code: Schema.optional(Schema.Unknown),
     headers: Schema.optional(Schema.Unknown),
 }), [Schema.Record(Schema.String, Schema.Unknown)]);
-const RefusalEvent = Schema.Union([
-    Schema.Struct({
-        type: Schema.tag("response.refusal.delta"),
-        item_id: Schema.String,
-        delta: Schema.String,
-    }),
-    Schema.Struct({
-        type: Schema.tag("response.refusal.done"),
-        item_id: Schema.String,
-        refusal: Schema.String,
-    }),
-]);
-const isRefusalEvent = Schema.is(RefusalEvent);
 const BASE = { id: ADAPTER, name: NAME };
 // =============================================================================
 // Request Lowering
@@ -279,36 +276,49 @@ const lowerReasoning = (part, providerMetadataKey) => {
         encrypted_content: encryptedContent,
     };
 };
-const hostedToolItemID = (part, providerMetadataKey) => {
-    return itemID(part.providerMetadata, providerMetadataKey);
-};
-const lowerMedia = Effect.fn("OpenResponses.lowerMedia")(function* (part, request, extension) {
+const lowerMedia = Effect.fn("OpenResponses.lowerMedia")(function* (part, request, extension, target) {
     const media = ProviderShared.normalizeMedia(part);
     const extended = extension.lowerMedia?.({ part, media, request });
     if (extended)
         return extended;
+    const url = typeof part.data === "string" && (part.data.startsWith("https://") || part.data.startsWith("http://"))
+        ? part.data
+        : undefined;
     if (!media.mime.startsWith("image/")) {
+        if (target === "tool-result" && media.mime.startsWith("video/"))
+            return { type: "input_video", video_url: url ?? media.dataUrl };
         return {
             type: "input_file",
             filename: part.filename ?? (media.mime === "application/pdf" ? "document.pdf" : "file"),
-            file_data: media.dataUrl,
+            ...(url ? { file_url: url } : { file_data: media.base64 }),
         };
     }
-    return { type: "input_image", image_url: media.dataUrl };
+    return { type: "input_image", image_url: url ?? media.dataUrl };
 });
 const lowerUserContent = Effect.fnUntraced(function* (part, request, extension) {
     if (part.type === "text")
         return { type: "input_text", text: part.text };
     if (part.type === "media")
-        return yield* lowerMedia(part, request, extension);
+        return yield* lowerMessageMedia(part, request, extension);
     return yield* ProviderShared.unsupportedContent(extension.name, "user", ["text", "media"]);
 });
+const lowerMessageMedia = Effect.fnUntraced(function* (part, request, extension) {
+    const lowered = yield* lowerMedia(part, request, extension, "message");
+    if (lowered.type === "input_video")
+        return yield* ProviderShared.invalidRequest(`${extension.name} user messages do not support input_video`);
+    return lowered;
+});
 // Tool results may carry structured text, images, and files. Keep media as provider-native
 // content instead of JSON-stringifying base64 into a prompt string.
 const lowerToolResultContentItem = Effect.fnUntraced(function* (item, request, extension) {
     if (item.type === "text")
         return { type: "input_text", text: item.text };
-    return yield* lowerMedia({ type: "media", mediaType: item.mime, data: item.uri, filename: item.name }, request, extension);
+    return yield* lowerMedia({ type: "media", mediaType: item.mime, data: item.uri, filename: item.name }, request, extension, "tool-result");
+});
+const lowerHostedToolResultContentItem = Effect.fnUntraced(function* (item, request, extension) {
+    if (item.type === "text")
+        return { type: "input_text", text: item.text };
+    return yield* lowerMessageMedia({ type: "media", mediaType: item.mime, data: item.uri, filename: item.name }, request, extension);
 });
 const lowerToolResultOutput = Effect.fnUntraced(function* (part, request, extension) {
     // Text/json/error results are encoded as a plain string for backward
@@ -350,7 +360,7 @@ const lowerMessages = Effect.fn("OpenResponses.lowerMessages")(function* (reques
                 const groups = content.reduce((groups, part) => {
                     const metadata = part.providerMetadata?.[providerMetadataKey];
                     const id = itemID(part.providerMetadata, providerMetadataKey);
-                    const phase = ProviderShared.isRecord(metadata) ? messagePhase(metadata.phase, extension) : undefined;
+                    const phase = ProviderShared.isRecord(metadata) ? messagePhase(metadata.phase) : undefined;
                     const group = groups.at(-1);
                     if (group && group.id === id && group.phase === phase)
                         group.parts.push(part);
@@ -403,18 +413,18 @@ const lowerMessages = Effect.fn("OpenResponses.lowerMessages")(function* (reques
                 }
                 if (part.type === "tool-result" && part.providerExecuted === true) {
                     flushText();
-                    const itemID = hostedToolItemID(part, providerMetadataKey);
-                    if (store !== false && itemID && !hostedToolReferences.has(itemID))
-                        input.push({ type: "item_reference", id: itemID });
+                    const id = itemID(part.providerMetadata, providerMetadataKey);
+                    if (store !== false && id && !hostedToolReferences.has(id))
+                        input.push({ type: "item_reference", id });
                     if (store === false && part.result.type === "content") {
                         const content = part.result.value;
                         input.push({
                             role: "user",
-                            content: yield* Effect.forEach(content, (item) => lowerToolResultContentItem(item, request, extension)),
+                            content: yield* Effect.forEach(content, (item) => lowerHostedToolResultContentItem(item, request, extension)),
                         });
                     }
-                    if (itemID)
-                        hostedToolReferences.add(itemID);
+                    if (id)
+                        hostedToolReferences.add(id);
                     continue;
                 }
                 return yield* ProviderShared.unsupportedContent(extension.name, "assistant", [
@@ -598,18 +608,17 @@ const reasoningMetadata = (state, item) => providerMetadata(state, { itemId: ite
 // best-effort, not guaranteed.
 const onOutputItemAdded = (state, event) => {
     const item = event.item;
-    if (item?.type === "message" && item.id)
+    if (item?.type === "message" && item.id) {
+        const phase = messagePhase(item.phase);
         return [
             {
                 ...state,
                 messageItems: new Set([...state.messageItems, item.id]),
-                messagePhases: (() => {
-                    const phase = state.messagePhase(item.phase);
-                    return phase === undefined ? state.messagePhases : { ...state.messagePhases, [item.id]: phase };
-                })(),
+                messagePhases: phase === undefined ? state.messagePhases : { ...state.messagePhases, [item.id]: phase },
             },
             NO_EVENTS,
         ];
+    }
     if (item && isReasoningItem(item)) {
         const events = [];
         return [
@@ -731,7 +740,7 @@ const onOutputItemDone = Effect.fn("OpenResponses.onOutputItemDone")(function* (
     if (!item)
         return [state, NO_EVENTS];
     if (item.type === "message" && item.id) {
-        const itemPhase = state.messagePhase(item.phase);
+        const itemPhase = messagePhase(item.phase);
         const phase = itemPhase === undefined ? state.messagePhases[item.id] : itemPhase;
         const events = [];
         const messageItems = new Set(state.messageItems);
@@ -822,22 +831,26 @@ const onResponseFinish = Effect.fn("OpenResponses.onResponseFinish")(function* (
     });
     return [{ ...state, lifecycle, hasFunctionCall, tools: pending.tools }, events];
 });
-// Build a single human-readable message from whatever the provider supplied.
+// Build the prettiest summary available from whatever the provider supplied.
 // When both code and message are present, prefix the code so consumers see
 // the failure mode (e.g. `rate_limit_exceeded: Slow down`) instead of just
 // the bare message — production rate limits and context-length failures used
-// to be indistinguishable from generic stream drops.
-const providerErrorMessage = (event, fallback) => {
-    const nested = event.error ?? event.response?.error ?? undefined;
+// to be indistinguishable from generic stream drops. Returns undefined when
+// the payload carries no usable summary.
+const providerErrorMessage = (event, nested) => {
     const message = event.message || nested?.message || undefined;
     const code = event.code || nested?.code || undefined;
     if (message && code)
         return `${code}: ${message}`;
-    return message || code || fallback;
+    return message || code;
 };
 export const providerFailure = (id, event, fallback) => {
-    const code = event.code || event.error?.code || event.response?.error?.code || undefined;
-    const message = providerErrorMessage(event, fallback);
+    const nested = event.error ?? event.response?.error ?? undefined;
+    const code = event.code || nested?.code || undefined;
+    // Keep the full raw payload on the error even when the message is a summary.
+    const body = JSON.stringify(nested ?? event) ?? "";
+    const summary = providerErrorMessage(event, nested);
+    const message = summary ?? (body === "{}" ? fallback : body);
     const status = typeof event.status === "number"
         ? event.status
         : typeof event.status_code === "number"
@@ -846,7 +859,8 @@ export const providerFailure = (id, event, fallback) => {
     return new AIError({
         module: id,
         method: "stream",
-        reason: classifyProviderFailure({ message, code, status }),
+        body,
+        reason: classifyProviderFailure({ message, code, status, rawBody: body }),
     });
 };
 const providerError = (state, event, fallback) => providerFailure(state.id, event, fallback);
@@ -859,22 +873,18 @@ export const step = (state, event) => {
             : onOutputTextDone(state, event, event.item_id));
     }
     if (event.type === "response.refusal.delta" || event.type === "response.refusal.done") {
-        if (!isRefusalEvent(event))
+        const value = event.type === "response.refusal.delta" ? event.delta : event.refusal;
+        if (!event.item_id || typeof value !== "string")
             return ProviderShared.eventError(state.id, `${event.type} is malformed`);
         return Effect.succeed(event.type === "response.refusal.delta"
             ? onOutputTextDelta(state, event, event.item_id)
-            : onOutputTextDone(state, { ...event, text: event.refusal }, event.item_id));
+            : onOutputTextDone(state, { ...event, text: value }, event.item_id));
     }
     if (event.type === "response.reasoning.delta" || event.type === "response.reasoning_summary_text.delta") {
         if (!event.item_id)
             return ProviderShared.eventError(state.id, `${event.type} is missing item_id`);
         return Effect.succeed(onReasoningDelta(state, event, event.item_id));
     }
-    if (event.type === "response.reasoning.done" || event.type === "response.reasoning_summary_text.done") {
-        if (!event.item_id)
-            return ProviderShared.eventError(state.id, `${event.type} is missing item_id`);
-        return Effect.succeed(onReasoningDone(state, event));
-    }
     if (event.type === "response.reasoning_summary_part.added")
         return event.item_id
             ? Effect.succeed(onReasoningSummaryPartAdded(state, event))
@@ -918,16 +928,10 @@ export const initial = (request, extension = BASE) => ({
     tools: ToolStream.empty(),
     lifecycle: Lifecycle.initial(),
     messageItems: new Set(),
-    messagePhase: (value) => messagePhase(value, extension),
     messagePhases: {},
     reasoningItems: {},
     store: OpenResponsesOptions.resolve(request).store,
 });
-const messagePhase = (value, extension) => {
-    if (value === "commentary" || value === "final_answer")
-        return value;
-    return extension.messagePhase?.(value);
-};
 export const protocol = Protocol.make({
     id: ADAPTER,
     body: {

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

@@ -31,8 +31,8 @@ export declare const route: Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data: string;
-            readonly mime_type?: string | undefined;
+            readonly file_data?: string | undefined;
+            readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
             readonly text: string;
@@ -45,7 +45,7 @@ export declare const route: Route<{
         }[];
         readonly role: "assistant";
         readonly id?: string | undefined;
-        readonly phase?: "commentary" | "final_answer" | undefined;
+        readonly phase?: "commentary" | "final_answer" | null | undefined;
     } | {
         readonly type: "function_call";
         readonly name: string;
@@ -61,11 +61,14 @@ export declare const route: Route<{
         } | {
             readonly type: "input_file";
             readonly filename: string;
-            readonly file_data: string;
-            readonly mime_type?: string | undefined;
+            readonly file_data?: string | undefined;
+            readonly file_url?: string | undefined;
         } | {
             readonly type: "input_text";
             readonly text: string;
+        } | {
+            readonly type: "input_video";
+            readonly video_url: string;
         })[];
     })[];
     readonly model: string;