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

package/dist/base-C58Dsr9p.d.ts

@@ -0,0 +1,259 @@
+import { M as Message, A as ActionDefinition, d as ToolDefinition, R as ResponseFormat, W as WebSearchConfig, P as ProviderToolRuntimeOptions, g as StreamEvent, J as TokenUsage, X as LLMConfig, a6 as MessageAttachment } from './types-BkQCSiIt.js';
+
+/**
+ * Request-level LLM configuration overrides
+ */
+interface RequestLLMConfig {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    responseFormat?: ResponseFormat;
+}
+/**
+ * Chat completion request
+ */
+interface ChatCompletionRequest {
+    /** Conversation messages */
+    messages: Message[];
+    /**
+     * Raw provider-formatted messages (for agent loop with tool calls)
+     * When provided, these are used instead of converting from Message[]
+     * This allows passing messages with tool_calls and tool role
+     */
+    rawMessages?: Array<Record<string, unknown>>;
+    /** Available actions/tools */
+    actions?: ActionDefinition[];
+    /** Full tool definitions for provider-native tool search / deferred loading paths. */
+    toolDefinitions?: ToolDefinition[];
+    /** System prompt */
+    systemPrompt?: string;
+    /** LLM configuration overrides */
+    config?: RequestLLMConfig;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+    /**
+     * Enable native web search for the provider.
+     * When true or configured, the provider's native search is enabled.
+     */
+    webSearch?: boolean | WebSearchConfig;
+    /** Optional provider-specific tool policy hints derived from runtime selection. */
+    providerToolOptions?: ProviderToolRuntimeOptions;
+    /** Enable adapter-level provider payload logging. */
+    debug?: boolean;
+}
+/**
+ * Non-streaming completion result
+ */
+interface CompletionResult {
+    /** Text content */
+    content: string;
+    /** Tool calls */
+    toolCalls: Array<{
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+        /** Provider-specific metadata (e.g. Gemini 3 thought_signature in extra_content.google) */
+        extra_content?: Record<string, unknown>;
+    }>;
+    /** Thinking content (if extended thinking enabled) */
+    thinking?: string;
+    /** Token usage for billing/tracking */
+    usage?: TokenUsage;
+    /** Raw provider response for debugging */
+    rawResponse: Record<string, unknown>;
+}
+/**
+ * Base LLM adapter interface
+ */
+interface LLMAdapter {
+    /** Provider name */
+    readonly provider: string;
+    /** Model name */
+    readonly model: string;
+    /**
+     * Stream a chat completion
+     */
+    stream(request: ChatCompletionRequest): AsyncGenerator<StreamEvent>;
+    /**
+     * Non-streaming chat completion (for debugging/comparison)
+     */
+    complete?(request: ChatCompletionRequest): Promise<CompletionResult>;
+}
+/**
+ * Adapter factory function type
+ */
+type AdapterFactory = (config: LLMConfig) => LLMAdapter;
+/**
+ * Convert messages to provider format (simple text only)
+ */
+declare function formatMessages(messages: Message[], systemPrompt?: string): Array<{
+    role: string;
+    content: string;
+}>;
+/**
+ * Convert actions to OpenAI tool format
+ */
+declare function formatTools(actions: ActionDefinition[]): Array<{
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: object;
+    };
+}>;
+/**
+ * Content block types for multimodal messages
+ */
+type AnthropicContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    source: {
+        type: "base64";
+        media_type: string;
+        data: string;
+    } | {
+        type: "url";
+        url: string;
+    };
+} | {
+    type: "document";
+    source: {
+        type: "base64";
+        media_type: string;
+        data: string;
+    } | {
+        type: "url";
+        url: string;
+    };
+};
+type OpenAIContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "low" | "high" | "auto";
+    };
+};
+/**
+ * Check if a message has image attachments
+ * Supports both new format (metadata.attachments) and legacy (attachments)
+ */
+declare function hasImageAttachments(message: Message): boolean;
+/**
+ * Check if a message has media attachments (images or PDFs)
+ */
+declare function hasMediaAttachments(message: Message): boolean;
+/**
+ * Convert MessageAttachment to Anthropic image content block
+ *
+ * Anthropic format:
+ * {
+ *   type: "image",
+ *   source: {
+ *     type: "base64",
+ *     media_type: "image/png",
+ *     data: "base64data..."
+ *   }
+ * }
+ */
+declare function attachmentToAnthropicImage(attachment: MessageAttachment): AnthropicContentBlock | null;
+/**
+ * Convert MessageAttachment to OpenAI image_url content block
+ *
+ * OpenAI format:
+ * {
+ *   type: "image_url",
+ *   image_url: {
+ *     url: "data:image/png;base64,..."
+ *   }
+ * }
+ */
+declare function attachmentToOpenAIImage(attachment: MessageAttachment): OpenAIContentBlock | null;
+/**
+ * Convert MessageAttachment (PDF) to Anthropic document content block
+ *
+ * Anthropic format:
+ * {
+ *   type: "document",
+ *   source: {
+ *     type: "base64",
+ *     media_type: "application/pdf",
+ *     data: "base64data..."
+ *   }
+ * }
+ */
+declare function attachmentToAnthropicDocument(attachment: MessageAttachment): AnthropicContentBlock | null;
+/**
+ * Convert a Message to Anthropic multimodal content blocks
+ */
+declare function messageToAnthropicContent(message: Message): string | AnthropicContentBlock[];
+/**
+ * Convert a Message to OpenAI multimodal content blocks
+ */
+declare function messageToOpenAIContent(message: Message): string | OpenAIContentBlock[];
+/**
+ * Anthropic content block types (extended for tools)
+ */
+type AnthropicToolUseBlock = {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+};
+type AnthropicToolResultBlock = {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+};
+type AnthropicMessageContent = string | Array<AnthropicContentBlock | AnthropicToolUseBlock | AnthropicToolResultBlock>;
+/**
+ * Format messages for Anthropic with full tool support
+ * Handles: text, images, tool_use, and tool_result
+ *
+ * Key differences from OpenAI:
+ * - tool_calls become tool_use blocks in assistant content
+ * - tool results become tool_result blocks in user content
+ */
+declare function formatMessagesForAnthropic(messages: Message[], systemPrompt?: string): {
+    system: string;
+    messages: Array<{
+        role: "user" | "assistant";
+        content: AnthropicMessageContent;
+    }>;
+};
+/**
+ * OpenAI message format with tool support
+ */
+type OpenAIMessage = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: string | OpenAIContentBlock[];
+} | {
+    role: "assistant";
+    content: string | null;
+    tool_calls?: Array<{
+        id: string;
+        type: "function";
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+} | {
+    role: "tool";
+    content: string;
+    tool_call_id: string;
+};
+/**
+ * Format messages for OpenAI with full tool support
+ * Handles: text, images, tool_calls, and tool results
+ */
+declare function formatMessagesForOpenAI(messages: Message[], systemPrompt?: string): OpenAIMessage[];
+
+export { type AdapterFactory as A, type ChatCompletionRequest as C, type LLMAdapter as L, type OpenAIContentBlock as O, type CompletionResult as a, formatTools as b, formatMessagesForAnthropic as c, formatMessagesForOpenAI as d, messageToOpenAIContent as e, formatMessages as f, hasMediaAttachments as g, hasImageAttachments as h, attachmentToAnthropicImage as i, attachmentToAnthropicDocument as j, attachmentToOpenAIImage as k, type AnthropicContentBlock as l, messageToAnthropicContent as m };

package/dist/base-tNgbBaSo.d.mts

@@ -0,0 +1,259 @@
+import { M as Message, A as ActionDefinition, d as ToolDefinition, R as ResponseFormat, W as WebSearchConfig, P as ProviderToolRuntimeOptions, g as StreamEvent, J as TokenUsage, X as LLMConfig, a6 as MessageAttachment } from './types-BkQCSiIt.mjs';
+
+/**
+ * Request-level LLM configuration overrides
+ */
+interface RequestLLMConfig {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    responseFormat?: ResponseFormat;
+}
+/**
+ * Chat completion request
+ */
+interface ChatCompletionRequest {
+    /** Conversation messages */
+    messages: Message[];
+    /**
+     * Raw provider-formatted messages (for agent loop with tool calls)
+     * When provided, these are used instead of converting from Message[]
+     * This allows passing messages with tool_calls and tool role
+     */
+    rawMessages?: Array<Record<string, unknown>>;
+    /** Available actions/tools */
+    actions?: ActionDefinition[];
+    /** Full tool definitions for provider-native tool search / deferred loading paths. */
+    toolDefinitions?: ToolDefinition[];
+    /** System prompt */
+    systemPrompt?: string;
+    /** LLM configuration overrides */
+    config?: RequestLLMConfig;
+    /** Abort signal for cancellation */
+    signal?: AbortSignal;
+    /**
+     * Enable native web search for the provider.
+     * When true or configured, the provider's native search is enabled.
+     */
+    webSearch?: boolean | WebSearchConfig;
+    /** Optional provider-specific tool policy hints derived from runtime selection. */
+    providerToolOptions?: ProviderToolRuntimeOptions;
+    /** Enable adapter-level provider payload logging. */
+    debug?: boolean;
+}
+/**
+ * Non-streaming completion result
+ */
+interface CompletionResult {
+    /** Text content */
+    content: string;
+    /** Tool calls */
+    toolCalls: Array<{
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+        /** Provider-specific metadata (e.g. Gemini 3 thought_signature in extra_content.google) */
+        extra_content?: Record<string, unknown>;
+    }>;
+    /** Thinking content (if extended thinking enabled) */
+    thinking?: string;
+    /** Token usage for billing/tracking */
+    usage?: TokenUsage;
+    /** Raw provider response for debugging */
+    rawResponse: Record<string, unknown>;
+}
+/**
+ * Base LLM adapter interface
+ */
+interface LLMAdapter {
+    /** Provider name */
+    readonly provider: string;
+    /** Model name */
+    readonly model: string;
+    /**
+     * Stream a chat completion
+     */
+    stream(request: ChatCompletionRequest): AsyncGenerator<StreamEvent>;
+    /**
+     * Non-streaming chat completion (for debugging/comparison)
+     */
+    complete?(request: ChatCompletionRequest): Promise<CompletionResult>;
+}
+/**
+ * Adapter factory function type
+ */
+type AdapterFactory = (config: LLMConfig) => LLMAdapter;
+/**
+ * Convert messages to provider format (simple text only)
+ */
+declare function formatMessages(messages: Message[], systemPrompt?: string): Array<{
+    role: string;
+    content: string;
+}>;
+/**
+ * Convert actions to OpenAI tool format
+ */
+declare function formatTools(actions: ActionDefinition[]): Array<{
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: object;
+    };
+}>;
+/**
+ * Content block types for multimodal messages
+ */
+type AnthropicContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    source: {
+        type: "base64";
+        media_type: string;
+        data: string;
+    } | {
+        type: "url";
+        url: string;
+    };
+} | {
+    type: "document";
+    source: {
+        type: "base64";
+        media_type: string;
+        data: string;
+    } | {
+        type: "url";
+        url: string;
+    };
+};
+type OpenAIContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "low" | "high" | "auto";
+    };
+};
+/**
+ * Check if a message has image attachments
+ * Supports both new format (metadata.attachments) and legacy (attachments)
+ */
+declare function hasImageAttachments(message: Message): boolean;
+/**
+ * Check if a message has media attachments (images or PDFs)
+ */
+declare function hasMediaAttachments(message: Message): boolean;
+/**
+ * Convert MessageAttachment to Anthropic image content block
+ *
+ * Anthropic format:
+ * {
+ *   type: "image",
+ *   source: {
+ *     type: "base64",
+ *     media_type: "image/png",
+ *     data: "base64data..."
+ *   }
+ * }
+ */
+declare function attachmentToAnthropicImage(attachment: MessageAttachment): AnthropicContentBlock | null;
+/**
+ * Convert MessageAttachment to OpenAI image_url content block
+ *
+ * OpenAI format:
+ * {
+ *   type: "image_url",
+ *   image_url: {
+ *     url: "data:image/png;base64,..."
+ *   }
+ * }
+ */
+declare function attachmentToOpenAIImage(attachment: MessageAttachment): OpenAIContentBlock | null;
+/**
+ * Convert MessageAttachment (PDF) to Anthropic document content block
+ *
+ * Anthropic format:
+ * {
+ *   type: "document",
+ *   source: {
+ *     type: "base64",
+ *     media_type: "application/pdf",
+ *     data: "base64data..."
+ *   }
+ * }
+ */
+declare function attachmentToAnthropicDocument(attachment: MessageAttachment): AnthropicContentBlock | null;
+/**
+ * Convert a Message to Anthropic multimodal content blocks
+ */
+declare function messageToAnthropicContent(message: Message): string | AnthropicContentBlock[];
+/**
+ * Convert a Message to OpenAI multimodal content blocks
+ */
+declare function messageToOpenAIContent(message: Message): string | OpenAIContentBlock[];
+/**
+ * Anthropic content block types (extended for tools)
+ */
+type AnthropicToolUseBlock = {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+};
+type AnthropicToolResultBlock = {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+};
+type AnthropicMessageContent = string | Array<AnthropicContentBlock | AnthropicToolUseBlock | AnthropicToolResultBlock>;
+/**
+ * Format messages for Anthropic with full tool support
+ * Handles: text, images, tool_use, and tool_result
+ *
+ * Key differences from OpenAI:
+ * - tool_calls become tool_use blocks in assistant content
+ * - tool results become tool_result blocks in user content
+ */
+declare function formatMessagesForAnthropic(messages: Message[], systemPrompt?: string): {
+    system: string;
+    messages: Array<{
+        role: "user" | "assistant";
+        content: AnthropicMessageContent;
+    }>;
+};
+/**
+ * OpenAI message format with tool support
+ */
+type OpenAIMessage = {
+    role: "system";
+    content: string;
+} | {
+    role: "user";
+    content: string | OpenAIContentBlock[];
+} | {
+    role: "assistant";
+    content: string | null;
+    tool_calls?: Array<{
+        id: string;
+        type: "function";
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+} | {
+    role: "tool";
+    content: string;
+    tool_call_id: string;
+};
+/**
+ * Format messages for OpenAI with full tool support
+ * Handles: text, images, tool_calls, and tool results
+ */
+declare function formatMessagesForOpenAI(messages: Message[], systemPrompt?: string): OpenAIMessage[];
+
+export { type AdapterFactory as A, type ChatCompletionRequest as C, type LLMAdapter as L, type OpenAIContentBlock as O, type CompletionResult as a, formatTools as b, formatMessagesForAnthropic as c, formatMessagesForOpenAI as d, messageToOpenAIContent as e, formatMessages as f, hasMediaAttachments as g, hasImageAttachments as h, attachmentToAnthropicImage as i, attachmentToAnthropicDocument as j, attachmentToOpenAIImage as k, type AnthropicContentBlock as l, messageToAnthropicContent as m };

package/dist/fallback/index.d.mts

@@ -1,7 +1,7 @@
-import { L as LLMAdapter } from '../base-D-U61JaB.mjs';
-import { F as FallbackChainConfig, c as FallbackFailure, R as RoutingStore } from '../types-D4YfrQJR.mjs';
-export { d as FallbackInfo, b as RetryBackoff, e as RetryInfo, a as RoutingStrategy } from '../types-D4YfrQJR.mjs';
-import '../types-CR8mi9I0.mjs';
+import { L as LLMAdapter } from '../base-tNgbBaSo.mjs';
+import { F as FallbackChainConfig, c as FallbackFailure, R as RoutingStore } from '../types-B6dhnguR.mjs';
+export { d as FallbackInfo, b as RetryBackoff, e as RetryInfo, a as RoutingStrategy } from '../types-B6dhnguR.mjs';
+import '../types-BkQCSiIt.mjs';
 import 'zod';
 
 /**

package/dist/fallback/index.d.ts

@@ -1,7 +1,7 @@
-import { L as LLMAdapter } from '../base-iGi9Va6Z.js';
-import { F as FallbackChainConfig, c as FallbackFailure, R as RoutingStore } from '../types-38yolWJn.js';
-export { d as FallbackInfo, b as RetryBackoff, e as RetryInfo, a as RoutingStrategy } from '../types-38yolWJn.js';
-import '../types-CR8mi9I0.js';
+import { L as LLMAdapter } from '../base-C58Dsr9p.js';
+import { F as FallbackChainConfig, c as FallbackFailure, R as RoutingStore } from '../types-CCxPmkmK.js';
+export { d as FallbackInfo, b as RetryBackoff, e as RetryInfo, a as RoutingStrategy } from '../types-CCxPmkmK.js';
+import '../types-BkQCSiIt.js';
 import 'zod';
 
 /**

package/dist/index.d.mts

@@ -1,13 +1,13 @@
-import { G as GenerateTextParams, a as GenerateTextResult, S as StreamTextParams, b as StreamTextResult, T as ToolContext, c as Tool, d as StorageAdapter, e as StorageMessage } from './types-CR8mi9I0.mjs';
-export { A as AssistantMessage, C as CoreMessage, w as DEFAULT_CAPABILITIES, D as DoGenerateParams, f as DoGenerateResult, E as ErrorChunk, F as FilePart, s as FinishChunk, u as FinishReason, m as GenerateStep, I as ImagePart, L as LanguageModel, M as ModelCapabilities, R as ResponseOptions, v as StorageFile, o as StreamChunk, n as StreamPart, g as SystemMessage, p as TextDeltaChunk, j as TextPart, t as TokenUsage, k as ToolCall, q as ToolCallChunk, h as ToolMessage, l as ToolResult, r as ToolResultChunk, i as UserContentPart, U as UserMessage } from './types-CR8mi9I0.mjs';
+import { G as GenerateTextParams, a as GenerateTextResult, S as StreamTextParams, b as StreamTextResult, T as ToolContext, c as Tool, A as ActionDefinition, d as ToolDefinition, e as ToolProfile, K as KnowledgeBaseConfig, W as WebSearchConfig, f as StorageAdapter, R as ResponseFormat, D as DoneEventMessage, g as StreamEvent, h as ToolCallInfo, i as TokenUsageRaw, P as ProviderToolRuntimeOptions, M as Message, j as ToolResponse, k as StorageMessage } from './types-BkQCSiIt.mjs';
+export { a4 as AnthropicProviderToolOptions, a1 as AnthropicToolSelectionHints, p as AssistantMessage, a5 as Citation, C as CoreMessage, V as DEFAULT_CAPABILITIES, m as DoGenerateParams, n as DoGenerateResult, H as ErrorChunk, F as FilePart, E as FinishChunk, N as FinishReason, v as GenerateStep, I as ImagePart, X as LLMConfig, L as LanguageModel, l as ModelCapabilities, a3 as OpenAIProviderToolOptions, a0 as OpenAIToolSelectionHints, O as ResponseOptions, Q as StorageFile, x as StreamChunk, w as StreamPart, o as SystemMessage, y as TextDeltaChunk, s as TextPart, J as TokenUsage, t as ToolCall, z as ToolCallChunk, $ as ToolExecution, Y as ToolLocation, q as ToolMessage, a2 as ToolNativeProviderHints, u as ToolResult, B as ToolResultChunk, Z as UnifiedToolCall, _ as UnifiedToolResult, r as UserContentPart, U as UserMessage } from './types-BkQCSiIt.mjs';
 import { z } from 'zod';
-import { A as ActionDefinition, T as ToolDefinition, a as ToolProfile, K as KnowledgeBaseConfig, W as WebSearchConfig, L as LLMAdapter, D as DoneEventMessage, S as StreamEvent, b as ToolCallInfo, c as TokenUsageRaw, P as ProviderToolRuntimeOptions, M as Message, d as ToolResponse } from './base-D-U61JaB.mjs';
-export { e as AdapterFactory, m as AnthropicProviderToolOptions, j as AnthropicToolSelectionHints, C as ChatCompletionRequest, n as Citation, f as LLMConfig, l as OpenAIProviderToolOptions, O as OpenAIToolSelectionHints, i as ToolExecution, g as ToolLocation, k as ToolNativeProviderHints, U as UnifiedToolCall, h as UnifiedToolResult } from './base-D-U61JaB.mjs';
-import { A as AIProvider } from './types-DRqxMIjF.mjs';
-export { a as AnthropicProviderConfig, f as AnthropicTool, h as AnthropicToolResult, g as AnthropicToolUse, b as AzureProviderConfig, B as BaseProviderConfig, m as GeminiFunctionCall, l as GeminiFunctionDeclaration, n as GeminiFunctionResponse, G as GoogleProviderConfig, d as OllamaModelOptions, c as OllamaProviderConfig, O as OpenAIProviderConfig, i as OpenAITool, j as OpenAIToolCall, k as OpenAIToolResult, P as ProviderCapabilities, e as ProviderFormatter, X as XAIProviderConfig } from './types-DRqxMIjF.mjs';
+import { A as AIProvider } from './types-BSSiJW2o.mjs';
+export { a as AnthropicProviderConfig, f as AnthropicTool, h as AnthropicToolResult, g as AnthropicToolUse, b as AzureProviderConfig, B as BaseProviderConfig, m as GeminiFunctionCall, l as GeminiFunctionDeclaration, n as GeminiFunctionResponse, G as GoogleProviderConfig, d as OllamaModelOptions, c as OllamaProviderConfig, O as OpenAIProviderConfig, i as OpenAITool, j as OpenAIToolCall, k as OpenAIToolResult, P as ProviderCapabilities, e as ProviderFormatter, X as XAIProviderConfig } from './types-BSSiJW2o.mjs';
+import { L as LLMAdapter } from './base-tNgbBaSo.mjs';
+export { A as AdapterFactory, C as ChatCompletionRequest } from './base-tNgbBaSo.mjs';
 import * as hono from 'hono';
 import { Hono } from 'hono';
-export { F as FallbackChainConfig, c as FallbackFailure, d as FallbackInfo, b as RetryBackoff, e as RetryInfo, R as RoutingStore, a as RoutingStrategy } from './types-D4YfrQJR.mjs';
+export { F as FallbackChainConfig, c as FallbackFailure, d as FallbackInfo, b as RetryBackoff, e as RetryInfo, R as RoutingStore, a as RoutingStrategy } from './types-B6dhnguR.mjs';
 
 /**
  * generateText - Generate text using a language model
@@ -388,6 +388,7 @@ interface ChatRequest {
     config?: {
         temperature?: number;
         maxTokens?: number;
+        responseFormat?: ResponseFormat;
     };
     /** System prompt override */
     systemPrompt?: string;

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import { G as GenerateTextParams, a as GenerateTextResult, S as StreamTextParams, b as StreamTextResult, T as ToolContext, c as Tool, d as StorageAdapter, e as StorageMessage } from './types-CR8mi9I0.js';
-export { A as AssistantMessage, C as CoreMessage, w as DEFAULT_CAPABILITIES, D as DoGenerateParams, f as DoGenerateResult, E as ErrorChunk, F as FilePart, s as FinishChunk, u as FinishReason, m as GenerateStep, I as ImagePart, L as LanguageModel, M as ModelCapabilities, R as ResponseOptions, v as StorageFile, o as StreamChunk, n as StreamPart, g as SystemMessage, p as TextDeltaChunk, j as TextPart, t as TokenUsage, k as ToolCall, q as ToolCallChunk, h as ToolMessage, l as ToolResult, r as ToolResultChunk, i as UserContentPart, U as UserMessage } from './types-CR8mi9I0.js';
+import { G as GenerateTextParams, a as GenerateTextResult, S as StreamTextParams, b as StreamTextResult, T as ToolContext, c as Tool, A as ActionDefinition, d as ToolDefinition, e as ToolProfile, K as KnowledgeBaseConfig, W as WebSearchConfig, f as StorageAdapter, R as ResponseFormat, D as DoneEventMessage, g as StreamEvent, h as ToolCallInfo, i as TokenUsageRaw, P as ProviderToolRuntimeOptions, M as Message, j as ToolResponse, k as StorageMessage } from './types-BkQCSiIt.js';
+export { a4 as AnthropicProviderToolOptions, a1 as AnthropicToolSelectionHints, p as AssistantMessage, a5 as Citation, C as CoreMessage, V as DEFAULT_CAPABILITIES, m as DoGenerateParams, n as DoGenerateResult, H as ErrorChunk, F as FilePart, E as FinishChunk, N as FinishReason, v as GenerateStep, I as ImagePart, X as LLMConfig, L as LanguageModel, l as ModelCapabilities, a3 as OpenAIProviderToolOptions, a0 as OpenAIToolSelectionHints, O as ResponseOptions, Q as StorageFile, x as StreamChunk, w as StreamPart, o as SystemMessage, y as TextDeltaChunk, s as TextPart, J as TokenUsage, t as ToolCall, z as ToolCallChunk, $ as ToolExecution, Y as ToolLocation, q as ToolMessage, a2 as ToolNativeProviderHints, u as ToolResult, B as ToolResultChunk, Z as UnifiedToolCall, _ as UnifiedToolResult, r as UserContentPart, U as UserMessage } from './types-BkQCSiIt.js';
 import { z } from 'zod';
-import { A as ActionDefinition, T as ToolDefinition, a as ToolProfile, K as KnowledgeBaseConfig, W as WebSearchConfig, L as LLMAdapter, D as DoneEventMessage, S as StreamEvent, b as ToolCallInfo, c as TokenUsageRaw, P as ProviderToolRuntimeOptions, M as Message, d as ToolResponse } from './base-iGi9Va6Z.js';
-export { e as AdapterFactory, m as AnthropicProviderToolOptions, j as AnthropicToolSelectionHints, C as ChatCompletionRequest, n as Citation, f as LLMConfig, l as OpenAIProviderToolOptions, O as OpenAIToolSelectionHints, i as ToolExecution, g as ToolLocation, k as ToolNativeProviderHints, U as UnifiedToolCall, h as UnifiedToolResult } from './base-iGi9Va6Z.js';
-import { A as AIProvider } from './types-BctsnC3g.js';
-export { a as AnthropicProviderConfig, f as AnthropicTool, h as AnthropicToolResult, g as AnthropicToolUse, b as AzureProviderConfig, B as BaseProviderConfig, m as GeminiFunctionCall, l as GeminiFunctionDeclaration, n as GeminiFunctionResponse, G as GoogleProviderConfig, d as OllamaModelOptions, c as OllamaProviderConfig, O as OpenAIProviderConfig, i as OpenAITool, j as OpenAIToolCall, k as OpenAIToolResult, P as ProviderCapabilities, e as ProviderFormatter, X as XAIProviderConfig } from './types-BctsnC3g.js';
+import { A as AIProvider } from './types-BQ31QIsA.js';
+export { a as AnthropicProviderConfig, f as AnthropicTool, h as AnthropicToolResult, g as AnthropicToolUse, b as AzureProviderConfig, B as BaseProviderConfig, m as GeminiFunctionCall, l as GeminiFunctionDeclaration, n as GeminiFunctionResponse, G as GoogleProviderConfig, d as OllamaModelOptions, c as OllamaProviderConfig, O as OpenAIProviderConfig, i as OpenAITool, j as OpenAIToolCall, k as OpenAIToolResult, P as ProviderCapabilities, e as ProviderFormatter, X as XAIProviderConfig } from './types-BQ31QIsA.js';
+import { L as LLMAdapter } from './base-C58Dsr9p.js';
+export { A as AdapterFactory, C as ChatCompletionRequest } from './base-C58Dsr9p.js';
 import * as hono from 'hono';
 import { Hono } from 'hono';
-export { F as FallbackChainConfig, c as FallbackFailure, d as FallbackInfo, b as RetryBackoff, e as RetryInfo, R as RoutingStore, a as RoutingStrategy } from './types-38yolWJn.js';
+export { F as FallbackChainConfig, c as FallbackFailure, d as FallbackInfo, b as RetryBackoff, e as RetryInfo, R as RoutingStore, a as RoutingStrategy } from './types-CCxPmkmK.js';
 
 /**
  * generateText - Generate text using a language model
@@ -388,6 +388,7 @@ interface ChatRequest {
     config?: {
         temperature?: number;
         maxTokens?: number;
+        responseFormat?: ResponseFormat;
     };
     /** System prompt override */
     systemPrompt?: string;

package/dist/index.js

@@ -135,6 +135,11 @@ function formatToolsForGoogle(tools) {
 // src/core/generate-text.ts
 async function generateText(params) {
   const { model, tools, maxSteps = 1, signal } = params;
+  if (params.responseFormat && model.capabilities.supportsJsonMode === false) {
+    console.warn(
+      `[llm-sdk] ${model.provider}/${model.modelId} does not support structured output (responseFormat); the request will be sent but the provider may ignore it.`
+    );
+  }
   let messages = buildMessages(params);
   const steps = [];
   const allToolCalls = [];
@@ -149,6 +154,7 @@ async function generateText(params) {
       tools: formattedTools,
       temperature: params.temperature,
       maxTokens: params.maxTokens,
+      responseFormat: params.responseFormat,
       signal
     });
     const stepToolResults = [];
@@ -266,6 +272,11 @@ function sumUsage(steps) {
 // src/core/stream-text.ts
 async function streamText(params) {
   const { model, tools, maxSteps = 1, signal } = params;
+  if (params.responseFormat && model.capabilities.supportsJsonMode === false) {
+    console.warn(
+      `[llm-sdk] ${model.provider}/${model.modelId} does not support structured output (responseFormat); the request will be sent but the provider may ignore it.`
+    );
+  }
   let fullText = "";
   let finalUsage = {
     promptTokens: 0,
@@ -291,6 +302,7 @@ async function streamText(params) {
           tools: formattedTools,
           temperature: params.temperature,
           maxTokens: params.maxTokens,
+          responseFormat: params.responseFormat,
           signal
         })) {
           switch (chunk.type) {