@agent-native/core 0.114.13 → 0.114.15

package/corpus/core/src/client/settings/SettingsPanel.tsx

@@ -2857,7 +2857,7 @@ function SettingsPanelContent({
               />
               <ManualSetupCard
                 hint="Deploy manually to Netlify, Vercel, Cloudflare, or any Nitro-supported target."
-                docsUrl="https://www.builder.io/c/docs/agent-native-deployment"
+                docsUrl="https://www.builder.io/c/docs/agent-native-deployment?utm_source=agent-native&utm_medium=product&utm_campaign=onboarding&utm_content=deployment_settings"
                 dim={connected}
               />
             </div>
@@ -2888,7 +2888,7 @@ function SettingsPanelContent({
               />
               <ManualSetupCard
                 hint="Set DATABASE_URL in your .env to connect Neon, Supabase, Turso, any Postgres/SQLite database, or local PGlite with pglite:./data/pglite."
-                docsUrl="https://www.builder.io/c/docs/agent-native-database"
+                docsUrl="https://www.builder.io/c/docs/agent-native-database?utm_source=agent-native&utm_medium=product&utm_campaign=onboarding&utm_content=database_settings"
                 dim={connected}
               />
             </div>
@@ -2919,7 +2919,7 @@ function SettingsPanelContent({
               />
               <ManualSetupCard
                 hint="Without a provider, files are stored as base64 in your database. Fine for dev, not recommended for production."
-                docsUrl="https://www.builder.io/c/docs/agent-native-file-uploads"
+                docsUrl="https://www.builder.io/c/docs/agent-native-file-uploads?utm_source=agent-native&utm_medium=product&utm_campaign=onboarding&utm_content=file_upload_settings"
                 dim={connected}
               />
             </div>
@@ -2950,7 +2950,7 @@ function SettingsPanelContent({
               />
               <ManualSetupCard
                 hint="Configure Better Auth with BETTER_AUTH_SECRET and optional Google/GitHub OAuth providers."
-                docsUrl="https://www.builder.io/c/docs/agent-native-authentication"
+                docsUrl="https://www.builder.io/c/docs/agent-native-authentication?utm_source=agent-native&utm_medium=product&utm_campaign=onboarding&utm_content=authentication_settings"
                 dim={connected}
               />
             </div>

package/corpus/core/src/client/settings/useBuilderStatus.ts

@@ -1,5 +1,6 @@
 import { useState, useEffect, useCallback, useRef } from "react";
 
+import { applyBuilderUtmTrackingParams } from "../../shared/builder-link-tracking.js";
 import { trackEvent } from "../analytics.js";
 import { agentNativePath } from "../api-path.js";
 import { getCallbackOrigin } from "../frame.js";
@@ -343,6 +344,8 @@ export function withBuilderConnectTrackingParams(
       parsed.searchParams.set("redirect_url", parsedRedirect.toString());
     }
 
+    applyBuilderUtmTrackingParams(parsed.searchParams, { content: source });
+
     return parsed.toString();
   } catch {
     return url;

package/corpus/core/src/localization/default-messages.ts

@@ -725,9 +725,6 @@ const messages = {
     chatIntegrations: "Chat Integrations",
     chatIntegrationsDescription: "Talk to this agent from other platforms",
     addIntegration: "Add integration",
-    addSomething: "Add something not listed",
-    addSomethingTitle: "Add another integration",
-    addSomethingPlaceholder: "Which integration should we add?",
     dispatchEntrypoint:
       "For a central Slack or Telegram entrypoint that can route work across multiple apps, use the",
     sharedMessaging:
@@ -737,12 +734,9 @@ const messages = {
     menuLabel: "Integrations",
     menuDescription: "Connect MCP tools to the agent",
     title: "Connect integrations",
-    description: "Choose a default MCP integration or add a custom server.",
+    description: "Browse {{count}} MCP integrations or add a custom server.",
     searchPlaceholder: "Search integrations",
     addYourOwn: "Add your own",
-    addSomething: "Add something not listed",
-    addSomethingTitle: "Add another integration",
-    addSomethingPlaceholder: "Which MCP or provider should we add?",
     noMatches: "No integrations match that search.",
     connected: "Connected",
     configure: "Configure",

package/corpus/core/src/server/builder-browser.ts

@@ -8,6 +8,7 @@ import {
 import type { H3Event } from "h3";
 import { getHeader } from "h3";
 
+import { applyBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
 import {
   getAuthSecret,
   resolveSignupTrackingIdentity,
@@ -920,6 +921,9 @@ export function buildBuilderCliAuthUrl(
   );
   url.searchParams.set("framework", "agent-native");
   applyBuilderConnectTrackingParams(url.searchParams, tracking);
+  applyBuilderUtmTrackingParams(url.searchParams, {
+    content: cleanTrackingParam(tracking.agentNativeConnectSource) ?? null,
+  });
   return url.toString();
 }
 

package/corpus/core/src/server/builder-design-systems.ts

@@ -1,3 +1,4 @@
+import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
 import { FeatureNotConfiguredError } from "./credential-provider.js";
 import {
   getBuilderProxyOrigin,
@@ -356,11 +357,15 @@ function nonEmptyFiles(
 
 export function builderDesignSystemUrl(designSystemId?: string | null): string {
   const host = trimTrailingSlash(getBuilderAppHost());
-  return designSystemId
+  const url = designSystemId
     ? `${host}/app/design-system-intelligence/${encodeURIComponent(
         designSystemId,
       )}`
     : `${host}/app/design-system-intelligence`;
+  return withBuilderUtmTrackingParams(url, {
+    campaign: "product",
+    content: "design_system_intelligence",
+  });
 }
 
 export function localBuilderDesignSystemId(

package/corpus/core/src/server/fusion-app.ts

@@ -24,6 +24,7 @@
  * respond with newline-delimited JSON over chunked HTTP.
  */
 
+import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
 import { getBuilderApiHost, getBuilderAppHost } from "./builder-browser.js";
 
 export interface FusionBranchRef {
@@ -86,7 +87,10 @@ function fusionUrl(
 /** The Builder visual-editor URL for a fusion branch. */
 export function getFusionBranchEditorUrl(ref: FusionBranchRef): string {
   const host = getBuilderAppHost().replace(/\/+$/, "");
-  return `${host}/app/projects/${encodeURIComponent(ref.projectId)}/${encodeURIComponent(ref.branchName)}`;
+  return withBuilderUtmTrackingParams(
+    `${host}/app/projects/${encodeURIComponent(ref.projectId)}/${encodeURIComponent(ref.branchName)}`,
+    { campaign: "product", content: "fusion_editor" },
+  );
 }
 
 /** Public URL for a reserved fusion hosting slug. */

package/corpus/core/src/shared/builder-link-tracking.ts

@@ -0,0 +1,41 @@
+export const BUILDER_UTM_SOURCE = "agent-native";
+export const BUILDER_UTM_MEDIUM = "product";
+export const BUILDER_UTM_CAMPAIGN = "onboarding";
+
+export function applyBuilderUtmTrackingParams(
+  params: URLSearchParams,
+  options: {
+    medium?: string;
+    campaign?: string;
+    content?: string | null;
+  } = {},
+): void {
+  params.set("utm_source", BUILDER_UTM_SOURCE);
+  params.set("utm_medium", options.medium ?? BUILDER_UTM_MEDIUM);
+  params.set("utm_campaign", options.campaign ?? BUILDER_UTM_CAMPAIGN);
+  if (options.content) params.set("utm_content", options.content);
+}
+
+export function withBuilderUtmTrackingParams(
+  url: string,
+  options: {
+    medium?: string;
+    campaign?: string;
+    content?: string | null;
+  } = {},
+): string {
+  let parsed: URL;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return url;
+  }
+  if (
+    parsed.hostname !== "builder.io" &&
+    parsed.hostname !== "www.builder.io"
+  ) {
+    return url;
+  }
+  applyBuilderUtmTrackingParams(parsed.searchParams, options);
+  return parsed.toString();
+}

package/corpus/core/src/shared/index.ts

@@ -7,6 +7,7 @@ export {
 export { agentEnv, type EnvVar } from "./agent-env.js";
 export { extractOAuthStateAppId } from "./oauth-state.js";
 export { truncate } from "./truncate.js";
+export { withBuilderUtmTrackingParams } from "./builder-link-tracking.js";
 export {
   llmConnectionTrackingProperties,
   normalizeLlmConnection,

package/corpus/templates/analytics/AGENTS.md

@@ -230,7 +230,16 @@ membership id when its native update status reports `update-available`.
   filters; do not hand-wire custom email routes around that action surface.
   Report PNGs are Playwright captures of the real dashboard route in
   `reportScreenshot=1` mode, authenticated by a short-lived embed-session token
-  and embedded inline in email with a CID image. Netlify builds emit a scheduled
+  and embedded inline in email as ordered CID images. Complete dashboards are
+  captured sequentially in bounded panel windows; every window must match the
+  panel ids snapshotted at the start, and a failed or mismatched window
+  invalidates the entire image set so the scheduler can retry instead of
+  sending a partial report. Capture is capped at 10 windows and 14 MiB of raw
+  PNG data, and subscriptions are capped at five distinct recipients; use a
+  mailing-list address for larger audiences. The serverless capture deadline
+  reserves 90 seconds of the 300-second worker budget for cleanup and delivery.
+  The ten-minute retry delay is an eligibility floor; the \*/15 sweep runs the
+  retry on its first tick after that floor. Netlify builds emit a scheduled
   trigger plus a background worker from
   `scripts/emit-netlify-dashboard-report-cron.ts`, using a per-deploy internal
   token and disabling the in-process interval scheduler on Netlify to avoid

package/corpus/templates/analytics/actions/save-dashboard-report-subscription.ts

@@ -5,7 +5,10 @@ import {
 } from "@agent-native/core/server";
 import { z } from "zod";
 
-import { saveDashboardReportSubscription } from "../server/lib/dashboard-report-subscriptions";
+import {
+  MAX_DASHBOARD_REPORT_RECIPIENTS,
+  saveDashboardReportSubscription,
+} from "../server/lib/dashboard-report-subscriptions";
 
 export default defineAction({
   description:
@@ -14,7 +17,12 @@ export default defineAction({
     id: z.string().optional().describe("Existing subscription ID to update"),
     dashboardId: z.string().describe("Dashboard ID to email"),
     name: z.string().optional().describe("Human-readable subscription name"),
-    recipients: z.array(z.string().email()).min(1).describe("Email recipients"),
+    recipients: z
+      .array(z.string().email())
+      .min(1)
+      .describe(
+        `Email recipients (maximum ${MAX_DASHBOARD_REPORT_RECIPIENTS}; use a mailing-list address for larger audiences)`,
+      ),
     filters: z
       .record(z.string(), z.string())
       .optional()

package/corpus/templates/analytics/app/components/dashboard/SqlChart.tsx

@@ -87,7 +87,7 @@ const DEFAULT_COLORS = [
 ];
 
 const CHART_TOOLTIP_WRAPPER_STYLE: CSSProperties = {
-  zIndex: 9999,
+  zIndex: 280,
   pointerEvents: "none",
 };
 
@@ -117,6 +117,7 @@ const CHART_LEGEND_PROPS = {
 } as const;
 
 const CHART_RESIZE_DEBOUNCE_MS = 50;
+const LEGEND_ACTION_CLOSE_DELAY_MS = 600;
 
 type ChartSize = {
   width: number;
@@ -586,7 +587,7 @@ export function SeriesLegend({
     closeTimeoutRef.current = setTimeout(() => {
       setOpenKey(null);
       closeTimeoutRef.current = null;
-    }, 200);
+    }, LEGEND_ACTION_CLOSE_DELAY_MS);
   }, [clearCloseTimeout]);
 
   useEffect(() => () => clearCloseTimeout(), [clearCloseTimeout]);
@@ -674,7 +675,7 @@ export function SeriesLegend({
                 <PopoverContent
                   side="top"
                   align="center"
-                  sideOffset={8}
+                  sideOffset={0}
                   collisionPadding={12}
                   className="w-auto max-w-[calc(100vw-1.5rem)] rounded-lg p-1 shadow-lg"
                   onPointerEnter={clearCloseTimeout}
@@ -943,7 +944,7 @@ export function ChartTooltip({
     <div
       ref={boxRef}
       role="tooltip"
-      className="fixed z-[9999] min-w-40 max-w-[280px] rounded-md border border-border bg-card px-3 py-2 text-xs text-foreground shadow-lg pointer-events-none"
+      className="fixed z-[280] min-w-40 max-w-[280px] rounded-md border border-border bg-card px-3 py-2 text-xs text-foreground shadow-lg pointer-events-none"
     >
       {labelText && (
         <div className="mb-1.5 truncate font-medium text-foreground">

package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/index.tsx

@@ -148,6 +148,11 @@ import { dashboardExtensionSlotId } from "./extension-slot";
 import { interpolate } from "./interpolate";
 import { serializePanelSql } from "./panel-sql";
 import { AddPanelPopover, PanelEditorDialog } from "./PanelEditorDialog";
+import {
+  listReportablePanelIds,
+  parseReportPanelWindow,
+  windowReportPanels,
+} from "./report-panel-window";
 import { SqlChartCard } from "./SqlChartCard";
 import {
   clampDashboardColumns,
@@ -188,31 +193,6 @@ function groupDashboardTabs(tabs: string[]): {
   return { groups, hasNestedTabs };
 }
 
-function parseReportPanelLimit(raw: string | null): number | null {
-  if (!raw) return null;
-  const parsed = Number.parseInt(raw, 10);
-  if (!Number.isFinite(parsed) || parsed <= 0) return null;
-  return Math.min(50, parsed);
-}
-
-function limitReportPanels(panels: SqlPanel[], limit: number | null) {
-  if (!limit) return panels;
-  const limited: SqlPanel[] = [];
-  let chartCount = 0;
-
-  for (const panel of panels) {
-    if (panel.chartType === "section") {
-      if (chartCount < limit) limited.push(panel);
-      continue;
-    }
-    if (chartCount >= limit) continue;
-    chartCount++;
-    limited.push(panel);
-  }
-
-  return limited;
-}
-
 function DashboardDropLine({
   slot,
   activeSlot,
@@ -504,8 +484,11 @@ export default function SqlDashboardPage() {
   const dashboardId = searchParams.get("id") || routeId;
   const reportScreenshot = searchParams.get("reportScreenshot") === "1";
   const reportSettingsRequested = searchParams.get("reportSettings") === "1";
-  const reportPanelLimit = reportScreenshot
-    ? parseReportPanelLimit(searchParams.get("reportPanelLimit"))
+  const reportPanelWindow = reportScreenshot
+    ? parseReportPanelWindow(
+        searchParams.get("reportPanelOffset"),
+        searchParams.get("reportPanelLimit"),
+      )
     : null;
 
   const [dashboard, setDashboard] = useState<SqlDashboardConfig | null>(null);
@@ -1180,9 +1163,9 @@ export default function SqlDashboardPage() {
         ? requestedTab
         : tabs[0]
       : null;
-  // Report captures need the complete dashboard in one image. The report
-  // URL intentionally has no `tab` parameter, so do not apply the normal
-  // first-tab selection while rendering the screenshot surface.
+  // Report captures cover the complete dashboard across ordered windows. The
+  // report URL intentionally has no `tab` parameter, so do not apply the
+  // normal first-tab selection while rendering the screenshot surface.
   const activeTab = reportScreenshot ? null : selectedTab;
   const groupedTabs = useMemo(() => groupDashboardTabs(tabs), [tabs]);
   const activeTabGroup = activeTab
@@ -1221,8 +1204,8 @@ export default function SqlDashboardPage() {
     const tabPanels = activeTab
       ? dashboard.panels.filter((p) => !p.tab || p.tab === activeTab)
       : dashboard.panels;
-    return limitReportPanels(tabPanels, reportPanelLimit);
-  }, [dashboard, activeTab, reportPanelLimit]);
+    return windowReportPanels(tabPanels, reportPanelWindow);
+  }, [dashboard, activeTab, reportPanelWindow]);
 
   // Group panels into "section blocks": each section starts a new block whose
   // grid uses the section's `columns` (falling back to the dashboard default).
@@ -1713,6 +1696,11 @@ export default function SqlDashboardPage() {
       className="space-y-4"
       data-dashboard-report-capture
       data-dashboard-report-ready={loaded && dashboard ? "true" : "false"}
+      data-dashboard-report-panel-ids={
+        reportScreenshot
+          ? JSON.stringify(listReportablePanelIds(visiblePanels))
+          : undefined
+      }
     >
       {hiddenAt ? (
         <div className="flex flex-wrap items-center gap-3 rounded-md border border-amber-200 bg-amber-50 px-3 py-2 text-sm text-amber-900 dark:border-amber-900/70 dark:bg-amber-950/40 dark:text-amber-200">

package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/report-panel-window.ts

@@ -0,0 +1,62 @@
+import type { SqlPanel } from "./types";
+
+export const REPORT_PANEL_CHUNK_SIZE = 8;
+
+export function listReportablePanelIds(panels: SqlPanel[]): string[] {
+  return panels
+    .filter((panel) => panel.chartType !== "section")
+    .map((panel) => panel.id);
+}
+
+export function parseReportPanelWindow(
+  offsetRaw: string | null,
+  limitRaw: string | null,
+): { offset: number; limit: number } | null {
+  if (!offsetRaw || !limitRaw) return null;
+  const offset = Number.parseInt(offsetRaw, 10);
+  const limit = Number.parseInt(limitRaw, 10);
+  if (!Number.isFinite(offset) || offset < 0) return null;
+  if (!Number.isFinite(limit) || limit <= 0) return null;
+  return { offset, limit: Math.min(REPORT_PANEL_CHUNK_SIZE, limit) };
+}
+
+export function countReportablePanels(panels: SqlPanel[]): number {
+  return listReportablePanelIds(panels).length;
+}
+
+/**
+ * A report chunk is indexed by chart panels, not section headers. When a
+ * chunk starts inside a section, repeat that section header so each image is
+ * readable on its own while preserving the dashboard's panel order.
+ */
+export function windowReportPanels(
+  panels: SqlPanel[],
+  window: { offset: number; limit: number } | null,
+): SqlPanel[] {
+  if (!window) return panels;
+
+  const end = window.offset + window.limit;
+  let chartIndex = 0;
+  let activeSection: SqlPanel | null = null;
+  let includedFirstChart = false;
+  const selected: SqlPanel[] = [];
+
+  for (const panel of panels) {
+    if (panel.chartType === "section") {
+      activeSection = panel;
+      if (includedFirstChart && chartIndex < end) selected.push(panel);
+      continue;
+    }
+
+    const include = chartIndex >= window.offset && chartIndex < end;
+    if (include) {
+      if (!includedFirstChart && activeSection) selected.push(activeSection);
+      selected.push(panel);
+      includedFirstChart = true;
+    }
+    chartIndex++;
+    if (chartIndex >= end) break;
+  }
+
+  return selected;
+}

package/corpus/templates/analytics/changelog/2026-07-21-chart-series-controls-stay-open-while-moving-from-the-legend.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-21
+---
+
+Chart series controls stay open while moving from the legend

package/corpus/templates/analytics/changelog/2026-07-21-dashboard-email-captures-complete-large-dashboards-in-chunks.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-21
+---
+
+Daily dashboard emails now include every panel reliably, even for large dashboards.

package/corpus/templates/analytics/seeds/dashboards/agent-native-templates-first-party.json

@@ -480,7 +480,7 @@
       "chartType": "area",
       "source": "first-party",
       "width": 2,
-      "sql": "WITH all_users AS (SELECT NULLIF(user_key, '') AS user_key, event_date, user_id, COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown') AS template FROM analytics_events WHERE event_name = 'session status' AND signed_in = 'true' AND NULLIF(user_key, '') IS NOT NULL AND lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) <> 'docs' AND ('{{emailFilter}}' IN ('', 'all') OR ('{{emailFilter}}' = 'exclude_builder' AND lower(coalesce(user_id, '')) NOT LIKE '%@builder.io') OR ('{{emailFilter}}' = 'only_builder' AND lower(coalesce(user_id, '')) LIKE '%@builder.io'))), first_seen AS (SELECT user_key, MIN(event_date) AS first_date FROM all_users GROUP BY user_key) SELECT a.event_date AS date, a.template AS template, COUNT(DISTINCT a.user_key) AS users FROM all_users a JOIN first_seen f ON f.user_key = a.user_key WHERE a.event_date <> f.first_date AND a.template <> 'unknown' AND (a.event_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD')))) GROUP BY 1, 2 ORDER BY date, template",
+      "sql": "WITH all_users AS (SELECT NULLIF(user_key, '') AS user_key, event_date, user_id, COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown') AS template FROM analytics_events WHERE event_name = 'session status' AND signed_in = 'true' AND NULLIF(user_key, '') IS NOT NULL AND lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) <> 'docs' AND ('{{emailFilter}}' IN ('', 'all') OR ('{{emailFilter}}' = 'exclude_builder' AND lower(coalesce(user_id, '')) NOT LIKE '%@builder.io') OR ('{{emailFilter}}' = 'only_builder' AND lower(coalesce(user_id, '')) LIKE '%@builder.io')) AND event_date >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD')), first_seen AS (SELECT user_key, MIN(event_date) AS first_date FROM all_users GROUP BY user_key) SELECT a.event_date AS date, a.template AS template, COUNT(DISTINCT a.user_key) AS users FROM all_users a JOIN first_seen f ON f.user_key = a.user_key WHERE a.event_date <> f.first_date AND a.template <> 'unknown' AND (a.event_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD')))) GROUP BY 1, 2 ORDER BY date, template",
       "config": {
         "xKey": "date",
         "yKey": "users",
@@ -491,7 +491,7 @@
           "valueKey": "users"
         },
         "stacked": true,
-        "description": "Daily signed-in visitors who are NOT on their all-time first active day (Recurring only), stacked by inferred template/app used that day. Docs traffic and unknown template are excluded."
+        "description": "Daily signed-in visitors who are not on their first active day observed in the previous 365 days, stacked by inferred template/app used that day. Docs traffic and unknown template are excluded."
       }
     },
     {
@@ -500,7 +500,7 @@
       "chartType": "bar",
       "source": "first-party",
       "width": 1,
-      "sql": "WITH all_users AS (SELECT NULLIF(user_key, '') AS user_key, event_date, user_id, COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown') AS template FROM analytics_events WHERE event_name = 'session status' AND signed_in = 'true' AND NULLIF(user_key, '') IS NOT NULL AND lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) <> 'docs' AND ('{{emailFilter}}' IN ('', 'all') OR ('{{emailFilter}}' = 'exclude_builder' AND lower(coalesce(user_id, '')) NOT LIKE '%@builder.io') OR ('{{emailFilter}}' = 'only_builder' AND lower(coalesce(user_id, '')) LIKE '%@builder.io'))), first_seen AS (SELECT user_key, MIN(event_date) AS first_date FROM all_users GROUP BY user_key) SELECT to_char(date_trunc('week', a.event_date::date), 'YYYY-MM-DD') AS date, a.template AS template, COUNT(DISTINCT a.user_key) AS users FROM all_users a JOIN first_seen f ON f.user_key = a.user_key WHERE a.event_date <> f.first_date AND a.template <> 'unknown' AND (a.event_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD')))) GROUP BY 1, 2 ORDER BY date, template",
+      "sql": "WITH all_users AS (SELECT NULLIF(user_key, '') AS user_key, event_date, user_id, COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown') AS template FROM analytics_events WHERE event_name = 'session status' AND signed_in = 'true' AND NULLIF(user_key, '') IS NOT NULL AND lower(COALESCE(NULLIF(template, ''), NULLIF(properties::jsonb ->> 'templateId', ''), NULLIF(properties::jsonb ->> 'agent_native_template', ''), NULLIF(properties::jsonb ->> 'agentNativeTemplate', ''), NULLIF(app, ''), NULLIF(properties::jsonb ->> 'agent_native_app', ''), NULLIF(properties::jsonb ->> 'agentNativeApp', ''), 'unknown')) <> 'docs' AND ('{{emailFilter}}' IN ('', 'all') OR ('{{emailFilter}}' = 'exclude_builder' AND lower(coalesce(user_id, '')) NOT LIKE '%@builder.io') OR ('{{emailFilter}}' = 'only_builder' AND lower(coalesce(user_id, '')) LIKE '%@builder.io')) AND event_date >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD')), first_seen AS (SELECT user_key, MIN(event_date) AS first_date FROM all_users GROUP BY user_key) SELECT to_char(date_trunc('week', a.event_date::date), 'YYYY-MM-DD') AS date, a.template AS template, COUNT(DISTINCT a.user_key) AS users FROM all_users a JOIN first_seen f ON f.user_key = a.user_key WHERE a.event_date <> f.first_date AND a.template <> 'unknown' AND (a.event_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND a.event_date >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD')))) GROUP BY 1, 2 ORDER BY date, template",
       "config": {
         "xKey": "date",
         "yKey": "users",
@@ -511,7 +511,7 @@
           "valueKey": "users"
         },
         "stacked": true,
-        "description": "Weekly distinct signed-in visitors who are NOT on their all-time first active day (Recurring only), stacked by inferred template/app used that week. Weeks start Monday; docs traffic and unknown template are excluded."
+        "description": "Weekly distinct signed-in visitors who are not on their first active day observed in the previous 365 days, stacked by inferred template/app used that week. Weeks start Monday; docs traffic and unknown template are excluded."
       }
     },
     {

package/corpus/templates/analytics/server/jobs/dashboard-report.ts

@@ -51,7 +51,6 @@ export async function runDashboardReportsOnce(): Promise<{
           () =>
             sendDashboardReportSubscription(sub, {
               skipEmailWithoutScreenshot: retryAt !== null,
-              allowLimitedFallback: retryAt === null,
             }),
         );
         if (!result.screenshotAttached) {
@@ -79,13 +78,7 @@ export async function runDashboardReportsOnce(): Promise<{
           await markDashboardReportResult(sub, "error", message);
           continue;
         }
-        if (result.screenshotMode !== "full" && result.screenshotError) {
-          const detail = `sent with ${result.screenshotMode} screenshot; earlier attempts failed: ${result.screenshotError}`;
-          console.warn(`[dashboard-report] Subscription ${sub.id} ${detail}`);
-          await markDashboardReportResult(sub, "success", detail);
-        } else {
-          await markDashboardReportResult(sub, "success");
-        }
+        await markDashboardReportResult(sub, "success");
       } catch (err: any) {
         failed++;
         const message = err?.message ?? String(err);

package/corpus/templates/analytics/server/lib/dashboard-report-subscriptions.ts

@@ -6,6 +6,10 @@ import { and, asc, eq, isNull, lte, or, sql } from "drizzle-orm";
 import { getDb, schema } from "../db/index.js";
 import { loadDashboardSeed } from "./dashboard-seeds";
 import { getDashboard } from "./dashboards-store";
+import {
+  FIRST_PARTY_DASHBOARD_ID,
+  repairFirstPartyRecurringUserPanels,
+} from "./first-party-metric-catalog";
 
 export interface ReportSubscriptionInput {
   id?: string;
@@ -43,6 +47,8 @@ export interface AccessCtx {
   orgId: string | null;
 }
 
+export const MAX_DASHBOARD_REPORT_RECIPIENTS = 5;
+
 export interface ReportDashboard {
   id: string;
   title: string;
@@ -55,10 +61,14 @@ export async function getReportDashboard(
 ): Promise<ReportDashboard | null> {
   const dashboard = await getDashboard(dashboardId, ctx);
   if (dashboard?.kind === "sql") {
+    const config =
+      dashboardId === FIRST_PARTY_DASHBOARD_ID
+        ? repairFirstPartyRecurringUserPanels(dashboard.config).config
+        : dashboard.config;
     return {
       id: dashboard.id,
       title: dashboard.title,
-      config: dashboard.config,
+      config,
     };
   }
 
@@ -78,6 +88,19 @@ function nowIso(): string {
   return new Date().toISOString();
 }
 
+const DASHBOARD_REPORT_ERROR_MAX_LENGTH = 2_000;
+const DASHBOARD_REPORT_ERROR_OMISSION = "\n… [truncated] …\n";
+
+export function truncateDashboardReportError(error: string): string {
+  if (error.length <= DASHBOARD_REPORT_ERROR_MAX_LENGTH) return error;
+
+  const retainedLength =
+    DASHBOARD_REPORT_ERROR_MAX_LENGTH - DASHBOARD_REPORT_ERROR_OMISSION.length;
+  const prefixLength = Math.ceil(retainedLength / 2);
+  const suffixLength = Math.floor(retainedLength / 2);
+  return `${error.slice(0, prefixLength)}${DASHBOARD_REPORT_ERROR_OMISSION}${error.slice(-suffixLength)}`;
+}
+
 function safeJsonParse<T>(raw: unknown, fallback: T): T {
   if (typeof raw !== "string") return fallback;
   try {
@@ -88,7 +111,9 @@ function safeJsonParse<T>(raw: unknown, fallback: T): T {
   }
 }
 
-function normalizeRecipients(recipients: string[]): string[] {
+export function normalizeDashboardReportRecipients(
+  recipients: string[],
+): string[] {
   const seen = new Set<string>();
   const normalized: string[] = [];
   for (const raw of recipients) {
@@ -97,6 +122,14 @@ function normalizeRecipients(recipients: string[]): string[] {
     seen.add(email);
     normalized.push(email);
   }
+  if (normalized.length === 0) {
+    throw new Error("At least one recipient is required");
+  }
+  if (normalized.length > MAX_DASHBOARD_REPORT_RECIPIENTS) {
+    throw new Error(
+      `Dashboard reports support at most ${MAX_DASHBOARD_REPORT_RECIPIENTS} recipients; use a mailing-list address for larger audiences`,
+    );
+  }
   return normalized;
 }
 
@@ -239,6 +272,8 @@ export function lastDailyRunAt(
 }
 
 const DASHBOARD_REPORT_RETRY_WINDOW_MS = 60 * 60 * 1000;
+// This is the earliest nextRunAt. The generated */15 cron means the actual
+// retry occurs on the first sweep after this floor, not exactly ten minutes later.
 const DASHBOARD_REPORT_RETRY_DELAY_MS = 10 * 60 * 1000;
 
 export function dashboardReportRetryAt(
@@ -348,10 +383,7 @@ export async function saveDashboardReportSubscription(
     throw Object.assign(new Error("Dashboard not found"), { statusCode: 404 });
   }
 
-  const recipients = normalizeRecipients(input.recipients);
-  if (recipients.length === 0) {
-    throw new Error("At least one recipient is required");
-  }
+  const recipients = normalizeDashboardReportRecipients(input.recipients);
 
   const timeOfDay = assertTimeOfDay(input.timeOfDay);
   const timezone = assertTimezone(input.timezone);
@@ -539,7 +571,7 @@ export async function markDashboardReportResult(
     .update(schema.dashboardReportSubscriptions)
     .set({
       lastStatus: status,
-      lastError: error ? error.slice(0, 500) : null,
+      lastError: error ? truncateDashboardReportError(error) : null,
       nextRunAt: sub.enabled
         ? (options?.nextRunAt ??
           nextDailyRunAt(sub.timeOfDay, sub.timezone, new Date()))