@agent-native/core 0.80.10 → 0.81.0

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

@@ -110,6 +110,11 @@ type SkipRange = {
   endMs: number;
 };
 
+type ReplayViewportDimensions = {
+  width: number;
+  height: number;
+};
+
 const DEFAULT_PLAYER_WIDTH = 1024;
 const DEFAULT_PLAYER_HEIGHT = 640;
 const DEFAULT_SPEED = 2;
@@ -334,9 +339,12 @@ function ReplayPlayer({
     height: number;
   } | null>(null);
   const [fitScale, setFitScale] = useState(1);
+  const initialDims = useMemo(() => replayViewportDimensions(events), [events]);
 
-  const playerWidth = streamedDims?.width ?? DEFAULT_PLAYER_WIDTH;
-  const playerHeight = streamedDims?.height ?? DEFAULT_PLAYER_HEIGHT;
+  const playerWidth =
+    streamedDims?.width ?? initialDims?.width ?? DEFAULT_PLAYER_WIDTH;
+  const playerHeight =
+    streamedDims?.height ?? initialDims?.height ?? DEFAULT_PLAYER_HEIGHT;
   const skipRanges = useMemo(() => buildIdleSkipRanges(events), [events]);
   const skipRangesRef = useLiveRef(skipRanges);
   const skipInactiveRef = useLiveRef(skipInactive);
@@ -414,7 +422,7 @@ function ReplayPlayer({
       if (cancelled || !stageRootRef.current) return;
 
       stageRootRef.current.innerHTML = "";
-      setStreamedDims(null);
+      setStreamedDims(initialDims);
       localReplayer = new Replayer(events as any[], {
         root: stageRootRef.current,
         speed: DEFAULT_SPEED,
@@ -431,6 +439,7 @@ function ReplayPlayer({
       const meta = localReplayer.getMetaData?.();
       const total = Number(meta?.totalTime ?? replayDuration(events));
       setTotalTime(Number.isFinite(total) ? total : 0);
+      applyReplayFrameDimensions(localReplayer, initialDims);
       localReplayer.on?.("finish", () => {
         setPlaying(false);
         const finalTime = Number(localReplayer.getCurrentTime?.() ?? total);
@@ -438,10 +447,20 @@ function ReplayPlayer({
       });
       localReplayer.on?.("resize", (payload: unknown) => {
         const dims = payload as { width?: unknown; height?: unknown };
-        if (typeof dims.width === "number" && typeof dims.height === "number") {
-          setStreamedDims({ width: dims.width, height: dims.height });
+        const nextDims = normalizeReplayDimensions(dims.width, dims.height);
+        if (nextDims) {
+          applyReplayFrameDimensions(localReplayer, nextDims);
+          revealReplayFrame(localReplayer);
+          setStreamedDims(nextDims);
         }
       });
+      localReplayer.on?.("fullsnapshot-rebuilded", () => {
+        applyReplayFrameDimensions(
+          localReplayer,
+          replayViewportDimensions(events) ?? initialDims,
+        );
+        revealReplayFrame(localReplayer);
+      });
       updateTime(0);
       setStatus("ready");
       try {
@@ -456,6 +475,13 @@ function ReplayPlayer({
         }
         setPlaying(false);
       }
+      window.requestAnimationFrame(() => {
+        applyReplayFrameDimensions(
+          localReplayer,
+          replayViewportDimensions(events) ?? initialDims,
+        );
+        revealReplayFrame(localReplayer);
+      });
     }
 
     void loadReplay().catch((loadError: any) => {
@@ -479,7 +505,7 @@ function ReplayPlayer({
       replayerRef.current = null;
       if (stageRootRef.current) stageRootRef.current.innerHTML = "";
     };
-  }, [events, t, updateTime]);
+  }, [events, initialDims, t, updateTime]);
 
   useEffect(() => {
     if (!playing || status !== "ready") {
@@ -842,7 +868,7 @@ function ReplayTimeline({
   const t = useT();
   const visibleMarkers = markers.slice(0, 120);
   return (
-    <Card className="flex min-h-0 overflow-hidden">
+    <Card className="analytics-session-detail-timeline min-h-0 overflow-hidden">
       <CardContent className="flex min-h-0 flex-1 flex-col p-0">
         <div className="shrink-0 border-b px-3 py-2">
           <div className="flex items-center gap-2 text-sm font-semibold">
@@ -925,7 +951,7 @@ function DetailSkeleton() {
   return (
     <div className="analytics-session-detail-workbench grid min-h-0 flex-1 gap-3">
       <Skeleton className="h-full min-h-[420px] w-full" />
-      <Skeleton className="h-full min-h-[420px] w-full" />
+      <Skeleton className="analytics-session-detail-timeline h-full min-h-[420px] w-full" />
     </div>
   );
 }
@@ -1008,13 +1034,13 @@ function sanitizeMutationData(data: AnyRecord): AnyRecord {
         typeof copy.value === "string" &&
         containsStylesheetNetworkLoad(copy.value)
       ) {
-        copy.value = "";
+        copy.value = sanitizeCssText(copy.value);
       }
       if (
         typeof copy.textContent === "string" &&
         containsStylesheetNetworkLoad(copy.textContent)
       ) {
-        copy.textContent = "";
+        copy.textContent = sanitizeCssText(copy.textContent);
       }
       return copy;
     });
@@ -1035,21 +1061,12 @@ function sanitizeSerializedNode(node: unknown): AnyRecord | null {
       childNodes: [],
     };
   }
-  if (next.type === 2 && tagName === "style") {
-    return {
-      ...next,
-      attributes: isRecord(next.attributes)
-        ? sanitizeAttributes(next.attributes)
-        : {},
-      childNodes: [],
-    };
-  }
   if (
     next.type === 3 &&
     typeof next.textContent === "string" &&
     containsStylesheetNetworkLoad(next.textContent)
   ) {
-    next.textContent = "";
+    next.textContent = sanitizeCssText(next.textContent);
   }
   if (
     next.type === 2 &&
@@ -1073,6 +1090,13 @@ function containsStylesheetNetworkLoad(value: string): boolean {
   return /@import\b/i.test(value) || /\burl\s*\(/i.test(value);
 }
 
+function sanitizeCssText(value: string): string {
+  if (!containsStylesheetNetworkLoad(value)) return value;
+  return value
+    .replace(/@import\s+(?:url\s*\()?[^;{}]+;?/gi, "")
+    .replace(/\burl\s*\((?:\\.|[^\\)])*\)/gi, "none");
+}
+
 function sanitizeAttributes(attributes: AnyRecord): AnyRecord {
   const next: AnyRecord = {};
   for (const [key, value] of Object.entries(attributes)) {
@@ -1080,7 +1104,11 @@ function sanitizeAttributes(attributes: AnyRecord): AnyRecord {
     if (normalized.startsWith("on")) continue;
     if (normalized === "srcdoc") continue;
     if (isReplayResourceAttribute(normalized)) continue;
-    if (normalized === "style" && /\burl\s*\(/i.test(String(value))) continue;
+    if (normalized === "style") {
+      const style = sanitizeCssText(String(value));
+      if (style.trim()) next[key] = style;
+      continue;
+    }
     next[key] = value;
   }
   return next;
@@ -1240,6 +1268,66 @@ function currentUrlAt(events: AnyReplayEvent[], currentTime: number): string {
   return current;
 }
 
+export function replayViewportDimensions(
+  events: AnyReplayEvent[],
+): ReplayViewportDimensions | null {
+  for (const event of events) {
+    if (event.type !== RRWEB_EVENT_TYPE.Meta) continue;
+    const dims = normalizeReplayDimensions(
+      event.data?.width,
+      event.data?.height,
+    );
+    if (dims) return dims;
+  }
+  return null;
+}
+
+function normalizeReplayDimensions(
+  width: unknown,
+  height: unknown,
+): ReplayViewportDimensions | null {
+  if (
+    typeof width !== "number" ||
+    typeof height !== "number" ||
+    !Number.isFinite(width) ||
+    !Number.isFinite(height) ||
+    width <= 0 ||
+    height <= 0
+  ) {
+    return null;
+  }
+  return {
+    width: Math.round(width),
+    height: Math.round(height),
+  };
+}
+
+function applyReplayFrameDimensions(
+  replayer: any,
+  dims: ReplayViewportDimensions | null,
+) {
+  const width = dims?.width ?? DEFAULT_PLAYER_WIDTH;
+  const height = dims?.height ?? DEFAULT_PLAYER_HEIGHT;
+  const wrapper = replayer?.wrapper as HTMLElement | undefined;
+  const iframe = replayer?.iframe as HTMLIFrameElement | undefined;
+  const mouseTail = replayer?.mouseTail as HTMLCanvasElement | undefined;
+  for (const element of [wrapper, iframe]) {
+    if (!element) continue;
+    element.style.width = `${width}px`;
+    element.style.height = `${height}px`;
+  }
+  for (const element of [iframe, mouseTail]) {
+    if (!element) continue;
+    element.setAttribute("width", String(width));
+    element.setAttribute("height", String(height));
+  }
+}
+
+function revealReplayFrame(replayer: any) {
+  const iframe = replayer?.iframe as HTMLIFrameElement | undefined;
+  if (iframe) iframe.style.display = "inherit";
+}
+
 function replayStartedAt(events: AnyReplayEvent[]): number {
   const first = events.find((event) =>
     Number.isFinite(Number(event.timestamp)),

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

@@ -235,7 +235,7 @@ export default function SessionsPage() {
                     >
                       <span className="inline-flex h-10 w-[92px] items-center justify-center gap-2 rounded-md bg-primary/10 font-medium text-primary">
                         <IconPlayerPlay className="h-4 w-4 fill-current" />
-                        {formatDuration(recording.durationMs)}
+                        {formatSessionDuration(recording.durationMs)}
                       </span>
                       <span className="min-w-0">
                         <span className="block truncate text-sm font-medium text-foreground">
@@ -523,13 +523,11 @@ function formatDateTime(value: string): string {
   }).format(date);
 }
 
-function formatDuration(ms: number | null): string {
-  if (!ms || !Number.isFinite(ms) || ms <= 0) return "0s";
+export function formatSessionDuration(ms: number | null): string {
+  if (!ms || !Number.isFinite(ms) || ms <= 0) return "0m";
   const seconds = Math.round(ms / 1000);
-  if (seconds < 60) return `${seconds}s`;
   const minutes = Math.floor(seconds / 60);
-  const remainingSeconds = seconds % 60;
-  if (minutes < 60) return `${minutes}m ${remainingSeconds}s`;
+  if (minutes < 60) return `${minutes}m`;
   const hours = Math.floor(minutes / 60);
   const remainingMinutes = minutes % 60;
   return `${hours}h ${remainingMinutes}m`;

package/corpus/templates/analytics/changelog/2026-06-30-ask-opens-a-fresh-chat-unless-you-were-just-chatting-and-das.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-30
+---
+
+Ask opens a fresh chat unless you were just chatting, and dashboard navigation keeps the sidebar closed from an empty Ask state.

package/corpus/templates/analytics/changelog/2026-06-30-dashboard-email-reports-are-more-reliable-and-use-cleaner.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-30
+---
+
+Dashboard email reports are more reliable and use cleaner header copy.

package/corpus/templates/analytics/changelog/2026-06-30-dashboard-toolbar-controls-use-a-quieter-share-button-and-ve.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-30
+---
+
+Dashboard toolbar controls use a quieter share button and vertical actions menu.

package/corpus/templates/analytics/changelog/2026-06-30-session-replay-rows-show-whole-minute-durations-in-the-playl.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-30
+---
+
+Session replay rows show whole-minute durations in the playlist.

package/corpus/templates/analytics/changelog/2026-06-30-session-replays-now-render-captured-styling-and-keep-the-eve.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-30
+---
+
+Session replays now render captured styling and keep the event timeline out of compact layouts.

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

@@ -41,14 +41,27 @@ export async function runDashboardReportsOnce(): Promise<{
     for (const sub of batch) {
       processed++;
       try {
-        await runWithRequestContext(
+        const result = await runWithRequestContext(
           {
             userEmail: sub.ownerEmail,
             orgId: sub.orgId ?? undefined,
           },
-          () => sendDashboardReportSubscription(sub),
+          () =>
+            sendDashboardReportSubscription(sub, { requireScreenshot: true }),
         );
-        await markDashboardReportResult(sub, "success");
+        if (result.screenshotAttached) {
+          await markDashboardReportResult(sub, "success");
+        } else {
+          failed++;
+          const message = result.screenshotError
+            ? `Dashboard screenshot unavailable: ${result.screenshotError}`
+            : "Dashboard screenshot unavailable";
+          console.error(
+            `[dashboard-report] Subscription ${sub.id} sent without a screenshot:`,
+            message,
+          );
+          await markDashboardReportResult(sub, "error", message);
+        }
       } catch (err: any) {
         failed++;
         const message = err?.message ?? String(err);

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

@@ -42,8 +42,8 @@ const DASHBOARD_REPORT_SCREENSHOT_PARAM = "reportScreenshot";
 const DASHBOARD_REPORT_SETTINGS_PARAM = "reportSettings";
 const DASHBOARD_REPORT_CID = "dashboard-report-snapshot";
 const LOCAL_SCREENSHOT_TIMEOUT_MS = 90_000;
-const SERVERLESS_SCREENSHOT_TIMEOUT_MS = 25_000;
-const SERVERLESS_SECOND_READY_TIMEOUT_MS = 10_000;
+const SERVERLESS_SCREENSHOT_TIMEOUT_MS = 60_000;
+const SERVERLESS_SECOND_READY_TIMEOUT_MS = 30_000;
 const MAX_SCREENSHOT_VIEWPORT_HEIGHT = 30_000;
 const SCREENSHOT_VIEWPORT_PADDING = 64;
 
@@ -249,11 +249,28 @@ async function launchScreenshotBrowser() {
 }
 
 function screenshotTimeoutMs(): number {
+  const configured = positiveIntEnv("DASHBOARD_REPORT_SCREENSHOT_TIMEOUT_MS");
+  if (configured) return configured;
   return isServerlessBrowserRuntime()
     ? SERVERLESS_SCREENSHOT_TIMEOUT_MS
     : LOCAL_SCREENSHOT_TIMEOUT_MS;
 }
 
+function secondReadyTimeoutMs(): number {
+  const configured = positiveIntEnv("DASHBOARD_REPORT_SECOND_READY_TIMEOUT_MS");
+  if (configured) return configured;
+  return isServerlessBrowserRuntime()
+    ? SERVERLESS_SECOND_READY_TIMEOUT_MS
+    : screenshotTimeoutMs();
+}
+
+function positiveIntEnv(name: string): number | null {
+  const raw = process.env[name]?.trim();
+  if (!raw) return null;
+  const parsed = Number.parseInt(raw, 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+}
+
 async function waitForDashboardReportReady(
   page: any,
   timeout: number,
@@ -393,12 +410,7 @@ async function captureDashboardPng(
     await capture.waitFor({ state: "visible", timeout });
     await waitForDashboardReportReady(page, timeout);
     await scrollDashboardForLazyRendering(page);
-    await waitForDashboardReportReady(
-      page,
-      isServerlessBrowserRuntime()
-        ? SERVERLESS_SECOND_READY_TIMEOUT_MS
-        : timeout,
-    );
+    await waitForDashboardReportReady(page, secondReadyTimeoutMs());
 
     await fitViewportToDashboardCapture(page, capture, attempt.viewport);
     await capture.scrollIntoViewIfNeeded();
@@ -478,18 +490,15 @@ function renderReportEmailHtml(
   return `<!doctype html>
 <html>
   <body style="margin:0;padding:24px;background:#ffffff;color:#171717;font-family:Inter,Arial,sans-serif;">
-    <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>
+    <p style="margin:0 0 12px;font-size:15px;line-height:1.4;font-weight:600;">
+      Here's your report of <a href="${dashboardUrl}" style="color:#2563eb;text-decoration:none;">${title}</a> for ${date}
+    </p>
     ${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>`;
 }
@@ -521,6 +530,7 @@ function reportFilename(title: string): string {
 
 export async function sendDashboardReportSubscription(
   sub: DashboardReportSubscription,
+  options: { requireScreenshot?: boolean } = {},
 ): Promise<{
   dashboardUrl: string;
   recipientCount: number;
@@ -530,6 +540,13 @@ export async function sendDashboardReportSubscription(
 }> {
   const snapshot = await collectReportSnapshot(sub);
   const capture = await captureDashboardPngWithFallback(sub, snapshot);
+  if (!capture.png && options.requireScreenshot) {
+    throw new Error(
+      capture.error
+        ? `Dashboard screenshot unavailable: ${capture.error}`
+        : "Dashboard screenshot unavailable",
+    );
+  }
   const screenshotAttached = Boolean(capture.png);
   const html = renderReportEmailHtml(snapshot, { screenshotAttached });
   const text = renderReportText(snapshot, { screenshotAttached });

package/corpus/templates/assets/.agents/skills/image-generation/SKILL.md

@@ -15,8 +15,15 @@ Use this skill before calling `generate-image`, `generate-image-batch`, or
   `presetId`, and `media-type` references choose image generation versus video
   generation. Call `view-screen` when the user says "this library" or "this
   image" and you need fresh IDs. The image model may default from the composer
-  image-model picker; all other generation settings should be explicit action
-  args, preset values, or action schema defaults.
+  image-model picker.
+- A tagged `@preset` (presetId) owns `aspectRatio`, `imageSize`, `model`,
+  `tier`, and `category`. When a preset is set, do NOT pass those args yourself —
+  leave them out so the preset's saved values are used. You cannot see the
+  preset's settings from the presetId, so passing your own guess silently
+  overrides the preset (this is the usual cause of a preset's aspect ratio being
+  ignored). Pass one of these args alongside a preset ONLY when the user
+  explicitly asks for a value that differs from the preset. When there is no
+  preset, set them explicitly or rely on the action schema defaults.
 - Use category-tagged references. Blog heroes should prefer `hero`; diagrams
   should prefer `diagram`; product imagery should include `product` and `logo`
   references.

package/corpus/templates/assets/AGENTS.md

@@ -47,6 +47,10 @@ prompt, aspectRatio }`.
   composer is empty. The image model is the only remaining composer-side
   default; the image-model picker writes `imageGenerationModel`, which image
   generation actions may use when `model` is omitted.
+- For exact visible copy inside a generated image, pass `embeddedText` and
+  optional `textPlacement` to `generate-image` or each `generate-image-batch`
+  slot. Keep the general `prompt` for creative direction; the structured text
+  fields are what allow the pipeline to render copy instead of suppressing it.
 - `asset-variants` is the shared live generation tray state. New image
   candidates should appear there through `generate-image` or
   `generate-image-batch`; do not invent page-local progress surfaces.

package/corpus/templates/assets/actions/_tool-activity.ts

@@ -0,0 +1,46 @@
+import type { ActionRunContext } from "@agent-native/core/action";
+
+const DEFAULT_TOOL_ACTIVITY_INTERVAL_MS = 8_000;
+
+type ToolActivityOptions = {
+  label: string;
+  ongoingLabel?: string;
+  intervalMs?: number;
+  tool?: string;
+};
+
+function canEmitToolActivity(
+  context: ActionRunContext | undefined,
+): context is ActionRunContext & Required<Pick<ActionRunContext, "send">> {
+  return context?.caller === "tool" && typeof context.send === "function";
+}
+
+export async function withToolActivity<T>(
+  context: ActionRunContext | undefined,
+  options: ToolActivityOptions,
+  work: () => Promise<T>,
+): Promise<T> {
+  if (!canEmitToolActivity(context)) return work();
+
+  const tool = options.tool ?? context.actionName;
+  const sendActivity = (label: string) => {
+    context.send({
+      type: "activity",
+      label,
+      ...(tool ? { tool } : {}),
+    });
+  };
+
+  sendActivity(options.label);
+  const interval = setInterval(
+    () => sendActivity(options.ongoingLabel ?? options.label),
+    options.intervalMs ?? DEFAULT_TOOL_ACTIVITY_INTERVAL_MS,
+  );
+  interval.unref?.();
+
+  try {
+    return await work();
+  } finally {
+    clearInterval(interval);
+  }
+}

package/corpus/templates/assets/actions/generate-image-batch.ts

@@ -18,7 +18,6 @@ import {
   STYLE_STRENGTHS,
 } from "../shared/api.js";
 import { requireGenerationSessionInLibrary } from "./_helpers.js";
-import { readImageModelDefault } from "./_image-model-default.js";
 import generateImage from "./generate-image.js";
 import { upsertVariantSlot } from "./variant-slots.js";
 
@@ -35,14 +34,36 @@ export default defineAction({
         "Brand kit/library ID. Pass the refId from a brand-kit @mention, or choose a kit from view-screen/list-libraries.",
       ),
     collectionId: z.string().optional(),
-    presetId: z.string().optional(),
+    presetId: z
+      .string()
+      .optional()
+      .describe(
+        "Generation preset ID (from a @preset mention or list-generation-presets). The preset already defines aspectRatio, imageSize, model, tier, and category. When you set presetId, OMIT each slot's aspectRatio/imageSize and the top-level model/tier so the preset's values are used; only pass one when the user explicitly asks for a value that differs from the preset.",
+      ),
     sessionId: z.string().optional(),
     slots: z
       .array(
         z.object({
           slotId: z.string(),
           prompt: z.string().min(1),
-          aspectRatio: z.enum(ASPECT_RATIOS).optional(),
+          embeddedText: z
+            .string()
+            .optional()
+            .describe(
+              "Exact words to render inside the image, spelled exactly. When set, the image is allowed to contain this text; when omitted, the image avoids embedded text.",
+            ),
+          textPlacement: z
+            .string()
+            .optional()
+            .describe(
+              "Where/how the embedded text should appear, e.g. 'centered headline', 'lower-left label'.",
+            ),
+          aspectRatio: z
+            .enum(ASPECT_RATIOS)
+            .optional()
+            .describe(
+              "Slot aspect ratio. When a presetId is set, omit this — the preset's aspect ratio is used unless the user explicitly asks for a different ratio for this slot.",
+            ),
           imageSize: z.enum(IMAGE_SIZES).optional(),
           categories: z.array(z.enum(IMAGE_CATEGORIES)).optional(),
           referenceAssetIds: z.array(z.string()).optional(),
@@ -78,7 +99,6 @@ export default defineAction({
   parallelSafe: true,
   timeoutMs: IMAGE_GENERATION_TOOL_TIMEOUT_MS,
   run: async ({ slots, ...inputBase }, context?: ActionRunContext) => {
-    const imageModelDefault = await readImageModelDefault();
     const libraryId = inputBase.libraryId;
     if (!libraryId) {
       throw new Error(
@@ -88,7 +108,6 @@ export default defineAction({
     const base = {
       ...inputBase,
       libraryId,
-      model: inputBase.model ?? imageModelDefault,
     };
     await assertAccess("asset-library", base.libraryId, "editor");
     if (base.sessionId) {
@@ -123,6 +142,8 @@ export default defineAction({
               presetId: base.presetId,
               sessionId: base.sessionId,
               prompt: slot.prompt,
+              embeddedText: slot.embeddedText,
+              textPlacement: slot.textPlacement,
               aspectRatio: slot.aspectRatio,
               imageSize: slot.imageSize,
               model: base.model,