@yourgpt/copilot-sdk 2.5.1-beta.0 → 2.5.2-alpha.0

package/dist/experimental/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunk5EGBIQYS_cjs = require('../chunk-5EGBIQYS.cjs');
-var chunkZYLHGNIG_cjs = require('../chunk-ZYLHGNIG.cjs');
+var chunkGW5ZZHJ7_cjs = require('../chunk-GW5ZZHJ7.cjs');
 require('../chunk-7GWEW2DU.cjs');
 require('../chunk-JGPDQDY4.cjs');
 require('../chunk-BJYA5NDL.cjs');
@@ -530,7 +530,7 @@ function useGenerativeUI(config = {}) {
   const toolName = config.name ?? "render_ui";
   const configRef = React__namespace.useRef(config);
   configRef.current = config;
-  chunkZYLHGNIG_cjs.useTool({
+  chunkGW5ZZHJ7_cjs.useTool({
     name: toolName,
     description: "Renders a rich UI component inline in the chat. Handled automatically by the SDK.",
     inputSchema: RENDER_UI_SCHEMA,

package/dist/experimental/index.js

@@ -1,5 +1,5 @@
 import { cn, DotsLoader } from '../chunk-TXQ37MAO.js';
-import { useTool } from '../chunk-JPUKXFR4.js';
+import { useTool } from '../chunk-37HN4F6S.js';
 import '../chunk-J5D3AZF6.js';
 import '../chunk-EWVQWTNV.js';
 import '../chunk-VNLLW3ZI.js';

package/dist/react/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunk6R63NBNP_cjs = require('../chunk-6R63NBNP.cjs');
-var chunkZYLHGNIG_cjs = require('../chunk-ZYLHGNIG.cjs');
+var chunk4PL7TK42_cjs = require('../chunk-4PL7TK42.cjs');
+var chunkGW5ZZHJ7_cjs = require('../chunk-GW5ZZHJ7.cjs');
 var chunk7GWEW2DU_cjs = require('../chunk-7GWEW2DU.cjs');
 require('../chunk-JGPDQDY4.cjs');
 require('../chunk-BJYA5NDL.cjs');
@@ -22,243 +22,243 @@ require('../chunk-JEQ2X3Z6.cjs');
 
 Object.defineProperty(exports, "ReactChat", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.ReactChat; }
+  get: function () { return chunk4PL7TK42_cjs.ReactChat; }
 });
 Object.defineProperty(exports, "ReactThreadManager", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.ReactThreadManager; }
+  get: function () { return chunk4PL7TK42_cjs.ReactThreadManager; }
 });
 Object.defineProperty(exports, "ReactThreadManagerState", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.ReactThreadManagerState; }
+  get: function () { return chunk4PL7TK42_cjs.ReactThreadManagerState; }
 });
 Object.defineProperty(exports, "createMessageIntentHandler", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.createMessageIntentHandler; }
+  get: function () { return chunk4PL7TK42_cjs.createMessageIntentHandler; }
 });
 Object.defineProperty(exports, "createPermissionStorage", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.createPermissionStorage; }
+  get: function () { return chunk4PL7TK42_cjs.createPermissionStorage; }
 });
 Object.defineProperty(exports, "createReactChat", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.createReactChat; }
+  get: function () { return chunk4PL7TK42_cjs.createReactChat; }
 });
 Object.defineProperty(exports, "createReactThreadManager", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.createReactThreadManager; }
+  get: function () { return chunk4PL7TK42_cjs.createReactThreadManager; }
 });
 Object.defineProperty(exports, "createReactThreadManagerState", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.createReactThreadManagerState; }
+  get: function () { return chunk4PL7TK42_cjs.createReactThreadManagerState; }
 });
 Object.defineProperty(exports, "createSessionPermissionCache", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.createSessionPermissionCache; }
+  get: function () { return chunk4PL7TK42_cjs.createSessionPermissionCache; }
 });
 Object.defineProperty(exports, "createToolIntentHandler", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.createToolIntentHandler; }
+  get: function () { return chunk4PL7TK42_cjs.createToolIntentHandler; }
 });
 Object.defineProperty(exports, "defineSkill", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.defineSkill; }
+  get: function () { return chunk4PL7TK42_cjs.defineSkill; }
 });
 Object.defineProperty(exports, "formatKnowledgeResultsForAI", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.formatKnowledgeResultsForAI; }
+  get: function () { return chunk4PL7TK42_cjs.formatKnowledgeResultsForAI; }
 });
 Object.defineProperty(exports, "searchKnowledgeBase", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.searchKnowledgeBase; }
+  get: function () { return chunk4PL7TK42_cjs.searchKnowledgeBase; }
 });
 Object.defineProperty(exports, "useAIAction", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useAIAction; }
+  get: function () { return chunk4PL7TK42_cjs.useAIAction; }
 });
 Object.defineProperty(exports, "useAIActions", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useAIActions; }
+  get: function () { return chunk4PL7TK42_cjs.useAIActions; }
 });
 Object.defineProperty(exports, "useAITools", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useAITools; }
+  get: function () { return chunk4PL7TK42_cjs.useAITools; }
 });
 Object.defineProperty(exports, "useAgent", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useAgent; }
+  get: function () { return chunk4PL7TK42_cjs.useAgent; }
 });
 Object.defineProperty(exports, "useCapabilities", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useCapabilities; }
+  get: function () { return chunk4PL7TK42_cjs.useCapabilities; }
 });
 Object.defineProperty(exports, "useChat", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useChat; }
+  get: function () { return chunk4PL7TK42_cjs.useChat; }
 });
 Object.defineProperty(exports, "useContextStats", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useContextStats; }
+  get: function () { return chunk4PL7TK42_cjs.useContextStats; }
 });
 Object.defineProperty(exports, "useCopilotEvent", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useCopilotEvent; }
+  get: function () { return chunk4PL7TK42_cjs.useCopilotEvent; }
 });
 Object.defineProperty(exports, "useDevLogger", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useDevLogger; }
+  get: function () { return chunk4PL7TK42_cjs.useDevLogger; }
 });
 Object.defineProperty(exports, "useFeatureSupport", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useFeatureSupport; }
+  get: function () { return chunk4PL7TK42_cjs.useFeatureSupport; }
 });
 Object.defineProperty(exports, "useKnowledgeBase", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useKnowledgeBase; }
+  get: function () { return chunk4PL7TK42_cjs.useKnowledgeBase; }
 });
 Object.defineProperty(exports, "useMCPUIIntents", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useMCPUIIntents; }
+  get: function () { return chunk4PL7TK42_cjs.useMCPUIIntents; }
 });
 Object.defineProperty(exports, "useMessageCheckpoints", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useMessageCheckpoints; }
+  get: function () { return chunk4PL7TK42_cjs.useMessageCheckpoints; }
 });
 Object.defineProperty(exports, "useMessageMeta", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useMessageMeta; }
+  get: function () { return chunk4PL7TK42_cjs.useMessageMeta; }
 });
 Object.defineProperty(exports, "useSkill", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useSkill; }
+  get: function () { return chunk4PL7TK42_cjs.useSkill; }
 });
 Object.defineProperty(exports, "useSkillStatus", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useSkillStatus; }
+  get: function () { return chunk4PL7TK42_cjs.useSkillStatus; }
 });
 Object.defineProperty(exports, "useSuggestions", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useSuggestions; }
+  get: function () { return chunk4PL7TK42_cjs.useSuggestions; }
 });
 Object.defineProperty(exports, "useSupportedMediaTypes", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useSupportedMediaTypes; }
+  get: function () { return chunk4PL7TK42_cjs.useSupportedMediaTypes; }
 });
 Object.defineProperty(exports, "useThread", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useThread; }
+  get: function () { return chunk4PL7TK42_cjs.useThread; }
 });
 Object.defineProperty(exports, "useThreadManager", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useThreadManager; }
+  get: function () { return chunk4PL7TK42_cjs.useThreadManager; }
 });
 Object.defineProperty(exports, "useToolExecutor", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useToolExecutor; }
+  get: function () { return chunk4PL7TK42_cjs.useToolExecutor; }
 });
 Object.defineProperty(exports, "useToolWithSchema", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useToolWithSchema; }
+  get: function () { return chunk4PL7TK42_cjs.useToolWithSchema; }
 });
 Object.defineProperty(exports, "useToolsWithSchema", {
   enumerable: true,
-  get: function () { return chunk6R63NBNP_cjs.useToolsWithSchema; }
+  get: function () { return chunk4PL7TK42_cjs.useToolsWithSchema; }
 });
 Object.defineProperty(exports, "AbstractAgentLoop", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.AbstractAgentLoop; }
+  get: function () { return chunkGW5ZZHJ7_cjs.AbstractAgentLoop; }
 });
 Object.defineProperty(exports, "AbstractChat", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.AbstractChat; }
+  get: function () { return chunkGW5ZZHJ7_cjs.AbstractChat; }
 });
 Object.defineProperty(exports, "CopilotProvider", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.CopilotProvider; }
+  get: function () { return chunkGW5ZZHJ7_cjs.CopilotProvider; }
 });
 Object.defineProperty(exports, "MessageHistoryContext", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.MessageHistoryContext; }
+  get: function () { return chunkGW5ZZHJ7_cjs.MessageHistoryContext; }
 });
 Object.defineProperty(exports, "MessageTree", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.MessageTree; }
+  get: function () { return chunkGW5ZZHJ7_cjs.MessageTree; }
 });
 Object.defineProperty(exports, "ReactChatState", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.ReactChatState; }
+  get: function () { return chunkGW5ZZHJ7_cjs.ReactChatState; }
 });
 Object.defineProperty(exports, "SkillProvider", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.SkillProvider; }
+  get: function () { return chunkGW5ZZHJ7_cjs.SkillProvider; }
 });
 Object.defineProperty(exports, "createReactChatState", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.createReactChatState; }
+  get: function () { return chunkGW5ZZHJ7_cjs.createReactChatState; }
 });
 Object.defineProperty(exports, "defaultMessageHistoryConfig", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.defaultMessageHistoryConfig; }
+  get: function () { return chunkGW5ZZHJ7_cjs.defaultMessageHistoryConfig; }
 });
 Object.defineProperty(exports, "initialAgentLoopState", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.initialAgentLoopState; }
+  get: function () { return chunkGW5ZZHJ7_cjs.initialAgentLoopState; }
 });
 Object.defineProperty(exports, "isCompactionMarker", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.isCompactionMarker; }
+  get: function () { return chunkGW5ZZHJ7_cjs.isCompactionMarker; }
 });
 Object.defineProperty(exports, "keepToolPairsAtomic", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.keepToolPairsAtomic; }
+  get: function () { return chunkGW5ZZHJ7_cjs.keepToolPairsAtomic; }
 });
 Object.defineProperty(exports, "toDisplayMessage", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.toDisplayMessage; }
+  get: function () { return chunkGW5ZZHJ7_cjs.toDisplayMessage; }
 });
 Object.defineProperty(exports, "toLLMMessage", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.toLLMMessage; }
+  get: function () { return chunkGW5ZZHJ7_cjs.toLLMMessage; }
 });
 Object.defineProperty(exports, "toLLMMessages", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.toLLMMessages; }
+  get: function () { return chunkGW5ZZHJ7_cjs.toLLMMessages; }
 });
 Object.defineProperty(exports, "useAIContext", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.useAIContext; }
+  get: function () { return chunkGW5ZZHJ7_cjs.useAIContext; }
 });
 Object.defineProperty(exports, "useAIContexts", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.useAIContexts; }
+  get: function () { return chunkGW5ZZHJ7_cjs.useAIContexts; }
 });
 Object.defineProperty(exports, "useCopilot", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.useCopilot; }
+  get: function () { return chunkGW5ZZHJ7_cjs.useCopilot; }
 });
 Object.defineProperty(exports, "useMCPClient", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.useMCPClient; }
+  get: function () { return chunkGW5ZZHJ7_cjs.useMCPClient; }
 });
 Object.defineProperty(exports, "useMCPTools", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.useMCPTools; }
+  get: function () { return chunkGW5ZZHJ7_cjs.useMCPTools; }
 });
 Object.defineProperty(exports, "useMessageHistory", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.useMessageHistory; }
+  get: function () { return chunkGW5ZZHJ7_cjs.useMessageHistory; }
 });
 Object.defineProperty(exports, "useMessageHistoryContext", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.useMessageHistoryContext; }
+  get: function () { return chunkGW5ZZHJ7_cjs.useMessageHistoryContext; }
 });
 Object.defineProperty(exports, "useTool", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.useTool; }
+  get: function () { return chunkGW5ZZHJ7_cjs.useTool; }
 });
 Object.defineProperty(exports, "useTools", {
   enumerable: true,
-  get: function () { return chunkZYLHGNIG_cjs.useTools; }
+  get: function () { return chunkGW5ZZHJ7_cjs.useTools; }
 });
 Object.defineProperty(exports, "createLocalStorageAdapter", {
   enumerable: true,

package/dist/react/index.d.cts

@@ -665,6 +665,13 @@ interface AgentLoopConfig {
     tools?: ToolDefinition[];
     /** Max tool executions to keep in memory (default: 100). Oldest are pruned. */
     maxExecutionHistory?: number;
+    /**
+     * Returns the current thread id for tool handler context. Called once per
+     * tool invocation. Needed by consumers that need to scope per-tool state
+     * (e.g. per-thread browser-tab pinning in the Chrome extension). When
+     * omitted, `context.threadId` is undefined in handlers.
+     */
+    getThreadId?: () => string | undefined;
 }
 /**
  * Agent loop callbacks
@@ -808,6 +815,8 @@ declare class AbstractChat<T extends UIMessage = UIMessage> {
     get status(): ChatStatus$1;
     get error(): Error | undefined;
     get isStreaming(): boolean;
+    /** The thread id currently associated with this chat, if any. */
+    get threadId(): string | undefined;
     /**
      * Check if a request is currently in progress
      */
@@ -1516,6 +1525,23 @@ interface CopilotProviderProps {
      * Only inline skills (source.type === "inline") are supported client-side.
      */
     skills?: SkillDefinition[];
+    /**
+     * Allow multiple threads to stream concurrently. When enabled, switching away
+     * from a thread that is still generating does NOT cancel its request — it
+     * continues in the background. You can also start a new send on a different
+     * thread while another is still streaming.
+     *
+     * When enabled:
+     *   - `useCopilot().messages/status/error` always reflect the ACTIVE thread.
+     *   - A new `busyThreadIds` set reflects every thread currently streaming.
+     *   - The provider maintains one `ReactChatWithTools` instance per thread.
+     *
+     * When `onCreateSession` is provided, it may be called concurrently for
+     * different threads — ensure each call produces a distinct session id.
+     *
+     * @default false
+     */
+    concurrentThreads?: boolean;
 }
 type StreamChunkWithMessageId = StreamChunk & {
     messageId?: string;
@@ -1588,8 +1614,16 @@ interface CopilotContextValue {
      * 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;
+     *
+     * When `concurrentThreads` is enabled on the provider, `opts.hydrateMessages`
+     * is applied when the target instance is being created fresh (not yet
+     * streaming). It is ignored if the instance already exists (which would
+     * mean a stream is in-flight or completed) to avoid clobbering state.
+     */
+    setActiveThread: (id: string | null, opts?: {
+        hydrateMessages?: UIMessage[];
+        hydrateActiveLeafId?: string;
+    }) => void;
     /**
      * Force a new session to be created on the next sendMessage.
      * Call when the current session has expired or credits are exhausted.
@@ -1621,6 +1655,44 @@ interface CopilotContextValue {
      * Use useMessageMeta(messageId) for the hook API.
      */
     messageMeta: MessageMetaStore;
+    /**
+     * Whether concurrent-thread streaming is enabled (via the `concurrentThreads`
+     * prop on CopilotProvider). When false, the provider uses a single chat
+     * instance and inactive threads cannot stream. When true, each thread has
+     * its own instance and streams in the background on switch.
+     */
+    concurrentThreads: boolean;
+    /**
+     * The set of thread IDs that currently have an in-flight request
+     * (status "submitted" or "streaming"). Always empty when `concurrentThreads`
+     * is false. UI can use this to render per-thread busy indicators in a
+     * thread picker.
+     */
+    busyThreadIds: ReadonlySet<string>;
+    /**
+     * Reactive map of per-thread pending tool approvals. Key = thread id,
+     * value = ToolExecutions whose approvalStatus is "required". Empty when
+     * `concurrentThreads` is false. UI can use this to light up indicators
+     * on background threads that are blocked waiting for the user to approve
+     * or reject a tool — the approval card only renders on the active thread,
+     * so without this, a background thread's block is invisible.
+     */
+    pendingApprovalsByThread: ReadonlyMap<string, ToolExecution[]>;
+    /**
+     * Dispose the chat instance backing a given thread ID and remove it from
+     * the registry. Aborts its in-flight stream if any. Call this when a
+     * thread is deleted so its background stream doesn't keep running.
+     * No-op when `concurrentThreads` is false.
+     */
+    disposeThreadInstance: (threadId: string) => void;
+    /**
+     * Commit a locally-generated thread id to the currently-active pending
+     * chat instance. Used by persistence hooks (e.g. useInternalThreadManager)
+     * to make a just-started thread visible in the picker immediately, without
+     * waiting for the server to assign its session id. No-op when
+     * `concurrentThreads` is false or the active instance is not a pending slot.
+     */
+    assignLocalThreadId: (localId: string) => void;
 }
 declare function useCopilot(): CopilotContextValue;
 declare function CopilotProvider(props: CopilotProviderProps): react_jsx_runtime.JSX.Element;

package/dist/react/index.d.ts

@@ -665,6 +665,13 @@ interface AgentLoopConfig {
     tools?: ToolDefinition[];
     /** Max tool executions to keep in memory (default: 100). Oldest are pruned. */
     maxExecutionHistory?: number;
+    /**
+     * Returns the current thread id for tool handler context. Called once per
+     * tool invocation. Needed by consumers that need to scope per-tool state
+     * (e.g. per-thread browser-tab pinning in the Chrome extension). When
+     * omitted, `context.threadId` is undefined in handlers.
+     */
+    getThreadId?: () => string | undefined;
 }
 /**
  * Agent loop callbacks
@@ -808,6 +815,8 @@ declare class AbstractChat<T extends UIMessage = UIMessage> {
     get status(): ChatStatus$1;
     get error(): Error | undefined;
     get isStreaming(): boolean;
+    /** The thread id currently associated with this chat, if any. */
+    get threadId(): string | undefined;
     /**
      * Check if a request is currently in progress
      */
@@ -1516,6 +1525,23 @@ interface CopilotProviderProps {
      * Only inline skills (source.type === "inline") are supported client-side.
      */
     skills?: SkillDefinition[];
+    /**
+     * Allow multiple threads to stream concurrently. When enabled, switching away
+     * from a thread that is still generating does NOT cancel its request — it
+     * continues in the background. You can also start a new send on a different
+     * thread while another is still streaming.
+     *
+     * When enabled:
+     *   - `useCopilot().messages/status/error` always reflect the ACTIVE thread.
+     *   - A new `busyThreadIds` set reflects every thread currently streaming.
+     *   - The provider maintains one `ReactChatWithTools` instance per thread.
+     *
+     * When `onCreateSession` is provided, it may be called concurrently for
+     * different threads — ensure each call produces a distinct session id.
+     *
+     * @default false
+     */
+    concurrentThreads?: boolean;
 }
 type StreamChunkWithMessageId = StreamChunk & {
     messageId?: string;
@@ -1588,8 +1614,16 @@ interface CopilotContextValue {
      * 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;
+     *
+     * When `concurrentThreads` is enabled on the provider, `opts.hydrateMessages`
+     * is applied when the target instance is being created fresh (not yet
+     * streaming). It is ignored if the instance already exists (which would
+     * mean a stream is in-flight or completed) to avoid clobbering state.
+     */
+    setActiveThread: (id: string | null, opts?: {
+        hydrateMessages?: UIMessage[];
+        hydrateActiveLeafId?: string;
+    }) => void;
     /**
      * Force a new session to be created on the next sendMessage.
      * Call when the current session has expired or credits are exhausted.
@@ -1621,6 +1655,44 @@ interface CopilotContextValue {
      * Use useMessageMeta(messageId) for the hook API.
      */
     messageMeta: MessageMetaStore;
+    /**
+     * Whether concurrent-thread streaming is enabled (via the `concurrentThreads`
+     * prop on CopilotProvider). When false, the provider uses a single chat
+     * instance and inactive threads cannot stream. When true, each thread has
+     * its own instance and streams in the background on switch.
+     */
+    concurrentThreads: boolean;
+    /**
+     * The set of thread IDs that currently have an in-flight request
+     * (status "submitted" or "streaming"). Always empty when `concurrentThreads`
+     * is false. UI can use this to render per-thread busy indicators in a
+     * thread picker.
+     */
+    busyThreadIds: ReadonlySet<string>;
+    /**
+     * Reactive map of per-thread pending tool approvals. Key = thread id,
+     * value = ToolExecutions whose approvalStatus is "required". Empty when
+     * `concurrentThreads` is false. UI can use this to light up indicators
+     * on background threads that are blocked waiting for the user to approve
+     * or reject a tool — the approval card only renders on the active thread,
+     * so without this, a background thread's block is invisible.
+     */
+    pendingApprovalsByThread: ReadonlyMap<string, ToolExecution[]>;
+    /**
+     * Dispose the chat instance backing a given thread ID and remove it from
+     * the registry. Aborts its in-flight stream if any. Call this when a
+     * thread is deleted so its background stream doesn't keep running.
+     * No-op when `concurrentThreads` is false.
+     */
+    disposeThreadInstance: (threadId: string) => void;
+    /**
+     * Commit a locally-generated thread id to the currently-active pending
+     * chat instance. Used by persistence hooks (e.g. useInternalThreadManager)
+     * to make a just-started thread visible in the picker immediately, without
+     * waiting for the server to assign its session id. No-op when
+     * `concurrentThreads` is false or the active instance is not a pending slot.
+     */
+    assignLocalThreadId: (localId: string) => void;
 }
 declare function useCopilot(): CopilotContextValue;
 declare function CopilotProvider(props: CopilotProviderProps): react_jsx_runtime.JSX.Element;

package/dist/react/index.js

@@ -1,5 +1,5 @@
-export { ReactChat, ReactThreadManager, ReactThreadManagerState, createMessageIntentHandler, createPermissionStorage, createReactChat, createReactThreadManager, createReactThreadManagerState, createSessionPermissionCache, createToolIntentHandler, defineSkill, formatKnowledgeResultsForAI, searchKnowledgeBase, useAIAction, useAIActions, useAITools, useAgent, useCapabilities, useChat, useContextStats, useCopilotEvent, useDevLogger, useFeatureSupport, useKnowledgeBase, useMCPUIIntents, useMessageCheckpoints, useMessageMeta, useSkill, useSkillStatus, useSuggestions, useSupportedMediaTypes, useThread, useThreadManager, useToolExecutor, useToolWithSchema, useToolsWithSchema } from '../chunk-YYLTWY5R.js';
-export { AbstractAgentLoop, AbstractChat, CopilotProvider, MessageHistoryContext, MessageTree, ReactChatState, SkillProvider, createReactChatState, defaultMessageHistoryConfig, initialAgentLoopState, isCompactionMarker, keepToolPairsAtomic, toDisplayMessage, toLLMMessage, toLLMMessages, useAIContext, useAIContexts, useCopilot, useMCPClient, useMCPTools, useMessageHistory, useMessageHistoryContext, useTool, useTools } from '../chunk-JPUKXFR4.js';
+export { ReactChat, ReactThreadManager, ReactThreadManagerState, createMessageIntentHandler, createPermissionStorage, createReactChat, createReactThreadManager, createReactThreadManagerState, createSessionPermissionCache, createToolIntentHandler, defineSkill, formatKnowledgeResultsForAI, searchKnowledgeBase, useAIAction, useAIActions, useAITools, useAgent, useCapabilities, useChat, useContextStats, useCopilotEvent, useDevLogger, useFeatureSupport, useKnowledgeBase, useMCPUIIntents, useMessageCheckpoints, useMessageMeta, useSkill, useSkillStatus, useSuggestions, useSupportedMediaTypes, useThread, useThreadManager, useToolExecutor, useToolWithSchema, useToolsWithSchema } from '../chunk-VHJ46HKC.js';
+export { AbstractAgentLoop, AbstractChat, CopilotProvider, MessageHistoryContext, MessageTree, ReactChatState, SkillProvider, createReactChatState, defaultMessageHistoryConfig, initialAgentLoopState, isCompactionMarker, keepToolPairsAtomic, toDisplayMessage, toLLMMessage, toLLMMessages, useAIContext, useAIContexts, useCopilot, useMCPClient, useMCPTools, useMessageHistory, useMessageHistoryContext, useTool, useTools } from '../chunk-37HN4F6S.js';
 export { createLocalStorageAdapter, createMemoryAdapter, createServerAdapter, generateSuggestionReason } from '../chunk-J5D3AZF6.js';
 import '../chunk-EWVQWTNV.js';
 import '../chunk-VNLLW3ZI.js';