@agent-native/core 0.122.2 → 0.122.4

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

@@ -15,13 +15,25 @@ export type IntegrationResponseDeliveryTaskPayload = {
     deliveryReceipt?: PlatformDeliveryReceipt;
     deliveredAt?: string;
     artifacts?: A2AArtifactIdentity[];
+    campaignTerminalStatus?: "completed" | "failed";
+    awaitingA2ACompletion?: true;
 };
 export type ProcessIntegrationTaskResult = {
     status: "completed";
+} | {
+    status: "campaign-pending" | "campaign-active";
+} | {
+    status: "campaign-failed";
 } | {
     status: "delivery-pending";
     payload: IntegrationResponseDeliveryTaskPayload;
     errorMessage: string;
+    campaignLease?: {
+        campaignId: string;
+        runId: string;
+        leaseToken: string;
+        campaignStatus: "completed" | "failed" | "waiting-a2a";
+    };
 };
 export interface WebhookHandlerOptions {
     adapter: PlatformAdapter;
@@ -105,6 +117,9 @@ export declare function resolveBaseUrl(event: H3Event): string;
  * processor endpoint in `plugin.ts`. This is a fresh function execution, so
  * it gets its own timeout budget independent of the inbound webhook handler.
  */
-export declare function processIntegrationTask(task: PendingTask, options: WebhookHandlerOptions): Promise<ProcessIntegrationTaskResult>;
+export declare function processIntegrationTask(task: PendingTask, options: WebhookHandlerOptions, campaignOptions?: {
+    enabled?: boolean;
+    continuationInvocation?: boolean;
+}): Promise<ProcessIntegrationTaskResult>;
 export declare function recordIntegrationResponseDelivery(payload: IntegrationResponseDeliveryTaskPayload, receipt: PlatformDeliveryReceipt): Promise<void>;
 //# sourceMappingURL=webhook-handler.d.ts.map

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

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

package/dist/integrations/webhook-handler.js

@@ -6,6 +6,7 @@ import { getConfiguredEngineNameForRequest, getStoredModelForEngine, normalizeMo
 import { resolveMainChatMaxOutputTokens } from "../agent/engine/output-tokens.js";
 import { PROVIDER_TO_ENV } from "../agent/engine/provider-env-vars.js";
 import { runAgentLoop, actionsToEngineTools, filterInitialEngineTools, getOwnerActiveApiKey, getOwnerApiKey, engineToProvider, } from "../agent/production-agent.js";
+import { appendDurableContinuationContext } from "../agent/run-loop-with-resume.js";
 import { startRun } from "../agent/run-manager.js";
 import { buildCurrentTimeUserContext, buildRuntimeContextPrompt, } from "../agent/runtime-context.js";
 import { buildAssistantMessage, extractThreadMeta, threadDataToEngineMessages, } from "../agent/thread-data-builder.js";
@@ -19,7 +20,9 @@ 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 { 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";
 import { loadIntegrationMemoryPrompt } from "./integration-memory.js";
 import { insertPendingTask, isDuplicateEventError, stageTaskDeliveryPayload, } from "./pending-tasks-store.js";
@@ -32,6 +35,12 @@ const DEFERRED_RESPONSE_MAX_HANDLER_MS = 2_500;
 const EMPTY_INTEGRATION_RESPONSE_MESSAGE = "The model finished without a visible answer. Try again, or open the thread in Dispatch to inspect the run.";
 const CUTOFF_INTEGRATION_RESPONSE_MESSAGE = "I ran out of time on this one before I could write up an answer — it needed more research than a single run allows. " +
     "Open the thread in Dispatch to see what I gathered, or ask me again in smaller pieces (one source at a time works best).";
+const INTEGRATION_CAMPAIGN_LEASE_MS = 16 * 60_000;
+const INTEGRATION_CAMPAIGN_MAX_CHUNKS = 4;
+const INTEGRATION_CAMPAIGN_A2A_CHECK_MS = 30_000;
+// Keep a lost handoff plus the one-minute sweep inside the two-minute messaging
+// target without shortening general background-run budgets.
+const INTEGRATION_CAMPAIGN_NO_PROGRESS_TIMEOUT_MS = 45_000;
 /**
  * True when the run stopped at a continuation boundary rather than finishing:
  * the run-manager's soft timeout emits `auto_continue` and aborts the loop, and
@@ -42,6 +51,46 @@ const CUTOFF_INTEGRATION_RESPONSE_MESSAGE = "I ran out of time on this one befor
 function endedAtContinuationBoundary(run) {
     return run.events.some((runEvent) => runEvent.event.type === "auto_continue");
 }
+function continuationBoundaryReason(run) {
+    for (let index = run.events.length - 1; index >= 0; index -= 1) {
+        const runEvent = run.events[index];
+        if (!runEvent)
+            continue;
+        if (runEvent.event.type === "auto_continue")
+            return runEvent.event.reason;
+    }
+    return "run_timeout";
+}
+function checkpointContinuationReason(checkpoint) {
+    if (!checkpoint)
+        return "run_timeout";
+    try {
+        const reason = JSON.parse(checkpoint).reason;
+        if (reason === "run_timeout" ||
+            reason === "loop_limit" ||
+            reason === "max_tokens" ||
+            reason === "no_progress" ||
+            reason === "stream_ended" ||
+            reason === "gateway_timeout" ||
+            reason === "network_interrupted") {
+            return reason;
+        }
+    }
+    catch { }
+    return "run_timeout";
+}
+function parseIntegrationProgressRef(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return typeof parsed.kind === "string" &&
+            typeof parsed.streamTs === "string"
+            ? { kind: parsed.kind, streamTs: parsed.streamTs }
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Build a stable per-event dedup key from the incoming message. The same
  * key is computed for every retry of the same event from the platform —
@@ -354,15 +403,18 @@ export function resolveBaseUrl(event) {
  * processor endpoint in `plugin.ts`. This is a fresh function execution, so
  * it gets its own timeout budget independent of the inbound webhook handler.
  */
-export async function processIntegrationTask(task, options) {
+export async function processIntegrationTask(task, options, campaignOptions) {
     const parsed = JSON.parse(task.payload);
-    await recordInboundIntegrationAudit(task, parsed.incoming);
+    if (!campaignOptions?.continuationInvocation) {
+        await recordInboundIntegrationAudit(task, parsed.incoming);
+    }
     return processIncomingMessage(parsed.incoming, options, {
         taskId: task.id,
         attempts: task.attempts,
         placeholderRef: parsed.placeholderRef,
         orgId: task.orgId ?? undefined,
         principalType: parsed.principalType ?? options.principalType ?? "user",
+        durableCampaign: campaignOptions?.enabled === true,
     });
 }
 async function recordInboundIntegrationAudit(task, incoming) {
@@ -528,6 +580,152 @@ async function processIncomingMessage(incoming, options, opts = {}) {
             console.warn(`[integrations] Could not grant ${incoming.platform} sender access to thread ${threadId}:`, error instanceof Error ? error.message : error);
         });
     }
+    let campaign;
+    if (opts.durableCampaign && opts.taskId) {
+        const created = await createIntegrationCampaign({
+            integrationTaskId: opts.taskId,
+            threadId,
+            turnId: `integration-turn-${opts.taskId}`,
+        });
+        if (created.status === "completed") {
+            await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
+            return { status: "completed" };
+        }
+        if (created.status === "failed") {
+            await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
+            return { status: "campaign-failed" };
+        }
+        const runId = `integration-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+        const leaseToken = crypto.randomUUID();
+        const claimed = await claimIntegrationCampaign(created.id, {
+            runId,
+            leaseToken,
+            leaseDurationMs: INTEGRATION_CAMPAIGN_LEASE_MS,
+            maxChunks: INTEGRATION_CAMPAIGN_MAX_CHUNKS,
+        });
+        if (claimed.kind === "chunk-limit") {
+            const deliveryRunId = `integration-delivery-${crypto.randomUUID()}`;
+            const deliveryLeaseToken = crypto.randomUUID();
+            const deliveryCampaign = await claimIntegrationCampaignDeliveryForTask(opts.taskId, {
+                runId: deliveryRunId,
+                leaseToken: deliveryLeaseToken,
+                leaseDurationMs: INTEGRATION_CAMPAIGN_LEASE_MS,
+            });
+            if (!deliveryCampaign) {
+                await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
+                return { status: "campaign-active" };
+            }
+            const exhaustedProgressRef = deliveryCampaign.progressRef
+                ? parseIntegrationProgressRef(deliveryCampaign.progressRef)
+                : null;
+            const exhaustedProgress = exhaustedProgressRef
+                ? await adapter
+                    .resumeRunProgress?.(incoming, exhaustedProgressRef)
+                    .catch(() => null)
+                : null;
+            const exhaustedMessage = adapter.formatAgentResponse("I couldn't safely finish this request after several continuation attempts. No completed write will be replayed.");
+            let deliveryPayload = {
+                kind: "response-delivery",
+                incoming,
+                message: exhaustedMessage,
+                ...(opts.placeholderRef ? { placeholderRef: opts.placeholderRef } : {}),
+                internalThreadId: threadId,
+                campaignTerminalStatus: "failed",
+                ...buildDeliveryHistoryMessageIds(incoming),
+            };
+            try {
+                await stageTaskDeliveryPayload(opts.taskId, JSON.stringify(deliveryPayload));
+                let receipt;
+                if (exhaustedProgress) {
+                    try {
+                        receipt = await exhaustedProgress.complete(exhaustedMessage);
+                    }
+                    catch {
+                        receipt = await adapter.sendResponse(exhaustedMessage, incoming, {
+                            placeholderRef: opts.placeholderRef,
+                        });
+                    }
+                }
+                else {
+                    receipt = await adapter.sendResponse(exhaustedMessage, incoming, {
+                        placeholderRef: opts.placeholderRef,
+                    });
+                }
+                if (receipt?.status !== "delivered") {
+                    throw new Error(`${incoming.platform} exhaustion response completed without delivery proof`);
+                }
+                deliveryPayload = {
+                    ...deliveryPayload,
+                    deliveryReceipt: receipt,
+                    deliveredAt: new Date().toISOString(),
+                };
+                await stageTaskDeliveryPayload(opts.taskId, JSON.stringify(deliveryPayload));
+                await recordIntegrationResponseDelivery(deliveryPayload, receipt);
+                const terminalized = await failIntegrationCampaign(deliveryCampaign.id, {
+                    runId: deliveryRunId,
+                    leaseToken: deliveryLeaseToken,
+                    errorMessage: "Integration campaign exhausted its chunk limit",
+                });
+                if (!terminalized) {
+                    await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
+                    return { status: "campaign-active" };
+                }
+            }
+            catch (error) {
+                await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
+                return {
+                    status: "delivery-pending",
+                    payload: deliveryPayload,
+                    campaignLease: {
+                        campaignId: deliveryCampaign.id,
+                        runId: deliveryRunId,
+                        leaseToken: deliveryLeaseToken,
+                        campaignStatus: "failed",
+                    },
+                    errorMessage: error instanceof Error
+                        ? error.message.slice(0, 1000)
+                        : "Integration exhaustion response delivery failed",
+                };
+            }
+            await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
+            return { status: "campaign-failed" };
+        }
+        if (claimed.kind !== "claimed") {
+            await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
+            return { status: "campaign-active" };
+        }
+        campaign = { row: claimed.campaign, runId, leaseToken };
+        if (campaign.row.checkpoint) {
+            let waitingForA2A = false;
+            try {
+                waitingForA2A =
+                    JSON.parse(campaign.row.checkpoint).waitingForA2A === true;
+            }
+            catch { }
+            if (waitingForA2A) {
+                const activeA2A = await hasActiveA2AContinuationsForIntegrationTask(opts.taskId);
+                if (activeA2A) {
+                    const waiting = await waitForA2AIntegrationCampaign(campaign.row.id, {
+                        runId: campaign.runId,
+                        leaseToken: campaign.leaseToken,
+                        nextRunAt: Date.now() + INTEGRATION_CAMPAIGN_A2A_CHECK_MS,
+                        progressRef: campaign.row.progressRef,
+                    });
+                    await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
+                    return {
+                        status: waiting ? "campaign-pending" : "campaign-active",
+                    };
+                }
+                const completed = await completeIntegrationCampaignTask(campaign.row.id, {
+                    integrationTaskId: opts.taskId,
+                    runId: campaign.runId,
+                    leaseToken: campaign.leaseToken,
+                });
+                await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
+                return { status: completed ? "completed" : "campaign-active" };
+            }
+        }
+    }
     const existingMessages = [];
     if (thread?.threadData) {
         existingMessages.push(...threadDataToEngineMessages(thread.threadData));
@@ -555,15 +753,18 @@ async function processIncomingMessage(incoming, options, opts = {}) {
     // Precise current time rides the engine-facing user message (not the cached
     // system-prompt prefix, and not the persisted thread text) — the runtime
     // context appended to the system prompt is day-granular only.
-    const messages = [
-        ...existingMessages,
-        {
+    const messages = [...existingMessages];
+    if (campaign && campaign.row.chunkCount > 1) {
+        await appendDurableContinuationContext(messages, checkpointContinuationReason(campaign.row.checkpoint), threadId);
+    }
+    else {
+        messages.push({
             role: "user",
             content: [
                 { type: "text", text: userText + buildCurrentTimeUserContext() },
             ],
-        },
-    ];
+        });
+    }
     // Run agent loop via startRun, wrapped in a request context so that
     // tools (especially call-agent) can resolve the caller's org for org-scoped
     // A2A delegation. Without this, getRequestOrgId() returns undefined and
@@ -590,8 +791,25 @@ async function processIncomingMessage(incoming, options, opts = {}) {
         await releaseApplicableIntegrationBudgets(budgetReservations.reservations);
         throw error;
     }
-    const runId = `integration-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-    const progress = await adapter.startRunProgress?.(incoming).catch(() => null);
+    const runId = campaign?.runId ??
+        `integration-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+    const storedProgressRef = campaign?.row.progressRef
+        ? parseIntegrationProgressRef(campaign.row.progressRef)
+        : null;
+    const progress = storedProgressRef
+        ? await adapter
+            .resumeRunProgress?.(incoming, storedProgressRef)
+            .catch(() => null)
+        : await adapter.startRunProgress?.(incoming).catch(() => null);
+    if (campaign && campaign.row.chunkCount > 1 && progress) {
+        await Promise.resolve(progress.onEvent({
+            type: "agent_call_progress",
+            agent: "Agent Native",
+            state: "working",
+            elapsedSeconds: 0,
+            detail: "Continuing in the background",
+        })).catch(() => { });
+    }
     let usage = null;
     let budgetsSettled = false;
     // Wait for the run to complete inside this fresh function execution.
@@ -684,7 +902,23 @@ async function processIncomingMessage(incoming, options, opts = {}) {
             let threadCheckpoint;
             let outcome = { status: "completed" };
             try {
+                if (campaign) {
+                    const stillOwned = await heartbeatIntegrationCampaign(campaign.row.id, {
+                        runId: campaign.runId,
+                        leaseToken: campaign.leaseToken,
+                        leaseDurationMs: INTEGRATION_CAMPAIGN_LEASE_MS,
+                    });
+                    if (!stillOwned) {
+                        outcome = { status: "campaign-active" };
+                        return;
+                    }
+                }
                 queuedA2AContinuation = hasQueuedA2AContinuation(completedRun);
+                const durableCampaignContinuation = Boolean(campaign &&
+                    campaign.row.chunkCount < INTEGRATION_CAMPAIGN_MAX_CHUNKS &&
+                    completedRun.status === "completed" &&
+                    endedAtContinuationBoundary(completedRun) &&
+                    !queuedA2AContinuation);
                 const slackInputRequest = incoming.platform === "slack"
                     ? extractSlackInputRequest(completedRun)
                     : null;
@@ -704,6 +938,7 @@ async function processIncomingMessage(incoming, options, opts = {}) {
                 }
                 let suppressPlatformReply = queuedA2AContinuation &&
                     isQueuedA2AContinuationDeferral(responseText);
+                suppressPlatformReply ||= durableCampaignContinuation;
                 // Compute trusted tool receipts before choosing the empty-answer
                 // fallback. A completed write must not be reported as though nothing
                 // happened merely because the model ran out of time before its prose
@@ -787,6 +1022,14 @@ async function processIncomingMessage(incoming, options, opts = {}) {
                         artifacts: extractA2AArtifactIdentities(toolResults, {
                             persistedArtifactSecrets: artifactSecrets,
                         }),
+                        ...(campaign && queuedA2AContinuation
+                            ? { awaitingA2ACompletion: true }
+                            : {}),
+                        ...(campaign &&
+                            !queuedA2AContinuation &&
+                            !durableCampaignContinuation
+                            ? { campaignTerminalStatus: "completed" }
+                            : {}),
                     };
                     if (opts.taskId) {
                         await stageTaskDeliveryPayload(opts.taskId, JSON.stringify(stagedDeliveryPayload));
@@ -875,7 +1118,9 @@ async function processIncomingMessage(incoming, options, opts = {}) {
                     }
                 }
                 // Persist thread data
-                threadCheckpoint = await persistThreadData(threadId, incoming.text, completedRun, thread, deliveredResponse, toolResults, stagedDeliveryPayload, artifactSecrets);
+                const historyMessageIds = stagedDeliveryPayload ??
+                    (campaign ? buildDeliveryHistoryMessageIds(incoming) : undefined);
+                threadCheckpoint = await persistThreadData(threadId, incoming.text, completedRun, thread, deliveredResponse, toolResults, historyMessageIds, artifactSecrets, Boolean(campaign), !durableCampaignContinuation);
                 if (outgoingForDelivery && stagedDeliveryPayload) {
                     if (!threadCheckpoint) {
                         throw new Error("Integration response history checkpoint failed");
@@ -903,6 +1148,62 @@ async function processIncomingMessage(incoming, options, opts = {}) {
                 });
                 await settleApplicableIntegrationBudgets(budgetReservations.reservations, usage);
                 budgetsSettled = true;
+                if (campaign && queuedA2AContinuation) {
+                    const waiting = await waitForA2AIntegrationCampaign(campaign.row.id, {
+                        runId: campaign.runId,
+                        leaseToken: campaign.leaseToken,
+                        nextRunAt: Date.now() + INTEGRATION_CAMPAIGN_A2A_CHECK_MS,
+                        progressRef: progress?.ref
+                            ? JSON.stringify(progress.ref)
+                            : undefined,
+                    });
+                    if (!waiting) {
+                        throw new Error("Integration campaign lease was superseded");
+                    }
+                    outcome = { status: "campaign-pending" };
+                }
+                else if (campaign && durableCampaignContinuation) {
+                    const scheduled = await scheduleNextIntegrationCampaign(campaign.row.id, {
+                        runId: campaign.runId,
+                        leaseToken: campaign.leaseToken,
+                        nextRunAt: Date.now(),
+                        progressRef: progress?.ref
+                            ? JSON.stringify(progress.ref)
+                            : undefined,
+                        checkpoint: JSON.stringify({
+                            reason: continuationBoundaryReason(completedRun),
+                            threadId,
+                            ...(threadCheckpoint?.assistantMessageId
+                                ? {
+                                    assistantMessageId: threadCheckpoint.assistantMessageId,
+                                }
+                                : {}),
+                        }),
+                    });
+                    if (!scheduled) {
+                        throw new Error("Integration campaign lease was superseded");
+                    }
+                    await dispatchPendingIntegrationTask({
+                        taskId: opts.taskId,
+                        task: {
+                            platform: incoming.platform,
+                            externalThreadId: incoming.externalThreadId,
+                            platformContext: incoming.platformContext,
+                        },
+                        campaignContinuation: true,
+                    });
+                    outcome = { status: "campaign-pending" };
+                }
+                else if (campaign) {
+                    const completed = await completeIntegrationCampaignTask(campaign.row.id, {
+                        integrationTaskId: opts.taskId,
+                        runId: campaign.runId,
+                        leaseToken: campaign.leaseToken,
+                    });
+                    if (!completed) {
+                        throw new Error("Integration campaign lease was superseded");
+                    }
+                }
             }
             catch (err) {
                 console.error(`[integrations] Error sending response to ${incoming.platform}:`, err);
@@ -911,7 +1212,10 @@ async function processIncomingMessage(incoming, options, opts = {}) {
                         ? err.message.slice(0, 1000)
                         : `${incoming.platform} response delivery failed`;
                     if (!stagedDeliveryPayload?.deliveryReceipt) {
-                        threadCheckpoint = await persistThreadData(threadId, incoming.text, completedRun, thread, undefined, collectToolResultSummaries(completedRun), stagedDeliveryPayload, artifactSecrets);
+                        threadCheckpoint = await persistThreadData(threadId, incoming.text, completedRun, thread, undefined, collectToolResultSummaries(completedRun), stagedDeliveryPayload ??
+                            (campaign
+                                ? buildDeliveryHistoryMessageIds(incoming)
+                                : undefined), artifactSecrets, Boolean(campaign));
                     }
                     if (usage) {
                         await recordIntegrationUsage({
@@ -946,10 +1250,30 @@ async function processIncomingMessage(incoming, options, opts = {}) {
                                 ? { assistantMessageId: threadCheckpoint.assistantMessageId }
                                 : {}),
                         },
+                        ...(campaign &&
+                            (stagedDeliveryPayload?.campaignTerminalStatus ||
+                                stagedDeliveryPayload?.awaitingA2ACompletion)
+                            ? {
+                                campaignLease: {
+                                    campaignId: campaign.row.id,
+                                    runId: campaign.runId,
+                                    leaseToken: campaign.leaseToken,
+                                    campaignStatus: stagedDeliveryPayload.campaignTerminalStatus ??
+                                        "waiting-a2a",
+                                },
+                            }
+                            : {}),
                         errorMessage,
                     };
                     return;
                 }
+                if (campaign) {
+                    // A campaign-owned, no-delivery path must never fall through to
+                    // the default completed outcome. Its lease/checkpoint recovery
+                    // remains the sole owner of this logical turn.
+                    outcome = { status: "campaign-active" };
+                    return;
+                }
                 // A queued continuation owns the final platform response. Later
                 // bookkeeping failures must not close its stream with a false failure.
                 if (queuedA2AContinuation)
@@ -991,6 +1315,12 @@ async function processIncomingMessage(incoming, options, opts = {}) {
         {
             useHostedSoftTimeoutDefault: true,
             backgroundFunction: isInBackgroundFunctionRuntime(),
+            ...(campaign
+                ? {
+                    turnId: campaign.row.turnId,
+                    noProgressTimeoutMs: INTEGRATION_CAMPAIGN_NO_PROGRESS_TIMEOUT_MS,
+                }
+                : {}),
         });
     });
 }
@@ -1274,7 +1604,7 @@ function hasSubstantiveA2APartialAnswer(text) {
  * Persist the user message and agent response to the thread data,
  * so the conversation history is available in the web UI too.
  */
-async function persistThreadData(threadId, userText, completedRun, thread, deliveredResponse, toolResults = [], messageIds, artifactSecrets = []) {
+async function persistThreadData(threadId, userText, completedRun, thread, deliveredResponse, toolResults = [], messageIds, artifactSecrets = [], mergeRunContent = false, deliveryAttempted = true) {
     try {
         let repo;
         try {
@@ -1300,9 +1630,34 @@ async function persistThreadData(threadId, userText, completedRun, thread, deliv
         const existingAssistantMsg = builtAssistantMsg
             ? repo.messages.find((message) => message?.id === builtAssistantMsg.id)
             : undefined;
+        if (builtAssistantMsg && mergeRunContent) {
+            builtAssistantMsg.metadata.integrationRunIds = [completedRun.runId];
+        }
+        if (mergeRunContent && existingAssistantMsg && builtAssistantMsg) {
+            const previousRunIds = Array.isArray(existingAssistantMsg.metadata?.integrationRunIds)
+                ? existingAssistantMsg.metadata.integrationRunIds.filter((value) => typeof value === "string")
+                : [];
+            if (!previousRunIds.includes(completedRun.runId)) {
+                existingAssistantMsg.content = [
+                    ...(Array.isArray(existingAssistantMsg.content)
+                        ? existingAssistantMsg.content
+                        : []),
+                    ...(Array.isArray(builtAssistantMsg.content)
+                        ? builtAssistantMsg.content
+                        : []),
+                ];
+                existingAssistantMsg.metadata = {
+                    ...existingAssistantMsg.metadata,
+                    ...builtAssistantMsg.metadata,
+                    integrationRunIds: [...previousRunIds, completedRun.runId],
+                };
+            }
+        }
         const assistantMsg = existingAssistantMsg ?? builtAssistantMsg;
-        if (assistantMsg) {
+        if (assistantMsg && deliveryAttempted) {
             assistantMsg.metadata.integrationDeliveryAttempted = true;
+        }
+        if (assistantMsg) {
             const artifactIdentities = extractA2AArtifactIdentities(toolResults, {
                 persistedArtifactSecrets: artifactSecrets,
             });