@nanmicoder/dsh-agent-teams 0.1.9 → 0.1.11

package/README.md

@@ -22,6 +22,10 @@ Ask in natural language. The plugin provides the team protocol, ten coordination
   <img src="./assets/ui.png" width="100%" alt="DeepSeek Harness conversation with the AgentTeams live activity panel, members, tasks, dependencies, and reports">
 </p>
 
+## Releases
+
+Read the [latest release notes](https://github.com/NanmiCoder/dsh-agent-teams/releases/latest) or browse the [complete release history](https://github.com/NanmiCoder/dsh-agent-teams/releases). The same Markdown notes are included in the npm package under `release-notes/`.
+
 ## Why AgentTeams?
 
 | Capability | What it changes |
@@ -91,10 +95,11 @@ command), describe the goal, and press Enter.
 /agent-teams research the pricing pages of three competitors
 ```
 
-The line is claimed by the command pipeline and never reaches the model as
-plain text — the handler queues one deterministic activation message as an
-ordinary follow-up turn, so the captain protocol starts immediately. The
-invocation is durably logged (`command/run` / `command/done`).
+The command pipeline claims the line, then preserves that exact input as an
+ordinary user follow-up so it remains visible in the main chat. The gesture
+boundary adds the deterministic activation directive at pre-step, so the
+captain protocol still starts immediately. The invocation is also durably
+logged (`command/run` / `command/done`).
 
 Surfaces without command adjudication (for example the headless CLI) get the
 same deterministic activation through a gesture boundary: any genuine user

package/README_ZH.md

@@ -22,6 +22,10 @@
   <img src="./assets/ui.png" width="100%" alt="DeepSeek Harness 对话与 AgentTeams 实时活动面板，展示成员、任务依赖和回报">
 </p>
 
+## 版本更新
+
+查看[最新版本说明](https://github.com/NanmiCoder/dsh-agent-teams/releases/latest)，或浏览[完整发布历史](https://github.com/NanmiCoder/dsh-agent-teams/releases)。同一份 Markdown 说明也会随 npm 包发布到 `release-notes/` 目录。
+
 ## 为什么需要 AgentTeams？
 
 | 能力 | 带来的变化 |
@@ -88,7 +92,7 @@ dsh web
 /agent-teams 调研三家竞品的定价页
 ```
 
-这一行会被命令管线认领，**不会**以纯文本形式发给模型——处理器会以一条确定性激活消息排队一个普通跟进回合，队长协议立即启动。调用会持久化记录（`command/run` / `command/done`）。
+这一行被命令管线认领后，会按用户提交的原文作为普通用户消息送入主会话，因此聊天记录中仍能看到完整的 `/agent-teams …`。手势边界会在 pre-step 注入确定性激活指令，队长协议仍会立即启动。调用也会持久化记录（`command/run` / `command/done`）。
 
 没有命令裁决的表面（例如 headless CLI）也享有同等的确定性激活：任何以 `/agent-teams` 开头的真实用户消息，都会为其余文本激活该协议；句子中间出现的字样仍是普通文本。
 

package/lib/client/ActivityPanel.js

@@ -2,25 +2,28 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 /**
  * AgentTeams activity panel: the top-right floater monitoring every team.
  *
- * Modeled on the Claude Code desktop SessionActivityPanel: a fixed glass
- * panel at the top-right corner. On wide viewports it cooperatively makes the
- * conversation column yield space; narrow viewports keep overlay mode. It
+ * Modeled on the Claude Code desktop SessionActivityPanel: a shell-overlay
+ * panel that docks at the conversation's top-right edge by default, can be
+ * dragged into a floating window, resized, and folded into an activity badge.
+ * On wide viewports the docked panel makes the conversation column yield
+ * space; narrow viewports keep a simple inset overlay. It
  * polls the host `/plugins/dsh-agent-teams/state` route for
  * server-side snapshots (durable files + live subagent activity), with a
  * collapsed badge that auto-expands once when activity appears. Archived
  * teams stay available for the owning conversation after live work ends.
  *
- * The floater mounts through a body portal (no top-right slot exists in the
- * web shell); it is not a conversation node — the in-conversation panel was
- * removed in favor of this always-available monitor.
+ * The floater mounts in ui-layout's additive `shell.overlay`; it is not a
+ * conversation node — the in-conversation panel was removed in favor of this
+ * always-available monitor.
  * @module dsh-agent-teams/client/activity
  */
-import { useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';
-import { IconBranchOutline16, IconCloseOutline16, } from '@deepseek-ai/dsh-client-ui-primitives';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore, } from 'react';
+import { IconBranchOutline16, IconChevronDownOutline14, IconPanelLeftOutline16, } from '@deepseek-ai/dsh-client-ui-primitives';
 import { activityPanelExpandedForSession, compactDagLayout, COMPACT_DAG_NODE_HEIGHT, COMPACT_DAG_NODE_WIDTH, dependencyFocusTaskId, relatedTaskIds, usesParallelTaskGrid, } from "./activity-model.js";
 import { getActivityMonitorTargetsSnapshot, getActivitySnapshotsSnapshot, startActivityPolling, subscribeActivityMonitorTargets, subscribeActivitySnapshots, } from "./activity-monitor.js";
 import { ACTION_ART, LEAD_ART, memberArtUrl } from "./artwork.js";
 import { OPEN_PANEL_EVENT } from "./AgentTeamsCard.js";
+import { DEFAULT_PANEL_LAYOUT, PANEL_LAYOUT_STORAGE_KEY, compactPanelForBounds, dockPanelLayout, floatPanelLayout, movePanelLayout, panelMaximumHeight, panelUsesAutoHeight, parsePanelLayout, resizePanelLayout, resolvePanelGeometry, } from "./panel-geometry.js";
 import css from './ActivityPanel.module.css';
 /** Grace before the panel collapses once no team remains. */
 const AUTOCLOSE_GRACE_MS = 2000;
@@ -30,8 +33,22 @@ const AUTOCLOSE_GRACE_MS = 2000;
  * right after load. New activity after this window auto-expands as usual.
  */
 const AUTO_OPEN_SETTLE_MS = 4000;
-/** Root marker shared with the panel CSS while the portal is expanded. */
+/** Root marker shared with the panel CSS while the shell overlay is expanded. */
 const PANEL_OPEN_ATTRIBUTE = 'data-agent-teams-panel-open';
+/** Shared width concession consumed by the conversation root CSS. */
+const PANEL_SHIFT_PROPERTY = '--agent-teams-panel-shift';
+const PANEL_CONVERSATION_GAP = 14;
+const MOVE_THRESHOLD = 4;
+function initialPanelLayout() {
+    if (typeof window === 'undefined')
+        return DEFAULT_PANEL_LAYOUT;
+    return parsePanelLayout(window.localStorage.getItem(PANEL_LAYOUT_STORAGE_KEY));
+}
+function initialPanelBounds() {
+    if (typeof window === 'undefined')
+        return { width: 1440, height: 900, anchorRight: 1440 };
+    return { width: window.innerWidth, height: window.innerHeight, anchorRight: window.innerWidth };
+}
 /** Initial-letter fallback for unmatched roles. */
 function memberInitial(name) {
     return name.trim().slice(0, 1).toUpperCase() || '?';
@@ -82,7 +99,7 @@ function WorkGlyph({ active }) {
 }
 /** Collapsed badge: an always-visible corner pill while any team exists. */
 function CollapsedBadge({ count, busy, onClick }) {
-    return (_jsxs("button", { type: "button", className: css.badge, "data-busy": busy, onClick: onClick, "aria-label": `AgentTeams 活动，${count} 个团队`, children: [_jsx("span", { className: css.badgeDot, "data-busy": busy, "aria-hidden": true }), _jsx("span", { className: css.badgeCount, children: count })] }));
+    return (_jsxs("button", { type: "button", className: css.badge, "data-agent-teams-collapsed": true, "data-busy": busy, onClick: onClick, "aria-label": `AgentTeams 活动，${count} 个团队`, children: [_jsx("span", { className: css.badgeDot, "data-busy": busy, "aria-hidden": true }), _jsx("span", { className: css.badgeCount, children: count })] }));
 }
 function memberStateLabel(member, tasks, historic) {
     const owned = tasks.filter((task) => task.assignee === member.name);
@@ -219,8 +236,11 @@ function TeamSection({ team, onNavigate, historic = false }) {
     const allCompleted = team.tasks.length > 0 && completedCount === team.tasks.length;
     return (_jsxs("section", { className: css.team, "data-team-id": team.teamId, children: [_jsxs("header", { className: css.teamHead, children: [_jsx("span", { className: css.teamName, title: team.name, children: team.name }), historic && _jsx("span", { className: css.historicPill, children: "\u5DF2\u7ED3\u675F" }), _jsxs("span", { className: css.teamStats, children: [_jsxs("span", { "data-stat": "members", children: [team.members.length, " \u6210\u5458"] }), _jsxs("span", { "data-stat": "tasks", children: [completedCount, "/", team.tasks.length, " \u5B8C\u6210"] }), _jsxs("span", { "data-stat": "messages", children: [team.messageCount, " \u6D88\u606F"] })] })] }), _jsxs("section", { className: css.delegationSection, "aria-label": "\u961F\u957F\u6D3E\u5DE5\u5173\u7CFB", "data-delegation-map": true, children: [_jsxs("div", { className: css.captainNode, children: [_jsx("span", { className: css.captainAvatar, children: _jsx("img", { className: css.leadAvatar, src: LEAD_ART, alt: "", "aria-hidden": true }) }), _jsxs("span", { className: css.captainInfo, children: [_jsxs("span", { className: css.captainLine, children: [_jsx("span", { className: css.captainName, children: "\u961F\u957F" }), _jsx("span", { className: css.captainRole, children: "\u62C6\u89E3 \u00B7 \u6D3E\u53D1 \u00B7 \u6C47\u603B" })] }), _jsxs("span", { className: css.captainSummary, children: ["\u5DF2\u6D3E\u53D1 ", assignedCount, " \u9879\u4EFB\u52A1\u7ED9 ", team.members.length, " \u540D\u6210\u5458"] })] }), _jsxs("span", { className: css.captainState, "data-busy": busyCount > 0, children: [_jsx(WorkGlyph, { active: busyCount > 0 }), busyCount > 0 ? `${busyCount} 人执行中` : allCompleted ? '已收齐' : '等待回报'] })] }), _jsx(ProgressOverview, { team: team }), _jsxs("button", { type: "button", className: css.membersToggle, onClick: () => { setMembersOpen((current) => !current); }, "aria-expanded": membersOpen, "data-members-toggle": true, children: [_jsxs("span", { children: [_jsx(Chevron, { open: membersOpen }), "\u6210\u5458 ", team.members.length] }), _jsx("span", { children: membersOpen ? '收起' : '展开' })] }), membersOpen && _jsxs("div", { className: css.delegationTree, children: [team.members.length === 0 && _jsx("span", { className: css.emptyHint, children: "\u6682\u65E0\u6210\u5458\uFF0C\u7B49\u5F85\u961F\u957F\u7EC4\u5EFA\u56E2\u961F" }), team.members.map((member) => {
                                 const owned = team.tasks.filter((task) => task.assignee === member.name);
-                                return (_jsxs("div", { className: css.memberBlock, "data-activity": member.activity, children: [_jsx("span", { className: css.memberBranch, "aria-hidden": true, children: _jsx("span", {}) }), _jsxs("button", { type: "button", className: css.memberRow, "data-activity": member.activity, onClick: () => { if (member.id !== '')
-                                                onNavigate(member.id); }, children: [_jsxs("span", { className: css.memberAvatar, "data-unread": member.unread > 0, children: [memberArtUrl(member.name, member.role) !== null ? (_jsx("img", { className: css.memberArt, src: memberArtUrl(member.name, member.role) ?? '', alt: "", "aria-hidden": true })) : (_jsx("span", { className: css.memberInitial, style: { background: accentOf(member.id) }, children: memberInitial(member.name) })), _jsx("img", { className: css.stateArt, "data-activity": member.activity, src: ACTION_ART[member.activity], alt: "", "aria-hidden": true })] }), _jsxs("span", { className: css.memberInfo, children: [_jsxs("span", { className: css.memberLine, children: [_jsx("span", { className: css.memberName, children: member.name }), member.role !== '' && _jsx("span", { className: css.memberRole, children: member.role }), _jsxs("span", { className: css.memberState, "data-activity": member.activity, children: [_jsx(WorkGlyph, { active: member.activity === 'working' }), memberStateLabel(member, team.tasks, historic)] })] }), _jsx("span", { className: css.memberStatusLine, children: memberStatusText(member, team.tasks) })] }), _jsxs("span", { className: css.memberCount, children: [member.done, "/", member.total] })] }), _jsxs("div", { className: css.assignmentLine, children: [_jsx("span", { className: css.assignmentLabel, children: "\u961F\u957F\u6D3E\u53D1" }), _jsx("span", { className: css.assignmentTasks, children: owned.length === 0
+                                return (_jsxs("div", { className: css.memberBlock, "data-activity": member.activity, children: [_jsx("span", { className: css.memberBranch, "aria-hidden": true, children: _jsx("span", {}) }), _jsxs("button", { type: "button", className: css.memberRow, "data-activity": member.activity, onClick: () => {
+                                                if (member.id !== '') {
+                                                    onNavigate(team.captainSessionId, member.id);
+                                                }
+                                            }, children: [_jsxs("span", { className: css.memberAvatar, "data-unread": member.unread > 0, children: [memberArtUrl(member.name, member.role) !== null ? (_jsx("img", { className: css.memberArt, src: memberArtUrl(member.name, member.role) ?? '', alt: "", "aria-hidden": true })) : (_jsx("span", { className: css.memberInitial, style: { background: accentOf(member.id) }, children: memberInitial(member.name) })), _jsx("img", { className: css.stateArt, "data-activity": member.activity, src: ACTION_ART[member.activity], alt: "", "aria-hidden": true })] }), _jsxs("span", { className: css.memberInfo, children: [_jsxs("span", { className: css.memberLine, children: [_jsx("span", { className: css.memberName, children: member.name }), member.role !== '' && _jsx("span", { className: css.memberRole, children: member.role }), _jsxs("span", { className: css.memberState, "data-activity": member.activity, children: [_jsx(WorkGlyph, { active: member.activity === 'working' }), memberStateLabel(member, team.tasks, historic)] })] }), _jsx("span", { className: css.memberStatusLine, children: memberStatusText(member, team.tasks) })] }), _jsxs("span", { className: css.memberCount, children: [member.done, "/", member.total] })] }), _jsxs("div", { className: css.assignmentLine, children: [_jsx("span", { className: css.assignmentLabel, children: "\u961F\u957F\u6D3E\u53D1" }), _jsx("span", { className: css.assignmentTasks, children: owned.length === 0
                                                         ? _jsx("span", { className: css.taskEmpty, children: "\u6682\u65E0\u4EFB\u52A1" })
                                                         : owned.map((task) => (_jsx("span", { className: css.assignmentChip, "data-state": taskTone(task.state, task.status), title: task.subject, children: task.id }, task.id))) })] })] }, member.id));
                             })] })] }), _jsx(DependencyMap, { tasks: team.tasks })] }));
@@ -251,20 +271,28 @@ function historicCardTeam(data, owner) {
 /** The top-right activity floater. Teams follow the current session: live
  * snapshots and historic card summaries are only shown while their captain
  * session is the one currently open. */
-export function ActivityPanel({ sessionsList, openSession }) {
+export function ActivityPanel({ sessionsList, openMember }) {
     // Navigating to a member's subagent transcript is an explicit departure:
     // hide the floater immediately instead of waiting out the autocollapse
     // grace, so the panel never lingers over the member session.
-    const navigateToSession = (id) => {
+    const navigateToSession = (parentId, childId) => {
         setOpen(false);
         setWasActive(false);
-        openSession(id);
+        openMember(parentId, childId);
     };
     const [open, setOpen] = useState(false);
     const [openOwner, setOpenOwner] = useState();
     const [autoOpened, setAutoOpened] = useState(false);
     const [wasActive, setWasActive] = useState(false);
     const [historic, setHistoric] = useState(new Map());
+    const [layout, setLayout] = useState(initialPanelLayout);
+    const [bounds, setBounds] = useState(initialPanelBounds);
+    const [interaction, setInteraction] = useState(null);
+    const panelRef = useRef(null);
+    const boundsRef = useRef(bounds);
+    const gestureRef = useRef(null);
+    const frameRef = useRef(null);
+    const pendingLayoutRef = useRef(null);
     const current = useSyncExternalStore(sessionsList.subscribe, sessionsList.getSnapshot).current;
     const monitorTargets = useSyncExternalStore(subscribeActivityMonitorTargets, getActivityMonitorTargetsSnapshot);
     const { teams, archivedTeams } = useSyncExternalStore(subscribeActivitySnapshots, getActivitySnapshotsSnapshot);
@@ -273,7 +301,60 @@ export function ActivityPanel({ sessionsList, openSession }) {
     useEffect(() => { currentRef.current = current; }, [current]);
     const mountedAtRef = useRef(performance.now());
     const expanded = activityPanelExpandedForSession(open, openOwner, current);
-    // This portal survives conversation route changes. Gate expansion by its
+    const geometry = useMemo(() => resolvePanelGeometry(layout, bounds), [layout, bounds]);
+    const compact = compactPanelForBounds(bounds);
+    const commitLayout = useCallback((next) => {
+        setLayout(next);
+    }, []);
+    useEffect(() => {
+        window.localStorage.setItem(PANEL_LAYOUT_STORAGE_KEY, JSON.stringify(layout));
+    }, [layout]);
+    // The slot sits inside AppFrame, so all geometry is measured against the
+    // shell overlay rather than the browser viewport. The conversation's real
+    // right edge is the dock anchor and naturally follows sidebar/details
+    // concessions without importing their hashed implementation classes.
+    useLayoutEffect(() => {
+        const overlay = document.querySelector('[data-shell-overlay]');
+        if (overlay === null)
+            return;
+        const conversation = document.querySelector("[data-phase='active']");
+        let frame = null;
+        const measure = () => {
+            frame = null;
+            const overlayRect = overlay.getBoundingClientRect();
+            const conversationRect = conversation?.getBoundingClientRect();
+            const next = {
+                width: overlayRect.width,
+                height: overlayRect.height,
+                anchorRight: conversationRect === undefined
+                    ? overlayRect.width
+                    : Math.min(Math.max(conversationRect.right - overlayRect.left, 0), overlayRect.width),
+            };
+            const previous = boundsRef.current;
+            if (previous.width === next.width
+                && previous.height === next.height
+                && previous.anchorRight === next.anchorRight)
+                return;
+            boundsRef.current = next;
+            setBounds(next);
+        };
+        const scheduleMeasure = () => {
+            frame ??= requestAnimationFrame(measure);
+        };
+        measure();
+        const observer = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(scheduleMeasure);
+        observer?.observe(overlay);
+        if (conversation !== null)
+            observer?.observe(conversation);
+        window.addEventListener('resize', scheduleMeasure);
+        return () => {
+            if (frame !== null)
+                cancelAnimationFrame(frame);
+            observer?.disconnect();
+            window.removeEventListener('resize', scheduleMeasure);
+        };
+    }, [current]);
+    // This shell overlay survives conversation route changes. Gate expansion by its
     // owning session during render, then clear stale state before paint. This
     // removes the old panel immediately instead of waiting for the no-team
     // autoclose grace period on the destination page.
@@ -285,25 +366,34 @@ export function ActivityPanel({ sessionsList, openSession }) {
         setWasActive(false);
         setAutoOpened(false);
     }, [current, openOwner]);
-    // The activity panel is a body portal, so announce its open state on body.
-    // CSS can then make the conversation column yield space without knowing the
-    // host shell's hashed module class names. Narrow viewports keep overlay mode.
+    // Only the wide docked mode asks the conversation column to yield. Floating
+    // and compact modes are intentionally true overlays. The width is written as
+    // one shared variable so the panel and the concession cannot drift apart.
     useLayoutEffect(() => {
         const root = document.documentElement;
-        if (expanded)
+        const shouldYield = expanded && geometry.mode === 'docked' && !compact;
+        if (shouldYield) {
             root.setAttribute(PANEL_OPEN_ATTRIBUTE, '');
-        else
+            root.style.setProperty(PANEL_SHIFT_PROPERTY, `${geometry.width + PANEL_CONVERSATION_GAP + 18}px`);
+        }
+        else {
             root.removeAttribute(PANEL_OPEN_ATTRIBUTE);
-        return () => { root.removeAttribute(PANEL_OPEN_ATTRIBUTE); };
-    }, [expanded]);
+            root.style.removeProperty(PANEL_SHIFT_PROPERTY);
+        }
+        return () => {
+            root.removeAttribute(PANEL_OPEN_ATTRIBUTE);
+            root.style.removeProperty(PANEL_SHIFT_PROPERTY);
+        };
+    }, [compact, expanded, geometry.mode, geometry.width]);
     useEffect(() => {
-        // Installing the plugin alone must not touch the state route. A successful
-        // AgentTeams conversation card registers the demand that reaches here.
-        if (currentTargets.length === 0)
+        if (current === undefined)
             return;
-        const controller = startActivityPolling(currentTargets);
+        // Cards keep live teams on the normal cadence. The current-session scope
+        // also performs one cold-start discovery pass so archived/cardless teams
+        // survive a browser or `dsh web` restart.
+        const controller = startActivityPolling(currentTargets, { discoverySessionId: current });
         return () => { controller.stop(); };
-    }, [currentTargets]);
+    }, [current, currentTargets]);
     useEffect(() => {
         const onOpenPanel = (event) => {
             const activeSession = currentRef.current;
@@ -365,6 +455,123 @@ export function ActivityPanel({ sessionsList, openSession }) {
     }, [visibleCount, autoOpened, wasActive]);
     const busy = useMemo(() => visibleTeams.some((team) => team.members.some((member) => member.activity === 'working')), [visibleTeams]);
     const hasTeams = visibleCount > 0;
+    // Auto-height panels do not store their live content height. Capture the
+    // rendered box when a pointer gesture starts so movement and a first manual
+    // resize clamp against what the user actually sees.
+    const panelGeometryForGesture = useCallback(() => {
+        const measuredHeight = panelRef.current?.getBoundingClientRect().height;
+        if (measuredHeight === undefined || measuredHeight <= 0)
+            return geometry;
+        return { ...geometry, height: measuredHeight };
+    }, [geometry]);
+    const flushScheduledLayout = useCallback(() => {
+        if (frameRef.current !== null) {
+            cancelAnimationFrame(frameRef.current);
+            frameRef.current = null;
+        }
+        const pending = pendingLayoutRef.current;
+        pendingLayoutRef.current = null;
+        if (pending !== null)
+            commitLayout(pending);
+    }, [commitLayout]);
+    const scheduleLayout = useCallback((next) => {
+        pendingLayoutRef.current = next;
+        frameRef.current ??= requestAnimationFrame(() => {
+            frameRef.current = null;
+            const pending = pendingLayoutRef.current;
+            pendingLayoutRef.current = null;
+            if (pending !== null)
+                commitLayout(pending);
+        });
+    }, [commitLayout]);
+    useEffect(() => () => {
+        if (frameRef.current !== null)
+            cancelAnimationFrame(frameRef.current);
+    }, []);
+    const beginMove = useCallback((event) => {
+        if (compact || event.button !== 0 || event.target.closest('button') !== null)
+            return;
+        event.preventDefault();
+        event.currentTarget.setPointerCapture(event.pointerId);
+        gestureRef.current = {
+            kind: 'move',
+            pointerId: event.pointerId,
+            originX: event.clientX,
+            originY: event.clientY,
+            start: panelGeometryForGesture(),
+            activated: false,
+        };
+    }, [compact, panelGeometryForGesture]);
+    const beginResize = useCallback((edge, event) => {
+        if (compact || event.button !== 0 || (geometry.mode === 'docked' && edge !== 'left'))
+            return;
+        event.preventDefault();
+        event.stopPropagation();
+        event.currentTarget.setPointerCapture(event.pointerId);
+        gestureRef.current = {
+            kind: 'resize',
+            edge,
+            pointerId: event.pointerId,
+            originX: event.clientX,
+            originY: event.clientY,
+            start: panelGeometryForGesture(),
+            activated: true,
+        };
+        setInteraction('resizing');
+    }, [compact, geometry.mode, panelGeometryForGesture]);
+    const updateGesture = useCallback((event) => {
+        const gesture = gestureRef.current;
+        if (gesture === null || gesture.pointerId !== event.pointerId
+            || !event.currentTarget.hasPointerCapture(event.pointerId))
+            return;
+        const dx = event.clientX - gesture.originX;
+        const dy = event.clientY - gesture.originY;
+        const activeBounds = boundsRef.current;
+        if (gesture.kind === 'move') {
+            if (!gesture.activated && Math.hypot(dx, dy) < MOVE_THRESHOLD)
+                return;
+            if (!gesture.activated) {
+                gesture.activated = true;
+                setInteraction('dragging');
+            }
+            scheduleLayout(movePanelLayout(floatPanelLayout(gesture.start, activeBounds), dx, dy, activeBounds));
+            return;
+        }
+        scheduleLayout(resizePanelLayout(gesture.start, gesture.edge ?? 'left', dx, dy, activeBounds));
+    }, [scheduleLayout]);
+    const endGesture = useCallback((event) => {
+        const gesture = gestureRef.current;
+        if (gesture === null || gesture.pointerId !== event.pointerId)
+            return;
+        updateGesture(event);
+        flushScheduledLayout();
+        if (event.currentTarget.hasPointerCapture(event.pointerId)) {
+            event.currentTarget.releasePointerCapture(event.pointerId);
+        }
+        gestureRef.current = null;
+        setInteraction(null);
+    }, [flushScheduledLayout, updateGesture]);
+    const cancelGesture = useCallback((event) => {
+        const gesture = gestureRef.current;
+        if (gesture === null || gesture.pointerId !== event.pointerId)
+            return;
+        flushScheduledLayout();
+        gestureRef.current = null;
+        setInteraction(null);
+    }, [flushScheduledLayout]);
+    const toggleDock = useCallback(() => {
+        const liveGeometry = panelGeometryForGesture();
+        commitLayout(liveGeometry.mode === 'docked'
+            ? floatPanelLayout(liveGeometry, boundsRef.current)
+            : dockPanelLayout(liveGeometry, boundsRef.current));
+    }, [commitLayout, panelGeometryForGesture]);
+    const autoHeight = panelUsesAutoHeight(geometry, bounds);
+    const panelStyle = {
+        width: geometry.width,
+        height: autoHeight ? 'auto' : geometry.height,
+        maxHeight: panelMaximumHeight(geometry, bounds),
+        transform: `translate3d(${geometry.x}px, ${geometry.y}px, 0)`,
+    };
     if (!hasTeams && !expanded)
         return null;
     return (_jsxs(_Fragment, { children: [!expanded && (_jsx(CollapsedBadge, { count: visibleCount, busy: busy, onClick: () => {
@@ -372,13 +579,13 @@ export function ActivityPanel({ sessionsList, openSession }) {
                         return;
                     setOpenOwner(current);
                     setOpen(true);
-                } })), expanded && (_jsxs("aside", { className: css.panel, "data-agent-teams-activity": true, children: [_jsxs("header", { className: css.panelHead, children: [_jsxs("span", { className: css.panelTitle, children: ["AgentTeams \u6D3B\u52A8", _jsx("span", { className: css.panelDot, "data-busy": busy, "aria-hidden": true })] }), _jsx("button", { type: "button", className: css.closeButton, onClick: () => {
-                                    setOpen(false);
-                                    setOpenOwner(undefined);
-                                }, "aria-label": "\u5173\u95ED", children: _jsx(IconCloseOutline16, {}) })] }), _jsx("div", { className: css.teams, children: visibleCount === 0
+                } })), expanded && (_jsxs("aside", { ref: panelRef, className: css.panel, style: panelStyle, "data-agent-teams-activity": true, "data-panel-mode": geometry.mode, "data-height-mode": autoHeight ? 'auto' : 'manual', "data-compact": compact || undefined, "data-dragging": interaction === 'dragging' || undefined, "data-resizing": interaction === 'resizing' || undefined, "aria-label": "AgentTeams \u6D3B\u52A8\u9762\u677F", children: [_jsxs("header", { className: css.panelHead, onPointerDown: beginMove, onPointerMove: updateGesture, onPointerUp: endGesture, onPointerCancel: cancelGesture, "data-drag-handle": !compact || undefined, children: [_jsxs("span", { className: css.panelTitle, children: ["AgentTeams \u6D3B\u52A8", _jsx("span", { className: css.panelDot, "data-busy": busy, "aria-hidden": true })] }), _jsxs("span", { className: css.panelControls, children: [!compact && (_jsx("button", { type: "button", className: css.iconButton, "data-control": "dock", "data-mode": geometry.mode, onClick: toggleDock, "aria-label": geometry.mode === 'docked' ? '切换为浮动面板' : '停靠到右侧', title: geometry.mode === 'docked' ? '切换为浮动面板' : '停靠到右侧', children: _jsx(IconPanelLeftOutline16, {}) })), _jsx("button", { type: "button", className: css.iconButton, "data-control": "collapse", onClick: () => {
+                                            setOpen(false);
+                                            setOpenOwner(undefined);
+                                        }, "aria-label": "\u6536\u8D77\u6D3B\u52A8\u9762\u677F", title: "\u6536\u8D77\u6D3B\u52A8\u9762\u677F", children: _jsx(IconChevronDownOutline14, {}) })] })] }), _jsx("div", { className: css.teams, children: visibleCount === 0
                             ? _jsx("span", { className: css.emptyHint, children: "\u6682\u65E0\u56E2\u961F\u6D3B\u52A8" })
                             : (_jsxs(_Fragment, { children: [visibleTeams.map((team) => (_jsx(TeamSection, { team: team, onNavigate: navigateToSession }, team.teamId))), visibleArchived.map((team) => (_jsx("div", { "data-team-id": team.teamId, "data-historic": true, className: css.archivedWrap, children: _jsx(TeamSection, { team: team, onNavigate: navigateToSession, historic: true }) }, `${team.captainSessionId}:${team.teamId}`))), visibleHistoric.map(({ data: team, owner }) => {
                                         const teamKey = `${owner}:${team.teamId}`;
                                         return (_jsx(TeamSection, { team: historicCardTeam(team, owner), onNavigate: navigateToSession, historic: true }, teamKey));
-                                    })] })) })] }))] }));
+                                    })] })) }), !compact && (_jsx("div", { className: css.resizeHandle, "data-resize-edge": "left", onPointerDown: (event) => { beginResize('left', event); }, onPointerMove: updateGesture, onPointerUp: endGesture, onPointerCancel: cancelGesture, "aria-hidden": true })), !compact && geometry.mode === 'floating' && (_jsxs(_Fragment, { children: [_jsx("div", { className: css.resizeHandle, "data-resize-edge": "bottom", onPointerDown: (event) => { beginResize('bottom', event); }, onPointerMove: updateGesture, onPointerUp: endGesture, onPointerCancel: cancelGesture, "aria-hidden": true }), _jsx("div", { className: css.resizeHandle, "data-resize-edge": "corner", onPointerDown: (event) => { beginResize('corner', event); }, onPointerMove: updateGesture, onPointerUp: endGesture, onPointerCancel: cancelGesture, "aria-hidden": true })] }))] }))] }));
 }

package/lib/client/AgentTeamsCard.js

@@ -30,7 +30,7 @@ function openActivityPanel(data) {
     }));
 }
 /** Render one durable team as a compact conversation card. */
-export function AgentTeamsCard({ node, openSession, sessionId }) {
+export function AgentTeamsCard({ node, openMember, sessionId }) {
     const data = node.data;
     // `conversation.chat.node` is session-scoped, so its framework-owned id is
     // a stable owner even while another conversation becomes current.
@@ -47,6 +47,8 @@ export function AgentTeamsCard({ node, openSession, sessionId }) {
         teamName: snapshot?.name ?? data.teamName,
         members: snapshot?.members.map((member) => ({ id: member.id, name: member.name, role: member.role })) ?? data.members,
     }), [data, owner, snapshot]);
-    return (_jsxs("section", { className: css.root, "data-agent-teams-card": true, "data-team-id": resolved.teamId, children: [_jsxs("header", { className: css.head, children: [_jsx("img", { className: css.leadAvatar, src: LEAD_ART, alt: "", "aria-hidden": true }), _jsx("span", { className: css.teamName, title: resolved.teamName, children: resolved.teamName }), _jsxs("span", { className: css.memberCount, children: [resolved.members.length, " \u540D\u6210\u5458"] }), _jsx("button", { type: "button", className: css.panelButton, onClick: () => { openActivityPanel(resolved); }, "aria-label": "\u6253\u5F00\u6D3B\u52A8\u9762\u677F", title: "\u6253\u5F00\u6D3B\u52A8\u9762\u677F", children: "\u6D3B\u52A8\u9762\u677F" })] }), resolved.members.length > 0 && (_jsx("div", { className: css.members, children: resolved.members.map((member) => (_jsxs("button", { type: "button", className: css.member, onClick: () => { if (member.id !== '')
-                        openSession(member.id); }, title: member.role === '' ? member.name : `${member.name} · ${member.role}`, children: [memberArtUrl(member.name, member.role) !== null ? (_jsx("img", { className: css.memberArt, src: memberArtUrl(member.name, member.role) ?? '', alt: "", "aria-hidden": true })) : (_jsx("span", { className: css.memberInitial, children: member.name.trim().slice(0, 1).toUpperCase() || '?' })), _jsx("span", { className: css.memberName, children: member.name })] }, member.id))) }))] }));
+    return (_jsxs("section", { className: css.root, "data-agent-teams-card": true, "data-team-id": resolved.teamId, children: [_jsxs("header", { className: css.head, children: [_jsx("img", { className: css.leadAvatar, src: LEAD_ART, alt: "", "aria-hidden": true }), _jsx("span", { className: css.teamName, title: resolved.teamName, children: resolved.teamName }), _jsxs("span", { className: css.memberCount, children: [resolved.members.length, " \u540D\u6210\u5458"] }), _jsx("button", { type: "button", className: css.panelButton, onClick: () => { openActivityPanel(resolved); }, "aria-label": "\u6253\u5F00\u6D3B\u52A8\u9762\u677F", title: "\u6253\u5F00\u6D3B\u52A8\u9762\u677F", children: "\u6D3B\u52A8\u9762\u677F" })] }), resolved.members.length > 0 && (_jsx("div", { className: css.members, children: resolved.members.map((member) => (_jsxs("button", { type: "button", className: css.member, onClick: () => {
+                        if (member.id !== '')
+                            openMember(owner, member.id);
+                    }, title: member.role === '' ? member.name : `${member.name} · ${member.role}`, children: [memberArtUrl(member.name, member.role) !== null ? (_jsx("img", { className: css.memberArt, src: memberArtUrl(member.name, member.role) ?? '', alt: "", "aria-hidden": true })) : (_jsx("span", { className: css.memberInitial, children: member.name.trim().slice(0, 1).toUpperCase() || '?' })), _jsx("span", { className: css.memberName, children: member.name })] }, member.id))) }))] }));
 }

package/lib/client/activity-model.js

@@ -14,10 +14,10 @@ export function usesParallelTaskGrid(tasks) {
 /**
  * Whether an expanded activity panel still belongs to the current session.
  *
- * The panel is mounted through a body portal, so React does not remount it
- * when the conversation route changes. Ownership keeps an expanded panel
- * from leaking onto the new-session screen (or another conversation) while
- * its local open state is being reset.
+ * The panel is mounted in the root-scoped shell overlay, so React does not
+ * remount it when the conversation route changes. Ownership keeps an expanded
+ * panel from leaking onto the new-session screen (or another conversation)
+ * while its local open state is being reset.
  */
 export function activityPanelExpandedForSession(open, owner, current) {
     return open && owner !== undefined && owner === current;

package/lib/client/activity-monitor.js

@@ -104,12 +104,17 @@ export const ACTIVITY_STATE_URL = '/plugins/dsh-agent-teams/state';
 /**
  * Start the single polling loop for the current session's requested targets.
  *
- * With no targets this is deliberately inert: installing the plugin must not
- * touch the state route. Live state is polled at the normal cadence; archive
- * state is fetched only as a one-time fallback for targets no longer live.
+ * With neither targets nor a discovery session this is deliberately inert.
+ * A discovery session performs one live+archive pass after selection/restart;
+ * it keeps polling only while that captain still owns a live team. This
+ * restores legacy/cardless history without turning every ordinary session
+ * into a permanent one-second filesystem scan. Explicit card targets retain
+ * the normal cadence, and archive state is refreshed when a target or a
+ * previously discovered live team disappears.
  */
 export function startActivityPolling(monitorTargets, runtime = {}) {
-    if (monitorTargets.length === 0) {
+    const discoverySessionId = runtime.discoverySessionId?.trim();
+    if (monitorTargets.length === 0 && (discoverySessionId === undefined || discoverySessionId === '')) {
         return { firstTick: Promise.resolve(), stop: () => { } };
     }
     const fetchState = runtime.fetchState ?? ((url, init) => fetch(url, init));
@@ -119,10 +124,16 @@ export function startActivityPolling(monitorTargets, runtime = {}) {
     const settleTargets = runtime.settleTargets ?? settleActivityMonitorTargets;
     let cancelled = false;
     let inFlight = false;
+    let discoveryComplete = false;
+    let discoveredLiveKeys = new Set();
     let controller;
     const tick = async () => {
         if (inFlight || cancelled)
             return;
+        // A cardless ordinary or archive-only session needs one recovery pass,
+        // then stays dormant until the component is recreated for another session.
+        if (discoveryComplete && monitorTargets.length === 0 && discoveredLiveKeys.size === 0)
+            return;
         inFlight = true;
         controller = new AbortController();
         try {
@@ -137,11 +148,24 @@ export function startActivityPolling(monitorTargets, runtime = {}) {
                 return;
             const liveTeams = body.teams;
             publishSnapshots({ teams: liveTeams });
+            const previousDiscoveredKeys = discoveredLiveKeys;
+            discoveredLiveKeys = new Set(discoverySessionId === undefined || discoverySessionId === ''
+                ? []
+                : liveTeams
+                    .filter((team) => team.captainSessionId === discoverySessionId)
+                    .map((team) => team.teamId));
+            const discoveredTeamArchived = [...previousDiscoveredKeys]
+                .some((teamId) => !discoveredLiveKeys.has(teamId));
             const missing = monitorTargets.filter((target) => !liveTeams.some((team) => team.captainSessionId === target.sessionId && team.teamId === target.teamId));
-            if (missing.length === 0)
+            const needsDiscoveryArchive = discoverySessionId !== undefined
+                && discoverySessionId !== ''
+                && !discoveryComplete;
+            if (missing.length === 0 && !needsDiscoveryArchive && !discoveredTeamArchived)
                 return;
-            // Archives are immutable. A successful fallback retires every missing
-            // target, including legacy cards whose host archive no longer exists.
+            // Archives are immutable per team generation. A successful fallback
+            // retires every missing explicit target, including legacy cards whose
+            // host archive no longer exists; discovery remains available from the
+            // shared snapshot after this controller becomes dormant.
             const archivedResponse = await fetchState(`${ACTIVITY_STATE_URL}?archived=1`, {
                 cache: 'no-store',
                 signal: controller.signal,
@@ -152,6 +176,7 @@ export function startActivityPolling(monitorTargets, runtime = {}) {
             if (cancelled || !Array.isArray(archivedBody.teams))
                 return;
             publishSnapshots({ archivedTeams: archivedBody.teams });
+            discoveryComplete = true;
             settleTargets(new Set(missing.map((target) => target.key)));
         }
         catch (error) {

package/lib/client/index.js

@@ -1,32 +1,45 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createRoot } from 'react-dom/client';
 import { ActivityPanel } from "./ActivityPanel.js";
 import { AgentTeamsCard } from "./AgentTeamsCard.js";
 import { agentTeamsCardDefinition } from "./agent-teams-card-definition.js";
+import { openAgentTeamMember } from "./session-navigation.js";
 /** Required services: conversation nodes, slots, and sessions navigation. */
 export const inject = ['conversationEvents', 'slots', 'sessions'];
+/** The replayed user message is the canonical transcript entry. */
+function HiddenAgentTeamsCommand() {
+    return null;
+}
 /**
- * Mount the floater through a body portal (the web shell has no top-right
- * slot) and register the in-conversation team card, whose "activity panel"
- * button re-activates the floater via a window event — the recovery path
- * for a closed floater or a re-opened session.
+ * Register the activity monitor in the shell's additive overlay and the
+ * in-conversation team card. The card's activity button re-opens a folded
+ * monitor via a window event — the recovery path for an old session.
  */
 export function apply(ctx) {
-    const host = document.createElement('div');
-    host.dataset.agentTeamsHost = '';
-    document.body.appendChild(host);
-    const root = createRoot(host);
-    root.render(_jsx(ActivityPanel, { sessionsList: ctx.sessions.list, openSession: (id) => { ctx.sessions.open(id); } }));
-    ctx.effect(() => () => {
-        root.unmount();
-        host.remove();
-    }, 'agent-teams: activity panel');
+    const openMember = (parentId, childId) => {
+        void openAgentTeamMember(ctx.sessions, parentId, childId).catch((error) => {
+            console.warn(`agent-teams: failed to open member transcript ${childId}: ${String(error)}`);
+        });
+    };
+    const Panel = () => _jsx(ActivityPanel, { sessionsList: ctx.sessions.list, openMember: openMember });
+    ctx.slots.inject('shell.overlay', () => ctx.slots.register({
+        name: 'shell.overlay',
+        id: 'agent-teams-activity',
+        order: 80,
+        label: 'AgentTeams activity',
+    }, Panel));
+    // The host command is only the slash-menu/admission surface. Its input is
+    // replayed as the visible user message, so the generic result row would be
+    // a duplicate placed before that message by command lifecycle ordering.
+    ctx.slots.inject('conversation.chat.commandview', () => ctx.slots.register({
+        name: 'conversation.chat.commandview',
+        key: 'agent-teams',
+    }, HiddenAgentTeamsCommand));
     ctx.conversationEvents.register(agentTeamsCardDefinition);
     ctx.slots.inject('conversation.chat.node', () => ctx.slots.register({
         name: 'conversation.chat.node',
         key: 'agent-teams',
         inject: () => ({
-            openSession: (id) => { ctx.sessions.open(id); },
+            openMember,
         }),
     }, AgentTeamsCard));
 }