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

package/dist/controllers/event-binding.controller.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Event Binding Controller
+ *
+ * Centralizes all DOM event listener bindings for <rtc-agent>. This controller
+ * manages the lifecycle of 30+ event handlers, ensuring proper cleanup and
+ * reducing the root component's size by ~300 lines.
+ *
+ * ## Architecture
+ *
+ * The controller receives dependencies via constructor injection (all controllers
+ * and callbacks needed by event handlers) and provides:
+ * - Bound handler references (arrow functions stored as instance fields)
+ * - `bindEvents(element)` to attach all listeners in connectedCallback
+ * - `unbindEvents(element)` to detach all listeners in disconnectedCallback
+ *
+ * ## Event Categories
+ *
+ * - Window control: minimize, maximize, restore
+ * - Authentication: login requested, logout
+ * - Session management: new session, delete, rename
+ * - Message handling: input submit, stop, resend, fork
+ * - Toast notifications: requested, close
+ * - Slash commands: command requested
+ * - VS Code layout: activity change, file select, folder toggle
+ * - Editor area: save, tab close/select, content change, view mode, cursor, restore
+ * - Chat layout: session select, tab activate/close
+ * - UI interactions: keydown, wheel, drawer close, file explorer refresh
+ *
+ * @module EventBindingController
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { WindowStateController } from './window-state.controller.js';
+import type { AuthController } from './auth.controller.js';
+import type { SessionController } from './session.controller.js';
+import type { MessageController } from './message.controller.js';
+import type { ToolCallController } from './tool-call.controller.js';
+import type { WindowInteractionController } from './window-interaction.controller.js';
+import type { PersistenceController } from './persistence.controller.js';
+import type { SkillController } from './skill.controller.js';
+import type { ToastController } from './toast.controller.js';
+import type { ForkController } from './fork.controller.js';
+import type { ActivityController } from './activity.controller.js';
+import type { FileExplorerController } from './file-explorer.controller.js';
+import type { EditorAreaController } from './editor-area.controller.js';
+import type { StatusBarController } from './status-bar.controller.js';
+import type { SessionTreeController } from './session-tree.controller.js';
+import type { SessionTabController } from './session-tab.controller.js';
+import type { SettingsController } from './settings.controller.js';
+import type { NotificationController } from './notification.controller.js';
+import type { Logger } from '@rtc-agent/client';
+/**
+ * Dependencies required by EventBindingController.
+ *
+ * All controllers and callbacks needed by event handlers are injected here.
+ * This avoids circular dependencies and keeps the controller decoupled from
+ * the root component's internal state.
+ */
+export interface EventBindingDeps {
+    windowState: WindowStateController;
+    auth: AuthController;
+    session: SessionController;
+    message: MessageController;
+    toolCall: ToolCallController;
+    interaction: WindowInteractionController;
+    persistence: PersistenceController;
+    skill: SkillController;
+    toast: ToastController;
+    fork: ForkController;
+    activity: ActivityController;
+    fileExplorer: FileExplorerController;
+    editorArea: EditorAreaController;
+    statusBar: StatusBarController;
+    sessionTree: SessionTreeController;
+    sessionTab: SessionTabController;
+    settings: SettingsController;
+    notification: NotificationController;
+    autoSaveTimers: Map<string, ReturnType<typeof setTimeout>>;
+    getRtcProcessor: () => any;
+    setRtcProcessor: (value: any) => void;
+    getUnsubConnection: () => (() => void) | undefined;
+    setUnsubConnection: (value: (() => void) | undefined) => void;
+    getConnectGeneration: () => number;
+    bumpConnectGeneration: () => void;
+    getConnecting: () => Promise<void> | undefined;
+    setConnecting: (value: Promise<void> | undefined) => void;
+    fileTreeLoaded: () => boolean;
+    setFileTreeLoaded: (value: boolean) => void;
+    initialSessionLoadDone: () => boolean;
+    setInitialSessionLoadDone: (value: boolean) => void;
+    loadFileTree: () => Promise<void>;
+    loadFolderChildren: (path: string) => Promise<void>;
+    handleFileOpen: (path: string) => Promise<void>;
+    handleEditorSave: (path: string) => Promise<void>;
+    handleRestoreDefault: (path: string) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    loadSessions: () => Promise<void>;
+    handleCommand: (name: string, args?: string) => Promise<void>;
+    beforeMessageSend: (detail: {
+        message: {
+            content: string;
+            metadata?: Record<string, unknown>;
+        };
+    }) => Promise<boolean>;
+    showRestoreConfirmDialog: (path: string, root: ShadowRoot) => Promise<boolean>;
+    handleLoginRequested: (event: Event) => void;
+    dispatchClearActiveInput: () => void;
+    getShadowRoot: () => ShadowRoot;
+    findScrollableParent: (el: Element) => Element | null;
+    scheduleAutoSave: (filePath: string) => void;
+    log: Logger;
+}
+/**
+ * EventBindingController centralizes all DOM event listener management.
+ *
+ * Reduces rtc-agent.ts size by ~300 lines by extracting:
+ * - 30+ bound handler declarations (arrow functions as class fields)
+ * - Event listener attachment in connectedCallback
+ * - Event listener removal in disconnectedCallback
+ *
+ * @example
+ * ```typescript
+ * // In rtc-agent.ts connectedCallback:
+ * this._eventBindings = new EventBindingController(this, deps);
+ * this._eventBindings.bindEvents(this);
+ *
+ * // In disconnectedCallback:
+ * this._eventBindings.unbindEvents(this);
+ * ```
+ */
+export declare class EventBindingController implements ReactiveController {
+    host: ReactiveControllerHost;
+    private deps;
+    private _boundOnMinimize;
+    private _boundOnMaximize;
+    private _boundOnRestore;
+    private _boundOnLoginRequested;
+    private _boundOnLogout;
+    private _boundOnNewSession;
+    private _boundOnSessionDeleteRequested;
+    private _boundOnSessionRenameConfirmed;
+    private _boundOnInputSubmit;
+    private _boundOnForkInitiated;
+    private _boundOnStopRequested;
+    private _boundOnResendMessage;
+    private _boundOnToastRequested;
+    private _boundOnToastClose;
+    private _boundOnCommandRequested;
+    private _boundOnActivityChange;
+    private _boundOnFileSelect;
+    private _boundOnFolderToggle;
+    private _boundOnFileExplorerRefresh;
+    private _boundOnEditorAreaSave;
+    private _boundOnEditorAreaTabClose;
+    private _boundOnEditorAreaTabSelect;
+    private _boundOnEditorAreaContentChange;
+    private _boundOnEditorAreaViewModeChange;
+    private _boundOnEditorAreaCursorMove;
+    private _boundOnEditorAreaRestoreDefault;
+    private _boundOnChatLayoutSessionSelect;
+    private _boundOnChatLayoutTabActivate;
+    private _boundOnChatLayoutTabClose;
+    private _boundOnKeydown;
+    private _boundOnWheel;
+    private _boundOnDrawerClose;
+    constructor(host: ReactiveControllerHost, deps: EventBindingDeps);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * Initialize all bound event handlers.
+     *
+     * Each handler is an arrow function that captures `this` and delegates
+     * to the appropriate controller or callback. Handlers are stored as
+     * instance fields so they can be removed in unbindEvents.
+     */
+    private _initializeHandlers;
+    /**
+     * Bind all event listeners to the specified element.
+     *
+     * Call this in connectedCallback after controllers are initialized.
+     *
+     * @param element The element to attach listeners to (typically `this` in rtc-agent.ts)
+     */
+    bindEvents(element: Element): void;
+    /**
+     * Unbind all event listeners from the specified element.
+     *
+     * Call this in disconnectedCallback to prevent memory leaks.
+     *
+     * @param element The element to detach listeners from (typically `this` in rtc-agent.ts)
+     */
+    unbindEvents(element: Element): void;
+    /**
+     * Get handler references for use in templates.
+     *
+     * Some handlers are used directly in templates (e.g., `@click=${handler}`).
+     * This getter provides access to those handlers.
+     */
+    get handlers(): {
+        onLoginRequested: (event: Event) => void;
+    };
+}
+//# sourceMappingURL=event-binding.controller.d.ts.map

package/dist/controllers/event-binding.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-binding.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/event-binding.controller.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,42 @@
+/**
+ * File Explorer Controller
+ *
+ * Manages file tree state: expand/collapse, selection, loading state.
+ *
+ * State is stored inside the Controller (expandedPaths, loadingPaths),
+ * rather than on FileNode objects, for easier batch operations (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;
+    /**
+     * Recursively collect all folder paths
+     */
+    private _collectFolderPaths;
+    /**
+     * Recursively update children of the node at the given path
+     * Returns new root node (immutable update)
+     */
+    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"}

package/dist/controllers/function-debug.controller.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Function Debug Controller
+ *
+ * Manages the function debugger state: selected function, params, logs, history.
+ * Handles function execution with log capture and history persistence via IndexedDB.
+ *
+ * Consumed by: <rtc-function-tree>, <rtc-function-debugger>, <rtc-function-params>,
+ *              <rtc-function-console>, <rtc-function-history>
+ * Provided by: <rtc-agent> (root)
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { FunctionRegistry } from '../core/function-registry.js';
+import { type FunctionDebugActions, type FunctionDebugContextValue } from '../contexts/function-debug.js';
+import type { WorkerBridge } from '../worker-bridge.js';
+export declare class FunctionDebugController implements ReactiveController {
+    host: ReactiveControllerHost;
+    private _registry;
+    private _workerBridge;
+    private _state;
+    /** Cursor cache for efficient pagination: page -> cursor */
+    private _cursorCache;
+    readonly actions: FunctionDebugActions;
+    get value(): FunctionDebugContextValue;
+    constructor(host: ReactiveControllerHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * Set the function registry
+     *
+     * Called by <rtc-agent> when the registry is available.
+     */
+    setRegistry(registry: FunctionRegistry | null): void;
+    /**
+     * Set the worker bridge for IndexedDB access
+     *
+     * Called by <rtc-agent> when the worker bridge is available.
+     * Automatically loads the first page of history when bridge becomes available.
+     */
+    set workerBridge(bridge: WorkerBridge | null);
+    get workerBridge(): WorkerBridge | null;
+    private _selectFunction;
+    private _updateParams;
+    /**
+     * Execute the currently selected function
+     *
+     * @param clearLogs - Whether to clear logs before execution (default: true)
+     */
+    private _execute;
+    /** Execute from a history item: restore params and re-run (append logs, don't clear) */
+    private _executeFromHistory;
+    /** Load a history item's params and logs to the current view (without executing) */
+    private _loadFromHistory;
+    private _clearLogs;
+    private _clearHistory;
+    private _addLog;
+    private _addToHistory;
+    private _loadHistoryPage;
+    private _setHistoryFilter;
+    /**
+     * Generate default parameter values from function definition
+     *
+     * Reuses `getExampleValue` from markdown-generator to produce
+     * meaningful defaults from OpenAPI schema (example > default > type-based).
+     */
+    private _generateDefaultParams;
+}
+//# sourceMappingURL=function-debug.controller.d.ts.map

package/dist/controllers/function-debug.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-debug.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/function-debug.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAEH,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EACjC,MAAM,+BAA+B,CAAC;AAQvC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAStD,qBAAa,uBAAwB,YAAW,kBAAkB;IAC9D,IAAI,EAAE,sBAAsB,CAAC;IAE7B,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,MAAM,CAAyD;IACvE,4DAA4D;IAC5D,OAAO,CAAC,YAAY,CAAyC;IAE7D,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IAEvC,IAAI,KAAK,IAAI,yBAAyB,CAErC;gBAEW,IAAI,EAAE,sBAAsB;IAgBxC,aAAa;IAIb,gBAAgB;IAEhB;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAI7C;;;;;OAKG;IACH,IAAI,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,EAQ3C;IAED,IAAI,YAAY,IAAI,YAAY,GAAG,IAAI,CAEtC;IAID,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,aAAa;IAKrB;;;;OAIG;YACW,QAAQ;IA6EtB,wFAAwF;YAC1E,mBAAmB;IAqBjC,oFAAoF;IACpF,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,UAAU;YAKJ,aAAa;IA6B3B,OAAO,CAAC,OAAO;YAgBD,aAAa;YAeb,gBAAgB;YA+EhB,iBAAiB;IAc/B;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;CAmBjC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Functions Controller
+ *
+ * Manages the function registry state and provides it via Lit Context.
+ *
+ * Consumed by: <rtc-function-tree>, <rtc-functions-layout>
+ * Provided by: <rtc-agent> (root)
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { FunctionRegistry } from '../core/function-registry.js';
+import { type FunctionsActions, type FunctionsContextValue } from '../contexts/functions.js';
+export declare class FunctionsController implements ReactiveController {
+    host: ReactiveControllerHost;
+    private _registry;
+    private _state;
+    readonly actions: FunctionsActions;
+    get value(): FunctionsContextValue;
+    constructor(host: ReactiveControllerHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * Set the function registry
+     *
+     * Called by <rtc-agent> when the registry is available.
+     * Triggers a refresh of the function list.
+     */
+    setRegistry(registry: FunctionRegistry | null): void;
+    /** Refresh function list from registry */
+    private _refresh;
+}
+//# sourceMappingURL=functions.controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"functions.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/functions.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAA+C,KAAK,gBAAgB,EAAE,KAAK,qBAAqB,EAAC,MAAM,0BAA0B,CAAC;AAKzI,qBAAa,mBAAoB,YAAW,kBAAkB;IAC1D,IAAI,EAAE,sBAAsB,CAAC;IAE7B,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,MAAM,CAAgD;IAE9D,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IAEnC,IAAI,KAAK,IAAI,qBAAqB,CAEjC;gBAEW,IAAI,EAAE,sBAAsB;IAQxC,aAAa;IACb,gBAAgB;IAEhB;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAU7C,0CAA0C;IAC1C,OAAO,CAAC,QAAQ;CAiBnB"}

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

@@ -0,0 +1,192 @@
+/**
+ * Message Controller
+ *
+ * Encapsulates message list management: send, streaming append, finalize, clear.
+ * Dispatches `rtc-message-sent` event for external consumers.
+ *
+ * Cross-controller note: When the session switches, the root component calls
+ * `reload()` on this controller to load the message history for the new session.
+ *
+ * Corresponds to: `messageContext` (defined in `contexts/message.ts`).
+ * Provided by: `<rtc-agent>` (root)
+ * Consumed by: `<rtc-content-area>`, `<rtc-message-list>`, `<rtc-input-area>`
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { Message, MessageActions } from '../types/index.js';
+import type { MessageContextValue } from '../contexts/message.js';
+import type { PersistenceLayer } from '@rtc-agent/persistence';
+import type { SessionController } from './session.controller.js';
+import { MessageRepository } from '../repositories/index.js';
+export declare class MessageController implements ReactiveController {
+    host: ReactiveControllerHost & EventTarget;
+    /** Message repository for multi-session support. */
+    private _repository?;
+    /** Persistence layer — injected by root component after construction. */
+    private _persistence?;
+    /** Session controller — injected by root component after construction. */
+    private _sessionController?;
+    /**
+     * Per-session promise chain to serialize updateMessageFromBus calls.
+     * Prevents race condition when multiple messages arrive concurrently from UIUpdateBus.
+     * Key: sessionClientId, Value: pending promise chain for that session.
+     */
+    private _sessionUpdateChains;
+    readonly actions: MessageActions;
+    /** Setter for persistence injection (avoids circular deps). */
+    set persistence(layer: PersistenceLayer);
+    /**
+     * Build pagination cursor from a message.
+     * Format: "${timestamp}|${clientId}" for (created_at, client_id) composite sorting.
+     */
+    private _buildCursor;
+    /**
+     * Build pagination cursor from a UI Message.
+     *
+     * UI Message.timestamp = new Date(created_at).getTime(), which is the same
+     * numeric value that _buildCursor produces from LocalMessage.created_at.
+     * So "${msg.timestamp}|${msg.clientId}" produces an identical cursor string.
+     */
+    private _buildCursorFromUI;
+    /** Get the message repository for multi-session support. */
+    get repository(): MessageRepository;
+    /** Setter for session controller injection (avoids circular deps). */
+    set sessionController(controller: SessionController);
+    get value(): MessageContextValue;
+    constructor(host: ReactiveControllerHost & EventTarget);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /**
+     * Add a mock assistant message (demo page only).
+     *
+     * **Note**: This method is NOT part of `MessageActions` and is not exposed
+     * via Context. In a real environment, assistant messages are injected by the
+     * protocol layer via `sendMessage` or a dedicated method.
+     */
+    addDemoAssistantMessage(content: string): void;
+    /**
+     * Fetch initial messages for a session (if repository doesn't have data yet).
+     * Called by rtc-message-list in willUpdate.
+     */
+    fetchInitialMessages(sessionId: string): Promise<void>;
+    /**
+     * Load more messages for a specific session (backward pagination).
+     * Called by rtc-message-list when user scrolls to top.
+     */
+    loadMoreForSession(sessionId: string): Promise<void>;
+    /**
+     * Load newer messages for a session (forward pagination).
+     * Called by rtc-message-list when virtual scroll needs to load newer messages.
+     */
+    loadNewerForSession(sessionId: string): Promise<void>;
+    /**
+     * Load all messages for a session from persistence (for export/commands).
+     *
+     * Unlike the paginated UI methods, this loads the complete message history
+     * without pagination limits. Use sparingly — for large sessions this loads
+     * all messages into memory.
+     *
+     * Returns empty array if persistence is not available or session has no messages.
+     */
+    loadAllMessages(sessionId: string): Promise<Message[]>;
+    /**
+     * Evict a session from the repository cache.
+     * Called when a tab is closed to free memory.
+     */
+    evictSession(sessionId: string): void;
+    /**
+     * Update a single message field from UIUpdateBus event.
+     * More efficient than reload() for streaming updates.
+     *
+     * Handles both existing messages (patch) and new messages (append).
+     *
+     * Uses per-session promise chain to serialize updates and prevent race conditions
+     * when multiple messages arrive concurrently from UIUpdateBus.
+     *
+     * @param entityId - Message client ID
+     */
+    updateMessageFromBus(entityId: string): Promise<void>;
+    /**
+     * Apply a single UIUpdateBus update to repository and legacy state.
+     * Called within the per-session promise chain to ensure serialization.
+     */
+    private _applyBusUpdate;
+    /**
+     * Reload messages from persistence. Public method for UIUpdateBus / root wiring.
+     *
+     * - With entityId: immutable single-message update (replace matching clientId).
+     * - Without entityId: full reload for the current session (from SessionController).
+     */
+    reload(entityId?: string): Promise<void>;
+    /**
+     * Upsert a single message into the repository.
+     *
+     * Shared by `reload(entityId)` and `_applyBusUpdate()` to eliminate duplication.
+     * Uses explicit clientId check + sorted insert to prevent duplicates and ensure correct ordering.
+     *
+     * Why not use sort()?
+     * - sort() relies on timestamp values, which may be inconsistent between client and server
+     * - Direct insertion at correct position maintains order incrementally
+     * - Prevents order flips that cause VirtualScroll diff to miscalculate prepend/append
+     */
+    private _upsertMessage;
+    /**
+     * Compare two messages for sorting by (timestamp, role, clientId) composite key.
+     *
+     * Sorting priority:
+     * 1. timestamp (ascending) - primary sort by creation time
+     * 2. role priority (system < user < assistant) - ensures prompt messages appear before user messages
+     *    when timestamps are equal or very close
+     * 3. clientId (ascending) - final tiebreaker for deterministic ordering
+     *
+     * This matches the persistence layer (entity-repository.ts) and _mergeMessages() logic,
+     * with added role priority to handle the common case of prompt+user message pairs.
+     */
+    private _compareMessages;
+    private _sendMessage;
+    /**
+     * Re-send a failed message (preserves original client_id for idempotent retry).
+     */
+    private _resendMessage;
+    /**
+     * Fork a conversation: create a new session based on an existing message.
+     *
+     * Note: After forking, setCurrentSession must be called to add the new
+     * session to the sessions list, otherwise _ensureTabForSession cannot
+     * immediately locate the session to fetch its real title.
+     */
+    private _forkSession;
+    private _reloadFromDB;
+    /**
+     * Merge existing messages with freshly fetched messages.
+     *
+     * Strategy: Pure clientId deduplication.
+     * - Put existing first, then overwrite with fresh for same clientId (fresh is newer version)
+     * - Sort by (timestamp, clientId) composite key, matching persistence layer sorting
+     *
+     * Why not timestamp-based partitioning?
+     * - Timestamps are not unique (multiple messages can be created in the same millisecond)
+     * - clientId is the unique business identifier, deduplication by it is unambiguous
+     */
+    private _mergeMessages;
+    /**
+     * Get user message history for the current session (used for up/down arrow navigation in input).
+     *
+     * Returns an array of plain text content in reverse chronological order (newest first).
+     * Queried via PersistenceLayer.
+     */
+    getUserMessageHistory(sessionId: string, limit?: number): Promise<string[]>;
+    /**
+     * Extract plain text from a message's content field.
+     *
+     * Content storage formats:
+     * - Current format (post-fix): full ContentData JSON, e.g. '{"type":"user_message","data":{"text":"..."}}'
+     * - Legacy format (historical data): plain text string or object with data only, e.g. '{"text":"..."}'
+     * - Plain text: returned as-is
+     */
+    private _extractTextFromContent;
+    private _localMessageToUI;
+    private _appendToLastMessage;
+    private _finalizeLastMessage;
+    private _clearMessages;
+}
+//# sourceMappingURL=message.controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/message.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AACpE,OAAO,KAAK,EAAC,OAAO,EAAgB,cAAc,EAA2B,MAAM,mBAAmB,CAAC;AACvG,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAC,gBAAgB,EAAe,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAE/D,OAAO,EAAC,iBAAiB,EAAoB,MAAM,0BAA0B,CAAC;AAK9E,qBAAa,iBAAkB,YAAW,kBAAkB;IACxD,IAAI,EAAE,sBAAsB,GAAG,WAAW,CAAC;IAE3C,oDAAoD;IACpD,OAAO,CAAC,WAAW,CAAC,CAAoB;IAExC,yEAAyE;IACzE,OAAO,CAAC,YAAY,CAAC,CAAmB;IAExC,0EAA0E;IAC1E,OAAO,CAAC,kBAAkB,CAAC,CAAoB;IAE/C;;;;OAIG;IACH,OAAO,CAAC,oBAAoB,CAAoC;IAEhE,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC,+DAA+D;IAC/D,IAAI,WAAW,CAAC,KAAK,EAAE,gBAAgB,EAmCtC;IAED;;;OAGG;IACH,OAAO,CAAC,YAAY;IAKpB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAI1B,4DAA4D;IAC5D,IAAI,UAAU,IAAI,iBAAiB,CAKlC;IAED,sEAAsE;IACtE,IAAI,iBAAiB,CAAC,UAAU,EAAE,iBAAiB,EAElD;IAED,IAAI,KAAK,IAAI,mBAAmB,CAoB/B;gBAEW,IAAI,EAAE,sBAAsB,GAAG,WAAW;IAgBtD,aAAa;IACb,gBAAgB;IAOhB;;;;;;OAMG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM;IAkBvC;;;OAGG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D;;;OAGG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1D;;;OAGG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D;;;;;;;;OAQG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAgB5D;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;;;;;;;OAUG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiD3D;;;OAGG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM;IAsB9B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,cAAc;IA2BtB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;YAgBV,YAAY;IAkE1B;;OAEG;YACW,cAAc;IAiC5B;;;;;;OAMG;YACW,YAAY;YAoDZ,aAAa;IA6F3B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkB9E;;;;;;;OAOG;IACH,OAAO,CAAC,uBAAuB;IA2B/B,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,cAAc;CAgBzB"}

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

@@ -0,0 +1,26 @@
+/**
+ * Mode Controller
+ *
+ * Encapsulates AI working mode state. Supports 5 modes:
+ * manual, edit, plan, auto, bypass.
+ *
+ * Corresponds to: `modeContext` (defined in `contexts/mode.ts`).
+ * Provided by: `<rtc-agent>` (root)
+ * Consumed by: `<rtc-input-area>`, `<rtc-mode-panel>`
+ */
+import type { ReactiveController, ReactiveControllerHost } from 'lit';
+import type { ModeActions } from '../types/index.js';
+import type { ModeContextValue } from '../contexts/mode.js';
+export declare class ModeController implements ReactiveController {
+    host: ReactiveControllerHost;
+    private _state;
+    readonly actions: ModeActions;
+    get value(): ModeContextValue;
+    constructor(host: ReactiveControllerHost);
+    hostConnected(): void;
+    hostDisconnected(): void;
+    /** Restore mode from localStorage */
+    private _restoreMode;
+    private _setMode;
+}
+//# sourceMappingURL=mode.controller.d.ts.map