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

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

@@ -0,0 +1,110 @@
+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>;
+    evictSession(sessionId: string): 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;
+}
+/**
+ * Debounced session loader to prevent multiple concurrent loadSessions calls.
+ *
+ * When multiple session structural changes occur in quick succession (e.g., batch imports),
+ * this class ensures only one loadSessions call is made after a debounce period.
+ * It also serializes in-flight requests to prevent race conditions.
+ *
+ * Fix 40: Prevents IndexedDB query storms and UI jitter from rapid session events.
+ */
+export declare class DebouncedSessionLoader {
+    private _timer?;
+    private _inflight?;
+    private readonly _debounceMs;
+    private readonly _loadSessions;
+    constructor(loadSessions: () => Promise<void>, debounceMs?: number);
+    /**
+     * Request a session reload. If called multiple times within the debounce period,
+     * only one actual loadSessions call will be made.
+     */
+    request(): void;
+    /**
+     * Execute the actual loadSessions call, serializing with any in-flight request.
+     */
+    private _execute;
+    /**
+     * Clean up pending timer on dispose.
+     */
+    dispose(): 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;
+    /** Debounced session loader to prevent multiple concurrent loadSessions calls. */
+    sessionLoader: DebouncedSessionLoader;
+    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;IACtD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;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;AAED;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,MAAM,CAAC,CAAgC;IAC/C,OAAO,CAAC,SAAS,CAAC,CAAgB;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;gBAGhD,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACjC,UAAU,GAAE,MAAW;IAM3B;;;OAGG;IACH,OAAO,IAAI,IAAI;IAaf;;OAEG;YACW,QAAQ;IAWtB;;OAEG;IACH,OAAO,IAAI,IAAI;CAMlB;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,kFAAkF;IAClF,aAAa,EAAE,sBAAsB,CAAC;IACtC,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,CAsCtB"}

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

@@ -0,0 +1,25 @@
+import type { PersistenceLayer } from '@rtc-agent/persistence';
+import type { Logger } from '@rtc-agent/client';
+import type { ToastActions } from '../../../controllers/toast.controller.js';
+import type { Session, Message } from '../../../types/index.js';
+export interface CommandDeps {
+    persistenceLayer: PersistenceLayer | undefined;
+    currentSessionId: string | null;
+    /** Current session object (for commands that need session metadata like title, tokens). */
+    currentSession?: Session;
+    /** Current session messages (for commands that need message data like /export). */
+    currentMessages?: Message[];
+    /** Shadow root host for showing dialogs. */
+    host?: ShadowRoot;
+    toast: ToastActions;
+    logger: Logger;
+}
+/**
+ * Handle slash commands dispatched from the input area.
+ *
+ * Currently supported:
+ * - /compact [custom_instruction]: compress current session context
+ * - /export: export current session to HTML file
+ */
+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;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAOhE,MAAM,WAAW,WAAW;IACxB,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC/C,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,2FAA2F;IAC3F,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,eAAe,CAAC,EAAE,OAAO,EAAE,CAAC;IAC5B,4CAA4C;IAC5C,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;GAMG;AACH,wBAAsB,aAAa,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,IAAI,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAYf"}

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

@@ -0,0 +1,89 @@
+import { RtcProcessor } from '@rtc-agent/persistence';
+import type { PersistenceLayer, LocalRtc } from '@rtc-agent/persistence';
+import type { WorkerBridge } from '../../../worker-bridge.js';
+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?: WorkerBridge;
+        connect(): Promise<void>;
+        getConnectionState(): Promise<ConnectionState>;
+        onConnectionStateChange(cb: (event: {
+            state: ConnectionState;
+        }) => void): () => void;
+    };
+    message: {
+        persistence?: PersistenceLayer;
+    };
+    session: {
+        persistence?: PersistenceLayer;
+    };
+    notification: {
+        persistence?: PersistenceLayer;
+    };
+    functionDebug: {
+        workerBridge: WorkerBridge | null;
+    };
+    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,63 @@
+/**
+ * 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';
+import type { ExportOptions } from '../../overlay/rtc-export-dialog.js';
+/**
+ * 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>;
+/**
+ * Show export options dialog.
+ *
+ * Creates an <rtc-export-dialog> overlay, appends it to the host's shadowRoot,
+ * and returns a Promise that resolves to the export options or null if cancelled.
+ * The overlay is automatically removed after the user responds.
+ *
+ * @param totalMessages - Total number of messages available for export.
+ * @param host - The shadow root host to append the dialog to.
+ */
+export declare function showExportDialog(totalMessages: number, host: ShadowRoot): Promise<ExportOptions | null>;
+//# 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;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAIxE;;;;;;;;;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;AAID;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC5B,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,UAAU,GACjB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA2B/B"}

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

@@ -0,0 +1,69 @@
+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;
+                    isUnsaved?: boolean;
+                }>;
+                activeSessionId: string | null;
+            };
+        };
+        actions: {
+            getStoredActiveSessionId(): string | null;
+            openOrActivate(sessionId: string, title: string, opts?: {
+                activate?: boolean;
+                skipPersist?: boolean;
+                isUnsaved?: boolean;
+            }): void;
+            closeTab(sessionId: string): 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,CAAC;oBAAC,SAAS,CAAC,EAAE,OAAO,CAAA;iBAAE,CAAC,CAAC;gBAC/E,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,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;YAClC,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,CAmLlB"}

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

@@ -0,0 +1,155 @@
+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.
+ *
+ * Fix 42: Uses generation counter to detect stale results from concurrent loads.
+ * If a newer load starts for the same path, older loads are discarded.
+ */
+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.
+ *
+ * Race-condition safety (loop-until-stable + per-file lock):
+ *
+ * 1. Concurrency guard: if a save is already in-flight for this file,
+ *    returns immediately. The in-flight save's loop will detect content
+ *    drift and re-write.
+ * 2. Snapshot comparison: captures content before each write; after write
+ *    completes, re-reads current tab content. If they differ, the user
+ *    typed during the write -- loop writes again with latest content.
+ * 3. The lock is held throughout the entire loop, preventing out-of-order
+ *    writes from concurrent save attempts (e.g. Ctrl+S during auto-save).
+ * 4. Loop naturally converges: user stops typing -> content stable ->
+ *    at most 1 extra iteration after drift detection.
+ */
+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): Promise<{
+                    files: Array<{
+                        path: string;
+                        content: string;
+                    }>;
+                    deletePaths: 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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"}