@integrity-labs/agt-cli 0.28.60 → 0.28.62

package/dist/mcp/telegram-channel.js

@@ -14982,6 +14982,17 @@ function politeDeclineCopy(reason) {
       return "Sorry, I only respond to other agents in this channel.";
   }
 }
+function decideDeclineReply(input) {
+  const last = input.cache.get(input.key);
+  if (last !== void 0) {
+    const elapsed = input.now - last;
+    if (elapsed < input.cooldownMs) {
+      return { reply: false, remainingMs: input.cooldownMs - elapsed };
+    }
+  }
+  input.cache.set(input.key, input.now);
+  return { reply: true };
+}
 
 // src/inbound-access.ts
 function decideInboundAccess(input) {
@@ -15022,6 +15033,56 @@ function decideInboundAccess(input) {
   return { kind: "admit" };
 }
 
+// src/flags-cache-read.ts
+import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join2 } from "path";
+function defaultFlagsCachePath() {
+  return join2(homedir2(), ".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 (!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[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/maintenance-mode.ts
+var FLAG_KEY = "platform-maintenance-mode";
+var MAINTENANCE_OFFLINE_MESSAGE = "The Augmented Team platform is offline for scheduled maintenance right now, so I can't pick this up \u2014 please try again shortly.";
+function isMaintenanceModeActive(opts) {
+  return resolveHostBooleanFlag({
+    key: FLAG_KEY,
+    envVar: "",
+    defaultValue: false,
+    cachePath: opts?.cachePath,
+    env: opts?.env
+  });
+}
+
 // src/watch-command.ts
 var WATCH_DEFAULT_DURATION_MS = 2 * 60 * 60 * 1e3;
 var WATCH_MAX_DURATION_MS = 7 * 24 * 60 * 60 * 1e3;
@@ -15633,15 +15694,15 @@ function buildCommandRegistrations() {
 }
 
 // src/agent-config-state.ts
-import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
-import { join as join2 } from "path";
+import { existsSync as existsSync3, readFileSync as readFileSync4 } 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 (!existsSync2(path)) return null;
+  const path = join3(stateDir, SESSION_STATE_FILENAME);
+  if (!existsSync3(path)) return null;
   try {
-    const parsed = JSON.parse(readFileSync3(path, "utf-8"));
+    const parsed = JSON.parse(readFileSync4(path, "utf-8"));
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return null;
     return parsed;
   } catch {
@@ -16155,11 +16216,11 @@ var TELEGRAM_EGRESS_TOOLS = /* @__PURE__ */ new Set([
 ]);
 
 // src/telegram-pending-inbound-cleanup.ts
-import { readdirSync, readFileSync as readFileSync4, statSync } from "fs";
-import { join as join3 } from "path";
+import { readdirSync, readFileSync as readFileSync5, statSync } from "fs";
+import { join as join4 } from "path";
 function markerArrivalMs(fullPath) {
   try {
-    const received = JSON.parse(readFileSync4(fullPath, "utf-8")).received_at;
+    const received = JSON.parse(readFileSync5(fullPath, "utf-8")).received_at;
     const parsed = received ? Date.parse(received) : Number.NaN;
     if (Number.isFinite(parsed)) return parsed;
   } catch {
@@ -16183,7 +16244,7 @@ function clearAllTelegramPendingMarkersForChat(pendingDir, chatId, clearMarkerFi
   for (const filename of filenames) {
     if (!filename.startsWith(prefix)) continue;
     if (!filename.endsWith(".json")) continue;
-    const fullPath = join3(pendingDir, filename);
+    const fullPath = join4(pendingDir, filename);
     if (bounded && markerArrivalMs(fullPath) > cutoffMs) continue;
     clearMarkerFile(fullPath);
     cleared++;
@@ -16193,14 +16254,14 @@ function clearAllTelegramPendingMarkersForChat(pendingDir, chatId, clearMarkerFi
 
 // src/mcp-spawn-lock.ts
 import {
-  existsSync as existsSync3,
+  existsSync as existsSync4,
   mkdirSync as mkdirSync4,
-  readFileSync as readFileSync5,
+  readFileSync as readFileSync6,
   renameSync as renameSync3,
   unlinkSync as unlinkSync4,
   writeFileSync as writeFileSync4
 } from "fs";
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 function defaultIsPidAlive(pid) {
   if (!Number.isFinite(pid) || pid <= 0) return false;
   try {
@@ -16218,7 +16279,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 = join4(agentDir, basename);
+  const path = join5(agentDir, basename);
   const existing = readLockHolder(path);
   if (existing) {
     if (existing.pid === selfPid) {
@@ -16247,9 +16308,9 @@ function releaseMcpSpawnLock(lockPath, opts = {}) {
   }
 }
 function readLockHolder(path) {
-  if (!existsSync3(path)) return null;
+  if (!existsSync4(path)) return null;
   try {
-    const raw = readFileSync5(path, "utf8");
+    const raw = readFileSync6(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;
@@ -16263,45 +16324,6 @@ function readLockHolder(path) {
 // src/ack-reaction.ts
 import { readdirSync as readdirSync2, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
 import { join as join6 } from "path";
-
-// src/flags-cache-read.ts
-import { existsSync as existsSync4, readFileSync as readFileSync6 } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join5 } from "path";
-function defaultFlagsCachePath() {
-  return join5(homedir2(), ".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 (!existsSync4(path)) return void 0;
-    const parsed = JSON.parse(readFileSync6(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;
@@ -16667,6 +16689,53 @@ function telegramApiCall(method, body, timeoutMs) {
     req.end();
   });
 }
+var TELEGRAM_MAINTENANCE_NOTICE_CACHE = /* @__PURE__ */ new Map();
+var TELEGRAM_MAINTENANCE_COOLDOWN_MS = (() => {
+  const raw = process.env["TELEGRAM_MAINTENANCE_NOTICE_COOLDOWN_SEC"];
+  const n = raw ? Number(raw) : NaN;
+  return Number.isFinite(n) && n >= 0 ? n * 1e3 : 1800 * 1e3;
+})();
+async function maybeSendTelegramMaintenanceNotice(args) {
+  if (args.senderId === void 0) return;
+  const key2 = `${args.chatId}|${args.senderId}|maintenance`;
+  const decision = decideDeclineReply({
+    cache: TELEGRAM_MAINTENANCE_NOTICE_CACHE,
+    key: key2,
+    cooldownMs: TELEGRAM_MAINTENANCE_COOLDOWN_MS,
+    now: Date.now()
+  });
+  if (!decision.reply) {
+    process.stderr.write(
+      `telegram-channel(${AGENT_CODE_NAME}): maintenance notice suppressed by cooldown (chat=${redactId(String(args.chatId))}, remaining=${decision.remainingMs}ms)
+`
+    );
+    return;
+  }
+  try {
+    const resp = await telegramApiCall(
+      "sendMessage",
+      {
+        chat_id: args.chatId,
+        text: MAINTENANCE_OFFLINE_MESSAGE,
+        ...args.messageThreadId != null ? { message_thread_id: args.messageThreadId } : {}
+      },
+      1e4
+    );
+    if (!resp.ok) {
+      TELEGRAM_MAINTENANCE_NOTICE_CACHE.delete(key2);
+      process.stderr.write(
+        `telegram-channel(${AGENT_CODE_NAME}): maintenance notice rejected (chat=${redactId(String(args.chatId))}): ${resp.description ?? "unknown"}
+`
+      );
+    }
+  } catch (err) {
+    TELEGRAM_MAINTENANCE_NOTICE_CACHE.delete(key2);
+    process.stderr.write(
+      `telegram-channel(${AGENT_CODE_NAME}): maintenance notice failed: ${err.message}
+`
+    );
+  }
+}
 var ACK_EMOJI = (process.env.TELEGRAM_ACK_REACTION ?? "").trim() || "\u{1F440}";
 var TELEGRAM_SKIP_REACTION = (process.env.TELEGRAM_SKIP_REACTION ?? "").trim();
 async function setMessageReaction(chatId, messageId, emoji2) {
@@ -16903,6 +16972,8 @@ function buildTelegramHelpMessage(codeName) {
     `\u2022 /status \u2014 this agent's model, session origin, uptime + connectivity`,
     `\u2022 /watch <google-doc-url> [duration] \u2014 watch a Google Doc for comments that mention me (default 2h, max 7d; auto-pauses when the window ends)`,
     `\u2022 /restart \u2014 restart this agent`,
+    `\u2022 /onboard \u2014 restart this agent's onboarding from scratch`,
+    `\u2022 /resume-onboarding \u2014 resume this agent's onboarding where it left off`,
     `\u2022 /investigate-${codeName} \u2014 live tail of this agent's terminal pane (DM only; team owners/admins and the agent's reports-to person)`
   ].join("\n");
 }
@@ -17021,6 +17092,62 @@ async function handleStatusCommand(opts) {
     );
   }
 }
+async function handleOnboardingCommand(opts) {
+  const verb = opts.mode === "reset" ? "/onboard" : "/resume-onboarding";
+  const reply = async (text) => {
+    try {
+      const resp = await telegramApiCall(
+        "sendMessage",
+        { chat_id: opts.chatId, text, reply_to_message_id: Number(opts.messageId) },
+        1e4
+      );
+      if (!resp.ok) {
+        process.stderr.write(
+          `telegram-channel(${AGENT_CODE_NAME}): ${verb} reply rejected (chat ${redactId(opts.chatId)}): ${resp.description ?? "unknown"}
+`
+        );
+      }
+    } catch (err) {
+      process.stderr.write(
+        `telegram-channel(${AGENT_CODE_NAME}): ${verb} reply send failed: ${redactAugmentedPaths(err.message)}
+`
+      );
+    }
+  };
+  if (!AGT_HOST || !AGT_API_KEY || !AGT_AGENT_ID) {
+    process.stderr.write(
+      `telegram-channel(${AGENT_CODE_NAME}): ${verb} missing AGT_* env \u2014 cannot reach host runtime
+`
+    );
+    await reply(`\u26A0\uFE0F This agent has no host API wiring \u2014 ${verb} needs the host runtime to be reachable.`);
+    return;
+  }
+  try {
+    const res = await fetch(`${AGT_HOST}/host/onboarding/${opts.mode}`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json; charset=utf-8",
+        Authorization: `Bearer ${AGT_API_KEY}`
+      },
+      body: JSON.stringify({ agent_id: AGT_AGENT_ID }),
+      signal: AbortSignal.timeout(1e4)
+    });
+    const data = await res.json();
+    process.stderr.write(
+      `telegram-channel(${AGENT_CODE_NAME}): ${verb} forwarded (ok=${data.ok}) from chat ${redactId(opts.chatId)}
+`
+    );
+    await reply(
+      data.ok ? `\u{1F504} ${data.message ?? "Onboarding updated."}` : `\u274C ${verb} failed${data.error ? `: ${data.error}` : "."}`
+    );
+  } catch (err) {
+    process.stderr.write(
+      `telegram-channel(${AGENT_CODE_NAME}): ${verb} forward failed: ${redactAugmentedPaths(err.message)}
+`
+    );
+    await reply(`\u274C ${verb} forwarding failed \u2014 host runtime unreachable. Try again in a moment.`);
+  }
+}
 async function handleRestartCommand(opts) {
   try {
     if (!existsSync5(RESTART_FLAGS_DIR)) {
@@ -17397,6 +17524,14 @@ var WATCH_SYNTAX_RE = /^\/watch(?:@([A-Za-z0-9_]{1,64}))?(?:\s|$)/;
 function isWatchSyntax(text) {
   return WATCH_SYNTAX_RE.test(text);
 }
+var ONBOARD_SYNTAX_RE = /^\/onboard(?:@([A-Za-z0-9_]{1,64}))?(?:\s|$)/;
+var RESUME_ONBOARDING_SYNTAX_RE = /^\/resume-onboarding(?:@([A-Za-z0-9_]{1,64}))?(?:\s|$)/;
+function isOnboardSyntax(text) {
+  return ONBOARD_SYNTAX_RE.test(text);
+}
+function isResumeOnboardingSyntax(text) {
+  return RESUME_ONBOARDING_SYNTAX_RE.test(text);
+}
 function isRestartSyntax(text) {
   return RESTART_SYNTAX_RE.test(text);
 }
@@ -18722,7 +18857,11 @@ async function pollLoop() {
         const trimmedContent = content.trim();
         const isFromBot = !!msg.from?.is_bot;
         const nowMs = Date.now();
-        const telegramCommand = isHelpSyntax(trimmedContent) ? "help" : isStatusSyntax(trimmedContent) ? "status" : isWatchSyntax(trimmedContent) ? "watch" : isRestartSyntax(trimmedContent) ? "restart" : isInvestigateSyntax(trimmedContent) ? "investigate" : void 0;
+        const telegramCommand = isHelpSyntax(trimmedContent) ? "help" : isStatusSyntax(trimmedContent) ? "status" : isWatchSyntax(trimmedContent) ? "watch" : (
+          // ENG-6511: check /resume-onboarding before /onboard for clarity
+          // (the prefixes are disjoint, so order is not load-bearing).
+          isResumeOnboardingSyntax(trimmedContent) ? "resume-onboarding" : isOnboardSyntax(trimmedContent) ? "onboard" : isRestartSyntax(trimmedContent) ? "restart" : isInvestigateSyntax(trimmedContent) ? "investigate" : void 0
+        );
         let classification;
         let peerLeaf;
         if (isFromBot) {
@@ -18820,6 +18959,23 @@ async function pollLoop() {
           }
           continue;
         }
+        if (access.kind === "command" && (access.command === "onboard" || access.command === "resume-onboarding")) {
+          const cmdToken = access.command === "onboard" ? "/onboard" : "/resume-onboarding";
+          const disposition = await classifyRestartCommand(
+            trimmedContent.replace(
+              new RegExp(`^${cmdToken}(@[A-Za-z0-9_]{1,64})?`),
+              "/restart$1"
+            )
+          );
+          if (disposition === "act") {
+            await handleOnboardingCommand({
+              chatId,
+              messageId: String(msg.message_id),
+              mode: access.command === "onboard" ? "reset" : "resume"
+            });
+          }
+          continue;
+        }
         if (access.kind === "command" && access.command === "restart") {
           const disposition = await classifyRestartCommand(trimmedContent);
           if (disposition === "act") {
@@ -18908,6 +19064,18 @@ async function pollLoop() {
           }
           continue;
         }
+        if (!isFromBot && isMaintenanceModeActive()) {
+          process.stderr.write(
+            `telegram-channel(${AGENT_CODE_NAME}): maintenance-mode active \u2014 offline notice, no dispatch (chat=${redactId(chatId)})
+`
+          );
+          await maybeSendTelegramMaintenanceNotice({
+            chatId,
+            senderId: userId,
+            messageThreadId: msg.message_thread_id
+          });
+          continue;
+        }
         if (isFromBot && classification?.kind === "peer-ingress") {
           const limit = await peerRateLimiter.recordInboundPeer(
             chatId,

package/dist/{persistent-session-3W3TQK73.js → persistent-session-5PEPYSMG.js}

@@ -25,8 +25,8 @@ import {
   takeZombieDetection,
   writeDirectChatSessionState,
   writePersistentClaudeWrapper
-} from "./chunk-IGP67S2Z.js";
-import "./chunk-BCWB6A4G.js";
+} from "./chunk-AKOF4VV5.js";
+import "./chunk-7F2K3RRD.js";
 import "./chunk-XWVM4KPK.js";
 export {
   SEND_KEYS_ENTER_DELAY_MS,
@@ -56,4 +56,4 @@ export {
   writeDirectChatSessionState,
   writePersistentClaudeWrapper
 };
-//# sourceMappingURL=persistent-session-3W3TQK73.js.map
+//# sourceMappingURL=persistent-session-5PEPYSMG.js.map

package/dist/{responsiveness-probe-5MXY5KYZ.js → responsiveness-probe-HG23JDG2.js}

@@ -1,7 +1,7 @@
 import {
   paneLogPath
-} from "./chunk-IGP67S2Z.js";
-import "./chunk-BCWB6A4G.js";
+} from "./chunk-AKOF4VV5.js";
+import "./chunk-7F2K3RRD.js";
 import "./chunk-XWVM4KPK.js";
 
 // src/lib/responsiveness-probe.ts
@@ -250,4 +250,4 @@ export {
   parkPendingInbound,
   readAndResetChannelDeflections
 };
-//# sourceMappingURL=responsiveness-probe-5MXY5KYZ.js.map
+//# sourceMappingURL=responsiveness-probe-HG23JDG2.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@integrity-labs/agt-cli",
-  "version": "0.28.60",
+  "version": "0.28.62",
   "description": "Augmented Team CLI — agent provisioning and management",
   "type": "module",
   "engines": {