@agent-native/core 0.134.0 → 0.135.0

package/corpus/templates/assets/app/routes/settings.tsx

@@ -10,6 +10,8 @@ import {
 import { TeamPage } from "@agent-native/core/client/org";
 import {
   AccountSettingsCard,
+  SettingsGroup,
+  SettingsRow,
   SettingsTabsPage,
   useAgentSettingsTabs,
   useBuilderConnectFlow,
@@ -36,6 +38,7 @@ import {
   type FormEvent,
   type ReactNode,
 } from "react";
+import { toast } from "sonner";
 
 import { PageShell } from "@/components/layout/PageShell";
 import { Button } from "@/components/ui/button";
@@ -56,6 +59,8 @@ import {
   SelectTrigger,
   SelectValue,
 } from "@/components/ui/select";
+import { Switch } from "@/components/ui/switch";
+import { useAssetsPrefs } from "@/hooks/use-assets-prefs";
 import { cn } from "@/lib/utils";
 
 import changelog from "../../CHANGELOG.md?raw";
@@ -81,6 +86,7 @@ export default function SettingsPage() {
   const { data } = useActionQuery("list-libraries", { compact: true }) as {
     data?: { count?: number };
   };
+  const { prefs, loading: prefsLoading, save: savePrefs } = useAssetsPrefs();
 
   const generalSearchEntries = useMemo<SettingsSearchEntry[]>(
     () => [
@@ -90,6 +96,12 @@ export default function SettingsPage() {
         keywords: "language locale translation i18n",
         hash: "language",
       },
+      {
+        id: "assets-notifications",
+        label: t("settings.emailNotifications"),
+        keywords: "email notification generation finished failed alert",
+        hash: "notifications",
+      },
       {
         id: "assets-generation-setup",
         label: t("settings.setupTitle"),
@@ -125,20 +137,41 @@ export default function SettingsPage() {
               </p>
             </div>
 
-            <Card id="language" className="scroll-mt-4">
-              <CardHeader>
-                <CardTitle className="text-base">
-                  {t("settings.languageTitle")}
-                </CardTitle>
-                <CardDescription>
-                  {t("settings.languageDescription")}
-                </CardDescription>
-              </CardHeader>
-              <CardContent className="max-w-xs space-y-1.5">
-                <Label>{t("settings.languageLabel")}</Label>
-                <LanguagePicker label={t("settings.languageLabel")} />
-              </CardContent>
-            </Card>
+            <SettingsGroup className="scroll-mt-4">
+              <SettingsRow
+                id="language"
+                label={t("settings.languageTitle")}
+                description={t("settings.languageDescription")}
+                control={
+                  <div className="w-56">
+                    <LanguagePicker label={t("settings.languageLabel")} />
+                  </div>
+                }
+              />
+              <SettingsRow
+                id="notifications"
+                label={t("settings.emailNotifications")}
+                description={t("settings.emailNotificationsDescription")}
+                control={
+                  <Switch
+                    aria-label={t("settings.emailNotifications")}
+                    checked={prefs.emailNotifications !== false}
+                    disabled={prefsLoading}
+                    onCheckedChange={(checked) => {
+                      savePrefs({ emailNotifications: checked }).catch(
+                        (err) => {
+                          toast.error(
+                            err instanceof Error
+                              ? err.message
+                              : t("settings.saveFailed"),
+                          );
+                        },
+                      );
+                    }}
+                  />
+                }
+              />
+            </SettingsGroup>
 
             <section id="asset-generation-setup" className="scroll-mt-4">
               <AssetsSetupCard libraryCount={data?.count ?? 0} />
@@ -243,8 +276,9 @@ function AssetsSetupCard({ libraryCount }: { libraryCount: number }) {
 
       <CardContent className="p-0">
         <SettingsRow
+          className="border-b border-border/70 last:border-b-0"
           icon={<IconKey className="size-4" />}
-          title="Builder"
+          label="Builder"
           description={
             builderConnected
               ? orgName
@@ -261,7 +295,7 @@ function AssetsSetupCard({ libraryCount }: { libraryCount: number }) {
                 : t("settings.optional")}
             </StatusPill>
           }
-          action={
+          control={
             builderEnabled ? (
               <Button
                 type="button"
@@ -295,8 +329,9 @@ function AssetsSetupCard({ libraryCount }: { libraryCount: number }) {
         {setupIssue ? <SetupIssueCallout message={setupIssue} /> : null}
 
         <SettingsRow
+          className="border-b border-border/70 last:border-b-0"
           icon={<IconPhoto className="size-4" />}
-          title={t("settings.generation")}
+          label={t("settings.generation")}
           description={generationSummary(configData, builderConnected, t)}
           status={
             <StatusPill tone={generationReady ? "ready" : "attention"}>
@@ -305,7 +340,7 @@ function AssetsSetupCard({ libraryCount }: { libraryCount: number }) {
                 : t("settings.generationNeedsSetup")}
             </StatusPill>
           }
-          action={
+          control={
             generationStep ? (
               <DisclosureButton
                 open={manualGenerationOpen}
@@ -326,8 +361,9 @@ function AssetsSetupCard({ libraryCount }: { libraryCount: number }) {
         ) : null}
 
         <SettingsRow
+          className="border-b border-border/70 last:border-b-0"
           icon={<IconCloudUpload className="size-4" />}
-          title={t("settings.storage")}
+          label={t("settings.storage")}
           description={
             storageReady
               ? t("settings.storageReady")
@@ -340,7 +376,7 @@ function AssetsSetupCard({ libraryCount }: { libraryCount: number }) {
                 : t("settings.generationNeedsSetup")}
             </StatusPill>
           }
-          action={
+          control={
             storageStep ? (
               <DisclosureButton
                 open={manualStorageOpen}
@@ -361,8 +397,9 @@ function AssetsSetupCard({ libraryCount }: { libraryCount: number }) {
         ) : null}
 
         <SettingsRow
+          className="border-b border-border/70 last:border-b-0"
           icon={<IconLibraryPhoto className="size-4" />}
-          title={t("settings.brandKits")}
+          label={t("settings.brandKits")}
           description={`${libraryCount} accessible ${
             libraryCount === 1 ? "brand kit" : "brand kits"
           }.`}
@@ -375,40 +412,6 @@ function AssetsSetupCard({ libraryCount }: { libraryCount: number }) {
   );
 }
 
-function SettingsRow({
-  icon,
-  title,
-  description,
-  status,
-  action,
-}: {
-  icon: ReactNode;
-  title: string;
-  description: string;
-  status: ReactNode;
-  action?: ReactNode;
-}) {
-  return (
-    <div className="flex flex-col gap-3 border-b border-border/70 px-5 py-4 last:border-b-0 sm:flex-row sm:items-center sm:justify-between">
-      <div className="flex min-w-0 gap-3">
-        <div className="mt-0.5 flex size-8 shrink-0 items-center justify-center rounded-md border border-border bg-background text-muted-foreground">
-          {icon}
-        </div>
-        <div className="min-w-0">
-          <div className="flex flex-wrap items-center gap-2">
-            <h3 className="text-sm font-medium">{title}</h3>
-            {status}
-          </div>
-          <p className="mt-1 max-w-xl text-sm leading-6 text-muted-foreground">
-            {description}
-          </p>
-        </div>
-      </div>
-      {action ? <div className="shrink-0 sm:ms-4">{action}</div> : null}
-    </div>
-  );
-}
-
 function StatusPill({
   children,
   tone,

package/corpus/templates/assets/changelog/2026-08-01-get-an-email-when-a-generation-you-started-finishes-or-fails.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-08-01
+---
+
+Get an email when a generation you started finishes or fails, with a new toggle in Settings

package/corpus/templates/assets/server/lib/generation-run-notifications.ts

@@ -0,0 +1,89 @@
+/**
+ * "Your generation finished" notifications.
+ *
+ * Only terminal transitions that happen *out of band* call this — a polled video
+ * run landing, or a stale image run being declared interrupted. Synchronous
+ * `generate-image` hands the result straight back to the caller, so emailing
+ * there would mail a user who is already looking at the image.
+ */
+import { notifyWithDelivery } from "@agent-native/core/notifications";
+import { getUserSetting } from "@agent-native/core/settings";
+
+import {
+  ASSETS_USER_PREFS_KEY,
+  type AssetsUserPrefs,
+} from "../../shared/assets-user-prefs.js";
+import type { schema } from "../db/index.js";
+
+type GenerationRun = typeof schema.assetGenerationRuns.$inferSelect;
+
+export type GenerationRunNotificationStatus =
+  | "no-recipient"
+  | "notified"
+  | "notification-error";
+
+export interface GenerationRunNotificationResult {
+  status: GenerationRunNotificationStatus;
+  emailed: boolean;
+}
+
+async function wantsEmail(email: string): Promise<boolean> {
+  const stored = await getUserSetting(email, ASSETS_USER_PREFS_KEY);
+  if (!stored || typeof stored !== "object" || Array.isArray(stored)) {
+    // No stored preference is a real state, and its meaning is "opted in".
+    return true;
+  }
+  return (stored as AssetsUserPrefs).emailNotifications !== false;
+}
+
+function summarize(run: GenerationRun): string {
+  const kind = run.mediaType === "video" ? "Video" : "Image";
+  const prompt = run.prompt.trim();
+  return prompt.length > 80
+    ? `${kind}: ${prompt.slice(0, 77)}…`
+    : `${kind}: ${prompt}`;
+}
+
+export async function notifyGenerationRunFinished(
+  run: GenerationRun,
+  outcome: "completed" | "failed",
+): Promise<GenerationRunNotificationResult> {
+  const owner = run.ownerEmail?.trim().toLowerCase();
+  if (!owner) return { status: "no-recipient", emailed: false };
+
+  try {
+    const emailed = await wantsEmail(owner);
+    const failed = outcome === "failed";
+    const title = failed ? "Generation failed" : "Generation finished";
+    const body = failed
+      ? `${summarize(run)}\n\n${run.error ?? "The run ended without a result."}`
+      : summarize(run);
+
+    await notifyWithDelivery(
+      {
+        severity: failed ? "warning" : "info",
+        title,
+        body,
+        channels: emailed ? ["inbox", "email"] : ["inbox"],
+        metadata: {
+          kind: "generation_run",
+          runId: run.id,
+          libraryId: run.libraryId,
+          outcome,
+          // The email channel is a no-op without explicit recipients.
+          ...(emailed ? { emailRecipients: [owner], emailSubject: title } : {}),
+        },
+      },
+      { owner },
+    );
+    return { status: "notified", emailed };
+  } catch (err) {
+    // A generation that produced an asset must not be reported as failed just
+    // because the mail server was down.
+    console.error(
+      `[assets] Could not notify ${owner} that run ${run.id} ${outcome}:`,
+      err instanceof Error ? err.message : String(err),
+    );
+    return { status: "notification-error", emailed: false };
+  }
+}

package/corpus/templates/assets/server/lib/video-runs.ts

@@ -2,6 +2,7 @@ import { eq } from "drizzle-orm";
 
 import { getDb, schema } from "../db/index.js";
 import { createAssetFromBuffer } from "./assets.js";
+import { notifyGenerationRunFinished } from "./generation-run-notifications.js";
 import { nowIso, parseJson, stringifyJson } from "./json.js";
 import { pollGeminiVideoGeneration } from "./video-generation.js";
 
@@ -59,6 +60,7 @@ async function markRunCompletedWithAsset(
       metadata: nextRun.metadata,
     })
     .where(eq(schema.assetGenerationRuns.id, run.id));
+  await notifyGenerationRunFinished(nextRun, "completed");
   return nextRun;
 }
 
@@ -217,14 +219,19 @@ export async function completeVideoGenerationRun(
   } catch (err) {
     const message =
       err instanceof Error ? err.message : "Video generation failed.";
+    const completedAt = nowIso();
     await getDb()
       .update(schema.assetGenerationRuns)
       .set({
         status: "failed",
         error: message,
-        completedAt: nowIso(),
+        completedAt,
       })
       .where(eq(schema.assetGenerationRuns.id, run.id));
+    await notifyGenerationRunFinished(
+      { ...run, status: "failed", error: message, completedAt },
+      "failed",
+    );
     throw err;
   }
 }

package/corpus/templates/assets/server/routes/_agent-native/assets/user-prefs.get.ts

@@ -0,0 +1,17 @@
+import { getSession } from "@agent-native/core/server";
+import { getUserSetting } from "@agent-native/core/settings";
+import { defineEventHandler, setResponseStatus } from "h3";
+
+import { ASSETS_USER_PREFS_KEY } from "../../../../shared/assets-user-prefs.js";
+
+export default defineEventHandler(async (event) => {
+  const session = await getSession(event);
+  if (!session?.email) {
+    setResponseStatus(event, 401);
+    return { error: "unauthorized" };
+  }
+
+  const stored = await getUserSetting(session.email, ASSETS_USER_PREFS_KEY);
+  // coercion-ok: a null read means this user has no preferences yet, which is a real state.
+  return stored ?? {};
+});

package/corpus/templates/assets/server/routes/_agent-native/assets/user-prefs.put.ts

@@ -0,0 +1,36 @@
+import { getSession } from "@agent-native/core/server";
+import { getUserSetting, putUserSetting } from "@agent-native/core/settings";
+import { defineEventHandler, getHeader, readBody, setResponseStatus } from "h3";
+
+import { ASSETS_USER_PREFS_KEY } from "../../../../shared/assets-user-prefs.js";
+
+export default defineEventHandler(async (event) => {
+  const session = await getSession(event);
+  if (!session?.email) {
+    setResponseStatus(event, 401);
+    return { error: "unauthorized" };
+  }
+
+  // coercion-ok: an unparsable body is rejected with 400 immediately below.
+  const body = await readBody(event).catch(() => null);
+  if (!body || typeof body !== "object" || Array.isArray(body)) {
+    setResponseStatus(event, 400);
+    return { error: "Invalid settings payload" };
+  }
+
+  // Merge so a partial save never wipes preferences written elsewhere.
+  const stored = await getUserSetting(session.email, ASSETS_USER_PREFS_KEY);
+  // coercion-ok: a null read means this user has no preferences yet, which is a real state.
+  const existing = stored ?? {};
+  const next = {
+    ...(typeof existing === "object" && existing && !Array.isArray(existing)
+      ? existing
+      : {}),
+    ...(body as Record<string, unknown>),
+  };
+
+  await putUserSetting(session.email, ASSETS_USER_PREFS_KEY, next, {
+    requestSource: getHeader(event, "x-request-source") || undefined,
+  });
+  return next;
+});

package/corpus/templates/assets/shared/assets-user-prefs.ts

@@ -0,0 +1,10 @@
+/**
+ * Per-user Assets preferences, stored under one user-setting key so Settings
+ * and the generation pipeline agree on a single source of truth.
+ */
+export const ASSETS_USER_PREFS_KEY = "assets-user-prefs";
+
+export type AssetsUserPrefs = {
+  /** Email me when a generation run I started finishes or fails. */
+  emailNotifications?: boolean;
+};

package/corpus/templates/assets/vitest.config.ts

@@ -1,16 +1,20 @@
 import path from "node:path";
 
-import { defineConfig } from "vitest/config";
+import baseConfig from "@agent-native/core/vitest-config";
+import { defineConfig, mergeConfig } from "vitest/config";
 
-export default defineConfig({
-  resolve: {
-    alias: {
-      "@": path.resolve(__dirname, "./app"),
-      "@shared": path.resolve(__dirname, "./shared"),
+export default mergeConfig(
+  baseConfig,
+  defineConfig({
+    resolve: {
+      alias: {
+        "@": path.resolve(__dirname, "./app"),
+        "@shared": path.resolve(__dirname, "./shared"),
+      },
     },
-  },
-  test: {
-    include: ["**/*.{test,spec}.?(c|m)[jt]s?(x)"],
-    exclude: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
-  },
-});
+    test: {
+      include: ["**/*.{test,spec}.?(c|m)[jt]s?(x)"],
+      exclude: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
+    },
+  }),
+);

package/corpus/templates/brain/app/routes/settings.tsx

@@ -7,6 +7,8 @@ import { LanguagePicker, useT } from "@agent-native/core/client/i18n";
 import { TeamPage } from "@agent-native/core/client/org";
 import {
   AccountSettingsCard,
+  SettingsGroup,
+  SettingsRow,
   SettingsTabsPage,
   useAgentSettingsTabs,
   type SettingsSearchEntry,
@@ -717,21 +719,19 @@ export default function SettingsRoute() {
             </main>
 
             <aside className="grid content-start gap-5">
-              <Card id="language" className="scroll-mt-4">
-                <CardHeader>
-                  <CardTitle className="flex items-center gap-2 text-base">
-                    <IconAdjustments className="size-4 text-primary" />
-                    {t("settings.languageTitle")}
-                  </CardTitle>
-                  <CardDescription>
-                    {t("settings.languageDescription")}
-                  </CardDescription>
-                </CardHeader>
-                <CardContent className="space-y-1.5">
-                  <Label>{t("settings.languageLabel")}</Label>
-                  <LanguagePicker label={t("settings.languageLabel")} />
-                </CardContent>
-              </Card>
+              <SettingsGroup className="scroll-mt-4">
+                <SettingsRow
+                  id="language"
+                  icon={<IconAdjustments className="text-primary" />}
+                  label={t("settings.languageTitle")}
+                  description={t("settings.languageDescription")}
+                  control={
+                    <div className="w-48">
+                      <LanguagePicker label={t("settings.languageLabel")} />
+                    </div>
+                  }
+                />
+              </SettingsGroup>
 
               <Card>
                 <CardHeader>

package/corpus/templates/brain/vitest.config.ts

@@ -1,13 +1,17 @@
-import { defineConfig } from "vitest/config";
+import baseConfig from "@agent-native/core/vitest-config";
+import { defineConfig, mergeConfig } from "vitest/config";
 
-export default defineConfig({
-  test: {
-    passWithNoTests: true,
-    exclude: [
-      "**/node_modules/**",
-      "**/dist/**",
-      "**/.output/**",
-      "**/.{idea,git,cache,output,temp}/**",
-    ],
-  },
-});
+export default mergeConfig(
+  baseConfig,
+  defineConfig({
+    test: {
+      passWithNoTests: true,
+      exclude: [
+        "**/node_modules/**",
+        "**/dist/**",
+        "**/.output/**",
+        "**/.{idea,git,cache,output,temp}/**",
+      ],
+    },
+  }),
+);

package/corpus/templates/calendar/app/pages/Settings.tsx

@@ -4,6 +4,8 @@ import { LanguagePicker, useT } from "@agent-native/core/client/i18n";
 import { TeamPage } from "@agent-native/core/client/org";
 import {
   AccountSettingsCard,
+  SettingsGroup,
+  SettingsRow,
   SettingsTabsPage,
   useAgentSettingsTabs,
   type SettingsSearchEntry,
@@ -209,20 +211,36 @@ export default function Settings() {
             {t("settings.description")}
           </p>
 
-          <Card id="language" className="scroll-mt-16">
-            <CardHeader>
-              <CardTitle className="text-lg">
-                {t("settings.languageTitle")}
-              </CardTitle>
-              <CardDescription>
-                {t("settings.languageDescription")}
-              </CardDescription>
-            </CardHeader>
-            <CardContent className="max-w-xs space-y-1.5">
-              <Label>{t("settings.languageLabel")}</Label>
-              <LanguagePicker label={t("settings.languageLabel")} />
-            </CardContent>
-          </Card>
+          <SettingsGroup>
+            <SettingsRow
+              id="language"
+              label={t("settings.languageTitle")}
+              description={t("settings.languageDescription")}
+              control={
+                <div className="w-56">
+                  <LanguagePicker label={t("settings.languageLabel")} />
+                </div>
+              }
+            />
+            <SettingsRow
+              id="appearance"
+              label={t("settings.appearance")}
+              description={t("settings.appearanceDescription")}
+            >
+              <AppearancePicker
+                onChange={(preset: AppearancePresetId) => {
+                  // Persist server-side so the choice survives reload and syncs
+                  // across devices; the local UI has already updated optimistically.
+                  callAction(
+                    "change-appearance" as any,
+                    { preset } as any,
+                  ).catch(() => {
+                    // Server write failed; the local DOM change still stands.
+                  });
+                }}
+              />
+            </SettingsRow>
+          </SettingsGroup>
 
           {/* Google Calendar Connection */}
           <Card id="google-calendar" className="scroll-mt-16">
@@ -460,32 +478,6 @@ export default function Settings() {
               </div>
             </CardContent>
           </Card>
-
-          {/* Appearance */}
-          <Card id="appearance" className="scroll-mt-16">
-            <CardHeader>
-              <CardTitle className="text-lg">
-                {t("settings.appearance")}
-              </CardTitle>
-              <CardDescription>
-                {t("settings.appearanceDescription")}
-              </CardDescription>
-            </CardHeader>
-            <CardContent>
-              <AppearancePicker
-                onChange={(preset: AppearancePresetId) => {
-                  // Persist server-side so the choice survives reload and syncs
-                  // across devices; the local UI has already updated optimistically.
-                  callAction(
-                    "change-appearance" as any,
-                    { preset } as any,
-                  ).catch(() => {
-                    // Server write failed; the local DOM change still stands.
-                  });
-                }}
-              />
-            </CardContent>
-          </Card>
         </div>
       }
       team={

package/corpus/templates/calendar/changelog/2026-08-01-language-and-appearance-now-sit-together-in-one-preferences-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-01
+---
+
+Language and appearance now sit together in one Preferences card in Settings

package/corpus/templates/calendar/vitest.config.ts

@@ -1,16 +1,20 @@
 import path from "node:path";
 
-import { defineConfig } from "vitest/config";
+import baseConfig from "@agent-native/core/vitest-config";
+import { defineConfig, mergeConfig } from "vitest/config";
 
-export default defineConfig({
-  resolve: {
-    alias: {
-      "@": path.resolve(__dirname, "./app"),
-      "@shared": path.resolve(__dirname, "./shared"),
+export default mergeConfig(
+  baseConfig,
+  defineConfig({
+    resolve: {
+      alias: {
+        "@": path.resolve(__dirname, "./app"),
+        "@shared": path.resolve(__dirname, "./shared"),
+      },
     },
-  },
-  test: {
-    include: ["**/*.{test,spec}.?(c|m)[jt]s?(x)"],
-    exclude: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
-  },
-});
+    test: {
+      include: ["**/*.{test,spec}.?(c|m)[jt]s?(x)"],
+      exclude: ["**/node_modules/**", "**/.git/**", "**/dist/**"],
+    },
+  }),
+);