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

package/state/app-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-store.d.ts","sourceRoot":"","sources":["../../../../../src/state/app-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAsBlD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAI5D;AAgDD,iBAAS,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAyBrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,CAAC,EACvC,OAAO,GAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAmB,GAC3C,CAAC,CAuCH;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,CAAC,GACtC,CAAC,CAEH;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAGzE;AAED,OAAO,EAAE,YAAY,IAAI,iBAAiB,EAAE,CAAC"}

package/state/app-store.js

@@ -0,0 +1,169 @@
+/**
+ * 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 { useCallback, useRef, useSyncExternalStore } from "react";
+const appStoreGlobal = globalThis;
+if (!appStoreGlobal.__ELIZAOS_UI_APP_STORE__) {
+    appStoreGlobal.__ELIZAOS_UI_APP_STORE__ = {
+        value: null,
+        listeners: new Set(),
+    };
+}
+const store = appStoreGlobal.__ELIZAOS_UI_APP_STORE__;
+/**
+ * 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 function seedAppValue(value) {
+    store.value = value;
+}
+/**
+ * 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 function publishAppValue(value) {
+    if (store.value === value && store.listeners.size === 0)
+        return;
+    store.value = value;
+    for (const listener of store.listeners)
+        listener();
+}
+function subscribe(listener) {
+    store.listeners.add(listener);
+    return () => {
+        store.listeners.delete(listener);
+    };
+}
+// In tests a component may render outside <AppProvider> and without a barrel
+// mock, relying on the same inert proxy useApp() returns. Mirror that proxy here
+// (cached so its function/value refs are STABLE across getSnapshot calls — fresh
+// refs would loop useSyncExternalStore). Production always seeds the store, so
+// this only triggers under NODE_ENV=test.
+let testFallbackValue = null;
+function getTestFallbackValue() {
+    if (!testFallbackValue) {
+        const noop = () => { };
+        const identityT = (k) => k;
+        const navigation = {
+            scheduleAfterTabCommit: (fn) => {
+                queueMicrotask(fn);
+            },
+        };
+        testFallbackValue = new Proxy({}, {
+            get(_target, prop) {
+                if (prop === "t")
+                    return identityT;
+                if (prop === "uiLanguage")
+                    return "en";
+                if (prop === "companionHalfFramerateMode")
+                    return "when_saving_power";
+                if (prop === "navigation")
+                    return navigation;
+                return noop;
+            },
+        });
+    }
+    return testFallbackValue;
+}
+function readAppValue() {
+    const value = store.value;
+    if (value != null)
+        return value;
+    if (typeof process !== "undefined" && process.env.NODE_ENV === "test") {
+        return getTestFallbackValue();
+    }
+    throw new Error("useAppSelector used before AppProvider rendered — wrap the consumer in <AppProvider>.");
+}
+function shallowEqual(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (typeof a !== "object" ||
+        a === null ||
+        typeof b !== "object" ||
+        b === null) {
+        return false;
+    }
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    for (const key of aKeys) {
+        if (!Object.hasOwn(b, key) ||
+            !Object.is(a[key], b[key])) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * 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 function useAppSelector(selector, isEqual = Object.is) {
+    // Memoize the selected snapshot so getSnapshot returns a referentially-stable
+    // value when nothing relevant changed — required to avoid useSyncExternalStore
+    // infinite loops and to bail out of re-renders on equal slices.
+    const lastRef = useRef(null);
+    const getSnapshot = useCallback(() => {
+        const value = readAppValue();
+        const last = lastRef.current;
+        if (last &&
+            last.value === value &&
+            last.selector === selector &&
+            last.isEqual === isEqual) {
+            // Same value identity → selected slice cannot have changed.
+            return last.selected;
+        }
+        const selected = selector(value);
+        if (last && isEqual(last.selected, selected)) {
+            // Value changed but the selected slice is equal → keep the prior ref.
+            lastRef.current = {
+                value,
+                selector,
+                isEqual,
+                selected: last.selected,
+            };
+            return last.selected;
+        }
+        lastRef.current = { value, selector, isEqual, selected };
+        return selected;
+    }, [selector, isEqual]);
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+/** {@link useAppSelector} with shallow equality — use for object/array slices. */
+export function useAppSelectorShallow(selector) {
+    return useAppSelector(selector, shallowEqual);
+}
+/** Test-only: seed the store and notify subscribers (mirrors a publish). */
+export function __setAppValueForTests(value) {
+    store.value = value;
+    for (const listener of store.listeners)
+        listener();
+}
+export { shallowEqual as __appShallowEqual };

package/state/autonomy.d.ts

@@ -1,4 +1,4 @@
-import type { StreamEventEnvelope } from "../api/client";
+import type { StreamEventEnvelope } from "../api/client.js";
 export type AutonomyRunHealthStatus = "ok" | "gap_detected" | "recovered" | "partial";
 export interface AutonomyRunHealth {
     runId: string;

package/state/chat-conversation-guards.d.ts

@@ -1,4 +1,4 @@
-import type { Conversation } from "../api";
+import type { Conversation } from "../api/index.js";
 export declare function isConversationRecord(value: unknown): value is Conversation;
 export declare function isMainChatConversation(conversation: Pick<Conversation, "metadata" | "title"> | null | undefined): boolean;
 export declare function filterMainChatConversations(conversations: Conversation[]): Conversation[];

package/state/chat-conversation-guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-conversation-guards.d.ts","sourceRoot":"","sources":["../../../../../src/state/chat-conversation-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAoB3C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAc1E;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACxE,OAAO,CAUT;AAED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,YAAY,EAAE,GAC5B,YAAY,EAAE,CAEhB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,CAIxE"}
+{"version":3,"file":"chat-conversation-guards.d.ts","sourceRoot":"","sources":["../../../../../src/state/chat-conversation-guards.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAmB3C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAc1E;AAED,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACxE,OAAO,CAUT;AAED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,YAAY,EAAE,GAC5B,YAAY,EAAE,CAEhB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,EAAE,CAIxE"}

package/state/chat-conversation-guards.js

@@ -10,7 +10,6 @@ const LEGACY_PAGE_CHAT_TITLES = new Set([
     "automations",
     "apps",
     "phone",
-    "lifeops",
     "settings",
     "wallet",
 ]);

package/state/complete-reset-local-state-after-wipe.d.ts

@@ -28,7 +28,7 @@
  *    path calls one without the others, so the coupling-guarantee comments
  *    in `useChatLifecycle.ts` (token-clear ↔ markFirstRunReset) hold.
  */
-import type { AgentStatus, FirstRunOptions } from "../api/client";
+import type { AgentStatus, FirstRunOptions } from "../api/client.js";
 /**
  * Ports for `completeResetLocalStateAfterServerWipe` (all side effects explicit).
  */

package/state/conversation-message-filter.d.ts

@@ -1,4 +1,4 @@
-import type { ConversationMessage } from "../api";
+import type { ConversationMessage } from "../api/index.js";
 /**
  * Whether a message should appear in the rendered transcript. User turns always
  * render; an assistant turn renders when it has visible text, structured

package/state/first-run-bootstrap.d.ts

@@ -1,4 +1,4 @@
-import { type PersistedActiveServer } from "./persistence";
+import { type PersistedActiveServer } from "./persistence.js";
 export interface ExistingFirstRunProbeClient {
     apiAvailable: boolean;
     getFirstRunStatus: () => Promise<{

package/state/first-run-restart.d.ts

@@ -1,4 +1,4 @@
-import type { AgentStatus, ElizaClient } from "../api";
+import type { AgentStatus, ElizaClient } from "../api/index.js";
 /**
  * First-run can overlap a runtime restart already in flight on slower boots.
  * Use the waitable restart path so "already restarting" is treated as

package/state/handle-reset-applied-from-main.d.ts

@@ -8,8 +8,8 @@
  * and main-process reset must apply the **same** client + first-run + cloud
  * teardown or the two entry points drift.
  */
-import type { AgentStatus } from "../api/client";
-import { type LifecycleAction } from "./types";
+import type { AgentStatus } from "../api/client.js";
+import { type LifecycleAction } from "./types.js";
 export type HandleResetAppliedFromMainDeps = {
     performanceNow: () => number;
     isLifecycleBusy: () => boolean;

package/state/index.d.ts

@@ -1,19 +1,25 @@
-export { AppProvider } from "./AppContext";
-export { RESYNC_EVENT, type ResyncEventDetail } from "./AppContext.hooks";
-export * from "./action-notice";
-export * from "./agent-profiles";
-export * from "./ChatComposerContext.hooks";
-export * from "./CompanionSceneConfigContext.hooks";
-export * from "./internal";
-export * from "./PtySessionsContext.hooks";
-export * from "./parsers";
-export * from "./persistence";
-export * from "./TranslationContext.hooks";
-export { TranslationProvider } from "./TranslationProvider";
-export * from "./types";
-export * from "./ui-preferences";
-export * from "./useApp";
-export * from "./useContentPack";
-export * from "./useDeveloperMode";
-export * from "./useWalletState";
+export { AppProvider } from "./AppContext.js";
+export { RESYNC_EVENT, type ResyncEventDetail } from "./AppContext.hooks.js";
+export * from "./action-notice.js";
+export * from "./agent-profiles.js";
+export { __setAppValueForTests, publishAppValue, useAppSelector, useAppSelectorShallow, } from "./app-store.js";
+export * from "./ChatComposerContext.hooks.js";
+export * from "./ChatTurnStatusContext.hooks.js";
+export * from "./CompanionSceneConfigContext.hooks.js";
+export * from "./ConversationMessagesContext.hooks.js";
+export * from "./internal.js";
+export * from "./PtySessionsContext.hooks.js";
+export * from "./parsers.js";
+export * from "./persistence.js";
+export * from "./TranslationContext.hooks.js";
+export { TranslationProvider } from "./TranslationProvider.js";
+export * from "./types.js";
+export * from "./ui-preferences.js";
+export * from "./useApp.js";
+export * from "./useBackgroundConfig.js";
+export * from "./useContentPack.js";
+export * from "./useDeveloperMode.js";
+export * from "./usePreviewMode.js";
+export * from "./useViewKinds.js";
+export * from "./useWalletState.js";
 //# sourceMappingURL=index.d.ts.map

package/state/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,YAAY,CAAC;AAC3B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC1E,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,YAAY,CAAC;AAC3B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/state/index.js

@@ -2,8 +2,11 @@ export { AppProvider } from "./AppContext.js";
 export { RESYNC_EVENT } from "./AppContext.hooks.js";
 export * from "./action-notice.js";
 export * from "./agent-profiles.js";
+export { __setAppValueForTests, publishAppValue, useAppSelector, useAppSelectorShallow, } from "./app-store.js";
 export * from "./ChatComposerContext.hooks.js";
+export * from "./ChatTurnStatusContext.hooks.js";
 export * from "./CompanionSceneConfigContext.hooks.js";
+export * from "./ConversationMessagesContext.hooks.js";
 export * from "./internal.js";
 export * from "./PtySessionsContext.hooks.js";
 export * from "./parsers.js";
@@ -13,6 +16,9 @@ export { TranslationProvider } from "./TranslationProvider.js";
 export * from "./types.js";
 export * from "./ui-preferences.js";
 export * from "./useApp.js";
+export * from "./useBackgroundConfig.js";
 export * from "./useContentPack.js";
 export * from "./useDeveloperMode.js";
+export * from "./usePreviewMode.js";
+export * from "./useViewKinds.js";
 export * from "./useWalletState.js";

package/state/internal.d.ts

@@ -1,12 +1,12 @@
-export { canRevertSetupTo, getFlaminaTopicForSetupStep, getSetupNavMetas, getSetupStepOrder, resolveSetupNextStep, resolveSetupPreviousStep, } from "../first-run/setup-steps";
-export { filterRenderableConversationMessages, shouldKeepConversationMessage, } from "./conversation-message-filter";
-export { asApiLikeError, computeStreamingDelta, formatSearchBullet, formatStartupErrorDetail, mergeStreamingText, normalizeCustomActionName, normalizeStreamComparisonText, parseAgentStartupDiagnostics, parseAgentStatusEvent, parseAgentStatusFromMainMenuResetPayload, parseConversationMessageEvent, parseCustomActionParams, parseProactiveMessageEvent, parseSlashCommandInput, parseStreamEventEnvelopeEvent, shouldApplyFinalStreamText, } from "./parsers";
-export { applyUiTheme, clearAvatarIndex, clearPersistedActiveServer, clearPersistedSetupStep, createPersistedActiveServer, loadActiveConversationId, loadAvatarIndex, loadChatAvatarVisible, loadChatVoiceMuted, loadCompanionAnimateWhenHidden, loadCompanionHalfFramerateMode, loadCompanionMessageCutoffTs, loadCompanionVrmPowerMode, loadLastNativeTab, loadPersistedActiveServer, loadPersistedFirstRunComplete, loadPersistedSetupStep, loadUiLanguage, loadUiShellMode, loadUiTheme, normalizeCompanionHalfFramerateMode, normalizeCompanionVrmPowerMode, normalizeUiShellMode, normalizeUiTheme, type PersistedActiveServer, saveActiveConversationId, saveAvatarIndex, saveChatAvatarVisible, saveChatVoiceMuted, saveCompanionAnimateWhenHidden, saveCompanionHalfFramerateMode, saveCompanionMessageCutoffTs, saveCompanionVrmPowerMode, saveLastNativeTab, savePersistedActiveServer, savePersistedFirstRunComplete, saveSetupStep, saveUiLanguage, saveUiShellMode, saveUiTheme, type UiTheme, } from "./persistence";
-export { deriveFirstRunResumeFieldsFromConfig, hasPartialSetupConnectionConfig, inferSetupResumeStep, } from "./setup-resume";
-export { type TranslationContextValue, useTranslation, } from "./TranslationContext.hooks";
-export { TranslationProvider } from "./TranslationProvider";
-export { type ActionNotice, AGENT_READY_TIMEOUT_MS, AGENT_STATES, AGENT_TRANSFER_MIN_PASSWORD_LENGTH, type AppActions, type AppContextValue, type AppState, type ChatTurnUsage, type CompanionHalfFramerateMode, type CompanionVrmPowerMode, FIRST_RUN_PERMISSION_LABELS, type FirstRunMode, type FirstRunNextOptions, type GamePostMessageAuthPayload, type InventoryChainFilters, LIFECYCLE_MESSAGES, type LifecycleAction, type LoadConversationMessagesResult, type NavigationEventsApi, SETUP_STEPS, type SetupStep, type ShellView, type SlashCommandInput, type StartupErrorReason, type StartupErrorState, type StartupPhase, type UiShellMode, } from "./types";
-export { AppContext, useApp } from "./useApp";
-export { applyStreamingTextModification, type StreamingTextModification, type StreamingTextSetter, } from "./useStreamingText";
-export { getCompanionBackgroundUrl, getVrmBackgroundUrl, getVrmCount, getVrmPreviewUrl, getVrmTitle, getVrmUrl, normalizeAvatarIndex, VRM_COUNT, } from "./vrm";
+export { canRevertSetupTo, getFlaminaTopicForSetupStep, getSetupNavMetas, getSetupStepOrder, resolveSetupNextStep, resolveSetupPreviousStep, } from "../first-run/setup-steps.js";
+export { filterRenderableConversationMessages, shouldKeepConversationMessage, } from "./conversation-message-filter.js";
+export { asApiLikeError, computeStreamingDelta, formatSearchBullet, formatStartupErrorDetail, mergeStreamingText, normalizeCustomActionName, normalizeStreamComparisonText, parseAgentStartupDiagnostics, parseAgentStatusEvent, parseAgentStatusFromMainMenuResetPayload, parseConversationMessageEvent, parseCustomActionParams, parseProactiveMessageEvent, parseSlashCommandInput, parseStreamEventEnvelopeEvent, shouldApplyFinalStreamText, } from "./parsers.js";
+export { applyUiTheme, clearAvatarIndex, clearPersistedActiveServer, clearPersistedSetupStep, createPersistedActiveServer, loadActiveConversationId, loadAvatarIndex, loadChatAvatarVisible, loadChatVoiceMuted, loadCompanionAnimateWhenHidden, loadCompanionHalfFramerateMode, loadCompanionMessageCutoffTs, loadCompanionVrmPowerMode, loadLastNativeTab, loadPersistedActiveServer, loadPersistedFirstRunComplete, loadPersistedSetupStep, loadUiLanguage, loadUiShellMode, loadUiTheme, normalizeCompanionHalfFramerateMode, normalizeCompanionVrmPowerMode, normalizeUiShellMode, normalizeUiTheme, type PersistedActiveServer, saveActiveConversationId, saveAvatarIndex, saveChatAvatarVisible, saveChatVoiceMuted, saveCompanionAnimateWhenHidden, saveCompanionHalfFramerateMode, saveCompanionMessageCutoffTs, saveCompanionVrmPowerMode, saveLastNativeTab, savePersistedActiveServer, savePersistedFirstRunComplete, saveSetupStep, saveUiLanguage, saveUiShellMode, saveUiTheme, type UiTheme, } from "./persistence.js";
+export { deriveFirstRunResumeFieldsFromConfig, hasPartialSetupConnectionConfig, inferSetupResumeStep, } from "./setup-resume.js";
+export { type TranslationContextValue, useTranslation, } from "./TranslationContext.hooks.js";
+export { TranslationProvider } from "./TranslationProvider.js";
+export { type ActionNotice, AGENT_READY_TIMEOUT_MS, AGENT_STATES, AGENT_TRANSFER_MIN_PASSWORD_LENGTH, type AppActions, type AppContextValue, type AppState, type ChatTurnUsage, type CompanionHalfFramerateMode, type CompanionVrmPowerMode, FIRST_RUN_PERMISSION_LABELS, type FirstRunMode, type FirstRunNextOptions, type GamePostMessageAuthPayload, type InventoryChainFilters, LIFECYCLE_MESSAGES, type LifecycleAction, type LoadConversationMessagesResult, type NavigationEventsApi, SETUP_STEPS, type SetupStep, type ShellView, type SlashCommandInput, type StartupErrorReason, type StartupErrorState, type StartupPhase, type UiShellMode, } from "./types.js";
+export { AppContext, useApp } from "./useApp.js";
+export { applyStreamingTextModification, type StreamingTextModification, type StreamingTextSetter, } from "./useStreamingText.js";
+export { getCompanionBackgroundUrl, getVrmBackgroundUrl, getVrmCount, getVrmPreviewUrl, getVrmTitle, getVrmUrl, normalizeAvatarIndex, VRM_COUNT, } from "./vrm.js";
 //# sourceMappingURL=internal.d.ts.map

package/state/notifications/navigate-deep-link.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Safe navigation for a notification `deepLink`.
+ *
+ * `AgentNotification.deepLink` is producer-supplied free-form text — the NOTIFY
+ * action, LifeOps, the orchestrator, and the proactive-interaction decider all
+ * populate it, and some source it straight from LLM/model output. It is
+ * therefore attacker-influenceable (a prompt-injected agent or a compromised
+ * connector can set it). A deep link reaches the DOM as a navigation target, so
+ * it MUST be scheme-checked before use: a `javascript:` deep link would execute
+ * in the app origin (especially dangerous under Electrobun/Capacitor), and an
+ * arbitrary `https://attacker` top-window navigation is an open-redirect /
+ * phishing pivot.
+ *
+ * Allowlist (anything else is dropped, no navigation):
+ *  - `http(s)://…` → opened in a NEW tab with `noopener,noreferrer` (never a
+ *    top-window navigation, so it can't be used to redirect the app away);
+ *  - `/…` (root-relative app route) → dispatched as the in-app
+ *    `eliza:navigate:view` event (no full reload).
+ *
+ * This is the single source of truth for both the in-app notification center
+ * and the OS/web notification click handler so the two cannot diverge.
+ */
+/** Whether a deep link is a safe navigation target (see module doc). */
+export declare function isSafeDeepLink(deepLink: string): boolean;
+/** Best-effort, scheme-checked navigation for a notification deep link. */
+export declare function navigateDeepLink(deepLink: string): void;
+//# sourceMappingURL=navigate-deep-link.d.ts.map

package/state/notifications/navigate-deep-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate-deep-link.d.ts","sourceRoot":"","sources":["../../../../../../src/state/notifications/navigate-deep-link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKxD;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAgBvD"}

package/state/notifications/navigate-deep-link.js

@@ -0,0 +1,48 @@
+/**
+ * Safe navigation for a notification `deepLink`.
+ *
+ * `AgentNotification.deepLink` is producer-supplied free-form text — the NOTIFY
+ * action, LifeOps, the orchestrator, and the proactive-interaction decider all
+ * populate it, and some source it straight from LLM/model output. It is
+ * therefore attacker-influenceable (a prompt-injected agent or a compromised
+ * connector can set it). A deep link reaches the DOM as a navigation target, so
+ * it MUST be scheme-checked before use: a `javascript:` deep link would execute
+ * in the app origin (especially dangerous under Electrobun/Capacitor), and an
+ * arbitrary `https://attacker` top-window navigation is an open-redirect /
+ * phishing pivot.
+ *
+ * Allowlist (anything else is dropped, no navigation):
+ *  - `http(s)://…` → opened in a NEW tab with `noopener,noreferrer` (never a
+ *    top-window navigation, so it can't be used to redirect the app away);
+ *  - `/…` (root-relative app route) → dispatched as the in-app
+ *    `eliza:navigate:view` event (no full reload).
+ *
+ * This is the single source of truth for both the in-app notification center
+ * and the OS/web notification click handler so the two cannot diverge.
+ */
+/** Whether a deep link is a safe navigation target (see module doc). */
+export function isSafeDeepLink(deepLink) {
+    if (typeof deepLink !== "string")
+        return false;
+    if (/^https?:\/\//i.test(deepLink))
+        return true;
+    // Root-relative app path, but not a scheme-relative `//host` URL.
+    return deepLink.startsWith("/") && !deepLink.startsWith("//");
+}
+/** Best-effort, scheme-checked navigation for a notification deep link. */
+export function navigateDeepLink(deepLink) {
+    if (typeof window === "undefined")
+        return;
+    if (/^https?:\/\//i.test(deepLink)) {
+        window.open(deepLink, "_blank", "noopener,noreferrer");
+        return;
+    }
+    if (deepLink.startsWith("/") && !deepLink.startsWith("//")) {
+        const viewId = deepLink.slice(1).split("/")[0] || undefined;
+        window.dispatchEvent(new CustomEvent("eliza:navigate:view", {
+            detail: { viewId, viewPath: deepLink },
+        }));
+    }
+    // Any other scheme (javascript:, data:, custom foo://, scheme-relative //) is
+    // intentionally dropped — no navigation.
+}

package/state/notifications/notification-store.d.ts

@@ -1,4 +1,5 @@
 import type { AgentNotification } from "@elizaos/core";
+import { type ActionTone } from "../action-notice.js";
 /**
  * Notification center store.
  *
@@ -16,8 +17,7 @@ export interface NotificationState {
     unreadCount: number;
     hydrated: boolean;
 }
-type ToastTone = "info" | "success" | "error";
-type ToastSink = (text: string, tone?: ToastTone, ttlMs?: number) => void;
+type ToastSink = (text: string, tone?: ActionTone, ttlMs?: number) => void;
 /** Idempotent boot: hydrate the inbox and subscribe to live notifications. */
 export declare function initNotifications(): void;
 /** Register the in-app toast sink (the app shell wires `setActionNotice`). */

package/state/notifications/notification-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-store.d.ts","sourceRoot":"","sources":["../../../../../../src/state/notifications/notification-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMvD;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,KAAK,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAC9C,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAoJ1E,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED,8EAA8E;AAC9E,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAE1E;AAID,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAO9D;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlE;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGxD;AAaD,wBAAgB,gBAAgB,IAAI,iBAAiB,CAEpD;AAED,4BAA4B;AAC5B,wBAAgB,gCAAgC,IAAI,IAAI,CAKvD;AAED,6CAA6C;AAC7C,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,iBAAiB,EAC/B,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAEN"}
+{"version":3,"file":"notification-store.d.ts","sourceRoot":"","sources":["../../../../../../src/state/notifications/notification-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAKvD,OAAO,EACL,KAAK,UAAU,EAGhB,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAkJ3E,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,IAAI,CAKxC;AAED,8EAA8E;AAC9E,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,CAE1E;AAID,wBAAsB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAO9D;AAED,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlE;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAGxD;AAaD,wBAAgB,gBAAgB,IAAI,iBAAiB,CAEpD;AAED,4BAA4B;AAC5B,wBAAgB,gCAAgC,IAAI,IAAI,CAKvD;AAED,6CAA6C;AAC7C,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,iBAAiB,EAC/B,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CAEN"}

package/state/notifications/notification-store.js

@@ -2,6 +2,7 @@ import { useSyncExternalStore } from "react";
 import { client } from "../../api/client.js";
 import { invokeDesktopBridgeRequest } from "../../bridge/electrobun-rpc.js";
 import { showNativeNotification } from "../../bridge/native-notifications.js";
+import { TOAST_TTL_MS, toastToneForPriority, } from "../action-notice.js";
 let state = {
     notifications: [],
     unreadCount: 0,
@@ -36,9 +37,6 @@ function isWindowFocused() {
         return true;
     return document.visibilityState === "visible" && document.hasFocus();
 }
-function toastTone(priority) {
-    return priority === "urgent" ? "error" : "info";
-}
 async function fireDesktopNotification(notification) {
     await invokeDesktopBridgeRequest({
         rpcMethod: "desktopShowNotification",
@@ -83,7 +81,9 @@ function deliver(notification) {
         const text = notification.body
             ? `${notification.title} — ${notification.body}`
             : notification.title;
-        toastSink(text, toastTone(notification.priority), interruptive ? 7000 : 4000);
+        toastSink(text, toastToneForPriority(notification.priority), interruptive
+            ? TOAST_TTL_MS.notificationInterruptive
+            : TOAST_TTL_MS.notification);
     }
 }
 function ingest(notification, unreadCount) {

package/state/parsers.d.ts

@@ -1,6 +1,6 @@
-import type { AgentStartupDiagnostics, AgentStatus, ConversationMessage, CustomActionDef, StreamEventEnvelope } from "../api/client";
-import { mergeStreamingText } from "../utils/streaming-text";
-import { type ApiLikeError, type SlashCommandInput } from "./types";
+import type { AgentStartupDiagnostics, AgentStatus, ConversationMessage, CustomActionDef, StreamEventEnvelope } from "../api/client.js";
+import { mergeStreamingText } from "../utils/streaming-text.js";
+import { type ApiLikeError, type SlashCommandInput } from "./types.js";
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
 export declare function parseAgentStatusEvent(data: Record<string, unknown>): AgentStatus | null;
 /**

package/state/parsers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../../../../src/state/parsers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,WAAW,GAAG,IAAI,CA+BpB;AAED;;;GAGG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,OAAO,GACf,WAAW,GAAG,IAAI,CAepB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,uBAAuB,GAAG,SAAS,CA8BrC;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,mBAAmB,GAAG,IAAI,CA+B5B;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,mBAAmB,GAAG,IAAI,CA8G5B;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAAG,IAAI,CAMjE;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAQT;AAoBD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAY7E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,GACd;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CA2DA;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAGzE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAiBhE;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAazE"}
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../../../../src/state/parsers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACvB,MAAM,SAAS,CAAC;AAEjB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,WAAW,GAAG,IAAI,CA+BpB;AAED;;;GAGG;AACH,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,OAAO,GACf,WAAW,GAAG,IAAI,CAepB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,uBAAuB,GAAG,SAAS,CA8BrC;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,mBAAmB,GAAG,IAAI,CA+B5B;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,mBAAmB,GAAG,IAAI,CA8G5B;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAAG,IAAI,CAMjE;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAER;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAQT;AA0BD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAY7E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK/D;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,GACd;IACD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CA2DA;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAGzE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAiBhE;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAazE"}

package/state/parsers.js

@@ -236,13 +236,19 @@ function normalizeSlashCommandName(name) {
         name = `/${name}`;
     return name.trim().toLowerCase();
 }
-// A simple utility to split command arguments, equivalent to chat-commands splitCommandArgs
+// Split command arguments into tokens. Each token is an optional `key=` prefix
+// followed by a value that is either a quoted string (quotes stripped, inner
+// spaces preserved) or a bare run of non-space chars. Keeping `key="multi word"`
+// and `key='multi word'` as a single `key=multi word` token lets a named arg
+// carry spaces — the previous regex split it at the quote, binding `key=""`.
 function splitCommandArgs(text) {
     const parts = [];
-    const regex = /[^\s"']+|"([^"]*)"|'([^']*)'/g;
+    const regex = /([^\s"'=]+=)?(?:"([^"]*)"|'([^']*)'|([^\s"']+))/g;
     let match = regex.exec(text);
     while (match !== null) {
-        parts.push(match[1] || match[2] || match[0]);
+        const prefix = match[1] ?? "";
+        const value = match[2] ?? match[3] ?? match[4] ?? "";
+        parts.push(prefix + value);
         match = regex.exec(text);
     }
     return parts;

package/state/persistence.d.ts

@@ -1,8 +1,8 @@
-import { type UiLanguage } from "../i18n";
-import type { Tab } from "../navigation";
-import type { CompanionHalfFramerateMode, CompanionVrmPowerMode, SetupStep } from "./types";
-import type { UiShellMode, UiTheme, UiThemeMode } from "./ui-preferences";
-export type { UiTheme, UiThemeMode } from "./ui-preferences";
+import { type UiLanguage } from "../i18n/index.js";
+import type { Tab } from "../navigation/index.js";
+import type { CompanionHalfFramerateMode, CompanionVrmPowerMode, SetupStep } from "./types.js";
+import { type BackgroundConfig, type UiShellMode, type UiTheme, type UiThemeMode } from "./ui-preferences.js";
+export type { UiTheme, UiThemeMode } from "./ui-preferences.js";
 declare function normalizeUiThemeMode(value: unknown): UiThemeMode;
 export { normalizeUiThemeMode };
 /**
@@ -12,10 +12,10 @@ export { normalizeUiThemeMode };
  */
 export declare function getSystemTheme(): UiTheme;
 /**
- * Resolve a {@link UiThemeMode} to a concrete {@link UiTheme}. The app is
- * light-only, so every mode resolves to `light`.
+ * Resolve a {@link UiThemeMode} to a concrete {@link UiTheme}: an explicit
+ * `light`/`dark` choice wins; `system` follows the OS color-scheme.
  */
-export declare function resolveUiTheme(_mode: UiThemeMode): UiTheme;
+export declare function resolveUiTheme(mode: UiThemeMode): UiTheme;
 /**
  * Load the persisted theme mode. New users (no stored value) default to
  * `system`. A legacy concrete `eliza:ui-theme` value is treated as an
@@ -27,6 +27,13 @@ declare function normalizeUiTheme(value: unknown): UiTheme;
 export { normalizeUiTheme };
 export declare function loadUiTheme(): UiTheme;
 export declare function saveUiTheme(theme: UiTheme): void;
+export declare function normalizeBackgroundConfig(value: unknown): BackgroundConfig;
+export declare function loadBackgroundConfig(): BackgroundConfig;
+export declare function saveBackgroundConfig(config: BackgroundConfig): void;
+export declare const MAX_BACKGROUND_HISTORY = 10;
+export declare function normalizeBackgroundHistory(value: unknown): BackgroundConfig[];
+export declare function loadBackgroundHistory(): BackgroundConfig[];
+export declare function saveBackgroundHistory(history: BackgroundConfig[]): void;
 export declare function normalizeCompanionVrmPowerMode(value: unknown): CompanionVrmPowerMode;
 /**
  * Persisted 3D companion power preference. Migrates legacy boolean keys once.
@@ -137,4 +144,12 @@ export declare function createPersistedActiveServer(args: {
 export declare function loadPersistedActiveServer(): PersistedActiveServer | null;
 export declare function savePersistedActiveServer(server: PersistedActiveServer): void;
 export declare function clearPersistedActiveServer(): void;
+/**
+ * Drop the bearer access token from the persisted active server while keeping
+ * the server selection (kind/apiBase/label). Call this on sign-out: the token
+ * is a JWT and leaving it in localStorage after sign-out is an at-rest leak,
+ * but clearing the whole record would needlessly forget which backend to
+ * re-authenticate against.
+ */
+export declare function scrubPersistedActiveServerToken(): void;
 //# sourceMappingURL=persistence.d.ts.map

package/state/persistence.d.ts.map

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