@yushaw/sanqian-chat 0.2.39 → 0.2.41

package/dist/renderer/index.d.mts

@@ -1260,6 +1260,10 @@ interface HistoryListProps {
         yesterday?: string;
         delete?: string;
     };
+    /** Whether a conversation should be highlighted (host-defined relation) */
+    isConversationHighlighted?: (conversation: ConversationInfo) => boolean;
+    /** Label for highlighted conversations */
+    highlightedLabel?: string | ((conversation: ConversationInfo) => string | null | undefined);
 }
 declare const HistoryList: react.NamedExoticComponent<HistoryListProps>;
 
@@ -1318,6 +1322,34 @@ interface AlertConfig {
     action?: AlertAction;
     dismissible?: boolean;
 }
+interface CompactChatStateSnapshot {
+    messages: ChatMessage[];
+    isLoading: boolean;
+    isStreaming: boolean;
+    error: string | null;
+    conversationId: string | null;
+    conversationTitle: string | null;
+    capabilities?: UseChatCapabilities;
+}
+interface CompactChatController {
+    sendMessage: (content: string) => Promise<void>;
+    trySendMessage: (content: string) => Promise<boolean>;
+    newConversation: (options?: ConversationSwitchOptions) => void;
+    loadConversation: (id: string, options?: ConversationSwitchOptions) => Promise<void>;
+    stopStreaming: () => void;
+    focusInput: () => void;
+    setInputText: (text: string) => void;
+    getState: () => CompactChatStateSnapshot;
+}
+interface CompactChatHistoryConfig {
+    /**
+     * Whether a conversation is related to host-side context and should be highlighted.
+     * Example: highlight conversations linked to the current note.
+     */
+    isConversationHighlighted?: (conversation: ConversationInfo) => boolean;
+    /** Label shown on highlighted rows. */
+    highlightedLabel?: string | ((conversation: ConversationInfo) => string | null | undefined);
+}
 interface CompactChatProps {
     /** Chat adapter for backend communication */
     adapter: ChatAdapter;
@@ -1335,11 +1367,10 @@ interface CompactChatProps {
     onMessageReceived?: (message: ChatMessage) => void;
     /** Called when loading state changes */
     onLoadingChange?: (isLoading: boolean) => void;
-    /** Called when chat state changes (messages, conversationId) */
-    onStateChange?: (state: {
-        messages: ChatMessage[];
-        conversationId: string | null;
-    }) => void;
+    /** Called when conversation changes (including detached/background completion metadata). */
+    onConversationChange?: (conversationId: string, title?: string, meta?: ConversationChangeMeta) => void;
+    /** Called when chat state changes */
+    onStateChange?: (state: CompactChatStateSnapshot) => void;
     /** Header content (left side) */
     headerLeft?: ReactNode;
     /** Header content (right side) */
@@ -1353,11 +1384,21 @@ interface CompactChatProps {
     /** Ref to expose sendMessage function for external input */
     sendMessageRef?: React.MutableRefObject<((message: string) => void) | null>;
     /** Ref to expose newConversation function */
-    newConversationRef?: React.MutableRefObject<(() => void) | null>;
+    newConversationRef?: React.MutableRefObject<((options?: ConversationSwitchOptions) => void) | null>;
+    /** Ref to expose loadConversation function */
+    loadConversationRef?: React.MutableRefObject<((id: string, options?: ConversationSwitchOptions) => Promise<void>) | null>;
+    /** Ref to expose stopStreaming function */
+    stopStreamingRef?: React.MutableRefObject<(() => void) | null>;
     /** Ref to expose focusInput function */
     focusInputRef?: React.MutableRefObject<(() => void) | null>;
     /** Ref to expose setText function (for filling input externally) */
     setTextRef?: React.MutableRefObject<((text: string) => void) | null>;
+    /** Ref to expose a full controller for advanced integrations */
+    controllerRef?: React.MutableRefObject<CompactChatController | null>;
+    /** Called after a conversation is deleted from history */
+    onConversationDeleted?: (id: string) => void;
+    /** History list customization */
+    historyConfig?: CompactChatHistoryConfig;
     /** Custom message renderer */
     renderMessage?: (message: ChatMessage) => ReactNode;
     /** Empty state content (when no messages) */
@@ -1696,4 +1737,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 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 };
+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 CompactChatController, type CompactChatHistoryConfig, type CompactChatProps, type CompactChatStateSnapshot, 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

@@ -1260,6 +1260,10 @@ interface HistoryListProps {
         yesterday?: string;
         delete?: string;
     };
+    /** Whether a conversation should be highlighted (host-defined relation) */
+    isConversationHighlighted?: (conversation: ConversationInfo) => boolean;
+    /** Label for highlighted conversations */
+    highlightedLabel?: string | ((conversation: ConversationInfo) => string | null | undefined);
 }
 declare const HistoryList: react.NamedExoticComponent<HistoryListProps>;
 
@@ -1318,6 +1322,34 @@ interface AlertConfig {
     action?: AlertAction;
     dismissible?: boolean;
 }
+interface CompactChatStateSnapshot {
+    messages: ChatMessage[];
+    isLoading: boolean;
+    isStreaming: boolean;
+    error: string | null;
+    conversationId: string | null;
+    conversationTitle: string | null;
+    capabilities?: UseChatCapabilities;
+}
+interface CompactChatController {
+    sendMessage: (content: string) => Promise<void>;
+    trySendMessage: (content: string) => Promise<boolean>;
+    newConversation: (options?: ConversationSwitchOptions) => void;
+    loadConversation: (id: string, options?: ConversationSwitchOptions) => Promise<void>;
+    stopStreaming: () => void;
+    focusInput: () => void;
+    setInputText: (text: string) => void;
+    getState: () => CompactChatStateSnapshot;
+}
+interface CompactChatHistoryConfig {
+    /**
+     * Whether a conversation is related to host-side context and should be highlighted.
+     * Example: highlight conversations linked to the current note.
+     */
+    isConversationHighlighted?: (conversation: ConversationInfo) => boolean;
+    /** Label shown on highlighted rows. */
+    highlightedLabel?: string | ((conversation: ConversationInfo) => string | null | undefined);
+}
 interface CompactChatProps {
     /** Chat adapter for backend communication */
     adapter: ChatAdapter;
@@ -1335,11 +1367,10 @@ interface CompactChatProps {
     onMessageReceived?: (message: ChatMessage) => void;
     /** Called when loading state changes */
     onLoadingChange?: (isLoading: boolean) => void;
-    /** Called when chat state changes (messages, conversationId) */
-    onStateChange?: (state: {
-        messages: ChatMessage[];
-        conversationId: string | null;
-    }) => void;
+    /** Called when conversation changes (including detached/background completion metadata). */
+    onConversationChange?: (conversationId: string, title?: string, meta?: ConversationChangeMeta) => void;
+    /** Called when chat state changes */
+    onStateChange?: (state: CompactChatStateSnapshot) => void;
     /** Header content (left side) */
     headerLeft?: ReactNode;
     /** Header content (right side) */
@@ -1353,11 +1384,21 @@ interface CompactChatProps {
     /** Ref to expose sendMessage function for external input */
     sendMessageRef?: React.MutableRefObject<((message: string) => void) | null>;
     /** Ref to expose newConversation function */
-    newConversationRef?: React.MutableRefObject<(() => void) | null>;
+    newConversationRef?: React.MutableRefObject<((options?: ConversationSwitchOptions) => void) | null>;
+    /** Ref to expose loadConversation function */
+    loadConversationRef?: React.MutableRefObject<((id: string, options?: ConversationSwitchOptions) => Promise<void>) | null>;
+    /** Ref to expose stopStreaming function */
+    stopStreamingRef?: React.MutableRefObject<(() => void) | null>;
     /** Ref to expose focusInput function */
     focusInputRef?: React.MutableRefObject<(() => void) | null>;
     /** Ref to expose setText function (for filling input externally) */
     setTextRef?: React.MutableRefObject<((text: string) => void) | null>;
+    /** Ref to expose a full controller for advanced integrations */
+    controllerRef?: React.MutableRefObject<CompactChatController | null>;
+    /** Called after a conversation is deleted from history */
+    onConversationDeleted?: (id: string) => void;
+    /** History list customization */
+    historyConfig?: CompactChatHistoryConfig;
     /** Custom message renderer */
     renderMessage?: (message: ChatMessage) => ReactNode;
     /** Empty state content (when no messages) */
@@ -1696,4 +1737,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 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 };
+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 CompactChatController, type CompactChatHistoryConfig, type CompactChatProps, type CompactChatStateSnapshot, 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

@@ -1920,33 +1920,56 @@ code {
 
 [data-streamdown="code-block-header"] {
   position: absolute !important;
-  top: 14px !important;
-  right: 8px !important;
+  top: 10px !important;
+  left: 12px !important;
+  right: auto !important;
   z-index: 10;
   padding: 0 !important;
   background: transparent !important;
   border: none !important;
   opacity: 0;
   transition: opacity 150ms ease;
+  pointer-events: none;
+}
+
+[data-streamdown="code-block-actions"] {
+  position: absolute !important;
+  top: 10px !important;
+  right: 8px !important;
+  z-index: 11;
+  display: flex !important;
+  align-items: center;
+  gap: 4px;
+  padding: 0 !important;
+  background: transparent !important;
+  border: none !important;
+  opacity: 0;
+  transition: opacity 150ms ease;
+  pointer-events: auto !important;
 }
 
-[data-streamdown="code-block"]:hover [data-streamdown="code-block-header"] {
+[data-streamdown="code-block"]:hover [data-streamdown="code-block-header"],
+[data-streamdown="code-block"]:hover [data-streamdown="code-block-actions"] {
   opacity: 1;
 }
 
 [data-streamdown="code-block-header"] > span:first-child {
+  display: inline-flex;
   font-size: 11px;
   color: var(--color-muted);
   text-transform: lowercase;
-  margin-right: 8px;
 }
 
 [data-streamdown="code-block-header"] > div {
   display: flex;
   gap: 4px;
+  margin-left: 8px;
+  pointer-events: auto;
 }
 
-[data-streamdown="code-block-header"] button {
+/* Normalize action buttons for both streamdown v1 (header>div) and v2 (code-block-actions). */
+[data-streamdown="code-block-header"] button,
+[data-streamdown="code-block-actions"] button {
   padding: 4px !important;
   border: none !important;
   border-radius: 4px !important;
@@ -1955,18 +1978,21 @@ code {
   cursor: pointer;
 }
 
-[data-streamdown="code-block-header"] button:hover {
+[data-streamdown="code-block-header"] button:hover,
+[data-streamdown="code-block-actions"] button:hover {
   opacity: 1;
   background: var(--color-border) !important;
 }
 
-[data-streamdown="code-block-header"] svg {
+[data-streamdown="code-block-header"] svg,
+[data-streamdown="code-block-actions"] svg {
   color: var(--color-muted) !important;
   width: 12px !important;
   height: 12px !important;
 }
 
-[data-streamdown="code-block-header"] button:hover svg {
+[data-streamdown="code-block-header"] button:hover svg,
+[data-streamdown="code-block-actions"] button:hover svg {
   color: var(--color-text) !important;
 }
 
@@ -6967,9 +6993,8 @@ var useChatHeader = (config) => {
     }
     if (typeof config?.alwaysOnTop === "boolean") {
       setIsPinned(config.alwaysOnTop);
-      resolvedOnPin?.(config.alwaysOnTop);
     }
-  }, [config?.alwaysOnTop, resolvedOnPin]);
+  }, [config?.alwaysOnTop]);
   const showPin = !!resolvedOnPin || typeof config?.alwaysOnTop === "boolean";
   const showClose = !!resolvedOnClose;
   const logoNode = (0, import_react17.useMemo)(() => resolveLogoNode(config?.logo, "header"), [config?.logo]);
@@ -10252,7 +10277,9 @@ var HistoryList = (0, import_react36.memo)(function HistoryList2({
   onDelete,
   onLoadMore,
   isDarkMode = false,
-  strings = {}
+  strings = {},
+  isConversationHighlighted,
+  highlightedLabel
 }) {
   const [hoveredId, setHoveredId] = (0, import_react36.useState)(null);
   const loadMoreRef = (0, import_react36.useRef)(null);
@@ -10308,6 +10335,8 @@ var HistoryList = (0, import_react36.memo)(function HistoryList2({
     conversations.map((conv) => {
       const isSelected = conv.id === selectedId;
       const isHovered = conv.id === hoveredId;
+      const isHighlighted = isConversationHighlighted?.(conv) === true;
+      const resolvedHighlightLabel = isHighlighted ? (typeof highlightedLabel === "function" ? highlightedLabel(conv) : highlightedLabel) ?? "RELATED" : null;
       return /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)(
         "div",
         {
@@ -10319,21 +10348,42 @@ var HistoryList = (0, import_react36.memo)(function HistoryList2({
             padding: "0.5rem 0.75rem",
             textAlign: "left",
             cursor: "pointer",
-            transition: "background-color 0.15s ease",
-            background: isSelected || isHovered ? colors.hover : "transparent"
+            transition: "background-color 0.15s ease, border-color 0.15s ease, box-shadow 0.15s ease",
+            border: isSelected ? "1px solid var(--chat-border-focus)" : "1px solid transparent",
+            background: isSelected || isHovered ? colors.hover : isHighlighted ? "color-mix(in srgb, var(--chat-accent) 6%, transparent)" : "transparent",
+            boxShadow: isSelected ? "inset 2px 0 0 var(--chat-accent)" : "none"
           },
           onClick: () => onSelect(conv.id),
           onMouseEnter: () => setHoveredId(conv.id),
           onMouseLeave: () => setHoveredId(null),
           children: [
             /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("div", { style: { minWidth: 0, flex: 1 }, children: [
-              /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("div", { style: {
-                fontSize: "0.875rem",
-                color: colors.text,
-                overflow: "hidden",
-                textOverflow: "ellipsis",
-                whiteSpace: "nowrap"
-              }, children: conv.title || "Untitled" }),
+              /* @__PURE__ */ (0, import_jsx_runtime23.jsxs)("div", { style: { display: "flex", alignItems: "center", gap: "0.375rem", minWidth: 0 }, children: [
+                /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("div", { style: {
+                  fontSize: "0.875rem",
+                  color: colors.text,
+                  overflow: "hidden",
+                  textOverflow: "ellipsis",
+                  whiteSpace: "nowrap"
+                }, children: conv.title || "Untitled" }),
+                resolvedHighlightLabel && /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(
+                  "span",
+                  {
+                    style: {
+                      fontSize: "0.625rem",
+                      lineHeight: 1,
+                      padding: "0.18rem 0.32rem",
+                      borderRadius: 999,
+                      border: "1px solid color-mix(in srgb, var(--chat-accent) 30%, transparent)",
+                      background: "color-mix(in srgb, var(--chat-accent) 12%, transparent)",
+                      color: "color-mix(in srgb, var(--chat-accent) 85%, var(--chat-text) 15%)",
+                      flexShrink: 0,
+                      fontWeight: 500
+                    },
+                    children: resolvedHighlightLabel
+                  }
+                )
+              ] }),
               /* @__PURE__ */ (0, import_jsx_runtime23.jsx)("div", { style: { fontSize: "0.75rem", color: colors.muted }, children: formatRelativeTime(conv.updatedAt, strings) })
             ] }),
             isHovered && /* @__PURE__ */ (0, import_jsx_runtime23.jsx)(
@@ -10369,39 +10419,50 @@ var HistoryModal = (0, import_react37.memo)(function HistoryModal2({
   isDarkMode = false
 }) {
   const modalRef = (0, import_react37.useRef)(null);
+  const closeTimerRef = (0, import_react37.useRef)(null);
   const [isClosing, setIsClosing] = (0, import_react37.useState)(false);
   const [shouldRender, setShouldRender] = (0, import_react37.useState)(isOpen);
+  const clearCloseTimer = (0, import_react37.useCallback)(() => {
+    if (closeTimerRef.current === null) return;
+    clearTimeout(closeTimerRef.current);
+    closeTimerRef.current = null;
+  }, []);
   (0, import_react37.useEffect)(() => {
     if (isOpen) {
+      clearCloseTimer();
       setShouldRender(true);
       setIsClosing(false);
-    } else if (shouldRender && !isClosing) {
-      setIsClosing(true);
-      setTimeout(() => {
-        setShouldRender(false);
-        setIsClosing(false);
-      }, ANIMATION_DURATION);
+      return;
+    }
+    if (!shouldRender) {
+      setIsClosing(false);
+      return;
     }
-  }, [isOpen, shouldRender, isClosing]);
-  const handleClose = (0, import_react37.useCallback)(() => {
     setIsClosing(true);
-    setTimeout(() => {
+    clearCloseTimer();
+    closeTimerRef.current = setTimeout(() => {
       setShouldRender(false);
       setIsClosing(false);
-      onClose();
+      closeTimerRef.current = null;
     }, ANIMATION_DURATION);
-  }, [onClose]);
+    return clearCloseTimer;
+  }, [isOpen, shouldRender, clearCloseTimer]);
+  (0, import_react37.useEffect)(() => clearCloseTimer, [clearCloseTimer]);
+  const handleCloseRequest = (0, import_react37.useCallback)(() => {
+    if (!isOpen || isClosing) return;
+    onClose();
+  }, [isOpen, isClosing, onClose]);
   (0, import_react37.useEffect)(() => {
     if (!shouldRender || isClosing) return;
     const handleKeyDown = (e) => {
       if (e.key === "Escape") {
         e.preventDefault();
-        handleClose();
+        handleCloseRequest();
       }
     };
     document.addEventListener("keydown", handleKeyDown);
     return () => document.removeEventListener("keydown", handleKeyDown);
-  }, [shouldRender, isClosing, handleClose]);
+  }, [shouldRender, isClosing, handleCloseRequest]);
   (0, import_react37.useEffect)(() => {
     if (!isOpen || !modalRef.current) return;
     modalRef.current.focus();
@@ -10409,11 +10470,12 @@ var HistoryModal = (0, import_react37.memo)(function HistoryModal2({
   const handleBackdropClick = (0, import_react37.useCallback)(
     (e) => {
       if (e.target === e.currentTarget && !isClosing) {
-        handleClose();
+        handleCloseRequest();
       }
     },
-    [handleClose, isClosing]
+    [handleCloseRequest, isClosing]
   );
+  useWindowDragLock(shouldRender);
   if (!shouldRender) return null;
   const closingClass = isClosing ? " chat-modal-closing" : "";
   return /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
@@ -10482,7 +10544,7 @@ var HistoryModal = (0, import_react37.memo)(function HistoryModal2({
                   /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
                     "button",
                     {
-                      onClick: handleClose,
+                      onClick: handleCloseRequest,
                       "aria-label": closeLabel,
                       style: {
                         display: "flex",
@@ -10594,6 +10656,7 @@ var CompactChat = (0, import_react38.memo)(function CompactChat2({
   onError,
   onMessageReceived,
   onLoadingChange,
+  onConversationChange,
   onStateChange,
   headerLeft,
   headerRight,
@@ -10602,8 +10665,13 @@ var CompactChat = (0, import_react38.memo)(function CompactChat2({
   inputPortalContainer,
   sendMessageRef,
   newConversationRef,
+  loadConversationRef,
+  stopStreamingRef,
   focusInputRef: parentFocusInputRef,
   setTextRef: parentSetTextRef,
+  controllerRef,
+  onConversationDeleted,
+  historyConfig,
   renderMessage,
   emptyState,
   className = "",
@@ -10645,7 +10713,6 @@ var CompactChat = (0, import_react38.memo)(function CompactChat2({
   const chatContainerRef = (0, import_react38.useRef)(null);
   const chatInputRef = (0, import_react38.useRef)(null);
   const [showHistory, setShowHistory] = (0, import_react38.useState)(false);
-  useWindowDragLock(showHistory);
   const [connectionAlert, setConnectionAlert] = (0, import_react38.useState)(null);
   const portalContainerRef = (0, import_react38.useRef)(inputPortalContainer ?? null);
   portalContainerRef.current = inputPortalContainer ?? null;
@@ -10674,7 +10741,8 @@ var CompactChat = (0, import_react38.memo)(function CompactChat2({
   });
   const chat = useChat({
     adapter,
-    onError
+    onError,
+    onConversationChange
   });
   useFocusPersistence({
     containerRef: chatContainerRef,
@@ -10718,6 +10786,16 @@ var CompactChat = (0, import_react38.memo)(function CompactChat2({
       newConversationRef.current = chat.newConversation;
     }
   }, [newConversationRef, chat.newConversation]);
+  (0, import_react38.useEffect)(() => {
+    if (loadConversationRef) {
+      loadConversationRef.current = chat.loadConversation;
+    }
+  }, [loadConversationRef, chat.loadConversation]);
+  (0, import_react38.useEffect)(() => {
+    if (stopStreamingRef) {
+      stopStreamingRef.current = chat.stopStreaming;
+    }
+  }, [stopStreamingRef, chat.stopStreaming]);
   (0, import_react38.useEffect)(() => {
     if (parentFocusInputRef) {
       parentFocusInputRef.current = () => chatInputRef.current?.focus();
@@ -10728,6 +10806,63 @@ var CompactChat = (0, import_react38.memo)(function CompactChat2({
       parentSetTextRef.current = (text) => chatInputRef.current?.setValue(text);
     }
   }, [parentSetTextRef]);
+  const getStateSnapshot = (0, import_react38.useCallback)(() => ({
+    messages: chat.messages,
+    isLoading: chat.isLoading,
+    isStreaming: chat.isStreaming,
+    error: chat.error,
+    conversationId: chat.conversationId,
+    conversationTitle: chat.conversationTitle,
+    capabilities: chat.capabilities
+  }), [
+    chat.messages,
+    chat.isLoading,
+    chat.isStreaming,
+    chat.error,
+    chat.conversationId,
+    chat.conversationTitle,
+    chat.capabilities
+  ]);
+  (0, import_react38.useEffect)(() => {
+    if (!controllerRef) return;
+    controllerRef.current = {
+      sendMessage: chat.sendMessage,
+      trySendMessage: chat.trySendMessage,
+      newConversation: chat.newConversation,
+      loadConversation: chat.loadConversation,
+      stopStreaming: chat.stopStreaming,
+      focusInput: () => chatInputRef.current?.focus(),
+      setInputText: (text) => chatInputRef.current?.setValue(text),
+      getState: getStateSnapshot
+    };
+  }, [
+    controllerRef,
+    chat.sendMessage,
+    chat.trySendMessage,
+    chat.newConversation,
+    chat.loadConversation,
+    chat.stopStreaming,
+    getStateSnapshot
+  ]);
+  (0, import_react38.useEffect)(() => {
+    return () => {
+      if (sendMessageRef) sendMessageRef.current = null;
+      if (newConversationRef) newConversationRef.current = null;
+      if (loadConversationRef) loadConversationRef.current = null;
+      if (stopStreamingRef) stopStreamingRef.current = null;
+      if (parentFocusInputRef) parentFocusInputRef.current = null;
+      if (parentSetTextRef) parentSetTextRef.current = null;
+      if (controllerRef) controllerRef.current = null;
+    };
+  }, [
+    sendMessageRef,
+    newConversationRef,
+    loadConversationRef,
+    stopStreamingRef,
+    parentFocusInputRef,
+    parentSetTextRef,
+    controllerRef
+  ]);
   (0, import_react38.useEffect)(() => {
     if (!adapter.onFocusInput) return;
     return adapter.onFocusInput(() => {
@@ -10749,12 +10884,9 @@ var CompactChat = (0, import_react38.memo)(function CompactChat2({
   }, [chat.isLoading, onLoadingChange]);
   (0, import_react38.useEffect)(() => {
     if (onStateChange) {
-      onStateChange({
-        messages: chat.messages,
-        conversationId: chat.conversationId
-      });
+      onStateChange(getStateSnapshot());
     }
-  }, [chat.messages, chat.conversationId, onStateChange]);
+  }, [getStateSnapshot, onStateChange]);
   (0, import_react38.useEffect)(() => {
     if (connection.isConnected) {
       resourcePicker.refreshProviders();
@@ -10782,11 +10914,12 @@ var CompactChat = (0, import_react38.memo)(function CompactChat2({
   const handleDeleteConversation = (0, import_react38.useCallback)(
     async (id) => {
       await conversations.deleteConversation(id);
+      onConversationDeleted?.(id);
       if (id === chat.conversationId) {
         chat.newConversation();
       }
     },
-    [conversations, chat]
+    [conversations, chat, onConversationDeleted]
   );
   const handleNewChat = (0, import_react38.useCallback)(() => {
     chat.newConversation();
@@ -11047,6 +11180,8 @@ var CompactChat = (0, import_react38.memo)(function CompactChat2({
                 onDelete: handleDeleteConversation,
                 onLoadMore: conversations.loadMore,
                 isDarkMode: resolvedIsDarkMode,
+                isConversationHighlighted: historyConfig?.isConversationHighlighted,
+                highlightedLabel: historyConfig?.highlightedLabel,
                 strings: {
                   noHistory: mergedStrings.noHistory,
                   loadMore: mergedStrings.loadMore,

package/dist/renderer/index.mjs

@@ -1832,33 +1832,56 @@ code {
 
 [data-streamdown="code-block-header"] {
   position: absolute !important;
-  top: 14px !important;
-  right: 8px !important;
+  top: 10px !important;
+  left: 12px !important;
+  right: auto !important;
   z-index: 10;
   padding: 0 !important;
   background: transparent !important;
   border: none !important;
   opacity: 0;
   transition: opacity 150ms ease;
+  pointer-events: none;
+}
+
+[data-streamdown="code-block-actions"] {
+  position: absolute !important;
+  top: 10px !important;
+  right: 8px !important;
+  z-index: 11;
+  display: flex !important;
+  align-items: center;
+  gap: 4px;
+  padding: 0 !important;
+  background: transparent !important;
+  border: none !important;
+  opacity: 0;
+  transition: opacity 150ms ease;
+  pointer-events: auto !important;
 }
 
-[data-streamdown="code-block"]:hover [data-streamdown="code-block-header"] {
+[data-streamdown="code-block"]:hover [data-streamdown="code-block-header"],
+[data-streamdown="code-block"]:hover [data-streamdown="code-block-actions"] {
   opacity: 1;
 }
 
 [data-streamdown="code-block-header"] > span:first-child {
+  display: inline-flex;
   font-size: 11px;
   color: var(--color-muted);
   text-transform: lowercase;
-  margin-right: 8px;
 }
 
 [data-streamdown="code-block-header"] > div {
   display: flex;
   gap: 4px;
+  margin-left: 8px;
+  pointer-events: auto;
 }
 
-[data-streamdown="code-block-header"] button {
+/* Normalize action buttons for both streamdown v1 (header>div) and v2 (code-block-actions). */
+[data-streamdown="code-block-header"] button,
+[data-streamdown="code-block-actions"] button {
   padding: 4px !important;
   border: none !important;
   border-radius: 4px !important;
@@ -1867,18 +1890,21 @@ code {
   cursor: pointer;
 }
 
-[data-streamdown="code-block-header"] button:hover {
+[data-streamdown="code-block-header"] button:hover,
+[data-streamdown="code-block-actions"] button:hover {
   opacity: 1;
   background: var(--color-border) !important;
 }
 
-[data-streamdown="code-block-header"] svg {
+[data-streamdown="code-block-header"] svg,
+[data-streamdown="code-block-actions"] svg {
   color: var(--color-muted) !important;
   width: 12px !important;
   height: 12px !important;
 }
 
-[data-streamdown="code-block-header"] button:hover svg {
+[data-streamdown="code-block-header"] button:hover svg,
+[data-streamdown="code-block-actions"] button:hover svg {
   color: var(--color-text) !important;
 }
 
@@ -6879,9 +6905,8 @@ var useChatHeader = (config) => {
     }
     if (typeof config?.alwaysOnTop === "boolean") {
       setIsPinned(config.alwaysOnTop);
-      resolvedOnPin?.(config.alwaysOnTop);
     }
-  }, [config?.alwaysOnTop, resolvedOnPin]);
+  }, [config?.alwaysOnTop]);
   const showPin = !!resolvedOnPin || typeof config?.alwaysOnTop === "boolean";
   const showClose = !!resolvedOnClose;
   const logoNode = useMemo4(() => resolveLogoNode(config?.logo, "header"), [config?.logo]);
@@ -10180,7 +10205,9 @@ var HistoryList = memo16(function HistoryList2({
   onDelete,
   onLoadMore,
   isDarkMode = false,
-  strings = {}
+  strings = {},
+  isConversationHighlighted,
+  highlightedLabel
 }) {
   const [hoveredId, setHoveredId] = useState20(null);
   const loadMoreRef = useRef16(null);
@@ -10236,6 +10263,8 @@ var HistoryList = memo16(function HistoryList2({
     conversations.map((conv) => {
       const isSelected = conv.id === selectedId;
       const isHovered = conv.id === hoveredId;
+      const isHighlighted = isConversationHighlighted?.(conv) === true;
+      const resolvedHighlightLabel = isHighlighted ? (typeof highlightedLabel === "function" ? highlightedLabel(conv) : highlightedLabel) ?? "RELATED" : null;
       return /* @__PURE__ */ jsxs17(
         "div",
         {
@@ -10247,21 +10276,42 @@ var HistoryList = memo16(function HistoryList2({
             padding: "0.5rem 0.75rem",
             textAlign: "left",
             cursor: "pointer",
-            transition: "background-color 0.15s ease",
-            background: isSelected || isHovered ? colors.hover : "transparent"
+            transition: "background-color 0.15s ease, border-color 0.15s ease, box-shadow 0.15s ease",
+            border: isSelected ? "1px solid var(--chat-border-focus)" : "1px solid transparent",
+            background: isSelected || isHovered ? colors.hover : isHighlighted ? "color-mix(in srgb, var(--chat-accent) 6%, transparent)" : "transparent",
+            boxShadow: isSelected ? "inset 2px 0 0 var(--chat-accent)" : "none"
           },
           onClick: () => onSelect(conv.id),
           onMouseEnter: () => setHoveredId(conv.id),
           onMouseLeave: () => setHoveredId(null),
           children: [
             /* @__PURE__ */ jsxs17("div", { style: { minWidth: 0, flex: 1 }, children: [
-              /* @__PURE__ */ jsx23("div", { style: {
-                fontSize: "0.875rem",
-                color: colors.text,
-                overflow: "hidden",
-                textOverflow: "ellipsis",
-                whiteSpace: "nowrap"
-              }, children: conv.title || "Untitled" }),
+              /* @__PURE__ */ jsxs17("div", { style: { display: "flex", alignItems: "center", gap: "0.375rem", minWidth: 0 }, children: [
+                /* @__PURE__ */ jsx23("div", { style: {
+                  fontSize: "0.875rem",
+                  color: colors.text,
+                  overflow: "hidden",
+                  textOverflow: "ellipsis",
+                  whiteSpace: "nowrap"
+                }, children: conv.title || "Untitled" }),
+                resolvedHighlightLabel && /* @__PURE__ */ jsx23(
+                  "span",
+                  {
+                    style: {
+                      fontSize: "0.625rem",
+                      lineHeight: 1,
+                      padding: "0.18rem 0.32rem",
+                      borderRadius: 999,
+                      border: "1px solid color-mix(in srgb, var(--chat-accent) 30%, transparent)",
+                      background: "color-mix(in srgb, var(--chat-accent) 12%, transparent)",
+                      color: "color-mix(in srgb, var(--chat-accent) 85%, var(--chat-text) 15%)",
+                      flexShrink: 0,
+                      fontWeight: 500
+                    },
+                    children: resolvedHighlightLabel
+                  }
+                )
+              ] }),
               /* @__PURE__ */ jsx23("div", { style: { fontSize: "0.75rem", color: colors.muted }, children: formatRelativeTime(conv.updatedAt, strings) })
             ] }),
             isHovered && /* @__PURE__ */ jsx23(
@@ -10297,39 +10347,50 @@ var HistoryModal = memo17(function HistoryModal2({
   isDarkMode = false
 }) {
   const modalRef = useRef17(null);
+  const closeTimerRef = useRef17(null);
   const [isClosing, setIsClosing] = useState21(false);
   const [shouldRender, setShouldRender] = useState21(isOpen);
+  const clearCloseTimer = useCallback21(() => {
+    if (closeTimerRef.current === null) return;
+    clearTimeout(closeTimerRef.current);
+    closeTimerRef.current = null;
+  }, []);
   useEffect25(() => {
     if (isOpen) {
+      clearCloseTimer();
       setShouldRender(true);
       setIsClosing(false);
-    } else if (shouldRender && !isClosing) {
-      setIsClosing(true);
-      setTimeout(() => {
-        setShouldRender(false);
-        setIsClosing(false);
-      }, ANIMATION_DURATION);
+      return;
+    }
+    if (!shouldRender) {
+      setIsClosing(false);
+      return;
     }
-  }, [isOpen, shouldRender, isClosing]);
-  const handleClose = useCallback21(() => {
     setIsClosing(true);
-    setTimeout(() => {
+    clearCloseTimer();
+    closeTimerRef.current = setTimeout(() => {
       setShouldRender(false);
       setIsClosing(false);
-      onClose();
+      closeTimerRef.current = null;
     }, ANIMATION_DURATION);
-  }, [onClose]);
+    return clearCloseTimer;
+  }, [isOpen, shouldRender, clearCloseTimer]);
+  useEffect25(() => clearCloseTimer, [clearCloseTimer]);
+  const handleCloseRequest = useCallback21(() => {
+    if (!isOpen || isClosing) return;
+    onClose();
+  }, [isOpen, isClosing, onClose]);
   useEffect25(() => {
     if (!shouldRender || isClosing) return;
     const handleKeyDown = (e) => {
       if (e.key === "Escape") {
         e.preventDefault();
-        handleClose();
+        handleCloseRequest();
       }
     };
     document.addEventListener("keydown", handleKeyDown);
     return () => document.removeEventListener("keydown", handleKeyDown);
-  }, [shouldRender, isClosing, handleClose]);
+  }, [shouldRender, isClosing, handleCloseRequest]);
   useEffect25(() => {
     if (!isOpen || !modalRef.current) return;
     modalRef.current.focus();
@@ -10337,11 +10398,12 @@ var HistoryModal = memo17(function HistoryModal2({
   const handleBackdropClick = useCallback21(
     (e) => {
       if (e.target === e.currentTarget && !isClosing) {
-        handleClose();
+        handleCloseRequest();
       }
     },
-    [handleClose, isClosing]
+    [handleCloseRequest, isClosing]
   );
+  useWindowDragLock(shouldRender);
   if (!shouldRender) return null;
   const closingClass = isClosing ? " chat-modal-closing" : "";
   return /* @__PURE__ */ jsx24(
@@ -10410,7 +10472,7 @@ var HistoryModal = memo17(function HistoryModal2({
                   /* @__PURE__ */ jsx24(
                     "button",
                     {
-                      onClick: handleClose,
+                      onClick: handleCloseRequest,
                       "aria-label": closeLabel,
                       style: {
                         display: "flex",
@@ -10522,6 +10584,7 @@ var CompactChat = memo18(function CompactChat2({
   onError,
   onMessageReceived,
   onLoadingChange,
+  onConversationChange,
   onStateChange,
   headerLeft,
   headerRight,
@@ -10530,8 +10593,13 @@ var CompactChat = memo18(function CompactChat2({
   inputPortalContainer,
   sendMessageRef,
   newConversationRef,
+  loadConversationRef,
+  stopStreamingRef,
   focusInputRef: parentFocusInputRef,
   setTextRef: parentSetTextRef,
+  controllerRef,
+  onConversationDeleted,
+  historyConfig,
   renderMessage,
   emptyState,
   className = "",
@@ -10573,7 +10641,6 @@ var CompactChat = memo18(function CompactChat2({
   const chatContainerRef = useRef18(null);
   const chatInputRef = useRef18(null);
   const [showHistory, setShowHistory] = useState22(false);
-  useWindowDragLock(showHistory);
   const [connectionAlert, setConnectionAlert] = useState22(null);
   const portalContainerRef = useRef18(inputPortalContainer ?? null);
   portalContainerRef.current = inputPortalContainer ?? null;
@@ -10602,7 +10669,8 @@ var CompactChat = memo18(function CompactChat2({
   });
   const chat = useChat({
     adapter,
-    onError
+    onError,
+    onConversationChange
   });
   useFocusPersistence({
     containerRef: chatContainerRef,
@@ -10646,6 +10714,16 @@ var CompactChat = memo18(function CompactChat2({
       newConversationRef.current = chat.newConversation;
     }
   }, [newConversationRef, chat.newConversation]);
+  useEffect26(() => {
+    if (loadConversationRef) {
+      loadConversationRef.current = chat.loadConversation;
+    }
+  }, [loadConversationRef, chat.loadConversation]);
+  useEffect26(() => {
+    if (stopStreamingRef) {
+      stopStreamingRef.current = chat.stopStreaming;
+    }
+  }, [stopStreamingRef, chat.stopStreaming]);
   useEffect26(() => {
     if (parentFocusInputRef) {
       parentFocusInputRef.current = () => chatInputRef.current?.focus();
@@ -10656,6 +10734,63 @@ var CompactChat = memo18(function CompactChat2({
       parentSetTextRef.current = (text) => chatInputRef.current?.setValue(text);
     }
   }, [parentSetTextRef]);
+  const getStateSnapshot = useCallback22(() => ({
+    messages: chat.messages,
+    isLoading: chat.isLoading,
+    isStreaming: chat.isStreaming,
+    error: chat.error,
+    conversationId: chat.conversationId,
+    conversationTitle: chat.conversationTitle,
+    capabilities: chat.capabilities
+  }), [
+    chat.messages,
+    chat.isLoading,
+    chat.isStreaming,
+    chat.error,
+    chat.conversationId,
+    chat.conversationTitle,
+    chat.capabilities
+  ]);
+  useEffect26(() => {
+    if (!controllerRef) return;
+    controllerRef.current = {
+      sendMessage: chat.sendMessage,
+      trySendMessage: chat.trySendMessage,
+      newConversation: chat.newConversation,
+      loadConversation: chat.loadConversation,
+      stopStreaming: chat.stopStreaming,
+      focusInput: () => chatInputRef.current?.focus(),
+      setInputText: (text) => chatInputRef.current?.setValue(text),
+      getState: getStateSnapshot
+    };
+  }, [
+    controllerRef,
+    chat.sendMessage,
+    chat.trySendMessage,
+    chat.newConversation,
+    chat.loadConversation,
+    chat.stopStreaming,
+    getStateSnapshot
+  ]);
+  useEffect26(() => {
+    return () => {
+      if (sendMessageRef) sendMessageRef.current = null;
+      if (newConversationRef) newConversationRef.current = null;
+      if (loadConversationRef) loadConversationRef.current = null;
+      if (stopStreamingRef) stopStreamingRef.current = null;
+      if (parentFocusInputRef) parentFocusInputRef.current = null;
+      if (parentSetTextRef) parentSetTextRef.current = null;
+      if (controllerRef) controllerRef.current = null;
+    };
+  }, [
+    sendMessageRef,
+    newConversationRef,
+    loadConversationRef,
+    stopStreamingRef,
+    parentFocusInputRef,
+    parentSetTextRef,
+    controllerRef
+  ]);
   useEffect26(() => {
     if (!adapter.onFocusInput) return;
     return adapter.onFocusInput(() => {
@@ -10677,12 +10812,9 @@ var CompactChat = memo18(function CompactChat2({
   }, [chat.isLoading, onLoadingChange]);
   useEffect26(() => {
     if (onStateChange) {
-      onStateChange({
-        messages: chat.messages,
-        conversationId: chat.conversationId
-      });
+      onStateChange(getStateSnapshot());
     }
-  }, [chat.messages, chat.conversationId, onStateChange]);
+  }, [getStateSnapshot, onStateChange]);
   useEffect26(() => {
     if (connection.isConnected) {
       resourcePicker.refreshProviders();
@@ -10710,11 +10842,12 @@ var CompactChat = memo18(function CompactChat2({
   const handleDeleteConversation = useCallback22(
     async (id) => {
       await conversations.deleteConversation(id);
+      onConversationDeleted?.(id);
       if (id === chat.conversationId) {
         chat.newConversation();
       }
     },
-    [conversations, chat]
+    [conversations, chat, onConversationDeleted]
   );
   const handleNewChat = useCallback22(() => {
     chat.newConversation();
@@ -10975,6 +11108,8 @@ var CompactChat = memo18(function CompactChat2({
                 onDelete: handleDeleteConversation,
                 onLoadMore: conversations.loadMore,
                 isDarkMode: resolvedIsDarkMode,
+                isConversationHighlighted: historyConfig?.isConversationHighlighted,
+                highlightedLabel: historyConfig?.highlightedLabel,
                 strings: {
                   noHistory: mergedStrings.noHistory,
                   loadMore: mergedStrings.loadMore,

package/package.json

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

package/src/renderer/styles/chat.css

@@ -413,33 +413,56 @@ code {
 
 [data-streamdown="code-block-header"] {
   position: absolute !important;
-  top: 14px !important;
-  right: 8px !important;
+  top: 10px !important;
+  left: 12px !important;
+  right: auto !important;
   z-index: 10;
   padding: 0 !important;
   background: transparent !important;
   border: none !important;
   opacity: 0;
   transition: opacity 150ms ease;
+  pointer-events: none;
+}
+
+[data-streamdown="code-block-actions"] {
+  position: absolute !important;
+  top: 10px !important;
+  right: 8px !important;
+  z-index: 11;
+  display: flex !important;
+  align-items: center;
+  gap: 4px;
+  padding: 0 !important;
+  background: transparent !important;
+  border: none !important;
+  opacity: 0;
+  transition: opacity 150ms ease;
+  pointer-events: auto !important;
 }
 
-[data-streamdown="code-block"]:hover [data-streamdown="code-block-header"] {
+[data-streamdown="code-block"]:hover [data-streamdown="code-block-header"],
+[data-streamdown="code-block"]:hover [data-streamdown="code-block-actions"] {
   opacity: 1;
 }
 
 [data-streamdown="code-block-header"] > span:first-child {
+  display: inline-flex;
   font-size: 11px;
   color: var(--color-muted);
   text-transform: lowercase;
-  margin-right: 8px;
 }
 
 [data-streamdown="code-block-header"] > div {
   display: flex;
   gap: 4px;
+  margin-left: 8px;
+  pointer-events: auto;
 }
 
-[data-streamdown="code-block-header"] button {
+/* Normalize action buttons for both streamdown v1 (header>div) and v2 (code-block-actions). */
+[data-streamdown="code-block-header"] button,
+[data-streamdown="code-block-actions"] button {
   padding: 4px !important;
   border: none !important;
   border-radius: 4px !important;
@@ -448,18 +471,21 @@ code {
   cursor: pointer;
 }
 
-[data-streamdown="code-block-header"] button:hover {
+[data-streamdown="code-block-header"] button:hover,
+[data-streamdown="code-block-actions"] button:hover {
   opacity: 1;
   background: var(--color-border) !important;
 }
 
-[data-streamdown="code-block-header"] svg {
+[data-streamdown="code-block-header"] svg,
+[data-streamdown="code-block-actions"] svg {
   color: var(--color-muted) !important;
   width: 12px !important;
   height: 12px !important;
 }
 
-[data-streamdown="code-block-header"] button:hover svg {
+[data-streamdown="code-block-header"] button:hover svg,
+[data-streamdown="code-block-actions"] button:hover svg {
   color: var(--color-text) !important;
 }
 

package/src/renderer/styles/coreCss.ts

@@ -420,33 +420,56 @@ code {
 
 [data-streamdown="code-block-header"] {
   position: absolute !important;
-  top: 14px !important;
-  right: 8px !important;
+  top: 10px !important;
+  left: 12px !important;
+  right: auto !important;
   z-index: 10;
   padding: 0 !important;
   background: transparent !important;
   border: none !important;
   opacity: 0;
   transition: opacity 150ms ease;
+  pointer-events: none;
+}
+
+[data-streamdown="code-block-actions"] {
+  position: absolute !important;
+  top: 10px !important;
+  right: 8px !important;
+  z-index: 11;
+  display: flex !important;
+  align-items: center;
+  gap: 4px;
+  padding: 0 !important;
+  background: transparent !important;
+  border: none !important;
+  opacity: 0;
+  transition: opacity 150ms ease;
+  pointer-events: auto !important;
 }
 
-[data-streamdown="code-block"]:hover [data-streamdown="code-block-header"] {
+[data-streamdown="code-block"]:hover [data-streamdown="code-block-header"],
+[data-streamdown="code-block"]:hover [data-streamdown="code-block-actions"] {
   opacity: 1;
 }
 
 [data-streamdown="code-block-header"] > span:first-child {
+  display: inline-flex;
   font-size: 11px;
   color: var(--color-muted);
   text-transform: lowercase;
-  margin-right: 8px;
 }
 
 [data-streamdown="code-block-header"] > div {
   display: flex;
   gap: 4px;
+  margin-left: 8px;
+  pointer-events: auto;
 }
 
-[data-streamdown="code-block-header"] button {
+/* Normalize action buttons for both streamdown v1 (header>div) and v2 (code-block-actions). */
+[data-streamdown="code-block-header"] button,
+[data-streamdown="code-block-actions"] button {
   padding: 4px !important;
   border: none !important;
   border-radius: 4px !important;
@@ -455,18 +478,21 @@ code {
   cursor: pointer;
 }
 
-[data-streamdown="code-block-header"] button:hover {
+[data-streamdown="code-block-header"] button:hover,
+[data-streamdown="code-block-actions"] button:hover {
   opacity: 1;
   background: var(--color-border) !important;
 }
 
-[data-streamdown="code-block-header"] svg {
+[data-streamdown="code-block-header"] svg,
+[data-streamdown="code-block-actions"] svg {
   color: var(--color-muted) !important;
   width: 12px !important;
   height: 12px !important;
 }
 
-[data-streamdown="code-block-header"] button:hover svg {
+[data-streamdown="code-block-header"] button:hover svg,
+[data-streamdown="code-block-actions"] button:hover svg {
   color: var(--color-text) !important;
 }
 

package/src/renderer/styles/safe.css

@@ -413,33 +413,56 @@ code {
 
 [data-streamdown="code-block-header"] {
   position: absolute !important;
-  top: 14px !important;
-  right: 8px !important;
+  top: 10px !important;
+  left: 12px !important;
+  right: auto !important;
   z-index: 10;
   padding: 0 !important;
   background: transparent !important;
   border: none !important;
   opacity: 0;
   transition: opacity 150ms ease;
+  pointer-events: none;
+}
+
+[data-streamdown="code-block-actions"] {
+  position: absolute !important;
+  top: 10px !important;
+  right: 8px !important;
+  z-index: 11;
+  display: flex !important;
+  align-items: center;
+  gap: 4px;
+  padding: 0 !important;
+  background: transparent !important;
+  border: none !important;
+  opacity: 0;
+  transition: opacity 150ms ease;
+  pointer-events: auto !important;
 }
 
-[data-streamdown="code-block"]:hover [data-streamdown="code-block-header"] {
+[data-streamdown="code-block"]:hover [data-streamdown="code-block-header"],
+[data-streamdown="code-block"]:hover [data-streamdown="code-block-actions"] {
   opacity: 1;
 }
 
 [data-streamdown="code-block-header"] > span:first-child {
+  display: inline-flex;
   font-size: 11px;
   color: var(--color-muted);
   text-transform: lowercase;
-  margin-right: 8px;
 }
 
 [data-streamdown="code-block-header"] > div {
   display: flex;
   gap: 4px;
+  margin-left: 8px;
+  pointer-events: auto;
 }
 
-[data-streamdown="code-block-header"] button {
+/* Normalize action buttons for both streamdown v1 (header>div) and v2 (code-block-actions). */
+[data-streamdown="code-block-header"] button,
+[data-streamdown="code-block-actions"] button {
   padding: 4px !important;
   border: none !important;
   border-radius: 4px !important;
@@ -448,18 +471,21 @@ code {
   cursor: pointer;
 }
 
-[data-streamdown="code-block-header"] button:hover {
+[data-streamdown="code-block-header"] button:hover,
+[data-streamdown="code-block-actions"] button:hover {
   opacity: 1;
   background: var(--color-border) !important;
 }
 
-[data-streamdown="code-block-header"] svg {
+[data-streamdown="code-block-header"] svg,
+[data-streamdown="code-block-actions"] svg {
   color: var(--color-muted) !important;
   width: 12px !important;
   height: 12px !important;
 }
 
-[data-streamdown="code-block-header"] button:hover svg {
+[data-streamdown="code-block-header"] button:hover svg,
+[data-streamdown="code-block-actions"] button:hover svg {
   color: var(--color-text) !important;
 }