@yourgpt/copilot-sdk 2.1.5-alpha.5 → 2.1.5-alpha.7

package/dist/react/index.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk5UGWLGFS_cjs = require('../chunk-5UGWLGFS.cjs');
-var chunkLHLVTGIP_cjs = require('../chunk-LHLVTGIP.cjs');
-var chunkKGYDGK3U_cjs = require('../chunk-KGYDGK3U.cjs');
+var chunkM66XAHSW_cjs = require('../chunk-M66XAHSW.cjs');
+var chunkNPBOKT63_cjs = require('../chunk-NPBOKT63.cjs');
+var chunk7GWEW2DU_cjs = require('../chunk-7GWEW2DU.cjs');
 require('../chunk-JGPDQDY4.cjs');
 require('../chunk-BJYA5NDL.cjs');
 require('../chunk-Y2A6AMGO.cjs');
@@ -22,255 +22,259 @@ require('../chunk-JEQ2X3Z6.cjs');
 
 Object.defineProperty(exports, "ReactChat", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.ReactChat; }
+  get: function () { return chunkM66XAHSW_cjs.ReactChat; }
 });
 Object.defineProperty(exports, "ReactThreadManager", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.ReactThreadManager; }
+  get: function () { return chunkM66XAHSW_cjs.ReactThreadManager; }
 });
 Object.defineProperty(exports, "ReactThreadManagerState", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.ReactThreadManagerState; }
+  get: function () { return chunkM66XAHSW_cjs.ReactThreadManagerState; }
 });
 Object.defineProperty(exports, "createMessageIntentHandler", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.createMessageIntentHandler; }
+  get: function () { return chunkM66XAHSW_cjs.createMessageIntentHandler; }
 });
 Object.defineProperty(exports, "createPermissionStorage", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.createPermissionStorage; }
+  get: function () { return chunkM66XAHSW_cjs.createPermissionStorage; }
 });
 Object.defineProperty(exports, "createReactChat", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.createReactChat; }
+  get: function () { return chunkM66XAHSW_cjs.createReactChat; }
 });
 Object.defineProperty(exports, "createReactThreadManager", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.createReactThreadManager; }
+  get: function () { return chunkM66XAHSW_cjs.createReactThreadManager; }
 });
 Object.defineProperty(exports, "createReactThreadManagerState", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.createReactThreadManagerState; }
+  get: function () { return chunkM66XAHSW_cjs.createReactThreadManagerState; }
 });
 Object.defineProperty(exports, "createSessionPermissionCache", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.createSessionPermissionCache; }
+  get: function () { return chunkM66XAHSW_cjs.createSessionPermissionCache; }
 });
 Object.defineProperty(exports, "createToolIntentHandler", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.createToolIntentHandler; }
+  get: function () { return chunkM66XAHSW_cjs.createToolIntentHandler; }
 });
 Object.defineProperty(exports, "defineSkill", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.defineSkill; }
+  get: function () { return chunkM66XAHSW_cjs.defineSkill; }
 });
 Object.defineProperty(exports, "formatKnowledgeResultsForAI", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.formatKnowledgeResultsForAI; }
+  get: function () { return chunkM66XAHSW_cjs.formatKnowledgeResultsForAI; }
 });
 Object.defineProperty(exports, "searchKnowledgeBase", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.searchKnowledgeBase; }
+  get: function () { return chunkM66XAHSW_cjs.searchKnowledgeBase; }
 });
 Object.defineProperty(exports, "useAIAction", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useAIAction; }
+  get: function () { return chunkM66XAHSW_cjs.useAIAction; }
 });
 Object.defineProperty(exports, "useAIActions", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useAIActions; }
+  get: function () { return chunkM66XAHSW_cjs.useAIActions; }
 });
 Object.defineProperty(exports, "useAITools", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useAITools; }
+  get: function () { return chunkM66XAHSW_cjs.useAITools; }
 });
 Object.defineProperty(exports, "useAgent", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useAgent; }
+  get: function () { return chunkM66XAHSW_cjs.useAgent; }
 });
 Object.defineProperty(exports, "useCapabilities", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useCapabilities; }
+  get: function () { return chunkM66XAHSW_cjs.useCapabilities; }
 });
 Object.defineProperty(exports, "useChat", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useChat; }
+  get: function () { return chunkM66XAHSW_cjs.useChat; }
 });
 Object.defineProperty(exports, "useContextStats", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useContextStats; }
+  get: function () { return chunkM66XAHSW_cjs.useContextStats; }
 });
 Object.defineProperty(exports, "useCopilotEvent", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useCopilotEvent; }
+  get: function () { return chunkM66XAHSW_cjs.useCopilotEvent; }
 });
 Object.defineProperty(exports, "useDevLogger", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useDevLogger; }
+  get: function () { return chunkM66XAHSW_cjs.useDevLogger; }
 });
 Object.defineProperty(exports, "useFeatureSupport", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useFeatureSupport; }
+  get: function () { return chunkM66XAHSW_cjs.useFeatureSupport; }
 });
 Object.defineProperty(exports, "useKnowledgeBase", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useKnowledgeBase; }
+  get: function () { return chunkM66XAHSW_cjs.useKnowledgeBase; }
 });
 Object.defineProperty(exports, "useMCPUIIntents", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useMCPUIIntents; }
+  get: function () { return chunkM66XAHSW_cjs.useMCPUIIntents; }
 });
 Object.defineProperty(exports, "useMessageCheckpoints", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useMessageCheckpoints; }
+  get: function () { return chunkM66XAHSW_cjs.useMessageCheckpoints; }
 });
 Object.defineProperty(exports, "useMessageMeta", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useMessageMeta; }
+  get: function () { return chunkM66XAHSW_cjs.useMessageMeta; }
 });
 Object.defineProperty(exports, "useSkill", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useSkill; }
+  get: function () { return chunkM66XAHSW_cjs.useSkill; }
 });
 Object.defineProperty(exports, "useSkillStatus", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useSkillStatus; }
+  get: function () { return chunkM66XAHSW_cjs.useSkillStatus; }
 });
 Object.defineProperty(exports, "useSuggestions", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useSuggestions; }
+  get: function () { return chunkM66XAHSW_cjs.useSuggestions; }
 });
 Object.defineProperty(exports, "useSupportedMediaTypes", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useSupportedMediaTypes; }
+  get: function () { return chunkM66XAHSW_cjs.useSupportedMediaTypes; }
+});
+Object.defineProperty(exports, "useThread", {
+  enumerable: true,
+  get: function () { return chunkM66XAHSW_cjs.useThread; }
 });
 Object.defineProperty(exports, "useThreadManager", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useThreadManager; }
+  get: function () { return chunkM66XAHSW_cjs.useThreadManager; }
 });
 Object.defineProperty(exports, "useToolExecutor", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useToolExecutor; }
+  get: function () { return chunkM66XAHSW_cjs.useToolExecutor; }
 });
 Object.defineProperty(exports, "useToolWithSchema", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useToolWithSchema; }
+  get: function () { return chunkM66XAHSW_cjs.useToolWithSchema; }
 });
 Object.defineProperty(exports, "useToolsWithSchema", {
   enumerable: true,
-  get: function () { return chunk5UGWLGFS_cjs.useToolsWithSchema; }
+  get: function () { return chunkM66XAHSW_cjs.useToolsWithSchema; }
 });
 Object.defineProperty(exports, "AbstractAgentLoop", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.AbstractAgentLoop; }
+  get: function () { return chunkNPBOKT63_cjs.AbstractAgentLoop; }
 });
 Object.defineProperty(exports, "AbstractChat", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.AbstractChat; }
+  get: function () { return chunkNPBOKT63_cjs.AbstractChat; }
 });
 Object.defineProperty(exports, "CopilotProvider", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.CopilotProvider; }
+  get: function () { return chunkNPBOKT63_cjs.CopilotProvider; }
 });
 Object.defineProperty(exports, "MessageHistoryContext", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.MessageHistoryContext; }
+  get: function () { return chunkNPBOKT63_cjs.MessageHistoryContext; }
 });
 Object.defineProperty(exports, "MessageTree", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.MessageTree; }
+  get: function () { return chunkNPBOKT63_cjs.MessageTree; }
 });
 Object.defineProperty(exports, "ReactChatState", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.ReactChatState; }
+  get: function () { return chunkNPBOKT63_cjs.ReactChatState; }
 });
 Object.defineProperty(exports, "SkillProvider", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.SkillProvider; }
+  get: function () { return chunkNPBOKT63_cjs.SkillProvider; }
 });
 Object.defineProperty(exports, "createReactChatState", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.createReactChatState; }
+  get: function () { return chunkNPBOKT63_cjs.createReactChatState; }
 });
 Object.defineProperty(exports, "defaultMessageHistoryConfig", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.defaultMessageHistoryConfig; }
+  get: function () { return chunkNPBOKT63_cjs.defaultMessageHistoryConfig; }
 });
 Object.defineProperty(exports, "initialAgentLoopState", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.initialAgentLoopState; }
+  get: function () { return chunkNPBOKT63_cjs.initialAgentLoopState; }
 });
 Object.defineProperty(exports, "isCompactionMarker", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.isCompactionMarker; }
+  get: function () { return chunkNPBOKT63_cjs.isCompactionMarker; }
 });
 Object.defineProperty(exports, "keepToolPairsAtomic", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.keepToolPairsAtomic; }
+  get: function () { return chunkNPBOKT63_cjs.keepToolPairsAtomic; }
 });
 Object.defineProperty(exports, "toDisplayMessage", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.toDisplayMessage; }
+  get: function () { return chunkNPBOKT63_cjs.toDisplayMessage; }
 });
 Object.defineProperty(exports, "toLLMMessage", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.toLLMMessage; }
+  get: function () { return chunkNPBOKT63_cjs.toLLMMessage; }
 });
 Object.defineProperty(exports, "toLLMMessages", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.toLLMMessages; }
+  get: function () { return chunkNPBOKT63_cjs.toLLMMessages; }
 });
 Object.defineProperty(exports, "useAIContext", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.useAIContext; }
+  get: function () { return chunkNPBOKT63_cjs.useAIContext; }
 });
 Object.defineProperty(exports, "useAIContexts", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.useAIContexts; }
+  get: function () { return chunkNPBOKT63_cjs.useAIContexts; }
 });
 Object.defineProperty(exports, "useCopilot", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.useCopilot; }
+  get: function () { return chunkNPBOKT63_cjs.useCopilot; }
 });
 Object.defineProperty(exports, "useMCPClient", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.useMCPClient; }
+  get: function () { return chunkNPBOKT63_cjs.useMCPClient; }
 });
 Object.defineProperty(exports, "useMCPTools", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.useMCPTools; }
+  get: function () { return chunkNPBOKT63_cjs.useMCPTools; }
 });
 Object.defineProperty(exports, "useMessageHistory", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.useMessageHistory; }
+  get: function () { return chunkNPBOKT63_cjs.useMessageHistory; }
 });
 Object.defineProperty(exports, "useMessageHistoryContext", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.useMessageHistoryContext; }
+  get: function () { return chunkNPBOKT63_cjs.useMessageHistoryContext; }
 });
 Object.defineProperty(exports, "useTool", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.useTool; }
+  get: function () { return chunkNPBOKT63_cjs.useTool; }
 });
 Object.defineProperty(exports, "useTools", {
   enumerable: true,
-  get: function () { return chunkLHLVTGIP_cjs.useTools; }
+  get: function () { return chunkNPBOKT63_cjs.useTools; }
 });
 Object.defineProperty(exports, "createLocalStorageAdapter", {
   enumerable: true,
-  get: function () { return chunkKGYDGK3U_cjs.createLocalStorageAdapter; }
+  get: function () { return chunk7GWEW2DU_cjs.createLocalStorageAdapter; }
 });
 Object.defineProperty(exports, "createMemoryAdapter", {
   enumerable: true,
-  get: function () { return chunkKGYDGK3U_cjs.createMemoryAdapter; }
+  get: function () { return chunk7GWEW2DU_cjs.createMemoryAdapter; }
 });
 Object.defineProperty(exports, "createServerAdapter", {
   enumerable: true,
-  get: function () { return chunkKGYDGK3U_cjs.createServerAdapter; }
+  get: function () { return chunk7GWEW2DU_cjs.createServerAdapter; }
 });
 Object.defineProperty(exports, "generateSuggestionReason", {
   enumerable: true,
-  get: function () { return chunkKGYDGK3U_cjs.generateSuggestionReason; }
+  get: function () { return chunk7GWEW2DU_cjs.generateSuggestionReason; }
 });
 Object.defineProperty(exports, "tool", {
   enumerable: true,

package/dist/react/index.d.cts

@@ -3,8 +3,8 @@ import { U as UIMessage, B as BranchInfo } from '../MessageTree-Dt9qfJ55.cjs';
 export { M as MessageTree } from '../MessageTree-Dt9qfJ55.cjs';
 import * as React$1 from 'react';
 import React__default from 'react';
-import { L as LLMConfig, l as ToolsConfig, s as ActionDefinition, o as CapturedContext, m as ToolConsentRequest, T as ToolType, n as ToolConsentResponse, S as ScreenshotOptions, C as ConsoleLogOptions, N as NetworkRequestOptions, I as IntentDetectionResult, y as InternalKnowledgeBaseConfig, B as InternalKnowledgeBaseSearchResponse, z as InternalKnowledgeBaseResult, Y as ThreadManagerState, Z as LoadStatus, U as ThreadManagerConfig, F as ThreadManager, V as ThreadManagerCallbacks, W as CreateThreadOptions, X as UpdateThreadOptions } from '../ThreadManager-DK46fVl3.cjs';
-export { A as ActionParameter, q as CloudConfig, r as CopilotConfig, _ as LocalStorageAdapterConfig, J as createLocalStorageAdapter, O as createMemoryAdapter, i as generateSuggestionReason } from '../ThreadManager-DK46fVl3.cjs';
+import { L as LLMConfig, l as ToolsConfig, s as ActionDefinition, o as CapturedContext, m as ToolConsentRequest, T as ToolType, n as ToolConsentResponse, S as ScreenshotOptions, C as ConsoleLogOptions, N as NetworkRequestOptions, I as IntentDetectionResult, y as InternalKnowledgeBaseConfig, B as InternalKnowledgeBaseSearchResponse, z as InternalKnowledgeBaseResult, Y as ThreadManagerState, Z as LoadStatus, U as ThreadManagerConfig, F as ThreadManager, V as ThreadManagerCallbacks, W as CreateThreadOptions, X as UpdateThreadOptions } from '../ThreadManager-B12N-zpq.cjs';
+export { A as ActionParameter, q as CloudConfig, r as CopilotConfig, _ as LocalStorageAdapterConfig, J as createLocalStorageAdapter, O as createMemoryAdapter, i as generateSuggestionReason } from '../ThreadManager-B12N-zpq.cjs';
 import { T as ToolDefinition, t as ToolOptimizationConfig, r as ContextUsage, f as ToolSource, P as PermissionLevel, c as ToolInputSchema, y as ToolExecution$1, e as ToolContext, b as ToolResponse$1, g as ToolRenderProps, i as ToolResultConfig, D as AIResponseMode, u as ToolSet, U as UnifiedToolCall, G as PermissionStorageConfig, H as PermissionStorageAdapter } from '../tools-DcS6Aeao.cjs';
 export { z as AgentLoopConfig, q as ContextUsagePart, h as ToolConfig, a as ToolExecutionStatus, F as ToolPermission, v as ToolSetEntry, I as tool } from '../tools-DcS6Aeao.cjs';
 import { A as AsyncThreadStorageAdapter, M as MessageAttachment, T as ToolCall, d as Message, S as Source, a as Thread, b as ThreadData, c as ThreadStorageAdapter } from '../types-waEqyE4K.cjs';
@@ -142,6 +142,8 @@ interface ChatResponse {
         /** Tool call ID for tool result messages */
         tool_call_id?: string;
     }>;
+    /** Session ID — present when server storage adapter created/resolved a session */
+    threadId?: string;
     /** Whether client needs to execute tools */
     requiresAction?: boolean;
     /** Tool calls with metadata (includes hidden flag for server-side tools) */
@@ -211,6 +213,8 @@ type StreamChunk = {
         tool_call_id?: string;
     }>;
     requiresAction?: boolean;
+    /** Session ID from server storage adapter */
+    threadId?: string;
 } | {
     type: "action:start";
     id: string;
@@ -427,6 +431,17 @@ interface ChatState$1<T extends UIMessage = UIMessage> {
  * Chat status
  */
 type ChatStatus$1 = "ready" | "submitted" | "streaming" | "error";
+/**
+ * YourGPT configuration for automatic session management
+ */
+interface YourGPTConfig {
+    /** YourGPT API key (sent as api-key header) */
+    apiKey: string;
+    /** Widget UID to scope sessions to */
+    widgetUid: string;
+    /** API base URL (default: https://api.yourgpt.ai) */
+    endpoint?: string;
+}
 /**
  * Chat configuration
  *
@@ -462,6 +477,37 @@ interface ChatConfig {
     body?: Resolvable<Record<string, unknown>>;
     /** Thread ID for conversation persistence */
     threadId?: string;
+    /**
+     * Called once before the first message on a new thread to obtain a session/thread ID.
+     * The returned value IS the thread ID — session and thread are the same identity.
+     *
+     * Only called when `config.threadId` is not set (new thread).
+     * If `threadId` is already provided, this is skipped entirely.
+     * Takes priority over `yourgptConfig` when both are provided.
+     *
+     * @example Async server session
+     * ```ts
+     * onCreateSession={async () => {
+     *   const res = await fetch('/api/sessions', { method: 'POST' })
+     *   return (await res.json()).id
+     * }}
+     * ```
+     */
+    onCreateSession?: () => string | Promise<string>;
+    /**
+     * YourGPT config — enables automatic session creation with zero boilerplate.
+     * When provided, the SDK calls YourGPT's createSession API before the first
+     * message and uses the returned session_uid as `threadId`.
+     *
+     * @example
+     * ```tsx
+     * yourgptConfig={{
+     *   apiKey: process.env.YOURGPT_API_KEY,
+     *   widgetUid: widgetUid,
+     * }}
+     * ```
+     */
+    yourgptConfig?: YourGPTConfig;
     /** Enable debug logging */
     debug?: boolean;
     /** Available tools (passed to LLM) */
@@ -500,6 +546,17 @@ interface ChatCallbacks<T extends UIMessage = UIMessage> {
     onFinish?: (messages: T[]) => void;
     /** Called when prompt context usage changes */
     onContextUsageChange?: (usage: ContextUsage) => void;
+    /**
+     * Called once when a new session/thread ID is assigned (null → sessionId transition).
+     * Use this to persist the session ID in your storage layer.
+     * The returned ID is the same as the threadId that will be used for all subsequent requests.
+     */
+    onThreadChange?: (id: string) => void;
+    /**
+     * Called when the session creation status changes.
+     * Use this to show/hide a spinner while the session is being created.
+     */
+    onSessionStatusChange?: (status: "idle" | "creating" | "ready" | "error") => void;
     /** Called when a server-side tool starts executing (action:start event) */
     onServerToolStart?: (info: ServerToolInfo) => void;
     /** Called when a server-side tool receives args (action:args event) */
@@ -731,6 +788,9 @@ declare class AbstractChat<T extends UIMessage = UIMessage> {
     protected callbacks: ChatCallbacks<T>;
     protected optimizer: ChatContextOptimizer;
     protected lastContextUsage: ContextUsage | null;
+    private onCreateSession?;
+    private sessionInitPromise;
+    private sessionStatus;
     private eventHandlers;
     private streamState;
     constructor(init: ChatInit<T>);
@@ -880,6 +940,27 @@ declare class AbstractChat<T extends UIMessage = UIMessage> {
      * Set dynamic context (appended to system prompt)
      */
     setContext(context: string): void;
+    /**
+     * Switch to a different thread (or start a new one).
+     *
+     * - Pass the session/thread ID from persistence → used as-is, no session creation call.
+     * - Pass null → threadId cleared, new session created on first sendMessage.
+     *
+     * The session ID IS the thread ID: whatever is stored in persistence is passed here directly.
+     */
+    setActiveThread(id: string | null): void;
+    /**
+     * Force a new session to be created on the next sendMessage.
+     * Call this when the current session has expired or credits are exhausted.
+     * After calling this, the next sendMessage will invoke onCreateSession/yourgptConfig
+     * again and onThreadChange will fire with the new session ID.
+     */
+    renewSession(): void;
+    private setSessionStatus;
+    /**
+     * Get the current session creation status.
+     */
+    getSessionStatus(): "idle" | "creating" | "ready" | "error";
     /**
      * Set system prompt dynamically
      * This allows updating the system prompt after initialization
@@ -900,9 +981,17 @@ declare class AbstractChat<T extends UIMessage = UIMessage> {
      * Additional properties merged into every request body
      */
     setBody(body: ChatConfig["body"]): void;
+    /**
+     * Default session creation via yourgptConfig.
+     * Only called when yourgptConfig is set and no onCreateSession is provided.
+     * The returned session_uid IS the thread ID going forward.
+     */
+    private _defaultCreateSession;
     /**
      * Build the request payload
      */
+    /** Inline text-file attachments into message content for the LLM */
+    private inlineTextAttachments;
     protected buildRequest(): {
         messages: {
             role: string;
@@ -1337,8 +1426,39 @@ interface CopilotProviderProps {
     tools?: ToolsConfig;
     /** Thread ID for conversation persistence */
     threadId?: string;
+    /**
+     * Called once before the first message on a new thread to create a session.
+     * The returned value IS the thread ID — session and thread are the same identity.
+     * Only called when `threadId` is not set. If `threadId` is provided, this is skipped.
+     * Takes priority over `yourgptConfig`.
+     *
+     * @example
+     * ```tsx
+     * onCreateSession={async () => {
+     *   const res = await fetch('/api/sessions', { method: 'POST', headers })
+     *   return (await res.json()).id
+     * }}
+     * ```
+     */
+    onCreateSession?: () => string | Promise<string>;
+    /**
+     * Called when a new session/thread ID is assigned (new thread created).
+     * Use this to persist the session ID in your storage layer.
+     */
+    onThreadChange?: (id: string) => void;
+    /**
+     * YourGPT config — enables automatic session creation with zero boilerplate.
+     * The SDK calls YourGPT's createSession API before the first message and
+     * uses the returned session_uid as `threadId`.
+     *
+     * @example
+     * ```tsx
+     * yourgptConfig={{ apiKey: "your-api-key", widgetUid: widgetUid }}
+     * ```
+     */
+    yourgptConfig?: YourGPTConfig;
     /** Initial messages to populate the chat */
-    initialMessages?: Message[];
+    initialMessages?: UIMessage[];
     /** Callback when messages change */
     onMessagesChange?: (messages: Message[]) => void;
     /** Callback when an error occurs */
@@ -1443,6 +1563,19 @@ interface CopilotContextValue {
     }>) => void;
     agentIteration: number;
     threadId?: string;
+    /**
+     * Switch to a different thread (or start a new one).
+     * Pass the session/thread ID from persistence to reuse it (no new session call),
+     * or null to start a fresh thread (new session created on first sendMessage).
+     */
+    setActiveThread: (id: string | null) => void;
+    /**
+     * Force a new session to be created on the next sendMessage.
+     * Call when the current session has expired or credits are exhausted.
+     */
+    renewSession: () => void;
+    /** Current session creation status */
+    sessionStatus: "idle" | "creating" | "ready" | "error";
     /**
      * Runtime URL configuration.
      * Can be a static string or getter function (matches what was passed to provider).
@@ -1469,7 +1602,7 @@ interface CopilotContextValue {
     messageMeta: MessageMetaStore;
 }
 declare function useCopilot(): CopilotContextValue;
-declare function CopilotProvider({ children, runtimeUrl, systemPrompt, tools: toolsConfig, threadId, initialMessages, onMessagesChange, onError, streaming, headers, body, debug, maxIterations, maxIterationsMessage, mcpServers, optimization, messageHistory, skills, }: CopilotProviderProps): react_jsx_runtime.JSX.Element;
+declare function CopilotProvider(props: CopilotProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Chat UI state interface (UI-only state, not message data)
@@ -2722,6 +2855,71 @@ interface UseThreadManagerReturn {
  */
 declare function useThreadManager(config?: UseThreadManagerConfig): UseThreadManagerReturn;
 
+/**
+ * useThread — Session/thread management hook
+ *
+ * Provides clean semantics for managing the active session/thread.
+ * When yourgptConfig or onCreateSession is configured, the session ID
+ * IS the thread ID — they are the same identity.
+ *
+ * Use this hook instead of calling setActiveThread/renewSession directly.
+ */
+interface UseThreadReturn {
+    /**
+     * Current session/thread ID.
+     * undefined until the first session is created (new thread not yet sent).
+     */
+    threadId: string | undefined;
+    /**
+     * Current session creation status.
+     * - "idle"     — no session config, or threadId already set
+     * - "creating" — session creation request in flight
+     * - "ready"    — threadId is set and usable
+     * - "error"    — session creation failed
+     */
+    sessionStatus: "idle" | "creating" | "ready" | "error";
+    /**
+     * Switch to an existing thread/session.
+     * Pass the session ID from your persistence layer — it is used as-is,
+     * no new session creation call is made.
+     */
+    switchThread: (sessionId: string) => void;
+    /**
+     * Start a fresh thread.
+     * Clears the current session; a new session is created on the next sendMessage.
+     * onThreadChange fires with the new session ID once it is assigned.
+     */
+    newThread: () => void;
+    /**
+     * Force a new session to be created on the next sendMessage.
+     * Call this when the current session has expired or credits are exhausted.
+     * onThreadChange fires with the new session ID once it is assigned.
+     */
+    renewSession: () => void;
+}
+/**
+ * useThread — Clean hook for session/thread management
+ *
+ * @example
+ * ```tsx
+ * function ChatHeader() {
+ *   const { threadId, sessionStatus, newThread, switchThread, renewSession } = useThread();
+ *
+ *   const loadThread = (stored: { sessionId: string }) => {
+ *     switchThread(stored.sessionId);   // session ID IS the thread ID
+ *   };
+ *
+ *   return (
+ *     <>
+ *       {sessionStatus === "creating" && <Spinner />}
+ *       <button onClick={newThread}>New Chat</button>
+ *     </>
+ *   );
+ * }
+ * ```
+ */
+declare function useThread(): UseThreadReturn;
+
 /**
  * React hook for managing an MCP client connection
  *
@@ -3159,6 +3357,10 @@ interface ReactChatConfig {
     llm?: ChatConfig["llm"];
     /** Thread ID */
     threadId?: string;
+    /** Called once before first message to obtain a session/thread ID */
+    onCreateSession?: () => string | Promise<string>;
+    /** YourGPT config — enables automatic session creation */
+    yourgptConfig?: YourGPTConfig;
     /** Enable streaming (default: true) */
     streaming?: boolean;
     /** Request headers */
@@ -3472,4 +3674,4 @@ interface UseMessageMetaReturn<T extends Record<string, unknown>> {
  */
 declare function useMessageMeta<T extends Record<string, unknown> = Record<string, unknown>>(messageId: string | undefined): UseMessageMetaReturn<T>;
 
-export { type AIContextItem, AbstractAgentLoop, AbstractChat, ActionDefinition, type AgentLoopActions, type AgentLoopCallbacks, type AgentLoopState, AsyncThreadStorageAdapter, BranchInfo, type CapabilitiesResponse, CapturedContext, type ChatActions, type ChatCallbacks, type ChatConfig, type ChatState, type ChatStatus, type ToolExecution as ChatToolExecution, type ToolResponse as ChatToolResponse, type CombinedChatState, type CompactedToolResult, type CompactionEvent, type CompactionMarker, type CompactionStrategy, type ContextStats, ContextUsage, type CopilotContextValue, CopilotProvider, type CopilotProviderProps, type AgentLoopState$1 as CoreAgentLoopState, type ChatState$1 as CoreChatState, type DevLoggerState, type DisplayMessage, IntentDetectionResult, type KnowledgeBaseConfig, type KnowledgeBaseResult, type KnowledgeBaseSearchResponse, LLMConfig, type LLMMessage, Message, type MessageCheckpoint, type MessageHistoryConfig, MessageHistoryContext, type MessageHistoryContextValue, MessageMetaStore, type MessageTokenUsage, PermissionLevel, PermissionStorageAdapter, PermissionStorageConfig, type ProviderCapabilities, ReactChat, type ReactChatConfig, ReactChatState, ReactThreadManager, type ReactThreadManagerConfig, ReactThreadManagerState, ResolvedSkill, type ServerAdapterConfig, type SessionCompactionState, SkillDefinition, SkillProvider, type SkillProviderProps, Source, type StreamChunkWithMessageId, type StreamEventHandler, type Suggestion, Thread, ThreadData, type TokenUsage, ToolConsentRequest, ToolConsentResponse, ToolContext, ToolDefinition, ToolExecution$1 as ToolExecution, ToolResponse$1 as ToolResponse, ToolSet, ToolType, type ToolsActions, ToolsConfig, type ToolsState, UIMessage, UnifiedToolCall, type UseAIToolsOptions, type UseAIToolsReturn, type UseAgentOptions, type UseAgentReturn, type UseChatConfig, type UseChatReturn, type UseKnowledgeBaseConfig, UseMCPClientConfig, UseMCPClientReturn, UseMCPToolsConfig, UseMCPToolsReturn, UseMCPUIIntentsConfig, UseMCPUIIntentsReturn, type UseMessageCheckpointsReturn, type UseMessageHistoryOptions, type UseMessageHistoryReturn, type UseMessageMetaReturn, type UseSkillStatusReturn, type UseSuggestionsOptions, type UseSuggestionsReturn, type UseThreadManagerConfig, type UseThreadManagerReturn, type UseToolConfig, type UseToolExecutorReturn, type UseToolWithSchemaConfig, createMessageIntentHandler, createPermissionStorage, createReactChat, createReactChatState, createReactThreadManager, createReactThreadManagerState, createServerAdapter, createSessionPermissionCache, createToolIntentHandler, defaultMessageHistoryConfig, defineSkill, formatKnowledgeResultsForAI, initialAgentLoopState, isCompactionMarker, keepToolPairsAtomic, searchKnowledgeBase, toDisplayMessage, toLLMMessage, toLLMMessages, useAIAction, useAIActions, useAIContext, useAIContexts, useAITools, useAgent, useCapabilities, useChat, useContextStats, useCopilot, useCopilotEvent, useDevLogger, useFeatureSupport, useKnowledgeBase, useMCPClient, useMCPTools, useMCPUIIntents, useMessageCheckpoints, useMessageHistory, useMessageHistoryContext, useMessageMeta, useSkill, useSkillStatus, useSuggestions, useSupportedMediaTypes, useThreadManager, useTool, useToolExecutor, useToolWithSchema, useTools, useToolsWithSchema };
+export { type AIContextItem, AbstractAgentLoop, AbstractChat, ActionDefinition, type AgentLoopActions, type AgentLoopCallbacks, type AgentLoopState, AsyncThreadStorageAdapter, BranchInfo, type CapabilitiesResponse, CapturedContext, type ChatActions, type ChatCallbacks, type ChatConfig, type ChatState, type ChatStatus, type ToolExecution as ChatToolExecution, type ToolResponse as ChatToolResponse, type CombinedChatState, type CompactedToolResult, type CompactionEvent, type CompactionMarker, type CompactionStrategy, type ContextStats, ContextUsage, type CopilotContextValue, CopilotProvider, type CopilotProviderProps, type AgentLoopState$1 as CoreAgentLoopState, type ChatState$1 as CoreChatState, type DevLoggerState, type DisplayMessage, IntentDetectionResult, type KnowledgeBaseConfig, type KnowledgeBaseResult, type KnowledgeBaseSearchResponse, LLMConfig, type LLMMessage, Message, type MessageCheckpoint, type MessageHistoryConfig, MessageHistoryContext, type MessageHistoryContextValue, MessageMetaStore, type MessageTokenUsage, PermissionLevel, PermissionStorageAdapter, PermissionStorageConfig, type ProviderCapabilities, ReactChat, type ReactChatConfig, ReactChatState, ReactThreadManager, type ReactThreadManagerConfig, ReactThreadManagerState, ResolvedSkill, type ServerAdapterConfig, type SessionCompactionState, SkillDefinition, SkillProvider, type SkillProviderProps, Source, type StreamChunkWithMessageId, type StreamEventHandler, type Suggestion, Thread, ThreadData, type TokenUsage, ToolConsentRequest, ToolConsentResponse, ToolContext, ToolDefinition, ToolExecution$1 as ToolExecution, ToolResponse$1 as ToolResponse, ToolSet, ToolType, type ToolsActions, ToolsConfig, type ToolsState, UIMessage, UnifiedToolCall, type UseAIToolsOptions, type UseAIToolsReturn, type UseAgentOptions, type UseAgentReturn, type UseChatConfig, type UseChatReturn, type UseKnowledgeBaseConfig, UseMCPClientConfig, UseMCPClientReturn, UseMCPToolsConfig, UseMCPToolsReturn, UseMCPUIIntentsConfig, UseMCPUIIntentsReturn, type UseMessageCheckpointsReturn, type UseMessageHistoryOptions, type UseMessageHistoryReturn, type UseMessageMetaReturn, type UseSkillStatusReturn, type UseSuggestionsOptions, type UseSuggestionsReturn, type UseThreadManagerConfig, type UseThreadManagerReturn, type UseThreadReturn, type UseToolConfig, type UseToolExecutorReturn, type UseToolWithSchemaConfig, createMessageIntentHandler, createPermissionStorage, createReactChat, createReactChatState, createReactThreadManager, createReactThreadManagerState, createServerAdapter, createSessionPermissionCache, createToolIntentHandler, defaultMessageHistoryConfig, defineSkill, formatKnowledgeResultsForAI, initialAgentLoopState, isCompactionMarker, keepToolPairsAtomic, searchKnowledgeBase, toDisplayMessage, toLLMMessage, toLLMMessages, useAIAction, useAIActions, useAIContext, useAIContexts, useAITools, useAgent, useCapabilities, useChat, useContextStats, useCopilot, useCopilotEvent, useDevLogger, useFeatureSupport, useKnowledgeBase, useMCPClient, useMCPTools, useMCPUIIntents, useMessageCheckpoints, useMessageHistory, useMessageHistoryContext, useMessageMeta, useSkill, useSkillStatus, useSuggestions, useSupportedMediaTypes, useThread, useThreadManager, useTool, useToolExecutor, useToolWithSchema, useTools, useToolsWithSchema };