@agent-native/core 0.72.1 → 0.72.3

package/corpus/core/src/client/use-chat-threads.ts

@@ -63,6 +63,12 @@ export interface UseChatThreadsOptions {
   autoCreate?: boolean;
   /** Restore the active thread from localStorage. Defaults to true. */
   restoreActiveThread?: boolean;
+  /**
+   * Route-owned active thread. `undefined` preserves the legacy localStorage
+   * source of truth; a string opens that thread; `null` means the URL is in
+   * create/new-chat mode.
+   */
+  routeThreadId?: string | null;
 }
 
 const ACTIVE_THREAD_KEY = "agent-chat-active-thread";
@@ -114,6 +120,12 @@ function createLocalThreadId(): string {
   return `thread-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
 }
 
+function normalizeThreadId(value: string | null | undefined): string | null {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  return trimmed || null;
+}
+
 function scopesMatch(
   a?: ChatThreadScope | null,
   b?: ChatThreadScope | null,
@@ -155,6 +167,8 @@ export function useChatThreads(
 ) {
   const autoCreate = options?.autoCreate !== false;
   const restoreActiveThread = options?.restoreActiveThread !== false;
+  const routeControlsActiveThread = options?.routeThreadId !== undefined;
+  const routeThreadId = normalizeThreadId(options?.routeThreadId);
   // Each (storageKey, scope) pair gets its own active-thread localStorage key
   // for chats that belong to a resource. General chats keep using the unscoped
   // key even while the user is looking at a resource, so clicking into a deck,
@@ -180,10 +194,16 @@ export function useChatThreads(
     let id: string | null = null;
     let isNew = false;
     if (typeof window !== "undefined") {
-      try {
-        id = restoreActiveThread ? localStorage.getItem(activeThreadKey) : null;
-      } catch {
-        id = null;
+      if (routeControlsActiveThread) {
+        id = routeThreadId;
+      } else {
+        try {
+          id = restoreActiveThread
+            ? localStorage.getItem(activeThreadKey)
+            : null;
+        } catch {
+          id = null;
+        }
       }
       if (!id && autoCreate) {
         id = createLocalThreadId();
@@ -323,6 +343,10 @@ export function useChatThreads(
   const persistedKeyRef = useRef(activeThreadKey);
   useEffect(() => {
     if (persistedKeyRef.current !== activeThreadKey) {
+      if (routeControlsActiveThread) {
+        persistedKeyRef.current = activeThreadKey;
+        return;
+      }
       const currentId = activeThreadIdRef.current;
       if (currentId) {
         const currentThreadScope = readKnownThreadScope(currentId);
@@ -357,6 +381,11 @@ export function useChatThreads(
       return;
     }
     try {
+      if (routeControlsActiveThread && !routeThreadId) {
+        localStorage.removeItem(activeThreadKey);
+        localStorage.removeItem(activeThreadSeenKey);
+        return;
+      }
       if (activeThreadId) {
         const threadScope = readKnownThreadScope(activeThreadId);
         if (threadScope === undefined) return;
@@ -378,6 +407,8 @@ export function useChatThreads(
     addOptimisticThread,
     autoCreate,
     readKnownThreadScope,
+    routeControlsActiveThread,
+    routeThreadId,
     storageKey,
     threads,
   ]);
@@ -484,6 +515,10 @@ export function useChatThreads(
       const loadedHasSavedId = Boolean(
         savedId && loadedThreads.some((t) => t.id === savedId),
       );
+      const savedIdCameFromRoute =
+        Boolean(savedId) &&
+        routeControlsActiveThread &&
+        routeThreadId === savedId;
 
       if (
         savedId &&
@@ -491,6 +526,11 @@ export function useChatThreads(
         !loadedHasSavedId
       ) {
         addOptimisticThread(savedId, scopeRef.current ?? null);
+      } else if (savedId && savedIdCameFromRoute && !loadedHasSavedId) {
+        // A deep link may point to a thread that is not in the current list
+        // response. Keep it route-owned so AssistantChat can restore it via
+        // /threads/:id instead of reclassifying it as a new empty tab.
+        setActiveThreadId(savedId);
       } else if (
         savedId &&
         !newlyCreatedRef.current.has(savedId) &&
@@ -526,7 +566,13 @@ export function useChatThreads(
       }
       setIsLoading(false);
     })();
-  }, [fetchThreads, addOptimisticThread, autoCreate]);
+  }, [
+    fetchThreads,
+    addOptimisticThread,
+    autoCreate,
+    routeControlsActiveThread,
+    routeThreadId,
+  ]);
 
   const createThread = useCallback(
     (preferredId?: string): Promise<string | null> => {
@@ -543,6 +589,41 @@ export function useChatThreads(
     [addOptimisticThread],
   );
 
+  useEffect(() => {
+    if (!routeControlsActiveThread) return;
+    if (routeThreadId) {
+      if (activeThreadIdRef.current !== routeThreadId) {
+        setActiveThreadId(routeThreadId);
+      }
+      return;
+    }
+
+    const currentId = activeThreadIdRef.current;
+    const currentThread = currentId
+      ? threadsRef.current.find((thread) => thread.id === currentId)
+      : undefined;
+    const currentIsUnsavedNewThread =
+      currentId !== null &&
+      newlyCreatedRef.current.has(currentId) &&
+      (currentThread?.messageCount ?? 0) === 0;
+    if (currentIsUnsavedNewThread) return;
+
+    if (!autoCreate) {
+      if (currentId !== null) setActiveThreadId(null);
+      return;
+    }
+
+    const id = createLocalThreadId();
+    newlyCreatedRef.current.add(id);
+    addOptimisticThread(id, scopeRef.current ?? null);
+    setActiveThreadId(id);
+  }, [
+    addOptimisticThread,
+    autoCreate,
+    routeControlsActiveThread,
+    routeThreadId,
+  ]);
+
   // Drop a thread's scope so it becomes a general (cross-resource) chat.
   // This is the "Detach from <deck>" escape hatch in the UI. The PUT
   // also bumps the thread's updatedAt so it surfaces in the All Chats

package/corpus/templates/assets/actions/navigate.ts

@@ -4,7 +4,7 @@ import { z } from "zod";
 
 export default defineAction({
   description:
-    "Navigate the Assets UI. Views (internal keys, with the surface they open): create, picker (the image Library browser), libraries (the Brand Kits list), library (a single Brand Kit), asset, generation-session, generation-run, extensions, audit, settings. Use libraryId, assetId, sessionId, runId, or extensionId where appropriate.",
+    "Navigate the Assets UI. Views (internal keys, with the surface they open): create, picker (the image Library browser), libraries (the Brand Kits list), library (a single Brand Kit), asset, generation-session, generation-run, extensions, audit, settings. Use threadId to open a specific create/chat thread; use libraryId, assetId, sessionId, runId, or extensionId where appropriate.",
   schema: z.object({
     view: z
       .enum([
@@ -25,6 +25,7 @@ export default defineAction({
     assetId: z.string().optional(),
     sessionId: z.string().optional(),
     runId: z.string().optional(),
+    threadId: z.string().optional(),
     presetId: z.string().optional(),
     mediaType: z.enum(["image", "video"]).optional(),
     query: z.string().optional(),

package/corpus/templates/assets/app/components/layout/Layout.tsx

@@ -36,7 +36,8 @@ export function Layout({ children }: LayoutProps) {
   const location = useLocation();
   const navigate = useNavigate();
   const [mobileSidebarOpen, setMobileSidebarOpen] = useState(false);
-  const isCreateRoute = location.pathname === "/";
+  const isCreateRoute =
+    location.pathname === "/" || location.pathname.startsWith("/chat/");
   const chatHomeHandoffActive = useAgentChatHomeHandoff({
     storageKey: ASSETS_CHAT_STORAGE_KEY,
     activePath: location.pathname,
@@ -44,7 +45,7 @@ export function Layout({ children }: LayoutProps) {
   });
   useAgentChatHomeHandoffLinks({
     storageKey: ASSETS_CHAT_STORAGE_KEY,
-    chatPath: "/",
+    isChatPath: (pathname) => pathname === "/" || pathname.startsWith("/chat/"),
   });
 
   useEffect(() => {

package/corpus/templates/assets/app/components/layout/Sidebar.tsx

@@ -100,8 +100,24 @@ function persistedActiveThreadId() {
   }
 }
 
+function threadIdFromPath(pathname: string) {
+  const match = pathname.match(/^\/chat\/([^/]+)/);
+  if (!match) return null;
+  try {
+    const value = decodeURIComponent(match[1]).trim();
+    return value || null;
+  } catch {
+    return null;
+  }
+}
+
+function chatThreadPath(threadId: string) {
+  return `/chat/${encodeURIComponent(threadId)}`;
+}
+
 function AssetsChatsSection() {
   const navigate = useNavigate();
+  const location = useLocation();
   const {
     threads,
     activeThreadId,
@@ -159,7 +175,10 @@ function AssetsChatsSection() {
 
   function openThread(threadId: string, options?: { isNew?: boolean }) {
     switchThread(threadId);
-    navigateWithAgentChatViewTransition(navigate, "/");
+    navigateWithAgentChatViewTransition(
+      navigate,
+      options?.isNew ? "/" : chatThreadPath(threadId),
+    );
     window.requestAnimationFrame(() => {
       window.dispatchEvent(
         new CustomEvent("agent-chat:open-thread", {
@@ -261,7 +280,10 @@ function AssetsChatsSection() {
       </div>
       <div className="grid gap-0.5">
         {visibleThreads.map((thread) => {
-          const isActive = thread.id === activeThreadId;
+          const isActive =
+            thread.id ===
+            (threadIdFromPath(location.pathname) ??
+              (location.pathname === "/" ? null : activeThreadId));
           const isRenaming = thread.id === renamingThreadId;
           return (
             <div
@@ -367,7 +389,8 @@ function AssetsChatsSection() {
 export function Sidebar() {
   const location = useLocation();
   const navigate = useNavigate();
-  const isCreateRoute = location.pathname === "/";
+  const isCreateRoute =
+    location.pathname === "/" || location.pathname.startsWith("/chat/");
   const { data: auditAdmin } = useActionQuery("is-audit-admin", {}, {
     refetchInterval: 30_000,
   } as any) as { data: { allowed?: boolean } | undefined };
@@ -453,7 +476,7 @@ export function Sidebar() {
             const Icon = item.icon;
             const isActive =
               item.href === "/"
-                ? location.pathname === "/"
+                ? isCreateRoute
                 : item.href === "/brand-kits"
                   ? location.pathname === "/brand-kits" ||
                     location.pathname.startsWith("/brand-kits/") ||

package/corpus/templates/assets/app/hooks/use-navigation-state.ts

@@ -22,11 +22,18 @@ function optionalLibraryTab(params: URLSearchParams) {
 }
 
 function navigationFromPath(pathname: string, search = "") {
+  const params = new URLSearchParams(search);
+  const chat = pathname.match(/^\/chat\/([^/]+)/);
+  if (chat) {
+    return {
+      view: "create",
+      threadId: decodePathParam(chat[1]),
+    };
+  }
   // The "library" view is the brand-kit detail page (route /brand-kits/:id).
   // Keep the internal view key stable for the agent/MCP contract.
   const library = pathname.match(/^\/brand-kits\/([^/]+)/);
   if (library) {
-    const params = new URLSearchParams(search);
     return {
       view: "library",
       libraryId: library[1],
@@ -37,10 +44,13 @@ function navigationFromPath(pathname: string, search = "") {
   if (asset) return { view: "asset", assetId: asset[1] };
   const image = pathname.match(/^\/image\/([^/]+)/);
   if (image) return { view: "asset", assetId: image[1] };
-  if (pathname === "/") return { view: "create" };
+  if (pathname === "/") {
+    return {
+      view: "create",
+    };
+  }
   // The "picker" view is the image Library browser (route /library).
   if (pathname === "/library") {
-    const params = new URLSearchParams(search);
     return {
       view: "picker",
       mediaType:
@@ -93,7 +103,12 @@ function pathFromCommand(command: any): string | null {
   }
   if (command.view === "audit") return "/audit";
   if (command.view === "settings") return "/settings";
-  if (command.view === "create") return "/";
+  if (command.view === "create") {
+    if (typeof command.threadId === "string" && command.threadId.trim()) {
+      return `/chat/${encodeURIComponent(command.threadId.trim())}`;
+    }
+    return "/";
+  }
   if (command.view === "picker") {
     const params = new URLSearchParams();
     if (command.mediaType === "image" || command.mediaType === "video") {
@@ -131,7 +146,10 @@ export function useNavigationState() {
       navigationFromPath(pathname, search),
     getCommandPath: (command) => pathFromCommand(command),
     onNavigate: (_command, path) => {
-      if (location.pathname === "/" && pathnameFromPath(path) !== "/") {
+      if (
+        isCreatePath(location.pathname) &&
+        !isCreatePath(pathnameFromPath(path))
+      ) {
         markAgentChatHomeHandoff(ASSETS_CHAT_STORAGE_KEY);
       }
     },
@@ -141,3 +159,15 @@ export function useNavigationState() {
 function pathnameFromPath(path: string): string {
   return path.split(/[?#]/, 1)[0] || "/";
 }
+
+function decodePathParam(value: string): string {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+
+function isCreatePath(pathname: string): boolean {
+  return pathname === "/" || pathname.startsWith("/chat/");
+}

package/corpus/templates/assets/app/routes/_index.tsx

@@ -1,4 +1,5 @@
 import { useCallback, useEffect, useState } from "react";
+import { useNavigate, useParams } from "react-router";
 import {
   AgentChatSurface,
   getBrowserTabId,
@@ -61,7 +62,13 @@ export function meta() {
   ];
 }
 
+function chatThreadPath(threadId: string | null) {
+  return threadId ? `/chat/${encodeURIComponent(threadId)}` : "/";
+}
+
 export default function CreatePage() {
+  const { threadId } = useParams();
+  const navigate = useNavigate();
   const [imageModel, setImageModel] = useState<string>(DEFAULT_IMAGE_MODEL);
 
   useEffect(() => {
@@ -113,6 +120,11 @@ export default function CreatePage() {
         className="assets-create-chat-panel"
         defaultMode="chat"
         storageKey={ASSETS_CHAT_STORAGE_KEY}
+        threadUrlSync={{
+          routeThreadId: threadId ?? null,
+          getPath: chatThreadPath,
+          navigate,
+        }}
         browserTabId={getBrowserTabId()}
         imageModelMenu={{
           value: imageModel,

package/corpus/templates/assets/app/routes/chat.$threadId.tsx

@@ -0,0 +1 @@
+export { default, meta } from "./_index";

package/corpus/templates/chat/actions/navigate.ts

@@ -10,6 +10,7 @@
  * Options:
  *   --view   View name to navigate to
  *   --path   URL path to navigate to
+ *   --threadId Chat thread ID to open on the chat route
  */
 
 import { defineAction } from "@agent-native/core/action";
@@ -22,6 +23,7 @@ export default defineAction({
   schema: z.object({
     view: z.string().optional().describe("View name to navigate to"),
     path: z.string().optional().describe("URL path to navigate to"),
+    threadId: z.string().optional().describe("Chat thread ID to open"),
   }),
   http: false,
   run: async (args) => {
@@ -31,6 +33,7 @@ export default defineAction({
     const nav: Record<string, string> = {};
     if (args.view) nav.view = args.view;
     if (args.path) nav.path = args.path;
+    if (args.threadId) nav.threadId = args.threadId;
     nav._writeId = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
     await writeAppState("navigate", nav);
     return `Navigating to ${args.view || args.path}`;

package/corpus/templates/chat/app/components/layout/Layout.tsx

@@ -35,6 +35,7 @@ const SIDEBAR_COLLAPSE_KEY = "chat.sidebar.collapsed";
 function routeOwnsToolbar(pathname: string): boolean {
   return (
     pathname === "/" ||
+    pathname.startsWith("/chat/") ||
     pathname === "/database" ||
     pathname.startsWith("/extensions")
   );
@@ -45,13 +46,17 @@ export function Layout({ children }: LayoutProps) {
   const navigate = useNavigate();
   const [mobileSidebarOpen, setMobileSidebarOpen] = useState(false);
   const [sidebarCollapsed, setSidebarCollapsed] = useState(true);
-  const isChatRoute = location.pathname === "/";
+  const isChatRoute =
+    location.pathname === "/" || location.pathname.startsWith("/chat/");
   const chatHomeHandoffActive = useAgentChatHomeHandoff({
     storageKey: "chat",
     activePath: location.pathname,
     enabled: !isChatRoute,
   });
-  useAgentChatHomeHandoffLinks({ storageKey: "chat", chatPath: "/" });
+  useAgentChatHomeHandoffLinks({
+    storageKey: "chat",
+    isChatPath: (pathname) => pathname === "/" || pathname.startsWith("/chat/"),
+  });
 
   useEffect(() => {
     setMobileSidebarOpen(false);

package/corpus/templates/chat/app/components/layout/Sidebar.tsx

@@ -104,8 +104,24 @@ function persistedActiveThreadId() {
   }
 }
 
+function threadIdFromPath(pathname: string) {
+  const match = pathname.match(/^\/chat\/([^/]+)/);
+  if (!match) return null;
+  try {
+    const value = decodeURIComponent(match[1]).trim();
+    return value || null;
+  } catch {
+    return null;
+  }
+}
+
+function chatThreadPath(threadId: string) {
+  return `/chat/${encodeURIComponent(threadId)}`;
+}
+
 function ChatThreadsSection() {
   const navigate = useNavigate();
+  const location = useLocation();
   const {
     threads,
     activeThreadId,
@@ -162,7 +178,10 @@ function ChatThreadsSection() {
 
   function openThread(threadId: string, options?: { isNew?: boolean }) {
     switchThread(threadId);
-    navigateWithAgentChatViewTransition(navigate, "/");
+    navigateWithAgentChatViewTransition(
+      navigate,
+      options?.isNew ? "/" : chatThreadPath(threadId),
+    );
     window.requestAnimationFrame(() => {
       window.dispatchEvent(
         new CustomEvent("agent-chat:open-thread", {
@@ -244,7 +263,10 @@ function ChatThreadsSection() {
       </div>
       <div className="grid gap-0.5">
         {visibleThreads.map((thread) => {
-          const isActive = thread.id === activeThreadId;
+          const isActive =
+            thread.id ===
+            (threadIdFromPath(location.pathname) ??
+              (location.pathname === "/" ? null : activeThreadId));
           const isRenaming = thread.id === renamingThreadId;
           return (
             <div
@@ -348,7 +370,8 @@ export function Sidebar({
 }: SidebarProps) {
   const location = useLocation();
   const navigate = useNavigate();
-  const isChatRoute = location.pathname === "/";
+  const isChatRoute =
+    location.pathname === "/" || location.pathname.startsWith("/chat/");
   const ToggleIcon = collapsed
     ? IconLayoutSidebarLeftExpand
     : IconLayoutSidebarLeftCollapse;
@@ -440,7 +463,7 @@ export function Sidebar({
             const Icon = item.icon;
             const isActive =
               item.href === "/"
-                ? location.pathname === "/"
+                ? isChatRoute
                 : location.pathname.startsWith(item.href);
             const link = (
               <Link

package/corpus/templates/chat/app/hooks/use-navigation-state.ts

@@ -10,6 +10,7 @@ import { TAB_ID } from "@/lib/tab-id";
 export interface NavigationState {
   view: string;
   path?: string;
+  threadId?: string;
 }
 
 export function useNavigationState() {
@@ -17,14 +18,21 @@ export function useNavigationState() {
   useAgentRouteState<NavigationState>({
     browserTabId: TAB_ID,
     requestSource: TAB_ID,
-    getNavigationState: ({ pathname, search, hash }) => ({
-      view: viewForPath(pathname),
-      path: appPath(pathname),
-    }),
+    getNavigationState: ({ pathname }) => {
+      const threadId = threadIdFromPath(pathname);
+      return {
+        view: viewForPath(pathname),
+        path: appPath(pathname),
+        ...(threadId ? { threadId } : {}),
+      };
+    },
     getCommandPath: (command) =>
-      routerPath(command.path || pathForView(command.view)),
+      routerPath(command.path || pathForCommand(command)),
     onNavigate: (_command, path) => {
-      if (location.pathname === "/" && pathnameFromPath(path) !== "/") {
+      if (
+        isChatPath(location.pathname) &&
+        !isChatPath(pathnameFromPath(path))
+      ) {
         markAgentChatHomeHandoff("chat");
       }
     },
@@ -35,7 +43,19 @@ function pathnameFromPath(path: string): string {
   return path.split(/[?#]/, 1)[0] || "/";
 }
 
+function threadIdFromPath(pathname: string): string | null {
+  const match = pathname.match(/^\/chat\/([^/]+)/);
+  if (!match) return null;
+  try {
+    const value = decodeURIComponent(match[1]).trim();
+    return value || null;
+  } catch {
+    return null;
+  }
+}
+
 function viewForPath(pathname: string): string {
+  if (isChatPath(pathname)) return "chat";
   if (pathname.startsWith("/database")) return "database";
   if (pathname.startsWith("/extensions")) return "extensions";
   if (pathname.startsWith("/observability")) return "observability";
@@ -62,6 +82,14 @@ function pathForView(view?: string): string {
   }
 }
 
+function pathForCommand(command: any): string {
+  const path = pathForView(command?.view);
+  if (path !== "/") return path;
+  const threadId =
+    typeof command?.threadId === "string" ? command.threadId.trim() : "";
+  return threadId ? `/chat/${encodeURIComponent(threadId)}` : "/";
+}
+
 function routerPath(path: string): string {
   const basePath = appBasePath();
   if (!basePath) return path;
@@ -71,3 +99,7 @@ function routerPath(path: string): string {
   }
   return path;
 }
+
+function isChatPath(pathname: string): boolean {
+  return pathname === "/" || pathname.startsWith("/chat/");
+}

package/corpus/templates/chat/app/routes/_index.tsx

@@ -1,4 +1,5 @@
 import { useEffect } from "react";
+import { useNavigate, useParams } from "react-router";
 import {
   AgentChatSurface,
   markAgentChatHomeHandoff,
@@ -25,7 +26,14 @@ export function meta() {
   ];
 }
 
+function chatThreadPath(threadId: string | null) {
+  return threadId ? `/chat/${encodeURIComponent(threadId)}` : "/";
+}
+
 export default function ChatRoute() {
+  const { threadId } = useParams();
+  const navigate = useNavigate();
+
   useEffect(() => {
     function handleChatRunning(event: Event) {
       const detail = (event as CustomEvent).detail;
@@ -45,6 +53,11 @@ export default function ChatRoute() {
         className="h-full"
         defaultMode="chat"
         storageKey="chat"
+        threadUrlSync={{
+          routeThreadId: threadId ?? null,
+          getPath: chatThreadPath,
+          navigate,
+        }}
         browserTabId={TAB_ID}
         showHeader={false}
         showTabBar={false}

package/corpus/templates/chat/app/routes/chat.$threadId.tsx

@@ -0,0 +1 @@
+export { default, meta } from "./_index";

package/corpus/templates/dispatch/app/routes/chat.$threadId.tsx

@@ -0,0 +1,26 @@
+export { default } from "@agent-native/dispatch/routes/pages/chat";
+import type { LoaderFunctionArgs } from "react-router";
+import {
+  buildThreadLinkPreviewMeta,
+  type ThreadLinkPreview,
+} from "@agent-native/dispatch/lib/thread-link-preview";
+
+export async function loader({ params, request }: LoaderFunctionArgs) {
+  const threadId =
+    params.threadId ?? new URL(request.url).searchParams.get("thread");
+  const { loadThreadLinkPreview } =
+    await import("@agent-native/dispatch/server/lib/thread-link-preview");
+  return {
+    threadPreview: await loadThreadLinkPreview(threadId),
+  };
+}
+
+export function meta({
+  data,
+}: {
+  data?: { threadPreview: ThreadLinkPreview | null };
+}) {
+  return data?.threadPreview
+    ? buildThreadLinkPreviewMeta(data.threadPreview)
+    : [{ title: "Chat — Dispatch" }];
+}

package/dist/client/AgentPanel.d.ts

@@ -21,7 +21,7 @@
  *   <AgentChatSurface mode="page" className="h-screen" />
  */
 import React from "react";
-import type { MultiTabAssistantChatHeaderProps } from "./MultiTabAssistantChat.js";
+import type { MultiTabAssistantChatHeaderProps, MultiTabAssistantChatProps } from "./MultiTabAssistantChat.js";
 import type { AssistantChatProps } from "./AssistantChat.js";
 export declare function getAgentPanelChatTabGroups(tabs: MultiTabAssistantChatHeaderProps["tabs"], activeTabId: string): {
     activeTab: import("./MultiTabAssistantChat.js").ChatTab | undefined;
@@ -80,6 +80,8 @@ export interface AgentPanelProps extends Omit<AssistantChatProps, "onSwitchToCli
     scope?: import("./use-chat-threads.js").ChatThreadScope | null;
     /** Stable browser tab id used for tab-scoped app-state context. */
     browserTabId?: string;
+    /** Keep chat thread selection in URL state. */
+    threadUrlSync?: MultiTabAssistantChatProps["threadUrlSync"];
     /** Optional notice rendered below the main header while Chat mode is active. */
     chatNotice?: React.ReactNode;
     /** Show the chat thread tab row when the panel header is hidden. Default: true. */
@@ -150,12 +152,14 @@ export interface AgentSidebarProps {
     scope?: import("./use-chat-threads.js").ChatThreadScope | null;
     /** Stable browser tab id used for tab-scoped app-state context. */
     browserTabId?: string;
+    /** Keep chat thread selection in URL state. */
+    threadUrlSync?: MultiTabAssistantChatProps["threadUrlSync"];
 }
 /**
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.
  */
-export declare function AgentSidebar({ children, emptyStateText, suggestions, dynamicSuggestions, defaultSidebarWidth, sidebarWidth, position, defaultOpen, animateMobile, chatViewTransition, storageKey, openOnChatRunning, onFullscreenRequest, scope, browserTabId, }: AgentSidebarProps): import("react/jsx-runtime").JSX.Element;
+export declare function AgentSidebar({ children, emptyStateText, suggestions, dynamicSuggestions, defaultSidebarWidth, sidebarWidth, position, defaultOpen, animateMobile, chatViewTransition, storageKey, openOnChatRunning, onFullscreenRequest, scope, browserTabId, threadUrlSync, }: AgentSidebarProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Focus the agent chat composer input.
  * Opens the sidebar if closed, then focuses the text input.