@integrity-labs/agt-cli 0.19.16 → 0.19.18

package/mcp/telegram-channel.js

@@ -14211,6 +14211,82 @@ async function isThreadKilled(opts) {
   }
 }
 
+// src/telegram-peer-classifier.ts
+function classifyPeerMessage(msg, cfg, self) {
+  if (!msg.from?.is_bot) return { kind: "human" };
+  if (self.bot_id !== null && msg.from.id === self.bot_id) {
+    return { kind: "self" };
+  }
+  if (cfg.peer_agent_mode === "off") {
+    return { kind: "drop", reason: "mode_off" };
+  }
+  const chatId = String(msg.chat.id);
+  if (cfg.peer_group_ids.length === 0) {
+    if (msg.chat.type !== "private") {
+      return { kind: "drop", reason: "chat_not_allowed" };
+    }
+  } else if (!cfg.peer_group_ids.includes(chatId)) {
+    return { kind: "drop", reason: "chat_not_allowed" };
+  }
+  const peer = cfg.peers.find((p) => p.bot_id === msg.from.id);
+  if (!peer) {
+    return { kind: "drop", reason: "unknown_peer" };
+  }
+  if (self.bot_id === null || self.bot_username === null) {
+    return { kind: "drop", reason: "self_resolution_pending" };
+  }
+  if (isAddressedToUs(msg, self.bot_id, self.bot_username)) {
+    return { kind: "peer-ingress", peer };
+  }
+  return { kind: "drop", reason: "not_addressed" };
+}
+function isAddressedToUs(msg, ourBotId, ourBotUsername) {
+  if (msg.reply_to_message?.from?.id === ourBotId) return true;
+  const text = msg.text ?? msg.caption ?? "";
+  const entities = msg.entities ?? msg.caption_entities ?? [];
+  const usAt = "@" + ourBotUsername;
+  for (const entity of entities) {
+    const slice = text.slice(entity.offset, entity.offset + entity.length).toLowerCase();
+    if (entity.type === "bot_command") {
+      const at = slice.indexOf("@");
+      if (at < 0) {
+        return true;
+      }
+      if (slice.slice(at + 1) === ourBotUsername) return true;
+    } else if (entity.type === "mention" && slice === usAt) {
+      return true;
+    }
+  }
+  return false;
+}
+var CODE_NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function parsePeersEnv(raw) {
+  if (!raw || raw.trim().length === 0) return [];
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return [];
+  }
+  if (!Array.isArray(parsed)) return [];
+  const out = [];
+  for (const entry of parsed) {
+    if (entry && typeof entry === "object" && typeof entry.code_name === "string" && CODE_NAME_RE.test(entry.code_name) && typeof entry.agent_id === "string" && typeof entry.bot_id === "number" && Number.isInteger(entry.bot_id) && entry.bot_id > 0) {
+      const e = entry;
+      out.push({ code_name: e.code_name, bot_id: e.bot_id, agent_id: e.agent_id });
+    }
+  }
+  return out;
+}
+function parsePeerGroupIdsEnv(raw) {
+  if (!raw) return [];
+  return raw.split(",").map((s) => s.trim()).filter(Boolean);
+}
+function parsePeerAgentModeEnv(raw) {
+  if (raw === "listen" || raw === "respond") return raw;
+  return "off";
+}
+
 // src/telegram-channel.ts
 function redactId(id) {
   return createHash("sha256").update(String(id)).digest("hex").slice(0, 8);
@@ -14222,6 +14298,11 @@ var AGT_API_KEY = process.env.AGT_API_KEY ?? null;
 var ALLOWED_CHATS = new Set(
   (process.env.TELEGRAM_ALLOWED_CHATS ?? "").split(",").map((s) => s.trim()).filter(Boolean)
 );
+var PEER_CLASSIFIER_CONFIG = {
+  peer_agent_mode: parsePeerAgentModeEnv(process.env.TELEGRAM_PEER_AGENT_MODE),
+  peer_group_ids: parsePeerGroupIdsEnv(process.env.TELEGRAM_PEER_GROUP_IDS),
+  peers: parsePeersEnv(process.env.TELEGRAM_PEERS)
+};
 if (!BOT_TOKEN) {
   process.stderr.write(
     "telegram-channel: Missing TELEGRAM_BOT_TOKEN. Cannot start.\n"
@@ -14418,25 +14499,41 @@ async function handleRestartCommand(opts) {
   }
 }
 var cachedBotUsername = null;
-async function resolveBotUsername() {
-  if (cachedBotUsername !== null) return cachedBotUsername;
+var cachedBotId = null;
+async function refreshBotIdentity() {
   try {
     const resp = await telegramApiCall("getMe", {}, 5e3);
-    if (resp.ok && resp.result && typeof resp.result.username === "string") {
-      cachedBotUsername = resp.result.username.toLowerCase();
-      return cachedBotUsername;
+    if (resp.ok && resp.result) {
+      const result = resp.result;
+      if (typeof result.username === "string") {
+        cachedBotUsername = result.username.toLowerCase();
+      }
+      if (typeof result.id === "number") {
+        cachedBotId = result.id;
+      }
+      if (cachedBotUsername !== null && cachedBotId !== null) return;
     }
     process.stderr.write(
-      `telegram-channel(${AGENT_CODE_NAME}): getMe rejected: ${resp.description ?? "unknown"} \u2014 will retry on next /restart@<bot>
+      `telegram-channel(${AGENT_CODE_NAME}): getMe rejected: ${resp.description ?? "unknown"} \u2014 will retry on next lookup
 `
     );
   } catch (err) {
     process.stderr.write(
-      `telegram-channel(${AGENT_CODE_NAME}): getMe failed: ${redactAugmentedPaths(err.message)} \u2014 will retry on next /restart@<bot>
+      `telegram-channel(${AGENT_CODE_NAME}): getMe failed: ${redactAugmentedPaths(err.message)} \u2014 will retry on next lookup
 `
     );
   }
-  return null;
+}
+async function resolveBotUsername() {
+  if (cachedBotUsername !== null) return cachedBotUsername;
+  await refreshBotIdentity();
+  return cachedBotUsername;
+}
+async function resolveBotIdentity() {
+  if (cachedBotId === null || cachedBotUsername === null) {
+    await refreshBotIdentity();
+  }
+  return { bot_id: cachedBotId, bot_username: cachedBotUsername };
 }
 var RESTART_SYNTAX_RE = /^\/restart(?:@([A-Za-z0-9_]{1,64}))?(?:\s|$)/;
 var HELP_SYNTAX_RE = /^\/help(?:@([A-Za-z0-9_]{1,64}))?(?:\s|$)/;
@@ -15151,6 +15248,37 @@ async function pollLoop() {
         if (chatId && !isFromBot) {
           resetThread(chatId, "");
         }
+        let peerAgentMeta = null;
+        if (isFromBot) {
+          const classifierMsg = {
+            message_id: msg.message_id,
+            text: msg.text,
+            caption: msg.caption,
+            from: msg.from ? { id: msg.from.id, username: msg.from.username, is_bot: msg.from.is_bot } : void 0,
+            chat: { id: msg.chat.id, type: msg.chat.type },
+            reply_to_message: msg.reply_to_message ? {
+              message_id: msg.reply_to_message.message_id,
+              from: msg.reply_to_message.from ? { id: msg.reply_to_message.from.id, is_bot: msg.reply_to_message.from.is_bot } : void 0
+            } : void 0,
+            entities: msg.entities,
+            caption_entities: msg.caption_entities
+          };
+          const self = await resolveBotIdentity();
+          const classification = classifyPeerMessage(classifierMsg, PEER_CLASSIFIER_CONFIG, self);
+          if (classification.kind === "self") {
+            continue;
+          }
+          if (classification.kind === "drop") {
+            process.stderr.write(
+              `telegram-channel(${AGENT_CODE_NAME}): peer_drop reason=${classification.reason} chat=${redactId(chatId)} from=${redactId(String(msg.from?.id ?? "unknown"))}
+`
+            );
+            continue;
+          }
+          if (classification.kind === "peer-ingress") {
+            peerAgentMeta = { code_name: classification.peer.code_name, agent_id: classification.peer.agent_id };
+          }
+        }
         const messageId = String(msg.message_id);
         void setMessageReaction(chatId, messageId, ACK_EMOJI);
         trackPendingMessage(chatId, messageId, msg.chat.type);
@@ -15194,7 +15322,15 @@ async function pollLoop() {
               user_name: userName,
               ts: String(msg.date),
               ...fileMeta.length > 0 ? { files: JSON.stringify(fileMeta) } : {},
-              ...imagePath ? { image_path: imagePath } : {}
+              ...imagePath ? { image_path: imagePath } : {},
+              // ENG-4902: peer-agent ingress carries distinct framing so the
+              // runtime (MVP #5) can apply the peer-agent system preamble
+              // and store the turn under a peer_agent memory role.
+              ...peerAgentMeta ? {
+                source_role: "agent",
+                peer_code_name: peerAgentMeta.code_name,
+                peer_agent_id: peerAgentMeta.agent_id
+              } : {}
             }
           }
         });

package/package.json

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