@agent-native/core 0.149.6 → 0.151.1

package/corpus/templates/slides/app/lib/slide-image-replacement.ts

@@ -4,6 +4,14 @@ interface ReplaceOptions {
   alt?: string;
 }
 
+export interface SlideImageDropPosition {
+  x: number;
+  y: number;
+}
+
+const DROPPED_IMAGE_WIDTH = 320;
+const DROPPED_IMAGE_HEIGHT = 180;
+
 interface PlaceholderTarget {
   index: number | null;
   label: string;
@@ -53,6 +61,13 @@ function cleanAlt(value: string | undefined): string {
   return (value || "Uploaded image").replace(/\s+/g, " ").trim();
 }
 
+function createSlideObjectId(): string {
+  if (typeof crypto !== "undefined" && "randomUUID" in crypto) {
+    return crypto.randomUUID();
+  }
+  return `slide-object-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+}
+
 function hasStyleProperty(style: string, property: string): boolean {
   return new RegExp(`(?:^|;)\\s*${property}\\s*:`, "i").test(style);
 }
@@ -188,6 +203,52 @@ export function insertImageIntoSlideHtml(
   return serializeFragment(doc);
 }
 
+/** Insert a desktop drop as a durable, independently movable canvas object. */
+export function insertDroppedImageIntoSlideHtml(
+  content: string,
+  newSrc: string,
+  options: ReplaceOptions & { position?: SlideImageDropPosition } = {},
+): string {
+  const doc = parseFragment(content);
+  const img = doc.createElement("img");
+  const position = options.position ?? {
+    x: 640,
+    y: 360,
+  };
+  const left = Math.max(0, Math.round(position.x - DROPPED_IMAGE_WIDTH / 2));
+  const top = Math.max(0, Math.round(position.y - DROPPED_IMAGE_HEIGHT / 2));
+
+  img.setAttribute("src", newSrc);
+  img.setAttribute("alt", cleanAlt(options.alt));
+  img.setAttribute("data-slide-object-id", createSlideObjectId());
+  img.className = "fmd-img-uploaded";
+  img.setAttribute(
+    "style",
+    `position: absolute; left: ${left}px; top: ${top}px; width: ${DROPPED_IMAGE_WIDTH}px; height: ${DROPPED_IMAGE_HEIGHT}px; max-width: none; max-height: none; margin: 0; border-radius: 8px; object-fit: contain; box-sizing: border-box; z-index: 1;`,
+  );
+
+  const slideRoot = doc.body.querySelector<HTMLElement>(".fmd-slide");
+  if (slideRoot) {
+    if (!hasStyleProperty(slideRoot.getAttribute("style") ?? "", "position")) {
+      slideRoot.setAttribute(
+        "style",
+        `${(slideRoot.getAttribute("style") ?? "").trim().replace(/;+\s*$/, "")}; position: relative;`.replace(
+          /^;\s*/,
+          "",
+        ),
+      );
+    }
+    slideRoot.appendChild(img);
+  } else {
+    // Markdown-backed slides keep their source text. Appending a raw image tag
+    // lets ReactMarkdown preserve the text while the slide canvas supplies the
+    // positioned containing block at render time.
+    doc.body.append(doc.createTextNode("\n\n"), img);
+  }
+
+  return serializeFragment(doc);
+}
+
 export function replaceImageTargetInSlideHtml(
   content: string,
   oldSrc: string,

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

@@ -36,10 +36,7 @@ import EditorSidebar from "@/components/editor/EditorSidebar";
 import EditorToolbar from "@/components/editor/EditorToolbar";
 import GeneratingSlidePreview from "@/components/editor/GeneratingSlidePreview";
 import HistoryPanel from "@/components/editor/HistoryPanel";
-import ImageDropPromptPopover from "@/components/editor/ImageDropPromptPopover";
 import ImageGenPanel from "@/components/editor/ImageGenPanel";
-import ImageSearchPanel from "@/components/editor/ImageSearchPanel";
-import LogoSearchPanel from "@/components/editor/LogoSearchPanel";
 import { QuestionFlow } from "@/components/editor/QuestionFlow";
 import SlideEditor from "@/components/editor/SlideEditor";
 import { TweaksPanel } from "@/components/editor/TweaksPanel";
@@ -49,7 +46,6 @@ import { useAgentGenerating } from "@/hooks/use-agent-generating";
 import { useDeckDesignSystem } from "@/hooks/use-deck-design-system";
 import { useDeckPresence } from "@/hooks/use-deck-presence";
 import { useDeckRole } from "@/hooks/use-deck-role";
-import { useGeneratingSlidePreview } from "@/hooks/use-generating-slide-preview";
 import {
   useSlideComments,
   type CommentThread,
@@ -71,7 +67,7 @@ import {
 import { isMissingUploadProviderError } from "@/lib/image-drop-to-agent";
 import { imageFileLooksSupported } from "@/lib/slide-image-replacement";
 import {
-  insertImageIntoSlideHtml,
+  insertDroppedImageIntoSlideHtml,
   replaceImageTargetInSlideHtml,
 } from "@/lib/slide-image-replacement";
 import { TAB_ID } from "@/lib/tab-id";
@@ -203,8 +199,6 @@ export default function DeckEditor() {
   // Dialog/popover states
   const [imageGenOpen, setImageGenOpen] = useState(false);
   const [assetLibraryOpen, setAssetLibraryOpen] = useState(false);
-  const [imageSearchOpen, setImageSearchOpen] = useState(false);
-  const [logoSearchOpen, setLogoSearchOpen] = useState(false);
   const [historyOpen, setHistoryOpen] = useState(false);
   const historyButtonRef = useRef<HTMLButtonElement>(null);
   const [sidePanel, setSidePanel] = useState<EditorSidePanel>(null);
@@ -246,19 +240,6 @@ export default function DeckEditor() {
   // Hidden file input for direct upload
   const uploadInputRef = useRef<HTMLInputElement>(null);
 
-  // Drop-to-prompt popover state. Opens when a user drops an image somewhere
-  // other than an existing image/placeholder on the slide — so we ask "what
-  // should we do with this?" and hand the image off to the agent chat instead
-  // of guessing (or worse, letting the browser navigate to the file).
-  const [imageDropPopover, setImageDropPopover] = useState<{
-    open: boolean;
-    file: File | null;
-    position: { x: number; y: number } | null;
-  }>({ open: false, file: null, position: null });
-  const closeImageDropPopover = useCallback(() => {
-    setImageDropPopover({ open: false, file: null, position: null });
-  }, []);
-
   const deck = getDeck(id || "");
   const fitDims = getAspectRatioDims(deck?.aspectRatio);
   const currentDeckAccessKey = deckAccessCheckKey(id, org?.orgId);
@@ -267,11 +248,6 @@ export default function DeckEditor() {
     ((org?.pendingInvitations?.length ?? 0) > 0 ||
       (org?.domainMatches?.length ?? 0) > 0);
   const slideCount = deck?.slides.length ?? 0;
-  const streamedGeneratingSlideContent = useGeneratingSlidePreview({
-    deckId: id ?? "",
-    slideCount,
-    generating,
-  });
   // Mirror Google Slides: viewers see the editor shell with edit affordances
   // disabled (rather than a separate "viewer" route). Owners/Editors/Admins
   // get the full editor. Only assume edit access while the role is still
@@ -365,26 +341,17 @@ export default function DeckEditor() {
     );
     const slideWasAdded = currentSlideIds.length > previousSlideIds.length;
 
-    if (
-      slideWasAdded &&
-      addedSlide &&
-      (generating ||
-        isNewDeckGenerating ||
-        addSlideGenerating ||
-        generatingSlideSelected)
-    ) {
+    previousSlideIdsRef.current = currentSlideIds;
+    if (!slideWasAdded) return;
+
+    // Keep the user's current slide stable while AI appends slides. The only
+    // exception is an explicit click on the synthetic generating-slide row,
+    // which opts the user into following that one generated slide.
+    if (addedSlide && generatingSlideSelected) {
       setActiveSlideId(addedSlide.id);
     }
-
-    previousSlideIdsRef.current = currentSlideIds;
-    if (slideWasAdded) setGeneratingSlideSelected(false);
-  }, [
-    addSlideGenerating,
-    deck,
-    generating,
-    generatingSlideSelected,
-    isNewDeckGenerating,
-  ]);
+    setGeneratingSlideSelected(false);
+  }, [deck, generatingSlideSelected]);
 
   useEffect(() => {
     if (
@@ -541,22 +508,43 @@ export default function DeckEditor() {
       position?: { x: number; y: number },
     ) => {
       if (!id || !currentSlideRef.current) return;
-      // When there's no concrete target (drop landed on slide whitespace, the
-      // canvas, or the editor chrome), defer to the user: open the popover so
-      // they can tell the agent what to do with the image. The agent can then
-      // decide which slide / placeholder / element to update, generate a
-      // matching layout, or add a new slide.
+      const targetSlideId = currentSlideRef.current.id;
       if (!replaceSrc) {
-        setImageDropPopover({
-          open: true,
-          file,
-          position: position ?? null,
-        });
+        try {
+          const newUrl = await uploadImageAsset(file);
+          const targetSlide =
+            currentSlideRef.current?.id === targetSlideId
+              ? currentSlideRef.current
+              : getDeck(id)?.slides.find((slide) => slide.id === targetSlideId);
+          if (!targetSlide) return;
+          const updatedContent = insertDroppedImageIntoSlideHtml(
+            targetSlide.content,
+            newUrl,
+            { alt: file.name, position },
+          );
+          if (updatedContent !== targetSlide.content) {
+            updateSlide(id, targetSlide.id, { content: updatedContent });
+          }
+          toast.success(t("deckEditor.imageAdded"), {
+            description: file.name,
+          });
+        } catch (error) {
+          toast.error(t("deckEditor.imageUploadFailed"), {
+            description:
+              error instanceof Error
+                ? error.message
+                : t("deckEditor.imageUploadError"),
+          });
+        }
         return;
       }
-      const targetSlide = currentSlideRef.current;
       try {
         const newUrl = await uploadImageAsset(file);
+        const targetSlide =
+          currentSlideRef.current?.id === targetSlideId
+            ? currentSlideRef.current
+            : getDeck(id)?.slides.find((slide) => slide.id === targetSlideId);
+        if (!targetSlide) return;
         const updatedContent = replaceImageTargetInSlideHtml(
           targetSlide.content,
           replaceSrc,
@@ -578,7 +566,7 @@ export default function DeckEditor() {
         });
       }
     },
-    [id, updateSlide, uploadImageAsset],
+    [getDeck, id, t, updateSlide, uploadImageAsset],
   );
 
   // Drag an already-hosted image (e.g. dragged out of a generated-image
@@ -586,17 +574,18 @@ export default function DeckEditor() {
   // uploadAndApplyImage there's nothing to upload — the URL is already a
   // live asset — so this just swaps it into the target image/placeholder.
   const dropImageUrlOnSlide = useCallback(
-    (replaceSrc: string | null, url: string) => {
+    (
+      replaceSrc: string | null,
+      url: string,
+      position?: { x: number; y: number },
+    ) => {
       if (!id || !currentSlideRef.current) return;
       if (!replaceSrc) {
-        // No existing image/placeholder under the drop point (e.g. an empty
-        // slide) — the URL is already a known, hosted asset (unlike an
-        // arbitrary local file), so just add it to the slide directly
-        // instead of routing through the agent-prompt popover.
         const targetSlide = currentSlideRef.current;
-        const updatedContent = insertImageIntoSlideHtml(
+        const updatedContent = insertDroppedImageIntoSlideHtml(
           targetSlide.content,
           url,
+          { position },
         );
         if (updatedContent !== targetSlide.content) {
           updateSlide(id, targetSlide.id, { content: updatedContent });
@@ -981,10 +970,9 @@ export default function DeckEditor() {
 
   // Editor-wide drag-and-drop catch-all. SlideEditor's own drop handler runs
   // first for drops landing on a slide (it calls stopPropagation), so this
-  // only fires for drops that landed in the surrounding chrome — sidebar,
-  // toolbar, deck thumbnails, or empty space. Without this, the browser's
-  // default kicks in and navigates to the dropped image file, which
-  // surprises users who expect drop-to-attach behavior everywhere.
+  // only fires for drops that landed in the surrounding chrome. Prevent the
+  // browser from navigating to the dropped file, and add it to the active
+  // slide at the default canvas position.
   const editorDragOver = (e: React.DragEvent) => {
     if (!Array.from(e.dataTransfer?.types ?? []).includes("Files")) return;
     e.preventDefault();
@@ -996,15 +984,8 @@ export default function DeckEditor() {
     if (!file) return;
     e.preventDefault();
     e.stopPropagation();
-    setImageDropPopover({
-      open: true,
-      file,
-      position: { x: e.clientX, y: e.clientY },
-    });
+    void uploadAndApplyImage(null, file);
   };
-  const contextHintForDrop = currentSlide
-    ? `Current slide: ${currentSlide.id} (index ${currentIndex >= 0 ? currentIndex : 0}). Deck: ${id}.`
-    : `Deck: ${id}.`;
 
   const handleAddEmptySlide = () => {
     const activeIdx = deck.slides.findIndex((s) => s.id === activeSlideId);
@@ -1034,7 +1015,7 @@ export default function DeckEditor() {
           setReplaceImageSrc(null);
           setAssetLibraryOpen(true);
         }}
-        onShowHistory={() => setHistoryOpen(!historyOpen)}
+        onShowHistory={() => setHistoryOpen((open) => !open)}
         historyButtonRef={historyButtonRef}
         currentSlide={currentSlide}
         onWideContextToolbarSlotChange={setWideContextToolbarSlot}
@@ -1159,7 +1140,6 @@ export default function DeckEditor() {
                     generatingSlideVisible
                       ? {
                           index: deck.slides.length,
-                          content: streamedGeneratingSlideContent,
                         }
                       : undefined
                   }
@@ -1191,7 +1171,6 @@ export default function DeckEditor() {
           <div className="flex min-h-0 flex-1 overflow-auto bg-[var(--slides-editor-surface)] p-4 md:p-8">
             <div className="m-auto w-full max-w-6xl">
               <GeneratingSlidePreview
-                content={streamedGeneratingSlideContent}
                 aspectRatio={deck.aspectRatio}
                 designSystem={designSystem}
                 thumbnail={false}
@@ -1207,7 +1186,6 @@ export default function DeckEditor() {
             <div className="flex min-h-0 flex-1 overflow-auto bg-[var(--slides-editor-surface)] p-4 md:p-8">
               <div className="m-auto w-full max-w-6xl">
                 <GeneratingSlidePreview
-                  content={streamedGeneratingSlideContent}
                   aspectRatio={deck.aspectRatio}
                   designSystem={designSystem}
                   thumbnail={false}
@@ -1260,14 +1238,6 @@ export default function DeckEditor() {
               setReplaceImageSrc(src);
               uploadInputRef.current?.click();
             }}
-            onSearchImage={(src) => {
-              setReplaceImageSrc(src);
-              setImageSearchOpen(true);
-            }}
-            onLogoSearch={(src) => {
-              setReplaceImageSrc(src);
-              setLogoSearchOpen(true);
-            }}
             onDropImage={uploadAndApplyImage}
             onDropImageUrl={dropImageUrlOnSlide}
             onToggleObjectFit={toggleObjectFit}
@@ -1388,30 +1358,6 @@ export default function DeckEditor() {
             : undefined
         }
       />
-      <ImageSearchPanel
-        open={imageSearchOpen}
-        onOpenChange={setImageSearchOpen}
-        onSelectImage={
-          replaceImageSrc
-            ? (newUrl) => {
-                replaceImageInSlide(replaceImageSrc, newUrl);
-                setReplaceImageSrc(null);
-              }
-            : undefined
-        }
-      />
-      <LogoSearchPanel
-        open={logoSearchOpen}
-        onOpenChange={setLogoSearchOpen}
-        onSelectLogo={
-          replaceImageSrc
-            ? (newUrl) => {
-                replaceImageInSlide(replaceImageSrc, newUrl);
-                setReplaceImageSrc(null);
-              }
-            : undefined
-        }
-      />
       <HistoryPanel
         deckId={id}
         open={historyOpen}
@@ -1419,13 +1365,6 @@ export default function DeckEditor() {
         canRestore={canEdit}
         anchorRef={historyButtonRef}
       />
-      <ImageDropPromptPopover
-        open={imageDropPopover.open}
-        file={imageDropPopover.file}
-        position={imageDropPopover.position}
-        contextHint={contextHintForDrop}
-        onClose={closeImageDropPopover}
-      />
     </div>
   );
 }

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

@@ -26,6 +26,7 @@ import { useLocation, useNavigate, useSearchParams } from "react-router";
 import { toast } from "sonner";
 
 import DeckCard from "@/components/deck/DeckCard";
+import { DeckEditorSkeleton } from "@/components/editor/DeckEditorSkeleton";
 import {
   NewDeckReferenceStep,
   type ImportedReference,
@@ -271,6 +272,7 @@ export default function Index() {
   } | null>(null);
   const [showNewDeckReferenceStep, setShowNewDeckReferenceStep] =
     useState(false);
+  const [isStartingNewDeck, setIsStartingNewDeck] = useState(false);
   const [recentReferences, setRecentReferences] = useState<RecentReference[]>(
     [],
   );
@@ -544,11 +546,15 @@ export default function Index() {
       : undefined;
     let deck: ReturnType<typeof createDeck> | undefined;
     flushSync(() => {
+      setIsStartingNewDeck(true);
       deck = createDeck(undefined, {
         designSystemId: selectedDesignSystem?.id ?? null,
       });
     });
-    if (!deck) return;
+    if (!deck) {
+      setIsStartingNewDeck(false);
+      return;
+    }
     navigate(`/deck/${deck.id}`);
   };
 
@@ -588,12 +594,20 @@ export default function Index() {
       : undefined;
     let deck: ReturnType<typeof createDeck> | undefined;
     flushSync(() => {
+      // Commit the destination-shaped shell before navigating. React Router
+      // keeps the current outlet mounted while a cold route chunk loads, and
+      // showing the deck grid during that handoff makes the route indicator
+      // look like a second app.
+      setIsStartingNewDeck(true);
       deck = createDeck(undefined, {
         noDefaultSlides: true,
         designSystemId: selectedDesignSystem?.id ?? null,
       });
     });
-    if (!deck) return;
+    if (!deck) {
+      setIsStartingNewDeck(false);
+      return;
+    }
     const deckId = deck.id;
     setNewDeckPromptOpen(false);
 
@@ -735,7 +749,7 @@ export default function Index() {
           "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 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.',
+            '\"` 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, and do not reuse the uploaded filename or a generic label like "Untitled scene" when the content can describe the deck better.',
           "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=" +
@@ -1290,6 +1304,17 @@ export default function Index() {
     ),
   );
 
+  if (isStartingNewDeck) {
+    return (
+      <div
+        className="fixed inset-0 z-[300] min-h-screen bg-background"
+        data-testid="new-deck-loading"
+      >
+        <DeckEditorSkeleton label={t("deckEditor.lookingForDeck")} />
+      </div>
+    );
+  }
+
   return (
     <main className="min-w-0 flex-1 overflow-y-auto px-4 pb-6 pt-0 sm:px-6 sm:pb-10">
       {loading ? (

package/corpus/templates/slides/changelog/2026-08-11-agent-chat-now-follows-the-current-slide-and-selection.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-11
+---
+
+Agent chat now follows the current slide and selection

package/corpus/templates/slides/changelog/2026-08-11-deck-titles-now-use-slide-content-instead-of-placeholder-filenames.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-11
+---
+
+Imported decks now use slide content for their title instead of a placeholder filename.

package/corpus/templates/slides/changelog/2026-08-11-history-now-opens-from-the-deck-overflow-menu.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-11
+---
+
+History now opens from the deck overflow menu

package/corpus/templates/slides/changelog/2026-08-11-images-can-be-dropped-directly-onto-slides-and-resized-or-re.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-11
+---
+
+Images can be dropped directly onto slides and resized or repositioned freely

package/corpus/templates/slides/changelog/2026-08-11-new-decks-now-transition-directly-to-a-full-page-editor-load.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-11
+---
+
+New decks now transition directly to a full-page editor loading state

package/corpus/templates/slides/changelog/2026-08-11-selected-slide-layers-can-be-nudged-precisely-with-arrow-key.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-11
+---
+
+Selected slide layers can be nudged precisely with arrow keys

package/corpus/templates/slides/changelog/2026-08-11-slides-can-copy-and-paste-element-styles-with-cmd-option-c-v.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-08-11
+---
+
+Slides can copy and paste element styles with Cmd+Option+C/V and the context menu

package/corpus/templates/slides/changelog/2026-08-11-slides-shows-one-compact-ai-marker-and-keeps-your-current-sl.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-11
+---
+
+Slides shows one compact AI marker and keeps your current slide selected while new slides load as skeletons

package/corpus/templates/slides/changelog/2026-08-11-text-edits-preserve-slide-layout-when-no-changes-are-made.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-11
+---
+
+Text edits preserve slide layout when no changes are made

package/corpus/templates/slides/changelog/2026-08-11-the-style-toolbar-now-uses-the-full-available-width.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-11
+---
+
+The style toolbar now uses the full available width

package/corpus/templates/slides/changelog/2026-08-11-undo-and-redo-now-move-one-visible-slide-state-at-a-time.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-11
+---
+
+Undo and redo now move one visible slide state at a time

package/corpus/templates/slides/server/lib/chat-attachments.ts

@@ -158,11 +158,15 @@ function stripForwardedAttachmentData(
 ): AgentChatAttachment {
   const next = { ...attachment };
   // Keep visual data for the current model turn so uploaded screenshots remain
-  // available for vision analysis; non-visual files only need their path/URL.
+  // available for vision analysis. Keep non-visual bytes until core's shared
+  // pre-upload boundary has created the durable public object-storage URL;
+  // `slidesUploadPath` is a private import handle, not a chat attachment URL.
   const inlineImage = isVisualAttachment(attachment)
     ? decodeDataUrl(attachment.data)
     : null;
-  if (!inlineImage || inlineImage.bytes.length > MAX_INLINE_IMAGE_BYTES) {
+  if (!inlineImage && (saved.url || !attachment.data)) {
+    delete next.data;
+  } else if (inlineImage && inlineImage.bytes.length > MAX_INLINE_IMAGE_BYTES) {
     delete next.data;
   }
   (next as any).slidesUploadPath = saved.path;

package/corpus/templates/slides/shared/deck-title.ts

@@ -11,6 +11,14 @@ const GENERATED_TITLE_PLACEHOLDERS = new Set([
   "your name",
 ]);
 
+const IMPORTED_TITLE_PLACEHOLDERS = new Set([
+  "untitled deck",
+  "untitled file",
+  "untitled presentation",
+  "untitled scene",
+  "untitled slide",
+]);
+
 /**
  * Generated deck ids should never become user-facing titles. Keep this
  * deliberately narrow so normal titles with spaces and punctuation remain
@@ -63,6 +71,15 @@ function plainText(value: string): string {
     .trim();
 }
 
+function plainTextLines(value: string): string[] {
+  return decodeHtmlEntities(
+    value.replace(/<br\s*\/?>/gi, "\n").replace(/<[^>]+>/gi, "\n"),
+  )
+    .split(/\r?\n/)
+    .map((line) => line.replace(/\s+/g, " ").trim())
+    .filter(Boolean);
+}
+
 function usableCandidate(value: string): string | null {
   const candidate = plainText(value).replace(/^[•●▪‣\-\s]+/, "");
   if (!candidate || candidate.length > 140) return null;
@@ -101,6 +118,17 @@ export function deriveDeckTitleFromSlideContent(
     if (text) candidates.push({ score: fontSize, text });
   }
 
+  const fallbackLines = plainTextLines(content);
+  if (fallbackLines.length > 1) {
+    for (const line of fallbackLines) {
+      const text = usableCandidate(line);
+      if (text) {
+        candidates.push({ score: 1, text });
+        break;
+      }
+    }
+  }
+
   return candidates.sort((a, b) => b.score - a.score)[0]?.text ?? null;
 }
 
@@ -126,6 +154,34 @@ export function repairGeneratedDeckTitle(
   );
 }
 
+/**
+ * Imported files often fall back to filenames when they do not have a
+ * meaningful title in their own metadata. Prefer the first slide's content
+ * when it can produce a real deck title; otherwise keep a human-readable
+ * fallback instead of a source filename placeholder.
+ */
+export function resolveImportedDeckTitle(
+  requestedTitle: unknown,
+  firstSlideContent: unknown,
+): string {
+  if (typeof requestedTitle === "string") {
+    const title = requestedTitle.trim();
+    const opaqueTitle = isOpaqueDeckTitle(requestedTitle);
+    if (
+      title &&
+      !opaqueTitle &&
+      !IMPORTED_TITLE_PLACEHOLDERS.has(title.toLowerCase())
+    ) {
+      return title;
+    }
+  }
+
+  const derivedTitle = deriveDeckTitleFromSlideContent(firstSlideContent);
+  if (derivedTitle) return derivedTitle;
+
+  return "Imported File";
+}
+
 export function assertHumanReadableDeckTitle(title: string): void {
   if (isOpaqueDeckTitle(title)) {
     throw new Error(