@yourgpt/llm-sdk 2.1.4-alpha.1 → 2.1.4-alpha.3

package/dist/fallback/index.mjs

@@ -0,0 +1,280 @@
+// src/fallback/errors.ts
+var FallbackExhaustedError = class extends Error {
+  constructor(failures) {
+    const summary = failures.map((f) => `${f.provider}/${f.model}: ${f.error.message}`).join("; ");
+    super(
+      `All ${failures.length} model(s) in the fallback chain failed. ${summary}`
+    );
+    this.name = "FallbackExhaustedError";
+    this.failures = failures;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/fallback/routing-store.ts
+var MemoryRoutingStore = class {
+  constructor() {
+    this._map = /* @__PURE__ */ new Map();
+  }
+  async get(key) {
+    return this._map.get(key);
+  }
+  async set(key, value) {
+    this._map.set(key, value);
+  }
+};
+
+// src/fallback/chain.ts
+var ROUND_ROBIN_KEY = "ygpt_fallback_rr_index";
+function defaultIsRetryable(error) {
+  if (typeof error === "object" && error !== null) {
+    const ctorName = error.constructor?.name ?? "";
+    if (ctorName === "APIUserAbortError") return false;
+    if (ctorName === "APIConnectionError") return true;
+    if (ctorName === "APIConnectionTimeoutError") return true;
+    const status = error.status ?? error.statusCode;
+    if (typeof status === "number") {
+      if (status === 429) return true;
+      if (status >= 500) return true;
+      if (status >= 400) return false;
+    }
+  }
+  if (error instanceof Error) {
+    const msg = error.message;
+    if (/the operation was aborted/i.test(msg)) return false;
+    if (/the user aborted a request/i.test(msg)) return false;
+    if (/\b4[0-9]{2}\b/.test(msg) && !/\b429\b/.test(msg)) return false;
+    if (/\b429\b/.test(msg)) return true;
+    if (/rate[\s_-]?limit/i.test(msg)) return true;
+    if (/too many requests/i.test(msg)) return true;
+    if (/quota exceeded/i.test(msg)) return true;
+    if (/\b5[0-9]{2}\b/.test(msg)) return true;
+    if (/internal server error/i.test(msg)) return true;
+    if (/service unavailable/i.test(msg)) return true;
+    if (/bad gateway/i.test(msg)) return true;
+    if (/gateway timeout/i.test(msg)) return true;
+    if (/overloaded/i.test(msg)) return true;
+    if (/^connection error\.?$/i.test(msg)) return true;
+    if (/^request timed out\.?$/i.test(msg)) return true;
+    if (/timed?\s*out/i.test(msg)) return true;
+    if (/timeout/i.test(msg)) return true;
+    if (/fetch failed/i.test(msg)) return true;
+    if (/ECONNREFUSED/.test(msg)) return true;
+    if (/ECONNRESET/.test(msg)) return true;
+    if (/ETIMEDOUT/.test(msg)) return true;
+    if (/ENOTFOUND/.test(msg)) return true;
+    if (/ENETUNREACH/.test(msg)) return true;
+    if (/EHOSTUNREACH/.test(msg)) return true;
+  }
+  return false;
+}
+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));
+}
+var FallbackChain = class {
+  constructor(config) {
+    if (config.models.length === 0) {
+      throw new Error("FallbackChain requires at least one model.");
+    }
+    this._config = {
+      models: config.models,
+      strategy: config.strategy ?? "priority",
+      store: config.store ?? new MemoryRoutingStore(),
+      retries: config.retries ?? 0,
+      retryDelay: config.retryDelay ?? 500,
+      retryBackoff: config.retryBackoff ?? "exponential",
+      onFallback: config.onFallback,
+      onRetry: config.onRetry,
+      retryableErrors: config.retryableErrors
+    };
+  }
+  get provider() {
+    return "fallback-chain";
+  }
+  get model() {
+    return this._config.models.map((m) => `${m.provider}/${m.model}`).join(",");
+  }
+  async _startIndex() {
+    if (this._config.strategy !== "round-robin") return 0;
+    const stored = await this._config.store.get(ROUND_ROBIN_KEY);
+    return typeof stored === "number" ? stored % this._config.models.length : 0;
+  }
+  async _advanceIndex(successfulIndex) {
+    if (this._config.strategy !== "round-robin") return;
+    const next = (successfulIndex + 1) % this._config.models.length;
+    await this._config.store.set(ROUND_ROBIN_KEY, next);
+  }
+  _isRetryable(error) {
+    return this._config.retryableErrors ? this._config.retryableErrors(error) : defaultIsRetryable(error);
+  }
+  /**
+   * Try streaming from a single adapter, with per-model retries.
+   *
+   * Returns an async generator that either:
+   *   - yields all chunks on success, then returns
+   *   - throws the final error if all retries exhausted or error is non-retryable
+   *
+   * The `retriesAttempted` out-param is filled via the returned object so callers
+   * can record it in FallbackFailure.
+   */
+  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;
+      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;
+          }
+          if (chunk.type === "message:start") continue;
+          contentStarted = true;
+          yield chunk;
+        }
+      } 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 = {
+          model: adapter.model,
+          provider: adapter.provider,
+          error: failureError,
+          retryAttempt: attempt,
+          maxRetries: retries,
+          delayMs
+        };
+        onRetry?.(retryInfo);
+        await sleep(delayMs);
+        continue;
+      }
+      out.retriesAttempted = retries;
+      throw failureError;
+    }
+  }
+  async *stream(request) {
+    const { models, onFallback } = this._config;
+    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 };
+      try {
+        yield* this._streamWithRetries(adapter, request, out);
+        await this._advanceIndex(index);
+        return;
+      } catch (error) {
+        if (!this._isRetryable(error)) throw error;
+        const failure = {
+          model: adapter.model,
+          provider: adapter.provider,
+          error: error instanceof Error ? error : new Error(String(error)),
+          attempt: i + 1,
+          retriesAttempted: out.retriesAttempted
+        };
+        failures.push(failure);
+        const nextOffset = i + 1;
+        if (nextOffset < models.length && onFallback) {
+          const nextIndex = (startIndex + nextOffset) % models.length;
+          onFallback({
+            attemptedModel: adapter.model,
+            nextModel: models[nextIndex].model,
+            error: failure.error,
+            attempt: failure.attempt
+          });
+        }
+      }
+    }
+    throw new FallbackExhaustedError(failures);
+  }
+  async complete(request) {
+    const { models, onFallback, retries, retryDelay, retryBackoff, onRetry } = this._config;
+    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];
+      if (!adapter.complete) {
+        failures.push({
+          model: adapter.model,
+          provider: adapter.provider,
+          error: new Error(
+            `Adapter ${adapter.provider}/${adapter.model} does not implement complete()`
+          ),
+          attempt: i + 1,
+          retriesAttempted: 0
+        });
+        continue;
+      }
+      const maxAttempts = retries + 1;
+      let lastError = null;
+      let retriesAttempted = 0;
+      for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+          const result = await adapter.complete(request);
+          await this._advanceIndex(index);
+          return result;
+        } catch (error) {
+          if (!this._isRetryable(error)) throw error;
+          lastError = error instanceof Error ? error : new Error(String(error));
+          retriesAttempted = attempt - 1;
+          if (attempt < maxAttempts) {
+            const delayMs = calcDelay(retryDelay, attempt, retryBackoff);
+            onRetry?.({
+              model: adapter.model,
+              provider: adapter.provider,
+              error: lastError,
+              retryAttempt: attempt,
+              maxRetries: retries,
+              delayMs
+            });
+            await sleep(delayMs);
+          }
+        }
+      }
+      const failure = {
+        model: adapter.model,
+        provider: adapter.provider,
+        error: lastError,
+        attempt: i + 1,
+        retriesAttempted
+      };
+      failures.push(failure);
+      const nextOffset = i + 1;
+      if (nextOffset < models.length && onFallback) {
+        const nextIndex = (startIndex + nextOffset) % models.length;
+        onFallback({
+          attemptedModel: adapter.model,
+          nextModel: models[nextIndex].model,
+          error: failure.error,
+          attempt: failure.attempt
+        });
+      }
+    }
+    throw new FallbackExhaustedError(failures);
+  }
+};
+function createFallbackChain(config) {
+  return new FallbackChain(config);
+}
+
+export { FallbackExhaustedError, MemoryRoutingStore, createFallbackChain };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.d.mts

@@ -1,8 +1,13 @@
-import { G as GenerateTextParams, a as GenerateTextResult, S as StreamTextParams, b as StreamTextResult, T as ToolContext, c as Tool, A as AIProvider, d as ActionDefinition, e as ToolDefinition, f as ToolProfile, K as KnowledgeBaseConfig, W as WebSearchConfig, L as LLMAdapter, D as DoneEventMessage, g as StreamEvent, h as ToolCallInfo, i as TokenUsageRaw, P as ProviderToolRuntimeOptions, M as Message, j as ToolResponse } from './types-COAOEe_y.mjs';
-export { V as AdapterFactory, _ as AnthropicProviderConfig, an as AnthropicProviderToolOptions, a5 as AnthropicTool, a7 as AnthropicToolResult, ak as AnthropicToolSelectionHints, a6 as AnthropicToolUse, p as AssistantMessage, a1 as AzureProviderConfig, Y as BaseProviderConfig, Q as ChatCompletionRequest, ao as Citation, C as CoreMessage, O as DEFAULT_CAPABILITIES, m as DoGenerateParams, n as DoGenerateResult, H as ErrorChunk, F as FilePart, E as FinishChunk, N as FinishReason, ac as GeminiFunctionCall, ab as GeminiFunctionDeclaration, ad as GeminiFunctionResponse, v as GenerateStep, $ as GoogleProviderConfig, I as ImagePart, ae as LLMConfig, k as LanguageModel, l as ModelCapabilities, a3 as OllamaModelOptions, a2 as OllamaProviderConfig, Z as OpenAIProviderConfig, am as OpenAIProviderToolOptions, a8 as OpenAITool, a9 as OpenAIToolCall, aa as OpenAIToolResult, aj as OpenAIToolSelectionHints, X as ProviderCapabilities, a4 as ProviderFormatter, R as ResponseOptions, x as StreamChunk, w as StreamPart, o as SystemMessage, y as TextDeltaChunk, s as TextPart, J as TokenUsage, t as ToolCall, z as ToolCallChunk, ai as ToolExecution, af as ToolLocation, q as ToolMessage, al as ToolNativeProviderHints, u as ToolResult, B as ToolResultChunk, ag as UnifiedToolCall, ah as UnifiedToolResult, r as UserContentPart, U as UserMessage, a0 as XAIProviderConfig } from './types-COAOEe_y.mjs';
+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 { 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-5n-UuPfS.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-5n-UuPfS.mjs';
+import { A as AIProvider } from './types-VDgiUvH2.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-VDgiUvH2.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-BQl1suAv.mjs';
 
 /**
  * generateText - Generate text using a language model
@@ -257,6 +262,17 @@ interface RuntimeConfigWithAdapter {
      * Set to true for defaults, or pass WebSearchConfig for customization.
      */
     webSearch?: boolean | WebSearchConfig;
+    /**
+     * Storage adapter for automatic session creation and message persistence.
+     * When provided, runtime.chat() and runtime.stream() auto-save messages.
+     *
+     * @example
+     * ```ts
+     * import { createYourGPT } from '@yourgpt/llm-sdk/yourgpt'
+     * storage: createYourGPT({ apiKey, widgetUid })
+     * ```
+     */
+    storage?: StorageAdapter;
 }
 /**
  * Runtime configuration with AIProvider
@@ -303,6 +319,17 @@ interface RuntimeConfigWithProvider {
      * Set to true for defaults, or pass WebSearchConfig for customization.
      */
     webSearch?: boolean | WebSearchConfig;
+    /**
+     * Storage adapter for automatic session creation and message persistence.
+     * When provided, runtime.chat() and runtime.stream() auto-save messages.
+     *
+     * @example
+     * ```ts
+     * import { createYourGPT } from '@yourgpt/llm-sdk/yourgpt'
+     * storage: createYourGPT({ apiKey, widgetUid })
+     * ```
+     */
+    storage?: StorageAdapter;
 }
 /**
  * Runtime configuration - provide either a provider instance or a custom adapter
@@ -537,6 +564,8 @@ interface OnFinishResult {
         completionTokens: number;
         totalTokens: number;
     };
+    /** Session ID — present when storage adapter created/resolved a session */
+    threadId?: string;
 }
 /**
  * Options for StreamResult constructor
@@ -562,6 +591,8 @@ interface CollectedResult {
     requiresAction: boolean;
     /** Token usage for billing/tracking */
     usage?: TokenUsageRaw;
+    /** Session ID — present when storage adapter created/resolved a session */
+    threadId?: string;
     /** Raw events (for debugging) */
     events: StreamEvent[];
 }
@@ -870,6 +901,7 @@ type ToolSearchState = {
 declare class Runtime {
     private adapter;
     private config;
+    private storage;
     private actions;
     private tools;
     constructor(config: RuntimeConfig);
@@ -1034,6 +1066,7 @@ declare class Runtime {
          */
         onFinish?: (result: {
             messages: DoneEventMessage[];
+            threadId?: string;
             usage?: {
                 promptTokens: number;
                 completionTokens: number;
@@ -1464,6 +1497,32 @@ interface AgentLoopOptions {
  */
 declare function runAgentLoop(options: AgentLoopOptions): AsyncGenerator<StreamEvent>;
 
+/**
+ * Storage Helpers
+ *
+ * Extract input/output messages from request/response for storage adapters.
+ * Used internally by Runtime when `storage` is configured.
+ */
+
+/**
+ * Extract new INPUT messages from a request's message array.
+ *
+ * The SDK sends the full conversation history on each request. This function
+ * picks only the NEW messages the user just added:
+ * - New user turn (last meaningful msg = "user"): returns [userMsg]
+ * - Tool continuation (last meaningful msg = "tool"): returns tool results after last assistant
+ * - Otherwise: returns []
+ *
+ * Skips empty assistant placeholders the SDK pushes before sending.
+ */
+declare function extractInputMessages(reqMessages: unknown[]): StorageMessage[];
+/**
+ * Map LLM output messages (DoneEventMessage format) to StorageMessage format.
+ *
+ * Converts from snake_case API format to camelCase storage format.
+ */
+declare function mapOutputMessages(resultMessages: DoneEventMessage[]): StorageMessage[];
+
 /**
  * Generate a message ID
  */
@@ -1477,4 +1536,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, 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, formatSSEData, formatToolsForAnthropic, formatToolsForGoogle, formatToolsForOpenAI, generateMessageId, generateText, generateThreadId, generateToolCallId, 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, 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 };

package/dist/index.d.ts

@@ -1,8 +1,13 @@
-import { G as GenerateTextParams, a as GenerateTextResult, S as StreamTextParams, b as StreamTextResult, T as ToolContext, c as Tool, A as AIProvider, d as ActionDefinition, e as ToolDefinition, f as ToolProfile, K as KnowledgeBaseConfig, W as WebSearchConfig, L as LLMAdapter, D as DoneEventMessage, g as StreamEvent, h as ToolCallInfo, i as TokenUsageRaw, P as ProviderToolRuntimeOptions, M as Message, j as ToolResponse } from './types-COAOEe_y.js';
-export { V as AdapterFactory, _ as AnthropicProviderConfig, an as AnthropicProviderToolOptions, a5 as AnthropicTool, a7 as AnthropicToolResult, ak as AnthropicToolSelectionHints, a6 as AnthropicToolUse, p as AssistantMessage, a1 as AzureProviderConfig, Y as BaseProviderConfig, Q as ChatCompletionRequest, ao as Citation, C as CoreMessage, O as DEFAULT_CAPABILITIES, m as DoGenerateParams, n as DoGenerateResult, H as ErrorChunk, F as FilePart, E as FinishChunk, N as FinishReason, ac as GeminiFunctionCall, ab as GeminiFunctionDeclaration, ad as GeminiFunctionResponse, v as GenerateStep, $ as GoogleProviderConfig, I as ImagePart, ae as LLMConfig, k as LanguageModel, l as ModelCapabilities, a3 as OllamaModelOptions, a2 as OllamaProviderConfig, Z as OpenAIProviderConfig, am as OpenAIProviderToolOptions, a8 as OpenAITool, a9 as OpenAIToolCall, aa as OpenAIToolResult, aj as OpenAIToolSelectionHints, X as ProviderCapabilities, a4 as ProviderFormatter, R as ResponseOptions, x as StreamChunk, w as StreamPart, o as SystemMessage, y as TextDeltaChunk, s as TextPart, J as TokenUsage, t as ToolCall, z as ToolCallChunk, ai as ToolExecution, af as ToolLocation, q as ToolMessage, al as ToolNativeProviderHints, u as ToolResult, B as ToolResultChunk, ag as UnifiedToolCall, ah as UnifiedToolResult, r as UserContentPart, U as UserMessage, a0 as XAIProviderConfig } from './types-COAOEe_y.js';
+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 { 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-Di31iy_8.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-Di31iy_8.js';
+import { A as AIProvider } from './types-C0vLXzuw.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-C0vLXzuw.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-CNL8ZRne.js';
 
 /**
  * generateText - Generate text using a language model
@@ -257,6 +262,17 @@ interface RuntimeConfigWithAdapter {
      * Set to true for defaults, or pass WebSearchConfig for customization.
      */
     webSearch?: boolean | WebSearchConfig;
+    /**
+     * Storage adapter for automatic session creation and message persistence.
+     * When provided, runtime.chat() and runtime.stream() auto-save messages.
+     *
+     * @example
+     * ```ts
+     * import { createYourGPT } from '@yourgpt/llm-sdk/yourgpt'
+     * storage: createYourGPT({ apiKey, widgetUid })
+     * ```
+     */
+    storage?: StorageAdapter;
 }
 /**
  * Runtime configuration with AIProvider
@@ -303,6 +319,17 @@ interface RuntimeConfigWithProvider {
      * Set to true for defaults, or pass WebSearchConfig for customization.
      */
     webSearch?: boolean | WebSearchConfig;
+    /**
+     * Storage adapter for automatic session creation and message persistence.
+     * When provided, runtime.chat() and runtime.stream() auto-save messages.
+     *
+     * @example
+     * ```ts
+     * import { createYourGPT } from '@yourgpt/llm-sdk/yourgpt'
+     * storage: createYourGPT({ apiKey, widgetUid })
+     * ```
+     */
+    storage?: StorageAdapter;
 }
 /**
  * Runtime configuration - provide either a provider instance or a custom adapter
@@ -537,6 +564,8 @@ interface OnFinishResult {
         completionTokens: number;
         totalTokens: number;
     };
+    /** Session ID — present when storage adapter created/resolved a session */
+    threadId?: string;
 }
 /**
  * Options for StreamResult constructor
@@ -562,6 +591,8 @@ interface CollectedResult {
     requiresAction: boolean;
     /** Token usage for billing/tracking */
     usage?: TokenUsageRaw;
+    /** Session ID — present when storage adapter created/resolved a session */
+    threadId?: string;
     /** Raw events (for debugging) */
     events: StreamEvent[];
 }
@@ -870,6 +901,7 @@ type ToolSearchState = {
 declare class Runtime {
     private adapter;
     private config;
+    private storage;
     private actions;
     private tools;
     constructor(config: RuntimeConfig);
@@ -1034,6 +1066,7 @@ declare class Runtime {
          */
         onFinish?: (result: {
             messages: DoneEventMessage[];
+            threadId?: string;
             usage?: {
                 promptTokens: number;
                 completionTokens: number;
@@ -1464,6 +1497,32 @@ interface AgentLoopOptions {
  */
 declare function runAgentLoop(options: AgentLoopOptions): AsyncGenerator<StreamEvent>;
 
+/**
+ * Storage Helpers
+ *
+ * Extract input/output messages from request/response for storage adapters.
+ * Used internally by Runtime when `storage` is configured.
+ */
+
+/**
+ * Extract new INPUT messages from a request's message array.
+ *
+ * The SDK sends the full conversation history on each request. This function
+ * picks only the NEW messages the user just added:
+ * - New user turn (last meaningful msg = "user"): returns [userMsg]
+ * - Tool continuation (last meaningful msg = "tool"): returns tool results after last assistant
+ * - Otherwise: returns []
+ *
+ * Skips empty assistant placeholders the SDK pushes before sending.
+ */
+declare function extractInputMessages(reqMessages: unknown[]): StorageMessage[];
+/**
+ * Map LLM output messages (DoneEventMessage format) to StorageMessage format.
+ *
+ * Converts from snake_case API format to camelCase storage format.
+ */
+declare function mapOutputMessages(resultMessages: DoneEventMessage[]): StorageMessage[];
+
 /**
  * Generate a message ID
  */
@@ -1477,4 +1536,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, 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, formatSSEData, formatToolsForAnthropic, formatToolsForGoogle, formatToolsForOpenAI, generateMessageId, generateText, generateThreadId, generateToolCallId, 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, 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 };