@agent-native/core 0.79.7 → 0.79.9

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

@@ -146,7 +146,7 @@ const messages = {
     savingWentWrong: "保存此剪辑时出现问题。",
     finishingClip: "正在完成您的剪辑...",
     loomSourcePreserved:
-      "Loom 源链接被保留。连接 Builder.io 或 S3 存储，Clips 将重试保存其自己的副本。",
+      "Loom 源链接被保留。连接存储：Builder.io（免费套餐存储 + AI）或 S3 兼容存储，Clips 将重试保存自己的副本。",
     clipDataPreserved:
       "Your clip data is still preserved.连接Builder.io或S3存储，Clips将自动上传。",
     details: "细节",
@@ -223,12 +223,13 @@ const messages = {
     savingWentWrong: "保存此剪辑时出现问题。",
     finishingClip: "完成这个剪辑...",
     loomPreservedManage:
-      "Loom 源链接被保留。连接 Builder.io 或 S3 存储，然后重试导入。",
+      "Loom 源链接被保留。连接存储：Builder.io（免费套餐存储 + AI）或 S3 兼容存储，然后重试导入。",
     videoPreservedManage:
       "视频被保留。连接Builder.io或S3存储，Clips将完成上传。",
-    creatorNeedsStorage: "创建者需要连接 Builder.io 或 S3 存储才能完成此剪辑。",
+    creatorNeedsStorage:
+      "创建者需要先连接存储才能完成此剪辑：Builder.io（免费套餐存储 + AI）或 S3 兼容存储。",
     signInStorage:
-      "如果这是您的剪辑，请在此处登录以连接 Builder.io 或 S3 存储并完成上传。",
+      "如果这是您的剪辑，请在此处登录以连接存储：Builder.io（免费套餐存储 + AI）或 S3 兼容存储，并完成上传。",
     uploadNotCompleteSession:
       "上传尚未完成。打开此剪辑的仪表板或要求创建者检查存储空间。",
     uploadNotCompleteSignIn:
@@ -330,7 +331,8 @@ const messages = {
     cleanupKept: "清理工作无法完成。保留了本机转录本。",
     cleanupBuilderFailed:
       "即使 Builder.io 已连接，清理也无法完成。保留了本机转录本。",
-    cleanupPaused: "清理已暂停。在“设置”中连接 Builder.io 即可启用它。",
+    cleanupPaused:
+      "清理已暂停。请在“设置”中连接 AI：Builder.io（免费额度）或你自己的 LLM 密钥。",
     builderNoResponse: "没有收到Builder的回复。允许弹出窗口并重试。",
     saveFailed: "保存失败（{{status}}）",
     savedRetrying: "已保存。正在重试转录...",
@@ -562,7 +564,7 @@ Clips 中所有面向用户的重要更改都会记录在这里。你可以随
       "Builder.io 是 Clips 上传的主要存储路径。需要自带存储桶时，也可以使用 S3。",
     checkingBuilder: "正在检查 Builder.io",
     builderConnected: "Builder.io 已连接",
-    connectBuilder: "连接 Builder.io",
+    connectBuilder: "使用 Builder.io（免费）",
     builderConnectedFor: "正在为 {{orgName}} 使用 Builder.io。",
     builderConnectedGeneric: "新的剪辑会使用已连接的 Builder.io 提供方。",
     builderIncludes: "包含对象存储、上传，以及新剪辑的托管转录。",
@@ -586,12 +588,11 @@ Clips 中所有面向用户的重要更改都会记录在这里。你可以随
     s3RegionLabel: "区域",
     s3PublicBaseUrlLabel: "公共基础 URL",
     apiSetup: "AI 设置",
-    apiSetupDescription:
-      "Builder.io 是托管 AI 额度的默认路径。也可以在这里添加可选的提供方密钥。",
-    builderEasySetup: "Builder.io 是最简单的设置方式",
+    apiSetupDescription: "使用 Builder.io 免费额度或你自己的 LLM 密钥连接 AI。",
+    builderEasySetup: "Builder.io 免费额度",
     builderAiAvailable: "Clips 可使用包含的 AI 额度和托管转录。",
     builderAiDescription:
-      "先连接 Builder，即可使用包含的 AI 额度、对象存储、上传和托管转录。",
+      "优先使用 Builder.io，可获得内置 AI 额度、对象存储、上传和托管转录。",
     providerKeyTitle: "使用自己的提供方密钥",
     providerKeyDescription:
       "添加 Anthropic、OpenAI、Gemini、Groq 或 OpenRouter 密钥，用于按提供方计费的使用。",
@@ -730,7 +731,8 @@ Clips 中所有面向用户的重要更改都会记录在这里。你可以随
     title: "拼接录制",
     pickAtLeastTwo: "请选择至少 2 个录制进行拼接",
     videoUrlMissing: "一个或多个录制还没有可用的视频 URL",
-    connectStorage: "拼接录制前请连接 Builder.io 或 S3 兼容存储。",
+    connectStorage:
+      "拼接录制前请连接存储：Builder.io（免费套餐存储 + AI）或 S3 兼容存储。",
     created: "拼接录制已创建",
     failed: "拼接录制失败",
     noOtherRecordings: "没有其他可用录制。",
@@ -954,9 +956,12 @@ Clips 中所有面向用户的重要更改都会记录在这里。你可以随
     builderTimeout: "5 分钟内未收到 Builder 响应。请检查弹出窗口并重试。",
     builderConnected: "Builder.io 已连接",
     waitingForBuilder: "正在等待 Builder...",
-    connectBuilder: "连接 Builder.io",
+    connectBuilder: "使用 Builder.io（免费）",
     free: "免费",
     configureS3: "配置 S3 兼容存储",
+    whyPrompt: "为什么会看到这个？",
+    whyDescription:
+      "Clips 是 100% 免费且开源的应用，所以你需要连接一种方式来存储剪辑。使用 Builder.io 可获得免费套餐存储和 AI，或使用 S3 兼容对象存储和你自己的 LLM 密钥。",
   },
   captureInstall: {
     title: "Choose your recorder (已本地化)",
@@ -1159,9 +1164,9 @@ Clips 中所有面向用户的重要更改都会记录在这里。你可以随
     downloadRecording: "Download recording (已本地化)",
     openRecorderInTab: "Open recorder in tab (已本地化)",
     connectStorageToFinish:
-      "Connect Builder.io or S3 storage on the next screen and Clips will finish saving it. (已本地化)",
+      "在下一屏连接存储：Builder.io（免费套餐存储 + AI）或 S3 兼容存储。Clips 将完成保存。",
     connectStorageToRetryLoom:
-      "Connect Builder.io or S3 storage on the next screen and Clips will retry the import. (已本地化)",
+      "在下一屏连接存储：Builder.io（免费套餐存储 + AI）或 S3 兼容存储。Clips 将重试导入。",
   },
   dictateRoute: {
     pageTitle: "Dictate · Clips (已本地化)",

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

@@ -146,7 +146,7 @@ const messages = {
     savingWentWrong: "儲存此剪輯時出現問題。",
     finishingClip: "正在完成您的剪輯...",
     loomSourcePreserved:
-      "Loom 來源連結被保留。連線 Builder.io 或 S3 存儲，Clips 將重試儲存其自己的副本。",
+      "Loom 來源連結被保留。連接儲存：Builder.io（免費方案儲存 + AI）或 S3 相容儲存，Clips 將重試儲存自己的副本。",
     clipDataPreserved:
       "Your clip data is still preserved.連線Builder.io或S3存儲，Clips將自動上傳。",
     details: "細節",
@@ -223,12 +223,13 @@ const messages = {
     savingWentWrong: "儲存此剪輯時出現問題。",
     finishingClip: "完成這個剪輯...",
     loomPreservedManage:
-      "Loom 來源連結被保留。連線 Builder.io 或 S3 存儲，然後重試匯入。",
+      "Loom 來源連結被保留。連接儲存：Builder.io（免費方案儲存 + AI）或 S3 相容儲存，然後重試匯入。",
     videoPreservedManage:
       "影片被保留。連線Builder.io或S3存儲，Clips將完成上傳。",
-    creatorNeedsStorage: "建立者需要連線 Builder.io 或 S3 存儲才能完成此剪輯。",
+    creatorNeedsStorage:
+      "建立者需要先連接儲存才能完成此剪輯：Builder.io（免費方案儲存 + AI）或 S3 相容儲存。",
     signInStorage:
-      "如果這是您的剪輯，請在此處登入以連線 Builder.io 或 S3 存儲並完成上傳。",
+      "如果這是您的剪輯，請在此處登入以連接儲存：Builder.io（免費方案儲存 + AI）或 S3 相容儲存，並完成上傳。",
     uploadNotCompleteSession:
       "上傳尚未完成。開啟此剪輯的儀表板或要求建立者檢查存儲空間。",
     uploadNotCompleteSignIn:
@@ -330,7 +331,8 @@ const messages = {
     cleanupKept: "清理工作無法完成。保留了本機轉錄本。",
     cleanupBuilderFailed:
       "即使 Builder.io 已連線，清理也無法完成。保留了本機轉錄本。",
-    cleanupPaused: "清理已暫停。在“設定”中連線 Builder.io 即可啟用它。",
+    cleanupPaused:
+      "清理已暫停。請在「設定」中連接 AI：Builder.io（免費額度）或你自己的 LLM 金鑰。",
     builderNoResponse: "沒有收到Builder的回複。允許快顯窗口並重試。",
     saveFailed: "儲存失敗（{{status}}）",
     savedRetrying: "已儲存。正在重試轉錄...",
@@ -555,7 +557,7 @@ const messages = {
       "Builder.io 是 Clips 上傳的主要存儲路徑。需要自帶存儲桶時，也可以使用 S3。",
     checkingBuilder: "正在檢查 Builder.io",
     builderConnected: "Builder.io 已連線",
-    connectBuilder: "連線 Builder.io",
+    connectBuilder: "使用 Builder.io（免費）",
     builderConnectedFor: "正在為 {{orgName}} 使用 Builder.io。",
     builderConnectedGeneric: "新的剪輯會使用已連線的 Builder.io 提供方。",
     builderIncludes: "包含物件存儲、上傳，以及新剪輯的託管轉錄。",
@@ -579,12 +581,11 @@ const messages = {
     s3RegionLabel: "區域",
     s3PublicBaseUrlLabel: "公開基礎 URL",
     apiSetup: "AI 設定",
-    apiSetupDescription:
-      "Builder.io 是託管 AI 額度的預設路徑。也可以在這裡新增可選的提供方金鑰。",
-    builderEasySetup: "Builder.io 是最簡單的設定方式",
+    apiSetupDescription: "使用 Builder.io 免費額度或你自己的 LLM 金鑰連接 AI。",
+    builderEasySetup: "Builder.io 免費額度",
     builderAiAvailable: "Clips 可使用包含的 AI 額度和託管轉錄。",
     builderAiDescription:
-      "先連線 Builder，即可使用包含的 AI 額度、物件存儲、上傳和託管轉錄。",
+      "優先使用 Builder.io，可獲得內建 AI 額度、物件儲存、上傳和託管轉錄。",
     providerKeyTitle: "使用自己的提供方金鑰",
     providerKeyDescription:
       "新增 Anthropic、OpenAI、Gemini、Groq 或 OpenRouter 金鑰，用於按提供方計費的使用。",
@@ -723,7 +724,8 @@ const messages = {
     title: "拼接錄製",
     pickAtLeastTwo: "請選取至少 2 個錄製進行拼接",
     videoUrlMissing: "一個或多個錄製還沒有可用的影片 URL",
-    connectStorage: "拼接錄製前請連線 Builder.io 或 S3 兼容存儲。",
+    connectStorage:
+      "拼接錄製前請連接儲存：Builder.io（免費方案儲存 + AI）或 S3 相容儲存。",
     created: "拼接錄製已建立",
     failed: "拼接錄製失敗",
     noOtherRecordings: "沒有其他可用錄製。",
@@ -947,9 +949,12 @@ const messages = {
     builderTimeout: "5 分鐘內未收到 Builder 回應。請檢查快顯窗口並重試。",
     builderConnected: "Builder.io 已連線",
     waitingForBuilder: "正在等待 Builder...",
-    connectBuilder: "連線 Builder.io",
+    connectBuilder: "使用 Builder.io（免費）",
     free: "免費",
     configureS3: "設定 S3 兼容存儲",
+    whyPrompt: "為什麼我會看到這個？",
+    whyDescription:
+      "Clips 是 100% 免費且開源的，因此你需要連接一種儲存 clips 的方式。使用 Builder.io 可取得免費方案儲存和 AI，或使用 S3 相容物件儲存和你自己的 LLM 金鑰。",
   },
   captureInstall: {
     title: "Choose your recorder (已本機化)",
@@ -1152,9 +1157,9 @@ const messages = {
     downloadRecording: "Download recording (已本機化)",
     openRecorderInTab: "Open recorder in tab (已本機化)",
     connectStorageToFinish:
-      "Connect Builder.io or S3 storage on the next screen and Clips will finish saving it. (已本機化)",
+      "在下一屏連接儲存：Builder.io（免費方案儲存 + AI）或 S3 相容儲存。Clips 將完成儲存。",
     connectStorageToRetryLoom:
-      "Connect Builder.io or S3 storage on the next screen and Clips will retry the import. (已本機化)",
+      "在下一屏連接儲存：Builder.io（免費方案儲存 + AI）或 S3 相容儲存。Clips 將重試匯入。",
   },
   dictateRoute: {
     pageTitle: "Dictate · Clips (已本機化)",

package/corpus/templates/clips/app/routes/r.$recordingId.tsx

@@ -114,6 +114,13 @@ function failureDetail(reason: string | null | undefined): string | null {
 
 function nativeSaveFailureMessage(reason: string | null | undefined): string {
   const text = reason ?? "";
+  if (
+    /finalization callback failed|missing required metadata|missing playback metadata|corrupted or incomplete|missing moov/i.test(
+      text,
+    )
+  ) {
+    return "macOS could not finish writing this desktop recording. The local file is incomplete, so discard it from the Clips menu and record again.";
+  }
   if (/too large|compression/i.test(text)) {
     return "Clips tried to compress this desktop recording, but it is still too large to upload. The original is saved locally and can be retried from the Clips menu.";
   }

package/corpus/templates/clips/app/routes/record.tsx

@@ -1119,7 +1119,7 @@ export default function RecordRoute() {
         markStorageConfigured(status);
         if (!status.configured) {
           throw new Error(
-            "No video storage configured. Open Settings to connect Builder.io or S3-compatible storage.",
+            "No video storage configured. Connect storage: Builder.io (free tier storage + AI) or S3-compatible storage.",
           );
         }
 
@@ -1329,7 +1329,7 @@ export default function RecordRoute() {
         markStorageConfigured(status);
         if (!status.configured) {
           throw new Error(
-            "No video storage configured. Open Settings to connect Builder.io or S3-compatible storage.",
+            "No video storage configured. Connect storage: Builder.io (free tier storage + AI) or S3-compatible storage.",
           );
         }
 

package/corpus/templates/clips/changelog/2026-06-26-desktop-recordings-recover-more-reliably-when-macos-reports-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-26
+---
+
+Desktop recordings recover more reliably when macOS reports a finalization error.

package/corpus/templates/clips/changelog/2026-06-26-slack-unfurls-now-recognize-recording-dashboard-links-pasted.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-26
+---
+
+Slack unfurls now recognize recording dashboard links pasted from Clips.

package/corpus/templates/clips/changelog/2026-06-26-storage-setup-now-explains-why-clips-needs-connected-storage.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-26
+---
+
+Storage setup now explains why Clips needs connected storage and guides saved desktop or Chrome uploads back to Builder.io.

package/corpus/templates/clips/chrome-extension/public/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": 3,
   "name": "Agent-Native Clips",
   "short_name": "Clips",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Start Clips recordings from Chrome, capture optional diagnostics, and preview Clips links on GitHub.",
   "minimum_chrome_version": "116",
   "action": {

package/corpus/templates/clips/chrome-extension/src/background.ts

@@ -8,6 +8,10 @@ const MAX_CONSOLE_LOGS = 400;
 const MAX_NETWORK_REQUESTS = 400;
 const MAX_MESSAGE_LENGTH = 2_000;
 const MAX_URL_LENGTH = 1_000;
+const STORAGE_SETUP_REQUIRED_MESSAGE =
+  "Connect storage to finish saving this clip: Builder.io (free tier storage + AI) or S3-compatible storage.";
+const STORAGE_SETUP_FAILURE_RE =
+  /video storage is not connected|no video storage configured|file upload provider|storage provider|connect builder|s3-compatible/i;
 const SECRET_KEY_FRAGMENT =
   "(?:authorization|cookie|set[-_]?cookie|token|secret|password|passwd|pwd|api[-_]?key|apikey|session|credential)";
 const AUTHORIZATION_SCHEME_RE =
@@ -151,6 +155,7 @@ type OffscreenStatusMessage = {
   recordingId?: string;
   result?: Record<string, unknown>;
   error?: string;
+  storageSetupRequired?: boolean;
 };
 
 type ExtensionErrorMessage = {
@@ -162,6 +167,16 @@ type ExtensionErrorMessage = {
   context?: Record<string, unknown>;
 };
 
+function isStorageSetupFailureMessage(message: string | null | undefined) {
+  return STORAGE_SETUP_FAILURE_RE.test(message ?? "");
+}
+
+function friendlyRecordingError(message: string | null | undefined): string {
+  return isStorageSetupFailureMessage(message)
+    ? STORAGE_SETUP_REQUIRED_MESSAGE
+    : message || "Could not stop recording.";
+}
+
 type PendingNetworkRequest = {
   requestId: string;
   timestampMs: number;
@@ -1369,8 +1384,9 @@ async function stopRecording() {
     };
   } catch (err) {
     recording.status = "error";
-    recording.error =
-      err instanceof Error ? err.message : "Could not stop recording.";
+    recording.error = friendlyRecordingError(
+      err instanceof Error ? err.message : null,
+    );
     resetOverlay();
     await broadcastUnmount();
     broadcastOverlayState();
@@ -2032,7 +2048,12 @@ async function dispatchRuntimeMessage(message: unknown): Promise<unknown> {
     ) {
       activeNativeRecording.status = status.status;
       activeNativeRecording.error =
-        typeof status.error === "string" ? status.error : null;
+        typeof status.error === "string"
+          ? status.storageSetupRequired === true ||
+            isStorageSetupFailureMessage(status.error)
+            ? STORAGE_SETUP_REQUIRED_MESSAGE
+            : status.error
+          : null;
       if (typeof status.recordingId === "string") {
         activeNativeRecording.recordingId = status.recordingId;
         activeNativeRecording.recordingUrl = recordingUrl(

package/corpus/templates/clips/chrome-extension/src/offscreen.ts

@@ -23,6 +23,15 @@ import { captureExtensionError, initExtensionSentry } from "./sentry";
 
 initExtensionSentry("offscreen");
 
+const STORAGE_SETUP_REQUIRED_MESSAGE =
+  "Connect storage to finish saving this clip: Builder.io (free tier storage + AI) or S3-compatible storage.";
+const STORAGE_SETUP_FAILURE_RE =
+  /video storage is not connected|no video storage configured|file upload provider|storage provider|connect builder|s3-compatible/i;
+
+function isStorageSetupFailureMessage(message: string | null | undefined) {
+  return STORAGE_SETUP_FAILURE_RE.test(message ?? "");
+}
+
 type CaptureMode = "screen" | "camera";
 
 type AcquireMessage = {
@@ -396,7 +405,14 @@ async function uploadChunk(
     body,
   });
   const text = await res.text().catch(() => "");
-  const data = text ? (JSON.parse(text) as UploadResult) : {};
+  let data: UploadResult = {};
+  if (text) {
+    try {
+      data = JSON.parse(text) as UploadResult;
+    } catch {
+      data = {};
+    }
+  }
   if (!res.ok) {
     console.error(
       "[clips-offscreen] chunk upload failed",
@@ -405,9 +421,17 @@ async function uploadChunk(
       Boolean(recording.authToken),
       text.slice(0, 200),
     );
+    const storageSetupRequired =
+      data?.storageSetupRequired === true ||
+      isStorageSetupFailureMessage(data?.error || text);
     const error = new Error(
-      data?.error || `Upload failed (${res.status}): ${text || res.statusText}`,
+      storageSetupRequired
+        ? STORAGE_SETUP_REQUIRED_MESSAGE
+        : data?.error ||
+            `Upload failed (${res.status}): ${text || res.statusText}`,
     );
+    (error as { storageSetupRequired?: boolean }).storageSetupRequired =
+      storageSetupRequired;
     captureExtensionError(error, {
       tags: {
         surface: "offscreen",
@@ -845,6 +869,8 @@ async function finalizeStop(recording: ActiveRecording): Promise<void> {
     reportStatus(recording.sessionId, "error", {
       recordingId: recording.recordingId,
       error: error.message,
+      storageSetupRequired: (error as { storageSetupRequired?: boolean })
+        .storageSetupRequired,
     });
     recording.rejectStopped(error);
   }

package/corpus/templates/clips/chrome-extension/src/popup.html

@@ -405,6 +405,22 @@
 
       <span id="status" class="status" role="status" aria-live="polite"></span>
 
+      <div id="storage-help" class="storage-help" hidden>
+        <button id="storage-help-open" class="storage-help-open" type="button">
+          Use Builder.io (free)
+        </button>
+        <span aria-hidden="true">·</span>
+        <span class="storage-help-why" tabindex="0">
+          Why am I seeing this?
+          <span class="storage-help-details" role="tooltip">
+            Clips is 100% free and open source, so you need to hook up a way to
+            store your clips. Connect storage with Builder.io for free-tier
+            storage and AI, or use S3-compatible object storage and your own LLM
+            keys.
+          </span>
+        </span>
+      </div>
+
       <nav class="bottom-row" aria-label="Clips shortcuts">
         <button id="open-library" class="bottom-button" type="button">
           <svg viewBox="0 0 24 24" fill="none" aria-hidden="true">

package/corpus/templates/clips/chrome-extension/src/popup.ts

@@ -93,9 +93,17 @@ const FEEDBACK_URL =
 const FEEDBACK_PLACEHOLDER = "Tell us what's on your mind...";
 const FEEDBACK_SUBMIT_TEXT = "Send feedback";
 const FEEDBACK_SUCCESS_MESSAGE = "Thanks for the feedback!";
+const STORAGE_SETUP_REQUIRED_MESSAGE =
+  "Connect storage to finish saving this clip: Builder.io (free tier storage + AI) or S3-compatible storage.";
+const STORAGE_SETUP_FAILURE_RE =
+  /video storage is not connected|no video storage configured|file upload provider|storage provider|connect builder|s3-compatible/i;
 const feedbackTarget = parseFeedbackTarget(FEEDBACK_URL);
 const feedbackSchemaCache = new Map<string, Promise<FeedbackFormSchema>>();
 
+function isStorageSetupFailureMessage(message: string | null | undefined) {
+  return STORAGE_SETUP_FAILURE_RE.test(message ?? "");
+}
+
 function screenSurface(
   value: CaptureSurface,
 ): Exclude<CaptureSurface, "camera"> {
@@ -507,6 +515,14 @@ function setStatus(message: string, kind: "info" | "error" = "info"): void {
   status.dataset.kind = kind;
 }
 
+function setStorageHelp(visible: boolean): void {
+  byId<HTMLDivElement>("storage-help").hidden = !visible;
+}
+
+function storageSetupUrl(settings: ExtensionSettings): string {
+  return `${settings.clipsBaseUrl.replace(/\/+$/, "")}/record`;
+}
+
 function renderMode(settings: ExtensionSettings): void {
   const mode = recordingMode(settings);
   for (const button of document.querySelectorAll<HTMLButtonElement>(
@@ -690,7 +706,10 @@ function renderActiveRecording(recording: NativeRecording | null): void {
   start.hidden = active;
   signIn.hidden = true;
   if (recordingActions) recordingActions.hidden = !active;
-  if (!recording) return;
+  if (!recording) {
+    setStorageHelp(false);
+    return;
+  }
 
   recordingTitle.textContent = recording.targetTitle || "Current recording";
   const host = hostnameLabel(recording.targetUrl);
@@ -706,10 +725,16 @@ function renderActiveRecording(recording: NativeRecording | null): void {
       : recording.status === "stopping"
         ? "Stopping..."
         : recording.status === "error"
-          ? recording.error || "Recording needs attention"
+          ? isStorageSetupFailureMessage(recording.error)
+            ? STORAGE_SETUP_REQUIRED_MESSAGE
+            : recording.error || "Recording needs attention"
           : `Recording ${formatDuration(recording.startedAtMs)}`;
   recordingStatus.dataset.kind =
     recording.status === "error" ? "error" : "info";
+  setStorageHelp(
+    recording.status === "error" &&
+      isStorageSetupFailureMessage(recording.error),
+  );
 }
 
 async function init(): Promise<void> {
@@ -751,6 +776,7 @@ async function init(): Promise<void> {
   const openSettings = byId<HTMLButtonElement>("open-settings");
   const openRecent = byId<HTMLButtonElement>("open-recent");
   const signIn = byId<HTMLButtonElement>("sign-in");
+  const storageHelpOpen = byId<HTMLButtonElement>("storage-help-open");
   let activeRecording: NativeRecording | null = null;
   let authStatus: AuthStatus = "checking";
   let feedbackOpenedAt = 0;
@@ -1071,6 +1097,7 @@ async function init(): Promise<void> {
   start.addEventListener("click", async () => {
     start.disabled = true;
     signIn.hidden = true;
+    setStorageHelp(false);
     setStatus(""); // no chatty "Checking…/Starting…" text — the disabled button is enough
     try {
       authStatus = await readAuthStatus(settings);
@@ -1085,10 +1112,11 @@ async function init(): Promise<void> {
       if (!storageConfigured) {
         start.disabled = false;
         setStatus(
-          "Connect Builder.io or S3 storage in Clips, then start recording.",
+          "Connect storage in Clips first: Builder.io (free tier storage + AI) or S3-compatible storage.",
           "error",
         );
-        await createTab(`${settings.clipsBaseUrl.replace(/\/+$/, "")}/record`);
+        setStorageHelp(true);
+        await createTab(storageSetupUrl(settings));
         window.close();
         return;
       }
@@ -1117,7 +1145,14 @@ async function init(): Promise<void> {
         setStatus("");
         return;
       }
-      setStatus(message, "error");
+      const storageSetupFailure = isStorageSetupFailureMessage(message);
+      setStorageHelp(storageSetupFailure);
+      setStatus(
+        storageSetupFailure
+          ? "Connect storage in Clips first: Builder.io (free tier storage + AI) or S3-compatible storage."
+          : message,
+        "error",
+      );
     } catch (err) {
       captureExtensionError(err, {
         tags: { surface: "popup", action: "start-recording" },
@@ -1128,13 +1163,24 @@ async function init(): Promise<void> {
         },
       });
       start.disabled = false;
+      const message =
+        err instanceof Error ? err.message : "Could not start Clips.";
+      const storageSetupFailure = isStorageSetupFailureMessage(message);
+      setStorageHelp(storageSetupFailure);
       setStatus(
-        err instanceof Error ? err.message : "Could not start Clips.",
+        storageSetupFailure
+          ? "Connect storage in Clips first: Builder.io (free tier storage + AI) or S3-compatible storage."
+          : message,
         "error",
       );
     }
   });
 
+  storageHelpOpen.addEventListener("click", async () => {
+    await createTab(storageSetupUrl(settings));
+    window.close();
+  });
+
   signIn.addEventListener("click", async () => {
     signIn.disabled = true;
     const response = await sendRuntimeMessage<PopupStartResponse>({
@@ -1161,7 +1207,13 @@ async function init(): Promise<void> {
     }
     stop.disabled = false;
     discard.disabled = false;
-    setStatus(response.error || "Could not stop recording.", "error");
+    const message = response.error || "Could not stop recording.";
+    const storageSetupFailure = isStorageSetupFailureMessage(message);
+    setStorageHelp(storageSetupFailure);
+    setStatus(
+      storageSetupFailure ? STORAGE_SETUP_REQUIRED_MESSAGE : message,
+      "error",
+    );
   });
 
   discard.addEventListener("click", async () => {

package/corpus/templates/clips/chrome-extension/src/sentry.ts

@@ -67,6 +67,31 @@ function scrubEvent<T extends Sentry.Event>(event: T): T {
   return event;
 }
 
+function shouldDropExpectedMediaPermissionError(
+  error: unknown,
+  context: CaptureContext,
+): boolean {
+  const tags = context.tags ?? {};
+  const isPermissionProbe =
+    tags.surface === "permission" &&
+    (tags.permission === "mic" || tags.permission === "cam");
+  const isOptionalBubbleCamera =
+    tags.surface === "overlay" && tags.overlayPart === "bubble";
+  if (!isPermissionProbe && !isOptionalBubbleCamera) return false;
+
+  const text =
+    error instanceof Error
+      ? `${error.name}: ${error.message}`
+      : String(error ?? "");
+
+  return (
+    /\bNotAllowedError\b/i.test(text) ||
+    /\bPermission (?:denied|dismissed)\b/i.test(text) ||
+    /\b(?:NotFoundError|DevicesNotFoundError)\b/i.test(text) ||
+    /\bRequested device not found\b/i.test(text)
+  );
+}
+
 function scrubScopeString(value: string): string {
   const scrubbed = scrubUrl(value, { redactAllQueryValues: true });
   if (scrubbed !== value) return scrubbed;
@@ -175,7 +200,9 @@ export function captureExtensionError(
   error: unknown,
   context: CaptureContext = {},
 ): string | undefined {
-  if (!initialized) return undefined;
+  if (!initialized || shouldDropExpectedMediaPermissionError(error, context)) {
+    return undefined;
+  }
   try {
     return Sentry.withScope((scope) => {
       if (context.tags) {