@agent-native/core-corpus 0.201.0 → 0.201.1

package/corpus/templates/slides/app/hooks/use-new-deck-generation.ts

@@ -18,6 +18,8 @@ import { CHAT_STOP_DEBOUNCE_MS } from "./use-agent-generating";
 
 export const NEW_DECK_GENERATION_SUBMIT_TARGET_EVENT =
   "agentNative.chatSubmitTarget";
+const NEW_DECK_GENERATION_RUN_CLEARED_EVENT =
+  "slides:new-deck-generation:cleared";
 
 type NewDeckGenerationLifecycle = {
   deckId: string;
@@ -135,6 +137,11 @@ type NewDeckGenerationRun = {
   tabId: string | null;
 };
 
+type NewDeckGenerationRunReference = {
+  submitMessageId: string;
+  tabId: string;
+};
+
 const runTabIds = new Map<string, string>();
 
 export function clearNewDeckGenerationRun(
@@ -144,6 +151,15 @@ export function clearNewDeckGenerationRun(
   const key = getRunTabStorageKey(deckId, submitMessageId);
   runTabIds.delete(key);
   window.sessionStorage.removeItem(key);
+  const activeRun = getActiveRun(deckId);
+  if (activeRun?.submitMessageId === submitMessageId) {
+    window.sessionStorage.removeItem(getActiveRunStorageKey(deckId));
+  }
+  window.dispatchEvent(
+    new CustomEvent(NEW_DECK_GENERATION_RUN_CLEARED_EVENT, {
+      detail: { deckId, submitMessageId },
+    }),
+  );
 }
 
 export function useNewDeckGenerationRun(
@@ -152,6 +168,7 @@ export function useNewDeckGenerationRun(
   submitMessageId: string | null,
 ): {
   generating: boolean;
+  submitMessageId: string | null;
   tabId: string | null;
   questionContinuationPending: boolean;
   expectQuestionContinuation: (submitMessageId: string) => void;
@@ -165,8 +182,15 @@ export function useNewDeckGenerationRun(
   );
   const startsNewRoute = isNewDeckRoute && !run.isNewDeckRoute;
   const newSubmit = submitMessageId && submitMessageId !== run.submitMessageId;
+  const storedActiveRun = getActiveRun(deckId);
+  const restoresActiveRun =
+    run.submitMessageId !== null &&
+    storedActiveRun?.submitMessageId === run.submitMessageId;
   const clearsFinishedSubmit =
-    !isNewDeckRoute && !submitMessageId && run.submitMessageId !== null;
+    !isNewDeckRoute &&
+    !submitMessageId &&
+    run.submitMessageId !== null &&
+    !restoresActiveRun;
   let currentRun = run;
   if (
     run.deckId !== deckId ||
@@ -189,11 +213,46 @@ export function useNewDeckGenerationRun(
       (previous.deckId !== currentRun.deckId ||
         previous.submitMessageId !== currentRun.submitMessageId)
     ) {
-      clearNewDeckGenerationRun(previous.deckId, previous.submitMessageId);
+      const hasRecoverableRun =
+        previous.deckId !== currentRun.deckId &&
+        hasStoredNewDeckGenerationRun(
+          previous.deckId,
+          previous.submitMessageId,
+        );
+      if (!hasRecoverableRun) {
+        clearNewDeckGenerationRun(previous.deckId, previous.submitMessageId);
+      }
     }
     previousRunRef.current = currentRun;
   }, [currentRun.deckId, currentRun.submitMessageId]);
 
+  useEffect(() => {
+    const handleRunCleared = (event: Event) => {
+      const detail = (event as CustomEvent).detail;
+      if (
+        detail?.deckId !== currentRunRef.current.deckId ||
+        detail?.submitMessageId !== currentRunRef.current.submitMessageId
+      ) {
+        return;
+      }
+      setRun({
+        deckId: detail.deckId,
+        submitMessageId: null,
+        isNewDeckRoute: false,
+        tabId: null,
+      });
+    };
+    window.addEventListener(
+      NEW_DECK_GENERATION_RUN_CLEARED_EVENT,
+      handleRunCleared,
+    );
+    return () =>
+      window.removeEventListener(
+        NEW_DECK_GENERATION_RUN_CLEARED_EVENT,
+        handleRunCleared,
+      );
+  }, []);
+
   const currentRunRef = useRef(currentRun);
   currentRunRef.current = currentRun;
   const routeCleanupTokenRef = useRef<symbol | null>(null);
@@ -206,7 +265,11 @@ export function useNewDeckGenerationRun(
         if (
           routeCleanupTokenRef.current === token &&
           runAtExit.submitMessageId &&
-          !runAtExit.tabId
+          !runAtExit.tabId &&
+          !hasStoredNewDeckGenerationRun(
+            runAtExit.deckId,
+            runAtExit.submitMessageId,
+          )
         ) {
           clearNewDeckGenerationRun(
             runAtExit.deckId,
@@ -412,6 +475,7 @@ export function useNewDeckGenerationRun(
 
   return {
     generating: activeRun.runKey === runKey && activeRun.generating,
+    submitMessageId: currentRun.submitMessageId,
     tabId: currentRun.tabId,
     questionContinuationPending: currentContinuation.submitMessageId !== null,
     expectQuestionContinuation,
@@ -424,11 +488,19 @@ function createRun(
   isNewDeckRoute: boolean,
   submitMessageId: string | null,
 ): NewDeckGenerationRun {
+  const activeRun = submitMessageId ? null : getActiveRun(deckId);
+  const currentSubmitMessageId =
+    submitMessageId ?? activeRun?.submitMessageId ?? null;
   return {
     deckId,
-    submitMessageId,
-    isNewDeckRoute,
-    tabId: submitMessageId ? getRunTabId(deckId, submitMessageId) : null,
+    submitMessageId: currentSubmitMessageId,
+    isNewDeckRoute: isNewDeckRoute || currentSubmitMessageId !== null,
+    tabId: currentSubmitMessageId
+      ? (getRunTabId(deckId, currentSubmitMessageId) ??
+        (activeRun?.submitMessageId === currentSubmitMessageId
+          ? activeRun.tabId
+          : null))
+      : null,
   };
 }
 
@@ -436,6 +508,50 @@ function getRunTabStorageKey(deckId: string, submitMessageId: string): string {
   return `slides:new-deck-generation:${deckId}:${submitMessageId}`;
 }
 
+function getActiveRunStorageKey(deckId: string): string {
+  return `slides:new-deck-generation-active:${deckId}`;
+}
+
+function getActiveRun(deckId: string): NewDeckGenerationRunReference | null {
+  if (typeof window === "undefined") return null;
+  const serialized = window.sessionStorage.getItem(
+    getActiveRunStorageKey(deckId),
+  );
+  if (!serialized) return null;
+  let value: unknown;
+  try {
+    value = JSON.parse(serialized);
+  } catch (error) {
+    throw new Error(
+      `Cannot restore Slides generation ownership for deck ${deckId}: invalid session data.`,
+      { cause: error },
+    );
+  }
+  if (
+    typeof value !== "object" ||
+    value === null ||
+    !("submitMessageId" in value) ||
+    typeof value.submitMessageId !== "string" ||
+    !("tabId" in value) ||
+    typeof value.tabId !== "string"
+  ) {
+    throw new Error(
+      `Cannot restore Slides generation ownership for deck ${deckId}: invalid session data.`,
+    );
+  }
+  return {
+    submitMessageId: value.submitMessageId,
+    tabId: value.tabId,
+  };
+}
+
+function hasStoredNewDeckGenerationRun(
+  deckId: string,
+  submitMessageId: string,
+): boolean {
+  return getActiveRun(deckId)?.submitMessageId === submitMessageId;
+}
+
 function getRunTabId(deckId: string, submitMessageId: string): string | null {
   if (typeof window === "undefined") return null;
   const key = getRunTabStorageKey(deckId, submitMessageId);
@@ -454,6 +570,13 @@ export function rememberNewDeckGenerationRunTab(
   const key = getRunTabStorageKey(deckId, submitMessageId);
   runTabIds.set(key, tabId);
   window.sessionStorage.setItem(key, tabId);
+  window.sessionStorage.setItem(
+    getActiveRunStorageKey(deckId),
+    JSON.stringify({
+      submitMessageId,
+      tabId,
+    } satisfies NewDeckGenerationRunReference),
+  );
 }
 
 function createLifecycle(

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

@@ -227,7 +227,10 @@ type Navigate = (
 
 type CreateDeck = (
   title?: string,
-  options?: { noDefaultSlides?: boolean; designSystemId?: string | null },
+  options?: {
+    noDefaultSlides?: boolean;
+    designSystemId?: string | null;
+  },
 ) => Deck;
 
 type SubmitAgent = (

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

@@ -598,23 +598,28 @@ export default function DeckEditor() {
   const { generating } = useAgentGenerating();
   const { generating: addSlideAgentGenerating, submit: addSlideAgentSubmit } =
     useAgentGenerating();
-  const generationSubmitId = searchParams.get("generationSubmitId");
-  const isNewDeckGenerationRoute =
-    searchParams.get("generating") === "1" || Boolean(generationSubmitId);
+  const routeGenerationSubmitId = searchParams.get("generationSubmitId");
+  const isNewDeckGenerationRouteFromUrl =
+    searchParams.get("generating") === "1" || Boolean(routeGenerationSubmitId);
   const retryEmptyGenerationInFlightRef = useRef(false);
   const emptyGenerationRecoveryRef = useRef<string | null>(null);
   const [retryEmptyGenerationPending, setRetryEmptyGenerationPending] =
     useState(false);
   const {
     generating: newDeckGenerationGenerating,
+    submitMessageId: restoredGenerationSubmitId,
     tabId: newDeckGenerationTabId,
     questionContinuationPending,
     submitQuestionContinuation: submitTrackedQuestionContinuation,
   } = useNewDeckGenerationRun(
     id ?? "",
-    isNewDeckGenerationRoute,
-    generationSubmitId,
+    isNewDeckGenerationRouteFromUrl,
+    routeGenerationSubmitId,
   );
+  const generationSubmitId =
+    routeGenerationSubmitId ?? restoredGenerationSubmitId;
+  const isNewDeckGenerationRoute =
+    isNewDeckGenerationRouteFromUrl || Boolean(restoredGenerationSubmitId);
   const submitQuestionContinuation = useCallback(
     ({ message, context }: { message: string; context: string }) => {
       if (!generationSubmitId) {
@@ -1831,9 +1836,21 @@ export default function DeckEditor() {
       `The user skipped the pre-generation questions for deck ${id}. Proceed with reasonable defaults. Every slide is rendered into a fixed native canvas (${fitDims.width}x${fitDims.height} CSS pixels; standard padding leaves ${Math.max(0, fitDims.width - 220)}x${Math.max(0, fitDims.height - 160)}px for main content); keep each slide within that fit budget and split dense source material across more slides instead of packing it tightly. Never use zoom, transform: scale(), clipping, or scroll overflow to hide content overflow, and keep body text at least 16px. Start a manage-progress run, add the first slide as soon as it is ready, then continue sequentially using add-slide with --deckId=${id}. Wait for each add-slide result before calling it again.`,
     onSubmitMessage: submitQuestionContinuation,
     onSkipMessage: submitQuestionContinuation,
+    threadId: newDeckGenerationTabId ?? undefined,
   });
 
   const showQuestionFlow = Boolean(questionFlowQuestions?.length);
+  const pendingQuestionKey =
+    questionFlowQuestions?.map((question) => question.id).join(":") ?? "";
+  useEffect(() => {
+    if (!pendingQuestionKey || !newDeckGenerationTabId) return;
+    window.dispatchEvent(
+      new CustomEvent("agent-chat:open-thread", {
+        detail: { threadId: newDeckGenerationTabId },
+      }),
+    );
+    window.dispatchEvent(new Event("agent-panel:open"));
+  }, [id, newDeckGenerationTabId, pendingQuestionKey]);
   const waitingOnNewDeckQuestions =
     showQuestionFlow || questionContinuationPending;
   const { isNewDeckCreation, phase: newDeckGenerationPhase } =
@@ -2152,10 +2169,9 @@ export default function DeckEditor() {
   ]);
 
   useEffect(() => {
-    const submitMessageId = searchParams.get("generationSubmitId");
     if (
       !id ||
-      !submitMessageId ||
+      !generationSubmitId ||
       !shouldClearNewDeckGenerationRun({
         generating: newDeckGenerationGenerating || newDeckGenerationSignal,
         waitingOnQuestions: waitingOnNewDeckQuestions,
@@ -2167,7 +2183,7 @@ export default function DeckEditor() {
     let cancelled = false;
     void refetchPendingQuestion().then((stillWaiting) => {
       if (cancelled || stillWaiting) return;
-      clearNewDeckGenerationRun(id, submitMessageId);
+      clearNewDeckGenerationRun(id, generationSubmitId);
       setSearchParams(
         (prev) => {
           const next = new URLSearchParams(prev);
@@ -2181,6 +2197,7 @@ export default function DeckEditor() {
       cancelled = true;
     };
   }, [
+    generationSubmitId,
     id,
     newDeckGenerationGenerating,
     newDeckGenerationSignal,

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

@@ -495,6 +495,34 @@ async function loadReferenceDeckGenerationContext(
   ].join("\n");
 }
 
+const HOME_LIBRARY_TAB_STORAGE_KEY = "slides-home-library-tab";
+
+function readHomeLibraryTabPreference():
+  | { status: "available"; value: SlidesHomeLibraryTab | null }
+  | { status: "unavailable" } {
+  if (typeof window === "undefined") return { status: "unavailable" };
+  try {
+    const value = window.localStorage.getItem(HOME_LIBRARY_TAB_STORAGE_KEY);
+    return {
+      status: "available",
+      value: value === "templates" || value === "recent" ? value : null,
+    };
+  } catch {
+    return { status: "unavailable" };
+  }
+}
+
+function writeHomeLibraryTabPreference(
+  value: SlidesHomeLibraryTab,
+): { status: "available" } | { status: "unavailable" } {
+  try {
+    window.localStorage.setItem(HOME_LIBRARY_TAB_STORAGE_KEY, value);
+    return { status: "available" };
+  } catch {
+    return { status: "unavailable" };
+  }
+}
+
 export default function Index({ active = true }: { active?: boolean }) {
   const t = useT();
   const openMobileSidebar = useOpenMobileSidebar();
@@ -516,6 +544,11 @@ export default function Index({ active = true }: { active?: boolean }) {
     reloadDecks,
     catchUpStaleDeckList,
   } = useDecks();
+  const viewState = deckListViewState({
+    loading,
+    loadError,
+    deckCount: decks.length,
+  });
   const systemsFlag = useDesignSystemWorkflowsState();
   const systemsEnabled = systemsFlag.enabled;
   const {
@@ -683,20 +716,42 @@ export default function Index({ active = true }: { active?: boolean }) {
     string | null
   >(null);
   const [deckSearch, setDeckSearch] = useState("");
-  const [homeSection, setHomeSection] =
-    useState<SlidesHomeLibraryTab>("templates");
-  const homeLibraryTabWasSelectedRef = useRef(false);
+  const [storedHomeLibraryTab] = useState(readHomeLibraryTabPreference);
+  const homeLibraryTabPreferenceRef = useRef(
+    storedHomeLibraryTab.status === "available"
+      ? storedHomeLibraryTab.value
+      : null,
+  );
+  const homeLibraryTabStorageAvailableRef = useRef(
+    storedHomeLibraryTab.status === "available",
+  );
+  const [homeSection, setHomeSection] = useState<SlidesHomeLibraryTab>(
+    homeLibraryTabPreferenceRef.current ??
+      (viewState === "decks" ? "recent" : "templates"),
+  );
+  const persistHomeLibraryTab = useCallback((value: SlidesHomeLibraryTab) => {
+    if (!homeLibraryTabStorageAvailableRef.current) return;
+    homeLibraryTabStorageAvailableRef.current =
+      writeHomeLibraryTabPreference(value).status === "available";
+  }, []);
+  const selectHomeLibraryTab = useCallback(
+    (value: SlidesHomeLibraryTab) => {
+      homeLibraryTabPreferenceRef.current = value;
+      setHomeSection(value);
+      persistHomeLibraryTab(value);
+    },
+    [persistHomeLibraryTab],
+  );
   const deckFilterWasSelectedRef = useRef(false);
   const revealRecentSearch = useCallback(() => {
     if (decks.length === 0) return false;
-    homeLibraryTabWasSelectedRef.current = true;
-    setHomeSection("recent");
+    selectHomeLibraryTab("recent");
     return true;
-  }, [decks.length]);
+  }, [decks.length, selectHomeLibraryTab]);
   useHomeSearchShortcut(isHome, revealRecentSearch);
   useEffect(() => {
-    if (deckSearch.trim()) setHomeSection("recent");
-  }, [deckSearch]);
+    if (deckSearch.trim()) selectHomeLibraryTab("recent");
+  }, [deckSearch, selectHomeLibraryTab]);
   const [storedDeckFilter, setStoredDeckFilter] = useState<DeckFilter>("mine");
   const referenceDeckAutoRef = useRef(true);
   const [showSignInDialog, setShowSignInDialog] = useState(false);
@@ -1106,6 +1161,7 @@ export default function Index({ active = true }: { active?: boolean }) {
         noDefaultSlides: true,
         designSystemId: selectedDesignSystem?.id ?? null,
         deferPersistence: true,
+        undoableCreation: false,
       });
     });
     if (!deck) {
@@ -2342,24 +2398,23 @@ export default function Index({ active = true }: { active?: boolean }) {
 
   const homeTitle = t("home.decksTitle");
   const deckImport = usePromptImport({ onImport: handleDirectImport });
-  const viewState = deckListViewState({
-    loading,
-    loadError,
-    deckCount: decks.length,
-  });
-  const hasDecks = viewState === "decks";
   useEffect(() => {
     if (viewState === "loading") return;
-    if (!hasDecks) {
+    if (viewState === "empty") {
       setHomeSection("templates");
-      homeLibraryTabWasSelectedRef.current = false;
+      homeLibraryTabPreferenceRef.current = "templates";
+      persistHomeLibraryTab("templates");
       return;
     }
-    if (homeLibraryTabWasSelectedRef.current) return;
-
-    setHomeSection("recent");
-    homeLibraryTabWasSelectedRef.current = true;
-  }, [hasDecks, viewState]);
+    if (viewState === "error") {
+      setHomeSection("templates");
+      return;
+    }
+    const preferredTab = homeLibraryTabPreferenceRef.current ?? "recent";
+    homeLibraryTabPreferenceRef.current = preferredTab;
+    setHomeSection(preferredTab);
+    persistHomeLibraryTab(preferredTab);
+  }, [persistHomeLibraryTab, viewState]);
   const homeHeaderActions = useMemo(
     () => (
       <HomeHeaderActions>
@@ -2542,7 +2597,7 @@ export default function Index({ active = true }: { active?: boolean }) {
         </div>
       }
       quickActions={
-        isHome && quickActionsEnabled ? (
+        isHome && showNewDeckPrompt ? (
           <AgentSuggestionBar
             suggestions={homeSuggestions.map((suggestion, index) => ({
               ...suggestion,
@@ -2585,16 +2640,8 @@ export default function Index({ active = true }: { active?: boolean }) {
       ) : null}
       <ClientOnly>
         <SlidesHomeLibrary
-          recentVisible={hasDecks}
-          value={
-            hasDecks && !homeLibraryTabWasSelectedRef.current
-              ? "recent"
-              : homeSection
-          }
-          onValueChange={(value) => {
-            homeLibraryTabWasSelectedRef.current = true;
-            setHomeSection(value);
-          }}
+          value={homeSection}
+          onValueChange={selectHomeLibraryTab}
           labels={{
             templates: t("templatesPage.title"),
             recent: t("home.recent"),
@@ -2608,18 +2655,14 @@ export default function Index({ active = true }: { active?: boolean }) {
             </Button>
           }
           search={
-            hasDecks ? (
-              <DeckSearchInput
-                value={deckSearch}
-                onChange={setDeckSearch}
-                className="w-full sm:w-64 sm:shrink-0"
-              />
-            ) : null
+            <DeckSearchInput
+              value={deckSearch}
+              onChange={setDeckSearch}
+              className="w-full sm:w-64 sm:shrink-0"
+            />
           }
           recentActions={
-            hasDecks ? (
-              <DeckFilterMenu value={deckFilter} onChange={setDeckFilter} />
-            ) : null
+            <DeckFilterMenu value={deckFilter} onChange={setDeckFilter} />
           }
           templates={<DeckTemplateLibrary enabled={isHome} />}
           recent={

package/corpus/templates/slides/changelog/2026-10-05-file-uploads-explain-the-free-builder-io-option-and-how-to-c.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-10-05
+---
+
+File uploads explain the free Builder.io option and how to connect S3-compatible storage.

package/corpus/templates/slides/changelog/2026-10-05-slides-restores-pending-generation-questions-when-reopened.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-10-05
+---
+
+Slides keeps a pending generation question and its chat available when you leave and reopen a deck.

package/corpus/templates/slides/changelog/2026-10-05-the-home-page-shows-both-library-tabs-and-starter-prompts-im.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-10-05
+---
+
+The home page shows both library tabs and starter prompts immediately while content loads.

package/corpus/templates/slides/changelog/2026-10-05-undo-stops-at-generated-deck.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-10-05
+---
+
+Prompt-generated Slides decks remain when Cmd+Z reaches deck creation.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core-corpus",
-  "version": "0.201.0",
+  "version": "0.201.1",
   "description": "Opt-in source corpus for Agent-Native Core source-search.",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {