@agent-native/core 0.90.8 → 0.90.10

package/corpus/core/src/file-upload/types.ts

@@ -16,8 +16,8 @@ export interface FileUploadInput {
   mimeType?: string;
   /** Optional owner email for per-user scoping in fallback storage. */
   ownerEmail?: string;
-  /** Builder.io upload hint: return after asset registration instead of waiting for server-side compression. */
-  skipCompressionWait?: boolean;
+  /** Builder.io upload hint: return one stable URL while compression finishes asynchronously. */
+  stableUrl?: boolean;
   /** Builder.io upload hint: set false for internal artifacts that should not appear in the asset library. */
   recordAsset?: boolean;
 }
@@ -81,7 +81,7 @@ export interface FileUploadProvider {
     completeSession(
       session: ResumableUploadSession,
       filename: string,
-      options?: { skipCompressionWait?: boolean; recordAsset?: boolean },
+      options?: { stableUrl?: boolean; recordAsset?: boolean },
     ): Promise<string>;
   };
 }

package/corpus/core/src/styles/blocks.css

@@ -1007,6 +1007,13 @@
   min-height: 100%;
 }
 
+.plan-html-frame[data-frame="hide"]:not([data-render-mode="design"])
+  > .plan-html-frame-content
+  > :first-child {
+  margin: 0 !important;
+  padding: 0 !important;
+}
+
 .plan-html-frame[data-prototype-live="true"] {
   overflow: auto;
 }

package/corpus/templates/analytics/.agents/skills/session-replay/SKILL.md

@@ -106,12 +106,17 @@ agent answers about browser recordings in the Analytics template.
 
 ## Capture Defaults
 
-- Replay is off unless enabled by config/env.
-- Consumers can enable replay directly with
+- Replay is on by default for signed-in hosted users when
+  `VITE_AGENT_NATIVE_ANALYTICS_PUBLIC_KEY` or `configureTracking({ key })` is
+  present. The default sample rate is 100% of eligible sessions.
+- Replay remains off when no first-party analytics key is configured, and it is
+  not auto-enabled on localhost/local dev. Consumers can still enable replay
+  directly with
   `configureTracking({ key, endpoint, sessionReplay: { enabled: true } })`.
+- Apps can opt out with `configureTracking({ sessionReplay: false })`.
 - Agent Native templates already call `configureTracking()` in their roots;
-  hosted template deployments can usually enable replay with Vite/Netlify env
-  vars on the recorded site.
+  hosted template deployments only need the normal Agent Native Analytics
+  Vite/Netlify env vars on the recorded site.
 - Inputs are masked by default. Page text is visible unless marked with
   `.an-mask` or `data-an-mask`.
 - Use `.an-block`, `.an-ignore`, `data-an-block`, or `data-an-ignore` for

package/corpus/templates/analytics/app/components/dashboard/SqlChart.tsx

@@ -155,6 +155,24 @@ export function formatMetricValue(
     : String(raw ?? "-");
 }
 
+function isNumericLikeValue(value: unknown): boolean {
+  if (typeof value === "number") return Number.isFinite(value);
+  return (
+    typeof value === "string" &&
+    value.trim() !== "" &&
+    Number.isFinite(Number(value))
+  );
+}
+
+export function detectMetricValueColumn(
+  row: Record<string, unknown>,
+  configuredKey?: string,
+): string {
+  const cols = Object.keys(row);
+  if (configuredKey && cols.includes(configuredKey)) return configuredKey;
+  return cols.find((key) => isNumericLikeValue(row[key])) || cols[0] || "";
+}
+
 function parsePrometheusSeriesLabel(label: string): {
   metric: string;
   labels: Record<string, string>;
@@ -804,7 +822,7 @@ function detectKeys(
   if (yKeys.length === 0) {
     for (const c of cols) {
       if (c === xKey) continue;
-      if (typeof sample[c] === "number") yKeys.push(c);
+      if (isNumericLikeValue(sample[c])) yKeys.push(c);
     }
   }
   if (yKeys.length === 0 && cols.length > 1) {
@@ -1120,14 +1138,10 @@ function MetricRenderer({
   panel: SqlPanel;
 }) {
   const row = rows[0];
-  const cols = Object.keys(row);
-  const valueCol =
-    panel.config?.yKey ||
-    cols.find((c) => typeof row[c] === "number") ||
-    cols[0];
+  const valueCol = detectMetricValueColumn(row, panel.config?.yKey);
 
   let raw: unknown;
-  if (rows.length > 1 && typeof row[valueCol] === "number") {
+  if (rows.length > 1 && isNumericLikeValue(row[valueCol])) {
     raw = rows.reduce((sum, r) => sum + (Number(r[valueCol]) || 0), 0);
   } else {
     raw = row[valueCol];

package/corpus/templates/analytics/app/entry.client.tsx

@@ -1,7 +1,12 @@
-import { appBasePath } from "@agent-native/core/client/api-path";
+import {
+  appBasePath,
+  installRouteChunkRecovery,
+} from "@agent-native/core/client";
 import { hydrateRoot } from "react-dom/client";
 import { HydratedRouter } from "react-router/dom";
 
+installRouteChunkRecovery();
+
 const basePath = appBasePath();
 const pathname = window.location.pathname;
 const routerBasePath =

package/corpus/templates/analytics/app/pages/sessions/SessionsPage.tsx

@@ -546,7 +546,7 @@ configureTracking({
   sessionReplay: {
     enabled: true,
     requireSignedInUser: true,
-    sampleRate: 0.1,
+    sampleRate: 1,
   },
   getDefaultProps: (_event, props) => ({
     ...props,

package/corpus/templates/analytics/changelog/2026-07-07-analytics-now-recovers-from-stale-route-chunks-after-deploys.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Analytics now recovers from stale route chunks after deploys instead of leaving dashboards stuck on failed module loads.

package/corpus/templates/analytics/changelog/2026-07-07-metric-dashboard-cards-now-show-warehouse-backed-numeric-val.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Metric dashboard cards now show warehouse-backed numeric values correctly when query results return numbers as strings.

package/corpus/templates/clips/actions/create-recording.ts

@@ -113,7 +113,7 @@ export default defineAction({
           sessionId: session.sessionId,
           meta: {
             ...session.meta,
-            skipCompressionWait: true,
+            stableUrl: true,
             recordAsset: false,
           },
           bytesUploaded: 0,

package/corpus/templates/clips/actions/finalize-recording.ts

@@ -596,7 +596,7 @@ export default defineAction({
             typeof resumableSession.meta.filename === "string"
               ? resumableSession.meta.filename
               : "",
-            { skipCompressionWait: true, recordAsset: false },
+            { stableUrl: true, recordAsset: false },
           );
           debugLog("[finalize] resumable upload completed", { id, videoUrl });
           try {
@@ -966,7 +966,7 @@ export default defineAction({
           filename: `${id}.${videoFormat}`,
           mimeType,
           ownerEmail,
-          skipCompressionWait: true,
+          stableUrl: true,
           recordAsset: false,
         });
       } catch (err) {

package/corpus/templates/clips/actions/import-loom-recording.ts

@@ -296,7 +296,7 @@ export default defineAction({
       filename: `${id}.mp4`,
       mimeType: media.mimeType,
       ownerEmail,
-      skipCompressionWait: true,
+      stableUrl: true,
       recordAsset: false,
     });
 

package/corpus/templates/clips/actions/lib/ensure-seekable-video.ts

@@ -218,7 +218,7 @@ export async function ensureRecordingSeekable(params: {
     filename: `${recordingId}.${videoFormat}`,
     mimeType,
     ownerEmail,
-    skipCompressionWait: true,
+    stableUrl: true,
     recordAsset: false,
   });
 

package/corpus/templates/clips/changelog/2026-07-07-clip-video-uploads-now-compress-in-the-background-while-keeping.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-07
+---
+
+Clip video uploads now compress in the background while keeping a single stable playback URL.

package/corpus/templates/clips/changelog/2026-07-07-desktop-settings-and-fn-dictation-are-more-reliable.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Desktop settings stay out of the server URL field on open, and Fn dictation recovers when macOS disables its Input Monitoring tap.

package/corpus/templates/clips/changelog/2026-07-07-desktop-settings-now-includes-a-manual-update-check-with-res.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-07
+---
+
+Desktop settings now include a manual update check with restart status.

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

@@ -81,7 +81,14 @@ import {
   saveBool,
   saveString,
 } from "./lib/storage";
-import { installAndRestart, isUpdatePendingRestart } from "./lib/updater";
+import {
+  canCheckForUpdates,
+  installAndRestart,
+  isUpdatePendingRestart,
+  retryUpdateCheck,
+  useUpdateStatus,
+  type UpdateStatus,
+} from "./lib/updater";
 import { normalizeServerUrl } from "./lib/url";
 import {
   installDesktopVoiceDictation,
@@ -3521,6 +3528,25 @@ function formatStorageBytes(bytes: number): string {
   return `${Math.max(1, Math.round(mb))} MB`;
 }
 
+function desktopUpdateStatusText(status: UpdateStatus): string {
+  switch (status.state) {
+    case "idle":
+      return "Clips checks automatically after launch and every 4 hours.";
+    case "checking":
+      return "Checking for updates...";
+    case "not-available":
+      return "Clips is up to date.";
+    case "available":
+      return `Update ${status.version} found. Downloading now...`;
+    case "downloading":
+      return `Downloading update ${status.version}... ${status.percent}%`;
+    case "downloaded":
+      return `Update ${status.version} is ready. Restart to install it.`;
+    case "error":
+      return `Update check failed: ${status.message}`;
+  }
+}
+
 function Setup({
   initial,
   serverUrl,
@@ -3568,8 +3594,8 @@ function Setup({
 }) {
   const [url, setUrl] = useState(initial ?? DEFAULT_URL);
   const [readinessOpen, setReadinessOpen] = useState(false);
-  const inputRef = useRef<HTMLInputElement | null>(null);
   const featureConfig = useFeatureConfig();
+  const updateStatus = useUpdateStatus();
   const voiceEnabled = featureConfig?.voiceEnabled !== false;
   const meetingsEnabled = featureConfig?.meetingsEnabled !== false;
   const launchAtLoginEnabled = featureConfig?.launchAtLoginEnabled !== false;
@@ -3868,10 +3894,6 @@ function Setup({
     );
   }
 
-  useEffect(() => {
-    inputRef.current?.focus();
-  }, []);
-
   useEffect(() => {
     let cancelled = false;
     const refresh = () => {
@@ -4134,6 +4156,32 @@ function Setup({
     if (providerStatus[byokProvider]) return null;
     return `${keyForByokProvider(byokProvider)} is not set — cleanup will fail until configured.`;
   })();
+  const updateChecksSupported = canCheckForUpdates();
+  const updateBusy =
+    updateStatus.state === "checking" ||
+    updateStatus.state === "available" ||
+    updateStatus.state === "downloading";
+  const updateReady = updateStatus.state === "downloaded";
+  const updateStatusClass =
+    updateStatus.state === "error"
+      ? "setup-warning"
+      : updateStatus.state === "downloaded" ||
+          updateStatus.state === "not-available"
+        ? "setup-success"
+        : "setup-hint";
+  const updateCheckLabel = !updateChecksSupported
+    ? "Release builds only"
+    : updateStatus.state === "checking"
+      ? "Checking..."
+      : updateStatus.state === "downloading"
+        ? `Downloading ${updateStatus.percent}%`
+        : "Check now";
+
+  function checkForDesktopUpdate() {
+    retryUpdateCheck().catch((err) => {
+      console.error("[clips-updater] manual check failed:", err);
+    });
+  }
 
   return (
     <form className="setup" onSubmit={handleSubmit}>
@@ -4161,13 +4209,12 @@ function Setup({
         />
         <input
           id="clips-url"
-          ref={inputRef}
           type="url"
           value={url}
           onChange={(e) => setUrl(e.target.value)}
           placeholder="http://localhost:8080"
         />
-        <button className="primary" type="submit">
+        <button className="secondary setup-connect-button" type="submit">
           Connect
         </button>
       </div>
@@ -4214,6 +4261,46 @@ function Setup({
         </div>
       </div>
 
+      <div className="setup-section">
+        <SettingLabel
+          label="Desktop updates"
+          hint="Check the signed Clips desktop release channel and download any available update."
+        />
+        <div className="setup-button-row">
+          <button
+            type="button"
+            className="secondary"
+            onClick={checkForDesktopUpdate}
+            disabled={!updateChecksSupported || updateBusy || updateReady}
+          >
+            <IconRefresh
+              size={15}
+              stroke={1.9}
+              className={updateBusy ? "update-spinner" : undefined}
+            />
+            {updateCheckLabel}
+          </button>
+          {updateReady ? (
+            <button
+              type="button"
+              className="secondary"
+              onClick={() => {
+                installAndRestart().catch((err) => {
+                  console.error("[clips-updater] relaunch failed:", err);
+                });
+              }}
+            >
+              Restart to install
+            </button>
+          ) : null}
+        </div>
+        <p className={updateStatusClass}>
+          {updateChecksSupported
+            ? desktopUpdateStatusText(updateStatus)
+            : "Update checks are available in signed release builds."}
+        </p>
+      </div>
+
       <div className="setup-section-heading">Permissions</div>
 
       <div className="setup-section">

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

@@ -26,6 +26,13 @@ let cachedStatus: UpdateStatus = { state: "idle" };
 let pendingUpdate: Update | null = null;
 const listeners = new Set<StatusListener>();
 let started = false;
+let checkInFlight: Promise<void> | null = null;
+
+function canRunUpdateChecks() {
+  // Dev and local release builds are for testing the current checkout. Do not
+  // replace them with the published auto-update channel.
+  return !import.meta.env.DEV && !__CLIPS_DESKTOP_LOCAL_BUILD__;
+}
 
 function setStatus(next: UpdateStatus) {
   cachedStatus = next;
@@ -33,55 +40,60 @@ function setStatus(next: UpdateStatus) {
 }
 
 async function runCheck() {
-  try {
-    setStatus({ state: "checking" });
-    const update = await check();
-    if (!update) {
-      setStatus({ state: "not-available" });
-      return;
-    }
-    pendingUpdate = update;
-    const version = update.version;
-    const notes = update.body ?? undefined;
-    setStatus({ state: "available", version, notes });
-
-    // Download ONLY — do not install here. On macOS `install` swaps the .app
-    // bundle on disk while this process keeps running, which invalidates the
-    // running process's Screen Recording (TCC) grant and breaks capture until
-    // relaunch. We defer the swap to `installAndRestart()` so a downloaded-but-
-    // not-yet-installed update leaves the running app fully functional; the
-    // user records normally until they choose to restart.
-    let total = 0;
-    let downloaded = 0;
-    await update.download((event) => {
-      if (event.event === "Started") {
-        total = event.data.contentLength ?? 0;
-        downloaded = 0;
-        setStatus({ state: "downloading", version, notes, percent: 0 });
-      } else if (event.event === "Progress") {
-        downloaded += event.data.chunkLength;
-        const percent =
-          total > 0 ? Math.min(100, Math.round((downloaded / total) * 100)) : 0;
-        setStatus({ state: "downloading", version, notes, percent });
-      } else if (event.event === "Finished") {
-        setStatus({ state: "downloaded", version, notes });
+  if (checkInFlight) return checkInFlight;
+
+  checkInFlight = (async () => {
+    try {
+      setStatus({ state: "checking" });
+      const update = await check();
+      if (!update) {
+        setStatus({ state: "not-available" });
+        return;
       }
-    });
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    setStatus({ state: "error", message });
-  }
+      pendingUpdate = update;
+      const version = update.version;
+      const notes = update.body ?? undefined;
+      setStatus({ state: "available", version, notes });
+
+      // Download ONLY — do not install here. On macOS `install` swaps the .app
+      // bundle on disk while this process keeps running, which invalidates the
+      // running process's Screen Recording (TCC) grant and breaks capture until
+      // relaunch. We defer the swap to `installAndRestart()` so a downloaded-but-
+      // not-yet-installed update leaves the running app fully functional; the
+      // user records normally until they choose to restart.
+      let total = 0;
+      let downloaded = 0;
+      await update.download((event) => {
+        if (event.event === "Started") {
+          total = event.data.contentLength ?? 0;
+          downloaded = 0;
+          setStatus({ state: "downloading", version, notes, percent: 0 });
+        } else if (event.event === "Progress") {
+          downloaded += event.data.chunkLength;
+          const percent =
+            total > 0
+              ? Math.min(100, Math.round((downloaded / total) * 100))
+              : 0;
+          setStatus({ state: "downloading", version, notes, percent });
+        } else if (event.event === "Finished") {
+          setStatus({ state: "downloaded", version, notes });
+        }
+      });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      setStatus({ state: "error", message });
+    } finally {
+      checkInFlight = null;
+    }
+  })();
+
+  return checkInFlight;
 }
 
 function startUpdateLoop() {
   if (started) return;
   started = true;
-  // Skip update checks in dev — there's no release endpoint to check.
-  if (import.meta.env.DEV) return;
-  // Local release builds are for testing the current checkout. Do not replace
-  // them with the published auto-update channel just because package.json has
-  // a lower development version.
-  if (__CLIPS_DESKTOP_LOCAL_BUILD__) return;
+  if (!canRunUpdateChecks()) return;
   // Check 3s after launch (let the popover finish first paint), then every
   // 4 hours. Matches the cadence used by the Electron app.
   setTimeout(runCheck, 3000);
@@ -125,11 +137,16 @@ export function isUpdatePendingRestart(): boolean {
   return cachedStatus.state === "downloaded";
 }
 
+export function canCheckForUpdates(): boolean {
+  return canRunUpdateChecks();
+}
+
 /**
  * Manual retry entry point. Used by the UpdateBanner's error state to let
  * users re-attempt after a signature-verification / download / network
  * failure. Runs a full check + download pass, same as the periodic loop.
  */
 export function retryUpdateCheck(): Promise<void> {
+  if (!canRunUpdateChecks()) return Promise.resolve();
   return runCheck();
 }

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

@@ -835,6 +835,11 @@ body[data-clips-route="recording-pill"] #root {
   cursor: not-allowed;
 }
 
+.setup-connect-button {
+  height: 38px;
+  margin-top: 2px;
+}
+
 .primary.start {
   margin-top: 2px;
 }