@rtc-agent/component 0.2.7-rc.3 → 0.2.8-rc.0

package/dist/contexts/session-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tab.d.ts","sourceRoot":"","sources":["../../src/contexts/session-tab.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,eAAe,EAAE,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAE1E,MAAM,WAAW,sBAAsB;IACnC,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,iBAAiB,CAAC;CAC9B;AAED,eAAO,MAAM,iBAAiB;;CAE7B,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,eAGvC,CAAC"}

package/dist/contexts/session-tree.d.ts

@@ -0,0 +1,10 @@
+import type { SessionTreeState, SessionTreeActions } from '../types/index.js';
+export interface SessionTreeContextValue {
+    state: SessionTreeState;
+    actions: SessionTreeActions;
+}
+export declare const SessionTreeContext: {
+    __context__: SessionTreeContextValue;
+};
+export declare const DEFAULT_SESSION_TREE_STATE: SessionTreeState;
+//# sourceMappingURL=session-tree.d.ts.map

package/dist/contexts/session-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-tree.d.ts","sourceRoot":"","sources":["../../src/contexts/session-tree.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAC,gBAAgB,EAAE,kBAAkB,EAAC,MAAM,mBAAmB,CAAC;AAE5E,MAAM,WAAW,uBAAuB;IACpC,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,kBAAkB,CAAC;CAC/B;AAED,eAAO,MAAM,kBAAkB;;CAE9B,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,gBAExC,CAAC"}

package/dist/contexts/session.d.ts

@@ -0,0 +1,16 @@
+import type { SessionState, SessionActions } from '../types/index.js';
+/**
+ * Session Context — holds session list and current session.
+ *
+ * Provided by: <rtc-agent> (root)
+ * Consumed by: <rtc-session-header>, <rtc-session-panel>, <rtc-content-area>
+ */
+export interface SessionContextValue {
+    state: SessionState;
+    actions: SessionActions;
+}
+export declare const SessionContext: {
+    __context__: SessionContextValue;
+};
+export declare const DEFAULT_SESSION_STATE: SessionState;
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/contexts/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAE,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAChC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,cAAc,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc;;CAE1B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,YAGnC,CAAC"}

package/dist/contexts/settings.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Settings Context — global settings state and actions
+ *
+ * Provided by: <rtc-agent> (root)
+ * Consumed by: <rtc-settings-layout>, various feature components
+ */
+export interface SettingsState {
+    appearance: {
+        theme: 'light' | 'dark' | 'system';
+        fontSize: number;
+    };
+    chat: {
+        sendShortcut: 'Enter' | 'Ctrl+Enter';
+        density: 'compact' | 'comfortable';
+    };
+    files: {
+        autoSave: boolean;
+        defaultViewMode: 'edit' | 'preview' | 'split';
+    };
+    notifications: {
+        soundEnabled: boolean;
+        toastEnabled: boolean;
+    };
+}
+export interface SettingsActions {
+    updateAppearance(partial: Partial<SettingsState['appearance']>): void;
+    updateChat(partial: Partial<SettingsState['chat']>): void;
+    updateFiles(partial: Partial<SettingsState['files']>): void;
+    updateNotifications(partial: Partial<SettingsState['notifications']>): void;
+    resetAll(): void;
+}
+export interface SettingsContextValue {
+    state: SettingsState;
+    actions: SettingsActions;
+}
+export declare const SettingsContext: {
+    __context__: SettingsContextValue;
+};
+export declare const DEFAULT_SETTINGS_STATE: SettingsState;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/contexts/settings.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE;QACR,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;QACnC,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,EAAE;QACF,YAAY,EAAE,OAAO,GAAG,YAAY,CAAC;QACrC,OAAO,EAAE,SAAS,GAAG,aAAa,CAAC;KACtC,CAAC;IACF,KAAK,EAAE;QACH,QAAQ,EAAE,OAAO,CAAC;QAClB,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;KACjD,CAAC;IACF,aAAa,EAAE;QACX,YAAY,EAAE,OAAO,CAAC;QACtB,YAAY,EAAE,OAAO,CAAC;KACzB,CAAC;CACL;AAED,MAAM,WAAW,eAAe;IAC5B,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC;IACtE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1D,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5D,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,GAAG,IAAI,CAAC;IAC5E,QAAQ,IAAI,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;CAC5B;AAED,eAAO,MAAM,eAAe;;CAE3B,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,aAKpC,CAAC"}

package/dist/contexts/skill.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Skill Context
+ *
+ * Provides Skill system state to child components
+ *
+ * Provided by: <rtc-agent> (root)
+ * Consumed by: future Skill panels, Function list components, etc.
+ */
+import type { FunctionRegistry } from '../core/function-registry.js';
+/**
+ * Skill Context value
+ */
+export interface SkillContextValue {
+    /** Function registry instance */
+    registry: FunctionRegistry | null;
+}
+/**
+ * Skill Context default value
+ */
+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,iCAAiC;IACjC,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 — Number of active turns in the current session.
+ *
+ * Provided by the `<rtc-agent>` root component, consumed by `<rtc-input-area>`,
+ * used to determine the send button icon / disabled state.
+ *
+ * Data source: write-time aggregation from the persistence layer. On each turn-related update,
+ * EntityRepository writes back pending_turn_count / running_turn_count to the sessions row,
+ * UIUpdateBus automatically publishes a session.updated event,
+ * and the root component subscribes and reads these two fields from the session row into this 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
+ *
+ * Manages activity state in VS Code-style layout (explorer/chat/settings).
+ *
+ * Corresponds to: `ActivityContext` (defined in `contexts/activity.ts`).
+ * Provided by: `<rtc-agent>` (root)
+ * Consumed by: `<rtc-activity-bar>`, `<rtc-agent>` (conditional layout rendering)
+ *
+ * ## Persistence
+ * - Saves current active activity and sidebarVisible state via localStorage
+ * - Restores to last activity on page refresh
+ */
+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;
+    /** Current activity (readonly quick access) */
+    get active(): Activity;
+    /** Whether sidebar is visible (readonly quick access) */
+    get sidebarVisible(): boolean;
+    constructor(host: ReactiveControllerHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    private _restore;
+    private _persist;
+    /**
+     * Set activity
+     *
+     * Logic:
+     * - Click current activity → toggle sidebar
+     * - Click different activity → switch activity and show 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,+CAA+C;IAC/C,IAAI,MAAM,IAAI,QAAQ,CAErB;IAED,yDAAyD;IACzD,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,207 @@
+/**
+ * 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>;
+    /**
+     * Execute refresh with concurrency guard to prevent race conditions.
+     * If a refresh is already in-flight, wait for it; otherwise start a new one.
+     */
+    private _executeRefreshWithGuard;
+    /**
+     * 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;IAWtD,aAAa;IAkBb;;;;;;;;OAQG;IACH,gBAAgB;IAehB;;;;;;;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;IAiBf;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IA0BtB,oCAAoC;IACpC,OAAO,CAAC,WAAW;IAgEnB,kCAAkC;IAClC,OAAO,CAAC,WAAW;IAKnB,4BAA4B;IAC5B,OAAO,CAAC,gBAAgB;IAiBxB;;;OAGG;YACW,eAAe;IA4C7B;;;;;;;;;OASG;IACG,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAyBvD;;;OAGG;YACW,wBAAwB;IAetC;;;OAGG;YACW,UAAU;IA6GxB,wDAAwD;IACxD,OAAO,CAAC,mBAAmB;IAY3B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,UAAU;CAYrB"}

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

@@ -0,0 +1,120 @@
+/**
+ * Editor Area Controller
+ *
+ * Manages Editor Area state:
+ * - Open file tab list
+ * - Current active file
+ * - Content and dirty state per tab
+ * - View mode per tab
+ *
+ * Provides actions for components or Debug HTML to call.
+ *
+ * Design notes:
+ * - Only one tab allowed per path (idempotent open)
+ * - activeFilePath clears after closing the last tab
+ * - Auto-switches to adjacent tab after closing the active tab
+ * - Marks isDirty on content change
+ * - Clears isDirty on save (actual VFS write handled externally)
+ *
+ * ## Persistence
+ * - Saves the open tab list (filePath, viewMode, cursorPosition)
+ *   and activeFilePath via localStorage. Content is not persisted;
+ *   it is reloaded from VFS after refresh.
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { EditorTab, EditorViewMode } from '../types/index.js';
+export interface EditorAreaState {
+    tabs: EditorTab[];
+    activeFilePath: string;
+}
+export interface EditorAreaActions {
+    /** Open a file (idempotent: switches to existing tab if already open) */
+    openFile(filePath: string, content: string, viewMode?: EditorViewMode): void;
+    /** Close a tab */
+    closeFile(filePath: string): void;
+    /** Close all tabs */
+    closeAll(): void;
+    /** Switch to a specific tab */
+    switchTab(filePath: string): void;
+    /** Update content (auto-marks dirty) */
+    updateContent(filePath: string, content: string): void;
+    /** Save file (clears dirty flag) */
+    saveFile(filePath: string): void;
+    /** Set view mode */
+    setViewMode(filePath: string, viewMode: EditorViewMode): void;
+    /** Update cursor position */
+    setCursorPosition(filePath: string, position: {
+        line: number;
+        column: number;
+    }): void;
+    /**
+     * Silently set file content (does not mark dirty)
+     *
+     * Used to reload content from VFS into restored tabs after refresh.
+     * Creates a new tab if the tab does not exist.
+     */
+    loadContent(filePath: string, content: string): void;
+}
+export declare class EditorAreaController implements ReactiveController {
+    private _host;
+    private _tabs;
+    private _activeFilePath;
+    /** Cursor position persistence throttle: avoid frequent localStorage writes */
+    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;
+    /**
+     * Open a file
+     *
+     * Idempotent: if file is already open, only switches the tab without overwriting content.
+     */
+    private _openFile;
+    /**
+     * Close a tab
+     *
+     * Auto-switches to adjacent tab after closing. Clears activeFilePath if closing the last tab.
+     */
+    private _closeFile;
+    /**
+     * Close all tabs
+     */
+    private _closeAll;
+    /**
+     * Switch to a specific tab
+     */
+    private _switchTab;
+    /**
+     * Update content (auto-marks dirty)
+     */
+    private _updateContent;
+    /**
+     * Save file (clears dirty flag)
+     *
+     * Note: actual VFS write is handled externally by listening to the editor-area-save event.
+     */
+    private _saveFile;
+    /**
+     * Set view mode
+     */
+    private _setViewMode;
+    /**
+     * Update cursor position
+     */
+    private _setCursorPosition;
+    /**
+     * Silently set file content (does not mark dirty)
+     *
+     * Used to reload content from VFS into restored tabs after refresh.
+     * Creates a new tab if the tab does not exist.
+     */
+    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;;;;;;;;;;;;;;;;;;;;;;GAsBG;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,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC7E,kBAAkB;IAClB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,qBAAqB;IACrB,QAAQ,IAAI,IAAI,CAAC;IACjB,+BAA+B;IAC/B,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,wCAAwC;IACxC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB;IACpB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9D,6BAA6B;IAC7B,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,+EAA+E;IAC/E,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
+ *
+ * Manages editor state: view mode, toolbar button availability.
+ *
+ * Phase 2.5 only implements toolbar-related state; tab management (openTabs / activeFile)
+ * is deferred to 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"}