switchroom 0.20.0 → 0.20.2

package/dist/buzz-gateway/index.js

@@ -1,5 +1,5 @@
 // src/buzz-gateway/index.ts
-import { join as join2 } from "node:path";
+import { join as join3 } from "node:path";
 
 // node_modules/.bun/@noble+hashes@2.0.1/node_modules/@noble/hashes/utils.js
 /*! noble-hashes - MIT License (c) 2022 Paul Miller (paulmillr.com) */
@@ -8874,6 +8874,20 @@ async function publishOutbound(req, secretKey, transport, nowSec) {
   }
   return { ok: true, eventId: signed.eventId };
 }
+async function publishOutboundTallied(req, secretKey, transport, tally, nowSec) {
+  let result;
+  try {
+    result = await publishOutbound(req, secretKey, transport, nowSec);
+  } catch {
+    tally.failed += 1;
+    return { ok: false, error: "publish failed: transport threw" };
+  }
+  if (result.ok)
+    tally.ok += 1;
+  else
+    tally.failed += 1;
+  return result;
+}
 
 // src/buzz-gateway/inbound-map.ts
 var BUZZ_MESSAGE_KIND = 9;
@@ -8898,6 +8912,22 @@ function resolveThreadRoot(ev) {
     return eTags[0][1];
   return ev.id;
 }
+function resolveReplyParent(ev) {
+  const eTags = ev.tags.filter((t) => t[0] === "e" && typeof t[1] === "string");
+  if (eTags.length === 0)
+    return;
+  const hasMarkers = eTags.some((t) => t[3] === "root" || t[3] === "reply" || t[3] === "mention");
+  if (hasMarkers) {
+    const reply = eTags.find((t) => t[3] === "reply");
+    if (reply)
+      return reply[1];
+    const root = eTags.find((t) => t[3] === "root");
+    if (root)
+      return root[1];
+    return;
+  }
+  return eTags[eTags.length - 1][1];
+}
 function resolveChannelId(ev, fallback) {
   const h = ev.tags.find((t) => t[0] === "h" && typeof t[1] === "string");
   return h ? h[1] : fallback;
@@ -8907,14 +8937,16 @@ function mapBuzzEvent(ev, ctx) {
     return null;
   const channelId = resolveChannelId(ev, ctx.groupId);
   const threadRoot = resolveThreadRoot(ev);
+  const replyTo = resolveReplyParent(ev);
   const user = senderLabel(ev.pubkey, ctx.pubkeyNames);
-  const text = `<channel source="buzz" ` + `buzz_channel_id="${escapeAttr(channelId)}" ` + `buzz_event_id="${escapeAttr(ev.id)}" ` + `buzz_pubkey="${escapeAttr(ev.pubkey)}" ` + `buzz_thread_root="${escapeAttr(threadRoot)}" ` + `user="${escapeAttr(user)}">` + escapeBody(ev.content) + `</channel>`;
+  const text = `<channel source="buzz" ` + `buzz_channel_id="${escapeAttr(channelId)}" ` + `buzz_event_id="${escapeAttr(ev.id)}" ` + `buzz_pubkey="${escapeAttr(ev.pubkey)}" ` + `buzz_thread_root="${escapeAttr(threadRoot)}" ` + (replyTo !== undefined ? `buzz_reply_to="${escapeAttr(replyTo)}" ` : "") + `user="${escapeAttr(user)}">` + escapeBody(ev.content) + `</channel>`;
   const meta = {
     source: "buzz",
     buzz_channel_id: channelId,
     buzz_event_id: ev.id,
     buzz_pubkey: ev.pubkey,
     buzz_thread_root: threadRoot,
+    ...replyTo !== undefined ? { buzz_reply_to: replyTo } : {},
     user
   };
   return {
@@ -9052,6 +9084,110 @@ function createRetryQueue(deps) {
   };
 }
 
+// src/buzz-gateway/heartbeat.ts
+import {
+  mkdirSync as realMkdirSync,
+  writeFileSync as realWriteFileSync
+} from "node:fs";
+import { dirname as dirname2, join as join2 } from "node:path";
+var BUZZ_HEARTBEAT_SUBDIR = "buzz";
+var BUZZ_HEARTBEAT_FILE = "buzz-sidecar.heartbeat.json";
+var BUZZ_HEARTBEAT_INTERVAL_MS = 60 * 1000;
+var BUZZ_HEARTBEAT_STALE_MULTIPLIER = 3;
+var BUZZ_HEARTBEAT_STALE_MS = BUZZ_HEARTBEAT_INTERVAL_MS * BUZZ_HEARTBEAT_STALE_MULTIPLIER;
+var BUZZ_HEARTBEAT_MAX_INTERVAL_MS = BUZZ_HEARTBEAT_STALE_MS / BUZZ_HEARTBEAT_STALE_MULTIPLIER;
+function resolveStatsIntervalMs(raw) {
+  const requested = Number(raw);
+  if (!Number.isFinite(requested) || requested <= 0) {
+    return BUZZ_HEARTBEAT_INTERVAL_MS;
+  }
+  return Math.min(requested, BUZZ_HEARTBEAT_MAX_INTERVAL_MS);
+}
+function buzzHeartbeatStatePath(stateDir) {
+  return join2(stateDir, BUZZ_HEARTBEAT_SUBDIR, BUZZ_HEARTBEAT_FILE);
+}
+function writeBuzzHeartbeat(path, hb, io = {}) {
+  const mkdir = io.mkdirSync ?? realMkdirSync;
+  const write = io.writeFileSync ?? realWriteFileSync;
+  mkdir(dirname2(path), { recursive: true });
+  write(path, JSON.stringify(hb));
+}
+
+// src/buzz-gateway/stats.ts
+var REJECT_PREFIX = "rejected:";
+function summarizePipeline(pumpStats, mirror) {
+  let received = 0;
+  let authFailures = 0;
+  for (const [key, count] of Object.entries(pumpStats)) {
+    received += count;
+    if (key.startsWith(REJECT_PREFIX))
+      authFailures += count;
+  }
+  return {
+    received,
+    injected: pumpStats.injected ?? 0,
+    duplicate: pumpStats.duplicate ?? 0,
+    queued: pumpStats.queued ?? 0,
+    injectFailed: pumpStats.inject_failed ?? 0,
+    droppedByKind: pumpStats.unmapped ?? 0,
+    channelOff: pumpStats.channel_off ?? 0,
+    authFailures,
+    mirrorOk: mirror.ok,
+    mirrorFailed: mirror.failed
+  };
+}
+function formatStatsLine(s) {
+  return `buzz stats: received=${s.received} injected=${s.injected} ` + `duplicate=${s.duplicate} queued=${s.queued} inject_failed=${s.injectFailed} ` + `dropped_by_kind=${s.droppedByKind} channel_off=${s.channelOff} ` + `auth_failures=${s.authFailures} mirror_ok=${s.mirrorOk} mirror_failed=${s.mirrorFailed}`;
+}
+function createStatsReporter(deps) {
+  const intervalMs = deps.intervalMs && deps.intervalMs > 0 ? deps.intervalMs : 60000;
+  const setTimer = deps.setTimer ?? ((fn, ms) => setTimeout(fn, ms));
+  const clearTimer = deps.clearTimer ?? ((t) => clearTimeout(t));
+  let timer = null;
+  let stopped = false;
+  let lastLine = null;
+  function tick() {
+    const sample = deps.sample();
+    const line = formatStatsLine(sample.summary);
+    if (line !== lastLine) {
+      deps.emit(line);
+      lastLine = line;
+    }
+    try {
+      deps.persist?.(sample);
+    } catch {}
+  }
+  function schedule() {
+    if (stopped)
+      return;
+    timer = setTimer(() => {
+      timer = null;
+      if (stopped)
+        return;
+      tick();
+      schedule();
+    }, intervalMs);
+    if (timer && typeof timer.unref === "function") {
+      timer.unref();
+    }
+  }
+  return {
+    start() {
+      stopped = false;
+      tick();
+      schedule();
+    },
+    stop() {
+      stopped = true;
+      if (timer !== null) {
+        clearTimer(timer);
+        timer = null;
+      }
+    },
+    tick
+  };
+}
+
 // src/buzz-gateway/index.ts
 function log(msg) {
   process.stderr.write(`buzz-gateway: ${msg}
@@ -9123,8 +9259,8 @@ async function main() {
   const agentPubkey = getPublicKey(secretKey).toLowerCase();
   log(`booted agent=${config.agentName} relay=${config.relayUrl} group=${config.groupId} allowlist=${config.authorized.size}`);
   const stateDir = process.env.TELEGRAM_STATE_DIR ?? "/state/agent/telegram";
-  const socketPath = process.env.SWITCHROOM_GATEWAY_SOCKET ?? join2(stateDir, "gateway.sock");
-  const journalPath = process.env.BUZZ_JOURNAL_PATH ?? join2(stateDir, "buzz", "journal.jsonl");
+  const socketPath = process.env.SWITCHROOM_GATEWAY_SOCKET ?? join3(stateDir, "gateway.sock");
+  const journalPath = process.env.BUZZ_JOURNAL_PATH ?? join3(stateDir, "buzz", "journal.jsonl");
   const dedup = createDedupStore({ journalPath, log });
   const ipcClient = createInjectIpcClient({ socketPath, log });
   const inject = makeInject(ipcClient, config.agentName);
@@ -9158,16 +9294,17 @@ async function main() {
     log
   });
   const publishTransport = (event, timeoutMs) => nostr.publish(event, timeoutMs);
+  const mirror = { ok: 0, failed: 0 };
   const buzzPeer = createBuzzPeerClient({
     socketPath,
     agentName: config.agentName,
     onOutbound: async (req) => {
-      const result = await publishOutbound({
+      const result = await publishOutboundTallied({
         channelId: req.channelId,
         replyToEventId: req.replyToEventId,
         threadRootId: req.threadRootId,
         payload: req.payload
-      }, secretKey, publishTransport);
+      }, secretKey, publishTransport, mirror);
       return {
         type: "buzz_publish_result",
         correlationId: req.correlationId,
@@ -9178,8 +9315,30 @@ async function main() {
     },
     log
   });
+  const bootTs = Date.now();
+  const heartbeatPath = buzzHeartbeatStatePath(stateDir);
+  const statsIntervalMs = resolveStatsIntervalMs(process.env.BUZZ_STATS_INTERVAL_MS);
+  const statsReporter = createStatsReporter({
+    intervalMs: statsIntervalMs,
+    sample: () => ({
+      summary: summarizePipeline(pump.stats, mirror),
+      subscribed: nostr.isSubscribed()
+    }),
+    emit: (line) => log(line),
+    persist: (sample) => writeBuzzHeartbeat(heartbeatPath, {
+      v: 1,
+      agent: config.agentName,
+      ts: Date.now(),
+      bootTs,
+      subscribed: sample.subscribed,
+      stats: sample.summary
+    })
+  });
   const shutdown = () => {
     log("shutting down");
+    try {
+      statsReporter.stop();
+    } catch {}
     try {
       nostr.stop();
     } catch {}
@@ -9200,6 +9359,7 @@ async function main() {
   process.on("SIGTERM", shutdown);
   process.on("SIGINT", shutdown);
   nostr.start();
+  statsReporter.start();
 }
 main().catch((err) => {
   log(`FATAL: ${err.message}`);

package/dist/cli/notion-write-pretool.mjs

@@ -12123,7 +12123,7 @@ var BuzzChannelSchema = exports_external.object({
   default_channel_id: exports_external.string().describe("Relay-minted group UUID (the NIP-29 `h` tag) the sidecar subscribes " + "to and stamps on injected turns."),
   channel_map: exports_external.record(exports_external.string(), exports_external.string()).default({}).describe("Optional map of extra group UUIDs \u2192 friendly labels."),
   pubkey_names: exports_external.record(exports_external.string(), exports_external.string()).default({}).describe("Optional petnames: hex/npub pubkey \u2192 display name, used to label " + "the sender on injected turns."),
-  pinned_relay_digest: exports_external.string().optional().describe("Pinned relay image digest (M4). The compat-check warns on mismatch; " + "advisory in Phase 1.")
+  pinned_relay_digest: exports_external.string().optional().describe("Pinned relay image digest (M4). RESERVED \u2014 no consumer of this field " + "exists; the existing compat-check (compat-check.ts) validates only " + "the wire contract (AUTH kind, message kind, tag names) and does not " + "read this field. Kept in the schema so the intended digest-pin can " + "be wired without a config shape change.")
 }).strict();
 var ChannelsSchema = exports_external.object({
   telegram: TelegramChannelSchema,
@@ -12180,7 +12180,7 @@ var HindsightConfigSchema = exports_external.object({
     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."),
-  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 \u2014 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 \u2014 a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks; and " + "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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; and " + "HINDSIGHT_API_CONSOLIDATION_RECALL_MAX_CONCURRENT \u2014 the background " + "half of switchroom's recall-admission split (#3660): of the " + "RECALL_MAX_CONCURRENT admission slots, at most this many may be held " + "by background consolidation recalls at once, so foreground per-turn " + "recall always keeps the remainder; must be >= 1 and strictly less " + "than RECALL_MAX_CONCURRENT or the engine refuses to boot; unset " + "means the image's derived default min(2, RECALL_MAX_CONCURRENT - 1); " + "1 biases hard toward the interactive lane while a consolidation " + "backlog drains; and " + "HINDSIGHT_MM_REFRESH_MIN_INTERVAL_S \u2014 the rollback/tuning knob for " + "switchroom's MM-refresh-debounce image patch: the minimum seconds " + "between consolidation-triggered refreshes of one mental model; unset " + "means the image's baked 3600, 0 restores upstream's " + "refresh-every-round behaviour; explicit and cron-scheduled refreshes " + "are never debounced), 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).")
+  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 \u2014 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 \u2014 a per-deployment " + "`bank-pattern:priority,...` map; unset means upstream's flat " + "created_at FIFO across banks; and " + "HINDSIGHT_CE_DECISIVE_RELATIVE_GAP \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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; and " + "HINDSIGHT_API_CONSOLIDATION_RECALL_MAX_CONCURRENT \u2014 the background " + "half of switchroom's recall-admission split (#3660): of the " + "RECALL_MAX_CONCURRENT admission slots, at most this many may be held " + "by background consolidation recalls at once, so foreground per-turn " + "recall always keeps the remainder; must be >= 1 and strictly less " + "than RECALL_MAX_CONCURRENT or the engine refuses to boot; unset " + "means the image's derived default min(2, RECALL_MAX_CONCURRENT - 1); " + "1 biases hard toward the interactive lane while a consolidation " + "backlog drains; and " + "HINDSIGHT_MM_REFRESH_MIN_INTERVAL_S \u2014 the rollback/tuning knob for " + "switchroom's MM-refresh-debounce image patch: the minimum seconds " + "between consolidation-triggered refreshes of one mental model; unset " + "means the image's baked 3600, 0 restores upstream's " + "refresh-every-round behaviour; explicit and cron-scheduled refreshes " + "are never debounced; and " + "HINDSIGHT_API_TEMPORAL_LANGUAGES \u2014 the language set dateparser is " + "restricted to during temporal query analysis, made live by switchroom's " + "temporal-language image patch (which ended a 200+-locale auto-detection " + "pass that blocked the shared asyncio loop on every recall); " + "comma-separated, unset means the image's baked `en`, set e.g. `en,es` to " + "restore i18n parsing), 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).")
 });
 var 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)."),