@agent-native/core 0.4.5 → 0.6.1

package/dist/integrations/adapters/slack.js

@@ -0,0 +1,215 @@
+import { getHeader } from "h3";
+import { readBody } from "../../server/h3-helpers.js";
+/** Slack's max message length */
+const SLACK_MAX_LENGTH = 4000;
+/**
+ * Create a Slack platform adapter.
+ *
+ * Required env vars:
+ * - SLACK_BOT_TOKEN — Bot user OAuth token (xoxb-...)
+ * - SLACK_SIGNING_SECRET — Used to verify webhook signatures
+ */
+export function slackAdapter() {
+    return {
+        platform: "slack",
+        label: "Slack",
+        getRequiredEnvKeys() {
+            return [
+                {
+                    key: "SLACK_BOT_TOKEN",
+                    label: "Slack Bot Token",
+                    required: true,
+                },
+                {
+                    key: "SLACK_SIGNING_SECRET",
+                    label: "Slack Signing Secret",
+                    required: true,
+                },
+            ];
+        },
+        async handleVerification(event) {
+            // Slack sends url_verification when first setting up the webhook
+            const body = await readRawBody(event);
+            try {
+                const parsed = JSON.parse(body);
+                if (parsed.type === "url_verification") {
+                    return { handled: true, response: { challenge: parsed.challenge } };
+                }
+            }
+            catch { }
+            // Store raw body for later use
+            event.context.__rawBody = body;
+            return { handled: false };
+        },
+        async verifyWebhook(event) {
+            const signingSecret = process.env.SLACK_SIGNING_SECRET;
+            if (!signingSecret)
+                return false;
+            const signature = getHeader(event, "x-slack-signature");
+            const timestamp = getHeader(event, "x-slack-request-timestamp");
+            if (!signature || !timestamp)
+                return false;
+            // Reject requests older than 5 minutes (replay protection)
+            const ts = parseInt(timestamp, 10);
+            if (Math.abs(Date.now() / 1000 - ts) > 300)
+                return false;
+            const body = event.context.__rawBody ??
+                (await readRawBody(event));
+            const crypto = await import("node:crypto");
+            const basestring = `v0:${timestamp}:${body}`;
+            const expectedSignature = "v0=" +
+                crypto
+                    .createHmac("sha256", signingSecret)
+                    .update(basestring)
+                    .digest("hex");
+            // Timing-safe comparison
+            try {
+                return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expectedSignature));
+            }
+            catch {
+                return false;
+            }
+        },
+        async parseIncomingMessage(event) {
+            const raw = event.context.__rawBody ??
+                (await readRawBody(event));
+            let payload;
+            try {
+                payload = JSON.parse(raw);
+            }
+            catch {
+                return null;
+            }
+            // Handle Events API wrapper
+            if (payload.type === "event_callback") {
+                const e = payload.event;
+                if (!e)
+                    return null;
+                // Ignore bot messages
+                if (e.bot_id || e.subtype === "bot_message")
+                    return null;
+                // Ignore message edits and deletes
+                if (e.subtype === "message_changed" || e.subtype === "message_deleted")
+                    return null;
+                // Handle both direct messages and app_mentions
+                const text = e.text?.trim();
+                if (!text)
+                    return null;
+                // Remove bot mention from text (e.g., "<@U123> do something" → "do something")
+                const cleanText = text.replace(/<@[A-Z0-9]+>/g, "").trim();
+                if (!cleanText)
+                    return null;
+                // Thread ID: use thread_ts if in a thread, otherwise message ts
+                const threadTs = e.thread_ts || e.ts;
+                const externalThreadId = `${e.channel}:${threadTs}`;
+                return {
+                    platform: "slack",
+                    externalThreadId,
+                    text: cleanText,
+                    senderName: e.user,
+                    senderId: e.user,
+                    platformContext: {
+                        channelId: e.channel,
+                        threadTs: threadTs,
+                        messageTs: e.ts,
+                        teamId: payload.team_id,
+                        eventId: payload.event_id,
+                    },
+                    timestamp: Math.floor(parseFloat(e.ts) * 1000),
+                };
+            }
+            return null;
+        },
+        async sendResponse(message, context) {
+            const token = process.env.SLACK_BOT_TOKEN;
+            if (!token) {
+                console.error("[slack] SLACK_BOT_TOKEN not configured");
+                return;
+            }
+            const channelId = context.platformContext.channelId;
+            const threadTs = context.platformContext.threadTs;
+            // Split long messages
+            const chunks = splitMessage(message.text, SLACK_MAX_LENGTH);
+            for (const chunk of chunks) {
+                const body = {
+                    channel: channelId,
+                    text: chunk,
+                    thread_ts: threadTs,
+                };
+                try {
+                    const res = await fetch("https://slack.com/api/chat.postMessage", {
+                        method: "POST",
+                        headers: {
+                            Authorization: `Bearer ${token}`,
+                            "Content-Type": "application/json",
+                        },
+                        body: JSON.stringify(body),
+                    });
+                    const data = (await res.json());
+                    if (!data.ok) {
+                        console.error("[slack] chat.postMessage error:", data.error);
+                    }
+                }
+                catch (err) {
+                    console.error("[slack] Failed to send message:", err);
+                }
+            }
+        },
+        formatAgentResponse(text) {
+            return { text, platformContext: {} };
+        },
+        async getStatus(baseUrl) {
+            const hasToken = !!process.env.SLACK_BOT_TOKEN;
+            const hasSecret = !!process.env.SLACK_SIGNING_SECRET;
+            const configured = hasToken && hasSecret;
+            return {
+                platform: "slack",
+                label: "Slack",
+                enabled: false, // overridden by plugin
+                configured,
+                details: {
+                    hasToken,
+                    hasSecret,
+                },
+                error: !configured
+                    ? "Set SLACK_BOT_TOKEN and SLACK_SIGNING_SECRET in your environment"
+                    : undefined,
+            };
+        },
+    };
+}
+/** Read the raw body as a string (H3 may have already parsed it) */
+async function readRawBody(event) {
+    if (event.context.__rawBody)
+        return event.context.__rawBody;
+    const body = await readBody(event);
+    const raw = typeof body === "string" ? body : JSON.stringify(body);
+    event.context.__rawBody = raw;
+    return raw;
+}
+/** Split a message into chunks that fit within the platform's limit */
+function splitMessage(text, maxLength) {
+    if (text.length <= maxLength)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxLength) {
+            chunks.push(remaining);
+            break;
+        }
+        // Try to split at a newline
+        let splitIdx = remaining.lastIndexOf("\n", maxLength);
+        if (splitIdx <= 0) {
+            // Try to split at a space
+            splitIdx = remaining.lastIndexOf(" ", maxLength);
+        }
+        if (splitIdx <= 0) {
+            splitIdx = maxLength;
+        }
+        chunks.push(remaining.slice(0, splitIdx));
+        remaining = remaining.slice(splitIdx).trimStart();
+    }
+    return chunks;
+}
+//# sourceMappingURL=slack.js.map

package/dist/integrations/adapters/slack.js.map

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

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

@@ -0,0 +1,12 @@
+import type { PlatformAdapter } from "../types.js";
+/**
+ * Create a Telegram platform adapter.
+ *
+ * Required env vars:
+ * - TELEGRAM_BOT_TOKEN — Bot token from @BotFather
+ *
+ * Optional env vars:
+ * - TELEGRAM_WEBHOOK_SECRET — Secret token for webhook verification
+ */
+export declare function telegramAdapter(): PlatformAdapter;
+//# sourceMappingURL=telegram.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../../src/integrations/adapters/telegram.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,aAAa,CAAC;AAOrB;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,eAAe,CAqLjD"}

package/dist/integrations/adapters/telegram.js

@@ -0,0 +1,184 @@
+import { getHeader } from "h3";
+import { readBody } from "../../server/h3-helpers.js";
+/** Telegram's max message length */
+const TELEGRAM_MAX_LENGTH = 4096;
+/**
+ * Create a Telegram platform adapter.
+ *
+ * Required env vars:
+ * - TELEGRAM_BOT_TOKEN — Bot token from @BotFather
+ *
+ * Optional env vars:
+ * - TELEGRAM_WEBHOOK_SECRET — Secret token for webhook verification
+ */
+export function telegramAdapter() {
+    return {
+        platform: "telegram",
+        label: "Telegram",
+        getRequiredEnvKeys() {
+            return [
+                {
+                    key: "TELEGRAM_BOT_TOKEN",
+                    label: "Telegram Bot Token",
+                    required: true,
+                },
+                {
+                    key: "TELEGRAM_WEBHOOK_SECRET",
+                    label: "Telegram Webhook Secret",
+                    required: false,
+                },
+            ];
+        },
+        async handleVerification(_event) {
+            // Telegram doesn't have a verification challenge — webhook is set via API call
+            return { handled: false };
+        },
+        async verifyWebhook(event) {
+            const secret = process.env.TELEGRAM_WEBHOOK_SECRET;
+            if (!secret) {
+                // No secret configured — accept all (Telegram recommends using a secret but doesn't require it)
+                return !!process.env.TELEGRAM_BOT_TOKEN;
+            }
+            const headerSecret = getHeader(event, "x-telegram-bot-api-secret-token");
+            if (!headerSecret)
+                return false;
+            // Timing-safe comparison
+            try {
+                const crypto = await import("node:crypto");
+                return crypto.timingSafeEqual(Buffer.from(secret), Buffer.from(headerSecret));
+            }
+            catch {
+                return false;
+            }
+        },
+        async parseIncomingMessage(event) {
+            const body = await readBody(event);
+            if (!body)
+                return null;
+            // Handle regular messages
+            const message = body.message || body.edited_message;
+            if (!message)
+                return null;
+            // Only process text messages
+            const text = message.text?.trim();
+            if (!text)
+                return null;
+            // Ignore bot commands that we don't handle (e.g., /start is fine)
+            // Remove /start command prefix if present
+            const cleanText = text === "/start"
+                ? "Hello! I'm ready to chat."
+                : text.replace(/^\/\w+\s*/, "").trim() || text;
+            const chat = message.chat;
+            const from = message.from;
+            return {
+                platform: "telegram",
+                externalThreadId: String(chat.id),
+                text: cleanText,
+                senderName: from?.first_name + (from?.last_name ? ` ${from.last_name}` : ""),
+                senderId: String(from?.id),
+                platformContext: {
+                    chatId: chat.id,
+                    chatType: chat.type,
+                    messageId: message.message_id,
+                    fromId: from?.id,
+                    fromUsername: from?.username,
+                },
+                timestamp: message.date * 1000,
+            };
+        },
+        async sendResponse(message, context) {
+            const token = process.env.TELEGRAM_BOT_TOKEN;
+            if (!token) {
+                console.error("[telegram] TELEGRAM_BOT_TOKEN not configured");
+                return;
+            }
+            const chatId = context.platformContext.chatId;
+            const chunks = splitMessage(message.text, TELEGRAM_MAX_LENGTH);
+            for (const chunk of chunks) {
+                try {
+                    const res = await fetch(`https://api.telegram.org/bot${token}/sendMessage`, {
+                        method: "POST",
+                        headers: { "Content-Type": "application/json" },
+                        body: JSON.stringify({
+                            chat_id: chatId,
+                            text: chunk,
+                            parse_mode: "Markdown",
+                        }),
+                    });
+                    const data = (await res.json());
+                    if (!data.ok) {
+                        // Retry without Markdown if parsing fails
+                        if (data.description?.includes("parse")) {
+                            await fetch(`https://api.telegram.org/bot${token}/sendMessage`, {
+                                method: "POST",
+                                headers: { "Content-Type": "application/json" },
+                                body: JSON.stringify({
+                                    chat_id: chatId,
+                                    text: chunk,
+                                }),
+                            });
+                        }
+                        else {
+                            console.error("[telegram] sendMessage error:", data.description);
+                        }
+                    }
+                }
+                catch (err) {
+                    console.error("[telegram] Failed to send message:", err);
+                }
+            }
+        },
+        formatAgentResponse(text) {
+            return { text, platformContext: { parse_mode: "Markdown" } };
+        },
+        async getStatus(_baseUrl) {
+            const hasToken = !!process.env.TELEGRAM_BOT_TOKEN;
+            let botName;
+            if (hasToken) {
+                try {
+                    const res = await fetch(`https://api.telegram.org/bot${process.env.TELEGRAM_BOT_TOKEN}/getMe`);
+                    const data = (await res.json());
+                    if (data.ok) {
+                        botName = data.result?.username;
+                    }
+                }
+                catch { }
+            }
+            return {
+                platform: "telegram",
+                label: "Telegram",
+                enabled: false, // overridden by plugin
+                configured: hasToken,
+                details: {
+                    hasToken,
+                    botUsername: botName,
+                },
+                error: !hasToken
+                    ? "Set TELEGRAM_BOT_TOKEN in your environment"
+                    : undefined,
+            };
+        },
+    };
+}
+/** Split a message into chunks that fit within the platform's limit */
+function splitMessage(text, maxLength) {
+    if (text.length <= maxLength)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxLength) {
+            chunks.push(remaining);
+            break;
+        }
+        let splitIdx = remaining.lastIndexOf("\n", maxLength);
+        if (splitIdx <= 0)
+            splitIdx = remaining.lastIndexOf(" ", maxLength);
+        if (splitIdx <= 0)
+            splitIdx = maxLength;
+        chunks.push(remaining.slice(0, splitIdx));
+        remaining = remaining.slice(splitIdx).trimStart();
+    }
+    return chunks;
+}
+//# sourceMappingURL=telegram.js.map

package/dist/integrations/adapters/telegram.js.map

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

package/dist/integrations/adapters/whatsapp.d.ts

@@ -0,0 +1,14 @@
+import type { PlatformAdapter } from "../types.js";
+/**
+ * Create a WhatsApp Cloud API platform adapter.
+ *
+ * Required env vars:
+ * - WHATSAPP_ACCESS_TOKEN — Permanent access token from Meta
+ * - WHATSAPP_VERIFY_TOKEN — Custom token for webhook verification
+ * - WHATSAPP_PHONE_NUMBER_ID — Phone number ID from Meta dashboard
+ *
+ * Optional env vars:
+ * - WHATSAPP_APP_SECRET — App secret for signature verification
+ */
+export declare function whatsappAdapter(): PlatformAdapter;
+//# sourceMappingURL=whatsapp.d.ts.map

package/dist/integrations/adapters/whatsapp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp.d.ts","sourceRoot":"","sources":["../../../src/integrations/adapters/whatsapp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EAIhB,MAAM,aAAa,CAAC;AAOrB;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,IAAI,eAAe,CA4LjD"}

package/dist/integrations/adapters/whatsapp.js

@@ -0,0 +1,205 @@
+import { getQuery, getHeader } from "h3";
+import { readBody } from "../../server/h3-helpers.js";
+/** WhatsApp's max message length */
+const WHATSAPP_MAX_LENGTH = 4096;
+/**
+ * Create a WhatsApp Cloud API platform adapter.
+ *
+ * Required env vars:
+ * - WHATSAPP_ACCESS_TOKEN — Permanent access token from Meta
+ * - WHATSAPP_VERIFY_TOKEN — Custom token for webhook verification
+ * - WHATSAPP_PHONE_NUMBER_ID — Phone number ID from Meta dashboard
+ *
+ * Optional env vars:
+ * - WHATSAPP_APP_SECRET — App secret for signature verification
+ */
+export function whatsappAdapter() {
+    return {
+        platform: "whatsapp",
+        label: "WhatsApp",
+        getRequiredEnvKeys() {
+            return [
+                {
+                    key: "WHATSAPP_ACCESS_TOKEN",
+                    label: "WhatsApp Access Token",
+                    required: true,
+                },
+                {
+                    key: "WHATSAPP_VERIFY_TOKEN",
+                    label: "WhatsApp Verify Token",
+                    required: true,
+                },
+                {
+                    key: "WHATSAPP_PHONE_NUMBER_ID",
+                    label: "WhatsApp Phone Number ID",
+                    required: true,
+                },
+                {
+                    key: "WHATSAPP_APP_SECRET",
+                    label: "WhatsApp App Secret",
+                    required: false,
+                },
+            ];
+        },
+        async handleVerification(event) {
+            // WhatsApp uses GET request for webhook verification
+            const method = event.node?.req?.method || "POST";
+            if (method !== "GET")
+                return { handled: false };
+            const query = getQuery(event);
+            const mode = query["hub.mode"];
+            const token = query["hub.verify_token"];
+            const challenge = query["hub.challenge"];
+            if (mode === "subscribe" && token === process.env.WHATSAPP_VERIFY_TOKEN) {
+                return { handled: true, response: challenge };
+            }
+            return { handled: false };
+        },
+        async verifyWebhook(event) {
+            const appSecret = process.env.WHATSAPP_APP_SECRET;
+            if (!appSecret) {
+                // No app secret — accept if access token is configured
+                return !!process.env.WHATSAPP_ACCESS_TOKEN;
+            }
+            const signature = getHeader(event, "x-hub-signature-256");
+            if (!signature)
+                return false;
+            const body = await readRawBody(event);
+            const crypto = await import("node:crypto");
+            const expectedSignature = "sha256=" +
+                crypto.createHmac("sha256", appSecret).update(body).digest("hex");
+            try {
+                return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expectedSignature));
+            }
+            catch {
+                return false;
+            }
+        },
+        async parseIncomingMessage(event) {
+            const body = await readBody(event);
+            if (!body)
+                return null;
+            // WhatsApp Cloud API webhook payload structure
+            const entry = body.entry?.[0];
+            if (!entry)
+                return null;
+            const changes = entry.changes?.[0];
+            if (!changes || changes.field !== "messages")
+                return null;
+            const value = changes.value;
+            const message = value?.messages?.[0];
+            if (!message)
+                return null;
+            // Only handle text messages
+            if (message.type !== "text")
+                return null;
+            const text = message.text?.body?.trim();
+            if (!text)
+                return null;
+            const contact = value.contacts?.[0];
+            const from = message.from; // Phone number
+            return {
+                platform: "whatsapp",
+                externalThreadId: from,
+                text,
+                senderName: contact?.profile?.name,
+                senderId: from,
+                platformContext: {
+                    phoneNumberId: value.metadata?.phone_number_id,
+                    displayPhoneNumber: value.metadata?.display_phone_number,
+                    messageId: message.id,
+                    from,
+                    timestamp: message.timestamp,
+                },
+                timestamp: parseInt(message.timestamp, 10) * 1000,
+            };
+        },
+        async sendResponse(message, context) {
+            const accessToken = process.env.WHATSAPP_ACCESS_TOKEN;
+            const phoneNumberId = process.env.WHATSAPP_PHONE_NUMBER_ID;
+            if (!accessToken || !phoneNumberId) {
+                console.error("[whatsapp] WHATSAPP_ACCESS_TOKEN or WHATSAPP_PHONE_NUMBER_ID not configured");
+                return;
+            }
+            const to = context.senderId;
+            const chunks = splitMessage(message.text, WHATSAPP_MAX_LENGTH);
+            for (const chunk of chunks) {
+                try {
+                    const res = await fetch(`https://graph.facebook.com/v21.0/${phoneNumberId}/messages`, {
+                        method: "POST",
+                        headers: {
+                            Authorization: `Bearer ${accessToken}`,
+                            "Content-Type": "application/json",
+                        },
+                        body: JSON.stringify({
+                            messaging_product: "whatsapp",
+                            recipient_type: "individual",
+                            to,
+                            type: "text",
+                            text: { body: chunk },
+                        }),
+                    });
+                    if (!res.ok) {
+                        const data = await res.json().catch(() => ({}));
+                        console.error("[whatsapp] sendMessage error:", data);
+                    }
+                }
+                catch (err) {
+                    console.error("[whatsapp] Failed to send message:", err);
+                }
+            }
+        },
+        formatAgentResponse(text) {
+            return { text, platformContext: {} };
+        },
+        async getStatus(_baseUrl) {
+            const hasAccessToken = !!process.env.WHATSAPP_ACCESS_TOKEN;
+            const hasVerifyToken = !!process.env.WHATSAPP_VERIFY_TOKEN;
+            const hasPhoneNumberId = !!process.env.WHATSAPP_PHONE_NUMBER_ID;
+            const configured = hasAccessToken && hasVerifyToken && hasPhoneNumberId;
+            return {
+                platform: "whatsapp",
+                label: "WhatsApp",
+                enabled: false, // overridden by plugin
+                configured,
+                details: {
+                    hasAccessToken,
+                    hasVerifyToken,
+                    hasPhoneNumberId,
+                },
+                error: !configured
+                    ? "Set WHATSAPP_ACCESS_TOKEN, WHATSAPP_VERIFY_TOKEN, and WHATSAPP_PHONE_NUMBER_ID"
+                    : undefined,
+            };
+        },
+    };
+}
+async function readRawBody(event) {
+    if (event.context.__rawBody)
+        return event.context.__rawBody;
+    const body = await readBody(event);
+    const raw = typeof body === "string" ? body : JSON.stringify(body);
+    event.context.__rawBody = raw;
+    return raw;
+}
+function splitMessage(text, maxLength) {
+    if (text.length <= maxLength)
+        return [text];
+    const chunks = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        if (remaining.length <= maxLength) {
+            chunks.push(remaining);
+            break;
+        }
+        let splitIdx = remaining.lastIndexOf("\n", maxLength);
+        if (splitIdx <= 0)
+            splitIdx = remaining.lastIndexOf(" ", maxLength);
+        if (splitIdx <= 0)
+            splitIdx = maxLength;
+        chunks.push(remaining.slice(0, splitIdx));
+        remaining = remaining.slice(splitIdx).trimStart();
+    }
+    return chunks;
+}
+//# sourceMappingURL=whatsapp.js.map