@rtc-agent/component 0.2.7-rc.3 → 0.2.7-rc.4

package/dist/components/activity-bar/rtc-activity-bar.d.ts

@@ -0,0 +1,65 @@
+/**
+ * RTC Activity Bar Component
+ *
+ * VS Code 风格的左侧活动栏，支持在资源管理器/聊天/设置间切换。
+ *
+ * @element rtc-activity-bar
+ * @fires activity-change - 活动切换时触发 (detail: { activity, toggleSidebar })
+ *
+ * ## 交互逻辑
+ * - 点击当前活动 → toggle sidebar（触发 activity-change 事件，toggleSidebar: true）
+ * - 点击不同活动 → 切换活动并显示 sidebar（触发 activity-change 事件，toggleSidebar: false）
+ * - ↑/↓ 箭头键在图标间切换（roving tabindex），Enter/Space 激活
+ *
+ * ## 样式
+ * 使用项目 design tokens（--rtc-color-*），支持亮色/暗色主题。
+ */
+import { LitElement } from 'lit';
+import type { Activity } from '../../types/index.js';
+export declare class RtcActivityBar extends LitElement {
+    static styles: import("lit").CSSResult;
+    /** 当前活动 */
+    active: Activity;
+    /** 是否显示 Files 按钮 */
+    showFiles: boolean;
+    /** 是否显示 Settings 按钮 */
+    showSettings: boolean;
+    private _localeCtx;
+    /**
+     * 处理活动图标点击
+     *
+     * 逻辑：
+     * - 点击当前活动 → toggleSidebar: true
+     * - 点击不同活动 → 切换活动，toggleSidebar: false
+     */
+    private _handleClick;
+    /**
+     * 键盘事件处理
+     *
+     * - ↑/↓：在可用活动间移动焦点（roving tabindex）
+     * - Enter/Space：激活当前活动
+     * - Home/End：跳到首/末项
+     */
+    private _handleKeydown;
+    /**
+     * 将焦点移到指定活动图标（roving tabindex）
+     */
+    private _focusActivity;
+    /**
+     * 计算 roving tabindex：当前 active 的活动获得 tabindex=0，其余 -1
+     */
+    private _tabIndex;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'rtc-activity-bar': RtcActivityBar;
+    }
+    interface HTMLElementEventMap {
+        'activity-change': CustomEvent<{
+            activity: Activity;
+            toggleSidebar: boolean;
+        }>;
+    }
+}
+//# sourceMappingURL=rtc-activity-bar.d.ts.map

package/dist/components/activity-bar/rtc-activity-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-activity-bar.d.ts","sourceRoot":"","sources":["../../../src/components/activity-bar/rtc-activity-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAC,UAAU,EAAgB,MAAM,KAAK,CAAC;AAK9C,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAcnD,qBAEa,cAAe,SAAQ,UAAU;IAC1C,MAAM,CAAC,MAAM,0BAAU;IAEvB,WAAW;IAEX,MAAM,EAAE,QAAQ,CAAU;IAE1B,oBAAoB;IAEpB,SAAS,UAAQ;IAEjB,uBAAuB;IAEvB,YAAY,UAAQ;IAIpB,OAAO,CAAC,UAAU,CAMhB;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAcpB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAyCtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB,MAAM;CAkDT;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,kBAAkB,EAAE,cAAc,CAAC;KACtC;IAED,UAAU,mBAAmB;QACzB,iBAAiB,EAAE,WAAW,CAAC;YAC3B,QAAQ,EAAE,QAAQ,CAAC;YACnB,aAAa,EAAE,OAAO,CAAC;SAC1B,CAAC,CAAC;KACN;CACJ"}

package/dist/components/activity-bar/rtc-activity-bar.styles.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Activity Bar 样式
+ *
+ * 使用项目 design tokens（--rtc-color-*）支持多主题。
+ */
+export declare const styles: import("lit").CSSResult;
+//# sourceMappingURL=rtc-activity-bar.styles.d.ts.map

package/dist/components/activity-bar/rtc-activity-bar.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-activity-bar.styles.d.ts","sourceRoot":"","sources":["../../../src/components/activity-bar/rtc-activity-bar.styles.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,MAAM,yBAgElB,CAAC"}

package/dist/components/chat-layout/rtc-chat-layout.d.ts

@@ -0,0 +1,211 @@
+/**
+ * RTC Chat Layout Component
+ *
+ * 两栏布局的对话页面：
+ * - 左栏：rtc-session-tree（会话树）
+ * - 右栏：rtc-session-tab-bar（Tab 标签栏）+ 聊天内容区
+ *
+ * 点击会话树节点 → 打开/切换 Tab → 聊天内容区显示该 session 的消息。
+ *
+ * 聊天内容区复用现有组件（rtc-content-area / rtc-notice-bar /
+ * rtc-input-area / rtc-overlay-manager）。通过 SessionContext 的
+ * currentSessionId 切换不同 session，并通过 messageController 属性
+ * 将 MessageRepository 传递给 rtc-content-area → rtc-message-list，
+ * 实现每个 tab 独立的消息实例。
+ *
+ * @element rtc-chat-layout
+ * @fires rtc-chat-layout-session-select - 用户点击会话树节点 (detail: { sessionId })
+ * @fires rtc-chat-layout-tab-activate - 用户切换 Tab (detail: { sessionId })
+ * @fires rtc-chat-layout-tab-close - 用户关闭 Tab (detail: { sessionId })
+ * @fires rtc-fork-initiated - 分叉请求编排完成 (detail: { oldSessionClientId, oldMessageClientId, newSessionClientId, content })
+ * @fires rtc-new-session - 新建会话（含全部关闭后自动创建）
+ */
+import { LitElement, type PropertyValues } from 'lit';
+import '../session-tree/rtc-session-tree.js';
+import '../session-tree/rtc-session-tab-bar.js';
+import '../content-area/rtc-content-area.js';
+import '../notice-bar/rtc-notice-bar.js';
+import '../input-area/rtc-input-area.js';
+import type { MessageController } from '../../controllers/message.controller.js';
+import '../overlay/rtc-overlay-manager.js';
+import '../drawer/rtc-drawer.js';
+export declare class RtcChatLayout extends LitElement {
+    static styles: import("lit").CSSResult[];
+    private _localeCtx;
+    /** 主题：light / dark / system */
+    theme: 'light' | 'dark' | 'system';
+    /**
+     * 会话树（.sidebar）是否可见
+     *
+     * 由父级 rtc-agent 根据 ActivityController.sidebarVisible 透传：
+     * - 点击"聊天"活动栏图标 → toggleSidebar → false → 隐藏
+     * - 再次点击 → toggleSidebar → true → 展开
+     */
+    sessionTreeVisible: boolean;
+    /** Message controller for repository access (passed to rtc-content-area). */
+    messageController?: MessageController;
+    /** 是否正在拖拽 resize handle */
+    private _isResizing;
+    /** 拖拽开始时的 Y 坐标 */
+    private _resizeStartY;
+    /** 拖拽开始时的 input-area 高度 */
+    private _resizeStartHeight;
+    /** 当前拖拽的 session ID */
+    private _resizeSessionId;
+    /** 最小 input-area 高度 */
+    private static readonly MIN_INPUT_HEIGHT;
+    /** 最大 input-area 高度 */
+    private static readonly MAX_INPUT_HEIGHT;
+    /**
+     * 已经应用过保存的高度的 session 集合
+     *
+     * 用于避免重复应用：每个 session 的 input-area 只在首次渲染时应用一次。
+     * 当 session 被新创建时（不在集合中），会应用保存的高度。
+     */
+    private _heightAppliedSessions;
+    private _sessionCtx;
+    private _tabCtx;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    /**
+     * 组件更新后检查是否需要应用保存的 input-area 高度
+     *
+     * 每次更新后遍历所有 tab，对于尚未应用过高度的 session，
+     * 应用 localStorage 中保存的高度。这确保了：
+     * 1. 首次加载时，tabs 渲染后立即应用保存的高度
+     * 2. 新建 tab 时，也会应用保存的高度
+     * 3. 每个 session 只应用一次，避免覆盖用户的拖拽调整
+     */
+    protected updated(_changedProperties: PropertyValues): void;
+    /** 清空当前活动 tab 的输入框（供 Escape 键等场景调用） */
+    private _boundOnClearActiveInput;
+    /** 清空当前活动 tab 的输入框 */
+    clearActiveInput(): void;
+    /**
+     * 开始拖拽 resize handle
+     *
+     * 记录初始状态，设置拖拽标志。
+     */
+    private _handleResizeStart;
+    /** 全局 mousemove 处理 */
+    private _boundOnResizeMouseMove;
+    /** 全局 mouseup 处理 */
+    private _boundOnResizeMouseUp;
+    /**
+     * 保存 input-area 高度到 localStorage
+     *
+     * 高度是全局设置（所有 tab 共享），不区分 sessionId。
+     */
+    private _saveInputAreaHeight;
+    /**
+     * 从 localStorage 加载 input-area 高度
+     *
+     * 返回 null 表示没有保存的高度，使用默认值。
+     */
+    private _loadInputAreaHeight;
+    /**
+     * 应用保存的高度到指定 session 的 input-area
+     */
+    private _applyStoredHeight;
+    /** 根据 sessionId 获取对应的 input-area 元素 */
+    private _getInputAreaBySession;
+    /**
+     * 核心编排：确保存在一个 unsaved tab
+     *
+     * - 已有 unsaved tab → 激活它，返回其 sessionId
+     * - 没有 → 创建新 session + 开 unsaved tab，返回 newId
+     *
+     * 同步方法（无 await），保证双击 "+" 幂等：
+     * 第二次调用时 findUnsavedTab 立即返回已有 tab。
+     *
+     * @param params 可选的瞬态 UI 参数（fork 内容、notice 提示等）
+     */
+    private _ensureUnsavedSession;
+    private _boundOnForkRequested;
+    private _boundOnMessageSent;
+    /** session-header / session-tree "+" 按钮事件透传到 _handleNewSession */
+    private _handleSessionTreeNew;
+    /** Toast 通知点击：跳转到对应 session（含 reopen 检查） */
+    private _handleNotificationClick;
+    /**
+     * 为指定 session 打开或激活 Tab
+     *
+     * 从 SessionContext 的 sessions 列表中查找 session 以获取标题。
+     * 如果 session 不存在（如新建会话还未持久化），使用 'Untitled' 作为占位标题。
+     * 后续 `_loadSessions` 会通过 `updateTabTitles` 同步真实标题。
+     */
+    private _ensureTabForSession;
+    /**
+     * 点击会话树节点
+     *
+     * 1. 检查 session 状态，如果是 closed 则先调用 reopenSession
+     * 2. 打开/切换到对应 Tab
+     * 3. 切换 SessionContext 的 currentSessionId（触发聊天内容刷新）
+     */
+    private _handleTreeSelect;
+    /**
+     * 打开 session（含透明 reopen 检查）
+     *
+     * 如果 session 状态为 closed，先调用 reopenSession 重新打开。
+     * 成功后再执行 UI 操作（打开 Tab + 切换 session）。
+     */
+    private _openWithReopenCheck;
+    /**
+     * 点击展开/折叠（由 SessionTreeController 内部处理，此处无需额外逻辑）
+     */
+    private _handleTreeToggle;
+    /**
+     * 点击新建会话按钮
+     *
+     * 通过 _ensureUnsavedSession 保证 unsaved tab 唯一：
+     * - 已有 unsaved tab → 聚焦它
+     * - 没有 → 创建新 session + 开 unsaved tab
+     *
+     * 派发 rtc-new-session，由 rtc-agent 清 fork 状态。
+     */
+    private _handleNewSession;
+    /**
+     * 切换 Tab
+     *
+     * 切换 SessionContext 的 currentSessionId。
+     */
+    private _handleTabActivate;
+    /**
+     * Phase 4: Update visibility state for all tab message lists.
+     * Called when tab switches to notify virtual scroll of visibility changes.
+     *
+     * @param activeSessionId - The newly activated tab's session ID
+     */
+    private _updateTabVisibility;
+    /**
+     * 关闭 Tab
+     *
+     * SessionTabController 会自动处理相邻 Tab 激活。
+     * 如果关闭的是当前活动的 session，需要切换到新激活的 Tab；
+     * 如果没有剩余 Tab（需求 4），立即调用 _handleNewSession 创建新 unsaved tab。
+     *
+     * 注意：不能通过 this._tabCtx.state 读取关闭后的状态，
+     * 因为 @consume 的 context 更新是异步的（等 Lit 下一轮渲染）。
+     * 此处同步计算剩余 Tab 来判断下一步。
+     */
+    private _handleTabClose;
+    private _renderChatContent;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'rtc-chat-layout': RtcChatLayout;
+    }
+    interface HTMLElementEventMap {
+        'rtc-chat-layout-session-select': CustomEvent<{
+            sessionId: string;
+        }>;
+        'rtc-chat-layout-tab-activate': CustomEvent<{
+            sessionId: string;
+        }>;
+        'rtc-chat-layout-tab-close': CustomEvent<{
+            sessionId: string;
+        }>;
+    }
+}
+//# sourceMappingURL=rtc-chat-layout.d.ts.map

package/dist/components/chat-layout/rtc-chat-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-chat-layout.d.ts","sourceRoot":"","sources":["../../../src/components/chat-layout/rtc-chat-layout.ts"],"names":[],"mappings":"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"}

package/dist/components/chat-layout/rtc-chat-layout.styles.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Chat Layout 样式
+ *
+ * 布局：
+ * - rtc-drawer overlay 抽屉（会话树，从左侧滑入，不挤压主内容）
+ * - 右栏：TabBar + 聊天内容区（flex: 1）
+ *
+ * 颜色使用项目 Tokens，确保双主题适配。
+ */
+export declare const styles: import("lit").CSSResult;
+//# sourceMappingURL=rtc-chat-layout.styles.d.ts.map

package/dist/components/chat-layout/rtc-chat-layout.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-chat-layout.styles.d.ts","sourceRoot":"","sources":["../../../src/components/chat-layout/rtc-chat-layout.styles.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM,yBAkIlB,CAAC"}

package/dist/components/content-area/rtc-content-area.d.ts

@@ -0,0 +1,34 @@
+/**
+ * RTC Content Area Component
+ *
+ * Switches between empty state and message list based on messages.
+ * Each `<rtc-content-area>` receives a `sessionId` and `messageController`
+ * from its parent, passing them down to `<rtc-message-list>`.
+ *
+ * @element rtc-content-area
+ * @csspart container - The content container
+ */
+import { LitElement } from 'lit';
+import type { MessageController } from '../../controllers/message.controller.js';
+import './rtc-message-list.js';
+import '../empty-state/rtc-empty-state.js';
+export declare class RtcContentArea extends LitElement {
+    static styles: import("lit").CSSResult;
+    theme: 'light' | 'dark' | 'system';
+    /** Session ID for the message list instance. */
+    sessionId: string | null;
+    /** Message controller for repository access. */
+    messageController?: MessageController;
+    /**
+     * Whether this tab is unsaved (draft session not yet persisted to DB).
+     * Unsaved sessions have no messages and should show empty state.
+     */
+    isUnsaved: boolean;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'rtc-content-area': RtcContentArea;
+    }
+}
+//# sourceMappingURL=rtc-content-area.d.ts.map

package/dist/components/content-area/rtc-content-area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-content-area.d.ts","sourceRoot":"","sources":["../../../src/components/content-area/rtc-content-area.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAC,UAAU,EAAO,MAAM,KAAK,CAAC;AAIrC,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yCAAyC,CAAC;AAC/E,OAAO,uBAAuB,CAAC;AAC/B,OAAO,mCAAmC,CAAC;AAE3C,qBACa,cAAe,SAAQ,UAAU;IAC1C,MAAM,CAAC,MAAM,0BAAU;IAGvB,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAY;IAE9C,gDAAgD;IAEhD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEhC,gDAAgD;IAEhD,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;;OAGG;IAEH,SAAS,EAAE,OAAO,CAAS;IAE3B,MAAM;CAgBT;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,kBAAkB,EAAE,cAAc,CAAC;KACtC;CACJ"}

package/dist/components/content-area/rtc-content-area.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const styles: import("lit").CSSResult;
+//# sourceMappingURL=rtc-content-area.styles.d.ts.map

package/dist/components/content-area/rtc-content-area.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-content-area.styles.d.ts","sourceRoot":"","sources":["../../../src/components/content-area/rtc-content-area.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAelB,CAAC"}

package/dist/components/content-area/rtc-error-message.d.ts

@@ -0,0 +1,82 @@
+/**
+ * RTC Error Message Component
+ *
+ * Renders an error feedback message with category-specific icon and color,
+ * title, description, optional retry button, and collapsible raw error details.
+ *
+ * ## Layout model (时间线布局)
+ *
+ * Reuses the shared timeline layout (dot + vertical line) from timeline.styles.ts.
+ * The dot color reflects the error category.
+ *
+ * ## XSS safety
+ *
+ * All text content is rendered via Lit's `html` template literal, which
+ * auto-escapes HTML entities. The raw_error field is rendered inside a <pre>
+ * element using text content interpolation (also auto-escaped by Lit).
+ * No innerHTML or unsafeHTML is used anywhere.
+ *
+ * @element rtc-error-message
+ * @csspart dot - The timeline dot (colored by error category)
+ * @csspart content - The error content area
+ */
+import { LitElement, nothing } from 'lit';
+import type { Message } from '../../types/index.js';
+import type { StatefulComponent } from '../../utils/message-virtual-scroll.js';
+export declare class RtcErrorMessage extends LitElement implements StatefulComponent {
+    static styles: import("lit").CSSResult[];
+    private _localeCtx;
+    /**
+     * The full Message object (for timestamp, clientId, etc.).
+     * The error content is extracted from message.content.data.
+     */
+    message: Message;
+    /**
+     * Whether the raw error detail panel is expanded.
+     * Default collapsed to avoid overwhelming the user with technical details.
+     */
+    private _rawErrorExpanded;
+    /**
+     * Extract ErrorContent from the message's content data.
+     */
+    private get _errorData();
+    /**
+     * Look up the visual configuration for the current error category.
+     *
+     * Labels are resolved through lit-localize's `msg()` so they update when
+     * the user switches locale. Each case is a separate `msg()` call so the
+     * extractor can pick them up as translation keys.
+     */
+    private _getCategoryConfig;
+    /**
+     * Resolve the localized label for an error category.
+     *
+     * A switch with one `msg()` per case is required: lit-localize's extractor
+     * needs static string arguments and cannot follow dynamic lookups.
+     */
+    private _getCategoryLabel;
+    private _toggleRawError;
+    private _handleRetry;
+    /**
+     * Extract component state for preservation across virtualization.
+     * Called by MessageVirtualScroll before destroying the element.
+     *
+     * Preserved state:
+     * - rawErrorExpanded: User's expand/collapse preference for raw error details
+     */
+    getState(): Record<string, unknown>;
+    /**
+     * Inject cached state after restoring from skeleton placeholder.
+     * Called synchronously before first render to avoid flicker.
+     *
+     * @param state - Previously extracted state from getState()
+     */
+    setState(state: Record<string, unknown>): void;
+    render(): typeof nothing | import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'rtc-error-message': RtcErrorMessage;
+    }
+}
+//# sourceMappingURL=rtc-error-message.d.ts.map

package/dist/components/content-area/rtc-error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-error-message.d.ts","sourceRoot":"","sources":["../../../src/components/content-area/rtc-error-message.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAC,UAAU,EAAa,OAAO,EAAC,MAAM,KAAK,CAAC;AAOnD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,sBAAsB,CAAC;AAGlD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,uCAAuC,CAAC;AA2C7E,qBAEa,eAAgB,SAAQ,UAAW,YAAW,iBAAiB;IACxE,MAAM,CAAC,MAAM,4BAuIX;IAIF,OAAO,CAAC,UAAU,CAMhB;IAEF;;;OAGG;IAEH,OAAO,EAAE,OAAO,CAA6G;IAE7H;;;OAGG;IAEH,OAAO,CAAC,iBAAiB,CAAS;IAElC;;OAEG;IACH,OAAO,KAAK,UAAU,GAMrB;IAED;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,YAAY;IAUpB;;;;;;OAMG;IACH,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAMnC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9C,MAAM;CAuDT;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,mBAAmB,EAAE,eAAe,CAAC;KACxC;CACJ"}