jinn-cli 0.7.8 → 0.9.0

package/dist/src/connectors/telegram/__tests__/connector.test.js

@@ -0,0 +1,257 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+// Mock node-telegram-bot-api before importing connector
+const mockSendMessage = vi.fn().mockResolvedValue({ message_id: 1 });
+const mockEditMessageText = vi.fn().mockResolvedValue(true);
+const mockGetMe = vi.fn().mockResolvedValue({ id: 999, username: "test_bot" });
+const mockStartPolling = vi.fn();
+const mockStopPolling = vi.fn().mockResolvedValue(undefined);
+const mockOn = vi.fn();
+vi.mock("node-telegram-bot-api", () => {
+    const MockBot = vi.fn(function () {
+        this.sendMessage = mockSendMessage;
+        this.editMessageText = mockEditMessageText;
+        this.getMe = mockGetMe;
+        this.startPolling = mockStartPolling;
+        this.stopPolling = mockStopPolling;
+        this.on = mockOn;
+    });
+    return { default: MockBot };
+});
+vi.mock("../../../shared/logger.js", () => ({
+    logger: {
+        info: vi.fn(),
+        warn: vi.fn(),
+        debug: vi.fn(),
+        error: vi.fn(),
+    },
+}));
+// Import after mocks are set up
+const { TelegramConnector } = await import("../index.js");
+describe("TelegramConnector", () => {
+    let connector;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        connector = new TelegramConnector({
+            botToken: "123456:ABC-DEF",
+        });
+    });
+    describe("constructor", () => {
+        it("sets the connector name to telegram", () => {
+            expect(connector.name).toBe("telegram");
+        });
+    });
+    describe("getCapabilities", () => {
+        it("returns correct capabilities", () => {
+            expect(connector.getCapabilities()).toEqual({
+                threading: false,
+                messageEdits: true,
+                reactions: false,
+                attachments: true,
+            });
+        });
+    });
+    describe("getHealth", () => {
+        it("returns stopped before start", () => {
+            const health = connector.getHealth();
+            expect(health.status).toBe("stopped");
+        });
+    });
+    describe("start", () => {
+        it("registers message handler and starts polling after validation", async () => {
+            await connector.start();
+            const health = connector.getHealth();
+            expect(health.status).toBe("running");
+            expect(mockGetMe).toHaveBeenCalledOnce();
+            expect(mockStartPolling).toHaveBeenCalledOnce();
+            expect(mockOn).toHaveBeenCalledWith("message", expect.any(Function));
+        });
+        it("does not start polling if getMe fails (invalid token)", async () => {
+            mockGetMe.mockRejectedValueOnce(new Error("Invalid token"));
+            await connector.start();
+            const health = connector.getHealth();
+            expect(health.status).toBe("error");
+            expect(health.detail).toContain("Invalid token");
+            expect(mockStartPolling).not.toHaveBeenCalled();
+        });
+    });
+    describe("stop", () => {
+        it("stops polling and sets stopped state", async () => {
+            await connector.start();
+            await connector.stop();
+            expect(mockStopPolling).toHaveBeenCalledOnce();
+            expect(connector.getHealth().status).toBe("stopped");
+        });
+    });
+    describe("onMessage", () => {
+        it("routes incoming messages to the handler", async () => {
+            const handler = vi.fn();
+            connector.onMessage(handler);
+            await connector.start();
+            // Get the registered message callback
+            const messageCallback = mockOn.mock.calls.find((call) => call[0] === "message")?.[1];
+            expect(messageCallback).toBeDefined();
+            // Simulate incoming Telegram message
+            const telegramMsg = {
+                message_id: 42,
+                chat: { id: 12345, type: "private" },
+                from: { id: 67890, username: "testuser", first_name: "Test", is_bot: false },
+                date: Math.floor(Date.now() / 1000) + 10,
+                text: "Hello bot!",
+            };
+            await messageCallback(telegramMsg);
+            expect(handler).toHaveBeenCalledOnce();
+            const msg = handler.mock.calls[0][0];
+            expect(msg.connector).toBe("telegram");
+            expect(msg.source).toBe("telegram");
+            expect(msg.sessionKey).toBe("telegram:12345");
+            expect(msg.text).toBe("Hello bot!");
+            expect(msg.user).toBe("testuser");
+            expect(msg.userId).toBe("67890");
+            expect(msg.channel).toBe("12345");
+        });
+        it("ignores messages from bots", async () => {
+            const handler = vi.fn();
+            connector.onMessage(handler);
+            await connector.start();
+            const messageCallback = mockOn.mock.calls.find((call) => call[0] === "message")?.[1];
+            const botMsg = {
+                message_id: 1,
+                chat: { id: 12345, type: "private" },
+                from: { id: 999, username: "test_bot", first_name: "Bot", is_bot: true },
+                date: Math.floor(Date.now() / 1000) + 10,
+                text: "Bot message",
+            };
+            await messageCallback(botMsg);
+            expect(handler).not.toHaveBeenCalled();
+        });
+        it("ignores messages from unauthorized users when allowFrom is set", async () => {
+            const restricted = new TelegramConnector({
+                botToken: "123456:ABC-DEF",
+                allowFrom: [67890],
+            });
+            const handler = vi.fn();
+            restricted.onMessage(handler);
+            await restricted.start();
+            const messageCallback = mockOn.mock.calls.find((call) => call[0] === "message")?.[1];
+            // Unauthorized user
+            const msg = {
+                message_id: 1,
+                chat: { id: 11111, type: "private" },
+                from: { id: 99999, username: "stranger", first_name: "Stranger", is_bot: false },
+                date: Math.floor(Date.now() / 1000) + 10,
+                text: "Hello",
+            };
+            await messageCallback(msg);
+            expect(handler).not.toHaveBeenCalled();
+        });
+        it("rejects messages with from: undefined when allowFrom is set", async () => {
+            const restricted = new TelegramConnector({
+                botToken: "123456:ABC-DEF",
+                allowFrom: [67890],
+            });
+            const handler = vi.fn();
+            restricted.onMessage(handler);
+            await restricted.start();
+            const messageCallback = mockOn.mock.calls.find((call) => call[0] === "message")?.[1];
+            // Channel post or forwarded message with no `from`
+            const msg = {
+                message_id: 1,
+                chat: { id: 11111, type: "channel" },
+                date: Math.floor(Date.now() / 1000) + 10,
+                text: "Channel post",
+            };
+            await messageCallback(msg);
+            expect(handler).not.toHaveBeenCalled();
+        });
+        it("allows messages from authorized users through allowFrom", async () => {
+            const restricted = new TelegramConnector({
+                botToken: "123456:ABC-DEF",
+                allowFrom: [67890],
+            });
+            const handler = vi.fn();
+            restricted.onMessage(handler);
+            await restricted.start();
+            const messageCallback = mockOn.mock.calls.find((call) => call[0] === "message")?.[1];
+            const msg = {
+                message_id: 1,
+                chat: { id: 12345, type: "private" },
+                from: { id: 67890, username: "allowed_user", first_name: "Allowed", is_bot: false },
+                date: Math.floor(Date.now() / 1000) + 10,
+                text: "Hello",
+            };
+            await messageCallback(msg);
+            expect(handler).toHaveBeenCalledOnce();
+        });
+    });
+    describe("sendMessage", () => {
+        it("sends a message to the target chat", async () => {
+            const target = { channel: "12345" };
+            await connector.sendMessage(target, "Hello!");
+            expect(mockSendMessage).toHaveBeenCalledWith("12345", "Hello!", {
+                parse_mode: "Markdown",
+            });
+        });
+        it("does not send empty messages", async () => {
+            const target = { channel: "12345" };
+            await connector.sendMessage(target, "");
+            expect(mockSendMessage).not.toHaveBeenCalled();
+        });
+        it("chunks long messages", async () => {
+            const target = { channel: "12345" };
+            const longText = "A".repeat(5000);
+            await connector.sendMessage(target, longText);
+            expect(mockSendMessage).toHaveBeenCalledTimes(2);
+        });
+        it("retries without parse_mode on Markdown parse error", async () => {
+            mockSendMessage
+                .mockRejectedValueOnce(new Error("Bad Request: can't parse entities"))
+                .mockResolvedValueOnce({ message_id: 2 });
+            const target = { channel: "12345" };
+            const result = await connector.sendMessage(target, "**bad markdown");
+            // First call with Markdown, second without
+            expect(mockSendMessage).toHaveBeenCalledTimes(2);
+            expect(mockSendMessage.mock.calls[0][2]).toEqual({ parse_mode: "Markdown" });
+            expect(mockSendMessage.mock.calls[1][2]).toEqual({});
+            expect(result).toBe("2");
+        });
+    });
+    describe("replyMessage", () => {
+        it("sends a reply to a specific message", async () => {
+            const target = {
+                channel: "12345",
+                replyContext: { chatId: 12345, messageId: 42 },
+            };
+            await connector.replyMessage(target, "Reply!");
+            expect(mockSendMessage).toHaveBeenCalledWith("12345", "Reply!", {
+                parse_mode: "Markdown",
+                reply_to_message_id: 42,
+            });
+        });
+    });
+    describe("editMessage", () => {
+        it("edits an existing message", async () => {
+            const target = {
+                channel: "12345",
+                messageTs: "42",
+            };
+            await connector.editMessage(target, "Edited!");
+            expect(mockEditMessageText).toHaveBeenCalledWith("Edited!", {
+                chat_id: "12345",
+                message_id: 42,
+                parse_mode: "Markdown",
+            });
+        });
+    });
+    describe("reconstructTarget", () => {
+        it("reconstructs target from reply context", () => {
+            const target = connector.reconstructTarget({
+                chatId: 12345,
+                messageId: 42,
+            });
+            expect(target.channel).toBe("12345");
+            expect(target.messageTs).toBe("42");
+            expect(target.replyContext).toEqual({ chatId: 12345, messageId: 42 });
+        });
+    });
+});
+//# sourceMappingURL=connector.test.js.map

package/dist/src/connectors/telegram/__tests__/connector.test.js.map

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

package/dist/src/connectors/telegram/__tests__/format.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=format.test.d.ts.map

package/dist/src/connectors/telegram/__tests__/format.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.test.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/telegram/__tests__/format.test.ts"],"names":[],"mappings":""}

package/dist/src/connectors/telegram/__tests__/format.test.js

@@ -0,0 +1,79 @@
+import { describe, it, expect } from "vitest";
+import { markdownToTelegram, formatResponse } from "../format.js";
+describe("markdownToTelegram", () => {
+    describe("headings", () => {
+        it("converts markdown headings to bold text", () => {
+            expect(markdownToTelegram("# Heading 1")).toBe("*Heading 1*");
+            expect(markdownToTelegram("## Heading 2")).toBe("*Heading 2*");
+            expect(markdownToTelegram("### Heading 3")).toBe("*Heading 3*");
+        });
+    });
+    describe("bold", () => {
+        it("preserves **bold** as *bold*", () => {
+            expect(markdownToTelegram("**bold text**")).toBe("*bold text*");
+        });
+        it("converts __bold__ to *bold*", () => {
+            expect(markdownToTelegram("__bold text__")).toBe("*bold text*");
+        });
+    });
+    describe("italic", () => {
+        it("converts single *italic* to _italic_", () => {
+            expect(markdownToTelegram("*italic text*")).toBe("_italic text_");
+        });
+    });
+    describe("strikethrough", () => {
+        it("preserves ~~strikethrough~~", () => {
+            expect(markdownToTelegram("~~deleted~~")).toBe("~deleted~");
+        });
+    });
+    describe("links", () => {
+        it("converts markdown links to Telegram inline links", () => {
+            expect(markdownToTelegram("[Google](https://google.com)")).toBe("[Google](https://google.com)");
+        });
+    });
+    describe("bullet lists", () => {
+        it("converts - items to bullet points", () => {
+            expect(markdownToTelegram("- item one\n- item two")).toBe("• item one\n• item two");
+        });
+        it("converts * items to bullet points", () => {
+            expect(markdownToTelegram("* item one\n* item two")).toBe("• item one\n• item two");
+        });
+        it("preserves indentation", () => {
+            expect(markdownToTelegram("  - nested")).toBe("  • nested");
+        });
+    });
+    describe("code blocks", () => {
+        it("preserves inline code untouched", () => {
+            expect(markdownToTelegram("`**not bold**`")).toBe("`**not bold**`");
+        });
+        it("preserves fenced code blocks untouched", () => {
+            const input = "```\n**not bold**\n```";
+            expect(markdownToTelegram(input)).toBe(input);
+        });
+    });
+    describe("mixed content", () => {
+        it("handles mixed markdown correctly", () => {
+            const input = "## Title\n\n**Bold** and ~~deleted~~ with `code`";
+            const expected = "*Title*\n\n*Bold* and ~deleted~ with `code`";
+            expect(markdownToTelegram(input)).toBe(expected);
+        });
+    });
+});
+describe("formatResponse", () => {
+    it("returns a single chunk for short messages", () => {
+        const result = formatResponse("Hello world");
+        expect(result).toEqual(["Hello world"]);
+    });
+    it("splits long messages at newline boundaries", () => {
+        const line = "A".repeat(4000);
+        const input = `${line}\n${"B".repeat(4000)}`;
+        const result = formatResponse(input);
+        expect(result.length).toBe(2);
+        expect(result[0]).toBe(line);
+    });
+    it("applies markdown conversion before chunking", () => {
+        const result = formatResponse("## Hello");
+        expect(result).toEqual(["*Hello*"]);
+    });
+});
+//# sourceMappingURL=format.test.js.map

package/dist/src/connectors/telegram/__tests__/format.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.test.js","sourceRoot":"","sources":["../../../../../src/connectors/telegram/__tests__/format.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAElE,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACxB,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC9D,MAAM,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC/D,MAAM,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,CAAC,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CAAC,kBAAkB,CAAC,8BAA8B,CAAC,CAAC,CAAC,IAAI,CAC7D,8BAA8B,CAC/B,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CACvD,wBAAwB,CACzB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;YAC3C,MAAM,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CACvD,wBAAwB,CACzB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;YAC/B,MAAM,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,KAAK,GAAG,wBAAwB,CAAC;YACvC,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,KAAK,GAAG,kDAAkD,CAAC;YACjE,MAAM,QAAQ,GAAG,6CAA6C,CAAC;YAC/D,MAAM,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/connectors/telegram/__tests__/threads.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=threads.test.d.ts.map

package/dist/src/connectors/telegram/__tests__/threads.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.test.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/telegram/__tests__/threads.test.ts"],"names":[],"mappings":""}

package/dist/src/connectors/telegram/__tests__/threads.test.js

@@ -0,0 +1,51 @@
+import { describe, it, expect } from "vitest";
+import { deriveSessionKey, buildReplyContext, isOldTelegramMessage } from "../threads.js";
+describe("deriveSessionKey", () => {
+    it("returns telegram:<chatId> for a private chat", () => {
+        expect(deriveSessionKey({ chat: { id: 12345, type: "private" }, message_id: 1 })).toBe("telegram:12345");
+    });
+    it("returns telegram:<chatId> for a group chat", () => {
+        expect(deriveSessionKey({ chat: { id: -100999, type: "group" }, message_id: 1 })).toBe("telegram:-100999");
+    });
+    it("returns telegram:<chatId> for a supergroup", () => {
+        expect(deriveSessionKey({ chat: { id: -1001234, type: "supergroup" }, message_id: 1 })).toBe("telegram:-1001234");
+    });
+});
+describe("buildReplyContext", () => {
+    it("builds reply context for a private message", () => {
+        const ctx = buildReplyContext({
+            chat: { id: 12345, type: "private" },
+            message_id: 42,
+        });
+        expect(ctx).toEqual({
+            chatId: 12345,
+            messageId: 42,
+        });
+    });
+    it("builds reply context for a group message", () => {
+        const ctx = buildReplyContext({
+            chat: { id: -100999, type: "group" },
+            message_id: 99,
+        });
+        expect(ctx).toEqual({
+            chatId: -100999,
+            messageId: 99,
+        });
+    });
+});
+describe("isOldTelegramMessage", () => {
+    it("returns true for messages before boot time", () => {
+        const bootTime = 1700000000000; // ms
+        const msgDate = 1699999990; // seconds — before boot
+        expect(isOldTelegramMessage(msgDate, bootTime)).toBe(true);
+    });
+    it("returns false for messages after boot time", () => {
+        const bootTime = 1700000000000;
+        const msgDate = 1700000010; // seconds — after boot
+        expect(isOldTelegramMessage(msgDate, bootTime)).toBe(false);
+    });
+    it("returns false for undefined date", () => {
+        expect(isOldTelegramMessage(undefined, Date.now())).toBe(false);
+    });
+});
+//# sourceMappingURL=threads.test.js.map

package/dist/src/connectors/telegram/__tests__/threads.test.js.map

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

package/dist/src/connectors/telegram/format.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Convert standard markdown to Telegram Markdown format.
+ * Handles headings, bold, italic, strikethrough, links, and bullet lists.
+ * Preserves code blocks and inline code untouched.
+ */
+export declare function markdownToTelegram(text: string): string;
+/**
+ * Split text into chunks that fit within Telegram's message length limit (4096 chars).
+ * Converts markdown to Telegram format before chunking.
+ */
+export declare function formatResponse(text: string): string[];
+//# sourceMappingURL=format.d.ts.map

package/dist/src/connectors/telegram/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/format.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2BvD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BrD"}

package/dist/src/connectors/telegram/format.js

@@ -0,0 +1,61 @@
+const TELEGRAM_MAX_LENGTH = 4096;
+/**
+ * Convert standard markdown to Telegram Markdown format.
+ * Handles headings, bold, italic, strikethrough, links, and bullet lists.
+ * Preserves code blocks and inline code untouched.
+ */
+export function markdownToTelegram(text) {
+    // Split text into code and non-code segments to protect code from conversion
+    const segments = text.split(/(```[\s\S]*?```|`[^`]+`)/g);
+    return segments
+        .map((segment, i) => {
+        // Odd indices are code matches — leave them untouched
+        if (i % 2 === 1)
+            return segment;
+        return (segment
+            // Headings: ## text → bold (placeholder to avoid italic capture)
+            .replace(/^(#{1,6})\s+(.+)$/gm, (_match, _hashes, content) => `\x00BOLD${content}\x00BOLD`)
+            // Bold: **text** or __text__ → placeholder
+            .replace(/\*\*(.+?)\*\*/g, "\x00BOLD$1\x00BOLD")
+            .replace(/__(.+?)__/g, "\x00BOLD$1\x00BOLD")
+            // Italic: *text* → _text_ (after bold is extracted)
+            .replace(/\*(.+?)\*/g, "_$1_")
+            // Restore bold markers → *text*
+            .replace(/\x00BOLD(.+?)\x00BOLD/g, "*$1*")
+            // Strikethrough: ~~text~~ → ~text~
+            .replace(/~~(.+?)~~/g, "~$1~")
+            // Bullet lists: - item or * item → • item
+            .replace(/^(\s*)[-*]\s+/gm, "$1• "));
+    })
+        .join("");
+}
+/**
+ * Split text into chunks that fit within Telegram's message length limit (4096 chars).
+ * Converts markdown to Telegram format before chunking.
+ */
+export function formatResponse(text) {
+    const converted = markdownToTelegram(text);
+    if (converted.length <= TELEGRAM_MAX_LENGTH) {
+        return [converted];
+    }
+    const chunks = [];
+    let remaining = converted;
+    while (remaining.length > 0) {
+        if (remaining.length <= TELEGRAM_MAX_LENGTH) {
+            chunks.push(remaining);
+            break;
+        }
+        // Try to split at a newline boundary within the limit
+        let splitIndex = remaining.lastIndexOf("\n", TELEGRAM_MAX_LENGTH);
+        if (splitIndex <= 0) {
+            splitIndex = remaining.lastIndexOf(" ", TELEGRAM_MAX_LENGTH);
+        }
+        if (splitIndex <= 0) {
+            splitIndex = TELEGRAM_MAX_LENGTH;
+        }
+        chunks.push(remaining.slice(0, splitIndex));
+        remaining = remaining.slice(splitIndex).trimStart();
+    }
+    return chunks;
+}
+//# sourceMappingURL=format.js.map

package/dist/src/connectors/telegram/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../../src/connectors/telegram/format.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAEjC;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAEzD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;QAClB,sDAAsD;QACtD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QAEhC,OAAO,CACL,OAAO;YACL,iEAAiE;aAChE,OAAO,CAAC,qBAAqB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,OAAO,UAAU,CAAC;YAC3F,2CAA2C;aAC1C,OAAO,CAAC,gBAAgB,EAAE,oBAAoB,CAAC;aAC/C,OAAO,CAAC,YAAY,EAAE,oBAAoB,CAAC;YAC5C,oDAAoD;aACnD,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;YAC9B,gCAAgC;aAC/B,OAAO,CAAC,wBAAwB,EAAE,MAAM,CAAC;YAC1C,mCAAmC;aAClC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;YAC9B,0CAA0C;aACzC,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC,CACtC,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAE3C,IAAI,SAAS,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAC5C,OAAO,CAAC,SAAS,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,SAAS,CAAC;IAE1B,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,IAAI,SAAS,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;YAC5C,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvB,MAAM;QACR,CAAC;QAED,sDAAsD;QACtD,IAAI,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;QAClE,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACpB,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;YACpB,UAAU,GAAG,mBAAmB,CAAC;QACnC,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QAC5C,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,SAAS,EAAE,CAAC;IACtD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/connectors/telegram/index.d.ts

@@ -0,0 +1,26 @@
+import type { Connector, ConnectorCapabilities, ConnectorHealth, IncomingMessage, ReplyContext, Target, TelegramConnectorConfig } from "../../shared/types.js";
+export declare class TelegramConnector implements Connector {
+    name: string;
+    private bot;
+    private handler;
+    private readonly allowedUsers;
+    private readonly ignoreOldMessagesOnBoot;
+    private readonly bootTimeMs;
+    private started;
+    private lastError;
+    private readonly capabilities;
+    constructor(config: TelegramConnectorConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getCapabilities(): ConnectorCapabilities;
+    getHealth(): ConnectorHealth;
+    reconstructTarget(replyContext: ReplyContext): Target;
+    private safeSend;
+    sendMessage(target: Target, text: string): Promise<string | undefined>;
+    replyMessage(target: Target, text: string): Promise<string | undefined>;
+    addReaction(_target: Target, _emoji: string): Promise<void>;
+    removeReaction(_target: Target, _emoji: string): Promise<void>;
+    editMessage(target: Target, text: string): Promise<void>;
+    onMessage(handler: (msg: IncomingMessage) => void): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/connectors/telegram/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connectors/telegram/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,MAAM,EACN,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAK/B,qBAAa,iBAAkB,YAAW,SAAS;IACjD,IAAI,SAAc;IAClB,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,OAAO,CAAiD;IAChE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAU;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAuB;IAExC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAK3B;gBAEU,MAAM,EAAE,uBAAuB;IASrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,eAAe,IAAI,qBAAqB;IAIxC,SAAS,IAAI,eAAe;IAQ5B,iBAAiB,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM;YAQvC,QAAQ;IAwBhB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAYtE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAoBvE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9D,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;CAGzD"}