@agent-native/core 0.109.0 → 0.109.1

package/corpus/templates/clips/app/components/player/playback-comment-overlay.tsx

@@ -1,5 +1,11 @@
 export const PLAYBACK_COMMENT_VISIBLE_MS = 4_000;
 
+export function getPlaybackCommentVisibleMs(playbackRate = 1): number {
+  const safePlaybackRate =
+    Number.isFinite(playbackRate) && playbackRate > 0 ? playbackRate : 1;
+  return PLAYBACK_COMMENT_VISIBLE_MS * safePlaybackRate;
+}
+
 export interface PlaybackComment {
   id: string;
   content: string;
@@ -13,11 +19,14 @@ export interface PlaybackComment {
 export function getActivePlaybackComments(
   comments: PlaybackComment[] | undefined,
   currentMs: number,
+  playbackRate = 1,
 ): PlaybackComment[] {
   if (!comments?.length || !Number.isFinite(currentMs) || currentMs < 0) {
     return [];
   }
 
+  const visibleMs = getPlaybackCommentVisibleMs(playbackRate);
+
   return comments
     .filter((comment) => {
       const timestamp = comment.videoTimestampMs;
@@ -28,7 +37,7 @@ export function getActivePlaybackComments(
         Number.isFinite(timestamp) &&
         timestamp >= 0 &&
         currentMs >= timestamp &&
-        currentMs < timestamp + PLAYBACK_COMMENT_VISIBLE_MS
+        currentMs < timestamp + visibleMs
       );
     })
     .sort(
@@ -40,11 +49,17 @@ export function getActivePlaybackComments(
 export function PlaybackCommentOverlay({
   comments,
   currentMs,
+  playbackRate = 1,
 }: {
   comments: PlaybackComment[] | undefined;
   currentMs: number;
+  playbackRate?: number;
 }) {
-  const activeComments = getActivePlaybackComments(comments, currentMs);
+  const activeComments = getActivePlaybackComments(
+    comments,
+    currentMs,
+    playbackRate,
+  );
   if (activeComments.length === 0) return null;
 
   return (

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

@@ -318,6 +318,7 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
     // Whether we've already captured-and-uploaded a still-frame thumbnail for
     // this clip. Owner-only and once per player lifecycle.
     const thumbnailCapturedRef = useRef(false);
+    const [thumbnailLoadFailed, setThumbnailLoadFailed] = useState(false);
     // "Preparing your clip…" overlay — shown while the browser buffers the
     // first frame of a freshly-finalized clip so the user doesn't see a blank
     // black rectangle. Hidden on loadeddata / canplay / currentTime > 0, or
@@ -933,6 +934,10 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
       setPlayError(null);
     }, [activeVideoSourceIdentity, recordingId]);
 
+    useEffect(() => {
+      setThumbnailLoadFailed(false);
+    }, [recordingId, thumbnailUrl]);
+
     useEffect(() => {
       let cancelled = false;
       setShouldRefreshAutoThumbnail(false);
@@ -1188,10 +1193,11 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
           // retry on a format that will never play. Show the poster with a
           // clear, non-looping explanation instead.
           <div className="relative flex h-full w-full items-center justify-center bg-black">
-            {thumbnailUrl ? (
+            {thumbnailUrl && !thumbnailLoadFailed ? (
               <img
                 src={resolveLocalUrl(thumbnailUrl)}
                 alt=""
+                onError={() => setThumbnailLoadFailed(true)}
                 className={cn(
                   "absolute inset-0 h-full w-full",
                   cover ? "object-cover" : "object-contain",
@@ -1447,6 +1453,7 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
         )}
 
         {thumbnailUrl &&
+        !thumbnailLoadFailed &&
         !autoPlay &&
         !hasPlaybackStarted &&
         (!startMs || startMs <= 0) ? (
@@ -1454,6 +1461,7 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
             src={resolveLocalUrl(thumbnailUrl)}
             alt=""
             aria-hidden="true"
+            onError={() => setThumbnailLoadFailed(true)}
             className={cn(
               "pointer-events-none absolute inset-0 z-[1] h-full w-full",
               cover ? "object-cover" : "object-contain",
@@ -1495,7 +1503,11 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
 
         {/* Timestamped comments */}
         {!hideChrome && !isLoomEmbed && hasPlaybackStarted ? (
-          <PlaybackCommentOverlay comments={comments} currentMs={currentMs} />
+          <PlaybackCommentOverlay
+            comments={comments}
+            currentMs={currentMs}
+            playbackRate={speed}
+          />
         ) : null}
 
         {/* Floating CTA (throughout placement) */}

package/corpus/templates/clips/app/components/recorder/recorder-engine.ts

@@ -11,7 +11,7 @@ import {
   captureClientException,
   trackEvent,
 } from "@agent-native/core/client";
-import { waitForReadyRecordingAfterFinalizeError } from "@shared/finalize-recovery";
+import { waitForAcceptedRecordingAfterFinalizeError } from "@shared/finalize-recovery";
 import {
   chooseFallbackAudioInput,
   enumerateAudioInputDevices,
@@ -2231,7 +2231,7 @@ export class RecorderEngine {
   private async recoverReadyAfterFinalUploadError(
     signal?: AbortSignal,
   ): Promise<Record<string, unknown> | null> {
-    return waitForReadyRecordingAfterFinalizeError({
+    return waitForAcceptedRecordingAfterFinalizeError({
       uploadUrl: this.opts.uploadUrl,
       recordingId: this.opts.recordingId,
       preferAuthenticated: true,

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

@@ -92,7 +92,7 @@ import { cn } from "@/lib/utils";
 import { STALE_PENDING_TRANSCRIPT_REASON } from "../../shared/transcript-status";
 
 const UPLOAD_STUCK_TIMEOUT_MS = 5 * 60 * 1000;
-const PROCESSING_STUCK_TIMEOUT_MS = 2 * 60 * 1000;
+const PROCESSING_STUCK_TIMEOUT_MS = 12 * 60 * 1000;
 const READY_MEDIA_SETTLE_POLL_MS = 20 * 1000;
 const READY_MEDIA_SETTLE_POLL_INTERVAL_MS = 1000;
 

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

@@ -9,7 +9,7 @@ import { useLiveTranscription } from "@agent-native/core/client/transcription/us
 import type { BrowserDiagnosticsData } from "@shared/browser-diagnostics";
 import {
   isStoredButUnservableFinalizeError,
-  waitForReadyRecordingAfterFinalizeError,
+  waitForAcceptedRecordingAfterFinalizeError,
 } from "@shared/finalize-recovery";
 import {
   chunkUploadParallelism,
@@ -1733,7 +1733,7 @@ export default function RecordRoute() {
             createdId &&
             (err as { name?: string } | null)?.name !== "AbortError"
           ) {
-            const recovered = await waitForReadyRecordingAfterFinalizeError({
+            const recovered = await waitForAcceptedRecordingAfterFinalizeError({
               uploadUrl: uploadBase,
               recordingId: createdId,
               preferAuthenticated: true,
@@ -1764,7 +1764,7 @@ export default function RecordRoute() {
             chunkRes.status !== 413 &&
             !isUploadSizeError(error.message)
           ) {
-            const recovered = await waitForReadyRecordingAfterFinalizeError({
+            const recovered = await waitForAcceptedRecordingAfterFinalizeError({
               uploadUrl: uploadBase,
               recordingId: createdId,
               preferAuthenticated: true,

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

@@ -67,6 +67,7 @@ import { parsePlaybackSpeed } from "@/lib/playback-speed";
 import { isStorageSetupFailureReason } from "@/lib/storage-failures";
 
 import { getDb, schema } from "../../server/db";
+import { resolvePlayerThumbnailUrl } from "../../server/lib/player-thumbnail-url";
 import {
   buildAgentApiUrls,
   CLIPS_AGENT_ACCESS_PARAM,
@@ -226,8 +227,10 @@ export async function loader({ params, url }: LoaderFunctionArgs) {
     id: rec.id,
     title: rec.title,
     description: rec.description,
-    thumbnailUrl: rec.thumbnailUrl,
-    animatedThumbnailUrl: rec.animatedThumbnailUrl,
+    thumbnailUrl: rec.password
+      ? null
+      : resolvePlayerThumbnailUrl(rec, { appPath }),
+    animatedThumbnailUrl: null,
     visibility: rec.visibility,
     status: rec.status,
     archivedAt: rec.archivedAt,
@@ -286,7 +289,7 @@ const CLIPS_TEMPLATE_URL = "https://www.agent-native.com/templates/clips";
 const CLIPS_AGENT_DOCS_URL =
   "https://www.agent-native.com/docs/template-clips#agent-readable-clips";
 const UPLOAD_STUCK_TIMEOUT_MS = 5 * 60 * 1000;
-const PROCESSING_STUCK_TIMEOUT_MS = 2 * 60 * 1000;
+const PROCESSING_STUCK_TIMEOUT_MS = 12 * 60 * 1000;
 
 type ViewerPlatform = "mac" | "windows" | "linux";
 

package/corpus/templates/clips/changelog/2026-07-17-clips-now-retries-storage-verification-in-the-background-ins.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-17
+---
+
+Clips now retries storage verification in the background instead of failing completed uploads prematurely.

package/corpus/templates/clips/changelog/2026-07-17-fixed-broken-thumbnail-icons-appearing-over-playable-clip-em.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-17
+---
+
+Fixed broken thumbnail icons appearing over playable clip embeds

package/corpus/templates/clips/changelog/2026-07-17-playback-comments-stay-readable-at-faster-playback-speeds.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-17
+---
+
+Playback comments stay readable at faster playback speeds

package/corpus/templates/clips/chrome-extension/src/finalize-recovery.ts

@@ -2,6 +2,9 @@ export {
   authenticatedRecordingStatusUrl,
   publicRecordingStatusUrl,
   readyRecordingFromPublicPayload,
+  waitForAcceptedRecordingAfterFinalizeError,
   waitForReadyRecordingAfterFinalizeError,
+  type RecoveredFinalizeRecording,
+  type RecoveredProcessingRecording,
   type RecoveredReadyRecording,
 } from "@shared/finalize-recovery";

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

@@ -35,7 +35,7 @@ import {
 } from "@shared/recording-core";
 import { MAX_UPLOAD_BYTES } from "@shared/upload-limits";
 
-import { waitForReadyRecordingAfterFinalizeError } from "./finalize-recovery";
+import { waitForAcceptedRecordingAfterFinalizeError } from "./finalize-recovery";
 import {
   createNativeTranscriptionCapture,
   type NativeTranscriptionCapture,
@@ -875,7 +875,7 @@ async function uploadChunk(
       if (extra.isFinal && res.status === 504) {
         triedFinalUploadRecovery = true;
         await res.text().catch(() => "");
-        const recovered = await waitForReadyRecordingAfterFinalizeError({
+        const recovered = await waitForAcceptedRecordingAfterFinalizeError({
           uploadUrl: recording.uploadUrl,
           recordingId: recording.recordingId,
           authToken: recording.authToken,
@@ -1619,7 +1619,7 @@ async function finalizeStop(recording: ActiveRecording): Promise<void> {
     const error = err instanceof Error ? err : new Error(String(err));
 
     if (isFinalUploadRecoveryCandidate(error)) {
-      const recovered = await waitForReadyRecordingAfterFinalizeError({
+      const recovered = await waitForAcceptedRecordingAfterFinalizeError({
         uploadUrl: recording.uploadUrl,
         recordingId: recording.recordingId,
         authToken: recording.authToken,

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

@@ -70,6 +70,7 @@ import {
   exportBrowserRecordingBackup,
   listBrowserRecordingBackups,
   retryBrowserRecordingBackup,
+  scheduleNativeBackupCleanupAfterProcessing,
   shouldUseNativeFullscreenRecording,
   startRecording,
   type LocalExportedFile,
@@ -1894,12 +1895,23 @@ export function App() {
     try {
       const authToken = loadDesktopAuthToken(targetServerUrl);
       if (upload.kind === "native") {
-        await invoke("native_fullscreen_recording_retry_upload", {
-          serverUrl: targetServerUrl,
-          recordingId: upload.recordingId,
-          authToken,
-          cookie: typeof document !== "undefined" ? document.cookie || "" : "",
-        });
+        const result = await invoke<{ verificationPending?: boolean }>(
+          "native_fullscreen_recording_retry_upload",
+          {
+            serverUrl: targetServerUrl,
+            recordingId: upload.recordingId,
+            authToken,
+            cookie:
+              typeof document !== "undefined" ? document.cookie || "" : "",
+          },
+        );
+        if (result.verificationPending) {
+          scheduleNativeBackupCleanupAfterProcessing({
+            serverUrl: targetServerUrl,
+            recordingId: upload.recordingId,
+            authToken,
+          });
+        }
       } else {
         await retryBrowserRecordingBackup({
           recordingId: upload.recordingId,

package/corpus/templates/clips/desktop/src/lib/recorder.ts

@@ -51,7 +51,10 @@ import { invoke } from "@tauri-apps/api/core";
 import { emit, listen, type UnlistenFn } from "@tauri-apps/api/event";
 import { open as openExternal } from "@tauri-apps/plugin-shell";
 
-import { waitForReadyRecordingAfterFinalizeError } from "../../../shared/finalize-recovery";
+import {
+  waitForAcceptedRecordingAfterFinalizeError,
+  waitForReadyRecordingAfterFinalizeError,
+} from "../../../shared/finalize-recovery";
 import type { LocalRecordingMode } from "../shared/config";
 import { createAudioCue, type AudioCue } from "./audio-cue";
 import { createCameraCompositeStream } from "./camera-composite";
@@ -752,7 +755,56 @@ async function markBrowserRecordingBackupError(
   });
 }
 
-async function recoverReadyRecordingAfterFinalizeError({
+function scheduleBrowserBackupCleanupAfterProcessing(args: {
+  serverUrl: string;
+  recordingId: string;
+  authToken?: string;
+}): void {
+  void waitForReadyRecordingAfterFinalizeError({
+    uploadUrl: chunkUrl(args.serverUrl, args.recordingId, 0, false),
+    recordingId: args.recordingId,
+    authToken: args.authToken,
+    preferAuthenticated: true,
+    timeoutMs: 12 * 60 * 1000,
+  })
+    .then((recovered) => {
+      if (recovered?.status === "ready") {
+        return deleteBrowserRecordingBackup(args.recordingId);
+      }
+    })
+    .catch((err) => {
+      console.warn(
+        "[clips-recorder] background backup cleanup check failed:",
+        err,
+      );
+    });
+}
+
+export function scheduleNativeBackupCleanupAfterProcessing(args: {
+  serverUrl: string;
+  recordingId: string;
+  authToken?: string;
+}): void {
+  void waitForReadyRecordingAfterFinalizeError({
+    uploadUrl: chunkUrl(args.serverUrl, args.recordingId, 0, false),
+    recordingId: args.recordingId,
+    authToken: args.authToken,
+    preferAuthenticated: true,
+    timeoutMs: 12 * 60 * 1000,
+  })
+    .then((recovered) => {
+      if (recovered?.status === "ready") {
+        return invoke("native_fullscreen_recording_dismiss_upload", {
+          recordingId: args.recordingId,
+        });
+      }
+    })
+    .catch((err) => {
+      console.warn("[clips-recorder] native backup cleanup check failed:", err);
+    });
+}
+
+async function recoverAcceptedRecordingAfterFinalizeError({
   serverUrl,
   recordingId,
   authToken,
@@ -760,19 +812,27 @@ async function recoverReadyRecordingAfterFinalizeError({
   serverUrl: string;
   recordingId: string;
   authToken?: string;
-}): Promise<boolean> {
-  const recovered = await waitForReadyRecordingAfterFinalizeError({
+}): Promise<"processing" | "ready" | null> {
+  const recovered = await waitForAcceptedRecordingAfterFinalizeError({
     uploadUrl: chunkUrl(serverUrl, recordingId, 0, false),
     recordingId,
     authToken,
     preferAuthenticated: true,
   });
-  if (!recovered) return false;
+  if (!recovered) return null;
+  if (recovered.status === "processing") {
+    scheduleBrowserBackupCleanupAfterProcessing({
+      serverUrl,
+      recordingId,
+      authToken,
+    });
+    return "processing";
+  }
   await markBrowserRecordingBackupError(
     recordingId,
     "Upload completed, but its final receipt could not be verified. The local backup was kept.",
   ).catch(() => {});
-  return true;
+  return "ready";
 }
 
 export async function listBrowserRecordingBackups(): Promise<
@@ -951,10 +1011,21 @@ export async function retryBrowserRecordingBackup(input: {
           validatedChunks,
           input.authToken,
         );
-        verifyFinalizeReceipt(receipt, meta);
+        const receiptStatus = verifyFinalizeReceipt(receipt, meta);
+        if (receiptStatus === "processing") {
+          scheduleBrowserBackupCleanupAfterProcessing({
+            serverUrl: meta.serverUrl,
+            recordingId: meta.recordingId,
+            authToken: input.authToken,
+          });
+          return {
+            recordingId: meta.recordingId,
+            viewUrl: `/r/${meta.recordingId}`,
+          };
+        }
       } catch (err) {
         if (
-          await recoverReadyRecordingAfterFinalizeError({
+          await recoverAcceptedRecordingAfterFinalizeError({
             serverUrl: meta.serverUrl,
             recordingId: meta.recordingId,
             authToken: input.authToken,
@@ -1007,10 +1078,21 @@ export async function retryBrowserRecordingBackup(input: {
         new Blob([], { type: meta.mimeType }),
         input.authToken,
       );
-      verifyFinalizeReceipt(receipt, meta);
+      const receiptStatus = verifyFinalizeReceipt(receipt, meta);
+      if (receiptStatus === "processing") {
+        scheduleBrowserBackupCleanupAfterProcessing({
+          serverUrl: meta.serverUrl,
+          recordingId: meta.recordingId,
+          authToken: input.authToken,
+        });
+        return {
+          recordingId: meta.recordingId,
+          viewUrl: `/r/${meta.recordingId}`,
+        };
+      }
     } catch (err) {
       if (
-        await recoverReadyRecordingAfterFinalizeError({
+        await recoverAcceptedRecordingAfterFinalizeError({
           serverUrl: meta.serverUrl,
           recordingId: meta.recordingId,
           authToken: input.authToken,
@@ -1143,6 +1225,7 @@ interface NativeFullscreenUploadResult {
   durationMs: number;
   width?: number;
   height?: number;
+  verificationPending?: boolean;
 }
 
 interface NativeFullscreenSaveResult {
@@ -2490,7 +2573,7 @@ async function startNativeFullscreenRecording(
             uploadResult = await uploadPromise;
           } catch (err) {
             if (
-              await recoverReadyRecordingAfterFinalizeError({
+              await recoverAcceptedRecordingAfterFinalizeError({
                 serverUrl: params.serverUrl,
                 recordingId: id,
                 authToken: params.authToken,
@@ -2505,6 +2588,13 @@ async function startNativeFullscreenRecording(
             );
             throw err;
           }
+          if (uploadResult.verificationPending) {
+            scheduleNativeBackupCleanupAfterProcessing({
+              serverUrl: params.serverUrl,
+              recordingId: id,
+              authToken: params.authToken,
+            });
+          }
           const transcriptSaved = await transcriptSavePromise;
           if (!transcriptSaved && capturedTranscript?.text.trim()) {
             // The first write runs in parallel with native upload. Retry once
@@ -3878,15 +3968,23 @@ async function startRecordingInner(
             const receipt = bodyText
               ? (JSON.parse(bodyText) as FinalizeReceipt)
               : null;
-            verifyFinalizeReceipt(receipt, {
+            const receiptStatus = verifyFinalizeReceipt(receipt, {
               bytes: backupBytes,
               durationMs,
             });
+            if (receiptStatus === "processing") {
+              scheduleBrowserBackupCleanupAfterProcessing({
+                serverUrl: params.serverUrl,
+                recordingId: id,
+                authToken: params.authToken,
+              });
+              return { recordingId: id, viewUrl };
+            }
           } catch (err) {
             console.error("[clips-recorder] finalize fetch failed:", err);
             const error = err instanceof Error ? err : new Error(String(err));
             if (
-              await recoverReadyRecordingAfterFinalizeError({
+              await recoverAcceptedRecordingAfterFinalizeError({
                 serverUrl: params.serverUrl,
                 recordingId: id,
                 authToken: params.authToken,

package/corpus/templates/clips/desktop/src/lib/upload-verification.ts

@@ -2,6 +2,7 @@ export interface FinalizeReceipt {
   ok?: unknown;
   finalized?: unknown;
   status?: unknown;
+  verificationPending?: unknown;
   sourceSizeBytes?: unknown;
   durationMs?: unknown;
 }
@@ -11,16 +12,22 @@ export interface LocalRecordingProof {
   durationMs: number;
 }
 
+export type FinalizeReceiptStatus = "processing" | "ready";
+
 export function verifyFinalizeReceipt(
   receipt: FinalizeReceipt | null,
   local: LocalRecordingProof,
-): void {
-  if (
-    !receipt ||
-    receipt.ok !== true ||
-    receipt.finalized !== true ||
-    receipt.status !== "ready"
-  ) {
+): FinalizeReceiptStatus {
+  const ready =
+    receipt?.ok === true &&
+    receipt.finalized === true &&
+    receipt.status === "ready";
+  const processing =
+    receipt?.ok === true &&
+    receipt.finalized === false &&
+    receipt.status === "processing" &&
+    receipt.verificationPending === true;
+  if (!ready && !processing) {
     throw new Error(
       "Clip may be incomplete. Finalization was not confirmed; the local backup was kept.",
     );
@@ -48,4 +55,6 @@ export function verifyFinalizeReceipt(
       "Clip may be incomplete. The uploaded duration did not match the local recording; the local backup was kept.",
     );
   }
+
+  return ready ? "ready" : "processing";
 }

package/corpus/templates/clips/desktop/src-tauri/src/lib.rs

@@ -249,8 +249,7 @@ pub fn run() {
                 use tauri_plugin_deep_link::DeepLinkExt;
                 let dl_handle = app.handle().clone();
                 app.deep_link().on_open_url(move |event| {
-                    let urls: Vec<String> =
-                        event.urls().iter().map(|u| u.to_string()).collect();
+                    let urls: Vec<String> = event.urls().iter().map(|u| u.to_string()).collect();
                     dlog!("[clips-tray] deep link opened: {:?}", urls);
                     present_popover(&dl_handle);
                     let _ = dl_handle.emit("clips:deep-link", urls);
@@ -263,8 +262,7 @@ pub fn run() {
                 // arguments rather than an on_open_url event. Consume it here so
                 // the popover appears and the browser does not hit its fallback.
                 if let Ok(Some(urls)) = app.deep_link().get_current() {
-                    let url_strings: Vec<String> =
-                        urls.iter().map(|u| u.to_string()).collect();
+                    let url_strings: Vec<String> = urls.iter().map(|u| u.to_string()).collect();
                     dlog!("[clips-tray] deep link cold start: {:?}", url_strings);
                     present_popover(app.handle());
                     let _ = app.handle().emit("clips:deep-link", url_strings);