@integrity-labs/agt-cli 0.27.92 → 0.27.94

package/dist/bin/agt.js

@@ -28,7 +28,7 @@ import {
   success,
   table,
   warn
-} from "../chunk-FXXCD523.js";
+} from "../chunk-2ITGJXXM.js";
 import {
   CHANNEL_REGISTRY,
   DEPLOYMENT_TEMPLATES,
@@ -4934,7 +4934,7 @@ import { execFileSync, execSync } from "child_process";
 import { existsSync as existsSync10, realpathSync as realpathSync2 } from "fs";
 import chalk18 from "chalk";
 import ora16 from "ora";
-var cliVersion = true ? "0.27.92" : "dev";
+var cliVersion = true ? "0.27.94" : "dev";
 async function fetchLatestVersion() {
   const host2 = getHost();
   if (!host2) return null;
@@ -5857,7 +5857,7 @@ function handleError(err) {
 }
 
 // src/bin/agt.ts
-var cliVersion2 = true ? "0.27.92" : "dev";
+var cliVersion2 = true ? "0.27.94" : "dev";
 var program = new Command();
 program.name("agt").description("Augmented CLI \u2014 agent provisioning and management").version(cliVersion2).option("--json", "Emit machine-readable JSON output (suppress spinners and colors)").option("--skip-update-check", "Skip the automatic update check on startup");
 program.hook("preAction", async (thisCommand, actionCommand) => {

package/dist/{chunk-FXXCD523.js → chunk-2ITGJXXM.js}

@@ -7578,4 +7578,4 @@ export {
   managerInstallSystemUnitCommand,
   managerUninstallSystemUnitCommand
 };
-//# sourceMappingURL=chunk-FXXCD523.js.map
+//# sourceMappingURL=chunk-2ITGJXXM.js.map

package/dist/lib/manager-worker.js

@@ -16,7 +16,7 @@ import {
   provisionStopHook,
   requireHost,
   safeWriteJsonAtomic
-} from "../chunk-FXXCD523.js";
+} from "../chunk-2ITGJXXM.js";
 import {
   getProjectDir as getProjectDir2,
   getReadyTasks,
@@ -3996,7 +3996,7 @@ var cachedMaintenanceWindow = null;
 var lastVersionCheckAt = 0;
 var VERSION_CHECK_INTERVAL_MS = 5 * 60 * 1e3;
 var lastResponsivenessProbeAt = 0;
-var agtCliVersion = true ? "0.27.92" : "dev";
+var agtCliVersion = true ? "0.27.94" : "dev";
 function resolveBrewPath(execFileSync4) {
   try {
     const out = execFileSync4("which", ["brew"], { timeout: 5e3 }).toString().trim();

package/dist/mcp/slack-channel.js

@@ -6986,13 +6986,10 @@ __export(slack_block_kit_runtime_exports, {
   DEFAULT_ASK_USER_LIMITS: () => DEFAULT_ASK_USER_LIMITS,
   apiCall: () => apiCall,
   buildAskUserBlocks: () => buildAskUserBlocks,
-  buildRatingActionsBlock: () => buildRatingActionsBlock,
   createPendingInteraction: () => createPendingInteraction,
   decodeActionId: () => decodeActionId,
-  defaultRatingLabels: () => defaultRatingLabels,
   encodeActionId: () => encodeActionId,
   generateOptionToken: () => generateOptionToken,
-  ratingValuesForScale: () => ratingValuesForScale,
   recordSlackDelivery: () => recordSlackDelivery,
   resolveInteractive: () => resolveInteractive,
   updatePendingInteractionMessageTs: () => updatePendingInteractionMessageTs,
@@ -7159,22 +7156,6 @@ function buildAskUserBlocks(opts) {
     }
   ];
 }
-function ratingValuesForScale(scale) {
-  return scale === "1-5" ? [1, 2, 3, 4, 5] : [-1, 0, 1];
-}
-function defaultRatingLabels(scale) {
-  return scale === "1-5" ? ["1", "2", "3", "4", "5"] : ["\u{1F44E}", "\u{1F914}", "\u{1F44D}"];
-}
-function buildRatingActionsBlock(opts) {
-  return {
-    type: "actions",
-    elements: opts.options.map(({ label, token }) => ({
-      type: "button",
-      text: { type: "plain_text", text: label },
-      action_id: encodeActionId(opts.callbackId, token)
-    }))
-  };
-}
 async function resolveInteractive(cfg, input) {
   const res = await apiCall(cfg, "POST", "/host/interactive/resolve", {
     agent_id: cfg.agentId,
@@ -17212,7 +17193,7 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
     ...blockKitToolsAvailable() ? [
       {
         name: "slack.send_structured",
-        description: 'Send a Slack message built from Block Kit blocks (structured layout: headers, sections, dividers, context, action buttons). Use when plain text isn\'t enough \u2014 status reports, confirmations with multiple fields, calls-to-action with buttons. Pass a `text` fallback for push notifications. Returns { message_ts, permalink }. Does NOT block waiting for user interactions; for that use slack.ask_user. Pass `interactive: { type: "rate_run", run_id }` to append a 1-5 rating button row that records the score against this scheduled-task run (ENG-4572).',
+        description: "Send a Slack message built from Block Kit blocks (structured layout: headers, sections, dividers, context, action buttons). Use when plain text isn't enough \u2014 status reports, confirmations with multiple fields, calls-to-action with buttons. Pass a `text` fallback for push notifications. Returns { message_ts, permalink }. Does NOT block waiting for user interactions; for that use slack.ask_user.",
         inputSchema: {
           type: "object",
           properties: {
@@ -17222,18 +17203,7 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
               description: "Array of Block Kit blocks. Supported block types: header, section, divider, context, actions. Supported interactive elements (inside actions blocks): button. Hard limits: 50 blocks per message, 5 elements per actions block, 3000 chars per section text, 75 chars per button label."
             },
             text: { type: "string", description: "Plain-text fallback for push notifications and unfurls. Required." },
-            thread_ts: { type: "string", description: "Thread timestamp for threaded replies (optional)" },
-            interactive: {
-              type: "object",
-              description: `Optional interactive affordance appended to the message. Currently supports type="rate_run" \u2014 appends a 1-5 button row that updates this run's rating when tapped. Use after a scheduled-task delivery so users can rate the firing.`,
-              properties: {
-                type: { type: "string", enum: ["rate_run"], description: 'Affordance kind. Only "rate_run" is supported today.' },
-                run_id: { type: "string", description: "The runs.run_id this rating belongs to (returned by /host/runs/start)." },
-                scale: { type: "string", enum: ["1-5", "sentiment"], description: 'Rating scale. Default "1-5" (1..5 buttons). "sentiment" emits \u{1F44E}/\u{1F914}/\u{1F44D} mapping to -1/0/+1 \u2014 reserved for future Telegram parity.' },
-                expires_in_seconds: { type: "number", description: "How long the rating row stays tappable. Default 86400 (24h). The pending row times out after this; later taps are ignored." }
-              },
-              required: ["type", "run_id"]
-            }
+            thread_ts: { type: "string", description: "Thread timestamp for threaded replies (optional)" }
           },
           required: ["channel", "blocks", "text"]
         }
@@ -17908,7 +17878,7 @@ async function handleSendStructured(args) {
   }
   const runtime = await Promise.resolve().then(() => (init_slack_block_kit_runtime(), slack_block_kit_runtime_exports));
   const { validateSlackBlocks: validateSlackBlocks2 } = runtime;
-  const { channel, blocks, text, thread_ts, interactive } = args;
+  const { channel, blocks, text, thread_ts } = args;
   if (typeof channel !== "string" || !channel) {
     return errResult("channel is required");
   }
@@ -17920,97 +17890,16 @@ async function handleSendStructured(args) {
   if (!validation.ok) {
     return errResult(`Invalid blocks: ${validation.errors.map((e) => `${e.path}: ${e.message}`).join("; ")}`);
   }
-  let effectiveBlocks = blocks;
-  let ratingCallbackId = null;
-  let ratingExpiresAt = null;
-  let ratingTokenised = [];
-  if (interactive) {
-    if (interactive.type !== "rate_run") {
-      return errResult(`Unsupported interactive.type '${interactive.type}'. Supported: rate_run.`);
-    }
-    if (typeof interactive.run_id !== "string" || !interactive.run_id) {
-      return errResult("interactive.run_id is required when interactive is set");
-    }
-    if (!interactiveHostAvailable()) {
-      return errResult(
-        "interactive=rate_run requires Block Kit plus host MCP wiring (AGT_HOST, AGT_API_KEY, AGT_AGENT_ID)."
-      );
-    }
-    const scale = interactive.scale === "sentiment" ? "sentiment" : "1-5";
-    const requestedTtl = typeof interactive.expires_in_seconds === "number" ? interactive.expires_in_seconds : 86400;
-    const ttl = Math.max(60, Math.min(7 * 86400, requestedTtl));
-    const { randomUUID: rndUUID } = await import("crypto");
-    ratingCallbackId = rndUUID();
-    ratingExpiresAt = new Date(Date.now() + ttl * 1e3);
-    const values = runtime.ratingValuesForScale(scale);
-    const labels = runtime.defaultRatingLabels(scale);
-    ratingTokenised = values.map((v, i) => ({
-      token: runtime.generateOptionToken(),
-      value: String(v),
-      label: labels[i] ?? String(v)
-    }));
-    const ratingBlock = runtime.buildRatingActionsBlock({
-      callbackId: ratingCallbackId,
-      options: ratingTokenised.map(({ label, token }) => ({
-        // The numeric value is carried by token → options mapping in the
-        // pending_interaction row, not by the button itself, so this
-        // cast-back to RatingOption only needs label + token + a placeholder.
-        value: 0,
-        label,
-        token
-      }))
-    });
-    effectiveBlocks = [...blocks, ratingBlock];
-    const finalValidation = runtime.validateSlackBlocks(effectiveBlocks);
-    if (!finalValidation.ok) {
-      return errResult(
-        `Invalid blocks (after appending rating row): ${finalValidation.errors.map((e) => `${e.path}: ${e.message}`).join("; ")}`
-      );
-    }
-    const cfg = {
-      apiHost: AGT_HOST,
-      apiKey: AGT_API_KEY,
-      agentId: AGT_AGENT_ID
-    };
-    try {
-      await runtime.createPendingInteraction(cfg, {
-        callbackId: ratingCallbackId,
-        channelId: channel,
-        messageTs: "",
-        threadTs: thread_ts,
-        options: ratingTokenised,
-        expiresAt: ratingExpiresAt,
-        kind: "rate_run",
-        kindData: { run_id: interactive.run_id, scale }
-      });
-    } catch (err) {
-      return errResult(`Failed to register rating row: ${err.message}`);
-    }
-  }
   const result = await postSlackMessageWithTs({
     channel,
-    blocks: effectiveBlocks,
+    blocks,
     text,
     ...thread_ts ? { thread_ts } : {}
   });
   if (!result.ok || !result.ts) {
     return errResult(`Slack chat.postMessage failed: ${result.error ?? "unknown"}`);
   }
-  if (ratingCallbackId) {
-    try {
-      await runtime.updatePendingInteractionMessageTs(
-        { apiHost: AGT_HOST, apiKey: AGT_API_KEY, agentId: AGT_AGENT_ID },
-        ratingCallbackId,
-        result.ts
-      );
-    } catch (err) {
-      process.stderr.write(
-        `slack-channel(${AGENT_CODE_NAME}): updatePendingInteractionMessageTs failed for rating ${hashId(ratingCallbackId)}: ${err.message}
-`
-      );
-    }
-  }
-  if (interactiveHostAvailable() && !ratingCallbackId) {
+  if (interactiveHostAvailable()) {
     const cfg = {
       apiHost: AGT_HOST,
       apiKey: AGT_API_KEY,
@@ -18040,8 +17929,7 @@ async function handleSendStructured(args) {
         type: "text",
         text: JSON.stringify({
           message_ts: result.ts,
-          permalink: permalink ?? "",
-          ...ratingCallbackId ? { rating_callback_id: ratingCallbackId } : {}
+          permalink: permalink ?? ""
         })
       }
     ]

package/dist/mcp/telegram-channel.js

@@ -6986,13 +6986,10 @@ __export(slack_block_kit_runtime_exports, {
   DEFAULT_ASK_USER_LIMITS: () => DEFAULT_ASK_USER_LIMITS,
   apiCall: () => apiCall,
   buildAskUserBlocks: () => buildAskUserBlocks,
-  buildRatingActionsBlock: () => buildRatingActionsBlock,
   createPendingInteraction: () => createPendingInteraction,
   decodeActionId: () => decodeActionId,
-  defaultRatingLabels: () => defaultRatingLabels,
   encodeActionId: () => encodeActionId,
   generateOptionToken: () => generateOptionToken,
-  ratingValuesForScale: () => ratingValuesForScale,
   recordSlackDelivery: () => recordSlackDelivery,
   resolveInteractive: () => resolveInteractive,
   updatePendingInteractionMessageTs: () => updatePendingInteractionMessageTs,
@@ -7159,22 +7156,6 @@ function buildAskUserBlocks(opts) {
     }
   ];
 }
-function ratingValuesForScale(scale) {
-  return scale === "1-5" ? [1, 2, 3, 4, 5] : [-1, 0, 1];
-}
-function defaultRatingLabels(scale) {
-  return scale === "1-5" ? ["1", "2", "3", "4", "5"] : ["\u{1F44E}", "\u{1F914}", "\u{1F44D}"];
-}
-function buildRatingActionsBlock(opts) {
-  return {
-    type: "actions",
-    elements: opts.options.map(({ label, token }) => ({
-      type: "button",
-      text: { type: "plain_text", text: label },
-      action_id: encodeActionId(opts.callbackId, token)
-    }))
-  };
-}
 async function resolveInteractive(cfg, input) {
   const res = await apiCall(cfg, "POST", "/host/interactive/resolve", {
     agent_id: cfg.agentId,
@@ -14545,23 +14526,33 @@ var DEFAULT_THROTTLE = {
   windowMs: 12e4,
   ringSize: 8
 };
-function decideReplyThrottle(input) {
+var DEFAULT_REPLY_QUEUE_DEPTH = 2;
+function planReplyDelivery(input) {
   const cfg = input.config ?? DEFAULT_THROTTLE;
+  const maxDepth = input.maxQueueDepth ?? DEFAULT_REPLY_QUEUE_DEPTH;
   const cutoff = input.now - cfg.windowMs;
-  const inWindow = input.recentReplyTimestamps.filter((t) => t >= cutoff);
-  if (inWindow.length >= cfg.threshold) {
-    return {
-      allow: false,
-      recentCount: inWindow.length,
-      reason: "throttle_threshold_exceeded"
-    };
+  const inWindow = input.recentReplyTimestamps.filter((t) => t >= cutoff).sort((a, b) => a - b);
+  const occupancy = inWindow.length + input.queuedCount;
+  if (occupancy < cfg.threshold) {
+    return { action: "send", recentCount: inWindow.length, reason: "under_threshold" };
+  }
+  if (input.queuedCount >= maxDepth) {
+    return { action: "refuse", recentCount: inWindow.length, reason: "queue_full" };
   }
+  const idx = Math.min(input.queuedCount, inWindow.length - 1);
+  const opensAt = (inWindow[idx] ?? input.now) + cfg.windowMs;
   return {
-    allow: true,
+    action: "queue",
+    deliverAtMs: Math.max(opensAt, input.now),
     recentCount: inWindow.length,
-    reason: "under_threshold"
+    reason: "queued_for_slot"
   };
 }
+function relaxedThrottleConfig(cfg, env = process.env, envVar = "TELEGRAM_PRIVATE_REPLY_THROTTLE_COUNT") {
+  const raw = Number(env[envVar]);
+  const threshold = Number.isFinite(raw) && raw > 0 ? raw : cfg.threshold * 2;
+  return { ...cfg, threshold, ringSize: Math.max(cfg.ringSize, threshold + 2) };
+}
 var buffers = /* @__PURE__ */ new Map();
 function key(channelId, threadKey) {
   return `${channelId}
${threadKey}`;
@@ -16320,6 +16311,54 @@ var orphanSweepTimer = setInterval(() => {
   sweepTelegramStaleMarkers(sessionAlive ? channelOrphanMarkerMs() : STALE_MARKER_MS);
 }, orphanSweepIntervalMs());
 orphanSweepTimer.unref?.();
+var queuedReplyCounts = /* @__PURE__ */ new Map();
+function _resetQueuedReplyCountsForTests() {
+  queuedReplyCounts.clear();
+}
+async function deliverQueuedReply(p) {
+  const remaining = (queuedReplyCounts.get(p.chatId) ?? 1) - 1;
+  if (remaining <= 0) queuedReplyCounts.delete(p.chatId);
+  else queuedReplyCounts.set(p.chatId, remaining);
+  try {
+    const killed = await isThreadKilled({
+      channelType: "telegram",
+      channelId: p.chatId,
+      threadTs: "",
+      agtHost: AGT_HOST,
+      agtApiKey: AGT_API_KEY
+    });
+    if (killed) {
+      process.stderr.write(
+        `telegram-channel(${AGENT_CODE_NAME}): reply_queue_dropped reason=killed chat=${redactId(p.chatId)}
+`
+      );
+      return;
+    }
+    const body = { chat_id: p.chatId, text: p.text };
+    if (p.replyToMessageId) body.reply_to_message_id = Number(p.replyToMessageId);
+    const data = await telegramApiCall("sendMessage", body, 15e3);
+    if (!data.ok) {
+      process.stderr.write(
+        `telegram-channel(${AGENT_CODE_NAME}): reply_queue_failed chat=${redactId(p.chatId)} error=${data.description ?? "unknown"}
+`
+      );
+      return;
+    }
+    recordReply(p.chatId, "", Date.now(), p.throttleCfg);
+    if (p.isReplyTool) {
+      clearPendingMessage(p.chatId, p.replyToMessageId);
+    }
+    process.stderr.write(
+      `telegram-channel(${AGENT_CODE_NAME}): reply_queue_delivered chat=${redactId(p.chatId)}
+`
+    );
+  } catch (err) {
+    process.stderr.write(
+      `telegram-channel(${AGENT_CODE_NAME}): reply_queue_failed chat=${redactId(p.chatId)} error=${err.message}
+`
+    );
+  }
+}
 function clearPendingMessage(chatId, messageId) {
   if (messageId) {
     clearPendingInboundMarker(chatId, messageId);
@@ -16553,28 +16592,56 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
         isError: true
       };
     }
-    const tgThrottleCfg = configFromEnv();
+    const isPrivateChat = !chat_id.startsWith("-");
+    const tgThrottleCfg = isPrivateChat ? relaxedThrottleConfig(configFromEnv()) : configFromEnv();
     const tgThrottleNow = Date.now();
-    const tgThrottleDecision = decideReplyThrottle({
+    const tgPlan = planReplyDelivery({
       recentReplyTimestamps: getRecentReplies(chat_id, "", tgThrottleNow, tgThrottleCfg),
+      queuedCount: queuedReplyCounts.get(chat_id) ?? 0,
       now: tgThrottleNow,
       config: tgThrottleCfg
     });
-    if (!tgThrottleDecision.allow) {
+    if (tgPlan.action === "refuse") {
       process.stderr.write(
-        `telegram-channel(${AGENT_CODE_NAME}): reply_throttled chat=${redactId(chat_id)} count=${tgThrottleDecision.recentCount} window_ms=${tgThrottleCfg.windowMs} threshold=${tgThrottleCfg.threshold}
+        `telegram-channel(${AGENT_CODE_NAME}): reply_throttled chat=${redactId(chat_id)} count=${tgPlan.recentCount} queued=${queuedReplyCounts.get(chat_id) ?? 0} window_ms=${tgThrottleCfg.windowMs} threshold=${tgThrottleCfg.threshold}
 `
       );
       return {
         content: [
           {
             type: "text",
-            text: `Reply throttled: ${tgThrottleDecision.recentCount} replies from this agent to this chat within the last ${Math.round(tgThrottleCfg.windowMs / 1e3)}s (threshold ${tgThrottleCfg.threshold}). The chat is paused for this agent until a human posts in it. Stop attempting to reply.`
+            text: `Reply throttled: ${tgPlan.recentCount} replies from this agent to this chat within the last ${Math.round(tgThrottleCfg.windowMs / 1e3)}s (threshold ${tgThrottleCfg.threshold}) and the delivery queue is full. The chat is paused for this agent until a human posts in it. Stop attempting to reply.`
           }
         ],
         isError: true
       };
     }
+    if (tgPlan.action === "queue" && tgPlan.deliverAtMs !== void 0) {
+      const delayMs = Math.max(0, tgPlan.deliverAtMs - tgThrottleNow);
+      queuedReplyCounts.set(chat_id, (queuedReplyCounts.get(chat_id) ?? 0) + 1);
+      process.stderr.write(
+        `telegram-channel(${AGENT_CODE_NAME}): reply_queued chat=${redactId(chat_id)} delay_ms=${delayMs} count=${tgPlan.recentCount} threshold=${tgThrottleCfg.threshold}
+`
+      );
+      const timer = setTimeout(() => {
+        void deliverQueuedReply({
+          chatId: chat_id,
+          text,
+          replyToMessageId: reply_to_message_id,
+          isReplyTool: name === "telegram.reply",
+          throttleCfg: tgThrottleCfg
+        });
+      }, delayMs);
+      timer.unref();
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Reply queued, not yet sent: the reply-rate window is full (${tgPlan.recentCount} recent sends, threshold ${tgThrottleCfg.threshold}). It will be delivered automatically in ~${Math.ceil(delayMs / 1e3)}s. Do not re-send this message; avoid further sends to this chat until it delivers.`
+          }
+        ]
+      };
+    }
     try {
       const body = { chat_id, text };
       if (reply_to_message_id) body.reply_to_message_id = Number(reply_to_message_id);
@@ -17403,5 +17470,6 @@ pollLoop().catch((err) => {
 });
 export {
   __resetBackOnlineNoticeThrottle,
-  __resetUndeliverableNoticeThrottle
+  __resetUndeliverableNoticeThrottle,
+  _resetQueuedReplyCountsForTests
 };

package/package.json

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