@ponythewhite/base-context 1.0.11 → 1.0.13

package/dist/bundle/{chunk-JZHGOOFM.js → chunk-TXVF6Q5H.js}

@@ -116,6 +116,7 @@ import {
   acquireDaemonSocketPathLease,
   acquireSessionLease,
   addAssistantUsage,
+  addRequestUsageTotals,
   agentFamilyRelationship,
   assertAgentFamilyReach,
   assertAgentSessionNameAvailable,
@@ -173,6 +174,7 @@ import {
   durableDaemonWorkerDescriptor,
   emitSessionShutdownEvent,
   emptyGoalState,
+  emptyRequestUsageTotals,
   emptyUsage,
   encodeJournalFrame,
   encodeJournalFrameJson,
@@ -349,7 +351,7 @@ import {
   watchWithErrorHandler,
   workerRosterEntryFromSummary,
   wrapTextWithAnsi
-} from "./chunk-TOOVREMP.js";
+} from "./chunk-TKOBEJ5E.js";
 import {
   array,
   boolean,
@@ -368,7 +370,7 @@ import {
 import {
   installFileLogSink,
   setLogContext
-} from "./chunk-QKIFBA7N.js";
+} from "./chunk-Q6UAHLII.js";
 import {
   APP_NAME,
   APP_TITLE,
@@ -414,7 +416,7 @@ import {
   shouldUseWindowsShell,
   signalProcessGroupOrProcess,
   typebox_exports
-} from "./chunk-2IPDSTDR.js";
+} from "./chunk-AEMRBMI2.js";
 import {
   PRODUCT,
   PRODUCT_ENV
@@ -436,7 +438,7 @@ import {
   getProviders,
   modelsAreEqual,
   supportsFastMode
-} from "./chunk-D3KOF57W.js";
+} from "./chunk-25VYRAC6.js";
 import {
   __commonJS,
   __export,
@@ -6360,10 +6362,15 @@ var SettingsManager = class _SettingsManager {
     return model === void 0 ? void 0 : structuredClone(model);
   }
   getCompactionSettings() {
+    const targetTokens = this.settings.compaction?.targetTokens;
+    if (targetTokens !== void 0 && targetTokens !== "model-limit" && (!Number.isSafeInteger(targetTokens) || targetTokens <= 0)) {
+      throw new Error('compaction.targetTokens must be a positive safe integer or "model-limit"');
+    }
     return {
       enabled: this.getCompactionEnabled(),
       reserveTokens: this.getCompactionReserveTokens(),
-      keepRecentTokens: this.getCompactionKeepRecentTokens()
+      keepRecentTokens: this.getCompactionKeepRecentTokens(),
+      ...targetTokens === void 0 ? {} : { targetTokens }
     };
   }
   /** Detached explicit configuration; the request path resolves and validates its model/effort. */
@@ -34609,10 +34616,17 @@ var DaemonAgentConnection = class _DaemonAgentConnection {
     });
   }
   async getContextTree() {
-    return this.requestData({
+    const tree = await this.requestData({
       type: "get_context_tree",
       activeSessionId: this.activeSessionId
     });
+    if (this.client.supportsServerCapability("context_request_usage"))
+      return tree;
+    const legacy = (node) => {
+      const { ownRequestUsage: _ignored, ...rest } = node;
+      return { ...rest, children: node.children.map(legacy) };
+    };
+    return legacy(tree);
   }
   async getSessionContext() {
     if (this.latestSnapshotIsFresh && this.latestSnapshot?.sessionContext) {
@@ -40813,8 +40827,50 @@ function sumOwnUsage(root) {
   walk(root);
   return total;
 }
+var GOAL_SCOPE = "Goal budget: root successful main uncached input + output only; excludes cache, children and auxiliary requests";
+function formatReceiptContextTree(root, width) {
+  const rows = flattenContextTree(root);
+  const total = emptyRequestUsageTotals();
+  const seen = /* @__PURE__ */ new Set();
+  let missingNodes = 0;
+  const lines = [theme.bold("Context"), "", "Generation receipts: captured sources, known usage only", ""];
+  for (const { node, prefix } of rows) {
+    const usage = node.ownRequestUsage;
+    const label = truncateToWidth(`${prefix}${node.label}`, Math.max(16, width - 45), "...");
+    if (!usage) {
+      missingNodes++;
+      lines.push(`${statusIcon(node.status)} ${label}: request usage unknown`);
+    } else if (seen.has(usage.sessionId)) {
+      lines.push(`${statusIcon(node.status)} ${label}: shared source (counted once)`);
+    } else {
+      seen.add(usage.sessionId);
+      addRequestUsageTotals(total, usage.total);
+      lines.push(`${statusIcon(node.status)} ${label}: ${formatTokenCount2(usage.total.processedTokens)} tokens \xB7 ${formatCost(usage.total.catalogEstimateUsd)} est.`);
+      for (const [purpose, bucket] of Object.entries(usage.byPurpose)) {
+        lines.push(`  ${purpose}: ${bucket.processedTokens.toLocaleString()} tokens \xB7 $${bucket.catalogEstimateUsd.toFixed(4)} est. \xB7 ${bucket.settledAttempts} settled`);
+      }
+    }
+    if (node.contextUsage)
+      lines.push(`  Context: ${formatContextColumn(node.contextUsage, node.id === "root")}`);
+  }
+  lines.push("", theme.bold("Captured family \u2014 known generation usage"));
+  lines.push(`Sessions with receipts: ${seen.size}; request usage unavailable: ${missingNodes}`);
+  lines.push(`Uncached input: ${total.input.toLocaleString()}`);
+  lines.push(`Input total (including cache): ${total.inputTotal.toLocaleString()}`);
+  lines.push(`Cache read: ${total.cacheRead.toLocaleString()}; cache write: ${total.cacheWrite.toLocaleString()}`);
+  lines.push(`Output: ${total.output.toLocaleString()}`);
+  lines.push(`Processed total: ${total.processedTokens.toLocaleString()}`);
+  lines.push(`Catalog estimate (unvalidated rates, not an invoice): $${total.catalogEstimateUsd.toFixed(4)}`);
+  lines.push(`Unknown usage: ${total.missingUsageAttempts} missing, ${total.partialUsageAttempts} partial, ${total.unsettledAttempts} unsettled attempts; ${total.unpricedAttempts} settled attempts unpriced`);
+  lines.push("Missing fields are not zero. Totals exclude unavailable sessions and non-generation token-count requests.");
+  lines.push("Captured sources are not a guarantee of complete historical family usage.");
+  lines.push("", GOAL_SCOPE);
+  return lines.join("\n");
+}
 function formatContextTree(root, width) {
   const rows = flattenContextTree(root);
+  if (rows.some(({ node }) => node.ownRequestUsage))
+    return formatReceiptContextTree(root, width);
   const tokenCells = rows.map((row) => formatTokenCount2(spentTokens(row.node.ownUsage)));
   const costCells = rows.map((row) => formatCost(row.node.ownUsage.cost.total));
   const tokenHeader = "tokens";
@@ -40826,6 +40882,9 @@ function formatContextTree(root, width) {
   const lines = [];
   lines.push(theme.bold("Context"));
   lines.push("");
+  lines.push("Legacy conversation projection \u2014 request receipts unavailable; auxiliary usage may be missing");
+  lines.push("Costs below are catalog estimates, not invoices");
+  lines.push("");
   if (root.model) {
     lines.push(`${theme.fg("dim", "Model:")} ${root.model.provider}/${root.model.id}`);
     lines.push("");
@@ -40871,6 +40930,7 @@ function formatContextTree(root, width) {
       lines.push(`${theme.fg("dim", "Current:")} ${rootContext.tokens.toLocaleString()} / ${rootContext.contextWindow.toLocaleString()} (${percent})`);
     }
   }
+  lines.push("", GOAL_SCOPE);
   return lines.join("\n");
 }
 
@@ -59637,6 +59697,7 @@ var DaemonRlmCapacityClient = class {
 // dist/modes/daemon/daemon-session-summarizer.js
 var SWEEP_INTERVAL_MS = 25e3;
 var SETTLE_DEBOUNCE_MS = 2e3;
+var MIN_REFRESH_INTERVAL_MS = 6e4;
 var SUMMARY_CONTEXT_MESSAGES = 8;
 var SUMMARY_MAX_CHARS_PER_MESSAGE = 600;
 var SUMMARY_MAX_TOKENS = 400;
@@ -59670,7 +59731,7 @@ function messageText(content) {
     const type = block.type;
     if (type === "text" && typeof block.text === "string") {
       parts.push(block.text);
-    } else if (type === "tool_use" || type === "toolUse") {
+    } else if (type === "toolCall" || type === "tool_use" || type === "toolUse") {
       const name = block.name;
       if (typeof name === "string") {
         tools.push(name);
@@ -59734,7 +59795,7 @@ function parseAgentStatusResponse(text, isWorking) {
   return { summary, taskState };
 }
 async function generateAgentStatus(params) {
-  const { registry, messages, isWorking, signal, requests, model: selectedModel } = params;
+  const { registry, messages, isWorking, sessionId, signal, requests, model: selectedModel } = params;
   if (messages.length === 0) {
     return void 0;
   }
@@ -59758,7 +59819,13 @@ async function generateAgentStatus(params) {
           timestamp
         }
       ]
-    }, { maxTokens: SUMMARY_MAX_TOKENS, apiKey: auth.apiKey, headers: auth.headers, signal }, { purpose: "native-control", purposeDetail: "daemon-status" });
+    }, {
+      maxTokens: SUMMARY_MAX_TOKENS,
+      apiKey: auth.apiKey,
+      headers: auth.headers,
+      signal,
+      sessionId: sessionId ? `daemon-status:${sessionId}` : void 0
+    }, { purpose: "native-control", purposeDetail: "daemon-status" });
     if (response.stopReason === "error") {
       return void 0;
     }
@@ -59794,6 +59861,7 @@ var DaemonSessionSummarizer = class {
   debounceTimers = /* @__PURE__ */ new Map();
   // Controller per in-flight summary so a closing session can abort its write.
   inFlight = /* @__PURE__ */ new Map();
+  refreshes = /* @__PURE__ */ new Map();
   tasks = /* @__PURE__ */ new Map();
   forgotten = /* @__PURE__ */ new Set();
   stopped = false;
@@ -59843,6 +59911,7 @@ var DaemonSessionSummarizer = class {
       this.debounceTimers.delete(activeSessionId);
     }
     this.inFlight.get(activeSessionId)?.abort();
+    this.refreshes.delete(activeSessionId);
     this.rerunRequested.delete(activeSessionId);
     await this.tasks.get(activeSessionId);
   }
@@ -59859,6 +59928,9 @@ var DaemonSessionSummarizer = class {
   }
   /** Called when a session finishes a turn; debounce until the agent settles. */
   notifyActivity(state) {
+    this.schedule(state, SETTLE_DEBOUNCE_MS);
+  }
+  schedule(state, delay8) {
     const id = state.activeSessionId;
     if (this.stopped || this.forgotten.has(id))
       return;
@@ -59869,7 +59941,7 @@ var DaemonSessionSummarizer = class {
     const timer = setTimeout(() => {
       this.debounceTimers.delete(id);
       this.summarize(state);
-    }, SETTLE_DEBOUNCE_MS);
+    }, delay8);
     timer.unref?.();
     this.debounceTimers.set(id, timer);
   }
@@ -59903,33 +59975,54 @@ var DaemonSessionSummarizer = class {
     const messageCount = messages.length;
     const isWorking = isSessionWorking(state);
     const previous = state.summaryState;
-    const contentUnchanged = previous?.basedOnMessageCount === messageCount;
     const owesIdleVerdict = !isWorking && previous?.taskState === void 0;
     const owesSummary = !isWorking && !previous?.summary;
     const turnError = !isWorking ? terminalTurnError(messages) : void 0;
-    const owesErrorVerdict = turnError !== void 0 && (previous?.taskState !== "needs_input" || previous?.summary !== turnError);
-    if (contentUnchanged && !isWorking && !owesIdleVerdict && !owesSummary && !owesErrorVerdict) {
-      return;
+    const contextMessages = () => {
+      const streaming = isWorking ? session.state.streamingMessage : void 0;
+      return streaming ? [...session.messages, streaming] : session.messages;
+    };
+    const input = buildStatusContext(contextMessages(), isWorking);
+    const model = session.model;
+    const isCurrentSource = () => state.runtime.session === session && session.sessionManager === sessionManager && sessionManager.getSessionId() === sessionId && sessionManager.getSessionFile() === sessionFile && session.model === model;
+    let refresh = this.refreshes.get(id);
+    if (!refresh?.isCurrentSource()) {
+      refresh = { isCurrentSource };
+      this.refreshes.set(id, refresh);
+    }
+    const finalTransition = !isWorking && refresh.wasWorking === true;
+    refresh.wasWorking = isWorking;
+    const reuse = turnError === void 0 && refresh.input === input && previous?.summary ? previous : void 0;
+    if ((reuse || turnError !== void 0 && previous?.summary === turnError && previous.taskState === "needs_input") && previous?.basedOnMessageCount === messageCount) {
+      return;
+    }
+    if (!reuse && turnError === void 0) {
+      const remaining = MIN_REFRESH_INTERVAL_MS - (Date.now() - (refresh.attemptedAt ?? -Infinity));
+      if (!finalTransition && remaining > 0) {
+        this.schedule(state, remaining);
+        return;
+      }
+      refresh.attemptedAt = Date.now();
     }
-    const streaming = isWorking ? session.state.streamingMessage : void 0;
-    const contextMessages = streaming ? [...messages, streaming] : messages;
     const controller = new AbortController();
-    const isCurrent = () => !controller.signal.aborted && state.runtime.session === session && session.sessionManager === sessionManager && sessionManager.getSessionId() === sessionId && sessionManager.getSessionFile() === sessionFile && isSessionWorking(state) === isWorking && session.messages.length === messageCount;
+    const isCurrent = () => !controller.signal.aborted && isCurrentSource() && isSessionWorking(state) === isWorking && session.messages.length === messageCount && buildStatusContext(contextMessages(), isWorking) === input && (isWorking || terminalTurnError(session.messages) === turnError);
     this.inFlight.set(id, controller);
     let requests;
     let status;
+    let completedInput;
     let changed = false;
     try {
-      if (turnError === void 0)
+      if (!reuse && turnError === void 0)
         requests = this.getRequests?.(session);
-      const generated = turnError !== void 0 ? { summary: turnError, taskState: "needs_input" } : await this.generate({
+      const generated = reuse ?? (turnError !== void 0 ? { summary: turnError, taskState: "needs_input" } : await this.generate({
         registry: session.modelRegistry,
-        model: session.model,
-        messages: contextMessages,
+        model,
+        messages: contextMessages(),
         isWorking,
+        sessionId,
         signal: controller.signal,
         requests
-      });
+      }));
       await requests?.dispose();
       const result = generated ?? (!isWorking && (owesIdleVerdict || owesSummary) ? { summary: previous?.summary ?? "", taskState: "needs_input" } : void 0);
       if (!result) {
@@ -59938,6 +60031,8 @@ var DaemonSessionSummarizer = class {
       if (!isCurrent()) {
         return;
       }
+      if (generated && turnError === void 0)
+        completedInput = input;
       const taskState = result.taskState ?? (previous?.basedOnMessageCount === messageCount ? previous?.taskState : void 0);
       status = {
         summary: result.summary,
@@ -59958,6 +60053,7 @@ var DaemonSessionSummarizer = class {
       }
     }
     if (status && isCurrent()) {
+      refresh.input = completedInput;
       state.summaryState = status;
       if (changed)
         this.onStatusChanged?.(state);

package/dist/bundle/{cli-main-BRXGYTGK.js → cli-main-ZTJM5EEH.js}

@@ -5,10 +5,10 @@ import {
   isOwnedSessionWorkerProcess,
   maybeRunOwnedSessionWorkerFrontend,
   maybeStartDaemonEarly
-} from "./chunk-TOOVREMP.js";
+} from "./chunk-TKOBEJ5E.js";
 import {
   APP_NAME
-} from "./chunk-2IPDSTDR.js";
+} from "./chunk-AEMRBMI2.js";
 import "./chunk-5QCJ5DQU.js";
 import "./chunk-CRBVRZBV.js";
 import "./chunk-GRJFXLBM.js";
@@ -16,7 +16,7 @@ import "./chunk-2T7M7VJ4.js";
 import "./chunk-UIRUOAIQ.js";
 import "./chunk-HXOBFFJX.js";
 import "./chunk-DGNX7HQ3.js";
-import "./chunk-D3KOF57W.js";
+import "./chunk-25VYRAC6.js";
 import "./chunk-BAWSWWEU.js";
 
 // dist/cli-main.js
@@ -39,7 +39,7 @@ async function runCli() {
     }
     const [{ EnvHttpProxyAgent, setGlobalDispatcher }, { main }] = await Promise.all([
       import("undici"),
-      import("./main-POUXGEL6.js")
+      import("./main-53I74INO.js")
     ]);
     setGlobalDispatcher(new EnvHttpProxyAgent({ bodyTimeout: 0, headersTimeout: 0 }));
     try {

package/dist/bundle/cli.js

@@ -52,6 +52,6 @@ var supported = assertNodeVersion({
   exit: (code) => process.exit(code)
 });
 if (supported) {
-  const { runCli } = await import("./cli-main-BRXGYTGK.js");
+  const { runCli } = await import("./cli-main-ZTJM5EEH.js");
   await runCli();
 }

package/dist/bundle/{google-HTMCUJ7X.js → google-4GA4YMUX.js}

@@ -10,7 +10,7 @@ import {
   mapToolChoice,
   observeGoogleUsage,
   retainThoughtSignature
-} from "./chunk-Q3MBSBEB.js";
+} from "./chunk-FOGKLC7V.js";
 import {
   buildBaseOptions,
   sanitizeSurrogates
@@ -26,7 +26,7 @@ import {
   formatStreamFailureMessage,
   recordStreamFailure,
   streamFailureFromStopReason
-} from "./chunk-D3KOF57W.js";
+} from "./chunk-25VYRAC6.js";
 import "./chunk-BAWSWWEU.js";
 
 // ../ai/src/providers/google.ts

package/dist/bundle/{google-vertex-ZQO65AXF.js → google-vertex-7AMALD7D.js}

@@ -12,7 +12,7 @@ import {
   mapToolChoice,
   observeGoogleUsage,
   retainThoughtSignature
-} from "./chunk-Q3MBSBEB.js";
+} from "./chunk-FOGKLC7V.js";
 import {
   buildBaseOptions,
   sanitizeSurrogates
@@ -25,7 +25,7 @@ import {
   formatStreamFailureMessage,
   recordStreamFailure,
   streamFailureFromStopReason
-} from "./chunk-D3KOF57W.js";
+} from "./chunk-25VYRAC6.js";
 import "./chunk-BAWSWWEU.js";
 
 // ../ai/src/providers/google-vertex.ts

package/dist/bundle/{main-POUXGEL6.js → main-53I74INO.js}

@@ -17,11 +17,11 @@ import {
   shouldUseDaemonClientRuntime,
   shouldUseDaemonInteractive,
   shouldUseEphemeralSessionManagerForDaemonInteractive
-} from "./chunk-JZHGOOFM.js";
-import "./chunk-TOOVREMP.js";
+} from "./chunk-TXVF6Q5H.js";
+import "./chunk-TKOBEJ5E.js";
 import "./chunk-CFNASUYO.js";
-import "./chunk-QKIFBA7N.js";
-import "./chunk-2IPDSTDR.js";
+import "./chunk-Q6UAHLII.js";
+import "./chunk-AEMRBMI2.js";
 import "./chunk-5QCJ5DQU.js";
 import "./chunk-CRBVRZBV.js";
 import "./chunk-GRJFXLBM.js";
@@ -29,7 +29,7 @@ import "./chunk-2T7M7VJ4.js";
 import "./chunk-UIRUOAIQ.js";
 import "./chunk-HXOBFFJX.js";
 import "./chunk-DGNX7HQ3.js";
-import "./chunk-D3KOF57W.js";
+import "./chunk-25VYRAC6.js";
 import "./chunk-BAWSWWEU.js";
 export {
   createDefaultRuntimeFactory,

package/dist/bundle/{mistral-SB7LU56G.js → mistral-74BXMNRM.js}

@@ -45,7 +45,7 @@ import {
   clampThinkingLevel,
   recordStreamFailure,
   streamFailureFromStopReason
-} from "./chunk-D3KOF57W.js";
+} from "./chunk-25VYRAC6.js";
 import "./chunk-BAWSWWEU.js";
 
 // ../../node_modules/@mistralai/mistralai/esm/lib/url.js

package/dist/bundle/{openai-codex-responses-5CEW4VN3.js → openai-codex-responses-COXNC4IH.js}

@@ -8,7 +8,7 @@ import {
   convertResponsesTools,
   observeResponsesEvent,
   processResponsesStream
-} from "./chunk-KT2BNEPE.js";
+} from "./chunk-MUFZODP5.js";
 import "./chunk-NQB5DCFC.js";
 import {
   headersToRecord
@@ -33,7 +33,7 @@ import {
   formatThrownValue,
   isLocalRequestPreparationError,
   recordStreamFailure
-} from "./chunk-D3KOF57W.js";
+} from "./chunk-25VYRAC6.js";
 import "./chunk-BAWSWWEU.js";
 
 // ../ai/src/utils/abortable-delay.ts

package/dist/bundle/{openai-completions-BAZJQSS2.js → openai-completions-BCSA5Q6S.js}

@@ -36,7 +36,7 @@ import {
   formatStreamFailureMessage,
   recordStreamFailure,
   withRequestBody
-} from "./chunk-D3KOF57W.js";
+} from "./chunk-25VYRAC6.js";
 import "./chunk-BAWSWWEU.js";
 
 // ../ai/src/providers/openai-completions.ts
@@ -120,7 +120,7 @@ var streamOpenAICompletions = (model, context, options) => {
       const cacheWriteCost = cacheControl && hasStandardAnthropicCachePricing(model) ? getAnthropicCacheWriteCost(model.cost.input, cacheControl.ttl === "1h" ? "1h" : "5m") : void 0;
       const cacheSessionId = cacheRetention === "none" ? void 0 : options?.sessionId;
       let client = createClient(model, context, apiKey, options?.headers, cacheSessionId, compat);
-      if (attempts.enabled) {
+      if (attempts.enabled || options?.signal) {
         client = client.withOptions({});
         client.fetchWithTimeout = attempts.wrapHttp(client.fetchWithTimeout.bind(client));
       }

package/dist/bundle/{openai-responses-VHOE427P.js → openai-responses-ONCIZSJS.js}

@@ -10,7 +10,7 @@ import {
   convertResponsesMessages,
   convertResponsesTools,
   processResponsesStream
-} from "./chunk-KT2BNEPE.js";
+} from "./chunk-MUFZODP5.js";
 import "./chunk-NQB5DCFC.js";
 import {
   OpenAI
@@ -33,7 +33,7 @@ import {
   openAIVisibleInput,
   recordStreamFailure,
   streamFailureFromStopReason
-} from "./chunk-D3KOF57W.js";
+} from "./chunk-25VYRAC6.js";
 import "./chunk-BAWSWWEU.js";
 
 // ../ai/src/providers/openai-responses.ts
@@ -83,7 +83,7 @@ var streamOpenAIResponses = (model, context, options) => {
       const cacheSessionId = cacheRetention === "none" ? void 0 : options?.sessionId;
       let client = createClient(model, context, apiKey, options?.headers, cacheSessionId);
       const preparationClient = client;
-      if (attempts.enabled) {
+      if (attempts.enabled || options?.signal) {
         client = client.withOptions({});
         client.fetchWithTimeout = attempts.wrapHttp(client.fetchWithTimeout.bind(client));
       }

package/dist/core/agent-session.d.ts

@@ -518,6 +518,8 @@ export declare class AgentSession {
     private _rlmChildCleanupFailures;
     private _deletingRlmChildren;
     private _rlmChildUnsubscribes;
+    private _rlmChildUsageSources;
+    private _rlmParentUsageAttribution?;
     /** Latest recap for this session, written by the daemon summarizer; read by a parent to label its child snapshots. */
     private _currentRecap?;
     private readonly _initialGoal;
@@ -834,6 +836,8 @@ export declare class AgentSession {
     private _normalizePromptSnippet;
     private _normalizePromptGuidelines;
     private _rebuildSystemPrompt;
+    private _readHarnessSnapshot;
+    private _appendHarnessSnapshotIfChanged;
     private _refreshExtensionSystemPrompt;
     private _finishSubmissionNormalization;
     private _normalizeSubmission;
@@ -1202,6 +1206,8 @@ export declare class AgentSession {
     private _removeRlmSubagentTracking;
     private _emitRlmSubagentRemoval;
     private _deleteResolvedRlmSubagent;
+    private _restoreRlmChildUsageSource;
+    private _subscribeRlmChildEvents;
     /**
      * Retain a finished child session for the parent lifetime so inspectors and
      * daemon-hosted agent messaging can keep addressing it. Returns false (and disposes