@agent-native/core 0.117.1 → 0.118.0

package/corpus/templates/clips/changelog/2026-07-22-manage-agent-navigation-now-uses-the-connected-nodes-icon.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-22
+---
+
+Manage agent navigation now uses the connected-nodes icon.

package/corpus/templates/clips/changelog/2026-07-22-permissions-and-rewind-controls-are-now-grouped-with-clearer.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-22
+---
+
+Permissions and Rewind controls are now grouped with clearer aligned actions.

package/corpus/templates/clips/changelog/2026-07-22-quieter-permissions-and-rewind-controls.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-22
+---
+
+Permissions and Rewind now use quieter expandable rows with clearer setup guidance.

package/corpus/templates/clips/changelog/2026-07-22-the-desktop-popover-opens-centered-under-the-menu-bar-icon-o.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-22
+---
+
+The desktop popover opens centered under the menu bar icon on first launch

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

@@ -2,6 +2,8 @@ import {
   IconAlertTriangle,
   IconArrowLeft,
   IconCalendarEvent,
+  IconChevronDown,
+  IconChevronRight,
   IconCircleCheck,
   IconCopy,
   IconDownload,
@@ -345,6 +347,8 @@ const CAM_ON_KEY = "clips:camera-on";
 const MIC_ON_KEY = "clips:mic-on";
 const SYSTEM_AUDIO_KEY = "clips:system-audio";
 const READINESS_REVIEWED_KEY = "clips:readiness-reviewed";
+const REWIND_DOCS_URL =
+  "https://www.agent-native.com/docs/template-clips#agent-readable-clips";
 
 // Sensible defaults so the user never has to type a URL on first launch.
 // Dev builds point at the local dev server; production builds point at the
@@ -936,6 +940,7 @@ export function App() {
   const [readinessOpen, setReadinessOpen] = useState<boolean>(
     () => !loadBool(READINESS_REVIEWED_KEY, false),
   );
+  const [rewindHomeOpen, setRewindHomeOpen] = useState(false);
   const [recorder, setRecorder] = useState<RecorderHandle | null>(null);
   const [recError, setRecError] = useState<string | null>(null);
   const [cameraError, setCameraError] = useState<string | null>(null);
@@ -969,6 +974,9 @@ export function App() {
     config: featureConfig?.screenMemory ?? DEFAULT_SCREEN_MEMORY_CONFIG,
     clipRecordingActive: isRecording || recordingFlowActive,
   });
+  const homeRewindOn =
+    featureConfig?.screenMemory?.enabled === true &&
+    featureConfig.screenMemory.paused !== true;
   const refreshHomeScreenMemoryStatus = useCallback(() => {
     const version = ++homeScreenMemoryRefreshVersionRef.current;
     invoke<ScreenMemoryStatus>("screen_memory_status")
@@ -2551,6 +2559,12 @@ export function App() {
     });
   }
 
+  function openRewindDocs() {
+    openExternal(REWIND_DOCS_URL).catch((err) => {
+      console.error("[clips-tray] open Rewind docs failed:", err);
+    });
+  }
+
   async function retryPendingUpload(upload: PendingDesktopUpload) {
     if (retryingUploadId || exportingUploadId || dismissingUploadId) return;
     const targetServerUrl = serverUrlForPendingUpload(upload, serverUrl);
@@ -3668,71 +3682,95 @@ export function App() {
           />
         </div>
 
-        <ReadinessPanel
-          mode={mode}
-          cameraOn={cameraOn}
-          micOn={micOn}
-          includeVoicePaste={voiceDictationEnabled}
-          includeFnMonitoring={fnShortcutEnabled}
-          open={readinessOpen}
-          onOpenChange={updateReadinessOpen}
-          onOpenPermission={openPrivacySettings}
-        />
+        <div className="recorder-disclosures">
+          <ReadinessPanel
+            mode={mode}
+            cameraOn={cameraOn}
+            micOn={micOn}
+            includeVoicePaste={voiceDictationEnabled}
+            includeFnMonitoring={fnShortcutEnabled}
+            open={readinessOpen}
+            onOpenChange={updateReadinessOpen}
+            onOpenPermission={openPrivacySettings}
+          />
 
-        <section className="rewind-home-card" aria-label="Rewind status">
-          <div className="rewind-home-status">
-            <span
-              className={`rewind-home-dot ${homeRewindPresentation.isLive ? "is-live" : ""}`}
-            />
-            <div>
-              <strong>{homeRewindPresentation.title}</strong>
-              {!homeRewindPresentation.isLive ||
-              homeRewindPresentation.hasError ? (
-                <p>{homeRewindPresentation.detail}</p>
-              ) : null}
-            </div>
-            <div className="rewind-home-controls">
-              <button
-                type="button"
-                className="rewind-agent-prompt-copy"
-                onClick={() => void copyRewindAgentPrompt()}
-                aria-label={
-                  rewindAgentPromptCopied
-                    ? "Setup prompt copied — paste it into your agent once"
-                    : "Set up your agent"
-                }
-                title={
-                  rewindAgentPromptCopied
-                    ? "Setup prompt copied — paste it into your agent once"
-                    : "Set up your agent"
-                }
-              >
-                {rewindAgentPromptCopied ? (
-                  <IconCircleCheck size={15} stroke={2} />
+          <section className="rewind-home-card" aria-label="Rewind">
+            <button
+              type="button"
+              className="rewind-home-summary"
+              aria-expanded={rewindHomeOpen}
+              onClick={() => setRewindHomeOpen((open) => !open)}
+            >
+              <span className="rewind-home-title">Rewind</span>
+              <span className="rewind-home-state">
+                {homeRewindOn ? "On" : "Off"}
+                {rewindHomeOpen ? (
+                  <IconChevronDown size={11} stroke={2} />
                 ) : (
-                  <IconCopy size={15} stroke={1.9} />
+                  <IconChevronRight size={11} stroke={2} />
                 )}
-              </button>
-              <Switch
-                on={
-                  featureConfig?.screenMemory?.enabled === true &&
-                  featureConfig.screenMemory.paused !== true
-                }
-                disabled={
-                  homeScreenMemoryBusy || isRecording || recordingFlowActive
-                }
-                onChange={(remembering) =>
-                  void setHomeRewindRemembering(remembering)
-                }
-                label={
-                  featureConfig?.screenMemory?.enabled === true
-                    ? "Remember with Rewind"
-                    : "Set up Rewind"
-                }
-              />
-            </div>
-          </div>
-        </section>
+              </span>
+            </button>
+            {rewindHomeOpen ? (
+              <div className="rewind-home-details">
+                <p>{homeRewindPresentation.detail}</p>
+                <div className="rewind-home-detail-actions">
+                  <button
+                    type="button"
+                    className="rewind-docs-link"
+                    onClick={openRewindDocs}
+                  >
+                    Learn about Rewind
+                    <IconExternalLink size={13} stroke={1.9} />
+                  </button>
+                  <div className="rewind-home-controls">
+                    <Tooltip>
+                      <TooltipTrigger asChild>
+                        <button
+                          type="button"
+                          className="rewind-agent-prompt-copy"
+                          onClick={() => void copyRewindAgentPrompt()}
+                          aria-label={
+                            rewindAgentPromptCopied
+                              ? "Setup prompt copied — paste it into your agent once"
+                              : "Copy setup prompt for your agent"
+                          }
+                        >
+                          {rewindAgentPromptCopied ? (
+                            <IconCircleCheck size={15} stroke={2} />
+                          ) : (
+                            <IconCopy size={15} stroke={1.9} />
+                          )}
+                        </button>
+                      </TooltipTrigger>
+                      <TooltipContent>
+                        {rewindAgentPromptCopied
+                          ? "Setup prompt copied"
+                          : "Copy setup prompt for your agent"}
+                      </TooltipContent>
+                    </Tooltip>
+                    <Switch
+                      on={homeRewindOn}
+                      disabled={
+                        homeScreenMemoryBusy ||
+                        isRecording ||
+                        recordingFlowActive
+                      }
+                      onChange={(remembering) =>
+                        void setHomeRewindRemembering(remembering)
+                      }
+                      label={
+                        featureConfig?.screenMemory?.enabled === true
+                          ? "Remember with Rewind"
+                          : "Set up Rewind"
+                      }
+                    />
+                  </div>
+                </div>
+              </div>
+            ) : null}
+          </section>
+        </div>
 
         {!isRecording ? (
           <button

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

@@ -0,0 +1,31 @@
+import { invoke } from "@tauri-apps/api/core";
+
+export interface DismissibleMeetingNotification {
+  type: "calendar" | "adhoc";
+  meetingId: string;
+  platform?: string | null;
+  scheduledStart?: string | null;
+  scheduledEnd?: string | null;
+}
+
+type NativeInvoke = (
+  command: string,
+  args: Record<string, unknown>,
+) => Promise<unknown>;
+
+export async function dismissMeetingNotification(
+  notification: DismissibleMeetingNotification,
+  nativeInvoke: NativeInvoke = invoke,
+): Promise<void> {
+  try {
+    await nativeInvoke("dismiss_meeting_notification", {
+      meetingId: notification.meetingId,
+      notificationType: notification.type,
+      platform: notification.platform ?? null,
+      scheduledStart: notification.scheduledStart ?? null,
+      scheduledEnd: notification.scheduledEnd ?? null,
+    });
+  } catch (error) {
+    console.warn("[clips-meeting-notif] dismissal sync failed", error);
+  }
+}

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

@@ -114,7 +114,6 @@ const LIVE_UPLOAD_CHUNK_MS = 2_000;
 const NATIVE_FULLSCREEN_SEGMENT_MS = 5 * 60_000;
 const NATIVE_FULLSCREEN_MIME_TYPE = "video/mp4";
 const MEDIA_RECORDER_STOP_TIMEOUT_MS = 15_000;
-const THUMBNAIL_UPLOAD_TIMEOUT_MS = 8_000;
 // GCS resumable uploads require every non-final chunk to be a multiple of
 // 256 KiB. MediaRecorder emits arbitrary blob sizes, so on the streaming path
 // we buffer raw blobs and only PUT aligned slices; the unaligned remainder is
@@ -1462,146 +1461,6 @@ async function saveRecordingTranscriptFailure(
   }
 }
 
-const THUMBNAIL_PROBE_WIDTH = 40;
-const THUMBNAIL_MIN_MEAN_LUMA = 8;
-const THUMBNAIL_MIN_MAX_LUMA = 28;
-const THUMBNAIL_MIN_VISIBLE_PIXEL_RATIO = 0.005;
-
-function canvasHasVisibleContent(canvas: HTMLCanvasElement): boolean {
-  if (!canvas.width || !canvas.height) return false;
-
-  const width = THUMBNAIL_PROBE_WIDTH;
-  const height = Math.max(
-    1,
-    Math.round((canvas.height / canvas.width) * width),
-  );
-  const probe = document.createElement("canvas");
-  probe.width = width;
-  probe.height = height;
-
-  const ctx = probe.getContext("2d", { willReadFrequently: true });
-  if (!ctx) return true;
-
-  try {
-    ctx.drawImage(canvas, 0, 0, width, height);
-    const data = ctx.getImageData(0, 0, width, height).data;
-    let totalLuma = 0;
-    let maxLuma = 0;
-    let visiblePixels = 0;
-    const pixels = data.length / 4;
-
-    for (let i = 0; i < data.length; i += 4) {
-      const alpha = data[i + 3] / 255;
-      const luma =
-        (0.2126 * data[i] + 0.7152 * data[i + 1] + 0.0722 * data[i + 2]) *
-        alpha;
-      totalLuma += luma;
-      maxLuma = Math.max(maxLuma, luma);
-      if (luma >= THUMBNAIL_MIN_MAX_LUMA) visiblePixels++;
-    }
-
-    const meanLuma = totalLuma / Math.max(1, pixels);
-    const visibleRatio = visiblePixels / Math.max(1, pixels);
-    return (
-      meanLuma >= THUMBNAIL_MIN_MEAN_LUMA ||
-      (maxLuma >= THUMBNAIL_MIN_MAX_LUMA &&
-        visibleRatio >= THUMBNAIL_MIN_VISIBLE_PIXEL_RATIO)
-    );
-  } catch {
-    return true;
-  }
-}
-
-async function waitForVideoDimensions(
-  video: HTMLVideoElement,
-  timeoutMs = 1600,
-): Promise<boolean> {
-  const startedAt = Date.now();
-  while (Date.now() - startedAt < timeoutMs) {
-    if (video.videoWidth > 0 && video.videoHeight > 0) return true;
-    await new Promise((resolve) => window.setTimeout(resolve, 80));
-  }
-  return video.videoWidth > 0 && video.videoHeight > 0;
-}
-
-async function captureStreamThumbnailBlob(
-  stream: MediaStream | null,
-): Promise<Blob | null> {
-  if (!stream?.getVideoTracks().some((track) => track.readyState === "live")) {
-    return null;
-  }
-
-  const video = document.createElement("video");
-  video.muted = true;
-  video.playsInline = true;
-  video.autoplay = true;
-  video.srcObject = stream;
-  video.style.position = "fixed";
-  video.style.left = "-10000px";
-  video.style.top = "0";
-  video.style.width = "1px";
-  video.style.height = "1px";
-  video.style.opacity = "0";
-
-  try {
-    document.body.appendChild(video);
-    await video.play().catch(() => {});
-    if (!(await waitForVideoDimensions(video))) return null;
-
-    const canvas = document.createElement("canvas");
-    canvas.width = video.videoWidth;
-    canvas.height = video.videoHeight;
-    const ctx = canvas.getContext("2d");
-    if (!ctx) return null;
-
-    ctx.drawImage(video, 0, 0, canvas.width, canvas.height);
-    if (!canvasHasVisibleContent(canvas)) return null;
-
-    return await new Promise<Blob | null>((resolve) => {
-      canvas.toBlob((blob) => resolve(blob), "image/jpeg", 0.85);
-    });
-  } finally {
-    video.pause();
-    video.srcObject = null;
-    video.remove();
-  }
-}
-
-async function captureAndUploadRecordingThumbnail(params: {
-  serverUrl: string;
-  recordingId: string;
-  stream: MediaStream | null;
-  authToken?: string;
-}): Promise<void> {
-  const blob = await captureStreamThumbnailBlob(params.stream);
-  if (!blob) {
-    console.warn("[clips-recorder] no visible thumbnail frame captured");
-    return;
-  }
-
-  const url = `${params.serverUrl.replace(
-    /\/+$/,
-    "",
-  )}/api/recordings/${params.recordingId}/thumbnail`;
-  const res = await fetch(url, {
-    method: "POST",
-    headers: buildRetryHeaders(blob.type || "image/jpeg", params.authToken),
-    credentials: "include",
-    body: blob,
-    signal: AbortSignal.timeout(THUMBNAIL_UPLOAD_TIMEOUT_MS),
-  });
-  if (!res.ok) {
-    const body = await res.text().catch(() => "");
-    throw new Error(
-      `Thumbnail upload failed (${res.status}): ${body.slice(0, 200)}`,
-    );
-  }
-  console.log("[clips-recorder] thumbnail uploaded", {
-    recordingId: params.recordingId,
-    bytes: blob.size,
-  });
-}
-
 /**
  * Counter of in-flight chunk POSTs. The bubble frame pump reads
  * `window.clipsChunkBusy` and SKIPS frame encoding while it's truthy,
@@ -3120,18 +2979,8 @@ async function startNativeFullscreenRecording(
               err,
             ),
           );
-          await invoke("native_fullscreen_capture_thumbnail", {
-            serverUrl: params.serverUrl,
-            recordingId: id,
-            authToken: params.authToken ?? "",
-            cookie: params.cookie ?? "",
-          }).catch((err) => {
-            console.warn(
-              "[clips-recorder] native thumbnail capture/upload failed:",
-              err,
-            );
-          });
-
+          // The owner player captures the poster from decoded recording media.
+          // Never screen-capture this post-stop window: it may show upload UI.
           try {
             uploadResult = await uploadPromise;
           } catch (err) {
@@ -4294,8 +4143,8 @@ async function startRecordingInner(
       stopped = true;
       // Stamped right after the recorder fully stops below (see stoppedAt).
       // Duration must measure recorded content — through the final flushed
-      // chunk — but NOT the transcript-finalize + thumbnail + upload awaits that
-      // follow, which add ~seconds and would overstate the saved duration.
+      // chunk — but NOT the transcript-finalize + upload awaits that follow,
+      // which add ~seconds and would overstate the saved duration.
       let stoppedAt = 0;
       const viewUrl = `/r/${id}`;
       const absoluteViewUrl = `${params.serverUrl.replace(/\/+$/, "")}${viewUrl}`;
@@ -4412,18 +4261,6 @@ async function startRecordingInner(
       }
 
       if (!recorderStopTimedOut) {
-        void captureAndUploadRecordingThumbnail({
-          serverUrl: params.serverUrl,
-          recordingId: id,
-          stream: primaryVideo,
-          authToken: params.authToken,
-        }).catch((err) => {
-          console.warn(
-            "[clips-recorder] thumbnail capture/upload failed:",
-            err,
-          );
-        });
-
         const capturedTranscript = await transcriptionCapture
           ?.stop()
           .catch((err) => {

package/corpus/templates/clips/desktop/src/overlays/meeting-notification.tsx

@@ -11,6 +11,7 @@ import { emit, listen } from "@tauri-apps/api/event";
 import { getCurrentWindow } from "@tauri-apps/api/window";
 import { useEffect, useRef, useState } from "react";
 
+import { dismissMeetingNotification } from "../lib/meeting-notification-dismissal";
 import {
   detectMeetingJoinProvider,
   joinProviderLabel,
@@ -308,6 +309,14 @@ export function MeetingNotification() {
     dataRef.current = null;
   }
 
+  function dismissNotification() {
+    const current = dataRef.current;
+    hideNotification();
+    if (current) {
+      void dismissMeetingNotification(current);
+    }
+  }
+
   async function takeNotes() {
     if (!data || pending) return;
     setPending(true);
@@ -447,7 +456,7 @@ export function MeetingNotification() {
         {showClose ? (
           <button
             className="meeting-notification-close"
-            onClick={hideNotification}
+            onClick={dismissNotification}
             aria-label="Dismiss"
             data-no-drag
           >