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

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,CAuBpB;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;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"}

package/state/parsers.js

@@ -16,10 +16,17 @@ export function parseAgentStatusEvent(data) {
     const startedAt = typeof data.startedAt === "number" ? data.startedAt : undefined;
     const uptime = typeof data.uptime === "number" ? data.uptime : undefined;
     const startup = parseAgentStartupDiagnostics(data.startup);
+    // `canRespond` is the server-authoritative readiness signal (deriveAgentReady).
+    // Carry it through from the WS `status` event — dropping it would reset a ready
+    // agent's status to `canRespond: undefined`, which falls back to running+model
+    // and (for a cloud agent with no locally-detected model) wrongly re-gates the
+    // composer back to "waking up".
+    const canRespond = typeof data.canRespond === "boolean" ? data.canRespond : undefined;
     return {
         state: state,
         agentName,
         model,
+        ...(canRespond !== undefined ? { canRespond } : {}),
         startedAt,
         uptime,
         startup,

package/state/persistence.d.ts

@@ -1,15 +1,32 @@
-import type { ConversationMode } from "../api/client";
 import { type UiLanguage } from "../i18n";
 import type { Tab } from "../navigation";
-import type { CompanionHalfFramerateMode, CompanionVrmPowerMode, OnboardingStep } from "./types";
-import type { UiShellMode, UiTheme } from "./ui-preferences";
-export type { UiTheme } from "./ui-preferences";
+import type { CompanionHalfFramerateMode, CompanionVrmPowerMode, SetupStep } from "./types";
+import type { UiShellMode, UiTheme, UiThemeMode } from "./ui-preferences";
+export type { UiTheme, UiThemeMode } from "./ui-preferences";
+declare function normalizeUiThemeMode(value: unknown): UiThemeMode;
+export { normalizeUiThemeMode };
+/**
+ * The app ships a single curated light look — there is no dark theme. Kept as a
+ * function (not a constant) so existing callers and the system-change listener
+ * keep their shape.
+ */
+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`.
+ */
+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
+ * explicit user choice and migrated into a `light`/`dark` mode.
+ */
+export declare function loadUiThemeMode(): UiThemeMode;
+export declare function saveUiThemeMode(mode: UiThemeMode): void;
 declare function normalizeUiTheme(value: unknown): UiTheme;
 export { normalizeUiTheme };
 export declare function loadUiTheme(): UiTheme;
 export declare function saveUiTheme(theme: UiTheme): void;
-export declare function loadThemeId(): string;
-export declare function saveThemeId(themeId: string): void;
 export declare function normalizeCompanionVrmPowerMode(value: unknown): CompanionVrmPowerMode;
 /**
  * Persisted 3D companion power preference. Migrates legacy boolean keys once.
@@ -28,17 +45,19 @@ export declare function saveCompanionHalfFramerateMode(mode: CompanionHalfFramer
  * in base.css (`[data-theme="dark"]` and `.dark`) are satisfied.
  */
 export declare function applyUiTheme(theme: UiTheme): void;
-export declare function loadPersistedOnboardingStep(): OnboardingStep | null;
-export declare function saveOnboardingStep(step: OnboardingStep): void;
-export declare function clearPersistedOnboardingStep(): void;
-export declare function loadPersistedOnboardingComplete(): boolean;
-export declare function savePersistedOnboardingComplete(complete: boolean): void;
+export declare function loadPersistedSetupStep(): SetupStep | null;
+export declare function saveSetupStep(step: SetupStep): void;
+export declare function clearPersistedSetupStep(): void;
+export declare function loadPersistedFirstRunComplete(): boolean;
+export declare function savePersistedFirstRunComplete(complete: boolean): void;
 export declare function loadPersistedActivePackId(): string | null;
 export declare function savePersistedActivePackId(packId: string | null): void;
 export declare function loadPersistedActivePackUrl(): string | null;
 export declare function savePersistedActivePackUrl(packUrl: string | null): void;
 export declare function loadUiLanguage(): UiLanguage;
 export declare function saveUiLanguage(language: UiLanguage): void;
+/** Whether the user has a persisted UI language (vs. a fresh first visit). */
+export declare function hasStoredUiLanguage(): boolean;
 declare function normalizeUiShellMode(mode: unknown): UiShellMode;
 export { normalizeUiShellMode };
 export declare function loadUiShellMode(): UiShellMode;
@@ -73,6 +92,17 @@ export declare function loadRecentApps(): string[];
 export declare function saveRecentApps(apps: string[]): void;
 export declare function loadWalletEnabled(): boolean;
 export declare function saveWalletEnabled(value: boolean): void;
+type ContinuousChatModeValue = "off" | "vad-gated" | "always-on";
+export declare function loadContinuousChatMode(): ContinuousChatModeValue;
+export declare function saveContinuousChatMode(mode: ContinuousChatModeValue): void;
+export interface VadAutoStopValue {
+    /** Trailing silence (ms) that ends a turn in local-ASR capture. */
+    silenceMs: number;
+    /** RMS amplitude (0–1) above which audio is treated as speech. */
+    speechRmsThreshold: number;
+}
+export declare function loadVadAutoStop(): VadAutoStopValue;
+export declare function saveVadAutoStop(value: VadAutoStopValue): void;
 export declare function loadBrowserEnabled(): boolean;
 export declare function saveBrowserEnabled(value: boolean): void;
 export declare function loadComputerUseEnabled(): boolean;
@@ -81,8 +111,6 @@ export declare function loadChatAvatarVisible(): boolean;
 export declare function loadChatVoiceMuted(): boolean;
 export declare function saveChatAvatarVisible(value: boolean): void;
 export declare function saveChatVoiceMuted(value: boolean): void;
-export declare function loadChatMode(): ConversationMode;
-export declare function saveChatMode(value: ConversationMode): void;
 export declare function loadActiveConversationId(): string | null;
 export declare function saveActiveConversationId(value: string | null): void;
 export declare function loadCompanionMessageCutoffTs(): number;
@@ -101,6 +129,7 @@ export interface PersistedActiveServer {
 }
 export declare function createPersistedActiveServer(args: {
     kind: PersistedActiveServer["kind"];
+    id?: string;
     apiBase?: string;
     accessToken?: string;
     label?: string;

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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"}

package/state/persistence.js

@@ -1,17 +1,18 @@
-import { logger } from "@elizaos/core";
+import { logger } from "@elizaos/logger";
 import { asRecord } from "@elizaos/shared";
 import { fetchWithCsrf } from "../api/csrf-client.js";
 import { getBootConfig } from "../config/boot-config-store.js";
 import { DEFAULT_UI_LANGUAGE, normalizeLanguage, } from "../i18n/index.js";
-import { applyThemeToDocument, clearThemeOverrides, resolveBuiltinTheme, } from "../themes/apply-theme.js";
+import { detectClientLanguage } from "../i18n/region.js";
+import { normalizeDirectCloudSharedAgentApiBase } from "../utils/cloud-agent-base.js";
+import { DEFAULT_LOCAL_ASR_AUTO_STOP } from "../voice/local-asr-capture.js";
 import { normalizeAvatarIndex } from "./vrm.js";
 /* ── Shared localStorage helper ──────────────────────────────────────── */
 function tryLocalStorage(fn, fallback) {
     try {
         return fn();
     }
-    catch (err) {
-        console.warn("[persistence] localStorage operation failed:", err);
+    catch {
         return fallback;
     }
 }
@@ -20,7 +21,48 @@ function describePersistenceError(err) {
 }
 const UI_THEME_STORAGE_KEY = "eliza:ui-theme";
 const LEGACY_UI_THEME_STORAGE_KEY = "elizaos:ui-theme";
-const THEME_ID_STORAGE_KEY = "eliza:theme-id";
+const UI_THEME_MODE_STORAGE_KEY = "eliza:ui-theme-mode";
+function normalizeUiThemeMode(value) {
+    return value === "light" || value === "dark" || value === "system"
+        ? value
+        : "system";
+}
+export { normalizeUiThemeMode };
+/**
+ * The app ships a single curated light look — there is no dark theme. Kept as a
+ * function (not a constant) so existing callers and the system-change listener
+ * keep their shape.
+ */
+export function getSystemTheme() {
+    return "light";
+}
+/**
+ * Resolve a {@link UiThemeMode} to a concrete {@link UiTheme}. The app is
+ * light-only, so every mode resolves to `light`.
+ */
+export function resolveUiTheme(_mode) {
+    return "light";
+}
+/**
+ * Load the persisted theme mode. New users (no stored value) default to
+ * `system`. A legacy concrete `eliza:ui-theme` value is treated as an
+ * explicit user choice and migrated into a `light`/`dark` mode.
+ */
+export function loadUiThemeMode() {
+    return tryLocalStorage(() => {
+        const mode = localStorage.getItem(UI_THEME_MODE_STORAGE_KEY);
+        if (mode != null)
+            return normalizeUiThemeMode(mode);
+        const legacy = localStorage.getItem(UI_THEME_STORAGE_KEY) ??
+            localStorage.getItem(LEGACY_UI_THEME_STORAGE_KEY);
+        return legacy === "light" || legacy === "dark" ? legacy : "system";
+    }, "system");
+}
+export function saveUiThemeMode(mode) {
+    tryLocalStorage(() => {
+        localStorage.setItem(UI_THEME_MODE_STORAGE_KEY, normalizeUiThemeMode(mode));
+    }, undefined);
+}
 const THEME_SWITCHING_ATTRIBUTE = "data-theme-switching";
 let themeSwitchResetFrameId = null;
 function normalizeUiTheme(value) {
@@ -56,17 +98,6 @@ export function saveUiTheme(theme) {
         localStorage.setItem(LEGACY_UI_THEME_STORAGE_KEY, normalized);
     }, undefined);
 }
-/* ── Theme ID persistence ────────────────────────────────────────────── */
-export function loadThemeId() {
-    return tryLocalStorage(() => {
-        return localStorage.getItem(THEME_ID_STORAGE_KEY) ?? "bsc-gold";
-    }, "bsc-gold");
-}
-export function saveThemeId(themeId) {
-    tryLocalStorage(() => {
-        localStorage.setItem(THEME_ID_STORAGE_KEY, themeId);
-    }, undefined);
-}
 const COMPANION_VRM_POWER_STORAGE_KEY = "eliza:companion-vrm-power";
 /** Legacy; migrated into `eliza:companion-vrm-power` on first read. */
 const LEGACY_COMPANION_EFFICIENCY_KEY = "eliza:companion-efficiency";
@@ -218,99 +249,62 @@ export function applyUiTheme(theme) {
             }
         }
     }
-    // Apply the active theme's color set (must run even when only themeId changed)
-    const themeId = loadThemeId();
-    if (themeId && themeId !== "bsc-gold") {
-        const theme = resolveBuiltinTheme(themeId);
-        if (theme) {
-            applyThemeToDocument(theme, normalizedTheme);
-        }
-    }
-    else {
-        // BSC Gold is the base.css default — clear any overrides
-        clearThemeOverrides();
-    }
 }
 const UI_LANGUAGE_STORAGE_KEY = "eliza:ui-language";
 const UI_SHELL_MODE_STORAGE_KEY = "eliza:ui-shell-mode";
 const LAST_NATIVE_TAB_STORAGE_KEY = "eliza:last-native-tab";
-const ONBOARDING_STEP_STORAGE_KEY = "eliza:onboarding:step";
-function normalizeOnboardingStep(value) {
+const SETUP_STEP_STORAGE_KEY = "eliza:setup:step";
+function normalizeSetupStep(value) {
     switch (value) {
-        case "deployment":
-        case "providers":
-        case "features":
-            return value;
-        case "identity":
-            // Identity/character selection was removed; restart at the setup step.
-            return "deployment";
-        case "permissions":
-        case "launch":
-            // permissions/launch removed — resume at providers
-            return "providers";
-        // Legacy step ID migration — map old persisted values to new equivalents
-        case "cloud_login":
-        case "welcome":
-            // cloud_login is now part of deployment step; resume at deployment
-            return "deployment";
-        case "hosting":
         case "connection":
-            // hosting is now part of deployment step; resume at providers
-            return "providers";
-        case "cloudLogin":
-        case "rpc":
-            return "providers";
-        case "voice":
-        case "senses":
-            // voice/permissions removed from onboarding; resume at providers
-            return "providers";
-        case "activate":
-            return "providers";
+        case "model":
+        case "capabilities":
+            return value;
         default:
             return null;
     }
 }
-export function loadPersistedOnboardingStep() {
-    return tryLocalStorage(() => normalizeOnboardingStep(localStorage.getItem(ONBOARDING_STEP_STORAGE_KEY)), null);
+export function loadPersistedSetupStep() {
+    return tryLocalStorage(() => normalizeSetupStep(localStorage.getItem(SETUP_STEP_STORAGE_KEY)), null);
 }
-export function saveOnboardingStep(step) {
+export function saveSetupStep(step) {
     tryLocalStorage(() => {
-        localStorage.setItem(ONBOARDING_STEP_STORAGE_KEY, step);
+        localStorage.setItem(SETUP_STEP_STORAGE_KEY, step);
     }, undefined);
 }
-export function clearPersistedOnboardingStep() {
+export function clearPersistedSetupStep() {
     tryLocalStorage(() => {
-        localStorage.removeItem(ONBOARDING_STEP_STORAGE_KEY);
+        localStorage.removeItem(SETUP_STEP_STORAGE_KEY);
     }, undefined);
 }
-/* ── Onboarding completion persistence ────────────────────────────────── */
-const ONBOARDING_COMPLETE_STORAGE_KEY = "eliza:onboarding-complete";
-export function loadPersistedOnboardingComplete() {
+/* ── First-run completion persistence ────────────────────────────────── */
+const FIRST_RUN_COMPLETE_STORAGE_KEY = "eliza:first-run-complete";
+export function loadPersistedFirstRunComplete() {
     if (typeof localStorage === "undefined") {
         return false;
     }
     try {
-        return localStorage.getItem(ONBOARDING_COMPLETE_STORAGE_KEY) === "1";
+        return localStorage.getItem(FIRST_RUN_COMPLETE_STORAGE_KEY) === "1";
     }
     catch (err) {
-        logger.warn(`[persistence] failed to load onboarding completion flag: ${describePersistenceError(err)}`);
+        logger.warn(`[persistence] failed to load first-run completion flag: ${describePersistenceError(err)}`);
         return false;
     }
 }
-export function savePersistedOnboardingComplete(complete) {
+export function savePersistedFirstRunComplete(complete) {
     if (typeof localStorage === "undefined") {
         return;
     }
     try {
         if (complete) {
-            localStorage.setItem(ONBOARDING_COMPLETE_STORAGE_KEY, "1");
+            localStorage.setItem(FIRST_RUN_COMPLETE_STORAGE_KEY, "1");
         }
         else {
-            localStorage.removeItem(ONBOARDING_COMPLETE_STORAGE_KEY);
+            localStorage.removeItem(FIRST_RUN_COMPLETE_STORAGE_KEY);
         }
     }
     catch (err) {
-        logger.warn(`[persistence] failed to save onboarding completion flag: ${describePersistenceError(err)}`);
+        logger.warn(`[persistence] failed to save first-run completion flag: ${describePersistenceError(err)}`);
     }
 }
 /* ── Content pack persistence ───────────────────────────────────────── */
@@ -345,7 +339,10 @@ export function savePersistedActivePackUrl(packUrl) {
 export function loadUiLanguage() {
     return tryLocalStorage(() => {
         const stored = localStorage.getItem(UI_LANGUAGE_STORAGE_KEY);
-        return normalizeLanguage(stored ?? DEFAULT_UI_LANGUAGE);
+        if (stored != null)
+            return normalizeLanguage(stored);
+        // No explicit user choice yet — guess from browser/region hints.
+        return detectClientLanguage() ?? DEFAULT_UI_LANGUAGE;
     }, DEFAULT_UI_LANGUAGE);
 }
 export function saveUiLanguage(language) {
@@ -353,6 +350,10 @@ export function saveUiLanguage(language) {
         localStorage.setItem(UI_LANGUAGE_STORAGE_KEY, normalizeLanguage(language));
     }, undefined);
 }
+/** Whether the user has a persisted UI language (vs. a fresh first visit). */
+export function hasStoredUiLanguage() {
+    return tryLocalStorage(() => localStorage.getItem(UI_LANGUAGE_STORAGE_KEY) != null, false);
+}
 function normalizeUiShellMode(mode) {
     return mode === "native" ? "native" : "companion";
 }
@@ -375,7 +376,6 @@ function normalizeLastNativeTab(tab) {
         case "browser":
         case "inventory":
         case "documents":
-        case "connectors":
         case "triggers":
         case "plugins":
         case "skills":
@@ -574,6 +574,55 @@ export function saveWalletEnabled(value) {
         localStorage.setItem(WALLET_ENABLED_KEY, String(value));
     }, undefined);
 }
+/* ── Continuous chat mode persistence ───────────────────────────────────── */
+const CONTINUOUS_CHAT_MODE_KEY = "eliza:voice:continuous-chat-mode";
+function normalizeContinuousChatMode(value) {
+    if (value === "vad-gated" || value === "always-on")
+        return value;
+    return "off";
+}
+export function loadContinuousChatMode() {
+    return tryLocalStorage(() => normalizeContinuousChatMode(localStorage.getItem(CONTINUOUS_CHAT_MODE_KEY)), "off");
+}
+export function saveContinuousChatMode(mode) {
+    tryLocalStorage(() => {
+        localStorage.setItem(CONTINUOUS_CHAT_MODE_KEY, mode);
+    }, undefined);
+}
+/* ── VAD auto-stop persistence ──────────────────────────────────────────── */
+// Local mirror of the `vadAutoStop` voice setting (source of truth is the agent
+// config under `messages.voice`). Stored here too so the capture hot path
+// (`useShellController.startCapture`) can read it synchronously on the user
+// gesture without an async config fetch — mirrors how continuous-chat-mode is
+// dual-stored above.
+const VAD_AUTO_STOP_KEY = "eliza:voice:vad-auto-stop";
+const DEFAULT_VAD_AUTO_STOP = {
+    silenceMs: DEFAULT_LOCAL_ASR_AUTO_STOP.silenceMs,
+    speechRmsThreshold: DEFAULT_LOCAL_ASR_AUTO_STOP.speechRmsThreshold,
+};
+export function loadVadAutoStop() {
+    return tryLocalStorage(() => {
+        const raw = localStorage.getItem(VAD_AUTO_STOP_KEY);
+        if (!raw)
+            return DEFAULT_VAD_AUTO_STOP;
+        const parsed = JSON.parse(raw);
+        return {
+            silenceMs: typeof parsed.silenceMs === "number" &&
+                Number.isFinite(parsed.silenceMs)
+                ? parsed.silenceMs
+                : DEFAULT_VAD_AUTO_STOP.silenceMs,
+            speechRmsThreshold: typeof parsed.speechRmsThreshold === "number" &&
+                Number.isFinite(parsed.speechRmsThreshold)
+                ? parsed.speechRmsThreshold
+                : DEFAULT_VAD_AUTO_STOP.speechRmsThreshold,
+        };
+    }, DEFAULT_VAD_AUTO_STOP);
+}
+export function saveVadAutoStop(value) {
+    tryLocalStorage(() => {
+        localStorage.setItem(VAD_AUTO_STOP_KEY, JSON.stringify(value));
+    }, undefined);
+}
 /* ── Browser enabled persistence ────────────────────────────────────── */
 const BROWSER_ENABLED_KEY = "eliza:browser:enabled";
 export function loadBrowserEnabled() {
@@ -625,21 +674,8 @@ export function saveChatVoiceMuted(value) {
         localStorage.setItem(CHAT_VOICE_MUTED_KEY, String(value));
     }, undefined);
 }
-/* ── Chat mode persistence ─────────────────────────────────────────────── */
-const CHAT_MODE_KEY = "eliza:chat:mode";
 const ACTIVE_CONVERSATION_ID_KEY = "eliza:chat:activeConversationId";
 const COMPANION_MESSAGE_CUTOFF_TS_KEY = "eliza:chat:companionMessageCutoffTs";
-export function loadChatMode() {
-    return tryLocalStorage(() => {
-        const stored = localStorage.getItem(CHAT_MODE_KEY);
-        return stored === "power" ? "power" : "simple";
-    }, "simple");
-}
-export function saveChatMode(value) {
-    tryLocalStorage(() => {
-        localStorage.setItem(CHAT_MODE_KEY, value);
-    }, undefined);
-}
 export function loadActiveConversationId() {
     return tryLocalStorage(() => {
         const stored = localStorage.getItem(ACTIVE_CONVERSATION_ID_KEY)?.trim();
@@ -688,14 +724,28 @@ function normalizeApiBase(value) {
     let end = trimmed.length;
     while (end > 0 && trimmed.charCodeAt(end - 1) === 47)
         end--;
-    return trimmed.slice(0, end);
+    return normalizeDirectCloudSharedAgentApiBase(trimmed.slice(0, end));
 }
 function isElizaCloudControlPlaneApiBase(value) {
     const apiBase = normalizeApiBase(value);
     if (!apiBase)
         return false;
     try {
-        return ELIZA_CLOUD_CONTROL_PLANE_HOSTS.has(new URL(apiBase).hostname.toLowerCase());
+        const url = new URL(apiBase);
+        if (!ELIZA_CLOUD_CONTROL_PLANE_HOSTS.has(url.hostname.toLowerCase())) {
+            return false;
+        }
+        // The BARE control-plane origin (no path) AND the agent-id-less agents
+        // COLLECTION (`/api/v1/eliza/agents`, no `/<id>`) are both "managed cloud"
+        // endpoints with no agent selected — their apiBase is derived at runtime and
+        // must NOT be persisted (persisting the id-less collection makes every
+        // /api/* call concat to `.../agents/api/...` and 404 with "Backend
+        // Unreachable"). A specific per-agent base on the same host — a shared-runtime
+        // REST adapter at /api/v1/eliza/agents/<id> — IS concrete and MUST be
+        // persisted; dropping it loses the agent the client must talk to. Treat any
+        // other non-trivial path as concrete.
+        const pathname = url.pathname.replace(/\/+$/, "");
+        return pathname === "" || pathname === "/api/v1/eliza/agents";
     }
     catch (err) {
         logger.debug(`[persistence] failed to parse apiBase URL while checking Eliza Cloud control plane: apiBase=${apiBase}; error=${describePersistenceError(err)}`);
@@ -718,7 +768,7 @@ export function createPersistedActiveServer(args) {
             };
         case "cloud":
             return {
-                id: `cloud:${apiBase ?? "managed"}`,
+                id: trimPersistedValue(args.id) ?? `cloud:${apiBase ?? "managed"}`,
                 kind: "cloud",
                 label: explicitLabel ?? "Eliza Cloud",
                 ...(apiBase ? { apiBase } : {}),

package/state/private-network-host.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Canonical "is this host on a private / loopback / LAN network" test.
+ *
+ * Single source of truth for the protocol-selection and cloud-login-backend
+ * decisions that branch on whether the agent backend lives on the local
+ * machine or LAN (`useCloudState`, `useOnboardingCallbacks`). Covers
+ * loopback, RFC1918 ranges, the Tailscale CGNAT range (100.64.0.0/10), and
+ * the `.local` / `.internal` mDNS / private suffixes.
+ */
+export declare function isPrivateNetworkHost(host: string): boolean;
+//# sourceMappingURL=private-network-host.d.ts.map

package/state/private-network-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"private-network-host.d.ts","sourceRoot":"","sources":["../../../../../src/state/private-network-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CA0B1D"}

package/state/private-network-host.js

@@ -0,0 +1,35 @@
+/**
+ * Canonical "is this host on a private / loopback / LAN network" test.
+ *
+ * Single source of truth for the protocol-selection and cloud-login-backend
+ * decisions that branch on whether the agent backend lives on the local
+ * machine or LAN (`useCloudState`, `useOnboardingCallbacks`). Covers
+ * loopback, RFC1918 ranges, the Tailscale CGNAT range (100.64.0.0/10), and
+ * the `.local` / `.internal` mDNS / private suffixes.
+ */
+export function isPrivateNetworkHost(host) {
+    const normalized = host
+        .trim()
+        .toLowerCase()
+        .replace(/^\[|\]$/g, "");
+    if (normalized === "localhost" ||
+        normalized === "127.0.0.1" ||
+        normalized === "::1" ||
+        normalized.endsWith(".local") ||
+        normalized.endsWith(".internal")) {
+        return true;
+    }
+    if (/^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(normalized))
+        return true;
+    if (/^10\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(normalized))
+        return true;
+    if (/^192\.168\.\d{1,3}\.\d{1,3}$/.test(normalized))
+        return true;
+    if (/^172\.(1[6-9]|2\d|3[0-1])\.\d{1,3}\.\d{1,3}$/.test(normalized)) {
+        return true;
+    }
+    if (/^100\.(6[4-9]|[7-9]\d|1[01]\d|12[0-7])\.\d{1,3}\.\d{1,3}$/.test(normalized)) {
+        return true;
+    }
+    return false;
+}

package/state/setup-resume.d.ts

@@ -0,0 +1,9 @@
+import type { BuildFirstRunConnectionArgs } from "../first-run/first-run-config";
+import type { SetupStep } from "./types";
+export declare function hasPartialSetupConnectionConfig(config: Record<string, unknown> | null | undefined): boolean;
+export declare function inferSetupResumeStep(args: {
+    config?: Record<string, unknown> | null;
+    persistedStep?: SetupStep | null;
+}): SetupStep;
+export declare function deriveFirstRunResumeFieldsFromConfig(config: Record<string, unknown> | null | undefined): Partial<BuildFirstRunConnectionArgs>;
+//# sourceMappingURL=setup-resume.d.ts.map

package/state/setup-resume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-resume.d.ts","sourceRoot":"","sources":["../../../../../src/state/setup-resume.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAGjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,OAAO,CAqBT;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxC,aAAa,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CAClC,GAAG,SAAS,CAUZ;AAED,wBAAgB,oCAAoC,CAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACjD,OAAO,CAAC,2BAA2B,CAAC,CAkFtC"}