@opencode-ai/ai 0.0.0-dev-17675 → 0.0.0-dev-17684

package/README.md

@@ -237,11 +237,11 @@ Prompt caching is **on by default**. Every `LLMRequest` resolves to `cache: "aut
 
 ### Auto placement
 
-`"auto"` places up to four breakpoints — the last tool definition, the first system part, the last system part when distinct, and the final message boundary. These expose successively larger reusable prefixes for tools, the base agent, project instructions, and the active conversation. The rolling final-message boundary is the load-bearing detail in tool loops: it advances on every request so the previous cache entry stays within Anthropic's 20-block lookback.
+`"auto"` places up to four breakpoints — the last tool definition, the first system part, the last system part when distinct, and the final message boundary. These expose successively larger reusable prefixes for tools, the base agent, project instructions, and the active conversation. The rolling final-message boundary advances on every request so recent conversation prefixes remain reusable during tool loops.
 
 Tools precede every system and conversation block in the provider prefix, so tool definitions must remain byte-stable and deterministically ordered for downstream breakpoints to remain reusable.
 
-The math justifies the default: Anthropic's 5-minute cache write is 1.25× base, read is 0.1×, so a single reuse within 5 minutes already wins. One-shot completions below the per-model minimum-cacheable-token threshold silently no-op on the wire, so the worst case is harmless.
+Requests below a provider's minimum cacheable size simply do not produce a reusable cache entry.
 
 ### Opting out
 
@@ -285,6 +285,7 @@ LLM.request({
 | ----------------------- | ------------------------------------------------------------------------- |
 | Anthropic Messages      | emits up to 4 `cache_control` markers (4-breakpoint cap enforced)         |
 | Bedrock Converse        | emits up to 4 `cachePoint` blocks (4-breakpoint cap enforced)             |
+| OpenRouter              | emits up to 4 `cache_control` markers                                     |
 | OpenAI Chat / Responses | no-op (implicit caching above 1024 tokens)                                |
 | Gemini                  | no-op (implicit caching on 2.5+; explicit `CachedContent` is out-of-band) |
 
@@ -371,11 +372,23 @@ Request options in order of stability:
 
 1. **`generation`** — portable knobs (`maxTokens`, `temperature`, `topP`, `topK`, penalties, seed, stop).
 2. **`promptCacheKey`** — stable cache affinity lowered by every protocol that supports it.
-3. **`providerOptions: { <provider>: {...} }`** — typed-at-the-facade provider-specific knobs (OpenAI `store`, Anthropic `thinking`, Gemini `thinkingConfig`, OpenRouter routing).
+3. **`providerOptions: { ... }`** — flat options inferred from the selected model (OpenAI `store`, Anthropic `thinking`, Gemini `thinkingConfig`, OpenRouter routing).
 4. **`http: { body, headers, query }`** — last-resort serializable overlays merged into the final HTTP request. Reach for this only when a stable typed path doesn't yet exist.
 
 Route/provider defaults are overridden by request-level values for each axis.
 
+The selected model supplies the provider-specific option type, so per-request overrides stay flat while the canonical runtime request remains provider-neutral:
+
+```ts
+LLM.request({
+  model,
+  prompt,
+  providerOptions: {
+    reasoningEffort: "low",
+  },
+})
+```
+
 ## Routes
 
 Adding a new model or deployment is usually 5-15 lines using `Route.make({ protocol, endpoint, auth, framing, ... })`. The route owns endpoint/auth/framing and the protocol owns body construction plus stream parsing. Transports are reusable IO templates that receive route endpoint/auth at compile time. Capability/catalog metadata lives outside this low-level package; unsupported request shapes fail during protocol lowering. See `AGENTS.md` for the architectural detail.
@@ -387,6 +400,5 @@ This package is built on Effect. Public methods return `Effect` or `Stream`; pro
 ## See also
 
 - `AGENTS.md` — architecture, route construction, contributor guide
-- `STATUS.md` — native provider parity status and AI SDK migration gaps
 - `example/tutorial.ts` — runnable end-to-end walkthrough
 - `test/provider/*.test.ts` — fixture-first protocol tests; `*.recorded.test.ts` files cover live cassettes

package/dist/cache-policy.js

@@ -5,8 +5,8 @@
 // The default `"auto"` shape places breakpoints at the last tool definition,
 // the first and last distinct system parts, and the conversation tail. This
 // exposes reusable tool, base-agent, project, and session prefixes while
-// advancing the tail after each tool result keeps the previous cache entry
-// within Anthropic's 20-block lookback during long agent turns.
+// advancing the tail after each tool result keeps recent conversation prefixes
+// reusable during long agent runs.
 //
 // Manual `cache: CacheHint` placements on individual parts are preserved and
 // count against the four-breakpoint budget; auto only fills remaining slots.
@@ -20,9 +20,7 @@ const AUTO = {
 const NONE = {};
 const BREAKPOINT_CAP = 4;
 // Resolution rules:
-//   - undefined   → "auto" — caching is on by default. The math favors it:
-//                   Anthropic 5m-cache write is 1.25x base, read is 0.1x,
-//                   so a single reuse within 5 minutes already wins.
+//   - undefined   → "auto" — caching is on by default.
 //   - "auto"      → tools + first/last system + final message boundary.
 //   - "none"      → no auto placement; manual `CacheHint`s still flow.
 //   - object form → exactly what the caller asked for.

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

@@ -1,7 +1,6 @@
 import { Schema } from "effect";
 import { Route } from "../route/client.js";
 import { Protocol } from "../route/protocol.js";
-import { type ProviderOptions } from "../schema/index.js";
 import { Lifecycle } from "./utils/lifecycle.js";
 import { ToolStream } from "./utils/tool-stream.js";
 export declare const DEFAULT_BASE_URL = "https://api.anthropic.com/v1";
@@ -25,9 +24,7 @@ export interface OptionsInput {
     readonly thinking?: ThinkingInput;
     readonly effort?: string;
 }
-export type ProviderOptionsInput = ProviderOptions & {
-    readonly anthropic?: OptionsInput;
-};
+export type ProviderOptionsInput = OptionsInput;
 export declare const AnthropicMessagesBody: Schema.Struct<{
     model: Schema.String;
     system: Schema.optional<Schema.$Array<Schema.Struct<{
@@ -207,8 +204,8 @@ export declare const AnthropicMessagesBody: Schema.Struct<{
 export type AnthropicMessagesBody = Schema.Schema.Type<typeof AnthropicMessagesBody>;
 /**
  * The Anthropic Messages protocol — request body construction, body schema,
- * and the streaming-event state machine. Used by native Anthropic Cloud and
- * (once registered) Vertex Anthropic / Bedrock-hosted Anthropic passthrough.
+ * and the streaming-event state machine shared by Anthropic-compatible and
+ * Vertex-hosted Messages routes.
  */
 export declare const protocol: Protocol<{
     readonly max_tokens: number;
@@ -346,14 +343,6 @@ export declare const protocol: Protocol<{
         }[];
     })[];
     readonly stream: true;
-    readonly system?: readonly {
-        readonly type: "text";
-        readonly text: string;
-        readonly cache_control?: {
-            readonly type: "ephemeral";
-            readonly ttl?: "1h" | "5m" | undefined;
-        } | undefined;
-    }[] | undefined;
     readonly tools?: readonly {
         readonly description: string;
         readonly name: string;
@@ -365,6 +354,14 @@ export declare const protocol: Protocol<{
             readonly ttl?: "1h" | "5m" | undefined;
         } | undefined;
     }[] | undefined;
+    readonly system?: readonly {
+        readonly type: "text";
+        readonly text: string;
+        readonly cache_control?: {
+            readonly type: "ephemeral";
+            readonly ttl?: "1h" | "5m" | undefined;
+        } | undefined;
+    }[] | undefined;
     readonly temperature?: number | undefined;
     readonly thinking?: {
         readonly type: "enabled";
@@ -376,7 +373,7 @@ export declare const protocol: Protocol<{
         readonly type: "disabled";
     } | undefined;
     readonly tool_choice?: {
-        readonly type: "none" | "auto" | "any";
+        readonly type: "auto" | "none" | "any";
     } | {
         readonly type: "tool";
         readonly name: string;
@@ -389,10 +386,6 @@ export declare const protocol: Protocol<{
     } | undefined;
 }, string, {
     readonly type: string;
-    readonly error?: {
-        readonly type?: string | undefined;
-        readonly message?: string | undefined;
-    } | undefined;
     readonly message?: {
         readonly usage?: {
             readonly [x: string]: unknown;
@@ -410,6 +403,10 @@ export declare const protocol: Protocol<{
             } | null | undefined;
         } | undefined;
     } | undefined;
+    readonly error?: {
+        readonly type?: string | undefined;
+        readonly message?: string | undefined;
+    } | undefined;
     readonly delta?: {
         readonly type?: string | undefined;
         readonly text?: string | undefined;
@@ -588,14 +585,6 @@ export declare const route: Route<{
         }[];
     })[];
     readonly stream: true;
-    readonly system?: readonly {
-        readonly type: "text";
-        readonly text: string;
-        readonly cache_control?: {
-            readonly type: "ephemeral";
-            readonly ttl?: "1h" | "5m" | undefined;
-        } | undefined;
-    }[] | undefined;
     readonly tools?: readonly {
         readonly description: string;
         readonly name: string;
@@ -607,6 +596,14 @@ export declare const route: Route<{
             readonly ttl?: "1h" | "5m" | undefined;
         } | undefined;
     }[] | undefined;
+    readonly system?: readonly {
+        readonly type: "text";
+        readonly text: string;
+        readonly cache_control?: {
+            readonly type: "ephemeral";
+            readonly ttl?: "1h" | "5m" | undefined;
+        } | undefined;
+    }[] | undefined;
     readonly temperature?: number | undefined;
     readonly thinking?: {
         readonly type: "enabled";
@@ -618,7 +615,7 @@ export declare const route: Route<{
         readonly type: "disabled";
     } | undefined;
     readonly tool_choice?: {
-        readonly type: "none" | "auto" | "any";
+        readonly type: "auto" | "none" | "any";
     } | {
         readonly type: "tool";
         readonly name: string;

package/dist/protocols/anthropic-messages.js

@@ -468,7 +468,7 @@ const lowerMessages = Effect.fn("AnthropicMessages.lowerMessages")(function* (re
     return messages;
 });
 const resolveOptions = Effect.fn("AnthropicMessages.resolveOptions")(function* (request) {
-    const input = request.providerOptions?.anthropic;
+    const input = request.providerOptions;
     return {
         thinking: yield* resolveThinking(input?.thinking),
         effort: typeof input?.effort === "string" ? input.effort : undefined,
@@ -844,8 +844,8 @@ const step = (state, event) => {
 // =============================================================================
 /**
  * The Anthropic Messages protocol — request body construction, body schema,
- * and the streaming-event state machine. Used by native Anthropic Cloud and
- * (once registered) Vertex Anthropic / Bedrock-hosted Anthropic passthrough.
+ * and the streaming-event state machine shared by Anthropic-compatible and
+ * Vertex-hosted Messages routes.
  */
 export const protocol = Protocol.make({
     id: ADAPTER,

package/dist/protocols/gemini.d.ts

@@ -1,7 +1,6 @@
 import { Schema } from "effect";
 import { Route } from "../route/client.js";
 import { Protocol } from "../route/protocol.js";
-import { type ProviderOptions } from "../schema/index.js";
 import { Lifecycle } from "./utils/lifecycle.js";
 export declare const DEFAULT_BASE_URL = "https://generativelanguage.googleapis.com/v1beta";
 export interface OptionsInput {
@@ -18,9 +17,7 @@ export interface OptionsInput {
         readonly thinkingLevel?: "minimal" | "low" | "medium" | "high" | (string & {});
     };
 }
-export type ProviderOptionsInput = ProviderOptions & {
-    readonly gemini?: OptionsInput;
-};
+export type ProviderOptionsInput = OptionsInput;
 declare const GeminiBody: Schema.Struct<{
     cachedContent: Schema.optional<Schema.String>;
     contents: Schema.$Array<Schema.Struct<{
@@ -98,12 +95,11 @@ declare const GeminiBody: Schema.Struct<{
 export type GeminiBody = Schema.Schema.Type<typeof GeminiBody>;
 /**
  * The Gemini protocol — request body construction, body schema, and the
- * streaming-event state machine. Used by Google AI Studio Gemini and (once
- * registered) Vertex Gemini.
+ * streaming-event state machine shared by Google AI Studio and Vertex Gemini.
  */
 export declare const protocol: Protocol<{
     readonly contents: readonly {
-        readonly role: "user" | "model";
+        readonly role: "model" | "user";
         readonly parts: readonly ({
             readonly inlineData: {
                 readonly mimeType: string;
@@ -181,7 +177,7 @@ export declare const protocol: Protocol<{
 }, string, {
     readonly candidates?: readonly {
         readonly content?: {
-            readonly role: "user" | "model";
+            readonly role: "model" | "user";
             readonly parts: readonly ({
                 readonly inlineData: {
                     readonly mimeType: string;
@@ -234,7 +230,7 @@ export declare const protocol: Protocol<{
 }>;
 export declare const route: Route<{
     readonly contents: readonly {
-        readonly role: "user" | "model";
+        readonly role: "model" | "user";
         readonly parts: readonly ({
             readonly inlineData: {
                 readonly mimeType: string;

package/dist/protocols/gemini.js

@@ -293,7 +293,7 @@ const lowerMessages = Effect.fn("Gemini.lowerMessages")(function* (request) {
     return contents;
 });
 const resolveOptions = (request) => {
-    const input = request.providerOptions?.gemini;
+    const input = request.providerOptions;
     const value = input?.thinkingConfig;
     const thinkingConfig = {
         thinkingBudget: ProviderShared.isRecord(value) && typeof value.thinkingBudget === "number" ? value.thinkingBudget : undefined,
@@ -491,8 +491,7 @@ const step = (state, event) => {
 // =============================================================================
 /**
  * The Gemini protocol — request body construction, body schema, and the
- * streaming-event state machine. Used by Google AI Studio Gemini and (once
- * registered) Vertex Gemini.
+ * streaming-event state machine shared by Google AI Studio and Vertex Gemini.
  */
 export const protocol = Protocol.make({
     id: ADAPTER,

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

@@ -191,11 +191,11 @@ export declare const coreFields: {
     prompt_cache_key: Schema.optional<Schema.String>;
     include: Schema.optional<Schema.$Array<Schema.declare<OpenResponsesOptions.ResponseIncludable, OpenResponsesOptions.ResponseIncludable>>>;
     reasoning: Schema.optional<Schema.Struct<{
-        readonly effort: Schema.optional<Schema.String>;
+        readonly effort: Schema.optional<Schema.declare<OpenResponsesOptions.ReasoningEffort, OpenResponsesOptions.ReasoningEffort>>;
         readonly summary: Schema.optional<Schema.Literals<readonly ["auto", "concise", "detailed"]>>;
     }>>;
     text: Schema.optional<Schema.Struct<{
-        readonly verbosity: Schema.optional<Schema.Literals<readonly ["low", "medium", "high"]>>;
+        readonly verbosity: Schema.optional<Schema.declare<OpenResponsesOptions.TextVerbosity, OpenResponsesOptions.TextVerbosity>>;
     }>>;
     max_output_tokens: Schema.optional<Schema.Number>;
     max_tool_calls: Schema.optional<Schema.Int>;
@@ -290,11 +290,11 @@ declare const OpenResponsesBody: Schema.Struct<{
     readonly prompt_cache_key: Schema.optional<Schema.String>;
     readonly include: Schema.optional<Schema.$Array<Schema.declare<OpenResponsesOptions.ResponseIncludable, OpenResponsesOptions.ResponseIncludable>>>;
     readonly reasoning: Schema.optional<Schema.Struct<{
-        readonly effort: Schema.optional<Schema.String>;
+        readonly effort: Schema.optional<Schema.declare<OpenResponsesOptions.ReasoningEffort, OpenResponsesOptions.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<OpenResponsesOptions.TextVerbosity, OpenResponsesOptions.TextVerbosity>>;
     }>>;
     readonly max_output_tokens: Schema.optional<Schema.Number>;
     readonly max_tool_calls: Schema.optional<Schema.Int>;
@@ -330,18 +330,18 @@ export declare const WebSocketErrorEvent: Schema.StructWithRest<Schema.Struct<{
 export declare const decodeKnownErrorEvent: (event: Event) => Effect.Effect<{
     readonly [x: string]: unknown;
     readonly type: "error";
-    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?: number | undefined;
     readonly code?: string | null | undefined;
     readonly message?: string | undefined;
     readonly headers?: {
         readonly [x: string]: string | number | boolean;
     } | 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 param?: string | null | undefined;
     readonly status_code?: number | undefined;
 }, Schema.SchemaError, never>;
@@ -437,7 +437,7 @@ export declare const lowerTool: (protocolName: string, tool: ToolDefinition, inp
     };
     strict: boolean;
 }, AIError, never>;
-export declare const lowerToolChoice: (protocolName: string, toolChoice: NonNullable<LLMRequest["toolChoice"]>) => Effect.Effect<"required" | "none" | "auto" | {
+export declare const lowerToolChoice: (protocolName: string, toolChoice: NonNullable<LLMRequest["toolChoice"]>) => Effect.Effect<"required" | "auto" | "none" | {
     type: "function";
     name: string;
 }, AIError, never>;
@@ -447,10 +447,10 @@ export declare const fromRequestWithExtension: (request: LLMRequest, extension:
     max_tool_calls?: number | undefined;
     service_tier?: "default" | "auto" | "flex" | "priority" | undefined;
     text?: {
-        verbosity: "low" | "medium" | "high";
+        verbosity: OpenResponsesOptions.TextVerbosity;
     } | undefined;
     reasoning?: {
-        effort: string | undefined;
+        effort: OpenResponsesOptions.ReasoningEffort | undefined;
         summary: "auto" | "concise" | "detailed" | undefined;
     } | undefined;
     include?: readonly OpenResponsesOptions.ResponseIncludable[] | undefined;
@@ -468,9 +468,9 @@ export declare const fromRequestWithExtension: (request: LLMRequest, extension:
         };
         strict: boolean;
     }[] | undefined;
-    tool_choice: "required" | "none" | "auto" | {
+    tool_choice: "required" | "auto" | "none" | {
         type: "allowed_tools";
-        mode: "required" | "none" | "auto";
+        mode: "required" | "auto" | "none";
         tools: {
             type: "function";
             name: string;
@@ -549,7 +549,7 @@ export declare const fromRequest: (request: LLMRequest) => Effect.Effect<{
     readonly instructions?: string | undefined;
     readonly reasoning?: {
         readonly summary?: "auto" | "concise" | "detailed" | undefined;
-        readonly effort?: string | undefined;
+        readonly effort?: OpenResponsesOptions.ReasoningEffort | undefined;
     } | undefined;
     readonly tools?: readonly {
         readonly type: "function";
@@ -561,15 +561,15 @@ export declare const fromRequest: (request: LLMRequest) => Effect.Effect<{
         readonly strict?: boolean | undefined;
     }[] | undefined;
     readonly text?: {
-        readonly verbosity?: "low" | "medium" | "high" | undefined;
+        readonly verbosity?: OpenResponsesOptions.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" | "none" | "auto";
+        readonly mode: "required" | "auto" | "none";
         readonly tools: readonly {
             readonly type: "function";
             readonly name: string;
@@ -843,7 +843,7 @@ export declare const protocol: Protocol<{
     readonly instructions?: string | undefined;
     readonly reasoning?: {
         readonly summary?: "auto" | "concise" | "detailed" | undefined;
-        readonly effort?: string | undefined;
+        readonly effort?: OpenResponsesOptions.ReasoningEffort | undefined;
     } | undefined;
     readonly tools?: readonly {
         readonly type: "function";
@@ -855,15 +855,15 @@ export declare const protocol: Protocol<{
         readonly strict?: boolean | undefined;
     }[] | undefined;
     readonly text?: {
-        readonly verbosity?: "low" | "medium" | "high" | undefined;
+        readonly verbosity?: OpenResponsesOptions.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" | "none" | "auto";
+        readonly mode: "required" | "auto" | "none";
         readonly tools: readonly {
             readonly type: "function";
             readonly name: string;
@@ -881,17 +881,17 @@ export declare const protocol: Protocol<{
 }, 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;
@@ -904,13 +904,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;
@@ -998,7 +998,7 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
     readonly instructions?: string | undefined;
     readonly reasoning?: {
         readonly summary?: "auto" | "concise" | "detailed" | undefined;
-        readonly effort?: string | undefined;
+        readonly effort?: OpenResponsesOptions.ReasoningEffort | undefined;
     } | undefined;
     readonly tools?: readonly {
         readonly type: "function";
@@ -1010,15 +1010,15 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         readonly strict?: boolean | undefined;
     }[] | undefined;
     readonly text?: {
-        readonly verbosity?: "low" | "medium" | "high" | undefined;
+        readonly verbosity?: OpenResponsesOptions.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" | "none" | "auto";
+        readonly mode: "required" | "auto" | "none";
         readonly tools: readonly {
             readonly type: "function";
             readonly name: string;

package/dist/protocols/open-responses.js

@@ -214,7 +214,7 @@ export const lowerTool = Effect.fn("OpenResponses.lowerTool")(function* (protoco
         name: tool.name,
         description: tool.description,
         parameters: ToolSchemaProjection.responses(inputSchema),
-        // TODO: Read this from Responses tool options so direct LLM callers can opt into strict schemas.
+        // The common tool definition does not currently express Responses strict-schema policy.
         strict: false,
     };
 });

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

@@ -95,7 +95,7 @@ export declare const bodyFields: {
     }>>;
     store: Schema.optional<Schema.Boolean>;
     prompt_cache_key: Schema.optional<Schema.String>;
-    reasoning_effort: Schema.optional<Schema.String>;
+    reasoning_effort: Schema.optional<Schema.declare<import("./utils/open-responses-options.js").ReasoningEffort, import("./utils/open-responses-options.js").ReasoningEffort>>;
     max_completion_tokens: Schema.optional<Schema.Number>;
     max_tokens: Schema.optional<Schema.Number>;
     temperature: Schema.optional<Schema.Number>;
@@ -189,7 +189,7 @@ declare const OpenAIChatBody: Schema.Struct<{
     }>>;
     store: Schema.optional<Schema.Boolean>;
     prompt_cache_key: Schema.optional<Schema.String>;
-    reasoning_effort: Schema.optional<Schema.String>;
+    reasoning_effort: Schema.optional<Schema.declare<import("./utils/open-responses-options.js").ReasoningEffort, import("./utils/open-responses-options.js").ReasoningEffort>>;
     max_completion_tokens: Schema.optional<Schema.Number>;
     max_tokens: Schema.optional<Schema.Number>;
     temperature: Schema.optional<Schema.Number>;
@@ -263,7 +263,7 @@ interface LoweringOptions {
     readonly cacheControl?: (cache: CacheHint | undefined) => Schema.Schema.Type<typeof OpenAIChatCacheControl> | undefined;
 }
 export declare const fromRequest: (request: LLMRequest, options?: LoweringOptions | undefined) => Effect.Effect<{
-    reasoning_effort?: string | undefined;
+    reasoning_effort?: import("./utils/open-responses-options.js").ReasoningEffort | undefined;
     prompt_cache_key?: string | undefined;
     store?: boolean | undefined;
     temperature: number | undefined;
@@ -347,7 +347,7 @@ export declare const fromRequest: (request: LLMRequest, options?: LoweringOption
             readonly ttl?: string | undefined;
         } | undefined;
     }[] | undefined;
-    tool_choice: "required" | "none" | "auto" | {
+    tool_choice: "required" | "auto" | "none" | {
         type: "function";
         function: {
             name: string;
@@ -358,7 +358,7 @@ export declare const fromRequest: (request: LLMRequest, options?: LoweringOption
         include_usage: boolean;
     };
 } | {
-    reasoning_effort?: string | undefined;
+    reasoning_effort?: import("./utils/open-responses-options.js").ReasoningEffort | undefined;
     prompt_cache_key?: string | undefined;
     store?: boolean | undefined;
     temperature: number | undefined;
@@ -442,7 +442,7 @@ export declare const fromRequest: (request: LLMRequest, options?: LoweringOption
             readonly ttl?: string | undefined;
         } | undefined;
     }[] | undefined;
-    tool_choice: "required" | "none" | "auto" | {
+    tool_choice: "required" | "auto" | "none" | {
         type: "function";
         function: {
             name: string;
@@ -521,7 +521,6 @@ export declare const protocol: Protocol<{
         } | undefined;
     })[];
     readonly stream: true;
-    readonly stop?: readonly string[] | undefined;
     readonly max_completion_tokens?: number | undefined;
     readonly max_tokens?: number | undefined;
     readonly tools?: readonly {
@@ -538,9 +537,10 @@ export declare const protocol: Protocol<{
             readonly ttl?: string | undefined;
         } | undefined;
     }[] | undefined;
+    readonly stop?: readonly string[] | undefined;
     readonly temperature?: number | undefined;
     readonly seed?: number | undefined;
-    readonly tool_choice?: "required" | "none" | "auto" | {
+    readonly tool_choice?: "required" | "auto" | "none" | {
         readonly type: "function";
         readonly function: {
             readonly name: string;
@@ -552,7 +552,7 @@ export declare const protocol: Protocol<{
         readonly include_usage: boolean;
     } | undefined;
     readonly prompt_cache_key?: string | undefined;
-    readonly reasoning_effort?: string | undefined;
+    readonly reasoning_effort?: import("./utils/open-responses-options.js").ReasoningEffort | undefined;
     readonly frequency_penalty?: number | undefined;
     readonly presence_penalty?: number | undefined;
 }, string, {
@@ -660,7 +660,6 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         } | undefined;
     })[];
     readonly stream: true;
-    readonly stop?: readonly string[] | undefined;
     readonly max_completion_tokens?: number | undefined;
     readonly max_tokens?: number | undefined;
     readonly tools?: readonly {
@@ -677,9 +676,10 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
             readonly ttl?: string | undefined;
         } | undefined;
     }[] | undefined;
+    readonly stop?: readonly string[] | undefined;
     readonly temperature?: number | undefined;
     readonly seed?: number | undefined;
-    readonly tool_choice?: "required" | "none" | "auto" | {
+    readonly tool_choice?: "required" | "auto" | "none" | {
         readonly type: "function";
         readonly function: {
             readonly name: string;
@@ -691,7 +691,7 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
         readonly include_usage: boolean;
     } | undefined;
     readonly prompt_cache_key?: string | undefined;
-    readonly reasoning_effort?: string | undefined;
+    readonly reasoning_effort?: import("./utils/open-responses-options.js").ReasoningEffort | undefined;
     readonly frequency_penalty?: number | undefined;
     readonly presence_penalty?: number | undefined;
 }, string>;
@@ -757,7 +757,6 @@ export declare const route: Route<{
         } | undefined;
     })[];
     readonly stream: true;
-    readonly stop?: readonly string[] | undefined;
     readonly max_completion_tokens?: number | undefined;
     readonly max_tokens?: number | undefined;
     readonly tools?: readonly {
@@ -774,9 +773,10 @@ export declare const route: Route<{
             readonly ttl?: string | undefined;
         } | undefined;
     }[] | undefined;
+    readonly stop?: readonly string[] | undefined;
     readonly temperature?: number | undefined;
     readonly seed?: number | undefined;
-    readonly tool_choice?: "required" | "none" | "auto" | {
+    readonly tool_choice?: "required" | "auto" | "none" | {
         readonly type: "function";
         readonly function: {
             readonly name: string;
@@ -788,7 +788,7 @@ export declare const route: Route<{
         readonly include_usage: boolean;
     } | undefined;
     readonly prompt_cache_key?: string | undefined;
-    readonly reasoning_effort?: string | undefined;
+    readonly reasoning_effort?: import("./utils/open-responses-options.js").ReasoningEffort | undefined;
     readonly frequency_penalty?: number | undefined;
     readonly presence_penalty?: number | undefined;
 }, HttpTransport.HttpPrepared<string>>;