@agent-native/core 0.92.0 → 0.92.2

package/corpus/templates/clips/app/i18n/ko-KR.ts

@@ -312,7 +312,7 @@ const messages = {
     unassigned: "할당되지 않음",
     them: "그들을",
     me: "나",
-    regeneratingNotes: "메모 재생성 - 자신의 메모가 유지됩니다.",
+    regeneratingNotes: "요약 재생성 중",
     meetingRemoved: "회의가 삭제되었습니다.",
     couldNotRemoveMeeting: "회의를 삭제할 수 없습니다.",
     couldNotLoadMeeting: "이 회의를 로드할 수 없습니다.",
@@ -320,8 +320,8 @@ const messages = {
     couldNotCopyTranscript: "스크립트를 복사할 수 없습니다.",
     allMeetings: "모든 회의",
     live: "살다",
-    generatingNotesInline: "메모 생성 중…",
-    regenerateNotes: "메모 재생성",
+    generatingNotesInline: "요약 생성 중…",
+    regenerateNotes: "요약 재생성",
     share: "공유하다",
     meetingOptions: "회의 옵션",
     removeMeeting: "회의 삭제",
@@ -334,12 +334,13 @@ const messages = {
     desktopHint:
       "메모를 시작하려면 메뉴 막대에서 Clips Desktop을 열고 Start Meeting Notes를 선택하거나, 알림이 표시되면 Start notes를 클릭하세요. Clips가 마이크와 시스템 오디오를 캡처하고 여기에 기록을 작성합니다.",
     getDesktopApp: "데스크톱 앱 받기",
-    generateNotesFailed: "메모를 생성할 수 없습니다. 다시 시도해 보세요.",
+    generateNotesFailed: "요약을 생성할 수 없습니다. 다시 시도해 보세요.",
     attendee_one: "{{count}} 참석자",
     attendee_other: "{{count}} 참석자",
     joinCall: "통화에 참여",
     myNotes: "내 노트",
     aiNotes: "AI 노트",
+    summary: "요약",
     actionItems: "조치사항",
     working: "일하고 있는…",
     noActionItems:
@@ -904,7 +905,7 @@ Clips의 모든 사용자 대상 변경 사항은 여기에 기록됩니다. 명
     unavailable: "이 회의는 비공개이거나 더 이상 사용할 수 없습니다.",
     tryClips: "Clips 사용해 보기",
     attendees: "참석자 {{count}}명",
-    noAiNotes: "이 회의의 AI 노트가 아직 생성되지 않았습니다.",
+    noAiNotes: "이 회의의 요약이 아직 생성되지 않았습니다.",
     summary: "요약",
     keyPoints: "핵심 포인트",
     actionItems: "작업 항목",

package/corpus/templates/clips/app/i18n/pt-BR.ts

@@ -317,7 +317,7 @@ const messages = {
     unassigned: "Não atribuído",
     them: "Eles",
     me: "Meu",
-    regeneratingNotes: "Regenerando notas — suas próprias notas são mantidas",
+    regeneratingNotes: "Regenerando resumo",
     meetingRemoved: "Reunião removida",
     couldNotRemoveMeeting: "Não foi possível remover a reunião",
     couldNotLoadMeeting: "Não foi possível carregar esta reunião.",
@@ -325,8 +325,8 @@ const messages = {
     couldNotCopyTranscript: "Não foi possível copiar a transcrição",
     allMeetings: "Todas as reuniões",
     live: "Ao vivo",
-    generatingNotesInline: "Gerando notas…",
-    regenerateNotes: "Regenerar notas",
+    generatingNotesInline: "Gerando resumo…",
+    regenerateNotes: "Regenerar resumo",
     share: "Compartilhar",
     meetingOptions: "Opções de reunião",
     removeMeeting: "Remover reunião",
@@ -339,12 +339,13 @@ const messages = {
     desktopHint:
       "Para iniciar notas, abra o Clips Desktop na barra de menus e escolha Start Meeting Notes, ou clique em Start notes quando o lembrete aparecer. O Clips captura o microfone e o áudio do sistema e escreve a transcrição aqui.",
     getDesktopApp: "Obtenha o aplicativo para desktop",
-    generateNotesFailed: "Não foi possível gerar notas. Tente novamente.",
+    generateNotesFailed: "Não foi possível gerar o resumo. Tente novamente.",
     attendee_one: "participante {{count}}",
     attendee_other: "participantes {{count}}",
     joinCall: "Participar da chamada",
     myNotes: "Minhas anotações",
     aiNotes: "Notas de IA",
+    summary: "Resumo",
     actionItems: "Itens de ação",
     working: "Trabalhando…",
     noActionItems:
@@ -921,7 +922,7 @@ Todas as mudanças visíveis para usuários do Clips são documentadas aqui. Voc
     unavailable: "Esta reunião é privada ou não está mais disponível.",
     tryClips: "Experimentar Clips",
     attendees: "{{count}} participantes",
-    noAiNotes: "As notas de IA ainda não foram geradas para esta reunião.",
+    noAiNotes: "Um resumo ainda não foi gerado para esta reunião.",
     summary: "Resumo",
     keyPoints: "Pontos principais",
     actionItems: "Itens de ação",

package/corpus/templates/clips/app/i18n/zh-CN.ts

@@ -299,7 +299,7 @@ const messages = {
     unassigned: "未分配",
     them: "他们",
     me: "我",
-    regeneratingNotes: "重新生成笔记——保留您自己的笔记",
+    regeneratingNotes: "正在重新生成摘要",
     meetingRemoved: "会议已删除",
     couldNotRemoveMeeting: "无法删除会议",
     couldNotLoadMeeting: "无法加载该会议。",
@@ -307,8 +307,8 @@ const messages = {
     couldNotCopyTranscript: "无法复制成绩单",
     allMeetings: "所有会议",
     live: "居住",
-    generatingNotesInline: "正在生成笔记...",
-    regenerateNotes: "重新生成笔记",
+    generatingNotesInline: "正在生成摘要...",
+    regenerateNotes: "重新生成摘要",
     share: "分享",
     meetingOptions: "会议选项",
     removeMeeting: "删除会议",
@@ -321,12 +321,13 @@ const messages = {
     desktopHint:
       "要开始记录，请从菜单栏打开 Clips Desktop 并选择 Start Meeting Notes，或在提醒出现时点击 Start notes。Clips 会捕获麦克风和系统音频，并在这里写入文字记录。",
     getDesktopApp: "获取桌面应用程序",
-    generateNotesFailed: "无法生成笔记。再试一次。",
+    generateNotesFailed: "无法生成摘要。再试一次。",
     attendee_one: "{{count}} 与会者",
     attendee_other: "{{count}} 与会者",
     joinCall: "加入通话",
     myNotes: "我的笔记",
     aiNotes: "人工智能笔记",
+    summary: "摘要",
     actionItems: "行动项目",
     working: "在职的…",
     noActionItems: "还没有行动项目。从记录生成笔记后，它们会出现在此处。",
@@ -867,7 +868,7 @@ Clips 中所有面向用户的重要更改都会记录在这里。你可以随
     unavailable: "此会议是私密的或不再可用。",
     tryClips: "试用 Clips",
     attendees: "{{count}} 位参会者",
-    noAiNotes: "此会议尚未生成 AI 笔记。",
+    noAiNotes: "此会议尚未生成摘要。",
     summary: "摘要",
     keyPoints: "要点",
     actionItems: "行动项",

package/corpus/templates/clips/app/i18n/zh-TW.ts

@@ -299,7 +299,7 @@ const messages = {
     unassigned: "未指派",
     them: "他們",
     me: "我",
-    regeneratingNotes: "正在重新產生筆記，並保留您自己的筆記",
+    regeneratingNotes: "正在重新產生摘要",
     meetingRemoved: "會議已刪除",
     couldNotRemoveMeeting: "無法刪除會議",
     couldNotLoadMeeting: "無法載入該會議。",
@@ -307,8 +307,8 @@ const messages = {
     couldNotCopyTranscript: "無法複製逐字稿",
     allMeetings: "所有會議",
     live: "即時",
-    generatingNotesInline: "正在產生筆記...",
-    regenerateNotes: "重新產生筆記",
+    generatingNotesInline: "正在產生摘要...",
+    regenerateNotes: "重新產生摘要",
     share: "分享",
     meetingOptions: "會議選項",
     removeMeeting: "刪除會議",
@@ -321,12 +321,13 @@ const messages = {
     desktopHint:
       "若要開始筆記，請從選單列開啟 Clips Desktop 並選擇 Start Meeting Notes，或在提醒出現時按 Start notes。Clips 會擷取麥克風和系統音訊，並在這裡寫入逐字稿。",
     getDesktopApp: "取得桌面應用程式",
-    generateNotesFailed: "無法產生筆記。請再試一次。",
+    generateNotesFailed: "無法產生摘要。請再試一次。",
     attendee_one: "{{count}} 與會者",
     attendee_other: "{{count}} 與會者",
     joinCall: "加入通話",
     myNotes: "我的筆記",
     aiNotes: "AI 筆記",
+    summary: "摘要",
     actionItems: "行動項目",
     working: "處理中…",
     noActionItems: "還沒有行動項目。從逐字稿產生筆記後，它們會出現在此處。",
@@ -860,7 +861,7 @@ const messages = {
     unavailable: "此會議是私密的或不再可用。",
     tryClips: "試用 Clips",
     attendees: "{{count}} 位與會者",
-    noAiNotes: "此會議尚未產生 AI 筆記。",
+    noAiNotes: "此會議尚未產生摘要。",
     summary: "摘要",
     keyPoints: "要點",
     actionItems: "行動項",

package/corpus/templates/clips/app/routes/_app.meetings.$meetingId.tsx

@@ -9,16 +9,16 @@ import {
   IconClock,
   IconCopy,
   IconDeviceDesktop,
-  IconDots,
+  IconDotsVertical,
   IconEdit,
   IconExternalLink,
   IconLoader2,
   IconNotes,
   IconPlayerStop,
+  IconRefresh,
   IconShare3,
   IconTrash,
   IconUsers,
-  IconWand,
 } from "@tabler/icons-react";
 import { useQueryClient } from "@tanstack/react-query";
 import { useEffect, useMemo, useRef, useState } from "react";
@@ -60,7 +60,6 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { Skeleton } from "@/components/ui/skeleton";
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import {
   Tooltip,
   TooltipContent,
@@ -123,14 +122,6 @@ function formatDateTime(iso?: string | null): string {
   }
 }
 
-function formatDurationMs(ms?: number | null): string {
-  if (!ms || ms <= 0) return "";
-  const total = Math.round(ms / 1000);
-  const m = Math.floor(total / 60);
-  const s = total % 60;
-  return `${m}:${s.toString().padStart(2, "0")}`;
-}
-
 function TitleEditor({
   value,
   onChange,
@@ -482,12 +473,6 @@ export default function MeetingDetailRoute() {
     updateMeeting.mutate({ id: meeting.id, summaryMd: next });
   };
 
-  const handleUserNotesChange = (next: string) => {
-    if (!meeting) return;
-    patchCachedMeeting({ userNotesMd: next });
-    updateMeeting.mutate({ id: meeting.id, userNotesMd: next });
-  };
-
   const handleToggleActionItem = (index: number, completed: boolean) => {
     if (!meeting) return;
     const items = meeting.actionItemsJson ?? [];
@@ -517,7 +502,7 @@ export default function MeetingDetailRoute() {
 
   const handleFinalize = () => {
     if (!meeting) return;
-    // "My notes" (userNotesMd) is a separate field and is untouched by
+    // User-authored notes (userNotesMd) are separate and untouched by
     // regeneration; only the AI summary/bullets are overwritten. Reassure
     // the user their own notes are kept.
     if (hasNotes) {
@@ -626,7 +611,8 @@ export default function MeetingDetailRoute() {
   const bullets = meeting.bulletsJson ?? [];
   const actionItems = meeting.actionItemsJson ?? [];
   const segments = meeting.segmentsJson ?? [];
-  const recordingDuration = formatDurationMs(meeting.recordingDurationMs);
+  const hasSummary =
+    !!meeting.summaryMd || bullets.length > 0 || actionItems.length > 0;
 
   const handleCopyTranscript = async () => {
     if (!segments.length) return;
@@ -647,7 +633,7 @@ export default function MeetingDetailRoute() {
   };
 
   return (
-    <div className="p-6 max-w-6xl mx-auto w-full flex flex-col min-h-0 flex-1">
+    <div className="p-6 max-w-6xl mx-auto w-full flex flex-col min-h-0 flex-1 lg:h-full lg:overflow-hidden">
       <PageHeader>
         <Tooltip>
           <TooltipTrigger asChild>
@@ -692,15 +678,6 @@ export default function MeetingDetailRoute() {
               <IconLoader2 className="h-3.5 w-3.5 animate-spin" />
               {t("meetingDetail.generatingNotesInline")}
             </span>
-          ) : hasNotes ? (
-            <Button
-              size="sm"
-              variant="ghost"
-              onClick={handleFinalize}
-              className="cursor-pointer h-8"
-            >
-              {t("meetingDetail.regenerateNotes")}
-            </Button>
           ) : null}
           <ShareMeetingPopover
             meetingId={meeting.id}
@@ -721,10 +698,16 @@ export default function MeetingDetailRoute() {
                     className="h-8 w-8 cursor-pointer"
                     aria-label={t("meetingDetail.meetingOptions")}
                   >
-                    <IconDots className="h-4 w-4" />
+                    <IconDotsVertical className="h-4 w-4" />
                   </Button>
                 </DropdownMenuTrigger>
                 <DropdownMenuContent align="end" className="w-44">
+                  {hasSummary && !finalize.isPending && (
+                    <DropdownMenuItem onSelect={handleFinalize}>
+                      <IconRefresh className="mr-2 h-4 w-4" />
+                      {t("meetingDetail.regenerateNotes")}
+                    </DropdownMenuItem>
+                  )}
                   {isLive && (
                     <DropdownMenuItem
                       onSelect={(event) => {
@@ -869,94 +852,51 @@ export default function MeetingDetailRoute() {
         )}
       </div>
 
-      <div className="clips-meeting-detail-grid grid grid-cols-1 gap-6 flex-1 min-h-0">
-        {/* Two-tone canvas: user notes (black) + AI summary/bullets (gray) */}
+      <div className="clips-meeting-detail-grid grid grid-cols-1 gap-6 flex-1 min-h-0 lg:overflow-hidden">
+        {/* Summary canvas with generated bullets and action items. */}
         <div
           className={cn(
             "clips-meeting-notes-panel rounded-lg border border-border bg-background min-h-[480px] overflow-hidden flex flex-col",
             notesJustArrived && "animate-in fade-in duration-500",
           )}
         >
-          <Tabs
-            defaultValue="notes"
-            className="flex min-h-0 flex-1 flex-col gap-0"
-          >
-            <div className="flex shrink-0 items-center justify-between gap-2 border-b border-border px-3 py-2">
-              <TabsList className="h-8 gap-1 bg-transparent p-0">
-                <TabsTrigger
-                  value="notes"
-                  className="h-7 px-2.5 text-xs data-[state=active]:bg-muted"
-                >
-                  {t("meetingDetail.myNotes")}
-                </TabsTrigger>
-                <TabsTrigger
-                  value="ai"
-                  className="h-7 gap-1 px-2.5 text-xs data-[state=active]:bg-muted"
-                >
-                  <IconWand className="h-3 w-3" />
-                  {t("meetingDetail.aiNotes")}
-                </TabsTrigger>
-                <TabsTrigger
-                  value="actions"
-                  className="h-7 px-2.5 text-xs data-[state=active]:bg-muted"
-                >
-                  {t("meetingDetail.actionItems")}
-                  {actionItems.length > 0 && (
-                    <span className="ml-1 text-muted-foreground">
-                      {actionItems.length}
-                    </span>
-                  )}
-                </TabsTrigger>
-              </TabsList>
-              {finalize.isPending && (
-                <span className="flex items-center gap-1 text-[10px] text-muted-foreground">
-                  <IconLoader2 className="h-3 w-3 animate-spin" />
-                  {t("meetingDetail.working")}
-                </span>
-              )}
+          <div className="flex shrink-0 items-center justify-between gap-2 border-b border-border px-4 py-2.5">
+            <div className="text-xs font-medium">
+              {t("meetingDetail.summary")}
             </div>
+            {finalize.isPending && (
+              <span className="flex items-center gap-1 text-[10px] text-muted-foreground">
+                <IconLoader2 className="h-3 w-3 animate-spin" />
+                {t("meetingDetail.working")}
+              </span>
+            )}
+          </div>
 
-            <TabsContent
-              value="notes"
-              className="mt-0 min-h-0 flex-1 overflow-y-auto"
-            >
-              <CanvasEditor
-                view="user"
-                userNotesMd={meeting.userNotesMd ?? ""}
-                onUserNotesChange={handleUserNotesChange}
-                readOnly={!canEdit}
-              />
-            </TabsContent>
-
-            <TabsContent
-              value="ai"
-              className="mt-0 min-h-0 flex-1 overflow-y-auto"
-            >
-              <CanvasEditor
-                view="ai"
-                summaryMd={meeting.summaryMd ?? ""}
-                bullets={bullets.map((b) => b.text)}
-                onSummaryChange={handleSummaryChange}
-                readOnly={!canEdit}
-                renderBullet={(b) => (
-                  <BulletLink
-                    bullet={b}
-                    segments={segments}
-                    onJumpTo={handleJumpToSegment}
-                  >
-                    <div className="flex gap-2 text-sm leading-relaxed text-muted-foreground">
-                      <span>•</span>
-                      <span className="flex-1">{b}</span>
-                    </div>
-                  </BulletLink>
-                )}
-              />
-            </TabsContent>
+          <div className="min-h-0 flex-1 overflow-y-auto">
+            <CanvasEditor
+              view="ai"
+              summaryMd={meeting.summaryMd ?? ""}
+              bullets={bullets.map((b) => b.text)}
+              onSummaryChange={handleSummaryChange}
+              readOnly={!canEdit}
+              renderBullet={(b) => (
+                <BulletLink
+                  bullet={b}
+                  segments={segments}
+                  onJumpTo={handleJumpToSegment}
+                >
+                  <div className="flex gap-2 text-sm leading-relaxed text-muted-foreground">
+                    <span>•</span>
+                    <span className="flex-1">{b}</span>
+                  </div>
+                </BulletLink>
+              )}
+            />
 
-            <TabsContent
-              value="actions"
-              className="mt-0 min-h-0 flex-1 overflow-y-auto px-6 py-4"
-            >
+            <div className="max-w-2xl px-6 pb-6">
+              <div className="mb-3 text-xs font-medium">
+                {t("meetingDetail.actionItems")}
+              </div>
               {actionItems.length > 0 ? (
                 <ActionItemsByPerson
                   items={actionItems}
@@ -968,8 +908,8 @@ export default function MeetingDetailRoute() {
                   {t("meetingDetail.noActionItems")}
                 </p>
               )}
-            </TabsContent>
-          </Tabs>
+            </div>
+          </div>
         </div>
 
         {/* Transcript pane — chat-bubble layout */}
@@ -980,13 +920,6 @@ export default function MeetingDetailRoute() {
               {t("meetingDetail.transcript")}
             </div>
             <div className="flex items-center gap-2">
-              {meeting.transcriptStatus === "ready" && (
-                <span className="text-[10px] text-muted-foreground">
-                  {t("meetingDetail.segments", {
-                    count: segments.length,
-                  })}
-                </span>
-              )}
               {segments.length > 0 && (
                 <Tooltip>
                   <TooltipTrigger asChild>

package/corpus/templates/clips/changelog/2026-07-08-hosted-clip-uploads-now-clear-failed-buffered-chunks.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-08
+---
+
+Hosted clip uploads now clear failed buffered chunks and require connected storage before saving thumbnails.

package/corpus/templates/clips/changelog/2026-07-08-hosted-recording-uploads-now-avoid-sql-chunk-storage.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-08
+---
+
+Hosted recording uploads now avoid storing video chunks in SQL and ask users to restart when a resumable storage session is missing.

package/corpus/templates/clips/changelog/2026-07-08-meeting-recaps-now-keep-summaries-action-items-and-transcrip.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-08
+---
+
+Meeting recaps now keep summaries, action items, and transcript controls cleaner on one page.

package/corpus/templates/clips/changelog/2026-07-08-video-playback-controls-now-match-loom-style-5-second-skips-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-08
+---
+
+Video playback controls now match Loom-style 5-second skips and pause from the video surface.

package/corpus/templates/clips/server/lib/recording-upload-state.ts

@@ -1,5 +1,10 @@
 import { getDbExec, isPostgres } from "@agent-native/core/db";
 
+const STALE_CHUNK_PRUNE_LIMIT = 100;
+const STALE_CHUNK_PRUNE_MIN_INTERVAL_MS = 5 * 60 * 1000;
+const DEFAULT_STALE_CHUNK_TTL_MS = 6 * 60 * 60 * 1000;
+const lastPruneByOwner = new Map<string, number>();
+
 function escapeLike(value: string): string {
   return value.replace(/[!%_]/g, (match) => `!${match}`);
 }
@@ -8,6 +13,10 @@ function chunkPrefix(recordingId: string): string {
   return `recording-chunks-${recordingId}-`;
 }
 
+function allChunksPrefix(): string {
+  return "recording-chunks-";
+}
+
 function likePrefix(prefix: string): string {
   return `${escapeLike(prefix)}%`;
 }
@@ -89,6 +98,17 @@ export async function listRecordingChunkKeys(
   return rows.map((row) => String(row.key));
 }
 
+export async function deleteRecordingChunks(
+  ownerEmail: string,
+  recordingId: string,
+): Promise<number> {
+  const result = await getDbExec().execute({
+    sql: `DELETE FROM application_state WHERE session_id = ? AND key LIKE ? ESCAPE '!'`,
+    args: [ownerEmail, likePrefix(chunkPrefix(recordingId))],
+  });
+  return result.rowsAffected ?? 0;
+}
+
 export async function sumRecordingChunkBytes(
   ownerEmail: string,
   recordingId: string,
@@ -102,3 +122,46 @@ export async function sumRecordingChunkBytes(
   });
   return numberFromRowValue(rows[0]?.bytes);
 }
+
+export async function pruneStaleRecordingChunks(
+  ownerEmail: string,
+  options: {
+    now?: number;
+    ttlMs?: number;
+    minIntervalMs?: number;
+  } = {},
+): Promise<number> {
+  const now = options.now ?? Date.now();
+  const minIntervalMs =
+    options.minIntervalMs ?? STALE_CHUNK_PRUNE_MIN_INTERVAL_MS;
+  const lastPrune = lastPruneByOwner.get(ownerEmail) ?? 0;
+  if (minIntervalMs > 0 && now - lastPrune < minIntervalMs) return 0;
+  lastPruneByOwner.set(ownerEmail, now);
+
+  const ttlMs = options.ttlMs ?? DEFAULT_STALE_CHUNK_TTL_MS;
+  const cutoff = new Date(now - ttlMs).toISOString();
+  const createdAtExpression = isPostgres()
+    ? `value::jsonb ->> 'createdAt'`
+    : `json_extract(value, '$.createdAt')`;
+  const { rows } = await getDbExec().execute({
+    sql: `SELECT key FROM application_state WHERE session_id = ? AND key LIKE ? ESCAPE '!' AND ${createdAtExpression} IS NOT NULL AND ${createdAtExpression} < ? LIMIT ?`,
+    args: [
+      ownerEmail,
+      likePrefix(allChunksPrefix()),
+      cutoff,
+      STALE_CHUNK_PRUNE_LIMIT,
+    ],
+  });
+
+  let purged = 0;
+  for (const row of rows) {
+    const key = String(row.key ?? "");
+    if (!key) continue;
+    const result = await getDbExec().execute({
+      sql: `DELETE FROM application_state WHERE session_id = ? AND key = ?`,
+      args: [ownerEmail, key],
+    });
+    purged += result.rowsAffected ?? 0;
+  }
+  return purged;
+}

package/corpus/templates/clips/server/lib/video-storage.ts

@@ -25,6 +25,10 @@ export function requiresConfiguredVideoStorage(): boolean {
   return process.env.NODE_ENV === "production" || !isLikelyLocalDatabase();
 }
 
+export function allowsSqlRecordingChunkScratch(): boolean {
+  return !requiresConfiguredVideoStorage();
+}
+
 interface VideoStorageResolveContext {
   userEmail?: string;
   orgId?: string | null;

package/corpus/templates/clips/server/routes/api/recordings/[recordingId]/thumbnail.post.ts

@@ -28,6 +28,10 @@ import {
   getEventOwnerContext,
   ownerEmailMatches,
 } from "../../../../lib/recordings.js";
+import {
+  requiresConfiguredVideoStorage,
+  STORAGE_SETUP_REQUIRED_REASON,
+} from "../../../../lib/video-storage.js";
 
 const MAX_THUMBNAIL_BYTES = 2 * 1024 * 1024;
 
@@ -154,12 +158,9 @@ export default defineEventHandler(async (event: H3Event) => {
       return { error: "Thumbnail bytes do not match Content-Type" };
     }
 
-    // Try the configured file-upload provider first (Builder.io or a
-    // user-registered one). In dev / solo mode no provider is usually
-    // configured and `uploadFile()` returns `null` — in that case we fall
-    // back to a base64 `data:` URL inline in the `recordings.thumbnail_url`
-    // column. It's not glamorous but it unblocks the library grid
-    // immediately and mirrors what `set-thumbnail` does.
+    // Try the configured file-upload provider first. Hosted/persistent SQL
+    // must not store base64 data URLs in recordings.thumbnail_url; local dev can
+    // still fall back inline to keep the first-frame preview flow lightweight.
     const uploaded = await uploadFile({
       data: bytes,
       mimeType,
@@ -177,15 +178,20 @@ export default defineEventHandler(async (event: H3Event) => {
         bytes: bytes.byteLength,
       });
     } else {
+      if (requiresConfiguredVideoStorage()) {
+        setResponseStatus(event, 409);
+        return {
+          ok: false,
+          error: STORAGE_SETUP_REQUIRED_REASON,
+          storageSetupRequired: true,
+        };
+      }
       const base64 = Buffer.from(bytes).toString("base64");
       url = `data:${mimeType};base64,${base64}`;
-      console.log(
-        "[thumbnail] no provider configured, stored inline data URL",
-        {
-          recordingId,
-          bytes: bytes.byteLength,
-        },
-      );
+      console.log("[thumbnail] local storage fallback stored inline data URL", {
+        recordingId,
+        bytes: bytes.byteLength,
+      });
     }
 
     await db