@integrity-labs/agt-cli 0.12.8 → 0.12.9

package/dist/bin/agt.js

@@ -3717,7 +3717,7 @@ import { execFileSync, execSync } from "child_process";
 import { existsSync as existsSync5, realpathSync } from "fs";
 import chalk20 from "chalk";
 import ora15 from "ora";
-var cliVersion = true ? "0.12.8" : "dev";
+var cliVersion = true ? "0.12.9" : "dev";
 async function fetchLatestVersion() {
   const host2 = getHost();
   if (!host2) return null;
@@ -4166,7 +4166,7 @@ function handleError(err) {
 }
 
 // src/bin/agt.ts
-var cliVersion2 = true ? "0.12.8" : "dev";
+var cliVersion2 = true ? "0.12.9" : "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", (thisCommand) => {

package/mcp/index.js

@@ -21150,13 +21150,10 @@ server.tool(
         }
       ]
     });
+    const first = data.added_items?.[0];
+    const text = !data.ok ? "Failed to add item." : first ? `Added "${first.title}" to board (status: ${params.status ?? "today"}, id: ${first.id}). Board: ${first.url}` : `Added "${params.title}" to board (status: ${params.status ?? "today"}).`;
     return {
-      content: [
-        {
-          type: "text",
-          text: data.ok ? `Added "${params.title}" to board (status: ${params.status ?? "today"}).` : "Failed to add item."
-        }
-      ]
+      content: [{ type: "text", text }]
     };
   }
 );

package/mcp/telegram-channel.js

@@ -13863,6 +13863,10 @@ var StdioServerTransport = class {
 
 // src/telegram-channel.ts
 import https from "https";
+import { createHash } from "crypto";
+function redactId(id) {
+  return createHash("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 ALLOWED_CHATS = new Set(
@@ -13913,6 +13917,67 @@ function telegramApiCall(method, body, timeoutMs) {
     req.end();
   });
 }
+var ACK_EMOJI = "\u{1F440}";
+var TIMEOUT_EMOJI = "\u{1F494}";
+var RESPONSE_TIMEOUT_MS = 12e4;
+async function setMessageReaction(chatId, messageId, emoji2) {
+  try {
+    const resp = await telegramApiCall(
+      "setMessageReaction",
+      {
+        chat_id: chatId,
+        message_id: Number(messageId),
+        reaction: emoji2 ? [{ type: "emoji", emoji: emoji2 }] : []
+      },
+      1e4
+    );
+    if (!resp.ok) {
+      process.stderr.write(
+        `telegram-channel(${AGENT_CODE_NAME}): setMessageReaction failed (${emoji2 ?? "clear"}): ${resp.description ?? "unknown"}
+`
+      );
+    }
+  } catch (err) {
+    process.stderr.write(
+      `telegram-channel(${AGENT_CODE_NAME}): setMessageReaction error: ${err.message}
+`
+    );
+  }
+}
+var pendingMessages = /* @__PURE__ */ new Map();
+function trackPendingMessage(chatId, messageId, chatType) {
+  const key = `${chatId}:${messageId}`;
+  const existing = pendingMessages.get(key);
+  if (existing) clearTimeout(existing.timer);
+  const timer = setTimeout(() => {
+    pendingMessages.delete(key);
+    void setMessageReaction(chatId, messageId, TIMEOUT_EMOJI);
+    process.stderr.write(
+      `telegram-channel(${AGENT_CODE_NAME}): response timeout for message ${redactId(messageId)} in chat ${redactId(chatId)}
+`
+    );
+  }, RESPONSE_TIMEOUT_MS);
+  timer.unref?.();
+  pendingMessages.set(key, { timer, chatType });
+}
+function clearPendingMessage(chatId, messageId) {
+  if (messageId) {
+    const key = `${chatId}:${messageId}`;
+    const entry = pendingMessages.get(key);
+    if (entry) {
+      clearTimeout(entry.timer);
+      pendingMessages.delete(key);
+    }
+    return;
+  }
+  const prefix = `${chatId}:`;
+  for (const [key, entry] of pendingMessages) {
+    if (!key.startsWith(prefix)) continue;
+    if (entry.chatType !== "private") continue;
+    clearTimeout(entry.timer);
+    pendingMessages.delete(key);
+  }
+}
 var mcp = new Server(
   { name: "telegram", version: "0.1.0" },
   {
@@ -13922,10 +13987,15 @@ var mcp = new Server(
     },
     instructions: [
       'Messages from Telegram arrive as <channel source="telegram" chat_id="..." user="..." user_name="..." message_id="...">.',
-      "Reply using the telegram.reply tool, passing chat_id from the tag.",
+      "The user reads Telegram, not this session. The ONLY way to reach them is the telegram.reply tool \u2014 anything you put in session output is invisible to them.",
+      `EVERY response to a Telegram message goes through telegram.reply, passing the chat_id from the tag. This includes clarifying questions, error messages, partial answers, "I don't understand", and status updates \u2014 no exceptions.`,
+      'For work that will take more than ~30 seconds, follow the standard kanban flow from CLAUDE.md: call kanban.add to track the task, then IMMEDIATELY reply via telegram.reply with "On it \u2014 tracking here: <kanban URL>" including the created task title, move the task to in_progress, do the work, and reply via telegram.reply with the result.',
+      "Simple lookups, one-line answers, and no-action acknowledgements do NOT need a kanban task \u2014 but still reply via telegram.reply every time.",
+      "When a user mentions a time without a timezone, interpret it in your Timezone from the Identity section of CLAUDE.md. Do NOT ask the user which timezone they meant \u2014 resolve it yourself against your own identity.",
       "Address users by their user_name when possible; user is their numeric Telegram ID.",
-      "To reply as a thread quote (reference a specific earlier message), pass reply_to_message_id \u2014 otherwise omit it for a normal reply.",
-      "Telegram DMs are 1:1 \u2014 always reply unless the message is obviously not for you."
+      "To quote-reply to a specific earlier message, pass its message_id as reply_to_message_id \u2014 otherwise omit it for a normal reply.",
+      "Telegram DMs are 1:1 \u2014 always reply to every inbound message unless it is obviously not addressed to you.",
+      'Every inbound message gets an automatic \u{1F440} reaction as a "seen, working on it" ack. Use the telegram.react tool to add your own reactions (e.g. \u270D while clarifying, \u{1FAE1} on task complete). Only free-tier emoji are available to bots \u2014 stick to: \u{1F44D} \u{1F44E} \u2764 \u{1F525} \u{1F389} \u{1F914} \u{1F92F} \u{1F64F} \u{1F44C} \u{1F440} \u{1F4AF} \u270D \u{1FAE1} \u{1F192} \u{1F973} and similar common reactions. Premium-only emoji fail silently.'
     ].join(" ")
   }
 );
@@ -13964,6 +14034,28 @@ mcp.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         required: ["chat_id", "text"]
       }
+    },
+    {
+      name: "telegram.react",
+      description: "Add an emoji reaction to a Telegram message. Only free-tier emoji reactions are available to bots (Premium-only emoji fail silently). Pass an empty string or omit emoji to clear the bot's reaction on that message.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          chat_id: {
+            type: "string",
+            description: "Telegram chat ID (from the chat_id attribute in the <channel> tag)"
+          },
+          message_id: {
+            type: "string",
+            description: "Telegram message_id to react to (from the message_id attribute)"
+          },
+          emoji: {
+            type: "string",
+            description: `A single emoji from Telegram's free-tier reaction set (e.g. "\u{1F440}", "\u{1FAE1}", "\u270D", "\u{1F525}"). Pass "" to clear.`
+          }
+        },
+        required: ["chat_id", "message_id"]
+      }
     }
   ]
 }));
@@ -13987,6 +14079,9 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
           isError: true
         };
       }
+      if (name === "telegram.reply") {
+        clearPendingMessage(chat_id, reply_to_message_id);
+      }
       return { content: [{ type: "text", text: "sent" }] };
     } catch (err) {
       return {
@@ -13995,6 +14090,38 @@ mcp.setRequestHandler(CallToolRequestSchema, async (req) => {
       };
     }
   }
+  if (name === "telegram.react") {
+    const { chat_id, message_id, emoji: emoji2 } = args;
+    if (ALLOWED_CHATS.size > 0 && !ALLOWED_CHATS.has(chat_id)) {
+      return {
+        content: [{ type: "text", text: `Chat ${chat_id} is not in TELEGRAM_ALLOWED_CHATS` }],
+        isError: true
+      };
+    }
+    try {
+      const data = await telegramApiCall(
+        "setMessageReaction",
+        {
+          chat_id,
+          message_id: Number(message_id),
+          reaction: emoji2 ? [{ type: "emoji", emoji: emoji2 }] : []
+        },
+        1e4
+      );
+      if (!data.ok) {
+        return {
+          content: [{ type: "text", text: `Telegram error: ${data.description ?? "unknown"}` }],
+          isError: true
+        };
+      }
+      return { content: [{ type: "text", text: emoji2 ? "reacted" : "cleared" }] };
+    } catch (err) {
+      return {
+        content: [{ type: "text", text: `Failed: ${err.message}` }],
+        isError: true
+      };
+    }
+  }
   throw new Error(`Unknown tool: ${name}`);
 });
 await mcp.connect(new StdioServerTransport());
@@ -14031,6 +14158,9 @@ async function pollLoop() {
         if (ALLOWED_CHATS.size > 0 && !ALLOWED_CHATS.has(chatId)) continue;
         const userId = msg.from?.id != null ? String(msg.from.id) : "unknown";
         const userName = msg.from?.username || [msg.from?.first_name, msg.from?.last_name].filter(Boolean).join(" ").trim() || userId;
+        const messageId = String(msg.message_id);
+        void setMessageReaction(chatId, messageId, ACK_EMOJI);
+        trackPendingMessage(chatId, messageId, msg.chat.type);
         await mcp.notification({
           method: "notifications/claude/channel",
           params: {
@@ -14039,7 +14169,7 @@ async function pollLoop() {
               source: "telegram",
               chat_id: chatId,
               chat_type: msg.chat.type,
-              message_id: String(msg.message_id),
+              message_id: messageId,
               user: userId,
               user_name: userName,
               ts: String(msg.date)
@@ -14063,6 +14193,8 @@ function sleep(ms) {
 function shutdown(reason) {
   if (isShuttingDown) return;
   isShuttingDown = true;
+  for (const { timer } of pendingMessages.values()) clearTimeout(timer);
+  pendingMessages.clear();
   process.stderr.write(
     `telegram-channel(${AGENT_CODE_NAME}): ${reason} \u2014 exiting
 `

package/package.json

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