@gamalan/pi-gateway 1.0.0

package/dist/adapters/discord.js

@@ -0,0 +1,224 @@
+/**
+ * Discord Adapter - Hermes-style Discord platform adapter
+ *
+ * Features:
+ * - DM and guild channel support
+ * - Slash command registration
+ * - Typing indicators
+ * - Message editing/deletion
+ * - Rate limit handling
+ */
+import { BaseAdapter } from "./base.js";
+import { logger } from "../logger.js";
+export class DiscordAdapter extends BaseAdapter {
+    platform = "discord";
+    config;
+    httpClient = null;
+    wsConnection = null;
+    heartbeatInterval = null;
+    sequence = null;
+    sessionId = null;
+    intents = 0;
+    constructor(config) {
+        super();
+        this.config = config;
+        // Intents: GUILD_MESSAGES (1<<9) + DIRECT_MESSAGES (1<<12) + MESSAGE_CONTENT (1<<15)
+        this.intents = 1 << 9 | 1 << 12 | 1 << 15;
+    }
+    async initialize() {
+        // Test bot token
+        const response = await this.apiRequest("/users/@me");
+        const data = await response.json();
+        if (!response.ok) {
+            throw new Error(`Discord authentication failed: ${response.status}`);
+        }
+        logger.info(`[Discord] Bot initialized: ${data.username}`);
+    }
+    async apiRequest(endpoint, options = {}) {
+        const url = `https://discord.com/api/v10${endpoint}`;
+        return fetch(url, {
+            ...options,
+            headers: {
+                "Authorization": `Bot ${this.config.botToken}`,
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        });
+    }
+    async start(callbacks) {
+        await super.start(callbacks);
+        // Connect to Gateway
+        const gatewayResponse = await this.apiRequest("/gateway");
+        const gatewayData = (await gatewayResponse.json());
+        const gatewayUrl = `${gatewayData.url}?v=10&encoding=json&intents=${this.intents}`;
+        this.wsConnection = new WebSocket(gatewayUrl);
+        this.wsConnection.onopen = () => {
+            logger.info("[Discord] WebSocket connected");
+        };
+        this.wsConnection.onmessage = async (event) => {
+            const data = JSON.parse(event.data);
+            await this.handleGatewayMessage(data);
+        };
+        this.wsConnection.onclose = () => {
+            logger.info("[Discord] WebSocket closed");
+            this.callbacks?.onDisconnect?.();
+            // Attempt reconnect after 5 seconds
+            setTimeout(() => this.start(callbacks), 5000);
+        };
+    }
+    async handleGatewayMessage(data) {
+        switch (data.op) {
+            case 0: // Dispatch
+                this.sequence = data.s;
+                await this.handleDispatch(data.t, data.d);
+                break;
+            case 10: // Hello
+                this.startHeartbeat(data.d.heartbeat_interval);
+                this.identify();
+                break;
+            case 11: // Heartbeat ACK
+                // Heartbeat acknowledged
+                break;
+        }
+    }
+    startHeartbeat(interval) {
+        this.heartbeatInterval = setInterval(() => {
+            if (this.wsConnection?.readyState === WebSocket.OPEN) {
+                this.wsConnection.send(JSON.stringify({
+                    op: 1,
+                    d: this.sequence,
+                }));
+            }
+        }, interval);
+    }
+    async identify() {
+        const identifyPayload = {
+            op: 2,
+            d: {
+                token: this.config.botToken,
+                intents: this.intents,
+                properties: {
+                    os: "linux",
+                    browser: "pi-gateway",
+                    device: "pi-gateway",
+                },
+            },
+        };
+        this.wsConnection?.send(JSON.stringify(identifyPayload));
+    }
+    async handleDispatch(type, data) {
+        switch (type) {
+            case "READY":
+                this.sessionId = data.session_id;
+                logger.info(`[Discord] Logged in as ${data.user.username}`);
+                break;
+            case "MESSAGE_CREATE":
+                await this.handleMessage(data);
+                break;
+            case "MESSAGE_UPDATE":
+                // Handle edits if needed
+                break;
+        }
+    }
+    async handleMessage(data) {
+        // Ignore bots
+        if (data.author.bot && data.author.id !== this.getBotId())
+            return;
+        // Check if DM or allowed channel
+        const isDM = !data.guild_id;
+        if (!isDM && this.config.allowedChannels?.length) {
+            if (!this.config.allowedChannels.includes(data.channel_id))
+                return;
+        }
+        // Check mention requirement in guilds
+        if (!isDM && this.config.requireMention) {
+            const mentioned = data.content.includes(`<@${this.getBotId()}>`);
+            if (!mentioned)
+                return;
+        }
+        const message = {
+            id: data.id,
+            platform: this.platform,
+            channelId: data.channel_id,
+            userId: data.author.id,
+            content: data.content,
+            timestamp: new Date(data.timestamp).getTime(),
+            metadata: {
+                guildId: data.guild_id,
+                username: data.author.username,
+                discriminator: data.author.discriminator,
+                isDM,
+            },
+        };
+        await this.callbacks?.onMessage(message);
+    }
+    getBotId() {
+        // Extract from token - this is approximate
+        return this.config.botToken.split(".")[0];
+    }
+    async sendMessage(channelId, content) {
+        const response = await this.apiRequest(`/channels/${channelId}/messages`, {
+            method: "POST",
+            body: JSON.stringify({ content }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Failed to send message: ${error}`);
+        }
+        const data = (await response.json());
+        return data.id;
+    }
+    async editMessage(channelId, messageId, content) {
+        await this.apiRequest(`/channels/${channelId}/messages/${messageId}`, {
+            method: "PATCH",
+            body: JSON.stringify({ content }),
+        });
+    }
+    async deleteMessage(channelId, messageId) {
+        await this.apiRequest(`/channels/${channelId}/messages/${messageId}`, {
+            method: "DELETE",
+        });
+    }
+    async setTyping(channelId, isTyping) {
+        if (!isTyping)
+            return; // Discord doesn't have a "stop typing" API
+        await this.apiRequest(`/channels/${channelId}/typing`, {
+            method: "POST",
+        });
+    }
+    async getStatus() {
+        try {
+            const response = await this.apiRequest("/gateway/bot");
+            const data = await response.json();
+            return {
+                connected: true,
+                latency: data.session_start_limit?.remaining ?? undefined,
+            };
+        }
+        catch {
+            return { connected: false };
+        }
+    }
+    async stop() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+        }
+        if (this.wsConnection) {
+            this.wsConnection.close();
+        }
+        await super.stop();
+    }
+    // Helper to register slash commands
+    async registerSlashCommands(commands) {
+        if (!this.config.guildId) {
+            logger.warn("[Discord] guildId required for slash commands");
+            return;
+        }
+        await this.apiRequest(`/applications/${this.getBotId()}/guilds/${this.config.guildId}/commands`, {
+            method: "PUT",
+            body: JSON.stringify(commands),
+        });
+        logger.info(`[Discord] Registered ${commands.length} slash commands`);
+    }
+}
+//# sourceMappingURL=discord.js.map

package/dist/adapters/discord.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord.js","sourceRoot":"","sources":["../../src/adapters/discord.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAA6C,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAWtC,MAAM,OAAO,cAAe,SAAQ,WAAW;IACpC,QAAQ,GAAG,SAAkB,CAAC;IACvC,MAAM,CAAgB;IACd,UAAU,GAAwB,IAAI,CAAC;IACvC,YAAY,GAAqB,IAAI,CAAC;IACtC,iBAAiB,GAA0C,IAAI,CAAC;IAChE,QAAQ,GAAkB,IAAI,CAAC;IAC/B,SAAS,GAAkB,IAAI,CAAC;IAChC,OAAO,GAAW,CAAC,CAAC;IAE5B,YAAY,MAAqB;QAC/B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,qFAAqF;QACrF,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,UAAU;QACd,iBAAiB;QACjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;QACrD,MAAM,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,kCAAkC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,8BAA8B,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7D,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,UAAuB,EAAE;QAClE,MAAM,GAAG,GAAG,8BAA8B,QAAQ,EAAE,CAAC;QACrD,OAAO,KAAK,CAAC,GAAG,EAAE;YAChB,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,eAAe,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;gBAC9C,cAAc,EAAE,kBAAkB;gBAClC,GAAG,OAAO,CAAC,OAAO;aACnB;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,SAAS;QACnB,MAAM,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAE7B,qBAAqB;QACrB,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC1D,MAAM,WAAW,GAAG,CAAC,MAAM,eAAe,CAAC,IAAI,EAAE,CAAoB,CAAC;QACtE,MAAM,UAAU,GAAG,GAAG,WAAW,CAAC,GAAG,+BAA+B,IAAI,CAAC,OAAO,EAAE,CAAC;QAEnF,IAAI,CAAC,YAAY,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC;QAE9C,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,GAAG,EAAE;YAC9B,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,SAAS,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE;YAC5C,MAAM,IAAI,GAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACzC,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,OAAO,GAAG,GAAG,EAAE;YAC/B,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YAC1C,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,CAAC;YACjC,oCAAoC;YACpC,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAC,IAAS;QAC1C,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC;YAChB,KAAK,CAAC,EAAE,WAAW;gBACjB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC;gBACvB,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC1C,MAAM;YAER,KAAK,EAAE,EAAE,QAAQ;gBACf,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;gBAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAChB,MAAM;YAER,KAAK,EAAE,EAAE,gBAAgB;gBACvB,yBAAyB;gBACzB,MAAM;QACV,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,QAAgB;QACrC,IAAI,CAAC,iBAAiB,GAAG,WAAW,CAAC,GAAG,EAAE;YACxC,IAAI,IAAI,CAAC,YAAY,EAAE,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;gBACrD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;oBACpC,EAAE,EAAE,CAAC;oBACL,CAAC,EAAE,IAAI,CAAC,QAAQ;iBACjB,CAAC,CAAC,CAAC;YACN,CAAC;QACH,CAAC,EAAE,QAAQ,CAAC,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,MAAM,eAAe,GAAG;YACtB,EAAE,EAAE,CAAC;YACL,CAAC,EAAE;gBACD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,UAAU,EAAE;oBACV,EAAE,EAAE,OAAO;oBACX,OAAO,EAAE,YAAY;oBACrB,MAAM,EAAE,YAAY;iBACrB;aACF;SACF,CAAC;QAEF,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;IAC3D,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,IAAS;QAClD,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,OAAO;gBACV,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,0BAA0B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC5D,MAAM;YAER,KAAK,gBAAgB;gBACnB,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBAC/B,MAAM;YAER,KAAK,gBAAgB;gBACnB,yBAAyB;gBACzB,MAAM;QACV,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,IAAS;QACnC,cAAc;QACd,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,QAAQ,EAAE;YAAE,OAAO;QAElE,iCAAiC;QACjC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;QAC5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,CAAC;YACjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC;gBAAE,OAAO;QACrE,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACxC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACjE,IAAI,CAAC,SAAS;gBAAE,OAAO;QACzB,CAAC;QAED,MAAM,OAAO,GAAoB;YAC/B,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE;YACtB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;YAC7C,QAAQ,EAAE;gBACR,OAAO,EAAE,IAAI,CAAC,QAAQ;gBACtB,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;gBACxC,IAAI;aACL;SACF,CAAC;QAEF,MAAM,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAEO,QAAQ;QACd,2CAA2C;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,OAAe;QAClD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,SAAS,WAAW,EAAE;YACxE,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmB,CAAC;QACvD,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,SAAiB,EAAE,OAAe;QACrE,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,SAAS,aAAa,SAAS,EAAE,EAAE;YACpE,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;SAClC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,SAAiB;QACtD,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,SAAS,aAAa,SAAS,EAAE,EAAE;YACpE,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,QAAiB;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,2CAA2C;QAElE,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,SAAS,SAAS,EAAE;YACrD,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;YACvD,MAAM,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO;gBACL,SAAS,EAAE,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,IAAI,SAAS;aAC1D,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;QACD,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,qBAAqB,CAAC,QAI1B;QACA,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,UAAU,CAAC,iBAAiB,IAAI,CAAC,QAAQ,EAAE,WAAW,IAAI,CAAC,MAAM,CAAC,OAAO,WAAW,EAAE;YAC/F,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;SAC/B,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,wBAAwB,QAAQ,CAAC,MAAM,iBAAiB,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,13 @@
+export { BaseAdapter, type PlatformMessage, type PlatformConfig, type AdapterCallbacks, type PlatformAdapter } from "./base.js";
+export { DiscordAdapter } from "./discord.js";
+export type { DiscordConfig } from "./discord.js";
+export { TwitchAdapter } from "./twitch.js";
+export type { TwitchConfig } from "./twitch.js";
+export { TelegramAdapter } from "./telegram.js";
+export type { TelegramConfig } from "./telegram.js";
+export { SlackAdapter } from "./slack.js";
+export type { SlackConfig } from "./slack.js";
+export { WhatsAppAdapter } from "./whatsapp.js";
+export type { WhatsAppConfig } from "./whatsapp.js";
+export { WebSocketAdapter } from "./websocket.js";
+export type { WebSocketConfig } from "./websocket.js";

package/dist/adapters/index.js

@@ -0,0 +1,8 @@
+export { BaseAdapter } from "./base.js";
+export { DiscordAdapter } from "./discord.js";
+export { TwitchAdapter } from "./twitch.js";
+export { TelegramAdapter } from "./telegram.js";
+export { SlackAdapter } from "./slack.js";
+export { WhatsAppAdapter } from "./whatsapp.js";
+export { WebSocketAdapter } from "./websocket.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA0F,MAAM,WAAW,CAAC;AAChI,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/adapters/slack.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Slack Adapter - Hermes-style Slack platform adapter
+ *
+ * Features:
+ * - Incoming webhooks (outbound only)
+ * - Web API (with bot token)
+ * - Slash command support
+ * - Block Kit support
+ */
+import { BaseAdapter, type PlatformConfig } from "./base.js";
+export interface SlackConfig extends PlatformConfig {
+    platform: "slack";
+    webhookUrl?: string;
+    botToken?: string;
+    signingSecret?: string;
+    teamId?: string;
+    defaultChannel?: string;
+}
+export declare class SlackAdapter extends BaseAdapter {
+    readonly platform: "slack";
+    config: SlackConfig;
+    private connected;
+    constructor(config: SlackConfig);
+    initialize(): Promise<void>;
+    private apiRequest;
+    start(callbacks: any): Promise<void>;
+    stop(): Promise<void>;
+    sendMessage(channelId: string, content: string): Promise<string>;
+    postMessage(channelId: string, content: string, blocks?: any[]): Promise<string>;
+    replyToThread(channelId: string, threadTs: string, content: string): Promise<string>;
+    editMessage(channelId: string, messageTs: string, content: string): Promise<void>;
+    deleteMessage(channelId: string, messageTs: string): Promise<void>;
+    setTyping(channelId: string, isTyping: boolean): Promise<void>;
+    getChannelInfo(channelId: string): Promise<{
+        id: string;
+        name: string;
+        numMembers: number;
+        topic: string;
+    } | null>;
+    listChannels(): Promise<Array<{
+        id: string;
+        name: string;
+    }>>;
+    getStatus(): Promise<{
+        connected: boolean;
+        latency?: number;
+    }>;
+    handleIncomingEvent(event: any): Promise<void>;
+}

package/dist/adapters/slack.js

@@ -0,0 +1,231 @@
+/**
+ * Slack Adapter - Hermes-style Slack platform adapter
+ *
+ * Features:
+ * - Incoming webhooks (outbound only)
+ * - Web API (with bot token)
+ * - Slash command support
+ * - Block Kit support
+ */
+import { BaseAdapter } from "./base.js";
+import { logger } from "../logger.js";
+export class SlackAdapter extends BaseAdapter {
+    platform = "slack";
+    config;
+    connected = false;
+    constructor(config) {
+        super();
+        this.config = {
+            enabled: true,
+            platform: "slack",
+            ...config,
+        };
+    }
+    async initialize() {
+        if (this.config.botToken) {
+            // Test bot token
+            const response = await this.apiRequest("auth.test", { method: "POST" });
+            const data = await response.json();
+            if (!data.ok) {
+                throw new Error(`Slack auth failed: ${data}`);
+            }
+            logger.info(`[Slack] Bot initialized for team: ${data.team_id}`);
+        }
+        else if (this.config.webhookUrl) {
+            logger.info("[Slack] Using webhook mode (outbound only)");
+        }
+        else {
+            throw new Error("Slack requires either botToken or webhookUrl");
+        }
+    }
+    async apiRequest(endpoint, options = {}) {
+        const url = `https://slack.com/api/${endpoint}`;
+        return fetch(url, {
+            ...options,
+            headers: {
+                "Content-Type": "application/json",
+                "Authorization": `Bearer ${this.config.botToken}`,
+                ...options.headers,
+            },
+        });
+    }
+    async start(callbacks) {
+        await super.start(callbacks);
+        this.connected = true;
+        if (!this.config.botToken && !this.config.webhookUrl) {
+            logger.warn("[Slack] No credentials configured - adapter is outbound-only");
+        }
+    }
+    async stop() {
+        this.connected = false;
+        await super.stop();
+    }
+    async sendMessage(channelId, content) {
+        // Try webhook first if available
+        if (this.config.webhookUrl) {
+            const payload = {
+                text: content,
+                ...(channelId && channelId.startsWith("#") ? { channel: channelId } : {}),
+            };
+            const response = await fetch(this.config.webhookUrl, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify(payload),
+            });
+            if (!response.ok) {
+                throw new Error(`Slack webhook failed: ${response.status}`);
+            }
+            return `webhook-${Date.now()}`;
+        }
+        // Use Web API if we have a bot token
+        if (this.config.botToken) {
+            const response = await this.apiRequest("chat.postMessage", {
+                method: "POST",
+                body: JSON.stringify({
+                    channel: channelId,
+                    text: content,
+                }),
+            });
+            const data = await response.json();
+            if (!data.ok) {
+                throw new Error(`Slack API error: ${data.error}`);
+            }
+            return data.ts || String(Date.now());
+        }
+        throw new Error("No Slack credentials configured");
+    }
+    async postMessage(channelId, content, blocks) {
+        if (!this.config.botToken) {
+            throw new Error("Bot token required for rich messages");
+        }
+        const body = {
+            channel: channelId,
+            text: content,
+        };
+        if (blocks) {
+            body.blocks = blocks;
+        }
+        const response = await this.apiRequest("chat.postMessage", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        const data = await response.json();
+        if (!data.ok) {
+            throw new Error(`Slack API error: ${data.error}`);
+        }
+        return data.ts || String(Date.now());
+    }
+    async replyToThread(channelId, threadTs, content) {
+        if (!this.config.botToken) {
+            throw new Error("Bot token required for threaded replies");
+        }
+        const response = await this.apiRequest("chat.postMessage", {
+            method: "POST",
+            body: JSON.stringify({
+                channel: channelId,
+                text: content,
+                thread_ts: threadTs,
+            }),
+        });
+        const data = await response.json();
+        if (!data.ok) {
+            throw new Error(`Slack API error: ${data.error}`);
+        }
+        return data.ts || String(Date.now());
+    }
+    async editMessage(channelId, messageTs, content) {
+        if (!this.config.botToken) {
+            throw new Error("Bot token required for editing");
+        }
+        await this.apiRequest("chat.update", {
+            method: "POST",
+            body: JSON.stringify({
+                channel: channelId,
+                ts: messageTs,
+                text: content,
+            }),
+        });
+    }
+    async deleteMessage(channelId, messageTs) {
+        if (!this.config.botToken) {
+            throw new Error("Bot token required for deletion");
+        }
+        await this.apiRequest("chat.delete", {
+            method: "POST",
+            body: JSON.stringify({
+                channel: channelId,
+                ts: messageTs,
+            }),
+        });
+    }
+    async setTyping(channelId, isTyping) {
+        if (!this.config.botToken)
+            return;
+        await this.apiRequest("chat.postEphemeral", {
+            method: "POST",
+            body: JSON.stringify({
+                channel: channelId,
+                text: isTyping ? "_typing_" : "",
+            }),
+        });
+    }
+    async getChannelInfo(channelId) {
+        if (!this.config.botToken) {
+            throw new Error("Bot token required");
+        }
+        const response = await this.apiRequest("conversations.info", {
+            method: "POST",
+            body: JSON.stringify({ channel: channelId }),
+        });
+        const data = await response.json();
+        if (!data.ok || !data.channel) {
+            return null;
+        }
+        return {
+            id: data.channel.id,
+            name: data.channel.name,
+            numMembers: data.channel.num_members,
+            topic: data.channel.topic?.value || "",
+        };
+    }
+    async listChannels() {
+        if (!this.config.botToken) {
+            throw new Error("Bot token required");
+        }
+        const response = await this.apiRequest("conversations.list", {
+            method: "POST",
+            body: JSON.stringify({ types: "public_channel,private_channel" }),
+        });
+        const data = await response.json();
+        if (!data.ok) {
+            return [];
+        }
+        return (data.channels || []).map(c => ({ id: c.id, name: c.name }));
+    }
+    async getStatus() {
+        return {
+            connected: this.connected,
+            ...(this.config.botToken ? { mode: "api" } : { mode: "webhook" })
+        };
+    }
+    // Handle incoming events (for WebSocket or Socket Mode)
+    async handleIncomingEvent(event) {
+        if (event.type === "message" && !event.subtype) {
+            const message = {
+                id: this.generateMessageId(),
+                platform: "slack",
+                channelId: event.channel,
+                userId: event.user,
+                content: event.text,
+                timestamp: parseFloat(event.ts) * 1000,
+                metadata: {
+                    team: event.team,
+                    threadTs: event.thread_ts,
+                    username: event.username,
+                },
+            };
+            this.emitMessage(message);
+        }
+    }
+}
+//# sourceMappingURL=slack.js.map

package/dist/adapters/slack.js.map

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

package/dist/adapters/telegram.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Telegram Adapter - Hermes-style Telegram platform adapter
+ *
+ * Features:
+ * - Polling and webhook modes
+ * - DM and group chat support
+ * - Inline queries
+ * - Callback buttons
+ */
+import { BaseAdapter, type PlatformConfig } from "./base.js";
+interface TelegramConfig extends PlatformConfig {
+    platform: "telegram";
+    token: string;
+    /** Public URL Telegram sends updates to (e.g. https://example.com/webhook/telegram).
+     *  When set, webhook mode is used. When omitted, long polling is used. */
+    webhookUrl?: string;
+    webhookSecret?: string;
+    allowedChats?: string[];
+    requireUsername?: boolean;
+}
+export type { TelegramConfig };
+export declare class TelegramAdapter extends BaseAdapter {
+    readonly platform: "telegram";
+    config: TelegramConfig;
+    private offset;
+    private pollingActive;
+    private connected;
+    constructor(config: TelegramConfig);
+    initialize(): Promise<void>;
+    private apiRequest;
+    start(callbacks: any): Promise<void>;
+    /**
+     * Long polling via getUpdates.
+     *
+     * Telegram holds the connection open (up to `timeout` seconds) and
+     * returns immediately when a message arrives. This is NOT interval-
+     * based polling — it is near-real-time, similar to a persistent
+     * connection. Used as a fallback when no webhookUrl is configured.
+     */
+    private startLongPolling;
+    private longPoll;
+    private handleUpdate;
+    private sleep;
+    stop(): Promise<void>;
+    sendMessage(channelId: string, content: string): Promise<string>;
+    sendPhoto(channelId: string, photoUrl: string, caption?: string): Promise<string>;
+    sendButtons(channelId: string, text: string, buttons: Array<Array<{
+        text: string;
+        data: string;
+    }>>): Promise<string>;
+    editMessage(channelId: string, messageId: string, content: string): Promise<void>;
+    deleteMessage(channelId: string, messageId: string): Promise<void>;
+    setTyping(channelId: string, isTyping: boolean): Promise<void>;
+    getStatus(): Promise<{
+        connected: boolean;
+        latency?: number;
+    }>;
+    getMe(): Promise<{
+        id: number;
+        username: string;
+        first_name: string;
+    }>;
+    handleWebhookUpdate(update: any): Promise<void>;
+}