@agent-native/core 0.119.5 → 0.119.6

package/dist/file-upload/actions/upload-image.d.ts

@@ -17,12 +17,12 @@ declare const _default: import("../../action.js").ActionDefinition<{
     id?: undefined;
     provider?: undefined;
 } | {
-    error?: undefined;
     configured?: undefined;
     connectPath?: undefined;
     url: string;
     id: string;
     provider: string;
+    error?: undefined;
 }>;
 export default _default;
 //# sourceMappingURL=upload-image.d.ts.map

package/dist/integrations/integration-durable-dispatch-config.d.ts

@@ -0,0 +1,7 @@
+export declare const INTEGRATION_DURABLE_DISPATCH_ENV = "AGENT_INTEGRATION_DURABLE_DISPATCH";
+export declare const INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV = "AGENT_INTEGRATION_DURABLE_DISPATCH_SCOPES";
+export declare const INTEGRATION_PROCESS_TASK_PATH = "/_agent-native/integrations/process-task";
+export declare const INTEGRATION_RETRY_SWEEP_PATH = "/_agent-native/integrations/retry-stuck-tasks";
+export declare const INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT = "integration-pending-tasks-sweep";
+export declare function isIntegrationDurableDispatchConfigured(): boolean;
+//# sourceMappingURL=integration-durable-dispatch-config.d.ts.map

package/dist/integrations/integration-durable-dispatch-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-durable-dispatch-config.d.ts","sourceRoot":"","sources":["../../src/integrations/integration-durable-dispatch-config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gCAAgC,uCACP,CAAC;AACvC,eAAO,MAAM,uCAAuC,8CACP,CAAC;AAC9C,eAAO,MAAM,6BAA6B,6CACE,CAAC;AAC7C,eAAO,MAAM,4BAA4B,kDACQ,CAAC;AAClD,eAAO,MAAM,qCAAqC,oCACf,CAAC;AAEpC,wBAAgB,sCAAsC,IAAI,OAAO,CAUhE"}

package/dist/integrations/integration-durable-dispatch-config.js

@@ -0,0 +1,16 @@
+export const INTEGRATION_DURABLE_DISPATCH_ENV = "AGENT_INTEGRATION_DURABLE_DISPATCH";
+export const INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV = "AGENT_INTEGRATION_DURABLE_DISPATCH_SCOPES";
+export const INTEGRATION_PROCESS_TASK_PATH = "/_agent-native/integrations/process-task";
+export const INTEGRATION_RETRY_SWEEP_PATH = "/_agent-native/integrations/retry-stuck-tasks";
+export const INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT = "integration-pending-tasks-sweep";
+export function isIntegrationDurableDispatchConfigured() {
+    const value = process.env.AGENT_INTEGRATION_DURABLE_DISPATCH;
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return (normalized === "1" ||
+        normalized === "true" ||
+        normalized === "yes" ||
+        normalized === "on");
+}
+//# sourceMappingURL=integration-durable-dispatch-config.js.map

package/dist/integrations/integration-durable-dispatch-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-durable-dispatch-config.js","sourceRoot":"","sources":["../../src/integrations/integration-durable-dispatch-config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gCAAgC,GAC3C,oCAAoC,CAAC;AACvC,MAAM,CAAC,MAAM,uCAAuC,GAClD,2CAA2C,CAAC;AAC9C,MAAM,CAAC,MAAM,6BAA6B,GACxC,0CAA0C,CAAC;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GACvC,+CAA+C,CAAC;AAClD,MAAM,CAAC,MAAM,qCAAqC,GAChD,iCAAiC,CAAC;AAEpC,MAAM,UAAU,sCAAsC;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC;IAC7D,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,CACL,UAAU,KAAK,GAAG;QAClB,UAAU,KAAK,MAAM;QACrB,UAAU,KAAK,KAAK;QACpB,UAAU,KAAK,IAAI,CACpB,CAAC;AACJ,CAAC","sourcesContent":["export const INTEGRATION_DURABLE_DISPATCH_ENV =\n  \"AGENT_INTEGRATION_DURABLE_DISPATCH\";\nexport const INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV =\n  \"AGENT_INTEGRATION_DURABLE_DISPATCH_SCOPES\";\nexport const INTEGRATION_PROCESS_TASK_PATH =\n  \"/_agent-native/integrations/process-task\";\nexport const INTEGRATION_RETRY_SWEEP_PATH =\n  \"/_agent-native/integrations/retry-stuck-tasks\";\nexport const INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT =\n  \"integration-pending-tasks-sweep\";\n\nexport function isIntegrationDurableDispatchConfigured(): boolean {\n  const value = process.env.AGENT_INTEGRATION_DURABLE_DISPATCH;\n  if (!value) return false;\n  const normalized = value.trim().toLowerCase();\n  return (\n    normalized === \"1\" ||\n    normalized === \"true\" ||\n    normalized === \"yes\" ||\n    normalized === \"on\"\n  );\n}\n"]}

package/dist/integrations/integration-durable-dispatch.d.ts

@@ -0,0 +1,23 @@
+import { INTEGRATION_DURABLE_DISPATCH_ENV, INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV, INTEGRATION_PROCESS_TASK_PATH, INTEGRATION_RETRY_SWEEP_PATH, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, isIntegrationDurableDispatchConfigured } from "./integration-durable-dispatch-config.js";
+export { INTEGRATION_DURABLE_DISPATCH_ENV, INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV, INTEGRATION_PROCESS_TASK_PATH, INTEGRATION_RETRY_SWEEP_PATH, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, isIntegrationDurableDispatchConfigured, };
+export type IntegrationDispatchOutcome = "background-acknowledged" | "portable-unconfirmed" | "failed";
+export interface IntegrationDispatchTaskScope {
+    platform: string;
+    externalThreadId: string;
+    platformContext?: Record<string, unknown>;
+}
+export interface IntegrationDurableDispatchScope {
+    platform: string;
+    value: string;
+}
+export declare function integrationDispatchScopeValue(task: IntegrationDispatchTaskScope): string | null;
+export declare function configuredIntegrationDurableDispatchScopes(): IntegrationDurableDispatchScope[] | null;
+export declare function isIntegrationDurableDispatchEnabledForTask(task: IntegrationDispatchTaskScope): boolean;
+export declare function dispatchPendingIntegrationTask(input: {
+    taskId: string;
+    task: IntegrationDispatchTaskScope;
+    event?: unknown;
+    baseUrl?: string;
+    portableSettleMs?: number;
+}): Promise<IntegrationDispatchOutcome>;
+//# sourceMappingURL=integration-durable-dispatch.d.ts.map

package/dist/integrations/integration-durable-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-durable-dispatch.d.ts","sourceRoot":"","sources":["../../src/integrations/integration-durable-dispatch.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,gCAAgC,EAChC,uCAAuC,EACvC,6BAA6B,EAC7B,4BAA4B,EAC5B,qCAAqC,EACrC,sCAAsC,EACvC,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EACL,gCAAgC,EAChC,uCAAuC,EACvC,6BAA6B,EAC7B,4BAA4B,EAC5B,qCAAqC,EACrC,sCAAsC,GACvC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAClC,yBAAyB,GACzB,sBAAsB,GACtB,QAAQ,CAAC;AAEb,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,4BAA4B,GACjC,MAAM,GAAG,IAAI,CAGf;AAED,wBAAgB,0CAA0C,IACtD,+BAA+B,EAAE,GACjC,IAAI,CAeP;AAiBD,wBAAgB,0CAA0C,CACxD,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAkBT;AA4BD,wBAAsB,8BAA8B,CAAC,KAAK,EAAE;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,4BAA4B,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAmDtC"}

package/dist/integrations/integration-durable-dispatch.js

@@ -0,0 +1,115 @@
+import { hasConfiguredA2ASecret } from "../a2a/auth-policy.js";
+import { AGENT_BACKGROUND_PROCESSOR_FIELD, AGENT_BACKGROUND_PROCESSOR_INTEGRATION, dispatchPathTargetsNetlifyBackgroundFunction, resolveDurableBackgroundDispatchPath, } from "../agent/durable-background.js";
+import { fireInternalDispatch } from "../server/self-dispatch.js";
+import { INTEGRATION_DURABLE_DISPATCH_ENV, INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV, INTEGRATION_PROCESS_TASK_PATH, INTEGRATION_RETRY_SWEEP_PATH, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, isIntegrationDurableDispatchConfigured, } from "./integration-durable-dispatch-config.js";
+import { recordPendingTaskDispatchAttempt } from "./pending-tasks-store.js";
+export { INTEGRATION_DURABLE_DISPATCH_ENV, INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV, INTEGRATION_PROCESS_TASK_PATH, INTEGRATION_RETRY_SWEEP_PATH, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, isIntegrationDurableDispatchConfigured, };
+export function integrationDispatchScopeValue(task) {
+    const value = task.platformContext?.channelId;
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+export function configuredIntegrationDurableDispatchScopes() {
+    const raw = process.env.AGENT_INTEGRATION_DURABLE_DISPATCH_SCOPES;
+    if (!raw?.trim())
+        return null;
+    return raw
+        .split(",")
+        .map((value) => value.trim())
+        .filter(Boolean)
+        .map((scope) => {
+        const separator = scope.indexOf(":");
+        return {
+            platform: separator > 0 ? scope.slice(0, separator) : "",
+            value: separator > 0 ? scope.slice(separator + 1) : "",
+        };
+    })
+        .filter((scope) => scope.platform && scope.value);
+}
+function taskScopeCandidates(task) {
+    const candidates = [
+        `${task.platform}:*`,
+        `${task.platform}:${task.externalThreadId}`,
+    ];
+    const explicitScope = integrationDispatchScopeValue(task);
+    if (explicitScope) {
+        candidates.push(`${task.platform}:${explicitScope}`);
+    }
+    else if (task.platform === "slack") {
+        const channelId = task.externalThreadId.split(":")[2];
+        if (channelId)
+            candidates.push(`slack:${channelId}`);
+    }
+    return candidates;
+}
+export function isIntegrationDurableDispatchEnabledForTask(task) {
+    if (!isIntegrationDurableDispatchConfigured())
+        return false;
+    const scopes = configuredIntegrationDurableDispatchScopes();
+    if (scopes &&
+        !taskScopeCandidates(task).some((candidate) => scopes.some((scope) => `${scope.platform}:${scope.value}` === candidate))) {
+        return false;
+    }
+    const path = resolveDurableBackgroundDispatchPath(INTEGRATION_PROCESS_TASK_PATH);
+    return (dispatchPathTargetsNetlifyBackgroundFunction(path) &&
+        hasConfiguredA2ASecret());
+}
+async function recordDispatch(taskId, outcome) {
+    try {
+        await recordPendingTaskDispatchAttempt(taskId, outcome);
+    }
+    catch (error) {
+        console.error(`[integrations] Failed to record dispatch outcome for ${taskId}:`, error);
+    }
+}
+function logDispatch(taskId, outcome, startedAt) {
+    console.info("[integrations] pending task dispatch", {
+        taskId,
+        outcome,
+        durationMs: Date.now() - startedAt,
+    });
+}
+export async function dispatchPendingIntegrationTask(input) {
+    const startedAt = Date.now();
+    const durable = isIntegrationDurableDispatchEnabledForTask(input.task);
+    if (durable) {
+        const backgroundPath = resolveDurableBackgroundDispatchPath(INTEGRATION_PROCESS_TASK_PATH);
+        try {
+            await fireInternalDispatch({
+                event: input.event,
+                baseUrl: input.baseUrl,
+                path: backgroundPath,
+                taskId: input.taskId,
+                body: {
+                    [AGENT_BACKGROUND_PROCESSOR_FIELD]: AGENT_BACKGROUND_PROCESSOR_INTEGRATION,
+                },
+                awaitResponse: true,
+                responseTimeoutMs: 2_000,
+            });
+            await recordDispatch(input.taskId, "background-acknowledged");
+            logDispatch(input.taskId, "background-acknowledged", startedAt);
+            return "background-acknowledged";
+        }
+        catch (error) {
+            console.error(`[integrations] Background dispatch failed for ${input.taskId}; trying the portable processor:`, error);
+        }
+    }
+    try {
+        await fireInternalDispatch({
+            event: input.event,
+            baseUrl: input.baseUrl,
+            path: INTEGRATION_PROCESS_TASK_PATH,
+            taskId: input.taskId,
+            settleMs: input.portableSettleMs,
+        });
+        await recordDispatch(input.taskId, "portable-unconfirmed");
+        logDispatch(input.taskId, "portable-unconfirmed", startedAt);
+        return "portable-unconfirmed";
+    }
+    catch (error) {
+        console.error(`[integrations] Portable dispatch failed for ${input.taskId}:`, error);
+        await recordDispatch(input.taskId, "failed");
+        logDispatch(input.taskId, "failed", startedAt);
+        return "failed";
+    }
+}
+//# sourceMappingURL=integration-durable-dispatch.js.map

package/dist/integrations/integration-durable-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-durable-dispatch.js","sourceRoot":"","sources":["../../src/integrations/integration-durable-dispatch.ts"],"names":[],"mappings":"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","sourcesContent":["import { hasConfiguredA2ASecret } from \"../a2a/auth-policy.js\";\nimport {\n  AGENT_BACKGROUND_PROCESSOR_FIELD,\n  AGENT_BACKGROUND_PROCESSOR_INTEGRATION,\n  dispatchPathTargetsNetlifyBackgroundFunction,\n  resolveDurableBackgroundDispatchPath,\n} from \"../agent/durable-background.js\";\nimport { fireInternalDispatch } from \"../server/self-dispatch.js\";\nimport {\n  INTEGRATION_DURABLE_DISPATCH_ENV,\n  INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV,\n  INTEGRATION_PROCESS_TASK_PATH,\n  INTEGRATION_RETRY_SWEEP_PATH,\n  INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT,\n  isIntegrationDurableDispatchConfigured,\n} from \"./integration-durable-dispatch-config.js\";\nimport { recordPendingTaskDispatchAttempt } from \"./pending-tasks-store.js\";\n\nexport {\n  INTEGRATION_DURABLE_DISPATCH_ENV,\n  INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV,\n  INTEGRATION_PROCESS_TASK_PATH,\n  INTEGRATION_RETRY_SWEEP_PATH,\n  INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT,\n  isIntegrationDurableDispatchConfigured,\n};\n\nexport type IntegrationDispatchOutcome =\n  | \"background-acknowledged\"\n  | \"portable-unconfirmed\"\n  | \"failed\";\n\nexport interface IntegrationDispatchTaskScope {\n  platform: string;\n  externalThreadId: string;\n  platformContext?: Record<string, unknown>;\n}\n\nexport interface IntegrationDurableDispatchScope {\n  platform: string;\n  value: string;\n}\n\nexport function integrationDispatchScopeValue(\n  task: IntegrationDispatchTaskScope,\n): string | null {\n  const value = task.platformContext?.channelId;\n  return typeof value === \"string\" && value.trim() ? value.trim() : null;\n}\n\nexport function configuredIntegrationDurableDispatchScopes():\n  | IntegrationDurableDispatchScope[]\n  | null {\n  const raw = process.env.AGENT_INTEGRATION_DURABLE_DISPATCH_SCOPES;\n  if (!raw?.trim()) return null;\n  return raw\n    .split(\",\")\n    .map((value) => value.trim())\n    .filter(Boolean)\n    .map((scope) => {\n      const separator = scope.indexOf(\":\");\n      return {\n        platform: separator > 0 ? scope.slice(0, separator) : \"\",\n        value: separator > 0 ? scope.slice(separator + 1) : \"\",\n      };\n    })\n    .filter((scope) => scope.platform && scope.value);\n}\n\nfunction taskScopeCandidates(task: IntegrationDispatchTaskScope): string[] {\n  const candidates = [\n    `${task.platform}:*`,\n    `${task.platform}:${task.externalThreadId}`,\n  ];\n  const explicitScope = integrationDispatchScopeValue(task);\n  if (explicitScope) {\n    candidates.push(`${task.platform}:${explicitScope}`);\n  } else if (task.platform === \"slack\") {\n    const channelId = task.externalThreadId.split(\":\")[2];\n    if (channelId) candidates.push(`slack:${channelId}`);\n  }\n  return candidates;\n}\n\nexport function isIntegrationDurableDispatchEnabledForTask(\n  task: IntegrationDispatchTaskScope,\n): boolean {\n  if (!isIntegrationDurableDispatchConfigured()) return false;\n  const scopes = configuredIntegrationDurableDispatchScopes();\n  if (\n    scopes &&\n    !taskScopeCandidates(task).some((candidate) =>\n      scopes.some((scope) => `${scope.platform}:${scope.value}` === candidate),\n    )\n  ) {\n    return false;\n  }\n  const path = resolveDurableBackgroundDispatchPath(\n    INTEGRATION_PROCESS_TASK_PATH,\n  );\n  return (\n    dispatchPathTargetsNetlifyBackgroundFunction(path) &&\n    hasConfiguredA2ASecret()\n  );\n}\n\nasync function recordDispatch(\n  taskId: string,\n  outcome: IntegrationDispatchOutcome,\n): Promise<void> {\n  try {\n    await recordPendingTaskDispatchAttempt(taskId, outcome);\n  } catch (error) {\n    console.error(\n      `[integrations] Failed to record dispatch outcome for ${taskId}:`,\n      error,\n    );\n  }\n}\n\nfunction logDispatch(\n  taskId: string,\n  outcome: IntegrationDispatchOutcome,\n  startedAt: number,\n): void {\n  console.info(\"[integrations] pending task dispatch\", {\n    taskId,\n    outcome,\n    durationMs: Date.now() - startedAt,\n  });\n}\n\nexport async function dispatchPendingIntegrationTask(input: {\n  taskId: string;\n  task: IntegrationDispatchTaskScope;\n  event?: unknown;\n  baseUrl?: string;\n  portableSettleMs?: number;\n}): Promise<IntegrationDispatchOutcome> {\n  const startedAt = Date.now();\n  const durable = isIntegrationDurableDispatchEnabledForTask(input.task);\n  if (durable) {\n    const backgroundPath = resolveDurableBackgroundDispatchPath(\n      INTEGRATION_PROCESS_TASK_PATH,\n    );\n    try {\n      await fireInternalDispatch({\n        event: input.event,\n        baseUrl: input.baseUrl,\n        path: backgroundPath,\n        taskId: input.taskId,\n        body: {\n          [AGENT_BACKGROUND_PROCESSOR_FIELD]:\n            AGENT_BACKGROUND_PROCESSOR_INTEGRATION,\n        },\n        awaitResponse: true,\n        responseTimeoutMs: 2_000,\n      });\n      await recordDispatch(input.taskId, \"background-acknowledged\");\n      logDispatch(input.taskId, \"background-acknowledged\", startedAt);\n      return \"background-acknowledged\";\n    } catch (error) {\n      console.error(\n        `[integrations] Background dispatch failed for ${input.taskId}; trying the portable processor:`,\n        error,\n      );\n    }\n  }\n\n  try {\n    await fireInternalDispatch({\n      event: input.event,\n      baseUrl: input.baseUrl,\n      path: INTEGRATION_PROCESS_TASK_PATH,\n      taskId: input.taskId,\n      settleMs: input.portableSettleMs,\n    });\n    await recordDispatch(input.taskId, \"portable-unconfirmed\");\n    logDispatch(input.taskId, \"portable-unconfirmed\", startedAt);\n    return \"portable-unconfirmed\";\n  } catch (error) {\n    console.error(\n      `[integrations] Portable dispatch failed for ${input.taskId}:`,\n      error,\n    );\n    await recordDispatch(input.taskId, \"failed\");\n    logDispatch(input.taskId, \"failed\", startedAt);\n    return \"failed\";\n  }\n}\n"]}

package/dist/integrations/pending-tasks-retry-job.d.ts

@@ -1,8 +1,20 @@
+export interface PendingTasksSweepResult {
+    selected: number;
+    dispatched: number;
+    markedFailed: number;
+    skipped: number;
+    dispatchFailed: number;
+}
+export interface PendingTasksSweepOptions {
+    webhookBaseUrl?: string;
+    limit?: number;
+    durableOnly?: boolean;
+}
 /**
  * One pass: find stuck tasks and re-fire the processor for each.
  * Exported for tests and for manual triggers.
  */
-export declare function retryStuckPendingTasks(webhookBaseUrl?: string): Promise<void>;
+export declare function retryStuckPendingTasks(input?: string | PendingTasksSweepOptions): Promise<PendingTasksSweepResult>;
 /**
  * Start the periodic retry loop. Safe to call multiple times — second call
  * is a no-op.

package/dist/integrations/pending-tasks-retry-job.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pending-tasks-retry-job.d.ts","sourceRoot":"","sources":["../../src/integrations/pending-tasks-retry-job.ts"],"names":[],"mappings":"AAuDA;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC,CAiGf;AA8ED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,IAAI,CA0BP;AAED,2BAA2B;AAC3B,wBAAgB,wBAAwB,IAAI,IAAI,CAU/C"}
+{"version":3,"file":"pending-tasks-retry-job.d.ts","sourceRoot":"","sources":["../../src/integrations/pending-tasks-retry-job.ts"],"names":[],"mappings":"AAqEA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAkDD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,CAAC,EAAE,MAAM,GAAG,wBAAwB,GACxC,OAAO,CAAC,uBAAuB,CAAC,CA6KlC;AAcD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,IAAI,CA0BP;AAED,2BAA2B;AAC3B,wBAAgB,wBAAwB,IAAI,IAAI,CAU/C"}

package/dist/integrations/pending-tasks-retry-job.js

@@ -1,20 +1,22 @@
 import { getDbExec } from "../db/client.js";
-import { withConfiguredAppBasePath } from "../server/app-base-path.js";
-import { FRAMEWORK_ROUTE_PREFIX } from "../server/core-routes-plugin.js";
-import { signInternalToken } from "./internal-token.js";
-import { MAX_PENDING_TASK_ATTEMPTS } from "./pending-tasks-store.js";
+import { configuredIntegrationDurableDispatchScopes, dispatchPendingIntegrationTask, isIntegrationDurableDispatchEnabledForTask, } from "./integration-durable-dispatch.js";
+import { ensurePendingTasksTable, MAX_PENDING_TASK_ATTEMPTS, } from "./pending-tasks-store.js";
 /**
  * Retries stuck integration webhook tasks.
  *
  * The integration webhook flow enqueues work into `integration_pending_tasks`
  * (see `pending-tasks-store.ts`) and then fires a self-webhook to the
  * `/_agent-native/integrations/process-task` endpoint to drain the queue.
- * If that fire-and-forget dispatch fails (e.g. transient network blip), the
+ * If that initial dispatch is lost (e.g. transient network blip), the
  * row stays in `pending` forever. Likewise, if the processor is killed mid-
  * processing (function timeout, container shutdown), a row can remain in
  * `processing` forever.
  *
- * This job runs every 60s and re-fires the processor endpoint for tasks that
+ * The in-process fallback runs every 60s. Durable deployments also invoke the
+ * same bounded sweep from an external scheduler so recovery does not depend on
+ * a serverless process remaining alive.
+ *
+ * Each sweep re-fires the processor endpoint for tasks that
  * look stuck:
  *   - status='pending' AND created_at older than 90s (initial dispatch lost)
  *   - status='processing' AND updated_at older than the host-specific
@@ -33,8 +35,9 @@ const PENDING_STUCK_AFTER_MS = 90_000;
 /** Tasks "processing" longer than this are considered killed mid-flight. */
 const DEFAULT_PROCESSING_STUCK_AFTER_MS = 5 * 60 * 1000;
 const SERVERLESS_PROCESSING_STUCK_AFTER_MS = 75_000;
+const DURABLE_BACKGROUND_PROCESSING_STUCK_AFTER_MS = 16 * 60 * 1000;
 /** After this many attempts we give up and mark the task failed */
-const PROCESSOR_PATH = `${FRAMEWORK_ROUTE_PREFIX}/integrations/process-task`;
+const DEFAULT_SWEEP_LIMIT = 100;
 let retryInterval = null;
 let initialTimer = null;
 let activeWebhookBaseUrl;
@@ -43,58 +46,137 @@ let activeWebhookBaseUrl;
  * minute when the queue isn't in use yet on a given deployment.
  */
 let tableExists = null;
+function affectedRows(result) {
+    return Number(result.rowsAffected ??
+        result.rowCount ??
+        0);
+}
+function isMissingPendingTasksTableError(error) {
+    const message = error instanceof Error ? error.message : String(error ?? "");
+    return /no such table|relation .* does not exist|undefined_table/i.test(message);
+}
+function durableScopeSql() {
+    const scopes = configuredIntegrationDurableDispatchScopes();
+    if (scopes === null)
+        return { clause: "", args: [] };
+    if (scopes.length === 0)
+        return { clause: " AND 1 = 0", args: [] };
+    const clauses = [];
+    const args = [];
+    for (const scope of scopes) {
+        if (scope.value === "*") {
+            clauses.push("platform = ?");
+            args.push(scope.platform);
+            continue;
+        }
+        if (scope.platform === "slack" && /^[A-Za-z0-9]+$/.test(scope.value)) {
+            clauses.push("(platform = ? AND (external_thread_id = ? OR dispatch_scope = ? OR external_thread_id LIKE ?))");
+            args.push(scope.platform, scope.value, scope.value, `%:%:${scope.value}:%`);
+            continue;
+        }
+        clauses.push("(platform = ? AND (external_thread_id = ? OR dispatch_scope = ?))");
+        args.push(scope.platform, scope.value, scope.value);
+    }
+    return { clause: ` AND (${clauses.join(" OR ")})`, args };
+}
 /**
  * One pass: find stuck tasks and re-fire the processor for each.
  * Exported for tests and for manual triggers.
  */
-export async function retryStuckPendingTasks(webhookBaseUrl) {
-    const baseUrl = webhookBaseUrl ?? activeWebhookBaseUrl;
+export async function retryStuckPendingTasks(input) {
+    const options = typeof input === "string" ? { webhookBaseUrl: input } : (input ?? {});
+    const baseUrl = options.webhookBaseUrl ?? activeWebhookBaseUrl;
+    const limit = Math.max(1, Math.min(500, Math.floor(options.limit ?? DEFAULT_SWEEP_LIMIT)));
+    const scopeSql = options.durableOnly
+        ? durableScopeSql()
+        : { clause: "", args: [] };
+    const result = {
+        selected: 0,
+        dispatched: 0,
+        markedFailed: 0,
+        skipped: 0,
+        dispatchFailed: 0,
+    };
+    await ensurePendingTasksTable();
     const client = getDbExec();
     const now = Date.now();
     const pendingCutoff = now - PENDING_STUCK_AFTER_MS;
     const processingCutoff = now - getProcessingStuckAfterMs();
+    const durableProcessingCutoff = now - DURABLE_BACKGROUND_PROCESSING_STUCK_AFTER_MS;
     let stuckRows;
     try {
         const { rows } = await client.execute({
             sql: `
-        SELECT id, status, attempts
+        SELECT id, platform, external_thread_id, dispatch_scope, status, attempts, updated_at
           FROM integration_pending_tasks
-         WHERE (status = 'pending' AND created_at <= ? AND updated_at <= ?)
-            OR (status = 'processing' AND updated_at <= ?)
+         WHERE ((status = 'pending' AND created_at <= ? AND updated_at <= ?)
+            OR (status = 'processing' AND (
+              (last_dispatch_outcome = 'background-acknowledged'
+                AND updated_at <= ?)
+              OR ((last_dispatch_outcome IS NULL
+                    OR last_dispatch_outcome <> 'background-acknowledged')
+                AND updated_at <= ?)
+            )))
+         ${scopeSql.clause}
+         ORDER BY updated_at ASC
+         LIMIT ?
       `,
             // `updated_at` is initialized to `created_at` on insert, so a genuinely
             // stuck pending row still matches on the first sweep. The retry path
             // below touches `updated_at`, which (with this predicate) keeps the row
             // from being re-selected — and re-firing the processor — on every tick.
-            args: [pendingCutoff, pendingCutoff, processingCutoff],
+            args: [
+                pendingCutoff,
+                pendingCutoff,
+                durableProcessingCutoff,
+                processingCutoff,
+                ...scopeSql.args,
+                limit,
+            ],
         });
         stuckRows = rows.map((r) => ({
             id: r.id,
+            platform: r.platform,
+            externalThreadId: r.external_thread_id,
             status: r.status,
             attempts: Number(r.attempts ?? 0),
+            updatedAt: Number(r.updated_at ?? 0),
+            dispatchScope: r.dispatch_scope ?? null,
         }));
         tableExists = true;
     }
     catch (err) {
-        // Most common case: the table hasn't been created yet because no inbound
-        // integration webhook has been processed on this deployment. Silently
-        // no-op until the table appears.
+        if (!isMissingPendingTasksTableError(err))
+            throw err;
         if (tableExists !== false) {
             tableExists = false;
             if (process.env.DEBUG) {
                 console.log("[integrations] pending-tasks retry job: table not present yet, skipping");
             }
         }
-        return;
+        return result;
     }
+    stuckRows = stuckRows.filter((row) => {
+        const durable = isIntegrationDurableDispatchEnabledForTask({
+            platform: row.platform,
+            externalThreadId: row.externalThreadId,
+            platformContext: row.dispatchScope
+                ? { channelId: row.dispatchScope }
+                : undefined,
+        });
+        if (options.durableOnly && !durable)
+            return false;
+        return true;
+    });
+    result.selected = stuckRows.length;
     if (stuckRows.length === 0)
-        return;
+        return result;
     for (const row of stuckRows) {
         try {
             // Cap retries — mark failed and move on so the row stops bouncing
             // between pending and processing forever.
             if (row.attempts >= MAX_PENDING_TASK_ATTEMPTS) {
-                await client.execute({
+                const update = await client.execute({
                     sql: `
             UPDATE integration_pending_tasks
                SET status = 'failed',
@@ -104,14 +186,21 @@ export async function retryStuckPendingTasks(webhookBaseUrl) {
                    external_event_key = NULL
              WHERE id = ?
                AND status = ?
+               AND updated_at = ?
           `,
                     args: [
                         Date.now(),
                         `Retry job: exceeded ${MAX_PENDING_TASK_ATTEMPTS} attempts`,
                         row.id,
                         row.status,
+                        row.updatedAt,
                     ],
                 });
+                if (affectedRows(update) === 0) {
+                    result.skipped += 1;
+                    continue;
+                }
+                result.markedFailed += 1;
                 console.warn(`[integrations] Pending task ${row.id} exceeded ${MAX_PENDING_TASK_ATTEMPTS} attempts — marking failed`);
                 continue;
             }
@@ -120,21 +209,43 @@ export async function retryStuckPendingTasks(webhookBaseUrl) {
             // Without this, processing rows stay stuck forever.
             // For pending rows, just touch updated_at to avoid re-firing every tick.
             const newStatus = row.status === "processing" ? "pending" : row.status;
-            await client.execute({
+            const update = await client.execute({
                 sql: `
           UPDATE integration_pending_tasks
              SET status = ?, updated_at = ?
            WHERE id = ?
              AND status = ?
+             AND updated_at = ?
         `,
-                args: [newStatus, Date.now(), row.id, row.status],
+                args: [newStatus, Date.now(), row.id, row.status, row.updatedAt],
+            });
+            if (affectedRows(update) === 0) {
+                result.skipped += 1;
+                continue;
+            }
+            const outcome = await dispatchPendingIntegrationTask({
+                taskId: row.id,
+                task: {
+                    platform: row.platform,
+                    externalThreadId: row.externalThreadId,
+                    platformContext: row.dispatchScope
+                        ? { channelId: row.dispatchScope }
+                        : undefined,
+                },
+                baseUrl,
+                portableSettleMs: 1_000,
             });
-            await refireProcessor(row.id, baseUrl);
+            if (outcome === "failed")
+                result.dispatchFailed += 1;
+            else
+                result.dispatched += 1;
         }
         catch (err) {
+            result.dispatchFailed += 1;
             console.error(`[integrations] Failed to retry pending task ${row.id}:`, err);
         }
     }
+    return result;
 }
 function getProcessingStuckAfterMs() {
     if (process.env.NETLIFY ||
@@ -145,58 +256,6 @@ function getProcessingStuckAfterMs() {
     }
     return DEFAULT_PROCESSING_STUCK_AFTER_MS;
 }
-/**
- * Fire-and-forget POST to the processor endpoint for a single task id.
- * Mirrors the original dispatch from the webhook handler, including the
- * short-lived HMAC bearer token bound to this taskId.
- */
-async function refireProcessor(taskId, webhookBaseUrl) {
-    const baseUrl = webhookBaseUrl ||
-        process.env.WEBHOOK_BASE_URL ||
-        process.env.APP_URL ||
-        process.env.URL ||
-        process.env.DEPLOY_URL ||
-        `http://localhost:${process.env.PORT || 3000}`;
-    const url = `${withConfiguredAppBasePath(baseUrl)}${PROCESSOR_PATH}`;
-    // Sign with HMAC if A2A_SECRET is configured. In production we MUST sign —
-    // an unsigned dispatch in production lets attackers re-trigger any queued
-    // task with a guessable id (C3 in the webhook security audit). In dev we
-    // fall back to unsigned so contributors can iterate without configuring
-    // A2A_SECRET locally.
-    const headers = {
-        "Content-Type": "application/json",
-    };
-    try {
-        headers["Authorization"] = `Bearer ${signInternalToken(taskId)}`;
-    }
-    catch (err) {
-        if (process.env.NODE_ENV === "production") {
-            console.error(`[integrations] Refusing to dispatch task ${taskId} — A2A_SECRET not configured. ` +
-                "Set A2A_SECRET to enable signed retry dispatches.");
-            return;
-        }
-        // Dev: proceed unsigned. Log the underlying error path so a malformed
-        // secret (different from "not set") doesn't fail silently (L5 in the audit).
-        if (err instanceof Error && !/A2A_SECRET/i.test(err.message)) {
-            console.error(`[integrations] signInternalToken failed unexpectedly for ${taskId}:`, err);
-        }
-    }
-    // Don't await the body — we just want the request to leave the box.
-    // A short timeout avoids tying up the retry loop on a hung processor.
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), 5_000);
-    try {
-        await fetch(url, {
-            method: "POST",
-            headers,
-            body: JSON.stringify({ taskId }),
-            signal: controller.signal,
-        });
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
 /**
  * Start the periodic retry loop. Safe to call multiple times — second call
  * is a no-op.