switchroom 0.19.42 → 0.19.43

package/dist/host-control/main.js

@@ -11416,7 +11416,7 @@ var init_schema = __esm(() => {
       reflect: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `reflect` LLM op (synthesis / mental-model " + "refresh). Emits `HINDSIGHT_API_REFLECT_LLM_*`. Absent → uses global."),
       consolidation: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `consolidation` LLM op (background memory " + "merge). Emits `HINDSIGHT_API_CONSOLIDATION_LLM_*`. Absent → global.")
     }).optional().describe("LLM knob for the hindsight container. The flat `provider`/`model` set " + "the global default (backward-compatible); optional `retain`/`reflect`/" + "`consolidation` blocks override individual ops. All fields optional; " + "unset fields fall back to the hard-coded defaults."),
-    env: exports_external.record(exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean()])).optional().describe("Operator overrides for switchroom's capability-gated Hindsight " + "performance defaults. Only the keys switchroom actually manages are " + "honoured (`HINDSIGHT_PERF_ENV_KEYS` in " + "src/setup/hindsight-perf-defaults.ts: RERANKER_LOCAL_FP16, " + "RERANKER_LOCAL_BATCH_SIZE, LLM_MAX_CONCURRENT, " + "RETAIN/CONSOLIDATION_LLM_MAX_CONCURRENT, LLM_STRICT_SCHEMA, " + "LLM_MAX_RETRIES, CONSOLIDATION_LLM_PARALLELISM, " + "MAX_OBSERVATIONS_PER_SCOPE, " + "RECALL_MAX_CANDIDATES_PER_SOURCE, LINK_EXPANSION_PER_ENTITY_LIMIT, " + "LINK_EXPANSION_TIMEOUT, LLM_REASONING_EFFORT, " + "RERANKER_LOCAL_BUCKET_BATCHING, RERANKER_MAX_CANDIDATES, " + "RERANKER_LOCAL_MAX_CONCURRENT, RECALL_MAX_CONCURRENT, " + "REFLECT_WALL_TIMEOUT, WORKER_CONSOLIDATION_MAX_SLOTS, " + "WORKER_CONSOLIDATION_SLOT_LIMIT, " + "CONSOLIDATION_MAX_MEMORIES_PER_ROUND, RECENCY_DECAY_FUNCTION, " + "RECENCY_DECAY_HALFLIFE_DAYS — switchroom defaults recall's recency " + "curve to `exponential` with a 30-day half-life so a fact retained " + "today outranks a stale one, instead of upstream's near-flat " + "linear/365-day window), the override-only keys " + "switchroom manages but ships NO default for " + "(`HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS`: " + "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY — a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks; and " + "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP — the rollback knob for " + "switchroom's CE-saturation damping patch, a float; >= ~0.65 backs the " + "damping out entirely, unset means the patch's own derived gap; and " + "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS — only read when the " + "decay function is `linear`, so switchroom ships no default for it but " + "still honours an operator who flips the function back; and " + "HINDSIGHT_API_WORKER_MAX_SLOTS — the worker poller's TOTAL in-flight " + "task budget, the pool WORKER_CONSOLIDATION_MAX_SLOTS reserves out of; " + "unset means upstream's own default; and " + "HINDSIGHT_API_WORKER_RETAIN_MAX_SLOTS — the reserved slot FLOOR for the " + "retain (memory write) lane, carved from that same total; unset means " + "upstream's own 0, i.e. no floor and retain competes for the shared " + "pool), plus the " + "embedded-PostgreSQL (pg0) sizing keys switchroom manages in " + "src/setup/hindsight-pg-defaults.ts (`HINDSIGHT_PG_ENV_KEYS`: " + "SWITCHROOM_HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE, " + "SWITCHROOM_HINDSIGHT_PG_SHARED_BUFFERS — a postgres size string such " + "as `4GB`, or the sentinel `off` to leave pg0's own default for that " + "one knob). A value set here " + "REPLACES switchroom's default and is emitted even when the gating " + "capability is absent, so an operator can always force a knob. Other " + "`HINDSIGHT_API_*` keys are deliberately IGNORED — a blanket " + "passthrough would collide with the vars startHindsight() derives " + "itself (HINDSIGHT_API_PORT, the retain token/deadline budget).")
+    env: exports_external.record(exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean()])).optional().describe("Operator overrides for switchroom's capability-gated Hindsight " + "performance defaults. Only the keys switchroom actually manages are " + "honoured (`HINDSIGHT_PERF_ENV_KEYS` in " + "src/setup/hindsight-perf-defaults.ts: RERANKER_LOCAL_FP16, " + "RERANKER_LOCAL_BATCH_SIZE, LLM_MAX_CONCURRENT, " + "RETAIN/CONSOLIDATION_LLM_MAX_CONCURRENT, LLM_STRICT_SCHEMA, " + "LLM_MAX_RETRIES, CONSOLIDATION_LLM_PARALLELISM, " + "MAX_OBSERVATIONS_PER_SCOPE, " + "RECALL_MAX_CANDIDATES_PER_SOURCE, LINK_EXPANSION_PER_ENTITY_LIMIT, " + "LINK_EXPANSION_TIMEOUT, LLM_REASONING_EFFORT, " + "RERANKER_LOCAL_BUCKET_BATCHING, RERANKER_MAX_CANDIDATES, " + "RERANKER_LOCAL_MAX_CONCURRENT, RECALL_MAX_CONCURRENT, " + "REFLECT_WALL_TIMEOUT, WORKER_CONSOLIDATION_RESERVED_SLOTS, " + "WORKER_CONSOLIDATION_SLOT_LIMIT, " + "CONSOLIDATION_MAX_MEMORIES_PER_ROUND, GRAPH_SEED_MIN_SIMILARITY, " + "LLM_SUPPORTS_MAX_ITEMS, RECENCY_DECAY_FUNCTION, " + "RECENCY_DECAY_HALFLIFE_DAYS — switchroom defaults recall's recency " + "curve to `exponential` with a 30-day half-life so a fact retained " + "today outranks a stale one, instead of upstream's near-flat " + "linear/365-day window), the override-only keys " + "switchroom manages but ships NO default for " + "(`HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS`: " + "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY — a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks; and " + "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP — the rollback knob for " + "switchroom's CE-saturation damping patch, a float; >= ~0.65 backs the " + "damping out entirely, unset means the patch's own derived gap; and " + "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS — only read when the " + "decay function is `linear`, so switchroom ships no default for it but " + "still honours an operator who flips the function back; and " + "HINDSIGHT_API_WORKER_MAX_SLOTS — the worker poller's TOTAL in-flight " + "task budget, the pool WORKER_CONSOLIDATION_RESERVED_SLOTS reserves out of; " + "unset means upstream's own default; and " + "HINDSIGHT_API_WORKER_RETAIN_RESERVED_SLOTS — the reserved slot FLOOR for the " + "retain (memory write) lane, carved from that same total; unset means " + "upstream's own 0, i.e. no floor and retain competes for the shared " + "pool; and " + "the pre-0.8.6 name HINDSIGHT_API_WORKER_<TYPE>_MAX_SLOTS is still " + "accepted for every operation type and normalised to " + "..._RESERVED_SLOTS on the way in, because setting both names for " + "one type is a hard boot failure in the engine and switchroom " + "therefore emits only the canonical name; and " + "HINDSIGHT_API_SEMANTIC_MIN_SIMILARITY — the cosine-similarity floor a " + "candidate must reach to be returned by the semantic retrieval arm at " + "all (0..1); unset means upstream's own 0.3, and where it should sit " + "depends on the bank's embedding model and phrasing diversity, so " + "switchroom ships no opinion; and " + "HINDSIGHT_MCP_RECALL_BUDGET_MODE — the rollback knob for switchroom's " + "mcp-recall-token-budget image patch; `legacy` restores upstream's " + "exact pre-patch recall returns, anything else or unset is the " + "honest-envelope mode; and " + "HINDSIGHT_API_LLM_TEMPERATURE_REFLECT — upstream's own per-op reflect " + "temperature knob, made live by switchroom's reflect-temperature image " + "patch; a float, or `none` to omit the kwarg (provider default, " + "upstream's accidental pre-patch behaviour); unset means the image's " + "baked default 0.1), plus the " + "embedded-PostgreSQL (pg0) sizing keys switchroom manages in " + "src/setup/hindsight-pg-defaults.ts (`HINDSIGHT_PG_ENV_KEYS`: " + "SWITCHROOM_HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE, " + "SWITCHROOM_HINDSIGHT_PG_SHARED_BUFFERS — a postgres size string such " + "as `4GB`, or the sentinel `off` to leave pg0's own default for that " + "one knob). A value set here " + "REPLACES switchroom's default and is emitted even when the gating " + "capability is absent, so an operator can always force a knob. Other " + "`HINDSIGHT_API_*` keys are deliberately IGNORED — a blanket " + "passthrough would collide with the vars startHindsight() derives " + "itself (HINDSIGHT_API_PORT, the retain token/deadline budget).")
   });
   MicrosoftWorkspaceConfigSchema = exports_external.object({
     microsoft_client_id: exports_external.string().min(1).optional().describe("Microsoft OAuth application (client) ID from Entra portal " + "(literal string or vault reference e.g. " + "'vault:microsoft-oauth-client-id'). OPTIONAL — omit it to use " + "switchroom's shipped default Microsoft app (zero-config). " + "Set it only to bring your own Entra app (BYO)."),
@@ -21342,7 +21342,7 @@ function allocateAgentUid(name) {
 }
 
 // src/build-info.ts
-var VERSION = "0.19.42";
+var VERSION = "0.19.43";
 
 // src/setup/hindsight-recall-tunables.ts
 var RECALL_DEADLINE_HEADROOM_SECONDS = 2;
@@ -21518,7 +21518,9 @@ var HINDSIGHT_DEFAULT_RECALL_MAX_CONCURRENT = 8;
 var HINDSIGHT_DEFAULT_REFLECT_WALL_TIMEOUT_S = 600;
 var HINDSIGHT_DEFAULT_CONSOLIDATION_MAX_MEMORIES_PER_ROUND = 250;
 var HINDSIGHT_DEFAULT_CONSOLIDATION_SLOT_LIMIT = 6;
-var HINDSIGHT_DEFAULT_CONSOLIDATION_MAX_SLOTS = 1;
+var HINDSIGHT_DEFAULT_CONSOLIDATION_RESERVED_SLOTS = 1;
+var HINDSIGHT_DEFAULT_GRAPH_SEED_MIN_SIMILARITY = 0.3;
+var HINDSIGHT_DEFAULT_LLM_SUPPORTS_MAX_ITEMS = "false";
 var HINDSIGHT_DEFAULT_RECENCY_DECAY_FUNCTION = "exponential";
 var HINDSIGHT_DEFAULT_RECENCY_DECAY_HALFLIFE_DAYS = 30;
 var HINDSIGHT_PERF_DEFAULTS_UNGATED = [
@@ -21564,8 +21566,8 @@ var HINDSIGHT_PERF_DEFAULTS_UNGATED = [
     String(HINDSIGHT_DEFAULT_REFLECT_WALL_TIMEOUT_S)
   ],
   [
-    "HINDSIGHT_API_WORKER_CONSOLIDATION_MAX_SLOTS",
-    String(HINDSIGHT_DEFAULT_CONSOLIDATION_MAX_SLOTS)
+    "HINDSIGHT_API_WORKER_CONSOLIDATION_RESERVED_SLOTS",
+    String(HINDSIGHT_DEFAULT_CONSOLIDATION_RESERVED_SLOTS)
   ],
   [
     "HINDSIGHT_API_WORKER_CONSOLIDATION_SLOT_LIMIT",
@@ -21582,6 +21584,10 @@ var HINDSIGHT_PERF_DEFAULTS_UNGATED = [
   [
     "HINDSIGHT_API_RECENCY_DECAY_HALFLIFE_DAYS",
     String(HINDSIGHT_DEFAULT_RECENCY_DECAY_HALFLIFE_DAYS)
+  ],
+  [
+    "HINDSIGHT_API_GRAPH_SEED_MIN_SIMILARITY",
+    String(HINDSIGHT_DEFAULT_GRAPH_SEED_MIN_SIMILARITY)
   ]
 ];
 var HINDSIGHT_PERF_DEFAULTS_GPU = [
@@ -21602,22 +21608,41 @@ var HINDSIGHT_PERF_DEFAULTS_LOCAL_LLM = [
     String(HINDSIGHT_DEFAULT_CONSOLIDATION_LLM_MAX_CONCURRENT)
   ],
   ["HINDSIGHT_API_LLM_STRICT_SCHEMA", HINDSIGHT_DEFAULT_LLM_STRICT_SCHEMA],
-  ["HINDSIGHT_API_LLM_MAX_RETRIES", String(HINDSIGHT_DEFAULT_LLM_MAX_RETRIES)]
+  ["HINDSIGHT_API_LLM_MAX_RETRIES", String(HINDSIGHT_DEFAULT_LLM_MAX_RETRIES)],
+  ["HINDSIGHT_API_LLM_SUPPORTS_MAX_ITEMS", HINDSIGHT_DEFAULT_LLM_SUPPORTS_MAX_ITEMS]
 ];
 var HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS = new Set([
   "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY",
   "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP",
   "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS",
   "HINDSIGHT_API_WORKER_MAX_SLOTS",
-  "HINDSIGHT_API_WORKER_RETAIN_MAX_SLOTS"
+  "HINDSIGHT_API_WORKER_RETAIN_RESERVED_SLOTS",
+  "HINDSIGHT_API_SEMANTIC_MIN_SIMILARITY",
+  "HINDSIGHT_MCP_RECALL_BUDGET_MODE",
+  "HINDSIGHT_API_LLM_TEMPERATURE_REFLECT",
+  "HINDSIGHT_API_RETAIN_WALL_TIMEOUT"
 ]);
+var HINDSIGHT_WORKER_SLOT_TYPES = [
+  "consolidation",
+  "file_convert_retain",
+  "graph_maintenance",
+  "import_documents",
+  "refresh_mental_model",
+  "retain"
+];
+var HINDSIGHT_WORKER_RESERVED_SLOT_ALIASES = new Map(HINDSIGHT_WORKER_SLOT_TYPES.map((type) => [
+  `HINDSIGHT_API_WORKER_${type.toUpperCase()}_MAX_SLOTS`,
+  `HINDSIGHT_API_WORKER_${type.toUpperCase()}_RESERVED_SLOTS`
+]));
 var HINDSIGHT_PERF_ENV_KEYS = new Set([
   ...[
     ...HINDSIGHT_PERF_DEFAULTS_UNGATED,
     ...HINDSIGHT_PERF_DEFAULTS_GPU,
     ...HINDSIGHT_PERF_DEFAULTS_LOCAL_LLM
   ].map(([k]) => k),
-  ...HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS
+  ...HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS,
+  ...HINDSIGHT_WORKER_RESERVED_SLOT_ALIASES.keys(),
+  ...HINDSIGHT_WORKER_RESERVED_SLOT_ALIASES.values()
 ]);
 
 // src/setup/hindsight-context-budget.ts
@@ -29543,6 +29568,17 @@ function deferredLines(target) {
     `- hostd template regen (only if the release changed hostd mounts/env) — \`switchroom hostd install --tag ${target}\``
   ];
 }
+function warningLines(warnings) {
+  if (!warnings || warnings.length === 0)
+    return [];
+  const MAX_SHOWN = 8;
+  const shown = warnings.slice(0, MAX_SHOWN);
+  const lines = ["**Warnings:**", ...shown.map((w) => `- ⚠️ ${w}`)];
+  if (warnings.length > MAX_SHOWN) {
+    lines.push(`- …and ${warnings.length - MAX_SHOWN} more (see \`get_status\`).`);
+  }
+  return lines;
+}
 var MAX_RENDER_CHARS = 3800;
 function rolledList(rolled, compact) {
   if (rolled.length === 0)
@@ -29556,6 +29592,7 @@ function renderWith(s, compact) {
   const rolledCount = rolled.length;
   const checklist = checklistLines(s, compact);
   const singletons = singletonLines(s);
+  const warnings = warningLines(s.warnings);
   const elapsedMs = s.elapsedMs ?? (s.startedAtMs !== undefined && s.nowMs !== undefined ? s.nowMs - s.startedAtMs : undefined);
   if (s.terminal === "completed") {
     const parts2 = [headerLine(s, "✅")];
@@ -29568,6 +29605,8 @@ function renderWith(s, compact) {
       parts2.push("", ...checklist);
     if (singletons.length > 0)
       parts2.push("", ...singletons);
+    if (warnings.length > 0)
+      parts2.push("", ...warnings);
     if (s.deferred !== false)
       parts2.push("", ...deferredLines(s.target));
     return parts2.join(`
@@ -29587,6 +29626,8 @@ function renderWith(s, compact) {
       parts2.push("", ...checklist);
     if (singletons.length > 0)
       parts2.push("", ...singletons);
+    if (warnings.length > 0)
+      parts2.push("", ...warnings);
     return parts2.join(`
 `);
   }
@@ -29602,6 +29643,8 @@ function renderWith(s, compact) {
       parts2.push("", ...checklist);
     if (singletons.length > 0)
       parts2.push("", ...singletons);
+    if (warnings.length > 0)
+      parts2.push("", ...warnings);
     return parts2.join(`
 `);
   }
@@ -31487,6 +31530,9 @@ ${output.recovery.stderr}` : "";
         if (parsed.drifted && parsed.drifted.length > 0) {
           entry.drifted = parsed.drifted;
         }
+        if (parsed.warnings && parsed.warnings.length > 0) {
+          entry.warnings = parsed.warnings;
+        }
         if (parsed.got !== undefined)
           entry.got = parsed.got;
         if (parsed.timedOut)
@@ -31629,7 +31675,8 @@ ${pinNote}`.trim();
         ...entry.failed_step ? { failedStep: entry.failed_step } : {},
         ...entry.failed_agent ? { failedAgent: entry.failed_agent } : {},
         ...entry.got !== undefined ? { got: entry.got } : {},
-        ...entry.drifted && entry.drifted.length > 0 ? { drifted: entry.drifted } : {}
+        ...entry.drifted && entry.drifted.length > 0 ? { drifted: entry.drifted } : {},
+        ...entry.warnings && entry.warnings.length > 0 ? { warnings: entry.warnings } : {}
       });
       this.opts.rolloutRelay.postTerminal({
         requestId: entry.request_id,
@@ -31712,7 +31759,7 @@ ${pinNote}`.trim();
     };
   }
   statusEntryToResponse(request_id, entry) {
-    const rolloutPayload = entry.op === "rollout" && (entry.rolled !== undefined || entry.failed_step !== undefined || entry.failed_agent !== undefined || entry.current_phase !== undefined) ? JSON.stringify({
+    const rolloutPayload = entry.op === "rollout" && (entry.rolled !== undefined || entry.failed_step !== undefined || entry.failed_agent !== undefined || entry.warnings !== undefined && entry.warnings.length > 0 || entry.current_phase !== undefined) ? JSON.stringify({
       rolled: entry.rolled ?? [],
       ...entry.current_phase ? { phase: entry.current_phase } : {},
       ...entry.phase_n !== undefined ? { n: entry.phase_n } : {},
@@ -31722,6 +31769,7 @@ ${pinNote}`.trim();
       ...entry.failed_agent ? { failedAgent: entry.failed_agent } : {},
       ...entry.got !== undefined ? { got: entry.got } : {},
       ...entry.drifted && entry.drifted.length > 0 ? { drifted: entry.drifted } : {},
+      ...entry.warnings && entry.warnings.length > 0 ? { warnings: entry.warnings } : {},
       ...entry.pin ? { pin: entry.pin } : {},
       ...entry.prior_pin ? { prior_pin: entry.prior_pin } : {}
     }) : undefined;
@@ -32285,6 +32333,7 @@ class SocketRolloutRelay {
 // src/host-control/rollout-narration-relay.ts
 import { connect as connect4 } from "node:net";
 var DEFAULT_POST_REPLY_TIMEOUT_MS = 5000;
+var DEFAULT_EDIT_REPLY_TIMEOUT_MS = 5000;
 
 class SocketRolloutNarrationRelay {
   opts;
@@ -32382,18 +32431,40 @@ class SocketRolloutNarrationRelay {
       sockPath = this.opts.resolveGatewaySocket(args.agentName);
     } catch (e) {
       log(`narration edit resolveGatewaySocket threw: ${e.message}`);
-      return;
+      return Promise.resolve({
+        ok: false,
+        gone: false,
+        reason: `resolveGatewaySocket threw: ${e.message}`
+      });
     }
-    if (sockPath === null)
-      return;
-    try {
-      const client2 = connect4({ path: sockPath });
-      client2.setTimeout(5000);
-      const done = () => {
+    if (sockPath === null) {
+      return Promise.resolve({
+        ok: false,
+        gone: false,
+        reason: "no reachable gateway"
+      });
+    }
+    return new Promise((resolve10) => {
+      let settled = false;
+      let client2;
+      const finish = (outcome) => {
+        if (settled)
+          return;
+        settled = true;
         try {
           client2.destroy();
         } catch {}
+        resolve10(outcome);
       };
+      try {
+        client2 = connect4({ path: sockPath });
+      } catch (e) {
+        log(`narration edit connect threw: ${e.message}`);
+        resolve10({ ok: false, gone: false, reason: e.message });
+        return;
+      }
+      client2.setTimeout(this.opts.editReplyTimeoutMs ?? DEFAULT_EDIT_REPLY_TIMEOUT_MS);
+      let buffer = "";
       client2.on("connect", () => {
         try {
           client2.write(JSON.stringify({
@@ -32404,21 +32475,46 @@ class SocketRolloutNarrationRelay {
             text: args.text
           }) + `
 `);
-          client2.end();
         } catch (e) {
           log(`narration edit write failed: ${e.message}`);
-          done();
+          finish({ ok: false, gone: false, reason: e.message });
+        }
+      });
+      client2.on("data", (chunk2) => {
+        buffer += chunk2.toString("utf8");
+        const lines = buffer.split(`
+`);
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+          if (!line.trim())
+            continue;
+          let obj;
+          try {
+            obj = JSON.parse(line);
+          } catch {
+            continue;
+          }
+          if (obj.type === "rollout_status_edited" && obj.requestId === args.requestId) {
+            if (obj.ok === true) {
+              finish({ ok: true });
+            } else {
+              finish({
+                ok: false,
+                gone: obj.gone === true,
+                ...typeof obj.reason === "string" ? { reason: obj.reason } : {}
+              });
+            }
+            return;
+          }
         }
       });
-      client2.on("timeout", done);
+      client2.on("timeout", () => finish({ ok: false, gone: false, reason: "edit reply timed out" }));
       client2.on("error", (e) => {
         log(`narration edit socket error: ${e.message}`);
-        done();
+        finish({ ok: false, gone: false, reason: e.message });
       });
-      client2.on("close", () => {});
-    } catch (e) {
-      log(`narration edit connect threw: ${e.message}`);
-    }
+      client2.on("close", () => finish({ ok: false, gone: false, reason: "no edit reply" }));
+    });
   }
 }
 
@@ -32731,9 +32827,62 @@ class LogTailRolloutNarrator {
       singletons: initialSingletons(),
       frozen: false,
       timer: null,
-      pendingEditAfterPost: false
+      pendingEditAfterPost: false,
+      goneRepostUsed: false,
+      goneRepostForMessageId: null
     };
   }
+  escalateCard(esc) {
+    try {
+      if (this.opts.escalate) {
+        this.opts.escalate(esc);
+        return;
+      }
+      this.opts.log?.(`rollout card escalation request=${esc.requestId} agent=${esc.agentName} ` + `staleMessageId=${esc.staleMessageId} reason=${esc.reason}` + `${esc.detail !== undefined ? ` detail=${esc.detail}` : ""} ` + `— card could not be restored, no operator card issued (get_status remains the record)`);
+    } catch {}
+  }
+  onEditOutcome(requestId, editedMessageId, outcome) {
+    if (outcome.ok)
+      return;
+    const st = this.states.get(requestId);
+    if (!st)
+      return;
+    if (!outcome.gone) {
+      this.opts.log?.(`rollout narration edit failed (transient, requestId=${requestId}): ${outcome.reason ?? "unknown"}`);
+      return;
+    }
+    if (st.messageId !== editedMessageId)
+      return;
+    if (st.goneRepostUsed) {
+      this.escalateCard({
+        requestId,
+        agentName: st.agentName,
+        staleMessageId: editedMessageId,
+        reason: "gone-again",
+        detail: outcome.reason
+      });
+      return;
+    }
+    st.goneRepostUsed = true;
+    st.messageId = null;
+    st.postFailed = false;
+    st.goneRepostForMessageId = editedMessageId;
+    if (st.timer) {
+      clearTimeout(st.timer);
+      st.timer = null;
+    }
+    this.opts.log?.(`rollout narration card ${editedMessageId} is gone (requestId=${requestId}); re-posting once`);
+    if (!this.tryPost(requestId, true)) {
+      st.goneRepostForMessageId = null;
+      this.escalateCard({
+        requestId,
+        agentName: st.agentName,
+        staleMessageId: editedMessageId,
+        reason: "repost-unavailable",
+        detail: "post-attempt cap reached"
+      });
+    }
+  }
   ensureState(entry) {
     let st = this.states.get(entry.request_id);
     if (!st) {
@@ -32797,10 +32946,22 @@ class LogTailRolloutNarrator {
       if (mid === null) {
         st.postFailed = true;
         this.opts.log?.(`rollout narration post returned no message_id (requestId=${requestId}); backing off re-posts`);
+        if (st.goneRepostForMessageId !== null) {
+          const stale = st.goneRepostForMessageId;
+          st.goneRepostForMessageId = null;
+          this.escalateCard({
+            requestId,
+            agentName: st.agentName,
+            staleMessageId: stale,
+            reason: "repost-failed",
+            detail: "post returned no message_id"
+          });
+        }
         return;
       }
       st.messageId = mid;
       st.postFailed = false;
+      st.goneRepostForMessageId = null;
       try {
         this.opts.onMessageId?.(requestId, mid);
       } catch (e) {
@@ -32814,6 +32975,17 @@ class LogTailRolloutNarrator {
       st.posting = false;
       st.postFailed = true;
       this.opts.log?.(`rollout narration post failed (non-fatal): ${e.message}`);
+      if (st.goneRepostForMessageId !== null) {
+        const stale = st.goneRepostForMessageId;
+        st.goneRepostForMessageId = null;
+        this.escalateCard({
+          requestId,
+          agentName: st.agentName,
+          staleMessageId: stale,
+          reason: "repost-failed",
+          detail: e.message
+        });
+      }
     });
     return true;
   }
@@ -32849,11 +33021,14 @@ class LogTailRolloutNarrator {
       return;
     }
     const text = renderRolloutStatus({ ...st.render, nowMs: this.now() });
+    const editedMessageId = st.messageId;
     this.relay.edit({
       requestId,
       agentName: st.agentName,
-      messageId: st.messageId,
+      messageId: editedMessageId,
       text
+    }).then((outcome) => this.onEditOutcome(requestId, editedMessageId, outcome)).catch((e) => {
+      this.opts.log?.(`rollout narration edit relay rejected (non-fatal): ${e.message}`);
     });
   }
 }
@@ -33453,7 +33628,9 @@ async function main() {
   }), {
     log: (m) => process.stderr.write(`hostd: rollout-narration — ${m}
 `),
-    onMessageId: (rid, mid) => server?.persistNarrationMessageId(rid, mid)
+    onMessageId: (rid, mid) => server?.persistNarrationMessageId(rid, mid),
+    escalate: (esc) => process.stderr.write(`hostd: rollout card escalation request=${esc.requestId} agent=${esc.agentName} ` + `staleMessageId=${esc.staleMessageId} reason=${esc.reason}` + `${esc.detail !== undefined ? ` detail=${esc.detail}` : ""} ` + `— card could not be restored, no operator card issued
+`)
   });
   const server = new HostdServer({
     homeDir: homedir8(),

package/dist/vault/approvals/kernel-server.js

@@ -4856,7 +4856,7 @@ var init_schema = __esm(() => {
       reflect: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `reflect` LLM op (synthesis / mental-model " + "refresh). Emits `HINDSIGHT_API_REFLECT_LLM_*`. Absent → uses global."),
       consolidation: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `consolidation` LLM op (background memory " + "merge). Emits `HINDSIGHT_API_CONSOLIDATION_LLM_*`. Absent → global.")
     }).optional().describe("LLM knob for the hindsight container. The flat `provider`/`model` set " + "the global default (backward-compatible); optional `retain`/`reflect`/" + "`consolidation` blocks override individual ops. All fields optional; " + "unset fields fall back to the hard-coded defaults."),
-    env: exports_external.record(exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean()])).optional().describe("Operator overrides for switchroom's capability-gated Hindsight " + "performance defaults. Only the keys switchroom actually manages are " + "honoured (`HINDSIGHT_PERF_ENV_KEYS` in " + "src/setup/hindsight-perf-defaults.ts: RERANKER_LOCAL_FP16, " + "RERANKER_LOCAL_BATCH_SIZE, LLM_MAX_CONCURRENT, " + "RETAIN/CONSOLIDATION_LLM_MAX_CONCURRENT, LLM_STRICT_SCHEMA, " + "LLM_MAX_RETRIES, CONSOLIDATION_LLM_PARALLELISM, " + "MAX_OBSERVATIONS_PER_SCOPE, " + "RECALL_MAX_CANDIDATES_PER_SOURCE, LINK_EXPANSION_PER_ENTITY_LIMIT, " + "LINK_EXPANSION_TIMEOUT, LLM_REASONING_EFFORT, " + "RERANKER_LOCAL_BUCKET_BATCHING, RERANKER_MAX_CANDIDATES, " + "RERANKER_LOCAL_MAX_CONCURRENT, RECALL_MAX_CONCURRENT, " + "REFLECT_WALL_TIMEOUT, WORKER_CONSOLIDATION_MAX_SLOTS, " + "WORKER_CONSOLIDATION_SLOT_LIMIT, " + "CONSOLIDATION_MAX_MEMORIES_PER_ROUND, RECENCY_DECAY_FUNCTION, " + "RECENCY_DECAY_HALFLIFE_DAYS — switchroom defaults recall's recency " + "curve to `exponential` with a 30-day half-life so a fact retained " + "today outranks a stale one, instead of upstream's near-flat " + "linear/365-day window), the override-only keys " + "switchroom manages but ships NO default for " + "(`HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS`: " + "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY — a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks; and " + "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP — the rollback knob for " + "switchroom's CE-saturation damping patch, a float; >= ~0.65 backs the " + "damping out entirely, unset means the patch's own derived gap; and " + "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS — only read when the " + "decay function is `linear`, so switchroom ships no default for it but " + "still honours an operator who flips the function back; and " + "HINDSIGHT_API_WORKER_MAX_SLOTS — the worker poller's TOTAL in-flight " + "task budget, the pool WORKER_CONSOLIDATION_MAX_SLOTS reserves out of; " + "unset means upstream's own default; and " + "HINDSIGHT_API_WORKER_RETAIN_MAX_SLOTS — the reserved slot FLOOR for the " + "retain (memory write) lane, carved from that same total; unset means " + "upstream's own 0, i.e. no floor and retain competes for the shared " + "pool), plus the " + "embedded-PostgreSQL (pg0) sizing keys switchroom manages in " + "src/setup/hindsight-pg-defaults.ts (`HINDSIGHT_PG_ENV_KEYS`: " + "SWITCHROOM_HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE, " + "SWITCHROOM_HINDSIGHT_PG_SHARED_BUFFERS — a postgres size string such " + "as `4GB`, or the sentinel `off` to leave pg0's own default for that " + "one knob). A value set here " + "REPLACES switchroom's default and is emitted even when the gating " + "capability is absent, so an operator can always force a knob. Other " + "`HINDSIGHT_API_*` keys are deliberately IGNORED — a blanket " + "passthrough would collide with the vars startHindsight() derives " + "itself (HINDSIGHT_API_PORT, the retain token/deadline budget).")
+    env: exports_external.record(exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean()])).optional().describe("Operator overrides for switchroom's capability-gated Hindsight " + "performance defaults. Only the keys switchroom actually manages are " + "honoured (`HINDSIGHT_PERF_ENV_KEYS` in " + "src/setup/hindsight-perf-defaults.ts: RERANKER_LOCAL_FP16, " + "RERANKER_LOCAL_BATCH_SIZE, LLM_MAX_CONCURRENT, " + "RETAIN/CONSOLIDATION_LLM_MAX_CONCURRENT, LLM_STRICT_SCHEMA, " + "LLM_MAX_RETRIES, CONSOLIDATION_LLM_PARALLELISM, " + "MAX_OBSERVATIONS_PER_SCOPE, " + "RECALL_MAX_CANDIDATES_PER_SOURCE, LINK_EXPANSION_PER_ENTITY_LIMIT, " + "LINK_EXPANSION_TIMEOUT, LLM_REASONING_EFFORT, " + "RERANKER_LOCAL_BUCKET_BATCHING, RERANKER_MAX_CANDIDATES, " + "RERANKER_LOCAL_MAX_CONCURRENT, RECALL_MAX_CONCURRENT, " + "REFLECT_WALL_TIMEOUT, WORKER_CONSOLIDATION_RESERVED_SLOTS, " + "WORKER_CONSOLIDATION_SLOT_LIMIT, " + "CONSOLIDATION_MAX_MEMORIES_PER_ROUND, GRAPH_SEED_MIN_SIMILARITY, " + "LLM_SUPPORTS_MAX_ITEMS, RECENCY_DECAY_FUNCTION, " + "RECENCY_DECAY_HALFLIFE_DAYS — switchroom defaults recall's recency " + "curve to `exponential` with a 30-day half-life so a fact retained " + "today outranks a stale one, instead of upstream's near-flat " + "linear/365-day window), the override-only keys " + "switchroom manages but ships NO default for " + "(`HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS`: " + "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY — a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks; and " + "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP — the rollback knob for " + "switchroom's CE-saturation damping patch, a float; >= ~0.65 backs the " + "damping out entirely, unset means the patch's own derived gap; and " + "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS — only read when the " + "decay function is `linear`, so switchroom ships no default for it but " + "still honours an operator who flips the function back; and " + "HINDSIGHT_API_WORKER_MAX_SLOTS — the worker poller's TOTAL in-flight " + "task budget, the pool WORKER_CONSOLIDATION_RESERVED_SLOTS reserves out of; " + "unset means upstream's own default; and " + "HINDSIGHT_API_WORKER_RETAIN_RESERVED_SLOTS — the reserved slot FLOOR for the " + "retain (memory write) lane, carved from that same total; unset means " + "upstream's own 0, i.e. no floor and retain competes for the shared " + "pool; and " + "the pre-0.8.6 name HINDSIGHT_API_WORKER_<TYPE>_MAX_SLOTS is still " + "accepted for every operation type and normalised to " + "..._RESERVED_SLOTS on the way in, because setting both names for " + "one type is a hard boot failure in the engine and switchroom " + "therefore emits only the canonical name; and " + "HINDSIGHT_API_SEMANTIC_MIN_SIMILARITY — the cosine-similarity floor a " + "candidate must reach to be returned by the semantic retrieval arm at " + "all (0..1); unset means upstream's own 0.3, and where it should sit " + "depends on the bank's embedding model and phrasing diversity, so " + "switchroom ships no opinion; and " + "HINDSIGHT_MCP_RECALL_BUDGET_MODE — the rollback knob for switchroom's " + "mcp-recall-token-budget image patch; `legacy` restores upstream's " + "exact pre-patch recall returns, anything else or unset is the " + "honest-envelope mode; and " + "HINDSIGHT_API_LLM_TEMPERATURE_REFLECT — upstream's own per-op reflect " + "temperature knob, made live by switchroom's reflect-temperature image " + "patch; a float, or `none` to omit the kwarg (provider default, " + "upstream's accidental pre-patch behaviour); unset means the image's " + "baked default 0.1), plus the " + "embedded-PostgreSQL (pg0) sizing keys switchroom manages in " + "src/setup/hindsight-pg-defaults.ts (`HINDSIGHT_PG_ENV_KEYS`: " + "SWITCHROOM_HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE, " + "SWITCHROOM_HINDSIGHT_PG_SHARED_BUFFERS — a postgres size string such " + "as `4GB`, or the sentinel `off` to leave pg0's own default for that " + "one knob). A value set here " + "REPLACES switchroom's default and is emitted even when the gating " + "capability is absent, so an operator can always force a knob. Other " + "`HINDSIGHT_API_*` keys are deliberately IGNORED — a blanket " + "passthrough would collide with the vars startHindsight() derives " + "itself (HINDSIGHT_API_PORT, the retain token/deadline budget).")
   });
   MicrosoftWorkspaceConfigSchema = exports_external.object({
     microsoft_client_id: exports_external.string().min(1).optional().describe("Microsoft OAuth application (client) ID from Entra portal " + "(literal string or vault reference e.g. " + "'vault:microsoft-oauth-client-id'). OPTIONAL — omit it to use " + "switchroom's shipped default Microsoft app (zero-config). " + "Set it only to bring your own Entra app (BYO)."),
@@ -19413,7 +19413,9 @@ var HINDSIGHT_DEFAULT_RECALL_MAX_CONCURRENT = 8;
 var HINDSIGHT_DEFAULT_REFLECT_WALL_TIMEOUT_S = 600;
 var HINDSIGHT_DEFAULT_CONSOLIDATION_MAX_MEMORIES_PER_ROUND = 250;
 var HINDSIGHT_DEFAULT_CONSOLIDATION_SLOT_LIMIT = 6;
-var HINDSIGHT_DEFAULT_CONSOLIDATION_MAX_SLOTS = 1;
+var HINDSIGHT_DEFAULT_CONSOLIDATION_RESERVED_SLOTS = 1;
+var HINDSIGHT_DEFAULT_GRAPH_SEED_MIN_SIMILARITY = 0.3;
+var HINDSIGHT_DEFAULT_LLM_SUPPORTS_MAX_ITEMS = "false";
 var HINDSIGHT_DEFAULT_RECENCY_DECAY_FUNCTION = "exponential";
 var HINDSIGHT_DEFAULT_RECENCY_DECAY_HALFLIFE_DAYS = 30;
 var HINDSIGHT_PERF_DEFAULTS_UNGATED = [
@@ -19459,8 +19461,8 @@ var HINDSIGHT_PERF_DEFAULTS_UNGATED = [
     String(HINDSIGHT_DEFAULT_REFLECT_WALL_TIMEOUT_S)
   ],
   [
-    "HINDSIGHT_API_WORKER_CONSOLIDATION_MAX_SLOTS",
-    String(HINDSIGHT_DEFAULT_CONSOLIDATION_MAX_SLOTS)
+    "HINDSIGHT_API_WORKER_CONSOLIDATION_RESERVED_SLOTS",
+    String(HINDSIGHT_DEFAULT_CONSOLIDATION_RESERVED_SLOTS)
   ],
   [
     "HINDSIGHT_API_WORKER_CONSOLIDATION_SLOT_LIMIT",
@@ -19477,6 +19479,10 @@ var HINDSIGHT_PERF_DEFAULTS_UNGATED = [
   [
     "HINDSIGHT_API_RECENCY_DECAY_HALFLIFE_DAYS",
     String(HINDSIGHT_DEFAULT_RECENCY_DECAY_HALFLIFE_DAYS)
+  ],
+  [
+    "HINDSIGHT_API_GRAPH_SEED_MIN_SIMILARITY",
+    String(HINDSIGHT_DEFAULT_GRAPH_SEED_MIN_SIMILARITY)
   ]
 ];
 var HINDSIGHT_PERF_DEFAULTS_GPU = [
@@ -19497,22 +19503,41 @@ var HINDSIGHT_PERF_DEFAULTS_LOCAL_LLM = [
     String(HINDSIGHT_DEFAULT_CONSOLIDATION_LLM_MAX_CONCURRENT)
   ],
   ["HINDSIGHT_API_LLM_STRICT_SCHEMA", HINDSIGHT_DEFAULT_LLM_STRICT_SCHEMA],
-  ["HINDSIGHT_API_LLM_MAX_RETRIES", String(HINDSIGHT_DEFAULT_LLM_MAX_RETRIES)]
+  ["HINDSIGHT_API_LLM_MAX_RETRIES", String(HINDSIGHT_DEFAULT_LLM_MAX_RETRIES)],
+  ["HINDSIGHT_API_LLM_SUPPORTS_MAX_ITEMS", HINDSIGHT_DEFAULT_LLM_SUPPORTS_MAX_ITEMS]
 ];
 var HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS = new Set([
   "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY",
   "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP",
   "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS",
   "HINDSIGHT_API_WORKER_MAX_SLOTS",
-  "HINDSIGHT_API_WORKER_RETAIN_MAX_SLOTS"
+  "HINDSIGHT_API_WORKER_RETAIN_RESERVED_SLOTS",
+  "HINDSIGHT_API_SEMANTIC_MIN_SIMILARITY",
+  "HINDSIGHT_MCP_RECALL_BUDGET_MODE",
+  "HINDSIGHT_API_LLM_TEMPERATURE_REFLECT",
+  "HINDSIGHT_API_RETAIN_WALL_TIMEOUT"
 ]);
+var HINDSIGHT_WORKER_SLOT_TYPES = [
+  "consolidation",
+  "file_convert_retain",
+  "graph_maintenance",
+  "import_documents",
+  "refresh_mental_model",
+  "retain"
+];
+var HINDSIGHT_WORKER_RESERVED_SLOT_ALIASES = new Map(HINDSIGHT_WORKER_SLOT_TYPES.map((type) => [
+  `HINDSIGHT_API_WORKER_${type.toUpperCase()}_MAX_SLOTS`,
+  `HINDSIGHT_API_WORKER_${type.toUpperCase()}_RESERVED_SLOTS`
+]));
 var HINDSIGHT_PERF_ENV_KEYS = new Set([
   ...[
     ...HINDSIGHT_PERF_DEFAULTS_UNGATED,
     ...HINDSIGHT_PERF_DEFAULTS_GPU,
     ...HINDSIGHT_PERF_DEFAULTS_LOCAL_LLM
   ].map(([k]) => k),
-  ...HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS
+  ...HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS,
+  ...HINDSIGHT_WORKER_RESERVED_SLOT_ALIASES.keys(),
+  ...HINDSIGHT_WORKER_RESERVED_SLOT_ALIASES.values()
 ]);
 
 // src/setup/hindsight-context-budget.ts

package/dist/vault/broker/server.js

@@ -4452,7 +4452,7 @@ var init_schema = __esm(() => {
       reflect: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `reflect` LLM op (synthesis / mental-model " + "refresh). Emits `HINDSIGHT_API_REFLECT_LLM_*`. Absent → uses global."),
       consolidation: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `consolidation` LLM op (background memory " + "merge). Emits `HINDSIGHT_API_CONSOLIDATION_LLM_*`. Absent → global.")
     }).optional().describe("LLM knob for the hindsight container. The flat `provider`/`model` set " + "the global default (backward-compatible); optional `retain`/`reflect`/" + "`consolidation` blocks override individual ops. All fields optional; " + "unset fields fall back to the hard-coded defaults."),
-    env: exports_external.record(exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean()])).optional().describe("Operator overrides for switchroom's capability-gated Hindsight " + "performance defaults. Only the keys switchroom actually manages are " + "honoured (`HINDSIGHT_PERF_ENV_KEYS` in " + "src/setup/hindsight-perf-defaults.ts: RERANKER_LOCAL_FP16, " + "RERANKER_LOCAL_BATCH_SIZE, LLM_MAX_CONCURRENT, " + "RETAIN/CONSOLIDATION_LLM_MAX_CONCURRENT, LLM_STRICT_SCHEMA, " + "LLM_MAX_RETRIES, CONSOLIDATION_LLM_PARALLELISM, " + "MAX_OBSERVATIONS_PER_SCOPE, " + "RECALL_MAX_CANDIDATES_PER_SOURCE, LINK_EXPANSION_PER_ENTITY_LIMIT, " + "LINK_EXPANSION_TIMEOUT, LLM_REASONING_EFFORT, " + "RERANKER_LOCAL_BUCKET_BATCHING, RERANKER_MAX_CANDIDATES, " + "RERANKER_LOCAL_MAX_CONCURRENT, RECALL_MAX_CONCURRENT, " + "REFLECT_WALL_TIMEOUT, WORKER_CONSOLIDATION_MAX_SLOTS, " + "WORKER_CONSOLIDATION_SLOT_LIMIT, " + "CONSOLIDATION_MAX_MEMORIES_PER_ROUND, RECENCY_DECAY_FUNCTION, " + "RECENCY_DECAY_HALFLIFE_DAYS — switchroom defaults recall's recency " + "curve to `exponential` with a 30-day half-life so a fact retained " + "today outranks a stale one, instead of upstream's near-flat " + "linear/365-day window), the override-only keys " + "switchroom manages but ships NO default for " + "(`HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS`: " + "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY — a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks; and " + "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP — the rollback knob for " + "switchroom's CE-saturation damping patch, a float; >= ~0.65 backs the " + "damping out entirely, unset means the patch's own derived gap; and " + "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS — only read when the " + "decay function is `linear`, so switchroom ships no default for it but " + "still honours an operator who flips the function back; and " + "HINDSIGHT_API_WORKER_MAX_SLOTS — the worker poller's TOTAL in-flight " + "task budget, the pool WORKER_CONSOLIDATION_MAX_SLOTS reserves out of; " + "unset means upstream's own default; and " + "HINDSIGHT_API_WORKER_RETAIN_MAX_SLOTS — the reserved slot FLOOR for the " + "retain (memory write) lane, carved from that same total; unset means " + "upstream's own 0, i.e. no floor and retain competes for the shared " + "pool), plus the " + "embedded-PostgreSQL (pg0) sizing keys switchroom manages in " + "src/setup/hindsight-pg-defaults.ts (`HINDSIGHT_PG_ENV_KEYS`: " + "SWITCHROOM_HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE, " + "SWITCHROOM_HINDSIGHT_PG_SHARED_BUFFERS — a postgres size string such " + "as `4GB`, or the sentinel `off` to leave pg0's own default for that " + "one knob). A value set here " + "REPLACES switchroom's default and is emitted even when the gating " + "capability is absent, so an operator can always force a knob. Other " + "`HINDSIGHT_API_*` keys are deliberately IGNORED — a blanket " + "passthrough would collide with the vars startHindsight() derives " + "itself (HINDSIGHT_API_PORT, the retain token/deadline budget).")
+    env: exports_external.record(exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean()])).optional().describe("Operator overrides for switchroom's capability-gated Hindsight " + "performance defaults. Only the keys switchroom actually manages are " + "honoured (`HINDSIGHT_PERF_ENV_KEYS` in " + "src/setup/hindsight-perf-defaults.ts: RERANKER_LOCAL_FP16, " + "RERANKER_LOCAL_BATCH_SIZE, LLM_MAX_CONCURRENT, " + "RETAIN/CONSOLIDATION_LLM_MAX_CONCURRENT, LLM_STRICT_SCHEMA, " + "LLM_MAX_RETRIES, CONSOLIDATION_LLM_PARALLELISM, " + "MAX_OBSERVATIONS_PER_SCOPE, " + "RECALL_MAX_CANDIDATES_PER_SOURCE, LINK_EXPANSION_PER_ENTITY_LIMIT, " + "LINK_EXPANSION_TIMEOUT, LLM_REASONING_EFFORT, " + "RERANKER_LOCAL_BUCKET_BATCHING, RERANKER_MAX_CANDIDATES, " + "RERANKER_LOCAL_MAX_CONCURRENT, RECALL_MAX_CONCURRENT, " + "REFLECT_WALL_TIMEOUT, WORKER_CONSOLIDATION_RESERVED_SLOTS, " + "WORKER_CONSOLIDATION_SLOT_LIMIT, " + "CONSOLIDATION_MAX_MEMORIES_PER_ROUND, GRAPH_SEED_MIN_SIMILARITY, " + "LLM_SUPPORTS_MAX_ITEMS, RECENCY_DECAY_FUNCTION, " + "RECENCY_DECAY_HALFLIFE_DAYS — switchroom defaults recall's recency " + "curve to `exponential` with a 30-day half-life so a fact retained " + "today outranks a stale one, instead of upstream's near-flat " + "linear/365-day window), the override-only keys " + "switchroom manages but ships NO default for " + "(`HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS`: " + "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY — a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks; and " + "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP — the rollback knob for " + "switchroom's CE-saturation damping patch, a float; >= ~0.65 backs the " + "damping out entirely, unset means the patch's own derived gap; and " + "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS — only read when the " + "decay function is `linear`, so switchroom ships no default for it but " + "still honours an operator who flips the function back; and " + "HINDSIGHT_API_WORKER_MAX_SLOTS — the worker poller's TOTAL in-flight " + "task budget, the pool WORKER_CONSOLIDATION_RESERVED_SLOTS reserves out of; " + "unset means upstream's own default; and " + "HINDSIGHT_API_WORKER_RETAIN_RESERVED_SLOTS — the reserved slot FLOOR for the " + "retain (memory write) lane, carved from that same total; unset means " + "upstream's own 0, i.e. no floor and retain competes for the shared " + "pool; and " + "the pre-0.8.6 name HINDSIGHT_API_WORKER_<TYPE>_MAX_SLOTS is still " + "accepted for every operation type and normalised to " + "..._RESERVED_SLOTS on the way in, because setting both names for " + "one type is a hard boot failure in the engine and switchroom " + "therefore emits only the canonical name; and " + "HINDSIGHT_API_SEMANTIC_MIN_SIMILARITY — the cosine-similarity floor a " + "candidate must reach to be returned by the semantic retrieval arm at " + "all (0..1); unset means upstream's own 0.3, and where it should sit " + "depends on the bank's embedding model and phrasing diversity, so " + "switchroom ships no opinion; and " + "HINDSIGHT_MCP_RECALL_BUDGET_MODE — the rollback knob for switchroom's " + "mcp-recall-token-budget image patch; `legacy` restores upstream's " + "exact pre-patch recall returns, anything else or unset is the " + "honest-envelope mode; and " + "HINDSIGHT_API_LLM_TEMPERATURE_REFLECT — upstream's own per-op reflect " + "temperature knob, made live by switchroom's reflect-temperature image " + "patch; a float, or `none` to omit the kwarg (provider default, " + "upstream's accidental pre-patch behaviour); unset means the image's " + "baked default 0.1), plus the " + "embedded-PostgreSQL (pg0) sizing keys switchroom manages in " + "src/setup/hindsight-pg-defaults.ts (`HINDSIGHT_PG_ENV_KEYS`: " + "SWITCHROOM_HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE, " + "SWITCHROOM_HINDSIGHT_PG_SHARED_BUFFERS — a postgres size string such " + "as `4GB`, or the sentinel `off` to leave pg0's own default for that " + "one knob). A value set here " + "REPLACES switchroom's default and is emitted even when the gating " + "capability is absent, so an operator can always force a knob. Other " + "`HINDSIGHT_API_*` keys are deliberately IGNORED — a blanket " + "passthrough would collide with the vars startHindsight() derives " + "itself (HINDSIGHT_API_PORT, the retain token/deadline budget).")
   });
   MicrosoftWorkspaceConfigSchema = exports_external.object({
     microsoft_client_id: exports_external.string().min(1).optional().describe("Microsoft OAuth application (client) ID from Entra portal " + "(literal string or vault reference e.g. " + "'vault:microsoft-oauth-client-id'). OPTIONAL — omit it to use " + "switchroom's shipped default Microsoft app (zero-config). " + "Set it only to bring your own Entra app (BYO)."),
@@ -19826,7 +19826,9 @@ var HINDSIGHT_DEFAULT_RECALL_MAX_CONCURRENT = 8;
 var HINDSIGHT_DEFAULT_REFLECT_WALL_TIMEOUT_S = 600;
 var HINDSIGHT_DEFAULT_CONSOLIDATION_MAX_MEMORIES_PER_ROUND = 250;
 var HINDSIGHT_DEFAULT_CONSOLIDATION_SLOT_LIMIT = 6;
-var HINDSIGHT_DEFAULT_CONSOLIDATION_MAX_SLOTS = 1;
+var HINDSIGHT_DEFAULT_CONSOLIDATION_RESERVED_SLOTS = 1;
+var HINDSIGHT_DEFAULT_GRAPH_SEED_MIN_SIMILARITY = 0.3;
+var HINDSIGHT_DEFAULT_LLM_SUPPORTS_MAX_ITEMS = "false";
 var HINDSIGHT_DEFAULT_RECENCY_DECAY_FUNCTION = "exponential";
 var HINDSIGHT_DEFAULT_RECENCY_DECAY_HALFLIFE_DAYS = 30;
 var HINDSIGHT_PERF_DEFAULTS_UNGATED = [
@@ -19872,8 +19874,8 @@ var HINDSIGHT_PERF_DEFAULTS_UNGATED = [
     String(HINDSIGHT_DEFAULT_REFLECT_WALL_TIMEOUT_S)
   ],
   [
-    "HINDSIGHT_API_WORKER_CONSOLIDATION_MAX_SLOTS",
-    String(HINDSIGHT_DEFAULT_CONSOLIDATION_MAX_SLOTS)
+    "HINDSIGHT_API_WORKER_CONSOLIDATION_RESERVED_SLOTS",
+    String(HINDSIGHT_DEFAULT_CONSOLIDATION_RESERVED_SLOTS)
   ],
   [
     "HINDSIGHT_API_WORKER_CONSOLIDATION_SLOT_LIMIT",
@@ -19890,6 +19892,10 @@ var HINDSIGHT_PERF_DEFAULTS_UNGATED = [
   [
     "HINDSIGHT_API_RECENCY_DECAY_HALFLIFE_DAYS",
     String(HINDSIGHT_DEFAULT_RECENCY_DECAY_HALFLIFE_DAYS)
+  ],
+  [
+    "HINDSIGHT_API_GRAPH_SEED_MIN_SIMILARITY",
+    String(HINDSIGHT_DEFAULT_GRAPH_SEED_MIN_SIMILARITY)
   ]
 ];
 var HINDSIGHT_PERF_DEFAULTS_GPU = [
@@ -19910,22 +19916,41 @@ var HINDSIGHT_PERF_DEFAULTS_LOCAL_LLM = [
     String(HINDSIGHT_DEFAULT_CONSOLIDATION_LLM_MAX_CONCURRENT)
   ],
   ["HINDSIGHT_API_LLM_STRICT_SCHEMA", HINDSIGHT_DEFAULT_LLM_STRICT_SCHEMA],
-  ["HINDSIGHT_API_LLM_MAX_RETRIES", String(HINDSIGHT_DEFAULT_LLM_MAX_RETRIES)]
+  ["HINDSIGHT_API_LLM_MAX_RETRIES", String(HINDSIGHT_DEFAULT_LLM_MAX_RETRIES)],
+  ["HINDSIGHT_API_LLM_SUPPORTS_MAX_ITEMS", HINDSIGHT_DEFAULT_LLM_SUPPORTS_MAX_ITEMS]
 ];
 var HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS = new Set([
   "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY",
   "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP",
   "HINDSIGHT_API_RECENCY_DECAY_LINEAR_WINDOW_DAYS",
   "HINDSIGHT_API_WORKER_MAX_SLOTS",
-  "HINDSIGHT_API_WORKER_RETAIN_MAX_SLOTS"
+  "HINDSIGHT_API_WORKER_RETAIN_RESERVED_SLOTS",
+  "HINDSIGHT_API_SEMANTIC_MIN_SIMILARITY",
+  "HINDSIGHT_MCP_RECALL_BUDGET_MODE",
+  "HINDSIGHT_API_LLM_TEMPERATURE_REFLECT",
+  "HINDSIGHT_API_RETAIN_WALL_TIMEOUT"
 ]);
+var HINDSIGHT_WORKER_SLOT_TYPES = [
+  "consolidation",
+  "file_convert_retain",
+  "graph_maintenance",
+  "import_documents",
+  "refresh_mental_model",
+  "retain"
+];
+var HINDSIGHT_WORKER_RESERVED_SLOT_ALIASES = new Map(HINDSIGHT_WORKER_SLOT_TYPES.map((type) => [
+  `HINDSIGHT_API_WORKER_${type.toUpperCase()}_MAX_SLOTS`,
+  `HINDSIGHT_API_WORKER_${type.toUpperCase()}_RESERVED_SLOTS`
+]));
 var HINDSIGHT_PERF_ENV_KEYS = new Set([
   ...[
     ...HINDSIGHT_PERF_DEFAULTS_UNGATED,
     ...HINDSIGHT_PERF_DEFAULTS_GPU,
     ...HINDSIGHT_PERF_DEFAULTS_LOCAL_LLM
   ].map(([k]) => k),
-  ...HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS
+  ...HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS,
+  ...HINDSIGHT_WORKER_RESERVED_SLOT_ALIASES.keys(),
+  ...HINDSIGHT_WORKER_RESERVED_SLOT_ALIASES.values()
 ]);
 
 // src/setup/hindsight-context-budget.ts