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

package/dist/integrations/plugin.js

@@ -0,0 +1,260 @@
+import { defineEventHandler, setResponseStatus, getMethod } from "h3";
+import { FRAMEWORK_ROUTE_PREFIX } from "../server/core-routes-plugin.js";
+import { getH3App } from "../server/framework-request-handler.js";
+import { handleWebhook } from "./webhook-handler.js";
+import { getIntegrationConfig, saveIntegrationConfig } from "./config-store.js";
+import { slackAdapter } from "./adapters/slack.js";
+import { telegramAdapter } from "./adapters/telegram.js";
+import { whatsappAdapter } from "./adapters/whatsapp.js";
+import { googleDocsAdapter } from "./adapters/google-docs.js";
+import { startGoogleDocsPoller, handlePushNotification, } from "./google-docs-poller.js";
+import { resourceGetByPath, SHARED_OWNER } from "../resources/store.js";
+/** Built-in adapters, instantiated lazily */
+function getDefaultAdapters() {
+    return [
+        slackAdapter(),
+        telegramAdapter(),
+        whatsappAdapter(),
+        googleDocsAdapter(),
+    ];
+}
+/**
+ * Load resources for the integration agent's system prompt.
+ * Mirrors the pattern from agent-chat-plugin.ts.
+ */
+async function loadResourcesForPrompt(owner) {
+    const resourceNames = ["AGENTS.md", "LEARNINGS.md"];
+    const sections = [];
+    for (const name of resourceNames) {
+        try {
+            const shared = await resourceGetByPath(SHARED_OWNER, name);
+            if (shared?.content?.trim()) {
+                sections.push(`<resource name="${name}" scope="shared">\n${shared.content.trim()}\n</resource>`);
+            }
+        }
+        catch { }
+        if (owner !== SHARED_OWNER) {
+            try {
+                const personal = await resourceGetByPath(owner, name);
+                if (personal?.content?.trim()) {
+                    sections.push(`<resource name="${name}" scope="personal">\n${personal.content.trim()}\n</resource>`);
+                }
+            }
+            catch { }
+        }
+    }
+    if (sections.length === 0)
+        return "";
+    return ("\n\nThe following resources contain template-specific instructions and user context.\n\n" +
+        sections.join("\n\n"));
+}
+const INTEGRATION_SYSTEM_PROMPT = `You are an AI agent responding via a messaging platform integration (Slack, Telegram, WhatsApp, etc.).
+
+You have the same capabilities as the web chat agent. Use your tools to help the user.
+
+Keep responses concise — messaging platforms have character limits and users expect shorter replies than in a web interface. Use markdown sparingly (bold and lists are fine, but avoid complex formatting that may not render well on all platforms).
+
+If a task requires many steps, summarize what you did rather than streaming every detail.`;
+/**
+ * Creates a Nitro plugin that mounts messaging platform integration webhook routes.
+ *
+ * Routes:
+ *   POST   /_agent-native/integrations/:platform/webhook  — receive platform webhooks
+ *   GET    /_agent-native/integrations/status              — all integrations status
+ *   GET    /_agent-native/integrations/:platform/status    — single platform status
+ *   POST   /_agent-native/integrations/:platform/enable    — enable integration
+ *   POST   /_agent-native/integrations/:platform/disable   — disable integration
+ *   POST   /_agent-native/integrations/:platform/setup     — platform-specific setup
+ */
+export function createIntegrationsPlugin(options) {
+    return async (nitroApp) => {
+        const adapters = options?.adapters ?? getDefaultAdapters();
+        const adapterMap = new Map();
+        for (const adapter of adapters) {
+            adapterMap.set(adapter.platform, adapter);
+        }
+        const model = options?.model ?? "claude-sonnet-4-6";
+        const apiKey = options?.apiKey ?? process.env.ANTHROPIC_API_KEY ?? "";
+        // Build the system prompt
+        const baseSystemPrompt = options?.systemPrompt ?? INTEGRATION_SYSTEM_PROMPT;
+        // Resolve actions
+        const actions = options?.actions ?? {};
+        const h3 = getH3App(nitroApp);
+        const P = `${FRAMEWORK_ROUTE_PREFIX}/integrations`;
+        // ─── Status endpoint (all integrations) ───────────────────────
+        h3.use(`${P}/status`, defineEventHandler(async (event) => {
+            if (getMethod(event) !== "GET") {
+                setResponseStatus(event, 405);
+                return { error: "Method not allowed" };
+            }
+            const baseUrl = getBaseUrl(event);
+            const statuses = [];
+            for (const adapter of adapters) {
+                const status = await adapter.getStatus(baseUrl);
+                const config = await getIntegrationConfig(adapter.platform);
+                status.enabled = !!config?.configData?.enabled;
+                status.webhookUrl = `${baseUrl}${P}/${adapter.platform}/webhook`;
+                statuses.push(status);
+            }
+            return statuses;
+        }));
+        // ─── Per-platform catch-all ───────────────────────────────────
+        // Handles: webhook, status, enable, disable, setup for each platform
+        h3.use(`${P}`, defineEventHandler(async (event) => {
+            const method = getMethod(event);
+            // event.path is stripped to the remainder after the mount prefix
+            const raw = (event.path || "/").split("?")[0].replace(/^\//, "");
+            const parts = raw.split("/").filter(Boolean);
+            // Already handled by the dedicated /status route above
+            if (parts[0] === "status" && parts.length === 1)
+                return;
+            const platform = parts[0];
+            const action = parts[1]; // webhook, status, enable, disable, setup
+            if (!platform) {
+                setResponseStatus(event, 404);
+                return { error: "Platform required" };
+            }
+            const adapter = adapterMap.get(platform);
+            if (!adapter) {
+                setResponseStatus(event, 404);
+                return { error: `Unknown platform: ${platform}` };
+            }
+            // Set params for handlers that read them
+            if (event.context) {
+                event.context.params = {
+                    ...event.context.params,
+                    platform,
+                };
+            }
+            // ─── GET /:platform/status ─────────────────────────────
+            if (action === "status" && method === "GET") {
+                const baseUrl = getBaseUrl(event);
+                const status = await adapter.getStatus(baseUrl);
+                const config = await getIntegrationConfig(platform);
+                status.enabled = !!config?.configData?.enabled;
+                status.webhookUrl = `${baseUrl}${P}/${platform}/webhook`;
+                return status;
+            }
+            // ─── POST /:platform/webhook ───────────────────────────
+            if (action === "webhook" && method === "POST") {
+                // Google Docs push notifications bypass the normal webhook flow —
+                // they're opaque "something changed" pings, not message payloads.
+                if (platform === "google-docs") {
+                    handlePushNotification().catch((err) => {
+                        console.error("[google-docs] Push handler error:", err);
+                    });
+                    return "ok";
+                }
+                const config = await getIntegrationConfig(platform);
+                if (!config?.configData?.enabled) {
+                    setResponseStatus(event, 404);
+                    return { error: `Integration ${platform} is not enabled` };
+                }
+                const incoming = await adapter.parseIncomingMessage(event);
+                if (!incoming) {
+                    setResponseStatus(event, 200);
+                    return "ok";
+                }
+                const owner = options?.resolveOwner
+                    ? await options.resolveOwner(incoming)
+                    : `integration@${platform}`;
+                const resources = await loadResourcesForPrompt(owner);
+                const systemPrompt = baseSystemPrompt + resources;
+                const result = await handleWebhook(event, {
+                    adapter,
+                    systemPrompt,
+                    actions,
+                    model,
+                    apiKey: options?.apiKey ?? process.env.ANTHROPIC_API_KEY ?? "",
+                    ownerEmail: owner,
+                    beforeProcess: options?.beforeProcess,
+                });
+                setResponseStatus(event, result.status);
+                return result.body;
+            }
+            // ─── POST /:platform/enable ────────────────────────────
+            if (action === "enable" && method === "POST") {
+                await saveIntegrationConfig(platform, { enabled: true });
+                return { ok: true, platform, enabled: true };
+            }
+            // ─── POST /:platform/disable ───────────────────────────
+            if (action === "disable" && method === "POST") {
+                await saveIntegrationConfig(platform, { enabled: false });
+                return { ok: true, platform, enabled: false };
+            }
+            // ─── POST /:platform/setup ─────────────────────────────
+            if (action === "setup" && method === "POST") {
+                if (platform === "telegram") {
+                    const baseUrl = getBaseUrl(event);
+                    const webhookUrl = `${baseUrl}${P}/telegram/webhook`;
+                    const token = process.env.TELEGRAM_BOT_TOKEN;
+                    if (!token) {
+                        setResponseStatus(event, 400);
+                        return { error: "TELEGRAM_BOT_TOKEN not configured" };
+                    }
+                    try {
+                        const res = await fetch(`https://api.telegram.org/bot${token}/setWebhook`, {
+                            method: "POST",
+                            headers: { "Content-Type": "application/json" },
+                            body: JSON.stringify({ url: webhookUrl }),
+                        });
+                        const data = await res.json();
+                        return { ok: true, platform, webhookUrl, result: data };
+                    }
+                    catch (err) {
+                        setResponseStatus(event, 500);
+                        return { error: err.message };
+                    }
+                }
+                return { ok: true, platform, message: "No setup required" };
+            }
+            setResponseStatus(event, 404);
+            return { error: "Not found" };
+        }));
+        // ─── Start Google Docs poller/push ────────────────────────────
+        if (adapterMap.has("google-docs")) {
+            // Defer startup slightly so the server is fully ready
+            setTimeout(() => {
+                // We don't know the base URL at plugin init time — it depends on
+                // the incoming request. For push mode, the webhook URL needs to be
+                // resolved. We pass it as a special option; the poller will attempt
+                // to register a watch when the first request reveals the base URL,
+                // or use the WEBHOOK_BASE_URL env var if set.
+                const baseUrl = process.env.WEBHOOK_BASE_URL;
+                const webhookUrl = baseUrl
+                    ? `${baseUrl}${P}/google-docs/webhook`
+                    : undefined;
+                startGoogleDocsPoller({
+                    systemPrompt: baseSystemPrompt,
+                    actions,
+                    model,
+                    apiKey,
+                    ownerEmail: "integration@google-docs",
+                    webhookUrl,
+                });
+            }, 2000);
+        }
+        if (process.env.DEBUG)
+            console.log(`[integrations] Mounted integration routes for: ${adapters.map((a) => a.platform).join(", ")}`);
+    };
+}
+/**
+ * Default integrations plugin — auto-mounts all adapters.
+ */
+export const defaultIntegrationsPlugin = createIntegrationsPlugin();
+/** Extract base URL from the request */
+function getBaseUrl(event) {
+    try {
+        const headers = event.node?.req?.headers || event.headers || {};
+        const getHeader = (name) => typeof headers.get === "function"
+            ? headers.get(name)
+            : headers[name];
+        const proto = getHeader("x-forwarded-proto") || "http";
+        const host = getHeader("host") || "localhost:3000";
+        return `${proto}://${host}`;
+    }
+    catch {
+        return "http://localhost:3000";
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/integrations/plugin.js.map

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

package/dist/integrations/thread-mapping-store.d.ts

@@ -0,0 +1,25 @@
+export interface ThreadMapping {
+    platform: string;
+    externalThreadId: string;
+    internalThreadId: string;
+    platformContext: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+}
+/**
+ * Look up the internal thread ID for an external platform thread.
+ */
+export declare function getThreadMapping(platform: string, externalThreadId: string): Promise<ThreadMapping | null>;
+/**
+ * Create or update a thread mapping.
+ */
+export declare function saveThreadMapping(platform: string, externalThreadId: string, internalThreadId: string, platformContext?: Record<string, unknown>): Promise<void>;
+/**
+ * Delete a thread mapping.
+ */
+export declare function deleteThreadMapping(platform: string, externalThreadId: string): Promise<void>;
+/**
+ * List all thread mappings for a platform.
+ */
+export declare function listThreadMappings(platform: string): Promise<ThreadMapping[]>;
+//# sourceMappingURL=thread-mapping-store.d.ts.map

package/dist/integrations/thread-mapping-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-mapping-store.d.ts","sourceRoot":"","sources":["../../src/integrations/thread-mapping-store.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAiB/B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,EACxB,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAC5C,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,EAAE,CAAC,CAe1B"}

package/dist/integrations/thread-mapping-store.js

@@ -0,0 +1,95 @@
+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_thread_mappings (
+          platform TEXT NOT NULL,
+          external_thread_id TEXT NOT NULL,
+          internal_thread_id TEXT NOT NULL,
+          platform_context TEXT NOT NULL DEFAULT '{}',
+          created_at ${intType()} NOT NULL,
+          updated_at ${intType()} NOT NULL,
+          PRIMARY KEY (platform, external_thread_id)
+        )
+      `);
+        })();
+    }
+    return _initPromise;
+}
+/**
+ * Look up the internal thread ID for an external platform thread.
+ */
+export async function getThreadMapping(platform, externalThreadId) {
+    await ensureTable();
+    const client = getDbExec();
+    const { rows } = await client.execute({
+        sql: `SELECT platform, external_thread_id, internal_thread_id, platform_context, created_at, updated_at FROM integration_thread_mappings WHERE platform = ? AND external_thread_id = ?`,
+        args: [platform, externalThreadId],
+    });
+    if (rows.length === 0)
+        return null;
+    const row = rows[0];
+    return {
+        platform: row.platform,
+        externalThreadId: row.external_thread_id,
+        internalThreadId: row.internal_thread_id,
+        platformContext: JSON.parse(row.platform_context),
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+/**
+ * Create or update a thread mapping.
+ */
+export async function saveThreadMapping(platform, externalThreadId, internalThreadId, platformContext = {}) {
+    await ensureTable();
+    const client = getDbExec();
+    const now = Date.now();
+    await client.execute({
+        sql: isPostgres()
+            ? `INSERT INTO integration_thread_mappings (platform, external_thread_id, internal_thread_id, platform_context, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?) ON CONFLICT (platform, external_thread_id) DO UPDATE SET internal_thread_id=EXCLUDED.internal_thread_id, platform_context=EXCLUDED.platform_context, updated_at=EXCLUDED.updated_at`
+            : `INSERT OR REPLACE INTO integration_thread_mappings (platform, external_thread_id, internal_thread_id, platform_context, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)`,
+        args: [
+            platform,
+            externalThreadId,
+            internalThreadId,
+            JSON.stringify(platformContext),
+            now,
+            now,
+        ],
+    });
+}
+/**
+ * Delete a thread mapping.
+ */
+export async function deleteThreadMapping(platform, externalThreadId) {
+    await ensureTable();
+    const client = getDbExec();
+    await client.execute({
+        sql: `DELETE FROM integration_thread_mappings WHERE platform = ? AND external_thread_id = ?`,
+        args: [platform, externalThreadId],
+    });
+}
+/**
+ * List all thread mappings for a platform.
+ */
+export async function listThreadMappings(platform) {
+    await ensureTable();
+    const client = getDbExec();
+    const { rows } = await client.execute({
+        sql: `SELECT platform, external_thread_id, internal_thread_id, platform_context, created_at, updated_at FROM integration_thread_mappings WHERE platform = ?`,
+        args: [platform],
+    });
+    return rows.map((row) => ({
+        platform: row.platform,
+        externalThreadId: row.external_thread_id,
+        internalThreadId: row.internal_thread_id,
+        platformContext: JSON.parse(row.platform_context),
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    }));
+}
+//# sourceMappingURL=thread-mapping-store.js.map

package/dist/integrations/thread-mapping-store.js.map

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

package/dist/integrations/types.d.ts

@@ -0,0 +1,144 @@
+import type { H3Event } from "h3";
+import type { EnvKeyConfig } from "../server/create-server.js";
+/**
+ * Normalized incoming message from any messaging platform.
+ */
+export interface IncomingMessage {
+    /** Platform identifier (e.g., "slack", "telegram", "whatsapp") */
+    platform: string;
+    /** Platform-specific thread/conversation identifier */
+    externalThreadId: string;
+    /** Message text content */
+    text: string;
+    /** Display name of the sender */
+    senderName?: string;
+    /** Platform-specific sender ID */
+    senderId?: string;
+    /** Raw platform-specific context needed for routing responses */
+    platformContext: Record<string, unknown>;
+    /** Message timestamp (epoch ms) */
+    timestamp: number;
+}
+/**
+ * Outgoing message to send back to a messaging platform.
+ */
+export interface OutgoingMessage {
+    /** Text content of the response */
+    text: string;
+    /** Platform-specific payload (e.g., Slack blocks, Telegram parse_mode) */
+    platformContext: Record<string, unknown>;
+}
+/**
+ * Proactive outbound message target for a platform.
+ * Used when the agent needs to send to a saved destination instead of replying
+ * to the current inbound thread.
+ */
+export interface OutboundTarget {
+    /** Canonical platform-specific destination id (channel, chat, thread, etc.) */
+    destination: string;
+    /** Optional thread reference when the destination supports threading */
+    threadRef?: string | null;
+    /** Optional fallback display label */
+    label?: string;
+}
+/**
+ * Connection status for a platform integration.
+ */
+export interface IntegrationStatus {
+    platform: string;
+    /** Human-readable label (e.g., "Slack", "Telegram") */
+    label: string;
+    /** Whether the integration is explicitly enabled */
+    enabled: boolean;
+    /** Whether all required credentials are configured */
+    configured: boolean;
+    /** Platform-specific details (workspace name, bot username, etc.) */
+    details?: Record<string, unknown>;
+    /** Error message if something is wrong */
+    error?: string;
+    /** The webhook URL that should be configured in the platform */
+    webhookUrl?: string;
+}
+/**
+ * Platform adapter interface — implement this for each messaging platform.
+ *
+ * Each adapter handles the platform-specific concerns:
+ * - Webhook verification (HMAC signatures, challenge responses)
+ * - Message parsing (platform events → normalized IncomingMessage)
+ * - Response formatting (agent text → platform-specific format)
+ * - Response delivery (POST back to platform API)
+ */
+export interface PlatformAdapter {
+    /** Unique platform identifier */
+    readonly platform: string;
+    /** Human-readable label */
+    readonly label: string;
+    /** Env keys this adapter needs (tokens, secrets, etc.) */
+    getRequiredEnvKeys(): EnvKeyConfig[];
+    /**
+     * Handle platform-specific verification challenges.
+     * For example, Slack sends a `url_verification` event when setting up.
+     * Return `{ handled: true, response }` to short-circuit the webhook handler.
+     */
+    handleVerification(event: H3Event): Promise<{
+        handled: boolean;
+        response?: unknown;
+    }>;
+    /**
+     * Validate the webhook request signature.
+     * Returns true if the request is authentic.
+     */
+    verifyWebhook(event: H3Event): Promise<boolean>;
+    /**
+     * Parse the webhook payload into a normalized IncomingMessage.
+     * Return null to silently ignore the event (bot messages, edits, etc.).
+     */
+    parseIncomingMessage(event: H3Event): Promise<IncomingMessage | null>;
+    /**
+     * Send the agent's response back to the messaging platform.
+     */
+    sendResponse(message: OutgoingMessage, context: IncomingMessage): Promise<void>;
+    /**
+     * Send a proactive outbound message to a platform destination. Adapters that
+     * only support direct replies can omit this.
+     */
+    sendMessageToTarget?(message: OutgoingMessage, target: OutboundTarget): Promise<void>;
+    /**
+     * Format plain agent response text into a platform-appropriate message.
+     * Handles markdown conversion, message splitting for length limits, etc.
+     */
+    formatAgentResponse(text: string): OutgoingMessage;
+    /** Return current connection/configuration status for the settings UI. */
+    getStatus(baseUrl?: string): Promise<IntegrationStatus>;
+}
+/**
+ * Options for the integrations plugin.
+ */
+export interface IntegrationsPluginOptions {
+    /** Platform adapters to enable. Default: all built-in adapters with configured env keys. */
+    adapters?: PlatformAdapter[];
+    /** System prompt for the agent (same as agent-chat). Inherited from agent-chat plugin if not set. */
+    systemPrompt?: string;
+    /** Actions registry (same as agent-chat). */
+    actions?: Record<string, import("../agent/production-agent.js").ActionEntry>;
+    /** Model to use. Default: claude-sonnet-4-6 */
+    model?: string;
+    /** Anthropic API key. Falls back to ANTHROPIC_API_KEY env var. */
+    apiKey?: string;
+    /**
+     * Resolve which owner should receive personal resource context and own the
+     * created chat thread for an incoming platform message.
+     */
+    resolveOwner?: (incoming: IncomingMessage) => string | Promise<string>;
+    /**
+     * Optional preprocessor for inbound platform messages. Can intercept special
+     * commands (such as `/link`) before the agent loop runs.
+     */
+    beforeProcess?: (incoming: IncomingMessage, adapter: PlatformAdapter) => Promise<{
+        handled: true;
+        responseText?: string;
+    } | {
+        handled: false;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/integrations/types.d.ts.map

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

package/dist/integrations/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/integrations/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/integrations/types.ts"],"names":[],"mappings":""}

package/dist/integrations/webhook-handler.d.ts

@@ -0,0 +1,40 @@
+import type { H3Event } from "h3";
+import type { PlatformAdapter, IncomingMessage } from "./types.js";
+import { type ActionEntry } from "../agent/production-agent.js";
+export interface WebhookHandlerOptions {
+    adapter: PlatformAdapter;
+    /** Resolved system prompt string */
+    systemPrompt: string;
+    /** Action entries for the agent */
+    actions: Record<string, ActionEntry>;
+    /** Model to use */
+    model: string;
+    /** Anthropic API key */
+    apiKey: string;
+    /** Thread owner for personal/shared resource loading */
+    ownerEmail: string;
+    /** Optional hook to intercept inbound commands before agent execution */
+    beforeProcess?: (incoming: IncomingMessage, adapter: PlatformAdapter) => Promise<{
+        handled: true;
+        responseText?: string;
+    } | {
+        handled: false;
+    }>;
+}
+/**
+ * Process an incoming webhook from a messaging platform.
+ *
+ * Flow:
+ * 1. Handle verification challenges (Slack url_verification, etc.)
+ * 2. Verify webhook signature
+ * 3. Parse incoming message (null = ignored event)
+ * 4. Return HTTP 200 immediately
+ * 5. Resolve/create internal thread
+ * 6. Run agent loop in background
+ * 7. Post response back to platform
+ */
+export declare function handleWebhook(event: H3Event, options: WebhookHandlerOptions): Promise<{
+    status: number;
+    body: unknown;
+}>;
+//# sourceMappingURL=webhook-handler.d.ts.map

package/dist/integrations/webhook-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-handler.d.ts","sourceRoot":"","sources":["../../src/integrations/webhook-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAElC,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnE,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAoCtC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,eAAe,CAAC;IACzB,oCAAoC;IACpC,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,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,CACd,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,eAAe,KACrB,OAAO,CACR;QACE,OAAO,EAAE,IAAI,CAAC;QACd,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACD;QAAE,OAAO,EAAE,KAAK,CAAA;KAAE,CACrB,CAAC;CACH;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAkD5C"}