@agent-native/core 0.129.2 → 0.130.0

package/corpus/templates/analytics/server/plugins/agent-chat.ts

@@ -172,7 +172,9 @@ interface DataSourceStatusSummary {
   externalSourceLabels: string[];
   availableExternalSources: Array<{
     aliases: string[];
-    configured: boolean;
+    configured: boolean | null;
+    label?: string;
+    setupLink?: string;
   }>;
   setupLink: string;
 }
@@ -242,7 +244,7 @@ function hasMissingRequestedExternalSource(
   const configuredAliases = [
     ...configuredSourceLabels.map((label) => [label]),
     ...availableExternalSources
-      .filter(({ configured }) => configured)
+      .filter(({ configured }) => configured === true)
       .map(({ aliases }) => aliases),
   ];
   const sourceAliases = [
@@ -256,12 +258,21 @@ function hasMissingRequestedExternalSource(
     .filter(({ terms }) =>
       terms.some((term) => containsNormalizedPhrase(userText, term)),
     )
-    .some(
-      ({ aliases }) =>
-        !configuredAliases.some((configured) =>
-          sourceAliasesOverlap(configured, aliases),
-        ),
-    );
+    .some(({ aliases }) => {
+      const matchingStatuses = availableExternalSources.filter((source) =>
+        sourceAliasesOverlap(source.aliases, aliases),
+      );
+      if (
+        matchingStatuses.some(
+          ({ configured }) => configured === true || configured === null,
+        )
+      ) {
+        return false;
+      }
+      return !configuredAliases.some((configured) =>
+        sourceAliasesOverlap(configured, aliases),
+      );
+    });
 }
 
 function dataSourceStatusSummary(
@@ -270,7 +281,7 @@ function dataSourceStatusSummary(
   const externalSourceLabels = new Set<string>();
   const availableExternalSources = new Map<
     string,
-    { aliases: string[]; configured: boolean }
+    DataSourceStatusSummary["availableExternalSources"][number]
   >();
   let checked = false;
   let setupLink = ANALYTICS_DATA_SOURCES_LINK;
@@ -278,7 +289,8 @@ function dataSourceStatusSummary(
   const addAvailableExternalSource = (
     provider: unknown,
     label: unknown,
-    configured: boolean,
+    configured: boolean | null,
+    providerSetupLink?: unknown,
   ) => {
     const aliases = [provider, label]
       .filter((value): value is string => typeof value === "string")
@@ -288,11 +300,35 @@ function dataSourceStatusSummary(
     if (!key) return;
     const existing = availableExternalSources.get(key);
     if (existing) {
-      existing.configured ||= configured;
+      existing.configured =
+        existing.configured === true || configured === true
+          ? true
+          : existing.configured === null || configured === null
+            ? null
+            : false;
       existing.aliases = [...new Set([...existing.aliases, ...aliases])];
+      if (!existing.label && typeof label === "string" && label.trim()) {
+        existing.label = label.trim();
+      }
+      if (
+        !existing.setupLink &&
+        typeof providerSetupLink === "string" &&
+        providerSetupLink.trim()
+      ) {
+        existing.setupLink = providerSetupLink.trim();
+      }
       return;
     }
-    availableExternalSources.set(key, { aliases, configured });
+    availableExternalSources.set(key, {
+      aliases,
+      configured,
+      ...(typeof label === "string" && label.trim()
+        ? { label: label.trim() }
+        : {}),
+      ...(typeof providerSetupLink === "string" && providerSetupLink.trim()
+        ? { setupLink: providerSetupLink.trim() }
+        : {}),
+    });
   };
 
   for (const result of toolResults ?? []) {
@@ -373,7 +409,12 @@ function dataSourceStatusSummary(
       if (typeof label === "string" && label.trim()) {
         externalSourceLabels.add(label.trim());
       }
-      addAvailableExternalSource(record.provider, label, true);
+      addAvailableExternalSource(
+        record.provider,
+        label,
+        true,
+        record.setupLink,
+      );
     }
 
     // Backward compatibility for status responses that predate the compact
@@ -393,12 +434,15 @@ function dataSourceStatusSummary(
         .toLowerCase();
       if (providerId === "first-party") continue;
       const label = record.label ?? record.provider;
+      const configured =
+        typeof record.configured === "boolean" ? record.configured : null;
       addAvailableExternalSource(
         record.provider,
         label,
-        record.configured === true,
+        configured,
+        record.setupLink,
       );
-      if (record.configured !== true) continue;
+      if (configured !== true) continue;
       if (typeof label === "string" && label.trim()) {
         externalSourceLabels.add(label.trim());
       }
@@ -418,8 +462,17 @@ function dataSourceStatusSummary(
       const record = provider as Record<string, unknown>;
       const providerId = record.id ?? record.provider;
       const label = record.label ?? providerId;
+      const grantState =
+        typeof record.grantState === "string" ? record.grantState : null;
       const configured =
-        record.configured === true || record.grantState === "connected";
+        record.configured === true || grantState === "connected"
+          ? true
+          : record.configured === false ||
+              grantState === "granted" ||
+              grantState === "needs_grant" ||
+              grantState === "not_connected"
+            ? false
+            : null;
       addAvailableExternalSource(providerId, label, configured);
       if (configured && typeof label === "string" && label.trim()) {
         externalSourceLabels.add(label.trim());
@@ -435,6 +488,34 @@ function dataSourceStatusSummary(
   };
 }
 
+function requestedExternalSourceSetup(
+  userText: string,
+  summary: DataSourceStatusSummary,
+): { label: string; setupLink: string } | null {
+  let source:
+    | DataSourceStatusSummary["availableExternalSources"][number]
+    | undefined;
+  let bestMatchLength = -1;
+  for (const candidate of summary.availableExternalSources) {
+    if (candidate.configured !== false || !candidate.setupLink) continue;
+    const matchLength = Math.max(
+      -1,
+      ...candidate.aliases
+        .filter((alias) => containsNormalizedPhrase(userText, alias))
+        .map((alias) => normalizeSourceLabel(alias).length),
+    );
+    if (matchLength > bestMatchLength) {
+      source = candidate;
+      bestMatchLength = matchLength;
+    }
+  }
+  if (!source?.setupLink) return null;
+  return {
+    label: source.label ?? source.aliases[0] ?? "data source",
+    setupLink: source.setupLink,
+  };
+}
+
 function includesDataSourcesLink(text: string, setupLink: string): boolean {
   const normalizedSetupLink = setupLink.trim().replace(/&amp;/g, "&");
   if (!normalizedSetupLink) return false;
@@ -475,8 +556,23 @@ export function realDataFinalGuard(
   const incompleteEvidence = hasIncompleteDataEvidence(context.toolResults);
   const dataQueryAttempted = hasDataQueryAttempt(context.toolResults);
   const sourceStatus = dataSourceStatusSummary(context.toolResults);
+  const requestedSourceSetup = requestedExternalSourceSetup(
+    userText,
+    sourceStatus,
+  );
+  const setupLink = requestedSourceSetup?.setupLink ?? sourceStatus.setupLink;
+  const setupLabel = requestedSourceSetup
+    ? `Connect ${requestedSourceSetup.label}`
+    : "Connect data sources";
+  const setupMarkdown = `[${setupLabel}](${setupLink})`;
+  const hasUnknownExternalSourceStatus =
+    sourceStatus.availableExternalSources.some(
+      ({ configured }) => configured === null,
+    );
   const noConnectedExternalSources =
-    sourceStatus.checked && sourceStatus.externalSourceLabels.length === 0;
+    sourceStatus.checked &&
+    sourceStatus.externalSourceLabels.length === 0 &&
+    !hasUnknownExternalSourceStatus;
   const externalSourceRequest = looksLikeExternalSourceRequest(userText);
   const missingRequestedExternalSource = hasMissingRequestedExternalSource(
     userText,
@@ -601,11 +697,11 @@ export function realDataFinalGuard(
     }
     if (
       needsDataSourceLink &&
-      !includesDataSourcesLink(context.text, sourceStatus.setupLink)
+      !includesDataSourcesLink(context.text, setupLink)
     ) {
       return {
-        retryMessage: `The response correctly explains that the requested live data is unavailable, but it needs a contextual next step. Explain which external source is missing, keep the conversation open, and include this exact markdown link: [Connect data sources](${sourceStatus.setupLink}). Do not use the generic no-grounded-data fallback.`,
-        fallbackMessage: `I can help with that once the relevant source is connected. [Connect data sources](${sourceStatus.setupLink})`,
+        retryMessage: `The response correctly explains that the requested live data is unavailable, but it needs a contextual next step. Explain which external source is missing, keep the conversation open, and include this exact markdown link: ${setupMarkdown}. Do not use the generic no-grounded-data fallback.`,
+        fallbackMessage: `I can help with that once the relevant source is connected. ${setupMarkdown}`,
         maxRetries: 2,
       };
     }
@@ -615,11 +711,11 @@ export function realDataFinalGuard(
   if (failedQueryMessage) {
     if (
       needsDataSourceLink &&
-      !includesDataSourcesLink(context.text, sourceStatus.setupLink)
+      !includesDataSourcesLink(context.text, setupLink)
     ) {
       return {
-        retryMessage: `${failedQueryMessage} Explain which external source is missing and include this exact markdown link: [Connect data sources](${sourceStatus.setupLink}).`,
-        fallbackMessage: `${failedQueryMessage} [Connect data sources](${sourceStatus.setupLink})`,
+        retryMessage: `${failedQueryMessage} Explain which external source is missing and include this exact markdown link: ${setupMarkdown}.`,
+        fallbackMessage: `${failedQueryMessage} ${setupMarkdown}`,
         maxRetries: 2,
       };
     }
@@ -635,8 +731,8 @@ export function realDataFinalGuard(
       (noConnectedExternalSources && externalSourceRequest))
   ) {
     return {
-      retryMessage: `The requested external source is not connected. Explain what is missing in the context of the user's question and include this exact markdown link: [Connect data sources](${sourceStatus.setupLink}). Do not use the generic no-grounded-data fallback.`,
-      fallbackMessage: `I can help with that once the relevant source is connected. [Connect data sources](${sourceStatus.setupLink})`,
+      retryMessage: `The requested external source is not connected. Explain what is missing in the context of the user's question and include this exact markdown link: ${setupMarkdown}. Do not use the generic no-grounded-data fallback.`,
+      fallbackMessage: `I can help with that once the relevant source is connected. ${setupMarkdown}`,
       maxRetries: 2,
       expandToolSurface: true,
     };
@@ -655,8 +751,8 @@ export function realDataFinalGuard(
   }
   if (noConnectedExternalSources) {
     return {
-      retryMessage: `The user asked for live analytics, but data-source-status found no connected external providers. The built-in first-party source is still available for first-party Analytics data. If this request needs an external source, respond naturally in the context of the user's question, explain what is missing, and include [Connect data sources](${sourceStatus.setupLink}). Do not use a generic canned no-data response.`,
-      fallbackMessage: `I can help with that once the relevant source is connected. [Connect data sources](${sourceStatus.setupLink})`,
+      retryMessage: `The user asked for live analytics, but data-source-status found no connected external providers. The built-in first-party source is still available for first-party Analytics data. If this request needs an external source, respond naturally in the context of the user's question, explain what is missing, and include ${setupMarkdown}. Do not use a generic canned no-data response.`,
+      fallbackMessage: `I can help with that once the relevant source is connected. ${setupMarkdown}`,
       maxRetries: 2,
       expandToolSurface: true,
     };

package/corpus/templates/analytics/server/routes/[...page].get.ts

@@ -2,6 +2,7 @@ import { AGENT_ACCESS_PARAM } from "@agent-native/core/server";
 import { createH3SSRHandler } from "@agent-native/core/server/ssr-handler";
 import {
   buildAgentReadableResourceDiscovery,
+  injectDocumentMarkup,
   renderAgentReadableResourceDiscoveryScript,
 } from "@agent-native/core/shared";
 import {
@@ -140,13 +141,7 @@ function injectAgentDiscovery(html: string, script: string): string {
   if (scriptId && html.includes(`id="${scriptId}"`)) {
     return html;
   }
-  if (html.includes("</head>")) {
-    return html.replace("</head>", `${script}</head>`);
-  }
-  if (html.includes("</body>")) {
-    return html.replace("</body>", `${script}</body>`);
-  }
-  return `${html}${script}`;
+  return injectDocumentMarkup(html, script, { target: "head" });
 }
 
 export default defineEventHandler(async (event) => {

package/corpus/templates/analytics/vite.config.ts

@@ -2,6 +2,8 @@ import { agentNative } from "@agent-native/core/vite";
 import { reactRouter } from "@react-router/dev/vite";
 import { defineConfig } from "vite";
 
+import { ANALYTICS_NATIVE_MCP_PRESET_EXCLUSIONS } from "./app/lib/native-mcp-exclusions";
+
 const reactRouterPlugins = reactRouter as unknown as () => any[];
 const agentNativePlugins = agentNative as unknown as (
   options?: Parameters<typeof agentNative>[0],
@@ -14,6 +16,11 @@ export default defineConfig({
       // shiki only runs in AssistantChat's useEffect — keep it out of the
       // CF Pages Functions bundle (25 MiB limit).
       ssrStubs: ["shiki"],
+      // Native data-source actions own these providers in Analytics; showing
+      // their MCP presets would create a second, conflicting setup path.
+      mcpIntegrations: {
+        defaults: { exclude: [...ANALYTICS_NATIVE_MCP_PRESET_EXCLUSIONS] },
+      },
     }),
   ],
 });

package/corpus/templates/brain/actions/list-connection-providers.ts

@@ -30,6 +30,59 @@ const SUPPORTED_SOURCE_PROVIDERS = new Set([
   "github",
 ]);
 
+function dispatchIntegrationsHref(providerId: string) {
+  const params = new URLSearchParams({
+    provider: providerId,
+    appId: APP_ID,
+    returnTo: "ask",
+  });
+  return `/dispatch/integrations?${params.toString()}`;
+}
+
+function providerApiConfigured({
+  credentialHealth,
+  providerApi,
+  workspace,
+}: {
+  credentialHealth: Awaited<ReturnType<typeof credentialHealthForProvider>>;
+  providerApi: ReturnType<typeof listProviderApiCatalog>[number] | null;
+  workspace: WorkspaceConnectionProviderAppSummary;
+}): boolean | null {
+  if (!providerApi) return null;
+  if (workspace.hasActiveWorkspaceConnection) return true;
+  if (providerApi.auth === "none") return true;
+
+  const availableKeys = new Set(
+    credentialHealth.details
+      .filter((detail) => detail.available)
+      .map((detail) => detail.key),
+  );
+
+  // Jira's legacy fallback is one complete Basic-auth tuple. The catalog keys
+  // are individually optional because OAuth is preferred, so the generic
+  // required-key count cannot prove that an unconnected Jira provider is ready.
+  if (providerApi.id === "jira") {
+    return ["JIRA_BASE_URL", "JIRA_USER_EMAIL", "JIRA_API_TOKEN"].every((key) =>
+      availableKeys.has(key),
+    );
+  }
+
+  if (
+    providerApi.auth.startsWith("oauth-bearer:") &&
+    !providerApi.auth.includes("-or-")
+  ) {
+    return false;
+  }
+  if (providerApi.credentialKeys.length === 0) return false;
+  if (
+    providerApi.auth.includes("-or-api-key-header:") ||
+    providerApi.auth.includes("-or-bearer-key:")
+  ) {
+    return providerApi.credentialKeys.some((key) => availableKeys.has(key));
+  }
+  return providerApi.credentialKeys.every((key) => availableKeys.has(key));
+}
+
 async function credentialHealthForProvider(
   provider: WorkspaceConnectionProviderCatalogForAppItem,
 ): Promise<{
@@ -100,14 +153,48 @@ async function credentialHealthForProvider(
 
 function providerHealthForProvider({
   credentialHealth,
+  providerApi,
+  providerApiIsConfigured,
   sourceProviderSupported,
   workspace,
 }: {
   credentialHealth: Awaited<ReturnType<typeof credentialHealthForProvider>>;
+  providerApi: ReturnType<typeof listProviderApiCatalog>[number] | null;
+  providerApiIsConfigured: boolean | null;
   sourceProviderSupported: boolean;
   workspace: WorkspaceConnectionProviderAppSummary;
 }) {
+  if (providerApi && providerApiIsConfigured === false) {
+    if (workspace.grantState === "needs_grant") {
+      return {
+        status: "needs_grant" as const,
+        message: workspace.grantAvailabilityMessage,
+      };
+    }
+    if (
+      workspace.hasGrantedWorkspaceConnection &&
+      !workspace.hasActiveWorkspaceConnection
+    ) {
+      return {
+        status: "unhealthy" as const,
+        message:
+          "Brain has a grant, but the shared connection needs reauth or repair.",
+      };
+    }
+    return {
+      status: "missing_credentials" as const,
+      message:
+        "Connect this provider before Brain makes an on-demand API request.",
+    };
+  }
   if (!sourceProviderSupported) {
+    if (providerApi) {
+      return {
+        status: "ready" as const,
+        message:
+          "Authenticated provider API access is ready for on-demand Brain queries.",
+      };
+    }
     return {
       status: "unsupported" as const,
       message:
@@ -175,7 +262,7 @@ async function listWorkspaceConnectionsForCatalog(): Promise<{
 
 export default defineAction({
   description:
-    "List reusable connection provider metadata relevant to Brain sources, including workspace connection grants for the Brain app.",
+    "Check reusable Brain source and provider API readiness before using a provider. Each provider reports whether authenticated access is configured and includes a focused setupLink. When a requested provider is unavailable, explain the missing connection and return its setupLink instead of attempting provider-api-request.",
   schema: z.object({}),
   http: { method: "GET" },
   readOnly: true,
@@ -206,8 +293,13 @@ export default defineAction({
         const workspaceConnection = provider.workspaceConnection;
         const credentialHealth = await credentialHealthForProvider(provider);
         const providerApi = isProviderApiId(provider.id)
-          ? listProviderApiCatalog(provider.id)[0]
+          ? (listProviderApiCatalog(provider.id)[0] ?? null)
           : null;
+        const providerApiIsConfigured = providerApiConfigured({
+          credentialHealth,
+          providerApi,
+          workspace: workspaceConnection,
+        });
         return {
           id: provider.id,
           label: provider.label,
@@ -222,9 +314,15 @@ export default defineAction({
           configuredSourceCount,
           hasConfiguredSources: configuredSourceCount > 0,
           sourceProviderSupported,
+          configured:
+            providerApiIsConfigured ??
+            (sourceProviderSupported ? credentialHealth.available : null),
+          setupLink: dispatchIntegrationsHref(provider.id),
           credentialHealth,
           providerHealth: providerHealthForProvider({
             credentialHealth,
+            providerApi,
+            providerApiIsConfigured,
             sourceProviderSupported,
             workspace: workspaceConnection,
           }),

package/corpus/templates/brain/app/lib/brain.ts

@@ -549,8 +549,18 @@ export interface BrainConnectionProvider {
   configuredSourceCount: number;
   hasConfiguredSources: boolean;
   sourceProviderSupported: boolean;
+  configured?: boolean | null;
+  setupLink?: string;
   credentialHealth?: BrainCredentialHealth;
   providerHealth?: BrainProviderHealth;
+  rawProviderApi?: {
+    available: boolean;
+    actionNames: string[];
+    docsUrls: string[];
+    specUrls: string[];
+    auth: string | null;
+    examples: unknown[];
+  };
   workspaceConnection?: BrainWorkspaceConnectionSummary;
 }
 

package/corpus/templates/brain/app/routes/sources.tsx

@@ -1115,6 +1115,14 @@ function ProviderCatalog({
             const readinessCallout = providerReadinessCallout(provider, t);
             const ReadinessIcon = readinessCallout.icon;
             const readinessItems = providerReadinessItems(provider, t);
+            const providerNeedsSetup =
+              provider.configured !== true &&
+              provider.rawProviderApi?.available === true &&
+              (provider.providerHealth?.status === "needs_grant" ||
+                provider.providerHealth?.status === "unhealthy" ||
+                provider.providerHealth?.status === "missing_credentials");
+            const providerSetupHref =
+              provider.setupLink ?? dispatchIntegrationsHref(provider.id);
             return (
               <div
                 key={provider.id}
@@ -1378,7 +1386,8 @@ function ProviderCatalog({
                         {t("sources.noSharedWorkspaceConnection")}
                       </p>
                     )}
-                    {!provider.sourceProviderSupported ? (
+                    {!provider.sourceProviderSupported &&
+                    provider.rawProviderApi?.available !== true ? (
                       <p className="text-xs leading-5 text-muted-foreground">
                         {t("sources.connectionMetadataOnlyDetail")}
                       </p>
@@ -1400,11 +1409,13 @@ function ProviderCatalog({
                     <IconSettings2 className="size-4" />
                     {expanded ? t("sources.hideDetails") : t("sources.details")}
                   </Button>
-                  {grantState === "needs_grant" ? (
+                  {grantState === "needs_grant" || providerNeedsSetup ? (
                     <Button size="sm" variant="outline" asChild>
-                      <a href={dispatchIntegrationsHref(provider.id)}>
+                      <a href={providerSetupHref}>
                         <IconExternalLink className="size-4" />
-                        {t("sources.grantInDispatch")}
+                        {grantState === "needs_grant"
+                          ? t("sources.grantInDispatch")
+                          : t("sources.connectProvider")}
                       </a>
                     </Button>
                   ) : null}

package/corpus/templates/brain/changelog/2026-07-29-brain-automatically-retries-failed-source-syncs-and-guides-y.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-29
+---
+
+Brain automatically retries failed source syncs, drains search indexing backlogs faster, and guides you to connect provider APIs when setup is missing.

package/corpus/templates/brain/jobs/process-ingest-queue.ts

@@ -30,6 +30,7 @@ export type DistillationAgentRunner = (
 export interface ProcessBrainIngestQueueOptions {
   limit?: number;
   runDistillation?: boolean;
+  maxDistillations?: number;
   distillationRunner?: DistillationAgentRunner;
 }
 
@@ -331,9 +332,20 @@ export async function processBrainIngestQueueOnce(
     const processed: string[] = [];
     const deferred: string[] = [];
     const failed: string[] = [];
+    const maxDistillations = Math.max(
+      0,
+      Math.floor(options.maxDistillations ?? Number.POSITIVE_INFINITY),
+    );
+    let distillationsStarted = 0;
     for (const row of rows) {
       const payload = parseJson<Record<string, unknown>>(row.payloadJson, {});
       if (row.operation === "distill") {
+        if (
+          options.runDistillation &&
+          distillationsStarted >= maxDistillations
+        ) {
+          continue;
+        }
         if (!options.runDistillation) {
           const claimToken = await claimForHeadlessRunner(row, payload);
           if (!claimToken) continue;
@@ -367,6 +379,7 @@ export async function processBrainIngestQueueOnce(
         };
         const claimToken = await claimForHeadlessRunner(row, nextPayload);
         if (!claimToken) continue;
+        distillationsStarted += 1;
 
         try {
           const runner =

package/corpus/templates/brain/server/jobs/sync-sources.ts

@@ -1,10 +1,10 @@
 import { runWithRequestContext } from "@agent-native/core/server/request-context";
 import { accessFilter } from "@agent-native/core/sharing";
-import { and, eq, ne } from "drizzle-orm";
+import { and, inArray, ne } from "drizzle-orm";
 
 import type { BrainSourceProvider } from "../../shared/types.js";
 import { getDb, schema } from "../db/index.js";
-import { nowIso, parseJson } from "../lib/brain.js";
+import { parseJson } from "../lib/brain.js";
 import { runConnectorSync } from "../lib/connectors.js";
 
 const DEFAULT_POLL_MINUTES = 60;
@@ -13,6 +13,7 @@ let skippingLogged = false;
 let running = false;
 
 type SourceRow = typeof schema.brainSources.$inferSelect;
+const RETRYABLE_SOURCE_STATUSES: SourceRow["status"][] = ["active", "error"];
 
 function configuredPollMinutes(source: SourceRow): number {
   const config = parseJson<Record<string, unknown>>(source.configJson, {});
@@ -56,30 +57,34 @@ function retryAfterAt(source: SourceRow): number | null {
   return Number.isFinite(retryAt) ? retryAt : null;
 }
 
+function sourceSyncDueAt(source: SourceRow, nowMs: number): number | null {
+  if (!RETRYABLE_SOURCE_STATUSES.includes(source.status)) return null;
+  if (!isAutoSyncEnabled(source)) return null;
+
+  const pollIntervalMs = configuredPollMinutes(source) * 60 * 1000;
+  let pollAt = nowMs;
+  if (source.status === "error") {
+    const failedAt = Date.parse(source.updatedAt);
+    if (Number.isFinite(failedAt)) pollAt = failedAt + pollIntervalMs;
+  } else if (source.lastSyncedAt) {
+    const lastSynced = Date.parse(source.lastSyncedAt);
+    if (Number.isFinite(lastSynced)) pollAt = lastSynced + pollIntervalMs;
+  }
+
+  return Math.max(pollAt, retryAfterAt(source) ?? Number.NEGATIVE_INFINITY);
+}
+
 export function isBrainSourceDue(
   source: SourceRow,
   nowMs = Date.now(),
 ): boolean {
-  if (source.status !== "active") return false;
-  if (!isAutoSyncEnabled(source)) return false;
-  const retryAt = retryAfterAt(source);
-  if (retryAt && retryAt > nowMs) return false;
-  if (!source.lastSyncedAt) return true;
-  const lastSynced = Date.parse(source.lastSyncedAt);
-  if (!Number.isFinite(lastSynced)) return true;
-  return nowMs - lastSynced >= configuredPollMinutes(source) * 60 * 1000;
+  const dueAt = sourceSyncDueAt(source, nowMs);
+  return dueAt !== null && dueAt <= nowMs;
 }
 
 export function nextBrainSourceSyncAt(source: SourceRow): string | null {
-  if (source.status !== "active" || !isAutoSyncEnabled(source)) return null;
-  const retryAt = retryAfterAt(source);
-  if (retryAt) return new Date(retryAt).toISOString();
-  if (!source.lastSyncedAt) return nowIso();
-  const lastSynced = Date.parse(source.lastSyncedAt);
-  if (!Number.isFinite(lastSynced)) return nowIso();
-  return new Date(
-    lastSynced + configuredPollMinutes(source) * 60 * 1000,
-  ).toISOString();
+  const dueAt = sourceSyncDueAt(source, Date.now());
+  return dueAt === null ? null : new Date(dueAt).toISOString();
 }
 
 export async function listDueBrainSources(
@@ -90,15 +95,15 @@ export async function listDueBrainSources(
 ) {
   const db = getDb();
   const where = options.system
-    ? // guard:allow-unscoped — system scheduler enumerates active sources,
+    ? // guard:allow-unscoped — system scheduler enumerates retryable sources,
       // then re-enters each row's owner/org context before syncing.
       and(
-        eq(schema.brainSources.status, "active"),
+        inArray(schema.brainSources.status, RETRYABLE_SOURCE_STATUSES),
         ne(schema.brainSources.provider, "manual"),
       )
     : and(
         accessFilter(schema.brainSources, schema.brainSourceShares),
-        eq(schema.brainSources.status, "active"),
+        inArray(schema.brainSources.status, RETRYABLE_SOURCE_STATUSES),
         ne(schema.brainSources.provider, "manual"),
       );
   const rows = await db

package/corpus/templates/brain/server/plugins/agent-chat.ts

@@ -24,6 +24,7 @@ const INITIAL_TOOL_NAMES = [
   "write-knowledge",
   "list-sources",
   "get-source",
+  "list-connection-providers",
   "create-source",
   "sync-source",
   "enqueue-distillation",
@@ -56,7 +57,7 @@ Important rules:
 - Source policy matters: strict means answer from reviewed knowledge only; balanced means raw captures are fallback context when reviewed knowledge is thin; exploratory means raw captures and sources may be surfaced as clearly labeled leads.
 - Company-tier knowledge may create a proposal instead of publishing immediately, depending on settings.
 - Slack and Granola sources are configurable v1 connectors. Generic transcript import is always available.
-- Source/read actions are convenience readers, not provider capability limits. For ad hoc provider analysis that needs an endpoint, filter, payload, pagination mode, or API version not modeled by a Brain action, call provider-api-catalog/provider-api-docs, then provider-api-request against the provider's real HTTP API. Use connectionId for a specific shared grant and accountId for a specific OAuth account.
+- Source/read actions are convenience readers, not provider capability limits. Before any provider API request, call list-connection-providers and inspect the matching provider. If configured is not true, do not attempt the request; explain that the connection needs setup or repair and include setupLink. Jira is queried on demand through the provider API rather than indexed as a Brain source. For ad hoc provider analysis that needs an endpoint, filter, payload, pagination mode, or API version not modeled by a Brain action, call provider-api-catalog/provider-api-docs, then provider-api-request against the provider's real HTTP API. Use connectionId for a specific shared grant and accountId for a specific OAuth account.
 - For broad searches, joins, classification, source-corpus counts, or absence claims across provider records, fetch every relevant page or an explicitly bounded cohort, stage/save large responses with stageAs/saveToFile/fetchAllPages, then use query-staged-dataset or run-code to reduce the corpus. Report source, filters, row counts, pagination, truncation, and gaps.`,
   a2aMessageFallback: async ({ text }) => tryAnswerBrainA2AQuestion(text),
   mentionProviders: async () => {