@agent-native/core-corpus 0.205.0 → 0.206.0-nightly-20261009011246

package/corpus/README.md

@@ -32,4 +32,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core-corpus/corpu
 
 ## Generated Counts
 
-- template files: 11555
+- template files: 11622

package/corpus/templates/analytics/.agents/skills/data-querying/SKILL.md

@@ -85,7 +85,7 @@ Useful `properties`:
 - Time: `duration_ms` is the full run in milliseconds; `$ai_latency` is model time in seconds (run minus tool time).
 - Tools: `tool_calls`, `successful_tools`, `failed_tools`, `tools`, `tools_truncated`. The bounded `tools` array holds names, relative start times, durations, statuses, and coarse error classes, never args or results; failed runs and interrupted tools stay queryable.
 - Delegation: `delegated`, `delegation_protocol`, `caller_app`, `delegation_task_id`, `a2a_task_id`, `parent_run_id`, `parent_turn_id`. Agent Teams child runs use `delegation_protocol = 'agent-team'`, keep their own `run_id`, and link to the launching run through `parent_run_id`.
-- Errors: `status`, `error_message`/`$ai_error`.
+- Errors: `status`, `$ai_error` (terminal code, cause, retryable, and a fixed code-derived message), `$ai_error_type`. Run failure messages are omitted from telemetry.
 
 ## Inline Charts In Chat
 

package/corpus/templates/analytics/.agents/skills/onboarding-journeys/SKILL.md

@@ -2,9 +2,9 @@
 name: onboarding-journeys
 description: >-
   Build the onboarding journey tree (signup to first output, with % splits,
-  drop-off per step, and example replays) and render a screenshot per step. Use
-  when asked for an onboarding storyboard, where new users drop off, or frames
-  for each onboarding step.
+  last-observed-step counts, and example replays) and render a screenshot per
+  step. Use when asked for an onboarding storyboard, where users stop being
+  observed, or frames for each onboarding step.
 scope: dev
 ---
 
@@ -38,7 +38,9 @@ type JourneyTree = { window: { from: string; to: string }; app: string; rootN: n
 ```
 
 - Nodes come parents first. `key` is the path of step keys joined with ` > `;
-  `pctOf*` are percents (0-100).
+  `pctOf*` are percents (0-100). `dropoffN` / `dropoffPct` count sessions
+  whose last observed step is this node; they do not establish that a user
+  exited.
 - `dropoffN` is sessions whose last observed step is that node. It is not a
   confirmed exit: a blocked tracker or an event outside the window reads the
   same. A node at `maxDepth` where `n - dropoffN - sum(children n)` is above
@@ -51,18 +53,30 @@ type JourneyTree = { window: { from: string; to: string }; app: string; rootN: n
 - An example with `recordingId: null` has no replay the caller can open, and
   `viewportReason` says why the viewport is unknown (`no_recording`,
   `not_captured` for recordings before viewport capture, `unreadable`).
+- `offsetMs` is milliseconds from the recording's `startedAt`, not the first
+  rrweb event.
+- `replayUrl` uses that same offset in `atMs`; the session page converts it to
+  the first-event-relative player clock after replay events load.
 - Test identities are always excluded; `emailFilter` defaults to
   `exclude_builder`, as in the onboarding metrics. A session with any excluded
   identity is dropped whole.
 
 ## Capture
 
-The CLI mints a two-hour tokenized replay link per recording with
-`create-session-replay-agent-link`, opens each recording once in headless
-Chromium at `/sessions/:id?frame=1&agent_access=...`, seeks to each `offsetMs`,
-and uses the Sessions screenshot compositor. It writes `<nodeKey>-<n>.png` and
-`manifest.json` with `frames`, `failures` (explicit, with a reason), and
-`skipped`. Fix failures or report them; do not paint over a missing frame.
+The CLI mints a two-hour recording-scoped replay link with
+`create-session-replay-agent-link`, reads the token-gated manifest and every
+chunk, then renders each recording once with the local `@rrweb/replay` player
+in headless Chromium. Each JourneyTree `offsetMs` is relative to the recording's
+`startedAt`; the CLI maps `startedAt + offsetMs` to rrweb's first-event-relative
+playhead for seeking, viewport, and route evaluation while preserving the
+original offset in frame metadata. If the target precedes the first replay
+event, report a frame failure instead of clamping the seek to zero. The CLI
+uses a native browser screenshot so dialogs and other top-layer content remain
+visible. The token and replay events stay in memory; the CLI writes only PNGs
+and `manifest.json` with `frames`, `failures` (explicit, with a reason), and
+`skipped`. Manifest chunk counts and ordering must be complete; the CLI reads
+bounded batches only through the requested offsets and validates every fetched
+chunk. Fix failures or report them; do not paint over a missing frame.
 
 Authenticate to the deployed app, never a local database: run
 `npx -y @agent-native/core@latest connect https://analytics.agent-native.com --client codex`
@@ -70,9 +84,12 @@ Authenticate to the deployed app, never a local database: run
 `--token` / set `AGENT_NATIVE_TOKEN`. `--app-url` overrides the app. Frame mode
 needs a deployment that includes `/sessions/:id?frame=1`.
 
-Frame mode renders without a login; the signed link is the only credential. It
-masks and scrubs exactly as the Sessions viewer does. Do not add viewport
-clamping or pointer projection to it (see `session-replay`).
+Replay fetches use the recording-scoped token without app cookies or a referrer.
+The capture browser stays offline while rendering untrusted replay DOM, so
+remote images and fonts are not fetched. The output manifest marks this as
+`remoteAssets: "not-fetched"`. Keep recorded URLs and CSS intact for rrweb
+playback; network controls belong at the capture boundary. `--upload` stores
+PNGs through the private upload action, which checks recording access again.
 
 Viewport comes from the recording's first rrweb Meta event, stored by replay
 ingest in `session_recordings.metadata.viewport` (`first` and `last`). Older

package/corpus/templates/analytics/.agents/skills/session-replay/SKILL.md

@@ -447,6 +447,16 @@ agent answers about browser recordings in the Analytics template.
   Vite/Netlify env vars on the recorded site.
 - Inputs are masked by default. Page text is visible unless marked with
   `.an-mask` or `data-an-mask`.
+- UI rendering a run failure message or diagnostic details spreads
+  `SESSION_REPLAY_MASK_PROPS` from `@agent-native/core/client/session-replay-privacy` on
+  the message element, including expanded details and failed tool rows. Keep
+  headlines and recovery controls outside the mask. The `data-an-mask` marker
+  remains active when an app supplies its own `maskTextSelector`; selectors
+  extend this privacy baseline. Do not rely on name redaction for run errors.
+  Masking covers text only; the recorder keeps attributes, so leave `title` off
+  masked failure text. Wrap failed content that can render links or embedded
+  frames, such as an MCP App or a failed activity summary, in
+  `SESSION_REPLAY_BLOCK_PROPS`.
 - Use `.an-block`, `.an-ignore`, `data-an-block`, or `data-an-ignore` for
   sensitive zones that should not be captured.
 - A definitive upload `409` abandons only the conflicted replay identity and

package/corpus/templates/analytics/actions/get-onboarding-journey.ts

@@ -33,7 +33,7 @@ const isoDate = z
 
 export default defineAction({
   description:
-    'Build the onboarding journey tree for a date window: per-session step sequences (signup, onboarding questions, setup method, app entry, first action, first output) folded into a prefix tree. format "tree" returns { window, app, rootN, coverage, nodes }: each node has n, pctOfRoot, pctOfParent, dropoffN/dropoffPct (sessions whose last observed step is that node, not a confirmed exit) and example sessions with recordingId, offsetMs to seek to, and the recording\'s viewport. format "summary" returns the same counts as an indented text outline with no examples. Check coverage.truncated first: true means counts are a partial sample or the node list was cut (see notes). Use it to plan onboarding storyboards or find where new users stop; feed the tree to the journey:capture CLI to render frames.',
+    'Build the onboarding journey tree for a date window: per-session step sequences (signup, onboarding questions, setup method, app entry, first action, first output) folded into a prefix tree. format "tree" returns { window, app, rootN, coverage, nodes }: each node has n, pctOfRoot, pctOfParent, dropoffN/dropoffPct (sessions whose last observed step is that node, not a confirmed exit) and example sessions with recordingId, a recording-start-relative offsetMs to seek to, and the recording\'s viewport. format "summary" returns the same counts as an indented text outline with no examples. Check coverage.truncated first: true means counts are a partial sample or the node list was cut (see notes). Use it to plan onboarding storyboards or find where new users stop; feed the tree to the journey:capture CLI to render frames.',
   schema: z.object({
     dateFrom: isoDate.describe(
       "Inclusive UTC start date, YYYY-MM-DD. Sessions that began earlier appear mid-journey, so start a day before the period you care about.",

package/corpus/templates/analytics/app/i18n/en-US.ts

@@ -1568,6 +1568,8 @@ export default {
     replayPlayer: "Replay player",
     replayLoading: "Loading replay...",
     replayLoadingProgress: "{{loaded}} of {{total}} replay chunks loaded",
+    replayTargetFallback:
+      "Requested recording offset {{requested}} is unavailable; showing the nearest replay frame at {{available}}.",
     replayUnavailable: "No playable replay for this session",
     replayUnavailableDescription:
       "This recording has metadata, but no playable replay events were found.",

package/corpus/templates/analytics/app/pages/adhoc/explorer-dashboard/ChartCard.tsx

@@ -149,7 +149,7 @@ export function DashboardChartCard({
       if (
         target instanceof Element &&
         target.closest(
-          "button, a, input, textarea, select, [role='menuitem'], [data-no-panel-chat-select]",
+          "button, a, input, textarea, select, [role='menuitem'], [role='menuitemradio'], [data-no-panel-chat-select]",
         )
       ) {
         return;

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

@@ -30,6 +30,7 @@ import {
   AlertDialogHeader,
   AlertDialogTitle,
 } from "@/components/ui/alert-dialog";
+import { Badge } from "@/components/ui/badge";
 import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
 import {
   Dialog,
@@ -42,16 +43,14 @@ import {
   DropdownMenuContent,
   DropdownMenuItem,
   DropdownMenuLabel,
+  DropdownMenuRadioGroup,
+  DropdownMenuRadioItem,
   DropdownMenuSeparator,
+  DropdownMenuSub,
+  DropdownMenuSubContent,
+  DropdownMenuSubTrigger,
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
-import {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue,
-} from "@/components/ui/select";
 import {
   Tooltip,
   TooltipContent,
@@ -150,6 +149,9 @@ export function SqlChartCard({
 }: SqlChartCardProps) {
   const t = useT();
   const timeRange = timeRangeDays(filters?.timeRange);
+  const timeRangeOverrideLabel = timeRangeFilter?.options?.find(
+    (option) => option.value === timeRangeOverride,
+  )?.label;
   const exportToGoogleSheets = useActionMutation(
     "export-dashboard-panel-to-google-sheet",
   );
@@ -263,7 +265,7 @@ export function SqlChartCard({
       if (
         target instanceof Element &&
         target.closest(
-          "button, a, input, textarea, select, [role='menuitem'], [data-no-panel-chat-select]",
+          "button, a, input, textarea, select, [role='menuitem'], [role='menuitemradio'], [data-no-panel-chat-select]",
         )
       ) {
         return;
@@ -606,44 +608,17 @@ export function SqlChartCard({
           <CardTitle className="text-sm font-medium flex-1 truncate">
             {panel.title}
           </CardTitle>
-          {timeRangeFilter?.options?.length ? (
-            <Tooltip>
-              <TooltipTrigger asChild>
-                <Select
-                  value={timeRangeOverride ?? INHERIT_TIME_RANGE}
-                  onValueChange={(value) =>
-                    onTimeRangeOverrideChange?.(
-                      value === INHERIT_TIME_RANGE ? null : value,
-                    )
-                  }
-                >
-                  <SelectTrigger
-                    size="sm"
-                    className="h-6 w-[100px] text-xs"
-                    aria-label={t("sqlDashboard.chartTimeRangeOverride")}
-                  >
-                    <SelectValue />
-                  </SelectTrigger>
-                  <SelectContent align="end">
-                    <SelectItem value={INHERIT_TIME_RANGE} className="text-xs">
-                      {t("sqlDashboard.chartTimeRangeInherit")}
-                    </SelectItem>
-                    {timeRangeFilter.options.map((opt) => (
-                      <SelectItem
-                        key={opt.value}
-                        value={opt.value}
-                        className="text-xs"
-                      >
-                        {opt.label}
-                      </SelectItem>
-                    ))}
-                  </SelectContent>
-                </Select>
-              </TooltipTrigger>
-              <TooltipContent>
-                {t("sqlDashboard.chartTimeRangeOverride")}
-              </TooltipContent>
-            </Tooltip>
+          {timeRangeOverrideLabel ? (
+            <Badge
+              variant="secondary"
+              className="max-w-32 shrink-0 truncate px-1.5 py-0 text-[10px] font-normal"
+              title={timeRangeOverrideLabel}
+            >
+              <span className="sr-only">
+                {t("sqlDashboard.chartTimeRangeOverride")}{" "}
+              </span>
+              {timeRangeOverrideLabel}
+            </Badge>
           ) : null}
           <div className="flex items-center gap-1 opacity-0 transition-opacity group-hover:opacity-100 focus-within:opacity-100">
             {!editable || onSaveSql ? (
@@ -689,6 +664,35 @@ export function SqlChartCard({
                     {t("sqlDashboard.chatWithPanel")}
                   </DropdownMenuItem>
                   <DropdownMenuSeparator />
+                  {timeRangeFilter?.options?.length ? (
+                    <DropdownMenuSub>
+                      <DropdownMenuSubTrigger>
+                        {timeRangeFilter.label}
+                      </DropdownMenuSubTrigger>
+                      <DropdownMenuSubContent className="w-52">
+                        <DropdownMenuRadioGroup
+                          value={timeRangeOverride ?? INHERIT_TIME_RANGE}
+                          onValueChange={(value) =>
+                            onTimeRangeOverrideChange?.(
+                              value === INHERIT_TIME_RANGE ? null : value,
+                            )
+                          }
+                        >
+                          <DropdownMenuRadioItem value={INHERIT_TIME_RANGE}>
+                            {t("sqlDashboard.chartTimeRangeInherit")}
+                          </DropdownMenuRadioItem>
+                          {timeRangeFilter.options.map((opt) => (
+                            <DropdownMenuRadioItem
+                              key={opt.value}
+                              value={opt.value}
+                            >
+                              {opt.label}
+                            </DropdownMenuRadioItem>
+                          ))}
+                        </DropdownMenuRadioGroup>
+                      </DropdownMenuSubContent>
+                    </DropdownMenuSub>
+                  ) : null}
                   <DropdownMenuItem onSelect={() => setExpanded(true)}>
                     <IconMaximize className="h-4 w-4 mr-2" />
                     {t("sqlDashboard.fullScreen")}

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

@@ -301,10 +301,22 @@ const PanelCell = memo(function PanelCell({
   const [timeRangeOverride, setTimeRangeOverride] = useState<string | null>(
     null,
   );
+  const validTimeRangeOverride = timeRangeFilter?.options?.some(
+    (option) => option.value === timeRangeOverride,
+  )
+    ? timeRangeOverride
+    : null;
+  useEffect(() => {
+    if (timeRangeOverride !== null && validTimeRangeOverride === null) {
+      setTimeRangeOverride(null);
+    }
+  }, [timeRangeOverride, validTimeRangeOverride]);
   const effectiveVars = useMemo(
     () =>
-      timeRangeOverride ? { ...vars, timeRange: timeRangeOverride } : vars,
-    [vars, timeRangeOverride],
+      validTimeRangeOverride
+        ? { ...vars, timeRange: validTimeRangeOverride }
+        : vars,
+    [vars, validTimeRangeOverride],
   );
   const resolved = useMemo(
     () =>
@@ -395,7 +407,7 @@ const PanelCell = memo(function PanelCell({
         }
         filters={effectiveVars}
         timeRangeFilter={timeRangeFilter}
-        timeRangeOverride={timeRangeOverride}
+        timeRangeOverride={validTimeRangeOverride}
         onTimeRangeOverrideChange={setTimeRangeOverride}
         extensionContext={
           panel.chartType === "extension"