@elizaos/ui 2.0.0-beta.1 → 2.0.3-beta.2

package/dist/state/persistence.js

@@ -1,794 +0,0 @@
-import { logger } from "@elizaos/core";
-import { asRecord } from "@elizaos/shared";
-import { fetchWithCsrf } from "../api/csrf-client.js";
-import { getBootConfig } from "../config/boot-config-store.js";
-import { DEFAULT_UI_LANGUAGE, normalizeLanguage, } from "../i18n/index.js";
-import { applyThemeToDocument, clearThemeOverrides, resolveBuiltinTheme, } from "../themes/apply-theme.js";
-import { normalizeAvatarIndex } from "./vrm.js";
-/* ── Shared localStorage helper ──────────────────────────────────────── */
-function tryLocalStorage(fn, fallback) {
-    try {
-        return fn();
-    }
-    catch (err) {
-        console.warn("[persistence] localStorage operation failed:", err);
-        return fallback;
-    }
-}
-function describePersistenceError(err) {
-    return err instanceof Error ? err.message : String(err);
-}
-const UI_THEME_STORAGE_KEY = "eliza:ui-theme";
-const LEGACY_UI_THEME_STORAGE_KEY = "elizaos:ui-theme";
-const THEME_ID_STORAGE_KEY = "eliza:theme-id";
-const THEME_SWITCHING_ATTRIBUTE = "data-theme-switching";
-let themeSwitchResetFrameId = null;
-function normalizeUiTheme(value) {
-    return value === "light" ? "light" : "dark";
-}
-export { normalizeUiTheme };
-function suppressThemeTransitions(root) {
-    if (typeof window === "undefined")
-        return;
-    root.setAttribute(THEME_SWITCHING_ATTRIBUTE, "");
-    if (themeSwitchResetFrameId != null) {
-        window.cancelAnimationFrame(themeSwitchResetFrameId);
-    }
-    themeSwitchResetFrameId = window.requestAnimationFrame(() => {
-        themeSwitchResetFrameId = window.requestAnimationFrame(() => {
-            root.removeAttribute(THEME_SWITCHING_ATTRIBUTE);
-            themeSwitchResetFrameId = null;
-        });
-    });
-}
-export function loadUiTheme() {
-    return tryLocalStorage(() => {
-        const current = localStorage.getItem(UI_THEME_STORAGE_KEY);
-        if (current != null)
-            return normalizeUiTheme(current);
-        return normalizeUiTheme(localStorage.getItem(LEGACY_UI_THEME_STORAGE_KEY));
-    }, "dark");
-}
-export function saveUiTheme(theme) {
-    tryLocalStorage(() => {
-        const normalized = normalizeUiTheme(theme);
-        localStorage.setItem(UI_THEME_STORAGE_KEY, normalized);
-        localStorage.setItem(LEGACY_UI_THEME_STORAGE_KEY, normalized);
-    }, undefined);
-}
-/* ── Theme ID persistence ────────────────────────────────────────────── */
-export function loadThemeId() {
-    return tryLocalStorage(() => {
-        return localStorage.getItem(THEME_ID_STORAGE_KEY) ?? "bsc-gold";
-    }, "bsc-gold");
-}
-export function saveThemeId(themeId) {
-    tryLocalStorage(() => {
-        localStorage.setItem(THEME_ID_STORAGE_KEY, themeId);
-    }, undefined);
-}
-const COMPANION_VRM_POWER_STORAGE_KEY = "eliza:companion-vrm-power";
-/** Legacy; migrated into `eliza:companion-vrm-power` on first read. */
-const LEGACY_COMPANION_EFFICIENCY_KEY = "eliza:companion-efficiency";
-/** Legacy; migrated into `eliza:companion-vrm-power` on first read. */
-const LEGACY_COMPANION_QUALITY_ON_BATTERY_KEY = "eliza:companion-quality-on-battery";
-export function normalizeCompanionVrmPowerMode(value) {
-    return value === "quality" || value === "efficiency" ? value : "balanced";
-}
-/**
- * Persisted 3D companion power preference. Migrates legacy boolean keys once.
- */
-export function loadCompanionVrmPowerMode() {
-    try {
-        const raw = localStorage.getItem(COMPANION_VRM_POWER_STORAGE_KEY);
-        if (raw === "quality" || raw === "balanced" || raw === "efficiency") {
-            return raw;
-        }
-        const legacyEffPresent = localStorage.getItem(LEGACY_COMPANION_EFFICIENCY_KEY) != null;
-        const legacyQobPresent = localStorage.getItem(LEGACY_COMPANION_QUALITY_ON_BATTERY_KEY) != null;
-        if (legacyEffPresent || legacyQobPresent) {
-            const effOn = localStorage.getItem(LEGACY_COMPANION_EFFICIENCY_KEY) === "1";
-            const qobOn = localStorage.getItem(LEGACY_COMPANION_QUALITY_ON_BATTERY_KEY) === "1";
-            const migrated = effOn
-                ? "efficiency"
-                : qobOn
-                    ? "quality"
-                    : "balanced";
-            saveCompanionVrmPowerMode(migrated);
-            localStorage.removeItem(LEGACY_COMPANION_EFFICIENCY_KEY);
-            localStorage.removeItem(LEGACY_COMPANION_QUALITY_ON_BATTERY_KEY);
-            return migrated;
-        }
-        if (raw != null && raw !== "") {
-            saveCompanionVrmPowerMode("balanced");
-        }
-        return "balanced";
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to load companion VRM power mode: ${describePersistenceError(err)}`);
-        return "balanced";
-    }
-}
-export function saveCompanionVrmPowerMode(mode) {
-    try {
-        const next = normalizeCompanionVrmPowerMode(mode);
-        localStorage.setItem(COMPANION_VRM_POWER_STORAGE_KEY, next);
-        localStorage.removeItem(LEGACY_COMPANION_EFFICIENCY_KEY);
-        localStorage.removeItem(LEGACY_COMPANION_QUALITY_ON_BATTERY_KEY);
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to save companion VRM power mode: ${describePersistenceError(err)}`);
-    }
-}
-const COMPANION_ANIMATE_WHEN_HIDDEN_KEY = "eliza:companion-animate-when-hidden";
-/** When true, keep the VRM loop running when the document is hidden; 3D environment is hidden. */
-export function loadCompanionAnimateWhenHidden() {
-    try {
-        return localStorage.getItem(COMPANION_ANIMATE_WHEN_HIDDEN_KEY) === "1";
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to load companion animate-when-hidden flag: ${describePersistenceError(err)}`);
-        return false;
-    }
-}
-export function saveCompanionAnimateWhenHidden(enabled) {
-    try {
-        localStorage.setItem(COMPANION_ANIMATE_WHEN_HIDDEN_KEY, enabled ? "1" : "0");
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to save companion animate-when-hidden flag: ${describePersistenceError(err)}`);
-    }
-}
-const COMPANION_HALF_FRAMERATE_STORAGE_KEY = "eliza:companion-half-framerate";
-const COMPANION_HALF_FRAMERATE_VALUES = new Set([
-    "off",
-    "when_saving_power",
-    "always",
-]);
-function isCompanionHalfFramerateMode(value) {
-    return (typeof value === "string" && COMPANION_HALF_FRAMERATE_VALUES.has(value));
-}
-export function normalizeCompanionHalfFramerateMode(raw) {
-    if (isCompanionHalfFramerateMode(raw))
-        return raw;
-    return "when_saving_power";
-}
-export function loadCompanionHalfFramerateMode() {
-    try {
-        return normalizeCompanionHalfFramerateMode(localStorage.getItem(COMPANION_HALF_FRAMERATE_STORAGE_KEY));
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to load companion half-framerate mode: ${describePersistenceError(err)}`);
-        return "when_saving_power";
-    }
-}
-export function saveCompanionHalfFramerateMode(mode) {
-    try {
-        localStorage.setItem(COMPANION_HALF_FRAMERATE_STORAGE_KEY, normalizeCompanionHalfFramerateMode(mode));
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to save companion half-framerate mode: ${describePersistenceError(err)}`);
-    }
-}
-/**
- * Apply the theme to the document root.
- * Sets both `data-theme` attribute and `.dark` class so both CSS selectors
- * in base.css (`[data-theme="dark"]` and `.dark`) are satisfied.
- */
-export function applyUiTheme(theme) {
-    if (typeof document === "undefined")
-        return;
-    const normalizedTheme = normalizeUiTheme(theme);
-    const root = document.documentElement;
-    if (!root)
-        return;
-    const currentTheme = typeof root.getAttribute === "function"
-        ? root.getAttribute("data-theme")
-        : (root.dataset?.theme ?? null);
-    const shouldBeDark = normalizedTheme === "dark";
-    const classMatchesTheme = root.classList
-        ? root.classList.contains("dark") === shouldBeDark
-        : true;
-    const colorSchemeMatches = root.style.colorScheme === normalizedTheme;
-    const uiThemeChanged = !(currentTheme === normalizedTheme &&
-        classMatchesTheme &&
-        colorSchemeMatches);
-    if (uiThemeChanged) {
-        suppressThemeTransitions(root);
-        if (currentTheme !== normalizedTheme) {
-            if (typeof root.setAttribute === "function") {
-                root.setAttribute("data-theme", normalizedTheme);
-            }
-            else if ("dataset" in root && root.dataset) {
-                root.dataset.theme = normalizedTheme;
-            }
-            else {
-                return;
-            }
-        }
-        if (root.style && root.style.colorScheme !== normalizedTheme) {
-            root.style.colorScheme = normalizedTheme;
-        }
-        if (root.classList && !classMatchesTheme) {
-            if (shouldBeDark) {
-                root.classList.add("dark");
-            }
-            else {
-                root.classList.remove("dark");
-            }
-        }
-    }
-    // Apply the active theme's color set (must run even when only themeId changed)
-    const themeId = loadThemeId();
-    if (themeId && themeId !== "bsc-gold") {
-        const theme = resolveBuiltinTheme(themeId);
-        if (theme) {
-            applyThemeToDocument(theme, normalizedTheme);
-        }
-    }
-    else {
-        // BSC Gold is the base.css default — clear any overrides
-        clearThemeOverrides();
-    }
-}
-const UI_LANGUAGE_STORAGE_KEY = "eliza:ui-language";
-const UI_SHELL_MODE_STORAGE_KEY = "eliza:ui-shell-mode";
-const LAST_NATIVE_TAB_STORAGE_KEY = "eliza:last-native-tab";
-const ONBOARDING_STEP_STORAGE_KEY = "eliza:onboarding:step";
-function normalizeOnboardingStep(value) {
-    switch (value) {
-        case "deployment":
-        case "providers":
-        case "features":
-            return value;
-        case "identity":
-            // Identity/character selection was removed; restart at the setup step.
-            return "deployment";
-        case "permissions":
-        case "launch":
-            // permissions/launch removed — resume at providers
-            return "providers";
-        // Legacy step ID migration — map old persisted values to new equivalents
-        case "cloud_login":
-        case "welcome":
-            // cloud_login is now part of deployment step; resume at deployment
-            return "deployment";
-        case "hosting":
-        case "connection":
-            // hosting is now part of deployment step; resume at providers
-            return "providers";
-        case "cloudLogin":
-        case "rpc":
-            return "providers";
-        case "voice":
-        case "senses":
-            // voice/permissions removed from onboarding; resume at providers
-            return "providers";
-        case "activate":
-            return "providers";
-        default:
-            return null;
-    }
-}
-export function loadPersistedOnboardingStep() {
-    return tryLocalStorage(() => normalizeOnboardingStep(localStorage.getItem(ONBOARDING_STEP_STORAGE_KEY)), null);
-}
-export function saveOnboardingStep(step) {
-    tryLocalStorage(() => {
-        localStorage.setItem(ONBOARDING_STEP_STORAGE_KEY, step);
-    }, undefined);
-}
-export function clearPersistedOnboardingStep() {
-    tryLocalStorage(() => {
-        localStorage.removeItem(ONBOARDING_STEP_STORAGE_KEY);
-    }, undefined);
-}
-/* ── Onboarding completion persistence ────────────────────────────────── */
-const ONBOARDING_COMPLETE_STORAGE_KEY = "eliza:onboarding-complete";
-export function loadPersistedOnboardingComplete() {
-    if (typeof localStorage === "undefined") {
-        return false;
-    }
-    try {
-        return localStorage.getItem(ONBOARDING_COMPLETE_STORAGE_KEY) === "1";
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to load onboarding completion flag: ${describePersistenceError(err)}`);
-        return false;
-    }
-}
-export function savePersistedOnboardingComplete(complete) {
-    if (typeof localStorage === "undefined") {
-        return;
-    }
-    try {
-        if (complete) {
-            localStorage.setItem(ONBOARDING_COMPLETE_STORAGE_KEY, "1");
-        }
-        else {
-            localStorage.removeItem(ONBOARDING_COMPLETE_STORAGE_KEY);
-        }
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to save onboarding completion flag: ${describePersistenceError(err)}`);
-    }
-}
-/* ── Content pack persistence ───────────────────────────────────────── */
-const ACTIVE_PACK_STORAGE_KEY = "elizaos:active-pack-id";
-const ACTIVE_PACK_URL_STORAGE_KEY = "elizaos:active-pack-url";
-export function loadPersistedActivePackId() {
-    return tryLocalStorage(() => localStorage.getItem(ACTIVE_PACK_STORAGE_KEY), null);
-}
-export function savePersistedActivePackId(packId) {
-    tryLocalStorage(() => {
-        if (packId) {
-            localStorage.setItem(ACTIVE_PACK_STORAGE_KEY, packId);
-        }
-        else {
-            localStorage.removeItem(ACTIVE_PACK_STORAGE_KEY);
-        }
-    }, undefined);
-}
-export function loadPersistedActivePackUrl() {
-    return tryLocalStorage(() => localStorage.getItem(ACTIVE_PACK_URL_STORAGE_KEY), null);
-}
-export function savePersistedActivePackUrl(packUrl) {
-    tryLocalStorage(() => {
-        if (packUrl) {
-            localStorage.setItem(ACTIVE_PACK_URL_STORAGE_KEY, packUrl);
-        }
-        else {
-            localStorage.removeItem(ACTIVE_PACK_URL_STORAGE_KEY);
-        }
-    }, undefined);
-}
-export function loadUiLanguage() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(UI_LANGUAGE_STORAGE_KEY);
-        return normalizeLanguage(stored ?? DEFAULT_UI_LANGUAGE);
-    }, DEFAULT_UI_LANGUAGE);
-}
-export function saveUiLanguage(language) {
-    tryLocalStorage(() => {
-        localStorage.setItem(UI_LANGUAGE_STORAGE_KEY, normalizeLanguage(language));
-    }, undefined);
-}
-function normalizeUiShellMode(mode) {
-    return mode === "native" ? "native" : "companion";
-}
-export { normalizeUiShellMode };
-export function loadUiShellMode() {
-    return tryLocalStorage(() => normalizeUiShellMode(localStorage.getItem(UI_SHELL_MODE_STORAGE_KEY)), "companion");
-}
-export function saveUiShellMode(mode) {
-    tryLocalStorage(() => {
-        localStorage.setItem(UI_SHELL_MODE_STORAGE_KEY, normalizeUiShellMode(mode));
-    }, undefined);
-}
-function normalizeLastNativeTab(tab) {
-    switch (tab) {
-        case "advanced":
-            return "fine-tuning";
-        case "chat":
-        case "stream":
-        case "apps":
-        case "browser":
-        case "inventory":
-        case "documents":
-        case "connectors":
-        case "triggers":
-        case "plugins":
-        case "skills":
-        case "fine-tuning":
-        case "trajectories":
-        case "relationships":
-        case "voice":
-        case "runtime":
-        case "database":
-        case "desktop":
-        case "settings":
-        case "logs":
-            return tab;
-        default:
-            return "chat";
-    }
-}
-export function loadLastNativeTab() {
-    return tryLocalStorage(() => normalizeLastNativeTab(localStorage.getItem(LAST_NATIVE_TAB_STORAGE_KEY)), "chat");
-}
-export function saveLastNativeTab(tab) {
-    tryLocalStorage(() => {
-        localStorage.setItem(LAST_NATIVE_TAB_STORAGE_KEY, normalizeLastNativeTab(tab));
-    }, undefined);
-}
-/* ── Avatar persistence ───────────────────────────────────────────────── */
-const AVATAR_INDEX_KEY = "eliza_avatar_index";
-export function loadAvatarIndex() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(AVATAR_INDEX_KEY);
-        if (stored) {
-            const n = parseInt(stored, 10);
-            return normalizeAvatarIndex(n);
-        }
-        return 1;
-    }, 1);
-}
-export function saveAvatarIndex(index) {
-    tryLocalStorage(() => {
-        localStorage.setItem(AVATAR_INDEX_KEY, String(normalizeAvatarIndex(index)));
-    }, undefined);
-}
-export function clearAvatarIndex() {
-    tryLocalStorage(() => {
-        localStorage.removeItem(AVATAR_INDEX_KEY);
-    }, undefined);
-}
-/* ── Favorite apps persistence ────────────────────────────────────────── */
-const FAVORITE_APPS_KEY = "eliza:favorite-apps";
-function sanitizeFavoriteApps(value) {
-    if (!Array.isArray(value))
-        return [];
-    const seen = new Set();
-    const apps = [];
-    for (const item of value) {
-        if (typeof item !== "string" || item.length === 0 || seen.has(item)) {
-            continue;
-        }
-        seen.add(item);
-        apps.push(item);
-    }
-    return apps;
-}
-function getDefaultFavoriteApps() {
-    return sanitizeFavoriteApps(getBootConfig().defaultApps);
-}
-export function loadFavoriteApps() {
-    const defaultApps = getDefaultFavoriteApps();
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(FAVORITE_APPS_KEY);
-        if (stored === null)
-            return defaultApps;
-        try {
-            const parsed = JSON.parse(stored);
-            return sanitizeFavoriteApps(parsed);
-        }
-        catch (err) {
-            logger.warn(`[persistence] failed to parse favorite apps from localStorage: ${describePersistenceError(err)}`);
-            return defaultApps;
-        }
-    }, defaultApps);
-}
-export function saveFavoriteApps(apps) {
-    tryLocalStorage(() => {
-        localStorage.setItem(FAVORITE_APPS_KEY, JSON.stringify(sanitizeFavoriteApps(apps)));
-    }, undefined);
-}
-/**
- * Hydrate the favorites list from the server-side persisted store
- * (config.ui.favoriteApps), falling back to the local cache on failure.
- * Mirrors the result back into localStorage so the next boot is fast.
- */
-export async function fetchServerFavoriteApps() {
-    try {
-        const resp = await fetchWithCsrf("/api/apps/favorites", {
-            method: "GET",
-            headers: { Accept: "application/json" },
-        });
-        if (!resp.ok)
-            return null;
-        const data = (await resp.json());
-        const sanitized = sanitizeFavoriteApps(data.favoriteApps);
-        saveFavoriteApps(sanitized);
-        return sanitized;
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to fetch server favorite apps: ${describePersistenceError(err)}`);
-        return null;
-    }
-}
-/**
- * Replace the server-persisted favorites list. Used when the UI commits
- * a bulk reorder/edit. Best-effort: returns null on failure.
- */
-export async function replaceServerFavoriteApps(favoriteAppNames) {
-    try {
-        const resp = await fetchWithCsrf("/api/apps/favorites/replace", {
-            method: "POST",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ favoriteAppNames }),
-        });
-        if (!resp.ok)
-            return null;
-        const data = (await resp.json());
-        const sanitized = sanitizeFavoriteApps(data.favoriteApps);
-        saveFavoriteApps(sanitized);
-        return sanitized;
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to replace server favorite apps: ${describePersistenceError(err)}`);
-        return null;
-    }
-}
-/**
- * Toggle a single app's favorite state on the server. Returns the updated
- * list, or `null` if the request failed (caller should keep optimistic UI
- * state). Local cache is updated on success.
- */
-export async function toggleServerFavoriteApp(appName, isFavorite) {
-    try {
-        const resp = await fetchWithCsrf("/api/apps/favorites", {
-            method: "PUT",
-            headers: { "Content-Type": "application/json" },
-            body: JSON.stringify({ appName, isFavorite }),
-        });
-        if (!resp.ok)
-            return null;
-        const data = (await resp.json());
-        const sanitized = sanitizeFavoriteApps(data.favoriteApps);
-        saveFavoriteApps(sanitized);
-        return sanitized;
-    }
-    catch (err) {
-        logger.warn(`[persistence] failed to toggle server favorite app: ${describePersistenceError(err)}`);
-        return null;
-    }
-}
-/* ── Recent apps persistence ──────────────────────────────────────────── */
-const RECENT_APPS_KEY = "eliza:recent-apps";
-/** Cap on persisted recency list. Older entries are evicted. */
-export const RECENT_APPS_MAX = 10;
-export function loadRecentApps() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(RECENT_APPS_KEY);
-        if (!stored)
-            return [];
-        try {
-            const parsed = JSON.parse(stored);
-            if (!Array.isArray(parsed))
-                return [];
-            return parsed
-                .filter((item) => typeof item === "string")
-                .slice(0, RECENT_APPS_MAX);
-        }
-        catch (err) {
-            logger.warn(`[persistence] failed to parse recent apps from localStorage: ${describePersistenceError(err)}`);
-            return [];
-        }
-    }, []);
-}
-export function saveRecentApps(apps) {
-    tryLocalStorage(() => {
-        localStorage.setItem(RECENT_APPS_KEY, JSON.stringify(apps.slice(0, RECENT_APPS_MAX)));
-    }, undefined);
-}
-/* ── Wallet enabled persistence ─────────────────────────────────────── */
-const WALLET_ENABLED_KEY = "eliza:wallet:enabled";
-export function loadWalletEnabled() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(WALLET_ENABLED_KEY);
-        return stored === null ? true : stored === "true";
-    }, true);
-}
-export function saveWalletEnabled(value) {
-    tryLocalStorage(() => {
-        localStorage.setItem(WALLET_ENABLED_KEY, String(value));
-    }, undefined);
-}
-/* ── Browser enabled persistence ────────────────────────────────────── */
-const BROWSER_ENABLED_KEY = "eliza:browser:enabled";
-export function loadBrowserEnabled() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(BROWSER_ENABLED_KEY);
-        return stored === null ? true : stored === "true";
-    }, true);
-}
-export function saveBrowserEnabled(value) {
-    tryLocalStorage(() => {
-        localStorage.setItem(BROWSER_ENABLED_KEY, String(value));
-    }, undefined);
-}
-/* ── Computer Use enabled persistence ───────────────────────────────── */
-const COMPUTER_USE_ENABLED_KEY = "eliza:computeruse:enabled";
-export function loadComputerUseEnabled() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(COMPUTER_USE_ENABLED_KEY);
-        return stored === null ? false : stored === "true";
-    }, false);
-}
-export function saveComputerUseEnabled(value) {
-    tryLocalStorage(() => {
-        localStorage.setItem(COMPUTER_USE_ENABLED_KEY, String(value));
-    }, undefined);
-}
-/* ── Chat UI persistence ──────────────────────────────────────────────── */
-const CHAT_AVATAR_VISIBLE_KEY = "eliza:chat:avatarVisible";
-const CHAT_VOICE_MUTED_KEY = "eliza:chat:voiceMuted";
-export function loadChatAvatarVisible() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(CHAT_AVATAR_VISIBLE_KEY);
-        return stored === null ? true : stored === "true";
-    }, true);
-}
-export function loadChatVoiceMuted() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(CHAT_VOICE_MUTED_KEY);
-        return stored === null ? false : stored === "true";
-    }, false);
-}
-export function saveChatAvatarVisible(value) {
-    tryLocalStorage(() => {
-        localStorage.setItem(CHAT_AVATAR_VISIBLE_KEY, String(value));
-    }, undefined);
-}
-export function saveChatVoiceMuted(value) {
-    tryLocalStorage(() => {
-        localStorage.setItem(CHAT_VOICE_MUTED_KEY, String(value));
-    }, undefined);
-}
-/* ── Chat mode persistence ─────────────────────────────────────────────── */
-const CHAT_MODE_KEY = "eliza:chat:mode";
-const ACTIVE_CONVERSATION_ID_KEY = "eliza:chat:activeConversationId";
-const COMPANION_MESSAGE_CUTOFF_TS_KEY = "eliza:chat:companionMessageCutoffTs";
-export function loadChatMode() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(CHAT_MODE_KEY);
-        return stored === "power" ? "power" : "simple";
-    }, "simple");
-}
-export function saveChatMode(value) {
-    tryLocalStorage(() => {
-        localStorage.setItem(CHAT_MODE_KEY, value);
-    }, undefined);
-}
-export function loadActiveConversationId() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(ACTIVE_CONVERSATION_ID_KEY)?.trim();
-        return stored ? stored : null;
-    }, null);
-}
-export function saveActiveConversationId(value) {
-    tryLocalStorage(() => {
-        if (value?.trim()) {
-            localStorage.setItem(ACTIVE_CONVERSATION_ID_KEY, value);
-            return;
-        }
-        localStorage.removeItem(ACTIVE_CONVERSATION_ID_KEY);
-    }, undefined);
-}
-export function loadCompanionMessageCutoffTs() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(COMPANION_MESSAGE_CUTOFF_TS_KEY);
-        const parsed = stored ? Number.parseInt(stored, 10) : Number.NaN;
-        return Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
-    }, 0);
-}
-export function saveCompanionMessageCutoffTs(value) {
-    tryLocalStorage(() => {
-        localStorage.setItem(COMPANION_MESSAGE_CUTOFF_TS_KEY, String(Math.max(0, Math.trunc(value))));
-    }, undefined);
-}
-const ACTIVE_SERVER_STORAGE_KEY = "elizaos:active-server";
-const ELIZA_CLOUD_CONTROL_PLANE_HOSTS = new Set([
-    "api.elizacloud.ai",
-    "elizacloud.ai",
-    "www.elizacloud.ai",
-    "dev.elizacloud.ai",
-]);
-function trimPersistedValue(value) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    return trimmed ? trimmed : undefined;
-}
-function normalizeApiBase(value) {
-    const trimmed = trimPersistedValue(value);
-    if (!trimmed)
-        return trimmed;
-    let end = trimmed.length;
-    while (end > 0 && trimmed.charCodeAt(end - 1) === 47)
-        end--;
-    return trimmed.slice(0, end);
-}
-function isElizaCloudControlPlaneApiBase(value) {
-    const apiBase = normalizeApiBase(value);
-    if (!apiBase)
-        return false;
-    try {
-        return ELIZA_CLOUD_CONTROL_PLANE_HOSTS.has(new URL(apiBase).hostname.toLowerCase());
-    }
-    catch (err) {
-        logger.debug(`[persistence] failed to parse apiBase URL while checking Eliza Cloud control plane: apiBase=${apiBase}; error=${describePersistenceError(err)}`);
-        return false;
-    }
-}
-export function createPersistedActiveServer(args) {
-    const normalizedApiBase = normalizeApiBase(args.apiBase);
-    const apiBase = isElizaCloudControlPlaneApiBase(normalizedApiBase)
-        ? undefined
-        : normalizedApiBase;
-    const accessToken = trimPersistedValue(args.accessToken);
-    const explicitLabel = trimPersistedValue(args.label);
-    switch (args.kind) {
-        case "local":
-            return {
-                id: "local:embedded",
-                kind: "local",
-                label: explicitLabel ?? "This device",
-            };
-        case "cloud":
-            return {
-                id: `cloud:${apiBase ?? "managed"}`,
-                kind: "cloud",
-                label: explicitLabel ?? "Eliza Cloud",
-                ...(apiBase ? { apiBase } : {}),
-                ...(accessToken ? { accessToken } : {}),
-            };
-        case "remote": {
-            let label = explicitLabel ?? "Remote server";
-            if (!explicitLabel && apiBase) {
-                try {
-                    label = new URL(apiBase).host || label;
-                }
-                catch (err) {
-                    logger.debug(`[persistence] failed to parse apiBase URL for remote server label; using raw apiBase: apiBase=${apiBase}; error=${describePersistenceError(err)}`);
-                    label = apiBase;
-                }
-            }
-            return {
-                id: `remote:${apiBase ?? "manual"}`,
-                kind: "remote",
-                label,
-                ...(apiBase ? { apiBase } : {}),
-                ...(accessToken ? { accessToken } : {}),
-            };
-        }
-    }
-}
-function normalizePersistedActiveServer(value) {
-    const record = asRecord(value);
-    if (!record) {
-        return null;
-    }
-    const kind = record.kind === "local" ||
-        record.kind === "cloud" ||
-        record.kind === "remote"
-        ? record.kind
-        : null;
-    const id = trimPersistedValue(record.id);
-    const label = trimPersistedValue(record.label);
-    if (!kind || !id || !label) {
-        return null;
-    }
-    const normalizedApiBase = normalizeApiBase(record.apiBase);
-    const apiBase = isElizaCloudControlPlaneApiBase(normalizedApiBase)
-        ? undefined
-        : normalizedApiBase;
-    const accessToken = trimPersistedValue(record.accessToken);
-    return {
-        id,
-        kind,
-        label,
-        ...(apiBase ? { apiBase } : {}),
-        ...(accessToken ? { accessToken } : {}),
-    };
-}
-export function loadPersistedActiveServer() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(ACTIVE_SERVER_STORAGE_KEY);
-        if (!stored) {
-            return null;
-        }
-        return normalizePersistedActiveServer(JSON.parse(stored));
-    }, null);
-}
-export function savePersistedActiveServer(server) {
-    tryLocalStorage(() => {
-        localStorage.setItem(ACTIVE_SERVER_STORAGE_KEY, JSON.stringify(server));
-    }, undefined);
-}
-export function clearPersistedActiveServer() {
-    tryLocalStorage(() => {
-        localStorage.removeItem(ACTIVE_SERVER_STORAGE_KEY);
-    }, undefined);
-}