@agent-native/core 0.161.16 → 0.161.20

package/corpus/templates/clips/.agents/skills/secrets/SKILL.md

@@ -3,8 +3,8 @@ name: secrets
 description: >-
   Declaratively register API keys and service credentials a template needs so
   they appear in the agent sidebar settings UI and the onboarding checklist.
-  Use for any third-party API key (OpenAI, Stripe, Twilio, etc.) and for
-  surfacing OAuth connections in the unified settings UI.
+  Use before adding any third-party credential or setup UI so API keys, OAuth
+  connections, and scoped configuration use the correct shared primitive.
 scope: dev
 metadata:
   internal: true
@@ -24,6 +24,33 @@ encrypted `app_secrets` vault, `saveCredential` / `resolveCredential`, OAuth, or
 `${keys.NAME}` substitution. Examples must use obvious placeholders such as
 `<OPENAI_API_KEY>` or `${keys.SLACK_WEBHOOK}`, not real-looking copied values.
 
+## Credential Modeling Preflight
+
+Before registering a provider's fields, inspect the workspace/provider connection
+catalog first. If a reusable connection exists, use its app grant and scoped
+`resolveWorkspaceConnectionCredential(s)ForApp` path instead of registering a
+parallel secret. Only classify fields for app-local setup when no reusable
+connection exists:
+
+- **API or service key** - register it as `kind: "api-key"` with the narrowest
+  correct `scope`, a human label, a description, a docs link, and a validator.
+- **OAuth authorization or refresh token** - use the OAuth token store and
+  register a `kind: "oauth"` entry so the shared UI renders Connect and the
+  runtime owns status, refresh, and reauthorization.
+- **Deploy- or app-level configuration** - use deployment/runtime
+  configuration, not a per-user secret row.
+- **Account, customer, manager, or other non-secret identifier** - store it as
+  scoped connection metadata or app data, not as a masked secret field.
+
+`required: true` is for a logical setup requirement. If a provider needs
+several values, do not automatically create one required checklist item per
+field; use one composite onboarding step or a registered connection readiness
+check.
+
+Custom setup UI is allowed for provider-specific prerequisites, ordering, or
+health checks, but it must delegate credential storage and connection state to
+the shared vault/OAuth/settings surfaces.
+
 ## When to use
 
 Use this for any external credential your template needs: API keys, service

package/corpus/templates/clips/AGENTS.md

@@ -29,6 +29,7 @@ video sharing app. The agent and the UI share the same SQL data and actions.
 - Never hardcode API keys, tokens, webhook URLs, signing secrets, private
   Builder/internal data, customer data, or credential-looking literals. Use
   secrets/OAuth/runtime config and obvious placeholders.
+- For external integrations, inspect the workspace/provider connection catalog first; reuse its scoped resolver.
 - Use actions for recording metadata, transcripts, cleanup, summaries, chapters,
   comments, spaces/folders, meetings, and sharing. Never bypass access helpers.
 - Comment text accepts inline Markdown for emphasis, inline code, links, and

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

@@ -183,6 +183,8 @@ export interface VideoPlayerProps {
   defaultSpeed?: number;
   /** Autoplay on mount. */
   autoPlay?: boolean;
+  /** Persist resume position for an authenticated viewer. */
+  persistPlaybackPosition?: boolean;
   /** Start time in ms. */
   startMs?: number;
   /** Comment + chapter overlays for the scrubber. */
@@ -247,6 +249,7 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
       thumbnailUrl,
       defaultSpeed = 1.2,
       autoPlay,
+      persistPlaybackPosition = true,
       startMs,
       editsJson,
       comments,
@@ -520,6 +523,7 @@ export const VideoPlayer = forwardRef<VideoPlayerHandle, VideoPlayerProps>(
       recordingId,
       videoEl: playbackVideoEl,
       durationMs,
+      enabled: persistPlaybackPosition,
       explicitStartMs: startMs,
       allowRestoreWhilePlaying: autoPlay,
       onRestore: restorePlaybackPosition,

package/corpus/templates/clips/app/hooks/use-playback-position.ts

@@ -13,6 +13,7 @@ export interface UsePlaybackPositionOptions {
   recordingId: string;
   videoEl: HTMLVideoElement | null;
   durationMs: number;
+  enabled?: boolean;
   explicitStartMs?: number;
   allowRestoreWhilePlaying?: boolean;
   onRestore?: (positionMs: number) => void;
@@ -27,6 +28,7 @@ export function usePlaybackPosition({
   recordingId,
   videoEl,
   durationMs,
+  enabled = true,
   explicitStartMs,
   allowRestoreWhilePlaying = false,
   onRestore,
@@ -38,7 +40,7 @@ export function usePlaybackPosition({
   onRestoreRef.current = onRestore;
 
   useEffect(() => {
-    if (!videoEl || !recordingId) return;
+    if (!enabled || !videoEl || !recordingId) return;
 
     const controller = new AbortController();
     let cancelled = false;
@@ -184,5 +186,11 @@ export function usePlaybackPosition({
       window.removeEventListener("pagehide", onPageHide);
       document.removeEventListener("visibilitychange", onVisibilityChange);
     };
-  }, [allowRestoreWhilePlaying, explicitStartMs, recordingId, videoEl]);
+  }, [
+    allowRestoreWhilePlaying,
+    enabled,
+    explicitStartMs,
+    recordingId,
+    videoEl,
+  ]);
 }

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

@@ -236,6 +236,7 @@ export default function EmbedRoute() {
         videoFormat={recording.videoFormat}
         embedProvider={isLoomEmbedBacked ? "loom" : null}
         durationMs={recording.durationMs}
+        persistPlaybackPosition={false}
         editsJson={recording.editsJson}
         thumbnailUrl={recording.thumbnailUrl}
         defaultSpeed={parsePlaybackSpeed(recording.defaultSpeed) ?? 1.2}

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

@@ -187,6 +187,30 @@ function nativeSaveFailureMessage(reason: string | null | undefined): string {
   return "The desktop recorder finished and saved a local copy, but Clips could not upload it. You can retry from the Clips menu without recording again.";
 }
 
+export function BackToLibraryButton() {
+  const t = useT();
+  const navigate = useNavigate();
+
+  return (
+    <Tooltip>
+      <TooltipTrigger asChild>
+        <Button
+          variant="ghost"
+          size="icon"
+          className="shrink-0"
+          onClick={() => navigate("/library", { replace: true })}
+          aria-label={t("recordingPage.backToLibrary")}
+        >
+          <IconArrowLeft className="h-4 w-4 rtl:-scale-x-100" />
+        </Button>
+      </TooltipTrigger>
+      <TooltipContent side="bottom" align="start">
+        {t("recordingPage.backToLibrary")}
+      </TooltipContent>
+    </Tooltip>
+  );
+}
+
 function parseTimeParam(raw: string | null): number {
   if (!raw) return 0;
   const value = raw.trim();
@@ -965,17 +989,7 @@ export default function RecordingPage() {
       return (
         <div className="flex min-h-screen w-full flex-col bg-background">
           <header className="flex min-w-0 shrink-0 items-center gap-3 border-b border-border px-3 py-2 sm:px-4 sm:py-3">
-            <Button
-              asChild
-              variant="ghost"
-              size="icon"
-              className="shrink-0"
-              aria-label={t("recordingPage.backToLibrary")}
-            >
-              <Link to="/library" replace>
-                <IconArrowLeft className="h-4 w-4 rtl:-scale-x-100" />
-              </Link>
-            </Button>
+            <BackToLibraryButton />
             <div className="min-w-0 flex-1">
               <p className="truncate text-sm font-medium">{visibleTitle}</p>
               <p className="truncate text-xs text-muted-foreground">
@@ -1294,20 +1308,7 @@ export default function RecordingPage() {
       {/* Main video column */}
       <div className="flex w-full min-w-0 flex-col xl:flex-1">
         <header className="flex min-w-0 shrink-0 items-center gap-2 border-b border-border px-3 py-2 sm:gap-3 sm:px-4 sm:py-3">
-          <Button
-            asChild
-            variant="ghost"
-            size="icon"
-            className="shrink-0 sm:w-auto sm:px-2"
-            aria-label={t("recordingPage.backToLibrary")}
-          >
-            <Link to="/library" replace>
-              <IconArrowLeft className="h-4 w-4 rtl:-scale-x-100" />
-              <span className="hidden sm:inline">
-                {t("recordingPage.backToLibrary")}
-              </span>
-            </Link>
-          </Button>
+          <BackToLibraryButton />
           <div className="flex-1 min-w-0">
             <EditableRecordingTitle
               recordingId={recording.id}

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

@@ -1226,6 +1226,7 @@ export default function ShareRoute() {
               videoFormat={recording.videoFormat}
               embedProvider={isLoomEmbedBacked ? "loom" : null}
               durationMs={recording.durationMs}
+              persistPlaybackPosition={Boolean(session)}
               editsJson={recording.editsJson}
               thumbnailUrl={recording.thumbnailUrl}
               role={viewerRole ?? (viewerCanEdit ? "owner" : "viewer")}

package/corpus/templates/clips/changelog/2026-08-18-clips-no-longer-opens-welcome-window-on-first-launch.md

@@ -0,0 +1,6 @@
+---
+type: removed
+date: 2026-08-18
+---
+
+Clips no longer opens a welcome window on first launch.

package/corpus/templates/clips/changelog/2026-08-18-clips-now-recovers-interrupted-uploads-and-reliably-restarts.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-18
+---
+
+Clips now recovers interrupted uploads and reliably restarts after installing desktop updates.

package/corpus/templates/clips/changelog/2026-08-18-meeting-notifications-no-longer-show-decorative-left-side-lines.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-08-18
+---
+
+Meeting notifications no longer show decorative left-side lines.

package/corpus/templates/clips/changelog/2026-08-18-pending-recording-files-now-use-a-clips-prefixed-name.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-08-18
+---
+
+Pending recording files now use a Clips-prefixed name instead of a feature-ambiguous stem.

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

@@ -1,7 +1,10 @@
-import { relaunch } from "@tauri-apps/plugin-process";
+import { invoke } from "@tauri-apps/api/core";
+import { exit, relaunch } from "@tauri-apps/plugin-process";
 import { check, Update } from "@tauri-apps/plugin-updater";
 import { useEffect, useState } from "react";
 
+import { isMacPlatform } from "./platform";
+
 declare const __CLIPS_DESKTOP_LOCAL_BUILD__: boolean;
 
 export type UpdateStatus =
@@ -166,9 +169,26 @@ export async function installAndRestart(): Promise<void> {
   // bundle no longer matches the running process as short as possible — the
   // process is torn down by `relaunch()` right after, so capture never runs
   // against a swapped-out bundle.
+  const restartBundlePath = await invoke<string>("restart_bundle_path").catch(
+    (err) => {
+      console.error("[clips-updater] restart target lookup failed:", err);
+      return null;
+    },
+  );
   if (pendingUpdate) {
     await pendingUpdate.install();
   }
+  if (isMacPlatform() && restartBundlePath) {
+    try {
+      await invoke("schedule_restart_after_exit", {
+        bundlePath: restartBundlePath,
+      });
+      await exit(0);
+      return;
+    } catch (err) {
+      console.error("[clips-updater] macOS restart handoff failed:", err);
+    }
+  }
   await relaunch();
 }
 

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

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

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

@@ -386,7 +386,6 @@ export function MeetingNotification() {
     return <div className="meeting-notification-root" />;
   }
 
-  const isCalendar = data.type === "calendar";
   const hasJoin = Boolean(data.joinUrl);
   const provider = detectMeetingJoinProvider(data.joinUrl, data.platform);
   const providerName = joinProviderLabel(provider);
@@ -404,9 +403,6 @@ export function MeetingNotification() {
         onMouseEnter={() => setDomHovered(true)}
         onMouseLeave={() => setDomHovered(false)}
       >
-        <div
-          className={`meeting-notification-bar ${isCalendar ? "meeting-notification-bar-calendar" : "meeting-notification-bar-adhoc"}`}
-        />
         <div className="meeting-notification-content">
           <div className="meeting-notification-title">{data.title}</div>
           <div className="meeting-notification-subtitle">{data.subtitle}</div>

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

@@ -129,7 +129,6 @@ export interface FeatureConfig {
   showInScreenCapture: boolean;
   regionGuides: RegionGuidesConfig;
   screenMemory: ScreenMemoryConfig;
-  onboardingComplete: boolean;
   whisperModelEnabled: boolean;
   whisperModelId: string;
 }

package/corpus/templates/clips/desktop/src/styles.css

@@ -5263,124 +5263,6 @@ body[data-clips-route="recording-pill"] #root {
   }
 }
 
-/* ------------------------------------------------------------------------- */
-/* Overlay: onboarding                                                        */
-/* ------------------------------------------------------------------------- */
-
-.onboarding-root {
-  position: fixed;
-  inset: 0;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  background: #212121;
-  color: #f5f5f5;
-}
-
-.onboarding-card {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  gap: 20px;
-  padding: 40px 36px;
-  max-width: 380px;
-  width: 100%;
-}
-
-.onboarding-title {
-  font-size: 22px;
-  font-weight: 700;
-  color: white;
-  margin: 0;
-  letter-spacing: -0.3px;
-}
-
-.onboarding-subtitle {
-  font-size: 14px;
-  color: #a3a3a3;
-  margin: -8px 0 0;
-}
-
-.onboarding-features {
-  display: flex;
-  flex-direction: column;
-  gap: 10px;
-  width: 100%;
-}
-
-.onboarding-feature {
-  display: flex;
-  align-items: flex-start;
-  gap: 12px;
-  padding: 14px 16px;
-  background: rgba(255, 255, 255, 0.04);
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  border-radius: 12px;
-  cursor: pointer;
-  user-select: none;
-}
-
-.onboarding-feature:hover {
-  background: rgba(255, 255, 255, 0.06);
-}
-
-.onboarding-checkbox {
-  width: 18px;
-  height: 18px;
-  margin: 1px 0 0;
-  accent-color: #16a34a;
-  cursor: pointer;
-  flex-shrink: 0;
-}
-
-.onboarding-feature-text {
-  display: flex;
-  flex-direction: column;
-  gap: 3px;
-}
-
-.onboarding-feature-name {
-  font-size: 14px;
-  font-weight: 600;
-  color: white;
-}
-
-.onboarding-feature-desc {
-  font-size: 12px;
-  color: #a3a3a3;
-  line-height: 1.4;
-}
-
-.onboarding-cta {
-  width: 100%;
-  border: none;
-  border-radius: 12px;
-  padding: 12px 16px;
-  background: #f5f5f5;
-  color: #212121;
-  font-size: 14px;
-  font-weight: 600;
-  cursor: pointer;
-  height: 44px;
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  margin-top: 4px;
-}
-
-.onboarding-cta:hover {
-  background: #e5e5e5;
-}
-
-.onboarding-cta:active {
-  transform: translateY(1px);
-}
-
-.onboarding-cta:disabled {
-  opacity: 0.6;
-  cursor: not-allowed;
-}
-
 /* ------------------------------------------------------------------------- */
 /* Overlay: meeting notification                                              */
 /* ------------------------------------------------------------------------- */
@@ -5414,24 +5296,6 @@ body[data-clips-route="recording-pill"] #root {
   max-width: 440px;
 }
 
-.meeting-notification-bar {
-  width: 3px;
-  height: 36px;
-  border-radius: 999px;
-  flex-shrink: 0;
-}
-
-.meeting-notification-bar-calendar {
-  background: #7dd3fc;
-}
-
-.meeting-notification-bar-adhoc {
-  background: transparent;
-  border-left: 3px dashed #a3a3a3;
-  width: 3px;
-  border-radius: 0;
-}
-
 .meeting-notification-content {
   flex: 1;
   min-width: 0;

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

@@ -9,7 +9,6 @@
     "bubble",
     "signin",
     "finalizing",
-    "onboarding",
     "meeting-notif",
     "meeting-nub",
     "flow-bar",

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

@@ -48,7 +48,6 @@ const REGION_GUIDES_LABEL: &str = "region-guides";
 const REGION_GUIDE_EDITOR_LABEL: &str = "region-guide-editor";
 const REGION_RECORD_BORDER_LABEL: &str = "region-record-border";
 const MONITOR_PICKER_LABEL_PREFIX: &str = "monitor-picker-";
-const ONBOARDING_LABEL: &str = "onboarding";
 const OVERLAY_LABELS: &[&str] = &[
     COUNTDOWN_LABEL,
     TOOLBAR_LABEL,
@@ -59,8 +58,6 @@ const OVERLAY_LABELS: &[&str] = &[
     REGION_GUIDES_LABEL,
     REGION_RECORD_BORDER_LABEL,
 ];
-const ONBOARDING_WIDTH_LOGICAL: f64 = 560.0;
-const ONBOARDING_HEIGHT_LOGICAL: f64 = 640.0;
 
 /// Physical-pixel bubble sizes. Logical px on retina = physical / 2, so these
 /// map to ~96 (small) and ~180 (medium) logical px — matching Loom's camera
@@ -599,48 +596,6 @@ pub async fn hide_finalizing(app: AppHandle) -> Result<(), String> {
     Ok(())
 }
 
-/// First-run onboarding window (ONBOARD-WINDOW). Unlike the transparent,
-/// click-through overlays above, this is a normal decorated, focused window
-/// with its own solid dark background (`.onboarding-root` in styles.css) —
-/// centered on the primary display so it reads as a real app window, not a
-/// HUD. Called once from `lib.rs`'s `setup()` when `onboarding_complete` is
-/// false. Reuses an existing window if one is somehow already open (e.g. a
-/// hot-reload re-triggering setup in dev) instead of building a second one.
-pub fn show_onboarding_window(app: &AppHandle) {
-    if let Some(existing) = app.get_webview_window(ONBOARDING_LABEL) {
-        let _ = existing.show();
-        let _ = existing.set_focus();
-        return;
-    }
-    let win =
-        match WebviewWindowBuilder::new(app, ONBOARDING_LABEL, build_overlay_url("onboarding"))
-            .title("Welcome to Clips")
-            .inner_size(ONBOARDING_WIDTH_LOGICAL, ONBOARDING_HEIGHT_LOGICAL)
-            .resizable(false)
-            .center()
-            .focused(true)
-            .build()
-        {
-            Ok(w) => w,
-            Err(e) => {
-                eprintln!("[clips-tray] onboarding window build failed: {}", e);
-                return;
-            }
-        };
-    let _ = win.show();
-}
-
-/// Close the first-run onboarding window once the overlay's finish handler
-/// has saved feature config + opened the popover. Idempotent — closing an
-/// already-closed/never-built window is a no-op.
-#[tauri::command]
-pub async fn hide_onboarding_window(app: AppHandle) -> Result<(), String> {
-    if let Some(w) = app.get_webview_window(ONBOARDING_LABEL) {
-        let _ = w.close();
-    }
-    Ok(())
-}
-
 /// Full-screen, click-through recording guides. The React view renders the
 /// saved translucent rectangles, while AppKit marks the whole overlay as
 /// non-shareable so the guides stay private to the recorder.

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

@@ -134,7 +134,6 @@ pub struct FeatureConfig {
     pub region_guides: RegionGuidesConfig,
     #[serde(default)]
     pub screen_memory: ScreenMemoryConfig,
-    pub onboarding_complete: bool,
     #[serde(default = "default_whisper_model_enabled")]
     pub whisper_model_enabled: bool,
     #[serde(default = "default_whisper_model_id")]
@@ -238,7 +237,6 @@ impl Default for FeatureConfig {
             show_in_screen_capture: false,
             region_guides: RegionGuidesConfig::default(),
             screen_memory: ScreenMemoryConfig::default(),
-            onboarding_complete: false,
             whisper_model_enabled: default_whisper_model_enabled(),
             whisper_model_id: default_whisper_model_id(),
         }
@@ -437,8 +435,7 @@ mod tests {
         let config: FeatureConfig = serde_json::from_value(serde_json::json!({
             "clipsEnabled": true,
             "meetingsEnabled": true,
-            "voiceEnabled": true,
-            "onboardingComplete": true
+            "voiceEnabled": true
         }))
         .unwrap();
 

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

@@ -52,7 +52,7 @@ use state::{
 };
 use util::{
     configure_overlay_behavior, is_recording_active, present_interactive_window,
-    set_capture_excluded,
+    restart_bundle_path, schedule_restart_after_exit, set_capture_excluded,
 };
 
 // Embedded fallback icon — a tiny 16x16 solid purple PNG so the binary always
@@ -116,7 +116,6 @@ pub fn run() {
             clips::close_signin,
             clips::show_flow_bar,
             clips::hide_flow_bar,
-            clips::hide_onboarding_window,
             clips::complete_voice_dictation,
             clips::paste_last_dictation,
             clips::set_recording_state,
@@ -248,6 +247,8 @@ pub fn run() {
             // persistent log file (production debugging)
             logfile::frontend_log,
             logfile::open_logs,
+            restart_bundle_path,
+            schedule_restart_after_exit,
         ])
         .plugin(tauri_plugin_shell::init())
         .plugin(tauri_plugin_deep_link::init())
@@ -341,15 +342,6 @@ pub fn run() {
             tray::build_tray(app)?;
             config::sync_launch_at_login(app.handle());
             let feature_config = config::feature_config(app.handle());
-            // ONBOARD-WINDOW: first-run onboarding never had a Rust-side
-            // window to appear in — the `#onboarding` hash route and overlay
-            // component existed, but nothing ever called
-            // WebviewWindowBuilder for it. Build it here, after the popover
-            // exists, gated on the persisted `onboarding_complete` flag so
-            // returning users never see it again.
-            if !feature_config.onboarding_complete {
-                clips::show_onboarding_window(app.handle());
-            }
             screen_memory::sync_from_config(app.handle(), &feature_config);
             // Re-show always-on region guides after relaunch/reboot when the
             // setting is on (no-op if a recording owns the window or the