pi-courier 0.1.0

package/dist/transports/matrix.js

@@ -0,0 +1,240 @@
+import { AutojoinRoomsMixin, LogService, MatrixClient, RichConsoleLogger, RustSdkCryptoStorageProvider, SimpleFsStorageProvider, } from "matrix-bot-sdk";
+import * as os from "os";
+import * as path from "path";
+import { extractUsername, formatForMatrix, shouldSkipEvent, stripBotMention, wasBotMentioned, } from "./matrix-utils.js";
+/**
+ * Matrix transport provider using matrix-bot-sdk
+ * Works with any Matrix homeserver — Element X, Element Web, FluffyChat, etc.
+ */
+export class MatrixProvider {
+    config;
+    auth;
+    type = "matrix";
+    client;
+    _isConnected = false;
+    messageHandler;
+    errorHandler;
+    botUserId;
+    joinedRooms = new Set();
+    roomMemberCount = new Map();
+    connectedAt = 0;
+    constructor(config, auth) {
+        this.config = config;
+        this.auth = auth;
+    }
+    get isConnected() {
+        return this._isConnected;
+    }
+    // Formatting delegated to matrix-utils.ts (pure, testable)
+    async connect() {
+        if (this._isConnected)
+            return;
+        const { homeserverUrl, accessToken } = this.config;
+        if (!homeserverUrl || !accessToken) {
+            throw new Error("Matrix homeserver URL and access token required");
+        }
+        const storagePath = path.join(os.homedir(), ".pi", "msg-bridge-matrix-store.json");
+        const storage = new SimpleFsStorageProvider(storagePath);
+        // Set up E2EE crypto storage if encryption is enabled.
+        // Uses @matrix-org/matrix-sdk-crypto-nodejs (native Rust, SQLite on disk).
+        // Crypto state persists across restarts — same device, same keys.
+        // The device must be verified once from another Matrix client (Element, etc).
+        let cryptoProvider;
+        if (this.config.encryption !== false) {
+            try {
+                const cryptoStorePath = path.join(os.homedir(), ".pi", "msg-bridge-matrix-crypto");
+                cryptoProvider = new RustSdkCryptoStorageProvider(cryptoStorePath, 0 /* RustSdkCryptoStoreType.Sqlite */);
+                console.log("[Matrix] E2EE crypto storage enabled (Rust/SQLite)");
+            }
+            catch (err) {
+                console.warn("[Matrix] E2EE crypto not available, continuing without encryption:", err.message);
+            }
+        }
+        this.client = new MatrixClient(homeserverUrl, accessToken, storage, cryptoProvider);
+        // Auto-join rooms the bot is invited to
+        AutojoinRoomsMixin.setupOnClient(this.client);
+        // Cache bot user ID (never changes)
+        this.botUserId = await this.client.getUserId();
+        // Track room membership and member counts
+        this.client.on("room.join", (roomId) => {
+            this.joinedRooms.add(roomId);
+            // Refresh member count asynchronously
+            this.client?.getJoinedRoomMembers(roomId)
+                .then(members => this.roomMemberCount.set(roomId, members.length))
+                .catch(() => { });
+        });
+        this.client.on("room.leave", (roomId) => {
+            this.joinedRooms.delete(roomId);
+            this.roomMemberCount.delete(roomId);
+        });
+        // Handle incoming messages
+        this.client.on("room.message", async (roomId, event) => {
+            try {
+                await this.handleMessage(roomId, event);
+            }
+            catch (err) {
+                if (this.errorHandler) {
+                    this.errorHandler(err);
+                }
+            }
+        });
+        try {
+            // During initial sync the SDK replays historical events and tries to
+            // decrypt them. For E2EE rooms this produces two known error patterns:
+            //   1. "Decryption error" — old messages we don't have keys for
+            //   2. "M_NOT_FOUND"     — stale sync token references a purged event
+            // Our connectedAt filter skips these events anyway, so the errors are
+            // noise. A filtering logger suppresses only these specific patterns.
+            const defaultLogger = new RichConsoleLogger();
+            const syncFilterLogger = {
+                info: (mod, ...args) => defaultLogger.info(mod, ...args),
+                warn: (mod, ...args) => defaultLogger.warn(mod, ...args),
+                debug: (mod, ...args) => defaultLogger.debug(mod, ...args),
+                trace: (mod, ...args) => defaultLogger.trace(mod, ...args),
+                error: (mod, ...args) => {
+                    const msg = args.map(a => typeof a === "string" ? a : JSON.stringify(a)).join(" ");
+                    if (mod === "MatrixClientLite" && msg.includes("Decryption error"))
+                        return;
+                    if (mod === "MatrixHttpClient" && msg.includes("M_NOT_FOUND"))
+                        return;
+                    defaultLogger.error(mod, ...args);
+                },
+            };
+            LogService.setLogger(syncFilterLogger);
+            await this.client.start();
+            // Restore default logging — real errors after sync should not be filtered
+            LogService.setLogger(defaultLogger);
+        }
+        catch (error) {
+            // Clean up dangling state so connect() can be retried
+            this.client = undefined;
+            this.botUserId = undefined;
+            this.joinedRooms.clear();
+            this.roomMemberCount.clear();
+            console.error("[Matrix] Failed to connect:", error);
+            throw error;
+        }
+        // Seed joined rooms and member count caches
+        const rooms = await this.client.getJoinedRooms();
+        this.joinedRooms = new Set(rooms);
+        await Promise.all(rooms.map(async (roomId) => {
+            try {
+                const members = await this.client.getJoinedRoomMembers(roomId);
+                this.roomMemberCount.set(roomId, members.length);
+            }
+            catch {
+                // Will be fetched on first message if needed
+            }
+        }));
+        this.connectedAt = Date.now();
+        this._isConnected = true;
+        const cryptoStatus = cryptoProvider ? "E2EE enabled" : "E2EE disabled";
+        console.log(`✅ Matrix connected as ${this.botUserId} (${rooms.length} rooms, ${cryptoStatus})`);
+    }
+    async disconnect() {
+        if (!this._isConnected || !this.client)
+            return;
+        this.client.stop();
+        this._isConnected = false;
+        this.client = undefined;
+        this.botUserId = undefined;
+        this.joinedRooms.clear();
+        this.roomMemberCount.clear();
+        this.connectedAt = 0;
+        console.log("[Matrix] Disconnected");
+    }
+    async sendMessage(chatId, text) {
+        if (!this.client) {
+            throw new Error("Matrix client not connected");
+        }
+        if (!text?.trim())
+            return;
+        const { body, formattedBody } = formatForMatrix(text);
+        await this.client.sendMessage(chatId, {
+            msgtype: "m.text",
+            body,
+            ...(formattedBody && {
+                format: "org.matrix.custom.html",
+                formatted_body: formattedBody,
+            }),
+        });
+    }
+    async sendTyping(chatId) {
+        if (!this.client)
+            return;
+        try {
+            await this.client.setTyping(chatId, true, 10000);
+        }
+        catch {
+            // Ignore typing indicator errors
+        }
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    onError(handler) {
+        this.errorHandler = handler;
+    }
+    async handleMessage(roomId, event) {
+        if (!this.client || !this.botUserId)
+            return;
+        // Pure filter — delegates to testable utility
+        const skipReason = shouldSkipEvent(event, this.botUserId, this.connectedAt, this.joinedRooms, roomId);
+        if (skipReason)
+            return;
+        const chatId = roomId;
+        const userId = event.sender; // e.g. @user:matrix.org
+        const username = extractUsername(userId);
+        const messageText = event.content.body;
+        const messageId = event.event_id;
+        // Determine if group chat from cached member count (no API call per message)
+        let memberCount = this.roomMemberCount.get(roomId);
+        if (memberCount === undefined) {
+            // Cache miss — fetch once and cache
+            try {
+                const members = await this.client.getJoinedRoomMembers(roomId);
+                memberCount = members.length;
+                this.roomMemberCount.set(roomId, memberCount);
+            }
+            catch {
+                memberCount = 2; // Default to DM if we can't check
+            }
+        }
+        const isGroupChat = memberCount > 2;
+        // Check if bot was mentioned (pure utility)
+        const wasMentioned = isGroupChat ? wasBotMentioned(messageText, this.botUserId) : false;
+        // Check authorization
+        const sendMessageToUser = async (cId, text) => {
+            await this.sendMessage(cId, text);
+        };
+        const isAuthorized = await this.auth.checkAuthorization(userId, chatId, username, isGroupChat, wasMentioned, sendMessageToUser, this.type);
+        // Handle challenge codes and commands in DMs
+        if (!isGroupChat && (messageText.startsWith("/") || messageText.match(/^\d{6}$/))) {
+            const handled = await this.auth.handleAdminCommand(messageText, chatId, userId, async (text) => await this.sendMessage(chatId, text), this.type);
+            if (handled)
+                return;
+        }
+        if (!isAuthorized)
+            return;
+        // Strip bot mention from message (pure utility)
+        const cleanContent = wasMentioned && this.botUserId
+            ? stripBotMention(messageText, this.botUserId)
+            : messageText;
+        // Forward to message handler
+        if (this.messageHandler && cleanContent) {
+            const externalMessage = {
+                chatId,
+                transport: this.type,
+                content: cleanContent,
+                username,
+                userId,
+                timestamp: new Date(event.origin_server_ts || Date.now()),
+                messageId,
+                isGroupChat,
+                wasMentioned,
+            };
+            this.messageHandler(externalMessage);
+        }
+    }
+}
+//# sourceMappingURL=matrix.js.map

package/dist/transports/matrix.js.map

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

package/dist/transports/slack.d.ts

@@ -0,0 +1,31 @@
+import type { ChallengeAuth } from "../auth/challenge-auth.js";
+import type { ExternalMessage } from "../types.js";
+import type { ITransportProvider } from "./interface.js";
+/**
+ * Slack transport provider using @slack/bolt
+ */
+export declare class SlackProvider implements ITransportProvider {
+    private config;
+    private auth;
+    readonly type = "slack";
+    private app;
+    private _isConnected;
+    private botUserId;
+    private messageHandler?;
+    private errorHandler?;
+    private lastProcessedMessageId;
+    private userCache;
+    private channelCache;
+    constructor(config: {
+        botToken: string;
+        appToken: string;
+    }, auth: ChallengeAuth);
+    get isConnected(): boolean;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    sendMessage(chatId: string, text: string): Promise<void>;
+    sendTyping(_chatId: string): Promise<void>;
+    onMessage(handler: (message: ExternalMessage) => void): void;
+    onError(handler: (error: Error) => void): void;
+}
+//# sourceMappingURL=slack.d.ts.map

package/dist/transports/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/transports/slack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAUzD;;GAEG;AACH,qBAAa,aAAc,YAAW,kBAAkB;IAepD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI;IAfd,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,GAAG,CAAoB;IAC/B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAqC;IAC5D,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,sBAAsB,CAAM;IAGpC,OAAO,CAAC,SAAS,CAAkC;IAEnD,OAAO,CAAC,YAAY,CAA4D;gBAGtE,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAC9C,IAAI,EAAE,aAAa;IAG7B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkKxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAI5D,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;CAG/C"}

package/dist/transports/slack.js

@@ -0,0 +1,203 @@
+async function loadSlackBolt() {
+    const slack = await import("@slack/bolt");
+    return slack;
+}
+/**
+ * Slack transport provider using @slack/bolt
+ */
+export class SlackProvider {
+    config;
+    auth;
+    type = "slack";
+    app = null;
+    _isConnected = false;
+    botUserId = "";
+    messageHandler;
+    errorHandler;
+    lastProcessedMessageId = "";
+    // Cache user info to avoid repeated API calls
+    userCache = new Map();
+    // Cache channel info to detect DMs vs channels
+    channelCache = new Map();
+    constructor(config, auth) {
+        this.config = config;
+        this.auth = auth;
+    }
+    get isConnected() {
+        return this._isConnected;
+    }
+    async connect() {
+        if (this._isConnected)
+            return;
+        const { botToken, appToken } = this.config;
+        if (!botToken || !appToken) {
+            throw new Error("Slack requires both botToken (xoxb-...) and appToken (xapp-...)");
+        }
+        const slack = await loadSlackBolt();
+        this.app = new slack.App({
+            token: botToken,
+            appToken: appToken,
+            socketMode: true,
+            logLevel: slack.LogLevel.WARN,
+        });
+        // Get bot's own user ID for mention detection
+        try {
+            const authResult = await this.app.client.auth.test();
+            this.botUserId = authResult.user_id || "";
+            console.log(`[Slack] Bot user ID: ${this.botUserId}`);
+        }
+        catch (e) {
+            console.warn("[Slack] Could not get bot info:", e);
+        }
+        // Listen for all messages
+        this.app.message(async ({ message, client }) => {
+            // Skip bot messages, message edits, deletes, etc.
+            if (message.subtype) {
+                return;
+            }
+            // TypeScript type guard for regular messages
+            if (!("user" in message) || !("text" in message) || !message.text) {
+                return;
+            }
+            const userId = message.user;
+            const channelId = message.channel;
+            const text = message.text;
+            const ts = message.ts;
+            // Filter out duplicate messages
+            if (ts === this.lastProcessedMessageId) {
+                return;
+            }
+            this.lastProcessedMessageId = ts;
+            // Get username from cache or fetch
+            let username = this.userCache.get(userId) || userId;
+            if (!this.userCache.has(userId)) {
+                try {
+                    const userInfo = await client.users.info({ user: userId });
+                    const fetchedName = userInfo.user?.real_name || userInfo.user?.name;
+                    if (fetchedName) {
+                        username = fetchedName;
+                        this.userCache.set(userId, username);
+                    }
+                }
+                catch {
+                    username = userId;
+                }
+            }
+            // Get channel info from cache or fetch (to detect DM vs channel)
+            let channelInfo = this.channelCache.get(channelId);
+            if (!channelInfo) {
+                try {
+                    const convInfo = await client.conversations.info({ channel: channelId });
+                    const conv = convInfo.channel;
+                    // is_im = direct message, is_mpim = multi-party DM
+                    const isDM = conv?.is_im === true || conv?.is_mpim === true;
+                    const name = conv?.name || (isDM ? "DM" : channelId);
+                    channelInfo = { isDM, name };
+                    this.channelCache.set(channelId, channelInfo);
+                }
+                catch {
+                    // Default to assuming it's a DM if we can't fetch info
+                    channelInfo = { isDM: true };
+                    this.channelCache.set(channelId, channelInfo);
+                }
+            }
+            // Detect bot mention: <@BOT_USER_ID>
+            const wasMentioned = this.botUserId
+                ? text.includes(`<@${this.botUserId}>`)
+                : false;
+            const isGroupChat = !channelInfo.isDM;
+            // Check authorization
+            const sendMessageToUser = async (cId, text) => {
+                if (this.app) {
+                    await this.app.client.chat.postMessage({
+                        channel: cId,
+                        text: text,
+                    });
+                }
+            };
+            const isAuthorized = await this.auth.checkAuthorization(userId, channelId, username, isGroupChat, wasMentioned, sendMessageToUser, this.type);
+            // Handle admin commands and challenge codes in DM
+            if (!isGroupChat && (text.startsWith("/") || text.match(/^\d{6}$/))) {
+                const handled = await this.auth.handleAdminCommand(text, channelId, userId, async (text) => await this.sendMessage(channelId, text), this.type);
+                if (handled) {
+                    return;
+                }
+            }
+            if (!isAuthorized) {
+                return; // Auth handler already sent challenge/error messages
+            }
+            // Forward to message handler
+            if (this.messageHandler) {
+                const externalMessage = {
+                    chatId: channelId,
+                    transport: this.type,
+                    content: text.trim(),
+                    username: username,
+                    userId: userId,
+                    timestamp: new Date(parseFloat(ts) * 1000),
+                    messageId: ts,
+                    isGroupChat,
+                    wasMentioned,
+                };
+                this.messageHandler(externalMessage);
+            }
+        });
+        // Handle errors
+        this.app.error(async (error) => {
+            console.error("[Slack] Error:", error);
+            if (this.errorHandler) {
+                this.errorHandler(new Error(String(error)));
+            }
+        });
+        try {
+            await this.app.start();
+            this._isConnected = true;
+        }
+        catch (error) {
+            throw new Error(`Slack connection failed: ${error.message}`);
+        }
+    }
+    async disconnect() {
+        if (this.app) {
+            try {
+                await this.app.stop();
+            }
+            catch {
+                // Ignore stop errors
+            }
+            this.app = null;
+        }
+        this._isConnected = false;
+        this.userCache.clear();
+        this.channelCache.clear();
+        console.log("[Slack] Disconnected");
+    }
+    async sendMessage(chatId, text) {
+        if (!this.app) {
+            throw new Error("Slack not connected");
+        }
+        if (!text?.trim())
+            return;
+        try {
+            await this.app.client.chat.postMessage({
+                channel: chatId,
+                text: text,
+            });
+        }
+        catch (error) {
+            throw new Error(`Slack send failed: ${error.message}`);
+        }
+    }
+    async sendTyping(_chatId) {
+        // Slack doesn't support typing indicators for bots
+        // We could potentially add a reaction or use a "thinking" message
+        // but for now we'll just skip it
+    }
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    onError(handler) {
+        this.errorHandler = handler;
+    }
+}
+//# sourceMappingURL=slack.js.map

package/dist/transports/slack.js.map

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

package/dist/transports/telegram.d.ts

@@ -0,0 +1,38 @@
+import type { ChallengeAuth } from "../auth/challenge-auth.js";
+import type { ExternalMessage } from "../types.js";
+import type { ITransportProvider } from "./interface.js";
+/**
+ * Telegram transport provider using node-telegram-bot-api
+ */
+export declare class TelegramProvider implements ITransportProvider {
+    private token;
+    private auth;
+    readonly type = "telegram";
+    private bot?;
+    private _isConnected;
+    private messageHandler?;
+    private errorHandler?;
+    private lastProcessedMessageId;
+    constructor(token: string, auth: ChallengeAuth);
+    get isConnected(): boolean;
+    /**
+     * Convert standard markdown to Telegram MarkdownV1 format.
+     *
+     * Telegram MarkdownV1 syntax: *bold*, _italic_, `code`, ```pre```, [text](url).
+     * Per docs, only `_ * [ \`` need backslash-escaping when literal — otherwise
+     * a stray `_` (e.g. in a snake_case tool name like `hud_canvas`) is parsed
+     * as an opening italic marker with no close, returning HTTP 400.
+     *
+     * Strategy: lift valid markdown patterns into NUL-sentinel placeholders,
+     * escape the remaining specials, then restore the placeholders.
+     */
+    private formatForTelegram;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    sendMessage(chatId: string, text: string): Promise<void>;
+    sendTyping(chatId: string): Promise<void>;
+    onMessage(handler: (message: ExternalMessage) => void): void;
+    onError(handler: (error: Error) => void): void;
+    private handleMessage;
+}
+//# sourceMappingURL=telegram.d.ts.map

package/dist/transports/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/transports/telegram.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;GAEG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IASvD,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,IAAI;IATd,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,GAAG,CAAC,CAAc;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAC,CAAqC;IAC5D,OAAO,CAAC,YAAY,CAAC,CAAyB;IAC9C,OAAO,CAAC,sBAAsB,CAAK;gBAGzB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,aAAa;IAG7B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iBAAiB;IAiBnB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASxD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAI5D,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,IAAI;YAIhC,aAAa;CA4F5B"}