@agent-native/core 0.136.0 → 0.136.3

package/corpus/templates/clips/server/lib/transactional-email-store.ts

@@ -32,6 +32,17 @@ export const transactionalEmailStateSchema = z.enum([
   "failed",
 ]);
 
+export const recapMonthSchema = z.string().regex(/^\d{4}-(0[1-9]|1[0-2])$/);
+
+/** The three recap modules the agent writes; everything else is templated. */
+export const recapCopySchema = z
+  .object({
+    heroLine: nonEmptyStringSchema.max(400),
+    agentBreakdown: nonEmptyStringSchema.max(400),
+    completionNote: nonEmptyStringSchema.max(400),
+  })
+  .strict();
+
 const commonPayloadFields = {
   recipient: recipientSchema,
   shareId: nonEmptyStringSchema.optional(),
@@ -60,6 +71,22 @@ export const transactionalEmailPayloadSchema = z.discriminatedUnion("type", [
       recordingIds: z.array(recordingIdSchema).length(1),
     })
     .strict(),
+  z
+    .object({
+      type: z.literal("first-agent-view"),
+      ...commonPayloadFields,
+      recordingIds: z.array(recordingIdSchema).length(1),
+    })
+    .strict(),
+  z
+    .object({
+      type: z.literal("monthly-recap"),
+      ...commonPayloadFields,
+      // The month's top clip, which anchors the card and the AI copy.
+      recordingIds: z.array(recordingIdSchema).length(1),
+      month: recapMonthSchema,
+    })
+    .strict(),
   z
     .object({
       type: z.literal("two-clips"),
@@ -85,6 +112,7 @@ export const transactionalEmailConfigSchema = z
     shareDiscoveryCursor: reconciliationCursorSchema,
     reminderCursor: reconciliationCursorSchema,
     firstViewCursor: reconciliationCursorSchema,
+    firstAgentViewCursor: reconciliationCursorSchema,
     firstImportCursor: reconciliationCursorSchema,
   })
   .strict();
@@ -93,6 +121,7 @@ export const transactionalEmailCursorNameSchema = z.enum([
   "shareDiscoveryCursor",
   "reminderCursor",
   "firstViewCursor",
+  "firstAgentViewCursor",
   "firstImportCursor",
 ]);
 
@@ -102,7 +131,9 @@ export const transactionalEmailJobSchema = z
     type: z.enum([
       "first-view",
       "unviewed-reminder",
+      "first-agent-view",
       "first-import",
+      "monthly-recap",
       "two-clips",
     ]),
     state: transactionalEmailStateSchema,
@@ -110,6 +141,7 @@ export const transactionalEmailJobSchema = z
     recordingIds: z.array(recordingIdSchema).min(1),
     shareId: nonEmptyStringSchema.optional(),
     requestedBy: nonEmptyStringSchema.optional(),
+    month: recapMonthSchema.optional(),
     generatedSummary: z.string().max(20_000).optional(),
     attempts: z.number().int().nonnegative(),
     createdAt: timestampSchema,
@@ -133,6 +165,7 @@ export const transactionalEmailJobSchema = z
       recordingIds: job.recordingIds,
       shareId: job.shareId,
       requestedBy: job.requestedBy,
+      ...(job.month === undefined ? {} : { month: job.month }),
     });
     if (!parsedPayload.success) {
       context.addIssue({
@@ -172,6 +205,12 @@ export type TransactionalEmailConfig = z.infer<
   typeof transactionalEmailConfigSchema
 >;
 export type TransactionalEmailJob = z.infer<typeof transactionalEmailJobSchema>;
+export type RecapCopy = z.infer<typeof recapCopySchema>;
+
+/** Job types whose copy is written by the agent before they can be sent. */
+export function isAiBackedType(type: TransactionalEmailJob["type"]): boolean {
+  return type === "two-clips";
+}
 
 export type TransactionalEmailStoreOptions = {
   root?: string;
@@ -625,7 +664,7 @@ export function createTransactionalEmailStore(
     const claimant = recipientSchema.parse(claimantEmail.trim().toLowerCase());
     return withJobLock(logicalKey, async () => {
       const job = await readJob(logicalKey);
-      if (!job || job.type !== "two-clips" || job.state !== "awaiting_ai") {
+      if (!job || !isAiBackedType(job.type) || job.state !== "awaiting_ai") {
         return null;
       }
       const timestamp = now().toISOString();
@@ -652,7 +691,7 @@ export function createTransactionalEmailStore(
       const dispatchedAt = job?.aiDispatchedAt ?? job?.updatedAt;
       if (
         !job ||
-        job.type !== "two-clips" ||
+        !isAiBackedType(job.type) ||
         job.state !== "ai_dispatched" ||
         !dispatchedAt ||
         Date.parse(dispatchedAt) > staleBefore.getTime()

package/corpus/templates/clips/server/lib/transactional-email-templates.ts

@@ -5,7 +5,18 @@ import {
   sendEmail,
 } from "@agent-native/core/server";
 
+import { recapMonthLabel } from "./recap-metrics.js";
+import type { RecapCopy } from "./transactional-email-store.js";
+
 const CLIPS_BRAND_NAME = "Clips";
+const CLIPS_SENDER_NAME = "Agent-Native Clips";
+/**
+ * Yields `clips@agent-native.com` on first-party deployments and is ignored
+ * where the configured sender is someone else's verified address, so a
+ * self-hosted install keeps sending from an address its provider accepts.
+ */
+const CLIPS_SENDER_SLUG = "clips";
+const UNIDENTIFIED_AGENT_NAME = "An AI agent";
 const EMAIL_SEND_TIMEOUT_MS = 60_000;
 const FRIENDLY_REPLY_TO = "hello@agent-native.com";
 const UNTITLED_CLIP = "Untitled Clip";
@@ -31,11 +42,26 @@ export type ClipsTransactionalEmailInput =
       senderName?: string | null;
       brandLogoUrl?: string | null;
     })
+  | (TransactionalEmailBase & {
+      kind: "first-agent-view";
+      recordingId: string;
+      title?: string | null;
+      /** Absent when the reading agent could not be identified by product. */
+      agentName?: string | null;
+    })
   | (TransactionalEmailBase & {
       kind: "first-import";
       recordingId: string;
       title?: string | null;
     })
+  | (TransactionalEmailBase & {
+      kind: "monthly-recap";
+      month: string;
+      humanViews: number;
+      agentSessions: number;
+      topClip: RecapTopClipInput;
+      copy: RecapCopy;
+    })
   | (TransactionalEmailBase & {
       kind: "two-clips";
       generatedSummary?: string | null;
@@ -60,6 +86,16 @@ export type ClipsTransactionalEmailInput =
       videoTimestampMs?: number | null;
     });
 
+export interface RecapTopClipInput {
+  recordingId: string;
+  title?: string | null;
+  thumbnailUrl?: string | null;
+  durationMs: number;
+  recordedAt: string;
+  humanViews: number;
+  agentSessions: number;
+}
+
 export interface ClipsTransactionalEmailRenderOptions {
   appUrl: string;
   appBasePath?: string;
@@ -169,6 +205,158 @@ function resolveBrandLogoUrl(
   }
 }
 
+function escapeHtml(value: string): string {
+  return value
+    .replace(/&/g, "&")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+}
+
+function countLabel(count: number, singular: string, plural: string): string {
+  return `${count} ${count === 1 ? singular : plural}`;
+}
+
+export function renderRecapSubject(
+  humanViews: number,
+  agentSessions: number,
+  month: string,
+): string {
+  const monthLabel = recapMonthLabel(month);
+  const views = countLabel(humanViews, "human view", "human views");
+  const reads = countLabel(agentSessions, "agent read", "agent reads");
+  if (humanViews > 0 && agentSessions > 0) {
+    return `${views} and ${reads} on your clips in ${monthLabel}`;
+  }
+  if (humanViews > 0) return `${views} on your clips in ${monthLabel}`;
+  return `${reads} on your clips in ${monthLabel}`;
+}
+
+export interface RecapCopySource {
+  humanViews: number;
+  agentSessions: number;
+  topClip: {
+    humanViews: number;
+    completedPct: number;
+    dropOffMs: number | null;
+    /** A null `agentLabel` is an agent we could not identify by product. */
+    agentBreakdown: { agentLabel: string | null; sessions: number }[];
+  };
+}
+
+/**
+ * Builds every recap module from the metrics themselves.
+ *
+ * Deliberately not agent-written: a recap that waited on the owner opening
+ * Clips would silently never arrive for the owners least likely to open it.
+ * Each module is mechanical, so nothing is lost by composing it here.
+ */
+export function composeRecapCopy(recap: RecapCopySource): RecapCopy {
+  const views = countLabel(recap.humanViews, "time", "times");
+  const reads = countLabel(recap.agentSessions, "agent", "agents");
+  const heroLine =
+    recap.humanViews > 0 && recap.agentSessions > 0
+      ? `Your clips were watched ${views}. ${reads} read them.`
+      : recap.humanViews > 0
+        ? `Your clips were watched ${views}.`
+        : `${reads} read your clips.`;
+
+  const completionNote =
+    recap.topClip.humanViews === 0
+      ? "No human views on this one yet"
+      : `${recap.topClip.completedPct}% average completion${
+          recap.topClip.dropOffMs === null
+            ? ""
+            : ` · most stopped at ${formatClipDuration(recap.topClip.dropOffMs)}`
+        }`;
+
+  const agentBreakdown =
+    recap.topClip.agentBreakdown.length === 0
+      ? "No agent reads yet"
+      : recap.topClip.agentBreakdown
+          .map((entry) =>
+            entry.agentLabel
+              ? `${entry.sessions} from ${entry.agentLabel}`
+              : `${entry.sessions} unidentified`,
+          )
+          .join(" · ");
+
+  return { heroLine, completionNote, agentBreakdown };
+}
+
+export function formatClipDuration(durationMs: number): string {
+  const totalSeconds = Math.max(0, Math.round(durationMs / 1000));
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  return `${minutes}:${String(seconds).padStart(2, "0")}`;
+}
+
+function formatRecordedDate(recordedAt: string): string {
+  const parsed = new Date(recordedAt);
+  return Number.isNaN(parsed.getTime())
+    ? ""
+    : parsed.toLocaleDateString("en-US", {
+        month: "short",
+        day: "numeric",
+        timeZone: "UTC",
+      });
+}
+
+/**
+ * Email clients resolve neither CSS custom properties nor external
+ * stylesheets, so the recap card inlines the same literal palette that
+ * `renderEmail` already draws the surrounding card with.
+ */
+const CARD_BG = "#0a0a0c"; // guard:allow-raw-color — inlined for email clients
+const CARD_BORDER = "#3f3f46"; // guard:allow-raw-color — inlined for email clients
+const CARD_DIVIDER = "#27272a"; // guard:allow-raw-color — inlined for email clients
+const CARD_STRONG = "#fafafa"; // guard:allow-raw-color — inlined for email clients
+const CARD_MUTED = "#a1a1aa"; // guard:allow-raw-color — inlined for email clients
+
+/** The clip card plus the Watched/Read pair, as one trusted HTML block. */
+function recapHeroHtml(
+  clip: RecapTopClipInput,
+  copy: RecapCopy,
+  url: string,
+): string {
+  const title = escapeHtml(clipTitle(clip.title));
+  const recordedDate = escapeHtml(formatRecordedDate(clip.recordedAt));
+  const duration = escapeHtml(formatClipDuration(clip.durationMs));
+  const meta = [recordedDate, duration].filter(Boolean).join(" · ");
+  const safeUrl = escapeHtml(url);
+  const thumbnail = clip.thumbnailUrl?.trim()
+    ? `<tr><td style="padding:0 0 14px;"><a href="${safeUrl}" style="display:block;"><img src="${escapeHtml(clip.thumbnailUrl.trim())}" alt="${title}" width="516" style="display:block; width:100%; max-width:516px; border:0; border-radius:8px;" /></a></td></tr>`
+    : "";
+
+  const numberCell = (
+    heading: string,
+    value: number,
+    subLine: string,
+  ) => `<td width="50%" valign="top" style="padding:0 8px;">
+        <div style="font-size:12px; letter-spacing:0.08em; text-transform:uppercase; color:${CARD_MUTED};">${escapeHtml(heading)}</div>
+        <div style="font-size:28px; font-weight:600; color:${CARD_STRONG}; padding:2px 0 4px;">${value}</div>
+        <div style="font-size:13px; line-height:1.5; color:${CARD_MUTED};">${escapeHtml(subLine)}</div>
+      </td>`;
+
+  return `<table role="presentation" cellpadding="0" cellspacing="0" border="0" width="100%" style="margin:0 0 24px; border:1px solid ${CARD_BORDER}; border-radius:10px; background:${CARD_BG};">
+    <tr><td style="padding:16px;">
+      <table role="presentation" cellpadding="0" cellspacing="0" border="0" width="100%">
+        ${thumbnail}
+        <tr><td style="padding:0 0 4px;">
+          <a href="${safeUrl}" style="font-size:17px; font-weight:600; color:${CARD_STRONG}; text-decoration:none;">${title}</a>
+        </td></tr>
+        <tr><td style="padding:0 0 16px; font-size:13px; color:${CARD_MUTED};">${escapeHtml(meta)}</td></tr>
+        <tr><td style="border-top:1px solid ${CARD_DIVIDER}; padding-top:16px;">
+          <table role="presentation" cellpadding="0" cellspacing="0" border="0" width="100%"><tr>
+            ${numberCell("Watched", clip.humanViews, copy.completionNote)}
+            ${numberCell("Read", clip.agentSessions, copy.agentBreakdown)}
+          </tr></table>
+        </td></tr>
+      </table>
+    </td></tr>
+  </table>`;
+}
+
 function validReplyTo(value: string | null | undefined): string | undefined {
   const candidate = singleLine(value).toLowerCase();
   return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(candidate) ? candidate : undefined;
@@ -178,7 +366,10 @@ export function renderClipsTransactionalEmail(
   input: ClipsTransactionalEmailInput,
   options: ClipsTransactionalEmailRenderOptions,
 ): RenderedClipsTransactionalEmail {
-  const title = input.kind === "two-clips" ? undefined : clipTitle(input.title);
+  const title =
+    input.kind === "two-clips" || input.kind === "monthly-recap"
+      ? undefined
+      : clipTitle(input.title);
 
   switch (input.kind) {
     case "first-view": {
@@ -230,6 +421,32 @@ export function renderClipsTransactionalEmail(
       return { subject, ...rendered };
     }
 
+    case "first-agent-view": {
+      const agentName = singleLine(input.agentName) || UNIDENTIFIED_AGENT_NAME;
+      const subject = "An AI agent “watched” your Clip";
+      const rendered = renderEmail({
+        brandName: CLIPS_BRAND_NAME,
+        preheader: subject,
+        heading: "An AI agent “watched” your Clip",
+        paragraphs: [
+          `${emailStrong(agentName)} accessed ${emailStrong(title!)} today — the full transcript and the frames, not just the title.`,
+          "Every clip you record ships in two formats: video for people, structured JSON and readable frames for agents. When someone points an agent at your clip, it reads the whole thing in one pass.",
+          "Which means this one stopped being a video and became documentation that answers questions without you. You can even import videos from other screen recording apps to give them agentic readability.",
+        ],
+        cta: {
+          label: "See Clip Analytics",
+          url: clipUrl(input.recordingId, options),
+        },
+        secondaryCta: {
+          label: "Import a video",
+          url: recordUrl(options),
+        },
+        footer:
+          "You received this one-time note because an AI agent read one of your Clips for the first time.",
+      });
+      return { subject, ...rendered };
+    }
+
     case "first-import": {
       const subject = "Your first imported video is now Agent-Native";
       const url = clipUrl(input.recordingId, options);
@@ -256,6 +473,26 @@ export function renderClipsTransactionalEmail(
       return { subject, ...rendered };
     }
 
+    case "monthly-recap": {
+      const subject = renderRecapSubject(
+        input.humanViews,
+        input.agentSessions,
+        input.month,
+      );
+      const url = clipUrl(input.topClip.recordingId, options);
+      const rendered = renderEmail({
+        brandName: CLIPS_BRAND_NAME,
+        preheader: subject,
+        heading: `${input.copy.heroLine} Here’s your top Clip of the month:`,
+        paragraphs: [],
+        heroHtml: recapHeroHtml(input.topClip, input.copy, url),
+        cta: { label: "View more Clips Analytics", url },
+        secondaryCta: { label: "Record a new Clip", url: recordUrl(options) },
+        footer: `You received this because your Clips were watched in ${recapMonthLabel(input.month)}. Recaps arrive once a month; ask your agent for a Clips recap any time.`,
+      });
+      return { subject, ...rendered };
+    }
+
     case "two-clips": {
       const summary =
         singleLine(input.generatedSummary) ||
@@ -364,8 +601,13 @@ export async function sendClipsTransactionalEmail(
     html: rendered.html,
     text: rendered.text,
     fromName: reminderSender
-      ? `${reminderSender} (via Agent-Native Clips)`
-      : undefined,
+      ? `${reminderSender} (via ${CLIPS_SENDER_NAME})`
+      : CLIPS_SENDER_NAME,
+    appSender: {
+      name: CLIPS_SENDER_NAME,
+      slug: CLIPS_SENDER_SLUG,
+      replyTo: FRIENDLY_REPLY_TO,
+    },
     replyTo:
       input.kind === "unviewed-reminder"
         ? (validReplyTo(input.senderEmail) ?? FRIENDLY_REPLY_TO)

package/corpus/templates/clips/server/plugins/db.ts

@@ -915,6 +915,22 @@ const migrations = runMigrations(
       name: "recording-upload-generation-fence",
       sql: `ALTER TABLE recordings ADD COLUMN IF NOT EXISTS upload_generation_id TEXT`,
     },
+    {
+      version: 56,
+      name: "recording-agent-views-user-agent",
+      sql: `ALTER TABLE recording_agent_views ADD COLUMN IF NOT EXISTS user_agent TEXT`,
+    },
+    {
+      version: 57,
+      name: "recording-agent-views-clear-placeholder-label",
+      // Rows written before the user-agent column stored the literal placeholder
+      // 'Agent' for any agent the user-agent patterns could not name, which is
+      // indistinguishable from an agent that really is called "Agent". NULL is
+      // the one value that means "we don't know", so unnamed history renders as
+      // unknown too.
+      // guard:allow-unscoped — startup migration normalizes a legacy placeholder across all rows.
+      sql: `UPDATE recording_agent_views SET agent_label = NULL WHERE agent_label = 'Agent'`,
+    },
   ],
   { table: "clips_migrations" },
 );

package/corpus/templates/clips/server/register-secrets.ts

@@ -12,7 +12,7 @@ import { registerRequiredSecret } from "@agent-native/core/secrets";
 // available for desktop voice dictation and other provider-specific tools.
 //
 // We support two BYOK providers:
-//   1. Gemini — recommended for fast LLM cleanup in the desktop tray.
+//   1. Gemini — BYOK fallback for fast text cleanup in the desktop tray.
 //   2. Groq — optional voice-dictation provider, not a recording transcript
 //      fallback.
 //
@@ -30,7 +30,7 @@ registerRequiredSecret({
   key: "GEMINI_API_KEY",
   label: "Gemini API Key (recommended)",
   description:
-    "Fast LLM-backed transcription cleanup via Gemini Flash Lite. Recommended for Clips voice dictation when you want to bring your own key.",
+    "Fast text-model-backed transcription cleanup via Builder/Luna or Gemini Flash Lite. Recommended for Clips voice dictation when you want to bring your own key.",
   docsUrl: "https://aistudio.google.com/apikey",
   scope: "user",
   kind: "api-key",

package/corpus/templates/clips/server/routes/api/public-recording.get.ts

@@ -42,6 +42,7 @@ import {
 } from "../../../shared/transcript-segments.js";
 import { resolveTranscriptPresentation } from "../../../shared/transcript-status.js";
 import { getDb, schema } from "../../db/index.js";
+import { countRecordingAgentViews } from "../../lib/agent-views.js";
 import { isMediaVerificationPending } from "../../lib/media-verification-state.js";
 import { resolvePlayerThumbnailUrl } from "../../lib/player-thumbnail-url.js";
 import { resolvePlayerVideoUrl } from "../../lib/player-video-url.js";
@@ -411,7 +412,10 @@ export default defineEventHandler(async (event) => {
     recordingStatus: rec.status,
   });
 
-  const viewCount = await countRecordingViews(recordingId);
+  const [viewCount, agentViewCount] = await Promise.all([
+    countRecordingViews(recordingId),
+    countRecordingAgentViews(recordingId),
+  ]);
 
   const viewerRole =
     viewerAccess?.role ?? (viewerIsOrgMember ? "viewer" : null);
@@ -471,8 +475,9 @@ export default defineEventHandler(async (event) => {
       updatedAt: rec.updatedAt,
     },
     agentContextUrl,
-    // Aggregate count only — never viewer identities on this public payload.
+    // Aggregate counts only — never viewer identities on this public payload.
     viewCount,
+    agentViewCount,
     transcript: transcript
       ? {
           status: transcriptPresentation.status,

package/corpus/templates/clips/server/routes/api/video/[recordingId].get.ts

@@ -64,12 +64,15 @@ import {
   loomEmbedUrlForRecording,
 } from "../../../../shared/loom.js";
 import { getDb, schema } from "../../../db/index.js";
+import { allowsLegacyS3ObjectForPersistedMedia } from "../../../lib/media-storage-provenance.js";
 import { getOrganizationRoleForEmail } from "../../../lib/recordings.js";
+import { fetchS3ObjectByUrl } from "../../../lib/s3-upload-provider.js";
 import { verifySharePassword } from "../../../lib/share-password.js";
 
 interface RecordingRow {
   expiresAt?: string | null;
   organizationId?: string | null;
+  ownerEmail?: string | null;
   password?: string | null;
   sourceAppName?: string | null;
   sourceWindowTitle?: string | null;
@@ -453,7 +456,45 @@ export default defineEventHandler(async (event: H3Event) => {
 
         let upstream: Response | { error: string; status: number };
         try {
-          upstream = await fetchProviderMedia(sourceUrl, rangeHeader);
+          const db = getDb();
+          const [persistedMedia] = await db
+            .select({
+              videoUrl: schema.recordings.videoUrl,
+              editsJson: schema.recordings.editsJson,
+            })
+            .from(schema.recordings)
+            .where(eq(schema.recordings.id, recordingId))
+            .limit(1);
+          const allowLegacyObjectKey = allowsLegacyS3ObjectForPersistedMedia({
+            requestedUrl: sourceUrl,
+            persistedUrl: persistedMedia?.videoUrl,
+            editsJson: persistedMedia?.editsJson,
+          });
+          const signedS3Response = await runWithRequestContext(
+            {
+              userEmail: rec.ownerEmail ?? undefined,
+              orgId: rec.organizationId ?? undefined,
+            },
+            () =>
+              fetchS3ObjectByUrl(sourceUrl, {
+                range: rangeHeader?.startsWith("bytes=")
+                  ? rangeHeader
+                  : undefined,
+                timeoutMs: PROVIDER_MEDIA_FETCH_TIMEOUT_MS,
+                recordingId,
+                ...(allowLegacyObjectKey ? { allowLegacyObjectKey } : {}),
+              }),
+          );
+          if (
+            signedS3Response?.status === 200 ||
+            signedS3Response?.status === 206 ||
+            signedS3Response?.status === 416
+          ) {
+            upstream = signedS3Response;
+          } else {
+            await signedS3Response?.body?.cancel().catch(() => undefined);
+            upstream = await fetchProviderMedia(sourceUrl, rangeHeader);
+          }
         } catch (err) {
           setResponseStatus(event, statusCodeForProviderFetchError(err));
           return { error: messageForProviderFetchError(err) };

package/corpus/templates/design/actions/take-design-screenshot.ts

@@ -29,9 +29,11 @@
  *     the actionable-today half of the loop — the agent can read and fix
  *     these findings without needing to "see" anything.
  *
- * Requires a real headless Chromium. Local dev has Playwright's browsers
- * installed (`playwright install chromium`, same as the design e2e suite);
- * hosted/serverless deploys (Netlify Functions) do not bundle a Chromium
+ * Requires a real headless Chromium. Local dev needs Playwright's headless
+ * shell (`playwright install --only-shell chromium`); plain
+ * `install chromium` also downloads the full headed browser — several hundred
+ * MB more disk, needed only by `pnpm e2e:headed`/`e2e:ui`, never by this
+ * action. Hosted/serverless deploys (Netlify Functions) do not bundle a Chromium
  * binary, so this action detects that failure and returns a structured,
  * model-actionable `{ ok: false, reason }` telling the agent to fall back to
  * `run-design-audit` instead of surfacing a raw stack trace.

package/corpus/templates/design/package.json

@@ -47,7 +47,7 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@playwright/test": "^1.61.1",
+    "@playwright/test": "catalog:",
     "@radix-ui/react-accordion": "^1.2.12",
     "@radix-ui/react-alert-dialog": "^1.1.15",
     "@radix-ui/react-aspect-ratio": "^1.1.8",

package/corpus/templates/design/server/lib/playwright-runtime.ts

@@ -15,13 +15,17 @@ export type PlaywrightModule = {
 };
 
 /**
- * Dynamic import of a real Chromium-capable Playwright package.  Tries the
- * bare `"playwright"` package first (present when `@agent-native/core`'s
- * optional dependency resolved), then falls back to `@playwright/test` (a
+ * Dynamic import of a real Chromium-capable Playwright package. Tries the bare
+ * `"playwright"` package first (supplied as an optional dependency of
+ * `@agent-native/creative-context`), then falls back to `@playwright/test` (a
  * direct devDependency of this template, used by its own e2e suite, which
  * re-exports the same chromium/Browser API). Loaded via a non-literal
  * specifier so bundlers don't try to statically resolve/include it — it's
  * optional and can be entirely absent (e.g. in a hosted deploy).
+ *
+ * When both are absent the FIRST error is what callers need: reporting the
+ * fallback's "Cannot find package '@playwright/test'" names a package the user
+ * never asked for and sends them installing the wrong thing.
  */
 export async function importPlaywright(): Promise<PlaywrightModule> {
   try {
@@ -29,8 +33,12 @@ export async function importPlaywright(): Promise<PlaywrightModule> {
     return (await import(
       /* @vite-ignore */ specifier
     )) as unknown as PlaywrightModule;
-  } catch {
-    return (await import("@playwright/test")) as unknown as PlaywrightModule;
+  } catch (playwrightErr) {
+    try {
+      return (await import("@playwright/test")) as unknown as PlaywrightModule;
+    } catch {
+      throw playwrightErr;
+    }
   }
 }
 

package/corpus/templates/mail/actions/get-automation-settings.ts

@@ -1,8 +1,10 @@
 import { defineAction } from "@agent-native/core";
 import { getRequestUserEmail } from "@agent-native/core/server";
-import { getSetting, getUserSetting } from "@agent-native/core/settings";
+import { getUserSetting } from "@agent-native/core/settings";
 import { z } from "zod";
 
+import { resolveAutomationModelSettings } from "../server/lib/automation-model.js";
+
 export default defineAction({
   description:
     "Read the engine and model used to evaluate inbox automation rules, falling back to the app's configured agent engine.",
@@ -17,16 +19,6 @@ export default defineAction({
       engine?: string;
       model?: string;
     } | null;
-    const agentEngine = (await getSetting("agent-engine").catch(
-      () => null,
-    )) as {
-      engine?: string;
-      model?: string;
-    } | null;
-
-    return {
-      engine: data?.engine || agentEngine?.engine || "anthropic",
-      model: data?.model || agentEngine?.model || "claude-haiku-4-5-20251001",
-    };
+    return resolveAutomationModelSettings(ownerEmail, data);
   },
 });

package/corpus/templates/mail/app/pages/SettingsPage.tsx

@@ -906,7 +906,7 @@ function AutomationsSection() {
           { method: "GET" },
         );
       } catch {
-        return { engine: "anthropic", model: defaultModel };
+        return { model: defaultModel };
       }
     },
     staleTime: 30_000,

package/corpus/templates/mail/changelog/2026-08-03-inbox-automations-now-prefer-the-lowest-cost-luna-model-when.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-03
+---
+
+Inbox automations now prefer the lowest-cost Luna model when a Luna-capable provider is available.