@opencode/ai 0.0.0-dev-20386 → 0.0.0-dev-20388

package/dist/cache-policy.js

@@ -47,6 +47,7 @@ const RESPECTS_INLINE_HINTS = new Set([
     "zai-coding-messages",
     "bedrock-converse",
     "openrouter",
+    "digitalocean",
 ]);
 // OpenRouter upstreams other than Anthropic and Alibaba Qwen cache without breakpoints. Gemini uses only the last
 // breakpoint, so a conversation-tail breakpoint writes a new cache every step and costs more than none. Qwen ignores

package/dist/protocols/alibaba-chat.d.ts

@@ -186,6 +186,7 @@ export declare const protocol: Protocol<{
     } | null | undefined;
     readonly usage?: {
         readonly [x: string]: unknown;
+        readonly cache_read_input_tokens?: number | null | undefined;
         readonly cached_tokens?: number | null | undefined;
         readonly prompt_tokens?: number | null | undefined;
         readonly completion_tokens?: number | null | undefined;
@@ -196,6 +197,7 @@ export declare const protocol: Protocol<{
             readonly cache_write_tokens?: number | null | undefined;
         } | null | undefined;
         readonly prompt_cache_hit_tokens?: number | null | undefined;
+        readonly cache_created_input_tokens?: number | null | undefined;
         readonly completion_tokens_details?: {
             readonly [x: string]: unknown;
             readonly reasoning_tokens?: number | null | undefined;
@@ -225,6 +227,7 @@ export declare const protocol: Protocol<{
         } | null | undefined;
         readonly usage?: {
             readonly [x: string]: unknown;
+            readonly cache_read_input_tokens?: number | null | undefined;
             readonly cached_tokens?: number | null | undefined;
             readonly prompt_tokens?: number | null | undefined;
             readonly completion_tokens?: number | null | undefined;
@@ -235,6 +238,7 @@ export declare const protocol: Protocol<{
                 readonly cache_write_tokens?: number | null | undefined;
             } | null | undefined;
             readonly prompt_cache_hit_tokens?: number | null | undefined;
+            readonly cache_created_input_tokens?: number | null | undefined;
             readonly completion_tokens_details?: {
                 readonly [x: string]: unknown;
                 readonly reasoning_tokens?: number | null | undefined;

package/dist/protocols/bedrock-converse.js

@@ -236,13 +236,28 @@ const lowerToolResult = Effect.fn("BedrockConverse.lowerToolResult")(function* (
         },
     };
 });
+// Keep Claude and Nova tool-result images inline; put other models' images beside the result.
+const keepToolImagesInline = (id) => id.includes("anthropic.claude-") || id.includes("amazon.nova-");
 const lowerMessages = Effect.fn("BedrockConverse.lowerMessages")(function* (request, breakpoints) {
     const messages = [];
     const documentNames = new Set();
     // Mistral can reject replay IDs even when they satisfy Converse's broader ID syntax.
     const normalizeID = request.model.id.includes("mistral.") ? MistralToolID.normalizer(request) : (id) => id;
     const providerMetadataKey = request.model.route.providerMetadataKey ?? String(request.model.provider);
+    const hoistImages = !keepToolImagesInline(request.model.id);
+    // Bedrock expects parallel tool results before any images hoisted beside them.
+    const pendingImages = [];
+    const flushImages = () => {
+        if (pendingImages.length === 0)
+            return;
+        const previous = messages.at(-1);
+        if (previous?.role === "user")
+            messages[messages.length - 1] = { role: "user", content: [...previous.content, ...pendingImages] };
+        pendingImages.length = 0;
+    };
     for (const message of request.messages) {
+        if (message.role !== "tool")
+            flushImages();
         if (message.role === "system") {
             const part = yield* ProviderShared.wrappedSystemUpdate("Bedrock Converse", message);
             const content = textWithCache(breakpoints, part.text, part.cache);
@@ -317,7 +332,20 @@ const lowerMessages = Effect.fn("BedrockConverse.lowerMessages")(function* (requ
         for (const part of message.content) {
             if (!ProviderShared.supportsContent(part, ["tool-result"]))
                 return yield* ProviderShared.unsupportedContent("Bedrock Converse", "tool", ["tool-result"]);
-            content.push(yield* lowerToolResult(part, documentNames, normalizeID));
+            const result = yield* lowerToolResult(part, documentNames, normalizeID);
+            const images = hoistImages
+                ? result.toolResult.content.filter((item) => "image" in item)
+                : [];
+            const nonImageContent = result.toolResult.content.filter((item) => !("image" in item));
+            content.push(images.length === 0
+                ? result
+                : {
+                    toolResult: {
+                        ...result.toolResult,
+                        content: nonImageContent.length > 0 ? nonImageContent : [{ text: "See attached image." }],
+                    },
+                });
+            pendingImages.push(...images);
             const cachePoint = BedrockCache.block(breakpoints, part.cache);
             if (cachePoint)
                 content.push(cachePoint);
@@ -328,6 +356,7 @@ const lowerMessages = Effect.fn("BedrockConverse.lowerMessages")(function* (requ
         else
             messages.push({ role: "user", content });
     }
+    flushImages();
     return messages;
 });
 // System prompts share the cache-point convention: emit the text block, then

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

@@ -315,6 +315,8 @@ export declare const OpenAIChatEvent: Schema.StructWithRest<Schema.Struct<{
             readonly total_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
             readonly cached_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
             readonly prompt_cache_hit_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
+            readonly cache_read_input_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
+            readonly cache_created_input_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
             readonly prompt_tokens_details: Schema.optional<Schema.NullOr<Schema.StructWithRest<Schema.Struct<{
                 readonly cached_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
                 readonly cache_write_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
@@ -332,6 +334,8 @@ export declare const OpenAIChatEvent: Schema.StructWithRest<Schema.Struct<{
         readonly total_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
         readonly cached_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
         readonly prompt_cache_hit_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly cache_read_input_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
+        readonly cache_created_input_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
         readonly prompt_tokens_details: Schema.optional<Schema.NullOr<Schema.StructWithRest<Schema.Struct<{
             readonly cached_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
             readonly cache_write_tokens: Schema.optional<Schema.NullOr<Schema.Number>>;
@@ -755,6 +759,7 @@ export declare const protocol: Protocol<{
     } | null | undefined;
     readonly usage?: {
         readonly [x: string]: unknown;
+        readonly cache_read_input_tokens?: number | null | undefined;
         readonly cached_tokens?: number | null | undefined;
         readonly prompt_tokens?: number | null | undefined;
         readonly completion_tokens?: number | null | undefined;
@@ -765,6 +770,7 @@ export declare const protocol: Protocol<{
             readonly cache_write_tokens?: number | null | undefined;
         } | null | undefined;
         readonly prompt_cache_hit_tokens?: number | null | undefined;
+        readonly cache_created_input_tokens?: number | null | undefined;
         readonly completion_tokens_details?: {
             readonly [x: string]: unknown;
             readonly reasoning_tokens?: number | null | undefined;
@@ -794,6 +800,7 @@ export declare const protocol: Protocol<{
         } | null | undefined;
         readonly usage?: {
             readonly [x: string]: unknown;
+            readonly cache_read_input_tokens?: number | null | undefined;
             readonly cached_tokens?: number | null | undefined;
             readonly prompt_tokens?: number | null | undefined;
             readonly completion_tokens?: number | null | undefined;
@@ -804,6 +811,7 @@ export declare const protocol: Protocol<{
                 readonly cache_write_tokens?: number | null | undefined;
             } | null | undefined;
             readonly prompt_cache_hit_tokens?: number | null | undefined;
+            readonly cache_created_input_tokens?: number | null | undefined;
             readonly completion_tokens_details?: {
                 readonly [x: string]: unknown;
                 readonly reasoning_tokens?: number | null | undefined;

package/dist/protocols/openai-chat.js

@@ -161,9 +161,11 @@ const OpenAIChatUsage = Schema.StructWithRest(Schema.Struct({
     prompt_tokens: optionalNull(Schema.Number),
     completion_tokens: optionalNull(Schema.Number),
     total_tokens: optionalNull(Schema.Number),
-    // Zai reports cache hits as top-level `cached_tokens`; DeepSeek uses `prompt_cache_hit_tokens`.
+    // Provider-specific cache accounting fields.
     cached_tokens: optionalNull(Schema.Number),
     prompt_cache_hit_tokens: optionalNull(Schema.Number),
+    cache_read_input_tokens: optionalNull(Schema.Number),
+    cache_created_input_tokens: optionalNull(Schema.Number),
     prompt_tokens_details: optionalNull(Schema.StructWithRest(Schema.Struct({
         cached_tokens: optionalNull(Schema.Number),
         cache_write_tokens: optionalNull(Schema.Number),
@@ -719,17 +721,19 @@ const mapFinishReason = Effect.fn("OpenAIChat.mapFinishReason")(function* (event
 // satisfied on both sides.
 // Providers differ on cache-hit location: OpenAI uses
 // `prompt_tokens_details.cached_tokens`, DeepSeek uses
-// `prompt_cache_hit_tokens`, and Zai uses top-level `cached_tokens`.
+// `prompt_cache_hit_tokens`, Zai uses top-level `cached_tokens`, and
+// DigitalOcean uses top-level `cache_read_input_tokens` / `cache_created_input_tokens`.
 const mapUsage = (usage, providerMetadataKey) => {
     if (!usage)
         return undefined;
     const input = usage.prompt_tokens ?? undefined;
     const output = usage.completion_tokens ?? undefined;
-    const cached = (usage.prompt_tokens_details?.cached_tokens ??
+    const cached = usage.prompt_tokens_details?.cached_tokens ??
         usage.prompt_cache_hit_tokens ??
         usage.cached_tokens ??
-        undefined);
-    const cacheWrite = usage.prompt_tokens_details?.cache_write_tokens ?? undefined;
+        usage.cache_read_input_tokens ??
+        undefined;
+    const cacheWrite = usage.prompt_tokens_details?.cache_write_tokens ?? usage.cache_created_input_tokens ?? undefined;
     const reasoning = usage.completion_tokens_details?.reasoning_tokens ?? undefined;
     const nonCached = ProviderShared.subtractTokens(input, ProviderShared.sumTokens(cached, cacheWrite));
     return new Usage({

package/dist/protocols/utils/cache.d.ts

@@ -1,6 +1,11 @@
+import type { CacheHint } from "../../schema/index.js";
 export interface Breakpoints {
     remaining: number;
     dropped: number;
 }
 export declare const newBreakpoints: (cap: number) => Breakpoints;
 export declare const ttlBucket: (ttlSeconds: number | undefined) => "1h" | undefined;
+export declare const cacheControl: () => (cache: CacheHint | undefined) => {
+    type: "ephemeral";
+    ttl: "1h" | undefined;
+} | undefined;

package/dist/protocols/utils/cache.js

@@ -1,5 +1,13 @@
-// Shared counter and TTL mapping for provider cache-marker lowering.
 export const newBreakpoints = (cap) => ({ remaining: cap, dropped: 0 });
 // Requests of at least one hour use the explicit `"1h"` bucket; shorter
 // requests omit the wire TTL and use the provider default.
 export const ttlBucket = (ttlSeconds) => ttlSeconds !== undefined && ttlSeconds >= 3600 ? "1h" : undefined;
+export const cacheControl = () => {
+    const breakpoints = newBreakpoints(4);
+    return (cache) => {
+        if (cache === undefined || breakpoints.remaining === 0)
+            return undefined;
+        breakpoints.remaining -= 1;
+        return { type: "ephemeral", ttl: ttlBucket(cache.ttlSeconds) };
+    };
+};

package/dist/protocols/zai-chat.d.ts

@@ -163,6 +163,7 @@ export declare const protocol: Protocol<{
     } | null | undefined;
     readonly usage?: {
         readonly [x: string]: unknown;
+        readonly cache_read_input_tokens?: number | null | undefined;
         readonly cached_tokens?: number | null | undefined;
         readonly prompt_tokens?: number | null | undefined;
         readonly completion_tokens?: number | null | undefined;
@@ -173,6 +174,7 @@ export declare const protocol: Protocol<{
             readonly cache_write_tokens?: number | null | undefined;
         } | null | undefined;
         readonly prompt_cache_hit_tokens?: number | null | undefined;
+        readonly cache_created_input_tokens?: number | null | undefined;
         readonly completion_tokens_details?: {
             readonly [x: string]: unknown;
             readonly reasoning_tokens?: number | null | undefined;
@@ -202,6 +204,7 @@ export declare const protocol: Protocol<{
         } | null | undefined;
         readonly usage?: {
             readonly [x: string]: unknown;
+            readonly cache_read_input_tokens?: number | null | undefined;
             readonly cached_tokens?: number | null | undefined;
             readonly prompt_tokens?: number | null | undefined;
             readonly completion_tokens?: number | null | undefined;
@@ -212,6 +215,7 @@ export declare const protocol: Protocol<{
                 readonly cache_write_tokens?: number | null | undefined;
             } | null | undefined;
             readonly prompt_cache_hit_tokens?: number | null | undefined;
+            readonly cache_created_input_tokens?: number | null | undefined;
             readonly completion_tokens_details?: {
                 readonly [x: string]: unknown;
                 readonly reasoning_tokens?: number | null | undefined;

package/dist/providers/digitalocean.d.ts

@@ -0,0 +1,469 @@
+import type { ProviderPackage } from "../provider-package.js";
+import { OpenAIChat } from "../protocols/openai-chat.js";
+import { type ProviderAuthOption } from "../route/auth-options.js";
+import { Route, type RouteDefaultsInput } from "../route/client.js";
+import { Protocol } from "../route/protocol.js";
+import { type ModelID } from "../schema/index.js";
+import type { OpenAIProviderOptionsInput } from "./openai-options.js";
+export declare const id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+export type LanguageModelOptions = Omit<RouteDefaultsInput, "providerOptions"> & ProviderAuthOption<"optional"> & {
+    readonly baseURL?: string;
+    readonly providerOptions?: OpenAIProviderOptionsInput;
+};
+export type Settings = ProviderPackage.Settings & OpenAIProviderOptionsInput & {
+    readonly apiKey?: string;
+};
+export declare const protocol: Protocol<{
+    readonly model: string;
+    readonly messages: readonly ({
+        readonly role: "system";
+        readonly content: string | readonly ({
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        } | {
+            readonly type: "image_url";
+            readonly image_url: {
+                readonly url: string;
+            };
+        } | {
+            readonly type: "file";
+            readonly file: {
+                readonly filename: string;
+                readonly file_data: string;
+            };
+        })[];
+    } | {
+        readonly role: "user";
+        readonly content: string | readonly ({
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        } | {
+            readonly type: "image_url";
+            readonly image_url: {
+                readonly url: string;
+            };
+        } | {
+            readonly type: "file";
+            readonly file: {
+                readonly filename: string;
+                readonly file_data: string;
+            };
+        })[];
+    } | {
+        readonly [x: string]: unknown;
+        readonly content: string | readonly {
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        }[] | null;
+        readonly role: "assistant";
+        readonly reasoning?: string | undefined;
+        readonly reasoning_content?: string | undefined;
+        readonly reasoning_text?: string | undefined;
+        readonly tool_calls?: readonly {
+            readonly function: {
+                readonly name: string;
+                readonly arguments: string;
+            };
+            readonly id: string;
+            readonly type: "function";
+            readonly extra_content?: {
+                readonly google: {
+                    readonly thought_signature: string;
+                };
+            } | undefined;
+        }[] | undefined;
+        readonly reasoning_details?: unknown;
+    } | {
+        readonly role: "tool";
+        readonly tool_call_id: string;
+        readonly content: string | readonly {
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        }[];
+    })[];
+    readonly stream: true;
+    readonly max_completion_tokens?: number | undefined;
+    readonly max_tokens?: number | undefined;
+    readonly tools?: readonly {
+        readonly function: {
+            readonly description: string;
+            readonly name: string;
+            readonly parameters: {
+                readonly [x: string]: unknown;
+            };
+            readonly strict?: boolean | undefined;
+        };
+        readonly type: "function";
+        readonly cache_control?: {
+            readonly type: "ephemeral";
+            readonly ttl?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    readonly stop?: readonly string[] | undefined;
+    readonly temperature?: number | undefined;
+    readonly seed?: number | undefined;
+    readonly tool_choice?: "required" | "auto" | "none" | {
+        readonly type: "function";
+        readonly function: {
+            readonly name: string;
+        };
+    } | undefined;
+    readonly top_p?: number | undefined;
+    readonly frequency_penalty?: number | undefined;
+    readonly presence_penalty?: number | undefined;
+    readonly prompt_cache_key?: string | undefined;
+    readonly reasoning_effort?: import("../schema/options.js").ReasoningEffort | undefined;
+    readonly store?: boolean | undefined;
+    readonly stream_options?: {
+        readonly include_usage: boolean;
+    } | undefined;
+    readonly tool_stream?: boolean | undefined;
+}, string, "[DONE]" | {
+    readonly [x: string]: unknown;
+    readonly error?: {
+        readonly [x: string]: unknown;
+        readonly message: string;
+        readonly code?: string | number | null | undefined;
+    } | null | undefined;
+    readonly usage?: {
+        readonly [x: string]: unknown;
+        readonly cache_read_input_tokens?: number | null | undefined;
+        readonly cached_tokens?: number | null | undefined;
+        readonly prompt_tokens?: number | null | undefined;
+        readonly completion_tokens?: number | null | undefined;
+        readonly total_tokens?: number | null | undefined;
+        readonly prompt_tokens_details?: {
+            readonly [x: string]: unknown;
+            readonly cached_tokens?: number | null | undefined;
+            readonly cache_write_tokens?: number | null | undefined;
+        } | null | undefined;
+        readonly prompt_cache_hit_tokens?: number | null | undefined;
+        readonly cache_created_input_tokens?: number | null | undefined;
+        readonly completion_tokens_details?: {
+            readonly [x: string]: unknown;
+            readonly reasoning_tokens?: number | null | undefined;
+            readonly accepted_prediction_tokens?: number | null | undefined;
+            readonly rejected_prediction_tokens?: number | null | undefined;
+        } | null | undefined;
+    } | null | undefined;
+    readonly choices?: readonly {
+        readonly [x: string]: unknown;
+        readonly delta?: {
+            readonly [x: string]: unknown;
+            readonly reasoning?: string | null | undefined;
+            readonly reasoning_content?: string | null | undefined;
+            readonly reasoning_text?: string | null | undefined;
+            readonly content?: string | null | undefined;
+            readonly refusal?: string | null | undefined;
+            readonly tool_calls?: readonly {
+                readonly function?: {
+                    readonly name?: string | null | undefined;
+                    readonly arguments?: string | null | undefined;
+                } | null | undefined;
+                readonly id?: string | null | undefined;
+                readonly index?: number | null | undefined;
+                readonly extra_content?: unknown;
+            }[] | null | undefined;
+            readonly reasoning_details?: unknown;
+        } | null | undefined;
+        readonly usage?: {
+            readonly [x: string]: unknown;
+            readonly cache_read_input_tokens?: number | null | undefined;
+            readonly cached_tokens?: number | null | undefined;
+            readonly prompt_tokens?: number | null | undefined;
+            readonly completion_tokens?: number | null | undefined;
+            readonly total_tokens?: number | null | undefined;
+            readonly prompt_tokens_details?: {
+                readonly [x: string]: unknown;
+                readonly cached_tokens?: number | null | undefined;
+                readonly cache_write_tokens?: number | null | undefined;
+            } | null | undefined;
+            readonly prompt_cache_hit_tokens?: number | null | undefined;
+            readonly cache_created_input_tokens?: number | null | undefined;
+            readonly completion_tokens_details?: {
+                readonly [x: string]: unknown;
+                readonly reasoning_tokens?: number | null | undefined;
+                readonly accepted_prediction_tokens?: number | null | undefined;
+                readonly rejected_prediction_tokens?: number | null | undefined;
+            } | null | undefined;
+        } | null | undefined;
+        readonly finish_reason?: string | null | undefined;
+        readonly native_finish_reason?: string | null | undefined;
+    }[] | null | undefined;
+}, OpenAIChat.ParserState>;
+export declare const route: Route<{
+    readonly model: string;
+    readonly messages: readonly ({
+        readonly role: "system";
+        readonly content: string | readonly ({
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        } | {
+            readonly type: "image_url";
+            readonly image_url: {
+                readonly url: string;
+            };
+        } | {
+            readonly type: "file";
+            readonly file: {
+                readonly filename: string;
+                readonly file_data: string;
+            };
+        })[];
+    } | {
+        readonly role: "user";
+        readonly content: string | readonly ({
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        } | {
+            readonly type: "image_url";
+            readonly image_url: {
+                readonly url: string;
+            };
+        } | {
+            readonly type: "file";
+            readonly file: {
+                readonly filename: string;
+                readonly file_data: string;
+            };
+        })[];
+    } | {
+        readonly [x: string]: unknown;
+        readonly content: string | readonly {
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        }[] | null;
+        readonly role: "assistant";
+        readonly reasoning?: string | undefined;
+        readonly reasoning_content?: string | undefined;
+        readonly reasoning_text?: string | undefined;
+        readonly tool_calls?: readonly {
+            readonly function: {
+                readonly name: string;
+                readonly arguments: string;
+            };
+            readonly id: string;
+            readonly type: "function";
+            readonly extra_content?: {
+                readonly google: {
+                    readonly thought_signature: string;
+                };
+            } | undefined;
+        }[] | undefined;
+        readonly reasoning_details?: unknown;
+    } | {
+        readonly role: "tool";
+        readonly tool_call_id: string;
+        readonly content: string | readonly {
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        }[];
+    })[];
+    readonly stream: true;
+    readonly max_completion_tokens?: number | undefined;
+    readonly max_tokens?: number | undefined;
+    readonly tools?: readonly {
+        readonly function: {
+            readonly description: string;
+            readonly name: string;
+            readonly parameters: {
+                readonly [x: string]: unknown;
+            };
+            readonly strict?: boolean | undefined;
+        };
+        readonly type: "function";
+        readonly cache_control?: {
+            readonly type: "ephemeral";
+            readonly ttl?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    readonly stop?: readonly string[] | undefined;
+    readonly temperature?: number | undefined;
+    readonly seed?: number | undefined;
+    readonly tool_choice?: "required" | "auto" | "none" | {
+        readonly type: "function";
+        readonly function: {
+            readonly name: string;
+        };
+    } | undefined;
+    readonly top_p?: number | undefined;
+    readonly frequency_penalty?: number | undefined;
+    readonly presence_penalty?: number | undefined;
+    readonly prompt_cache_key?: string | undefined;
+    readonly reasoning_effort?: import("../schema/options.js").ReasoningEffort | undefined;
+    readonly store?: boolean | undefined;
+    readonly stream_options?: {
+        readonly include_usage: boolean;
+    } | undefined;
+    readonly tool_stream?: boolean | undefined;
+}, import("../route/transport/http.js").HttpPrepared<string>, import("../route/client.js").CompactionOperations | undefined>;
+export declare const routes: Route<{
+    readonly model: string;
+    readonly messages: readonly ({
+        readonly role: "system";
+        readonly content: string | readonly ({
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        } | {
+            readonly type: "image_url";
+            readonly image_url: {
+                readonly url: string;
+            };
+        } | {
+            readonly type: "file";
+            readonly file: {
+                readonly filename: string;
+                readonly file_data: string;
+            };
+        })[];
+    } | {
+        readonly role: "user";
+        readonly content: string | readonly ({
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        } | {
+            readonly type: "image_url";
+            readonly image_url: {
+                readonly url: string;
+            };
+        } | {
+            readonly type: "file";
+            readonly file: {
+                readonly filename: string;
+                readonly file_data: string;
+            };
+        })[];
+    } | {
+        readonly [x: string]: unknown;
+        readonly content: string | readonly {
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        }[] | null;
+        readonly role: "assistant";
+        readonly reasoning?: string | undefined;
+        readonly reasoning_content?: string | undefined;
+        readonly reasoning_text?: string | undefined;
+        readonly tool_calls?: readonly {
+            readonly function: {
+                readonly name: string;
+                readonly arguments: string;
+            };
+            readonly id: string;
+            readonly type: "function";
+            readonly extra_content?: {
+                readonly google: {
+                    readonly thought_signature: string;
+                };
+            } | undefined;
+        }[] | undefined;
+        readonly reasoning_details?: unknown;
+    } | {
+        readonly role: "tool";
+        readonly tool_call_id: string;
+        readonly content: string | readonly {
+            readonly type: "text";
+            readonly text: string;
+            readonly cache_control?: {
+                readonly type: "ephemeral";
+                readonly ttl?: string | undefined;
+            } | undefined;
+        }[];
+    })[];
+    readonly stream: true;
+    readonly max_completion_tokens?: number | undefined;
+    readonly max_tokens?: number | undefined;
+    readonly tools?: readonly {
+        readonly function: {
+            readonly description: string;
+            readonly name: string;
+            readonly parameters: {
+                readonly [x: string]: unknown;
+            };
+            readonly strict?: boolean | undefined;
+        };
+        readonly type: "function";
+        readonly cache_control?: {
+            readonly type: "ephemeral";
+            readonly ttl?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    readonly stop?: readonly string[] | undefined;
+    readonly temperature?: number | undefined;
+    readonly seed?: number | undefined;
+    readonly tool_choice?: "required" | "auto" | "none" | {
+        readonly type: "function";
+        readonly function: {
+            readonly name: string;
+        };
+    } | undefined;
+    readonly top_p?: number | undefined;
+    readonly frequency_penalty?: number | undefined;
+    readonly presence_penalty?: number | undefined;
+    readonly prompt_cache_key?: string | undefined;
+    readonly reasoning_effort?: import("../schema/options.js").ReasoningEffort | undefined;
+    readonly store?: boolean | undefined;
+    readonly stream_options?: {
+        readonly include_usage: boolean;
+    } | undefined;
+    readonly tool_stream?: boolean | undefined;
+}, import("../route/transport/http.js").HttpPrepared<string>, import("../route/client.js").CompactionOperations | undefined>[];
+export declare const configure: (input?: LanguageModelOptions) => {
+    id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+    model: (modelID: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, import("../route/client.js").CompactionOperations | undefined>;
+    configure: (input?: LanguageModelOptions) => /*elided*/ any;
+};
+export declare const provider: {
+    id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+    model: (modelID: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, import("../route/client.js").CompactionOperations | undefined>;
+    configure: (input?: LanguageModelOptions) => {
+        id: string & import("effect/Brand").Brand<"AI.ProviderID">;
+        model: (modelID: string | ModelID) => import("../schema/options.js").LanguageModel<import("./openai-options.js").OpenAIOptionsInput, import("../route/client.js").CompactionOperations | undefined>;
+        configure: /*elided*/ any;
+    };
+};
+export declare const model: ProviderPackage.Definition<Settings, OpenAIProviderOptionsInput>["model"];
+export * as DigitalOcean from "./digitalocean.js";

package/dist/providers/digitalocean.js

@@ -0,0 +1,53 @@
+import { OpenAIChat } from "../protocols/openai-chat.js";
+import { cacheControl } from "../protocols/utils/cache.js";
+import { AuthOptions } from "../route/auth-options.js";
+import { Route } from "../route/client.js";
+import { Endpoint } from "../route/endpoint.js";
+import { Protocol } from "../route/protocol.js";
+import { ProviderID } from "../schema/index.js";
+export const id = ProviderID.make("digitalocean");
+const baseURL = "https://inference.do-ai.run/v1";
+export const protocol = Protocol.make({
+    id: "digitalocean-chat",
+    body: {
+        schema: OpenAIChat.protocol.body.schema,
+        from: (request) => OpenAIChat.fromRequest(request, { cacheControl: cacheControl() }),
+    },
+    stream: OpenAIChat.protocol.stream,
+});
+export const route = Route.make({
+    id: "digitalocean",
+    provider: id,
+    providerMetadataKey: "digitalocean",
+    protocol,
+    endpoint: Endpoint.path("/chat/completions", { baseURL }),
+    framing: OpenAIChat.framing,
+});
+export const routes = [route];
+export const configure = (input = {}) => {
+    const { apiKey: _apiKey, auth: _auth, baseURL: endpoint, ...defaults } = input;
+    const configured = route.with({
+        ...defaults,
+        endpoint: { baseURL: endpoint ?? baseURL },
+        auth: AuthOptions.bearer(input, ["DIGITALOCEAN_ACCESS_TOKEN", "DIGITALOCEAN_API_KEY", "DO_INFERENCE_API_KEY"]),
+    });
+    return {
+        id,
+        model: (modelID) => configured.model({
+            id: modelID,
+            compatibility: {
+                supportsPromptCacheKey: true,
+            },
+        }),
+        configure,
+    };
+};
+export const provider = configure();
+export const model = (modelID, { apiKey, baseURL, body, headers, ...providerOptions }) => configure({
+    apiKey,
+    baseURL,
+    headers,
+    http: { body },
+    providerOptions,
+}).model(modelID);
+export * as DigitalOcean from "./digitalocean.js";

package/dist/providers/groq.d.ts

@@ -156,6 +156,7 @@ export declare const protocol: Protocol<{
     } | null | undefined;
     readonly usage?: {
         readonly [x: string]: unknown;
+        readonly cache_read_input_tokens?: number | null | undefined;
         readonly cached_tokens?: number | null | undefined;
         readonly prompt_tokens?: number | null | undefined;
         readonly completion_tokens?: number | null | undefined;
@@ -166,6 +167,7 @@ export declare const protocol: Protocol<{
             readonly cache_write_tokens?: number | null | undefined;
         } | null | undefined;
         readonly prompt_cache_hit_tokens?: number | null | undefined;
+        readonly cache_created_input_tokens?: number | null | undefined;
         readonly completion_tokens_details?: {
             readonly [x: string]: unknown;
             readonly reasoning_tokens?: number | null | undefined;
@@ -195,6 +197,7 @@ export declare const protocol: Protocol<{
         } | null | undefined;
         readonly usage?: {
             readonly [x: string]: unknown;
+            readonly cache_read_input_tokens?: number | null | undefined;
             readonly cached_tokens?: number | null | undefined;
             readonly prompt_tokens?: number | null | undefined;
             readonly completion_tokens?: number | null | undefined;
@@ -205,6 +208,7 @@ export declare const protocol: Protocol<{
                 readonly cache_write_tokens?: number | null | undefined;
             } | null | undefined;
             readonly prompt_cache_hit_tokens?: number | null | undefined;
+            readonly cache_created_input_tokens?: number | null | undefined;
             readonly completion_tokens_details?: {
                 readonly [x: string]: unknown;
                 readonly reasoning_tokens?: number | null | undefined;

package/dist/providers/index.d.ts

@@ -14,6 +14,7 @@ export * as CloudflareWorkersAI from "./cloudflare-workers-ai.js";
 export * as DeepInfra from "./deepinfra.js";
 export * as Deepgram from "./deepgram.js";
 export * as DeepSeek from "./deepseek.js";
+export * as DigitalOcean from "./digitalocean.js";
 export * as ElevenLabs from "./elevenlabs.js";
 export * as Fal from "./fal.js";
 export * as Fireworks from "./fireworks.js";

package/dist/providers/index.js

@@ -14,6 +14,7 @@ export * as CloudflareWorkersAI from "./cloudflare-workers-ai.js";
 export * as DeepInfra from "./deepinfra.js";
 export * as Deepgram from "./deepgram.js";
 export * as DeepSeek from "./deepseek.js";
+export * as DigitalOcean from "./digitalocean.js";
 export * as ElevenLabs from "./elevenlabs.js";
 export * as Fal from "./fal.js";
 export * as Fireworks from "./fireworks.js";

package/dist/providers/openrouter.d.ts

@@ -338,6 +338,7 @@ export declare const protocol: Protocol<{
     } | null | undefined;
     readonly usage?: {
         readonly [x: string]: unknown;
+        readonly cache_read_input_tokens?: number | null | undefined;
         readonly cached_tokens?: number | null | undefined;
         readonly prompt_tokens?: number | null | undefined;
         readonly completion_tokens?: number | null | undefined;
@@ -348,6 +349,7 @@ export declare const protocol: Protocol<{
             readonly cache_write_tokens?: number | null | undefined;
         } | null | undefined;
         readonly prompt_cache_hit_tokens?: number | null | undefined;
+        readonly cache_created_input_tokens?: number | null | undefined;
         readonly completion_tokens_details?: {
             readonly [x: string]: unknown;
             readonly reasoning_tokens?: number | null | undefined;
@@ -377,6 +379,7 @@ export declare const protocol: Protocol<{
         } | null | undefined;
         readonly usage?: {
             readonly [x: string]: unknown;
+            readonly cache_read_input_tokens?: number | null | undefined;
             readonly cached_tokens?: number | null | undefined;
             readonly prompt_tokens?: number | null | undefined;
             readonly completion_tokens?: number | null | undefined;
@@ -387,6 +390,7 @@ export declare const protocol: Protocol<{
                 readonly cache_write_tokens?: number | null | undefined;
             } | null | undefined;
             readonly prompt_cache_hit_tokens?: number | null | undefined;
+            readonly cache_created_input_tokens?: number | null | undefined;
             readonly completion_tokens_details?: {
                 readonly [x: string]: unknown;
                 readonly reasoning_tokens?: number | null | undefined;

package/dist/providers/openrouter.js

@@ -6,7 +6,7 @@ import { AuthOptions } from "../route/auth-options.js";
 import { HttpOptions, ProviderID } from "../schema/index.js";
 import { SystemOne } from "../experimental/system-one.js";
 import { OpenAIChat } from "../protocols/openai-chat.js";
-import { newBreakpoints, ttlBucket } from "../protocols/utils/cache.js";
+import { cacheControl } from "../protocols/utils/cache.js";
 import { isRecord, ProviderShared } from "../protocols/shared.js";
 export const id = ProviderID.make("openrouter");
 const baseURL = "https://openrouter.ai/api/v1";
@@ -47,18 +47,6 @@ export const protocol = Protocol.make({
     },
     stream: OpenAIChat.protocol.stream,
 });
-const cacheControl = () => {
-    const breakpoints = newBreakpoints(4);
-    return (cache) => {
-        if (cache === undefined || breakpoints.remaining === 0)
-            return undefined;
-        breakpoints.remaining -= 1;
-        return {
-            type: "ephemeral",
-            ...(ttlBucket(cache.ttlSeconds) === "1h" ? { ttl: "1h" } : {}),
-        };
-    };
-};
 // OpenRouter forwards `reasoning.max_tokens` as the upstream thinking budget. Upstreams such as Anthropic and Alibaba
 // reject one that is not below the output limit; 1,024 is Anthropic's minimum budget.
 const fitReasoning = (reasoning, maxTokens) => typeof reasoning.max_tokens === "number"

package/package.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
-  "version": "0.0.0-dev-20386",
+  "version": "0.0.0-dev-20388",
   "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-20386",
+    "@opencode/http-recorder": "0.0.0-dev-20388",
     "@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-20386",
+    "@opencode/schema": "0.0.0-dev-20388",
     "aws4fetch": "1.0.20",
     "effect": "4.0.0-rc.112",
     "google-auth-library": "10.5.0"