@elizaos/agent 2.0.0-alpha.358 → 2.0.0-alpha.376

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

@@ -0,0 +1,1896 @@
+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, useTranslation, 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 })] }) }) }) }) }) }) }));
+}