@agent-native/core 0.141.3 → 0.141.4

package/corpus/templates/slides/app/pages/Index.tsx

@@ -20,7 +20,10 @@ import { useLocation, useNavigate, useSearchParams } from "react-router";
 import { toast } from "sonner";
 
 import DeckCard from "@/components/deck/DeckCard";
-import { NewDeckReferenceStep } from "@/components/editor/NewDeckReferenceStep";
+import {
+  NewDeckReferenceStep,
+  type NewDeckReferenceSelection,
+} from "@/components/editor/NewDeckReferenceStep";
 import PromptPopover, {
   uploadPromptFiles,
   type UploadedFile,
@@ -46,10 +49,10 @@ import { createDeckAgentMessage } from "@/lib/agent-visible-message";
 import { savePromptToComposerDraft } from "@/lib/composer-draft";
 import { sortDecksByRecency } from "@/lib/deck-sorting";
 import {
-  resolveNewDeckReferenceSelection,
-  type NewDeckReferenceSelection,
-} from "@/lib/new-deck-reference-selection";
-import { rememberRecentReference } from "@/lib/recent-references";
+  readRecentReferences,
+  rememberRecentReference,
+  type RecentReference,
+} from "@/lib/recent-references";
 
 const NEW_DECK_DRAFT_SCOPE = "slides-new-deck";
 const PENDING_PROMPT_KEY = "slides:pending-deck-prompt";
@@ -237,6 +240,9 @@ export default function Index() {
   } | null>(null);
   const [showNewDeckReferenceStep, setShowNewDeckReferenceStep] =
     useState(false);
+  const [recentReferences, setRecentReferences] = useState<RecentReference[]>(
+    [],
+  );
   const [referenceImporting, setReferenceImporting] = useState(false);
   const initialPromptConsumedRef = useRef(false);
   const [signInPromptHadFiles, setSignInPromptHadFiles] = useState(false);
@@ -296,11 +302,18 @@ export default function Index() {
     [deckFilter, decks],
   );
   const rememberReference = useCallback(
-    (reference: Parameters<typeof rememberRecentReference>[0]) =>
-      rememberRecentReference(reference),
+    (reference: Parameters<typeof rememberRecentReference>[0]) => {
+      const result = rememberRecentReference(reference);
+      if (result.readable) setRecentReferences(result.items);
+    },
     [],
   );
 
+  useEffect(() => {
+    const result = readRecentReferences();
+    if (result.readable) setRecentReferences(result.items);
+  }, []);
+
   useEffect(() => {
     if (initialDesignSystemId) {
       rememberReference({
@@ -314,15 +327,13 @@ export default function Index() {
   }, [initialDesignSystemId, rememberReference, workspaceReferenceDeckId]);
 
   const initialPrompt = searchParams.get("initialPrompt")?.trim() ?? "";
-  const openInitialPromptReferenceStep = useCallback(() => {
+  const onboardingPreview = searchParams.get("onboarding") === "preview";
+  const openInitialPrompt = useCallback(() => {
     if (!initialPrompt || initialPromptConsumedRef.current) return;
     initialPromptConsumedRef.current = true;
-    setPendingDeck({ prompt: initialPrompt, files: [] });
-    designSystemAutoRef.current = true;
-    referenceDeckAutoRef.current = true;
-    setSelectedDesignSystemId(initialDesignSystemId ?? null);
-    setSelectedReferenceDeckId(workspaceReferenceDeckId ?? null);
-    setShowNewDeckReferenceStep(true);
+    anchorElRef.current = null;
+    setNewDeckInitialPrompt({ text: initialPrompt, key: Date.now() });
+    setShowNewDeckPrompt(true);
     setSearchParams(
       (previous) => {
         const next = new URLSearchParams(previous);
@@ -336,22 +347,39 @@ export default function Index() {
   useEffect(() => {
     if (!initialPrompt || initialPromptConsumedRef.current) return;
     const firstRunActive =
-      typeof document !== "undefined" &&
-      document.cookie
-        .split(";")
-        .some((part) => part.trim().startsWith("agent-native-first-run="));
-    const handleFirstRunCompleted = () => openInitialPromptReferenceStep();
+      onboardingPreview ||
+      (typeof document !== "undefined" &&
+        document.cookie
+          .split(";")
+          .some((part) => part.trim().startsWith("agent-native-first-run=")));
+    const handleFirstRunCompleted = () => openInitialPrompt();
     window.addEventListener(
       "agent-native:first-run-completed",
       handleFirstRunCompleted,
     );
-    if (!firstRunActive) openInitialPromptReferenceStep();
-    return () =>
+    let fallbackTimer: number | undefined;
+    if (!firstRunActive) {
+      openInitialPrompt();
+    } else {
+      // A landing link can open in a tab where the first-run marker exists but
+      // the onboarding surface is not mounted. Do not leave the prompt waiting
+      // forever in that case, while still giving the real onboarding overlay
+      // time to load and dispatch its completion event.
+      fallbackTimer = window.setTimeout(() => {
+        const firstRunSurface = document.querySelector(
+          "[data-onboarding-screen], [data-onboarding-loading]",
+        );
+        if (!firstRunSurface) openInitialPrompt();
+      }, 2500);
+    }
+    return () => {
       window.removeEventListener(
         "agent-native:first-run-completed",
         handleFirstRunCompleted,
       );
-  }, [initialPrompt, openInitialPromptReferenceStep]);
+      if (fallbackTimer !== undefined) window.clearTimeout(fallbackTimer);
+    };
+  }, [initialPrompt, onboardingPreview, openInitialPrompt]);
 
   const setDeckFilter = useCallback(
     (value: string) => {
@@ -504,7 +532,7 @@ export default function Index() {
   const handleCreateDeckWithPrompt = async (
     prompt: string,
     files: UploadedFile[],
-    referenceSelection: Partial<NewDeckReferenceSelection> = {},
+    referenceSelection: NewDeckReferenceSelection = {},
   ) => {
     // Pre-flight auth check. The add-deck action returns 403 silently
     // when unauthenticated, leaving the user stuck on a deck page that
@@ -520,22 +548,14 @@ export default function Index() {
       newDeckRetryFiles,
       files,
     );
-    const resolvedSelection = resolveNewDeckReferenceSelection({
-      designSystemAuto: designSystemAutoRef.current,
-      selectedDesignSystemId,
-      defaultDesignSystemId: initialDesignSystemId,
-      referenceDeckAuto: referenceDeckAutoRef.current,
-      selectedReferenceDeckId,
-      defaultReferenceDeckId: workspaceReferenceDeckId,
-    });
     const designSystemId =
       referenceSelection.designSystemId !== undefined
         ? referenceSelection.designSystemId
-        : resolvedSelection.designSystemId;
+        : selectedDesignSystemId;
     const referenceDeckId =
       referenceSelection.referenceDeckId !== undefined
         ? referenceSelection.referenceDeckId
-        : resolvedSelection.referenceDeckId;
+        : selectedReferenceDeckId;
     const selectedDesignSystem = designSystemId
       ? designSystems.find((ds) => ds.id === designSystemId)
       : undefined;
@@ -608,6 +628,19 @@ export default function Index() {
           "Design system selection:",
           "- None selected. Do not apply a design system unless the user asks for one.",
         ].join("\n");
+    const referenceSource = referenceSelection.referenceSource;
+    const referenceSourceContext = referenceSource
+      ? [
+          "",
+          "Additional reference source selected in the reference step:",
+          `- ${referenceSource.kind}: ${referenceSource.value}`,
+          referenceSource.kind === "google-docs"
+            ? "Call `import-google-doc` before generating and use the returned text as source material."
+            : referenceSource.kind === "website"
+              ? "Call `import-from-url` before generating and use the returned page context as a reference."
+              : "Use the Figma source as the design reference. If Builder or Figma access is required, report the exact connection step instead of guessing.",
+        ].join("\n")
+      : "";
 
     const context = [
       `The user just created a new empty deck (id: "${deckId}") and wants to create a presentation or standalone visual.`,
@@ -616,6 +649,7 @@ export default function Index() {
       fileContext,
       referenceDeckContext,
       designSystemContext,
+      referenceSourceContext,
       "",
       "Before generating, if the request or selected references leave a meaningful choice unresolved, use the `ask-question` tool to ask one concise, prompt-specific question in the inline guided-question flow. Generate the question wording and 2 to 4 options from the user's request and selected references, like Claude's design-question flow; do not use a fixed generic questionnaire. Ask only a choice that materially affects the deck, such as audience, tone, structure, or length. If the prompt already makes the choice clear, do not ask it again. Wait for the user's answer or skip before adding slides.",
       "Start a `manage-progress` run so progress appears in the app header. Add the first slide as soon as it is ready, then continue one slide at a time so the editor visibly fills in.",
@@ -652,64 +686,30 @@ export default function Index() {
     [setNewDeckPromptOpen],
   );
 
-  const handleReferenceDesignSystemSelect = useCallback(
-    (designSystemId: string | null) => {
-      designSystemAutoRef.current = false;
-      setSelectedDesignSystemId(designSystemId);
-      if (designSystemId) {
-        rememberReference({ id: designSystemId, kind: "design-system" });
+  const handleReferenceSelect = useCallback(
+    async (selection: NewDeckReferenceSelection) => {
+      const pending = pendingDeck;
+      if (!pending) return;
+      if (selection.designSystemId) {
+        rememberReference({
+          id: selection.designSystemId,
+          kind: "design-system",
+        });
       }
-    },
-    [rememberReference],
-  );
-
-  const handleReferenceDeckSelect = useCallback(
-    (referenceDeckId: string | null) => {
-      referenceDeckAutoRef.current = false;
-      setSelectedReferenceDeckId(referenceDeckId);
-      if (referenceDeckId) {
-        rememberReference({ id: referenceDeckId, kind: "deck" });
+      if (selection.referenceDeckId) {
+        rememberReference({ id: selection.referenceDeckId, kind: "deck" });
       }
+      setShowNewDeckReferenceStep(false);
+      setPendingDeck(null);
+      await handleCreateDeckWithPrompt(
+        pending.prompt,
+        pending.files,
+        selection,
+      );
     },
-    [rememberReference],
-  );
-
-  const handleGoogleSlidesImported = useCallback(
-    async ({ id, title }: { id: string; title: string }) => {
-      await reloadDecks();
-      rememberReference({ id, kind: "deck" });
-      referenceDeckAutoRef.current = false;
-      setSelectedReferenceDeckId(id);
-      toast.success(t("editorToolbar.importComplete"), {
-        description: title,
-      });
-    },
-    [reloadDecks, rememberReference, t],
+    [handleCreateDeckWithPrompt, pendingDeck, rememberReference],
   );
 
-  const handleReferenceContinue = useCallback(() => {
-    const pending = pendingDeck;
-    if (!pending) return;
-    setShowNewDeckReferenceStep(false);
-    setPendingDeck(null);
-    const selection = resolveNewDeckReferenceSelection({
-      designSystemAuto: designSystemAutoRef.current,
-      selectedDesignSystemId,
-      defaultDesignSystemId: initialDesignSystemId,
-      referenceDeckAuto: referenceDeckAutoRef.current,
-      selectedReferenceDeckId,
-      defaultReferenceDeckId: workspaceReferenceDeckId,
-    });
-    void handleCreateDeckWithPrompt(pending.prompt, pending.files, selection);
-  }, [
-    handleCreateDeckWithPrompt,
-    initialDesignSystemId,
-    pendingDeck,
-    selectedDesignSystemId,
-    selectedReferenceDeckId,
-    workspaceReferenceDeckId,
-  ]);
-
   const handleReferenceImport = useCallback(
     async (files: File[]) => {
       const pending = pendingDeck;
@@ -723,6 +723,10 @@ export default function Index() {
         const pdfReference = uploaded.find((file) =>
           file.originalName.toLowerCase().endsWith(".pdf"),
         );
+        let referenceSelection: NewDeckReferenceSelection = {
+          designSystemId: null,
+          referenceDeckId: null,
+        };
         if (pptxReference) {
           const imported = (await callAction("import-pptx", {
             filePath: pptxReference.path,
@@ -732,8 +736,11 @@ export default function Index() {
           }
           await reloadDecks();
           rememberReference({ id: imported.id, kind: "deck" });
-          referenceDeckAutoRef.current = false;
           setSelectedReferenceDeckId(imported.id);
+          referenceSelection = {
+            designSystemId: null,
+            referenceDeckId: imported.id,
+          };
         }
         if (!pptxReference && pdfReference) {
           const referenceDeck = createDeck(undefined, {
@@ -759,8 +766,11 @@ export default function Index() {
             }
             await reloadDecks();
             rememberReference({ id: referenceDeck.id, kind: "deck" });
-            referenceDeckAutoRef.current = false;
             setSelectedReferenceDeckId(referenceDeck.id);
+            referenceSelection = {
+              designSystemId: null,
+              referenceDeckId: referenceDeck.id,
+            };
           } catch (error) {
             deleteDeck(referenceDeck.id);
             throw error;
@@ -770,19 +780,13 @@ export default function Index() {
         const generationFiles = uploaded.filter(
           (file) => file !== importedReference,
         );
-        if (generationFiles.length > 0) {
-          setPendingDeck((current) =>
-            current
-              ? {
-                  ...current,
-                  files: mergeUploadedFilesForRetry(
-                    current.files,
-                    generationFiles,
-                  ),
-                }
-              : current,
-          );
-        }
+        setShowNewDeckReferenceStep(false);
+        setPendingDeck(null);
+        await handleCreateDeckWithPrompt(
+          pending.prompt,
+          [...pending.files, ...generationFiles],
+          referenceSelection,
+        );
       } catch (error) {
         toast.error(t("editorToolbar.uploadFailed"), {
           description:
@@ -799,6 +803,7 @@ export default function Index() {
       createDeck,
       deleteDeck,
       ensureDeckPersisted,
+      handleCreateDeckWithPrompt,
       pendingDeck,
       reloadDecks,
       rememberReference,
@@ -950,8 +955,8 @@ export default function Index() {
     <main className="min-w-0 flex-1 overflow-y-auto px-4 py-6 sm:px-6 sm:py-10">
       {loading ? (
         <>
-          <div className="flex items-center justify-end mb-4">
-            <div className="h-3 w-16 rounded bg-muted animate-pulse" />
+          <div className="mb-4 flex items-center justify-end">
+            <div className="h-3 w-16 animate-pulse rounded bg-muted" />
           </div>
           <div className="deck-grid-container">
             <div className="deck-grid grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4">
@@ -1150,45 +1155,36 @@ export default function Index() {
       <NewDeckReferenceStep
         open={showNewDeckReferenceStep}
         onOpenChange={(open) => {
-          if (!open) handleReferenceSkip();
+          if (!open) {
+            const prompt = pendingDeck?.prompt;
+            setShowNewDeckReferenceStep(false);
+            setPendingDeck(null);
+            if (prompt) {
+              setNewDeckInitialPrompt({ text: prompt, key: Date.now() });
+              setShowNewDeckPrompt(true);
+            }
+          }
         }}
         designSystems={designSystems}
         decks={decks}
         defaultDesignSystemId={initialDesignSystemId}
         defaultReferenceDeckId={workspaceReferenceDeckId}
-        selectedDesignSystemId={selectedDesignSystemId}
-        selectedReferenceDeckId={selectedReferenceDeckId}
-        onSelectDesignSystem={handleReferenceDesignSystemSelect}
-        onSelectReferenceDeck={handleReferenceDeckSelect}
+        recentReferences={recentReferences}
+        onSelect={(selection) => void handleReferenceSelect(selection)}
         onImport={handleReferenceImport}
-        onGoogleSlidesImported={handleGoogleSlidesImported}
-        onContinue={handleReferenceContinue}
         onSkip={handleReferenceSkip}
         importing={referenceImporting}
-        title={t("home.referenceReviewTitle")}
-        description={t("home.referenceReviewDescription")}
+        title={t("home.newDeckPromptTitle")}
         designSystemLabel={t("home.designSystem")}
         referenceDeckLabel={t("home.referenceDeck")}
-        noneLabel={t("home.none")}
-        importFileLabel={t("editorToolbar.importFile")}
+        chooseDeckLabel={t("home.referenceDeckPlaceholder")}
         importingLabel={t("editorToolbar.importing")}
-        continueLabel={t("designSystemSetup.continueToGeneration")}
-        skipLabel={t("home.skipReferences")}
+        skipLabel={t("home.referenceDeckNone")}
         defaultSuffix={t("home.defaultSuffix")}
         starredLabel={t("home.referenceDeckStarredGroup")}
         otherDecksLabel={t("home.referenceDeckOtherGroup")}
         searchDecksLabel={t("root.searchDecks")}
-        chooseAnotherDeckLabel={t("home.chooseAnotherDeck")}
-        noMatchingDecksLabel={t("home.noMatchingDecks")}
-        googleSlidesTitle={t("home.googleSlidesReferenceTitle")}
-        googleSlidesConnectLabel={t("home.googleSlidesReferenceConnect")}
-        googleSlidesChooseLabel={t("home.googleSlidesReferenceChoose")}
-        googleSlidesPickingLabel={t("home.googleSlidesReferencePicking")}
-        googleSlidesConnectedLabel={t("home.googleSlidesReferenceConnected")}
-        googleSlidesUnavailableLabel={t(
-          "home.googleSlidesReferenceUnavailable",
-        )}
-        promptNote={pendingDeck?.prompt}
+        promptSummary={pendingDeck?.prompt}
       />
 
       {/* Sign-in required to create a deck. Shown when an unauthenticated
@@ -1227,23 +1223,17 @@ function EmptyState({
 }) {
   const t = useT();
   return (
-    <div className="flex flex-col items-center justify-center min-h-[60vh] text-center">
-      <div className="w-16 h-16 rounded-2xl bg-gradient-to-br from-[#609FF8]/20 to-[#4080E0]/20 border border-[#609FF8]/20 flex items-center justify-center mb-6">
-        <IconStack2 className="w-7 h-7 text-[#609FF8]" />
-      </div>
-      <h2 className="text-xl font-semibold text-foreground mb-2">
+    <div className="flex min-h-[60vh] flex-col items-center justify-center gap-5 text-center">
+      <h2 className="text-xl font-semibold text-foreground">
         {t("home.emptyTitle")}
       </h2>
-      <p className="text-sm text-muted-foreground max-w-sm mb-8 leading-relaxed">
-        {t("home.emptyDescription")}
-      </p>
       <Button
         onClick={(e: React.MouseEvent<HTMLButtonElement>) =>
           onCreateDeck(e as React.MouseEvent<HTMLElement>)
         }
       >
-        <IconPlus className="w-4 h-4" />
-        {t("home.newDeck")}
+        <IconPlus className="size-4" />
+        {t("home.createFirstDeck")}
       </Button>
     </div>
   );

package/corpus/templates/slides/app/root.tsx

@@ -16,6 +16,7 @@ import {
   CommandMenu,
   useCommandMenuShortcut,
 } from "@agent-native/core/client/navigation";
+import { registerFirstRunOnboardingExtension } from "@agent-native/core/client/onboarding";
 import { getThemeInitScript } from "@agent-native/core/client/ui";
 import { IconHierarchy2, IconSun, IconMoon } from "@tabler/icons-react";
 import { useQueryClient } from "@tanstack/react-query";
@@ -33,6 +34,7 @@ import {
 import type { LinksFunction } from "react-router";
 
 import { Layout as AppLayout } from "@/components/layout/Layout";
+import { FirstDeckOnboardingFlow } from "@/components/onboarding/FirstDeckOnboardingFlow";
 import { AppToolkitProvider } from "@/components/ui/toolkit-provider";
 import { DeckProvider } from "@/context/DeckContext";
 import { useNavigationState } from "@/hooks/use-navigation-state";
@@ -42,6 +44,12 @@ import changelog from "../CHANGELOG.md?raw";
 import { i18nCatalog } from "./i18n";
 
 import stylesheet from "./global.css?url";
+
+registerFirstRunOnboardingExtension({
+  id: "slides-first-deck",
+  component: FirstDeckOnboardingFlow,
+});
+
 configureTracking({
   getDefaultProps: (_name, properties) => ({
     ...properties,

package/corpus/templates/slides/changelog/2026-08-05-deck-browsing-keeps-all-and-mine-in-the-header-with-a-tighte.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-05
+---
+
+Deck browsing keeps All and Mine in the header with a tighter grid layout.

package/corpus/templates/slides/changelog/2026-08-05-new-deck-creation-now-flows-through-a-clean-full-screen-refe.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-05
+---
+
+New deck creation now flows through a clean full-screen reference step

package/corpus/templates/slides/changelog/2026-08-05-website-imports-now-include-linked-stylesheets-for-more-accu.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-05
+---
+
+Website imports now include linked stylesheets for more accurate brand colors and fonts

package/corpus/templates/slides/server/lib/comment-notifications.ts

@@ -21,6 +21,7 @@ import { and, eq } from "drizzle-orm";
 import { getDeckUrl } from "../../actions/_app-url.js";
 import { SLIDES_USER_PREFS_KEY } from "../../shared/slides-user-prefs.js";
 import { getDb, schema } from "../db/index.js";
+import { SLIDES_DECK_COMMENT_EMAIL_ID } from "./emails.js";
 
 /**
  * `deck-missing` stays distinct from `no-recipients`: one means the deck could
@@ -99,6 +100,41 @@ async function threadParticipants(
   return rows.map((row) => row.authorEmail);
 }
 
+export function renderDeckCommentEmail({
+  actor,
+  title,
+  url,
+  content,
+  isReply,
+}: {
+  actor: string;
+  title: string;
+  url: string;
+  content: string;
+  isReply: boolean;
+}) {
+  return {
+    subject: isReply
+      ? `${actor} replied to a comment on "${title}"`
+      : `${actor} commented on "${title}"`,
+    ...renderEmail({
+      preheader: isReply
+        ? `${actor} replied to a comment on ${title}.`
+        : `${actor} commented on ${title}.`,
+      heading: isReply ? "New reply on your deck" : "New comment",
+      paragraphs: [
+        isReply
+          ? `${emailStrong(actor)} replied in a comment thread on ${emailStrong(title)}.`
+          : `${emailStrong(actor)} commented on ${emailStrong(title)}.`,
+        `"${excerpt(content)}"`,
+      ],
+      cta: { label: "Open deck", url },
+      footer:
+        "You received this because you own or participated in this thread. Turn these off in Slides settings.",
+    }),
+  };
+}
+
 export async function notifyDeckComment(input: {
   deckId: string;
   slideId: string;
@@ -153,29 +189,16 @@ async function deliverDeckCommentEmails(input: {
     preferenceKey: SLIDES_USER_PREFS_KEY,
     logLabel: LOG_LABEL,
     send: async (to) => {
-      const { html, text } = renderEmail({
-        preheader: input.isReply
-          ? `${actor} replied to a comment on ${deck.title}.`
-          : `${actor} commented on ${deck.title}.`,
-        heading: input.isReply ? "New reply on your deck" : "New comment",
-        paragraphs: [
-          input.isReply
-            ? `${emailStrong(actor)} replied in a comment thread on ${emailStrong(deck.title)}.`
-            : `${emailStrong(actor)} commented on ${emailStrong(deck.title)}.`,
-          `"${excerpt(input.content)}"`,
-        ],
-        cta: { label: "Open deck", url },
-        footer:
-          "You received this because you own or participated in this thread. Turn these off in Slides settings.",
-      });
-
       await sendEmail({
+        ...renderDeckCommentEmail({
+          actor,
+          title: deck.title,
+          url,
+          content: input.content,
+          isReply: input.isReply,
+        }),
         to,
-        subject: input.isReply
-          ? `${actor} replied to a comment on "${deck.title}"`
-          : `${actor} commented on "${deck.title}"`,
-        html,
-        text,
+        templateId: SLIDES_DECK_COMMENT_EMAIL_ID,
       });
     },
   });

package/corpus/templates/slides/server/lib/emails.ts

@@ -0,0 +1,40 @@
+/**
+ * Catalog entries for the transactional emails Slides sends.
+ *
+ * Registered from `server/plugins/transactional-emails.ts` so Dispatch can list
+ * and preview them without the app having sent anything yet.
+ */
+
+import { defineTransactionalEmail } from "@agent-native/core/email-catalog";
+
+import { renderDeckCommentEmail } from "./comment-notifications.js";
+
+export const SLIDES_DECK_COMMENT_EMAIL_ID = "slides.deck-comment";
+
+let registered = false;
+
+export function registerSlidesEmails(): void {
+  if (registered) return;
+  registered = true;
+
+  defineTransactionalEmail({
+    id: SLIDES_DECK_COMMENT_EMAIL_ID,
+    name: "Deck comment",
+    trigger:
+      "Someone posts a comment or a thread reply on a slide. Subject and copy differ slightly for a reply; both send under this id.",
+    recipientLabel: "Deck owner and authors",
+    recipient:
+      "The deck owner, plus every prior author in the thread when the new comment is a reply. The list is re-checked against the deck's live ACL and filtered by each user's `emailNotifications` preference; the comment's own author never receives it.",
+    senderLabel: "Default sender",
+    sender:
+      "The configured default sender. This call site sets no `from`, `fromName`, `replyTo`, or `appSender`.",
+    preview: () =>
+      renderDeckCommentEmail({
+        actor: "Sam Rivera",
+        title: "Series A narrative",
+        url: "https://example.com/decks/deck_sample?slide=3",
+        content: "Slide 3 needs the updated revenue chart before Thursday.",
+        isReply: false,
+      }),
+  });
+}

package/corpus/templates/slides/server/plugins/transactional-emails.ts

@@ -0,0 +1,5 @@
+import { registerSlidesEmails } from "../lib/emails.js";
+
+export default function registerTransactionalEmails(): void {
+  registerSlidesEmails();
+}

package/dist/brand-kit/index.d.ts

@@ -16,5 +16,6 @@
  */
 export * from "./types.js";
 export * from "./brand-signals.js";
+export * from "./tokens.js";
 export { extractDesignTokensFromUrl, validateUrl, parseOwnerRepo, fetchGitHubJson, fetchGitHubJsonResult, fetchGitHubRaw, parseTailwindConfig, parseCss, detectStylingFramework, createCodeAnalysisState, analyzeCodeFile, analyzeCssFile, analyzeTailwindConfig, analyzeJsonTheme, analyzePackageJson, analyzeThemeSourceFile, addFont, extractCssVars, extractCodeColors, extractCodeFonts, extractDocumentColors, extractDocumentFonts, classifyFile, suggestionsForType, unique, MAX_FILES, MAX_FILE_SIZE, FETCH_TIMEOUT, ROOT_PATTERNS, SECONDARY_PATHS, CODE_MAX_FILES, CODE_MAX_TOTAL_BYTES, } from "../server/design-token-utils.js";
 export type { ContentType, ParsedCss, ParsedTailwindConfig, CodeAnalysisState, UrlExtractionResult, GitHubFetchOptions, GitHubJsonResult, } from "../server/design-token-utils.js";

package/dist/brand-kit/index.js

@@ -16,6 +16,7 @@
  */
 export * from "./types.js";
 export * from "./brand-signals.js";
+export * from "./tokens.js";
 // Import-source parsing + token extraction (Tailwind/CSS/GitHub/URL/document/
 // code analysis). These already power the import-* actions across templates.
 export {