@agent-native/core 0.100.2 → 0.101.3

package/corpus/templates/clips/app/components/player/share-dialog.tsx

@@ -7,7 +7,6 @@ import {
 } from "@agent-native/core/client";
 import {
   IconCode,
-  IconChevronDown,
   IconExternalLink,
   IconLink,
   IconMail,
@@ -33,13 +32,7 @@ import {
   type SharesResponse,
   type Visibility,
 } from "@/components/sharing/share-ui";
-import { SlackShareHint } from "@/components/sharing/slack-share-hint";
 import { Button } from "@/components/ui/button";
-import {
-  Collapsible,
-  CollapsibleContent,
-  CollapsibleTrigger,
-} from "@/components/ui/collapsible";
 import { Dialog, DialogContent, DialogTitle } from "@/components/ui/dialog";
 import { Input } from "@/components/ui/input";
 import { Label } from "@/components/ui/label";
@@ -317,7 +310,6 @@ function LinkTab({
   const agentLinkRequestIdRef = useRef(0);
   const [agentContextUrl, setAgentContextUrl] = useState("");
   const [agentLinkError, setAgentLinkError] = useState(false);
-  const [agentShareOpen, setAgentShareOpen] = useState(false);
 
   useEffect(() => {
     createAgentLinkAsyncRef.current = createAgentLink.mutateAsync;
@@ -352,26 +344,22 @@ function LinkTab({
     setAgentLinkError(false);
     if (!sharesLoaded) return;
 
-    if (!isPublic && agentShareOpen) {
+    if (!isPublic) {
       void loadAgentContextUrl();
     }
 
     return () => {
       agentLinkRequestIdRef.current += 1;
     };
-  }, [
-    agentShareOpen,
-    isPublic,
-    loadAgentContextUrl,
-    recordingId,
-    sharesLoaded,
-    visibility,
-  ]);
+  }, [isPublic, loadAgentContextUrl, recordingId, sharesLoaded, visibility]);
 
+  const agentLink = isPublic ? shareUrl : agentContextUrl;
   const agentShareDisabled =
-    isPending || createAgentLink.isPending || !agentContextUrl;
-  const agentPrompt = agentContextUrl
-    ? t("shareDialog.agentPrompt", { agentContextUrl })
+    visibilityPending ||
+    !sharesLoaded ||
+    (!isPublic && (isPending || createAgentLink.isPending || !agentContextUrl));
+  const agentPrompt = agentLink
+    ? t("shareDialog.agentPrompt", { agentContextUrl: agentLink })
     : "";
 
   return (
@@ -399,67 +387,42 @@ function LinkTab({
         }
       />
 
-      {/* Public links unfurl into a playable video in Slack; surface that here
-          (and a connect link) instead of leaving it buried in Settings. */}
-      {isPublic ? <SlackShareHint canManage={canManage} /> : null}
-
-      {sharesLoaded && !isPublic ? (
-        <Collapsible open={agentShareOpen} onOpenChange={setAgentShareOpen}>
-          <CollapsibleTrigger asChild>
-            <Button
-              type="button"
-              variant="ghost"
-              className="h-auto w-full justify-between px-0 py-1 text-left hover:bg-transparent"
-            >
-              <span className="min-w-0">
-                <span className="block text-xs font-medium text-foreground">
-                  {t("shareDialog.shareWithAgents")}
-                </span>
-                <span className="mt-0.5 block text-xs font-normal text-muted-foreground">
-                  {t("shareDialog.agentTokenDescription")}
-                </span>
-              </span>
-              <IconChevronDown
-                className={`h-4 w-4 shrink-0 text-muted-foreground transition-transform ${
-                  agentShareOpen ? "rotate-180" : ""
-                }`}
-                aria-hidden
-              />
-            </Button>
-          </CollapsibleTrigger>
-          <CollapsibleContent className="pt-2">
-            <div className="space-y-3 rounded-md border border-border bg-muted/30 p-3">
-              <CopyField
-                label={t("shareDialog.shareWithAgents")}
-                value={agentContextUrl}
-                disabled={agentShareDisabled}
-              />
-              {agentLinkError ? (
-                <div className="flex items-center justify-between gap-2 rounded-md border border-border bg-background px-3 py-2">
-                  <p className="text-xs text-muted-foreground">
-                    {t("shareDialog.agentLinkUnavailable")}
-                  </p>
-                  <Button
-                    type="button"
-                    variant="ghost"
-                    size="sm"
-                    className="h-7"
-                    onClick={() => void loadAgentContextUrl()}
-                    disabled={createAgentLink.isPending}
-                  >
-                    {t("shareDialog.retryAgentLink")}
-                  </Button>
-                </div>
-              ) : null}
-              <CopyField
-                label={t("shareDialog.copyAgentPrompt")}
-                value={agentPrompt}
-                disabled={agentShareDisabled}
-              />
-            </div>
-          </CollapsibleContent>
-        </Collapsible>
-      ) : null}
+      <div className="space-y-2">
+        <CopyField
+          label={t("shareDialog.shareWithAgents")}
+          value={agentLink}
+          disabled={agentShareDisabled}
+        />
+        {sharesLoaded && !isPublic ? (
+          <>
+            <p className="text-xs text-muted-foreground">
+              {t("shareDialog.agentTokenDescription")}
+            </p>
+            {agentLinkError ? (
+              <div className="flex items-center justify-between gap-2 rounded-md border border-border bg-muted/30 px-3 py-2">
+                <p className="text-xs text-muted-foreground">
+                  {t("shareDialog.agentLinkUnavailable")}
+                </p>
+                <Button
+                  type="button"
+                  variant="ghost"
+                  size="sm"
+                  className="h-7"
+                  onClick={() => void loadAgentContextUrl()}
+                  disabled={createAgentLink.isPending}
+                >
+                  {t("shareDialog.retryAgentLink")}
+                </Button>
+              </div>
+            ) : null}
+            <CopyField
+              label={t("shareDialog.copyAgentPrompt")}
+              value={agentPrompt}
+              disabled={agentShareDisabled}
+            />
+          </>
+        ) : null}
+      </div>
 
       {sharesLoaded && !isPublic && canManage ? (
         <MakePublicCard

package/corpus/templates/clips/app/components/player/video-player.tsx

@@ -28,6 +28,7 @@ import {
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
 import { Spinner } from "@/components/ui/spinner";
+import { useMseVideoSource } from "@/hooks/use-mse-video-source";
 import {
   parsePlaybackSpeed,
   readPlaybackSpeedPreference,
@@ -365,6 +366,32 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
       [resolvedVideoSrc],
     );
 
+    // Media Source Extensions path for raw fragmented-MP4 recordings (desktop
+    // live-stream uploads). Those files declare no up-front duration, so the
+    // native progressive pipeline scans the whole file before it can play from
+    // a CDN. When the asset sniffs as fragmented, `mse.mode === "mse"` and we
+    // hand the element a MediaSource object URL instead of the raw URL, with the
+    // duration supplied from the DB. Everything else (classic MP4, WebM, Loom,
+    // browsers without MediaSource) stays on the native `<video src>` path,
+    // byte-for-byte unchanged.
+    const mse = useMseVideoSource({
+      videoRef,
+      sourceUrl: resolvedVideoSrc,
+      durationMs,
+      videoFormat,
+      disabled: isLoomEmbed || unsupportedFormat,
+    });
+    const mseActive = mse.mode === "mse" && Boolean(mse.objectUrl);
+    // The URL actually put on the <video> element: the MediaSource object URL
+    // while MSE drives playback, nothing while we're still sniffing an eligible
+    // asset (so the browser never starts the slow native scan), otherwise the
+    // normal resolved/cache-busted source.
+    const domVideoSrc = mseActive
+      ? mse.objectUrl
+      : mse.mode === "pending"
+        ? undefined
+        : activeVideoSrc;
+
     useEffect(() => {
       if (!resolvedVideoSrc) {
         setActiveVideoSrc(undefined);
@@ -1164,7 +1191,7 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
         ) : activeVideoSrc ? (
           <video
             ref={videoRef}
-            src={activeVideoSrc}
+            src={domVideoSrc}
             poster={resolveLocalUrl(thumbnailUrl)}
             // `crossOrigin` is only needed so the owner's canvas thumbnail
             // capture isn't tainted. For everyone else (viewers, and the Slack
@@ -1328,6 +1355,17 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
               playAttemptPendingRef.current = false;
               setIsPlayPending(false);
 
+              // If the MSE pipeline surfaced a media error, tear it down and let
+              // the native <video src> path take over the raw asset URL instead
+              // of running the cache-bust retry against a MediaSource blob URL.
+              if (mseActive) {
+                mse.fallbackToNative();
+                setIsBuffering(false);
+                setIsPreparing(true);
+                setCanPlay(false);
+                return;
+              }
+
               // Most "format not supported" / decode errors reported here are
               // transient — e.g. the share page's video element started
               // fetching a moment before a background seekable-remux pass

package/corpus/templates/clips/app/hooks/use-desktop-promo.ts

@@ -1,8 +1,10 @@
 import { useCallback, useEffect, useState } from "react";
 
 import { useIsMobile } from "@/hooks/use-mobile";
-
-const DISMISSED_KEY = "clips.desktop-promo.dismissed";
+import {
+  hasDownloadedDesktopApp,
+  markDesktopAppDownloaded,
+} from "@/lib/capture-install-options";
 
 function detectDesktopApp(): boolean {
   if (typeof navigator === "undefined") return false;
@@ -25,20 +27,12 @@ export function useDesktopPromo() {
 
   useEffect(() => {
     setIsDesktopApp(detectDesktopApp());
-    setDismissed(
-      typeof window !== "undefined" &&
-        window.localStorage?.getItem(DISMISSED_KEY) === "1",
-    );
+    setDismissed(hasDownloadedDesktopApp());
   }, []);
 
   const dismiss = useCallback(() => {
     setDismissed(true);
-    try {
-      window.localStorage?.setItem(DISMISSED_KEY, "1");
-    } catch {
-      // localStorage can throw in private browsing — ignore, dismissal
-      // still holds for the session via React state.
-    }
+    markDesktopAppDownloaded();
   }, []);
 
   return {

package/corpus/templates/clips/app/hooks/use-mse-video-source.ts

@@ -0,0 +1,146 @@
+/**
+ * Decides whether a recording should play through Media Source Extensions and,
+ * when it should, owns the `MseVideoLoader` lifecycle.
+ *
+ * Raw fragmented-MP4 recordings (from the desktop live-streaming pipeline)
+ * declare no up-front duration, so the browser's progressive `<video src>`
+ * pipeline stalls when they're served from a CDN. This hook sniffs the asset,
+ * and for fragmented files hands the video element a `MediaSource` object URL
+ * driven by range requests with the duration supplied from the DB. Classic MP4,
+ * WebM, Loom, and anything the browser can't MSE fall back to the native path
+ * unchanged.
+ */
+
+import {
+  type RefObject,
+  useCallback,
+  useEffect,
+  useRef,
+  useState,
+} from "react";
+
+import { sniffFragmentedMp4 } from "@/lib/fmp4";
+import { MseVideoLoader, isMediaSourceSupported } from "@/lib/mse-video-loader";
+
+export type MseSourceMode = "pending" | "native" | "mse";
+
+export interface UseMseVideoSourceParams {
+  videoRef: RefObject<HTMLVideoElement | null>;
+  /** The resolved asset URL (proxied same-origin or provider URL). */
+  sourceUrl: string | undefined;
+  /** Authoritative duration in ms from the DB. */
+  durationMs: number;
+  /** Container format hint. WebM is never eligible for this MP4-only loader. */
+  videoFormat?: "webm" | "mp4" | null;
+  /** True for Loom embeds / formats the browser cannot decode — never MSE. */
+  disabled?: boolean;
+}
+
+export interface UseMseVideoSourceResult {
+  mode: MseSourceMode;
+  /** MediaSource object URL to use as `<video src>` when `mode === "mse"`. */
+  objectUrl: string | undefined;
+  /** Drop MSE and revert to the plain `<video src>` path. */
+  fallbackToNative: () => void;
+}
+
+export function useMseVideoSource({
+  videoRef,
+  sourceUrl,
+  durationMs,
+  videoFormat,
+  disabled,
+}: UseMseVideoSourceParams): UseMseVideoSourceResult {
+  // WebM recordings use the native Infinity-duration workaround; only MP4 (and
+  // unknown-format, which the sniff will confirm) are candidates.
+  const eligible =
+    !disabled &&
+    !!sourceUrl &&
+    videoFormat !== "webm" &&
+    isMediaSourceSupported();
+
+  const [mode, setMode] = useState<MseSourceMode>(() =>
+    eligible ? "pending" : "native",
+  );
+  const [objectUrl, setObjectUrl] = useState<string | undefined>(undefined);
+  const loaderRef = useRef<MseVideoLoader | null>(null);
+
+  // Latest duration, kept in a ref so the (deliberately duration-independent)
+  // rebuild effect below seeds a freshly created loader with the current value
+  // even if it changed during the async sniff. Updating a ref in render is
+  // side-effect-free and safe.
+  const durationMsRef = useRef(durationMs);
+  durationMsRef.current = durationMs;
+
+  useEffect(() => {
+    loaderRef.current?.destroy();
+    loaderRef.current = null;
+    setObjectUrl(undefined);
+
+    if (!eligible || !sourceUrl) {
+      setMode("native");
+      return;
+    }
+
+    setMode("pending");
+    let cancelled = false;
+
+    void sniffFragmentedMp4(sourceUrl)
+      .then((isFragmented) => {
+        if (cancelled) return;
+        const video = videoRef.current;
+        if (!isFragmented || !video) {
+          setMode("native");
+          return;
+        }
+        try {
+          const loader = new MseVideoLoader({
+            url: sourceUrl,
+            durationMs: durationMsRef.current,
+            video,
+            onFatal: () => {
+              if (cancelled) return;
+              loaderRef.current?.destroy();
+              loaderRef.current = null;
+              setObjectUrl(undefined);
+              setMode("native");
+            },
+          });
+          loaderRef.current = loader;
+          setObjectUrl(loader.objectUrl);
+          setMode("mse");
+        } catch {
+          setMode("native");
+        }
+      })
+      .catch(() => {
+        if (!cancelled) setMode("native");
+      });
+
+    return () => {
+      cancelled = true;
+      loaderRef.current?.destroy();
+      loaderRef.current = null;
+    };
+    // videoRef is a stable ref object. `durationMs` is intentionally excluded:
+    // it only seeds the timeline and is pushed to the live loader by the effect
+    // below, so a metadata-poll update must not rebuild the loader (which would
+    // revoke the object URL and restart playback from byte zero).
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [eligible, sourceUrl]);
+
+  // Recording metadata polling can raise the DB duration while the same
+  // fragmented asset is still playing; apply it to the live loader in place.
+  useEffect(() => {
+    loaderRef.current?.setDuration(durationMs);
+  }, [durationMs]);
+
+  const fallbackToNative = useCallback(() => {
+    loaderRef.current?.destroy();
+    loaderRef.current = null;
+    setObjectUrl(undefined);
+    setMode("native");
+  }, []);
+
+  return { mode, objectUrl, fallbackToNative };
+}

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

@@ -887,14 +887,6 @@ const messages = {
       "سيفقد {{email}} الوصول إلى هذه المؤسسة. يمكنك دائمًا دعوته مرة أخرى.",
     remove: "إزالة",
   },
-  slackShareHint: {
-    playsInline: "يعمل داخل Slack",
-    connectedDescription:
-      "الصق هذا الرابط في أي مساحة عمل متصلة لتشغيله داخلها.",
-    makeInline: "اجعله يعمل داخل Slack",
-    connectDescription: "قم بتوصيل مساحة عمل حتى يظهر هذا الرابط كفيديو.",
-    connect: "اتصال",
-  },
   commentsPanel: {
     disabled: "تم تعطيل التعليقات لهذا التسجيل.",
     beFirst: "كن أول من يعلق",

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

@@ -911,15 +911,6 @@ Alle sichtbaren Änderungen für Clips-Nutzer werden hier dokumentiert. Du kanns
       "{{email}} verliert den Zugriff auf diese Organisation. Du kannst die Person jederzeit erneut einladen.",
     remove: "Entfernen",
   },
-  slackShareHint: {
-    playsInline: "Wird inline in Slack abgespielt",
-    connectedDescription:
-      "Füge diesen Link in einem verbundenen Workspace ein, um ihn inline abzuspielen.",
-    makeInline: "Inline-Wiedergabe in Slack aktivieren",
-    connectDescription:
-      "Verbinde einen Workspace, damit dieser Link als Video angezeigt wird.",
-    connect: "Verbinden",
-  },
   commentsPanel: {
     disabled: "Kommentare sind für diese Aufzeichnung deaktiviert.",
     beFirst: "Schreibe den ersten Kommentar",

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

@@ -882,14 +882,6 @@ All notable user-facing changes to Clips are documented here. Open it any time f
       "{{email}} will lose access to this organization. You can always invite them back.",
     remove: "Remove",
   },
-  slackShareHint: {
-    playsInline: "Plays inline in Slack",
-    connectedDescription:
-      "Paste this link in any connected workspace to play it inline.",
-    makeInline: "Make it play inline in Slack",
-    connectDescription: "Connect a workspace so this link unfurls as a video.",
-    connect: "Connect",
-  },
   commentsPanel: {
     disabled: "Comments are disabled for this recording.",
     beFirst: "Be the first to comment",

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

@@ -904,15 +904,6 @@ Todos los cambios visibles para los usuarios de Clips se documentan aquí. Puede
       "{{email}} perderá acceso a esta organización. Siempre puedes volver a invitarlo.",
     remove: "Eliminar",
   },
-  slackShareHint: {
-    playsInline: "Se reproduce inline en Slack",
-    connectedDescription:
-      "Pega este enlace en cualquier espacio conectado para reproducirlo inline.",
-    makeInline: "Haz que se reproduzca inline en Slack",
-    connectDescription:
-      "Conecta un espacio para que este enlace se despliegue como video.",
-    connect: "Conectar",
-  },
   commentsPanel: {
     disabled: "Los comentarios están desactivados para esta grabación.",
     beFirst: "Sé la primera persona en comentar",

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

@@ -906,15 +906,6 @@ Tous les changements visibles par les utilisateurs de Clips sont documentés ici
       "{{email}} perdra l’accès à cette organisation. Vous pourrez toujours l’inviter à nouveau.",
     remove: "Retirer",
   },
-  slackShareHint: {
-    playsInline: "Lecture inline dans Slack",
-    connectedDescription:
-      "Collez ce lien dans n’importe quel espace connecté pour le lire inline.",
-    makeInline: "Le lire inline dans Slack",
-    connectDescription:
-      "Connectez un espace pour que ce lien se déplie en vidéo.",
-    connect: "Connecter",
-  },
   commentsPanel: {
     disabled: "Les commentaires sont désactivés pour cet enregistrement.",
     beFirst: "Soyez le premier à commenter",

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

@@ -876,14 +876,6 @@ Clips में उपयोगकर्ताओं को दिखने व
       "{{email}} इस संगठन तक पहुंच खो देगा। आप उन्हें हमेशा वापस आमंत्रित कर सकते हैं।",
     remove: "हटाएं",
   },
-  slackShareHint: {
-    playsInline: "Slack में इनलाइन चलता है",
-    connectedDescription:
-      "इसे इनलाइन चलाने के लिए यह लिंक किसी भी जुड़े हुए वर्कस्पेस में पेस्ट करें।",
-    makeInline: "इसे Slack में इनलाइन चलाएं",
-    connectDescription: "एक वर्कस्पेस कनेक्ट करें ताकि यह लिंक वीडियो के रूप में खुले।",
-    connect: "कनेक्ट करें",
-  },
   commentsPanel: {
     disabled: "इस रिकॉर्डिंग के लिए टिप्पणियां बंद हैं।",
     beFirst: "पहली टिप्पणी करें",

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

@@ -893,15 +893,6 @@ Clips のユーザー向けの主な変更はここに記録されます。コ
       "{{email}} はこの組織へのアクセスを失います。いつでも再招待できます。",
     remove: "削除",
   },
-  slackShareHint: {
-    playsInline: "Slack 内でインライン再生",
-    connectedDescription:
-      "このリンクを接続済みワークスペースに貼り付けるとインライン再生されます。",
-    makeInline: "Slack でインライン再生する",
-    connectDescription:
-      "ワークスペースを接続すると、このリンクが動画として展開されます。",
-    connect: "接続",
-  },
   commentsPanel: {
     disabled: "この録画ではコメントが無効です。",
     beFirst: "最初にコメントする",

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

@@ -883,15 +883,6 @@ Clips의 모든 사용자 대상 변경 사항은 여기에 기록됩니다. 명
       "{{email}}은 이 조직에 대한 액세스 권한을 잃습니다. 언제든 다시 초대할 수 있습니다.",
     remove: "제거",
   },
-  slackShareHint: {
-    playsInline: "Slack에서 인라인 재생",
-    connectedDescription:
-      "이 링크를 연결된 워크스페이스에 붙여넣으면 인라인으로 재생됩니다.",
-    makeInline: "Slack에서 인라인 재생하기",
-    connectDescription:
-      "워크스페이스를 연결하면 이 링크가 동영상으로 펼쳐집니다.",
-    connect: "연결",
-  },
   commentsPanel: {
     disabled: "이 녹화에서는 댓글이 비활성화되어 있습니다.",
     beFirst: "첫 댓글을 남겨보세요",

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

@@ -900,15 +900,6 @@ Todas as mudanças visíveis para usuários do Clips são documentadas aqui. Voc
       "{{email}} perderá acesso a esta organização. Você sempre pode convidá-lo novamente.",
     remove: "Remover",
   },
-  slackShareHint: {
-    playsInline: "Reproduz inline no Slack",
-    connectedDescription:
-      "Cole este link em qualquer workspace conectado para reproduzi-lo inline.",
-    makeInline: "Faça reproduzir inline no Slack",
-    connectDescription:
-      "Conecte um workspace para que este link abra como vídeo.",
-    connect: "Conectar",
-  },
   commentsPanel: {
     disabled: "Os comentários estão desativados para esta gravação.",
     beFirst: "Seja a primeira pessoa a comentar",

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

@@ -849,13 +849,6 @@ Clips 中所有面向用户的重要更改都会记录在这里。你可以随
       "{{email}} 将失去对此组织的访问权限。你随时可以重新邀请他们。",
     remove: "移除",
   },
-  slackShareHint: {
-    playsInline: "可在 Slack 中内联播放",
-    connectedDescription: "将此链接粘贴到任何已连接工作区即可内联播放。",
-    makeInline: "让它在 Slack 中内联播放",
-    connectDescription: "连接一个工作区，让此链接展开为视频。",
-    connect: "连接",
-  },
   commentsPanel: {
     disabled: "此录制已禁用评论。",
     beFirst: "成为第一个评论的人",

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

@@ -842,13 +842,6 @@ const messages = {
       "{{email}} 將失去對此組織的存取權限。你隨時可以重新邀請他們。",
     remove: "移除",
   },
-  slackShareHint: {
-    playsInline: "可在 Slack 中行內播放",
-    connectedDescription: "將此連結貼上到任何已連線工作區即可行內播放。",
-    makeInline: "讓它在 Slack 中行內播放",
-    connectDescription: "連線一個工作區，讓此連結展開為影片。",
-    connect: "連線",
-  },
   commentsPanel: {
     disabled: "此錄製已停用評論。",
     beFirst: "成為第一個評論的人",

package/corpus/templates/clips/app/lib/capture-install-options.ts

@@ -1,3 +1,24 @@
+const DESKTOP_DOWNLOAD_STORAGE_KEY = "clips.desktop-promo.dismissed";
+
+export function hasDownloadedDesktopApp(): boolean {
+  try {
+    return (
+      typeof window !== "undefined" &&
+      window.localStorage?.getItem(DESKTOP_DOWNLOAD_STORAGE_KEY) === "1"
+    );
+  } catch {
+    return false;
+  }
+}
+
+export function markDesktopAppDownloaded(): void {
+  try {
+    window.localStorage?.setItem(DESKTOP_DOWNLOAD_STORAGE_KEY, "1");
+  } catch {
+    // Download tracking is best-effort and must not block the installer.
+  }
+}
+
 function isFalsy(value: unknown): boolean {
   if (typeof value !== "string") return false;
   return ["0", "false", "no", "off"].includes(value.trim().toLowerCase());