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

package/hooks/index.d.ts

@@ -1,25 +1,28 @@
-export { BugReportProvider } from "./BugReportProvider";
-export * from "./useActivityEvents";
-export * from "./useAutomationDeepLink";
-export * from "./useBugReport.hooks";
-export * from "./useChatAvatarVoiceBridge";
-export * from "./useCloudHandoffPhase";
-export * from "./useConnectorAccounts";
-export * from "./useConnectorReconnect";
-export * from "./useConnectorSendAsAccount";
-export * from "./useContextMenu";
-export * from "./useDesktopBridgeEvent";
-export * from "./useDocumentVisibility";
-export * from "./useFetchData";
-export { COMMON_SHORTCUTS } from "./useKeyboardShortcuts";
-export * from "./useLinkedSidebarSelection";
-export * from "./useMediaQuery";
-export * from "./useModalState";
-export * from "./useRenderGuard";
-export * from "./useRuntimeMode";
-export * from "./useSignalPairing";
-export * from "./useTimeout";
-export * from "./useViewEvent";
-export * from "./useVoiceChat";
-export * from "./useWhatsAppPairing";
+export { BugReportProvider } from "./BugReportProvider.js";
+export * from "./frame-budget.js";
+export * from "./useActivityEvents.js";
+export * from "./useAutomationDeepLink.js";
+export * from "./useBugReport.hooks.js";
+export * from "./useChatAvatarVoiceBridge.js";
+export * from "./useCloudHandoffPhase.js";
+export * from "./useConnectorAccounts.js";
+export * from "./useConnectorReconnect.js";
+export * from "./useConnectorSendAsAccount.js";
+export * from "./useContextMenu.js";
+export * from "./useDesktopBridgeEvent.js";
+export * from "./useDocumentVisibility.js";
+export * from "./useFetchData.js";
+export * from "./useFrameBudgetMonitor.js";
+export { COMMON_SHORTCUTS } from "./useKeyboardShortcuts.js";
+export * from "./useLayoutShiftMonitor.js";
+export * from "./useLinkedSidebarSelection.js";
+export * from "./useMediaQuery.js";
+export * from "./useModalState.js";
+export * from "./useRenderGuard.js";
+export * from "./useRuntimeMode.js";
+export * from "./useSignalPairing.js";
+export * from "./useTimeout.js";
+export * from "./useViewEvent.js";
+export * from "./useVoiceChat.js";
+export * from "./useWhatsAppPairing.js";
 //# sourceMappingURL=index.d.ts.map

package/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC"}

package/hooks/index.js

@@ -1,4 +1,5 @@
 export { BugReportProvider } from "./BugReportProvider.js";
+export * from "./frame-budget.js";
 export * from "./useActivityEvents.js";
 export * from "./useAutomationDeepLink.js";
 export * from "./useBugReport.hooks.js";
@@ -11,7 +12,9 @@ export * from "./useContextMenu.js";
 export * from "./useDesktopBridgeEvent.js";
 export * from "./useDocumentVisibility.js";
 export * from "./useFetchData.js";
+export * from "./useFrameBudgetMonitor.js";
 export { COMMON_SHORTCUTS } from "./useKeyboardShortcuts.js";
+export * from "./useLayoutShiftMonitor.js";
 export * from "./useLinkedSidebarSelection.js";
 export * from "./useMediaQuery.js";
 export * from "./useModalState.js";

package/hooks/resource-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-cache.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/resource-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAyCH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;CACnB;AAmCD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,GAAG,EAAE,MAAM,EACX,OAAO,UAAQ,GACd,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAoB/B;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,UAAQ,GAAG,IAAI,CAKxE;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAU5C;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAajE;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,UAAQ,EACf,KAAK,UAAQ,GACZ,OAAO,CAAC,CAAC,CAAC,CA2BZ;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,GACjB,MAAM,IAAI,CAkDZ;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,IAAI,IAAI,CAe3C"}
+{"version":3,"file":"resource-cache.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/resource-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAyCH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;CACnB;AAmCD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,GAAG,EAAE,MAAM,EACX,OAAO,UAAQ,GACd,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,CAoB/B;AAwBD,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,UAAQ,GAAG,IAAI,CAkBxE;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAU5C;AAED,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAajE;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,UAAQ,EACf,KAAK,UAAQ,GACZ,OAAO,CAAC,CAAC,CAAC,CA2BZ;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,GACjB,MAAM,IAAI,CAkDZ;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,IAAI,IAAI,CAe3C"}

package/hooks/resource-cache.js

@@ -93,8 +93,44 @@ export function getCached(key, persist = false) {
     }
     return undefined;
 }
+/**
+ * Conservative deep equality for cached payloads. Cache values are fetched JSON
+ * (no functions/symbols/cycles), so a stringify compare is correct and cheap
+ * relative to the re-render it prevents. Anything non-serializable or stringify
+ * that throws falls through to "not equal" so a real update is never skipped.
+ */
+function cacheDataEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== "object" ||
+        typeof b !== "object" ||
+        a === null ||
+        b === null)
+        return false;
+    try {
+        return JSON.stringify(a) === JSON.stringify(b);
+    }
+    catch {
+        return false;
+    }
+}
 /** Overwrite the cached value for a key and notify subscribers. */
 export function setCached(key, data, persist = false) {
+    // A poll that returns an unchanged payload (the common case) must not churn
+    // the snapshot reference — useSyncExternalStore compares by reference, so a
+    // fresh-but-equal entry re-renders every consumer (e.g. the router + tab bar
+    // every 30s for useAvailableViews). Refresh freshness in place and skip the
+    // notify, keeping the same snapshot object the CacheEntry contract promises.
+    const existing = store.get(key);
+    if (existing && cacheDataEqual(existing.data, data)) {
+        const now = Date.now();
+        existing.updatedAt = now;
+        if (existing.snapshot)
+            existing.snapshot.updatedAt = now;
+        if (persist)
+            writePersisted(key, { data: existing.data, updatedAt: now });
+        return;
+    }
     const entry = { data, updatedAt: Date.now() };
     store.set(key, entry);
     if (persist)

package/hooks/useAccounts.d.ts

@@ -9,9 +9,8 @@
  * `setActionNotice` so the parent settings panel can surface them.
  */
 import type { LinkedAccountProviderId } from "@elizaos/shared";
-import type { AccountStrategy, AccountsListResponse, AccountTestResult } from "../api/client-agent";
-type ActionTone = "info" | "success" | "error";
-type ActionNoticeFn = (text: string, tone?: ActionTone, ttlMs?: number, once?: boolean, busy?: boolean) => void;
+import type { AccountStrategy, AccountsListResponse, AccountTestResult } from "../api/client-agent.js";
+import type { ActionNoticeFn } from "../state/action-notice.js";
 export interface UseAccountsOptions {
     setActionNotice?: ActionNoticeFn;
     /** How often to refetch the full list. Defaults to 30s. */
@@ -37,5 +36,4 @@ export interface UseAccountsResult {
     setStrategy: (providerId: LinkedAccountProviderId, strategy: AccountStrategy) => Promise<void>;
 }
 export declare function useAccounts(opts?: UseAccountsOptions): UseAccountsResult;
-export {};
 //# sourceMappingURL=useAccounts.d.ts.map

package/hooks/useAccounts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAccounts.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useAccounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAEV,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAG7B,KAAK,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/C,KAAK,cAAc,GAAG,CACpB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,UAAU,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EACd,IAAI,CAAC,EAAE,OAAO,KACX,IAAI,CAAC;AAEV,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,YAAY,EAAE,CACZ,UAAU,EAAE,uBAAuB,EACnC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KACpC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,KAAK,EAAE,CACL,UAAU,EAAE,uBAAuB,EACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,KACjE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,EAAE,CACN,UAAU,EAAE,uBAAuB,EACnC,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,IAAI,EAAE,CACJ,UAAU,EAAE,uBAAuB,EACnC,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChC,YAAY,EAAE,CACZ,UAAU,EAAE,uBAAuB,EACnC,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,EAAE,CACX,UAAU,EAAE,uBAAuB,EACnC,QAAQ,EAAE,eAAe,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAmCD,wBAAgB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,iBAAiB,CAiO5E"}
+{"version":3,"file":"useAccounts.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useAccounts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAEV,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,MAAM,WAAW,kBAAkB;IACjC,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,YAAY,EAAE,CACZ,UAAU,EAAE,uBAAuB,EACnC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KACpC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,KAAK,EAAE,CACL,UAAU,EAAE,uBAAuB,EACnC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,KACjE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,MAAM,EAAE,CACN,UAAU,EAAE,uBAAuB,EACnC,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,IAAI,EAAE,CACJ,UAAU,EAAE,uBAAuB,EACnC,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAChC,YAAY,EAAE,CACZ,UAAU,EAAE,uBAAuB,EACnC,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,EAAE,CACX,UAAU,EAAE,uBAAuB,EACnC,QAAQ,EAAE,eAAe,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAmCD,wBAAgB,WAAW,CAAC,IAAI,GAAE,kBAAuB,GAAG,iBAAiB,CAmO5E"}

package/hooks/useAccounts.js

@@ -44,6 +44,8 @@ export function useAccounts(opts = {}) {
     const [loading, setLoading] = useState(true);
     const [saving, setSaving] = useState(() => new Set());
     const mountedRef = useRef(true);
+    const dataRef = useRef(data);
+    dataRef.current = data;
     const notify = useCallback((prefix, err) => {
         setActionNotice?.(describeError(prefix, err), "error", 6000);
     }, [setActionNotice]);
@@ -106,7 +108,7 @@ export function useAccounts(opts = {}) {
     }, [markSaving, notify, refresh]);
     const patch = useCallback(async (providerId, accountId, body) => {
         markSaving(accountId, true);
-        const previous = data;
+        const previous = dataRef.current;
         // Optimistic update for safe fields.
         setData((prev) => {
             if (!prev)
@@ -136,7 +138,7 @@ export function useAccounts(opts = {}) {
         finally {
             markSaving(accountId, false);
         }
-    }, [data, markSaving, notify]);
+    }, [markSaving, notify]);
     const remove = useCallback(async (providerId, accountId) => {
         markSaving(accountId, true);
         try {
@@ -201,7 +203,7 @@ export function useAccounts(opts = {}) {
     const setStrategy = useCallback(async (providerId, strategy) => {
         const key = `strategy:${providerId}`;
         markSaving(key, true);
-        const previous = data;
+        const previous = dataRef.current;
         setData((prev) => {
             if (!prev)
                 return prev;
@@ -220,7 +222,7 @@ export function useAccounts(opts = {}) {
         finally {
             markSaving(key, false);
         }
-    }, [data, markSaving, notify]);
+    }, [markSaving, notify]);
     useEffect(() => {
         mountedRef.current = true;
         void refresh();

package/hooks/useActivityEvents.d.ts

@@ -2,12 +2,24 @@
  * Hook that subscribes to WebSocket activity events and maintains a ring buffer
  * of recent entries for the chat widget rail.
  */
+export interface ActivityEventSource {
+    type: "pty-session-event" | "proactive-message" | "agent_event";
+    stream?: string;
+    data?: unknown;
+    seq?: number;
+    ts?: number;
+    runId?: string;
+    agentId?: string;
+    roomId?: string;
+    sessionKey?: string;
+}
 export interface ActivityEvent {
     id: string;
     timestamp: number;
     eventType: string;
     sessionId?: string;
     summary: string;
+    source?: ActivityEventSource;
 }
 /**
  * Subscribe to task/proactive websocket events plus assistant activity events,

package/hooks/useActivityEvents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useActivityEvents.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useActivityEvents.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAiDD;;;GAGG;AACH,wBAAgB,iBAAiB;;;EA4HhC"}
+{"version":3,"file":"useActivityEvents.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useActivityEvents.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,mBAAmB,GAAG,mBAAmB,GAAG,aAAa,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAiCD;;;GAGG;AACH,wBAAgB,iBAAiB;;;EAuHhC"}

package/hooks/useActivityEvents.js

@@ -2,6 +2,7 @@
  * Hook that subscribes to WebSocket activity events and maintains a ring buffer
  * of recent entries for the chat widget rail.
  */
+import { activityEventToPlaintext } from "@elizaos/core";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { client } from "../api/index.js";
 import { parseProactiveMessageEvent } from "../state/parsers.js";
@@ -11,37 +12,26 @@ function makeEventId() {
     nextEventId += 1;
     return `evt-${nextEventId}-${Date.now()}`;
 }
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
+function readString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
 }
-function summarizeAssistantActivityEvent(data) {
-    if (data.type !== "agent_event" || data.stream !== "assistant") {
-        return null;
-    }
-    const payload = isRecord(data.payload) ? data.payload : null;
-    if (!payload) {
-        return null;
-    }
-    const source = typeof payload.source === "string" ? payload.source : "";
-    const text = typeof payload.text === "string" ? payload.text.trim().slice(0, 120) : "";
-    if (!text) {
-        return null;
-    }
-    switch (source) {
-        case "lifeops-reminder":
-            return { eventType: "reminder", summary: text };
-        case "lifeops-workflow":
-            return { eventType: "workflow", summary: text };
-        case "proactive-gm":
-        case "proactive-gn":
-        case "proactive-goal-check-in":
-            return { eventType: "check-in", summary: text };
-        case "proactive-nudge":
-        case "proactive-social-overuse":
-            return { eventType: "nudge", summary: text };
-        default:
-            return null;
-    }
+function readFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value)
+        ? value
+        : undefined;
+}
+function agentEventSource(data) {
+    return {
+        type: "agent_event",
+        stream: readString(data.stream),
+        data: data.payload ?? data.data,
+        seq: readFiniteNumber(data.seq),
+        ts: readFiniteNumber(data.ts),
+        runId: readString(data.runId),
+        agentId: readString(data.agentId),
+        roomId: readString(data.roomId),
+        sessionKey: readString(data.sessionKey),
+    };
 }
 /**
  * Subscribe to task/proactive websocket events plus assistant activity events,
@@ -78,40 +68,20 @@ export function useActivityEvents() {
     }, [scheduleFlush]);
     useEffect(() => {
         const unbindPty = client.onWsEvent("pty-session-event", (data) => {
-            // Validate the WS boundary instead of casting: strings stay strings,
-            // anything else becomes undefined so a malformed event can't poison the rail.
-            const str = (v) => typeof v === "string" ? v : undefined;
-            const eventType = str(data.eventType) ?? str(data.type) ?? "";
-            const sessionId = str(data.sessionId);
-            const d = isRecord(data.data) ? data.data : undefined;
-            let summary = eventType;
-            if (eventType === "task_registered") {
-                summary = `Task started: ${str(d?.label) ?? sessionId ?? "unknown"}`;
-            }
-            else if (eventType === "task_complete" || eventType === "stopped") {
-                summary = `Task ${eventType === "task_complete" ? "completed" : "stopped"}`;
-            }
-            else if (eventType === "tool_running") {
-                const tool = str(d?.description) ?? str(d?.toolName) ?? "tool";
-                summary = `Running ${tool}`.slice(0, 80);
-            }
-            else if (eventType === "blocked") {
-                summary = "Waiting for input";
-            }
-            else if (eventType === "blocked_auto_resolved") {
-                summary = "Decision auto-approved";
-            }
-            else if (eventType === "escalation") {
-                summary = "Escalated — needs attention";
-            }
-            else if (eventType === "error") {
-                summary = "Error occurred";
-            }
+            const activity = activityEventToPlaintext(data, { maxLength: 120 });
+            if (!activity)
+                return;
             pushEvent({
-                timestamp: Date.now(),
-                eventType,
-                sessionId: sessionId ?? undefined,
-                summary,
+                timestamp: readFiniteNumber(data.ts) ?? Date.now(),
+                eventType: activity.eventType,
+                sessionId: activity.sessionId,
+                summary: activity.plaintext,
+                source: {
+                    type: "pty-session-event",
+                    data,
+                    ts: readFiniteNumber(data.ts),
+                    sessionKey: readString(data.sessionId),
+                },
             });
         });
         const unbindProactive = client.onWsEvent("proactive-message", (data) => {
@@ -123,21 +93,30 @@ export function useActivityEvents() {
             if (!parsed)
                 return;
             const summary = parsed.message.text.trim().slice(0, 120) || "Proactive message";
+            const activity = activityEventToPlaintext({ type: "proactive-message", message: { text: summary } }, { maxLength: 120 });
             pushEvent({
-                timestamp: Date.now(),
-                eventType: "proactive-message",
-                summary,
+                timestamp: readFiniteNumber(data.ts) ?? Date.now(),
+                eventType: activity?.eventType ?? "proactive-message",
+                summary: activity?.plaintext ?? summary,
+                source: {
+                    type: "proactive-message",
+                    data,
+                    ts: readFiniteNumber(data.ts),
+                },
             });
         });
         const unbindAgent = client.onWsEvent("agent_event", (data) => {
-            const activity = summarizeAssistantActivityEvent(data);
+            const activity = activityEventToPlaintext(data, { maxLength: 120 });
             if (!activity) {
                 return;
             }
+            const source = agentEventSource(data);
             pushEvent({
-                timestamp: Date.now(),
+                timestamp: source.ts ?? Date.now(),
                 eventType: activity.eventType,
-                summary: activity.summary,
+                sessionId: activity.sessionId ?? source.sessionKey,
+                summary: activity.plaintext,
+                source,
             });
         });
         return () => {

package/hooks/useAuthStatus.d.ts

@@ -9,7 +9,7 @@
  *
  * Call `refetch()` after login / logout to force a fresh check.
  */
-import { type AuthAccessInfo, type AuthIdentity, type AuthSessionInfo } from "../api/auth-client";
+import { type AuthAccessInfo, type AuthIdentity, type AuthSessionInfo } from "../api/auth-client.js";
 export type AuthStatusState = {
     phase: "loading";
 } | {

package/hooks/useAuthStatus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAuthStatus.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useAuthStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EAErB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,eAAe,GACvB;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GACpB;IACE,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,cAAc,CAAC;CACxB,GACD;IACE,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,sBAAsB,GAAG,gCAAgC,CAAC;IACnE,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,GACD;IAAE,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEpC,UAAU,oBAAoB;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAuED,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG;IACjE,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAkCA"}
+{"version":3,"file":"useAuthStatus.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useAuthStatus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,eAAe,EAErB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,MAAM,eAAe,GACvB;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GACpB;IACE,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,cAAc,CAAC;CACxB,GACD;IACE,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,CAAC,EAAE,sBAAsB,GAAG,gCAAgC,CAAC;IACnE,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,GACD;IAAE,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEpC,UAAU,oBAAoB;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAuED,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG;IACjE,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAwDA"}

package/hooks/useAuthStatus.js

@@ -94,9 +94,27 @@ export function useAuthStatus(options = {}) {
         if (skip || observeOnly || pollIntervalMs === 0)
             return;
         const id = setInterval(() => {
+            if (typeof document !== "undefined" &&
+                document.visibilityState === "hidden") {
+                return;
+            }
             void fetch();
         }, pollIntervalMs);
-        return () => clearInterval(id);
+        const visibilityHandler = typeof document !== "undefined"
+            ? () => {
+                if (document.visibilityState === "visible")
+                    void fetch();
+            }
+            : undefined;
+        if (visibilityHandler) {
+            document.addEventListener("visibilitychange", visibilityHandler);
+        }
+        return () => {
+            clearInterval(id);
+            if (visibilityHandler && typeof document !== "undefined") {
+                document.removeEventListener("visibilitychange", visibilityHandler);
+            }
+        };
     }, [skip, observeOnly, pollIntervalMs, fetch]);
     return { state, refetch: fetch };
 }

package/hooks/useAvailableViews.d.ts

@@ -1,14 +1,15 @@
 /**
  * Fetches available views from GET /api/views.
  *
- * This hook is the primary data source for the ViewCatalog. When the
+ * This hook is the primary data source for Springboard. When the
  * /api/views endpoint is live, it will return the full ViewRegistryEntry list.
- * Until then it returns an empty list so the ViewCatalog renders gracefully.
+ * Until then it returns an empty list so Springboard renders gracefully.
  *
  * Polling interval: 30s. The endpoint is expected to be cheap (in-memory list).
  * Polling can be replaced with a WebSocket subscription when
  * plugins are installed or uninstalled at runtime.
  */
+import type { AppShellBackgroundPolicy, ViewKind } from "@elizaos/core";
 export interface ViewRegistryEntry {
     /** Stable unique identifier for the view, e.g. "wallet.inventory". */
     id: string;
@@ -39,12 +40,23 @@ export interface ViewRegistryEntry {
     hasHeroImage?: boolean;
     /** Whether the view is currently loadable. */
     available: boolean;
+    /** Screen background policy for this view. Defaults to `"opaque"`. */
+    backgroundPolicy?: AppShellBackgroundPolicy;
     /** The plugin that provides this view. */
     pluginName: string;
     /** Freeform tags used for search and filtering. */
     tags?: string[];
-    /** When true, the view only appears when Developer Mode is enabled. */
+    /**
+     * When true, the view only appears when Developer Mode is enabled.
+     * Equivalent to `viewKind: "developer"`.
+     */
     developerOnly?: boolean;
+    /**
+     * Four-tier visibility category. Supersedes `developerOnly` when set:
+     * `system`/`release` always show; `developer`/`preview` follow Settings
+     * toggles. See `ViewKind` in `@elizaos/core`.
+     */
+    viewKind?: ViewKind;
     /** When false, the view is hidden from the manager grid (internal views). */
     visibleInManager?: boolean;
     /** Named capabilities the view exposes (informational). */
@@ -67,6 +79,8 @@ interface UseAvailableViewsResult {
     /** Re-fetches immediately. */
     refresh: () => void;
 }
+export declare function withBuiltinShellViews(views: ViewRegistryEntry[]): ViewRegistryEntry[];
 export declare function useAvailableViews(): UseAvailableViewsResult;
+export declare function useRoutableViews(): UseAvailableViewsResult;
 export {};
 //# sourceMappingURL=useAvailableViews.d.ts.map

package/hooks/useAvailableViews.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAvailableViews.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useAvailableViews.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;IAChC,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,uEAAuE;IACvE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,UAAU,uBAAuB;IAC/B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAyID,wBAAgB,iBAAiB,IAAI,uBAAuB,CAyC3D"}
+{"version":3,"file":"useAvailableViews.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useAvailableViews.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAcxE,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;IAChC,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,wBAAwB,CAAC;IAC5C,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,UAAU,uBAAuB;IAC/B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAmND,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,iBAAiB,EAAE,GACzB,iBAAiB,EAAE,CAErB;AAED,wBAAgB,iBAAiB,IAAI,uBAAuB,CAyC3D;AAED,wBAAgB,gBAAgB,IAAI,uBAAuB,CAa1D"}

package/hooks/useAvailableViews.js

@@ -1,9 +1,9 @@
 /**
  * Fetches available views from GET /api/views.
  *
- * This hook is the primary data source for the ViewCatalog. When the
+ * This hook is the primary data source for Springboard. When the
  * /api/views endpoint is live, it will return the full ViewRegistryEntry list.
- * Until then it returns an empty list so the ViewCatalog renders gracefully.
+ * Until then it returns an empty list so Springboard renders gracefully.
  *
  * Polling interval: 30s. The endpoint is expected to be cheap (in-memory list).
  * Polling can be replaced with a WebSocket subscription when
@@ -12,6 +12,7 @@
 import { useEffect, useMemo, useSyncExternalStore } from "react";
 import { fetchWithCsrf } from "../api/csrf-client.js";
 import { getAppShellPageRegistrySnapshot, listAppShellPages, subscribeAppShellPages, } from "../app-shell-registry.js";
+import { TAB_PATHS, titleForTab } from "../navigation/index.js";
 import { getFrontendPlatform } from "../platform/platform-guards.js";
 import { startPolling } from "./resource-cache.js";
 import { useCachedResource } from "./useCachedResource.js";
@@ -68,6 +69,63 @@ async function fetchViews() {
 }
 const VIEWS_CACHE_KEY = "views:available";
 const EMPTY_VIEWS = [];
+// Per-tab Lucide glyph names for the builtin shell views, so each springboard
+// tile renders a DISTINCT icon instead of collapsing onto the generic
+// LayoutGrid fallback (every builtin entry previously shipped no `icon`, so
+// Settings/Files/Tasks all rendered the same 4-square placeholder). Names must
+// exist in ViewIcon's ICONS map; an id with no entry here falls through to the
+// keyword guesser, then LayoutGrid.
+const TAB_ICON_NAMES = {
+    chat: "MessageSquare",
+    phone: "Phone",
+    messages: "MessageSquare",
+    contacts: "UsersRound",
+    camera: "AppWindow",
+    tasks: "ListTodo",
+    browser: "Globe",
+    companion: "Bot",
+    stream: "Radio",
+    apps: "LayoutGrid",
+    views: "LayoutGrid",
+    character: "Bot",
+    "character-select": "Users",
+    automations: "Zap",
+    triggers: "Zap",
+    inventory: "Wallet",
+    documents: "FileText",
+    files: "FolderClosed",
+    plugins: "Plug",
+    skills: "Sparkles",
+    advanced: "BrainCircuit",
+    "fine-tuning": "BrainCircuit",
+    trajectories: "Activity",
+    transcripts: "FileText",
+    relationships: "Network",
+    memories: "BrainCircuit",
+    rolodex: "UsersRound",
+    voice: "Mic",
+    runtime: "Terminal",
+    database: "Database",
+    desktop: "Monitor",
+    settings: "Settings",
+    tutorial: "Sparkles",
+    help: "Inbox",
+    logs: "ScrollText",
+    background: "ImageIcon",
+};
+const BUILTIN_SHELL_VIEW_ENTRIES = Object.entries(TAB_PATHS).map(([id, path]) => ({
+    id,
+    label: titleForTab(id),
+    viewType: "gui",
+    icon: TAB_ICON_NAMES[id],
+    path,
+    available: true,
+    pluginName: "@elizaos/builtin",
+    tags: [id],
+    builtin: true,
+    visibleInManager: false,
+    desktopTabEnabled: true,
+}));
 /**
  * Map an in-process app-shell page (registered by a plugin via
  * `registerAppShellPage`) to a view-registry entry. On iOS/Android the agent's
@@ -87,6 +145,8 @@ function appShellPageToViewEntry(page) {
         available: true,
         pluginName: page.pluginId,
         developerOnly: page.developerOnly,
+        viewKind: page.viewKind,
+        backgroundPolicy: page.backgroundPolicy,
         visibleInManager: true,
         builtin: false,
     };
@@ -116,20 +176,29 @@ function getAppShellViewEntriesSnapshot() {
  * — app-shell pages only fill ids the network didn't return, which on mobile is
  * every dynamically-bundled plugin view the route filtered out.
  */
-function mergeWithAppShellViews(networkViews, appShellViews) {
-    if (appShellViews.length === 0)
-        return networkViews;
+function mergeViewRegistryEntries(primaryViews, fallbackGroups) {
+    if (fallbackGroups.every((group) => group.length === 0)) {
+        return primaryViews;
+    }
     const byKey = new Map();
-    for (const view of networkViews) {
+    for (const view of primaryViews) {
         byKey.set(`${view.viewType ?? "gui"}:${view.id}`, view);
     }
-    for (const entry of appShellViews) {
-        const key = `${entry.viewType ?? "gui"}:${entry.id}`;
-        if (!byKey.has(key))
-            byKey.set(key, entry);
+    for (const group of fallbackGroups) {
+        for (const entry of group) {
+            const key = `${entry.viewType ?? "gui"}:${entry.id}`;
+            if (!byKey.has(key))
+                byKey.set(key, entry);
+        }
     }
     return [...byKey.values()];
 }
+function mergeWithAppShellViews(networkViews, appShellViews) {
+    return mergeViewRegistryEntries(networkViews, [appShellViews]);
+}
+export function withBuiltinShellViews(views) {
+    return mergeViewRegistryEntries(views, [BUILTIN_SHELL_VIEW_ENTRIES]);
+}
 export function useAvailableViews() {
     // All mounts share one cache slot, so the router and the desktop-tab consumer
     // (which both mount this hook) issue a single request and paint instantly on
@@ -157,3 +226,13 @@ export function useAvailableViews() {
         refresh: refetch,
     };
 }
+export function useRoutableViews() {
+    const { views, loading, error, refresh } = useAvailableViews();
+    const routableViews = useMemo(() => withBuiltinShellViews(views), [views]);
+    return useMemo(() => ({
+        views: routableViews,
+        loading,
+        error,
+        refresh,
+    }), [routableViews, loading, error, refresh]);
+}