@nanmicoder/dsh-agent-teams 0.1.16-rc.3 → 0.1.17-rc.1

package/README.md

@@ -30,7 +30,7 @@ Ask in natural language. The plugin provides the team protocol, 13 coordination
 
 ## Releases
 
-[v0.1.16-rc.3](./release-notes/v0.1.16-rc.3.md) targets npm `next`, with a concise fixed team protocol, existing-team reuse guidance, Web approval wakeups, and team-lock cleanup. Choose a version pair below.
+[v0.1.17-rc.1](./release-notes/v0.1.17-rc.1.md) supports DeepSeek Harness `0.1.5-rc.1` on the npm `next` channel. It adapts subagent delivery, explicit member initialization, and Web panel navigation while retaining three older host targets.
 
 ## Why AgentTeams?
 
@@ -49,18 +49,19 @@ The conversation card and activity panel use Harness's official locale service.
 
 ## Install and choose versions
 
-**Recommended pair: DeepSeek Harness `0.1.2-rc.1` + AgentTeams `0.1.16-rc.3`. Both are still prereleases.**
+**Recommended pair: DeepSeek Harness `0.1.5-rc.1` + AgentTeams `0.1.17-rc.1`. Both are prereleases.**
 
 | Use case | DeepSeek Harness | AgentTeams plugin |
 | --- | --- | --- |
-| **Recommended installation** | **`0.1.2-rc.1`** | **`0.1.16-rc.3`** |
-| Developer Alpha testing | `0.1.2-alpha.5` | `0.1.16-rc.3` |
-| Retaining an older Alpha | `0.1.2-alpha.2` | `0.1.16-rc.3` |
+| **Recommended installation** | **`0.1.5-rc.1`** | **`0.1.17-rc.1`** |
+| Retaining an older RC | `0.1.2-rc.1` | `0.1.17-rc.1` |
+| Developer Alpha testing | `0.1.2-alpha.5` | `0.1.17-rc.1` |
+| Retaining an older Alpha | `0.1.2-alpha.2` | `0.1.17-rc.1` |
 
 ### 1. Install DeepSeek Harness
 
 ```sh
-npm install --global @deepseek-ai/dsh@0.1.2-rc.1
+npm install --global @deepseek-ai/dsh@0.1.5-rc.1
 dsh --version
 ```
 
@@ -68,15 +69,15 @@ Skip this if you already run this version. Alpha is opt-in: select an exact Alph
 
 ### 2. Install the AgentTeams plugin
 
-This installs into the `web` profile. Replace `web` with your actual profile name if different:
+Install into the `web` profile. Replace the profile name if needed:
 
 ```sh
-dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.16-rc.3
+dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.17-rc.1
 ```
 
 **After installation, stop and restart Harness for that profile, then refresh the browser.**
 
-Plugin `0.1.16-rc.3` uses the `next` channel; `latest` still points to `0.1.15`, which targets Alpha.2. Use the exact-version command above. Future plugin prereleases use `next`; only stable plugin releases that pass the full verification matrix may use `latest`.
+Plugin prereleases use npm `next`; use the exact-version command above. `latest` is not the recommended entry for this host pair. See the [source installation guide](./docs/maintenance-workflow.md) and [release verification](./docs/releases/v0.1.17-rc.1/README.md).
 
 > Desktop users must check the app's embedded Harness core; upgrading the global CLI does not upgrade it. For older `0.1.0-*` / `0.1.1-*` or unlisted hosts, keep a working pair and follow the [older-version and diagnostic guide](./docs/maintenance-workflow.md).
 
@@ -123,6 +124,8 @@ same deterministic activation through a gesture boundary: any genuine user
 message starting with `/agent-teams` activates the protocol for the rest of
 the text. Mid-sentence mentions stay ordinary prose.
 
+Historical panels require saved team state or archives. Sessions from early versions that deleted teams without retaining archives do not yet support reconstructing the full panel from logs.
+
 ## Configuration
 
 Defaults work without extra setup. A trusted profile can override member behavior:

package/README_ZH.md

@@ -30,7 +30,7 @@
 
 ## 版本更新
 
-[v0.1.16-rc.3](./release-notes/v0.1.16-rc.3.md) 面向 npm `next` 渠道，精简固定团队协议、引导复用已有团队，并修复 Web 批准通知和团队锁清理。安装版本见下方配对表。
+[v0.1.17-rc.1](./release-notes/v0.1.17-rc.1.md) 适配 DeepSeek Harness `0.1.5-rc.1`，发布到 npm `next` 渠道。新增子代理投递、成员初始化和 Web 面板导航适配，保留三个旧宿主目标。
 
 ## 为什么需要 AgentTeams？
 
@@ -48,18 +48,19 @@
 
 ## 安装与版本选择
 
-**推荐组合：DeepSeek Harness `0.1.2-rc.1` + AgentTeams `0.1.16-rc.3`。两者都仍是预发布版本。**
+**推荐组合：DeepSeek Harness `0.1.5-rc.1` + AgentTeams `0.1.17-rc.1`。两者均为预发布版本。**
 
 | 使用场景 | DeepSeek Harness | AgentTeams 插件 |
 | --- | --- | --- |
-| **推荐安装** | **`0.1.2-rc.1`** | **`0.1.16-rc.3`** |
-| 开发者测试 Alpha | `0.1.2-alpha.5` | `0.1.16-rc.3` |
-| 保留旧 Alpha | `0.1.2-alpha.2` | `0.1.16-rc.3` |
+| **推荐安装** | **`0.1.5-rc.1`** | **`0.1.17-rc.1`** |
+| 保留旧 RC | `0.1.2-rc.1` | `0.1.17-rc.1` |
+| 开发者测试 Alpha | `0.1.2-alpha.5` | `0.1.17-rc.1` |
+| 保留旧 Alpha | `0.1.2-alpha.2` | `0.1.17-rc.1` |
 
 ### 1. 安装 DeepSeek Harness
 
 ```sh
-npm install --global @deepseek-ai/dsh@0.1.2-rc.1
+npm install --global @deepseek-ai/dsh@0.1.5-rc.1
 dsh --version
 ```
 
@@ -67,15 +68,15 @@ dsh --version
 
 ### 2. 安装 AgentTeams 插件
 
-以下安装到 `web` profile；使用其他 profile 时，将 `web` 换成实际名称：
+安装到 `web` profile；使用其他 profile 时替换名称：
 
 ```sh
-dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.16-rc.3
+dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.17-rc.1
 ```
 
 **安装后，停止并重新启动该 profile 的 Harness 进程，再刷新浏览器。**
 
-插件 `0.1.16-rc.3` 使用 `next` 渠道；当前 `latest` 仍是面向 Alpha.2 的 `0.1.15`。请使用上面的精确版本命令。后续插件预发布版本继续进入 `next`，通过完整验证的正式版本才进入 `latest`。
+插件预发布使用 npm `next`，请使用上面的精确版本命令；`latest` 不是这组宿主的推荐安装入口。源码安装见[维护指南](./docs/maintenance-workflow.md)，验证范围见[本版验收记录](./docs/releases/v0.1.17-rc.1/README.md)。
 
 > Desktop 用户需核对应用内置的 Harness 核心；全局 CLI 升级不会升级桌面内核。旧 `0.1.0-*` / `0.1.1-*` 或其他未列出的宿主，请先保留已工作的组合，参考[旧版本与诊断指引](./docs/maintenance-workflow.md)。
 
@@ -135,6 +136,7 @@ dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.16-rc.
 - 一个队长同一时间只能带一个活动团队。
 - 没有开放任务的空闲成员会自动续领就绪任务；仍持有开放 attempt 的空闲成员会停驻，队长可发消息让其沿用原 attempt 继续，或显式转派；冷重启遗留的开放任务才会生成新 attempt。暂时无法实时投递的消息会持久保存在邮箱中并在后续状态边界重投。
 - 状态使用文件持久化，并在单个 DSH 进程内串行操作；多个进程同时修改同一团队不保证一致。
+- 历史面板依赖保存的团队状态或归档；早期版本删除团队时未保留归档的会话，暂不支持从日志重建完整面板。
 - 活动面板如实展示持久化状态；模型偶尔可能完成工作却没有按协议更新任务状态。
 
 完整工具列表、状态模型、Web UI 行为、配置与已知限制见 [docs/usage.md](./docs/usage.md)。

package/compatibility.json

@@ -1,10 +1,23 @@
 {
   "schemaVersion": 1,
-  "recommendedHost": "0.1.2-rc.1",
+  "recommendedHost": "0.1.5-rc.1",
   "previewTag": "next",
   "supportedHosts": [
-    { "version": "0.1.2-rc.1", "track": "recommended" },
-    { "version": "0.1.2-alpha.5", "track": "preview" },
-    { "version": "0.1.2-alpha.2", "track": "legacy" }
+    {
+      "version": "0.1.5-rc.1",
+      "track": "recommended"
+    },
+    {
+      "version": "0.1.2-rc.1",
+      "track": "legacy"
+    },
+    {
+      "version": "0.1.2-alpha.5",
+      "track": "preview"
+    },
+    {
+      "version": "0.1.2-alpha.2",
+      "track": "legacy"
+    }
   ]
 }

package/lib/client/ActivityPanel.js

@@ -410,7 +410,7 @@ function historicCardTeam(data, owner) {
         captainInbox: [],
     };
 }
-export function ActivityPanel({ sessionsList, modelDirectories, openMember, t }) {
+export function ActivityPanel({ sessionsList, modelDirectories, openMember, t, conversationVisible = true }) {
     // 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.
@@ -439,7 +439,7 @@ export function ActivityPanel({ sessionsList, modelDirectories, openMember, t })
         setOpen(false);
         setOpenOwner(undefined);
         window.requestAnimationFrame(() => {
-            document.querySelector('[data-composer-card] textarea')?.focus();
+            document.querySelector('[data-composer-card] [contenteditable="true"][role="textbox"], [data-composer-card] textarea')?.focus();
         });
     };
     const { teams, archivedTeams } = useSyncExternalStore(subscribeActivitySnapshots, getActivitySnapshotsSnapshot);
@@ -447,7 +447,7 @@ export function ActivityPanel({ sessionsList, modelDirectories, openMember, t })
     const currentRef = useRef(current);
     useEffect(() => { currentRef.current = current; }, [current]);
     const mountedAtRef = useRef(performance.now());
-    const expanded = activityPanelExpandedForSession(open, openOwner, current);
+    const expanded = conversationVisible && activityPanelExpandedForSession(open, openOwner, current);
     const geometry = useMemo(() => resolvePanelGeometry(layout, bounds), [layout, bounds]);
     const compact = compactPanelForBounds(bounds);
     const commitLayout = useCallback((next) => {
@@ -754,7 +754,7 @@ export function ActivityPanel({ sessionsList, modelDirectories, openMember, t })
         maxHeight: panelMaximumHeight(geometry, bounds),
         transform: `translate3d(${geometry.x}px, ${geometry.y}px, 0)`,
     };
-    if (!hasTeams && !expanded)
+    if (!conversationVisible || (!hasTeams && !expanded))
         return null;
     return (_jsxs(_Fragment, { children: [!expanded && (_jsx(CollapsedBadge, { count: visibleCount, busy: busy, t: t, onClick: () => {
                     if (current === undefined)

package/lib/client/index.js

@@ -5,7 +5,8 @@ import { agentTeamsCardDefinition } from "./agent-teams-card-definition.js";
 import { AGENT_TEAMS_LOCALE_NAMESPACE, en, zh, } from "./locales.js";
 import { openAgentTeamMember } from "./session-navigation.js";
 /** Required services: conversation nodes, slots, sessions navigation, and locale. */
-export const inject = ['uiConversation', 'slots', 'sessions', 'locale', 'modelDirectories'];
+export const inject = ['uiConversation', 'slots', 'sessions', 'locale', 'modelDirectories', 'layout'];
+const useLegacyPanelInfo = select => select({ activePanelId: null });
 /** The replayed user message is the canonical transcript entry. */
 function HiddenAgentTeamsCommand() {
     return null;
@@ -18,11 +19,16 @@ function HiddenAgentTeamsCommand() {
 export function apply(ctx) {
     ctx.effect(() => ctx.locale.register(AGENT_TEAMS_LOCALE_NAMESPACE, { zh, en }), 'agent-teams: dictionaries');
     const openMember = (parentId, childId) => {
-        void openAgentTeamMember(ctx.sessions, parentId, childId).catch((error) => {
+        void openAgentTeamMember(ctx.sessions, parentId, childId, ctx.layout).catch((error) => {
             console.warn(`agent-teams: failed to open member transcript ${childId}: ${String(error)}`);
         });
     };
-    const Panel = ({ t }) => (_jsx(ActivityPanel, { sessionsList: ctx.sessions.list, modelDirectories: ctx.modelDirectories, openMember: openMember, t: t }));
+    const Panel = ({ t, usePanelInfo }) => {
+        // A host's standard hook set is fixed for this mounted plugin instance.
+        const usePanel = usePanelInfo ?? useLegacyPanelInfo;
+        const conversationVisible = usePanel(panel => panel.activePanelId === null);
+        return (_jsx(ActivityPanel, { conversationVisible: conversationVisible, sessionsList: ctx.sessions.list, modelDirectories: ctx.modelDirectories, openMember: openMember, t: t }));
+    };
     ctx.slots.inject('shell.overlay', () => ctx.slots.register({
         name: 'shell.overlay',
         id: 'agent-teams-activity',

package/lib/client/session-navigation.js

@@ -5,17 +5,23 @@
  * Harness rc.8 intentionally removed cold subagents from the ordinary session
  * list. They must first be rediscovered in their parent's catalog, then opened
  * with the exact parent/child/mode address. Older runtimes have only `open()`;
- * the fallback preserves the plugin's rc.6 peer range.
+ * the fallback preserves ordinary-session navigation. New layouts also select
+ * the Conversation panel and cancel catalog refreshes superseded by navigation.
  */
-export async function openAgentTeamMember(sessions, parentSessionId, childSessionId) {
+export async function openAgentTeamMember(sessions, parentSessionId, childSessionId, layout) {
+    const navigation = layout?.beginNavigation?.();
     if (sessions.openSubagent === undefined || sessions.refreshSubagents === undefined) {
         sessions.open(childSessionId);
+        layout?.selectPanel?.(null);
         return 'session';
     }
     await sessions.refreshSubagents(parentSessionId);
+    if (navigation?.aborted)
+        return 'cancelled';
     const retained = sessions.subagentAddress?.(childSessionId);
     sessions.openSubagent(retained?.parentSessionId === parentSessionId
         ? retained
         : { parentSessionId, childSessionId, mode: 'continuable' });
+    layout?.selectPanel?.(null);
     return 'subagent';
 }

package/lib/client.js

@@ -2692,7 +2692,7 @@ window.__ModuleLoader__.load({
 				captainInbox: []
 			};
 		}
-		function ActivityPanel({ sessionsList, modelDirectories, openMember, t }) {
+		function ActivityPanel({ sessionsList, modelDirectories, openMember, t, conversationVisible = true }) {
 			const navigateToSession = (parentId, childId) => {
 				setOpen(false);
 				setWasActive(false);
@@ -2722,7 +2722,7 @@ window.__ModuleLoader__.load({
 				setOpen(false);
 				setOpenOwner(void 0);
 				window.requestAnimationFrame(() => {
-					document.querySelector("[data-composer-card] textarea")?.focus();
+					document.querySelector("[data-composer-card] [contenteditable=\"true\"][role=\"textbox\"], [data-composer-card] textarea")?.focus();
 				});
 			};
 			const { teams, archivedTeams } = (0, react.useSyncExternalStore)(subscribeActivitySnapshots, getActivitySnapshotsSnapshot);
@@ -2732,7 +2732,7 @@ window.__ModuleLoader__.load({
 				currentRef.current = current;
 			}, [current]);
 			const mountedAtRef = (0, react.useRef)(performance.now());
-			const expanded = activityPanelExpandedForSession(open, openOwner, current);
+			const expanded = conversationVisible && activityPanelExpandedForSession(open, openOwner, current);
 			const geometry = (0, react.useMemo)(() => resolvePanelGeometry(layout, bounds), [layout, bounds]);
 			const compact = compactPanelForBounds(bounds);
 			const commitLayout = (0, react.useCallback)((next) => {
@@ -3006,7 +3006,7 @@ window.__ModuleLoader__.load({
 				maxHeight: panelMaximumHeight(geometry, bounds),
 				transform: `translate3d(${geometry.x}px, ${geometry.y}px, 0)`
 			};
-			if (!hasTeams && !expanded) return null;
+			if (!conversationVisible || !hasTeams && !expanded) return null;
 			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [!expanded && (0, react_jsx_runtime.jsx)(CollapsedBadge, {
 				count: visibleCount,
 				busy,
@@ -3620,20 +3620,25 @@ window.__ModuleLoader__.load({
 		* Harness rc.8 intentionally removed cold subagents from the ordinary session
 		* list. They must first be rediscovered in their parent's catalog, then opened
 		* with the exact parent/child/mode address. Older runtimes have only `open()`;
-		* the fallback preserves the plugin's rc.6 peer range.
+		* the fallback preserves ordinary-session navigation. New layouts also select
+		* the Conversation panel and cancel catalog refreshes superseded by navigation.
 		*/
-		async function openAgentTeamMember(sessions, parentSessionId, childSessionId) {
+		async function openAgentTeamMember(sessions, parentSessionId, childSessionId, layout) {
+			const navigation = layout?.beginNavigation?.();
 			if (sessions.openSubagent === void 0 || sessions.refreshSubagents === void 0) {
 				sessions.open(childSessionId);
+				layout?.selectPanel?.(null);
 				return "session";
 			}
 			await sessions.refreshSubagents(parentSessionId);
+			if (navigation?.aborted) return "cancelled";
 			const retained = sessions.subagentAddress?.(childSessionId);
 			sessions.openSubagent(retained?.parentSessionId === parentSessionId ? retained : {
 				parentSessionId,
 				childSessionId,
 				mode: "continuable"
 			});
+			layout?.selectPanel?.(null);
 			return "subagent";
 		}
 		//#endregion
@@ -3644,8 +3649,10 @@ window.__ModuleLoader__.load({
 			"slots",
 			"sessions",
 			"locale",
-			"modelDirectories"
+			"modelDirectories",
+			"layout"
 		];
+		const useLegacyPanelInfo = (select) => select({ activePanelId: null });
 		/** The replayed user message is the canonical transcript entry. */
 		function HiddenAgentTeamsCommand() {
 			return null;
@@ -3661,16 +3668,19 @@ window.__ModuleLoader__.load({
 				en
 			}), "agent-teams: dictionaries");
 			const openMember = (parentId, childId) => {
-				openAgentTeamMember(ctx.sessions, parentId, childId).catch((error) => {
+				openAgentTeamMember(ctx.sessions, parentId, childId, ctx.layout).catch((error) => {
 					console.warn(`agent-teams: failed to open member transcript ${childId}: ${String(error)}`);
 				});
 			};
-			const Panel = ({ t }) => (0, react_jsx_runtime.jsx)(ActivityPanel, {
-				sessionsList: ctx.sessions.list,
-				modelDirectories: ctx.modelDirectories,
-				openMember,
-				t
-			});
+			const Panel = ({ t, usePanelInfo }) => {
+				return (0, react_jsx_runtime.jsx)(ActivityPanel, {
+					conversationVisible: (usePanelInfo ?? useLegacyPanelInfo)((panel) => panel.activePanelId === null),
+					sessionsList: ctx.sessions.list,
+					modelDirectories: ctx.modelDirectories,
+					openMember,
+					t
+				});
+			};
 			ctx.slots.inject("shell.overlay", () => ctx.slots.register({
 				name: "shell.overlay",
 				id: "agent-teams-activity",