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

package/state/useDataLoaders.js

@@ -40,6 +40,11 @@ function buildLocalizedCharacterPayload(preset, name) {
         postExamples: [...preset.postExamples],
     };
 }
+// ── Hook deps ─────────────────────────────────────────────────────────────
+// Upper bound on the in-memory conversation-message prefetch cache. Holds the
+// active conversation plus several neighbors in each swipe direction; oldest
+// entries are evicted first.
+const CONVERSATION_MESSAGE_CACHE_MAX = 16;
 // ── Hook ──────────────────────────────────────────────────────────────────
 export function useDataLoaders(deps) {
     const { autonomousStoreRef, autonomousEventsRef, autonomousLatestEventIdRef, autonomousRunHealthByRunIdRef, autonomousReplayInFlightRef, setAutonomousEvents, setAutonomousLatestEventId, setAutonomousRunHealthByRunId, activeConversationIdRef, conversationMessagesRef, greetingFiredRef, setConversations, setActiveConversationId, setConversationMessages, loadWalletConfig, agentStatus, characterData, characterDraft, loadCharacter, selectedVrmIndex, firstRunComplete, uiLanguage, setOwnerNameState, } = deps;
@@ -68,6 +73,7 @@ export function useDataLoaders(deps) {
         setAutonomousLatestEventId,
         setAutonomousRunHealthByRunId,
     ]);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: autonomousStoreRef is a ref — its .current is read at call-time (always latest) and must NOT be a dependency, or this callback's identity churns on every autonomy merge and cascades into useStartupCoordinator's deps.
     const fetchAutonomyReplay = useCallback(async () => {
         if (autonomousReplayInFlightRef.current)
             return;
@@ -109,11 +115,13 @@ export function useDataLoaders(deps) {
         finally {
             autonomousReplayInFlightRef.current = false;
         }
+        // autonomousStoreRef.current is read at call-time inside the body — a ref
+        // read is always latest, so it must NOT be a dep (it would churn this
+        // callback's identity, cascading into useStartupCoordinator's deps).
     }, [
         applyAutonomyEventMerge,
         autonomousReplayInFlightRef,
         autonomousRunHealthByRunIdRef,
-        autonomousStoreRef.current,
         setAutonomousRunHealthByRunId,
     ]);
     const appendAutonomousEvent = useCallback((event) => {
@@ -123,6 +131,29 @@ export function useDataLoaders(deps) {
         }
     }, [applyAutonomyEventMerge, fetchAutonomyReplay]);
     // ── Conversations ───────────────────────────────────────────────────
+    // Prefetch cache: conversationId → its filtered messages. Adjacent
+    // conversations are warmed on every select (prefetchConversationMessages) so a
+    // horizontal swipe paints the thread instantly from memory instead of waiting
+    // on the network. Capped (LRU-ish via Map insertion order) so it can't grow
+    // without bound as the user swipes through a long history.
+    const conversationMessageCacheRef = useRef(new Map());
+    // Abort the prior in-flight active-conversation load when a newer one starts:
+    // a fast swipe stacks selects, and only the latest should win the thread.
+    const activeMessageLoadAbortRef = useRef(null);
+    // Per-id prefetch aborts so a neighbor is never double-fetched.
+    const prefetchAbortRef = useRef(new Map());
+    const cacheConversationMessages = useCallback((id, messages) => {
+        const cache = conversationMessageCacheRef.current;
+        // Re-insert to move to the most-recent position (eviction is oldest-first).
+        cache.delete(id);
+        cache.set(id, messages);
+        while (cache.size > CONVERSATION_MESSAGE_CACHE_MAX) {
+            const oldest = cache.keys().next().value;
+            if (oldest === undefined)
+                break;
+            cache.delete(oldest);
+        }
+    }, []);
     const loadConversations = useCallback(async () => {
         try {
             const { conversations: c } = await client.listConversations();
@@ -135,9 +166,30 @@ export function useDataLoaders(deps) {
         }
     }, [setConversations]);
     const loadConversationMessages = useCallback(async (convId) => {
+        // A newer active-conversation load supersedes any prior in-flight one so a
+        // rapid swipe doesn't let an older fetch clobber the latest thread.
+        activeMessageLoadAbortRef.current?.abort();
+        const controller = new AbortController();
+        activeMessageLoadAbortRef.current = controller;
+        const { signal } = controller;
+        // Instant paint from the prefetch cache (a swiped-to neighbor) so the
+        // thread never flashes empty mid-swipe; the fetch below still revalidates.
+        const cached = conversationMessageCacheRef.current.get(convId);
+        if (cached) {
+            greetingFiredRef.current = hasConversationBootstrapMessage(cached);
+            conversationMessagesRef.current = cached;
+            setConversationMessages(cached);
+        }
         try {
-            const { messages } = await client.getConversationMessages(convId);
+            const { messages } = await client.getConversationMessages(convId, {
+                signal,
+            });
+            // Superseded by a newer load while in flight — let the newer one own the
+            // thread instead of committing this stale result.
+            if (signal.aborted)
+                return { ok: true };
             const nextMessages = filterRenderableConversationMessages(messages);
+            cacheConversationMessages(convId, nextMessages);
             greetingFiredRef.current =
                 hasConversationBootstrapMessage(nextMessages);
             conversationMessagesRef.current = nextMessages;
@@ -145,6 +197,12 @@ export function useDataLoaders(deps) {
             return { ok: true };
         }
         catch (err) {
+            // A newer load aborted this one (fast swipe); the newer load owns the
+            // thread, so report success and let the caller skip its error path.
+            if (signal.aborted ||
+                err.name === "AbortError") {
+                return { ok: true };
+            }
             const status = err.status;
             if (status === 404) {
                 const refreshed = await client.listConversations().catch(() => null);
@@ -161,7 +219,9 @@ export function useDataLoaders(deps) {
                     setActiveConversationId(null);
                     activeConversationIdRef.current = null;
                 }
-                // The conversation is definitively gone (404) — clear the thread.
+                // The conversation is definitively gone (404) — clear the thread and
+                // drop any stale cache entry so a later swipe can't resurrect it.
+                conversationMessageCacheRef.current.delete(convId);
                 greetingFiredRef.current = false;
                 conversationMessagesRef.current = [];
                 setConversationMessages([]);
@@ -170,8 +230,11 @@ export function useDataLoaders(deps) {
             // wipe the thread. The message store is reused as the on-screen history,
             // and blanking it on a flaky-connection reload looked like the app ate
             // the entire conversation (the data is still server-side; a later reload
-            // restores it). Keep the existing messages and let the caller surface a
-            // transient error instead.
+            // restores it). If we already painted from the prefetch cache, the user
+            // is looking at usable (if slightly stale) content, so treat the failed
+            // revalidation as a soft success rather than surfacing an error over it.
+            if (cached && status !== 404)
+                return { ok: true };
             return {
                 ok: false,
                 status,
@@ -182,12 +245,42 @@ export function useDataLoaders(deps) {
         }
     }, [
         activeConversationIdRef,
+        cacheConversationMessages,
         conversationMessagesRef,
         greetingFiredRef,
         setActiveConversationId,
         setConversationMessages,
         setConversations,
     ]);
+    // Warm the prefetch cache for adjacent conversations so a horizontal swipe
+    // paints instantly. Best-effort + abortable: an id already cached or already
+    // in flight is skipped, and a miss just means the eventual select does a
+    // normal (spinner-backed) load.
+    const prefetchConversationMessages = useCallback((ids) => {
+        for (const id of ids) {
+            if (!id)
+                continue;
+            if (conversationMessageCacheRef.current.has(id))
+                continue;
+            if (prefetchAbortRef.current.has(id))
+                continue;
+            const controller = new AbortController();
+            prefetchAbortRef.current.set(id, controller);
+            void client
+                .getConversationMessages(id, { signal: controller.signal })
+                .then(({ messages }) => {
+                if (controller.signal.aborted)
+                    return;
+                cacheConversationMessages(id, filterRenderableConversationMessages(messages));
+            })
+                .catch(() => {
+                // Prefetch is opportunistic warming; ignore failures.
+            })
+                .finally(() => {
+                prefetchAbortRef.current.delete(id);
+            });
+        }
+    }, [cacheConversationMessages]);
     // ── BSC trade / steward wrappers ────────────────────────────────────
     const getBscTradePreflight = useCallback(async (tokenAddress) => client.getBscTradePreflight(tokenAddress), []);
     const getBscTradeQuote = useCallback(async (request) => client.getBscTradeQuote(request), []);
@@ -368,6 +461,7 @@ export function useDataLoaders(deps) {
         // Conversations
         loadConversations,
         loadConversationMessages,
+        prefetchConversationMessages,
         // BSC / Steward / Trading
         getBscTradePreflight,
         getBscTradeQuote,

package/state/useDeveloperMode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDeveloperMode.d.ts","sourceRoot":"","sources":["../../../../../src/state/useDeveloperMode.ts"],"names":[],"mappings":"AA+CA,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAKvD;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C"}
+{"version":3,"file":"useDeveloperMode.d.ts","sourceRoot":"","sources":["../../../../../src/state/useDeveloperMode.ts"],"names":[],"mappings":"AAkFA,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAOvD;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C"}

package/state/useDeveloperMode.js

@@ -1,23 +1,60 @@
 import { useSyncExternalStore } from "react";
 /**
- * Developer Mode state — when on, the shell renders apps, widgets, and
- * nav tabs marked `developerOnly: true` (logs viewer, trajectory viewer,
- * etc). Persists to localStorage so it survives reloads.
+ * Developer Mode state — when on, the shell renders apps, widgets, nav tabs,
+ * and settings marked `developerOnly: true` (logs viewer, trajectory viewer,
+ * raw config, etc). Persists to localStorage so it survives reloads.
+ *
+ * Default: ON in development builds, OFF in production — until the user sets it
+ * explicitly, after which their choice wins on every platform/build.
  */
 const STORAGE_KEY = "eliza:developerMode";
 const ENABLED = "1";
 const DISABLED = "0";
 const listeners = new Set();
+/** Build-default when the user hasn't chosen: dev builds on, production off. */
+function defaultDeveloperMode() {
+    try {
+        return Boolean(import.meta.env?.DEV);
+    }
+    catch {
+        return false;
+    }
+}
 function readStorage() {
     if (typeof window === "undefined")
-        return false;
+        return defaultDeveloperMode();
     try {
-        return window.localStorage.getItem(STORAGE_KEY) === ENABLED;
+        const raw = window.localStorage.getItem(STORAGE_KEY);
+        if (raw === ENABLED)
+            return true;
+        if (raw === DISABLED)
+            return false;
+        return defaultDeveloperMode();
     }
     catch {
-        return false;
+        return defaultDeveloperMode();
     }
 }
+/**
+ * Cached snapshot of the persisted value. `getSnapshot` runs on every render of
+ * every subscriber, so it must return a stable primitive without per-render
+ * localStorage I/O. The cache is seeded once and refreshed only when the value
+ * changes (via `setDeveloperMode` or a cross-tab `storage` event).
+ */
+let cachedEnabled = readStorage();
+if (typeof window !== "undefined") {
+    window.addEventListener("storage", (event) => {
+        if (event.key !== null && event.key !== STORAGE_KEY)
+            return;
+        const next = readStorage();
+        if (next === cachedEnabled)
+            return;
+        cachedEnabled = next;
+        for (const listener of listeners) {
+            listener();
+        }
+    });
+}
 function writeStorage(enabled) {
     if (typeof window === "undefined")
         return;
@@ -35,16 +72,19 @@ function subscribe(listener) {
     };
 }
 function getSnapshot() {
-    return readStorage();
+    return cachedEnabled;
 }
 function getServerSnapshot() {
     return false;
 }
 export function isDeveloperModeEnabled() {
-    return readStorage();
+    return cachedEnabled;
 }
 export function setDeveloperMode(enabled) {
     writeStorage(enabled);
+    if (enabled === cachedEnabled)
+        return;
+    cachedEnabled = enabled;
     for (const listener of listeners) {
         listener();
     }

package/state/useDisplayPreferences.d.ts

@@ -4,8 +4,8 @@
  * Extracted from AppContext. Each preference persists to localStorage
  * and normalizes on set.
  */
-import type { CompanionHalfFramerateMode, CompanionVrmPowerMode } from "./types";
-import type { UiTheme, UiThemeMode } from "./ui-preferences";
+import type { CompanionHalfFramerateMode, CompanionVrmPowerMode } from "./types.js";
+import { type BackgroundConfig, type UiTheme, type UiThemeMode } from "./ui-preferences.js";
 export declare function useDisplayPreferences(): {
     state: {
         uiTheme: UiTheme;
@@ -13,11 +13,15 @@ export declare function useDisplayPreferences(): {
         companionVrmPowerMode: CompanionVrmPowerMode;
         companionAnimateWhenHidden: boolean;
         companionHalfFramerateMode: CompanionHalfFramerateMode;
+        backgroundConfig: BackgroundConfig;
+        canUndoBackground: boolean;
     };
     setUiTheme: (theme: UiTheme) => void;
     setUiThemeMode: (mode: UiThemeMode) => void;
     setCompanionVrmPowerMode: (mode: CompanionVrmPowerMode) => void;
     setCompanionAnimateWhenHidden: (enabled: boolean) => void;
     setCompanionHalfFramerateMode: (mode: CompanionHalfFramerateMode) => void;
+    setBackgroundConfig: (config: BackgroundConfig) => void;
+    undoBackgroundConfig: () => void;
 };
 //# sourceMappingURL=useDisplayPreferences.d.ts.map

package/state/useDisplayPreferences.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useDisplayPreferences.d.ts","sourceRoot":"","sources":["../../../../../src/state/useDisplayPreferences.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,OAAO,KAAK,EACV,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE7D,wBAAgB,qBAAqB;;;;;;;;wBAoBzB,OAAO;2BANyB,WAAW;qCAa5C,qBAAqB;6CAM8B,OAAO;0CAK1D,0BAA0B;EA2DpC"}
+{"version":3,"file":"useDisplayPreferences.d.ts","sourceRoot":"","sources":["../../../../../src/state/useDisplayPreferences.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH,OAAO,KAAK,EACV,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,kBAAkB,CAAC;AAE1B,wBAAgB,qBAAqB;;;;;;;;;;wBAgCzB,OAAO;2BANyB,WAAW;qCAa5C,qBAAqB;6CAM8B,OAAO;0CAK1D,0BAA0B;kCASc,gBAAgB;;EAkFlE"}

package/state/useDisplayPreferences.js

@@ -4,14 +4,24 @@
  * Extracted from AppContext. Each preference persists to localStorage
  * and normalizes on set.
  */
-import { useCallback, useEffect, useState } from "react";
-import { applyUiTheme, getSystemTheme, loadCompanionAnimateWhenHidden, loadCompanionHalfFramerateMode, loadCompanionVrmPowerMode, loadUiThemeMode, normalizeCompanionHalfFramerateMode, normalizeCompanionVrmPowerMode, normalizeUiThemeMode, resolveUiTheme, saveCompanionAnimateWhenHidden, saveCompanionHalfFramerateMode, saveCompanionVrmPowerMode, saveUiTheme, saveUiThemeMode, } from "./persistence.js";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { applyUiTheme, getSystemTheme, loadBackgroundConfig, loadBackgroundHistory, loadCompanionAnimateWhenHidden, loadCompanionHalfFramerateMode, loadCompanionVrmPowerMode, loadUiThemeMode, MAX_BACKGROUND_HISTORY, normalizeBackgroundConfig, normalizeCompanionHalfFramerateMode, normalizeCompanionVrmPowerMode, normalizeUiThemeMode, resolveUiTheme, saveBackgroundConfig, saveBackgroundHistory, saveCompanionAnimateWhenHidden, saveCompanionHalfFramerateMode, saveCompanionVrmPowerMode, saveUiTheme, saveUiThemeMode, } from "./persistence.js";
+import { backgroundConfigsEqual, } from "./ui-preferences.js";
 export function useDisplayPreferences() {
     const [uiThemeMode, setUiThemeModeState] = useState(loadUiThemeMode);
     const [uiTheme, setUiThemeState] = useState(() => resolveUiTheme(loadUiThemeMode()));
     const [companionVrmPowerMode, setCompanionVrmPowerModeState] = useState(loadCompanionVrmPowerMode);
     const [companionAnimateWhenHidden, setCompanionAnimateWhenHiddenState] = useState(loadCompanionAnimateWhenHidden);
     const [companionHalfFramerateMode, setCompanionHalfFramerateModeState] = useState(loadCompanionHalfFramerateMode);
+    const [backgroundConfig, setBackgroundConfigState] = useState(loadBackgroundConfig);
+    // Bounded undo stack: the previous configs, most-recent last. Refs mirror the
+    // latest values so the set/undo callbacks stay identity-stable ([] deps) while
+    // never reading stale state.
+    const [backgroundHistory, setBackgroundHistoryState] = useState(loadBackgroundHistory);
+    const backgroundConfigRef = useRef(backgroundConfig);
+    backgroundConfigRef.current = backgroundConfig;
+    const backgroundHistoryRef = useRef(backgroundHistory);
+    backgroundHistoryRef.current = backgroundHistory;
     // Normalize + persist wrappers
     const setUiThemeMode = useCallback((mode) => {
         setUiThemeModeState(normalizeUiThemeMode(mode));
@@ -29,6 +39,24 @@ export function useDisplayPreferences() {
     const setCompanionHalfFramerateMode = useCallback((mode) => {
         setCompanionHalfFramerateModeState(normalizeCompanionHalfFramerateMode(mode));
     }, []);
+    // Setting pushes the outgoing config onto the undo stack (unless unchanged).
+    const setBackgroundConfig = useCallback((config) => {
+        const next = normalizeBackgroundConfig(config);
+        const prev = backgroundConfigRef.current;
+        if (backgroundConfigsEqual(prev, next))
+            return;
+        setBackgroundHistoryState((h) => [...h, prev].slice(-MAX_BACKGROUND_HISTORY));
+        setBackgroundConfigState(next);
+    }, []);
+    // Undo restores the most recent previous config and pops it off the stack.
+    // There is no redo — stepping back simply discards the undone config.
+    const undoBackgroundConfig = useCallback(() => {
+        const history = backgroundHistoryRef.current;
+        if (history.length === 0)
+            return;
+        setBackgroundConfigState(history[history.length - 1]);
+        setBackgroundHistoryState((h) => h.slice(0, -1));
+    }, []);
     // Resolve mode -> concrete theme. When following the system, track OS
     // color-scheme changes live.
     useEffect(() => {
@@ -61,6 +89,12 @@ export function useDisplayPreferences() {
     useEffect(() => {
         saveCompanionHalfFramerateMode(companionHalfFramerateMode);
     }, [companionHalfFramerateMode]);
+    useEffect(() => {
+        saveBackgroundConfig(backgroundConfig);
+    }, [backgroundConfig]);
+    useEffect(() => {
+        saveBackgroundHistory(backgroundHistory);
+    }, [backgroundHistory]);
     return {
         state: {
             uiTheme,
@@ -68,11 +102,15 @@ export function useDisplayPreferences() {
             companionVrmPowerMode,
             companionAnimateWhenHidden,
             companionHalfFramerateMode,
+            backgroundConfig,
+            canUndoBackground: backgroundHistory.length > 0,
         },
         setUiTheme,
         setUiThemeMode,
         setCompanionVrmPowerMode,
         setCompanionAnimateWhenHidden,
         setCompanionHalfFramerateMode,
+        setBackgroundConfig,
+        undoBackgroundConfig,
     };
 }

package/state/useFirstRunCallbacks.d.ts

@@ -10,15 +10,15 @@
  * and applyDetectedProviders.
  */
 import { type RefObject } from "react";
-import type { StylePreset, VoiceConfig } from "../api";
-import { ElizaClient } from "../api/client-base";
+import type { StylePreset, VoiceConfig } from "../api/index.js";
+import { ElizaClient } from "../api/client-base.js";
 type FirstRunClient = Pick<ElizaClient, "getAuthStatus" | "getBaseUrl" | "getStatus" | "selectOrProvisionCloudAgent" | "setBaseUrl" | "setToken" | "startAgent" | "submitFirstRun" | "updateConfig">;
-import { type scanProviderCredentials } from "../bridge";
-import type { UiLanguage } from "../i18n";
-import { type Tab } from "../navigation";
-import { type FirstRunNextOptions } from "./internal";
-import type { AppState, CompleteFirstRunOptions, SetupStep } from "./types";
-import type { FirstRunStateHook } from "./useFirstRunState";
+import { type scanProviderCredentials } from "../bridge/index.js";
+import type { UiLanguage } from "../i18n/index.js";
+import { type Tab } from "../navigation/index.js";
+import { type FirstRunNextOptions } from "./internal.js";
+import type { AppState, CompleteFirstRunOptions, SetupStep } from "./types.js";
+import type { FirstRunStateHook } from "./useFirstRunState.js";
 export declare function buildFirstRunStyleVoiceConfig(args: {
     style: StylePreset | undefined;
     voiceProvider: string;

package/state/useFirstRunState.d.ts

@@ -5,9 +5,9 @@
  * Connector tokens (telegram, discord, etc.) collapse into a single Record.
  * Remote connection state (connecting/connected/error) collapses into one object.
  */
-import type { FirstRunOptions } from "../api";
-import { type FirstRunRuntimeTarget } from "../first-run/runtime-target";
-import type { AppState, SetupStep } from "./types";
+import type { FirstRunOptions } from "../api/index.js";
+import { type FirstRunRuntimeTarget } from "../first-run/runtime-target.js";
+import type { AppState, SetupStep } from "./types.js";
 export type ConnectorTokenKey = "telegramToken" | "discordToken" | "whatsAppSessionPath" | "twilioAccountSid" | "twilioAuthToken" | "twilioPhoneNumber" | "blooioApiKey" | "blooioPhoneNumber" | "githubToken";
 export interface RemoteConnectionState {
     status: "idle" | "connecting" | "connected" | "error";

package/state/useLifecycleState.d.ts

@@ -4,11 +4,14 @@
  * Replaces 20+ individual useState hooks from AppContext with a single
  * reducer + dispatch, cutting hook count and making state transitions explicit.
  */
-import type { AgentStatus } from "../api";
-import type { ActionBanner, ActionNotice, AppState, LifecycleAction, StartupErrorState, StartupPhase } from "./types";
+import type { AgentStatus } from "../api/index.js";
+import { type CloudHandoffPhaseDetail } from "../events/index.js";
+import type { ActionBanner, ActionNotice, AppState, LifecycleAction, StartupErrorState, StartupPhase } from "./types.js";
 export interface LifecycleState {
     connected: boolean;
     agentStatus: AgentStatus | null;
+    /** Latest shared→dedicated cloud-agent handoff phase (see CLOUD_HANDOFF_PHASE_EVENT). */
+    cloudHandoffPhase: CloudHandoffPhaseDetail | null;
     firstRunComplete: boolean;
     firstRunUiRevealNonce: number;
     firstRunLoading: boolean;
@@ -33,6 +36,9 @@ type LifecycleAction_ = {
 } | {
     type: "SET_AGENT_STATUS";
     value: AgentStatus | null;
+} | {
+    type: "SET_CLOUD_HANDOFF_PHASE";
+    value: CloudHandoffPhaseDetail | null;
 } | {
     type: "SET_FIRST_RUN_COMPLETE";
     value: boolean;
@@ -99,6 +105,7 @@ export interface LifecycleStateHook {
     setAgentStatus: (v: AgentStatus | null) => void;
     /** Only calls setAgentStatus when the payload has materially changed. */
     setAgentStatusIfChanged: (next: AgentStatus | null) => void;
+    setCloudHandoffPhase: (v: CloudHandoffPhaseDetail | null) => void;
     setFirstRunComplete: (v: boolean) => void;
     incrementFirstRunRevealNonce: () => void;
     setFirstRunLoading: (v: boolean) => void;

package/state/useLifecycleState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useLifecycleState.d.ts","sourceRoot":"","sources":["../../../../../src/state/useLifecycleState.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useLifecycleState.d.ts","sourceRoot":"","sources":["../../../../../src/state/useLifecycleState.ts"],"names":[],"mappings":"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"}

package/state/useLifecycleState.js

@@ -5,10 +5,13 @@
  * reducer + dispatch, cutting hook count and making state transitions explicit.
  */
 import { useCallback, useEffect, useMemo, useReducer, useRef } from "react";
+import { CLOUD_HANDOFF_PHASE_EVENT, } from "../events/index.js";
+import { TOAST_TTL_MS } from "./action-notice.js";
 import { loadPersistedFirstRunComplete, savePersistedFirstRunComplete, } from "./persistence.js";
 const INITIAL_LIFECYCLE_STATE = {
     connected: false,
     agentStatus: null,
+    cloudHandoffPhase: null,
     firstRunComplete: loadPersistedFirstRunComplete(),
     firstRunUiRevealNonce: 0,
     firstRunLoading: true,
@@ -38,6 +41,10 @@ function lifecycleReducer(state, action) {
             return { ...state, connected: action.value };
         case "SET_AGENT_STATUS":
             return { ...state, agentStatus: action.value };
+        case "SET_CLOUD_HANDOFF_PHASE":
+            if (state.cloudHandoffPhase === action.value)
+                return state;
+            return { ...state, cloudHandoffPhase: action.value };
         case "SET_FIRST_RUN_COMPLETE":
             return { ...state, firstRunComplete: action.value };
         case "INCREMENT_FIRST_RUN_REVEAL_NONCE":
@@ -167,6 +174,23 @@ export function useLifecycleState() {
         agentStatusRef.current = next;
         dispatch({ type: "SET_AGENT_STATUS", value: next });
     }, []);
+    const setCloudHandoffPhase = useCallback((v) => dispatch({ type: "SET_CLOUD_HANDOFF_PHASE", value: v }), []);
+    // Single subscriber for the shared→dedicated handoff phase. Mirroring it into
+    // lifecycle state (rather than each surface subscribing to the window event on
+    // its own) is what lets the chat shell + Settings cloud-agents row read one
+    // unified "shared-now / dedicated-pending" signal. The CloudHandoffBanner keeps
+    // its own display-lingering hook; this is the canonical app-state copy.
+    useEffect(() => {
+        if (typeof window === "undefined")
+            return;
+        const onPhase = (event) => {
+            const detail = event.detail;
+            if (detail)
+                dispatch({ type: "SET_CLOUD_HANDOFF_PHASE", value: detail });
+        };
+        window.addEventListener(CLOUD_HANDOFF_PHASE_EVENT, onPhase);
+        return () => window.removeEventListener(CLOUD_HANDOFF_PHASE_EVENT, onPhase);
+    }, []);
     const setFirstRunComplete = useCallback((v) => {
         savePersistedFirstRunComplete(v);
         dispatch({ type: "SET_FIRST_RUN_COMPLETE", value: v });
@@ -177,7 +201,7 @@ export function useLifecycleState() {
     const setStartupError = useCallback((v) => dispatch({ type: "SET_STARTUP_ERROR", value: v }), []);
     const retryStartup = useCallback(() => dispatch({ type: "RETRY_STARTUP" }), []);
     const setAuthRequired = useCallback((v) => dispatch({ type: "SET_AUTH_REQUIRED", value: v }), []);
-    const setActionNotice = useCallback((text, tone = "info", ttlMs = 2800, once = false, busy = false) => {
+    const setActionNotice = useCallback((text, tone = "info", ttlMs = TOAST_TTL_MS.default, once = false, busy = false) => {
         if (once && shownOnceNotices.current.has(text))
             return;
         if (once)
@@ -256,6 +280,7 @@ export function useLifecycleState() {
         setConnected,
         setAgentStatus,
         setAgentStatusIfChanged,
+        setCloudHandoffPhase,
         setFirstRunComplete,
         incrementFirstRunRevealNonce,
         setFirstRunLoading,

package/state/useLogsState.d.ts

@@ -4,7 +4,7 @@
  * Manages log entries, sources, tags, and filter state.
  * The loadLogs callback reads all three filter values from state.
  */
-import type { LogEntry } from "../api";
+import type { LogEntry } from "../api/index.js";
 export declare function useLogsState(): {
     state: {
         logs: LogEntry[];

package/state/useMiscUiState.d.ts

@@ -8,7 +8,7 @@
  *  - Games: active game iframe state and overlay flag
  *  - UI chrome: command palette, emote picker, dropped files
  */
-import type { AppRunSummary, AppSessionState, McpMarketplaceResult, McpRegistryServerDetail, McpServerConfig, McpServerStatus } from "../api";
+import type { AppRunSummary, AppSessionState, McpMarketplaceResult, McpRegistryServerDetail, McpServerConfig, McpServerStatus } from "../api/index.js";
 /**
  * Currently-selected connector chat in the messages sidebar.
  * When non-null, ChatView swaps its main panel out for a read-only

package/state/useNavigationState.d.ts

@@ -5,8 +5,8 @@
  * deferred post-tab-commit work, uiShellMode persist, lastNativeTab persist,
  * and tabFromPath logic.
  */
-import { type Tab } from "../navigation";
-import { type ShellView, type UiShellMode } from "./internal";
+import { type Tab } from "../navigation/index.js";
+import { type ShellView, type UiShellMode } from "./internal.js";
 export interface NavigationStateDeps {
     tab: Tab;
     setTabRaw: (t: Tab) => void;

package/state/usePluginsSkillsState.d.ts

@@ -6,7 +6,7 @@
  *
  * Accepts `{ setActionNotice }` for cross-domain notifications.
  */
-import { type CatalogSkill, type PluginInfo, type RegistryPlugin, type SkillInfo, type SkillMarketplaceResult, type SkillScanReportSummary } from "../api";
+import { type CatalogSkill, type PluginInfo, type RegistryPlugin, type SkillInfo, type SkillMarketplaceResult, type SkillScanReportSummary } from "../api/index.js";
 /**
  * Pick the primary sensitive credential parameter from a plugin's
  * declared parameter list. Walks the priority list in order and returns
@@ -31,8 +31,8 @@ export declare function usePluginsSkillsState({ setActionNotice, setPendingResta
     isLoadingPlugins: boolean;
     pluginsLoadError: string | null;
     pluginsLoaded: boolean;
-    pluginFilter: "all" | "streaming" | "ai-provider" | "connector" | "feature";
-    setPluginFilter: import("react").Dispatch<import("react").SetStateAction<"all" | "streaming" | "ai-provider" | "connector" | "feature">>;
+    pluginFilter: "streaming" | "all" | "ai-provider" | "connector" | "feature";
+    setPluginFilter: import("react").Dispatch<import("react").SetStateAction<"streaming" | "all" | "ai-provider" | "connector" | "feature">>;
     pluginStatusFilter: "enabled" | "disabled" | "all";
     setPluginStatusFilter: import("react").Dispatch<import("react").SetStateAction<"enabled" | "disabled" | "all">>;
     pluginSearch: string;

package/state/usePreviewMode.d.ts

@@ -0,0 +1,4 @@
+export declare function isPreviewModeEnabled(): boolean;
+export declare function setPreviewMode(enabled: boolean): void;
+export declare function useIsPreviewMode(): boolean;
+//# sourceMappingURL=usePreviewMode.d.ts.map

package/state/usePreviewMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreviewMode.d.ts","sourceRoot":"","sources":["../../../../../src/state/usePreviewMode.ts"],"names":[],"mappings":"AAkFA,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAOrD;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C"}