@iloveagents/foundry-web-ui 0.29.1 → 0.31.0

package/dist/components/context-bar.js

@@ -1,23 +1,4 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { PinStateIcon } from "./pin-state-icon.js";
-/**
- * Context Pins — pin button with count badge and hover flyout.
- *
- * Click: toggles pin/unpin current page.
- * Hover (when pins exist): shows flyout to view, navigate, and remove pins.
- */
-import { useState, useRef, useEffect, createElement } from "react";
-import { useNavigate } from "react-router";
-import { X, TextSelect, FileText, Link2, StickyNote } from "lucide-react";
-import { cn } from "@iloveagents/foundry-web-primitives";
-import { TooltipIconButton } from "./tooltip-icon-button.js";
 import { useAppStore } from "../lib/app-store.js";
-const CONTEXT_ICONS = {
-    selection: TextSelect,
-    page: FileText,
-    ref: Link2,
-    note: StickyNote,
-};
 /** Resolve the URL a context item navigates to when clicked.
  *
  * Two shapes the framework knows about:
@@ -59,15 +40,14 @@ export function getNavigablePath(item) {
     return null;
 }
 /**
- * The "is this page pinned, and how do I flip that" logic, shared by the
- * pin badge here and the composer's add-menu. Two call sites deciding
- * independently what "pinned" means is how they end up disagreeing.
+ * Pin the current navigation context from the With menu.
  */
 export function usePagePin() {
     const items = useAppStore((s) => s.contextItems);
     const removeItem = useAppStore((s) => s.removeContextItem);
     const addContextItem = useAppStore((s) => s.addContextItem);
-    const currentPage = useAppStore((s) => s.currentPage);
+    const page = useAppStore((s) => s.currentPage);
+    const currentPage = page;
     const pageLabel = useAppStore((s) => s.navContext.label);
     const navMeta = useAppStore((s) => s.navContext.meta);
     const currentPagePin = items.find((i) => i.persistence === "persistent" &&
@@ -91,54 +71,3 @@ export function usePagePin() {
         },
     };
 }
-export const ContextPins = ({ allowPageToggle = true, showPinButton = false, compact = false, flyoutDirection = "up", }) => {
-    const items = useAppStore((s) => s.contextItems);
-    const removeItem = useAppStore((s) => s.removeContextItem);
-    const currentPage = useAppStore((s) => s.currentPage);
-    const { isPinned: isCurrentPagePinned, toggle: handleTogglePin } = usePagePin();
-    const navigate = useNavigate();
-    const [flyoutOpen, setFlyoutOpen] = useState(false);
-    const containerRef = useRef(null);
-    const hoverTimeout = useRef(undefined);
-    const pinned = items.filter((i) => i.persistence === "persistent");
-    // Close flyout on outside click
-    useEffect(() => {
-        if (!flyoutOpen)
-            return;
-        const handleClick = (e) => {
-            if (containerRef.current && !containerRef.current.contains(e.target)) {
-                setFlyoutOpen(false);
-            }
-        };
-        document.addEventListener("mousedown", handleClick);
-        return () => document.removeEventListener("mousedown", handleClick);
-    }, [flyoutOpen]);
-    const handleMouseEnter = () => {
-        clearTimeout(hoverTimeout.current);
-        if (pinned.length > 0)
-            setFlyoutOpen(true);
-    };
-    const handleMouseLeave = () => {
-        hoverTimeout.current = setTimeout(() => setFlyoutOpen(false), 200);
-    };
-    if (pinned.length === 0 && !showPinButton)
-        return null;
-    return (_jsxs("div", { className: "relative", ref: containerRef, onMouseEnter: handleMouseEnter, onMouseLeave: handleMouseLeave, onFocus: handleMouseEnter, onBlur: (event) => {
-            if (!event.currentTarget.contains(event.relatedTarget))
-                setFlyoutOpen(false);
-        }, children: [_jsxs(TooltipIconButton, { tooltip: allowPageToggle
-                    ? isCurrentPagePinned
-                        ? "Unpin this page"
-                        : "Pin this page"
-                    : "Manage pinned context", size: "icon", className: cn("shrink-0 relative", compact ? "size-7" : "size-8", isCurrentPagePinned ? "text-foreground" : "text-muted-foreground"), "aria-pressed": allowPageToggle ? isCurrentPagePinned : undefined, "aria-expanded": !allowPageToggle ? flyoutOpen : undefined, onClick: allowPageToggle ? handleTogglePin : () => setFlyoutOpen(true), children: [_jsx(PinStateIcon, { pinned: isCurrentPagePinned, className: compact ? "size-3.5" : "size-4" }), pinned.length > 0 && (_jsx("span", { className: cn("absolute rounded-full bg-primary font-medium text-primary-foreground flex items-center justify-center", compact
-                            ? "-top-0.5 -right-0.5 size-3.5 text-[9px]"
-                            : "top-0 right-0 size-3.5 text-[9px]"), children: pinned.length }))] }), flyoutOpen && pinned.length > 0 && (_jsxs("div", { className: cn("absolute z-50 w-64 rounded-lg border border-border bg-background shadow-xl p-2 space-y-1", flyoutDirection === "up" ? "bottom-full mb-2 left-0" : "top-9 right-0"), children: [_jsx("div", { className: "px-1 pb-1 border-b border-border/50", children: _jsx("span", { className: "text-[10px] font-medium text-muted-foreground uppercase tracking-wide", children: "Pinned Context" }) }), pinned.map((item) => {
-                        const navPath = getNavigablePath(item);
-                        return (_jsxs("div", { className: "flex items-center gap-1.5 px-1 py-1 rounded hover:bg-muted group/pin", children: [createElement(CONTEXT_ICONS[item.type] ?? TextSelect, {
-                                    className: "size-3 text-primary shrink-0",
-                                }), navPath ? (_jsx("button", { type: "button", onClick: () => {
-                                        navigate(navPath);
-                                        setFlyoutOpen(false);
-                                    }, className: "text-xs text-foreground truncate flex-1 text-left hover:underline", children: item.label })) : (_jsx("span", { className: "text-xs text-foreground truncate flex-1", children: item.label })), _jsx("button", { type: "button", onClick: () => removeItem(item.id), className: cn("p-0.5 rounded hover:bg-primary/10 transition-opacity shrink-0", "opacity-0 group-hover/pin:opacity-100"), "aria-label": `Remove ${item.label}`, children: _jsx(X, { className: "size-3 text-muted-foreground" }) })] }, item.id));
-                    })] }))] }));
-};

package/dist/components/focus-chat-pane.js

@@ -8,5 +8,5 @@ import { FocusPaneResize } from "./data-table/focus-pane-resize.js";
 import { ChatContent } from "./assistant-chat.js";
 export function FocusChatPane({ chatOpen, setChatOpen, chatWidth, setChatWidth, source, onClose, }) {
     const pageLabel = useAppStore((state) => state.navContext.label);
-    return (_jsxs("aside", { "aria-label": "Focused content chat", style: { "--focus-chat-width": `${chatWidth ?? 384}px` }, className: cn("relative flex min-h-0 shrink-0 flex-col border-r border-border bg-background", chatOpen ? "w-full md:w-[var(--focus-chat-width)]" : "w-11", source && "hidden xl:flex"), children: [_jsx("div", { className: cn("flex h-12 shrink-0 items-center", chatOpen ? "gap-1 border-b border-border px-2" : "justify-center"), children: chatOpen ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "min-w-0 flex-1 px-2 text-sm font-semibold", children: "Chat" }), _jsx(TooltipIconButton, { tooltip: "Collapse chat", "aria-label": "Collapse chat", className: "size-8", onClick: () => setChatOpen(false), children: _jsx(PanelLeft, { size: 18 }) }), _jsx(Button, { variant: "ghost", size: "icon", title: "Close", "aria-label": "Close", className: "size-8 md:hidden", onClick: () => onClose(), children: _jsx(X, { size: 18 }) })] })) : (_jsx(TooltipIconButton, { tooltip: "Expand chat", "aria-label": "Expand chat", "aria-expanded": false, className: "size-8", onClick: () => setChatOpen(true), children: _jsx(MessageSquare, { size: 18 }) })) }), chatOpen && (_jsx(FocusPaneResize, { label: "chat", side: "right", width: chatWidth, onResize: setChatWidth })), chatOpen && (_jsx(ChatContent, { emptyState: _jsx(ChatEmptyState, { pageLabel: pageLabel, homeStarterPriority: 20 }), compactComposer: true, showPinButton: false, hideCurrentPageBadge: true, starterSuggestions: [] }))] }));
+    return (_jsxs("aside", { "aria-label": "Focused content chat", style: { "--focus-chat-width": `${chatWidth ?? 384}px` }, className: cn("relative flex min-h-0 shrink-0 flex-col border-r border-border bg-background", chatOpen ? "w-full md:w-[var(--focus-chat-width)]" : "w-11", source && "hidden xl:flex"), children: [_jsx("div", { className: cn("flex h-12 shrink-0 items-center", chatOpen ? "gap-1 border-b border-border px-2" : "justify-center"), children: chatOpen ? (_jsxs(_Fragment, { children: [_jsx("span", { className: "min-w-0 flex-1 px-2 text-sm font-semibold", children: "Chat" }), _jsx(TooltipIconButton, { tooltip: "Collapse chat", "aria-label": "Collapse chat", className: "size-8", onClick: () => setChatOpen(false), children: _jsx(PanelLeft, { size: 18 }) }), _jsx(Button, { variant: "ghost", size: "icon", title: "Close", "aria-label": "Close", className: "size-8 md:hidden", onClick: () => onClose(), children: _jsx(X, { size: 18 }) })] })) : (_jsx(TooltipIconButton, { tooltip: "Expand chat", "aria-label": "Expand chat", "aria-expanded": false, className: "size-8", onClick: () => setChatOpen(true), children: _jsx(MessageSquare, { size: 18 }) })) }), chatOpen && (_jsx(FocusPaneResize, { label: "chat", side: "right", width: chatWidth, onResize: setChatWidth })), chatOpen && (_jsx(ChatContent, { emptyState: _jsx(ChatEmptyState, { pageLabel: pageLabel, homeStarterPriority: 20 }), compactComposer: true, starterSuggestions: [] }))] }));
 }

package/dist/components/markdown-text.js

@@ -132,10 +132,12 @@ function extractCodeInfo(children) {
  * Shared markdown component overrides used by both chat messages and the tool panel.
  */
 export const markdownComponents = {
-    h1: ({ children, ...props }) => (_jsx("h1", { className: "text-2xl font-bold mt-6 mb-4 text-foreground", ...props, children: children })),
-    h2: ({ children, ...props }) => (_jsx("h2", { className: "text-xl font-bold mt-5 mb-3 text-foreground", ...props, children: children })),
-    h3: ({ children, ...props }) => (_jsx("h3", { className: "text-lg font-semibold mt-4 mb-2 text-foreground", ...props, children: children })),
-    h4: ({ children, ...props }) => (_jsx("h4", { className: "text-base font-semibold mt-3 mb-1.5 text-foreground", ...props, children: children })),
+    h1: ({ children, ...props }) => (_jsx("h1", { className: "text-2xl font-bold mt-6 mb-4 text-content-heading-1", ...props, children: children })),
+    h2: ({ children, ...props }) => (_jsx("h2", { className: "text-xl font-bold mt-5 mb-3 text-content-heading-2", ...props, children: children })),
+    h3: ({ children, ...props }) => (_jsx("h3", { className: "text-lg font-semibold mt-4 mb-2 text-content-heading-3", ...props, children: children })),
+    h4: ({ children, ...props }) => (_jsx("h4", { className: "text-base font-semibold mt-3 mb-1.5 text-content-heading-4", ...props, children: children })),
+    h5: ({ children, ...props }) => (_jsx("h5", { className: "mt-3 mb-1.5 text-sm font-semibold text-content-heading-5", ...props, children: children })),
+    h6: ({ children, ...props }) => (_jsx("h6", { className: "mt-3 mb-1.5 text-xs font-semibold text-content-heading-6", ...props, children: children })),
     p: ({ children, ...props }) => (_jsx("p", { className: "mb-2 leading-relaxed text-foreground", ...props, children: injectCitations(children) })),
     ul: ({ children, ...props }) => (_jsx("ul", { className: "list-disc list-outside pl-6 mb-4 space-y-1 text-foreground", ...props, children: children })),
     ol: ({ children, ...props }) => (_jsx("ol", { className: "list-decimal list-outside pl-6 mb-4 space-y-1 text-foreground", ...props, children: children })),

package/dist/components/sidebar.js

@@ -13,9 +13,9 @@ import { TooltipIconButton } from "./tooltip-icon-button.js";
 import { Button } from "@iloveagents/foundry-web-primitives";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, } from "../ui/dropdown-menu.js";
 import { AppBrand } from "./app-brand.js";
-const ACTIVE_NAV_ROW_CLASS = "border border-transparent bg-sidebar-selected shadow-none";
-const ACTIVE_NAV_TEXT_CLASS = "font-semibold text-sidebar-foreground";
-const ACTIVE_NAV_ICON_CLASS = "text-primary";
+const ACTIVE_NAV_ROW_CLASS = "border border-transparent bg-sidebar-selected text-sidebar-selected-foreground shadow-none";
+const ACTIVE_NAV_TEXT_CLASS = "font-semibold text-sidebar-selected-foreground";
+const ACTIVE_NAV_ICON_CLASS = "text-sidebar-selected-foreground";
 const ACTIVE_NAV_BADGE_CLASS = "border border-sidebar-border bg-background/60 text-sidebar-foreground";
 // Indent ladder for the nav tree, indexed by depth (0 = top-level item).
 //
@@ -437,13 +437,15 @@ function ContainerDropZone({ dnd }) {
 function NavTwisty({ hasChildren, childrenUnloaded = false, isExpanded, onToggle, label, isActive, depth, inTree = true, }) {
     const cell = cn(NAV_TWISTY_CLASS, getNavDepthOffsets(depth).column);
     if (!hasChildren) {
-        return (_jsx("span", { "data-nav-twisty-cell": true, "aria-hidden": "true", className: cn(cell, "pointer-events-none"), children: inTree && !childrenUnloaded && (_jsx("span", { "data-nav-leaf-dot": true, className: cn("block size-1 shrink-0 rounded-full", isActive ? "bg-primary/70" : "bg-sidebar-foreground/30") })) }));
+        return (_jsx("span", { "data-nav-twisty-cell": true, "aria-hidden": "true", className: cn(cell, "pointer-events-none"), children: inTree && !childrenUnloaded && (_jsx("span", { "data-nav-leaf-dot": true, className: cn("block size-1 shrink-0 rounded-full", isActive ? "bg-sidebar-selected-foreground/70" : "bg-sidebar-foreground/30") })) }));
     }
     return (_jsx("span", { "data-nav-twisty-cell": true, className: cell, children: _jsx("button", { type: "button", "data-nav-twisty": true, "aria-expanded": isExpanded, "aria-label": isExpanded ? `Collapse ${label}` : `Expand ${label}`, onClick: (e) => {
                 e.preventDefault();
                 e.stopPropagation();
                 onToggle?.();
-            }, className: cn("flex items-center justify-center rounded", NAV_TWISTY_HIT_CLASS, isActive ? "text-primary" : "text-sidebar-foreground/50 hover:text-sidebar-foreground"), children: _jsx(ChevronRight, { className: cn("size-3.5 transition-transform duration-150", isExpanded && "rotate-90") }) }) }));
+            }, className: cn("flex items-center justify-center rounded", NAV_TWISTY_HIT_CLASS, isActive
+                ? "text-sidebar-selected-foreground"
+                : "text-sidebar-foreground/50 hover:text-sidebar-foreground"), children: _jsx(ChevronRight, { className: cn("size-3.5 transition-transform duration-150", isExpanded && "rotate-90") }) }) }));
 }
 function NavItemActions({ actions }) {
     return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsx(Button, { type: "button", variant: "ghost", size: "icon", className: "size-7 rounded-md text-muted-foreground hover:bg-muted/80 hover:text-foreground", onClick: (e) => {
@@ -506,10 +508,11 @@ function NavLeafItem({ item, isActive, onClick, depth = 0, }) {
 }
 function SubNavItems({ items, parentPath, depth = 1, }) {
     const navigate = useNavigate();
-    const currentPath = useLocation().pathname;
+    const location = useLocation();
+    const currentPath = location.pathname + location.search;
     const setNavContext = useAppStore((s) => s.setNavContext);
     const navContext = useAppStore((s) => s.navContext);
-    const isOnParent = currentPath === parentPath;
+    const isOnParent = matchesNavLocation(currentPath, parentPath);
     const [activeLabel, setActiveLabel] = useState(items[0]?.label ?? "");
     // Children with unique paths (e.g., SPACES documents) use URL matching;
     // children sharing the parent path (e.g., Documents sub-filters) use label matching.
@@ -543,19 +546,40 @@ function SubNavItems({ items, parentPath, depth = 1, }) {
 }
 /** Check if current page is inside a nav item's subtree. */
 function isInSubtree(currentPage, item) {
-    if (currentPage === item.to)
+    if (matchesNavLocation(currentPage, item.to))
         return true;
     return item.children?.some((c) => isInSubtree(currentPage, c)) ?? false;
 }
+/** A navigation target may declare stable scope parameters while the page
+ * adds transient state such as a selected row or table sort. */
+function matchesNavLocation(currentPage, target) {
+    const current = new URL(currentPage, "http://navigation.local");
+    const destination = new URL(target, current.origin);
+    if (current.pathname.replace(/\/+$/, "") !== destination.pathname.replace(/\/+$/, "")) {
+        return false;
+    }
+    if (destination.searchParams.size === 0)
+        return true;
+    return [...destination.searchParams].every(([key, value]) => current.searchParams.getAll(key).includes(value));
+}
+function hasMoreSpecificNavMatch(currentPage, target) {
+    const count = new URL(target, "http://navigation.local").searchParams.size;
+    const walk = (items) => items.some((item) => (matchesNavLocation(currentPage, item.to) &&
+        new URL(item.to, "http://navigation.local").searchParams.size > count) ||
+        walk(item.children ?? []));
+    return useNavStore.getState().config.some((group) => walk(group.items));
+}
 /** A list owns the sidebar selection of descendants it deliberately does not draw.
  * The route lookup still resolves the actual descendant for chat and page actions. */
 function isSelectedNavItem(currentPage, item) {
-    return currentPage === item.to || Boolean(item.childrenHidden && isInSubtree(currentPage, item));
+    return ((matchesNavLocation(currentPage, item.to) && !hasMoreSpecificNavMatch(currentPage, item.to)) ||
+        Boolean(item.childrenHidden && isInSubtree(currentPage, item)));
 }
 /** Nested folder with collapsible children (used inside SubNavItems). */
 function NestedFolderItem({ item, depth }) {
     const navigate = useNavigate();
-    const currentPath = useLocation().pathname;
+    const location = useLocation();
+    const currentPath = location.pathname + location.search;
     const setNavContext = useAppStore((s) => s.setNavContext);
     const navContext = useAppStore((s) => s.navContext);
     const isInsideSubtree = isInSubtree(currentPath, item);
@@ -624,7 +648,8 @@ function NestedFolderItem({ item, depth }) {
 }
 function CollapsibleNavItem({ item, inTree = true, heading = false, underHeader = false, }) {
     const navigate = useNavigate();
-    const currentPath = useLocation().pathname;
+    const location = useLocation();
+    const currentPath = location.pathname + location.search;
     const setNavContext = useAppStore((s) => s.setNavContext);
     const navContext = useAppStore((s) => s.navContext);
     const isInsideSubtree = isInSubtree(currentPath, item);
@@ -643,7 +668,9 @@ function CollapsibleNavItem({ item, inTree = true, heading = false, underHeader
         : heading || !underHeader
             ? NAV_FLAT_BODY_CLASS
             : getNavDepthOffsets(0).body;
-    const headingClass = heading && !isDisabled && "font-semibold text-sidebar-foreground";
+    const headingClass = heading &&
+        !isDisabled &&
+        `font-semibold ${isActive ? "text-sidebar-selected-foreground" : "text-sidebar-primary"}`;
     const { draggableProps, dropTargetProps, isDragOver, isFileDragOver } = useNavItemDnd(item.dnd);
     const rendersRow = Boolean(hasChildren || hasActions);
     const activeRowRef = useActiveNavRowScroll(isActive && rendersRow);
@@ -693,7 +720,12 @@ function CollapsibleNavItem({ item, inTree = true, heading = false, underHeader
             // Transparent border for box-model parity — see the NavLink variant.
             "rounded-lg border border-transparent pr-3 py-1.5 text-left text-sm text-sidebar-foreground/45"), children: [_jsx(NavTwisty, { hasChildren: false, childrenUnloaded: item.childrenUnloaded, inTree: rowInTree, label: item.label, depth: 0 }), _jsx(item.icon, { className: "size-4 shrink-0 text-sidebar-foreground/45" }), _jsx("span", { className: "truncate", children: item.label })] }));
     }
-    return (_jsx(NavLink, { ref: activeLinkRef, "data-active-nav-row": isActive ? "true" : undefined, "data-nav-depth": 0, to: item.to, ...draggableProps, ...dropTargetProps, className: () => cn("relative flex items-center gap-2 w-full", bodyClass, 
+    return (_jsx(NavLink, { ref: activeLinkRef, "data-active-nav-row": isActive ? "true" : undefined, "data-nav-depth": 0, to: item.to, onClick: (event) => {
+            if (!isActive || !matchesNavLocation(currentPath, item.to))
+                return;
+            event.preventDefault();
+            useSidebarStore.getState().closeMobile();
+        }, ...draggableProps, ...dropTargetProps, className: () => cn("relative flex items-center gap-2 w-full", bodyClass, 
         // The transparent border is NOT decoration: it is what makes this
         // row's box model match every other variant. An absolutely
         // positioned twisty resolves against the PADDING box, so a row
@@ -766,7 +798,8 @@ function SidebarResizeHandle() {
 // group is now the source of truth for "you're in a chat right now".
 // Kept as a comment so future spelunkers know it was intentional.
 function CollapsedNavShortcut({ to, label, icon: Icon, isActive, }) {
-    return (_jsx(NavLink, { to: to, children: _jsx(TooltipIconButton, { tooltip: label, side: "right", className: cn(isActive && "border border-transparent bg-sidebar-selected text-sidebar-foreground"), children: _jsx(Icon, { className: cn("size-4", isActive ? "text-primary" : "text-sidebar-icon") }) }) }, to));
+    return (_jsx(NavLink, { to: to, children: _jsx(TooltipIconButton, { tooltip: label, side: "right", className: cn(isActive &&
+                "border border-transparent bg-sidebar-selected text-sidebar-selected-foreground"), children: _jsx(Icon, { className: cn("size-4", isActive ? "text-sidebar-selected-foreground" : "text-sidebar-icon") }) }) }, to));
 }
 // ---------------------------------------------------------------------------
 // Collapsible nav-group state — persisted per-label in localStorage so the
@@ -953,7 +986,7 @@ function NavGroupSection({ group }) {
                 // collapsible headers and item labels.
                 _jsxs("div", { "data-nav-group-header": true, className: cn("flex items-center justify-between py-1.5 transition-colors hover:bg-sidebar-accent/70", SIDEBAR_GROUP_HEADER_BOX, SIDEBAR_ITEM_GAP_CLASS), children: [_jsx("span", { "aria-hidden": "true", className: SIDEBAR_ITEM_ICON_CLASS }), _jsx(NavLink, { to: group.to, end: true, className: "min-w-0 flex-1", children: ({ isActive }) => (_jsx("span", { className: cn("block", SIDEBAR_GROUP_HEADER_LABEL_CLASS, isActive
                                     ? "text-sidebar-selected-foreground"
-                                    : "text-sidebar-foreground/75 hover:text-sidebar-foreground"), children: group.label })) }), group.createActions && group.createActions.length > 0 && (_jsx(CreateActionsMenu, { group: group }))] })) : (_jsxs("div", { "data-nav-group-header": true, className: cn("flex items-center", SIDEBAR_GROUP_HEADER_BOX, SIDEBAR_ITEM_GAP_CLASS), children: [_jsx("span", { "aria-hidden": "true", className: SIDEBAR_ITEM_ICON_CLASS }), _jsx("span", { className: cn("text-sidebar-foreground/75", SIDEBAR_GROUP_HEADER_LABEL_CLASS), children: group.label })] })) })), !collapsed && (_jsx("div", { className: cn(animateRows &&
+                                    : "text-sidebar-foreground/75 hover:text-sidebar-foreground"), children: group.label })) }), group.createActions && group.createActions.length > 0 && (_jsx(CreateActionsMenu, { group: group }))] })) : (_jsxs("div", { "data-nav-group-header": true, className: cn("flex items-center", SIDEBAR_GROUP_HEADER_BOX, SIDEBAR_ITEM_GAP_CLASS), children: [_jsx("span", { "aria-hidden": "true", className: SIDEBAR_ITEM_ICON_CLASS }), _jsx("span", { className: cn("text-sidebar-foreground/75", SIDEBAR_GROUP_HEADER_LABEL_CLASS), children: group.label })] })) })), !collapsed && (_jsx("div", { "data-nav-group-items": true, className: cn(animateRows &&
                     "motion-safe:animate-in motion-safe:fade-in-0 motion-safe:slide-in-from-top-1 motion-safe:duration-200"), children: (focused ? [focusedItem] : group.items).map((item) => (_jsx(CollapsibleNavItem, { item: item, 
                     // A leaf dot distinguishes "nothing under this" from a sibling
                     // that branches. Decided per GROUP: Workspaces has branches, so
@@ -996,7 +1029,8 @@ function SidebarContent({ collapsed, groups, onNewConversation, hideFooterAction
     // still resolving, so the skeleton never flashes over a populated tree.
     const hasWorkspacesGroup = navConfig.some((group) => group.label === "Workspaces" || group.meta?.type === "spaces-workspaces");
     const showNavSkeleton = navLoading && !hasWorkspacesGroup;
-    const currentPage = useLocation().pathname;
+    const location = useLocation();
+    const currentPage = location.pathname + location.search;
     const navContext = useAppStore((s) => s.navContext);
     useScrollActiveNavRow(currentPage, navConfig, collapsed);
     const preventNativeFileDrop = useCallback((e) => {
@@ -1050,7 +1084,7 @@ function SidebarContent({ collapsed, groups, onNewConversation, hideFooterAction
                                     to: it.to,
                                     label: it.label,
                                     icon: it.icon,
-                                    isActive: currentPage === it.to,
+                                    isActive: isSelectedNavItem(currentPage, it),
                                 }));
                             return { group, groupIndex, items };
                         })

package/dist/components/tool-panel.js

@@ -141,5 +141,5 @@ export function ToolPanel({ contained = false }) {
                     else
                         return;
                     event.preventDefault();
-                }, className: cn("absolute left-0 top-0 z-10 h-full w-2 -translate-x-1/2", "cursor-col-resize touch-none", "before:absolute before:inset-y-0 before:left-1/2 before:w-px before:-translate-x-1/2", "before:bg-transparent hover:before:bg-primary/40 focus-visible:before:bg-primary", "focus:outline-none") })) : null, _jsx("div", { className: "flex-shrink-0 border-b border-border px-6 py-4", children: _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("h2", { className: "text-lg font-semibold text-foreground truncate pr-4", children: content.title }), _jsxs("div", { className: "flex items-center gap-1", children: [entityId && (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", onClick: handleToggleEntityPin, className: cn("flex items-center justify-center", "size-8 rounded-md shrink-0", "hover:bg-muted transition-colors", "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary", isEntityPinned ? "text-foreground" : "text-muted-foreground"), "aria-pressed": isEntityPinned, "aria-label": isEntityPinned ? "Unpin document" : "Pin document", title: isEntityPinned ? "Unpin document" : "Pin document", children: _jsx(PinStateIcon, { pinned: isEntityPinned }) }), _jsx("button", { type: "button", onClick: handleNavigateToEntity, className: cn("flex items-center justify-center", "size-8 rounded-md shrink-0", "hover:bg-muted transition-colors", "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary"), "aria-label": "Open in navigation", title: "Open in navigation", children: _jsx(FolderOpen, { className: "size-4 text-muted-foreground" }) })] })), _jsx("button", { type: "button", onClick: handleCopyAll, className: cn("flex items-center justify-center", "size-8 rounded-md flex-shrink-0", "hover:bg-muted transition-colors", "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary"), "aria-label": "Copy content", children: copied ? (_jsx(Check, { className: "size-4 text-success" })) : (_jsx(Copy, { className: "size-4 text-muted-foreground" })) }), !contained && (_jsx("button", { type: "button", onClick: toggleFullscreen, className: cn("flex items-center justify-center", "size-8 rounded-md flex-shrink-0", "hover:bg-muted transition-colors", "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary"), "aria-label": isFullscreen ? "Exit fullscreen" : "Fullscreen", children: isFullscreen ? (_jsx(Minimize2, { className: "size-4 text-muted-foreground" })) : (_jsx(Maximize2, { className: "size-4 text-muted-foreground" })) })), _jsx("button", { type: "button", onClick: closePanel, className: cn("flex items-center justify-center", "size-8 rounded-md flex-shrink-0", "hover:bg-muted transition-colors", "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary"), "aria-label": "Close panel", children: _jsx(X, { className: "size-5 text-muted-foreground" }) })] })] }) }), _jsxs("div", { className: "relative flex-1 overflow-y-auto", ref: contentRef, "data-testid": "tool-panel-content", children: [_jsx(PanelContentRenderer, { content: content }), _jsx(SelectionPopover, { containerRef: contentRef })] })] }));
+                }, className: cn("absolute left-0 top-0 z-10 h-full w-2 -translate-x-1/2", "cursor-col-resize touch-none", "before:absolute before:inset-y-0 before:left-1/2 before:w-px before:-translate-x-1/2", "before:bg-transparent hover:before:bg-primary/40 focus-visible:before:bg-primary", "focus:outline-none") })) : null, _jsx("div", { className: "flex-shrink-0 border-b border-border px-6 py-4", children: _jsxs("div", { className: "flex items-center justify-between", children: [_jsx("h2", { className: "text-lg font-semibold text-heading truncate pr-4", children: content.title }), _jsxs("div", { className: "flex items-center gap-1", children: [entityId && (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", onClick: handleToggleEntityPin, className: cn("flex items-center justify-center", "size-8 rounded-md shrink-0", "hover:bg-muted transition-colors", "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary", isEntityPinned ? "text-foreground" : "text-muted-foreground"), "aria-pressed": isEntityPinned, "aria-label": isEntityPinned ? "Unpin document" : "Pin document", title: isEntityPinned ? "Unpin document" : "Pin document", children: _jsx(PinStateIcon, { pinned: isEntityPinned }) }), _jsx("button", { type: "button", onClick: handleNavigateToEntity, className: cn("flex items-center justify-center", "size-8 rounded-md shrink-0", "hover:bg-muted transition-colors", "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary"), "aria-label": "Open in navigation", title: "Open in navigation", children: _jsx(FolderOpen, { className: "size-4 text-muted-foreground" }) })] })), _jsx("button", { type: "button", onClick: handleCopyAll, className: cn("flex items-center justify-center", "size-8 rounded-md flex-shrink-0", "hover:bg-muted transition-colors", "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary"), "aria-label": "Copy content", children: copied ? (_jsx(Check, { className: "size-4 text-success" })) : (_jsx(Copy, { className: "size-4 text-muted-foreground" })) }), !contained && (_jsx("button", { type: "button", onClick: toggleFullscreen, className: cn("flex items-center justify-center", "size-8 rounded-md flex-shrink-0", "hover:bg-muted transition-colors", "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary"), "aria-label": isFullscreen ? "Exit fullscreen" : "Fullscreen", children: isFullscreen ? (_jsx(Minimize2, { className: "size-4 text-muted-foreground" })) : (_jsx(Maximize2, { className: "size-4 text-muted-foreground" })) })), _jsx("button", { type: "button", onClick: closePanel, className: cn("flex items-center justify-center", "size-8 rounded-md flex-shrink-0", "hover:bg-muted transition-colors", "focus:outline-none focus-visible:ring-2 focus-visible:ring-primary"), "aria-label": "Close panel", children: _jsx(X, { className: "size-5 text-muted-foreground" }) })] })] }) }), _jsxs("div", { className: "relative flex-1 overflow-y-auto", ref: contentRef, "data-testid": "tool-panel-content", children: [_jsx(PanelContentRenderer, { content: content }), _jsx(SelectionPopover, { containerRef: contentRef })] })] }));
 }

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { ToolPanel } from "./components/tool-panel.js";
 export { ToolPanelLayout } from "./components/tool-panel-layout.js";
 export { MarkdownText, markdownComponents } from "./components/markdown-text.js";
 export { ClientToolExecutor } from "./components/client-tool-executor.js";
-export { AGUIRuntimeProvider, useAGUIAdapter } from "./components/ag-ui-runtime-provider.js";
+export { AGUIRuntimeProvider, useAGUIAdapter, useIsForegroundChat, } from "./components/ag-ui-runtime-provider.js";
 export type { AGUIChatConversationFactoryArgs, AGUIHistoryAdapterFactory, } from "./components/ag-ui-runtime-provider.js";
 export { ChatContent, DEFAULT_STARTER_SUGGESTIONS, DEFAULT_COMPOSER_PLACEHOLDER, } from "./components/assistant-chat.js";
 export { ComposerAddMenu, type ComposerAddMenuProps } from "./components/composer-add-menu.js";
@@ -19,8 +19,8 @@ export type { ToolCallStatus, ToolCallCardProps } from "./components/tool-call-c
 export { ToolFallback } from "./components/tool-fallback.js";
 export { ConfirmationCard } from "./components/confirmation-card.js";
 export { TooltipIconButton } from "./components/tooltip-icon-button.js";
-export { ComposerContextBadges, SentContextBadges } from "./components/context-badges.js";
-export { ContextPins, usePagePin } from "./components/context-bar.js";
+export { SentContextBadges } from "./components/context-badges.js";
+export { usePagePin } from "./components/context-bar.js";
 export { SelectionPopover } from "./components/selection-popover.js";
 export { GlobalSelectionPopover } from "./components/global-selection-popover.js";
 export { LoadingIndicator } from "./components/loading-indicator.js";
@@ -76,8 +76,8 @@ export { submitComposerText } from "./lib/composer-submit-store.js";
 export { registerSelectionContextResolver, resolveSelectionContext, type SelectionContextInput, type SelectionContextItem, type SelectionContextResolver, type SelectionContextResult, } from "./lib/selection-context.js";
 export { useThemeStore } from "./lib/theme-store.js";
 export type { ThemeMode } from "./lib/theme-store.js";
-export { mergeThemeDefinitions, resolveThemeRuntime, getEffectiveThemeMode, getThemePreset, } from "./lib/theme-runtime.js";
-export type { ThemeDefinition, ThemeLayer, ResolvedThemeRuntime, ThemeColorSlots, ThemeSidebarSlots, ThemeStatusSlots, ThemeChartSlots, ThemeTypographySlots, ThemeRadiusSlots, ThemeAppSlots, ThemeBranding, } from "./lib/theme-runtime.js";
+export { THEME_SLOTS, mergeThemeDefinitions, resolveThemeRuntime, getEffectiveThemeMode, getThemePreset, } from "./lib/theme-runtime.js";
+export type { ThemeSlot, ThemeDefinition, ThemeLayer, ResolvedThemeRuntime, ThemeColorSlots, ThemeSidebarSlots, ThemeStatusSlots, ThemeChartSlots, ThemeTypographySlots, ThemeRadiusSlots, ThemeAppSlots, ThemeBranding, } from "./lib/theme-runtime.js";
 export { useDevStore } from "./lib/dev-store.js";
 export { DEFAULT_NAV_CONFIG, findNavItem } from "./lib/nav-config.js";
 export type { NavItem, NavItemAction, NavItemDnd, NavGroup, NavGroupCreateAction, NavMatch, CollapsedRailItem, CollapsedRailContext, } from "./lib/nav-config.js";
@@ -91,3 +91,4 @@ export { ReasoningPart, ReasoningMessagePartComponent } from "./components/reaso
 export { ReasoningEffortPicker } from "./components/reasoning-effort-picker.js";
 export { AuthProvider } from "./lib/auth-provider.js";
 export { createUiId } from "./lib/create-ui-id.js";
+export { useChatRuns, isChatRunActive, removeChatRun, type ChatRun, } from "./lib/chat-runs-store.js";

package/dist/index.js

@@ -5,7 +5,7 @@ export { ToolPanel } from "./components/tool-panel.js";
 export { ToolPanelLayout } from "./components/tool-panel-layout.js";
 export { MarkdownText, markdownComponents } from "./components/markdown-text.js";
 export { ClientToolExecutor } from "./components/client-tool-executor.js";
-export { AGUIRuntimeProvider, useAGUIAdapter } from "./components/ag-ui-runtime-provider.js";
+export { AGUIRuntimeProvider, useAGUIAdapter, useIsForegroundChat, } from "./components/ag-ui-runtime-provider.js";
 export { ChatContent, DEFAULT_STARTER_SUGGESTIONS, DEFAULT_COMPOSER_PLACEHOLDER, } from "./components/assistant-chat.js";
 export { ComposerAddMenu } from "./components/composer-add-menu.js";
 export { ChatBubble } from "./components/chat-bubble.js";
@@ -17,8 +17,8 @@ export { ToolCallCard } from "./components/tool-call-card.js";
 export { ToolFallback } from "./components/tool-fallback.js";
 export { ConfirmationCard } from "./components/confirmation-card.js";
 export { TooltipIconButton } from "./components/tooltip-icon-button.js";
-export { ComposerContextBadges, SentContextBadges } from "./components/context-badges.js";
-export { ContextPins, usePagePin } from "./components/context-bar.js";
+export { SentContextBadges } from "./components/context-badges.js";
+export { usePagePin } from "./components/context-bar.js";
 export { SelectionPopover } from "./components/selection-popover.js";
 export { GlobalSelectionPopover } from "./components/global-selection-popover.js";
 export { LoadingIndicator } from "./components/loading-indicator.js";
@@ -79,7 +79,7 @@ export { useChatLifecycleStore } from "./lib/chat-lifecycle-store.js";
 export { submitComposerText } from "./lib/composer-submit-store.js";
 export { registerSelectionContextResolver, resolveSelectionContext, } from "./lib/selection-context.js";
 export { useThemeStore } from "./lib/theme-store.js";
-export { mergeThemeDefinitions, resolveThemeRuntime, getEffectiveThemeMode, getThemePreset, } from "./lib/theme-runtime.js";
+export { THEME_SLOTS, mergeThemeDefinitions, resolveThemeRuntime, getEffectiveThemeMode, getThemePreset, } from "./lib/theme-runtime.js";
 // Stores moved to @iloveagents/foundry-agent (#95): authStore, citationStore,
 // streamingStatusStore, clientToolRegistry. Consumers import directly from
 // `@iloveagents/foundry-agent` / `@iloveagents/foundry-agent/msal` — no re-exports here per
@@ -106,3 +106,4 @@ export { AuthProvider } from "./lib/auth-provider.js";
 // Re-exporting here would create two canonical sources for the same
 // utility — banned per the "no shims" pre-1.0 rule (#90).
 export { createUiId } from "./lib/create-ui-id.js";
+export { useChatRuns, isChatRunActive, removeChatRun, } from "./lib/chat-runs-store.js";

package/dist/lib/ag-ui-adapter.d.ts

@@ -19,9 +19,12 @@
 import type { ChatModelAdapter, ChatModelRunOptions, ChatModelRunResult } from "@assistant-ui/react";
 export declare class AGUIAdapterSDK implements ChatModelAdapter {
     private readonly runner;
+    private previousAppState?;
+    private readonly conversationUrl?;
     constructor(url?: string, options?: {
         threadId?: string;
         fetchFn?: typeof fetch;
+        conversationUrl?: string;
     });
     get threadId(): string;
     get state(): unknown;

package/dist/lib/ag-ui-adapter.js

@@ -16,12 +16,15 @@
  * @see https://docs.ag-ui.com/sdk/js/client/http-agent
  * @see https://www.assistant-ui.com/docs/runtimes/custom/local
  */
-import { AGUIRunner, agentStateStore, clientToolRegistry, streamingStatusStore, } from "@iloveagents/foundry-agent";
+import { mergeChatState } from "./merge-chat-state.js";
+import { AGUIRunner, clientToolRegistry } from "@iloveagents/foundry-agent";
 import { tokenFetch } from "@iloveagents/foundry-agent/msal";
 import { useAppStore } from "./app-store.js";
 import { useDevStore } from "./dev-store.js";
+import { publishChatAgentState, beginChatRun, touchChatRun, updateChatRun, getChatStateSnapshot, useChatRuns, retainChatProjection, waitForForegroundChat, } from "./chat-runs-store.js";
 export class AGUIAdapterSDK {
     constructor(url = "/api/agent", options) {
+        this.conversationUrl = options?.conversationUrl;
         this.runner = new AGUIRunner({
             url,
             threadId: options?.threadId,
@@ -35,11 +38,22 @@ export class AGUIAdapterSDK {
         return this.runner.state;
     }
     async *run({ messages, abortSignal }) {
+        if (useChatRuns.getState().deletedThreads[this.threadId]) {
+            throw new Error("This conversation was deleted. Start a new chat to continue.");
+        }
         const aguiMessages = convertMessagesToAGUI(messages);
         // App-level lifecycle: mark thread active, snapshot context, consume
         // ephemeral context off the last user message.
         useAppStore.getState().markThreadActive();
         const appState = useAppStore.getState().getAgentState();
+        const projection = appState;
+        const retained = getChatStateSnapshot(this.threadId);
+        const serverState = retained.state ?? this.runner.state;
+        const requestState = mergeChatState(serverState && typeof serverState === "object"
+            ? serverState
+            : {}, this.previousAppState ?? retained.projection, projection);
+        this.previousAppState = structuredClone(projection);
+        retainChatProjection(this.threadId, projection);
         const context = buildAGUIContext(appState);
         const lastUserMsg = [...messages].reverse().find((m) => m.role === "user");
         if (lastUserMsg) {
@@ -55,7 +69,25 @@ export class AGUIAdapterSDK {
         // Liveness clock for the working indicator: every runner event (incl.
         // server heartbeats) proves the run is alive; the indicator derives
         // elapsed time from runStartedAt and staleness from lastSignalAt.
-        streamingStatusStore.getState().markRunStarted();
+        const stopController = new AbortController();
+        const runSignal = AbortSignal.any([abortSignal, stopController.signal]);
+        beginChatRun({
+            threadId: this.threadId,
+            conversationUrl: this.conversationUrl,
+            title: lastUserMsg?.content
+                .filter((p) => p.type === "text")
+                .map((p) => p.text)
+                .join(" ")
+                .slice(0, 120) || "Conversation",
+            pageLabel: useAppStore.getState().navContext.label ?? undefined,
+            contextMeta: { ...useAppStore.getState().navContext.meta },
+            stop: () => stopController.abort(),
+        });
+        const registry = clientToolRegistry.getState();
+        const pageOwners = new Map(registry.listPageTools().map((tool) => [tool.name, tool]));
+        const ownerLocation = typeof window === "undefined" ? "" : window.location.href;
+        const schemas = registry.getActiveSchemas();
+        const advertised = new Set(schemas.map((tool) => tool.name));
         /**
          * Build a `ChatModelRunResult` from the accumulated state.
          *
@@ -110,13 +142,35 @@ export class AGUIAdapterSDK {
         try {
             for await (const event of this.runner.run({
                 messages: aguiMessages,
-                state: appState,
+                state: requestState,
                 context,
-                registry: clientToolRegistry.getState(),
-                abortSignal,
+                registry: {
+                    ...registry,
+                    getActiveSchemas: () => schemas,
+                    isRegistered: (name) => advertised.has(name),
+                    executeTool: async (name, args) => {
+                        await waitForForegroundChat(this.threadId, runSignal);
+                        runSignal.throwIfAborted();
+                        const owner = pageOwners.get(name);
+                        if (owner) {
+                            const current = clientToolRegistry
+                                .getState()
+                                .listPageTools()
+                                .find((tool) => tool.name === name);
+                            if (current !== owner ||
+                                (typeof window !== "undefined" && window.location.href !== ownerLocation)) {
+                                return JSON.stringify({
+                                    error: "The page changed since this action was requested. Open the original page and request the action again.",
+                                });
+                            }
+                        }
+                        return clientToolRegistry.getState().executeTool(name, args);
+                    },
+                },
+                abortSignal: runSignal,
             })) {
                 let shouldYield = false;
-                streamingStatusStore.getState().touchSignal();
+                touchChatRun(this.threadId);
                 switch (event.type) {
                     case "heartbeat":
                         // Server liveness ping — already recorded via touchSignal above.
@@ -146,7 +200,7 @@ export class AGUIAdapterSDK {
                         shouldYield = true;
                         break;
                     case "streaming-status":
-                        streamingStatusStore.getState().setStreamingStatus(event.status);
+                        touchChatRun(this.threadId, event.status);
                         break;
                     case "text-delta":
                         currentText += event.delta;
@@ -162,7 +216,7 @@ export class AGUIAdapterSDK {
                     case "agent-state":
                         // Publish server state so pages can react to it. Not a chat
                         // message, so no yield.
-                        agentStateStore.getState().setAgentState(event.state, event.patch);
+                        publishChatAgentState(this.threadId, event.state, event.patch);
                         break;
                     case "messages-snapshot":
                     case "activity":
@@ -256,7 +310,10 @@ export class AGUIAdapterSDK {
             // not a silent empty bubble. We yield the terminal status rather
             // than throwing; an unhandled throw re-introduces the stuck-running
             // bug (the runner generator has already returned here).
-            if (runError !== null) {
+            if (runSignal.aborted) {
+                yield buildResult({ type: "incomplete", reason: "cancelled" });
+            }
+            else if (runError !== null) {
                 yield buildResult({
                     type: "incomplete",
                     reason: "error",
@@ -267,9 +324,16 @@ export class AGUIAdapterSDK {
                 yield buildResult({ type: "complete", reason: "stop" });
             }
         }
+        catch (error) {
+            if (runSignal.aborted)
+                yield buildResult({ type: "incomplete", reason: "cancelled" });
+            else {
+                runError = error instanceof Error ? error.message : String(error);
+                throw error;
+            }
+        }
         finally {
-            streamingStatusStore.getState().setStreamingStatus({ status: "idle" });
-            streamingStatusStore.getState().markRunEnded();
+            updateChatRun(this.threadId, runSignal.aborted ? "cancelled" : runError !== null ? "failed" : "completed", runError ?? undefined);
         }
     }
 }

package/dist/lib/auth-provider.js

@@ -42,7 +42,7 @@ export const AuthProvider = ({ config, children }) => {
     if (!ready)
         return null;
     if (initError) {
-        return (_jsx("div", { className: "flex min-h-dvh items-center justify-center bg-background px-6 text-center", children: _jsxs("div", { className: "max-w-md rounded-2xl border border-border bg-card px-6 py-5 shadow-sm", children: [_jsx("h1", { className: "text-lg font-semibold text-foreground", children: "Authentication unavailable" }), _jsx("p", { className: "mt-2 text-sm text-muted-foreground", children: initError })] }) }));
+        return (_jsx("div", { className: "flex min-h-dvh items-center justify-center bg-background px-6 text-center", children: _jsxs("div", { className: "max-w-md rounded-2xl border border-border bg-card px-6 py-5 shadow-sm", children: [_jsx("h1", { className: "text-lg font-semibold text-heading", children: "Authentication unavailable" }), _jsx("p", { className: "mt-2 text-sm text-muted-foreground", children: initError })] }) }));
     }
     if (!MsalProvider || !useMsalHook) {
         return null;

package/dist/lib/chat-runs-store.d.ts

@@ -0,0 +1,40 @@
+import { type StreamingStatus } from "@iloveagents/foundry-agent";
+export type ChatRunStatus = "running" | "waiting" | "completed" | "failed" | "cancelled";
+export interface ChatRun {
+    threadId: string;
+    conversationUrl?: string;
+    title: string;
+    pageLabel?: string;
+    /** Navigation snapshot at run start, interpreted by the owning feature module. */
+    contextMeta?: Record<string, unknown>;
+    status: ChatRunStatus;
+    startedAt: number;
+    finishedAt?: number;
+    error?: string;
+    stop: () => void;
+}
+export declare const isChatRunActive: (run: ChatRun) => boolean;
+/** Browser-session activity. Message persistence remains owned by the history adapter. */
+export declare const useChatRuns: import("zustand").UseBoundStore<import("zustand").StoreApi<{
+    foregroundId: string | null;
+    runs: Record<string, ChatRun>;
+    deletedThreads: Record<string, true>;
+}>>;
+export declare function getChatStateSnapshot(threadId: string): {
+    state: unknown;
+    projection: Record<string, unknown> | undefined;
+};
+export declare function retainChatProjection(threadId: string, projection: Record<string, unknown>): void;
+export declare function publishChatAgentState(threadId: string, state: unknown, patch?: unknown[]): void;
+export declare function isForegroundChat(threadId: string): boolean;
+export declare function selectChatRun(threadId: string): void;
+/** Call after a successful conversation deletion so session activity cannot restore it. */
+export declare function removeChatRun(threadId: string): void;
+export declare function beginChatRun(run: Omit<ChatRun, "status" | "startedAt">): void;
+export declare function touchChatRun(threadId: string, status?: StreamingStatus): void;
+export declare function updateChatRun(threadId: string, status: ChatRunStatus, error?: string): void;
+/** Browser tools need the conversation in front, so they cannot act on another chat's page. */
+export declare function waitForForegroundChat(threadId: string, signal: AbortSignal): Promise<void>;
+export declare function warnBeforeChatUnload(event: BeforeUnloadEvent): void;
+/** Dispose browser-owned runs when the authenticated runtime is torn down. */
+export declare function disposeChatRuns(): void;