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

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

@@ -1,4 +1,4 @@
-import { L as LLMAdapter } from './base-tNgbBaSo.mjs';
+import { L as LLMAdapter } from './base-BICaQaRS.mjs';
 
 /**
  * Fallback Chain & Routing Strategy Types
@@ -188,7 +188,14 @@ interface FallbackChainConfig {
      */
     onFallback?: (info: FallbackInfo) => void;
     /**
-     * Custom predicate to decide whether an error should trigger a fallback.
+     * Additional errors that may advance to the next model without retrying the
+     * current model. Use a narrow compatibility predicate (status/code/param).
+     * Transient retries/fallbacks retain their existing behavior. Cancellation
+     * and failures after stream output never retry or fall back.
+     */
+    fallbackErrors?: (error: unknown) => boolean;
+    /**
+     * Custom predicate controlling same-model retries and subsequent fallback.
      *
      * By default, the following trigger fallback:
      * - HTTP 5xx server errors
@@ -202,8 +209,8 @@ interface FallbackChainConfig {
      *
      * @example
      * ```typescript
-     * // Also fall back on any error
-     * retryableErrors: () => true,
+     * // Retry only the transient failures your provider identifies.
+     * retryableErrors: (error) => isTransientProviderError(error),
      * ```
      */
     retryableErrors?: (error: unknown) => boolean;

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

@@ -1,4 +1,4 @@
-import { L as LLMAdapter } from './base-C58Dsr9p.js';
+import { L as LLMAdapter } from './base-CpRPB8u8.js';
 
 /**
  * Fallback Chain & Routing Strategy Types
@@ -188,7 +188,14 @@ interface FallbackChainConfig {
      */
     onFallback?: (info: FallbackInfo) => void;
     /**
-     * Custom predicate to decide whether an error should trigger a fallback.
+     * Additional errors that may advance to the next model without retrying the
+     * current model. Use a narrow compatibility predicate (status/code/param).
+     * Transient retries/fallbacks retain their existing behavior. Cancellation
+     * and failures after stream output never retry or fall back.
+     */
+    fallbackErrors?: (error: unknown) => boolean;
+    /**
+     * Custom predicate controlling same-model retries and subsequent fallback.
      *
      * By default, the following trigger fallback:
      * - HTTP 5xx server errors
@@ -202,8 +209,8 @@ interface FallbackChainConfig {
      *
      * @example
      * ```typescript
-     * // Also fall back on any error
-     * retryableErrors: () => true,
+     * // Retry only the transient failures your provider identifies.
+     * retryableErrors: (error) => isTransientProviderError(error),
      * ```
      */
     retryableErrors?: (error: unknown) => boolean;

package/dist/{types-BQ31QIsA.d.ts → types-DHQEMFHA.d.mts}

@@ -1,13 +1,5 @@
-import { d as ToolDefinition, Z as UnifiedToolCall, _ as UnifiedToolResult } from './types-BkQCSiIt.js';
-import { L as LLMAdapter } from './base-C58Dsr9p.js';
-
-/**
- * Provider Types
- *
- * Defines interfaces for:
- * 1. Provider Formatters (for tool transformations in agent loop)
- * 2. Multi-provider architecture (AIProvider, capabilities, configs)
- */
+import { ae as OpenAIParameterOptions, O as OpenAITransportOptions, e as ToolDefinition, a1 as UnifiedToolCall, a2 as UnifiedToolResult } from './types-Dg1Bcg1k.mjs';
+import { L as LLMAdapter } from './base-BICaQaRS.mjs';
 
 /**
  * Provider formatter interface
@@ -259,7 +251,7 @@ interface BaseProviderConfig {
 /**
  * OpenAI provider configuration
  */
-interface OpenAIProviderConfig extends BaseProviderConfig {
+interface OpenAIProviderConfig extends BaseProviderConfig, OpenAIParameterOptions, OpenAITransportOptions {
     /** OpenAI organization ID */
     organization?: string;
     /** OpenAI project ID */

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

@@ -1,5 +1,78 @@
 import { z } from 'zod';
 
+/** OpenAI reasoning controls. Omit to retain the model's default effort. */
+type OpenAIReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
+interface OpenAIParameterOptions {
+    reasoningEffort?: OpenAIReasoningEffort;
+    /** Use passthrough for compatible servers with different model rules. */
+    parameterPolicy?: "openai" | "passthrough";
+    /** Receives omitted-option warnings; defaults to console.warn. */
+    onWarning?: (message: string) => void;
+}
+
+/** Responses-only options. Omitted values retain the API's defaults. */
+interface OpenAIResponsesOptions {
+    store?: boolean;
+    /** Send only new input after this stored response; do not also resend its history. */
+    previousResponseId?: string;
+    include?: string[];
+    reasoningSummary?: "auto" | "concise" | "detailed";
+    promptCacheKey?: string;
+    /** Legacy retention option for models that support it. */
+    promptCacheRetention?: "in_memory" | "24h";
+    /** GPT-5.6+ cache mode and minimum lifetime; provider/model support varies. */
+    promptCacheOptions?: {
+        mode?: "implicit" | "explicit";
+        ttl?: "30m";
+    };
+}
+interface OpenAITransportOptions {
+    /** auto preserves existing routing; responses also works without function tools. */
+    api?: "auto" | "chat" | "responses";
+    responses?: OpenAIResponsesOptions;
+}
+/** Opaque provider items: retain their complete contents and order for replay. */
+interface OpenAIResponseItem {
+    type: string;
+    [key: string]: unknown;
+}
+interface OpenAIResponseMetadata {
+    id?: string;
+    model?: string;
+    status?: string;
+    output: OpenAIResponseItem[];
+    usage?: Record<string, unknown>;
+    store?: boolean;
+    refusals: string[];
+}
+interface ProviderMetadata {
+    openai?: {
+        response?: OpenAIResponseMetadata;
+    };
+    [provider: string]: unknown;
+}
+
+/** Explicit model-facing output; the application's raw tool result stays separate. */
+type ToolOutputPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string | Uint8Array;
+    mediaType: string;
+} | {
+    type: "image";
+    url: string;
+} | {
+    type: "image";
+    fileId: string;
+    provider: "openai";
+};
+interface ToolModelOutput {
+    type: "content";
+    content: ToolOutputPart[];
+}
+
 /**
  * Stream event types for llm-sdk
  * These types are used internally by the SDK for streaming responses
@@ -32,6 +105,7 @@ interface MessageDeltaEvent extends BaseEvent {
  * Message finished streaming
  */
 interface MessageEndEvent extends BaseEvent {
+    providerMetadata?: ProviderMetadata;
     type: "message:end";
 }
 /**
@@ -77,6 +151,7 @@ interface ActionArgsEvent extends BaseEvent {
  * Action execution completed
  */
 interface ActionEndEvent extends BaseEvent {
+    modelOutput?: ToolModelOutput;
     type: "action:end";
     id: string;
     name?: string;
@@ -90,6 +165,12 @@ interface ErrorEvent extends BaseEvent {
     type: "error";
     message: string;
     code?: string;
+    status?: number;
+    providerCode?: string;
+    param?: string;
+    requestId?: string;
+    /** In-process cause, omitted from serialized error events. */
+    cause?: unknown;
 }
 /**
  * Tool call information
@@ -107,6 +188,7 @@ interface ToolCallInfo {
  * Assistant message with tool calls
  */
 interface AssistantToolMessage {
+    providerMetadata?: ProviderMetadata;
     role: "assistant";
     content: string | null;
     tool_calls: Array<{
@@ -182,6 +264,8 @@ interface CitationEvent extends BaseEvent {
  * Message format for done event (API format with snake_case)
  */
 interface DoneEventMessage {
+    modelOutput?: ToolModelOutput;
+    providerMetadata?: ProviderMetadata;
     role: "assistant" | "tool";
     content: string | null;
     tool_calls?: Array<{
@@ -216,6 +300,7 @@ interface ThreadCreatedEvent extends BaseEvent {
  * Stream completed
  */
 interface DoneEvent extends BaseEvent {
+    providerMetadata?: ProviderMetadata;
     type: "done";
     requiresAction?: boolean;
     messages?: DoneEventMessage[];
@@ -249,6 +334,7 @@ type ResponseFormat = {
  * LLM configuration
  */
 interface LLMConfig {
+    reasoningEffort?: OpenAIReasoningEffort;
     temperature?: number;
     maxTokens?: number;
     responseFormat?: ResponseFormat;
@@ -293,6 +379,8 @@ interface MessageMetadata {
  * Message type (simplified for llm-sdk)
  */
 interface Message {
+    modelOutput?: ToolModelOutput;
+    providerMetadata?: ProviderMetadata;
     id: string;
     thread_id?: string;
     role: MessageRole;
@@ -363,7 +451,10 @@ interface AIContent {
     type?: "text" | "image";
     text?: string;
     mediaType?: string;
-    data?: string;
+    data?: string | Uint8Array;
+    url?: string;
+    fileId?: string;
+    provider?: "openai";
     summary?: string;
     details?: string;
 }
@@ -379,6 +470,7 @@ interface ToolInputSchema {
  * Tool definition
  */
 interface ToolDefinition<TParams = Record<string, unknown>> {
+    toModelOutput?: (result: unknown) => ToolModelOutput | undefined;
     name: string;
     description: string;
     location: ToolLocation;
@@ -608,11 +700,14 @@ interface UserMessage {
     content: string | UserContentPart[];
 }
 interface AssistantMessage {
+    /** Provider state retained for continuation and inspection. */
+    providerMetadata?: ProviderMetadata;
     role: "assistant";
     content: string | null;
     toolCalls?: ToolCall[];
 }
 interface ToolMessage {
+    modelOutput?: ToolModelOutput;
     role: "tool";
     toolCallId: string;
     content: string;
@@ -633,6 +728,7 @@ interface ImagePart {
     mimeType?: string;
 }
 interface FilePart {
+    filename?: string;
     type: "file";
     /** Base64 data or URL */
     data: string;
@@ -649,6 +745,8 @@ interface Tool<TParams = unknown, TResult = unknown> {
     parameters: z.ZodType<TParams>;
     /** Execute function */
     execute: (params: 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,
@@ -683,6 +781,7 @@ interface ToolCall {
  * Tool execution result
  */
 interface ToolResult {
+    modelOutput?: ToolModelOutput;
     /** Tool call ID this result corresponds to */
     toolCallId: string;
     /** Result data (will be JSON stringified for LLM) */
@@ -692,10 +791,14 @@ interface ToolResult {
  * Parameters for model.doGenerate() and model.doStream()
  */
 interface DoGenerateParams {
+    /** OpenAI endpoint and Responses options. */
+    openai?: OpenAITransportOptions;
     /** Messages to send to LLM */
     messages: CoreMessage[];
     /** Tools available to the LLM (already formatted for provider) */
     tools?: unknown[];
+    /** OpenAI reasoning effort. Omit to preserve the model default. */
+    reasoningEffort?: OpenAIReasoningEffort;
     /** Temperature (0-2) */
     temperature?: number;
     /** Maximum tokens to generate */
@@ -709,6 +812,8 @@ interface DoGenerateParams {
  * Result from model.doGenerate()
  */
 interface DoGenerateResult {
+    /** Provider state retained for continuation and inspection. */
+    providerMetadata?: ProviderMetadata;
     /** Generated text content */
     text: string;
     /** Tool calls requested by the LLM */
@@ -745,11 +850,14 @@ interface ToolCallChunk {
     toolCall: ToolCall;
 }
 interface ToolResultChunk {
+    modelOutput?: ToolModelOutput;
     type: "tool-result";
     toolCallId: string;
     result: unknown;
 }
 interface FinishChunk {
+    /** Provider state retained for continuation and inspection. */
+    providerMetadata?: ProviderMetadata;
     type: "finish";
     finishReason: FinishReason;
     usage?: TokenUsage;
@@ -762,6 +870,8 @@ interface ErrorChunk {
  * Parameters for generateText()
  */
 interface GenerateTextParams {
+    /** OpenAI endpoint and Responses options. */
+    openai?: OpenAITransportOptions;
     /** Language model to use */
     model: LanguageModel;
     /** Simple prompt (converted to user message) */
@@ -771,9 +881,11 @@ interface GenerateTextParams {
     /** Full message history */
     messages?: CoreMessage[];
     /** Tools available to the LLM */
-    tools?: Record<string, Tool>;
+    tools?: Record<string, Tool<any, any>>;
     /** Maximum agentic steps (tool call loops) */
     maxSteps?: number;
+    /** OpenAI reasoning effort. Omit to preserve the model default. */
+    reasoningEffort?: OpenAIReasoningEffort;
     /** Temperature (0-2) */
     temperature?: number;
     /** Maximum tokens to generate */
@@ -787,6 +899,8 @@ interface GenerateTextParams {
  * Result from generateText()
  */
 interface GenerateTextResult {
+    /** Provider state retained for continuation and inspection. */
+    providerMetadata?: ProviderMetadata;
     /** Final text output */
     text: string;
     /** Token usage */
@@ -808,6 +922,8 @@ interface GenerateTextResult {
  * A single step in the generation process
  */
 interface GenerateStep {
+    /** Provider state retained for continuation and inspection. */
+    providerMetadata?: ProviderMetadata;
     /** Text generated in this step */
     text: string;
     /** Tool calls made in this step */
@@ -827,6 +943,11 @@ type StreamTextParams = GenerateTextParams;
  * Result from streamText()
  */
 interface StreamTextResult {
+    /** Final conversation, including opaque provider state for replay. */
+    readonly response: Promise<{
+        messages: CoreMessage[];
+    }>;
+    readonly providerMetadata: Promise<ProviderMetadata | undefined>;
     /** Async iterable of text chunks only */
     textStream: AsyncIterable<string>;
     /** Async iterable of all stream parts */
@@ -863,6 +984,7 @@ type StreamPart = {
     type: "tool-result";
     toolCallId: string;
     result: unknown;
+    modelOutput?: ToolModelOutput;
 } | {
     type: "step-start";
     step: number;
@@ -870,10 +992,12 @@ type StreamPart = {
     type: "step-finish";
     step: number;
     finishReason: FinishReason;
+    providerMetadata?: ProviderMetadata;
 } | {
     type: "finish";
     finishReason: FinishReason;
     usage: TokenUsage;
+    providerMetadata?: ProviderMetadata;
 } | {
     type: "error";
     error: Error;
@@ -960,4 +1084,4 @@ interface StorageFile {
     filename?: string;
 }
 
-export { type ToolExecution as $, type ActionDefinition as A, type ToolResultChunk as B, type CoreMessage as C, type DoneEventMessage as D, type FinishChunk as E, type FilePart as F, type GenerateTextParams as G, type ErrorChunk as H, type ImagePart as I, type TokenUsage as J, type KnowledgeBaseConfig as K, type LanguageModel as L, type Message as M, type FinishReason as N, type ResponseOptions as O, type ProviderToolRuntimeOptions as P, type StorageFile as Q, type ResponseFormat as R, type StreamTextParams as S, type ToolContext as T, type UserMessage as U, DEFAULT_CAPABILITIES as V, type WebSearchConfig as W, type LLMConfig as X, type ToolLocation as Y, type UnifiedToolCall as Z, type UnifiedToolResult as _, type GenerateTextResult as a, type OpenAIToolSelectionHints as a0, type AnthropicToolSelectionHints as a1, type ToolNativeProviderHints as a2, type OpenAIProviderToolOptions as a3, type AnthropicProviderToolOptions as a4, type Citation as a5, type MessageAttachment as a6, type StreamTextResult as b, type Tool as c, type ToolDefinition as d, type ToolProfile as e, type StorageAdapter as f, type StreamEvent as g, type ToolCallInfo as h, type TokenUsageRaw as i, type ToolResponse as j, type StorageMessage as k, type ModelCapabilities as l, type DoGenerateParams as m, type DoGenerateResult as n, type SystemMessage as o, type AssistantMessage as p, type ToolMessage as q, type UserContentPart as r, type TextPart as s, type ToolCall as t, type ToolResult as u, type GenerateStep as v, type StreamPart as w, type StreamChunk as x, type TextDeltaChunk as y, type ToolCallChunk as z };
+export { type LLMConfig as $, type ActionDefinition as A, type StreamChunk as B, type CoreMessage as C, type DoneEventMessage as D, type TextDeltaChunk as E, type FilePart as F, type GenerateTextParams as G, type ToolCallChunk as H, type ImagePart as I, type ToolResultChunk as J, type KnowledgeBaseConfig as K, type LanguageModel as L, type Message as M, type FinishChunk as N, type OpenAITransportOptions as O, type ProviderMetadata as P, type ErrorChunk as Q, type ResponseFormat as R, type StreamTextParams as S, type ToolContext as T, type UserMessage as U, type TokenUsage as V, type WebSearchConfig as W, type FinishReason as X, type ResponseOptions as Y, type StorageFile as Z, DEFAULT_CAPABILITIES as _, type GenerateTextResult as a, type ToolLocation as a0, type UnifiedToolCall as a1, type UnifiedToolResult as a2, type ToolExecution as a3, type OpenAIToolSelectionHints as a4, type AnthropicToolSelectionHints as a5, type ToolNativeProviderHints as a6, type OpenAIProviderToolOptions as a7, type AnthropicProviderToolOptions as a8, type Citation as a9, type OpenAIResponsesOptions as aa, type OpenAIResponseItem as ab, type OpenAIResponseMetadata as ac, type ToolOutputPart as ad, type OpenAIParameterOptions as ae, type MessageAttachment as af, type StreamTextResult as b, type ToolModelOutput as c, type Tool as d, type ToolDefinition as e, type ToolProfile as f, type StorageAdapter as g, type OpenAIReasoningEffort as h, type StreamEvent as i, type ToolCallInfo as j, type TokenUsageRaw as k, type ProviderToolRuntimeOptions as l, type ToolResponse as m, type StorageMessage as n, type ModelCapabilities as o, type DoGenerateParams as p, type DoGenerateResult as q, type SystemMessage as r, type AssistantMessage as s, type ToolMessage as t, type UserContentPart as u, type TextPart as v, type ToolCall as w, type ToolResult as x, type GenerateStep as y, type StreamPart as z };