@integrity-labs/agt-cli 0.28.449 → 0.28.451

package/dist/mcp/telegram-channel.js

@@ -18870,7 +18870,7 @@ var require_filters = __commonJS({
       return r.copySafeness(str, res);
     }
     _exports.indent = indent;
-    function join16(arr, del, attr) {
+    function join17(arr, del, attr) {
       del = del || "";
       if (attr) {
         arr = lib.map(arr, function(v) {
@@ -18879,7 +18879,7 @@ var require_filters = __commonJS({
       }
       return arr.join(del);
     }
-    _exports.join = join16;
+    _exports.join = join17;
     function last(arr) {
       return arr[arr.length - 1];
     }
@@ -22480,11 +22480,11 @@ async function waitForResolution(cfg, callbackId, opts) {
       }
     } catch {
     }
-    await sleep(interval);
+    await sleep2(interval);
   }
   return { kind: "timeout" };
 }
-function sleep(ms) {
+function sleep2(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 function generateOptionToken() {
@@ -30085,7 +30085,7 @@ var StdioServerTransport = class {
 
 // src/telegram-channel.ts
 import https from "https";
-import { createHash as createHash2, randomUUID as randomUUID3 } from "crypto";
+import { createHash as createHash3, randomUUID as randomUUID3 } from "crypto";
 import {
   closeSync,
   createWriteStream,
@@ -30093,18 +30093,18 @@ import {
   ftruncateSync,
   mkdirSync as mkdirSync9,
   openSync,
-  readFileSync as readFileSync15,
-  readdirSync as readdirSync4,
+  readFileSync as readFileSync16,
+  readdirSync as readdirSync5,
   realpathSync,
   renameSync as renameSync7,
-  statSync as statSync3,
+  statSync as statSync4,
   unlinkSync as unlinkSync8,
   watch,
   writeFileSync as writeFileSync11,
   writeSync
 } from "fs";
-import { homedir as homedir6 } from "os";
-import { basename, extname, join as join15, resolve as resolve2 } from "path";
+import { homedir as homedir7 } from "os";
+import { basename, extname, join as join16, resolve as resolve2 } from "path";
 
 // src/channel-attachments.ts
 import { homedir } from "os";
@@ -30695,6 +30695,40 @@ function resolveGhostReplyMode(opts) {
   if (cached2 !== void 0) return cached2;
   return "off";
 }
+var USAGE_LIMIT_REACTIVE_FLAG_KEY = "usage-limit-reactive-notice";
+function parseUsageLimitReactiveMode(raw) {
+  if (raw === void 0) return void 0;
+  const v = raw.trim().toLowerCase();
+  if (v === "") return void 0;
+  if (v === "off" || v === "shadow" || v === "enforce") return v;
+  const b = envBoolean(raw);
+  if (b === true) return "enforce";
+  if (b === false) return "off";
+  return void 0;
+}
+function cachedUsageLimitReactiveMode(path) {
+  try {
+    if (!existsSync2(path)) return void 0;
+    const parsed = JSON.parse(readFileSync3(path, "utf8"));
+    if (!parsed || typeof parsed !== "object") return void 0;
+    const flags = parsed.flags;
+    if (!flags || typeof flags !== "object") return void 0;
+    const value = flags[USAGE_LIMIT_REACTIVE_FLAG_KEY];
+    if (typeof value === "string") return parseUsageLimitReactiveMode(value);
+    if (typeof value === "boolean") return value ? "enforce" : "off";
+    return void 0;
+  } catch {
+    return void 0;
+  }
+}
+function resolveUsageLimitReactiveMode(opts) {
+  const env2 = opts?.env ?? process.env;
+  const modeOverride = parseUsageLimitReactiveMode(env2["AGT_USAGE_LIMIT_REACTIVE_MODE"]);
+  if (modeOverride !== void 0) return modeOverride;
+  const cached2 = cachedUsageLimitReactiveMode(opts?.cachePath ?? defaultFlagsCachePath());
+  if (cached2 !== void 0) return cached2;
+  return "off";
+}
 
 // src/maintenance-mode.ts
 var FLAG_KEY = "platform-maintenance-mode";
@@ -34036,7 +34070,113 @@ var BANNER_PATTERNS = [
   // pct=100.
   new RegExp(`${SUBJECT}hit\\s+your\\s+(?:[a-z0-9-]+\\s+)?limit${SEP}resets\\s+(${RESET_DATE})`, "i")
 ];
+function parseUsageBanner(text, now = /* @__PURE__ */ new Date()) {
+  let bestIndex = -1;
+  let best = null;
+  for (let i = 0; i < BANNER_PATTERNS.length; i++) {
+    const pattern = new RegExp(BANNER_PATTERNS[i].source, "gi");
+    let match;
+    while ((match = pattern.exec(text)) !== null) {
+      if (match.index === pattern.lastIndex)
+        pattern.lastIndex++;
+      let pct;
+      let resetStr;
+      if (i === 0) {
+        pct = Number.parseInt(match[1], 10);
+        resetStr = match[2];
+      } else {
+        pct = 100;
+        resetStr = match[1];
+      }
+      if (!Number.isFinite(pct) || pct < 0 || pct > 100)
+        continue;
+      const nextChar = text[match.index + match[0].length];
+      if (nextChar !== void 0 && /[A-Za-z0-9]/.test(nextChar))
+        continue;
+      const weekResetsAt = parseResetDateTime(resetStr, now);
+      if (!weekResetsAt)
+        continue;
+      if (match.index >= bestIndex) {
+        bestIndex = match.index;
+        best = { pct, weekResetsAt };
+      }
+    }
+  }
+  return best;
+}
+var MONTHS = [
+  "jan",
+  "feb",
+  "mar",
+  "apr",
+  "may",
+  "jun",
+  "jul",
+  "aug",
+  "sep",
+  "oct",
+  "nov",
+  "dec"
+];
+var TIME_TAIL = /,\s*(\d{1,2})(?::(\d{2}))?\s*(am|pm)(?:\s*\(?UTC\)?)?\s*$/i;
+var TIME_ONLY = /^(\d{1,2})(?::(\d{2}))?\s*(am|pm)(?:\s*\(?UTC\)?)?$/i;
 var MS_PER_DAY = 24 * 60 * 60 * 1e3;
+function parseAmPm(hourStr, minStr, ampm) {
+  const rawHour = Number.parseInt(hourStr, 10);
+  if (!Number.isFinite(rawHour) || rawHour < 1 || rawHour > 12)
+    return null;
+  let minute = 0;
+  if (minStr) {
+    minute = Number.parseInt(minStr, 10);
+    if (!Number.isFinite(minute) || minute < 0 || minute > 59)
+      return null;
+  }
+  const isPm = ampm.toLowerCase() === "pm";
+  return { hour: rawHour % 12 + (isPm ? 12 : 0), minute };
+}
+function parseResetDateTime(humanDate, now) {
+  const trimmed = humanDate.trim();
+  const timeOnly = trimmed.match(TIME_ONLY);
+  if (timeOnly) {
+    const hm = parseAmPm(timeOnly[1], timeOnly[2], timeOnly[3]);
+    if (!hm)
+      return null;
+    const todayAt = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate(), hm.hour, hm.minute);
+    return new Date(todayAt <= now.getTime() ? todayAt + MS_PER_DAY : todayAt);
+  }
+  const timeMatch = trimmed.match(TIME_TAIL);
+  const dateOnly = timeMatch ? trimmed.slice(0, timeMatch.index).trim() : trimmed;
+  const parts = dateOnly.split(/\s+/);
+  if (parts.length !== 2)
+    return null;
+  const month = MONTHS.indexOf(parts[0].slice(0, 3).toLowerCase());
+  if (month < 0)
+    return null;
+  const day = Number.parseInt(parts[1], 10);
+  if (!Number.isFinite(day) || day < 1 || day > 31)
+    return null;
+  let hour = 0;
+  let minute = 0;
+  if (timeMatch) {
+    const hm = parseAmPm(timeMatch[1], timeMatch[2], timeMatch[3]);
+    if (!hm)
+      return null;
+    hour = hm.hour;
+    minute = hm.minute;
+  }
+  const baseYear = now.getUTCFullYear();
+  let resolved = null;
+  let bestDelta = Number.POSITIVE_INFINITY;
+  for (const y of [baseYear - 1, baseYear, baseYear + 1]) {
+    const candidate = new Date(Date.UTC(y, month, day, hour, minute));
+    const delta = Math.abs(candidate.getTime() - now.getTime());
+    if (delta < bestDelta) {
+      bestDelta = delta;
+      resolved = candidate;
+    }
+  }
+  return resolved;
+}
 
 // ../core/dist/claude-code-usage/usage-limit-marker.js
 var USAGE_LIMIT_MARKER_FILENAME = "claude-usage-limit.json";
@@ -34081,6 +34221,101 @@ var UNKNOWN_RATE_LIMIT = Object.freeze({
   resetsAt: null,
   text: null
 });
+function contentText(record2) {
+  const candidates = [record2.content];
+  const message = record2.message;
+  if (typeof message === "object" && message !== null) {
+    candidates.push(message.content);
+  }
+  const parts = [];
+  for (const candidate of candidates) {
+    if (typeof candidate === "string") {
+      if (candidate)
+        parts.push(candidate);
+      continue;
+    }
+    if (!Array.isArray(candidate))
+      continue;
+    for (const block of candidate) {
+      if (typeof block === "string") {
+        if (block)
+          parts.push(block);
+        continue;
+      }
+      if (typeof block !== "object" || block === null)
+        continue;
+      const text = block.text;
+      if (typeof text === "string" && text)
+        parts.push(text);
+    }
+  }
+  const joined = parts.join("\n").trim();
+  return joined ? joined : null;
+}
+function classifyTranscriptLine(line, startMs, endMs, now) {
+  const trimmed = line.trim();
+  if (!trimmed)
+    return null;
+  let obj;
+  try {
+    obj = JSON.parse(trimmed);
+  } catch {
+    return null;
+  }
+  if (typeof obj !== "object" || obj === null)
+    return null;
+  const record2 = obj;
+  if (record2.type !== "assistant")
+    return null;
+  const ts = record2.timestamp;
+  if (typeof ts !== "string" || !ts)
+    return null;
+  const tsMs = new Date(ts).getTime();
+  if (!Number.isFinite(tsMs) || tsMs < startMs || tsMs > endMs)
+    return null;
+  if (record2.error === "rate_limit" || record2.apiErrorStatus === 429) {
+    const text = contentText(record2);
+    const observation = text ? parseUsageBanner(text, now ?? new Date(endMs)) : null;
+    return { verdict: "capped", atMs: tsMs, resetsAt: observation?.weekResetsAt ?? null, text };
+  }
+  if (record2.isApiErrorMessage === true)
+    return null;
+  const message = record2.message;
+  if (typeof message !== "object" || message === null)
+    return null;
+  const msg = message;
+  if (msg.model === "<synthetic>")
+    return null;
+  const usage = msg.usage;
+  if (typeof usage !== "object" || usage === null)
+    return null;
+  const u = usage;
+  const spent = Number(u.input_tokens ?? 0) + Number(u.output_tokens ?? 0) + Number(u.cache_creation_input_tokens ?? 0) + Number(u.cache_read_input_tokens ?? 0);
+  if (!Number.isFinite(spent) || spent <= 0)
+    return null;
+  return { verdict: "serving", atMs: tsMs, resetsAt: null, text: null };
+}
+function pickNewerClassification(current, next) {
+  if (next.verdict === "unknown")
+    return current;
+  if (current.verdict === "unknown")
+    return next;
+  return next.atMs >= current.atMs ? next : current;
+}
+function classifyTranscriptRateLimit(jsonl, startMs, endMs, now) {
+  let newest = UNKNOWN_RATE_LIMIT;
+  for (const line of jsonl.split("\n")) {
+    const classified = classifyTranscriptLine(line, startMs, endMs, now);
+    if (classified)
+      newest = pickNewerClassification(newest, classified);
+  }
+  return newest;
+}
+
+// ../core/dist/claude-code-usage/transcript-location.js
+function encodeClaudeProjectPath(projectDir) {
+  return "-" + projectDir.replace(/^\//, "").replace(/[/.]/g, "-");
+}
 
 // ../core/dist/account-enforcement/marker.js
 var ACCOUNT_ENFORCEMENT_MARKER_FILENAME = "account-enforcement.json";
@@ -37099,11 +37334,102 @@ function emitToolCallMarkupRedactionTelemetry(channel) {
   }
 }
 
+// src/rate-limit-watch.ts
+import { readFileSync as readFileSync11, readdirSync, statSync } from "fs";
+import { homedir as homedir5 } from "os";
+import { join as join9 } from "path";
+var DEFAULT_WATCH_MS = 5e3;
+var DEFAULT_POLL_MS = 400;
+function agentTranscriptDir(opts) {
+  const cwd = opts?.cwd ?? process.cwd();
+  const home = opts?.home ?? homedir5();
+  return join9(home, ".claude", "projects", encodeClaudeProjectPath(cwd));
+}
+function classifyTranscriptSince(opts) {
+  const dir = opts.transcriptDir ?? agentTranscriptDir({ cwd: opts.cwd, home: opts.home });
+  let entries;
+  try {
+    entries = readdirSync(dir);
+  } catch {
+    return UNKNOWN_RATE_LIMIT;
+  }
+  let newest = UNKNOWN_RATE_LIMIT;
+  for (const name of entries) {
+    if (!name.endsWith(".jsonl")) continue;
+    const path = join9(dir, name);
+    try {
+      const st = statSync(path);
+      if (!st.isFile() || st.mtimeMs < opts.sinceMs) continue;
+    } catch {
+      continue;
+    }
+    let content;
+    try {
+      content = readFileSync11(path, "utf-8");
+    } catch {
+      continue;
+    }
+    newest = pickNewerClassification(
+      newest,
+      classifyTranscriptRateLimit(content, opts.sinceMs, opts.nowMs, new Date(opts.nowMs))
+    );
+  }
+  return newest;
+}
+var sleep = (ms) => new Promise((resolve3) => setTimeout(resolve3, ms));
+async function watchForRateLimitRefusal(opts) {
+  const now = opts.now ?? (() => Date.now());
+  const wait = opts.wait ?? sleep;
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_WATCH_MS;
+  const pollMs = opts.pollMs ?? DEFAULT_POLL_MS;
+  const deadline = now() + timeoutMs;
+  for (; ; ) {
+    let result;
+    try {
+      result = classifyTranscriptSince({
+        sinceMs: opts.sinceMs,
+        nowMs: now(),
+        transcriptDir: opts.transcriptDir,
+        cwd: opts.cwd,
+        home: opts.home
+      });
+    } catch {
+      return null;
+    }
+    if (result.verdict === "capped") return result;
+    if (result.verdict === "serving") return null;
+    if (now() >= deadline) return null;
+    await wait(pollMs);
+  }
+}
+
+// src/usage-limit-reactive-decision.ts
+import { createHash } from "crypto";
+function shouldReadPredictiveMarker(mode) {
+  return mode !== "enforce";
+}
+function armedWatchMode(opts) {
+  if (opts.mode === "off") return null;
+  if (opts.isBot || !opts.replyOwed) return null;
+  return opts.mode;
+}
+function decideRefusalAction(opts) {
+  const { refusal } = opts;
+  if (!refusal || refusal.verdict !== "capped") return "none";
+  if (!refusal.resetsAt) return "missing-reset";
+  return opts.mode === "shadow" ? "shadow-log" : "notify";
+}
+function describeUnparsedRefusal(text) {
+  if (!text) return "refusal=absent";
+  const hash = createHash("sha256").update(text).digest("hex").slice(0, 12);
+  return `refusal_hash=${hash} refusal_len=${text.length}`;
+}
+
 // src/reply-intent-runtime.ts
 import { execFile as execFile2 } from "child_process";
 import { existsSync as existsSync5, mkdirSync as mkdirSync6, writeFileSync as writeFileSync7 } from "fs";
-import { homedir as homedir5 } from "os";
-import { join as join9 } from "path";
+import { homedir as homedir6 } from "os";
+import { join as join10 } from "path";
 var DEFAULT_CLAUDE_EVAL_MODEL = "claude-haiku-4-5-20251001";
 var DEFAULT_ANTHROPIC_MESSAGES_URL = "https://api.anthropic.com/v1/messages";
 var ANTHROPIC_API_VERSION = "2023-06-01";
@@ -37202,12 +37528,12 @@ async function runAnthropicMessages(prompt, opts) {
 var emptyMcpConfigPath = null;
 function ensureEmptyMcpConfig() {
   if (emptyMcpConfigPath && existsSync5(emptyMcpConfigPath)) return emptyMcpConfigPath;
-  const dir = join9(homedir5(), ".augmented");
+  const dir = join10(homedir6(), ".augmented");
   try {
     mkdirSync6(dir, { recursive: true });
   } catch {
   }
-  const p2 = join9(dir, ".reply-intent-empty-mcp.json");
+  const p2 = join10(dir, ".reply-intent-empty-mcp.json");
   writeFileSync7(p2, JSON.stringify({ mcpServers: {} }));
   emptyMcpConfigPath = p2;
   return p2;
@@ -37232,7 +37558,7 @@ function runClaudeP(prompt, model) {
     execFile2(
       "claude",
       args,
-      { cwd: homedir5(), timeout: CLASSIFY_TIMEOUT_MS, maxBuffer: 1 << 20 },
+      { cwd: homedir6(), timeout: CLASSIFY_TIMEOUT_MS, maxBuffer: 1 << 20 },
       (err, stdout) => {
         if (err) {
           reject(err);
@@ -37354,17 +37680,17 @@ function emitTransientApiErrorTelemetry(channel, match, original) {
 }
 
 // src/telegram-pending-inbound-cleanup.ts
-import { readdirSync, readFileSync as readFileSync11, statSync } from "fs";
-import { join as join10 } from "path";
+import { readdirSync as readdirSync2, readFileSync as readFileSync12, statSync as statSync2 } from "fs";
+import { join as join11 } from "path";
 function markerArrivalMs(fullPath) {
   try {
-    const received = JSON.parse(readFileSync11(fullPath, "utf-8")).received_at;
+    const received = JSON.parse(readFileSync12(fullPath, "utf-8")).received_at;
     const parsed = received ? Date.parse(received) : Number.NaN;
     if (Number.isFinite(parsed)) return parsed;
   } catch {
   }
   try {
-    return statSync(fullPath).mtimeMs;
+    return statSync2(fullPath).mtimeMs;
   } catch {
     return Number.POSITIVE_INFINITY;
   }
@@ -37380,7 +37706,7 @@ function applyToChatMarkers(pendingDir, chatId, op, cutoffMs) {
   const bounded = Number.isFinite(cutoffMs);
   let filenames;
   try {
-    filenames = readdirSync(pendingDir);
+    filenames = readdirSync2(pendingDir);
   } catch {
     return 0;
   }
@@ -37388,7 +37714,7 @@ function applyToChatMarkers(pendingDir, chatId, op, cutoffMs) {
   for (const filename of filenames) {
     if (!filename.startsWith(prefix)) continue;
     if (!filename.endsWith(".json")) continue;
-    const fullPath = join10(pendingDir, filename);
+    const fullPath = join11(pendingDir, filename);
     if (bounded && markerArrivalMs(fullPath) > cutoffMs) continue;
     op(fullPath);
     applied++;
@@ -37398,12 +37724,12 @@ function applyToChatMarkers(pendingDir, chatId, op, cutoffMs) {
 
 // src/recovery-ledger.ts
 import { existsSync as existsSync6, unlinkSync as unlinkSync6 } from "fs";
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 function recoveryLedgerEntryExists(ledgerDir, markerName, exists = (p2) => existsSync6(p2)) {
   if (!ledgerDir || !markerName) return false;
   if (markerName.includes("/") || markerName.includes("\\") || markerName.includes("..")) return false;
   try {
-    return exists(join11(ledgerDir, markerName));
+    return exists(join12(ledgerDir, markerName));
   } catch {
     return false;
   }
@@ -37414,14 +37740,14 @@ function removeRecoveryLedgerEntry(ledgerDir, markerName, unlink = (p2) => {
   if (!ledgerDir || !markerName) return;
   if (markerName.includes("/") || markerName.includes("\\") || markerName.includes("..")) return;
   try {
-    unlink(join11(ledgerDir, markerName));
+    unlink(join12(ledgerDir, markerName));
   } catch {
   }
 }
 
 // src/inbound-delivery-ledger.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync7, readdirSync as readdirSync2, readFileSync as readFileSync12, renameSync as renameSync5, writeFileSync as writeFileSync8 } from "fs";
-import { join as join12 } from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync7, readdirSync as readdirSync3, readFileSync as readFileSync13, renameSync as renameSync5, writeFileSync as writeFileSync8 } from "fs";
+import { join as join13 } from "path";
 function safeInboundId(inboundId) {
   return inboundId.replace(/[^A-Za-z0-9_-]/g, "_");
 }
@@ -37429,8 +37755,8 @@ var defaultDeps = {
   mkdir: (dir) => mkdirSync7(dir, { recursive: true }),
   writeFile: (path, data) => writeFileSync8(path, data, "utf8"),
   rename: (from, to) => renameSync5(from, to),
-  readdir: (dir) => readdirSync2(dir),
-  readFile: (path) => readFileSync12(path, "utf8"),
+  readdir: (dir) => readdirSync3(dir),
+  readFile: (path) => readFileSync13(path, "utf8"),
   exists: (path) => existsSync7(path)
 };
 function writeInboundDeliveryLedgerEntry(dir, record2, deps = defaultDeps) {
@@ -37439,7 +37765,7 @@ function writeInboundDeliveryLedgerEntry(dir, record2, deps = defaultDeps) {
   if (!safe || safe.includes("/") || safe.includes("\\") || safe.includes("..")) return;
   try {
     deps.mkdir(dir);
-    const final = join12(dir, `${safe}.json`);
+    const final = join13(dir, `${safe}.json`);
     const tmp = `${final}.tmp`;
     deps.writeFile(tmp, JSON.stringify(record2));
     deps.rename(tmp, final);
@@ -37448,10 +37774,10 @@ function writeInboundDeliveryLedgerEntry(dir, record2, deps = defaultDeps) {
 }
 
 // src/channel-inbound-id.ts
-import { createHash } from "crypto";
+import { createHash as createHash2 } from "crypto";
 var INBOUND_ID_HEX_LEN = 12;
 function hashInboundId(payload) {
-  const digest = createHash("sha256").update(payload).digest("hex").slice(0, INBOUND_ID_HEX_LEN);
+  const digest = createHash2("sha256").update(payload).digest("hex").slice(0, INBOUND_ID_HEX_LEN);
   return `ib_${digest}`;
 }
 function telegramInboundId(chatId, messageId) {
@@ -37644,14 +37970,14 @@ function createKanbanCardActiveClient(args) {
 import {
   existsSync as existsSync8,
   mkdirSync as mkdirSync8,
-  readFileSync as readFileSync13,
+  readFileSync as readFileSync14,
   renameSync as renameSync6,
-  statSync as statSync2,
+  statSync as statSync3,
   unlinkSync as unlinkSync7,
   utimesSync,
   writeFileSync as writeFileSync9
 } from "fs";
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 var STALE_LOCK_MS = 9e4;
 var HEARTBEAT_INTERVAL_MS = 3e4;
 function defaultIsPidAlive(pid) {
@@ -37674,7 +38000,7 @@ function acquireMcpSpawnLock(args) {
   const nowMs = options.nowMs ?? (() => Date.now());
   const lockMtimeMs = options.lockMtimeMs ?? defaultLockMtimeMs;
   const staleMs = options.staleMs ?? STALE_LOCK_MS;
-  const path = join13(agentDir, basename2);
+  const path = join14(agentDir, basename2);
   const existing = readLockHolder(path);
   if (existing) {
     if (existing.pid === selfPid) {
@@ -37733,7 +38059,7 @@ function startMcpSpawnLockHeartbeat(lockPath, opts = {}) {
 }
 function defaultLockMtimeMs(path) {
   try {
-    return statSync2(path).mtimeMs;
+    return statSync3(path).mtimeMs;
   } catch {
     return null;
   }
@@ -37741,7 +38067,7 @@ function defaultLockMtimeMs(path) {
 function readLockHolder(path) {
   if (!existsSync8(path)) return null;
   try {
-    const raw = readFileSync13(path, "utf8");
+    const raw = readFileSync14(path, "utf8");
     const parsed = JSON.parse(raw);
     const pid = typeof parsed.pid === "number" ? parsed.pid : Number(parsed.pid);
     if (!Number.isFinite(pid) || pid <= 0) return null;
@@ -37753,8 +38079,8 @@ function readLockHolder(path) {
 }
 
 // src/ack-reaction.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync14, writeFileSync as writeFileSync10 } from "fs";
-import { join as join14 } from "path";
+import { readdirSync as readdirSync4, readFileSync as readFileSync15, writeFileSync as writeFileSync10 } from "fs";
+import { join as join15 } from "path";
 var REPLY_WEDGED_THRESHOLD_MS = 5 * 60 * 1e3;
 var ACK_STARTUP_GRACE_MS = 6e4;
 var ACK_PANE_FRESH_THRESHOLD_MS = 6e4;
@@ -37827,7 +38153,7 @@ var GIVE_UP_SIGNAL_MAX_AGE_MS = 30 * 60 * 1e3;
 function readGiveUpSignal(path, now = Date.now()) {
   if (!path) return null;
   try {
-    const raw = JSON.parse(readFileSync14(path, "utf8"));
+    const raw = JSON.parse(readFileSync15(path, "utf8"));
     if (typeof raw.gave_up_at !== "string") return null;
     const t = Date.parse(raw.gave_up_at);
     if (!Number.isFinite(t) || t > now) return null;
@@ -37853,7 +38179,7 @@ function oldestPendingMarkerAgeMs(dir, now = Date.now(), opts) {
   if (!dir) return null;
   let names;
   try {
-    names = readdirSync3(dir);
+    names = readdirSync4(dir);
   } catch {
     return null;
   }
@@ -37862,7 +38188,7 @@ function oldestPendingMarkerAgeMs(dir, now = Date.now(), opts) {
     if (!name.endsWith(".json")) continue;
     let receivedAt;
     try {
-      const raw = JSON.parse(readFileSync14(join14(dir, name), "utf-8"));
+      const raw = JSON.parse(readFileSync15(join15(dir, name), "utf-8"));
       if (raw.discretionary === true) continue;
       if (!opts?.includeSeen && typeof raw.seen_at === "string" && raw.seen_at) continue;
       receivedAt = raw.received_at;
@@ -37939,14 +38265,14 @@ function isMarkerGenuinelyAged(receivedAt, nowMs, thresholdMs) {
 }
 var DEFLECTION_COUNTER_SUFFIX = "-deflections.json";
 function deflectionCounterPath(agentDir, channel) {
-  return join14(agentDir, `${channel}${DEFLECTION_COUNTER_SUFFIX}`);
+  return join15(agentDir, `${channel}${DEFLECTION_COUNTER_SUFFIX}`);
 }
 function recordChannelDeflection(agentDir, channel, cause) {
   if (!agentDir) return;
   const path = deflectionCounterPath(agentDir, channel);
   let counts = {};
   try {
-    const parsed = JSON.parse(readFileSync14(path, "utf-8"));
+    const parsed = JSON.parse(readFileSync15(path, "utf-8"));
     if (parsed && typeof parsed === "object") counts = parsed;
   } catch {
   }
@@ -38023,11 +38349,11 @@ async function actuateHostRestart(opts) {
 
 // src/telegram-channel.ts
 function redactId(id) {
-  return createHash2("sha256").update(String(id)).digest("hex").slice(0, 8);
+  return createHash3("sha256").update(String(id)).digest("hex").slice(0, 8);
 }
 var BOT_TOKEN = process.env.TELEGRAM_BOT_TOKEN;
 var AGENT_CODE_NAME = process.env.AGT_AGENT_CODE_NAME ?? "unknown";
-var TELEGRAM_AGENT_DIR = AGENT_CODE_NAME && AGENT_CODE_NAME !== "unknown" ? join15(homedir6(), ".augmented", AGENT_CODE_NAME) : null;
+var TELEGRAM_AGENT_DIR = AGENT_CODE_NAME && AGENT_CODE_NAME !== "unknown" ? join16(homedir7(), ".augmented", AGENT_CODE_NAME) : null;
 var AGT_HOST = process.env.AGT_HOST ?? null;
 var AGT_API_KEY = process.env.AGT_API_KEY ?? null;
 var AGT_AGENT_ID = process.env.AGT_AGENT_ID ?? null;
@@ -38130,11 +38456,11 @@ var peerRateLimiter = peerRateApiClient && parsePeerAgentModeEnv(process.env.TEL
   log: (line) => process.stderr.write(`telegram-channel(${AGENT_CODE_NAME}): ${line}
 `)
 }) : createPeerRateLimiter();
-var PEER_PRESENCE_STATE_FILE = TELEGRAM_AGENT_DIR ? join15(TELEGRAM_AGENT_DIR, "telegram-peer-presence.json") : null;
+var PEER_PRESENCE_STATE_FILE = TELEGRAM_AGENT_DIR ? join16(TELEGRAM_AGENT_DIR, "telegram-peer-presence.json") : null;
 function readPeerPresenceState() {
   if (!PEER_PRESENCE_STATE_FILE) return null;
   try {
-    const parsed = JSON.parse(readFileSync15(PEER_PRESENCE_STATE_FILE, "utf-8"));
+    const parsed = JSON.parse(readFileSync16(PEER_PRESENCE_STATE_FILE, "utf-8"));
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
     return parsed;
   } catch {
@@ -38169,9 +38495,9 @@ if (!BOT_TOKEN) {
 var stderrLogStream = null;
 if (AGENT_CODE_NAME && AGENT_CODE_NAME !== "unknown") {
   try {
-    const logDir = join15(homedir6(), ".augmented", AGENT_CODE_NAME);
+    const logDir = join16(homedir7(), ".augmented", AGENT_CODE_NAME);
     mkdirSync9(logDir, { recursive: true });
-    stderrLogStream = createWriteStream(join15(logDir, "telegram-channel-stderr.log"), {
+    stderrLogStream = createWriteStream(join16(logDir, "telegram-channel-stderr.log"), {
       flags: "a",
       mode: 384
     });
@@ -38356,6 +38682,47 @@ async function maybeSendTelegramUsageLimitNotice(args) {
     );
   }
 }
+function armTelegramUsageLimitWatch(args) {
+  void (async () => {
+    try {
+      const refusal = await watchForRateLimitRefusal({ sinceMs: args.sinceMs });
+      const action = decideRefusalAction({ mode: args.mode, refusal });
+      if (action === "none") return;
+      if (action === "missing-reset") {
+        process.stderr.write(
+          `telegram-channel(${AGENT_CODE_NAME}): [usage-limit-reactive] mode=${args.mode} refusal detected for chat=${redactId(args.chatId)} but no reset time in it (${describeUnparsedRefusal(refusal?.text)}) - no notice
+`
+        );
+        return;
+      }
+      const resetsAt = refusal?.resetsAt;
+      if (!resetsAt) return;
+      if (action === "shadow-log") {
+        process.stderr.write(
+          `telegram-channel(${AGENT_CODE_NAME}): [usage-limit-reactive] mode=shadow WOULD notify chat=${redactId(args.chatId)} resets=${resetsAt.toISOString()}
+`
+        );
+        return;
+      }
+      await maybeSendTelegramUsageLimitNotice({
+        chatId: args.chatId,
+        senderId: args.senderId,
+        ...args.messageThreadId != null ? { messageThreadId: args.messageThreadId } : {},
+        limitedUntil: resetsAt
+      });
+      clearPendingMessage(args.chatId, args.sinceMs);
+      process.stderr.write(
+        `telegram-channel(${AGENT_CODE_NAME}): [usage-limit-reactive] reported refusal for chat=${redactId(args.chatId)} resets=${resetsAt.toISOString()}
+`
+      );
+    } catch (err) {
+      process.stderr.write(
+        `telegram-channel(${AGENT_CODE_NAME}): [usage-limit-reactive] watch failed for chat=${redactId(args.chatId)}: ${err.message}
+`
+      );
+    }
+  })();
+}
 var TELEGRAM_ACCOUNT_MUTE_NOTICE_CACHE = /* @__PURE__ */ new Map();
 async function maybeSendTelegramAccountMuteNotice(args) {
   if (args.senderId === void 0) return;
@@ -38567,7 +38934,7 @@ function scheduleBusyAck(chatId, messageId, arrivedWhileBusy) {
     let paneLogFreshAgeMs = null;
     if (AGENT_DIR) {
       try {
-        const paneMtimeMs = statSync3(join15(AGENT_DIR, "pane.log")).mtimeMs;
+        const paneMtimeMs = statSync4(join16(AGENT_DIR, "pane.log")).mtimeMs;
         paneLogFreshAgeMs = Math.max(0, Date.now() - paneMtimeMs);
       } catch {
       }
@@ -38597,7 +38964,7 @@ function scheduleBusyAck(chatId, messageId, arrivedWhileBusy) {
 function __resetBusyAckNoticeThrottle() {
   lastBusyAckNoticeAt.clear();
 }
-var RESTART_FLAGS_DIR = join15(homedir6(), ".augmented", "restart-flags");
+var RESTART_FLAGS_DIR = join16(homedir7(), ".augmented", "restart-flags");
 function actuateHostRestartTelegram() {
   return actuateHostRestart({
     agtHost: AGT_HOST,
@@ -38982,7 +39349,7 @@ async function handleRestartCommand(opts) {
       if (!existsSync9(RESTART_FLAGS_DIR)) {
         mkdirSync9(RESTART_FLAGS_DIR, { recursive: true });
       }
-      const flagPath = join15(RESTART_FLAGS_DIR, `${AGENT_CODE_NAME}.flag`);
+      const flagPath = join16(RESTART_FLAGS_DIR, `${AGENT_CODE_NAME}.flag`);
       const flag = {
         codeName: AGENT_CODE_NAME,
         source: "telegram",
@@ -39388,16 +39755,16 @@ async function classifyRestartCommand(text) {
   if (!ours) return "verification_failed";
   return target === ours ? "act" : "ignore";
 }
-var AGENT_DIR = AGENT_CODE_NAME && AGENT_CODE_NAME !== "unknown" ? join15(homedir6(), ".augmented", AGENT_CODE_NAME) : null;
-var PENDING_INBOUND_DIR = AGENT_DIR ? join15(AGENT_DIR, "telegram-pending-inbound") : null;
-var RECOVERY_OUTBOX_DIR = AGENT_DIR ? join15(AGENT_DIR, "telegram-recovery-outbox") : null;
-var RECOVERY_LEDGER_DIR = AGENT_DIR ? join15(AGENT_DIR, ".agt-telegram-recovery-ledger") : null;
-var DELIVERY_LEDGER_DIR = AGENT_DIR ? join15(AGENT_DIR, ".agt-inbound-delivery-ledger") : null;
-var RESTART_CONFIRM_FILE = AGENT_DIR ? join15(AGENT_DIR, "telegram-restart-confirm.json") : null;
+var AGENT_DIR = AGENT_CODE_NAME && AGENT_CODE_NAME !== "unknown" ? join16(homedir7(), ".augmented", AGENT_CODE_NAME) : null;
+var PENDING_INBOUND_DIR = AGENT_DIR ? join16(AGENT_DIR, "telegram-pending-inbound") : null;
+var RECOVERY_OUTBOX_DIR = AGENT_DIR ? join16(AGENT_DIR, "telegram-recovery-outbox") : null;
+var RECOVERY_LEDGER_DIR = AGENT_DIR ? join16(AGENT_DIR, ".agt-telegram-recovery-ledger") : null;
+var DELIVERY_LEDGER_DIR = AGENT_DIR ? join16(AGENT_DIR, ".agt-inbound-delivery-ledger") : null;
+var RESTART_CONFIRM_FILE = AGENT_DIR ? join16(AGENT_DIR, "telegram-restart-confirm.json") : null;
 var TELEGRAM_PROCESS_BOOT_MS = Date.now();
-var TELEGRAM_RECENT_DMS_FILE = AGENT_DIR ? join15(AGENT_DIR, "telegram-recent-dms.json") : null;
-var TELEGRAM_CHANNEL_ADD_RESTART_FILE = AGENT_DIR ? join15(AGENT_DIR, "telegram-channel-add-restart.json") : null;
-var TELEGRAM_OFFSET_FILE = AGENT_DIR ? join15(AGENT_DIR, "telegram-getupdates-offset.json") : null;
+var TELEGRAM_RECENT_DMS_FILE = AGENT_DIR ? join16(AGENT_DIR, "telegram-recent-dms.json") : null;
+var TELEGRAM_CHANNEL_ADD_RESTART_FILE = AGENT_DIR ? join16(AGENT_DIR, "telegram-channel-add-restart.json") : null;
+var TELEGRAM_OFFSET_FILE = AGENT_DIR ? join16(AGENT_DIR, "telegram-getupdates-offset.json") : null;
 var recentDms = /* @__PURE__ */ new Map();
 var recentDmPersister = TELEGRAM_RECENT_DMS_FILE ? createRecentDmPersister({
   filePath: TELEGRAM_RECENT_DMS_FILE,
@@ -39452,7 +39819,7 @@ function safeMarkerName(chatId, messageId) {
 }
 function pendingInboundPath(chatId, messageId) {
   if (!PENDING_INBOUND_DIR) return null;
-  return join15(PENDING_INBOUND_DIR, safeMarkerName(chatId, messageId));
+  return join16(PENDING_INBOUND_DIR, safeMarkerName(chatId, messageId));
 }
 function writePendingInboundMarker(chatId, messageId, chatType, undeliverable = false, payload) {
   const path = pendingInboundPath(chatId, messageId);
@@ -39500,7 +39867,7 @@ function rewriteTelegramMarkerInPlace(path, marker) {
 function clearTelegramMarkerFileWithHeal(fullPath) {
   let marker = null;
   try {
-    marker = JSON.parse(readFileSync15(fullPath, "utf-8"));
+    marker = JSON.parse(readFileSync16(fullPath, "utf-8"));
   } catch {
   }
   if (marker && decideRecoveryHeal({
@@ -39517,7 +39884,7 @@ function clearTelegramMarkerFileWithHeal(fullPath) {
 function markTelegramMarkerSeenInPlace(fullPath) {
   let marker;
   try {
-    marker = JSON.parse(readFileSync15(fullPath, "utf-8"));
+    marker = JSON.parse(readFileSync16(fullPath, "utf-8"));
   } catch {
     return;
   }
@@ -39529,7 +39896,7 @@ function markTelegramMarkerSeenInPlace(fullPath) {
 function markTelegramMarkerSeenWithHeal(fullPath) {
   let marker = null;
   try {
-    marker = JSON.parse(readFileSync15(fullPath, "utf-8"));
+    marker = JSON.parse(readFileSync16(fullPath, "utf-8"));
   } catch {
     return;
   }
@@ -39545,7 +39912,7 @@ function readPendingInboundMarker(chatId, messageId) {
   const path = pendingInboundPath(chatId, messageId);
   if (!path || !existsSync9(path)) return null;
   try {
-    return JSON.parse(readFileSync15(path, "utf-8"));
+    return JSON.parse(readFileSync16(path, "utf-8"));
   } catch {
     return null;
   }
@@ -39565,10 +39932,10 @@ function nextRetryName(filename) {
 async function processRecoveryOutboxFile(filename) {
   if (!RECOVERY_OUTBOX_DIR) return;
   if (filename.endsWith(".poison.json") || filename.endsWith(".tmp")) return;
-  const fullPath = join15(RECOVERY_OUTBOX_DIR, filename);
+  const fullPath = join16(RECOVERY_OUTBOX_DIR, filename);
   let payload;
   try {
-    const raw = readFileSync15(fullPath, "utf-8");
+    const raw = readFileSync16(fullPath, "utf-8");
     payload = JSON.parse(raw);
   } catch (err) {
     process.stderr.write(
@@ -39662,7 +40029,7 @@ async function processRecoveryOutboxFile(filename) {
   const next = nextRetryName(filename);
   if (next) {
     try {
-      renameSync7(fullPath, join15(RECOVERY_OUTBOX_DIR, next.next));
+      renameSync7(fullPath, join16(RECOVERY_OUTBOX_DIR, next.next));
       if (next.attempt >= MAX_RECOVERY_ATTEMPTS) {
         process.stderr.write(
           `telegram-channel(${AGENT_CODE_NAME}): ghost-reply recovery exhausted retries \u2014 moved to ${next.next}
@@ -39694,7 +40061,7 @@ function scanRecoveryRetries() {
   if (!RECOVERY_OUTBOX_DIR) return;
   let entries;
   try {
-    entries = readdirSync4(RECOVERY_OUTBOX_DIR);
+    entries = readdirSync5(RECOVERY_OUTBOX_DIR);
   } catch {
     return;
   }
@@ -39703,7 +40070,7 @@ function scanRecoveryRetries() {
     if (!f.includes(".retry-") || f.endsWith(".poison.json")) continue;
     let mtimeMs;
     try {
-      mtimeMs = statSync3(join15(RECOVERY_OUTBOX_DIR, f)).mtimeMs;
+      mtimeMs = statSync4(join16(RECOVERY_OUTBOX_DIR, f)).mtimeMs;
     } catch {
       continue;
     }
@@ -39724,7 +40091,7 @@ function startRecoveryOutboxWatcher() {
     return;
   }
   try {
-    for (const f of readdirSync4(RECOVERY_OUTBOX_DIR)) {
+    for (const f of readdirSync5(RECOVERY_OUTBOX_DIR)) {
       if (isFirstAttemptOutboxFile(f)) void processRecoveryOutboxFile(f);
     }
   } catch {
@@ -39733,7 +40100,7 @@ function startRecoveryOutboxWatcher() {
     const watcher = watch(RECOVERY_OUTBOX_DIR, (event, filename) => {
       if (event !== "rename" || !filename) return;
       if (!isFirstAttemptOutboxFile(filename)) return;
-      if (existsSync9(join15(RECOVERY_OUTBOX_DIR, filename))) {
+      if (existsSync9(join16(RECOVERY_OUTBOX_DIR, filename))) {
         void processRecoveryOutboxFile(filename);
       }
     });
@@ -39748,7 +40115,7 @@ function startRecoveryOutboxWatcher() {
   retryTimer.unref?.();
 }
 startRecoveryOutboxWatcher();
-var NOTICE_OUTBOX_DIR = AGENT_DIR ? join15(AGENT_DIR, "telegram-notice-outbox") : null;
+var NOTICE_OUTBOX_DIR = AGENT_DIR ? join16(AGENT_DIR, "telegram-notice-outbox") : null;
 var NOTICE_MAX_AGE_MS = 9e4;
 var NOTICE_INFLIGHT = /* @__PURE__ */ new Set();
 async function processNoticeOutboxFile(filename) {
@@ -39756,11 +40123,11 @@ async function processNoticeOutboxFile(filename) {
   if (filename.startsWith(".") || filename.endsWith(".tmp") || !filename.endsWith(".json")) return;
   if (NOTICE_INFLIGHT.has(filename)) return;
   NOTICE_INFLIGHT.add(filename);
-  const fullPath = join15(NOTICE_OUTBOX_DIR, filename);
+  const fullPath = join16(NOTICE_OUTBOX_DIR, filename);
   try {
     let mtimeMs;
     try {
-      mtimeMs = statSync3(fullPath).mtimeMs;
+      mtimeMs = statSync4(fullPath).mtimeMs;
     } catch {
       return;
     }
@@ -39773,7 +40140,7 @@ async function processNoticeOutboxFile(filename) {
     }
     let payload;
     try {
-      const parsed = JSON.parse(readFileSync15(fullPath, "utf-8"));
+      const parsed = JSON.parse(readFileSync16(fullPath, "utf-8"));
       if (!parsed || typeof parsed !== "object") throw new Error("not an object");
       payload = parsed;
     } catch {
@@ -39844,13 +40211,13 @@ function startNoticeOutboxWatcher() {
     return;
   }
   try {
-    for (const f of readdirSync4(NOTICE_OUTBOX_DIR)) void processNoticeOutboxFile(f);
+    for (const f of readdirSync5(NOTICE_OUTBOX_DIR)) void processNoticeOutboxFile(f);
   } catch {
   }
   try {
     const watcher = watch(NOTICE_OUTBOX_DIR, (event, filename) => {
       if (event !== "rename" || !filename) return;
-      if (existsSync9(join15(NOTICE_OUTBOX_DIR, filename))) void processNoticeOutboxFile(filename);
+      if (existsSync9(join16(NOTICE_OUTBOX_DIR, filename))) void processNoticeOutboxFile(filename);
     });
     watcher.unref?.();
   } catch (err) {
@@ -39870,7 +40237,7 @@ function sweepTelegramStaleMarkers(thresholdMs) {
   if (!existsSync9(PENDING_INBOUND_DIR)) return;
   let filenames;
   try {
-    filenames = readdirSync4(PENDING_INBOUND_DIR);
+    filenames = readdirSync5(PENDING_INBOUND_DIR);
   } catch (err) {
     process.stderr.write(
       `telegram-channel(${AGENT_CODE_NAME}): stale-marker readdir failed: ${err.message}
@@ -39884,10 +40251,10 @@ function sweepTelegramStaleMarkers(thresholdMs) {
   for (const filename of filenames) {
     if (!filename.endsWith(".json")) continue;
     if (filename.endsWith(".tmp")) continue;
-    const fullPath = join15(PENDING_INBOUND_DIR, filename);
+    const fullPath = join16(PENDING_INBOUND_DIR, filename);
     let marker;
     try {
-      marker = JSON.parse(readFileSync15(fullPath, "utf-8"));
+      marker = JSON.parse(readFileSync16(fullPath, "utf-8"));
     } catch (err) {
       process.stderr.write(
         `telegram-channel(${AGENT_CODE_NAME}): stale-marker parse failed for ${redactId(filename)}: ${err.message}
@@ -39940,13 +40307,13 @@ var orphanSweepTimer = setInterval(() => {
   checkWatchdogGiveUpNotice();
 }, orphanSweepIntervalMs());
 orphanSweepTimer.unref?.();
-var TELEGRAM_PROGRESS_HEARTBEAT_PATH = AGENT_DIR ? join15(AGENT_DIR, "channel-progress-heartbeat.json") : null;
+var TELEGRAM_PROGRESS_HEARTBEAT_PATH = AGENT_DIR ? join16(AGENT_DIR, "channel-progress-heartbeat.json") : null;
 var telegramTrackedProgress = null;
 var telegramProgressTickRunning = false;
 function readTelegramProgressHeartbeat() {
   if (!TELEGRAM_PROGRESS_HEARTBEAT_PATH || !existsSync9(TELEGRAM_PROGRESS_HEARTBEAT_PATH)) return null;
   try {
-    return parseProgressHeartbeat(readFileSync15(TELEGRAM_PROGRESS_HEARTBEAT_PATH, "utf-8"));
+    return parseProgressHeartbeat(readFileSync16(TELEGRAM_PROGRESS_HEARTBEAT_PATH, "utf-8"));
   } catch {
     return null;
   }
@@ -39969,11 +40336,11 @@ function findTelegramProgressTarget() {
   let best = null;
   let bestMs = Infinity;
   try {
-    for (const name of readdirSync4(PENDING_INBOUND_DIR)) {
+    for (const name of readdirSync5(PENDING_INBOUND_DIR)) {
       if (!name.endsWith(".json")) continue;
       let m;
       try {
-        m = JSON.parse(readFileSync15(join15(PENDING_INBOUND_DIR, name), "utf-8"));
+        m = JSON.parse(readFileSync16(join16(PENDING_INBOUND_DIR, name), "utf-8"));
       } catch {
         continue;
       }
@@ -40100,11 +40467,11 @@ function listPendingInboundChatIds() {
   if (!PENDING_INBOUND_DIR || !existsSync9(PENDING_INBOUND_DIR)) return [];
   const chats = /* @__PURE__ */ new Set();
   try {
-    for (const name of readdirSync4(PENDING_INBOUND_DIR)) {
+    for (const name of readdirSync5(PENDING_INBOUND_DIR)) {
       if (!name.endsWith(".json")) continue;
       try {
         const marker = JSON.parse(
-          readFileSync15(join15(PENDING_INBOUND_DIR, name), "utf8")
+          readFileSync16(join16(PENDING_INBOUND_DIR, name), "utf8")
         );
         if (typeof marker.seen_at === "string" && marker.seen_at) continue;
         if (typeof marker.chat_id === "string" && marker.chat_id) chats.add(marker.chat_id);
@@ -40146,7 +40513,7 @@ async function notifyWatchdogGiveUp(chatId, reason) {
 }
 function checkWatchdogGiveUpNotice() {
   if (!AGENT_DIR) return;
-  const signal = readGiveUpSignal(join15(AGENT_DIR, GIVE_UP_SIGNAL_FILENAME));
+  const signal = readGiveUpSignal(join16(AGENT_DIR, GIVE_UP_SIGNAL_FILENAME));
   const signalAtMs = signal?.atMs ?? null;
   const act = decideGiveUpNotice({
     signalAtMs,
@@ -40425,7 +40792,7 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
         isError: true
       };
     }
-    const allowedRoot = resolve2(homedir6(), ".augmented", AGENT_CODE_NAME, "project") + "/";
+    const allowedRoot = resolve2(homedir7(), ".augmented", AGENT_CODE_NAME, "project") + "/";
     const resolvedPath = resolve2(path);
     if (!resolvedPath.startsWith(allowedRoot)) {
       return {
@@ -40473,7 +40840,7 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
     }
     let realRoot = allowedRoot;
     try {
-      realRoot = realpathSync(resolve2(homedir6(), ".augmented", AGENT_CODE_NAME, "project")) + "/";
+      realRoot = realpathSync(resolve2(homedir7(), ".augmented", AGENT_CODE_NAME, "project")) + "/";
     } catch {
     }
     if (!realPath.startsWith(realRoot)) {
@@ -40488,7 +40855,7 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
     let bytes;
     let size;
     try {
-      const st = statSync3(realPath);
+      const st = statSync4(realPath);
       if (!st.isFile()) {
         return { content: [{ type: "text", text: `Upload refused: ${resolvedPath} is not a regular file.` }], isError: true };
       }
@@ -40502,7 +40869,7 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
           isError: true
         };
       }
-      bytes = readFileSync15(realPath);
+      bytes = readFileSync16(realPath);
     } catch (err) {
       return { content: [{ type: "text", text: `Failed to read file: ${err.message}` }], isError: true };
     }
@@ -41056,7 +41423,7 @@ async function replayPendingTelegramMarkers() {
   if (!sessionAlive) return;
   let filenames;
   try {
-    filenames = readdirSync4(PENDING_INBOUND_DIR);
+    filenames = readdirSync5(PENDING_INBOUND_DIR);
   } catch {
     return;
   }
@@ -41064,7 +41431,7 @@ async function replayPendingTelegramMarkers() {
   let paneFreshAgeMs = null;
   if (AGENT_DIR) {
     try {
-      paneFreshAgeMs = Math.max(0, now - statSync3(join15(AGENT_DIR, "pane.log")).mtimeMs);
+      paneFreshAgeMs = Math.max(0, now - statSync4(join16(AGENT_DIR, "pane.log")).mtimeMs);
     } catch {
     }
   }
@@ -41072,10 +41439,10 @@ async function replayPendingTelegramMarkers() {
   const entries = [];
   for (const name of filenames) {
     if (!name.endsWith(".json") || name.endsWith(".tmp")) continue;
-    const fullPath = join15(PENDING_INBOUND_DIR, name);
+    const fullPath = join16(PENDING_INBOUND_DIR, name);
     let marker;
     try {
-      marker = JSON.parse(readFileSync15(fullPath, "utf-8"));
+      marker = JSON.parse(readFileSync16(fullPath, "utf-8"));
     } catch {
       continue;
     }
@@ -41243,7 +41610,7 @@ async function pollLoop() {
           `telegram-channel(${AGENT_CODE_NAME}): getUpdates failed: ${resp.description ?? "unknown"}
 `
         );
-        await sleep2(5e3);
+        await sleep3(5e3);
         continue;
       }
       const offsetBeforeBatch = nextOffset;
@@ -41561,7 +41928,8 @@ async function pollLoop() {
           });
           continue;
         }
-        const telegramUsageLimitUntil = !isFromBot ? readUsageLimitUntil({ codeName: AGENT_CODE_NAME }) : null;
+        const reactiveMode = resolveUsageLimitReactiveMode();
+        const telegramUsageLimitUntil = !isFromBot && shouldReadPredictiveMarker(reactiveMode) ? readUsageLimitUntil({ codeName: AGENT_CODE_NAME }) : null;
         if (telegramUsageLimitUntil) {
           process.stderr.write(
             `telegram-channel(${AGENT_CODE_NAME}): usage-limit active until ${telegramUsageLimitUntil.toISOString()} \u2014 notice, no dispatch (chat=${redactId(chatId)})
@@ -41625,7 +41993,7 @@ async function pollLoop() {
         let paneLogFreshAgeMs = null;
         if (AGENT_DIR) {
           try {
-            const paneMtimeMs = statSync3(join15(AGENT_DIR, "pane.log")).mtimeMs;
+            const paneMtimeMs = statSync4(join16(AGENT_DIR, "pane.log")).mtimeMs;
             paneLogFreshAgeMs = Math.max(0, Date.now() - paneMtimeMs);
           } catch {
           }
@@ -41724,10 +42092,27 @@ async function pollLoop() {
         if (!isFromBot && !peerAgentMeta && userId && userId !== "unknown" && chatId) {
           clearScheduledTurnMarker(TELEGRAM_AGENT_DIR);
         }
+        const dispatchedAtMs = Date.now();
         await mcp.notification({
           method: "notifications/claude/channel",
           params: channelPayload
         });
+        const watchMode = armedWatchMode({
+          mode: reactiveMode,
+          isBot: isFromBot || !!peerAgentMeta,
+          // Every Telegram inbound that reaches here owes a reply — there is no
+          // discretionary auto-follow variant as there is on Slack.
+          replyOwed: true
+        });
+        if (watchMode) {
+          armTelegramUsageLimitWatch({
+            mode: watchMode,
+            chatId,
+            senderId: userId,
+            ...msg.message_thread_id != null ? { messageThreadId: msg.message_thread_id } : {},
+            sinceMs: dispatchedAtMs
+          });
+        }
         seedTelegramProgressHeartbeat();
         conversationIngestClient?.ingest({
           channel: "telegram",
@@ -41773,11 +42158,11 @@ async function pollLoop() {
         `telegram-channel(${AGENT_CODE_NAME}): poll error: ${err.message}
 `
       );
-      await sleep2(5e3);
+      await sleep3(5e3);
     }
   }
 }
-function sleep2(ms) {
+function sleep3(ms) {
   return new Promise((resolve3) => setTimeout(resolve3, ms).unref());
 }
 function shutdown(reason) {