daemora 1.0.0-alpha.0

package/dist/channels/EmailChannel.js

@@ -0,0 +1,226 @@
+/**
+ * EmailChannel — IMAP inbound + SMTP outbound email bot.
+ *
+ * Receive path:
+ *   • imapflow polls an IMAP folder (default INBOX) every `pollInterval`
+ *     ms looking for UNSEEN messages.
+ *   • For each message we fetch the envelope (parsed headers) and the
+ *     text body, build an IncomingMessage, and hand it to the channel
+ *     manager's onMessage callback. No external MIME parser needed —
+ *     imapflow does the heavy lifting.
+ *
+ * Send path:
+ *   • Resend SMTP relay if RESEND_API_KEY is configured, otherwise a
+ *     standard nodemailer transport against the IMAP account's SMTP
+ *     server (Gmail by default).
+ *
+ * This matches the JS EmailChannel capability surface (inbound polling
+ * + outbound via Resend or SMTP) with the modern imapflow API and
+ * async/await all the way through.
+ */
+import { BaseChannel } from "./BaseChannel.js";
+import { createLogger } from "../util/logger.js";
+const log = createLogger("channel.email");
+export class EmailChannel extends BaseChannel {
+    id = "email";
+    name = "Email";
+    supportsFiles = true;
+    opts;
+    pollTimer = null;
+    transport = null;
+    fromAddress = null;
+    polling = false;
+    constructor(opts) {
+        super();
+        this.opts = {
+            onMessage: opts.onMessage,
+            user: opts.user,
+            password: opts.password,
+            imapHost: opts.imapHost ?? "imap.gmail.com",
+            imapPort: opts.imapPort ?? 993,
+            smtpHost: opts.smtpHost ?? "smtp.gmail.com",
+            smtpPort: opts.smtpPort ?? 465,
+            mailbox: opts.mailbox ?? "INBOX",
+            pollInterval: opts.pollInterval ?? 60_000,
+            resendApiKey: opts.resendApiKey,
+            resendFrom: opts.resendFrom,
+            allowedSenders: new Set((opts.allowedSenders ?? []).map((a) => a.toLowerCase())),
+        };
+    }
+    // ── Lifecycle ───────────────────────────────────────────────────
+    async start() {
+        const nodemailerMod = await import("nodemailer");
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const nodemailer = nodemailerMod.default ?? nodemailerMod;
+        if (this.opts.resendApiKey) {
+            this.transport = nodemailer.createTransport({
+                host: "smtp.resend.com",
+                port: 465,
+                secure: true,
+                auth: { user: "resend", pass: this.opts.resendApiKey },
+            });
+            this.fromAddress = this.opts.resendFrom ?? "daemora@resend.dev";
+            log.info({ from: this.fromAddress }, "email outbound: resend");
+        }
+        else {
+            this.transport = nodemailer.createTransport({
+                host: this.opts.smtpHost,
+                port: this.opts.smtpPort,
+                secure: this.opts.smtpPort === 465,
+                auth: { user: this.opts.user, pass: this.opts.password },
+            });
+            this.fromAddress = this.opts.user;
+            log.info({ host: this.opts.smtpHost, from: this.fromAddress }, "email outbound: smtp");
+        }
+        // Inbound polling starts immediately and repeats every pollInterval.
+        this.polling = true;
+        this.pollTimer = setInterval(() => void this.pollInbox(), this.opts.pollInterval);
+        void this.pollInbox();
+        log.info({ host: this.opts.imapHost, mailbox: this.opts.mailbox, intervalMs: this.opts.pollInterval }, "email inbound: IMAP polling started");
+    }
+    async stop() {
+        this.polling = false;
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        this.transport?.close();
+        this.transport = null;
+        log.info("email channel stopped");
+    }
+    // ── Outbound ────────────────────────────────────────────────────
+    async sendReply(meta, text) {
+        if (!this.transport || !this.fromAddress) {
+            throw new Error("Email transport not initialised");
+        }
+        const to = meta.senderEmail ?? meta.to ?? meta.email;
+        if (!to)
+            throw new Error("Email reply needs senderEmail / to / email in channelMeta");
+        const subject = meta.subject ?? "(no subject)";
+        await this.transport.sendMail({
+            from: this.fromAddress,
+            to,
+            subject: subject.startsWith("Re:") ? subject : `Re: ${subject}`,
+            text,
+        });
+        log.info({ to }, "email reply sent");
+    }
+    async sendFile(meta, filePath, caption) {
+        if (!this.transport || !this.fromAddress) {
+            throw new Error("Email transport not initialised");
+        }
+        const to = meta.senderEmail ?? meta.to ?? meta.email;
+        if (!to)
+            throw new Error("Email file send needs senderEmail / to / email in channelMeta");
+        const subject = meta.subject ?? "File from Daemora";
+        await this.transport.sendMail({
+            from: this.fromAddress,
+            to,
+            subject,
+            text: caption ?? "",
+            // nodemailer supports attachments via the same sendMail call;
+            // we extend the call site rather than the typed interface.
+            ...{ attachments: [{ path: filePath }] },
+        });
+    }
+    isAllowed(userId) {
+        if (this.opts.allowedSenders.size === 0)
+            return true;
+        return this.opts.allowedSenders.has(userId.toLowerCase());
+    }
+    // ── Inbound polling ──────────────────────────────────────────────
+    async pollInbox() {
+        if (!this.polling)
+            return;
+        const { ImapFlow } = await import("imapflow");
+        const client = new ImapFlow({
+            host: this.opts.imapHost,
+            port: this.opts.imapPort,
+            secure: true,
+            auth: { user: this.opts.user, pass: this.opts.password },
+            logger: false,
+        });
+        try {
+            await client.connect();
+            await client.mailboxOpen(this.opts.mailbox);
+            const uids = await client.search({ seen: false });
+            if (!uids || uids.length === 0) {
+                await client.logout();
+                return;
+            }
+            log.info({ count: uids.length }, "email: unseen messages");
+            for await (const msg of client.fetch(uids, {
+                envelope: true,
+                source: true,
+                uid: true,
+            })) {
+                const fromAddr = msg.envelope?.from?.[0]?.address?.toLowerCase() ?? "";
+                if (fromAddr && !this.isAllowed(fromAddr)) {
+                    log.debug({ from: fromAddr }, "email: sender not in allowlist, skipping");
+                    continue;
+                }
+                const subject = msg.envelope?.subject ?? "(no subject)";
+                const messageId = msg.envelope?.messageId ?? String(msg.uid);
+                const body = msg.source ? extractPlainBody(msg.source.toString("utf-8")) : "";
+                const incoming = {
+                    channel: this.id,
+                    userId: fromAddr || "unknown",
+                    text: `Email from ${fromAddr || "unknown"}\nSubject: ${subject}\n\n${body.slice(0, 5000)}`,
+                    meta: {
+                        channel: this.id,
+                        userId: fromAddr,
+                        chatId: fromAddr,
+                        messageId,
+                        senderEmail: fromAddr,
+                        email: fromAddr,
+                        subject,
+                        uid: msg.uid,
+                    },
+                    timestamp: msg.envelope?.date?.getTime() ?? Date.now(),
+                };
+                try {
+                    this.opts.onMessage(incoming);
+                }
+                catch (e) {
+                    log.error({ err: e.message }, "email onMessage handler failed");
+                }
+            }
+            await client.messageFlagsAdd(uids, ["\\Seen"]);
+            await client.mailboxClose();
+            await client.logout();
+        }
+        catch (e) {
+            log.error({ err: e.message }, "email poll error");
+            try {
+                await client.logout();
+            }
+            catch { /* ignore */ }
+        }
+    }
+}
+/**
+ * Minimal MIME-ish body extractor: strips headers (everything up to
+ * the first blank line), pulls the text/plain part out of a simple
+ * multipart envelope if present, and leaves the decoded text alone.
+ * Not a full parser — covers the 90% case we see from real inboxes.
+ */
+function extractPlainBody(raw) {
+    const headersEnd = raw.indexOf("\r\n\r\n");
+    const afterHeaders = headersEnd >= 0 ? raw.slice(headersEnd + 4) : raw;
+    // Handle the common multipart/alternative layout.
+    const boundaryMatch = raw.match(/boundary="?([^";\r\n]+)"?/i);
+    if (boundaryMatch?.[1]) {
+        const boundary = `--${boundaryMatch[1]}`;
+        const parts = afterHeaders.split(boundary);
+        for (const part of parts) {
+            if (/content-type:\s*text\/plain/i.test(part)) {
+                const bodyStart = part.indexOf("\r\n\r\n");
+                if (bodyStart >= 0) {
+                    return part.slice(bodyStart + 4).trim();
+                }
+            }
+        }
+    }
+    return afterHeaders.trim();
+}
+//# sourceMappingURL=EmailChannel.js.map

package/dist/channels/EmailChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailChannel.js","sourceRoot":"","sources":["../../src/channels/EmailChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAA0C,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AA2D1C,MAAM,OAAO,YAAa,SAAQ,WAAW;IAClC,EAAE,GAAG,OAAgB,CAAC;IACtB,IAAI,GAAG,OAAgB,CAAC;IACf,aAAa,GAAG,IAAI,CAAC;IAEtB,IAAI,CAInB;IAEM,SAAS,GAA0C,IAAI,CAAC;IACxD,SAAS,GAA+B,IAAI,CAAC;IAC7C,WAAW,GAAkB,IAAI,CAAC;IAClC,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,IAAsB;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,IAAI,GAAG;YACV,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,gBAAgB;YAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,GAAG;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,gBAAgB;YAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,GAAG;YAC9B,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO;YAChC,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,MAAM;YACzC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,cAAc,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;SACjF,CAAC;IACJ,CAAC;IAED,mEAAmE;IAEnE,KAAK,CAAC,KAAK;QACT,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACjD,8DAA8D;QAC9D,MAAM,UAAU,GAAI,aAAqB,CAAC,OAAO,IAAI,aAAa,CAAC;QAEnE,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC;gBAC1C,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,GAAG;gBACT,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;aACvD,CAAwB,CAAC;YAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,oBAAoB,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,wBAAwB,CAAC,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC;gBAC1C,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;gBACxB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;gBACxB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,GAAG;gBAClC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;aACzD,CAAwB,CAAC;YAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAClC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,sBAAsB,CAAC,CAAC;QACzF,CAAC;QAED,qEAAqE;QACrE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAClF,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;QACtB,GAAG,CAAC,IAAI,CACN,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAC5F,qCAAqC,CACtC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,CAAC;IAED,mEAAmE;IAE1D,KAAK,CAAC,SAAS,CAAC,IAAiB,EAAE,IAAY;QACtD,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,EAAE,GAAI,IAAI,CAAC,WAAkC,IAAK,IAAI,CAAC,EAAyB,IAAK,IAAI,CAAC,KAA4B,CAAC;QAC7H,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QACtF,MAAM,OAAO,GAAI,IAAI,CAAC,OAA8B,IAAI,cAAc,CAAC;QACvE,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YAC5B,IAAI,EAAE,IAAI,CAAC,WAAW;YACtB,EAAE;YACF,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,EAAE;YAC/D,IAAI;SACL,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,kBAAkB,CAAC,CAAC;IACvC,CAAC;IAEQ,KAAK,CAAC,QAAQ,CAAC,IAAiB,EAAE,QAAgB,EAAE,OAAgB;QAC3E,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,MAAM,EAAE,GAAI,IAAI,CAAC,WAAkC,IAAK,IAAI,CAAC,EAAyB,IAAK,IAAI,CAAC,KAA4B,CAAC;QAC7H,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAC1F,MAAM,OAAO,GAAI,IAAI,CAAC,OAA8B,IAAI,mBAAmB,CAAC;QAC5E,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YAC5B,IAAI,EAAE,IAAI,CAAC,WAAW;YACtB,EAAE;YACF,OAAO;YACP,IAAI,EAAE,OAAO,IAAI,EAAE;YACnB,8DAA8D;YAC9D,2DAA2D;YAC3D,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE;SACiC,CAAC,CAAC;IAC/E,CAAC;IAEQ,SAAS,CAAC,MAAc;QAC/B,IAAI,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACrD,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,oEAAoE;IAE5D,KAAK,CAAC,SAAS;QACrB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAE1B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC;YAC1B,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YACxB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ;YACxB,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YACxD,MAAM,EAAE,KAAK;SACd,CAA8B,CAAC;QAEhC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAE5C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;gBACtB,OAAO;YACT,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC;YAE3D,IAAI,KAAK,EAAE,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE;gBACzC,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,IAAI;gBACZ,GAAG,EAAE,IAAI;aACV,CAAC,EAAE,CAAC;gBACH,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;gBACvE,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC1C,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,0CAA0C,CAAC,CAAC;oBAC1E,SAAS;gBACX,CAAC;gBAED,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,EAAE,OAAO,IAAI,cAAc,CAAC;gBACxD,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,EAAE,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC7D,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBAE9E,MAAM,QAAQ,GAAoB;oBAChC,OAAO,EAAE,IAAI,CAAC,EAAE;oBAChB,MAAM,EAAE,QAAQ,IAAI,SAAS;oBAC7B,IAAI,EAAE,cAAc,QAAQ,IAAI,SAAS,cAAc,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE;oBAC1F,IAAI,EAAE;wBACJ,OAAO,EAAE,IAAI,CAAC,EAAE;wBAChB,MAAM,EAAE,QAAQ;wBAChB,MAAM,EAAE,QAAQ;wBAChB,SAAS;wBACT,WAAW,EAAE,QAAQ;wBACrB,KAAK,EAAE,QAAQ;wBACf,OAAO;wBACP,GAAG,EAAE,GAAG,CAAC,GAAG;qBACb;oBACD,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE;iBACvD,CAAC;gBAEF,IAAI,CAAC;oBACH,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAChC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAG,CAAW,CAAC,OAAO,EAAE,EAAE,gCAAgC,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC;YAED,MAAM,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/C,MAAM,MAAM,CAAC,YAAY,EAAE,CAAC;YAC5B,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAG,CAAW,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,CAAC;YAC7D,IAAI,CAAC;gBAAC,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAEvE,kDAAkD;IAClD,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC9D,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,KAAK,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;gBAC3C,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;oBACnB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC1C,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,CAAC;AAC7B,CAAC"}

package/dist/channels/FeishuChannel.d.ts

@@ -0,0 +1,40 @@
+/**
+ * FeishuChannel — Feishu / Lark webhook bot.
+ *
+ * Inbound: webhook, URL verification challenge handshake on first setup.
+ * Outbound: POST /open-apis/im/v1/messages. Supports PATCH for edit.
+ * Auth: OAuth2 tenant access token, cached until just before expiry.
+ *
+ * Streaming strategy: edit-in-place. Feishu lets us PATCH a message by
+ * its id, so the base streaming loop works — we just need the id back
+ * from the first send.
+ */
+import { BaseChannel, type ChannelMeta, type IncomingMessage, type WebhookRequest, type WebhookResponse } from "./BaseChannel.js";
+export interface FeishuChannelOpts {
+    readonly appId: string;
+    readonly appSecret: string;
+    /** Optional — only needed when Feishu sends signed encrypted events. */
+    readonly verificationToken?: string;
+    readonly onMessage: (msg: IncomingMessage) => void;
+}
+export declare class FeishuChannel extends BaseChannel {
+    readonly id: "feishu";
+    readonly name: "Feishu";
+    readonly supportsStreaming = true;
+    readonly maxMessageLength = 3500;
+    private readonly appId;
+    private readonly appSecret;
+    private readonly verificationToken;
+    private readonly onMessage;
+    private token;
+    private tokenExpiresAt;
+    constructor(opts: FeishuChannelOpts);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    webhookPath(): string;
+    handleWebhook(req: WebhookRequest, res: WebhookResponse, _rawBody: string | null): Promise<void>;
+    sendReply(meta: ChannelMeta, text: string): Promise<void>;
+    sendOrEditStream(meta: ChannelMeta, text: string, prevMessageId: string | null): Promise<string | null>;
+    private getAccessToken;
+}
+//# sourceMappingURL=FeishuChannel.d.ts.map

package/dist/channels/FeishuChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeishuChannel.d.ts","sourceRoot":"","sources":["../../src/channels/FeishuChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AA8B1B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD;AAED,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,SAAkB,iBAAiB,QAAQ;IAC3C,SAAkB,gBAAgB,QAAQ;IAE1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAqB;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,cAAc,CAAK;gBAEf,IAAI,EAAE,iBAAiB;IAQ7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAElB,WAAW,IAAI,MAAM;IAIf,aAAa,CAC1B,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,IAAI,CAAC;IAmDD,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBzD,gBAAgB,CAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAuCX,cAAc;CAwB7B"}

package/dist/channels/FeishuChannel.js

@@ -0,0 +1,169 @@
+/**
+ * FeishuChannel — Feishu / Lark webhook bot.
+ *
+ * Inbound: webhook, URL verification challenge handshake on first setup.
+ * Outbound: POST /open-apis/im/v1/messages. Supports PATCH for edit.
+ * Auth: OAuth2 tenant access token, cached until just before expiry.
+ *
+ * Streaming strategy: edit-in-place. Feishu lets us PATCH a message by
+ * its id, so the base streaming loop works — we just need the id back
+ * from the first send.
+ */
+import { createLogger } from "../util/logger.js";
+import { BaseChannel, } from "./BaseChannel.js";
+const log = createLogger("channel.feishu");
+const FEISHU_API = "https://open.feishu.cn/open-apis";
+export class FeishuChannel extends BaseChannel {
+    id = "feishu";
+    name = "Feishu";
+    supportsStreaming = true;
+    maxMessageLength = 3500;
+    appId;
+    appSecret;
+    verificationToken;
+    onMessage;
+    token = null;
+    tokenExpiresAt = 0;
+    constructor(opts) {
+        super();
+        this.appId = opts.appId;
+        this.appSecret = opts.appSecret;
+        this.verificationToken = opts.verificationToken;
+        this.onMessage = opts.onMessage;
+    }
+    async start() {
+        await this.getAccessToken();
+        log.info("feishu channel ready (webhook)");
+    }
+    async stop() { }
+    webhookPath() {
+        return "feishu";
+    }
+    async handleWebhook(req, res, _rawBody) {
+        const body = (req.body ?? {});
+        if (body.type === "url_verification" && body.challenge) {
+            res.status(200).json({ challenge: body.challenge });
+            return;
+        }
+        if (this.verificationToken) {
+            const token = body.token;
+            if (token && token !== this.verificationToken) {
+                res.status(403).end();
+                return;
+            }
+        }
+        res.status(200).json({ code: 0 });
+        const eventType = body.header?.event_type;
+        if (eventType !== "im.message.receive_v1")
+            return;
+        const ev = body.event;
+        const msg = ev?.message;
+        if (!msg || msg.message_type !== "text")
+            return;
+        const senderId = ev?.sender?.sender_id?.open_id;
+        if (!senderId)
+            return;
+        let text = "";
+        try {
+            const parsed = JSON.parse(msg.content);
+            text = (parsed.text ?? "").trim();
+        }
+        catch {
+            return;
+        }
+        if (!text)
+            return;
+        const incoming = {
+            channel: this.id,
+            userId: senderId,
+            text,
+            meta: {
+                channel: this.id,
+                userId: senderId,
+                chatId: msg.chat_id,
+                messageId: msg.message_id,
+            },
+            timestamp: msg.create_time ? Number(msg.create_time) : Date.now(),
+        };
+        this.onMessage(incoming);
+    }
+    async sendReply(meta, text) {
+        const chatId = meta.chatId ?? "";
+        if (!chatId)
+            return;
+        const token = await this.getAccessToken();
+        if (!token)
+            return;
+        await fetch(`${FEISHU_API}/im/v1/messages?receive_id_type=chat_id`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                receive_id: chatId,
+                msg_type: "text",
+                content: JSON.stringify({ text }),
+            }),
+        });
+    }
+    async sendOrEditStream(meta, text, prevMessageId) {
+        const token = await this.getAccessToken();
+        if (!token)
+            return null;
+        if (prevMessageId) {
+            await fetch(`${FEISHU_API}/im/v1/messages/${prevMessageId}`, {
+                method: "PATCH",
+                headers: {
+                    Authorization: `Bearer ${token}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({ content: JSON.stringify({ text }) }),
+            });
+            return prevMessageId;
+        }
+        const chatId = meta.chatId ?? "";
+        if (!chatId)
+            return null;
+        const resp = await fetch(`${FEISHU_API}/im/v1/messages?receive_id_type=chat_id`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                receive_id: chatId,
+                msg_type: "text",
+                content: JSON.stringify({ text }),
+            }),
+        });
+        if (!resp.ok)
+            return null;
+        const json = (await resp.json());
+        return json.data?.message_id ?? null;
+    }
+    async getAccessToken() {
+        if (this.token && Date.now() < this.tokenExpiresAt - 60_000)
+            return this.token;
+        try {
+            const resp = await fetch(`${FEISHU_API}/auth/v3/tenant_access_token/internal`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ app_id: this.appId, app_secret: this.appSecret }),
+            });
+            const json = (await resp.json());
+            if (json.code !== 0 || !json.tenant_access_token) {
+                log.error({ code: json.code, msg: json.msg }, "feishu token fetch failed");
+                return null;
+            }
+            this.token = json.tenant_access_token;
+            this.tokenExpiresAt = Date.now() + (json.expire ?? 7200) * 1000;
+            return this.token;
+        }
+        catch (err) {
+            log.error({ err: err.message }, "feishu token fetch failed");
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=FeishuChannel.js.map

package/dist/channels/FeishuChannel.js.map

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

package/dist/channels/GoogleChatChannel.d.ts

@@ -0,0 +1,46 @@
+/**
+ * GoogleChatChannel — Google Chat webhook bot.
+ *
+ * Inbound: sync webhook, respond within 30s. Async follow-ups allowed
+ * via chat.googleapis.com/v1/{space}/messages.
+ * Auth: service-account JWT → OAuth2 access token, cached.
+ *
+ * Streaming strategy: edit-in-place via PATCH once the first message
+ * name is known. The webhook handler responds immediately with an
+ * empty ack; all content flows through push endpoints so streaming
+ * edits work the same as a normal send loop.
+ *
+ * Implementation note: this builds the service-account JWT manually
+ * (crypto.createSign) so there's no google-auth-library dependency.
+ */
+import { BaseChannel, type ChannelMeta, type IncomingMessage, type WebhookRequest, type WebhookResponse } from "./BaseChannel.js";
+interface ServiceAccountKey {
+    client_email: string;
+    private_key: string;
+    token_uri?: string;
+}
+export interface GoogleChatChannelOpts {
+    /** The JSON object (not string) for the service account key. */
+    readonly serviceAccount: ServiceAccountKey;
+    readonly onMessage: (msg: IncomingMessage) => void;
+}
+export declare class GoogleChatChannel extends BaseChannel {
+    readonly id: "googlechat";
+    readonly name: "Google Chat";
+    readonly supportsStreaming = true;
+    readonly maxMessageLength = 4000;
+    private readonly key;
+    private readonly onMessage;
+    private accessToken;
+    private tokenExpiresAt;
+    constructor(opts: GoogleChatChannelOpts);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    webhookPath(): string;
+    handleWebhook(req: WebhookRequest, res: WebhookResponse, _rawBody: string | null): Promise<void>;
+    sendReply(meta: ChannelMeta, text: string): Promise<void>;
+    sendOrEditStream(meta: ChannelMeta, text: string, prevMessageId: string | null): Promise<string | null>;
+    private getAccessToken;
+}
+export {};
+//# sourceMappingURL=GoogleChatChannel.d.ts.map

package/dist/channels/GoogleChatChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleChatChannel.d.ts","sourceRoot":"","sources":["../../src/channels/GoogleChatChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAQ1B,UAAU,iBAAiB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAaD,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD;AAED,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,QAAQ,CAAC,EAAE,EAAG,YAAY,CAAU;IACpC,QAAQ,CAAC,IAAI,EAAG,aAAa,CAAU;IACvC,SAAkB,iBAAiB,QAAQ;IAC3C,SAAkB,gBAAgB,QAAQ;IAE1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAoB;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,cAAc,CAAK;gBAEf,IAAI,EAAE,qBAAqB;IAMjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAElB,WAAW,IAAI,MAAM;IAIf,aAAa,CAC1B,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,IAAI,CAAC;IAgCD,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBzD,gBAAgB,CAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAyCX,cAAc;CAqC7B"}