@agent-native/core 0.95.0 → 0.96.0

package/corpus/templates/analytics/app/global.css

@@ -149,6 +149,16 @@
   background-color: hsl(var(--background)) !important;
 }
 
+.analytics-chat-panel .agent-thread-content {
+  padding-top: 4.5rem;
+}
+
+.analytics-chat-panel
+  [data-agent-page-chat-scrolled]
+  [data-agent-page-chat-fade] {
+  opacity: 1;
+}
+
 @media (max-width: 767px) {
   .analytics-chat-panel [data-agent-page-new-chat] {
     display: none;

package/corpus/templates/analytics/app/lib/data-sources.ts

@@ -748,14 +748,15 @@ export const dataSources: DataSource[] = [
   {
     id: "slack",
     name: "Slack",
-    description: "Channel messages and workspace search",
+    description:
+      "Channel history and workspace search. Prefer a Slack workspace integration from Settings > Connections; a local bot token remains available as a legacy fallback.",
     category: "communication",
     icon: IconMessage,
     envKeys: ["SLACK_BOT_TOKEN"],
     docsUrl: "https://api.slack.com/methods",
     walkthroughSteps: [
       {
-        title: "Create a Slack App",
+        title: "Create a Slack App for local fallback access",
         description:
           "Go to api.slack.com/apps, create a new app, and add OAuth scopes: channels:read, channels:history, search:read.",
         url: "https://api.slack.com/apps",
@@ -767,10 +768,10 @@ export const dataSources: DataSource[] = [
           'Under "OAuth & Permissions", install the app and copy the Bot User OAuth Token.',
       },
       {
-        title: "Enter your Bot Token",
+        title: "Enter your local fallback Bot Token",
         description: 'Paste the Bot User OAuth Token (starts with "xoxb-").',
         inputKey: "SLACK_BOT_TOKEN",
-        inputLabel: "Bot Token",
+        inputLabel: "Bot Token (legacy local fallback)",
         inputPlaceholder: "xoxb-...",
         inputType: "password",
       },

package/corpus/templates/analytics/app/pages/Ask.tsx

@@ -1,5 +1,9 @@
-import { AgentChatSurface, useT } from "@agent-native/core/client";
-import { useState } from "react";
+import {
+  AgentChatSurface,
+  useAgentChatContext,
+  useT,
+} from "@agent-native/core/client";
+import { useEffect, useMemo, useState } from "react";
 
 import {
   ANALYTICS_CHAT_STORAGE_KEY,
@@ -7,9 +11,28 @@ import {
 } from "@/lib/chat-handoff";
 import { TAB_ID } from "@/lib/tab-id";
 
+const DASHBOARD_CONTEXT_KEYS = new Set([
+  "analytics-selected-dashboard",
+  "analytics-selected-dashboard-panel",
+]);
+
 export default function AskPage() {
   const t = useT();
   const [restoreActiveThread] = useState(() => hasRecentAnalyticsChat());
+  const { items: chatContextItems, remove: removeChatContextItem } =
+    useAgentChatContext();
+  const staleDashboardContextKey = useMemo(
+    () =>
+      chatContextItems.find((item) => DASHBOARD_CONTEXT_KEYS.has(item.key))
+        ?.key ?? null,
+    [chatContextItems],
+  );
+
+  useEffect(() => {
+    if (staleDashboardContextKey) {
+      removeChatContextItem(staleDashboardContextKey);
+    }
+  }, [removeChatContextItem, staleDashboardContextKey]);
 
   return (
     <div className="analytics-ask-page flex h-full min-h-0 flex-col bg-background">

package/corpus/templates/analytics/changelog/2026-07-10-analytics-answers-simple-time-bounded-metrics-without-unnece.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-10
+---
+
+Analytics answers simple time-bounded metrics without unnecessary follow-up queries.

package/corpus/templates/analytics/changelog/2026-07-10-analytics-chat-reliably-uses-connected-data-sources-across-s.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-10
+---
+
+Analytics chat reliably uses connected data sources across supported models

package/corpus/templates/analytics/changelog/2026-07-10-chat-threads-now-stay-clear-of-top-actions-and-fade-smoothly.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-10
+---
+
+Chat threads now stay clear of top actions and fade smoothly beneath them while scrolling.

package/corpus/templates/analytics/changelog/2026-07-10-context-chips-can-now-be-selected-and-removed-one-at-a-time-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-10
+---
+
+Context chips can now be selected and removed one at a time with Backspace from the start of the Ask composer.

package/corpus/templates/analytics/changelog/2026-07-10-slack-token-setup-marked-legacy.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-10
+---
+
+Slack data-source setup now favors workspace connections and identifies raw bot tokens as a legacy local fallback.

package/corpus/templates/analytics/changelog/2026-07-10-the-ask-composer-no-longer-carries-dashboard-or-panel-contex.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-10
+---
+
+The Ask composer no longer carries dashboard or panel context after leaving a dashboard.

package/corpus/templates/analytics/changelog/2026-07-10-the-ask-section-stays-highlighted-while-its-chat-history-is-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-10
+---
+
+The Ask section stays highlighted while its chat history is expanded.

package/corpus/templates/analytics/server/lib/bigquery.ts

@@ -241,6 +241,15 @@ export interface QueryResult {
   cached?: boolean;
 }
 
+export interface RunQueryOptions {
+  /**
+   * The current agent run's abort signal. This cancels in-flight BigQuery
+   * requests and, importantly, stops the one-second job polling wait without
+   * starting another request after the parent run has ended.
+   */
+  signal?: AbortSignal;
+}
+
 interface BigQueryField {
   name: string;
   type: string;
@@ -265,6 +274,57 @@ interface BigQueryGetQueryResultsResponse {
   totalBytesProcessed?: string;
 }
 
+function createAbortError(): Error {
+  if (typeof DOMException !== "undefined") {
+    return new DOMException("BigQuery query aborted", "AbortError");
+  }
+  const error = new Error("BigQuery query aborted");
+  error.name = "AbortError";
+  return error;
+}
+
+function throwIfAborted(signal?: AbortSignal): void {
+  if (signal?.aborted) throw createAbortError();
+}
+
+function waitForPollInterval(signal?: AbortSignal): Promise<void> {
+  throwIfAborted(signal);
+  return new Promise((resolve, reject) => {
+    const timeout = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, 1000);
+    const onAbort = () => {
+      clearTimeout(timeout);
+      signal?.removeEventListener("abort", onAbort);
+      reject(createAbortError());
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+
+async function cancelQueryJob(
+  projectId: string,
+  jobId: string,
+  token: string,
+): Promise<void> {
+  try {
+    await fetch(
+      `https://bigquery.googleapis.com/bigquery/v2/projects/${projectId}/jobs/${jobId}/cancel`,
+      {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${token}`,
+          "Content-Type": "application/json",
+        },
+      },
+    );
+  } catch {
+    // The caller is already aborting. Cancellation is best-effort and must not
+    // hide the original abort reason if BigQuery or the network is unavailable.
+  }
+}
+
 /**
  * Convert BigQuery REST API row format to plain objects.
  * BigQuery returns rows as { f: [{ v: value }, ...] } arrays
@@ -361,7 +421,12 @@ export async function dryRunQuery(sql: string): Promise<string | null> {
   return `BigQuery validation failed (${res.status})`;
 }
 
-export async function runQuery(sql: string): Promise<QueryResult> {
+export async function runQuery(
+  sql: string,
+  options: RunQueryOptions = {},
+): Promise<QueryResult> {
+  const { signal } = options;
+  throwIfAborted(signal);
   const { projectId, cacheScope, appEventsTable } = await getProjectInfo();
   const resolvedSql = await resolveTablePlaceholder(
     sql,
@@ -383,8 +448,10 @@ export async function runQuery(sql: string): Promise<QueryResult> {
   const token = await getAccessToken();
   const url = `https://bigquery.googleapis.com/bigquery/v2/projects/${projectId}/queries`;
 
+  throwIfAborted(signal);
   const res = await fetch(url, {
     method: "POST",
+    ...(signal ? { signal } : {}),
     headers: {
       Authorization: `Bearer ${token}`,
       "Content-Type": "application/json",
@@ -409,20 +476,29 @@ export async function runQuery(sql: string): Promise<QueryResult> {
     const resultsUrl = `https://bigquery.googleapis.com/bigquery/v2/projects/${projectId}/queries/${jobId}`;
 
     let attempts = 0;
-    while (!data.jobComplete && attempts < 60) {
-      await new Promise((resolve) => setTimeout(resolve, 1000));
-      const pollRes = await fetch(resultsUrl, {
-        headers: {
-          Authorization: `Bearer ${token}`,
-          "Content-Type": "application/json",
-        },
-      });
-      if (!pollRes.ok) {
-        const text = await pollRes.text();
-        throw new Error(`BigQuery poll error ${pollRes.status}: ${text}`);
+    try {
+      while (!data.jobComplete && attempts < 60) {
+        await waitForPollInterval(signal);
+        throwIfAborted(signal);
+        const pollRes = await fetch(resultsUrl, {
+          ...(signal ? { signal } : {}),
+          headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+          },
+        });
+        if (!pollRes.ok) {
+          const text = await pollRes.text();
+          throw new Error(`BigQuery poll error ${pollRes.status}: ${text}`);
+        }
+        data = (await pollRes.json()) as BigQueryGetQueryResultsResponse;
+        attempts++;
+      }
+    } catch (error) {
+      if (signal?.aborted) {
+        await cancelQueryJob(projectId, jobId, token);
       }
-      data = (await pollRes.json()) as BigQueryGetQueryResultsResponse;
-      attempts++;
+      throw error;
     }
 
     if (!data.jobComplete) {

package/corpus/templates/analytics/server/lib/credential-keys.ts

@@ -107,10 +107,14 @@ export const credentialKeys: CredentialKeyConfig[] = [
     required: false,
   },
   // Slack
-  { key: "SLACK_BOT_TOKEN", label: "Slack Bot Token", required: false },
+  {
+    key: "SLACK_BOT_TOKEN",
+    label: "Slack Bot Token (legacy local fallback)",
+    required: false,
+  },
   {
     key: "SLACK_BOT_TOKEN_2",
-    label: "Slack Bot Token (secondary)",
+    label: "Slack Bot Token (legacy secondary fallback)",
     required: false,
   },
   // Notion

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

@@ -34,6 +34,18 @@ import {
 const DATA_DICT_PREFIX = "data-dict-";
 const ANALYTICS_BACKGROUND_RUN_SOFT_TIMEOUT_MS = 13 * 60_000;
 
+export const SIMPLE_TIME_BOUNDED_METRIC_FAST_PATH_GUIDANCE =
+  "SIMPLE TIME-BOUNDED METRIC FAST PATH — When the data dictionary or a known canonical source identifies the metric, run one bounded aggregate. Once it returns a valid result, answer the explicit question immediately with the source, time window, row count, and only necessary caveats. Do not schema-discover, retry, enrich, cross-check, or add breakdowns after that successful result unless the query failed or the result conflicts with the known metric definition. This does not waive the real-data requirement: never answer from a guess, stale value, or unverified result. ";
+
+export function analyticsSourceGuidanceOpening(): string {
+  return (
+    "<data-source-guidance>\n" +
+    "Apply real-data requirements only when presenting analytics results, source records, or derived metrics. Do not call data-source tools for workflow migration, recurring-job setup, UI/code fixes, settings help, conceptual planning, or other non-data tasks unless the user explicitly asks for data. " +
+    SIMPLE_TIME_BOUNDED_METRIC_FAST_PATH_GUIDANCE +
+    "SURFACE DIFFERENTIATION — You are the analytics assistant for definitions, deep-dive analysis, and action. For questions about what a metric, model, or table means, use the Data Dictionary and configured schema tools first. For trends, comparisons, anomalies, current data, or anything that requires querying live data, answer directly in chat with the relevant provider query, dashboard analysis, and inline charts when useful. "
+  );
+}
+
 export {
   applyAnalyticsPlanModePolicy,
   INITIAL_TOOL_NAMES,
@@ -55,7 +67,61 @@ function latestUserText(
   return "";
 }
 
-function realDataFinalGuard(context: AgentLoopFinalResponseGuardContext) {
+function configuredDataSourceLabels(
+  toolResults: AgentLoopFinalResponseGuardContext["toolResults"],
+): string[] {
+  const labels = new Set<string>();
+  for (const result of toolResults ?? []) {
+    const normalizedName = String(result.name ?? "")
+      .trim()
+      .toLowerCase()
+      .replace(/[\s_]+/g, "-");
+    if (normalizedName !== "data-source-status" || result.isError) continue;
+
+    let parsed: Record<string, unknown>;
+    try {
+      const value = JSON.parse(String(result.content ?? ""));
+      if (!value || typeof value !== "object" || Array.isArray(value)) continue;
+      parsed = value as Record<string, unknown>;
+    } catch {
+      continue;
+    }
+
+    const compactSources = Array.isArray(parsed.configuredDataSources)
+      ? parsed.configuredDataSources
+      : [];
+    for (const source of compactSources) {
+      if (!source || typeof source !== "object" || Array.isArray(source)) {
+        continue;
+      }
+      const record = source as Record<string, unknown>;
+      const label = record.label ?? record.provider;
+      if (typeof label === "string" && label.trim()) labels.add(label.trim());
+    }
+
+    // Backward compatibility for runs against deployments that predate the
+    // compact configuredDataSources summary.
+    const providers = Array.isArray(parsed.providers) ? parsed.providers : [];
+    for (const provider of providers) {
+      if (
+        !provider ||
+        typeof provider !== "object" ||
+        Array.isArray(provider)
+      ) {
+        continue;
+      }
+      const record = provider as Record<string, unknown>;
+      if (record.configured !== true) continue;
+      const label = record.label ?? record.provider;
+      if (typeof label === "string" && label.trim()) labels.add(label.trim());
+    }
+  }
+  return [...labels];
+}
+
+export function realDataFinalGuard(
+  context: AgentLoopFinalResponseGuardContext,
+) {
   if ((context as { executionMode?: string }).executionMode === "plan") {
     return null;
   }
@@ -125,11 +191,22 @@ function realDataFinalGuard(context: AgentLoopFinalResponseGuardContext) {
     };
   }
 
+  const configuredSources = configuredDataSourceLabels(context.toolResults);
+  const configuredSourceGuidance = configuredSources.length
+    ? ` \`data-source-status\` already confirmed these connected sources: ${configuredSources.join(", ")}. Do not claim that no sources are connected and do not ask the user to reconnect them. Immediately call the relevant query action for one of those sources.`
+    : "";
   return {
     retryMessage:
-      "This looks like an analytics result request, but no real source query ran. If you are making data claims, run one relevant data-source action or connected provider MCP tool now and answer from that result. If the right response is a clarification, plan, or explicit unavailable/credentials-missing message with no metrics or source-record claims, finalize that directly instead.",
-    fallbackMessage:
-      "I can't provide a grounded analytics result yet because no real data-source query ran successfully. Tell me which source to use or connect the missing source, and I'll run it before giving numbers or source-record conclusions.",
+      "This looks like an analytics result request, but no real source query ran. If you are making data claims, run one relevant data-source action or connected provider MCP tool now and answer from that result." +
+      configuredSourceGuidance +
+      " If the right response is a clarification, plan, or explicit unavailable/credentials-missing message with no metrics or source-record claims, finalize that directly instead.",
+    fallbackMessage: configuredSources.length
+      ? `I found connected data sources (${configuredSources.join(", ")}), but the model still did not run a real source query. Please retry the request; you do not need to reconnect those sources.`
+      : "I can't provide a grounded analytics result yet because no real data-source query ran successfully. Tell me which source to use or connect the missing source, and I'll run it before giving numbers or source-record conclusions.",
+    // Some models use separate turns for status, schema discovery, and the
+    // actual query. One corrective turn was enough for Sonnet but caused Luna
+    // to hit the fallback before it reached the query.
+    maxRetries: 2,
   };
 }
 
@@ -159,9 +236,7 @@ export default createAgentChatPlugin({
     // The generic template can ship provider actions without every deployment
     // having credentials or workspace-specific schemas configured.
     const sourceGuidance =
-      "<data-source-guidance>\n" +
-      "Apply real-data requirements only when presenting analytics results, source records, or derived metrics. Do not call data-source tools for workflow migration, recurring-job setup, UI/code fixes, settings help, conceptual planning, or other non-data tasks unless the user explicitly asks for data. " +
-      "SURFACE DIFFERENTIATION — You are the analytics assistant for definitions, deep-dive analysis, and action. For questions about what a metric, model, or table means, use the Data Dictionary and configured schema tools first. For trends, comparisons, anomalies, current data, or anything that requires querying live data, answer directly in chat with the relevant provider query, dashboard analysis, and inline charts when useful. " +
+      analyticsSourceGuidanceOpening() +
       "DASHBOARD CREATION RULE — You may create dashboards, analyses, SQL panels, or other resources only when the user explicitly asks you to (e.g. 'build me a dashboard for...', 'create a new analysis', 'add a chart for...'). Never create any resource proactively during research, trend analysis, or answering questions. If you think a dashboard would be useful, suggest it and wait for explicit confirmation before creating anything. Never add new items to the sidebar or modify existing dashboards without an explicit user directive. " +
       "DASHBOARD MUTATION RULE — For dashboard edits, default to `mutate-dashboard` with the typed `dashboard.*` script API so the main payload is a string and avoids native-array serialization traps. It can move panels by id, edit titles/SQL/config, insert, duplicate, remove, and patch dashboard fields in one atomic save. The script API is constrained: no variables/imports/loops/functions, only JSON-compatible arguments on documented dashboard methods. Do not count shifting `/panels/<index>` positions for ordinary dashboard edits unless the user specifically asks for low-level JSON-pointer operations. " +
       "DASHBOARD READ RULE — `get-sql-dashboard` is compact by default: use its `panels` summaries plus `layout.panelOrder`, `layout.firstPanelIds`, and `layout.groups[].rows[].rowNumber/panelIds` for orientation and verification. Pass `includeConfig: true` only when you truly need full panel SQL/config. " +

package/corpus/templates/brain/changelog/2026-07-10-slack-backfill-token-marked-legacy.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-10
+---
+
+Slack backfills now favor workspace connections while clearly marking raw bot tokens as a local fallback.

package/corpus/templates/brain/server/register-secrets.ts

@@ -2,9 +2,9 @@ import { registerRequiredSecret } from "@agent-native/core/secrets";
 
 registerRequiredSecret({
   key: "SLACK_BOT_TOKEN",
-  label: "Slack Bot Token",
+  label: "Slack Bot Token (local fallback)",
   description:
-    "Optional Slack bot token for channel backfills. Brain only scans allow-listed channels and never enumerates DMs.",
+    "Optional local fallback for Brain channel backfills. Prefer a Slack workspace integration in Settings > Connections. Brain only scans allow-listed channels and never enumerates DMs.",
   docsUrl: "https://api.slack.com/authentication/token-types",
   scope: "workspace",
   kind: "api-key",

package/corpus/templates/clips/app/components/library/library-layout.tsx

@@ -154,6 +154,9 @@ export function LibraryLayout({ children }: LibraryLayoutProps) {
   );
   const [headerSlot, setHeaderSlot] = useState<HTMLElement | null>(null);
   const showCollapsedSidebar = sidebarCollapsed && !isMobile;
+  const sidebarHasNewRecordingAction = isMobile
+    ? sidebarOpen
+    : !sidebarCollapsed;
 
   // Routes whose page renders its own h-12 toolbar. Layout still mounts Sidebar
   // + AgentSidebar, but skips its own header so there's no double-header.
@@ -603,7 +606,10 @@ export function LibraryLayout({ children }: LibraryLayoutProps) {
             </div>
           )}
           <main className="agent-native-app-main flex min-h-0 flex-1 flex-col overflow-y-auto">
-            <PageHeaderSlotProvider slot={headerSlot}>
+            <PageHeaderSlotProvider
+              slot={headerSlot}
+              sidebarHasNewRecordingAction={sidebarHasNewRecordingAction}
+            >
               {children}
             </PageHeaderSlotProvider>
           </main>

package/corpus/templates/clips/app/components/library/page-header.tsx

@@ -7,24 +7,40 @@ import {
 } from "react";
 import { createPortal } from "react-dom";
 
-const PageHeaderSlotContext = createContext<HTMLElement | null>(null);
+interface PageHeaderSlotContextValue {
+  slot: HTMLElement | null;
+  sidebarHasNewRecordingAction: boolean;
+}
+
+const PageHeaderSlotContext = createContext<PageHeaderSlotContextValue>({
+  slot: null,
+  sidebarHasNewRecordingAction: false,
+});
 
 export function PageHeaderSlotProvider({
   slot,
+  sidebarHasNewRecordingAction,
   children,
 }: {
   slot: HTMLElement | null;
+  sidebarHasNewRecordingAction: boolean;
   children: ReactNode;
 }) {
   return (
-    <PageHeaderSlotContext.Provider value={slot}>
+    <PageHeaderSlotContext.Provider
+      value={{ slot, sidebarHasNewRecordingAction }}
+    >
       {children}
     </PageHeaderSlotContext.Provider>
   );
 }
 
+export function usePageHeaderLayout() {
+  return useContext(PageHeaderSlotContext);
+}
+
 export function PageHeader({ children }: { children: ReactNode }) {
-  const slot = useContext(PageHeaderSlotContext);
+  const { slot } = usePageHeaderLayout();
   const [ready, setReady] = useState(false);
   useEffect(() => setReady(true), []);
   if (!ready || !slot) return null;

package/corpus/templates/clips/app/routes/_app.library._index.tsx

@@ -4,6 +4,7 @@ import { IconPlayerRecord } from "@tabler/icons-react";
 import { NavLink } from "react-router";
 
 import { LibraryGrid } from "@/components/library/library-grid";
+import { usePageHeaderLayout } from "@/components/library/page-header";
 
 const SEO_TITLE =
   "Agent-Native Clips - Open Source, agent-friendly Loom alternative";
@@ -24,24 +25,27 @@ export function meta() {
 
 export default function LibraryIndexRoute() {
   const t = useT();
+  const { sidebarHasNewRecordingAction } = usePageHeaderLayout();
   return (
     <LibraryGrid
       view="library"
       folderId={null}
       title="Library"
       extraActions={
-        <Button
-          className="gap-1.5 bg-primary text-primary-foreground shadow-sm hover:bg-primary/90"
-          size="sm"
-          asChild
-        >
-          <NavLink to="/record" aria-label={t("navigation.newRecording")}>
-            <IconPlayerRecord className="h-4 w-4" />
-            <span className="hidden sm:inline">
-              {t("navigation.newRecording")}
-            </span>
-          </NavLink>
-        </Button>
+        !sidebarHasNewRecordingAction && (
+          <Button
+            className="gap-1.5 bg-primary text-primary-foreground shadow-sm hover:bg-primary/90"
+            size="sm"
+            asChild
+          >
+            <NavLink to="/record" aria-label={t("navigation.newRecording")}>
+              <IconPlayerRecord className="h-4 w-4" />
+              <span className="hidden sm:inline">
+                {t("navigation.newRecording")}
+              </span>
+            </NavLink>
+          </Button>
+        )
       }
     />
   );

package/corpus/templates/clips/changelog/2026-07-10-new-recording-appears-once-when-the-library-sidebar-is-open.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-10
+---
+
+New recording appears once when the library sidebar is open.

package/corpus/templates/clips/changelog/2026-07-10-slack-token-fallback-guidance.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-10
+---
+
+Slack setup now more clearly separates the legacy unfurl token fallback from workspace connections and messaging automations.

package/corpus/templates/clips/server/register-secrets.ts

@@ -212,7 +212,7 @@ registerRequiredSecret({
   key: "SLACK_BOT_TOKEN",
   label: "Slack Bot Token (legacy)",
   description:
-    "Legacy single-workspace bot token fallback for Clips link unfurls. New installs should use the Slack OAuth connect flow.",
+    "Legacy single-workspace bot token fallback for Clips link unfurls. New installs should use the Clips Slack workspace connection; new messaging automations should connect Slack in Settings > Messaging.",
   docsUrl: "https://api.slack.com/apps",
   scope: "workspace",
   kind: "api-key",