@dsh-cc/subagent-task 0.6.0 → 0.6.2

package/README.i18n.yaml

@@ -1,6 +1,6 @@
 # Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
 # 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 run verify-translation-pairing --write packages/subagent/task/README.md
-README.md: 2f41225a5a429d06b1c499a0f764797183ce6ab4
-README.zh.md: 5388f67d88f9e8bec717ab5cb353e35e962de8b1
+#   pnpm check:readme --write
+README.md: d141a9d39756bd366011bb44f00436931504b194
+README.zh.md: 5592ec30d340dc25f2c158f36fb1782c0da4b9c4

package/lib/index.d.ts

@@ -23,6 +23,19 @@ export { registerTaskTool, TASK_TOOL, MAX_LIVE_CONTINUABLE_CHILDREN, CLAUDE_CODE
 export { collectFirstEpoch, collectorFor, collectorKey, registerCollector, unregisterCollector, collectorsForSession, registeredCollectorCount, markCollectedForSuppression, releaseCollectedForSuppression, isCollectedForSuppression, } from './epoch-collector.ts';
 export type { CollectorRegistration, EpochOutcome, EpochTerminal, } from './epoch-collector.ts';
 export { mountAgentCatalog } from './catalog.ts';
+export { createOneShotLedger, DEFAULT_ACTIVE_TTL_MS, DEFAULT_ENDED_TTL_MS, INTERNAL_LABELS } from './one-shot-ledger.ts';
+export type { OneShotLedgerRow } from './one-shot-ledger.ts';
+export { mountSubagentChildNotice, foldChildNotice, CHILD_NOTICE_SOURCE_KIND } from './one-shot-notice.ts';
+/**
+ * One-shot subagent visibility (memory-recall hardening follow-ups W2a/c):
+ * the shared `subagent/start`/`subagent/end` ledger plus the parent-scoped
+ * `agent/pre-step` notice, mounted on ONE context. Safe on a context without
+ * an `agents` service — parentage then stays unresolvable and nothing is
+ * ever injected.
+ * @param ctx - the plug context.
+ * @returns an unmount callback.
+ */
+export declare function mountOneShotVisibility(ctx: Context): () => void;
 export { mountStripWorkspaceInstructions, isDelegated, isAgentInstructions, } from './strip-instructions.ts';
 export { isSubagentSettledNotice, mountSettledNoticeSuppression, } from './suppress-settled.ts';
 export type { ResumePinsConfig, CaptureInput } from './resume-capture.ts';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAOlD,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAQ5E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,6BAA6B,EAC7B,oCAAoC,EACpC,uBAAuB,GACxB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,aAAa,GACd,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EACL,+BAA+B,EAC/B,WAAW,EACX,mBAAmB,GACpB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEnF,wBAAwB;AACxB,eAAO,MAAM,IAAI,qBAAqB,CAAA;AAEtC,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,2BAA2B,CAAA;AAK/D,eAAO,MAAM,uBAAuB,QA8BxB,CAAA;AAEZ;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAU7E;AAED,4BAA4B;AAC5B,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,gBAAqB,GAAG,IAAI,CA0BvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAOlD,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAU5E,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,6BAA6B,EAC7B,oCAAoC,EACpC,uBAAuB,GACxB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EACV,qBAAqB,EACrB,YAAY,EACZ,aAAa,GACd,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACxH,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC5D,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAE1G;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,IAAI,CAQ/D;AAED,OAAO,EACL,+BAA+B,EAC/B,WAAW,EACX,mBAAmB,GACpB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EACL,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEnF,wBAAwB;AACxB,eAAO,MAAM,IAAI,qBAAqB,CAAA;AAEtC,yDAAyD;AACzD,eAAO,MAAM,uBAAuB,2BAA2B,CAAA;AAK/D,eAAO,MAAM,uBAAuB,QA8BxB,CAAA;AAEZ;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAU7E;AAED,4BAA4B;AAC5B,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,gBAAqB,GAAG,IAAI,CA2BvE"}

package/lib/index.js

@@ -23,12 +23,34 @@ import { PluginAgentIndex } from "./plugin-agents.js";
 import { registerTaskTool } from "./tool.js";
 import { mountSettledNoticeSuppression } from "./suppress-settled.js";
 import { mountAgentCatalog } from "./catalog.js";
+import { createOneShotLedger } from "./one-shot-ledger.js";
+import { mountSubagentChildNotice } from "./one-shot-notice.js";
 import { mountStripWorkspaceInstructions } from "./strip-instructions.js";
 export { AgentRegistry } from "./registry.js";
 export { PluginAgentIndex } from "./plugin-agents.js";
 export { registerTaskTool, TASK_TOOL, MAX_LIVE_CONTINUABLE_CHILDREN, CLAUDE_CODE_DISABLE_BACKGROUND_TASKS, backgroundTasksDisabled, } from "./tool.js";
 export { collectFirstEpoch, collectorFor, collectorKey, registerCollector, unregisterCollector, collectorsForSession, registeredCollectorCount, markCollectedForSuppression, releaseCollectedForSuppression, isCollectedForSuppression, } from "./epoch-collector.js";
 export { mountAgentCatalog } from "./catalog.js";
+export { createOneShotLedger, DEFAULT_ACTIVE_TTL_MS, DEFAULT_ENDED_TTL_MS, INTERNAL_LABELS } from "./one-shot-ledger.js";
+export { mountSubagentChildNotice, foldChildNotice, CHILD_NOTICE_SOURCE_KIND } from "./one-shot-notice.js";
+/**
+ * One-shot subagent visibility (memory-recall hardening follow-ups W2a/c):
+ * the shared `subagent/start`/`subagent/end` ledger plus the parent-scoped
+ * `agent/pre-step` notice, mounted on ONE context. Safe on a context without
+ * an `agents` service — parentage then stays unresolvable and nothing is
+ * ever injected.
+ * @param ctx - the plug context.
+ * @returns an unmount callback.
+ */
+export function mountOneShotVisibility(ctx) {
+    const agents = ctx.get('agents');
+    const ledger = createOneShotLedger({ bus: ctx, agents });
+    const offNotice = mountSubagentChildNotice(ctx, ledger);
+    return () => {
+        ledger.dispose();
+        offNotice();
+    };
+}
 export { mountStripWorkspaceInstructions, isDelegated, isAgentInstructions, } from "./strip-instructions.js";
 export { isSubagentSettledNotice, mountSettledNoticeSuppression, } from "./suppress-settled.js";
 export { SpawnPinCapture, overlayRoute, probeWorkspace } from "./resume-capture.js";
@@ -120,6 +142,7 @@ export function apply(ctx, config = {}) {
     mountBackgroundSection(ctx);
     mountStripWorkspaceInstructions(ctx);
     mountSettledNoticeSuppression(ctx);
+    mountOneShotVisibility(ctx);
     publishCollectorRegistry(ctx);
 }
 /**

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/one-shot-ledger.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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;
+        };
+        /** Legacy event array (removed at the harness 0.1.2-rc.1 line — probed last). */
+        events?: readonly {
+            type?: string;
+            data?: {
+                label?: unknown;
+                mode?: unknown;
+            };
+        }[];
+        /** Preferred probe: the session's own (non-inherited) event log. */
+        ownEvents?: () => readonly unknown[];
+        /** Fallback probe: the full snapshot event log. */
+        snapshotEvents?: () => readonly 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,iFAAiF;QACjF,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;QACjF,oEAAoE;QACpE,SAAS,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE,CAAA;QACpC,mDAAmD;QACnD,cAAc,CAAC,EAAE,MAAM,SAAS,OAAO,EAAE,CAAA;KAC1C,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;AAkChD;;;;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,CA4EA"}

package/lib/one-shot-ledger.js

@@ -0,0 +1,152 @@
+/**
+ * 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;
+/**
+ * Read the child session's event log through the live harness API:
+ * prefer `ownEvents()`, fall back to `snapshotEvents()`, then to the legacy
+ * `events` array (removed at the harness 0.1.2-rc.1 line — the old probe
+ * read only that dead field, so descriptors NEVER resolved).
+ */
+function sessionEvents(session) {
+    if (typeof session?.ownEvents === 'function')
+        return session.ownEvents();
+    if (typeof session?.snapshotEvents === 'function')
+        return session.snapshotEvents();
+    return session?.events ?? [];
+}
+function resolveDescriptor(child) {
+    const event = sessionEvents(child?.session)
+        .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);
+            }
+        }
+    };
+    /**
+     * Lazy per-row re-resolution: the in-process driver appends the
+     * `subagent/descriptor` inside the child's FIRST pre-step — after
+     * `subagent/start` fires — so an insert-time probe legitimately sees
+     * nothing. For any row still label-less, re-probe once via `agents.get`;
+     * resolved rows are cached (never probed again). A gone child stays
+     * unlabeled without error.
+     */
+    const reResolve = () => {
+        if (deps.agents?.get === undefined)
+            return;
+        for (const row of rowsByRunId.values()) {
+            if (row.label !== undefined)
+                continue;
+            const descriptor = resolveDescriptor(deps.agents.get(row.id));
+            if (descriptor.label === undefined)
+                continue;
+            row.label = descriptor.label;
+            if (descriptor.mode !== undefined)
+                row.mode = descriptor.mode;
+            row.internal = INTERNAL_LABELS.includes(descriptor.label);
+        }
+    };
+    return {
+        rows() {
+            prune();
+            reResolve();
+            return [...rowsByRunId.values()];
+        },
+        activeFor(parentId) {
+            prune();
+            reResolve();
+            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,54 @@
+/**
+ * Parent-scoped subagent-child notice (memory-recall hardening follow-ups
+ * W2c; addendum 2026-09-10): on `agent/pre-step`, ONLY the agent whose
+ * `session.id` matches a ledger row's `parentId` gets one folded
+ * observe-only line, contributed by REWRITING the enter decision's message
+ * batch (`{...decision, messages: [...decision.messages, notice]}`). The
+ * previous `agent.inject()` delivery was wrong twice over: inject queues a
+ * DURABLE pending inbox message, and the harness loop re-opens a turn
+ * whenever the inbox has pending work at turn end — an idle session woke
+ * forever with nothing to do (the phantom-loop bug). A batch append enriches
+ * only the current step (pinned by tests/mechanism-pins.spec.ts T1).
+ *
+ * Dedupe is per agent OBJECT: a WeakMap stores the last appended fold text;
+ * an identical fold appends nothing, a changed fold appends again.
+ *
+ * Registration follows `strip-instructions.ts` / `suppress-settled.ts`: a
+ * plain `agent/pre-step` waterfall listener that delegates to `next()`
+ * unchanged (observe-only).
+ *
+ * @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;;;;;;;;;;;;;;;;;;;;GAoBG;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,CA8B5F"}

package/lib/one-shot-notice.js

@@ -0,0 +1,86 @@
+/**
+ * Parent-scoped subagent-child notice (memory-recall hardening follow-ups
+ * W2c; addendum 2026-09-10): on `agent/pre-step`, ONLY the agent whose
+ * `session.id` matches a ledger row's `parentId` gets one folded
+ * observe-only line, contributed by REWRITING the enter decision's message
+ * batch (`{...decision, messages: [...decision.messages, notice]}`). The
+ * previous `agent.inject()` delivery was wrong twice over: inject queues a
+ * DURABLE pending inbox message, and the harness loop re-opens a turn
+ * whenever the inbox has pending work at turn end — an idle session woke
+ * forever with nothing to do (the phantom-loop bug). A batch append enriches
+ * only the current step (pinned by tests/mechanism-pins.spec.ts T1).
+ *
+ * Dedupe is per agent OBJECT: a WeakMap stores the last appended fold text;
+ * an identical fold appends nothing, a changed fold appends again.
+ *
+ * Registration follows `strip-instructions.ts` / `suppress-settled.ts`: a
+ * plain `agent/pre-step` waterfall listener that delegates to `next()`
+ * unchanged (observe-only).
+ *
+ * @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) {
+    // Last appended fold text per agent object (dedupe across pre-steps).
+    const lastNotice = new WeakMap();
+    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));
+            const text = foldChildNotice(active);
+            // Never append an empty fold; never re-append an unchanged fold. The
+            // memo updates only on an actual append, so a fold skipped by a
+            // non-enter decision is retried on the next enter.
+            if (text === '' || lastNotice.get(agent) === text)
+                return decision;
+            if (decision.kind !== 'enter')
+                return decision;
+            lastNotice.set(agent, text);
+            return {
+                ...decision,
+                messages: [...decision.messages, createUserMessage({
+                        content: [{ type: 'text', text }],
+                        source: { kind: 'cc-subagent-children' },
+                    })],
+            };
+        }
+        catch {
+            // Absent llm seam or decision 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;;;;;;;;;;;;;;;;;;;;GAoBG;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,sEAAsE;IACtE,MAAM,UAAU,GAAG,IAAI,OAAO,EAAiB,CAAA;IAC/C,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,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,CAAC,CAAA;YACpC,qEAAqE;YACrE,gEAAgE;YAChE,mDAAmD;YACnD,IAAI,IAAI,KAAK,EAAE,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI;gBAAE,OAAO,QAAQ,CAAA;YAClE,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO;gBAAE,OAAO,QAAQ,CAAA;YAC9C,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YAC3B,OAAO;gBACL,GAAG,QAAQ;gBACX,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;wBACjD,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;wBACjC,MAAM,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE;qBACzC,CAAC,CAAC;aACJ,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qDAAqD;QACvD,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dsh-cc/subagent-task",
   "description": "Claude Code-compatible Task tool: subagent_type dispatch over per-workspace .claude/agents definitions for the DeepSeek Harness",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dsh-cc/dsh-cc.git",
@@ -41,11 +41,11 @@
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "dependencies": {
-    "@dsh-cc/claude-code-agents": "^0.6.0",
-    "@dsh-cc/model-aliases": "^0.6.0",
-    "@dsh-cc/memory": "^0.6.0",
-    "@dsh-cc/subagent-resume-pins": "^0.6.0",
-    "@dsh-cc/tools": "^0.6.0"
+    "@dsh-cc/claude-code-agents": "^0.6.2",
+    "@dsh-cc/memory": "^0.6.2",
+    "@dsh-cc/model-aliases": "^0.6.2",
+    "@dsh-cc/subagent-resume-pins": "^0.6.2",
+    "@dsh-cc/tools": "^0.6.2"
   },
   "devDependencies": {
     "@deepseek-ai/dsh-agent-loop": "link:../../../../deepseek-harness/packages/core/agent-loop",
@@ -65,13 +65,13 @@
     "@deepseek-ai/dsh-subagent": "link:../../../../deepseek-harness/packages/subagent/subagent",
     "@deepseek-ai/dsh-system-prompt": "link:../../../../deepseek-harness/packages/core/system-prompt",
     "@dsh-cc/agent-loop-mock": "^0.1.0",
-    "@dsh-cc/claude-code-agents": "^0.6.0",
-    "@dsh-cc/model-aliases": "^0.6.0",
-    "@dsh-cc/subagent-resume-pins": "^0.6.0",
-    "@dsh-cc/tools": "^0.6.0",
-    "@dsh-cc/memory": "^0.6.0",
-    "@dsh-cc/tool-search": "0.6.0",
-    "@dsh-cc/plugin-loader": "^0.6.0"
+    "@dsh-cc/memory": "^0.6.2",
+    "@dsh-cc/model-aliases": "^0.6.2",
+    "@dsh-cc/claude-code-agents": "^0.6.2",
+    "@dsh-cc/subagent-resume-pins": "^0.6.2",
+    "@dsh-cc/tools": "^0.6.2",
+    "@dsh-cc/plugin-loader": "^0.6.2",
+    "@dsh-cc/tool-search": "0.6.2"
   },
   "publishConfig": {
     "access": "public"