@opencode-ai/ai 0.0.0-dev-17643 → 0.0.0-dev-17652

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

@@ -3,6 +3,7 @@ import { HttpTransport } from "../route/transport/index.js";
 import { Protocol } from "../route/protocol.js";
 import { AIError, LLMEvent, Usage, type LLMRequest, type MediaPart, type ProviderMetadata, type ToolDefinition } from "../schema/index.js";
 import { ProviderShared } from "./shared.js";
+import { OpenResponsesOptions } from "./utils/open-responses-options.js";
 import { Lifecycle } from "./utils/lifecycle.js";
 import { ToolStream } from "./utils/tool-stream.js";
 export declare const PATH = "/responses";
@@ -96,6 +97,13 @@ export declare const Tool: Schema.Struct<{
 export declare const ToolChoice: 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;
+    }>>;
 }>]>;
 export declare const coreFields: {
     model: Schema.String;
@@ -169,12 +177,19 @@ export declare const coreFields: {
     tool_choice: Schema.optional<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;
+        }>>;
     }>]>>;
     store: Schema.optional<Schema.Boolean>;
     truncation: Schema.optional<Schema.Literals<readonly ["auto", "disabled"]>>;
     service_tier: Schema.optional<Schema.Literals<readonly ["auto", "default", "flex", "priority"]>>;
     prompt_cache_key: Schema.optional<Schema.String>;
-    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"]>>>;
+    include: Schema.optional<Schema.$Array<Schema.declare<OpenResponsesOptions.ResponseIncludable, OpenResponsesOptions.ResponseIncludable>>>;
     reasoning: Schema.optional<Schema.Struct<{
         readonly effort: Schema.optional<Schema.String>;
         readonly summary: Schema.optional<Schema.Literals<readonly ["auto", "concise", "detailed"]>>;
@@ -183,6 +198,8 @@ export declare const coreFields: {
         readonly verbosity: Schema.optional<Schema.Literals<readonly ["low", "medium", "high"]>>;
     }>>;
     max_output_tokens: Schema.optional<Schema.Number>;
+    max_tool_calls: Schema.optional<Schema.Int>;
+    parallel_tool_calls: Schema.optional<Schema.Boolean>;
     temperature: Schema.optional<Schema.Number>;
     top_p: Schema.optional<Schema.Number>;
 };
@@ -259,12 +276,19 @@ declare const OpenResponsesBody: Schema.Struct<{
     readonly tool_choice: Schema.optional<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;
+        }>>;
     }>]>>;
     readonly store: Schema.optional<Schema.Boolean>;
     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<OpenResponsesOptions.ResponseIncludable, OpenResponsesOptions.ResponseIncludable>>>;
     readonly reasoning: Schema.optional<Schema.Struct<{
         readonly effort: Schema.optional<Schema.String>;
         readonly summary: Schema.optional<Schema.Literals<readonly ["auto", "concise", "detailed"]>>;
@@ -273,6 +297,8 @@ declare const OpenResponsesBody: Schema.Struct<{
         readonly verbosity: Schema.optional<Schema.Literals<readonly ["low", "medium", "high"]>>;
     }>>;
     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>;
 }>;
@@ -417,6 +443,8 @@ export declare const lowerToolChoice: (protocolName: string, toolChoice: NonNull
 }, AIError, never>;
 export declare const fromRequestWithExtension: (request: LLMRequest, extension: Extension) => Effect.Effect<{
     truncation?: "auto" | "disabled" | undefined;
+    parallel_tool_calls?: boolean | undefined;
+    max_tool_calls?: number | undefined;
     service_tier?: "default" | "auto" | "flex" | "priority" | undefined;
     text?: {
         verbosity: "low" | "medium" | "high";
@@ -425,7 +453,7 @@ export declare const fromRequestWithExtension: (request: LLMRequest, extension:
         effort: string | undefined;
         summary: "auto" | "concise" | "detailed" | undefined;
     } | undefined;
-    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;
+    include?: readonly OpenResponsesOptions.ResponseIncludable[] | undefined;
     prompt_cache_key?: string | undefined;
     store?: boolean | undefined;
     instructions?: string | undefined;
@@ -441,6 +469,13 @@ export declare const fromRequestWithExtension: (request: LLMRequest, extension:
         strict: boolean;
     }[] | undefined;
     tool_choice: "required" | "none" | "auto" | {
+        type: "allowed_tools";
+        mode: "required" | "none" | "auto";
+        tools: {
+            type: "function";
+            name: string;
+        }[];
+    } | {
         type: "function";
         name: string;
     } | undefined;
@@ -532,14 +567,23 @@ export declare const fromRequest: (request: LLMRequest) => Effect.Effect<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
     } | 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 OpenResponsesOptions.ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
     readonly prompt_cache_key?: string | 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;
 }, AIError, never>;
 export declare const providerMetadata: (state: ParserState, metadata: Record<string, unknown>) => ProviderMetadata;
 export type StepResult = readonly [ParserState, ReadonlyArray<LLMEvent>];
@@ -817,14 +861,23 @@ export declare const protocol: Protocol<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
     } | 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 OpenResponsesOptions.ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
     readonly prompt_cache_key?: string | 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;
@@ -963,13 +1016,22 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
     } | 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 OpenResponsesOptions.ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
     readonly prompt_cache_key?: string | 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 * as OpenResponses from "./open-responses.js";

package/dist/protocols/open-responses.js

@@ -94,6 +94,11 @@ export const Tool = Schema.Struct({
 export const ToolChoice = Schema.Union([
     Schema.Literals(["auto", "none", "required"]),
     Schema.Struct({ type: Schema.tag("function"), name: Schema.String }),
+    Schema.Struct({
+        type: Schema.tag("allowed_tools"),
+        mode: Schema.Literals(["auto", "none", "required"]),
+        tools: Schema.Array(Schema.Struct({ type: Schema.tag("function"), name: Schema.String })),
+    }),
 ]);
 // Fields shared between the HTTP body and the WebSocket `response.create`
 // message. The HTTP body adds `stream: true`; the WebSocket message adds
@@ -118,6 +123,8 @@ export const coreFields = {
         verbosity: Schema.optional(OpenResponsesOptions.TextVerbositySchema),
     })),
     max_output_tokens: Schema.optional(Schema.Number),
+    max_tool_calls: Schema.optional(Schema.Int),
+    parallel_tool_calls: Schema.optional(Schema.Boolean),
     temperature: Schema.optional(Schema.Number),
     top_p: Schema.optional(Schema.Number),
 };
@@ -419,9 +426,21 @@ const lowerOptions = (request) => {
             : {}),
         ...(options.textVerbosity ? { text: { verbosity: options.textVerbosity } } : {}),
         ...(options.serviceTier ? { service_tier: options.serviceTier } : {}),
+        ...(options.maxToolCalls !== undefined ? { max_tool_calls: options.maxToolCalls } : {}),
+        ...(options.parallelToolCalls !== undefined ? { parallel_tool_calls: options.parallelToolCalls } : {}),
         ...(options.truncation ? { truncation: options.truncation } : {}),
     };
 };
+const allowedToolChoice = (request) => {
+    const allowed = OpenResponsesOptions.resolve(request).allowedTools;
+    if (!allowed)
+        return undefined;
+    return {
+        type: "allowed_tools",
+        mode: allowed.mode,
+        tools: allowed.toolNames.map((name) => ({ type: "function", name })),
+    };
+};
 export const fromRequestWithExtension = Effect.fn("OpenResponses.fromRequestWithExtension")(function* (request, extension) {
     const generation = request.generation;
     const toolSchemaCompatibility = request.model.compatibility?.toolSchema;
@@ -431,7 +450,8 @@ export const fromRequestWithExtension = Effect.fn("OpenResponses.fromRequestWith
         tools: request.tools.length === 0
             ? undefined
             : yield* Effect.forEach(request.tools, (tool) => lowerTool(extension.name, tool, ToolSchemaProjection.modelCompatibility(tool.inputSchema, toolSchemaCompatibility))),
-        tool_choice: request.toolChoice ? yield* lowerToolChoice(extension.name, request.toolChoice) : undefined,
+        tool_choice: allowedToolChoice(request) ??
+            (request.toolChoice ? yield* lowerToolChoice(extension.name, request.toolChoice) : undefined),
         stream: true,
         max_output_tokens: generation?.maxTokens,
         temperature: generation?.temperature,

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

@@ -88,13 +88,22 @@ export declare const route: Route<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
     } | 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 prompt_cache_key?: string | 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("../route/transport/http.js").HttpPrepared<string>>;
 export * as OpenAICompatibleResponses from "./openai-compatible-responses.js";

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

@@ -93,6 +93,13 @@ 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">;
     }>]>>;
@@ -102,7 +109,7 @@ declare const OpenAIResponsesBody: Schema.Struct<{
     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 summary: Schema.optional<Schema.Literals<readonly ["auto", "concise", "detailed"]>>;
@@ -111,6 +118,8 @@ declare const OpenAIResponsesBody: Schema.Struct<{
         readonly verbosity: Schema.optional<Schema.Literals<readonly ["low", "medium", "high"]>>;
     }>>;
     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>;
 }>;
@@ -215,16 +224,25 @@ export declare const protocol: Protocol<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        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 prompt_cache_key?: string | 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;
@@ -380,16 +398,25 @@ export declare const httpTransport: HttpTransport.HttpJsonTransport<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        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 prompt_cache_key?: string | 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 ({
@@ -491,16 +518,25 @@ export declare const transport: import("../route/transport/index.js").Transport<
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        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 prompt_cache_key?: string | 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 ({
@@ -602,15 +638,24 @@ export declare const route: Route<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        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 prompt_cache_key?: string | 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

@@ -101,7 +101,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 = {

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

@@ -1,25 +1,42 @@
 import { Schema } from "effect";
-import { TextVerbosity, type LLMRequest } from "../../schema/index.js";
+import { type LLMRequest } from "../../schema/index.js";
 export declare const ResponseIncludables: 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"];
-export type ResponseIncludable = (typeof ResponseIncludables)[number];
+export type ResponseIncludable = (typeof ResponseIncludables)[number] | (string & {});
 export declare const ServiceTiers: readonly ["auto", "default", "flex", "priority"];
 export type ServiceTier = (typeof ServiceTiers)[number];
 export declare const Truncations: readonly ["auto", "disabled"];
 export type Truncation = (typeof Truncations)[number];
 export declare const ReasoningEffort: Schema.String;
 export declare const TextVerbositySchema: Schema.Literals<readonly ["low", "medium", "high"]>;
-export declare const ResponseIncludableSchema: 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"]>;
+export declare const ResponseIncludableSchema: Schema.declare<ResponseIncludable, ResponseIncludable>;
 export declare const ServiceTierSchema: Schema.Literals<readonly ["auto", "default", "flex", "priority"]>;
 export declare const TruncationSchema: Schema.Literals<readonly ["auto", "disabled"]>;
-export interface Resolved {
-    readonly instructions?: string;
-    readonly store?: boolean;
-    readonly reasoningEffort?: string;
-    readonly reasoningSummary?: "auto" | "concise" | "detailed";
-    readonly include?: ReadonlyArray<ResponseIncludable>;
-    readonly textVerbosity?: Schema.Schema.Type<typeof TextVerbosity>;
-    readonly serviceTier?: ServiceTier;
-    readonly truncation?: Truncation;
-}
+export declare const AllowedTools: Schema.Struct<{
+    readonly toolNames: Schema.$Array<Schema.String>;
+    readonly mode: Schema.optional<Schema.Literals<readonly ["auto", "none", "required"]>>;
+}>;
+export type AllowedTools = typeof AllowedTools.Type;
+export declare const Options: Schema.Struct<{
+    readonly instructions: Schema.optional<Schema.String>;
+    readonly store: Schema.optional<Schema.Boolean>;
+    readonly reasoningEffort: Schema.optional<Schema.String>;
+    readonly reasoningSummary: Schema.optional<Schema.Literals<readonly ["auto", "concise", "detailed"]>>;
+    readonly include: Schema.optional<Schema.$Array<Schema.declare<ResponseIncludable, ResponseIncludable>>>;
+    readonly textVerbosity: Schema.optional<Schema.Literals<readonly ["low", "medium", "high"]>>;
+    readonly serviceTier: Schema.optional<Schema.Literals<readonly ["auto", "default", "flex", "priority"]>>;
+    readonly truncation: Schema.optional<Schema.Literals<readonly ["auto", "disabled"]>>;
+    readonly allowedTools: Schema.optional<Schema.Struct<{
+        readonly toolNames: Schema.$Array<Schema.String>;
+        readonly mode: Schema.optional<Schema.Literals<readonly ["auto", "none", "required"]>>;
+    }>>;
+    readonly maxToolCalls: Schema.optional<Schema.Int>;
+    readonly parallelToolCalls: Schema.optional<Schema.Boolean>;
+}>;
+export type Options = typeof Options.Type;
+export type Resolved = Omit<Options, "allowedTools"> & {
+    readonly allowedTools?: AllowedTools & {
+        readonly mode: NonNullable<AllowedTools["mode"]>;
+    };
+};
 export declare const resolve: (request: LLMRequest) => Resolved;
 export * as OpenResponsesOptions from "./open-responses-options.js";

package/dist/protocols/utils/open-responses-options.js

@@ -1,4 +1,4 @@
-import { Schema } from "effect";
+import { Option, Schema } from "effect";
 import { TextVerbosity } from "../../schema/index.js";
 export const ResponseIncludables = [
     "file_search_call.results",
@@ -12,35 +12,39 @@ export const ResponseIncludables = [
 ];
 export const ServiceTiers = ["auto", "default", "flex", "priority"];
 export const Truncations = ["auto", "disabled"];
-const TEXT_VERBOSITY = new Set(["low", "medium", "high"]);
-const INCLUDABLES = new Set(ResponseIncludables);
-const SERVICE_TIERS = new Set(ServiceTiers);
-const TRUNCATIONS = new Set(Truncations);
-const isTextVerbosity = (value) => typeof value === "string" && TEXT_VERBOSITY.has(value);
-const isServiceTier = (value) => typeof value === "string" && SERVICE_TIERS.has(value);
-const isTruncation = (value) => typeof value === "string" && TRUNCATIONS.has(value);
 export const ReasoningEffort = Schema.String;
 export const TextVerbositySchema = TextVerbosity;
-export const ResponseIncludableSchema = Schema.Literals(ResponseIncludables);
+export const ResponseIncludableSchema = Schema.declare((value) => typeof value === "string", { title: "ResponseIncludable" });
 export const ServiceTierSchema = Schema.Literals(ServiceTiers);
 export const TruncationSchema = Schema.Literals(Truncations);
+export const AllowedTools = Schema.Struct({
+    toolNames: Schema.Array(Schema.String),
+    mode: Schema.optional(Schema.Literals(["auto", "none", "required"])),
+});
+export const Options = Schema.Struct({
+    instructions: Schema.optional(Schema.String),
+    store: Schema.optional(Schema.Boolean),
+    reasoningEffort: Schema.optional(ReasoningEffort),
+    reasoningSummary: Schema.optional(Schema.Literals(["auto", "concise", "detailed"])),
+    include: Schema.optional(Schema.Array(ResponseIncludableSchema)),
+    textVerbosity: Schema.optional(TextVerbositySchema),
+    serviceTier: Schema.optional(ServiceTierSchema),
+    truncation: Schema.optional(TruncationSchema),
+    allowedTools: Schema.optional(AllowedTools),
+    maxToolCalls: Schema.optional(Schema.Int),
+    parallelToolCalls: Schema.optional(Schema.Boolean),
+});
+const decodeOptions = Schema.decodeUnknownOption(Options);
 export const resolve = (request) => {
-    const input = request.providerOptions?.[request.model.route.providerMetadataKey ?? "openresponses"];
-    const include = Array.isArray(input?.include)
-        ? input.include.filter((entry) => INCLUDABLES.has(entry))
-        : [];
-    const reasoningSummary = input?.reasoningSummary;
+    const input = Option.getOrUndefined(decodeOptions(request.providerOptions?.[request.model.route.providerMetadataKey ?? "openresponses"]));
+    if (!input)
+        return {};
     return {
-        instructions: typeof input?.instructions === "string" ? input.instructions : undefined,
-        store: typeof input?.store === "boolean" ? input.store : undefined,
-        reasoningEffort: typeof input?.reasoningEffort === "string" ? input.reasoningEffort : undefined,
-        reasoningSummary: reasoningSummary === "auto" || reasoningSummary === "concise" || reasoningSummary === "detailed"
-            ? reasoningSummary
+        ...input,
+        include: input.include?.length ? input.include : undefined,
+        allowedTools: input.allowedTools && input.allowedTools.toolNames.length > 0
+            ? { ...input.allowedTools, mode: input.allowedTools.mode ?? "auto" }
             : undefined,
-        include: include.length > 0 ? include : undefined,
-        textVerbosity: isTextVerbosity(input?.textVerbosity) ? input.textVerbosity : undefined,
-        serviceTier: isServiceTier(input?.serviceTier) ? input.serviceTier : undefined,
-        truncation: isTruncation(input?.truncation) ? input.truncation : undefined,
     };
 };
 export * as OpenResponsesOptions from "./open-responses-options.js";

package/dist/protocols/utils/openai-options.d.ts

@@ -7,7 +7,7 @@ export declare const OpenAIServiceTiers: readonly ["auto", "default", "flex", "p
 export type OpenAIServiceTier = OpenResponsesOptions.ServiceTier;
 export declare const OpenAIReasoningEffort: import("effect/Schema").String;
 export declare const OpenAITextVerbosity: import("effect/Schema").Literals<readonly ["low", "medium", "high"]>;
-export declare const OpenAIResponseIncludable: import("effect/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"]>;
+export declare const OpenAIResponseIncludable: import("effect/Schema").declare<OpenResponsesOptions.ResponseIncludable, OpenResponsesOptions.ResponseIncludable>;
 export declare const OpenAIServiceTier: import("effect/Schema").Literals<readonly ["auto", "default", "flex", "priority"]>;
 export declare const isReasoningEffort: (effort: unknown) => effort is OpenAIReasoningEffort;
 export declare const resolve: (request: import("../../schema/messages.js").LLMRequest) => OpenResponsesOptions.Resolved;

package/dist/providers/amazon-bedrock-mantle.d.ts

@@ -215,16 +215,25 @@ export declare const routes: (RouteDef<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        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("../protocols/utils/open-responses-options.js").ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
     readonly prompt_cache_key?: string | 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("../protocols/open-responses-channel.js").Prepared>)[];
 export declare const configure: (input?: Config) => {
     id: string & import("effect/Brand").Brand<"AI.ProviderID">;

package/dist/providers/azure.d.ts

@@ -218,16 +218,25 @@ export declare const routes: (RouteDef<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        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("../protocols/utils/open-responses-options.js").ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
     readonly prompt_cache_key?: string | 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("../protocols/open-responses-channel.js").Prepared>)[];
 export declare const configure: (input: Config) => {
     id: string & import("effect/Brand").Brand<"AI.ProviderID">;

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

@@ -101,14 +101,23 @@ export declare const routes: import("../route/client.js").Route<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
     } | 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("../protocols/utils/open-responses-options.js").ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
     readonly prompt_cache_key?: string | 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("../route/transport/http.js").HttpPrepared<string>>[];
 export declare const configure: (input?: Config) => {
     id: string & import("effect/Brand").Brand<"AI.ProviderID">;

package/dist/providers/open-responses-options.d.ts

@@ -1,16 +1,8 @@
-import type { ResponseIncludable, ServiceTier, Truncation } from "../protocols/utils/open-responses-options.js";
-import type { ProviderOptions, ReasoningEffort, TextVerbosity } from "../schema/index.js";
-export interface OpenResponsesOptionsInput {
+import type { Options } from "../protocols/utils/open-responses-options.js";
+import type { ProviderOptions } from "../schema/index.js";
+export type OpenResponsesOptionsInput = Options & {
     readonly [key: string]: unknown;
-    readonly instructions?: string;
-    readonly store?: boolean;
-    readonly reasoningEffort?: ReasoningEffort;
-    readonly reasoningSummary?: "auto" | "concise" | "detailed";
-    readonly include?: ReadonlyArray<ResponseIncludable>;
-    readonly textVerbosity?: TextVerbosity;
-    readonly serviceTier?: ServiceTier;
-    readonly truncation?: Truncation;
-}
+};
 export type OpenResponsesProviderOptionsInput = ProviderOptions & {
     readonly openresponses?: OpenResponsesOptionsInput;
 };

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

@@ -99,14 +99,23 @@ export declare const routes: import("../route/client.js").Route<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        readonly tools: readonly {
+            readonly type: "function";
+            readonly name: string;
+        }[];
     } | 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("../protocols/utils/open-responses-options.js").ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
     readonly prompt_cache_key?: string | 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("../route/transport/http.js").HttpPrepared<string>>[];
 export declare const configure: (input: Config) => {
     id: string & import("effect/Brand").Brand<"AI.ProviderID">;

package/dist/providers/openai.d.ts

@@ -203,16 +203,25 @@ export declare const routes: (Route<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        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("../protocols/utils/open-responses-options.js").ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
     readonly prompt_cache_key?: string | 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("../protocols/open-responses-channel.js").Prepared>)[];
 export type Config = RouteDefaultsInput & ProviderAuthOption<"optional"> & {
     readonly baseURL?: string;

package/dist/providers/xai.d.ts

@@ -213,16 +213,25 @@ export declare const routes: (Route<{
     readonly tool_choice?: "required" | "none" | "auto" | {
         readonly type: "function";
         readonly name: string;
+    } | {
+        readonly type: "allowed_tools";
+        readonly mode: "required" | "none" | "auto";
+        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("../protocols/utils/open-responses-options.js").ResponseIncludable[] | undefined;
     readonly truncation?: "auto" | "disabled" | undefined;
     readonly prompt_cache_key?: string | 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("../route/transport/http.js").HttpPrepared<string>>)[];
 export declare const configure: (input?: LanguageModelOptions) => {
     id: string & import("effect/Brand").Brand<"AI.ProviderID">;

package/package.json

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