@agent-native/core 0.7.13 → 0.7.15

package/dist/integrations/task-queue-stats.js

@@ -0,0 +1,117 @@
+/**
+ * Read-only observability helpers for the integration task queue.
+ *
+ * Lives in its own file so it stays out of `pending-tasks-store.ts`, which is
+ * actively being edited by the agent that owns the queue itself. These
+ * helpers only SELECT — they never write — and they degrade gracefully if
+ * the `integration_pending_tasks` table doesn't exist yet (returning zeroed
+ * stats instead of throwing).
+ */
+import { getDbExec } from "../db/client.js";
+const ZERO_STATS = {
+    pending: 0,
+    processing: 0,
+    completed_last_hour: 0,
+    failed_last_hour: 0,
+    oldest_pending_age_seconds: 0,
+    recent_failures: [],
+};
+function isMissingTableError(err) {
+    const msg = err instanceof Error ? err.message : String(err ?? "");
+    return /no such table|does not exist|relation .* does not exist|undefined_table/i.test(msg);
+}
+/**
+ * Get a snapshot of the integration task queue health.
+ *
+ * Returns zeros if the table doesn't exist yet — safe to call before the
+ * pending-tasks store has initialised the schema.
+ */
+export async function getTaskQueueStats() {
+    const client = getDbExec();
+    const now = Date.now();
+    const oneHourAgo = now - 60 * 60 * 1000;
+    try {
+        // Status counts (pending, processing) — only need the live ones.
+        const liveCounts = await client.execute({
+            sql: `SELECT status, COUNT(*) AS c FROM integration_pending_tasks
+            WHERE status IN ('pending', 'processing')
+            GROUP BY status`,
+            args: [],
+        });
+        let pending = 0;
+        let processing = 0;
+        for (const row of liveCounts.rows) {
+            const status = row.status;
+            const count = Number(row.c ?? 0);
+            if (status === "pending")
+                pending = count;
+            else if (status === "processing")
+                processing = count;
+        }
+        // Last-hour completion + failure counts. updated_at is the most reliable
+        // column — completed_at can be null on failed tasks, and created_at would
+        // miss tasks queued >1h ago that just finished now.
+        const lastHourCounts = await client.execute({
+            sql: `SELECT status, COUNT(*) AS c FROM integration_pending_tasks
+            WHERE status IN ('completed', 'failed') AND updated_at >= ?
+            GROUP BY status`,
+            args: [oneHourAgo],
+        });
+        let completedLastHour = 0;
+        let failedLastHour = 0;
+        for (const row of lastHourCounts.rows) {
+            const status = row.status;
+            const count = Number(row.c ?? 0);
+            if (status === "completed")
+                completedLastHour = count;
+            else if (status === "failed")
+                failedLastHour = count;
+        }
+        // Oldest pending task — used to surface stuck queues.
+        let oldestPendingAgeSeconds = 0;
+        if (pending > 0) {
+            const oldest = await client.execute({
+                sql: `SELECT created_at FROM integration_pending_tasks
+              WHERE status = 'pending'
+              ORDER BY created_at ASC
+              LIMIT 1`,
+                args: [],
+            });
+            const oldestRow = oldest.rows[0];
+            if (oldestRow) {
+                const createdAt = Number(oldestRow.created_at ?? now);
+                oldestPendingAgeSeconds = Math.max(0, Math.floor((now - createdAt) / 1000));
+            }
+        }
+        // Recent failures, capped at 5 — enough to spot patterns without
+        // blowing up the response payload.
+        const failures = await client.execute({
+            sql: `SELECT id, platform, error_message, attempts FROM integration_pending_tasks
+            WHERE status = 'failed' AND updated_at >= ?
+            ORDER BY updated_at DESC
+            LIMIT 5`,
+            args: [oneHourAgo],
+        });
+        const recentFailures = failures.rows.map((row) => ({
+            id: String(row.id ?? ""),
+            platform: String(row.platform ?? ""),
+            error: String(row.error_message ?? ""),
+            attempts: Number(row.attempts ?? 0),
+        }));
+        return {
+            pending,
+            processing,
+            completed_last_hour: completedLastHour,
+            failed_last_hour: failedLastHour,
+            oldest_pending_age_seconds: oldestPendingAgeSeconds,
+            recent_failures: recentFailures,
+        };
+    }
+    catch (err) {
+        if (isMissingTableError(err)) {
+            return { ...ZERO_STATS, recent_failures: [] };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=task-queue-stats.js.map

package/dist/integrations/task-queue-stats.js.map

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

package/dist/integrations/types.d.ts

@@ -58,6 +58,10 @@ export interface IntegrationStatus {
     error?: string;
     /** The webhook URL that should be configured in the platform */
     webhookUrl?: string;
+    /** The full list of env keys (required + optional) the adapter recognizes,
+     *  including UI hints. Surfaced on the integrations status endpoint so the
+     *  frontend can render fields without hard-coding them per platform. */
+    requiredEnvKeys?: import("../server/create-server.js").EnvKeyConfig[];
 }
 /**
  * Platform adapter interface — implement this for each messaging platform.
@@ -96,8 +100,28 @@ export interface PlatformAdapter {
     parseIncomingMessage(event: H3Event): Promise<IncomingMessage | null>;
     /**
      * Send the agent's response back to the messaging platform.
+     *
+     * If `opts.placeholderRef` is provided (returned earlier by
+     * `postProcessingPlaceholder`), adapters that support in-place edits should
+     * update that placeholder message rather than posting a new one. Adapters
+     * without an "update message" API can ignore the ref and post fresh.
      */
-    sendResponse(message: OutgoingMessage, context: IncomingMessage): Promise<void>;
+    sendResponse(message: OutgoingMessage, context: IncomingMessage, opts?: {
+        placeholderRef?: string;
+    }): Promise<void>;
+    /**
+     * Optionally post a "working on it…" placeholder message immediately when a
+     * webhook arrives, before the agent loop runs. Adapters that support
+     * in-place message edits (Slack via `chat.update`, etc.) return an opaque
+     * `placeholderRef` that the webhook flow threads through to `sendResponse`
+     * so the same message is updated with the final answer once ready.
+     *
+     * Adapters without edit support should leave this undefined; the webhook
+     * handler will skip the placeholder step entirely.
+     */
+    postProcessingPlaceholder?(incoming: IncomingMessage): Promise<{
+        placeholderRef: string;
+    } | null>;
     /**
      * Send a proactive outbound message to a platform destination. Adapters that
      * only support direct replies can omit this.
@@ -106,8 +130,15 @@ export interface PlatformAdapter {
     /**
      * Format plain agent response text into a platform-appropriate message.
      * Handles markdown conversion, message splitting for length limits, etc.
+     *
+     * `opts.threadDeepLinkUrl`, when present, is a URL back to the originating
+     * thread in the dispatch UI. Adapters that support rich blocks should
+     * render this as a button (Slack); adapters that don't may inline it as a
+     * link or simply omit it.
      */
-    formatAgentResponse(text: string): OutgoingMessage;
+    formatAgentResponse(text: string, opts?: {
+        threadDeepLinkUrl?: string;
+    }): OutgoingMessage;
     /** Return current connection/configuration status for the settings UI. */
     getStatus(baseUrl?: string): Promise<IntegrationStatus>;
 }
@@ -115,6 +146,8 @@ export interface PlatformAdapter {
  * Options for the integrations plugin.
  */
 export interface IntegrationsPluginOptions {
+    /** App identifier used by call-agent to prevent self-calls (e.g. "dispatch"). */
+    appId?: string;
     /** 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. */

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

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

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

@@ -1,6 +1,7 @@
 import type { H3Event } from "h3";
 import type { PlatformAdapter, IncomingMessage } from "./types.js";
 import { type ActionEntry } from "../agent/production-agent.js";
+import { type PendingTask } from "./pending-tasks-store.js";
 export interface WebhookHandlerOptions {
     adapter: PlatformAdapter;
     /** Resolved system prompt string */
@@ -13,6 +14,13 @@ export interface WebhookHandlerOptions {
     apiKey: string;
     /** Thread owner for personal/shared resource loading */
     ownerEmail: string;
+    /**
+     * Pre-parsed incoming message. When provided, handleWebhook skips its own
+     * verification + parsing steps. Required when the caller has already read
+     * the request body (h3 doesn't reliably cache parsed bodies, so re-parsing
+     * the same event hangs on streaming providers).
+     */
+    incoming?: IncomingMessage;
     /** Optional hook to intercept inbound commands before agent execution */
     beforeProcess?: (incoming: IncomingMessage, adapter: PlatformAdapter) => Promise<{
         handled: true;
@@ -28,13 +36,30 @@ export interface WebhookHandlerOptions {
  * 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
+ * 4. Persist task to SQL
+ * 5. Fire-and-forget POST to /_agent-native/integrations/process-task
+ *    (a fresh function execution with its own timeout budget)
+ * 6. Return HTTP 200 immediately (within Slack's 3s SLA)
+ *
+ * The processor endpoint runs the actual agent loop. This split is essential
+ * for serverless platforms (Netlify Lambda, Vercel, Cloudflare Workers) which
+ * freeze the function as soon as the response is returned, killing any
+ * lingering background promises.
  */
 export declare function handleWebhook(event: H3Event, options: WebhookHandlerOptions): Promise<{
     status: number;
     body: unknown;
 }>;
+/**
+ * Resolve the base URL we should dispatch the processor request to.
+ * Prefers explicit env vars (most reliable on serverless), falls back to the
+ * inbound request's headers.
+ */
+export declare function resolveBaseUrl(event: H3Event): string;
+/**
+ * Run the actual agent loop for a previously-enqueued task. Called by the
+ * processor endpoint in `plugin.ts`. This is a fresh function execution, so
+ * it gets its own timeout budget independent of the inbound webhook handler.
+ */
+export declare function processIntegrationTask(task: PendingTask, options: WebhookHandlerOptions): Promise<void>;
 //# sourceMappingURL=webhook-handler.d.ts.map

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

@@ -1 +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"}
+{"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;AAClC,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGnE,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AAWtC,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAoBlC,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;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,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;;;;;;;;;;;;;;;;GAgBG;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,CAsE5C;AA6GD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CA2BrD;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAQf"}