@agent-native/core-corpus 0.219.0 → 0.220.0-nightly-20261023183804

package/corpus/README.md

@@ -32,4 +32,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core-corpus/corpu
 
 ## Generated Counts
 
-- template files: 14579
+- template files: 14683

package/corpus/templates/analytics/.agents/skills/external-agents/references/mcp-apps-embedding.md

@@ -162,8 +162,15 @@ actions for Forms, Content, Clips, Slides, and Design. The action should return
 concise structured content plus the link; it should not dump large catalogs or
 HTML.
 
-Compatibility target: build to the standard once, not per-client shims. MCP
-Apps-capable hosts should include Claude/Claude Desktop/Claude Code, ChatGPT
-custom MCP apps, VS Code GitHub Copilot, Goose, Postman, MCPJam, Cursor, and
-any future host that follows the extension negotiation. Host support varies by
-plan, release channel, and client version, so keep the deep link fallback.
+Compatibility target: build to the standard once, not per-client shims.
+Hosts that render MCP Apps inline today include Claude chat on web, desktop, and
+mobile, plus the Claude Desktop Code tab; ChatGPT; VS Code GitHub Copilot (1.109+);
+Microsoft 365 Copilot; Cursor (2.6+); Goose; Postman; MCPJam; Codex Desktop (26.616+);
+and T3 Code (in Codex threads). Desktop Code rendering is observed in
+[widget bug reports](https://github.com/anthropics/claude-code/issues/103809).
+Treat the Claude Code terminal, Cowork, and Code on claude.ai web as link-out hosts.
+[Cowork doesn't declare MCP Apps yet](https://github.com/anthropics/claude-code/issues/103924),
+and using it on the same connector can make inline apps disappear in Chat until
+you reconnect the connector. Host support varies by plan, release channel, and client version,
+so keep the deep link fallback. See the community-maintained
+[MCP client matrix](https://modelcontextprotocol.io/extensions/client-matrix).

package/corpus/templates/analytics/.deploy-tmp/agent-native-provided-plugins.mjs

@@ -0,0 +1,10 @@
+// AUTO-GENERATED by @agent-native/core deploy build
+import { markDefaultPluginProvided } from "@agent-native/core/server/edge";
+
+const pluginStems = ["agent-chat","analytics-alert-jobs","analytics-rollup-backfill-jobs","auth","collab","config","content-metrics-collection-jobs","core-routes","creative-context","dashboard-report-jobs","db","feature-flags","labs","onboarding","otel","session-replay-retention-jobs","transactional-emails","uptime-monitor-jobs"];
+
+export default function markBuildDiscoveredPlugins(nitroApp) {
+  for (const stem of pluginStems) {
+    markDefaultPluginProvided(nitroApp, stem);
+  }
+}

package/corpus/templates/assets/.agents/skills/external-agents/references/mcp-apps-embedding.md

@@ -162,8 +162,15 @@ actions for Forms, Content, Clips, Slides, and Design. The action should return
 concise structured content plus the link; it should not dump large catalogs or
 HTML.
 
-Compatibility target: build to the standard once, not per-client shims. MCP
-Apps-capable hosts should include Claude/Claude Desktop/Claude Code, ChatGPT
-custom MCP apps, VS Code GitHub Copilot, Goose, Postman, MCPJam, Cursor, and
-any future host that follows the extension negotiation. Host support varies by
-plan, release channel, and client version, so keep the deep link fallback.
+Compatibility target: build to the standard once, not per-client shims.
+Hosts that render MCP Apps inline today include Claude chat on web, desktop, and
+mobile, plus the Claude Desktop Code tab; ChatGPT; VS Code GitHub Copilot (1.109+);
+Microsoft 365 Copilot; Cursor (2.6+); Goose; Postman; MCPJam; Codex Desktop (26.616+);
+and T3 Code (in Codex threads). Desktop Code rendering is observed in
+[widget bug reports](https://github.com/anthropics/claude-code/issues/103809).
+Treat the Claude Code terminal, Cowork, and Code on claude.ai web as link-out hosts.
+[Cowork doesn't declare MCP Apps yet](https://github.com/anthropics/claude-code/issues/103924),
+and using it on the same connector can make inline apps disappear in Chat until
+you reconnect the connector. Host support varies by plan, release channel, and client version,
+so keep the deep link fallback. See the community-maintained
+[MCP client matrix](https://modelcontextprotocol.io/extensions/client-matrix).

package/corpus/templates/assets/.deploy-tmp/agent-native-provided-plugins.mjs

@@ -0,0 +1,10 @@
+// AUTO-GENERATED by @agent-native/core deploy build
+import { markDefaultPluginProvided } from "@agent-native/core/server/edge";
+
+const pluginStems = ["agent-chat","auth","creative-context","db","labs","onboarding","otel"];
+
+export default function markBuildDiscoveredPlugins(nitroApp) {
+  for (const stem of pluginStems) {
+    markDefaultPluginProvided(nitroApp, stem);
+  }
+}

package/corpus/templates/brain/.agents/skills/external-agents/references/mcp-apps-embedding.md

@@ -162,8 +162,15 @@ actions for Forms, Content, Clips, Slides, and Design. The action should return
 concise structured content plus the link; it should not dump large catalogs or
 HTML.
 
-Compatibility target: build to the standard once, not per-client shims. MCP
-Apps-capable hosts should include Claude/Claude Desktop/Claude Code, ChatGPT
-custom MCP apps, VS Code GitHub Copilot, Goose, Postman, MCPJam, Cursor, and
-any future host that follows the extension negotiation. Host support varies by
-plan, release channel, and client version, so keep the deep link fallback.
+Compatibility target: build to the standard once, not per-client shims.
+Hosts that render MCP Apps inline today include Claude chat on web, desktop, and
+mobile, plus the Claude Desktop Code tab; ChatGPT; VS Code GitHub Copilot (1.109+);
+Microsoft 365 Copilot; Cursor (2.6+); Goose; Postman; MCPJam; Codex Desktop (26.616+);
+and T3 Code (in Codex threads). Desktop Code rendering is observed in
+[widget bug reports](https://github.com/anthropics/claude-code/issues/103809).
+Treat the Claude Code terminal, Cowork, and Code on claude.ai web as link-out hosts.
+[Cowork doesn't declare MCP Apps yet](https://github.com/anthropics/claude-code/issues/103924),
+and using it on the same connector can make inline apps disappear in Chat until
+you reconnect the connector. Host support varies by plan, release channel, and client version,
+so keep the deep link fallback. See the community-maintained
+[MCP client matrix](https://modelcontextprotocol.io/extensions/client-matrix).

package/corpus/templates/brain/.deploy-tmp/agent-native-provided-plugins.mjs

@@ -0,0 +1,10 @@
+// AUTO-GENERATED by @agent-native/core deploy build
+import { markDefaultPluginProvided } from "@agent-native/core/server/edge";
+
+const pluginStems = ["agent-chat","auth","brain-jobs","core-routes","db","otel"];
+
+export default function markBuildDiscoveredPlugins(nitroApp) {
+  for (const stem of pluginStems) {
+    markDefaultPluginProvided(nitroApp, stem);
+  }
+}

package/corpus/templates/calendar/.agents/skills/external-agents/references/mcp-apps-embedding.md

@@ -162,8 +162,15 @@ actions for Forms, Content, Clips, Slides, and Design. The action should return
 concise structured content plus the link; it should not dump large catalogs or
 HTML.
 
-Compatibility target: build to the standard once, not per-client shims. MCP
-Apps-capable hosts should include Claude/Claude Desktop/Claude Code, ChatGPT
-custom MCP apps, VS Code GitHub Copilot, Goose, Postman, MCPJam, Cursor, and
-any future host that follows the extension negotiation. Host support varies by
-plan, release channel, and client version, so keep the deep link fallback.
+Compatibility target: build to the standard once, not per-client shims.
+Hosts that render MCP Apps inline today include Claude chat on web, desktop, and
+mobile, plus the Claude Desktop Code tab; ChatGPT; VS Code GitHub Copilot (1.109+);
+Microsoft 365 Copilot; Cursor (2.6+); Goose; Postman; MCPJam; Codex Desktop (26.616+);
+and T3 Code (in Codex threads). Desktop Code rendering is observed in
+[widget bug reports](https://github.com/anthropics/claude-code/issues/103809).
+Treat the Claude Code terminal, Cowork, and Code on claude.ai web as link-out hosts.
+[Cowork doesn't declare MCP Apps yet](https://github.com/anthropics/claude-code/issues/103924),
+and using it on the same connector can make inline apps disappear in Chat until
+you reconnect the connector. Host support varies by plan, release channel, and client version,
+so keep the deep link fallback. See the community-maintained
+[MCP client matrix](https://modelcontextprotocol.io/extensions/client-matrix).

package/corpus/templates/calendar/.deploy-tmp/agent-native-provided-plugins.mjs

@@ -0,0 +1,10 @@
+// AUTO-GENERATED by @agent-native/core deploy build
+import { markDefaultPluginProvided } from "@agent-native/core/server/edge";
+
+const pluginStems = ["agent-chat","auth","core-routes","db","event-rules","oauth-refresh","otel","transactional-emails"];
+
+export default function markBuildDiscoveredPlugins(nitroApp) {
+  for (const stem of pluginStems) {
+    markDefaultPluginProvided(nitroApp, stem);
+  }
+}

package/corpus/templates/chat/.deploy-tmp/agent-native-provided-plugins.mjs

@@ -0,0 +1,10 @@
+// AUTO-GENERATED by @agent-native/core deploy build
+import { markDefaultPluginProvided } from "@agent-native/core/server/edge";
+
+const pluginStems = ["agent-chat","auth","otel"];
+
+export default function markBuildDiscoveredPlugins(nitroApp) {
+  for (const stem of pluginStems) {
+    markDefaultPluginProvided(nitroApp, stem);
+  }
+}

package/corpus/templates/clips/.agents/skills/external-agents/references/mcp-apps-embedding.md

@@ -162,8 +162,15 @@ actions for Forms, Content, Clips, Slides, and Design. The action should return
 concise structured content plus the link; it should not dump large catalogs or
 HTML.
 
-Compatibility target: build to the standard once, not per-client shims. MCP
-Apps-capable hosts should include Claude/Claude Desktop/Claude Code, ChatGPT
-custom MCP apps, VS Code GitHub Copilot, Goose, Postman, MCPJam, Cursor, and
-any future host that follows the extension negotiation. Host support varies by
-plan, release channel, and client version, so keep the deep link fallback.
+Compatibility target: build to the standard once, not per-client shims.
+Hosts that render MCP Apps inline today include Claude chat on web, desktop, and
+mobile, plus the Claude Desktop Code tab; ChatGPT; VS Code GitHub Copilot (1.109+);
+Microsoft 365 Copilot; Cursor (2.6+); Goose; Postman; MCPJam; Codex Desktop (26.616+);
+and T3 Code (in Codex threads). Desktop Code rendering is observed in
+[widget bug reports](https://github.com/anthropics/claude-code/issues/103809).
+Treat the Claude Code terminal, Cowork, and Code on claude.ai web as link-out hosts.
+[Cowork doesn't declare MCP Apps yet](https://github.com/anthropics/claude-code/issues/103924),
+and using it on the same connector can make inline apps disappear in Chat until
+you reconnect the connector. Host support varies by plan, release channel, and client version,
+so keep the deep link fallback. See the community-maintained
+[MCP client matrix](https://modelcontextprotocol.io/extensions/client-matrix).

package/corpus/templates/clips/.deploy-tmp/agent-native-provided-plugins.mjs

@@ -0,0 +1,10 @@
+// AUTO-GENERATED by @agent-native/core deploy build
+import { markDefaultPluginProvided } from "@agent-native/core/server/edge";
+
+const pluginStems = ["agent-chat","auth","calendar-jobs","config","core-routes","db","feature-flags","labs","onboarding","onboarding-calendar","otel","transactional-email-catalog"];
+
+export default function markBuildDiscoveredPlugins(nitroApp) {
+  for (const stem of pluginStems) {
+    markDefaultPluginProvided(nitroApp, stem);
+  }
+}

package/corpus/templates/clips/app/components/recorder/storage-setup-card.tsx

@@ -31,10 +31,11 @@ import {
 // success should finish this card's setup; a connection made long after the
 // cancel belongs to something else.
 const CANCELLED_SETUP_RECOVERY_MS = 60_000;
+// The custom-keys form finishes in another tab with no signal back, so a
+// status read on leaving or returning credits it only this long after it was
+// opened; storage set up later belongs to something else.
+const CUSTOM_KEYS_CREDIT_WINDOW_MS = 15 * 60_000;
 
-// The S3 path finishes in settings, outside this card, so only the choice is
-// recorded here; a later `recording_started.storage_connected` shows whether
-// it landed.
 function trackStorageStep(
   name:
     | "onboarding_step_viewed"
@@ -66,6 +67,8 @@ export interface StorageSetupCardProps {
    */
   recordingAttemptId?: string;
   outputId?: string;
+  /** Why the host is showing the card, recorded on every step event. */
+  setupReason?: string;
 }
 
 export function StorageSetupCard({
@@ -79,6 +82,7 @@ export function StorageSetupCard({
   connectFlow = "file_upload",
   recordingAttemptId,
   outputId,
+  setupReason,
 }: StorageSetupCardProps) {
   const t = useT();
   const storageSetupHref = useStorageSetupHref();
@@ -100,6 +104,9 @@ export function StorageSetupCard({
   const connectRequestedRef = useRef(false);
   const connectIntentExpiresAtRef = useRef<number | null>(null);
   const [stepViewId] = useState(createOnboardingCorrelationId);
+  // Fixed for the showing: the host's status can change while the card is up,
+  // and every event under one step_view_id must agree on why it showed.
+  const [viewSetupReason] = useState(setupReason);
   const stepProperties = useMemo(
     () => ({
       flow: connectSource,
@@ -108,8 +115,69 @@ export function StorageSetupCard({
         ? { recording_attempt_id: recordingAttemptId }
         : {}),
       ...(outputId ? { output_id: outputId } : {}),
+      ...(viewSetupReason ? { setup_reason: viewSetupReason } : {}),
     }),
-    [connectSource, stepViewId, recordingAttemptId, outputId],
+    [connectSource, stepViewId, recordingAttemptId, outputId, viewSetupReason],
+  );
+  const stepPropertiesRef = useRef(stepProperties);
+  stepPropertiesRef.current = stepProperties;
+  const builderHandedOffRef = useRef(false);
+  const skippedRef = useRef(false);
+  const customKeysOpenedAtRef = useRef<number | null>(null);
+  const customKeysOpenedRecently = useCallback(() => {
+    const openedAt = customKeysOpenedAtRef.current;
+    return (
+      openedAt !== null && Date.now() - openedAt <= CUSTOM_KEYS_CREDIT_WINDOW_MS
+    );
+  }, []);
+  const completionTrackedRef = useRef(false);
+  const returnReadInFlightRef = useRef(false);
+  const storageBeforeSetupRef = useRef<Promise<
+    { status: VideoStorageStatus } | { error: unknown }
+  > | null>(null);
+  const readStorageBeforeSetup = useCallback(() => {
+    storageBeforeSetupRef.current ??= fetchVideoStorageStatus({
+      timeoutMs: 10_000,
+    }).then(
+      (status) => ({ status }),
+      (error: unknown) => ({ error }),
+    );
+  }, []);
+
+  // The route hosting this card can unmount it the moment the shared storage
+  // status reads configured, before this card's poll sees it, so the unmount
+  // path below reads the status once more and records through this too.
+  // Only a change to the workspace's own storage completes this step: free
+  // hosted clips also read as configured, and own storage that was already
+  // there at the showing's first setup click was not set up by this card.
+  // The read of storage before setup must start before any setup request
+  // can, since one-request account activation can finish before a read sent
+  // with it.
+  const trackCompletedIfConfigured = useCallback(
+    (status: VideoStorageStatus) => {
+      const before = storageBeforeSetupRef.current;
+      if (status.mode !== "own" || !before || completionTrackedRef.current) {
+        return;
+      }
+      // Claimed before the wait, so reads landing together record once.
+      completionTrackedRef.current = true;
+      void before.then((read) => {
+        if ("error" in read) {
+          console.warn(
+            "[storage-setup] storage before setup could not be read:",
+            read.error,
+          );
+          return;
+        }
+        if (read.status.mode === "own" || skippedRef.current) return;
+        const methodId = status.activeProvider?.id;
+        trackStorageStep("onboarding_step_completed", {
+          ...stepPropertiesRef.current,
+          ...(methodId ? { method_id: methodId } : {}),
+        });
+      });
+    },
+    [],
   );
 
   const clearConfiguredTimeout = useCallback(() => {
@@ -177,10 +245,7 @@ export function StorageSetupCard({
           stop();
           setConnecting(false);
           setConnected(true);
-          trackStorageStep("onboarding_step_completed", {
-            ...stepProperties,
-            method_id: "builder",
-          });
+          trackCompletedIfConfigured(status);
           clearConfiguredTimeout();
           configuredTimeoutRef.current = setTimeout(() => {
             configuredTimeoutRef.current = null;
@@ -211,9 +276,9 @@ export function StorageSetupCard({
   }, [
     clearConfiguredTimeout,
     onConfigured,
-    stepProperties,
     stopVisibilityHandler,
     t,
+    trackCompletedIfConfigured,
   ]);
 
   const handleBuilderConnected = useCallback(() => {
@@ -222,6 +287,7 @@ export function StorageSetupCard({
     connectRequestedRef.current = false;
     connectIntentExpiresAtRef.current = null;
     if (expiresAt !== null && Date.now() > expiresAt) return;
+    builderHandedOffRef.current = true;
     startFileUploadPoll();
   }, [startFileUploadPoll]);
 
@@ -269,6 +335,7 @@ export function StorageSetupCard({
         setStatusIssue("connect-not-allowed");
         return;
       }
+      readStorageBeforeSetup();
       connectRequestedRef.current = true;
       connectIntentExpiresAtRef.current = null;
       setStatusIssue(null);
@@ -281,7 +348,12 @@ export function StorageSetupCard({
         scope: builderConnectionScope,
       });
     },
-    [builderConnectionScope, builderConnect.start, stepProperties],
+    [
+      builderConnectionScope,
+      builderConnect.start,
+      readStorageBeforeSetup,
+      stepProperties,
+    ],
   );
   const handleBuilderCancel = useCallback(() => {
     connectIntentExpiresAtRef.current =
@@ -290,6 +362,7 @@ export function StorageSetupCard({
   }, [builderConnect.cancel]);
   const handleSkip = useCallback(() => {
     clearConfiguredTimeout();
+    skippedRef.current = true;
     trackStorageStep("onboarding_step_skipped", {
       ...stepProperties,
     });
@@ -307,8 +380,41 @@ export function StorageSetupCard({
           )
     : null;
   const builderConnecting = builderConnect.connecting;
+  const builderConnectingRef = useRef(builderConnecting);
+  builderConnectingRef.current = builderConnecting;
   const actionConnecting = connecting || builderConnecting;
 
+  // The custom-keys form opens in another tab, and some routes keep this card
+  // mounted after it saves, so a return to this tab reads the status too.
+  useEffect(() => {
+    const readOnReturn = () => {
+      if (
+        document.hidden ||
+        !customKeysOpenedRecently() ||
+        completionTrackedRef.current ||
+        skippedRef.current ||
+        returnReadInFlightRef.current
+      ) {
+        return;
+      }
+      returnReadInFlightRef.current = true;
+      void fetchVideoStorageStatus({ timeoutMs: 10_000 })
+        .then(trackCompletedIfConfigured)
+        .catch((err) => {
+          console.warn("[storage-setup] completion check failed:", err);
+        })
+        .finally(() => {
+          returnReadInFlightRef.current = false;
+        });
+    };
+    window.addEventListener("focus", readOnReturn);
+    document.addEventListener("visibilitychange", readOnReturn);
+    return () => {
+      window.removeEventListener("focus", readOnReturn);
+      document.removeEventListener("visibilitychange", readOnReturn);
+    };
+  }, [customKeysOpenedRecently, trackCompletedIfConfigured]);
+
   useEffect(() => {
     trackStorageStep("onboarding_step_viewed", {
       ...stepProperties,
@@ -319,6 +425,24 @@ export function StorageSetupCard({
     mountedRef.current = true;
     return () => {
       mountedRef.current = false;
+      // The route can unmount this card mid-setup: while the connect flow is
+      // still connecting, or after this card accepted the connect but before
+      // its storage poll saw it. After a cancel the flow keeps connecting
+      // through its popup-closed grace, so crediting then relies on that grace
+      // staying shorter than CANCELLED_SETUP_RECOVERY_MS.
+      const setupPending =
+        !completionTrackedRef.current &&
+        !skippedRef.current &&
+        (builderHandedOffRef.current ||
+          builderConnectingRef.current ||
+          customKeysOpenedRecently());
+      if (setupPending) {
+        void fetchVideoStorageStatus({ timeoutMs: 10_000 })
+          .then(trackCompletedIfConfigured)
+          .catch((err) => {
+            console.warn("[storage-setup] completion check failed:", err);
+          });
+      }
       clearConfiguredTimeout();
       if (pollRef.current) {
         clearInterval(pollRef.current);
@@ -326,7 +450,12 @@ export function StorageSetupCard({
       }
       stopVisibilityHandler();
     };
-  }, [clearConfiguredTimeout, stopVisibilityHandler]);
+  }, [
+    clearConfiguredTimeout,
+    customKeysOpenedRecently,
+    stopVisibilityHandler,
+    trackCompletedIfConfigured,
+  ]);
 
   return (
     <div className="mx-auto flex w-full max-w-md flex-col gap-5 rounded-2xl border border-border bg-card p-6 shadow-lg">
@@ -357,6 +486,7 @@ export function StorageSetupCard({
             cancel: undefined,
           }}
           onConnect={handleBuilderConnect}
+          onTriggerClick={readStorageBeforeSetup}
         >
           <Button
             type="button"
@@ -379,12 +509,14 @@ export function StorageSetupCard({
                 href={storageSetupHref}
                 target="_blank"
                 rel="noopener noreferrer"
-                onClick={() =>
+                onClick={() => {
+                  readStorageBeforeSetup();
+                  customKeysOpenedAtRef.current = Date.now();
                   trackStorageStep("onboarding_method_clicked", {
                     ...stepProperties,
                     method_id: "s3",
-                  })
-                }
+                  });
+                }}
               >
                 {t("storageSetup.customKeys")}
               </a>

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

@@ -1279,6 +1279,16 @@ export function shouldRedirectToStorageSetupHome({
   );
 }
 
+export function storageSetupReason(
+  status: Pick<VideoStorageStatus, "denyReason"> | undefined,
+): string {
+  if (!status) return "status_unavailable";
+  // "disabled" means free hosted clips are off, not that a hosted clip was denied.
+  return status.denyReason && status.denyReason !== "disabled"
+    ? `hosted_${status.denyReason}`
+    : "storage_required";
+}
+
 export function shouldShowFirstRunStorageSetup({
   storageConfigured,
   storageStatusUnavailable,
@@ -4187,6 +4197,7 @@ export default function RecordRoute() {
                     showBuilderStorageOffer={!hostedAllowanceExhausted}
                     connectSource="clips_record_storage_setup_card"
                     connectFlow="record"
+                    setupReason={storageSetupReason(storageQuery.data)}
                   />
                 </div>
               ) : showStorageStatusUnavailable ? (

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

@@ -230,7 +230,9 @@ import {
 import {
   RECORDING_SERVER_UNAVAILABLE,
   RECORDING_SESSION_EXPIRED,
+  buildVideoStorageSetupUrl,
   isStorageSetupFailureMessage,
+  onStorageSetupRequired,
 } from "./lib/recording-request";
 import {
   listenForRecordingShortcutStopAcks,
@@ -1392,6 +1394,8 @@ export function App({
     );
   }, [videoStorageIdentity, serverUrl, signedInAs]);
 
+  const videoStorageProbeSeqRef = useRef(0);
+
   const refreshVideoStorageStatus = useCallback(async () => {
     if (authStatus !== "authed") {
       hostedClipLimitMsRef.current = null;
@@ -1400,11 +1404,15 @@ export function App({
     }
 
     const probedIdentity = videoStorageIdentity;
+    // Probes are slow enough to overlap; only the newest result may land, or a
+    // pre-connect "missing" overwrites the "configured" that came after it.
+    const probeSeq = ++videoStorageProbeSeqRef.current;
     const { probe, maxClipDurationMs } = await hasConfiguredVideoStorage(
       serverUrl,
       signedInAs,
     );
     if (videoStorageIdentityRef.current !== probedIdentity) return false;
+    if (videoStorageProbeSeqRef.current !== probeSeq) return false;
     if (probe === "unavailable") {
       setVideoStorageStatus("unavailable");
       return false;
@@ -1433,8 +1441,10 @@ export function App({
       });
     };
     const interval = window.setInterval(tick, 5000);
+    // Showing the popover always re-probes, even past an in-flight probe: the
+    // newest probe wins.
     const onVisibilityChange = () => {
-      if (!document.hidden) tick();
+      if (!document.hidden) void refreshVideoStorageStatus();
     };
     document.addEventListener("visibilitychange", onVisibilityChange);
     return () => {
@@ -3855,6 +3865,7 @@ export function App({
   ) => {
     if (recordFirstUploading || !recordFirstKey || !signedInAs) return;
     if (videoStorageStatus !== "configured") {
+      setRecError(STORAGE_SETUP_HELP_TEXT);
       openVideoStorageSetup();
       return;
     }
@@ -4147,19 +4158,62 @@ export function App({
   const openVideoStorageSetup = useCallback(
     (targetServerUrl?: string) => {
       const base = (targetServerUrl?.trim() || serverUrl).replace(/\/+$/, "");
-      setRecError(STORAGE_SETUP_HELP_TEXT);
-      void openExternal(`${base}/record?connectStorage=1`).catch((err) => {
+      void openExternal(buildVideoStorageSetupUrl(base)).catch((err) => {
         setRecError(
           err instanceof Error
             ? err.message
             : "Could not open Clips storage setup.",
         );
       });
-      void refreshVideoStorageStatus();
     },
-    [refreshVideoStorageStatus, serverUrl],
+    [serverUrl],
+  );
+
+  // Drops the "missing" banner until the next probe. A probe already in flight
+  // would land after this and restore it, so it is invalidated too.
+  const forgetMissingVideoStorage = useCallback(() => {
+    videoStorageProbeSeqRef.current += 1;
+    setRecError((message) =>
+      isStorageSetupFailureMessage(message) ? null : message,
+    );
+    setVideoStorageStatus((status) =>
+      status === "missing" ? "checking" : status,
+    );
+  }, []);
+
+  // The banner goes away on click; reopening the popover re-probes, and the
+  // banner returns only if storage is still missing.
+  const connectVideoStorage = useCallback(() => {
+    forgetMissingVideoStorage();
+    openVideoStorageSetup();
+  }, [forgetMissingVideoStorage, openVideoStorageSetup]);
+
+  useEffect(
+    () =>
+      onStorageSetupRequired(() => {
+        setRecError(STORAGE_SETUP_HELP_TEXT);
+        invoke("show_popover").catch(() => {});
+        void refreshVideoStorageStatus();
+      }),
+    [refreshVideoStorageStatus],
   );
 
+  useEffect(() => {
+    if (videoStorageStatus !== "configured") return;
+    setRecError((message) =>
+      isStorageSetupFailureMessage(message) ? null : message,
+    );
+  }, [videoStorageStatus]);
+
+  useEffect(() => {
+    const onVisibilityChange = () => {
+      if (document.hidden) forgetMissingVideoStorage();
+    };
+    document.addEventListener("visibilitychange", onVisibilityChange);
+    return () =>
+      document.removeEventListener("visibilitychange", onVisibilityChange);
+  }, [forgetMissingVideoStorage]);
+
   async function handleStartRecording(options?: {
     resumeCapture?: RestartHandoff;
   }): Promise<RecorderHandle | null> {
@@ -4877,14 +4931,14 @@ export function App({
         delete next[key];
         return next;
       });
-      void openExternal(
-        `${targetServerUrl.replace(/\/+$/, "")}/record?connectStorage=1`,
-      ).catch((error) => {
-        setRecoveryActionErrors((errors) => ({
-          ...errors,
-          [key]: error instanceof Error ? error.message : String(error),
-        }));
-      });
+      void openExternal(buildVideoStorageSetupUrl(targetServerUrl)).catch(
+        (error) => {
+          setRecoveryActionErrors((errors) => ({
+            ...errors,
+            [key]: error instanceof Error ? error.message : String(error),
+          }));
+        },
+      );
     },
   };
   const pendingUploadBanner = shouldShowRecordingRecoveryBanner(
@@ -5475,9 +5529,7 @@ export function App({
               onRetry={() => beginRecording()}
             />
           ) : isStorageSetupFailureMessage(recError) ? (
-            <StorageConnectionBanner
-              onConnect={() => openVideoStorageSetup()}
-            />
+            <StorageConnectionBanner onConnect={connectVideoStorage} />
           ) : recError === RECORDING_SESSION_EXPIRED ? (
             <SessionExpiredBanner onReconnect={() => void reconnectSession()} />
           ) : recError === RECORDING_SERVER_UNAVAILABLE ? (
@@ -5486,6 +5538,12 @@ export function App({
             <div className="error-banner">{recError}</div>
           )
         ) : null}
+        {!recError &&
+        localRecordingMode === "off" &&
+        authStatus === "authed" &&
+        videoStorageStatus === "missing" ? (
+          <StorageConnectionBanner onConnect={connectVideoStorage} />
+        ) : null}
         {cameraError && !recError ? (
           cameraError === MACOS_CAPTURE_PERMISSION_MESSAGE ||
           cameraError === DESKTOP_CAPTURE_PERMISSION_MESSAGE ? (