@yushaw/sanqian-chat 0.2.4 → 0.2.8

package/README.md

@@ -99,6 +99,19 @@ src/renderer/styles/
 
 ## Changelog
 
+### 0.2.7 (2026-01-06)
+- **Added**: External resource reference support
+  - `useResourcePicker` hook - manage resource picker state, search, pagination
+  - `ResourcePicker` component - two-level picker (providers → resources)
+  - `ResourceChip` / `ResourceChipList` - display attached resources
+  - `AddResourceButton` - + button with dropdown menu
+- **Added**: `ChatAdapter` extensions: `listResourceProviders`, `getResourceList`, `onLocaleChanged`
+- **Added**: `FloatingWindow.notifyLocaleChanged(locale)` and `ChatPanel.notifyLocaleChanged(locale)` - notify renderer when locale changes
+- **Added**: `sendMessage` now accepts `options.attachedResources`
+- **Added**: Message rendering displays attached resources in user messages
+- **Added**: New types: `AttachedResource`, `ResourcePickerItem`, `ContextProviderInfo`
+- **Changed**: `AppContextProvider.getList` now accepts `options` parameter for search/pagination
+
 ### 2025-01-03
 - **Added**: Focus persistence - input keeps focus when clicking empty areas (unless selecting text)
 - **Added**: `Cmd+N` (macOS) / `Ctrl+N` (Windows) keyboard shortcut for new chat
@@ -114,3 +127,24 @@ src/renderer/styles/
 - **Fixed**: `console.log` only outputs in `devMode`
 - **Fixed**: Global style pollution - default to `'safe'` mode (no Tailwind preflight)
 - **Fixed**: `cancelStream` now calls `sdk.cancelRun()` for real cancellation
+
+## Tech Debt / Future Optimizations
+
+### Low Priority (记录于 2026-01-05)
+
+1. **FloatingChat 命名优化**
+   - `FloatingChat` 实际是通用组件（embedded + floating），名字有误导
+   - 可考虑改名为 `ChatContainer` 或 `ChatView`
+   - 文件：`src/renderer/components/FloatingChat.tsx`
+
+2. **Header 按钮复用**
+   - `FloatingChat` 内联了 `<ModeToggleButton>` + `<AttachButton>`
+   - 可改用 `<PanelHeaderButtons />` 与 `CompactChat` 保持一致
+   - 文件：`src/renderer/components/FloatingChat.tsx:134-136`
+
+
+3. **useCallback 依赖优化** (微优化)
+   - `useAttachState.ts:68`: toggle 依赖 state，每次 state 变化重建
+   - `useChatPanel.ts:86`: toggleMode 依赖 mode，每次 mode 变化重建
+   - 可用 useRef 避免重建，但当前影响可忽略
+   - 文件：`src/renderer/hooks/useAttachState.ts`, `src/renderer/hooks/useChatPanel.ts`

package/dist/chunk-S6HCEDWX.mjs

@@ -0,0 +1,86 @@
+// src/preload/factories.ts
+import { ipcRenderer } from "electron";
+function createSanqianChatApi() {
+  return {
+    connect: () => ipcRenderer.invoke("sanqian-chat:connect"),
+    isConnected: () => ipcRenderer.invoke("sanqian-chat:isConnected"),
+    stream: (params) => ipcRenderer.invoke("sanqian-chat:stream", params),
+    cancelStream: (params) => ipcRenderer.invoke("sanqian-chat:cancelStream", params),
+    onStreamEvent: (callback) => {
+      const handler = (_, data) => {
+        callback(data.streamId, data.event);
+      };
+      ipcRenderer.on("sanqian-chat:streamEvent", handler);
+      return () => ipcRenderer.removeListener("sanqian-chat:streamEvent", handler);
+    },
+    sendHitlResponse: (params) => ipcRenderer.invoke("sanqian-chat:hitlResponse", params),
+    listConversations: (params) => ipcRenderer.invoke("sanqian-chat:listConversations", params),
+    getConversation: (params) => ipcRenderer.invoke("sanqian-chat:getConversation", params),
+    deleteConversation: (params) => ipcRenderer.invoke("sanqian-chat:deleteConversation", params),
+    hide: () => ipcRenderer.invoke("sanqian-chat:hide"),
+    setAlwaysOnTop: (params) => ipcRenderer.invoke("sanqian-chat:setAlwaysOnTop", params),
+    getAlwaysOnTop: () => ipcRenderer.invoke("sanqian-chat:getAlwaysOnTop"),
+    getUiConfig: () => ipcRenderer.invoke("sanqian-chat:getUiConfig"),
+    setBackgroundColor: (params) => ipcRenderer.invoke("sanqian-chat:setBackgroundColor", params),
+    getPlatform: () => process.platform,
+    // Resource Picker
+    listResourceProviders: () => ipcRenderer.invoke("sanqian-chat:listResourceProviders"),
+    getResourceList: (params) => ipcRenderer.invoke("sanqian-chat:getResourceList", params),
+    // Locale
+    onLocaleChanged: (callback) => {
+      const handler = (_, data) => {
+        callback(data.locale);
+      };
+      ipcRenderer.on("sanqian-chat:localeChanged", handler);
+      return () => ipcRenderer.removeListener("sanqian-chat:localeChanged", handler);
+    }
+  };
+}
+function createChatPanelApi() {
+  return {
+    // Mode
+    getMode: () => ipcRenderer.invoke("chatPanel:getMode"),
+    setMode: (mode) => ipcRenderer.invoke("chatPanel:setMode", mode),
+    toggleMode: () => ipcRenderer.invoke("chatPanel:toggleMode"),
+    onModeChanged: (callback) => {
+      const handler = (_, data) => {
+        callback(data.mode);
+      };
+      ipcRenderer.on("chatPanel:modeChanged", handler);
+      return () => ipcRenderer.removeListener("chatPanel:modeChanged", handler);
+    },
+    // Visibility
+    isVisible: () => ipcRenderer.invoke("chatPanel:isVisible"),
+    show: () => ipcRenderer.invoke("chatPanel:show"),
+    hide: () => ipcRenderer.invoke("chatPanel:hide"),
+    toggle: () => ipcRenderer.invoke("chatPanel:toggle"),
+    onVisibilityChanged: (callback) => {
+      const handler = (_, data) => {
+        callback(data.visible);
+      };
+      ipcRenderer.on("chatPanel:visibilityChanged", handler);
+      return () => ipcRenderer.removeListener("chatPanel:visibilityChanged", handler);
+    },
+    // Attach state
+    getAttachState: () => ipcRenderer.invoke("chatPanel:getAttachState"),
+    toggleAttach: () => ipcRenderer.invoke("chatPanel:toggleAttach"),
+    onAttachStateChanged: (callback) => {
+      const handler = (_, data) => {
+        callback(data.state);
+      };
+      ipcRenderer.on("chatPanel:attachStateChanged", handler);
+      return () => ipcRenderer.removeListener("chatPanel:attachStateChanged", handler);
+    },
+    // Width
+    getWidth: () => ipcRenderer.invoke("chatPanel:getWidth"),
+    setWidth: (width, animate) => ipcRenderer.invoke("chatPanel:setWidth", { width, animate }),
+    onResizeEnd: () => ipcRenderer.invoke("chatPanel:onResizeEnd"),
+    // UI Config
+    getUiConfig: () => ipcRenderer.invoke("chatPanel:getUiConfig")
+  };
+}
+
+export {
+  createSanqianChatApi,
+  createChatPanelApi
+};

package/dist/core/index.d.mts

@@ -1,5 +1,5 @@
-import { HitlInterruptPayload, HitlResponse, SanqianSDK } from '@yushaw/sanqian-sdk';
-export { ChatStreamEvent, HitlInterruptPayload, HitlInterruptType, HitlResponse, HitlRiskLevel, ChatMessage as SdkChatMessage, ConversationDetail as SdkConversationDetail, ConversationInfo as SdkConversationInfo, ToolCall as SdkToolCall } from '@yushaw/sanqian-sdk';
+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';
 
 /**
  * @yushaw/sanqian-chat Core Types
@@ -57,6 +57,12 @@ interface ChatUiStrings {
     hitlInputRequest: string;
     hitlApprovalRequired: string;
     hitlInputRequired: string;
+    attachWindow: string;
+    detachWindow: string;
+    floatWindow: string;
+    embedWindow: string;
+    collapseSidebar: string;
+    history: string;
 }
 type ChatThemeMode = 'light' | 'dark' | 'auto';
 type ChatFontSize = 'small' | 'normal' | 'large' | 'extra-large';
@@ -114,6 +120,8 @@ interface ChatMessage {
     finalContent?: string;
     isComplete?: boolean;
     filePaths?: string[];
+    /** Attached external resources (for user messages) */
+    attachedResources?: AttachedResource[];
 }
 /** Conversation info for UI */
 interface ConversationInfo {
@@ -154,6 +162,233 @@ interface FloatingWindowConfig {
     /** Optional full path for window state file */
     windowStatePath?: string;
 }
+type ChatPanelMode = 'embedded' | 'floating';
+type ChatPanelPosition = 'right' | 'left';
+type AttachState = 'attached' | 'detached' | 'unavailable';
+type AttachPosition = 'right' | 'left' | 'top' | 'bottom';
+/**
+ * Window attachment configuration for floating mode
+ */
+interface AttachConfig {
+    /**
+     * Target window to attach to (BrowserWindow instance)
+     */
+    window: unknown;
+    /**
+     * Attach position relative to target window
+     * @default 'right'
+     */
+    position?: AttachPosition;
+    /**
+     * Gap between windows (px)
+     * @default 0
+     */
+    gap?: number;
+    /**
+     * Sync height/width with target window
+     * @default true
+     */
+    syncSize?: boolean;
+    /**
+     * Behavior when target window is minimized
+     * @default 'hide'
+     */
+    onMinimize?: 'hide' | 'detach' | 'minimize';
+    /**
+     * Behavior when target window is closed
+     * @default 'hide'
+     */
+    onClose?: 'hide' | 'destroy';
+    /**
+     * Allow user to drag and detach
+     * @default true
+     */
+    allowDetach?: boolean;
+    /**
+     * Allow re-attach when dragged near target edge
+     * @default true
+     */
+    allowReattach?: boolean;
+    /**
+     * Distance threshold for re-attach (px)
+     * @default 20
+     */
+    reattachThreshold?: number;
+}
+/**
+ * ChatPanel configuration
+ */
+interface ChatPanelConfig {
+    /**
+     * Host window (BaseWindow supports embedded, BrowserWindow floating only)
+     */
+    hostWindow: unknown;
+    /**
+     * Host window's main content view (required for embedded mode)
+     */
+    hostMainView?: unknown;
+    /**
+     * Initial mode
+     * @default 'embedded'
+     */
+    initialMode?: ChatPanelMode;
+    /**
+     * Embed position
+     * @default 'right'
+     */
+    position?: ChatPanelPosition;
+    /**
+     * Panel width
+     * @default 360
+     */
+    width?: number;
+    /**
+     * Minimum width
+     * @default 240
+     */
+    minWidth?: number;
+    /**
+     * Minimum host content width when showing panel.
+     * If window is too narrow, expand it to ensure main content has this width.
+     * Set to 0 to disable auto-expand.
+     * @default 0
+     */
+    minHostContentWidth?: number;
+    /**
+     * Allow resize
+     * @default true
+     */
+    resizable?: boolean;
+    /**
+     * Preload script path
+     */
+    preloadPath: string;
+    /**
+     * Renderer HTML path or URL
+     */
+    rendererPath: string;
+    /**
+     * Dev mode - load URL instead of file
+     */
+    devMode?: boolean;
+    /**
+     * SDK client getter
+     */
+    getClient: () => unknown;
+    /**
+     * Agent ID getter
+     */
+    getAgentId: () => string | null;
+    /**
+     * Layout change callback (for host app to adjust main content)
+     */
+    onLayoutChange?: (layout: {
+        mainWidth: number;
+        chatWidth: number;
+        chatVisible: boolean;
+    }) => void;
+    /**
+     * Shortcut configuration
+     */
+    shortcuts?: {
+        /** Toggle show/hide, false to disable */
+        toggle?: string | false;
+        /** Toggle mode, false to disable */
+        toggleMode?: string | false;
+    };
+    /**
+     * Floating window attach configuration
+     */
+    attach?: AttachConfig;
+    /**
+     * State persistence key
+     */
+    stateKey?: string;
+    /**
+     * UI config for renderer
+     */
+    uiConfig?: ChatUiConfigSerializable;
+}
+/**
+ * Context provider info for UI display (in + menu)
+ */
+interface ContextProviderInfo {
+    /** Full provider ID (format: "appName:providerId") */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description */
+    description: string;
+    /** App name (extracted from id) */
+    appName: string;
+    /** Whether app is currently connected */
+    isConnected?: boolean;
+    /** Whether provider supports getList (resource picker) */
+    hasGetList?: boolean;
+    /** Whether provider supports getCurrent (auto-inject) */
+    hasGetCurrent?: boolean;
+}
+/**
+ * Resource item for picker display (extends ContextListItem with provider info)
+ */
+interface ResourcePickerItem extends ContextListItem {
+    /** Full provider ID that owns this resource */
+    providerId: string;
+    /** Provider display name */
+    providerName?: string;
+}
+/**
+ * Attached resource reference (selected by user)
+ */
+interface AttachedResource {
+    /** Full provider ID (format: "appName:providerId") */
+    providerId: string;
+    /** Resource ID (from ContextListItem.id) */
+    resourceId: string;
+    /** Display title */
+    title: string;
+    /** Optional summary for tooltip */
+    summary?: string;
+    /** Resource type for icon/styling */
+    type?: ResourceType;
+    /** Icon emoji or URL */
+    icon?: string;
+}
+/**
+ * Resource picker state
+ */
+interface ResourcePickerState {
+    /** Currently loading */
+    isLoading: boolean;
+    /** Search query */
+    query: string;
+    /** Available items grouped by provider */
+    itemsByProvider: Record<string, ResourcePickerItem[]>;
+    /** Whether more items are available (for pagination) */
+    hasMoreByProvider: Record<string, boolean>;
+    /** Error message if any */
+    error?: string;
+}
+/**
+ * Attachment menu item type
+ */
+type AttachmentMenuItemType = 'upload' | 'provider';
+/**
+ * Attachment menu item for + button dropdown
+ */
+interface AttachmentMenuItem {
+    type: AttachmentMenuItemType;
+    /** For 'upload': 'file' or 'image'. For 'provider': provider ID */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Icon emoji or URL */
+    icon?: string;
+    /** Description or subtitle */
+    description?: string;
+    /** Whether currently available (e.g., app connected) */
+    available?: boolean;
+}
 
 /**
  * Chat Adapter Interface
@@ -237,10 +472,23 @@ interface ChatAdapter {
     deleteConversation(id: string): Promise<void>;
     chatStream(messages: SendMessage[], conversationId: string | undefined, onEvent: (event: StreamEvent) => void, options?: {
         agentId?: string | null;
+        /** Attached context provider IDs (e.g., ["sanqian-notes:notes"]) - for getCurrent */
+        attachedContexts?: string[];
+        /** Attached resource references (e.g., ["sanqian-notes:notes:abc123"]) - for getById */
+        attachedResources?: string[];
     }): Promise<{
         cancel: () => void;
     }>;
     sendHitlResponse?(response: HitlResponse, runId?: string): void;
+    /** List available context providers */
+    listResourceProviders?(): Promise<ContextProviderInfo[]>;
+    /** Get resource list from a provider with search/pagination */
+    getResourceList?(providerId: string, options?: ResourceListOptions): Promise<{
+        items: ResourcePickerItem[];
+        hasMore?: boolean;
+    }>;
+    /** Subscribe to locale change events */
+    onLocaleChanged?(callback: (locale: string) => void): () => void;
     cleanup?(): void;
 }
 /** SDK adapter config */
@@ -327,4 +575,4 @@ declare function parseToolCalls(toolCalls: unknown): ToolCall[] | undefined;
  */
 declare function mergeConsecutiveAssistantMessages(rawMessages: ApiMessage[]): ChatMessage[];
 
-export { type ApiMessage, type ChatAdapter, type ChatAdapterConfig, type ChatFontSize, type ChatMessage, type ChatThemeMode, type ChatUiConfigSerializable, type ChatUiStrings, type ConnectionErrorCode, type ConnectionStatus, type ConversationDetail, type ConversationInfo, type FloatingWindowConfig, type HitlInterruptData, type Locale, type MessageBlock, type MessageRole, type SdkAdapterConfig, type SendMessage, 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 Locale, type MessageBlock, type MessageRole, type ResourcePickerItem, type ResourcePickerState, type SdkAdapterConfig, type SendMessage, type StreamEvent, type ToolCall, type ToolCallStatus, type WindowPosition, createChatAdapter, createSdkAdapter, mergeConsecutiveAssistantMessages, parseToolCalls };