daemora 1.0.0-alpha.0

package/dist/channels/MatrixChannel.js

@@ -0,0 +1,156 @@
+/**
+ * MatrixChannel — Matrix (matrix.org / Element) chat integration.
+ *
+ * Uses raw HTTP against the Matrix Client-Server API — no SDK — so
+ * there's one less native dependency to carry. Long-polls /sync for
+ * new events and sends replies via /rooms/{roomId}/send.
+ *
+ * Setup:
+ *   1. Register a bot account, e.g. @mybot:matrix.org
+ *   2. Generate an access token via /_matrix/client/v3/login
+ *   3. Provide MATRIX_HOMESERVER_URL, MATRIX_ACCESS_TOKEN, and
+ *      optionally MATRIX_BOT_USER_ID (used to filter out the bot's
+ *      own echoes).
+ */
+import { createLogger } from "../util/logger.js";
+import { BaseChannel } from "./BaseChannel.js";
+const log = createLogger("channel.matrix");
+const SYNC_TIMEOUT_MS = 30_000;
+export class MatrixChannel extends BaseChannel {
+    id = "matrix";
+    name = "Matrix";
+    maxMessageLength = 32_000;
+    homeserverUrl;
+    accessToken;
+    botUserId;
+    allowedUsers;
+    onMessage;
+    running = false;
+    syncToken = null;
+    abortController = null;
+    constructor(opts) {
+        super();
+        this.homeserverUrl = opts.homeserverUrl.replace(/\/+$/, "");
+        this.accessToken = opts.accessToken;
+        this.botUserId = opts.botUserId;
+        this.allowedUsers = new Set(opts.allowedUsers ?? []);
+        this.onMessage = opts.onMessage;
+    }
+    // ── Lifecycle ───────────────────────────────────────────────────
+    async start() {
+        this.running = true;
+        this.abortController = new AbortController();
+        // Initial sync to discover current position, then loop long-polls.
+        void this.syncLoop().catch((err) => {
+            if (!err.name?.includes("Abort")) {
+                log.error({ err }, "matrix sync loop crashed");
+            }
+        });
+        log.info({ homeserver: this.homeserverUrl }, "matrix channel started");
+    }
+    async stop() {
+        this.running = false;
+        this.abortController?.abort();
+        this.abortController = null;
+        log.info("matrix channel stopped");
+    }
+    isAllowed(userId) {
+        if (this.allowedUsers.size === 0)
+            return true;
+        return this.allowedUsers.has(userId);
+    }
+    // ── Outbound ────────────────────────────────────────────────────
+    async sendReply(meta, text) {
+        const roomId = meta.roomId ?? meta.chatId;
+        if (!roomId)
+            throw new Error("Matrix reply needs roomId in channelMeta");
+        // Matrix messages can be huge but splitting keeps reading comfortable.
+        const chunks = text.match(/[\s\S]{1,4000}/g) ?? [text];
+        for (const chunk of chunks) {
+            await this.sendMessage(roomId, chunk);
+        }
+    }
+    async sendMessage(roomId, text) {
+        const txnId = `daemora-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const url = `${this.homeserverUrl}/_matrix/client/v3/rooms/${encodeURIComponent(roomId)}/send/m.room.message/${txnId}`;
+        const res = await fetch(url, {
+            method: "PUT",
+            headers: { "Content-Type": "application/json", Authorization: `Bearer ${this.accessToken}` },
+            body: JSON.stringify({ msgtype: "m.text", body: text }),
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            log.error({ status: res.status, body }, "matrix send failed");
+        }
+    }
+    // ── Sync loop ───────────────────────────────────────────────────
+    async syncLoop() {
+        while (this.running) {
+            try {
+                const params = new URLSearchParams({
+                    timeout: String(SYNC_TIMEOUT_MS),
+                    access_token: this.accessToken,
+                });
+                if (this.syncToken)
+                    params.set("since", this.syncToken);
+                else
+                    params.set("filter", JSON.stringify({ room: { timeline: { limit: 0 } } }));
+                const res = await fetch(`${this.homeserverUrl}/_matrix/client/v3/sync?${params.toString()}`, {
+                    method: "GET",
+                    signal: this.abortController?.signal ?? null,
+                });
+                if (!res.ok) {
+                    const body = await res.text().catch(() => "");
+                    log.warn({ status: res.status, body }, "matrix sync bad status");
+                    await new Promise((r) => setTimeout(r, 3000));
+                    continue;
+                }
+                const data = (await res.json());
+                this.syncToken = data.next_batch;
+                for (const [roomId, room] of Object.entries(data.rooms?.join ?? {})) {
+                    for (const event of room.timeline?.events ?? []) {
+                        this.handleEvent(roomId, event);
+                    }
+                }
+            }
+            catch (e) {
+                if (!this.running)
+                    break;
+                const err = e;
+                if (err.name === "AbortError")
+                    break;
+                log.error({ err: err.message }, "matrix sync error");
+                await new Promise((r) => setTimeout(r, 3000));
+            }
+        }
+    }
+    handleEvent(roomId, event) {
+        if (event.type !== "m.room.message")
+            return;
+        if (event.content?.msgtype !== "m.text")
+            return;
+        const sender = event.sender ?? "";
+        if (this.botUserId && sender === this.botUserId)
+            return;
+        if (!this.isAllowed(sender))
+            return;
+        const body = event.content.body?.trim();
+        if (!body)
+            return;
+        const incoming = {
+            channel: this.id,
+            userId: sender,
+            text: body,
+            meta: {
+                channel: this.id,
+                userId: sender,
+                roomId,
+                chatId: roomId,
+                ...(event.event_id ? { messageId: event.event_id } : {}),
+            },
+            timestamp: event.origin_server_ts ?? Date.now(),
+        };
+        this.onMessage(incoming);
+    }
+}
+//# sourceMappingURL=MatrixChannel.js.map

package/dist/channels/MatrixChannel.js.map

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

package/dist/channels/MattermostChannel.d.ts

@@ -0,0 +1,42 @@
+/**
+ * MattermostChannel — receives messages via Mattermost's WebSocket API.
+ *
+ * Setup:
+ *   1. Create a Bot Account in System Console → Integrations → Bot Accounts.
+ *   2. Copy the bot access token and user id.
+ *   3. Provide MATTERMOST_URL, MATTERMOST_TOKEN, MATTERMOST_BOT_USER_ID,
+ *      optionally MATTERMOST_BOT_USERNAME (used to detect @mentions).
+ *
+ * Only responds to DMs or @mentions — otherwise the bot would reply to
+ * every channel message it can see.
+ */
+import { BaseChannel, type ChannelMeta, type IncomingMessage } from "./BaseChannel.js";
+export interface MattermostChannelOpts {
+    readonly url: string;
+    readonly token: string;
+    readonly botUserId: string;
+    readonly botUsername?: string;
+    readonly allowedUsers?: readonly string[];
+    readonly onMessage: (msg: IncomingMessage) => void;
+}
+export declare class MattermostChannel extends BaseChannel {
+    readonly id: "mattermost";
+    readonly name: "Mattermost";
+    readonly maxMessageLength = 16000;
+    private readonly url;
+    private readonly token;
+    private readonly botUserId;
+    private readonly botUsername;
+    private readonly allowedUsers;
+    private readonly onMessage;
+    private ws;
+    private seq;
+    private running;
+    constructor(opts: MattermostChannelOpts);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendReply(meta: ChannelMeta, text: string): Promise<void>;
+    isAllowed(userId: string): boolean;
+    private handleMessage;
+}
+//# sourceMappingURL=MattermostChannel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MattermostChannel.d.ts","sourceRoot":"","sources":["../../src/channels/MattermostChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAcvF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD;AAmBD,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,QAAQ,CAAC,EAAE,EAAG,YAAY,CAAU;IACpC,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IACtC,SAAkB,gBAAgB,SAAU;IAE5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,EAAE,qBAAqB;IAUjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOZ,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B/D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAK3C,OAAO,CAAC,aAAa;CAsCtB"}

package/dist/channels/MattermostChannel.js

@@ -0,0 +1,144 @@
+/**
+ * MattermostChannel — receives messages via Mattermost's WebSocket API.
+ *
+ * Setup:
+ *   1. Create a Bot Account in System Console → Integrations → Bot Accounts.
+ *   2. Copy the bot access token and user id.
+ *   3. Provide MATTERMOST_URL, MATTERMOST_TOKEN, MATTERMOST_BOT_USER_ID,
+ *      optionally MATTERMOST_BOT_USERNAME (used to detect @mentions).
+ *
+ * Only responds to DMs or @mentions — otherwise the bot would reply to
+ * every channel message it can see.
+ */
+import { createLogger } from "../util/logger.js";
+import { BaseChannel } from "./BaseChannel.js";
+const log = createLogger("channel.mattermost");
+export class MattermostChannel extends BaseChannel {
+    id = "mattermost";
+    name = "Mattermost";
+    maxMessageLength = 16_000;
+    url;
+    token;
+    botUserId;
+    botUsername;
+    allowedUsers;
+    onMessage;
+    ws = null;
+    seq = 1;
+    running = false;
+    constructor(opts) {
+        super();
+        this.url = opts.url.replace(/\/+$/, "");
+        this.token = opts.token;
+        this.botUserId = opts.botUserId;
+        this.botUsername = opts.botUsername;
+        this.allowedUsers = new Set(opts.allowedUsers ?? []);
+        this.onMessage = opts.onMessage;
+    }
+    async start() {
+        const { WebSocket } = (await import("ws"));
+        const wsUrl = this.url.replace(/^http/i, "ws") + "/api/v4/websocket";
+        this.ws = new WebSocket(wsUrl);
+        this.running = true;
+        this.ws.on("open", () => {
+            this.ws?.send(JSON.stringify({
+                seq: this.seq++,
+                action: "authentication_challenge",
+                data: { token: this.token },
+            }));
+            log.info("mattermost websocket connected");
+        });
+        this.ws.on("message", (raw) => this.handleMessage(raw.toString()));
+        this.ws.on("error", (err) => log.error({ err: err.message }, "mattermost ws error"));
+        this.ws.on("close", () => {
+            log.info("mattermost websocket closed");
+            this.running = false;
+        });
+    }
+    async stop() {
+        this.running = false;
+        this.ws?.close();
+        this.ws = null;
+        log.info("mattermost channel stopped");
+    }
+    async sendReply(meta, text) {
+        const channelId = meta.channelId ?? meta.chatId;
+        if (!channelId)
+            throw new Error("Mattermost reply needs channelId in channelMeta");
+        const rootId = meta.postId ?? meta.messageId;
+        const chunks = text.match(/[\s\S]{1,4000}/g) ?? [text];
+        for (const chunk of chunks) {
+            const res = await fetch(`${this.url}/api/v4/posts`, {
+                method: "POST",
+                headers: {
+                    Authorization: `Bearer ${this.token}`,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify({
+                    channel_id: channelId,
+                    message: chunk,
+                    ...(rootId ? { root_id: rootId } : {}),
+                }),
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                log.error({ status: res.status, body }, "mattermost send failed");
+            }
+        }
+    }
+    isAllowed(userId) {
+        if (this.allowedUsers.size === 0)
+            return true;
+        return this.allowedUsers.has(userId);
+    }
+    handleMessage(raw) {
+        let msg;
+        try {
+            msg = JSON.parse(raw);
+        }
+        catch {
+            return;
+        }
+        if (msg.event !== "posted")
+            return;
+        if (!msg.data?.post)
+            return;
+        let post;
+        try {
+            post = JSON.parse(msg.data.post);
+        }
+        catch {
+            return;
+        }
+        if (!post.message?.trim())
+            return;
+        if (post.user_id === this.botUserId)
+            return;
+        if (!this.isAllowed(post.user_id))
+            return;
+        const isDM = msg.data.channel_type === "D";
+        const mentionTag = this.botUsername ? `@${this.botUsername}` : null;
+        const isMentioned = !!(mentionTag && post.message.includes(mentionTag));
+        if (!isDM && !isMentioned)
+            return;
+        // Strip leading mentions so the agent gets the clean prompt.
+        const body = post.message.replace(/@\S+/g, "").trim() || post.message;
+        const incoming = {
+            channel: this.id,
+            userId: post.user_id,
+            text: body,
+            meta: {
+                channel: this.id,
+                userId: post.user_id,
+                channelId: post.channel_id,
+                chatId: post.channel_id,
+                messageId: post.id,
+                postId: post.id,
+                isDM,
+            },
+            timestamp: post.create_at ?? Date.now(),
+        };
+        this.onMessage(incoming);
+    }
+}
+//# sourceMappingURL=MattermostChannel.js.map

package/dist/channels/MattermostChannel.js.map

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

package/dist/channels/NextcloudChannel.d.ts

@@ -0,0 +1,46 @@
+/**
+ * NextcloudChannel — Nextcloud Talk bot via the Spreed REST API.
+ *
+ * Polls every ~5 s for new messages in every DM / group room the bot
+ * user participates in, then replies with POST
+ * `/ocs/v2.php/apps/spreed/api/v1/chat/{token}`.
+ *
+ * Setup:
+ *   1. Create a dedicated Nextcloud user for the bot.
+ *   2. Generate an app password (Profile → Security).
+ *   3. Provide NEXTCLOUD_URL, NEXTCLOUD_USER, NEXTCLOUD_PASSWORD, and
+ *      optionally NEXTCLOUD_ROOM_TOKEN to restrict to one room.
+ */
+import { BaseChannel, type ChannelMeta, type IncomingMessage } from "./BaseChannel.js";
+export interface NextcloudChannelOpts {
+    readonly url: string;
+    readonly user: string;
+    readonly password: string;
+    readonly roomToken?: string;
+    readonly pollIntervalMs?: number;
+    readonly allowedUsers?: readonly string[];
+    readonly onMessage: (msg: IncomingMessage) => void;
+}
+export declare class NextcloudChannel extends BaseChannel {
+    readonly id: "nextcloud";
+    readonly name: "Nextcloud Talk";
+    readonly maxMessageLength = 32000;
+    private readonly url;
+    private readonly user;
+    private readonly password;
+    private readonly roomToken;
+    private readonly pollMs;
+    private readonly allowedUsers;
+    private readonly onMessage;
+    private pollTimer;
+    private running;
+    private readonly lastMessageIds;
+    constructor(opts: NextcloudChannelOpts);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendReply(meta: ChannelMeta, text: string): Promise<void>;
+    isAllowed(userId: string): boolean;
+    private headers;
+    private poll;
+}
+//# sourceMappingURL=NextcloudChannel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NextcloudChannel.d.ts","sourceRoot":"","sources":["../../src/channels/NextcloudChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIvF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD;AAcD,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,QAAQ,CAAC,EAAE,EAAG,WAAW,CAAU;IACnC,QAAQ,CAAC,IAAI,EAAG,gBAAgB,CAAU;IAC1C,SAAkB,gBAAgB,SAAU;IAE5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;gBAEhD,IAAI,EAAE,oBAAoB;IAWhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASZ,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB/D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAO3C,OAAO,CAAC,OAAO;YASD,IAAI;CAsDnB"}

package/dist/channels/NextcloudChannel.js

@@ -0,0 +1,146 @@
+/**
+ * NextcloudChannel — Nextcloud Talk bot via the Spreed REST API.
+ *
+ * Polls every ~5 s for new messages in every DM / group room the bot
+ * user participates in, then replies with POST
+ * `/ocs/v2.php/apps/spreed/api/v1/chat/{token}`.
+ *
+ * Setup:
+ *   1. Create a dedicated Nextcloud user for the bot.
+ *   2. Generate an app password (Profile → Security).
+ *   3. Provide NEXTCLOUD_URL, NEXTCLOUD_USER, NEXTCLOUD_PASSWORD, and
+ *      optionally NEXTCLOUD_ROOM_TOKEN to restrict to one room.
+ */
+import { createLogger } from "../util/logger.js";
+import { BaseChannel } from "./BaseChannel.js";
+const log = createLogger("channel.nextcloud");
+export class NextcloudChannel extends BaseChannel {
+    id = "nextcloud";
+    name = "Nextcloud Talk";
+    maxMessageLength = 32_000;
+    url;
+    user;
+    password;
+    roomToken;
+    pollMs;
+    allowedUsers;
+    onMessage;
+    pollTimer = null;
+    running = false;
+    lastMessageIds = new Map();
+    constructor(opts) {
+        super();
+        this.url = opts.url.replace(/\/$/, "");
+        this.user = opts.user;
+        this.password = opts.password;
+        this.roomToken = opts.roomToken;
+        this.pollMs = opts.pollIntervalMs ?? 5_000;
+        this.allowedUsers = new Set(opts.allowedUsers ?? []);
+        this.onMessage = opts.onMessage;
+    }
+    async start() {
+        this.running = true;
+        this.pollTimer = setInterval(() => { void this.poll(); }, this.pollMs);
+        log.info({ url: this.url, intervalMs: this.pollMs }, "nextcloud polling started");
+    }
+    async stop() {
+        this.running = false;
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = null;
+        }
+        log.info("nextcloud channel stopped");
+    }
+    async sendReply(meta, text) {
+        const token = meta.token ?? meta.chatId;
+        if (!token)
+            throw new Error("Nextcloud reply needs token in channelMeta");
+        const chunks = text.match(/[\s\S]{1,32000}/g) ?? [text];
+        for (const chunk of chunks) {
+            const body = new URLSearchParams({ message: chunk });
+            const res = await fetch(`${this.url}/ocs/v2.php/apps/spreed/api/v1/chat/${token}`, {
+                method: "POST",
+                headers: {
+                    ...this.headers(),
+                    "Content-Type": "application/x-www-form-urlencoded",
+                },
+                body: body.toString(),
+            });
+            if (!res.ok) {
+                log.error({ status: res.status }, "nextcloud send failed");
+            }
+        }
+    }
+    isAllowed(userId) {
+        if (this.allowedUsers.size === 0)
+            return true;
+        return this.allowedUsers.has(userId);
+    }
+    // ── Internals ───────────────────────────────────────────────────
+    headers() {
+        const creds = Buffer.from(`${this.user}:${this.password}`).toString("base64");
+        return {
+            Authorization: `Basic ${creds}`,
+            "OCS-APIRequest": "true",
+            Accept: "application/json",
+        };
+    }
+    async poll() {
+        if (!this.running)
+            return;
+        try {
+            const roomsRes = await fetch(`${this.url}/ocs/v2.php/apps/spreed/api/v4/room`, {
+                headers: this.headers(),
+            });
+            if (!roomsRes.ok)
+                return;
+            const roomsData = (await roomsRes.json());
+            const rooms = roomsData.ocs?.data ?? [];
+            for (const room of rooms) {
+                if (this.roomToken && room.token !== this.roomToken)
+                    continue;
+                if (room.type !== 1 && room.type !== 3)
+                    continue; // 1=DM, 3=group
+                const lastKnown = this.lastMessageIds.get(room.token) ?? 0;
+                const msgsRes = await fetch(`${this.url}/ocs/v2.php/apps/spreed/api/v1/chat/${room.token}?lookIntoFuture=0&limit=10&lastKnownMessageId=${lastKnown}`, { headers: this.headers() });
+                if (!msgsRes.ok)
+                    continue;
+                const msgsData = (await msgsRes.json());
+                const messages = msgsData.ocs?.data ?? [];
+                for (const msg of messages) {
+                    if (msg.actorId === this.user)
+                        continue;
+                    if (msg.messageType !== "comment")
+                        continue;
+                    if (msg.id <= lastKnown)
+                        continue;
+                    this.lastMessageIds.set(room.token, Math.max(this.lastMessageIds.get(room.token) ?? 0, msg.id));
+                    if (!msg.actorId || !this.isAllowed(msg.actorId))
+                        continue;
+                    const text = msg.message?.trim();
+                    if (!text)
+                        continue;
+                    const incoming = {
+                        channel: this.id,
+                        userId: msg.actorId,
+                        text,
+                        meta: {
+                            channel: this.id,
+                            userId: msg.actorId,
+                            actorId: msg.actorId,
+                            token: room.token,
+                            chatId: room.token,
+                            messageId: String(msg.id),
+                        },
+                        timestamp: msg.timestamp ? msg.timestamp * 1000 : Date.now(),
+                    };
+                    this.onMessage(incoming);
+                }
+            }
+        }
+        catch (e) {
+            log.debug({ err: e.message }, "nextcloud poll error");
+        }
+    }
+}
+//# sourceMappingURL=NextcloudChannel.js.map

package/dist/channels/NextcloudChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NextcloudChannel.js","sourceRoot":"","sources":["../../src/channels/NextcloudChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,WAAW,EAA0C,MAAM,kBAAkB,CAAC;AAEvF,MAAM,GAAG,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;AAwB9C,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IACtC,EAAE,GAAG,WAAoB,CAAC;IAC1B,IAAI,GAAG,gBAAyB,CAAC;IACxB,gBAAgB,GAAG,MAAM,CAAC;IAE3B,GAAG,CAAS;IACZ,IAAI,CAAS;IACb,QAAQ,CAAS;IACjB,SAAS,CAAqB;IAC9B,MAAM,CAAS;IACf,YAAY,CAAsB;IAClC,SAAS,CAAiC;IAEnD,SAAS,GAA0C,IAAI,CAAC;IACxD,OAAO,GAAG,KAAK,CAAC;IACP,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5D,YAAY,IAA0B;QACpC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC;QAC3C,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,2BAA2B,CAAC,CAAC;IACpF,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,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,CAAC;IAEQ,KAAK,CAAC,SAAS,CAAC,IAAiB,EAAE,IAAY;QACtD,MAAM,KAAK,GAAI,IAAI,CAAC,KAA4B,IAAK,IAAI,CAAC,MAA6B,CAAC;QACxF,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,uCAAuC,KAAK,EAAE,EAAE;gBACjF,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,GAAG,IAAI,CAAC,OAAO,EAAE;oBACjB,cAAc,EAAE,mCAAmC;iBACpD;gBACD,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;aACtB,CAAC,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAEQ,SAAS,CAAC,MAAc;QAC/B,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9C,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,mEAAmE;IAE3D,OAAO;QACb,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9E,OAAO;YACL,aAAa,EAAE,SAAS,KAAK,EAAE;YAC/B,gBAAgB,EAAE,MAAM;YACxB,MAAM,EAAE,kBAAkB;SAC3B,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO;QAC1B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,qCAAqC,EAAE;gBAC7E,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;aACxB,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,OAAO;YACzB,MAAM,SAAS,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyC,CAAC;YAClF,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;YAExC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,SAAS;oBAAE,SAAS;gBAC9D,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;oBAAE,SAAS,CAAC,gBAAgB;gBAElE,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC3D,MAAM,OAAO,GAAG,MAAM,KAAK,CACzB,GAAG,IAAI,CAAC,GAAG,uCAAuC,IAAI,CAAC,KAAK,iDAAiD,SAAS,EAAE,EACxH,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAC5B,CAAC;gBACF,IAAI,CAAC,OAAO,CAAC,EAAE;oBAAE,SAAS;gBAC1B,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAA4C,CAAC;gBACnF,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC;gBAE1C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC3B,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,CAAC,IAAI;wBAAE,SAAS;oBACxC,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;wBAAE,SAAS;oBAC5C,IAAI,GAAG,CAAC,EAAE,IAAI,SAAS;wBAAE,SAAS;oBAClC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBAEhG,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;wBAAE,SAAS;oBAC3D,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;oBACjC,IAAI,CAAC,IAAI;wBAAE,SAAS;oBAEpB,MAAM,QAAQ,GAAoB;wBAChC,OAAO,EAAE,IAAI,CAAC,EAAE;wBAChB,MAAM,EAAE,GAAG,CAAC,OAAO;wBACnB,IAAI;wBACJ,IAAI,EAAE;4BACJ,OAAO,EAAE,IAAI,CAAC,EAAE;4BAChB,MAAM,EAAE,GAAG,CAAC,OAAO;4BACnB,OAAO,EAAE,GAAG,CAAC,OAAO;4BACpB,KAAK,EAAE,IAAI,CAAC,KAAK;4BACjB,MAAM,EAAE,IAAI,CAAC,KAAK;4BAClB,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;yBAC1B;wBACD,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;qBAC7D,CAAC;oBACF,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAG,CAAW,CAAC,OAAO,EAAE,EAAE,sBAAsB,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF"}

package/dist/channels/SignalChannel.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SignalChannel — relays Signal messages through a signal-cli daemon.
+ *
+ * signal-cli is an external binary (https://github.com/AsamK/signal-cli)
+ * that handles the Signal protocol. This channel polls its REST daemon
+ * every 2 s for new messages and sends replies via POST /v2/send.
+ *
+ * Setup:
+ *   1. Install signal-cli.
+ *   2. Register + verify your phone number.
+ *   3. Start the daemon:  signal-cli -u +1234567890 daemon --http 127.0.0.1:8080
+ *   4. Provide SIGNAL_CLI_URL and SIGNAL_PHONE_NUMBER.
+ */
+import { BaseChannel, type ChannelMeta, type IncomingMessage } from "./BaseChannel.js";
+export interface SignalChannelOpts {
+    readonly cliUrl: string;
+    readonly phoneNumber: string;
+    readonly allowedUsers?: readonly string[];
+    readonly onMessage: (msg: IncomingMessage) => void;
+}
+export declare class SignalChannel extends BaseChannel {
+    readonly id: "signal";
+    readonly name: "Signal";
+    private readonly cliUrl;
+    private readonly phoneNumber;
+    private readonly allowedUsers;
+    private readonly onMessage;
+    private pollTimer;
+    private running;
+    private readonly inflight;
+    constructor(opts: SignalChannelOpts);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendReply(meta: ChannelMeta, text: string): Promise<void>;
+    isAllowed(userId: string): boolean;
+    private poll;
+    private handleEnvelope;
+}
+//# sourceMappingURL=SignalChannel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SignalChannel.d.ts","sourceRoot":"","sources":["../../src/channels/SignalChannel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAOvF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;CACpD;AAYD,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAChC,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAElC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;gBAElC,IAAI,EAAE,iBAAiB;IAQ7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASZ,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqB/D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;YAO7B,IAAI;IAgBlB,OAAO,CAAC,cAAc;CAkCvB"}