@agent-native/core 0.161.10 → 0.161.14

package/dist/client/embed-auth.js

@@ -11,6 +11,7 @@ const GUARDED_METHODS = new Set(["GET", "HEAD"]);
 const AUTH_FAILURE_HEADER = "x-agent-native-auth-circuit-breaker";
 const MCP_CHAT_BRIDGE_VIEWPORT_STYLE_ID = "agent-native-mcp-chat-bridge-viewport";
 const MCP_CHAT_BRIDGE_VIEWPORT_HEIGHT = 560;
+let pendingMcpChatBridgeViewportNotification = null;
 const authFailureCache = new Map();
 let embedAuthFailure = null;
 function browserWindow() {
@@ -211,11 +212,38 @@ function notifyMcpChatBridgeViewportHeight(win) {
             // Cross-host embeds can deny parent messaging in tests or strict sandboxes.
         }
     };
+    const pending = pendingMcpChatBridgeViewportNotification;
+    pendingMcpChatBridgeViewportNotification = null;
+    if (pending) {
+        if (pending.animationFrameId !== null) {
+            pending.win.cancelAnimationFrame?.(pending.animationFrameId);
+        }
+        for (const id of pending.timeoutIds)
+            pending.win.clearTimeout(id);
+    }
     notify();
+    const nextPending = {
+        win,
+        animationFrameId: null,
+        timeoutIds: [],
+    };
+    pendingMcpChatBridgeViewportNotification = nextPending;
+    const notifyIfCurrent = () => {
+        // Some hosts expose requestAnimationFrame/timers from a different clock
+        // than the one used by clearTimeout. The identity guard keeps a superseded
+        // setup from notifying even when cancellation cannot reach that clock.
+        if (pendingMcpChatBridgeViewportNotification !== nextPending)
+            return;
+        notify();
+    };
     try {
-        win.requestAnimationFrame?.(() => notify());
-        win.setTimeout?.(notify, 250);
-        win.setTimeout?.(notify, 1000);
+        if (win.requestAnimationFrame) {
+            nextPending.animationFrameId = win.requestAnimationFrame(notifyIfCurrent);
+        }
+        if (win.setTimeout) {
+            nextPending.timeoutIds.push(win.setTimeout(notifyIfCurrent, 250));
+            nextPending.timeoutIds.push(win.setTimeout(notifyIfCurrent, 1000));
+        }
     }
     catch {
         // Timers are a progressive enhancement for late host bridge initialization.
@@ -223,6 +251,15 @@ function notifyMcpChatBridgeViewportHeight(win) {
 }
 /** Internal test helper. Do not use in app code. */
 export function _resetEmbedAuthForTests() {
+    if (pendingMcpChatBridgeViewportNotification) {
+        const pending = pendingMcpChatBridgeViewportNotification;
+        pendingMcpChatBridgeViewportNotification = null;
+        if (pending.animationFrameId !== null) {
+            pending.win.cancelAnimationFrame?.(pending.animationFrameId);
+        }
+        for (const id of pending.timeoutIds)
+            pending.win.clearTimeout(id);
+    }
     installed = false;
     memoryToken = null;
     mcpChatBridgeActive = false;

package/dist/client/mcp-apps/McpAppRenderer.js

@@ -55,6 +55,11 @@ export function McpAppRenderer({ app, className }) {
         setReady(true);
         setError(null);
     }, []);
+    const handleIframeError = useCallback(() => {
+        readyRef.current = false;
+        setReady(false);
+        setError("MCP App iframe failed to load.");
+    }, []);
     const applyHeight = useCallback((desiredHeight) => {
         if (typeof desiredHeight === "number" &&
             Number.isFinite(desiredHeight) &&
@@ -228,9 +233,9 @@ export function McpAppRenderer({ app, className }) {
         // new-but-equal `app` object reference does not tear down a live bridge.
     }, [applyHeight, markReady, srcDoc]);
     if (!resourceHtml) {
-        return (_jsxs("div", { className: cn("agent-mcp-app agent-mcp-app--error", className), children: [_jsx(IconAlertTriangle, { size: 15 }), _jsx("span", { children: "MCP App resource was not available." })] }));
+        return (_jsxs("div", { className: cn("agent-mcp-app agent-mcp-app--error", className), children: [_jsx(IconAlertTriangle, { size: 15 }), _jsx("span", { children: "MCP App resource was not available." }), externalOpenUrl && (_jsx("button", { type: "button", className: "agent-mcp-app__open", onClick: () => window.open(externalOpenUrl, "_blank", "noopener,noreferrer"), children: "Open in new tab" }))] }));
     }
-    return (_jsxs("div", { className: cn("agent-mcp-app", uiMeta.prefersBorder === false && "agent-mcp-app--flush", className), children: [!ready && !error && (_jsxs("div", { className: "agent-mcp-app__loading", children: [_jsx(IconLoader2, { size: 14, className: "agent-conversation-spin" }), _jsx("span", { children: "Loading MCP App" })] })), error && (_jsxs("div", { className: "agent-mcp-app__error", children: [_jsx(IconAlertTriangle, { size: 15 }), _jsx("span", { children: error }), externalOpenUrl && (_jsx("button", { type: "button", className: "agent-mcp-app__open", onClick: () => window.open(externalOpenUrl, "_blank", "noopener,noreferrer"), children: "Open in new tab" }))] })), _jsx("iframe", { ref: iframeRef, title: app.tool?.title ?? app.originalToolName, srcDoc: srcDoc, sandbox: SANDBOX_FLAGS, allow: buildAllowAttribute(supportedPermissions), style: { height } })] }));
+    return (_jsxs("div", { className: cn("agent-mcp-app", uiMeta.prefersBorder === false && "agent-mcp-app--flush", className), children: [!ready && !error && (_jsxs("div", { className: "agent-mcp-app__loading", children: [_jsx(IconLoader2, { size: 14, className: "agent-conversation-spin" }), _jsx("span", { children: "Loading MCP App" })] })), error && (_jsx("div", { className: "agent-mcp-app__error", role: "alert", children: _jsxs("div", { className: "agent-mcp-app__error-box", children: [_jsx(IconAlertTriangle, { size: 15 }), _jsx("span", { children: error }), externalOpenUrl && (_jsx("button", { type: "button", className: "agent-mcp-app__open", onClick: () => window.open(externalOpenUrl, "_blank", "noopener,noreferrer"), children: "Open in new tab" }))] }) })), _jsx("iframe", { ref: iframeRef, title: app.tool?.title ?? app.originalToolName, srcDoc: srcDoc, sandbox: SANDBOX_FLAGS, allow: buildAllowAttribute(supportedPermissions), style: { height }, onError: handleIframeError })] }));
 }
 function messageTextFromMcpUiMessage(params) {
     return textPartsFromMcpContent(params.content).join("\n\n").trim();

package/dist/client/route-state.js

@@ -37,12 +37,39 @@ function defaultCommandDedupKey(command) {
 function currentRouterPath(location) {
     return `${location.pathname}${location.search}${location.hash}`;
 }
+function shallowEqualNavigationState(left, right) {
+    if (Object.is(left, right))
+        return true;
+    if (!left ||
+        !right ||
+        typeof left !== "object" ||
+        typeof right !== "object") {
+        return false;
+    }
+    const leftKeys = Object.keys(left);
+    const rightKeys = Object.keys(right);
+    if (leftKeys.length !== rightKeys.length)
+        return false;
+    for (const key of leftKeys) {
+        if (!Object.prototype.hasOwnProperty.call(right, key) ||
+            !Object.is(left[key], right[key])) {
+            return false;
+        }
+    }
+    return true;
+}
 function stringifyForWriteDedup(value) {
     try {
-        return JSON.stringify(value);
+        const serialized = JSON.stringify(value);
+        return typeof serialized === "string"
+            ? serialized
+            : Symbol("unserializable navigation state");
     }
     catch {
-        return "";
+        // Do not turn a serialization failure into a reusable string key. A
+        // distinct token lets a changed unserializable state reach the write path
+        // and surface its real error instead of being silently deduplicated.
+        return Symbol("unserializable navigation state");
     }
 }
 function resolveAgentChatViewTransitionOption(option, command, path) {
@@ -65,10 +92,10 @@ export function useSemanticNavigationState(options) {
     const commandKeys = useMemo(() => uniqueKeys(options.commandKeys ?? ["navigate"]), [options.commandKeys]);
     const commandQueryKey = useMemo(() => options.commandQueryKey ?? ["navigate-command"], [options.commandQueryKey]);
     const navigationState = options.state ?? null;
-    const navigationWriteDedup = stringifyForWriteDedup({
+    const navigationWriteDedup = useMemo(() => stringifyForWriteDedup({
         keys: navigationKeys,
         state: navigationState,
-    });
+    }), [navigationKeys, navigationState]);
     const getCommandDedupKeyRef = useRef(options.getCommandDedupKey);
     const onCommandRef = useRef(options.onCommand);
     const onErrorRef = useRef(options.onError);
@@ -184,7 +211,17 @@ export function useAgentRouteState(options) {
         browserTabId ?? "global",
     ], [browserTabId, commandKey, options.commandQueryKey]);
     const routeLocation = useMemo(() => routeLocationFromReactRouter(location), [location]);
-    const navigationState = options.getNavigationState(routeLocation) ?? null;
+    // Callers may include app-local state in this callback in addition to the
+    // router location. Derive on every render so those values are not frozen at
+    // the last route change, then retain the previous object when its shallow
+    // values are unchanged. This keeps the write-dedup serialization off the
+    // unrelated-render path without hiding captured state updates.
+    const derivedNavigationState = options.getNavigationState(routeLocation) ?? null;
+    const navigationStateRef = useRef(derivedNavigationState);
+    if (!shallowEqualNavigationState(navigationStateRef.current, derivedNavigationState)) {
+        navigationStateRef.current = derivedNavigationState;
+    }
+    const navigationState = navigationStateRef.current;
     return useSemanticNavigationState({
         state: navigationState,
         navigationKeys,

package/dist/client/use-change-version.js

@@ -31,11 +31,13 @@
  * refetch when that source fires. A poll heartbeat with no event does
  * nothing.
  */
-import { useSyncExternalStore } from "react";
+import { useCallback, useMemo, useSyncExternalStore } from "react";
+const MAX_TRACKED_SOURCES = 1_000;
+const ZERO_SNAPSHOT = () => 0;
 class ChangeVersionStore {
     versions = new Map();
-    listeners = new Set();
-    cachedSnapshots = new Map();
+    listeners = new Map();
+    activeSources = new Map();
     /**
      * Advance the counter for `source` to at least `version`. Returns true if
      * the counter actually moved (so callers can avoid spurious work).
@@ -46,31 +48,60 @@ class ChangeVersionStore {
         const current = this.versions.get(source) ?? 0;
         if (version > current) {
             this.versions.set(source, version);
-            this.cachedSnapshots.set(source, version);
-            this.notify();
+            this.evictUnobservedSources();
+            for (const listener of this.listeners.get(source) ?? [])
+                listener();
             return true;
         }
         return false;
     }
     get(source) {
-        // useSyncExternalStore requires reference-stable snapshots for unchanged
-        // values, so we serve from a cached map that we only update inside
-        // `bump`.
-        const cached = this.cachedSnapshots.get(source);
-        if (cached !== undefined)
-            return cached;
-        this.cachedSnapshots.set(source, 0);
-        return 0;
+        return this.versions.get(source) ?? 0;
     }
-    subscribe(listener) {
-        this.listeners.add(listener);
+    subscribe(sources, listener) {
+        const uniqueSources = new Set(sources.filter(Boolean));
+        for (const source of uniqueSources) {
+            this.activeSources.set(source, (this.activeSources.get(source) ?? 0) + 1);
+            let listeners = this.listeners.get(source);
+            if (!listeners) {
+                listeners = new Set();
+                this.listeners.set(source, listeners);
+            }
+            listeners.add(listener);
+        }
         return () => {
-            this.listeners.delete(listener);
+            for (const source of uniqueSources) {
+                const listeners = this.listeners.get(source);
+                listeners?.delete(listener);
+                if (listeners?.size === 0)
+                    this.listeners.delete(source);
+                const count = (this.activeSources.get(source) ?? 1) - 1;
+                if (count > 0)
+                    this.activeSources.set(source, count);
+                else
+                    this.activeSources.delete(source);
+            }
+            this.evictUnobservedSources();
         };
     }
-    notify() {
-        for (const listener of this.listeners)
-            listener();
+    reset() {
+        this.versions.clear();
+        this.listeners.clear();
+        this.activeSources.clear();
+    }
+    evictUnobservedSources() {
+        while (this.versions.size > MAX_TRACKED_SOURCES) {
+            let evicted = false;
+            for (const source of this.versions.keys()) {
+                if (this.activeSources.has(source))
+                    continue;
+                this.versions.delete(source);
+                evicted = true;
+                break;
+            }
+            if (!evicted)
+                return;
+        }
     }
 }
 const store = new ChangeVersionStore();
@@ -110,7 +141,9 @@ export function getChangeVersion(source) {
  * ```
  */
 export function useChangeVersion(source) {
-    return useSyncExternalStore((cb) => store.subscribe(cb), () => store.get(source), () => 0);
+    const subscribe = useCallback((listener) => store.subscribe([source], listener), [source]);
+    const getSnapshot = useCallback(() => store.get(source), [source]);
+    return useSyncExternalStore(subscribe, getSnapshot, ZERO_SNAPSHOT);
 }
 /**
  * Convenience for queries that should refetch on multiple sources — returns
@@ -123,12 +156,25 @@ export function useChangeVersion(source) {
  * ```
  */
 export function useChangeVersions(sources) {
-    return useSyncExternalStore((cb) => store.subscribe(cb), () => sources.reduce((sum, src) => sum + store.get(src), 0), () => 0);
+    const sourceKey = sources
+        .map((source) => `${source.length}:${source}`)
+        .join("\u0001");
+    const stableSources = useMemo(() => {
+        const uniqueSources = [];
+        const seen = new Set();
+        for (const source of sources) {
+            if (seen.has(source))
+                continue;
+            seen.add(source);
+            uniqueSources.push(source);
+        }
+        return uniqueSources;
+    }, [sourceKey]);
+    const subscribe = useCallback((listener) => store.subscribe(stableSources, listener), [stableSources]);
+    const getSnapshot = useCallback(() => stableSources.reduce((sum, src) => sum + store.get(src), 0), [stableSources]);
+    return useSyncExternalStore(subscribe, getSnapshot, ZERO_SNAPSHOT);
 }
 /** Internal test helper — reset all counters. Do not use in app code. */
 export function _resetChangeVersionStoreForTests() {
-    // @ts-expect-error reaching past private to clear state in tests
-    store.versions.clear();
-    // @ts-expect-error reaching past private to clear state in tests
-    store.cachedSnapshots.clear();
+    store.reset();
 }

package/dist/client/use-db-sync.d.ts

@@ -18,6 +18,7 @@ interface QueryClient {
 }
 export type SyncEvent = {
     version?: number;
+    cursorId?: string;
     source?: string;
     type?: string;
     key?: string;