@opencode-ai/ai 0.0.0-beta-17639 → 0.0.0-beta-17728

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

@@ -8,6 +8,8 @@ export declare const PATH = "/responses";
 declare const OpenAIResponsesBody: Schema.Struct<{
     readonly stream: Schema.Literal<true>;
     readonly input: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+        readonly type: Schema.tag<"message">;
+        readonly id: Schema.optionalKey<Schema.String>;
         readonly role: Schema.tag<"assistant">;
         readonly content: Schema.$Array<Schema.Struct<{
             readonly type: Schema.tag<"output_text">;
@@ -35,6 +37,8 @@ declare const OpenAIResponsesBody: Schema.Struct<{
             readonly mime_type: Schema.optional<Schema.String>;
         }>]>]>>;
     }>, Schema.Struct<{
+        readonly type: Schema.tag<"message">;
+        readonly id: Schema.optionalKey<Schema.String>;
         readonly role: Schema.tag<"assistant">;
         readonly content: Schema.$Array<Schema.Struct<{
             readonly type: Schema.tag<"output_text">;
@@ -54,6 +58,7 @@ declare const OpenAIResponsesBody: Schema.Struct<{
         readonly id: Schema.String;
     }>, Schema.Struct<{
         readonly type: Schema.tag<"function_call">;
+        readonly id: Schema.optionalKey<Schema.String>;
         readonly call_id: Schema.String;
         readonly name: Schema.String;
         readonly arguments: Schema.String;
@@ -93,26 +98,43 @@ declare const OpenAIResponsesBody: Schema.Struct<{
     readonly tool_choice: Schema.optional<Schema.Union<readonly [Schema.Union<readonly [Schema.Literals<readonly ["auto", "none", "required"]>, Schema.Struct<{
         readonly type: Schema.tag<"function">;
         readonly name: Schema.String;
+    }>, Schema.Struct<{
+        readonly type: Schema.tag<"allowed_tools">;
+        readonly mode: Schema.Literals<readonly ["auto", "none", "required"]>;
+        readonly tools: Schema.$Array<Schema.Struct<{
+            readonly type: Schema.tag<"function">;
+            readonly name: Schema.String;
+        }>>;
     }>]>, Schema.Struct<{
         readonly type: Schema.tag<"image_generation">;
     }>]>>;
     readonly model: Schema.String;
     readonly instructions: Schema.optional<Schema.String>;
     readonly store: Schema.optional<Schema.Boolean>;
+    readonly metadata: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
+    readonly safety_identifier: Schema.optional<Schema.String>;
+    readonly stream_options: Schema.optional<Schema.Struct<{
+        readonly include_obfuscation: Schema.optional<Schema.Boolean>;
+    }>>;
+    readonly top_logprobs: Schema.optional<Schema.Int>;
     readonly truncation: Schema.optional<Schema.Literals<readonly ["auto", "disabled"]>>;
     readonly service_tier: Schema.optional<Schema.Literals<readonly ["auto", "default", "flex", "priority"]>>;
     readonly prompt_cache_key: Schema.optional<Schema.String>;
-    readonly include: Schema.optional<Schema.$Array<Schema.Literals<readonly ["file_search_call.results", "web_search_call.results", "web_search_call.action.sources", "message.input_image.image_url", "computer_call_output.output.image_url", "code_interpreter_call.outputs", "reasoning.encrypted_content", "message.output_text.logprobs"]>>>;
+    readonly include: Schema.optional<Schema.$Array<Schema.declare<import("./utils/open-responses-options.js").ResponseIncludable, import("./utils/open-responses-options.js").ResponseIncludable>>>;
     readonly reasoning: Schema.optional<Schema.Struct<{
-        readonly effort: Schema.optional<Schema.String>;
+        readonly effort: Schema.optional<Schema.declare<import("./utils/open-responses-options.js").ReasoningEffort, import("./utils/open-responses-options.js").ReasoningEffort>>;
         readonly summary: Schema.optional<Schema.Literals<readonly ["auto", "concise", "detailed"]>>;
     }>>;
     readonly text: Schema.optional<Schema.Struct<{
-        readonly verbosity: Schema.optional<Schema.Literals<readonly ["low", "medium", "high"]>>;
+        readonly verbosity: Schema.optional<Schema.declare<import("./utils/open-responses-options.js").TextVerbosity, import("./utils/open-responses-options.js").TextVerbosity>>;
     }>>;
     readonly max_output_tokens: Schema.optional<Schema.Number>;
+    readonly max_tool_calls: Schema.optional<Schema.Int>;
+    readonly parallel_tool_calls: Schema.optional<Schema.Boolean>;
     readonly temperature: Schema.optional<Schema.Number>;
     readonly top_p: Schema.optional<Schema.Number>;
+    readonly presence_penalty: Schema.optional<Schema.Number>;
+    readonly frequency_penalty: Schema.optional<Schema.Number>;
 }>;
 export type OpenAIResponsesBody = Schema.Schema.Type<typeof OpenAIResponsesBody>;
 export declare const protocol: Protocol<{
@@ -148,17 +170,20 @@ export declare const protocol: Protocol<{
             readonly text: string;
         })[];
     } | {
+        readonly type: "message";
         readonly content: readonly {
             readonly type: "output_text";
             readonly text: string;
         }[];
         readonly role: "assistant";
+        readonly id?: string | undefined;
         readonly phase?: "commentary" | "final_answer" | undefined;
     } | {
         readonly type: "function_call";
-        readonly call_id: string;
         readonly name: string;
         readonly arguments: string;
+        readonly call_id: string;
+        readonly id?: string | undefined;
     } | {
         readonly type: "function_call_output";
         readonly call_id: string;
@@ -175,19 +200,24 @@ export declare const protocol: Protocol<{
             readonly text: string;
         })[];
     } | {
+        readonly type: "message";
         readonly content: readonly {
             readonly type: "output_text";
             readonly text: string;
         }[];
         readonly role: "assistant";
+        readonly id?: string | undefined;
         readonly phase?: "commentary" | "final_answer" | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
+    readonly metadata?: {
+        readonly [x: string]: string;
+    } | undefined;
     readonly instructions?: string | undefined;
     readonly reasoning?: {
         readonly summary?: "auto" | "concise" | "detailed" | undefined;
-        readonly effort?: string | undefined;
+        readonly effort?: import("./utils/open-responses-options.js").ReasoningEffort | undefined;
     } | undefined;
     readonly tools?: readonly ({
         readonly type: "function";
@@ -202,43 +232,59 @@ export declare const protocol: Protocol<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly quality?: "low" | "medium" | "high" | "auto" | undefined;
+        readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
         readonly partial_images?: number | undefined;
     })[] | undefined;
     readonly text?: {
-        readonly verbosity?: "low" | "medium" | "high" | undefined;
+        readonly verbosity?: import("./utils/open-responses-options.js").TextVerbosity | undefined;
     } | undefined;
     readonly temperature?: number | undefined;
-    readonly tool_choice?: "required" | "none" | "auto" | {
+    readonly tool_choice?: "required" | "auto" | "none" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "auto" | "none";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
     } | {
         readonly type: "image_generation";
     } | undefined;
     readonly top_p?: number | undefined;
-    readonly include?: readonly ("file_search_call.results" | "web_search_call.results" | "web_search_call.action.sources" | "message.input_image.image_url" | "computer_call_output.output.image_url" | "code_interpreter_call.outputs" | "reasoning.encrypted_content" | "message.output_text.logprobs")[] | undefined;
     readonly store?: boolean | undefined;
+    readonly include?: readonly import("./utils/open-responses-options.js").ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
+    readonly stream_options?: {
+        readonly include_obfuscation?: boolean | undefined;
+    } | undefined;
     readonly prompt_cache_key?: string | undefined;
+    readonly frequency_penalty?: number | undefined;
+    readonly presence_penalty?: number | undefined;
+    readonly safety_identifier?: string | undefined;
+    readonly top_logprobs?: number | undefined;
     readonly service_tier?: "default" | "auto" | "flex" | "priority" | undefined;
     readonly max_output_tokens?: number | undefined;
+    readonly max_tool_calls?: number | undefined;
+    readonly parallel_tool_calls?: boolean | undefined;
 }, string, {
     readonly [x: string]: unknown;
     readonly type: string;
+    readonly status?: unknown;
+    readonly code?: string | null | undefined;
+    readonly message?: string | undefined;
+    readonly headers?: unknown;
+    readonly text?: string | undefined;
     readonly error?: {
         readonly type?: string | null | undefined;
         readonly code?: string | null | undefined;
         readonly message?: string | null | undefined;
         readonly param?: string | null | undefined;
     } | null | undefined;
-    readonly status?: unknown;
-    readonly code?: string | null | undefined;
-    readonly message?: string | undefined;
-    readonly headers?: unknown;
-    readonly text?: string | undefined;
     readonly item?: {
         readonly [x: string]: unknown;
         readonly type: string;
@@ -251,13 +297,13 @@ export declare const protocol: Protocol<{
     readonly delta?: string | undefined;
     readonly response?: {
         readonly [x: string]: unknown;
+        readonly id?: string | undefined;
         readonly error?: {
             readonly type?: string | null | undefined;
             readonly code?: string | null | undefined;
             readonly message?: string | null | undefined;
             readonly param?: string | null | undefined;
         } | null | undefined;
-        readonly id?: string | undefined;
         readonly usage?: {
             readonly input_tokens?: number | undefined;
             readonly output_tokens?: number | undefined;
@@ -313,17 +359,20 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
             readonly text: string;
         })[];
     } | {
+        readonly type: "message";
         readonly content: readonly {
             readonly type: "output_text";
             readonly text: string;
         }[];
         readonly role: "assistant";
+        readonly id?: string | undefined;
         readonly phase?: "commentary" | "final_answer" | undefined;
     } | {
         readonly type: "function_call";
-        readonly call_id: string;
         readonly name: string;
         readonly arguments: string;
+        readonly call_id: string;
+        readonly id?: string | undefined;
     } | {
         readonly type: "function_call_output";
         readonly call_id: string;
@@ -340,19 +389,24 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
             readonly text: string;
         })[];
     } | {
+        readonly type: "message";
         readonly content: readonly {
             readonly type: "output_text";
             readonly text: string;
         }[];
         readonly role: "assistant";
+        readonly id?: string | undefined;
         readonly phase?: "commentary" | "final_answer" | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
+    readonly metadata?: {
+        readonly [x: string]: string;
+    } | undefined;
     readonly instructions?: string | undefined;
     readonly reasoning?: {
         readonly summary?: "auto" | "concise" | "detailed" | undefined;
-        readonly effort?: string | undefined;
+        readonly effort?: import("./utils/open-responses-options.js").ReasoningEffort | undefined;
     } | undefined;
     readonly tools?: readonly ({
         readonly type: "function";
@@ -367,29 +421,45 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly quality?: "low" | "medium" | "high" | "auto" | undefined;
+        readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
         readonly partial_images?: number | undefined;
     })[] | undefined;
     readonly text?: {
-        readonly verbosity?: "low" | "medium" | "high" | undefined;
+        readonly verbosity?: import("./utils/open-responses-options.js").TextVerbosity | undefined;
     } | undefined;
     readonly temperature?: number | undefined;
-    readonly tool_choice?: "required" | "none" | "auto" | {
+    readonly tool_choice?: "required" | "auto" | "none" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "auto" | "none";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
     } | {
         readonly type: "image_generation";
     } | undefined;
     readonly top_p?: number | undefined;
-    readonly include?: readonly ("file_search_call.results" | "web_search_call.results" | "web_search_call.action.sources" | "message.input_image.image_url" | "computer_call_output.output.image_url" | "code_interpreter_call.outputs" | "reasoning.encrypted_content" | "message.output_text.logprobs")[] | undefined;
     readonly store?: boolean | undefined;
+    readonly include?: readonly import("./utils/open-responses-options.js").ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
+    readonly stream_options?: {
+        readonly include_obfuscation?: boolean | undefined;
+    } | undefined;
     readonly prompt_cache_key?: string | undefined;
+    readonly frequency_penalty?: number | undefined;
+    readonly presence_penalty?: number | undefined;
+    readonly safety_identifier?: string | undefined;
+    readonly top_logprobs?: number | undefined;
     readonly service_tier?: "default" | "auto" | "flex" | "priority" | undefined;
     readonly max_output_tokens?: number | undefined;
+    readonly max_tool_calls?: number | undefined;
+    readonly parallel_tool_calls?: boolean | undefined;
 }, string>;
 export declare const transport: import("../route/transport/index.js").Transport<{
     readonly input: readonly ({
@@ -424,17 +494,20 @@ export declare const transport: import("../route/transport/index.js").Transport<
             readonly text: string;
         })[];
     } | {
+        readonly type: "message";
         readonly content: readonly {
             readonly type: "output_text";
             readonly text: string;
         }[];
         readonly role: "assistant";
+        readonly id?: string | undefined;
         readonly phase?: "commentary" | "final_answer" | undefined;
     } | {
         readonly type: "function_call";
-        readonly call_id: string;
         readonly name: string;
         readonly arguments: string;
+        readonly call_id: string;
+        readonly id?: string | undefined;
     } | {
         readonly type: "function_call_output";
         readonly call_id: string;
@@ -451,19 +524,24 @@ export declare const transport: import("../route/transport/index.js").Transport<
             readonly text: string;
         })[];
     } | {
+        readonly type: "message";
         readonly content: readonly {
             readonly type: "output_text";
             readonly text: string;
         }[];
         readonly role: "assistant";
+        readonly id?: string | undefined;
         readonly phase?: "commentary" | "final_answer" | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
+    readonly metadata?: {
+        readonly [x: string]: string;
+    } | undefined;
     readonly instructions?: string | undefined;
     readonly reasoning?: {
         readonly summary?: "auto" | "concise" | "detailed" | undefined;
-        readonly effort?: string | undefined;
+        readonly effort?: import("./utils/open-responses-options.js").ReasoningEffort | undefined;
     } | undefined;
     readonly tools?: readonly ({
         readonly type: "function";
@@ -478,29 +556,45 @@ export declare const transport: import("../route/transport/index.js").Transport<
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly quality?: "low" | "medium" | "high" | "auto" | undefined;
+        readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
         readonly partial_images?: number | undefined;
     })[] | undefined;
     readonly text?: {
-        readonly verbosity?: "low" | "medium" | "high" | undefined;
+        readonly verbosity?: import("./utils/open-responses-options.js").TextVerbosity | undefined;
     } | undefined;
     readonly temperature?: number | undefined;
-    readonly tool_choice?: "required" | "none" | "auto" | {
+    readonly tool_choice?: "required" | "auto" | "none" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "auto" | "none";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
     } | {
         readonly type: "image_generation";
     } | undefined;
     readonly top_p?: number | undefined;
-    readonly include?: readonly ("file_search_call.results" | "web_search_call.results" | "web_search_call.action.sources" | "message.input_image.image_url" | "computer_call_output.output.image_url" | "code_interpreter_call.outputs" | "reasoning.encrypted_content" | "message.output_text.logprobs")[] | undefined;
     readonly store?: boolean | undefined;
+    readonly include?: readonly import("./utils/open-responses-options.js").ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
+    readonly stream_options?: {
+        readonly include_obfuscation?: boolean | undefined;
+    } | undefined;
     readonly prompt_cache_key?: string | undefined;
+    readonly frequency_penalty?: number | undefined;
+    readonly presence_penalty?: number | undefined;
+    readonly safety_identifier?: string | undefined;
+    readonly top_logprobs?: number | undefined;
     readonly service_tier?: "default" | "auto" | "flex" | "priority" | undefined;
     readonly max_output_tokens?: number | undefined;
+    readonly max_tool_calls?: number | undefined;
+    readonly parallel_tool_calls?: boolean | undefined;
 }, import("./open-responses-channel.js").Prepared, string>;
 export declare const route: Route<{
     readonly input: readonly ({
@@ -535,17 +629,20 @@ export declare const route: Route<{
             readonly text: string;
         })[];
     } | {
+        readonly type: "message";
         readonly content: readonly {
             readonly type: "output_text";
             readonly text: string;
         }[];
         readonly role: "assistant";
+        readonly id?: string | undefined;
         readonly phase?: "commentary" | "final_answer" | undefined;
     } | {
         readonly type: "function_call";
-        readonly call_id: string;
         readonly name: string;
         readonly arguments: string;
+        readonly call_id: string;
+        readonly id?: string | undefined;
     } | {
         readonly type: "function_call_output";
         readonly call_id: string;
@@ -562,19 +659,24 @@ export declare const route: Route<{
             readonly text: string;
         })[];
     } | {
+        readonly type: "message";
         readonly content: readonly {
             readonly type: "output_text";
             readonly text: string;
         }[];
         readonly role: "assistant";
+        readonly id?: string | undefined;
         readonly phase?: "commentary" | "final_answer" | null | undefined;
     })[];
     readonly model: string;
     readonly stream: true;
+    readonly metadata?: {
+        readonly [x: string]: string;
+    } | undefined;
     readonly instructions?: string | undefined;
     readonly reasoning?: {
         readonly summary?: "auto" | "concise" | "detailed" | undefined;
-        readonly effort?: string | undefined;
+        readonly effort?: import("./utils/open-responses-options.js").ReasoningEffort | undefined;
     } | undefined;
     readonly tools?: readonly ({
         readonly type: "function";
@@ -589,28 +691,44 @@ export declare const route: Route<{
         readonly size?: string | undefined;
         readonly action?: "generate" | "auto" | "edit" | undefined;
         readonly output_format?: "png" | "jpeg" | "webp" | undefined;
-        readonly quality?: "low" | "medium" | "high" | "auto" | undefined;
+        readonly quality?: "auto" | "low" | "medium" | "high" | undefined;
         readonly background?: "auto" | "opaque" | "transparent" | undefined;
         readonly output_compression?: number | undefined;
         readonly input_fidelity?: "low" | "high" | undefined;
         readonly partial_images?: number | undefined;
     })[] | undefined;
     readonly text?: {
-        readonly verbosity?: "low" | "medium" | "high" | undefined;
+        readonly verbosity?: import("./utils/open-responses-options.js").TextVerbosity | undefined;
     } | undefined;
     readonly temperature?: number | undefined;
-    readonly tool_choice?: "required" | "none" | "auto" | {
+    readonly tool_choice?: "required" | "auto" | "none" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "auto" | "none";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
     } | {
         readonly type: "image_generation";
     } | undefined;
     readonly top_p?: number | undefined;
-    readonly include?: readonly ("file_search_call.results" | "web_search_call.results" | "web_search_call.action.sources" | "message.input_image.image_url" | "computer_call_output.output.image_url" | "code_interpreter_call.outputs" | "reasoning.encrypted_content" | "message.output_text.logprobs")[] | undefined;
     readonly store?: boolean | undefined;
+    readonly include?: readonly import("./utils/open-responses-options.js").ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
+    readonly stream_options?: {
+        readonly include_obfuscation?: boolean | undefined;
+    } | undefined;
     readonly prompt_cache_key?: string | undefined;
+    readonly frequency_penalty?: number | undefined;
+    readonly presence_penalty?: number | undefined;
+    readonly safety_identifier?: string | undefined;
+    readonly top_logprobs?: number | undefined;
     readonly service_tier?: "default" | "auto" | "flex" | "priority" | undefined;
     readonly max_output_tokens?: number | undefined;
+    readonly max_tool_calls?: number | undefined;
+    readonly parallel_tool_calls?: boolean | undefined;
 }, import("./open-responses-channel.js").Prepared>;
 export * as OpenAIResponses from "./openai-responses.js";

package/dist/protocols/openai-responses.js

@@ -37,6 +37,8 @@ const OpenAIResponsesToolChoice = Schema.Union([
 ]);
 const OpenAIResponsesInputItem = Schema.Union([
     Schema.Struct({
+        type: Schema.tag("message"),
+        id: Schema.optionalKey(Schema.String),
         role: Schema.tag("assistant"),
         content: Schema.Array(Schema.Struct({ type: Schema.tag("output_text"), text: Schema.String })),
         phase: Schema.optionalKey(Schema.NullOr(OpenResponses.MessagePhase)),
@@ -101,7 +103,7 @@ const fromRequest = Effect.fn("OpenAIResponses.fromRequest")(function* (request)
         tools: request.tools.length === 0
             ? undefined
             : yield* Effect.forEach(request.tools, (tool) => lowerTool(tool, ToolSchemaProjection.modelCompatibility(tool.inputSchema, toolSchemaCompatibility))),
-        tool_choice: request.toolChoice ? yield* lowerToolChoice(request.toolChoice, request.tools) : undefined,
+        tool_choice: body.tool_choice ?? (request.toolChoice ? yield* lowerToolChoice(request.toolChoice, request.tools) : undefined),
     };
 });
 const HOSTED_TOOLS = {
@@ -203,6 +205,6 @@ export const route = Route.make({
     endpoint,
     auth,
     transport,
-    defaults: { providerOptions: { openai: { store: false } } },
+    defaults: { providerOptions: { store: false } },
 });
 export * as OpenAIResponses from "./openai-responses.js";

package/dist/protocols/shared.d.ts

@@ -26,12 +26,10 @@ export interface ToolAccumulator {
  * when at least one is defined. Returns `undefined` when neither input nor
  * output is known so routes don't publish a misleading `0`.
  *
- * Under the additive `AI.Usage` contract, `inputTokens` and `outputTokens`
- * are the non-cached input and visible output only. The provider-supplied
- * `total` is the source of truth when present; the computed fallback
- * under-counts cache and reasoning by design and exists mainly so
- * Anthropic-style providers (which don't surface a total) still get a
- * sensible aggregate on the input + output axes.
+ * Under the inclusive `AI.Usage` contract, `inputTokens` includes cached input
+ * and `outputTokens` includes reasoning. Protocol mappers normalize those
+ * inclusive values before calling this helper. The provider-supplied total is
+ * the source of truth when present; otherwise their sum is the canonical total.
  */
 export declare const totalTokens: (inputTokens: number | undefined, outputTokens: number | undefined, total: number | undefined) => number | undefined;
 /**
@@ -43,7 +41,7 @@ export declare const totalTokens: (inputTokens: number | undefined, outputTokens
  *
  * If `total` is `undefined`, returns `undefined` (we don't fabricate
  * counts). If `subtrahend` is `undefined`, returns `total` unchanged. The
- * provider-native breakdown stays available on `Usage.native` for debugging.
+ * provider-native breakdown stays available on `Usage.providerMetadata` for debugging.
  */
 export declare const subtractTokens: (total: number | undefined, subtrahend: number | undefined) => number | undefined;
 /**
@@ -117,19 +115,15 @@ export declare const toolResultText: (part: ToolResultPart) => string;
 export declare const errorText: (error: unknown) => string;
 /**
  * `framing` step for Server-Sent Events. Decodes UTF-8, runs the SSE channel
- * decoder, and drops empty / `[DONE]` keep-alive events so the downstream
- * `decodeChunk` sees one JSON string per element. The SSE channel emits a
+ * decoder, and drops empty / `[DONE]` keep-alive events so the protocol event
+ * schema sees one JSON string per element. The SSE channel emits a
  * `Retry` control event on its error channel; we drop it here (we don't
  * implement client-driven retries). Decoder failures become provider output
  * errors so the public error channel stays `AIError`.
  */
 export declare const sseFraming: (bytes: Stream.Stream<Uint8Array, AIError>) => Stream.Stream<string, AIError>;
 /**
- * Canonical invalid-request constructor. Lift one-line `const invalid =
- * (message) => invalidRequest(message)` aliases out of every
- * route so the error constructor lives in one place. If we ever extend
- * `InvalidRequestReason` with route context or trace metadata, the change
- * lands here.
+ * Canonical invalid-request constructor shared by protocol lowering.
  */
 export declare const invalidRequest: (message: string) => AIError;
 export declare const matchToolChoice: <Auto, None, Required, Tool>(route: string, toolChoice: NonNullable<LLMRequest["toolChoice"]>, cases: {

package/dist/protocols/shared.js

@@ -19,12 +19,10 @@ export const optionalNull = (schema) => Schema.optional(Schema.NullOr(schema));
  * when at least one is defined. Returns `undefined` when neither input nor
  * output is known so routes don't publish a misleading `0`.
  *
- * Under the additive `AI.Usage` contract, `inputTokens` and `outputTokens`
- * are the non-cached input and visible output only. The provider-supplied
- * `total` is the source of truth when present; the computed fallback
- * under-counts cache and reasoning by design and exists mainly so
- * Anthropic-style providers (which don't surface a total) still get a
- * sensible aggregate on the input + output axes.
+ * Under the inclusive `AI.Usage` contract, `inputTokens` includes cached input
+ * and `outputTokens` includes reasoning. Protocol mappers normalize those
+ * inclusive values before calling this helper. The provider-supplied total is
+ * the source of truth when present; otherwise their sum is the canonical total.
  */
 export const totalTokens = (inputTokens, outputTokens, total) => {
     if (total !== undefined)
@@ -42,7 +40,7 @@ export const totalTokens = (inputTokens, outputTokens, total) => {
  *
  * If `total` is `undefined`, returns `undefined` (we don't fabricate
  * counts). If `subtrahend` is `undefined`, returns `total` unchanged. The
- * provider-native breakdown stays available on `Usage.native` for debugging.
+ * provider-native breakdown stays available on `Usage.providerMetadata` for debugging.
  */
 export const subtractTokens = (total, subtrahend) => {
     if (total === undefined)
@@ -151,19 +149,15 @@ export const errorText = (error) => {
 };
 /**
  * `framing` step for Server-Sent Events. Decodes UTF-8, runs the SSE channel
- * decoder, and drops empty / `[DONE]` keep-alive events so the downstream
- * `decodeChunk` sees one JSON string per element. The SSE channel emits a
+ * decoder, and drops empty / `[DONE]` keep-alive events so the protocol event
+ * schema sees one JSON string per element. The SSE channel emits a
  * `Retry` control event on its error channel; we drop it here (we don't
  * implement client-driven retries). Decoder failures become provider output
  * errors so the public error channel stays `AIError`.
  */
 export const sseFraming = (bytes) => bytes.pipe(Stream.decodeText(), Stream.pipeThroughChannel(Sse.decode()), Stream.catchTag("Retry", () => Stream.empty), Stream.catchTag("SseError", (error) => Stream.fail(eventError("sse", error.message))), Stream.filter((event) => event.data.length > 0 && event.data !== "[DONE]"), Stream.map((event) => event.data));
 /**
- * Canonical invalid-request constructor. Lift one-line `const invalid =
- * (message) => invalidRequest(message)` aliases out of every
- * route so the error constructor lives in one place. If we ever extend
- * `InvalidRequestReason` with route context or trace metadata, the change
- * lands here.
+ * Canonical invalid-request constructor shared by protocol lowering.
  */
 export const invalidRequest = (message) => new AIError({
     module: "ProviderShared",

package/dist/protocols/utils/bedrock-cache.js

@@ -2,16 +2,15 @@ import { Schema } from "effect";
 import { newBreakpoints, ttlBucket } from "./cache.js";
 // Bedrock cache markers are positional: emit a `cachePoint` block immediately
 // after the content the caller wants treated as a cacheable prefix. Bedrock
-// accepts optional `ttl: "5m" | "1h"` on cachePoint, mirroring Anthropic.
+// accepts optional `ttl: "5m" | "1h"` on cachePoint.
 export const CachePointBlock = Schema.Struct({
     cachePoint: Schema.Struct({
         type: Schema.tag("default"),
         ttl: Schema.optional(Schema.Literals(["5m", "1h"])),
     }),
 });
-// Bedrock-Claude enforces the same 4-breakpoint cap as the Anthropic Messages
-// API. Callers pass a shared counter through every `block()` call site so the
-// budget is respected across `system`, `messages`, and `tools`.
+// Callers pass a shared counter through every `block()` call site so the
+// four-breakpoint budget is respected across `system`, `messages`, and `tools`.
 export const BEDROCK_BREAKPOINT_CAP = 4;
 export const breakpoints = () => newBreakpoints(BEDROCK_BREAKPOINT_CAP);
 const DEFAULT_5M = { cachePoint: { type: "default" } };

package/dist/protocols/utils/cache.js

@@ -1,8 +1,5 @@
-// Shared helpers for provider cache-marker lowering. Anthropic and Bedrock
-// both enforce a 4-breakpoint cap per request and accept the same `5m`/`1h`
-// TTL buckets, so the counter and TTL mapping live here.
+// Shared counter and TTL mapping for provider cache-marker lowering.
 export const newBreakpoints = (cap) => ({ remaining: cap, dropped: 0 });
-// Returns `"1h"` for any `ttlSeconds >= 3600`, otherwise `undefined` (the
-// provider default 5m). Anthropic & Bedrock both treat anything shorter than
-// an hour as 5m.
+// 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;