switchroom 0.19.22 → 0.19.24

package/telegram-plugin/dist/gateway/gateway.js

@@ -21042,16 +21042,19 @@ var init_schema = __esm(() => {
     model: exports_external.string().min(1).optional().describe("Per-op model (upstream `HINDSIGHT_API_<OP>_LLM_MODEL`). Absent \u2192 " + "inherit the global `hindsight.llm.model`."),
     provider: exports_external.string().min(1).optional().describe("Per-op provider (upstream `HINDSIGHT_API_<OP>_LLM_PROVIDER`). " + "Absent \u2192 inherit the global `hindsight.llm.provider`."),
     base_url: exports_external.string().min(1).optional().describe("Per-op base URL (upstream `HINDSIGHT_API_<OP>_LLM_BASE_URL`). " + "Optional passthrough; absent \u2192 inherit the global."),
-    api_key: exports_external.string().min(1).optional().describe("Per-op API key (upstream `HINDSIGHT_API_<OP>_LLM_API_KEY`). Literal " + "or `vault:` reference. Optional passthrough; absent \u2192 inherit global.")
+    api_key: exports_external.string().min(1).optional().describe("Per-op API key (upstream `HINDSIGHT_API_<OP>_LLM_API_KEY`). Literal " + "or `vault:` reference. Optional passthrough; absent \u2192 inherit global."),
+    context_window: exports_external.number().int().positive().optional().describe("Context window (tokens) of the backend serving THIS op. NOT an " + "upstream env var \u2014 switchroom derives the op's token budget " + "(consolidation batch size / max-completion caps / reflect " + "max-context cap) from it so a single call can never overflow the " + "window. Absent \u2192 inherit " + "`hindsight.llm.context_window`, else a per-provider default " + "(conservative for non-`claude-code` providers, which usually mean " + "a local llama.cpp/Ollama slot; a self-hosted `base_url` \u2014 loopback, " + "RFC1918, `.local`/`.internal` \u2014 forces the conservative default too, " + "regardless of the provider NAME, since the endpoint is where the " + "traffic actually terminates). All three lanes (`retain`, " + "`reflect`, `consolidation`) are budgeted independently.")
   }).describe("Per-operation LLM override. Every field optional; an unset field (or " + "an omitted op block) inherits the global `hindsight.llm.*`, which is " + "already the engine's fallback \u2014 switchroom emits only the vars set.");
   HindsightConfigSchema = exports_external.object({
     llm: exports_external.object({
       provider: exports_external.string().min(1).optional().describe("Hindsight LLM provider (upstream `HINDSIGHT_API_LLM_PROVIDER`). " + "Defaults to `claude-code` (subscription-honest, broker-fed OAuth). " + "Any litellm-routable provider the upstream image supports is valid. " + "Serves as the GLOBAL default for every op absent a per-op override."),
       model: exports_external.string().min(1).optional().describe("Hindsight LLM model (upstream `HINDSIGHT_API_LLM_MODEL`). Defaults " + "to HINDSIGHT_DEFAULT_MODEL. Any model your LiteLLM proxy can route " + "is valid, e.g. `openrouter/z-ai/glm-5.2` when routing through the " + "fleet proxy. With provider=claude-code this value is ALSO exported " + "as `ANTHROPIC_MODEL` to the claude subprocess. Serves as the GLOBAL " + "default for every op absent a per-op override."),
+      context_window: exports_external.number().int().positive().optional().describe("GLOBAL context window (tokens) of the backend serving hindsight's " + "LLM ops \u2014 the declared size switchroom derives every token budget " + "from. Set this to the real window of whatever you point " + "`hindsight.llm` at (e.g. 32768 for a llama.cpp slot launched with " + "`-c 65536 -np 2`, 131072 for a large-window OpenRouter model). " + "Absent \u2192 a per-provider default: 200000 for `claude-code`, a " + "conservative 32768 for everything else. Overflowing a local " + "backend's window does NOT error \u2014 llama.cpp context-shift silently " + "drops the system prompt and the model answers conversationally " + "with HTTP 200 \u2014 so this value is what makes the failure " + "detectable at setup time instead of never."),
       retain: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `retain` LLM op (memory ingestion). Emits " + "`HINDSIGHT_API_RETAIN_LLM_*`. Absent \u2192 uses the global model/provider."),
       reflect: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `reflect` LLM op (synthesis / mental-model " + "refresh). Emits `HINDSIGHT_API_REFLECT_LLM_*`. Absent \u2192 uses global."),
       consolidation: HindsightPerOpLlmSchema.optional().describe("Per-op override for the `consolidation` LLM op (background memory " + "merge). Emits `HINDSIGHT_API_CONSOLIDATION_LLM_*`. Absent \u2192 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.")
+    }).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, " + "RECALL_MAX_CANDIDATES_PER_SOURCE, LINK_EXPANSION_PER_ENTITY_LIMIT, " + "LINK_EXPANSION_TIMEOUT, LLM_REASONING_EFFORT), the override-only keys " + "switchroom manages but ships NO default for " + "(`HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS`: " + "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY \u2014 a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks), 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 \u2014 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 \u2014 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 \u2014 omit it to use " + "switchroom's shipped default Microsoft app (zero-config). " + "Set it only to bring your own Entra app (BYO)."),
@@ -63264,7 +63267,8 @@ function createSendGate(config) {
         pending: null,
         running: false,
         suppressedUntilMs: 0,
-        editWindowTs: []
+        editWindowTs: [],
+        criticalWake: null
       };
       perMessage.set(key, state);
     }
@@ -63350,9 +63354,11 @@ function createSendGate(config) {
       }
     }
   }
-  async function admitLoop(buckets, deadline) {
+  async function admitLoop(buckets, deadline, interrupt) {
     let counted = false;
     for (;; ) {
+      if (interrupt?.fired)
+        return false;
       const now = clock.now();
       let wait = 0;
       for (const b of buckets)
@@ -63368,11 +63374,12 @@ function createSendGate(config) {
         counters.queued++;
         counted = true;
       }
-      await clock.sleep(deadline !== undefined ? Math.min(wait, deadline - now) : wait);
+      const nap = clock.sleep(deadline !== undefined ? Math.min(wait, deadline - now) : wait);
+      await (interrupt ? Promise.race([nap, interrupt.promise]) : nap);
     }
   }
-  function admit(buckets) {
-    return admitLoop(buckets);
+  function admit(buckets, interrupt) {
+    return admitLoop(buckets, undefined, interrupt);
   }
   let criticalTail = Promise.resolve();
   function criticalSerialize(job) {
@@ -63390,6 +63397,24 @@ function createSendGate(config) {
       }
     })();
   }
+  function makeInterrupt() {
+    let resolve6;
+    const interrupt = {
+      fired: false,
+      promise: new Promise((r) => {
+        resolve6 = r;
+      })
+    };
+    return {
+      interrupt,
+      fire: () => {
+        if (interrupt.fired)
+          return;
+        interrupt.fired = true;
+        resolve6();
+      }
+    };
+  }
   async function admitPriority(buckets, priority) {
     const now = clock.now();
     if (priority === "cosmetic") {
@@ -63487,7 +63512,18 @@ function createSendGate(config) {
             continue;
           }
         } else {
-          await admit(bucketsFor(opts));
+          const { interrupt, fire } = makeInterrupt();
+          state.criticalWake = fire;
+          let admitted;
+          try {
+            admitted = await admit(bucketsFor(opts), interrupt);
+          } finally {
+            state.criticalWake = null;
+          }
+          if (!admitted) {
+            supersede(state, p);
+            continue;
+          }
         }
         state.lastSentMs = clock.now();
         if (perMessageEditMaxPerWindow > 0 && p.priorityClass === "cosmetic") {
@@ -63512,6 +63548,31 @@ function createSendGate(config) {
       state.running = false;
     }
   }
+  function supersede(state, p) {
+    const next = state.pending;
+    if (!next) {
+      state.pending = p;
+      return;
+    }
+    next.priorityClass = maxPriority(next.priorityClass, p.priorityClass);
+    next.promise.then(p.resolve, p.reject);
+  }
+  function editUnderPressure(state, opts, now) {
+    if (state.suppressedUntilMs > now)
+      return true;
+    for (const b of bucketsFor(opts)) {
+      if (b.msUntilAvailable(now) > 0)
+        return true;
+    }
+    return false;
+  }
+  function settleForCaller(state, pending, opts, priority, now) {
+    if (priority !== "cosmetic" || !editUnderPressure(state, opts, now)) {
+      return pending.promise;
+    }
+    pending.promise.catch(() => {});
+    return Promise.resolve(undefined);
+  }
   function handleEdit(fn, opts) {
     const messageId = opts.messageId;
     const key = messageKey(opts.chat_id, messageId);
@@ -63520,16 +63581,6 @@ function createSendGate(config) {
     const existing = perMessage.get(key);
     maybeEvict(now, existing === undefined);
     const state = existing ?? messageState(key);
-    if ((opts.priorityClass ?? "useful") === "cosmetic") {
-      let wait = 0;
-      for (const b of bucketsFor(opts))
-        wait = Math.max(wait, b.msUntilAvailable(now));
-      const msgWait = state.suppressedUntilMs > now ? state.suppressedUntilMs - now : 0;
-      if (wait > 0 || msgWait > 0) {
-        counters.shed++;
-        return Promise.resolve(SEND_GATE_SHED2);
-      }
-    }
     if (state.pending) {
       state.pending.priorityClass = maxPriority(state.pending.priorityClass, opts.priorityClass ?? "useful");
       if (state.pending.hash !== hash) {
@@ -63537,7 +63588,9 @@ function createSendGate(config) {
         state.pending.hash = hash;
         state.pending.fn = fn;
       }
-      return state.pending.promise;
+      if (state.pending.priorityClass === "critical")
+        state.criticalWake?.();
+      return settleForCaller(state, state.pending, opts, opts.priorityClass ?? "useful", now);
     }
     if (hash === state.lastHash) {
       counters.dropped++;
@@ -63558,9 +63611,13 @@ function createSendGate(config) {
       priorityClass: opts.priorityClass ?? "useful"
     };
     state.pending = pending;
-    if (!state.running)
+    if (state.running) {
+      if (pending.priorityClass === "critical")
+        state.criticalWake?.();
+    } else {
       drive(state, opts);
-    return promise;
+    }
+    return settleForCaller(state, pending, opts, pending.priorityClass, now);
   }
   async function gate(fn, opts) {
     if (!enabled2)
@@ -75868,6 +75925,30 @@ function makeKey3(chatId, threadId) {
 }
 
 // reply-owner-resolve.ts
+function latestEndedAccepted(candidates) {
+  if (candidates.latestEndedTurnId == null)
+    return false;
+  const age = candidates.latestEndedAgeMs;
+  const ttl = candidates.latestEndedTtlMs;
+  if (age === null)
+    return false;
+  if (age === undefined || ttl == null)
+    return true;
+  return age <= ttl;
+}
+function decideContentGateBypass(input) {
+  if (input.tier === "live")
+    return true;
+  if (input.tier === "none")
+    return false;
+  if (input.handbackCouldOwnReply)
+    return false;
+  if (input.candidates == null)
+    return false;
+  if (!latestEndedAccepted(input.candidates))
+    return false;
+  return input.resolvedTurnId != null && input.resolvedTurnId === input.candidates.latestEndedTurnId;
+}
 function decideAnswerLatchSuppression(input) {
   if (input.superseded)
     return false;
@@ -76376,7 +76457,9 @@ function createBackstopReadBack(w) {
     };
     try {
       const r = await w.gate(() => w.editMessageText(messageId, body, editApiOpts), gateOpts);
-      return w.isShed(r) ? "ambiguous" : "exists";
+      if (w.isShed(r) || r === undefined)
+        return "ambiguous";
+      return "exists";
     } catch (err) {
       return classifyReadBackError(err);
     }
@@ -76497,14 +76580,23 @@ async function sendReply(deps, req) {
   let supersedeFlushIds = [];
   {
     const replyThreadId = args.message_thread_id != null ? Number(args.message_thread_id) : undefined;
-    const { turn: ownerTurn, tier: ownerTier } = resolveReplyOwnerTurn(turn, chat_id, args);
+    const {
+      turn: ownerTurn,
+      tier: ownerTier,
+      candidates: ownerCandidates
+    } = resolveReplyOwnerTurn(turn, chat_id, args);
     const resolvedTurnId = ownerTurn?.turnId ?? null;
     const ownerEndedAt = ownerTurn?.endedAt ?? null;
     const gateThreadId = ownerTurn?.sessionThreadId ?? replyThreadId;
     const handbackAt = getLastSubagentHandbackAt(chat_id);
     const now = Date.now();
     const handbackCouldOwnReply = handbackAt != null && ownerEndedAt != null && handbackAt > ownerEndedAt && now - handbackAt <= DEFAULT_SUPERSEDE_TTL_MS2;
-    const replyIsOwnAnswer = ownerTier === "live" || ownerTier === "latest-ended" && !handbackCouldOwnReply;
+    const replyIsOwnAnswer = decideContentGateBypass({
+      tier: ownerTier,
+      resolvedTurnId,
+      candidates: ownerCandidates,
+      handbackCouldOwnReply
+    });
     const decision = flushedTurnSupersede.take(chat_id, gateThreadId, { liveTurnId: resolvedTurnId, replyText: text4, positiveAttribution: replyIsOwnAnswer, now });
     if (decision.supersede) {
       process.stderr.write(`telegram gateway: reply: superseding flushed turn message(s) ` + `chatId=${chat_id} ids=${JSON.stringify(decision.deleteMessageIds)}
@@ -76529,7 +76621,7 @@ async function sendReply(deps, req) {
         replyMatchesFlushedAnswer
       });
       if (decision.reason === "new-content") {
-        process.stderr.write(`telegram gateway: reply: flush supersede declined \u2014 new content (#3429) ` + `chatId=${chat_id} ownerTurnId=${JSON.stringify(resolvedTurnId)}; sending fresh
+        process.stderr.write(`telegram gateway: reply: flush supersede declined \u2014 new content (#3429) ` + `chatId=${chat_id} ownerTurnId=${JSON.stringify(resolvedTurnId)} ` + `tier=${ownerTier} latestEnded=${JSON.stringify(ownerCandidates.latestEndedTurnId)} ` + `handbackInWindow=${handbackCouldOwnReply}; sending fresh
 `);
       }
       if (suppressByLatch) {
@@ -79124,6 +79216,7 @@ function handleSessionEvent(deps, ev) {
               sentIds = delivery.sentIds;
               chunkCount = delivery.chunkCount;
               delivered = delivery.delivered;
+              turn.landedUnconfirmed = delivery.landedUnconfirmed;
               outboundDedup.record(backstopChatId, backstopThreadId, capturedText, Date.now(), getCurrentTurn()?.registryKey ?? null);
               if (sentIds.length > 0) {
                 flushedTurnSupersede.record(backstopChatId, backstopThreadId, { turnId: turn.turnId, messageIds: sentIds, text: capturedText }, Date.now());
@@ -80058,12 +80151,14 @@ function isTurnFlushSafetyEnabled(env = process.env) {
 }
 
 // reply-owner-resolve.ts
-function latestEndedAccepted(candidates) {
+function latestEndedAccepted2(candidates) {
   if (candidates.latestEndedTurnId == null)
     return false;
   const age = candidates.latestEndedAgeMs;
   const ttl = candidates.latestEndedTtlMs;
-  if (age == null || ttl == null)
+  if (age === null)
+    return false;
+  if (age === undefined || ttl == null)
     return true;
   return age <= ttl;
 }
@@ -80074,7 +80169,7 @@ function resolveReplyOwnerTier(candidates) {
     return "origin";
   if (candidates.quotedTurnId != null)
     return "quoted";
-  if (latestEndedAccepted(candidates))
+  if (latestEndedAccepted2(candidates))
     return "latest-ended";
   return "none";
 }
@@ -83021,6 +83116,99 @@ function assertPositive(value, label) {
   }
 }
 
+// ../src/setup/host-capabilities.ts
+init_paths();
+
+// ../src/setup/hindsight-perf-defaults.ts
+var HINDSIGHT_RERANKER_MAX_CANDIDATES_FOR_DERIVATION = 150;
+var HINDSIGHT_DEFAULT_RECALL_MAX_CANDIDATES_PER_SOURCE = Math.ceil(HINDSIGHT_RERANKER_MAX_CANDIDATES_FOR_DERIVATION * 0.4);
+var HINDSIGHT_DEFAULT_LINK_EXPANSION_PER_ENTITY_LIMIT = 50;
+var HINDSIGHT_DEFAULT_LINK_EXPANSION_TIMEOUT_S = 2;
+var HINDSIGHT_DEFAULT_LLM_REASONING_EFFORT = "low";
+var HINDSIGHT_DEFAULT_LLM_MAX_CONCURRENT = 4;
+var HINDSIGHT_DEFAULT_RETAIN_LLM_MAX_CONCURRENT = 1;
+var HINDSIGHT_DEFAULT_CONSOLIDATION_LLM_MAX_CONCURRENT = 1;
+var HINDSIGHT_DEFAULT_RERANKER_LOCAL_FP16 = "true";
+var HINDSIGHT_DEFAULT_RERANKER_LOCAL_BATCH_SIZE = 128;
+var HINDSIGHT_DEFAULT_LLM_STRICT_SCHEMA = "true";
+var HINDSIGHT_DEFAULT_LLM_MAX_RETRIES = 2;
+var HINDSIGHT_DEFAULT_CONSOLIDATION_LLM_PARALLELISM = 2;
+var HINDSIGHT_PERF_DEFAULTS_UNGATED = [
+  [
+    "HINDSIGHT_API_RECALL_MAX_CANDIDATES_PER_SOURCE",
+    String(HINDSIGHT_DEFAULT_RECALL_MAX_CANDIDATES_PER_SOURCE)
+  ],
+  [
+    "HINDSIGHT_API_LINK_EXPANSION_PER_ENTITY_LIMIT",
+    String(HINDSIGHT_DEFAULT_LINK_EXPANSION_PER_ENTITY_LIMIT)
+  ],
+  [
+    "HINDSIGHT_API_LINK_EXPANSION_TIMEOUT",
+    String(HINDSIGHT_DEFAULT_LINK_EXPANSION_TIMEOUT_S)
+  ],
+  ["HINDSIGHT_API_LLM_REASONING_EFFORT", HINDSIGHT_DEFAULT_LLM_REASONING_EFFORT],
+  [
+    "HINDSIGHT_API_CONSOLIDATION_LLM_PARALLELISM",
+    String(HINDSIGHT_DEFAULT_CONSOLIDATION_LLM_PARALLELISM)
+  ]
+];
+var HINDSIGHT_PERF_DEFAULTS_GPU = [
+  ["HINDSIGHT_API_RERANKER_LOCAL_FP16", HINDSIGHT_DEFAULT_RERANKER_LOCAL_FP16],
+  [
+    "HINDSIGHT_API_RERANKER_LOCAL_BATCH_SIZE",
+    String(HINDSIGHT_DEFAULT_RERANKER_LOCAL_BATCH_SIZE)
+  ]
+];
+var HINDSIGHT_PERF_DEFAULTS_LOCAL_LLM = [
+  ["HINDSIGHT_API_LLM_MAX_CONCURRENT", String(HINDSIGHT_DEFAULT_LLM_MAX_CONCURRENT)],
+  [
+    "HINDSIGHT_API_RETAIN_LLM_MAX_CONCURRENT",
+    String(HINDSIGHT_DEFAULT_RETAIN_LLM_MAX_CONCURRENT)
+  ],
+  [
+    "HINDSIGHT_API_CONSOLIDATION_LLM_MAX_CONCURRENT",
+    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)]
+];
+var HINDSIGHT_PERF_OVERRIDE_ONLY_KEYS = new Set([
+  "HINDSIGHT_API_WORKER_CONSOLIDATION_BANK_PRIORITY"
+]);
+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
+]);
+
+// ../src/setup/hindsight-pg-defaults.ts
+var HINDSIGHT_PG_MEM_LIMIT_MIB_FOR_DERIVATION = 8 * 1024;
+var HINDSIGHT_PG_APP_ANON_MIB = 2560;
+var HINDSIGHT_PG_PAGE_CACHE_FLOOR_MIB = 2048;
+var HINDSIGHT_PG_SHARED_BUFFERS_BUDGET_MIB = HINDSIGHT_PG_MEM_LIMIT_MIB_FOR_DERIVATION - HINDSIGHT_PG_APP_ANON_MIB - HINDSIGHT_PG_PAGE_CACHE_FLOOR_MIB;
+var HINDSIGHT_PG_DEFAULT_SHARED_BUFFERS_MIB = 1536;
+var HINDSIGHT_PG_DEFAULT_EFFECTIVE_CACHE_SIZE_MIB = 4096;
+function pgMib(mib) {
+  return `${mib}MB`;
+}
+var HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE_ENV = "SWITCHROOM_HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE";
+var HINDSIGHT_PG_SHARED_BUFFERS_ENV = "SWITCHROOM_HINDSIGHT_PG_SHARED_BUFFERS";
+var HINDSIGHT_PG_DEFAULTS = [
+  [
+    HINDSIGHT_PG_EFFECTIVE_CACHE_SIZE_ENV,
+    pgMib(HINDSIGHT_PG_DEFAULT_EFFECTIVE_CACHE_SIZE_MIB)
+  ],
+  [HINDSIGHT_PG_SHARED_BUFFERS_ENV, pgMib(HINDSIGHT_PG_DEFAULT_SHARED_BUFFERS_MIB)]
+];
+var HINDSIGHT_PG_ENV_KEYS = new Set(HINDSIGHT_PG_DEFAULTS.map(([k]) => k));
+
+// ../src/setup/hindsight-context-budget.ts
+var HINDSIGHT_UPSTREAM_RETAIN_CHUNK_SIZE = 3000;
+var HINDSIGHT_RETAIN_MAX_COMPLETION_FLOOR = HINDSIGHT_UPSTREAM_RETAIN_CHUNK_SIZE + 72;
+
 // ../src/setup/hindsight.ts
 var HINDSIGHT_DEFAULT_API_PORT = 18888;
 var HINDSIGHT_DEFAULT_MCP_URL = `http://127.0.0.1:${HINDSIGHT_DEFAULT_API_PORT}/mcp/`;
@@ -87593,10 +87781,10 @@ function createCapturedResumeDispatcher(ports) {
       if (delivered) {
         ports.obligationLedger.close(o.originTurnId);
         ports.backstopDeliveryLedger.clear(o.originTurnId);
-        stderr(`telegram gateway: captured-answer resume delivered \u2014 origin=${o.originTurnId} ` + `${sentIds.length} chunk(s) confirmed; obligation closed
+        stderr(`telegram gateway: captured-answer resume delivered \u2014 origin=${o.originTurnId} ` + `${sentIds.length} message id(s) landed; obligation closed
 `);
       } else {
-        stderr(`telegram gateway: captured-answer resume partial \u2014 origin=${o.originTurnId} ` + `tail still not confirmed; left OPEN for retry
+        stderr(`telegram gateway: captured-answer resume partial \u2014 origin=${o.originTurnId} ` + `tail still not landed; left OPEN for retry
 `);
       }
     } catch (err) {
@@ -88467,8 +88655,29 @@ function resolveAnswerThreadId(input) {
   return input.liveThreadId;
 }
 
+// gateway/latest-turn-lookup.ts
+function latestTurnForChat(turns, chatId, opts) {
+  let latest = null;
+  for (const t of turns) {
+    if (t.sessionChatId !== chatId)
+      continue;
+    if (opts.endedOnly && t.endedAt == null)
+      continue;
+    latest = t;
+  }
+  return latest;
+}
+
 // gateway/turns-jsonl-rotate.ts
 var TURNS_JSONL_MAX_BYTES = 5 * 1024 * 1024;
+var DEFAULT_AGENT_STATE_DIR = "/state/agent";
+function resolveAgentStateDir(env = process.env) {
+  const dir = env.SWITCHROOM_AGENT_STATE_DIR?.trim();
+  return dir != null && dir !== "" ? dir.replace(/\/+$/, "") : DEFAULT_AGENT_STATE_DIR;
+}
+function resolveTurnsJsonlPath(env = process.env) {
+  return `${resolveAgentStateDir(env)}/turns.jsonl`;
+}
 function maybeRotate(path3, fs3, maxBytes = TURNS_JSONL_MAX_BYTES) {
   const size = fs3.statSize(path3);
   if (size == null || size < maxBytes)
@@ -88497,7 +88706,8 @@ function buildTurnRecord(turn, endedAt) {
     duration_ms: turn.startedAt > 0 ? endedAt - turn.startedAt : 0,
     tools: turn.toolCallCount ?? 0,
     status: computeTurnStatus(turn),
-    turn_id: turn.turnId
+    turn_id: turn.turnId,
+    ...turn.landedUnconfirmed != null && turn.landedUnconfirmed > 0 ? { landed_unconfirmed: turn.landedUnconfirmed } : {}
   };
 }
 
@@ -88679,8 +88889,16 @@ async function runBackstopDelivery(ledger, turnId, chunks, cardMessageId, deps,
       break;
   }
   const sentIds = ledger.sentIds(turnId);
-  const delivered = ledger.allConfirmed(turnId, chunkCount) && backstopReceiptIds(ledger.confirmedIds(turnId), cardMessageId).length > 0;
+  const confirmed = ledger.allConfirmed(turnId, chunkCount);
+  const allLanded = chunkCount > 0 && ledger.unsentIndices(turnId, chunkCount).length === 0;
+  const delivered = allLanded && backstopReceiptIds(sentIds, cardMessageId).length > 0;
   const exhausted = !delivered;
+  const confirmedSet = new Set(ledger.confirmedIds(turnId));
+  const landedUnconfirmedIds = sentIds.filter((id) => !confirmedSet.has(id));
+  if (delivered && !confirmed) {
+    stderr(`telegram gateway: backstop delivery landed-unconfirmed for turn ${turnId} \u2014 ` + `every chunk returned a fresh message id but the read-back probe was ` + `inconclusive for ${landedUnconfirmedIds.length} of ${sentIds.length} landed ` + `id(s); counting it delivered (an ambiguous probe is not a failure)
+`);
+  }
   if (deps.recordOutbound && sentIds.length > 0) {
     const texts = [];
     const ids = [];
@@ -88692,7 +88910,7 @@ async function runBackstopDelivery(ledger, turnId, chunks, cardMessageId, deps,
     }
     deps.recordOutbound(ids, texts);
   }
-  return { sentIds, chunkCount, delivered, attempts, exhausted };
+  return { sentIds, chunkCount, delivered, confirmed, landedUnconfirmedIds, attempts, exhausted };
 }
 
 // gateway/inbound-delivery-confirm.ts
@@ -96331,10 +96549,10 @@ function startOutboxSweep(deps) {
 }
 
 // ../src/build-info.ts
-var VERSION2 = "0.19.22";
-var COMMIT_SHA = "50ef9fb5";
-var COMMIT_DATE = "2026-07-26T06:22:32Z";
-var LATEST_PR = 3696;
+var VERSION2 = "0.19.24";
+var COMMIT_SHA = "0fa8ffb8";
+var COMMIT_DATE = "2026-07-27T05:19:34Z";
+var LATEST_PR = 3744;
 var COMMITS_AHEAD_OF_TAG = 0;
 
 // gateway/boot-version.ts
@@ -98194,7 +98412,7 @@ var STATE_DIR = process.env.TELEGRAM_STATE_DIR ?? join65(homedir19(), ".claude",
 var permCardStore = createPermissionCardStore(STATE_DIR);
 var BLOCKED_APPROVALS_DIR = process.env.SWITCHROOM_BLOCKED_APPROVALS_DIR ?? "/state/blocked-approvals";
 var AGENT_NAME = process.env.SWITCHROOM_AGENT_NAME ?? "agent";
-var blockedApprovalStore = createBlockedApprovalStore(BLOCKED_APPROVALS_DIR, AGENT_NAME, process.env.SWITCHROOM_AGENT_STATE_DIR ?? "/state/agent");
+var blockedApprovalStore = createBlockedApprovalStore(BLOCKED_APPROVALS_DIR, AGENT_NAME, resolveAgentStateDir());
 function reconcileBlockedApprovals() {
   const oldest = selectOldestHeld(pendingPermissions);
   if (oldest == null) {
@@ -98975,7 +99193,8 @@ async function deliverAnswer(args) {
     sentIds: result.sentIds,
     chunkCount: result.chunkCount,
     delivered: result.delivered,
-    exhausted: result.exhausted
+    exhausted: result.exhausted,
+    landedUnconfirmed: result.landedUnconfirmedIds.length
   };
 }
 var chatAvailableReactions = new Map;
@@ -99304,18 +99523,13 @@ function findTurnByOriginId(originTurnId) {
   return recentTurnsById.get(originTurnId) ?? null;
 }
 var LATE_REPLY_TOPIC_RECOVERY_ENABLED = process.env.SWITCHROOM_LATE_REPLY_TOPIC_RECOVERY !== "0";
-function findLatestEndedTurnForChat(chatId) {
-  let latest = null;
-  for (const t of recentTurnsById.values()) {
-    if (t.sessionChatId === chatId)
-      latest = t;
-  }
-  return latest;
+function findLatestTurnForChat(chatId, opts) {
+  return latestTurnForChat(recentTurnsById.values(), chatId, opts);
 }
 function resolveReplyOwnerTurn(liveTurn, chatId, args) {
   const origin = findTurnByOriginId(args.origin_turn_id);
   const quoted = findTurnByQuotedMessageId(chatId, args.reply_to);
-  const latestEnded = findLatestEndedTurnForChat(chatId);
+  const latestEnded = findLatestTurnForChat(chatId, { endedOnly: true });
   const byId = new Map;
   for (const t of [latestEnded, quoted, origin, liveTurn]) {
     if (t != null)
@@ -99332,10 +99546,10 @@ function resolveReplyOwnerTurn(liveTurn, chatId, args) {
   };
   const tier = resolveReplyOwnerTier(candidates);
   const winnerId = resolveReplyOwnerTurnId(candidates);
-  return { turn: winnerId != null ? byId.get(winnerId) ?? null : null, tier };
+  return { turn: winnerId != null ? byId.get(winnerId) ?? null : null, tier, candidates };
 }
 function resolveAnswerThreadWithLog(chatId, explicitThreadId, originTurn, originVia, liveTurn, surface) {
-  const recovered = LATE_REPLY_TOPIC_RECOVERY_ENABLED && explicitThreadId == null && originTurn == null && liveTurn == null ? findLatestEndedTurnForChat(chatId) : null;
+  const recovered = LATE_REPLY_TOPIC_RECOVERY_ENABLED && explicitThreadId == null && originTurn == null && liveTurn == null ? findLatestTurnForChat(chatId, { endedOnly: false }) : null;
   const threadId = resolveAnswerThreadId({
     explicitThreadId,
     originResolved: originTurn != null,
@@ -99802,7 +100016,7 @@ function snapshotContextOccupancy() {
     } catch {
       cap = null;
     }
-    const stateDir = process.env.SWITCHROOM_AGENT_STATE_DIR ?? "/state/agent";
+    const stateDir = resolveAgentStateDir();
     writeContextOccupancySnapshot(stateDir, buildContextOccupancy(occupancy, cap, Date.now()));
   } catch {}
 }
@@ -99814,10 +100028,11 @@ function emitTurnRecord(turn, endedAt) {
       toolCallCount: turn.toolCallCount ?? 0,
       turnId: turn.turnId,
       finalAnswerDelivered: turn.finalAnswerDelivered,
-      deliveryOutcome: turn.deliveryOutcome
+      deliveryOutcome: turn.deliveryOutcome,
+      landedUnconfirmed: turn.landedUnconfirmed
     }, endedAt)) + `
 `;
-    const turnsPath = "/state/agent/turns.jsonl";
+    const turnsPath = resolveTurnsJsonlPath();
     maybeRotate(turnsPath, {
       statSize: (p) => {
         try {