@agent-native/core 0.5.0-dev.b51eaae → 0.7.1

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

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

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

package/dist/integrations/config-store.d.ts

@@ -0,0 +1,24 @@
+export interface IntegrationConfig {
+    platform: string;
+    configKey: string;
+    configData: Record<string, unknown>;
+    owner: string | null;
+    updatedAt: number;
+}
+/**
+ * Get the config for a platform integration.
+ */
+export declare function getIntegrationConfig(platform: string, configKey?: string): Promise<IntegrationConfig | null>;
+/**
+ * Save or update a platform integration config.
+ */
+export declare function saveIntegrationConfig(platform: string, configData: Record<string, unknown>, configKey?: string, owner?: string): Promise<void>;
+/**
+ * Delete a platform integration config.
+ */
+export declare function deleteIntegrationConfig(platform: string, configKey?: string): Promise<void>;
+/**
+ * List all configs for a platform.
+ */
+export declare function listIntegrationConfigs(platform?: string): Promise<IntegrationConfig[]>;
+//# sourceMappingURL=config-store.d.ts.map

package/dist/integrations/config-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-store.d.ts","sourceRoot":"","sources":["../../src/integrations/config-store.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAY,GACpB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAgBnC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,SAAS,SAAY,EACrB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkB9B"}

package/dist/integrations/config-store.js

@@ -0,0 +1,92 @@
+import { getDbExec, isPostgres, intType } from "../db/client.js";
+let _initPromise;
+async function ensureTable() {
+    if (!_initPromise) {
+        _initPromise = (async () => {
+            const client = getDbExec();
+            await client.execute(`
+        CREATE TABLE IF NOT EXISTS integration_configs (
+          platform TEXT NOT NULL,
+          config_key TEXT NOT NULL,
+          config_data TEXT NOT NULL,
+          owner TEXT,
+          updated_at ${intType()} NOT NULL,
+          PRIMARY KEY (platform, config_key)
+        )
+      `);
+        })();
+    }
+    return _initPromise;
+}
+/**
+ * Get the config for a platform integration.
+ */
+export async function getIntegrationConfig(platform, configKey = "default") {
+    await ensureTable();
+    const client = getDbExec();
+    const { rows } = await client.execute({
+        sql: `SELECT platform, config_key, config_data, owner, updated_at FROM integration_configs WHERE platform = ? AND config_key = ?`,
+        args: [platform, configKey],
+    });
+    if (rows.length === 0)
+        return null;
+    const row = rows[0];
+    return {
+        platform: row.platform,
+        configKey: row.config_key,
+        configData: JSON.parse(row.config_data),
+        owner: row.owner ?? null,
+        updatedAt: row.updated_at,
+    };
+}
+/**
+ * Save or update a platform integration config.
+ */
+export async function saveIntegrationConfig(platform, configData, configKey = "default", owner) {
+    await ensureTable();
+    const client = getDbExec();
+    await client.execute({
+        sql: isPostgres()
+            ? `INSERT INTO integration_configs (platform, config_key, config_data, owner, updated_at) VALUES (?, ?, ?, ?, ?) ON CONFLICT (platform, config_key) DO UPDATE SET config_data=EXCLUDED.config_data, owner=EXCLUDED.owner, updated_at=EXCLUDED.updated_at`
+            : `INSERT OR REPLACE INTO integration_configs (platform, config_key, config_data, owner, updated_at) VALUES (?, ?, ?, ?, ?)`,
+        args: [
+            platform,
+            configKey,
+            JSON.stringify(configData),
+            owner ?? null,
+            Date.now(),
+        ],
+    });
+}
+/**
+ * Delete a platform integration config.
+ */
+export async function deleteIntegrationConfig(platform, configKey = "default") {
+    await ensureTable();
+    const client = getDbExec();
+    await client.execute({
+        sql: `DELETE FROM integration_configs WHERE platform = ? AND config_key = ?`,
+        args: [platform, configKey],
+    });
+}
+/**
+ * List all configs for a platform.
+ */
+export async function listIntegrationConfigs(platform) {
+    await ensureTable();
+    const client = getDbExec();
+    const { rows } = platform
+        ? await client.execute({
+            sql: `SELECT platform, config_key, config_data, owner, updated_at FROM integration_configs WHERE platform = ?`,
+            args: [platform],
+        })
+        : await client.execute(`SELECT platform, config_key, config_data, owner, updated_at FROM integration_configs`);
+    return rows.map((row) => ({
+        platform: row.platform,
+        configKey: row.config_key,
+        configData: JSON.parse(row.config_data),
+        owner: row.owner ?? null,
+        updatedAt: row.updated_at,
+    }));
+}
+//# sourceMappingURL=config-store.js.map

package/dist/integrations/config-store.js.map

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

package/dist/integrations/google-docs-poller.d.ts

@@ -0,0 +1,54 @@
+import { type ActionEntry } from "../agent/production-agent.js";
+export interface GoogleDocsPollerOptions {
+    /** Polling interval in milliseconds (fallback mode). Default: 30000 (30s) */
+    intervalMs?: number;
+    /** Trigger keyword in comments. Default: "@agent" (case-insensitive) */
+    triggerKeyword?: string;
+    /** System prompt for the agent */
+    systemPrompt: string;
+    /** Action entries for the agent */
+    actions: Record<string, ActionEntry>;
+    /** Model to use */
+    model: string;
+    /** Anthropic API key */
+    apiKey: string;
+    /** Thread owner email */
+    ownerEmail: string;
+    /** Webhook URL for push mode (set by plugin from WEBHOOK_BASE_URL) */
+    webhookUrl?: string;
+}
+/**
+ * Register a Google Drive changes.watch channel so Google pushes
+ * notifications to our webhook instead of us polling.
+ *
+ * Returns true if the watch was registered successfully.
+ */
+export declare function registerWatch(webhookUrl: string): Promise<boolean>;
+/**
+ * Process pending Drive changes — called by both push notifications and polling.
+ * Fetches changes since the last page token, finds Google Docs that changed,
+ * and checks their comments for agent mentions.
+ */
+export declare function processChanges(options: GoogleDocsPollerOptions): Promise<void>;
+/**
+ * Handle a push notification from Google Drive changes.watch.
+ * Called from the integration webhook route.
+ */
+export declare function handlePushNotification(): Promise<void>;
+/**
+ * Start the Google Docs integration.
+ *
+ * Hybrid approach:
+ * 1. Attempts to register a Google Drive changes.watch webhook for
+ *    near-instant push notifications (~seconds latency)
+ * 2. Falls back to polling if the watch registration fails
+ *    (e.g. domain not verified, local dev)
+ * 3. Even in push mode, polls at a slow interval (5min) as a safety net
+ *    in case a push notification is missed
+ */
+export declare function startGoogleDocsPoller(options: GoogleDocsPollerOptions): Promise<void>;
+/**
+ * Stop the Google Docs integration.
+ */
+export declare function stopGoogleDocsPoller(): Promise<void>;
+//# sourceMappingURL=google-docs-poller.d.ts.map

package/dist/integrations/google-docs-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-docs-poller.d.ts","sourceRoot":"","sources":["../../src/integrations/google-docs-poller.ts"],"names":[],"mappings":"AAWA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAoBtC,MAAM,WAAW,uBAAuB;IACtC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAWD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqExE;AA0KD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAa5D;AA0JD;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAmCf;AA2BD;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAW1D"}