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

package/dist/react/index.d.cts

@@ -1,16 +1,16 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { U as UIMessage, B as BranchInfo } from '../MessageTree-B0JGQOCi.cjs';
-export { M as MessageTree } from '../MessageTree-B0JGQOCi.cjs';
+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 { 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-tmksfhUo.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-tmksfhUo.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';
 export { P as PersistenceConfig, j as ThreadStorageAdapter } from '../types-waEqyE4K.cjs';
-import { G as MCPServerConfig, U as UseMCPClientConfig, D as UseMCPClientReturn, E as UseMCPToolsConfig, F as UseMCPToolsReturn } from '../types-BLw7mxtW.cjs';
-export { b as MCPClientState } from '../types-BLw7mxtW.cjs';
+import { G as MCPServerConfig, U as UseMCPClientConfig, D as UseMCPClientReturn, E as UseMCPToolsConfig, F as UseMCPToolsReturn } from '../types-Cvg4DUoc.cjs';
+export { b as MCPClientState } from '../types-Cvg4DUoc.cjs';
 import { S as SkillDefinition, R as ResolvedSkill } from '../types-BckL3hiw.cjs';
 export { C as ClientInlineSkill, b as SkillSource, c as SkillStrategy } from '../types-BckL3hiw.cjs';
 import { U as UseMCPUIIntentsConfig, m as UseMCPUIIntentsReturn } from '../types-B20VCJXL.cjs';
@@ -509,6 +509,15 @@ interface ChatCallbacks<T extends UIMessage = UIMessage> {
         result?: unknown;
         error?: string;
     }) => void;
+    /**
+     * Called for every raw stream chunk as it arrives.
+     * Use this to build custom real-time UI on top of the SDK — e.g. thinking
+     * step parsers, tool progress trackers, loop iteration counters.
+     * The `messageId` field is the ID of the assistant message being streamed.
+     */
+    onStreamChunk?: (chunk: StreamChunk & {
+        messageId?: string;
+    }) => void;
 }
 /**
  * Chat initialization options
@@ -763,6 +772,17 @@ declare class AbstractChat<T extends UIMessage = UIMessage> {
         toolCallId: string;
         result: unknown;
     }>): Promise<void>;
+    /**
+     * Add tool result messages to history and stop — does NOT trigger a new LLM request.
+     *
+     * Use this instead of continueWithToolResults when you want to close out pending
+     * tool_use blocks (so the history stays valid) without letting the AI continue.
+     * Optionally appends a final assistant message (e.g. an iteration-limit notice).
+     */
+    addToolResultMessages(toolResults: Array<{
+        toolCallId: string;
+        result: unknown;
+    }>, finalAssistantContent?: string): Promise<void>;
     /**
      * Stop generation
      */
@@ -804,7 +824,9 @@ declare class AbstractChat<T extends UIMessage = UIMessage> {
     /**
      * Process a chat request
      */
-    protected processRequest(): Promise<void>;
+    protected processRequest(options?: {
+        preCreatedMessageId?: string;
+    }): Promise<void>;
     /**
      * Set tools available for the LLM
      */
@@ -1356,6 +1378,26 @@ interface CopilotProviderProps {
      */
     skills?: SkillDefinition[];
 }
+type StreamChunkWithMessageId = StreamChunk & {
+    messageId?: string;
+};
+type StreamEventHandler = (chunk: StreamChunkWithMessageId) => void;
+/**
+ * Reactive store for custom per-message metadata.
+ * Powers useMessageMeta() — consumers write any shape they want,
+ * all components reading the same messageId react automatically.
+ */
+declare class MessageMetaStore {
+    private store;
+    private listeners;
+    private static readonly EMPTY;
+    subscribe: (cb: () => void) => (() => void);
+    getSnapshot: () => Map<string, Record<string, unknown>>;
+    getMeta: (messageId: string) => Record<string, unknown>;
+    setMeta: (messageId: string, meta: Record<string, unknown>) => void;
+    updateMeta: (messageId: string, updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
+    clear: () => void;
+}
 interface CopilotContextValue {
     messages: UIMessage[];
     status: "ready" | "submitted" | "streaming" | "error";
@@ -1399,6 +1441,7 @@ interface CopilotContextValue {
         content: string;
         strategy?: string;
     }>) => void;
+    agentIteration: number;
     threadId?: string;
     /**
      * Runtime URL configuration.
@@ -1406,6 +1449,24 @@ interface CopilotContextValue {
      */
     runtimeUrl: Resolvable<string>;
     toolsConfig?: ToolsConfig;
+    /**
+     * Subscribe to raw stream chunks as they arrive.
+     * Returns an unsubscribe function. Use useCopilotEvent() for the hook API.
+     *
+     * @example
+     * ```ts
+     * const unsub = subscribeToStreamEvents((chunk) => {
+     *   if (chunk.type === 'thinking:delta') { ... }
+     * })
+     * return unsub // cleanup
+     * ```
+     */
+    subscribeToStreamEvents: (handler: StreamEventHandler) => () => void;
+    /**
+     * Reactive per-message metadata store.
+     * Use useMessageMeta(messageId) for the hook API.
+     */
+    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;
@@ -2892,6 +2953,72 @@ interface UseSkillStatusReturn {
 }
 declare function useSkillStatus(): UseSkillStatusReturn;
 
+interface MessageCheckpoint {
+    /** Unique checkpoint ID */
+    id: string;
+    /** ID of the user message that triggered this checkpoint */
+    messageId: string;
+    /** When this checkpoint was created */
+    timestamp: number;
+    /** Optional human-readable label */
+    label?: string;
+    /** Full message list BEFORE the user message was processed */
+    messages: UIMessage[];
+}
+interface UseMessageCheckpointsReturn {
+    /** All saved checkpoints, oldest first */
+    checkpoints: MessageCheckpoint[];
+    /** True if a checkpoint exists for the given user message ID */
+    hasCheckpoint: (messageId: string) => boolean;
+    /** Get the checkpoint for a user message ID, or undefined */
+    getCheckpoint: (messageId: string) => MessageCheckpoint | undefined;
+    /**
+     * Restore chat to the state before the user message with the given ID.
+     * Returns the checkpoint if found, undefined otherwise.
+     * Checkpoints created after this one are pruned.
+     */
+    restore: (messageId: string) => MessageCheckpoint | undefined;
+    /**
+     * Manually save a checkpoint for a message ID.
+     * Auto-save already runs on every new user message — use this for
+     * programmatic checkpoints (e.g. before a destructive tool call).
+     */
+    save: (messageId: string, label?: string) => MessageCheckpoint | undefined;
+    /** Clear all saved checkpoints */
+    clear: () => void;
+}
+/**
+ * useMessageCheckpoints
+ *
+ * Automatically saves a checkpoint before each user message is sent to the
+ * agent. Each checkpoint captures the full chat state that existed BEFORE
+ * that user message, so restoring it rolls the conversation back to exactly
+ * that point.
+ *
+ * Generic — works for any agentic app (flow builders, code editors, document
+ * assistants, etc.). App-specific side effects (e.g. restoring a canvas or
+ * database state) can be layered on top via the returned `restore` value.
+ *
+ * @example
+ * ```tsx
+ * // Inside <CopilotChat> children
+ * function MyCheckpointActions() {
+ *   const { hasCheckpoint, restore } = useMessageCheckpoints();
+ *   return (
+ *     <CopilotChat.MessageActions role="user">
+ *       <CopilotChat.Action
+ *         icon={<RotateCcw className="size-3.5" />}
+ *         tooltip="Restore to before this message"
+ *         onClick={({ message }) => restore(message.id)}
+ *         hidden={({ message }) => !hasCheckpoint(message.id)}
+ *       />
+ *     </CopilotChat.MessageActions>
+ *   );
+ * }
+ * ```
+ */
+declare function useMessageCheckpoints(): UseMessageCheckpointsReturn;
+
 /**
  * Create a permission storage adapter based on config
  */
@@ -3306,4 +3433,43 @@ declare function toLLMMessages(messages: DisplayMessage[]): LLMMessage[];
 declare function keepToolPairsAtomic(messages: DisplayMessage[]): DisplayMessage[];
 declare function isCompactionMarker(msg: DisplayMessage): msg is CompactionMarker;
 
-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 MessageHistoryConfig, MessageHistoryContext, type MessageHistoryContextValue, 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 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 UseMessageHistoryOptions, type UseMessageHistoryReturn, 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, useDevLogger, useFeatureSupport, useKnowledgeBase, useMCPClient, useMCPTools, useMCPUIIntents, useMessageHistory, useMessageHistoryContext, useSkill, useSkillStatus, useSuggestions, useSupportedMediaTypes, useThreadManager, useTool, useToolExecutor, useToolWithSchema, useTools, useToolsWithSchema };
+type StreamChunkType = StreamChunk["type"];
+type ChunkOfType<T extends StreamChunkType | "*"> = T extends "*" ? StreamChunkWithMessageId : Extract<StreamChunk, {
+    type: T;
+}> & {
+    messageId?: string;
+};
+/**
+ * Subscribe to a specific stream event type (or all events with '*').
+ *
+ * The handler is called synchronously during streaming — keep it fast.
+ * Handler identity doesn't need to be stable; the hook re-subscribes
+ * automatically when it changes.
+ *
+ * @param eventType - Stream chunk type to listen for, or '*' for all
+ * @param handler   - Callback invoked for each matching chunk
+ */
+declare function useCopilotEvent<T extends StreamChunkType | "*">(eventType: T, handler: (chunk: ChunkOfType<T>) => void): void;
+
+interface UseMessageMetaReturn<T extends Record<string, unknown>> {
+    /** Current metadata for this message. Empty object if nothing set yet. */
+    meta: T;
+    /**
+     * Replace metadata entirely.
+     */
+    setMeta: (meta: T) => void;
+    /**
+     * Merge/update metadata using an updater function.
+     * Receives previous meta, return next meta.
+     */
+    updateMeta: (updater: (prev: T) => T) => void;
+}
+/**
+ * Read and write custom metadata for a specific message ID.
+ *
+ * @param messageId - The message to attach metadata to.
+ *                   Pass undefined to get a no-op instance (safe for conditional use).
+ */
+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 };

package/dist/react/index.d.ts

@@ -1,16 +1,16 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { U as UIMessage, B as BranchInfo } from '../MessageTree-CSIHErPK.js';
-export { M as MessageTree } from '../MessageTree-CSIHErPK.js';
+import { U as UIMessage, B as BranchInfo } from '../MessageTree-Clhiv_k2.js';
+export { M as MessageTree } from '../MessageTree-Clhiv_k2.js';
 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-D7KwT2FJ.js';
 export { A as ActionParameter, q as CloudConfig, r as CopilotConfig, _ as LocalStorageAdapterConfig, J as createLocalStorageAdapter, O as createMemoryAdapter, i as generateSuggestionReason } from '../ThreadManager-D7KwT2FJ.js';
-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-tmksfhUo.js';
-export { z as AgentLoopConfig, q as ContextUsagePart, h as ToolConfig, a as ToolExecutionStatus, F as ToolPermission, v as ToolSetEntry, I as tool } from '../tools-tmksfhUo.js';
+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.js';
+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.js';
 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.js';
 export { P as PersistenceConfig, j as ThreadStorageAdapter } from '../types-waEqyE4K.js';
-import { G as MCPServerConfig, U as UseMCPClientConfig, D as UseMCPClientReturn, E as UseMCPToolsConfig, F as UseMCPToolsReturn } from '../types-BqwW3Baj.js';
-export { b as MCPClientState } from '../types-BqwW3Baj.js';
+import { G as MCPServerConfig, U as UseMCPClientConfig, D as UseMCPClientReturn, E as UseMCPToolsConfig, F as UseMCPToolsReturn } from '../types-BUYni9B8.js';
+export { b as MCPClientState } from '../types-BUYni9B8.js';
 import { S as SkillDefinition, R as ResolvedSkill } from '../types-BckL3hiw.js';
 export { C as ClientInlineSkill, b as SkillSource, c as SkillStrategy } from '../types-BckL3hiw.js';
 import { U as UseMCPUIIntentsConfig, m as UseMCPUIIntentsReturn } from '../types-B20VCJXL.js';
@@ -509,6 +509,15 @@ interface ChatCallbacks<T extends UIMessage = UIMessage> {
         result?: unknown;
         error?: string;
     }) => void;
+    /**
+     * Called for every raw stream chunk as it arrives.
+     * Use this to build custom real-time UI on top of the SDK — e.g. thinking
+     * step parsers, tool progress trackers, loop iteration counters.
+     * The `messageId` field is the ID of the assistant message being streamed.
+     */
+    onStreamChunk?: (chunk: StreamChunk & {
+        messageId?: string;
+    }) => void;
 }
 /**
  * Chat initialization options
@@ -763,6 +772,17 @@ declare class AbstractChat<T extends UIMessage = UIMessage> {
         toolCallId: string;
         result: unknown;
     }>): Promise<void>;
+    /**
+     * Add tool result messages to history and stop — does NOT trigger a new LLM request.
+     *
+     * Use this instead of continueWithToolResults when you want to close out pending
+     * tool_use blocks (so the history stays valid) without letting the AI continue.
+     * Optionally appends a final assistant message (e.g. an iteration-limit notice).
+     */
+    addToolResultMessages(toolResults: Array<{
+        toolCallId: string;
+        result: unknown;
+    }>, finalAssistantContent?: string): Promise<void>;
     /**
      * Stop generation
      */
@@ -804,7 +824,9 @@ declare class AbstractChat<T extends UIMessage = UIMessage> {
     /**
      * Process a chat request
      */
-    protected processRequest(): Promise<void>;
+    protected processRequest(options?: {
+        preCreatedMessageId?: string;
+    }): Promise<void>;
     /**
      * Set tools available for the LLM
      */
@@ -1356,6 +1378,26 @@ interface CopilotProviderProps {
      */
     skills?: SkillDefinition[];
 }
+type StreamChunkWithMessageId = StreamChunk & {
+    messageId?: string;
+};
+type StreamEventHandler = (chunk: StreamChunkWithMessageId) => void;
+/**
+ * Reactive store for custom per-message metadata.
+ * Powers useMessageMeta() — consumers write any shape they want,
+ * all components reading the same messageId react automatically.
+ */
+declare class MessageMetaStore {
+    private store;
+    private listeners;
+    private static readonly EMPTY;
+    subscribe: (cb: () => void) => (() => void);
+    getSnapshot: () => Map<string, Record<string, unknown>>;
+    getMeta: (messageId: string) => Record<string, unknown>;
+    setMeta: (messageId: string, meta: Record<string, unknown>) => void;
+    updateMeta: (messageId: string, updater: (prev: Record<string, unknown>) => Record<string, unknown>) => void;
+    clear: () => void;
+}
 interface CopilotContextValue {
     messages: UIMessage[];
     status: "ready" | "submitted" | "streaming" | "error";
@@ -1399,6 +1441,7 @@ interface CopilotContextValue {
         content: string;
         strategy?: string;
     }>) => void;
+    agentIteration: number;
     threadId?: string;
     /**
      * Runtime URL configuration.
@@ -1406,6 +1449,24 @@ interface CopilotContextValue {
      */
     runtimeUrl: Resolvable<string>;
     toolsConfig?: ToolsConfig;
+    /**
+     * Subscribe to raw stream chunks as they arrive.
+     * Returns an unsubscribe function. Use useCopilotEvent() for the hook API.
+     *
+     * @example
+     * ```ts
+     * const unsub = subscribeToStreamEvents((chunk) => {
+     *   if (chunk.type === 'thinking:delta') { ... }
+     * })
+     * return unsub // cleanup
+     * ```
+     */
+    subscribeToStreamEvents: (handler: StreamEventHandler) => () => void;
+    /**
+     * Reactive per-message metadata store.
+     * Use useMessageMeta(messageId) for the hook API.
+     */
+    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;
@@ -2892,6 +2953,72 @@ interface UseSkillStatusReturn {
 }
 declare function useSkillStatus(): UseSkillStatusReturn;
 
+interface MessageCheckpoint {
+    /** Unique checkpoint ID */
+    id: string;
+    /** ID of the user message that triggered this checkpoint */
+    messageId: string;
+    /** When this checkpoint was created */
+    timestamp: number;
+    /** Optional human-readable label */
+    label?: string;
+    /** Full message list BEFORE the user message was processed */
+    messages: UIMessage[];
+}
+interface UseMessageCheckpointsReturn {
+    /** All saved checkpoints, oldest first */
+    checkpoints: MessageCheckpoint[];
+    /** True if a checkpoint exists for the given user message ID */
+    hasCheckpoint: (messageId: string) => boolean;
+    /** Get the checkpoint for a user message ID, or undefined */
+    getCheckpoint: (messageId: string) => MessageCheckpoint | undefined;
+    /**
+     * Restore chat to the state before the user message with the given ID.
+     * Returns the checkpoint if found, undefined otherwise.
+     * Checkpoints created after this one are pruned.
+     */
+    restore: (messageId: string) => MessageCheckpoint | undefined;
+    /**
+     * Manually save a checkpoint for a message ID.
+     * Auto-save already runs on every new user message — use this for
+     * programmatic checkpoints (e.g. before a destructive tool call).
+     */
+    save: (messageId: string, label?: string) => MessageCheckpoint | undefined;
+    /** Clear all saved checkpoints */
+    clear: () => void;
+}
+/**
+ * useMessageCheckpoints
+ *
+ * Automatically saves a checkpoint before each user message is sent to the
+ * agent. Each checkpoint captures the full chat state that existed BEFORE
+ * that user message, so restoring it rolls the conversation back to exactly
+ * that point.
+ *
+ * Generic — works for any agentic app (flow builders, code editors, document
+ * assistants, etc.). App-specific side effects (e.g. restoring a canvas or
+ * database state) can be layered on top via the returned `restore` value.
+ *
+ * @example
+ * ```tsx
+ * // Inside <CopilotChat> children
+ * function MyCheckpointActions() {
+ *   const { hasCheckpoint, restore } = useMessageCheckpoints();
+ *   return (
+ *     <CopilotChat.MessageActions role="user">
+ *       <CopilotChat.Action
+ *         icon={<RotateCcw className="size-3.5" />}
+ *         tooltip="Restore to before this message"
+ *         onClick={({ message }) => restore(message.id)}
+ *         hidden={({ message }) => !hasCheckpoint(message.id)}
+ *       />
+ *     </CopilotChat.MessageActions>
+ *   );
+ * }
+ * ```
+ */
+declare function useMessageCheckpoints(): UseMessageCheckpointsReturn;
+
 /**
  * Create a permission storage adapter based on config
  */
@@ -3306,4 +3433,43 @@ declare function toLLMMessages(messages: DisplayMessage[]): LLMMessage[];
 declare function keepToolPairsAtomic(messages: DisplayMessage[]): DisplayMessage[];
 declare function isCompactionMarker(msg: DisplayMessage): msg is CompactionMarker;
 
-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 MessageHistoryConfig, MessageHistoryContext, type MessageHistoryContextValue, 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 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 UseMessageHistoryOptions, type UseMessageHistoryReturn, 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, useDevLogger, useFeatureSupport, useKnowledgeBase, useMCPClient, useMCPTools, useMCPUIIntents, useMessageHistory, useMessageHistoryContext, useSkill, useSkillStatus, useSuggestions, useSupportedMediaTypes, useThreadManager, useTool, useToolExecutor, useToolWithSchema, useTools, useToolsWithSchema };
+type StreamChunkType = StreamChunk["type"];
+type ChunkOfType<T extends StreamChunkType | "*"> = T extends "*" ? StreamChunkWithMessageId : Extract<StreamChunk, {
+    type: T;
+}> & {
+    messageId?: string;
+};
+/**
+ * Subscribe to a specific stream event type (or all events with '*').
+ *
+ * The handler is called synchronously during streaming — keep it fast.
+ * Handler identity doesn't need to be stable; the hook re-subscribes
+ * automatically when it changes.
+ *
+ * @param eventType - Stream chunk type to listen for, or '*' for all
+ * @param handler   - Callback invoked for each matching chunk
+ */
+declare function useCopilotEvent<T extends StreamChunkType | "*">(eventType: T, handler: (chunk: ChunkOfType<T>) => void): void;
+
+interface UseMessageMetaReturn<T extends Record<string, unknown>> {
+    /** Current metadata for this message. Empty object if nothing set yet. */
+    meta: T;
+    /**
+     * Replace metadata entirely.
+     */
+    setMeta: (meta: T) => void;
+    /**
+     * Merge/update metadata using an updater function.
+     * Receives previous meta, return next meta.
+     */
+    updateMeta: (updater: (prev: T) => T) => void;
+}
+/**
+ * Read and write custom metadata for a specific message ID.
+ *
+ * @param messageId - The message to attach metadata to.
+ *                   Pass undefined to get a no-op instance (safe for conditional use).
+ */
+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 };

package/dist/react/index.js

@@ -1,10 +1,12 @@
-export { AbstractAgentLoop, AbstractChat, CopilotProvider, MessageHistoryContext, MessageTree, ReactChat, ReactChatState, ReactThreadManager, ReactThreadManagerState, SkillProvider, createMessageIntentHandler, createPermissionStorage, createReactChat, createReactChatState, createReactThreadManager, createReactThreadManagerState, createSessionPermissionCache, createToolIntentHandler, defaultMessageHistoryConfig, defineSkill, formatKnowledgeResultsForAI, initialAgentLoopState, isCompactionMarker, keepToolPairsAtomic, searchKnowledgeBase, toDisplayMessage, toLLMMessage, toLLMMessages, useAIAction, useAIActions, useAIContext, useAIContexts, useAITools, useAgent, useCapabilities, useChat, useContextStats, useCopilot, useDevLogger, useFeatureSupport, useKnowledgeBase, useMCPClient, useMCPTools, useMCPUIIntents, useMessageHistory, useMessageHistoryContext, useSkill, useSkillStatus, useSuggestions, useSupportedMediaTypes, useThreadManager, useTool, useToolExecutor, useToolWithSchema, useTools, useToolsWithSchema } from '../chunk-FLZO2FO3.js';
-export { createLocalStorageAdapter, createMemoryAdapter, createServerAdapter, generateSuggestionReason } from '../chunk-EEH3L64W.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, useThreadManager, useToolExecutor, useToolWithSchema, useToolsWithSchema } from '../chunk-ZAOTYA5L.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-DH6EO6NW.js';
+export { createLocalStorageAdapter, createMemoryAdapter, createServerAdapter, generateSuggestionReason } from '../chunk-YLZCTR4O.js';
 import '../chunk-EWVQWTNV.js';
 import '../chunk-VNLLW3ZI.js';
-import '../chunk-RKGRQRZU.js';
-export { tool } from '../chunk-3AONOZLY.js';
-import '../chunk-LLM7AHMO.js';
+import '../chunk-533K2Z7C.js';
+export { tool } from '../chunk-AIVXGTWS.js';
+import '../chunk-DDZLRCVX.js';
+import '../chunk-53UGJNHN.js';
 import '../chunk-RQ74USYU.js';
 import '../chunk-7W7QLZNC.js';
 import '../chunk-CEOMTQTP.js';
@@ -12,7 +14,6 @@ import '../chunk-PPFHA6IL.js';
 import '../chunk-DABZYCVX.js';
 import '../chunk-MNDGIW47.js';
 import '../chunk-VD74IPKB.js';
-import '../chunk-53UGJNHN.js';
 import '../chunk-DGUM43GV.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/styles.css

@@ -60,6 +60,51 @@
   }
 }
 
+/* Links inside user message bubble — override link color for visibility on primary background */
+.csdk-message-user {
+  --csdk-link-color: hsl(var(--primary-foreground) / 0.9);
+}
+
+/* Message entrance animation — fires on React DOM mount via @starting-style.
+   csdk-message: applied to every message row (user + assistant + tool).
+   Consumers can override via .csdk-user-message / .csdk-assistant-message selectors. */
+
+.csdk-message {
+  opacity: 1;
+  transform: translateY(0) scale(1);
+  transition: opacity 0.22s cubic-bezier(0, 0, 0.2, 1),
+              transform 0.22s cubic-bezier(0, 0, 0.2, 1);
+}
+
+@starting-style {
+  .csdk-message {
+    opacity: 0;
+    transform: translateY(8px) scale(0.97);
+  }
+}
+
+/* Avatar pop-in — independent scale spring, fires alongside the message row entry.
+   Scoped to assistant messages so user-side layout stays clean.
+   The parent .csdk-message handles fade + translateY; this adds a separate scale
+   with a slight spring overshoot so the avatar feels "alive" on arrival. */
+.csdk-assistant-message .csdk-avatar {
+  transform-origin: center;
+  transform: scale(1);
+  transition: transform 320ms cubic-bezier(0.34, 1.56, 0.64, 1);
+}
+
+@starting-style {
+  .csdk-assistant-message .csdk-avatar {
+    transform: scale(0.35);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .csdk-assistant-message .csdk-avatar {
+    transition: none;
+  }
+}
+
 /* Confirmation Card Animations */
 /* Uses @starting-style for reliable first-paint entry in React (more robust than @keyframes) */
 

package/dist/tools/anthropic/index.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
-var chunkNUXLAZOE_cjs = require('../../chunk-NUXLAZOE.cjs');
+var chunk3ZDRX7J2_cjs = require('../../chunk-3ZDRX7J2.cjs');
+require('../../chunk-XWOHNY3F.cjs');
 var chunkTXLIY7GF_cjs = require('../../chunk-TXLIY7GF.cjs');
 require('../../chunk-CBAHCI4R.cjs');
 require('../../chunk-MEBXW75C.cjs');
@@ -8,7 +9,6 @@ require('../../chunk-W73FBYIH.cjs');
 require('../../chunk-2FAWEBZS.cjs');
 require('../../chunk-6T5XXJEP.cjs');
 require('../../chunk-GANCV72Z.cjs');
-require('../../chunk-XWOHNY3F.cjs');
 require('../../chunk-JEQ2X3Z6.cjs');
 
 // src/tools/anthropic/index.ts
@@ -46,7 +46,7 @@ function anthropicSearch(config = {}) {
       return {
         success: true,
         data: response,
-        _aiContext: chunkNUXLAZOE_cjs.formatSearchResultsForAI(response)
+        _aiContext: chunk3ZDRX7J2_cjs.formatSearchResultsForAI(response)
       };
     }
   };

package/dist/tools/anthropic/index.d.cts

@@ -1,4 +1,4 @@
-import { T as ToolDefinition } from '../../tools-tmksfhUo.cjs';
+import { T as ToolDefinition } from '../../tools-DcS6Aeao.cjs';
 export { a as anthropicProvider } from '../../anthropic-DGalr_Fw.cjs';
 import '../../types-ZguuKEs_.cjs';
 

package/dist/tools/anthropic/index.d.ts

@@ -1,4 +1,4 @@
-import { T as ToolDefinition } from '../../tools-tmksfhUo.js';
+import { T as ToolDefinition } from '../../tools-DcS6Aeao.js';
 export { a as anthropicProvider } from '../../anthropic-DkCEDYOt.js';
 import '../../types-ZguuKEs_.js';
 

package/dist/tools/anthropic/index.js

@@ -1,4 +1,5 @@
-import { formatSearchResultsForAI } from '../../chunk-LLM7AHMO.js';
+import { formatSearchResultsForAI } from '../../chunk-DDZLRCVX.js';
+import '../../chunk-53UGJNHN.js';
 import { searchAnthropic } from '../../chunk-RQ74USYU.js';
 export { anthropicProvider } from '../../chunk-RQ74USYU.js';
 import '../../chunk-7W7QLZNC.js';
@@ -7,7 +8,6 @@ import '../../chunk-PPFHA6IL.js';
 import '../../chunk-DABZYCVX.js';
 import '../../chunk-MNDGIW47.js';
 import '../../chunk-VD74IPKB.js';
-import '../../chunk-53UGJNHN.js';
 import '../../chunk-DGUM43GV.js';
 
 // src/tools/anthropic/index.ts