@nanmicoder/dsh-agent-teams 0.1.11 → 0.1.13

package/lib/index.js

@@ -44,9 +44,9 @@ function usageSectionText(toolNames) {
 1. Call agent_teams_create with a team name and the goal as description. You become the captain and may lead one team at a time.
 2. Call agent_teams_add_member once per role the goal needs (researcher, engineer, reviewer, ...). Members are durable subagents: they wait for your messages, then work a full turn. By default a member on your current provider/model snapshots your current reasoning effort; a member routed to a different provider or model automatically uses that target model's default effort. Never ask the user to choose these per member; only pass provider/model when the user explicitly requests a different route for that role, and reasoning_effort only when the user explicitly requests a particular effort ("default" explicitly selects the target model's default).
 3. Break the goal into tasks with agent_teams_create_task and wire dependencies. Assign role-specific work when useful; unassigned ready work belongs to the shared pool. The scheduler automatically claims one ready task for each truly idle member and wakes it, including across later rounds.
-4. Lead by delegation: monitor with agent_teams_status, send guidance with agent_teams_send_message, and let idle teammates execute ready work. Do not duplicate a teammate's work merely because its turn is slow.
-5. If work is blocked, stale, or needs takeover, always call agent_teams_reassign_task first. Reassign to another idle member, or use assignee=captain before doing it yourself. Reassignment revokes the old attempt and waits for that member to quiesce, preventing late results from overwriting the new attempt.
-6. Tasks carry attempt_id capabilities. Members must use the current attempt_id for updates; stale-attempt errors mean ownership changed. Poll status until every required task is terminal and every member is idle/ready.
+4. Lead by delegation: monitor with agent_teams_status, send guidance with agent_teams_send_message, and let idle teammates execute ready work. Do not duplicate a teammate's work merely because its turn is slow. If the user requires every member to contribute or report, create one task per required contribution (or message each member directly); never wait for an unassigned member to produce work it was never given.
+5. If the user explicitly asks to pause a running member, its open attempt remains parked after interruption; after answering the user, send that same member guidance with agent_teams_send_message so it continues the same attempt. Do not interrupt members for an ordinary user question that did not request a pause. If work must change owner, restart from scratch, or be taken over, call agent_teams_reassign_task first. Reassign to another idle member, retry with the same member, or use assignee=captain before doing it yourself. Reassignment revokes the old attempt and waits for that member to quiesce, preventing late results from overwriting the new attempt.
+6. Tasks carry attempt_id capabilities. Members must use the current attempt_id for updates; stale-attempt errors mean ownership changed. Check status after progress notifications until every required task is terminal and every member is idle/ready; do not busy-poll or require reports from members with no assigned work.
 7. Present the team's results to the user, then agent_teams_delete the team unless the user wants to keep working with it.
 
 Tools: ${toolNames}`;

package/lib/scheduler.js

@@ -5,7 +5,10 @@
  * continuable agents instead expose explicit idle/running edges, so this
  * scheduler closes the same loop without keeping a polling turn alive: every
  * idle edge and every task-graph mutation attempts one atomic claim and wakes
- * the selected durable member.
+ * the selected durable member. A resident member that becomes idle while it
+ * still owns an open attempt is parked: only an explicit captain reassignment
+ * may rotate that capability. Automatic retry is reserved for cold recovery,
+ * when the durable owner is no longer resident in the live Agent registry.
  * @module dsh-agent-teams/scheduler
  */
 import { join } from 'node:path';
@@ -22,8 +25,11 @@ function liveCaptain(ctx, captainSessionId, supplied) {
         return supplied;
     return ctx.agents.get(captainSessionId);
 }
+function liveMember(ctx, member) {
+    return ctx.agents.get(member.id);
+}
 function isMemberAvailable(ctx, member) {
-    const live = ctx.agents.get(member.id);
+    const live = liveMember(ctx, member);
     return live === undefined || live.status === 'idle';
 }
 function ownedOpenTask(tasks, memberName) {
@@ -59,6 +65,13 @@ function fallbackMailboxPrompt(messages) {
 /** Install one scheduler and its member activity observer. */
 export function installTeamScheduler(ctx, config) {
     const memberQueues = new Map();
+    // An idle edge in this process proves that the resident member ended its
+    // turn while the current attempt was still open. Remember that capability
+    // even after Harness disposes the continuable AgentHandle: later status or
+    // graph kicks must keep it parked. A cold process starts with an empty map,
+    // so durable open attempts are still recovered after restart.
+    const parkedAttempts = new Map();
+    const memberQueueKey = (stateRoot, teamId, memberName) => (`${stateRoot}\u0000${teamId}\u0000${memberName}`);
     const serializeMember = async (key, operation) => {
         const previous = memberQueues.get(key) ?? Promise.resolve();
         let release;
@@ -92,7 +105,7 @@ export function installTeamScheduler(ctx, config) {
         },
         async kickMember(workspace, teamId, memberName, suppliedCaptain) {
             const stateRoot = stateRootOf(workspace, config);
-            const queueKey = `${stateRoot}\u0000${teamId}\u0000${memberName}`;
+            const queueKey = memberQueueKey(stateRoot, teamId, memberName);
             await serializeMember(queueKey, async () => {
                 let team = await readTeam(stateRoot, teamId);
                 if (team === undefined)
@@ -124,12 +137,20 @@ export function installTeamScheduler(ctx, config) {
                     const currentMember = fresh.members.find(candidate => candidate.name === memberName && candidate.status !== 'removed');
                     if (currentMember === undefined || currentMember.id === '' || !isMemberAvailable(ctx, currentMember))
                         return undefined;
-                    // An idle/ready member that still owns an open task lost the turn
-                    // that was executing it (model stopped early, interrupt settlement,
-                    // or process restart). Retry that task with a fresh capability
-                    // instead of permanently treating the durable claim as "busy".
-                    const task = ownedOpenTask(fresh.tasks, currentMember.name)
-                        ?? nextReadyTask(fresh.tasks, currentMember.name);
+                    const owned = ownedOpenTask(fresh.tasks, currentMember.name);
+                    // A resident idle member can intentionally leave an attempt open
+                    // while waiting for guidance, or because the user paused its turn.
+                    // Re-dispatching here would revoke still-valid work on every idle
+                    // edge and every status kick. The idle observer remembers that exact
+                    // capability across normal continuable disposal; only an unobserved
+                    // durable capability (cold process recovery) or a legacy open task
+                    // with no capability is retried.
+                    const parkedAttemptId = parkedAttempts.get(currentMember.id);
+                    const recoverOwned = owned !== undefined
+                        && (owned.attemptId === undefined || owned.attemptId !== parkedAttemptId);
+                    const task = recoverOwned ? owned : owned === undefined
+                        ? nextReadyTask(fresh.tasks, currentMember.name)
+                        : undefined;
                     if (task === undefined) {
                         if (currentMember.status !== 'idle') {
                             currentMember.status = 'idle';
@@ -139,6 +160,7 @@ export function installTeamScheduler(ctx, config) {
                     }
                     const previousAssignee = task.assignee;
                     const attemptId = beginTaskAttempt(task, currentMember.name);
+                    parkedAttempts.delete(currentMember.id);
                     currentMember.status = 'working';
                     await writeTeam(stateRoot, fresh);
                     return {
@@ -184,17 +206,33 @@ export function installTeamScheduler(ctx, config) {
         const workspace = agent.session.header.cwd ?? process.cwd();
         const stateRoot = stateRootOf(workspace, config);
         const located = await findTeamByParticipant(stateRoot, agent.id);
-        if (located === undefined || located.captainSessionId === agent.id)
+        if (located === undefined) {
+            parkedAttempts.delete(agent.id);
+            return;
+        }
+        if (located.captainSessionId === agent.id)
             return;
         const member = located.members.find(candidate => candidate.id === agent.id && candidate.status !== 'removed');
-        if (member === undefined)
+        if (member === undefined) {
+            parkedAttempts.delete(agent.id);
             return;
+        }
         await withTeamLock(teamLockKey(stateRoot, located.id), async () => {
             const fresh = await readTeam(stateRoot, located.id);
             const current = fresh?.members.find(candidate => candidate.id === agent.id && candidate.status !== 'removed');
             if (fresh === undefined || current === undefined)
                 return;
             const next = status === 'running' ? 'working' : 'idle';
+            if (next === 'idle') {
+                const owned = ownedOpenTask(fresh.tasks, current.name);
+                if (owned?.attemptId === undefined)
+                    parkedAttempts.delete(agent.id);
+                else
+                    parkedAttempts.set(agent.id, owned.attemptId);
+            }
+            else {
+                parkedAttempts.delete(agent.id);
+            }
             if (current.status === next)
                 return;
             current.status = next;

package/lib/types/client/ActivityPanel.d.ts

@@ -16,12 +16,14 @@
  * always-available monitor.
  * @module dsh-agent-teams/client/activity
  */
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { ObservableSnapshot, SessionListState } from '@deepseek-ai/dsh-client-runtime/client';
 /** 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 declare function ActivityPanel({ sessionsList, openMember }: {
+export type ActivityPanelProps = {
     readonly sessionsList: ObservableSnapshot<SessionListState>;
     readonly openMember: (parentId: SessionId, childId: SessionId) => void;
-}): import("react").JSX.Element | null;
+} & PropsLocale<'agentTeams'>;
+export declare function ActivityPanel({ sessionsList, openMember, t }: ActivityPanelProps): import("react").JSX.Element | null;

package/lib/types/client/AgentTeamsCard.d.ts

@@ -20,4 +20,4 @@ export interface AgentTeamsCardInjected {
 /** Complete keyed Chat renderer props. */
 export type AgentTeamsCardProps = PropsRuntime<'conversation.chat.node', 'agent-teams'> & PropsLocale<'agentTeams'> & AgentTeamsCardInjected;
 /** Render one durable team as a compact conversation card. */
-export declare function AgentTeamsCard({ node, openMember, sessionId }: AgentTeamsCardProps): import("react").JSX.Element;
+export declare function AgentTeamsCard({ node, openMember, sessionId, t }: AgentTeamsCardProps): import("react").JSX.Element;

package/lib/types/client/activity-monitor.d.ts

@@ -71,6 +71,13 @@ export declare function getActivitySnapshotsSnapshot(): ActivitySnapshots;
 export declare function updateActivitySnapshots(update: Partial<ActivitySnapshots>): void;
 /** Poll cadence for the live host snapshot route. */
 export declare const ACTIVITY_POLL_MS = 1000;
+/**
+ * Low-frequency probe cadence while a cardless discovery session still owns
+ * no team. The probe keeps the panel able to pick up a team created later in
+ * that session (e.g. a run_code-wrapped agent_teams_create) without turning
+ * every ordinary session into a one-second filesystem scan.
+ */
+export declare const ACTIVITY_PROBE_MS = 5000;
 /** Host route serving live and archived team snapshots. */
 export declare const ACTIVITY_STATE_URL = "/plugins/dsh-agent-teams/state";
 interface ActivityFetchResponse {
@@ -105,12 +112,17 @@ export interface ActivityPollingController {
  * Start the single polling loop for the current session's requested targets.
  *
  * 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.
+ * Explicit card targets poll at the live cadence from the start. A discovery
+ * session performs an immediate live+archive restore pass, then — while it
+ * still owns no team — probes on a low-frequency cadence, so a team created
+ * later in that session (e.g. a run_code-wrapped agent_teams_create) is
+ * discovered without a manual reload, without turning every ordinary session
+ * into a one-second filesystem scan. The moment a team for the discovery
+ * session appears, the controller upgrades to the live one-second cadence for
+ * the rest of its lifetime. The caller — the session view, which stops the
+ * controller when the session is no longer current — bounds the lifetime, and
+ * archive state is refreshed when a target or a previously discovered live
+ * team disappears.
  */
 export declare function startActivityPolling(monitorTargets: readonly ActivityMonitorTarget[], runtime?: ActivityPollingRuntime): ActivityPollingController;
 export {};

package/lib/types/client/index.d.ts

@@ -1,6 +1,13 @@
 /** Browser plugin for the AgentTeams activity floater and conversation card. */
 import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
-/** Required services: conversation nodes, slots, and sessions navigation. */
+import { type AgentTeamsLocaleKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** AgentTeams conversation card and activity monitor copy. */
+        agentTeams: AgentTeamsLocaleKey;
+    }
+}
+/** Required services: conversation nodes, slots, sessions navigation, and locale. */
 export declare const inject: string[];
 /**
  * Register the activity monitor in the shell's additive overlay and the

package/lib/types/client/locales.d.ts

@@ -0,0 +1,169 @@
+/** `agentTeams` namespace dictionaries for every plugin-owned Web surface. */
+/** Dictionary namespace owned by the AgentTeams client plugin. */
+export declare const AGENT_TEAMS_LOCALE_NAMESPACE = "agentTeams";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'card.memberCount': string;
+    'action.openActivityPanel': string;
+    'activity.panelButton': string;
+    'activity.badgeAria': string;
+    'activity.panelAria': string;
+    'activity.title': string;
+    'activity.float': string;
+    'activity.dockRight': string;
+    'activity.collapse': string;
+    'activity.empty': string;
+    'format.listSeparator': string;
+    'task.status.pending': string;
+    'task.status.claimed': string;
+    'task.status.inProgress': string;
+    'task.status.completed': string;
+    'task.status.failed': string;
+    'task.status.cancelled': string;
+    'member.state.working': string;
+    'member.state.failed': string;
+    'member.state.waiting': string;
+    'member.state.delivered': string;
+    'member.state.left': string;
+    'member.state.removed': string;
+    'member.state.pending': string;
+    'member.state.unassigned': string;
+    'member.status.executing': string;
+    'member.status.working': string;
+    'member.status.waitingOn': string;
+    'member.status.waitingPrerequisite': string;
+    'member.status.waitingAssignment': string;
+    'member.status.delivered': string;
+    'member.status.idle': string;
+    'member.status.unknown': string;
+    'task.assignee.unclaimed': string;
+    'task.summary.waitingBreakdown': string;
+    'task.summary.allDelivered': string;
+    'task.summary.blockedAndRunning': string;
+    'task.summary.more': string;
+    'task.summary.running': string;
+    'task.summary.ready': string;
+    'task.summary.blocked': string;
+    'task.summary.waitingSchedule': string;
+    'progress.aria': string;
+    'progress.title': string;
+    'progress.running': string;
+    'progress.blocked': string;
+    'progress.delivered': string;
+    'dependency.aria': string;
+    'dependency.parallel': string;
+    'dependency.title': string;
+    'dependency.hint.parallel': string;
+    'dependency.hint.chain': string;
+    'dependency.hint.pinned': string;
+    'task.runningAria': string;
+    'task.detail.completed': string;
+    'task.detail.noPrerequisite': string;
+    'task.detail.ready': string;
+    'task.detail.waitingOn': string;
+    'task.detail.noDownstream': string;
+    'task.detail.unlocks': string;
+    'team.ended': string;
+    'team.stats.members': string;
+    'team.stats.completed': string;
+    'team.stats.messages': string;
+    'delegation.aria': string;
+    'captain.name': string;
+    'captain.role': string;
+    'captain.summary': string;
+    'captain.state.working': string;
+    'captain.state.collected': string;
+    'captain.state.waiting': string;
+    'members.toggle': string;
+    'members.collapse': string;
+    'members.expand': string;
+    'members.empty': string;
+    'assignment.label': string;
+    'assignment.empty': string;
+    'archive.label': string;
+};
+/** AgentTeams namespace key union. */
+export type AgentTeamsLocaleKey = keyof typeof zh;
+/** English dictionary, checked complete against the Chinese source key set. */
+export declare const en: {
+    'card.memberCount': string;
+    'action.openActivityPanel': string;
+    'activity.panelButton': string;
+    'activity.badgeAria': string;
+    'activity.panelAria': string;
+    'activity.title': string;
+    'activity.float': string;
+    'activity.dockRight': string;
+    'activity.collapse': string;
+    'activity.empty': string;
+    'format.listSeparator': string;
+    'task.status.pending': string;
+    'task.status.claimed': string;
+    'task.status.inProgress': string;
+    'task.status.completed': string;
+    'task.status.failed': string;
+    'task.status.cancelled': string;
+    'member.state.working': string;
+    'member.state.failed': string;
+    'member.state.waiting': string;
+    'member.state.delivered': string;
+    'member.state.left': string;
+    'member.state.removed': string;
+    'member.state.pending': string;
+    'member.state.unassigned': string;
+    'member.status.executing': string;
+    'member.status.working': string;
+    'member.status.waitingOn': string;
+    'member.status.waitingPrerequisite': string;
+    'member.status.waitingAssignment': string;
+    'member.status.delivered': string;
+    'member.status.idle': string;
+    'member.status.unknown': string;
+    'task.assignee.unclaimed': string;
+    'task.summary.waitingBreakdown': string;
+    'task.summary.allDelivered': string;
+    'task.summary.blockedAndRunning': string;
+    'task.summary.more': string;
+    'task.summary.running': string;
+    'task.summary.ready': string;
+    'task.summary.blocked': string;
+    'task.summary.waitingSchedule': string;
+    'progress.aria': string;
+    'progress.title': string;
+    'progress.running': string;
+    'progress.blocked': string;
+    'progress.delivered': string;
+    'dependency.aria': string;
+    'dependency.parallel': string;
+    'dependency.title': string;
+    'dependency.hint.parallel': string;
+    'dependency.hint.chain': string;
+    'dependency.hint.pinned': string;
+    'task.runningAria': string;
+    'task.detail.completed': string;
+    'task.detail.noPrerequisite': string;
+    'task.detail.ready': string;
+    'task.detail.waitingOn': string;
+    'task.detail.noDownstream': string;
+    'task.detail.unlocks': string;
+    'team.ended': string;
+    'team.stats.members': string;
+    'team.stats.completed': string;
+    'team.stats.messages': string;
+    'delegation.aria': string;
+    'captain.name': string;
+    'captain.role': string;
+    'captain.summary': string;
+    'captain.state.working': string;
+    'captain.state.collected': string;
+    'captain.state.waiting': string;
+    'members.toggle': string;
+    'members.collapse': string;
+    'members.expand': string;
+    'members.empty': string;
+    'assignment.label': string;
+    'assignment.empty': string;
+    'archive.label': string;
+};
+/** Translation function consumed by pure view helpers. */
+export type AgentTeamsTranslate = (key: AgentTeamsLocaleKey, params?: Record<string, unknown>) => string;

package/lib/types/scheduler.d.ts

@@ -5,7 +5,10 @@
  * continuable agents instead expose explicit idle/running edges, so this
  * scheduler closes the same loop without keeping a polling turn alive: every
  * idle edge and every task-graph mutation attempts one atomic claim and wakes
- * the selected durable member.
+ * the selected durable member. A resident member that becomes idle while it
+ * still owns an open attempt is parked: only an explicit captain reassignment
+ * may rotate that capability. Automatic retry is reserved for cold recovery,
+ * when the durable owner is no longer resident in the live Agent registry.
  * @module dsh-agent-teams/scheduler
  */
 import type { Context } from '@deepseek-ai/cordis';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanmicoder/dsh-agent-teams",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "AgentTeams for DeepSeek Harness: multi-agent team collaboration (captain, members, tasks with dependencies, messaging) driven by natural language, with a tree monitor in the web GUI",
   "type": "module",
   "main": "lib/index.js",

package/release-notes/v0.1.12.md

@@ -0,0 +1,54 @@
+# AgentTeams v0.1.12
+
+This release adds host-native English and Simplified Chinese localization to the AgentTeams Web UI.
+
+## New & Improved
+
+- **Official Harness locale integration**: the plugin registers its own `agentTeams` namespace with the Harness locale service instead of inspecting or rewriting host DOM.
+- **Complete localized Web surfaces**: the conversation card and activity panel now translate task and member states, dynamic summaries, progress labels, dependency guidance, archive markers, controls, and accessibility text.
+- **Live language switching**: changing the Harness language updates the active AgentTeams card and panel immediately without a page reload or a separate plugin setting.
+- **Consistent fallback behavior**: English remains the fallback for missing locale entries, and dictionary keys and placeholders are verified as a release contract.
+
+The `/agent-teams` slash-command description and input hint remain stable English metadata because the current Harness command protocol does not expose a locale namespace.
+
+## Verification
+
+- Ran a real DeepSeek API workflow in an isolated `/tmp` Git project with one captain, two members, two dependent tasks, durable messaging, generated artifacts, and a successful project verification command.
+- Verified English → Chinese → English live switching in the real Harness Web UI, including panel folding, dock/floating mode, task dependencies, and member transcript navigation.
+- Passed type checking, production build, offline verification, lifecycle verification, the eight-member complex stress suite, and the Skill mirror check.
+
+## Installation
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+<details>
+<summary><b>中文版本 / Chinese Version</b></summary>
+
+# AgentTeams v0.1.12
+
+本次更新为 AgentTeams Web UI 增加基于宿主官方能力的简体中文与英文多语言支持。
+
+## 新增与改进
+
+- **接入 Harness 官方多语言服务**：插件注册独立的 `agentTeams` 命名空间，不读取或改写宿主 DOM。
+- **完整覆盖 Web 界面**：对话卡片与活动面板中的任务/成员状态、动态摘要、进度、依赖提示、归档标识、操作按钮及无障碍文案均已适配。
+- **语言实时切换**：修改 Harness 语言后，当前 AgentTeams 卡片和面板无需刷新即可同步更新，也不需要插件自己的语言设置。
+- **稳定回退与发布校验**：缺失文案按官方机制回退到英文，发布验证会检查中英文字典的键和模板参数保持一致。
+
+由于当前 Harness 命令协议尚未提供 locale namespace，`/agent-teams` 在 slash 菜单中的描述和输入提示暂时保留稳定的英文元数据。
+
+## 验证
+
+- 在隔离的 `/tmp` Git 项目中使用真实 DeepSeek API 完成队长、两名成员、两个依赖任务、持久消息、真实产物及项目校验的完整链路。
+- 在真实 Harness Web UI 中验证英文 → 中文 → 英文实时切换，以及面板收起、停靠/浮动、任务依赖和成员记录跳转。
+- 通过类型检查、生产构建、离线验证、生命周期验证、八成员复杂压力测试及 Skill 镜像检查。
+
+## 安装
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+</details>

package/release-notes/v0.1.13.md

@@ -0,0 +1,60 @@
+# AgentTeams v0.1.13
+
+This release makes long-running AgentTeams sessions calmer, more predictable, and easier to observe.
+
+## Fixed & Improved
+
+- **No retry storms while checking progress**: an idle member with an open task attempt now stays parked instead of restarting the same work whenever the captain checks status.
+- **Explicit pause and resume**: a captain message resumes a parked member with the same task capability, while reassignment still revokes the previous attempt safely.
+- **Activity panel discovery**: teams created after the first page discovery pass appear without a manual reload.
+- **Lower idle overhead**: ordinary cardless sessions probe every five seconds and upgrade to the one-second live cadence only after a team is discovered.
+- **Clearer delegation guidance**: the captain is instructed to create work for every required contributor and to avoid busy polling or waiting on unassigned members.
+
+## Verification
+
+- Passed production build, offline verification, lifecycle verification, the eight-member complex stress suite, and the Skill mirror check.
+- Ran three independent four-member workflows with real DeepSeek models in a `/tmp` workspace; all assigned tasks completed in all three runs.
+- Verified parked-member resume, task dependency gates, member-to-member reassignment, captain takeover, archive readback, live language switching, panel persistence, and idle polling cadence in the real Harness Web UI.
+
+## Known Limitation
+
+- After a hard DSH restart, the team, members, tasks, and dependency graph are restored, but unfinished members may remain in **Ready to continue** instead of resuming automatically. The captain can explicitly resume or reassign them; automatic cold-restart continuation will be addressed separately.
+
+## Installation
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+<details>
+<summary><b>中文版本 / Chinese Version</b></summary>
+
+# AgentTeams v0.1.13
+
+本次更新让长时间运行的 AgentTeams 协作更安静、更可预测，也更容易观察。
+
+## 修复与改进
+
+- **查询进度不再触发重复工作**：成员空闲但仍持有未完成任务时会保持暂停，不会因为队长查询状态而重新执行同一件事。
+- **明确的暂停与继续语义**：队长发消息可让暂停成员沿用原任务能力继续执行；任务转派仍会安全撤销旧 attempt。
+- **活动面板自动发现团队**：首次页面探测之后才创建的团队，也能自动出现在面板中，无需手动刷新。
+- **降低普通会话开销**：没有团队卡片的普通会话每 5 秒低频探测一次，发现团队后才升级为每秒实时轮询。
+- **更清晰的派工指导**：要求每位必须参与的成员都有明确任务，并避免高频查询或等待未分配工作的成员。
+
+## 验证
+
+- 通过生产构建、离线验证、生命周期验证、八成员复杂压力测试及 Skill 镜像检查。
+- 在 `/tmp` workspace 中使用真实 DeepSeek 模型连续运行 3 轮独立四人团队流程，三轮所有已分配任务均完成。
+- 在真实 Harness Web UI 中验证成员暂停继续、任务依赖、成员间转派、队长接管、归档读取、语言实时切换、面板状态保持及普通会话轮询频率。
+
+## 已知限制
+
+- DSH 硬重启后，团队、成员、任务和依赖图能够恢复，但未完成成员可能停在“待继续执行”，不会自动恢复工作。队长可以显式继续或转派；冷重启自动续跑将在后续版本单独处理。
+
+## 安装
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+</details>