@yourgpt/llm-sdk 2.5.1-beta.0 → 2.5.1-beta.1

package/dist/providers/openrouter/index.js

@@ -132,6 +132,33 @@ function toOpenAIResponsesTextFormat(rf) {
     strict: rf.json_schema.strict ?? true
   };
 }
+function toOpenAIResponsesMcpTools(mcpServers) {
+  if (!mcpServers || mcpServers.length === 0) return [];
+  return mcpServers.map((mcp) => ({
+    type: "mcp",
+    server_label: mcp.label,
+    server_url: mcp.url,
+    ...mcp.headers ? { headers: mcp.headers } : {},
+    ...mcp.allowedTools ? { allowed_tools: mcp.allowedTools } : {},
+    require_approval: mcp.requireApproval ?? "never"
+  }));
+}
+function isStringEffort(effort) {
+  return typeof effort === "string" && (effort === "minimal" || effort === "low" || effort === "medium" || effort === "high");
+}
+function toOpenAIReasoning(effort) {
+  if (!effort) return void 0;
+  if (typeof effort === "object" && "raw" in effort) return effort.raw;
+  if (typeof effort === "object" && "budgetTokens" in effort) {
+    const budget = effort.budgetTokens;
+    const mapped = budget >= 16e3 ? "high" : budget >= 8e3 ? "medium" : "low";
+    return { effort: mapped, summary: "auto" };
+  }
+  if (isStringEffort(effort)) {
+    return { effort, summary: "auto" };
+  }
+  return void 0;
+}
 function formatTools(actions) {
   return actions.map((action) => ({
     type: "function",
@@ -525,6 +552,14 @@ var OpenAIAdapter = class _OpenAIAdapter {
     return this.client;
   }
   shouldUseResponsesApi(request) {
+    if (request.config?.mcpServers && request.config.mcpServers.length > 0 || request.config?.reasoningEffort !== void 0) {
+      if (this.provider !== "openai" && this.provider !== "azure") {
+        throw new Error(
+          `[llm-sdk] Provider "${this.provider}" does not support MCP servers or per-request reasoning effort. Use OpenAI or Anthropic for these features.`
+        );
+      }
+      return true;
+    }
     return request.providerToolOptions?.openai?.nativeToolSearch?.enabled === true && request.providerToolOptions.openai.nativeToolSearch.useResponsesApi !== false && Array.isArray(request.toolDefinitions) && request.toolDefinitions.length > 0;
   }
   buildResponsesInput(request) {
@@ -585,7 +620,7 @@ var OpenAIAdapter = class _OpenAIAdapter {
       strict: true,
       defer_loading: tool.deferLoading === true
     }));
-    return [{ type: "tool_search" }, ...nativeTools];
+    return nativeTools.length > 0 ? [{ type: "tool_search" }, ...nativeTools] : [];
   }
   parseResponsesResult(response) {
     const content = typeof response?.output_text === "string" ? response.output_text : "";
@@ -617,16 +652,30 @@ var OpenAIAdapter = class _OpenAIAdapter {
     const responsesTextFormat = toOpenAIResponsesTextFormat(
       request.config?.responseFormat
     );
+    const mcpTools = toOpenAIResponsesMcpTools(request.config?.mcpServers);
+    const modelId = request.config?.model || this.model;
+    const reasoning = isOpenAIReasoningModel(modelId) ? toOpenAIReasoning(request.config?.reasoningEffort) : void 0;
+    if (request.config?.reasoningEffort && !isOpenAIReasoningModel(modelId)) {
+      console.warn(
+        `[llm-sdk] openai/${modelId} is not a reasoning model; \`reasoningEffort\` is ignored. Use o1/o3/o4/gpt-5.x for reasoning.`
+      );
+    }
+    const functionTools = this.buildResponsesTools(
+      request.toolDefinitions ?? []
+    );
+    const tools = [...functionTools, ...mcpTools];
     const payload = {
       model: request.config?.model || this.model,
       instructions: request.systemPrompt,
       input: this.buildResponsesInput(request),
-      tools: this.buildResponsesTools(request.toolDefinitions ?? []),
+      tools: tools.length > 0 ? tools : void 0,
       tool_choice: openaiToolOptions?.toolChoice === "required" ? "required" : openaiToolOptions?.toolChoice === "auto" ? "auto" : void 0,
       parallel_tool_calls: openaiToolOptions?.parallelToolCalls,
       temperature: request.config?.temperature ?? this.config.temperature,
       max_output_tokens: request.config?.maxTokens ?? this.config.maxTokens,
       ...responsesTextFormat ? { text: { format: responsesTextFormat } } : {},
+      ...reasoning ? { reasoning } : {},
+      store: false,
       stream: false
     };
     logProviderPayload("openai", "request payload", payload, request.debug);

package/dist/providers/openrouter/index.mjs

@@ -130,6 +130,33 @@ function toOpenAIResponsesTextFormat(rf) {
     strict: rf.json_schema.strict ?? true
   };
 }
+function toOpenAIResponsesMcpTools(mcpServers) {
+  if (!mcpServers || mcpServers.length === 0) return [];
+  return mcpServers.map((mcp) => ({
+    type: "mcp",
+    server_label: mcp.label,
+    server_url: mcp.url,
+    ...mcp.headers ? { headers: mcp.headers } : {},
+    ...mcp.allowedTools ? { allowed_tools: mcp.allowedTools } : {},
+    require_approval: mcp.requireApproval ?? "never"
+  }));
+}
+function isStringEffort(effort) {
+  return typeof effort === "string" && (effort === "minimal" || effort === "low" || effort === "medium" || effort === "high");
+}
+function toOpenAIReasoning(effort) {
+  if (!effort) return void 0;
+  if (typeof effort === "object" && "raw" in effort) return effort.raw;
+  if (typeof effort === "object" && "budgetTokens" in effort) {
+    const budget = effort.budgetTokens;
+    const mapped = budget >= 16e3 ? "high" : budget >= 8e3 ? "medium" : "low";
+    return { effort: mapped, summary: "auto" };
+  }
+  if (isStringEffort(effort)) {
+    return { effort, summary: "auto" };
+  }
+  return void 0;
+}
 function formatTools(actions) {
   return actions.map((action) => ({
     type: "function",
@@ -523,6 +550,14 @@ var OpenAIAdapter = class _OpenAIAdapter {
     return this.client;
   }
   shouldUseResponsesApi(request) {
+    if (request.config?.mcpServers && request.config.mcpServers.length > 0 || request.config?.reasoningEffort !== void 0) {
+      if (this.provider !== "openai" && this.provider !== "azure") {
+        throw new Error(
+          `[llm-sdk] Provider "${this.provider}" does not support MCP servers or per-request reasoning effort. Use OpenAI or Anthropic for these features.`
+        );
+      }
+      return true;
+    }
     return request.providerToolOptions?.openai?.nativeToolSearch?.enabled === true && request.providerToolOptions.openai.nativeToolSearch.useResponsesApi !== false && Array.isArray(request.toolDefinitions) && request.toolDefinitions.length > 0;
   }
   buildResponsesInput(request) {
@@ -583,7 +618,7 @@ var OpenAIAdapter = class _OpenAIAdapter {
       strict: true,
       defer_loading: tool.deferLoading === true
     }));
-    return [{ type: "tool_search" }, ...nativeTools];
+    return nativeTools.length > 0 ? [{ type: "tool_search" }, ...nativeTools] : [];
   }
   parseResponsesResult(response) {
     const content = typeof response?.output_text === "string" ? response.output_text : "";
@@ -615,16 +650,30 @@ var OpenAIAdapter = class _OpenAIAdapter {
     const responsesTextFormat = toOpenAIResponsesTextFormat(
       request.config?.responseFormat
     );
+    const mcpTools = toOpenAIResponsesMcpTools(request.config?.mcpServers);
+    const modelId = request.config?.model || this.model;
+    const reasoning = isOpenAIReasoningModel(modelId) ? toOpenAIReasoning(request.config?.reasoningEffort) : void 0;
+    if (request.config?.reasoningEffort && !isOpenAIReasoningModel(modelId)) {
+      console.warn(
+        `[llm-sdk] openai/${modelId} is not a reasoning model; \`reasoningEffort\` is ignored. Use o1/o3/o4/gpt-5.x for reasoning.`
+      );
+    }
+    const functionTools = this.buildResponsesTools(
+      request.toolDefinitions ?? []
+    );
+    const tools = [...functionTools, ...mcpTools];
     const payload = {
       model: request.config?.model || this.model,
       instructions: request.systemPrompt,
       input: this.buildResponsesInput(request),
-      tools: this.buildResponsesTools(request.toolDefinitions ?? []),
+      tools: tools.length > 0 ? tools : void 0,
       tool_choice: openaiToolOptions?.toolChoice === "required" ? "required" : openaiToolOptions?.toolChoice === "auto" ? "auto" : void 0,
       parallel_tool_calls: openaiToolOptions?.parallelToolCalls,
       temperature: request.config?.temperature ?? this.config.temperature,
       max_output_tokens: request.config?.maxTokens ?? this.config.maxTokens,
       ...responsesTextFormat ? { text: { format: responsesTextFormat } } : {},
+      ...reasoning ? { reasoning } : {},
+      store: false,
       stream: false
     };
     logProviderPayload("openai", "request payload", payload, request.debug);

package/dist/providers/togetherai/index.d.mts

@@ -1,7 +1,7 @@
-import { L as LanguageModel } from '../../types-BkQCSiIt.mjs';
-import { A as AIProvider } from '../../types-BSSiJW2o.mjs';
+import { L as LanguageModel } from '../../types-D774b0dg.mjs';
+import { A as AIProvider } from '../../types-BvkiJ1dd.mjs';
 import 'zod';
-import '../../base-tNgbBaSo.mjs';
+import '../../base-BYQKp9TW.mjs';
 
 /**
  * Together AI Provider

package/dist/providers/togetherai/index.d.ts

@@ -1,7 +1,7 @@
-import { L as LanguageModel } from '../../types-BkQCSiIt.js';
-import { A as AIProvider } from '../../types-BQ31QIsA.js';
+import { L as LanguageModel } from '../../types-D774b0dg.js';
+import { A as AIProvider } from '../../types-TMilS-Dz.js';
 import 'zod';
-import '../../base-C58Dsr9p.js';
+import '../../base-Cxq3ni0t.js';
 
 /**
  * Together AI Provider

package/dist/providers/togetherai/index.js

@@ -132,6 +132,33 @@ function toOpenAIResponsesTextFormat(rf) {
     strict: rf.json_schema.strict ?? true
   };
 }
+function toOpenAIResponsesMcpTools(mcpServers) {
+  if (!mcpServers || mcpServers.length === 0) return [];
+  return mcpServers.map((mcp) => ({
+    type: "mcp",
+    server_label: mcp.label,
+    server_url: mcp.url,
+    ...mcp.headers ? { headers: mcp.headers } : {},
+    ...mcp.allowedTools ? { allowed_tools: mcp.allowedTools } : {},
+    require_approval: mcp.requireApproval ?? "never"
+  }));
+}
+function isStringEffort(effort) {
+  return typeof effort === "string" && (effort === "minimal" || effort === "low" || effort === "medium" || effort === "high");
+}
+function toOpenAIReasoning(effort) {
+  if (!effort) return void 0;
+  if (typeof effort === "object" && "raw" in effort) return effort.raw;
+  if (typeof effort === "object" && "budgetTokens" in effort) {
+    const budget = effort.budgetTokens;
+    const mapped = budget >= 16e3 ? "high" : budget >= 8e3 ? "medium" : "low";
+    return { effort: mapped, summary: "auto" };
+  }
+  if (isStringEffort(effort)) {
+    return { effort, summary: "auto" };
+  }
+  return void 0;
+}
 function formatTools(actions) {
   return actions.map((action) => ({
     type: "function",
@@ -477,6 +504,14 @@ var OpenAIAdapter = class _OpenAIAdapter {
     return this.client;
   }
   shouldUseResponsesApi(request) {
+    if (request.config?.mcpServers && request.config.mcpServers.length > 0 || request.config?.reasoningEffort !== void 0) {
+      if (this.provider !== "openai" && this.provider !== "azure") {
+        throw new Error(
+          `[llm-sdk] Provider "${this.provider}" does not support MCP servers or per-request reasoning effort. Use OpenAI or Anthropic for these features.`
+        );
+      }
+      return true;
+    }
     return request.providerToolOptions?.openai?.nativeToolSearch?.enabled === true && request.providerToolOptions.openai.nativeToolSearch.useResponsesApi !== false && Array.isArray(request.toolDefinitions) && request.toolDefinitions.length > 0;
   }
   buildResponsesInput(request) {
@@ -537,7 +572,7 @@ var OpenAIAdapter = class _OpenAIAdapter {
       strict: true,
       defer_loading: tool.deferLoading === true
     }));
-    return [{ type: "tool_search" }, ...nativeTools];
+    return nativeTools.length > 0 ? [{ type: "tool_search" }, ...nativeTools] : [];
   }
   parseResponsesResult(response) {
     const content = typeof response?.output_text === "string" ? response.output_text : "";
@@ -569,16 +604,30 @@ var OpenAIAdapter = class _OpenAIAdapter {
     const responsesTextFormat = toOpenAIResponsesTextFormat(
       request.config?.responseFormat
     );
+    const mcpTools = toOpenAIResponsesMcpTools(request.config?.mcpServers);
+    const modelId = request.config?.model || this.model;
+    const reasoning = isOpenAIReasoningModel(modelId) ? toOpenAIReasoning(request.config?.reasoningEffort) : void 0;
+    if (request.config?.reasoningEffort && !isOpenAIReasoningModel(modelId)) {
+      console.warn(
+        `[llm-sdk] openai/${modelId} is not a reasoning model; \`reasoningEffort\` is ignored. Use o1/o3/o4/gpt-5.x for reasoning.`
+      );
+    }
+    const functionTools = this.buildResponsesTools(
+      request.toolDefinitions ?? []
+    );
+    const tools = [...functionTools, ...mcpTools];
     const payload = {
       model: request.config?.model || this.model,
       instructions: request.systemPrompt,
       input: this.buildResponsesInput(request),
-      tools: this.buildResponsesTools(request.toolDefinitions ?? []),
+      tools: tools.length > 0 ? tools : void 0,
       tool_choice: openaiToolOptions?.toolChoice === "required" ? "required" : openaiToolOptions?.toolChoice === "auto" ? "auto" : void 0,
       parallel_tool_calls: openaiToolOptions?.parallelToolCalls,
       temperature: request.config?.temperature ?? this.config.temperature,
       max_output_tokens: request.config?.maxTokens ?? this.config.maxTokens,
       ...responsesTextFormat ? { text: { format: responsesTextFormat } } : {},
+      ...reasoning ? { reasoning } : {},
+      store: false,
       stream: false
     };
     logProviderPayload("openai", "request payload", payload, request.debug);

package/dist/providers/togetherai/index.mjs

@@ -130,6 +130,33 @@ function toOpenAIResponsesTextFormat(rf) {
     strict: rf.json_schema.strict ?? true
   };
 }
+function toOpenAIResponsesMcpTools(mcpServers) {
+  if (!mcpServers || mcpServers.length === 0) return [];
+  return mcpServers.map((mcp) => ({
+    type: "mcp",
+    server_label: mcp.label,
+    server_url: mcp.url,
+    ...mcp.headers ? { headers: mcp.headers } : {},
+    ...mcp.allowedTools ? { allowed_tools: mcp.allowedTools } : {},
+    require_approval: mcp.requireApproval ?? "never"
+  }));
+}
+function isStringEffort(effort) {
+  return typeof effort === "string" && (effort === "minimal" || effort === "low" || effort === "medium" || effort === "high");
+}
+function toOpenAIReasoning(effort) {
+  if (!effort) return void 0;
+  if (typeof effort === "object" && "raw" in effort) return effort.raw;
+  if (typeof effort === "object" && "budgetTokens" in effort) {
+    const budget = effort.budgetTokens;
+    const mapped = budget >= 16e3 ? "high" : budget >= 8e3 ? "medium" : "low";
+    return { effort: mapped, summary: "auto" };
+  }
+  if (isStringEffort(effort)) {
+    return { effort, summary: "auto" };
+  }
+  return void 0;
+}
 function formatTools(actions) {
   return actions.map((action) => ({
     type: "function",
@@ -475,6 +502,14 @@ var OpenAIAdapter = class _OpenAIAdapter {
     return this.client;
   }
   shouldUseResponsesApi(request) {
+    if (request.config?.mcpServers && request.config.mcpServers.length > 0 || request.config?.reasoningEffort !== void 0) {
+      if (this.provider !== "openai" && this.provider !== "azure") {
+        throw new Error(
+          `[llm-sdk] Provider "${this.provider}" does not support MCP servers or per-request reasoning effort. Use OpenAI or Anthropic for these features.`
+        );
+      }
+      return true;
+    }
     return request.providerToolOptions?.openai?.nativeToolSearch?.enabled === true && request.providerToolOptions.openai.nativeToolSearch.useResponsesApi !== false && Array.isArray(request.toolDefinitions) && request.toolDefinitions.length > 0;
   }
   buildResponsesInput(request) {
@@ -535,7 +570,7 @@ var OpenAIAdapter = class _OpenAIAdapter {
       strict: true,
       defer_loading: tool.deferLoading === true
     }));
-    return [{ type: "tool_search" }, ...nativeTools];
+    return nativeTools.length > 0 ? [{ type: "tool_search" }, ...nativeTools] : [];
   }
   parseResponsesResult(response) {
     const content = typeof response?.output_text === "string" ? response.output_text : "";
@@ -567,16 +602,30 @@ var OpenAIAdapter = class _OpenAIAdapter {
     const responsesTextFormat = toOpenAIResponsesTextFormat(
       request.config?.responseFormat
     );
+    const mcpTools = toOpenAIResponsesMcpTools(request.config?.mcpServers);
+    const modelId = request.config?.model || this.model;
+    const reasoning = isOpenAIReasoningModel(modelId) ? toOpenAIReasoning(request.config?.reasoningEffort) : void 0;
+    if (request.config?.reasoningEffort && !isOpenAIReasoningModel(modelId)) {
+      console.warn(
+        `[llm-sdk] openai/${modelId} is not a reasoning model; \`reasoningEffort\` is ignored. Use o1/o3/o4/gpt-5.x for reasoning.`
+      );
+    }
+    const functionTools = this.buildResponsesTools(
+      request.toolDefinitions ?? []
+    );
+    const tools = [...functionTools, ...mcpTools];
     const payload = {
       model: request.config?.model || this.model,
       instructions: request.systemPrompt,
       input: this.buildResponsesInput(request),
-      tools: this.buildResponsesTools(request.toolDefinitions ?? []),
+      tools: tools.length > 0 ? tools : void 0,
       tool_choice: openaiToolOptions?.toolChoice === "required" ? "required" : openaiToolOptions?.toolChoice === "auto" ? "auto" : void 0,
       parallel_tool_calls: openaiToolOptions?.parallelToolCalls,
       temperature: request.config?.temperature ?? this.config.temperature,
       max_output_tokens: request.config?.maxTokens ?? this.config.maxTokens,
       ...responsesTextFormat ? { text: { format: responsesTextFormat } } : {},
+      ...reasoning ? { reasoning } : {},
+      store: false,
       stream: false
     };
     logProviderPayload("openai", "request payload", payload, request.debug);

package/dist/providers/xai/index.d.mts

@@ -1,7 +1,7 @@
-import { L as LanguageModel } from '../../types-BkQCSiIt.mjs';
-import { X as XAIProviderConfig, A as AIProvider } from '../../types-BSSiJW2o.mjs';
+import { L as LanguageModel } from '../../types-D774b0dg.mjs';
+import { X as XAIProviderConfig, A as AIProvider } from '../../types-BvkiJ1dd.mjs';
 import 'zod';
-import '../../base-tNgbBaSo.mjs';
+import '../../base-BYQKp9TW.mjs';
 
 /**
  * xAI Provider - Modern Pattern

package/dist/providers/xai/index.d.ts

@@ -1,7 +1,7 @@
-import { L as LanguageModel } from '../../types-BkQCSiIt.js';
-import { X as XAIProviderConfig, A as AIProvider } from '../../types-BQ31QIsA.js';
+import { L as LanguageModel } from '../../types-D774b0dg.js';
+import { X as XAIProviderConfig, A as AIProvider } from '../../types-TMilS-Dz.js';
 import 'zod';
-import '../../base-C58Dsr9p.js';
+import '../../base-Cxq3ni0t.js';
 
 /**
  * xAI Provider - Modern Pattern

package/dist/providers/xai/index.js

@@ -132,6 +132,33 @@ function toOpenAIResponsesTextFormat(rf) {
     strict: rf.json_schema.strict ?? true
   };
 }
+function toOpenAIResponsesMcpTools(mcpServers) {
+  if (!mcpServers || mcpServers.length === 0) return [];
+  return mcpServers.map((mcp) => ({
+    type: "mcp",
+    server_label: mcp.label,
+    server_url: mcp.url,
+    ...mcp.headers ? { headers: mcp.headers } : {},
+    ...mcp.allowedTools ? { allowed_tools: mcp.allowedTools } : {},
+    require_approval: mcp.requireApproval ?? "never"
+  }));
+}
+function isStringEffort(effort) {
+  return typeof effort === "string" && (effort === "minimal" || effort === "low" || effort === "medium" || effort === "high");
+}
+function toOpenAIReasoning(effort) {
+  if (!effort) return void 0;
+  if (typeof effort === "object" && "raw" in effort) return effort.raw;
+  if (typeof effort === "object" && "budgetTokens" in effort) {
+    const budget = effort.budgetTokens;
+    const mapped = budget >= 16e3 ? "high" : budget >= 8e3 ? "medium" : "low";
+    return { effort: mapped, summary: "auto" };
+  }
+  if (isStringEffort(effort)) {
+    return { effort, summary: "auto" };
+  }
+  return void 0;
+}
 function formatTools(actions) {
   return actions.map((action) => ({
     type: "function",
@@ -501,6 +528,14 @@ var OpenAIAdapter = class _OpenAIAdapter {
     return this.client;
   }
   shouldUseResponsesApi(request) {
+    if (request.config?.mcpServers && request.config.mcpServers.length > 0 || request.config?.reasoningEffort !== void 0) {
+      if (this.provider !== "openai" && this.provider !== "azure") {
+        throw new Error(
+          `[llm-sdk] Provider "${this.provider}" does not support MCP servers or per-request reasoning effort. Use OpenAI or Anthropic for these features.`
+        );
+      }
+      return true;
+    }
     return request.providerToolOptions?.openai?.nativeToolSearch?.enabled === true && request.providerToolOptions.openai.nativeToolSearch.useResponsesApi !== false && Array.isArray(request.toolDefinitions) && request.toolDefinitions.length > 0;
   }
   buildResponsesInput(request) {
@@ -561,7 +596,7 @@ var OpenAIAdapter = class _OpenAIAdapter {
       strict: true,
       defer_loading: tool.deferLoading === true
     }));
-    return [{ type: "tool_search" }, ...nativeTools];
+    return nativeTools.length > 0 ? [{ type: "tool_search" }, ...nativeTools] : [];
   }
   parseResponsesResult(response) {
     const content = typeof response?.output_text === "string" ? response.output_text : "";
@@ -593,16 +628,30 @@ var OpenAIAdapter = class _OpenAIAdapter {
     const responsesTextFormat = toOpenAIResponsesTextFormat(
       request.config?.responseFormat
     );
+    const mcpTools = toOpenAIResponsesMcpTools(request.config?.mcpServers);
+    const modelId = request.config?.model || this.model;
+    const reasoning = isOpenAIReasoningModel(modelId) ? toOpenAIReasoning(request.config?.reasoningEffort) : void 0;
+    if (request.config?.reasoningEffort && !isOpenAIReasoningModel(modelId)) {
+      console.warn(
+        `[llm-sdk] openai/${modelId} is not a reasoning model; \`reasoningEffort\` is ignored. Use o1/o3/o4/gpt-5.x for reasoning.`
+      );
+    }
+    const functionTools = this.buildResponsesTools(
+      request.toolDefinitions ?? []
+    );
+    const tools = [...functionTools, ...mcpTools];
     const payload = {
       model: request.config?.model || this.model,
       instructions: request.systemPrompt,
       input: this.buildResponsesInput(request),
-      tools: this.buildResponsesTools(request.toolDefinitions ?? []),
+      tools: tools.length > 0 ? tools : void 0,
       tool_choice: openaiToolOptions?.toolChoice === "required" ? "required" : openaiToolOptions?.toolChoice === "auto" ? "auto" : void 0,
       parallel_tool_calls: openaiToolOptions?.parallelToolCalls,
       temperature: request.config?.temperature ?? this.config.temperature,
       max_output_tokens: request.config?.maxTokens ?? this.config.maxTokens,
       ...responsesTextFormat ? { text: { format: responsesTextFormat } } : {},
+      ...reasoning ? { reasoning } : {},
+      store: false,
       stream: false
     };
     logProviderPayload("openai", "request payload", payload, request.debug);

package/dist/providers/xai/index.mjs

@@ -130,6 +130,33 @@ function toOpenAIResponsesTextFormat(rf) {
     strict: rf.json_schema.strict ?? true
   };
 }
+function toOpenAIResponsesMcpTools(mcpServers) {
+  if (!mcpServers || mcpServers.length === 0) return [];
+  return mcpServers.map((mcp) => ({
+    type: "mcp",
+    server_label: mcp.label,
+    server_url: mcp.url,
+    ...mcp.headers ? { headers: mcp.headers } : {},
+    ...mcp.allowedTools ? { allowed_tools: mcp.allowedTools } : {},
+    require_approval: mcp.requireApproval ?? "never"
+  }));
+}
+function isStringEffort(effort) {
+  return typeof effort === "string" && (effort === "minimal" || effort === "low" || effort === "medium" || effort === "high");
+}
+function toOpenAIReasoning(effort) {
+  if (!effort) return void 0;
+  if (typeof effort === "object" && "raw" in effort) return effort.raw;
+  if (typeof effort === "object" && "budgetTokens" in effort) {
+    const budget = effort.budgetTokens;
+    const mapped = budget >= 16e3 ? "high" : budget >= 8e3 ? "medium" : "low";
+    return { effort: mapped, summary: "auto" };
+  }
+  if (isStringEffort(effort)) {
+    return { effort, summary: "auto" };
+  }
+  return void 0;
+}
 function formatTools(actions) {
   return actions.map((action) => ({
     type: "function",
@@ -499,6 +526,14 @@ var OpenAIAdapter = class _OpenAIAdapter {
     return this.client;
   }
   shouldUseResponsesApi(request) {
+    if (request.config?.mcpServers && request.config.mcpServers.length > 0 || request.config?.reasoningEffort !== void 0) {
+      if (this.provider !== "openai" && this.provider !== "azure") {
+        throw new Error(
+          `[llm-sdk] Provider "${this.provider}" does not support MCP servers or per-request reasoning effort. Use OpenAI or Anthropic for these features.`
+        );
+      }
+      return true;
+    }
     return request.providerToolOptions?.openai?.nativeToolSearch?.enabled === true && request.providerToolOptions.openai.nativeToolSearch.useResponsesApi !== false && Array.isArray(request.toolDefinitions) && request.toolDefinitions.length > 0;
   }
   buildResponsesInput(request) {
@@ -559,7 +594,7 @@ var OpenAIAdapter = class _OpenAIAdapter {
       strict: true,
       defer_loading: tool.deferLoading === true
     }));
-    return [{ type: "tool_search" }, ...nativeTools];
+    return nativeTools.length > 0 ? [{ type: "tool_search" }, ...nativeTools] : [];
   }
   parseResponsesResult(response) {
     const content = typeof response?.output_text === "string" ? response.output_text : "";
@@ -591,16 +626,30 @@ var OpenAIAdapter = class _OpenAIAdapter {
     const responsesTextFormat = toOpenAIResponsesTextFormat(
       request.config?.responseFormat
     );
+    const mcpTools = toOpenAIResponsesMcpTools(request.config?.mcpServers);
+    const modelId = request.config?.model || this.model;
+    const reasoning = isOpenAIReasoningModel(modelId) ? toOpenAIReasoning(request.config?.reasoningEffort) : void 0;
+    if (request.config?.reasoningEffort && !isOpenAIReasoningModel(modelId)) {
+      console.warn(
+        `[llm-sdk] openai/${modelId} is not a reasoning model; \`reasoningEffort\` is ignored. Use o1/o3/o4/gpt-5.x for reasoning.`
+      );
+    }
+    const functionTools = this.buildResponsesTools(
+      request.toolDefinitions ?? []
+    );
+    const tools = [...functionTools, ...mcpTools];
     const payload = {
       model: request.config?.model || this.model,
       instructions: request.systemPrompt,
       input: this.buildResponsesInput(request),
-      tools: this.buildResponsesTools(request.toolDefinitions ?? []),
+      tools: tools.length > 0 ? tools : void 0,
       tool_choice: openaiToolOptions?.toolChoice === "required" ? "required" : openaiToolOptions?.toolChoice === "auto" ? "auto" : void 0,
       parallel_tool_calls: openaiToolOptions?.parallelToolCalls,
       temperature: request.config?.temperature ?? this.config.temperature,
       max_output_tokens: request.config?.maxTokens ?? this.config.maxTokens,
       ...responsesTextFormat ? { text: { format: responsesTextFormat } } : {},
+      ...reasoning ? { reasoning } : {},
+      store: false,
       stream: false
     };
     logProviderPayload("openai", "request payload", payload, request.debug);

package/dist/{types-BSSiJW2o.d.mts → types-BvkiJ1dd.d.mts}

@@ -1,5 +1,5 @@
-import { d as ToolDefinition, Z as UnifiedToolCall, _ as UnifiedToolResult } from './types-BkQCSiIt.mjs';
-import { L as LLMAdapter } from './base-tNgbBaSo.mjs';
+import { d as ToolDefinition, $ as UnifiedToolCall, a0 as UnifiedToolResult } from './types-D774b0dg.mjs';
+import { L as LLMAdapter } from './base-BYQKp9TW.mjs';
 
 /**
  * Provider Types

package/dist/{types-CCxPmkmK.d.ts → types-ChORafYS.d.ts}

@@ -1,4 +1,4 @@
-import { L as LLMAdapter } from './base-C58Dsr9p.js';
+import { L as LLMAdapter } from './base-Cxq3ni0t.js';
 
 /**
  * Fallback Chain & Routing Strategy Types