@yushaw/sanqian-chat 0.2.15 → 0.2.18

package/dist/{chunk-YBHGKM2H.mjs → chunk-27MEXKQU.mjs}

@@ -38,6 +38,9 @@ function createSanqianChatApi() {
     getSessionResources: () => {
       return ipcRenderer.sendSync("sanqian-chat:getSessionResourcesSync");
     },
+    fetchSessionResources: (agentId) => {
+      return ipcRenderer.invoke("sanqian-chat:fetchSessionResources", agentId ? { agentId } : void 0);
+    },
     onSessionResourceEvent: (callback) => {
       const handler = (_, event) => {
         callback(event);

package/dist/core/index.d.mts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { ResourceType, HitlInterruptPayload, ContextListItem, HitlResponse, ResourceListOptions, SanqianSDK } from '@yushaw/sanqian-sdk';
 export { ChatStreamEvent, ContextListItem, HitlInterruptPayload, HitlInterruptType, HitlResponse, HitlRiskLevel, ResourceListOptions, ResourceListResult, ResourceType, ChatMessage as SdkChatMessage, ConversationDetail as SdkConversationDetail, ConversationInfo as SdkConversationInfo, ToolCall as SdkToolCall } from '@yushaw/sanqian-sdk';
 
@@ -434,6 +435,57 @@ type SessionResourceEvent = {
     type: 'resources_cleared';
     appName: string;
 };
+/**
+ * Link click event with parsed URL information
+ */
+interface LinkClickEvent {
+    /** Original href string */
+    href: string;
+    /** Parsed URL object (undefined if invalid URL) */
+    url?: URL;
+    /** Original React mouse event */
+    originalEvent: React.MouseEvent;
+}
+/**
+ * Link handler configuration for custom protocol support
+ *
+ * Allows third-party apps to handle custom URL schemes (e.g., sanqian-notes://)
+ * in chat messages.
+ *
+ * @example
+ * ```tsx
+ * <CompactChat
+ *   linkHandler={{
+ *     allowedProtocols: ['sanqian-notes:', 'obsidian:'],
+ *     onLinkClick: (event) => {
+ *       if (event.href.startsWith('sanqian-notes://')) {
+ *         // Handle note navigation
+ *         return true; // Prevent default behavior
+ *       }
+ *       return false; // Let default behavior handle it
+ *     }
+ *   }}
+ * />
+ * ```
+ */
+interface LinkHandlerConfig {
+    /**
+     * Additional protocols to allow in markdown links.
+     * These will be merged with default protocols ['workspace:', 'download:'].
+     * Without this, rehype-harden will strip links with unknown protocols.
+     *
+     * @example ['sanqian-notes:', 'obsidian:', 'bear:']
+     */
+    allowedProtocols?: string[];
+    /**
+     * Callback when a link is clicked.
+     *
+     * @param event - Link click event with href and parsed URL
+     * @returns true if handled (prevents default and legacy onLinkClick),
+     *          false/void to fall back to legacy onLinkClick prop or browser default
+     */
+    onLinkClick?: (event: LinkClickEvent) => boolean | void;
+}
 
 /**
  * Chat Adapter Interface
@@ -536,8 +588,10 @@ interface ChatAdapter {
     }>;
     /** Subscribe to locale change events */
     onLocaleChanged?(callback: (locale: string) => void): () => void;
-    /** Get current session resources from all connected apps */
+    /** Get session resources pushed by THIS app (local cache) */
     getSessionResources?(): StoredSessionResource[];
+    /** Fetch session resources from server (optionally filtered by agent) */
+    fetchSessionResources?(agentId?: string): Promise<StoredSessionResource[]>;
     /** Subscribe to session resource events (push/remove) */
     onSessionResourceEvent?(callback: (event: SessionResourceEvent) => void): () => void;
     /** Remove a session resource (user action from UI) */
@@ -630,4 +684,4 @@ declare function parseToolCalls(toolCalls: unknown): ToolCall[] | undefined;
  */
 declare function mergeConsecutiveAssistantMessages(rawMessages: ApiMessage[]): ChatMessage[];
 
-export { type ApiMessage, type AttachConfig, type AttachPosition, type AttachState, type AttachedResource, type AttachmentMenuItem, type AttachmentMenuItemType, type ChatAdapter, type ChatAdapterConfig, type ChatFontSize, type ChatMessage, type ChatPanelConfig, type ChatPanelMode, type ChatPanelPosition, type ChatThemeMode, type ChatUiConfigSerializable, type ChatUiStrings, type ConnectionErrorCode, type ConnectionStatus, type ContextProviderInfo, type ConversationDetail, type ConversationInfo, type FloatingWindowConfig, type HitlInterruptData, type Locale, type MessageBlock, type MessageRole, type ResourcePickerItem, type ResourcePickerState, type SdkAdapterConfig, type SendMessage, type SessionResource, type SessionResourceEvent, type StoredSessionResource, type StreamEvent, type ToolCall, type ToolCallStatus, type WindowPosition, createChatAdapter, createSdkAdapter, mergeConsecutiveAssistantMessages, parseToolCalls };
+export { type ApiMessage, type AttachConfig, type AttachPosition, type AttachState, type AttachedResource, type AttachmentMenuItem, type AttachmentMenuItemType, type ChatAdapter, type ChatAdapterConfig, type ChatFontSize, type ChatMessage, type ChatPanelConfig, type ChatPanelMode, type ChatPanelPosition, type ChatThemeMode, type ChatUiConfigSerializable, type ChatUiStrings, type ConnectionErrorCode, type ConnectionStatus, type ContextProviderInfo, type ConversationDetail, type ConversationInfo, type FloatingWindowConfig, type HitlInterruptData, type LinkClickEvent, type LinkHandlerConfig, type Locale, type MessageBlock, type MessageRole, type ResourcePickerItem, type ResourcePickerState, type SdkAdapterConfig, type SendMessage, type SessionResource, type SessionResourceEvent, type StoredSessionResource, type StreamEvent, type ToolCall, type ToolCallStatus, type WindowPosition, createChatAdapter, createSdkAdapter, mergeConsecutiveAssistantMessages, parseToolCalls };

package/dist/core/index.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { ResourceType, HitlInterruptPayload, ContextListItem, HitlResponse, ResourceListOptions, SanqianSDK } from '@yushaw/sanqian-sdk';
 export { ChatStreamEvent, ContextListItem, HitlInterruptPayload, HitlInterruptType, HitlResponse, HitlRiskLevel, ResourceListOptions, ResourceListResult, ResourceType, ChatMessage as SdkChatMessage, ConversationDetail as SdkConversationDetail, ConversationInfo as SdkConversationInfo, ToolCall as SdkToolCall } from '@yushaw/sanqian-sdk';
 
@@ -434,6 +435,57 @@ type SessionResourceEvent = {
     type: 'resources_cleared';
     appName: string;
 };
+/**
+ * Link click event with parsed URL information
+ */
+interface LinkClickEvent {
+    /** Original href string */
+    href: string;
+    /** Parsed URL object (undefined if invalid URL) */
+    url?: URL;
+    /** Original React mouse event */
+    originalEvent: React.MouseEvent;
+}
+/**
+ * Link handler configuration for custom protocol support
+ *
+ * Allows third-party apps to handle custom URL schemes (e.g., sanqian-notes://)
+ * in chat messages.
+ *
+ * @example
+ * ```tsx
+ * <CompactChat
+ *   linkHandler={{
+ *     allowedProtocols: ['sanqian-notes:', 'obsidian:'],
+ *     onLinkClick: (event) => {
+ *       if (event.href.startsWith('sanqian-notes://')) {
+ *         // Handle note navigation
+ *         return true; // Prevent default behavior
+ *       }
+ *       return false; // Let default behavior handle it
+ *     }
+ *   }}
+ * />
+ * ```
+ */
+interface LinkHandlerConfig {
+    /**
+     * Additional protocols to allow in markdown links.
+     * These will be merged with default protocols ['workspace:', 'download:'].
+     * Without this, rehype-harden will strip links with unknown protocols.
+     *
+     * @example ['sanqian-notes:', 'obsidian:', 'bear:']
+     */
+    allowedProtocols?: string[];
+    /**
+     * Callback when a link is clicked.
+     *
+     * @param event - Link click event with href and parsed URL
+     * @returns true if handled (prevents default and legacy onLinkClick),
+     *          false/void to fall back to legacy onLinkClick prop or browser default
+     */
+    onLinkClick?: (event: LinkClickEvent) => boolean | void;
+}
 
 /**
  * Chat Adapter Interface
@@ -536,8 +588,10 @@ interface ChatAdapter {
     }>;
     /** Subscribe to locale change events */
     onLocaleChanged?(callback: (locale: string) => void): () => void;
-    /** Get current session resources from all connected apps */
+    /** Get session resources pushed by THIS app (local cache) */
     getSessionResources?(): StoredSessionResource[];
+    /** Fetch session resources from server (optionally filtered by agent) */
+    fetchSessionResources?(agentId?: string): Promise<StoredSessionResource[]>;
     /** Subscribe to session resource events (push/remove) */
     onSessionResourceEvent?(callback: (event: SessionResourceEvent) => void): () => void;
     /** Remove a session resource (user action from UI) */
@@ -630,4 +684,4 @@ declare function parseToolCalls(toolCalls: unknown): ToolCall[] | undefined;
  */
 declare function mergeConsecutiveAssistantMessages(rawMessages: ApiMessage[]): ChatMessage[];
 
-export { type ApiMessage, type AttachConfig, type AttachPosition, type AttachState, type AttachedResource, type AttachmentMenuItem, type AttachmentMenuItemType, type ChatAdapter, type ChatAdapterConfig, type ChatFontSize, type ChatMessage, type ChatPanelConfig, type ChatPanelMode, type ChatPanelPosition, type ChatThemeMode, type ChatUiConfigSerializable, type ChatUiStrings, type ConnectionErrorCode, type ConnectionStatus, type ContextProviderInfo, type ConversationDetail, type ConversationInfo, type FloatingWindowConfig, type HitlInterruptData, type Locale, type MessageBlock, type MessageRole, type ResourcePickerItem, type ResourcePickerState, type SdkAdapterConfig, type SendMessage, type SessionResource, type SessionResourceEvent, type StoredSessionResource, type StreamEvent, type ToolCall, type ToolCallStatus, type WindowPosition, createChatAdapter, createSdkAdapter, mergeConsecutiveAssistantMessages, parseToolCalls };
+export { type ApiMessage, type AttachConfig, type AttachPosition, type AttachState, type AttachedResource, type AttachmentMenuItem, type AttachmentMenuItemType, type ChatAdapter, type ChatAdapterConfig, type ChatFontSize, type ChatMessage, type ChatPanelConfig, type ChatPanelMode, type ChatPanelPosition, type ChatThemeMode, type ChatUiConfigSerializable, type ChatUiStrings, type ConnectionErrorCode, type ConnectionStatus, type ContextProviderInfo, type ConversationDetail, type ConversationInfo, type FloatingWindowConfig, type HitlInterruptData, type LinkClickEvent, type LinkHandlerConfig, type Locale, type MessageBlock, type MessageRole, type ResourcePickerItem, type ResourcePickerState, type SdkAdapterConfig, type SendMessage, type SessionResource, type SessionResourceEvent, type StoredSessionResource, type StreamEvent, type ToolCall, type ToolCallStatus, type WindowPosition, createChatAdapter, createSdkAdapter, mergeConsecutiveAssistantMessages, parseToolCalls };

package/dist/core/index.js

@@ -438,15 +438,32 @@ function createSessionResourceMethods(getSdk) {
       const sdk = getSdk();
       return sdk?.getSessionResources?.() || [];
     },
+    async fetchSessionResources(agentId) {
+      const sdk = getSdk();
+      if (!sdk) return [];
+      return sdk.fetchSessionResources?.(agentId) ?? [];
+    },
     onSessionResourceEvent(callback) {
       const sdk = getSdk();
       if (!sdk) return () => {
       };
-      const handler = (resourceId) => {
+      const pushHandler = (resource) => {
+        callback({ type: "resource_pushed", resource });
+      };
+      sdk.on("resourcePushed", pushHandler);
+      const removeHandler = (resourceId) => {
         callback({ type: "resource_removed", resourceId, source: "user" });
       };
-      sdk.on("resourceRemoved", handler);
-      return () => sdk.off("resourceRemoved", handler);
+      sdk.on("resourceRemoved", removeHandler);
+      const clearHandler = (appName) => {
+        callback({ type: "resources_cleared", appName });
+      };
+      sdk.on("resourcesCleared", clearHandler);
+      return () => {
+        sdk.off("resourcePushed", pushHandler);
+        sdk.off("resourceRemoved", removeHandler);
+        sdk.off("resourcesCleared", clearHandler);
+      };
     },
     async removeSessionResource(fullId) {
       const sdk = getSdk();

package/dist/core/index.mjs

@@ -399,15 +399,32 @@ function createSessionResourceMethods(getSdk) {
       const sdk = getSdk();
       return sdk?.getSessionResources?.() || [];
     },
+    async fetchSessionResources(agentId) {
+      const sdk = getSdk();
+      if (!sdk) return [];
+      return sdk.fetchSessionResources?.(agentId) ?? [];
+    },
     onSessionResourceEvent(callback) {
       const sdk = getSdk();
       if (!sdk) return () => {
       };
-      const handler = (resourceId) => {
+      const pushHandler = (resource) => {
+        callback({ type: "resource_pushed", resource });
+      };
+      sdk.on("resourcePushed", pushHandler);
+      const removeHandler = (resourceId) => {
         callback({ type: "resource_removed", resourceId, source: "user" });
       };
-      sdk.on("resourceRemoved", handler);
-      return () => sdk.off("resourceRemoved", handler);
+      sdk.on("resourceRemoved", removeHandler);
+      const clearHandler = (appName) => {
+        callback({ type: "resources_cleared", appName });
+      };
+      sdk.on("resourcesCleared", clearHandler);
+      return () => {
+        sdk.off("resourcePushed", pushHandler);
+        sdk.off("resourceRemoved", removeHandler);
+        sdk.off("resourcesCleared", clearHandler);
+      };
     },
     async removeSessionResource(fullId) {
       const sdk = getSdk();

package/dist/main/index.js

@@ -1915,6 +1915,16 @@ var ChatPanel = class {
         return { success: false, error: e instanceof Error ? e.message : "Failed to remove resource" };
       }
     });
+    import_electron2.ipcMain.handle("sanqian-chat:fetchSessionResources", async (_, params) => {
+      try {
+        const sdk = activeInstance2?.getSdk();
+        if (!sdk) return [];
+        return await sdk.fetchSessionResources(params?.agentId);
+      } catch (e) {
+        console.error("Failed to fetch session resources:", e);
+        return [];
+      }
+    });
     import_electron2.ipcMain.handle("chatPanel:getMode", () => {
       return activeInstance2?.getMode() ?? "floating";
     });
@@ -1981,6 +1991,7 @@ var ChatPanel = class {
     import_electron2.ipcMain.removeHandler("sanqian-chat:getResourceList");
     import_electron2.ipcMain.removeAllListeners("sanqian-chat:getSessionResourcesSync");
     import_electron2.ipcMain.removeHandler("sanqian-chat:removeSessionResource");
+    import_electron2.ipcMain.removeHandler("sanqian-chat:fetchSessionResources");
     import_electron2.ipcMain.removeHandler("chatPanel:getMode");
     import_electron2.ipcMain.removeHandler("chatPanel:setMode");
     import_electron2.ipcMain.removeHandler("chatPanel:toggleMode");

package/dist/main/index.mjs

@@ -1890,6 +1890,16 @@ var ChatPanel = class {
         return { success: false, error: e instanceof Error ? e.message : "Failed to remove resource" };
       }
     });
+    ipcMain2.handle("sanqian-chat:fetchSessionResources", async (_, params) => {
+      try {
+        const sdk = activeInstance2?.getSdk();
+        if (!sdk) return [];
+        return await sdk.fetchSessionResources(params?.agentId);
+      } catch (e) {
+        console.error("Failed to fetch session resources:", e);
+        return [];
+      }
+    });
     ipcMain2.handle("chatPanel:getMode", () => {
       return activeInstance2?.getMode() ?? "floating";
     });
@@ -1956,6 +1966,7 @@ var ChatPanel = class {
     ipcMain2.removeHandler("sanqian-chat:getResourceList");
     ipcMain2.removeAllListeners("sanqian-chat:getSessionResourcesSync");
     ipcMain2.removeHandler("sanqian-chat:removeSessionResource");
+    ipcMain2.removeHandler("sanqian-chat:fetchSessionResources");
     ipcMain2.removeHandler("chatPanel:getMode");
     ipcMain2.removeHandler("chatPanel:setMode");
     ipcMain2.removeHandler("chatPanel:toggleMode");

package/dist/preload/entry.js

@@ -43,6 +43,9 @@ function createSanqianChatApi() {
     getSessionResources: () => {
       return import_electron.ipcRenderer.sendSync("sanqian-chat:getSessionResourcesSync");
     },
+    fetchSessionResources: (agentId) => {
+      return import_electron.ipcRenderer.invoke("sanqian-chat:fetchSessionResources", agentId ? { agentId } : void 0);
+    },
     onSessionResourceEvent: (callback) => {
       const handler = (_, event) => {
         callback(event);

package/dist/preload/entry.mjs

@@ -1,7 +1,7 @@
 import {
   createChatPanelApi,
   createSanqianChatApi
-} from "../chunk-YBHGKM2H.mjs";
+} from "../chunk-27MEXKQU.mjs";
 
 // src/preload/entry.ts
 import { contextBridge } from "electron";

package/dist/preload/factories.d.mts

@@ -247,6 +247,7 @@ interface SanqianChatAPI {
     }>;
     onLocaleChanged(callback: (locale: string) => void): () => void;
     getSessionResources(): StoredSessionResource[];
+    fetchSessionResources(agentId?: string): Promise<StoredSessionResource[]>;
     onSessionResourceEvent(callback: (event: SessionResourceEvent) => void): () => void;
     removeSessionResource(fullId: string): Promise<{
         success: boolean;

package/dist/preload/factories.d.ts

@@ -247,6 +247,7 @@ interface SanqianChatAPI {
     }>;
     onLocaleChanged(callback: (locale: string) => void): () => void;
     getSessionResources(): StoredSessionResource[];
+    fetchSessionResources(agentId?: string): Promise<StoredSessionResource[]>;
     onSessionResourceEvent(callback: (event: SessionResourceEvent) => void): () => void;
     removeSessionResource(fullId: string): Promise<{
         success: boolean;

package/dist/preload/factories.js

@@ -63,6 +63,9 @@ function createSanqianChatApi() {
     getSessionResources: () => {
       return import_electron.ipcRenderer.sendSync("sanqian-chat:getSessionResourcesSync");
     },
+    fetchSessionResources: (agentId) => {
+      return import_electron.ipcRenderer.invoke("sanqian-chat:fetchSessionResources", agentId ? { agentId } : void 0);
+    },
     onSessionResourceEvent: (callback) => {
       const handler = (_, event) => {
         callback(event);

package/dist/preload/factories.mjs

@@ -1,7 +1,7 @@
 import {
   createChatPanelApi,
   createSanqianChatApi
-} from "../chunk-YBHGKM2H.mjs";
+} from "../chunk-27MEXKQU.mjs";
 export {
   createChatPanelApi,
   createSanqianChatApi

package/dist/preload/index.js

@@ -65,6 +65,9 @@ function createSanqianChatApi() {
     getSessionResources: () => {
       return import_electron.ipcRenderer.sendSync("sanqian-chat:getSessionResourcesSync");
     },
+    fetchSessionResources: (agentId) => {
+      return import_electron.ipcRenderer.invoke("sanqian-chat:fetchSessionResources", agentId ? { agentId } : void 0);
+    },
     onSessionResourceEvent: (callback) => {
       const handler = (_, event) => {
         callback(event);

package/dist/preload/index.mjs

@@ -1,7 +1,7 @@
 import {
   createChatPanelApi,
   createSanqianChatApi
-} from "../chunk-YBHGKM2H.mjs";
+} from "../chunk-27MEXKQU.mjs";
 export {
   createChatPanelApi,
   createSanqianChatApi

package/dist/renderer/index.d.mts

@@ -1,8 +1,8 @@
+import * as react from 'react';
+import react__default, { ReactNode, RefObject, CSSProperties } from 'react';
 import { ResourceType, HitlInterruptPayload, ContextListItem, HitlResponse, ResourceListOptions, SanqianSDK } from '@yushaw/sanqian-sdk';
 export { ContextListItem, HitlInterruptPayload, HitlInterruptType, HitlResponse, HitlRiskLevel, ResourceListOptions, ResourceListResult, ResourceType, ChatMessage as SdkChatMessage, ConversationDetail as SdkConversationDetail, ConversationInfo as SdkConversationInfo, ToolCall as SdkToolCall } from '@yushaw/sanqian-sdk';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as react from 'react';
-import { ReactNode, RefObject, CSSProperties } from 'react';
 export { ChatMessage, ChatStreamEvent, SDKConfig, SanqianSDK, ToolDefinition } from '@yushaw/sanqian-sdk/browser';
 
 /**
@@ -438,6 +438,57 @@ type SessionResourceEvent = {
     type: 'resources_cleared';
     appName: string;
 };
+/**
+ * Link click event with parsed URL information
+ */
+interface LinkClickEvent {
+    /** Original href string */
+    href: string;
+    /** Parsed URL object (undefined if invalid URL) */
+    url?: URL;
+    /** Original React mouse event */
+    originalEvent: react__default.MouseEvent;
+}
+/**
+ * Link handler configuration for custom protocol support
+ *
+ * Allows third-party apps to handle custom URL schemes (e.g., sanqian-notes://)
+ * in chat messages.
+ *
+ * @example
+ * ```tsx
+ * <CompactChat
+ *   linkHandler={{
+ *     allowedProtocols: ['sanqian-notes:', 'obsidian:'],
+ *     onLinkClick: (event) => {
+ *       if (event.href.startsWith('sanqian-notes://')) {
+ *         // Handle note navigation
+ *         return true; // Prevent default behavior
+ *       }
+ *       return false; // Let default behavior handle it
+ *     }
+ *   }}
+ * />
+ * ```
+ */
+interface LinkHandlerConfig {
+    /**
+     * Additional protocols to allow in markdown links.
+     * These will be merged with default protocols ['workspace:', 'download:'].
+     * Without this, rehype-harden will strip links with unknown protocols.
+     *
+     * @example ['sanqian-notes:', 'obsidian:', 'bear:']
+     */
+    allowedProtocols?: string[];
+    /**
+     * Callback when a link is clicked.
+     *
+     * @param event - Link click event with href and parsed URL
+     * @returns true if handled (prevents default and legacy onLinkClick),
+     *          false/void to fall back to legacy onLinkClick prop or browser default
+     */
+    onLinkClick?: (event: LinkClickEvent) => boolean | void;
+}
 
 /**
  * Chat Adapter Interface
@@ -540,8 +591,10 @@ interface ChatAdapter {
     }>;
     /** Subscribe to locale change events */
     onLocaleChanged?(callback: (locale: string) => void): () => void;
-    /** Get current session resources from all connected apps */
+    /** Get session resources pushed by THIS app (local cache) */
     getSessionResources?(): StoredSessionResource[];
+    /** Fetch session resources from server (optionally filtered by agent) */
+    fetchSessionResources?(agentId?: string): Promise<StoredSessionResource[]>;
     /** Subscribe to session resource events (push/remove) */
     onSessionResourceEvent?(callback: (event: SessionResourceEvent) => void): () => void;
     /** Remove a session resource (user action from UI) */
@@ -1267,6 +1320,27 @@ interface CompactChatProps {
     getErrorMessage?: (errorCode: string) => string;
     /** Use floating window container style (for transparent Electron windows) */
     floating?: boolean;
+    /**
+     * Link handler configuration for custom protocol support.
+     * Allows third-party apps to handle custom URL schemes (e.g., sanqian-notes://)
+     * in chat message content.
+     *
+     * @example
+     * ```tsx
+     * <CompactChat
+     *   linkHandler={{
+     *     allowedProtocols: ['sanqian-notes:'],
+     *     onLinkClick: (event) => {
+     *       if (event.href.startsWith('sanqian-notes://')) {
+     *         // Handle navigation
+     *         return true;
+     *       }
+     *     }
+     *   }}
+     * />
+     * ```
+     */
+    linkHandler?: LinkHandlerConfig;
 }
 declare const CompactChat: react.NamedExoticComponent<CompactChatProps>;
 
@@ -1392,6 +1466,8 @@ interface ResourcePickerProps {
     anchorRef?: React.RefObject<HTMLElement>;
     /** Locale for i18n */
     locale?: 'en' | 'zh';
+    /** Additional class name (for theme support) */
+    className?: string;
 }
 declare const ResourcePicker: react.NamedExoticComponent<ResourcePickerProps>;
 
@@ -1454,6 +1530,8 @@ interface AddResourceButtonProps {
     disabled?: boolean;
     /** Locale */
     locale?: 'en' | 'zh';
+    /** Theme class for dark mode support */
+    themeClass?: string;
 }
 declare const AddResourceButton: react.NamedExoticComponent<AddResourceButtonProps>;
 
@@ -1519,8 +1597,16 @@ interface MarkdownRendererProps {
             children?: ReactNode;
         }>;
     };
-    /** Callback when a link is clicked */
+    /**
+     * Callback when a link is clicked (legacy, use linkHandler for new code)
+     * @deprecated Use linkHandler.onLinkClick instead
+     */
     onLinkClick?: (href: string, event: React.MouseEvent) => void;
+    /**
+     * Link handler configuration for custom protocol support.
+     * Allows third-party apps to handle custom URL schemes (e.g., sanqian-notes://)
+     */
+    linkHandler?: LinkHandlerConfig;
 }
 declare const MarkdownRenderer: react.NamedExoticComponent<MarkdownRendererProps>;
 
@@ -1551,4 +1637,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 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 };
+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 };