@nanmicoder/dsh-agent-teams 0.1.5 → 0.1.6

package/lib/types/members.d.ts

@@ -115,11 +115,24 @@ export declare function deliverToMember(ctx: Context, captain: Agent, childId: s
  */
 export declare function interruptMember(ctx: Context, captain: Agent, childId: string): void;
 /**
- * Snapshot each direct continuable child's activity under the captain's
- * session, keyed by child session id. A member that is currently running its
- * turn reports `running`; an idle member reports `inactive`.
+ * 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.
+ */
+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.
  */
-export declare function memberActivity(ctx: Context, captainSessionId: string): Promise<Map<string, 'running' | 'inactive'>>;
+export declare function memberActivity(ctx: Context, captainSessionId: string): Promise<Map<string, 'running' | 'idle' | 'ready'>>;

package/lib/types/scheduler.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Event-driven shared task scheduler.
+ *
+ * Claude Code teammates keep polling the shared task list after a turn. DSH
+ * 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.
+ * @module dsh-agent-teams/scheduler
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+export interface SchedulerConfig {
+    readonly stateDir: string;
+}
+export interface TeamScheduler {
+    /** Try to give every genuinely idle/ready member one unit of ready work. */
+    kickTeam(workspace: string, teamId: string, captain?: Agent): Promise<void>;
+    /** Try to flush fallback mail or give one member one ready task. */
+    kickMember(workspace: string, teamId: string, memberName: string, captain?: Agent): Promise<void>;
+}
+/** Install one scheduler and its member activity observer. */
+export declare function installTeamScheduler(ctx: Context, config: SchedulerConfig): TeamScheduler;

package/lib/types/snapshot.d.ts

@@ -8,7 +8,7 @@
  * @module dsh-agent-teams/snapshot
  */
 import type { Context } from '@deepseek-ai/cordis';
-import type { TeamState } from './types.ts';
+import type { MemberStatus, TeamState } from './types.ts';
 /** Visual task state for the activity panel. */
 export type VisualTaskState = 'blocked' | 'open' | 'running' | 'completed';
 /** One member row of the activity snapshot. */
@@ -16,6 +16,7 @@ export interface TeamActivityMember {
     readonly id: string;
     readonly name: string;
     readonly role: string;
+    readonly status: MemberStatus;
     readonly activity: 'working' | 'idle' | 'unknown';
     readonly progress: number;
     readonly done: number;
@@ -50,6 +51,13 @@ export interface TeamActivitySnapshot {
     readonly messageCount: number;
     readonly captainInbox: readonly TeamActivityMessage[];
 }
+/** Snapshot projection switches for live and archived teams. */
+export interface TeamSnapshotOptions {
+    /** Historic review must retain members that were marked removed at shutdown. */
+    readonly includeRemoved?: boolean;
+    /** Archived teams have no meaningful live activity after their sessions stop. */
+    readonly historic?: boolean;
+}
 /**
  * Assemble one team snapshot from its durable files plus live activity.
  * @param ctx - the plugin context (injects `subagents`, used for activity).
@@ -58,7 +66,7 @@ export interface TeamActivitySnapshot {
  * @param state - the durable team record.
  * @returns the panel snapshot.
  */
-export declare function assembleTeamSnapshot(ctx: Context, stateRoot: string, workspace: string, state: TeamState): Promise<TeamActivitySnapshot>;
+export declare function assembleTeamSnapshot(ctx: Context, stateRoot: string, workspace: string, state: TeamState, options?: TeamSnapshotOptions): Promise<TeamActivitySnapshot>;
 /**
  * Collect every team under the given workspace state roots.
  * @param ctx - the plugin context.

package/lib/types/state.d.ts

@@ -61,6 +61,15 @@ export declare const TASK_TRANSITIONS: Readonly<Record<TaskStatus, readonly Task
  * @returns the transition error, or undefined when allowed.
  */
 export declare function transitionError(current: TaskStatus, next: TaskStatus): string | undefined;
+/** Activate the task's current generation for one owner and return its capability id. */
+export declare function activateTaskAttempt(task: TeamTask, assignee: string): string;
+/** Start a fresh task generation for one owner. */
+export declare function beginTaskAttempt(task: TeamTask, assignee: string): string;
+/**
+ * Revoke the current worker immediately. Clearing its capability makes old
+ * updates stale; a separate handoff generation serializes async quiescence.
+ */
+export declare function invalidateTaskAttempt(task: TeamTask, nextAssignee?: string, reassigning?: boolean): void;
 /**
  * Create the team directory structure and the initial team record.
  * @param stateRoot - resolved absolute state root directory.
@@ -89,6 +98,10 @@ export declare function readTeamSync(stateRoot: string, teamId: string): TeamSta
  * @param state - the record to persist.
  */
 export declare function writeTeam(stateRoot: string, state: TeamState): Promise<void>;
+/** Read the durable set of member session ids retired by remove/delete. */
+export declare function readRetiredMemberIds(stateRoot: string): Promise<Set<string>>;
+/** Atomically add session ids to the durable retired-member deny-list. */
+export declare function recordRetiredMemberIds(stateRoot: string, memberIds: readonly string[]): Promise<void>;
 /**
  * Find the team owned by one captain session (at most one per captain).
  * @param stateRoot - resolved absolute state root directory.
@@ -125,6 +138,17 @@ export declare function appendMailbox(stateRoot: string, teamId: string, agentKe
  * @returns the messages, empty when the mailbox does not exist yet.
  */
 export declare function readMailbox(stateRoot: string, teamId: string, agentKey: string, onMalformedLine?: (lineNumber: number, error: unknown) => void): Promise<TeamMessage[]>;
+/** Read only messages that have not been acknowledged by their recipient. */
+export declare function readUnreadMailbox(stateRoot: string, teamId: string, agentKey: string, onMalformedLine?: (lineNumber: number, error: unknown) => void): Promise<TeamMessage[]>;
+/** Lease selected fallback messages to one delivery path. */
+export declare function claimMailboxDelivery(stateRoot: string, teamId: string, agentKey: string, messageIds: readonly string[]): Promise<void>;
+/** Release a failed delivery lease so the scheduler can retry it later. */
+export declare function releaseMailboxDelivery(stateRoot: string, teamId: string, agentKey: string, messageIds: readonly string[]): Promise<void>;
+/**
+ * Mark selected durable mailbox records delivered/read while preserving
+ * malformed lines for diagnostics. Callers serialize this with the team lock.
+ */
+export declare function acknowledgeMailbox(stateRoot: string, teamId: string, agentKey: string, messageIds: readonly string[]): Promise<void>;
 /**
  * Remove a team's whole directory (members should be interrupted first).
  * @param stateRoot - resolved absolute state root directory.

package/lib/types/types.d.ts

@@ -20,12 +20,20 @@ export interface TeamTask {
     /** What needs to be done. */
     description?: string;
     status: TaskStatus;
-    /** Member name the task is assigned to; unassigned tasks await a claim. */
+    /** Member name (or `captain`) the task is assigned to; unassigned tasks await a claim. */
     assignee?: string;
     /** Task ids that must reach `completed` before this task can be claimed. */
     dependencies: string[];
     /** The worker's written result, set when the task completes or fails. */
     output?: string;
+    /** Monotonic execution generation. Reassignment/retry invalidates every older attempt. */
+    attempt?: number;
+    /** Capability for the current claimed/in-progress attempt. Members must present it when updating. */
+    attemptId?: string;
+    /** Opaque generation for a revocation/handoff that has not started its next attempt yet. */
+    handoffId?: string;
+    /** A handoff is quiescing the old owner; the scheduler must not dispatch it yet. */
+    reassigning?: boolean;
     createdAt: number;
     updatedAt: number;
 }
@@ -57,6 +65,12 @@ export interface TeamMessage {
     to: string;
     content: string;
     ts: number;
+    /** Process-local delivery lease; prevents fallback and direct delivery racing. */
+    deliveryClaimedAt?: number;
+    /** Set after the durable message was accepted by the recipient's live Harness inbox. */
+    deliveredAt?: number;
+    /** Set once the recipient has consumed or been shown the durable fallback. */
+    readAt?: number;
 }
 /** The full durable team record. */
 export interface TeamState {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanmicoder/dsh-agent-teams",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "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",
@@ -82,7 +82,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit",
     "sync:skill": "node scripts/sync-skill.mjs",
     "verify:skill": "node scripts/sync-skill.mjs --check",
-    "verify": "node scripts/verify.mjs && pnpm verify:skill",
+    "verify": "node scripts/verify.mjs && node scripts/lifecycle-verify.mjs && node scripts/stress-verify.mjs && pnpm verify:skill",
     "prepublishOnly": "pnpm build && pnpm verify"
   },
   "peerDependencies": {