@yourgpt/llm-sdk 2.6.0-beta.0 → 2.6.0-beta.2

package/dist/fallback/index.mjs

@@ -1,3 +1,26 @@
+// src/core/provider-error.ts
+function errorFromEvent(event) {
+  if (event.cause instanceof Error) return event.cause;
+  return Object.assign(new Error(event.message), {
+    status: event.status,
+    code: event.providerCode ?? event.code,
+    param: event.param,
+    request_id: event.requestId
+  });
+}
+function throwIfAborted(signal) {
+  if (!signal?.aborted) return;
+  const error = new Error("The operation was aborted");
+  error.name = "AbortError";
+  throw error;
+}
+function isAbortError(error) {
+  if (!(error instanceof Error)) return false;
+  return error.name === "AbortError" || error.constructor.name === "APIUserAbortError" || /^(aborted|the operation was aborted|the user aborted a request)/i.test(
+    error.message
+  );
+}
+
 // src/fallback/errors.ts
 var FallbackExhaustedError = class extends Error {
   constructor(failures) {
@@ -72,8 +95,24 @@ function calcDelay(base, attempt, backoff) {
   if (backoff === "fixed") return base;
   return base * Math.pow(2, attempt - 1);
 }
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+function sleep(ms, signal) {
+  throwIfAborted(signal);
+  return new Promise((resolve, reject) => {
+    const onAbort = () => {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", onAbort);
+      try {
+        throwIfAborted(signal);
+      } catch (error) {
+        reject(error);
+      }
+    };
+    const timer = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
 }
 var FallbackChain = class {
   constructor(config) {
@@ -89,7 +128,8 @@ var FallbackChain = class {
       retryBackoff: config.retryBackoff ?? "exponential",
       onFallback: config.onFallback,
       onRetry: config.onRetry,
-      retryableErrors: config.retryableErrors
+      retryableErrors: config.retryableErrors,
+      fallbackErrors: config.fallbackErrors
     };
   }
   get provider() {
@@ -109,8 +149,12 @@ var FallbackChain = class {
     await this._config.store.set(ROUND_ROBIN_KEY, next);
   }
   _isRetryable(error) {
+    if (isAbortError(error)) return false;
     return this._config.retryableErrors ? this._config.retryableErrors(error) : defaultIsRetryable(error);
   }
+  _canFallback(error) {
+    return !isAbortError(error) && (this._isRetryable(error) || this._config.fallbackErrors?.(error) === true);
+  }
   /**
    * Try streaming from a single adapter, with per-model retries.
    *
@@ -123,65 +167,52 @@ var FallbackChain = class {
    */
   async *_streamWithRetries(adapter, request, out) {
     const { retries, retryDelay, retryBackoff, onRetry } = this._config;
-    const maxAttempts = retries + 1;
-    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-      let contentStarted = false;
-      let failureError = null;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+      throwIfAborted(request.signal);
+      out.retriesAttempted = attempt;
       try {
         for await (const chunk of adapter.stream(request)) {
-          if (chunk.type === "error") {
-            if (!contentStarted) {
-              const msg = chunk.message ?? "Unknown error";
-              failureError = new Error(msg);
-              break;
-            }
-            yield chunk;
-            return;
-          }
+          throwIfAborted(request.signal);
+          if (chunk.type === "error") throw errorFromEvent(chunk);
           if (chunk.type === "message:start") continue;
-          contentStarted = true;
+          out.contentStarted = true;
           yield chunk;
         }
+        throwIfAborted(request.signal);
+        return;
       } catch (error) {
-        if (contentStarted) throw error;
-        if (!this._isRetryable(error)) throw error;
-        failureError = error instanceof Error ? error : new Error(String(error));
-      }
-      if (failureError === null) return;
-      if (!this._isRetryable(failureError)) throw failureError;
-      out.retriesAttempted = attempt - 1;
-      if (attempt < maxAttempts) {
-        const delayMs = calcDelay(retryDelay, attempt, retryBackoff);
-        const retryInfo = {
+        throwIfAborted(request.signal);
+        if (out.contentStarted || !this._isRetryable(error) || attempt === retries)
+          throw error;
+        const delayMs = calcDelay(retryDelay, attempt + 1, retryBackoff);
+        onRetry?.({
           model: adapter.model,
           provider: adapter.provider,
-          error: failureError,
-          retryAttempt: attempt,
+          error: error instanceof Error ? error : new Error(String(error)),
+          retryAttempt: attempt + 1,
           maxRetries: retries,
           delayMs
-        };
-        onRetry?.(retryInfo);
-        await sleep(delayMs);
-        continue;
+        });
+        await sleep(delayMs, request.signal);
       }
-      out.retriesAttempted = retries;
-      throw failureError;
     }
   }
   async *stream(request) {
     const { models, onFallback } = this._config;
+    throwIfAborted(request.signal);
     const startIndex = await this._startIndex();
     const failures = [];
     for (let i = 0; i < models.length; i++) {
       const index = (startIndex + i) % models.length;
       const adapter = models[index];
-      const out = { retriesAttempted: 0 };
+      const out = { retriesAttempted: 0, contentStarted: false };
       try {
         yield* this._streamWithRetries(adapter, request, out);
         await this._advanceIndex(index);
         return;
       } catch (error) {
-        if (!this._isRetryable(error)) throw error;
+        throwIfAborted(request.signal);
+        if (out.contentStarted || !this._canFallback(error)) throw error;
         const failure = {
           model: adapter.model,
           provider: adapter.provider,
@@ -206,6 +237,7 @@ var FallbackChain = class {
   }
   async complete(request) {
     const { models, onFallback, retries, retryDelay, retryBackoff, onRetry } = this._config;
+    throwIfAborted(request.signal);
     const startIndex = await this._startIndex();
     const failures = [];
     for (let i = 0; i < models.length; i++) {
@@ -227,14 +259,18 @@ var FallbackChain = class {
       let lastError = null;
       let retriesAttempted = 0;
       for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        throwIfAborted(request.signal);
         try {
           const result = await adapter.complete(request);
+          throwIfAborted(request.signal);
           await this._advanceIndex(index);
           return result;
         } catch (error) {
-          if (!this._isRetryable(error)) throw error;
+          throwIfAborted(request.signal);
+          if (!this._canFallback(error)) throw error;
           lastError = error instanceof Error ? error : new Error(String(error));
           retriesAttempted = attempt - 1;
+          if (!this._isRetryable(error)) break;
           if (attempt < maxAttempts) {
             const delayMs = calcDelay(retryDelay, attempt, retryBackoff);
             onRetry?.({
@@ -245,7 +281,7 @@ var FallbackChain = class {
               maxRetries: retries,
               delayMs
             });
-            await sleep(delayMs);
+            await sleep(delayMs, request.signal);
           }
         }
       }

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, 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 { 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-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 { 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-B6dhnguR.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,8 @@ interface ChatRequest {
     botId?: string;
     /** LLM config overrides */
     config?: {
+        openai?: OpenAITransportOptions;
+        reasoningEffort?: OpenAIReasoningEffort;
         temperature?: number;
         maxTokens?: number;
         responseFormat?: ResponseFormat;
@@ -1537,4 +1520,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, 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 { 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-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 { 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-CCxPmkmK.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,8 @@ interface ChatRequest {
     botId?: string;
     /** LLM config overrides */
     config?: {
+        openai?: OpenAITransportOptions;
+        reasoningEffort?: OpenAIReasoningEffort;
         temperature?: number;
         maxTokens?: number;
         responseFormat?: ResponseFormat;
@@ -1537,4 +1520,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 };