@integrity-labs/agt-cli 0.27.162 → 0.27.164

package/dist/mcp/slack-channel.js

@@ -14344,9 +14344,152 @@ function decideInboundAccess(input) {
   return { kind: "admit" };
 }
 
+// src/watch-command.ts
+var WATCH_DEFAULT_DURATION_MS = 2 * 60 * 60 * 1e3;
+var WATCH_MAX_DURATION_MS = 7 * 24 * 60 * 60 * 1e3;
+var WATCH_MIN_DURATION_MS = 5 * 60 * 1e3;
+function extractDriveFileId(s) {
+  const trimmed = s.trim().replace(/^<|>$/g, "");
+  const pathId = trimmed.match(/\/d\/([A-Za-z0-9_-]{10,})/);
+  if (pathId?.[1]) return pathId[1];
+  const idParam = trimmed.match(/[?&]id=([A-Za-z0-9_-]{10,})/);
+  if (idParam?.[1]) return idParam[1];
+  if (!/[/:?]/.test(trimmed) && /^[A-Za-z0-9_-]{20,}$/.test(trimmed)) return trimmed;
+  return null;
+}
+function parseDurationToken(token) {
+  const m = token.trim().match(/^(\d+)\s*([smhd])?$/i);
+  if (!m?.[1]) return null;
+  const n = Number.parseInt(m[1], 10);
+  if (!Number.isFinite(n) || n <= 0) return null;
+  const unit = (m[2] ?? "m").toLowerCase();
+  const mult = unit === "s" ? 1e3 : unit === "m" ? 6e4 : unit === "h" ? 36e5 : 864e5;
+  return n * mult;
+}
+function parseWatchArgs(args) {
+  const parts = args.trim().split(/\s+/).filter(Boolean);
+  const first = parts[0];
+  if (!first) return { ok: false, error: "usage" };
+  if (parts.length > 2) return { ok: false, error: "usage" };
+  const fileId = extractDriveFileId(first);
+  if (!fileId) return { ok: false, error: "bad-url" };
+  let durationMs = WATCH_DEFAULT_DURATION_MS;
+  const durationToken = parts[1];
+  if (durationToken !== void 0) {
+    const parsed = parseDurationToken(durationToken);
+    if (parsed === null) return { ok: false, error: "bad-duration" };
+    durationMs = Math.min(Math.max(parsed, WATCH_MIN_DURATION_MS), WATCH_MAX_DURATION_MS);
+  }
+  return { ok: true, value: { fileId, durationMs } };
+}
+function watchArgsFromText(strippedText, codeName, opts) {
+  const forms = [];
+  if (opts?.allowBare ?? true) forms.push("/watch");
+  if (codeName) forms.push(`/watch-${codeName}`);
+  for (const f of forms) {
+    if (strippedText === f) return "";
+    if (strippedText.startsWith(`${f} `)) return strippedText.slice(f.length + 1).trim();
+  }
+  return null;
+}
+async function postWatchTrigger(opts) {
+  const doFetch = opts.fetchImpl ?? fetch;
+  try {
+    const res = await doFetch(`${opts.host}/host/triggers`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json; charset=utf-8",
+        Authorization: `Bearer ${opts.apiKey}`
+      },
+      body: JSON.stringify({
+        agent_id: opts.agentId,
+        provider: "gdrive_comments",
+        config: { fileId: opts.fileId },
+        expires_at: opts.expiresAtIso
+      }),
+      signal: AbortSignal.timeout(opts.timeoutMs ?? 15e3)
+    });
+    if (!res.ok) {
+      let msg = `HTTP ${res.status}`;
+      try {
+        const j2 = await res.json();
+        if (j2?.error) msg = j2.error;
+      } catch {
+      }
+      return { ok: false, status: res.status, error: msg };
+    }
+    const j = await res.json().catch(() => ({}));
+    return { ok: true, status: res.status, reused: !!j.reused, expiresAt: j.expires_at ?? null };
+  } catch (err) {
+    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+  }
+}
+function humanDuration(ms) {
+  const mins = Math.round(ms / 6e4);
+  if (mins % 1440 === 0) return `${mins / 1440}d`;
+  if (mins % 60 === 0) return `${mins / 60}h`;
+  return `${mins}m`;
+}
+function watchUsageText() {
+  return "Usage: `/watch <google-doc-url> [duration]` \u2014 e.g. `/watch https://docs.google.com/document/d/\u2026/edit 2h`. Duration defaults to 2h (max 7d).";
+}
+function watchBadUrlText() {
+  return "That doesn't look like a Google Doc link. Paste the doc's share URL (the part with `/d/<id>`).";
+}
+function watchBadDurationText() {
+  return "I couldn't read that duration. Try `30m`, `2h`, or `1d` (max 7d).";
+}
+function watchErrorText() {
+  return "\u274C I couldn't set up that watch just now. Please try again in a moment.";
+}
+function watchSuccessTextSlack(fileId, durationMs, reused) {
+  const url = `https://docs.google.com/document/d/${fileId}/edit`;
+  const verb = reused ? "Extended my watch on" : "Watching";
+  return `\u{1F440} ${verb} <${url}|that doc> for new comments that mention me, for the next ${humanDuration(durationMs)}. I'll pause automatically when the window's up. (Make sure Google Drive is connected with comment access, or I won't see them.)`;
+}
+
 // src/ack-reaction.ts
-import { readdirSync, readFileSync } from "fs";
+import { readdirSync, readFileSync as readFileSync2 } from "fs";
+import { join as join2 } from "path";
+
+// src/flags-cache-read.ts
+import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
 import { join } from "path";
+function defaultFlagsCachePath() {
+  return join(homedir(), ".augmented", "flags-cache.json");
+}
+function envBoolean(raw) {
+  if (raw === void 0) return void 0;
+  const v = raw.trim().toLowerCase();
+  if (v === "") return void 0;
+  if (v === "1" || v === "true" || v === "yes" || v === "on") return true;
+  if (v === "0" || v === "false" || v === "no" || v === "off") return false;
+  return void 0;
+}
+function cachedBoolean(key2, path) {
+  try {
+    if (!existsSync(path)) return void 0;
+    const parsed = JSON.parse(readFileSync(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[key2];
+    return typeof value === "boolean" ? value : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function resolveHostBooleanFlag(opts) {
+  const env = opts.env ?? process.env;
+  const envValue = envBoolean(env[opts.envVar]);
+  if (envValue !== void 0) return envValue;
+  const cached2 = cachedBoolean(opts.key, opts.cachePath ?? defaultFlagsCachePath());
+  if (cached2 !== void 0) return cached2;
+  return opts.defaultValue;
+}
+
+// src/ack-reaction.ts
 var REPLY_WEDGED_THRESHOLD_MS = 5 * 60 * 1e3;
 var ACK_STARTUP_GRACE_MS = 6e4;
 var ACK_PANE_FRESH_THRESHOLD_MS = 6e4;
@@ -14381,8 +14524,11 @@ function undeliverableNoticeText() {
 var BUSY_ACK_THRESHOLD_MS = 9e4;
 var BUSY_ACK_NOTICE_THROTTLE_MS = 10 * 60 * 1e3;
 function channelBusyAckEnabled() {
-  const v = process.env.AGT_CHANNEL_BUSY_ACK_ENABLED;
-  return v === "1" || v === "true";
+  return resolveHostBooleanFlag({
+    key: "channel-busy-ack",
+    envVar: "AGT_CHANNEL_BUSY_ACK_ENABLED",
+    defaultValue: false
+  });
 }
 function channelBusyAckThresholdMs() {
   const raw = parseInt(process.env.AGT_CHANNEL_BUSY_ACK_THRESHOLD_MS ?? "", 10);
@@ -14406,7 +14552,7 @@ var GIVE_UP_SIGNAL_MAX_AGE_MS = 30 * 60 * 1e3;
 function readGiveUpSignalAtMs(path, now = Date.now()) {
   if (!path) return null;
   try {
-    const raw = JSON.parse(readFileSync(path, "utf8"));
+    const raw = JSON.parse(readFileSync2(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;
@@ -14438,7 +14584,7 @@ function oldestPendingMarkerAgeMs(dir, now = Date.now()) {
     if (!name.endsWith(".json")) continue;
     let receivedAt;
     try {
-      const raw = JSON.parse(readFileSync(join(dir, name), "utf-8"));
+      const raw = JSON.parse(readFileSync2(join2(dir, name), "utf-8"));
       receivedAt = raw.received_at;
     } catch {
       continue;
@@ -14521,15 +14667,15 @@ function probeAgentSessionCached(codeName, ttlMs = SESSION_PROBE_TTL_MS, now = D
 }
 
 // src/agent-config-state.ts
-import { existsSync, readFileSync as readFileSync2 } from "fs";
-import { join as join2 } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
+import { join as join3 } from "path";
 var SESSION_STATE_FILENAME = "session-state.json";
 function readAgentSessionState(stateDir) {
   if (!stateDir) return null;
-  const path = join2(stateDir, SESSION_STATE_FILENAME);
-  if (!existsSync(path)) return null;
+  const path = join3(stateDir, SESSION_STATE_FILENAME);
+  if (!existsSync2(path)) return null;
   try {
-    const parsed = JSON.parse(readFileSync2(path, "utf-8"));
+    const parsed = JSON.parse(readFileSync3(path, "utf-8"));
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
     return parsed;
   } catch {
@@ -14601,10 +14747,10 @@ import { promisify } from "util";
 import { open, stat } from "fs/promises";
 
 // src/channel-attachments.ts
-import { homedir } from "os";
-import { join as join3, resolve, sep } from "path";
+import { homedir as homedir2 } from "os";
+import { join as join4, resolve, sep } from "path";
 function resolveChannelInboundDir(codeName, channelSlug) {
-  const base = join3(homedir(), ".augmented");
+  const base = join4(homedir2(), ".augmented");
   const allowedSegment = /^[A-Za-z0-9_-]+$/;
   if (!allowedSegment.test(codeName) || !allowedSegment.test(channelSlug)) {
     throw new Error(
@@ -14682,7 +14828,7 @@ function isPathInside(target, root) {
   return normalizedTarget === resolve(root) || normalizedTarget.startsWith(normalizedRoot);
 }
 function redactAugmentedPaths(msg) {
-  const homePrefix = homedir().replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const homePrefix = homedir2().replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   return msg.replaceAll(
     new RegExp(`${homePrefix}[\\\\/]\\.augmented(?:[\\\\/][^\\s'"\`]*)*`, "g"),
     "<augmented-path>"
@@ -15030,14 +15176,14 @@ var SLACK_EGRESS_TOOLS = /* @__PURE__ */ new Set([
 ]);
 
 // src/slack-pending-inbound-cleanup.ts
-import { existsSync as existsSync2, readdirSync as readdirSync2, statSync, unlinkSync } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync3, readdirSync as readdirSync2, statSync, unlinkSync } from "fs";
+import { join as join5 } from "path";
 function sanitizeMarkerSegment(value) {
   return value.replace(/[^A-Za-z0-9_-]/g, "_");
 }
 var defaultClearMarkerFile = (fullPath) => {
   try {
-    if (existsSync2(fullPath)) unlinkSync(fullPath);
+    if (existsSync3(fullPath)) unlinkSync(fullPath);
   } catch {
   }
 };
@@ -15048,7 +15194,7 @@ function clearAllSlackPendingMarkersForThread(dir, channel, threadTs, clear = de
   try {
     for (const f of readdirSync2(dir)) {
       if (!f.startsWith(prefix) || !f.endsWith(".json")) continue;
-      clear(join4(dir, f));
+      clear(join5(dir, f));
       cleared += 1;
     }
   } catch {
@@ -15063,7 +15209,7 @@ function clearSlackPendingMarkerByMessageTs(dir, channel, messageTs, clear = def
   try {
     for (const f of readdirSync2(dir)) {
       if (!f.startsWith(channelPrefix) || !f.endsWith(messageSuffix)) continue;
-      clear(join4(dir, f));
+      clear(join5(dir, f));
       cleared += 1;
     }
   } catch {
@@ -15075,7 +15221,7 @@ function clearOldestSlackPendingMarkerInChannel(dir, channel, clear = defaultCle
   const channelPrefix = `${sanitizeMarkerSegment(channel)}__`;
   try {
     const entries = readdirSync2(dir).filter((f) => f.startsWith(channelPrefix) && f.endsWith(".json")).map((f) => {
-      const full = join4(dir, f);
+      const full = join5(dir, f);
       let mtime = 0;
       try {
         mtime = statSync(full).mtimeMs;
@@ -15103,7 +15249,7 @@ function resolveReplyThreadTs(input) {
 }
 
 // src/restart-confirm.ts
-import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync3, renameSync, unlinkSync as unlinkSync2, writeFileSync } from "fs";
+import { existsSync as existsSync4, mkdirSync, readFileSync as readFileSync4, renameSync, unlinkSync as unlinkSync2, writeFileSync } from "fs";
 import { dirname } from "path";
 import { randomUUID } from "crypto";
 var RESTART_CONFIRM_MAX_AGE_MS = 10 * 60 * 1e3;
@@ -15121,15 +15267,15 @@ function buildBackOnlineText(name) {
 }
 function writeRestartConfirmMarker(filePath, marker) {
   const dir = dirname(filePath);
-  if (!existsSync3(dir)) mkdirSync(dir, { recursive: true, mode: 448 });
+  if (!existsSync4(dir)) mkdirSync(dir, { recursive: true, mode: 448 });
   const tmpPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
   writeFileSync(tmpPath, JSON.stringify(marker) + "\n", { encoding: "utf8", mode: 384 });
   renameSync(tmpPath, filePath);
 }
 function readRestartConfirmMarker(filePath) {
   try {
-    if (!existsSync3(filePath)) return null;
-    const parsed = JSON.parse(readFileSync3(filePath, "utf8"));
+    if (!existsSync4(filePath)) return null;
+    const parsed = JSON.parse(readFileSync4(filePath, "utf8"));
     if (!parsed || typeof parsed !== "object") return null;
     return parsed;
   } catch {
@@ -15138,7 +15284,7 @@ function readRestartConfirmMarker(filePath) {
 }
 function clearRestartConfirmMarker(filePath) {
   try {
-    if (existsSync3(filePath)) unlinkSync2(filePath);
+    if (existsSync4(filePath)) unlinkSync2(filePath);
   } catch {
   }
 }
@@ -15239,9 +15385,9 @@ var StdioServerTransport = class {
 import {
   chmodSync,
   createWriteStream,
-  existsSync as existsSync6,
+  existsSync as existsSync7,
   mkdirSync as mkdirSync5,
-  readFileSync as readFileSync7,
+  readFileSync as readFileSync8,
   readdirSync as readdirSync3,
   renameSync as renameSync3,
   statSync as statSync2,
@@ -15249,12 +15395,12 @@ import {
   watch,
   writeFileSync as writeFileSync5
 } from "fs";
-import { basename, join as join6, resolve as resolve2 } from "path";
-import { homedir as homedir2 } from "os";
+import { basename, join as join7, resolve as resolve2 } from "path";
+import { homedir as homedir3 } from "os";
 import { createHash, randomUUID as randomUUID2 } from "crypto";
 
 // src/slack-thread-store.ts
-import { mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
+import { mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname2 } from "path";
 var FILE_VERSION = 1;
 var DEFAULT_TTL_DAYS = 30;
@@ -15265,7 +15411,7 @@ function loadThreadStore(filePath, opts = {}) {
   const ttlMs = ttlDays * 24 * 60 * 60 * 1e3;
   let raw;
   try {
-    raw = readFileSync4(filePath, "utf-8");
+    raw = readFileSync5(filePath, "utf-8");
   } catch {
     return { threads: /* @__PURE__ */ new Map(), pruned: 0 };
   }
@@ -15379,7 +15525,7 @@ async function runOrRetry(fn, opts) {
 }
 
 // src/slack-bot-photo.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync5, mkdirSync as mkdirSync3, readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "fs";
 import { dirname as dirname3 } from "path";
 async function applyBotPhoto(opts) {
   const fetchImpl = opts.fetchImpl ?? fetch;
@@ -15387,9 +15533,9 @@ async function applyBotPhoto(opts) {
     process.stderr.write(m);
   });
   const { token, avatarUrl, markerPath } = opts;
-  if (markerPath && existsSync4(markerPath)) {
+  if (markerPath && existsSync5(markerPath)) {
     try {
-      if (readFileSync5(markerPath, "utf-8").trim() === avatarUrl) {
+      if (readFileSync6(markerPath, "utf-8").trim() === avatarUrl) {
         return { status: "skipped-unchanged" };
       }
     } catch {
@@ -16182,14 +16328,14 @@ function createSlackBotUserIdClient(args) {
 
 // src/mcp-spawn-lock.ts
 import {
-  existsSync as existsSync5,
+  existsSync as existsSync6,
   mkdirSync as mkdirSync4,
-  readFileSync as readFileSync6,
+  readFileSync as readFileSync7,
   renameSync as renameSync2,
   unlinkSync as unlinkSync3,
   writeFileSync as writeFileSync4
 } from "fs";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 function defaultIsPidAlive(pid) {
   if (!Number.isFinite(pid) || pid <= 0) return false;
   try {
@@ -16207,7 +16353,7 @@ function acquireMcpSpawnLock(args) {
   const isPidAlive = options.isPidAlive ?? defaultIsPidAlive;
   const selfPid = options.selfPid ?? process.pid;
   const now = options.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
-  const path = join5(agentDir, basename2);
+  const path = join6(agentDir, basename2);
   const existing = readLockHolder(path);
   if (existing) {
     if (existing.pid === selfPid) {
@@ -16236,9 +16382,9 @@ function releaseMcpSpawnLock(lockPath, opts = {}) {
   }
 }
 function readLockHolder(path) {
-  if (!existsSync5(path)) return null;
+  if (!existsSync6(path)) return null;
   try {
-    const raw = readFileSync6(path, "utf8");
+    const raw = readFileSync7(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;
@@ -16414,8 +16560,8 @@ var SLACK_PEER_CLASSIFIER_CONFIG = {
   peers: parsePeersEnv(process.env.SLACK_PEERS, process.env.SLACK_PEERS_GATE),
   peer_disabled_mode: SLACK_PEER_DISABLED_MODE
 };
-var SLACK_AGENT_DIR = AGENT_CODE_NAME ? join6(homedir2(), ".augmented", AGENT_CODE_NAME) : null;
-var SLACK_MCP_CONFIG_PATH = SLACK_AGENT_DIR ? join6(SLACK_AGENT_DIR, "project", ".mcp.json") : null;
+var SLACK_AGENT_DIR = AGENT_CODE_NAME ? join7(homedir3(), ".augmented", AGENT_CODE_NAME) : null;
+var SLACK_MCP_CONFIG_PATH = SLACK_AGENT_DIR ? join7(SLACK_AGENT_DIR, "project", ".mcp.json") : null;
 var liveAllowedUsersCache = null;
 function readLiveAllowedUsers() {
   if (!SLACK_MCP_CONFIG_PATH) return null;
@@ -16425,7 +16571,7 @@ function readLiveAllowedUsers() {
       return liveAllowedUsersCache.value;
     }
     const value = extractAllowedUsersFromMcpJson(
-      readFileSync7(SLACK_MCP_CONFIG_PATH, "utf-8")
+      readFileSync8(SLACK_MCP_CONFIG_PATH, "utf-8")
     );
     if (value === null) return null;
     liveAllowedUsersCache = { mtimeMs, value };
@@ -16437,11 +16583,11 @@ function readLiveAllowedUsers() {
 function getEffectiveAllowedUsers() {
   return readLiveAllowedUsers() ?? ALLOWED_USERS;
 }
-var SLACK_PENDING_INBOUND_DIR = SLACK_AGENT_DIR ? join6(SLACK_AGENT_DIR, "slack-pending-inbound") : null;
-var SLACK_RECOVERY_OUTBOX_DIR = SLACK_AGENT_DIR ? join6(SLACK_AGENT_DIR, "slack-recovery-outbox") : null;
-var SLACK_RESTART_CONFIRM_FILE = SLACK_AGENT_DIR ? join6(SLACK_AGENT_DIR, "slack-restart-confirm.json") : null;
+var SLACK_PENDING_INBOUND_DIR = SLACK_AGENT_DIR ? join7(SLACK_AGENT_DIR, "slack-pending-inbound") : null;
+var SLACK_RECOVERY_OUTBOX_DIR = SLACK_AGENT_DIR ? join7(SLACK_AGENT_DIR, "slack-recovery-outbox") : null;
+var SLACK_RESTART_CONFIRM_FILE = SLACK_AGENT_DIR ? join7(SLACK_AGENT_DIR, "slack-restart-confirm.json") : null;
 var SLACK_MAX_RECOVERY_ATTEMPTS = 3;
-var SLACK_AVATAR_MARKER_PATH = SLACK_AGENT_DIR ? join6(SLACK_AGENT_DIR, "slack-avatar-applied") : null;
+var SLACK_AVATAR_MARKER_PATH = SLACK_AGENT_DIR ? join7(SLACK_AGENT_DIR, "slack-avatar-applied") : null;
 function redactSlackId(id) {
   if (!id) return "<none>";
   return createHash("sha256").update(id).digest("hex").slice(0, 8);
@@ -16452,7 +16598,7 @@ function safeSlackMarkerName(channel, threadTs, messageTs) {
 }
 function slackPendingInboundPath(channel, threadTs, messageTs) {
   if (!SLACK_PENDING_INBOUND_DIR) return null;
-  return join6(SLACK_PENDING_INBOUND_DIR, safeSlackMarkerName(channel, threadTs, messageTs));
+  return join7(SLACK_PENDING_INBOUND_DIR, safeSlackMarkerName(channel, threadTs, messageTs));
 }
 function writeSlackPendingInboundMarker(channel, threadTs, messageTs, undeliverable = false) {
   const path = slackPendingInboundPath(channel, threadTs, messageTs);
@@ -16477,9 +16623,9 @@ function writeSlackPendingInboundMarker(channel, threadTs, messageTs, undelivera
 }
 function readSlackPendingInboundMarker(channel, threadTs, messageTs) {
   const path = slackPendingInboundPath(channel, threadTs, messageTs);
-  if (!path || !existsSync6(path)) return null;
+  if (!path || !existsSync7(path)) return null;
   try {
-    return JSON.parse(readFileSync7(path, "utf-8"));
+    return JSON.parse(readFileSync8(path, "utf-8"));
   } catch {
     return null;
   }
@@ -16573,7 +16719,7 @@ function scheduleBusyAck(channel, threadTs, messageTs, isThreadReply) {
     let paneLogFreshAgeMs = null;
     if (SLACK_AGENT_DIR) {
       try {
-        const paneMtimeMs = statSync2(join6(SLACK_AGENT_DIR, "pane.log")).mtimeMs;
+        const paneMtimeMs = statSync2(join7(SLACK_AGENT_DIR, "pane.log")).mtimeMs;
         paneLogFreshAgeMs = Math.max(0, Date.now() - paneMtimeMs);
       } catch {
       }
@@ -16598,7 +16744,7 @@ function __resetSlackBusyAckNoticeThrottle() {
 function clearSlackMarkerFileWithHeal(fullPath) {
   let marker = null;
   try {
-    marker = JSON.parse(readFileSync7(fullPath, "utf-8"));
+    marker = JSON.parse(readFileSync8(fullPath, "utf-8"));
   } catch {
   }
   if (marker && decideRecoveryHeal({
@@ -16608,7 +16754,7 @@ function clearSlackMarkerFileWithHeal(fullPath) {
     healSlackUndeliverable(marker.channel, marker.message_ts);
   }
   try {
-    if (existsSync6(fullPath)) unlinkSync4(fullPath);
+    if (existsSync7(fullPath)) unlinkSync4(fullPath);
   } catch {
   }
 }
@@ -16649,10 +16795,10 @@ function slackNextRetryName(filename) {
 async function processSlackRecoveryOutboxFile(filename) {
   if (!SLACK_RECOVERY_OUTBOX_DIR) return;
   if (filename.endsWith(".poison.json") || filename.endsWith(".tmp")) return;
-  const fullPath = join6(SLACK_RECOVERY_OUTBOX_DIR, filename);
+  const fullPath = join7(SLACK_RECOVERY_OUTBOX_DIR, filename);
   let payload;
   try {
-    payload = JSON.parse(readFileSync7(fullPath, "utf-8"));
+    payload = JSON.parse(readFileSync8(fullPath, "utf-8"));
   } catch (err) {
     process.stderr.write(
       `slack-channel(${AGENT_CODE_NAME}): recovery outbox parse failed (${filename}): ${err.message}
@@ -16726,7 +16872,7 @@ async function processSlackRecoveryOutboxFile(filename) {
   const next = slackNextRetryName(filename);
   if (next) {
     try {
-      renameSync3(fullPath, join6(SLACK_RECOVERY_OUTBOX_DIR, next.next));
+      renameSync3(fullPath, join7(SLACK_RECOVERY_OUTBOX_DIR, next.next));
       if (next.attempt >= SLACK_MAX_RECOVERY_ATTEMPTS) {
         process.stderr.write(
           `slack-channel(${AGENT_CODE_NAME}): ghost-reply recovery exhausted retries \u2014 moved to ${next.next}
@@ -16765,7 +16911,7 @@ function scanSlackRecoveryRetries() {
     if (!f.includes(".retry-") || f.endsWith(".poison.json")) continue;
     let mtimeMs;
     try {
-      mtimeMs = statSync2(join6(SLACK_RECOVERY_OUTBOX_DIR, f)).mtimeMs;
+      mtimeMs = statSync2(join7(SLACK_RECOVERY_OUTBOX_DIR, f)).mtimeMs;
     } catch {
       continue;
     }
@@ -16795,7 +16941,7 @@ function startSlackRecoveryOutboxWatcher() {
     const watcher = watch(SLACK_RECOVERY_OUTBOX_DIR, (event, filename) => {
       if (event !== "rename" || !filename) return;
       if (!isFirstAttemptSlackOutboxFile(filename)) return;
-      if (existsSync6(join6(SLACK_RECOVERY_OUTBOX_DIR, filename))) {
+      if (existsSync7(join7(SLACK_RECOVERY_OUTBOX_DIR, filename))) {
         void processSlackRecoveryOutboxFile(filename);
       }
     });
@@ -16816,7 +16962,7 @@ function trackPendingMessage(channel, threadTs, messageTs, undeliverable = false
 }
 function sweepSlackStaleMarkers(thresholdMs) {
   if (!SLACK_PENDING_INBOUND_DIR) return;
-  if (!existsSync6(SLACK_PENDING_INBOUND_DIR)) return;
+  if (!existsSync7(SLACK_PENDING_INBOUND_DIR)) return;
   let filenames;
   try {
     filenames = readdirSync3(SLACK_PENDING_INBOUND_DIR);
@@ -16832,10 +16978,10 @@ function sweepSlackStaleMarkers(thresholdMs) {
   for (const filename of filenames) {
     if (!filename.endsWith(".json")) continue;
     if (filename.endsWith(".tmp")) continue;
-    const fullPath = join6(SLACK_PENDING_INBOUND_DIR, filename);
+    const fullPath = join7(SLACK_PENDING_INBOUND_DIR, filename);
     let marker;
     try {
-      marker = JSON.parse(readFileSync7(fullPath, "utf-8"));
+      marker = JSON.parse(readFileSync8(fullPath, "utf-8"));
     } catch (err) {
       process.stderr.write(
         `slack-channel(${AGENT_CODE_NAME}): stale-marker parse failed for ${redactSlackId(filename)}: ${err.message}
@@ -16874,14 +17020,14 @@ var slackOrphanSweepTimer = setInterval(() => {
 slackOrphanSweepTimer.unref?.();
 var lastSlackGiveUpHandledAtMs = null;
 function listPendingSlackConversations() {
-  if (!SLACK_PENDING_INBOUND_DIR || !existsSync6(SLACK_PENDING_INBOUND_DIR)) return [];
+  if (!SLACK_PENDING_INBOUND_DIR || !existsSync7(SLACK_PENDING_INBOUND_DIR)) return [];
   const byKey = /* @__PURE__ */ new Map();
   try {
     for (const name of readdirSync3(SLACK_PENDING_INBOUND_DIR)) {
       if (!name.endsWith(".json")) continue;
       try {
         const marker = JSON.parse(
-          readFileSync7(join6(SLACK_PENDING_INBOUND_DIR, name), "utf8")
+          readFileSync8(join7(SLACK_PENDING_INBOUND_DIR, name), "utf8")
         );
         if (typeof marker.channel !== "string" || !marker.channel) continue;
         if (typeof marker.thread_ts !== "string" || !marker.thread_ts) continue;
@@ -16931,7 +17077,7 @@ function postSlackWatchdogGiveUpNotice(channel, threadTs, isThreadReply) {
 }
 function checkSlackWatchdogGiveUpNotice() {
   if (!SLACK_AGENT_DIR) return;
-  const signalAtMs = readGiveUpSignalAtMs(join6(SLACK_AGENT_DIR, GIVE_UP_SIGNAL_FILENAME));
+  const signalAtMs = readGiveUpSignalAtMs(join7(SLACK_AGENT_DIR, GIVE_UP_SIGNAL_FILENAME));
   const act = decideGiveUpNotice({
     signalAtMs,
     lastHandledAtMs: lastSlackGiveUpHandledAtMs,
@@ -16958,7 +17104,7 @@ async function notifyStrandedInboundsOnFirstConnect() {
   strandedInboundNoticeInFlight = true;
   let hadFailure = false;
   try {
-    if (!SLACK_PENDING_INBOUND_DIR || !existsSync6(SLACK_PENDING_INBOUND_DIR)) return;
+    if (!SLACK_PENDING_INBOUND_DIR || !existsSync7(SLACK_PENDING_INBOUND_DIR)) return;
     let filenames;
     try {
       filenames = readdirSync3(SLACK_PENDING_INBOUND_DIR);
@@ -16971,10 +17117,10 @@ async function notifyStrandedInboundsOnFirstConnect() {
     let notified = 0;
     for (const filename of filenames) {
       if (!filename.endsWith(".json")) continue;
-      const fullPath = join6(SLACK_PENDING_INBOUND_DIR, filename);
+      const fullPath = join7(SLACK_PENDING_INBOUND_DIR, filename);
       let marker;
       try {
-        marker = JSON.parse(readFileSync7(fullPath, "utf-8"));
+        marker = JSON.parse(readFileSync8(fullPath, "utf-8"));
       } catch {
         continue;
       }
@@ -17101,7 +17247,7 @@ function noteThreadActivityByMessageTs(channel, messageTs) {
   if (!channel || !messageTs) return;
   clearPendingMessage(channel, messageTs);
   if (!SLACK_PENDING_INBOUND_DIR) return;
-  if (!existsSync6(SLACK_PENDING_INBOUND_DIR)) return;
+  if (!existsSync7(SLACK_PENDING_INBOUND_DIR)) return;
   let filenames;
   try {
     filenames = readdirSync3(SLACK_PENDING_INBOUND_DIR);
@@ -17115,10 +17261,10 @@ function noteThreadActivityByMessageTs(channel, messageTs) {
   for (const filename of filenames) {
     if (!filename.startsWith(channelPrefix)) continue;
     if (!filename.endsWith(messageSuffix)) continue;
-    clearSlackMarkerFileWithHeal(join6(SLACK_PENDING_INBOUND_DIR, filename));
+    clearSlackMarkerFileWithHeal(join7(SLACK_PENDING_INBOUND_DIR, filename));
   }
 }
-var RESTART_FLAGS_DIR = join6(homedir2(), ".augmented", "restart-flags");
+var RESTART_FLAGS_DIR = join7(homedir3(), ".augmented", "restart-flags");
 function buildAugmentedSlackMetadata() {
   if (!AGT_TEAM_ID) return void 0;
   return {
@@ -17172,6 +17318,7 @@ function buildSlackHelpMessage(codeName) {
     `\u2022 \`${agentSlashCommand("/help")}\` (or type \`/help\`) \u2014 show this help`,
     `\u2022 \`${agentSlashCommand("/restart")}\` \u2014 restart this agent`,
     `\u2022 \`${agentSlashCommand("/status")}\` \u2014 this agent's model, session origin, uptime + connectivity`,
+    "\u2022 `/watch <google-doc-url> [duration]` (type it in chat) \u2014 watch a Google Doc for comments that mention me (default 2h, max 7d; auto-pauses when the window ends). In a shared channel, address me as `/watch-<my-name>`.",
     "\u2022 `/kill` \u2014 silence all agents in this thread for 6h (use as a thread reply)",
     "\u2022 `/unkill` \u2014 clear a kill (use as a thread reply)",
     `\u2022 \`${agentSlashCommand("/investigate")}\` \u2014 live tail of this agent's terminal pane (DM only, allowlisted users; works while the channel process is alive \u2014 a wedged host still needs SSM diagnostics)`
@@ -17504,10 +17651,10 @@ async function handleSlashCommandEnvelope(payload) {
       return;
     }
     try {
-      if (!existsSync6(RESTART_FLAGS_DIR)) {
+      if (!existsSync7(RESTART_FLAGS_DIR)) {
         mkdirSync5(RESTART_FLAGS_DIR, { recursive: true });
       }
-      const flagPath = join6(RESTART_FLAGS_DIR, `${codeName}.flag`);
+      const flagPath = join7(RESTART_FLAGS_DIR, `${codeName}.flag`);
       writeSlackRestartConfirm(
         {
           channel: payload.channel_id,
@@ -17622,10 +17769,10 @@ async function handleHelpCommand(opts) {
 async function handleRestartCommand(opts) {
   const codeName = AGENT_CODE_NAME ?? "unknown";
   try {
-    if (!existsSync6(RESTART_FLAGS_DIR)) {
+    if (!existsSync7(RESTART_FLAGS_DIR)) {
       mkdirSync5(RESTART_FLAGS_DIR, { recursive: true });
     }
-    const flagPath = join6(RESTART_FLAGS_DIR, `${codeName}.flag`);
+    const flagPath = join7(RESTART_FLAGS_DIR, `${codeName}.flag`);
     writeSlackRestartConfirm(
       {
         channel: opts.channel,
@@ -17685,13 +17832,68 @@ async function denyUnauthorizedRestart(opts) {
     ...opts.threadTs ? { thread_ts: opts.threadTs } : {}
   });
 }
+async function handleWatchCommand(opts) {
+  const codeName = AGENT_CODE_NAME ?? "unknown";
+  const replyThread = opts.threadTs ?? opts.ts;
+  const post = (text) => postSlackMessage({
+    channel: opts.channel,
+    text,
+    ...replyThread ? { thread_ts: replyThread } : {}
+  });
+  const parsed = parseWatchArgs(watchArgsFromText(opts.rawText, AGENT_CODE_NAME) ?? "");
+  if (!parsed.ok) {
+    await post(
+      parsed.error === "bad-url" ? watchBadUrlText() : parsed.error === "bad-duration" ? watchBadDurationText() : watchUsageText()
+    );
+    return;
+  }
+  if (!AGT_HOST || !AGT_API_KEY || !AGT_AGENT_ID) {
+    process.stderr.write(`slack-channel(${codeName}): /watch missing AGT_* env \u2014 cannot create watch
+`);
+    await post(watchErrorText());
+    return;
+  }
+  const expiresAtIso = new Date(Date.now() + parsed.value.durationMs).toISOString();
+  const res = await postWatchTrigger({
+    host: AGT_HOST,
+    apiKey: AGT_API_KEY,
+    agentId: AGT_AGENT_ID,
+    fileId: parsed.value.fileId,
+    expiresAtIso
+  });
+  if (!res.ok) {
+    process.stderr.write(
+      `slack-channel(${codeName}): /watch create failed (status=${res.status ?? "?"}): ${res.error ?? "unknown"}
+`
+    );
+    await post(watchErrorText());
+    return;
+  }
+  process.stderr.write(
+    `slack-channel(${codeName}): /watch ${res.reused ? "extended" : "created"} for doc ${parsed.value.fileId.slice(0, 8)}\u2026 channel ${hashChannelId(opts.channel)}
+`
+  );
+  await post(watchSuccessTextSlack(parsed.value.fileId, parsed.value.durationMs, !!res.reused));
+}
+async function denyUnauthorizedWatch(opts) {
+  const codeName = AGENT_CODE_NAME ?? "unknown";
+  process.stderr.write(
+    `slack-channel(${codeName}): /watch denied \u2014 sender not in SLACK_ALLOWED_USERS, channel ${hashChannelId(opts.channel)}
+`
+  );
+  await postSlackMessage({
+    channel: opts.channel,
+    text: `\u{1F6AB} \`/watch\` denied \u2014 your Slack user is not in the allowlist for \`${codeName}\`.`,
+    ...opts.threadTs ? { thread_ts: opts.threadTs } : {}
+  });
+}
 var trackedThreads = /* @__PURE__ */ new Map();
 var THREAD_STORE_PATH = resolveThreadStorePath();
 var THREAD_STORE_TTL_DAYS = parseTtlDays(process.env.SLACK_THREAD_FOLLOW_TTL_DAYS);
 var threadPersister = null;
 function resolveThreadStorePath() {
   if (!AGENT_CODE_NAME) return null;
-  return join6(homedir2(), ".augmented", AGENT_CODE_NAME, "slack-tracked-threads.json");
+  return join7(homedir3(), ".augmented", AGENT_CODE_NAME, "slack-tracked-threads.json");
 }
 function parseTtlDays(raw) {
   if (!raw) return void 0;
@@ -17726,9 +17928,9 @@ if (!BOT_TOKEN || !APP_TOKEN) {
 var slackStderrLogStream = null;
 if (AGENT_CODE_NAME) {
   try {
-    const logDir = join6(homedir2(), ".augmented", AGENT_CODE_NAME);
+    const logDir = join7(homedir3(), ".augmented", AGENT_CODE_NAME);
     mkdirSync5(logDir, { recursive: true });
-    slackStderrLogStream = createWriteStream(join6(logDir, "slack-channel-stderr.log"), {
+    slackStderrLogStream = createWriteStream(join7(logDir, "slack-channel-stderr.log"), {
       flags: "a",
       mode: 384
     });
@@ -18285,7 +18487,7 @@ ${result.formatted}` : "Thread is empty or not found."
         isError: true
       };
     }
-    const allowedRoot = resolve2(homedir2(), ".augmented", AGENT_CODE_NAME, "project") + "/";
+    const allowedRoot = resolve2(homedir3(), ".augmented", AGENT_CODE_NAME, "project") + "/";
     const resolvedPath = resolve2(path);
     if (!resolvedPath.startsWith(allowedRoot)) {
       return {
@@ -18307,7 +18509,7 @@ ${result.formatted}` : "Thread is empty or not found."
         };
       }
       size = stat2.size;
-      bytes = readFileSync7(resolvedPath);
+      bytes = readFileSync8(resolvedPath);
     } catch (err) {
       return {
         content: [{ type: "text", text: `Failed to read file: ${err.message}` }],
@@ -18894,7 +19096,7 @@ function isDownloadableFileId(fileId, channel) {
 }
 function redactAugmentedPaths2(msg) {
   return msg.replaceAll(
-    new RegExp(`${homedir2().replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&")}/\\.augmented/[^\\s'"\`]*`, "g"),
+    new RegExp(`${homedir3().replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&")}/\\.augmented/[^\\s'"\`]*`, "g"),
     "<augmented-path>"
   );
 }
@@ -19146,7 +19348,9 @@ async function connectSocketMode() {
       const helpSuffixed = agentSlashCommand("/help");
       const isRestartCommand = strippedText === "/restart" || strippedText.startsWith("/restart ") || strippedText === restartSuffixed || strippedText.startsWith(`${restartSuffixed} `);
       const isHelpCommand = strippedText === "/help" || strippedText.startsWith("/help ") || strippedText === helpSuffixed || strippedText.startsWith(`${helpSuffixed} `);
-      const command = isBot ? void 0 : isHelpCommand ? { command: "help", authorized: true } : isRestartCommand ? { command: "restart", authorized: isRestartSenderAllowed(getEffectiveAllowedUsers(), evt.user) } : void 0;
+      const isWatchDm = evt.channel?.startsWith("D") ?? false;
+      const isWatchCommand = !isBot && watchArgsFromText(strippedText, AGENT_CODE_NAME, { allowBare: isWatchDm }) !== null;
+      const command = isBot ? void 0 : isHelpCommand ? { command: "help", authorized: true } : isWatchCommand ? { command: "watch", authorized: isRestartSenderAllowed(getEffectiveAllowedUsers(), evt.user) } : isRestartCommand ? { command: "restart", authorized: isRestartSenderAllowed(getEffectiveAllowedUsers(), evt.user) } : void 0;
       const slackHomeTeamId = process.env.SLACK_HOME_TEAM_ID;
       const sameOrg = !!slackHomeTeamId && evt.team === slackHomeTeamId;
       const access = decideInboundAccess({
@@ -19205,6 +19409,22 @@ async function connectSocketMode() {
           });
           return;
         }
+        if (access.command === "watch") {
+          if (!access.authorized) {
+            await denyUnauthorizedWatch({
+              channel: evt.channel ?? "",
+              threadTs: evt.thread_ts
+            });
+            return;
+          }
+          await handleWatchCommand({
+            channel: evt.channel ?? "",
+            threadTs: evt.thread_ts,
+            ts: evt.ts ?? "",
+            rawText: strippedText
+          });
+          return;
+        }
         if (access.command === "restart") {
           if (!access.authorized) {
             await denyUnauthorizedRestart({
@@ -19286,7 +19506,7 @@ async function connectSocketMode() {
       let paneLogFreshAgeMs = null;
       if (SLACK_AGENT_DIR) {
         try {
-          const paneMtimeMs = statSync2(join6(SLACK_AGENT_DIR, "pane.log")).mtimeMs;
+          const paneMtimeMs = statSync2(join7(SLACK_AGENT_DIR, "pane.log")).mtimeMs;
           paneLogFreshAgeMs = Math.max(0, Date.now() - paneMtimeMs);
         } catch {
         }