daemora 1.0.0-alpha.0

package/dist/channels/TelegramChannel.js

@@ -0,0 +1,469 @@
+/**
+ * TelegramChannel — Telegram Bot API integration.
+ *
+ * Uses raw fetch against the Bot API — no external packages.
+ * Supports both long-polling (getUpdates) and webhook modes.
+ * Handles text, voice, audio, photo, video, and document updates. Voice
+ * and audio are downloaded and transcribed via Whisper so the agent
+ * receives usable text; media files are saved to a temp dir and their
+ * paths are embedded so the agent can read / analyse them with its
+ * normal tools.
+ */
+import { createWriteStream, readFileSync } from "node:fs";
+import { mkdir } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { basename, extname, join } from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { createLogger } from "../util/logger.js";
+import { transcribeAudioFile } from "../voice/transcribe.js";
+import { BaseChannel } from "./BaseChannel.js";
+const log = createLogger("channel.telegram");
+const API_BASE = "https://api.telegram.org/bot";
+// ── Markdown escaping ─────────────────────────────────────────────
+const MD_V2_SPECIAL = /[_*[\]()~`>#+\-=|{}.!\\]/g;
+function escapeMarkdownV2(text) {
+    return text.replace(MD_V2_SPECIAL, "\\$&");
+}
+/**
+ * Light formatting for Telegram MarkdownV2.
+ * Escapes special chars but preserves simple bold/italic/code blocks
+ * that are already correctly formed.
+ */
+function formatForTelegram(text) {
+    // If text has no markdown, just escape it
+    if (!/[*_`]/.test(text))
+        return escapeMarkdownV2(text);
+    // Preserve code blocks, escape the rest
+    const parts = [];
+    let remaining = text;
+    // Handle triple-backtick code blocks
+    const codeBlockRe = /```([\s\S]*?)```/g;
+    let lastIdx = 0;
+    let match;
+    while ((match = codeBlockRe.exec(remaining)) !== null) {
+        const before = remaining.slice(lastIdx, match.index);
+        parts.push(escapeMarkdownV2(before));
+        parts.push("```" + match[1] + "```");
+        lastIdx = match.index + match[0].length;
+    }
+    parts.push(escapeMarkdownV2(remaining.slice(lastIdx)));
+    return parts.join("");
+}
+function fmtSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
+}
+// ── Channel implementation ────────────────────────────────────────
+export class TelegramChannel extends BaseChannel {
+    id = "telegram";
+    name = "Telegram";
+    supportsStreaming = true;
+    supportsFiles = true;
+    maxMessageLength = 4090;
+    token;
+    onMessage;
+    webhookUrl;
+    allowedUsers;
+    pollInterval;
+    cfg;
+    offset = 0;
+    polling = false;
+    pollTimer = null;
+    downloadDir = null;
+    constructor(opts) {
+        super();
+        this.token = opts.token;
+        this.onMessage = opts.onMessage;
+        this.webhookUrl = opts.webhookUrl;
+        this.allowedUsers = new Set(opts.allowedUsers ?? []);
+        this.pollInterval = opts.pollInterval ?? 1000;
+        this.cfg = opts.cfg;
+    }
+    // ── Lifecycle ─────────────────────────────────────────────────
+    async start() {
+        if (this.webhookUrl) {
+            await this.setWebhook(this.webhookUrl);
+            log.info({ webhookUrl: this.webhookUrl }, "telegram webhook set");
+        }
+        else {
+            // Clear any existing webhook before long-polling.
+            await this.apiCall("deleteWebhook", { drop_pending_updates: false })
+                .catch(() => { });
+            // Tell Telegram to drop any in-flight long-poll from a previous
+            // process (tsx watch / SIGKILL restarts leave getUpdates hanging
+            // on Telegram's side up to 60s, and the new poll gets 409 until
+            // it times out). `close` returns an error if there's no live
+            // session — swallow it.
+            await this.apiCall("close").catch(() => { });
+            this.polling = true;
+            this.poll();
+            log.info("telegram long-polling started");
+        }
+    }
+    async stop() {
+        this.polling = false;
+        if (this.pollTimer) {
+            clearTimeout(this.pollTimer);
+            this.pollTimer = null;
+        }
+        log.info("telegram channel stopped");
+    }
+    // ── Outbound ──────────────────────────────────────────────────
+    async sendReply(meta, text) {
+        const chatId = meta.chatId ?? meta.userId;
+        const formatted = formatForTelegram(text);
+        await this.apiCall("sendMessage", {
+            chat_id: chatId,
+            text: formatted,
+            parse_mode: "MarkdownV2",
+            ...(meta.messageId ? { reply_to_message_id: Number(meta.messageId) } : {}),
+        });
+    }
+    async sendOrEditStream(meta, text, prevMessageId) {
+        const chatId = meta.chatId ?? meta.userId;
+        const formatted = formatForTelegram(text);
+        if (prevMessageId) {
+            await this.apiCall("editMessageText", {
+                chat_id: chatId,
+                message_id: Number(prevMessageId),
+                text: formatted,
+                parse_mode: "MarkdownV2",
+            });
+            return prevMessageId;
+        }
+        const resp = (await this.apiCall("sendMessage", {
+            chat_id: chatId,
+            text: formatted,
+            parse_mode: "MarkdownV2",
+            ...(meta.messageId ? { reply_to_message_id: Number(meta.messageId) } : {}),
+        }));
+        return resp ? String(resp.message_id) : null;
+    }
+    async sendTyping(meta) {
+        const chatId = meta.chatId ?? meta.userId;
+        await this.apiCall("sendChatAction", {
+            chat_id: chatId,
+            action: "typing",
+        });
+    }
+    /**
+     * Upload a local file to a Telegram chat. Routes to the best-fit
+     * endpoint: photos → sendPhoto (renders inline), videos → sendVideo,
+     * audio → sendAudio, everything else → sendDocument. Uses multipart
+     * form so the raw bytes are uploaded — no need for a public URL.
+     */
+    async sendFile(meta, path, caption) {
+        const chatId = meta.chatId ?? meta.userId;
+        if (!chatId)
+            return;
+        try {
+            const bytes = readFileSync(path);
+            const name = basename(path);
+            const ext = extname(path).toLowerCase();
+            const { endpoint, fieldName } = telegramEndpointForExt(ext);
+            const form = new FormData();
+            form.append("chat_id", String(chatId));
+            if (caption && caption.trim().length > 0)
+                form.append("caption", caption);
+            form.append(fieldName, new Blob([new Uint8Array(bytes)]), name);
+            const url = `${API_BASE}${this.token}/${endpoint}`;
+            const resp = await fetch(url, { method: "POST", body: form });
+            if (!resp.ok) {
+                const body = await resp.text().catch(() => "");
+                log.error({ endpoint, status: resp.status, body: body.slice(0, 300) }, "telegram sendFile failed");
+            }
+        }
+        catch (err) {
+            log.error({ err: err.message, path }, "telegram sendFile errored");
+        }
+    }
+    async editMessage(meta, messageId, text) {
+        const chatId = meta.chatId ?? meta.userId;
+        const formatted = formatForTelegram(text);
+        await this.apiCall("editMessageText", {
+            chat_id: chatId,
+            message_id: Number(messageId),
+            text: formatted,
+            parse_mode: "MarkdownV2",
+        });
+    }
+    async deleteMessage(meta, messageId) {
+        const chatId = meta.chatId ?? meta.userId;
+        await this.apiCall("deleteMessage", {
+            chat_id: chatId,
+            message_id: Number(messageId),
+        });
+    }
+    // ── Access control ────────────────────────────────────────────
+    isAllowed(userId) {
+        if (this.allowedUsers.size === 0)
+            return true;
+        return this.allowedUsers.has(userId);
+    }
+    // ── Webhook handling (for external HTTP server) ───────────────
+    /**
+     * Process a raw webhook update body. Call this from your HTTP route
+     * handler when Telegram POSTs to the webhook URL.
+     */
+    handleWebhookUpdate(body) {
+        const update = body;
+        this.processUpdate(update);
+    }
+    // ── Internals ─────────────────────────────────────────────────
+    async setWebhook(url) {
+        await this.apiCall("setWebhook", { url });
+    }
+    poll() {
+        if (!this.polling)
+            return;
+        this.getUpdates()
+            .then((updates) => {
+            for (const update of updates) {
+                this.processUpdate(update);
+                this.offset = update.update_id + 1;
+            }
+        })
+            .catch((err) => {
+            log.error({ err }, "telegram poll error");
+        })
+            .finally(() => {
+            if (this.polling) {
+                this.pollTimer = setTimeout(() => this.poll(), this.pollInterval);
+            }
+        });
+    }
+    async getUpdates() {
+        const result = await this.apiCall("getUpdates", {
+            offset: this.offset,
+            timeout: 30,
+            allowed_updates: ["message", "edited_message"],
+        });
+        return result ?? [];
+    }
+    processUpdate(update) {
+        // Media processing is async (download + transcribe), so defer the
+        // whole branch rather than blocking the poll loop.
+        void this.processUpdateAsync(update).catch((err) => {
+            log.error({ err }, "telegram processUpdate failed");
+        });
+    }
+    async processUpdateAsync(update) {
+        const msg = update.message ?? update.edited_message;
+        if (!msg)
+            return;
+        const userId = String(msg.from?.id ?? "unknown");
+        if (!this.isAllowed(userId)) {
+            log.debug({ userId }, "telegram: user not in allowlist, skipping");
+            return;
+        }
+        const caption = (msg.caption ?? "").trim();
+        const textOnly = (msg.text ?? "").trim();
+        // Start with any explicit text. Media handlers may replace or
+        // augment this — e.g. voice becomes a transcript, photos embed
+        // the downloaded path so the agent can analyse them.
+        let text = textOnly;
+        const extraMeta = {};
+        // Attachments the agent should see alongside the text turn. Images
+        // populate this so the multimodal model can actually view them;
+        // documents/videos populate it so the AttachmentProcessor can
+        // surface a "[file: /path]" hint without us rebuilding the string.
+        const attachments = [];
+        // ── Voice (Telegram's .ogg/opus "hold to record" messages) ──
+        if (msg.voice) {
+            await this.sendChatAction(String(msg.chat.id), "typing");
+            const path = await this.downloadFile(msg.voice.file_id, ".ogg").catch((err) => {
+                log.warn({ err }, "telegram voice download failed");
+                return null;
+            });
+            if (!path) {
+                await this.sendReplyRaw(msg, "Sorry, I couldn't download your voice message.");
+                return;
+            }
+            const transcript = await this.safelyTranscribe(path);
+            if (!transcript) {
+                await this.sendReplyRaw(msg, "I got your voice message but transcription isn't configured (set GROQ_API_KEY or OPENAI_API_KEY).");
+                return;
+            }
+            text = `[Voice message]: ${transcript}`;
+            extraMeta["voiceFilePath"] = path;
+            extraMeta["voiceDurationSec"] = msg.voice.duration;
+        }
+        // ── Audio files (uploaded) ──
+        else if (msg.audio) {
+            await this.sendChatAction(String(msg.chat.id), "typing");
+            const ext = extname(msg.audio.file_name ?? "") || ".mp3";
+            const path = await this.downloadFile(msg.audio.file_id, ext).catch(() => null);
+            if (!path) {
+                await this.sendReplyRaw(msg, "Couldn't download the audio file.");
+                return;
+            }
+            const transcript = await this.safelyTranscribe(path);
+            text = transcript
+                ? `[Audio transcript]: ${transcript}${caption ? `\nUser caption: ${caption}` : ""}`
+                : `[Audio file received at ${path}]${caption ? `\nUser caption: ${caption}` : ""}`;
+            extraMeta["audioFilePath"] = path;
+        }
+        // ── Photos ──
+        else if (msg.photo) {
+            await this.sendChatAction(String(msg.chat.id), "typing");
+            const best = msg.photo[msg.photo.length - 1]; // highest-res
+            if (best) {
+                const path = await this.downloadFile(best.file_id, ".jpg").catch(() => null);
+                if (path) {
+                    text = caption || "";
+                    extraMeta["photoFilePath"] = path;
+                    attachments.push({ kind: "image", path, mimeType: "image/jpeg" });
+                }
+                else {
+                    text = caption ? `[Photo — download failed]\n${caption}` : "[Photo — download failed]";
+                }
+            }
+        }
+        // ── Video ──
+        else if (msg.video || msg.video_note) {
+            await this.sendChatAction(String(msg.chat.id), "upload_video");
+            const video = msg.video ?? msg.video_note;
+            const ext = video === msg.video_note ? ".mp4" : (extname(msg.video?.file_name ?? "") || ".mp4");
+            const path = await this.downloadFile(video.file_id, ext).catch(() => null);
+            text = path
+                ? `[Video received at ${path}]\n${caption || "User sent a video."}`
+                : `[Video — download failed]\n${caption}`;
+            if (path)
+                extraMeta["videoFilePath"] = path;
+        }
+        // ── Documents / files ──
+        else if (msg.document) {
+            await this.sendChatAction(String(msg.chat.id), "typing");
+            const ext = extname(msg.document.file_name ?? "") || "";
+            const path = await this.downloadFile(msg.document.file_id, ext).catch(() => null);
+            if (path) {
+                text = caption || "";
+                extraMeta["documentFilePath"] = path;
+                const mime = msg.document.mime_type ?? "application/octet-stream";
+                const doc = {
+                    kind: mime.startsWith("image/") ? "image" : "document",
+                    path,
+                    mimeType: mime,
+                    ...(msg.document.file_name ? { filename: msg.document.file_name } : {}),
+                    ...(msg.document.file_size !== undefined ? { size: msg.document.file_size } : {}),
+                };
+                attachments.push(doc);
+            }
+            else {
+                text = `[File "${msg.document.file_name ?? "unknown"}" — download failed]\n${caption}`;
+            }
+            extraMeta["documentName"] = msg.document.file_name;
+        }
+        if (!text.trim() && attachments.length === 0)
+            return;
+        const incoming = {
+            channel: this.id,
+            userId,
+            text: text.trim(),
+            meta: {
+                channel: this.id,
+                userId,
+                chatId: String(msg.chat.id),
+                messageId: String(msg.message_id),
+                telegramFrom: msg.from,
+                chatType: msg.chat.type,
+                ...extraMeta,
+            },
+            timestamp: msg.date * 1000,
+            ...(attachments.length > 0 ? { attachments } : {}),
+        };
+        this.onMessage(incoming);
+    }
+    /** Returns the transcript or null when STT isn't configured / fails. */
+    async safelyTranscribe(filePath) {
+        try {
+            const { text } = await transcribeAudioFile(this.cfg, filePath);
+            return text || null;
+        }
+        catch (err) {
+            log.warn({ err: err.message }, "telegram transcription failed");
+            return null;
+        }
+    }
+    async ensureDownloadDir() {
+        if (this.downloadDir)
+            return this.downloadDir;
+        const dir = join(tmpdir(), "daemora-telegram");
+        await mkdir(dir, { recursive: true });
+        this.downloadDir = dir;
+        return dir;
+    }
+    /**
+     * Download a Telegram-hosted file by `file_id`. Telegram's two-step
+     * flow: getFile → returns relative file_path → fetch from /file/bot<TOKEN>/<path>.
+     * Returns the absolute local path on disk.
+     */
+    async downloadFile(fileId, ext) {
+        const info = (await this.apiCall("getFile", { file_id: fileId }));
+        if (!info?.file_path)
+            throw new Error(`Telegram getFile returned no file_path for ${fileId}`);
+        const url = `https://api.telegram.org/file/bot${this.token}/${info.file_path}`;
+        const res = await fetch(url);
+        if (!res.ok || !res.body)
+            throw new Error(`Telegram file download ${res.status}`);
+        const dir = await this.ensureDownloadDir();
+        const outPath = join(dir, `${fileId}${ext.startsWith(".") ? ext : `.${ext || "bin"}`}`);
+        await pipeline(Readable.fromWeb(res.body), createWriteStream(outPath));
+        return outPath;
+    }
+    async sendChatAction(chatId, action) {
+        await this.apiCall("sendChatAction", { chat_id: chatId, action });
+    }
+    /** Plain-text reply used for error paths where MarkdownV2 escaping is overkill. */
+    async sendReplyRaw(msg, text) {
+        await this.apiCall("sendMessage", {
+            chat_id: msg.chat.id,
+            text,
+            reply_to_message_id: msg.message_id,
+        });
+    }
+    async apiCall(method, params) {
+        const url = `${API_BASE}${this.token}/${method}`;
+        try {
+            const init = {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+            };
+            if (params)
+                init.body = JSON.stringify(params);
+            const resp = await fetch(url, init);
+            if (!resp.ok) {
+                const body = await resp.text();
+                log.error({ method, status: resp.status, body }, "telegram API error");
+                return null;
+            }
+            const json = (await resp.json());
+            if (!json.ok) {
+                log.error({ method, json }, "telegram API returned ok=false");
+                return null;
+            }
+            return json.result;
+        }
+        catch (err) {
+            log.error({ err, method }, "telegram API call failed");
+            return null;
+        }
+    }
+}
+function telegramEndpointForExt(ext) {
+    const img = new Set([".jpg", ".jpeg", ".png", ".gif", ".webp"]);
+    const video = new Set([".mp4", ".mov", ".avi", ".mkv", ".webm"]);
+    const audio = new Set([".mp3", ".ogg", ".wav", ".m4a", ".oga"]);
+    if (img.has(ext))
+        return { endpoint: "sendPhoto", fieldName: "photo" };
+    if (video.has(ext))
+        return { endpoint: "sendVideo", fieldName: "video" };
+    if (audio.has(ext))
+        return { endpoint: "sendAudio", fieldName: "audio" };
+    return { endpoint: "sendDocument", fieldName: "document" };
+}
+//# sourceMappingURL=TelegramChannel.js.map

package/dist/channels/TelegramChannel.js.map

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

package/dist/channels/TwitchChannel.d.ts

@@ -0,0 +1,45 @@
+/**
+ * TwitchChannel — chat bot over Twitch's IRC gateway (wss TMI).
+ *
+ * Setup:
+ *   1. Create a Twitch app at https://dev.twitch.tv/console
+ *   2. Generate an OAuth token for the bot account (chat:read + chat:edit scopes).
+ *   3. Provide TWITCH_BOT_USERNAME, TWITCH_OAUTH_TOKEN, TWITCH_CHANNEL.
+ *
+ * Bot listens for `!ask` / `@botname` commands in the configured
+ * channel and ignores everything else so it can sit silently in busy
+ * streams.
+ */
+import { BaseChannel, type ChannelMeta, type IncomingMessage } from "./BaseChannel.js";
+export interface TwitchChannelOpts {
+    readonly username: string;
+    /** OAuth token WITHOUT the `oauth:` prefix. We add it before sending. */
+    readonly token: string;
+    /** Twitch channel to join, without the `#` prefix. */
+    readonly channel: string;
+    /** Command prefix. Default `!ask`. */
+    readonly prefix?: string;
+    readonly allowedUsers?: readonly string[];
+    readonly onMessage: (msg: IncomingMessage) => void;
+}
+export declare class TwitchChannel extends BaseChannel {
+    readonly id: "twitch";
+    readonly name: "Twitch";
+    readonly maxMessageLength = 490;
+    private readonly username;
+    private readonly token;
+    private readonly channel;
+    private readonly prefix;
+    private readonly allowedUsers;
+    private readonly onMessage;
+    private ws;
+    private running;
+    constructor(opts: TwitchChannelOpts);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendReply(meta: ChannelMeta, text: string): Promise<void>;
+    isAllowed(userId: string): boolean;
+    private sendChat;
+    private handleLine;
+}
+//# sourceMappingURL=TwitchChannel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TwitchChannel.d.ts","sourceRoot":"","sources":["../../src/channels/TwitchChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAavF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,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,gBAAgB,OAAO;IAEzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,iBAAiB;IAU7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOZ,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAO3C,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,UAAU;CAyCnB"}

package/dist/channels/TwitchChannel.js

@@ -0,0 +1,117 @@
+/**
+ * TwitchChannel — chat bot over Twitch's IRC gateway (wss TMI).
+ *
+ * Setup:
+ *   1. Create a Twitch app at https://dev.twitch.tv/console
+ *   2. Generate an OAuth token for the bot account (chat:read + chat:edit scopes).
+ *   3. Provide TWITCH_BOT_USERNAME, TWITCH_OAUTH_TOKEN, TWITCH_CHANNEL.
+ *
+ * Bot listens for `!ask` / `@botname` commands in the configured
+ * channel and ignores everything else so it can sit silently in busy
+ * streams.
+ */
+import { createLogger } from "../util/logger.js";
+import { BaseChannel } from "./BaseChannel.js";
+const log = createLogger("channel.twitch");
+export class TwitchChannel extends BaseChannel {
+    id = "twitch";
+    name = "Twitch";
+    maxMessageLength = 490; // Twitch caps PRIVMSG at 500; leave room for @mention prefix
+    username;
+    token;
+    channel;
+    prefix;
+    allowedUsers;
+    onMessage;
+    ws = null;
+    running = false;
+    constructor(opts) {
+        super();
+        this.username = opts.username.toLowerCase();
+        this.token = opts.token.replace(/^oauth:/i, "");
+        this.channel = opts.channel.replace(/^#/, "").toLowerCase();
+        this.prefix = (opts.prefix ?? "!ask").toLowerCase();
+        this.allowedUsers = new Set((opts.allowedUsers ?? []).map((u) => u.toLowerCase()));
+        this.onMessage = opts.onMessage;
+    }
+    async start() {
+        const { WebSocket } = (await import("ws"));
+        this.ws = new WebSocket("wss://irc-ws.chat.twitch.tv:443");
+        this.running = true;
+        this.ws.on("open", () => {
+            this.ws?.send(`PASS oauth:${this.token}`);
+            this.ws?.send(`NICK ${this.username}`);
+            this.ws?.send(`JOIN #${this.channel}`);
+            log.info({ channel: this.channel }, "twitch connected");
+        });
+        this.ws.on("message", (raw) => this.handleLine(raw.toString().trim()));
+        this.ws.on("error", (err) => log.error({ err: err.message }, "twitch ws error"));
+        this.ws.on("close", () => {
+            this.running = false;
+            log.info("twitch ws closed");
+        });
+    }
+    async stop() {
+        this.running = false;
+        this.ws?.close();
+        this.ws = null;
+        log.info("twitch channel stopped");
+    }
+    async sendReply(meta, text) {
+        const mentionPrefix = meta.username ? `@${meta.username} ` : "";
+        this.sendChat(`${mentionPrefix}${text}`);
+    }
+    isAllowed(userId) {
+        if (this.allowedUsers.size === 0)
+            return true;
+        return this.allowedUsers.has(userId.toLowerCase());
+    }
+    // ── Internals ───────────────────────────────────────────────────
+    sendChat(text) {
+        if (this.ws?.readyState === 1) {
+            this.ws.send(`PRIVMSG #${this.channel} :${text.slice(0, 490)}`);
+        }
+    }
+    handleLine(line) {
+        if (line.startsWith("PING")) {
+            this.ws?.send("PONG :tmi.twitch.tv");
+            return;
+        }
+        const match = line.match(/^:(\w+)!\w+@\w+\.tmi\.twitch\.tv PRIVMSG #(\w+) :(.+)$/);
+        if (!match)
+            return;
+        const sender = match[1];
+        const message = match[3];
+        if (sender.toLowerCase() === this.username)
+            return;
+        const lower = message.toLowerCase();
+        const mentioned = lower.includes(`@${this.username}`);
+        const hasPrefix = lower.startsWith(this.prefix);
+        if (!mentioned && !hasPrefix)
+            return;
+        if (!this.isAllowed(sender)) {
+            this.sendChat(`@${sender} Sorry, you're not on the allowlist.`);
+            return;
+        }
+        const input = message
+            .replace(new RegExp(`^${this.prefix}\\s*`, "i"), "")
+            .replace(new RegExp(`@${this.username}\\s*`, "ig"), "")
+            .trim();
+        if (!input)
+            return;
+        const incoming = {
+            channel: this.id,
+            userId: sender,
+            text: input,
+            meta: {
+                channel: this.id,
+                userId: sender,
+                username: sender,
+                chatId: this.channel,
+            },
+            timestamp: Date.now(),
+        };
+        this.onMessage(incoming);
+    }
+}
+//# sourceMappingURL=TwitchChannel.js.map