@elizaos/ui 2.0.3-beta.2 → 2.0.3-beta.3

package/state/AppContext.js

@@ -19,12 +19,16 @@ 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 { publishAppValue, seedAppValue } from "./app-store.js";
 import { ChatComposerCtx, ChatInputRefCtx, clearAllChatDrafts, useChatComposerDraftPersistence, } from "./ChatComposerContext.hooks.js";
+import { ChatTurnStatusCtx } from "./ChatTurnStatusContext.hooks.js";
 import { CompanionSceneConfigCtx } from "./CompanionSceneConfigContext.hooks.js";
+import { ConversationMessagesCtx } from "./ConversationMessagesContext.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 { isTrustedRestoreApiBaseUrl } from "./startup-phase-restore.js";
 import { useTranslation } from "./TranslationContext.hooks.js";
 import { TranslationProvider } from "./TranslationProvider.js";
 import { useAppLifecycleEvents } from "./useAppLifecycleEvents.js";
@@ -75,7 +79,7 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
     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;
+    const { state: { uiTheme, uiThemeMode, companionVrmPowerMode, companionAnimateWhenHidden, companionHalfFramerateMode, backgroundConfig, canUndoBackground, }, setUiTheme, setUiThemeMode, setCompanionVrmPowerMode, setCompanionAnimateWhenHidden, setCompanionHalfFramerateMode, setBackgroundConfig, undoBackgroundConfig, } = displayPrefs;
     // Apply the host app's brand theme (set via BrandingConfig.theme).
     const brandTheme = brandingOverride?.theme;
     useEffect(() => {
@@ -85,7 +89,7 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
     }, [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;
+    const { state: { connected, agentStatus, cloudHandoffPhase, 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;
@@ -132,7 +136,12 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
     // 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 { state: { chatInput, chatSending, chatFirstTokenReceived, chatLastUsage, chatAvatarVisible, chatAgentVoiceMuted, chatAvatarSpeaking, conversations, activeConversationId, companionMessageCutoffTs, conversationMessages, 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;
+    // Live server-reported phase of the in-flight assistant turn (rich status
+    // indicator, #8813). Held outside the giant AppContext value (in its own
+    // ChatTurnStatusCtx, like conversationMessages) so the per-status-event
+    // updates re-render only the chat surfaces, not all ~135 useApp() subscribers.
+    const [serverTurnStatus, setServerTurnStatus] = useState(null);
     const _chatComposerTextareaRef = useRef(null);
     // addUnread / removeUnread wrappers for old setUnreadConversations patterns.
     // Read current unreadConversations through a ref so this callback stays
@@ -364,7 +373,7 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         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;
+    const { fetchAutonomyReplay, appendAutonomousEvent, loadConversations, loadConversationMessages, prefetchConversationMessages, 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
@@ -384,6 +393,7 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         setChatInput,
         setChatSending,
         setChatFirstTokenReceived,
+        setServerTurnStatus,
         setChatLastUsage,
         setChatPendingImages,
         setConversations,
@@ -419,6 +429,7 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         resetBackendConnection,
         loadConversations,
         loadConversationMessages,
+        prefetchConversationMessages,
         loadPlugins,
         elizaCloudEnabled,
         elizaCloudConnected,
@@ -834,6 +845,14 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         const profile = loadAgentProfileRegistry().profiles.find((p) => p.id === profileId);
         if (!profile)
             return;
+        // The profile registry is persisted in localStorage, so a tampered/
+        // attacker-written profile could point a "remote" agent at an untrusted
+        // host. Refuse to switch to (and dial / send the bearer token to) such a
+        // profile — same trust gate the boot-restore path uses.
+        if (profile.kind === "remote" &&
+            !isTrustedRestoreApiBaseUrl(profile.apiBase)) {
+            return;
+        }
         setActiveProfileId(profileId);
         // Conversation ids are per-account, so saved drafts from the old
         // profile would re-attach to whatever conversation happens to land
@@ -949,14 +968,33 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
     // 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
+    // conversationMessages lives in ConversationMessagesContext so per-token
+    // streaming updates re-render only the chat surfaces (ChatView + the shell
+    // controller behind ContinuousChatOverlay) instead of cascading through
+    // AppContext to all ~135 useApp() subscribers.
+    const removeConversationMessage = useCallback((messageId) => {
+        setConversationMessages((prev) => prev.filter((message) => message.id !== messageId));
+    }, [setConversationMessages]);
+    const conversationMessagesValue = useMemo(() => ({ conversationMessages, removeConversationMessage }), [conversationMessages, removeConversationMessage]);
+    // Live assistant-turn status (rich status indicator) lives in its own context
+    // for the same isolation reason as conversationMessages above. setServerTurnStatus
+    // is a stable useState setter, so the value identity only changes when the
+    // status itself changes.
+    const chatTurnStatusValue = useMemo(() => ({ serverTurnStatus, setServerTurnStatus }), [serverTurnStatus]);
+    // High-write-frequency state is exposed through narrow fresh contexts below.
+    // AppContext keeps stale compatibility copies for older consumers, but they
+    // intentionally stay out of the dependency list so per-keystroke/per-token/
+    // per-poll updates do not fan out to every AppContext subscriber.
+    const appContextHotCompatibility = useRef({
+        autonomousEvents: [],
+        autonomousLatestEventId: null,
+        autonomousRunHealthByRunId: {},
+        chatInput: "",
+        chatPendingImages: [],
+        chatSending: false,
+        conversationMessages: [],
+        ptySessions: [],
+    }).current;
     const value = useMemo(() => ({
         // Translations
         t,
@@ -966,11 +1004,14 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         uiLanguage,
         uiTheme,
         uiThemeMode,
+        backgroundConfig,
+        canUndoBackground,
         companionVrmPowerMode,
         companionAnimateWhenHidden,
         companionHalfFramerateMode,
         connected,
         agentStatus,
+        cloudHandoffPhase,
         firstRunComplete,
         firstRunUiRevealNonce,
         firstRunLoading,
@@ -993,9 +1034,6 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         pairingCodeInput,
         pairingError,
         pairingBusy,
-        // chatInput/chatSending/chatPendingImages are stale here — read via useChatComposer()
-        chatInput,
-        chatSending,
         chatFirstTokenReceived,
         chatLastUsage,
         chatAvatarVisible,
@@ -1004,11 +1042,7 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         conversations,
         activeConversationId,
         companionMessageCutoffTs,
-        conversationMessages,
-        autonomousEvents,
-        autonomousLatestEventId,
-        autonomousRunHealthByRunId,
-        ptySessions,
+        ...appContextHotCompatibility,
         unreadConversations,
         triggers,
         triggersLoaded,
@@ -1226,7 +1260,6 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         mcpHeaderInputs,
         droppedFiles,
         shareIngestNotice,
-        chatPendingImages,
         analysisMode,
         setAnalysisMode,
         appRuns,
@@ -1260,6 +1293,8 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         setUiLanguage,
         setUiTheme,
         setUiThemeMode,
+        setBackgroundConfig,
+        undoBackgroundConfig,
         setCompanionVrmPowerMode,
         setCompanionAnimateWhenHidden,
         setCompanionHalfFramerateMode,
@@ -1388,11 +1423,14 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         uiLanguage,
         uiTheme,
         uiThemeMode,
+        backgroundConfig,
+        canUndoBackground,
         companionVrmPowerMode,
         companionAnimateWhenHidden,
         companionHalfFramerateMode,
         connected,
         agentStatus,
+        cloudHandoffPhase,
         firstRunComplete,
         firstRunUiRevealNonce,
         firstRunLoading,
@@ -1422,10 +1460,17 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         conversations,
         activeConversationId,
         companionMessageCutoffTs,
-        conversationMessages,
-        autonomousEvents,
-        autonomousLatestEventId,
-        autonomousRunHealthByRunId,
+        appContextHotCompatibility,
+        // NOTE: conversationMessages intentionally EXCLUDED — it gets a new array
+        // reference on every streamed token. Provided fresh via
+        // ConversationMessagesCtx (useConversationMessages()); the copy left in the
+        // value object is stale and unread.
+        // NOTE: autonomousEvents/autonomousLatestEventId/autonomousRunHealthByRunId
+        // intentionally EXCLUDED — they update on every heartbeat/agent/proactive WS
+        // event but no component reads them from useApp() (readers use the *Ref handles
+        // off useChatState). A stale copy remains in the value object purely to satisfy
+        // the AppContextValue type; excluding them from deps stops the heartbeat stream
+        // from re-rendering all AppContext subscribers.
         // NOTE: ptySessions intentionally EXCLUDED — provided fresh via PtySessionsCtx.
         unreadConversations,
         triggers,
@@ -1675,6 +1720,8 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         setUiLanguage,
         setUiTheme,
         setUiThemeMode,
+        setBackgroundConfig,
+        undoBackgroundConfig,
         setCompanionVrmPowerMode,
         setCompanionAnimateWhenHidden,
         setCompanionHalfFramerateMode,
@@ -1791,19 +1838,25 @@ function AppProviderInner({ children, branding: brandingOverride, }) {
         setActionNotice,
         setState,
         copyToClipboard,
-        chatPendingImages,
         setChatPendingImages,
-        chatSending,
-        ptySessions, // chatInput/chatSending/chatPendingImages are stale here — read via useChatComposer()
-        chatInput,
         analysisMode,
         setAnalysisMode,
     ]);
+    // Mirror the context value into the external selector store so useAppSelector
+    // consumers get field-level subscriptions (re-render only on the slice they
+    // read) instead of re-rendering on every context change. seedAppValue keeps
+    // the snapshot fresh during this render (the provider renders before its
+    // children, so no null-window); publishAppValue notifies subscribers from a
+    // commit-time effect (never a setState-during-render).
+    seedAppValue(value);
+    useEffect(() => {
+        publishAppValue(value);
+    }, [value]);
     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 })] }) }) }) }) }) }) }));
+    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(ConversationMessagesCtx.Provider, { value: conversationMessagesValue, children: _jsx(ChatTurnStatusCtx.Provider, { value: chatTurnStatusValue, 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 })] }) }) }) }) }) }) }) }) }));
 }

package/state/ChatComposerContext.hooks.d.ts

@@ -11,7 +11,7 @@
  * the sibling .tsx) so the Provider file stays React Fast Refresh-compatible.
  */
 import { type Dispatch, type RefObject, type SetStateAction } from "react";
-import type { ImageAttachment } from "../api";
+import type { ImageAttachment } from "../api/index.js";
 export interface ChatComposerValue {
     chatInput: string;
     chatSending: boolean;

package/state/ChatTurnStatusContext.hooks.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ChatTurnStatusContext — isolated context for the live, server-reported phase
+ * of the in-flight assistant turn (the rich status indicator, issue #8813).
+ *
+ * The server streams additive `{ type: "status" }` SSE events (thinking →
+ * streaming / running_action → …) during a turn. They arrive faster than the
+ * coarse `chatSending` boolean and carry detail (which action is running) that a
+ * boolean can't. Keeping the live status in its own context — like
+ * ConversationMessagesContext — means only the chat surfaces re-render as status
+ * events land, never the ~135 useApp() subscribers.
+ *
+ * The provider holds `serverTurnStatus`: the latest server status for the
+ * current turn, or null between turns. `useShellController` reads it and folds
+ * it together with its client-derived signals (thinking / streaming / speaking /
+ * waking) into the single `turnStatus` the overlay renders.
+ */
+import type { ChatTurnStatus } from "../api/index.js";
+export interface ChatTurnStatusValue {
+    /** Latest server-streamed status for the active turn, or null between turns. */
+    serverTurnStatus: ChatTurnStatus | null;
+    /** Set the live server status (called from the chat-send SSE `onStatus`),
+     *  or clear it (null) when a turn ends. */
+    setServerTurnStatus: (status: ChatTurnStatus | null) => void;
+}
+export declare const ChatTurnStatusCtx: import("react").Context<ChatTurnStatusValue>;
+export declare function useChatTurnStatus(): ChatTurnStatusValue;
+//# sourceMappingURL=ChatTurnStatusContext.hooks.d.ts.map

package/state/ChatTurnStatusContext.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatTurnStatusContext.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/state/ChatTurnStatusContext.hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,gBAAgB,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC;+CAC2C;IAC3C,mBAAmB,EAAE,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAC;CAC9D;AAED,eAAO,MAAM,iBAAiB,8CAG5B,CAAC;AAEH,wBAAgB,iBAAiB,IAAI,mBAAmB,CAEvD"}

package/state/ChatTurnStatusContext.hooks.js

@@ -0,0 +1,24 @@
+/**
+ * ChatTurnStatusContext — isolated context for the live, server-reported phase
+ * of the in-flight assistant turn (the rich status indicator, issue #8813).
+ *
+ * The server streams additive `{ type: "status" }` SSE events (thinking →
+ * streaming / running_action → …) during a turn. They arrive faster than the
+ * coarse `chatSending` boolean and carry detail (which action is running) that a
+ * boolean can't. Keeping the live status in its own context — like
+ * ConversationMessagesContext — means only the chat surfaces re-render as status
+ * events land, never the ~135 useApp() subscribers.
+ *
+ * The provider holds `serverTurnStatus`: the latest server status for the
+ * current turn, or null between turns. `useShellController` reads it and folds
+ * it together with its client-derived signals (thinking / streaming / speaking /
+ * waking) into the single `turnStatus` the overlay renders.
+ */
+import { createContext, useContext } from "react";
+export const ChatTurnStatusCtx = createContext({
+    serverTurnStatus: null,
+    setServerTurnStatus: () => { },
+});
+export function useChatTurnStatus() {
+    return useContext(ChatTurnStatusCtx);
+}

package/state/CompanionSceneConfigContext.hooks.d.ts

@@ -10,9 +10,9 @@
  * one of its 7 fields actually changes. The context object + hook live here (not
  * in the sibling .tsx) so the Provider file stays React Fast Refresh-compatible.
  */
-import type { Tab } from "../navigation";
-import type { UiTheme } from "./persistence";
-import type { CompanionHalfFramerateMode, CompanionVrmPowerMode } from "./types";
+import type { Tab } from "../navigation/index.js";
+import type { UiTheme } from "./persistence.js";
+import type { CompanionHalfFramerateMode, CompanionVrmPowerMode } from "./types.js";
 export interface CompanionSceneConfig {
     selectedVrmIndex: number;
     customVrmUrl: string;

package/state/ConversationMessagesContext.hooks.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ConversationMessagesContext — isolated context for the active conversation's
+ * message list.
+ *
+ * conversationMessages gets a new array reference on every streamed token while
+ * the agent is responding. Keeping it in the giant AppContext value would
+ * cascade those per-token updates to every useApp() subscriber (~135 of them:
+ * sidebars, settings panels, the companion overlay, etc.). This dedicated
+ * context lets only the chat surfaces (ChatView and the shell controller that
+ * drives ContinuousChatOverlay) re-render as tokens arrive.
+ *
+ * The context object + hook live here (not in the sibling AppContext.tsx) so the
+ * Provider file stays React Fast Refresh-compatible.
+ */
+import type { ConversationMessage } from "../api/index.js";
+export interface ConversationMessagesValue {
+    conversationMessages: ConversationMessage[];
+    /**
+     * Remove a single message from the live transcript by id (#8792). Used to
+     * dismiss a proactive suggestion locally without a server round-trip.
+     */
+    removeConversationMessage: (messageId: string) => void;
+}
+export declare const ConversationMessagesCtx: import("react").Context<ConversationMessagesValue>;
+export declare function useConversationMessages(): ConversationMessagesValue;
+//# sourceMappingURL=ConversationMessagesContext.hooks.d.ts.map

package/state/ConversationMessagesContext.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationMessagesContext.hooks.d.ts","sourceRoot":"","sources":["../../../../../src/state/ConversationMessagesContext.hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAElD,MAAM,WAAW,yBAAyB;IACxC,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C;;;OAGG;IACH,yBAAyB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACxD;AAED,eAAO,MAAM,uBAAuB,oDAKnC,CAAC;AAEF,wBAAgB,uBAAuB,IAAI,yBAAyB,CAEnE"}

package/state/ConversationMessagesContext.hooks.js

@@ -0,0 +1,22 @@
+/**
+ * ConversationMessagesContext — isolated context for the active conversation's
+ * message list.
+ *
+ * conversationMessages gets a new array reference on every streamed token while
+ * the agent is responding. Keeping it in the giant AppContext value would
+ * cascade those per-token updates to every useApp() subscriber (~135 of them:
+ * sidebars, settings panels, the companion overlay, etc.). This dedicated
+ * context lets only the chat surfaces (ChatView and the shell controller that
+ * drives ContinuousChatOverlay) re-render as tokens arrive.
+ *
+ * The context object + hook live here (not in the sibling AppContext.tsx) so the
+ * Provider file stays React Fast Refresh-compatible.
+ */
+import { createContext, useContext } from "react";
+export const ConversationMessagesCtx = createContext({
+    conversationMessages: [],
+    removeConversationMessage: () => { },
+});
+export function useConversationMessages() {
+    return useContext(ConversationMessagesCtx);
+}

package/state/PtySessionsContext.hooks.d.ts

@@ -9,7 +9,7 @@
  * The context object + hook live here (not in the sibling .tsx) so the
  * Provider file stays React Fast Refresh-compatible.
  */
-import type { CodingAgentSession } from "../api/client";
+import type { CodingAgentSession } from "../api/client.js";
 export interface PtySessionsValue {
     ptySessions: CodingAgentSession[];
 }

package/state/TranslationContext.hooks.d.ts

@@ -9,7 +9,7 @@
  * .tsx) so the `TranslationProvider` component file stays React Fast
  * Refresh-compatible.
  */
-import { type UiLanguage } from "../i18n";
+import { type UiLanguage } from "../i18n/index.js";
 export interface TranslationContextValue {
     /** Translate a key, optionally with interpolation values. */
     t: (key: string, values?: Record<string, unknown>) => string;

package/state/TranslationProvider.d.ts

@@ -6,8 +6,8 @@
  * component and stays React Fast Refresh-compatible.
  */
 import { type ReactNode } from "react";
-import { type BrandingConfig } from "../config/branding";
-import { type UiLanguage } from "../i18n";
+import { type BrandingConfig } from "../config/branding.js";
+import { type UiLanguage } from "../i18n/index.js";
 export declare function TranslationProvider({ children, onLanguageSyncError, branding, }: {
     children: ReactNode;
     /** Optional callback when the server config sync fails. */

package/state/action-notice.d.ts

@@ -1,7 +1,37 @@
+import type { NotificationPriority } from "@elizaos/core";
+/** The three visual tones a transient shell toast can render in. */
+export type ActionTone = "info" | "success" | "error";
 export interface ActionNotice {
-    tone: string;
+    tone: ActionTone;
     text: string;
     /** When true, ShellOverlays shows an indeterminate spinner (long-running work). */
     busy?: boolean;
 }
+/** Signature of the shell `setActionNotice` callback threaded through settings hooks. */
+export type ActionNoticeFn = (text: string, tone?: ActionTone, ttlMs?: number, once?: boolean, busy?: boolean) => void;
+/**
+ * Canonical auto-dismiss windows for transient surfaces, in milliseconds.
+ *
+ * Previously these were scattered magic numbers — `setActionNotice`'s 2800ms
+ * default, the notification store's 4000/7000ms deliveries, and the system
+ * warning banner's 20000ms — with no shared definition. Collapsing them here is
+ * the single source of truth so the timings stay coherent across the shell.
+ */
+export declare const TOAST_TTL_MS: {
+    /** Default dwell for a plain `setActionNotice` (quick confirmations). */
+    readonly default: 2800;
+    /** A non-interruptive notification toast (normal/low priority). */
+    readonly notification: 4000;
+    /** An interruptive notification toast (high/urgent priority). */
+    readonly notificationInterruptive: 7000;
+    /** A system-warning banner — stays up long enough to be read + acted on. */
+    readonly systemWarning: 20000;
+};
+/**
+ * Map a notification's delivery priority to its toast tone. `urgent` surfaces as
+ * an error tone (red, demands attention); everything else is informational.
+ * This is the one place priority→tone is decided so the inbox, the toast, and
+ * any future surface agree.
+ */
+export declare function toastToneForPriority(priority: NotificationPriority): ActionTone;
 //# sourceMappingURL=action-notice.d.ts.map

package/state/action-notice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-notice.d.ts","sourceRoot":"","sources":["../../../../../src/state/action-notice.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}
+{"version":3,"file":"action-notice.d.ts","sourceRoot":"","sources":["../../../../../src/state/action-notice.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,oEAAoE;AACpE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,UAAU,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EACd,IAAI,CAAC,EAAE,OAAO,KACX,IAAI,CAAC;AAEV;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;IACvB,yEAAyE;;IAEzE,mEAAmE;;IAEnE,iEAAiE;;IAEjE,4EAA4E;;CAEpE,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,oBAAoB,GAC7B,UAAU,CAEZ"}

package/state/action-notice.js

@@ -1 +1,27 @@
-export {};
+/**
+ * Canonical auto-dismiss windows for transient surfaces, in milliseconds.
+ *
+ * Previously these were scattered magic numbers — `setActionNotice`'s 2800ms
+ * default, the notification store's 4000/7000ms deliveries, and the system
+ * warning banner's 20000ms — with no shared definition. Collapsing them here is
+ * the single source of truth so the timings stay coherent across the shell.
+ */
+export const TOAST_TTL_MS = {
+    /** Default dwell for a plain `setActionNotice` (quick confirmations). */
+    default: 2800,
+    /** A non-interruptive notification toast (normal/low priority). */
+    notification: 4000,
+    /** An interruptive notification toast (high/urgent priority). */
+    notificationInterruptive: 7000,
+    /** A system-warning banner — stays up long enough to be read + acted on. */
+    systemWarning: 20_000,
+};
+/**
+ * Map a notification's delivery priority to its toast tone. `urgent` surfaces as
+ * an error tone (red, demands attention); everything else is informational.
+ * This is the one place priority→tone is decided so the inbox, the toast, and
+ * any future surface agree.
+ */
+export function toastToneForPriority(priority) {
+    return priority === "urgent" ? "error" : "info";
+}

package/state/agent-profiles.d.ts

@@ -4,13 +4,21 @@
  * Stores a catalogue of known agent connections (local, cloud, remote) in
  * localStorage so users can manage and switch between multiple agents.
  */
-import type { AgentProfile, AgentProfileRegistry } from "./agent-profile-types";
-export type { AgentProfile, AgentProfileRegistry } from "./agent-profile-types";
+import type { AgentProfile, AgentProfileRegistry } from "./agent-profile-types.js";
+export type { AgentProfile, AgentProfileRegistry } from "./agent-profile-types.js";
 export declare function loadAgentProfileRegistry(): AgentProfileRegistry;
 export declare function saveAgentProfileRegistry(registry: AgentProfileRegistry): void;
 export declare function getActiveProfile(): AgentProfile | null;
 export declare function setActiveProfileId(id: string): void;
 export declare function addAgentProfile(profile: Omit<AgentProfile, "id" | "createdAt">): AgentProfile;
 export declare function removeAgentProfile(id: string): void;
+/**
+ * Drop the bearer access token from every persisted agent profile while keeping
+ * the rest of each profile (label/kind/apiBase/active selection). Call this on
+ * sign-out: the token is a JWT and leaving copies in localStorage after sign-out
+ * is an at-rest leak, but clearing the whole registry would needlessly forget
+ * which backends to re-authenticate against.
+ */
+export declare function scrubPersistedAgentProfileTokens(): void;
 export declare function updateAgentProfile(id: string, updates: Partial<Omit<AgentProfile, "id" | "createdAt">>): void;
 //# sourceMappingURL=agent-profiles.d.ts.map

package/state/agent-profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-profiles.d.ts","sourceRoot":"","sources":["../../../../../src/state/agent-profiles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGhF,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AA+DhF,wBAAgB,wBAAwB,IAAI,oBAAoB,CAY/D;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAI7E;AAED,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAMtD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKnD;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,CAAC,GAC9C,YAAY,CAWd;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAOnD;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,CAAC,CAAC,GACvD,IAAI,CAMN"}
+{"version":3,"file":"agent-profiles.d.ts","sourceRoot":"","sources":["../../../../../src/state/agent-profiles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGhF,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AA+DhF,wBAAgB,wBAAwB,IAAI,oBAAoB,CAY/D;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAI7E;AAED,wBAAgB,gBAAgB,IAAI,YAAY,GAAG,IAAI,CAMtD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAKnD;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,CAAC,GAC9C,YAAY,CAWd;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAOnD;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,IAAI,IAAI,CAUvD;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,CAAC,CAAC,GACvD,IAAI,CAMN"}

package/state/agent-profiles.js

@@ -108,6 +108,26 @@ export function removeAgentProfile(id) {
     }
     saveAgentProfileRegistry(registry);
 }
+/**
+ * Drop the bearer access token from every persisted agent profile while keeping
+ * the rest of each profile (label/kind/apiBase/active selection). Call this on
+ * sign-out: the token is a JWT and leaving copies in localStorage after sign-out
+ * is an at-rest leak, but clearing the whole registry would needlessly forget
+ * which backends to re-authenticate against.
+ */
+export function scrubPersistedAgentProfileTokens() {
+    const registry = loadAgentProfileRegistry();
+    let changed = false;
+    registry.profiles = registry.profiles.map((profile) => {
+        if (!profile.accessToken)
+            return profile;
+        changed = true;
+        const { accessToken, ...rest } = profile;
+        return rest;
+    });
+    if (changed)
+        saveAgentProfileRegistry(registry);
+}
 export function updateAgentProfile(id, updates) {
     const registry = loadAgentProfileRegistry();
     const idx = registry.profiles.findIndex((p) => p.id === id);

package/state/agent-runtime-target.d.ts

@@ -1,5 +1,5 @@
-import { type MobileRuntimeMode } from "../first-run/mobile-runtime-mode";
-import type { PersistedActiveServer } from "./persistence";
+import { type MobileRuntimeMode } from "../first-run/mobile-runtime-mode.js";
+import type { PersistedActiveServer } from "./persistence.js";
 export type AgentRuntimeTargetKind = "local" | "cloud" | "remote";
 export interface AgentRuntimeTarget {
     kind: AgentRuntimeTargetKind;

package/state/app-store.d.ts

@@ -0,0 +1,52 @@
+/**
+ * App selector store — a `useSyncExternalStore`-backed mirror of the AppContext
+ * value that gives consumers FIELD-LEVEL subscriptions.
+ *
+ * The problem it solves: `useApp()` returns one monolithic context value
+ * (~300 fields). Plain `useContext` re-renders every consumer whenever ANY field
+ * changes. `useAppSelector(s => s.tab)` re-renders only when the *selected* slice
+ * changes, killing the monolithic-context re-render class without a new
+ * dependency (`useSyncExternalStore` is a React built-in / peer dep).
+ *
+ * Wiring (done once, in AppContext): `seedAppValue(value)` is called during the
+ * provider's render so the snapshot is fresh before any child reads it (no
+ * null-window on mount, since the provider renders top-down before its
+ * children), and `publishAppValue(value)` is called from a commit-time effect so
+ * subscribers are notified *after* render (never a setState-during-render).
+ *
+ * Singleton: the store hangs off `globalThis` (same trick as `useApp.ts`) so a
+ * single instance is shared across the host app and externalized plugin view
+ * bundles, which resolve `@elizaos/ui`/`react` to the host singletons.
+ *
+ * Migration seam: consumers can move from `useApp()` to `useAppSelector` one
+ * file at a time. The store backing can later be swapped (e.g. to zustand)
+ * behind this hook with zero consumer churn.
+ */
+import type { AppContextValue } from "./internal.js";
+/**
+ * Keep the snapshot fresh during the provider's render (top-down, before any
+ * child reads it). Render-safe: it only writes a module field, never notifies.
+ */
+export declare function seedAppValue(value: AppContextValue): void;
+/**
+ * Notify subscribers of a new value. Call this from a commit-time effect so the
+ * notification (which schedules subscriber re-renders) never runs during render.
+ */
+export declare function publishAppValue(value: AppContextValue): void;
+declare function shallowEqual(a: unknown, b: unknown): boolean;
+/**
+ * Subscribe to a slice of the AppContext value. Re-renders only when the
+ * selected value changes per `isEqual` (default `Object.is`). For object/array
+ * selections, pass `shallowEqual` (or use {@link useAppSelectorShallow}) so a
+ * fresh-but-equal object reference does not force a re-render.
+ *
+ * Prefer a stable (module-level or `useCallback`'d) selector; an inline selector
+ * still works correctly (the snapshot is memoized in a ref).
+ */
+export declare function useAppSelector<T>(selector: (value: AppContextValue) => T, isEqual?: (a: T, b: T) => boolean): T;
+/** {@link useAppSelector} with shallow equality — use for object/array slices. */
+export declare function useAppSelectorShallow<T>(selector: (value: AppContextValue) => T): T;
+/** Test-only: seed the store and notify subscribers (mirrors a publish). */
+export declare function __setAppValueForTests(value: AppContextValue | null): void;
+export { shallowEqual as __appShallowEqual };
+//# sourceMappingURL=app-store.d.ts.map