@opencode-ai/ai 0.0.0-dev-18049 → 0.0.0-dev-18052

package/dist/protocols/anthropic-messages.d.ts

@@ -50,26 +50,50 @@ export declare const AnthropicMessagesBody: Schema.Struct<{
             }>>;
         }>, Schema.Struct<{
             readonly type: Schema.tag<"image">;
-            readonly source: Schema.Struct<{
+            readonly source: Schema.Union<readonly [Schema.Struct<{
                 readonly type: Schema.tag<"base64">;
                 readonly media_type: Schema.String;
                 readonly data: Schema.String;
-            }>;
+            }>, Schema.Struct<{
+                readonly type: Schema.tag<"url">;
+                readonly url: Schema.String;
+            }>, Schema.Struct<{
+                readonly type: Schema.tag<"file">;
+                readonly file_id: Schema.String;
+            }>]>;
             readonly cache_control: Schema.optional<Schema.Struct<{
                 readonly type: Schema.tag<"ephemeral">;
                 readonly ttl: Schema.optional<Schema.Literals<readonly ["5m", "1h"]>>;
             }>>;
+            readonly transformations: Schema.optional<Schema.Struct<{
+                readonly oversized_image: Schema.optional<Schema.Literals<readonly ["downsize", "error"]>>;
+            }>>;
         }>, Schema.Struct<{
             readonly type: Schema.tag<"document">;
-            readonly source: Schema.Struct<{
+            readonly source: Schema.Union<readonly [Schema.Struct<{
                 readonly type: Schema.tag<"base64">;
                 readonly media_type: Schema.Literal<"application/pdf">;
                 readonly data: Schema.String;
-            }>;
+            }>, Schema.Struct<{
+                readonly type: Schema.tag<"text">;
+                readonly media_type: Schema.Literal<"text/plain">;
+                readonly data: Schema.String;
+            }>, Schema.Struct<{
+                readonly type: Schema.tag<"url">;
+                readonly url: Schema.String;
+            }>, Schema.Struct<{
+                readonly type: Schema.tag<"file">;
+                readonly file_id: Schema.String;
+            }>]>;
             readonly cache_control: Schema.optional<Schema.Struct<{
                 readonly type: Schema.tag<"ephemeral">;
                 readonly ttl: Schema.optional<Schema.Literals<readonly ["5m", "1h"]>>;
             }>>;
+            readonly title: Schema.optional<Schema.String>;
+            readonly context: Schema.optional<Schema.String>;
+            readonly citations: Schema.optional<Schema.Struct<{
+                readonly enabled: Schema.Boolean;
+            }>>;
         }>, Schema.Struct<{
             readonly type: Schema.tag<"tool_result">;
             readonly tool_use_id: Schema.String;
@@ -82,26 +106,50 @@ export declare const AnthropicMessagesBody: Schema.Struct<{
                 }>>;
             }>, Schema.Struct<{
                 readonly type: Schema.tag<"image">;
-                readonly source: Schema.Struct<{
+                readonly source: Schema.Union<readonly [Schema.Struct<{
                     readonly type: Schema.tag<"base64">;
                     readonly media_type: Schema.String;
                     readonly data: Schema.String;
-                }>;
+                }>, Schema.Struct<{
+                    readonly type: Schema.tag<"url">;
+                    readonly url: Schema.String;
+                }>, Schema.Struct<{
+                    readonly type: Schema.tag<"file">;
+                    readonly file_id: Schema.String;
+                }>]>;
                 readonly cache_control: Schema.optional<Schema.Struct<{
                     readonly type: Schema.tag<"ephemeral">;
                     readonly ttl: Schema.optional<Schema.Literals<readonly ["5m", "1h"]>>;
                 }>>;
+                readonly transformations: Schema.optional<Schema.Struct<{
+                    readonly oversized_image: Schema.optional<Schema.Literals<readonly ["downsize", "error"]>>;
+                }>>;
             }>, Schema.Struct<{
                 readonly type: Schema.tag<"document">;
-                readonly source: Schema.Struct<{
+                readonly source: Schema.Union<readonly [Schema.Struct<{
                     readonly type: Schema.tag<"base64">;
                     readonly media_type: Schema.Literal<"application/pdf">;
                     readonly data: Schema.String;
-                }>;
+                }>, Schema.Struct<{
+                    readonly type: Schema.tag<"text">;
+                    readonly media_type: Schema.Literal<"text/plain">;
+                    readonly data: Schema.String;
+                }>, Schema.Struct<{
+                    readonly type: Schema.tag<"url">;
+                    readonly url: Schema.String;
+                }>, Schema.Struct<{
+                    readonly type: Schema.tag<"file">;
+                    readonly file_id: Schema.String;
+                }>]>;
                 readonly cache_control: Schema.optional<Schema.Struct<{
                     readonly type: Schema.tag<"ephemeral">;
                     readonly ttl: Schema.optional<Schema.Literals<readonly ["5m", "1h"]>>;
                 }>>;
+                readonly title: Schema.optional<Schema.String>;
+                readonly context: Schema.optional<Schema.String>;
+                readonly citations: Schema.optional<Schema.Struct<{
+                    readonly enabled: Schema.Boolean;
+                }>>;
             }>]>>]>;
             readonly is_error: Schema.optional<Schema.Boolean>;
             readonly cache_control: Schema.optional<Schema.Struct<{
@@ -232,22 +280,46 @@ export declare const protocol: Protocol<{
                 readonly type: "base64";
                 readonly media_type: string;
                 readonly data: string;
+            } | {
+                readonly type: "url";
+                readonly url: string;
+            } | {
+                readonly type: "file";
+                readonly file_id: string;
             };
             readonly cache_control?: {
                 readonly type: "ephemeral";
                 readonly ttl?: "1h" | "5m" | undefined;
             } | undefined;
+            readonly transformations?: {
+                readonly oversized_image?: "error" | "downsize" | undefined;
+            } | undefined;
         } | {
             readonly type: "document";
             readonly source: {
                 readonly type: "base64";
                 readonly media_type: "application/pdf";
                 readonly data: string;
+            } | {
+                readonly type: "text";
+                readonly media_type: "text/plain";
+                readonly data: string;
+            } | {
+                readonly type: "url";
+                readonly url: string;
+            } | {
+                readonly type: "file";
+                readonly file_id: string;
             };
+            readonly title?: string | undefined;
+            readonly context?: string | undefined;
             readonly cache_control?: {
                 readonly type: "ephemeral";
                 readonly ttl?: "1h" | "5m" | undefined;
             } | undefined;
+            readonly citations?: {
+                readonly enabled: boolean;
+            } | undefined;
         } | {
             readonly type: "tool_result";
             readonly content: string | readonly ({
@@ -263,22 +335,46 @@ export declare const protocol: Protocol<{
                     readonly type: "base64";
                     readonly media_type: string;
                     readonly data: string;
+                } | {
+                    readonly type: "url";
+                    readonly url: string;
+                } | {
+                    readonly type: "file";
+                    readonly file_id: string;
                 };
                 readonly cache_control?: {
                     readonly type: "ephemeral";
                     readonly ttl?: "1h" | "5m" | undefined;
                 } | undefined;
+                readonly transformations?: {
+                    readonly oversized_image?: "error" | "downsize" | undefined;
+                } | undefined;
             } | {
                 readonly type: "document";
                 readonly source: {
                     readonly type: "base64";
                     readonly media_type: "application/pdf";
                     readonly data: string;
+                } | {
+                    readonly type: "text";
+                    readonly media_type: "text/plain";
+                    readonly data: string;
+                } | {
+                    readonly type: "url";
+                    readonly url: string;
+                } | {
+                    readonly type: "file";
+                    readonly file_id: string;
                 };
+                readonly title?: string | undefined;
+                readonly context?: string | undefined;
                 readonly cache_control?: {
                     readonly type: "ephemeral";
                     readonly ttl?: "1h" | "5m" | undefined;
                 } | undefined;
+                readonly citations?: {
+                    readonly enabled: boolean;
+                } | undefined;
             })[];
             readonly tool_use_id: string;
             readonly cache_control?: {
@@ -477,22 +573,46 @@ export declare const route: Route<{
                 readonly type: "base64";
                 readonly media_type: string;
                 readonly data: string;
+            } | {
+                readonly type: "url";
+                readonly url: string;
+            } | {
+                readonly type: "file";
+                readonly file_id: string;
             };
             readonly cache_control?: {
                 readonly type: "ephemeral";
                 readonly ttl?: "1h" | "5m" | undefined;
             } | undefined;
+            readonly transformations?: {
+                readonly oversized_image?: "error" | "downsize" | undefined;
+            } | undefined;
         } | {
             readonly type: "document";
             readonly source: {
                 readonly type: "base64";
                 readonly media_type: "application/pdf";
                 readonly data: string;
+            } | {
+                readonly type: "text";
+                readonly media_type: "text/plain";
+                readonly data: string;
+            } | {
+                readonly type: "url";
+                readonly url: string;
+            } | {
+                readonly type: "file";
+                readonly file_id: string;
             };
+            readonly title?: string | undefined;
+            readonly context?: string | undefined;
             readonly cache_control?: {
                 readonly type: "ephemeral";
                 readonly ttl?: "1h" | "5m" | undefined;
             } | undefined;
+            readonly citations?: {
+                readonly enabled: boolean;
+            } | undefined;
         } | {
             readonly type: "tool_result";
             readonly content: string | readonly ({
@@ -508,22 +628,46 @@ export declare const route: Route<{
                     readonly type: "base64";
                     readonly media_type: string;
                     readonly data: string;
+                } | {
+                    readonly type: "url";
+                    readonly url: string;
+                } | {
+                    readonly type: "file";
+                    readonly file_id: string;
                 };
                 readonly cache_control?: {
                     readonly type: "ephemeral";
                     readonly ttl?: "1h" | "5m" | undefined;
                 } | undefined;
+                readonly transformations?: {
+                    readonly oversized_image?: "error" | "downsize" | undefined;
+                } | undefined;
             } | {
                 readonly type: "document";
                 readonly source: {
                     readonly type: "base64";
                     readonly media_type: "application/pdf";
                     readonly data: string;
+                } | {
+                    readonly type: "text";
+                    readonly media_type: "text/plain";
+                    readonly data: string;
+                } | {
+                    readonly type: "url";
+                    readonly url: string;
+                } | {
+                    readonly type: "file";
+                    readonly file_id: string;
                 };
+                readonly title?: string | undefined;
+                readonly context?: string | undefined;
                 readonly cache_control?: {
                     readonly type: "ephemeral";
                     readonly ttl?: "1h" | "5m" | undefined;
                 } | undefined;
+                readonly citations?: {
+                    readonly enabled: boolean;
+                } | undefined;
             })[];
             readonly tool_use_id: string;
             readonly cache_control?: {

package/dist/protocols/anthropic-messages.js

@@ -1,3 +1,4 @@
+import { Buffer } from "node:buffer";
 import { Effect, Schema } from "effect";
 import { Tool } from "@opencode-ai/schema/tool";
 import { Route } from "../route/client.js";
@@ -40,23 +41,57 @@ const AnthropicTextBlock = Schema.Struct({
     text: Schema.String,
     cache_control: Schema.optional(AnthropicCacheControl),
 });
+// SDK: Base64ImageSource:201 {type:"base64", media_type:"image/jpeg"|... , data}, URLImageSource:3817 {type:"url", url}, FileImageSource:2350 {type:"file", file_id}
+// SDK: ImageBlockParam:2356 {source: Base64|URL|File, cache_control, transformations:2381 {oversized_image?}}
+const AnthropicBase64ImageSource = Schema.Struct({
+    type: Schema.tag("base64"),
+    media_type: Schema.String,
+    data: Schema.String,
+});
+const AnthropicURLImageSource = Schema.Struct({ type: Schema.tag("url"), url: Schema.String });
+const AnthropicFileImageSource = Schema.Struct({ type: Schema.tag("file"), file_id: Schema.String });
+const AnthropicImageSource = Schema.Union([
+    AnthropicBase64ImageSource,
+    AnthropicURLImageSource,
+    AnthropicFileImageSource,
+]);
+const AnthropicImageTransformations = Schema.Struct({
+    oversized_image: Schema.optional(Schema.Literals(["downsize", "error"])),
+});
 const AnthropicImageBlock = Schema.Struct({
     type: Schema.tag("image"),
-    source: Schema.Struct({
-        type: Schema.tag("base64"),
-        media_type: Schema.String,
-        data: Schema.String,
-    }),
+    source: AnthropicImageSource,
     cache_control: Schema.optional(AnthropicCacheControl),
+    transformations: Schema.optional(AnthropicImageTransformations),
+});
+// SDK: Base64PDFSource:209 {type:"base64", media_type:"application/pdf", data}, PlainTextSource:2716 {type:"text", media_type:"text/plain", data},
+// SDK: URLPDFSource:3823 {type:"url", url}, FileDocumentSource:2344 {type:"file", file_id}, ContentBlockSource:2266 {type:"content", content}
+// SDK: DocumentBlockParam:2297 {source: 5-way union, cache_control, citations, context, title}
+const AnthropicBase64PDFSource = Schema.Struct({
+    type: Schema.tag("base64"),
+    media_type: Schema.Literal("application/pdf"),
+    data: Schema.String,
+});
+const AnthropicPlainTextSource = Schema.Struct({
+    type: Schema.tag("text"),
+    media_type: Schema.Literal("text/plain"),
+    data: Schema.String,
 });
+const AnthropicURLPDFSource = Schema.Struct({ type: Schema.tag("url"), url: Schema.String });
+const AnthropicFileDocumentSource = Schema.Struct({ type: Schema.tag("file"), file_id: Schema.String });
+const AnthropicDocumentSource = Schema.Union([
+    AnthropicBase64PDFSource,
+    AnthropicPlainTextSource,
+    AnthropicURLPDFSource,
+    AnthropicFileDocumentSource,
+]);
 const AnthropicDocumentBlock = Schema.Struct({
     type: Schema.tag("document"),
-    source: Schema.Struct({
-        type: Schema.tag("base64"),
-        media_type: Schema.Literal("application/pdf"),
-        data: Schema.String,
-    }),
+    source: AnthropicDocumentSource,
     cache_control: Schema.optional(AnthropicCacheControl),
+    title: Schema.optional(Schema.String),
+    context: Schema.optional(Schema.String),
+    citations: Schema.optional(Schema.Struct({ enabled: Schema.Boolean })),
 });
 const AnthropicThinkingBlock = Schema.Struct({
     type: Schema.tag("thinking"),
@@ -325,7 +360,149 @@ const lowerServerToolResult = Effect.fn("AnthropicMessages.lowerServerToolResult
     const payload = part.providerMetadata?.anthropic?.["result"] ?? part.result.value;
     return { type: wireType, tool_use_id: scrubToolCallID(part.id), content: payload };
 });
-const lowerMedia = Effect.fn("AnthropicMessages.lowerMedia")(function* (part) {
+const fileIdFromMetadata = (metadata) => {
+    if (!ProviderShared.isRecord(metadata))
+        return undefined;
+    const anthropic = metadata.anthropic;
+    if (ProviderShared.isRecord(anthropic)) {
+        if (typeof anthropic.file_id === "string")
+            return anthropic.file_id;
+        if (typeof anthropic.fileId === "string")
+            return anthropic.fileId;
+    }
+    if (typeof metadata.file_id === "string")
+        return metadata.file_id;
+    if (typeof metadata.fileId === "string")
+        return metadata.fileId;
+    return undefined;
+};
+const transformationsFromMetadata = (metadata) => {
+    if (!ProviderShared.isRecord(metadata))
+        return undefined;
+    const anthropic = ProviderShared.isRecord(metadata.anthropic) ? metadata.anthropic : undefined;
+    const raw = anthropic?.transformations ?? metadata.transformations;
+    if (ProviderShared.isRecord(raw)) {
+        const value = raw.oversized_image;
+        if (value === "downsize" || value === "error")
+            return { oversized_image: value };
+    }
+    if (anthropic && (anthropic.oversized_image === "downsize" || anthropic.oversized_image === "error"))
+        return { oversized_image: anthropic.oversized_image };
+    return undefined;
+};
+const documentTitleFromPart = (part) => {
+    if (ProviderShared.isRecord(part.metadata)) {
+        const anthropic = part.metadata.anthropic;
+        if (ProviderShared.isRecord(anthropic) && typeof anthropic.title === "string")
+            return anthropic.title;
+        if (typeof part.metadata.title === "string")
+            return part.metadata.title;
+    }
+    if (typeof part.filename === "string" && part.filename.length > 0)
+        return part.filename;
+    return undefined;
+};
+const documentContextFromMetadata = (metadata) => {
+    if (!ProviderShared.isRecord(metadata))
+        return undefined;
+    const anthropic = ProviderShared.isRecord(metadata.anthropic) ? metadata.anthropic : undefined;
+    if (anthropic && typeof anthropic.context === "string")
+        return anthropic.context;
+    if (typeof metadata.context === "string")
+        return metadata.context;
+    return undefined;
+};
+const citationsFromMetadata = (metadata) => {
+    if (!ProviderShared.isRecord(metadata))
+        return undefined;
+    const raw = ProviderShared.isRecord(metadata.anthropic)
+        ? (metadata.anthropic.citations ?? metadata.citations)
+        : metadata.citations;
+    if (ProviderShared.isRecord(raw) && typeof raw.enabled === "boolean")
+        return { enabled: raw.enabled };
+    return undefined;
+};
+const isHttpUrl = (value) => /^https?:\/\//i.test(value.trim());
+const lowerMedia = Effect.fn("AnthropicMessages.lowerMedia")(function* (part, breakpoints) {
+    const mime = part.mediaType.toLowerCase();
+    const cacheControlValue = breakpoints ? cacheControl(breakpoints, part.cache) : undefined;
+    const fileId = fileIdFromMetadata(part.metadata);
+    // SDK file sources: FileImageSource:2350 / FileDocumentSource:2344 {type:"file", file_id}
+    if (fileId) {
+        if (mime.startsWith("image/"))
+            return {
+                type: "image",
+                source: { type: "file", file_id: fileId },
+                ...(cacheControlValue === undefined ? {} : { cache_control: cacheControlValue }),
+                ...(transformationsFromMetadata(part.metadata) === undefined
+                    ? {}
+                    : { transformations: transformationsFromMetadata(part.metadata) }),
+            };
+        return {
+            type: "document",
+            source: { type: "file", file_id: fileId },
+            ...(cacheControlValue === undefined ? {} : { cache_control: cacheControlValue }),
+            ...(documentTitleFromPart(part) === undefined ? {} : { title: documentTitleFromPart(part) }),
+            ...(documentContextFromMetadata(part.metadata) === undefined
+                ? {}
+                : { context: documentContextFromMetadata(part.metadata) }),
+            ...(citationsFromMetadata(part.metadata) === undefined
+                ? {}
+                : { citations: citationsFromMetadata(part.metadata) }),
+        };
+    }
+    const rawString = typeof part.data === "string" ? part.data.trim() : undefined;
+    // SDK URL sources: URLImageSource:3817 / URLPDFSource:3823 {type:"url", url}
+    if (rawString && isHttpUrl(rawString) && !rawString.startsWith("data:")) {
+        if (mime.startsWith("image/"))
+            return {
+                type: "image",
+                source: { type: "url", url: rawString },
+                ...(cacheControlValue === undefined ? {} : { cache_control: cacheControlValue }),
+                ...(transformationsFromMetadata(part.metadata) === undefined
+                    ? {}
+                    : { transformations: transformationsFromMetadata(part.metadata) }),
+            };
+        if (mime === "application/pdf")
+            return {
+                type: "document",
+                source: { type: "url", url: rawString },
+                ...(cacheControlValue === undefined ? {} : { cache_control: cacheControlValue }),
+                ...(documentTitleFromPart(part) === undefined ? {} : { title: documentTitleFromPart(part) }),
+                ...(documentContextFromMetadata(part.metadata) === undefined
+                    ? {}
+                    : { context: documentContextFromMetadata(part.metadata) }),
+                ...(citationsFromMetadata(part.metadata) === undefined
+                    ? {}
+                    : { citations: citationsFromMetadata(part.metadata) }),
+            };
+    }
+    // SDK PlainTextSource:2716 {type:"text", media_type:"text/plain", data}
+    if (mime === "text/plain") {
+        const textData = typeof part.data !== "string"
+            ? Buffer.from(part.data).toString("utf8")
+            : part.data.startsWith("data:")
+                ? (() => {
+                    const comma = part.data.indexOf(",");
+                    const payload = comma >= 0 ? part.data.slice(comma + 1) : part.data;
+                    return part.data.includes(";base64")
+                        ? Buffer.from(payload, "base64").toString("utf8")
+                        : decodeURIComponent(payload);
+                })()
+                : part.data;
+        return {
+            type: "document",
+            source: { type: "text", media_type: "text/plain", data: textData },
+            ...(cacheControlValue === undefined ? {} : { cache_control: cacheControlValue }),
+            ...(documentTitleFromPart(part) === undefined ? {} : { title: documentTitleFromPart(part) }),
+            ...(documentContextFromMetadata(part.metadata) === undefined
+                ? {}
+                : { context: documentContextFromMetadata(part.metadata) }),
+            ...(citationsFromMetadata(part.metadata) === undefined
+                ? {}
+                : { citations: citationsFromMetadata(part.metadata) }),
+        };
+    }
     const media = ProviderShared.normalizeMedia(part);
     if (media.mime === "application/pdf")
         return {
@@ -335,6 +512,14 @@ const lowerMedia = Effect.fn("AnthropicMessages.lowerMedia")(function* (part) {
                 media_type: "application/pdf",
                 data: media.base64,
             },
+            ...(cacheControlValue === undefined ? {} : { cache_control: cacheControlValue }),
+            ...(documentTitleFromPart(part) === undefined ? {} : { title: documentTitleFromPart(part) }),
+            ...(documentContextFromMetadata(part.metadata) === undefined
+                ? {}
+                : { context: documentContextFromMetadata(part.metadata) }),
+            ...(citationsFromMetadata(part.metadata) === undefined
+                ? {}
+                : { citations: citationsFromMetadata(part.metadata) }),
         };
     if (!media.mime.startsWith("image/"))
         return yield* invalid(`Anthropic Messages does not support media type ${part.mediaType}`);
@@ -345,6 +530,10 @@ const lowerMedia = Effect.fn("AnthropicMessages.lowerMedia")(function* (part) {
             media_type: media.mime,
             data: media.base64,
         },
+        ...(cacheControlValue === undefined ? {} : { cache_control: cacheControlValue }),
+        ...(transformationsFromMetadata(part.metadata) === undefined
+            ? {}
+            : { transformations: transformationsFromMetadata(part.metadata) }),
     };
 });
 // Tool results may carry structured text, images, and documents. Keep media as provider-native
@@ -440,7 +629,7 @@ const lowerMessages = Effect.fn("AnthropicMessages.lowerMessages")(function* (re
                     continue;
                 }
                 if (part.type === "media") {
-                    content.push(yield* lowerMedia(part));
+                    content.push(yield* lowerMedia(part, breakpoints));
                     continue;
                 }
                 return yield* ProviderShared.unsupportedContent("Anthropic Messages", "user", ["text", "media"]);

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

@@ -434,6 +434,7 @@ export declare const Event: Schema.StructWithRest<Schema.Struct<{
     readonly headers: Schema.optional<Schema.Unknown>;
 }>, readonly [Schema.$Record<Schema.String, Schema.Unknown>]>;
 export type Event = Schema.Schema.Type<typeof Event>;
+export type ItemKind = "message" | "reasoning" | "function-call" | "reference";
 export interface Extension {
     readonly id: string;
     readonly name: string;
@@ -442,6 +443,7 @@ export interface Extension {
         readonly media: ProviderShared.NormalizedMedia;
         readonly request: LLMRequest;
     }) => MediaInput | undefined;
+    readonly acceptsItemID?: (kind: ItemKind, id: string) => boolean;
 }
 export interface ParserState {
     readonly id: string;

package/dist/protocols/open-responses.js

@@ -245,26 +245,34 @@ export const lowerToolChoice = (protocolName, toolChoice) => ProviderShared.matc
     required: () => "required",
     tool: (toolName) => ({ type: "function", name: toolName }),
 });
+// Servers validate item ids on replayed history, and a malformed or oversized
+// id can fail an otherwise valid request. Only server-issued tokens are worth
+// resending; anything else is treated as absent so the item is resent without
+// an id (or skipped, for items that cannot be expressed without one).
+const ITEM_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
 const itemID = (providerMetadata, providerMetadataKey) => {
     const metadata = providerMetadata?.[providerMetadataKey];
-    return ProviderShared.isRecord(metadata) && typeof metadata.itemId === "string" && metadata.itemId.length > 0
+    return ProviderShared.isRecord(metadata) &&
+        typeof metadata.itemId === "string" &&
+        ITEM_ID_PATTERN.test(metadata.itemId)
         ? metadata.itemId
         : undefined;
 };
-const lowerToolCall = (part, providerMetadataKey) => {
+const acceptsItemID = (extension, kind, id) => id !== undefined && (extension.acceptsItemID?.(kind, id) ?? true);
+const lowerToolCall = (part, providerMetadataKey, extension) => {
     const id = itemID(part.providerMetadata, providerMetadataKey);
     return {
         type: "function_call",
-        ...(id ? { id } : {}),
+        ...(acceptsItemID(extension, "function-call", id) ? { id } : {}),
         call_id: part.id,
         name: part.name,
         arguments: ProviderShared.encodeJson(part.input),
     };
 };
-const lowerReasoning = (part, providerMetadataKey) => {
+const lowerReasoning = (part, providerMetadataKey, extension) => {
     const metadata = part.providerMetadata?.[providerMetadataKey];
     const id = itemID(part.providerMetadata, providerMetadataKey);
-    if (!ProviderShared.isRecord(metadata) || !id)
+    if (!ProviderShared.isRecord(metadata) || !acceptsItemID(extension, "reasoning", id))
         return undefined;
     const encryptedContent = typeof metadata.reasoningEncryptedContent === "string" || metadata.reasoningEncryptedContent === null
         ? metadata.reasoningEncryptedContent
@@ -359,7 +367,8 @@ const lowerMessages = Effect.fn("OpenResponses.lowerMessages")(function* (reques
                     return;
                 const groups = content.reduce((groups, part) => {
                     const metadata = part.providerMetadata?.[providerMetadataKey];
-                    const id = itemID(part.providerMetadata, providerMetadataKey);
+                    const rawID = itemID(part.providerMetadata, providerMetadataKey);
+                    const id = acceptsItemID(extension, "message", rawID) ? rawID : undefined;
                     const phase = ProviderShared.isRecord(metadata) ? messagePhase(metadata.phase) : undefined;
                     const group = groups.at(-1);
                     if (group && group.id === id && group.phase === phase)
@@ -384,7 +393,7 @@ const lowerMessages = Effect.fn("OpenResponses.lowerMessages")(function* (reques
                 }
                 if (part.type === "reasoning") {
                     flushText();
-                    const reasoning = lowerReasoning(part, providerMetadataKey);
+                    const reasoning = lowerReasoning(part, providerMetadataKey, extension);
                     if (!reasoning)
                         continue;
                     if (store !== false) {
@@ -408,14 +417,15 @@ const lowerMessages = Effect.fn("OpenResponses.lowerMessages")(function* (reques
                     flushText();
                     if (part.providerExecuted === true)
                         continue;
-                    input.push(lowerToolCall(part, providerMetadataKey));
+                    input.push(lowerToolCall(part, providerMetadataKey, extension));
                     continue;
                 }
                 if (part.type === "tool-result" && part.providerExecuted === true) {
                     flushText();
                     const id = itemID(part.providerMetadata, providerMetadataKey);
-                    if (store !== false && id && !hostedToolReferences.has(id))
-                        input.push({ type: "item_reference", id });
+                    const reference = acceptsItemID(extension, "reference", id) ? id : undefined;
+                    if (store !== false && reference && !hostedToolReferences.has(reference))
+                        input.push({ type: "item_reference", id: reference });
                     if (store === false) {
                         // The server is not storing this exchange, so the tool outcome has to
                         // travel in the input. Non-content results degrade to their text form.
@@ -427,8 +437,8 @@ const lowerMessages = Effect.fn("OpenResponses.lowerMessages")(function* (reques
                             content: yield* Effect.forEach(content, (item) => lowerHostedToolResultContentItem(item, request, extension)),
                         });
                     }
-                    if (id)
-                        hostedToolReferences.add(id);
+                    if (reference)
+                        hostedToolReferences.add(reference);
                     continue;
                 }
                 return yield* ProviderShared.unsupportedContent(extension.name, "assistant", [

package/dist/protocols/openai-responses.js

@@ -43,9 +43,27 @@ const OpenAIResponsesBody = Schema.Struct({
     ...OpenAIResponsesCoreFields,
     stream: Schema.Literal(true),
 });
+// Replayed items are paired with stored server state by id, so a foreign or
+// synthetic token can fail request validation even when `call_id` pairing is
+// intact. Only resend ids in each item kind's own grammar; hosted tool
+// references keep generic validation because every hosted tool mints its own
+// prefix. The same allowlist approach codex uses before resending history
+// (codex-rs core/src/client.rs, `prepare_response_items_for_request`).
+const ITEM_ID_PREFIXES = {
+    message: ["msg_"],
+    reasoning: ["rs_"],
+    "function-call": ["fc_"],
+    // Every hosted tool mints its own id prefix, so references keep generic
+    // validation only.
+    reference: [],
+};
 const extension = {
     id: ADAPTER,
     name: NAME,
+    acceptsItemID: (kind, id) => {
+        const prefixes = ITEM_ID_PREFIXES[kind];
+        return prefixes.length === 0 || prefixes.some((prefix) => id.startsWith(prefix));
+    },
 };
 const nativeImageToolInput = (tool) => {
     const native = tool.native?.openai;

package/dist/protocols/utils/bedrock-media.d.ts

@@ -29,6 +29,7 @@ export declare const lower: (part: {
     readonly metadata?: {
         readonly [x: string]: unknown;
     } | undefined;
+    readonly cache?: import("../../schema/options.js").CacheHint | undefined;
     readonly filename?: string | undefined;
 }) => Effect.Effect<{
     readonly document: {

package/dist/providers/anthropic-compatible.d.ts

@@ -41,22 +41,46 @@ export declare const routes: import("../route/client.js").Route<{
                 readonly type: "base64";
                 readonly media_type: string;
                 readonly data: string;
+            } | {
+                readonly type: "url";
+                readonly url: string;
+            } | {
+                readonly type: "file";
+                readonly file_id: string;
             };
             readonly cache_control?: {
                 readonly type: "ephemeral";
                 readonly ttl?: "1h" | "5m" | undefined;
             } | undefined;
+            readonly transformations?: {
+                readonly oversized_image?: "error" | "downsize" | undefined;
+            } | undefined;
         } | {
             readonly type: "document";
             readonly source: {
                 readonly type: "base64";
                 readonly media_type: "application/pdf";
                 readonly data: string;
+            } | {
+                readonly type: "text";
+                readonly media_type: "text/plain";
+                readonly data: string;
+            } | {
+                readonly type: "url";
+                readonly url: string;
+            } | {
+                readonly type: "file";
+                readonly file_id: string;
             };
+            readonly title?: string | undefined;
+            readonly context?: string | undefined;
             readonly cache_control?: {
                 readonly type: "ephemeral";
                 readonly ttl?: "1h" | "5m" | undefined;
             } | undefined;
+            readonly citations?: {
+                readonly enabled: boolean;
+            } | undefined;
         } | {
             readonly type: "tool_result";
             readonly content: string | readonly ({
@@ -72,22 +96,46 @@ export declare const routes: import("../route/client.js").Route<{
                     readonly type: "base64";
                     readonly media_type: string;
                     readonly data: string;
+                } | {
+                    readonly type: "url";
+                    readonly url: string;
+                } | {
+                    readonly type: "file";
+                    readonly file_id: string;
                 };
                 readonly cache_control?: {
                     readonly type: "ephemeral";
                     readonly ttl?: "1h" | "5m" | undefined;
                 } | undefined;
+                readonly transformations?: {
+                    readonly oversized_image?: "error" | "downsize" | undefined;
+                } | undefined;
             } | {
                 readonly type: "document";
                 readonly source: {
                     readonly type: "base64";
                     readonly media_type: "application/pdf";
                     readonly data: string;
+                } | {
+                    readonly type: "text";
+                    readonly media_type: "text/plain";
+                    readonly data: string;
+                } | {
+                    readonly type: "url";
+                    readonly url: string;
+                } | {
+                    readonly type: "file";
+                    readonly file_id: string;
                 };
+                readonly title?: string | undefined;
+                readonly context?: string | undefined;
                 readonly cache_control?: {
                     readonly type: "ephemeral";
                     readonly ttl?: "1h" | "5m" | undefined;
                 } | undefined;
+                readonly citations?: {
+                    readonly enabled: boolean;
+                } | undefined;
             })[];
             readonly tool_use_id: string;
             readonly cache_control?: {

package/dist/providers/anthropic.d.ts

@@ -25,22 +25,46 @@ export declare const routes: import("../route/client.js").Route<{
                 readonly type: "base64";
                 readonly media_type: string;
                 readonly data: string;
+            } | {
+                readonly type: "url";
+                readonly url: string;
+            } | {
+                readonly type: "file";
+                readonly file_id: string;
             };
             readonly cache_control?: {
                 readonly type: "ephemeral";
                 readonly ttl?: "1h" | "5m" | undefined;
             } | undefined;
+            readonly transformations?: {
+                readonly oversized_image?: "error" | "downsize" | undefined;
+            } | undefined;
         } | {
             readonly type: "document";
             readonly source: {
                 readonly type: "base64";
                 readonly media_type: "application/pdf";
                 readonly data: string;
+            } | {
+                readonly type: "text";
+                readonly media_type: "text/plain";
+                readonly data: string;
+            } | {
+                readonly type: "url";
+                readonly url: string;
+            } | {
+                readonly type: "file";
+                readonly file_id: string;
             };
+            readonly title?: string | undefined;
+            readonly context?: string | undefined;
             readonly cache_control?: {
                 readonly type: "ephemeral";
                 readonly ttl?: "1h" | "5m" | undefined;
             } | undefined;
+            readonly citations?: {
+                readonly enabled: boolean;
+            } | undefined;
         } | {
             readonly type: "tool_result";
             readonly content: string | readonly ({
@@ -56,22 +80,46 @@ export declare const routes: import("../route/client.js").Route<{
                     readonly type: "base64";
                     readonly media_type: string;
                     readonly data: string;
+                } | {
+                    readonly type: "url";
+                    readonly url: string;
+                } | {
+                    readonly type: "file";
+                    readonly file_id: string;
                 };
                 readonly cache_control?: {
                     readonly type: "ephemeral";
                     readonly ttl?: "1h" | "5m" | undefined;
                 } | undefined;
+                readonly transformations?: {
+                    readonly oversized_image?: "error" | "downsize" | undefined;
+                } | undefined;
             } | {
                 readonly type: "document";
                 readonly source: {
                     readonly type: "base64";
                     readonly media_type: "application/pdf";
                     readonly data: string;
+                } | {
+                    readonly type: "text";
+                    readonly media_type: "text/plain";
+                    readonly data: string;
+                } | {
+                    readonly type: "url";
+                    readonly url: string;
+                } | {
+                    readonly type: "file";
+                    readonly file_id: string;
                 };
+                readonly title?: string | undefined;
+                readonly context?: string | undefined;
                 readonly cache_control?: {
                     readonly type: "ephemeral";
                     readonly ttl?: "1h" | "5m" | undefined;
                 } | undefined;
+                readonly citations?: {
+                    readonly enabled: boolean;
+                } | undefined;
             })[];
             readonly tool_use_id: string;
             readonly cache_control?: {

package/dist/providers/google-vertex-messages.d.ts

@@ -58,22 +58,46 @@ export declare const routes: Route<{
                 readonly type: "base64";
                 readonly media_type: string;
                 readonly data: string;
+            } | {
+                readonly type: "url";
+                readonly url: string;
+            } | {
+                readonly type: "file";
+                readonly file_id: string;
             };
             readonly cache_control?: {
                 readonly type: "ephemeral";
                 readonly ttl?: "1h" | "5m" | undefined;
             } | undefined;
+            readonly transformations?: {
+                readonly oversized_image?: "error" | "downsize" | undefined;
+            } | undefined;
         } | {
             readonly type: "document";
             readonly source: {
                 readonly type: "base64";
                 readonly media_type: "application/pdf";
                 readonly data: string;
+            } | {
+                readonly type: "text";
+                readonly media_type: "text/plain";
+                readonly data: string;
+            } | {
+                readonly type: "url";
+                readonly url: string;
+            } | {
+                readonly type: "file";
+                readonly file_id: string;
             };
+            readonly title?: string | undefined;
+            readonly context?: string | undefined;
             readonly cache_control?: {
                 readonly type: "ephemeral";
                 readonly ttl?: "1h" | "5m" | undefined;
             } | undefined;
+            readonly citations?: {
+                readonly enabled: boolean;
+            } | undefined;
         } | {
             readonly type: "tool_result";
             readonly content: string | readonly ({
@@ -89,22 +113,46 @@ export declare const routes: Route<{
                     readonly type: "base64";
                     readonly media_type: string;
                     readonly data: string;
+                } | {
+                    readonly type: "url";
+                    readonly url: string;
+                } | {
+                    readonly type: "file";
+                    readonly file_id: string;
                 };
                 readonly cache_control?: {
                     readonly type: "ephemeral";
                     readonly ttl?: "1h" | "5m" | undefined;
                 } | undefined;
+                readonly transformations?: {
+                    readonly oversized_image?: "error" | "downsize" | undefined;
+                } | undefined;
             } | {
                 readonly type: "document";
                 readonly source: {
                     readonly type: "base64";
                     readonly media_type: "application/pdf";
                     readonly data: string;
+                } | {
+                    readonly type: "text";
+                    readonly media_type: "text/plain";
+                    readonly data: string;
+                } | {
+                    readonly type: "url";
+                    readonly url: string;
+                } | {
+                    readonly type: "file";
+                    readonly file_id: string;
                 };
+                readonly title?: string | undefined;
+                readonly context?: string | undefined;
                 readonly cache_control?: {
                     readonly type: "ephemeral";
                     readonly ttl?: "1h" | "5m" | undefined;
                 } | undefined;
+                readonly citations?: {
+                    readonly enabled: boolean;
+                } | undefined;
             })[];
             readonly tool_use_id: string;
             readonly cache_control?: {

package/dist/schema/messages.d.ts

@@ -34,6 +34,7 @@ export declare const MediaPart: Schema.Struct<{
     readonly mediaType: Schema.String;
     readonly data: Schema.Union<readonly [Schema.String, Schema.Uint8Array]>;
     readonly filename: Schema.optional<Schema.String>;
+    readonly cache: Schema.optional<typeof CacheHint>;
     readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
 }>;
 export type MediaPart = Schema.Schema.Type<typeof MediaPart>;
@@ -175,6 +176,7 @@ export declare const ContentPart: Schema.toTaggedUnion<"type", readonly [Schema.
     readonly mediaType: Schema.String;
     readonly data: Schema.Union<readonly [Schema.String, Schema.Uint8Array]>;
     readonly filename: Schema.optional<Schema.String>;
+    readonly cache: Schema.optional<typeof CacheHint>;
     readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
 }>, Schema.Struct<{
     readonly type: Schema.Literal<"tool-call">;
@@ -247,6 +249,7 @@ declare const Message_base: Schema.Class<Message, Schema.Struct<{
         readonly mediaType: Schema.String;
         readonly data: Schema.Union<readonly [Schema.String, Schema.Uint8Array]>;
         readonly filename: Schema.optional<Schema.String>;
+        readonly cache: Schema.optional<typeof CacheHint>;
         readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.Unknown>>;
     }>, Schema.Struct<{
         readonly type: Schema.Literal<"tool-call">;

package/dist/schema/messages.js

@@ -33,6 +33,7 @@ export const MediaPart = Schema.Struct({
     mediaType: Schema.String,
     data: Schema.Union([Schema.String, Schema.Uint8Array]),
     filename: Schema.optional(Schema.String),
+    cache: Schema.optional(CacheHint),
     metadata: Schema.optional(Schema.Record(Schema.String, Schema.Unknown)),
 }).annotate({ identifier: "LLM.Content.Media" });
 const isToolResultValue = (value) => isRecord(value) &&

package/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "0.0.0-dev-18049",
+  "version": "0.0.0-dev-18052",
   "name": "@opencode-ai/ai",
   "type": "module",
   "license": "MIT",
@@ -30,7 +30,7 @@
   "devDependencies": {
     "@clack/prompts": "1.0.0-alpha.1",
     "@effect/platform-node": "4.0.0-rc.111",
-    "@opencode-ai/http-recorder": "0.0.0-dev-18049",
+    "@opencode-ai/http-recorder": "0.0.0-dev-18052",
     "@tsconfig/bun": "1.0.9",
     "@types/bun": "1.3.13",
     "@typescript/native-preview": "7.0.0-dev.20251207.1",
@@ -39,7 +39,7 @@
   "dependencies": {
     "@smithy/eventstream-codec": "4.2.14",
     "@smithy/util-utf8": "4.2.2",
-    "@opencode-ai/schema": "0.0.0-dev-18049",
+    "@opencode-ai/schema": "0.0.0-dev-18052",
     "aws4fetch": "1.0.20",
     "effect": "4.0.0-rc.111",
     "google-auth-library": "10.5.0"