@easyoref/gramjs 1.21.1

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * GramJS MTProto channel monitor.
+ *
+ * Connects to Telegram as a user account (burner), joins/monitors
+ * the configured public channels, and stores new messages in Redis
+ * when there's an active alert window.
+ *
+ * Rate-limited: 1-2s/channel with ±500ms jitter to avoid bans.
+ * Uses exponential backoff on flood errors.
+ */
+export declare function startMonitor(): Promise<void>;
+export declare function stopMonitor(): Promise<void>;
+/**
+ * Fetch recent messages from a public Telegram channel via MTProto.
+ * Used by the telegram_mtproto_mcp_read_sources MCP tool.
+ *
+ * @param channel - Channel username with @ prefix (e.g. "@idf_telegram")
+ * @param limit - Number of messages to fetch (1-20)
+ * @returns Array of ChannelPost objects (newest first)
+ */
+export declare function fetchRecentChannelPosts(channel: string, limit?: number): Promise<Array<{
+    text: string;
+    ts: number;
+    messageUrl?: string;
+}>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiFH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAgKlD;AAiGD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjD;AAID;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAAU,GAChB,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CA+BnE"}

package/dist/index.js

@@ -0,0 +1,324 @@
+/**
+ * GramJS MTProto channel monitor.
+ *
+ * Connects to Telegram as a user account (burner), joins/monitors
+ * the configured public channels, and stores new messages in Redis
+ * when there's an active alert window.
+ *
+ * Rate-limited: 1-2s/channel with ±500ms jitter to avoid bans.
+ * Uses exponential backoff on flood errors.
+ */
+import * as logger from "@easyoref/monitoring";
+import { config, getActiveAlert, pushChannelPost } from "@easyoref/shared";
+import { Api, TelegramClient } from "telegram";
+import { NewMessage } from "telegram/events/index.js";
+import { StringSession } from "telegram/sessions/index.js";
+const SOCKS5_TYPE = 5;
+let _client = undefined;
+// ── Monitored channels (hardcoded) ────────────────────
+const MONITORED_CHANNELS = [
+    // Original 5 channels
+    "@newsflashhhj",
+    "@yediotnews25",
+    "@Trueisrael",
+    "@israelsecurity",
+    "@N12LIVE",
+    // New channels added 2026-03-07
+    "@moriahdoron",
+    "@divuhim1234",
+    "@GLOBAL_Telegram_MOKED",
+    "@pkpoi",
+    "@lieldaphna",
+    "@News_cabinet_news",
+    "@yaronyanir1299",
+    "@ynetalerts",
+    "@idf_telegram",
+    "@israel_9", // 9tv — Israeli news channel
+];
+const PRIVATE_CHANNELS = [
+    {
+        inviteHash: "AmLhsj0A5YJbpv0XtJQENg",
+        channelId: "1023468930",
+        title: "Private Intel Group",
+    },
+];
+// ── Helpers ────────────────────────────────────────────
+function sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+}
+function jitter(baseMs) {
+    return baseMs + Math.random() * 500 - 250;
+}
+// ── Client ─────────────────────────────────────────────
+export async function startMonitor() {
+    if (!config.agent.enabled)
+        return;
+    const { apiId, apiHash, sessionString } = config.agent.mtproto;
+    if (!apiId || !apiHash) {
+        logger.warn("GramJS: api_id or api_hash not set — MTProto monitor disabled");
+        return;
+    }
+    const session = new StringSession(sessionString || "");
+    const clientOpts = {
+        connectionRetries: 5,
+        retryDelay: 2000,
+        autoReconnect: true,
+        deviceModel: "Desktop",
+        appVersion: "1.0.0",
+        systemVersion: "macOS 14",
+        langCode: "en",
+        proxy: undefined,
+    };
+    // SOCKS5 proxy support
+    if (config.agent.socks5Proxy) {
+        try {
+            const proxyUrl = new URL(config.agent.socks5Proxy);
+            clientOpts.proxy = {
+                socksType: SOCKS5_TYPE,
+                ip: proxyUrl.hostname,
+                port: Number(proxyUrl.port),
+                username: proxyUrl.username || undefined,
+                password: proxyUrl.password || undefined,
+            };
+            logger.info("GramJS: SOCKS5 proxy configured", {
+                host: proxyUrl.hostname,
+            });
+        }
+        catch {
+            logger.warn("GramJS: invalid socks5_proxy URL, ignoring");
+        }
+    }
+    _client = new TelegramClient(session, apiId, apiHash, clientOpts);
+    if (!sessionString) {
+        logger.warn("GramJS: no session_string configured. Run `npx tsx src/agent/auth.ts` first.");
+        return;
+    }
+    try {
+        await _client.connect();
+        logger.info("GramJS: connected to Telegram MTProto");
+    }
+    catch (err) {
+        logger.error("GramJS: connection failed", { error: String(err) });
+        return;
+    }
+    // Get all dialogs to check existing memberships
+    let existingChannels = new Set();
+    let existingPrivateIds = new Set();
+    try {
+        const dialogs = await _client.getDialogs({ limit: 200 });
+        for (const dialog of dialogs) {
+            const entity = dialog.entity;
+            // Public channel username
+            if (entity && "username" in entity && entity.username) {
+                existingChannels.add(String(entity.username).toLowerCase());
+            }
+            // Private channel ID
+            if (entity && "id" in entity) {
+                existingPrivateIds.add(String(entity.id));
+            }
+        }
+        logger.info("GramJS: fetched existing dialogs", {
+            total: dialogs.length,
+        });
+    }
+    catch (err) {
+        logger.warn("GramJS: failed to fetch dialogs, will try joining anyway", {
+            error: String(err),
+        });
+    }
+    // Auto-join all monitored public channels (required for NewMessage events)
+    for (const ch of MONITORED_CHANNELS) {
+        const username = ch.replace("@", "");
+        const normalizedUsername = username.toLowerCase();
+        // Check if already a member
+        if (existingChannels.has(normalizedUsername)) {
+            logger.debug("GramJS: already in channel", { channel: ch });
+            continue;
+        }
+        try {
+            await _client.invoke(new Api.channels.JoinChannel({ channel: username }));
+            logger.info("GramJS: joined channel", { channel: ch });
+        }
+        catch (err) {
+            const errStr = String(err);
+            if (errStr.includes("USER_ALREADY_PARTICIPANT")) {
+                logger.debug("GramJS: already in channel (via API)", { channel: ch });
+            }
+            else {
+                logger.warn("GramJS: failed to join channel", {
+                    channel: ch,
+                    error: errStr,
+                });
+            }
+        }
+        // Rate limit: 1-2s between joins
+        await sleep(jitter(1500));
+    }
+    // Auto-join private channels via invite hash
+    for (const priv of PRIVATE_CHANNELS) {
+        // Check if already a member by channel ID
+        if (existingPrivateIds.has(priv.channelId)) {
+            logger.debug("GramJS: already in private channel", { title: priv.title });
+            continue;
+        }
+        try {
+            await _client.invoke(new Api.messages.ImportChatInvite({ hash: priv.inviteHash }));
+            logger.info("GramJS: joined private channel", { title: priv.title });
+        }
+        catch (err) {
+            const errStr = String(err);
+            if (errStr.includes("USER_ALREADY_PARTICIPANT") ||
+                errStr.includes("INVITE_HASH_EXPIRED")) {
+                logger.debug("GramJS: already in private channel or hash expired", {
+                    title: priv.title,
+                });
+            }
+            else {
+                logger.warn("GramJS: failed to join private channel", {
+                    title: priv.title,
+                    error: errStr,
+                });
+            }
+        }
+        // Rate limit: 1-2s between joins
+        await sleep(jitter(1500));
+    }
+    // Subscribe to new messages across all monitored channels
+    _client.addEventHandler(async (event) => {
+        await handleNewMessage(event).catch((err) => {
+            logger.warn("GramJS: handler error", { error: String(err) });
+        });
+    }, new NewMessage({}));
+    logger.info("GramJS: monitoring channels", {
+        public: MONITORED_CHANNELS.length,
+        private: PRIVATE_CHANNELS.length,
+    });
+}
+async function handleNewMessage(event) {
+    const msg = event.message;
+    if (!msg?.text || !msg.peerId) {
+        logger.debug("GramJS: skipped message (no text or peerId)");
+        return;
+    }
+    // Get channel identifier (username or title)
+    let channel = "";
+    let channelId = ""; // for private channels
+    let isPrivate = false;
+    try {
+        const chat = await event.message.getChat();
+        // Try to extract channel ID from peerId (for private channels)
+        if (msg.peerId && "channelId" in msg.peerId) {
+            // channelId is stored as bigint, convert to string
+            const rawId = String(msg.peerId.channelId);
+            channelId = rawId;
+        }
+        // Check if it's a monitored private channel
+        const privateMatch = PRIVATE_CHANNELS.find((p) => p.channelId === channelId);
+        if (privateMatch) {
+            channel = privateMatch.title;
+            isPrivate = true;
+        }
+        else if (chat && "username" in chat && chat.username) {
+            channel = `@${chat.username}`;
+        }
+        else if (chat && "title" in chat && chat.title) {
+            channel = String(chat.title);
+        }
+        else {
+            logger.debug("GramJS: skipped message (unidentifiable chat)");
+            return; // Not a channel we can identify
+        }
+    }
+    catch {
+        return;
+    }
+    // Only care about configured channels (public or private)
+    const normalizedChannel = channel.toLowerCase();
+    const isMonitored = isPrivate ||
+        MONITORED_CHANNELS.some((c) => c.toLowerCase() === normalizedChannel ||
+            c.toLowerCase().replace("@", "") === normalizedChannel.replace("@", ""));
+    if (!isMonitored) {
+        logger.debug("GramJS: skipped message (not monitored)", {
+            channel,
+            channelId,
+        });
+        return;
+    }
+    // Only store if there's an active alert window
+    const active = await getActiveAlert();
+    if (!active) {
+        logger.debug("GramJS: skipped message (no active alert)", { channel });
+        return;
+    }
+    // Anti-flood: jittered delay
+    await sleep(jitter(1000));
+    // Build direct message URL
+    let messageUrl;
+    if (isPrivate) {
+        // Private channel: https://t.me/c/1023468930/123
+        messageUrl = `https://t.me/c/${channelId}/${msg.id}`;
+    }
+    else {
+        // Public channel: https://t.me/username/123
+        const username = channel.replace("@", "");
+        messageUrl = `https://t.me/${username}/${msg.id}`;
+    }
+    await pushChannelPost(active.alertId, {
+        channel,
+        text: msg.text,
+        ts: Date.now(),
+        messageUrl,
+    });
+    logger.info("GramJS: stored channel post", {
+        channel,
+        alertId: active.alertId,
+        text_len: msg.text.length,
+        private: isPrivate,
+    });
+}
+export async function stopMonitor() {
+    if (_client) {
+        await _client.disconnect();
+        _client = undefined;
+        logger.info("GramJS: disconnected");
+    }
+}
+// ── Fetch recent posts (used by MCP tools) ─────────────
+/**
+ * Fetch recent messages from a public Telegram channel via MTProto.
+ * Used by the telegram_mtproto_mcp_read_sources MCP tool.
+ *
+ * @param channel - Channel username with @ prefix (e.g. "@idf_telegram")
+ * @param limit - Number of messages to fetch (1-20)
+ * @returns Array of ChannelPost objects (newest first)
+ */
+export async function fetchRecentChannelPosts(channel, limit = 5) {
+    if (!_client?.connected) {
+        logger.warn("GramJS: fetchRecentChannelPosts — client not connected");
+        return [];
+    }
+    const username = channel.replace("@", "");
+    const safeLimit = Math.min(Math.max(limit, 1), 20);
+    try {
+        // Rate limit: jittered delay before fetching
+        await sleep(jitter(1000));
+        const messages = await _client.getMessages(username, {
+            limit: safeLimit,
+        });
+        return messages
+            .filter((msg) => msg.text)
+            .map((msg) => ({
+            text: msg.text ?? "",
+            ts: msg.date ? msg.date * 1000 : Date.now(),
+            messageUrl: `https://t.me/${username}/${msg.id}`,
+        }));
+    }
+    catch (err) {
+        logger.warn("GramJS: fetchRecentChannelPosts failed", {
+            channel,
+            error: String(err),
+        });
+        return [];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@easyoref/gramjs",
+  "version": "1.21.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "telegram": "^2.26.0",
+    "qrcode-terminal": "^0.12.0",
+    "input": "^1.0.1",
+    "@easyoref/shared": "*",
+    "@easyoref/monitoring": "*",
+    "zod": "4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/qrcode-terminal": "^0.12.2",
+    "typescript": "^5.7.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,400 @@
+/**
+ * GramJS MTProto channel monitor.
+ *
+ * Connects to Telegram as a user account (burner), joins/monitors
+ * the configured public channels, and stores new messages in Redis
+ * when there's an active alert window.
+ *
+ * Rate-limited: 1-2s/channel with ±500ms jitter to avoid bans.
+ * Uses exponential backoff on flood errors.
+ */
+
+import * as logger from "@easyoref/monitoring";
+import { config, getActiveAlert, pushChannelPost } from "@easyoref/shared";
+import { Api, TelegramClient } from "telegram";
+import { NewMessage } from "telegram/events/index.js";
+import type { NewMessageEvent } from "telegram/events/NewMessage.js";
+import { StringSession } from "telegram/sessions/index.js";
+
+const SOCKS5_TYPE = 5 as const;
+
+type TelegramCtorOpts = ConstructorParameters<typeof TelegramClient>[3];
+
+type TelegramClientOpts = {
+  connectionRetries: number;
+  retryDelay: number;
+  autoReconnect: boolean;
+  deviceModel: string;
+  appVersion: string;
+  systemVersion: string;
+  langCode: string;
+  proxy?: {
+    socksType: typeof SOCKS5_TYPE;
+    ip: string;
+    port: number;
+    username?: string;
+    password?: string;
+  };
+};
+
+let _client: TelegramClient | undefined = undefined;
+
+// ── Monitored channels (hardcoded) ────────────────────
+
+const MONITORED_CHANNELS = [
+  // Original 5 channels
+  "@newsflashhhj",
+  "@yediotnews25",
+  "@Trueisrael",
+  "@israelsecurity",
+  "@N12LIVE",
+  // New channels added 2026-03-07
+  "@moriahdoron",
+  "@divuhim1234",
+  "@GLOBAL_Telegram_MOKED",
+  "@pkpoi",
+  "@lieldaphna",
+  "@News_cabinet_news",
+  "@yaronyanir1299",
+  "@ynetalerts",
+  "@idf_telegram",
+  "@israel_9", // 9tv — Israeli news channel
+];
+
+// Private channels (invite hash + channel ID for URL building)
+interface PrivateChannel {
+  inviteHash: string; // from t.me/joinchat/...
+  channelId: string; // from t.me/c/1023468930/... (without -100 prefix)
+  title: string; // for logs/identification
+}
+
+const PRIVATE_CHANNELS: PrivateChannel[] = [
+  {
+    inviteHash: "AmLhsj0A5YJbpv0XtJQENg",
+    channelId: "1023468930",
+    title: "Private Intel Group",
+  },
+];
+
+// ── Helpers ────────────────────────────────────────────
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+function jitter(baseMs: number): number {
+  return baseMs + Math.random() * 500 - 250;
+}
+
+// ── Client ─────────────────────────────────────────────
+
+export async function startMonitor(): Promise<void> {
+  if (!config.agent.enabled) return;
+
+  const { apiId, apiHash, sessionString } = config.agent.mtproto;
+
+  if (!apiId || !apiHash) {
+    logger.warn(
+      "GramJS: api_id or api_hash not set — MTProto monitor disabled",
+    );
+    return;
+  }
+
+  const session = new StringSession(sessionString || "");
+
+  const clientOpts = {
+    connectionRetries: 5,
+    retryDelay: 2000,
+    autoReconnect: true,
+    deviceModel: "Desktop",
+    appVersion: "1.0.0",
+    systemVersion: "macOS 14",
+    langCode: "en",
+    proxy: undefined as TelegramClientOpts["proxy"],
+  } satisfies TelegramClientOpts;
+
+  // SOCKS5 proxy support
+  if (config.agent.socks5Proxy) {
+    try {
+      const proxyUrl = new URL(config.agent.socks5Proxy);
+      clientOpts.proxy = {
+        socksType: SOCKS5_TYPE,
+        ip: proxyUrl.hostname,
+        port: Number(proxyUrl.port),
+        username: proxyUrl.username || undefined,
+        password: proxyUrl.password || undefined,
+      };
+      logger.info("GramJS: SOCKS5 proxy configured", {
+        host: proxyUrl.hostname,
+      });
+    } catch {
+      logger.warn("GramJS: invalid socks5_proxy URL, ignoring");
+    }
+  }
+
+  _client = new TelegramClient(session, apiId, apiHash, clientOpts);
+
+  if (!sessionString) {
+    logger.warn(
+      "GramJS: no session_string configured. Run `npx tsx src/agent/auth.ts` first.",
+    );
+    return;
+  }
+
+  try {
+    await _client.connect();
+    logger.info("GramJS: connected to Telegram MTProto");
+  } catch (err) {
+    logger.error("GramJS: connection failed", { error: String(err) });
+    return;
+  }
+
+  // Get all dialogs to check existing memberships
+  let existingChannels: Set<string> = new Set();
+  let existingPrivateIds: Set<string> = new Set();
+
+  try {
+    const dialogs = await _client.getDialogs({ limit: 200 });
+    for (const dialog of dialogs) {
+      const entity = dialog.entity;
+      // Public channel username
+      if (entity && "username" in entity && entity.username) {
+        existingChannels.add(String(entity.username).toLowerCase());
+      }
+      // Private channel ID
+      if (entity && "id" in entity) {
+        existingPrivateIds.add(String(entity.id));
+      }
+    }
+    logger.info("GramJS: fetched existing dialogs", {
+      total: dialogs.length,
+    });
+  } catch (err) {
+    logger.warn("GramJS: failed to fetch dialogs, will try joining anyway", {
+      error: String(err),
+    });
+  }
+
+  // Auto-join all monitored public channels (required for NewMessage events)
+  for (const ch of MONITORED_CHANNELS) {
+    const username = ch.replace("@", "");
+    const normalizedUsername = username.toLowerCase();
+
+    // Check if already a member
+    if (existingChannels.has(normalizedUsername)) {
+      logger.debug("GramJS: already in channel", { channel: ch });
+      continue;
+    }
+
+    try {
+      await _client.invoke(new Api.channels.JoinChannel({ channel: username }));
+      logger.info("GramJS: joined channel", { channel: ch });
+    } catch (err: unknown) {
+      const errStr = String(err);
+      if (errStr.includes("USER_ALREADY_PARTICIPANT")) {
+        logger.debug("GramJS: already in channel (via API)", { channel: ch });
+      } else {
+        logger.warn("GramJS: failed to join channel", {
+          channel: ch,
+          error: errStr,
+        });
+      }
+    }
+    // Rate limit: 1-2s between joins
+    await sleep(jitter(1500));
+  }
+
+  // Auto-join private channels via invite hash
+  for (const priv of PRIVATE_CHANNELS) {
+    // Check if already a member by channel ID
+    if (existingPrivateIds.has(priv.channelId)) {
+      logger.debug("GramJS: already in private channel", { title: priv.title });
+      continue;
+    }
+
+    try {
+      await _client.invoke(
+        new Api.messages.ImportChatInvite({ hash: priv.inviteHash }),
+      );
+      logger.info("GramJS: joined private channel", { title: priv.title });
+    } catch (err: unknown) {
+      const errStr = String(err);
+      if (
+        errStr.includes("USER_ALREADY_PARTICIPANT") ||
+        errStr.includes("INVITE_HASH_EXPIRED")
+      ) {
+        logger.debug("GramJS: already in private channel or hash expired", {
+          title: priv.title,
+        });
+      } else {
+        logger.warn("GramJS: failed to join private channel", {
+          title: priv.title,
+          error: errStr,
+        });
+      }
+    }
+    // Rate limit: 1-2s between joins
+    await sleep(jitter(1500));
+  }
+
+  // Subscribe to new messages across all monitored channels
+  _client.addEventHandler(async (event: NewMessageEvent) => {
+    await handleNewMessage(event).catch((err) => {
+      logger.warn("GramJS: handler error", { error: String(err) });
+    });
+  }, new NewMessage({}));
+
+  logger.info("GramJS: monitoring channels", {
+    public: MONITORED_CHANNELS.length,
+    private: PRIVATE_CHANNELS.length,
+  });
+}
+
+async function handleNewMessage(event: NewMessageEvent): Promise<void> {
+  const msg = event.message;
+  if (!msg?.text || !msg.peerId) {
+    logger.debug("GramJS: skipped message (no text or peerId)");
+    return;
+  }
+
+  // Get channel identifier (username or title)
+  let channel = "";
+  let channelId = ""; // for private channels
+  let isPrivate = false;
+
+  try {
+    const chat = await event.message.getChat();
+
+    // Try to extract channel ID from peerId (for private channels)
+    if (msg.peerId && "channelId" in msg.peerId) {
+      // channelId is stored as bigint, convert to string
+      const rawId = String(msg.peerId.channelId);
+      channelId = rawId;
+    }
+
+    // Check if it's a monitored private channel
+    const privateMatch = PRIVATE_CHANNELS.find(
+      (p) => p.channelId === channelId,
+    );
+    if (privateMatch) {
+      channel = privateMatch.title;
+      isPrivate = true;
+    } else if (chat && "username" in chat && chat.username) {
+      channel = `@${chat.username}`;
+    } else if (chat && "title" in chat && chat.title) {
+      channel = String(chat.title);
+    } else {
+      logger.debug("GramJS: skipped message (unidentifiable chat)");
+      return; // Not a channel we can identify
+    }
+  } catch {
+    return;
+  }
+
+  // Only care about configured channels (public or private)
+  const normalizedChannel = channel.toLowerCase();
+  const isMonitored =
+    isPrivate ||
+    MONITORED_CHANNELS.some(
+      (c) =>
+        c.toLowerCase() === normalizedChannel ||
+        c.toLowerCase().replace("@", "") === normalizedChannel.replace("@", ""),
+    );
+
+  if (!isMonitored) {
+    logger.debug("GramJS: skipped message (not monitored)", {
+      channel,
+      channelId,
+    });
+    return;
+  }
+
+  // Only store if there's an active alert window
+  const active = await getActiveAlert();
+  if (!active) {
+    logger.debug("GramJS: skipped message (no active alert)", { channel });
+    return;
+  }
+
+  // Anti-flood: jittered delay
+  await sleep(jitter(1000));
+
+  // Build direct message URL
+  let messageUrl: string;
+  if (isPrivate) {
+    // Private channel: https://t.me/c/1023468930/123
+    messageUrl = `https://t.me/c/${channelId}/${msg.id}`;
+  } else {
+    // Public channel: https://t.me/username/123
+    const username = channel.replace("@", "");
+    messageUrl = `https://t.me/${username}/${msg.id}`;
+  }
+
+  await pushChannelPost(active.alertId, {
+    channel,
+    text: msg.text,
+    ts: Date.now(),
+    messageUrl,
+  });
+
+  logger.info("GramJS: stored channel post", {
+    channel,
+    alertId: active.alertId,
+    text_len: msg.text.length,
+    private: isPrivate,
+  });
+}
+
+export async function stopMonitor(): Promise<void> {
+  if (_client) {
+    await _client.disconnect();
+    _client = undefined;
+    logger.info("GramJS: disconnected");
+  }
+}
+
+// ── Fetch recent posts (used by MCP tools) ─────────────
+
+/**
+ * Fetch recent messages from a public Telegram channel via MTProto.
+ * Used by the telegram_mtproto_mcp_read_sources MCP tool.
+ *
+ * @param channel - Channel username with @ prefix (e.g. "@idf_telegram")
+ * @param limit - Number of messages to fetch (1-20)
+ * @returns Array of ChannelPost objects (newest first)
+ */
+export async function fetchRecentChannelPosts(
+  channel: string,
+  limit: number = 5,
+): Promise<Array<{ text: string; ts: number; messageUrl?: string }>> {
+  if (!_client?.connected) {
+    logger.warn("GramJS: fetchRecentChannelPosts — client not connected");
+    return [];
+  }
+
+  const username = channel.replace("@", "");
+  const safeLimit = Math.min(Math.max(limit, 1), 20);
+
+  try {
+    // Rate limit: jittered delay before fetching
+    await sleep(jitter(1000));
+
+    const messages = await _client.getMessages(username, {
+      limit: safeLimit,
+    });
+
+    return messages
+      .filter((msg) => msg.text)
+      .map((msg) => ({
+        text: msg.text ?? "",
+        ts: msg.date ? msg.date * 1000 : Date.now(),
+        messageUrl: `https://t.me/${username}/${msg.id}`,
+      }));
+  } catch (err) {
+    logger.warn("GramJS: fetchRecentChannelPosts failed", {
+      channel,
+      error: String(err),
+    });
+    return [];
+  }
+}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "references": [{ "path": "../shared" }, { "path": "../monitoring" }],
+  "include": ["src/**/*"]
+}