@agent-native/core 0.149.2 → 0.149.3

package/corpus/templates/slides/app/components/editor/SlideEditor.tsx

@@ -532,6 +532,8 @@ interface SlideEditorProps {
    *  shell above the slide rail. Selection state lives here, so the toolbar is
    *  portaled out rather than lifted. Falls back to rendering in place. */
   contextToolbarSlot?: HTMLElement | null;
+  /** Wide editor-shell host for the toolbar's top-row placement. */
+  wideContextToolbarSlot?: HTMLElement | null;
   /** Selection-independent actions for the head of the contextual toolbar. */
   contextToolbarLeading?: ReactNode;
   onGenerateImage: () => void;
@@ -564,8 +566,6 @@ interface SlideEditorProps {
   onComment?: (quotedText: string) => void;
   /** Zero-based index of the current slide */
   slideIndex?: number;
-  /** Total number of slides in the deck */
-  slideCount?: number;
   /** Design system to inject as CSS custom properties on the slide */
   designSystem?: DesignSystemData;
   /** Deck aspect ratio (defaults to 16:9 when omitted) */
@@ -647,10 +647,15 @@ function SameSlidePresenceIndicator({ users }: { users: CollabUser[] }) {
   if (users.length === 0) return null;
   const visible = users.slice(0, 3);
   const overflow = users.length - visible.length;
+  const agentIsPresent = users.some(
+    (user) => user.email.trim().toLowerCase() === "agent@system",
+  );
   const label =
-    users.length === 1
-      ? `${users[0].name} is here`
-      : `${users.length} others here`;
+    agentIsPresent && users.length === 1
+      ? "AI editing"
+      : users.length === 1
+        ? `${users[0].name} is here`
+        : `${users.length} others here`;
   return (
     <div className="pointer-events-auto flex items-center gap-1.5 rounded-full border border-border bg-popover/95 py-1 pl-1 pr-2.5 text-xs text-popover-foreground shadow-lg">
       <div className="flex items-center">
@@ -993,6 +998,7 @@ export default function SlideEditor({
   onUpdateSlide,
   readOnly = false,
   contextToolbarSlot,
+  wideContextToolbarSlot,
   contextToolbarLeading,
   onGenerateImage,
   onOpenAssetLibrary,
@@ -1004,7 +1010,6 @@ export default function SlideEditor({
   onToggleObjectFit,
   agentActive,
   slideIndex = 0,
-  slideCount = 1,
   designSystem,
   aspectRatio,
   drawMode,
@@ -4198,6 +4203,27 @@ export default function SlideEditor({
       // the button's onClick runs, so partial-text formatting would silently
       // apply to the whole object.
       data-slide-inline-edit-surface="true"
+      data-slide-context-toolbar-placement="row"
+      onPointerDownCapture={preserveRichTextSelection}
+    >
+      <SlideContextToolbar
+        snapshot={selectedStyleSnapshot}
+        background={slide.background}
+        designSystem={designSystem}
+        leading={contextToolbarLeading}
+        onChange={applySelectedStylePatch}
+        onBackgroundChange={applySlideBackground}
+        onArrange={handleArrangeSelected}
+        onToggleList={handleToggleList}
+      />
+    </div>
+  ) : null;
+
+  const wideContextToolbar = !readOnly ? (
+    <div
+      className="shrink-0"
+      data-slide-inline-edit-surface="true"
+      data-slide-context-toolbar-placement="top"
       onPointerDownCapture={preserveRichTextSelection}
     >
       <SlideContextToolbar
@@ -4209,15 +4235,19 @@ export default function SlideEditor({
         onBackgroundChange={applySlideBackground}
         onArrange={handleArrangeSelected}
         onToggleList={handleToggleList}
+        className="slide-context-toolbar--top-row"
       />
     </div>
   ) : null;
 
   return (
     <div
-      className="relative flex h-full min-h-0 flex-1 flex-col overflow-hidden"
+      className="relative flex h-full min-h-0 flex-1 flex-col overflow-hidden rounded-l-lg bg-[var(--slides-editor-surface)]"
       data-slide-element-selected={slideElementSelected ? "true" : undefined}
     >
+      {!readOnly && wideContextToolbarSlot
+        ? createPortal(wideContextToolbar, wideContextToolbarSlot)
+        : null}
       {contextToolbarSlot
         ? createPortal(contextToolbar, contextToolbarSlot)
         : contextToolbar}
@@ -4225,7 +4255,7 @@ export default function SlideEditor({
       <div className="flex min-h-0 flex-1 overflow-hidden">
         <div className="min-w-0 flex-1 overflow-hidden">
           {slide.excalidrawData ? (
-            <div className="relative h-full bg-background">
+            <div className="relative h-full bg-[var(--slides-editor-surface)]">
               {!readOnly && (
                 <ExcalidrawExitButton
                   // JSON.stringify drops `undefined` properties before the patch
@@ -4245,8 +4275,8 @@ export default function SlideEditor({
               />
             </div>
           ) : (
-            <div className="relative h-full bg-background">
-              <div className="absolute right-3 top-3 z-20 flex h-8 items-center gap-0.5 rounded-md border border-border bg-popover/95 px-1 shadow-lg">
+            <div className="relative h-full bg-[var(--slides-editor-surface)]">
+              <div className="absolute right-3 top-3 z-20 flex h-8 items-center gap-0.5 rounded-md bg-popover/95 px-1">
                 <Tooltip>
                   <TooltipTrigger asChild>
                     <Button
@@ -4385,8 +4415,6 @@ export default function SlideEditor({
       <SpeakerNotesPanel
         notes={slide.notes}
         onChange={(notes) => onUpdateSlide({ notes })}
-        slideIndex={slideIndex}
-        slideCount={slideCount}
         readOnly={readOnly}
       />
 

package/corpus/templates/slides/app/components/editor/SpeakerNotesPanel.tsx

@@ -5,8 +5,6 @@ import { useState, type PointerEvent as ReactPointerEvent } from "react";
 interface SpeakerNotesPanelProps {
   notes: string;
   onChange: (notes: string) => void;
-  slideIndex: number;
-  slideCount: number;
   readOnly?: boolean;
 }
 
@@ -21,16 +19,15 @@ function clampNotesHeight(value: number) {
 export function SpeakerNotesPanel({
   notes,
   onChange,
-  slideIndex,
-  slideCount,
   readOnly = false,
 }: SpeakerNotesPanelProps) {
   const t = useT();
   const [expanded, setExpanded] = useState(() => {
     try {
-      return localStorage.getItem("speaker-notes-expanded") !== "false";
+      return localStorage.getItem("speaker-notes-expanded") === "true";
     } catch {
-      return true;
+      // coercion-ok: browser storage is optional; the collapsed state is the default.
+      return false;
     }
   });
   const [height, setHeight] = useState(() => {
@@ -74,7 +71,7 @@ export function SpeakerNotesPanel({
   };
 
   return (
-    <div className="flex-shrink-0 border-t border-border bg-background">
+    <div className="flex-shrink-0 bg-[var(--slides-editor-surface)]">
       {expanded && (
         <div
           role="separator"
@@ -83,7 +80,7 @@ export function SpeakerNotesPanel({
           className="group flex h-2 cursor-row-resize items-center justify-center"
           onPointerDown={startResize}
         >
-          <div className="h-px w-10 rounded-full bg-border transition-colors group-hover:bg-muted-foreground/70" />
+          <div className="h-px w-10 rounded-full bg-muted-foreground/30 transition-colors group-hover:bg-muted-foreground/70" />
         </div>
       )}
       <button
@@ -91,10 +88,7 @@ export function SpeakerNotesPanel({
         className="flex w-full cursor-pointer items-center justify-between px-4 py-1.5"
       >
         <span className="text-[10px] font-medium text-muted-foreground uppercase tracking-wider">
-          {t("raw.speakerNotesForSlide", {
-            index: slideIndex + 1,
-            count: slideCount,
-          })}
+          {t("raw.speakerNotes")}
         </span>
         {expanded ? (
           <IconChevronDown className="w-3 h-3 text-muted-foreground" />

package/corpus/templates/slides/app/components/editor/editor-command-model.ts

@@ -0,0 +1,35 @@
+import type { ComponentType } from "react";
+
+export type EditorCommandGroup =
+  | "media"
+  | "slideTools"
+  | "comments"
+  | "deck"
+  | "other";
+
+export interface EditorCommand {
+  id: string;
+  group: EditorCommandGroup;
+  label: string;
+  keywords?: string[];
+  icon?: ComponentType<{ className?: string; size?: number }>;
+  active?: boolean;
+  run: () => void;
+}
+
+const EMPTY_COMMANDS: readonly EditorCommand[] = [];
+type EditorCommandSource = () => readonly EditorCommand[];
+
+let activeCommandSource: EditorCommandSource | null = null;
+
+export function registerEditorCommands(source: EditorCommandSource) {
+  activeCommandSource = source;
+
+  return () => {
+    if (activeCommandSource === source) activeCommandSource = null;
+  };
+}
+
+export function getEditorCommands(): readonly EditorCommand[] {
+  return activeCommandSource?.() ?? EMPTY_COMMANDS;
+}

package/corpus/templates/slides/app/components/layout/Sidebar.tsx

@@ -6,8 +6,8 @@ import { OrgSwitcher } from "@agent-native/core/client/org";
 import { FeedbackButton } from "@agent-native/core/client/ui";
 import { SidebarFooterActions } from "@agent-native/toolkit/app-shell";
 import {
-  IconStack2,
-  IconPalette,
+  IconLayoutGrid,
+  IconComponents,
   IconSettings,
   IconLayoutSidebarLeftCollapse,
   IconLayoutSidebarLeftExpand,
@@ -23,9 +23,9 @@ import {
 import { cn } from "@/lib/utils";
 
 const navItems = [
-  { icon: IconStack2, labelKey: "navigation.decks", href: "/" },
+  { icon: IconLayoutGrid, labelKey: "navigation.decks", href: "/" },
   {
-    icon: IconPalette,
+    icon: IconComponents,
     labelKey: "navigation.designSystems",
     href: "/design-systems",
   },
@@ -161,8 +161,8 @@ export function Sidebar({ collapsed, onToggleCollapsed }: SidebarProps) {
 
   if (collapsed) {
     return (
-      <aside className="flex h-full w-12 shrink-0 flex-col items-center overflow-hidden border-e border-border bg-sidebar text-sidebar-foreground transition-[width] duration-200 ease-out">
-        <div className="flex h-12 w-full shrink-0 items-center justify-center border-b border-border">
+      <aside className="flex h-full w-12 shrink-0 flex-col items-center overflow-hidden bg-sidebar text-sidebar-foreground transition-[width] duration-200 ease-out">
+        <div className="flex h-12 w-full shrink-0 items-center justify-center">
           {brandControl}
         </div>
         <nav className="flex min-h-0 flex-1 flex-col items-center gap-1 overflow-y-auto pt-1">
@@ -224,10 +224,8 @@ export function Sidebar({ collapsed, onToggleCollapsed }: SidebarProps) {
   }
 
   return (
-    <aside className="flex h-full w-56 min-w-0 shrink-0 flex-col overflow-hidden border-e border-border bg-sidebar text-sidebar-foreground transition-[width] duration-200 ease-out">
-      <div className="flex h-12 shrink-0 items-center border-b border-border px-4">
-        {brandControl}
-      </div>
+    <aside className="flex h-full w-56 min-w-0 shrink-0 flex-col overflow-hidden bg-sidebar text-sidebar-foreground transition-[width] duration-200 ease-out">
+      <div className="flex h-12 shrink-0 items-center px-4">{brandControl}</div>
 
       <div className="flex min-h-0 flex-1 flex-col overflow-y-auto">
         <nav className="space-y-1 px-2 py-2">

package/corpus/templates/slides/app/context/DeckContext.tsx

@@ -8,6 +8,7 @@ import { callAction } from "@agent-native/core/client/hooks";
 import { isEmbedAuthActive } from "@agent-native/core/client/host";
 import { useOrg } from "@agent-native/core/client/org";
 import { subscribeSyncEvents } from "@agent-native/core/client/use-db-sync";
+import { DEFAULT_DECK_TITLE } from "@shared/deck-title";
 import { nanoid } from "nanoid";
 import {
   createContext,
@@ -1760,7 +1761,7 @@ export function DeckProvider({ children }: { children: ReactNode }) {
       const insertIndex = decksRef.current.length;
       const newDeck: Deck = {
         id: nanoid(10),
-        title: title || "Untitled Deck",
+        title: title?.trim() || DEFAULT_DECK_TITLE,
         createdAt: new Date().toISOString(),
         updatedAt: new Date().toISOString(),
         createdByMe: true,

package/corpus/templates/slides/app/global.css

@@ -143,7 +143,7 @@ button[title="Open agent sidebar"] {
 }
 
 .slide-style-inspector .slides-inspector-section {
-  border-bottom: 1px solid var(--slides-inspector-divider);
+  border-bottom: 0;
   border-radius: 0;
   padding: 0.625rem 0.75rem;
 }
@@ -239,6 +239,81 @@ button[title="Open agent sidebar"] {
   container-type: inline-size;
 }
 
+.deck-editor-shell {
+  --slides-editor-surface: hsl(var(--background));
+  container-type: inline-size;
+  container-name: deck-editor;
+}
+
+@supports (background: color-mix(in srgb, white, black)) {
+  .deck-editor-shell {
+    --slides-editor-surface: color-mix(
+      in srgb,
+      hsl(var(--background)) 35%,
+      var(--agent-native-lower-surface, hsl(var(--background))) 65%
+    );
+  }
+}
+
+.deck-editor-context-toolbar-host {
+  min-width: 0;
+  overflow: hidden;
+}
+
+.deck-editor-context-toolbar-host--wide {
+  display: none;
+}
+
+.deck-editor-context-toolbar-host--narrow {
+  display: flex;
+  justify-content: flex-end;
+}
+
+.deck-editor-context-toolbar-host--narrow
+  > [data-slide-inline-edit-surface="true"] {
+  min-width: 0;
+  width: fit-content;
+  max-width: 100%;
+  flex: 0 1 auto;
+}
+
+@container deck-editor (max-width: 1149px) {
+  .deck-editor-context-toolbar-host--wide {
+    display: none;
+  }
+
+  .deck-editor-context-toolbar-host--narrow {
+    display: flex;
+  }
+}
+
+@container deck-editor (min-width: 1150px) {
+  .deck-editor-context-toolbar-host--narrow {
+    display: none;
+  }
+
+  .deck-editor-context-toolbar-host--wide[data-context-toolbar-visible="true"] {
+    display: flex;
+    flex: 1 1 0%;
+    align-items: center;
+    justify-content: flex-end;
+  }
+
+  .deck-editor-context-toolbar-host--wide
+    > [data-slide-inline-edit-surface="true"] {
+    min-width: 0;
+    max-width: 100%;
+  }
+
+  .deck-editor-context-toolbar-host--wide .slide-context-toolbar--top-row {
+    height: 2.75rem;
+    justify-content: flex-end;
+    border: 0;
+    background: transparent;
+    padding-inline: 0;
+  }
+}
+
 @container (max-width: 36rem) {
   .deck-grid {
     grid-template-columns: minmax(0, 1fr);

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

@@ -659,6 +659,7 @@ const messages = {
     deckCount_other: "decks",
     createDeckOrVisual: "Create a presentation",
     noMineDecks: "No decks created by you yet.",
+    noDecksMatchSearch: "No decks match your search.",
     deleteDeckTitle: "Delete Deck?",
     deleteDeckDescription:
       "This will permanently delete this deck and all its slides. This action cannot be undone.",

package/corpus/templates/slides/app/lib/create-deck-generation.ts

@@ -91,6 +91,30 @@ async function loadReferenceDeckGenerationContext(
   ].join("\n");
 }
 
+export function isSourceImprovementRequest(
+  prompt: string,
+  files: UploadedFile[],
+): boolean {
+  const hasSourceDeck = files.some((file) =>
+    /\.(pptx|pdf)$/i.test(file.originalName),
+  );
+  if (!hasSourceDeck) return false;
+
+  const normalized = prompt.toLowerCase();
+  const asksToImprove =
+    /\b(restyl\w*|redesign\w*|rebrand\w*|revamp\w*|rework\w*|moderni[sz]\w*|refresh\w*|polish\w*|improv\w*|updat\w*|revis\w*|edit\w*)\b/.test(
+      normalized,
+    ) ||
+    /\bmake\b[\s\S]{0,40}\b(better|modern|professional|polished|prett\w*)\b/.test(
+      normalized,
+    );
+  // A source deck attachment is the object being improved even when the
+  // prompt uses an implicit phrase such as "make this prettier". Requiring a
+  // source noun here silently falls back to reference-only generation and can
+  // discard the uploaded deck's slide IDs and content.
+  return asksToImprove;
+}
+
 function describeUploadedFilesForAgent(
   files: UploadedFile[],
   deckId: string,
@@ -103,25 +127,26 @@ function describeUploadedFilesForAgent(
         `- ${file.originalName} (${file.type}, ${(file.size / 1024).toFixed(1)}KB) at path: ${file.path}${file.url ? `; embeddable URL: ${file.url}` : ""}`,
     )
     .join("\n");
-  const sourceFile = importedSourceDeck?.file;
   return [
     "",
     importedSourceDeck
-      ? `The user uploaded ${files.length} file(s). The ${sourceFile?.originalName ?? importedSourceDeck.format.toUpperCase()} source deck has already been imported into target deck ${deckId} with ${importedSourceDeck.slideCount} source slide(s); do not import it again.`
-      : `The user uploaded ${files.length} file(s). These are mandatory source material, not optional references — process every one of them with the matching import action BEFORE adding the first slide:`,
+      ? `The user uploaded ${files.length} file(s). The ${importedSourceDeck.file.originalName} source deck has already been imported into target deck ${deckId} with ${importedSourceDeck.slideCount} source slide(s); do not import it again.`
+      : `The user attached ${files.length} file(s) as reference material for this new deck. Attachments are context for the agent by default; do not import or append their slides to target deck ${deckId} merely because they were attached.`,
     fileList,
     "",
     "File handling rules:",
     importedSourceDeck
-      ? "- The imported source deck is the canonical source. Preserve its slide count, order, IDs, factual copy, notes, imagery, charts, tables, diagrams, and freeform objects while improving styling. For a deck-wide restyle, use one patch-deck call with requireAllSourceSlides=true; use update-slide only for a targeted one-slide edit. Do not rebuild it with add-slide."
-      : `- PPTX files: call \`import-pptx --filePath \"<path>\" --deckId ${deckId}\` before adding or editing slides.`,
+      ? "- The imported source deck is canonical. Preserve its slide count, order, IDs, factual copy, notes, imagery, charts, tables, diagrams, and freeform objects while improving styling. For a deck-wide restyle, use one patch-deck call with requireAllSourceSlides=true; use update-slide only for a targeted one-slide edit. Do not rebuild it with add-slide."
+      : `- PDF, PPTX, and DOCX files: call \`import-file --filePath \"<path>\" --format auto\` (without \`importIntoDeck\`) when you need their text or structure. Use the returned material as reference while creating new slides with \`add-slide\`.`,
     importedSourceDeck
       ? "- For a PDF source, keep the original full-page image in every slide and add restrained design-system chrome around it without obscuring source content. Never OCR-reconstruct a source-faithful page from extracted text."
-      : `- PDF and DOCX files: call \`import-file --filePath \"<path>\" --format auto --deckId ${deckId}\` and use the returned extracted text as source material. The returned text is capped for reliability; re-run with maxChars only if more context is needed. For a visual PDF whose original layout should be preserved, pass \`--importIntoDeck true\` instead of rebuilding the pages from extracted text. Do not proceed to add-slide until this call has returned for every PDF/DOCX in the list above.`,
+      : "- Do not pass `importIntoDeck: true` for an attached file unless the user explicitly asks to import or preserve the source pages in the current deck. An attached reference is not an instruction to replace or seed the deck.",
     "- Text-like files: use the uploaded-text-file blocks already included in the prompt; do not call import-file for them.",
     '- Image files with an embeddable URL are mandatory assets: if the user specified where to use one (e.g. "on the first and last slide"), embed it there with `<img src="...">` exactly as requested. Do not omit a requested image and continue silently — if it truly cannot be placed, say why in your final chat response.',
     "- Image files without a URL are visual/reference assets only; do not claim to have processed a PPTX/PDF/DOCX unless the relevant import action succeeds.",
-    "- Before your final response, verify every uploaded file above was either imported (PPTX/PDF/DOCX) or placed as requested (images). If any file's content or requested placement is missing from the deck, say so explicitly instead of reporting success.",
+    importedSourceDeck
+      ? "- Before your final response, verify the same source slide IDs and count with get-deck after the restyle. If source fidelity is partial or images were skipped, report the exact warning instead of claiming success."
+      : "- Before your final response, verify every uploaded file above was either used as reference or placed as explicitly requested. If any file's content or requested placement is missing from the deck, say so explicitly instead of reporting success.",
   ].join("\n");
 }
 
@@ -179,7 +204,7 @@ export interface StartDeckGenerationOptions {
     files: UploadedFile[],
     failure: DeckPersistenceResult,
   ) => void;
-  onSetupFailure: (
+  onSetupFailure?: (
     prompt: string,
     files: UploadedFile[],
     failure: unknown,
@@ -248,15 +273,17 @@ export async function startDeckGeneration({
   }
 
   let importedSourceDeck: ImportedSourceDeck | null = null;
-  try {
-    importedSourceDeck = await importUploadedDeckIntoDeck(
-      filesForGeneration,
-      deckId,
-    );
-  } catch (error) {
-    deleteDeck(deckId);
-    onSetupFailure(prompt, filesForGeneration, error);
-    return "failed";
+  if (isSourceImprovementRequest(prompt, filesForGeneration)) {
+    try {
+      importedSourceDeck = await importUploadedDeckIntoDeck(
+        filesForGeneration,
+        deckId,
+      );
+    } catch (error) {
+      deleteDeck(deckId);
+      onSetupFailure?.(prompt, filesForGeneration, error);
+      return "failed";
+    }
   }
 
   onPromptClosed();
@@ -324,20 +351,21 @@ export async function startDeckGeneration({
         "Source-preserving improvement mode:",
         `- The target deck already contains ${importedSourceDeck.slideCount} imported source slides. Treat those slides as the user's complete source, not as inspiration for a new deck.`,
         "- Keep the exact source slide count, order, IDs, factual meaning, notes, images, charts, tables, diagrams, and freeform objects unless the user explicitly asks to change one of them.",
-        "- Read `get-deck` once before editing to obtain every existing slide ID and source HTML, load the linked design system with `get-design-system`, then make a deck-wide restyle with one `patch-deck` call using `requireAllSourceSlides: true` and one `patch-slide` operation with `fields.content` for every source slide ID. Do not split a full-deck restyle into arbitrary batches or fall back to one-by-one `update-slide` calls; use `update-slide` only for a targeted one-slide edit. Keep every original `<img>` source and enough original factual copy for each slide; for PDF slides, use restrained design-system chrome around the page without obscuring it.",
-        "- Do not call `add-slide`, delete slides, reorder slides, or replace source images with generic cards. Do not claim success until `get-deck` verifies the same slide IDs and count after the edits.",
-        '- After the patch succeeds, verify with `get-deck` using `compact: "true"` so only slide IDs, count, and previews are returned. Do not report an initial or partial pass, and do not leave any source slides for a later run.',
-        "- If `get-deck` reports partial source fidelity or skipped images, stop and report the exact warning instead of claiming a reliable restyle.",
+        "- Read get-deck once before editing to obtain every existing slide ID and source HTML, load the linked design system with get-design-system, then make a deck-wide restyle with one patch-deck call using requireAllSourceSlides=true and one patch-slide operation with fields.content for every source slide ID. Do not split a full-deck restyle into arbitrary batches or fall back to one-by-one update-slide calls; use update-slide only for a targeted one-slide edit. Keep every original image source and enough original factual copy for each slide; for PDF slides, use restrained design-system chrome around the page without obscuring it.",
+        "- Do not call add-slide, delete slides, reorder slides, or replace source images with generic cards. Do not claim success until get-deck verifies the same slide IDs and count after the edits.",
+        '- After the patch succeeds, verify with get-deck using compact: "true" so only slide IDs, count, and previews are returned. Do not report an initial or partial pass, and do not leave any source slides for a later run.',
+        "- If get-deck reports partial source fidelity or skipped images, stop and report the exact warning instead of claiming a reliable restyle.",
       ].join("\n")
     : "";
   const sourceModeInstructions = importedSourceDeck
     ? [
         "The request is an in-place visual improvement of an imported source deck. Make a coherent style pass across every existing slide while preserving all source content and media.",
         "Do not use the new-deck add-slide workflow for this source-preserving request. Finish every source slide in this run; if patch-deck rejects incomplete coverage, continue with the returned missing IDs instead of reporting success with a partial deck.",
-      ]
+      ].join("\n")
     : [
+        "This is a new deck. Keep it empty until generation begins; attached reference files must not seed it with imported 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.",
-        `After reading any requested or imported source material, but before adding the first slide, choose a concise, specific deck title from the user's request and source material. Never use the deck id, run id, file id, or another opaque alphanumeric token as the title. Call \`patch-deck\` with \`deckId: \"${deckId}\"\` and \`operations: [{ \"op\": \"patch-deck-fields\", \"fields\": { \"title\": \"<generated title>\" } }]\`. Include only \`title\` in \`fields\`; omit all other optional fields. Never leave a generated deck named \"Untitled Deck\" or another placeholder.`,
+        `After reading any requested or attached reference material, but before adding the first slide, choose a concise, specific deck title from the user's request and source material. Never use the deck id, run id, file id, or another opaque alphanumeric token as the title. Call \`patch-deck\` with \`deckId: \"${deckId}\"\` and \`operations: [{ \"op\": \"patch-deck-fields\", \"fields\": { \"title\": \"<generated title>\" } }]\`. Include only \`title\` in \`fields\`; omit all other optional fields. Never leave a generated deck named \"Untitled Deck\" or another placeholder.`,
         "If the user asks for a standalone visual, diagram, hero, one-pager, poster, or a couple of visuals, create only the requested one/few polished visual slides. Do not pad the result into a full presentation.",
         "If the request is for a presentation or deck and does not explicitly ask for one slide, infer a coherent multi-slide outline from the scope and keep adding slides until that outline is complete. Do not stop after the first slide just because the prompt has few explicit instructions.",
         `Add slides ONE AT A TIME using the \`add-slide\` action with --deckId=${deckId}. Wait for each \`add-slide\` result before calling it again; do not batch or parallelize slide writes.`,

package/corpus/templates/slides/app/lib/slide-animation-elements.ts

@@ -17,6 +17,27 @@ export interface ResolvedAnimationTarget<
   key: string;
 }
 
+export type AnimationTargetResolutionIssueCode =
+  | "missing-target"
+  | "duplicate-target";
+
+export interface AnimationTargetResolutionIssue<
+  T extends AnimationTarget = AnimationTarget,
+> {
+  animationIndex: number;
+  code: AnimationTargetResolutionIssueCode;
+  target: T;
+  key?: string;
+  preview?: string;
+}
+
+export interface AnimationTargetResolution<
+  T extends AnimationTarget = AnimationTarget,
+> {
+  resolved: ResolvedAnimationTarget<T>[] | null;
+  issue: AnimationTargetResolutionIssue<T> | null;
+}
+
 const INLINE_TAGS = new Set([
   "a",
   "abbr",
@@ -222,21 +243,63 @@ export function resolveSlideAnimationTargets<T extends AnimationTarget>(
   root: Element,
   targets: readonly T[],
 ): ResolvedAnimationTarget<T>[] | null {
+  return resolveSlideAnimationTargetsWithDiagnostics(root, targets).resolved;
+}
+
+export function resolveSlideAnimationTargetsWithDiagnostics<
+  T extends AnimationTarget,
+>(root: Element, targets: readonly T[]): AnimationTargetResolution<T> {
   const seen = new Set<string>();
   const resolved: ResolvedAnimationTarget<T>[] = [];
 
-  for (const target of targets) {
+  for (const [animationIndex, target] of targets.entries()) {
     const element = resolveSlideAnimationElement(root, target);
-    if (!element) return null;
+    if (!element) {
+      return {
+        resolved: null,
+        issue: {
+          animationIndex,
+          code: "missing-target",
+          target,
+        },
+      };
+    }
     const path = getElementPath(root, element);
-    if (!path) return null;
+    if (!path) {
+      return {
+        resolved: null,
+        issue: {
+          animationIndex,
+          code: "missing-target",
+          target,
+          preview: getElementPreview(
+            element,
+            `Element ${target.elementIndex + 1}`,
+          ),
+        },
+      };
+    }
     const key = animationElementKey(path);
-    if (seen.has(key)) return null;
+    if (seen.has(key)) {
+      return {
+        resolved: null,
+        issue: {
+          animationIndex,
+          code: "duplicate-target",
+          target,
+          key,
+          preview: getElementPreview(
+            element,
+            `Element ${target.elementIndex + 1}`,
+          ),
+        },
+      };
+    }
     seen.add(key);
     resolved.push({ target, element, key });
   }
 
-  return resolved;
+  return { resolved, issue: null };
 }
 
 export function getSlideAnimationTargetKey(