@elizaos/agent 2.0.0-alpha.520 → 2.0.0-alpha.521

package/packages/app-core/src/state/AppContext.js

@@ -1,1896 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * Global application state via React Context.
- *
- * Children access state and actions through the useApp() hook.
- */
-import { ConfirmDialog, PromptDialog, useConfirm, usePrompt, } from "@elizaos/ui";
-import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
-import { client } from "../api";
-import { AppBootContext } from "../config/boot-config-react";
-import { getBootConfig } from "../config/boot-config-store";
-import { BrandingContext, DEFAULT_BRANDING } from "../config/branding";
-import { canonicalPathForPath, getWindowNavigationPath, isRouteRootPath, resolveInitialTabForPath, shouldUseHashNavigation, tabFromPath, } from "../navigation";
-import { copyTextToClipboard } from "../utils";
-import { getActiveProfile, loadAgentProfileRegistry, setActiveProfileId, } from "./agent-profiles";
-import { ChatComposerCtx, ChatInputRefCtx } from "./ChatComposerContext";
-import { CompanionSceneConfigCtx } from "./CompanionSceneConfigContext";
-import { AppContext } from "./internal";
-import { PtySessionsCtx } from "./PtySessionsContext";
-import { createPersistedActiveServer, fetchServerFavoriteApps, loadFavoriteApps, loadRecentApps, replaceServerFavoriteApps, saveFavoriteApps, savePersistedActiveServer, saveRecentApps, } from "./persistence";
-import { deriveUiShellModeForTab } from "./shell-routing";
-import { TranslationProvider, useTranslation } from "./TranslationContext";
-import { useCharacterState } from "./useCharacterState";
-import { useChatCallbacks } from "./useChatCallbacks";
-import { useChatState } from "./useChatState";
-import { useCloudState } from "./useCloudState";
-import { useDataLoaders } from "./useDataLoaders";
-import { useDisplayPreferences } from "./useDisplayPreferences";
-import { useExportImportState } from "./useExportImportState";
-import { useLifecycleState } from "./useLifecycleState";
-import { useLogsState } from "./useLogsState";
-import { useMiscUiState } from "./useMiscUiState";
-import { useNavigationState } from "./useNavigationState";
-import { useOnboardingCallbacks } from "./useOnboardingCallbacks";
-import { useOnboardingCompat } from "./useOnboardingCompat";
-import { useOnboardingState } from "./useOnboardingState";
-import { usePairingState } from "./usePairingState";
-import { usePluginsSkillsState } from "./usePluginsSkillsState";
-import { useStartupCoordinator } from "./useStartupCoordinator";
-import { useTriggersState } from "./useTriggersState";
-import { useVincentState } from "./useVincentState";
-import { useWalletState } from "./useWalletState";
-export { AGENT_STATES, AGENT_TRANSFER_MIN_PASSWORD_LENGTH, AppContext, applyUiTheme, asApiLikeError, computeStreamingDelta, formatSearchBullet, formatStartupErrorDetail, getCompanionBackgroundUrl, getVrmBackgroundUrl, getVrmPreviewUrl, getVrmTitle, getVrmUrl, LIFECYCLE_MESSAGES, loadAvatarIndex, loadChatAvatarVisible, loadChatMode, loadChatVoiceMuted, loadCompanionAnimateWhenHidden, loadCompanionHalfFramerateMode, loadCompanionVrmPowerMode, loadUiLanguage, loadUiShellMode, loadUiTheme, mergeStreamingText, normalizeAvatarIndex, normalizeCompanionHalfFramerateMode, normalizeCompanionVrmPowerMode, normalizeCustomActionName, normalizeStreamComparisonText, normalizeUiShellMode, normalizeUiTheme, ONBOARDING_PERMISSION_LABELS, parseAgentStartupDiagnostics, parseAgentStatusEvent, parseAgentStatusFromMainMenuResetPayload, parseConversationMessageEvent, parseCustomActionParams, parseProactiveMessageEvent, parseSlashCommandInput, parseStreamEventEnvelopeEvent, saveAvatarIndex, saveChatAvatarVisible, saveChatMode, saveChatVoiceMuted, saveCompanionAnimateWhenHidden, saveCompanionHalfFramerateMode, saveCompanionVrmPowerMode, saveUiLanguage, saveUiShellMode, saveUiTheme, shouldApplyFinalStreamText, useApp, VRM_COUNT, } from "./internal";
-export { AGENT_READY_TIMEOUT_MS } from "./types";
-/** RuntimeGate and bare `completeOnboarding()` land on chat; the wizard opens the companion overlay separately. */
-const DEFAULT_LANDING_TAB = "chat";
-function traceGreeting(phase, detail) {
-    try {
-        if (typeof localStorage !== "undefined" &&
-            localStorage.getItem("elizaos:debug:greeting") === "1") {
-            console.info(`[eliza][greeting] ${phase}`, detail ?? "");
-        }
-    }
-    catch {
-        /* noop */
-    }
-}
-// ── Provider ───────────────────────────────────────────────────────────
-export function AppProvider({ children, branding: brandingOverride, }) {
-    const onLanguageSyncError = useCallback((lang) => {
-        // Notification is deferred until AppProviderInner mounts; this is
-        // only called on language *changes*, never on initial mount.
-        console.warn("[eliza] Failed to sync language to server:", lang);
-    }, []);
-    return (_jsx(TranslationProvider, { onLanguageSyncError: onLanguageSyncError, children: _jsx(AppProviderInner, { branding: brandingOverride, children: children }) }));
-}
-function AppProviderInner({ children, branding: brandingOverride, }) {
-    // --- Core state ---
-    const [tab, _setTabRawInner] = useState(() => resolveInitialTabForPath(getWindowNavigationPath(), DEFAULT_LANDING_TAB));
-    const initialTabSetRef = useRef(false);
-    const setTabRaw = useCallback((t) => {
-        _setTabRawInner(t);
-    }, []);
-    // uiLanguage + t live in TranslationContext; consumed via useTranslation()
-    const { t, uiLanguage, setUiLanguage } = useTranslation();
-    // --- Display preferences (extracted to useDisplayPreferences) ---
-    const displayPrefs = useDisplayPreferences();
-    const { state: { uiTheme, themeId, companionVrmPowerMode, companionAnimateWhenHidden, companionHalfFramerateMode, }, setUiTheme, setThemeId, setCompanionVrmPowerMode, setCompanionAnimateWhenHidden, setCompanionHalfFramerateMode, } = displayPrefs;
-    // ── Lifecycle state (consolidated from 20+ useState hooks) ──
-    const lifecycle = useLifecycleState();
-    const { state: { connected, agentStatus, onboardingComplete, onboardingUiRevealNonce, onboardingLoading, startupPhase, startupError, authRequired, actionNotice, lifecycleBusy, lifecycleAction, pendingRestart, pendingRestartReasons, restartBannerDismissed, backendConnection, backendDisconnectedBannerDismissed, systemWarnings, }, setConnected, setAgentStatus, setAgentStatusIfChanged, setOnboardingComplete, incrementOnboardingRevealNonce: setOnboardingUiRevealNonce_increment, setOnboardingLoading, setStartupPhase, setStartupError, setAuthRequired, setActionNotice, beginLifecycleAction, finishLifecycleAction, setPendingRestart: setPendingRestartAction, dismissRestartBanner, showRestartBanner, setBackendConnection, dismissBackendBanner: dismissBackendDisconnectedBanner, resetBackendConnection, dismissSystemWarning, startupStatus, lifecycleBusyRef, lifecycleActionRef, } = lifecycle;
-    // Compatibility wrappers — old code calls these separately; lifecycle hook combines them.
-    const setPendingRestart = useCallback((v) => {
-        const resolved = typeof v === "function" ? v(lifecycle.state.pendingRestart) : v;
-        setPendingRestartAction(resolved);
-    }, [lifecycle.state.pendingRestart, setPendingRestartAction]);
-    const setPendingRestartReasons = useCallback((v) => {
-        const resolved = typeof v === "function" ? v(lifecycle.state.pendingRestartReasons) : v;
-        setPendingRestartAction(lifecycle.state.pendingRestart, resolved);
-    }, [
-        lifecycle.state.pendingRestart,
-        lifecycle.state.pendingRestartReasons,
-        setPendingRestartAction,
-    ]);
-    const setOnboardingUiRevealNonce = useCallback((_fn) => setOnboardingUiRevealNonce_increment(), [setOnboardingUiRevealNonce_increment]);
-    const setBackendDisconnectedBannerDismissed = useCallback((v) => {
-        if (v)
-            dismissBackendDisconnectedBanner();
-        // Note: only dismissal is supported via the reducer
-    }, [dismissBackendDisconnectedBanner]);
-    const setSystemWarnings = useCallback((v) => {
-        const resolved = typeof v === "function" ? v(lifecycle.state.systemWarnings) : v;
-        lifecycle.setSystemWarnings(resolved);
-    }, [lifecycle.state.systemWarnings, lifecycle.setSystemWarnings]);
-    const triggerRestartRef = useRef(async () => { });
-    const triggerRestartProxy = useCallback(async () => {
-        await triggerRestartRef.current();
-    }, []);
-    // retryStartup resets lifecycle state AND dispatches RETRY to the coordinator.
-    // The coordinator's phase effects will re-run from restoring-session.
-    // We store a ref to the coordinator's retry since it's created after this line.
-    const coordinatorRetryRef = useRef(null);
-    const coordinatorResetRef = useRef(null);
-    const coordinatorOnboardingCompleteRef = useRef(null);
-    const retryStartup = useCallback(() => {
-        lifecycle.retryStartup();
-        coordinatorRetryRef.current?.();
-    }, [lifecycle.retryStartup]);
-    const _resetToSplash = useCallback(() => {
-        lifecycle.retryStartup();
-        coordinatorResetRef.current?.();
-    }, [lifecycle.retryStartup]);
-    const uiShellMode = deriveUiShellModeForTab(tab);
-    // --- Pairing ---
-    // --- Pairing (extracted to usePairingState) ---
-    const pairingHook = usePairingState();
-    const { state: { pairingEnabled, pairingExpiresAt, pairingCodeInput, pairingError, pairingBusy, }, setPairingEnabled, setPairingExpiresAt, setPairingCodeInput, handlePairingSubmit, } = pairingHook;
-    // NOTE: StartupCoordinator hook moved below (after all dependency hooks).
-    // Search for "── StartupCoordinator (sole startup authority) ──" below.
-    // ── Chat state (consolidated from 18+ useState + 10 useEffect hooks) ──
-    const chatState = useChatState();
-    const { state: { chatInput, chatSending, chatFirstTokenReceived, chatLastUsage, chatAvatarVisible, chatAgentVoiceMuted, chatMode, chatAvatarSpeaking, conversations, activeConversationId, companionMessageCutoffTs, conversationMessages, autonomousEvents, autonomousLatestEventId, autonomousRunHealthByRunId, ptySessions, unreadConversations, chatPendingImages, }, setChatInput, setChatSending, setChatFirstTokenReceived, setChatLastUsage, setChatAvatarVisible, setChatAgentVoiceMuted, setChatMode, setChatAvatarSpeaking, setConversations, setActiveConversationId, setCompanionMessageCutoffTs, setConversationMessages, setAutonomousEvents, setAutonomousLatestEventId, setAutonomousRunHealthByRunId, setPtySessions, setChatPendingImages, resetDraftState: resetConversationDraftState, activeConversationIdRef, chatInputRef, chatPendingImagesRef, conversationMessagesRef, conversationHydrationEpochRef, chatAbortRef, chatSendBusyRef, chatSendNonceRef, greetingFiredRef, greetingInFlightConversationRef, companionStaleConversationRefreshRef, autonomousStoreRef, autonomousEventsRef, autonomousLatestEventIdRef, autonomousRunHealthByRunIdRef, autonomousReplayInFlightRef, addUnread, } = chatState;
-    const _chatComposerTextareaRef = useRef(null);
-    // addUnread / removeUnread wrappers for old setUnreadConversations patterns.
-    // Read current unreadConversations through a ref so this callback stays
-    // stable across renders — otherwise it cascades into handleChatClear /
-    // handleSelectConversation / handleDeleteConversation and busts the
-    // AppContext value memo on every keystroke.
-    const unreadConversationsRef = useRef(unreadConversations);
-    unreadConversationsRef.current = unreadConversations;
-    const setUnreadConversations = useCallback((v) => {
-        if (typeof v === "function") {
-            const nextVal = v(unreadConversationsRef.current);
-            // Sync back through dispatch
-            for (const id of nextVal)
-                addUnread(id);
-        }
-        else {
-            // Direct set not supported through reducer — use add/remove
-        }
-    }, [addUnread]);
-    // --- Triggers (extracted to useTriggersState) ---
-    const triggersHook = useTriggersState();
-    const { state: { triggers, triggersLoaded, triggersLoading, triggersSaving, triggerRunsById, triggerHealth, triggerError, }, loadTriggers, loadTriggerHealth, loadTriggerRuns, ensureTriggersLoaded, createTrigger, updateTrigger, deleteTrigger, runTriggerNow, } = triggersHook;
-    // --- Plugins / Skills / Store / Catalog (extracted to usePluginsSkillsState) ---
-    const pluginsSkillsHook = usePluginsSkillsState({
-        setActionNotice,
-        setPendingRestart,
-        setPendingRestartReasons,
-        showRestartBanner,
-        triggerRestart: triggerRestartProxy,
-    });
-    const { plugins, setPlugins, pluginFilter, setPluginFilter, pluginStatusFilter, setPluginStatusFilter, pluginSearch, setPluginSearch, pluginSettingsOpen, setPluginSettingsOpen, pluginAdvancedOpen, setPluginAdvancedOpen, pluginSaving, pluginSaveSuccess, loadPlugins, ensurePluginsLoaded, handlePluginToggle, handlePluginConfigSave, skills, setSkills, skillsSubTab, setSkillsSubTab, skillCreateFormOpen, setSkillCreateFormOpen, skillCreateName, setSkillCreateName, skillCreateDescription, setSkillCreateDescription, skillCreating, skillReviewReport, setSkillReviewReport, skillReviewId, setSkillReviewId, skillReviewLoading, skillToggleAction, skillsMarketplaceQuery, setSkillsMarketplaceQuery, skillsMarketplaceResults, skillsMarketplaceError, skillsMarketplaceLoading, skillsMarketplaceAction, skillsMarketplaceManualGithubUrl, setSkillsMarketplaceManualGithubUrl, loadSkills, refreshSkills, handleSkillToggle, handleCreateSkill, handleOpenSkill, handleDeleteSkill, handleReviewSkill, handleAcknowledgeSkill, searchSkillsMarketplace, installSkillFromMarketplace, installSkillFromGithubUrl, uninstallMarketplaceSkill, enableMarketplaceSkill, disableMarketplaceSkill, copyMarketplaceSkillSource, storePlugins, setStorePlugins, storeSearch, setStoreSearch, storeFilter, setStoreFilter, storeLoading, setStoreLoading, storeInstalling, setStoreInstalling, storeUninstalling, setStoreUninstalling, storeError, setStoreError, storeDetailPlugin, setStoreDetailPlugin, storeSubTab, setStoreSubTab, catalogSkills, setCatalogSkills, catalogTotal, setCatalogTotal, catalogPage, setCatalogPage, catalogTotalPages, setCatalogTotalPages, catalogSort, setCatalogSort, catalogSearch, setCatalogSearch, catalogLoading, setCatalogLoading, catalogError, setCatalogError, catalogDetailSkill, setCatalogDetailSkill, catalogInstalling, setCatalogInstalling, catalogUninstalling, setCatalogUninstalling, } = pluginsSkillsHook;
-    // --- Logs (extracted to useLogsState) ---
-    const logsHook = useLogsState();
-    const { state: { logs, logSources, logTags, logTagFilter, logLevelFilter, logSourceFilter, logLoadError, }, setLogs, setLogTagFilter, setLogLevelFilter, setLogSourceFilter, loadLogs, } = logsHook;
-    // --- Character (extracted to useCharacterState) ---
-    const characterHook = useCharacterState({ agentStatus, setAgentStatus });
-    const { state: { characterData, characterLoading, characterSaving, characterSaveSuccess, characterSaveError, characterDraft, selectedVrmIndex, customVrmUrl, customVrmPreviewUrl, customBackgroundUrl, customCatchphrase, customVoicePresetId, activePackId, customWorldUrl, }, setSelectedVrmIndex, setCustomVrmUrl, setCustomVrmPreviewUrl, setCustomBackgroundUrl, setCustomCatchphrase, setCustomVoicePresetId, setActivePackId, setCustomWorldUrl, loadCharacter, handleSaveCharacter, handleCharacterFieldInput, handleCharacterArrayInput, handleCharacterStyleInput, handleCharacterMessageExamplesInput, } = characterHook;
-    // elizaCloud* state, refs, and callbacks are now provided by useCloudState (cloudHook above).
-    const [ownerName, setOwnerNameState] = useState(null);
-    const [_ownerNameHydrated, _setOwnerNameHydrated] = useState(false);
-    const [_pendingOwnerNamePrompt, _setPendingOwnerNamePrompt] = useState(false);
-    const [_showOwnerNamePrompt, _setShowOwnerNamePrompt] = useState(false);
-    // Updates, Extension, and Workbench state are now in useDataLoaders (dataLoaders).
-    // --- Agent export/import (extracted to useExportImportState) ---
-    const exportImportHook = useExportImportState();
-    const { state: { exportBusy, exportPassword, exportIncludeLogs, exportError, exportSuccess, importBusy, importPassword, importFile, importError, importSuccess, }, setExportPassword, setExportIncludeLogs, setExportError, setExportSuccess, setImportPassword, setImportFile, setImportError, setImportSuccess, handleAgentExport, handleAgentImport, } = exportImportHook;
-    // ── Onboarding state (consolidated from 35+ useState hooks) ──
-    const onboarding = useOnboardingState(brandingOverride?.cloudOnly);
-    const { state: { step: onboardingStep, mode: onboardingMode, activeGuide: onboardingActiveGuide, deferredTasks: onboardingDeferredTasks, postChecklistDismissed: postOnboardingChecklistDismissed, options: onboardingOptions, name: onboardingName, ownerName: onboardingOwnerName, style: onboardingStyle, avatar: onboardingAvatar, serverTarget: onboardingServerTarget, cloudApiKey: onboardingCloudApiKey, provider: onboardingProvider, apiKey: onboardingApiKey, voiceProvider: onboardingVoiceProvider, voiceApiKey: onboardingVoiceApiKey, smallModel: onboardingSmallModel, largeModel: onboardingLargeModel, openRouterModel: onboardingOpenRouterModel, primaryModel: onboardingPrimaryModel, existingInstallDetected: onboardingExistingInstallDetected, detectedProviders: onboardingDetectedProviders, remoteApiBase: onboardingRemoteApiBase, remoteToken: onboardingRemoteToken, subscriptionTab: onboardingSubscriptionTab, elizaCloudTab: onboardingElizaCloudTab, selectedChains: onboardingSelectedChains, rpcSelections: onboardingRpcSelections, rpcKeys: onboardingRpcKeys, featureTelegram: onboardingFeatureTelegram, featureDiscord: onboardingFeatureDiscord, featurePhone: onboardingFeaturePhone, featureCrypto: onboardingFeatureCrypto, featureBrowser: onboardingFeatureBrowser, featureComputerUse: onboardingFeatureComputerUse, featureOAuthPending: onboardingFeatureOAuthPending, }, setStep: setOnboardingStep, setMode: setOnboardingMode, setActiveGuide: setOnboardingActiveGuide, addDeferredTask: addDeferredOnboardingTask, setOptions: setOnboardingOptions, setDetectedProviders: setOnboardingDetectedProviders, completionCommittedRef: onboardingCompletionCommittedRefFromHook, forceLocalBootstrapRef: forceLocalBootstrapRefFromHook, } = onboarding;
-    const { onboardingRemoteConnecting, onboardingRemoteError, onboardingRemoteConnected, onboardingTelegramToken, onboardingDiscordToken, onboardingWhatsAppSessionPath, onboardingTwilioAccountSid, onboardingTwilioAuthToken, onboardingTwilioPhoneNumber, onboardingBlooioApiKey, onboardingBlooioPhoneNumber, onboardingGithubToken, setOnboardingName, setOnboardingOwnerName, setOnboardingStyle, setOnboardingServerTarget, setOnboardingCloudApiKey, setOnboardingSmallModel, setOnboardingLargeModel, setOnboardingProvider, setOnboardingApiKey, setOnboardingVoiceProvider, setOnboardingVoiceApiKey, setOnboardingExistingInstallDetected, setOnboardingRemoteApiBase, setOnboardingRemoteToken, setOnboardingRemoteConnecting, setOnboardingRemoteError, setOnboardingRemoteConnected, setOnboardingOpenRouterModel, setOnboardingPrimaryModel, setOnboardingTelegramToken, setOnboardingDiscordToken, setOnboardingWhatsAppSessionPath, setOnboardingTwilioAccountSid, setOnboardingTwilioAuthToken, setOnboardingTwilioPhoneNumber, setOnboardingBlooioApiKey, setOnboardingBlooioPhoneNumber, setOnboardingGithubToken, setOnboardingSubscriptionTab, setOnboardingElizaCloudTab, setOnboardingSelectedChains, setOnboardingRpcSelections, setOnboardingRpcKeys, setOnboardingAvatar, setOnboardingFeatureTelegram, setOnboardingFeatureDiscord, setOnboardingFeaturePhone, setOnboardingFeatureCrypto, setOnboardingFeatureBrowser, setOnboardingFeatureComputerUse, setOnboardingFeatureOAuthPending, setOnboardingCloudProvisionedContainer, setPostOnboardingChecklistDismissed, setOnboardingDeferredTasks, } = useOnboardingCompat(onboarding);
-    // startupStatus is now derived in useLifecycleState
-    // --- Command palette / emote picker / MCP / game / dropped files (extracted to useMiscUiState) ---
-    const miscUiHook = useMiscUiState();
-    const { state: { commandPaletteOpen, commandQuery, commandActiveIndex, emotePickerOpen, mcpConfiguredServers, mcpServerStatuses, mcpMarketplaceQuery, mcpMarketplaceResults, mcpMarketplaceLoading, mcpAction, mcpAddingServer, mcpAddingResult, mcpEnvInputs, mcpHeaderInputs, droppedFiles, shareIngestNotice, appRuns, activeGameRunId, activeGameApp, activeGameDisplayName, activeGameViewerUrl, activeGameSandbox, activeGamePostMessageAuth, activeGamePostMessagePayload, activeGameSession, gameOverlayEnabled, companionAppRunning, activeOverlayApp, activeInboxChat, activeTerminalSessionId, }, setActiveInboxChat, setActiveTerminalSessionId, setCommandQuery, setCommandActiveIndex, setEmotePickerOpen, setMcpConfiguredServers, setMcpServerStatuses, setMcpMarketplaceQuery, setMcpMarketplaceResults, setMcpMarketplaceLoading, setMcpAction, setMcpAddingServer, setMcpAddingResult, setMcpEnvInputs, setMcpHeaderInputs, setDroppedFiles, setShareIngestNotice, setAppRuns, setActiveGameRunId, setGameOverlayEnabled, setActiveOverlayApp, closeCommandPalette, openEmotePicker, closeEmotePicker, } = miscUiHook;
-    // chatPendingImages now comes from useChatState
-    // --- Admin ---
-    const [appsSubTab, setAppsSubTabRaw] = useState(() => {
-        try {
-            const stored = sessionStorage.getItem("eliza:appsSubTab");
-            if (stored === "browse" || stored === "running" || stored === "games")
-                return stored;
-        }
-        catch {
-            /* ignore */
-        }
-        return "browse";
-    });
-    const setAppsSubTab = useCallback((v) => {
-        setAppsSubTabRaw(v);
-        try {
-            sessionStorage.setItem("eliza:appsSubTab", v);
-        }
-        catch {
-            /* ignore */
-        }
-    }, []);
-    const [agentSubTab, setAgentSubTab] = useState("character");
-    const [pluginsSubTab, setPluginsSubTab] = useState("features");
-    const [databaseSubTab, setDatabaseSubTab] = useState("tables");
-    // --- Favorite apps ---
-    const [favoriteApps, setFavoriteAppsRaw] = useState(() => loadFavoriteApps());
-    const setFavoriteApps = useCallback((apps) => {
-        setFavoriteAppsRaw(apps);
-        saveFavoriteApps(apps);
-        // Mirror the change to the server so the agent's FAVORITE_APP action
-        // and the dashboard share a single source of truth. Fire-and-forget;
-        // failures keep the local cache as the optimistic source.
-        void replaceServerFavoriteApps(apps);
-    }, []);
-    // Hydrate favorites from the server on mount. The local cache primes the
-    // first paint; the server response is authoritative if it differs.
-    useEffect(() => {
-        let cancelled = false;
-        void fetchServerFavoriteApps().then((serverApps) => {
-            if (cancelled || serverApps == null)
-                return;
-            setFavoriteAppsRaw((current) => {
-                if (current.length === serverApps.length &&
-                    current.every((entry, idx) => entry === serverApps[idx])) {
-                    return current;
-                }
-                return serverApps;
-            });
-        });
-        return () => {
-            cancelled = true;
-        };
-    }, []);
-    // --- Recently launched apps ---
-    const [recentApps, setRecentAppsRaw] = useState(() => loadRecentApps());
-    const setRecentApps = useCallback((apps) => {
-        setRecentAppsRaw(apps);
-        saveRecentApps(apps);
-    }, []);
-    // --- Config ---
-    const [configRaw, setConfigRaw] = useState({});
-    const [configText, setConfigText] = useState("");
-    // --- Refs for timers ---
-    // actionNoticeTimer, shownOnceNotices, agentStatusRef, lifecycleBusyRef,
-    // lifecycleActionRef, setAgentStatusIfChanged are now in useLifecycleState
-    // elizaCloudPollInterval, elizaCloudDisconnectInFlightRef,
-    // elizaCloudPreferDisconnectedUntilLoginRef, lastElizaCloudPollConnectedRef,
-    // elizaCloudLoginPollTimer are now in useCloudState (cloudHook)
-    const prevAgentStateRef = useRef(null);
-    const _restartNotificationSignatureRef = useRef(null);
-    const _heartbeatNotificationKeyRef = useRef(null);
-    // Onboarding refs now come from useOnboardingState
-    const onboardingCompletionCommittedRef = onboardingCompletionCommittedRefFromHook;
-    const forceLocalBootstrapRef = forceLocalBootstrapRefFromHook;
-    // exportBusyRef and importBusyRef are now managed inside useExportImportState (exportImportHook)
-    // walletApiKeySavingRef is now managed inside useWalletState (walletHook)
-    // elizaCloudLoginBusyRef, elizaCloudAuthNoticeSentRef, handleCloudLoginRef
-    // are now managed inside useCloudState (cloudHook)
-    // --- Confirm Modal ---
-    const { modalProps } = useConfirm();
-    const { prompt: promptModal, modalProps: promptModalProps } = usePrompt();
-    // --- Wallet / Inventory / Registry / Drop / Whitelist (extracted to useWalletState) ---
-    // Placed after characterHook (characterDraft) and promptModal — both are required params.
-    const walletHook = useWalletState({
-        setActionNotice,
-        promptModal,
-        agentName: agentStatus?.agentName,
-        characterName: characterDraft?.name,
-    });
-    const { state: { browserEnabled, computerUseEnabled, walletEnabled, walletAddresses, walletConfig, walletBalances, walletNfts, walletLoading, walletNftsLoading, inventoryView, walletExportData, walletExportVisible, walletApiKeySaving, inventorySort, inventorySortDirection, inventoryChainFilters, walletError, registryStatus, registryLoading, registryRegistering, registryError, dropStatus, dropLoading, mintInProgress, mintResult, mintError, mintShiny, whitelistStatus, whitelistLoading, wallets, walletPrimary, walletPrimaryRestarting, walletPrimaryPending, cloudRefreshing, }, setBrowserEnabled, setComputerUseEnabled, setWalletEnabled, setWalletAddresses, setInventoryView, setInventorySort, setInventorySortDirection, setInventoryChainFilters, loadWalletConfig, loadBalances, loadNfts, handleWalletApiKeySave, handleExportKeys, loadRegistryStatus, registerOnChain, syncRegistryProfile, loadDropStatus, mintFromDrop, loadWhitelistStatus, setPrimary: setWalletPrimary, refreshCloud: refreshCloudWallets, } = walletHook;
-    // setActionNotice is now provided by useLifecycleState
-    // ── Cloud state (extracted to useCloudState) ───────────────────────
-    // Placed after walletHook so loadWalletConfig is available.
-    const cloudHook = useCloudState({ setActionNotice, loadWalletConfig, t });
-    // ── Vincent state (extracted to useVincentState) ──────────────────
-    const vincentHook = useVincentState({ setActionNotice, t });
-    const { vincentConnected, vincentLoginBusy, vincentLoginError, handleVincentLogin, handleVincentDisconnect, } = vincentHook;
-    const { elizaCloudEnabled, setElizaCloudEnabled, elizaCloudVoiceProxyAvailable, setElizaCloudVoiceProxyAvailable, elizaCloudConnected, setElizaCloudConnected, elizaCloudHasPersistedKey, setElizaCloudHasPersistedKey, elizaCloudCredits, setElizaCloudCredits, elizaCloudCreditsLow, setElizaCloudCreditsLow, elizaCloudCreditsCritical, setElizaCloudCreditsCritical, elizaCloudAuthRejected, setElizaCloudAuthRejected, elizaCloudCreditsError, setElizaCloudCreditsError, elizaCloudTopUpUrl, setElizaCloudTopUpUrl, elizaCloudUserId, setElizaCloudUserId, elizaCloudStatusReason, setElizaCloudStatusReason, cloudDashboardView, setCloudDashboardView, elizaCloudLoginBusy, elizaCloudLoginError, setElizaCloudLoginError, elizaCloudDisconnecting, elizaCloudPollInterval, elizaCloudPreferDisconnectedUntilLoginRef, elizaCloudLoginPollTimer, pollCloudCredits, handleCloudLogin, handleCloudDisconnect, } = cloudHook;
-    // ── Clipboard ──────────────────────────────────────────────────────
-    const copyToClipboard = useCallback(async (text) => {
-        await copyTextToClipboard(text);
-    }, []);
-    // Language is managed by TranslationProvider (see useTranslation() above)
-    // ── Navigation (extracted to useNavigationState) ──────────────────
-    const navHook = useNavigationState({
-        tab,
-        setTabRaw,
-        uiShellMode,
-        hasActiveGameRun: activeGameRunId.trim().length > 0,
-        setAppsSubTab,
-    });
-    const { setTab, setUiShellMode, switchUiShellMode, switchShellView, navigation, } = navHook;
-    useEffect(() => {
-        const navPath = getWindowNavigationPath();
-        if (isRouteRootPath(navPath)) {
-            return;
-        }
-        const routeTab = tabFromPath(navPath);
-        const canonicalPath = canonicalPathForPath(navPath);
-        if (canonicalPath && typeof window !== "undefined") {
-            if (shouldUseHashNavigation()) {
-                window.location.hash = canonicalPath;
-            }
-            else {
-                window.history.replaceState(null, "", `${canonicalPath}${window.location.search}${window.location.hash}`);
-            }
-        }
-        if (routeTab && routeTab !== tab) {
-            setTabRaw(routeTab);
-        }
-    }, [tab, setTabRaw]);
-    // loadLogs is now in useLogsState (logsHook)
-    // ── Data loading (extracted to useDataLoaders) ────────────────────
-    const dataLoaders = useDataLoaders({
-        autonomousStoreRef,
-        autonomousEventsRef,
-        autonomousLatestEventIdRef,
-        autonomousRunHealthByRunIdRef,
-        autonomousReplayInFlightRef,
-        setAutonomousEvents,
-        setAutonomousLatestEventId,
-        setAutonomousRunHealthByRunId,
-        activeConversationIdRef,
-        conversationMessagesRef,
-        greetingFiredRef,
-        setConversations,
-        setActiveConversationId,
-        setConversationMessages,
-        loadWalletConfig,
-        agentStatus,
-        characterData,
-        characterDraft,
-        loadCharacter,
-        selectedVrmIndex,
-        onboardingComplete,
-        uiLanguage,
-        setOwnerNameState,
-    });
-    const { fetchAutonomyReplay, appendAutonomousEvent, loadConversations, loadConversationMessages, getBscTradePreflight, getBscTradeQuote, getBscTradeTxStatus, getStewardStatus, getStewardAddresses, getStewardBalance, getStewardTokens, getStewardWebhookEvents, getStewardHistory, getStewardPending, approveStewardTx, rejectStewardTx, loadWalletTradingProfile, executeBscTrade, executeBscTransfer, loadInventory, workbenchLoading, workbench, workbenchTasksAvailable, workbenchTriggersAvailable, workbenchTodosAvailable, loadWorkbench, updateStatus, updateLoading, updateChannelSaving, loadUpdateStatus, handleChannelChange, extensionStatus, extensionChecking, checkExtensionStatus, } = dataLoaders;
-    // pollCloudCredits is now provided by useCloudState (cloudHook — wired below)
-    // ── Lifecycle actions ──────────────────────────────────────────────
-    // beginLifecycleAction / finishLifecycleAction are now provided by useLifecycleState
-    // ── Chat callbacks (extracted to useChatCallbacks) ──────────────────
-    const chatCallbacks = useChatCallbacks({
-        t,
-        uiLanguage,
-        uiShellMode,
-        tab,
-        agentStatus,
-        chatInput,
-        chatMode,
-        conversations,
-        activeConversationId,
-        companionMessageCutoffTs,
-        conversationMessages,
-        ptySessions,
-        setChatInput,
-        setChatSending,
-        setChatFirstTokenReceived,
-        setChatLastUsage,
-        setChatPendingImages,
-        setConversations,
-        setActiveConversationId,
-        setCompanionMessageCutoffTs,
-        setConversationMessages,
-        setUnreadConversations,
-        resetConversationDraftState,
-        activeConversationIdRef,
-        chatInputRef,
-        chatPendingImagesRef,
-        conversationMessagesRef,
-        conversationHydrationEpochRef,
-        chatAbortRef,
-        chatSendBusyRef,
-        chatSendNonceRef,
-        greetingFiredRef,
-        greetingInFlightConversationRef,
-        companionStaleConversationRefreshRef,
-        lifecycleAction,
-        beginLifecycleAction,
-        finishLifecycleAction,
-        lifecycleBusyRef,
-        lifecycleActionRef,
-        setAgentStatus,
-        setActionNotice,
-        pendingRestart,
-        pendingRestartReasons,
-        setPendingRestart,
-        setPendingRestartReasons,
-        setBackendDisconnectedBannerDismissed,
-        resetBackendConnection,
-        loadConversations,
-        loadConversationMessages,
-        loadPlugins,
-        elizaCloudEnabled,
-        elizaCloudConnected,
-        pollCloudCredits,
-        elizaCloudPreferDisconnectedUntilLoginRef,
-        setElizaCloudEnabled,
-        setElizaCloudConnected,
-        setElizaCloudVoiceProxyAvailable,
-        setElizaCloudHasPersistedKey,
-        setElizaCloudCredits,
-        setElizaCloudCreditsLow,
-        setElizaCloudCreditsCritical,
-        setElizaCloudAuthRejected,
-        setElizaCloudCreditsError,
-        setElizaCloudTopUpUrl,
-        setElizaCloudUserId,
-        setElizaCloudStatusReason,
-        setElizaCloudLoginError,
-        onboardingCompletionCommittedRef,
-        setOnboardingUiRevealNonce,
-        setOnboardingLoading,
-        setOnboardingComplete,
-        setOnboardingStep,
-        setOnboardingMode,
-        setOnboardingActiveGuide,
-        setOnboardingDeferredTasks,
-        setPostOnboardingChecklistDismissed,
-        setOnboardingName,
-        setOnboardingStyle,
-        setOnboardingServerTarget,
-        setOnboardingProvider,
-        setOnboardingApiKey,
-        setOnboardingVoiceProvider: setOnboardingVoiceProvider,
-        setOnboardingVoiceApiKey: setOnboardingVoiceApiKey,
-        setOnboardingPrimaryModel,
-        setOnboardingOpenRouterModel,
-        setOnboardingRemoteConnected,
-        setOnboardingRemoteApiBase,
-        setOnboardingRemoteToken,
-        setOnboardingSmallModel,
-        setOnboardingLargeModel,
-        setOnboardingOptions,
-        setSelectedVrmIndex,
-        setCustomVrmUrl,
-        setCustomBackgroundUrl,
-        setPlugins: setPlugins,
-        setSkills: setSkills,
-        setLogs: setLogs,
-        coordinatorResetRef,
-    });
-    const { fetchGreeting, requestGreetingWhenRunning, hydrateInitialConversationState, handleStartDraftConversation, handleStart, handleStop, handleRestart, triggerRestart, retryBackendConnection, restartBackend, relaunchDesktop, notifyAssistantEvent, notifyHeartbeatEvent, handleResetAppliedFromMain, handleReset, handleNewConversation, sendChatText, handleChatSend, sendActionMessage, handleChatStop, handleChatRetry, handleChatEdit, handleChatClear, handleSelectConversation, handleDeleteConversation, handleRenameConversation, suggestConversationTitle, } = chatCallbacks;
-    useEffect(() => {
-        triggerRestartRef.current = triggerRestart;
-    }, [triggerRestart]);
-    // ── Pairing ────────────────────────────────────────────────────────
-    // ── Plugin / Skill / Store / Catalog actions are provided by usePluginsSkillsState (pluginsSkillsHook) ──
-    // ── Inventory / Registry / Drop / Whitelist actions are provided by useWalletState (walletHook) ──
-    // ── Character actions are provided by useCharacterState (characterHook) ──
-    // ── Onboarding callbacks (extracted to useOnboardingCallbacks) ──────
-    const onboardingCallbacks = useOnboardingCallbacks({
-        onboarding,
-        setActiveOverlayApp,
-        setOnboardingStep,
-        setOnboardingMode,
-        setOnboardingActiveGuide,
-        addDeferredOnboardingTask: addDeferredOnboardingTask,
-        setOnboardingDetectedProviders,
-        setOnboardingServerTarget,
-        setOnboardingCloudApiKey,
-        setOnboardingProvider,
-        setOnboardingApiKey,
-        setOnboardingPrimaryModel,
-        setOnboardingRemoteApiBase,
-        setOnboardingRemoteToken,
-        setOnboardingRemoteConnecting,
-        setOnboardingRemoteError,
-        setOnboardingRemoteConnected,
-        setPostOnboardingChecklistDismissed,
-        setBrowserEnabled,
-        setComputerUseEnabled,
-        setOnboardingComplete,
-        coordinatorOnboardingCompleteRef,
-        initialTabSetRef,
-        setTab,
-        defaultLandingTab: DEFAULT_LANDING_TAB,
-        loadCharacter,
-        uiLanguage,
-        selectedVrmIndex,
-        walletConfig,
-        elizaCloudConnected,
-        setActionNotice,
-        retryStartup,
-        setWalletEnabled,
-        forceLocalBootstrapRef,
-        client,
-    });
-    const { handleOnboardingNext, handleOnboardingBack, handleOnboardingJumpToStep, goToOnboardingStep, handleOnboardingRemoteConnect, handleOnboardingUseLocalBackend, handleCloudOnboardingFinish, applyDetectedProviders, completeOnboarding, } = onboardingCallbacks;
-    // handleAgentExport and handleAgentImport are now in useExportImportState (exportImportHook)
-    // closeCommandPalette, openEmotePicker, closeEmotePicker are now in useMiscUiState (miscUiHook)
-    // ── Generic state setter ───────────────────────────────────────────
-    const setState = useCallback((key, value) => {
-        const setterMap = {
-            tab: setTab,
-            onboardingStep: setOnboardingStep,
-            chatInput: setChatInput,
-            chatAvatarVisible: setChatAvatarVisible,
-            chatAgentVoiceMuted: setChatAgentVoiceMuted,
-            chatLastUsage: setChatLastUsage,
-            chatMode: setChatMode,
-            chatAvatarSpeaking: setChatAvatarSpeaking,
-            companionMessageCutoffTs: setCompanionMessageCutoffTs,
-            uiShellMode: setUiShellMode,
-            uiLanguage: setUiLanguage,
-            autonomousRunHealthByRunId: setAutonomousRunHealthByRunId,
-            startupError: setStartupError,
-            pairingCodeInput: setPairingCodeInput,
-            pluginFilter: setPluginFilter,
-            pluginStatusFilter: setPluginStatusFilter,
-            pluginSearch: setPluginSearch,
-            pluginSettingsOpen: setPluginSettingsOpen,
-            pluginAdvancedOpen: setPluginAdvancedOpen,
-            skillsSubTab: setSkillsSubTab,
-            skillCreateFormOpen: setSkillCreateFormOpen,
-            skillCreateName: setSkillCreateName,
-            skillCreateDescription: setSkillCreateDescription,
-            skillsMarketplaceQuery: setSkillsMarketplaceQuery,
-            skillsMarketplaceManualGithubUrl: setSkillsMarketplaceManualGithubUrl,
-            logTagFilter: setLogTagFilter,
-            logLevelFilter: setLogLevelFilter,
-            logSourceFilter: setLogSourceFilter,
-            browserEnabled: setBrowserEnabled,
-            computerUseEnabled: setComputerUseEnabled,
-            walletEnabled: setWalletEnabled,
-            inventoryView: setInventoryView,
-            inventorySort: setInventorySort,
-            inventorySortDirection: setInventorySortDirection,
-            inventoryChainFilters: setInventoryChainFilters,
-            exportPassword: setExportPassword,
-            exportIncludeLogs: setExportIncludeLogs,
-            exportError: setExportError,
-            exportSuccess: setExportSuccess,
-            importPassword: setImportPassword,
-            importFile: setImportFile,
-            importError: setImportError,
-            importSuccess: setImportSuccess,
-            onboardingName: setOnboardingName,
-            onboardingOwnerName: setOnboardingOwnerName,
-            onboardingStyle: setOnboardingStyle,
-            onboardingServerTarget: setOnboardingServerTarget,
-            onboardingCloudApiKey: setOnboardingCloudApiKey,
-            onboardingSmallModel: setOnboardingSmallModel,
-            onboardingLargeModel: setOnboardingLargeModel,
-            onboardingProvider: setOnboardingProvider,
-            onboardingApiKey: setOnboardingApiKey,
-            onboardingVoiceProvider: setOnboardingVoiceProvider,
-            onboardingVoiceApiKey: setOnboardingVoiceApiKey,
-            onboardingExistingInstallDetected: setOnboardingExistingInstallDetected,
-            onboardingDetectedProviders: setOnboardingDetectedProviders,
-            onboardingRemoteApiBase: setOnboardingRemoteApiBase,
-            onboardingRemoteToken: setOnboardingRemoteToken,
-            onboardingRemoteConnecting: setOnboardingRemoteConnecting,
-            onboardingRemoteError: setOnboardingRemoteError,
-            onboardingRemoteConnected: setOnboardingRemoteConnected,
-            onboardingSelectedChains: setOnboardingSelectedChains,
-            onboardingRpcSelections: setOnboardingRpcSelections,
-            onboardingOpenRouterModel: setOnboardingOpenRouterModel,
-            onboardingPrimaryModel: setOnboardingPrimaryModel,
-            onboardingTelegramToken: setOnboardingTelegramToken,
-            onboardingDiscordToken: setOnboardingDiscordToken,
-            onboardingWhatsAppSessionPath: setOnboardingWhatsAppSessionPath,
-            onboardingTwilioAccountSid: setOnboardingTwilioAccountSid,
-            onboardingTwilioAuthToken: setOnboardingTwilioAuthToken,
-            onboardingTwilioPhoneNumber: setOnboardingTwilioPhoneNumber,
-            onboardingBlooioApiKey: setOnboardingBlooioApiKey,
-            onboardingBlooioPhoneNumber: setOnboardingBlooioPhoneNumber,
-            onboardingGithubToken: setOnboardingGithubToken,
-            onboardingSubscriptionTab: setOnboardingSubscriptionTab,
-            onboardingElizaCloudTab: setOnboardingElizaCloudTab,
-            onboardingRpcKeys: setOnboardingRpcKeys,
-            onboardingAvatar: setOnboardingAvatar,
-            onboardingFeatureTelegram: setOnboardingFeatureTelegram,
-            onboardingFeatureDiscord: setOnboardingFeatureDiscord,
-            onboardingFeaturePhone: setOnboardingFeaturePhone,
-            onboardingFeatureCrypto: setOnboardingFeatureCrypto,
-            onboardingFeatureBrowser: setOnboardingFeatureBrowser,
-            onboardingFeatureComputerUse: setOnboardingFeatureComputerUse,
-            onboardingFeatureOAuthPending: setOnboardingFeatureOAuthPending,
-            elizaCloudEnabled: setElizaCloudEnabled,
-            elizaCloudVoiceProxyAvailable: setElizaCloudVoiceProxyAvailable,
-            cloudDashboardView: setCloudDashboardView,
-            selectedVrmIndex: setSelectedVrmIndex,
-            customVrmUrl: setCustomVrmUrl,
-            customVrmPreviewUrl: setCustomVrmPreviewUrl,
-            customBackgroundUrl: setCustomBackgroundUrl,
-            customCatchphrase: setCustomCatchphrase,
-            customVoicePresetId: setCustomVoicePresetId,
-            activePackId: setActivePackId,
-            customWorldUrl: setCustomWorldUrl,
-            commandQuery: setCommandQuery,
-            commandActiveIndex: setCommandActiveIndex,
-            emotePickerOpen: setEmotePickerOpen,
-            storeSearch: setStoreSearch,
-            storeFilter: setStoreFilter,
-            storeSubTab: setStoreSubTab,
-            catalogSearch: setCatalogSearch,
-            catalogSort: setCatalogSort,
-            catalogPage: setCatalogPage,
-            skillReviewId: setSkillReviewId,
-            skillReviewReport: setSkillReviewReport,
-            appRuns: setAppRuns,
-            activeGameRunId: setActiveGameRunId,
-            gameOverlayEnabled: setGameOverlayEnabled,
-            companionAppRunning: (v) => setActiveOverlayApp(v ? "@elizaos/app-companion" : null),
-            activeOverlayApp: setActiveOverlayApp,
-            activeInboxChat: setActiveInboxChat,
-            activeTerminalSessionId: setActiveTerminalSessionId,
-            storePlugins: setStorePlugins,
-            storeLoading: setStoreLoading,
-            storeInstalling: setStoreInstalling,
-            storeUninstalling: setStoreUninstalling,
-            storeError: setStoreError,
-            storeDetailPlugin: setStoreDetailPlugin,
-            catalogSkills: setCatalogSkills,
-            catalogTotal: setCatalogTotal,
-            catalogTotalPages: setCatalogTotalPages,
-            catalogLoading: setCatalogLoading,
-            catalogError: setCatalogError,
-            catalogDetailSkill: setCatalogDetailSkill,
-            catalogInstalling: setCatalogInstalling,
-            catalogUninstalling: setCatalogUninstalling,
-            mcpConfiguredServers: setMcpConfiguredServers,
-            mcpServerStatuses: setMcpServerStatuses,
-            mcpMarketplaceQuery: setMcpMarketplaceQuery,
-            mcpMarketplaceResults: setMcpMarketplaceResults,
-            mcpMarketplaceLoading: setMcpMarketplaceLoading,
-            mcpAction: setMcpAction,
-            mcpAddingServer: setMcpAddingServer,
-            mcpAddingResult: setMcpAddingResult,
-            mcpEnvInputs: setMcpEnvInputs,
-            mcpHeaderInputs: setMcpHeaderInputs,
-            droppedFiles: setDroppedFiles,
-            shareIngestNotice: setShareIngestNotice,
-            appsSubTab: setAppsSubTab,
-            agentSubTab: setAgentSubTab,
-            pluginsSubTab: setPluginsSubTab,
-            databaseSubTab: setDatabaseSubTab,
-            favoriteApps: setFavoriteApps,
-            recentApps: setRecentApps,
-            configRaw: setConfigRaw,
-            configText: setConfigText,
-            onboardingComplete: setOnboardingComplete,
-        };
-        const setter = setterMap[key];
-        if (setter)
-            setter(value);
-    }, [
-        setOnboardingStep,
-        setSelectedVrmIndex,
-        setUiLanguage,
-        setUiShellMode,
-        setAutonomousRunHealthByRunId,
-        setChatAgentVoiceMuted,
-        setChatAvatarSpeaking,
-        setChatAvatarVisible,
-        setChatInput,
-        setChatLastUsage,
-        setChatMode,
-        setCompanionMessageCutoffTs,
-        setOnboardingApiKey,
-        setOnboardingAvatar,
-        setOnboardingBlooioApiKey,
-        setOnboardingBlooioPhoneNumber,
-        setOnboardingServerTarget,
-        setOnboardingDetectedProviders,
-        setOnboardingDiscordToken,
-        setOnboardingElizaCloudTab,
-        setOnboardingExistingInstallDetected,
-        setOnboardingGithubToken,
-        setOnboardingLargeModel,
-        setOnboardingName,
-        setOnboardingOpenRouterModel,
-        setOnboardingOwnerName,
-        setOnboardingPrimaryModel,
-        setOnboardingProvider,
-        setOnboardingRemoteApiBase,
-        setOnboardingRemoteConnected,
-        setOnboardingRemoteConnecting,
-        setOnboardingRemoteError,
-        setOnboardingRemoteToken,
-        setOnboardingRpcKeys,
-        setOnboardingRpcSelections,
-        setOnboardingSelectedChains,
-        setOnboardingSmallModel,
-        setOnboardingStyle,
-        setOnboardingSubscriptionTab,
-        setOnboardingTelegramToken,
-        setOnboardingTwilioAccountSid,
-        setOnboardingTwilioAuthToken,
-        setOnboardingTwilioPhoneNumber,
-        setOnboardingWhatsAppSessionPath,
-        setOnboardingComplete,
-        setStartupError,
-        setFavoriteApps,
-        setTab,
-        setStoreUninstalling,
-        setStoreSubTab,
-        setCatalogSort,
-        setCatalogTotal,
-        setActiveOverlayApp,
-        setCatalogUninstalling,
-        setCloudDashboardView,
-        setCommandActiveIndex,
-        setCommandQuery,
-        setComputerUseEnabled,
-        setCustomBackgroundUrl,
-        setCustomCatchphrase,
-        setCustomVoicePresetId,
-        setCustomVrmPreviewUrl,
-        setCustomVrmUrl,
-        setCustomWorldUrl,
-        setDroppedFiles,
-        setElizaCloudEnabled,
-        setElizaCloudVoiceProxyAvailable,
-        setEmotePickerOpen,
-        setExportError,
-        setExportIncludeLogs,
-        setExportPassword,
-        setExportSuccess,
-        setGameOverlayEnabled,
-        setImportError,
-        setImportFile,
-        setImportPassword,
-        setImportSuccess,
-        setInventoryChainFilters,
-        setInventorySort,
-        setInventorySortDirection,
-        setInventoryView,
-        setLogLevelFilter,
-        setLogSourceFilter,
-        setLogTagFilter,
-        setMcpAction,
-        setMcpAddingResult,
-        setMcpAddingServer,
-        setMcpConfiguredServers,
-        setMcpEnvInputs,
-        setMcpHeaderInputs,
-        setMcpMarketplaceLoading,
-        setMcpMarketplaceQuery,
-        setMcpMarketplaceResults,
-        setMcpServerStatuses,
-        setOnboardingCloudApiKey,
-        setOnboardingFeatureBrowser,
-        setOnboardingFeatureComputerUse,
-        setOnboardingFeatureCrypto,
-        setOnboardingFeatureDiscord,
-        setOnboardingFeatureOAuthPending,
-        setOnboardingFeaturePhone,
-        setOnboardingFeatureTelegram,
-        setOnboardingVoiceApiKey,
-        setOnboardingVoiceProvider,
-        setPairingCodeInput,
-        setPluginAdvancedOpen,
-        setPluginFilter,
-        setPluginSearch,
-        setPluginSettingsOpen,
-        setPluginStatusFilter,
-        setShareIngestNotice,
-        setSkillCreateDescription,
-        setSkillCreateFormOpen,
-        setSkillCreateName,
-        setSkillReviewId,
-        setSkillReviewReport,
-        setSkillsMarketplaceManualGithubUrl,
-        setSkillsMarketplaceQuery,
-        setSkillsSubTab,
-        setStoreDetailPlugin,
-        setStoreError,
-        setStoreFilter,
-        setStoreInstalling,
-        setStoreLoading,
-        setStorePlugins,
-        setStoreSearch,
-        setCatalogTotalPages,
-        setWalletEnabled,
-        setCatalogSkills,
-        setCatalogSearch,
-        setCatalogPage,
-        setCatalogLoading,
-        setCatalogInstalling,
-        setBrowserEnabled,
-        setCatalogError,
-        setAppsSubTab,
-        setActiveInboxChat,
-        setCatalogDetailSkill,
-        setAppRuns,
-        setActivePackId,
-        setActiveGameRunId,
-        setActiveTerminalSessionId,
-        setRecentApps,
-    ]);
-    const requestGreetingWhenRunningRef = useRef(requestGreetingWhenRunning);
-    useEffect(() => {
-        requestGreetingWhenRunningRef.current = requestGreetingWhenRunning;
-    }, [requestGreetingWhenRunning]);
-    useEffect(() => {
-        const publishConnectionState = (state) => {
-            setBackendConnection({
-                state: state.state,
-                reconnectAttempt: state.reconnectAttempt,
-                maxReconnectAttempts: state.maxReconnectAttempts,
-                showDisconnectedUI: state.state === "failed",
-            });
-        };
-        if (typeof client.getConnectionState === "function") {
-            publishConnectionState(client.getConnectionState());
-        }
-        if (typeof client.onConnectionStateChange !== "function") {
-            return;
-        }
-        return client.onConnectionStateChange((state) => {
-            publishConnectionState(state);
-        });
-    }, [setBackendConnection]);
-    // Passed to the startup coordinator so the PTY poll interval can skip API
-    // calls when no sessions are active.
-    const hasPtySessionsRef = useRef(ptySessions.length > 0);
-    hasPtySessionsRef.current = ptySessions.length > 0;
-    // ── StartupCoordinator (sole startup authority) ──────────────────────
-    // Called after all dependency hooks so every setter/callback is available.
-    const startupCoordinator = useStartupCoordinator({
-        setConnected,
-        setAgentStatus,
-        setAgentStatusIfChanged,
-        setStartupPhase,
-        setStartupError,
-        setAuthRequired,
-        setOnboardingComplete,
-        setOnboardingLoading,
-        setPendingRestart,
-        setPendingRestartReasons,
-        setSystemWarnings,
-        showRestartBanner,
-        setPairingEnabled,
-        setPairingExpiresAt,
-        setOnboardingOptions,
-        setOnboardingExistingInstallDetected,
-        setOnboardingStep,
-        setOnboardingServerTarget,
-        setOnboardingCloudApiKey,
-        setOnboardingProvider,
-        setOnboardingVoiceProvider,
-        setOnboardingApiKey,
-        setOnboardingPrimaryModel,
-        setOnboardingOpenRouterModel,
-        setOnboardingRemoteConnected,
-        setOnboardingRemoteApiBase,
-        setOnboardingRemoteToken,
-        setOnboardingSmallModel,
-        setOnboardingLargeModel,
-        setOnboardingCloudProvisionedContainer,
-        applyDetectedProviders,
-        hydrateInitialConversationState,
-        loadWorkbench,
-        loadPlugins,
-        loadSkills,
-        loadCharacter,
-        loadWalletConfig,
-        loadInventory,
-        loadUpdateStatus,
-        checkExtensionStatus,
-        pollCloudCredits,
-        fetchAutonomyReplay,
-        appendAutonomousEvent,
-        notifyAssistantEvent,
-        notifyHeartbeatEvent,
-        setSelectedVrmIndex,
-        setCustomVrmUrl,
-        setCustomBackgroundUrl,
-        setWalletAddresses,
-        setPtySessions,
-        hasPtySessionsRef,
-        setTab,
-        setTabRaw,
-        setConversationMessages,
-        setUnreadConversations,
-        setConversations,
-        requestGreetingWhenRunningRef,
-        onboardingCompletionCommittedRef,
-        forceLocalBootstrapRef,
-        initialTabSetRef,
-        activeConversationIdRef,
-        elizaCloudPollInterval,
-        elizaCloudLoginPollTimer,
-        uiLanguage,
-        onboardingMode,
-    });
-    // Wire coordinator refs so callbacks defined before the coordinator can reach it
-    coordinatorRetryRef.current = startupCoordinator.retry;
-    coordinatorResetRef.current = startupCoordinator.reset;
-    coordinatorOnboardingCompleteRef.current =
-        startupCoordinator.onboardingComplete;
-    // Memoize the coordinator handle so that unrelated re-renders (e.g. chatInput
-    // keystrokes) don't produce a new object reference and bust the value useMemo below.
-    // The coordinator's computed fields (legacyPhase, loading, terminal, target, phase)
-    // all derive from its reducer state, so state is the only dep we need.
-    // biome-ignore lint/correctness/useExhaustiveDependencies: coordinator fields all derive from state
-    const stableStartupCoordinator = useMemo(() => startupCoordinator, 
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [startupCoordinator.state]);
-    const switchAgentProfile = useCallback((profileId) => {
-        const profile = loadAgentProfileRegistry().profiles.find((p) => p.id === profileId);
-        if (!profile)
-            return;
-        setActiveProfileId(profileId);
-        const server = createPersistedActiveServer({
-            kind: profile.kind,
-            apiBase: profile.apiBase,
-            accessToken: profile.accessToken,
-            label: profile.label,
-        });
-        savePersistedActiveServer(server);
-        if (profile.apiBase) {
-            client.setBaseUrl(profile.apiBase);
-        }
-        if (profile.accessToken) {
-            client.setToken(profile.accessToken);
-        }
-        const target = profile.kind === "cloud"
-            ? "cloud-managed"
-            : profile.kind === "remote"
-                ? "remote-backend"
-                : "embedded-local";
-        startupCoordinator.dispatch({
-            type: "SWITCH_AGENT",
-            target: target,
-        });
-    }, [startupCoordinator]);
-    // When agent transitions to "running", send a greeting if conversation is empty
-    useEffect(() => {
-        const current = agentStatus?.state ?? null;
-        const prev = prevAgentStateRef.current;
-        prevAgentStateRef.current = current;
-        if (current === "running" && prev !== "running") {
-            void loadWorkbench();
-            // Agent just started — greet if conversation is empty.
-            // The greetingFiredRef guard prevents double-greeting when both the
-            // init mount effect and this state-transition effect race to fire.
-            if (activeConversationId &&
-                conversationMessages.length === 0 &&
-                !chatSending &&
-                !greetingFiredRef.current &&
-                greetingInFlightConversationRef.current !== activeConversationId) {
-                void fetchGreeting(activeConversationId);
-            }
-        }
-    }, [
-        agentStatus?.state,
-        loadWorkbench,
-        activeConversationId,
-        conversationMessages.length,
-        chatSending,
-        fetchGreeting,
-        greetingInFlightConversationRef.current,
-        greetingFiredRef.current,
-    ]);
-    // Empty thread + running agent: ensure a first assistant message is requested
-    // (covers races where startup/transition greeting paths miss the active conv id).
-    useEffect(() => {
-        if (!activeConversationId ||
-            conversationMessages.length > 0 ||
-            agentStatus?.state !== "running" ||
-            chatSending) {
-            return;
-        }
-        if (greetingFiredRef.current)
-            return;
-        if (greetingInFlightConversationRef.current === activeConversationId) {
-            return;
-        }
-        const timerId = window.setTimeout(() => {
-            if (activeConversationIdRef.current !== activeConversationId)
-                return;
-            if (conversationMessagesRef.current.length > 0)
-                return;
-            if (greetingFiredRef.current)
-                return;
-            if (greetingInFlightConversationRef.current === activeConversationId) {
-                return;
-            }
-            traceGreeting("effect:empty_thread_auto_greet", {
-                activeConversationId,
-            });
-            void fetchGreeting(activeConversationId);
-        }, 0);
-        return () => window.clearTimeout(timerId);
-    }, [
-        activeConversationId,
-        agentStatus?.state,
-        chatSending,
-        conversationMessages.length,
-        fetchGreeting,
-        activeConversationIdRef.current,
-        greetingFiredRef.current,
-        greetingInFlightConversationRef.current,
-        conversationMessagesRef.current.length,
-    ]);
-    // ── Context value ──────────────────────────────────────────────────
-    // t is provided by TranslationContext (useTranslation() above)
-    // Cloud auth-rejected effect is now inside useCloudState.
-    const companionSceneConfig = useMemo(() => ({
-        selectedVrmIndex,
-        customVrmUrl,
-        customWorldUrl,
-        uiTheme,
-        tab,
-        companionVrmPowerMode,
-        companionHalfFramerateMode,
-        companionAnimateWhenHidden,
-    }), [
-        selectedVrmIndex,
-        customVrmUrl,
-        customWorldUrl,
-        uiTheme,
-        tab,
-        companionVrmPowerMode,
-        companionHalfFramerateMode,
-        companionAnimateWhenHidden,
-    ]);
-    // chatInput/chatSending/chatPendingImages live in ChatComposerContext so that
-    // keystrokes don't cascade through AppContext to all subscribers.
-    const composerValue = useMemo(() => ({
-        chatInput,
-        chatSending,
-        chatPendingImages,
-        setChatInput,
-        setChatPendingImages,
-    }), [
-        chatInput,
-        chatSending,
-        chatPendingImages,
-        setChatInput,
-        setChatPendingImages,
-    ]);
-    // ptySessions lives in PtySessionsContext so the 5-second poll doesn't
-    // cascade through AppContext to all subscribers.
-    const ptySessionsValue = useMemo(() => ({ ptySessions }), [ptySessions]);
-    // The AppContext value is memoized and does NOT include chatInput/chatSending/
-    // chatPendingImages (in ChatComposerCtx) or ptySessions (in PtySessionsCtx).
-    // autonomousEvents/autonomousLatestEventId/autonomousRunHealthByRunId are also
-    // excluded — they update on every heartbeat WS event but no component reads them
-    // directly from useApp(). Excluding them prevents heartbeat events from re-rendering
-    // all AppContext subscribers (CompanionViewOverlay, App, etc.).
-    // NOTE: this dep array must stay in sync with the fields in the value object.
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    const value = useMemo(() => ({
-        // Translations
-        t,
-        // State
-        tab,
-        uiShellMode,
-        uiLanguage,
-        uiTheme,
-        themeId,
-        companionVrmPowerMode,
-        companionAnimateWhenHidden,
-        companionHalfFramerateMode,
-        connected,
-        agentStatus,
-        onboardingComplete,
-        onboardingUiRevealNonce,
-        onboardingLoading,
-        startupPhase,
-        startupStatus,
-        startupError,
-        // StartupCoordinator — the sole startup authority
-        startupCoordinator: stableStartupCoordinator,
-        authRequired,
-        actionNotice,
-        lifecycleBusy,
-        lifecycleAction,
-        pendingRestart,
-        pendingRestartReasons,
-        restartBannerDismissed,
-        backendConnection,
-        backendDisconnectedBannerDismissed,
-        pairingEnabled,
-        pairingExpiresAt,
-        pairingCodeInput,
-        pairingError,
-        pairingBusy,
-        // chatInput/chatSending/chatPendingImages are stale here — read via useChatComposer()
-        chatInput,
-        chatSending,
-        chatFirstTokenReceived,
-        chatLastUsage,
-        chatAvatarVisible,
-        chatAgentVoiceMuted,
-        chatMode,
-        chatAvatarSpeaking,
-        conversations,
-        activeConversationId,
-        companionMessageCutoffTs,
-        conversationMessages,
-        autonomousEvents,
-        autonomousLatestEventId,
-        autonomousRunHealthByRunId,
-        ptySessions,
-        unreadConversations,
-        triggers,
-        triggersLoaded,
-        triggersLoading,
-        triggersSaving,
-        triggerRunsById,
-        triggerHealth,
-        triggerError,
-        plugins,
-        pluginFilter,
-        pluginStatusFilter,
-        pluginSearch,
-        pluginSettingsOpen,
-        pluginAdvancedOpen,
-        pluginSaving,
-        pluginSaveSuccess,
-        skills,
-        skillsSubTab,
-        skillCreateFormOpen,
-        skillCreateName,
-        skillCreateDescription,
-        skillCreating,
-        skillReviewReport,
-        skillReviewId,
-        skillReviewLoading,
-        skillToggleAction,
-        skillsMarketplaceQuery,
-        skillsMarketplaceResults,
-        skillsMarketplaceError,
-        skillsMarketplaceLoading,
-        skillsMarketplaceAction,
-        skillsMarketplaceManualGithubUrl,
-        logs,
-        logSources,
-        logTags,
-        logTagFilter,
-        logLevelFilter,
-        logSourceFilter,
-        logLoadError,
-        browserEnabled,
-        computerUseEnabled,
-        walletEnabled,
-        walletAddresses,
-        walletConfig,
-        walletBalances,
-        walletNfts,
-        walletLoading,
-        walletNftsLoading,
-        inventoryView,
-        walletExportData,
-        walletExportVisible,
-        walletApiKeySaving,
-        inventorySort,
-        inventorySortDirection,
-        inventoryChainFilters,
-        walletError,
-        registryStatus,
-        registryLoading,
-        registryRegistering,
-        registryError,
-        dropStatus,
-        dropLoading,
-        mintInProgress,
-        mintResult,
-        mintError,
-        mintShiny,
-        whitelistStatus,
-        whitelistLoading,
-        wallets,
-        walletPrimary,
-        walletPrimaryRestarting,
-        walletPrimaryPending,
-        cloudRefreshing,
-        setWalletPrimary,
-        refreshCloudWallets,
-        characterData,
-        characterLoading,
-        characterSaving,
-        characterSaveSuccess,
-        characterSaveError,
-        characterDraft,
-        selectedVrmIndex,
-        customVrmUrl,
-        customVrmPreviewUrl,
-        customBackgroundUrl,
-        customCatchphrase,
-        customVoicePresetId,
-        activePackId,
-        customWorldUrl,
-        elizaCloudEnabled,
-        elizaCloudVoiceProxyAvailable,
-        elizaCloudConnected,
-        elizaCloudHasPersistedKey,
-        elizaCloudCredits,
-        elizaCloudCreditsLow,
-        elizaCloudCreditsCritical,
-        elizaCloudAuthRejected,
-        elizaCloudCreditsError,
-        elizaCloudTopUpUrl,
-        elizaCloudUserId,
-        elizaCloudStatusReason,
-        ownerName,
-        cloudDashboardView,
-        elizaCloudLoginBusy,
-        elizaCloudLoginError,
-        elizaCloudDisconnecting,
-        activeAgentProfile: getActiveProfile(),
-        updateStatus,
-        updateLoading,
-        updateChannelSaving,
-        extensionStatus,
-        extensionChecking,
-        storePlugins,
-        storeSearch,
-        storeFilter,
-        storeLoading,
-        storeInstalling,
-        storeUninstalling,
-        storeError,
-        storeDetailPlugin,
-        storeSubTab,
-        catalogSkills,
-        catalogTotal,
-        catalogPage,
-        catalogTotalPages,
-        catalogSort,
-        catalogSearch,
-        catalogLoading,
-        catalogError,
-        catalogDetailSkill,
-        catalogInstalling,
-        catalogUninstalling,
-        workbenchLoading,
-        workbench,
-        workbenchTasksAvailable,
-        workbenchTriggersAvailable,
-        workbenchTodosAvailable,
-        exportBusy,
-        exportPassword,
-        exportIncludeLogs,
-        exportError,
-        exportSuccess,
-        importBusy,
-        importPassword,
-        importFile,
-        importError,
-        importSuccess,
-        onboardingStep,
-        onboardingMode,
-        onboardingActiveGuide,
-        onboardingDeferredTasks,
-        postOnboardingChecklistDismissed,
-        onboardingOptions,
-        onboardingName,
-        onboardingOwnerName,
-        onboardingStyle,
-        onboardingServerTarget,
-        onboardingCloudApiKey,
-        onboardingSmallModel,
-        onboardingLargeModel,
-        onboardingProvider,
-        onboardingApiKey,
-        onboardingVoiceProvider,
-        onboardingVoiceApiKey,
-        onboardingExistingInstallDetected,
-        onboardingDetectedProviders,
-        onboardingRemoteApiBase,
-        onboardingRemoteToken,
-        onboardingRemoteConnecting,
-        onboardingRemoteError,
-        onboardingRemoteConnected,
-        onboardingOpenRouterModel,
-        onboardingPrimaryModel,
-        onboardingTelegramToken,
-        onboardingDiscordToken,
-        onboardingWhatsAppSessionPath,
-        onboardingTwilioAccountSid,
-        onboardingTwilioAuthToken,
-        onboardingTwilioPhoneNumber,
-        onboardingBlooioApiKey,
-        onboardingBlooioPhoneNumber,
-        onboardingGithubToken,
-        onboardingSubscriptionTab,
-        onboardingElizaCloudTab,
-        onboardingSelectedChains,
-        onboardingRpcSelections,
-        onboardingRpcKeys,
-        onboardingAvatar,
-        onboardingFeatureTelegram,
-        onboardingFeatureDiscord,
-        onboardingFeaturePhone,
-        onboardingFeatureCrypto,
-        onboardingFeatureBrowser,
-        onboardingFeatureComputerUse,
-        onboardingFeatureOAuthPending,
-        commandPaletteOpen,
-        commandQuery,
-        commandActiveIndex,
-        closeCommandPalette,
-        emotePickerOpen,
-        mcpConfiguredServers,
-        mcpServerStatuses,
-        mcpMarketplaceQuery,
-        mcpMarketplaceResults,
-        mcpMarketplaceLoading,
-        mcpAction,
-        mcpAddingServer,
-        mcpAddingResult,
-        mcpEnvInputs,
-        mcpHeaderInputs,
-        droppedFiles,
-        shareIngestNotice,
-        chatPendingImages,
-        appRuns,
-        activeGameRunId,
-        activeGameApp,
-        activeGameDisplayName,
-        activeGameViewerUrl,
-        activeGameSandbox,
-        activeGamePostMessageAuth,
-        activeGameSession,
-        gameOverlayEnabled,
-        companionAppRunning,
-        activeOverlayApp,
-        activeInboxChat,
-        activeTerminalSessionId,
-        appsSubTab,
-        agentSubTab,
-        pluginsSubTab,
-        databaseSubTab,
-        favoriteApps,
-        recentApps,
-        configRaw,
-        configText,
-        activeGamePostMessagePayload,
-        // Actions
-        setTab,
-        setUiShellMode,
-        switchUiShellMode,
-        switchShellView,
-        navigation,
-        setUiLanguage,
-        setUiTheme,
-        setThemeId,
-        setCompanionVrmPowerMode,
-        setCompanionAnimateWhenHidden,
-        setCompanionHalfFramerateMode,
-        handleStart,
-        handleStop,
-        handleRestart,
-        handleReset,
-        handleResetAppliedFromMain,
-        retryStartup,
-        dismissRestartBanner,
-        showRestartBanner,
-        triggerRestart,
-        relaunchDesktop,
-        dismissBackendDisconnectedBanner,
-        retryBackendConnection,
-        restartBackend,
-        systemWarnings,
-        dismissSystemWarning,
-        handleChatSend,
-        handleChatStop,
-        handleChatRetry,
-        handleChatEdit,
-        handleChatClear,
-        handleStartDraftConversation,
-        handleNewConversation,
-        setChatPendingImages,
-        handleSelectConversation,
-        handleDeleteConversation,
-        handleRenameConversation,
-        suggestConversationTitle,
-        sendActionMessage,
-        sendChatText,
-        loadTriggers,
-        ensureTriggersLoaded,
-        createTrigger,
-        updateTrigger,
-        deleteTrigger,
-        runTriggerNow,
-        loadTriggerRuns,
-        loadTriggerHealth,
-        handlePairingSubmit,
-        loadPlugins,
-        ensurePluginsLoaded,
-        handlePluginToggle,
-        handlePluginConfigSave,
-        loadSkills,
-        refreshSkills,
-        handleSkillToggle,
-        handleCreateSkill,
-        handleOpenSkill,
-        handleDeleteSkill,
-        handleReviewSkill,
-        handleAcknowledgeSkill,
-        searchSkillsMarketplace,
-        installSkillFromMarketplace,
-        uninstallMarketplaceSkill,
-        installSkillFromGithubUrl,
-        enableMarketplaceSkill,
-        disableMarketplaceSkill,
-        copyMarketplaceSkillSource,
-        loadLogs,
-        loadInventory,
-        loadWalletConfig,
-        loadBalances,
-        loadNfts,
-        executeBscTrade,
-        executeBscTransfer,
-        getBscTradePreflight,
-        getBscTradeQuote,
-        getBscTradeTxStatus,
-        getStewardStatus,
-        getStewardAddresses,
-        getStewardBalance,
-        getStewardTokens,
-        getStewardWebhookEvents,
-        getStewardHistory,
-        getStewardPending,
-        approveStewardTx,
-        rejectStewardTx,
-        loadWalletTradingProfile,
-        handleWalletApiKeySave,
-        handleExportKeys,
-        loadRegistryStatus,
-        registerOnChain,
-        syncRegistryProfile,
-        loadDropStatus,
-        mintFromDrop,
-        loadWhitelistStatus,
-        loadCharacter,
-        handleSaveCharacter,
-        handleCharacterFieldInput,
-        handleCharacterArrayInput,
-        handleCharacterStyleInput,
-        handleCharacterMessageExamplesInput,
-        handleOnboardingNext,
-        handleOnboardingBack,
-        handleOnboardingJumpToStep,
-        goToOnboardingStep,
-        handleOnboardingRemoteConnect,
-        handleOnboardingUseLocalBackend,
-        completeOnboarding,
-        handleCloudLogin,
-        handleCloudDisconnect,
-        switchAgentProfile,
-        handleCloudOnboardingFinish,
-        vincentConnected,
-        vincentLoginBusy,
-        vincentLoginError,
-        handleVincentLogin,
-        handleVincentDisconnect,
-        loadUpdateStatus,
-        handleChannelChange,
-        checkExtensionStatus,
-        openEmotePicker,
-        closeEmotePicker,
-        loadWorkbench,
-        handleAgentExport,
-        handleAgentImport,
-        setActionNotice,
-        setState,
-        copyToClipboard,
-    }), 
-    // prettier-ignore
-    [
-        t,
-        tab,
-        uiShellMode,
-        uiLanguage,
-        uiTheme,
-        themeId,
-        companionVrmPowerMode,
-        companionAnimateWhenHidden,
-        companionHalfFramerateMode,
-        connected,
-        agentStatus,
-        onboardingComplete,
-        onboardingUiRevealNonce,
-        onboardingLoading,
-        startupPhase,
-        startupStatus,
-        startupError,
-        stableStartupCoordinator,
-        authRequired,
-        actionNotice,
-        lifecycleBusy,
-        lifecycleAction,
-        pendingRestart,
-        pendingRestartReasons,
-        restartBannerDismissed,
-        backendConnection,
-        backendDisconnectedBannerDismissed,
-        pairingEnabled,
-        pairingExpiresAt,
-        pairingCodeInput,
-        pairingError,
-        pairingBusy,
-        chatFirstTokenReceived,
-        chatLastUsage,
-        chatAvatarVisible,
-        chatAgentVoiceMuted,
-        chatMode,
-        chatAvatarSpeaking,
-        conversations,
-        activeConversationId,
-        companionMessageCutoffTs,
-        conversationMessages,
-        autonomousEvents,
-        autonomousLatestEventId,
-        autonomousRunHealthByRunId,
-        // NOTE: ptySessions intentionally EXCLUDED — provided fresh via PtySessionsCtx.
-        unreadConversations,
-        triggers,
-        triggersLoaded,
-        triggersLoading,
-        triggersSaving,
-        triggerRunsById,
-        triggerHealth,
-        triggerError,
-        plugins,
-        pluginFilter,
-        pluginStatusFilter,
-        pluginSearch,
-        pluginSettingsOpen,
-        pluginAdvancedOpen,
-        pluginSaving,
-        pluginSaveSuccess,
-        skills,
-        skillsSubTab,
-        skillCreateFormOpen,
-        skillCreateName,
-        skillCreateDescription,
-        skillCreating,
-        skillReviewReport,
-        skillReviewId,
-        skillReviewLoading,
-        skillToggleAction,
-        skillsMarketplaceQuery,
-        skillsMarketplaceResults,
-        skillsMarketplaceError,
-        skillsMarketplaceLoading,
-        skillsMarketplaceAction,
-        skillsMarketplaceManualGithubUrl,
-        logs,
-        logSources,
-        logTags,
-        logTagFilter,
-        logLevelFilter,
-        logSourceFilter,
-        logLoadError,
-        browserEnabled,
-        computerUseEnabled,
-        walletEnabled,
-        walletAddresses,
-        walletConfig,
-        walletBalances,
-        walletNfts,
-        walletLoading,
-        walletNftsLoading,
-        inventoryView,
-        walletExportData,
-        walletExportVisible,
-        walletApiKeySaving,
-        inventorySort,
-        inventorySortDirection,
-        inventoryChainFilters,
-        walletError,
-        registryStatus,
-        registryLoading,
-        registryRegistering,
-        registryError,
-        dropStatus,
-        dropLoading,
-        mintInProgress,
-        mintResult,
-        mintError,
-        mintShiny,
-        whitelistStatus,
-        whitelistLoading,
-        wallets,
-        walletPrimary,
-        walletPrimaryRestarting,
-        walletPrimaryPending,
-        cloudRefreshing,
-        setWalletPrimary,
-        refreshCloudWallets,
-        characterData,
-        characterLoading,
-        characterSaving,
-        characterSaveSuccess,
-        characterSaveError,
-        characterDraft,
-        selectedVrmIndex,
-        customVrmUrl,
-        customVrmPreviewUrl,
-        customBackgroundUrl,
-        customCatchphrase,
-        customVoicePresetId,
-        activePackId,
-        customWorldUrl,
-        elizaCloudEnabled,
-        elizaCloudVoiceProxyAvailable,
-        elizaCloudConnected,
-        elizaCloudHasPersistedKey,
-        elizaCloudCredits,
-        elizaCloudCreditsLow,
-        elizaCloudCreditsCritical,
-        elizaCloudAuthRejected,
-        elizaCloudCreditsError,
-        elizaCloudTopUpUrl,
-        elizaCloudUserId,
-        elizaCloudStatusReason,
-        ownerName,
-        cloudDashboardView,
-        elizaCloudLoginBusy,
-        elizaCloudLoginError,
-        elizaCloudDisconnecting,
-        updateStatus,
-        updateLoading,
-        updateChannelSaving,
-        extensionStatus,
-        extensionChecking,
-        storePlugins,
-        storeSearch,
-        storeFilter,
-        storeLoading,
-        storeInstalling,
-        storeUninstalling,
-        storeError,
-        storeDetailPlugin,
-        storeSubTab,
-        catalogSkills,
-        catalogTotal,
-        catalogPage,
-        catalogTotalPages,
-        catalogSort,
-        catalogSearch,
-        catalogLoading,
-        catalogError,
-        catalogDetailSkill,
-        catalogInstalling,
-        catalogUninstalling,
-        workbenchLoading,
-        workbench,
-        workbenchTasksAvailable,
-        workbenchTriggersAvailable,
-        workbenchTodosAvailable,
-        exportBusy,
-        exportPassword,
-        exportIncludeLogs,
-        exportError,
-        exportSuccess,
-        importBusy,
-        importPassword,
-        importFile,
-        importError,
-        importSuccess,
-        onboardingStep,
-        onboardingMode,
-        onboardingActiveGuide,
-        onboardingDeferredTasks,
-        postOnboardingChecklistDismissed,
-        onboardingOptions,
-        onboardingName,
-        onboardingOwnerName,
-        onboardingStyle,
-        onboardingServerTarget,
-        onboardingCloudApiKey,
-        onboardingSmallModel,
-        onboardingLargeModel,
-        onboardingProvider,
-        onboardingApiKey,
-        onboardingVoiceProvider,
-        onboardingVoiceApiKey,
-        onboardingExistingInstallDetected,
-        onboardingDetectedProviders,
-        onboardingRemoteApiBase,
-        onboardingRemoteToken,
-        onboardingRemoteConnecting,
-        onboardingRemoteError,
-        onboardingRemoteConnected,
-        onboardingOpenRouterModel,
-        onboardingPrimaryModel,
-        onboardingTelegramToken,
-        onboardingDiscordToken,
-        onboardingWhatsAppSessionPath,
-        onboardingTwilioAccountSid,
-        onboardingTwilioAuthToken,
-        onboardingTwilioPhoneNumber,
-        onboardingBlooioApiKey,
-        onboardingBlooioPhoneNumber,
-        onboardingGithubToken,
-        onboardingSubscriptionTab,
-        onboardingElizaCloudTab,
-        onboardingSelectedChains,
-        onboardingRpcSelections,
-        onboardingRpcKeys,
-        onboardingAvatar,
-        onboardingFeatureTelegram,
-        onboardingFeatureDiscord,
-        onboardingFeaturePhone,
-        onboardingFeatureCrypto,
-        onboardingFeatureBrowser,
-        onboardingFeatureComputerUse,
-        onboardingFeatureOAuthPending,
-        commandPaletteOpen,
-        commandQuery,
-        commandActiveIndex,
-        closeCommandPalette,
-        emotePickerOpen,
-        mcpConfiguredServers,
-        mcpServerStatuses,
-        mcpMarketplaceQuery,
-        mcpMarketplaceResults,
-        mcpMarketplaceLoading,
-        mcpAction,
-        mcpAddingServer,
-        mcpAddingResult,
-        mcpEnvInputs,
-        mcpHeaderInputs,
-        droppedFiles,
-        shareIngestNotice,
-        appRuns,
-        activeGameRunId,
-        activeGameApp,
-        activeGameDisplayName,
-        activeGameViewerUrl,
-        activeGameSandbox,
-        activeGamePostMessageAuth,
-        activeGameSession,
-        gameOverlayEnabled,
-        companionAppRunning,
-        activeOverlayApp,
-        activeInboxChat,
-        activeTerminalSessionId,
-        appsSubTab,
-        agentSubTab,
-        pluginsSubTab,
-        databaseSubTab,
-        favoriteApps,
-        recentApps,
-        configRaw,
-        configText,
-        activeGamePostMessagePayload,
-        systemWarnings,
-        setTab,
-        setUiShellMode,
-        switchUiShellMode,
-        switchShellView,
-        navigation,
-        setUiLanguage,
-        setUiTheme,
-        setThemeId,
-        setCompanionVrmPowerMode,
-        setCompanionAnimateWhenHidden,
-        setCompanionHalfFramerateMode,
-        handleStart,
-        handleStop,
-        handleRestart,
-        handleReset,
-        handleResetAppliedFromMain,
-        retryStartup,
-        dismissRestartBanner,
-        showRestartBanner,
-        triggerRestart,
-        relaunchDesktop,
-        dismissBackendDisconnectedBanner,
-        retryBackendConnection,
-        restartBackend,
-        dismissSystemWarning,
-        handleChatSend,
-        handleChatStop,
-        handleChatRetry,
-        handleChatEdit,
-        handleChatClear,
-        handleStartDraftConversation,
-        handleNewConversation,
-        handleSelectConversation,
-        handleDeleteConversation,
-        handleRenameConversation,
-        suggestConversationTitle,
-        sendActionMessage,
-        sendChatText,
-        loadTriggers,
-        ensureTriggersLoaded,
-        createTrigger,
-        updateTrigger,
-        deleteTrigger,
-        runTriggerNow,
-        loadTriggerRuns,
-        loadTriggerHealth,
-        handlePairingSubmit,
-        loadPlugins,
-        ensurePluginsLoaded,
-        handlePluginToggle,
-        handlePluginConfigSave,
-        loadSkills,
-        refreshSkills,
-        handleSkillToggle,
-        handleCreateSkill,
-        handleOpenSkill,
-        handleDeleteSkill,
-        handleReviewSkill,
-        handleAcknowledgeSkill,
-        searchSkillsMarketplace,
-        installSkillFromMarketplace,
-        uninstallMarketplaceSkill,
-        installSkillFromGithubUrl,
-        enableMarketplaceSkill,
-        disableMarketplaceSkill,
-        copyMarketplaceSkillSource,
-        loadLogs,
-        loadInventory,
-        loadWalletConfig,
-        loadBalances,
-        loadNfts,
-        executeBscTrade,
-        executeBscTransfer,
-        getBscTradePreflight,
-        getBscTradeQuote,
-        getBscTradeTxStatus,
-        getStewardStatus,
-        getStewardAddresses,
-        getStewardBalance,
-        getStewardTokens,
-        getStewardWebhookEvents,
-        getStewardHistory,
-        getStewardPending,
-        approveStewardTx,
-        rejectStewardTx,
-        loadWalletTradingProfile,
-        handleWalletApiKeySave,
-        handleExportKeys,
-        loadRegistryStatus,
-        registerOnChain,
-        syncRegistryProfile,
-        loadDropStatus,
-        mintFromDrop,
-        loadWhitelistStatus,
-        loadCharacter,
-        handleSaveCharacter,
-        handleCharacterFieldInput,
-        handleCharacterArrayInput,
-        handleCharacterStyleInput,
-        handleCharacterMessageExamplesInput,
-        handleOnboardingNext,
-        handleOnboardingBack,
-        handleOnboardingJumpToStep,
-        goToOnboardingStep,
-        handleOnboardingRemoteConnect,
-        handleOnboardingUseLocalBackend,
-        completeOnboarding,
-        handleCloudLogin,
-        handleCloudDisconnect,
-        switchAgentProfile,
-        handleCloudOnboardingFinish,
-        vincentConnected,
-        vincentLoginBusy,
-        vincentLoginError,
-        handleVincentLogin,
-        handleVincentDisconnect,
-        loadUpdateStatus,
-        handleChannelChange,
-        checkExtensionStatus,
-        openEmotePicker,
-        closeEmotePicker,
-        loadWorkbench,
-        handleAgentExport,
-        handleAgentImport,
-        setActionNotice,
-        setState,
-        copyToClipboard,
-        chatPendingImages,
-        setChatPendingImages,
-        chatSending,
-        ptySessions, // chatInput/chatSending/chatPendingImages are stale here — read via useChatComposer()
-        chatInput,
-    ]);
-    const bootConfig = getBootConfig();
-    const bootConfigValue = useMemo(() => ({
-        ...bootConfig,
-        branding: { ...bootConfig.branding, ...brandingOverride },
-    }), [bootConfig, brandingOverride]);
-    const mergedBranding = useMemo(() => ({ ...DEFAULT_BRANDING, ...bootConfigValue.branding }), [bootConfigValue]);
-    return (_jsx(AppBootContext.Provider, { value: bootConfigValue, children: _jsx(BrandingContext.Provider, { value: mergedBranding, children: _jsx(CompanionSceneConfigCtx.Provider, { value: companionSceneConfig, children: _jsx(PtySessionsCtx.Provider, { value: ptySessionsValue, children: _jsx(ChatInputRefCtx.Provider, { value: chatInputRef, children: _jsx(ChatComposerCtx.Provider, { value: composerValue, children: _jsxs(AppContext.Provider, { value: value, children: [children, _jsx(ConfirmDialog, { ...modalProps }), _jsx(PromptDialog, { ...promptModalProps })] }) }) }) }) }) }) }));
-}