@dsh-cc/subagent-task 0.5.0 → 0.6.1

package/lib/one-shot-ledger.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Process-level one-shot subagent ledger (memory-recall hardening follow-ups
+ * W2a, `docs/plans/2026-09-09-memory-recall-hardening-followups.md` §2 W2):
+ * one shared `subagent/start` + `subagent/end` listener pair (mirroring
+ * `epoch-collector.ts` wiring) folds every run the process observes into
+ * rows keyed by runId.
+ *
+ * Pairing is BY RUN ID, never by child id: a cold-resumed child gets a new
+ * runId and must not satisfy a stale watcher (epoch-collector's documented
+ * lesson). Parentage resolves from the child's session header
+ * `parentSession` via the `agents` seam (`ctx.agents.get(id)`), the same
+ * probe the TUI driver uses; unresolvable parentage is kept but treated as
+ * unscoped and never injected into any session's context.
+ *
+ * Internal (infra-fork) classification prefers the child's session
+ * descriptor metadata — the `subagent/descriptor` event's `label` — falling
+ * back to nothing (a child with no descriptor label is never internal on
+ * label grounds). {@link INTERNAL_LABELS} lists the production labels that
+ * must always classify as internal; a completeness test pins it.
+ *
+ * Rows prune by TTL both after ending AND while active (a crashed child may
+ * never emit `end`); an `end` arriving after its row was pruned is a no-op.
+ *
+ * @module @dsh-cc/subagent-task/one-shot-ledger
+ */
+/** Production labels that mark a child as internal dsh-cc infrastructure. */
+export declare const INTERNAL_LABELS: readonly string[];
+/** One observed subagent run. */
+export interface OneShotLedgerRow {
+    /** Unique identity shared by the paired start/end events. */
+    runId: string;
+    /** The child agent's (session) id. */
+    id: string;
+    /** Provider name snapshot from the events. */
+    provider: string;
+    /** Creation label from the child's session descriptor, when enumerable. */
+    label?: string;
+    /** Parent session id resolved from the child's session header, when resolvable. */
+    parentId?: string;
+    /** Wall-clock ms when the start event arrived. */
+    startedAt: number;
+    /** Wall-clock ms when the paired end event arrived. */
+    endedAt?: number;
+    /** Terminal stop reason from the end event. */
+    stopReason?: string;
+    /** True when the child is internal dsh-cc infrastructure (descriptor label ∈ {@link INTERNAL_LABELS}). */
+    internal: boolean;
+    /** Descriptor mode snapshot when enumerable (`one-shot` / `continuable`). */
+    mode?: string;
+}
+/** The duck-typed child-agent snapshot probed for parentage/label metadata. */
+export interface LedgerChildSnapshot {
+    session?: {
+        id?: unknown;
+        header?: {
+            parentSession?: unknown;
+        };
+        events?: readonly {
+            type?: string;
+            data?: {
+                label?: unknown;
+                mode?: unknown;
+            };
+        }[];
+    };
+}
+/** Duck-typed `ctx.agents` accessor for child-session parentage probes. */
+export interface LedgerAgents {
+    get?(id: string): LedgerChildSnapshot | undefined;
+}
+/** Duck-typed event bus (cordis `ctx.on`) the lifecycle events arrive on. */
+export interface LedgerEventBus {
+    on(event: string, listener: (info: Record<string, unknown>) => void): (() => void) | void;
+}
+export interface OneShotLedgerDeps {
+    /** The bus the shared listener pair subscribes to. */
+    bus: LedgerEventBus;
+    /** The live agent registry (`ctx.agents`) used for parentage/label probes. */
+    agents?: LedgerAgents | undefined;
+    /** Wall clock; defaults to `Date.now`. */
+    now?: () => number;
+    /** How long an ended row stays queryable. Default 5 minutes. */
+    endedTtlMs?: number;
+    /** How long a never-ended (active) row stays queryable. Default 60 minutes. */
+    activeTtlMs?: number;
+}
+export declare const DEFAULT_ENDED_TTL_MS: number;
+export declare const DEFAULT_ACTIVE_TTL_MS: number;
+/**
+ * Create the ledger and attach its shared `subagent/start` / `subagent/end`
+ * listener pair to the bus (mirrors `epoch-collector`'s shared-watcher
+ * wiring). The returned handle prunes lazily on every read.
+ */
+export declare function createOneShotLedger(deps: OneShotLedgerDeps): {
+    rows(): readonly OneShotLedgerRow[];
+    activeFor(parentId: string): readonly OneShotLedgerRow[];
+    dispose(): void;
+};
+//# sourceMappingURL=one-shot-ledger.d.ts.map

package/lib/one-shot-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-shot-ledger.d.ts","sourceRoot":"","sources":["../src/one-shot-ledger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAS5C,CAAA;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAA;IACb,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAA;IACV,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAA;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,0GAA0G;IAC1G,QAAQ,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE;QACR,EAAE,CAAC,EAAE,OAAO,CAAA;QACZ,MAAM,CAAC,EAAE;YAAE,aAAa,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;QACpC,MAAM,CAAC,EAAE,SAAS;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE;gBAAE,KAAK,CAAC,EAAE,OAAO,CAAC;gBAAC,IAAI,CAAC,EAAE,OAAO,CAAA;aAAE,CAAA;SAAE,EAAE,CAAA;KAClF,CAAA;CACF;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAA;CAClD;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;CAC1F;AAED,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,GAAG,EAAE,cAAc,CAAA;IACnB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACjC,0CAA0C;IAC1C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,eAAO,MAAM,oBAAoB,QAAa,CAAA;AAC9C,eAAO,MAAM,qBAAqB,QAAc,CAAA;AAmBhD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG;IAC5D,IAAI,IAAI,SAAS,gBAAgB,EAAE,CAAA;IACnC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,gBAAgB,EAAE,CAAA;IACxD,OAAO,IAAI,IAAI,CAAA;CAChB,CAuDA"}

package/lib/one-shot-ledger.js

@@ -0,0 +1,113 @@
+/**
+ * Process-level one-shot subagent ledger (memory-recall hardening follow-ups
+ * W2a, `docs/plans/2026-09-09-memory-recall-hardening-followups.md` §2 W2):
+ * one shared `subagent/start` + `subagent/end` listener pair (mirroring
+ * `epoch-collector.ts` wiring) folds every run the process observes into
+ * rows keyed by runId.
+ *
+ * Pairing is BY RUN ID, never by child id: a cold-resumed child gets a new
+ * runId and must not satisfy a stale watcher (epoch-collector's documented
+ * lesson). Parentage resolves from the child's session header
+ * `parentSession` via the `agents` seam (`ctx.agents.get(id)`), the same
+ * probe the TUI driver uses; unresolvable parentage is kept but treated as
+ * unscoped and never injected into any session's context.
+ *
+ * Internal (infra-fork) classification prefers the child's session
+ * descriptor metadata — the `subagent/descriptor` event's `label` — falling
+ * back to nothing (a child with no descriptor label is never internal on
+ * label grounds). {@link INTERNAL_LABELS} lists the production labels that
+ * must always classify as internal; a completeness test pins it.
+ *
+ * Rows prune by TTL both after ending AND while active (a crashed child may
+ * never emit `end`); an `end` arriving after its row was pruned is a no-op.
+ *
+ * @module @dsh-cc/subagent-task/one-shot-ledger
+ */
+/** Production labels that mark a child as internal dsh-cc infrastructure. */
+export const INTERNAL_LABELS = [
+    // packages/memory/memory/src/recall.ts (the recall selector)
+    'memory-recall',
+    // packages/memory/memory-consolidation/src/index.ts (startMemoryJob call sites)
+    'extract-memories',
+    'memory-consolidation',
+    // packages/hooks/hooks-claude-code/src/dispatch.ts (CC hook bridge forks)
+    'hook-prompt',
+    'hook-agent',
+];
+export const DEFAULT_ENDED_TTL_MS = 5 * 60_000;
+export const DEFAULT_ACTIVE_TTL_MS = 60 * 60_000;
+function resolveDescriptor(child) {
+    const event = child?.session?.events?.find(e => e.type === 'subagent/descriptor');
+    if (event === undefined)
+        return {};
+    return {
+        ...event.data?.label !== undefined ? { label: String(event.data.label) } : {},
+        ...event.data?.mode !== undefined ? { mode: String(event.data.mode) } : {},
+    };
+}
+function resolveParentId(child) {
+    const parent = child?.session?.header?.parentSession;
+    return parent === undefined || parent === null || parent === '' ? undefined : String(parent);
+}
+/**
+ * Create the ledger and attach its shared `subagent/start` / `subagent/end`
+ * listener pair to the bus (mirrors `epoch-collector`'s shared-watcher
+ * wiring). The returned handle prunes lazily on every read.
+ */
+export function createOneShotLedger(deps) {
+    const now = deps.now ?? Date.now;
+    const endedTtlMs = deps.endedTtlMs ?? DEFAULT_ENDED_TTL_MS;
+    const activeTtlMs = deps.activeTtlMs ?? DEFAULT_ACTIVE_TTL_MS;
+    // Rows the ledger keeps, keyed by runId (one row per epoch).
+    const rowsByRunId = new Map();
+    const offStart = deps.bus.on('subagent/start', info => {
+        const id = String(info.id);
+        const child = deps.agents?.get?.(id);
+        const descriptor = resolveDescriptor(child);
+        const label = descriptor.label;
+        const parentId = resolveParentId(child);
+        rowsByRunId.set(String(info.runId), {
+            runId: String(info.runId),
+            id,
+            provider: String(info.provider),
+            ...label !== undefined ? { label } : {},
+            ...parentId !== undefined ? { parentId } : {},
+            startedAt: now(),
+            internal: label !== undefined && INTERNAL_LABELS.includes(label),
+            ...descriptor.mode !== undefined ? { mode: descriptor.mode } : {},
+        });
+    });
+    const offEnd = deps.bus.on('subagent/end', info => {
+        const runId = String(info.runId);
+        const row = rowsByRunId.get(runId);
+        if (row === undefined)
+            return; // pruned or never started: a no-op
+        row.endedAt = now();
+        row.stopReason = String(info.stopReason);
+    });
+    const prune = () => {
+        const t = now();
+        for (const [runId, row] of rowsByRunId) {
+            if (row.endedAt !== undefined ? t - row.endedAt > endedTtlMs : t - row.startedAt > activeTtlMs) {
+                rowsByRunId.delete(runId);
+            }
+        }
+    };
+    return {
+        rows() {
+            prune();
+            return [...rowsByRunId.values()];
+        },
+        activeFor(parentId) {
+            prune();
+            return [...rowsByRunId.values()].filter(row => row.parentId === parentId && row.endedAt === undefined
+                // Unresolvable parentage is never scoped to any session.
+                && row.parentId !== undefined);
+        },
+        dispose() {
+            offStart?.();
+            offEnd?.();
+        },
+    };
+}
+//# sourceMappingURL=one-shot-ledger.js.map

package/lib/one-shot-ledger.js.map

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

package/lib/one-shot-notice.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Parent-scoped subagent-child notice (memory-recall hardening follow-ups
+ * W2c): on `agent/pre-step`, ONLY the agent whose `session.id` matches a
+ * ledger row's `parentId` gets one folded observe-only line — contributed
+ * via `agent.inject()` + `createUserMessage` with a dedicated
+ * `MessageSourceMap` kind, mirroring `packages/memory/memory/src/recall.ts`'s
+ * contribution shape — when that session has ≥1 active non-internal
+ * one-shot child. Zero emission otherwise: sessions with no children see
+ * nothing; internal-only activity yields at most a folded count, never
+ * per-child rows.
+ *
+ * Registration follows `strip-instructions.ts` / `suppress-settled.ts`: a
+ * plain `agent/pre-step` waterfall listener that delegates to `next()`
+ * unchanged (observe-only). No `prepend` — unlike the strip, this listener
+ * reads only the ledger and its own agent, so ordering is irrelevant.
+ *
+ * @module @dsh-cc/subagent-task/one-shot-notice
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { OneShotLedgerRow } from './one-shot-ledger.ts';
+declare module '@deepseek-ai/dsh-llm' {
+    interface MessageSourceMap {
+        ccSubagentChild: {
+            kind: 'cc-subagent-children';
+        };
+    }
+}
+/** MessageSourceMap kind for the observe-only child notice. */
+export declare const CHILD_NOTICE_SOURCE_KIND = "cc-subagent-children";
+/**
+ * Fold the active children of one parent into the single observe-only line.
+ * Non-internal children surface their labels; internal children fold into a
+ * bare count (`… +N internal`), and internal-only activity yields a count
+ * line with no per-child rows at all.
+ */
+export declare function foldChildNotice(rows: readonly {
+    label?: string;
+    internal: boolean;
+}[]): string;
+/** The ledger surface the notice listener reads. */
+export interface ChildNoticeLedger {
+    activeFor(parentId: string): readonly OneShotLedgerRow[];
+}
+/**
+ * Mount the `agent/pre-step` child-notice listener.
+ * @param ctx - the plug context.
+ * @param ledger - the ledger to read.
+ * @returns an unmount callback.
+ */
+export declare function mountSubagentChildNotice(ctx: Context, ledger: ChildNoticeLedger): () => void;
+//# sourceMappingURL=one-shot-notice.d.ts.map

package/lib/one-shot-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-shot-notice.d.ts","sourceRoot":"","sources":["../src/one-shot-notice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,gBAAgB;QACxB,eAAe,EAAE;YAAE,IAAI,EAAE,sBAAsB,CAAA;SAAE,CAAA;KAClD;CACF;AAED,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,yBAAyB,CAAA;AAE9D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,EAAE,GAAG,MAAM,CAW9F;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,gBAAgB,EAAE,CAAA;CACzD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAmB5F"}

package/lib/one-shot-notice.js

@@ -0,0 +1,71 @@
+/**
+ * Parent-scoped subagent-child notice (memory-recall hardening follow-ups
+ * W2c): on `agent/pre-step`, ONLY the agent whose `session.id` matches a
+ * ledger row's `parentId` gets one folded observe-only line — contributed
+ * via `agent.inject()` + `createUserMessage` with a dedicated
+ * `MessageSourceMap` kind, mirroring `packages/memory/memory/src/recall.ts`'s
+ * contribution shape — when that session has ≥1 active non-internal
+ * one-shot child. Zero emission otherwise: sessions with no children see
+ * nothing; internal-only activity yields at most a folded count, never
+ * per-child rows.
+ *
+ * Registration follows `strip-instructions.ts` / `suppress-settled.ts`: a
+ * plain `agent/pre-step` waterfall listener that delegates to `next()`
+ * unchanged (observe-only). No `prepend` — unlike the strip, this listener
+ * reads only the ledger and its own agent, so ordering is irrelevant.
+ *
+ * @module @dsh-cc/subagent-task/one-shot-notice
+ */
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+/** MessageSourceMap kind for the observe-only child notice. */
+export const CHILD_NOTICE_SOURCE_KIND = 'cc-subagent-children';
+/**
+ * Fold the active children of one parent into the single observe-only line.
+ * Non-internal children surface their labels; internal children fold into a
+ * bare count (`… +N internal`), and internal-only activity yields a count
+ * line with no per-child rows at all.
+ */
+export function foldChildNotice(rows) {
+    const visible = rows.filter(row => !row.internal);
+    const internalCount = rows.length - visible.length;
+    if (visible.length === 0 && internalCount === 0)
+        return '';
+    const parts = [];
+    if (visible.length > 0) {
+        const labels = visible.map(row => row.label ?? 'unlabeled');
+        parts.push(`${visible.length} active subagent child${visible.length === 1 ? '' : 'ren'}: ${labels.join(', ')}`);
+    }
+    if (internalCount > 0)
+        parts.push(`+${internalCount} internal`);
+    return `[observe] ${parts.join(' ')}`.trim();
+}
+/**
+ * Mount the `agent/pre-step` child-notice listener.
+ * @param ctx - the plug context.
+ * @param ledger - the ledger to read.
+ * @returns an unmount callback.
+ */
+export function mountSubagentChildNotice(ctx, ledger) {
+    return ctx.on('agent/pre-step', async ({ agent }, next) => {
+        const decision = await next();
+        // Fire-and-forget: the notice is model-visible enrichment, never worth
+        // an unhandled rejection in the host.
+        try {
+            const sid = agent.session?.id;
+            if (sid === undefined)
+                return decision;
+            const active = ledger.activeFor(String(sid));
+            if (active.length === 0)
+                return decision;
+            agent.inject(createUserMessage({
+                content: [{ type: 'text', text: foldChildNotice(active) }],
+                source: { kind: 'cc-subagent-children' },
+            }));
+        }
+        catch {
+            // Absent llm seam or inject surface: skip quietly.
+        }
+        return decision;
+    });
+}
+//# sourceMappingURL=one-shot-notice.js.map

package/lib/one-shot-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-shot-notice.js","sourceRoot":"","sources":["../src/one-shot-notice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AASxD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAA;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAsD;IACpF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACjD,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,IAAI,WAAW,CAAC,CAAA;QAC3D,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,yBAAyB,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACjH,CAAC;IACD,IAAI,aAAa,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,aAAa,WAAW,CAAC,CAAA;IAC/D,OAAO,aAAa,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAA;AAC9C,CAAC;AAOD;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAY,EAAE,MAAyB;IAC9E,OAAO,GAAG,CAAC,EAAE,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAoB,EAAE,IAAI,EAA4B,EAAE;QACpG,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAA;QAC7B,uEAAuE;QACvE,sCAAsC;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAI,KAAK,CAAC,OAAwC,EAAE,EAAE,CAAA;YAC/D,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,QAAQ,CAAA;YACtC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,QAAQ,CAAA;YACxC,KAAK,CAAC,MAAM,CAAC,iBAAiB,CAAC;gBAC7B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1D,MAAM,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE;aACzC,CAAC,CAAC,CAAA;QACL,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/lib/plugin-agents.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Live enumeration of plugin agent providers over the `subagents` seam.
+ *
+ * The CC Task tool treats the seam's registered agent providers purely as a
+ * DEFINITION source: `cc-plugin-loader`'s `mountAgents` registers one
+ * `AgentProvider` per plugin agent under the scoped id
+ * `` `${pluginName}:${agentType}` `` (the `namespacePrefix` mechanism), and
+ * this index enumerates them live on every call — plugin mounts are
+ * effect-scoped Cordis contexts that may appear (or disappear) after this
+ * plugin's `apply()`, so nothing is cached.
+ *
+ * Builtin providers (`spawn`, `fork`, …) are excluded naturally: they carry
+ * no `definition`.
+ *
+ * @module @dsh-cc/subagent-task/plugin-agents
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { AgentDefinition } from '@dsh-cc/claude-code-agents';
+import type { SubagentsLike } from './background-start.ts';
+/** Options for the index, mostly injectable seams for tests. */
+export interface PluginAgentIndexOptions {
+    /**
+     * Override the seam lookup (hermetic tests). Defaults to
+     * `ctx.get('subagents')`, re-read on every call.
+     */
+    seam?: () => SubagentsLike | undefined;
+}
+/**
+ * The structural guard for a plugin agent provider: a `start` function, a
+ * string `name` containing `:` (the scoped `plugin:agent` id), and a
+ * `definition` with a string `agentType` and `systemPrompt`. Builtin
+ * providers (spawn/fork/…) carry no definition and are excluded naturally.
+ *
+ * The guard additionally REQUIRES the loader brand (`Symbol.for(
+ * 'dsh-cc.plugin-agent-provider')`, plan §9.4): the structural shape alone is
+ * an accidental protocol any foreign provider could fake, so only providers
+ * the loader actually created are adopted.
+ *
+ * Precondition (load-bearing): the provider only carries a scoped name when
+ * `mountAgents` was given a `namespacePrefix` — no prefix at mount ⇒ the
+ * agent is undiscoverable: neither addressable by Task nor listed in the
+ * catalog.
+ */
+export declare function isPluginAgentProvider(provider: unknown): provider is {
+    name: string;
+    start: unknown;
+    definition: AgentDefinition;
+};
+/**
+ * A live view over the seam's plugin agent providers. All methods read the
+ * seam lazily on EVERY call so effect-scoped plugin mounts that appear after
+ * `apply()` are still discovered.
+ */
+export declare class PluginAgentIndex {
+    private readonly ctx;
+    private readonly seamOverride;
+    constructor(ctx: Context, options?: PluginAgentIndexOptions);
+    /** The seam, re-read on every call (lazy: mounts may appear after apply). */
+    private getSeam;
+    /**
+     * List every plugin agent currently registered on the seam, as
+     * `{ id, definition }` pairs. The scan is synchronous and uncached.
+     */
+    list(): {
+        id: string;
+        definition: AgentDefinition;
+    }[];
+    /**
+     * Resolve one plugin agent by its exact scoped id (`plugin:agent`).
+     * Bare plugin agent names are NOT addressable — matching CC, where plugin
+     * agents are addressed only by scoped id.
+     */
+    resolve(type: string): AgentDefinition | undefined;
+    /** A snapshot of the currently known scoped ids (for catalog diffing). */
+    knownIds(): string[];
+}
+//# sourceMappingURL=plugin-agents.d.ts.map

package/lib/plugin-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-agents.d.ts","sourceRoot":"","sources":["../src/plugin-agents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAiB1D,gEAAgE;AAChE,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,aAAa,GAAG,SAAS,CAAA;CACvC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,IAAI;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,UAAU,EAAE,eAAe,CAAA;CAC5B,CASA;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+C;gBAEhE,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,uBAA4B;IAK/D,6EAA6E;IAC7E,OAAO,CAAC,OAAO;IAKf;;;OAGG;IACH,IAAI,IAAI;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,eAAe,CAAA;KAAE,EAAE;IAerD;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIlD,0EAA0E;IAC1E,QAAQ,IAAI,MAAM,EAAE;CAGrB"}

package/lib/plugin-agents.js

@@ -0,0 +1,110 @@
+/**
+ * Live enumeration of plugin agent providers over the `subagents` seam.
+ *
+ * The CC Task tool treats the seam's registered agent providers purely as a
+ * DEFINITION source: `cc-plugin-loader`'s `mountAgents` registers one
+ * `AgentProvider` per plugin agent under the scoped id
+ * `` `${pluginName}:${agentType}` `` (the `namespacePrefix` mechanism), and
+ * this index enumerates them live on every call — plugin mounts are
+ * effect-scoped Cordis contexts that may appear (or disappear) after this
+ * plugin's `apply()`, so nothing is cached.
+ *
+ * Builtin providers (`spawn`, `fork`, …) are excluded naturally: they carry
+ * no `definition`.
+ *
+ * @module @dsh-cc/subagent-task/plugin-agents
+ */
+/**
+ * The loader's brand key, duplicated as a `Symbol.for` lookup instead of a
+ * runtime import of `@dsh-cc/plugin-loader` (a devDependency — a runtime
+ * import here would break published consumers). Kept in lockstep with
+ * `PLUGIN_AGENT_PROVIDER_BRAND` in the loader; both resolve to the same
+ * registry symbol.
+ */
+const PLUGIN_AGENT_PROVIDER_BRAND = Symbol.for('dsh-cc.plugin-agent-provider');
+/** Whether a value was created by the loader as a plugin agent provider. */
+function hasLoaderBrand(value) {
+    return typeof value === 'object' && value !== null
+        && value[PLUGIN_AGENT_PROVIDER_BRAND] === true;
+}
+/**
+ * The structural guard for a plugin agent provider: a `start` function, a
+ * string `name` containing `:` (the scoped `plugin:agent` id), and a
+ * `definition` with a string `agentType` and `systemPrompt`. Builtin
+ * providers (spawn/fork/…) carry no definition and are excluded naturally.
+ *
+ * The guard additionally REQUIRES the loader brand (`Symbol.for(
+ * 'dsh-cc.plugin-agent-provider')`, plan §9.4): the structural shape alone is
+ * an accidental protocol any foreign provider could fake, so only providers
+ * the loader actually created are adopted.
+ *
+ * Precondition (load-bearing): the provider only carries a scoped name when
+ * `mountAgents` was given a `namespacePrefix` — no prefix at mount ⇒ the
+ * agent is undiscoverable: neither addressable by Task nor listed in the
+ * catalog.
+ */
+export function isPluginAgentProvider(provider) {
+    if (!hasLoaderBrand(provider))
+        return false;
+    const candidate = provider;
+    if (typeof candidate.name !== 'string' || !candidate.name.includes(':'))
+        return false;
+    if (typeof candidate.start !== 'function')
+        return false;
+    const def = candidate.definition;
+    if (typeof def !== 'object' || def === null)
+        return false;
+    const shape = def;
+    return typeof shape.agentType === 'string' && typeof shape.systemPrompt === 'string';
+}
+/**
+ * A live view over the seam's plugin agent providers. All methods read the
+ * seam lazily on EVERY call so effect-scoped plugin mounts that appear after
+ * `apply()` are still discovered.
+ */
+export class PluginAgentIndex {
+    ctx;
+    seamOverride;
+    constructor(ctx, options = {}) {
+        this.ctx = ctx;
+        this.seamOverride = options.seam;
+    }
+    /** The seam, re-read on every call (lazy: mounts may appear after apply). */
+    getSeam() {
+        if (this.seamOverride !== undefined)
+            return this.seamOverride();
+        return this.ctx.get('subagents');
+    }
+    /**
+     * List every plugin agent currently registered on the seam, as
+     * `{ id, definition }` pairs. The scan is synchronous and uncached.
+     */
+    list() {
+        const seam = this.getSeam();
+        // The seam is duck-typed: a host (or test harness) may expose a partial
+        // seam without `list` — treat that as "no plugin agents", not a crash.
+        if (seam === undefined || typeof seam.list !== 'function')
+            return [];
+        const entries = [];
+        for (const name of seam.list()) {
+            const provider = seam.getProvider(name);
+            if (isPluginAgentProvider(provider)) {
+                entries.push({ id: provider.name, definition: provider.definition });
+            }
+        }
+        return entries.sort((a, b) => a.id.localeCompare(b.id));
+    }
+    /**
+     * Resolve one plugin agent by its exact scoped id (`plugin:agent`).
+     * Bare plugin agent names are NOT addressable — matching CC, where plugin
+     * agents are addressed only by scoped id.
+     */
+    resolve(type) {
+        return this.list().find(entry => entry.id === type)?.definition;
+    }
+    /** A snapshot of the currently known scoped ids (for catalog diffing). */
+    knownIds() {
+        return this.list().map(entry => entry.id);
+    }
+}
+//# sourceMappingURL=plugin-agents.js.map

package/lib/plugin-agents.js.map

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

package/lib/suppress-settled.d.ts

@@ -1,6 +1,6 @@
 /**
  * Duplicate-notice suppression for inline-collected subagent epochs
- * (`docs/plans/2026-09-10-epoch-collector-dsh-cc.md` §5): a pre-step
+ * (`docs/plans/2026-09-05-epoch-collector-dsh-cc.md` §5): a pre-step
  * waterfall listener that DROPs pending `subagent-settled` messages whose
  * `senderSessionId` is in the pop-once "collected" set, so a collected
  * epoch's settlement account lives only in the tool result and never also

package/lib/suppress-settled.js

@@ -1,6 +1,6 @@
 /**
  * Duplicate-notice suppression for inline-collected subagent epochs
- * (`docs/plans/2026-09-10-epoch-collector-dsh-cc.md` §5): a pre-step
+ * (`docs/plans/2026-09-05-epoch-collector-dsh-cc.md` §5): a pre-step
  * waterfall listener that DROPs pending `subagent-settled` messages whose
  * `senderSessionId` is in the pop-once "collected" set, so a collected
  * epoch's settlement account lives only in the tool result and never also

package/lib/tool.d.ts

@@ -18,6 +18,10 @@
  *   task text as the first user message, a routes-resolved `agentOptions`
  *   override, and the definition's tool restriction (sanitized of tool names
  *   this composition no longer registers).
+ * - A type matching a plugin agent's scoped id (`plugin:agent`, from the
+ *   `subagents` seam's namespaced providers) → the identical fold: the
+ *   provider's `AgentDefinition` is dispatched through the same `spawn`
+ *   provider mechanics; no new start path exists for plugin agents.
  * - Any other type → an error result listing the available types.
  *
  * The seam's capability contract (`assertCapabilities`) is honoured
@@ -33,6 +37,7 @@
  */
 import type { Context } from '@deepseek-ai/cordis';
 import type { AgentRegistry } from './registry.ts';
+import { PluginAgentIndex } from './plugin-agents.ts';
 import { SpawnPinCapture } from './resume-capture.ts';
 export { MAX_LIVE_CONTINUABLE_CHILDREN, CLAUDE_CODE_DISABLE_BACKGROUND_TASKS, backgroundTasksDisabled, } from './background-start.ts';
 /** The registered tool name (the CC display mapping surfaces it as `Task`). */
@@ -45,5 +50,5 @@ export declare const TASK_TOOL = "subagent_fork";
  *   no `resumePins` plugin config) writes no pins and runs no preflight.
  * @returns the registration disposer, or undefined when the tools seam is absent.
  */
-export declare function registerTaskTool(ctx: Context, registry: AgentRegistry, capture?: SpawnPinCapture): (() => void) | undefined;
+export declare function registerTaskTool(ctx: Context, registry: AgentRegistry, capture?: SpawnPinCapture, pluginIndex?: PluginAgentIndex): (() => void) | undefined;
 //# sourceMappingURL=tool.d.ts.map

package/lib/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAYrD,OAAO,EACL,6BAA6B,EAC7B,oCAAoC,EACpC,uBAAuB,GACxB,MAAM,uBAAuB,CAAA;AAE9B,+EAA+E;AAC/E,eAAO,MAAM,SAAS,kBAAkB,CAAA;AA8CxC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,eAAe,GACxB,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAkL1B"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAOlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAYrD,OAAO,EACL,6BAA6B,EAC7B,oCAAoC,EACpC,uBAAuB,GACxB,MAAM,uBAAuB,CAAA;AAE9B,+EAA+E;AAC/E,eAAO,MAAM,SAAS,kBAAkB,CAAA;AA8CxC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,eAAe,EACzB,WAAW,GAAE,gBAA4C,GACxD,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CA8M1B"}