@integrity-labs/agt-cli 0.28.153 → 0.28.155

package/dist/mcp/direct-chat-channel.js

@@ -14035,6 +14035,54 @@ function emitPreambleStripTelemetry(channel, shape) {
   }
 }
 
+// src/transient-api-error.ts
+var CODE_KIND = {
+  "429": "rate_limit",
+  "500": "server_error",
+  "503": "unavailable",
+  "529": "overloaded"
+};
+var FRIENDLY_TRANSIENT_MESSAGE = "Sorry, I hit a brief technical hiccup just now and couldn't finish that. Please give me a moment and try again shortly.";
+function detectTransientApiError(text) {
+  if (!text) return null;
+  const head = text.replace(/^\s+/, "").slice(0, 200);
+  const code = head.match(/^api error:\s*(\d{3})\b/i)?.[1] ?? head.match(
+    /^(\d{3})\s+(?:overloaded|service unavailable|internal server error|too many requests|server error)\b/i
+  )?.[1];
+  if (code) {
+    const kind = CODE_KIND[code];
+    if (kind) return { code, kind };
+  }
+  const typeToken = head.match(/^[^a-z0-9]*(overloaded_error|rate_limit_error)\b/i)?.[1];
+  if (typeToken) {
+    return typeToken.toLowerCase() === "overloaded_error" ? { code: "529", kind: "overloaded" } : { code: "429", kind: "rate_limit" };
+  }
+  return null;
+}
+function rewriteTransientApiError(text) {
+  const match = detectTransientApiError(text);
+  if (!match) return { text, rewritten: false, original: null, match: null };
+  return { text: FRIENDLY_TRANSIENT_MESSAGE, rewritten: true, original: text, match };
+}
+function emitTransientApiErrorTelemetry(channel, match, original) {
+  if (!match) return;
+  const agentCode = process.env.AGT_AGENT_CODE_NAME ?? "unknown";
+  try {
+    process.stderr.write(
+      `agt.egress.transient_api_error ${JSON.stringify({
+        channel,
+        agent_code: agentCode,
+        code: match.code,
+        kind: match.kind,
+        // Raw error kept for operators (truncated); never shown to the end user.
+        raw: (original ?? "").replace(/\s+/g, " ").trim().slice(0, 300)
+      })}
+`
+    );
+  } catch {
+  }
+}
+
 // src/direct-chat-claim-tracker.ts
 var DirectChatClaimTracker = class {
   bySession = /* @__PURE__ */ new Map();
@@ -14528,7 +14576,9 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
     const { session_id, content: rawContent } = args;
     const sanitizedReply = stripRepostPreambleWithMeta(rawContent);
     if (sanitizedReply.stripped) emitPreambleStripTelemetry("direct_chat", sanitizedReply.shape);
-    const content = sanitizedReply.text;
+    const apiErr = rewriteTransientApiError(sanitizedReply.text);
+    if (apiErr.rewritten) emitTransientApiErrorTelemetry("direct_chat", apiErr.match, apiErr.original);
+    const content = apiErr.text;
     const message_ids = claimTracker.peek(session_id);
     const streamEnabled = resolveHostBooleanFlag({
       key: "direct-chat-stream-reply",

package/dist/mcp/slack-channel.js

@@ -15325,6 +15325,54 @@ function emitPreambleStripTelemetry(channel, shape) {
   }
 }
 
+// src/transient-api-error.ts
+var CODE_KIND = {
+  "429": "rate_limit",
+  "500": "server_error",
+  "503": "unavailable",
+  "529": "overloaded"
+};
+var FRIENDLY_TRANSIENT_MESSAGE = "Sorry, I hit a brief technical hiccup just now and couldn't finish that. Please give me a moment and try again shortly.";
+function detectTransientApiError(text) {
+  if (!text) return null;
+  const head = text.replace(/^\s+/, "").slice(0, 200);
+  const code = head.match(/^api error:\s*(\d{3})\b/i)?.[1] ?? head.match(
+    /^(\d{3})\s+(?:overloaded|service unavailable|internal server error|too many requests|server error)\b/i
+  )?.[1];
+  if (code) {
+    const kind = CODE_KIND[code];
+    if (kind) return { code, kind };
+  }
+  const typeToken = head.match(/^[^a-z0-9]*(overloaded_error|rate_limit_error)\b/i)?.[1];
+  if (typeToken) {
+    return typeToken.toLowerCase() === "overloaded_error" ? { code: "529", kind: "overloaded" } : { code: "429", kind: "rate_limit" };
+  }
+  return null;
+}
+function rewriteTransientApiError(text) {
+  const match = detectTransientApiError(text);
+  if (!match) return { text, rewritten: false, original: null, match: null };
+  return { text: FRIENDLY_TRANSIENT_MESSAGE, rewritten: true, original: text, match };
+}
+function emitTransientApiErrorTelemetry(channel, match, original) {
+  if (!match) return;
+  const agentCode = process.env.AGT_AGENT_CODE_NAME ?? "unknown";
+  try {
+    process.stderr.write(
+      `agt.egress.transient_api_error ${JSON.stringify({
+        channel,
+        agent_code: agentCode,
+        code: match.code,
+        kind: match.kind,
+        // Raw error kept for operators (truncated); never shown to the end user.
+        raw: (original ?? "").replace(/\s+/g, " ").trim().slice(0, 300)
+      })}
+`
+    );
+  } catch {
+  }
+}
+
 // src/slack-pending-inbound-cleanup.ts
 import { existsSync as existsSync3, readdirSync as readdirSync2, statSync, unlinkSync } from "fs";
 import { join as join5 } from "path";
@@ -17534,7 +17582,9 @@ async function processSlackRecoveryOutboxFile(filename) {
   }
   const recovered = stripRepostPreambleWithMeta(payload.text);
   if (recovered.stripped) emitPreambleStripTelemetry("slack", recovered.shape);
-  const text = recovered.text;
+  const apiErr = rewriteTransientApiError(recovered.text);
+  if (apiErr.rewritten) emitTransientApiErrorTelemetry("slack", apiErr.match, apiErr.original);
+  const text = apiErr.text;
   let sendSucceeded = false;
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), 15e3);
@@ -19358,6 +19408,8 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
     };
     const sanitized = stripRepostPreambleWithMeta(text);
     if (sanitized.stripped) emitPreambleStripTelemetry("slack", sanitized.shape);
+    const apiErr = rewriteTransientApiError(sanitized.text);
+    if (apiErr.rewritten) emitTransientApiErrorTelemetry("slack", apiErr.match, apiErr.original);
     try {
       const res = await fetch("https://slack.com/api/chat.postMessage", {
         method: "POST",
@@ -19367,7 +19419,7 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
         },
         body: JSON.stringify({
           channel,
-          text: sanitized.text,
+          text: apiErr.text,
           ...effectiveThreadTs ? { thread_ts: effectiveThreadTs } : {},
           ...buildAugmentedSlackMetadata() ? { metadata: buildAugmentedSlackMetadata() } : {}
           // ↑ Labels this message as Augmented-agent-originated so peer agents

package/dist/mcp/teams-channel.js

@@ -14094,6 +14094,54 @@ function emitPreambleStripTelemetry(channel, shape) {
   }
 }
 
+// src/transient-api-error.ts
+var CODE_KIND = {
+  "429": "rate_limit",
+  "500": "server_error",
+  "503": "unavailable",
+  "529": "overloaded"
+};
+var FRIENDLY_TRANSIENT_MESSAGE = "Sorry, I hit a brief technical hiccup just now and couldn't finish that. Please give me a moment and try again shortly.";
+function detectTransientApiError(text) {
+  if (!text) return null;
+  const head = text.replace(/^\s+/, "").slice(0, 200);
+  const code = head.match(/^api error:\s*(\d{3})\b/i)?.[1] ?? head.match(
+    /^(\d{3})\s+(?:overloaded|service unavailable|internal server error|too many requests|server error)\b/i
+  )?.[1];
+  if (code) {
+    const kind = CODE_KIND[code];
+    if (kind) return { code, kind };
+  }
+  const typeToken = head.match(/^[^a-z0-9]*(overloaded_error|rate_limit_error)\b/i)?.[1];
+  if (typeToken) {
+    return typeToken.toLowerCase() === "overloaded_error" ? { code: "529", kind: "overloaded" } : { code: "429", kind: "rate_limit" };
+  }
+  return null;
+}
+function rewriteTransientApiError(text) {
+  const match = detectTransientApiError(text);
+  if (!match) return { text, rewritten: false, original: null, match: null };
+  return { text: FRIENDLY_TRANSIENT_MESSAGE, rewritten: true, original: text, match };
+}
+function emitTransientApiErrorTelemetry(channel, match, original) {
+  if (!match) return;
+  const agentCode = process.env.AGT_AGENT_CODE_NAME ?? "unknown";
+  try {
+    process.stderr.write(
+      `agt.egress.transient_api_error ${JSON.stringify({
+        channel,
+        agent_code: agentCode,
+        code: match.code,
+        kind: match.kind,
+        // Raw error kept for operators (truncated); never shown to the end user.
+        raw: (original ?? "").replace(/\s+/g, " ").trim().slice(0, 300)
+      })}
+`
+    );
+  } catch {
+  }
+}
+
 // src/msteams-inbound-puller.ts
 import { existsSync, mkdirSync, readdirSync, utimesSync, writeFileSync } from "fs";
 import { join } from "path";
@@ -15465,10 +15513,12 @@ async function handleReply(args) {
   }
   const sanitized = stripRepostPreambleWithMeta(text);
   if (sanitized.stripped) emitPreambleStripTelemetry("teams", sanitized.shape);
+  const apiErr = rewriteTransientApiError(sanitized.text);
+  if (apiErr.rewritten) emitTransientApiErrorTelemetry("teams", apiErr.match, apiErr.original);
   try {
     const result = await sendActivity(serviceUrl, conversationId, {
       type: "message",
-      text: sanitized.text,
+      text: apiErr.text,
       textFormat: "markdown",
       ...replyToId ? { replyToId } : {}
     });
@@ -16026,10 +16076,12 @@ async function processRecoveryFile(filename) {
   }
   const recovered = stripRepostPreambleWithMeta(payload.text);
   if (recovered.stripped) emitPreambleStripTelemetry("teams", recovered.shape);
+  const apiErr = rewriteTransientApiError(recovered.text);
+  if (apiErr.rewritten) emitTransientApiErrorTelemetry("teams", apiErr.match, apiErr.original);
   try {
     await sendActivity(payload.service_url, payload.conversation_id, {
       type: "message",
-      text: recovered.text,
+      text: apiErr.text,
       ...payload.reply_to_id ? { replyToId: payload.reply_to_id } : {}
     });
     try {

package/dist/mcp/telegram-channel.js

@@ -16395,6 +16395,54 @@ function emitPreambleStripTelemetry(channel, shape) {
   }
 }
 
+// src/transient-api-error.ts
+var CODE_KIND = {
+  "429": "rate_limit",
+  "500": "server_error",
+  "503": "unavailable",
+  "529": "overloaded"
+};
+var FRIENDLY_TRANSIENT_MESSAGE = "Sorry, I hit a brief technical hiccup just now and couldn't finish that. Please give me a moment and try again shortly.";
+function detectTransientApiError(text) {
+  if (!text) return null;
+  const head = text.replace(/^\s+/, "").slice(0, 200);
+  const code = head.match(/^api error:\s*(\d{3})\b/i)?.[1] ?? head.match(
+    /^(\d{3})\s+(?:overloaded|service unavailable|internal server error|too many requests|server error)\b/i
+  )?.[1];
+  if (code) {
+    const kind = CODE_KIND[code];
+    if (kind) return { code, kind };
+  }
+  const typeToken = head.match(/^[^a-z0-9]*(overloaded_error|rate_limit_error)\b/i)?.[1];
+  if (typeToken) {
+    return typeToken.toLowerCase() === "overloaded_error" ? { code: "529", kind: "overloaded" } : { code: "429", kind: "rate_limit" };
+  }
+  return null;
+}
+function rewriteTransientApiError(text) {
+  const match = detectTransientApiError(text);
+  if (!match) return { text, rewritten: false, original: null, match: null };
+  return { text: FRIENDLY_TRANSIENT_MESSAGE, rewritten: true, original: text, match };
+}
+function emitTransientApiErrorTelemetry(channel, match, original) {
+  if (!match) return;
+  const agentCode = process.env.AGT_AGENT_CODE_NAME ?? "unknown";
+  try {
+    process.stderr.write(
+      `agt.egress.transient_api_error ${JSON.stringify({
+        channel,
+        agent_code: agentCode,
+        code: match.code,
+        kind: match.kind,
+        // Raw error kept for operators (truncated); never shown to the end user.
+        raw: (original ?? "").replace(/\s+/g, " ").trim().slice(0, 300)
+      })}
+`
+    );
+  } catch {
+  }
+}
+
 // src/telegram-pending-inbound-cleanup.ts
 import { readdirSync, readFileSync as readFileSync7, statSync } from "fs";
 import { join as join5 } from "path";
@@ -18093,7 +18141,9 @@ async function processRecoveryOutboxFile(filename) {
   }
   const recovered = stripRepostPreambleWithMeta(payload.text);
   if (recovered.stripped) emitPreambleStripTelemetry("telegram", recovered.shape);
-  const text = recovered.text;
+  const apiErr = rewriteTransientApiError(recovered.text);
+  if (apiErr.rewritten) emitTransientApiErrorTelemetry("telegram", apiErr.match, apiErr.original);
+  const text = apiErr.text;
   const body = {
     chat_id: payload.chat_id,
     text,
@@ -18791,6 +18841,8 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
     }
     const tgSanitized = stripRepostPreambleWithMeta(text);
     if (tgSanitized.stripped) emitPreambleStripTelemetry("telegram", tgSanitized.shape);
+    const tgApiErr = rewriteTransientApiError(tgSanitized.text);
+    if (tgApiErr.rewritten) emitTransientApiErrorTelemetry("telegram", tgApiErr.match, tgApiErr.original);
     const isPrivateChat = !chat_id.startsWith("-");
     const tgThrottleCfg = isPrivateChat ? relaxedThrottleConfig(configFromEnv()) : configFromEnv();
     const tgThrottleNow = Date.now();
@@ -18826,8 +18878,9 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
         void deliverQueuedReply({
           chatId: chat_id,
           // ENG-6794: deliver the pre-sanitized text (preamble already stripped
-          // and counted above, before the throttle decision).
-          text: tgSanitized.text,
+          // and counted above, before the throttle decision). ENG-6861: and with
+          // any raw transient API error already softened to a friendly line.
+          text: tgApiErr.text,
           replyToMessageId: reply_to_message_id,
           isReplyTool: name === "telegram.reply",
           throttleCfg: tgThrottleCfg
@@ -18844,7 +18897,7 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
       };
     }
     try {
-      const body = { chat_id, text: tgSanitized.text };
+      const body = { chat_id, text: tgApiErr.text };
       if (reply_to_message_id) body.reply_to_message_id = Number(reply_to_message_id);
       const drainCutoffMs = Date.now();
       const data = await telegramApiCall("sendMessage", body, 15e3);

package/package.json

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