opensquid 0.5.441 → 0.5.449

package/dist/chat/adapters/telegram.js

@@ -1,498 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,94 +0,0 @@
-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).
-    });
-});