switchroom 0.18.3 → 0.18.6

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

@@ -12658,6 +12658,445 @@ var init_demo_mask = __esm(() => {
   vaultKeyCache = new Map;
 });
 
+// auth-snapshot-format.ts
+function classifyHealth(snap, now = new Date) {
+  if (!snap.quota)
+    return "unknown";
+  const q = snap.quota;
+  if (isProbeThin(q))
+    return "unknown";
+  const norm = refillNormalizedUtils(q, now);
+  const max = Math.max(norm.fiveHourUtilizationPct, norm.sevenDayUtilizationPct);
+  if (max >= 99.5)
+    return "blocked";
+  if (max >= THROTTLING_THRESHOLD_PCT)
+    return "throttling";
+  return "healthy";
+}
+function blockedReason(snap, now = new Date) {
+  if (classifyHealth(snap, now) !== "blocked")
+    return null;
+  return "quota-exhausted";
+}
+function bindingWindow(q) {
+  if (q.representativeClaim === "seven_day")
+    return "7d";
+  if (q.representativeClaim === "five_hour")
+    return "5h";
+  return q.sevenDayUtilizationPct >= q.fiveHourUtilizationPct ? "7d" : "5h";
+}
+function formatRelative(target, now = new Date) {
+  if (!target)
+    return "\u2014";
+  const deltaMs = target.getTime() - now.getTime();
+  if (deltaMs <= 0)
+    return "now";
+  const totalMin = Math.round(deltaMs / 60000);
+  if (totalMin < 60)
+    return `${totalMin}m`;
+  const h = Math.floor(totalMin / 60);
+  const m = totalMin % 60;
+  if (h < 24)
+    return m > 0 ? `${h}h ${m}m` : `${h}h`;
+  const d = Math.floor(h / 24);
+  const rh = h % 24;
+  return rh > 0 ? `${d}d ${rh}h` : `${d}d`;
+}
+function formatAbsolute(target, tz = "UTC") {
+  if (!target)
+    return "\u2014";
+  return target.toLocaleString("en-US", {
+    timeZone: tz,
+    weekday: "short",
+    hour: "numeric",
+    minute: "2-digit",
+    hour12: true
+  });
+}
+function formatStatusTime(target, now = new Date, tz = "UTC") {
+  if (!target)
+    return "\u2014";
+  const dayFmt = new Intl.DateTimeFormat("en-CA", {
+    timeZone: tz,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
+  });
+  const timeFmt = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    hour: "numeric",
+    minute: "2-digit",
+    hour12: true
+  });
+  const timeStr = timeFmt.format(target);
+  if (dayFmt.format(target) === dayFmt.format(now)) {
+    return timeStr;
+  }
+  const withinWeek = target.getTime() - now.getTime() < 7 * 24 * 60 * 60 * 1000;
+  const dateFmt = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    weekday: "short",
+    ...withinWeek ? {} : { day: "numeric", month: "short" }
+  });
+  return `${dateFmt.format(target)} ${timeStr}`;
+}
+function fmtPct(pct) {
+  return `${Math.min(100, Math.round(pct))}%`;
+}
+function displayLabel(label, opts) {
+  return opts.demo ? maskEmail(label) : label;
+}
+function renderAccountRow(snap, opts) {
+  const now = opts.now ?? new Date;
+  const tz = opts.tz ?? "UTC";
+  const lines = [];
+  const marker = snap.isActive ? "\u25cf " : "";
+  const label = displayLabel(snap.label, opts);
+  if (!snap.quota) {
+    lines.push(`${marker}\`${codeSpanSafe(label)}\`  _quota probe failed_`);
+    if (snap.quotaError) {
+      lines.push(`  _${escapeMarkdown(snap.quotaError)}_`);
+    }
+    return lines;
+  }
+  const q = snap.quota;
+  if (isProbeThin(q)) {
+    lines.push(`${marker}\`${codeSpanSafe(label)}\`  _quota unknown (thin probe)_`);
+    return lines;
+  }
+  const norm = refillNormalizedUtils(q, now);
+  const fiveStr = fmtPct(norm.fiveHourUtilizationPct);
+  const sevenStr = fmtPct(norm.sevenDayUtilizationPct);
+  lines.push(`${marker}\`${codeSpanSafe(label)}\`  ${fiveStr} / ${sevenStr}`);
+  const health = classifyHealth(snap, now);
+  if (health === "blocked") {
+    const win = bindingWindow(q);
+    const reset2 = win === "5h" ? q.fiveHourResetAt : q.sevenDayResetAt;
+    const winLabel = win === "5h" ? "5-hour" : "7-day";
+    lines.push(reset2 ? `  _quota exhausted \u2014 back ${formatAbsolute(reset2, tz)} (\`in ${formatRelative(reset2, now)}\`, ${winLabel} cap)_` : `  _quota exhausted \u2014 ${winLabel} cap, reset time unknown_`);
+    return lines;
+  }
+  const fiveResetIn = q.fiveHourResetAt ? q.fiveHourResetAt.getTime() - now.getTime() : Infinity;
+  const sevenResetIn = q.sevenDayResetAt ? q.sevenDayResetAt.getTime() - now.getTime() : Infinity;
+  const fiveFirst = fiveResetIn <= sevenResetIn;
+  const fiveSeg = q.fiveHourResetAt ? `5h refills ${formatAbsolute(q.fiveHourResetAt, tz)} (\`in ${formatRelative(q.fiveHourResetAt, now)}\`)` : "5h refills \u2014";
+  const sevenSeg = q.sevenDayResetAt ? `7d resets ${formatAbsolute(q.sevenDayResetAt, tz)} (\`in ${formatRelative(q.sevenDayResetAt, now)}\`)` : "7d resets \u2014";
+  lines.push(`  _${fiveFirst ? fiveSeg : sevenSeg}_`);
+  lines.push(`  _${fiveFirst ? sevenSeg : fiveSeg}_`);
+  if (q.overageDisabledReason != null && OVERAGE_EXHAUSTED_REASONS.has(q.overageDisabledReason)) {
+    lines.push(`  _overage off (${escapeMarkdown(q.overageDisabledReason)}) \u2014 serving from quota_`);
+  }
+  return lines;
+}
+function formatAgeStamp(atMs, now = new Date) {
+  const ageSec = Math.max(0, Math.round((now.getTime() - atMs) / 1000));
+  return ageSec < 60 ? `${ageSec}s ago` : `${Math.round(ageSec / 60)}m ago`;
+}
+function tableCell(s) {
+  return s.replace(/\\/g, "\\\\").replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+}
+function pctCells(snap, now) {
+  if (!snap.quota)
+    return { five: "\u2014", seven: "\u2014" };
+  if (isProbeThin(snap.quota))
+    return { five: "?", seven: "?" };
+  const norm = refillNormalizedUtils(snap.quota, now);
+  return { five: fmtPct(norm.fiveHourUtilizationPct), seven: fmtPct(norm.sevenDayUtilizationPct) };
+}
+function windowResetCell(snap, now, tz, win) {
+  if (!snap.quota) {
+    return snap.quotaError ? `probe failed (${snap.quotaError})` : "\u2014";
+  }
+  if (isProbeThin(snap.quota))
+    return "quota unknown";
+  const reset2 = win === "5h" ? snap.quota.fiveHourResetAt : snap.quota.sevenDayResetAt;
+  if (!reset2)
+    return "\u2014";
+  return `${formatStatusTime(reset2, now, tz)} (in ${formatRelative(reset2, now)})`;
+}
+function renderAuthSnapshotFormat2(snapshots, opts = {}) {
+  const now = opts.now ?? new Date;
+  const tz = opts.tz ?? "UTC";
+  const lines = [];
+  lines.push("\uD83D\uDD0B **Auth \u2014 fleet status**");
+  const ordered = [...snapshots].sort((a, b) => {
+    if (a.isActive !== b.isActive)
+      return a.isActive ? -1 : 1;
+    const r = TABLE_HEALTH_RANK[classifyHealth(a, now)] - TABLE_HEALTH_RANK[classifyHealth(b, now)];
+    if (r !== 0)
+      return r;
+    return a.label.localeCompare(b.label);
+  });
+  if (ordered.length > 0) {
+    lines.push("");
+    lines.push("| State | Account | 5h | 5h resets | 7d | 7d resets |");
+    lines.push("| --- | --- | --- | --- | --- | --- |");
+    for (const s of ordered) {
+      const emoji = HEALTH_EMOJI[classifyHealth(s, now)];
+      const label = displayLabel(s.label, opts);
+      const accountCell = `\`${codeSpanSafe(s.isActive ? `${label} (active)` : label)}\``;
+      const { five, seven } = pctCells(s, now);
+      const fiveReset = windowResetCell(s, now, tz, "5h");
+      const sevenReset = windowResetCell(s, now, tz, "7d");
+      lines.push(`| ${emoji} | ${tableCell(accountCell)} | ${five} | ${tableCell(fiveReset)} | ${seven} | ${tableCell(sevenReset)} |`);
+    }
+  }
+  lines.push("");
+  lines.push(`_${recommendation(snapshots, now, opts.demo ?? false)}_`);
+  if (opts.staleCachedAtMs != null) {
+    lines.push(`_\u26a0 cached ${formatAgeStamp(opts.staleCachedAtMs, now)}_`);
+  } else if (opts.liveProbedAtMs != null) {
+    lines.push(`_Live \u00b7 refreshed ${formatAgeStamp(opts.liveProbedAtMs, now)}_`);
+  } else if (opts.probeFailed) {
+    lines.push("_\u26a0 probe failed \u2014 no live data_");
+  } else {
+    lines.push("_Live_");
+  }
+  return lines.join(`
+`);
+}
+function recommendation(snapshots, now = new Date, demo = false) {
+  const active = snapshots.find((s) => s.isActive);
+  if (!active)
+    return "No active account set.";
+  const activeHealth = classifyHealth(active, now);
+  const others = snapshots.filter((s) => !s.isActive);
+  const healthyAlt = others.find((s) => classifyHealth(s, now) === "healthy");
+  const lbl = (s) => demo ? maskEmail(s.label) : s.label;
+  const activeLabel = lbl(active);
+  if (activeHealth === "healthy") {
+    return `Recommendation: stay on ${activeLabel}.`;
+  }
+  if (activeHealth === "throttling") {
+    if (healthyAlt) {
+      return `Recommendation: active ${activeLabel} is throttling. Switch to ${lbl(healthyAlt)} for headroom.`;
+    }
+    return `Recommendation: active ${activeLabel} is throttling; no healthy alternative \u2014 wait for refill.`;
+  }
+  if (activeHealth === "blocked") {
+    if (healthyAlt) {
+      return `Recommendation: active ${activeLabel} is BLOCKED \u2014 switch to ${lbl(healthyAlt)} now.`;
+    }
+    return summarizeNoHealthyAlt(snapshots, now, demo);
+  }
+  return `Active ${activeLabel}: quota probe failed; broker last_seen unknown.`;
+}
+function summarizeNoHealthyAlt(snapshots, now, demo = false) {
+  const mask = (label) => demo ? maskEmail(label) : label;
+  let throttlingLabel = null;
+  let allTrulyBlocked = true;
+  for (const s of snapshots) {
+    const h = classifyHealth(s, now);
+    if (h === "throttling") {
+      if (!throttlingLabel)
+        throttlingLabel = s.label;
+      allTrulyBlocked = false;
+    } else if (h === "healthy" || h === "unknown") {
+      allTrulyBlocked = false;
+    } else if (h === "blocked" && blockedReason(s, now) === "quota-exhausted") {
+      if (s.quota) {
+        const win = bindingWindow(s.quota);
+        const at = win === "5h" ? s.quota.fiveHourResetAt : s.quota.sevenDayResetAt;
+        if (at && at.getTime() > now.getTime())
+          allTrulyBlocked = false;
+      }
+    }
+  }
+  const earliestRecovery = pickEarliestRecovery(snapshots, now);
+  if (throttlingLabel) {
+    const eta = earliestRecovery ? ` Soonest full refill: ${mask(earliestRecovery.label)} in ${formatRelative(earliestRecovery.at, now)}.` : "";
+    return `No fully-healthy account; ${mask(throttlingLabel)} is throttling but still usable.${eta}`;
+  }
+  if (!allTrulyBlocked) {
+    if (earliestRecovery) {
+      return `All accounts at capacity; soonest refill: ${mask(earliestRecovery.label)} in ${formatRelative(earliestRecovery.at, now)}.`;
+    }
+    return `All accounts at capacity \u2014 waiting on a window refill.`;
+  }
+  if (earliestRecovery) {
+    return `All accounts blocked. Earliest recovery: ${mask(earliestRecovery.label)} in ${formatRelative(earliestRecovery.at, now)}.`;
+  }
+  return `All accounts blocked. Run /auth add to attach another subscription.`;
+}
+function pickEarliestRecovery(snapshots, now) {
+  let best = null;
+  for (const s of snapshots) {
+    if (!s.quota)
+      continue;
+    if (isProbeThin(s.quota))
+      continue;
+    const win = bindingWindow(s.quota);
+    const at = win === "5h" ? s.quota.fiveHourResetAt : s.quota.sevenDayResetAt;
+    if (!at || at.getTime() <= now.getTime())
+      continue;
+    if (!best || at.getTime() < best.at.getTime()) {
+      best = { label: s.label, at };
+    }
+  }
+  return best;
+}
+function renderFallbackAnnouncement(input) {
+  const now = input.now ?? new Date;
+  const tz = input.tz ?? "UTC";
+  const lines = [];
+  const limitWord = input.oldQuota ? limitWordFor(input.oldQuota) : "quota";
+  const headerLimit = limitWord === "quota" ? "quota cap" : `${limitWord} limit`;
+  if (!input.newLabel) {
+    lines.push(`\uD83D\uDD34 **All accounts blocked \u00b7 ${headerLimit} on ${escapeMarkdown(input.oldLabel)}**`);
+    lines.push("");
+    lines.push(`Triggered by: agent **${escapeMarkdown(input.triggerAgent)}**`);
+    const fleet = input.fleetSnapshots ?? [];
+    if (fleet.length > 0) {
+      lines.push("");
+      const rowOpts = { now, tz };
+      const healthOrder = ["blocked", "throttling", "healthy", "unknown"];
+      const rank = (s) => healthOrder.indexOf(classifyHealth(s, now));
+      const ordered = [...fleet].sort((a, b) => rank(a) - rank(b) || Number(b.isActive) - Number(a.isActive));
+      for (const snap of ordered) {
+        for (const ln of renderAccountRow(snap, rowOpts))
+          lines.push(ln);
+      }
+      const earliest = pickEarliestRecovery(fleet, now);
+      if (earliest) {
+        lines.push("");
+        lines.push(`Earliest recovery: \`${codeSpanSafe(earliest.label)}\` ` + `${formatAbsolute(earliest.at, tz)} (in ${formatRelative(earliest.at, now)})`);
+      }
+    } else if (input.oldQuota) {
+      const recovery = recoveryAtFor(input.oldQuota);
+      if (recovery) {
+        lines.push(`${escapeMarkdown(input.oldLabel)} recovers ${formatAbsolute(recovery, tz)} ` + `(in ${formatRelative(recovery, now)})`);
+      }
+    }
+    lines.push("");
+    lines.push(`Run \`/auth add <label>\` to attach another subscription, ` + `or \`/auth refresh\` to re-probe.`);
+    return lines.join(`
+`);
+  }
+  lines.push(`\u2713 **Switched fleet \u00b7 ${headerLimit} on ${escapeMarkdown(input.oldLabel)}**`);
+  lines.push("");
+  lines.push(`\`${codeSpanSafe(input.oldLabel)}\` \u2192 \`${codeSpanSafe(input.newLabel)}\``);
+  lines.push(`Triggered by: agent **${escapeMarkdown(input.triggerAgent)}**`);
+  lines.push("");
+  if (input.oldQuota) {
+    const recovery = recoveryAtFor(input.oldQuota);
+    if (recovery) {
+      lines.push(`\`${codeSpanSafe(input.oldLabel)}\` recovers ` + `${formatAbsolute(recovery, tz)} (in ${formatRelative(recovery, now)})`);
+    }
+  }
+  if (input.newQuota) {
+    const fiveStr = fmtPct(input.newQuota.fiveHourUtilizationPct);
+    const sevenStr = fmtPct(input.newQuota.sevenDayUtilizationPct);
+    const hasHeadroom = input.newQuota.fiveHourUtilizationPct < THROTTLING_THRESHOLD_PCT && input.newQuota.sevenDayUtilizationPct < THROTTLING_THRESHOLD_PCT;
+    const headroomStr = hasHeadroom ? "_(plenty of headroom)_" : "_(near limit \u2014 watch this)_";
+    lines.push(`\`${codeSpanSafe(input.newLabel)}\` now: ${fiveStr} of 5h \u00b7 ${sevenStr} of 7d ${headroomStr}`);
+  } else {
+    lines.push(`_(quota probe for new account is pending \u2014 will reflect on next /auth)_`);
+  }
+  return lines.join(`
+`);
+}
+function limitWordFor(q) {
+  if (q.representativeClaim === "seven_day" && q.sevenDayUtilizationPct >= 99)
+    return "7-day";
+  if (q.representativeClaim === "five_hour" && q.fiveHourUtilizationPct >= 99)
+    return "5-hour";
+  if (q.sevenDayUtilizationPct >= 99)
+    return "7-day";
+  if (q.fiveHourUtilizationPct >= 99)
+    return "5-hour";
+  return q.sevenDayUtilizationPct >= q.fiveHourUtilizationPct ? "7-day" : "5-hour";
+}
+function recoveryAtFor(q) {
+  const word = limitWordFor(q);
+  if (word === "7-day")
+    return q.sevenDayResetAt;
+  if (word === "5-hour")
+    return q.fiveHourResetAt;
+  if (!q.fiveHourResetAt)
+    return q.sevenDayResetAt;
+  if (!q.sevenDayResetAt)
+    return q.fiveHourResetAt;
+  return q.fiveHourResetAt.getTime() < q.sevenDayResetAt.getTime() ? q.fiveHourResetAt : q.sevenDayResetAt;
+}
+function buildSnapshotKeyboard(snapshots, opts = {}) {
+  const max = opts.maxSwitchButtons ?? 3;
+  const now = opts.now ?? new Date;
+  const rows = [];
+  const switchTargets = snapshots.filter((s) => !s.isActive).sort((a, b) => switchPriority(a, now) - switchPriority(b, now)).filter((s) => classifyHealth(s, now) !== "blocked" && classifyHealth(s, now) !== "unknown").slice(0, max);
+  for (const t of switchTargets) {
+    rows.push([
+      {
+        text: `Switch fleet \u2192 ${opts.demo ? maskEmail(t.label) : t.label}`,
+        callbackData: `auth:use:${t.label}`
+      }
+    ]);
+  }
+  rows.push([
+    { text: "\u21bb Refresh", callbackData: opts.demo ? "auth:refresh:demo" : "auth:refresh" },
+    { text: "/usage", insertText: "/usage" },
+    { text: "+ Add", insertText: "/auth add " }
+  ]);
+  return rows;
+}
+function switchPriority(s, now = new Date) {
+  const h = classifyHealth(s, now);
+  if (h === "healthy")
+    return 0;
+  if (h === "throttling")
+    return 1;
+  if (h === "unknown")
+    return 2;
+  return 3;
+}
+function buildSnapshotsFromState(state3, quotas) {
+  const out = [];
+  for (let i = 0;i < state3.accounts.length; i++) {
+    const acc = state3.accounts[i];
+    const q = quotas[i];
+    out.push({
+      label: acc.label,
+      isActive: acc.label === state3.active,
+      quota: q && q.ok ? q.data : null,
+      quotaError: q && !q.ok ? q.reason : undefined,
+      expiresAtMs: acc.expiresAt
+    });
+  }
+  return out;
+}
+function reviveLastQuota(snap) {
+  if (!snap)
+    return null;
+  return {
+    fiveHourUtilizationPct: snap.fiveHourUtilizationPct,
+    sevenDayUtilizationPct: snap.sevenDayUtilizationPct,
+    fiveHourResetAt: snap.fiveHourResetAt ? new Date(snap.fiveHourResetAt) : null,
+    sevenDayResetAt: snap.sevenDayResetAt ? new Date(snap.sevenDayResetAt) : null,
+    representativeClaim: snap.representativeClaim,
+    overageStatus: snap.overageStatus,
+    overageDisabledReason: snap.overageDisabledReason,
+    fiveHourUtilPresent: snap.fiveHourUtilPresent,
+    sevenDayUtilPresent: snap.sevenDayUtilPresent
+  };
+}
+var THROTTLING_THRESHOLD_PCT = 80, OVERAGE_EXHAUSTED_REASONS, HEALTH_EMOJI, TABLE_HEALTH_RANK;
+var init_auth_snapshot_format = __esm(() => {
+  init_demo_mask();
+  init_card_format();
+  OVERAGE_EXHAUSTED_REASONS = new Set(["out_of_credits"]);
+  HEALTH_EMOJI = {
+    healthy: "\uD83D\uDFE2",
+    throttling: "\uD83D\uDFE1",
+    blocked: "\uD83D\uDD34",
+    unknown: "\u26aa"
+  };
+  TABLE_HEALTH_RANK = {
+    blocked: 0,
+    throttling: 1,
+    unknown: 2,
+    healthy: 3
+  };
+});
+
 // ../node_modules/.bun/zod@3.25.76/node_modules/zod/v3/helpers/util.js
 var util, objectUtil, ZodParsedType, getParsedType = (data) => {
   const t = typeof data;
@@ -24950,7 +25389,8 @@ var init_schema = __esm(() => {
   UserSchema = exports_external.object({
     name: exports_external.string().optional().describe("Display name for the user."),
     telegram_ids: exports_external.array(exports_external.string()).min(1).describe("Telegram username(s) and/or numeric user id(s) identifying this user " + "(a leading @ is optional). Matched against the message sender for " + "per-speaker memory routing."),
-    profile_bank: exports_external.string().describe("Hindsight bank holding this user's memory profile (author via " + "`switchroom memory profile add <bank> ...`).")
+    profile_bank: exports_external.string().describe("Hindsight bank holding this user's memory profile (author via " + "`switchroom memory profile add <bank> ...`)."),
+    person_id: exports_external.string().optional().describe("Free-text display name projected into the inbound `<channel>` " + 'tag\'s `user` attribute (e.g. "Lisa") so an agent can greet by ' + "name instead of only seeing the raw Telegram id/username. NOT a " + "stable identity system \u2014 just a label. Resolution is boot-time-only " + "(no hot-reload; a config change needs an agent restart) and " + "chat-scoped (a resolved name is only shown in a chat/group the " + "person is actually a member of, per that chat's access.json " + "membership \u2014 never broadcast into every chat the agent operates " + "in). Keep this broadly safe to show, the same discipline as " + "picking a `profile_bank` name: there is no automated enforcement " + "that a `person_id` stays safe if a group's membership changes " + "later \u2014 see docs/configuration.md.")
   });
   SwitchroomConfigSchema = exports_external.object({
     switchroom: exports_external.object({
@@ -36687,7 +37127,7 @@ var init_boot_card = __esm(() => {
 var exports_auth_snapshot_format = {};
 __export(exports_auth_snapshot_format, {
   zipProbeResults: () => zipProbeResults,
-  reviveLastQuota: () => reviveLastQuota,
+  reviveLastQuota: () => reviveLastQuota2,
   renderFallbackAnnouncement: () => renderFallbackAnnouncement2,
   renderAuthSnapshotFormat2: () => renderAuthSnapshotFormat22,
   recommendation: () => recommendation2,
@@ -36891,6 +37331,8 @@ function renderAuthSnapshotFormat22(snapshots, opts = {}) {
     lines.push(`_\u26a0 cached ${formatAgeStamp2(opts.staleCachedAtMs, now)}_`);
   } else if (opts.liveProbedAtMs != null) {
     lines.push(`_Live \u00b7 refreshed ${formatAgeStamp2(opts.liveProbedAtMs, now)}_`);
+  } else if (opts.probeFailed) {
+    lines.push("_\u26a0 probe failed \u2014 no live data_");
   } else {
     lines.push("_Live_");
   }
@@ -37118,7 +37560,7 @@ function buildSnapshotsFromState2(state4, quotas) {
   }
   return out;
 }
-function reviveLastQuota(snap) {
+function reviveLastQuota2(snap) {
   if (!snap)
     return null;
   return {
@@ -37139,7 +37581,7 @@ function buildSnapshotsFromCachedState(state4) {
     return {
       label: acc.label,
       isActive: acc.label === state4.active,
-      quota: reviveLastQuota(lq),
+      quota: reviveLastQuota2(lq),
       quotaError: lq ? undefined : "no cached quota (no probe since broker start)",
       expiresAtMs: acc.expiresAt,
       capturedAtMs: lq?.capturedAt
@@ -37147,7 +37589,7 @@ function buildSnapshotsFromCachedState(state4) {
   });
 }
 var THROTTLING_THRESHOLD_PCT2 = 80, OVERAGE_EXHAUSTED_REASONS2, HEALTH_EMOJI2, TABLE_HEALTH_RANK2;
-var init_auth_snapshot_format = __esm(() => {
+var init_auth_snapshot_format2 = __esm(() => {
   init_demo_mask();
   init_card_format();
   OVERAGE_EXHAUSTED_REASONS2 = new Set(["out_of_credits"]);
@@ -37799,6 +38241,148 @@ var init_approvals_commands = __esm(() => {
   init_client3();
 });
 
+// quota-bar-format.ts
+var exports_quota_bar_format = {};
+__export(exports_quota_bar_format, {
+  renderUsageCard: () => renderUsageCard,
+  renderQuotaBarBlockFromListState: () => renderQuotaBarBlockFromListState,
+  renderQuotaBarBlock: () => renderQuotaBarBlock,
+  renderQuotaBarAccount: () => renderQuotaBarAccount,
+  pickDot: () => pickDot,
+  formatWindowRow: () => formatWindowRow,
+  formatTimeLeft: () => formatTimeLeft,
+  elapsedFraction: () => elapsedFraction,
+  buildBar: () => buildBar,
+  accountStatus: () => accountStatus
+});
+function pickDot(pct) {
+  const clamped = Math.max(0, Math.min(100, pct));
+  if (clamped >= 90)
+    return "\uD83D\uDD34";
+  if (clamped >= 50)
+    return "\uD83D\uDFE1";
+  return "\uD83D\uDFE2";
+}
+function formatTimeLeft(target, now = new Date) {
+  if (!target)
+    return "resets now";
+  const deltaMs = target.getTime() - now.getTime();
+  if (!Number.isFinite(deltaMs) || deltaMs <= 0)
+    return "resets now";
+  const totalMin = Math.round(deltaMs / 60000);
+  if (totalMin < 60)
+    return `${totalMin}m left`;
+  const totalHours = Math.floor(totalMin / 60);
+  const m = totalMin % 60;
+  if (totalHours < 24)
+    return `${totalHours}h${m}m left`;
+  const d = Math.floor(totalHours / 24);
+  const h = totalHours % 24;
+  return h > 0 ? `${d}d${h}h left` : `${d}d left`;
+}
+function elapsedFraction(target, windowDurationMs, now = new Date) {
+  if (!target)
+    return 0;
+  const timeLeftMs = target.getTime() - now.getTime();
+  if (!Number.isFinite(timeLeftMs) || timeLeftMs <= 0)
+    return 0;
+  return Math.max(0, Math.min(1, 1 - timeLeftMs / windowDurationMs));
+}
+function buildBar(pct, elapsedFrac) {
+  const clampedPct = Math.max(0, Math.min(100, pct));
+  const fillCount = Math.round(clampedPct / 100 * BAR_WIDTH);
+  const cells = new Array(BAR_WIDTH).fill("\u2591");
+  for (let i = 0;i < fillCount; i++)
+    cells[i] = "\u2588";
+  const tickIndex = Math.max(0, Math.min(BAR_WIDTH - 1, Math.round(elapsedFrac * (BAR_WIDTH - 1))));
+  cells[tickIndex] = "\u2503";
+  return cells.join("");
+}
+function accountStatus(isActive, exhausted) {
+  if (isActive)
+    return "active";
+  if (exhausted)
+    return "exhausted";
+  return "idle";
+}
+function formatWindowRow(window2, pct, resetAt, now = new Date) {
+  const windowMs = window2 === "5h" ? FIVE_HOUR_MS : SEVEN_DAY_MS;
+  const dot = pickDot(pct);
+  const bar = buildBar(pct, elapsedFraction(resetAt, windowMs, now));
+  const pctStr = `${Math.round(Math.max(0, Math.min(100, pct)))}%`;
+  const timeLeft = formatTimeLeft(resetAt, now);
+  return `- ${dot} ${window2} \`[${bar}] ${pctStr} / ${timeLeft}\``;
+}
+function renderQuotaBarAccount(label, isActive, exhausted, quota, now = new Date, demo = false) {
+  const status = accountStatus(isActive, exhausted);
+  const displayLabel3 = demo ? maskEmail(label) : label;
+  const lines = [`- **${escapeMarkdown(displayLabel3)}** (${status})`];
+  if (!quota || isProbeThin(quota)) {
+    const reason = !quota ? "no data \u2014 probe failed" : "no data \u2014 thin probe";
+    lines.push(`- \u26a0\ufe0f 5h \`${reason}\``);
+    lines.push(`- \u26a0\ufe0f 7d \`${reason}\``);
+    return lines;
+  }
+  const norm = refillNormalizedUtils(quota, now);
+  lines.push(formatWindowRow("5h", norm.fiveHourUtilizationPct, quota.fiveHourResetAt, now));
+  lines.push(formatWindowRow("7d", norm.sevenDayUtilizationPct, quota.sevenDayResetAt, now));
+  return lines;
+}
+function formatAgeStamp3(atMs, now = new Date) {
+  const ageSec = Math.max(0, Math.round((now.getTime() - atMs) / 1000));
+  return ageSec < 60 ? `${ageSec}s ago` : `${Math.round(ageSec / 60)}m ago`;
+}
+function renderQuotaBarBlock(snapshots, exhaustedByLabel, opts = {}) {
+  const now = opts.now ?? new Date;
+  const demo = opts.demo ?? false;
+  const lines = [];
+  for (const snap of snapshots) {
+    const exhausted = exhaustedByLabel.get(snap.label) ?? false;
+    lines.push(...renderQuotaBarAccount(snap.label, snap.isActive, exhausted, snap.quota, now, demo));
+  }
+  return lines.join(`
+`);
+}
+function renderQuotaBarBlockFromListState(state4, opts = {}) {
+  const now = opts.now ?? new Date;
+  const exhaustedByLabel = new Map(state4.accounts.map((a) => [a.label, a.exhausted]));
+  const snapshots = state4.accounts.map((acc) => ({
+    label: acc.label,
+    isActive: acc.label === state4.active,
+    quota: reviveLastQuota(acc.last_quota ?? null),
+    quotaError: acc.last_quota ? undefined : "no cached quota (no probe since broker start)",
+    expiresAtMs: acc.expiresAt,
+    capturedAtMs: acc.last_quota?.capturedAt
+  }));
+  return renderQuotaBarBlock(snapshots, exhaustedByLabel, { now });
+}
+function renderUsageCard(snapshots, exhaustedByLabel, opts = {}) {
+  const now = opts.now ?? new Date;
+  const demo = opts.demo ?? false;
+  const bar = renderQuotaBarBlock(snapshots, exhaustedByLabel, { now, demo });
+  const lines = [bar];
+  lines.push(`_${recommendation(snapshots, now, demo)}_`);
+  if (opts.staleCachedAtMs != null) {
+    lines.push(`_\u26a0 cached ${formatAgeStamp3(opts.staleCachedAtMs, now)}_`);
+  } else if (opts.liveProbedAtMs != null) {
+    lines.push(`_Live \u00b7 refreshed ${formatAgeStamp3(opts.liveProbedAtMs, now)}_`);
+  } else if (opts.probeFailed) {
+    lines.push("_\u26a0 probe failed \u2014 no live data_");
+  } else {
+    lines.push("_Live_");
+  }
+  return lines.join(`
+`);
+}
+var FIVE_HOUR_MS, SEVEN_DAY_MS, BAR_WIDTH = 10;
+var init_quota_bar_format = __esm(() => {
+  init_auth_snapshot_format();
+  init_card_format();
+  init_demo_mask();
+  FIVE_HOUR_MS = 5 * 60 * 60 * 1000;
+  SEVEN_DAY_MS = 7 * 24 * 60 * 60 * 1000;
+});
+
 // gateway/approval-callback.ts
 var exports_approval_callback = {};
 __export(exports_approval_callback, {
@@ -40681,6 +41265,19 @@ function extractRetryAfterSecs(err) {
     return ra;
   return null;
 }
+function classifyEditError(err) {
+  const retryAfter = extractRetryAfterSecs(err);
+  if (retryAfter != null)
+    return "rate_limited";
+  const desc = err instanceof Error ? err.message : err != null && typeof err === "object" && ("description" in err) ? String(err.description) : String(err);
+  const low = desc.toLowerCase();
+  if (low.includes("not modified"))
+    return "not_modified";
+  if (low.includes("not found") || low.includes("can't be edited") || low.includes("cannot be edited") || low.includes("not enough rights")) {
+    return "gone";
+  }
+  return "transient";
+}
 function createWorkerActivityFeed(opts) {
   const log = opts.log ?? (() => {});
   const nowFn = opts.now ?? Date.now;
@@ -40694,6 +41291,18 @@ function createWorkerActivityFeed(opts) {
   });
   const clearIntervalFn = opts.clearInterval ?? ((handle) => clearInterval(handle));
   const handles = new Map;
+  const finalized = new Set;
+  const FINALIZED_CAP = 256;
+  function markFinalized(agentId) {
+    if (finalized.has(agentId))
+      return;
+    finalized.add(agentId);
+    if (finalized.size > FINALIZED_CAP) {
+      const oldest = finalized.values().next().value;
+      if (oldest != null)
+        finalized.delete(oldest);
+    }
+  }
   let heartbeatTimer = null;
   function sendOptsFor(h) {
     return {
@@ -40755,29 +41364,65 @@ function createWorkerActivityFeed(opts) {
       h.lastEditAt = nowFn();
       log(`worker-feed: edit agent=${h.agentId} chat=${h.chatId} ` + `thread=${h.threadId ?? "-"} msgId=${h.messageId} bytes=${body.length}`);
     } catch (err) {
-      noteRateLimited(h, err, "edit");
-      log(`worker-feed: edit failed, will re-post: ${err.message}`);
-      h.messageId = null;
-      h.lastBody = null;
+      const outcome = classifyEditError(err);
+      if (outcome === "rate_limited") {
+        noteRateLimited(h, err, "edit");
+        return;
+      }
+      if (outcome === "not_modified") {
+        h.lastBody = body;
+        h.lastEditAt = nowFn();
+        return;
+      }
+      if (outcome === "gone") {
+        h.messageId = null;
+        h.lastBody = null;
+        return;
+      }
+      log(`worker-feed: edit transient error agent=${h.agentId}: ${err.message}`);
     }
   }
   async function doFinish(h, view) {
-    if (h.messageId == null)
+    h.finished = true;
+    markFinalized(h.agentId);
+    if (h.messageId == null) {
+      h.pendingFinish = null;
       return;
+    }
     if (nowFn() < h.cooldownUntil) {
+      h.pendingFinish = view;
       return;
     }
     const body = renderWorkerActivity({ ...view, narrativeLines: h.narrative });
-    if (body === h.lastBody)
+    if (body === h.lastBody) {
+      h.pendingFinish = null;
       return;
+    }
     try {
       await opts.bot.editMessageText(h.chatId, h.messageId, body, sendOptsFor(h));
       h.lastBody = body;
       h.lastEditAt = nowFn();
+      h.pendingFinish = null;
       log(`worker-feed: finish agent=${h.agentId} chat=${h.chatId} ` + `thread=${h.threadId ?? "-"} msgId=${h.messageId} state=${view.state} bytes=${body.length}`);
     } catch (err) {
-      noteRateLimited(h, err, "finish");
-      log(`worker-feed: finish edit failed: ${err.message}`);
+      const outcome = classifyEditError(err);
+      if (outcome === "rate_limited") {
+        noteRateLimited(h, err, "finish");
+        h.pendingFinish = view;
+        return;
+      }
+      if (outcome === "not_modified") {
+        h.lastBody = body;
+        h.lastEditAt = nowFn();
+        h.pendingFinish = null;
+        return;
+      }
+      if (outcome === "gone") {
+        h.pendingFinish = null;
+        return;
+      }
+      h.pendingFinish = view;
+      log(`worker-feed: finish transient error agent=${h.agentId}: ${err.message}`);
     }
   }
   function heartbeatTick() {
@@ -40785,6 +41430,17 @@ function createWorkerActivityFeed(opts) {
     for (const h of handles.values()) {
       if (!handles.has(h.agentId))
         continue;
+      if (h.pendingFinish != null && now >= h.cooldownUntil) {
+        const view2 = h.pendingFinish;
+        h.chain = h.chain.then(() => doFinish(h, view2)).catch((err) => {
+          log(`worker-feed: heartbeat finalize re-drive error ${h.agentId}: ${err.message}`);
+        }).finally(() => {
+          if (handles.get(h.agentId)?.pendingFinish == null) {
+            handles.delete(h.agentId);
+          }
+        });
+        continue;
+      }
       if (h.lastView == null)
         continue;
       if (h.lastView.state !== "running")
@@ -40828,7 +41484,12 @@ function createWorkerActivityFeed(opts) {
     update(agentId, chatId, view, threadId) {
       if (chatId.length === 0)
         return Promise.resolve();
-      let h = handles.get(agentId);
+      if (finalized.has(agentId))
+        return Promise.resolve();
+      const existing = handles.get(agentId);
+      if (existing?.finished === true)
+        return Promise.resolve();
+      let h = existing;
       if (h == null) {
         h = {
           agentId,
@@ -40842,7 +41503,9 @@ function createWorkerActivityFeed(opts) {
           chain: Promise.resolve(),
           lastView: null,
           dispatchAtMs: null,
-          stepStartedAtMs: null
+          stepStartedAtMs: null,
+          finished: false,
+          pendingFinish: null
         };
         handles.set(agentId, h);
       }
@@ -40859,11 +41522,14 @@ function createWorkerActivityFeed(opts) {
       h.chain = h.chain.then(() => doFinish(h, view)).catch((err) => {
         log(`worker-feed: finish chain error ${agentId}: ${err.message}`);
       }).finally(() => {
-        handles.delete(agentId);
+        if (handles.get(agentId)?.pendingFinish == null) {
+          handles.delete(agentId);
+        }
       });
       return h.chain;
     },
     drop(agentId) {
+      markFinalized(agentId);
       handles.delete(agentId);
     },
     heartbeatTick,
@@ -57237,8 +57903,20 @@ _still working (${minutes}m) \u00b7 message me anytime, I'll keep you posted_`;
         elapsedMs: elapsed
       });
     }).catch((err) => {
-      process.stderr.write(`pending-work-progress: edit failed key=${key} ` + `msg=${editCtx.messageId}: ${err.message}
-`);
+      const desc = err instanceof Error ? err.message : err != null && typeof err === "object" && ("description" in err) ? String(err.description) : String(err);
+      const low = desc.toLowerCase();
+      if (low.includes("not modified")) {
+        activeDeps2.emitMetric?.({
+          kind: "pending_progress_edited",
+          chatKey: key,
+          elapsedMs: elapsed
+        });
+        return;
+      }
+      if (low.includes("not found") || low.includes("can't be edited") || low.includes("cannot be edited") || low.includes("not enough rights")) {
+        clearPending(key, "stale_turn");
+        return;
+      }
     });
   }
 }
@@ -57790,427 +58468,121 @@ function writeQuarantineMarker(telegramStateDir, reason, detail, nowFn = Date.no
   writeFileSync8(join11(telegramStateDir, QUARANTINE_FILENAME), JSON.stringify(marker) + `
 `, "utf-8");
 }
-// auth-snapshot-format.ts
-init_demo_mask();
-init_card_format();
-var THROTTLING_THRESHOLD_PCT = 80;
-var OVERAGE_EXHAUSTED_REASONS = new Set(["out_of_credits"]);
-function classifyHealth(snap, now = new Date) {
-  if (!snap.quota)
-    return "unknown";
-  const q = snap.quota;
-  if (isProbeThin(q))
-    return "unknown";
-  const norm = refillNormalizedUtils(q, now);
-  const max = Math.max(norm.fiveHourUtilizationPct, norm.sevenDayUtilizationPct);
-  if (max >= 99.5)
-    return "blocked";
-  if (max >= THROTTLING_THRESHOLD_PCT)
-    return "throttling";
-  return "healthy";
-}
-function blockedReason(snap, now = new Date) {
-  if (classifyHealth(snap, now) !== "blocked")
-    return null;
-  return "quota-exhausted";
-}
-function bindingWindow(q) {
-  if (q.representativeClaim === "seven_day")
-    return "7d";
-  if (q.representativeClaim === "five_hour")
-    return "5h";
-  return q.sevenDayUtilizationPct >= q.fiveHourUtilizationPct ? "7d" : "5h";
-}
-function formatRelative(target, now = new Date) {
-  if (!target)
-    return "\u2014";
-  const deltaMs = target.getTime() - now.getTime();
-  if (deltaMs <= 0)
-    return "now";
-  const totalMin = Math.round(deltaMs / 60000);
-  if (totalMin < 60)
-    return `${totalMin}m`;
-  const h = Math.floor(totalMin / 60);
-  const m = totalMin % 60;
-  if (h < 24)
-    return m > 0 ? `${h}h ${m}m` : `${h}h`;
-  const d = Math.floor(h / 24);
-  const rh = h % 24;
-  return rh > 0 ? `${d}d ${rh}h` : `${d}d`;
-}
-function formatAbsolute(target, tz = "UTC") {
-  if (!target)
-    return "\u2014";
-  return target.toLocaleString("en-US", {
-    timeZone: tz,
-    weekday: "short",
-    hour: "numeric",
-    minute: "2-digit",
-    hour12: true
-  });
-}
-function formatStatusTime(target, now = new Date, tz = "UTC") {
-  if (!target)
-    return "\u2014";
-  const dayFmt = new Intl.DateTimeFormat("en-CA", {
-    timeZone: tz,
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit"
-  });
-  const timeFmt = new Intl.DateTimeFormat("en-US", {
-    timeZone: tz,
-    hour: "numeric",
-    minute: "2-digit",
-    hour12: true
-  });
-  const timeStr = timeFmt.format(target);
-  if (dayFmt.format(target) === dayFmt.format(now)) {
-    return timeStr;
-  }
-  const withinWeek = target.getTime() - now.getTime() < 7 * 24 * 60 * 60 * 1000;
-  const dateFmt = new Intl.DateTimeFormat("en-US", {
-    timeZone: tz,
-    weekday: "short",
-    ...withinWeek ? {} : { day: "numeric", month: "short" }
-  });
-  return `${dateFmt.format(target)} ${timeStr}`;
-}
-function fmtPct(pct) {
-  return `${Math.min(100, Math.round(pct))}%`;
-}
-function displayLabel(label, opts) {
-  return opts.demo ? maskEmail(label) : label;
-}
-var HEALTH_EMOJI = {
-  healthy: "\uD83D\uDFE2",
-  throttling: "\uD83D\uDFE1",
-  blocked: "\uD83D\uDD34",
-  unknown: "\u26aa"
-};
-function renderAccountRow(snap, opts) {
-  const now = opts.now ?? new Date;
-  const tz = opts.tz ?? "UTC";
-  const lines = [];
-  const marker = snap.isActive ? "\u25cf " : "";
-  const label = displayLabel(snap.label, opts);
-  if (!snap.quota) {
-    lines.push(`${marker}\`${codeSpanSafe(label)}\`  _quota probe failed_`);
-    if (snap.quotaError) {
-      lines.push(`  _${escapeMarkdown(snap.quotaError)}_`);
-    }
-    return lines;
-  }
-  const q = snap.quota;
-  if (isProbeThin(q)) {
-    lines.push(`${marker}\`${codeSpanSafe(label)}\`  _quota unknown (thin probe)_`);
-    return lines;
-  }
-  const norm = refillNormalizedUtils(q, now);
-  const fiveStr = fmtPct(norm.fiveHourUtilizationPct);
-  const sevenStr = fmtPct(norm.sevenDayUtilizationPct);
-  lines.push(`${marker}\`${codeSpanSafe(label)}\`  ${fiveStr} / ${sevenStr}`);
-  const health = classifyHealth(snap, now);
-  if (health === "blocked") {
-    const win = bindingWindow(q);
-    const reset2 = win === "5h" ? q.fiveHourResetAt : q.sevenDayResetAt;
-    const winLabel = win === "5h" ? "5-hour" : "7-day";
-    lines.push(reset2 ? `  _quota exhausted \u2014 back ${formatAbsolute(reset2, tz)} (\`in ${formatRelative(reset2, now)}\`, ${winLabel} cap)_` : `  _quota exhausted \u2014 ${winLabel} cap, reset time unknown_`);
-    return lines;
-  }
-  const fiveResetIn = q.fiveHourResetAt ? q.fiveHourResetAt.getTime() - now.getTime() : Infinity;
-  const sevenResetIn = q.sevenDayResetAt ? q.sevenDayResetAt.getTime() - now.getTime() : Infinity;
-  const fiveFirst = fiveResetIn <= sevenResetIn;
-  const fiveSeg = q.fiveHourResetAt ? `5h refills ${formatAbsolute(q.fiveHourResetAt, tz)} (\`in ${formatRelative(q.fiveHourResetAt, now)}\`)` : "5h refills \u2014";
-  const sevenSeg = q.sevenDayResetAt ? `7d resets ${formatAbsolute(q.sevenDayResetAt, tz)} (\`in ${formatRelative(q.sevenDayResetAt, now)}\`)` : "7d resets \u2014";
-  lines.push(`  _${fiveFirst ? fiveSeg : sevenSeg}_`);
-  lines.push(`  _${fiveFirst ? sevenSeg : fiveSeg}_`);
-  if (q.overageDisabledReason != null && OVERAGE_EXHAUSTED_REASONS.has(q.overageDisabledReason)) {
-    lines.push(`  _overage off (${escapeMarkdown(q.overageDisabledReason)}) \u2014 serving from quota_`);
-  }
-  return lines;
-}
-function formatAgeStamp(atMs, now = new Date) {
-  const ageSec = Math.max(0, Math.round((now.getTime() - atMs) / 1000));
-  return ageSec < 60 ? `${ageSec}s ago` : `${Math.round(ageSec / 60)}m ago`;
-}
-var TABLE_HEALTH_RANK = {
-  blocked: 0,
-  throttling: 1,
-  unknown: 2,
-  healthy: 3
-};
-function tableCell(s) {
-  return s.replace(/\\/g, "\\\\").replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
-}
-function pctCells(snap, now) {
-  if (!snap.quota)
-    return { five: "\u2014", seven: "\u2014" };
-  if (isProbeThin(snap.quota))
-    return { five: "?", seven: "?" };
-  const norm = refillNormalizedUtils(snap.quota, now);
-  return { five: fmtPct(norm.fiveHourUtilizationPct), seven: fmtPct(norm.sevenDayUtilizationPct) };
-}
-function windowResetCell(snap, now, tz, win) {
-  if (!snap.quota) {
-    return snap.quotaError ? `probe failed (${snap.quotaError})` : "\u2014";
-  }
-  if (isProbeThin(snap.quota))
-    return "quota unknown";
-  const reset2 = win === "5h" ? snap.quota.fiveHourResetAt : snap.quota.sevenDayResetAt;
-  if (!reset2)
-    return "\u2014";
-  return `${formatStatusTime(reset2, now, tz)} (in ${formatRelative(reset2, now)})`;
-}
-function renderAuthSnapshotFormat2(snapshots, opts = {}) {
-  const now = opts.now ?? new Date;
-  const tz = opts.tz ?? "UTC";
-  const lines = [];
-  lines.push("\uD83D\uDD0B **Auth \u2014 fleet status**");
-  const ordered = [...snapshots].sort((a, b) => {
-    if (a.isActive !== b.isActive)
-      return a.isActive ? -1 : 1;
-    const r = TABLE_HEALTH_RANK[classifyHealth(a, now)] - TABLE_HEALTH_RANK[classifyHealth(b, now)];
-    if (r !== 0)
-      return r;
-    return a.label.localeCompare(b.label);
-  });
-  if (ordered.length > 0) {
-    lines.push("");
-    lines.push("| State | Account | 5h | 5h resets | 7d | 7d resets |");
-    lines.push("| --- | --- | --- | --- | --- | --- |");
-    for (const s of ordered) {
-      const emoji = HEALTH_EMOJI[classifyHealth(s, now)];
-      const label = displayLabel(s.label, opts);
-      const accountCell = `\`${codeSpanSafe(s.isActive ? `${label} (active)` : label)}\``;
-      const { five, seven } = pctCells(s, now);
-      const fiveReset = windowResetCell(s, now, tz, "5h");
-      const sevenReset = windowResetCell(s, now, tz, "7d");
-      lines.push(`| ${emoji} | ${tableCell(accountCell)} | ${five} | ${tableCell(fiveReset)} | ${seven} | ${tableCell(sevenReset)} |`);
-    }
-  }
-  lines.push("");
-  lines.push(`_${recommendation(snapshots, now, opts.demo ?? false)}_`);
-  if (opts.staleCachedAtMs != null) {
-    lines.push(`_\u26a0 cached ${formatAgeStamp(opts.staleCachedAtMs, now)}_`);
-  } else if (opts.liveProbedAtMs != null) {
-    lines.push(`_Live \u00b7 refreshed ${formatAgeStamp(opts.liveProbedAtMs, now)}_`);
-  } else {
-    lines.push("_Live_");
-  }
-  return lines.join(`
-`);
-}
-function recommendation(snapshots, now = new Date, demo = false) {
-  const active = snapshots.find((s) => s.isActive);
-  if (!active)
-    return "No active account set.";
-  const activeHealth = classifyHealth(active, now);
-  const others = snapshots.filter((s) => !s.isActive);
-  const healthyAlt = others.find((s) => classifyHealth(s, now) === "healthy");
-  const lbl = (s) => demo ? maskEmail(s.label) : s.label;
-  const activeLabel = lbl(active);
-  if (activeHealth === "healthy") {
-    return `Recommendation: stay on ${activeLabel}.`;
-  }
-  if (activeHealth === "throttling") {
-    if (healthyAlt) {
-      return `Recommendation: active ${activeLabel} is throttling. Switch to ${lbl(healthyAlt)} for headroom.`;
-    }
-    return `Recommendation: active ${activeLabel} is throttling; no healthy alternative \u2014 wait for refill.`;
-  }
-  if (activeHealth === "blocked") {
-    if (healthyAlt) {
-      return `Recommendation: active ${activeLabel} is BLOCKED \u2014 switch to ${lbl(healthyAlt)} now.`;
-    }
-    return summarizeNoHealthyAlt(snapshots, now, demo);
-  }
-  return `Active ${activeLabel}: quota probe failed; broker last_seen unknown.`;
-}
-function summarizeNoHealthyAlt(snapshots, now, demo = false) {
-  const mask = (label) => demo ? maskEmail(label) : label;
-  let throttlingLabel = null;
-  let allTrulyBlocked = true;
-  for (const s of snapshots) {
-    const h = classifyHealth(s, now);
-    if (h === "throttling") {
-      if (!throttlingLabel)
-        throttlingLabel = s.label;
-      allTrulyBlocked = false;
-    } else if (h === "healthy" || h === "unknown") {
-      allTrulyBlocked = false;
-    } else if (h === "blocked" && blockedReason(s, now) === "quota-exhausted") {
-      if (s.quota) {
-        const win = bindingWindow(s.quota);
-        const at = win === "5h" ? s.quota.fiveHourResetAt : s.quota.sevenDayResetAt;
-        if (at && at.getTime() > now.getTime())
-          allTrulyBlocked = false;
-      }
+
+// gateway/resolve-person.ts
+function normalizeTelegramKey(raw) {
+  return raw.trim().replace(/^@/, "").toLowerCase();
+}
+function buildPersonDirectory(entries) {
+  const byTelegramKey = {};
+  const dropped = [];
+  const personIdOwner = new Map;
+  const telegramKeyOwner = new Map;
+  for (const raw of entries) {
+    const key = typeof raw.key === "string" ? raw.key.trim() : "";
+    const personId = typeof raw.person_id === "string" ? raw.person_id.trim() : "";
+    if (key.length === 0) {
+      dropped.push({ key: raw.key || "(unknown)", reason: "missing users: map key", reasonClass: "missing users: map key" });
+      continue;
     }
-  }
-  const earliestRecovery = pickEarliestRecovery(snapshots, now);
-  if (throttlingLabel) {
-    const eta = earliestRecovery ? ` Soonest full refill: ${mask(earliestRecovery.label)} in ${formatRelative(earliestRecovery.at, now)}.` : "";
-    return `No fully-healthy account; ${mask(throttlingLabel)} is throttling but still usable.${eta}`;
-  }
-  if (!allTrulyBlocked) {
-    if (earliestRecovery) {
-      return `All accounts at capacity; soonest refill: ${mask(earliestRecovery.label)} in ${formatRelative(earliestRecovery.at, now)}.`;
+    if (personId.length === 0) {
+      dropped.push({ key, reason: "empty or missing person_id", reasonClass: "empty or missing person_id" });
+      continue;
     }
-    return `All accounts at capacity \u2014 waiting on a window refill.`;
-  }
-  if (earliestRecovery) {
-    return `All accounts blocked. Earliest recovery: ${mask(earliestRecovery.label)} in ${formatRelative(earliestRecovery.at, now)}.`;
-  }
-  return `All accounts blocked. Run /auth add to attach another subscription.`;
-}
-function pickEarliestRecovery(snapshots, now) {
-  let best = null;
-  for (const s of snapshots) {
-    if (!s.quota)
+    if (!Array.isArray(raw.telegram_ids) || raw.telegram_ids.length === 0) {
+      dropped.push({ key, reason: "no telegram_ids to resolve against", reasonClass: "no telegram_ids to resolve against" });
       continue;
-    if (isProbeThin(s.quota))
+    }
+    const personIdLower = personId.toLowerCase();
+    const existingOwner = personIdOwner.get(personIdLower);
+    if (existingOwner != null && existingOwner !== key) {
+      dropped.push({
+        key,
+        reason: `duplicate person_id "${personId}" already claimed by users.${existingOwner}`,
+        reasonClass: `duplicate person_id already claimed by users.${existingOwner}`
+      });
       continue;
-    const win = bindingWindow(s.quota);
-    const at = win === "5h" ? s.quota.fiveHourResetAt : s.quota.sevenDayResetAt;
-    if (!at || at.getTime() <= now.getTime())
+    }
+    personIdOwner.set(personIdLower, key);
+    const telegramKeys = [...new Set(raw.telegram_ids.map(normalizeTelegramKey).filter((k) => k.length > 0))];
+    if (telegramKeys.length === 0) {
+      dropped.push({ key, reason: "telegram_ids contained no usable id/username", reasonClass: "telegram_ids contained no usable id/username" });
+      personIdOwner.delete(personIdLower);
       continue;
-    if (!best || at.getTime() < best.at.getTime()) {
-      best = { label: s.label, at };
     }
-  }
-  return best;
-}
-function renderFallbackAnnouncement(input) {
-  const now = input.now ?? new Date;
-  const tz = input.tz ?? "UTC";
-  const lines = [];
-  const limitWord = input.oldQuota ? limitWordFor(input.oldQuota) : "quota";
-  const headerLimit = limitWord === "quota" ? "quota cap" : `${limitWord} limit`;
-  if (!input.newLabel) {
-    lines.push(`\uD83D\uDD34 **All accounts blocked \u00b7 ${headerLimit} on ${escapeMarkdown(input.oldLabel)}**`);
-    lines.push("");
-    lines.push(`Triggered by: agent **${escapeMarkdown(input.triggerAgent)}**`);
-    const fleet = input.fleetSnapshots ?? [];
-    if (fleet.length > 0) {
-      lines.push("");
-      const rowOpts = { now, tz };
-      const healthOrder = ["blocked", "throttling", "healthy", "unknown"];
-      const rank = (s) => healthOrder.indexOf(classifyHealth(s, now));
-      const ordered = [...fleet].sort((a, b) => rank(a) - rank(b) || Number(b.isActive) - Number(a.isActive));
-      for (const snap of ordered) {
-        for (const ln of renderAccountRow(snap, rowOpts))
-          lines.push(ln);
-      }
-      const earliest = pickEarliestRecovery(fleet, now);
-      if (earliest) {
-        lines.push("");
-        lines.push(`Earliest recovery: \`${codeSpanSafe(earliest.label)}\` ` + `${formatAbsolute(earliest.at, tz)} (in ${formatRelative(earliest.at, now)})`);
-      }
-    } else if (input.oldQuota) {
-      const recovery = recoveryAtFor(input.oldQuota);
-      if (recovery) {
-        lines.push(`${escapeMarkdown(input.oldLabel)} recovers ${formatAbsolute(recovery, tz)} ` + `(in ${formatRelative(recovery, now)})`);
-      }
+    const collidingTelegramKey = telegramKeys.find((tk) => {
+      const existingTkOwner = telegramKeyOwner.get(tk);
+      return existingTkOwner != null && existingTkOwner !== key;
+    });
+    if (collidingTelegramKey != null) {
+      const existingTkOwner = telegramKeyOwner.get(collidingTelegramKey);
+      dropped.push({
+        key,
+        reason: `duplicate telegram_id "${collidingTelegramKey}" already claimed by users.${existingTkOwner}`,
+        reasonClass: `duplicate telegram_id already claimed by users.${existingTkOwner}`
+      });
+      personIdOwner.delete(personIdLower);
+      continue;
     }
-    lines.push("");
-    lines.push(`Run \`/auth add <label>\` to attach another subscription, ` + `or \`/auth refresh\` to re-probe.`);
-    return lines.join(`
-`);
-  }
-  lines.push(`\u2713 **Switched fleet \u00b7 ${headerLimit} on ${escapeMarkdown(input.oldLabel)}**`);
-  lines.push("");
-  lines.push(`\`${codeSpanSafe(input.oldLabel)}\` \u2192 \`${codeSpanSafe(input.newLabel)}\``);
-  lines.push(`Triggered by: agent **${escapeMarkdown(input.triggerAgent)}**`);
-  lines.push("");
-  if (input.oldQuota) {
-    const recovery = recoveryAtFor(input.oldQuota);
-    if (recovery) {
-      lines.push(`\`${codeSpanSafe(input.oldLabel)}\` recovers ` + `${formatAbsolute(recovery, tz)} (in ${formatRelative(recovery, now)})`);
+    const entry = { key, personId, telegramKeys };
+    for (const tk of telegramKeys) {
+      telegramKeyOwner.set(tk, key);
+      byTelegramKey[tk] = entry;
     }
   }
-  if (input.newQuota) {
-    const fiveStr = fmtPct(input.newQuota.fiveHourUtilizationPct);
-    const sevenStr = fmtPct(input.newQuota.sevenDayUtilizationPct);
-    const hasHeadroom = input.newQuota.fiveHourUtilizationPct < THROTTLING_THRESHOLD_PCT && input.newQuota.sevenDayUtilizationPct < THROTTLING_THRESHOLD_PCT;
-    const headroomStr = hasHeadroom ? "_(plenty of headroom)_" : "_(near limit \u2014 watch this)_";
-    lines.push(`\`${codeSpanSafe(input.newLabel)}\` now: ${fiveStr} of 5h \u00b7 ${sevenStr} of 7d ${headroomStr}`);
-  } else {
-    lines.push(`_(quota probe for new account is pending \u2014 will reflect on next /auth)_`);
-  }
-  return lines.join(`
-`);
+  return { directory: { byTelegramKey }, dropped };
 }
-function limitWordFor(q) {
-  if (q.representativeClaim === "seven_day" && q.sevenDayUtilizationPct >= 99)
-    return "7-day";
-  if (q.representativeClaim === "five_hour" && q.fiveHourUtilizationPct >= 99)
-    return "5-hour";
-  if (q.sevenDayUtilizationPct >= 99)
-    return "7-day";
-  if (q.fiveHourUtilizationPct >= 99)
-    return "5-hour";
-  return q.sevenDayUtilizationPct >= q.fiveHourUtilizationPct ? "7-day" : "5-hour";
-}
-function recoveryAtFor(q) {
-  const word = limitWordFor(q);
-  if (word === "7-day")
-    return q.sevenDayResetAt;
-  if (word === "5-hour")
-    return q.fiveHourResetAt;
-  if (!q.fiveHourResetAt)
-    return q.sevenDayResetAt;
-  if (!q.sevenDayResetAt)
-    return q.fiveHourResetAt;
-  return q.fiveHourResetAt.getTime() < q.sevenDayResetAt.getTime() ? q.fiveHourResetAt : q.sevenDayResetAt;
-}
-function buildSnapshotKeyboard(snapshots, opts = {}) {
-  const max = opts.maxSwitchButtons ?? 3;
-  const now = opts.now ?? new Date;
-  const rows = [];
-  const switchTargets = snapshots.filter((s) => !s.isActive).sort((a, b) => switchPriority(a, now) - switchPriority(b, now)).filter((s) => classifyHealth(s, now) !== "blocked" && classifyHealth(s, now) !== "unknown").slice(0, max);
-  for (const t of switchTargets) {
-    rows.push([
-      {
-        text: `Switch fleet \u2192 ${opts.demo ? maskEmail(t.label) : t.label}`,
-        callbackData: `auth:use:${t.label}`
-      }
-    ]);
+function runPersonDirectoryBootCheck(readEntries) {
+  try {
+    const rawEntries = readEntries();
+    const { directory, dropped } = buildPersonDirectory(rawEntries);
+    if (dropped.length > 0) {
+      const alertSummary = dropped.map((d) => `${d.key} (${d.reasonClass})`).join("; ");
+      const logSummary = dropped.map((d) => `${d.key} (${d.reason})`).join("; ");
+      const plural = dropped.length === 1 ? "y" : "ies";
+      return {
+        directory,
+        alertDetail: `person_id: dropped ${dropped.length} malformed users: entr${plural} at boot \u2014 ${alertSummary}`,
+        logLine: `telegram gateway: person_id boot validation dropped ${dropped.length} entr${plural}: ${logSummary}`
+      };
+    }
+    return {
+      directory,
+      alertDetail: null,
+      logLine: rawEntries.length > 0 ? `telegram gateway: person_id boot validation ok \u2014 ${Object.keys(directory.byTelegramKey).length} telegram id/username(s) resolved` : `telegram gateway: person_id boot validation ok \u2014 no person_id entries configured`
+    };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return {
+      directory: { byTelegramKey: {} },
+      alertDetail: `person_id boot validation crashed \u2014 name resolution disabled this boot (fail-open, raw ids/usernames will show); see gateway stderr for detail`,
+      logLine: `telegram gateway: person_id boot validation CRASHED (name resolution disabled this boot, raw ids will show \u2014 fail-open): ${msg}`
+    };
   }
-  rows.push([
-    { text: "\u21bb Refresh", callbackData: opts.demo ? "auth:refresh:demo" : "auth:refresh" },
-    { text: "/usage", insertText: "/usage" },
-    { text: "+ Add", insertText: "/auth add " }
-  ]);
-  return rows;
-}
-function switchPriority(s, now = new Date) {
-  const h = classifyHealth(s, now);
-  if (h === "healthy")
-    return 0;
-  if (h === "throttling")
-    return 1;
-  if (h === "unknown")
-    return 2;
-  return 3;
 }
-function buildSnapshotsFromState(state3, quotas) {
-  const out = [];
-  for (let i = 0;i < state3.accounts.length; i++) {
-    const acc = state3.accounts[i];
-    const q = quotas[i];
-    out.push({
-      label: acc.label,
-      isActive: acc.label === state3.active,
-      quota: q && q.ok ? q.data : null,
-      quotaError: q && !q.ok ? q.reason : undefined,
-      expiresAtMs: acc.expiresAt
-    });
+function resolvePersonName(directory, opts) {
+  const idKey = normalizeTelegramKey(opts.telegramId);
+  const usernameKey = opts.username ? normalizeTelegramKey(opts.username) : undefined;
+  const entry = directory.byTelegramKey[idKey] ?? (usernameKey ? directory.byTelegramKey[usernameKey] : undefined);
+  if (!entry)
+    return;
+  if (opts.isDm)
+    return entry.personId;
+  const allowFrom = opts.groupAllowFrom ?? [];
+  const allowFromNormalized = allowFrom.map(normalizeTelegramKey);
+  const memberConfirmed = allowFromNormalized.includes(idKey) || usernameKey != null && allowFromNormalized.includes(usernameKey);
+  return memberConfirmed ? entry.personId : undefined;
+}
+function safeResolvePersonName(directory, opts, rawFallback) {
+  try {
+    return resolvePersonName(directory, opts) ?? rawFallback;
+  } catch {
+    return rawFallback;
   }
-  return out;
 }
 
 // gateway/auth-command.ts
+init_auth_snapshot_format();
 init_demo_mask();
 var AUTH_RM_CONFIRM_TTL_MS = 60000;
 var pendingAuthRmFlows = new Map;
@@ -60148,6 +60520,20 @@ function renderOperatorEvent(ev) {
           ]
         }
       };
+    case "config-warning":
+      return {
+        text: [
+          `\u2139\ufe0f **Config warning** for **${agent}**.`,
+          detail ? `_${detail}_` : "",
+          `Non-urgent \u2014 config will keep working with today's fallback behavior.`
+        ].filter(Boolean).join(`
+`),
+        keyboard: {
+          inline_keyboard: [
+            [{ text: "\u274c Dismiss", callback_data: `op:dismiss:${encodeURIComponent(ev.agent)}` }]
+          ]
+        }
+      };
   }
 }
 var DEFAULT_OPERATOR_EVENT_COOLDOWN_MS = 5 * 60000;
@@ -60402,6 +60788,7 @@ function resolveModelUnavailableFromOperatorEvent(ev) {
 
 // auto-fallback-fleet.ts
 init_card_format();
+init_auth_snapshot_format();
 function renderFallbackFailureNotice(triggerAgent, reason) {
   return `\u26a0\ufe0f **Auto-failover could not run** (trigger: **${escapeMarkdown(triggerAgent)}**)
 ` + `${escapeMarkdown(reason)}
@@ -72126,7 +72513,7 @@ function readSubTail(entry, tail, now, onDescriptionUpdate, fs2, log, db2, paren
       const events = projectSubagentLine(line, entry.agentId, startState);
       const fireNarrativeProgress = () => {
         if (onProgress == null || entry.state !== "running" || entry.historical)
-          return;
+          return false;
         try {
           onProgress({
             agentId: entry.agentId,
@@ -72140,24 +72527,26 @@ function readSubTail(entry, tail, now, onDescriptionUpdate, fs2, log, db2, paren
             lastTool: entry.lastTool,
             toolCount: entry.toolCount
           });
+          return true;
         } catch (cbErr) {
           log?.(`subagent-watcher: onProgress callback error ${entry.agentId}: ${cbErr.message}`);
+          return false;
         }
       };
       const resolvePendingSubNarrative = (toolName, toolInput) => {
         if (entry.pendingNarrative == null)
-          return;
+          return false;
         const pending = entry.pendingNarrative;
         entry.pendingNarrative = null;
         if (toolName != null && REPLY_TOOLS2.has(toolName)) {
           const replyText = typeof toolInput?.text === "string" ? toolInput.text : "";
           if (isDraftOfReply2(pending.text, replyText))
-            return;
+            return false;
         } else if (toolName == null && entry.lastReplyText != null && entry.lastReplyText.length > 0) {
           if (isDraftOfReply2(pending.text, entry.lastReplyText))
-            return;
+            return false;
         }
-        fireNarrativeProgress();
+        return fireNarrativeProgress();
       };
       for (const ev of events) {
         const idleSecBeforeBump = Math.round((now - entry.lastActivityAt) / 1000);
@@ -72185,7 +72574,7 @@ function readSubTail(entry, tail, now, onDescriptionUpdate, fs2, log, db2, paren
           log?.(`subagent-watcher: stall cleared for ${entry.agentId} (activity resumed after ${idleSecBeforeBump}s \u2014 re-arming detection)`);
         }
         if (ev.kind === "sub_agent_tool_use") {
-          resolvePendingSubNarrative(ev.toolName, ev.input);
+          const narrativeJustFired = resolvePendingSubNarrative(ev.toolName, ev.input);
           if (REPLY_TOOLS2.has(ev.toolName) && typeof ev.input?.text === "string") {
             entry.lastReplyText = ev.input.text;
           }
@@ -72194,7 +72583,7 @@ function readSubTail(entry, tail, now, onDescriptionUpdate, fs2, log, db2, paren
             name: ev.toolName,
             sanitisedArg: sanitiseToolArg(ev.toolName, ev.input ?? {})
           };
-          if (onProgress != null && entry.state === "running" && !entry.historical) {
+          if (onProgress != null && entry.state === "running" && !entry.historical && !narrativeJustFired) {
             const toolLine = describeToolUse(ev.toolName, ev.input ?? {});
             if (toolLine != null && toolLine.length > 0) {
               try {
@@ -74769,9 +75158,10 @@ function saveCreditState(stateDir, state4) {
 }
 
 // quota-watch.ts
+init_auth_snapshot_format();
+init_card_format();
 import { readFileSync as readFileSync42, writeFileSync as writeFileSync32, existsSync as existsSync41, mkdirSync as mkdirSync31 } from "fs";
 import { join as join43 } from "path";
-init_card_format();
 var STATE_FILE2 = "quota-watch.json";
 function emptyQuotaWatchState() {
   return {};
@@ -74995,7 +75385,7 @@ function patchQuotaWatchState(current, accountLabel, accountState) {
 }
 
 // gateway/gateway.ts
-init_auth_snapshot_format();
+init_auth_snapshot_format2();
 
 // demo-mask.ts
 function stableAssign2(input, cache, pool, overflow) {
@@ -75096,10 +75486,10 @@ function readTurnActiveMarkerAgeMs(stateDir, now) {
 }
 
 // ../src/build-info.ts
-var VERSION = "0.18.3";
-var COMMIT_SHA = "dbd8b112";
-var COMMIT_DATE = "2026-07-09T13:17:41+10:00";
-var LATEST_PR = 2952;
+var VERSION = "0.18.6";
+var COMMIT_SHA = "b62d558a";
+var COMMIT_DATE = "2026-07-10T10:22:09+10:00";
+var LATEST_PR = 2970;
 var COMMITS_AHEAD_OF_TAG = 0;
 
 // gateway/boot-version.ts
@@ -75161,7 +75551,7 @@ function classifyRejection(err, opts = {}) {
   if (e.error_code !== 400)
     return "shutdown";
   const desc = (e.description ?? "").toLowerCase();
-  if (desc.includes("message is not modified") || desc.includes("message to edit not found") || desc.includes("message to delete not found") || desc.includes("can't parse entities") || desc.includes("unsupported start tag") || desc.includes("chat not found") || desc.includes("not enough rights")) {
+  if (desc.includes("message is not modified") || desc.includes("message to edit not found") || desc.includes("message to delete not found") || desc.includes("can't parse entities") || desc.includes("unsupported start tag") || desc.includes("chat not found") || desc.includes("not enough rights") || desc.includes("group chat was upgraded to a supergroup chat") || desc.includes("chat_id is empty") || desc.includes("group chat was deactivated")) {
     return "log_only";
   }
   return "shutdown";
@@ -76550,6 +76940,7 @@ var ACCESS_FILE = join47(STATE_DIR, "access.json");
 var APPROVED_DIR = join47(STATE_DIR, "approved");
 var ENV_FILE = join47(STATE_DIR, ".env");
 var INBOX_DIR = join47(STATE_DIR, "inbox");
+var PEOPLE_FILE = join47(STATE_DIR, "people.json");
 function triggerSelfRestart(targetAgent, reason, delayMs = 300) {
   const isDocker = process.env.SWITCHROOM_RUNTIME === "docker";
   const selfAgent = process.env.SWITCHROOM_AGENT_NAME;
@@ -76823,6 +77214,18 @@ var BOOT_ACCESS = STATIC ? (() => {
 function loadAccess() {
   return BOOT_ACCESS ?? readAccessFile();
 }
+function readPeopleFile() {
+  try {
+    const raw = readFileSync45(PEOPLE_FILE, "utf8");
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed.entries))
+      return [];
+    return parsed.entries;
+  } catch {
+    return [];
+  }
+}
+var PERSON_DIRECTORY = { byTelegramKey: {} };
 function assertAllowedChat(chat_id) {
   const id = String(chat_id);
   const access = loadAccess();
@@ -76999,6 +77402,29 @@ function resolveSubagentOriginChat(agentId) {
     return null;
   }
 }
+var WORKER_FEED_FALLBACK_LOG_CAP = 256;
+var workerFeedOwnerDmFallbackLogged = new Set;
+function resolveWorkerFeedChat(agentId, fleetChatId) {
+  const origin = resolveSubagentOriginChat(agentId);
+  if (origin != null && origin.chatId.length > 0)
+    return origin;
+  if (fleetChatId.length > 0)
+    return { chatId: fleetChatId };
+  const ownerDm = loadAccess().allowFrom[0] ?? "";
+  if (origin == null && fleetChatId.length === 0 && ownerDm.length > 0) {
+    if (!workerFeedOwnerDmFallbackLogged.has(agentId)) {
+      workerFeedOwnerDmFallbackLogged.add(agentId);
+      if (workerFeedOwnerDmFallbackLogged.size > WORKER_FEED_FALLBACK_LOG_CAP) {
+        const oldest = workerFeedOwnerDmFallbackLogged.values().next().value;
+        if (oldest != null)
+          workerFeedOwnerDmFallbackLogged.delete(oldest);
+      }
+      process.stderr.write(`telegram gateway: worker-feed origin unresolved agent=${agentId} \u2014 routing card to owner DM
+`);
+    }
+  }
+  return { chatId: ownerDm, threadId: origin?.threadId };
+}
 var REGISTRY_REAPER_INTERVAL_MS = 21600000;
 function runHistoryReaperNow(reason) {
   const retentionDays = resolveRetentionDays(HISTORY_ACCESS.historyRetentionDays);
@@ -77861,7 +78287,12 @@ async function resolveCompactCard(kind, occNow) {
   try {
     await swallowingApiCall(() => bot.api.editMessageText(card.chatId, card.messageId, richMessage2(text5), {}), { chat_id: card.chatId, verb: `proactiveCompact.${kind}` });
   } catch (err) {
-    process.stderr.write(`telegram gateway: proactive-compact ${kind} card edit failed: ${err instanceof Error ? err.message : String(err)}
+    const desc = err instanceof Error ? err.message : String(err);
+    const low = desc.toLowerCase();
+    if (low.includes("not modified") || low.includes("not found") || low.includes("can't be edited") || low.includes("cannot be edited") || low.includes("not enough rights") || low.includes("429") || low.includes("retry after")) {
+      return;
+    }
+    process.stderr.write(`telegram gateway: proactive-compact ${kind} card edit failed: ${desc}
 `);
   }
 }
@@ -82387,7 +82818,9 @@ async function drainActivitySummary(turn, producer = "tool", openFlags) {
         turn.activityLastSentRender = target;
       } catch (err) {
         const msg = err instanceof Error ? err.message : String(err);
-        if (!msg.includes("message is not modified")) {
+        const low = msg.toLowerCase();
+        const isTransport = low.includes("not modified") || low.includes("not found") || low.includes("can't be edited") || low.includes("cannot be edited") || low.includes("not enough rights") || low.includes("429") || low.includes("retry after");
+        if (!isTransport) {
           turn.activityDrainFailures += 1;
           process.stderr.write(`telegram gateway: activity-summary drain failed: ${msg} (chat=${chat} thread=${thread ?? "-"} replyAnchor=${turn.sourceMessageId ?? "none"} everOpened=${turn.activityEverOpened} failures=${turn.activityDrainFailures})
 `);
@@ -82558,7 +82991,12 @@ function clearActivitySummary(turn, finalHtmlOverride) {
       try {
         await robustApiCall(() => bot.api.deleteMessage(chat, id), { chat_id: chat, ...thread != null ? { threadId: thread } : {}, verb: "activity-summary.delete" });
       } catch (err) {
-        process.stderr.write(`telegram gateway: activity-summary delete failed: ${err}
+        const msg = err instanceof Error ? err.message : String(err);
+        const low = msg.toLowerCase();
+        if (low.includes("not modified") || low.includes("not found") || low.includes("not enough rights") || low.includes("429") || low.includes("retry after")) {
+          return;
+        }
+        process.stderr.write(`telegram gateway: activity-summary delete failed: ${msg}
 `);
       }
       return;
@@ -82580,10 +83018,12 @@ function clearActivitySummary(turn, finalHtmlOverride) {
       await robustApiCall(() => bot.api.editMessageText(chat, id, richMessage2(finalHtml), {}), { chat_id: chat, ...thread != null ? { threadId: thread } : {}, verb: "activity-summary.finalize" });
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
-      if (!msg.includes("message is not modified")) {
-        process.stderr.write(`telegram gateway: activity-summary finalize failed: ${msg}
-`);
+      const low = msg.toLowerCase();
+      if (low.includes("not modified") || low.includes("not found") || low.includes("can't be edited") || low.includes("cannot be edited") || low.includes("not enough rights") || low.includes("429") || low.includes("retry after")) {
+        return;
       }
+      process.stderr.write(`telegram gateway: activity-summary finalize failed: ${msg}
+`);
     }
   });
 }
@@ -84192,12 +84632,19 @@ ${preBlock(write.output)}`;
   }
   const originTurnId = deriveTurnId(chat_id, messageThreadId ?? null, msgId);
   const topicScope = TOPIC_FRAMING_ENABLED && messageThreadId != null ? "This message belongs to the current topic only \u2014 answer ONLY this question, in this topic. Do not also answer a pending message from another topic." : undefined;
+  const rawUser = from.username ?? String(from.id);
+  const displayUser = safeResolvePersonName(PERSON_DIRECTORY, {
+    telegramId: String(from.id),
+    username: from.username,
+    isDm: isDmChatId(chat_id),
+    groupAllowFrom: access.groups[chat_id]?.allowFrom
+  }, rawUser);
   const inboundMsg = {
     type: "inbound",
     chatId: chat_id,
     ...messageThreadId != null ? { threadId: messageThreadId } : {},
     messageId: msgId ?? 0,
-    user: from.username ?? String(from.id),
+    user: displayUser,
     userId: from.id,
     ts: ctx.message?.date ?? Math.floor(Date.now() / 1000),
     text: effectiveText,
@@ -84212,7 +84659,7 @@ ${preBlock(write.output)}`;
     meta: {
       chat_id,
       ...msgId != null ? { message_id: String(msgId) } : {},
-      user: from.username ?? String(from.id),
+      user: displayUser,
       user_id: String(from.id),
       ts: new Date((ctx.message?.date ?? 0) * 1000).toISOString(),
       ...messageThreadId != null ? { message_thread_id: String(messageThreadId) } : {},
@@ -87729,14 +88176,14 @@ _Tap /auth to see updated quota for the new active account._`), {}), { chat_id:
       const probeResp = state4.accounts.length > 0 ? await client3.probeQuota(state4.accounts.map((a) => a.label), undefined, true).catch(() => ({ results: [] })) : { results: [] };
       const { quotas, staleCachedAtMs } = zipProbeResults(state4.accounts.map((a) => a.label), probeResp.results);
       const tz = process.env.SWITCHROOM_TIMEZONE ?? process.env.TZ ?? "UTC";
-      const { renderAuthSnapshotFormat2: renderAuthSnapshotFormat23, buildSnapshotsFromState: buildSnapshotsFromState4, buildSnapshotKeyboard: buildSnapshotKeyboard3 } = await Promise.resolve().then(() => (init_auth_snapshot_format(), exports_auth_snapshot_format));
+      const { renderAuthSnapshotFormat2: renderAuthSnapshotFormat23, buildSnapshotsFromState: buildSnapshotsFromState4, buildSnapshotKeyboard: buildSnapshotKeyboard3 } = await Promise.resolve().then(() => (init_auth_snapshot_format2(), exports_auth_snapshot_format));
       const snapshots = buildSnapshotsFromState4(state4, quotas);
       const renderNow = new Date;
       const text5 = renderAuthSnapshotFormat23(snapshots, {
         tz,
         now: renderNow,
         demo: refreshDemo,
-        ...staleCachedAtMs != null ? { staleCachedAtMs } : { liveProbedAtMs: renderNow.getTime() }
+        ...staleCachedAtMs != null ? { staleCachedAtMs } : probeResp.results.length > 0 ? { liveProbedAtMs: renderNow.getTime() } : { probeFailed: true }
       });
       const kbRows = buildSnapshotKeyboard3(snapshots, { now: renderNow, demo: refreshDemo });
       const inline_keyboard = kbRows.map((row) => row.map((b) => {
@@ -88118,16 +88565,17 @@ bot.command("usage", async (ctx) => {
     if (client3) {
       const state4 = await client3.listState();
       if (state4.accounts.length > 0) {
+        const renderNow = new Date;
         const probeResp = await client3.probeQuota(state4.accounts.map((a) => a.label)).catch(() => ({ results: [] }));
         const { quotas, staleCachedAtMs } = zipProbeResults(state4.accounts.map((a) => a.label), probeResp.results);
-        const { renderAuthSnapshotFormat2: renderAuthSnapshotFormat23, buildSnapshotsFromState: buildSnapshotsFromState4, buildSnapshotKeyboard: buildSnapshotKeyboard3 } = await Promise.resolve().then(() => (init_auth_snapshot_format(), exports_auth_snapshot_format));
-        const tz = process.env.SWITCHROOM_TIMEZONE ?? process.env.TZ ?? "UTC";
+        const { buildSnapshotsFromState: buildSnapshotsFromState4, buildSnapshotKeyboard: buildSnapshotKeyboard3 } = await Promise.resolve().then(() => (init_auth_snapshot_format2(), exports_auth_snapshot_format));
+        const { renderUsageCard: renderUsageCard2 } = await Promise.resolve().then(() => (init_quota_bar_format(), exports_quota_bar_format));
         const snapshots = buildSnapshotsFromState4(state4, quotas);
-        const text5 = renderAuthSnapshotFormat23(snapshots, {
-          tz,
-          now: new Date,
+        const exhaustedByLabel = new Map(state4.accounts.map((a) => [a.label, a.exhausted]));
+        const text5 = renderUsageCard2(snapshots, exhaustedByLabel, {
+          now: renderNow,
           demo,
-          ...staleCachedAtMs != null ? { staleCachedAtMs } : { liveProbedAtMs: Date.now() }
+          ...staleCachedAtMs != null ? { staleCachedAtMs } : probeResp.results.length > 0 ? { liveProbedAtMs: renderNow.getTime() } : { probeFailed: true }
         });
         const kbRows = buildSnapshotKeyboard3(snapshots, { now: new Date, demo });
         const keyboard = new import_grammy12.InlineKeyboard;
@@ -89970,6 +90418,21 @@ var didOneTimeSetup = false;
 `);
       if (!didOneTimeSetup) {
         didOneTimeSetup = true;
+        {
+          const bootCheck = runPersonDirectoryBootCheck(readPeopleFile);
+          PERSON_DIRECTORY = bootCheck.directory;
+          process.stderr.write(bootCheck.logLine + `
+`);
+          if (bootCheck.alertDetail != null) {
+            emitGatewayOperatorEvent({
+              kind: "config-warning",
+              agent: process.env.SWITCHROOM_AGENT_NAME ?? "-",
+              detail: bootCheck.alertDetail,
+              suggestedActions: [],
+              firstSeenAt: new Date
+            });
+          }
+        }
         registerSwitchroomBotCommands().catch(() => {});
         try {
           const accessAtBoot = loadAccess();
@@ -90459,8 +90922,8 @@ var didOneTimeSetup = false;
                     orphanStatusEnabled
                   });
                   if (surface === "worker-feed") {
-                    const origin = resolveSubagentOriginChat(agentId);
-                    const wkChat = origin?.chatId || fleetChatId || (loadAccess().allowFrom[0] ?? "");
+                    const wk = resolveWorkerFeedChat(agentId, fleetChatId);
+                    const wkChat = wk.chatId;
                     workerActivityFeed?.update(agentId, wkChat, {
                       description: dispatch.feedDescription,
                       lastTool,
@@ -90468,7 +90931,7 @@ var didOneTimeSetup = false;
                       latestSummary: stepLine,
                       elapsedMs,
                       state: "running"
-                    }, origin?.threadId)?.then(() => reconcileWorkerPin(agentId, wkChat, true));
+                    }, wk.threadId)?.then(() => reconcileWorkerPin(agentId, wkChat, true));
                     return;
                   }
                   if (surface !== "nest")
@@ -90517,8 +90980,8 @@ var didOneTimeSetup = false;
                   stampTurn.subagentActivityAt = Date.now();
                 }
                 if (workerFeedEnabled) {
-                  const origin = resolveSubagentOriginChat(agentId);
-                  const wkChat = origin?.chatId || fleetChatId || (loadAccess().allowFrom[0] ?? "");
+                  const wk = resolveWorkerFeedChat(agentId, fleetChatId);
+                  const wkChat = wk.chatId;
                   workerActivityFeed?.update(agentId, wkChat, {
                     description: dispatch.feedDescription,
                     lastTool,
@@ -90526,7 +90989,7 @@ var didOneTimeSetup = false;
                     latestSummary: stepLine,
                     elapsedMs,
                     state: "running"
-                  }, origin?.threadId)?.then(() => reconcileWorkerPin(agentId, wkChat, true));
+                  }, wk.threadId)?.then(() => reconcileWorkerPin(agentId, wkChat, true));
                   return;
                 }
                 const progressOrigin = resolveSubagentOriginChat(agentId);