@agent-native/core 0.130.1 → 0.131.2

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

@@ -1,9 +1,9 @@
 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 { INTEGRATION_DURABLE_DISPATCH_ENV, INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV, INTEGRATION_PROCESS_TASK_PATH, INTEGRATION_RECOVERY_RUNTIME_MARKER, INTEGRATION_RETRY_SWEEP_PATH, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, isInIntegrationRecoveryRuntime, 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 { INTEGRATION_DURABLE_DISPATCH_ENV, INTEGRATION_DURABLE_DISPATCH_SCOPES_ENV, INTEGRATION_PROCESS_TASK_PATH, INTEGRATION_RECOVERY_RUNTIME_MARKER, INTEGRATION_RETRY_SWEEP_PATH, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, isInIntegrationRecoveryRuntime, isIntegrationDurableDispatchConfigured, };
 export const INTEGRATION_CAMPAIGN_PROCESSOR_FIELD = "__integrationCampaignContinuation";
 export function integrationDispatchScopeValue(task) {
     const value = task.platformContext?.channelId;

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

@@ -1 +1 @@
-{"version":3,"file":"integration-durable-dispatch.js","sourceRoot":"","sources":["../../src/integrations/integration-durable-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EACL,gCAAgC,EAChC,sCAAsC,EACtC,4CAA4C,EAC5C,oCAAoC,GACrC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACL,gCAAgC,EAChC,uCAAuC,EACvC,6BAA6B,EAC7B,4BAA4B,EAC5B,qCAAqC,EACrC,sCAAsC,GACvC,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC;AAE5E,OAAO,EACL,gCAAgC,EAChC,uCAAuC,EACvC,6BAA6B,EAC7B,4BAA4B,EAC5B,qCAAqC,EACrC,sCAAsC,GACvC,CAAC;AAOF,MAAM,CAAC,MAAM,oCAAoC,GAC/C,mCAAmC,CAAC;AAatC,MAAM,UAAU,6BAA6B,CAC3C,IAAkC;IAElC,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,0CAA0C;IAGxD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC;IAClE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO;YACL,QAAQ,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE;YACxD,KAAK,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;SACvD,CAAC;IACJ,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAkC;IAC7D,MAAM,UAAU,GAAG;QACjB,GAAG,IAAI,CAAC,QAAQ,IAAI;QACpB,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EAAE;KAC5C,CAAC;IACF,MAAM,aAAa,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,aAAa,EAAE,CAAC;QAClB,UAAU,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,aAAa,EAAE,CAAC,CAAC;IACvD,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,SAAS;YAAE,UAAU,CAAC,IAAI,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,IAAkC;IAElC,IAAI,CAAC,sCAAsC,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,MAAM,GAAG,0CAA0C,EAAE,CAAC;IAC5D,IACE,MAAM;QACN,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAC5C,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE,KAAK,SAAS,CAAC,CACzE,EACD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,oCAAoC,CAC/C,6BAA6B,CAC9B,CAAC;IACF,OAAO,CACL,4CAA4C,CAAC,IAAI,CAAC;QAClD,sBAAsB,EAAE,CACzB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,MAAc,EACd,OAAmC;IAEnC,IAAI,CAAC;QACH,MAAM,gCAAgC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,wDAAwD,MAAM,GAAG,EACjE,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAClB,MAAc,EACd,OAAmC,EACnC,SAAiB;IAEjB,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAE;QACnD,MAAM;QACN,OAAO;QACP,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;KACnC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,KAQpD;IACC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,0CAA0C,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACvE,IACE,KAAK,CAAC,oBAAoB;QAC1B,CAAC,OAAO;QACR,CAAC,KAAK,CAAC,2CAA2C,EAClD,CAAC;QACD,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,cAAc,GAAG,oCAAoC,CACzD,6BAA6B,CAC9B,CAAC;QACF,IAAI,CAAC;YACH,MAAM,oBAAoB,CAAC;gBACzB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE;oBACJ,CAAC,gCAAgC,CAAC,EAChC,sCAAsC;oBACxC,GAAG,CAAC,KAAK,CAAC,oBAAoB;wBAC5B,CAAC,CAAC,EAAE,CAAC,oCAAoC,CAAC,EAAE,IAAI,EAAE;wBAClD,CAAC,CAAC,EAAE,CAAC;iBACR;gBACD,aAAa,EAAE,IAAI;gBACnB,iBAAiB,EAAE,KAAK;aACzB,CAAC,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;gBAChC,MAAM,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;YAChE,CAAC;YACD,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,yBAAyB,EAAE,SAAS,CAAC,CAAC;YAChE,OAAO,yBAAyB,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CACX,iDAAiD,KAAK,CAAC,MAAM,kCAAkC,EAC/F,KAAK,CACN,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,MAAM,oBAAoB,CAAC;YACzB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,6BAA6B;YACnC,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,oBAAoB;gBAC9B,CAAC,CAAC,EAAE,CAAC,oCAAoC,CAAC,EAAE,IAAI,EAAE;gBAClD,CAAC,CAAC,SAAS;YACb,QAAQ,EAAE,KAAK,CAAC,gBAAgB;SACjC,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;YAChC,MAAM,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;QAC7D,CAAC;QACD,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,sBAAsB,EAAE,SAAS,CAAC,CAAC;QAC7D,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,+CAA+C,KAAK,CAAC,MAAM,GAAG,EAC9D,KAAK,CACN,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;YAChC,MAAM,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/C,CAAC;QACD,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC","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 const INTEGRATION_CAMPAIGN_PROCESSOR_FIELD =\n  \"__integrationCampaignContinuation\";\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  campaignContinuation?: boolean;\n  allowPortableConfirmedReceiptReconciliation?: boolean;\n}): Promise<IntegrationDispatchOutcome> {\n  const startedAt = Date.now();\n  const durable = isIntegrationDurableDispatchEnabledForTask(input.task);\n  if (\n    input.campaignContinuation &&\n    !durable &&\n    !input.allowPortableConfirmedReceiptReconciliation\n  ) {\n    logDispatch(input.taskId, \"failed\", startedAt);\n    return \"failed\";\n  }\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          ...(input.campaignContinuation\n            ? { [INTEGRATION_CAMPAIGN_PROCESSOR_FIELD]: true }\n            : {}),\n        },\n        awaitResponse: true,\n        responseTimeoutMs: 2_000,\n      });\n      if (!input.campaignContinuation) {\n        await recordDispatch(input.taskId, \"background-acknowledged\");\n      }\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      body: input.campaignContinuation\n        ? { [INTEGRATION_CAMPAIGN_PROCESSOR_FIELD]: true }\n        : undefined,\n      settleMs: input.portableSettleMs,\n    });\n    if (!input.campaignContinuation) {\n      await recordDispatch(input.taskId, \"portable-unconfirmed\");\n    }\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    if (!input.campaignContinuation) {\n      await recordDispatch(input.taskId, \"failed\");\n    }\n    logDispatch(input.taskId, \"failed\", startedAt);\n    return \"failed\";\n  }\n}\n"]}
+{"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_RECOVERY_RUNTIME_MARKER,\n  INTEGRATION_RETRY_SWEEP_PATH,\n  INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT,\n  isInIntegrationRecoveryRuntime,\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_RECOVERY_RUNTIME_MARKER,\n  INTEGRATION_RETRY_SWEEP_PATH,\n  INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT,\n  isInIntegrationRecoveryRuntime,\n  isIntegrationDurableDispatchConfigured,\n};\n\nexport type IntegrationDispatchOutcome =\n  | \"background-acknowledged\"\n  | \"portable-unconfirmed\"\n  | \"failed\";\n\nexport const INTEGRATION_CAMPAIGN_PROCESSOR_FIELD =\n  \"__integrationCampaignContinuation\";\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  campaignContinuation?: boolean;\n  allowPortableConfirmedReceiptReconciliation?: boolean;\n}): Promise<IntegrationDispatchOutcome> {\n  const startedAt = Date.now();\n  const durable = isIntegrationDurableDispatchEnabledForTask(input.task);\n  if (\n    input.campaignContinuation &&\n    !durable &&\n    !input.allowPortableConfirmedReceiptReconciliation\n  ) {\n    logDispatch(input.taskId, \"failed\", startedAt);\n    return \"failed\";\n  }\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          ...(input.campaignContinuation\n            ? { [INTEGRATION_CAMPAIGN_PROCESSOR_FIELD]: true }\n            : {}),\n        },\n        awaitResponse: true,\n        responseTimeoutMs: 2_000,\n      });\n      if (!input.campaignContinuation) {\n        await recordDispatch(input.taskId, \"background-acknowledged\");\n      }\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      body: input.campaignContinuation\n        ? { [INTEGRATION_CAMPAIGN_PROCESSOR_FIELD]: true }\n        : undefined,\n      settleMs: input.portableSettleMs,\n    });\n    if (!input.campaignContinuation) {\n      await recordDispatch(input.taskId, \"portable-unconfirmed\");\n    }\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    if (!input.campaignContinuation) {\n      await recordDispatch(input.taskId, \"failed\");\n    }\n    logDispatch(input.taskId, \"failed\", startedAt);\n    return \"failed\";\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/integrations/plugin.ts"],"names":[],"mappings":"AA4CA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA0HzD,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EAK1B,MAAM,YAAY,CAAC;AAYpB,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAyM9D,eAAO,MAAM,sCAAsC;uBACrC,OAAO;;;uBACP,UAAU;;;uBACV,UAAU;;;uBACV,iBAAiB;;;uBACjB,SAAS;;;uBACT,aAAa;;;uBACb,OAAO;;EAIlB,CAAC;AAEJ,eAAO,MAAM,gCAAgC,0GAE5C,CAAC;AAEF,wBAAgB,gCAAgC,IAAI,eAAe,EAAE,CAEpE;AAUD,KAAK,yBAAyB,GAAG;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAgCF,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsFlC;AAmOD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,yBAAyB,GAClC,cAAc,CAqmFhB;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,gBAA6B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/integrations/plugin.ts"],"names":[],"mappings":"AA6CA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA2HzD,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EAK1B,MAAM,YAAY,CAAC;AAYpB,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAyM9D,eAAO,MAAM,sCAAsC;uBACrC,OAAO;;;uBACP,UAAU;;;uBACV,UAAU;;;uBACV,iBAAiB;;;uBACjB,SAAS;;;uBACT,aAAa;;;uBACb,OAAO;;EAIlB,CAAC;AAEJ,eAAO,MAAM,gCAAgC,0GAE5C,CAAC;AAEF,wBAAgB,gCAAgC,IAAI,eAAe,EAAE,CAEpE;AAUD,KAAK,yBAAyB,GAAG;IAC/B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAgCF,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsFlC;AAmOD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,yBAAyB,GAClC,cAAc,CAunFhB;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,gBAA6B,CAAC"}

package/dist/integrations/plugin.js

@@ -1,7 +1,7 @@
 import { defineEventHandler, setResponseStatus, setResponseHeader, getMethod, getQuery, sendRedirect, } from "h3";
 import { getRequestHeader } from "h3";
 import { createRemoteJWKSet, jwtVerify } from "jose";
-import { AGENT_BACKGROUND_PROCESSOR_FIELD, AGENT_BACKGROUND_PROCESSOR_INTEGRATION, } from "../agent/durable-background.js";
+import { AGENT_BACKGROUND_PROCESSOR_FIELD, AGENT_BACKGROUND_PROCESSOR_INTEGRATION, isInBackgroundFunctionRuntime, } from "../agent/durable-background.js";
 import { abortRun } from "../agent/run-manager.js";
 import { getOrgContext, resolveOrgIdForEmail } from "../org/context.js";
 import { loadResourcesForPrompt } from "../server/agent-chat-plugin.js";
@@ -32,7 +32,7 @@ import { IntegrationIdentityDeclinedError, resolveDefaultIntegrationExecutionCon
 import { disconnectIntegrationInstallation, listIntegrationInstallations, resolveIntegrationTokenBundle, updateIntegrationInstallation, upsertIntegrationInstallation, } from "./installations-store.js";
 import { recoverDueIntegrationCampaigns } from "./integration-campaign-recovery.js";
 import { claimIntegrationCampaignDeliveryForTask, completeIntegrationCampaignTaskAfterA2A, completeIntegrationCampaignTask, failIntegrationCampaignTaskDeliveryContainment, failDisabledIntegrationCampaignTask, failIntegrationCampaign, refreshIntegrationCampaignTaskA2AReceiptRetry, terminalizeIntegrationCampaignForTask, transitionIntegrationCampaignTaskToA2AReceiptRetry, transitionIntegrationCampaignTaskToDeliveryRetry, waitForA2AIntegrationCampaign, } from "./integration-campaigns-store.js";
-import { dispatchPendingIntegrationTask, INTEGRATION_CAMPAIGN_PROCESSOR_FIELD, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, integrationDispatchScopeValue, isIntegrationDurableDispatchConfigured, isIntegrationDurableDispatchEnabledForTask, } from "./integration-durable-dispatch.js";
+import { dispatchPendingIntegrationTask, INTEGRATION_CAMPAIGN_PROCESSOR_FIELD, INTEGRATION_RETRY_SWEEP_TOKEN_SUBJECT, integrationDispatchScopeValue, isInIntegrationRecoveryRuntime, isIntegrationDurableDispatchConfigured, isIntegrationDurableDispatchEnabledForTask, } from "./integration-durable-dispatch.js";
 import { forgetIntegrationMemory, integrationMemoryActions, listIntegrationMemory, rememberForIntegrationScope, } from "./integration-memory.js";
 import { extractBearerToken, verifyInternalToken } from "./internal-token.js";
 import { retryStuckPendingTasks, startPendingTasksRetryJob, } from "./pending-tasks-retry-job.js";
@@ -1221,13 +1221,20 @@ export function createIntegrationsPlugin(options) {
                 : {};
             let pollingDevice = device;
             if (method === "POST" &&
-                Object.prototype.hasOwnProperty.call(body, "computerCapabilities")) {
-                const computerCapabilities = readComputerCapabilities(body.computerCapabilities);
+                (Object.prototype.hasOwnProperty.call(body, "computerCapabilities") ||
+                    Object.prototype.hasOwnProperty.call(body, "browserSession"))) {
                 const updated = await updateRemoteDeviceDetails({
                     id: device.id,
                     metadata: {
                         ...(device.metadata ?? {}),
-                        computerCapabilities,
+                        ...(Object.prototype.hasOwnProperty.call(body, "computerCapabilities")
+                            ? {
+                                computerCapabilities: readComputerCapabilities(body.computerCapabilities),
+                            }
+                            : {}),
+                        ...(Object.prototype.hasOwnProperty.call(body, "browserSession")
+                            ? { browserSession: readBrowserSession(body.browserSession) }
+                            : {}),
                     },
                 });
                 if (updated)
@@ -2649,40 +2656,47 @@ export function createIntegrationsPlugin(options) {
             setResponseStatus(event, 404);
             return { error: "Not found" };
         }));
-        // ─── Start pending-tasks retry sweeper ────────────────────────
-        // Sweeps the integration_pending_tasks queue every 60s and re-fires the
-        // processor for any tasks that got stuck (initial dispatch lost or
-        // processor killed mid-flight). No-ops gracefully if the queue table
-        // hasn't been created yet on this deployment.
-        startPendingTasksRetryJob({
-            webhookBaseUrl: process.env.WEBHOOK_BASE_URL,
-        });
-        startA2AContinuationRetryJob(adapterMap);
-        startRemoteCommandsRetryJob();
-        startRemotePushDeliveryJob();
-        // ─── Start Google Docs poller/push ────────────────────────────
-        if (adapterMap.has("google-docs")) {
-            // Defer startup slightly so the server is fully ready
-            setTimeout(() => {
-                // We don't know the base URL at plugin init time — it depends on
-                // the incoming request. For push mode, the webhook URL needs to be
-                // resolved. We pass it as a special option; the poller will attempt
-                // to register a watch when the first request reveals the base URL,
-                // or use the WEBHOOK_BASE_URL env var if set.
-                const baseUrl = process.env.WEBHOOK_BASE_URL;
-                const webhookUrl = baseUrl
-                    ? `${withConfiguredAppBasePath(baseUrl)}${P}/google-docs/webhook`
-                    : undefined;
-                void startGoogleDocsPoller({
-                    systemPrompt: baseSystemPrompt,
-                    actions,
-                    initialToolNames,
-                    model: model ?? "",
-                    apiKey: getApiKey(),
-                    ownerEmail: "integration@google-docs",
-                    webhookUrl,
-                });
-            }, 2000);
+        // Background agent and scheduled recovery functions mount the same Nitro
+        // app, but they are workers rather than hosts for recurring integration
+        // jobs. Starting these timers in every worker multiplies recovery sweeps
+        // and pollers across concurrent runs, exhausting the shared database
+        // precisely while those runs are trying to checkpoint and deliver replies.
+        if (!isInBackgroundFunctionRuntime() && !isInIntegrationRecoveryRuntime()) {
+            // ─── Start pending-tasks retry sweeper ────────────────────────
+            // Sweeps the integration_pending_tasks queue every 60s and re-fires the
+            // processor for any tasks that got stuck (initial dispatch lost or
+            // processor killed mid-flight). No-ops gracefully if the queue table
+            // hasn't been created yet on this deployment.
+            startPendingTasksRetryJob({
+                webhookBaseUrl: process.env.WEBHOOK_BASE_URL,
+            });
+            startA2AContinuationRetryJob(adapterMap);
+            startRemoteCommandsRetryJob();
+            startRemotePushDeliveryJob();
+            // ─── Start Google Docs poller/push ────────────────────────────
+            if (adapterMap.has("google-docs")) {
+                // Defer startup slightly so the server is fully ready
+                setTimeout(() => {
+                    // We don't know the base URL at plugin init time — it depends on
+                    // the incoming request. For push mode, the webhook URL needs to be
+                    // resolved. We pass it as a special option; the poller will attempt
+                    // to register a watch when the first request reveals the base URL,
+                    // or use the WEBHOOK_BASE_URL env var if set.
+                    const baseUrl = process.env.WEBHOOK_BASE_URL;
+                    const webhookUrl = baseUrl
+                        ? `${withConfiguredAppBasePath(baseUrl)}${P}/google-docs/webhook`
+                        : undefined;
+                    void startGoogleDocsPoller({
+                        systemPrompt: baseSystemPrompt,
+                        actions,
+                        initialToolNames,
+                        model: model ?? "",
+                        apiKey: getApiKey(),
+                        ownerEmail: "integration@google-docs",
+                        webhookUrl,
+                    });
+                }, 2000);
+            }
         }
         if (process.env.DEBUG)
             console.log(`[integrations] Mounted integration routes for: ${adapters.map((a) => a.platform).join(", ")}`);
@@ -2734,6 +2748,37 @@ function readComputerCapabilities(value) {
         desktop: readSurface(input?.desktop, true),
     };
 }
+function readBrowserSession(value) {
+    if (value === null)
+        return null;
+    const input = readObject(value);
+    if (!input)
+        return null;
+    const handle = readString(input.handle);
+    const origin = readString(input.origin);
+    const title = readString(input.title);
+    if (input.version !== 1 ||
+        !handle ||
+        handle.length > 128 ||
+        !/^bsn_[0-9a-f-]+$/i.test(handle) ||
+        !origin ||
+        origin.length > 2_048 ||
+        !title ||
+        title.length > 512) {
+        return null;
+    }
+    try {
+        const url = new URL(origin);
+        if (url.origin !== origin ||
+            (url.protocol !== "http:" && url.protocol !== "https:")) {
+            return null;
+        }
+    }
+    catch {
+        return null;
+    }
+    return { version: 1, handle, origin, title };
+}
 function advertisedComputerOperationClasses(device) {
     const capabilities = getRemoteComputerCapabilities(device);
     const classes = [];