@dsh-cc/command-agents 0.8.2-rc.1 → 0.8.3-rc.1

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm check:readme --write
-README.md: 990e1fe57934caabc4e282dd16f26b0cb2710ca8
-README.zh.md: e7feeaca85d787815cecc115455951d86d48b5b8
+README.md: 08355d935658595df6455ff34f3d51d51837662f
+README.zh.md: 0d66e875a65958d7a18a063e3f566ad0e01c9ec4

package/README.md

@@ -12,9 +12,29 @@ Human-facing `/agents` command for continuable background agents (plan
 - `/agents <id>` — thin detail: pin provenance (path, definition, model
   selector, workspace, gate evaluation), residency, ids.
 - `/agents stop <id>` — one interrupt request on a running child (the child
-  stays continuable/resumable); short no-op explanation otherwise.
+  stays continuable/resumable); short no-op explanation otherwise. A released
+  (or mid-release) child refuses with an explicit "cannot be continued here"
+  copy instead of the resumable wording.
+- `/agents release <id>` — evict the child's resident activation (and its
+  resident descendants') through the harness drain seam; frees its capacity
+  slot when it was running; cooperative (a cancel-resistant turn keeps its
+  slot and the command reports the release as in flight); one-way in this
+  session (same-session continuation is unavailable — the upstream
+  cold-resume-after-drain gap); the persisted session survives on disk.
+  Released rows render a process-local `[released]` tag in the list and a
+  release line in the detail.
 - `/agents attach <id>` — namespace reserved, not implemented (P1).
 
+## Shared release core
+
+`src/release.ts` is the single release operation shared by `/agents release`
+and the model-facing `release_agent` tool (`@dsh-cc/subagent-task`): one
+gate/drain/resolve/reject/timeout flow, one copy set, and one process-local
+two-set marker (`releasing` / `released`), exported via the
+`@dsh-cc/command-agents/release` entry. The `[released]` tag renders only
+when a marker exists AND the row's residency is `ready` (registry-absent at
+snapshot time) — never from the marker alone.
+
 ## Shared snapshot
 
 `src/snapshot.ts` is a pure snapshot provider over injected services

package/README.zh.md

@@ -12,9 +12,25 @@
 - `/agents <id>` — 轻量详情：pin 来源（路径、定义、模型选择器、工作区、
   gate 评估结果）、驻留状态、ids。
 - `/agents stop <id>` — 对运行中的子代理发送一次中断请求（子代理仍可
-  延续/恢复）；否则给出简短的无操作说明。
+  延续/恢复）；否则给出简短的无操作说明。已释放（或释放进行中）的子代理
+  会以明确的"本会话内不可延续"文案拒绝，而不是可恢复的说法。
+- `/agents release <id>` — 通过 harness 的 drain 缝隙逐出该子代理的常驻
+  activation（连同其常驻后代）；当其为 running 时释放其容量槽位；驱逐是
+  协作式的（一个拒绝取消的 turn 会保留其槽位，此时命令报告释放仍在进行）；
+  本会话内单向不可逆（同会话延续不可用——上游 cold-resume-after-drain 缺口）；
+  持久化的 session 保留在磁盘上。已释放的行在列表中渲染进程本地的
+  `[released]` 标签，在详情中渲染一行 release 说明。
 - `/agents attach <id>` — 命名空间已保留，尚未实现（P1）。
 
+## Shared release core
+
+`src/release.ts` 是由 `/agents release` 与面向模型的 `release_agent` 工具
+（`@dsh-cc/subagent-task`）共享的唯一释放操作：一套 gate/drain/resolve/
+reject/timeout 流程、一套文案，以及一个进程本地的双集合标记
+（`releasing` / `released`），经 `@dsh-cc/command-agents/release` 入口导出。
+只有当标记存在且该行的驻留状态为 `ready`（快照时刻注册表缺席）时，
+`[released]` 标签才会渲染——绝不只凭标记。
+
 ## Shared snapshot
 
 `src/snapshot.ts` 是一个基于注入服务的纯快照提供者

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAkBlD,eAAO,MAAM,IAAI,mBAAmB,CAAA;AACpC,eAAO,MAAM,MAAM,UAAwD,CAAA;AAuE3E;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAqCxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AA2BlD,eAAO,MAAM,IAAI,mBAAmB,CAAA;AACpC,eAAO,MAAM,MAAM,UAAwD,CAAA;AAsG3E;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAsCxC"}

package/lib/index.js

@@ -10,7 +10,8 @@
  */
 import { SessionId } from '@deepseek-ai/dsh-session';
 import { helpable } from '@dsh-cc/command-usage';
-import { buildAgentsSnapshot, parseAgentsInput, renderAgentDetail, renderAgentsList, stopNotRunningCopy, stopRunningCopy, unknownAgentCopy, } from "./snapshot.js";
+import { buildAgentsSnapshot, parseAgentsInput, renderAgentDetail, renderAgentsList, stopNotRunningCopy, stopReleasedCopy, stopRunningCopy, unknownAgentCopy, } from "./snapshot.js";
+import { ReleaseFailure, renderReleaseOutcome, runRelease, isReleased, isReleasing, } from "./release.js";
 export const name = 'command-agents';
 export const inject = ['commands', 'subagents', 'agents', 'resumePinStore'];
 /** Adapt the injected services to the pure snapshot seam. */
@@ -27,22 +28,51 @@ function toSnapshotServices(subagents, agents, pinStore) {
         getAgent: id => agents.get(id),
         readPin: childId => pinStore.read(childId),
         pinPath: childId => pinStore.pathFor(childId),
+        isReleased: id => isReleased(id),
+        isReleasing: id => isReleasing(id),
     };
 }
 /** Execute one parsed `/agents` invocation against the snapshot. */
-async function executeAgents(snapshotServices, subagents, caller, rawInput) {
+async function executeAgents(snapshotServices, subagents, agents, caller, rawInput, signal) {
     const parsed = parseAgentsInput(rawInput);
     if (parsed.kind === 'error')
         return { kind: 'error', text: parsed.text };
     const parentSessionId = String(caller.session.id);
+    // The release branch runs BEFORE rows.find / any snapshot fast path: the
+    // authoritative drain seam, not the snapshot, decides.
+    if (parsed.kind === 'release') {
+        try {
+            const outcome = await runRelease({
+                parent: caller,
+                id: parsed.id,
+                subagents,
+                agents: agents,
+                signal,
+            });
+            return { kind: 'success', text: renderReleaseOutcome(outcome) };
+        }
+        catch (failure) {
+            if (failure instanceof ReleaseFailure)
+                return { kind: 'error', text: failure.message };
+            throw failure;
+        }
+    }
     if (parsed.kind === 'stop') {
         const rows = await buildAgentsSnapshot(snapshotServices, parentSessionId);
         const row = rows.find(candidate => candidate.id === parsed.id);
         if (row === undefined)
             return { kind: 'error', text: unknownAgentCopy(parsed.id) };
+        // Symmetric stop-copy gates (D3): a released Ready row and a mid-drain
+        // (releasing) row must never read "stays resumable".
         if (row.residency !== 'running') {
+            if (row.released === true) {
+                return { kind: 'success', text: stopReleasedCopy(parsed.id) };
+            }
             return { kind: 'success', text: stopNotRunningCopy(parsed.id, row.residency) };
         }
+        if (snapshotServices.isReleasing?.(parsed.id) === true) {
+            return { kind: 'success', text: stopReleasedCopy(parsed.id) };
+        }
         subagents.interrupt(SessionId(parsed.id), { kind: 'ancestor', agent: caller });
         return { kind: 'success', text: stopRunningCopy(parsed.id) };
     }
@@ -90,13 +120,14 @@ export function apply(ctx) {
     }, 'command-agents: clear host-realm ccAgents publication on unload');
     ctx.commands.register(helpable({
         name: 'agents',
-        description: 'list, inspect, or stop continuable background agents',
-        handler: (invocation) => executeAgents(snapshotServices, subagents, invocation.agent, invocation.rawInput),
+        description: 'list, inspect, stop, or release continuable background agents',
+        handler: (invocation) => executeAgents(snapshotServices, subagents, agents, invocation.agent, invocation.rawInput, invocation.signal),
     }, {
         usage: ['[<id>]'],
         subcommands: [
             { word: 'detail', args: '<id>', summary: 'Show one background agent by id (the bare form lists all)' },
-            { word: 'stop', args: '<id>', summary: 'Stop a running background agent by id' },
+            { word: 'stop', args: '<id>', summary: 'Interrupt a running agent\'s current turn (the activation stays resident; "/agents release <id>" evicts it)' },
+            { word: 'release', args: '<id>', summary: 'Evict an agent\'s resident activation (and resident descendants\'), freeing its capacity slot when it was running; cooperative; one-way in this session' },
         ],
     }));
 }

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/release.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Shared release operation: the single source of truth for evicting a direct
+ * continuable child's resident activation via the harness
+ * `drainContinuableChildren` seam (plan
+ * docs/plans/2026-09-30-subagent-release-valve.md §4 D1). Consumed by the
+ * model-facing `release_agent` tool and the human-facing
+ * `/agents release <id>` command, so both surfaces render ONE copy set (§5)
+ * and share ONE process-local marker state (F14: released rows are not
+ * representable upstream — the durable catalog survives a drain and reads
+ * `ready`).
+ *
+ * Residency derivation cross-reference: this module's registry reads derive
+ * residency exactly like the sibling sites `snapshot.ts residencyOf` (live
+ * `status === 'running'` → running, live-not-running → idle, absent →
+ * settled/ready) and `background-start.ts assertLiveCapacity` (a slot is held
+ * only while the registry reports `status === 'running'`).
+ * @module @dsh-cc/command-agents/release
+ */
+import { SessionId } from '@deepseek-ai/dsh-session';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+/** The duck-typed subagents seam release needs (host duck compat). */
+export interface ReleaseSubagentsLike {
+    listChildren?(parentSessionId: SessionId, signal?: AbortSignal): Promise<readonly {
+        id: string;
+        mode?: string;
+    }[]>;
+    drainContinuableChildren?(parent: Agent, ids: SessionId[]): Promise<void>;
+}
+/** The duck-typed live-agents registry slice release reads. */
+export interface ReleaseRegistryLike {
+    get(id: string): {
+        status?: 'idle' | 'running' | string;
+    } | undefined;
+}
+type PreStatus = 'running' | 'idle' | 'unknown';
+type CatalogNote = 'catalog' | 'registry-only' | 'catalog-unreadable';
+export type ReleaseOutcome = {
+    kind: 'released';
+    id: string;
+    preStatus: PreStatus;
+    catalogNote: CatalogNote;
+    cause?: string;
+} | {
+    kind: 'issued-unobservable';
+    id: string;
+    catalogNote: 'catalog';
+} | {
+    kind: 'evicted-degraded';
+    id: string;
+    failure: string;
+    catalogNote: CatalogNote;
+    cause?: string;
+} | {
+    kind: 'not-resident';
+    id: string;
+    releasedEarlier: boolean;
+} | {
+    kind: 'still-resident';
+    id: string;
+    drainPending: boolean;
+};
+export type ReleaseFailureReason = 'unknown-id' | 'not-continuable' | 'no-drain-seam' | 'catalog-unreadable' | 'not-direct-child' | 'stale-parent';
+/** A release gate error whose `message` IS the final §5 copy. */
+export declare class ReleaseFailure extends Error {
+    readonly reason: ReleaseFailureReason;
+    constructor(reason: ReleaseFailureReason, message: string);
+}
+/** How long a drain may run before the caller reports still-resident (F4). */
+export declare const DRAIN_OBSERVE_TIMEOUT_MS = 10000;
+/** Enter the releasing state (pre-issuance; F12a). */
+export declare function markReleasing(id: string): void;
+/** Terminal success: move the id releasing → released. */
+export declare function markReleased(id: string): void;
+/** Withdraw a releasing mark; refused (no-op) while the id is released. */
+export declare function clearReleasing(id: string): void;
+export declare function isReleased(id: string): boolean;
+export declare function isReleasing(id: string): boolean;
+/** Test-only: clears BOTH sets. */
+export declare function resetReleasedMarkers(): void;
+/**
+ * Run one release against the authoritative drain seam. Gate errors precede
+ * any marking/drain; every transition is test-pinned (plan §4 D1 step list).
+ */
+export declare function runRelease(deps: {
+    parent: Agent;
+    id: string;
+    subagents: ReleaseSubagentsLike | undefined;
+    agents: ReleaseRegistryLike | undefined;
+    signal?: AbortSignal;
+}): Promise<ReleaseOutcome>;
+/**
+ * Render a release outcome as the final user-facing text. Every §5 variant
+ * is a verbatim contract; the descendant clause rides on every
+ * eviction-claiming string.
+ */
+export declare function renderReleaseOutcome(outcome: ReleaseOutcome): string;
+export {};
+//# sourceMappingURL=release.d.ts.map

package/lib/release.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.d.ts","sourceRoot":"","sources":["../src/release.ts"],"names":[],"mappings":"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"}

package/lib/release.js

@@ -0,0 +1,357 @@
+/**
+ * Shared release operation: the single source of truth for evicting a direct
+ * continuable child's resident activation via the harness
+ * `drainContinuableChildren` seam (plan
+ * docs/plans/2026-09-30-subagent-release-valve.md §4 D1). Consumed by the
+ * model-facing `release_agent` tool and the human-facing
+ * `/agents release <id>` command, so both surfaces render ONE copy set (§5)
+ * and share ONE process-local marker state (F14: released rows are not
+ * representable upstream — the durable catalog survives a drain and reads
+ * `ready`).
+ *
+ * Residency derivation cross-reference: this module's registry reads derive
+ * residency exactly like the sibling sites `snapshot.ts residencyOf` (live
+ * `status === 'running'` → running, live-not-running → idle, absent →
+ * settled/ready) and `background-start.ts assertLiveCapacity` (a slot is held
+ * only while the registry reports `status === 'running'`).
+ * @module @dsh-cc/command-agents/release
+ */
+import { SessionId } from '@deepseek-ai/dsh-session';
+/** A release gate error whose `message` IS the final §5 copy. */
+export class ReleaseFailure extends Error {
+    reason;
+    constructor(reason, message) {
+        super(message);
+        this.reason = reason;
+    }
+}
+/** How long a drain may run before the caller reports still-resident (F4). */
+export const DRAIN_OBSERVE_TIMEOUT_MS = 10_000;
+// ---------------------------------------------------------------------------
+// Process-local markers (F14) — TWO sets: `releasing` and `released`.
+// markReleasing(id) adds releasing-membership AFTER the final throwIfAborted
+// and BEFORE drain issuance (F12a: an armed first-epoch collect resolves
+// DURING the drain, so the releasing mark must already be visible then).
+// markReleased(id) moves the id releasing → released (removes releasing
+// membership).
+// clearReleasing(id) removes releasing membership ONLY and is refused while
+// the id is released (a no-op then) — the invariant that makes a concurrent
+// retry's mark clobber-proof against a stale attempt's late handlers
+// (critic r5 #3). The timeout arm KEEPS the releasing mark and attaches a
+// late completion continuation (step 5). Snapshot tagging rule:
+// (isReleased(id) || isReleasing(id)) && registry-absent-at-snapshot-time —
+// never from the marker alone.
+// ---------------------------------------------------------------------------
+const releasing = new Set();
+const released = new Set();
+/** Enter the releasing state (pre-issuance; F12a). */
+export function markReleasing(id) {
+    releasing.add(id);
+}
+/** Terminal success: move the id releasing → released. */
+export function markReleased(id) {
+    releasing.delete(id);
+    released.add(id);
+}
+/** Withdraw a releasing mark; refused (no-op) while the id is released. */
+export function clearReleasing(id) {
+    if (released.has(id))
+        return;
+    releasing.delete(id);
+}
+export function isReleased(id) {
+    return released.has(id);
+}
+export function isReleasing(id) {
+    return releasing.has(id);
+}
+/** Test-only: clears BOTH sets. */
+export function resetReleasedMarkers() {
+    releasing.clear();
+    released.clear();
+}
+// ---------------------------------------------------------------------------
+// Copy helpers (F15 normalization).
+// ---------------------------------------------------------------------------
+function errorText(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function catalogUnreadableCopy(id, cause) {
+    return `Cannot verify ${id} against this session's child catalog (${cause}); refusing to release blind. Retry, or restart the session if listing stays broken.`;
+}
+function failureMessage(reason, id, detail) {
+    switch (reason) {
+        case 'unknown-id':
+            return `No agent ${id} among this session's continuable children; use list_agents or /agents for current ids.`;
+        case 'not-continuable':
+            return `Agent ${id} is not a continuable child (mode: ${detail ?? 'unknown'}); release only covers continuable children.`;
+        case 'no-drain-seam':
+            return `Cannot release ${id}: this composition's subagents seam exposes no drainContinuableChildren; free capacity by letting children settle or by restarting the session.`;
+        case 'catalog-unreadable':
+            return catalogUnreadableCopy(id, detail ?? '');
+        case 'not-direct-child':
+            return `Agent ${id} is not a direct child of this session (the drain seam refused with UNAUTHORIZED); release its direct parent instead — if that parent is one of this session's children. Releasing a parent evicts its whole resident subtree.`;
+        case 'stale-parent':
+            return `This session's agent handle is stale (the drain seam refused with UNAUTHORIZED against the parent identity); retry the release, or restart the turn if it persists.`;
+    }
+}
+const NO_LIST_CHILDREN_CAUSE = 'the subagents seam exposes no listChildren';
+function sleep(ms) {
+    return new Promise(resolve => { setTimeout(resolve, ms); });
+}
+function guardedRegistryRead(agents, id) {
+    if (agents === undefined || typeof agents.get !== 'function')
+        return { kind: 'unobservable' };
+    try {
+        const row = agents.get(id);
+        return row === undefined ? { kind: 'absent' } : { kind: 'present', status: row.status };
+    }
+    catch {
+        return { kind: 'unobservable' };
+    }
+}
+function preStatusOf(status) {
+    if (status === 'running' || status === 'idle')
+        return status;
+    return 'unknown';
+}
+/**
+ * Run one release against the authoritative drain seam. Gate errors precede
+ * any marking/drain; every transition is test-pinned (plan §4 D1 step list).
+ */
+export async function runRelease(deps) {
+    const { parent, id } = deps;
+    const subagents = deps.subagents;
+    const agents = deps.agents;
+    const signal = deps.signal ?? new AbortController().signal;
+    // Step 0: seam gates before any marking or drain.
+    if (subagents === undefined || typeof subagents.drainContinuableChildren !== 'function') {
+        throw new ReleaseFailure('no-drain-seam', failureMessage('no-drain-seam', id, undefined));
+    }
+    signal.throwIfAborted();
+    // Step 1: catalog read (guarded).
+    let catalog;
+    let catalogMode;
+    let catalogCause;
+    if (typeof subagents.listChildren !== 'function') {
+        catalog = 'unreadable';
+        catalogCause = NO_LIST_CHILDREN_CAUSE;
+    }
+    else {
+        try {
+            const rows = await subagents.listChildren(SessionId(parent.id), signal);
+            const row = rows.find(entry => String(entry.id) === id);
+            if (row === undefined) {
+                catalog = 'clean-miss';
+            }
+            else {
+                catalog = 'clean-hit';
+                catalogMode = row.mode;
+            }
+        }
+        catch (error) {
+            if (signal.aborted)
+                throw error; // cancellation is never catalog failure
+            catalog = 'unreadable';
+            catalogCause = errorText(error);
+        }
+    }
+    // Step 2: registry pre-read (guarded). `preStatus` is captured only on a hit.
+    const preRead = guardedRegistryRead(agents, id);
+    const preStatus = preRead.kind === 'present' ? preStatusOf(preRead.status) : undefined;
+    // Step 3: mode gate (clean catalog hit only).
+    if (catalog === 'clean-hit' && catalogMode !== 'continuable') {
+        throw new ReleaseFailure('not-continuable', failureMessage('not-continuable', id, catalogMode ?? 'unknown'));
+    }
+    // Step 4: the catalog × registry matrix.
+    if (catalog === 'clean-miss' && preRead.kind !== 'present') {
+        // miss × miss and miss × unobservable both refuse without a drain.
+        throw new ReleaseFailure('unknown-id', failureMessage('unknown-id', id, undefined));
+    }
+    if (catalog === 'unreadable' && preRead.kind !== 'present') {
+        // unreadable × miss and unreadable × unobservable refuse blind.
+        throw new ReleaseFailure('catalog-unreadable', catalogUnreadableCopy(id, catalogCause ?? ''));
+    }
+    if (catalog === 'clean-hit' && preRead.kind === 'absent') {
+        return { kind: 'not-resident', id, releasedEarlier: isReleased(id) };
+    }
+    // A drain row: catalogNote from the matrix.
+    const catalogNote = catalog === 'clean-hit' ? 'catalog'
+        : catalog === 'clean-miss' ? 'registry-only'
+            : 'catalog-unreadable';
+    // Step 5: the honored-cancellation checkpoint comes FIRST, then the mark,
+    // then issuance (critic r5 #1: an abort must never orphan a releasing mark
+    // on an unissued drain).
+    signal.throwIfAborted();
+    markReleasing(id);
+    const drain = subagents.drainContinuableChildren(parent, [SessionId(id)]);
+    const withCause = () => catalogNote === 'catalog-unreadable' && catalogCause !== undefined
+        ? { cause: catalogCause }
+        : {};
+    // Race the drain against the observe timeout; the timer is cleared on BOTH
+    // settle arms (grok r5 #6: a leftover rejecting timer is an unhandled
+    // rejection on the happy path).
+    let timer;
+    const timedOut = new Promise(resolve => {
+        timer = setTimeout(() => resolve('timeout'), DRAIN_OBSERVE_TIMEOUT_MS);
+    });
+    const settled = await Promise.race([
+        drain.then(() => 'resolved', error => ({ kind: 'rejected', error })),
+        timedOut,
+    ]).finally(() => { clearTimeout(timer); });
+    if (settled === 'timeout') {
+        // KEEP the releasing mark and attach a fully-total late continuation.
+        void drain.then(() => {
+            // Late resolve: absent ⇒ released (tag becomes visible); present ⇒
+            // clearReleasing (refused while released); unobservable ⇒ KEEP the
+            // releasing mark — a pure no-op, never a re-insert into releasing
+            // after markReleased (critic r6 #4 / grok r6 #6). Never throws.
+            try {
+                const read = guardedRegistryRead(agents, id);
+                if (read.kind === 'absent')
+                    markReleased(id);
+                else if (read.kind === 'present')
+                    clearReleasing(id);
+                // unobservable: keep the releasing mark (fail-open).
+            }
+            catch { /* total: swallow */ }
+        }, error => {
+            try {
+                const code = error?.code;
+                if (code === 'ACTIVATION_TEARDOWN_FAILED') {
+                    // The seam's disposal order deletes the resident entry before
+                    // throwing (F4) — the same evidence as the sync arm.
+                    const read = guardedRegistryRead(agents, id);
+                    if (read.kind !== 'present')
+                        markReleased(id);
+                    else
+                        clearReleasing(id);
+                }
+                else {
+                    clearReleasing(id);
+                }
+            }
+            catch { /* total: swallow */ }
+        });
+        return { kind: 'still-resident', id, drainPending: true };
+    }
+    if (typeof settled === 'object' && settled !== null && 'kind' in settled && settled.kind === 'rejected') {
+        const error = settled.error;
+        const message = errorText(error);
+        if (message.includes('not a direct child')) {
+            clearReleasing(id);
+            throw new ReleaseFailure('not-direct-child', failureMessage('not-direct-child', id, undefined));
+        }
+        if (message.includes('exact live parent')) {
+            clearReleasing(id);
+            throw new ReleaseFailure('stale-parent', failureMessage('stale-parent', id, undefined));
+        }
+        if (error?.code === 'ACTIVATION_TEARDOWN_FAILED') {
+            // F4's code-order pin: the resident entry is deleted BEFORE the throw,
+            // so absent-or-unobservable after this rejection is degraded success.
+            const read = guardedRegistryRead(agents, id);
+            if (read.kind !== 'present') {
+                markReleased(id);
+                return {
+                    kind: 'evicted-degraded', id, failure: message, catalogNote, ...withCause(),
+                };
+            }
+            clearReleasing(id);
+            throw error;
+        }
+        clearReleasing(id);
+        throw error;
+    }
+    const preReadWasHit = preRead.kind === 'present';
+    if (!preReadWasHit) {
+        // Pre-read never observed residency — possible only on the catalog-hit
+        // row. Zero residency evidence means the released label is never
+        // claimable (orchestrator ruling on the unnamed cell, matching the r2/r3
+        // adultery guard class): post absent OR unobservable ⇒ issued (no mark,
+        // no slot claim); only a still-present read is evidence something was
+        // there, and then the bounded poll applies.
+        let post = guardedRegistryRead(agents, id);
+        for (let attempt = 1; attempt <= 10 && post.kind === 'present'; attempt++) {
+            await sleep(200);
+            post = guardedRegistryRead(agents, id);
+        }
+        clearReleasing(id);
+        return post.kind === 'present'
+            ? { kind: 'still-resident', id, drainPending: false }
+            : { kind: 'issued-unobservable', id, catalogNote: 'catalog' };
+    }
+    let read = guardedRegistryRead(agents, id);
+    if (read.kind === 'absent') {
+        markReleased(id);
+        return { kind: 'released', id, preStatus: preStatus ?? 'unknown', catalogNote, ...withCause() };
+    }
+    if (read.kind === 'unobservable') {
+        // Observability died between pre- and post-read (grok r6 #3): the drain's
+        // resolution plus the pre-read hit is the eviction evidence; the tag's
+        // render degrades per §5's contradictions entry.
+        markReleased(id);
+        return { kind: 'released', id, preStatus: preStatus ?? 'unknown', catalogNote, ...withCause() };
+    }
+    for (let attempt = 1; attempt <= 10; attempt++) {
+        await sleep(200);
+        read = guardedRegistryRead(agents, id);
+        if (read.kind !== 'present') {
+            // absent: the F4 causation rule (pre-hit + resolved + post-absent ⇒
+            // released). unobservable after a pre-read HIT: observability died
+            // mid-flight (grok r6 #3) — the drain resolution is still eviction
+            // evidence; the tag's render degrades per §5's contradictions entry.
+            markReleased(id);
+            return { kind: 'released', id, preStatus: preStatus ?? 'unknown', catalogNote, ...withCause() };
+        }
+    }
+    clearReleasing(id);
+    return { kind: 'still-resident', id, drainPending: false };
+}
+// ---------------------------------------------------------------------------
+// §5 copy renderer — ONE renderer keyed by (kind, preStatus, catalogNote).
+// Every string here is a full-equality-pinned contract (plan §5).
+// ---------------------------------------------------------------------------
+/** Provenance prepends for the eviction-claiming kinds. */
+function provenancePrepend(outcome, id) {
+    if (outcome.catalogNote === 'registry-only') {
+        return `(Note: ${id} was absent from the readable child catalog — released via the live registry only.) `;
+    }
+    if (outcome.catalogNote === 'catalog-unreadable') {
+        return `(Note: the child catalog was unreadable (${outcome.cause}) — released via the live registry only.) `;
+    }
+    return '';
+}
+/**
+ * Render a release outcome as the final user-facing text. Every §5 variant
+ * is a verbatim contract; the descendant clause rides on every
+ * eviction-claiming string.
+ */
+export function renderReleaseOutcome(outcome) {
+    const { id } = outcome;
+    switch (outcome.kind) {
+        case 'released': {
+            const prepend = provenancePrepend(outcome, id);
+            const body = outcome.preStatus === 'running'
+                ? `Released agent ${id}: its in-flight turn was aborted and its resident activation evicted — the capacity slot it held is free. Its resident descendants (if any) were evicted with it. The persisted session survives on disk. Within this session it cannot be continued (send_message resolves but runs no turn — upstream cold-resume-after-drain gap); /agents marks it [released] for the rest of this process.`
+                : outcome.preStatus === 'idle'
+                    ? `Released agent ${id}: its resident (idle) activation was evicted; it held no capacity slot (only running children count toward the 25-child guard). Its resident descendants (if any) were evicted with it. The persisted session survives on disk; within this session it cannot be continued (upstream cold-resume-after-drain gap); /agents marks it [released] for the rest of this process.`
+                    : `Released agent ${id}: its resident activation was evicted; any capacity slot it held is free (its running state could not be observed). Its resident descendants (if any) were evicted with it. The persisted session survives on disk; within this session it cannot be continued (upstream cold-resume-after-drain gap); /agents marks it [released] for the rest of this process.`;
+            return prepend + body;
+        }
+        case 'issued-unobservable':
+            return `Release of agent ${id} was issued against the authoritative drain seam; this composition cannot observe the registry, so residency after the drain could not be confirmed and the child is NOT marked released. Eviction, when it applies, also covers resident descendants. If it was resident, the drain evicts it by the seam's own contract; its continuation state here is unknown.`;
+        case 'evicted-degraded': {
+            const prepend = provenancePrepend(outcome, id);
+            return prepend + `Release of agent ${id} reported a teardown failure (${outcome.failure}), but the activation entry is removed before that failure surfaces per the seam's disposal order — any capacity slot is free. Its resident descendants (if any) were evicted with it. The persisted session survives on disk; within this session it cannot be continued; /agents marks it [released] for the rest of this process.`;
+        }
+        case 'not-resident':
+            return outcome.releasedEarlier
+                ? `Agent ${id} was released earlier in this process and has no resident activation; nothing was evicted.`
+                : `Agent ${id} has no resident activation (settled or released); nothing was evicted and no capacity slot is held by it.`;
+        case 'still-resident':
+            return outcome.drainPending
+                ? `Release of agent ${id} is in flight: its turn did not reach idle within 10s (a cancel-resistant turn). The release still completes by itself if the turn ever becomes idle — /agents then marks it [released] — but nothing locally force-evicts a cancel-resistant turn; a process restart is the only hard boundary.`
+                : `Release of agent ${id} was issued, but the registry still reports it resident after the drain; check /agents detail ${id} and retry if it persists.`;
+    }
+}
+//# sourceMappingURL=release.js.map

package/lib/release.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release.js","sourceRoot":"","sources":["../src/release.ts"],"names":[],"mappings":"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"}

package/lib/snapshot.d.ts

@@ -27,6 +27,12 @@ export interface AgentRow {
     readonly hasChildren: boolean;
     /** Pin state; `undefined` when the child has no resume pin. */
     readonly pin?: AgentPinView;
+    /**
+     * Release-valve tag: the id sits in this process's released/releasing
+     * marker sets AND the row is `ready` (registry-absent at snapshot time) —
+     * per the D1 tagging rule, never from the marker alone.
+     */
+    readonly released?: boolean;
     /** The parent session id the listing was rooted at. */
     readonly parentId: string;
 }
@@ -94,6 +100,13 @@ export interface SnapshotServices {
         id: string;
         hasChildren?: boolean;
     }[]>;
+    /**
+     * Release-valve markers (process-local, F14): optional so compositions
+     * without the release module still snapshot; when present they gate the
+     * `[released]` tag and the stop-copy overrides.
+     */
+    isReleased?(id: string): boolean;
+    isReleasing?(id: string): boolean;
 }
 /**
  * Extract the stable bracketed gate deny code from a persisted deny reason
@@ -130,6 +143,9 @@ export type ParsedAgentsInput = {
 } | {
     readonly kind: 'stop';
     readonly id: string;
+} | {
+    readonly kind: 'release';
+    readonly id: string;
 } | {
     readonly kind: 'error';
     readonly text: string;
@@ -138,6 +154,8 @@ export type ParsedAgentsInput = {
 export declare function stopRunningCopy(id: string): string;
 /** Copy for a stop request on an idle/ready child (shared no-op explanation). */
 export declare function stopNotRunningCopy(id: string, residency: string): string;
+/** Copy for a stop request on a released (or releasing) child. */
+export declare function stopReleasedCopy(id: string): string;
 /** Copy for a stop/detail on an id the snapshot does not know. */
 export declare function unknownAgentCopy(id: string): string;
 /** Copy for the reserved `attach` namespace (P1). */

package/lib/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAA;AAEpD,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,+DAA+D;AAC/D,MAAM,WAAW,QAAQ;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAA;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,SAAS,CAAA;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wEAAwE;AACxE,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACtE,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAChF;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAA;IACzE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IACrD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,cAAc,GAAG,SAAS,CAAA;IAC9D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC;;;;;;;OAOG;IACH,eAAe,CAAC,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC,CAAA;IACpG;;;;OAIG;IACH,UAAU,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC,WAAW,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;CAClC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7D;AA6BD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,gBAAgB,EAC1B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAsCrB;AAYD,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAwBlE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,EACzC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,eAAe,EAAE,MAAM,GACtB,MAAM,CAyCR;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAErD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,qDAAqD;AACrD,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAoB/D"}

package/lib/snapshot.js

@@ -62,11 +62,18 @@ export async function buildAgentsSnapshot(services, parentSessionId) {
         if (entry.mode === 'one-shot')
             continue;
         const live = services.getAgent(String(entry.id));
+        const residency = residencyOf(live);
+        // Release-valve tagging rule (D1): the marker is process-local and the
+        // row must read registry-absent (`ready`) at snapshot time — never the
+        // marker alone (a live activation is not a released row).
+        const released = (services.isReleased?.(String(entry.id)) === true ||
+            services.isReleasing?.(String(entry.id)) === true) && residency === 'ready';
         list.push({
             id: String(entry.id),
             ...(entry.label !== undefined && entry.label.length > 0 ? { label: entry.label } : {}),
-            residency: residencyOf(live),
+            residency,
             hasChildren: childHasChildren.has(String(entry.id)),
+            ...(released ? { released: true } : {}),
             ...(() => {
                 const pin = pinViewOf(services.readPin(String(entry.id)));
                 return pin === undefined ? {} : { pin };
@@ -117,7 +124,8 @@ export function renderAgentsList(rows) {
                             ? ' [pin unreadable]'
                             : ' [pinned]';
             const childrenTag = row.hasChildren ? ' [has children]' : '';
-            lines.push(`  ${MARKERS[row.residency]} ${name} · ${shortIdOf(row.id)}${tag}${childrenTag}`);
+            const releasedTag = row.released === true ? ' [released]' : '';
+            lines.push(`  ${MARKERS[row.residency]} ${name} · ${shortIdOf(row.id)}${tag}${childrenTag}${releasedTag}`);
         }
     }
     return lines.join('\n');
@@ -134,6 +142,12 @@ export function renderAgentDetail(row, pin, pinPath, parentSessionId) {
     lines.push(`  residency: ${row.residency}`);
     lines.push(`  children: ${row.hasChildren ? 'present' : 'none'}`);
     lines.push(`  parent session: ${parentSessionId}`);
+    // Release-valve detail line: BEFORE the pin early-return, so an unpinned
+    // released row still discloses its process-local state.
+    if (row.released === true) {
+        lines.push('  released: this process — resident activation evicted or release in flight; '
+            + 'same-session continuation unavailable (upstream gap)');
+    }
     if (pin === undefined) {
         lines.push('  pin: none (not pinnable or not background-spawned)');
         return lines.join('\n');
@@ -172,6 +186,10 @@ export function stopRunningCopy(id) {
 export function stopNotRunningCopy(id, residency) {
     return `Agent ${id} is not running (residency: ${residency}); nothing to stop — it is resumable.`;
 }
+/** Copy for a stop request on a released (or releasing) child. */
+export function stopReleasedCopy(id) {
+    return `Agent ${id} was released (or its release is in flight) in this process; it cannot be continued here — nothing to stop.`;
+}
 /** Copy for a stop/detail on an id the snapshot does not know. */
 export function unknownAgentCopy(id) {
     return `No agent ${id} among this session's background agents; /agents lists current ids.`;
@@ -196,6 +214,12 @@ export function parseAgentsInput(raw) {
         }
         return { kind: 'stop', id: parts[1] };
     }
+    if (parts[0] === 'release') {
+        if (parts.length < 2 || parts[1].length === 0) {
+            return { kind: 'error', text: 'Usage: /agents release <id>' };
+        }
+        return { kind: 'release', id: parts[1] };
+    }
     if (parts[0] === 'attach') {
         return { kind: 'error', text: attachReservedCopy() };
     }

package/lib/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dsh-cc/command-agents",
   "description": "Human-facing slash command to list, inspect, and stop continuable background agents",
-  "version": "0.8.2-rc.1",
+  "version": "0.8.3-rc.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dsh-cc/dsh-cc.git",
@@ -17,6 +17,10 @@
       "types": "./lib/snapshot.d.ts",
       "default": "./lib/snapshot.js"
     },
+    "./release": {
+      "types": "./lib/release.d.ts",
+      "default": "./lib/release.js"
+    },
     "./invariant": {
       "types": "./lib/invariant.d.ts",
       "default": "./lib/invariant.js"
@@ -29,11 +33,11 @@
   ],
   "license": "Apache-2.0",
   "peerDependencies": {
-    "@deepseek-ai/dsh-commands": ">=0.1.7-rc.2",
-    "@deepseek-ai/dsh-invariants": ">=0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": ">=0.1.7-rc.2",
-    "@deepseek-ai/cordis": ">=0.1.7-rc.2",
-    "@dsh-cc/subagent-resume-pins": "^0.8.2-rc.1"
+    "@deepseek-ai/dsh-commands": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-invariants": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": ">=0.2.0-rc.2",
+    "@deepseek-ai/cordis": ">=0.2.0-rc.2",
+    "@dsh-cc/subagent-resume-pins": "^0.8.3-rc.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-loader": "link:../../../../deepseek-harness/vendor/loader",
@@ -42,12 +46,12 @@
     "@deepseek-ai/dsh-invariants": "link:../../../../deepseek-harness/packages/runtime-diagnostics/invariants",
     "@deepseek-ai/dsh-session": "link:../../../../deepseek-harness/packages/core/session",
     "@deepseek-ai/cordis": "link:../../../../deepseek-harness/vendor/cordis",
-    "@dsh-cc/subagent-resume-pins": "^0.8.2-rc.1"
+    "@dsh-cc/subagent-resume-pins": "^0.8.3-rc.1"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@dsh-cc/command-usage": "^0.8.2-rc.1"
+    "@dsh-cc/command-usage": "^0.8.3-rc.1"
   }
 }