codexmate 0.0.25 → 0.0.26

package/web-ui/modules/app.methods.session-browser.mjs

@@ -1,722 +1,985 @@
-import {
-    buildSessionFilterCacheState,
-    isSessionQueryEnabled,
-    normalizeSessionMessageRole,
-    normalizeSessionPathFilter
-} from '../logic.mjs';
-import {
-    applySessionsFilterUrlState,
-    buildSessionsFilterShareUrl,
-    normalizeSessionRoleFilter,
-    normalizeSessionTimePreset,
-    readSessionsFilterUrlState,
-    syncSessionsFilterUrl
-} from './sessions-filters-url.mjs';
-
-function isSessionLoadNativeDialogEnabled(vm) {
-    if (vm && typeof vm.isSessionLoadNativeDialogEnabled === 'function' && vm.isSessionLoadNativeDialogEnabled !== isSessionLoadNativeDialogEnabled) {
-        try {
-            return !!vm.isSessionLoadNativeDialogEnabled();
-        } catch (_) {
-            // fall through to shared detection
-        }
-    }
-
-    try {
-        if (globalThis && globalThis.__CODEXMATE_SESSION_LOAD_NATIVE_DIALOG__ === true) {
-            return true;
-        }
-    } catch (_) {
-        // ignore global flag lookup failures
-    }
-
-    try {
-        if (typeof localStorage !== 'undefined' && typeof localStorage.getItem === 'function') {
-            const stored = String(localStorage.getItem('codexmateSessionLoadNativeDialog') || '').trim().toLowerCase();
-            if (stored === '1' || stored === 'true' || stored === 'yes' || stored === 'on') {
-                return true;
-            }
-        }
-    } catch (_) {
-        // ignore storage lookup failures
-    }
-
-    try {
-        const search = typeof location !== 'undefined' && location && typeof location.search === 'string'
-            ? location.search
-            : (typeof window !== 'undefined' && window.location && typeof window.location.search === 'string'
-                ? window.location.search
-                : '');
-        if (!search) {
-            return false;
-        }
-        const params = new URLSearchParams(search);
-        const value = String(params.get('sessionLoadNativeDialog') || '').trim().toLowerCase();
-        return value === '1' || value === 'true' || value === 'yes' || value === 'on';
-    } catch (_) {
-        return false;
-    }
-}
-
-function emitSessionLoadNativeDialog(vm, step, details = '') {
-    if (!isSessionLoadNativeDialogEnabled(vm)) {
-        return;
-    }
-    const alertFn = typeof globalThis.alert === 'function'
-        ? globalThis.alert.bind(globalThis)
-        : (typeof window !== 'undefined' && typeof window.alert === 'function'
-            ? window.alert.bind(window)
-            : null);
-    if (!alertFn) {
-        return;
-    }
-    const message = details
-        ? `[codexmate][session-load] ${step}\n${details}`
-        : `[codexmate][session-load] ${step}`;
-    alertFn(message);
-}
-
-export function createSessionBrowserMethods(options = {}) {
-    const {
-        api,
-        loadSessionsHelper,
-        loadActiveSessionDetailHelper
-    } = options;
-
-    return {
-        normalizeSessionPathValue(value) {
-            return normalizeSessionPathFilter(value);
-        },
-
-        mergeSessionPathOptions(baseList = [], incomingList = []) {
-            const merged = [];
-            const seen = new Set();
-            const append = (items) => {
-                if (!Array.isArray(items)) return;
-                for (const item of items) {
-                    const value = this.normalizeSessionPathValue(item);
-                    if (!value) continue;
-                    const key = value.toLowerCase();
-                    if (seen.has(key)) continue;
-                    seen.add(key);
-                    merged.push(value);
-                }
-            };
-
-            append(baseList);
-            append(incomingList);
-            return merged;
-        },
-
-        extractPathOptionsFromSessions(sessions) {
-            const paths = [];
-            if (!Array.isArray(sessions)) {
-                return paths;
-            }
-
-            const seen = new Set();
-            for (const session of sessions) {
-                const value = this.normalizeSessionPathValue(session && session.cwd ? session.cwd : '');
-                if (!value) continue;
-                const key = value.toLowerCase();
-                if (seen.has(key)) continue;
-                seen.add(key);
-                paths.push(value);
-            }
-            return paths;
-        },
-
-        syncSessionPathOptionsForSource(source, nextOptions, mergeWithExisting = false) {
-            const targetSource = source === 'claude'
-                ? 'claude'
-                : (source === 'gemini' ? 'gemini' : (source === 'all' ? 'all' : 'codex'));
-            const current = Array.isArray(this.sessionPathOptionsMap[targetSource])
-                ? this.sessionPathOptionsMap[targetSource]
-                : [];
-            const merged = mergeWithExisting
-                ? this.mergeSessionPathOptions(current, nextOptions)
-                : this.mergeSessionPathOptions([], nextOptions);
-            this.sessionPathOptionsMap = {
-                ...this.sessionPathOptionsMap,
-                [targetSource]: merged
-            };
-            this.refreshSessionPathOptions(targetSource);
-        },
-
-        refreshSessionPathOptions(source) {
-            const targetSource = source === 'claude'
-                ? 'claude'
-                : (source === 'gemini' ? 'gemini' : (source === 'all' ? 'all' : 'codex'));
-            const base = Array.isArray(this.sessionPathOptionsMap[targetSource])
-                ? [...this.sessionPathOptionsMap[targetSource]]
-                : [];
-            const selected = this.normalizeSessionPathValue(this.sessionPathFilter);
-            if (selected && !base.some(item => item.toLowerCase() === selected.toLowerCase())) {
-                base.unshift(selected);
-            }
-            if (targetSource === this.sessionFilterSource) {
-                this.sessionPathOptions = base;
-            }
-        },
-
-        isSessionLoadNativeDialogEnabled() {
-            return isSessionLoadNativeDialogEnabled(this);
-        },
-
-        emitSessionLoadNativeDialog(step, details = '') {
-            emitSessionLoadNativeDialog(this, step, details);
-        },
-
-        async loadSessionPathOptions(options = {}) {
-            const source = options.source === 'claude'
-                ? 'claude'
-                : (options.source === 'gemini' ? 'gemini' : (options.source === 'all' ? 'all' : 'codex'));
-            const forceRefresh = !!options.forceRefresh;
-            const loaded = !!this.sessionPathOptionsLoadedMap[source];
-            if (!forceRefresh && loaded) {
-                emitSessionLoadNativeDialog(this, 'loadSessionPathOptions:cache-hit', `source=${source}`);
-                if (source === this.sessionFilterSource) {
-                    this.sessionPathOptionsLoading = false;
-                }
-                return;
-            }
-
-            const nextSeqMap = {
-                ...(this.sessionPathRequestSeqMap || {})
-            };
-            const requestSeq = (Number(nextSeqMap[source]) || 0) + 1;
-            nextSeqMap[source] = requestSeq;
-            this.sessionPathRequestSeqMap = nextSeqMap;
-            emitSessionLoadNativeDialog(
-                this,
-                'loadSessionPathOptions:start',
-                `source=${source}\nforceRefresh=${forceRefresh}\nrequestSeq=${requestSeq}`
-            );
-            if (source === this.sessionFilterSource) {
-                this.sessionPathOptionsLoading = true;
-            }
-            try {
-                const res = await api('list-session-paths', {
-                    source,
-                    limit: 500,
-                    forceRefresh
-                });
-                if (requestSeq !== Number(((this.sessionPathRequestSeqMap || {})[source]) || 0)) {
-                    emitSessionLoadNativeDialog(
-                        this,
-                        'loadSessionPathOptions:stale-response',
-                        `source=${source}\nrequestSeq=${requestSeq}`
-                    );
-                    return;
-                }
-                if (res && !res.error && Array.isArray(res.paths)) {
-                    this.syncSessionPathOptionsForSource(source, res.paths, true);
-                    this.sessionPathOptionsLoadedMap = {
-                        ...this.sessionPathOptionsLoadedMap,
-                        [source]: true
-                    };
-                    emitSessionLoadNativeDialog(
-                        this,
-                        'loadSessionPathOptions:success',
-                        `source=${source}\npaths=${res.paths.length}`
-                    );
-                } else if (res && res.error) {
-                    emitSessionLoadNativeDialog(
-                        this,
-                        'loadSessionPathOptions:error',
-                        `source=${source}\nerror=${res.error}`
-                    );
-                }
-            } catch (error) {
-                emitSessionLoadNativeDialog(
-                    this,
-                    'loadSessionPathOptions:exception',
-                    `source=${source}\nerror=${error && error.message ? error.message : String(error)}`
-                );
-                // 路径补全失败不影响会话主流程
-            } finally {
-                if (
-                    source === this.sessionFilterSource
-                    && requestSeq === Number(((this.sessionPathRequestSeqMap || {})[source]) || 0)
-                ) {
-                    this.sessionPathOptionsLoading = false;
-                }
-                emitSessionLoadNativeDialog(
-                    this,
-                    'loadSessionPathOptions:complete',
-                    `source=${source}\nrequestSeq=${requestSeq}`
-                );
-            }
-        },
-
-        onSessionResumeYoloChange() {
-            const value = this.sessionResumeWithYolo ? '1' : '0';
-            localStorage.setItem('codexmateSessionResumeYolo', value);
-        },
-
-        restoreSessionFilterCache() {
-            const urlState = readSessionsFilterUrlState();
-            if (urlState) {
-                applySessionsFilterUrlState(this, urlState);
-                if (this.mainTab === 'sessions' && typeof this.loadSessions === 'function') {
-                    void this.loadSessions();
-                }
-                return;
-            }
-            const sourceCache = localStorage.getItem('codexmateSessionFilterSource');
-            const pathCache = localStorage.getItem('codexmateSessionPathFilter');
-            const cached = buildSessionFilterCacheState(sourceCache, pathCache);
-            this.sessionFilterSource = cached.source;
-            this.sessionPathFilter = cached.pathFilter;
-            const queryCache = localStorage.getItem('codexmateSessionQuery');
-            const roleCache = localStorage.getItem('codexmateSessionRoleFilter');
-            const timeCache = localStorage.getItem('codexmateSessionTimePreset');
-            this.sessionQuery = typeof queryCache === 'string' ? queryCache : '';
-            this.sessionRoleFilter = normalizeSessionRoleFilter(roleCache);
-            this.sessionTimePreset = normalizeSessionTimePreset(timeCache);
-            this.refreshSessionPathOptions(this.sessionFilterSource);
-            if (this.mainTab === 'sessions' && typeof this.loadSessions === 'function') {
-                const shouldReload = cached.source !== 'all'
-                    || !!cached.pathFilter
-                    || !!(this.sessionQuery && isSessionQueryEnabled(cached.source))
-                    || (this.sessionRoleFilter && this.sessionRoleFilter !== 'all')
-                    || (this.sessionTimePreset && this.sessionTimePreset !== 'all');
-                if (shouldReload) {
-                    void this.loadSessions();
-                }
-            }
-        },
-
-        persistSessionFilterCache() {
-            const cached = buildSessionFilterCacheState(this.sessionFilterSource, this.sessionPathFilter);
-            localStorage.setItem('codexmateSessionFilterSource', cached.source);
-            if (cached.pathFilter) {
-                localStorage.setItem('codexmateSessionPathFilter', cached.pathFilter);
-            } else {
-                localStorage.removeItem('codexmateSessionPathFilter');
-            }
-            if (this.sessionQuery && isSessionQueryEnabled(this.sessionFilterSource)) {
-                localStorage.setItem('codexmateSessionQuery', this.sessionQuery);
-            } else {
-                localStorage.removeItem('codexmateSessionQuery');
-            }
-            localStorage.setItem('codexmateSessionRoleFilter', normalizeSessionRoleFilter(this.sessionRoleFilter));
-            localStorage.setItem('codexmateSessionTimePreset', normalizeSessionTimePreset(this.sessionTimePreset));
-        },
-
-        normalizeSessionPinnedMap(raw) {
-            if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
-                return {};
-            }
-            const next = {};
-            for (const [key, value] of Object.entries(raw)) {
-                if (!key) continue;
-                const numeric = Number(value);
-                if (!Number.isFinite(numeric) || numeric <= 0) continue;
-                next[key] = Math.floor(numeric);
-            }
-            return next;
-        },
-
-        restoreSessionPinnedMap() {
-            const cached = localStorage.getItem('codexmateSessionPinnedMap');
-            if (!cached) {
-                this.sessionPinnedMap = {};
-                return;
-            }
-            try {
-                const parsed = JSON.parse(cached);
-                this.sessionPinnedMap = this.normalizeSessionPinnedMap(parsed);
-            } catch (_) {
-                this.sessionPinnedMap = {};
-                localStorage.removeItem('codexmateSessionPinnedMap');
-            }
-        },
-
-        persistSessionPinnedMap() {
-            const payload = (this.sessionPinnedMap && typeof this.sessionPinnedMap === 'object')
-                ? this.sessionPinnedMap
-                : {};
-            localStorage.setItem('codexmateSessionPinnedMap', JSON.stringify(payload));
-        },
-
-        shouldPruneSessionPinnedMap(sessions = this.sessionsList) {
-            if (!Array.isArray(sessions) || sessions.length === 0) {
-                return false;
-            }
-            if (this.sessionFilterSource !== 'all') {
-                return false;
-            }
-            if (this.sessionPathFilter) {
-                return false;
-            }
-            if (this.sessionQuery && isSessionQueryEnabled(this.sessionFilterSource)) {
-                return false;
-            }
-            if (this.sessionRoleFilter && this.sessionRoleFilter !== 'all') {
-                return false;
-            }
-            if (this.sessionTimePreset && this.sessionTimePreset !== 'all') {
-                return false;
-            }
-            return true;
-        },
-
-        pruneSessionPinnedMap(sessions = this.sessionsList) {
-            const current = (this.sessionPinnedMap && typeof this.sessionPinnedMap === 'object')
-                ? this.sessionPinnedMap
-                : {};
-            const list = Array.isArray(sessions) ? sessions : [];
-            if (Object.keys(current).length === 0 || !this.shouldPruneSessionPinnedMap(list)) {
-                return;
-            }
-            const validKeys = new Set(list.map((session) => this.getSessionExportKey(session)).filter(Boolean));
-            const next = {};
-            let changed = false;
-            for (const [key, value] of Object.entries(current)) {
-                if (!validKeys.has(key)) {
-                    changed = true;
-                    continue;
-                }
-                next[key] = value;
-            }
-            if (!changed) {
-                return;
-            }
-            this.sessionPinnedMap = next;
-            this.persistSessionPinnedMap();
-        },
-
-        getSessionPinTimestamp(session) {
-            if (!session) return 0;
-            const key = this.getSessionExportKey(session);
-            if (!key) return 0;
-            const raw = this.sessionPinnedMap && this.sessionPinnedMap[key];
-            const numeric = Number(raw);
-            return Number.isFinite(numeric) && numeric > 0 ? Math.floor(numeric) : 0;
-        },
-
-        isSessionPinned(session) {
-            return this.getSessionPinTimestamp(session) > 0;
-        },
-
-        toggleSessionPin(session) {
-            if (!session) return;
-            const key = this.getSessionExportKey(session);
-            if (!key) return;
-            const current = (this.sessionPinnedMap && typeof this.sessionPinnedMap === 'object')
-                ? this.sessionPinnedMap
-                : {};
-            const next = { ...current };
-            if (next[key]) {
-                delete next[key];
-            } else {
-                next[key] = Date.now();
-            }
-            this.sessionPinnedMap = next;
-            this.persistSessionPinnedMap();
-        },
-
-        removeSessionPin(session) {
-            if (!session) return;
-            const key = this.getSessionExportKey(session);
-            if (!key) return;
-            const current = (this.sessionPinnedMap && typeof this.sessionPinnedMap === 'object')
-                ? this.sessionPinnedMap
-                : {};
-            if (!current[key]) return;
-            const next = { ...current };
-            delete next[key];
-            this.sessionPinnedMap = next;
-            this.persistSessionPinnedMap();
-        },
-
-        async onSessionSourceChange(event) {
-            const rawValue = event && event.target && typeof event.target.value === 'string'
-                ? event.target.value
-                : this.sessionFilterSource;
-            const cached = buildSessionFilterCacheState(rawValue, this.sessionPathFilter);
-            this.sessionFilterSource = cached.source;
-            this.refreshSessionPathOptions(this.sessionFilterSource);
-            this.persistSessionFilterCache();
-            syncSessionsFilterUrl(this);
-            await this.loadSessions();
-        },
-
-        async onSessionPathFilterChange() {
-            this.persistSessionFilterCache();
-            syncSessionsFilterUrl(this);
-            await this.loadSessions();
-        },
-
-        async onSessionFilterChange() {
-            this.persistSessionFilterCache();
-            syncSessionsFilterUrl(this);
-            await this.loadSessions();
-        },
-
-        async clearSessionFilters() {
-            this.sessionFilterSource = 'all';
-            this.sessionPathFilter = '';
-            this.sessionQuery = '';
-            this.sessionRoleFilter = 'all';
-            this.sessionTimePreset = 'all';
-            this.persistSessionFilterCache();
-            syncSessionsFilterUrl(this);
-            await this.onSessionSourceChange();
-        },
-
-        async copySessionsFilterShareUrl() {
-            const url = buildSessionsFilterShareUrl(this);
-            if (!url) {
-                this.showMessage(typeof this.t === 'function' ? this.t('sessions.filters.urlBuildFail') : 'Failed to build link', 'error');
-                return;
-            }
-            try {
-                if (navigator.clipboard && window.isSecureContext) {
-                    await navigator.clipboard.writeText(url);
-                    this.showMessage(typeof this.t === 'function' ? this.t('toast.copy.ok') : 'Copied', 'success');
-                    return;
-                }
-            } catch (_) {}
-            const ok = typeof this.fallbackCopyText === 'function' ? this.fallbackCopyText(url) : false;
-            if (ok) {
-                this.showMessage(typeof this.t === 'function' ? this.t('toast.copy.ok') : 'Copied', 'success');
-                return;
-            }
-            this.showMessage(typeof this.t === 'function' ? this.t('toast.copy.fail') : 'Copy failed', 'error');
-        },
-
-        normalizeSessionMessage(message) {
-            const fallback = {
-                role: 'assistant',
-                normalizedRole: 'assistant',
-                roleLabel: 'Assistant',
-                text: typeof message === 'string' ? message : '',
-                timestamp: ''
-            };
-            const safeMessage = message && typeof message === 'object' ? message : fallback;
-            const normalizedRole = normalizeSessionMessageRole(
-                safeMessage.normalizedRole || safeMessage.role
-            );
-            const roleLabel = normalizedRole === 'user'
-                ? 'User'
-                : (normalizedRole === 'system' ? 'System' : 'Assistant');
-            return {
-                ...safeMessage,
-                role: normalizedRole,
-                normalizedRole,
-                roleLabel
-            };
-        },
-
-        getRecordKey(message) {
-            if (!message || !Number.isInteger(message.recordLineIndex) || message.recordLineIndex < 0) {
-                return '';
-            }
-            return String(message.recordLineIndex);
-        },
-
-        getRecordRenderKey(message, idx) {
-            const recordKey = this.getRecordKey(message);
-            if (recordKey) {
-                return `record-${recordKey}`;
-            }
-            return `record-fallback-${idx}-${message && message.timestamp ? message.timestamp : ''}`;
-        },
-
-        syncActiveSessionMessageCount(messageCount) {
-            if (!Number.isFinite(messageCount) || messageCount < 0) return;
-            if (this.activeSession) {
-                this.activeSession.messageCount = messageCount;
-            }
-            const activeKey = this.activeSession ? this.getSessionExportKey(this.activeSession) : '';
-            if (!activeKey) return;
-            const matched = this.sessionsList.find(item => this.getSessionExportKey(item) === activeKey);
-            if (matched) {
-                matched.messageCount = messageCount;
-            }
-        },
-
-        invalidateSessionsUsageData(options = {}) {
-            this.sessionsUsageLoadedOnce = false;
-            this.sessionsUsageLoadedLimit = 0;
-            this.sessionsUsageError = '';
-            if (options.preserveList !== true) {
-                this.sessionsUsageList = [];
-            }
-        },
-
-        setSessionsUsageTimeRange(nextRange) {
-            const normalized = typeof nextRange === 'string' ? nextRange.trim().toLowerCase() : '';
-            const range = normalized === 'all' ? 'all' : (normalized === '30d' ? '30d' : '7d');
-            this.sessionsUsageTimeRange = range;
-            void this.loadSessionsUsage({ range });
-        },
-
-        async loadSessionsUsage(options = {}) {
-            if (this.sessionsUsageLoading) return;
-            const normalizedRange = typeof options.range === 'string'
-                ? options.range.trim().toLowerCase()
-                : (typeof this.sessionsUsageTimeRange === 'string' ? this.sessionsUsageTimeRange.trim().toLowerCase() : '');
-            const range = normalizedRange === 'all' ? 'all' : (normalizedRange === '30d' ? '30d' : '7d');
-            const defaultLimit = range === 'all' ? 2000 : (range === '30d' ? 1200 : 600);
-            const rawLimit = Number(options.limit);
-            const limit = Number.isFinite(rawLimit) ? Math.max(1, Math.min(rawLimit, 2000)) : defaultLimit;
-            const loadedLimit = Number(this.sessionsUsageLoadedLimit || 0);
-            if (this.sessionsUsageLoadedOnce && !options.forceRefresh && loadedLimit >= limit) {
-                return;
-            }
-            this.sessionsUsageLoading = true;
-            this.sessionsUsageError = '';
-            let loadSucceeded = false;
-            try {
-                const res = await api('list-sessions-usage', {
-                    source: 'all',
-                    limit,
-                    forceRefresh: !!options.forceRefresh
-                });
-                if (res.error) {
-                    this.sessionsUsageError = res.error;
-                    this.showMessage(res.error, 'error');
-                    return;
-                }
-                this.sessionsUsageList = Array.isArray(res.sessions) ? res.sessions : [];
-                loadSucceeded = true;
-            } catch (e) {
-                this.sessionsUsageError = '加载 usage 统计失败';
-                this.showMessage('加载 usage 统计失败', 'error');
-            } finally {
-                this.sessionsUsageLoading = false;
-                if (loadSucceeded) {
-                    this.sessionsUsageLoadedOnce = true;
-                    this.sessionsUsageLoadedLimit = limit;
-                }
-            }
-        },
-
-        async loadSessions(options = {}) {
-            const result = await loadSessionsHelper.call(this, api, options || {});
-            this.pruneSessionPinnedMap(this.sessionsList);
-            return result;
-        },
-
-        async selectSession(session) {
-            if (!session) {
-                emitSessionLoadNativeDialog(this, 'selectSession:skip-empty');
-                return;
-            }
-            emitSessionLoadNativeDialog(
-                this,
-                'selectSession:start',
-                `sessionId=${session.sessionId || ''}\nsource=${session.source || ''}`
-            );
-            const isSameSession = this.activeSession
-                && this.getSessionExportKey(this.activeSession) === this.getSessionExportKey(session);
-            if (isSameSession) {
-                emitSessionLoadNativeDialog(this, 'selectSession:same-session', `sessionId=${session.sessionId || ''}`);
-                if (this.sessionDetailLoading) {
-                    emitSessionLoadNativeDialog(this, 'selectSession:skip-detail-loading', `sessionId=${session.sessionId || ''}`);
-                    return;
-                }
-                const currentMessages = Array.isArray(this.activeSessionMessages) ? this.activeSessionMessages : [];
-                if (currentMessages.length > 0) {
-                    emitSessionLoadNativeDialog(
-                        this,
-                        'selectSession:skip-existing-messages',
-                        `sessionId=${session.sessionId || ''}\nmessages=${currentMessages.length}`
-                    );
-                    return;
-                }
-                if (typeof this.scheduleAfterFrame === 'function') {
-                    const selectedSession = this.activeSession;
-                    emitSessionLoadNativeDialog(this, 'selectSession:schedule-detail', `sessionId=${session.sessionId || ''}`);
-                    this.scheduleAfterFrame(() => {
-                        if (this.activeSession !== selectedSession) return;
-                        void this.loadActiveSessionDetail();
-                    });
-                    return;
-                }
-                emitSessionLoadNativeDialog(this, 'selectSession:load-detail-now', `sessionId=${session.sessionId || ''}`);
-                await this.loadActiveSessionDetail();
-                return;
-            }
-            this.activeSession = session;
-            emitSessionLoadNativeDialog(this, 'selectSession:activate', `sessionId=${session.sessionId || ''}`);
-            if (typeof this.expandVisibleSessionList === 'function') {
-                this.expandVisibleSessionList(0, { ensureActive: true });
-            }
-            this.activeSessionMessages = [];
-            this.resetSessionDetailPagination();
-            this.resetSessionPreviewMessageRender();
-            this.activeSessionDetailError = '';
-            this.activeSessionDetailClipped = false;
-            this.cancelSessionTimelineSync();
-            this.sessionTimelineActiveKey = '';
-            this.clearSessionTimelineRefs();
-            if (typeof this.scheduleAfterFrame === 'function') {
-                const selectedSession = this.activeSession;
-                emitSessionLoadNativeDialog(this, 'selectSession:schedule-detail', `sessionId=${session.sessionId || ''}`);
-                this.scheduleAfterFrame(() => {
-                    if (this.activeSession !== selectedSession) return;
-                    void this.loadActiveSessionDetail();
-                });
-                return;
-            }
-            emitSessionLoadNativeDialog(this, 'selectSession:load-detail-now', `sessionId=${session.sessionId || ''}`);
-            await this.loadActiveSessionDetail();
-        },
-
-        async loadSessionStandalonePlain() {
-            if (!this.activeSession) {
-                this.sessionStandaloneRequestSeq += 1;
-                this.sessionStandaloneLoading = false;
-                this.sessionStandaloneText = '';
-                this.sessionStandaloneTitle = '会话';
-                this.sessionStandaloneSourceLabel = '';
-                this.sessionStandaloneError = '';
-                return;
-            }
-
-            const requestSeq = ++this.sessionStandaloneRequestSeq;
-            const sessionSnapshot = this.activeSession;
-            this.sessionStandaloneLoading = true;
-            this.sessionStandaloneError = '';
-            try {
-                const res = await api('session-plain', {
-                    source: sessionSnapshot.source,
-                    sessionId: sessionSnapshot.sessionId,
-                    filePath: sessionSnapshot.filePath
-                });
-
-                if (requestSeq !== this.sessionStandaloneRequestSeq) {
-                    return;
-                }
-
-                if (res.error) {
-                    this.sessionStandaloneText = '';
-                    this.sessionStandaloneError = res.error;
-                    return;
-                }
-
-                this.sessionStandaloneSourceLabel = res.sourceLabel || sessionSnapshot.sourceLabel || '';
-                this.sessionStandaloneTitle = res.sessionId || sessionSnapshot.title || '会话';
-                this.sessionStandaloneText = typeof res.text === 'string' ? res.text : '';
-            } catch (e) {
-                if (requestSeq !== this.sessionStandaloneRequestSeq) {
-                    return;
-                }
-                this.sessionStandaloneText = '';
-                this.sessionStandaloneError = '加载会话内容失败: ' + e.message;
-            } finally {
-                if (requestSeq === this.sessionStandaloneRequestSeq) {
-                    this.sessionStandaloneLoading = false;
-                }
-            }
-        },
-
-        async loadActiveSessionDetail(options = {}) {
-            return loadActiveSessionDetailHelper.call(this, api, options);
-        }
-    };
-}
+import {
+    buildSessionFilterCacheState,
+    isSessionQueryEnabled,
+    normalizeSessionMessageRole,
+    normalizeSessionPathFilter
+} from '../logic.mjs';
+import {
+    applySessionsFilterUrlState,
+    buildSessionsFilterShareUrl,
+    normalizeSessionRoleFilter,
+    normalizeSessionTimePreset,
+    readSessionsFilterUrlState,
+    syncSessionsFilterUrl
+} from './sessions-filters-url.mjs';
+
+function isSessionLoadNativeDialogEnabled(vm) {
+    if (vm && typeof vm.isSessionLoadNativeDialogEnabled === 'function' && vm.isSessionLoadNativeDialogEnabled !== isSessionLoadNativeDialogEnabled) {
+        try {
+            return !!vm.isSessionLoadNativeDialogEnabled();
+        } catch (_) {
+            // fall through to shared detection
+        }
+    }
+
+    try {
+        if (globalThis && globalThis.__CODEXMATE_SESSION_LOAD_NATIVE_DIALOG__ === true) {
+            return true;
+        }
+    } catch (_) {
+        // ignore global flag lookup failures
+    }
+
+    try {
+        if (typeof localStorage !== 'undefined' && typeof localStorage.getItem === 'function') {
+            const stored = String(localStorage.getItem('codexmateSessionLoadNativeDialog') || '').trim().toLowerCase();
+            if (stored === '1' || stored === 'true' || stored === 'yes' || stored === 'on') {
+                return true;
+            }
+        }
+    } catch (_) {
+        // ignore storage lookup failures
+    }
+
+    try {
+        const search = typeof location !== 'undefined' && location && typeof location.search === 'string'
+            ? location.search
+            : (typeof window !== 'undefined' && window.location && typeof window.location.search === 'string'
+                ? window.location.search
+                : '');
+        if (!search) {
+            return false;
+        }
+        const params = new URLSearchParams(search);
+        const value = String(params.get('sessionLoadNativeDialog') || '').trim().toLowerCase();
+        return value === '1' || value === 'true' || value === 'yes' || value === 'on';
+    } catch (_) {
+        return false;
+    }
+}
+
+function emitSessionLoadNativeDialog(vm, step, details = '') {
+    if (!isSessionLoadNativeDialogEnabled(vm)) {
+        return;
+    }
+    const alertFn = typeof globalThis.alert === 'function'
+        ? globalThis.alert.bind(globalThis)
+        : (typeof window !== 'undefined' && typeof window.alert === 'function'
+            ? window.alert.bind(window)
+            : null);
+    if (!alertFn) {
+        return;
+    }
+    const message = details
+        ? `[codexmate][session-load] ${step}\n${details}`
+        : `[codexmate][session-load] ${step}`;
+    alertFn(message);
+}
+
+export function createSessionBrowserMethods(options = {}) {
+    const {
+        api,
+        loadSessionsHelper,
+        loadActiveSessionDetailHelper
+    } = options;
+
+    return {
+        normalizeSessionPathValue(value) {
+            return normalizeSessionPathFilter(value);
+        },
+
+        mergeSessionPathOptions(baseList = [], incomingList = []) {
+            const merged = [];
+            const seen = new Set();
+            const append = (items) => {
+                if (!Array.isArray(items)) return;
+                for (const item of items) {
+                    const value = this.normalizeSessionPathValue(item);
+                    if (!value) continue;
+                    const key = value.toLowerCase();
+                    if (seen.has(key)) continue;
+                    seen.add(key);
+                    merged.push(value);
+                }
+            };
+
+            append(baseList);
+            append(incomingList);
+            return merged;
+        },
+
+        extractPathOptionsFromSessions(sessions) {
+            const paths = [];
+            if (!Array.isArray(sessions)) {
+                return paths;
+            }
+
+            const seen = new Set();
+            for (const session of sessions) {
+                const value = this.normalizeSessionPathValue(session && session.cwd ? session.cwd : '');
+                if (!value) continue;
+                const key = value.toLowerCase();
+                if (seen.has(key)) continue;
+                seen.add(key);
+                paths.push(value);
+            }
+            return paths;
+        },
+
+        syncSessionPathOptionsForSource(source, nextOptions, mergeWithExisting = false) {
+            const targetSource = source === 'claude'
+                ? 'claude'
+                : (source === 'gemini' ? 'gemini' : (source === 'all' ? 'all' : 'codex'));
+            const current = Array.isArray(this.sessionPathOptionsMap[targetSource])
+                ? this.sessionPathOptionsMap[targetSource]
+                : [];
+            const merged = mergeWithExisting
+                ? this.mergeSessionPathOptions(current, nextOptions)
+                : this.mergeSessionPathOptions([], nextOptions);
+            this.sessionPathOptionsMap = {
+                ...this.sessionPathOptionsMap,
+                [targetSource]: merged
+            };
+            this.refreshSessionPathOptions(targetSource);
+        },
+
+        refreshSessionPathOptions(source) {
+            const targetSource = source === 'claude'
+                ? 'claude'
+                : (source === 'gemini' ? 'gemini' : (source === 'all' ? 'all' : 'codex'));
+            const base = Array.isArray(this.sessionPathOptionsMap[targetSource])
+                ? [...this.sessionPathOptionsMap[targetSource]]
+                : [];
+            const selected = this.normalizeSessionPathValue(this.sessionPathFilter);
+            if (selected && !base.some(item => item.toLowerCase() === selected.toLowerCase())) {
+                base.unshift(selected);
+            }
+            if (targetSource === this.sessionFilterSource) {
+                this.sessionPathOptions = base;
+            }
+        },
+
+        isSessionLoadNativeDialogEnabled() {
+            return isSessionLoadNativeDialogEnabled(this);
+        },
+
+        emitSessionLoadNativeDialog(step, details = '') {
+            emitSessionLoadNativeDialog(this, step, details);
+        },
+
+        async loadSessionPathOptions(options = {}) {
+            const source = options.source === 'claude'
+                ? 'claude'
+                : (options.source === 'gemini' ? 'gemini' : (options.source === 'all' ? 'all' : 'codex'));
+            const forceRefresh = !!options.forceRefresh;
+            const loaded = !!this.sessionPathOptionsLoadedMap[source];
+            if (!forceRefresh && loaded) {
+                emitSessionLoadNativeDialog(this, 'loadSessionPathOptions:cache-hit', `source=${source}`);
+                if (source === this.sessionFilterSource) {
+                    this.sessionPathOptionsLoading = false;
+                }
+                return;
+            }
+
+            const nextSeqMap = {
+                ...(this.sessionPathRequestSeqMap || {})
+            };
+            const requestSeq = (Number(nextSeqMap[source]) || 0) + 1;
+            nextSeqMap[source] = requestSeq;
+            this.sessionPathRequestSeqMap = nextSeqMap;
+            emitSessionLoadNativeDialog(
+                this,
+                'loadSessionPathOptions:start',
+                `source=${source}\nforceRefresh=${forceRefresh}\nrequestSeq=${requestSeq}`
+            );
+            if (source === this.sessionFilterSource) {
+                this.sessionPathOptionsLoading = true;
+            }
+            try {
+                const res = await api('list-session-paths', {
+                    source,
+                    limit: 500,
+                    forceRefresh
+                });
+                if (requestSeq !== Number(((this.sessionPathRequestSeqMap || {})[source]) || 0)) {
+                    emitSessionLoadNativeDialog(
+                        this,
+                        'loadSessionPathOptions:stale-response',
+                        `source=${source}\nrequestSeq=${requestSeq}`
+                    );
+                    return;
+                }
+                if (res && !res.error && Array.isArray(res.paths)) {
+                    this.syncSessionPathOptionsForSource(source, res.paths, true);
+                    this.sessionPathOptionsLoadedMap = {
+                        ...this.sessionPathOptionsLoadedMap,
+                        [source]: true
+                    };
+                    emitSessionLoadNativeDialog(
+                        this,
+                        'loadSessionPathOptions:success',
+                        `source=${source}\npaths=${res.paths.length}`
+                    );
+                } else if (res && res.error) {
+                    emitSessionLoadNativeDialog(
+                        this,
+                        'loadSessionPathOptions:error',
+                        `source=${source}\nerror=${res.error}`
+                    );
+                }
+            } catch (error) {
+                emitSessionLoadNativeDialog(
+                    this,
+                    'loadSessionPathOptions:exception',
+                    `source=${source}\nerror=${error && error.message ? error.message : String(error)}`
+                );
+                // 路径补全失败不影响会话主流程
+            } finally {
+                if (
+                    source === this.sessionFilterSource
+                    && requestSeq === Number(((this.sessionPathRequestSeqMap || {})[source]) || 0)
+                ) {
+                    this.sessionPathOptionsLoading = false;
+                }
+                emitSessionLoadNativeDialog(
+                    this,
+                    'loadSessionPathOptions:complete',
+                    `source=${source}\nrequestSeq=${requestSeq}`
+                );
+            }
+        },
+
+        onSessionResumeYoloChange() {
+            const value = this.sessionResumeWithYolo ? '1' : '0';
+            localStorage.setItem('codexmateSessionResumeYolo', value);
+        },
+
+        normalizeSessionSortMode(value) {
+            const normalized = typeof value === 'string' ? value.trim().toLowerCase() : '';
+            return normalized === 'hot' ? 'hot' : 'time';
+        },
+
+        restoreSessionFilterCache() {
+            const urlState = readSessionsFilterUrlState();
+            const normalizeSortMode = typeof this.normalizeSessionSortMode === 'function'
+                ? this.normalizeSessionSortMode.bind(this)
+                : ((value) => {
+                    const normalized = typeof value === 'string' ? value.trim().toLowerCase() : '';
+                    return normalized === 'hot' ? 'hot' : 'time';
+                });
+            if (urlState) {
+                applySessionsFilterUrlState(this, urlState);
+                try {
+                    const sortCache = localStorage.getItem('codexmateSessionSortMode');
+                    this.sessionSortMode = normalizeSortMode(sortCache);
+                } catch (_) {}
+                if (this.mainTab === 'sessions' && typeof this.loadSessions === 'function') {
+                    void this.loadSessions();
+                }
+                return;
+            }
+            const sourceCache = localStorage.getItem('codexmateSessionFilterSource');
+            const pathCache = localStorage.getItem('codexmateSessionPathFilter');
+            const cached = buildSessionFilterCacheState(sourceCache, pathCache);
+            this.sessionFilterSource = cached.source;
+            this.sessionPathFilter = cached.pathFilter;
+            const queryCache = localStorage.getItem('codexmateSessionQuery');
+            const roleCache = localStorage.getItem('codexmateSessionRoleFilter');
+            const timeCache = localStorage.getItem('codexmateSessionTimePreset');
+            const sortCache = localStorage.getItem('codexmateSessionSortMode');
+            this.sessionQuery = typeof queryCache === 'string' ? queryCache : '';
+            this.sessionRoleFilter = normalizeSessionRoleFilter(roleCache);
+            this.sessionTimePreset = normalizeSessionTimePreset(timeCache);
+            this.sessionSortMode = normalizeSortMode(sortCache);
+            this.refreshSessionPathOptions(this.sessionFilterSource);
+            if (this.mainTab === 'sessions' && typeof this.loadSessions === 'function') {
+                const shouldReload = cached.source !== 'all'
+                    || !!cached.pathFilter
+                    || !!(this.sessionQuery && isSessionQueryEnabled(cached.source))
+                    || (this.sessionRoleFilter && this.sessionRoleFilter !== 'all')
+                    || (this.sessionTimePreset && this.sessionTimePreset !== 'all');
+                if (shouldReload) {
+                    void this.loadSessions();
+                }
+            }
+        },
+
+        persistSessionFilterCache() {
+            const cached = buildSessionFilterCacheState(this.sessionFilterSource, this.sessionPathFilter);
+            localStorage.setItem('codexmateSessionFilterSource', cached.source);
+            if (cached.pathFilter) {
+                localStorage.setItem('codexmateSessionPathFilter', cached.pathFilter);
+            } else {
+                localStorage.removeItem('codexmateSessionPathFilter');
+            }
+            if (this.sessionQuery && isSessionQueryEnabled(this.sessionFilterSource)) {
+                localStorage.setItem('codexmateSessionQuery', this.sessionQuery);
+            } else {
+                localStorage.removeItem('codexmateSessionQuery');
+            }
+            localStorage.setItem('codexmateSessionRoleFilter', normalizeSessionRoleFilter(this.sessionRoleFilter));
+            localStorage.setItem('codexmateSessionTimePreset', normalizeSessionTimePreset(this.sessionTimePreset));
+        },
+
+        onSessionSortChange() {
+            const normalized = this.normalizeSessionSortMode(this.sessionSortMode);
+            this.sessionSortMode = normalized;
+            try {
+                localStorage.setItem('codexmateSessionSortMode', normalized);
+            } catch (_) {}
+        },
+
+        getSessionHotLabel(session) {
+            if (!session || typeof session !== 'object') return '';
+            const updatedAtMs = Date.parse(session.updatedAt || '');
+            if (!Number.isFinite(updatedAtMs)) return '';
+            const ageMs = Date.now() - updatedAtMs;
+            if (!Number.isFinite(ageMs) || ageMs < 0) return '';
+            const messageCount = Number.isFinite(Number(session.messageCount))
+                ? Math.max(0, Math.floor(Number(session.messageCount)))
+                : 0;
+            if (ageMs <= (24 * 60 * 60 * 1000) && messageCount >= 20) {
+                return typeof this.t === 'function' ? this.t('sessions.sort.hotBadge') : '热';
+            }
+            return '';
+        },
+
+        normalizeSessionPinnedMap(raw) {
+            if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+                return {};
+            }
+            const next = {};
+            for (const [key, value] of Object.entries(raw)) {
+                if (!key) continue;
+                const numeric = Number(value);
+                if (!Number.isFinite(numeric) || numeric <= 0) continue;
+                next[key] = Math.floor(numeric);
+            }
+            return next;
+        },
+
+        restoreSessionPinnedMap() {
+            const cached = localStorage.getItem('codexmateSessionPinnedMap');
+            if (!cached) {
+                this.sessionPinnedMap = {};
+                return;
+            }
+            try {
+                const parsed = JSON.parse(cached);
+                this.sessionPinnedMap = this.normalizeSessionPinnedMap(parsed);
+            } catch (_) {
+                this.sessionPinnedMap = {};
+                localStorage.removeItem('codexmateSessionPinnedMap');
+            }
+        },
+
+        persistSessionPinnedMap() {
+            const payload = (this.sessionPinnedMap && typeof this.sessionPinnedMap === 'object')
+                ? this.sessionPinnedMap
+                : {};
+            localStorage.setItem('codexmateSessionPinnedMap', JSON.stringify(payload));
+        },
+
+        shouldPruneSessionPinnedMap(sessions = this.sessionsList) {
+            if (!Array.isArray(sessions) || sessions.length === 0) {
+                return false;
+            }
+            if (this.sessionFilterSource !== 'all') {
+                return false;
+            }
+            if (this.sessionPathFilter) {
+                return false;
+            }
+            if (this.sessionQuery && isSessionQueryEnabled(this.sessionFilterSource)) {
+                return false;
+            }
+            if (this.sessionRoleFilter && this.sessionRoleFilter !== 'all') {
+                return false;
+            }
+            if (this.sessionTimePreset && this.sessionTimePreset !== 'all') {
+                return false;
+            }
+            return true;
+        },
+
+        pruneSessionPinnedMap(sessions = this.sessionsList) {
+            const current = (this.sessionPinnedMap && typeof this.sessionPinnedMap === 'object')
+                ? this.sessionPinnedMap
+                : {};
+            const list = Array.isArray(sessions) ? sessions : [];
+            if (Object.keys(current).length === 0 || !this.shouldPruneSessionPinnedMap(list)) {
+                return;
+            }
+            const validKeys = new Set(list.map((session) => this.getSessionExportKey(session)).filter(Boolean));
+            const next = {};
+            let changed = false;
+            for (const [key, value] of Object.entries(current)) {
+                if (!validKeys.has(key)) {
+                    changed = true;
+                    continue;
+                }
+                next[key] = value;
+            }
+            if (!changed) {
+                return;
+            }
+            this.sessionPinnedMap = next;
+            this.persistSessionPinnedMap();
+        },
+
+        getSessionPinTimestamp(session) {
+            if (!session) return 0;
+            const key = this.getSessionExportKey(session);
+            if (!key) return 0;
+            const raw = this.sessionPinnedMap && this.sessionPinnedMap[key];
+            const numeric = Number(raw);
+            return Number.isFinite(numeric) && numeric > 0 ? Math.floor(numeric) : 0;
+        },
+
+        isSessionPinned(session) {
+            return this.getSessionPinTimestamp(session) > 0;
+        },
+
+        toggleSessionPin(session) {
+            if (!session) return;
+            const key = this.getSessionExportKey(session);
+            if (!key) return;
+            const current = (this.sessionPinnedMap && typeof this.sessionPinnedMap === 'object')
+                ? this.sessionPinnedMap
+                : {};
+            const next = { ...current };
+            if (next[key]) {
+                delete next[key];
+            } else {
+                next[key] = Date.now();
+            }
+            this.sessionPinnedMap = next;
+            this.persistSessionPinnedMap();
+        },
+
+        removeSessionPin(session) {
+            if (!session) return;
+            const key = this.getSessionExportKey(session);
+            if (!key) return;
+            const current = (this.sessionPinnedMap && typeof this.sessionPinnedMap === 'object')
+                ? this.sessionPinnedMap
+                : {};
+            if (!current[key]) return;
+            const next = { ...current };
+            delete next[key];
+            this.sessionPinnedMap = next;
+            this.persistSessionPinnedMap();
+        },
+
+        async onSessionSourceChange(event) {
+            const rawValue = event && event.target && typeof event.target.value === 'string'
+                ? event.target.value
+                : this.sessionFilterSource;
+            const cached = buildSessionFilterCacheState(rawValue, this.sessionPathFilter);
+            this.sessionFilterSource = cached.source;
+            this.refreshSessionPathOptions(this.sessionFilterSource);
+            this.persistSessionFilterCache();
+            syncSessionsFilterUrl(this);
+            await this.loadSessions();
+        },
+
+        async onSessionPathFilterChange() {
+            this.persistSessionFilterCache();
+            syncSessionsFilterUrl(this);
+            await this.loadSessions();
+        },
+
+        async onSessionFilterChange() {
+            this.persistSessionFilterCache();
+            syncSessionsFilterUrl(this);
+            await this.loadSessions();
+        },
+
+        hasActiveSessionFilters() {
+            if (this.sessionFilterSource && this.sessionFilterSource !== 'all') return true;
+            if (this.sessionPathFilter) return true;
+            if (this.sessionQuery && isSessionQueryEnabled(this.sessionFilterSource)) return true;
+            if (this.sessionRoleFilter && this.sessionRoleFilter !== 'all') return true;
+            if (this.sessionTimePreset && this.sessionTimePreset !== 'all') return true;
+            return false;
+        },
+
+        getSessionFilterChips() {
+            const chips = [];
+            if (this.sessionFilterSource && this.sessionFilterSource !== 'all') {
+                const label = this.sessionFilterSource === 'codex'
+                    ? this.t('sessions.source.codex')
+                    : (this.sessionFilterSource === 'claude'
+                        ? this.t('sessions.source.claudeCode')
+                        : (this.sessionFilterSource === 'gemini'
+                            ? this.t('sessions.source.gemini')
+                            : (this.sessionFilterSource === 'codebuddy' ? this.t('sessions.source.codebuddy') : this.sessionFilterSource)));
+                chips.push({ key: 'source', title: this.t('sessions.filters.source'), value: label });
+            }
+            if (this.sessionPathFilter) {
+                chips.push({ key: 'path', title: this.t('sessions.filters.path'), value: this.sessionPathFilter });
+            }
+            if (this.sessionQuery && isSessionQueryEnabled(this.sessionFilterSource)) {
+                chips.push({ key: 'query', title: this.t('sessions.filters.keyword'), value: this.sessionQuery });
+            }
+            if (this.sessionRoleFilter && this.sessionRoleFilter !== 'all') {
+                const label = this.sessionRoleFilter === 'user'
+                    ? this.t('sessions.role.user')
+                    : (this.sessionRoleFilter === 'assistant'
+                        ? this.t('sessions.role.assistant')
+                        : (this.sessionRoleFilter === 'system' ? this.t('sessions.role.system') : this.sessionRoleFilter));
+                chips.push({ key: 'role', title: this.t('sessions.filters.role'), value: label });
+            }
+            if (this.sessionTimePreset && this.sessionTimePreset !== 'all') {
+                const label = this.sessionTimePreset === '7d'
+                    ? this.t('sessions.time.7d')
+                    : (this.sessionTimePreset === '30d'
+                        ? this.t('sessions.time.30d')
+                        : (this.sessionTimePreset === '90d' ? this.t('sessions.time.90d') : this.sessionTimePreset));
+                chips.push({ key: 'time', title: this.t('sessions.filters.time'), value: label });
+            }
+            return chips;
+        },
+
+        async clearSessionFilterChip(key) {
+            const normalized = typeof key === 'string' ? key.trim().toLowerCase() : '';
+            if (normalized === 'source') this.sessionFilterSource = 'all';
+            if (normalized === 'path') this.sessionPathFilter = '';
+            if (normalized === 'query') this.sessionQuery = '';
+            if (normalized === 'role') this.sessionRoleFilter = 'all';
+            if (normalized === 'time') this.sessionTimePreset = 'all';
+            this.persistSessionFilterCache();
+            syncSessionsFilterUrl(this);
+            await this.loadSessions();
+        },
+
+        async clearSessionFilters() {
+            this.sessionFilterSource = 'all';
+            this.sessionPathFilter = '';
+            this.sessionQuery = '';
+            this.sessionRoleFilter = 'all';
+            this.sessionTimePreset = 'all';
+            this.persistSessionFilterCache();
+            syncSessionsFilterUrl(this);
+            await this.onSessionSourceChange();
+        },
+
+        async copySessionsFilterShareUrl() {
+            const url = buildSessionsFilterShareUrl(this);
+            if (!url) {
+                this.showMessage(typeof this.t === 'function' ? this.t('sessions.filters.urlBuildFail') : 'Failed to build link', 'error');
+                return;
+            }
+            try {
+                if (navigator.clipboard && window.isSecureContext) {
+                    await navigator.clipboard.writeText(url);
+                    this.showMessage(typeof this.t === 'function' ? this.t('toast.copy.ok') : 'Copied', 'success');
+                    return;
+                }
+            } catch (_) {}
+            const ok = typeof this.fallbackCopyText === 'function' ? this.fallbackCopyText(url) : false;
+            if (ok) {
+                this.showMessage(typeof this.t === 'function' ? this.t('toast.copy.ok') : 'Copied', 'success');
+                return;
+            }
+            this.showMessage(typeof this.t === 'function' ? this.t('toast.copy.fail') : 'Copy failed', 'error');
+        },
+
+        normalizeSessionMessage(message) {
+            const fallback = {
+                role: 'assistant',
+                normalizedRole: 'assistant',
+                roleLabel: 'Assistant',
+                text: typeof message === 'string' ? message : '',
+                timestamp: ''
+            };
+            const safeMessage = message && typeof message === 'object' ? message : fallback;
+            const normalizedRole = normalizeSessionMessageRole(
+                safeMessage.normalizedRole || safeMessage.role
+            );
+            const roleLabel = normalizedRole === 'user'
+                ? 'User'
+                : (normalizedRole === 'system' ? 'System' : 'Assistant');
+            return {
+                ...safeMessage,
+                role: normalizedRole,
+                normalizedRole,
+                roleLabel
+            };
+        },
+
+        getRecordKey(message) {
+            if (!message || !Number.isInteger(message.recordLineIndex) || message.recordLineIndex < 0) {
+                return '';
+            }
+            return String(message.recordLineIndex);
+        },
+
+        getRecordRenderKey(message, idx) {
+            const recordKey = this.getRecordKey(message);
+            if (recordKey) {
+                return `record-${recordKey}`;
+            }
+            return `record-fallback-${idx}-${message && message.timestamp ? message.timestamp : ''}`;
+        },
+
+        syncActiveSessionMessageCount(messageCount) {
+            if (!Number.isFinite(messageCount) || messageCount < 0) return;
+            if (this.activeSession) {
+                this.activeSession.messageCount = messageCount;
+            }
+            const activeKey = this.activeSession ? this.getSessionExportKey(this.activeSession) : '';
+            if (!activeKey) return;
+            const matched = this.sessionsList.find(item => this.getSessionExportKey(item) === activeKey);
+            if (matched) {
+                matched.messageCount = messageCount;
+            }
+        },
+
+        cancelScheduledSessionListMessageCountHydrate() {
+            const handle = this.__sessionListMessageCountHydrateHandle || null;
+            if (!handle) return;
+            if (typeof this.cancelIdleTask === 'function') {
+                this.cancelIdleTask(handle);
+            }
+            this.__sessionListMessageCountHydrateHandle = null;
+        },
+
+        resetSessionListMessageCountHydrate() {
+            this.cancelScheduledSessionListMessageCountHydrate();
+            this.__sessionListMessageCountHydrateInFlight = false;
+            this.__sessionListMessageCountHydrateLastScheduleAt = 0;
+            this.__sessionListMessageCountHydrateLastAttemptAtMap = {};
+            this.sessionListMessageCountHydrateRequestSeq = (Number(this.sessionListMessageCountHydrateRequestSeq) || 0) + 1;
+        },
+
+        scheduleSessionListMessageCountHydrate() {
+            if (this.mainTab !== 'sessions' || !this.sessionListRenderEnabled) {
+                return;
+            }
+            const now = Date.now();
+            const lastAt = Number(this.__sessionListMessageCountHydrateLastScheduleAt || 0);
+            if ((now - lastAt) < 120) {
+                return;
+            }
+            this.__sessionListMessageCountHydrateLastScheduleAt = now;
+            this.cancelScheduledSessionListMessageCountHydrate();
+            const run = () => {
+                this.__sessionListMessageCountHydrateHandle = null;
+                void this.hydrateVisibleSessionListMessageCounts();
+            };
+            if (typeof this.scheduleIdleTask === 'function') {
+                this.__sessionListMessageCountHydrateHandle = this.scheduleIdleTask(run, 160);
+                return;
+            }
+            if (typeof this.scheduleAfterFrame === 'function') {
+                this.scheduleAfterFrame(run);
+                return;
+            }
+            run();
+        },
+
+        async hydrateVisibleSessionListMessageCounts() {
+            if (this.__sessionListMessageCountHydrateInFlight) {
+                return;
+            }
+            if (this.mainTab !== 'sessions' || !this.sessionListRenderEnabled) {
+                return;
+            }
+
+            const visible = Array.isArray(this.visibleSessionsList) ? this.visibleSessionsList : [];
+            if (!visible.length) return;
+
+            const now = Date.now();
+            const lastAttemptAtMap = (this.__sessionListMessageCountHydrateLastAttemptAtMap && typeof this.__sessionListMessageCountHydrateLastAttemptAtMap === 'object')
+                ? this.__sessionListMessageCountHydrateLastAttemptAtMap
+                : {};
+            const targets = [];
+            for (const session of visible) {
+                if (!session || typeof session !== 'object') continue;
+                const messageCountRaw = Number(session.messageCount);
+                const shouldHydrate = !Number.isFinite(messageCountRaw) || messageCountRaw === 0;
+                if (!shouldHydrate) continue;
+                const key = this.getSessionExportKey(session);
+                if (!key) continue;
+                const lastAttempt = Number(lastAttemptAtMap[key] || 0);
+                if ((now - lastAttempt) < 5000) {
+                    continue;
+                }
+                lastAttemptAtMap[key] = now;
+                targets.push({
+                    source: session.source,
+                    sessionId: session.sessionId,
+                    filePath: session.filePath
+                });
+                if (targets.length >= 32) {
+                    break;
+                }
+            }
+            this.__sessionListMessageCountHydrateLastAttemptAtMap = lastAttemptAtMap;
+            if (!targets.length) return;
+
+            const requestSeq = (Number(this.sessionListMessageCountHydrateRequestSeq) || 0) + 1;
+            this.sessionListMessageCountHydrateRequestSeq = requestSeq;
+            this.__sessionListMessageCountHydrateInFlight = true;
+            try {
+                const res = await api('session-message-counts', {
+                    items: targets,
+                    limit: targets.length
+                });
+                if (requestSeq !== Number(this.sessionListMessageCountHydrateRequestSeq || 0)) {
+                    return;
+                }
+                if (!res || res.error || !Array.isArray(res.items)) {
+                    return;
+                }
+                const byKey = new Map();
+                for (const item of res.items) {
+                    if (!item || typeof item !== 'object') continue;
+                    const key = typeof item.key === 'string' ? item.key : '';
+                    if (!key) continue;
+                    const messageCount = Number(item.messageCount);
+                    if (!Number.isFinite(messageCount) || messageCount < 0) continue;
+                    byKey.set(key, Math.floor(messageCount));
+                }
+                if (!byKey.size) {
+                    return;
+                }
+                const sessions = Array.isArray(this.sessionsList) ? this.sessionsList : [];
+                const sessionMap = new Map(sessions.map((session) => [this.getSessionExportKey(session), session]));
+                for (const [key, count] of byKey.entries()) {
+                    const matched = sessionMap.get(key);
+                    if (matched) {
+                        matched.messageCount = count;
+                    }
+                    if (this.activeSession && this.getSessionExportKey(this.activeSession) === key) {
+                        this.activeSession.messageCount = count;
+                    }
+                }
+            } catch (_) {
+                return;
+            } finally {
+                if (requestSeq === Number(this.sessionListMessageCountHydrateRequestSeq || 0)) {
+                    this.__sessionListMessageCountHydrateInFlight = false;
+                }
+            }
+        },
+
+        invalidateSessionsUsageData(options = {}) {
+            this.sessionsUsageLoadedOnce = false;
+            this.sessionsUsageLoadedLimit = 0;
+            this.sessionsUsageError = '';
+            if (options.preserveList !== true) {
+                this.sessionsUsageList = [];
+            }
+        },
+
+        setSessionsUsageTimeRange(nextRange) {
+            const normalized = typeof nextRange === 'string' ? nextRange.trim().toLowerCase() : '';
+            const range = normalized === 'all' ? 'all' : (normalized === '30d' ? '30d' : '7d');
+            this.sessionsUsageTimeRange = range;
+            if (range === 'all') {
+                this.sessionsUsageCompareEnabled = false;
+            }
+            void this.loadSessionsUsage({ range });
+        },
+
+        toggleSessionsUsageCompare() {
+            if (this.sessionsUsageTimeRange === 'all') {
+                this.sessionsUsageCompareEnabled = false;
+                return;
+            }
+            this.sessionsUsageCompareEnabled = !this.sessionsUsageCompareEnabled;
+            const range = typeof this.sessionsUsageTimeRange === 'string' ? this.sessionsUsageTimeRange.trim().toLowerCase() : '7d';
+            void this.loadSessionsUsage({
+                range,
+                limit: this.sessionsUsageCompareEnabled ? 2000 : undefined
+            });
+        },
+
+        selectSessionsUsageDay(dayKey) {
+            const normalized = typeof dayKey === 'string' ? dayKey.trim() : '';
+            this.sessionsUsageSelectedDayKey = normalized;
+        },
+
+        clearSessionsUsageDay() {
+            this.sessionsUsageSelectedDayKey = '';
+        },
+
+        async loadSessionsUsage(options = {}) {
+            if (this.sessionsUsageLoading) return;
+            const normalizedRange = typeof options.range === 'string'
+                ? options.range.trim().toLowerCase()
+                : (typeof this.sessionsUsageTimeRange === 'string' ? this.sessionsUsageTimeRange.trim().toLowerCase() : '');
+            const range = normalizedRange === 'all' ? 'all' : (normalizedRange === '30d' ? '30d' : '7d');
+            const defaultLimit = range === 'all' ? 2000 : (range === '30d' ? 1200 : 600);
+            const rawLimit = Number(options.limit);
+            const compareBoost = this.sessionsUsageCompareEnabled && range !== 'all'
+                ? 2000
+                : defaultLimit;
+            const limit = Number.isFinite(rawLimit)
+                ? Math.max(1, Math.min(rawLimit, 2000))
+                : compareBoost;
+            const loadedLimit = Number(this.sessionsUsageLoadedLimit || 0);
+            if (this.sessionsUsageLoadedOnce && !options.forceRefresh && loadedLimit >= limit) {
+                return;
+            }
+            this.sessionsUsageLoading = true;
+            this.sessionsUsageError = '';
+            let loadSucceeded = false;
+            try {
+                const res = await api('list-sessions-usage', {
+                    source: 'all',
+                    limit,
+                    forceRefresh: !!options.forceRefresh
+                });
+                if (res.error) {
+                    this.sessionsUsageError = res.error;
+                    this.showMessage(res.error, 'error');
+                    return;
+                }
+                this.sessionsUsageList = Array.isArray(res.sessions) ? res.sessions : [];
+                loadSucceeded = true;
+            } catch (e) {
+                this.sessionsUsageError = '加载 usage 统计失败';
+                this.showMessage('加载 usage 统计失败', 'error');
+            } finally {
+                this.sessionsUsageLoading = false;
+                if (loadSucceeded) {
+                    this.sessionsUsageLoadedOnce = true;
+                    this.sessionsUsageLoadedLimit = limit;
+                }
+            }
+        },
+
+        async loadSessions(options = {}) {
+            this.resetSessionListMessageCountHydrate();
+            const result = await loadSessionsHelper.call(this, api, options || {});
+            this.pruneSessionPinnedMap(this.sessionsList);
+            return result;
+        },
+
+        async selectSession(session) {
+            if (!session) {
+                emitSessionLoadNativeDialog(this, 'selectSession:skip-empty');
+                return;
+            }
+            emitSessionLoadNativeDialog(
+                this,
+                'selectSession:start',
+                `sessionId=${session.sessionId || ''}\nsource=${session.source || ''}`
+            );
+            const isSameSession = this.activeSession
+                && this.getSessionExportKey(this.activeSession) === this.getSessionExportKey(session);
+            if (isSameSession) {
+                emitSessionLoadNativeDialog(this, 'selectSession:same-session', `sessionId=${session.sessionId || ''}`);
+                if (this.sessionDetailLoading) {
+                    emitSessionLoadNativeDialog(this, 'selectSession:skip-detail-loading', `sessionId=${session.sessionId || ''}`);
+                    return;
+                }
+                const currentMessages = Array.isArray(this.activeSessionMessages) ? this.activeSessionMessages : [];
+                if (currentMessages.length > 0) {
+                    emitSessionLoadNativeDialog(
+                        this,
+                        'selectSession:skip-existing-messages',
+                        `sessionId=${session.sessionId || ''}\nmessages=${currentMessages.length}`
+                    );
+                    return;
+                }
+                if (typeof this.scheduleAfterFrame === 'function') {
+                    const selectedSession = this.activeSession;
+                    emitSessionLoadNativeDialog(this, 'selectSession:schedule-detail', `sessionId=${session.sessionId || ''}`);
+                    this.scheduleAfterFrame(() => {
+                        if (this.activeSession !== selectedSession) return;
+                        void this.loadActiveSessionDetail();
+                    });
+                    return;
+                }
+                emitSessionLoadNativeDialog(this, 'selectSession:load-detail-now', `sessionId=${session.sessionId || ''}`);
+                await this.loadActiveSessionDetail();
+                return;
+            }
+            this.activeSession = session;
+            emitSessionLoadNativeDialog(this, 'selectSession:activate', `sessionId=${session.sessionId || ''}`);
+            if (typeof this.expandVisibleSessionList === 'function') {
+                this.expandVisibleSessionList(0, { ensureActive: true });
+            }
+            this.activeSessionMessages = [];
+            this.resetSessionDetailPagination();
+            this.resetSessionPreviewMessageRender();
+            this.activeSessionDetailError = '';
+            this.activeSessionDetailClipped = false;
+            this.cancelSessionTimelineSync();
+            this.sessionTimelineActiveKey = '';
+            this.clearSessionTimelineRefs();
+            if (typeof this.scheduleAfterFrame === 'function') {
+                const selectedSession = this.activeSession;
+                emitSessionLoadNativeDialog(this, 'selectSession:schedule-detail', `sessionId=${session.sessionId || ''}`);
+                this.scheduleAfterFrame(() => {
+                    if (this.activeSession !== selectedSession) return;
+                    void this.loadActiveSessionDetail();
+                });
+                return;
+            }
+            emitSessionLoadNativeDialog(this, 'selectSession:load-detail-now', `sessionId=${session.sessionId || ''}`);
+            await this.loadActiveSessionDetail();
+        },
+
+        async loadSessionStandalonePlain() {
+            if (!this.activeSession) {
+                this.sessionStandaloneRequestSeq += 1;
+                this.sessionStandaloneLoading = false;
+                this.sessionStandaloneText = '';
+                this.sessionStandaloneTitle = '会话';
+                this.sessionStandaloneSourceLabel = '';
+                this.sessionStandaloneError = '';
+                return;
+            }
+
+            const requestSeq = ++this.sessionStandaloneRequestSeq;
+            const sessionSnapshot = this.activeSession;
+            this.sessionStandaloneLoading = true;
+            this.sessionStandaloneError = '';
+            try {
+                const res = await api('session-plain', {
+                    source: sessionSnapshot.source,
+                    sessionId: sessionSnapshot.sessionId,
+                    filePath: sessionSnapshot.filePath,
+                    maxMessages: sessionSnapshot.maxMessages || 50
+                });
+
+                if (requestSeq !== this.sessionStandaloneRequestSeq) {
+                    return;
+                }
+
+                if (res.error) {
+                    this.sessionStandaloneText = '';
+                    this.sessionStandaloneError = res.error;
+                    return;
+                }
+
+                this.sessionStandaloneSourceLabel = res.sourceLabel || sessionSnapshot.sourceLabel || '';
+                this.sessionStandaloneTitle = res.sessionId || sessionSnapshot.title || '会话';
+                this.sessionStandaloneText = typeof res.text === 'string' ? res.text : '';
+            } catch (e) {
+                if (requestSeq !== this.sessionStandaloneRequestSeq) {
+                    return;
+                }
+                this.sessionStandaloneText = '';
+                this.sessionStandaloneError = '加载会话内容失败: ' + e.message;
+            } finally {
+                if (requestSeq === this.sessionStandaloneRequestSeq) {
+                    this.sessionStandaloneLoading = false;
+                }
+            }
+        },
+
+        async loadActiveSessionDetail(options = {}) {
+            const result = await loadActiveSessionDetailHelper.call(this, api, options);
+            if (this.mainTab === 'sessions' && typeof this.scheduleSessionListMessageCountHydrate === 'function') {
+                this.scheduleSessionListMessageCountHydrate();
+            }
+            return result;
+        }
+    };
+}