@yourgpt/copilot-sdk 2.0.1 → 2.0.2-beta.2

package/dist/openai-7W2PCNW5.js

@@ -0,0 +1,4 @@
+export { openaiProvider, searchOpenAI, validateOpenAIConfig } from './chunk-VD74IPKB.js';
+import './chunk-DGUM43GV.js';
+//# sourceMappingURL=openai-7W2PCNW5.js.map
+//# sourceMappingURL=openai-7W2PCNW5.js.map

package/dist/openai-7W2PCNW5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"openai-7W2PCNW5.js"}

package/dist/openai-Cam8hF4f.d.ts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.js';
+
+/**
+ * OpenAI Web Search Provider
+ *
+ * Uses OpenAI's built-in web_search tool via the Responses API.
+ * No third-party API key required - uses your OpenAI API key.
+ *
+ * @see https://platform.openai.com/docs/guides/tools-web-search
+ */
+
+/**
+ * OpenAI native search provider implementation
+ */
+declare const openaiProvider: WebSearchProviderInterface;
+
+export { openaiProvider as o };

package/dist/openai-HVSCuXgO.d.cts

@@ -0,0 +1,17 @@
+import { W as WebSearchProviderInterface } from './types-ZguuKEs_.cjs';
+
+/**
+ * OpenAI Web Search Provider
+ *
+ * Uses OpenAI's built-in web_search tool via the Responses API.
+ * No third-party API key required - uses your OpenAI API key.
+ *
+ * @see https://platform.openai.com/docs/guides/tools-web-search
+ */
+
+/**
+ * OpenAI native search provider implementation
+ */
+declare const openaiProvider: WebSearchProviderInterface;
+
+export { openaiProvider as o };

package/dist/react/index.cjs

@@ -1,169 +1,202 @@
 'use strict';
 
-var chunkBLSI67J6_cjs = require('../chunk-BLSI67J6.cjs');
-var chunk4PRWNAXQ_cjs = require('../chunk-4PRWNAXQ.cjs');
+var chunkH5XMKBBA_cjs = require('../chunk-H5XMKBBA.cjs');
+var chunkUOWLKFXK_cjs = require('../chunk-UOWLKFXK.cjs');
+require('../chunk-7K7HZMP4.cjs');
+require('../chunk-UIWFYMAO.cjs');
+require('../chunk-CEKAYA2Q.cjs');
+require('../chunk-ASV6JLYG.cjs');
+require('../chunk-CBAHCI4R.cjs');
+require('../chunk-MEBXW75C.cjs');
+require('../chunk-W73FBYIH.cjs');
+require('../chunk-2FAWEBZS.cjs');
+require('../chunk-6T5XXJEP.cjs');
+require('../chunk-GANCV72Z.cjs');
+require('../chunk-XWOHNY3F.cjs');
+require('../chunk-TXLIY7GF.cjs');
+require('../chunk-JEQ2X3Z6.cjs');
 
 
 
 Object.defineProperty(exports, "AbstractAgentLoop", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.AbstractAgentLoop; }
+  get: function () { return chunkH5XMKBBA_cjs.AbstractAgentLoop; }
 });
 Object.defineProperty(exports, "AbstractChat", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.AbstractChat; }
+  get: function () { return chunkH5XMKBBA_cjs.AbstractChat; }
 });
 Object.defineProperty(exports, "CopilotProvider", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.CopilotProvider; }
+  get: function () { return chunkH5XMKBBA_cjs.CopilotProvider; }
 });
 Object.defineProperty(exports, "ReactChat", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.ReactChat; }
+  get: function () { return chunkH5XMKBBA_cjs.ReactChat; }
 });
 Object.defineProperty(exports, "ReactChatState", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.ReactChatState; }
+  get: function () { return chunkH5XMKBBA_cjs.ReactChatState; }
 });
 Object.defineProperty(exports, "ReactThreadManager", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.ReactThreadManager; }
+  get: function () { return chunkH5XMKBBA_cjs.ReactThreadManager; }
 });
 Object.defineProperty(exports, "ReactThreadManagerState", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.ReactThreadManagerState; }
+  get: function () { return chunkH5XMKBBA_cjs.ReactThreadManagerState; }
+});
+Object.defineProperty(exports, "createMessageIntentHandler", {
+  enumerable: true,
+  get: function () { return chunkH5XMKBBA_cjs.createMessageIntentHandler; }
 });
 Object.defineProperty(exports, "createPermissionStorage", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.createPermissionStorage; }
+  get: function () { return chunkH5XMKBBA_cjs.createPermissionStorage; }
 });
 Object.defineProperty(exports, "createReactChat", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.createReactChat; }
+  get: function () { return chunkH5XMKBBA_cjs.createReactChat; }
 });
 Object.defineProperty(exports, "createReactChatState", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.createReactChatState; }
+  get: function () { return chunkH5XMKBBA_cjs.createReactChatState; }
 });
 Object.defineProperty(exports, "createReactThreadManager", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.createReactThreadManager; }
+  get: function () { return chunkH5XMKBBA_cjs.createReactThreadManager; }
 });
 Object.defineProperty(exports, "createReactThreadManagerState", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.createReactThreadManagerState; }
+  get: function () { return chunkH5XMKBBA_cjs.createReactThreadManagerState; }
 });
 Object.defineProperty(exports, "createSessionPermissionCache", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.createSessionPermissionCache; }
+  get: function () { return chunkH5XMKBBA_cjs.createSessionPermissionCache; }
+});
+Object.defineProperty(exports, "createToolIntentHandler", {
+  enumerable: true,
+  get: function () { return chunkH5XMKBBA_cjs.createToolIntentHandler; }
 });
 Object.defineProperty(exports, "formatKnowledgeResultsForAI", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.formatKnowledgeResultsForAI; }
+  get: function () { return chunkH5XMKBBA_cjs.formatKnowledgeResultsForAI; }
 });
 Object.defineProperty(exports, "initialAgentLoopState", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.initialAgentLoopState; }
+  get: function () { return chunkH5XMKBBA_cjs.initialAgentLoopState; }
 });
 Object.defineProperty(exports, "searchKnowledgeBase", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.searchKnowledgeBase; }
+  get: function () { return chunkH5XMKBBA_cjs.searchKnowledgeBase; }
 });
 Object.defineProperty(exports, "useAIAction", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useAIAction; }
+  get: function () { return chunkH5XMKBBA_cjs.useAIAction; }
 });
 Object.defineProperty(exports, "useAIActions", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useAIActions; }
+  get: function () { return chunkH5XMKBBA_cjs.useAIActions; }
 });
 Object.defineProperty(exports, "useAIContext", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useAIContext; }
+  get: function () { return chunkH5XMKBBA_cjs.useAIContext; }
 });
 Object.defineProperty(exports, "useAIContexts", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useAIContexts; }
+  get: function () { return chunkH5XMKBBA_cjs.useAIContexts; }
 });
 Object.defineProperty(exports, "useAITools", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useAITools; }
+  get: function () { return chunkH5XMKBBA_cjs.useAITools; }
 });
 Object.defineProperty(exports, "useAgent", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useAgent; }
+  get: function () { return chunkH5XMKBBA_cjs.useAgent; }
 });
 Object.defineProperty(exports, "useCapabilities", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useCapabilities; }
+  get: function () { return chunkH5XMKBBA_cjs.useCapabilities; }
 });
 Object.defineProperty(exports, "useChat", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useChat; }
+  get: function () { return chunkH5XMKBBA_cjs.useChat; }
 });
 Object.defineProperty(exports, "useCopilot", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useCopilot; }
+  get: function () { return chunkH5XMKBBA_cjs.useCopilot; }
 });
 Object.defineProperty(exports, "useDevLogger", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useDevLogger; }
+  get: function () { return chunkH5XMKBBA_cjs.useDevLogger; }
 });
 Object.defineProperty(exports, "useFeatureSupport", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useFeatureSupport; }
+  get: function () { return chunkH5XMKBBA_cjs.useFeatureSupport; }
 });
 Object.defineProperty(exports, "useKnowledgeBase", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useKnowledgeBase; }
+  get: function () { return chunkH5XMKBBA_cjs.useKnowledgeBase; }
+});
+Object.defineProperty(exports, "useMCPClient", {
+  enumerable: true,
+  get: function () { return chunkH5XMKBBA_cjs.useMCPClient; }
+});
+Object.defineProperty(exports, "useMCPTools", {
+  enumerable: true,
+  get: function () { return chunkH5XMKBBA_cjs.useMCPTools; }
+});
+Object.defineProperty(exports, "useMCPUIIntents", {
+  enumerable: true,
+  get: function () { return chunkH5XMKBBA_cjs.useMCPUIIntents; }
 });
 Object.defineProperty(exports, "useSuggestions", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useSuggestions; }
+  get: function () { return chunkH5XMKBBA_cjs.useSuggestions; }
 });
 Object.defineProperty(exports, "useSupportedMediaTypes", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useSupportedMediaTypes; }
+  get: function () { return chunkH5XMKBBA_cjs.useSupportedMediaTypes; }
 });
 Object.defineProperty(exports, "useThreadManager", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useThreadManager; }
+  get: function () { return chunkH5XMKBBA_cjs.useThreadManager; }
 });
 Object.defineProperty(exports, "useTool", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useTool; }
+  get: function () { return chunkH5XMKBBA_cjs.useTool; }
 });
 Object.defineProperty(exports, "useToolExecutor", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useToolExecutor; }
+  get: function () { return chunkH5XMKBBA_cjs.useToolExecutor; }
 });
 Object.defineProperty(exports, "useToolWithSchema", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useToolWithSchema; }
+  get: function () { return chunkH5XMKBBA_cjs.useToolWithSchema; }
 });
 Object.defineProperty(exports, "useTools", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useTools; }
+  get: function () { return chunkH5XMKBBA_cjs.useTools; }
 });
 Object.defineProperty(exports, "useToolsWithSchema", {
   enumerable: true,
-  get: function () { return chunkBLSI67J6_cjs.useToolsWithSchema; }
+  get: function () { return chunkH5XMKBBA_cjs.useToolsWithSchema; }
 });
 Object.defineProperty(exports, "createLocalStorageAdapter", {
   enumerable: true,
-  get: function () { return chunk4PRWNAXQ_cjs.createLocalStorageAdapter; }
+  get: function () { return chunkUOWLKFXK_cjs.createLocalStorageAdapter; }
 });
 Object.defineProperty(exports, "createMemoryAdapter", {
   enumerable: true,
-  get: function () { return chunk4PRWNAXQ_cjs.createMemoryAdapter; }
+  get: function () { return chunkUOWLKFXK_cjs.createMemoryAdapter; }
 });
 Object.defineProperty(exports, "createServerAdapter", {
   enumerable: true,
-  get: function () { return chunk4PRWNAXQ_cjs.createServerAdapter; }
+  get: function () { return chunkUOWLKFXK_cjs.createServerAdapter; }
 });
 Object.defineProperty(exports, "generateSuggestionReason", {
   enumerable: true,
-  get: function () { return chunk4PRWNAXQ_cjs.generateSuggestionReason; }
+  get: function () { return chunkUOWLKFXK_cjs.generateSuggestionReason; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/react/index.d.cts

@@ -1,9 +1,14 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 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-CUq5Ocu2.cjs';
-export { A as ActionParameter, q as CloudConfig, r as CopilotConfig, _ as LocalStorageAdapterConfig, J as createLocalStorageAdapter, O as createMemoryAdapter, i as generateSuggestionReason } from '../ThreadManager-CUq5Ocu2.cjs';
-import { X as AsyncThreadStorageAdapter, M as MessageAttachment, i as ToolCall, S as Source, T as ToolDefinition, x as PermissionLevel, c as ToolInputSchema, g as Message, s as ToolExecution$1, e as ToolContext, b as ToolResponse$1, n as ToolRenderProps, p as ToolSet, U as UnifiedToolCall, k as Thread, l as ThreadData, _ as ThreadStorageAdapter, z as PermissionStorageConfig, B as PermissionStorageAdapter } from '../types-BtAaOV07.cjs';
-export { t as AgentLoopConfig, P as PersistenceConfig, m as ThreadStorageAdapter, a as ToolExecutionStatus, y as ToolPermission } from '../types-BtAaOV07.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-LfFRhr4e.cjs';
+export { A as ActionParameter, q as CloudConfig, r as CopilotConfig, _ as LocalStorageAdapterConfig, J as createLocalStorageAdapter, O as createMemoryAdapter, i as generateSuggestionReason } from '../ThreadManager-LfFRhr4e.cjs';
+import { T as ToolDefinition, P as PermissionLevel, c as ToolInputSchema, k as ToolExecution$1, e as ToolContext, b as ToolResponse$1, f as ToolRenderProps, h as ToolSet, U as UnifiedToolCall, q as PermissionStorageConfig, r as PermissionStorageAdapter } from '../tools-DDWrco4h.cjs';
+export { l as AgentLoopConfig, a as ToolExecutionStatus, p as ToolPermission } from '../tools-DDWrco4h.cjs';
+import { A as AsyncThreadStorageAdapter, c as MessageAttachment, f as ToolCall, S as Source, M as Message, T as Thread, a as ThreadData, b as ThreadStorageAdapter } from '../types-DG2ya08y.cjs';
+export { P as PersistenceConfig, h as ThreadStorageAdapter } from '../types-DG2ya08y.cjs';
+import { U as UseMCPClientConfig, D as UseMCPClientReturn, E as UseMCPToolsConfig, F as UseMCPToolsReturn } from '../types-DjSfYNKj.cjs';
+export { b as MCPClientState } from '../types-DjSfYNKj.cjs';
+import { U as UseMCPUIIntentsConfig, m as UseMCPUIIntentsReturn } from '../types-B20VCJXL.cjs';
 
 /**
  * Server Thread Storage Adapter
@@ -48,46 +53,6 @@ interface ServerAdapterConfig {
  */
 declare function createServerAdapter(config: ServerAdapterConfig): AsyncThreadStorageAdapter;
 
-/**
- * Message Types
- *
- * Pure type definitions for chat messages.
- * No logic, no side effects - just types.
- */
-
-/**
- * Chat message roles
- */
-type MessageRole = "user" | "assistant" | "system" | "tool";
-/**
- * UIMessage - The source of truth for UI state
- *
- * Inspired by Vercel AI SDK's UIMessage pattern.
- * This is what your UI renders and what gets persisted.
- */
-interface UIMessage {
-    /** Unique message ID */
-    id: string;
-    /** Message role */
-    role: MessageRole;
-    /** Message content */
-    content: string;
-    /** Thinking/reasoning content (for extended thinking models) */
-    thinking?: string;
-    /** Message attachments (images, PDFs, etc) */
-    attachments?: MessageAttachment[];
-    /** Tool calls made by assistant */
-    toolCalls?: ToolCall[];
-    /** Tool call ID (for tool result messages) */
-    toolCallId?: string;
-    /** Sources from knowledge base */
-    sources?: Source[];
-    /** Creation timestamp */
-    createdAt: Date;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-
 /**
  * ChatTransport Interface
  *
@@ -132,6 +97,32 @@ interface ChatResponse {
     /** Whether client needs to execute tools */
     requiresAction?: boolean;
 }
+/**
+ * Tool result from server
+ */
+interface ToolResultData {
+    success: boolean;
+    data?: unknown;
+    error?: string;
+    _aiContext?: string;
+}
+/**
+ * Citation from web search (unified format for all providers)
+ */
+interface Citation {
+    /** Unique citation index (1-based) */
+    index: number;
+    /** Source URL */
+    url: string;
+    /** Page title */
+    title: string;
+    /** Cited text snippet (optional) */
+    citedText?: string;
+    /** Source domain (extracted from URL) */
+    domain?: string;
+    /** Favicon URL (generated from domain) */
+    favicon?: string;
+}
 /**
  * Stream chunk types
  */
@@ -160,6 +151,37 @@ type StreamChunk = {
     type: "done";
     messages?: unknown[];
     requiresAction?: boolean;
+} | {
+    type: "action:start";
+    id: string;
+    name: string;
+} | {
+    type: "action:args";
+    id: string;
+    args: string;
+} | {
+    type: "action:end";
+    id: string;
+    name: string;
+    result?: ToolResultData;
+    error?: string;
+} | {
+    type: "tool:result";
+    id: string;
+    name: string;
+    result: ToolResultData;
+} | {
+    type: "loop:iteration";
+    iteration: number;
+    maxIterations: number;
+} | {
+    type: "loop:complete";
+    iterations: number;
+    maxIterationsReached?: boolean;
+    aborted?: boolean;
+} | {
+    type: "citation";
+    citations: Citation[];
 };
 /**
  * ChatTransport interface
@@ -200,6 +222,46 @@ interface ChatTransport {
     isStreaming(): boolean;
 }
 
+/**
+ * Message Types
+ *
+ * Pure type definitions for chat messages.
+ * No logic, no side effects - just types.
+ */
+
+/**
+ * Chat message roles
+ */
+type MessageRole = "user" | "assistant" | "system" | "tool";
+/**
+ * UIMessage - The source of truth for UI state
+ *
+ * Inspired by Vercel AI SDK's UIMessage pattern.
+ * This is what your UI renders and what gets persisted.
+ */
+interface UIMessage {
+    /** Unique message ID */
+    id: string;
+    /** Message role */
+    role: MessageRole;
+    /** Message content */
+    content: string;
+    /** Thinking/reasoning content (for extended thinking models) */
+    thinking?: string;
+    /** Message attachments (images, PDFs, etc) */
+    attachments?: MessageAttachment[];
+    /** Tool calls made by assistant */
+    toolCalls?: ToolCall[];
+    /** Tool call ID (for tool result messages) */
+    toolCallId?: string;
+    /** Sources from knowledge base */
+    sources?: Source[];
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+
 /**
  * ChatState Interface
  *
@@ -2051,6 +2113,169 @@ interface UseThreadManagerReturn {
  */
 declare function useThreadManager(config?: UseThreadManagerConfig): UseThreadManagerReturn;
 
+/**
+ * React hook for managing an MCP client connection
+ *
+ * This hook provides a managed MCP client that handles connection lifecycle,
+ * tool discovery, and state management automatically.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const {
+ *     state,
+ *     connect,
+ *     disconnect,
+ *     callTool,
+ *     isConnected,
+ *     isLoading,
+ *   } = useMCPClient({
+ *     name: "github",
+ *     transport: "http",
+ *     url: "https://mcp.github.com",
+ *     headers: { Authorization: `Bearer ${token}` },
+ *     autoConnect: true,
+ *   });
+ *
+ *   if (isLoading) return <div>Connecting...</div>;
+ *   if (!isConnected) return <button onClick={connect}>Connect</button>;
+ *
+ *   return (
+ *     <div>
+ *       <p>Connected to {state.serverInfo?.name}</p>
+ *       <p>{state.tools.length} tools available</p>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useMCPClient(config: UseMCPClientConfig): UseMCPClientReturn;
+
+/**
+ * React hook for connecting to an MCP server and auto-registering its tools
+ *
+ * This hook combines the MCP client management with automatic tool registration
+ * to the CopilotProvider. When connected, all MCP tools become available to
+ * the AI assistant automatically.
+ *
+ * @example
+ * ```tsx
+ * function CopilotWithGitHub() {
+ *   const {
+ *     state,
+ *     isConnected,
+ *     isLoading,
+ *     toolDefinitions,
+ *   } = useMCPTools({
+ *     name: "github",
+ *     transport: "http",
+ *     url: "https://mcp.github.com",
+ *     headers: { Authorization: `Bearer ${token}` },
+ *     autoConnect: true,
+ *     prefixToolNames: true,  // Tools named: github_create_issue, etc.
+ *     onElicitationRequest: async (request) => {
+ *       // Show custom approval UI
+ *       const approved = await showApprovalDialog(request);
+ *       return { requestId: request.requestId, accepted: approved };
+ *     },
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       {isLoading && <div>Connecting to GitHub MCP...</div>}
+ *       {isConnected && (
+ *         <div>{toolDefinitions.length} GitHub tools available</div>
+ *       )}
+ *       <CopilotChat />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useMCPTools(config: UseMCPToolsConfig): UseMCPToolsReturn;
+
+/**
+ * useMCPUIIntents - Hook for handling MCP-UI intents
+ *
+ * This hook provides a unified handler for all MCP-UI intent types.
+ * Use it to handle user interactions from MCP-UI components rendered
+ * in the chat interface.
+ *
+ * @example
+ * ```tsx
+ * function ChatWithMCPUI() {
+ *   const { sendMessage, callTool } = useCopilotChat();
+ *
+ *   const { handleIntent } = useMCPUIIntents({
+ *     // Handle tool calls from UI
+ *     onToolCall: async (name, args) => {
+ *       await callTool(name, args);
+ *     },
+ *     // Handle semantic actions
+ *     onIntent: (action, data) => {
+ *       if (action === "add_to_cart") {
+ *         // Dispatch to state management or send to agent
+ *         sendMessage(`Add ${data?.productId} to cart`);
+ *       }
+ *     },
+ *     // Pre-fill chat input
+ *     onPrompt: (text) => {
+ *       setInputValue(text);
+ *     },
+ *     // Show toast notifications
+ *     onNotify: (message, level) => {
+ *       toast({ message, type: level });
+ *     },
+ *     // Handle link clicks
+ *     onLink: (url, newTab) => {
+ *       // Return false to prevent default behavior
+ *       if (url.startsWith('internal://')) {
+ *         navigate(url.replace('internal://', '/'));
+ *         return false;
+ *       }
+ *     },
+ *   });
+ *
+ *   return (
+ *     <CopilotChat
+ *       onUIIntent={handleIntent}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+declare function useMCPUIIntents(config?: UseMCPUIIntentsConfig): UseMCPUIIntentsReturn;
+/**
+ * Create a simple intent handler that sends intents as messages
+ *
+ * This is a convenience function for when you want all intents
+ * to be converted to natural language messages sent to the agent.
+ *
+ * @example
+ * ```tsx
+ * const { sendMessage } = useCopilotChat();
+ * const { handleIntent } = useMCPUIIntents(
+ *   createMessageIntentHandler(sendMessage)
+ * );
+ * ```
+ */
+declare function createMessageIntentHandler(sendMessage: (message: string) => void | Promise<void>): UseMCPUIIntentsConfig;
+/**
+ * Create an intent handler that integrates with a tool executor
+ *
+ * This connects MCP-UI tool intents directly to useMCPTools
+ * for seamless tool chaining.
+ *
+ * @example
+ * ```tsx
+ * const { callTool } = useMCPTools({ ... });
+ * const { handleIntent } = useMCPUIIntents(
+ *   createToolIntentHandler(callTool)
+ * );
+ * ```
+ */
+declare function createToolIntentHandler(callTool: (name: string, args?: Record<string, unknown>) => Promise<unknown>): UseMCPUIIntentsConfig;
+
 /**
  * Create a permission storage adapter based on config
  */
@@ -2294,4 +2519,4 @@ interface UseChatReturn {
  */
 declare function useChat(config: UseChatConfig): UseChatReturn;
 
-export { type AIContextItem, AbstractAgentLoop, AbstractChat, ActionDefinition, type AgentLoopActions, type AgentLoopCallbacks, type AgentLoopState, AsyncThreadStorageAdapter, type CapabilitiesResponse, CapturedContext, type ChatActions, type ChatCallbacks, type ChatConfig, type ChatState, type ChatStatus, type ToolExecution as ChatToolExecution, type ToolResponse as ChatToolResponse, type CombinedChatState, type CopilotContextValue, CopilotProvider, type CopilotProviderProps, type AgentLoopState$1 as CoreAgentLoopState, type ChatState$1 as CoreChatState, type DevLoggerState, IntentDetectionResult, type KnowledgeBaseConfig, type KnowledgeBaseResult, type KnowledgeBaseSearchResponse, LLMConfig, Message, PermissionLevel, PermissionStorageAdapter, PermissionStorageConfig, type ProviderCapabilities, ReactChat, type ReactChatConfig, ReactChatState, ReactThreadManager, type ReactThreadManagerConfig, ReactThreadManagerState, type ServerAdapterConfig, Source, type Suggestion, Thread, ThreadData, ToolConsentRequest, ToolConsentResponse, ToolContext, ToolDefinition, ToolExecution$1 as ToolExecution, ToolResponse$1 as ToolResponse, ToolType, type ToolsActions, ToolsConfig, type ToolsState, type UIMessage, UnifiedToolCall, type UseAIToolsOptions, type UseAIToolsReturn, type UseAgentOptions, type UseAgentReturn, type UseChatConfig, type UseChatReturn, type UseKnowledgeBaseConfig, type UseSuggestionsOptions, type UseSuggestionsReturn, type UseThreadManagerConfig, type UseThreadManagerReturn, type UseToolConfig, type UseToolExecutorReturn, type UseToolWithSchemaConfig, createPermissionStorage, createReactChat, createReactChatState, createReactThreadManager, createReactThreadManagerState, createServerAdapter, createSessionPermissionCache, formatKnowledgeResultsForAI, initialAgentLoopState, searchKnowledgeBase, useAIAction, useAIActions, useAIContext, useAIContexts, useAITools, useAgent, useCapabilities, useChat, useCopilot, useDevLogger, useFeatureSupport, useKnowledgeBase, useSuggestions, useSupportedMediaTypes, useThreadManager, useTool, useToolExecutor, useToolWithSchema, useTools, useToolsWithSchema };
+export { type AIContextItem, AbstractAgentLoop, AbstractChat, ActionDefinition, type AgentLoopActions, type AgentLoopCallbacks, type AgentLoopState, AsyncThreadStorageAdapter, type CapabilitiesResponse, CapturedContext, type ChatActions, type ChatCallbacks, type ChatConfig, type ChatState, type ChatStatus, type ToolExecution as ChatToolExecution, type ToolResponse as ChatToolResponse, type CombinedChatState, type CopilotContextValue, CopilotProvider, type CopilotProviderProps, type AgentLoopState$1 as CoreAgentLoopState, type ChatState$1 as CoreChatState, type DevLoggerState, IntentDetectionResult, type KnowledgeBaseConfig, type KnowledgeBaseResult, type KnowledgeBaseSearchResponse, LLMConfig, Message, PermissionLevel, PermissionStorageAdapter, PermissionStorageConfig, type ProviderCapabilities, ReactChat, type ReactChatConfig, ReactChatState, ReactThreadManager, type ReactThreadManagerConfig, ReactThreadManagerState, type ServerAdapterConfig, Source, type Suggestion, Thread, ThreadData, ToolConsentRequest, ToolConsentResponse, ToolContext, ToolDefinition, ToolExecution$1 as ToolExecution, ToolResponse$1 as ToolResponse, ToolType, type ToolsActions, ToolsConfig, type ToolsState, type UIMessage, UnifiedToolCall, type UseAIToolsOptions, type UseAIToolsReturn, type UseAgentOptions, type UseAgentReturn, type UseChatConfig, type UseChatReturn, type UseKnowledgeBaseConfig, UseMCPClientConfig, UseMCPClientReturn, UseMCPToolsConfig, UseMCPToolsReturn, UseMCPUIIntentsConfig, UseMCPUIIntentsReturn, type UseSuggestionsOptions, type UseSuggestionsReturn, type UseThreadManagerConfig, type UseThreadManagerReturn, type UseToolConfig, type UseToolExecutorReturn, type UseToolWithSchemaConfig, createMessageIntentHandler, createPermissionStorage, createReactChat, createReactChatState, createReactThreadManager, createReactThreadManagerState, createServerAdapter, createSessionPermissionCache, createToolIntentHandler, formatKnowledgeResultsForAI, initialAgentLoopState, searchKnowledgeBase, useAIAction, useAIActions, useAIContext, useAIContexts, useAITools, useAgent, useCapabilities, useChat, useCopilot, useDevLogger, useFeatureSupport, useKnowledgeBase, useMCPClient, useMCPTools, useMCPUIIntents, useSuggestions, useSupportedMediaTypes, useThreadManager, useTool, useToolExecutor, useToolWithSchema, useTools, useToolsWithSchema };