@agent-native/core 0.90.9 → 0.90.11

package/corpus/core/src/client/analytics.ts

@@ -1005,8 +1005,16 @@ function configuredSessionReplayOptions(
   config: boolean | SessionReplayOptions | undefined,
   tracking: { endpoint?: string; publicKey?: string } = {},
 ): SessionReplayOptions | null {
-  const publicKey = tracking.publicKey || _agentNativeAnalyticsPublicKey;
-  const trackingEndpoint = tracking.endpoint || _agentNativeAnalyticsEndpoint;
+  const env = (import.meta.env as Record<string, string | undefined>) ?? {};
+  const publicKey =
+    tracking.publicKey ||
+    _agentNativeAnalyticsPublicKey ||
+    env.VITE_AGENT_NATIVE_ANALYTICS_PUBLIC_KEY;
+  const trackingEndpoint =
+    tracking.endpoint ||
+    _agentNativeAnalyticsEndpoint ||
+    env.VITE_AGENT_NATIVE_ANALYTICS_ENDPOINT ||
+    (publicKey ? AGENT_NATIVE_ANALYTICS_DEFAULT_ENDPOINT : undefined);
   const endpoint = trackingEndpoint
     ? replayEndpointFromTrackingEndpoint(trackingEndpoint)
     : undefined;
@@ -1034,7 +1042,13 @@ function configuredSessionReplayOptions(
     if (config.enabled === false) return null;
     return withTrackingDefaults(config);
   }
-  return sessionReplayEnabledFromEnv() ? withTrackingDefaults({}) : null;
+  const autoEnabledByAnalyticsKey =
+    !!publicKey &&
+    (typeof window === "undefined" ||
+      !isLocalAnalyticsHostname(window.location.hostname));
+  return sessionReplayEnabledFromEnv() || autoEnabledByAnalyticsKey
+    ? withTrackingDefaults({})
+    : null;
 }
 
 function replayExtraPropertiesWithDefaults(

package/corpus/core/src/client/blocks/library/wireframe-kit.tsx

@@ -121,6 +121,7 @@ export function useIsDark(): boolean {
  */
 export const KitConfigContext = createContext<{
   skeleton?: boolean;
+  flushFrame?: boolean;
   sketch?: number;
   theme?: "light" | "dark";
   style?: "sketchy" | "clean";
@@ -195,6 +196,7 @@ export function Screen({
   const isSkeleton = skeleton || Boolean(cfg.skeleton);
   const wfStyle = cfg.style ?? "sketchy";
   const wfTheme = theme ?? cfg.theme ?? "light";
+  const effectivePad = cfg.flushFrame ? 0 : pad;
   void sketch;
   return (
     <div
@@ -218,7 +220,7 @@ export function Screen({
         lineHeight: 1.25,
         display: "flex",
         flexDirection: "column",
-        padding: pad,
+        padding: effectivePad,
         boxSizing: "border-box",
         overflow: "hidden",
         ...style,

package/corpus/core/src/client/blocks/library/wireframe.tsx

@@ -414,7 +414,12 @@ function KitArtboard({
       caption={data.caption}
       render={({ theme, style }) => (
         <KitConfigContext.Provider
-          value={{ skeleton: data.skeleton, theme, style }}
+          value={{
+            skeleton: data.skeleton,
+            flushFrame: !showFrame,
+            theme,
+            style,
+          }}
         >
           {renderKitScreen(data.screen ?? [])}
         </KitConfigContext.Provider>

package/corpus/core/src/db/client.ts

@@ -856,15 +856,18 @@ export function isBackgroundFunctionPoolContext(): boolean {
   ) {
     return true;
   }
-  // Set by the HMAC-authenticated agent-chat `_process-run` route before it
-  // re-enters the normal chat handler. This mirrors the marker-only runtime
-  // proof used by durable-background.ts without importing agent code into db/.
-  if (
-    (globalThis as Record<string, unknown>)
-      .__AGENT_NATIVE_BACKGROUND_RUNTIME_EXPECTED__ === true
-  ) {
-    return true;
-  }
+  // NOTE: we deliberately do NOT trust `__AGENT_NATIVE_BACKGROUND_RUNTIME_EXPECTED__`
+  // here. That flag is set from the dispatch MARKER (which URL the foreground
+  // targeted), not from proof the request actually LANDED on a background
+  // function. A worker dispatched toward `-background` but routed onto the ~60s
+  // synchronous function would otherwise take the 8-connection background pool
+  // while running as one of MANY warm sync-function instances — multiplying
+  // Neon connections and exhausting the pooled endpoint ("connection
+  // terminated" / statement timeouts / failed heartbeat writes → stale runs).
+  // The genuine `-background` function sets `__AGENT_NATIVE_BACKGROUND_RUNTIME__`
+  // as its first cold-start statement, so a real background worker still gets
+  // the larger pool via the check above. Mirrors the same proof-of-landing
+  // tightening applied to `shouldUseBackgroundFunctionTimeoutForWorker`.
   const lambdaName = process.env.AWS_LAMBDA_FUNCTION_NAME;
   if (
     typeof lambdaName === "string" &&

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

@@ -13,14 +13,6 @@ const LARGE_FILE_THRESHOLD_BYTES = 30 * 1024 * 1024;
 const UPLOAD_TIMEOUT_MS = 120_000;
 const SMALL_FILE_RETRY_DELAYS_MS = [600, 1800];
 
-function enabledFlag(value: unknown): boolean {
-  return /^(true|1|yes|on)$/i.test(String(value || "").trim());
-}
-
-function stableUrlOptInEnabled(): boolean {
-  return enabledFlag(process.env.CLIPS_STABLE_URL_OPTIN);
-}
-
 function builderUploadHost(): string {
   return (
     process.env.BUILDER_APP_HOST ||
@@ -52,12 +44,9 @@ function fetchWithTimeout(url: string, init: RequestInit): Promise<Response> {
   );
 }
 
-function setSkipCompressionQueryParams(url: URL): void {
-  url.searchParams.set("skipCompressionWait", "true");
-  url.searchParams.set("skipCompression", "true");
-  if (stableUrlOptInEnabled()) {
-    url.searchParams.set("stableUrl", "true");
-  }
+function setStableUrlQueryParam(url: URL): void {
+  // Stable URLs let Builder compress asynchronously without changing the media URL.
+  url.searchParams.set("stableUrl", "true");
 }
 
 function setRecordAssetQueryParam(
@@ -121,7 +110,7 @@ async function uploadLargeFileViaSignedUrl(
     assetId,
     input.filename,
     {
-      skipCompressionWait: input.skipCompressionWait,
+      stableUrl: input.stableUrl,
       recordAsset: input.recordAsset,
     },
   );
@@ -177,12 +166,12 @@ async function completeBuilderUpload(
   privateKey: string,
   assetId: string,
   filename: string | undefined,
-  options?: { skipCompressionWait?: boolean; recordAsset?: boolean },
+  options?: { stableUrl?: boolean; recordAsset?: boolean },
 ): Promise<{ url: string; id?: string }> {
   const host = builderUploadHost();
   const url = new URL("/api/v1/upload/complete", host);
-  if (options?.skipCompressionWait) {
-    setSkipCompressionQueryParams(url);
+  if (options?.stableUrl) {
+    setStableUrlQueryParam(url);
   }
   setRecordAssetQueryParam(url, options?.recordAsset);
   const res = await fetchWithTimeout(url.toString(), {
@@ -287,8 +276,8 @@ export const builderFileUploadProvider: FileUploadProvider = {
 
     const url = new URL("/api/v1/upload", builderUploadHost());
     if (filename) url.searchParams.set("name", filename);
-    if (input.skipCompressionWait) {
-      setSkipCompressionQueryParams(url);
+    if (input.stableUrl) {
+      setStableUrlQueryParam(url);
     }
     setRecordAssetQueryParam(url, input.recordAsset);
 
@@ -429,9 +418,7 @@ export const builderFileUploadProvider: FileUploadProvider = {
         assetId,
         filename,
         {
-          skipCompressionWait:
-            options?.skipCompressionWait ||
-            session.meta.skipCompressionWait === true,
+          stableUrl: options?.stableUrl || session.meta.stableUrl === true,
           recordAsset:
             options?.recordAsset ??
             (session.meta.recordAsset === false ? false : undefined),

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/shared/reasoning-effort.ts

@@ -98,6 +98,29 @@ export function reasoningEffortLabel(effort: ReasoningEffort | undefined) {
   return REASONING_EFFORT_LABELS[effort ?? "auto"];
 }
 
+/**
+ * One tier down from each effort, stopping at "minimal" — "none"/"auto"
+ * (not really "tiers") and "minimal" itself are left unchanged. Used by the
+ * empty-final-response retry so a retried turn asks for meaningfully less
+ * reasoning instead of repeating the exact request that came back empty.
+ */
+const REASONING_EFFORT_STEP_DOWN: Partial<
+  Record<ReasoningEffort, ReasoningEffort>
+> = {
+  max: "xhigh",
+  xhigh: "high",
+  high: "medium",
+  medium: "low",
+  low: "minimal",
+};
+
+export function stepDownReasoningEffort(
+  effort: ReasoningEffort | undefined,
+): ReasoningEffort | undefined {
+  if (!effort) return effort;
+  return REASONING_EFFORT_STEP_DOWN[effort] ?? effort;
+}
+
 function isGPTReasoningModel(model: string) {
   return /^gpt-5/.test(model) || /^o\d/.test(model);
 }

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/actions/regenerate-chapters.ts

@@ -23,6 +23,12 @@ export default defineAction({
     "Ask the agent to generate chapters for this recording based on its transcript (and the full video when Include full video is enabled). The agent identifies topic transitions and calls set-chapters.",
   schema: z.object({
     recordingId: z.string().describe("Recording ID"),
+    openInChat: z
+      .boolean()
+      .optional()
+      .describe(
+        "When true, focus the queued generation request in the agent chat instead of keeping it hidden.",
+      ),
   }),
   run: async (args) => {
     await assertAccess("recording", args.recordingId, "editor");
@@ -57,6 +63,7 @@ export default defineAction({
       segmentsJson: transcript?.segmentsJson ?? "[]",
       transcriptText: transcript?.fullText ?? "",
       includeFullVideoInAi,
+      openInChat: args.openInChat === true,
       message: withFullVideoAiInstructions(
         baseMessage,
         args.recordingId,

package/corpus/templates/clips/app/hooks/use-auto-title.ts

@@ -15,6 +15,7 @@ import {
   agentNativePath,
   callAction,
   sendToAgentChat,
+  type AgentChatMessage,
 } from "@agent-native/core/client";
 import { fullVideoAiModelSelection } from "@shared/clips-ai-prefs";
 import { useEffect, useRef } from "react";
@@ -55,6 +56,7 @@ interface AiRequest {
   thresholdMs?: number;
   message?: string;
   includeFullVideoInAi?: boolean;
+  openInChat?: boolean;
 }
 
 const DISPATCHABLE_REQUESTS = new Set([
@@ -201,25 +203,33 @@ function buildRequestContext(rec: RecordingSummary, request: AiRequest) {
   };
 }
 
-function dispatchAiRequest(rec: RecordingSummary, request: AiRequest) {
+export function buildAiRequestChatOptions(
+  rec: RecordingSummary,
+  request: AiRequest,
+): AgentChatMessage {
   const includeFullVideo = request.includeFullVideoInAi === true;
   const gemini = includeFullVideo ? fullVideoAiModelSelection() : null;
-  sendToAgentChat({
+  const openInChat = request.openInChat === true;
+  return {
     message:
       request.message ??
       `Handle queued ${request.kind} work for recording ${rec.id}.`,
     context: JSON.stringify(buildRequestContext(rec, request)),
     submit: true,
-    openSidebar: false,
+    openSidebar: openInChat ? true : false,
     newTab: true,
-    background: true,
+    background: !openInChat,
     ...(gemini
       ? {
           engine: gemini.engine,
           model: gemini.model,
         }
       : {}),
-  });
+  };
+}
+
+function dispatchAiRequest(rec: RecordingSummary, request: AiRequest) {
+  sendToAgentChat(buildAiRequestChatOptions(rec, request));
 }
 
 function parseJsonArray(raw: string | undefined): unknown[] {

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

@@ -4,7 +4,6 @@ import {
   IconBrandApple,
   IconBrandWindows,
   IconExternalLink,
-  IconPlayerRecord,
 } from "@tabler/icons-react";
 import { useEffect, useState } from "react";
 
@@ -201,9 +200,18 @@ export default function DownloadPage() {
             href={appPath("/")}
             className="flex items-center gap-2 font-semibold"
           >
-            <span className="grid h-7 w-7 place-items-center rounded-md bg-primary text-primary-foreground">
-              <IconPlayerRecord className="h-4 w-4" />
-            </span>
+            <img
+              src={appPath("/agent-native-icon-light.svg")}
+              alt=""
+              aria-hidden="true"
+              className="block h-4 w-auto shrink-0 dark:hidden"
+            />
+            <img
+              src={appPath("/agent-native-icon-dark.svg")}
+              alt=""
+              aria-hidden="true"
+              className="hidden h-4 w-auto shrink-0 dark:block"
+            />
             <span>Clips</span>
           </a>
           <a

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

@@ -1096,6 +1096,7 @@ export default function RecordingPage() {
                   onSelect={() =>
                     regenerateChapters.mutate({
                       recordingId: recording.id,
+                      openInChat: true,
                     } as any)
                   }
                 >

package/corpus/templates/clips/changelog/2026-07-07-auto-generated-chapter-requests-now-open-the-matching-agent-.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-07-07
+---
+
+Auto-generated chapter requests now open the matching agent chat tab.

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/changelog/2026-07-07-the-clips-desktop-download-page-now-uses-the-agent-native-ap.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-07-07
+---
+
+The Clips Desktop download page now uses the Agent Native app icon in its header.