@agent-native/core 0.130.2 → 0.131.3

package/corpus/templates/calendar/app/lib/out-of-office.ts

@@ -1,5 +1,13 @@
 import type { CalendarEvent } from "@shared/api";
-import { addDays, differenceInMinutes, parseISO, startOfDay } from "date-fns";
+import {
+  addDays,
+  differenceInMinutes,
+  format,
+  parseISO,
+  startOfDay,
+} from "date-fns";
+
+import { dateTimeInTimezoneToIso } from "@/lib/event-form-utils";
 
 export interface OutOfOfficeSegment {
   topMinutes: number;
@@ -14,6 +22,84 @@ export function isOutOfOfficeEvent(
   return event.eventType === "outOfOffice";
 }
 
+function localDateTimeParts(value: string, timeZone: string) {
+  const date = parseISO(value);
+  if (Number.isNaN(date.getTime())) return null;
+
+  try {
+    const parts = new Intl.DateTimeFormat("en-US", {
+      timeZone,
+      year: "numeric",
+      month: "2-digit",
+      day: "2-digit",
+      hour: "2-digit",
+      minute: "2-digit",
+      hourCycle: "h23",
+    }).formatToParts(date);
+    const valueFor = (type: Intl.DateTimeFormatPartTypes) =>
+      parts.find((part) => part.type === type)?.value;
+    const year = valueFor("year");
+    const month = valueFor("month");
+    const day = valueFor("day");
+    const hour = valueFor("hour");
+    const minute = valueFor("minute");
+    if (!year || !month || !day || !hour || !minute) return null;
+    return { date: `${year}-${month}-${day}`, hour, minute };
+  } catch {
+    return null;
+  }
+}
+
+export function isFullDayOutOfOfficeEvent(
+  event: Pick<
+    CalendarEvent,
+    "eventType" | "allDay" | "start" | "end" | "startTimeZone" | "endTimeZone"
+  >,
+): boolean {
+  return getFullDayOutOfOfficeDateRange(event) !== null;
+}
+
+export function getFullDayOutOfOfficeDateRange(
+  event: Pick<
+    CalendarEvent,
+    "eventType" | "allDay" | "start" | "end" | "startTimeZone" | "endTimeZone"
+  >,
+): { startDate: string; endDateExclusive: string } | null {
+  if (!isOutOfOfficeEvent(event) || event.allDay) return null;
+  const timeZone = event.startTimeZone ?? event.endTimeZone;
+  if (!timeZone) return null;
+  const start = localDateTimeParts(event.start, timeZone);
+  const end = localDateTimeParts(event.end, timeZone);
+  const isFullDay =
+    start !== null &&
+    end !== null &&
+    new Date(event.start).getTime() ===
+      new Date(
+        dateTimeInTimezoneToIso(start.date, "00:00", timeZone),
+      ).getTime() &&
+    new Date(event.end).getTime() ===
+      new Date(
+        dateTimeInTimezoneToIso(end.date, "00:00", timeZone),
+      ).getTime() &&
+    end.date > start.date;
+  return isFullDay
+    ? { startDate: start.date, endDateExclusive: end.date }
+    : null;
+}
+
+export function fullDayOutOfOfficeCoversDate(
+  event: Pick<
+    CalendarEvent,
+    "eventType" | "allDay" | "start" | "end" | "startTimeZone" | "endTimeZone"
+  >,
+  date: Date,
+): boolean {
+  const range = getFullDayOutOfOfficeDateRange(event);
+  if (!range) return false;
+  const dateString = format(date, "yyyy-MM-dd");
+  return dateString >= range.startDate && dateString < range.endDateExclusive;
+}
+
 /** Return the portion of a timed out-of-office event visible on one day. */
 export function getOutOfOfficeSegment(
   event: Pick<CalendarEvent, "start" | "end">,

package/corpus/templates/calendar/app/pages/CalendarView.tsx

@@ -86,16 +86,21 @@ import { useViewPreferences } from "@/hooks/use-view-preferences";
 import { resolveEventAccountEmail } from "@/lib/event-account-selection";
 import { getGoogleEventColorHex } from "@/lib/event-colors";
 import {
+  buildEventTitleUpdate,
   dateTimeInTimezoneToIso,
+  getEditableEventTitle,
   getLocalTimezone,
+  UNNAMED_EVENT_TITLE,
 } from "@/lib/event-form-utils";
 import { buildDeleteEventMutationInput } from "@/lib/event-mutation-inputs";
+import { getLocationSuggestions } from "@/lib/location-suggestions";
 import { isMcpEmbedSurface } from "@/lib/mcp-embed";
 import { cn } from "@/lib/utils";
 
 const CALENDAR_DRAFT_EVENT_PREFIX = "calendar-draft-event:";
 
 type DraftEventPatch = Partial<CalendarEvent> & {
+  fullDay?: boolean;
   addGoogleMeet?: boolean;
   addZoom?: boolean;
   workingLocationType?: "homeOffice" | "officeLocation" | "customLocation";
@@ -168,8 +173,28 @@ function addMinutesToDateTimeParts(
 
 function draftRange(draft: CalendarEventDraft, fallbackDate: Date) {
   const fallback = fallbackDraftRange(fallbackDate);
-  const start = parseValidDate(draft.start) ?? fallback.start;
-  const parsedEnd = parseValidDate(draft.end);
+  const fullDayTimezone = draft.startTimeZone ?? draft.endTimeZone;
+  const fullDayDatePattern = /^\d{4}-\d{2}-\d{2}$/;
+  const semanticFullDay =
+    draft.eventType === "outOfOffice" &&
+    draft.fullDay &&
+    fullDayTimezone &&
+    draft.start &&
+    draft.end &&
+    fullDayDatePattern.test(draft.start) &&
+    fullDayDatePattern.test(draft.end);
+  const start = semanticFullDay
+    ? new Date(dateTimeInTimezoneToIso(draft.start!, "00:00", fullDayTimezone!))
+    : (parseValidDate(draft.start) ?? fallback.start);
+  const parsedEnd = semanticFullDay
+    ? new Date(
+        dateTimeInTimezoneToIso(
+          format(addDays(parseISO(draft.end!), 1), "yyyy-MM-dd"),
+          "00:00",
+          fullDayTimezone!,
+        ),
+      )
+    : parseValidDate(draft.end);
   const end =
     parsedEnd && parsedEnd.getTime() > start.getTime()
       ? parsedEnd
@@ -182,16 +207,25 @@ function draftToCalendarEvent(
   fallbackDate: Date,
 ): CalendarEvent {
   const { start, end } = draftRange(draft, fallbackDate);
+  const editableTitle = draft.title?.trim() ?? "";
   return {
     id: calendarDraftEventId(draft.id),
-    title: draft.title?.trim() || "(No title)",
+    title:
+      editableTitle ||
+      (draft.eventType === "outOfOffice"
+        ? "Out of office"
+        : UNNAMED_EVENT_TITLE),
+    titleIsGenerated: !editableTitle,
     description: draft.description ?? "",
     start: start.toISOString(),
     end: end.toISOString(),
     startTimeZone: draft.startTimeZone,
     endTimeZone: draft.endTimeZone ?? draft.startTimeZone,
     location: draft.location ?? draft.workingLocationLabel ?? "",
-    allDay: draft.allDay ?? false,
+    allDay:
+      draft.eventType === "outOfOffice" && draft.fullDay
+        ? false
+        : (draft.allDay ?? false),
     source: "local",
     accountEmail: draft.accountEmail,
     colorId: draft.colorId,
@@ -199,6 +233,7 @@ function draftToCalendarEvent(
     transparency: draft.transparency,
     visibility: draft.visibility,
     eventType: draft.eventType ?? "default",
+    outOfOfficeProperties: draft.outOfOfficeProperties,
     recurrence: draft.recurrence,
     attendees: draft.attendees,
     reminders: draft.reminders,
@@ -236,7 +271,9 @@ function applyDraftPatch(
   copy("endTimeZone");
   copy("location");
   copy("allDay");
+  copy("fullDay");
   copy("eventType");
+  copy("outOfOfficeProperties");
   copy("transparency");
   copy("visibility");
   copy("colorId");
@@ -548,6 +585,10 @@ export default function CalendarView() {
         : events,
     [events, viewMode, selectedDate],
   );
+  const locationSuggestions = useMemo(
+    () => getLocationSuggestions(events),
+    [events],
+  );
   const openNotificationEvent = useCallback(
     (event: CalendarEvent) => {
       setSelectedDate(parseISO(event.start));
@@ -616,9 +657,10 @@ export default function CalendarView() {
         setEventDraft(draft);
         persistCalendarDraft(draft);
       }
-      const trimmedTitle = draft.title?.trim();
+      const editableTitle = draft.title?.trim() ?? "";
+      const eventType = draft.eventType ?? "default";
       const title =
-        trimmedTitle && trimmedTitle !== "(No title)" ? trimmedTitle : "";
+        editableTitle || (eventType === "outOfOffice" ? "Out of office" : "");
       if (!title && !isSlotDraftId(draftId)) {
         committingDraftIdsRef.current.delete(draftId);
         toast.error(t("calendarView.addTitleBeforeCreate"));
@@ -632,9 +674,13 @@ export default function CalendarView() {
         return;
       }
 
-      const eventType = draft.eventType ?? "default";
       const location = draft.location ?? draft.workingLocationLabel ?? "";
       const timezone = draft.startTimeZone ?? getLocalTimezone();
+      const semanticFullDay =
+        eventType === "outOfOffice" &&
+        draft.fullDay === true &&
+        /^\d{4}-\d{2}-\d{2}$/.test(draft.start ?? "") &&
+        /^\d{4}-\d{2}-\d{2}$/.test(draft.end ?? "");
       const statusPatch =
         eventType === "default"
           ? {}
@@ -647,21 +693,32 @@ export default function CalendarView() {
                 "customLocation"
                   ? location
                   : draft.workingLocationLabel,
+              autoDeclineMode:
+                eventType === "outOfOffice"
+                  ? draft.outOfOfficeProperties?.autoDeclineMode
+                  : undefined,
+              declineMessage:
+                eventType === "outOfOffice"
+                  ? draft.outOfOfficeProperties?.declineMessage
+                  : undefined,
             };
 
       const payload: Parameters<typeof createEvent.mutate>[0] = {
         _tempId: eventId,
         title,
-        description: draft.description ?? "",
-        start: start.toISOString(),
-        end: end.toISOString(),
+        titleIsGenerated: !editableTitle,
+        description:
+          eventType === "outOfOffice" ? "" : (draft.description ?? ""),
+        start: semanticFullDay ? draft.start! : start.toISOString(),
+        end: semanticFullDay ? draft.end! : end.toISOString(),
         startTimeZone: draft.allDay ? undefined : timezone,
         endTimeZone: draft.allDay
           ? undefined
           : (draft.endTimeZone ?? draft.startTimeZone ?? timezone),
-        location,
+        location: eventType === "outOfOffice" ? "" : location,
         accountEmail,
         allDay: draft.allDay ?? false,
+        fullDay: draft.fullDay,
         transparency:
           eventType === "workingLocation"
             ? "transparent"
@@ -673,15 +730,16 @@ export default function CalendarView() {
         reminders: draft.reminders,
         remindersUseDefault: draft.remindersUseDefault,
         ...statusPatch,
-        addGoogleMeet: draft.addGoogleMeet,
-        addZoom: draft.addZoom,
+        addGoogleMeet:
+          eventType === "outOfOffice" ? undefined : draft.addGoogleMeet,
+        addZoom: eventType === "outOfOffice" ? undefined : draft.addZoom,
         color: draft.colorId
           ? getGoogleEventColorHex(draft.colorId)
           : undefined,
         colorId: draft.colorId,
         recurrence: draft.recurrence,
         attachments: draft.attachments,
-        attendees: draft.attendees,
+        attendees: eventType === "outOfOffice" ? undefined : draft.attendees,
       };
 
       deletePersistedCalendarDraft(draftId);
@@ -1305,8 +1363,9 @@ export default function CalendarView() {
   const handleQuickEditSave = useCallback(
     async (eventId: string, title: string, accountEmail?: string) => {
       setQuickEditEventId(null);
+      const trimmedTitle = title.trim();
       if (calendarDraftIdFromEventId(eventId)) {
-        updateDraftEvent(eventId, { title: title.trim() });
+        updateDraftEvent(eventId, { title: trimmedTitle });
         return;
       }
       setQuickEditTempIds((current) => {
@@ -1314,9 +1373,9 @@ export default function CalendarView() {
         const { [eventId]: _removed, ...next } = current;
         return next;
       });
-      if (title.trim() && title.trim() !== "(No title)") {
+      if (trimmedTitle) {
         const event = events.find((e) => e.id === eventId);
-        const updates = { title: title.trim() };
+        const updates = buildEventTitleUpdate(trimmedTitle);
         const guestNotification = event
           ? await promptGuestNotification({
               event,
@@ -1338,12 +1397,14 @@ export default function CalendarView() {
 
   const handleTitleSave = useCallback(
     async (eventId: string, title: string, accountEmail?: string) => {
+      const trimmedTitle = title.trim();
+      if (!trimmedTitle) return;
       if (calendarDraftIdFromEventId(eventId)) {
-        updateDraftEvent(eventId, { title });
+        updateDraftEvent(eventId, { title: trimmedTitle });
         return;
       }
       const event = events.find((e) => e.id === eventId);
-      const updates = { title };
+      const updates = buildEventTitleUpdate(trimmedTitle);
       const guestNotification = event
         ? await promptGuestNotification({
             event,
@@ -1376,7 +1437,7 @@ export default function CalendarView() {
       });
       // Delete the event if title was never set
       const ev = events.find((e) => e.id === eventId);
-      if (!ev || ev.title === "(No title)") {
+      if (!ev || !getEditableEventTitle(ev).trim()) {
         deleteEvent.mutate(
           buildDeleteEventMutationInput(
             {
@@ -1719,6 +1780,7 @@ export default function CalendarView() {
                 defaultDate={selectedDate}
                 defaultStartTime={createDefaultStart}
                 defaultEndTime={createDefaultEnd}
+                locationSuggestions={locationSuggestions}
               />
               <AccountAvatars />
               <AgentToggleButton />

package/corpus/templates/calendar/changelog/2026-07-26-out-of-office-events-now-default-to-full-days-with-a-ready.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-26
+---
+
+Out-of-office events now default to full days with a ready-to-use title and automatic decline settings.

package/corpus/templates/calendar/changelog/2026-07-29-recent-calendar-locations-now-appear-as-address-suggestions-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-29
+---
+
+Recent calendar locations now appear as address suggestions while creating an event.

package/corpus/templates/calendar/changelog/2026-07-29-sidebar-footers-now-keep-feedback-search-and-collapse-togeth.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-29
+---
+
+Sidebar footers now keep Feedback, Search, and Collapse together without a separate language shortcut.

package/corpus/templates/calendar/changelog/2026-07-29-unnamed-events-now-use-a-title-placeholder.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-29
+---
+
+Unnamed events now show an empty title field with an “Add title” placeholder when you edit them.

package/corpus/templates/calendar/server/lib/find-time.ts

@@ -110,11 +110,35 @@ export function zonedDateTimeToUtcIso(
   const [year, month, day] = dateOnly.split("-").map(Number);
   const [hour, minute] = time.split(":").map(Number);
   const wallClockUtc = Date.UTC(year, month - 1, day, hour, minute, 0);
-  const firstGuess = new Date(wallClockUtc);
-  const firstOffset = offsetMsForTimezone(firstGuess, timezone);
-  const secondGuess = new Date(wallClockUtc - firstOffset);
-  const secondOffset = offsetMsForTimezone(secondGuess, timezone);
-  return new Date(wallClockUtc - secondOffset).toISOString();
+  const offsets = new Set<number>();
+  for (let hours = -36; hours <= 36; hours += 6) {
+    offsets.add(
+      offsetMsForTimezone(
+        new Date(wallClockUtc + hours * 60 * 60 * 1000),
+        timezone,
+      ),
+    );
+  }
+
+  const candidates = [...offsets]
+    .map((offset) => new Date(wallClockUtc - offset))
+    .map((candidate) => ({
+      candidate,
+      localWallClock:
+        candidate.getTime() + offsetMsForTimezone(candidate, timezone),
+    }))
+    .sort((a, b) => {
+      const aDelta = a.localWallClock - wallClockUtc;
+      const bDelta = b.localWallClock - wallClockUtc;
+      if (aDelta === 0 && bDelta === 0) {
+        return a.candidate.getTime() - b.candidate.getTime();
+      }
+      if (aDelta >= 0 && bDelta < 0) return -1;
+      if (aDelta < 0 && bDelta >= 0) return 1;
+      return Math.abs(aDelta) - Math.abs(bDelta);
+    });
+
+  return candidates[0].candidate.toISOString();
 }
 
 function normalizeDateBound(value: string, timezone: string): string {

package/corpus/templates/calendar/server/lib/google-calendar.ts

@@ -881,6 +881,7 @@ export async function listEvents(
           return {
             id: `google-${event.id}`,
             title: event.summary || "Untitled",
+            titleIsGenerated: !event.summary,
             description: event.description || "",
             start: event.start?.dateTime || event.start?.date || "",
             end: event.end?.dateTime || event.end?.date || "",
@@ -1153,6 +1154,7 @@ export async function getEvent(
   return {
     id: `google-${event.id}`,
     title: event.summary || "Untitled",
+    titleIsGenerated: !event.summary,
     description: event.description || "",
     start: event.start?.dateTime || event.start?.date || "",
     end: event.end?.dateTime || event.end?.date || "",

package/corpus/templates/calendar/server/lib/ical-fetcher.ts

@@ -327,6 +327,7 @@ export async function fetchICalEvents(
     .map((e) => ({
       id: `ical-${feedId}-${e.uid}`,
       title: e.summary || "(No title)",
+      titleIsGenerated: !e.summary,
       description: e.description || "",
       start: e.start,
       end: e.end,

package/corpus/templates/calendar/shared/api.ts

@@ -1,6 +1,8 @@
 export interface CalendarEvent {
   id: string;
   title: string;
+  /** Client-facing provenance for a display label synthesized from an absent title. */
+  titleIsGenerated?: boolean;
   description: string;
   start: string; // ISO 8601
   end: string; // ISO 8601
@@ -138,7 +140,9 @@ export interface CalendarEventDraft {
   endTimeZone?: string;
   location?: string;
   allDay?: boolean;
+  fullDay?: boolean;
   eventType?: "default" | "outOfOffice" | "focusTime" | "workingLocation";
+  outOfOfficeProperties?: CalendarEvent["outOfOfficeProperties"];
   transparency?: "opaque" | "transparent";
   visibility?: "default" | "public" | "private" | "confidential";
   colorId?: string;

package/corpus/templates/chat/.agents/skills/agent-native-toolkit/SKILL.md

@@ -117,6 +117,11 @@ in the moment of agent use.
   missing-secret states, OAuth grants, and provider connection health.
 - **Agent UX kit**: sidebar, composer, staged context, mentions, voice, human
   approval, generative UI, progress, and screen-state exposure.
+- **Custom block kit**: optional extension creation, viewer chrome, slots, and
+  promotion affordances. Apps must opt in; Core keeps the sandbox, SQL storage,
+  access checks, and compatibility routes, while Toolkit owns reusable adoption
+  UI. Analytics may expose this as one-off **Custom Blocks**; durable behavior
+  should be promoted to app code.
 - **Chat history kit**: presentational chat lists and recent-chat rails belong
   in Toolkit; Core keeps thread persistence, agent execution, transport, and
   page-to-sidebar handoff. Use Toolkit's `ChatHistoryRail` for the standard

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

@@ -4,7 +4,7 @@ import {
   type ChatThreadSummary,
 } from "@agent-native/core/client/agent-chat";
 import { appPath } from "@agent-native/core/client/api-path";
-import { LanguagePicker, useT } from "@agent-native/core/client/i18n";
+import { useT } from "@agent-native/core/client/i18n";
 import { openCommandMenu } from "@agent-native/core/client/navigation";
 import { OrgSwitcher } from "@agent-native/core/client/org";
 import { FeedbackButton } from "@agent-native/core/client/ui";
@@ -334,9 +334,6 @@ export function Sidebar({
       <TooltipContent side="right">{t("root.commandSearch")}</TooltipContent>
     </Tooltip>
   );
-  const translateButton = (
-    <LanguagePicker variant="ghost-icon" label={t("settings.languageLabel")} />
-  );
   const feedbackButton = (
     <FeedbackButton
       variant={collapsed ? "icon" : "sidebar"}
@@ -495,7 +492,6 @@ export function Sidebar({
         <SidebarFooterActions
           collapsed={collapsed}
           feedback={feedbackButton}
-          translate={translateButton}
           search={searchButton}
           collapse={collapseButton}
         />

package/corpus/templates/chat/changelog/2026-07-29-sidebar-footers-now-keep-feedback-search-and-collapse-togeth.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-29
+---
+
+Sidebar footers now keep Feedback, Search, and Collapse together without a separate language shortcut.

package/corpus/templates/clips/.agents/skills/agent-native-toolkit/SKILL.md

@@ -117,6 +117,11 @@ in the moment of agent use.
   missing-secret states, OAuth grants, and provider connection health.
 - **Agent UX kit**: sidebar, composer, staged context, mentions, voice, human
   approval, generative UI, progress, and screen-state exposure.
+- **Custom block kit**: optional extension creation, viewer chrome, slots, and
+  promotion affordances. Apps must opt in; Core keeps the sandbox, SQL storage,
+  access checks, and compatibility routes, while Toolkit owns reusable adoption
+  UI. Analytics may expose this as one-off **Custom Blocks**; durable behavior
+  should be promoted to app code.
 - **Chat history kit**: presentational chat lists and recent-chat rails belong
   in Toolkit; Core keeps thread persistence, agent execution, transport, and
   page-to-sidebar handoff. Use Toolkit's `ChatHistoryRail` for the standard

package/corpus/templates/clips/app/components/library/library-layout.tsx

@@ -5,7 +5,7 @@ import {
 import { appPath } from "@agent-native/core/client/api-path";
 import { DevDatabaseLink } from "@agent-native/core/client/db-admin";
 import { getBrowserTabId } from "@agent-native/core/client/hooks";
-import { LanguagePicker, useT } from "@agent-native/core/client/i18n";
+import { useT } from "@agent-native/core/client/i18n";
 import { openCommandMenu } from "@agent-native/core/client/navigation";
 import {
   InvitationBanner,
@@ -201,9 +201,6 @@ export function LibraryLayout({ children }: LibraryLayoutProps) {
       <TooltipContent side="right">{t("root.commandSearch")}</TooltipContent>
     </Tooltip>
   );
-  const translateButton = (
-    <LanguagePicker variant="ghost-icon" label={t("settings.languageLabel")} />
-  );
   const feedbackButton = (
     <FeedbackButton
       variant={showCollapsedSidebar ? "icon" : "sidebar"}
@@ -673,7 +670,6 @@ export function LibraryLayout({ children }: LibraryLayoutProps) {
         <SidebarFooterActions
           collapsed={showCollapsedSidebar}
           feedback={feedbackButton}
-          translate={translateButton}
           search={searchButton}
           collapse={collapseButton}
           className={showCollapsedSidebar ? undefined : "px-0 py-0"}

package/corpus/templates/clips/changelog/2026-07-29-fixed-system-audio-recordings-picking-up-your-microphone-in-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-29
+---
+
+Fixed system-audio recordings picking up your microphone in their transcript.

package/corpus/templates/clips/changelog/2026-07-29-sidebar-footers-now-keep-feedback-search-and-collapse-togeth.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-29
+---
+
+Sidebar footers now keep Feedback, Search, and Collapse together without a separate language shortcut.

package/corpus/templates/clips/changelog/2026-07-29-the-desktop-camera-preview-now-closes-after-a-recording-fin.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-29
+---
+
+The desktop camera preview now closes after a recording finishes instead of lingering as a black circle.

package/corpus/templates/clips/desktop/src/app.tsx

@@ -30,6 +30,7 @@ import {
   type RefObject,
   useCallback,
   useEffect,
+  useLayoutEffect,
   useRef,
   useState,
 } from "react";
@@ -55,6 +56,7 @@ import { useMeetingTranscription } from "./hooks/useMeetingTranscription";
 import { stopAllMicMeters } from "./hooks/useMicMeter";
 import { useWhisperSettings } from "./hooks/useWhisperSettings";
 import { startBubbleFramePump } from "./lib/bubble-pump";
+import { shouldKeepBubbleSession } from "./lib/bubble-session";
 import {
   startBubbleWebrtc,
   type BubbleWebrtcHandle,
@@ -2196,26 +2198,23 @@ export function App() {
   const nativeFullscreenRecordingActive =
     mode !== "camera" && shouldUseNativeFullscreenRecording(source);
   // Ref mirror of `isRecording || recordingFlowActive` so cleanup (which
-  // captures the dep-snapshot value) can still see the CURRENT flow state
-  // at the moment it actually runs. Without this, if `recordingFlowActive`
-  // briefly flips false on a re-render mid-flow (e.g. finally-block
-  // recovery path), the cleanup function snapshots `bubbleActive=false`
-  // from THAT render and stops the camera stream even though recording is
-  // still in flight.
+  // captures the dep-snapshot value) can still see the current flow state.
+  // Update it in a layout effect: passive effect cleanup runs before passive
+  // effect setup, so mirroring this in a passive effect leaves cleanup behind.
   const recordingFlowGateRef = useRef(false);
   // Stop detaches the recorder state before optimization/upload finishes so a
   // fresh camera session can recover immediately. Keep that post-stop phase
   // separate so React cleanup does not close the finalizing progress window.
   const recordingStopFinalizingRef = useRef(false);
-  useEffect(() => {
-    recordingFlowGateRef.current = isRecording || recordingFlowActive;
-  }, [isRecording, recordingFlowActive]);
-  const bubbleActive =
-    wantsCamera &&
-    (popoverVisible ||
-      isRecording ||
-      recordingFlowActive ||
-      recordingFlowGateRef.current);
+  const recordingInFlight = isRecording || recordingFlowActive;
+  useLayoutEffect(() => {
+    recordingFlowGateRef.current = recordingInFlight;
+  }, [recordingInFlight]);
+  const bubbleActive = shouldKeepBubbleSession({
+    wantsCamera,
+    popoverVisible,
+    recordingInFlight,
+  });
 
   bubbleActiveRef.current = bubbleActive;
   // The toolbar is recording chrome, not pre-record chrome. Showing it while

package/corpus/templates/clips/desktop/src/lib/bubble-session.ts

@@ -0,0 +1,11 @@
+export function shouldKeepBubbleSession({
+  wantsCamera,
+  popoverVisible,
+  recordingInFlight,
+}: {
+  wantsCamera: boolean;
+  popoverVisible: boolean;
+  recordingInFlight: boolean;
+}): boolean {
+  return wantsCamera && (popoverVisible || recordingInFlight);
+}