npm - @agent-native/core - Versions diffs - 0.130.0 → 0.130.1 - Mend

@agent-native/core 0.130.0 → 0.130.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (63) hide show

package/dist/integrations/task-queue-stats.d.ts CHANGED Viewed

@@ -10,6 +10,18 @@ export interface TaskQueueStats {
     completed_last_hour: number;
     failed_last_hour: number;
     oldest_pending_age_seconds: number;
+    waiting_campaigns: number;
+    active_a2a_continuations: number;
+    oldest_active_a2a_age_seconds: number;
+    terminal_a2a_without_delivery: number;
+    recent_a2a_orphans: Array<{
+        continuation_id: string;
+        integration_task_id: string;
+        status: string;
+        attempts: number;
+        age_seconds: number;
+        reason_class: string;
+    }>;
     recent_failures: RecentFailure[];
     recent_tasks: Array<{
         id: string;

package/dist/integrations/task-queue-stats.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"task-queue-stats.d.ts","sourceRoot":"","sources":["../../src/integrations/task-queue-stats.ts"],"names":[],"mappings":"~~AAYA~~,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B,EAAE,MAAM,CAAC;IACnC,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;QACrC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;~~AAmBD~~;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,cAAc,CAAC,~~CAkIzB~~"}
1	+ {"version":3,"file":"task-queue-stats.d.ts","sourceRoot":"","sources":["../../src/integrations/task-queue-stats.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,0BAA0B,EAAE,MAAM,CAAC;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,EAAE,MAAM,CAAC;IACjC,6BAA6B,EAAE,MAAM,CAAC;IACtC,6BAA6B,EAAE,MAAM,CAAC;IACtC,kBAAkB,EAAE,KAAK,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;QACrC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAwBD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,cAAc,CAAC,CAkJzB"}

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

@@ -8,6 +8,7 @@
  * columns before the SELECTs execute.
  */
 import { getDbExec } from "../db/client.js";
+import { ensureA2AContinuationsTable } from "./a2a-continuations-store.js";
 import { ensurePendingTasksTable } from "./pending-tasks-store.js";
 const ZERO_STATS = {
     pending: 0,
@@ -15,6 +16,11 @@ const ZERO_STATS = {
     completed_last_hour: 0,
     failed_last_hour: 0,
     oldest_pending_age_seconds: 0,
+    waiting_campaigns: 0,
+    active_a2a_continuations: 0,
+    oldest_active_a2a_age_seconds: 0,
+    terminal_a2a_without_delivery: 0,
+    recent_a2a_orphans: [],
     recent_failures: [],
     recent_tasks: [],
 };
@@ -29,11 +35,14 @@ function isMissingTableError(err) {
  */
 export async function getTaskQueueStats(scope) {
     await ensurePendingTasksTable();
+    await ensureA2AContinuationsTable();
     const client = getDbExec();
     const now = Date.now();
     const oneHourAgo = now - 60 * 60 * 1000;
     const scopeSql = `owner_email = ?
               AND ((org_id IS NULL AND CAST(? AS TEXT) IS NULL) OR org_id = ?)`;
+    const joinedScopeSql = `t.owner_email = ?
+              AND ((t.org_id IS NULL AND CAST(? AS TEXT) IS NULL) OR t.org_id = ?)`;
     const scopeArgs = [scope.ownerEmail, scope.orgId, scope.orgId];
     try {
         // Status counts (pending, processing) — only need the live ones.
@@ -127,12 +136,16 @@ export async function getTaskQueueStats(scope) {
                 : String(row.last_dispatch_outcome),
             age_seconds: Math.max(0, Math.floor((now - Number(row.created_at ?? now)) / 1000)),
         }));
+        const waitingCampaigns = await readWaitingCampaignCount(client, joinedScopeSql, scopeArgs);
+        const a2aStats = await readA2AContinuationStats(client, joinedScopeSql, scopeArgs, now);
         return {
             pending,
             processing,
             completed_last_hour: completedLastHour,
             failed_last_hour: failedLastHour,
             oldest_pending_age_seconds: oldestPendingAgeSeconds,
+            waiting_campaigns: waitingCampaigns,
+            ...a2aStats,
             recent_failures: recentFailures,
             recent_tasks: recentTasks,
         };
@@ -144,4 +157,97 @@ export async function getTaskQueueStats(scope) {
         throw err;
     }
 }
+async function readWaitingCampaignCount(client, scopeSql, scopeArgs) {
+    try {
+        const result = await client.execute({
+            sql: `SELECT COUNT(*) AS c
+              FROM integration_campaigns c
+              INNER JOIN integration_pending_tasks t
+                ON t.id = c.integration_task_id
+             WHERE ${scopeSql}
+               AND c.status = 'waiting'`,
+            args: scopeArgs,
+        });
+        return Number(result.rows[0]?.c ?? 0);
+    }
+    catch (err) {
+        if (isMissingTableError(err))
+            return 0;
+        throw err;
+    }
+}
+async function readA2AContinuationStats(client, scopeSql, scopeArgs, now) {
+    try {
+        const live = await client.execute({
+            sql: `SELECT
+                   COUNT(CASE WHEN c.status IN ('pending', 'processing', 'delivering') THEN 1 END) AS active_count,
+                   MIN(CASE WHEN c.status IN ('pending', 'processing', 'delivering') THEN c.created_at END) AS oldest_created_at,
+                   COUNT(CASE WHEN c.status IN ('completed', 'failed')
+                         AND c.terminal_delivery_confirmed_at IS NULL THEN 1 END) AS orphan_count
+              FROM integration_a2a_continuations c
+              INNER JOIN integration_pending_tasks t
+                ON t.id = c.integration_task_id
+             WHERE ${scopeSql}`,
+            args: scopeArgs,
+        });
+        const orphaned = await client.execute({
+            sql: `SELECT c.id, c.integration_task_id, c.status, c.attempts,
+                   c.created_at, c.error_message
+              FROM integration_a2a_continuations c
+              INNER JOIN integration_pending_tasks t
+                ON t.id = c.integration_task_id
+             WHERE ${scopeSql}
+               AND c.status IN ('completed', 'failed')
+               AND c.terminal_delivery_confirmed_at IS NULL
+             ORDER BY c.updated_at DESC
+             LIMIT 5`,
+            args: scopeArgs,
+        });
+        const activeCount = Number(live.rows[0]?.active_count ?? 0);
+        const orphanCount = Number(live.rows[0]?.orphan_count ?? 0);
+        const oldestCreatedAt = Number(live.rows[0]?.oldest_created_at ?? now);
+        const recentOrphans = orphaned.rows.map((row) => ({
+            continuation_id: String(row.id ?? ""),
+            integration_task_id: String(row.integration_task_id ?? ""),
+            status: String(row.status ?? ""),
+            attempts: Number(row.attempts ?? 0),
+            age_seconds: Math.max(0, Math.floor((now - Number(row.created_at ?? now)) / 1000)),
+            reason_class: classifyA2AOrphanReason(row.error_message),
+        }));
+        return {
+            active_a2a_continuations: activeCount,
+            oldest_active_a2a_age_seconds: activeCount > 0
+                ? Math.max(0, Math.floor((now - oldestCreatedAt) / 1000))
+                : 0,
+            terminal_a2a_without_delivery: orphanCount,
+            recent_a2a_orphans: recentOrphans,
+        };
+    }
+    catch (err) {
+        if (isMissingTableError(err)) {
+            return {
+                active_a2a_continuations: 0,
+                oldest_active_a2a_age_seconds: 0,
+                terminal_a2a_without_delivery: 0,
+                recent_a2a_orphans: [],
+            };
+        }
+        throw err;
+    }
+}
+function classifyA2AOrphanReason(value) {
+    const message = String(value ?? "");
+    if (!message)
+        return "missing_terminal_delivery";
+    if (/timeout|timed out|abort/i.test(message))
+        return "timeout";
+    if (/token|secret|auth|credential/i.test(message))
+        return "authentication";
+    if (/database|sql|store|persist/i.test(message))
+        return "persistence";
+    if (/slack|provider|deliver|stream|response/i.test(message)) {
+        return "provider_delivery";
+    }
+    return "processor_failure";
+}
 //# sourceMappingURL=task-queue-stats.js.map

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

	@@ -1 +1 @@
1	- {"version":3,"file":"task-queue-stats.js","sourceRoot":"","sources":["../../src/integrations/task-queue-stats.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Read-only observability helpers for the integration task queue.\n \n Lives in its own file so it stays out of `pending-tasks-store.ts`, which is\n * actively being edited by the agent that owns the queue itself. These\n * Queue reads never expose payloads or user text. The helper first runs the\n * additive schema guard so older deployments gain the dispatch diagnostic\n * columns before the SELECTs execute.\n /\nimport { getDbExec } from \"../db/client.js\";\nimport { ensurePendingTasksTable } from \"./pending-tasks-store.js\";\n\nexport interface RecentFailure {\n id: string;\n platform: string;\n error: string;\n attempts: number;\n}\n\nexport interface TaskQueueStats {\n pending: number;\n processing: number;\n completed_last_hour: number;\n failed_last_hour: number;\n oldest_pending_age_seconds: number;\n recent_failures: RecentFailure[];\n recent_tasks: Array<{\n id: string;\n platform: string;\n status: string;\n attempts: number;\n dispatch_attempts: number;\n last_dispatch_outcome: string \| null;\n age_seconds: number;\n }>;\n}\n\nexport interface TaskQueueStatsScope {\n ownerEmail: string;\n orgId: string \| null;\n}\n\nconst ZERO_STATS: TaskQueueStats = {\n pending: 0,\n processing: 0,\n completed_last_hour: 0,\n failed_last_hour: 0,\n oldest_pending_age_seconds: 0,\n recent_failures: [],\n recent_tasks: [],\n};\n\nfunction isMissingTableError(err: unknown): boolean {\n const msg = err instanceof Error ? err.message : String(err ?? \"\");\n return /no such table\|does not exist\|relation . does not exist\|undefined_table/i.test(\n msg,\n );\n}\n\n/*\n Get a snapshot of the integration task queue health.\n \n Safe to call before the pending-tasks store has initialized the schema.\n /\nexport async function getTaskQueueStats(\n scope: TaskQueueStatsScope,\n): Promise<TaskQueueStats> {\n await ensurePendingTasksTable();\n const client = getDbExec();\n const now = Date.now();\n const oneHourAgo = now - 60 60 * 1000;\n const scopeSql = `owner_email = ?\n AND ((org_id IS NULL AND CAST(? AS TEXT) IS NULL) OR org_id = ?)`;\n const scopeArgs = [scope.ownerEmail, scope.orgId, scope.orgId];\n\n try {\n // Status counts (pending, processing) — only need the live ones.\n const liveCounts = await client.execute({\n sql: `SELECT status, COUNT() AS c FROM integration_pending_tasks\n WHERE ${scopeSql}\n AND status IN ('pending', 'processing')\n GROUP BY status`,\n args: scopeArgs,\n });\n\n let pending = 0;\n let processing = 0;\n for (const row of liveCounts.rows as Array<Record<string, unknown>>) {\n const status = row.status as string;\n const count = Number(row.c ?? 0);\n if (status === \"pending\") pending = count;\n else if (status === \"processing\") processing = count;\n }\n\n // Last-hour completion + failure counts. updated_at is the most reliable\n // column — completed_at can be null on failed tasks, and created_at would\n // miss tasks queued >1h ago that just finished now.\n const lastHourCounts = await client.execute({\n sql: `SELECT status, COUNT() AS c FROM integration_pending_tasks\n WHERE ${scopeSql}\n AND status IN ('completed', 'failed') AND updated_at >= ?\n GROUP BY status`,\n args: [...scopeArgs, oneHourAgo],\n });\n\n let completedLastHour = 0;\n let failedLastHour = 0;\n for (const row of lastHourCounts.rows as Array<Record<string, unknown>>) {\n const status = row.status as string;\n const count = Number(row.c ?? 0);\n if (status === \"completed\") completedLastHour = count;\n else if (status === \"failed\") failedLastHour = count;\n }\n\n // Oldest pending task — used to surface stuck queues.\n let oldestPendingAgeSeconds = 0;\n if (pending > 0) {\n const oldest = await client.execute({\n sql: `SELECT created_at FROM integration_pending_tasks\n WHERE ${scopeSql}\n AND status = 'pending'\n ORDER BY created_at ASC\n LIMIT 1`,\n args: scopeArgs,\n });\n const oldestRow = oldest.rows[0] as Record<string, unknown> \| undefined;\n if (oldestRow) {\n const createdAt = Number(oldestRow.created_at ?? now);\n oldestPendingAgeSeconds = Math.max(\n 0,\n Math.floor((now - createdAt) / 1000),\n );\n }\n }\n\n // Recent failures, capped at 5 — enough to spot patterns without\n // blowing up the response payload.\n const failures = await client.execute({\n sql: `SELECT id, platform, error_message, attempts FROM integration_pending_tasks\n WHERE ${scopeSql}\n AND status = 'failed' AND updated_at >= ?\n ORDER BY updated_at DESC\n LIMIT 5`,\n args: [...scopeArgs, oneHourAgo],\n });\n const recentFailures: RecentFailure[] = (\n failures.rows as Array<Record<string, unknown>>\n ).map((row) => ({\n id: String(row.id ?? \"\"),\n platform: String(row.platform ?? \"\"),\n error: String(row.error_message ?? \"\"),\n attempts: Number(row.attempts ?? 0),\n }));\n\n const recent = await client.execute({\n sql: `SELECT id, platform, status, attempts, dispatch_attempts,\n last_dispatch_outcome, created_at\n FROM integration_pending_tasks\n WHERE ${scopeSql}\n ORDER BY created_at DESC\n LIMIT 10`,\n args: scopeArgs,\n });\n const recentTasks = (recent.rows as Array<Record<string, unknown>>).map(\n (row) => ({\n id: String(row.id ?? \"\"),\n platform: String(row.platform ?? \"\"),\n status: String(row.status ?? \"\"),\n attempts: Number(row.attempts ?? 0),\n dispatch_attempts: Number(row.dispatch_attempts ?? 0),\n last_dispatch_outcome:\n row.last_dispatch_outcome == null\n ? null\n : String(row.last_dispatch_outcome),\n age_seconds: Math.max(\n 0,\n Math.floor((now - Number(row.created_at ?? now)) / 1000),\n ),\n }),\n );\n\n return {\n pending,\n processing,\n completed_last_hour: completedLastHour,\n failed_last_hour: failedLastHour,\n oldest_pending_age_seconds: oldestPendingAgeSeconds,\n recent_failures: recentFailures,\n recent_tasks: recentTasks,\n };\n } catch (err) {\n if (isMissingTableError(err)) {\n return { ...ZERO_STATS, recent_failures: [], recent_tasks: [] };\n }\n throw err;\n }\n}\n"]}
1	+ {"version":3,"file":"task-queue-stats.js","sourceRoot":"","sources":["../../src/integrations/task-queue-stats.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Read-only observability helpers for the integration task queue.\n \n Lives in its own file so it stays out of `pending-tasks-store.ts`, which is\n * actively being edited by the agent that owns the queue itself. These\n * Queue reads never expose payloads or user text. The helper first runs the\n * additive schema guard so older deployments gain the dispatch diagnostic\n * columns before the SELECTs execute.\n /\nimport { getDbExec } from \"../db/client.js\";\nimport { ensureA2AContinuationsTable } from \"./a2a-continuations-store.js\";\nimport { ensurePendingTasksTable } from \"./pending-tasks-store.js\";\n\nexport interface RecentFailure {\n id: string;\n platform: string;\n error: string;\n attempts: number;\n}\n\nexport interface TaskQueueStats {\n pending: number;\n processing: number;\n completed_last_hour: number;\n failed_last_hour: number;\n oldest_pending_age_seconds: number;\n waiting_campaigns: number;\n active_a2a_continuations: number;\n oldest_active_a2a_age_seconds: number;\n terminal_a2a_without_delivery: number;\n recent_a2a_orphans: Array<{\n continuation_id: string;\n integration_task_id: string;\n status: string;\n attempts: number;\n age_seconds: number;\n reason_class: string;\n }>;\n recent_failures: RecentFailure[];\n recent_tasks: Array<{\n id: string;\n platform: string;\n status: string;\n attempts: number;\n dispatch_attempts: number;\n last_dispatch_outcome: string \| null;\n age_seconds: number;\n }>;\n}\n\nexport interface TaskQueueStatsScope {\n ownerEmail: string;\n orgId: string \| null;\n}\n\nconst ZERO_STATS: TaskQueueStats = {\n pending: 0,\n processing: 0,\n completed_last_hour: 0,\n failed_last_hour: 0,\n oldest_pending_age_seconds: 0,\n waiting_campaigns: 0,\n active_a2a_continuations: 0,\n oldest_active_a2a_age_seconds: 0,\n terminal_a2a_without_delivery: 0,\n recent_a2a_orphans: [],\n recent_failures: [],\n recent_tasks: [],\n};\n\nfunction isMissingTableError(err: unknown): boolean {\n const msg = err instanceof Error ? err.message : String(err ?? \"\");\n return /no such table\|does not exist\|relation . does not exist\|undefined_table/i.test(\n msg,\n );\n}\n\n/*\n Get a snapshot of the integration task queue health.\n \n Safe to call before the pending-tasks store has initialized the schema.\n /\nexport async function getTaskQueueStats(\n scope: TaskQueueStatsScope,\n): Promise<TaskQueueStats> {\n await ensurePendingTasksTable();\n await ensureA2AContinuationsTable();\n const client = getDbExec();\n const now = Date.now();\n const oneHourAgo = now - 60 60 * 1000;\n const scopeSql = `owner_email = ?\n AND ((org_id IS NULL AND CAST(? AS TEXT) IS NULL) OR org_id = ?)`;\n const joinedScopeSql = `t.owner_email = ?\n AND ((t.org_id IS NULL AND CAST(? AS TEXT) IS NULL) OR t.org_id = ?)`;\n const scopeArgs = [scope.ownerEmail, scope.orgId, scope.orgId];\n\n try {\n // Status counts (pending, processing) — only need the live ones.\n const liveCounts = await client.execute({\n sql: `SELECT status, COUNT() AS c FROM integration_pending_tasks\n WHERE ${scopeSql}\n AND status IN ('pending', 'processing')\n GROUP BY status`,\n args: scopeArgs,\n });\n\n let pending = 0;\n let processing = 0;\n for (const row of liveCounts.rows as Array<Record<string, unknown>>) {\n const status = row.status as string;\n const count = Number(row.c ?? 0);\n if (status === \"pending\") pending = count;\n else if (status === \"processing\") processing = count;\n }\n\n // Last-hour completion + failure counts. updated_at is the most reliable\n // column — completed_at can be null on failed tasks, and created_at would\n // miss tasks queued >1h ago that just finished now.\n const lastHourCounts = await client.execute({\n sql: `SELECT status, COUNT() AS c FROM integration_pending_tasks\n WHERE ${scopeSql}\n AND status IN ('completed', 'failed') AND updated_at >= ?\n GROUP BY status`,\n args: [...scopeArgs, oneHourAgo],\n });\n\n let completedLastHour = 0;\n let failedLastHour = 0;\n for (const row of lastHourCounts.rows as Array<Record<string, unknown>>) {\n const status = row.status as string;\n const count = Number(row.c ?? 0);\n if (status === \"completed\") completedLastHour = count;\n else if (status === \"failed\") failedLastHour = count;\n }\n\n // Oldest pending task — used to surface stuck queues.\n let oldestPendingAgeSeconds = 0;\n if (pending > 0) {\n const oldest = await client.execute({\n sql: `SELECT created_at FROM integration_pending_tasks\n WHERE ${scopeSql}\n AND status = 'pending'\n ORDER BY created_at ASC\n LIMIT 1`,\n args: scopeArgs,\n });\n const oldestRow = oldest.rows[0] as Record<string, unknown> \| undefined;\n if (oldestRow) {\n const createdAt = Number(oldestRow.created_at ?? now);\n oldestPendingAgeSeconds = Math.max(\n 0,\n Math.floor((now - createdAt) / 1000),\n );\n }\n }\n\n // Recent failures, capped at 5 — enough to spot patterns without\n // blowing up the response payload.\n const failures = await client.execute({\n sql: `SELECT id, platform, error_message, attempts FROM integration_pending_tasks\n WHERE ${scopeSql}\n AND status = 'failed' AND updated_at >= ?\n ORDER BY updated_at DESC\n LIMIT 5`,\n args: [...scopeArgs, oneHourAgo],\n });\n const recentFailures: RecentFailure[] = (\n failures.rows as Array<Record<string, unknown>>\n ).map((row) => ({\n id: String(row.id ?? \"\"),\n platform: String(row.platform ?? \"\"),\n error: String(row.error_message ?? \"\"),\n attempts: Number(row.attempts ?? 0),\n }));\n\n const recent = await client.execute({\n sql: `SELECT id, platform, status, attempts, dispatch_attempts,\n last_dispatch_outcome, created_at\n FROM integration_pending_tasks\n WHERE ${scopeSql}\n ORDER BY created_at DESC\n LIMIT 10`,\n args: scopeArgs,\n });\n const recentTasks = (recent.rows as Array<Record<string, unknown>>).map(\n (row) => ({\n id: String(row.id ?? \"\"),\n platform: String(row.platform ?? \"\"),\n status: String(row.status ?? \"\"),\n attempts: Number(row.attempts ?? 0),\n dispatch_attempts: Number(row.dispatch_attempts ?? 0),\n last_dispatch_outcome:\n row.last_dispatch_outcome == null\n ? null\n : String(row.last_dispatch_outcome),\n age_seconds: Math.max(\n 0,\n Math.floor((now - Number(row.created_at ?? now)) / 1000),\n ),\n }),\n );\n const waitingCampaigns = await readWaitingCampaignCount(\n client,\n joinedScopeSql,\n scopeArgs,\n );\n const a2aStats = await readA2AContinuationStats(\n client,\n joinedScopeSql,\n scopeArgs,\n now,\n );\n\n return {\n pending,\n processing,\n completed_last_hour: completedLastHour,\n failed_last_hour: failedLastHour,\n oldest_pending_age_seconds: oldestPendingAgeSeconds,\n waiting_campaigns: waitingCampaigns,\n ...a2aStats,\n recent_failures: recentFailures,\n recent_tasks: recentTasks,\n };\n } catch (err) {\n if (isMissingTableError(err)) {\n return { ...ZERO_STATS, recent_failures: [], recent_tasks: [] };\n }\n throw err;\n }\n}\n\nasync function readWaitingCampaignCount(\n client: ReturnType<typeof getDbExec>,\n scopeSql: string,\n scopeArgs: Array<string \| null>,\n): Promise<number> {\n try {\n const result = await client.execute({\n sql: `SELECT COUNT(*) AS c\n FROM integration_campaigns c\n INNER JOIN integration_pending_tasks t\n ON t.id = c.integration_task_id\n WHERE ${scopeSql}\n AND c.status = 'waiting'`,\n args: scopeArgs,\n });\n return Number(result.rows[0]?.c ?? 0);\n } catch (err) {\n if (isMissingTableError(err)) return 0;\n throw err;\n }\n}\n\nasync function readA2AContinuationStats(\n client: ReturnType<typeof getDbExec>,\n scopeSql: string,\n scopeArgs: Array<string \| null>,\n now: number,\n): Promise<\n Pick<\n TaskQueueStats,\n \| \"active_a2a_continuations\"\n \| \"oldest_active_a2a_age_seconds\"\n \| \"terminal_a2a_without_delivery\"\n \| \"recent_a2a_orphans\"\n >\n> {\n try {\n const live = await client.execute({\n sql: `SELECT\n COUNT(CASE WHEN c.status IN ('pending', 'processing', 'delivering') THEN 1 END) AS active_count,\n MIN(CASE WHEN c.status IN ('pending', 'processing', 'delivering') THEN c.created_at END) AS oldest_created_at,\n COUNT(CASE WHEN c.status IN ('completed', 'failed')\n AND c.terminal_delivery_confirmed_at IS NULL THEN 1 END) AS orphan_count\n FROM integration_a2a_continuations c\n INNER JOIN integration_pending_tasks t\n ON t.id = c.integration_task_id\n WHERE ${scopeSql}`,\n args: scopeArgs,\n });\n const orphaned = await client.execute({\n sql: `SELECT c.id, c.integration_task_id, c.status, c.attempts,\n c.created_at, c.error_message\n FROM integration_a2a_continuations c\n INNER JOIN integration_pending_tasks t\n ON t.id = c.integration_task_id\n WHERE ${scopeSql}\n AND c.status IN ('completed', 'failed')\n AND c.terminal_delivery_confirmed_at IS NULL\n ORDER BY c.updated_at DESC\n LIMIT 5`,\n args: scopeArgs,\n });\n const activeCount = Number(live.rows[0]?.active_count ?? 0);\n const orphanCount = Number(live.rows[0]?.orphan_count ?? 0);\n const oldestCreatedAt = Number(live.rows[0]?.oldest_created_at ?? now);\n const recentOrphans = (orphaned.rows as Array<Record<string, unknown>>).map(\n (row) => ({\n continuation_id: String(row.id ?? \"\"),\n integration_task_id: String(row.integration_task_id ?? \"\"),\n status: String(row.status ?? \"\"),\n attempts: Number(row.attempts ?? 0),\n age_seconds: Math.max(\n 0,\n Math.floor((now - Number(row.created_at ?? now)) / 1000),\n ),\n reason_class: classifyA2AOrphanReason(row.error_message),\n }),\n );\n return {\n active_a2a_continuations: activeCount,\n oldest_active_a2a_age_seconds:\n activeCount > 0\n ? Math.max(0, Math.floor((now - oldestCreatedAt) / 1000))\n : 0,\n terminal_a2a_without_delivery: orphanCount,\n recent_a2a_orphans: recentOrphans,\n };\n } catch (err) {\n if (isMissingTableError(err)) {\n return {\n active_a2a_continuations: 0,\n oldest_active_a2a_age_seconds: 0,\n terminal_a2a_without_delivery: 0,\n recent_a2a_orphans: [],\n };\n }\n throw err;\n }\n}\n\nfunction classifyA2AOrphanReason(value: unknown): string {\n const message = String(value ?? \"\");\n if (!message) return \"missing_terminal_delivery\";\n if (/timeout\|timed out\|abort/i.test(message)) return \"timeout\";\n if (/token\|secret\|auth\|credential/i.test(message)) return \"authentication\";\n if (/database\|sql\|store\|persist/i.test(message)) return \"persistence\";\n if (/slack\|provider\|deliver\|stream\|response/i.test(message)) {\n return \"provider_delivery\";\n }\n return \"processor_failure\";\n}\n"]}

package/dist/integrations/types.d.ts CHANGED Viewed

@@ -122,6 +122,18 @@ export interface PlatformDeliveryReceipt {
     /** Opaque provider message ids/timestamps; never message content. */
     messageRefs?: string[];
 }
+export interface PlatformDeliveryOptions {
+    /** Provider-owned message reference that should be updated in place. */
+    placeholderRef?: string;
+    /** Stable logical delivery key for provider-side retry reconciliation. */
+    idempotencyKey?: string;
+    /** Earliest provider timestamp (epoch ms) that can contain this delivery. */
+    reconcileAfter?: number;
+    /** Abort provider I/O before the caller releases its durable delivery claim. */
+    signal?: AbortSignal;
+    /** Do not fall back to a fresh post if the stable target cannot be updated. */
+    strictTargetRef?: boolean;
+}
 /**
  * Proactive outbound message target for a platform.
  * Used when the agent needs to send to a saved destination instead of replying
@@ -186,12 +198,20 @@ export interface PlatformRunProgress {
      * credentials, or provider payload.
      */
     ref?: PlatformRunProgressRef;
+    /** Stable provider message target that can receive the terminal answer. */
+    responseTargetRef?: string;
     /** Receive normalized agent events. Implementations should throttle writes. */
-    onEvent(event: AgentChatEvent): Promise<void> | void;
+    onEvent(event: AgentChatEvent, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void> | void;
     /** Finalize the provider-native progress surface with the answer. */
-    complete(message: OutgoingMessage): Promise<void | PlatformDeliveryReceipt>;
+    complete(message: OutgoingMessage, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void | PlatformDeliveryReceipt>;
     /** Mark the provider-native surface failed and leave a retryable explanation. */
-    fail?(message: string): Promise<void>;
+    fail?(message: string, opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
 }
 /**
  * Safe, minimal reference to a provider-native run-progress surface.
@@ -284,9 +304,7 @@ export interface PlatformAdapter {
      * 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, opts?: {
-        placeholderRef?: string;
-    }): Promise<void | PlatformDeliveryReceipt>;
+    sendResponse(message: OutgoingMessage, context: IncomingMessage, opts?: PlatformDeliveryOptions): Promise<void | PlatformDeliveryReceipt>;
     /**
      * Send a short best-effort system notice to the conversation the incoming
      * message arrived on (polite identity declines, one-time access guidance).

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

	@@ -1 +1 @@
1	- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/integrations/types.ts"],"names":[],"mappings":"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~~CAAC~~,KAAK,EAAE,cAAc,~~GAAG~~,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;~~IACrD~~,qEAAqE;IACrE,QAAQ,~~CAAC~~,OAAO,EAAE,eAAe,~~GAAG~~,OAAO,CAAC,IAAI,GAAG,uBAAuB,CAAC,CAAC;~~IAC5E~~,iFAAiF;IACjF,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;~~CACvC~~;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,qBAAa,kCAAmC,SAAQ,KAAK;IAIzD,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,2BAA2B;IAJxD,QAAQ,CAAC,IAAI,qCAAqC;IAElD,YACW,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,2BAA2B,EAIvD;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;IAE7D,0DAA0D;IAC1D,kBAAkB,IAAI,YAAY,EAAE,CAAC;IAErC;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;QAC1C,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;IAEH;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhD;;;OAGG;IACH,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEtE;;;;OAIG;IACH,sBAAsB,CAAC,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE7E;;;;OAIG;IACH,uBAAuB,CAAC,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE9E;;;;OAIG;IACH,2BAA2B,CAAC,CAC1B,QAAQ,EAAE,eAAe,GACxB,wBAAwB,GAAG,IAAI,CAAC;IAEnC;;;;OAIG;IACH,0BAA0B,CAAC,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE,CAAC;IAEjE;;;;;;;OAOG;IACH,YAAY,CACV,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,eAAe,EACxB,IAAI,CAAC,EAAE~~;QAAE~~,~~cAAc~~,~~CAAC~~,~~EAAE,MAAM,CAAA;KAAE,GACjC,~~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"}
1	+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/integrations/types.ts"],"names":[],"mappings":"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"}

package/dist/integrations/types.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/integrations/types.ts"],"names":[],"mappings":"AAqOA,MAAM,OAAO,kCAAmC,SAAQ,KAAK;IAIhD,QAAQ;IACR,UAAU;IAJZ,IAAI,GAAG,iCAAiC,CAAC;IAElD,YACW,QAAgB,EAChB,UAA6C;QAEtD,KAAK,CAAC,YAAY,QAAQ,qBAAqB,UAAU,EAAE,CAAC,CAAC;wBAHpD,QAAQ;0BACR,UAAU;QAGnB,IAAI,CAAC,IAAI,GAAG,oCAAoC,CAAC;IACnD,CAAC;CACF;AAkKD,MAAM,UAAU,wBAAwB,CACtC,OAAwB,EACxB,UAA6C;IAE7C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,kCAAkC,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC","sourcesContent":["import type { H3Event } from \"h3\";\n\nimport type { AgentChatEvent } from \"../agent/types.js\";\nimport type { EnvKeyConfig } from \"../server/create-server.js\";\n\nexport type IntegrationConversationType =\n \| \"channel\"\n \| \"private_channel\"\n \| \"dm\"\n \| \"group_dm\"\n \| \"unknown\";\n\nexport type IntegrationTriggerKind = \"mention\" \| \"dm\" \| \"thread_reply\";\n\nexport interface IntegrationActorTrust {\n memberType: \"owner\" \| \"admin\" \| \"member\" \| \"guest\" \| \"external\" \| \"unknown\";\n verified: boolean;\n}\n\nexport interface IntegrationContextMessage {\n senderId?: string;\n senderName?: string;\n text: string;\n timestamp: number;\n sourceUrl?: string;\n reactions?: Array<{ name: string; count: number }>;\n files?: IntegrationFileReference[];\n}\n\nexport interface IntegrationFileReference {\n id: string;\n name?: string;\n mimetype?: string;\n size?: number;\n permalink?: string;\n downloadUrl?: string;\n}\n\n/*\n Normalized incoming message from any messaging platform.\n /\nexport interface IncomingMessage {\n /* Platform identifier (e.g., \"slack\", \"telegram\", \"whatsapp\") /\n platform: string;\n /* Platform-specific thread/conversation identifier /\n externalThreadId: string;\n /* Message text content /\n text: string;\n /* Display name of the sender /\n senderName?: string;\n /* Verified sender email, when the platform can provide one /\n senderEmail?: string;\n /* Platform-specific sender ID /\n senderId?: string;\n /* How this message intentionally invoked an agent. /\n triggerKind?: IntegrationTriggerKind;\n /* Normalized provider conversation type for policy evaluation. /\n conversationType?: IntegrationConversationType;\n /* Provider tenant/workspace identifier. /\n tenantId?: string;\n /* Authorized integration scope resolved before execution. /\n integrationScopeId?: string;\n /* Normalized actor trust; unknown/unverified callers fail closed. /\n actorTrust?: IntegrationActorTrust;\n /* Bounded provider-native conversation context hydrated at run time. /\n contextMessages?: IntegrationContextMessage[];\n /* Provider file references only. Raw file bodies never belong here. /\n files?: IntegrationFileReference[];\n /* Server-verified approval grants carried by an interaction continuation. /\n approvedToolCalls?: string[];\n /\n Whether the platform cryptographically authenticated that the message\n * genuinely came from the claimed sender (e.g. inbound email that passed\n * DKIM, or an aligned SPF pass, for the From domain). Defaults to\n * undefined/false for platforms that don't provide sender authentication.\n \n Owner-resolution paths that grant a real user's identity/credentials\n * MUST treat a missing/false value as \"unverified\" and fail closed —\n * never derive a privileged acting identity from an unverified sender.\n /\n senderVerified?: boolean;\n /* Raw platform-specific context needed for routing responses /\n platformContext: Record<string, unknown>;\n /\n Short-lived delivery context needed only while the queued task is active.\n * Secrets such as Discord interaction tokens belong here, never in\n * `platformContext`, thread mappings, logs, or agent-visible context.\n /\n responseContext?: Record<string, unknown>;\n /* Provider-native thread/topic reference, when one exists. /\n threadRef?: string;\n /\n Canonical provider URL for the originating message thread, when the\n * provider can resolve one. This is safe agent-visible provenance (not a\n * credential) and should be preserved across A2A delegation so created\n * artifacts can link back to their request source.\n /\n sourceUrl?: string;\n /\n Trusted app-side routing guidance added after provider parsing. Adapters\n * should not copy this from user-controlled webhook payload fields.\n /\n routingHint?: {\n targetAgent?: string;\n instruction: string;\n };\n /\n Trusted app-side note about the caller's identity/visibility tier, set\n * after execution-context resolution (e.g. an anonymous org-scoped Slack\n * member). Surfaced to the agent as integration context. Adapters must not\n * copy this from user-controlled webhook payload fields.\n /\n identityNote?: string;\n /* Provider-native message/activity reference for contextual replies. /\n replyRef?: string;\n /* Message timestamp (epoch ms) /\n timestamp: number;\n}\n\n/\n Outgoing message to send back to a messaging platform.\n /\nexport interface OutgoingMessage {\n /* Text content of the response /\n text: string;\n /* Platform-specific payload (e.g., Slack blocks, Telegram parse_mode) /\n platformContext: Record<string, unknown>;\n}\n\n/* Provider-confirmed references for a successfully delivered response. /\nexport interface PlatformDeliveryReceipt {\n status: \"delivered\";\n /* Opaque provider message ids/timestamps; never message content. /\n messageRefs?: string[];\n}\n\n/\n Proactive outbound message target for a platform.\n * Used when the agent needs to send to a saved destination instead of replying\n * to the current inbound thread.\n /\nexport interface OutboundTarget {\n /* Canonical platform-specific destination id (channel, chat, thread, etc.) /\n destination: string;\n /* Optional thread reference when the destination supports threading /\n threadRef?: string \| null;\n /* Optional fallback display label /\n label?: string;\n /* Provider tenant/workspace used to select an installation credential. /\n tenantId?: string;\n /* Managed installation id when the caller already resolved it. /\n installationId?: string;\n}\n\n/\n Connection status for a platform integration.\n /\nexport interface IntegrationStatus {\n platform: string;\n /* Human-readable label (e.g., \"Slack\", \"Telegram\") /\n label: string;\n /* Whether the integration is explicitly enabled /\n enabled: boolean;\n /* Whether all required credentials are configured /\n configured: boolean;\n /* Platform-specific details (workspace name, bot username, etc.) /\n details?: Record<string, unknown>;\n /* Error message if something is wrong /\n error?: string;\n /* The webhook URL that should be configured in the platform /\n webhookUrl?: string;\n /* The full list of env keys (required + optional) the adapter recognizes,\n * including UI hints. Surfaced on the integrations status endpoint so the\n * frontend can render fields without hard-coding them per platform. /\n requiredEnvKeys?: import(\"../server/create-server.js\").EnvKeyConfig[];\n}\n\nexport interface PlatformAdapterCapabilities {\n /* The adapter can deliver a response to the current inbound event. /\n replyText: boolean;\n /* The adapter can send without an active inbound event. /\n proactiveMessages: boolean;\n /* The adapter preserves a provider-native thread or topic reference. /\n nativeThreads: boolean;\n /* The adapter can quote/reply to a specific inbound message. /\n contextualReplies: boolean;\n /* The provider requires an immediate deferred webhook acknowledgement. /\n deferredWebhookResponse: boolean;\n /* The adapter only receives explicit interactions, not ordinary messages. /\n interactionOnly?: boolean;\n /* The adapter can hydrate bounded native thread/file/reaction context. /\n nativeContextHydration?: boolean;\n /* The adapter can surface live agent progress in the provider UI. /\n liveRunProgress?: boolean;\n}\n\nexport interface PlatformRunProgress {\n /\n Opaque, provider-owned reference for resuming this progress surface from a\n * durable continuation. It deliberately contains no user content,\n * credentials, or provider payload.\n /\n ref?: PlatformRunProgressRef;\n /* Receive normalized agent events. Implementations should throttle writes. /\n onEvent(event: AgentChatEvent): Promise<void> \| void;\n /* Finalize the provider-native progress surface with the answer. /\n complete(message: OutgoingMessage): Promise<void \| PlatformDeliveryReceipt>;\n /* Mark the provider-native surface failed and leave a retryable explanation. /\n fail?(message: string): Promise<void>;\n}\n\n/\n Safe, minimal reference to a provider-native run-progress surface.\n \n The field values are opaque to the framework. Adapters may use `kind` to\n * distinguish their own resume strategy and `streamTs` to identify the\n * provider-side stream. No incoming message text, platform payload, or\n * credential belongs here.\n /\nexport interface PlatformRunProgressRef {\n kind: string;\n streamTs: string;\n}\n\nexport interface ImmediateWebhookResponse {\n status: number;\n body: unknown;\n}\n\nexport class UnsupportedPlatformCapabilityError extends Error {\n readonly code = \"UNSUPPORTED_PLATFORM_CAPABILITY\";\n\n constructor(\n readonly platform: string,\n readonly capability: keyof PlatformAdapterCapabilities,\n ) {\n super(`Platform ${platform} does not support ${capability}`);\n this.name = \"UnsupportedPlatformCapabilityError\";\n }\n}\n\n/\n Platform adapter interface — implement this for each messaging platform.\n \n Each adapter handles the platform-specific concerns:\n * - Webhook verification (HMAC signatures, challenge responses)\n * - Message parsing (platform events → normalized IncomingMessage)\n * - Response formatting (agent text → platform-specific format)\n * - Response delivery (POST back to platform API)\n /\nexport interface PlatformAdapter {\n /* Unique platform identifier /\n readonly platform: string;\n /* Human-readable label /\n readonly label: string;\n /* Explicit runtime behavior. Missing fields are treated as unsupported. /\n readonly capabilities?: Partial<PlatformAdapterCapabilities>;\n\n /* Env keys this adapter needs (tokens, secrets, etc.) /\n getRequiredEnvKeys(): EnvKeyConfig[];\n\n /\n Handle platform-specific verification challenges.\n * For example, Slack sends a `url_verification` event when setting up.\n * Return `{ handled: true, response }` to short-circuit the webhook handler.\n /\n handleVerification(event: H3Event): Promise<{\n handled: boolean;\n response?: unknown;\n }>;\n\n /\n Validate the webhook request signature.\n * Returns true if the request is authentic.\n /\n verifyWebhook(event: H3Event): Promise<boolean>;\n\n /\n Parse the webhook payload into a normalized IncomingMessage.\n * Return null to silently ignore the event (bot messages, edits, etc.).\n /\n parseIncomingMessage(event: H3Event): Promise<IncomingMessage \| null>;\n\n /\n Hydrate bounded provider-native context after durable enqueue, outside the\n * provider acknowledgement budget. Implementations must return references,\n * metadata, and text only — never persist file bodies or credentials.\n /\n hydrateIncomingMessage?(incoming: IncomingMessage): Promise<IncomingMessage>;\n\n /\n Hydrate only verified sender identity before execution-context selection.\n * This runs on the provider acknowledgement path and must avoid fetching\n * conversation history or file bodies.\n /\n hydrateIncomingIdentity?(incoming: IncomingMessage): Promise<IncomingMessage>;\n\n /\n Provider-specific response returned only after a message is verified and\n * durably enqueued. Discord uses this to return a type-5 deferred response\n * within its three-second interaction deadline.\n /\n getImmediateWebhookResponse?(\n incoming: IncomingMessage,\n ): ImmediateWebhookResponse \| null;\n\n /\n Return pre-canonical thread ids used by older adapter versions. The\n * integration handler checks these only when the canonical mapping is\n * missing, then aliases a match to the canonical id without forking history.\n /\n getLegacyExternalThreadIds?(incoming: IncomingMessage): string[];\n\n /\n Send the agent's response back to the messaging platform.\n \n If `opts.placeholderRef` is provided (returned earlier by\n * `postProcessingPlaceholder`), adapters that support in-place edits should\n * update that placeholder message rather than posting a new one. Adapters\n * without an \"update message\" API can ignore the ref and post fresh.\n /\n sendResponse(\n message: OutgoingMessage,\n context: IncomingMessage,\n opts?: { placeholderRef?: string },\n ): Promise<void \| PlatformDeliveryReceipt>;\n\n /\n Send a short best-effort system notice to the conversation the incoming\n * message arrived on (polite identity declines, one-time access guidance).\n * Bypasses agent formatting. When `dedupeKey` is provided, the adapter may\n * drop the notice if the same key was sent recently. Callers must treat\n * failures as non-fatal.\n /\n sendSystemNotice?(\n incoming: IncomingMessage,\n text: string,\n opts?: {\n dedupeKey?: string;\n /* Dedupe window for `dedupeKey`. Adapters pick a default when omitted. /\n dedupeTtlMs?: number;\n },\n ): Promise<void>;\n\n /\n Optionally post a \"working on it…\" placeholder message immediately when a\n * webhook arrives, before the agent loop runs. Adapters that support\n * in-place message edits (Slack via `chat.update`, etc.) return an opaque\n * `placeholderRef` that the webhook flow threads through to `sendResponse`\n * so the same message is updated with the final answer once ready.\n \n Adapters without edit support should leave this undefined; the webhook\n * handler will skip the placeholder step entirely.\n /\n postProcessingPlaceholder?(\n incoming: IncomingMessage,\n ): Promise<{ placeholderRef: string } \| null>;\n\n /* Start a provider-native progress/streaming surface for an agent run. /\n startRunProgress?(\n incoming: IncomingMessage,\n ): Promise<PlatformRunProgress \| null>;\n\n /\n Reattach a durable continuation to a provider-native progress surface\n * previously started by this adapter. Adapters that cannot resume a native\n * surface should omit this and the continuation will use its normal reply\n * path instead.\n /\n resumeRunProgress?(\n incoming: IncomingMessage,\n ref: PlatformRunProgressRef,\n ): Promise<PlatformRunProgress \| null>;\n\n /\n Send a proactive outbound message to a platform destination. Adapters that\n * only support direct replies can omit this.\n /\n sendMessageToTarget?(\n message: OutgoingMessage,\n target: OutboundTarget,\n ): Promise<void>;\n\n /\n Format plain agent response text into a platform-appropriate message.\n * Handles markdown conversion, message splitting for length limits, etc.\n \n `opts.threadDeepLinkUrl`, when present, is a URL back to the originating\n * thread in the dispatch UI. Adapters that support rich blocks should\n * render this as a button (Slack); adapters that don't may inline it as a\n * link or simply omit it.\n /\n formatAgentResponse(\n text: string,\n opts?: { threadDeepLinkUrl?: string },\n ): OutgoingMessage;\n\n /* Return current connection/configuration status for the settings UI. /\n getStatus(baseUrl?: string): Promise<IntegrationStatus>;\n}\n\nexport function assertPlatformCapability(\n adapter: PlatformAdapter,\n capability: keyof PlatformAdapterCapabilities,\n): void {\n if (adapter.capabilities?.[capability] !== true) {\n throw new UnsupportedPlatformCapabilityError(adapter.platform, capability);\n }\n}\n\n/\n Options for the integrations plugin.\n /\nexport interface IntegrationsPluginOptions {\n /* App identifier used by call-agent to prevent self-calls (e.g. \"dispatch\"). /\n appId?: string;\n /* Full adapter set to enable. Default: all built-in adapters. /\n adapters?: PlatformAdapter[];\n /* Replace built-in adapters by platform without removing the other defaults. /\n adapterOverrides?: PlatformAdapter[];\n /* System prompt for the agent (same as agent-chat). Inherited from agent-chat plugin if not set. /\n systemPrompt?: string;\n /* Actions registry (same as agent-chat). /\n actions?: Record<string, import(\"../agent/production-agent.js\").ActionEntry>;\n /* Model to use. Defaults to the resolved engine's default model. /\n model?: string;\n /* Anthropic API key. Falls back to ANTHROPIC_API_KEY env var. /\n apiKey?: string;\n /* Agent engine to use. Defaults to the same engine resolver as web chat. /\n engine?:\n \| import(\"../agent/engine/types.js\").AgentEngine\n \| string\n \| {\n name: string;\n config: Record<string, unknown>;\n };\n /\n Resolve which owner should receive personal resource context and own the\n * created chat thread for an incoming platform message.\n /\n resolveOwner?: (incoming: IncomingMessage) => string \| Promise<string>;\n /\n Resolve the durable execution principal for an inbound provider message.\n * Shared channels should use a service principal; DMs may use a verified\n * linked user. When present this supersedes `resolveOwner`.\n /\n resolveExecutionContext?: (\n incoming: IncomingMessage,\n ) => IntegrationExecutionContext \| Promise<IntegrationExecutionContext>;\n /\n Explicitly allow an unlinked, verified Slack workspace member to run a DM\n * with the installation organization's shared/service visibility. Disabled\n * by default: DM identity resolution fails closed unless an app deliberately\n * accepts this wider access tier.\n /\n allowAnonymousOrgScopedSlackDm?: boolean;\n /\n Optional preprocessor for inbound platform messages. Can intercept special\n * commands (such as `/link`) before the agent loop runs.\n /\n beforeProcess?: (\n incoming: IncomingMessage,\n adapter: PlatformAdapter,\n ) => Promise<\n \| {\n handled: true;\n responseText?: string;\n }\n \| { handled: false }\n >;\n}\n\nexport interface IntegrationExecutionContext {\n ownerEmail: string;\n orgId: string \| null;\n principalType: \"user\" \| \"service\";\n installationId?: string;\n scopeId?: string;\n /\n True when a hydrated full workspace member could not be matched to an\n * organization member and runs with the anonymous org-scoped service\n * principal (org-wide visibility only, nothing user-private).\n */\n anonymousMember?: boolean;\n}\n"]}
1	+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/integrations/types.ts"],"names":[],"mappings":"AA0PA,MAAM,OAAO,kCAAmC,SAAQ,KAAK;IAIhD,QAAQ;IACR,UAAU;IAJZ,IAAI,GAAG,iCAAiC,CAAC;IAElD,YACW,QAAgB,EAChB,UAA6C;QAEtD,KAAK,CAAC,YAAY,QAAQ,qBAAqB,UAAU,EAAE,CAAC,CAAC;wBAHpD,QAAQ;0BACR,UAAU;QAGnB,IAAI,CAAC,IAAI,GAAG,oCAAoC,CAAC;IACnD,CAAC;CACF;AAkKD,MAAM,UAAU,wBAAwB,CACtC,OAAwB,EACxB,UAA6C;IAE7C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,kCAAkC,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC7E,CAAC;AACH,CAAC","sourcesContent":["import type { H3Event } from \"h3\";\n\nimport type { AgentChatEvent } from \"../agent/types.js\";\nimport type { EnvKeyConfig } from \"../server/create-server.js\";\n\nexport type IntegrationConversationType =\n \| \"channel\"\n \| \"private_channel\"\n \| \"dm\"\n \| \"group_dm\"\n \| \"unknown\";\n\nexport type IntegrationTriggerKind = \"mention\" \| \"dm\" \| \"thread_reply\";\n\nexport interface IntegrationActorTrust {\n memberType: \"owner\" \| \"admin\" \| \"member\" \| \"guest\" \| \"external\" \| \"unknown\";\n verified: boolean;\n}\n\nexport interface IntegrationContextMessage {\n senderId?: string;\n senderName?: string;\n text: string;\n timestamp: number;\n sourceUrl?: string;\n reactions?: Array<{ name: string; count: number }>;\n files?: IntegrationFileReference[];\n}\n\nexport interface IntegrationFileReference {\n id: string;\n name?: string;\n mimetype?: string;\n size?: number;\n permalink?: string;\n downloadUrl?: string;\n}\n\n/*\n Normalized incoming message from any messaging platform.\n /\nexport interface IncomingMessage {\n /* Platform identifier (e.g., \"slack\", \"telegram\", \"whatsapp\") /\n platform: string;\n /* Platform-specific thread/conversation identifier /\n externalThreadId: string;\n /* Message text content /\n text: string;\n /* Display name of the sender /\n senderName?: string;\n /* Verified sender email, when the platform can provide one /\n senderEmail?: string;\n /* Platform-specific sender ID /\n senderId?: string;\n /* How this message intentionally invoked an agent. /\n triggerKind?: IntegrationTriggerKind;\n /* Normalized provider conversation type for policy evaluation. /\n conversationType?: IntegrationConversationType;\n /* Provider tenant/workspace identifier. /\n tenantId?: string;\n /* Authorized integration scope resolved before execution. /\n integrationScopeId?: string;\n /* Normalized actor trust; unknown/unverified callers fail closed. /\n actorTrust?: IntegrationActorTrust;\n /* Bounded provider-native conversation context hydrated at run time. /\n contextMessages?: IntegrationContextMessage[];\n /* Provider file references only. Raw file bodies never belong here. /\n files?: IntegrationFileReference[];\n /* Server-verified approval grants carried by an interaction continuation. /\n approvedToolCalls?: string[];\n /\n Whether the platform cryptographically authenticated that the message\n * genuinely came from the claimed sender (e.g. inbound email that passed\n * DKIM, or an aligned SPF pass, for the From domain). Defaults to\n * undefined/false for platforms that don't provide sender authentication.\n \n Owner-resolution paths that grant a real user's identity/credentials\n * MUST treat a missing/false value as \"unverified\" and fail closed —\n * never derive a privileged acting identity from an unverified sender.\n /\n senderVerified?: boolean;\n /* Raw platform-specific context needed for routing responses /\n platformContext: Record<string, unknown>;\n /\n Short-lived delivery context needed only while the queued task is active.\n * Secrets such as Discord interaction tokens belong here, never in\n * `platformContext`, thread mappings, logs, or agent-visible context.\n /\n responseContext?: Record<string, unknown>;\n /* Provider-native thread/topic reference, when one exists. /\n threadRef?: string;\n /\n Canonical provider URL for the originating message thread, when the\n * provider can resolve one. This is safe agent-visible provenance (not a\n * credential) and should be preserved across A2A delegation so created\n * artifacts can link back to their request source.\n /\n sourceUrl?: string;\n /\n Trusted app-side routing guidance added after provider parsing. Adapters\n * should not copy this from user-controlled webhook payload fields.\n /\n routingHint?: {\n targetAgent?: string;\n instruction: string;\n };\n /\n Trusted app-side note about the caller's identity/visibility tier, set\n * after execution-context resolution (e.g. an anonymous org-scoped Slack\n * member). Surfaced to the agent as integration context. Adapters must not\n * copy this from user-controlled webhook payload fields.\n /\n identityNote?: string;\n /* Provider-native message/activity reference for contextual replies. /\n replyRef?: string;\n /* Message timestamp (epoch ms) /\n timestamp: number;\n}\n\n/\n Outgoing message to send back to a messaging platform.\n /\nexport interface OutgoingMessage {\n /* Text content of the response /\n text: string;\n /* Platform-specific payload (e.g., Slack blocks, Telegram parse_mode) /\n platformContext: Record<string, unknown>;\n}\n\n/* Provider-confirmed references for a successfully delivered response. /\nexport interface PlatformDeliveryReceipt {\n status: \"delivered\";\n /* Opaque provider message ids/timestamps; never message content. /\n messageRefs?: string[];\n}\n\nexport interface PlatformDeliveryOptions {\n /* Provider-owned message reference that should be updated in place. /\n placeholderRef?: string;\n /* Stable logical delivery key for provider-side retry reconciliation. /\n idempotencyKey?: string;\n /* Earliest provider timestamp (epoch ms) that can contain this delivery. /\n reconcileAfter?: number;\n /* Abort provider I/O before the caller releases its durable delivery claim. /\n signal?: AbortSignal;\n /* Do not fall back to a fresh post if the stable target cannot be updated. /\n strictTargetRef?: boolean;\n}\n\n/\n Proactive outbound message target for a platform.\n * Used when the agent needs to send to a saved destination instead of replying\n * to the current inbound thread.\n /\nexport interface OutboundTarget {\n /* Canonical platform-specific destination id (channel, chat, thread, etc.) /\n destination: string;\n /* Optional thread reference when the destination supports threading /\n threadRef?: string \| null;\n /* Optional fallback display label /\n label?: string;\n /* Provider tenant/workspace used to select an installation credential. /\n tenantId?: string;\n /* Managed installation id when the caller already resolved it. /\n installationId?: string;\n}\n\n/\n Connection status for a platform integration.\n /\nexport interface IntegrationStatus {\n platform: string;\n /* Human-readable label (e.g., \"Slack\", \"Telegram\") /\n label: string;\n /* Whether the integration is explicitly enabled /\n enabled: boolean;\n /* Whether all required credentials are configured /\n configured: boolean;\n /* Platform-specific details (workspace name, bot username, etc.) /\n details?: Record<string, unknown>;\n /* Error message if something is wrong /\n error?: string;\n /* The webhook URL that should be configured in the platform /\n webhookUrl?: string;\n /* The full list of env keys (required + optional) the adapter recognizes,\n * including UI hints. Surfaced on the integrations status endpoint so the\n * frontend can render fields without hard-coding them per platform. /\n requiredEnvKeys?: import(\"../server/create-server.js\").EnvKeyConfig[];\n}\n\nexport interface PlatformAdapterCapabilities {\n /* The adapter can deliver a response to the current inbound event. /\n replyText: boolean;\n /* The adapter can send without an active inbound event. /\n proactiveMessages: boolean;\n /* The adapter preserves a provider-native thread or topic reference. /\n nativeThreads: boolean;\n /* The adapter can quote/reply to a specific inbound message. /\n contextualReplies: boolean;\n /* The provider requires an immediate deferred webhook acknowledgement. /\n deferredWebhookResponse: boolean;\n /* The adapter only receives explicit interactions, not ordinary messages. /\n interactionOnly?: boolean;\n /* The adapter can hydrate bounded native thread/file/reaction context. /\n nativeContextHydration?: boolean;\n /* The adapter can surface live agent progress in the provider UI. /\n liveRunProgress?: boolean;\n}\n\nexport interface PlatformRunProgress {\n /\n Opaque, provider-owned reference for resuming this progress surface from a\n * durable continuation. It deliberately contains no user content,\n * credentials, or provider payload.\n /\n ref?: PlatformRunProgressRef;\n /* Stable provider message target that can receive the terminal answer. /\n responseTargetRef?: string;\n /* Receive normalized agent events. Implementations should throttle writes. /\n onEvent(\n event: AgentChatEvent,\n opts?: { signal?: AbortSignal },\n ): Promise<void> \| void;\n /* Finalize the provider-native progress surface with the answer. /\n complete(\n message: OutgoingMessage,\n opts?: { signal?: AbortSignal },\n ): Promise<void \| PlatformDeliveryReceipt>;\n /* Mark the provider-native surface failed and leave a retryable explanation. /\n fail?(message: string, opts?: { signal?: AbortSignal }): Promise<void>;\n}\n\n/\n Safe, minimal reference to a provider-native run-progress surface.\n \n The field values are opaque to the framework. Adapters may use `kind` to\n * distinguish their own resume strategy and `streamTs` to identify the\n * provider-side stream. No incoming message text, platform payload, or\n * credential belongs here.\n /\nexport interface PlatformRunProgressRef {\n kind: string;\n streamTs: string;\n}\n\nexport interface ImmediateWebhookResponse {\n status: number;\n body: unknown;\n}\n\nexport class UnsupportedPlatformCapabilityError extends Error {\n readonly code = \"UNSUPPORTED_PLATFORM_CAPABILITY\";\n\n constructor(\n readonly platform: string,\n readonly capability: keyof PlatformAdapterCapabilities,\n ) {\n super(`Platform ${platform} does not support ${capability}`);\n this.name = \"UnsupportedPlatformCapabilityError\";\n }\n}\n\n/\n Platform adapter interface — implement this for each messaging platform.\n \n Each adapter handles the platform-specific concerns:\n * - Webhook verification (HMAC signatures, challenge responses)\n * - Message parsing (platform events → normalized IncomingMessage)\n * - Response formatting (agent text → platform-specific format)\n * - Response delivery (POST back to platform API)\n /\nexport interface PlatformAdapter {\n /* Unique platform identifier /\n readonly platform: string;\n /* Human-readable label /\n readonly label: string;\n /* Explicit runtime behavior. Missing fields are treated as unsupported. /\n readonly capabilities?: Partial<PlatformAdapterCapabilities>;\n\n /* Env keys this adapter needs (tokens, secrets, etc.) /\n getRequiredEnvKeys(): EnvKeyConfig[];\n\n /\n Handle platform-specific verification challenges.\n * For example, Slack sends a `url_verification` event when setting up.\n * Return `{ handled: true, response }` to short-circuit the webhook handler.\n /\n handleVerification(event: H3Event): Promise<{\n handled: boolean;\n response?: unknown;\n }>;\n\n /\n Validate the webhook request signature.\n * Returns true if the request is authentic.\n /\n verifyWebhook(event: H3Event): Promise<boolean>;\n\n /\n Parse the webhook payload into a normalized IncomingMessage.\n * Return null to silently ignore the event (bot messages, edits, etc.).\n /\n parseIncomingMessage(event: H3Event): Promise<IncomingMessage \| null>;\n\n /\n Hydrate bounded provider-native context after durable enqueue, outside the\n * provider acknowledgement budget. Implementations must return references,\n * metadata, and text only — never persist file bodies or credentials.\n /\n hydrateIncomingMessage?(incoming: IncomingMessage): Promise<IncomingMessage>;\n\n /\n Hydrate only verified sender identity before execution-context selection.\n * This runs on the provider acknowledgement path and must avoid fetching\n * conversation history or file bodies.\n /\n hydrateIncomingIdentity?(incoming: IncomingMessage): Promise<IncomingMessage>;\n\n /\n Provider-specific response returned only after a message is verified and\n * durably enqueued. Discord uses this to return a type-5 deferred response\n * within its three-second interaction deadline.\n /\n getImmediateWebhookResponse?(\n incoming: IncomingMessage,\n ): ImmediateWebhookResponse \| null;\n\n /\n Return pre-canonical thread ids used by older adapter versions. The\n * integration handler checks these only when the canonical mapping is\n * missing, then aliases a match to the canonical id without forking history.\n /\n getLegacyExternalThreadIds?(incoming: IncomingMessage): string[];\n\n /\n Send the agent's response back to the messaging platform.\n \n If `opts.placeholderRef` is provided (returned earlier by\n * `postProcessingPlaceholder`), adapters that support in-place edits should\n * update that placeholder message rather than posting a new one. Adapters\n * without an \"update message\" API can ignore the ref and post fresh.\n /\n sendResponse(\n message: OutgoingMessage,\n context: IncomingMessage,\n opts?: PlatformDeliveryOptions,\n ): Promise<void \| PlatformDeliveryReceipt>;\n\n /\n Send a short best-effort system notice to the conversation the incoming\n * message arrived on (polite identity declines, one-time access guidance).\n * Bypasses agent formatting. When `dedupeKey` is provided, the adapter may\n * drop the notice if the same key was sent recently. Callers must treat\n * failures as non-fatal.\n /\n sendSystemNotice?(\n incoming: IncomingMessage,\n text: string,\n opts?: {\n dedupeKey?: string;\n /* Dedupe window for `dedupeKey`. Adapters pick a default when omitted. /\n dedupeTtlMs?: number;\n },\n ): Promise<void>;\n\n /\n Optionally post a \"working on it…\" placeholder message immediately when a\n * webhook arrives, before the agent loop runs. Adapters that support\n * in-place message edits (Slack via `chat.update`, etc.) return an opaque\n * `placeholderRef` that the webhook flow threads through to `sendResponse`\n * so the same message is updated with the final answer once ready.\n \n Adapters without edit support should leave this undefined; the webhook\n * handler will skip the placeholder step entirely.\n /\n postProcessingPlaceholder?(\n incoming: IncomingMessage,\n ): Promise<{ placeholderRef: string } \| null>;\n\n /* Start a provider-native progress/streaming surface for an agent run. /\n startRunProgress?(\n incoming: IncomingMessage,\n ): Promise<PlatformRunProgress \| null>;\n\n /\n Reattach a durable continuation to a provider-native progress surface\n * previously started by this adapter. Adapters that cannot resume a native\n * surface should omit this and the continuation will use its normal reply\n * path instead.\n /\n resumeRunProgress?(\n incoming: IncomingMessage,\n ref: PlatformRunProgressRef,\n ): Promise<PlatformRunProgress \| null>;\n\n /\n Send a proactive outbound message to a platform destination. Adapters that\n * only support direct replies can omit this.\n /\n sendMessageToTarget?(\n message: OutgoingMessage,\n target: OutboundTarget,\n ): Promise<void>;\n\n /\n Format plain agent response text into a platform-appropriate message.\n * Handles markdown conversion, message splitting for length limits, etc.\n \n `opts.threadDeepLinkUrl`, when present, is a URL back to the originating\n * thread in the dispatch UI. Adapters that support rich blocks should\n * render this as a button (Slack); adapters that don't may inline it as a\n * link or simply omit it.\n /\n formatAgentResponse(\n text: string,\n opts?: { threadDeepLinkUrl?: string },\n ): OutgoingMessage;\n\n /* Return current connection/configuration status for the settings UI. /\n getStatus(baseUrl?: string): Promise<IntegrationStatus>;\n}\n\nexport function assertPlatformCapability(\n adapter: PlatformAdapter,\n capability: keyof PlatformAdapterCapabilities,\n): void {\n if (adapter.capabilities?.[capability] !== true) {\n throw new UnsupportedPlatformCapabilityError(adapter.platform, capability);\n }\n}\n\n/\n Options for the integrations plugin.\n /\nexport interface IntegrationsPluginOptions {\n /* App identifier used by call-agent to prevent self-calls (e.g. \"dispatch\"). /\n appId?: string;\n /* Full adapter set to enable. Default: all built-in adapters. /\n adapters?: PlatformAdapter[];\n /* Replace built-in adapters by platform without removing the other defaults. /\n adapterOverrides?: PlatformAdapter[];\n /* System prompt for the agent (same as agent-chat). Inherited from agent-chat plugin if not set. /\n systemPrompt?: string;\n /* Actions registry (same as agent-chat). /\n actions?: Record<string, import(\"../agent/production-agent.js\").ActionEntry>;\n /* Model to use. Defaults to the resolved engine's default model. /\n model?: string;\n /* Anthropic API key. Falls back to ANTHROPIC_API_KEY env var. /\n apiKey?: string;\n /* Agent engine to use. Defaults to the same engine resolver as web chat. /\n engine?:\n \| import(\"../agent/engine/types.js\").AgentEngine\n \| string\n \| {\n name: string;\n config: Record<string, unknown>;\n };\n /\n Resolve which owner should receive personal resource context and own the\n * created chat thread for an incoming platform message.\n /\n resolveOwner?: (incoming: IncomingMessage) => string \| Promise<string>;\n /\n Resolve the durable execution principal for an inbound provider message.\n * Shared channels should use a service principal; DMs may use a verified\n * linked user. When present this supersedes `resolveOwner`.\n /\n resolveExecutionContext?: (\n incoming: IncomingMessage,\n ) => IntegrationExecutionContext \| Promise<IntegrationExecutionContext>;\n /\n Explicitly allow an unlinked, verified Slack workspace member to run a DM\n * with the installation organization's shared/service visibility. Disabled\n * by default: DM identity resolution fails closed unless an app deliberately\n * accepts this wider access tier.\n /\n allowAnonymousOrgScopedSlackDm?: boolean;\n /\n Optional preprocessor for inbound platform messages. Can intercept special\n * commands (such as `/link`) before the agent loop runs.\n /\n beforeProcess?: (\n incoming: IncomingMessage,\n adapter: PlatformAdapter,\n ) => Promise<\n \| {\n handled: true;\n responseText?: string;\n }\n \| { handled: false }\n >;\n}\n\nexport interface IntegrationExecutionContext {\n ownerEmail: string;\n orgId: string \| null;\n principalType: \"user\" \| \"service\";\n installationId?: string;\n scopeId?: string;\n /\n True when a hydrated full workspace member could not be matched to an\n * organization member and runs with the anonymous org-scoped service\n * principal (org-wide visibility only, nothing user-private).\n */\n anonymousMember?: boolean;\n}\n"]}

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

	@@ -1 +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,EAIL,KAAK,mBAAmB,EAEzB,MAAM,6BAA6B,CAAC;AAerC,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;~~AA0DtC~~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~~AAgrDD~~,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,sCAAsC,EAC/C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAsEf"}
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,EAIL,KAAK,mBAAmB,EAEzB,MAAM,6BAA6B,CAAC;AAerC,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAC;AA2DtC,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,uBAAuB,EAExB,MAAM,YAAY,CAAC;AA8FpB,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,sBAAsB,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IAChD,qBAAqB,CAAC,EAAE,IAAI,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,4BAA4B,GACpC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CAAA;CAAE,GAClD;IAAE,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC7B;IACE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,sCAAsC,CAAC;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,CAAC;KACxD,CAAC;CACH,CAAC;AA6CN,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;;;;;;;;;OASG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,CAAC,EACH,WAAW,GACX,MAAM,GACN;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACtD,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;;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;AAyDD,wBAAsB,wBAAwB,CAC5C,YAAY,EAAE,qBAAqB,CAAC,QAAQ,CAAC,EAC7C,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyB7B;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,CA0E5C;AAkHD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgCrD;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,qBAAqB,EAC9B,eAAe,CAAC,EAAE;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,GACA,OAAO,CAAC,4BAA4B,CAAC,CAmBvC;AA4rDD,wBAAsB,iCAAiC,CACrD,OAAO,EAAE,sCAAsC,EAC/C,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAsEf"}

package/dist/integrations/webhook-handler.js CHANGED Viewed

@@ -20,7 +20,8 @@ import { canUseDeployCredentialFallbackForRequest, readDeployCredentialEnv, } fr
 import { runWithRequestContext } from "../server/request-context.js";
 import { normalizeReasoningEffortForRequest } from "../shared/reasoning-effort.js";
 import { A2A_CONTINUATION_QUEUED_MARKER } from "./a2a-continuation-marker.js";
-import { hasActiveA2AContinuationsForIntegrationTask } from "./a2a-continuations-store.js";
+import { reconcileTerminalA2AParentIfDisabled } from "./a2a-continuation-processor.js";
+import { getA2AContinuationTaskOutcome } from "./a2a-continuations-store.js";
 import { clearIntegrationAwaitingInput, setIntegrationAwaitingInput, } from "./awaiting-input-store.js";
 import { claimIntegrationCampaignDeliveryForTask, claimIntegrationCampaign, completeIntegrationCampaignTask, createIntegrationCampaign, failIntegrationCampaign, heartbeatIntegrationCampaign, scheduleNextIntegrationCampaign, waitForA2AIntegrationCampaign, } from "./integration-campaigns-store.js";
 import { dispatchPendingIntegrationTask, integrationDispatchScopeValue, } from "./integration-durable-dispatch.js";
@@ -713,8 +714,16 @@ async function processIncomingMessage(incoming, options, opts = {}) {
             }
             catch { }
             if (waitingForA2A) {
-                const activeA2A = await hasActiveA2AContinuationsForIntegrationTask(opts.taskId);
-                if (activeA2A) {
+                const a2aOutcome = await getA2AContinuationTaskOutcome(opts.taskId);
+                if (a2aOutcome !== "terminal-delivered") {
+                    if (a2aOutcome === "terminal-without-delivery" &&
+                        (await reconcileTerminalA2AParentIfDisabled(opts.taskId))) {
+                        await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
+                        return { status: "campaign-failed" };
+                    }
+                    if (a2aOutcome !== "active") {
+                        console.warn(`[integrations] Waiting campaign ${campaign.row.id} has A2A outcome ${a2aOutcome} without terminal delivery proof`);
+                    }
                     const waiting = await waitForA2AIntegrationCampaign(campaign.row.id, {
                         runId: campaign.runId,
                         leaseToken: campaign.leaseToken,