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

package/dist/components/overlay/rtc-session-panel.styles.d.ts

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

package/dist/components/overlay/rtc-session-panel.styles.d.ts.map

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

package/dist/components/overlay/rtc-toast.d.ts

@@ -0,0 +1,51 @@
+/**
+ * RTC Toast Component
+ *
+ * 全局通知组件，用于显示操作反馈（复制成功、错误提示等）。
+ *
+ * ## 架构
+ *
+ * 事件驱动，不是全局 API：
+ * 1. 子组件 dispatch `rtc-toast-requested` 事件
+ * 2. `<rtc-agent>` 监听事件，将 toast 推入 `@state()` 数组
+ * 3. 本组件响应式渲染 toast 列表
+ *
+ * ## 事件接口
+ *
+ * ```typescript
+ * // 子组件触发
+ * this.dispatchEvent(new CustomEvent('rtc-toast-requested', {
+ *   bubbles: true,
+ *   composed: true,
+ *   detail: { message: '已复制', type: 'success' }
+ * }));
+ * ```
+ *
+ * @element rtc-toast
+ */
+import { LitElement } from 'lit';
+export type ToastType = 'success' | 'error' | 'info';
+export interface ToastAction {
+    label: string;
+    onClick: () => void;
+}
+export interface ToastItem {
+    id: number;
+    message: string;
+    type: ToastType;
+    action?: ToastAction;
+}
+export declare class RtcToast extends LitElement {
+    static styles: import("lit").CSSResult;
+    private _localeCtx;
+    toasts: ToastItem[];
+    private _handleClose;
+    private _handleKeyDown;
+    render(): unknown;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'rtc-toast': RtcToast;
+    }
+}
+//# sourceMappingURL=rtc-toast.d.ts.map

package/dist/components/overlay/rtc-toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-toast.d.ts","sourceRoot":"","sources":["../../../src/components/overlay/rtc-toast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAC,UAAU,EAAqB,MAAM,KAAK,CAAC;AAUnD,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAEa,QAAS,SAAQ,UAAU;IACtC,MAAM,CAAC,MAAM,0BAoJX;IAIF,OAAO,CAAC,UAAU,CAMhB;IAGF,MAAM,EAAE,SAAS,EAAE,CAAM;IAEzB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,cAAc;IAatB,MAAM;CAyCP;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,QAAQ,CAAC;KACvB;CACF"}

package/dist/components/overlay/rtc-todo-panel.d.ts

@@ -0,0 +1,23 @@
+/**
+ * RTC Todo Panel Component
+ *
+ * Floating panel displaying the current session's task list.
+ *
+ * @element rtc-todo-panel
+ * @csspart list - The todo list container
+ */
+import { LitElement } from 'lit';
+import type { TodoItem } from '../../types/index.js';
+export declare class RtcTodoPanel extends LitElement {
+    static styles: import("lit").CSSResult;
+    private _localeCtx;
+    todoList: TodoItem[];
+    private _renderStatusIcon;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'rtc-todo-panel': RtcTodoPanel;
+    }
+}
+//# sourceMappingURL=rtc-todo-panel.d.ts.map

package/dist/components/overlay/rtc-todo-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-todo-panel.d.ts","sourceRoot":"","sources":["../../../src/components/overlay/rtc-todo-panel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAC,UAAU,EAAgB,MAAM,KAAK,CAAC;AAO9C,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAmBnD,qBAEa,YAAa,SAAQ,UAAU;IACxC,MAAM,CAAC,MAAM,0BAAU;IAIvB,OAAO,CAAC,UAAU,CAMhB;IAGF,QAAQ,EAAE,QAAQ,EAAE,CAAM;IAE1B,OAAO,CAAC,iBAAiB;IAYzB,MAAM;CA+BT;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,gBAAgB,EAAE,YAAY,CAAC;KAClC;CACJ"}

package/dist/components/overlay/rtc-todo-panel.styles.d.ts

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

package/dist/components/overlay/rtc-todo-panel.styles.d.ts.map

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

package/dist/components/overlay/rtc-tool-confirm.d.ts

@@ -0,0 +1,30 @@
+/**
+ * RTC Tool Confirm Component
+ *
+ * Modal dialog asking user to approve/deny a tool call.
+ * Three actions: Yes (approve once), Yes-allow (approve all), No (deny).
+ *
+ * @element rtc-tool-confirm
+ * @fires rtc-tool-call-approved - User approved (detail: { toolCallId, allowAll })
+ * @fires rtc-tool-call-denied - User denied (detail: { toolCallId })
+ * @csspart backdrop - The backdrop overlay
+ * @csspart dialog - The dialog card
+ */
+import { LitElement } from 'lit';
+import type { ToolCall } from '../../types/index.js';
+export declare class RtcToolConfirm extends LitElement {
+    static styles: import("lit").CSSResult;
+    private _localeCtx;
+    toolCall: ToolCall;
+    private _approve;
+    private _deny;
+    private _onBackdropClick;
+    private _renderParams;
+    render(): import("lit").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'rtc-tool-confirm': RtcToolConfirm;
+    }
+}
+//# sourceMappingURL=rtc-tool-confirm.d.ts.map

package/dist/components/overlay/rtc-tool-confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-tool-confirm.d.ts","sourceRoot":"","sources":["../../../src/components/overlay/rtc-tool-confirm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAC,UAAU,EAAO,MAAM,KAAK,CAAC;AAMrC,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAC;AAKnD,qBAEa,cAAe,SAAQ,UAAU;IAC1C,MAAM,CAAC,MAAM,0BAAU;IAIvB,OAAO,CAAC,UAAU,CAMhB;IAGF,QAAQ,EAAE,QAAQ,CAA6D;IAE/E,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,gBAAgB;IAOxB,OAAO,CAAC,aAAa;IAQrB,MAAM;CAmBT;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,kBAAkB,EAAE,cAAc,CAAC;KACtC;CACJ"}

package/dist/components/overlay/rtc-tool-confirm.styles.d.ts

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

package/dist/components/overlay/rtc-tool-confirm.styles.d.ts.map

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

package/dist/components/rtc-agent/helpers/bus-handler.d.ts

@@ -0,0 +1,79 @@
+import type { SessionStatus } from '../../../types/index.js';
+import type { UIUpdateEvent } from '@rtc-agent/persistence';
+import type { Logger } from '@rtc-agent/client';
+interface MessageControllerLike {
+    updateMessageFromBus(entityId: string): Promise<void>;
+}
+interface SessionControllerLike {
+    value: {
+        state: {
+            sessions: Array<{
+                clientId: string;
+                title: string;
+            }>;
+        };
+    };
+}
+interface SessionTabControllerLike {
+    actions: {
+        closeTab(sessionId: string): void;
+        openOrActivate(sessionId: string, title: string, options?: {
+            activate?: boolean;
+        }): void;
+        updateTabStatus(sessionId: string, status: SessionStatus): void;
+    };
+}
+interface SessionTreeControllerLike {
+}
+interface PersistenceLayerLike {
+    getSession(clientId: string): Promise<{
+        pending_turn_count: number;
+        running_turn_count: number;
+    } | undefined>;
+}
+interface MasterLockLike {
+    isMaster: boolean;
+}
+interface RtcProcessorLike {
+    onRtcUpdate(): void;
+}
+/**
+ * Dependencies required by the UIUpdateBus handler.
+ *
+ * These are injected by rtc-agent.ts when subscribing to the bus.
+ * Note: `rtcProcessor` is a getter function because it may be set after the
+ * bus subscription is created (during _connectWithRetry).
+ */
+export interface BusHandlerDeps {
+    message: MessageControllerLike;
+    session: SessionControllerLike;
+    sessionTab: SessionTabControllerLike;
+    sessionTree: SessionTreeControllerLike;
+    persistence: {
+        layer?: PersistenceLayerLike;
+        masterLock?: MasterLockLike;
+    };
+    /** Getter for rtcProcessor - may be undefined initially, set after connection. */
+    getRtcProcessor(): RtcProcessorLike | undefined;
+    loadSessions: () => Promise<void>;
+    refreshTurnCounts: () => Promise<void>;
+    handleFileChange: (entityId: string, field: string) => Promise<void>;
+    log: Logger;
+}
+/**
+ * Handle UIUpdateBus events and dispatch to appropriate controllers.
+ *
+ * This function is called for every persistence-layer change. It routes events
+ * by entity type (message, session, rtc, file) and applies the appropriate
+ * controller updates.
+ *
+ * For session events, distinguishes between structural changes (require full
+ * reload) and lightweight changes (handled by dedicated handlers).
+ *
+ * @param event - The UIUpdateEvent from the persistence layer
+ * @param deps - Controller dependencies for handling the event
+ * @returns Promise<void> for message events (to enable queuing), undefined otherwise
+ */
+export declare function handleBusEvent(event: UIUpdateEvent, deps: BusHandlerDeps): void | Promise<void>;
+export {};
+//# sourceMappingURL=bus-handler.d.ts.map

package/dist/components/rtc-agent/helpers/bus-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus-handler.d.ts","sourceRoot":"","sources":["../../../../src/components/rtc-agent/helpers/bus-handler.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,mBAAmB,CAAC;AAG9C,UAAU,qBAAqB;IAC3B,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,UAAU,qBAAqB;IAC3B,KAAK,EAAE;QAAC,KAAK,EAAE;YAAC,QAAQ,EAAE,KAAK,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAC,CAAC,CAAA;SAAC,CAAA;KAAC,CAAC;CACxE;AAED,UAAU,wBAAwB;IAC9B,OAAO,EAAE;QACL,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAC,GAAG,IAAI,CAAC;QACvF,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;KACnE,CAAC;CACL;AAED,UAAU,yBAAyB;CAElC;AAED,UAAU,oBAAoB;IAC1B,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAC,GAAG,SAAS,CAAC,CAAC;CAC/G;AAED,UAAU,cAAc;IACpB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,gBAAgB;IACtB,WAAW,IAAI,IAAI,CAAC;CACvB;AAoBD;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,qBAAqB,CAAC;IAC/B,UAAU,EAAE,wBAAwB,CAAC;IACrC,WAAW,EAAE,yBAAyB,CAAC;IACvC,WAAW,EAAE;QACT,KAAK,CAAC,EAAE,oBAAoB,CAAC;QAC7B,UAAU,CAAC,EAAE,cAAc,CAAC;KAC/B,CAAC;IACF,kFAAkF;IAClF,eAAe,IAAI,gBAAgB,GAAG,SAAS,CAAC;IAChD,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,GAAG,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC1B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,cAAc,GACrB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BtB"}

package/dist/components/rtc-agent/helpers/command-handler.d.ts

@@ -0,0 +1,17 @@
+import type { PersistenceLayer } from '@rtc-agent/persistence';
+import type { Logger } from '@rtc-agent/client';
+import type { ToastActions } from '../../../controllers/toast.controller.js';
+export interface CommandDeps {
+    persistenceLayer: PersistenceLayer | undefined;
+    currentSessionId: string | null;
+    toast: ToastActions;
+    logger: Logger;
+}
+/**
+ * Handle slash commands dispatched from the input area.
+ *
+ * Currently supported:
+ * - /compact [custom_instruction]: compress current session context
+ */
+export declare function handleCommand(name: string, args: string | undefined, deps: CommandDeps): Promise<void>;
+//# sourceMappingURL=command-handler.d.ts.map

package/dist/components/rtc-agent/helpers/command-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../../../src/components/rtc-agent/helpers/command-handler.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAI7E,MAAM,WAAW,WAAW;IACxB,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC/C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB;AAID;;;;;GAKG;AACH,wBAAsB,aAAa,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/components/rtc-agent/helpers/connection-setup.d.ts

@@ -0,0 +1,92 @@
+import { RtcProcessor } from '@rtc-agent/persistence';
+import type { PersistenceLayer, LocalRtc } from '@rtc-agent/persistence';
+import type { ConnectionState } from '@rtc-agent/client';
+import type { Logger } from '@rtc-agent/client';
+import type { FileNode } from '../../../types/index.js';
+import type { Mode } from '../../../types/index.js';
+import type { ToastActions } from '../../../controllers/toast.controller.js';
+export interface ConnectionDeps {
+    persistence: {
+        layer: PersistenceLayer | undefined;
+        masterLock: {
+            isMaster: boolean;
+            onAcquire?: () => void;
+        } | undefined;
+        workerBridge?: {
+            core: {
+                batchWriteFiles(files: Array<{
+                    path: string;
+                    content: string;
+                }>): Promise<void>;
+            };
+        };
+        connect(): Promise<void>;
+        getConnectionState(): Promise<ConnectionState>;
+        onConnectionStateChange(cb: (event: {
+            state: ConnectionState;
+        }) => void): () => void;
+    };
+    message: {
+        persistence?: PersistenceLayer;
+    };
+    session: {
+        persistence?: PersistenceLayer;
+    };
+    notification: {
+        persistence?: PersistenceLayer;
+    };
+    activity: {
+        active: string;
+    };
+    fileExplorer: {
+        actions: {
+            setRoot(root: FileNode): void;
+        };
+    };
+    toast: ToastActions;
+    skill: {
+        actions: {
+            getRegistry(): unknown;
+        };
+    };
+    mode: {
+        value: {
+            state: {
+                currentMode: Mode;
+            };
+        };
+    };
+    scenariosURL: string;
+    loadFileTree: () => Promise<void>;
+    restoreEditorAreaContent: () => Promise<void>;
+    showToolConfirm: (rtc: LocalRtc) => Promise<boolean>;
+    showAskUser: (rtc: LocalRtc) => Promise<unknown>;
+    loadSessions: () => void;
+    onConnectionStateChange?: (state: ConnectionState) => void;
+    logger: Logger;
+}
+export interface ConnectionResult {
+    connectionFailed: boolean;
+    connectionError: string;
+    rtcProcessor?: RtcProcessor;
+    unsubConnection?: () => void;
+    connectionState: ConnectionState;
+}
+/**
+ * Connect to the persistence layer with error handling and retry.
+ *
+ * If the connection fails, returns `{connectionFailed: true, connectionError: ...}`
+ * so the caller can update UI state (e.g. show retry button in title bar).
+ *
+ * Post-connection steps:
+ * 1. Inject persistence layer into Message/Session/Notification controllers.
+ * 2. Load file tree if 'files' activity is active.
+ * 3. Restore editor area content from VFS.
+ * 4. Generate and write agent docs from FunctionRegistry.
+ * 5. Reload scenarios from scenariosURL.
+ * 6. Initialize RTC processor and resume pending tasks.
+ * 7. Set up connection state listener.
+ * 8. Load sessions from DB.
+ */
+export declare function connectWithRetry(deps: ConnectionDeps): Promise<ConnectionResult>;
+//# sourceMappingURL=connection-setup.d.ts.map

package/dist/components/rtc-agent/helpers/connection-setup.d.ts.map

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

package/dist/components/rtc-agent/helpers/dialog-helpers.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Dialog factory helpers for <rtc-agent>.
+ *
+ * Pure functions that create and manage dialog overlays.
+ * Extracted from rtc-agent.ts to keep the root component lean.
+ */
+import type { LocalRtc } from '@rtc-agent/persistence';
+/**
+ * Show tool confirmation dialog.
+ *
+ * Creates an <rtc-tool-confirm> overlay, appends it to the host's shadowRoot,
+ * and returns a Promise that resolves to true (approved) or false (denied).
+ * The overlay is automatically removed after the user responds.
+ *
+ * @param rtc - The RTC record being confirmed.
+ * @param host - The shadow root host to append the dialog to.
+ */
+export declare function showToolConfirmDialog(rtc: LocalRtc, host: ShadowRoot): Promise<boolean>;
+export interface AskUserAnswer {
+    answers: Record<string, string>;
+    annotations?: Record<string, {
+        preview?: string;
+        notes?: string;
+    }>;
+    metadata?: {
+        source?: string;
+    };
+}
+/**
+ * Show AskUser multi-select dialog.
+ *
+ * Creates an <rtc-ask-user> overlay, appends it to the host's shadowRoot,
+ * and returns a Promise that resolves to the user's answer dict or null if dismissed.
+ * The overlay is automatically removed after the user responds.
+ *
+ * @param rtc - The RTC record containing the questions.
+ * @param host - The shadow root host to append the dialog to.
+ */
+export declare function showAskUserDialog(rtc: LocalRtc, host: ShadowRoot): Promise<AskUserAnswer | null>;
+/**
+ * Show restore-to-default confirmation dialog.
+ *
+ * Creates an <rtc-restore-confirm> overlay, appends it to the host's shadowRoot,
+ * and returns a Promise that resolves to true (confirmed) or false (cancelled).
+ * The overlay is automatically removed after the user responds.
+ *
+ * @param filePath - The file path being restored.
+ * @param host - The shadow root host to append the dialog to.
+ */
+export declare function showRestoreConfirmDialog(filePath: string, host: ShadowRoot): Promise<boolean>;
+//# sourceMappingURL=dialog-helpers.d.ts.map

package/dist/components/rtc-agent/helpers/dialog-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-helpers.d.ts","sourceRoot":"","sources":["../../../../src/components/rtc-agent/helpers/dialog-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAIvD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACjC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,UAAU,GACjB,OAAO,CAAC,OAAO,CAAC,CAgClB;AAID,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC7B,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,UAAU,GACjB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA8B/B;AAID;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,GACjB,OAAO,CAAC,OAAO,CAAC,CA0BlB"}

package/dist/components/rtc-agent/helpers/session-loader.d.ts

@@ -0,0 +1,67 @@
+import type { Logger } from '@rtc-agent/client';
+import type { PersistenceLayer } from '@rtc-agent/persistence';
+import type { Session, SessionStatus } from '../../../types/index.js';
+export interface SessionLoaderDeps {
+    persistenceLayer: PersistenceLayer | undefined;
+    session: {
+        value: {
+            state: {
+                currentSessionId: string | null;
+            };
+        };
+        actions: {
+            setSessions(sessions: Session[]): void;
+            switchSession(id: string): void;
+            clearCurrentSession(): void;
+        };
+    };
+    sessionTree: {
+        actions: {
+            rebuildTree(sessions: Session[]): void;
+        };
+    };
+    sessionTab: {
+        value: {
+            state: {
+                tabs: ReadonlyArray<{
+                    sessionId: string;
+                    title: string;
+                }>;
+                activeSessionId: string | null;
+            };
+        };
+        actions: {
+            getStoredActiveSessionId(): string | null;
+            openOrActivate(sessionId: string, title: string, opts?: {
+                activate?: boolean;
+                skipPersist?: boolean;
+                isUnsaved?: boolean;
+            }): void;
+            setActiveTab(sessionId: string): void;
+        };
+        filterInvalidTabs(validIds: Set<string>): boolean;
+        updateTabTitles(titleMap: Map<string, string>): boolean;
+        syncTabStatuses(statusMap: Map<string, SessionStatus>): void;
+    };
+    logger: Logger;
+}
+/**
+ * Load sessions list from persistence and sync into SessionController.
+ *
+ * On initial load (after refresh), auto-selects the most recently updated session
+ * if none is currently selected.
+ *
+ * Side effects:
+ * - Updates SessionController with the loaded sessions.
+ * - Rebuilds the session tree.
+ * - Restores tabs from DB on first load.
+ * - Filters invalid tabs (sessions deleted from persistence).
+ * - Syncs tab titles and statuses.
+ * - Auto-selects a session on initial load.
+ *
+ * @param initialLoadDone - Whether the initial load has already been performed.
+ * @param deps - Dependencies for session, tab, and tree management.
+ * @returns `true` if the initial load was performed during this call.
+ */
+export declare function loadSessions(initialLoadDone: boolean, deps: SessionLoaderDeps): Promise<boolean>;
+//# sourceMappingURL=session-loader.d.ts.map

package/dist/components/rtc-agent/helpers/session-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-loader.d.ts","sourceRoot":"","sources":["../../../../src/components/rtc-agent/helpers/session-loader.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAItE,MAAM,WAAW,iBAAiB;IAC9B,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC/C,OAAO,EAAE;QACL,KAAK,EAAE;YAAE,KAAK,EAAE;gBAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAA;SAAE,CAAC;QACtD,OAAO,EAAE;YACL,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;YACvC,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;YAChC,mBAAmB,IAAI,IAAI,CAAC;SAC/B,CAAC;KACL,CAAC;IACF,WAAW,EAAE;QACT,OAAO,EAAE;YAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;SAAE,CAAC;KACvD,CAAC;IACF,UAAU,EAAE;QACR,KAAK,EAAE;YACH,KAAK,EAAE;gBACH,IAAI,EAAE,aAAa,CAAC;oBAAE,SAAS,EAAE,MAAM,CAAC;oBAAC,KAAK,EAAE,MAAM,CAAA;iBAAE,CAAC,CAAC;gBAC1D,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;aAClC,CAAC;SACL,CAAC;QACF,OAAO,EAAE;YACL,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAAC;YAC1C,cAAc,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;gBACH,QAAQ,CAAC,EAAE,OAAO,CAAC;gBACnB,WAAW,CAAC,EAAE,OAAO,CAAC;gBACtB,SAAS,CAAC,EAAE,OAAO,CAAC;aACvB,GACF,IAAI,CAAC;YACR,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;SACzC,CAAC;QAEF,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC;QAClD,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC;QACxD,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC;KAChE,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAC9B,eAAe,EAAE,OAAO,EACxB,IAAI,EAAE,iBAAiB,GACxB,OAAO,CAAC,OAAO,CAAC,CAwKlB"}

package/dist/components/rtc-agent/helpers/vfs-operations.d.ts

@@ -0,0 +1,136 @@
+import type { Logger } from '@rtc-agent/client';
+import type { FileNode } from '../../../types/index.js';
+import type { ToastActions } from '../../../controllers/toast.controller.js';
+export interface VfsDeps {
+    persistenceIsConnected: boolean;
+    fileExplorer: {
+        actions: {
+            setRoot(root: FileNode): void;
+            setLoading(path: string, loading: boolean): void;
+            updateChildren(path: string, children: FileNode[]): void;
+            selectNode(path: string): void;
+        };
+        value: {
+            isExpanded(path: string): boolean;
+        };
+    };
+    editorArea: {
+        tabs: ReadonlyArray<{
+            filePath: string;
+            content: string;
+            isDirty: boolean;
+        }>;
+        activeFilePath: string | null;
+        actions: {
+            openFile(path: string, content?: string, viewMode?: string): void;
+            closeFile(path: string): void;
+            loadContent(path: string, content: string): void;
+            saveFile(path: string): void;
+        };
+    };
+    toast: ToastActions;
+    settingsDefaultViewMode: string;
+    logger: Logger;
+}
+/**
+ * Load file tree from virtualFS (root directory, first level only).
+ *
+ * Phase 4: only loads the root's immediate children;
+ * subdirectories are lazy-loaded on demand via {@link loadFolderChildren}.
+ *
+ * @returns `true` if the tree was loaded successfully.
+ */
+export declare function loadFileTree(deps: VfsDeps): Promise<boolean>;
+/**
+ * Shallow-build a FileNode: only load the immediate children of a directory.
+ *
+ * Subdirectory children are left as `undefined` (not loaded);
+ * they are loaded on demand by {@link loadFolderChildren} when the user expands them.
+ */
+export declare function buildFileNodeShallow(path: string): Promise<FileNode>;
+/**
+ * Lazy-load children of a directory.
+ *
+ * Triggered by folder-toggle event (on first expand).
+ * Updates the file tree via fileExplorer.actions.updateChildren after loading.
+ */
+export declare function loadFolderChildren(path: string, deps: VfsDeps): Promise<void>;
+/**
+ * Open a file: read content from VFS and open in editor.
+ */
+export declare function handleFileOpen(filePath: string, deps: VfsDeps): Promise<void>;
+/**
+ * Restore Editor Area content for open files after page refresh.
+ *
+ * Tab metadata (filePath, viewMode, cursorPosition, activeFilePath) was already
+ * restored from localStorage in EditorAreaController constructor, but content is empty.
+ * This function iterates all restored tabs after VFS is ready, reads content from VFS,
+ * and fills it in. Tabs that fail to read (file no longer exists) are auto-closed.
+ */
+export declare function restoreEditorAreaContent(fileTreeLoaded: boolean, deps: VfsDeps): Promise<void>;
+/**
+ * Save file: write editor content to VFS.
+ *
+ * Sets `editedByUser: true` in metadata to protect from system overwrites.
+ */
+export declare function handleEditorSave(filePath: string, deps: VfsDeps): Promise<void>;
+/**
+ * Handle file change events from other tabs (via UIUpdateBus).
+ *
+ * - write/create: refresh parent dir in file tree; if file is open and unmodified, reload content.
+ * - delete: refresh parent dir in file tree; if file is open, close the tab.
+ * - batch: full refresh of file tree.
+ *
+ * @param filePath - The affected file path.
+ * @param field - The changed field ('write', 'create', 'delete', 'batch').
+ * @param fileTreeLoaded - Whether the file tree has been loaded at least once.
+ * @param deps - Shared dependencies.
+ * @param loadTree - Callback to reload the entire file tree.
+ * @param loadChildren - Callback to reload a directory's children.
+ */
+export declare function handleFileChange(filePath: string, field: string, fileTreeLoaded: boolean, deps: VfsDeps, loadTree: () => Promise<void>, loadChildren: (path: string) => Promise<void>): Promise<void>;
+/**
+ * Dependencies for handleRestoreDefault.
+ */
+export interface RestoreDefaultDeps {
+    persistence: {
+        workerBridge?: {
+            core: {
+                virtualFSWrite(path: string, content: string, mode: 'overwrite' | 'append', metadataOverride?: Partial<{
+                    editedByUser: boolean;
+                }>): Promise<number>;
+            };
+        };
+    };
+    editorArea: {
+        actions: {
+            loadContent(path: string, content: string): void;
+        };
+    };
+    skill: {
+        actions: {
+            getRegistry(): {
+                generateAllDocsContent(scenarioCount?: number): Array<{
+                    path: string;
+                    content: string;
+                }>;
+            } | null;
+        };
+    };
+    scenariosURL: string;
+    toast: ToastActions;
+    logger: Logger;
+}
+/**
+ * Restore a file to its default (system-generated) content.
+ *
+ * For /AGENT.md and /functions/*.md: regenerates from the current registry.
+ * For /scenarios/*.md: reloads from the scenariosURL (if set).
+ *
+ * After restore, sets `editedByUser: false` to allow future system updates.
+ */
+export declare function handleRestoreDefault(filePath: string, deps: RestoreDefaultDeps): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=vfs-operations.d.ts.map

package/dist/components/rtc-agent/helpers/vfs-operations.d.ts.map

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