@mce-bt/microagents-channels 0.1.0

package/dist/adapters/slack.d.ts

@@ -0,0 +1,32 @@
+import { type LogLevel } from '@slack/bolt';
+import { type Channel, type ChannelConfig } from '../channel.js';
+export interface SlackChannelConfig extends ChannelConfig {
+    /** Slack Bot Token (xoxb-...) */
+    botToken: string;
+    /** Slack App-Level Token (xapp-...) for Socket Mode */
+    appToken: string;
+    /** Slack Signing Secret */
+    signingSecret: string;
+    /** Port for Slack HTTP receiver (if not using socket mode) */
+    port?: number;
+    /** Log level for Slack Bolt */
+    logLevel?: LogLevel;
+}
+/**
+ * Slack channel adapter.
+ *
+ * Uses Slack Bolt SDK in Socket Mode to receive messages and forward them
+ * to the agent via AG-UI. Responses are posted back to the Slack channel/thread.
+ */
+export declare class SlackChannel implements Channel {
+    readonly type = "slack";
+    private app;
+    private config;
+    /** Map Slack thread_ts → agent session ID */
+    private threadSessions;
+    constructor(config: SlackChannelConfig);
+    private registerHandlers;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=slack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../src/adapters/slack.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAwB,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEvF,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IAEjB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IAEjB,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IAEtB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,OAAO;IAC1C,QAAQ,CAAC,IAAI,WAAW;IAExB,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,MAAM,CAAqB;IAEnC,6CAA6C;IAC7C,OAAO,CAAC,cAAc,CAA6B;gBAEvC,MAAM,EAAE,kBAAkB;IAetC,OAAO,CAAC,gBAAgB;IAqFlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAI5B"}

package/dist/adapters/slack.js

@@ -0,0 +1,108 @@
+import { App as SlackApp } from '@slack/bolt';
+import { randomUUID } from 'node:crypto';
+import { collectAgentResponse } from '../channel.js';
+/**
+ * Slack channel adapter.
+ *
+ * Uses Slack Bolt SDK in Socket Mode to receive messages and forward them
+ * to the agent via AG-UI. Responses are posted back to the Slack channel/thread.
+ */
+export class SlackChannel {
+    type = 'slack';
+    app;
+    config;
+    /** Map Slack thread_ts → agent session ID */
+    threadSessions = new Map();
+    constructor(config) {
+        this.config = config;
+        this.app = new SlackApp({
+            token: config.botToken,
+            appToken: config.appToken,
+            signingSecret: config.signingSecret,
+            socketMode: true,
+            port: config.port,
+            logLevel: config.logLevel,
+        });
+        this.registerHandlers();
+    }
+    registerHandlers() {
+        // Listen for direct messages and @mentions
+        this.app.event('message', async ({ event, say }) => {
+            // Skip bot messages to prevent loops
+            if ('bot_id' in event)
+                return;
+            if (!('text' in event) || !event.text)
+                return;
+            const threadTs = ('thread_ts' in event ? event.thread_ts : event.ts);
+            const text = event.text;
+            // Get or create session for this thread
+            let sessionId = this.threadSessions.get(threadTs);
+            if (!sessionId) {
+                sessionId = randomUUID();
+                this.threadSessions.set(threadTs, sessionId);
+            }
+            try {
+                const { text: responseText } = await collectAgentResponse(this.config.agentUrl, {
+                    threadId: threadTs,
+                    runId: randomUUID(),
+                    message: text,
+                    sessionId,
+                }, {
+                    sharedSecret: this.config.sharedSecret,
+                    agentId: 'slack-channel',
+                });
+                if (responseText) {
+                    await say({ text: responseText, thread_ts: threadTs });
+                }
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                await say({
+                    text: `⚠️ Error: ${errorMsg}`,
+                    thread_ts: threadTs,
+                });
+            }
+        });
+        // Listen for app mentions
+        this.app.event('app_mention', async ({ event, say }) => {
+            const threadTs = event.thread_ts ?? event.ts;
+            const text = event.text.replace(/<@[A-Z0-9]+>/g, '').trim();
+            if (!text)
+                return;
+            let sessionId = this.threadSessions.get(threadTs);
+            if (!sessionId) {
+                sessionId = randomUUID();
+                this.threadSessions.set(threadTs, sessionId);
+            }
+            try {
+                const { text: responseText } = await collectAgentResponse(this.config.agentUrl, {
+                    threadId: threadTs,
+                    runId: randomUUID(),
+                    message: text,
+                    sessionId,
+                }, {
+                    sharedSecret: this.config.sharedSecret,
+                    agentId: 'slack-channel',
+                });
+                if (responseText) {
+                    await say({ text: responseText, thread_ts: threadTs });
+                }
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                await say({
+                    text: `⚠️ Error: ${errorMsg}`,
+                    thread_ts: threadTs,
+                });
+            }
+        });
+    }
+    async start() {
+        await this.app.start();
+    }
+    async stop() {
+        await this.app.stop();
+        this.threadSessions.clear();
+    }
+}
+//# 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,52 @@
+import { type Channel, type ChannelConfig, type MediaPayload } from '../channel.js';
+export interface TelegramChannelConfig extends ChannelConfig {
+    /** Telegram Bot API token from @BotFather */
+    botToken: string;
+    /** Allowed chat IDs (for security). If empty, all chats are allowed. */
+    allowedChatIds?: number[];
+}
+/**
+ * Telegram channel adapter.
+ *
+ * Uses Grammy SDK to receive messages and forward them to the agent via AG-UI.
+ * Responses are sent back as Telegram messages.
+ */
+export declare class TelegramChannel implements Channel {
+    readonly type = "telegram";
+    private bot;
+    private config;
+    /** Map Telegram chat ID → agent session ID */
+    private chatSessions;
+    constructor(config: TelegramChannelConfig);
+    private isAllowed;
+    private getOrCreateSession;
+    /**
+     * Download a Telegram file by file_id and return as base64.
+     */
+    private downloadFile;
+    /**
+     * Send the agent response back — text in chunks with Markdown fallback.
+     */
+    private sendReply;
+    /**
+     * Common handler for forwarding a message (text or multimodal) to the agent.
+     */
+    private forwardToAgent;
+    private registerHandlers;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Get all known chat IDs (from active sessions + allowedChatIds).
+     */
+    getActiveChatIds(): number[];
+    /**
+     * Send a proactive message to all known chat sessions.
+     * Falls back to allowedChatIds if no sessions have been started yet.
+     */
+    sendMessage(text: string): Promise<void>;
+    /**
+     * Send media to all known chat sessions.
+     */
+    sendMedia(media: MediaPayload): Promise<void>;
+}
+//# sourceMappingURL=telegram.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/adapters/telegram.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAM1G,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IAEjB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,QAAQ,CAAC,IAAI,cAAc;IAE3B,OAAO,CAAC,GAAG,CAAM;IACjB,OAAO,CAAC,MAAM,CAAwB;IAEtC,8CAA8C;IAC9C,OAAO,CAAC,YAAY,CAA6B;gBAErC,MAAM,EAAE,qBAAqB;IAMzC,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;YACW,YAAY;IAiB1B;;OAEG;YACW,SAAS;IAYvB;;OAEG;YACW,cAAc;IA4B5B,OAAO,CAAC,gBAAgB;IAmKlB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;OAEG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAa5B;;;OAGG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9C;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BpD"}

package/dist/adapters/telegram.js

@@ -0,0 +1,317 @@
+import { Bot, InputFile } from 'grammy';
+import { randomUUID } from 'node:crypto';
+import { collectAgentResponse } from '../channel.js';
+/** Max file size for base64 download (10 MB) */
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+/**
+ * Telegram channel adapter.
+ *
+ * Uses Grammy SDK to receive messages and forward them to the agent via AG-UI.
+ * Responses are sent back as Telegram messages.
+ */
+export class TelegramChannel {
+    type = 'telegram';
+    bot;
+    config;
+    /** Map Telegram chat ID → agent session ID */
+    chatSessions = new Map();
+    constructor(config) {
+        this.config = config;
+        this.bot = new Bot(config.botToken);
+        this.registerHandlers();
+    }
+    isAllowed(chatId) {
+        if (!this.config.allowedChatIds || this.config.allowedChatIds.length === 0) {
+            return true;
+        }
+        return this.config.allowedChatIds.includes(chatId);
+    }
+    getOrCreateSession(chatId) {
+        let sessionId = this.chatSessions.get(chatId);
+        if (!sessionId) {
+            sessionId = randomUUID();
+            this.chatSessions.set(chatId, sessionId);
+        }
+        return sessionId;
+    }
+    /**
+     * Download a Telegram file by file_id and return as base64.
+     */
+    async downloadFile(fileId) {
+        const file = await this.bot.api.getFile(fileId);
+        const filePath = file.file_path;
+        if (!filePath)
+            throw new Error('File path not available');
+        if (file.file_size && file.file_size > MAX_FILE_SIZE) {
+            throw new Error(`File too large (${(file.file_size / 1024 / 1024).toFixed(1)} MB). Max: ${MAX_FILE_SIZE / 1024 / 1024} MB.`);
+        }
+        const url = `https://api.telegram.org/file/bot${this.config.botToken}/${filePath}`;
+        const response = await fetch(url);
+        if (!response.ok)
+            throw new Error(`Failed to download file: HTTP ${response.status}`);
+        const buffer = Buffer.from(await response.arrayBuffer());
+        return { data: buffer.toString('base64'), size: buffer.length };
+    }
+    /**
+     * Send the agent response back — text in chunks with Markdown fallback.
+     */
+    async sendReply(chatId, text, ctx) {
+        const maxLen = 4096;
+        for (let i = 0; i < text.length; i += maxLen) {
+            const chunk = text.slice(i, i + maxLen);
+            try {
+                await ctx.reply(chunk, { parse_mode: 'Markdown' });
+            }
+            catch {
+                await ctx.reply(chunk);
+            }
+        }
+    }
+    /**
+     * Common handler for forwarding a message (text or multimodal) to the agent.
+     */
+    async forwardToAgent(chatId, message, ctx) {
+        const sessionId = this.getOrCreateSession(chatId);
+        const { text: responseText } = await collectAgentResponse(this.config.agentUrl, {
+            threadId: String(chatId),
+            runId: randomUUID(),
+            message,
+            sessionId,
+        }, {
+            sharedSecret: this.config.sharedSecret,
+            agentId: 'telegram-channel',
+        });
+        if (responseText) {
+            await this.sendReply(chatId, responseText, ctx);
+        }
+        else {
+            await ctx.reply('⚠️ No response from agent.');
+        }
+    }
+    registerHandlers() {
+        // /start command
+        this.bot.command('start', async (ctx) => {
+            await ctx.reply('👋 Hello! Send me a message and I\'ll forward it to the agent.');
+        });
+        // /newsession command — reset thread session
+        this.bot.command('newsession', async (ctx) => {
+            this.chatSessions.delete(ctx.chat.id);
+            await ctx.reply('🔄 New session started.');
+        });
+        // /chatid command — show the user's chat ID
+        this.bot.command('chatid', async (ctx) => {
+            await ctx.reply(`Your chat ID is: \`${ctx.chat.id}\``, { parse_mode: 'Markdown' });
+        });
+        // Handle text messages
+        this.bot.on('message:text', async (ctx) => {
+            const chatId = ctx.chat.id;
+            if (!this.isAllowed(chatId))
+                return;
+            try {
+                await ctx.api.sendChatAction(chatId, 'typing');
+                await this.forwardToAgent(chatId, ctx.message.text, ctx);
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                await ctx.reply(`⚠️ Error: ${errorMsg}`);
+            }
+        });
+        // Handle photo messages
+        this.bot.on('message:photo', async (ctx) => {
+            const chatId = ctx.chat.id;
+            if (!this.isAllowed(chatId))
+                return;
+            try {
+                await ctx.api.sendChatAction(chatId, 'typing');
+                // Get the largest photo (last in array)
+                const photos = ctx.message.photo;
+                const largest = photos[photos.length - 1];
+                const { data } = await this.downloadFile(largest.file_id);
+                const parts = [];
+                if (ctx.message.caption) {
+                    parts.push({ type: 'text', text: ctx.message.caption });
+                }
+                parts.push({ type: 'image', mimeType: 'image/jpeg', data });
+                await this.forwardToAgent(chatId, parts, ctx);
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                await ctx.reply(`⚠️ Error: ${errorMsg}`);
+            }
+        });
+        // Handle document messages
+        this.bot.on('message:document', async (ctx) => {
+            const chatId = ctx.chat.id;
+            if (!this.isAllowed(chatId))
+                return;
+            try {
+                await ctx.api.sendChatAction(chatId, 'upload_document');
+                const doc = ctx.message.document;
+                const { data } = await this.downloadFile(doc.file_id);
+                const mimeType = doc.mime_type ?? 'application/octet-stream';
+                const name = doc.file_name ?? 'document';
+                const parts = [];
+                if (ctx.message.caption) {
+                    parts.push({ type: 'text', text: ctx.message.caption });
+                }
+                // If the document is an image, send as image content part
+                if (mimeType.startsWith('image/')) {
+                    parts.push({ type: 'image', mimeType, data });
+                }
+                else {
+                    parts.push({ type: 'file', mimeType, data, name });
+                }
+                await this.forwardToAgent(chatId, parts, ctx);
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                await ctx.reply(`⚠️ Error: ${errorMsg}`);
+            }
+        });
+        // Handle voice messages
+        this.bot.on('message:voice', async (ctx) => {
+            const chatId = ctx.chat.id;
+            if (!this.isAllowed(chatId))
+                return;
+            try {
+                await ctx.api.sendChatAction(chatId, 'typing');
+                const voice = ctx.message.voice;
+                const { data } = await this.downloadFile(voice.file_id);
+                const parts = [];
+                if (ctx.message.caption) {
+                    parts.push({ type: 'text', text: ctx.message.caption });
+                }
+                parts.push({ type: 'audio', mimeType: voice.mime_type ?? 'audio/ogg', data });
+                await this.forwardToAgent(chatId, parts, ctx);
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                await ctx.reply(`⚠️ Error: ${errorMsg}`);
+            }
+        });
+        // Handle audio messages
+        this.bot.on('message:audio', async (ctx) => {
+            const chatId = ctx.chat.id;
+            if (!this.isAllowed(chatId))
+                return;
+            try {
+                await ctx.api.sendChatAction(chatId, 'typing');
+                const audio = ctx.message.audio;
+                const { data } = await this.downloadFile(audio.file_id);
+                const parts = [];
+                if (ctx.message.caption) {
+                    parts.push({ type: 'text', text: ctx.message.caption });
+                }
+                parts.push({ type: 'audio', mimeType: audio.mime_type ?? 'audio/mpeg', data });
+                await this.forwardToAgent(chatId, parts, ctx);
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                await ctx.reply(`⚠️ Error: ${errorMsg}`);
+            }
+        });
+        // Handle video messages
+        this.bot.on('message:video', async (ctx) => {
+            const chatId = ctx.chat.id;
+            if (!this.isAllowed(chatId))
+                return;
+            try {
+                await ctx.api.sendChatAction(chatId, 'upload_video');
+                const video = ctx.message.video;
+                const { data } = await this.downloadFile(video.file_id);
+                const mimeType = video.mime_type ?? 'video/mp4';
+                const parts = [];
+                if (ctx.message.caption) {
+                    parts.push({ type: 'text', text: ctx.message.caption });
+                }
+                parts.push({ type: 'file', mimeType, data, name: `video.${mimeType.split('/')[1] ?? 'mp4'}` });
+                await this.forwardToAgent(chatId, parts, ctx);
+            }
+            catch (err) {
+                const errorMsg = err instanceof Error ? err.message : String(err);
+                await ctx.reply(`⚠️ Error: ${errorMsg}`);
+            }
+        });
+    }
+    async start() {
+        // Start long-polling
+        void this.bot.start({
+            onStart: () => {
+                // Bot started
+            },
+        });
+    }
+    async stop() {
+        this.bot.stop();
+        this.chatSessions.clear();
+    }
+    /**
+     * Get all known chat IDs (from active sessions + allowedChatIds).
+     */
+    getActiveChatIds() {
+        const chatIds = new Set();
+        for (const chatId of this.chatSessions.keys()) {
+            chatIds.add(chatId);
+        }
+        if (this.config.allowedChatIds) {
+            for (const chatId of this.config.allowedChatIds) {
+                chatIds.add(chatId);
+            }
+        }
+        return Array.from(chatIds);
+    }
+    /**
+     * Send a proactive message to all known chat sessions.
+     * Falls back to allowedChatIds if no sessions have been started yet.
+     */
+    async sendMessage(text) {
+        const chatIds = this.getActiveChatIds();
+        const maxLen = 4096;
+        for (const chatId of chatIds) {
+            for (let i = 0; i < text.length; i += maxLen) {
+                const chunk = text.slice(i, i + maxLen);
+                try {
+                    await this.bot.api.sendMessage(chatId, chunk, {
+                        parse_mode: 'Markdown',
+                    });
+                }
+                catch {
+                    // Markdown parse failed — retry without formatting
+                    await this.bot.api.sendMessage(chatId, chunk);
+                }
+            }
+        }
+    }
+    /**
+     * Send media to all known chat sessions.
+     */
+    async sendMedia(media) {
+        const chatIds = this.getActiveChatIds();
+        const buf = Buffer.from(media.data, 'base64');
+        for (const chatId of chatIds) {
+            switch (media.type) {
+                case 'photo':
+                    await this.bot.api.sendPhoto(chatId, new InputFile(buf, media.name ?? 'photo.jpg'), {
+                        caption: media.caption,
+                    });
+                    break;
+                case 'document':
+                    await this.bot.api.sendDocument(chatId, new InputFile(buf, media.name ?? 'document'), {
+                        caption: media.caption,
+                    });
+                    break;
+                case 'voice':
+                    await this.bot.api.sendVoice(chatId, new InputFile(buf, media.name ?? 'voice.ogg'), {
+                        caption: media.caption,
+                    });
+                    break;
+                case 'audio':
+                    await this.bot.api.sendAudio(chatId, new InputFile(buf, media.name ?? 'audio.mp3'), {
+                        caption: media.caption,
+                    });
+                    break;
+            }
+        }
+    }
+}
+//# sourceMappingURL=telegram.js.map

package/dist/adapters/telegram.js.map

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

package/dist/adapters/webhook.d.ts

@@ -0,0 +1,31 @@
+import { type Channel, type ChannelConfig } from '../channel.js';
+export interface WebhookChannelConfig extends ChannelConfig {
+    /** Port to listen on for incoming webhooks */
+    port: number;
+    /** Host to bind to */
+    host?: string;
+    /** Optional secret to validate incoming webhook requests */
+    webhookSecret?: string;
+    /** Path for the webhook endpoint */
+    path?: string;
+}
+/**
+ * Webhook channel adapter.
+ *
+ * Exposes an HTTP endpoint that receives messages via POST requests and forwards
+ * them to the agent. Useful for custom integrations, n8n, Zapier, etc.
+ *
+ * Request body: { "message": "...", "threadId"?: "...", "sessionId"?: "...", "metadata"?: {...} }
+ * Response body: { "response": "...", "toolCalls": [...], "sessionId": "..." }
+ */
+export declare class WebhookChannel implements Channel {
+    readonly type = "webhook";
+    private server;
+    private config;
+    /** Map thread IDs → session IDs */
+    private threadSessions;
+    constructor(config: WebhookChannelConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=webhook.d.ts.map

package/dist/adapters/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/adapters/webhook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAEvF,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,OAAO;IAC5C,QAAQ,CAAC,IAAI,aAAa;IAE1B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAuB;IAErC,mCAAmC;IACnC,OAAO,CAAC,cAAc,CAA6B;gBAEvC,MAAM,EAAE,oBAAoB;IAIlC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmFtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAS5B"}

package/dist/adapters/webhook.js

@@ -0,0 +1,115 @@
+import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { collectAgentResponse } from '../channel.js';
+/**
+ * Webhook channel adapter.
+ *
+ * Exposes an HTTP endpoint that receives messages via POST requests and forwards
+ * them to the agent. Useful for custom integrations, n8n, Zapier, etc.
+ *
+ * Request body: { "message": "...", "threadId"?: "...", "sessionId"?: "...", "metadata"?: {...} }
+ * Response body: { "response": "...", "toolCalls": [...], "sessionId": "..." }
+ */
+export class WebhookChannel {
+    type = 'webhook';
+    server = null;
+    config;
+    /** Map thread IDs → session IDs */
+    threadSessions = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    async start() {
+        const webhookPath = this.config.path ?? '/webhook';
+        this.server = createServer(async (req, res) => {
+            // Only accept POST to the webhook path
+            if (req.method !== 'POST' || req.url !== webhookPath) {
+                res.writeHead(404, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Not found' }));
+                return;
+            }
+            // Validate webhook secret
+            if (this.config.webhookSecret) {
+                const providedSecret = req.headers['x-webhook-secret'];
+                if (providedSecret !== this.config.webhookSecret) {
+                    res.writeHead(401, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Unauthorized' }));
+                    return;
+                }
+            }
+            try {
+                const body = await readBody(req);
+                const parsed = JSON.parse(body);
+                if (!parsed.message) {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Missing "message" field' }));
+                    return;
+                }
+                const threadId = parsed.threadId ?? randomUUID();
+                // Get or create session
+                let sessionId = parsed.sessionId;
+                if (!sessionId) {
+                    sessionId = this.threadSessions.get(threadId);
+                    if (!sessionId) {
+                        sessionId = randomUUID();
+                        this.threadSessions.set(threadId, sessionId);
+                    }
+                }
+                const result = await collectAgentResponse(this.config.agentUrl, {
+                    threadId,
+                    runId: randomUUID(),
+                    message: parsed.message,
+                    sessionId,
+                }, {
+                    sharedSecret: this.config.sharedSecret,
+                    agentId: 'webhook-channel',
+                });
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    response: result.text,
+                    toolCalls: result.toolCalls,
+                    threadId,
+                    sessionId,
+                }));
+            }
+            catch (err) {
+                res.writeHead(500, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    error: err instanceof Error ? err.message : String(err),
+                }));
+            }
+        });
+        const host = this.config.host ?? '0.0.0.0';
+        await new Promise((resolve) => {
+            this.server.listen(this.config.port, host, () => resolve());
+        });
+    }
+    async stop() {
+        if (this.server) {
+            await new Promise((resolve, reject) => {
+                this.server.close((err) => (err ? reject(err) : resolve()));
+            });
+            this.server = null;
+        }
+        this.threadSessions.clear();
+    }
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        const maxSize = 1024 * 1024; // 1MB limit
+        req.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > maxSize) {
+                req.destroy();
+                reject(new Error('Request body too large'));
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+        req.on('error', reject);
+    });
+}
+//# sourceMappingURL=webhook.js.map

package/dist/adapters/webhook.js.map

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

package/dist/channel.d.ts

@@ -0,0 +1,62 @@
+import type { MessageContent } from '@mce-bt/microagents-core';
+/**
+ * Media payload for sending media to a channel.
+ */
+export interface MediaPayload {
+    type: 'photo' | 'document' | 'voice' | 'audio';
+    /** Base64-encoded data or URL */
+    data: string;
+    mimeType: string;
+    /** Filename (for documents) */
+    name?: string;
+    /** Caption text */
+    caption?: string;
+}
+/**
+ * Abstract channel interface.
+ *
+ * A channel bridges an external messaging platform to an agent's AG-UI endpoint.
+ * It receives messages from the platform, forwards them to the agent, and streams
+ * the agent's response back to the platform.
+ */
+export interface Channel {
+    /** Unique channel type name (e.g., 'slack', 'telegram', 'webhook') */
+    readonly type: string;
+    /** Start the channel — connect to the platform and begin listening */
+    start(): Promise<void>;
+    /** Stop the channel gracefully */
+    stop(): Promise<void>;
+    /** Send a proactive message to all active chats (optional) */
+    sendMessage?(text: string): Promise<void>;
+    /** Send media to all active chats (optional) */
+    sendMedia?(media: MediaPayload): Promise<void>;
+}
+/**
+ * Configuration shared across all channel adapters.
+ */
+export interface ChannelConfig {
+    /** The agent's HTTP base URL (e.g., http://localhost:3000) */
+    agentUrl: string;
+    /** Shared secret for agent authentication */
+    sharedSecret?: string;
+}
+/**
+ * Helper: call the agent's AG-UI endpoint and collect the full text response.
+ *
+ * Channels typically don't stream to the user (most platforms don't support SSE),
+ * so this helper collects the full response text from the AG-UI event stream.
+ */
+export declare function collectAgentResponse(agentUrl: string, input: {
+    threadId: string;
+    runId: string;
+    message: MessageContent;
+    sessionId?: string;
+}, options?: {
+    sharedSecret?: string;
+    agentId?: string;
+    headers?: Record<string, string>;
+}): Promise<{
+    text: string;
+    toolCalls: string[];
+}>;
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAe,MAAM,0BAA0B,CAAC;AAGvF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;IAC/C,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,sEAAsE;IACtE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,kCAAkC;IAClC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,8DAA8D;IAC9D,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,gDAAgD;IAChD,SAAS,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IAEjB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,EACD,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,GACA,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA2EhD"}

package/dist/channel.js

@@ -0,0 +1,79 @@
+import { createHmac } from 'node:crypto';
+/**
+ * Helper: call the agent's AG-UI endpoint and collect the full text response.
+ *
+ * Channels typically don't stream to the user (most platforms don't support SSE),
+ * so this helper collects the full response text from the AG-UI event stream.
+ */
+export async function collectAgentResponse(agentUrl, input, options) {
+    const url = `${agentUrl}/ag-ui/runs`;
+    const body = JSON.stringify(input);
+    const headers = {
+        'Content-Type': 'application/json',
+        ...options?.headers,
+    };
+    if (options?.sharedSecret) {
+        const timestamp = Date.now().toString();
+        const signature = createHmac('sha256', options.sharedSecret)
+            .update(`${timestamp}.${body}`)
+            .digest('hex');
+        headers['X-Agent-Id'] = options.agentId ?? 'channel-client';
+        headers['X-Timestamp'] = timestamp;
+        headers['X-Signature'] = signature;
+    }
+    const response = await fetch(url, {
+        method: 'POST',
+        headers,
+        body,
+    });
+    if (!response.ok) {
+        throw new Error(`Agent request failed: HTTP ${response.status}`);
+    }
+    if (!response.body) {
+        throw new Error('No response body');
+    }
+    let text = '';
+    const toolCalls = [];
+    const reader = response.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            const lines = buffer.split('\n');
+            buffer = lines.pop() ?? '';
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed || !trimmed.startsWith('data: '))
+                    continue;
+                try {
+                    const event = JSON.parse(trimmed.slice(6));
+                    if (event.type === 'TEXT_MESSAGE_CONTENT') {
+                        text += event.delta;
+                    }
+                    else if (event.type === 'TOOL_CALL_START') {
+                        toolCalls.push(event.toolCallName);
+                    }
+                    else if (event.type === 'RUN_ERROR') {
+                        const errorMsg = event.message ?? 'Unknown agent error';
+                        throw new Error(`Agent error: ${errorMsg}`);
+                    }
+                }
+                catch (parseErr) {
+                    // Re-throw agent errors, skip parse errors
+                    if (parseErr instanceof Error && parseErr.message.startsWith('Agent error:')) {
+                        throw parseErr;
+                    }
+                }
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return { text, toolCalls };
+}
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { type Channel, type ChannelConfig, type MediaPayload, collectAgentResponse, } from './channel.js';
+export { SlackChannel, type SlackChannelConfig, } from './adapters/slack.js';
+export { TelegramChannel, type TelegramChannelConfig, } from './adapters/telegram.js';
+export { WebhookChannel, type WebhookChannelConfig, } from './adapters/webhook.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,GAC1B,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { collectAgentResponse, } from './channel.js';
+export { SlackChannel, } from './adapters/slack.js';
+export { TelegramChannel, } from './adapters/telegram.js';
+export { WebhookChannel, } from './adapters/webhook.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,GAEb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,GAEhB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,cAAc,GAEf,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@mce-bt/microagents-channels",
+  "version": "0.1.0",
+  "description": "Channel integrations — Slack, Telegram, Webhook",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "test": "vitest run --passWithNoTests"
+  },
+  "dependencies": {
+    "@mce-bt/microagents-core": "^0.1.0",
+    "@slack/bolt": "^4.3.0",
+    "grammy": "^1.35.0"
+  },
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cavillo/microagents.git",
+    "directory": "packages/channels"
+  },
+  "homepage": "https://github.com/cavillo/microagents#readme",
+  "bugs": {
+    "url": "https://github.com/cavillo/microagents/issues"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  }
+}