@rtc-agent/component 0.2.7-rc.4 → 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

@@ -1,10 +1,10 @@
 /**
  * File Explorer Controller
  *
- * 管理文件树状态：展开/折叠、选中、加载状态。
+ * Manages file tree state: expand/collapse, selection, loading state.
  *
- * 状态存储在 Controller 内部（expandedPaths, loadingPaths），
- * 而非 FileNode 对象上，便于批量操作（expandAll/collapseAll）。
+ * State is stored inside the Controller (expandedPaths, loadingPaths),
+ * rather than on FileNode objects, for easier batch operations (expandAll/collapseAll).
  *
  * Provided by: <rtc-agent> (root)
  */
@@ -30,12 +30,12 @@ export declare class FileExplorerController implements ReactiveController {
     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;
 }

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

@@ -12,7 +12,7 @@
  * Consumed by: `<rtc-content-area>`, `<rtc-message-list>`, `<rtc-input-area>`
  */
 import type { ReactiveController, ReactiveControllerHost } from 'lit';
-import type { MessageActions } from '../types/index.js';
+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';
@@ -78,6 +78,16 @@ export declare class MessageController implements ReactiveController {
      * 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.

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

@@ -1 +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,EAAwB,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;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;;;;;;;;;OAUG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwC3D;;;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"}
+{"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/notification.controller.d.ts

@@ -1,18 +1,19 @@
 /**
  * Notification Controller
  *
- * 轻量级通知系统：监听 UIUpdateBus 的新消息事件，根据焦点检测逻辑
- * 触发声音提示、Toast 通知和最小化图标动画。
+ * Lightweight notification system: listens for new message events via UIUpdateBus,
+ * triggers sound alerts, toast notifications, and minimized icon animations
+ * based on focus detection logic.
  *
- * 架构：
- * - 订阅 UIUpdateBus 的 'message' 事件（按 entity 过滤）
- * - 通过 PersistenceLayer 查询消息所属 session
- * - 焦点检测：当前 session 收到消息不通知，其他 session 才通知
- * - 通知展示：正常模式 → Toast，最小化模式 → 图标动画
+ * Architecture:
+ * - Subscribes to UIUpdateBus 'message' events (filtered by entity)
+ * - Queries the message's session via PersistenceLayer
+ * - Focus detection: no notification for the current session; notify for other sessions
+ * - Notification display: normal mode → Toast, minimized mode → icon animation
  *
  * Corresponds to: `NotificationContext` (defined in `contexts/notification.ts`).
  * Provided by: `<rtc-agent>` (root)
- * Consumed by: 需要感知未读通知的组件
+ * Consumed by: Components that need to be aware of unread notifications
  */
 import type { ReactiveController, ReactiveControllerHost } from 'lit';
 import type { NotificationContextValue, NotificationActions } from '../contexts/notification.js';
@@ -35,63 +36,66 @@ export declare class NotificationController implements ReactiveController {
     get value(): NotificationContextValue;
     private _busUnsubscribe?;
     private _sounds;
-    /** 延迟加载音效的定时器（非关键音效，组件卸载时需清理） */
+    /** Timer for deferred sound loading (non-critical sounds, cleaned up on unmount) */
     private _deferredSoundTimer?;
-    /** requestIdleCallback 返回的句柄，hostDisconnected 时用于取消尚未触发的 idle 回调。 */
+    /** Handle returned by requestIdleCallback, used in hostDisconnected to cancel untriggered idle callbacks. */
     private _idleCallbackId?;
-    /** 通知节流：防止快速连续通知导致 UI 卡顿 */
+    /** Notification throttle: prevent UI jank from rapid successive notifications */
     private _lastNotifyTime;
     private static readonly NOTIFY_THROTTLE_MS;
     /** Fallback delay (ms) when `requestIdleCallback` is available but hasn't fired yet. */
     private static readonly IDLE_FALLBACK_DELAY_MS;
     /** Delay (ms) for deferred sound loading when `requestIdleCallback` is not available. */
     private static readonly DEFERRED_SOUND_DELAY_MS;
+    /** AbortController for async operations, aborted on hostDisconnected to prevent stale operations */
+    private _abortController;
     constructor(host: ReactiveControllerHost & HTMLElement);
     hostConnected(): void;
     hostDisconnected(): void;
     /**
-     * 预加载提示音
+     * Preload notification sounds
      *
-     * 关键音效（message）立即加载；非关键音效延迟加载以优化首屏性能。
-     * 加载失败时降级处理：不影响 Toast 和动画功能。
+     * Critical sounds (message) load immediately; non-critical sounds load deferred
+     * to optimize first-paint performance. Load failures degrade gracefully:
+     * Toast and animation features are unaffected.
      *
-     * 注意：音效文件路径在构建时应确保存在，运行时加载失败会降级处理。
+     * Note: sound file paths should be verified at build time; runtime load failures degrade gracefully.
      */
     private _preloadSounds;
     private _loadSound;
     private _playSound;
     /**
-     * 订阅 UIUpdateBus 的新消息事件
+     * Subscribe to new message events from UIUpdateBus
      *
-     * 使用按 entity 过滤的订阅模式（参考 rtc-input-area 用法）。
-     * 仅监听 content 字段的 created 事件（消息内容首次写入时触发）。
+     * Uses entity-filtered subscription pattern (see rtc-input-area usage).
+     * Only listens for 'created' events on the content field (triggered on first message write).
      */
     private _subscribeToMessages;
     private _handleNewMessage;
     /**
-     * 判断是否应该触发通知
+     * Determine whether a notification should be triggered
      *
-     * 场景：
-     * - 用户在 session A 看消息，session B 收到新消息 → 通知
-     * - 用户在 session A 看消息，session A 收到新消息 → 不通知
-     * - 用户没在看任何 session → 通知所有新消息
-     * - 用户禁用通知 → 所有消息都不通知
+     * Scenarios:
+     * - User is viewing session A, session B receives a new message → notify
+     * - User is viewing session A, session A receives a new message → do not notify
+     * - User is not viewing any session → notify for all new messages
+     * - User has disabled notifications → no notifications for any messages
      */
     private _shouldNotify;
     private _triggerNotification;
     private _showToast;
     /**
-     * 跳转到目标 session 并清除通知状态
+     * Navigate to the target session and clear notification state
      *
-     * 流程：切换 session → 标记已读 → 派发 rtc-notification-click 事件
+     * Flow: switch session → mark as read → dispatch rtc-notification-click event
      */
     private _navigateToSession;
     /**
-     * 触发最小化图标脉冲动画
+     * Trigger minimized icon pulse animation
      *
-     * 通过 host 元素设置 data-notification 属性，
-     * CSS 通过 `:host([data-notification])` 选择器触发动画。
-     * 动画会一直持续，直到用户展开窗口或点击 bubble。
+     * Sets the data-notification attribute on the host element;
+     * CSS triggers animation via the `:host([data-notification])` selector.
+     * Animation persists until the user expands the window or clicks the bubble.
      */
     private _animateMinimizeIcon;
     private _clearAnimation;

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

@@ -1 +1 @@
-{"version":3,"file":"notification.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/notification.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AAEpE,OAAO,KAAK,EAAC,wBAAwB,EAAqB,mBAAmB,EAAC,MAAM,6BAA6B,CAAC;AAElH,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AAiB7D,qBAAa,sBAAuB,YAAW,kBAAkB;IAC7D,IAAI,EAAE,sBAAsB,GAAG,WAAW,CAAC;IAG3C,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAG/B,OAAO,CAAC,MAAM,CAAsD;IAEpE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IAEtC,IAAI,KAAK,IAAI,wBAAwB,CAEpC;IAGD,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,OAAO,CAAuC;IACtD,iCAAiC;IACjC,OAAO,CAAC,mBAAmB,CAAC,CAAgC;IAC5D,qEAAqE;IACrE,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,4BAA4B;IAC5B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IACjD,wFAAwF;IACxF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAQ;IACtD,yFAAyF;IACzF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAO;gBAE1C,IAAI,EAAE,sBAAsB,GAAG,WAAW;IAWtD,aAAa,IAAI,IAAI;IAKrB,gBAAgB,IAAI,IAAI;IAiBxB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAuDtB,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,UAAU;IAqBlB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;YAad,iBAAiB;IA4B/B;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,UAAU;IA0BlB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,SAAS;CAKpB"}
+{"version":3,"file":"notification.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/notification.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAE,sBAAsB,EAAC,MAAM,KAAK,CAAC;AAEpE,OAAO,KAAK,EAAC,wBAAwB,EAAqB,mBAAmB,EAAC,MAAM,6BAA6B,CAAC;AAElH,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,8BAA8B,CAAC;AACxE,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AAkB7D,qBAAa,sBAAuB,YAAW,kBAAkB;IAC7D,IAAI,EAAE,sBAAsB,GAAG,WAAW,CAAC;IAG3C,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;IAC9C,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAG/B,OAAO,CAAC,MAAM,CAAsD;IAEpE,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IAEtC,IAAI,KAAK,IAAI,wBAAwB,CAEpC;IAGD,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,OAAO,CAAuC;IACtD,oFAAoF;IACpF,OAAO,CAAC,mBAAmB,CAAC,CAAgC;IAC5D,6GAA6G;IAC7G,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,iFAAiF;IACjF,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAO;IACjD,wFAAwF;IACxF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAQ;IACtD,yFAAyF;IACzF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAO;IACtD,oGAAoG;IACpG,OAAO,CAAC,gBAAgB,CAAyB;gBAErC,IAAI,EAAE,sBAAsB,GAAG,WAAW;IAWtD,aAAa,IAAI,IAAI;IAKrB,gBAAgB,IAAI,IAAI;IAoBxB;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IAuDtB,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,UAAU;IAqBlB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;YAad,iBAAiB;IAyC/B;;;;;;;;OAQG;IACH,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,UAAU;IA0BlB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAe1B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,SAAS;CAKpB"}

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

@@ -33,6 +33,21 @@ export declare class PersistenceController implements ReactiveController {
      * Cleared on success (layer is set) or failure (so a retry can proceed).
      */
     private _connecting?;
+    /**
+     * Connection generation counter for race-condition prevention.
+     *
+     * When disconnect() clears `_connecting` while the underlying Promise is still
+     * in-flight, a subsequent connect() can set a new `_connecting`. When the OLD
+     * Promise finally resolves, its `finally` block would wrongly clear the NEW
+     * `_connecting`, leaving the new connection attempt invisible to the concurrency
+     * guard — leading to duplicate connection attempts and inconsistent state.
+     *
+     * Fix: each connection attempt captures the current generation; in `finally`,
+     * we only clear `_connecting` if the generation still matches. Any code path
+     * that invalidates an in-flight connection (disconnect) bumps the generation
+     * instead of just clearing `_connecting`, so stale Promises self-inhibit.
+     */
+    private _connectGeneration;
     private static readonly MAX_CONNECT_RETRIES;
     private static readonly CONNECT_RETRY_DELAY_MS;
     constructor(host: {
@@ -61,9 +76,9 @@ export declare class PersistenceController implements ReactiveController {
     /**
      * Get the MasterLock instance.
      *
-     * MasterLock 封装 Web Locks API，用于 Master Tab 选举。
-     * 每个 Tab 各自持有一个 MasterLock，自己判断是否为 Master。
-     * 只有 Master Tab 的 RtcProcessor 会执行 RTC 工具调用。
+     * MasterLock wraps the Web Locks API for Master Tab election.
+     * Each Tab holds its own MasterLock and determines whether it is the Master.
+     * Only the Master Tab's RtcProcessor will execute RTC tool calls.
      *
      * @see docs/shared-worker-proposal.md §4.3
      */
@@ -87,41 +102,43 @@ export declare class PersistenceController implements ReactiveController {
      * The WorkerPersistenceAdapter wraps the Comlink proxy, presenting a
      * PersistenceLayer-compatible interface to the rest of the application.
      *
-     * 支持重试：如果 Worker 初始化或连接失败，会自动重试。
+     * Supports retries: if Worker initialization or connection fails, it will automatically retry.
      */
     private _connectWorker;
     /**
-     * 单次连接尝试
+     * Single connection attempt
      */
     private _connectWorkerOnce;
     /**
-     * 清理失败的连接
+     * Clean up a failed connection
      */
     private _cleanupFailedConnection;
     /**
-     * 延迟指定毫秒数
+     * Delay for the specified number of milliseconds
      */
     private _delay;
     /**
      * Disconnect and tear down the PersistenceLayer.
      *
-     * - 先 reset offset，再 close layer
-     * - 额外释放 MasterLock + 销毁 WorkerBridge
+     * - Increment the generation counter to invalidate the finally block of any old _connecting promise
+     * - Clear the _connecting promise to allow a new connection attempt
+     * - Reset offset first, then close the layer
+     * - Additionally release the MasterLock and destroy the WorkerBridge
      *
      * Call this on logout or when auth is lost.
      */
     disconnect(): Promise<void>;
     /**
-     * 获取当前连接状态
+     * Get the current connection state.
      *
-     * 通过 WorkerBridge 获取连接状态。
+     * Retrieves the connection state via WorkerBridge.
      */
     getConnectionState(): Promise<ConnectionState>;
     /**
-     * 监听连接状态变更
+     * Listen for connection state changes.
      *
-     * 监听 WorkerBridge 广播的连接状态变更事件。
-     * 返回取消监听的函数。
+     * Subscribes to connection state change events broadcast by WorkerBridge.
+     * Returns a function that unsubscribes the listener.
      */
     onConnectionStateChange(listener: (event: ConnectionStateEvent) => void): () => void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"persistence.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/persistence.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,KAAK,CAAC;AAE5C,OAAO,EACH,KAAK,gBAAgB,EAMxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAC,eAAe,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAG7E,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAKzD,OAAO,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAwM7C,qBAAa,qBAAsB,YAAW,kBAAkB;IAC5D,OAAO,CAAC,MAAM,CAAC,CAAmB;IAClC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,qBAAqB,CAAC,CAAS;IACvC,OAAO,CAAC,UAAU,CAAC,CAAS;IAE5B;;;;;OAKG;IACH,OAAO,CAAC,WAAW,CAAC,CAAgB;IAEpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAQ;gBAGlD,IAAI,EAAE;QAAC,aAAa,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;KAAC,EAClD,IAAI,EAAE,cAAc;IAMxB,wEAAwE;IACxE,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAEzC;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAEtC;IAED,qEAAqE;IACrE,IAAI,KAAK,IAAI,gBAAgB,GAAG,SAAS,CAExC;IAED,kDAAkD;IAClD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,YAAY,GAAG,SAAS,CAE3C;IAED;;;;;;;;OAQG;IACH,IAAI,UAAU,IAAI,UAAU,GAAG,SAAS,CAEvC;IAED,aAAa;IAIb,gBAAgB;IAIhB;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC9B;;;;;;;OAOG;YACW,cAAc;IA2B5B;;OAEG;YACW,kBAAkB;IAiDhC;;OAEG;YACW,wBAAwB;IAYtC;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;;;;;;OAOG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4BjC;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAOpD;;;;;OAKG;IACH,uBAAuB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;CAOvF"}
+{"version":3,"file":"persistence.controller.d.ts","sourceRoot":"","sources":["../../src/controllers/persistence.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,KAAK,CAAC;AAE5C,OAAO,EACH,KAAK,gBAAgB,EAMxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAC,eAAe,EAAE,oBAAoB,EAAC,MAAM,mBAAmB,CAAC;AAG7E,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAKzD,OAAO,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAwM7C,qBAAa,qBAAsB,YAAW,kBAAkB;IAC5D,OAAO,CAAC,MAAM,CAAC,CAAmB;IAClC,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,qBAAqB,CAAC,CAAS;IACvC,OAAO,CAAC,UAAU,CAAC,CAAS;IAE5B;;;;;OAKG;IACH,OAAO,CAAC,WAAW,CAAC,CAAgB;IAEpC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,kBAAkB,CAAK;IAE/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IAChD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAQ;gBAGlD,IAAI,EAAE;QAAC,aAAa,CAAC,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;KAAC,EAClD,IAAI,EAAE,cAAc;IAMxB,wEAAwE;IACxE,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAEzC;IAED;;;;;;;;OAQG;IACH,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAEtC;IAED,qEAAqE;IACrE,IAAI,KAAK,IAAI,gBAAgB,GAAG,SAAS,CAExC;IAED,kDAAkD;IAClD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,YAAY,GAAG,SAAS,CAE3C;IAED;;;;;;;;OAQG;IACH,IAAI,UAAU,IAAI,UAAU,GAAG,SAAS,CAEvC;IAED,aAAa;IAIb,gBAAgB;IAIhB;;;;;;;;;OASG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6D9B;;;;;;;OAOG;YACW,cAAc;IA2B5B;;OAEG;YACW,kBAAkB;IA2FhC;;OAEG;YACW,wBAAwB;IAYtC;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;;;;;;;;OASG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyEjC;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAOpD;;;;;OAKG;IACH,uBAAuB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,GAAG,MAAM,IAAI;CAOvF"}