@yushaw/sanqian-chat 0.2.13 → 0.2.14

package/README.md

@@ -148,3 +148,36 @@ src/renderer/styles/
    - `useChatPanel.ts:86`: toggleMode 依赖 mode，每次 mode 变化重建
    - 可用 useRef 避免重建，但当前影响可忽略
    - 文件：`src/renderer/hooks/useAttachState.ts`, `src/renderer/hooks/useChatPanel.ts`
+
+
+## Changelog
+
+### 2026-01-11
+
+**Ask AI 焦点管理**
+
+- `ChatPanel.focusInput()` 方法：完整的焦点管理，支持 floating 和 embedded 模式
+  - macOS: `app.focus({ steal: true })` 确保应用获得前台焦点
+  - `floatingWindow.focus()` / `webContents.focus()` 确保窗口和 BrowserView 获得焦点
+  - IPC 消息通知渲染进程聚焦输入框
+- `ChatAdapter.onFocusInput` 接口：渲染进程监听焦点事件
+- `SanqianChatAPI.onFocusInput` preload API
+
+**Bug 修复**
+
+- 修复 session resources 发送前被删除的问题（移除了发送时的 `removeSessionResource` 调用）
+- 修复 `AttachedResourceTags` 深色模式样式（使用正确的 CSS 变量）
+- 清理 chip 布局的多余 padding/margin
+
+### 2026-01-10
+
+**Session Resources 功能实现**
+
+新增应用主动推送临时上下文的能力（Session Resources）：
+
+- `ChatAdapter` 接口新增 `getSessionResources`、`onSessionResourceEvent`、`removeSessionResource` 方法
+- `useChat` hook 新增 `sessionResources` 状态和 `removeSessionResource` 回调
+- `FloatingChat` / `CompactChat` 组件支持显示 session resources chips
+- IPC adapter 实现 session resources 相关 API
+
+详见设计文档：`docs/session-resources-design.md`

package/dist/{chunk-S6HCEDWX.mjs → chunk-YBHGKM2H.mjs}

@@ -33,6 +33,24 @@ function createSanqianChatApi() {
       };
       ipcRenderer.on("sanqian-chat:localeChanged", handler);
       return () => ipcRenderer.removeListener("sanqian-chat:localeChanged", handler);
+    },
+    // Session Resources
+    getSessionResources: () => {
+      return ipcRenderer.sendSync("sanqian-chat:getSessionResourcesSync");
+    },
+    onSessionResourceEvent: (callback) => {
+      const handler = (_, event) => {
+        callback(event);
+      };
+      ipcRenderer.on("sanqian-chat:sessionResourceEvent", handler);
+      return () => ipcRenderer.removeListener("sanqian-chat:sessionResourceEvent", handler);
+    },
+    removeSessionResource: (fullId) => ipcRenderer.invoke("sanqian-chat:removeSessionResource", { fullId }),
+    // Focus
+    onFocusInput: (callback) => {
+      const handler = () => callback();
+      ipcRenderer.on("sanqian-chat:focusInput", handler);
+      return () => ipcRenderer.removeListener("sanqian-chat:focusInput", handler);
     }
   };
 }

package/dist/core/index.d.mts

@@ -63,6 +63,7 @@ interface ChatUiStrings {
     embedWindow: string;
     collapseSidebar: string;
     history: string;
+    remove: string;
 }
 type ChatThemeMode = 'light' | 'dark' | 'auto';
 type ChatFontSize = 'small' | 'normal' | 'large' | 'extra-large';
@@ -389,6 +390,50 @@ interface AttachmentMenuItem {
     /** Whether currently available (e.g., app connected) */
     available?: boolean;
 }
+/**
+ * Session resource pushed by an app.
+ * Content is provided at push time (not fetched like attached_resources).
+ * Global scope - visible in all Chat UI instances, persists until app disconnects.
+ */
+interface SessionResource {
+    /** Resource ID (auto-generated if not provided) */
+    id?: string;
+    /** Display title (required) */
+    title: string;
+    /** Content (required, format controlled by app) */
+    content: string;
+    /** Optional summary for UI tooltip */
+    summary?: string;
+    /** Optional icon (emoji or URL) */
+    icon?: string;
+    /** Optional resource type for styling */
+    type?: ResourceType;
+}
+/**
+ * Stored session resource with full metadata (internal use)
+ */
+interface StoredSessionResource extends SessionResource {
+    /** Full ID: "appName:resourceId" */
+    fullId: string;
+    /** Source app name */
+    appName: string;
+    /** Push timestamp (ISO 8601) */
+    pushedAt: string;
+}
+/**
+ * Session resource event from backend
+ */
+type SessionResourceEvent = {
+    type: 'resource_pushed';
+    resource: StoredSessionResource;
+} | {
+    type: 'resource_removed';
+    resourceId: string;
+    source: 'app' | 'user';
+} | {
+    type: 'resources_cleared';
+    appName: string;
+};
 
 /**
  * Chat Adapter Interface
@@ -476,6 +521,8 @@ interface ChatAdapter {
         attachedContexts?: string[];
         /** Attached resource references (e.g., ["sanqian-notes:notes:abc123"]) - for getById */
         attachedResources?: string[];
+        /** Session resources pushed by apps (fullId list) */
+        sessionResources?: string[];
     }): Promise<{
         cancel: () => void;
     }>;
@@ -489,6 +536,14 @@ interface ChatAdapter {
     }>;
     /** Subscribe to locale change events */
     onLocaleChanged?(callback: (locale: string) => void): () => void;
+    /** Get current session resources from all connected apps */
+    getSessionResources?(): StoredSessionResource[];
+    /** Subscribe to session resource events (push/remove) */
+    onSessionResourceEvent?(callback: (event: SessionResourceEvent) => void): () => void;
+    /** Remove a session resource (user action from UI) */
+    removeSessionResource?(fullId: string): Promise<void>;
+    /** Subscribe to focus input events (e.g., from main process) */
+    onFocusInput?(callback: () => void): () => void;
     cleanup?(): void;
 }
 /** SDK adapter config */
@@ -575,4 +630,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 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 SessionResource, type SessionResourceEvent, type StoredSessionResource, type StreamEvent, type ToolCall, type ToolCallStatus, type WindowPosition, createChatAdapter, createSdkAdapter, mergeConsecutiveAssistantMessages, parseToolCalls };

package/dist/core/index.d.ts

@@ -63,6 +63,7 @@ interface ChatUiStrings {
     embedWindow: string;
     collapseSidebar: string;
     history: string;
+    remove: string;
 }
 type ChatThemeMode = 'light' | 'dark' | 'auto';
 type ChatFontSize = 'small' | 'normal' | 'large' | 'extra-large';
@@ -389,6 +390,50 @@ interface AttachmentMenuItem {
     /** Whether currently available (e.g., app connected) */
     available?: boolean;
 }
+/**
+ * Session resource pushed by an app.
+ * Content is provided at push time (not fetched like attached_resources).
+ * Global scope - visible in all Chat UI instances, persists until app disconnects.
+ */
+interface SessionResource {
+    /** Resource ID (auto-generated if not provided) */
+    id?: string;
+    /** Display title (required) */
+    title: string;
+    /** Content (required, format controlled by app) */
+    content: string;
+    /** Optional summary for UI tooltip */
+    summary?: string;
+    /** Optional icon (emoji or URL) */
+    icon?: string;
+    /** Optional resource type for styling */
+    type?: ResourceType;
+}
+/**
+ * Stored session resource with full metadata (internal use)
+ */
+interface StoredSessionResource extends SessionResource {
+    /** Full ID: "appName:resourceId" */
+    fullId: string;
+    /** Source app name */
+    appName: string;
+    /** Push timestamp (ISO 8601) */
+    pushedAt: string;
+}
+/**
+ * Session resource event from backend
+ */
+type SessionResourceEvent = {
+    type: 'resource_pushed';
+    resource: StoredSessionResource;
+} | {
+    type: 'resource_removed';
+    resourceId: string;
+    source: 'app' | 'user';
+} | {
+    type: 'resources_cleared';
+    appName: string;
+};
 
 /**
  * Chat Adapter Interface
@@ -476,6 +521,8 @@ interface ChatAdapter {
         attachedContexts?: string[];
         /** Attached resource references (e.g., ["sanqian-notes:notes:abc123"]) - for getById */
         attachedResources?: string[];
+        /** Session resources pushed by apps (fullId list) */
+        sessionResources?: string[];
     }): Promise<{
         cancel: () => void;
     }>;
@@ -489,6 +536,14 @@ interface ChatAdapter {
     }>;
     /** Subscribe to locale change events */
     onLocaleChanged?(callback: (locale: string) => void): () => void;
+    /** Get current session resources from all connected apps */
+    getSessionResources?(): StoredSessionResource[];
+    /** Subscribe to session resource events (push/remove) */
+    onSessionResourceEvent?(callback: (event: SessionResourceEvent) => void): () => void;
+    /** Remove a session resource (user action from UI) */
+    removeSessionResource?(fullId: string): Promise<void>;
+    /** Subscribe to focus input events (e.g., from main process) */
+    onFocusInput?(callback: () => void): () => void;
     cleanup?(): void;
 }
 /** SDK adapter config */
@@ -575,4 +630,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 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 SessionResource, type SessionResourceEvent, type StoredSessionResource, type StreamEvent, type ToolCall, type ToolCallStatus, type WindowPosition, createChatAdapter, createSdkAdapter, mergeConsecutiveAssistantMessages, parseToolCalls };

package/dist/core/index.js

@@ -413,7 +413,8 @@ function createChatAdapter(config) {
         {
           conversationId,
           persistHistory: config.persistHistory ?? false,
-          attachedResources: options?.attachedResources
+          attachedResources: options?.attachedResources,
+          sessionResources: options?.sessionResources
         }
       );
       return processStreamEvents(stream, onEvent, sdk, (id) => {
@@ -426,6 +427,31 @@ function createChatAdapter(config) {
       if (id) {
         sdkInstance.sendHitlResponse(id, response);
       }
+    },
+    // Session Resources (delegated to shared helper)
+    ...createSessionResourceMethods(() => sdkInstance)
+  };
+}
+function createSessionResourceMethods(getSdk) {
+  return {
+    getSessionResources() {
+      const sdk = getSdk();
+      return sdk?.getSessionResources?.() || [];
+    },
+    onSessionResourceEvent(callback) {
+      const sdk = getSdk();
+      if (!sdk) return () => {
+      };
+      const handler = (resourceId) => {
+        callback({ type: "resource_removed", resourceId, source: "user" });
+      };
+      sdk.on("resourceRemoved", handler);
+      return () => sdk.off("resourceRemoved", handler);
+    },
+    async removeSessionResource(fullId) {
+      const sdk = getSdk();
+      if (!sdk) return;
+      await sdk.removeSessionResource?.(fullId);
     }
   };
 }
@@ -515,10 +541,10 @@ function processStreamEvents(stream, onEvent, sdk, setCurrentRunId) {
   return {
     cancel: () => {
       controller.abort();
-      const sdkWithCancel = sdk;
-      if (currentRunId && typeof sdkWithCancel.cancelRun === "function") {
+      const extendedSdk = sdk;
+      if (currentRunId && typeof extendedSdk.cancelRun === "function") {
         try {
-          sdkWithCancel.cancelRun(currentRunId);
+          extendedSdk.cancelRun(currentRunId);
         } catch (e) {
           console.warn("[chat adapter] Failed to cancel run:", e);
         }
@@ -638,7 +664,8 @@ function createSdkAdapter(config) {
         sdkMessages,
         {
           conversationId,
-          attachedResources: options?.attachedResources
+          attachedResources: options?.attachedResources,
+          sessionResources: options?.sessionResources
         }
       );
       return processStreamEvents(stream, onEvent, sdk, (id) => {
@@ -652,7 +679,9 @@ function createSdkAdapter(config) {
       if (id) {
         sdk.sendHitlResponse(id, response);
       }
-    }
+    },
+    // Session Resources (delegated to shared helper)
+    ...createSessionResourceMethods(config.getSdk)
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/core/index.mjs

@@ -374,7 +374,8 @@ function createChatAdapter(config) {
         {
           conversationId,
           persistHistory: config.persistHistory ?? false,
-          attachedResources: options?.attachedResources
+          attachedResources: options?.attachedResources,
+          sessionResources: options?.sessionResources
         }
       );
       return processStreamEvents(stream, onEvent, sdk, (id) => {
@@ -387,6 +388,31 @@ function createChatAdapter(config) {
       if (id) {
         sdkInstance.sendHitlResponse(id, response);
       }
+    },
+    // Session Resources (delegated to shared helper)
+    ...createSessionResourceMethods(() => sdkInstance)
+  };
+}
+function createSessionResourceMethods(getSdk) {
+  return {
+    getSessionResources() {
+      const sdk = getSdk();
+      return sdk?.getSessionResources?.() || [];
+    },
+    onSessionResourceEvent(callback) {
+      const sdk = getSdk();
+      if (!sdk) return () => {
+      };
+      const handler = (resourceId) => {
+        callback({ type: "resource_removed", resourceId, source: "user" });
+      };
+      sdk.on("resourceRemoved", handler);
+      return () => sdk.off("resourceRemoved", handler);
+    },
+    async removeSessionResource(fullId) {
+      const sdk = getSdk();
+      if (!sdk) return;
+      await sdk.removeSessionResource?.(fullId);
     }
   };
 }
@@ -476,10 +502,10 @@ function processStreamEvents(stream, onEvent, sdk, setCurrentRunId) {
   return {
     cancel: () => {
       controller.abort();
-      const sdkWithCancel = sdk;
-      if (currentRunId && typeof sdkWithCancel.cancelRun === "function") {
+      const extendedSdk = sdk;
+      if (currentRunId && typeof extendedSdk.cancelRun === "function") {
         try {
-          sdkWithCancel.cancelRun(currentRunId);
+          extendedSdk.cancelRun(currentRunId);
         } catch (e) {
           console.warn("[chat adapter] Failed to cancel run:", e);
         }
@@ -599,7 +625,8 @@ function createSdkAdapter(config) {
         sdkMessages,
         {
           conversationId,
-          attachedResources: options?.attachedResources
+          attachedResources: options?.attachedResources,
+          sessionResources: options?.sessionResources
         }
       );
       return processStreamEvents(stream, onEvent, sdk, (id) => {
@@ -613,7 +640,9 @@ function createSdkAdapter(config) {
       if (id) {
         sdk.sendHitlResponse(id, response);
       }
-    }
+    },
+    // Session Resources (delegated to shared helper)
+    ...createSessionResourceMethods(config.getSdk)
   };
 }
 export {

package/dist/main/index.d.mts

@@ -192,7 +192,7 @@ interface AppEmbeddingConfig {
 /**
  * Events emitted by SanqianAppClient
  */
-type AppClientEvent = 'connected' | 'registered' | 'disconnected' | 'error' | 'tool_call';
+type AppClientEvent = 'connected' | 'registered' | 'disconnected' | 'error' | 'tool_call' | 'resourcePushed' | 'resourceRemoved';
 /**
  * Event handler types
  */
@@ -205,6 +205,8 @@ interface AppClientEventHandlers {
         name: string;
         arguments: Record<string, unknown>;
     }) => void;
+    resourcePushed: (resource: _yushaw_sanqian_sdk.StoredSessionResource) => void;
+    resourceRemoved: (resourceId: string) => void;
 }
 
 /**
@@ -284,6 +286,10 @@ declare class SanqianAppClient {
      * Subscribe to client events
      */
     on<E extends AppClientEvent>(event: E, handler: AppClientEventHandlers[E]): this;
+    /**
+     * Unsubscribe from client events
+     */
+    off<E extends AppClientEvent>(event: E, handler: AppClientEventHandlers[E]): this;
     /**
      * Remove all event listeners
      */
@@ -356,6 +362,44 @@ declare class SanqianAppClient {
      * List all available agents (not just own agents)
      */
     listAvailableAgents(): Promise<_yushaw_sanqian_sdk.AgentCapability[]>;
+    /**
+     * Push a temporary context resource to Sanqian Chat
+     * Resources are displayed as chips in the Chat UI and included in LLM context
+     *
+     * @example
+     * ```typescript
+     * const resource = await client.pushResource({
+     *   id: 'editor-selection',
+     *   title: 'Selected Text',
+     *   content: '<selection>...</selection>',
+     *   summary: 'First 50 chars...',
+     *   icon: '📝',
+     *   type: 'selection',
+     * });
+     * ```
+     */
+    pushResource(resource: _yushaw_sanqian_sdk.SessionResource): Promise<_yushaw_sanqian_sdk.StoredSessionResource>;
+    /**
+     * Remove a session resource by its full ID
+     *
+     * @example
+     * ```typescript
+     * await client.removeResource('my-app:editor-selection');
+     * ```
+     */
+    removeResource(resourceId: string): Promise<void>;
+    /**
+     * Get all current session resources
+     *
+     * @example
+     * ```typescript
+     * const resources = client.getSessionResources();
+     * for (const r of resources) {
+     *   console.log(`${r.fullId}: ${r.title}`);
+     * }
+     * ```
+     */
+    getSessionResources(): _yushaw_sanqian_sdk.StoredSessionResource[];
     /**
      * Get the underlying SDK instance
      * @internal This is for internal use by other sanqian-chat components
@@ -425,6 +469,7 @@ interface ChatUiStrings {
     embedWindow: string;
     collapseSidebar: string;
     history: string;
+    remove: string;
 }
 type ChatThemeMode = 'light' | 'dark' | 'auto';
 type ChatFontSize = 'small' | 'normal' | 'large' | 'extra-large';
@@ -715,6 +760,7 @@ declare class ChatPanel {
     private registeredShortcuts;
     private stateSaveTimer;
     private activeStreams;
+    private sessionResourceCleanup;
     constructor(config: ChatPanelConfig);
     private hostResizeHandler;
     private setupHostWindowListeners;
@@ -727,6 +773,18 @@ declare class ChatPanel {
      * Show panel
      */
     show(): void;
+    /**
+     * Focus the chat input
+     *
+     * Industry best practice (VS Code, etc.):
+     * 1. Focus the window (for floating mode)
+     * 2. Focus webContents to transfer focus to BrowserView
+     * 3. Send message to renderer to focus the input element
+     *
+     * Note: webContents.focus() is crucial for BrowserView - without it,
+     * focus stays in the main content area even if window has focus.
+     */
+    focusInput(): void;
     /**
      * Hide panel
      */
@@ -834,6 +892,11 @@ declare class ChatPanel {
     private scheduleSaveState;
     private saveState;
     private getSdk;
+    /**
+     * Setup session resource event forwarding from SDK to renderer
+     * Called when SDK becomes available (on connect)
+     */
+    private setupSessionResourceEvents;
     private setupIpcHandlers;
     private cleanupIpcHandlers;
 }

package/dist/main/index.d.ts

@@ -192,7 +192,7 @@ interface AppEmbeddingConfig {
 /**
  * Events emitted by SanqianAppClient
  */
-type AppClientEvent = 'connected' | 'registered' | 'disconnected' | 'error' | 'tool_call';
+type AppClientEvent = 'connected' | 'registered' | 'disconnected' | 'error' | 'tool_call' | 'resourcePushed' | 'resourceRemoved';
 /**
  * Event handler types
  */
@@ -205,6 +205,8 @@ interface AppClientEventHandlers {
         name: string;
         arguments: Record<string, unknown>;
     }) => void;
+    resourcePushed: (resource: _yushaw_sanqian_sdk.StoredSessionResource) => void;
+    resourceRemoved: (resourceId: string) => void;
 }
 
 /**
@@ -284,6 +286,10 @@ declare class SanqianAppClient {
      * Subscribe to client events
      */
     on<E extends AppClientEvent>(event: E, handler: AppClientEventHandlers[E]): this;
+    /**
+     * Unsubscribe from client events
+     */
+    off<E extends AppClientEvent>(event: E, handler: AppClientEventHandlers[E]): this;
     /**
      * Remove all event listeners
      */
@@ -356,6 +362,44 @@ declare class SanqianAppClient {
      * List all available agents (not just own agents)
      */
     listAvailableAgents(): Promise<_yushaw_sanqian_sdk.AgentCapability[]>;
+    /**
+     * Push a temporary context resource to Sanqian Chat
+     * Resources are displayed as chips in the Chat UI and included in LLM context
+     *
+     * @example
+     * ```typescript
+     * const resource = await client.pushResource({
+     *   id: 'editor-selection',
+     *   title: 'Selected Text',
+     *   content: '<selection>...</selection>',
+     *   summary: 'First 50 chars...',
+     *   icon: '📝',
+     *   type: 'selection',
+     * });
+     * ```
+     */
+    pushResource(resource: _yushaw_sanqian_sdk.SessionResource): Promise<_yushaw_sanqian_sdk.StoredSessionResource>;
+    /**
+     * Remove a session resource by its full ID
+     *
+     * @example
+     * ```typescript
+     * await client.removeResource('my-app:editor-selection');
+     * ```
+     */
+    removeResource(resourceId: string): Promise<void>;
+    /**
+     * Get all current session resources
+     *
+     * @example
+     * ```typescript
+     * const resources = client.getSessionResources();
+     * for (const r of resources) {
+     *   console.log(`${r.fullId}: ${r.title}`);
+     * }
+     * ```
+     */
+    getSessionResources(): _yushaw_sanqian_sdk.StoredSessionResource[];
     /**
      * Get the underlying SDK instance
      * @internal This is for internal use by other sanqian-chat components
@@ -425,6 +469,7 @@ interface ChatUiStrings {
     embedWindow: string;
     collapseSidebar: string;
     history: string;
+    remove: string;
 }
 type ChatThemeMode = 'light' | 'dark' | 'auto';
 type ChatFontSize = 'small' | 'normal' | 'large' | 'extra-large';
@@ -715,6 +760,7 @@ declare class ChatPanel {
     private registeredShortcuts;
     private stateSaveTimer;
     private activeStreams;
+    private sessionResourceCleanup;
     constructor(config: ChatPanelConfig);
     private hostResizeHandler;
     private setupHostWindowListeners;
@@ -727,6 +773,18 @@ declare class ChatPanel {
      * Show panel
      */
     show(): void;
+    /**
+     * Focus the chat input
+     *
+     * Industry best practice (VS Code, etc.):
+     * 1. Focus the window (for floating mode)
+     * 2. Focus webContents to transfer focus to BrowserView
+     * 3. Send message to renderer to focus the input element
+     *
+     * Note: webContents.focus() is crucial for BrowserView - without it,
+     * focus stays in the main content area even if window has focus.
+     */
+    focusInput(): void;
     /**
      * Hide panel
      */
@@ -834,6 +892,11 @@ declare class ChatPanel {
     private scheduleSaveState;
     private saveState;
     private getSdk;
+    /**
+     * Setup session resource event forwarding from SDK to renderer
+     * Called when SDK becomes available (on connect)
+     */
+    private setupSessionResourceEvents;
     private setupIpcHandlers;
     private cleanupIpcHandlers;
 }