@agent-native/core 0.176.1 → 0.176.2-nightly-20260831184159

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export { AutomationConnectorError, createAutomationCallbackHandler, createAutoma
 export { defineFeatureFlag, defineFeatureFlags, evaluateFeatureFlag, getFeatureFlagDefinition, getFeatureFlagRules, hasActiveFeatureFlagRollout, isFeatureFlagEnabled, listFeatureFlags, registerFeatureFlags, type FeatureFlagDefinition, type FeatureFlagMode, type FeatureFlagRules, type FeatureFlagScope, } from "./feature-flags/index.js";
 export { createFeatureFlagA2AActionRouteAuth, createFeatureFlagsPlugin, } from "./feature-flags/server.js";
 export { createServer, createSSEHandler, defineNitroPlugin, autoMountAuth, getSession, type CreateServerOptions, type SSEHandlerOptions, type AuthSession, type AuthOptions, } from "./server/index.js";
-export { agentChat, type AgentChatCallOptions, type AgentChatResponse, } from "./shared/index.js";
+export { agentChat, isQaTestEmail, type AgentChatCallOptions, type AgentChatResponse, } from "./shared/index.js";
 export { EMBED_MODE_QUERY_PARAM, EMBED_SESSION_COOKIE, EMBED_START_PATH, EMBED_TOKEN_QUERY_PARAM, } from "./shared/embed-auth.js";
 export { AGENT_WEB_CRAWLER_CATEGORIES, AGENT_WEB_CRAWLER_USER_AGENTS, DEFAULT_AGENT_WEB_CRAWLER_POLICY, absoluteUrl, agentWebConfigFromPackageJson, buildAgentWebStaticFiles, buildBaseJsonLd, buildLlmsFullTxt, buildLlmsTxt, buildMarkdownResponseHeaders, buildPageJsonLd, buildRobotsTxt, buildSitemapXml, deriveAgentWebPublicRoutes, estimateMarkdownTokens, markdownFilePathForPage, markdownUrlForPage, normalizeAgentWebConfig, pathPatternMatches, resolveAgentWebCrawlerPolicy, type AgentWebConfig, type AgentWebCrawlerCategory, type AgentWebCrawlerDecision, type AgentWebCrawlerOverrides, type AgentWebCrawlerPolicy, type AgentWebInputConfig, type AgentWebPage, type AgentWebStaticFile, type BuildAgentWebStaticFilesOptions, type DeriveAgentWebPublicRoutesOptions, type MarkdownResponseHeadersOptions, } from "./agent-web/index.js";
 export { recordUsage, getUsageSummary, getUserUsageCents, calculateCost, usageBillingForEngine, builderCreditsFromCostCents, BUILDER_AGENT_CREDIT_MARGIN_MULTIPLIER, BUILDER_AGENT_CREDITS_PER_USD, BUILDER_CREDIT_USAGE_BILLING, USD_USAGE_BILLING, type UsageRecord, type UsageCostSource, type UsageCostAggregate, type UsageSummary, type UsageBillingMode, type UsageBillingUnit, type UsageBucket, type DailyBucket, type UsageRecentEntry, } from "./usage/store.js";

package/dist/index.js

@@ -39,7 +39,7 @@ export { createServer, createSSEHandler, defineNitroPlugin, autoMountAuth, getSe
 //
 //   import { useDbSync, cn } from "@agent-native/core/client";
 // Shared (isomorphic)
-export { agentChat, } from "./shared/index.js";
+export { agentChat, isQaTestEmail, } from "./shared/index.js";
 export { EMBED_MODE_QUERY_PARAM, EMBED_SESSION_COOKIE, EMBED_START_PATH, EMBED_TOKEN_QUERY_PARAM, } from "./shared/embed-auth.js";
 // Agent Web surfaces
 export { AGENT_WEB_CRAWLER_CATEGORIES, AGENT_WEB_CRAWLER_USER_AGENTS, DEFAULT_AGENT_WEB_CRAWLER_POLICY, absoluteUrl, agentWebConfigFromPackageJson, buildAgentWebStaticFiles, buildBaseJsonLd, buildLlmsFullTxt, buildLlmsTxt, buildMarkdownResponseHeaders, buildPageJsonLd, buildRobotsTxt, buildSitemapXml, deriveAgentWebPublicRoutes, estimateMarkdownTokens, markdownFilePathForPage, markdownUrlForPage, normalizeAgentWebConfig, pathPatternMatches, resolveAgentWebCrawlerPolicy, } from "./agent-web/index.js";

package/dist/ingestion/media.js

@@ -196,8 +196,13 @@ export async function readBoundedResponseBytes(response, maxBytes) {
     if (Number.isFinite(contentLength) && contentLength > maxBytes) {
         throw new Error(`Remote artifact exceeds ${maxBytes} bytes.`);
     }
-    if (!response.body)
-        return new Uint8Array(await response.arrayBuffer());
+    if (!response.body) {
+        const bytes = new Uint8Array(await response.arrayBuffer());
+        if (bytes.byteLength > maxBytes) {
+            throw new Error(`Remote artifact exceeds ${maxBytes} bytes.`);
+        }
+        return bytes;
+    }
     const reader = response.body.getReader();
     const chunks = [];
     let total = 0;

package/dist/integrations/config-store.js

@@ -83,13 +83,11 @@ export async function saveIntegrationConfigIfUnchanged(platform, configData, con
     await ensureTable();
     const client = getDbExec();
     const nextRaw = JSON.stringify(configData);
-    const timestamp = Date.now();
     const result = expected
         ? await client.execute({
-            sql: `UPDATE integration_configs SET config_data = ?, updated_at = ? WHERE platform = ? AND config_key = ? AND config_data = ? AND updated_at = ?`,
+            sql: `UPDATE integration_configs SET config_data = ?, updated_at = updated_at + 1 WHERE platform = ? AND config_key = ? AND config_data = ? AND updated_at = ?`,
             args: [
                 nextRaw,
-                timestamp,
                 platform,
                 configKey,
                 JSON.stringify(expected.configData),
@@ -100,7 +98,7 @@ export async function saveIntegrationConfigIfUnchanged(platform, configData, con
             sql: isPostgres()
                 ? `INSERT INTO integration_configs (platform, config_key, config_data, owner, updated_at) VALUES (?, ?, ?, ?, ?) ON CONFLICT (platform, config_key) DO NOTHING`
                 : `INSERT OR IGNORE INTO integration_configs (platform, config_key, config_data, owner, updated_at) VALUES (?, ?, ?, ?, ?)`,
-            args: [platform, configKey, nextRaw, owner ?? null, timestamp],
+            args: [platform, configKey, nextRaw, owner ?? null, Date.now()],
         });
     if (result.rowsAffected === 0)
         return false;

package/dist/integrations/google-docs-poller.d.ts

@@ -31,7 +31,7 @@ export interface GoogleDocsPollerOptions {
  *
  * Returns true if the watch was registered successfully.
  */
-export declare function registerWatch(webhookUrl: string, expectedChannelId?: string): Promise<boolean>;
+export declare function registerWatch(webhookUrl: string, expectedChannelId?: string, expectedPollerGeneration?: number): Promise<boolean>;
 export declare function verifyGoogleDocsPushNotification(headers: GoogleDocsPushHeaders): Promise<boolean>;
 export declare function stopGoogleDocsWatchChannel(accessToken: string, channelId: unknown, resourceId: unknown): Promise<boolean>;
 /**

package/dist/integrations/google-docs-poller.js

@@ -28,6 +28,7 @@ let pollerJob = null;
 // arming itself afterwards.
 let pollerStartTimer = null;
 let activeOptions = null;
+let pollerGeneration = 0;
 // ─── Watch Channel Management ───────────────────────────────────────────────
 /** How long a watch channel lasts (Google max is ~24h, we use 23h to renew early) */
 const WATCH_CHANNEL_TTL_MS = 23 * 60 * 60 * 1000;
@@ -35,6 +36,9 @@ const WATCH_RETRY_MS = 5 * 60 * 1000;
 const WATCH_STOP_CLAIM_TTL_MS = WATCH_RETRY_MS - 30 * 1000;
 let watchRenewalTimer = null;
 const watchCleanupTimers = new Map();
+function isCurrentPollerGeneration(generation) {
+    return generation === undefined || generation === pollerGeneration;
+}
 function unrefTimer(timer) {
     if (typeof timer === "object" && timer !== null && "unref" in timer) {
         timer.unref();
@@ -80,13 +84,40 @@ function scheduleOrphanedWatchCleanup(channel, delayMs = WATCH_RETRY_MS) {
     unrefTimer(timer);
     watchCleanupTimers.set(channel.id, timer);
 }
+async function cleanupRegisteredWatch(accessToken, channel) {
+    let currentConfig = null;
+    try {
+        currentConfig = await getIntegrationConfig(PLATFORM, "watch-channel");
+    }
+    catch (err) {
+        console.warn("[google-docs] Could not read watch config during cleanup; continuing with provider stop", err);
+    }
+    const stopped = await stopGoogleDocsWatchChannel(accessToken, channel.id, channel.resourceId);
+    if (!stopped) {
+        scheduleOrphanedWatchCleanup(channel);
+        return;
+    }
+    if (currentConfig?.configData?.channelId === channel.id) {
+        try {
+            await saveIntegrationConfigIfUnchanged(PLATFORM, {}, "watch-channel", currentConfig);
+        }
+        catch (err) {
+            console.warn("[google-docs] Could not clear watch config after provider stop", err);
+        }
+    }
+}
 /**
  * Register a Google Drive changes.watch channel so Google pushes
  * notifications to our webhook instead of us polling.
  *
  * Returns true if the watch was registered successfully.
  */
-export async function registerWatch(webhookUrl, expectedChannelId) {
+export async function registerWatch(webhookUrl, expectedChannelId, expectedPollerGeneration) {
+    if (!isCurrentPollerGeneration(expectedPollerGeneration))
+        return false;
+    const integrationConfig = await getIntegrationConfig(PLATFORM);
+    if (!integrationConfig?.configData?.enabled)
+        return false;
     const accessToken = await getServiceAccountAccessToken();
     if (!accessToken)
         return false;
@@ -96,6 +127,8 @@ export async function registerWatch(webhookUrl, expectedChannelId) {
         pageToken = await getStartPageToken(accessToken);
         await setPageToken(pageToken);
     }
+    if (!isCurrentPollerGeneration(expectedPollerGeneration))
+        return false;
     const channelId = `gdocs-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
     const expiration = Date.now() + WATCH_CHANNEL_TTL_MS;
     const { token: channelToken, tokenHash: channelTokenHash } = createGoogleDocsChannelAuth();
@@ -108,6 +141,8 @@ export async function registerWatch(webhookUrl, expectedChannelId) {
             currentConfig?.configData?.channelId !== expectedChannelId) {
             return false;
         }
+        if (!isCurrentPollerGeneration(expectedPollerGeneration))
+            return false;
         const res = await fetch("https://www.googleapis.com/drive/v3/changes/watch", {
             method: "POST",
             headers: {
@@ -130,6 +165,15 @@ export async function registerWatch(webhookUrl, expectedChannelId) {
         }
         const data = (await res.json());
         registeredChannel = { id: data.id, resourceId: data.resourceId };
+        if (!isCurrentPollerGeneration(expectedPollerGeneration)) {
+            await cleanupRegisteredWatch(accessToken, registeredChannel);
+            return false;
+        }
+        const enabledAfterRegistration = await getIntegrationConfig(PLATFORM);
+        if (!enabledAfterRegistration?.configData?.enabled) {
+            await cleanupRegisteredWatch(accessToken, registeredChannel);
+            return false;
+        }
         // Promote only if no other registration changed the active channel while
         // this request was in flight. Stop this orphaned channel if it lost.
         const promoted = await saveIntegrationConfigIfUnchanged(PLATFORM, {
@@ -140,16 +184,19 @@ export async function registerWatch(webhookUrl, expectedChannelId) {
             webhookUrl,
         }, "watch-channel", currentConfig);
         if (!promoted) {
-            const stopped = await stopGoogleDocsWatchChannel(accessToken, data.id, data.resourceId);
-            if (!stopped) {
-                scheduleOrphanedWatchCleanup({
-                    id: data.id,
-                    resourceId: data.resourceId,
-                });
-            }
+            await cleanupRegisteredWatch(accessToken, registeredChannel);
             console.warn(`[google-docs] Watch registration lost a concurrent update (channel: ${data.id})`);
             return false;
         }
+        if (!isCurrentPollerGeneration(expectedPollerGeneration)) {
+            await cleanupRegisteredWatch(accessToken, registeredChannel);
+            return false;
+        }
+        const enabledBeforeScheduling = await getIntegrationConfig(PLATFORM);
+        if (!enabledBeforeScheduling?.configData?.enabled) {
+            await cleanupRegisteredWatch(accessToken, registeredChannel);
+            return false;
+        }
         const previousChannelId = currentConfig?.configData?.channelId;
         if (typeof previousChannelId === "string" &&
             previousChannelId !== data.id) {
@@ -164,17 +211,18 @@ export async function registerWatch(webhookUrl, expectedChannelId) {
                 });
             }
         }
+        if (!isCurrentPollerGeneration(expectedPollerGeneration)) {
+            await cleanupRegisteredWatch(accessToken, registeredChannel);
+            return false;
+        }
         console.log(`[google-docs] Watch registered (channel: ${data.id}, expires: ${new Date(parseInt(data.expiration)).toISOString()})`);
         // Schedule renewal before expiration
-        scheduleWatchRenewal(webhookUrl, undefined, data.id);
+        scheduleWatchRenewal(webhookUrl, undefined, data.id, expectedPollerGeneration);
         return true;
     }
     catch (err) {
         if (registeredChannel) {
-            const stopped = await stopGoogleDocsWatchChannel(accessToken, registeredChannel.id, registeredChannel.resourceId);
-            if (!stopped) {
-                scheduleOrphanedWatchCleanup(registeredChannel);
-            }
+            await cleanupRegisteredWatch(accessToken, registeredChannel);
         }
         console.error("[google-docs] Watch registration error:", err);
         return false;
@@ -258,31 +306,53 @@ export async function stopGoogleDocsWatchChannel(accessToken, channelId, resourc
 /**
  * Schedule automatic watch renewal before the channel expires.
  */
-function scheduleWatchRenewal(webhookUrl, delayMs = WATCH_CHANNEL_TTL_MS - 60 * 60 * 1000, expectedChannelId) {
+function scheduleWatchRenewal(webhookUrl, delayMs = WATCH_CHANNEL_TTL_MS - 60 * 60 * 1000, expectedChannelId, expectedPollerGeneration) {
+    if (!isCurrentPollerGeneration(expectedPollerGeneration))
+        return;
     if (watchRenewalTimer)
         clearTimeout(watchRenewalTimer);
     watchRenewalTimer = setTimeout(async () => {
         watchRenewalTimer = null;
+        if (!isCurrentPollerGeneration(expectedPollerGeneration))
+            return;
         try {
             console.log("[google-docs] Renewing watch channel...");
-            if (await registerWatch(webhookUrl, expectedChannelId))
+            if (await registerWatch(webhookUrl, expectedChannelId, expectedPollerGeneration)) {
                 return;
-            if (expectedChannelId !== undefined) {
-                const currentConfig = await getIntegrationConfig(PLATFORM, "watch-channel");
-                if (currentConfig?.configData?.channelId !== expectedChannelId) {
-                    return;
-                }
             }
+            if (!(await shouldRetryWatchRenewal(expectedChannelId)))
+                return;
+            if (!isCurrentPollerGeneration(expectedPollerGeneration))
+                return;
             console.warn(`[google-docs] Could not register the replacement watch; retrying in ${WATCH_RETRY_MS / 60_000} minutes`);
-            scheduleWatchRenewal(webhookUrl, WATCH_RETRY_MS, expectedChannelId);
+            scheduleWatchRenewal(webhookUrl, WATCH_RETRY_MS, expectedChannelId, expectedPollerGeneration);
         }
         catch (err) {
             console.warn(`[google-docs] Watch renewal failed; retrying in ${WATCH_RETRY_MS / 60_000} minutes`, err);
-            scheduleWatchRenewal(webhookUrl, WATCH_RETRY_MS, expectedChannelId);
+            if (!isCurrentPollerGeneration(expectedPollerGeneration))
+                return;
+            try {
+                if (!(await shouldRetryWatchRenewal(expectedChannelId)))
+                    return;
+            }
+            catch (configErr) {
+                console.warn("[google-docs] Could not verify the current watch before retrying", configErr);
+                return;
+            }
+            scheduleWatchRenewal(webhookUrl, WATCH_RETRY_MS, expectedChannelId, expectedPollerGeneration);
         }
     }, delayMs);
     unrefTimer(watchRenewalTimer);
 }
+async function shouldRetryWatchRenewal(expectedChannelId) {
+    const integrationConfig = await getIntegrationConfig(PLATFORM);
+    if (!integrationConfig?.configData?.enabled)
+        return false;
+    if (expectedChannelId === undefined)
+        return true;
+    const currentConfig = await getIntegrationConfig(PLATFORM, "watch-channel");
+    return currentConfig?.configData?.channelId === expectedChannelId;
+}
 function scheduleWatchCleanupRetry(expectedClaimId, delayMs = WATCH_RETRY_MS) {
     if (watchRenewalTimer)
         clearTimeout(watchRenewalTimer);
@@ -619,9 +689,12 @@ export async function startGoogleDocsPoller(options) {
         console.warn("[google-docs] Already running");
         return;
     }
+    const generation = ++pollerGeneration;
     activeOptions = options;
     // Check if integration is enabled before trying to register watch
     const config = await getIntegrationConfig(PLATFORM);
+    if (!isCurrentPollerGeneration(generation))
+        return;
     if (!config?.configData?.enabled) {
         // Still start the poll loop so it picks up when enabled later
         startPollLoop(options, options.intervalMs ?? 30_000);
@@ -631,7 +704,9 @@ export async function startGoogleDocsPoller(options) {
     const webhookUrl = options.webhookUrl;
     let pushMode = false;
     if (webhookUrl) {
-        pushMode = await registerWatch(webhookUrl);
+        pushMode = await registerWatch(webhookUrl, undefined, generation);
+        if (!isCurrentPollerGeneration(generation))
+            return;
         if (pushMode) {
             console.log("[google-docs] Push mode active — using Drive webhooks");
             // In push mode, still poll slowly as a safety net (every 5 min)
@@ -695,6 +770,8 @@ function startPollLoop(options, intervalMs) {
  * Stop the Google Docs integration.
  */
 export async function stopGoogleDocsPoller() {
+    pollerGeneration += 1;
+    activeOptions = null;
     if (pollerStartTimer) {
         clearTimeout(pollerStartTimer);
         pollerStartTimer = null;
@@ -722,5 +799,4 @@ export async function stopGoogleDocsPoller() {
         console.warn(`[google-docs] Watch cleanup failed; retrying in ${WATCH_RETRY_MS / 60_000} minutes`, err);
         scheduleWatchCleanupRetry(undefined);
     }
-    activeOptions = null;
 }

package/dist/integrations/plugin.js

@@ -29,7 +29,7 @@ import { createComputerApprovalRequest, decideComputerApproval, listComputerAppr
 import { ComputerSupervisionError } from "./computer-supervision.js";
 import { getIntegrationConfig, saveIntegrationConfig } from "./config-store.js";
 import { claimIntegrationControl } from "./controls-store.js";
-import { startGoogleDocsPoller, handlePushNotification, verifyGoogleDocsPushNotification, } from "./google-docs-poller.js";
+import { startGoogleDocsPoller, stopGoogleDocsPoller, handlePushNotification, verifyGoogleDocsPushNotification, } from "./google-docs-poller.js";
 import { IntegrationIdentityDeclinedError, resolveDefaultIntegrationExecutionContext, } from "./identity.js";
 import { disconnectIntegrationInstallation, listIntegrationInstallations, resolveIntegrationTokenBundle, updateIntegrationInstallation, upsertIntegrationInstallation, } from "./installations-store.js";
 import { recoverDueIntegrationCampaigns } from "./integration-campaign-recovery.js";
@@ -600,6 +600,34 @@ export function createIntegrationsPlugin(options) {
         const initialToolNames = Object.keys(localActions);
         const h3 = getH3App(nitroApp);
         const P = `${FRAMEWORK_ROUTE_PREFIX}/integrations`;
+        let googleDocsPollerTransition = Promise.resolve();
+        const runGoogleDocsPollerTransition = (operation) => {
+            const previous = googleDocsPollerTransition;
+            let release;
+            googleDocsPollerTransition = new Promise((resolve) => {
+                release = resolve;
+            });
+            return previous
+                .catch(() => undefined)
+                .then(operation)
+                .finally(release);
+        };
+        const createGoogleDocsPollerOptions = (event) => {
+            const configuredBaseUrl = getAppConfig().integrations.webhookBaseUrl;
+            const baseUrl = configuredBaseUrl || (event ? getBaseUrl(event) : undefined);
+            const webhookUrl = baseUrl
+                ? `${withConfiguredAppBasePath(baseUrl)}${P}/google-docs/webhook`
+                : undefined;
+            return {
+                systemPrompt: baseSystemPrompt,
+                actions,
+                initialToolNames,
+                model: model ?? "",
+                apiKey: getApiKey(),
+                ownerEmail: "integration@google-docs",
+                webhookUrl,
+            };
+        };
         // Routes mounted under a platform's own name rather than reached through
         // the `/:platform/...` catch-all. The catch-all 404s a platform the
         // allow-list dropped because it resolves an adapter first; these are
@@ -2427,6 +2455,14 @@ export function createIntegrationsPlugin(options) {
                         setResponseStatus(event, 401);
                         return { ok: false, error: "unauthorized" };
                     }
+                    const config = await getIntegrationConfig(platform);
+                    if (!config?.configData?.enabled) {
+                        setResponseStatus(event, 404);
+                        return {
+                            ok: false,
+                            error: `Integration ${platform} is not enabled`,
+                        };
+                    }
                     handlePushNotification().catch((err) => {
                         console.error("[google-docs] Push handler error:", err);
                     });
@@ -2635,6 +2671,9 @@ export function createIntegrationsPlugin(options) {
                 // the row itself remains deployment-wide.
                 const session = await getSession(event).catch(() => null);
                 await saveIntegrationConfig(platform, { enabled: true }, "default", session?.email);
+                if (platform === "google-docs") {
+                    await runGoogleDocsPollerTransition(() => startGoogleDocsPoller(createGoogleDocsPollerOptions(event)));
+                }
                 return { ok: true, platform, enabled: true };
             }
             // ─── POST /:platform/disable ───────────────────────────
@@ -2644,6 +2683,9 @@ export function createIntegrationsPlugin(options) {
                     return { error: adminCheck.error };
                 const session = await getSession(event).catch(() => null);
                 await saveIntegrationConfig(platform, { enabled: false }, "default", session?.email);
+                if (platform === "google-docs") {
+                    await runGoogleDocsPollerTransition(stopGoogleDocsPoller);
+                }
                 return { ok: true, platform, enabled: false };
             }
             // ─── POST /:platform/setup ─────────────────────────────
@@ -2718,7 +2760,7 @@ export function createIntegrationsPlugin(options) {
             // 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,
+                webhookBaseUrl: getAppConfig().integrations.webhookBaseUrl,
             });
             startA2AContinuationRetryJob(adapterMap);
             startRemoteCommandsRetryJob();
@@ -2732,19 +2774,7 @@ export function createIntegrationsPlugin(options) {
                     // 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,
-                    });
+                    void runGoogleDocsPollerTransition(() => startGoogleDocsPoller(createGoogleDocsPollerOptions()));
                 }, 2000);
             }
         }

package/dist/integrations/webhook-handler.js

@@ -14,6 +14,7 @@ import { createThread, getThread, grantThreadUserShare, setThreadSourceIfMissing
 import { updateThreadData } from "../chat-threads/store.js";
 import { getOrgA2ASecret, resolveOrgIdForEmail } from "../org/context.js";
 import { withConfiguredAppBasePath } from "../server/app-base-path.js";
+import { getAppProductionUrl } from "../server/app-url.js";
 import { runWithRequestContext } from "../server/request-context.js";
 import { resolveSelfDispatchBaseUrl } from "../server/self-dispatch.js";
 import { normalizeReasoningEffortForRequest } from "../shared/reasoning-effort.js";
@@ -969,7 +970,7 @@ async function processIncomingMessage(incoming, options, opts = {}) {
                 // fallback. A completed write must not be reported as though nothing
                 // happened merely because the model ran out of time before its prose
                 // summary. Read-only and unverified tool results do not qualify.
-                const baseUrl = process.env.APP_URL || process.env.URL || "";
+                const baseUrl = getAppProductionUrl(undefined, { fallback: "" });
                 const appBaseUrl = baseUrl ? withConfiguredAppBasePath(baseUrl) : "";
                 const toolResults = collectToolResultSummaries(completedRun);
                 const verifiedMutationReceipt = buildA2AVerifiedMutationReceipt(collectCompletedMutationToolResultSummaries(completedRun), { baseUrl: appBaseUrl || undefined });

package/dist/jobs/background-automation-runner.js

@@ -1,5 +1,6 @@
 import { collectFinalResponseTextFromAgentEvents } from "../a2a/response-text.js";
 import { getStoredModelForEngine, normalizeModelForEngine, resolveEngine, } from "../agent/engine/index.js";
+import { resolveMainChatMaxOutputTokens } from "../agent/engine/output-tokens.js";
 import { actionsToEngineTools, filterInitialEngineTools, getOwnerActiveApiKey, } from "../agent/production-agent.js";
 import { runAgentLoopDirectWithSoftTimeout } from "../agent/run-loop-with-resume.js";
 import { abortRun, resolveBackgroundAutomationSoftTimeoutMs, resolveBackgroundRunHardTimeoutMs, startRun, } from "../agent/run-manager.js";
@@ -454,6 +455,14 @@ async function executeBackgroundAutomation(options, deps, historyId, runIdRef) {
                     runId,
                     maxIterations: automation.meta.maxIterations,
                     maxRunInputTokens: automation.meta.maxRunInputTokens,
+                    // Same model-aware ceiling the interactive paths pass (see
+                    // agent-teams.ts and webhook-handler.ts). Without it a scheduled
+                    // run silently inherits the flat per-engine default — a LOWER
+                    // budget than chat, on exactly the runs that produce the largest
+                    // single tool call (a digest, a dashboard, a batch insert), and
+                    // the truncation surfaces as an unexplained invalid-arguments
+                    // retry loop rather than as a budget problem.
+                    maxOutputTokens: resolveMainChatMaxOutputTokens(model),
                 };
                 // Same adapter A2A uses: bridge this runner's multi-argument shape
                 // to the single-argument `runAgentLoop` `instrumentAgentLoop`
@@ -475,10 +484,17 @@ async function executeBackgroundAutomation(options, deps, historyId, runIdRef) {
                             // makes it visible to per-user observability reads.
                             userId: ownerEmail,
                             config,
-                            spanName: "background_automation_run",
+                            // The trace list column is a name, so it has to say WHICH
+                            // automation ran; a constant here made every scheduled run
+                            // in LLM analytics indistinguishable from every other one.
+                            spanName: `background_automation_run:${automation.name}`,
                             metadata: {
                                 automation: automation.name,
                                 trigger: "background_automation",
+                                // `recurring-job:` / `manual-automation:` / `automation:`
+                                // — what actually started this run, which the span name
+                                // alone does not say.
+                                label: usageLabel,
                                 scope: orgId ? "organization" : "personal",
                             },
                         });

package/dist/localization/core-messages/ar-SA.js

@@ -41,6 +41,25 @@ const messages = {
     "onboarding.roleOther": "أخرى",
     "onboarding.skipForNow": "تخطي الآن",
     "onboarding.saveRoleError": "تعذر حفظ دورك.",
+    "onboarding.builderActivateCredits": "تفعيل أرصدة Builder.io المجانية",
+    "onboarding.builderConnectCredits": "الاتصال بأرصدة Builder.io المجانية",
+    "onboarding.builderActivateDescription": "أنشئ حساب Builder.io الخاص بك أو أعد استخدامه وفعّل أرصدته المجانية بنقرة واحدة.",
+    "onboarding.builderActiveCredits": "مضمّنة مع أرصدة Builder.io المجانية النشطة",
+    "onboarding.builderCredits": "مضمّنة مع أرصدة Builder.io المجانية",
+    "onboarding.builderActivateTitle": "تفعيل الأرصدة المجانية",
+    "onboarding.builderAccountExistsTitle": "لديك حساب Builder.io بالفعل",
+    "onboarding.builderAccountExistsDescription": "سجّل الدخول لربطه.",
+    "onboarding.builderActivationDescription": "سننشئ حساب Builder.io الخاص بك تلقائيًا بنقرة واحدة.",
+    "onboarding.builderCreateAndActivate": "إنشاء وتفعيل",
+    "onboarding.builderConsentPrefix": "بمتابعة العملية، فإنك توافق على",
+    "onboarding.builderTerms": "الشروط",
+    "onboarding.builderPrivacy": "الخصوصية",
+    "onboarding.builderConsentAnd": "و",
+    "onboarding.builderExistingAccount": "لدي حساب Builder.io",
+    "onboarding.builderActivating": "جارٍ تفعيل أرصدة Builder.io المجانية",
+    "onboarding.builderConnecting": "جارٍ الاتصال بأرصدة Builder.io المجانية",
+    "onboarding.builderProvisioningDescription": "جارٍ إنشاء حساب Builder.io الخاص بك أو إعادة استخدامه. يستغرق ذلك عادةً بضع ثوانٍ.",
+    "onboarding.builderConnectionDescription": "أكمل الاتصال بنقرة واحدة في النافذة الجديدة.",
     "aboutAgentNative.title": "حول Agent-Native",
     "aboutAgentNative.version": "الإصدار",
     "aboutAgentNative.environment": "البيئة",

package/dist/localization/core-messages/de-DE.js

@@ -41,6 +41,25 @@ const messages = {
     "onboarding.roleOther": "Andere",
     "onboarding.skipForNow": "Vorerst überspringen",
     "onboarding.saveRoleError": "Deine Rolle konnte nicht gespeichert werden.",
+    "onboarding.builderActivateCredits": "Builder.io-Gratiscredits aktivieren",
+    "onboarding.builderConnectCredits": "Builder.io-Gratiscredits verbinden",
+    "onboarding.builderActivateDescription": "Erstelle oder verwende dein Builder.io-Konto erneut und aktiviere seine Gratiscredits mit einem Klick.",
+    "onboarding.builderActiveCredits": "In aktiven Builder.io-Gratiscredits enthalten",
+    "onboarding.builderCredits": "In Builder.io-Gratiscredits enthalten",
+    "onboarding.builderActivateTitle": "Gratiscredits aktivieren",
+    "onboarding.builderAccountExistsTitle": "Du hast bereits ein Builder.io-Konto",
+    "onboarding.builderAccountExistsDescription": "Melde dich an, um es zu verbinden.",
+    "onboarding.builderActivationDescription": "Wir erstellen dein Builder.io-Konto automatisch für dich mit einem Klick.",
+    "onboarding.builderCreateAndActivate": "Erstellen und aktivieren",
+    "onboarding.builderConsentPrefix": "Wenn du fortfährst, stimmst du den",
+    "onboarding.builderTerms": "Nutzungsbedingungen",
+    "onboarding.builderPrivacy": "Datenschutzbestimmungen",
+    "onboarding.builderConsentAnd": "und",
+    "onboarding.builderExistingAccount": "Ich habe ein Builder.io-Konto",
+    "onboarding.builderActivating": "Builder.io-Gratiscredits werden aktiviert",
+    "onboarding.builderConnecting": "Builder.io-Gratiscredits werden verbunden",
+    "onboarding.builderProvisioningDescription": "Dein Builder.io-Konto wird erstellt oder wiederverwendet. Das dauert normalerweise ein paar Sekunden.",
+    "onboarding.builderConnectionDescription": "Schließe die Verbindung mit einem Klick im neuen Fenster ab.",
     "aboutAgentNative.title": "Über Agent-Native",
     "aboutAgentNative.version": "Version",
     "aboutAgentNative.environment": "Umgebung",

package/dist/localization/core-messages/en-US.d.ts

@@ -41,6 +41,25 @@ declare const messages: {
     readonly "onboarding.roleOther": "Other";
     readonly "onboarding.skipForNow": "Skip for now";
     readonly "onboarding.saveRoleError": "Could not save your role.";
+    readonly "onboarding.builderActivateCredits": "Activate Builder.io free credits";
+    readonly "onboarding.builderConnectCredits": "Connect Builder.io free credits";
+    readonly "onboarding.builderActivateDescription": "Create or reuse your Builder.io account and activate its free credits in one click.";
+    readonly "onboarding.builderActiveCredits": "Included with active Builder.io free credits";
+    readonly "onboarding.builderCredits": "Included with Builder.io free credits";
+    readonly "onboarding.builderActivateTitle": "Activate free credits";
+    readonly "onboarding.builderAccountExistsTitle": "You already have a Builder.io account";
+    readonly "onboarding.builderAccountExistsDescription": "Log in to connect it.";
+    readonly "onboarding.builderActivationDescription": "We'll automatically create your Builder.io account for you in one click.";
+    readonly "onboarding.builderCreateAndActivate": "Create and activate";
+    readonly "onboarding.builderConsentPrefix": "By continuing, you agree to Builder.io's";
+    readonly "onboarding.builderTerms": "Terms";
+    readonly "onboarding.builderPrivacy": "Privacy";
+    readonly "onboarding.builderConsentAnd": "and";
+    readonly "onboarding.builderExistingAccount": "I have a Builder.io account";
+    readonly "onboarding.builderActivating": "Activating Builder.io free credits";
+    readonly "onboarding.builderConnecting": "Connecting Builder.io free credits";
+    readonly "onboarding.builderProvisioningDescription": "Creating or reusing your Builder.io account. This usually takes a few seconds.";
+    readonly "onboarding.builderConnectionDescription": "Finish the one-click connection in the new window.";
     readonly "aboutAgentNative.title": "About Agent-Native";
     readonly "aboutAgentNative.version": "Version";
     readonly "aboutAgentNative.environment": "Environment";

package/dist/localization/core-messages/en-US.js

@@ -41,6 +41,25 @@ const messages = {
     "onboarding.roleOther": "Other",
     "onboarding.skipForNow": "Skip for now",
     "onboarding.saveRoleError": "Could not save your role.",
+    "onboarding.builderActivateCredits": "Activate Builder.io free credits",
+    "onboarding.builderConnectCredits": "Connect Builder.io free credits",
+    "onboarding.builderActivateDescription": "Create or reuse your Builder.io account and activate its free credits in one click.",
+    "onboarding.builderActiveCredits": "Included with active Builder.io free credits",
+    "onboarding.builderCredits": "Included with Builder.io free credits",
+    "onboarding.builderActivateTitle": "Activate free credits",
+    "onboarding.builderAccountExistsTitle": "You already have a Builder.io account",
+    "onboarding.builderAccountExistsDescription": "Log in to connect it.",
+    "onboarding.builderActivationDescription": "We'll automatically create your Builder.io account for you in one click.",
+    "onboarding.builderCreateAndActivate": "Create and activate",
+    "onboarding.builderConsentPrefix": "By continuing, you agree to Builder.io's",
+    "onboarding.builderTerms": "Terms",
+    "onboarding.builderPrivacy": "Privacy",
+    "onboarding.builderConsentAnd": "and",
+    "onboarding.builderExistingAccount": "I have a Builder.io account",
+    "onboarding.builderActivating": "Activating Builder.io free credits",
+    "onboarding.builderConnecting": "Connecting Builder.io free credits",
+    "onboarding.builderProvisioningDescription": "Creating or reusing your Builder.io account. This usually takes a few seconds.",
+    "onboarding.builderConnectionDescription": "Finish the one-click connection in the new window.",
     "aboutAgentNative.title": "About Agent-Native",
     "aboutAgentNative.version": "Version",
     "aboutAgentNative.environment": "Environment",

package/dist/localization/core-messages/es-ES.js

@@ -41,6 +41,25 @@ const messages = {
     "onboarding.roleOther": "Otro",
     "onboarding.skipForNow": "Omitir por ahora",
     "onboarding.saveRoleError": "No se pudo guardar tu rol.",
+    "onboarding.builderActivateCredits": "Activar créditos gratuitos de Builder.io",
+    "onboarding.builderConnectCredits": "Conectar créditos gratuitos de Builder.io",
+    "onboarding.builderActivateDescription": "Crea o reutiliza tu cuenta de Builder.io y activa sus créditos gratuitos con un solo clic.",
+    "onboarding.builderActiveCredits": "Incluido con créditos gratuitos activos de Builder.io",
+    "onboarding.builderCredits": "Incluido con los créditos gratuitos de Builder.io",
+    "onboarding.builderActivateTitle": "Activar créditos gratuitos",
+    "onboarding.builderAccountExistsTitle": "Ya tienes una cuenta de Builder.io",
+    "onboarding.builderAccountExistsDescription": "Inicia sesión para conectarla.",
+    "onboarding.builderActivationDescription": "Crearemos automáticamente tu cuenta de Builder.io con un solo clic.",
+    "onboarding.builderCreateAndActivate": "Crear y activar",
+    "onboarding.builderConsentPrefix": "Al continuar, aceptas los",
+    "onboarding.builderTerms": "Términos",
+    "onboarding.builderPrivacy": "Privacidad",
+    "onboarding.builderConsentAnd": "y",
+    "onboarding.builderExistingAccount": "Tengo una cuenta de Builder.io",
+    "onboarding.builderActivating": "Activando los créditos gratuitos de Builder.io",
+    "onboarding.builderConnecting": "Conectando los créditos gratuitos de Builder.io",
+    "onboarding.builderProvisioningDescription": "Creando o reutilizando tu cuenta de Builder.io. Esto suele tardar unos segundos.",
+    "onboarding.builderConnectionDescription": "Finaliza la conexión con un clic en la nueva ventana.",
     "aboutAgentNative.title": "Acerca de Agent-Native",
     "aboutAgentNative.version": "Versión",
     "aboutAgentNative.environment": "Entorno",