@agent-native/core 0.114.5 → 0.114.7

package/corpus/templates/clips/desktop/src/lib/rewind-agent-prompt.ts

@@ -0,0 +1,9 @@
+export const REWIND_AGENT_PROMPT = `Set up Agent Native Rewind for this agent once so I can later say things like “Look at Rewind” or “What did I just say?” without pasting setup instructions again.
+
+Install or refresh the public Rewind skill and its local Clips Screen Memory MCP connection with:
+
+\`npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes\`
+
+Replace \`<client>\` with the compatible host you are running in: \`codex\`, \`claude-code\`, \`cursor\`, \`opencode\`, \`github-copilot\`, or \`cowork\`. Run the command yourself if you have shell access. Ask me to restart the host only if it cannot reload MCP servers in place, then verify the connection with \`screen_memory_status\`.
+
+If this host cannot install skills or MCP servers, explain that limitation clearly. For this request only, use any already-configured Screen Memory tools with the same local-first boundaries: search chapters before raw context, read the smallest relevant range, flag uncertainty, inspect local frames before escalation, never crawl Clips' archive paths, and request a bounded private Clip only when local evidence is insufficient.`;

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

@@ -0,0 +1,20 @@
+export interface RewindRecordingStartPhases<TPrepared, TStarted> {
+  prepare(): Promise<TPrepared>;
+  countdown(): Promise<void>;
+  activate(prepared: TPrepared): Promise<TStarted>;
+  onActivated?(): void;
+}
+
+/**
+ * Keep setup work ahead of the numeric countdown so zero is a media boundary,
+ * not the beginning of another asynchronous setup pipeline.
+ */
+export async function prepareRewindRecordingStart<TPrepared, TStarted>(
+  phases: RewindRecordingStartPhases<TPrepared, TStarted>,
+): Promise<TStarted> {
+  const prepared = await phases.prepare();
+  await phases.countdown();
+  const started = await phases.activate(prepared);
+  phases.onActivated?.();
+  return started;
+}

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

@@ -11,6 +11,7 @@ import { FlowBar } from "./overlays/flow-bar";
 import { MeetingNotification } from "./overlays/meeting-notification";
 import { MeetingNub } from "./overlays/meeting-nub";
 import { Onboarding } from "./overlays/onboarding";
+import { Preparing } from "./overlays/preparing";
 import { RecordingPill } from "./overlays/recording-pill";
 import { RegionGuideEditor, RegionGuides } from "./overlays/region-guides";
 import { RegionRecordBorder } from "./overlays/region-record-border";
@@ -43,6 +44,8 @@ function pickRoute(route: string): React.ReactElement {
       return <Bubble />;
     case "finalizing":
       return <Finalizing />;
+    case "preparing":
+      return <Preparing />;
     case "onboarding":
       return <Onboarding />;
     case "meeting-notif":

package/corpus/templates/clips/desktop/src/overlays/countdown.tsx

@@ -15,16 +15,17 @@ export function Countdown() {
   const closingRef = useRef(false);
 
   const closeWithEvent = useCallback(
-    (eventName: "clips:countdown-done" | "clips:countdown-cancel") => {
+    (
+      eventName: "clips:countdown-done" | "clips:countdown-cancel",
+      cause: "escape" | "return" | "button" | "timer",
+    ) => {
       if (closingRef.current) return;
       closingRef.current = true;
-      emit(eventName)
-        .finally(() => emit("clips:countdown-shortcuts-active", false))
-        .finally(() => {
-          getCurrentWindow()
-            .close()
-            .catch(() => {});
-        });
+      emit(eventName, { cause }).finally(() => {
+        getCurrentWindow()
+          .close()
+          .catch(() => {});
+      });
     },
     [],
   );
@@ -33,22 +34,21 @@ export function Countdown() {
     const onKeyDown = (event: KeyboardEvent) => {
       if (event.key === "Escape") {
         event.preventDefault();
-        closeWithEvent("clips:countdown-cancel");
+        closeWithEvent("clips:countdown-cancel", "escape");
       } else if (event.key === "Enter") {
         event.preventDefault();
-        closeWithEvent("clips:countdown-done");
+        closeWithEvent("clips:countdown-done", "return");
       }
     };
     window.addEventListener("keydown", onKeyDown);
     return () => {
       window.removeEventListener("keydown", onKeyDown);
-      emit("clips:countdown-shortcuts-active", false).catch(() => {});
     };
   }, [closeWithEvent]);
 
   useEffect(() => {
     if (n <= 0) {
-      closeWithEvent("clips:countdown-done");
+      closeWithEvent("clips:countdown-done", "timer");
       return;
     }
     const t = setTimeout(() => setN((v) => v - 1), COUNTDOWN_STEP_MS);
@@ -62,7 +62,7 @@ export function Countdown() {
           type="button"
           className="countdown-control countdown-control-cancel"
           aria-label="Cancel recording"
-          onClick={() => closeWithEvent("clips:countdown-cancel")}
+          onClick={() => closeWithEvent("clips:countdown-cancel", "button")}
         >
           <IconX size={30} stroke={2.4} />
         </button>
@@ -75,7 +75,7 @@ export function Countdown() {
           type="button"
           className="countdown-control countdown-control-skip"
           aria-label="Skip countdown and start recording now"
-          onClick={() => closeWithEvent("clips:countdown-done")}
+          onClick={() => closeWithEvent("clips:countdown-done", "button")}
         >
           <IconPlayerSkipForwardFilled size={28} />
         </button>

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

@@ -9,16 +9,15 @@ import { invoke } from "@tauri-apps/api/core";
 import { LogicalSize } from "@tauri-apps/api/dpi";
 import { emit, listen } from "@tauri-apps/api/event";
 import { getCurrentWindow } from "@tauri-apps/api/window";
-import { open as openExternal } from "@tauri-apps/plugin-shell";
 import { useEffect, useRef, useState } from "react";
 
-import { resolveDesktopMeetingJoinUrl } from "../lib/meeting-join-url";
 import {
   detectMeetingJoinProvider,
   joinProviderLabel,
   meetingNotificationAutoHideMs,
   type MeetingJoinProvider,
 } from "../lib/meeting-notification-timing";
+import { openMeetingJoinUrl } from "../lib/open-meeting-join-url";
 
 interface NotificationData {
   type: "calendar" | "adhoc";
@@ -51,7 +50,7 @@ const NOTIFICATION_MENU_HEIGHT = 224;
 async function openJoinUrl(url: string | null | undefined): Promise<void> {
   if (!url) return;
   try {
-    await openExternal(resolveDesktopMeetingJoinUrl(url));
+    await openMeetingJoinUrl(url);
   } catch (err) {
     console.error("[clips-tray] openJoinUrl failed:", err);
   }

package/corpus/templates/clips/desktop/src/overlays/onboarding.tsx

@@ -56,13 +56,13 @@ const PERMISSION_CARDS: Array<{
 // fails — same URLs the main app window uses.
 const MACOS_PRIVACY_URLS: Record<PermissionPane, string> = {
   microphone:
-    "x-apple.systempreferences:com.apple.preference.security?Privacy_Microphone",
+    "x-apple.systempreferences:com.apple.settings.PrivacySecurity.extension?Privacy_Microphone",
   speech:
-    "x-apple.systempreferences:com.apple.preference.security?Privacy_SpeechRecognition",
+    "x-apple.systempreferences:com.apple.settings.PrivacySecurity.extension?Privacy_SpeechRecognition",
   accessibility:
-    "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility",
+    "x-apple.systempreferences:com.apple.settings.PrivacySecurity.extension?Privacy_Accessibility",
   "input-monitoring":
-    "x-apple.systempreferences:com.apple.preference.security?Privacy_ListenEvent",
+    "x-apple.systempreferences:com.apple.settings.PrivacySecurity.extension?Privacy_ListenEvent",
 };
 
 function openPermissionSettings(pane: PermissionPane): void {

package/corpus/templates/clips/desktop/src/overlays/preparing.tsx

@@ -0,0 +1,13 @@
+/** Visible readiness state shown while the shared Rewind Clip writer and
+ * resumable upload session are prepared. The numeric countdown replaces it
+ * only after zero can be an immediate media boundary. */
+export function Preparing() {
+  return (
+    <div className="preparing-root">
+      <div className="preparing-card" role="status" aria-live="polite">
+        <div className="preparing-spinner" aria-hidden="true" />
+        <span>Preparing recording…</span>
+      </div>
+    </div>
+  );
+}

package/corpus/templates/clips/desktop/src/overlays/toolbar.tsx

@@ -6,6 +6,7 @@ import {
   IconRefresh,
   IconTrash,
 } from "@tabler/icons-react";
+import { invoke } from "@tauri-apps/api/core";
 import { LogicalSize } from "@tauri-apps/api/dpi";
 import { emit, listen } from "@tauri-apps/api/event";
 import { getCurrentWindow } from "@tauri-apps/api/window";
@@ -58,6 +59,8 @@ export function Toolbar() {
   // Stop / Pause are disabled until the recorder actually begins, at which
   // point `clips:toolbar-enabled` fires with `true` from the recorder.
   const [enabled, setEnabled] = useState(false);
+  const [preparing, setPreparing] = useState(false);
+  const [popoverVisible, setPopoverVisible] = useState(true);
   const [diskSpaceLevel, setDiskSpaceLevel] = useState<
     "ok" | "warning" | "critical"
   >("ok");
@@ -121,6 +124,7 @@ export function Toolbar() {
     trackListen(
       listen<boolean>("clips:toolbar-enabled", (ev) => {
         setEnabled(!!ev.payload);
+        setPreparing(false);
         setPendingAction(null);
         if (!ev.payload) {
           setDiskSpaceLevel("ok");
@@ -129,6 +133,16 @@ export function Toolbar() {
         }
       }),
     );
+    trackListen(
+      listen<boolean>("clips:toolbar-preparing", (ev) => {
+        setPreparing(!!ev.payload);
+      }),
+    );
+    trackListen(
+      listen<boolean>("clips:popover-visible", (ev) => {
+        setPopoverVisible(!!ev.payload);
+      }),
+    );
     trackListen(
       listen<{ freeMb: number }>("clips:disk-space-warning", () => {
         setDiskSpaceLevel((prev) =>
@@ -205,6 +219,8 @@ export function Toolbar() {
     // left with a zombie pill floating over their screen. The recorder
     // closing us first is a no-op on the already-closed window.
   }
+
+  const isPreparing = preparing || (!enabled && !popoverVisible);
   function togglePause() {
     if (!enabled || pendingAction) return;
     const transition = paused ? "resume" : "pause";
@@ -319,13 +335,22 @@ export function Toolbar() {
           }
           data-no-drag
         >
-          {pendingAction === "stop" ? (
+          {pendingAction === "stop" || isPreparing ? (
             <IconLoader2 className="toolbar-v-spinner" size={18} />
           ) : (
             <span className="toolbar-v-stop-square" />
           )}
         </button>
-        <div className="toolbar-v-time">{formatTime(elapsed)}</div>
+        <button
+          type="button"
+          className={`toolbar-v-time ${isPreparing ? "toolbar-v-time-preparing" : ""}`}
+          onClick={() => invoke("show_popover").catch(() => {})}
+          aria-label="Open Clips"
+          title="Open Clips"
+          data-no-drag
+        >
+          {isPreparing ? "Preparing…" : formatTime(elapsed)}
+        </button>
         {diskSpaceLevel !== "ok" && (
           <div
             className={`toolbar-v-disk-indicator toolbar-v-disk-indicator-${diskSpaceLevel}`}

package/corpus/templates/clips/desktop/src/shared/config.ts

@@ -3,6 +3,12 @@ import { listen } from "@tauri-apps/api/event";
 import { useState, useEffect } from "react";
 
 export type LocalRecordingMode = "off" | "composed" | "separate";
+export type RewindCaptureMode = "visuals" | "visuals-audio";
+export type RewindAgentClipRetention =
+  | "forever"
+  | "24-hours"
+  | "7-days"
+  | "30-days";
 
 export interface RegionGuideRect {
   id: string;
@@ -25,6 +31,12 @@ export interface ScreenMemoryConfig {
   maxBytes: number;
   segmentSeconds: number;
   sampleIntervalSeconds: number;
+  captureMode: RewindCaptureMode;
+  reviewBeforeSending: boolean;
+  autoPreviewBeforeSending: boolean;
+  agentClipRetention: RewindAgentClipRetention;
+  excludedBundleIds: string[];
+  excludePrivateWindows: boolean;
 }
 
 export type ScreenMemoryRuntimeState =
@@ -44,6 +56,8 @@ export interface ScreenMemorySegmentMetadata {
   width?: number | null;
   height?: number | null;
   bytes: number;
+  systemAudioPath?: string | null;
+  microphonePath?: string | null;
   corrupt: boolean;
   error?: string | null;
 }
@@ -66,6 +80,8 @@ export interface ScreenMemoryStatus {
   activeSegment?: ScreenMemoryActiveSegment | null;
   recentSegments: ScreenMemorySegmentMetadata[];
   lastError?: string | null;
+  exclusionActive: boolean;
+  coverage: string;
 }
 
 export interface ScreenMemoryDeleteResult {