@agent-native/core 0.120.1 → 0.120.3

package/corpus/templates/analytics/changelog/2026-07-24-manage-agent-is-clearly-marked-as-a-link-to-its-dedicated-pa.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-24
+---
+
+Manage agent is clearly marked as a link to its dedicated page

package/corpus/templates/analytics/changelog/2026-07-24-sidebar-footer-controls-follow-a-consistent-order.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-24
+---
+
+Sidebar utility controls now follow a consistent footer order.

package/corpus/templates/analytics/netlify.toml

@@ -10,9 +10,13 @@ functions = "templates/analytics/.netlify/functions-internal"
 
 [build.environment]
 GA_MEASUREMENT_ID = "G-ESF7FYXGN9"
+GTM_CONTAINER_ID = "GTM-N3WSTXZ"
 NITRO_PRESET = "netlify"
 NPM_CONFIG_PRODUCTION = "false"
 AGENT_PROD_CODE_EXECUTION = "sandboxed"
+# Analytics dashboard creation can span multiple model/tool rounds; keep those
+# turns on the durable background worker instead of the short foreground wall.
+AGENT_CHAT_DURABLE_BACKGROUND = "true"
 
 # A2A delegation calls run a full agent loop (LLM + tool calls + DB queries).
 # Hosted agent chat uses a soft timeout before this function timeout so the

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

@@ -75,7 +75,7 @@
       "chartType": "area",
       "source": "first-party",
       "width": 2,
-      "sql": "WITH offsets AS (SELECT (ROW_NUMBER() OVER (ORDER BY event_date) - 1)::int AS n FROM analytics_events LIMIT 800), signup_events AS (SELECT event_date AS date, 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 = 'signup' AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND event_date >= 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'))), bounds AS (SELECT MIN(date::date) AS start_date, MAX(date::date) AS end_date FROM signup_events), dates AS (SELECT to_char(bounds.start_date + offsets.n, 'YYYY-MM-DD') AS date FROM bounds CROSS JOIN offsets WHERE bounds.start_date IS NOT NULL AND bounds.start_date + offsets.n <= bounds.end_date), templates AS (SELECT DISTINCT template FROM signup_events), daily AS (SELECT date, template, COUNT(*) AS count FROM signup_events GROUP BY date, template) SELECT dates.date, templates.template, COALESCE(daily.count, 0) AS count FROM dates CROSS JOIN templates LEFT JOIN daily ON daily.date = dates.date AND daily.template = templates.template ORDER BY dates.date, templates.template",
+      "sql": "WITH digits AS (SELECT 0 AS n UNION ALL SELECT 1 UNION ALL SELECT 2 UNION ALL SELECT 3 UNION ALL SELECT 4 UNION ALL SELECT 5 UNION ALL SELECT 6 UNION ALL SELECT 7 UNION ALL SELECT 8 UNION ALL SELECT 9), offsets AS (SELECT ones.n + tens.n * 10 + hundreds.n * 100 AS n FROM digits ones CROSS JOIN digits tens CROSS JOIN digits hundreds WHERE hundreds.n < 8), signup_events AS (SELECT event_date AS date, 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 = 'signup' AND (event_date <= to_char(CURRENT_DATE, 'YYYY-MM-DD') AND ('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '7 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '30d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '30 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '90d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '90 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '180d' AND event_date >= to_char(CURRENT_DATE - INTERVAL '180 days', 'YYYY-MM-DD')) OR ('{{timeRange}}' = '365d' AND event_date >= 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'))), bounds AS (SELECT MIN(date::date) AS start_date, MAX(date::date) AS end_date FROM signup_events), dates AS (SELECT to_char(bounds.start_date + offsets.n, 'YYYY-MM-DD') AS date FROM bounds CROSS JOIN offsets WHERE bounds.start_date IS NOT NULL AND bounds.start_date + offsets.n <= bounds.end_date), templates AS (SELECT DISTINCT template FROM signup_events), daily AS (SELECT date, template, COUNT(*) AS count FROM signup_events GROUP BY date, template) SELECT dates.date, templates.template, COALESCE(daily.count, 0) AS count FROM dates CROSS JOIN templates LEFT JOIN daily ON daily.date = dates.date AND daily.template = templates.template ORDER BY dates.date, templates.template",
       "config": {
         "xKey": "date",
         "yKey": "count",

package/corpus/templates/analytics/server/db/schema.ts

@@ -67,6 +67,10 @@ export const dashboardRevisions = table(
       t.dashboardId,
       t.createdAt,
     ),
+    orgDashboardIdx: index("dashboard_revisions_org_dashboard_idx").on(
+      t.orgId,
+      t.dashboardId,
+    ),
   }),
 );
 
@@ -109,6 +113,11 @@ export const dashboardReportSubscriptions = table(
       enum: ["success", "error", "running"],
     }),
     lastError: text("last_error"),
+    lastCaptureAt: text("last_capture_at"),
+    lastCaptureMode: text("last_capture_mode", {
+      enum: ["full", "partial", "none"],
+    }),
+    lastCaptureError: text("last_capture_error"),
     createdAt: text("created_at").notNull().default(now()),
     updatedAt: text("updated_at").notNull().default(now()),
     ownerEmail: text("owner_email").notNull().default("local@localhost"),

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

@@ -5,6 +5,7 @@ import {
   claimDueDashboardReportSubscriptions,
   dashboardReportRetryAt,
   markDashboardReportResult,
+  recordDashboardReportCaptureOutcome,
 } from "../lib/dashboard-report-subscriptions";
 
 let running = false;
@@ -26,6 +27,24 @@ async function persistDashboardReportResult(
   }
 }
 
+async function persistDashboardReportCaptureOutcome(
+  ...args: Parameters<typeof recordDashboardReportCaptureOutcome>
+): Promise<void> {
+  try {
+    const persisted = await recordDashboardReportCaptureOutcome(...args);
+    if (!persisted) {
+      console.warn(
+        `[dashboard-report] Capture checkpoint was superseded for subscription ${args[0].id}`,
+      );
+    }
+  } catch (err) {
+    console.error(
+      `[dashboard-report] Failed to persist capture checkpoint for subscription ${args[0].id}:`,
+      err instanceof Error ? err.message : String(err),
+    );
+  }
+}
+
 function maxReportsPerSweep(): number {
   if (process.env.NETLIFY === "true") return 1;
   const raw = process.env.DASHBOARD_REPORT_SWEEP_LIMIT?.trim();
@@ -71,6 +90,8 @@ export async function runDashboardReportsOnce(): Promise<{
           () =>
             sendDashboardReportSubscription(sub, {
               skipEmailWithoutScreenshot: retryAt !== null,
+              onCaptureOutcome: (outcome) =>
+                persistDashboardReportCaptureOutcome(sub, outcome),
               ...(deliveryDeadlineAt ? { deadlineAt: deliveryDeadlineAt } : {}),
             }),
         );

package/corpus/templates/analytics/server/lib/agent-chat-plan-mode.ts

@@ -15,7 +15,6 @@ export const INITIAL_TOOL_NAMES = [
   "list-session-recordings",
   "list-analyses",
   "get-analysis",
-  "save-analysis",
   // Dashboard/extension INSPECTION stays on the initial surface so a
   // template-clone request can resolve and inspect the source on the first
   // turn. The MUTATING writers (update-dashboard, mutate-dashboard,

package/corpus/templates/analytics/server/lib/agent-readable-resource-context.ts

@@ -105,6 +105,7 @@ export function buildDashboardAgentContext(
     hiddenBy: dashboard.hiddenBy,
     createdAt: dashboard.createdAt,
     updatedAt: dashboard.updatedAt,
+    updatedBy: dashboard.updatedBy,
     url: `/dashboards/${dashboard.id}`,
   };
   return options.includeConfig === false ? base : { ...base, ...config };

package/corpus/templates/analytics/server/lib/canonical-first-party-dashboard-repair.ts

@@ -1,4 +1,7 @@
 import {
+  LEGACY_SIGNUPS_OVER_TIME_SQL,
+  LEGACY_SEED_SIGNUPS_OVER_TIME_SQL,
+  SIGNUPS_OVER_TIME_SQL,
   type ExactFirstPartyPanelReplacement,
   repairFirstPartyObservedRetentionPanels,
 } from "./first-party-metric-catalog";
@@ -12,6 +15,14 @@ const NEW_VS_RECURRING_USERS_DESCRIPTION =
 
 const CANONICAL_CUSTOM_PANEL_REPLACEMENTS: readonly ExactFirstPartyPanelReplacement[] =
   [
+    {
+      id: "signups-over-time",
+      legacySql: [
+        LEGACY_SEED_SIGNUPS_OVER_TIME_SQL,
+        LEGACY_SIGNUPS_OVER_TIME_SQL,
+      ],
+      sql: SIGNUPS_OVER_TIME_SQL,
+    },
     {
       id: "new-vs-recurring-users",
       legacySql: [LEGACY_NEW_VS_RECURRING_USERS_SQL],

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

@@ -1,6 +1,7 @@
 import { randomUUID } from "node:crypto";
 
 import { recordChange } from "@agent-native/core/server";
+import { EMBED_TOKEN_QUERY_PARAM } from "@agent-native/core/shared";
 import { and, asc, eq, isNull, lte, or, sql } from "drizzle-orm";
 
 import { getDb, schema } from "../db/index.js";
@@ -34,12 +35,22 @@ export interface DashboardReportSubscription {
   lastRunAt: string | null;
   lastStatus: "success" | "error" | "running" | null;
   lastError: string | null;
+  lastCaptureAt: string | null;
+  lastCaptureMode: DashboardReportCaptureMode | null;
+  lastCaptureError: string | null;
   createdAt: string;
   updatedAt: string;
   ownerEmail: string;
   orgId: string | null;
 }
 
+export type DashboardReportCaptureMode = "full" | "partial" | "none";
+
+export interface DashboardReportCaptureOutcome {
+  mode: DashboardReportCaptureMode;
+  error?: string;
+}
+
 export interface AccessCtx {
   email: string;
   orgId: string | null;
@@ -89,7 +100,15 @@ function nowIso(): string {
 const DASHBOARD_REPORT_ERROR_MAX_LENGTH = 2_000;
 const DASHBOARD_REPORT_ERROR_OMISSION = "\n… [truncated] …\n";
 
+export function redactDashboardReportDiagnostic(value: string): string {
+  return value.replace(
+    new RegExp(`(${EMBED_TOKEN_QUERY_PARAM}=)[^&\\s]+`, "gi"),
+    "$1[REDACTED]",
+  );
+}
+
 export function truncateDashboardReportError(error: string): string {
+  error = redactDashboardReportDiagnostic(error);
   if (error.length <= DASHBOARD_REPORT_ERROR_MAX_LENGTH) return error;
 
   const retainedLength =
@@ -307,6 +326,9 @@ function rowToSubscription(row: any): DashboardReportSubscription {
     lastRunAt: row.lastRunAt ?? null,
     lastStatus: row.lastStatus ?? null,
     lastError: row.lastError ?? null,
+    lastCaptureAt: row.lastCaptureAt ?? null,
+    lastCaptureMode: row.lastCaptureMode ?? null,
+    lastCaptureError: row.lastCaptureError ?? null,
     createdAt: row.createdAt,
     updatedAt: row.updatedAt,
     ownerEmail: row.ownerEmail,
@@ -578,3 +600,35 @@ export async function markDashboardReportResult(
     })
     .where(eq(schema.dashboardReportSubscriptions.id, sub.id));
 }
+
+/**
+ * Persists the capture result before email delivery so a serverless cutoff
+ * cannot erase the browser diagnostics after a fallback message is accepted.
+ */
+export async function recordDashboardReportCaptureOutcome(
+  sub: DashboardReportSubscription,
+  outcome: DashboardReportCaptureOutcome,
+): Promise<boolean> {
+  if (!sub.lastRunAt) return false;
+
+  const capturedAt = nowIso();
+  const db = getDb() as any;
+  const rows = await db
+    .update(schema.dashboardReportSubscriptions)
+    .set({
+      lastCaptureAt: capturedAt,
+      lastCaptureMode: outcome.mode,
+      lastCaptureError: outcome.error
+        ? truncateDashboardReportError(outcome.error)
+        : null,
+      updatedAt: capturedAt,
+    })
+    .where(
+      and(
+        eq(schema.dashboardReportSubscriptions.id, sub.id),
+        eq(schema.dashboardReportSubscriptions.lastRunAt, sub.lastRunAt),
+      ),
+    )
+    .returning();
+  return Boolean(rows[0]);
+}

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

@@ -29,6 +29,7 @@ import {
   getReportDashboard,
   normalizeDashboardReportRecipients,
   type AccessCtx,
+  type DashboardReportCaptureOutcome,
   type DashboardReportSubscription,
 } from "./dashboard-report-subscriptions";
 
@@ -437,6 +438,7 @@ async function waitForDashboardReportReady(
   timeout: number,
   consoleErrors: string[] = [],
   failedRequests: string[] = [],
+  expectedPanelIds: string[] = [],
 ): Promise<boolean> {
   try {
     await page.waitForFunction(
@@ -460,22 +462,34 @@ async function waitForDashboardReportReady(
     const detail = await page
       .evaluate(`(() => {
         const root = document.querySelector("[data-dashboard-report-capture]");
+        const expectedPanelIds = ${JSON.stringify(expectedPanelIds.slice(0, REPORT_PANEL_STATE_DIAGNOSTICS_LIMIT))};
+        const cleanText = (value, limit = ${REPORT_PANEL_STATE_TEXT_LIMIT}) =>
+          String(value ?? "").replace(/\\s+/g, " ").trim().slice(0, limit);
+        const panelStates = expectedPanelIds.map((id) => {
+          const panel = Array.from(
+            root?.querySelectorAll("[data-dashboard-report-panel-id]") ?? [],
+          ).find((node) =>
+            node.getAttribute("data-dashboard-report-panel-id") === id,
+          );
+          if (!panel) return { id: cleanText(id, 96), state: "missing" };
+          const errorNode = panel.querySelector(
+            "[data-dashboard-report-panel-error='true'], .text-red-400",
+          );
+          const error = cleanText(errorNode?.textContent);
+          return {
+            id: cleanText(id, 96),
+            title: cleanText(panel.getAttribute("data-dashboard-report-panel-title"), 120),
+            state: panel.querySelector("[data-dashboard-report-loading='true']")
+              ? "loading"
+              : error
+                ? "errored"
+                : "ready",
+            ...(error ? { error } : {}),
+          };
+        });
         return {
           ready: root?.getAttribute("data-dashboard-report-ready") ?? null,
-          loadingCount: root?.querySelectorAll("[data-dashboard-report-loading='true']").length ?? null,
-          loadingPanels: Array.from(
-            root?.querySelectorAll("[data-dashboard-report-loading='true']") ?? [],
-          ).reduce((panels, loadingNode) => {
-            const panel = loadingNode.closest("[data-dashboard-report-panel-id]");
-            const id = panel?.getAttribute("data-dashboard-report-panel-id");
-            if (!id || panels.some((entry) => entry.id === id)) return panels;
-            panels.push({
-              id,
-              title: panel?.getAttribute("data-dashboard-report-panel-title") ?? "",
-            });
-            return panels;
-          }, []),
-          text: document.body?.innerText?.slice(0, 1000) ?? "",
+          panelStates,
           url: location.href,
         };
       })()`)
@@ -596,6 +610,93 @@ async function runBoundedBrowserCleanup(
 const DIAGNOSTICS_PROBE_TIMEOUT_MS = 2_000;
 const DIAGNOSTICS_MAX_LENGTH = 700;
 const DIAGNOSTICS_COLLECTOR_LIMIT = 5;
+const REPORT_PANEL_STATE_DIAGNOSTICS_LIMIT = REPORT_PANEL_CHUNK_SIZE;
+const REPORT_PANEL_STATE_TEXT_LIMIT = 160;
+const DIAGNOSTICS_URL_LIMIT = 120;
+const DIAGNOSTICS_TEXT_SNAPSHOT_LIMIT = 180;
+const DIAGNOSTICS_REQUEST_TRACKING_LIMIT = 50;
+const DIAGNOSTICS_IN_FLIGHT_SERIALIZATION_LIMIT = 3;
+
+type InFlightReportRequest = {
+  method: string;
+  url: string;
+  startedAt: number;
+};
+
+type RecentReportResource = {
+  method: string;
+  url: string;
+  status?: number;
+  ageMs?: number;
+  outcome: "response" | "finished" | "failed";
+};
+
+function redactDiagnosticUrl(value: unknown): string {
+  return String(value ?? "")
+    .replace(
+      /([?&](?:__an_embed_token|token|access_token|authorization|sql|query)=)[^&\s]*/gi,
+      "$1[REDACTED]",
+    )
+    .slice(0, DIAGNOSTICS_URL_LIMIT);
+}
+
+function sanitizeDiagnosticText(
+  value: unknown,
+  limit = DIAGNOSTICS_TEXT_SNAPSHOT_LIMIT,
+): string {
+  return errorMessage(String(value ?? ""))
+    .replace(/\b(?:bearer\s+)[a-z0-9._~+/=-]+/gi, "Bearer [REDACTED]")
+    .replace(
+      /\b((?:access[_-]?token|auth(?:orization)?|session|cookie)\s*[:=]\s*)[^\s,;"'<>]+/gi,
+      "$1[REDACTED]",
+    )
+    .replace(/\s+/g, " ")
+    .trim()
+    .slice(0, limit);
+}
+
+function requestDiagnostic(req: any): InFlightReportRequest {
+  return {
+    method: sanitizeDiagnosticText(req.method?.(), 16) || "GET",
+    url: redactDiagnosticUrl(req.url?.()),
+    startedAt: Date.now(),
+  };
+}
+
+function requestDiagnosticPriority(url: string): number {
+  return /\/(?:_agent-native\/actions|auth|session)(?:\/|[?]|$)|get-sql-dashboard/i.test(
+    url,
+  )
+    ? 1
+    : 0;
+}
+
+function retainInFlightRequest(
+  requests: Map<any, InFlightReportRequest>,
+  req: any,
+) {
+  if (
+    !requests.has(req) &&
+    requests.size >= DIAGNOSTICS_REQUEST_TRACKING_LIMIT
+  ) {
+    const discard = [...requests.entries()].sort(([, left], [, right]) => {
+      const priority =
+        requestDiagnosticPriority(left.url) -
+        requestDiagnosticPriority(right.url);
+      return priority || left.startedAt - right.startedAt;
+    })[0];
+    if (discard) requests.delete(discard[0]);
+  }
+  requests.set(req, requestDiagnostic(req));
+}
+
+function pushRecentResource(
+  resources: RecentReportResource[],
+  resource: RecentReportResource,
+) {
+  if (resources.length >= DIAGNOSTICS_COLLECTOR_LIMIT) resources.shift();
+  resources.push(resource);
+}
 
 // netlify.toml's memory = "2gb" is plan-gated and can be silently ignored, so
 // capture the actual lambda memory ceiling alongside current RSS.
@@ -614,8 +715,24 @@ async function collectPageDiagnostics(
   page: any,
   consoleErrors: string[],
   failedRequests: string[],
+  inFlightRequests: Map<any, InFlightReportRequest>,
+  recentResources: RecentReportResource[],
 ): Promise<string> {
   const memory = memoryDiagnostics();
+  const pendingRequests = () =>
+    [...inFlightRequests.values()]
+      .sort((left, right) => {
+        const priority =
+          requestDiagnosticPriority(right.url) -
+          requestDiagnosticPriority(left.url);
+        return priority || right.startedAt - left.startedAt;
+      })
+      .slice(0, DIAGNOSTICS_IN_FLIGHT_SERIALIZATION_LIMIT)
+      .map((request) => ({
+        method: request.method,
+        url: request.url,
+        ageMs: Math.max(0, Date.now() - request.startedAt),
+      }));
   try {
     let responsive = true;
     let probeTimeout: ReturnType<typeof setTimeout> | undefined;
@@ -638,7 +755,9 @@ async function collectPageDiagnostics(
     if (!responsive) {
       return `${memory} page unresponsive (renderer hung or crashed); consoleErrors=${JSON.stringify(
         consoleErrors,
-      )} failedRequests=${JSON.stringify(failedRequests)}`.slice(
+      )} failedRequests=${JSON.stringify(failedRequests)} inFlightRequests=${JSON.stringify(
+        pendingRequests(),
+      )} recentResources=${JSON.stringify(recentResources)}`.slice(
         0,
         DIAGNOSTICS_MAX_LENGTH,
       );
@@ -651,8 +770,7 @@ async function collectPageDiagnostics(
       // page may already be closed; leave url empty
     }
 
-    let title = "";
-    let bodyText = "";
+    let pageState: Record<string, unknown> = {};
     let detailsTimeout: ReturnType<typeof setTimeout> | undefined;
     try {
       // page.evaluate ignores setDefaultTimeout, so race it like the probe —
@@ -662,7 +780,21 @@ async function collectPageDiagnostics(
           page.evaluate(
             `(() => ({
               title: document.title,
-              bodyText: document.body?.innerText?.slice(0, 240) ?? "",
+              readyState: document.readyState,
+              capture: (() => {
+                const root = document.querySelector("[data-dashboard-report-capture]");
+                return {
+                  present: Boolean(root),
+                  ready: root?.getAttribute("data-dashboard-report-ready") ?? null,
+                  phase: root?.getAttribute("data-dashboard-report-phase") ?? root?.dataset?.phase ?? null,
+                  fetchState: root?.getAttribute("data-dashboard-report-fetch-state") ?? root?.dataset?.fetchState ?? null,
+                  error: root?.getAttribute("data-dashboard-report-error") ?? root?.dataset?.error ?? null,
+                  childCount: root?.children.length ?? 0,
+                  htmlLength: root?.innerHTML.length ?? 0,
+                  textLength: root?.textContent.length ?? 0,
+                };
+              })(),
+              bodyTextSnapshot: document.body?.textContent?.replace(/\\s+/g, " ").trim().slice(0, ${DIAGNOSTICS_TEXT_SNAPSHOT_LIMIT}) ?? "",
             }))()`,
           ),
         ),
@@ -673,18 +805,46 @@ async function collectPageDiagnostics(
           );
         }),
       ]);
-      title = (details as any)?.title ?? "";
-      bodyText = (details as any)?.bodyText ?? "";
+      const raw = details as any;
+      pageState = {
+        title: sanitizeDiagnosticText(raw?.title),
+        readyState: sanitizeDiagnosticText(raw?.readyState, 32),
+        capture: raw?.capture
+          ? {
+              present: Boolean(raw.capture.present),
+              ready: sanitizeDiagnosticText(raw.capture.ready, 32) || null,
+              phase: sanitizeDiagnosticText(raw.capture.phase, 80) || null,
+              fetchState:
+                sanitizeDiagnosticText(raw.capture.fetchState, 80) || null,
+              error: sanitizeDiagnosticText(raw.capture.error) || null,
+              childCount: Number.isFinite(raw.capture.childCount)
+                ? raw.capture.childCount
+                : 0,
+              htmlLength: Number.isFinite(raw.capture.htmlLength)
+                ? raw.capture.htmlLength
+                : 0,
+              textLength: Number.isFinite(raw.capture.textLength)
+                ? raw.capture.textLength
+                : 0,
+            }
+          : { present: false },
+        bodyTextSnapshot: sanitizeDiagnosticText(raw?.bodyTextSnapshot),
+      };
     } catch {
       // best effort; leave title/bodyText empty
     } finally {
       if (detailsTimeout) clearTimeout(detailsTimeout);
     }
 
+    const { capture, readyState, title, bodyTextSnapshot } = pageState;
     return `${memory} page state: ${JSON.stringify({
-      url,
+      capture,
+      readyState,
+      inFlightRequests: pendingRequests(),
+      recentResources,
+      url: redactDiagnosticUrl(url),
       title,
-      bodyText,
+      bodyTextSnapshot,
       consoleErrors,
       failedRequests,
     })}`.slice(0, DIAGNOSTICS_MAX_LENGTH);
@@ -743,30 +903,64 @@ async function captureDashboardChunk(
   let captureStage = "pre-seeding the embed session";
   const consoleErrors: string[] = [];
   const failedRequests: string[] = [];
+  const inFlightRequests = new Map<any, InFlightReportRequest>();
+  const recentResources: RecentReportResource[] = [];
   page.on("console", (msg: any) => {
     if (
       msg.type() !== "error" ||
       consoleErrors.length >= DIAGNOSTICS_COLLECTOR_LIMIT
     )
       return;
-    consoleErrors.push(msg.text().slice(0, 160));
+    consoleErrors.push(sanitizeDiagnosticText(msg.text()));
+  });
+  page.on("request", (req: any) => {
+    retainInFlightRequest(inFlightRequests, req);
   });
   page.on("requestfailed", (req: any) => {
+    const request = inFlightRequests.get(req) ?? requestDiagnostic(req);
+    inFlightRequests.delete(req);
+    pushRecentResource(recentResources, {
+      method: request.method,
+      url: request.url,
+      ageMs: Math.max(0, Date.now() - request.startedAt),
+      outcome: "failed",
+    });
     if (failedRequests.length >= DIAGNOSTICS_COLLECTOR_LIMIT) return;
     failedRequests.push(
-      `${req.method()} ${req.url().slice(0, 120)}: ${req.failure()?.errorText ?? "failed"}`,
+      `${request.method} ${request.url}: ${sanitizeDiagnosticText(req.failure()?.errorText ?? "failed")}`,
     );
   });
   page.on("response", (res: any) => {
+    const req = res.request();
+    const request = inFlightRequests.get(req) ?? requestDiagnostic(req);
+    inFlightRequests.delete(req);
+    pushRecentResource(recentResources, {
+      method: request.method,
+      url: request.url,
+      status: res.status(),
+      ageMs: Math.max(0, Date.now() - request.startedAt),
+      outcome: "response",
+    });
     if (
       res.status() < 400 ||
       failedRequests.length >= DIAGNOSTICS_COLLECTOR_LIMIT
     )
       return;
     failedRequests.push(
-      `${res.request().method()} ${res.url().slice(0, 120)}: HTTP ${res.status()}`,
+      `${request.method} ${request.url}: HTTP ${res.status()}`,
     );
   });
+  page.on("requestfinished", (req: any) => {
+    const request = inFlightRequests.get(req);
+    if (!request) return;
+    inFlightRequests.delete(req);
+    pushRecentResource(recentResources, {
+      method: request.method,
+      url: request.url,
+      ageMs: Math.max(0, Date.now() - request.startedAt),
+      outcome: "finished",
+    });
+  });
   try {
     try {
       await page.context().addCookies([
@@ -801,7 +995,13 @@ async function captureDashboardChunk(
       });
     } catch (err) {
       const diagnostics = errorMessage(
-        await collectPageDiagnostics(page, consoleErrors, failedRequests),
+        await collectPageDiagnostics(
+          page,
+          consoleErrors,
+          failedRequests,
+          inFlightRequests,
+          recentResources,
+        ),
       );
       throw new Error(`${errorMessage(err)}; ${diagnostics}`);
     }
@@ -811,6 +1011,7 @@ async function captureDashboardChunk(
       boundedStageTimeout(attempt.readyTimeout ?? timeout, deadlineAt),
       consoleErrors,
       failedRequests,
+      expectedPanelIds,
     );
     captureStage = "validating the report chunk panels";
     await assertDashboardReportPanelWindow(page, expectedPanelIds);
@@ -825,6 +1026,7 @@ async function captureDashboardChunk(
       ),
       consoleErrors,
       failedRequests,
+      expectedPanelIds,
     );
     captureStage = "revalidating the report chunk panels";
     await assertDashboardReportPanelWindow(page, expectedPanelIds);
@@ -1138,6 +1340,9 @@ export async function sendDashboardReportSubscription(
     requireScreenshot?: boolean;
     skipEmailWithoutScreenshot?: boolean;
     deadlineAt?: number;
+    onCaptureOutcome?: (
+      outcome: DashboardReportCaptureOutcome,
+    ) => Promise<void>;
   } = {},
 ): Promise<{
   dashboardUrl: string;
@@ -1169,6 +1374,10 @@ export async function sendDashboardReportSubscription(
     !options.skipEmailWithoutScreenshot && !options.requireScreenshot,
     captureTimeoutMs,
   );
+  await options.onCaptureOutcome?.({
+    mode: capture.mode,
+    ...(capture.error ? { error: capture.error } : {}),
+  });
   if (capture.mode !== "full" && options.requireScreenshot) {
     throw new Error(
       capture.error

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

@@ -221,7 +221,10 @@ export function usesFirstPartyDashboardFilters(sql: string): boolean {
 }
 
 const TOTAL_SIGNUPS_SQL = `SELECT COUNT(*) AS signups FROM analytics_events WHERE event_name = 'signup' AND ${DASHBOARD_TIME_RANGE_FILTER} AND ${DASHBOARD_EMAIL_FILTER}`;
-const SIGNUPS_OVER_TIME_SQL = `WITH offsets AS (SELECT (ROW_NUMBER() OVER (ORDER BY ${EVENT_DATE_SQL}) - 1)::int AS n FROM analytics_events LIMIT 800), signup_events AS (SELECT ${EVENT_DATE_SQL} AS date, ${TEMPLATE_EXPR} AS template FROM analytics_events WHERE event_name = 'signup' AND ${DASHBOARD_TIME_RANGE_FILTER} AND ${DASHBOARD_EMAIL_FILTER}), bounds AS (SELECT MIN(date::date) AS start_date, MAX(date::date) AS end_date FROM signup_events), dates AS (SELECT to_char(bounds.start_date + offsets.n, 'YYYY-MM-DD') AS date FROM bounds CROSS JOIN offsets WHERE bounds.start_date IS NOT NULL AND bounds.start_date + offsets.n <= bounds.end_date), templates AS (SELECT DISTINCT template FROM signup_events), daily AS (SELECT date, template, COUNT(*) AS count FROM signup_events GROUP BY date, template) SELECT dates.date, templates.template, COALESCE(daily.count, 0) AS count FROM dates CROSS JOIN templates LEFT JOIN daily ON daily.date = dates.date AND daily.template = templates.template ORDER BY dates.date, templates.template`;
+const LEGACY_SEED_SIGNUPS_TIME_RANGE_FILTER = `('{{timeRange}}' IN ('', 'all') OR ('{{timeRange}}' = '7d' AND ${EVENT_DATE_SQL} >= ${daysAgoSql(7)}) OR ('{{timeRange}}' = '30d' AND ${EVENT_DATE_SQL} >= ${daysAgoSql(30)}) OR ('{{timeRange}}' = '90d' AND ${EVENT_DATE_SQL} >= ${daysAgoSql(90)}) OR ('{{timeRange}}' = '180d' AND ${EVENT_DATE_SQL} >= ${daysAgoSql(180)}) OR ('{{timeRange}}' = '365d' AND ${EVENT_DATE_SQL} >= ${daysAgoSql(365)}))`;
+export const LEGACY_SEED_SIGNUPS_OVER_TIME_SQL = `WITH offsets AS (SELECT (ROW_NUMBER() OVER (ORDER BY ${EVENT_DATE_SQL}) - 1)::int AS n FROM analytics_events LIMIT 800), signup_events AS (SELECT ${EVENT_DATE_SQL} AS date, ${TEMPLATE_EXPR} AS template FROM analytics_events WHERE event_name = 'signup' AND ${LEGACY_SEED_SIGNUPS_TIME_RANGE_FILTER} AND ${DASHBOARD_EMAIL_FILTER}), bounds AS (SELECT MIN(date::date) AS start_date, MAX(date::date) AS end_date FROM signup_events), dates AS (SELECT to_char(bounds.start_date + offsets.n, 'YYYY-MM-DD') AS date FROM bounds CROSS JOIN offsets WHERE bounds.start_date IS NOT NULL AND bounds.start_date + offsets.n <= bounds.end_date), templates AS (SELECT DISTINCT template FROM signup_events), daily AS (SELECT date, template, COUNT(*) AS count FROM signup_events GROUP BY date, template) SELECT dates.date, templates.template, COALESCE(daily.count, 0) AS count FROM dates CROSS JOIN templates LEFT JOIN daily ON daily.date = dates.date AND daily.template = templates.template ORDER BY dates.date, templates.template`;
+export const LEGACY_SIGNUPS_OVER_TIME_SQL = `WITH offsets AS (SELECT (ROW_NUMBER() OVER (ORDER BY ${EVENT_DATE_SQL}) - 1)::int AS n FROM analytics_events LIMIT 800), signup_events AS (SELECT ${EVENT_DATE_SQL} AS date, ${TEMPLATE_EXPR} AS template FROM analytics_events WHERE event_name = 'signup' AND ${DASHBOARD_TIME_RANGE_FILTER} AND ${DASHBOARD_EMAIL_FILTER}), bounds AS (SELECT MIN(date::date) AS start_date, MAX(date::date) AS end_date FROM signup_events), dates AS (SELECT to_char(bounds.start_date + offsets.n, 'YYYY-MM-DD') AS date FROM bounds CROSS JOIN offsets WHERE bounds.start_date IS NOT NULL AND bounds.start_date + offsets.n <= bounds.end_date), templates AS (SELECT DISTINCT template FROM signup_events), daily AS (SELECT date, template, COUNT(*) AS count FROM signup_events GROUP BY date, template) SELECT dates.date, templates.template, COALESCE(daily.count, 0) AS count FROM dates CROSS JOIN templates LEFT JOIN daily ON daily.date = dates.date AND daily.template = templates.template ORDER BY dates.date, templates.template`;
+export const SIGNUPS_OVER_TIME_SQL = `WITH digits AS (SELECT 0 AS n UNION ALL SELECT 1 UNION ALL SELECT 2 UNION ALL SELECT 3 UNION ALL SELECT 4 UNION ALL SELECT 5 UNION ALL SELECT 6 UNION ALL SELECT 7 UNION ALL SELECT 8 UNION ALL SELECT 9), offsets AS (SELECT ones.n + tens.n * 10 + hundreds.n * 100 AS n FROM digits ones CROSS JOIN digits tens CROSS JOIN digits hundreds WHERE hundreds.n < 8), signup_events AS (SELECT ${EVENT_DATE_SQL} AS date, ${TEMPLATE_EXPR} AS template FROM analytics_events WHERE event_name = 'signup' AND ${DASHBOARD_TIME_RANGE_FILTER} AND ${DASHBOARD_EMAIL_FILTER}), bounds AS (SELECT MIN(date::date) AS start_date, MAX(date::date) AS end_date FROM signup_events), dates AS (SELECT to_char(bounds.start_date + offsets.n, 'YYYY-MM-DD') AS date FROM bounds CROSS JOIN offsets WHERE bounds.start_date IS NOT NULL AND bounds.start_date + offsets.n <= bounds.end_date), templates AS (SELECT DISTINCT template FROM signup_events), daily AS (SELECT date, template, COUNT(*) AS count FROM signup_events GROUP BY date, template) SELECT dates.date, templates.template, COALESCE(daily.count, 0) AS count FROM dates CROSS JOIN templates LEFT JOIN daily ON daily.date = dates.date AND daily.template = templates.template ORDER BY dates.date, templates.template`;
 export const LEGACY_RETENTION_OVER_TIME_SQL = `WITH base AS (SELECT ${SIGNED_IN_ACTIVITY_KEY_SQL} AS user_key, ${EVENT_DATE_SQL} AS event_date, user_id FROM analytics_events WHERE ${SIGNED_IN_PRODUCT_ACTIVITY_FILTER} AND ${DASHBOARD_EMAIL_FILTER}), first_seen AS (SELECT user_key, MIN(event_date) AS cohort_date FROM base GROUP BY user_key), anchor_dates AS (SELECT DISTINCT cohort_date AS date FROM first_seen WHERE cohort_date <= ${daysAgoSql(14)} AND ${dashboardTimeRangeFilter("cohort_date")}), cohort_windows AS (SELECT a.date, f.user_key, f.cohort_date FROM anchor_dates a JOIN first_seen f ON f.cohort_date >= ${rollingWindowStartSql()} AND f.cohort_date <= a.date), cohort_sizes AS (SELECT date, COUNT(DISTINCT user_key) AS users FROM cohort_windows GROUP BY date), periods AS (SELECT '1-7d return' AS period UNION ALL SELECT '7-14d return' AS period), retained AS (SELECT cw.date, '1-7d return' AS period, COUNT(DISTINCT cw.user_key) AS retained FROM cohort_windows cw JOIN base b ON b.user_key = cw.user_key AND b.event_date > cw.cohort_date AND b.event_date <= to_char(cw.cohort_date::date + INTERVAL '7 days', 'YYYY-MM-DD') GROUP BY cw.date UNION ALL SELECT cw.date, '7-14d return' AS period, COUNT(DISTINCT cw.user_key) AS retained FROM cohort_windows cw JOIN base b ON b.user_key = cw.user_key AND b.event_date >= to_char(cw.cohort_date::date + INTERVAL '7 days', 'YYYY-MM-DD') AND b.event_date <= to_char(cw.cohort_date::date + INTERVAL '14 days', 'YYYY-MM-DD') GROUP BY cw.date) SELECT cs.date, p.period, COALESCE(r.retained, 0) AS retained_users, cs.users AS cohort_users, COALESCE(r.retained::float / NULLIF(cs.users, 0), 0) AS rate FROM cohort_sizes cs CROSS JOIN periods p LEFT JOIN retained r ON r.date = cs.date AND r.period = p.period WHERE cs.users >= ${RETENTION_MIN_COHORT_SIZE} ORDER BY cs.date, p.period`;
 export const LEGACY_ONE_DAY_RETENTION_BY_TEMPLATE_SQL = `WITH base AS (SELECT ${SIGNED_IN_ACTIVITY_KEY_SQL} AS user_key, ${TEMPLATE_EXPR} AS template, ${EVENT_DATE_SQL} AS event_date, user_id FROM analytics_events WHERE ${SIGNED_IN_ACTIVITY_FILTER} AND ${DASHBOARD_EMAIL_FILTER} AND ${KNOWN_PRODUCT_ACTIVITY_TEMPLATE_FILTER}), ranked_first_seen AS (SELECT user_key, template, event_date AS cohort_date, ROW_NUMBER() OVER (PARTITION BY user_key ORDER BY event_date, template) AS rn FROM base), first_seen AS (SELECT user_key, template, cohort_date FROM ranked_first_seen WHERE rn = 1), cohorts AS (SELECT user_key, template, cohort_date FROM first_seen WHERE cohort_date <= ${daysAgoSql(7)} AND ${dashboardTimeRangeFilter("cohort_date")}), cohort_sizes AS (SELECT template, COUNT(DISTINCT user_key) AS users FROM cohorts GROUP BY template), retained AS (SELECT c.template, COUNT(DISTINCT c.user_key) AS retained FROM cohorts c JOIN base b ON b.user_key = c.user_key AND b.event_date > c.cohort_date AND b.event_date <= to_char(c.cohort_date::date + INTERVAL '7 days', 'YYYY-MM-DD') GROUP BY c.template) SELECT cs.template, COALESCE(r.retained, 0) AS retained_users, cs.users AS cohort_users, COALESCE(r.retained::float / NULLIF(cs.users, 0), 0) AS rate FROM cohort_sizes cs LEFT JOIN retained r ON r.template = cs.template WHERE cs.users >= ${PER_TEMPLATE_RETENTION_MIN_COHORT_SIZE} ORDER BY rate DESC, cs.users DESC, cs.template`;
 export const LEGACY_SEVEN_DAY_RETENTION_BY_TEMPLATE_SQL = `WITH base AS (SELECT ${SIGNED_IN_ACTIVITY_KEY_SQL} AS user_key, ${TEMPLATE_EXPR} AS template, ${EVENT_DATE_SQL} AS event_date, user_id FROM analytics_events WHERE ${SIGNED_IN_ACTIVITY_FILTER} AND ${DASHBOARD_EMAIL_FILTER} AND ${KNOWN_PRODUCT_ACTIVITY_TEMPLATE_FILTER}), ranked_first_seen AS (SELECT user_key, template, event_date AS cohort_date, ROW_NUMBER() OVER (PARTITION BY user_key ORDER BY event_date, template) AS rn FROM base), first_seen AS (SELECT user_key, template, cohort_date FROM ranked_first_seen WHERE rn = 1), cohorts AS (SELECT user_key, template, cohort_date FROM first_seen WHERE cohort_date <= ${daysAgoSql(14)} AND ${dashboardTimeRangeFilter("cohort_date")}), cohort_sizes AS (SELECT template, COUNT(DISTINCT user_key) AS users FROM cohorts GROUP BY template), retained AS (SELECT c.template, COUNT(DISTINCT c.user_key) AS retained FROM cohorts c JOIN base b ON b.user_key = c.user_key AND b.event_date >= to_char(c.cohort_date::date + INTERVAL '7 days', 'YYYY-MM-DD') AND b.event_date <= to_char(c.cohort_date::date + INTERVAL '14 days', 'YYYY-MM-DD') GROUP BY c.template) SELECT cs.template, COALESCE(r.retained, 0) AS retained_users, cs.users AS cohort_users, COALESCE(r.retained::float / NULLIF(cs.users, 0), 0) AS rate FROM cohort_sizes cs LEFT JOIN retained r ON r.template = cs.template WHERE cs.users >= ${PER_TEMPLATE_RETENTION_MIN_COHORT_SIZE} ORDER BY rate DESC, cs.users DESC, cs.template`;