opensquid 0.5.395

package/dist/chat/adapters/telegram.js

@@ -0,0 +1,498 @@
+/**
+ * Telegram adapter — long-polling via the official Bot API (v0.7a).
+ *
+ * Rebuild path when you edit this file: `pnpm build` does NOT recompile
+ * src.legacy/ (rootDir=src per tsconfig.build.json), but the chat-daemon
+ * worker loads `dist/chat/adapters/telegram.js` at runtime. After
+ * editing, regenerate the dist file with:
+ *
+ *     pnpm exec tsc src.legacy/chat/adapters/telegram.ts \
+ *         --outDir dist --rootDir src.legacy \
+ *         --module NodeNext --moduleResolution NodeNext --target ES2022 \
+ *         --esModuleInterop --skipLibCheck --noEmitOnError false
+ *
+ * Then `node ./dist/index.js chat-daemon restart` to load the new code.
+ * Without the restart, sends keep using the old in-memory adapter.
+ *
+ * SDK: `grammy` (modern, TS-first, actively maintained — recommended
+ * over `telegraf` which is frozen at v4.16 from Feb 2024 and over
+ * `node-telegram-bot-api` which is untyped).
+ *
+ * Connection: long-polling via `bot.start()` — no public webhook URL
+ * required. The bot opens an outbound HTTPS connection to
+ * `api.telegram.org` and polls for updates. Works behind any NAT.
+ *
+ * Why `grammy` is loaded via dynamic import: opensquid declares all
+ * three chat SDKs as optionalDependencies. Users with no Telegram
+ * config (and possibly `npm --omit=optional`) shouldn't pay the install
+ * cost. The dynamic import only runs in `start()` when this adapter
+ * is actually being activated — and produces a clear "install grammy"
+ * error if the dep is missing.
+ *
+ * Gotcha: only ONE polling consumer per token at a time. A second
+ * opensquid process with the same token will collide with 409 Conflict.
+ * Surface that error clearly on start.
+ */
+import { ChatGatewayError, formatChannelId, } from "../gateway.js";
+export class TelegramAdapter {
+    config;
+    platform = "telegram";
+    bot = null;
+    handlers = [];
+    botUsername = "";
+    botId = "";
+    startPromise = null;
+    /**
+     * 0.7.4 (#147): true when the long-poll lost to a 409 Conflict
+     * (another consumer holds the token — typically the Claude Code
+     * `plugin:telegram` bun bot). Outbound sendMessage still works via
+     * HTTPS, only inbound is dead. A periodic retry attempts to reclaim.
+     */
+    outboundOnly = false;
+    /** 0.7.4 (#147): handle for the periodic long-poll retry timer. */
+    retryTimer = null;
+    /** Retry cadence — long enough that flapping doesn't burn API quota. */
+    static RETRY_INTERVAL_MS = 60_000;
+    /**
+     * 0.5.90 (TG.3): chat_ids for which we've already logged an allowlist
+     * drop this process. The adapter silently drops messages from non-
+     * allowlisted chats (correct policy — never echo policy decisions back
+     * to the sender), but operators need a one-time-per-chat log line so
+     * they can diagnose "why isn't my message routing?" without reading
+     * source. Tracked as a Set keyed by chatIdStr; resets on restart.
+     */
+    allowlistDropLogged = new Set();
+    constructor(config) {
+        this.config = config;
+        if (!config.bot_token?.trim()) {
+            throw new ChatGatewayError("telegram adapter: bot_token is required", "set chat_connections.telegram.bot_token in ~/.opensquid/config.json");
+        }
+    }
+    async start() {
+        if (this.bot)
+            return;
+        let Bot;
+        try {
+            const grammy = (await import("grammy"));
+            Bot = grammy.Bot;
+        }
+        catch (err) {
+            // v0.7 audit fix (M5): distinguish "not installed" from "installed
+            // but threw on load" — different remediation each case.
+            const code = err?.code;
+            if (code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND") {
+                throw new ChatGatewayError("telegram adapter: 'grammy' SDK not installed", "run `npm install grammy` (or reinstall opensquid without --omit=optional)");
+            }
+            throw new ChatGatewayError(`telegram adapter: 'grammy' SDK failed to load: ${err instanceof Error ? err.message : String(err)}`, "the SDK is installed but threw on import — check node version compatibility");
+        }
+        const bot = new Bot(this.config.bot_token);
+        this.bot = bot;
+        // Probe identity + token validity. Throws on bad token.
+        const me = await bot.api.getMe();
+        this.botUsername = me.username ?? "";
+        this.botId = String(me.id);
+        bot.on("message", async (ctx) => {
+            const m = ctx.message;
+            if (!m?.text)
+                return; // ignore non-text in v0.7
+            const chatIdStr = String(m.chat.id);
+            // Allowlist enforcement.
+            if (this.config.allowlist_chat_ids &&
+                this.config.allowlist_chat_ids.length > 0 &&
+                !this.config.allowlist_chat_ids.includes(chatIdStr)) {
+                // Silently drop on the chat side (correct — never echo policy back
+                // to the sender). But log once per chat_id per process lifetime
+                // (0.5.90 / TG.3) so operators can diagnose "why isn't my message
+                // routing?" without reading source. The first message from a
+                // newly-talking chat surfaces the drop with a hint to fix.
+                if (!this.allowlistDropLogged.has(chatIdStr)) {
+                    this.allowlistDropLogged.add(chatIdStr);
+                    const chatType = m.chat.type;
+                    const hint = "add this chat_id to chat_connections.telegram.allowlist_chat_ids in ~/.opensquid/config.json to enable inbound routing";
+                    // eslint-disable-next-line no-console
+                    console.error(`[telegram adapter] dropped inbound from non-allowlisted chat ${chatIdStr} (type=${chatType}); ${hint}`);
+                }
+                return;
+            }
+            const normalized = {
+                id: String(m.message_id),
+                threadId: m.message_thread_id !== undefined ? String(m.message_thread_id) : undefined,
+                platform: "telegram",
+                channel: formatChannelId("telegram", chatIdStr),
+                sender: m.from?.username ?? m.from?.first_name ?? String(m.from?.id ?? "unknown"),
+                senderId: String(m.from?.id ?? ""),
+                text: m.text,
+                receivedAt: new Date(m.date * 1000),
+                mentionsBot: detectBotMention(m.text, m.entities, this.botUsername),
+            };
+            for (const h of this.handlers) {
+                try {
+                    await h(normalized);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    // eslint-disable-next-line no-console
+                    console.error(`[telegram adapter] handler error: ${msg}`);
+                }
+            }
+        });
+        // `bot.start()` resolves only on bot.stop(). Fire-and-track via a
+        // promise we keep around for shutdown, but don't await it here.
+        // 0.7.4 (#147) fix: rejection handler delegates to
+        // handleStartRejection() so tests can exercise the 409 path
+        // without spinning up grammy.
+        this.startPromise = bot.start().catch((err) => this.handleStartRejection(err));
+        // Yield once so the polling loop has a tick to register before the
+        // gateway moves on to dispatch outbound messages.
+        await new Promise((r) => setImmediate(r));
+    }
+    /**
+     * 0.7.4 (#147): handle a rejection from `bot.start()`. Extracted
+     * from inline catch handler so tests can simulate 409 without
+     * needing a live grammy + colliding bot. EXPORTED VIA PROTECTED for
+     * test-only direct invocation; not part of the public adapter API.
+     */
+    handleStartRejection(err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const is409 = /409|Conflict/.test(msg);
+        if (is409) {
+            // eslint-disable-next-line no-console
+            console.error(`[telegram adapter] long-poll lost to 409 Conflict — degrading to OUTBOUND-ONLY (outbound sendMessage still works); periodic retry every ${TelegramAdapter.RETRY_INTERVAL_MS / 1000}s`);
+            this.outboundOnly = true;
+            this.startPromise = null;
+            this.scheduleRetry();
+        }
+        else {
+            // eslint-disable-next-line no-console
+            console.error(`[telegram adapter] long-poll loop errored: ${msg}`);
+            this.bot = null;
+            this.startPromise = null;
+        }
+    }
+    /**
+     * 0.7.4 (#147): test-only seed — install a fake bot reference + mark
+     * outbound-only so tests can verify isOutboundOnly() + retry timer
+     * without spinning up grammy. Must be called before any
+     * handleStartRejection in test context.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _testSeed(fakeBot) {
+        this.bot = fakeBot;
+    }
+    /**
+     * 0.7.4 (#147): test-only — clear the retry timer so tests don't
+     * leak intervals after a 409 simulation.
+     */
+    _testClearRetryTimer() {
+        if (this.retryTimer) {
+            clearInterval(this.retryTimer);
+            this.retryTimer = null;
+        }
+    }
+    /**
+     * 0.7.4 (#147): periodically retry the long-poll while in outbound-
+     * only mode. If the competing consumer disconnects, we reclaim
+     * inbound transparently.
+     */
+    scheduleRetry() {
+        if (this.retryTimer)
+            return;
+        this.retryTimer = setInterval(() => {
+            void this.tryReclaim();
+        }, TelegramAdapter.RETRY_INTERVAL_MS);
+    }
+    async tryReclaim() {
+        if (!this.outboundOnly || !this.bot)
+            return;
+        const bot = this.bot;
+        // Fire bot.start() again; same rejection handling as the initial
+        // start. If 409, stay outbound-only. If success (no rejection
+        // observable yet — start() resolves only on stop()), clear the
+        // outboundOnly flag and stop the retry timer.
+        const next = bot.start().catch((err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            const is409 = /409|Conflict/.test(msg);
+            if (!is409) {
+                // eslint-disable-next-line no-console
+                console.error(`[telegram adapter] retry start() errored: ${msg}`);
+            }
+            // Stay outbound-only; retry timer keeps running.
+            return;
+        });
+        // Yield to let the long-poll register if it's going to succeed.
+        await new Promise((r) => setImmediate(r));
+        // If the bot reference is still alive and no rejection fired yet,
+        // assume the long-poll is back. Reclaim inbound.
+        if (this.bot && this.outboundOnly) {
+            // Heuristic check: getMe still succeeds (the bot can still talk
+            // to the API). If 409 already rejected `next`, that handler will
+            // have run by now. We can't directly observe "start succeeded"
+            // because start() doesn't resolve on success — it stays pending.
+            // So we look for the absence of a fresh 409.
+            try {
+                await bot.api.getMe();
+                this.outboundOnly = false;
+                this.startPromise = next;
+                if (this.retryTimer) {
+                    clearInterval(this.retryTimer);
+                    this.retryTimer = null;
+                }
+                // eslint-disable-next-line no-console
+                console.error(`[telegram adapter] long-poll RECLAIMED — inbound restored`);
+            }
+            catch {
+                // getMe failed → keep outbound-only, retry on next tick
+            }
+        }
+    }
+    async shutdown() {
+        if (!this.bot)
+            return;
+        // 0.7.4 (#147): stop the retry timer first so it doesn't fire
+        // mid-shutdown and resurrect a dead adapter.
+        if (this.retryTimer) {
+            clearInterval(this.retryTimer);
+            this.retryTimer = null;
+        }
+        try {
+            await this.bot.stop();
+        }
+        catch {
+            // best-effort — if grammy already torn down, nothing to do
+        }
+        if (this.startPromise) {
+            // bot.start()'s promise should resolve after stop. Don't hang
+            // forever though — race against a short timeout.
+            await Promise.race([this.startPromise, new Promise((r) => setTimeout(r, 2000))]);
+        }
+        this.bot = null;
+        this.startPromise = null;
+        this.outboundOnly = false;
+    }
+    /**
+     * 0.7.4 (#147): introspection accessor for tests + the
+     * `chat_daemon_status` MCP tool to surface "outbound-only" state to
+     * operators trying to diagnose "where did my message go?"
+     */
+    isOutboundOnly() {
+        return this.outboundOnly;
+    }
+    onMessage(handler) {
+        this.handlers.push(handler);
+    }
+    async send(message) {
+        if (!this.bot) {
+            throw new ChatGatewayError("telegram adapter: not started", "call gateway.start() before send()");
+        }
+        const { chatId, threadId: channelThreadId } = parseTelegramChannel(message.channel);
+        const opts = {};
+        if (message.replyTo) {
+            const n = Number(message.replyTo);
+            if (Number.isFinite(n))
+                opts.reply_to_message_id = n;
+        }
+        // Explicit `message.threadId` from the caller wins over a thread id
+        // embedded in the channel string. The embedded form exists so that
+        // composite channel literals echoed from `chat_poll_inbox`
+        // (e.g. `telegram:-1001234567890:15`) can be passed back to
+        // `chat_send` verbatim without the caller having to split them.
+        const effectiveThreadId = message.threadId ?? channelThreadId;
+        if (effectiveThreadId !== undefined) {
+            const n = Number(effectiveThreadId);
+            if (Number.isFinite(n))
+                opts.message_thread_id = n;
+        }
+        // TPS.7 (v0.5.130) — detect topic-gone failure and re-throw as a
+        // typed error so the daemon's send-RPC handler can clear the stale
+        // binding + notify the operator. Other Bot API failures propagate
+        // unchanged (the caller's existing error path stays in charge).
+        let sent;
+        try {
+            sent = await this.bot.api.sendMessage(chatId, message.text, opts);
+        }
+        catch (err) {
+            if (isTopicGoneError(err) && opts.message_thread_id !== undefined) {
+                throw new TopicGoneError(extractGrammyDescription(err) ?? "topic gone", chatId, opts.message_thread_id, err);
+            }
+            throw err;
+        }
+        return {
+            platform: "telegram",
+            messageId: String(sent.message_id),
+            deliveredAt: new Date(sent.date * 1000),
+        };
+    }
+    /**
+     * v0.7.2 — Create a forum topic in a supergroup. Requires the bot
+     * to be admin with "Manage Topics" permission and the supergroup to
+     * have Topics enabled in settings. Returns the topic's
+     * `message_thread_id` for storage in chat-routing.json.
+     */
+    async createTopic(chatId, name, options = {}) {
+        if (!this.bot) {
+            throw new ChatGatewayError("telegram adapter: not started", "call gateway.start() before createTopic()");
+        }
+        const apiOpts = {};
+        if (options.iconColor !== undefined)
+            apiOpts.icon_color = options.iconColor;
+        if (options.iconCustomEmojiId !== undefined)
+            apiOpts.icon_custom_emoji_id = options.iconCustomEmojiId;
+        const res = await this.bot.api.createForumTopic(chatId, name, apiOpts);
+        return { message_thread_id: res.message_thread_id, name: res.name };
+    }
+    async identity() {
+        if (!this.bot) {
+            throw new ChatGatewayError("telegram adapter: not started");
+        }
+        return { username: this.botUsername, nativeId: this.botId };
+    }
+}
+// ---------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------
+/**
+ * Parse a Telegram channel id (with optional embedded forum-topic
+ * thread id) into its native chat_id + message_thread_id parts.
+ *
+ * Wire format (canonical, mirrors `chat_poll_inbox` output):
+ * - `telegram:<chat_id>`              → general topic, no thread
+ * - `telegram:<chat_id>:<thread_id>`  → forum topic (supergroup with
+ *                                       Topics enabled)
+ *
+ * Examples:
+ * - `telegram:-1001234567890`      → `{ chatId: "-1001234567890" }`
+ * - `telegram:-1001234567890:15`   → `{ chatId: "-1001234567890",
+ *                                       threadId: "15" }`
+ * - `telegram:8075471258`          → `{ chatId: "8075471258" }` (DM)
+ *
+ * Why the parser lives in the adapter (not in `gateway.ts`): Slack uses
+ * a different colon-in-native-id convention (`slack:C012345:1234.5678`
+ * where the trailing segment is `thread_ts`, an opaque part of the
+ * native id). Telegram's `<chat_id>:<thread_id>` semantic is
+ * platform-specific and shouldn't leak into the cross-platform
+ * `nativeIdFromChannel` helper.
+ *
+ * Exported for unit testing.
+ */
+export function parseTelegramChannel(channel) {
+    const colon = channel.indexOf(":");
+    if (colon === -1) {
+        throw new ChatGatewayError(`malformed channel id '${channel}'`, "telegram channel ids must be 'telegram:<chat_id>' or 'telegram:<chat_id>:<thread_id>'");
+    }
+    if (channel.slice(0, colon) !== "telegram") {
+        throw new ChatGatewayError(`telegram adapter received non-telegram channel: '${channel}'`);
+    }
+    const rest = channel.slice(colon + 1);
+    if (rest.length === 0) {
+        throw new ChatGatewayError(`malformed channel id '${channel}': empty chat_id`);
+    }
+    // chat_id is always the first segment after `telegram:`. If a second
+    // colon-segment is present, it's the forum-topic message_thread_id.
+    const sep = rest.indexOf(":");
+    if (sep === -1) {
+        return { chatId: rest };
+    }
+    const chatId = rest.slice(0, sep);
+    const threadId = rest.slice(sep + 1);
+    if (chatId.length === 0) {
+        throw new ChatGatewayError(`malformed channel id '${channel}': empty chat_id`);
+    }
+    if (threadId.length === 0) {
+        throw new ChatGatewayError(`malformed channel id '${channel}': empty thread_id after second colon`);
+    }
+    if (!/^\d+$/.test(threadId)) {
+        throw new ChatGatewayError(`malformed channel id '${channel}': thread_id must be all-digits, got '${threadId}'`);
+    }
+    return { chatId, threadId };
+}
+// ---------------------------------------------------------------------
+// TPS.7 (v0.5.130) — typed stale-topic error
+// ---------------------------------------------------------------------
+/**
+ * Thrown by `TelegramAdapter.send` when the Telegram Bot API rejects an
+ * outbound `sendMessage` because the target `message_thread_id` no
+ * longer exists in the supergroup. The daemon's RPC `send` handler
+ * catches this, clears the workspace's stale binding via
+ * `clearBinding` (TPS.3), and surfaces the staleness through TPS.5's
+ * collision channel.
+ *
+ * Carries the underlying `GrammyError` (as `underlying: unknown`) for
+ * diagnostics — callers shouldn't peek into it but the daemon logs it.
+ *
+ * Why a typed error vs. introspecting the original GrammyError at the
+ * RPC layer: keeps grammy out of `rpc-server.ts` (which doesn't import
+ * the SDK) and makes the contract obvious at every call site.
+ */
+export class TopicGoneError extends Error {
+    chatId;
+    threadId;
+    underlying;
+    platform = "telegram";
+    constructor(message, chatId, threadId, underlying) {
+        super(message);
+        this.chatId = chatId;
+        this.threadId = threadId;
+        this.underlying = underlying;
+        this.name = "TopicGoneError";
+    }
+}
+/**
+ * Match Bot API 400 responses whose description matches one of the
+ * known "thread not found" shapes. Defensive against Telegram changing
+ * the description string: matches "message thread not found" with
+ * either casing, both underscores or spaces, and the legacy CAPS form.
+ *
+ * Exported for unit testing.
+ */
+export function isTopicGoneError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const code = err.error_code;
+    if (code !== 400)
+        return false;
+    const desc = extractGrammyDescription(err);
+    if (desc === undefined)
+        return false;
+    return /message[_ ]thread[_ ]not[_ ]found/i.test(desc);
+}
+/**
+ * Pull the human-readable description out of a GrammyError-shaped value,
+ * falling back to the Error.message. Returns undefined if neither yields
+ * a usable string.
+ *
+ * Exported for unit testing.
+ */
+export function extractGrammyDescription(err) {
+    if (typeof err !== "object" || err === null)
+        return undefined;
+    const desc = err.description;
+    if (typeof desc === "string" && desc.length > 0)
+        return desc;
+    if (err instanceof Error && err.message.length > 0)
+        return err.message;
+    return undefined;
+}
+/**
+ * Detect whether a message text contains an @-mention of this bot, or
+ * uses one of telegram's bot_command entities pointing at the bot
+ * (`/cmd@my_bot`).
+ *
+ * Exported for unit testing.
+ */
+export function detectBotMention(text, entities, botUsername) {
+    if (!botUsername)
+        return false;
+    const lower = `@${botUsername.toLowerCase()}`;
+    if (text.toLowerCase().includes(lower))
+        return true;
+    if (!entities)
+        return false;
+    for (const ent of entities) {
+        if (ent.type !== "mention" && ent.type !== "bot_command")
+            continue;
+        const slice = text.slice(ent.offset, ent.offset + ent.length).toLowerCase();
+        if (slice.includes(lower))
+            return true;
+    }
+    return false;
+}

package/dist/chat/adapters/telegram.js.map

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

package/dist/chat/adapters/telegram.test.js

@@ -0,0 +1,94 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { ChatGatewayError } from "../gateway.js";
+import { TelegramAdapter, detectBotMention } from "./telegram.js";
+describe("TelegramAdapter constructor", () => {
+    it("rejects empty bot_token", () => {
+        expect(() => new TelegramAdapter({ bot_token: "" })).toThrow(ChatGatewayError);
+    });
+    it("rejects whitespace-only bot_token", () => {
+        expect(() => new TelegramAdapter({ bot_token: "   " })).toThrow(ChatGatewayError);
+    });
+    it("accepts a real-shaped token", () => {
+        // Don't actually call start() — that would try to load grammy.
+        const a = new TelegramAdapter({ bot_token: "123:ABCDEF" });
+        expect(a.platform).toBe("telegram");
+    });
+});
+describe("detectBotMention", () => {
+    it("returns false when botUsername is empty", () => {
+        expect(detectBotMention("@somebot hello", [], "")).toBe(false);
+    });
+    it("detects plain @-mention", () => {
+        expect(detectBotMention("hey @mybot do x", [], "mybot")).toBe(true);
+    });
+    it("is case-insensitive", () => {
+        expect(detectBotMention("hey @MyBot", [], "mybot")).toBe(true);
+        expect(detectBotMention("hey @mybot", [], "MyBot")).toBe(true);
+    });
+    it("returns false when text mentions someone else", () => {
+        expect(detectBotMention("hey @otherbot", [], "mybot")).toBe(false);
+    });
+    it("detects /cmd@mybot entity (bot_command)", () => {
+        const text = "/start@mybot please";
+        const entities = [{ type: "bot_command", offset: 0, length: 14 }];
+        expect(detectBotMention(text, entities, "mybot")).toBe(true);
+    });
+    it("ignores entities of unrelated types", () => {
+        const text = "see https://mybot.example.com";
+        const entities = [{ type: "url", offset: 4, length: 25 }];
+        expect(detectBotMention(text, entities, "mybot")).toBe(false);
+    });
+});
+describe("TelegramAdapter — 409 outbound-only fallback (#147)", () => {
+    let adapter;
+    afterEach(() => {
+        if (adapter) {
+            adapter._testClearRetryTimer();
+        }
+    });
+    it("starts in long-poll mode (isOutboundOnly false on a fresh adapter)", () => {
+        adapter = new TelegramAdapter({ bot_token: "123:ABCDEF" });
+        expect(adapter.isOutboundOnly()).toBe(false);
+    });
+    it("degrades to outbound-only on a 409 Conflict error (does NOT null the bot)", () => {
+        adapter = new TelegramAdapter({ bot_token: "123:ABCDEF" });
+        // Seed a fake bot so handleStartRejection can verify the bot
+        // reference is preserved through the 409 path.
+        const fakeBot = { api: { sendMessage: () => Promise.resolve({ message_id: 1, date: 0 }) } };
+        adapter._testSeed(fakeBot);
+        adapter.handleStartRejection(new Error("Call to 'getUpdates' failed! (409: Conflict: terminated by other getUpdates)"));
+        expect(adapter.isOutboundOnly()).toBe(true);
+        // Outbound bot reference still alive (we can't directly check
+        // this.bot from outside, but the absence of a "telegram adapter:
+        // not started" error on a hypothetical send() is the contract;
+        // verified indirectly via isOutboundOnly + clean shutdown below).
+    });
+    it("matches the 409 detection across both 'Conflict' and '409' substrings", () => {
+        adapter = new TelegramAdapter({ bot_token: "123:ABCDEF" });
+        adapter._testSeed({ api: { sendMessage: () => Promise.resolve({ message_id: 1, date: 0 }) } });
+        adapter.handleStartRejection(new Error("HTTP 409 Conflict"));
+        expect(adapter.isOutboundOnly()).toBe(true);
+        const a2 = new TelegramAdapter({ bot_token: "123:ABCDEF" });
+        a2._testSeed({ api: { sendMessage: () => Promise.resolve({ message_id: 1, date: 0 }) } });
+        a2.handleStartRejection(new Error("Some random Conflict happened"));
+        expect(a2.isOutboundOnly()).toBe(true);
+        a2._testClearRetryTimer();
+    });
+    it("non-409 errors still tear down the bot (treats as genuine failure)", () => {
+        adapter = new TelegramAdapter({ bot_token: "123:ABCDEF" });
+        adapter._testSeed({ api: { sendMessage: () => Promise.resolve({ message_id: 1, date: 0 }) } });
+        adapter.handleStartRejection(new Error("ECONNREFUSED"));
+        // outboundOnly stays false; the bot was nulled
+        expect(adapter.isOutboundOnly()).toBe(false);
+    });
+    it("schedules a periodic retry timer when entering outbound-only mode", () => {
+        adapter = new TelegramAdapter({ bot_token: "123:ABCDEF" });
+        adapter._testSeed({ api: { sendMessage: () => Promise.resolve({ message_id: 1, date: 0 }) } });
+        expect(adapter.isOutboundOnly()).toBe(false);
+        adapter.handleStartRejection(new Error("409 Conflict"));
+        expect(adapter.isOutboundOnly()).toBe(true);
+        // Retry timer is private; we can't directly assert it exists, but
+        // _testClearRetryTimer() should successfully clear it (verified by
+        // the afterEach not throwing on subsequent runs).
+    });
+});