@yushaw/sanqian-chat 0.2.36 → 0.2.39

package/dist/renderer/index.d.mts

@@ -677,13 +677,48 @@ interface UseChatOptions {
     adapter: ChatAdapter;
     conversationId?: string;
     onError?: (error: Error) => void;
-    onConversationChange?: (conversationId: string, title?: string) => void;
+    onConversationChange?: (conversationId: string, title?: string, meta?: ConversationChangeMeta) => void;
 }
 /** Options for sendMessage */
 interface SendMessageOptions {
     /** Attached resources to include with the message */
     attachedResources?: AttachedResource[];
 }
+interface ConversationChangeMeta {
+    /**
+     * Source of this conversation change event:
+     * - "active": current foreground stream completed and updated UI state
+     * - "background": a detached stream completed in background
+     */
+    source: 'active' | 'background';
+    /** Unique stream token within this hook instance */
+    streamToken?: string;
+    /** Whether this change comes from a detached/background stream */
+    detached?: boolean;
+    /** Optional user-provided context captured when detaching a stream */
+    detachContext?: unknown;
+}
+interface ConversationSwitchOptions {
+    /**
+     * Whether to cancel the currently active stream before switching.
+     * - true (default): existing behavior, stream is cancelled.
+     * - false: detach current stream and allow it to finish in background.
+     */
+    cancelActiveStream?: boolean;
+    /**
+     * Optional metadata persisted on detached stream context.
+     * Returned via onConversationChange meta when detached stream completes.
+     */
+    detachContext?: unknown;
+}
+interface UseChatCapabilities {
+    conversationSwitch: {
+        /** Supports `cancelActiveStream` option on loadConversation/newConversation */
+        supportsCancelActiveStream: true;
+        /** Supports `detachContext` propagation for detached/background streams */
+        supportsDetachContext: true;
+    };
+}
 interface UseChatReturn {
     messages: ChatMessage[];
     isLoading: boolean;
@@ -700,12 +735,14 @@ interface UseChatReturn {
     approveHitl: (remember?: boolean) => void;
     rejectHitl: (remember?: boolean) => void;
     submitHitlInput: (response: HitlResponse) => void;
-    loadConversation: (id: string) => Promise<void>;
-    newConversation: () => void;
+    loadConversation: (id: string, options?: ConversationSwitchOptions) => Promise<void>;
+    newConversation: (options?: ConversationSwitchOptions) => void;
     /** Session resources pushed by apps (global, persists until app disconnects) */
     sessionResources: StoredSessionResource[];
     /** Remove a session resource (user action from UI) */
     removeSessionResource: (fullId: string) => void;
+    /** Feature flags for safe capability-based integrations */
+    capabilities?: UseChatCapabilities;
 }
 declare function useChat(options: UseChatOptions): UseChatReturn;
 
@@ -1036,7 +1073,7 @@ interface SanqianChatProps {
     className?: string;
     emptyState?: ReactNode;
     onError?: (error: Error) => void;
-    onConversationChange?: (conversationId: string, title?: string) => void;
+    onConversationChange?: (conversationId: string, title?: string, meta?: ConversationChangeMeta) => void;
     onStateChange?: (state: {
         messages: ChatMessage[];
         conversationId: string | null;
@@ -1659,4 +1696,4 @@ declare function ensureChatBaseStyles(): void;
  */
 declare function ensureFullChatStyles(): void;
 
-export { AddResourceButton, type AddResourceButtonProps, type AlertAction, AlertBanner, type AlertBannerProps, type AlertConfig, type AlertType, AttachButton, type AttachButtonProps, type AttachConfig, type AttachPosition, type AttachState, type AttachedResource, AttachedResourceTags, type AttachedResourceTagsProps, type AttachmentMenuItem, type AttachmentMenuItemType, type ChatAdapter, type ChatAdapterConfig, type ChatFontSize, ChatInput, type ChatInputHandle, type ChatInputProps, type ChatPanelConfig, type ChatPanelMode, type ChatPanelPosition, type ChatThemeMode, type ChatUiConfig, type ChatUiConfigSerializable, type ChatUiStrings, CompactChat, type CompactChatProps, type ConnectionErrorCode, type ConnectionStatus, type ContextProviderInfo, type ConversationDetail, type ConversationInfo, FloatingChat, type FloatingChatProps, type FloatingWindowConfig, HistoryList, type HistoryListProps, HistoryModal, type HistoryModalProps, HitlCard, type HitlCardProps, type HitlInterruptData, I18nProvider, type I18nProviderProps, IntermediateSteps, type IntermediateStepsProps, type LinkClickEvent, type LinkHandlerConfig, type Locale, MarkdownRenderer, type MarkdownRendererProps, type MessageBlock, MessageBubble, type MessageBubbleProps, MessageList, type MessageListProps, type MessageRole, ModeToggleButton, type ModeToggleButtonProps, PanelControls, type PanelControlsProps, PanelHeaderButtons, PanelResizer, Resizer, type ResizerProps, type ResolvedTheme, ResourceChip, ResourceChipList, type ResourceChipListProps, type ResourceChipProps, ResourcePicker, type ResourcePickerItem, type ResourcePickerProps, type ResourcePickerState, SanqianChat, SanqianChatMessage, type SanqianChatMessageProps, type SanqianChatProps, SanqianMessageList, type SanqianMessageListHandle, type SanqianMessageListProps, type SdkAdapterConfig, type SendMessage, type SendMessageOptions, type SessionResource, type SessionResourceEvent, type StoredSessionResource, type StreamEvent, StreamingTimeline, type StreamingTimelineProps, type ThemeMode, ThemeProvider, type ThemeProviderProps, ThinkingSection, type ThinkingSectionProps, ToolArgumentsDisplay, type ToolArgumentsDisplayProps, type ToolCall, type ToolCallStatus, type Translations, type UseAttachStateReturn, type UseChatOptions, type UseChatPanelReturn, type UseChatReturn, type UseConnectionOptions, type UseConnectionReturn, type UseConversationsOptions, type UseConversationsReturn, type UseFocusPersistenceOptions, type UseResourcePickerOptions, type UseResourcePickerReturn, type WindowPosition, createChatAdapter, createIpcAdapter, createSdkAdapter, ensureChatBaseStyles, ensureFullChatStyles, getTranslations, resolveChatStrings, useAttachState, useChat, useChatPanel, useChatStyles, useConnection, useConversations, useFocusPersistence, useI18n, useIpcUiConfig, useResolvedUiConfig, useResourcePicker, useStandaloneI18n, useStandaloneTheme, useTheme, useWindowDragLock };
+export { AddResourceButton, type AddResourceButtonProps, type AlertAction, AlertBanner, type AlertBannerProps, type AlertConfig, type AlertType, AttachButton, type AttachButtonProps, type AttachConfig, type AttachPosition, type AttachState, type AttachedResource, AttachedResourceTags, type AttachedResourceTagsProps, type AttachmentMenuItem, type AttachmentMenuItemType, type ChatAdapter, type ChatAdapterConfig, type ChatFontSize, ChatInput, type ChatInputHandle, type ChatInputProps, type ChatPanelConfig, type ChatPanelMode, type ChatPanelPosition, type ChatThemeMode, type ChatUiConfig, type ChatUiConfigSerializable, type ChatUiStrings, CompactChat, type CompactChatProps, type ConnectionErrorCode, type ConnectionStatus, type ContextProviderInfo, type ConversationChangeMeta, type ConversationDetail, type ConversationInfo, type ConversationSwitchOptions, FloatingChat, type FloatingChatProps, type FloatingWindowConfig, HistoryList, type HistoryListProps, HistoryModal, type HistoryModalProps, HitlCard, type HitlCardProps, type HitlInterruptData, I18nProvider, type I18nProviderProps, IntermediateSteps, type IntermediateStepsProps, type LinkClickEvent, type LinkHandlerConfig, type Locale, MarkdownRenderer, type MarkdownRendererProps, type MessageBlock, MessageBubble, type MessageBubbleProps, MessageList, type MessageListProps, type MessageRole, ModeToggleButton, type ModeToggleButtonProps, PanelControls, type PanelControlsProps, PanelHeaderButtons, PanelResizer, Resizer, type ResizerProps, type ResolvedTheme, ResourceChip, ResourceChipList, type ResourceChipListProps, type ResourceChipProps, ResourcePicker, type ResourcePickerItem, type ResourcePickerProps, type ResourcePickerState, SanqianChat, SanqianChatMessage, type SanqianChatMessageProps, type SanqianChatProps, SanqianMessageList, type SanqianMessageListHandle, type SanqianMessageListProps, type SdkAdapterConfig, type SendMessage, type SendMessageOptions, type SessionResource, type SessionResourceEvent, type StoredSessionResource, type StreamEvent, StreamingTimeline, type StreamingTimelineProps, type ThemeMode, ThemeProvider, type ThemeProviderProps, ThinkingSection, type ThinkingSectionProps, ToolArgumentsDisplay, type ToolArgumentsDisplayProps, type ToolCall, type ToolCallStatus, type Translations, type UseAttachStateReturn, type UseChatCapabilities, type UseChatOptions, type UseChatPanelReturn, type UseChatReturn, type UseConnectionOptions, type UseConnectionReturn, type UseConversationsOptions, type UseConversationsReturn, type UseFocusPersistenceOptions, type UseResourcePickerOptions, type UseResourcePickerReturn, type WindowPosition, createChatAdapter, createIpcAdapter, createSdkAdapter, ensureChatBaseStyles, ensureFullChatStyles, getTranslations, resolveChatStrings, useAttachState, useChat, useChatPanel, useChatStyles, useConnection, useConversations, useFocusPersistence, useI18n, useIpcUiConfig, useResolvedUiConfig, useResourcePicker, useStandaloneI18n, useStandaloneTheme, useTheme, useWindowDragLock };

package/dist/renderer/index.d.ts

@@ -677,13 +677,48 @@ interface UseChatOptions {
     adapter: ChatAdapter;
     conversationId?: string;
     onError?: (error: Error) => void;
-    onConversationChange?: (conversationId: string, title?: string) => void;
+    onConversationChange?: (conversationId: string, title?: string, meta?: ConversationChangeMeta) => void;
 }
 /** Options for sendMessage */
 interface SendMessageOptions {
     /** Attached resources to include with the message */
     attachedResources?: AttachedResource[];
 }
+interface ConversationChangeMeta {
+    /**
+     * Source of this conversation change event:
+     * - "active": current foreground stream completed and updated UI state
+     * - "background": a detached stream completed in background
+     */
+    source: 'active' | 'background';
+    /** Unique stream token within this hook instance */
+    streamToken?: string;
+    /** Whether this change comes from a detached/background stream */
+    detached?: boolean;
+    /** Optional user-provided context captured when detaching a stream */
+    detachContext?: unknown;
+}
+interface ConversationSwitchOptions {
+    /**
+     * Whether to cancel the currently active stream before switching.
+     * - true (default): existing behavior, stream is cancelled.
+     * - false: detach current stream and allow it to finish in background.
+     */
+    cancelActiveStream?: boolean;
+    /**
+     * Optional metadata persisted on detached stream context.
+     * Returned via onConversationChange meta when detached stream completes.
+     */
+    detachContext?: unknown;
+}
+interface UseChatCapabilities {
+    conversationSwitch: {
+        /** Supports `cancelActiveStream` option on loadConversation/newConversation */
+        supportsCancelActiveStream: true;
+        /** Supports `detachContext` propagation for detached/background streams */
+        supportsDetachContext: true;
+    };
+}
 interface UseChatReturn {
     messages: ChatMessage[];
     isLoading: boolean;
@@ -700,12 +735,14 @@ interface UseChatReturn {
     approveHitl: (remember?: boolean) => void;
     rejectHitl: (remember?: boolean) => void;
     submitHitlInput: (response: HitlResponse) => void;
-    loadConversation: (id: string) => Promise<void>;
-    newConversation: () => void;
+    loadConversation: (id: string, options?: ConversationSwitchOptions) => Promise<void>;
+    newConversation: (options?: ConversationSwitchOptions) => void;
     /** Session resources pushed by apps (global, persists until app disconnects) */
     sessionResources: StoredSessionResource[];
     /** Remove a session resource (user action from UI) */
     removeSessionResource: (fullId: string) => void;
+    /** Feature flags for safe capability-based integrations */
+    capabilities?: UseChatCapabilities;
 }
 declare function useChat(options: UseChatOptions): UseChatReturn;
 
@@ -1036,7 +1073,7 @@ interface SanqianChatProps {
     className?: string;
     emptyState?: ReactNode;
     onError?: (error: Error) => void;
-    onConversationChange?: (conversationId: string, title?: string) => void;
+    onConversationChange?: (conversationId: string, title?: string, meta?: ConversationChangeMeta) => void;
     onStateChange?: (state: {
         messages: ChatMessage[];
         conversationId: string | null;
@@ -1659,4 +1696,4 @@ declare function ensureChatBaseStyles(): void;
  */
 declare function ensureFullChatStyles(): void;
 
-export { AddResourceButton, type AddResourceButtonProps, type AlertAction, AlertBanner, type AlertBannerProps, type AlertConfig, type AlertType, AttachButton, type AttachButtonProps, type AttachConfig, type AttachPosition, type AttachState, type AttachedResource, AttachedResourceTags, type AttachedResourceTagsProps, type AttachmentMenuItem, type AttachmentMenuItemType, type ChatAdapter, type ChatAdapterConfig, type ChatFontSize, ChatInput, type ChatInputHandle, type ChatInputProps, type ChatPanelConfig, type ChatPanelMode, type ChatPanelPosition, type ChatThemeMode, type ChatUiConfig, type ChatUiConfigSerializable, type ChatUiStrings, CompactChat, type CompactChatProps, type ConnectionErrorCode, type ConnectionStatus, type ContextProviderInfo, type ConversationDetail, type ConversationInfo, FloatingChat, type FloatingChatProps, type FloatingWindowConfig, HistoryList, type HistoryListProps, HistoryModal, type HistoryModalProps, HitlCard, type HitlCardProps, type HitlInterruptData, I18nProvider, type I18nProviderProps, IntermediateSteps, type IntermediateStepsProps, type LinkClickEvent, type LinkHandlerConfig, type Locale, MarkdownRenderer, type MarkdownRendererProps, type MessageBlock, MessageBubble, type MessageBubbleProps, MessageList, type MessageListProps, type MessageRole, ModeToggleButton, type ModeToggleButtonProps, PanelControls, type PanelControlsProps, PanelHeaderButtons, PanelResizer, Resizer, type ResizerProps, type ResolvedTheme, ResourceChip, ResourceChipList, type ResourceChipListProps, type ResourceChipProps, ResourcePicker, type ResourcePickerItem, type ResourcePickerProps, type ResourcePickerState, SanqianChat, SanqianChatMessage, type SanqianChatMessageProps, type SanqianChatProps, SanqianMessageList, type SanqianMessageListHandle, type SanqianMessageListProps, type SdkAdapterConfig, type SendMessage, type SendMessageOptions, type SessionResource, type SessionResourceEvent, type StoredSessionResource, type StreamEvent, StreamingTimeline, type StreamingTimelineProps, type ThemeMode, ThemeProvider, type ThemeProviderProps, ThinkingSection, type ThinkingSectionProps, ToolArgumentsDisplay, type ToolArgumentsDisplayProps, type ToolCall, type ToolCallStatus, type Translations, type UseAttachStateReturn, type UseChatOptions, type UseChatPanelReturn, type UseChatReturn, type UseConnectionOptions, type UseConnectionReturn, type UseConversationsOptions, type UseConversationsReturn, type UseFocusPersistenceOptions, type UseResourcePickerOptions, type UseResourcePickerReturn, type WindowPosition, createChatAdapter, createIpcAdapter, createSdkAdapter, ensureChatBaseStyles, ensureFullChatStyles, getTranslations, resolveChatStrings, useAttachState, useChat, useChatPanel, useChatStyles, useConnection, useConversations, useFocusPersistence, useI18n, useIpcUiConfig, useResolvedUiConfig, useResourcePicker, useStandaloneI18n, useStandaloneTheme, useTheme, useWindowDragLock };
+export { AddResourceButton, type AddResourceButtonProps, type AlertAction, AlertBanner, type AlertBannerProps, type AlertConfig, type AlertType, AttachButton, type AttachButtonProps, type AttachConfig, type AttachPosition, type AttachState, type AttachedResource, AttachedResourceTags, type AttachedResourceTagsProps, type AttachmentMenuItem, type AttachmentMenuItemType, type ChatAdapter, type ChatAdapterConfig, type ChatFontSize, ChatInput, type ChatInputHandle, type ChatInputProps, type ChatPanelConfig, type ChatPanelMode, type ChatPanelPosition, type ChatThemeMode, type ChatUiConfig, type ChatUiConfigSerializable, type ChatUiStrings, CompactChat, type CompactChatProps, type ConnectionErrorCode, type ConnectionStatus, type ContextProviderInfo, type ConversationChangeMeta, type ConversationDetail, type ConversationInfo, type ConversationSwitchOptions, FloatingChat, type FloatingChatProps, type FloatingWindowConfig, HistoryList, type HistoryListProps, HistoryModal, type HistoryModalProps, HitlCard, type HitlCardProps, type HitlInterruptData, I18nProvider, type I18nProviderProps, IntermediateSteps, type IntermediateStepsProps, type LinkClickEvent, type LinkHandlerConfig, type Locale, MarkdownRenderer, type MarkdownRendererProps, type MessageBlock, MessageBubble, type MessageBubbleProps, MessageList, type MessageListProps, type MessageRole, ModeToggleButton, type ModeToggleButtonProps, PanelControls, type PanelControlsProps, PanelHeaderButtons, PanelResizer, Resizer, type ResizerProps, type ResolvedTheme, ResourceChip, ResourceChipList, type ResourceChipListProps, type ResourceChipProps, ResourcePicker, type ResourcePickerItem, type ResourcePickerProps, type ResourcePickerState, SanqianChat, SanqianChatMessage, type SanqianChatMessageProps, type SanqianChatProps, SanqianMessageList, type SanqianMessageListHandle, type SanqianMessageListProps, type SdkAdapterConfig, type SendMessage, type SendMessageOptions, type SessionResource, type SessionResourceEvent, type StoredSessionResource, type StreamEvent, StreamingTimeline, type StreamingTimelineProps, type ThemeMode, ThemeProvider, type ThemeProviderProps, ThinkingSection, type ThinkingSectionProps, ToolArgumentsDisplay, type ToolArgumentsDisplayProps, type ToolCall, type ToolCallStatus, type Translations, type UseAttachStateReturn, type UseChatCapabilities, type UseChatOptions, type UseChatPanelReturn, type UseChatReturn, type UseConnectionOptions, type UseConnectionReturn, type UseConversationsOptions, type UseConversationsReturn, type UseFocusPersistenceOptions, type UseResourcePickerOptions, type UseResourcePickerReturn, type WindowPosition, createChatAdapter, createIpcAdapter, createSdkAdapter, ensureChatBaseStyles, ensureFullChatStyles, getTranslations, resolveChatStrings, useAttachState, useChat, useChatPanel, useChatStyles, useConnection, useConversations, useFocusPersistence, useI18n, useIpcUiConfig, useResolvedUiConfig, useResourcePicker, useStandaloneI18n, useStandaloneTheme, useTheme, useWindowDragLock };

package/dist/renderer/index.js

@@ -107,6 +107,12 @@ var findLastBlock = (blocks, predicate) => {
   }
   return void 0;
 };
+var CHAT_CAPABILITIES = {
+  conversationSwitch: {
+    supportsCancelActiveStream: true,
+    supportsDetachContext: true
+  }
+};
 function useChat(options) {
   const { adapter, onError, onConversationChange } = options;
   const [messages, setMessages] = (0, import_react.useState)([]);
@@ -127,6 +133,7 @@ function useChat(options) {
   const pendingCancelRef = (0, import_react.useRef)(false);
   const pendingCancelFnRef = (0, import_react.useRef)(null);
   const suppressStreamRef = (0, import_react.useRef)(false);
+  const activeStreamContextRef = (0, import_react.useRef)(null);
   const currentBlocksRef = (0, import_react.useRef)([]);
   const currentTextBlockIndexRef = (0, import_react.useRef)(-1);
   const needsContentClearRef = (0, import_react.useRef)(false);
@@ -214,8 +221,43 @@ function useChat(options) {
     pendingCancelRef.current = false;
     pendingCancelFnRef.current = null;
   }, []);
-  const handleStreamEvent = (0, import_react.useCallback)((event, assistantMessageId) => {
+  const detachActiveStream = (0, import_react.useCallback)((detachContext) => {
+    const context = activeStreamContextRef.current;
+    if (!context || context.detached) {
+      return;
+    }
+    context.detached = true;
+    context.detachContext = detachContext;
+    if (typewriterIntervalRef.current) {
+      clearTimeout(typewriterIntervalRef.current);
+      typewriterIntervalRef.current = null;
+    }
+    currentAssistantMessageIdRef.current = null;
+    resetStreamBuffers();
+    setIsStreaming(false);
+    setIsLoading(false);
+    setPendingInterrupt(null);
+    currentRunIdRef.current = null;
+    pendingInterruptStreamIdRef.current = null;
+    clearPendingCancel();
+    suppressStreamRef.current = false;
+  }, [clearPendingCancel, resetStreamBuffers]);
+  const handleStreamEvent = (0, import_react.useCallback)((event, streamContext) => {
     if (!isMountedRef.current) return;
+    const isActiveStream = activeStreamContextRef.current?.token === streamContext.token && !streamContext.detached;
+    if (!isActiveStream) {
+      if (event.type === "done" && event.conversationId && !streamContext.didReportConversationChange) {
+        streamContext.didReportConversationChange = true;
+        onConversationChange?.(event.conversationId, event.title, {
+          source: "background",
+          streamToken: streamContext.token,
+          detached: true,
+          detachContext: streamContext.detachContext
+        });
+      }
+      return;
+    }
+    const assistantMessageId = streamContext.assistantMessageId;
     currentAssistantMessageIdRef.current = assistantMessageId;
     if (suppressStreamRef.current && event.type !== "start" && event.type !== "cancelled" && event.type !== "done" && event.type !== "error") {
       return;
@@ -561,8 +603,13 @@ function useChat(options) {
         });
         resetStreamBuffers();
         if (event.conversationId) {
+          streamContext.didReportConversationChange = true;
           setConversationId(event.conversationId);
-          onConversationChange?.(event.conversationId, event.title);
+          onConversationChange?.(event.conversationId, event.title, {
+            source: "active",
+            streamToken: streamContext.token,
+            detached: false
+          });
         }
         if (event.title) setConversationTitle(event.title);
         setIsStreaming(false);
@@ -571,6 +618,7 @@ function useChat(options) {
         pendingInterruptStreamIdRef.current = null;
         suppressStreamRef.current = false;
         clearPendingCancel();
+        activeStreamContextRef.current = null;
         break;
       }
       case "cancelled": {
@@ -608,6 +656,7 @@ function useChat(options) {
         pendingInterruptStreamIdRef.current = null;
         suppressStreamRef.current = false;
         clearPendingCancel();
+        activeStreamContextRef.current = null;
         break;
       }
       case "error": {
@@ -636,6 +685,7 @@ function useChat(options) {
         pendingInterruptStreamIdRef.current = null;
         suppressStreamRef.current = false;
         clearPendingCancel();
+        activeStreamContextRef.current = null;
         break;
       }
       case "interrupt": {
@@ -686,6 +736,13 @@ function useChat(options) {
       blocks: [],
       isComplete: false
     };
+    const streamContext = {
+      token: crypto.randomUUID(),
+      assistantMessageId: assistantMessage.id,
+      detached: false,
+      didReportConversationChange: false
+    };
+    activeStreamContextRef.current = streamContext;
     const shouldRenderUserMessage = trimmedContent.length > 0 || hasAttachedResources;
     setMessages(
       (prev) => shouldRenderUserMessage ? [...prev, userMessage, assistantMessage] : [...prev, assistantMessage]
@@ -708,7 +765,7 @@ function useChat(options) {
       const { cancel } = await adapter.chatStream(
         apiMessages,
         conversationIdRef.current ?? void 0,
-        (event) => handleStreamEvent(event, assistantMessage.id),
+        (event) => handleStreamEvent(event, streamContext),
         {
           agentId: currentAgentIdRef.current,
           attachedResources: attachedResources?.length ? attachedResources : void 0,
@@ -743,6 +800,9 @@ function useChat(options) {
       pendingInterruptStreamIdRef.current = null;
       setIsLoading(false);
       setIsStreaming(false);
+      if (activeStreamContextRef.current?.token === streamContext.token) {
+        activeStreamContextRef.current = null;
+      }
       return false;
     }
   }, [adapter, clearPendingCancel, handleStreamEvent, onError, resetStreamBuffers, sessionResources]);
@@ -784,6 +844,7 @@ function useChat(options) {
     resetStreamBuffers();
     currentRunIdRef.current = null;
     pendingInterruptStreamIdRef.current = null;
+    activeStreamContextRef.current = null;
     setIsStreaming(false);
     setIsLoading(false);
   }, [clearPendingCancel, flushTypewriter, resetStreamBuffers]);
@@ -797,10 +858,20 @@ function useChat(options) {
     resetStreamBuffers();
     currentRunIdRef.current = null;
     pendingInterruptStreamIdRef.current = null;
+    activeStreamContextRef.current = null;
     clearPendingCancel();
     suppressStreamRef.current = false;
   }, [clearPendingCancel, resetStreamBuffers]);
-  const loadConversation = (0, import_react.useCallback)(async (id) => {
+  const loadConversation = (0, import_react.useCallback)(async (id, optionsArg) => {
+    const cancelActiveStream = optionsArg?.cancelActiveStream ?? true;
+    const activeStream = activeStreamContextRef.current;
+    if (activeStream && !activeStream.detached) {
+      if (cancelActiveStream) {
+        stopStreaming();
+      } else {
+        detachActiveStream(optionsArg?.detachContext);
+      }
+    }
     try {
       setIsLoading(true);
       setError(null);
@@ -821,9 +892,19 @@ function useChat(options) {
     } finally {
       if (isMountedRef.current) setIsLoading(false);
     }
-  }, [adapter, onError]);
-  const newConversation = (0, import_react.useCallback)(() => {
-    cancelRef.current?.();
+  }, [adapter, detachActiveStream, onError, stopStreaming]);
+  const newConversation = (0, import_react.useCallback)((optionsArg) => {
+    const cancelActiveStream = optionsArg?.cancelActiveStream ?? true;
+    const activeStream = activeStreamContextRef.current;
+    if (activeStream && !activeStream.detached) {
+      if (cancelActiveStream) {
+        stopStreaming();
+      } else {
+        detachActiveStream(optionsArg?.detachContext);
+      }
+    } else if (cancelActiveStream) {
+      cancelRef.current?.();
+    }
     if (typewriterIntervalRef.current) clearTimeout(typewriterIntervalRef.current);
     setMessages([]);
     setConversationId(null);
@@ -835,8 +916,9 @@ function useChat(options) {
     resetStreamBuffers();
     currentRunIdRef.current = null;
     pendingInterruptStreamIdRef.current = null;
+    activeStreamContextRef.current = null;
     clearPendingCancel();
-  }, [clearPendingCancel, resetStreamBuffers]);
+  }, [clearPendingCancel, detachActiveStream, resetStreamBuffers, stopStreaming]);
   const sendHitlResponse = (0, import_react.useCallback)((response) => {
     const runId = currentRunIdRef.current ?? void 0;
     const streamId = pendingInterruptStreamIdRef.current ?? void 0;
@@ -916,7 +998,8 @@ function useChat(options) {
     loadConversation,
     newConversation,
     sessionResources,
-    removeSessionResource
+    removeSessionResource,
+    capabilities: CHAT_CAPABILITIES
   };
 }
 
@@ -6951,8 +7034,7 @@ var MarkdownRenderer = (0, import_react18.memo)(function MarkdownRenderer2({
         defaultOrigin: origin,
         allowDataImages: true
       }],
-      import_streamdown.defaultRehypePlugins.raw,
-      import_streamdown.defaultRehypePlugins.katex
+      import_streamdown.defaultRehypePlugins.raw
     ];
   }, [allowedProtocols]);
   const handleLinkClick = (0, import_react18.useCallback)((href, event) => {
@@ -6974,7 +7056,7 @@ var MarkdownRenderer = (0, import_react18.memo)(function MarkdownRenderer2({
     }
   }, [linkHandler, onLinkClick]);
   const remarkPlugins = (0, import_react18.useMemo)(() => {
-    return [import_remark_gfm.default, import_streamdown.defaultRemarkPlugins.math];
+    return [import_remark_gfm.default];
   }, []);
   const customComponents = (0, import_react18.useMemo)(() => {
     const comps = {};

package/dist/renderer/index.mjs

@@ -19,6 +19,12 @@ var findLastBlock = (blocks, predicate) => {
   }
   return void 0;
 };
+var CHAT_CAPABILITIES = {
+  conversationSwitch: {
+    supportsCancelActiveStream: true,
+    supportsDetachContext: true
+  }
+};
 function useChat(options) {
   const { adapter, onError, onConversationChange } = options;
   const [messages, setMessages] = useState([]);
@@ -39,6 +45,7 @@ function useChat(options) {
   const pendingCancelRef = useRef(false);
   const pendingCancelFnRef = useRef(null);
   const suppressStreamRef = useRef(false);
+  const activeStreamContextRef = useRef(null);
   const currentBlocksRef = useRef([]);
   const currentTextBlockIndexRef = useRef(-1);
   const needsContentClearRef = useRef(false);
@@ -126,8 +133,43 @@ function useChat(options) {
     pendingCancelRef.current = false;
     pendingCancelFnRef.current = null;
   }, []);
-  const handleStreamEvent = useCallback((event, assistantMessageId) => {
+  const detachActiveStream = useCallback((detachContext) => {
+    const context = activeStreamContextRef.current;
+    if (!context || context.detached) {
+      return;
+    }
+    context.detached = true;
+    context.detachContext = detachContext;
+    if (typewriterIntervalRef.current) {
+      clearTimeout(typewriterIntervalRef.current);
+      typewriterIntervalRef.current = null;
+    }
+    currentAssistantMessageIdRef.current = null;
+    resetStreamBuffers();
+    setIsStreaming(false);
+    setIsLoading(false);
+    setPendingInterrupt(null);
+    currentRunIdRef.current = null;
+    pendingInterruptStreamIdRef.current = null;
+    clearPendingCancel();
+    suppressStreamRef.current = false;
+  }, [clearPendingCancel, resetStreamBuffers]);
+  const handleStreamEvent = useCallback((event, streamContext) => {
     if (!isMountedRef.current) return;
+    const isActiveStream = activeStreamContextRef.current?.token === streamContext.token && !streamContext.detached;
+    if (!isActiveStream) {
+      if (event.type === "done" && event.conversationId && !streamContext.didReportConversationChange) {
+        streamContext.didReportConversationChange = true;
+        onConversationChange?.(event.conversationId, event.title, {
+          source: "background",
+          streamToken: streamContext.token,
+          detached: true,
+          detachContext: streamContext.detachContext
+        });
+      }
+      return;
+    }
+    const assistantMessageId = streamContext.assistantMessageId;
     currentAssistantMessageIdRef.current = assistantMessageId;
     if (suppressStreamRef.current && event.type !== "start" && event.type !== "cancelled" && event.type !== "done" && event.type !== "error") {
       return;
@@ -473,8 +515,13 @@ function useChat(options) {
         });
         resetStreamBuffers();
         if (event.conversationId) {
+          streamContext.didReportConversationChange = true;
           setConversationId(event.conversationId);
-          onConversationChange?.(event.conversationId, event.title);
+          onConversationChange?.(event.conversationId, event.title, {
+            source: "active",
+            streamToken: streamContext.token,
+            detached: false
+          });
         }
         if (event.title) setConversationTitle(event.title);
         setIsStreaming(false);
@@ -483,6 +530,7 @@ function useChat(options) {
         pendingInterruptStreamIdRef.current = null;
         suppressStreamRef.current = false;
         clearPendingCancel();
+        activeStreamContextRef.current = null;
         break;
       }
       case "cancelled": {
@@ -520,6 +568,7 @@ function useChat(options) {
         pendingInterruptStreamIdRef.current = null;
         suppressStreamRef.current = false;
         clearPendingCancel();
+        activeStreamContextRef.current = null;
         break;
       }
       case "error": {
@@ -548,6 +597,7 @@ function useChat(options) {
         pendingInterruptStreamIdRef.current = null;
         suppressStreamRef.current = false;
         clearPendingCancel();
+        activeStreamContextRef.current = null;
         break;
       }
       case "interrupt": {
@@ -598,6 +648,13 @@ function useChat(options) {
       blocks: [],
       isComplete: false
     };
+    const streamContext = {
+      token: crypto.randomUUID(),
+      assistantMessageId: assistantMessage.id,
+      detached: false,
+      didReportConversationChange: false
+    };
+    activeStreamContextRef.current = streamContext;
     const shouldRenderUserMessage = trimmedContent.length > 0 || hasAttachedResources;
     setMessages(
       (prev) => shouldRenderUserMessage ? [...prev, userMessage, assistantMessage] : [...prev, assistantMessage]
@@ -620,7 +677,7 @@ function useChat(options) {
       const { cancel } = await adapter.chatStream(
         apiMessages,
         conversationIdRef.current ?? void 0,
-        (event) => handleStreamEvent(event, assistantMessage.id),
+        (event) => handleStreamEvent(event, streamContext),
         {
           agentId: currentAgentIdRef.current,
           attachedResources: attachedResources?.length ? attachedResources : void 0,
@@ -655,6 +712,9 @@ function useChat(options) {
       pendingInterruptStreamIdRef.current = null;
       setIsLoading(false);
       setIsStreaming(false);
+      if (activeStreamContextRef.current?.token === streamContext.token) {
+        activeStreamContextRef.current = null;
+      }
       return false;
     }
   }, [adapter, clearPendingCancel, handleStreamEvent, onError, resetStreamBuffers, sessionResources]);
@@ -696,6 +756,7 @@ function useChat(options) {
     resetStreamBuffers();
     currentRunIdRef.current = null;
     pendingInterruptStreamIdRef.current = null;
+    activeStreamContextRef.current = null;
     setIsStreaming(false);
     setIsLoading(false);
   }, [clearPendingCancel, flushTypewriter, resetStreamBuffers]);
@@ -709,10 +770,20 @@ function useChat(options) {
     resetStreamBuffers();
     currentRunIdRef.current = null;
     pendingInterruptStreamIdRef.current = null;
+    activeStreamContextRef.current = null;
     clearPendingCancel();
     suppressStreamRef.current = false;
   }, [clearPendingCancel, resetStreamBuffers]);
-  const loadConversation = useCallback(async (id) => {
+  const loadConversation = useCallback(async (id, optionsArg) => {
+    const cancelActiveStream = optionsArg?.cancelActiveStream ?? true;
+    const activeStream = activeStreamContextRef.current;
+    if (activeStream && !activeStream.detached) {
+      if (cancelActiveStream) {
+        stopStreaming();
+      } else {
+        detachActiveStream(optionsArg?.detachContext);
+      }
+    }
     try {
       setIsLoading(true);
       setError(null);
@@ -733,9 +804,19 @@ function useChat(options) {
     } finally {
       if (isMountedRef.current) setIsLoading(false);
     }
-  }, [adapter, onError]);
-  const newConversation = useCallback(() => {
-    cancelRef.current?.();
+  }, [adapter, detachActiveStream, onError, stopStreaming]);
+  const newConversation = useCallback((optionsArg) => {
+    const cancelActiveStream = optionsArg?.cancelActiveStream ?? true;
+    const activeStream = activeStreamContextRef.current;
+    if (activeStream && !activeStream.detached) {
+      if (cancelActiveStream) {
+        stopStreaming();
+      } else {
+        detachActiveStream(optionsArg?.detachContext);
+      }
+    } else if (cancelActiveStream) {
+      cancelRef.current?.();
+    }
     if (typewriterIntervalRef.current) clearTimeout(typewriterIntervalRef.current);
     setMessages([]);
     setConversationId(null);
@@ -747,8 +828,9 @@ function useChat(options) {
     resetStreamBuffers();
     currentRunIdRef.current = null;
     pendingInterruptStreamIdRef.current = null;
+    activeStreamContextRef.current = null;
     clearPendingCancel();
-  }, [clearPendingCancel, resetStreamBuffers]);
+  }, [clearPendingCancel, detachActiveStream, resetStreamBuffers, stopStreaming]);
   const sendHitlResponse = useCallback((response) => {
     const runId = currentRunIdRef.current ?? void 0;
     const streamId = pendingInterruptStreamIdRef.current ?? void 0;
@@ -828,7 +910,8 @@ function useChat(options) {
     loadConversation,
     newConversation,
     sessionResources,
-    removeSessionResource
+    removeSessionResource,
+    capabilities: CHAT_CAPABILITIES
   };
 }
 
@@ -6836,7 +6919,7 @@ import { memo as memo6 } from "react";
 
 // src/renderer/renderers/MarkdownRenderer.tsx
 import { memo as memo3, useMemo as useMemo5, useCallback as useCallback11 } from "react";
-import { Streamdown, defaultRehypePlugins, defaultRemarkPlugins } from "streamdown";
+import { Streamdown, defaultRehypePlugins } from "streamdown";
 import { harden } from "rehype-harden";
 import remarkGfm from "remark-gfm";
 import { jsx as jsx6 } from "react/jsx-runtime";
@@ -6871,8 +6954,7 @@ var MarkdownRenderer = memo3(function MarkdownRenderer2({
         defaultOrigin: origin,
         allowDataImages: true
       }],
-      defaultRehypePlugins.raw,
-      defaultRehypePlugins.katex
+      defaultRehypePlugins.raw
     ];
   }, [allowedProtocols]);
   const handleLinkClick = useCallback11((href, event) => {
@@ -6894,7 +6976,7 @@ var MarkdownRenderer = memo3(function MarkdownRenderer2({
     }
   }, [linkHandler, onLinkClick]);
   const remarkPlugins = useMemo5(() => {
-    return [remarkGfm, defaultRemarkPlugins.math];
+    return [remarkGfm];
   }, []);
   const customComponents = useMemo5(() => {
     const comps = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yushaw/sanqian-chat",
-  "version": "0.2.36",
+  "version": "0.2.39",
   "description": "Floating chat window SDK for Sanqian AI Assistant",
   "main": "./dist/main/index.js",
   "types": "./dist/main/index.d.ts",