@yourgpt/copilot-sdk 2.1.0 → 2.1.2

package/dist/react/index.cjs

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkMUZ2RYS2_cjs = require('../chunk-MUZ2RYS2.cjs');
-var chunk33JSFVGH_cjs = require('../chunk-33JSFVGH.cjs');
+var chunkBNBEKK3U_cjs = require('../chunk-BNBEKK3U.cjs');
+var chunk7MZLBGFQ_cjs = require('../chunk-7MZLBGFQ.cjs');
 require('../chunk-JGPDQDY4.cjs');
-require('../chunk-O33I4HBL.cjs');
-require('../chunk-HNRFRNMY.cjs');
+require('../chunk-GSTTJ46F.cjs');
+require('../chunk-CSEZZ5DX.cjs');
 require('../chunk-ASV6JLYG.cjs');
 require('../chunk-CBAHCI4R.cjs');
 require('../chunk-MEBXW75C.cjs');
@@ -20,183 +20,183 @@ require('../chunk-JEQ2X3Z6.cjs');
 
 Object.defineProperty(exports, "AbstractAgentLoop", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.AbstractAgentLoop; }
+  get: function () { return chunkBNBEKK3U_cjs.AbstractAgentLoop; }
 });
 Object.defineProperty(exports, "AbstractChat", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.AbstractChat; }
+  get: function () { return chunkBNBEKK3U_cjs.AbstractChat; }
 });
 Object.defineProperty(exports, "CopilotProvider", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.CopilotProvider; }
+  get: function () { return chunkBNBEKK3U_cjs.CopilotProvider; }
 });
 Object.defineProperty(exports, "ReactChat", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.ReactChat; }
+  get: function () { return chunkBNBEKK3U_cjs.ReactChat; }
 });
 Object.defineProperty(exports, "ReactChatState", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.ReactChatState; }
+  get: function () { return chunkBNBEKK3U_cjs.ReactChatState; }
 });
 Object.defineProperty(exports, "ReactThreadManager", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.ReactThreadManager; }
+  get: function () { return chunkBNBEKK3U_cjs.ReactThreadManager; }
 });
 Object.defineProperty(exports, "ReactThreadManagerState", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.ReactThreadManagerState; }
+  get: function () { return chunkBNBEKK3U_cjs.ReactThreadManagerState; }
 });
 Object.defineProperty(exports, "createMessageIntentHandler", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.createMessageIntentHandler; }
+  get: function () { return chunkBNBEKK3U_cjs.createMessageIntentHandler; }
 });
 Object.defineProperty(exports, "createPermissionStorage", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.createPermissionStorage; }
+  get: function () { return chunkBNBEKK3U_cjs.createPermissionStorage; }
 });
 Object.defineProperty(exports, "createReactChat", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.createReactChat; }
+  get: function () { return chunkBNBEKK3U_cjs.createReactChat; }
 });
 Object.defineProperty(exports, "createReactChatState", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.createReactChatState; }
+  get: function () { return chunkBNBEKK3U_cjs.createReactChatState; }
 });
 Object.defineProperty(exports, "createReactThreadManager", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.createReactThreadManager; }
+  get: function () { return chunkBNBEKK3U_cjs.createReactThreadManager; }
 });
 Object.defineProperty(exports, "createReactThreadManagerState", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.createReactThreadManagerState; }
+  get: function () { return chunkBNBEKK3U_cjs.createReactThreadManagerState; }
 });
 Object.defineProperty(exports, "createSessionPermissionCache", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.createSessionPermissionCache; }
+  get: function () { return chunkBNBEKK3U_cjs.createSessionPermissionCache; }
 });
 Object.defineProperty(exports, "createToolIntentHandler", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.createToolIntentHandler; }
+  get: function () { return chunkBNBEKK3U_cjs.createToolIntentHandler; }
 });
 Object.defineProperty(exports, "formatKnowledgeResultsForAI", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.formatKnowledgeResultsForAI; }
+  get: function () { return chunkBNBEKK3U_cjs.formatKnowledgeResultsForAI; }
 });
 Object.defineProperty(exports, "initialAgentLoopState", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.initialAgentLoopState; }
+  get: function () { return chunkBNBEKK3U_cjs.initialAgentLoopState; }
 });
 Object.defineProperty(exports, "searchKnowledgeBase", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.searchKnowledgeBase; }
+  get: function () { return chunkBNBEKK3U_cjs.searchKnowledgeBase; }
 });
 Object.defineProperty(exports, "useAIAction", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useAIAction; }
+  get: function () { return chunkBNBEKK3U_cjs.useAIAction; }
 });
 Object.defineProperty(exports, "useAIActions", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useAIActions; }
+  get: function () { return chunkBNBEKK3U_cjs.useAIActions; }
 });
 Object.defineProperty(exports, "useAIContext", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useAIContext; }
+  get: function () { return chunkBNBEKK3U_cjs.useAIContext; }
 });
 Object.defineProperty(exports, "useAIContexts", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useAIContexts; }
+  get: function () { return chunkBNBEKK3U_cjs.useAIContexts; }
 });
 Object.defineProperty(exports, "useAITools", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useAITools; }
+  get: function () { return chunkBNBEKK3U_cjs.useAITools; }
 });
 Object.defineProperty(exports, "useAgent", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useAgent; }
+  get: function () { return chunkBNBEKK3U_cjs.useAgent; }
 });
 Object.defineProperty(exports, "useCapabilities", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useCapabilities; }
+  get: function () { return chunkBNBEKK3U_cjs.useCapabilities; }
 });
 Object.defineProperty(exports, "useChat", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useChat; }
+  get: function () { return chunkBNBEKK3U_cjs.useChat; }
 });
 Object.defineProperty(exports, "useCopilot", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useCopilot; }
+  get: function () { return chunkBNBEKK3U_cjs.useCopilot; }
 });
 Object.defineProperty(exports, "useDevLogger", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useDevLogger; }
+  get: function () { return chunkBNBEKK3U_cjs.useDevLogger; }
 });
 Object.defineProperty(exports, "useFeatureSupport", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useFeatureSupport; }
+  get: function () { return chunkBNBEKK3U_cjs.useFeatureSupport; }
 });
 Object.defineProperty(exports, "useKnowledgeBase", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useKnowledgeBase; }
+  get: function () { return chunkBNBEKK3U_cjs.useKnowledgeBase; }
 });
 Object.defineProperty(exports, "useMCPClient", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useMCPClient; }
+  get: function () { return chunkBNBEKK3U_cjs.useMCPClient; }
 });
 Object.defineProperty(exports, "useMCPTools", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useMCPTools; }
+  get: function () { return chunkBNBEKK3U_cjs.useMCPTools; }
 });
 Object.defineProperty(exports, "useMCPUIIntents", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useMCPUIIntents; }
+  get: function () { return chunkBNBEKK3U_cjs.useMCPUIIntents; }
 });
 Object.defineProperty(exports, "useSuggestions", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useSuggestions; }
+  get: function () { return chunkBNBEKK3U_cjs.useSuggestions; }
 });
 Object.defineProperty(exports, "useSupportedMediaTypes", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useSupportedMediaTypes; }
+  get: function () { return chunkBNBEKK3U_cjs.useSupportedMediaTypes; }
 });
 Object.defineProperty(exports, "useThreadManager", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useThreadManager; }
+  get: function () { return chunkBNBEKK3U_cjs.useThreadManager; }
 });
 Object.defineProperty(exports, "useTool", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useTool; }
+  get: function () { return chunkBNBEKK3U_cjs.useTool; }
 });
 Object.defineProperty(exports, "useToolExecutor", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useToolExecutor; }
+  get: function () { return chunkBNBEKK3U_cjs.useToolExecutor; }
 });
 Object.defineProperty(exports, "useToolWithSchema", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useToolWithSchema; }
+  get: function () { return chunkBNBEKK3U_cjs.useToolWithSchema; }
 });
 Object.defineProperty(exports, "useTools", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useTools; }
+  get: function () { return chunkBNBEKK3U_cjs.useTools; }
 });
 Object.defineProperty(exports, "useToolsWithSchema", {
   enumerable: true,
-  get: function () { return chunkMUZ2RYS2_cjs.useToolsWithSchema; }
+  get: function () { return chunkBNBEKK3U_cjs.useToolsWithSchema; }
 });
 Object.defineProperty(exports, "createLocalStorageAdapter", {
   enumerable: true,
-  get: function () { return chunk33JSFVGH_cjs.createLocalStorageAdapter; }
+  get: function () { return chunk7MZLBGFQ_cjs.createLocalStorageAdapter; }
 });
 Object.defineProperty(exports, "createMemoryAdapter", {
   enumerable: true,
-  get: function () { return chunk33JSFVGH_cjs.createMemoryAdapter; }
+  get: function () { return chunk7MZLBGFQ_cjs.createMemoryAdapter; }
 });
 Object.defineProperty(exports, "createServerAdapter", {
   enumerable: true,
-  get: function () { return chunk33JSFVGH_cjs.createServerAdapter; }
+  get: function () { return chunk7MZLBGFQ_cjs.createServerAdapter; }
 });
 Object.defineProperty(exports, "generateSuggestionReason", {
   enumerable: true,
-  get: function () { return chunk33JSFVGH_cjs.generateSuggestionReason; }
+  get: function () { return chunk7MZLBGFQ_cjs.generateSuggestionReason; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/react/index.d.cts

@@ -2,14 +2,44 @@ 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-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, f as ToolSource, P as PermissionLevel, c as ToolInputSchema, l as ToolExecution$1, e as ToolContext, b as ToolResponse$1, g as ToolRenderProps, i as ToolSet, U as UnifiedToolCall, r as PermissionStorageConfig, s as PermissionStorageAdapter } from '../tools-Clyufshc.cjs';
-export { m as AgentLoopConfig, a as ToolExecutionStatus, q as ToolPermission } from '../tools-Clyufshc.cjs';
+import { T as ToolDefinition, f as ToolSource, P as PermissionLevel, c as ToolInputSchema, l as ToolExecution$1, e as ToolContext, b as ToolResponse$1, g as ToolRenderProps, i as ToolSet, U as UnifiedToolCall, r as PermissionStorageConfig, s as PermissionStorageAdapter } from '../tools-BHQRB_YT.cjs';
+export { m as AgentLoopConfig, a as ToolExecutionStatus, q as ToolPermission } from '../tools-BHQRB_YT.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 { G as MCPServerConfig, U as UseMCPClientConfig, D as UseMCPClientReturn, E as UseMCPToolsConfig, F as UseMCPToolsReturn } from '../types-DM6M_pv_.cjs';
-export { b as MCPClientState } from '../types-DM6M_pv_.cjs';
+import { G as MCPServerConfig, U as UseMCPClientConfig, D as UseMCPClientReturn, E as UseMCPToolsConfig, F as UseMCPToolsReturn } from '../types-8_Hp2rmm.cjs';
+export { b as MCPClientState } from '../types-8_Hp2rmm.cjs';
 import { U as UseMCPUIIntentsConfig, m as UseMCPUIIntentsReturn } from '../types-B20VCJXL.cjs';
 
+/**
+ * Resolvable - Type utility for values that can be static or dynamic
+ *
+ * This pattern allows SDK consumers to pass either:
+ * - Static value: `headers: { "x-api-key": "abc123" }`
+ * - Getter function: `headers: () => ({ "x-api-key": getToken() })`
+ *
+ * Values are resolved at request time, ensuring fresh data on every API call.
+ * This is the modern pattern used by tanstack-query, tRPC, and axios interceptors.
+ *
+ * @example
+ * ```tsx
+ * // Static (for values that never change)
+ * <CopilotProvider headers={{ "x-api-key": "static-key" }} />
+ *
+ * // Dynamic (for values that change at runtime)
+ * <CopilotProvider
+ *   headers={() => ({
+ *     Authorization: `Bearer ${getToken()}`,
+ *     ...getCustomHeaders(),
+ *   })}
+ * />
+ * ```
+ */
+/**
+ * A value that can be either static or a getter function
+ * Getter can be sync or async for flexibility
+ */
+type Resolvable<T> = T | (() => T) | (() => Promise<T>);
+
 /**
  * Server Thread Storage Adapter
  *
@@ -59,6 +89,7 @@ declare function createServerAdapter(config: ServerAdapterConfig): AsyncThreadSt
  * Contract for different transport implementations.
  * HTTP, WebSocket, or mock for testing.
  */
+
 /**
  * Chat request to send
  */
@@ -93,9 +124,18 @@ interface ChatResponse {
         role: string;
         content: string | null;
         tool_calls?: unknown[];
+        /** Tool call ID for tool result messages */
+        tool_call_id?: string;
     }>;
     /** Whether client needs to execute tools */
     requiresAction?: boolean;
+    /** Tool calls with metadata (includes hidden flag for server-side tools) */
+    toolCalls?: Array<{
+        id: string;
+        name: string;
+        args: Record<string, unknown>;
+        hidden?: boolean;
+    }>;
 }
 /**
  * Tool result from server
@@ -149,12 +189,18 @@ type StreamChunk = {
     message: string;
 } | {
     type: "done";
-    messages?: unknown[];
+    messages?: Array<{
+        role: string;
+        content: string | null;
+        tool_calls?: unknown[];
+        tool_call_id?: string;
+    }>;
     requiresAction?: boolean;
 } | {
     type: "action:start";
     id: string;
     name: string;
+    hidden?: boolean;
 } | {
     type: "action:args";
     id: string;
@@ -220,6 +266,21 @@ interface ChatTransport {
      * Check if currently streaming
      */
     isStreaming(): boolean;
+    /**
+     * Update headers configuration (optional)
+     * Can be static headers or a getter function for dynamic resolution
+     */
+    setHeaders?(headers: Resolvable<Record<string, string>>): void;
+    /**
+     * Update URL configuration (optional)
+     * Can be static URL or a getter function for dynamic resolution
+     */
+    setUrl?(url: Resolvable<string>): void;
+    /**
+     * Update body configuration (optional)
+     * Additional properties merged into every request body
+     */
+    setBody?(body: Resolvable<Record<string, unknown>>): void;
 }
 
 /**
@@ -369,18 +430,37 @@ interface ChatState$1<T extends UIMessage = UIMessage> {
 type ChatStatus$1 = "ready" | "submitted" | "streaming" | "error";
 /**
  * Chat configuration
+ *
+ * Supports both static values and getter functions for dynamic configuration.
+ * Using getter functions ensures fresh values on every request.
+ *
+ * @example
+ * ```typescript
+ * const config: ChatConfig = {
+ *   // Static URL
+ *   runtimeUrl: "/api/chat",
+ *
+ *   // Dynamic headers - resolved fresh on every request
+ *   headers: () => ({
+ *     Authorization: `Bearer ${getToken()}`,
+ *     ...getCustomHeaders(),
+ *   }),
+ * };
+ * ```
  */
 interface ChatConfig {
-    /** Runtime API endpoint */
-    runtimeUrl: string;
+    /** Runtime API endpoint - can be static or getter function */
+    runtimeUrl: Resolvable<string>;
     /** LLM configuration */
     llm?: Partial<LLMConfig>;
     /** System prompt */
     systemPrompt?: string;
     /** Enable streaming (default: true) */
     streaming?: boolean;
-    /** Request headers */
-    headers?: Record<string, string>;
+    /** Request headers - can be static or getter function */
+    headers?: Resolvable<Record<string, string>>;
+    /** Additional body properties - can be static or getter function */
+    body?: Resolvable<Record<string, unknown>>;
     /** Thread ID for conversation persistence */
     threadId?: string;
     /** Debug mode */
@@ -460,6 +540,11 @@ interface ToolExecution {
     approvalMessage?: string;
     /** Data passed from user's approval action (e.g., selected supervisor) */
     approvalData?: Record<string, unknown>;
+    /**
+     * Whether this tool execution should be hidden from the UI.
+     * When true, the tool won't appear in the chat, but still executes normally.
+     */
+    hidden?: boolean;
 }
 /**
  * Tool response
@@ -659,6 +744,21 @@ declare class AbstractChat<T extends UIMessage = UIMessage> {
      * This allows updating the system prompt after initialization
      */
     setSystemPrompt(prompt: string): void;
+    /**
+     * Set headers configuration
+     * Can be static headers or a getter function for dynamic resolution
+     */
+    setHeaders(headers: ChatConfig["headers"]): void;
+    /**
+     * Set URL configuration
+     * Can be static URL or a getter function for dynamic resolution
+     */
+    setUrl(url: ChatConfig["runtimeUrl"]): void;
+    /**
+     * Set body configuration
+     * Additional properties merged into every request body
+     */
+    setBody(body: ChatConfig["body"]): void;
     /**
      * Build the request payload
      */
@@ -870,8 +970,11 @@ declare class AbstractAgentLoop implements AgentLoopActions {
 
 interface CopilotProviderProps {
     children: React__default.ReactNode;
-    /** Runtime API endpoint URL */
-    runtimeUrl: string;
+    /**
+     * Runtime API endpoint URL
+     * Can be static string or getter function for dynamic resolution.
+     */
+    runtimeUrl: Resolvable<string>;
     /** System prompt sent with each request */
     systemPrompt?: string;
     /** @deprecated Use useTools() hook instead */
@@ -886,8 +989,16 @@ interface CopilotProviderProps {
     onError?: (error: Error) => void;
     /** Enable/disable streaming (default: true) */
     streaming?: boolean;
-    /** Custom headers to send with each request */
-    headers?: Record<string, string>;
+    /**
+     * Custom headers to send with each request
+     * Can be static object or getter function for dynamic resolution.
+     */
+    headers?: Resolvable<Record<string, string>>;
+    /**
+     * Additional body properties to include in each request
+     * Can be static object or getter function for dynamic resolution.
+     */
+    body?: Resolvable<Record<string, unknown>>;
     /** Enable debug logging */
     debug?: boolean;
     /** Max tool execution iterations (default: 20) */
@@ -921,11 +1032,15 @@ interface CopilotContextValue {
     removeContext: (id: string) => void;
     setSystemPrompt: (prompt: string) => void;
     threadId?: string;
-    runtimeUrl: string;
+    /**
+     * Runtime URL configuration.
+     * Can be a static string or getter function (matches what was passed to provider).
+     */
+    runtimeUrl: Resolvable<string>;
     toolsConfig?: ToolsConfig;
 }
 declare function useCopilot(): CopilotContextValue;
-declare function CopilotProvider({ children, runtimeUrl, systemPrompt, tools: toolsConfig, threadId, initialMessages, onMessagesChange, onError, streaming, headers, debug, maxIterations, maxIterationsMessage, mcpServers, }: CopilotProviderProps): react_jsx_runtime.JSX.Element;
+declare function CopilotProvider({ children, runtimeUrl, systemPrompt, tools: toolsConfig, threadId, initialMessages, onMessagesChange, onError, streaming, headers, body, debug, maxIterations, maxIterationsMessage, mcpServers, }: CopilotProviderProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Chat UI state interface (UI-only state, not message data)