@nomix-ai/nomix-harness 0.2.5 → 0.2.6

package/dist/kernel/client-ui-subagent/lib/types/client/SubagentHeaderLineage.d.ts

@@ -0,0 +1,18 @@
+import { type SessionId, type SubagentAddress } from '../../../../client-runtime/lib/client.js';
+import type { PropsLocale, PropsRuntime } from '../../../../client-ui-slots/lib/index.js';
+import { NS } from './locales.ts';
+/** Business actions supplied by the slot registration. */
+export interface SubagentCatalogInjected {
+    openChild: (address: SubagentAddress) => void;
+    refresh: (parentSessionId: SessionId) => void;
+    setCatalogOpen: (parentSessionId: SessionId, open: boolean) => void;
+}
+/** Full props for the session-header lineage renderer. */
+export type SubagentHeaderLineageProps = PropsRuntime<'conversation.session.header.lineage'> & SubagentCatalogInjected & PropsLocale<typeof NS>;
+/**
+ * Render one breadcrumb title together with its subagent navigation.
+ * @param props - Breadcrumb title, session standard props, and catalog actions.
+ * @returns An ordinary-title descendant count, or a title-and-chevron sibling switcher.
+ */
+export declare function SubagentHeaderLineage({ lineageSessionId, displayTitle, openTitle, useSessions, openChild, refresh, setCatalogOpen, t, }: SubagentHeaderLineageProps): import("react").JSX.Element;
+//# sourceMappingURL=SubagentHeaderLineage.d.ts.map

package/dist/kernel/client-ui-subagent/lib/types/client/{SubagentCatalogAction.js → SubagentHeaderLineage.js}

@@ -1,8 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useEffect, useMemo, useRef, useState, } from 'react';
+import { createPortal } from 'react-dom';
 import { indexSubagentDescendants, } from '../../../../client-runtime/lib/client.js';
 import { IconChevronDownOutline14, IconChevronRightOutline14, IconRefreshOutline14, StateDot, } from '../../../../client-ui-primitives/lib/index.js';
-import css from './SubagentCatalogAction.module.css';
+import css from './SubagentHeaderLineage.module.css';
 function diagnosticReason(entry, t) {
     switch (entry.reason) {
         case 'corrupt': return t('diagnostic.corrupt');
@@ -110,6 +111,9 @@ function formatExactDuration(ms, t) {
         });
 }
 const NO_DESCENDANTS = { count: 0, runningCount: 0 };
+function SubagentSwitcherIcon() {
+    return (_jsxs("svg", { width: "16", height: "16", viewBox: "0 0 20 20", fill: "none", "aria-hidden": "true", children: [_jsx("path", { d: "M5.99951 12.7L8.95546 14.9478C9.40011 15.2859 9.62244 15.455 9.87526 15.488C9.95774 15.4988 10.0413 15.4988 10.1238 15.488C10.3766 15.455 10.5989 15.2859 11.0436 14.9478L13.9995 12.7", stroke: "currentColor", strokeWidth: "1.5" }), _jsx("path", { d: "M13.9995 7.7417L11.0436 5.49387C10.5989 5.15574 10.3766 4.98668 10.1238 4.95362C10.0413 4.94283 9.95775 4.94283 9.87527 4.95362C9.62245 4.98668 9.40012 5.15574 8.95547 5.49387L5.99952 7.7417", stroke: "currentColor", strokeWidth: "1.5" })] }));
+}
 /** Render the known direct-child shape while its authoritative catalog hydrates. */
 function CatalogLoadingRows({ parentSessionId, summaries, level, t, }) {
     const children = Object.values(summaries).filter(summary => (summary.origin === 'subagent' && summary.parentId === parentSessionId));
@@ -118,7 +122,7 @@ function CatalogLoadingRows({ parentSessionId, summaries, level, t, }) {
     return children.map(summary => (_jsx("div", { className: css.node, children: _jsxs("div", { role: "treeitem", "aria-disabled": "true", "aria-level": level, "aria-label": t('loading.aria'), className: `${css.row} ${css.disabled} ${css.loadingRow}`, children: [_jsx("span", { className: css.disclosureSpace }), _jsx(StateDot, { state: summary.running ? 'ongoing' : 'done' }), _jsx("span", { className: css.content, children: _jsx("span", { className: css.label, children: t('loading.label') }) })] }) }, summary.id)));
 }
 /** Render one catalog level and recurse only through explicitly expanded rows. */
-function CatalogRows({ parentSessionId, catalog, catalogs, summaries, expanded, level, now, openChild, refresh, toggleBranch, closeCatalog, t, }) {
+function CatalogRows({ parentSessionId, currentSessionId, catalog, catalogs, summaries, expanded, level, now, openChild, refresh, toggleBranch, closeCatalog, t, }) {
     const emptyLoading = catalog.state === 'loading' && catalog.entries.length === 0;
     const reserveDisclosure = catalog.entries.some(entry => entry.kind === 'child' && entry.hasChildren);
     return (_jsxs(_Fragment, { children: [emptyLoading && (_jsx(CatalogLoadingRows, { parentSessionId: parentSessionId, summaries: summaries, level: level, t: t })), catalog.state === 'error' && (_jsxs("div", { className: css.error, children: [_jsx("span", { children: catalog.error?.message ?? t('load.error') }), _jsxs("button", { type: "button", className: css.refresh, onClick: () => { refresh(parentSessionId); }, children: [_jsx(IconRefreshOutline14, {}), t('retry')] })] })), catalog.entries.map((entry) => {
@@ -127,6 +131,7 @@ function CatalogRows({ parentSessionId, catalog, catalogs, summaries, expanded,
                     return (_jsx("div", { className: css.node, children: _jsxs("div", { role: "treeitem", "aria-disabled": "true", "aria-level": level, "aria-label": `${entry.id} ${reason}`, className: `${css.row} ${css.disabled}`, title: reason, children: [reserveDisclosure && _jsx("span", { className: css.disclosureSpace }), _jsx(StateDot, { state: "error" }), _jsxs("span", { className: css.content, children: [_jsx("span", { className: css.label, children: entry.id }), _jsx("span", { className: css.summary, children: reason })] })] }) }, entry.id));
                 }
                 const childCatalog = catalogs[entry.id];
+                const isCurrent = entry.id === currentSessionId;
                 const isExpanded = expanded.has(entry.id);
                 const knownLeaf = !entry.hasChildren;
                 const childLoading = childCatalog === undefined
@@ -174,32 +179,50 @@ function CatalogRows({ parentSessionId, catalog, catalogs, summaries, expanded,
                     event.stopPropagation();
                     toggleBranch(entry.id);
                 };
-                return (_jsxs("div", { className: css.node, children: [_jsxs("div", { role: "treeitem", tabIndex: 0, "aria-level": level, "aria-label": [label, secondary, metrics].filter(value => value !== '').join(' '), ...knownLeaf ? {} : { 'aria-expanded': isExpanded }, className: css.row, onClick: open, onKeyDown: handleKey, children: [knownLeaf
+                return (_jsxs("div", { className: css.node, children: [_jsxs("div", { role: "treeitem", tabIndex: 0, "aria-level": level, "aria-current": isCurrent || undefined, "aria-label": [label, secondary, metrics].filter(value => value !== '').join(' '), ...knownLeaf ? {} : { 'aria-expanded': isExpanded }, className: css.row, onClick: open, onKeyDown: handleKey, children: [knownLeaf
                                     ? reserveDisclosure && _jsx("span", { className: css.disclosureSpace })
-                                    : (_jsx("button", { type: "button", tabIndex: -1, className: `${css.disclosure} ${isExpanded ? css.disclosureOpen : ''}`, "aria-label": t(isExpanded ? 'branch.collapse' : 'branch.expand', { label }), onClick: toggle, children: _jsx(IconChevronRightOutline14, {}) })), _jsxs("div", { className: css.clickarea, children: [_jsx(StateDot, { state: entry.activity === 'running' ? 'ongoing' : 'done' }), _jsxs("span", { className: css.content, children: [_jsx("span", { className: css.label, children: label }), _jsx("span", { className: css.summary, children: secondary })] }), metrics !== '' && (_jsxs("span", { className: css.metrics, children: [tokenMetric !== undefined && _jsx("span", { className: css.metricToken, children: tokenMetric }), durationMetric !== undefined && (_jsx("span", { className: css.metricDuration, title: t('duration.exactTitle', { duration: durationMetric.exact }), children: durationMetric.compact }))] }))] })] }), isExpanded && !knownLeaf && (_jsx("div", { role: "group", className: css.children, "aria-busy": childLoading || undefined, children: childCatalog === undefined
+                                    : (_jsx("button", { type: "button", tabIndex: -1, className: `${css.disclosure} ${isExpanded ? css.disclosureOpen : ''}`, "aria-label": t(isExpanded ? 'branch.collapse' : 'branch.expand', { label }), onClick: toggle, children: _jsx(IconChevronRightOutline14, {}) })), _jsxs("div", { className: css.clickarea, children: [_jsx(StateDot, { state: entry.activity === 'running' ? 'ongoing' : 'done' }), _jsxs("span", { className: css.content, children: [_jsx("span", { className: `${css.label} ${isCurrent ? css.currentLabel : ''}`, children: label }), _jsx("span", { className: css.summary, children: secondary })] }), metrics !== '' && (_jsxs("span", { className: css.metrics, children: [tokenMetric !== undefined && _jsx("span", { className: css.metricToken, children: tokenMetric }), durationMetric !== undefined && (_jsx("span", { className: css.metricDuration, title: t('duration.exactTitle', { duration: durationMetric.exact }), children: durationMetric.compact }))] }))] })] }), isExpanded && !knownLeaf && (_jsx("div", { role: "group", className: css.children, "aria-busy": childLoading || undefined, children: childCatalog === undefined
                                 ? (_jsx(CatalogLoadingRows, { parentSessionId: entry.id, summaries: summaries, level: level + 1, t: t }))
-                                : (_jsx(CatalogRows, { parentSessionId: entry.id, catalog: childCatalog, catalogs: catalogs, summaries: summaries, expanded: expanded, level: level + 1, now: now, openChild: openChild, refresh: refresh, toggleBranch: toggleBranch, closeCatalog: closeCatalog, t: t })) }))] }, entry.id));
+                                : (_jsx(CatalogRows, { parentSessionId: entry.id, currentSessionId: currentSessionId, catalog: childCatalog, catalogs: catalogs, summaries: summaries, expanded: expanded, level: level + 1, now: now, openChild: openChild, refresh: refresh, toggleBranch: toggleBranch, closeCatalog: closeCatalog, t: t })) }))] }, entry.id));
             })] }));
 }
-/**
- * Render the current session's direct catalog and lazily expanded descendants.
- * @param props - session standard props plus catalog navigation actions.
- * @returns The action while the catalog is pending or summaries establish descendants.
- */
-export function SubagentCatalogAction({ sessionId, useSessions, openChild, refresh, setCatalogOpen, t, }) {
+const MENU_VIEWPORT_MARGIN = 16;
+/** Place a portaled catalog below its trigger without crossing the viewport edge. */
+function catalogMenuPosition(trigger) {
+    const rect = trigger.getBoundingClientRect();
+    const width = Math.min(336, window.innerWidth - MENU_VIEWPORT_MARGIN * 2);
+    return {
+        top: rect.bottom + 5,
+        left: Math.min(Math.max(MENU_VIEWPORT_MARGIN, rect.left), window.innerWidth - width - MENU_VIEWPORT_MARGIN),
+    };
+}
+/** One trigger-plus-tree dropdown over the catalog rooted at `rootSessionId`. */
+function CatalogDropdown({ rootSessionId, currentSessionId, displayTitle, openTitle, variant, separator = false, useSessions, openChild, refresh, setCatalogOpen, t, }) {
+    const ancestorSwitcher = variant === 'switcher' && openTitle !== undefined;
     const catalogs = useSessions(state => state.subagentsByParent);
     const summaries = useSessions(state => state.byId);
-    const catalog = catalogs[sessionId];
+    const catalog = catalogs[rootSessionId];
     const [open, setOpen] = useState(false);
+    const [menuPosition, setMenuPosition] = useState();
     const [now, setNow] = useState(() => Date.now());
     const [expanded, setExpanded] = useState(() => new Set());
     const rootRef = useRef(null);
     const triggerRef = useRef(null);
+    const menuRef = useRef(null);
+    const hoverOpenTimer = useRef(undefined);
+    const hoverCloseTimer = useRef(undefined);
     const observedCatalogs = useRef(new Set());
+    const requestedInitialCatalog = useRef();
     const setCatalogOpenRef = useRef(setCatalogOpen);
     setCatalogOpenRef.current = setCatalogOpen;
+    const currentEntry = currentSessionId === undefined
+        ? undefined
+        : catalog?.entries.find(entry => entry.kind === 'child' && entry.id === currentSessionId);
+    const switcherDisplayTitle = currentEntry?.kind === 'child'
+        ? currentEntry.label ?? currentEntry.id
+        : displayTitle;
     const healthy = catalog?.entries.filter(entry => entry.kind === 'child') ?? [];
-    const descendants = useMemo(() => indexSubagentDescendants(summaries).get(sessionId) ?? NO_DESCENDANTS, [sessionId, summaries]);
+    const descendants = useMemo(() => indexSubagentDescendants(summaries).get(rootSessionId) ?? NO_DESCENDANTS, [rootSessionId, summaries]);
     // The catalog can arrive before the session-list baseline; never undercount
     // the already-visible direct rows during that short bootstrap window.
     const descendantCount = Math.max(healthy.length, descendants.count);
@@ -207,7 +230,7 @@ export function SubagentCatalogAction({ sessionId, useSessions, openChild, refre
     const runningCountKey = descendants.runningCount === 1 ? 'count.running.one' : 'count.running.other';
     // Session summaries can announce membership before the descriptor-backed catalog catches up.
     // Keep that entry point visible through disabled loading rows; only catalog rows are navigable.
-    const summaryBackedLoading = descendants.count > 0
+    const summaryBackedLoading = (descendants.count > 0 || variant === 'switcher')
         && (catalog === undefined || (catalog.state === 'ready' && catalog.entries.length === 0));
     const presentedCatalog = summaryBackedLoading
         ? {
@@ -217,6 +240,14 @@ export function SubagentCatalogAction({ sessionId, useSessions, openChild, refre
             error: null,
         }
         : catalog;
+    useEffect(() => {
+        if (variant !== 'switcher'
+            || catalog !== undefined
+            || requestedInitialCatalog.current === rootSessionId)
+            return;
+        requestedInitialCatalog.current = rootSessionId;
+        refresh(rootSessionId);
+    }, [catalog, refresh, rootSessionId, variant]);
     const observeCatalog = (parentSessionId, next) => {
         if (next)
             observedCatalogs.current.add(parentSessionId);
@@ -231,17 +262,57 @@ export function SubagentCatalogAction({ sessionId, useSessions, openChild, refre
         observedCatalogs.current.clear();
         setExpanded(new Set());
     };
+    const cancelHoverClose = () => {
+        if (hoverCloseTimer.current === undefined)
+            return;
+        clearTimeout(hoverCloseTimer.current);
+        hoverCloseTimer.current = undefined;
+    };
+    const cancelHoverOpen = () => {
+        if (hoverOpenTimer.current === undefined)
+            return;
+        clearTimeout(hoverOpenTimer.current);
+        hoverOpenTimer.current = undefined;
+    };
     const changeOpen = (next, restoreFocus = false) => {
-        setOpen(next);
+        cancelHoverOpen();
+        cancelHoverClose();
         if (next) {
+            const trigger = triggerRef.current;
+            /* v8 ignore next -- a queued callback can outlive the trigger */
+            if (trigger === null)
+                return;
+            setOpen(true);
+            setMenuPosition(catalogMenuPosition(trigger));
             setNow(Date.now());
-            observeCatalog(sessionId, true);
+            observeCatalog(rootSessionId, true);
         }
-        else
+        else {
+            setOpen(false);
+            setMenuPosition(undefined);
             closeAllCatalogs();
+        }
         if (restoreFocus)
             queueMicrotask(() => { triggerRef.current?.focus(); });
     };
+    const scheduleHoverOpen = () => {
+        cancelHoverOpen();
+        cancelHoverClose();
+        if (open)
+            return;
+        hoverOpenTimer.current = setTimeout(() => {
+            hoverOpenTimer.current = undefined;
+            changeOpen(true);
+        }, 150);
+    };
+    const scheduleHoverClose = () => {
+        cancelHoverOpen();
+        cancelHoverClose();
+        hoverCloseTimer.current = setTimeout(() => {
+            hoverCloseTimer.current = undefined;
+            changeOpen(false);
+        }, 120);
+    };
     const closeBranch = (root) => {
         const closing = new Set();
         const visit = (parentSessionId) => {
@@ -271,13 +342,32 @@ export function SubagentCatalogAction({ sessionId, useSessions, openChild, refre
         if (!open)
             return;
         const closeOutside = (event) => {
-            if (event.target instanceof Node && !rootRef.current?.contains(event.target)) {
+            if (event.target instanceof Node
+                && !rootRef.current?.contains(event.target)
+                && !menuRef.current?.contains(event.target)) {
                 changeOpen(false);
             }
         };
         document.addEventListener('pointerdown', closeOutside);
         return () => { document.removeEventListener('pointerdown', closeOutside); };
     }, [open]);
+    useEffect(() => {
+        if (!open)
+            return;
+        const placeMenu = () => {
+            const trigger = triggerRef.current;
+            /* v8 ignore next -- native resize or scroll can outlive the trigger */
+            if (trigger === null)
+                return;
+            setMenuPosition(catalogMenuPosition(trigger));
+        };
+        window.addEventListener('resize', placeMenu);
+        document.addEventListener('scroll', placeMenu, true);
+        return () => {
+            window.removeEventListener('resize', placeMenu);
+            document.removeEventListener('scroll', placeMenu, true);
+        };
+    }, [open]);
     useEffect(() => {
         if (!open || descendants.runningCount === 0)
             return;
@@ -285,6 +375,8 @@ export function SubagentCatalogAction({ sessionId, useSessions, openChild, refre
         return () => { clearInterval(timer); };
     }, [open, descendants.runningCount]);
     useEffect(() => () => {
+        cancelHoverOpen();
+        cancelHoverClose();
         for (const parentSessionId of observedCatalogs.current) {
             setCatalogOpenRef.current(parentSessionId, false);
         }
@@ -295,11 +387,16 @@ export function SubagentCatalogAction({ sessionId, useSessions, openChild, refre
     // selecting any session schedules a refresh whose loading snapshot would
     // otherwise flash the action in and out on childless sessions.
     const visible = presentedCatalog !== undefined
-        && (presentedCatalog.state === 'error'
+        && (variant === 'switcher'
+            || presentedCatalog.state === 'error'
             || presentedCatalog.entries.length > 0
             || descendantCount > 0);
     useEffect(() => {
-        if (visible || !open)
+        if (visible)
+            return;
+        cancelHoverOpen();
+        cancelHoverClose();
+        if (!open)
             return;
         setOpen(false);
         closeAllCatalogs();
@@ -307,13 +404,13 @@ export function SubagentCatalogAction({ sessionId, useSessions, openChild, refre
     if (!visible)
         return null;
     const focusAt = (index) => {
-        const items = treeItems(rootRef.current);
+        const items = treeItems(menuRef.current);
         if (items.length === 0)
             return;
         items[(index + items.length) % items.length]?.focus();
     };
     const navigate = (event) => {
-        const items = treeItems(rootRef.current);
+        const items = treeItems(menuRef.current);
         const index = items.indexOf(document.activeElement);
         if (event.key === 'Escape') {
             event.preventDefault();
@@ -336,13 +433,44 @@ export function SubagentCatalogAction({ sessionId, useSessions, openChild, refre
             focusAt(index < 0 ? items.length - 1 : index - 1);
         }
     };
-    return (_jsxs("div", { className: css.root, ref: rootRef, onKeyDown: navigate, children: [_jsxs("button", { ref: triggerRef, type: "button", className: css.trigger, "aria-haspopup": "tree", "aria-expanded": open, "aria-label": t(descendants.runningCount > 0 ? runningCountKey : totalCountKey, { count: descendants.runningCount > 0 ? descendants.runningCount : descendantCount }), onClick: () => { changeOpen(!open); }, onKeyDown: (event) => {
+    return (_jsxs("div", { className: `${css.root} ${variant === 'switcher' ? css.switcherRoot : ''}`, ref: rootRef, onKeyDown: navigate, onMouseEnter: scheduleHoverOpen, onMouseLeave: scheduleHoverClose, children: [separator && _jsx("span", { className: css.separator, children: "/" }), _jsxs("button", { ref: triggerRef, type: "button", className: variant === 'switcher'
+                    ? `${css.switcherTrigger} ${ancestorSwitcher ? css.ancestorSwitcherTrigger : ''}`
+                    : css.trigger, "aria-haspopup": "tree", "aria-expanded": open, "aria-label": variant === 'switcher'
+                    ? t('switcher.aria', { title: switcherDisplayTitle })
+                    : t(descendants.runningCount > 0 ? runningCountKey : totalCountKey, { count: descendants.runningCount > 0 ? descendants.runningCount : descendantCount }), onClick: openTitle === undefined
+                    ? undefined
+                    : () => {
+                        cancelHoverOpen();
+                        if (open)
+                            changeOpen(false);
+                        openTitle();
+                    }, onKeyDown: (event) => {
                     if (event.key !== 'ArrowDown')
                         return;
                     event.preventDefault();
                     if (!open)
                         changeOpen(true);
                     queueMicrotask(() => { focusAt(0); });
-                }, children: [_jsx("span", { className: css.activitySlot, children: descendants.runningCount > 0 && _jsx(StateDot, { state: "ongoing" }) }), _jsx("span", { className: css.count, children: t(totalCountKey, { count: descendantCount }) }), _jsx(IconChevronDownOutline14, { className: open ? css.triggerOpen : undefined })] }), open && (_jsx("div", { className: css.menu, role: "tree", "aria-label": t('tree.aria'), children: _jsx(CatalogRows, { parentSessionId: sessionId, catalog: presentedCatalog, catalogs: catalogs, summaries: summaries, expanded: expanded, level: 1, now: now, openChild: openChild, refresh: refresh, toggleBranch: toggleBranch, closeCatalog: () => { changeOpen(false); }, t: t }) }))] }));
+                }, children: [variant === 'switcher'
+                        ? _jsx("span", { className: css.switcherTitle, children: switcherDisplayTitle })
+                        : (_jsxs(_Fragment, { children: [descendants.runningCount > 0 && (_jsx("span", { className: css.activitySlot, children: _jsx(StateDot, { state: "ongoing" }) })), _jsx("span", { className: css.count, children: t(totalCountKey, { count: descendantCount }) })] })), variant === 'switcher'
+                        ? _jsx(SubagentSwitcherIcon, {})
+                        : _jsx(IconChevronDownOutline14, { className: open ? css.triggerOpen : undefined })] }), open && createPortal((_jsx("div", { ref: menuRef, className: css.menu, style: menuPosition, role: "tree", "aria-label": t('tree.aria'), onMouseEnter: cancelHoverClose, onMouseLeave: scheduleHoverClose, children: _jsx(CatalogRows, { parentSessionId: rootSessionId, currentSessionId: currentSessionId, catalog: presentedCatalog, catalogs: catalogs, summaries: summaries, expanded: expanded, level: 1, now: now, openChild: openChild, refresh: refresh, toggleBranch: toggleBranch, closeCatalog: () => { changeOpen(false); }, t: t }) })), document.body)] }));
+}
+/**
+ * Render one breadcrumb title together with its subagent navigation.
+ * @param props - Breadcrumb title, session standard props, and catalog actions.
+ * @returns An ordinary-title descendant count, or a title-and-chevron sibling switcher.
+ */
+export function SubagentHeaderLineage({ lineageSessionId, displayTitle, openTitle, useSessions, openChild, refresh, setCatalogOpen, t, }) {
+    const parentId = useSessions((state) => {
+        const summary = state.byId[lineageSessionId];
+        return summary?.origin === 'subagent' ? summary.parentId : undefined;
+    });
+    const shared = { useSessions, openChild, refresh, setCatalogOpen, t };
+    if (parentId === undefined) {
+        return (_jsx(CatalogDropdown, { rootSessionId: lineageSessionId, variant: "count", separator: true, ...shared }, lineageSessionId));
+    }
+    return (_jsxs(_Fragment, { children: [_jsx(CatalogDropdown, { rootSessionId: parentId, currentSessionId: lineageSessionId, variant: "switcher", displayTitle: displayTitle, ...openTitle === undefined ? {} : { openTitle }, ...shared }, lineageSessionId), openTitle === undefined && (_jsx(CatalogDropdown, { rootSessionId: lineageSessionId, variant: "count", ...shared }, lineageSessionId))] }));
 }
-//# sourceMappingURL=SubagentCatalogAction.js.map
+//# sourceMappingURL=SubagentHeaderLineage.js.map

package/dist/kernel/client-ui-subagent/lib/types/client/index.d.ts

@@ -1,16 +1,4 @@
-/**
- * Subagent reference plugin, browser half: registers the '@' source —
- * candidates filtered from the session list snapshot's running children
- * (zero RPC; the list rides the plugin's root-context sessions service, the
- * scoped session comes from the per-call projection), pick inserts the
- * literal `@label ` text (plain-text-reference decision, see
- * .agents/notes/implemented/architecture/2026-07-25-web-input-machine-and-slash-pipeline.md:
- * the draft carries plain text, chip
- * visuals are derived by scanning against the source lexicon, and the
- * prompt ships the same literal). Consumption semantics stay with future
- * business work. No adjudication hooks: subagent
- * references never enter command adjudication.
- */
+/** Web subagent catalog, navigation, and addressed-session composer owner. */
 import type { ClientContext } from '../../../../client-runtime/lib/client.js';
 import { type SubagentKey } from './locales.ts';
 declare module '@nomix-ai/nomix-client-ui-slots' {
@@ -19,12 +7,12 @@ declare module '@nomix-ai/nomix-client-ui-slots' {
         'subagent': SubagentKey;
     }
 }
-export type { SubagentCatalogActionProps, SubagentCatalogInjected, } from './SubagentCatalogAction.tsx';
+export type { SubagentCatalogInjected, SubagentHeaderLineageProps, } from './SubagentHeaderLineage.tsx';
 export type { SubagentReadOnlyComposerProps, SubagentReadOnlyMatch, } from './SubagentReadOnlyComposer.tsx';
-/** Required services for references, conversation slots, and session navigation. */
+/** Required services for conversation slots and session navigation. */
 export declare const inject: string[];
 /**
- * Client plugin body: register the '@' subagent source over the root session list.
+ * Client plugin body: register the subagent catalog and read-only composer seats.
  * @param ctx - client root context.
  */
 export declare function apply(ctx: ClientContext): void;

package/dist/kernel/client-ui-subagent/lib/types/client/index.js

@@ -1,8 +1,8 @@
-import { SubagentCatalogAction } from "./SubagentCatalogAction.js";
+import { SubagentHeaderLineage } from "./SubagentHeaderLineage.js";
 import { SubagentReadOnlyComposer, } from "./SubagentReadOnlyComposer.js";
 import { en, NS, zh } from "./locales.js";
-/** Required services for references, conversation slots, and session navigation. */
-export const inject = ['inputTriggers', 'sessions', 'slots', 'locale'];
+/** Required services for conversation slots and session navigation. */
+export const inject = ['sessions', 'slots', 'locale'];
 /** Claim the composer for one-shot history or an unavailable continuation owner. */
 function selectReadOnlySubagent(owner) {
     const subagent = owner.session?.subagent;
@@ -18,48 +18,12 @@ function selectReadOnlySubagent(owner) {
     return owner.session?.running === true ? null : { reason: 'parent-unavailable' };
 }
 /**
- * Client plugin body: register the '@' subagent source over the root session list.
+ * Client plugin body: register the subagent catalog and read-only composer seats.
  * @param ctx - client root context.
  */
 export function apply(ctx) {
     ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'ui-subagent: dictionaries');
     const sessions = ctx.sessions;
-    // Child labels live on the session list (parentId lineage + displayTitle),
-    // not the conversation snapshot — the list store is the zero-RPC candidate feed.
-    const childLabels = (session, query) => {
-        const { byId } = sessions.list.getSnapshot();
-        return Object.values(byId)
-            .filter(child => child.parentId === session.sessionId && child.running && child.displayTitle.includes(query))
-            .map(child => child.displayTitle);
-    };
-    const source = {
-        trigger: '@',
-        name: 'subagent',
-        candidates(session, { query }) {
-            return Promise.resolve(childLabels(session, query).map(name => ({ name })));
-        },
-        lexicon(session) {
-            // The list snapshot is always warm — the full running-children roster.
-            return childLabels(session, '');
-        },
-        subscribeLexicon(_session, listener) {
-            // The roll derives from the list snapshot, so its change feed IS the list's.
-            return sessions.list.subscribe(listener);
-        },
-        onPick({ candidate }) {
-            // Plain-text reference: the literal lands in the draft
-            // and ships to the model verbatim (trailing space closes the token).
-            return { text: `@${candidate.name} ` };
-        },
-        codec: {
-            clipboardText: ref => `@${ref}`,
-            // TODO: serialize returns the raw label until the '@' consumption
-            // feature defines a model representation.
-            serialize: ref => Promise.resolve(`@${ref}`),
-        },
-    };
-    const inputTriggers = ctx.get('inputTriggers');
-    ctx.effect(() => inputTriggers.registerSource(source), 'ui-subagent: @ source');
     const catalogActions = (_parentSessionId) => ({
         openChild(address) {
             sessions.openSubagent(address);
@@ -71,13 +35,11 @@ export function apply(ctx) {
             sessions.setSubagentCatalogOpen(parentSessionId, open);
         },
     });
-    ctx.slots.inject('conversation.session.header.actions', () => ctx.slots.register({
-        name: 'conversation.session.header.actions',
-        id: 'subagent-catalog',
-        order: 10,
+    ctx.slots.inject('conversation.session.header.lineage', () => ctx.slots.register({
+        name: 'conversation.session.header.lineage',
         locale: NS,
         inject: catalogActions,
-    }, SubagentCatalogAction));
+    }, SubagentHeaderLineage));
     ctx.slots.inject('conversation.composer', () => ctx.slots.register({
         name: 'conversation.composer',
         priority: -10,

package/dist/kernel/client-ui-subagent/lib/types/client/locales.d.ts

@@ -31,6 +31,7 @@ export declare const zh: {
     readonly 'count.total.other': "{count} 个子代理";
     readonly 'count.running.one': "{count} 个子代理，正在运行";
     readonly 'count.running.other': "{count} 个子代理，正在运行";
+    readonly 'switcher.aria': "切换子代理：{title}";
     readonly 'tree.aria': "子代理会话";
     readonly 'readonly.oneShot.title': "一次性子代理记录";
     readonly 'readonly.title': "此子代理暂时只读";

package/dist/kernel/client-ui-subagent/lib/types/client/locales.js

@@ -31,6 +31,7 @@ export const zh = {
     'count.total.other': '{count} 个子代理',
     'count.running.one': '{count} 个子代理，正在运行',
     'count.running.other': '{count} 个子代理，正在运行',
+    'switcher.aria': '切换子代理：{title}',
     'tree.aria': '子代理会话',
     'readonly.oneShot.title': '一次性子代理记录',
     'readonly.title': '此子代理暂时只读',
@@ -67,6 +68,7 @@ export const en = {
     'count.total.other': '{count} subagents',
     'count.running.one': '{count} subagent running',
     'count.running.other': '{count} subagents running',
+    'switcher.aria': 'Switch subagent: {title}',
     'tree.aria': 'Subagent sessions',
     'readonly.oneShot.title': 'One-shot subagent record',
     'readonly.title': 'This subagent is read-only for now',

package/dist/kernel/client-ui-subagent/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-client-ui-subagent",
   "description": "Subagent conversation catalog, continuation routing UI, and '@' reference source",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },
@@ -46,16 +46,11 @@
     "watch": "tsdown --watch"
   },
   "license": "MIT",
-  "dependencies": {
-    "react": "^18.2.0"
-  },
   "peerDependencies": {
     "@nomix-ai/nomix-client-locale": "workspace:^",
     "@nomix-ai/nomix-client-runtime": "workspace:^",
     "@nomix-ai/nomix-client-ui-conversation": "workspace:^",
-    "@nomix-ai/nomix-client-ui-primitives": "workspace:^",
     "@nomix-ai/nomix-client-ui-input-trigger": "workspace:^",
-    "@nomix-ai/nomix-client-ui-slots": "workspace:^",
     "@nomix-ai/nomix-invariants": "workspace:^",
     "@nomix-ai/nomix-subagent": "workspace:^",
     "@nomix-ai/nomix-token-meter": "workspace:^",
@@ -66,14 +61,17 @@
     "@nomix-ai/nomix-client-runtime": "workspace:^",
     "@nomix-ai/nomix-client-test-runtime": "workspace:^",
     "@nomix-ai/nomix-client-ui-conversation": "workspace:^",
-    "@nomix-ai/nomix-client-ui-primitives": "workspace:^",
     "@nomix-ai/nomix-client-ui-input-trigger": "workspace:^",
+    "@nomix-ai/nomix-client-ui-primitives": "workspace:^",
     "@nomix-ai/nomix-client-ui-slots": "workspace:^",
     "@nomix-ai/nomix-invariants": "workspace:^",
     "@nomix-ai/nomix-subagent": "workspace:^",
     "@nomix-ai/nomix-token-meter": "workspace:^",
     "@types/react": "~18.3.1",
-    "@nomix-ai/cordis": "workspace:^"
+    "@types/react-dom": "~18.3.0",
+    "@nomix-ai/cordis": "workspace:^",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
   },
   "files": [
     "lib/index.js",