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

package/README.md

@@ -22,7 +22,7 @@
 
 `dsh-agent-teams` turns the current DeepSeek Harness session into a captain that can assemble durable sub-agents, split a goal into dependency-aware tasks, and coordinate work through direct messages.
 
-Ask in natural language. The plugin provides the team protocol, eleven coordination tools, persistent state, an automatic shared-task scheduler, and a live Web UI—without requiring a separate workflow engine.
+Ask in natural language. The plugin provides the team protocol, 13 coordination tools, persistent state, an automatic shared-task scheduler, and a live Web UI—without requiring a separate workflow engine.
 
 <p align="center">
   <img src="./assets/ui.png" width="100%" alt="DeepSeek Harness conversation with the AgentTeams live activity panel, members, tasks, dependencies, and reports">
@@ -30,7 +30,7 @@ Ask in natural language. The plugin provides the team protocol, eleven coordinat
 
 ## Releases
 
-[v0.1.16-rc.1](./release-notes/v0.1.16-rc.1.md) is the release candidate for the npm `next` channel: a shared host adapter, exact compatibility matrix, real-host acceptance and release gates. Check [GitHub Releases](https://github.com/NanmiCoder/dsh-agent-teams/releases) for release availability and history.
+[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,77 +49,39 @@ The conversation card and activity panel use Harness's official locale service.
 
 ## Install and choose versions
 
-> [!IMPORTANT]
-> **0.1.16-rc.1 is a prerelease on the `next` track.** Use the exact version below for the supported 0.1.2 hosts. Plugin 0.1.15 targets Alpha.2; do not use a mutable `latest` tag as a compatibility guarantee. Check the actual running host and profile before updating either side.
+**Recommended pair: DeepSeek Harness `0.1.5-rc.1` + AgentTeams `0.1.17-rc.1`. Both are prereleases.**
 
-| Harness host | Candidate track | Installation rule |
+| Use case | DeepSeek Harness | AgentTeams plugin |
 | --- | --- | --- |
-| **0.1.2-rc.1** | Default acceptance target | There is currently no GA host. RC is still a prerelease; ordinary users should not have to follow Alpha. |
-| **0.1.2-alpha.5** | Opt-in preview | Select the exact version and lock the entire host dependency cohort. |
-| **0.1.2-alpha.2** | Retained legacy preview | Pinning the CLI alone can still resolve rc.1 transitive dependencies. |
-| Other versions, source HEAD, embedded Desktop cores | Outside the current matrix | Keep a known working exact pair or complete acceptance before adding a target. |
+| **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` |
 
-[compatibility.json](./compatibility.json) is the single source for development, PR checks and release gates. Plugin prereleases use `next`. Unsuffixed versions may use `latest` only after the recommended host and full supported matrix pass. Harness dist-tags belong to upstream; this project cannot change them, so installation instructions use exact versions.
-
-### Ordinary users: keep a matching host and plugin
-
-The recommended host installation target is:
+### 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
 ```
 
-Once the release is available, install the exact plugin version into the profile you actually use (`web` below):
-
-```sh
-dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.16-rc.1
-```
-
-Restart the actual Harness process after changing either side and refresh the browser. Updating a global CLI does not replace an embedded Desktop core or another source checkout. For an unpublished checkout, use the source build below.
-
-An exact npm CLI version can still contain broad transitive dependencies. Preserve a verified lockfile and inspect the actual installation. Do not delete credentials or `.agent-teams` data to address a version mismatch.
-
-### Build and verify this candidate
+Skip this if you already run this version. Alpha is opt-in: select an exact Alpha version from the table and lock all host dependencies as described in the [maintenance guide](./docs/maintenance-workflow.md).
 
-In a checkout containing this change:
-
-```sh
-pnpm install --frozen-lockfile
-pnpm typecheck
-pnpm build
-pnpm verify
-pnpm pack --out ./agent-teams-candidate.tgz
-```
+### 2. Install the AgentTeams plugin
 
-Inspect the actual host, then install the artifact into a separate test profile:
+Install into the `web` profile. Replace the profile name if needed:
 
 ```sh
-node scripts/doctor.mjs --host-root "/actual/host/package/directory" --json
-dsh plugin --profile agent-teams-preview add --save-exact /absolute/path/agent-teams-candidate.tgz
-node scripts/doctor.mjs --host-root "/actual/host/package/directory" --profile-root "/actual/test/profile/directory" --json
-dsh --profile agent-teams-preview --dump-config
-dsh web --profile agent-teams-preview
+dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.17-rc.1
 ```
 
-The doctor checks the DSH dependency cohort, duplicate runtime identities and the profile's plugin version. It reads package metadata without reading credentials or changing configuration. Passing it does not replace team, task and UI acceptance. Rebuild, repack and restart after source changes.
-
-### Developers: explicitly test Alpha
-
-Choose an exact Alpha version; `^0.1.2-alpha.2` does not mean “Alpha.2 only.” Development uses exact rc.1 packages, cohort-wide `pnpm.overrides` and a frozen lockfile. The runtime runner creates separate dependency cohorts, profiles and workspaces for Alpha.2, Alpha.5 and rc.1, installs the same candidate tgz, and checks actual resolution.
+**After installation, stop and restart Harness for that profile, then refresh the browser.**
 
-```sh
-node scripts/harness-runtime-verify.mjs \
-  --host-version 0.1.2-alpha.2 \
-  --artifact ./agent-teams-candidate.tgz \
-  --report-dir /tmp/agent-teams-alpha2-check
-```
-
-This developer command downloads the host into temporary directories without modifying existing user profiles. It uses deterministic model responses with the real CLI, plugin, sessions, tools and subagents. See the [maintenance workflow](./docs/maintenance-workflow.md) for coverage and release requirements.
+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).
 
-### Retaining an older host / rollback
+> 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).
 
-For the historical Harness `0.1.0-rc.8` + plugin `0.1.14` pair, pin both sides. This is not a compatibility claim for every older RC. Keep another already verified older pair until a complete migration is ready. Historical [Alpha.2 compatibility](./docs/alpha2-compatibility.md) and [acceptance](./docs/alpha2-release-acceptance.md) reports describe those specific releases, not the current matrix.
+See the full [compatibility matrix](./compatibility.json), [source installation and Alpha testing guide](./docs/maintenance-workflow.md), and [verification coverage and platform limits](./docs/maintenance-2026-09-06/release/README.md).
 
 Then ask for a team directly:
 
@@ -127,7 +89,7 @@ Then ask for a team directly:
 
 ## How it works
 
-1. The current session creates a team and becomes its captain.
+1. For a request to use AgentTeams, the captain follows the core protocol already in its system instructions. It continues an existing team and uses `agent_teams_status` when current state needs checking. When no team exists, the goal becomes a staged plan for review.
 2. The captain adds role-specific members backed by continuable sub-agents.
 3. The goal becomes tasks with owners and explicit dependencies.
 4. The shared scheduler uses real `running / idle / ready` state to atomically claim one ready task per idle member and wake it. An interrupted resident attempt stays parked and can resume through a direct message without losing its capability; after a cold process restart, the scheduler retries stranded open work with a fresh attempt.
@@ -138,6 +100,8 @@ Team state is stored under `<workspace>/.agent-teams/`; the Web panel reads that
 
 Member creation is zero-interaction by default: a member on the captain's current LLM route snapshots that provider, model, and reasoning effort, while a member on a requested alternative route snapshots the target model's default effort; later continuations restore the resolved snapshot. Only an explicit heterogeneous-team request (for example, “backend on provider A/model X, frontend on provider B/model Y”) supplies a member-specific `provider` + `model`; there is no per-member model or reasoning prompt.
 
+Captain sessions keep the concise core protocol and the original 13 native team tools from their first request. All business tools are directly available; no loading tool or extra activation call is needed. Configured profiles retain their bounded directory in the fixed system prompt. Creating, approving, continuing or ending a team does not rewrite the system prompt or tool schemas. Core rules remain available after history compaction or discarded code-mode tool results. Members receive four team tools, fixed member instructions, and their ordinary coding/research tools. Web approval wakes the captain with a control message; later member reports wake it again. See the [fixed protocol and benchmark contract](./docs/progressive-loading.md).
+
 ## Slash command
 
 No “use AgentTeams” phrasing required. The plugin registers the
@@ -152,7 +116,7 @@ command), describe the goal, and press Enter.
 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
+first model request follows the staged planning protocol without a mandatory helper call. The invocation is also durably
 logged (`command/run` / `command/done`).
 
 Surfaces without command adjudication (for example the headless CLI) get the
@@ -160,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

@@ -22,7 +22,7 @@
 
 `dsh-agent-teams` 让当前 DeepSeek Harness 会话成为队长：创建可续聊的子 Agent、把目标拆成有依赖的任务，并通过直达消息协调成员工作。
 
-你只需用自然语言提出目标。插件会提供团队协议、11 个协作工具、持久化状态、自动共享任务调度和实时 Web UI，不需要额外的 Workflow 引擎。
+你只需用自然语言提出目标。插件会提供精简的固定团队协议、13 个业务工具、持久化状态、自动共享任务调度和实时 Web UI，不需要额外的 Workflow 引擎。
 
 <p align="center">
   <img src="./assets/ui.png" width="100%" alt="DeepSeek Harness 对话与 AgentTeams 实时活动面板，展示成员、任务依赖和回报">
@@ -30,7 +30,7 @@
 
 ## 版本更新
 
-[v0.1.16-rc.1](./release-notes/v0.1.16-rc.1.md) 是 npm `next` 渠道的发布候选：统一宿主兼容层、精确版本矩阵、真实宿主验收和发布门禁。发布状态与历史见 [GitHub Releases](https://github.com/NanmiCoder/dsh-agent-teams/releases)。
+[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,82 +48,46 @@
 
 ## 安装与版本选择
 
-> [!IMPORTANT]
-> **0.1.16-rc.1 是 `next` 渠道的预发布版本。** 对当前支持的 0.1.2 宿主，请使用下方精确插件版本。0.1.15 面向 Alpha.2，不能把可变的 `latest` 标签当作兼容保证。请先核对实际运行的宿主和 profile，再更新两端。
+**推荐组合：DeepSeek Harness `0.1.5-rc.1` + AgentTeams `0.1.17-rc.1`。两者均为预发布版本。**
 
-| Harness 宿主 | 本次候选的定位 | 使用原则 |
+| 使用场景 | DeepSeek Harness | AgentTeams 插件 |
 | --- | --- | --- |
-| **0.1.2-rc.1** | 普通用户默认验收目标 | 当前没有 GA；RC 仍是预发布，但不再要求普通用户跟随 Alpha。 |
-| **0.1.2-alpha.5** | 主动选择的预览版本 | 明确指定版本，并锁定整组宿主依赖。 |
-| **0.1.2-alpha.2** | 保留兼容的旧预览版本 | 单锁 CLI 不够，间接依赖可能被解析成 rc.1。 |
-| 其他版本、源码 HEAD、Desktop 内置核心 | 不在当前支持清单中 | 保留已工作的精确组合，或单独完成验收后加入清单。 |
+| **推荐安装** | **`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` |
 
-宿主矩阵只有一个来源：[compatibility.json](./compatibility.json)。开发、PR 验证和发布门禁都读取它。插件预发布版本统一发到 `next`；无后缀版本只有在推荐宿主与完整矩阵验收通过后才可以进入 `latest`。上游 Harness 的 npm 标签由上游维护，本项目不能修改它；我们的安装说明使用精确版本。
-
-### 普通用户：固定匹配的宿主与插件
-
-推荐宿主安装目标为：
+### 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
 ```
 
-确认发行版本可用后，在实际使用的 profile 中安装精确插件版本（以下以 `web` 为例）：
-
-```sh
-dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.16-rc.1
-```
-
-宿主或插件更新后，停止并重启实际运行的 Harness，再刷新浏览器。全局 CLI 升级不会更换 Desktop 内置核心，也不会更新另一个源码工作区。尚未发布的 checkout 可使用下方源码构建方式。
-
-npm 的精确 CLI 版本仍可能包含宽范围间接依赖。升级时保留已验证的锁文件，对实际安装路径运行诊断；不要通过删除凭据或 `.agent-teams` 来处理版本错配。
+已有该版本可跳过。Alpha 仅供主动测试：手动指定表中的 Alpha 版本，并按[维护指南](./docs/maintenance-workflow.md)锁定整组宿主依赖。
 
-### 从源码验证本次候选
+### 2. 安装 AgentTeams 插件
 
-在包含本次改动的插件 checkout 中：
+安装到 `web` profile；使用其他 profile 时替换名称：
 
 ```sh
-pnpm install --frozen-lockfile
-pnpm typecheck
-pnpm build
-pnpm verify
-pnpm pack --out ./agent-teams-candidate.tgz
+dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.17-rc.1
 ```
 
-先检查实际宿主的依赖，再在独立测试 profile 安装产物：
+**安装后，停止并重新启动该 profile 的 Harness 进程，再刷新浏览器。**
 
-```sh
-node scripts/doctor.mjs --host-root "/实际运行的宿主包目录" --json
-dsh plugin --profile agent-teams-preview add --save-exact /完整路径/agent-teams-candidate.tgz
-node scripts/doctor.mjs --host-root "/实际运行的宿主包目录" --profile-root "/实际测试profile目录" --json
-dsh --profile agent-teams-preview --dump-config
-dsh web --profile agent-teams-preview
-```
-
-`doctor` 检查整组 DSH 包版本、重复运行时身份以及 profile 中的插件版本。它只读文件，不读取凭据、不修改配置；检查通过不替代实际建队、任务执行和 UI 验收。源码更改后需要重新构建、打包和重启。
-
-### 开发者：显式测试 Alpha
+插件预发布使用 npm `next`，请使用上面的精确版本命令；`latest` 不是这组宿主的推荐安装入口。源码安装见[维护指南](./docs/maintenance-workflow.md)，验证范围见[本版验收记录](./docs/releases/v0.1.17-rc.1/README.md)。
 
-Alpha 需要明确指定版本，不能用一个 `^0.1.2-alpha.2` 表达“只接受 Alpha.2”。本仓库开发依赖通过精确版本、整组 `pnpm.overrides` 和 frozen lockfile 固定到 rc.1；自动验收会为 Alpha.2、Alpha.5 和 rc.1 分别创建独立安装闭包、profile 与工作区，安装同一份 tgz，并核对真实解析结果。
+> Desktop 用户需核对应用内置的 Harness 核心；全局 CLI 升级不会升级桌面内核。旧 `0.1.0-*` / `0.1.1-*` 或其他未列出的宿主，请先保留已工作的组合，参考[旧版本与诊断指引](./docs/maintenance-workflow.md)。
 
-```sh
-node scripts/harness-runtime-verify.mjs \
-  --host-version 0.1.2-alpha.2 \
-  --artifact ./agent-teams-candidate.tgz \
-  --report-dir /tmp/agent-teams-alpha2-check
-```
-
-这是会创建临时目录并下载宿主的开发验收命令，不会修改已有用户 profile。模型适配器使用固定测试响应；CLI、插件、会话、工具与子代理使用真实宿主实现。完整范围和发布流程见[维护流程](./docs/maintenance-workflow.md)。
-
-### 保留旧宿主 / 回退
-
-对于历史组合 Harness `0.1.0-rc.8` + 插件 `0.1.14`，应固定两端版本；不能据此推断所有旧 RC 都兼容。已使用其他已验证旧组合的用户先保留该组合。历史 [Alpha.2 兼容记录](./docs/alpha2-compatibility.md)和[验收报告](./docs/alpha2-release-acceptance.md)只描述当时版本，不覆盖当前清单。
+完整[兼容清单](./compatibility.json)、[源码安装与 Alpha 验证](./docs/maintenance-workflow.md)、[已验证范围与平台限制](./docs/maintenance-2026-09-06/release/README.md)。
 
 接着直接用自然语言拉团队：
 
 > 使用 AgentTeams 审查 v0.5.3 之后的提交，分别从性能、安全和产品角度分工，最后输出一份汇总报告。
 
+队长会话从第一轮起保留精简的固定核心协议和原有 13 个业务工具，直接调用，无需额外的加载工具或激活调用。已配置模板的精简目录固定保留。创建、批准、继续或结束团队都不会改写系统提示词和工具 schema，会话压缩或代码模式丢弃工具结果也不会丢失核心规则。成员保留四个团队工具、固定成员说明及普通编程/研究工具。Web 批准后会通知并唤醒队长，后续成员报告会再次唤醒它，无需忙轮询。详见[固定协议与 benchmark 标准](./docs/progressive-loading.md)。
+
 ## 工作方式
 
 1. 当前会话创建团队并成为队长。
@@ -172,6 +136,7 @@ node scripts/harness-runtime-verify.mjs \
 - 一个队长同一时间只能带一个活动团队。
 - 没有开放任务的空闲成员会自动续领就绪任务；仍持有开放 attempt 的空闲成员会停驻，队长可发消息让其沿用原 attempt 继续，或显式转派；冷重启遗留的开放任务才会生成新 attempt。暂时无法实时投递的消息会持久保存在邮箱中并在后续状态边界重投。
 - 状态使用文件持久化，并在单个 DSH 进程内串行操作；多个进程同时修改同一团队不保证一致。
+- 历史面板依赖保存的团队状态或归档；早期版本删除团队时未保留归档的会话，暂不支持从日志重建完整面板。
 - 活动面板如实展示持久化状态；模型偶尔可能完成工作却没有按协议更新任务状态。
 
 完整工具列表、状态模型、Web UI 行为、配置与已知限制见 [docs/usage.md](./docs/usage.md)。
@@ -207,7 +172,7 @@ pnpm verify
 
 在 `cordis.patch.yml` 的 `profiles` 中配置完整团队模板。每个 profile 都提供成员阵容，可独立指定 provider、model、role、reasoning_effort。`taskPlanning: captain` 表示只提供阵容和约束，由 Captain 根据用户目标设计 DAG；省略该字段或设为 `seed` 时，展开模板中的固定任务图。使用 `/agent-teams --profile <名称> <目标>` 显式激活；不会把首个普通 token 隐式识别为 profile。
 
-普通 `/agent-teams` 流程会调用 `agent_teams_create({ profile, approval: "required" })`：只落盘可编辑的成员占位和 DAG，不创建子会话、不领取任务。成员模型和推理等级直接读取 Harness 的模型目录。「返回对话修改」会终止仍在运行的规划轮次，让队长先追问修改方向，再用一次原子操作更新同一份草案；「放弃本次计划」经二次确认后会归档草案、中止轮次，并向模型注入不得自动重建团队的控制上下文。只有点击「确认并启动团队」才会按最终配置原子创建成员并启动就绪任务。运行中团队的停止入口位于该团队的面板标题，点击后需要二次确认，不再占用输入区域。直接工具调用方可显式传 `approval: "automatic"` 保留旧的立即执行路径。审查或测试失败不会解锁下游；自动 repair/review 不依赖 failed review。
+普通 `/agent-teams` 流程继续已有团队，按需调用 `agent_teams_status` 确认状态；仅在没有当前团队时调用 `agent_teams_create({ profile, approval: "required" })`：只落盘可编辑的成员占位和 DAG，不创建子会话、不领取任务。成员模型和推理等级直接读取 Harness 的模型目录。「返回对话修改」会终止仍在运行的规划轮次，让队长先追问修改方向，再用一次原子操作更新同一份草案；「放弃本次计划」经二次确认后会归档草案、中止轮次，并向模型注入不得自动重建团队的控制上下文。只有点击「确认并启动团队」才会按最终配置原子创建成员并启动就绪任务。运行中团队的停止入口位于该团队的面板标题，点击后需要二次确认，不再占用输入区域。直接工具调用方可显式传 `approval: "automatic"` 保留旧的立即执行路径。审查或测试失败不会解锁下游；自动 repair/review 不依赖 failed review。
 
 ## 许可证
 

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/capabilities.js

@@ -0,0 +1,106 @@
+import { readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { readTeamSync, readRetiredMemberIdsSync } from "./state.js";
+import { MEMBER_TOOL_NAMES, TEAM_TOOL_NAMES } from "./tool-names.js";
+export const TEAM_ACTIVATION_PROMPT = 'AgentTeams (Agent Teams) provides multi-agent team collaboration. Apply these rules when the user requests it (including /agent-teams) or when continuing an existing team. Mentioning, quoting, discussing, or declining AgentTeams alone is not a request to start work.';
+export const TEAM_MEMBER_PROMPT = 'You are an AgentTeams member. Follow your assigned member persona and task contract. Use agent_teams_claim_task, agent_teams_update_task, agent_teams_send_message and agent_teams_status for your own work. Include the current attempt_id in updates; report completion or failure to the captain. Do not create, approve, edit or resume a team. If your durable membership is unavailable, report that to the parent instead of creating a replacement.';
+function stateRoot(agent, config) {
+    return join(agent.session.header.cwd ?? process.cwd(), config.stateDir);
+}
+/** Synchronous startup/HMR hydration must finish before the first assembly. */
+function currentTeam(agent, config) {
+    const root = stateRoot(agent, config);
+    let entries;
+    try {
+        entries = readdirSync(root, { withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+    let found;
+    for (const entry of entries) {
+        if (!entry.isDirectory() || entry.name === 'archive')
+            continue;
+        const team = readTeamSync(root, entry.name);
+        if (team === undefined || (team.captainSessionId !== agent.id
+            && !team.members.some(member => member.id === agent.id)))
+            continue;
+        if (found !== undefined)
+            throw new Error('ambiguous AgentTeams membership');
+        found = team;
+    }
+    return found;
+}
+/** Call once, after all business definitions have registered. Never per member. */
+export function installTeamCapabilities(ctx, config) {
+    const states = new WeakMap();
+    const active = new Set();
+    let mounted = true;
+    // Snapshot policy once: profiles, team state, and tool results must never
+    // rewrite this prefix or control whether core instructions are available.
+    const captainPrompt = `${TEAM_ACTIVATION_PROMPT}\n\n${config.captainPrompt()}`;
+    function attach(agent) {
+        const prior = states.get(agent);
+        if (prior !== undefined)
+            return prior;
+        if (!mounted)
+            throw new Error('AgentTeams capability provider is disposed');
+        // Determine a member's role before its first request and retain it for the
+        // lifetime of this scope. Team creation/archive must never rewrite the
+        // captain's system/tools prefix, even after a long ordinary conversation.
+        let member = config.isPendingMember(agent);
+        try {
+            member ||= readRetiredMemberIdsSync(stateRoot(agent, config)).has(agent.id);
+            const team = currentTeam(agent, config);
+            member ||= team !== undefined && team.captainSessionId !== agent.id;
+        }
+        catch (error) {
+            // Unrelated damaged state must not disable ordinary conversation.
+            // Business tools still validate durable team state before acting.
+            ctx.logger.warn(`agent-teams: capability hydration failed: ${String(error)}`);
+        }
+        const state = { member, dispose: () => undefined };
+        let revoke;
+        let disposed = false;
+        let releaseLifetime;
+        state.dispose = () => {
+            if (disposed)
+                return;
+            disposed = true;
+            revoke?.();
+            releaseLifetime?.();
+            states.delete(agent);
+            active.delete(state);
+        };
+        states.set(agent, state);
+        active.add(state);
+        try {
+            if (member)
+                revoke = agent.ctx.tools.restrict({
+                    deny: TEAM_TOOL_NAMES.filter(name => !MEMBER_TOOL_NAMES.includes(name)),
+                });
+            releaseLifetime = agent.ctx.effect(() => state.dispose, 'agent-teams: capability lifetime');
+            return state;
+        }
+        catch (error) {
+            state.dispose();
+            throw error;
+        }
+    }
+    ctx.systemPrompt.section({
+        name: 'agent-teams:usage', order: config.order ?? 117,
+        text: ({ agent }) => {
+            return agent !== undefined && states.get(agent)?.member ? TEAM_MEMBER_PROMPT : captainPrompt;
+        },
+    });
+    ctx.on('agent/session-start', ({ agent }) => { attach(agent); });
+    ctx.effect(() => () => {
+        mounted = false;
+        for (const state of [...active])
+            state.dispose();
+    }, 'agent-teams: capability scopes');
+    for (const agent of ctx.agents.list())
+        attach(agent);
+}

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",