@agent-native/core 0.77.4 → 0.77.7

package/corpus/templates/clips/app/components/library/recording-card.tsx

@@ -117,13 +117,29 @@ export function RecordingCard({
     return (local || "?").slice(0, 2).toUpperCase();
   }, [recording.ownerEmail]);
 
-  const handleOpen = useCallback(() => {
-    if (selectionMode) {
-      onToggleSelect?.(recording.id);
-    } else {
-      navigate(`/r/${recording.id}`);
-    }
-  }, [navigate, onToggleSelect, recording.id, selectionMode]);
+  const recordingPath = `/r/${recording.id}`;
+
+  const handleOpen = useCallback(
+    (event: React.MouseEvent<HTMLElement>) => {
+      const shouldOpenNewTab =
+        event.button === 1 ||
+        (event.button === 0 && (event.metaKey || event.ctrlKey));
+
+      if (shouldOpenNewTab) {
+        event.preventDefault();
+        event.stopPropagation();
+        window.open(recordingPath, "_blank", "noopener,noreferrer");
+        return;
+      }
+
+      if (selectionMode) {
+        onToggleSelect?.(recording.id);
+      } else {
+        navigate(recordingPath);
+      }
+    },
+    [navigate, onToggleSelect, recording.id, recordingPath, selectionMode],
+  );
 
   const handleCheckbox = useCallback(
     (e: React.MouseEvent) => {
@@ -145,6 +161,7 @@ export function RecordingCard({
     <div
       role="article"
       onClick={handleOpen}
+      onAuxClick={handleOpen}
       onMouseEnter={() => setHovered(true)}
       onMouseLeave={() => setHovered(false)}
       className={cn(

package/corpus/templates/clips/app/i18n/ar-SA.ts

@@ -547,6 +547,20 @@ const messages = {
     languageDescription:
       "اختر لغة الواجهة لهذا الحساب. سيتذكرها Clips عبر أجهزتك.",
     languageLabel: "لغة الواجهة",
+    whatsNew: "ما الجديد",
+    changelogEmpty: "لا توجد تحديثات بعد.",
+    viewAllUpdates: "عرض كل التحديثات",
+    expand: "توسيع",
+    collapse: "طي",
+    changelogMarkdown: `# سجل التغييرات
+
+يتم توثيق كل التغييرات المرئية لمستخدمي Clips هنا. يمكنك فتحه في أي وقت من قائمة الأوامر (Cmd+K -> "ما الجديد") أو من الإعدادات.
+
+## 2026-06-23
+
+### تمت الإضافة
+
+- يمكنك الآن رؤية الجديد مباشرة داخل Clips. أصبح سجل التغييرات متاحًا في قائمة الأوامر (Cmd+K) وفي الإعدادات.`,
     profile: "الملف الشخصي",
     email: "البريد الإلكتروني",
     displayName: "اسم العرض",

package/corpus/templates/clips/app/i18n/de-DE.ts

@@ -569,6 +569,20 @@ const messages = {
     languageDescription:
       "Wähle die Oberflächensprache für dieses Konto. Clips merkt sie sich geräteübergreifend.",
     languageLabel: "Oberflächensprache",
+    whatsNew: "Neuigkeiten",
+    changelogEmpty: "Noch keine Updates.",
+    viewAllUpdates: "Alle Updates anzeigen",
+    expand: "Erweitern",
+    collapse: "Einklappen",
+    changelogMarkdown: `# Änderungsprotokoll
+
+Alle sichtbaren Änderungen für Clips-Nutzer werden hier dokumentiert. Du kannst es jederzeit über das Befehlsmenü (Cmd+K -> "Neuigkeiten") oder über die Einstellungen öffnen.
+
+## 2026-06-23
+
+### Hinzugefügt
+
+- Du kannst Neuigkeiten jetzt direkt in Clips ansehen. Das Änderungsprotokoll ist im Befehlsmenü (Cmd+K) und in den Einstellungen verfügbar.`,
     profile: "Profil",
     email: "E-Mail",
     displayName: "Anzeigename",

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

@@ -547,6 +547,20 @@ const messages = {
     languageDescription:
       "Choose the interface language for this account. Clips remembers it across devices.",
     languageLabel: "Interface language",
+    whatsNew: "What's new",
+    changelogEmpty: "No updates yet.",
+    viewAllUpdates: "View all updates",
+    expand: "Expand",
+    collapse: "Collapse",
+    changelogMarkdown: `# Changelog
+
+All notable user-facing changes to Clips are documented here. Open it any time from the command menu (Cmd+K -> "What's new") or from Settings.
+
+## 2026-06-23
+
+### Added
+
+- See what's new right inside Clips. A changelog now lives in the command menu (Cmd+K) and in Settings.`,
     profile: "Profile",
     email: "Email",
     displayName: "Display name",

package/corpus/templates/clips/app/i18n/es-ES.ts

@@ -562,6 +562,20 @@ const messages = {
     languageDescription:
       "Elige el idioma de la interfaz para esta cuenta. Clips lo recordará en todos tus dispositivos.",
     languageLabel: "Idioma de la interfaz",
+    whatsNew: "Novedades",
+    changelogEmpty: "Aún no hay actualizaciones.",
+    viewAllUpdates: "Ver todas las actualizaciones",
+    expand: "Expandir",
+    collapse: "Contraer",
+    changelogMarkdown: `# Registro de cambios
+
+Todos los cambios visibles para los usuarios de Clips se documentan aquí. Puedes abrirlo en cualquier momento desde el menú de comandos (Cmd+K -> "Novedades") o desde Ajustes.
+
+## 2026-06-23
+
+### Añadido
+
+- Ahora puedes ver las novedades directamente dentro de Clips. El registro de cambios vive en el menú de comandos (Cmd+K) y en Ajustes.`,
     profile: "Perfil",
     email: "Correo electrónico",
     displayName: "Nombre visible",

package/corpus/templates/clips/app/i18n/fr-FR.ts

@@ -562,6 +562,20 @@ const messages = {
     languageDescription:
       "Choisissez la langue de l’interface pour ce compte. Clips s’en souviendra sur tous vos appareils.",
     languageLabel: "Langue de l’interface",
+    whatsNew: "Nouveautés",
+    changelogEmpty: "Aucune mise à jour pour le moment.",
+    viewAllUpdates: "Voir toutes les mises à jour",
+    expand: "Développer",
+    collapse: "Replier",
+    changelogMarkdown: `# Journal des modifications
+
+Tous les changements visibles par les utilisateurs de Clips sont documentés ici. Vous pouvez l’ouvrir à tout moment depuis le menu de commandes (Cmd+K -> "Nouveautés") ou depuis les paramètres.
+
+## 2026-06-23
+
+### Ajouté
+
+- Vous pouvez maintenant voir les nouveautés directement dans Clips. Le journal des modifications est disponible dans le menu de commandes (Cmd+K) et dans les paramètres.`,
     profile: "Profil",
     email: "E-mail",
     displayName: "Nom affiché",

package/corpus/templates/clips/app/i18n/hi-IN.ts

@@ -544,6 +544,20 @@ const messages = {
     languageDescription:
       "इस खाते के लिए इंटरफ़ेस भाषा चुनें। Clips इसे आपके डिवाइसों पर याद रखेगा।",
     languageLabel: "इंटरफ़ेस भाषा",
+    whatsNew: "नया क्या है",
+    changelogEmpty: "अभी कोई अपडेट नहीं है।",
+    viewAllUpdates: "सभी अपडेट देखें",
+    expand: "फैलाएं",
+    collapse: "समेटें",
+    changelogMarkdown: `# बदलाव लॉग
+
+Clips में उपयोगकर्ताओं को दिखने वाले सभी महत्वपूर्ण बदलाव यहां दर्ज किए जाते हैं। आप इसे कमांड मेनू (Cmd+K -> "नया क्या है") या सेटिंग्स से कभी भी खोल सकते हैं।
+
+## 2026-06-23
+
+### जोड़ा गया
+
+- अब आप Clips के अंदर ही नया क्या है देख सकते हैं। बदलाव लॉग अब कमांड मेनू (Cmd+K) और सेटिंग्स में उपलब्ध है।`,
     profile: "प्रोफ़ाइल",
     email: "ईमेल",
     displayName: "दिखने वाला नाम",

package/corpus/templates/clips/app/i18n/ja-JP.ts

@@ -558,6 +558,20 @@ const messages = {
     languageDescription:
       "このアカウントのインターフェイス言語を選択します。Clips はデバイス間で設定を記憶します。",
     languageLabel: "インターフェイス言語",
+    whatsNew: "最新情報",
+    changelogEmpty: "まだ更新はありません。",
+    viewAllUpdates: "すべての更新を見る",
+    expand: "展開",
+    collapse: "折りたたむ",
+    changelogMarkdown: `# 変更履歴
+
+Clips のユーザー向けの主な変更はここに記録されます。コマンドメニュー（Cmd+K -> "最新情報"）または設定からいつでも開けます。
+
+## 2026-06-23
+
+### 追加
+
+- Clips 内で最新情報を直接確認できるようになりました。変更履歴はコマンドメニュー（Cmd+K）と設定にあります。`,
     profile: "プロフィール",
     email: "メール",
     displayName: "表示名",

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

@@ -551,6 +551,20 @@ const messages = {
     languageDescription:
       "이 계정의 인터페이스 언어를 선택하세요. Clips가 여러 기기에서 기억합니다.",
     languageLabel: "인터페이스 언어",
+    whatsNew: "새 소식",
+    changelogEmpty: "아직 업데이트가 없습니다.",
+    viewAllUpdates: "모든 업데이트 보기",
+    expand: "펼치기",
+    collapse: "접기",
+    changelogMarkdown: `# 변경 로그
+
+Clips의 모든 사용자 대상 변경 사항은 여기에 기록됩니다. 명령 메뉴(Cmd+K -> "새 소식") 또는 설정에서 언제든지 열 수 있습니다.
+
+## 2026-06-23
+
+### 추가됨
+
+- 이제 Clips 안에서 바로 새 소식을 볼 수 있습니다. 변경 로그는 명령 메뉴(Cmd+K)와 설정에 있습니다.`,
     profile: "프로필",
     email: "이메일",
     displayName: "표시 이름",

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

@@ -560,6 +560,20 @@ const messages = {
     languageDescription:
       "Escolha o idioma da interface para esta conta. O Clips lembrará em todos os seus dispositivos.",
     languageLabel: "Idioma da interface",
+    whatsNew: "Novidades",
+    changelogEmpty: "Ainda não há atualizações.",
+    viewAllUpdates: "Ver todas as atualizações",
+    expand: "Expandir",
+    collapse: "Recolher",
+    changelogMarkdown: `# Registro de alterações
+
+Todas as mudanças visíveis para usuários do Clips são documentadas aqui. Você pode abrir a qualquer momento pelo menu de comandos (Cmd+K -> "Novidades") ou pelas Configurações.
+
+## 2026-06-23
+
+### Adicionado
+
+- Agora você pode ver as novidades diretamente dentro do Clips. O registro de alterações fica no menu de comandos (Cmd+K) e nas Configurações.`,
     profile: "Perfil",
     email: "E-mail",
     displayName: "Nome de exibição",

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

@@ -526,6 +526,20 @@ const messages = {
     languageDescription:
       "选择此账号的界面语言。Clips 会在不同设备上记住你的选择。",
     languageLabel: "界面语言",
+    whatsNew: "最新变化",
+    changelogEmpty: "暂无更新。",
+    viewAllUpdates: "查看所有更新",
+    expand: "展开",
+    collapse: "收起",
+    changelogMarkdown: `# 更新日志
+
+Clips 中所有面向用户的重要更改都会记录在这里。你可以随时从命令菜单（Cmd+K -> “最新变化”）或设置中打开。
+
+## 2026-06-23
+
+### 新增
+
+- 现在可以直接在 Clips 中查看最新变化。更新日志已加入命令菜单（Cmd+K）和设置。`,
     profile: "个人资料",
     email: "邮箱",
     displayName: "显示名称",

package/corpus/templates/clips/app/lib/browser-diagnostics-capture.ts

@@ -26,8 +26,12 @@ function redactString(value: string): string {
   return redactBrowserDiagnosticString(value);
 }
 
+function redactUrlString(value: string): string {
+  return redactBrowserDiagnosticString(value, { redactQueryValues: true });
+}
+
 function sanitizeUrl(raw: string): string {
-  const redacted = redactString(raw);
+  const redacted = redactUrlString(raw);
   try {
     const parsed = new URL(redacted, window.location.href);
     parsed.username = "";

package/corpus/templates/clips/app/root.tsx

@@ -43,7 +43,6 @@ import {
 import { Toaster } from "@/components/ui/sonner";
 import { useNavigationState } from "@/hooks/use-navigation-state";
 
-import changelog from "../CHANGELOG.md?raw";
 import { i18nCatalog, loadI18nMessages } from "./i18n";
 
 import stylesheet from "./global.css?url";
@@ -349,7 +348,8 @@ function AppContent() {
         <CommandMenu
           open={cmdkOpen}
           onOpenChange={setCmdkOpen}
-          changelog={changelog}
+          changelog={t("settings.changelogMarkdown")}
+          changelogLabel={t("settings.whatsNew")}
           changelogKey="clips"
         >
           <CommandMenu.Group heading={t("root.commandActions")}>

package/corpus/templates/clips/app/routes/_app.extensions.$id.tsx

@@ -1,13 +1,16 @@
+import { useT } from "@agent-native/core/client";
 import { ExtensionViewerPage } from "@agent-native/core/client/extensions";
 
 import { PageHeader } from "@/components/library/page-header";
 
 export default function ExtensionViewerRoute() {
+  const t = useT();
+
   return (
     <>
       <PageHeader>
         <h1 className="text-base font-semibold tracking-tight truncate">
-          Extensions
+          {t("navigation.extensions")}
         </h1>
       </PageHeader>
       <ExtensionViewerPage />

package/corpus/templates/clips/app/routes/_app.extensions._index.tsx

@@ -1,13 +1,16 @@
+import { useT } from "@agent-native/core/client";
 import { ExtensionsListPage } from "@agent-native/core/client/extensions";
 
 import { PageHeader } from "@/components/library/page-header";
 
 export default function ExtensionsRoute() {
+  const t = useT();
+
   return (
     <>
       <PageHeader>
         <h1 className="text-base font-semibold tracking-tight truncate">
-          Extensions
+          {t("navigation.extensions")}
         </h1>
       </PageHeader>
       <ExtensionsListPage />

package/corpus/templates/clips/app/routes/_app.settings._index.tsx

@@ -66,8 +66,6 @@ import { useVideoStorageStatus } from "@/hooks/use-video-storage-status";
 import enMessages from "@/i18n/en-US";
 import { cn } from "@/lib/utils";
 
-import changelog from "../../CHANGELOG.md?raw";
-
 export function meta() {
   return [{ title: enMessages.settings.pageTitle }];
 }
@@ -343,7 +341,12 @@ async function saveRegisteredSecret(key: string, value: string): Promise<void> {
 }
 
 function CompactChangelogAside() {
-  const entries = useMemo(() => parseChangelog(changelog), []);
+  const t = useT();
+  const localizedChangelog = t("settings.changelogMarkdown");
+  const entries = useMemo(
+    () => parseChangelog(localizedChangelog),
+    [localizedChangelog],
+  );
   const [expanded, setExpanded] = useState(false);
 
   if (entries.length === 0) return null;
@@ -361,8 +364,12 @@ function CompactChangelogAside() {
           )}
         >
           <ChangelogSettingsCard
-            markdown={changelog}
+            markdown={localizedChangelog}
             limit={1}
+            title={t("settings.whatsNew")}
+            closeLabel={t("common.cancel")}
+            emptyText={t("settings.changelogEmpty")}
+            viewAllLabel={t("settings.viewAllUpdates")}
             className="rounded-md"
           />
         </div>
@@ -378,7 +385,7 @@ function CompactChangelogAside() {
               className="h-7 px-2 text-xs text-muted-foreground"
               onClick={() => setExpanded((value) => !value)}
             >
-              {expanded ? "Collapse" : "Expand"}
+              {expanded ? t("settings.collapse") : t("settings.expand")}
             </Button>
           </div>
         ) : null}

package/corpus/templates/clips/changelog/2026-06-25-chrome-extension-recordings-now-upload-large-capture-bursts.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-25
+---
+
+Chrome extension recordings now upload large capture bursts reliably and report extension errors to Sentry.

package/corpus/templates/clips/changelog/2026-06-25-console-diagnostics-keep-more-useful-non-secret-details-when.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-06-25
+---
+
+Console diagnostics keep more useful non-secret details when clips are shared with agents.

package/corpus/templates/clips/changelog/2026-06-25-fixed-owner-recognition-so-clips-created-from-desktop-and-we.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-25
+---
+
+Fixed owner recognition so Clips created from desktop and web sessions remain editable by the same signed-in user.

package/corpus/templates/clips/changelog/2026-06-25-localized-clips-settings-changelog-and-extension-sidebar-lab.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-06-25
+---
+
+Localized Clips Settings changelog and extension sidebar labels in every supported interface language.

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

@@ -10,6 +10,9 @@
     "typecheck": "tsgo --noEmit",
     "package": "pnpm build && tsx scripts/package.ts"
   },
+  "dependencies": {
+    "@sentry/browser": "^10.61.0"
+  },
   "devDependencies": {
     "@types/chrome": "^0.2.0",
     "@typescript/native-preview": "catalog:",

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.2",
+  "version": "0.1.3",
   "description": "Start Clips recordings from Chrome with optional redacted console and network diagnostics.",
   "minimum_chrome_version": "116",
   "action": {

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

@@ -1,3 +1,7 @@
+import { captureExtensionError, initExtensionSentry } from "./sentry";
+
+initExtensionSentry("background");
+
 const DEFAULT_CLIPS_BASE_URL = "https://clips.agent-native.com";
 const DEBUGGER_PROTOCOL_VERSION = "1.3";
 const MAX_CONSOLE_LOGS = 400;
@@ -149,6 +153,15 @@ type OffscreenStatusMessage = {
   error?: string;
 };
 
+type ExtensionErrorMessage = {
+  type: "CLIPS_EXTENSION_ERROR";
+  surface?: string;
+  name?: string;
+  message?: string;
+  stack?: string;
+  context?: Record<string, unknown>;
+};
+
 type PendingNetworkRequest = {
   requestId: string;
   timestampMs: number;
@@ -516,19 +529,24 @@ function truncate(value: string, maxLength: number): string {
   return value.length > maxLength ? `${value.slice(0, maxLength)}...` : value;
 }
 
-function redactString(value: string): string {
-  return value
+function redactString(
+  value: string,
+  options: { redactQueryValues?: boolean } = {},
+): string {
+  const redacted = value
     .replace(AUTHORIZATION_SCHEME_RE, "$1$2<redacted>")
     .replace(/\b(bearer|basic)\s+[a-z0-9._~+/-]+=*/gi, "$1 <redacted>")
     .replace(DOUBLE_QUOTED_SECRET_VALUE_RE, '$1$2$1$3"<redacted>"')
     .replace(SINGLE_QUOTED_SECRET_VALUE_RE, "$1$2$1$3'<redacted>'")
-    .replace(UNQUOTED_SECRET_VALUE_RE, "$1$2$1$3<redacted>")
-    .replace(/([?&][^=\s&?#]+)=([^&\s#]+)/g, "$1=<redacted>");
+    .replace(UNQUOTED_SECRET_VALUE_RE, "$1$2$1$3<redacted>");
+  return options.redactQueryValues
+    ? redacted.replace(/([?&][^=\s&?#]+)=([^&\s#]+)/g, "$1=<redacted>")
+    : redacted;
 }
 
 function sanitizeUrl(raw: string | null | undefined): string | null {
   if (!raw) return null;
-  const redacted = redactString(raw);
+  const redacted = redactString(raw, { redactQueryValues: true });
   try {
     const parsed = new URL(redacted);
     parsed.username = "";
@@ -1016,6 +1034,17 @@ async function armRecording(args: {
       visibility: "public",
     });
   } catch (err) {
+    captureExtensionError(err, {
+      tags: {
+        surface: "background",
+        recordingStep: "create-recording",
+      },
+      extra: {
+        captureSurface: settings.captureSurface,
+        includeCamera: settings.includeCamera,
+        includeMicrophone: settings.includeMicrophone,
+      },
+    });
     await abortArming();
     throw err;
   }
@@ -1070,6 +1099,18 @@ async function armRecording(args: {
     });
   } catch (err) {
     console.error("[clips-bg] arm: BEGIN failed", err);
+    captureExtensionError(err, {
+      tags: {
+        surface: "background",
+        recordingStep: "offscreen-begin",
+      },
+      extra: {
+        recordingId: created.id,
+        captureSurface: settings.captureSurface,
+        includeCamera: settings.includeCamera,
+        includeMicrophone: settings.includeMicrophone,
+      },
+    });
     await cancelRecording();
     throw err;
   }
@@ -1553,9 +1594,15 @@ function pushConsole(
   const timestampMs = Number.isFinite(entry.timestampMs)
     ? (entry.timestampMs as number)
     : nowMs();
-  const message = truncate(redactString(entry.message), MAX_MESSAGE_LENGTH);
+  const message = truncate(
+    redactString(entry.message, { redactQueryValues: true }),
+    MAX_MESSAGE_LENGTH,
+  );
   const stack = entry.stack
-    ? truncate(redactString(entry.stack), MAX_MESSAGE_LENGTH)
+    ? truncate(
+        redactString(entry.stack, { redactQueryValues: true }),
+        MAX_MESSAGE_LENGTH,
+      )
     : "";
   session.consoleLogs.push({
     timestampMs,
@@ -1762,7 +1809,10 @@ function handleResponseReceived(
     pending.ok = response.status >= 200 && response.status < 400;
   }
   if (typeof response.statusText === "string") {
-    pending.statusText = truncate(redactString(response.statusText), 120);
+    pending.statusText = truncate(
+      redactString(response.statusText, { redactQueryValues: true }),
+      120,
+    );
   }
 }
 
@@ -1792,7 +1842,12 @@ function finalizeNetworkRequest(
     ...(typeof pending.ok === "boolean" ? { ok: pending.ok } : {}),
     durationMs: Math.round(durationMs),
     ...(error
-      ? { error: truncate(redactString(error), MAX_MESSAGE_LENGTH) }
+      ? {
+          error: truncate(
+            redactString(error, { redactQueryValues: true }),
+            MAX_MESSAGE_LENGTH,
+          ),
+        }
       : {}),
   });
 }
@@ -1923,6 +1978,12 @@ chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => {
         (message as { type?: unknown })?.type,
         err,
       );
+      captureExtensionError(err, {
+        tags: {
+          surface: "background",
+          messageType: String((message as { type?: unknown })?.type ?? ""),
+        },
+      });
       response = {
         ok: false,
         error: err instanceof Error ? err.message : "Could not use Clips.",
@@ -1940,6 +2001,21 @@ chrome.runtime.onMessage.addListener((message, _sender, sendResponse) => {
 async function dispatchRuntimeMessage(message: unknown): Promise<unknown> {
   const type = (message as { type?: unknown }).type;
 
+  if (type === "CLIPS_EXTENSION_ERROR") {
+    const report = message as ExtensionErrorMessage;
+    const error = new Error(report.message || "Chrome extension error");
+    error.name = report.name || "ExtensionError";
+    if (report.stack) error.stack = report.stack;
+    captureExtensionError(error, {
+      tags: {
+        surface: report.surface || "content-script",
+        mechanism: "content-script-report",
+      },
+      extra: report.context,
+    });
+    return { ok: true };
+  }
+
   // Status updates streamed from the offscreen recorder.
   if (type === "CLIPS_NATIVE_STATUS") {
     const status = message as OffscreenStatusMessage;

package/corpus/templates/clips/chrome-extension/src/content-script.ts

@@ -18,6 +18,61 @@
   const ALL_PARTS: OverlayPart[] = ["bubble", "countdown", "toolbar", "saving"];
   const flags = window as unknown as { __clipsOverlayHostReady?: boolean };
 
+  function errorPayload(error: unknown): {
+    name: string;
+    message: string;
+    stack?: string;
+  } {
+    if (error instanceof Error) {
+      return {
+        name: error.name || "Error",
+        message: error.message || "Unknown content-script error",
+        stack: error.stack,
+      };
+    }
+    return {
+      name: "Error",
+      message: String(error ?? "Unknown content-script error"),
+    };
+  }
+
+  function reportContentScriptError(
+    error: unknown,
+    context: Record<string, unknown> = {},
+  ): void {
+    try {
+      chrome.runtime.sendMessage(
+        {
+          type: "CLIPS_EXTENSION_ERROR",
+          surface: "content-script",
+          ...errorPayload(error),
+          context: {
+            ...context,
+            pageUrl: location.href,
+          },
+        },
+        () => void chrome.runtime.lastError,
+      );
+    } catch {
+      /* background unavailable */
+    }
+  }
+
+  window.addEventListener("error", (event) => {
+    reportContentScriptError(event.error || event.message, {
+      mechanism: "global-error",
+      filename: event.filename,
+      lineno: event.lineno,
+      colno: event.colno,
+    });
+  });
+
+  window.addEventListener("unhandledrejection", (event) => {
+    reportContentScriptError(event.reason, {
+      mechanism: "unhandled-rejection",
+    });
+  });
+
   // ----- Draggable, resizable camera bubble ---------------------------------
   // Size + position persist in storage so the bubble stays where the user put it
   // across pages and recordings (like the desktop app). The iframe can't move or