@nanmicoder/dsh-agent-teams 0.1.17 → 0.1.18

package/lib/types/harness-compat.d.ts

@@ -18,6 +18,8 @@ export declare function sessionOwnEvents(session: Session): readonly SessionEven
 export declare function installContinuableMemberSetup(ctx: Context, setup: Setup): void;
 /** Queue a distinct host-authored turn; never substitute model-message steer. */
 export declare function queueMemberPrompt(runtime: Context['subagents'], parent: Agent, childId: SessionId, content: ContentBlock[], signal: AbortSignal): Promise<MessageId>;
+/** Coordination joins the nearest step, including waking an idle/cold child. */
+export declare function steerMemberPrompt(runtime: Context['subagents'], parent: Agent, childId: SessionId, content: ContentBlock[], signal: AbortSignal, live?: Agent): Promise<MessageId>;
 /** Guard all resumable delivery paths, preserving the native service receiver. */
 export declare function guardSubagentDelivery(ctx: Context, isRetired: (sender: Agent, targetId: SessionId) => Promise<boolean>): void;
 export {};

package/lib/types/index.d.ts

@@ -38,7 +38,7 @@ export interface Config {
     executionPrompt?: string;
     /** Plugin-wide fallback route for unavailable member models. */
     fallback?: import('./profiles.ts').TeamModelFallbackConfig;
-    /** Member delegation depth cap (default `1`; `0` forbids delegation entirely). */
+    /** Member delegation depth cap (default `0`; `0` forbids delegation entirely). */
     memberMaxDepth?: number;
     /** Team size cap in members (default `8`). */
     maxMembers?: number;

package/lib/types/mailbox.d.ts

@@ -0,0 +1,7 @@
+/** Durable delivery receipts and execution-generation filtering at step admission. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { TeamMessage, TeamState } from './types.ts';
+export declare function isCurrentMail(team: TeamState, message: TeamMessage): boolean;
+export declare function mailboxPrompt(teamId: string, recipient: string, messages: readonly TeamMessage[]): string;
+/** Only messages actually admitted to this recipient's step become read. */
+export declare function installMailboxAdmission(ctx: Context, stateDir: string): void;

package/lib/types/members.d.ts

@@ -1,6 +1,6 @@
 /**
  * Member subagent lifecycle: spawn a continuable child per member, deliver
- * messages into its FIFO inbox, and observe its activity.
+ * task turns and step-boundary messages, and observe its activity.
  *
  * Members are durable continuable subagents of the captain, so a member keeps
  * its conversation across turns and across harness restarts: the captain
@@ -92,7 +92,7 @@ export declare function selectFallbackRoute(current: {
     };
 };
 /** Deliver a durable member report to the live captain at its next model step. */
-export declare function steerCaptainReport(captain: Pick<Agent, 'steer'>, from: string, content: string): boolean;
+export declare function steerCaptainReport(captain: Pick<Agent, 'steer'>, from: string, content: string, receipt?: string): boolean;
 interface FailedMemberAttempt {
     readonly captainSessionId: string;
     readonly memberId: string;
@@ -151,7 +151,7 @@ export declare function memberWelcome(team: TeamState, memberName: string): stri
  * @param stateDir - configured state directory (for the persona).
  * @param signal - caller cancellation, forwarded to the start.
  */
-export declare function spawnMember(ctx: Context, config: MemberRuntimeConfig, selections: MemberSelectionRuntime, llmSelection: MemberLlmSelection, captain: Agent, team: TeamState, member: TeamMember, stateDir: string, signal: AbortSignal): Promise<void>;
+export declare function spawnMember(ctx: Context, config: MemberRuntimeConfig, selections: MemberSelectionRuntime, llmSelection: MemberLlmSelection, captain: Agent, team: TeamState, member: TeamMember, stateDir: string, signal: AbortSignal, initialPrompt?: string): Promise<void>;
 /**
  * Deliver one message to a member as its next FIFO turn. Best effort: a
  * failure (member gone or not continuable) is logged and reported as `false`
@@ -169,7 +169,7 @@ export declare function spawnMember(ctx: Context, config: MemberRuntimeConfig, s
  * @param signal - caller cancellation, forwarded to the delivery.
  * @returns whether the member inbox accepted the message.
  */
-export declare function deliverToMember(ctx: Context, captain: Agent, childId: string, text: string, signal: AbortSignal): Promise<boolean>;
+export declare function deliverToMember(ctx: Context, captain: Agent, childId: string, text: string, signal: AbortSignal, mode?: 'queue' | 'steer'): Promise<boolean>;
 /**
  * Request cancellation of one live member's current turn. Best effort, fire
  * and return; the target may keep running until it observes the signal.
@@ -191,6 +191,8 @@ export declare function interruptMember(ctx: Context, captain: Agent, childId: s
  * untouched while the delivery boundary still prevents further model turns.
  */
 export declare function installRetiredMemberGuard(ctx: Context, stateDir: string): void;
+/** Bound all descendant creation, including renamed tools and code-runtime calls. */
+export declare function installMemberDelegationGuard(ctx: Context, stateDir: string, maxDepth: number): void;
 /**
  * Snapshot the real driver activity for durable member ids.
  *

package/lib/types/scheduler.d.ts

@@ -21,6 +21,7 @@ export declare const DEPENDENCY_OUTPUTS_TOTAL_MAX_CHARS = 12000;
 export interface SchedulerConfig {
     readonly stateDir: string;
     readonly executionPrompt?: string;
+    readonly dispatch?: (captain: Agent, teamId: string, memberName: string, text: string, signal: AbortSignal, mode: 'queue' | 'steer', attemptId?: string) => Promise<boolean>;
 }
 export interface TeamScheduler {
     /** Try to give every genuinely idle/ready member one unit of ready work. */

package/lib/types/state.d.ts

@@ -149,6 +149,8 @@ export declare function appendMailbox(stateRoot: string, teamId: string, agentKe
 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[]>;
+/** Pending delivery is distinct from delivered-but-not-yet-read input. */
+export declare function readPendingMailbox(stateRoot: string, teamId: string, agentKey: string): 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. */
@@ -158,6 +160,9 @@ export declare function releaseMailboxDelivery(stateRoot: string, teamId: string
  * 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>;
+/** Acceptance by Harness is not evidence that a model step consumed input. */
+export declare function markMailboxDelivered(stateRoot: string, teamId: string, agentKey: string, ids: readonly string[]): Promise<void>;
+export declare function discardMailboxMessages(stateRoot: string, teamId: string, agentKey: string, ids: readonly string[]): Promise<void>;
 /** Filesystem primitives used by {@link replaceFileAtomicOrDirect}; injectable for tests. */
 export interface AtomicReplacePrimitives {
     rename: (from: string, to: string) => Promise<void>;

package/lib/types/types.d.ts

@@ -75,6 +75,8 @@ export interface TeamTask {
     attemptId?: string;
     /** Opaque generation for a revocation/handoff that has not started its next attempt yet. */
     handoffId?: string;
+    /** Previous activation retained until a handoff drain succeeds (retryable). */
+    handoffFromMemberId?: string;
     /** A handoff is quiescing the old owner; the scheduler must not dispatch it yet. */
     reassigning?: boolean;
     /** Quality-gate kind. Missing values are treated as `work`. */
@@ -130,6 +132,8 @@ export interface TeamMember {
     fallbackActive?: boolean;
     joinedAt: number;
     status: MemberStatus;
+    /** Execution admission is closed while a failed/pending handoff is drained. */
+    stopping?: boolean;
 }
 /** One mailbox message. */
 export interface TeamMessage {
@@ -146,6 +150,11 @@ export interface TeamMessage {
     deliveredAt?: number;
     /** Set once the recipient has consumed or been shown the durable fallback. */
     readAt?: number;
+    /** Guidance is scoped to the recipient's execution generation, when present. */
+    taskId?: string;
+    attemptId?: string;
+    /** Cancelled delivery is retained for audit but must not wake the recipient. */
+    discardedAt?: number;
 }
 /** Snapshot of the named profile used to seed a team. */
 export interface TeamModelFallback {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanmicoder/dsh-agent-teams",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "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",
@@ -228,7 +228,7 @@
     "verify": "node scripts/verify.mjs && node scripts/fallback-tdd.mjs && node scripts/member-failure-tdd.mjs && node scripts/quality-gates-tdd.mjs && node scripts/lifecycle-verify.mjs && node scripts/stress-verify.mjs && pnpm verify:web-routes && pnpm verify:release && pnpm verify:skill && pnpm verify:harness-contract && pnpm verify:http-body && pnpm verify:compatibility && pnpm verify:capabilities",
     "verify:web-routes": "node scripts/web-routes-verify.mjs",
     "verify:release": "node --test scripts/release-metadata.test.mjs",
-    "verify:harness-contract": "node scripts/harness-compat-tdd.mjs && node scripts/lifecycle-verify.mjs --modern-harness && node scripts/member-failure-tdd.mjs --modern-harness && node scripts/lifecycle-verify.mjs --delivery-harness && node scripts/member-failure-tdd.mjs --delivery-harness",
+    "verify:harness-contract": "node scripts/harness-compat-tdd.mjs && node scripts/stability-tdd.mjs && node scripts/lifecycle-verify.mjs --modern-harness && node scripts/member-failure-tdd.mjs --modern-harness && node scripts/lifecycle-verify.mjs --delivery-harness && node scripts/member-failure-tdd.mjs --delivery-harness",
     "verify:compatibility": "node scripts/compatibility.mjs && node --test scripts/compatibility.test.mjs && node scripts/doctor.mjs",
     "verify:http-body": "node --test scripts/http-body.test.mjs",
     "doctor": "node scripts/doctor.mjs",

package/release-notes/v0.1.18.md

@@ -0,0 +1,21 @@
+# v0.1.18 — Reliable team scheduling and message delivery
+
+npm channel: `latest`. Recommended host: DeepSeek Harness `0.1.5-rc.1`.
+
+- Create the roster and dependency graph atomically; start members only when their first task is ready, avoiding welcome-only model turns.
+- Deliver coordination at the next model step, preserve tool-result continuations, and discard duplicate or obsolete task messages. Suppress duplicate native success notifications after an accepted team report.
+- Drain member descendants and queued input on archive, removal, and reassignment. Reject retired member identities on cold restore and retry incomplete cleanup.
+- Allow dependency-fenced implementation planning while requirements are in progress, and correct or cancel tasks that have not started.
+- Return the current attempt ID when a member omits it, so it can retry the update without restarting completed work. Keep rejection of genuinely stale attempts.
+- Keep unfinished work from passing delivery gates; make deeper delegation an explicit choice.
+- Preserve existing progressive tool loading, direct workflows, Harness compatibility, and light/dark theme support.
+
+Validation includes regression tests and a four-host native runtime matrix: `0.1.5-rc.1`, `0.1.2-rc.1`, `0.1.2-alpha.5`, and `0.1.2-alpha.2`. The release workflow checks the same packaged artifact on every host before npm publication.
+
+Pre-release real DeepSeek testing under `/tmp` exercised six members, seventeen tasks, cold continuation, and review/repair loops, finishing with 32 external assertions. This involved interrupted runs and fixes between phases; it is not a claim of a clean single-run benchmark or a measured speedup. See the [full test report](https://github.com/NanmiCoder/dsh-agent-teams/blob/v0.1.18/docs/session-latency-audit-2026-09-12/complex-test-report.md), including test limitations and the disclosed test-scope incident.
+
+```sh
+dsh plugin --profile web add --save-exact @nanmicoder/dsh-agent-teams@0.1.18
+```
+
+Restart Harness and refresh the browser after upgrading. Updating the plugin does not update a Desktop app's embedded Harness. Before downgrading, finish or archive teams created by this release: older plugins do not understand dormant members with an empty session ID.