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

package/dist/{types-BkQCSiIt.d.mts → types-D774b0dg.d.mts}

@@ -245,6 +245,42 @@ type ResponseFormat = {
         strict?: boolean;
     };
 };
+/**
+ * MCP (Model Context Protocol) server reference for a request.
+ *
+ * Vendor-neutral shape — each adapter translates to its provider's native
+ * field: OpenAI Responses `tools[type=mcp]`, Anthropic `mcp_servers` +
+ * `tools[type=mcp_toolset]` (beta `mcp-client-2025-11-20`), or local
+ * execution for adapters without native MCP.
+ */
+interface McpServerConfig {
+    /** Human-readable label sent to the provider (also used as MCP server name). */
+    label: string;
+    /** MCP server endpoint (HTTP/SSE URL). */
+    url: string;
+    /** Additional HTTP headers; the `Authorization` value is also extracted for providers that take a separate token field. */
+    headers?: Record<string, string>;
+    /** Restrict the model to a subset of the MCP server's exposed tools. */
+    allowedTools?: string[];
+    /** Approval policy for tool invocation. Defaults to "never" (no human-in-the-loop). */
+    requireApproval?: "never" | "always";
+}
+/**
+ * Reasoning effort knob — normalized across providers.
+ *
+ * Maps to OpenAI Responses `reasoning.effort`, Anthropic `thinking`
+ * (adaptive+effort on Claude 4.6/4.7, budget_tokens on older models),
+ * Gemini `thinkingBudget`, xAI `reasoning_effort`. Adapters silently
+ * no-op when the underlying model doesn't support reasoning.
+ *
+ * Use the enum for the common case, or `{ budgetTokens }` / `{ raw }`
+ * for provider-specific escape hatches when full fidelity is required.
+ */
+type ReasoningEffort = "minimal" | "low" | "medium" | "high" | {
+    budgetTokens: number;
+} | {
+    raw: Record<string, unknown>;
+};
 /**
  * LLM configuration
  */
@@ -252,6 +288,8 @@ interface LLMConfig {
     temperature?: number;
     maxTokens?: number;
     responseFormat?: ResponseFormat;
+    mcpServers?: McpServerConfig[];
+    reasoningEffort?: ReasoningEffort;
 }
 /**
  * Tool call format (OpenAI style)
@@ -620,7 +658,7 @@ interface ToolMessage {
 /**
  * Content parts for multimodal user messages
  */
-type UserContentPart = TextPart | ImagePart | FilePart;
+type UserContentPart = TextPart | ImagePart | FilePart | AudioPart;
 interface TextPart {
     type: "text";
     text: string;
@@ -639,6 +677,15 @@ interface FilePart {
     /** MIME type (e.g., 'application/pdf') */
     mimeType: string;
 }
+interface AudioPart {
+    type: "input_audio";
+    input_audio: {
+        /** Base64-encoded audio data */
+        data: string;
+        /** Audio format (e.g., 'mp3', 'wav', 'ogg', 'webm', 'm4a', 'flac') */
+        format: string;
+    };
+}
 /**
  * Tool definition with Zod schema support
  */
@@ -702,6 +749,10 @@ interface DoGenerateParams {
     maxTokens?: number;
     /** Structured-output / JSON-mode request format (provider-translated) */
     responseFormat?: ResponseFormat;
+    /** MCP servers exposed to the model (provider-translated). */
+    mcpServers?: McpServerConfig[];
+    /** Reasoning/thinking effort knob (provider-translated). */
+    reasoningEffort?: ReasoningEffort;
     /** Abort signal */
     signal?: AbortSignal;
 }
@@ -780,6 +831,10 @@ interface GenerateTextParams {
     maxTokens?: number;
     /** Structured-output / JSON-mode request format */
     responseFormat?: ResponseFormat;
+    /** MCP servers exposed to the model (provider-translated). */
+    mcpServers?: McpServerConfig[];
+    /** Reasoning/thinking effort knob (provider-translated). */
+    reasoningEffort?: ReasoningEffort;
     /** Abort signal */
     signal?: AbortSignal;
 }
@@ -960,4 +1015,4 @@ interface StorageFile {
     filename?: string;
 }
 
-export { type ToolExecution as $, type ActionDefinition as A, type ToolResultChunk as B, type CoreMessage as C, type DoneEventMessage as D, type FinishChunk as E, type FilePart as F, type GenerateTextParams as G, type ErrorChunk as H, type ImagePart as I, type TokenUsage as J, type KnowledgeBaseConfig as K, type LanguageModel as L, type Message as M, type FinishReason as N, type ResponseOptions as O, type ProviderToolRuntimeOptions as P, type StorageFile as Q, type ResponseFormat as R, type StreamTextParams as S, type ToolContext as T, type UserMessage as U, DEFAULT_CAPABILITIES as V, type WebSearchConfig as W, type LLMConfig as X, type ToolLocation as Y, type UnifiedToolCall as Z, type UnifiedToolResult as _, type GenerateTextResult as a, type OpenAIToolSelectionHints as a0, type AnthropicToolSelectionHints as a1, type ToolNativeProviderHints as a2, type OpenAIProviderToolOptions as a3, type AnthropicProviderToolOptions as a4, type Citation as a5, type MessageAttachment as a6, type StreamTextResult as b, type Tool as c, type ToolDefinition as d, type ToolProfile as e, type StorageAdapter as f, type StreamEvent as g, type ToolCallInfo as h, type TokenUsageRaw as i, type ToolResponse as j, type StorageMessage as k, type ModelCapabilities as l, type DoGenerateParams as m, type DoGenerateResult as n, type SystemMessage as o, type AssistantMessage as p, type ToolMessage as q, type UserContentPart as r, type TextPart as s, type ToolCall as t, type ToolResult as u, type GenerateStep as v, type StreamPart as w, type StreamChunk as x, type TextDeltaChunk as y, type ToolCallChunk as z };
+export { type UnifiedToolCall as $, type ActionDefinition as A, type TextDeltaChunk as B, type CoreMessage as C, type DoneEventMessage as D, type ToolCallChunk as E, type FilePart as F, type GenerateTextParams as G, type ToolResultChunk as H, type ImagePart as I, type FinishChunk as J, type KnowledgeBaseConfig as K, type LanguageModel as L, type McpServerConfig as M, type ErrorChunk as N, type TokenUsage as O, type ProviderToolRuntimeOptions as P, type FinishReason as Q, type ResponseFormat as R, type StreamTextParams as S, type ToolContext as T, type UserMessage as U, type ResponseOptions as V, type WebSearchConfig as W, type StorageFile as X, DEFAULT_CAPABILITIES as Y, type LLMConfig as Z, type ToolLocation as _, type GenerateTextResult as a, type UnifiedToolResult as a0, type ToolExecution as a1, type OpenAIToolSelectionHints as a2, type AnthropicToolSelectionHints as a3, type ToolNativeProviderHints as a4, type OpenAIProviderToolOptions as a5, type AnthropicProviderToolOptions as a6, type Citation as a7, type MessageAttachment as a8, type StreamTextResult as b, type Tool as c, type ToolDefinition as d, type ToolProfile as e, type StorageAdapter as f, type ReasoningEffort as g, type StreamEvent as h, type ToolCallInfo as i, type TokenUsageRaw as j, type Message as k, type ToolResponse as l, type StorageMessage as m, type ModelCapabilities as n, type DoGenerateParams as o, type DoGenerateResult as p, type SystemMessage as q, type AssistantMessage as r, type ToolMessage as s, type UserContentPart as t, type TextPart as u, type ToolCall as v, type ToolResult as w, type GenerateStep as x, type StreamPart as y, type StreamChunk as z };

package/dist/{types-BkQCSiIt.d.ts → types-D774b0dg.d.ts}

@@ -245,6 +245,42 @@ type ResponseFormat = {
         strict?: boolean;
     };
 };
+/**
+ * MCP (Model Context Protocol) server reference for a request.
+ *
+ * Vendor-neutral shape — each adapter translates to its provider's native
+ * field: OpenAI Responses `tools[type=mcp]`, Anthropic `mcp_servers` +
+ * `tools[type=mcp_toolset]` (beta `mcp-client-2025-11-20`), or local
+ * execution for adapters without native MCP.
+ */
+interface McpServerConfig {
+    /** Human-readable label sent to the provider (also used as MCP server name). */
+    label: string;
+    /** MCP server endpoint (HTTP/SSE URL). */
+    url: string;
+    /** Additional HTTP headers; the `Authorization` value is also extracted for providers that take a separate token field. */
+    headers?: Record<string, string>;
+    /** Restrict the model to a subset of the MCP server's exposed tools. */
+    allowedTools?: string[];
+    /** Approval policy for tool invocation. Defaults to "never" (no human-in-the-loop). */
+    requireApproval?: "never" | "always";
+}
+/**
+ * Reasoning effort knob — normalized across providers.
+ *
+ * Maps to OpenAI Responses `reasoning.effort`, Anthropic `thinking`
+ * (adaptive+effort on Claude 4.6/4.7, budget_tokens on older models),
+ * Gemini `thinkingBudget`, xAI `reasoning_effort`. Adapters silently
+ * no-op when the underlying model doesn't support reasoning.
+ *
+ * Use the enum for the common case, or `{ budgetTokens }` / `{ raw }`
+ * for provider-specific escape hatches when full fidelity is required.
+ */
+type ReasoningEffort = "minimal" | "low" | "medium" | "high" | {
+    budgetTokens: number;
+} | {
+    raw: Record<string, unknown>;
+};
 /**
  * LLM configuration
  */
@@ -252,6 +288,8 @@ interface LLMConfig {
     temperature?: number;
     maxTokens?: number;
     responseFormat?: ResponseFormat;
+    mcpServers?: McpServerConfig[];
+    reasoningEffort?: ReasoningEffort;
 }
 /**
  * Tool call format (OpenAI style)
@@ -620,7 +658,7 @@ interface ToolMessage {
 /**
  * Content parts for multimodal user messages
  */
-type UserContentPart = TextPart | ImagePart | FilePart;
+type UserContentPart = TextPart | ImagePart | FilePart | AudioPart;
 interface TextPart {
     type: "text";
     text: string;
@@ -639,6 +677,15 @@ interface FilePart {
     /** MIME type (e.g., 'application/pdf') */
     mimeType: string;
 }
+interface AudioPart {
+    type: "input_audio";
+    input_audio: {
+        /** Base64-encoded audio data */
+        data: string;
+        /** Audio format (e.g., 'mp3', 'wav', 'ogg', 'webm', 'm4a', 'flac') */
+        format: string;
+    };
+}
 /**
  * Tool definition with Zod schema support
  */
@@ -702,6 +749,10 @@ interface DoGenerateParams {
     maxTokens?: number;
     /** Structured-output / JSON-mode request format (provider-translated) */
     responseFormat?: ResponseFormat;
+    /** MCP servers exposed to the model (provider-translated). */
+    mcpServers?: McpServerConfig[];
+    /** Reasoning/thinking effort knob (provider-translated). */
+    reasoningEffort?: ReasoningEffort;
     /** Abort signal */
     signal?: AbortSignal;
 }
@@ -780,6 +831,10 @@ interface GenerateTextParams {
     maxTokens?: number;
     /** Structured-output / JSON-mode request format */
     responseFormat?: ResponseFormat;
+    /** MCP servers exposed to the model (provider-translated). */
+    mcpServers?: McpServerConfig[];
+    /** Reasoning/thinking effort knob (provider-translated). */
+    reasoningEffort?: ReasoningEffort;
     /** Abort signal */
     signal?: AbortSignal;
 }
@@ -960,4 +1015,4 @@ interface StorageFile {
     filename?: string;
 }
 
-export { type ToolExecution as $, type ActionDefinition as A, type ToolResultChunk as B, type CoreMessage as C, type DoneEventMessage as D, type FinishChunk as E, type FilePart as F, type GenerateTextParams as G, type ErrorChunk as H, type ImagePart as I, type TokenUsage as J, type KnowledgeBaseConfig as K, type LanguageModel as L, type Message as M, type FinishReason as N, type ResponseOptions as O, type ProviderToolRuntimeOptions as P, type StorageFile as Q, type ResponseFormat as R, type StreamTextParams as S, type ToolContext as T, type UserMessage as U, DEFAULT_CAPABILITIES as V, type WebSearchConfig as W, type LLMConfig as X, type ToolLocation as Y, type UnifiedToolCall as Z, type UnifiedToolResult as _, type GenerateTextResult as a, type OpenAIToolSelectionHints as a0, type AnthropicToolSelectionHints as a1, type ToolNativeProviderHints as a2, type OpenAIProviderToolOptions as a3, type AnthropicProviderToolOptions as a4, type Citation as a5, type MessageAttachment as a6, type StreamTextResult as b, type Tool as c, type ToolDefinition as d, type ToolProfile as e, type StorageAdapter as f, type StreamEvent as g, type ToolCallInfo as h, type TokenUsageRaw as i, type ToolResponse as j, type StorageMessage as k, type ModelCapabilities as l, type DoGenerateParams as m, type DoGenerateResult as n, type SystemMessage as o, type AssistantMessage as p, type ToolMessage as q, type UserContentPart as r, type TextPart as s, type ToolCall as t, type ToolResult as u, type GenerateStep as v, type StreamPart as w, type StreamChunk as x, type TextDeltaChunk as y, type ToolCallChunk as z };
+export { type UnifiedToolCall as $, type ActionDefinition as A, type TextDeltaChunk as B, type CoreMessage as C, type DoneEventMessage as D, type ToolCallChunk as E, type FilePart as F, type GenerateTextParams as G, type ToolResultChunk as H, type ImagePart as I, type FinishChunk as J, type KnowledgeBaseConfig as K, type LanguageModel as L, type McpServerConfig as M, type ErrorChunk as N, type TokenUsage as O, type ProviderToolRuntimeOptions as P, type FinishReason as Q, type ResponseFormat as R, type StreamTextParams as S, type ToolContext as T, type UserMessage as U, type ResponseOptions as V, type WebSearchConfig as W, type StorageFile as X, DEFAULT_CAPABILITIES as Y, type LLMConfig as Z, type ToolLocation as _, type GenerateTextResult as a, type UnifiedToolResult as a0, type ToolExecution as a1, type OpenAIToolSelectionHints as a2, type AnthropicToolSelectionHints as a3, type ToolNativeProviderHints as a4, type OpenAIProviderToolOptions as a5, type AnthropicProviderToolOptions as a6, type Citation as a7, type MessageAttachment as a8, type StreamTextResult as b, type Tool as c, type ToolDefinition as d, type ToolProfile as e, type StorageAdapter as f, type ReasoningEffort as g, type StreamEvent as h, type ToolCallInfo as i, type TokenUsageRaw as j, type Message as k, type ToolResponse as l, type StorageMessage as m, type ModelCapabilities as n, type DoGenerateParams as o, type DoGenerateResult as p, type SystemMessage as q, type AssistantMessage as r, type ToolMessage as s, type UserContentPart as t, type TextPart as u, type ToolCall as v, type ToolResult as w, type GenerateStep as x, type StreamPart as y, type StreamChunk as z };

package/dist/{types-BQ31QIsA.d.ts → types-TMilS-Dz.d.ts}

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

package/dist/{types-B6dhnguR.d.mts → types-mwMhCwOq.d.mts}

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

package/dist/yourgpt/index.d.mts

@@ -1,4 +1,4 @@
-import { k as StorageMessage, f as StorageAdapter, Q as StorageFile } from '../types-BkQCSiIt.mjs';
+import { m as StorageMessage, f as StorageAdapter, X as StorageFile } from '../types-D774b0dg.mjs';
 import 'zod';
 
 /**

package/dist/yourgpt/index.d.ts

@@ -1,4 +1,4 @@
-import { k as StorageMessage, f as StorageAdapter, Q as StorageFile } from '../types-BkQCSiIt.js';
+import { m as StorageMessage, f as StorageAdapter, X as StorageFile } from '../types-D774b0dg.js';
 import 'zod';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yourgpt/llm-sdk",
-  "version": "2.5.1-beta.0",
+  "version": "2.5.1-beta.1",
   "description": "AI SDK for building AI Agents with any LLM",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",