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

package/dist/contexts/skill.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Skill Context
+ *
+ * 提供 Skill 系统状态给子组件
+ *
+ * Provided by: <rtc-agent> (root)
+ * Consumed by: 未来的 Skill 面板、Function 列表组件等
+ */
+import type { FunctionRegistry } from '../core/function-registry.js';
+/**
+ * Skill Context 值
+ */
+export interface SkillContextValue {
+    /** Function 注册表实例 */
+    registry: FunctionRegistry | null;
+}
+/**
+ * Skill Context 默认值
+ */
+export declare const DEFAULT_SKILL_STATE: SkillContextValue;
+/**
+ * Skill Context key
+ */
+export declare const SkillContext: {
+    __context__: SkillContextValue;
+};
+//# sourceMappingURL=skill.d.ts.map

package/dist/contexts/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../src/contexts/skill.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qBAAqB;IACrB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAEjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY;;CAA4D,CAAC"}

package/dist/contexts/tool-call.d.ts

@@ -0,0 +1,16 @@
+import type { ToolCallState, ToolCallActions } from '../types/index.js';
+/**
+ * ToolCall Context — pending tool calls awaiting user approval.
+ *
+ * Provided by: <rtc-agent> (root)
+ * Consumed by: <rtc-tool-confirm>, <rtc-overlay-manager>
+ */
+export interface ToolCallContextValue {
+    state: ToolCallState;
+    actions: ToolCallActions;
+}
+export declare const ToolCallContext: {
+    __context__: ToolCallContextValue;
+};
+export declare const DEFAULT_TOOL_CALL_STATE: ToolCallState;
+//# sourceMappingURL=tool-call.d.ts.map

package/dist/contexts/tool-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call.d.ts","sourceRoot":"","sources":["../../src/contexts/tool-call.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,aAAa,EAAE,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;CAC5B;AAED,eAAO,MAAM,eAAe;;CAE3B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,aAErC,CAAC"}

package/dist/contexts/turn-count.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Turn Count Context — 当前会话中处于活跃状态的 turn 数量
+ *
+ * 由 `<rtc-agent>` 根组件提供，`<rtc-input-area>` 消费，
+ * 用于决定 send 按钮的图标 / disabled 状态。
+ *
+ * 数据来源：persistence 层的写时聚合。每次收到 turn 相关 Update，
+ * EntityRepository 会把该 session 的 pending_turn_count / running_turn_count
+ * 回写到 sessions 行，UIUpdateBus 自动发布 session.updated 事件，
+ * 根组件订阅后从 session 行读出两个字段推入本 context。
+ *
+ * Provided by: <rtc-agent> (root)
+ * Consumed by: <rtc-input-area>
+ */
+export interface TurnCountContextValue {
+    pendingTurnCount: number;
+    runningTurnCount: number;
+}
+export declare const TurnCountContext: {
+    __context__: TurnCountContextValue;
+};
+export declare const DEFAULT_TURN_COUNT: TurnCountContextValue;
+//# sourceMappingURL=turn-count.d.ts.map

package/dist/contexts/turn-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-count.d.ts","sourceRoot":"","sources":["../../src/contexts/turn-count.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,qBAAqB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB;;CAE5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,qBAGhC,CAAC"}

package/dist/contexts/window-state.d.ts

@@ -0,0 +1,20 @@
+import type { WindowState, WindowStateActions } from '../types/index.js';
+/**
+ * WindowState Context — tracks floating window position, size, and mode.
+ *
+ * Provided by: <rtc-agent> (root)
+ * Consumed by: <rtc-title-bar>, <rtc-content-wrapper>
+ *
+ * State shape: WindowState (mode, position, size, lastState)
+ * Actions: WindowStateActions (setMode, setPosition, setSize, maximize, minimize, restore)
+ */
+export interface WindowStateContextValue {
+    state: WindowState;
+    actions: WindowStateActions;
+}
+export declare const WindowStateContext: {
+    __context__: WindowStateContextValue;
+};
+/** Default window state — centered, normal mode, 420×640. */
+export declare const DEFAULT_WINDOW_STATE: WindowState;
+//# sourceMappingURL=window-state.d.ts.map

package/dist/contexts/window-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-state.d.ts","sourceRoot":"","sources":["../../src/contexts/window-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,WAAW,EAAE,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAEvE;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,kBAAkB,CAAC;CAC/B;AAED,eAAO,MAAM,kBAAkB;;CAE9B,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,EAAE,WAIlC,CAAC"}

package/dist/controllers/activity.controller.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Activity Controller
+ *
+ * 管理 VS Code 风格布局中的活动状态（资源管理器/聊天/设置）。
+ *
+ * Corresponds to: `ActivityContext` (defined in `contexts/activity.ts`).
+ * Provided by: `<rtc-agent>` (root)
+ * Consumed by: `<rtc-activity-bar>`, `<rtc-agent>` (布局条件渲染)
+ *
+ * ## 持久化
+ * - 通过 localStorage 保存当前 active 活动和 sidebarVisible 状态
+ * - 刷新页面后恢复到上次离开时的活动
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { Activity } from '../types/index.js';
+import type { ActivityState, ActivityActions, ActivityContextValue } from '../contexts/activity.js';
+export type { ActivityState, ActivityActions };
+export declare class ActivityController implements ReactiveController {
+    host: ReactiveControllerHost;
+    private _state;
+    readonly actions: ActivityActions;
+    get value(): ActivityContextValue;
+    /** 当前活动（readonly 快捷访问） */
+    get active(): Activity;
+    /** 侧边栏是否可见（readonly 快捷访问） */
+    get sidebarVisible(): boolean;
+    constructor(host: ReactiveControllerHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _restore;
+    private _persist;
+    /**
+     * 设置活动
+     *
+     * 逻辑：
+     * - 点击当前活动 → toggle sidebar
+     * - 点击不同活动 → 切换活动并显示 sidebar
+     */
+    private _setActivity;
+    private _showSidebar;
+    private _hideSidebar;
+    private _toggleSidebar;
+    private _reset;
+}
+//# sourceMappingURL=activity.controller.d.ts.map

package/dist/controllers/activity.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/activity.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAC,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAC,MAAM,yBAAyB,CAAC;AAQlG,YAAY,EAAC,aAAa,EAAE,eAAe,EAAC,CAAC;AAE7C,qBAAa,kBAAmB,YAAW,kBAAkB;IACzD,IAAI,EAAE,sBAAsB,CAAC;IAE7B,OAAO,CAAC,MAAM,CAA8C;IAE5D,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAElC,IAAI,KAAK,IAAI,oBAAoB,CAEhC;IAED,0BAA0B;IAC1B,IAAI,MAAM,IAAI,QAAQ,CAErB;IAED,6BAA6B;IAC7B,IAAI,cAAc,IAAI,OAAO,CAE5B;gBAEW,IAAI,EAAE,sBAAsB;IAaxC,aAAa;IACb,gBAAgB;IAIhB,OAAO,CAAC,QAAQ;IAqBhB,OAAO,CAAC,QAAQ;IAShB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,MAAM;CAKjB"}

package/dist/controllers/auth.controller.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Auth Controller
+ *
+ * Encapsulates authentication state: login status, tokens, persistence, and auto-refresh.
+ * On login, dispatches `rtc-auth-login-requested` event on the host element
+ * for external consumers.
+ *
+ * Corresponds to: `authContext` (defined in `contexts/auth.ts`).
+ * Provided by: `<rtc-agent>` (root)
+ * Consumed by: `<rtc-login-page>`, `<rtc-content-wrapper>`
+ *
+ * Note: `setTokens()` is a root-level coordination method, NOT exposed on AuthContext.
+ * It is called directly by `<rtc-agent>` when login dialog completes.
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { TokenExpiredAction } from '@rtc-agent/client';
+import type { AuthState } from '../types/index.js';
+import type { AuthContextValue } from '../contexts/auth.js';
+import type { AuthProvider } from '../types/factory.js';
+interface SetTokensParams {
+    accessToken: string;
+    refreshToken: string;
+    userId: string;
+    expiresIn: number;
+}
+export declare class AuthController implements ReactiveController {
+    host: ReactiveControllerHost & EventTarget;
+    private _state;
+    private _refreshTimer?;
+    private _boundVisibilityHandler?;
+    /** In-flight refresh guard — prevents concurrent refresh calls from racing. */
+    private _refreshing?;
+    /** Flag to indicate external token mode (skip localStorage persistence). */
+    private _externalTokens;
+    /** Dynamic token provider (mode 2) */
+    private _dynamicTokenProvider?;
+    /** Auth provider (mode 3) */
+    private _authProvider?;
+    /**
+     * Callback fired when auth state transitions to logged-in.
+     *
+     * Covers all login paths:
+     * - Initial token load (valid tokens in localStorage)
+     * - Token refresh success (expired tokens refreshed on page load)
+     * - Login dialog completion (user explicitly logs in)
+     *
+     * Used by rtc-agent.ts to trigger WebSocket connection after auth is ready,
+     * fixing the race condition where connectedCallback() runs before async
+     * token refresh completes.
+     */
+    onLogin?: () => void;
+    readonly actions: {
+        login(): void;
+        logout(): void;
+    };
+    get value(): AuthContextValue;
+    get state(): AuthState;
+    constructor(host: ReactiveControllerHost & EventTarget);
+    hostConnected(): void;
+    /**
+     * ReactiveController lifecycle: host disconnected from DOM.
+     *
+     * Memory management: clears document-level listeners and timers that would
+     * otherwise prevent GC or fire on a detached element. Provider references
+     * (_dynamicTokenProvider, _authProvider) are intentionally NOT cleared here —
+     * they persist across temporary disconnects and are cleared by _performLogout()
+     * or when the controller is GC'd with the element.
+     */
+    hostDisconnected(): void;
+    /**
+     * Convenience: trigger login directly on the controller.
+     *
+     * Design exception for AuthController: `login`/`logout` are exposed at the
+     * controller top level (not nested under `actions`), because auth is a
+     * root-level concern and external callers (demo page, protocol layer) need
+     * a straightforward API. Internally delegates to `_login()`.
+     */
+    login(): void;
+    /** Convenience: trigger logout directly on the controller. */
+    logout(): void;
+    /**
+     * Set tokens after successful login.
+     * Called by <rtc-agent> when login dialog completes.
+     * NOT exposed on AuthContext (root-level coordination).
+     */
+    setTokens(params: SetTokensParams): void;
+    /**
+     * Set tokens from external source (host application).
+     *
+     * Unlike regular `setTokens()`, this method:
+     * 1. Does NOT persist tokens to localStorage
+     * 2. Sets a flag to skip future persistence
+     * 3. Still triggers onLogin callback for WebSocket connection
+     *
+     * Use this when the host application manages token lifecycle
+     * (e.g. StaticTokenAuth mode from createRtcAgent factory).
+     */
+    setExternalTokens(params: SetTokensParams): void;
+    /**
+     * Set the dynamic token provider (Mode 2: DynamicTokenAuth).
+     *
+     * Switches the controller into external-token mode: tokens are fetched
+     * on-demand from the provider instead of being stored in localStorage.
+     *
+     * The `_state` is set to logged-in with an empty `accessToken` (fetched
+     * lazily via `getAccessTokenAsync`) and `expiresAt = Infinity` (no
+     * scheduled refresh — the provider controls expiration).
+     *
+     * @param provider - The dynamic token provider callbacks and user ID.
+     */
+    setDynamicTokenProvider(provider: {
+        getToken: () => string | Promise<string>;
+        refreshToken?: () => Promise<{
+            accessToken: string;
+            refreshToken?: string;
+            expiresIn?: number;
+        }>;
+        userId: string;
+    }): void;
+    /**
+     * Set auth provider for mode 3 authentication.
+     *
+     * The component delegates all authentication management to the provider.
+     * Use this for complex authentication flows, multi-tenant applications,
+     * or custom token rotation strategies.
+     *
+     * @param provider - The auth provider interface with getToken, refreshToken, isLoggedIn, and optional logout.
+     */
+    setAuthProvider(provider: AuthProvider): void;
+    /** Get current access token (for API requests) */
+    getAccessToken(): string | undefined;
+    /**
+     * Get the current access token, resolving it asynchronously if needed.
+     *
+     * Priority:
+     * 1. Auth provider (mode 3) - calls provider.getToken()
+     * 2. Dynamic token provider (mode 2) - calls provider.getToken()
+     * 3. Stored token (mode 1 / internal auth) - returns _state.accessToken
+     *
+     * @returns The access token string, or undefined if unavailable.
+     */
+    getAccessTokenAsync(): Promise<string | undefined>;
+    private _login;
+    private _logout;
+    /**
+     * Internal logout implementation.
+     *
+     * Memory management: clears all provider references and timers to prevent leaks.
+     * - `_dynamicTokenProvider`: released so the closure can be GC'd
+     * - `_authProvider`: released so the host app's provider can be GC'd
+     * - `_refreshTimer`: cleared to prevent orphaned setTimeout callbacks
+     * - `_externalTokens`: reset so next login cycle starts clean
+     */
+    private _performLogout;
+    /** Load tokens from localStorage */
+    private _loadTokens;
+    /** Save tokens to localStorage */
+    private _saveTokens;
+    /** Schedule next refresh */
+    private _scheduleRefresh;
+    /**
+     * Execute refresh - shared method to eliminate duplication.
+     * Returns success status and new token info.
+     */
+    private _executeRefresh;
+    /**
+     * Handle token expiration — called by RTCAgentClient (via persistence layer)
+     * when Centrifuge detects the access token is expired.
+     *
+     * Flow: try refresh → success returns 'refresh', failure clears tokens and
+     * returns 'relogin' (component will show rtc-login-page).
+     *
+     * Uses a _refreshing promise guard to prevent concurrent refresh races
+     * that could corrupt localStorage (parse-modify-write race).
+     */
+    handleTokenExpired(): Promise<TokenExpiredAction>;
+    /**
+     * Internal: execute the refresh flow, update state + localStorage.
+     * Returns true on success, false on failure.
+     */
+    private _doRefresh;
+    /** Check if refresh needed when page becomes visible */
+    private _onVisibilityChange;
+    /**
+     * Fire login success side-effects: dispatch DOM event + invoke callback.
+     *
+     * Centralized to ensure both the `rtc-auth-login` DOM event and the
+     * `onLogin` callback fire together, covering all login paths:
+     * - setTokens (login dialog completion)
+     * - setExternalTokens (host app static tokens)
+     * - setDynamicTokenProvider (mode 2)
+     * - setAuthProvider (mode 3, when already logged in)
+     * - _loadTokens (valid tokens found or refresh succeeded)
+     *
+     * Memory note: `onLogin` callback is set by rtc-agent.ts in connectedCallback()
+     * and cleared in disconnectedCallback(). No leak risk — the callback reference
+     * is bounded to the host element's lifecycle.
+     */
+    private _fireLogin;
+}
+export {};
+//# sourceMappingURL=auth.controller.d.ts.map

package/dist/controllers/auth.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/auth.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AActD,UAAU,eAAe;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,cAAe,YAAW,kBAAkB;IACrD,IAAI,EAAE,sBAAsB,GAAG,WAAW,CAAC;IAE3C,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,aAAa,CAAC,CAAgC;IACtD,OAAO,CAAC,uBAAuB,CAAC,CAAa;IAC7C,+EAA+E;IAC/E,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,4EAA4E;IAC5E,OAAO,CAAC,eAAe,CAAS;IAEhC,sCAAsC;IACtC,OAAO,CAAC,qBAAqB,CAAC,CAQ5B;IAEF,6BAA6B;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAe;IAErC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAErB,QAAQ,CAAC,OAAO,EAAE;QAAC,KAAK,IAAI,IAAI,CAAC;QAAC,MAAM,IAAI,IAAI,CAAA;KAAC,CAAC;IAElD,IAAI,KAAK,IAAI,gBAAgB,CAE5B;IAED,IAAI,KAAK,IAAI,SAAS,CAErB;gBAEW,IAAI,EAAE,sBAAsB,GAAG,WAAW;IAUtD,aAAa;IAKb;;;;;;;;OAQG;IACH,gBAAgB;IAWhB;;;;;;;OAOG;IACH,KAAK;IAEL,8DAA8D;IAC9D,MAAM;IAEN;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe;IAwBjC;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,MAAM,EAAE,eAAe;IAoBzC;;;;;;;;;;;OAWG;IACH,uBAAuB,CAAC,QAAQ,EAAE;QAC9B,QAAQ,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACzC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC;YACzB,WAAW,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,SAAS,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC,CAAC;QACH,MAAM,EAAE,MAAM,CAAC;KAClB;IAgBD;;;;;;;;OAQG;IACH,eAAe,CAAC,QAAQ,EAAE,YAAY;IA0BtC,kDAAkD;IAClD,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC;;;;;;;;;OASG;IACG,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAUxD,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,OAAO;IAef;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAuBtB,oCAAoC;IACpC,OAAO,CAAC,WAAW;IAyDnB,kCAAkC;IAClC,OAAO,CAAC,WAAW;IAInB,4BAA4B;IAC5B,OAAO,CAAC,gBAAgB;IAaxB;;;OAGG;YACW,eAAe;IA4C7B;;;;;;;;;OASG;IACG,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAqDvD;;;OAGG;YACW,UAAU;IAoGxB,wDAAwD;IACxD,OAAO,CAAC,mBAAmB;IAQ3B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,UAAU;CAUrB"}

package/dist/controllers/editor-area.controller.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Editor Area Controller
+ *
+ * 管理 Editor Area 的状态：
+ * - 打开的文件标签列表
+ * - 当前活动文件
+ * - 每个标签的内容和脏状态
+ * - 每个标签的视图模式
+ *
+ * 提供 actions 供组件或 Debug HTML 调用。
+ *
+ * 设计要点：
+ * - 同一路径只允许开一个 tab（幂等打开）
+ * - 关闭最后一个 tab 后 activeFilePath 清空
+ * - 关闭当前活动 tab 后自动切到相邻 tab
+ * - 内容变更时标记 isDirty
+ * - 保存时清除 isDirty（实际写入 VFS 由外部处理）
+ *
+ * ## 持久化
+ * - 通过 localStorage 保存打开的 tab 列表（filePath, viewMode, cursorPosition）
+ *   和 activeFilePath。内容（content）不持久化，刷新后从 VFS 重新加载。
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { EditorTab, EditorViewMode } from '../types/index.js';
+export interface EditorAreaState {
+    tabs: EditorTab[];
+    activeFilePath: string;
+}
+export interface EditorAreaActions {
+    /** 打开文件（幂等：已存在则切换到该 tab） */
+    openFile(filePath: string, content: string, viewMode?: EditorViewMode): void;
+    /** 关闭标签 */
+    closeFile(filePath: string): void;
+    /** 关闭所有标签 */
+    closeAll(): void;
+    /** 切换到指定标签 */
+    switchTab(filePath: string): void;
+    /** 更新内容（自动标记 dirty） */
+    updateContent(filePath: string, content: string): void;
+    /** 保存文件（清除 dirty 标记） */
+    saveFile(filePath: string): void;
+    /** 设置视图模式 */
+    setViewMode(filePath: string, viewMode: EditorViewMode): void;
+    /** 更新光标位置 */
+    setCursorPosition(filePath: string, position: {
+        line: number;
+        column: number;
+    }): void;
+    /**
+     * 静默设置文件内容（不标记 dirty）
+     *
+     * 用于刷新后从 VFS 重新加载内容到已恢复的 tab。
+     * 如果 tab 不存在，则创建新 tab。
+     */
+    loadContent(filePath: string, content: string): void;
+}
+export declare class EditorAreaController implements ReactiveController {
+    private _host;
+    private _tabs;
+    private _activeFilePath;
+    /** 光标位置持久化节流：避免频繁写 localStorage */
+    private _cursorPersistTimer?;
+    readonly actions: EditorAreaActions;
+    constructor(host: ReactiveControllerHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _restore;
+    private _persist;
+    get state(): EditorAreaState;
+    get tabs(): readonly EditorTab[];
+    get activeFilePath(): string;
+    get activeTab(): EditorTab | undefined;
+    /**
+     * 打开文件
+     *
+     * 幂等：如果文件已打开，只切换标签不覆盖内容。
+     */
+    private _openFile;
+    /**
+     * 关闭标签
+     *
+     * 关闭后自动切换到相邻标签。如果关闭的是最后一个，清空 activeFilePath。
+     */
+    private _closeFile;
+    /**
+     * 关闭所有标签
+     */
+    private _closeAll;
+    /**
+     * 切换到指定标签
+     */
+    private _switchTab;
+    /**
+     * 更新内容（自动标记 dirty）
+     */
+    private _updateContent;
+    /**
+     * 保存文件（清除 dirty 标记）
+     *
+     * 注意：实际写入 VFS 由外部监听 editor-area-save 事件处理。
+     */
+    private _saveFile;
+    /**
+     * 设置视图模式
+     */
+    private _setViewMode;
+    /**
+     * 更新光标位置
+     */
+    private _setCursorPosition;
+    /**
+     * 静默设置文件内容（不标记 dirty）
+     *
+     * 用于刷新后从 VFS 重新加载内容到已恢复的 tab。
+     * 如果 tab 不存在，则创建新 tab。
+     */
+    private _loadContent;
+}
+//# sourceMappingURL=editor-area.controller.d.ts.map

package/dist/controllers/editor-area.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-area.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/editor-area.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,SAAS,EAAE,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAkBjE,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7E,WAAW;IACX,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa;IACb,QAAQ,IAAI,IAAI,CAAC;IACjB,cAAc;IACd,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,uBAAuB;IACvB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa;IACb,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9D,aAAa;IACb,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAC;IACpF;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxD;AAED,qBAAa,oBAAqB,YAAW,kBAAkB;IAC3D,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,eAAe,CAAM;IAE7B,mCAAmC;IACnC,OAAO,CAAC,mBAAmB,CAAC,CAAgC;IAE5D,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;gBAExB,IAAI,EAAE,sBAAsB;IAiBxC,aAAa;IAEb,gBAAgB;IAUhB,OAAO,CAAC,QAAQ;IA8BhB,OAAO,CAAC,QAAQ;IAuBhB,IAAI,KAAK,IAAI,eAAe,CAK3B;IAED,IAAI,IAAI,IAAI,SAAS,SAAS,EAAE,CAE/B;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,SAAS,IAAI,SAAS,GAAG,SAAS,CAErC;IAID;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAwBjB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAsBlB;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,OAAO,CAAC,cAAc;IActB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CA0BvB"}

package/dist/controllers/editor.controller.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Editor Controller
+ *
+ * 管理编辑器状态：视图模式、工具栏按钮可用性。
+ *
+ * Phase 2.5 仅实现工具栏相关状态；标签页管理（openTabs / activeFile）
+ * 留给 Phase 2.7。
+ *
+ * Provided by: <rtc-agent> (root)
+ * Consumed by: <rtc-editor-toolbar>, <rtc-editor-area>
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import { type EditorState, type EditorActions, type EditorContextValue } from '../contexts/editor.js';
+export declare class EditorController implements ReactiveController {
+    private _host;
+    private _state;
+    constructor(host: ReactiveControllerHost);
+    get state(): EditorState;
+    get value(): EditorContextValue;
+    get actions(): EditorActions;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _setViewMode;
+    private _setCanSave;
+    private _setCanUndo;
+    private _setCanRedo;
+    private _reset;
+}
+//# sourceMappingURL=editor.controller.d.ts.map

package/dist/controllers/editor.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/editor.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AAEpE,OAAO,EACH,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EAE1B,MAAM,uBAAuB,CAAC;AAE/B,qBAAa,gBAAiB,YAAW,kBAAkB;IACvD,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAA0C;gBAE5C,IAAI,EAAE,sBAAsB;IAOxC,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,IAAI,KAAK,IAAI,kBAAkB,CAK9B;IAED,IAAI,OAAO,IAAI,aAAa,CAQ3B;IAID,aAAa;IAIb,gBAAgB;IAMhB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,MAAM;CAIjB"}

package/dist/controllers/file-explorer.controller.d.ts

@@ -0,0 +1,42 @@
+/**
+ * File Explorer Controller
+ *
+ * 管理文件树状态：展开/折叠、选中、加载状态。
+ *
+ * 状态存储在 Controller 内部（expandedPaths, loadingPaths），
+ * 而非 FileNode 对象上，便于批量操作（expandAll/collapseAll）。
+ *
+ * Provided by: <rtc-agent> (root)
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import { type FileExplorerState, type FileExplorerActions, type FileExplorerContextValue } from '../contexts/file-explorer.js';
+export declare class FileExplorerController implements ReactiveController {
+    private _host;
+    private _state;
+    private _expandedPaths;
+    private _loadingPaths;
+    constructor(host: ReactiveControllerHost);
+    get state(): FileExplorerState;
+    get value(): FileExplorerContextValue;
+    get actions(): FileExplorerActions;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _setRoot;
+    private _toggleNode;
+    private _expandAll;
+    private _collapseAll;
+    private _selectNode;
+    private _setLoading;
+    private _updateChildren;
+    private _reset;
+    /**
+     * 递归收集所有文件夹路径
+     */
+    private _collectFolderPaths;
+    /**
+     * 递归更新指定路径节点的子项
+     * 返回新的根节点（不可变更新）
+     */
+    private _updateNodeChildren;
+}
+//# sourceMappingURL=file-explorer.controller.d.ts.map

package/dist/controllers/file-explorer.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-explorer.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/file-explorer.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AAEpE,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAEhC,MAAM,8BAA8B,CAAC;AAEtC,qBAAa,sBAAuB,YAAW,kBAAkB;IAC7D,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAAuD;IACrE,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,aAAa,CAAqB;gBAE9B,IAAI,EAAE,sBAAsB;IAOxC,IAAI,KAAK,IAAI,iBAAiB,CAE7B;IAED,IAAI,KAAK,IAAI,wBAAwB,CAQpC;IAED,IAAI,OAAO,IAAI,mBAAmB,CAWjC;IAID,aAAa;IAIb,gBAAgB;IAMhB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,MAAM;IASd;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;CAqB9B"}

package/dist/controllers/fork.controller.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Fork Controller
+ *
+ * Manages the fork-session flow: when the user clicks "fork" on a message,
+ * we prepare a new session pre-filled with the message content. The user
+ * can then edit and submit to create a branched session.
+ *
+ * Extracted from <rtc-agent> root component to keep it under 300 lines.
+ *
+ * No context — fork state is consumed only by the root component internally.
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ContentData } from '../types/index.js';
+/** Fork state: set when user initiates a fork, cleared on submit or cancel. */
+export interface ForkState {
+    oldSessionClientId: string;
+    oldMessageClientId: string;
+    newSessionClientId: string;
+    hintMessage: string;
+}
+export interface ForkActions {
+    /** Initiate a fork from a specific message. newSessionClientId is provided by the caller (chat-layout). */
+    requestFork: (oldSessionClientId: string, oldMessageClientId: string, newSessionClientId: string, content: string) => void;
+    /** Submit the fork: create the new session and send the message. */
+    submitFork: (content: ContentData) => Promise<void>;
+    /** Cancel the fork and return to normal mode. */
+    clearFork: () => void;
+}
+/**
+ * Callbacks the fork controller needs from the outside world.
+ * Set by the root component after construction.
+ */
+export interface ForkDeps {
+    /** Clear messages in the message list (switch to blank state). */
+    clearMessages: () => void;
+    /** Clear transient UI params (initialInputValue, noticeMessage) from the tab. */
+    clearTransientParams: (sessionId: string) => void;
+    /** Execute the fork via MessageController. */
+    executeFork: (params: {
+        oldSessionClientId: string;
+        oldMessageClientId: string;
+        newSessionClientId: string;
+        newMessageClientId: string;
+        content: ContentData;
+    }) => Promise<void>;
+}
+export declare class ForkController implements ReactiveController {
+    private _host;
+    private _state;
+    private _deps;
+    readonly actions: ForkActions;
+    get state(): ForkState | null;
+    get isActive(): boolean;
+    constructor(host: ReactiveControllerHost);
+    /** Wire dependencies after construction (avoids circular init). */
+    setDeps(deps: ForkDeps): void;
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _requestFork;
+    private _submitFork;
+    private _clearFork;
+}
+//# sourceMappingURL=fork.controller.d.ts.map

package/dist/controllers/fork.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/fork.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AAEpE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAKnD,+EAA+E;AAC/E,MAAM,WAAW,SAAS;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,2GAA2G;IAC3G,WAAW,EAAE,CAAC,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3H,oEAAoE;IACpE,UAAU,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,iDAAiD;IACjD,SAAS,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB,kEAAkE;IAClE,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,iFAAiF;IACjF,oBAAoB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,8CAA8C;IAC9C,WAAW,EAAE,CAAC,MAAM,EAAE;QAClB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,OAAO,EAAE,WAAW,CAAC;KACxB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,qBAAa,cAAe,YAAW,kBAAkB;IACrD,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAAyB;IAEtC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAE9B,IAAI,KAAK,IAAI,SAAS,GAAG,IAAI,CAE5B;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;gBAEW,IAAI,EAAE,sBAAsB;IAUxC,mEAAmE;IACnE,OAAO,CAAC,IAAI,EAAE,QAAQ;IAItB,aAAa;IACb,gBAAgB;IAEhB,OAAO,CAAC,YAAY;YAkBN,WAAW;IAoBzB,OAAO,CAAC,UAAU;CAQrB"}