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

package/state/AppContext.js

@@ -0,0 +1,1809 @@
+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 { useCallback, useEffect, useMemo, useRef, useState, } from "react";
+import { client } from "../api/index.js";
+import { ConfirmDialog, PromptDialog } from "../components/ui/confirm-dialog.js";
+import { useConfirm, usePrompt } from "../components/ui/confirm-dialog.hooks.js";
+import { AppBootContext } from "../config/boot-config-react.hooks.js";
+import { getBootConfig } from "../config/boot-config-store.js";
+import { BrandingContext, DEFAULT_BRANDING } from "../config/branding.js";
+import { isMobileLocalAgentIpcBase, persistMobileRuntimeModeForServerTarget, } from "../first-run/mobile-runtime-mode.js";
+import { activeServerKindToFirstRunRuntimeTarget, } from "../first-run/runtime-target.js";
+import { getWindowNavigationPath, resolveDefaultLandingTab, resolveInitialTabForPath, } from "../navigation/index.js";
+import { getFrontendPlatform } from "../platform/platform-guards.js";
+import { applyThemeToDocument } from "../themes/apply-theme.js";
+import { copyTextToClipboard } from "../utils/index.js";
+import { RESYNC_EVENT } from "./AppContext.hooks.js";
+import { getActiveProfile, loadAgentProfileRegistry, setActiveProfileId, } from "./agent-profiles.js";
+import { ChatComposerCtx, ChatInputRefCtx, clearAllChatDrafts, useChatComposerDraftPersistence, } from "./ChatComposerContext.hooks.js";
+import { CompanionSceneConfigCtx } from "./CompanionSceneConfigContext.hooks.js";
+import { AppContext } from "./internal.js";
+import { PtySessionsCtx } from "./PtySessionsContext.hooks.js";
+import { createPersistedActiveServer, savePersistedActiveServer, } from "./persistence.js";
+import { deriveUiShellModeForTab } from "./shell-routing.js";
+import { useTranslation } from "./TranslationContext.hooks.js";
+import { TranslationProvider } from "./TranslationProvider.js";
+import { useAppLifecycleEvents } from "./useAppLifecycleEvents.js";
+import { useAgentGreetingEffects, useBackendConnectionSync, useNavigationPathSync, } from "./useAppProviderEffects.js";
+import { useAppShellState } from "./useAppShellState.js";
+import { useCharacterState } from "./useCharacterState.js";
+import { useChatCallbacks } from "./useChatCallbacks.js";
+import { useChatState } from "./useChatState.js";
+import { useCloudState } from "./useCloudState.js";
+import { useDataLoaders } from "./useDataLoaders.js";
+import { useDisplayPreferences } from "./useDisplayPreferences.js";
+import { useExportImportState } from "./useExportImportState.js";
+import { useFirstRunCallbacks } from "./useFirstRunCallbacks.js";
+import { useFirstRunState } from "./useFirstRunState.js";
+import { useLifecycleState } from "./useLifecycleState.js";
+import { useLogsState } from "./useLogsState.js";
+import { useMiscUiState } from "./useMiscUiState.js";
+import { useNavigationState } from "./useNavigationState.js";
+import { usePairingState } from "./usePairingState.js";
+import { usePluginsSkillsState } from "./usePluginsSkillsState.js";
+import { useStartupCoordinator } from "./useStartupCoordinator.js";
+import { useTabSync } from "./useTabSync.js";
+import { useTriggersState } from "./useTriggersState.js";
+import { useWalletState } from "./useWalletState.js";
+/**
+ * FirstRunShell and bare `completeFirstRun()` land on the discovered
+ * main-tab app; callers can open the companion overlay separately.
+ *
+ * Resolved synchronously from the cached apps catalog at module load.
+ * Falls back to chat when no installed app declares `elizaos.app.mainTab=true`.
+ */
+const DEFAULT_LANDING_TAB = resolveDefaultLandingTab();
+// ── Provider ───────────────────────────────────────────────────────────
+export function AppProvider({ children, branding: brandingOverride, }) {
+    const onLanguageSyncError = useCallback((_lang) => {
+        // Non-fatal: language change will be reflected on next mount.
+    }, []);
+    return (_jsx(TranslationProvider, { onLanguageSyncError: onLanguageSyncError, branding: brandingOverride, 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, uiThemeMode, companionVrmPowerMode, companionAnimateWhenHidden, companionHalfFramerateMode, }, setUiTheme, setUiThemeMode, setCompanionVrmPowerMode, setCompanionAnimateWhenHidden, setCompanionHalfFramerateMode, } = displayPrefs;
+    // Apply the host app's brand theme (set via BrandingConfig.theme).
+    const brandTheme = brandingOverride?.theme;
+    useEffect(() => {
+        if (!brandTheme)
+            return;
+        return applyThemeToDocument(brandTheme, uiTheme);
+    }, [brandTheme, uiTheme]);
+    // ── Lifecycle state (consolidated from 20+ useState hooks) ──
+    const lifecycle = useLifecycleState();
+    const { state: { connected, agentStatus, firstRunComplete, firstRunUiRevealNonce, firstRunLoading, startupPhase, startupError, authRequired, actionNotice, lifecycleBusy, lifecycleAction, pendingRestart, pendingRestartReasons, restartBannerDismissed, backendConnection, backendDisconnectedBannerDismissed, systemWarnings, actionBanner, }, setConnected, setAgentStatus, setAgentStatusIfChanged, setFirstRunComplete, incrementFirstRunRevealNonce: setFirstRunUiRevealNonce_increment, setFirstRunLoading, setStartupPhase, setStartupError, setAuthRequired, setActionNotice, beginLifecycleAction, finishLifecycleAction, setPendingRestart: setPendingRestartAction, dismissRestartBanner, showRestartBanner, setBackendConnection, dismissBackendBanner: dismissBackendDisconnectedBanner, resetBackendConnection, dismissSystemWarning, showActionBanner, dismissActionBanner, 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 setFirstRunUiRevealNonce = useCallback((_fn) => setFirstRunUiRevealNonce_increment(), [setFirstRunUiRevealNonce_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 coordinatorFirstRunCompleteRef = useRef(null);
+    const retryStartup = useCallback(() => {
+        lifecycle.retryStartup();
+        coordinatorRetryRef.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, chatAvatarSpeaking, conversations, activeConversationId, companionMessageCutoffTs, conversationMessages, autonomousEvents, autonomousLatestEventId, autonomousRunHealthByRunId, ptySessions, unreadConversations, chatPendingImages, }, setChatInput, setChatSending, setChatFirstTokenReceived, setChatLastUsage, setChatAvatarVisible, setChatAgentVoiceMuted, setChatAvatarSpeaking, setConversations, setActiveConversationId, setCompanionMessageCutoffTs, setConversationMessages, setAutonomousEvents, setAutonomousLatestEventId, setAutonomousRunHealthByRunId, setPtySessions, setChatPendingImages, resetDraftState: resetConversationDraftState, activeConversationIdRef, chatInputRef, chatPendingImagesRef, conversationsRef, 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, isLoadingPlugins, pluginsLoadError, pluginsLoaded, 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 shellState = useAppShellState();
+    const { state: { ownerName, appsSubTab, agentSubTab, pluginsSubTab, databaseSubTab, favoriteApps, recentApps, configRaw, configText, }, setOwnerNameState, setAppsSubTab, setAgentSubTab, setPluginsSubTab, setDatabaseSubTab, setFavoriteApps, setRecentApps, setConfigRaw, setConfigText, } = shellState;
+    // 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;
+    // ── First-run state (consolidated from 35+ useState hooks) ──
+    const firstRun = useFirstRunState(brandingOverride?.cloudOnly);
+    const { state: { step: setupStep, mode: firstRunMode, activeGuide: firstRunActiveGuide, deferredTasks: firstRunDeferredTasks, postChecklistDismissed: postFirstRunChecklistDismissed, options: firstRunOptions, name: firstRunName, ownerName: firstRunOwnerName, style: firstRunStyle, avatar: setupAvatar, serverTarget: firstRunRuntimeTarget, cloudApiKey: firstRunCloudApiKey, provider: firstRunProvider, apiKey: firstRunApiKey, voiceProvider: firstRunVoiceProvider, voiceApiKey: firstRunVoiceApiKey, smallModel: firstRunSmallModel, largeModel: firstRunLargeModel, openRouterModel: firstRunOpenRouterModel, primaryModel: firstRunPrimaryModel, existingInstallDetected: firstRunExistingInstallDetected, detectedProviders: firstRunDetectedProviders, remoteApiBase: firstRunRemoteApiBase, remoteToken: firstRunRemoteToken, subscriptionTab: firstRunSubscriptionTab, elizaCloudTab: firstRunElizaCloudTab, selectedChains: firstRunSelectedChains, rpcSelections: firstRunRpcSelections, rpcKeys: firstRunRpcKeys, featureTelegram: firstRunFeatureTelegram, featureDiscord: firstRunFeatureDiscord, featurePhone: firstRunFeaturePhone, featureCrypto: firstRunFeatureCrypto, featureBrowser: firstRunFeatureBrowser, featureComputerUse: firstRunFeatureComputerUse, featureOAuthPending: firstRunFeatureOAuthPending, cloudProvisionedContainer: firstRunCloudProvisionedContainer, }, setStep: setSetupStep, setMode: setFirstRunMode, setActiveGuide: setFirstRunActiveGuide, addDeferredTask: addDeferredFirstRunTask, setOptions: setFirstRunOptions, setDetectedProviders: setFirstRunDetectedProviders, completionCommittedRef: firstRunCompletionCommittedRefFromHook, forceLocalBootstrapRef: forceLocalBootstrapRefFromHook, } = firstRun;
+    const { firstRunRemoteConnecting, firstRunRemoteError, firstRunRemoteConnected, firstRunTelegramToken, firstRunDiscordToken, firstRunWhatsAppSessionPath, firstRunTwilioAccountSid, firstRunTwilioAuthToken, firstRunTwilioPhoneNumber, firstRunBlooioApiKey, firstRunBlooioPhoneNumber, firstRunGithubToken, setFirstRunName, setFirstRunOwnerName, setFirstRunStyle, setFirstRunRuntimeTarget, setFirstRunCloudApiKey, setFirstRunSmallModel, setFirstRunLargeModel, setFirstRunProvider, setFirstRunApiKey, setFirstRunVoiceProvider, setFirstRunVoiceApiKey, setFirstRunExistingInstallDetected, setFirstRunRemoteApiBase, setFirstRunRemoteToken, setFirstRunRemoteConnecting, setFirstRunRemoteError, setFirstRunRemoteConnected, setFirstRunOpenRouterModel, setFirstRunPrimaryModel, setFirstRunTelegramToken, setFirstRunDiscordToken, setFirstRunWhatsAppSessionPath, setFirstRunTwilioAccountSid, setFirstRunTwilioAuthToken, setFirstRunTwilioPhoneNumber, setFirstRunBlooioApiKey, setFirstRunBlooioPhoneNumber, setFirstRunGithubToken, setFirstRunSubscriptionTab, setFirstRunElizaCloudTab, setFirstRunSelectedChains, setFirstRunRpcSelections, setFirstRunRpcKeys, setSetupAvatar, setFirstRunFeatureTelegram, setFirstRunFeatureDiscord, setFirstRunFeaturePhone, setFirstRunFeatureCrypto, setFirstRunFeatureBrowser, setFirstRunFeatureComputerUse, setFirstRunFeatureOAuthPending, setFirstRunCloudProvisionedContainer, setPostFirstRunChecklistDismissed, setFirstRunDeferredTasks, } = useMemo(() => {
+        const { dispatch, setConnectorToken, setDeferredTasks, setField, setRemoteStatus, } = firstRun;
+        const { connectorTokens, remote } = firstRun.state;
+        const bindField = (field) => (value) => {
+            setField(field, value);
+        };
+        const bindConnectorToken = (key) => (value) => {
+            setConnectorToken(key, value);
+        };
+        return {
+            firstRunRemoteConnecting: remote.status === "connecting",
+            firstRunRemoteError: remote.error,
+            firstRunRemoteConnected: remote.status === "connected",
+            firstRunTelegramToken: connectorTokens.telegramToken,
+            firstRunDiscordToken: connectorTokens.discordToken,
+            firstRunWhatsAppSessionPath: connectorTokens.whatsAppSessionPath,
+            firstRunTwilioAccountSid: connectorTokens.twilioAccountSid,
+            firstRunTwilioAuthToken: connectorTokens.twilioAuthToken,
+            firstRunTwilioPhoneNumber: connectorTokens.twilioPhoneNumber,
+            firstRunBlooioApiKey: connectorTokens.blooioApiKey,
+            firstRunBlooioPhoneNumber: connectorTokens.blooioPhoneNumber,
+            firstRunGithubToken: connectorTokens.githubToken,
+            setFirstRunName: bindField("name"),
+            setFirstRunOwnerName: bindField("ownerName"),
+            setFirstRunStyle: bindField("style"),
+            setFirstRunRuntimeTarget: bindField("serverTarget"),
+            setFirstRunCloudApiKey: bindField("cloudApiKey"),
+            setFirstRunSmallModel: bindField("smallModel"),
+            setFirstRunLargeModel: bindField("largeModel"),
+            setFirstRunProvider: bindField("provider"),
+            setFirstRunApiKey: bindField("apiKey"),
+            setFirstRunVoiceProvider: bindField("voiceProvider"),
+            setFirstRunVoiceApiKey: bindField("voiceApiKey"),
+            setFirstRunExistingInstallDetected: bindField("existingInstallDetected"),
+            setFirstRunRemoteApiBase: (value) => {
+                dispatch({ type: "SET_REMOTE_API_BASE", value });
+            },
+            setFirstRunRemoteToken: (value) => {
+                dispatch({ type: "SET_REMOTE_TOKEN", value });
+            },
+            setFirstRunRemoteConnecting: (value) => {
+                if (value) {
+                    setRemoteStatus("connecting");
+                    return;
+                }
+                if (remote.status === "connecting") {
+                    setRemoteStatus("idle");
+                }
+            },
+            setFirstRunRemoteError: (value) => {
+                if (value) {
+                    setRemoteStatus("error", value);
+                    return;
+                }
+                if (remote.status === "error") {
+                    setRemoteStatus("idle");
+                }
+            },
+            setFirstRunRemoteConnected: (value) => {
+                if (value) {
+                    setRemoteStatus("connected");
+                    return;
+                }
+                if (remote.status === "connected") {
+                    setRemoteStatus("idle");
+                }
+            },
+            setFirstRunOpenRouterModel: bindField("openRouterModel"),
+            setFirstRunPrimaryModel: bindField("primaryModel"),
+            setFirstRunTelegramToken: bindConnectorToken("telegramToken"),
+            setFirstRunDiscordToken: bindConnectorToken("discordToken"),
+            setFirstRunWhatsAppSessionPath: bindConnectorToken("whatsAppSessionPath"),
+            setFirstRunTwilioAccountSid: bindConnectorToken("twilioAccountSid"),
+            setFirstRunTwilioAuthToken: bindConnectorToken("twilioAuthToken"),
+            setFirstRunTwilioPhoneNumber: bindConnectorToken("twilioPhoneNumber"),
+            setFirstRunBlooioApiKey: bindConnectorToken("blooioApiKey"),
+            setFirstRunBlooioPhoneNumber: bindConnectorToken("blooioPhoneNumber"),
+            setFirstRunGithubToken: bindConnectorToken("githubToken"),
+            setFirstRunSubscriptionTab: bindField("subscriptionTab"),
+            setFirstRunElizaCloudTab: bindField("elizaCloudTab"),
+            setFirstRunSelectedChains: bindField("selectedChains"),
+            setFirstRunRpcSelections: bindField("rpcSelections"),
+            setFirstRunRpcKeys: bindField("rpcKeys"),
+            setSetupAvatar: bindField("avatar"),
+            setFirstRunFeatureTelegram: bindField("featureTelegram"),
+            setFirstRunFeatureDiscord: bindField("featureDiscord"),
+            setFirstRunFeaturePhone: bindField("featurePhone"),
+            setFirstRunFeatureCrypto: bindField("featureCrypto"),
+            setFirstRunFeatureBrowser: bindField("featureBrowser"),
+            setFirstRunFeatureComputerUse: bindField("featureComputerUse"),
+            setFirstRunFeatureOAuthPending: bindField("featureOAuthPending"),
+            setFirstRunCloudProvisionedContainer: bindField("cloudProvisionedContainer"),
+            setPostFirstRunChecklistDismissed: (value) => {
+                dispatch({ type: "SET_POST_CHECKLIST_DISMISSED", value });
+            },
+            setFirstRunDeferredTasks: (tasks) => {
+                setDeferredTasks(tasks);
+            },
+        };
+    }, [firstRun]);
+    // startupStatus is now derived in useLifecycleState
+    // --- Command palette / emote picker / MCP / game / dropped files (extracted to useMiscUiState) ---
+    const miscUiHook = useMiscUiState();
+    const { state: { analysisMode, 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, setAnalysisMode, 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
+    // --- Refs for timers ---
+    // actionNoticeTimer, shownOnceNotices, agentStatusRef, lifecycleBusyRef,
+    // lifecycleActionRef, setAgentStatusIfChanged are now in useLifecycleState
+    // elizaCloudPollInterval, elizaCloudDisconnectInFlightRef,
+    // elizaCloudPreferDisconnectedUntilLoginRef, lastElizaCloudPollConnectedRef,
+    // elizaCloudLoginPollTimer are now in useCloudState (cloudHook)
+    const _restartNotificationSignatureRef = useRef(null);
+    const _heartbeatNotificationKeyRef = useRef(null);
+    // First-run refs now come from useFirstRunState
+    const firstRunCompletionCommittedRef = firstRunCompletionCommittedRefFromHook;
+    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,
+        disconnectLocked: brandingOverride?.cloudOnly === true,
+    });
+    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, elizaCloudLoginFallbackUrl, 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;
+    useNavigationPathSync({ 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,
+        firstRunComplete,
+        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,
+        conversations,
+        activeConversationId,
+        companionMessageCutoffTs,
+        conversationMessages,
+        ptySessions,
+        setChatInput,
+        setChatSending,
+        setChatFirstTokenReceived,
+        setChatLastUsage,
+        setChatPendingImages,
+        setConversations,
+        setActiveConversationId,
+        setCompanionMessageCutoffTs,
+        setConversationMessages,
+        setUnreadConversations,
+        resetConversationDraftState,
+        activeConversationIdRef,
+        chatInputRef,
+        chatPendingImagesRef,
+        conversationsRef,
+        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,
+        firstRunCompletionCommittedRef,
+        setFirstRunUiRevealNonce,
+        setFirstRunLoading,
+        setFirstRunComplete,
+        setSetupStep,
+        setFirstRunMode,
+        setFirstRunActiveGuide,
+        setFirstRunDeferredTasks,
+        setPostFirstRunChecklistDismissed,
+        setFirstRunName,
+        setFirstRunStyle,
+        setFirstRunRuntimeTarget,
+        setFirstRunProvider,
+        setFirstRunApiKey,
+        setFirstRunVoiceProvider: setFirstRunVoiceProvider,
+        setFirstRunVoiceApiKey: setFirstRunVoiceApiKey,
+        setFirstRunPrimaryModel,
+        setFirstRunOpenRouterModel,
+        setFirstRunRemoteConnected,
+        setFirstRunRemoteApiBase,
+        setFirstRunRemoteToken,
+        setFirstRunSmallModel,
+        setFirstRunLargeModel,
+        setFirstRunOptions,
+        setSelectedVrmIndex,
+        setCustomVrmUrl,
+        setCustomBackgroundUrl,
+        setPlugins: setPlugins,
+        setSkills: setSkills,
+        setLogs: setLogs,
+        coordinatorResetRef,
+    });
+    const { fetchGreeting, requestGreetingWhenRunning, hydrateInitialConversationState, handleStartDraftConversation, handleStart, handleStop, handleRestart, triggerRestart, retryBackendConnection, restartBackend, relaunchDesktop, notifyHeartbeatEvent, handleResetAppliedFromMain, handleReset, handleNewConversation, sendChatText, handleChatSend, sendActionMessage, handleChatStop, handleChatRetry, handleChatEdit, handleChatClear, handleSelectConversation, handleDeleteConversation, handleRenameConversation, suggestConversationTitle, } = chatCallbacks;
+    useEffect(() => {
+        triggerRestartRef.current = triggerRestart;
+    }, [triggerRestart]);
+    // ── Cross-window sync + reconnect reconciliation ───────────────────
+    // Track whether the last active-conversation change came from another window
+    // so applying it doesn't echo straight back out and loop between tabs.
+    const tabSyncActiveConvRef = useRef(null);
+    const tabSync = useTabSync({
+        onActiveConversation: (id) => {
+            tabSyncActiveConvRef.current = id;
+            setActiveConversationId(id);
+        },
+        onPrefs: (prefs) => {
+            if (prefs.language) {
+                setUiLanguage(prefs.language);
+            }
+        },
+    });
+    // Mirror this window's active conversation to the other windows. Suppress the
+    // mirror when the change itself arrived via sync (no echo).
+    useEffect(() => {
+        if (tabSyncActiveConvRef.current === activeConversationId) {
+            tabSyncActiveConvRef.current = null;
+            return;
+        }
+        tabSync.publishActiveConversation(activeConversationId);
+    }, [activeConversationId, tabSync]);
+    // Mirror the UI language to the other windows.
+    useEffect(() => {
+        tabSync.publishPrefs({ language: uiLanguage });
+    }, [uiLanguage, tabSync]);
+    // Reconnect reconciliation: when the socket comes back after a drop, re-arm
+    // this window's per-connection active conversation on the server (the fresh
+    // connection has no memory of it) and ask conversation views to refetch their
+    // recent messages so the UI repairs state lost during the gap. Fires once per
+    // reconnect — no polling.
+    // biome-ignore lint/correctness/useExhaustiveDependencies: subscribe once on mount; the current conversation is read through a ref, and `client` is module-stable.
+    useEffect(() => {
+        return client.onReconnect(() => {
+            const convId = activeConversationIdRef.current;
+            client.sendWsMessage({
+                type: "active-conversation",
+                conversationId: convId,
+            });
+            if (typeof window !== "undefined") {
+                window.dispatchEvent(new CustomEvent(RESYNC_EVENT, {
+                    detail: { conversationId: convId },
+                }));
+            }
+        });
+    }, []);
+    // ── 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) ──
+    // ── First-run callbacks (extracted to useFirstRunCallbacks) ──────
+    const firstRunCallbacks = useFirstRunCallbacks({
+        firstRun,
+        setActiveOverlayApp,
+        setSetupStep,
+        setFirstRunMode,
+        setFirstRunActiveGuide,
+        addDeferredFirstRunTask: addDeferredFirstRunTask,
+        setFirstRunDetectedProviders,
+        setFirstRunRuntimeTarget,
+        setFirstRunCloudApiKey,
+        setFirstRunProvider,
+        setFirstRunApiKey,
+        setFirstRunPrimaryModel,
+        setFirstRunRemoteApiBase,
+        setFirstRunRemoteToken,
+        setFirstRunRemoteConnecting,
+        setFirstRunRemoteError,
+        setFirstRunRemoteConnected,
+        setPostFirstRunChecklistDismissed,
+        setBrowserEnabled,
+        setComputerUseEnabled,
+        setFirstRunComplete,
+        coordinatorFirstRunCompleteRef,
+        initialTabSetRef,
+        setTab,
+        defaultLandingTab: DEFAULT_LANDING_TAB,
+        loadCharacter,
+        uiLanguage,
+        selectedVrmIndex,
+        walletConfig,
+        elizaCloudConnected,
+        setActionNotice,
+        retryStartup,
+        setWalletEnabled,
+        forceLocalBootstrapRef,
+        client,
+    });
+    const { handleFirstRunNext, handleFirstRunBack, handleFirstRunJumpToStep, goToFirstRunStep, handleFirstRunRemoteConnect, handleFirstRunUseLocalBackend, handleCloudFirstRunFinish, applyDetectedProviders, completeFirstRun, } = firstRunCallbacks;
+    // handleAgentExport and handleAgentImport are now in useExportImportState (exportImportHook)
+    // closeCommandPalette, openEmotePicker, closeEmotePicker are now in useMiscUiState (miscUiHook)
+    // ── Generic state setter ───────────────────────────────────────────
+    // Ref-stable generic setter: the exposed `setState` callback never changes
+    // identity (deps `[]`), so it does not bust the AppContext value memo. The
+    // latest setter map is read through a ref on each call, so behavior is
+    // identical to a callback that closed over every setter directly.
+    const setStateImplRef = useRef(() => { });
+    setStateImplRef.current = (key, value) => {
+        {
+            const setterMap = {
+                tab: setTab,
+                setupStep: setSetupStep,
+                chatInput: setChatInput,
+                chatAvatarVisible: setChatAvatarVisible,
+                chatAgentVoiceMuted: setChatAgentVoiceMuted,
+                chatLastUsage: setChatLastUsage,
+                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,
+                firstRunName: setFirstRunName,
+                firstRunOwnerName: setFirstRunOwnerName,
+                firstRunStyle: setFirstRunStyle,
+                firstRunRuntimeTarget: setFirstRunRuntimeTarget,
+                firstRunCloudApiKey: setFirstRunCloudApiKey,
+                firstRunSmallModel: setFirstRunSmallModel,
+                firstRunLargeModel: setFirstRunLargeModel,
+                firstRunProvider: setFirstRunProvider,
+                firstRunApiKey: setFirstRunApiKey,
+                firstRunVoiceProvider: setFirstRunVoiceProvider,
+                firstRunVoiceApiKey: setFirstRunVoiceApiKey,
+                firstRunExistingInstallDetected: setFirstRunExistingInstallDetected,
+                firstRunDetectedProviders: setFirstRunDetectedProviders,
+                firstRunRemoteApiBase: setFirstRunRemoteApiBase,
+                firstRunRemoteToken: setFirstRunRemoteToken,
+                firstRunRemoteConnecting: setFirstRunRemoteConnecting,
+                firstRunRemoteError: setFirstRunRemoteError,
+                firstRunRemoteConnected: setFirstRunRemoteConnected,
+                firstRunSelectedChains: setFirstRunSelectedChains,
+                firstRunRpcSelections: setFirstRunRpcSelections,
+                firstRunOpenRouterModel: setFirstRunOpenRouterModel,
+                firstRunPrimaryModel: setFirstRunPrimaryModel,
+                firstRunTelegramToken: setFirstRunTelegramToken,
+                firstRunDiscordToken: setFirstRunDiscordToken,
+                firstRunWhatsAppSessionPath: setFirstRunWhatsAppSessionPath,
+                firstRunTwilioAccountSid: setFirstRunTwilioAccountSid,
+                firstRunTwilioAuthToken: setFirstRunTwilioAuthToken,
+                firstRunTwilioPhoneNumber: setFirstRunTwilioPhoneNumber,
+                firstRunBlooioApiKey: setFirstRunBlooioApiKey,
+                firstRunBlooioPhoneNumber: setFirstRunBlooioPhoneNumber,
+                firstRunGithubToken: setFirstRunGithubToken,
+                firstRunSubscriptionTab: setFirstRunSubscriptionTab,
+                firstRunElizaCloudTab: setFirstRunElizaCloudTab,
+                firstRunRpcKeys: setFirstRunRpcKeys,
+                setupAvatar: setSetupAvatar,
+                firstRunFeatureTelegram: setFirstRunFeatureTelegram,
+                firstRunFeatureDiscord: setFirstRunFeatureDiscord,
+                firstRunFeaturePhone: setFirstRunFeaturePhone,
+                firstRunFeatureCrypto: setFirstRunFeatureCrypto,
+                firstRunFeatureBrowser: setFirstRunFeatureBrowser,
+                firstRunFeatureComputerUse: setFirstRunFeatureComputerUse,
+                firstRunFeatureOAuthPending: setFirstRunFeatureOAuthPending,
+                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,
+                analysisMode: setAnalysisMode,
+                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/plugin-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,
+                firstRunComplete: setFirstRunComplete,
+            };
+            const setter = setterMap[key];
+            if (setter)
+                setter(value);
+        }
+    };
+    const setState = useCallback((key, value) => setStateImplRef.current(key, value), []);
+    const requestGreetingWhenRunningRef = useRef(requestGreetingWhenRunning);
+    useEffect(() => {
+        requestGreetingWhenRunningRef.current = requestGreetingWhenRunning;
+    }, [requestGreetingWhenRunning]);
+    useBackendConnectionSync({ 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;
+    // Lets the startup coordinator's PTY hydration gate the orchestrator/coding-agent
+    // routes until the agent runtime is running, avoiding the 404/503 console burst
+    // during the post-(re)start window before those services finish starting.
+    const agentRunningRef = useRef(agentStatus?.state === "running");
+    agentRunningRef.current = agentStatus?.state === "running";
+    // ── StartupCoordinator (sole startup authority) ──────────────────────
+    // Called after all dependency hooks so every setter/callback is available.
+    const startupCoordinator = useStartupCoordinator({
+        setConnected,
+        setAgentStatus,
+        setAgentStatusIfChanged,
+        setStartupPhase,
+        setStartupError,
+        setAuthRequired,
+        setFirstRunComplete,
+        setFirstRunLoading,
+        setPendingRestart,
+        setPendingRestartReasons,
+        setSystemWarnings,
+        showRestartBanner,
+        setPairingEnabled,
+        setPairingExpiresAt,
+        setFirstRunOptions,
+        setFirstRunExistingInstallDetected,
+        setSetupStep,
+        setFirstRunRuntimeTarget,
+        setFirstRunCloudApiKey,
+        setFirstRunProvider,
+        setFirstRunVoiceProvider,
+        setFirstRunApiKey,
+        setFirstRunPrimaryModel,
+        setFirstRunOpenRouterModel,
+        setFirstRunRemoteConnected,
+        setFirstRunRemoteApiBase,
+        setFirstRunRemoteToken,
+        setFirstRunSmallModel,
+        setFirstRunLargeModel,
+        setFirstRunCloudProvisionedContainer,
+        applyDetectedProviders,
+        hydrateInitialConversationState,
+        loadWorkbench,
+        loadPlugins,
+        loadSkills,
+        loadCharacter,
+        loadWalletConfig,
+        loadInventory,
+        loadUpdateStatus,
+        checkExtensionStatus,
+        pollCloudCredits,
+        fetchAutonomyReplay,
+        appendAutonomousEvent,
+        notifyHeartbeatEvent,
+        setSelectedVrmIndex,
+        setCustomVrmUrl,
+        setCustomBackgroundUrl,
+        setWalletAddresses,
+        setPtySessions,
+        hasPtySessionsRef,
+        agentRunningRef,
+        setTab,
+        setTabRaw,
+        setConversationMessages,
+        setUnreadConversations,
+        setConversations,
+        requestGreetingWhenRunningRef,
+        firstRunCompletionCommittedRef,
+        forceLocalBootstrapRef,
+        initialTabSetRef,
+        activeConversationIdRef,
+        elizaCloudPollInterval,
+        elizaCloudLoginPollTimer,
+        uiLanguage,
+        firstRunMode,
+    });
+    // useReducer dispatch is referentially stable across renders; bind it so
+    // callbacks (e.g. switchAgentProfile) depend on the stable dispatch rather
+    // than the whole coordinator handle (which is a fresh object each render).
+    const startupCoordinatorDispatch = startupCoordinator.dispatch;
+    // Wire coordinator refs so callbacks defined before the coordinator can reach it
+    coordinatorRetryRef.current = startupCoordinator.retry;
+    coordinatorResetRef.current = startupCoordinator.reset;
+    coordinatorFirstRunCompleteRef.current = startupCoordinator.firstRunComplete;
+    // 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);
+        // Conversation ids are per-account, so saved drafts from the old
+        // profile would re-attach to whatever conversation happens to land
+        // on the same id after the switch. Wipe them.
+        clearAllChatDrafts();
+        const server = createPersistedActiveServer({
+            kind: profile.kind,
+            apiBase: profile.apiBase,
+            accessToken: profile.accessToken,
+            label: profile.label,
+        });
+        savePersistedActiveServer(server);
+        // On mobile the boot-time reconcile (reconcileMobileRestoredActiveServer)
+        // CLEARS the active server whenever the persisted runtime mode disagrees
+        // with it (`mobileLocal && mode !== "local"` → null). So a profile switch
+        // only survives a reboot if we ALSO persist the matching runtime mode —
+        // otherwise switching to the on-device agent reverts to cloud next boot.
+        // The on-device agent is a `remote` profile whose apiBase is the local IPC
+        // base, so detect that and treat it as "local".
+        const frontendPlatform = getFrontendPlatform();
+        if (frontendPlatform === "android" || frontendPlatform === "ios") {
+            const runtimeTarget = server.kind === "local" || isMobileLocalAgentIpcBase(server.apiBase)
+                ? "local"
+                : activeServerKindToFirstRunRuntimeTarget(server.kind);
+            persistMobileRuntimeModeForServerTarget(runtimeTarget);
+        }
+        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";
+        startupCoordinatorDispatch({
+            type: "SWITCH_AGENT",
+            target: target,
+        });
+    }, [startupCoordinatorDispatch]);
+    useAgentGreetingEffects({
+        agentState: agentStatus?.state,
+        loadWorkbench,
+        activeConversationId,
+        conversationMessages,
+        chatSending,
+        fetchGreeting,
+        activeConversationIdRef,
+        conversationMessagesRef,
+        greetingFiredRef,
+        greetingInFlightConversationRef,
+    });
+    // ── Capacitor app lifecycle (APP_RESUME / APP_PAUSE) ────────────────
+    // Bridges native lifecycle events into the chat pipeline: aborts
+    // in-flight streams before iOS suspends the process, persists the
+    // active conversation id, and re-probes /api/health on resume so the
+    // renderer notices a respawned FGS / dev server on a new port.
+    useAppLifecycleEvents({
+        activeConversationIdRef,
+        conversationMessagesRef,
+        chatAbortRef,
+        setConversationMessages,
+    });
+    // ── Chat composer draft persistence ────────────────────────────────
+    // Restores the textarea content when the user revisits a conversation
+    // (a common mobile pattern: open the app, start typing, switch apps,
+    // come back later). Drafts are scoped per conversation id and are
+    // cleared after a successful send or when the user switches accounts.
+    useChatComposerDraftPersistence({
+        activeConversationId,
+        chatInput,
+        setChatInput,
+    });
+    // ── 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,
+        uiThemeMode,
+        companionVrmPowerMode,
+        companionAnimateWhenHidden,
+        companionHalfFramerateMode,
+        connected,
+        agentStatus,
+        firstRunComplete,
+        firstRunUiRevealNonce,
+        firstRunLoading,
+        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,
+        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,
+        isLoadingPlugins,
+        pluginsLoadError,
+        pluginsLoaded,
+        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,
+        elizaCloudLoginFallbackUrl,
+        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,
+        setupStep,
+        firstRunMode,
+        firstRunActiveGuide,
+        firstRunDeferredTasks,
+        postFirstRunChecklistDismissed,
+        firstRunOptions,
+        firstRunName,
+        firstRunOwnerName,
+        firstRunStyle,
+        firstRunRuntimeTarget,
+        firstRunCloudApiKey,
+        firstRunSmallModel,
+        firstRunLargeModel,
+        firstRunProvider,
+        firstRunApiKey,
+        firstRunVoiceProvider,
+        firstRunVoiceApiKey,
+        firstRunExistingInstallDetected,
+        firstRunDetectedProviders,
+        firstRunRemoteApiBase,
+        firstRunRemoteToken,
+        firstRunRemoteConnecting,
+        firstRunRemoteError,
+        firstRunRemoteConnected,
+        firstRunOpenRouterModel,
+        firstRunPrimaryModel,
+        firstRunTelegramToken,
+        firstRunDiscordToken,
+        firstRunWhatsAppSessionPath,
+        firstRunTwilioAccountSid,
+        firstRunTwilioAuthToken,
+        firstRunTwilioPhoneNumber,
+        firstRunBlooioApiKey,
+        firstRunBlooioPhoneNumber,
+        firstRunGithubToken,
+        firstRunSubscriptionTab,
+        firstRunElizaCloudTab,
+        firstRunSelectedChains,
+        firstRunRpcSelections,
+        firstRunRpcKeys,
+        setupAvatar,
+        firstRunFeatureTelegram,
+        firstRunFeatureDiscord,
+        firstRunFeaturePhone,
+        firstRunFeatureCrypto,
+        firstRunFeatureBrowser,
+        firstRunFeatureComputerUse,
+        firstRunFeatureOAuthPending,
+        firstRunCloudProvisionedContainer,
+        commandPaletteOpen,
+        commandQuery,
+        commandActiveIndex,
+        closeCommandPalette,
+        emotePickerOpen,
+        mcpConfiguredServers,
+        mcpServerStatuses,
+        mcpMarketplaceQuery,
+        mcpMarketplaceResults,
+        mcpMarketplaceLoading,
+        mcpAction,
+        mcpAddingServer,
+        mcpAddingResult,
+        mcpEnvInputs,
+        mcpHeaderInputs,
+        droppedFiles,
+        shareIngestNotice,
+        chatPendingImages,
+        analysisMode,
+        setAnalysisMode,
+        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,
+        setUiThemeMode,
+        setCompanionVrmPowerMode,
+        setCompanionAnimateWhenHidden,
+        setCompanionHalfFramerateMode,
+        handleStart,
+        handleStop,
+        handleRestart,
+        handleReset,
+        handleResetAppliedFromMain,
+        retryStartup,
+        dismissRestartBanner,
+        showRestartBanner,
+        triggerRestart,
+        relaunchDesktop,
+        dismissBackendDisconnectedBanner,
+        retryBackendConnection,
+        restartBackend,
+        systemWarnings,
+        dismissSystemWarning,
+        actionBanner,
+        showActionBanner,
+        dismissActionBanner,
+        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,
+        handleFirstRunNext,
+        handleFirstRunBack,
+        handleFirstRunJumpToStep,
+        goToFirstRunStep,
+        handleFirstRunRemoteConnect,
+        handleFirstRunUseLocalBackend,
+        completeFirstRun,
+        handleCloudLogin,
+        handleCloudDisconnect,
+        switchAgentProfile,
+        handleCloudFirstRunFinish,
+        loadUpdateStatus,
+        handleChannelChange,
+        checkExtensionStatus,
+        openEmotePicker,
+        closeEmotePicker,
+        loadWorkbench,
+        handleAgentExport,
+        handleAgentImport,
+        setActionNotice,
+        setState,
+        copyToClipboard,
+    }), 
+    // prettier-ignore
+    [
+        t,
+        tab,
+        uiShellMode,
+        uiLanguage,
+        uiTheme,
+        uiThemeMode,
+        companionVrmPowerMode,
+        companionAnimateWhenHidden,
+        companionHalfFramerateMode,
+        connected,
+        agentStatus,
+        firstRunComplete,
+        firstRunUiRevealNonce,
+        firstRunLoading,
+        startupPhase,
+        startupStatus,
+        startupError,
+        stableStartupCoordinator,
+        authRequired,
+        actionNotice,
+        lifecycleBusy,
+        lifecycleAction,
+        pendingRestart,
+        pendingRestartReasons,
+        restartBannerDismissed,
+        backendConnection,
+        backendDisconnectedBannerDismissed,
+        pairingEnabled,
+        pairingExpiresAt,
+        pairingCodeInput,
+        pairingError,
+        pairingBusy,
+        chatFirstTokenReceived,
+        chatLastUsage,
+        chatAvatarVisible,
+        chatAgentVoiceMuted,
+        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,
+        isLoadingPlugins,
+        pluginsLoadError,
+        pluginsLoaded,
+        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,
+        elizaCloudLoginFallbackUrl,
+        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,
+        setupStep,
+        firstRunMode,
+        firstRunActiveGuide,
+        firstRunDeferredTasks,
+        postFirstRunChecklistDismissed,
+        firstRunOptions,
+        firstRunName,
+        firstRunOwnerName,
+        firstRunStyle,
+        firstRunRuntimeTarget,
+        firstRunCloudApiKey,
+        firstRunSmallModel,
+        firstRunLargeModel,
+        firstRunProvider,
+        firstRunApiKey,
+        firstRunVoiceProvider,
+        firstRunVoiceApiKey,
+        firstRunExistingInstallDetected,
+        firstRunDetectedProviders,
+        firstRunRemoteApiBase,
+        firstRunRemoteToken,
+        firstRunRemoteConnecting,
+        firstRunRemoteError,
+        firstRunRemoteConnected,
+        firstRunOpenRouterModel,
+        firstRunPrimaryModel,
+        firstRunTelegramToken,
+        firstRunDiscordToken,
+        firstRunWhatsAppSessionPath,
+        firstRunTwilioAccountSid,
+        firstRunTwilioAuthToken,
+        firstRunTwilioPhoneNumber,
+        firstRunBlooioApiKey,
+        firstRunBlooioPhoneNumber,
+        firstRunGithubToken,
+        firstRunSubscriptionTab,
+        firstRunElizaCloudTab,
+        firstRunSelectedChains,
+        firstRunRpcSelections,
+        firstRunRpcKeys,
+        setupAvatar,
+        firstRunFeatureTelegram,
+        firstRunFeatureDiscord,
+        firstRunFeaturePhone,
+        firstRunFeatureCrypto,
+        firstRunFeatureBrowser,
+        firstRunFeatureComputerUse,
+        firstRunFeatureOAuthPending,
+        firstRunCloudProvisionedContainer,
+        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,
+        actionBanner,
+        setTab,
+        setUiShellMode,
+        switchUiShellMode,
+        switchShellView,
+        navigation,
+        setUiLanguage,
+        setUiTheme,
+        setUiThemeMode,
+        setCompanionVrmPowerMode,
+        setCompanionAnimateWhenHidden,
+        setCompanionHalfFramerateMode,
+        handleStart,
+        handleStop,
+        handleRestart,
+        handleReset,
+        handleResetAppliedFromMain,
+        retryStartup,
+        dismissRestartBanner,
+        showRestartBanner,
+        triggerRestart,
+        relaunchDesktop,
+        dismissBackendDisconnectedBanner,
+        retryBackendConnection,
+        restartBackend,
+        dismissSystemWarning,
+        showActionBanner,
+        dismissActionBanner,
+        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,
+        handleFirstRunNext,
+        handleFirstRunBack,
+        handleFirstRunJumpToStep,
+        goToFirstRunStep,
+        handleFirstRunRemoteConnect,
+        handleFirstRunUseLocalBackend,
+        completeFirstRun,
+        handleCloudLogin,
+        handleCloudDisconnect,
+        switchAgentProfile,
+        handleCloudFirstRunFinish,
+        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,
+        analysisMode,
+        setAnalysisMode,
+    ]);
+    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 })] }) }) }) }) }) }) }));
+}