@agent-native/core 0.79.27 → 0.80.1

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

@@ -267,7 +267,7 @@
       "chartType": "metric",
       "source": "first-party",
       "width": 1,
-      "sql": "SELECT COUNT(*) AS count FROM session_recordings WHERE chunk_count > 0 AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD'))) 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'))",
+      "sql": "SELECT COUNT(*) AS count FROM session_recordings WHERE chunk_count > 0 AND event_count > 0 AND COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, '')) IS NOT NULL AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD'))) AND ('{{emailFilter}}' IN ('', 'all') OR ('{{emailFilter}}' = 'exclude_builder' AND lower(coalesce(COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, '')), '')) NOT LIKE '%@builder.io') OR ('{{emailFilter}}' = 'only_builder' AND lower(coalesce(COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, '')), '')) LIKE '%@builder.io'))",
       "config": {
         "yKey": "count",
         "yFormatter": "number",
@@ -280,7 +280,7 @@
       "chartType": "area",
       "source": "first-party",
       "width": 1,
-      "sql": "SELECT substr(started_at, 1, 10) AS date, SUM(chunk_count) AS count FROM session_recordings WHERE chunk_count > 0 AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD'))) 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')) GROUP BY substr(started_at, 1, 10) ORDER BY date",
+      "sql": "SELECT substr(started_at, 1, 10) AS date, SUM(chunk_count) AS count FROM session_recordings WHERE chunk_count > 0 AND event_count > 0 AND COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, '')) IS NOT NULL AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD'))) AND ('{{emailFilter}}' IN ('', 'all') OR ('{{emailFilter}}' = 'exclude_builder' AND lower(coalesce(COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, '')), '')) NOT LIKE '%@builder.io') OR ('{{emailFilter}}' = 'only_builder' AND lower(coalesce(COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, '')), '')) LIKE '%@builder.io')) GROUP BY substr(started_at, 1, 10) ORDER BY date",
       "config": {
         "xKey": "date",
         "yKey": "count",
@@ -295,7 +295,7 @@
       "chartType": "table",
       "source": "first-party",
       "width": 2,
-      "sql": "SELECT id AS recording_id, session_id, COALESCE(NULLIF(app, ''), NULLIF(template, ''), 'unknown') AS app, COALESCE(NULLIF(user_id, ''), NULLIF(user_key, ''), NULLIF(anonymous_id, ''), 'anonymous') AS visitor, chunk_count AS chunks, event_count AS events, started_at, COALESCE(ended_at, last_ingested_at, started_at) AS last_seen, '/sessions/' || id AS href FROM session_recordings WHERE chunk_count > 0 AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD'))) 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')) ORDER BY last_seen DESC LIMIT 25",
+      "sql": "SELECT id AS recording_id, session_id, COALESCE(NULLIF(app, ''), NULLIF(template, ''), 'unknown') AS app, COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, '')) AS visitor, chunk_count AS chunks, event_count AS events, started_at, COALESCE(ended_at, last_ingested_at, started_at) AS last_seen, '/sessions/' || id AS href FROM session_recordings WHERE chunk_count > 0 AND event_count > 0 AND COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, '')) IS NOT NULL AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND substr(started_at, 1, 10) >= to_char(CURRENT_DATE - INTERVAL '365 days', 'YYYY-MM-DD'))) AND ('{{emailFilter}}' IN ('', 'all') OR ('{{emailFilter}}' = 'exclude_builder' AND lower(coalesce(COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, '')), '')) NOT LIKE '%@builder.io') OR ('{{emailFilter}}' = 'only_builder' AND lower(coalesce(COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, '')), '')) LIKE '%@builder.io')) ORDER BY last_seen DESC LIMIT 25",
       "config": {
         "description": "Recent first-party session recordings. Session links open the local replay viewer.",
         "sortable": true,

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

@@ -27,6 +27,7 @@ type ReportSnapshot = {
   description?: string;
   filters: Record<string, string>;
   dashboardUrl: string;
+  reportSettingsUrl: string;
   generatedAt: string;
 };
 
@@ -38,16 +39,17 @@ const DATE_FILTER_TYPES: ReadonlySet<FilterType> = new Set([
 const DEFAULT_SERVERLESS_CHROMIUM_PACK_URL =
   "https://github.com/Sparticuz/chromium/releases/download/v149.0.0/chromium-v149.0.0-pack.x64.tar";
 const DASHBOARD_REPORT_SCREENSHOT_PARAM = "reportScreenshot";
-const DASHBOARD_REPORT_PANEL_LIMIT_PARAM = "reportPanelLimit";
+const DASHBOARD_REPORT_SETTINGS_PARAM = "reportSettings";
 const DASHBOARD_REPORT_CID = "dashboard-report-snapshot";
-const COMPACT_REPORT_PANEL_LIMIT = 12;
 const LOCAL_SCREENSHOT_TIMEOUT_MS = 90_000;
 const SERVERLESS_SCREENSHOT_TIMEOUT_MS = 25_000;
 const SERVERLESS_SECOND_READY_TIMEOUT_MS = 10_000;
+const MAX_SCREENSHOT_VIEWPORT_HEIGHT = 30_000;
+const SCREENSHOT_VIEWPORT_PADDING = 64;
 
 type DashboardScreenshotAttempt = {
-  label: "full" | "compact";
-  panelLimit?: number;
+  label: "full" | "full-lightweight";
+  viewport: { width: number; height: number };
 };
 
 function daysAgo(n: number): string {
@@ -114,7 +116,10 @@ function dashboardBaseUrl(): string {
 function buildDashboardPath(
   dashboardId: string,
   filters: Record<string, string>,
-  options?: { reportScreenshot?: boolean; panelLimit?: number },
+  options?: {
+    reportScreenshot?: boolean;
+    reportSettings?: boolean;
+  },
 ): string {
   const url = new URL(
     `/dashboards/${encodeURIComponent(dashboardId)}`,
@@ -126,11 +131,8 @@ function buildDashboardPath(
   if (options?.reportScreenshot) {
     url.searchParams.set(DASHBOARD_REPORT_SCREENSHOT_PARAM, "1");
   }
-  if (options?.panelLimit && options.panelLimit > 0) {
-    url.searchParams.set(
-      DASHBOARD_REPORT_PANEL_LIMIT_PARAM,
-      String(Math.floor(options.panelLimit)),
-    );
+  if (options?.reportSettings) {
+    url.searchParams.set(DASHBOARD_REPORT_SETTINGS_PARAM, "1");
   }
   return `${url.pathname}${url.search}`;
 }
@@ -138,7 +140,10 @@ function buildDashboardPath(
 function buildDashboardUrl(
   dashboardId: string,
   filters: Record<string, string>,
-  options?: { reportScreenshot?: boolean; panelLimit?: number },
+  options?: {
+    reportScreenshot?: boolean;
+    reportSettings?: boolean;
+  },
 ): string {
   const path = buildDashboardPath(dashboardId, filters, options);
   const url = new URL(path, `${dashboardBaseUrl()}/`);
@@ -178,6 +183,9 @@ async function collectReportSnapshot(
     description: config.description,
     filters,
     dashboardUrl: buildDashboardUrl(sub.dashboardId, filters),
+    reportSettingsUrl: buildDashboardUrl(sub.dashboardId, filters, {
+      reportSettings: true,
+    }),
     generatedAt: new Date().toISOString(),
   };
 }
@@ -303,6 +311,44 @@ async function scrollDashboardForLazyRendering(page: any): Promise<void> {
   })()`);
 }
 
+async function fitViewportToDashboardCapture(
+  page: any,
+  capture: any,
+  minViewport: { width: number; height: number },
+): Promise<void> {
+  const box = await capture.boundingBox();
+  if (!box) return;
+
+  const size = {
+    width: Math.max(
+      minViewport.width,
+      Math.min(1800, Math.ceil(box.width + SCREENSHOT_VIEWPORT_PADDING)),
+    ),
+    height: Math.max(
+      minViewport.height,
+      Math.min(
+        MAX_SCREENSHOT_VIEWPORT_HEIGHT,
+        Math.ceil(box.height + SCREENSHOT_VIEWPORT_PADDING),
+      ),
+    ),
+  };
+  await page.setViewportSize(size);
+  await page.waitForTimeout(250);
+
+  const resizedBox = await capture.boundingBox();
+  if (!resizedBox) return;
+  const resizedHeight = Math.ceil(
+    resizedBox.height + SCREENSHOT_VIEWPORT_PADDING,
+  );
+  if (resizedHeight > size.height) {
+    await page.setViewportSize({
+      width: size.width,
+      height: Math.min(MAX_SCREENSHOT_VIEWPORT_HEIGHT, resizedHeight),
+    });
+    await page.waitForTimeout(250);
+  }
+}
+
 async function captureDashboardPng(
   sub: DashboardReportSubscription,
   snapshot: ReportSnapshot,
@@ -313,7 +359,6 @@ async function captureDashboardPng(
     snapshot.filters,
     {
       reportScreenshot: true,
-      panelLimit: attempt.panelLimit,
     },
   );
   const token = signEmbedSessionToken({
@@ -331,11 +376,14 @@ async function captureDashboardPng(
   try {
     const timeout = screenshotTimeoutMs();
     const page = await browser.newPage({
-      viewport: { width: 1440, height: 1800 },
+      viewport: attempt.viewport,
       deviceScaleFactor: 1,
     });
     page.setDefaultTimeout(timeout);
-    await page.emulateMedia({ media: "screen" });
+    await page.emulateMedia({ media: "screen", colorScheme: "light" });
+    await page.addInitScript(() => {
+      window.localStorage.setItem("theme", "light");
+    });
     await page.goto(screenshotUrl.toString(), {
       waitUntil: "domcontentloaded",
       timeout,
@@ -352,13 +400,7 @@ async function captureDashboardPng(
         : timeout,
     );
 
-    const box = await capture.boundingBox();
-    if (box) {
-      await page.setViewportSize({
-        width: Math.max(1200, Math.min(1800, Math.ceil(box.width + 64))),
-        height: Math.max(1000, Math.min(7000, Math.ceil(box.height + 64))),
-      });
-    }
+    await fitViewportToDashboardCapture(page, capture, attempt.viewport);
     await capture.scrollIntoViewIfNeeded();
     const image = await capture.screenshot({
       type: "png",
@@ -382,12 +424,12 @@ async function captureDashboardPngWithFallback(
   snapshot: ReportSnapshot,
 ): Promise<{
   png: Buffer | null;
-  mode: "full" | "compact" | "none";
+  mode: "full" | "full-lightweight" | "none";
   error?: string;
 }> {
   const attempts: DashboardScreenshotAttempt[] = [
-    { label: "full" },
-    { label: "compact", panelLimit: COMPACT_REPORT_PANEL_LIMIT },
+    { label: "full", viewport: { width: 1440, height: 1800 } },
+    { label: "full-lightweight", viewport: { width: 1200, height: 1400 } },
   ];
   let lastError: string | undefined;
 
@@ -423,13 +465,11 @@ function renderReportEmailHtml(
 ): string {
   const title = escapeHtml(snapshot.title);
   const dashboardUrl = escapeHtml(snapshot.dashboardUrl);
+  const reportSettingsUrl = escapeHtml(snapshot.reportSettingsUrl);
   const date = escapeHtml(reportDate(snapshot));
-  const description = snapshot.description
-    ? `<p style="margin:8px 0 18px;color:#525866;font-size:14px;line-height:1.5;">${escapeHtml(snapshot.description)}</p>`
-    : "";
   const screenshotBlock = options.screenshotAttached
     ? `<a href="${dashboardUrl}" style="display:block;text-decoration:none;">
-      <img src="cid:${DASHBOARD_REPORT_CID}" alt="${title}" width="100%" style="display:block;width:100%;max-width:1280px;height:auto;border:1px solid #e5e7eb;border-radius:8px;" />
+      <img src="cid:${DASHBOARD_REPORT_CID}" alt="${title}" width="100%" style="display:block;width:100%;max-width:1280px;height:auto;border:0;outline:0;border-radius:0;" />
     </a>`
     : `<div style="margin:18px 0;padding:14px 16px;border:1px solid #e5e7eb;border-radius:8px;background:#f9fafb;color:#374151;font-size:14px;line-height:1.5;">
       The dashboard image was unavailable for this run. Open the live dashboard to view the latest report.
@@ -441,10 +481,14 @@ function renderReportEmailHtml(
     <h3 style="margin:0 0 8px;font-size:18px;line-height:1.35;font-weight:600;">
       Here's the report of <a href="${dashboardUrl}" style="color:#2563eb;text-decoration:none;">${title}</a> for ${date}.
     </h3>
-    ${description}
     ${screenshotBlock}
     <p style="margin:18px 0 0;color:#525866;font-size:13px;line-height:1.45;">
       <a href="${dashboardUrl}" style="color:#2563eb;text-decoration:none;">Open dashboard</a>
+      <span style="color:#9ca3af;"> · </span>
+      <a href="${reportSettingsUrl}" style="color:#2563eb;text-decoration:none;">Edit subscription settings</a>
+    </p>
+    <p style="margin:6px 0 0;color:#6b7280;font-size:12px;line-height:1.45;">
+      Change recipients, delivery time, filters, or turn this report on/off.
     </p>
   </body>
 </html>`;
@@ -458,6 +502,7 @@ function renderReportText(
     `Daily dashboard report: ${snapshot.title}`,
     `Date: ${reportDate(snapshot)}`,
     `Open dashboard: ${snapshot.dashboardUrl}`,
+    `Edit subscription settings: ${snapshot.reportSettingsUrl}`,
   ];
   if (!options.screenshotAttached) {
     lines.push("Dashboard image unavailable for this run.");
@@ -480,7 +525,7 @@ export async function sendDashboardReportSubscription(
   dashboardUrl: string;
   recipientCount: number;
   screenshotAttached: boolean;
-  screenshotMode: "full" | "compact" | "none";
+  screenshotMode: "full" | "full-lightweight" | "none";
   screenshotError?: string;
 }> {
   const snapshot = await collectReportSnapshot(sub);

package/corpus/templates/analytics/server/lib/first-party-metric-catalog.ts

@@ -166,10 +166,13 @@ const REPLAY_RECORDING_DATE_SQL = "substr(started_at, 1, 10)";
 const REPLAY_TIME_RANGE_FILTER = dashboardTimeRangeFilter(
   REPLAY_RECORDING_DATE_SQL,
 );
-const REPLAY_RECORDING_FILTER = `chunk_count > 0 AND event_count > 0 AND user_id LIKE '%@%' AND ${REPLAY_TIME_RANGE_FILTER} AND ${DASHBOARD_EMAIL_FILTER}`;
+const REPLAY_VISITOR_EMAIL_SQL =
+  "COALESCE(NULLIF(CASE WHEN lower(coalesce(user_id, '')) LIKE '%@%' THEN user_id ELSE '' END, ''), NULLIF(CASE WHEN lower(coalesce(user_key, '')) LIKE '%@%' THEN user_key ELSE '' END, ''))";
+const REPLAY_EMAIL_FILTER = `('{{emailFilter}}' IN ('', 'all') OR ('{{emailFilter}}' = 'exclude_builder' AND lower(coalesce(${REPLAY_VISITOR_EMAIL_SQL}, '')) NOT LIKE '%@builder.io') OR ('{{emailFilter}}' = 'only_builder' AND lower(coalesce(${REPLAY_VISITOR_EMAIL_SQL}, '')) LIKE '%@builder.io'))`;
+const REPLAY_RECORDING_FILTER = `chunk_count > 0 AND event_count > 0 AND ${REPLAY_VISITOR_EMAIL_SQL} IS NOT NULL AND ${REPLAY_TIME_RANGE_FILTER} AND ${REPLAY_EMAIL_FILTER}`;
 const REPLAY_SESSIONS_SQL = `SELECT COUNT(*) AS count FROM session_recordings WHERE ${REPLAY_RECORDING_FILTER}`;
 const REPLAY_CHUNKS_OVER_TIME_SQL = `SELECT ${REPLAY_RECORDING_DATE_SQL} AS date, SUM(chunk_count) AS count FROM session_recordings WHERE ${REPLAY_RECORDING_FILTER} GROUP BY ${REPLAY_RECORDING_DATE_SQL} ORDER BY date`;
-const RECENT_REPLAY_SESSIONS_SQL = `SELECT id AS recording_id, session_id, COALESCE(NULLIF(app, ''), NULLIF(template, ''), 'unknown') AS app, COALESCE(NULLIF(user_id, ''), NULLIF(user_key, ''), NULLIF(anonymous_id, ''), 'anonymous') AS visitor, chunk_count AS chunks, event_count AS events, started_at, COALESCE(ended_at, last_ingested_at, started_at) AS last_seen, '/sessions/' || id AS href FROM session_recordings WHERE ${REPLAY_RECORDING_FILTER} ORDER BY last_seen DESC LIMIT 25`;
+const RECENT_REPLAY_SESSIONS_SQL = `SELECT id AS recording_id, session_id, COALESCE(NULLIF(app, ''), NULLIF(template, ''), 'unknown') AS app, ${REPLAY_VISITOR_EMAIL_SQL} AS visitor, chunk_count AS chunks, event_count AS events, started_at, COALESCE(ended_at, last_ingested_at, started_at) AS last_seen, '/sessions/' || id AS href FROM session_recordings WHERE ${REPLAY_RECORDING_FILTER} ORDER BY last_seen DESC LIMIT 25`;
 export const FIRST_PARTY_DASHBOARD_FILTERS: FirstPartyDashboardFilter[] = [
   {
     id: "timeRange",

package/corpus/templates/analytics/server/lib/real-data-actions.ts

@@ -69,9 +69,33 @@ const MCP_DATA_SOURCE_TOKENS = [
   "stripe",
 ];
 
+function normalizeActionToolName(name: string): string {
+  return name
+    .trim()
+    .toLowerCase()
+    .replace(/[\s_]+/g, "-")
+    .replace(/-+/g, "-");
+}
+
+function isToolName(name: string, expected: string): boolean {
+  return normalizeActionToolName(name) === expected;
+}
+
+function isDataQueryActionName(name: string): boolean {
+  return DATA_QUERY_ACTIONS.has(normalizeActionToolName(name));
+}
+
+function isCorpusSourceActionName(name: string): boolean {
+  return CORPUS_SOURCE_ACTIONS.has(normalizeActionToolName(name));
+}
+
+function isCorpusReductionActionName(name: string): boolean {
+  return CORPUS_REDUCTION_ACTIONS.has(normalizeActionToolName(name));
+}
+
 function isMcpDataSourceTool(name: string): boolean {
-  if (!name.startsWith("mcp__")) return false;
   const normalized = name.toLowerCase();
+  if (!normalized.startsWith("mcp__")) return false;
   return MCP_DATA_SOURCE_TOKENS.some((token) => normalized.includes(token));
 }
 
@@ -94,13 +118,13 @@ function getRunCodeBridgeToolNames(content: string | undefined): string[] {
 
 function hasRunCodeDataQueryAttempt(content: string | undefined): boolean {
   return getRunCodeBridgeToolNames(content).some(
-    (name) => DATA_QUERY_ACTIONS.has(name) || isMcpDataSourceTool(name),
+    (name) => isDataQueryActionName(name) || isMcpDataSourceTool(name),
   );
 }
 
 function hasRunCodeCorpusWorkflowAttempt(content: string | undefined): boolean {
   return getRunCodeBridgeToolNames(content).some(
-    (name) => CORPUS_SOURCE_ACTIONS.has(name) || isCorpusCapableMcpTool(name),
+    (name) => isCorpusSourceActionName(name) || isCorpusCapableMcpTool(name),
   );
 }
 
@@ -208,7 +232,7 @@ const UNSUPPORTED_RESULT_CLAIM =
   /(?:\b\d[\d,.]*(?:\.\d+)?\s*(?:%|percent|users?|customers?|accounts?|sessions?|events?|deals?|tickets?|issues?|calls?|messages?|signups?|pageviews?)\b|\$\s*\d|\b(?:data|query|results?)\s+(?:shows?|showed|indicates?|returned|found)\b|\b(?:i found|the top|the bottom|highest|lowest|increased|decreased|grew|declined|converted|churned|retained|averaged|total(?:ed)?|count(?:ed)?)\b)/i;
 
 const SAFE_NO_DATA_RESPONSE =
-  /\b(?:i can't|i cannot|can't retrieve|cannot retrieve|couldn't retrieve|unable to retrieve|don't have access|do not have access|not configured|missing credentials?|need (?:a|the)? ?data source|need to know which source|which source|which data source|clarify|can you|once (?:that'?s|it is) (?:connected|configured|available)|no data source|without a successful|before (?:i|we) can (?:calculate|report|answer|analyze)|i need to query)\b/i;
+  /\b(?:i can't|i cannot|can't retrieve|cannot retrieve|couldn't retrieve|unable to retrieve|don't have access|do not have access|not configured|missing credentials?|need (?:a|the)? ?data source|need to know which source|which source|which data source|clarify|can you|once (?:that'?s|it is) (?:connected|configured|available)|no data source|without a successful|query failed|source query failed|sql failed|error running|before (?:i|we) can (?:calculate|report|answer|analyze)|i need to query)\b/i;
 
 export function isSafeNoDataAnalyticsResponse(text: string): boolean {
   const trimmed = text.trim();
@@ -358,10 +382,10 @@ export function hasIncompleteDataEvidence(
     const name = String(result.name ?? "");
     if (
       name &&
-      !DATA_QUERY_ACTIONS.has(name) &&
+      !isDataQueryActionName(name) &&
       !isMcpDataSourceTool(name) &&
-      name !== "run-code" &&
-      name !== "provider-api-request"
+      !isToolName(name, "run-code") &&
+      !isToolName(name, "provider-api-request")
     ) {
       return false;
     }
@@ -419,11 +443,50 @@ export function hasDataQueryAttempt(
     if (result.isError) return false;
     if (isProviderErrorOnlyContent(result.content)) return false;
     const name = String(result.name ?? "");
-    if (name === "run-code") return hasRunCodeDataQueryAttempt(result.content);
-    return DATA_QUERY_ACTIONS.has(name) || isMcpDataSourceTool(name);
+    if (isToolName(name, "run-code")) {
+      return hasRunCodeDataQueryAttempt(result.content);
+    }
+    return isDataQueryActionName(name) || isMcpDataSourceTool(name);
   });
 }
 
+function isFailedDataQueryAttempt(result: {
+  name?: string;
+  isError?: boolean;
+  content?: string;
+}): boolean {
+  const name = String(result.name ?? "");
+  const isDataQuery =
+    isDataQueryActionName(name) ||
+    isMcpDataSourceTool(name) ||
+    (isToolName(name, "run-code") &&
+      hasRunCodeDataQueryAttempt(result.content));
+  if (!isDataQuery) return false;
+  return result.isError === true || isProviderErrorOnlyContent(result.content);
+}
+
+function compactToolFailure(content: string | undefined): string {
+  const trimmed = String(content ?? "").trim();
+  if (!trimmed) return "the tool returned an error result without details";
+  const max = 900;
+  return trimmed.length > max ? `${trimmed.slice(0, max)}...` : trimmed;
+}
+
+export function failedDataQueryAttemptMessage(
+  toolResults:
+    | Array<{ name?: string; isError?: boolean; content?: string }>
+    | undefined,
+): string | null {
+  const failed = (toolResults ?? []).find(isFailedDataQueryAttempt);
+  if (!failed) return null;
+  const name = String(failed.name ?? "data-source query");
+  return (
+    `I did try \`${name}\`, but it did not return a successful data result: ` +
+    compactToolFailure(failed.content) +
+    "\n\nI need to fix and rerun that query, or report that exact source error instead of giving numbers."
+  );
+}
+
 export function hasCorpusWorkflowAttempt(
   toolResults:
     | Array<{ name?: string; isError?: boolean; content?: string }>
@@ -433,8 +496,8 @@ export function hasCorpusWorkflowAttempt(
     if (result.isError) return false;
     if (isProviderErrorOnlyContent(result.content)) return false;
     const name = String(result.name ?? "");
-    if (CORPUS_SOURCE_ACTIONS.has(name)) return true;
-    if (name === "run-code") {
+    if (isCorpusSourceActionName(name)) return true;
+    if (isToolName(name, "run-code")) {
       return hasRunCodeCorpusWorkflowAttempt(result.content);
     }
 
@@ -453,10 +516,7 @@ export function hasFailedCorpusWorkflowEvidence(
 ): boolean {
   return (toolResults ?? []).some((result) => {
     const name = String(result.name ?? "");
-    if (
-      !CORPUS_SOURCE_ACTIONS.has(name) &&
-      !CORPUS_REDUCTION_ACTIONS.has(name)
-    ) {
+    if (!isCorpusSourceActionName(name) && !isCorpusReductionActionName(name)) {
       return false;
     }
     if (result.isError) return true;
@@ -576,19 +636,20 @@ function actionEvidenceTextForSourceRecords(result: {
   content?: string;
 }): string {
   const name = String(result.name ?? "");
+  const normalizedName = normalizeActionToolName(name);
   const content = String(result.content ?? "");
   const parsed = tryParseJsonContent(content);
 
-  if (name === "provider-corpus-job") {
+  if (normalizedName === "provider-corpus-job") {
     return corpusJobSourceEvidenceText(parsed);
   }
-  if (name === "provider-api-request") {
+  if (normalizedName === "provider-api-request") {
     return providerRequestEvidenceText(parsed);
   }
-  if (name === "query-staged-dataset") {
+  if (normalizedName === "query-staged-dataset") {
     return queryStagedDatasetEvidenceText(parsed);
   }
-  if (name === "gong-calls") {
+  if (normalizedName === "gong-calls") {
     if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
       return "";
     }
@@ -600,7 +661,7 @@ function actionEvidenceTextForSourceRecords(result: {
       transcripts: record.transcripts,
     });
   }
-  if (name === "run-code") {
+  if (normalizedName === "run-code") {
     return content;
   }
   if (isCorpusCapableMcpTool(name)) {

package/corpus/templates/analytics/server/lib/replay-storage.ts

@@ -0,0 +1,79 @@
+import { listFileUploadProviders } from "@agent-native/core/file-upload";
+import {
+  resolveHasBuilderPrivateKey,
+  runWithRequestContext,
+} from "@agent-native/core/server";
+
+/**
+ * Session replay chunk bytes are stored through the framework file-upload /
+ * private-blob path (Builder.io CDN by default, or an S3-compatible bucket).
+ * In production we require a configured provider — storing replay chunks inline
+ * in SQL is a local/dev-only fallback. This mirrors the Clips video-storage
+ * contract so replay capture fails loudly (and the UI can prompt setup) instead
+ * of silently recording empty, unplayable sessions.
+ */
+export const REPLAY_STORAGE_SETUP_REQUIRED_REASON =
+  "Session replay storage is not connected yet. Connect Builder.io or configure S3-compatible storage to record replays.";
+
+function appDatabaseUrl(): string {
+  const appName = process.env.APP_NAME?.toUpperCase().replace(/-/g, "_");
+  if (appName) {
+    const appUrl = process.env[`${appName}_DATABASE_URL`];
+    if (appUrl) return appUrl;
+  }
+  return process.env.DATABASE_URL || process.env.NETLIFY_DATABASE_URL || "";
+}
+
+function isLikelyLocalDatabase(): boolean {
+  const url = appDatabaseUrl();
+  return url === "" || url.startsWith("file:") || !url.includes("://");
+}
+
+export function requiresConfiguredReplayStorage(): boolean {
+  return process.env.NODE_ENV === "production" || !isLikelyLocalDatabase();
+}
+
+export interface ReplayStorageResolveContext {
+  userEmail?: string;
+  orgId?: string | null;
+}
+
+/**
+ * Whether a durable upload provider (non-inline) is configured for the given
+ * owner/org scope. Iterates registered providers (e.g. S3) first, then falls
+ * back to a resolvable Builder.io private key. When a scope is supplied the
+ * check runs inside that user/org request context so org-scoped `app_secrets`
+ * credentials resolve — exactly the scope the anonymous replay-ingest path
+ * lacks on its own.
+ */
+export async function hasRequestReplayStorage(
+  context?: ReplayStorageResolveContext,
+): Promise<boolean> {
+  const resolve = async () => {
+    for (const provider of listFileUploadProviders()) {
+      if (provider.id === "builder") continue;
+      if (provider.isConfigured()) return true;
+      if (provider.isConfiguredForRequest) {
+        try {
+          if (await provider.isConfiguredForRequest()) return true;
+        } catch {
+          // Treat a failed scoped lookup as not configured.
+        }
+      }
+    }
+
+    try {
+      return await resolveHasBuilderPrivateKey();
+    } catch {
+      return false;
+    }
+  };
+
+  if (context?.userEmail) {
+    return runWithRequestContext(
+      { userEmail: context.userEmail, orgId: context.orgId ?? undefined },
+      resolve,
+    );
+  }
+  return resolve();
+}