@yourgpt/llm-sdk 2.6.0-beta.1 → 2.6.0-beta.3

package/dist/audio-BBSwnjo8.d.mts

@@ -0,0 +1,92 @@
+/** Audio models are independent of chat models and chat streaming events. */
+type SpeechFormat = "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+interface AudioResponseMetadata {
+    provider: string;
+    modelId: string;
+    requestId?: string;
+    status?: number;
+}
+interface AudioWarning {
+    code: string;
+    message: string;
+}
+interface SpeechOptions {
+    text: string;
+    voice?: string;
+    outputFormat?: SpeechFormat;
+    speed?: number;
+    instructions?: string;
+    signal?: AbortSignal;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+interface GeneratedSpeech {
+    audio: {
+        uint8Array: Uint8Array;
+        readonly base64: string;
+        mediaType: string;
+        format: SpeechFormat;
+    };
+    response: AudioResponseMetadata;
+    warnings: AudioWarning[];
+    usage?: Record<string, unknown>;
+}
+interface SpeechModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doGenerate(options: SpeechOptions): Promise<GeneratedSpeech>;
+}
+interface TranscriptionOptions {
+    /** Recorded file bytes, base64, or a Blob. URLs and raw PCM are not fetched/decoded. */
+    audio: Uint8Array | ArrayBuffer | Blob | string;
+    mediaType?: string;
+    filename?: string;
+    language?: string;
+    prompt?: string;
+    signal?: AbortSignal;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+interface TranscriptSegment {
+    text: string;
+    start: number;
+    end: number;
+    speaker?: string;
+}
+interface TranscriptionResult {
+    text: string;
+    language?: string;
+    durationSeconds?: number;
+    segments?: TranscriptSegment[];
+    words?: Array<{
+        word: string;
+        start: number;
+        end: number;
+    }>;
+    response: AudioResponseMetadata;
+    warnings: AudioWarning[];
+    usage?: Record<string, unknown>;
+    /** Provider-supplied extras, including log probabilities when requested. */
+    providerMetadata?: Record<string, unknown>;
+}
+interface TranscriptionModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doTranscribe(options: TranscriptionOptions): Promise<TranscriptionResult>;
+}
+declare const audioErrorMarker: unique symbol;
+declare class AudioAPIError extends Error {
+    readonly code: "invalid_input" | "unsupported_option" | "provider_error" | "invalid_response" | "network_error";
+    readonly status?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly [audioErrorMarker] = true;
+    static [Symbol.hasInstance](value: unknown): boolean;
+    readonly name = "AudioAPIError";
+    constructor(message: string, code: "invalid_input" | "unsupported_option" | "provider_error" | "invalid_response" | "network_error", status?: number | undefined, requestId?: string | undefined);
+}
+declare function generateSpeech({ model, ...options }: SpeechOptions & {
+    model: SpeechModel;
+}): Promise<GeneratedSpeech>;
+declare function transcribe({ model, ...options }: TranscriptionOptions & {
+    model: TranscriptionModel;
+}): Promise<TranscriptionResult>;
+
+export { AudioAPIError as A, type GeneratedSpeech as G, type SpeechModel as S, type TranscriptionModel as T, type SpeechOptions as a, type TranscriptionOptions as b, type TranscriptionResult as c, type SpeechFormat as d, type TranscriptSegment as e, type AudioResponseMetadata as f, generateSpeech as g, type AudioWarning as h, transcribe as t };

package/dist/audio-BBSwnjo8.d.ts

@@ -0,0 +1,92 @@
+/** Audio models are independent of chat models and chat streaming events. */
+type SpeechFormat = "mp3" | "opus" | "aac" | "flac" | "wav" | "pcm";
+interface AudioResponseMetadata {
+    provider: string;
+    modelId: string;
+    requestId?: string;
+    status?: number;
+}
+interface AudioWarning {
+    code: string;
+    message: string;
+}
+interface SpeechOptions {
+    text: string;
+    voice?: string;
+    outputFormat?: SpeechFormat;
+    speed?: number;
+    instructions?: string;
+    signal?: AbortSignal;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+interface GeneratedSpeech {
+    audio: {
+        uint8Array: Uint8Array;
+        readonly base64: string;
+        mediaType: string;
+        format: SpeechFormat;
+    };
+    response: AudioResponseMetadata;
+    warnings: AudioWarning[];
+    usage?: Record<string, unknown>;
+}
+interface SpeechModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doGenerate(options: SpeechOptions): Promise<GeneratedSpeech>;
+}
+interface TranscriptionOptions {
+    /** Recorded file bytes, base64, or a Blob. URLs and raw PCM are not fetched/decoded. */
+    audio: Uint8Array | ArrayBuffer | Blob | string;
+    mediaType?: string;
+    filename?: string;
+    language?: string;
+    prompt?: string;
+    signal?: AbortSignal;
+    providerOptions?: Record<string, Record<string, unknown>>;
+}
+interface TranscriptSegment {
+    text: string;
+    start: number;
+    end: number;
+    speaker?: string;
+}
+interface TranscriptionResult {
+    text: string;
+    language?: string;
+    durationSeconds?: number;
+    segments?: TranscriptSegment[];
+    words?: Array<{
+        word: string;
+        start: number;
+        end: number;
+    }>;
+    response: AudioResponseMetadata;
+    warnings: AudioWarning[];
+    usage?: Record<string, unknown>;
+    /** Provider-supplied extras, including log probabilities when requested. */
+    providerMetadata?: Record<string, unknown>;
+}
+interface TranscriptionModel {
+    readonly provider: string;
+    readonly modelId: string;
+    doTranscribe(options: TranscriptionOptions): Promise<TranscriptionResult>;
+}
+declare const audioErrorMarker: unique symbol;
+declare class AudioAPIError extends Error {
+    readonly code: "invalid_input" | "unsupported_option" | "provider_error" | "invalid_response" | "network_error";
+    readonly status?: number | undefined;
+    readonly requestId?: string | undefined;
+    readonly [audioErrorMarker] = true;
+    static [Symbol.hasInstance](value: unknown): boolean;
+    readonly name = "AudioAPIError";
+    constructor(message: string, code: "invalid_input" | "unsupported_option" | "provider_error" | "invalid_response" | "network_error", status?: number | undefined, requestId?: string | undefined);
+}
+declare function generateSpeech({ model, ...options }: SpeechOptions & {
+    model: SpeechModel;
+}): Promise<GeneratedSpeech>;
+declare function transcribe({ model, ...options }: TranscriptionOptions & {
+    model: TranscriptionModel;
+}): Promise<TranscriptionResult>;
+
+export { AudioAPIError as A, type GeneratedSpeech as G, type SpeechModel as S, type TranscriptionModel as T, type SpeechOptions as a, type TranscriptionOptions as b, type TranscriptionResult as c, type SpeechFormat as d, type TranscriptSegment as e, type AudioResponseMetadata as f, generateSpeech as g, type AudioWarning as h, transcribe as t };

package/dist/{base-CkeT7u-O.d.mts → base-BICaQaRS.d.mts}

@@ -1,9 +1,10 @@
-import { M as Message, A as ActionDefinition, d as ToolDefinition, O as OpenAIReasoningEffort, R as ResponseFormat, W as WebSearchConfig, P as ProviderToolRuntimeOptions, g as StreamEvent, J as TokenUsage, Y as LLMConfig, a8 as MessageAttachment } from './types-BW3csYo5.mjs';
+import { M as Message, A as ActionDefinition, e as ToolDefinition, O as OpenAITransportOptions, h as OpenAIReasoningEffort, R as ResponseFormat, W as WebSearchConfig, l as ProviderToolRuntimeOptions, i as StreamEvent, P as ProviderMetadata, V as TokenUsage, $ as LLMConfig, c as ToolModelOutput, af as MessageAttachment } from './types-Dg1Bcg1k.mjs';
 
 /**
  * Request-level LLM configuration overrides
  */
 interface RequestLLMConfig {
+    openai?: OpenAITransportOptions;
     model?: string;
     reasoningEffort?: OpenAIReasoningEffort;
     temperature?: number;
@@ -46,6 +47,7 @@ interface ChatCompletionRequest {
  * Non-streaming completion result
  */
 interface CompletionResult {
+    providerMetadata?: ProviderMetadata;
     /** Text content */
     content: string;
     /** Tool calls */
@@ -208,7 +210,7 @@ type AnthropicToolUseBlock = {
 type AnthropicToolResultBlock = {
     type: "tool_result";
     tool_use_id: string;
-    content: string;
+    content: string | Array<Record<string, unknown>>;
 };
 type AnthropicMessageContent = string | Array<AnthropicContentBlock | AnthropicToolUseBlock | AnthropicToolResultBlock>;
 /**
@@ -237,6 +239,7 @@ type OpenAIMessage = {
     content: string | OpenAIContentBlock[];
 } | {
     role: "assistant";
+    providerMetadata?: ProviderMetadata;
     content: string | null;
     tool_calls?: Array<{
         id: string;
@@ -250,11 +253,12 @@ type OpenAIMessage = {
     role: "tool";
     content: string;
     tool_call_id: string;
+    modelOutput?: ToolModelOutput;
 };
 /**
  * Format messages for OpenAI with full tool support
  * Handles: text, images, tool_calls, and tool results
  */
-declare function formatMessagesForOpenAI(messages: Message[], systemPrompt?: string): OpenAIMessage[];
+declare function formatMessagesForOpenAI(messages: Message[], systemPrompt?: string, preserveProviderMetadata?: boolean): 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-BdTpUAWI.d.ts → base-CpRPB8u8.d.ts}

@@ -1,9 +1,10 @@
-import { M as Message, A as ActionDefinition, d as ToolDefinition, O as OpenAIReasoningEffort, R as ResponseFormat, W as WebSearchConfig, P as ProviderToolRuntimeOptions, g as StreamEvent, J as TokenUsage, Y as LLMConfig, a8 as MessageAttachment } from './types-BW3csYo5.js';
+import { M as Message, A as ActionDefinition, e as ToolDefinition, O as OpenAITransportOptions, h as OpenAIReasoningEffort, R as ResponseFormat, W as WebSearchConfig, l as ProviderToolRuntimeOptions, i as StreamEvent, P as ProviderMetadata, V as TokenUsage, $ as LLMConfig, c as ToolModelOutput, af as MessageAttachment } from './types-Dg1Bcg1k.js';
 
 /**
  * Request-level LLM configuration overrides
  */
 interface RequestLLMConfig {
+    openai?: OpenAITransportOptions;
     model?: string;
     reasoningEffort?: OpenAIReasoningEffort;
     temperature?: number;
@@ -46,6 +47,7 @@ interface ChatCompletionRequest {
  * Non-streaming completion result
  */
 interface CompletionResult {
+    providerMetadata?: ProviderMetadata;
     /** Text content */
     content: string;
     /** Tool calls */
@@ -208,7 +210,7 @@ type AnthropicToolUseBlock = {
 type AnthropicToolResultBlock = {
     type: "tool_result";
     tool_use_id: string;
-    content: string;
+    content: string | Array<Record<string, unknown>>;
 };
 type AnthropicMessageContent = string | Array<AnthropicContentBlock | AnthropicToolUseBlock | AnthropicToolResultBlock>;
 /**
@@ -237,6 +239,7 @@ type OpenAIMessage = {
     content: string | OpenAIContentBlock[];
 } | {
     role: "assistant";
+    providerMetadata?: ProviderMetadata;
     content: string | null;
     tool_calls?: Array<{
         id: string;
@@ -250,11 +253,12 @@ type OpenAIMessage = {
     role: "tool";
     content: string;
     tool_call_id: string;
+    modelOutput?: ToolModelOutput;
 };
 /**
  * Format messages for OpenAI with full tool support
  * Handles: text, images, tool_calls, and tool results
  */
-declare function formatMessagesForOpenAI(messages: Message[], systemPrompt?: string): OpenAIMessage[];
+declare function formatMessagesForOpenAI(messages: Message[], systemPrompt?: string, preserveProviderMetadata?: boolean): 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-CkeT7u-O.mjs';
-import { F as FallbackChainConfig, c as FallbackFailure, R as RoutingStore } from '../types-BWRYIvl_.mjs';
-export { d as FallbackInfo, b as RetryBackoff, e as RetryInfo, a as RoutingStrategy } from '../types-BWRYIvl_.mjs';
-import '../types-BW3csYo5.mjs';
+import { L as LLMAdapter } from '../base-BICaQaRS.mjs';
+import { F as FallbackChainConfig, c as FallbackFailure, R as RoutingStore } from '../types-C3RgRbEC.mjs';
+export { d as FallbackInfo, b as RetryBackoff, e as RetryInfo, a as RoutingStrategy } from '../types-C3RgRbEC.mjs';
+import '../types-Dg1Bcg1k.mjs';
 import 'zod';
 
 /**

package/dist/fallback/index.d.ts

@@ -1,7 +1,7 @@
-import { L as LLMAdapter } from '../base-BdTpUAWI.js';
-import { F as FallbackChainConfig, c as FallbackFailure, R as RoutingStore } from '../types-CpXcT-tY.js';
-export { d as FallbackInfo, b as RetryBackoff, e as RetryInfo, a as RoutingStrategy } from '../types-CpXcT-tY.js';
-import '../types-BW3csYo5.js';
+import { L as LLMAdapter } from '../base-CpRPB8u8.js';
+import { F as FallbackChainConfig, c as FallbackFailure, R as RoutingStore } from '../types-DCFqkJAy.js';
+export { d as FallbackInfo, b as RetryBackoff, e as RetryInfo, a as RoutingStrategy } from '../types-DCFqkJAy.js';
+import '../types-Dg1Bcg1k.js';
 import 'zod';
 
 /**

package/dist/index.d.mts

@@ -1,13 +1,14 @@
-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, O as OpenAIReasoningEffort, 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-BW3csYo5.mjs';
-export { a5 as AnthropicProviderToolOptions, a2 as AnthropicToolSelectionHints, p as AssistantMessage, a6 as Citation, C as CoreMessage, X 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, Y as LLMConfig, L as LanguageModel, l as ModelCapabilities, a4 as OpenAIProviderToolOptions, a1 as OpenAIToolSelectionHints, Q as ResponseOptions, V 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, a0 as ToolExecution, Z as ToolLocation, q as ToolMessage, a3 as ToolNativeProviderHints, u as ToolResult, B as ToolResultChunk, _ as UnifiedToolCall, $ as UnifiedToolResult, r as UserContentPart, U as UserMessage } from './types-BW3csYo5.mjs';
+import { G as GenerateTextParams, a as GenerateTextResult, S as StreamTextParams, b as StreamTextResult, T as ToolContext, c as ToolModelOutput, d as Tool, A as ActionDefinition, e as ToolDefinition, f as ToolProfile, K as KnowledgeBaseConfig, W as WebSearchConfig, g as StorageAdapter, P as ProviderMetadata, O as OpenAITransportOptions, h as OpenAIReasoningEffort, R as ResponseFormat, D as DoneEventMessage, i as StreamEvent, j as ToolCallInfo, k as TokenUsageRaw, l as ProviderToolRuntimeOptions, M as Message, m as ToolResponse, n as StorageMessage } from './types-Dg1Bcg1k.mjs';
+export { a8 as AnthropicProviderToolOptions, a5 as AnthropicToolSelectionHints, s as AssistantMessage, a9 as Citation, C as CoreMessage, _ as DEFAULT_CAPABILITIES, p as DoGenerateParams, q as DoGenerateResult, Q as ErrorChunk, F as FilePart, N as FinishChunk, X as FinishReason, y as GenerateStep, I as ImagePart, $ as LLMConfig, L as LanguageModel, o as ModelCapabilities, a7 as OpenAIProviderToolOptions, ab as OpenAIResponseItem, ac as OpenAIResponseMetadata, aa as OpenAIResponsesOptions, a4 as OpenAIToolSelectionHints, Y as ResponseOptions, Z as StorageFile, B as StreamChunk, z as StreamPart, r as SystemMessage, E as TextDeltaChunk, v as TextPart, V as TokenUsage, w as ToolCall, H as ToolCallChunk, a3 as ToolExecution, a0 as ToolLocation, t as ToolMessage, a6 as ToolNativeProviderHints, ad as ToolOutputPart, x as ToolResult, J as ToolResultChunk, a1 as UnifiedToolCall, a2 as UnifiedToolResult, u as UserContentPart, U as UserMessage } from './types-Dg1Bcg1k.mjs';
 import { z } from 'zod';
-import { A as AIProvider } from './types-NOswlhm9.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-NOswlhm9.mjs';
-import { L as LLMAdapter } from './base-CkeT7u-O.mjs';
-export { A as AdapterFactory, C as ChatCompletionRequest } from './base-CkeT7u-O.mjs';
+import { A as AIProvider } from './types-DHQEMFHA.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-DHQEMFHA.mjs';
+import { L as LLMAdapter } from './base-BICaQaRS.mjs';
+export { A as AdapterFactory, C as ChatCompletionRequest } from './base-BICaQaRS.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-BWRYIvl_.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-C3RgRbEC.mjs';
+export { A as AudioAPIError, f as AudioResponseMetadata, h as AudioWarning, G as GeneratedSpeech, d as SpeechFormat, S as SpeechModel, a as SpeechOptions, e as TranscriptSegment, T as TranscriptionModel, b as TranscriptionOptions, c as TranscriptionResult, g as generateSpeech, t as transcribe } from './audio-BBSwnjo8.mjs';
 
 /**
  * generateText - Generate text using a language model
@@ -77,30 +78,6 @@ declare function generateText(params: GenerateTextParams): Promise<GenerateTextR
  */
 declare function streamText(params: StreamTextParams): Promise<StreamTextResult>;
 
-/**
- * Tool Helper
- *
- * Create type-safe tools with Zod schema validation.
- *
- * @example
- * ```ts
- * import { tool } from '@yourgpt/llm-sdk';
- * import { z } from 'zod';
- *
- * const weatherTool = tool({
- *   description: 'Get current weather for a city',
- *   parameters: z.object({
- *     city: z.string().describe('City name'),
- *     unit: z.enum(['celsius', 'fahrenheit']).optional(),
- *   }),
- *   execute: async ({ city, unit }) => {
- *     const data = await fetchWeather(city);
- *     return { temperature: data.temp, condition: data.condition };
- *   },
- * });
- * ```
- */
-
 /**
  * Configuration for creating a tool
  */
@@ -111,6 +88,8 @@ interface ToolConfig<TParams extends z.ZodType, TResult = unknown> {
     parameters: TParams;
     /** Function to execute when the tool is called */
     execute: (params: z.infer<TParams>, context: ToolContext) => Promise<TResult>;
+    /** Map the raw result to explicit text/image content for the model. */
+    toModelOutput?: (result: TResult) => ToolModelOutput | undefined;
     /**
      * Hide this tool's execution from the chat UI.
      * When true, tool calls and results won't be displayed to the user,
@@ -149,7 +128,7 @@ declare function tool<TParams extends z.ZodType, TResult = unknown>(config: Tool
 /**
  * Format tools for OpenAI API format
  */
-declare function formatToolsForOpenAI(tools: Record<string, Tool>): Array<{
+declare function formatToolsForOpenAI(tools: Record<string, Tool<any, any>>): Array<{
     type: "function";
     function: {
         name: string;
@@ -160,7 +139,7 @@ declare function formatToolsForOpenAI(tools: Record<string, Tool>): Array<{
 /**
  * Format tools for Anthropic API format
  */
-declare function formatToolsForAnthropic(tools: Record<string, Tool>): Array<{
+declare function formatToolsForAnthropic(tools: Record<string, Tool<any, any>>): Array<{
     name: string;
     description: string;
     input_schema: object;
@@ -168,7 +147,7 @@ declare function formatToolsForAnthropic(tools: Record<string, Tool>): Array<{
 /**
  * Format tools for Google Gemini API format
  */
-declare function formatToolsForGoogle(tools: Record<string, Tool>): Array<{
+declare function formatToolsForGoogle(tools: Record<string, Tool<any, any>>): Array<{
     functionDeclarations: Array<{
         name: string;
         description: string;
@@ -364,6 +343,8 @@ interface MessageAttachment {
 interface ChatRequest {
     /** Conversation messages */
     messages: Array<{
+        modelOutput?: ToolModelOutput;
+        providerMetadata?: ProviderMetadata;
         role: string;
         content: string;
         /** Attachments like images (for vision support) */
@@ -386,6 +367,7 @@ interface ChatRequest {
     botId?: string;
     /** LLM config overrides */
     config?: {
+        openai?: OpenAITransportOptions;
         reasoningEffort?: OpenAIReasoningEffort;
         temperature?: number;
         maxTokens?: number;
@@ -1184,7 +1166,9 @@ declare function formatSSEData(event: StreamEvent): string;
 /**
  * Create a ReadableStream from an async generator of events
  */
-declare function createEventStream(generator: AsyncGenerator<StreamEvent>): ReadableStream<Uint8Array>;
+declare function createEventStream(generator: AsyncGenerator<StreamEvent>, options?: {
+    includeUsage?: boolean;
+}): ReadableStream<Uint8Array>;
 /**
  * Create SSE Response object
  */
@@ -1538,4 +1522,4 @@ declare function generateThreadId(): string;
  */
 declare function generateToolCallId(): string;
 
-export { AIProvider, ActionDefinition, type ActionRequest, type AgentLoopOptions, type ChatRequest, type CollectedResult, type CopilotChatResponse, DEFAULT_MAX_ITERATIONS, DoneEventMessage, GenerateResult, type GenerateResultData, GenerateTextParams, GenerateTextResult, LLMAdapter, Message, ProviderToolRuntimeOptions, type RequestContext, Runtime, type RuntimeConfig, StorageAdapter, StorageMessage, StreamEvent, StreamResult, type StreamResultOptions, StreamTextParams, StreamTextResult, TokenUsageRaw, Tool, ToolCallInfo, ToolContext, ToolDefinition, ToolProfile, ToolResponse, type ToolSearchMatch, WebSearchConfig, buildProviderToolOptions, createEventStream, createExpressHandler, createExpressMiddleware, createHonoApp, createNextHandler, createNodeHandler, createRuntime, createSSEHeaders, createSSEResponse, createStreamResult, createTextStreamHeaders, createTextStreamResponse, extractInputMessages, formatSSEData, formatToolsForAnthropic, formatToolsForGoogle, formatToolsForOpenAI, generateMessageId, generateText, generateThreadId, generateToolCallId, mapOutputMessages, pipeSSEToResponse, pipeTextToResponse, runAgentLoop, searchTools, selectTools, shouldExposeToolSearch, streamText, tool };
+export { AIProvider, ActionDefinition, type ActionRequest, type AgentLoopOptions, type ChatRequest, type CollectedResult, type CopilotChatResponse, DEFAULT_MAX_ITERATIONS, DoneEventMessage, GenerateResult, type GenerateResultData, GenerateTextParams, GenerateTextResult, LLMAdapter, Message, OpenAITransportOptions, ProviderMetadata, ProviderToolRuntimeOptions, type RequestContext, Runtime, type RuntimeConfig, StorageAdapter, StorageMessage, StreamEvent, StreamResult, type StreamResultOptions, StreamTextParams, StreamTextResult, TokenUsageRaw, Tool, ToolCallInfo, ToolContext, ToolDefinition, ToolModelOutput, ToolProfile, ToolResponse, type ToolSearchMatch, WebSearchConfig, buildProviderToolOptions, createEventStream, createExpressHandler, createExpressMiddleware, createHonoApp, createNextHandler, createNodeHandler, createRuntime, createSSEHeaders, createSSEResponse, createStreamResult, createTextStreamHeaders, createTextStreamResponse, extractInputMessages, formatSSEData, formatToolsForAnthropic, formatToolsForGoogle, formatToolsForOpenAI, generateMessageId, generateText, generateThreadId, generateToolCallId, mapOutputMessages, pipeSSEToResponse, pipeTextToResponse, runAgentLoop, searchTools, selectTools, shouldExposeToolSearch, streamText, tool };

package/dist/index.d.ts

@@ -1,13 +1,14 @@
-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, O as OpenAIReasoningEffort, 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-BW3csYo5.js';
-export { a5 as AnthropicProviderToolOptions, a2 as AnthropicToolSelectionHints, p as AssistantMessage, a6 as Citation, C as CoreMessage, X 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, Y as LLMConfig, L as LanguageModel, l as ModelCapabilities, a4 as OpenAIProviderToolOptions, a1 as OpenAIToolSelectionHints, Q as ResponseOptions, V 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, a0 as ToolExecution, Z as ToolLocation, q as ToolMessage, a3 as ToolNativeProviderHints, u as ToolResult, B as ToolResultChunk, _ as UnifiedToolCall, $ as UnifiedToolResult, r as UserContentPart, U as UserMessage } from './types-BW3csYo5.js';
+import { G as GenerateTextParams, a as GenerateTextResult, S as StreamTextParams, b as StreamTextResult, T as ToolContext, c as ToolModelOutput, d as Tool, A as ActionDefinition, e as ToolDefinition, f as ToolProfile, K as KnowledgeBaseConfig, W as WebSearchConfig, g as StorageAdapter, P as ProviderMetadata, O as OpenAITransportOptions, h as OpenAIReasoningEffort, R as ResponseFormat, D as DoneEventMessage, i as StreamEvent, j as ToolCallInfo, k as TokenUsageRaw, l as ProviderToolRuntimeOptions, M as Message, m as ToolResponse, n as StorageMessage } from './types-Dg1Bcg1k.js';
+export { a8 as AnthropicProviderToolOptions, a5 as AnthropicToolSelectionHints, s as AssistantMessage, a9 as Citation, C as CoreMessage, _ as DEFAULT_CAPABILITIES, p as DoGenerateParams, q as DoGenerateResult, Q as ErrorChunk, F as FilePart, N as FinishChunk, X as FinishReason, y as GenerateStep, I as ImagePart, $ as LLMConfig, L as LanguageModel, o as ModelCapabilities, a7 as OpenAIProviderToolOptions, ab as OpenAIResponseItem, ac as OpenAIResponseMetadata, aa as OpenAIResponsesOptions, a4 as OpenAIToolSelectionHints, Y as ResponseOptions, Z as StorageFile, B as StreamChunk, z as StreamPart, r as SystemMessage, E as TextDeltaChunk, v as TextPart, V as TokenUsage, w as ToolCall, H as ToolCallChunk, a3 as ToolExecution, a0 as ToolLocation, t as ToolMessage, a6 as ToolNativeProviderHints, ad as ToolOutputPart, x as ToolResult, J as ToolResultChunk, a1 as UnifiedToolCall, a2 as UnifiedToolResult, u as UserContentPart, U as UserMessage } from './types-Dg1Bcg1k.js';
 import { z } from 'zod';
-import { A as AIProvider } from './types-DA54bSmX.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-DA54bSmX.js';
-import { L as LLMAdapter } from './base-BdTpUAWI.js';
-export { A as AdapterFactory, C as ChatCompletionRequest } from './base-BdTpUAWI.js';
+import { A as AIProvider } from './types-Dikj3En4.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-Dikj3En4.js';
+import { L as LLMAdapter } from './base-CpRPB8u8.js';
+export { A as AdapterFactory, C as ChatCompletionRequest } from './base-CpRPB8u8.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-CpXcT-tY.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-DCFqkJAy.js';
+export { A as AudioAPIError, f as AudioResponseMetadata, h as AudioWarning, G as GeneratedSpeech, d as SpeechFormat, S as SpeechModel, a as SpeechOptions, e as TranscriptSegment, T as TranscriptionModel, b as TranscriptionOptions, c as TranscriptionResult, g as generateSpeech, t as transcribe } from './audio-BBSwnjo8.js';
 
 /**
  * generateText - Generate text using a language model
@@ -77,30 +78,6 @@ declare function generateText(params: GenerateTextParams): Promise<GenerateTextR
  */
 declare function streamText(params: StreamTextParams): Promise<StreamTextResult>;
 
-/**
- * Tool Helper
- *
- * Create type-safe tools with Zod schema validation.
- *
- * @example
- * ```ts
- * import { tool } from '@yourgpt/llm-sdk';
- * import { z } from 'zod';
- *
- * const weatherTool = tool({
- *   description: 'Get current weather for a city',
- *   parameters: z.object({
- *     city: z.string().describe('City name'),
- *     unit: z.enum(['celsius', 'fahrenheit']).optional(),
- *   }),
- *   execute: async ({ city, unit }) => {
- *     const data = await fetchWeather(city);
- *     return { temperature: data.temp, condition: data.condition };
- *   },
- * });
- * ```
- */
-
 /**
  * Configuration for creating a tool
  */
@@ -111,6 +88,8 @@ interface ToolConfig<TParams extends z.ZodType, TResult = unknown> {
     parameters: TParams;
     /** Function to execute when the tool is called */
     execute: (params: z.infer<TParams>, context: ToolContext) => Promise<TResult>;
+    /** Map the raw result to explicit text/image content for the model. */
+    toModelOutput?: (result: TResult) => ToolModelOutput | undefined;
     /**
      * Hide this tool's execution from the chat UI.
      * When true, tool calls and results won't be displayed to the user,
@@ -149,7 +128,7 @@ declare function tool<TParams extends z.ZodType, TResult = unknown>(config: Tool
 /**
  * Format tools for OpenAI API format
  */
-declare function formatToolsForOpenAI(tools: Record<string, Tool>): Array<{
+declare function formatToolsForOpenAI(tools: Record<string, Tool<any, any>>): Array<{
     type: "function";
     function: {
         name: string;
@@ -160,7 +139,7 @@ declare function formatToolsForOpenAI(tools: Record<string, Tool>): Array<{
 /**
  * Format tools for Anthropic API format
  */
-declare function formatToolsForAnthropic(tools: Record<string, Tool>): Array<{
+declare function formatToolsForAnthropic(tools: Record<string, Tool<any, any>>): Array<{
     name: string;
     description: string;
     input_schema: object;
@@ -168,7 +147,7 @@ declare function formatToolsForAnthropic(tools: Record<string, Tool>): Array<{
 /**
  * Format tools for Google Gemini API format
  */
-declare function formatToolsForGoogle(tools: Record<string, Tool>): Array<{
+declare function formatToolsForGoogle(tools: Record<string, Tool<any, any>>): Array<{
     functionDeclarations: Array<{
         name: string;
         description: string;
@@ -364,6 +343,8 @@ interface MessageAttachment {
 interface ChatRequest {
     /** Conversation messages */
     messages: Array<{
+        modelOutput?: ToolModelOutput;
+        providerMetadata?: ProviderMetadata;
         role: string;
         content: string;
         /** Attachments like images (for vision support) */
@@ -386,6 +367,7 @@ interface ChatRequest {
     botId?: string;
     /** LLM config overrides */
     config?: {
+        openai?: OpenAITransportOptions;
         reasoningEffort?: OpenAIReasoningEffort;
         temperature?: number;
         maxTokens?: number;
@@ -1184,7 +1166,9 @@ declare function formatSSEData(event: StreamEvent): string;
 /**
  * Create a ReadableStream from an async generator of events
  */
-declare function createEventStream(generator: AsyncGenerator<StreamEvent>): ReadableStream<Uint8Array>;
+declare function createEventStream(generator: AsyncGenerator<StreamEvent>, options?: {
+    includeUsage?: boolean;
+}): ReadableStream<Uint8Array>;
 /**
  * Create SSE Response object
  */
@@ -1538,4 +1522,4 @@ declare function generateThreadId(): string;
  */
 declare function generateToolCallId(): string;
 
-export { AIProvider, ActionDefinition, type ActionRequest, type AgentLoopOptions, type ChatRequest, type CollectedResult, type CopilotChatResponse, DEFAULT_MAX_ITERATIONS, DoneEventMessage, GenerateResult, type GenerateResultData, GenerateTextParams, GenerateTextResult, LLMAdapter, Message, ProviderToolRuntimeOptions, type RequestContext, Runtime, type RuntimeConfig, StorageAdapter, StorageMessage, StreamEvent, StreamResult, type StreamResultOptions, StreamTextParams, StreamTextResult, TokenUsageRaw, Tool, ToolCallInfo, ToolContext, ToolDefinition, ToolProfile, ToolResponse, type ToolSearchMatch, WebSearchConfig, buildProviderToolOptions, createEventStream, createExpressHandler, createExpressMiddleware, createHonoApp, createNextHandler, createNodeHandler, createRuntime, createSSEHeaders, createSSEResponse, createStreamResult, createTextStreamHeaders, createTextStreamResponse, extractInputMessages, formatSSEData, formatToolsForAnthropic, formatToolsForGoogle, formatToolsForOpenAI, generateMessageId, generateText, generateThreadId, generateToolCallId, mapOutputMessages, pipeSSEToResponse, pipeTextToResponse, runAgentLoop, searchTools, selectTools, shouldExposeToolSearch, streamText, tool };
+export { AIProvider, ActionDefinition, type ActionRequest, type AgentLoopOptions, type ChatRequest, type CollectedResult, type CopilotChatResponse, DEFAULT_MAX_ITERATIONS, DoneEventMessage, GenerateResult, type GenerateResultData, GenerateTextParams, GenerateTextResult, LLMAdapter, Message, OpenAITransportOptions, ProviderMetadata, ProviderToolRuntimeOptions, type RequestContext, Runtime, type RuntimeConfig, StorageAdapter, StorageMessage, StreamEvent, StreamResult, type StreamResultOptions, StreamTextParams, StreamTextResult, TokenUsageRaw, Tool, ToolCallInfo, ToolContext, ToolDefinition, ToolModelOutput, ToolProfile, ToolResponse, type ToolSearchMatch, WebSearchConfig, buildProviderToolOptions, createEventStream, createExpressHandler, createExpressMiddleware, createHonoApp, createNextHandler, createNodeHandler, createRuntime, createSSEHeaders, createSSEResponse, createStreamResult, createTextStreamHeaders, createTextStreamResponse, extractInputMessages, formatSSEData, formatToolsForAnthropic, formatToolsForGoogle, formatToolsForOpenAI, generateMessageId, generateText, generateThreadId, generateToolCallId, mapOutputMessages, pipeSSEToResponse, pipeTextToResponse, runAgentLoop, searchTools, selectTools, shouldExposeToolSearch, streamText, tool };