@sojaner/telex 0.1.15

package/dist/index.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { loadConfig, pickBot } from "./config.js";
+import { sessionFor } from "./telegram.js";
+import { ask, receipt, markExpired, refuse, heartbeat, deliver } from "./ask.js";
+import { touch, release } from "./registry.js";
+const config = loadConfig();
+const botNames = Object.keys(config.bots);
+// A project pins its bot with TELEX_BOT in the MCP registration; the agent can still override per call.
+const defaultBot = process.env.TELEX_BOT || config.defaultBot;
+/** Set once the agent has identified itself; until then telex has no interval and no owner. */
+let checkedIn = false;
+/** Listen to a bot's chat for messages nobody asked for, and acknowledge each one to the user. */
+function watch(bot) {
+    const session = sessionFor(bot.token);
+    session.watch(bot.chatId, {
+        allowFrom: bot.allowFrom,
+        accept: () => checkedIn,
+        onRefused: (message) => void refuse(session, bot.chatId, message),
+        onQueued: (message) => void receipt(session, bot.chatId, message),
+        onExpired: (messages) => markExpired(session, bot.chatId, messages),
+    });
+    return session;
+}
+const warned = new Set();
+/**
+ * Every call says who is calling. That fixes the expiry clock from the very first interaction and,
+ * through the shared registry, lets separate telex processes notice they share a bot.
+ */
+function checkIn(botName, bot, caller) {
+    const session = watch(bot);
+    session.setInboxTtl(bot.chatId, caller.interval_seconds * MISSED_BEATS * 1000);
+    checkedIn = true;
+    const others = touch({
+        bot: botName,
+        project: caller.project_path,
+        agent: caller.agent,
+        pid: process.pid,
+        interval_seconds: caller.interval_seconds,
+    });
+    for (const other of others) {
+        const key = `${other.pid}:${other.project}`;
+        if (warned.has(key))
+            continue;
+        warned.add(key);
+        void conflictWarning(session, bot, caller, other);
+    }
+    return session;
+}
+/** Telegram hands each update to one poller only, so a shared bot silently loses half the traffic. */
+function conflictWarning(session, bot, mine, other) {
+    return session.api("sendMessage", {
+        chat_id: bot.chatId,
+        parse_mode: "HTML",
+        text: [
+            "⚠️ <b>Two agents are using this bot at once</b>",
+            "",
+            `<code>${mine.agent}</code> — <code>${mine.project_path}</code>`,
+            `<code>${other.agent}</code> — <code>${other.project}</code>`,
+            "",
+            "Telegram gives each message to only one of them, so answers will go missing.",
+            "Give each project its own bot: <code>telex add &lt;name&gt;</code>.",
+        ].join("\n"),
+    }).catch(() => { });
+}
+const server = new McpServer({ name: "telex", version: "0.1.0" });
+/** Heartbeats a message may sit through before telex gives up on the agent's behalf. */
+const MISSED_BEATS = 3;
+/** Identity every call carries, so telex knows who is on the other end and how often to expect them. */
+const identity = {
+    project_path: z.string().min(1).describe("Absolute path of the project you are working in."),
+    agent: z.string().min(1).describe(`Your name, e.g. "claude-code", "codex", "gemini-cli".`),
+    interval_seconds: z.number().int().min(10).max(3600).default(60)
+        .describe(`How often you call heartbeat. Messages expire after ${3} missed intervals, so be honest.`),
+};
+const json = (value) => ({ content: [{ type: "text", text: JSON.stringify(value) }] });
+server.registerTool("send_to_user", {
+    title: "Message the user on Telegram",
+    description: [
+        "Send a message to the user via Telegram and optionally wait for their answer.",
+        "Use it to ask for a decision, get missing information, or report that long-running work finished.",
+        "",
+        `Formatting: 'message' is rendered with Telegram's HTML subset — <b>, <i>, <u>, <s>, <code>, <pre>, <a href="">, <blockquote>.`,
+        "Escape any literal &, < and > as &amp; &lt; &gt;. Markdown is NOT rendered.",
+        "",
+        "Pass 'options' for a multiple-choice question (buttons), or 'expect_text' for a free-text answer.",
+        "With neither, the message is a one-way notification and returns immediately.",
+        "",
+        `If the user does not answer within 'timeout_seconds' the result is {"status":"timeout"}, the buttons`,
+        "are removed and the message is marked stale. That means the user is unavailable — decide for yourself",
+        "whether to continue, retry or stop.",
+        "",
+        "If the user messaged the bot while you were not asking anything, the result also carries a 'pending'",
+        "array of what they said, delivered the same way a heartbeat would. Read it before you carry on.",
+        "",
+        "'project_path', 'agent' and 'interval_seconds' identify you. Until a call carries them telex has",
+        "no owner for this bot, and anything the user sends is refused rather than held.",
+        `Bots: ${botNames.join(", ")} (default for this project: ${defaultBot}).`,
+    ].join("\n"),
+    inputSchema: {
+        ...identity,
+        project: z.string().min(1).describe("Project or task name, shown as the message heading."),
+        message: z.string().min(1).describe("The copy to show the user, in Telegram HTML."),
+        options: z.array(z.string().min(1)).min(1).max(10).optional()
+            .describe("Single-choice answers, rendered as buttons. Mutually exclusive with expect_text."),
+        expect_text: z.boolean().optional()
+            .describe("Show a Reply button; the user's next message is returned as the answer."),
+        timeout_seconds: z.number().int().min(5).max(86400).default(300)
+            .describe("How long to wait for an answer before giving up."),
+        bot: z.enum(botNames).optional()
+            .describe(`Which configured bot to send through. Defaults to "${defaultBot}".`),
+    },
+}, async ({ project, message, options, expect_text, timeout_seconds, bot, ...caller }) => {
+    const { name: targetName, bot: target } = pickBot(config, bot);
+    const session = checkIn(targetName, target, caller);
+    const result = await ask(session, target.chatId, {
+        project,
+        message,
+        options,
+        expectText: expect_text,
+        timeoutSeconds: timeout_seconds,
+        allowFrom: target.allowFrom,
+    });
+    const pending = deliver(session, target.chatId);
+    return json(pending.length ? { ...result, pending } : result);
+});
+server.registerTool("heartbeat", {
+    title: "Check in and collect anything the user said",
+    description: [
+        "Call this on a fixed interval for the whole time you are working, and pass that interval as",
+        "'interval_seconds'. It returns immediately with whatever the user has messaged the bot since",
+        "your last check-in — it never blocks and never waits for them.",
+        "",
+        "Two jobs in one call. It delivers unprompted messages, and it is your liveness signal: the",
+        "user sees each of their messages marked as held, then delivered once a heartbeat collects it.",
+        `Miss ${MISSED_BEATS} intervals in a row and anything waiting is marked expired and dropped, which is how`,
+        "the user learns you were not listening rather than being ignored in silence.",
+        "",
+        `The result is {"messages":[...],"interval_seconds":n}. An empty array means nothing was said —`,
+        "that is the normal case, keep working and check in again next interval.",
+        "",
+        "'project_path' and 'agent' identify you. telex records them so it can warn the user when two",
+        "projects end up sharing one bot, which silently costs them half their messages.",
+        `Bots: ${botNames.join(", ")} (default for this project: ${defaultBot}).`,
+    ].join("\n"),
+    inputSchema: {
+        ...identity,
+        bot: z.enum(botNames).optional()
+            .describe(`Which configured bot to listen on. Defaults to "${defaultBot}".`),
+    },
+}, async ({ bot, ...caller }) => {
+    const { name: targetName, bot: target } = pickBot(config, bot);
+    const messages = heartbeat(checkIn(targetName, target, caller), target.chatId);
+    return json({ messages, interval_seconds: caller.interval_seconds });
+});
+// Start listening before any agent checks in, so early messages get refused rather than ignored.
+watch(pickBot(config).bot);
+const transport = new StdioServerTransport();
+// Polling now outlives any single request, so the process has to be told when the agent is gone.
+transport.onclose = () => {
+    release();
+    process.exit(0);
+};
+process.on("exit", () => release());
+await server.connect(transport);
+//# 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/dist/registry.js

@@ -0,0 +1,62 @@
+/**
+ * Which agents are alive, on disk, so separate telex processes can see each other.
+ * Each project's agent runs its own server; only a shared file can tell them apart.
+ */
+import { readFileSync, writeFileSync, mkdirSync, renameSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export const statePath = () => process.env.TELEX_STATE ??
+    join(process.env.XDG_STATE_HOME ?? join(homedir(), ".local", "state"), "telex", "sessions.json");
+const read = () => {
+    try {
+        const parsed = JSON.parse(readFileSync(statePath(), "utf8"));
+        return Array.isArray(parsed?.sessions) ? parsed.sessions : [];
+    }
+    catch {
+        return []; // a missing or corrupt file just means nothing is registered
+    }
+};
+const write = (sessions) => {
+    const path = statePath();
+    mkdirSync(dirname(path), { recursive: true });
+    // ponytail: write-rename, no lock. Two agents registering in the same millisecond can lose one
+    // record; it reappears on that agent's next call. Use a lockfile if that ever matters.
+    const tmp = `${path}.${process.pid}.tmp`;
+    writeFileSync(tmp, `${JSON.stringify({ sessions }, null, 2)}\n`, { mode: 0o600 });
+    renameSync(tmp, path);
+};
+const running = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/** A session counts as alive while its process exists and it has checked in within three intervals. */
+export function isLive(session, now) {
+    const grace = Math.max(session.interval_seconds * 3, 60) * 1000;
+    return running(session.pid) && now - Date.parse(session.last_seen) <= grace;
+}
+/**
+ * Record this agent and return the other live agents on the same bot. Two of them polling one
+ * token split the updates between themselves, so the caller warns the user about the ones returned.
+ */
+export function touch(entry, now = Date.now()) {
+    const stamp = new Date(now).toISOString();
+    const others = read().filter((s) => !(s.pid === entry.pid && s.bot === entry.bot) && isLive(s, now));
+    const mine = read().find((s) => s.pid === entry.pid && s.bot === entry.bot);
+    write([...others, { ...entry, started_at: mine?.started_at ?? stamp, last_seen: stamp }]);
+    return others.filter((s) => s.bot === entry.bot);
+}
+/** Drop this process's record. Best effort — a crash is covered by the liveness check instead. */
+export function release(pid = process.pid) {
+    try {
+        write(read().filter((s) => s.pid !== pid));
+    }
+    catch {
+        // nothing useful to do while exiting
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/setup.js

@@ -0,0 +1,125 @@
+/** Interactive bot onboarding: validate a token, learn the chat id by watching for a message. */
+import { createInterface } from "node:readline/promises";
+import { apiFor } from "./telegram.js";
+import { readConfig, writeConfig, configPath } from "./config.js";
+import { agents, runCli, writeFileConfig, ensureGitignored } from "./agents.js";
+const say = (s = "") => console.log(s);
+export async function addBotInteractive(preferredName) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        say("1. Open https://t.me/BotFather, send /newbot and follow the prompts.");
+        say("   BotFather replies with a token like 8123456789:AAH...\n");
+        const token = (await rl.question("Paste the bot token: ")).trim();
+        const api = apiFor(token);
+        const me = await api("getMe", {}).catch(() => {
+            throw new Error("Telegram rejected that token. Copy the whole line BotFather sent, including the digits before the colon.");
+        });
+        say(`\n✓ Token belongs to @${me.username}\n`);
+        say(`2. Open https://t.me/${me.username} and send it any message (say "hi").`);
+        say("   Waiting...");
+        const { chatId, userId, chatType } = await waitForFirstMessage(api);
+        say(`\n✓ Chat id ${chatId}${chatType === "private" ? "" : ` (${chatType})`}, your user id ${userId}\n`);
+        const config = readConfig();
+        const fallback = preferredName ?? (Object.keys(config.bots).length ? "" : "main");
+        const name = preferredName ?? ((await rl.question(`Name for this bot${fallback ? ` [${fallback}]` : ""}: `)).trim() || fallback);
+        if (!name)
+            throw new Error("a name is required");
+        const bot = { token, chatId, allowFrom: [userId] };
+        config.bots[name] = bot;
+        config.defaultBot ??= name;
+        writeConfig(config);
+        say(`✓ Wrote ${configPath()} (default bot: ${config.defaultBot})`);
+        await api("sendMessage", {
+            chat_id: chatId,
+            text: `<b>telex</b>\n\nSetup complete — bot "${name}" is ready.`,
+            parse_mode: "HTML",
+        });
+        say("✓ Sent a test message; check Telegram.\n");
+        return name;
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Long-poll until the user messages the bot, skipping whatever was already queued. */
+async function waitForFirstMessage(api) {
+    const seen = await api("getUpdates", { offset: -1, timeout: 0 });
+    let offset = seen.length ? seen[seen.length - 1].update_id + 1 : 0;
+    for (;;) {
+        const updates = await api("getUpdates", { offset, timeout: 30, allowed_updates: ["message"] });
+        for (const u of updates) {
+            offset = Math.max(offset, u.update_id + 1);
+            const msg = u.message;
+            if (msg)
+                return { chatId: msg.chat.id, userId: msg.from?.id ?? msg.chat.id, chatType: msg.chat.type };
+        }
+    }
+}
+/**
+ * Install the MCP registration into the current project: confirm the directory, pick an
+ * agent, then let that agent's CLI do it — or write the config file ourselves when it has none.
+ */
+export async function installConfig(bot, flags) {
+    const dir = process.cwd();
+    const list = agents();
+    const entry = { command: "telex", args: ["serve"], ...(bot ? { env: { TELEX_BOT: bot } } : {}) };
+    if (flags.scope && flags.scope !== "local" && flags.scope !== "project")
+        throw new Error(`--scope takes "local" or "project"`);
+    const interactive = !flags.agent && process.stdin.isTTY;
+    if (!flags.agent && !interactive)
+        throw new Error(`not a terminal — pass --agent <${list.map((a) => a.id).join("|")}> (or --print to just see the config)`);
+    const rl = interactive ? createInterface({ input: process.stdin, output: process.stdout }) : undefined;
+    try {
+        let agent;
+        if (flags.agent) {
+            agent = list.find((a) => a.id === flags.agent) ?? (() => { throw new Error(`unknown agent "${flags.agent}". Known: ${list.map((a) => a.id).join(", ")}`); })();
+        }
+        else {
+            if (!flags.yes) {
+                const answer = (await rl.question(`Install the telex MCP config in ${dir}? [Y/n] `)).trim().toLowerCase();
+                if (answer && !answer.startsWith("y"))
+                    return say("Nothing written. cd to the project you want and run it there.");
+            }
+            say();
+            list.forEach((a, i) => say(`  ${String(i + 1).padStart(2)}. ${a.label}`));
+            const pick = Number((await rl.question(`\nWhich agent? [1-${list.length}] `)).trim());
+            if (!Number.isInteger(pick) || pick < 1 || pick > list.length)
+                throw new Error("pick one of the listed numbers");
+            agent = list[pick - 1];
+        }
+        if (agent.cli) {
+            const argv = agent.cli(bot);
+            const result = runCli(argv, dir);
+            if (result)
+                return report(result, agent);
+            if (!agent.file)
+                throw new Error(`${agent.label}'s CLI ("${argv[0]}") is not on PATH, and it has no config file telex can write.`);
+            say(`! ${argv[0]} is not on PATH — writing ${agent.file} instead.\n`);
+        }
+        let local = flags.scope === "local";
+        if (agent.localFile && !flags.scope) {
+            if (!interactive)
+                throw new Error(`${agent.label} needs --scope local (gitignored) or --scope project (committed)`);
+            say(`\n  1. Committed  ${agent.file} — shared with the team`);
+            say(`  2. Local only ${agent.localFile} — gitignored, just you`);
+            local = (await rl.question(`\nWhich one? [1-2] `)).trim() === "2";
+        }
+        const result = writeFileConfig(agent, entry, dir, local);
+        const ignored = local && agent.localFile ? ensureGitignored(dir, agent.localFile) : null;
+        report(result, agent);
+        if (ignored)
+            say(`✓ Added ${agent.localFile} to ${ignored}`);
+    }
+    finally {
+        rl?.close();
+    }
+}
+function report(result, agent) {
+    say(`${result.ok ? "✓" : "✗"} ${agent.label}: ${result.how}`);
+    if (result.output)
+        for (const line of result.output.split("\n"))
+            say(`  ${line}`);
+    if (!result.ok)
+        process.exitCode = 1;
+}
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/telegram.js

@@ -0,0 +1,205 @@
+/** Thin Telegram Bot API client plus an on-demand long-poll loop per bot token. */
+export class TelegramError extends Error {
+    method;
+    description;
+    code;
+    constructor(method, description, code = 0) {
+        super(`telegram ${method} failed: ${description}`);
+        this.method = method;
+        this.description = description;
+        this.code = code;
+    }
+}
+/** Bot tokens appear in API URLs, so they leak through raw fetch errors. */
+export const redactToken = (s, token) => (token ? s.split(token).join("<token>") : s);
+export function apiFor(token) {
+    return async function call(method, params, attempt = 0) {
+        let body;
+        try {
+            const res = await fetch(`https://api.telegram.org/bot${token}/${method}`, {
+                method: "POST",
+                headers: { "content-type": "application/json" },
+                body: JSON.stringify(params),
+            });
+            body = (await res.json());
+        }
+        catch (err) {
+            throw new Error(redactToken(`telegram ${method} request failed: ${err.message}`, token));
+        }
+        if (body.ok)
+            return body.result;
+        const retryAfter = body.parameters?.retry_after;
+        if (retryAfter !== undefined && attempt < 2) {
+            await new Promise((r) => setTimeout(r, (retryAfter + 1) * 1000));
+            return call(method, params, attempt + 1);
+        }
+        throw new TelegramError(method, redactToken(body.description ?? "unknown error", token), 0);
+    };
+}
+/** Telegram's HTML subset only needs these three escaped in text nodes. */
+export const escapeHtml = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+/** Telegram counts message length in UTF-16 code units, which is what JS strings already are. */
+export const MAX_MESSAGE_LEN = 4000;
+/** An agent that never checks in must not grow the inbox without bound; oldest go first. */
+const INBOX_LIMIT = 50;
+/**
+ * One session per bot token. Polling runs while a question is open and, once a chat is watched,
+ * for the rest of the process's life — a project that is not running simply never answers.
+ */
+export class BotSession {
+    api;
+    pollTimeout;
+    offset = 0;
+    backlogSkipped = false;
+    looping = false;
+    callbackWaiters = new Map();
+    textWaiters = new Map();
+    watched = new Map();
+    inbox = new Map();
+    ttl = new Map();
+    listening = false;
+    constructor(api, pollTimeout = 30) {
+        this.api = api;
+        this.pollTimeout = pollTimeout;
+    }
+    onCallback(requestId, fn) {
+        this.callbackWaiters.set(requestId, fn);
+        this.ensureLoop();
+        return () => this.callbackWaiters.delete(requestId);
+    }
+    onText(chatId, fn) {
+        this.textWaiters.set(String(chatId), fn);
+        this.ensureLoop();
+        return () => this.textWaiters.delete(String(chatId));
+    }
+    /**
+     * Take an interest in a chat and keep polling for the life of the process. Being alive is what
+     * makes a project reachable: if nothing polls, nothing acknowledges, and nothing was delivered.
+     */
+    watch(chatId, options = {}) {
+        this.watched.set(String(chatId), options);
+        this.listening = true;
+        this.ensureLoop();
+    }
+    /** Stop the permanent poll. The loop still runs out whatever question is currently open. */
+    stop() {
+        this.listening = false;
+        this.watched.clear();
+        this.ttl.clear();
+    }
+    /**
+     * How long a message may sit unclaimed. Set from the agent's heartbeat interval, so until it
+     * checks in for the first time telex has no idea how long "too long" is and nothing expires.
+     */
+    setInboxTtl(chatId, ms) {
+        this.ttl.set(String(chatId), ms);
+    }
+    /** Hand over everything held for this chat. */
+    take(chatId) {
+        const key = String(chatId);
+        const queued = this.inbox.get(key) ?? [];
+        this.inbox.delete(key);
+        return queued;
+    }
+    get idle() {
+        return this.callbackWaiters.size === 0 && this.textWaiters.size === 0;
+    }
+    ensureLoop() {
+        if (this.looping)
+            return;
+        this.looping = true;
+        void this.loop().finally(() => (this.looping = false));
+    }
+    /**
+     * Messages the user sent before we asked anything must not be read as an answer,
+     * so the first poll of a process discards whatever is queued.
+     */
+    async skipBacklog() {
+        if (this.backlogSkipped)
+            return;
+        this.backlogSkipped = true;
+        const updates = await this.api("getUpdates", { offset: -1, timeout: 0 }).catch(() => []);
+        for (const u of updates)
+            this.offset = Math.max(this.offset, u.update_id + 1);
+    }
+    async loop() {
+        await this.skipBacklog();
+        while (this.listening || !this.idle) {
+            let updates;
+            try {
+                updates = await this.api("getUpdates", {
+                    offset: this.offset,
+                    timeout: this.pollTimeout,
+                    allowed_updates: ["message", "callback_query"],
+                });
+            }
+            catch (err) {
+                if (isPollingConflict(err)) {
+                    process.stderr.write("telex: getUpdates conflict — another process is polling this bot token. " +
+                        "Give telex its own bot, or stop the other poller.\n");
+                }
+                await new Promise((r) => setTimeout(r, 1000));
+                continue;
+            }
+            for (const u of updates)
+                this.dispatch(u);
+            this.sweepInbox();
+        }
+    }
+    /** Exposed for tests: route one update to whoever is waiting for it. */
+    dispatch(u) {
+        this.offset = Math.max(this.offset, u.update_id + 1);
+        const cq = u.callback_query;
+        if (cq?.data?.startsWith("telex:")) {
+            const [, requestId, payload] = cq.data.split(":");
+            this.callbackWaiters.get(requestId)?.(payload ?? "", {
+                callbackId: cq.id,
+                fromId: cq.from?.id,
+                chatId: cq.message?.chat.id,
+            });
+            return;
+        }
+        const msg = u.message;
+        // Slash commands stay available to whatever else the user runs against this bot.
+        if (msg?.text === undefined || msg.text.startsWith("/"))
+            return;
+        const key = String(msg.chat.id);
+        const answering = this.textWaiters.get(key);
+        if (answering)
+            return answering(msg.text, msg.from?.id);
+        this.queue(key, msg);
+    }
+    /** Nobody asked for this one, so hold it rather than let it answer whatever gets asked next. */
+    queue(key, msg, now = Date.now()) {
+        const watch = this.watched.get(key);
+        if (!watch)
+            return;
+        if (watch.allowFrom?.length && !(msg.from && watch.allowFrom.includes(msg.from.id)))
+            return;
+        const message = { message_id: msg.message_id, from_id: msg.from?.id, text: msg.text, received_at: now };
+        if (watch.accept && !watch.accept())
+            return watch.onRefused?.(message);
+        this.inbox.set(key, [...(this.inbox.get(key) ?? []), message].slice(-INBOX_LIMIT));
+        watch.onQueued?.(message);
+    }
+    /**
+     * Drop whatever outlived the TTL. Runs on every poll, so a message expires even when the agent
+     * has stopped checking in entirely — which is exactly when the user most needs telling.
+     */
+    sweepInbox(now = Date.now()) {
+        for (const [key, held] of this.inbox) {
+            const ttl = this.ttl.get(key);
+            if (ttl === undefined)
+                continue;
+            const expired = held.filter((m) => now - m.received_at > ttl);
+            if (!expired.length)
+                continue;
+            this.inbox.set(key, held.filter((m) => now - m.received_at <= ttl));
+            this.watched.get(key)?.onExpired?.(expired);
+        }
+    }
+}
+export const isPollingConflict = (err) => err instanceof TelegramError && /conflict|terminated by other/i.test(err.description);
+const sessions = new Map();
+export const sessionFor = (token) => sessions.get(token) ?? (sessions.set(token, new BotSession(apiFor(token))), sessions.get(token));
+//# sourceMappingURL=telegram.js.map

package/dist/telegram.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@sojaner/telex",
+  "version": "0.1.15",
+  "description": "MCP server that lets local AI agents ask users questions through Telegram bots",
+  "type": "module",
+  "bin": {
+    "telex": "dist/cli.js"
+  },
+  "engines": {
+    "node": ">=22.6",
+    "pnpm": ">=11"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "config.example.json",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Sojaner/telex.git"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "telex": "node src/cli.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "node --test test/*.test.ts"
+  }
+}