@agent-native/core 0.149.5 → 0.151.0

package/corpus/templates/slides/app/components/editor/canvas-interactions/index.ts

@@ -3,6 +3,7 @@ export {
   createSlidesCanvasInteractionCore,
   isWithinSlidesCanvasEdgeMoveBand,
   resolveSlidesCanvasDragTarget,
+  resolveSlidesCanvasNudge,
   resolveSlidesCanvasPointerIntent,
   slidesCanvasInteractionCore,
   SLIDES_CANVAS_EDGE_MOVE_BAND,

package/corpus/templates/slides/app/components/editor/canvas-interactions/slides-canvas-adapter.ts

@@ -76,6 +76,17 @@ export function createSlidesCanvasInteractionCore(
   return createCanvasInteractionCore(slidesCanvasInteractionConfig, adapter);
 }
 
+/**
+ * Slides only nudges selected layers for plain arrows and Shift+arrows. Other
+ * modifier chords stay native so browser and editing shortcuts keep working.
+ */
+export function resolveSlidesCanvasNudge(
+  input: Parameters<typeof slidesCanvasInteractionCore.nudge>[0],
+) {
+  if (input.altKey || input.ctrlKey || input.metaKey) return null;
+  return slidesCanvasInteractionCore.nudge(input);
+}
+
 /** Creates one shared controller per live Slides pointer gesture. */
 export function createSlidesCanvasGestureController(
   adapter: SlidesCanvasGestureAdapter,

package/corpus/templates/slides/app/components/editor/inline-edit-session.ts

@@ -0,0 +1,16 @@
+export interface InlineEditContentSnapshot {
+  slideId: string;
+  content: string;
+}
+
+export function shouldPersistInlineEditContent(
+  initial: InlineEditContentSnapshot | null,
+  current: InlineEditContentSnapshot | null,
+): boolean {
+  if (!current) return false;
+  return (
+    !initial ||
+    initial.slideId !== current.slideId ||
+    initial.content !== current.content
+  );
+}

package/corpus/templates/slides/app/components/editor/slide-object-interactions.ts

@@ -521,15 +521,31 @@ export function removeSlideObjectAndLayoutSpacer(element: HTMLElement): void {
   element.remove();
 }
 
+/**
+ * Whether Delete may remove this selected element from the slide content.
+ *
+ * Selection is intentionally broader than freeform object manipulation: an
+ * AI-generated flow-layout div is still user content and must be removable.
+ * The renderer's structural shells and the hidden spacer used to preserve a
+ * moved object's original layout slot are not user content.
+ */
+export function isDeletableSlideElement(element: HTMLElement): boolean {
+  return (
+    !element.classList.contains("fmd-layout-spacer") &&
+    !element.classList.contains("fmd-slide") &&
+    !element.classList.contains("fmd-autofit-scale") &&
+    !element.hasAttribute("data-fmd-autofit-content") &&
+    !element.hasAttribute("data-slide-canvas")
+  );
+}
+
 /**
  * Whether Delete should remove `element` even though it is not a freeform
- * canvas object.
+ * canvas object or generic flow element.
  *
- * Flow-layout nodes are deliberately excluded from object operations, because
- * deleting an arbitrary one collapses the layout around it. An image is the
- * exception: it is a leaf, users select it directly, and removing it leaves
- * the surrounding grid or card intact. Without this, selecting a picture in a
- * card grid and pressing Delete silently did nothing.
+ * Images are handled specially because they are leaves: an image nested in a
+ * card should be removed without swallowing the surrounding card. Generic
+ * flow elements are covered by `isDeletableSlideElement`.
  */
 export function isDeletableFlowImage(element: HTMLElement): boolean {
   return (

package/corpus/templates/slides/app/components/editor/style-clipboard.ts

@@ -1,5 +1,7 @@
 /** Shared style clipboard for copy/paste style (Cmd+Option+C / Cmd+Option+V) */
 
+import type { SlideStylePatch, SlideStyleSnapshot } from "./slide-style";
+
 export interface CopiedStyle {
   color?: string;
   bold?: boolean;
@@ -13,6 +15,65 @@ export function setCopiedStyle(s: CopiedStyle | null): void {
   copiedStyle = s;
 }
 
+/** Appearance-only style payload used by the canvas editor. */
+export type CopiedElementStyle = Pick<
+  SlideStylePatch,
+  | "color"
+  | "backgroundColor"
+  | "fontSize"
+  | "fontWeight"
+  | "fontStyle"
+  | "textDecoration"
+  | "lineHeight"
+  | "textAlign"
+  | "opacity"
+  | "borderRadius"
+  | "borderWidth"
+  | "borderColor"
+  | "paddingLeft"
+  | "paddingRight"
+  | "paddingTop"
+  | "paddingBottom"
+>;
+
+let copiedElementStyle: CopiedElementStyle | null = null;
+
+function px(value: number): string {
+  return `${Number.isInteger(value) ? value : Number(value.toFixed(2))}px`;
+}
+
+/** Converts the inspector's computed snapshot into an appearance-only patch. */
+export function copiedElementStyleFromSnapshot(
+  snapshot: SlideStyleSnapshot,
+): CopiedElementStyle {
+  return {
+    color: snapshot.color,
+    backgroundColor: snapshot.backgroundColor,
+    fontSize: px(snapshot.fontSize),
+    fontWeight: snapshot.fontWeight,
+    fontStyle: snapshot.fontStyle,
+    textDecoration: snapshot.textDecoration,
+    lineHeight: String(snapshot.lineHeight),
+    textAlign: snapshot.textAlign,
+    opacity: String(Math.max(0, Math.min(100, snapshot.opacity)) / 100),
+    borderRadius: px(snapshot.borderRadius),
+    borderWidth: px(snapshot.borderWidth),
+    borderColor: snapshot.borderColor,
+    paddingLeft: px(snapshot.paddingX),
+    paddingRight: px(snapshot.paddingX),
+    paddingTop: px(snapshot.paddingY),
+    paddingBottom: px(snapshot.paddingY),
+  };
+}
+
+export function getCopiedElementStyle(): CopiedElementStyle | null {
+  return copiedElementStyle ? { ...copiedElementStyle } : null;
+}
+
+export function setCopiedElementStyle(style: CopiedElementStyle | null): void {
+  copiedElementStyle = style ? { ...style } : null;
+}
+
 // Brand palette — persisted in localStorage
 const STORAGE_KEY = "slide-brand-palette";
 

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

@@ -9,6 +9,12 @@ import { useLocation } from "react-router";
 
 import { useDecks } from "@/context/DeckContext";
 import { useSidebarCollapsed } from "@/hooks/use-sidebar-collapsed";
+import {
+  hasCurrentSlideSelection,
+  readPublishedSlidesSelection,
+  SLIDES_SELECTION_CHANGED_EVENT,
+  type SlidesAgentSelection,
+} from "@/lib/slide-agent-context";
 import { TAB_ID } from "@/lib/tab-id";
 import { cn } from "@/lib/utils";
 
@@ -45,6 +51,8 @@ export function Layout({ children }: LayoutProps) {
   const location = useLocation();
   const t = useT();
   const [sidebarOpen, setSidebarOpen] = useState(false);
+  const [slidesSelection, setSlidesSelection] =
+    useState<SlidesAgentSelection | null>(() => readPublishedSlidesSelection());
   const [editorSidebarOverride, setEditorSidebarOverride] =
     useState<EditorSidebarOverride | null>(null);
   const { collapsed: sidebarCollapsed, setCollapsed: setSidebarCollapsed } =
@@ -53,6 +61,20 @@ export function Layout({ children }: LayoutProps) {
   const isEmptyDecksState =
     location.pathname === "/" && !decksLoading && decks.length === 0;
 
+  useEffect(() => {
+    const onSelectionChanged = (event: Event) => {
+      setSlidesSelection(
+        (event as CustomEvent<SlidesAgentSelection | null>).detail ?? null,
+      );
+    };
+    window.addEventListener(SLIDES_SELECTION_CHANGED_EVENT, onSelectionChanged);
+    return () =>
+      window.removeEventListener(
+        SLIDES_SELECTION_CHANGED_EVENT,
+        onSelectionChanged,
+      );
+  }, []);
+
   // Scope new chats to the deck the user is currently editing. The route
   // is `/deck/:id`; everywhere else (list, presentation) leaves
   // scope null so chats stay in the general pool. Keep the visible label
@@ -61,12 +83,14 @@ export function Layout({ children }: LayoutProps) {
     const match = location.pathname.match(/^\/deck\/([^/]+)/);
     const deckId = match?.[1];
     if (!deckId) return null;
+    const hasSelection = hasCurrentSlideSelection(slidesSelection, deckId);
     return {
       type: "deck" as const,
       id: deckId,
-      label: t("agent.thisDeck"),
+      label: t(hasSelection ? "agent.currentSelection" : "agent.thisSlide"),
+      contextKey: "slides-current-context",
     };
-  }, [location.pathname, t]);
+  }, [location.pathname, slidesSelection, t]);
 
   useEffect(() => {
     setSidebarOpen(false);

package/corpus/templates/slides/app/components/ui/context-menu.tsx

@@ -0,0 +1 @@
+export * from "@agent-native/toolkit/ui/context-menu";

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

@@ -614,13 +614,12 @@ type PatchDeckFields = Extract<
 export function applyOpToDeck(deck: Deck, op: PatchDeckOp): Deck {
   switch (op.op) {
     case "patch-slide": {
-      let changed = false;
+      const prior = deck.slides.find((s) => s.id === op.slideId);
+      if (!prior || !hasChangedFields(prior, op.fields)) return deck;
       const slides = deck.slides.map((s) => {
         if (s.id !== op.slideId) return s;
-        changed = true;
         return { ...s, ...op.fields };
       });
-      if (!changed) return deck; // slide concurrently deleted — skip
       return { ...deck, slides, updatedAt: new Date().toISOString() };
     }
     case "delete-slide": {
@@ -646,6 +645,12 @@ export function applyOpToDeck(deck: Deck, op: PatchDeckOp): Deck {
       for (const s of deck.slides) {
         if (!named.has(s.id)) reordered.push(s);
       }
+      if (
+        reordered.length === deck.slides.length &&
+        reordered.every((slide, index) => slide.id === deck.slides[index]?.id)
+      ) {
+        return deck;
+      }
       return {
         ...deck,
         slides: reordered,
@@ -672,6 +677,7 @@ export function applyOpToDeck(deck: Deck, op: PatchDeckOp): Deck {
       return { ...deck, slides, updatedAt: new Date().toISOString() };
     }
     case "patch-deck-fields": {
+      if (!hasChangedFields(deck, op.fields)) return deck;
       return {
         ...deck,
         ...op.fields,
@@ -681,6 +687,27 @@ export function applyOpToDeck(deck: Deck, op: PatchDeckOp): Deck {
   }
 }
 
+function equalDeckValue(left: unknown, right: unknown): boolean {
+  if (Object.is(left, right)) return true;
+  if (
+    left === null ||
+    right === null ||
+    typeof left !== "object" ||
+    typeof right !== "object"
+  ) {
+    return false;
+  }
+  return JSON.stringify(left) === JSON.stringify(right);
+}
+
+function hasChangedFields(current: object, fields: object): boolean {
+  const currentRecord = current as Record<string, unknown>;
+  const fieldRecord = fields as Record<string, unknown>;
+  return Object.keys(fieldRecord).some(
+    (key) => !equalDeckValue(currentRecord[key], fieldRecord[key]),
+  );
+}
+
 export function applyUndoOpToDecks(decks: Deck[], op: DeckUndoOp): Deck[] {
   switch (op.op) {
     case "delete-deck":
@@ -751,8 +778,11 @@ export function deriveInverseOp(
         // Capture the prior value for every field this op touches, so undo
         // restores exactly what changed (including clearing fields back to
         // undefined).
-        (priorFields as Record<string, unknown>)[key] = prior[key];
+        if (!equalDeckValue(prior[key], op.fields[key])) {
+          (priorFields as Record<string, unknown>)[key] = prior[key];
+        }
       }
+      if (Object.keys(priorFields).length === 0) return null;
       return [{ op: "patch-slide", slideId: op.slideId, fields: priorFields }];
     }
     case "delete-slide": {
@@ -786,6 +816,7 @@ export function deriveInverseOp(
     }
     case "add-slide": {
       // Inverse of adding a slide is deleting it.
+      if (before.slides.some((slide) => slide.id === op.slideId)) return null;
       return [
         {
           op: "delete-slide",
@@ -796,6 +827,7 @@ export function deriveInverseOp(
     }
     case "reorder-slides": {
       // Inverse reorder = the order the slides were in before.
+      if (applyOpToDeck(before, op) === before) return null;
       return [
         { op: "reorder-slides", orderedIds: before.slides.map((s) => s.id) },
       ];
@@ -803,9 +835,13 @@ export function deriveInverseOp(
     case "patch-deck-fields": {
       const priorFields: Record<string, unknown> = {};
       const beforeRecord = before as unknown as Record<string, unknown>;
+      const nextRecord = op.fields as Record<string, unknown>;
       for (const key of Object.keys(op.fields)) {
-        priorFields[key] = beforeRecord[key];
+        if (!equalDeckValue(beforeRecord[key], nextRecord[key])) {
+          priorFields[key] = beforeRecord[key];
+        }
       }
+      if (Object.keys(priorFields).length === 0) return null;
       return [
         {
           op: "patch-deck-fields",
@@ -1734,7 +1770,8 @@ export function DeckProvider({ children }: { children: ReactNode }) {
         target.tagName === "TEXTAREA" ||
         target.tagName === "INPUT" ||
         target.isContentEditable;
-      if ((e.metaKey || e.ctrlKey) && e.key === "z") {
+      const key = e.key.toLowerCase();
+      if ((e.metaKey || e.ctrlKey) && key === "z") {
         if (isTyping) return;
         e.preventDefault();
         if (e.shiftKey) {
@@ -1743,7 +1780,7 @@ export function DeckProvider({ children }: { children: ReactNode }) {
           undo();
         }
       }
-      if ((e.metaKey || e.ctrlKey) && e.key === "y") {
+      if ((e.metaKey || e.ctrlKey) && key === "y") {
         if (isTyping) return;
         e.preventDefault();
         redo();
@@ -1982,17 +2019,7 @@ export function DeckProvider({ children }: { children: ReactNode }) {
 
   const updateDeck = useCallback(
     (id: string, updates: Partial<Omit<Deck, "id" | "createdAt">>) => {
-      // Clear the external-update suppression window so a rename/update that
-      // happens within 2s of page load (or an SSE event) is not silently dropped.
-      markDeckDirty(id);
       const before = decksRef.current.find((d) => d.id === id);
-      setDecks((prev) =>
-        prev.map((d) =>
-          d.id === id
-            ? { ...d, ...updates, updatedAt: new Date().toISOString() }
-            : d,
-        ),
-      );
       // Enqueue a granular patch-deck-fields op — only the changed fields are
       // sent to the server, so concurrent edits to slides are never clobbered.
       // Exclude internal/derived fields that live only in client state.
@@ -2007,11 +2034,26 @@ export function DeckProvider({ children }: { children: ReactNode }) {
       };
       void _slides;
       _ca;
-      if (Object.keys(persistableUpdates).length > 0) {
-        const op: PatchDeckOp = {
-          op: "patch-deck-fields",
-          fields: persistableUpdates as PatchDeckFields,
-        };
+      const hasPersistableUpdates = Object.keys(persistableUpdates).length > 0;
+      const op: PatchDeckOp | null = hasPersistableUpdates
+        ? {
+            op: "patch-deck-fields",
+            fields: persistableUpdates as PatchDeckFields,
+          }
+        : null;
+      if (before && op && !deriveInverseOp(before, op)) return;
+
+      // Clear the external-update suppression window so a rename/update that
+      // happens within 2s of page load (or an SSE event) is not silently dropped.
+      markDeckDirty(id);
+      setDecks((prev) =>
+        prev.map((d) =>
+          d.id === id
+            ? { ...d, ...updates, updatedAt: new Date().toISOString() }
+            : d,
+        ),
+      );
+      if (op) {
         enqueueDeckOp(id, op);
         if (before) {
           // Coalesce rapid deck-field edits (e.g. title typing, tweak sliders)
@@ -2087,7 +2129,6 @@ export function DeckProvider({ children }: { children: ReactNode }) {
       updates: Partial<Omit<Slide, "id">>,
       options?: UpdateSlideOptions,
     ) => {
-      markDeckDirty(deckId);
       const label = updates.layout
         ? "Change layout"
         : updates.background
@@ -2096,6 +2137,9 @@ export function DeckProvider({ children }: { children: ReactNode }) {
             ? "Update content"
             : "Edit slide";
       const before = decksRef.current.find((d) => d.id === deckId);
+      const op: PatchDeckOp = { op: "patch-slide", slideId, fields: updates };
+      if (before && !deriveInverseOp(before, op)) return;
+      markDeckDirty(deckId);
       setDecksLocal((prev: Deck[]) =>
         prev.map((d) => {
           if (d.id !== deckId) return d;
@@ -2109,7 +2153,6 @@ export function DeckProvider({ children }: { children: ReactNode }) {
         }),
       );
       // Granular op — only this slide's changed fields reach the server.
-      const op: PatchDeckOp = { op: "patch-slide", slideId, fields: updates };
       enqueueDeckOp(deckId, op, options);
       if (before) {
         // Coalesce a burst of edits to the SAME slide's SAME field-set into one
@@ -2223,11 +2266,18 @@ export function DeckProvider({ children }: { children: ReactNode }) {
 
   const setDeckSlides = useCallback(
     (deckId: string, slides: Slide[]) => {
-      markDeckDirty(deckId);
       const before = decksRef.current.find((deck) => deck.id === deckId);
       const after = before
         ? { ...before, slides, updatedAt: new Date().toISOString() }
         : null;
+      if (
+        before &&
+        after &&
+        deckContentSignature(before) === deckContentSignature(after)
+      ) {
+        return;
+      }
+      markDeckDirty(deckId);
       // setDeckSlides replaces ALL slides wholesale (used by AI generation and
       // imports), so its undo entry is a deck-level full replacement instead of
       // a fine-grained slide patch.

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

@@ -257,7 +257,7 @@ button[title="Open agent sidebar"] {
 
 .deck-editor-context-toolbar-host {
   min-width: 0;
-  overflow: hidden;
+  overflow: auto;
 }
 
 .deck-editor-context-toolbar-host--wide {

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

@@ -48,7 +48,8 @@ const messages = {
   },
   agent: {
     emptyState: "Ask me anything about your presentations",
-    thisDeck: "This Deck",
+    thisSlide: "This Slide",
+    currentSelection: "Current Selection",
     suggestionPitch: "Build a 10-slide pitch from this doc",
     suggestionBrand: "Apply our brand to this deck",
     suggestionHero: "Generate a hero image for this slide",
@@ -436,6 +437,10 @@ const messages = {
     order: "Order",
     bringToFront: "Bring to front",
     sendToBack: "Send to back",
+    copyStyle: "Copy style",
+    pasteStyle: "Paste style",
+    copy: "Copy",
+    paste: "Paste",
   },
   animations: {
     appear: "Appear",

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

@@ -373,7 +373,7 @@ export async function startDeckGeneration({
     : [
         "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 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.`,
+        `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, uploaded filename, or another opaque alphanumeric token as the title. Do not reuse a generic placeholder like "Untitled scene" when the content or reference context gives you a better 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/image-drop-to-agent.ts

@@ -20,11 +20,13 @@ export type ImageDropAgentPayload =
   | {
       kind: "hosted";
       message: string;
+      context: string;
       referenceImagePaths: string[];
     }
   | {
       kind: "inline";
       message: string;
+      context: string;
       images: string[];
     };
 
@@ -52,21 +54,18 @@ export function buildImageDropAgentPayload(args: {
     args.intent.trim().length > 0
       ? args.intent.trim()
       : "Use this image on the current slide.";
-  const lines = [intentLine];
+  const contextLines: string[] = [];
   if (args.contextHint && args.contextHint.trim().length > 0) {
-    lines.push(args.contextHint.trim());
+    contextLines.push(args.contextHint.trim());
   }
-  lines.push(`Filename: ${args.filename}`);
+  contextLines.push(`Filename: ${args.filename}`);
 
   if (args.upload.ok && args.upload.url) {
-    lines.splice(
-      lines.length - 1,
-      0,
-      `Image URL (already uploaded): ${args.upload.url}`,
-    );
+    contextLines.push(`Image URL (already uploaded): ${args.upload.url}`);
     return {
       kind: "hosted",
-      message: lines.join("\n\n"),
+      message: intentLine,
+      context: contextLines.join("\n\n"),
       referenceImagePaths: [args.upload.url],
     };
   }
@@ -81,18 +80,19 @@ export function buildImageDropAgentPayload(args: {
   if (!isMissingUploadProviderError(args.upload.status, args.upload.error)) {
     // Unexpected upload failure — still try the inline path so the user can
     // keep working, but tell the agent the hosted upload didn't land.
-    lines.push(
+    contextLines.push(
       "Hosted upload failed; the image is attached inline as a data URL. Call upload-image on it before placing it on the slide if a durable URL is required.",
     );
   } else {
-    lines.push(
+    contextLines.push(
       "No file upload provider is configured, so the image is attached inline as a data URL. Call upload-image to obtain a hosted URL before inserting it into slide HTML.",
     );
   }
 
   return {
     kind: "inline",
-    message: lines.join("\n\n"),
+    message: intentLine,
+    context: contextLines.join("\n\n"),
     images: [args.dataUrl],
   };
 }

package/corpus/templates/slides/app/lib/slide-agent-context.ts

@@ -0,0 +1,52 @@
+export const SLIDES_SELECTION_CHANGED_EVENT = "slides:selection-changed";
+
+export interface SlidesAgentSelection {
+  deckId?: string;
+  slideId?: string;
+  slideIndex?: number;
+  slideNumber?: number;
+  items?: readonly unknown[];
+}
+
+interface SlidesSelectionWindow extends Window {
+  __slidesAgentSelection?: SlidesAgentSelection | null;
+}
+
+function getSlidesWindow(): SlidesSelectionWindow | null {
+  return typeof window === "undefined"
+    ? null
+    : (window as SlidesSelectionWindow);
+}
+
+/**
+ * Keep the visible scope chip responsive without making the browser event the
+ * source of truth for agent context. The app-state write remains canonical.
+ */
+export function publishSlidesSelection(
+  selection: SlidesAgentSelection | null,
+): void {
+  const slidesWindow = getSlidesWindow();
+  if (!slidesWindow) return;
+  slidesWindow.__slidesAgentSelection = selection;
+  slidesWindow.dispatchEvent(
+    new CustomEvent<SlidesAgentSelection | null>(
+      SLIDES_SELECTION_CHANGED_EVENT,
+      { detail: selection },
+    ),
+  );
+}
+
+export function readPublishedSlidesSelection(): SlidesAgentSelection | null {
+  return getSlidesWindow()?.__slidesAgentSelection ?? null;
+}
+
+export function hasCurrentSlideSelection(
+  selection: SlidesAgentSelection | null,
+  deckId: string,
+): boolean {
+  return (
+    selection?.deckId === deckId &&
+    Array.isArray(selection.items) &&
+    selection.items.length > 0
+  );
+}