@agent-native/core 0.121.1 → 0.122.0

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

@@ -32,7 +32,13 @@ import {
   type LoaderFunctionArgs,
   type MetaFunction,
 } from "react-router";
-import { Link, useLoaderData, useNavigate, useParams } from "react-router";
+import {
+  Link,
+  useLoaderData,
+  useNavigate,
+  useParams,
+  useSearchParams,
+} from "react-router";
 import { toast } from "sonner";
 
 import { CaptureInstallButton } from "@/components/capture-install-options";
@@ -41,6 +47,7 @@ import { CommentsPanel } from "@/components/player/comments-panel";
 import { RecordingOptionsMenu } from "@/components/player/delete-recording-menu";
 import { InsightsPanel } from "@/components/player/insights-panel";
 import { ReactionsTray } from "@/components/player/reactions-tray";
+import { RecordingViewsBadge } from "@/components/player/recording-views-badge";
 import { ShareRecordingPopover } from "@/components/player/share-dialog";
 import { SignInPromptDialog } from "@/components/player/sign-in-prompt-dialog";
 import { TranscriptPanel } from "@/components/player/transcript-panel";
@@ -82,6 +89,7 @@ import {
   buildSignupAttributionQuery,
   readShareAttribution,
 } from "../../shared/share-attribution";
+import { resolveDashboardRedirect } from "../../shared/share-dashboard-redirect";
 import { privateShareLoaderData } from "../../shared/share-loader-response";
 import {
   buildClipsShareMeta,
@@ -344,6 +352,7 @@ export default function ShareRoute() {
   const loaderData = useLoaderData<typeof loader>() as SharePageLoaderData;
   const { shareId } = useParams<{ shareId: string }>();
   const navigate = useNavigate();
+  const [searchParams] = useSearchParams();
 
   // Viral attribution: read the `ref`/`via` the visitor arrived on (the tagged
   // share link) so we can fire funnel events and forward attribution into the
@@ -415,6 +424,7 @@ export default function ShareRoute() {
     null,
   );
   const [processingTimeout, setProcessingTimeout] = useState(false);
+  const [panel, setPanel] = useState("comments");
   const requireSignIn = useCallback(
     (intent: "comment" | "react") => setSignInIntent(intent),
     [],
@@ -499,6 +509,10 @@ export default function ShareRoute() {
     viewerRole === "admin" ||
     viewerRole === "editor";
   const viewerIsOwner = Boolean(dataQ.data?.data?.viewer?.isOwner);
+  const viewerCanOpenDashboard = Boolean(
+    dataQ.data?.data?.viewer?.canOpenDashboard,
+  );
+  const viewCount = Number(dataQ.data?.data?.viewCount ?? 0);
   const showTitleSkeleton = recording
     ? shouldShowGeneratedTitleSkeleton(recording, transcriptStatus)
     : false;
@@ -522,6 +536,21 @@ export default function ShareRoute() {
     document.title = clipsSharePageTitle(recording.title);
   }, [recording?.title]);
 
+  // /share/:id and /r/:id render the same clip, so anyone who can open the
+  // authenticated page goes straight there rather than through a redundant
+  // "open dashboard" button. `canOpenDashboard` is the server's own
+  // `canOpenDirectRecordingPage` verdict; deriving it from the display role
+  // instead would bounce viewers between the two routes forever, since /r
+  // sends anyone it rejects back here.
+  useEffect(() => {
+    const target = resolveDashboardRedirect({
+      recordingId: recording?.id,
+      canOpenDashboard: viewerCanOpenDashboard,
+      search: searchParams.toString(),
+    });
+    if (target) navigate(target, { replace: true });
+  }, [viewerCanOpenDashboard, recording?.id, searchParams, navigate]);
+
   // The /share/* shell skips DbSyncSetup (and thus useNavigationState), so the
   // agent mounted in the side panel has no navigation context. Write it
   // explicitly for signed-in viewers so view-screen grounds the chat to this
@@ -809,12 +838,6 @@ export default function ShareRoute() {
                   {t("sharePage.signInIfYours")}
                 </a>
               </Button>
-            ) : canManageStorage && isFailure ? (
-              <Button asChild size="sm">
-                <a href={appPath(`/r/${recording.id}`)}>
-                  {t("sharePage.openDashboard")}
-                </a>
-              </Button>
             ) : null}
             <Button
               onClick={() => {
@@ -866,19 +889,13 @@ export default function ShareRoute() {
           </div>
 
           <div className="flex w-full min-w-0 flex-wrap items-center justify-between gap-2 sm:w-auto sm:justify-end">
-            {viewerCanEdit ? (
-              <Button variant="outline" size="sm" asChild>
-                <a
-                  href={appPath(`/r/${recording.id}`)}
-                  className="min-w-0 gap-1.5"
-                >
-                  <span className="truncate">
-                    {t("sharePage.openDashboard")}
-                  </span>
-                  <IconExternalLink className="h-3.5 w-3.5 shrink-0" />
-                </a>
-              </Button>
-            ) : session ? null : (
+            <RecordingViewsBadge
+              recordingId={recording.id}
+              viewCount={viewCount}
+              canViewDetails={viewerCanEdit}
+              onOpenInsights={() => setPanel("insights")}
+            />
+            {session ? null : (
               <Button variant="ghost" size="sm" asChild>
                 <a
                   href={appPath("/")}
@@ -984,16 +1001,6 @@ export default function ShareRoute() {
 
           <div className="flex shrink-0 flex-col gap-3 px-4 pb-4 sm:flex-row sm:items-start sm:px-0 sm:pb-0">
             <div className="min-w-0 flex-1">
-              {showTitleSkeleton ? (
-                <Skeleton
-                  aria-label={t("sharePage.generatingTitle")}
-                  className="h-5 w-72 max-w-full"
-                />
-              ) : (
-                <h2 className="break-words text-base font-semibold leading-tight">
-                  {visibleTitle}
-                </h2>
-              )}
               {recording.description ? (
                 <p className="whitespace-pre-wrap break-words text-sm text-muted-foreground">
                   {recording.description}
@@ -1058,7 +1065,11 @@ export default function ShareRoute() {
       </div>
 
       <aside className="flex min-h-[420px] w-full min-w-0 shrink-0 flex-col border-t border-border bg-background lg:min-h-0 lg:w-[380px] lg:border-s lg:border-t-0">
-        <Tabs defaultValue="comments" className="flex h-full flex-col">
+        <Tabs
+          value={panel}
+          onValueChange={setPanel}
+          className="flex h-full flex-col"
+        >
           <TabsList className="mx-3 mt-3 grid w-auto grid-cols-4">
             <TabsTrigger value="comments" className="text-xs gap-1">
               {t("recordingPage.activity")}

package/corpus/templates/clips/changelog/2026-07-24-clip-pages-now-show-a-view-count-with-viewer-avatars-next-to.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-24
+---
+
+Clip pages now show a view count with viewer avatars next to the title, and owners can click through to see who watched and how far they got.

package/corpus/templates/clips/changelog/2026-07-24-clip-summaries-read-like-a-description-you-d-write-yourself-.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-24
+---
+
+Clip summaries read like a description you'd write yourself instead of narrating "the speaker", and the share page no longer repeats the title under the player

package/corpus/templates/clips/changelog/2026-07-24-clip-view-counts-now-separate-human-views-from-agent-views-s.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-24
+---
+
+Clip view counts now separate human views from agent views, showing which AI agents (Claude, ChatGPT, Perplexity) read a clip through its agent APIs

package/corpus/templates/clips/changelog/2026-07-24-clips-actions-can-now-be-called-by-org-service-tokens-so-ext.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-24
+---
+
+Clips actions can now be called by org service tokens, so external systems like a support desk can import recordings automatically.

package/corpus/templates/clips/changelog/2026-07-24-clips-no-longer-briefly-shows-a-dock-icon-while-launching.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-24
+---
+
+Clips no longer briefly shows a Dock icon while launching

package/corpus/templates/clips/changelog/2026-07-24-fixed-owner-and-editor-share-links-redirecting-to-the-record.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-24
+---
+
+Fixed owner and editor share links redirecting to the recording dashboard

package/corpus/templates/clips/changelog/2026-07-24-meeting-and-note-recordings-now-start-as-a-compact-pill-on-t.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-24
+---
+
+Meeting and note recordings now start as a compact pill on the right edge with a live waveform that moves with the room, and the transcript view is grayscale with an Ask anything bar built in.

package/corpus/templates/clips/changelog/2026-07-24-new-clips-now-copy-a-shareable-link-instead-of-the-owner-onl.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-24
+---
+
+New clips now copy a shareable link instead of the owner-only link, so the link auto-copied by the web recorder, desktop app, and Chrome extension works for everyone you paste it to

package/corpus/templates/clips/changelog/2026-07-24-opening-a-share-link-as-the-clip-s-owner-now-goes-straight-t.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-24
+---
+
+Opening a share link as the clip's owner now goes straight to the full clip page instead of showing a near-identical page with an "Open dashboard" button.

package/corpus/templates/clips/changelog/2026-07-24-permissions-and-rewind-controls-now-use-compact-consistent-h.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-24
+---
+
+Permissions and Rewind controls now use compact, consistent hover states

package/corpus/templates/clips/changelog/2026-07-24-quitting-the-desktop-app-no-longer-shows-a-false-macos-crash.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-24
+---
+
+Quitting the desktop app no longer shows a false macOS crash report

package/corpus/templates/clips/changelog/2026-07-24-screen-recording-permission-errors-now-name-the-exact-app-to.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-24
+---
+
+Screen recording permission errors now name the exact app to allow in macOS System Settings, instead of pointing at an entry Clips never appears under

package/corpus/templates/clips/changelog/2026-07-24-the-desktop-app-now-copies-a-new-clip-s-share-link-to-your-c.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-07-24
+---
+
+The desktop app now copies a new clip's public share link to your clipboard the moment a recording finishes and shows a notification confirming it, so it's ready to paste straight into Slack

package/corpus/templates/clips/changelog/2026-07-24-the-recording-toolbar-now-stays-above-other-apps-including-o.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-24
+---
+
+The recording toolbar now stays above other apps, including on fullscreen and other Spaces

package/corpus/templates/clips/changelog/2026-07-24-transcript-captions-now-use-real-speech-timings-instead-of-a.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-24
+---
+
+Transcript captions now use real speech timings instead of an estimated even spread

package/corpus/templates/clips/changelog/2026-07-24-video-playback-no-longer-stutters-and-replays-the-last-momen.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-24
+---
+
+Video playback no longer stutters and replays the last moment during a clip

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

@@ -1,3 +1,5 @@
+import { buildRecordingShareUrl } from "@shared/recording-link";
+
 import {
   restartUploadModeFromResponse,
   restartUploadResetBody,
@@ -1080,12 +1082,26 @@ function sendOffscreenMessage<T>(message: Record<string, unknown>): Promise<T> {
   });
 }
 
+// The author's own dashboard. Fine to OPEN for the person who just recorded;
+// never the thing to hand someone else — see recordingShareUrl below.
 function recordingUrl(
   recording: Pick<NativeRecording, "clipsBaseUrl" | "recordingId">,
 ): string {
   return `${recording.clipsBaseUrl}/r/${encodeURIComponent(recording.recordingId)}`;
 }
 
+// The extension only stores the signed-in user's token and email; email is PII
+// and must never become the `via` attribution param, so share URLs go out
+// without an owner id.
+function recordingShareUrl(
+  recording: Pick<NativeRecording, "clipsBaseUrl" | "recordingId">,
+): string {
+  return buildRecordingShareUrl({
+    recordingId: recording.recordingId,
+    origin: recording.clipsBaseUrl,
+  });
+}
+
 async function copyRecordingUrlToClipboard(
   recording: NativeRecording,
 ): Promise<void> {
@@ -1093,7 +1109,7 @@ async function copyRecordingUrlToClipboard(
     await ensureOffscreenDocument();
     await sendOffscreenMessage({
       type: "CLIPS_OFFSCREEN_COPY_TEXT",
-      text: recording.recordingUrl,
+      text: recordingShareUrl(recording),
     });
   } catch (err) {
     console.warn("[clips-bg] could not copy recording URL", err);

package/corpus/templates/clips/desktop/package.json

@@ -23,7 +23,9 @@
     "@sentry/browser": "10.62.0",
     "@tabler/icons-react": "catalog:",
     "@tauri-apps/api": "^2.11.0",
+    "@tauri-apps/plugin-clipboard-manager": "^2.3.2",
     "@tauri-apps/plugin-fs": "2.5.1",
+    "@tauri-apps/plugin-notification": "^2.3.3",
     "@tauri-apps/plugin-process": "^2.3.1",
     "@tauri-apps/plugin-shell": "^2.3.5",
     "@tauri-apps/plugin-updater": "^2.10.1",

package/corpus/templates/clips/desktop/src/app.tsx

@@ -63,6 +63,7 @@ import {
   getCameraStreamWithFallback,
   isMediaConstraintFailure,
 } from "./lib/media-capture-constraints";
+import { sendNativeNotification } from "./lib/native-notification";
 import { openMeetingJoinUrl } from "./lib/open-meeting-join-url";
 import {
   DESKTOP_CAPTURE_PERMISSION_MESSAGE,
@@ -88,6 +89,10 @@ import {
   type RecorderHandle,
   type RecorderStopResult,
 } from "./lib/recorder";
+import {
+  copyRecordingShareLink,
+  recordingShareUrl,
+} from "./lib/recording-link";
 import { REWIND_AGENT_PROMPT } from "./lib/rewind-agent-prompt";
 import { getRewindStatusPresentation } from "./lib/rewind-status";
 import {
@@ -208,6 +213,13 @@ interface LocalRecordingNotice {
   files: LocalExportedFile[];
 }
 
+interface ShareLinkNotice {
+  recordingId: string;
+  origin: string;
+  url: string;
+  copied: boolean;
+}
+
 interface ScreenMemoryExportResult {
   folderPath: string;
   files: Array<{
@@ -907,6 +919,8 @@ export function App() {
   );
   const [localRecordingNotice, setLocalRecordingNotice] =
     useState<LocalRecordingNotice | null>(null);
+  const [shareLinkNotice, setShareLinkNotice] =
+    useState<ShareLinkNotice | null>(null);
   const [popoverView, setPopoverView] = useState<PopoverView>("recorder");
   const [rewindSettingsReturnView, setRewindSettingsReturnView] = useState<
     "recorder" | "settings"
@@ -2565,6 +2579,32 @@ export function App() {
     });
   }
 
+  // Never rejects: a clipboard failure must not be mistaken for a failed
+  // recording by the stop/retry callers that await this inside their try block.
+  async function copyShareLink(
+    recordingId: string,
+    origin = serverUrl,
+    { notify = true }: { notify?: boolean } = {},
+  ) {
+    try {
+      const url = recordingShareUrl(recordingId, origin);
+      const copied = await copyRecordingShareLink(recordingId, origin);
+      setShareLinkNotice({ recordingId, origin, url, copied });
+      // The popover hides right after an automatic copy, so the banner below is
+      // only seen on the next open — the OS notification is the live signal.
+      if (copied && notify) {
+        await sendNativeNotification({
+          title: "Link copied",
+          body: "Your clip link is ready to paste.",
+        });
+      }
+      return copied;
+    } catch (err) {
+      console.error("[clips-tray] copy share link failed:", err);
+      return false;
+    }
+  }
+
   async function retryPendingUpload(upload: PendingDesktopUpload) {
     if (retryingUploadId || exportingUploadId || dismissingUploadId) return;
     const targetServerUrl = serverUrlForPendingUpload(upload, serverUrl);
@@ -2598,6 +2638,7 @@ export function App() {
         });
       }
       await loadPendingUploads();
+      await copyShareLink(upload.recordingId, targetServerUrl);
       await openExternal(`${targetServerUrl}/r/${upload.recordingId}`);
       getCurrentWindow()
         .hide()
@@ -2737,6 +2778,7 @@ export function App() {
     }
     setRecError(null);
     setLocalRecordingNotice(null);
+    setShareLinkNotice(null);
     console.log("[clips-popover] handleStartRecording clicked", {
       serverUrl,
       mode,
@@ -3101,6 +3143,10 @@ export function App() {
             });
           } else {
             setLastRecordingId(stopResult.recordingId);
+            // The browser opens `/r/<id>` (the author's dashboard); what lands
+            // on the clipboard must be the public `/share/<id>` link, which is
+            // the one a recipient can actually open.
+            await copyShareLink(stopResult.recordingId);
           }
         } catch (err) {
           stopFailed = true;
@@ -3639,6 +3685,20 @@ export function App() {
           />
         ) : null}
 
+        {shareLinkNotice ? (
+          <ShareLinkBanner
+            notice={shareLinkNotice}
+            onCopy={() => {
+              void copyShareLink(
+                shareLinkNotice.recordingId,
+                shareLinkNotice.origin,
+                { notify: false },
+              );
+            }}
+            onDismiss={() => setShareLinkNotice(null)}
+          />
+        ) : null}
+
         <div className="panel">
           {showSourceRow ? (
             <SourceRow
@@ -4233,6 +4293,35 @@ function LocalRecordingSavedBanner({
   );
 }
 
+function ShareLinkBanner({
+  notice,
+  onCopy,
+  onDismiss,
+}: {
+  notice: ShareLinkNotice;
+  onCopy: () => void;
+  onDismiss: () => void;
+}) {
+  return (
+    <div className="share-link-banner">
+      <div className="local-save-copy">
+        <div className="local-save-title">
+          {notice.copied ? "Share link copied" : "Share link ready"}
+        </div>
+        <div className="local-save-sub">{notice.url}</div>
+      </div>
+      {notice.copied ? null : (
+        <button type="button" onClick={onCopy}>
+          Copy
+        </button>
+      )}
+      <button type="button" className="local-save-dismiss" onClick={onDismiss}>
+        Dismiss
+      </button>
+    </div>
+  );
+}
+
 function Header({
   mode,
   onModeChange,

package/corpus/templates/clips/desktop/src/hooks/useMeetingTranscription.ts

@@ -830,13 +830,19 @@ export function useMeetingTranscription({
     );
 
     unlistens.push(
-      listen<{ meetingId: string; openChat?: boolean }>(
+      listen<{ meetingId: string; openChat?: boolean; prompt?: string }>(
         "clips:open-meeting",
         (ev) => {
           if (!ev.payload?.meetingId) return;
-          const query = ev.payload.openChat ? "?chat=1" : "";
+          const params = new URLSearchParams();
+          if (ev.payload.openChat) params.set("chat", "1");
+          const prompt = ev.payload.prompt?.trim();
+          if (prompt) params.set("ask", prompt);
+          const query = params.toString();
           openExternal(
-            `${normalizedServerUrl}/meetings/${ev.payload.meetingId}${query}`,
+            `${normalizedServerUrl}/meetings/${ev.payload.meetingId}${
+              query ? `?${query}` : ""
+            }`,
           ).catch((err) =>
             console.warn("[clips-popover] open meeting in web failed:", err),
           );

package/corpus/templates/clips/desktop/src/lib/audio-meter.ts

@@ -0,0 +1,51 @@
+/**
+ * Level math for the Granola-style waveform meter on the recording pill.
+ *
+ * Kept separate from the React overlay so the "bars must track how loud people
+ * are talking" behaviour is unit-testable without a DOM.
+ */
+
+/** Per-bar scale. The middle bar swings widest, like Granola's meter. */
+export const METER_BAR_GAINS = [0.72, 1, 0.84];
+export const METER_BAR_COUNT = METER_BAR_GAINS.length;
+/** Height (0-1) each bar keeps at silence, so the meter idles as three dots. */
+export const METER_IDLE_HEIGHT = 0.14;
+/** Multiplier applied on every sample tick when no louder audio arrives. */
+export const METER_LEVEL_DECAY = 0.82;
+/** Floor a new sample must clear, so the meter falls smoothly instead of snapping. */
+export const METER_ATTACK_DECAY = 0.55;
+export const METER_SAMPLE_MS = 50;
+
+/** Fold an incoming 0-1 audio level into the current level. */
+export function nextMeterLevel(current: number, incoming: number): number {
+  if (!Number.isFinite(incoming)) return current;
+  const clamped = Math.max(0, Math.min(1, incoming));
+  return Math.max(current * METER_ATTACK_DECAY, clamped);
+}
+
+/** One decay tick. Snaps to silence below a threshold so bars settle at rest. */
+export function decayMeterLevel(current: number): number {
+  const decayed = current * METER_LEVEL_DECAY;
+  return decayed < 0.01 ? 0 : decayed;
+}
+
+/**
+ * Push the newest sample onto the front of the meter's history. Bar 0 shows
+ * the newest level and older levels travel outward, so the bars ripple against
+ * each other instead of moving as one block.
+ */
+export function advanceMeterLevels(levels: number[], sample: number): number[] {
+  return [sample, ...levels.slice(0, METER_BAR_COUNT - 1)];
+}
+
+/**
+ * Bar height as a percentage of the meter's box. Peak levels from speech taps
+ * are often quiet even when speech is clear, so a gentle curve keeps the meter
+ * responsive without turning background noise into a full-height signal.
+ */
+export function meterBarHeight(level: number, barIndex: number): number {
+  const gain = METER_BAR_GAINS[barIndex] ?? 1;
+  const safe = Number.isFinite(level) ? Math.max(0, Math.min(1, level)) : 0;
+  const shaped = safe > 0 ? Math.min(1, Math.pow(safe, 0.52) * 1.08) : 0;
+  return (METER_IDLE_HEIGHT + shaped * gain * (1 - METER_IDLE_HEIGHT)) * 100;
+}

package/corpus/templates/clips/desktop/src/lib/native-notification.ts

@@ -0,0 +1,44 @@
+import {
+  isPermissionGranted,
+  requestPermission,
+  sendNotification,
+} from "@tauri-apps/plugin-notification";
+
+export interface NativeNotification {
+  title: string;
+  body?: string;
+}
+
+export interface NativeNotificationDeps {
+  isPermissionGranted: () => Promise<boolean>;
+  requestPermission: () => Promise<NotificationPermission>;
+  sendNotification: (notification: NativeNotification) => void;
+}
+
+const tauriNotificationDeps: NativeNotificationDeps = {
+  isPermissionGranted,
+  requestPermission,
+  sendNotification,
+};
+
+/**
+ * Post an OS notification, requesting permission first when the user has not
+ * answered yet. Never rejects: callers await this inside recording stop/retry
+ * try blocks, where a throw would be reported as a failed recording.
+ */
+export async function sendNativeNotification(
+  notification: NativeNotification,
+  deps: NativeNotificationDeps = tauriNotificationDeps,
+): Promise<boolean> {
+  try {
+    const granted =
+      (await deps.isPermissionGranted()) ||
+      (await deps.requestPermission()) === "granted";
+    if (!granted) return false;
+    deps.sendNotification(notification);
+    return true;
+  } catch (err) {
+    console.warn("[clips-tray] native notification failed:", err);
+    return false;
+  }
+}

package/corpus/templates/clips/desktop/src/lib/recording-link.ts

@@ -0,0 +1,67 @@
+import { writeText } from "@tauri-apps/plugin-clipboard-manager";
+
+import { buildRecordingShareUrl } from "../../../shared/recording-link";
+import { normalizeServerUrl } from "./url";
+
+/**
+ * Absolute, paste-ready `/share/<id>` URL. Never `/r/<id>` — that is the owner
+ * dashboard and renders a sign-in prompt for anyone the link is sent to.
+ */
+export function recordingShareUrl(
+  recordingId: string,
+  serverUrl: string,
+): string {
+  return buildRecordingShareUrl({
+    recordingId,
+    origin: normalizeServerUrl(serverUrl),
+  });
+}
+
+async function writeClipboardText(text: string): Promise<boolean> {
+  // Rust-side write first: at recording-stop time the popover webview is
+  // usually not focused, and `navigator.clipboard.writeText` rejects with
+  // `NotAllowedError: Document is not focused` in exactly that case.
+  try {
+    await writeText(text);
+    return true;
+  } catch (err) {
+    console.warn("[clips-tray] native clipboard write failed:", err);
+  }
+
+  try {
+    await navigator.clipboard.writeText(text);
+    return true;
+  } catch (err) {
+    console.warn("[clips-tray] navigator clipboard write failed:", err);
+  }
+
+  try {
+    const textarea = document.createElement("textarea");
+    textarea.value = text;
+    textarea.setAttribute("readonly", "");
+    textarea.style.position = "fixed";
+    textarea.style.opacity = "0";
+    textarea.style.pointerEvents = "none";
+    document.body.appendChild(textarea);
+    textarea.select();
+    textarea.setSelectionRange(0, text.length);
+    const copied = document.execCommand("copy");
+    document.body.removeChild(textarea);
+    return copied;
+  } catch (err) {
+    console.warn("[clips-tray] execCommand clipboard write failed:", err);
+    return false;
+  }
+}
+
+/**
+ * Copy a recording's public share URL. Resolves to whether the clipboard
+ * actually took the text so callers never claim a copy that did not happen.
+ */
+export async function copyRecordingShareLink(
+  recordingId: string,
+  serverUrl: string,
+): Promise<boolean> {
+  if (!recordingId.trim() || !normalizeServerUrl(serverUrl)) return false;
+  return writeClipboardText(recordingShareUrl(recordingId, serverUrl));
+}