@agent-native/core 0.106.1 → 0.106.3

package/corpus/core/src/mcp/builtin-tools.ts

@@ -123,8 +123,18 @@ interface AskAppTaskResult {
     arguments: { app: string; taskId: string };
   };
   message?: string;
+  statusRead?: "unavailable";
+  retryable?: true;
+  errorCategory?: AskAppStatusErrorCategory;
+  attempts?: number;
 }
 
+type AskAppStatusErrorCategory =
+  | "transport"
+  | "timeout"
+  | "upstream_5xx"
+  | "rate_limited";
+
 function safeAppPath(raw: unknown): string | null {
   if (typeof raw !== "string" || !raw.trim()) return null;
   const value = raw.trim();
@@ -432,34 +442,125 @@ async function fetchAskAppA2ATask(
   taskId: string,
 ): Promise<AskAppTaskResult> {
   const { client } = await createA2AClientForAskApp(route.origin);
-  let lastError: unknown;
+  const maxAttempts = ASK_APP_STATUS_RETRY_DELAYS_MS.length + 1;
   for (
     let attempt = 0;
     attempt <= ASK_APP_STATUS_RETRY_DELAYS_MS.length;
     attempt++
   ) {
+    const startedAt = Date.now();
     try {
       const task = await client.getTask(taskId);
       return askAppTaskResult(route, task);
     } catch (err) {
-      lastError = err;
       const delayMs = ASK_APP_STATUS_RETRY_DELAYS_MS[attempt];
-      if (delayMs == null || !isTransientAskAppStatusError(err)) {
+      const errorCategory = askAppStatusErrorCategory(err);
+      const retryable = errorCategory != null;
+      const willRetry = retryable && delayMs != null;
+      if (retryable) {
+        console.warn("[ask_app_status] tasks/get attempt failed", {
+          app: route.app,
+          routedVia: route.routedVia,
+          taskId,
+          originHost: askAppStatusOriginHost(route.origin),
+          attempt: attempt + 1,
+          maxAttempts,
+          elapsedMs: Date.now() - startedAt,
+          errorCategory,
+          errorName: err instanceof Error ? err.name : typeof err,
+          causeCode: askAppStatusErrorCauseCode(err),
+          willRetry,
+        });
+      }
+
+      if (!retryable) {
         throw err;
       }
+      if (delayMs == null) {
+        return askAppStatusReadUnavailableResult(
+          route,
+          taskId,
+          errorCategory,
+          maxAttempts,
+        );
+      }
       await new Promise((resolve) => setTimeout(resolve, delayMs));
     }
   }
-  throw lastError;
+  throw new Error("ask_app_status retry loop exited unexpectedly.");
 }
 
 function isTransientAskAppStatusError(err: unknown): boolean {
+  return askAppStatusErrorCategory(err) != null;
+}
+
+function askAppStatusErrorCategory(
+  err: unknown,
+): AskAppStatusErrorCategory | null {
   const message = err instanceof Error ? err.message : String(err ?? "");
-  return (
-    /\bfetch failed\b|failed to fetch|networkerror|socket hang up|econnreset|etimedout|timeout|aborted/i.test(
-      message,
-    ) || /A2A request failed \((?:429|500|502|503|504)\)/i.test(message)
-  );
+  const causeCode = askAppStatusErrorCauseCode(err) ?? "";
+  const diagnostic = `${message} ${causeCode}`;
+  if (/A2A request failed \(429\)/i.test(message)) return "rate_limited";
+  if (/A2A request failed \((?:500|502|503|504)\)/i.test(message)) {
+    return "upstream_5xx";
+  }
+  if (/etimedout|timeout|aborted|aborterror/i.test(diagnostic)) {
+    return "timeout";
+  }
+  if (
+    /\bfetch failed\b|failed to fetch|networkerror|socket hang up|econnreset/i.test(
+      diagnostic,
+    )
+  ) {
+    return "transport";
+  }
+  return null;
+}
+
+function askAppStatusErrorCauseCode(err: unknown): string | undefined {
+  if (!(err instanceof Error)) return undefined;
+  const directCode = (err as Error & { code?: unknown }).code;
+  if (typeof directCode === "string" && directCode.trim()) {
+    return directCode.trim();
+  }
+  if (!err.cause || typeof err.cause !== "object") return undefined;
+  const code = (err.cause as { code?: unknown }).code;
+  return typeof code === "string" && code.trim() ? code.trim() : undefined;
+}
+
+function askAppStatusOriginHost(origin: string): string {
+  try {
+    return new URL(origin).host;
+  } catch {
+    return "unknown";
+  }
+}
+
+function askAppStatusReadUnavailableResult(
+  route: AskAppRoute,
+  taskId: string,
+  errorCategory: AskAppStatusErrorCategory,
+  attempts: number,
+): AskAppTaskResult {
+  return {
+    app: route.app,
+    routedVia: route.routedVia,
+    taskId,
+    status: "unknown",
+    statusRead: "unavailable",
+    retryable: true,
+    errorCategory,
+    attempts,
+    pollAfterMs: ASK_APP_POLL_INTERVAL_MS,
+    poll: {
+      tool: "ask_app_status",
+      arguments: { app: route.app, taskId },
+    },
+    message:
+      "The durable ask_app task status could not be read after bounded retries. " +
+      "The task may still be running or completed. Retry ask_app_status " +
+      "with the same app and taskId; do not resubmit ask_app.",
+  };
 }
 
 /**
@@ -1186,7 +1287,11 @@ function askAppStatusTool(
 ): ActionEntry {
   return {
     tool: tool(
-      "Poll a durable ask_app task and return its current status or final response.",
+      "Poll a durable ask_app task and return its current status or final response. " +
+        "If a transient status read stays unavailable after bounded retries, the " +
+        "result preserves the app and taskId with statusRead 'unavailable' and a " +
+        "poll instruction. Retry ask_app_status for that same task; never resubmit " +
+        "ask_app as status-read recovery because that can duplicate work.",
       {
         app: {
           type: "string",

package/corpus/core/src/server/agent-chat-plugin.ts

@@ -13,7 +13,10 @@ import {
   type H3Event,
 } from "h3";
 
-import { buildA2ARecoverableArtifactMessage } from "../a2a/artifact-response.js";
+import {
+  buildA2ARecoverableArtifactMessage,
+  type A2AToolResultSummary,
+} from "../a2a/artifact-response.js";
 import {
   hasConfiguredA2ASecret,
   isLoopbackAddress,
@@ -1463,7 +1466,7 @@ export function createAgentChatPlugin(
           // Run the SAME agent loop, then extract the final answer from the
           // event stream so pre-tool narration never leaks as the A2A result.
           const a2aEvents: AgentChatEvent[] = [];
-          const a2aToolResults: Array<{ tool: string; result: string }> = [];
+          const a2aToolResults: A2AToolResultSummary[] = [];
           let lastRecoverableArtifactText = "";
           const controller = new AbortController();
 
@@ -1498,6 +1501,8 @@ export function createAgentChatPlugin(
                   a2aToolResults.push({
                     tool: event.tool,
                     result: event.result,
+                    isError: event.isError,
+                    completedSideEffect: event.completedSideEffect,
                   });
                   const recoverableArtifactText =
                     buildA2ARecoverableArtifactMessage(a2aToolResults, {

package/corpus/templates/clips/app/components/capture-install-options.tsx

@@ -7,7 +7,7 @@ import {
   IconDeviceDesktop,
   IconExternalLink,
 } from "@tabler/icons-react";
-import { type ReactNode } from "react";
+import { type ReactNode, useSyncExternalStore } from "react";
 
 import { Button, type ButtonProps } from "@/components/ui/button";
 import {
@@ -16,11 +16,24 @@ import {
   PopoverTrigger,
 } from "@/components/ui/popover";
 import {
+  attemptOpenDesktopApp,
   clipsChromeExtensionEnabled,
   clipsChromeExtensionUrl,
+  hasDownloadedDesktopApp,
+  subscribeDownloaded,
 } from "@/lib/capture-install-options";
 import { cn } from "@/lib/utils";
 
+// SSR snapshot is always false; same-tab markDesktopAppDownloaded() notifies
+// subscribers so mounted CTAs flip to "Open" without a reload.
+function useHasDownloadedDesktopApp(): boolean {
+  return useSyncExternalStore(
+    subscribeDownloaded,
+    hasDownloadedDesktopApp,
+    () => false,
+  );
+}
+
 type PopoverPlacement = {
   align?: "start" | "center" | "end";
   side?: "top" | "right" | "bottom" | "left";
@@ -29,11 +42,15 @@ type PopoverPlacement = {
 type CaptureInstallButtonProps = Omit<ButtonProps, "asChild"> &
   PopoverPlacement & {
     children: ReactNode;
+    /** Label shown once the desktop app has been downloaded. */
+    downloadedChildren?: ReactNode;
     desktopHref?: string;
   };
 
 type CaptureInstallInlineLinkProps = PopoverPlacement & {
   children: ReactNode;
+  /** Label shown once the desktop app has been downloaded. */
+  downloadedChildren?: ReactNode;
   className?: string;
   desktopHref?: string;
 };
@@ -110,16 +127,37 @@ function InstallOptionsContent({ desktopHref = "/download" }) {
 
 export function CaptureInstallButton({
   children,
+  downloadedChildren,
   className,
   desktopHref = "/download",
   align = "end",
   side = "bottom",
   ...buttonProps
 }: CaptureInstallButtonProps) {
+  const downloaded = useHasDownloadedDesktopApp();
+  const label = downloaded ? (downloadedChildren ?? children) : children;
+
+  if (downloaded) {
+    const { onClick, ...restButtonProps } = buttonProps;
+    return (
+      <Button
+        className={className}
+        {...restButtonProps}
+        onClick={(event) => {
+          onClick?.(event);
+          if (event.defaultPrevented) return;
+          attemptOpenDesktopApp(desktopHref);
+        }}
+      >
+        {label}
+      </Button>
+    );
+  }
+
   if (!clipsChromeExtensionEnabled) {
     return (
       <Button asChild className={className} {...buttonProps}>
-        <a href={appPath(desktopHref)}>{children}</a>
+        <a href={appPath(desktopHref)}>{label}</a>
       </Button>
     );
   }
@@ -128,7 +166,7 @@ export function CaptureInstallButton({
     <Popover>
       <PopoverTrigger asChild>
         <Button className={className} {...buttonProps}>
-          {children}
+          {label}
           <IconChevronDown className="h-3.5 w-3.5" />
         </Button>
       </PopoverTrigger>
@@ -141,15 +179,32 @@ export function CaptureInstallButton({
 
 export function CaptureInstallInlineLink({
   children,
+  downloadedChildren,
   className,
   desktopHref = "/download",
   align = "start",
   side = "bottom",
 }: CaptureInstallInlineLinkProps) {
+  const downloaded = useHasDownloadedDesktopApp();
+
+  const label = downloaded ? (downloadedChildren ?? children) : children;
+
+  if (downloaded) {
+    return (
+      <button
+        type="button"
+        onClick={() => attemptOpenDesktopApp(desktopHref)}
+        className={cn("cursor-pointer", className)}
+      >
+        {label}
+      </button>
+    );
+  }
+
   if (!clipsChromeExtensionEnabled) {
     return (
       <a href={appPath(desktopHref)} className={className}>
-        {children}
+        {label}
       </a>
     );
   }
@@ -158,7 +213,7 @@ export function CaptureInstallInlineLink({
     <Popover>
       <PopoverTrigger asChild>
         <button type="button" className={cn("cursor-pointer", className)}>
-          {children}
+          {label}
         </button>
       </PopoverTrigger>
       <PopoverContent align={align} side={side} className="w-80 p-3">

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

@@ -528,7 +528,15 @@ export function LibraryLayout({ children }: LibraryLayoutProps) {
           <>
             <div className="shrink-0 space-y-1.5 px-2 py-1.5">
               {shouldShowSidebarLink && (
-                <CaptureInstallInlineLink className="flex w-full items-center gap-2 rounded px-2 py-1.5 text-xs text-foreground hover:bg-accent/60">
+                <CaptureInstallInlineLink
+                  className="flex w-full items-center gap-2 rounded px-2 py-1.5 text-xs text-foreground hover:bg-accent/60"
+                  downloadedChildren={
+                    <>
+                      <IconAppWindow className="h-4 w-4" />
+                      {t("captureInstall.openDesktopApp")}
+                    </>
+                  }
+                >
                   <IconAppWindow className="h-4 w-4" />
                   {t("navigation.desktopCta")}
                 </CaptureInstallInlineLink>

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

@@ -2,8 +2,8 @@ import { useCallback, useEffect, useState } from "react";
 
 import { useIsMobile } from "@/hooks/use-mobile";
 import {
-  hasDownloadedDesktopApp,
-  markDesktopAppDownloaded,
+  hasDismissedDesktopPromo,
+  markDesktopPromoDismissed,
 } from "@/lib/capture-install-options";
 
 function detectDesktopApp(): boolean {
@@ -27,12 +27,12 @@ export function useDesktopPromo() {
 
   useEffect(() => {
     setIsDesktopApp(detectDesktopApp());
-    setDismissed(hasDownloadedDesktopApp());
+    setDismissed(hasDismissedDesktopPromo());
   }, []);
 
   const dismiss = useCallback(() => {
     setDismissed(true);
-    markDesktopAppDownloaded();
+    markDesktopPromoDismissed();
   }, []);
 
   return {

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

@@ -1106,6 +1106,7 @@ const messages = {
     desktopTitle: "Desktop app (مترجم)",
     desktopDescription:
       "Most seamless for global shortcuts, menu-bar recording, meetings, and repeat captures. (مترجم)",
+    openDesktopApp: "Open desktop app (مترجم)",
   },
   editableTitle: {
     untitled: "Untitled Clip (مترجم)",

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

@@ -1132,6 +1132,7 @@ Alle sichtbaren Änderungen für Clips-Nutzer werden hier dokumentiert. Du kanns
     desktopTitle: "Desktop app (Lokalisiert)",
     desktopDescription:
       "Most seamless for global shortcuts, menu-bar recording, meetings, and repeat captures. (Lokalisiert)",
+    openDesktopApp: "Open desktop app (Lokalisiert)",
   },
   editableTitle: {
     untitled: "Untitled Clip (Lokalisiert)",

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

@@ -1102,6 +1102,7 @@ All notable user-facing changes to Clips are documented here. Open it any time f
     desktopTitle: "Desktop app",
     desktopDescription:
       "Most seamless for global shortcuts, menu-bar recording, meetings, and repeat captures.",
+    openDesktopApp: "Open desktop app",
   },
   editableTitle: {
     untitled: "Untitled Clip",

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

@@ -1125,6 +1125,7 @@ Todos los cambios visibles para los usuarios de Clips se documentan aquí. Puede
     desktopTitle: "Desktop app (Localizado)",
     desktopDescription:
       "Most seamless for global shortcuts, menu-bar recording, meetings, and repeat captures. (Localizado)",
+    openDesktopApp: "Open desktop app (Localizado)",
   },
   editableTitle: {
     untitled: "Untitled Clip (Localizado)",

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

@@ -1127,6 +1127,7 @@ Tous les changements visibles par les utilisateurs de Clips sont documentés ici
     desktopTitle: "Desktop app (Localisé)",
     desktopDescription:
       "Most seamless for global shortcuts, menu-bar recording, meetings, and repeat captures. (Localisé)",
+    openDesktopApp: "Open desktop app (Localisé)",
   },
   editableTitle: {
     untitled: "Untitled Clip (Localisé)",

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

@@ -1093,6 +1093,7 @@ Clips में उपयोगकर्ताओं को दिखने व
     desktopTitle: "Desktop app (स्थानीयकृत)",
     desktopDescription:
       "Most seamless for global shortcuts, menu-bar recording, meetings, and repeat captures. (स्थानीयकृत)",
+    openDesktopApp: "Open desktop app (स्थानीयकृत)",
   },
   editableTitle: {
     untitled: "Untitled Clip (स्थानीयकृत)",

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

@@ -1114,6 +1114,7 @@ Clips のユーザー向けの主な変更はここに記録されます。コ
     desktopTitle: "Desktop app (ローカライズ済み)",
     desktopDescription:
       "Most seamless for global shortcuts, menu-bar recording, meetings, and repeat captures. (ローカライズ済み)",
+    openDesktopApp: "Open desktop app (ローカライズ済み)",
   },
   editableTitle: {
     untitled: "Untitled Clip (ローカライズ済み)",

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

@@ -1103,6 +1103,7 @@ Clips의 모든 사용자 대상 변경 사항은 여기에 기록됩니다. 명
     desktopTitle: "Desktop app (현지화됨)",
     desktopDescription:
       "Most seamless for global shortcuts, menu-bar recording, meetings, and repeat captures. (현지화됨)",
+    openDesktopApp: "Open desktop app (현지화됨)",
   },
   editableTitle: {
     untitled: "Untitled Clip (현지화됨)",

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

@@ -1121,6 +1121,7 @@ Todas as mudanças visíveis para usuários do Clips são documentadas aqui. Voc
     desktopTitle: "Desktop app (Localizado)",
     desktopDescription:
       "Most seamless for global shortcuts, menu-bar recording, meetings, and repeat captures. (Localizado)",
+    openDesktopApp: "Open desktop app (Localizado)",
   },
   editableTitle: {
     untitled: "Untitled Clip (Localizado)",

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

@@ -1064,6 +1064,7 @@ Clips 中所有面向用户的重要更改都会记录在这里。你可以随
     desktopTitle: "Desktop app (已本地化)",
     desktopDescription:
       "Most seamless for global shortcuts, menu-bar recording, meetings, and repeat captures. (已本地化)",
+    openDesktopApp: "Open desktop app (已本地化)",
   },
   editableTitle: {
     untitled: "Untitled Clip (已本地化)",

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

@@ -1055,6 +1055,7 @@ const messages = {
       "瀏覽器記錄選項已就緒，正在等待 Chrome Web Store URL。",
     desktopTitle: "桌面應用程式",
     desktopDescription: "最適合全域快捷鍵、選單列錄製、會議與重複擷取。",
+    openDesktopApp: "開啟桌面應用程式",
   },
   editableTitle: {
     untitled: "未命名剪輯",

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

@@ -1,22 +1,107 @@
-const DESKTOP_DOWNLOAD_STORAGE_KEY = "clips.desktop-promo.dismissed";
+import { appPath } from "@agent-native/core/client";
+
+const DESKTOP_PROMO_DISMISSED_STORAGE_KEY = "clips.desktop-promo.dismissed";
+const DESKTOP_DOWNLOADED_STORAGE_KEY = "clips.desktop-app.downloaded";
+
+// Custom scheme the desktop build registers. A web click tries this first and
+// falls back to the download page when nothing handles it.
+const DESKTOP_APP_PROTOCOL_URL = "clips://open";
+const DESKTOP_APP_LAUNCH_FALLBACK_MS = 800;
 
 export function hasDownloadedDesktopApp(): boolean {
   try {
+    if (typeof window === "undefined") return false;
+    const ls = window.localStorage;
+    // Also treat the legacy dismissed flag as "downloaded" — before the flag
+    // split, a single key covered both states, so existing users only have it.
     return (
-      typeof window !== "undefined" &&
-      window.localStorage?.getItem(DESKTOP_DOWNLOAD_STORAGE_KEY) === "1"
+      ls?.getItem(DESKTOP_DOWNLOADED_STORAGE_KEY) === "1" ||
+      ls?.getItem(DESKTOP_PROMO_DISMISSED_STORAGE_KEY) === "1"
     );
   } catch {
     return false;
   }
 }
 
+const downloadedListeners = new Set<() => void>();
+
+export function subscribeDownloaded(callback: () => void): () => void {
+  downloadedListeners.add(callback);
+  return () => {
+    downloadedListeners.delete(callback);
+  };
+}
+
 export function markDesktopAppDownloaded(): void {
   try {
-    window.localStorage?.setItem(DESKTOP_DOWNLOAD_STORAGE_KEY, "1");
+    // Downloading (or successfully launching) the app also hides the promo.
+    window.localStorage?.setItem(DESKTOP_DOWNLOADED_STORAGE_KEY, "1");
+    window.localStorage?.setItem(DESKTOP_PROMO_DISMISSED_STORAGE_KEY, "1");
   } catch {
     // Download tracking is best-effort and must not block the installer.
   }
+  downloadedListeners.forEach((fn) => fn());
+}
+
+export function hasDismissedDesktopPromo(): boolean {
+  try {
+    return (
+      typeof window !== "undefined" &&
+      window.localStorage?.getItem(DESKTOP_PROMO_DISMISSED_STORAGE_KEY) === "1"
+    );
+  } catch {
+    return false;
+  }
+}
+
+export function markDesktopPromoDismissed(): void {
+  try {
+    window.localStorage?.setItem(DESKTOP_PROMO_DISMISSED_STORAGE_KEY, "1");
+  } catch {
+    // Dismiss tracking is best-effort.
+  }
+}
+
+/**
+ * Try to launch the installed desktop app via its custom protocol, falling back
+ * to the download page when nothing handles the scheme. Browsers expose no way
+ * to query whether the protocol is registered, so we watch for the tab losing
+ * focus (the app taking over) within a short window; if that never happens we
+ * assume the app is not installed and navigate to the fallback. A successful
+ * launch self-heals the stored "downloaded" flag.
+ */
+export function attemptOpenDesktopApp(fallbackHref = "/download"): void {
+  if (typeof window === "undefined") return;
+  const fallbackUrl = appPath(fallbackHref);
+
+  let launched = false;
+  const cleanup = () => {
+    window.removeEventListener("blur", onLeave);
+    document.removeEventListener("visibilitychange", onVisibility);
+  };
+  const onLeave = () => {
+    if (launched) return;
+    launched = true;
+    markDesktopAppDownloaded();
+    cleanup();
+  };
+  const onVisibility = () => {
+    if (document.hidden) onLeave();
+  };
+
+  window.addEventListener("blur", onLeave);
+  document.addEventListener("visibilitychange", onVisibility);
+
+  window.setTimeout(() => {
+    cleanup();
+    if (!launched) window.location.href = fallbackUrl;
+  }, DESKTOP_APP_LAUNCH_FALLBACK_MS);
+
+  try {
+    window.location.href = DESKTOP_APP_PROTOCOL_URL;
+  } catch {
+    // Some browsers throw on an unknown scheme; the timeout handles fallback.
+  }
 }
 
 function isFalsy(value: unknown): boolean {

package/corpus/templates/clips/app/routes/_app.dictate.tsx

@@ -640,7 +640,16 @@ function EmptyState({ isDesktopApp }: { isDesktopApp: boolean }) {
             {t("dictateRoute.emptyWebDescription")}
           </p>
           <div className="mt-5 flex items-center justify-center">
-            <CaptureInstallButton size="sm" className="gap-1.5">
+            <CaptureInstallButton
+              size="sm"
+              className="gap-1.5"
+              downloadedChildren={
+                <>
+                  <IconDeviceDesktop className="h-3.5 w-3.5" />
+                  {t("captureInstall.openDesktopApp")}
+                </>
+              }
+            >
               <IconDownload className="h-3.5 w-3.5" />
               {t("dictateRoute.downloadDesktopApp")}
             </CaptureInstallButton>

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

@@ -670,6 +670,7 @@ function DesktopRecorderCallout() {
       <CaptureInstallButton
         size="sm"
         className="mt-4 w-full bg-primary text-primary-foreground hover:bg-primary/90"
+        downloadedChildren={t("captureInstall.openDesktopApp")}
       >
         {t("recordRoute.downloadDesktopApp")}
       </CaptureInstallButton>

package/corpus/templates/clips/app/routes/share.$shareId.tsx

@@ -11,6 +11,7 @@ import {
 import {
   IconAlertTriangle,
   IconArrowLeft,
+  IconDeviceDesktop,
   IconDownload,
   IconDots,
   IconExternalLink,
@@ -1220,6 +1221,12 @@ function PublicAgentEmptyState({
           className="w-full gap-2"
           align="center"
           onClick={() => onCtaClick("download")}
+          downloadedChildren={
+            <>
+              <IconDeviceDesktop className="h-4 w-4" />
+              {t("captureInstall.openDesktopApp")}
+            </>
+          }
         >
           <IconDownload className="h-4 w-4" />
           {downloadLabel}

package/corpus/templates/clips/changelog/2026-07-16-the-desktop-app-button-now-shows-open-desktop-app-and-launch.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-16
+---
+
+The desktop app button now shows "Open desktop app" and launches the installed app instead of re-downloading once you've downloaded it.

package/corpus/templates/clips/desktop/src-tauri/Cargo.toml

@@ -34,6 +34,11 @@ tauri = { version = "2", features = [
 tauri-plugin-shell = "2"
 tauri-plugin-global-shortcut = "2"
 tauri-plugin-single-instance = "2"
+# Registers the `clips://` custom URL scheme so a web "Open desktop app"
+# click can launch/focus the running tray app. macOS registration is baked
+# into Info.plist at build time from `plugins.deep-link` in tauri.conf.json;
+# Windows/Linux register at runtime via `register_all()`.
+tauri-plugin-deep-link = "2"
 tauri-plugin-updater = "2"
 tauri-plugin-process = "2"
 tauri-plugin-autostart = "2.5.1"

package/corpus/templates/clips/desktop/src-tauri/capabilities/default.json

@@ -28,6 +28,7 @@
     "core:window:allow-close",
     "core:window:allow-start-dragging",
     "shell:allow-open",
+    "deep-link:default",
     "global-shortcut:allow-register",
     "global-shortcut:allow-unregister",
     "global-shortcut:allow-is-registered",