@iloveagents/foundry-web-ui 0.29.1 → 0.30.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/sidebar.js

@@ -506,10 +506,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 +544,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 +646,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);
@@ -693,7 +716,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
@@ -953,7 +981,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 +1024,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 +1079,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/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";
@@ -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";
@@ -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/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;