@agent-native/core 0.72.2 → 0.72.4

package/dist/client/MultiTabAssistantChat.d.ts

@@ -10,6 +10,21 @@ export interface ChatTab {
     /** Short name for sub-agent tabs (e.g. "Research", "Draft email") */
     subAgentName?: string;
 }
+export interface ChatThreadUrlSyncOptions {
+    /** Query-string parameter used by the generic URL adapter. Default: `thread`. */
+    paramName?: string;
+    /**
+     * Route-owned thread id. Pass `null` for the create route and a string for
+     * thread routes like `/chat/:threadId`.
+     */
+    routeThreadId?: string | null;
+    /** Build the URL path for a thread id, or for create mode when id is null. */
+    getPath?: (threadId: string | null) => string;
+    /** Optional router navigation callback used with `getPath`. */
+    navigate?: (path: string, options?: {
+        replace?: boolean;
+    }) => void;
+}
 export interface MultiTabAssistantChatHeaderProps {
     tabs: ChatTab[];
     activeTabId: string;
@@ -41,6 +56,12 @@ export type MultiTabAssistantChatProps = Omit<AssistantChatProps, "tabId" | "thr
     restoreActiveThread?: boolean;
     /** Stable browser tab id used for tab-scoped app-state context. */
     browserTabId?: string;
+    /**
+     * Keep the active thread in URL state. `true` uses the generic `?thread=id`
+     * adapter; passing `routeThreadId` + `getPath` lets an app bind chats to
+     * route params such as `/chat/:threadId`.
+     */
+    threadUrlSync?: boolean | ChatThreadUrlSyncOptions;
     /**
      * Bind new chats to a resource (deck, design, dashboard, etc.). When set,
      * new chats automatically inherit this scope and scoped chats tuck away when
@@ -50,5 +71,5 @@ export type MultiTabAssistantChatProps = Omit<AssistantChatProps, "tabId" | "thr
      */
     scope?: ChatThreadScope | null;
 };
-export declare function MultiTabAssistantChat({ showTabBar, renderHeader, renderOverlay, contentHidden, apiUrl, storageKey, restoreActiveThread, browserTabId, scope, ...props }: MultiTabAssistantChatProps): import("react/jsx-runtime").JSX.Element;
+export declare function MultiTabAssistantChat({ showTabBar, renderHeader, renderOverlay, contentHidden, apiUrl, storageKey, restoreActiveThread, browserTabId, threadUrlSync, scope, ...props }: MultiTabAssistantChatProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=MultiTabAssistantChat.d.ts.map

package/dist/client/MultiTabAssistantChat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MultiTabAssistantChat.d.ts","sourceRoot":"","sources":["../../src/client/MultiTabAssistantChat.tsx"],"names":[],"mappings":"AAAA,OAAO,KAMN,MAAM,OAAO,CAAC;AAUf,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAe5B,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAC;AAqqB/B,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IACzC,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAsFD,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,kBAAkB,EAClB,OAAO,GAAG,UAAU,CACrB,GAAG;IACF,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC5E,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7E,sGAAsG;IACtG,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,EACpC,UAAiB,EACjB,YAAY,EACZ,aAAa,EACb,aAAqB,EACrB,MAAqD,EACrD,UAAU,EACV,mBAA0B,EAC1B,YAAY,EACZ,KAAY,EACZ,GAAG,KAAK,EACT,EAAE,0BAA0B,2CA4rD5B"}
+{"version":3,"file":"MultiTabAssistantChat.d.ts","sourceRoot":"","sources":["../../src/client/MultiTabAssistantChat.tsx"],"names":[],"mappings":"AAAA,OAAO,KAMN,MAAM,OAAO,CAAC;AAUf,OAAO,EAEL,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAe5B,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,uBAAuB,CAAC;AAqqB/B,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;IACzC,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAsGD,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,MAAM,CAAC;IAC9C,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CACpE;AAyED,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAC3C,kBAAkB,EAClB,OAAO,GAAG,UAAU,CACrB,GAAG;IACF,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC5E,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gCAAgC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7E,sGAAsG;IACtG,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,mEAAmE;IACnE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,wBAAwB,CAAC;IACnD;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,EACpC,UAAiB,EACjB,YAAY,EACZ,aAAa,EACb,aAAqB,EACrB,MAAqD,EACrD,UAAU,EACV,mBAA0B,EAC1B,YAAY,EACZ,aAAqB,EACrB,KAAY,EACZ,GAAG,KAAK,EACT,EAAE,0BAA0B,2CA00D5B"}

package/dist/client/MultiTabAssistantChat.js

@@ -7,7 +7,7 @@ import { cn } from "./utils.js";
 import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "./components/ui/tooltip.js";
 import { Popover, PopoverAnchor, PopoverContent, PopoverTrigger, } from "./components/ui/popover.js";
 import { useChatThreads, } from "./use-chat-threads.js";
-import { agentNativePath } from "./api-path.js";
+import { agentNativePath, appPath } from "./api-path.js";
 import { callAction } from "./use-action.js";
 import { RunStuckBanner } from "./RunStuckBanner.js";
 import { DEFAULT_MODEL } from "../agent/default-model.js";
@@ -300,6 +300,83 @@ function chatTabStatusFromAgentTeamStatus(status) {
     return isActiveAgentTeamStatus(status) ? "running" : "completed";
 }
 const STALE_THREAD_THRESHOLD_MS = 12 * 60 * 60 * 1000;
+const DEFAULT_THREAD_URL_PARAM = "thread";
+const THREAD_URL_CHANGED_EVENT = "agent-chat:url-thread-changed";
+const hasOwn = Object.prototype.hasOwnProperty;
+// The history patch is installed once and shared via a ref count so that
+// multiple synced chats (or a remount) don't restore a stale `pushState`
+// reference and silently drop a wrapper installed by another instance.
+let historyPatchRefCount = 0;
+let restoreHistoryPatch = null;
+function installHistoryThreadUrlPatch() {
+    if (typeof window === "undefined")
+        return () => { };
+    historyPatchRefCount += 1;
+    if (historyPatchRefCount === 1) {
+        const originalPushState = window.history.pushState;
+        const originalReplaceState = window.history.replaceState;
+        const dispatchUrlChange = () => {
+            window.dispatchEvent(new Event(THREAD_URL_CHANGED_EVENT));
+        };
+        window.history.pushState = function pushState(...args) {
+            const result = originalPushState.apply(this, args);
+            dispatchUrlChange();
+            return result;
+        };
+        window.history.replaceState = function replaceState(...args) {
+            const result = originalReplaceState.apply(this, args);
+            dispatchUrlChange();
+            return result;
+        };
+        restoreHistoryPatch = () => {
+            window.history.pushState = originalPushState;
+            window.history.replaceState = originalReplaceState;
+        };
+    }
+    return () => {
+        historyPatchRefCount = Math.max(0, historyPatchRefCount - 1);
+        if (historyPatchRefCount === 0) {
+            restoreHistoryPatch?.();
+            restoreHistoryPatch = null;
+        }
+    };
+}
+function normalizeUrlThreadId(value) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value.trim();
+    return trimmed || null;
+}
+function resolveThreadUrlSync(value) {
+    if (!value)
+        return { enabled: false, paramName: DEFAULT_THREAD_URL_PARAM };
+    if (value === true) {
+        return { enabled: true, paramName: DEFAULT_THREAD_URL_PARAM };
+    }
+    return {
+        enabled: true,
+        paramName: value.paramName?.trim() || DEFAULT_THREAD_URL_PARAM,
+        ...(hasOwn.call(value, "routeThreadId")
+            ? { routeThreadId: normalizeUrlThreadId(value.routeThreadId) }
+            : {}),
+        ...(value.getPath ? { getPath: value.getPath } : {}),
+        ...(value.navigate ? { navigate: value.navigate } : {}),
+    };
+}
+function readUrlThreadId(paramName) {
+    if (typeof window === "undefined")
+        return null;
+    try {
+        const params = new URLSearchParams(window.location.search);
+        return normalizeUrlThreadId(params.get(paramName) ??
+            (paramName === DEFAULT_THREAD_URL_PARAM
+                ? params.get("threadId")
+                : null));
+    }
+    catch {
+        return null;
+    }
+}
 function runToAgentTeamTabInfo(run) {
     if (run.sourceRecord?.type && run.sourceRecord.type !== "agent-team-task") {
         return null;
@@ -321,8 +398,102 @@ function runToAgentTeamTabInfo(run) {
         status: run.status ?? "unknown",
     };
 }
-export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderOverlay, contentHidden = false, apiUrl = agentNativePath("/_agent-native/agent-chat"), storageKey, restoreActiveThread = true, browserTabId, scope = null, ...props }) {
-    const { threads, activeThreadId, isLoading, createThread, switchThread, detachThread, forkThread, saveThreadData, generateTitle, searchThreads, refreshThreads, isNewThread, } = useChatThreads(apiUrl, storageKey, scope, { restoreActiveThread });
+export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderOverlay, contentHidden = false, apiUrl = agentNativePath("/_agent-native/agent-chat"), storageKey, restoreActiveThread = true, browserTabId, threadUrlSync = false, scope = null, ...props }) {
+    const { enabled: threadUrlSyncEnabled, paramName: threadUrlParamName, routeThreadId, getPath: getThreadPath, navigate: navigateThreadUrl, } = resolveThreadUrlSync(threadUrlSync);
+    const threadRouteControlsActiveThread = threadUrlSyncEnabled &&
+        threadUrlSync !== true &&
+        typeof threadUrlSync === "object" &&
+        hasOwn.call(threadUrlSync, "routeThreadId");
+    const [urlThreadId, setUrlThreadId] = useState(() => threadUrlSyncEnabled
+        ? threadRouteControlsActiveThread
+            ? (routeThreadId ?? null)
+            : readUrlThreadId(threadUrlParamName)
+        : null);
+    const urlThreadIdRef = useRef(urlThreadId);
+    urlThreadIdRef.current = urlThreadId;
+    useEffect(() => {
+        if (!threadUrlSyncEnabled || threadRouteControlsActiveThread)
+            return;
+        const update = () => setUrlThreadId(readUrlThreadId(threadUrlParamName));
+        const uninstallHistoryPatch = installHistoryThreadUrlPatch();
+        update();
+        window.addEventListener("popstate", update);
+        window.addEventListener(THREAD_URL_CHANGED_EVENT, update);
+        return () => {
+            uninstallHistoryPatch();
+            window.removeEventListener("popstate", update);
+            window.removeEventListener(THREAD_URL_CHANGED_EVENT, update);
+        };
+    }, [
+        threadRouteControlsActiveThread,
+        threadUrlParamName,
+        threadUrlSyncEnabled,
+    ]);
+    useEffect(() => {
+        if (!threadUrlSyncEnabled || !threadRouteControlsActiveThread)
+            return;
+        setUrlThreadId(routeThreadId ?? null);
+    }, [routeThreadId, threadRouteControlsActiveThread, threadUrlSyncEnabled]);
+    const writeThreadUrl = useCallback((threadId, options = {}) => {
+        if (!threadUrlSyncEnabled || typeof window === "undefined")
+            return;
+        try {
+            const normalizedThreadId = normalizeUrlThreadId(threadId);
+            let next;
+            if (getThreadPath) {
+                next = getThreadPath(normalizedThreadId);
+            }
+            else {
+                const url = new URL(window.location.href);
+                if (normalizedThreadId) {
+                    url.searchParams.set(threadUrlParamName, normalizedThreadId);
+                }
+                else {
+                    url.searchParams.delete(threadUrlParamName);
+                }
+                if (threadUrlParamName !== "threadId") {
+                    url.searchParams.delete("threadId");
+                }
+                next = `${url.pathname}${url.search}${url.hash}`;
+            }
+            const current = `${window.location.pathname}${window.location.search}${window.location.hash}`;
+            if (next === current) {
+                setUrlThreadId(normalizedThreadId);
+                return;
+            }
+            if (getThreadPath && navigateThreadUrl) {
+                navigateThreadUrl(next, { replace: options.replace === true });
+                setUrlThreadId(normalizedThreadId);
+                return;
+            }
+            const method = options.replace ? "replaceState" : "pushState";
+            // `getThreadPath` returns a router-local path (no app basename). When we
+            // fall back to the raw History API instead of a router navigate, resolve
+            // the basename so deep-link reloads work in mounted apps.
+            const historyTarget = getThreadPath ? appPath(next) : next;
+            window.history[method](window.history.state, "", historyTarget);
+            setUrlThreadId(normalizedThreadId);
+            window.dispatchEvent(new Event(THREAD_URL_CHANGED_EVENT));
+            const popstate = typeof PopStateEvent === "function"
+                ? new PopStateEvent("popstate", { state: window.history.state })
+                : new Event("popstate");
+            window.dispatchEvent(popstate);
+        }
+        catch { }
+    }, [
+        getThreadPath,
+        navigateThreadUrl,
+        threadUrlParamName,
+        threadUrlSyncEnabled,
+    ]);
+    const { threads, activeThreadId, isLoading, createThread, switchThread: switchThreadState, detachThread, forkThread, saveThreadData, generateTitle, searchThreads, refreshThreads, isNewThread, } = useChatThreads(apiUrl, storageKey, scope, {
+        restoreActiveThread,
+        routeThreadId: threadUrlSyncEnabled ? urlThreadId : undefined,
+    });
+    const switchThread = useCallback((threadId, options = {}) => {
+        switchThreadState(threadId);
+        writeThreadUrl(threadId, options);
+    }, [switchThreadState, writeThreadUrl]);
     // Namespace all localStorage keys by storageKey when provided (for per-app isolation in frame)
     const keyPrefix = storageKey ? `:${storageKey}` : "";
     const modelSelectionKey = `${MODEL_SELECTION_STORAGE_KEY}${keyPrefix}`;
@@ -740,9 +911,19 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
         });
         // If active thread is stale, start fresh
         if (!parentMap[activeThreadId] && isStale(activeThreadId)) {
-            createThread();
+            createThread().then((id) => {
+                if (id)
+                    writeThreadUrl(null);
+            });
         }
-    }, [activeThreadId, threads, parentMap, switchThread, createThread]);
+    }, [
+        activeThreadId,
+        threads,
+        parentMap,
+        switchThread,
+        createThread,
+        writeThreadUrl,
+    ]);
     // Ensure active thread is always in open tabs.
     // Use functional update to check inside the setter — avoids race with the
     // initialization effect that may have already added the ID in the same batch.
@@ -777,10 +958,11 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
                 if (id) {
                     newThreadIds.current.add(id);
                     setOpenTabIds([id]);
+                    writeThreadUrl(null, { replace: true });
                 }
             });
         }
-    }, [isLoading, openTabIds, activeThreadId, createThread]);
+    }, [isLoading, openTabIds, activeThreadId, createThread, writeThreadUrl]);
     useEffect(() => {
         let stopped = false;
         let timer = null;
@@ -1046,9 +1228,12 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
                             mountedTabsRef.current.add(newId);
                         }
                         setOpenTabIds((prev) => prev.includes(newId) ? prev : [...prev, newId]);
+                        if (!background) {
+                            writeThreadUrl(newId);
+                        }
                         sendToTab(newId);
                         if (background && previousTabId) {
-                            switchThread(previousTabId);
+                            switchThreadState(previousTabId);
                         }
                     }
                 });
@@ -1077,6 +1262,8 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
         removeContextInTab,
         setContextInTab,
         switchThread,
+        switchThreadState,
+        writeThreadUrl,
     ]);
     // Replay submits posted before this lazy panel's listener attached. Dedup in
     // the handler keeps a live + replayed message single.
@@ -1147,9 +1334,10 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
         const id = await createThread();
         if (id) {
             newThreadIds.current.add(id);
+            writeThreadUrl(null);
         }
         return id;
-    }, [createThread]);
+    }, [createThread, writeThreadUrl]);
     const cleanupClosedTab = useCallback((tabId) => {
         if (parentMapRef.current[tabId]) {
             dismissedSubAgentTabsRef.current.add(tabId);
@@ -1187,6 +1375,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
                     if (newId) {
                         newThreadIds.current.add(newId);
                         setOpenTabIds([newId]);
+                        writeThreadUrl(null);
                     }
                 });
                 return prev; // Keep old tab until new one is ready
@@ -1199,7 +1388,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
             return next;
         });
         cleanupClosedTab(tabId);
-    }, [switchThread, createThread, cleanupClosedTab]);
+    }, [switchThread, createThread, cleanupClosedTab, writeThreadUrl]);
     const closeOtherTabs = useCallback((tabId) => {
         for (const id of openTabIdsRef.current) {
             if (id !== tabId && parentMapRef.current[id]) {
@@ -1245,7 +1434,8 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
         if (id) {
             newThreadIds.current.add(id);
             setOpenTabIds([id]);
-            switchThread(id);
+            switchThreadState(id);
+            writeThreadUrl(null);
             dismissedSubAgentTabsRef.current.clear();
             // Clean up all old refs
             chatRefs.current.clear();
@@ -1256,7 +1446,7 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
             setSubAgentNames({});
             setSubAgentStatuses({});
         }
-    }, [createThread, switchThread]);
+    }, [createThread, switchThreadState, writeThreadUrl]);
     // Keyboard shortcuts dispatched from AgentPanel based on the active mode
     useEffect(() => {
         const handleCloseCurrent = () => {
@@ -1287,13 +1477,20 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
                 return;
             if (detail?.newThread === true) {
                 newThreadIds.current.add(threadId);
+                void createThread(threadId).then((createdId) => {
+                    if (!createdId)
+                        return;
+                    setOpenTabIds((prev) => prev.includes(createdId) ? prev : [...prev, createdId]);
+                    writeThreadUrl(null);
+                });
+                return;
             }
             setOpenTabIds((prev) => prev.includes(threadId) ? prev : [...prev, threadId]);
             switchThread(threadId);
         };
         window.addEventListener("agent-chat:open-thread", handleOpenThread);
         return () => window.removeEventListener("agent-chat:open-thread", handleOpenThread);
-    }, [switchThread]);
+    }, [createThread, switchThread, writeThreadUrl]);
     const clearActiveTab = useCallback(() => {
         const tabIdToClear = activeThreadIdRef.current;
         void addTab().then((newTabId) => {
@@ -1421,7 +1618,12 @@ export function MultiTabAssistantChat({ showTabBar = true, renderHeader, renderO
     }, [generateTitle, saveThreadData]);
     const handleSaveThread = useCallback((threadId, data) => {
         saveThreadData(threadId, data);
-    }, [saveThreadData]);
+        if (data.messageCount > 0 &&
+            threadId === activeThreadIdRef.current &&
+            urlThreadIdRef.current !== threadId) {
+            writeThreadUrl(threadId);
+        }
+    }, [saveThreadData, writeThreadUrl]);
     // ─── Slash command handler ──────────────────────────────────────────
     const [helpVisible, setHelpVisible] = useState(false);
     const handleSlashCommand = useCallback((command) => {