@nanmicoder/dsh-agent-teams 0.1.10 → 0.1.11

package/lib/members.js

@@ -318,44 +318,22 @@ export function interruptMember(ctx, captain, childId) {
         ctx.logger.warn(`agent-teams: interrupt of member ${childId} failed: ${String(error)}`);
     }
 }
-/** Resolve one live parent's workspace-scoped retirement index. */
-async function retiredForParent(ctx, parentId, stateDir) {
-    const parent = ctx.agents.get(parentId);
-    return parent === undefined
-        ? new Set()
-        : readRetiredMemberIds(join(parent.session.header.cwd ?? process.cwd(), stateDir));
-}
 /**
  * Install the missing per-child retirement boundary above Harness rc.6.
  *
  * Upstream `interrupt()` deliberately preserves continuable sessions and the
  * upstream seam exposes no targeted forget/retire method. The durable
- * AgentTeams index therefore guards all three public continuation boundaries:
- * retired rows disappear from `list_agents` (children and descendants), and a
- * direct `followup()` is rejected before it can cold-resume the member. Exact
- * ids keep unrelated subagents untouched; transcripts remain in persistence
- * for archived-team review.
+ * AgentTeams index therefore rejects `followup()` before it can cold-resume a
+ * retired member. Catalog rows deliberately remain discoverable: Harness rc.8
+ * uses the direct-child catalog to authorize historical transcript reads and
+ * `openSubagent()`, so filtering those rows would make an archived member's
+ * persisted conversation inaccessible. Exact ids keep unrelated subagents
+ * untouched while the followup boundary still prevents further model turns.
  */
 export function installRetiredMemberGuard(ctx, stateDir) {
     const runtime = ctx.subagents;
     ctx.effect(() => {
-        const listChildren = runtime.listChildren;
-        const listDescendants = runtime.listDescendants;
         const followup = runtime.followup;
-        const guardedChildren = async (parentId, signal) => {
-            const [entries, retired] = await Promise.all([
-                listChildren.call(runtime, parentId, signal),
-                retiredForParent(ctx, parentId, stateDir),
-            ]);
-            return entries.filter(entry => !retired.has(entry.id));
-        };
-        const guardedDescendants = async (rootId, signal) => {
-            const [entries, retired] = await Promise.all([
-                listDescendants.call(runtime, rootId, signal),
-                retiredForParent(ctx, rootId, stateDir),
-            ]);
-            return entries.filter(entry => !retired.has(entry.id));
-        };
         const guardedFollowup = async (parent, childId, content, options) => {
             const retired = await readRetiredMemberIds(join(parent.session.header.cwd ?? process.cwd(), stateDir));
             if (retired.has(childId)) {
@@ -363,36 +341,32 @@ export function installRetiredMemberGuard(ctx, stateDir) {
             }
             return followup.call(runtime, parent, childId, content, options);
         };
-        runtime.listChildren = guardedChildren;
-        runtime.listDescendants = guardedDescendants;
         runtime.followup = guardedFollowup;
         return () => {
-            if (runtime.listChildren === guardedChildren)
-                runtime.listChildren = listChildren;
-            if (runtime.listDescendants === guardedDescendants)
-                runtime.listDescendants = listDescendants;
             if (runtime.followup === guardedFollowup)
                 runtime.followup = followup;
         };
     }, 'agent-teams: retired member guard');
 }
 /**
- * Snapshot each direct continuable child's real driver activity under the
- * captain's session. `listChildren().activity` is only session residency, so
- * live children are refined through the Agent registry exactly like Harness's
- * shipped `list_agents` tool.
- * @param ctx - the plugin context (injects `subagents`).
- * @param captainSessionId - the captain's session id.
- * @returns child id → activity, missing entries are unknown children.
+ * Snapshot the real driver activity for durable member ids.
+ *
+ * The team record is the membership authority, so this path intentionally no
+ * longer depends on `listChildren()`'s versioned projection shape. Harness
+ * rc.8 changed those rows to branded `SessionId` values plus residency-only
+ * `activity`; neither is needed to answer whether the live Agent driver is
+ * running, idle, or absent/ready.
+ * @param ctx - the plugin context (injects `agents`).
+ * @param memberIds - child ids restored from the durable team record.
+ * @returns child id → live activity.
  */
-export async function memberActivity(ctx, captainSessionId) {
-    const entries = await ctx.subagents.listChildren(brandedSessionId(captainSessionId));
+export function memberActivity(ctx, memberIds) {
     const activity = new Map();
-    for (const entry of entries) {
-        if (entry.kind !== 'child')
+    for (const id of memberIds) {
+        if (id === '')
             continue;
-        const live = ctx.agents.get(entry.id);
-        activity.set(entry.id, live === undefined ? 'ready' : live.status);
+        const live = ctx.agents.get(brandedSessionId(id));
+        activity.set(id, live === undefined ? 'ready' : live.status);
     }
     return activity;
 }

package/lib/snapshot.js

@@ -9,6 +9,7 @@
  */
 import { readdir } from 'node:fs/promises';
 import { join } from 'node:path';
+import { memberActivity } from "./members.js";
 import { CAPTAIN_KEY, listArchivedTeamIds, readArchivedTeam, readUnreadMailbox, readTeam, taskDepthsById, taskVisualState, } from "./state.js";
 /** The current task of a member: its first unfinished owned task. */
 function currentTaskOf(memberName, tasks) {
@@ -32,21 +33,9 @@ export async function assembleTeamSnapshot(ctx, stateRoot, workspace, state, opt
     const roster = options.includeRemoved === true
         ? state.members
         : state.members.filter((member) => member.status !== 'removed');
-    const activity = new Map();
-    if (options.historic !== true) {
-        try {
-            const children = await ctx.subagents.listChildren(state.captainSessionId);
-            for (const entry of children) {
-                if (entry.kind === 'child') {
-                    const live = ctx.agents.get(entry.id);
-                    activity.set(entry.id, live === undefined ? 'ready' : live.status);
-                }
-            }
-        }
-        catch (error) {
-            ctx.logger.warn(`agent-teams: activity listing failed for ${state.name}: ${String(error)}`);
-        }
-    }
+    const activity = options.historic === true
+        ? new Map()
+        : memberActivity(ctx, roster.map((member) => member.id));
     const unreadByMember = new Map();
     for (const member of roster) {
         try {

package/lib/tools.js

@@ -871,7 +871,7 @@ export function registerAgentTeamsTools(ctx, config) {
                 await scheduler.kickTeam(workspace, located.id, caller);
             }
             const { team, identity } = await withTeamLock(teamLockKey(stateRoot, located.id), () => requireFreshParticipant(stateRoot, located.id, caller.id));
-            const activity = await memberActivity(ctx, team.captainSessionId);
+            const activity = memberActivity(ctx, team.members.map((member) => member.id));
             const members = team.members
                 .filter((member) => member.status !== 'removed')
                 .map((member) => ({

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

@@ -21,7 +21,7 @@ import type { ObservableSnapshot, SessionListState } from '@deepseek-ai/dsh-clie
 /** 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, openSession }: {
+export declare function ActivityPanel({ sessionsList, openMember }: {
     readonly sessionsList: ObservableSnapshot<SessionListState>;
-    readonly openSession: (id: SessionId) => void;
+    readonly openMember: (parentId: SessionId, childId: SessionId) => void;
 }): import("react").JSX.Element | null;

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

@@ -15,9 +15,9 @@ import type { SessionId } from '@deepseek-ai/dsh-session/types';
 export declare const OPEN_PANEL_EVENT = "agent-teams:open-panel";
 /** Navigation action injected from the plugin's own SessionsService access. */
 export interface AgentTeamsCardInjected {
-    readonly openSession: (id: SessionId) => void;
+    readonly openMember: (parentId: SessionId, childId: SessionId) => void;
 }
 /** 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, openSession, sessionId }: AgentTeamsCardProps): import("react").JSX.Element;
+export declare function AgentTeamsCard({ node, openMember, sessionId }: AgentTeamsCardProps): import("react").JSX.Element;

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

@@ -79,6 +79,12 @@ interface ActivityFetchResponse {
 }
 /** Injectable browser primitives used by the poll controller and its tests. */
 export interface ActivityPollingRuntime {
+    /**
+     * Current captain session to discover after a cold client/host restart.
+     * This one-time scope restores teams whose older conversation log has no
+     * AgentTeams card capable of registering an explicit monitor target.
+     */
+    readonly discoverySessionId?: string;
     readonly fetchState?: (url: string, init: {
         readonly cache: 'no-store';
         readonly signal: AbortSignal;
@@ -98,9 +104,13 @@ export interface ActivityPollingController {
 /**
  * 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 declare function startActivityPolling(monitorTargets: readonly ActivityMonitorTarget[], runtime?: ActivityPollingRuntime): ActivityPollingController;
 export {};

package/lib/types/client/session-navigation.d.ts

@@ -0,0 +1,22 @@
+/** Version-tolerant navigation into durable AgentTeams member transcripts. */
+import type { SessionId, SubagentAddress } from '@deepseek-ai/dsh-client-runtime/client';
+/** Narrow sessions-service face used by the activity panel and team card. */
+export interface AgentTeamsSessionNavigator {
+    /** Legacy/ordinary session navigation. */
+    open(id: SessionId): void;
+    /** rc.8 addressed subagent navigation. */
+    openSubagent?(address: SubagentAddress): void;
+    /** Refresh the exact parent's durable direct-child catalog. */
+    refreshSubagents?(parentSessionId: SessionId): Promise<void>;
+    /** Reuse an address already retained by the client runtime when available. */
+    subagentAddress?(id: SessionId): SubagentAddress | undefined;
+}
+/**
+ * Open one member's persisted transcript.
+ *
+ * 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.
+ */
+export declare function openAgentTeamMember(sessions: AgentTeamsSessionNavigator, parentSessionId: SessionId, childSessionId: SessionId): Promise<'subagent' | 'session'>;

package/lib/types/members.d.ts

@@ -123,20 +123,24 @@ export declare function interruptMember(ctx: Context, captain: Agent, childId: s
  *
  * Upstream `interrupt()` deliberately preserves continuable sessions and the
  * upstream seam exposes no targeted forget/retire method. The durable
- * AgentTeams index therefore guards all three public continuation boundaries:
- * retired rows disappear from `list_agents` (children and descendants), and a
- * direct `followup()` is rejected before it can cold-resume the member. Exact
- * ids keep unrelated subagents untouched; transcripts remain in persistence
- * for archived-team review.
+ * AgentTeams index therefore rejects `followup()` before it can cold-resume a
+ * retired member. Catalog rows deliberately remain discoverable: Harness rc.8
+ * uses the direct-child catalog to authorize historical transcript reads and
+ * `openSubagent()`, so filtering those rows would make an archived member's
+ * persisted conversation inaccessible. Exact ids keep unrelated subagents
+ * untouched while the followup boundary still prevents further model turns.
  */
 export declare function installRetiredMemberGuard(ctx: Context, stateDir: string): void;
 /**
- * Snapshot each direct continuable child's real driver activity under the
- * captain's session. `listChildren().activity` is only session residency, so
- * live children are refined through the Agent registry exactly like Harness's
- * shipped `list_agents` tool.
- * @param ctx - the plugin context (injects `subagents`).
- * @param captainSessionId - the captain's session id.
- * @returns child id → activity, missing entries are unknown children.
+ * Snapshot the real driver activity for durable member ids.
+ *
+ * The team record is the membership authority, so this path intentionally no
+ * longer depends on `listChildren()`'s versioned projection shape. Harness
+ * rc.8 changed those rows to branded `SessionId` values plus residency-only
+ * `activity`; neither is needed to answer whether the live Agent driver is
+ * running, idle, or absent/ready.
+ * @param ctx - the plugin context (injects `agents`).
+ * @param memberIds - child ids restored from the durable team record.
+ * @returns child id → live activity.
  */
-export declare function memberActivity(ctx: Context, captainSessionId: string): Promise<Map<string, 'running' | 'idle' | 'ready'>>;
+export declare function memberActivity(ctx: Context, memberIds: readonly string[]): Map<string, 'running' | 'idle' | 'ready'>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanmicoder/dsh-agent-teams",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "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.11.md

@@ -0,0 +1,52 @@
+# AgentTeams v0.1.11
+
+This release restores AgentTeams activity and member history after a DeepSeek Harness client or host restart. It fixes the rc.8 compatibility regressions reported in [#60](https://github.com/NanmiCoder/dsh-agent-teams/issues/60) and [#61](https://github.com/NanmiCoder/dsh-agent-teams/issues/61).
+
+## Fixes
+
+- **Cold-start activity recovery**: selecting a captain session now performs a lightweight live and archived team discovery pass, so older sessions without an AgentTeams conversation card restore their activity panel after restart.
+- **Reliable member activity**: live `running / idle / ready` state is resolved from the durable team roster and Agent registry instead of depending on the versioned `listChildren()` projection shape.
+- **Persistent member history**: retired AgentTeams members remain discoverable in the Harness subagent catalog for transcript review while direct follow-up remains blocked.
+- **rc.8 transcript navigation**: activity-panel and conversation-card member links refresh the parent catalog and use addressed `openSubagent()` navigation, with a fallback for older Harness runtimes.
+
+## Verification
+
+- Reproduced the full captain/member/task/archive lifecycle in a real `/tmp` workspace on the Harness web client.
+- Verified cold restart recovery without opening the built-in subagent catalog first.
+- Verified archived member navigation and complete persisted task history.
+- Passed type checking, production build, offline verification, lifecycle verification, and the eight-member complex stress suite.
+
+## Installation
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+<details>
+<summary><b>中文版本 / Chinese Version</b></summary>
+
+# AgentTeams v0.1.11
+
+本次更新修复 DeepSeek Harness 客户端或 host 重启后 AgentTeams 活动面板与成员历史消失的问题，对应 [#60](https://github.com/NanmiCoder/dsh-agent-teams/issues/60) 和 [#61](https://github.com/NanmiCoder/dsh-agent-teams/issues/61) 中报告的 rc.8 兼容性回归。
+
+## 修复
+
+- **冷启动活动恢复**：选择队长会话时会执行一次轻量的活动团队与历史归档发现；即使旧会话没有 AgentTeams 对话卡片，重启后也能恢复活动面板。
+- **可靠的成员活动状态**：从持久化团队成员表和 Agent registry 解析真实的 `running / idle / ready`，不再依赖容易变化的 `listChildren()` 投影结构。
+- **成员历史持续可见**：已退休的 AgentTeams 成员继续保留在 Harness 子代理目录中供历史记录查看，但直接 follow-up 仍会被拒绝。
+- **rc.8 历史会话导航**：活动面板和对话卡片会先刷新父级目录，再通过带父子地址的 `openSubagent()` 打开成员记录；旧版 Harness 继续使用兼容回退。
+
+## 验证
+
+- 在 Harness Web 客户端的真实 `/tmp` workspace 中完成队长、成员、任务和归档全流程复现。
+- 验证未预先打开内置子代理目录时的冷重启恢复。
+- 验证归档成员导航及完整持久化任务历史。
+- 通过类型检查、生产构建、离线验证、生命周期验证及八成员复杂压力测试。
+
+## 安装
+
+```sh
+dsh plugin --profile web add @nanmicoder/dsh-agent-teams
+```
+
+</details>