@agent-native/core 0.99.0 → 0.99.2

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

@@ -249,32 +249,40 @@
    The recorded visitor cursor is a core session-replay affordance: users need
    to see the Mac-style arrow where the visitor clicked, including on dark
    recordings. rrweb's bundled cursor is a small black sprite that disappears
-   against those pages. This high-contrast arrow stays inside the replayer
-   wrapper and scales with the fit-to-stage transform. */
+   against those pages. Use the normal black Mac cursor with its white outline;
+   the small shadow below keeps it legible on either background. */
 .an-replay-stage-root .replayer-mouse {
   position: absolute;
   z-index: 2;
-  width: 1.125rem;
-  height: 1.5rem;
+  /* Render at 2x locally, then downscale to the compact 0.72rem x 0.96rem
+     screen size. This keeps the small cursor's rounded outline smooth. */
+  width: 1.44rem;
+  height: 1.92rem;
   border-radius: 0;
   background: transparent;
   background-image: none;
   box-shadow: none;
-  transform: none;
+  visibility: hidden;
+  /* The stage is fit-to-container, but the recorded cursor should stay at a
+     normal on-screen size. The stage supplies the inverse scale variable. */
+  transform: scale(calc(var(--an-replay-cursor-scale, 1) * 0.5));
+  transform-origin: top left;
   transition:
     left 80ms linear,
     top 80ms linear;
   pointer-events: none;
 }
 
+.an-replay-stage-root .replayer-mouse.has-position {
+  visibility: visible;
+}
+
 .an-replay-stage-root .replayer-mouse::before {
   content: "";
   position: absolute;
   inset: 0;
-  background: hsl(0 0% 100%);
-  clip-path: polygon(0 0, 0 77%, 30% 57%, 48% 100%, 68% 92%, 50% 51%, 92% 51%);
-  filter: drop-shadow(0 0 1px hsl(0 0% 0% / 0.95))
-    drop-shadow(0 1px 3px hsl(0 0% 0% / 0.35));
+  background: url("./assets/replay-cursor.svg") center / contain no-repeat;
+  filter: drop-shadow(0 1px 1px hsl(0 0% 0% / 0.4));
 }
 
 .an-replay-stage-root .replayer-mouse::after {

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

@@ -41,6 +41,12 @@ function daysAgo(n: number): string {
   return d.toISOString().slice(0, 10);
 }
 
+// Keep the legacy "all" date-range sentinel out of provider queries. Analytics
+// data cannot predate the Unix epoch, so this is equivalent to an unbounded
+// lower date while remaining valid for BigQuery DATE/TIMESTAMP expressions.
+const ALL_TIME_START = "1970-01-01";
+const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+
 /** Date-valued filters whose default may use the "Nd" / "today" shorthand. */
 const DATE_FILTER_TYPES: ReadonlySet<FilterType> = new Set([
   "date",
@@ -70,6 +76,18 @@ function resolveDefault(raw: string | undefined, type: FilterType): string {
   return raw;
 }
 
+function resolveDateValue(
+  raw: string | undefined,
+  allTimeValue: string,
+): string {
+  const value = raw?.trim();
+  if (!value) return "";
+  if (value.toLowerCase() === "all") return allTimeValue;
+
+  const resolved = resolveDefault(value, "date");
+  return ISO_DATE_RE.test(resolved) ? resolved : "";
+}
+
 export function resolveFilterVars(
   filters: DashboardFilter[],
   getParam: (key: string) => string,
@@ -79,17 +97,27 @@ export function resolveFilterVars(
     if (f.type === "date-range") {
       const startKey = `${f.id}Start`;
       const endKey = `${f.id}End`;
-      out[startKey] = getParam(startKey) || resolveDefault(f.default, f.type);
-      out[endKey] = getParam(endKey) || daysAgo(0);
+      out[startKey] =
+        resolveDateValue(getParam(startKey), ALL_TIME_START) ||
+        resolveDateValue(resolveDefault(f.default, f.type), ALL_TIME_START);
+      out[endKey] =
+        resolveDateValue(getParam(endKey), daysAgo(0)) || daysAgo(0);
     } else if (f.type === "toggle" || f.type === "toggle-date") {
       // Toggles have no "off value" default — if the user hasn't opted in
       // via the URL, the SQL-side conditional block ({{?id}}...{{/id}})
       // must see an empty value so it doesn't emit. Otherwise the filter
       // looks "off" in the UI but still filters the data.
-      out[f.id] = getParam(f.id);
+      out[f.id] =
+        f.type === "toggle-date"
+          ? resolveDateValue(getParam(f.id), ALL_TIME_START)
+          : getParam(f.id);
     } else {
       const v = getParam(f.id);
-      out[f.id] = v || resolveDefault(f.default, f.type);
+      out[f.id] =
+        f.type === "date"
+          ? resolveDateValue(v, ALL_TIME_START) ||
+            resolveDateValue(resolveDefault(f.default, f.type), ALL_TIME_START)
+          : v || resolveDefault(f.default, f.type);
     }
   }
   return out;

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

@@ -297,7 +297,10 @@ const PanelCell = memo(function PanelCell({
     [panel, vars],
   );
   const resolvedSql = useMemo(
-    () => interpolate(serializePanelSql(panel.sql), vars),
+    () =>
+      interpolate(serializePanelSql(panel.sql), vars, {
+        failClosedTimeVariables: true,
+      }),
     [panel.sql, vars],
   );
   const handleSelectForChat = useCallback(

package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/interpolate.ts

@@ -14,9 +14,23 @@ function escapeSqlValue(value: string): string {
   return value.replace(/'/g, "''");
 }
 
+export interface InterpolateOptions {
+  /**
+   * Replace missing/empty time variables with a value that cannot satisfy the
+   * canonical dashboard predicates. This keeps a stale or malformed panel
+   * fail-closed at render time instead of turning into an all-time query.
+   */
+  failClosedTimeVariables?: boolean;
+}
+
+function isTimeVariable(name: string): boolean {
+  return name === "timeRange" || /(?:Start|End)$/.test(name);
+}
+
 export function interpolate(
   sql: string | undefined | null,
   vars: Record<string, string> = {},
+  options: InterpolateOptions = {},
 ): string {
   // Defensive: a malformed dashboard config (e.g. agent wrote a panel without
   // a `sql` field) should not crash the page. Treat missing/non-string SQL
@@ -33,6 +47,13 @@ export function interpolate(
 
   return withConditionals.replace(/\{\{(\w+)\}\}/g, (_match, name) => {
     const value = vars[name];
+    if (
+      options.failClosedTimeVariables &&
+      isTimeVariable(name) &&
+      (value == null || value.length === 0)
+    ) {
+      return "__missing_dashboard_time_filter__";
+    }
     if (value == null) return "";
     return escapeSqlValue(String(value));
   });

package/corpus/templates/analytics/app/pages/adhoc/sql-dashboard/types.ts

@@ -63,7 +63,21 @@ export interface PivotConfig {
   valueKey: string;
 }
 
+/**
+ * Declares how a query's time coverage relates to the dashboard filter.
+ * `dashboard` is the default for ordinary event metrics; the other values are
+ * explicit exceptions that make intentional history scans visible to agents
+ * and reviewers.
+ */
+export type DashboardTimeScope =
+  | "dashboard"
+  | "fixed-window"
+  | "cohort-history"
+  | "all-time";
+
 export interface SqlPanelConfig {
+  /** Time coverage contract for first-party SQL panels. */
+  timeScope?: DashboardTimeScope;
   xKey?: string;
   yKey?: string;
   yKeys?: string[];

package/corpus/templates/analytics/app/pages/monitoring/errors/IssueDetail.tsx

@@ -102,7 +102,7 @@ export function IssueDetail({
                   {statusLabel(issue.status)}
                 </span>
               </div>
-              <h2 className="truncate text-lg font-semibold text-foreground">
+              <h2 className="break-words text-lg font-semibold text-foreground">
                 {issue.title}
               </h2>
               {issue.culprit ? (

package/corpus/templates/analytics/app/pages/sessions/SessionDetailPage.tsx

@@ -34,6 +34,7 @@ import {
 } from "@tabler/icons-react";
 import { useQuery } from "@tanstack/react-query";
 import {
+  type CSSProperties,
   type ReactNode,
   useCallback,
   useEffect,
@@ -46,6 +47,13 @@ import { Link, useParams } from "react-router";
 
 import { Button } from "@/components/ui/button";
 import { Card, CardContent } from "@/components/ui/card";
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuRadioGroup,
+  DropdownMenuRadioItem,
+  DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
 import { Input } from "@/components/ui/input";
 import {
   Popover,
@@ -711,6 +719,7 @@ function ReplayPlayer({
     if (!stageRootRef.current) return;
     let cancelled = false;
     let localReplayer: any = null;
+    let stopCursorVisibilityObserver = () => {};
 
     async function loadReplay() {
       const replayEvents = eventsRef.current;
@@ -761,6 +770,8 @@ function ReplayPlayer({
       // Do not mutate recorded URLs/CSS; suppress viewer-page referrer leakage
       // at the iframe boundary while retaining historical visual resources.
       localReplayer.iframe?.setAttribute?.("referrerpolicy", "no-referrer");
+      stopCursorVisibilityObserver =
+        hideReplayCursorUntilPosition(localReplayer);
       replayerRef.current = localReplayer;
       const meta = localReplayer.getMetaData?.();
       const total = Number(meta?.totalTime ?? replayDuration(replayEvents));
@@ -827,6 +838,7 @@ function ReplayPlayer({
 
     return () => {
       cancelled = true;
+      stopCursorVisibilityObserver();
       if (rafRef.current != null) cancelAnimationFrame(rafRef.current);
       rafRef.current = null;
       try {
@@ -977,22 +989,26 @@ function ReplayPlayer({
                 <div
                   ref={stageRootRef}
                   className="an-replay-stage-root absolute left-1/2 top-1/2"
-                  style={{
-                    width: playerWidth,
-                    height: playerHeight,
-                    transform: `translate(-50%, -50%) scale(${fitScale})`,
-                    transformOrigin: "center center",
-                  }}
+                  style={
+                    {
+                      width: playerWidth,
+                      height: playerHeight,
+                      "--an-replay-cursor-scale": String(1 / fitScale),
+                      transform: `translate(-50%, -50%) scale(${fitScale})`,
+                      transformOrigin: "center center",
+                    } as CSSProperties
+                  }
                 />
                 <button
                   type="button"
                   className={cn(
                     "absolute inset-0 z-20 rounded-[inherit] border-0 bg-transparent p-0 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:cursor-default",
-                    // INTENTIONAL — DO NOT REMOVE `cursor-none` while playing.
-                    // The recorded cursor is the meaningful pointer here;
-                    // hiding the viewer's stationary pointer keeps the
-                    // Mac-style replay cursor easy to follow.
-                    playing ? "cursor-none" : "cursor-pointer",
+                    // INTENTIONAL — KEEP THE VIEWER CURSOR VISIBLE.
+                    // The recorded cursor is a separate overlay, while this
+                    // button owns the live hover target for pause/play. Do
+                    // not add `cursor-none`: it makes the user's cursor
+                    // disappear when they move over the preview.
+                    "cursor-pointer",
                   )}
                   disabled={disabled}
                   aria-label={
@@ -1078,22 +1094,34 @@ function ReplayPlayer({
                 {formatClock(totalTime)}
               </span>
 
-              <div className="flex items-center rounded-md bg-muted p-1">
-                {SPEED_OPTIONS.map((option) => (
+              <DropdownMenu>
+                <DropdownMenuTrigger asChild>
                   <button
-                    key={option}
                     type="button"
-                    className={cn(
-                      "rounded px-2 py-1 text-xs font-medium text-muted-foreground transition-colors hover:text-foreground",
-                      speed === option &&
-                        "bg-background text-foreground shadow-sm",
-                    )}
-                    onClick={() => updateSpeed(option)}
+                    disabled={disabled}
+                    aria-label={`${speed}x`}
+                    className="inline-flex h-8 min-w-11 items-center justify-center rounded-md border px-2 text-xs font-medium tabular-nums transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50"
                   >
-                    {option}x
+                    {speed}x
                   </button>
-                ))}
-              </div>
+                </DropdownMenuTrigger>
+                <DropdownMenuContent align="center" side="top">
+                  <DropdownMenuRadioGroup
+                    value={String(speed)}
+                    onValueChange={(value) => updateSpeed(Number(value))}
+                  >
+                    {SPEED_OPTIONS.map((option) => (
+                      <DropdownMenuRadioItem
+                        key={option}
+                        value={String(option)}
+                        className="tabular-nums"
+                      >
+                        {option}x
+                      </DropdownMenuRadioItem>
+                    ))}
+                  </DropdownMenuRadioGroup>
+                </DropdownMenuContent>
+              </DropdownMenu>
 
               <Tooltip>
                 <TooltipTrigger asChild>
@@ -2278,6 +2306,32 @@ function hasPlayableReplayEvents(events: unknown[]): boolean {
   return false;
 }
 
+function hideReplayCursorUntilPosition(replayer: any): () => void {
+  const cursor = replayer?.mouse as HTMLElement | undefined;
+  if (!cursor || typeof MutationObserver === "undefined") return () => {};
+
+  let observer: MutationObserver | null = null;
+  const revealWhenPositioned = () => {
+    if (!cursor.style.left || !cursor.style.top) return;
+    cursor.classList.add("has-position");
+    observer?.disconnect();
+    observer = null;
+  };
+
+  cursor.classList.remove("has-position");
+  observer = new MutationObserver(revealWhenPositioned);
+  observer.observe(cursor, {
+    attributes: true,
+    attributeFilter: ["style"],
+  });
+  revealWhenPositioned();
+
+  return () => {
+    observer?.disconnect();
+    observer = null;
+  };
+}
+
 export function replayViewportDimensions(
   events: AnyReplayEvent[],
 ): ReplayViewportDimensions | null {

package/corpus/templates/analytics/app/pages/sessions/SessionsPage.tsx

@@ -22,7 +22,7 @@ import {
 } from "@tabler/icons-react";
 import { useQuery } from "@tanstack/react-query";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
-import { Link, useNavigate, useSearchParams } from "react-router";
+import { Link, useSearchParams } from "react-router";
 import { toast } from "sonner";
 
 import { Badge } from "@/components/ui/badge";
@@ -205,7 +205,6 @@ export function useDebouncedUrlFilter(
 
 export default function SessionsPage() {
   const t = useT();
-  const navigate = useNavigate();
   const [searchParams, setSearchParams] = useSearchParams();
   const range = readRange(searchParams.get("range"));
   const app = searchParams.get("app") ?? "";
@@ -389,11 +388,10 @@ export default function SessionsPage() {
                     recording.startedAt;
                   const deviceLabel = sessionDeviceLabel(recording);
                   return (
-                    <button
+                    <Link
                       key={recording.id}
-                      type="button"
+                      to={href}
                       className="analytics-session-row grid w-full gap-3 px-4 py-3 text-left transition-colors hover:bg-muted/35 focus-visible:bg-muted/35 focus-visible:outline-none"
-                      onClick={() => navigate(href)}
                       aria-label={t("sessions.watchReplay")}
                     >
                       <span className="inline-flex h-10 w-[92px] items-center justify-center gap-2 rounded-md bg-primary/10 font-medium text-primary">
@@ -446,7 +444,7 @@ export default function SessionsPage() {
                           </span>
                         ) : null}
                       </span>
-                    </button>
+                    </Link>
                   );
                 })}
               </div>

package/corpus/templates/analytics/changelog/2026-07-13-all-time-dashboard-filters-no-longer-send-invalid-dates-to-b.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-13
+---
+
+All-time dashboard filters no longer send invalid dates to BigQuery

package/corpus/templates/analytics/changelog/2026-07-13-dashboard-charts-now-honor-the-selected-time-range-by-defaul.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-13
+---
+
+Dashboard charts now honor the selected time range by default and reject accidental unbounded first-party queries

package/corpus/templates/analytics/changelog/2026-07-13-error-issue-titles-wrap-instead-of-overflowing.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-13
+---
+
+Error issue titles wrap instead of overflowing

package/corpus/templates/analytics/changelog/2026-07-13-keep-real-authorized-identities-in-analytics-incident-lookup.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-13
+---
+
+Keep real authorized identities in Analytics incident lookups when browser Demo mode is enabled

package/corpus/templates/analytics/changelog/2026-07-13-saving-a-new-dashboard-view-no-longer-fails-with-a-server-er.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-13
+---
+
+Saving a new dashboard view no longer fails with a server error

package/corpus/templates/analytics/changelog/2026-07-13-session-replay-cursors-stay-hidden-until-their-first-recorde.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-13
+---
+
+Session replay cursors stay hidden until their first recorded position

package/corpus/templates/analytics/changelog/2026-07-13-session-replay-links-now-support-cmd-click-and-middle-click-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-13
+---
+
+Session replay links now support Cmd-click and middle-click to open in a new tab

package/corpus/templates/analytics/changelog/2026-07-13-the-analytics-agents-tab-is-available-again-from-the-main-na.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-13
+---
+
+The Analytics Agents tab is available again from the main navigation.

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

@@ -226,7 +226,7 @@
       "chartType": "bar",
       "source": "first-party",
       "width": 2,
-      "sql": "SELECT COALESCE(NULLIF(app, ''), 'unknown') AS app, COUNT(*) AS count FROM analytics_events WHERE event_name = 'session status' GROUP BY COALESCE(NULLIF(app, ''), 'unknown') ORDER BY count DESC LIMIT 20",
+      "sql": "SELECT COALESCE(NULLIF(app, ''), 'unknown') AS app, COUNT(*) AS count FROM analytics_events WHERE event_name = 'session status' 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')) GROUP BY COALESCE(NULLIF(app, ''), 'unknown') ORDER BY count DESC LIMIT 20",
       "config": {
         "xKey": "app",
         "yKey": "count",
@@ -240,7 +240,7 @@
       "chartType": "bar",
       "source": "first-party",
       "width": 1,
-      "sql": "SELECT COALESCE(NULLIF(signed_in, ''), 'unknown') AS signed_in, COUNT(*) AS count FROM analytics_events WHERE event_name = 'session status' GROUP BY COALESCE(NULLIF(signed_in, ''), 'unknown') ORDER BY signed_in",
+      "sql": "SELECT COALESCE(NULLIF(signed_in, ''), 'unknown') AS signed_in, COUNT(*) AS count FROM analytics_events WHERE event_name = 'session status' 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')) GROUP BY COALESCE(NULLIF(signed_in, ''), 'unknown') ORDER BY signed_in",
       "config": {
         "xKey": "signed_in",
         "yKey": "count",
@@ -254,7 +254,7 @@
       "chartType": "area",
       "source": "first-party",
       "width": 1,
-      "sql": "SELECT event_date AS date, COUNT(*) AS count FROM analytics_events WHERE event_name = 'session status' GROUP BY event_date ORDER BY date",
+      "sql": "SELECT event_date AS date, COUNT(*) AS count FROM analytics_events WHERE event_name = 'session status' 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')) GROUP BY event_date ORDER BY date",
       "config": {
         "xKey": "date",
         "yKey": "count",

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

@@ -56,6 +56,10 @@ function panelSummaries(config: Record<string, unknown>) {
       width: typeof panel.width === "number" ? panel.width : undefined,
       columns: typeof panel.columns === "number" ? panel.columns : undefined,
       tab: typeof panel.tab === "string" ? panel.tab : undefined,
+      timeScope:
+        typeof panelConfig.timeScope === "string"
+          ? panelConfig.timeScope
+          : undefined,
       description:
         typeof panelConfig.description === "string"
           ? panelConfig.description