@agent-native/core 0.182.1 → 0.182.2-nightly-20260917210345

package/corpus/README.md

@@ -31,4 +31,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 
 ## Generated Counts
 
-- template files: 9518
+- template files: 9525

package/corpus/templates/clips/app/root.tsx

@@ -212,6 +212,16 @@ function ClipsExtensionAuthBridge() {
     const targetExtensionId = extensionId;
 
     let cancelled = false;
+    let removeBridgeListener: (() => void) | null = null;
+
+    const completeExtensionSignIn = () => {
+      if (cancelled) return;
+      const cleaned = new URL(window.location.href);
+      cleaned.searchParams.delete("clipsExtensionAuth");
+      cleaned.searchParams.delete("clipsExtensionId");
+      window.history.replaceState(window.history.state, "", cleaned);
+      setShowAuthSuccess(true);
+    };
 
     async function sendSessionToExtension() {
       const runtime = (
@@ -219,7 +229,6 @@ function ClipsExtensionAuthBridge() {
           chrome?: { runtime?: ExternalChromeRuntime };
         }
       ).chrome?.runtime;
-      if (!runtime?.sendMessage) return;
 
       const response = await fetch(appPath("/_agent-native/auth/session"), {
         credentials: "include",
@@ -233,21 +242,60 @@ function ClipsExtensionAuthBridge() {
         return;
       }
 
+      const message = {
+        source: "clips-auth-bridge",
+        kind: "session",
+        token: session.token,
+        email: session.email,
+        clipsBaseUrl: window.location.origin,
+      } as const;
+      const sendViaPageBridge = () => {
+        const onMessage = (event: MessageEvent) => {
+          if (
+            event.source !== window ||
+            event.origin !== window.location.origin
+          ) {
+            return;
+          }
+          const data = event.data as
+            | { source?: unknown; kind?: unknown; ok?: unknown }
+            | undefined;
+          if (
+            data?.source !== "clips-auth-bridge" ||
+            data.kind !== "session-result"
+          ) {
+            return;
+          }
+          removeBridgeListener?.();
+          removeBridgeListener = null;
+          if (data.ok === true) completeExtensionSignIn();
+        };
+        removeBridgeListener = () =>
+          window.removeEventListener("message", onMessage);
+        window.addEventListener("message", onMessage);
+        window.postMessage(message, window.location.origin);
+      };
+
+      if (!runtime?.sendMessage) {
+        sendViaPageBridge();
+        return;
+      }
+
       runtime.sendMessage(
         targetExtensionId,
         {
           type: "CLIPS_AUTH_SESSION",
-          token: session.token,
-          email: session.email,
-          clipsBaseUrl: window.location.origin,
+          token: message.token,
+          email: message.email,
+          clipsBaseUrl: message.clipsBaseUrl,
         },
         (extensionResponse) => {
-          if (cancelled || runtime.lastError || !extensionResponse?.ok) return;
-          const cleaned = new URL(window.location.href);
-          cleaned.searchParams.delete("clipsExtensionAuth");
-          cleaned.searchParams.delete("clipsExtensionId");
-          window.history.replaceState(window.history.state, "", cleaned);
-          setShowAuthSuccess(true);
+          if (cancelled) return;
+          if (!runtime.lastError && extensionResponse?.ok) {
+            completeExtensionSignIn();
+            return;
+          }
+          sendViaPageBridge();
         },
       );
     }
@@ -255,6 +303,7 @@ function ClipsExtensionAuthBridge() {
     void sendSessionToExtension();
     return () => {
       cancelled = true;
+      removeBridgeListener?.();
     };
   }, [location.search]);
 

package/corpus/templates/clips/changelog/2026-09-17-desktop-popover-closes-when-clicking-away.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-17
+---
+
+The desktop popover now closes when you click away from it.

package/corpus/templates/clips/changelog/2026-09-17-self-hosted-extension-sign-in.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-17
+---
+
+Self-hosted Clips extensions now finish sign-in reliably.

package/corpus/templates/clips/chrome-extension/src/background.ts

@@ -77,6 +77,13 @@ type PopupStartMessage = {
   settings?: Partial<ExtensionSettings>;
 };
 
+type AuthSessionMessage = {
+  type: "CLIPS_AUTH_SESSION";
+  token?: string;
+  email?: string;
+  clipsBaseUrl?: string;
+};
+
 type ExternalMessage =
   | {
       type: "CLIPS_CAPTURE_START";
@@ -93,12 +100,7 @@ type ExternalMessage =
       type: "CLIPS_CAPTURE_CANCEL";
       sessionId?: string;
     }
-  | {
-      type: "CLIPS_AUTH_SESSION";
-      token?: string;
-      email?: string;
-      clipsBaseUrl?: string;
-    };
+  | AuthSessionMessage;
 
 type ChromeTab = {
   id?: number;
@@ -2237,6 +2239,35 @@ async function handlePopupSignIn(message: {
   return { ok: true };
 }
 
+async function handleAuthSession(
+  message: AuthSessionMessage,
+  senderUrl?: string,
+) {
+  const settings = await readSettings();
+  const clipsBaseUrl = normalizeBaseUrl(
+    message.clipsBaseUrl ?? settings.clipsBaseUrl,
+  );
+  const senderOrigin = originOf(senderUrl);
+  if (
+    !senderOrigin ||
+    senderOrigin !== originOf(clipsBaseUrl) ||
+    senderOrigin !== originOf(settings.clipsBaseUrl)
+  ) {
+    return { ok: false, error: "Auth message came from the wrong origin." };
+  }
+  if (typeof message.token !== "string" || !message.token.trim()) {
+    return { ok: false, error: "Missing auth token." };
+  }
+  await storageSet({ ...settings, clipsBaseUrl });
+  await saveAuthSession({
+    token: message.token,
+    email: typeof message.email === "string" ? message.email : undefined,
+    clipsBaseUrl,
+    savedAt: nowIso(),
+  });
+  return { ok: true };
+}
+
 function summarize(snapshot: {
   endedAt: string;
   consoleLogs: ConsoleLog[];
@@ -2734,25 +2765,7 @@ async function handleExternalMessage(
   }
 
   if (message.type === "CLIPS_AUTH_SESSION") {
-    const settings = await readSettings();
-    const clipsBaseUrl = normalizeBaseUrl(
-      message.clipsBaseUrl ?? settings.clipsBaseUrl,
-    );
-    const senderOrigin = originOf(sender?.url);
-    if (!senderOrigin || senderOrigin !== originOf(clipsBaseUrl)) {
-      return { ok: false, error: "Auth message came from the wrong origin." };
-    }
-    if (typeof message.token !== "string" || !message.token.trim()) {
-      return { ok: false, error: "Missing auth token." };
-    }
-    await storageSet({ ...settings, clipsBaseUrl });
-    await saveAuthSession({
-      token: message.token,
-      email: typeof message.email === "string" ? message.email : undefined,
-      clipsBaseUrl,
-      savedAt: nowIso(),
-    });
-    return { ok: true };
+    return handleAuthSession(message, sender?.url);
   }
 
   if (message.type === "CLIPS_CAPTURE_START") {
@@ -2858,6 +2871,13 @@ async function dispatchRuntimeMessage(
 ): Promise<unknown> {
   const type = (message as { type?: unknown }).type;
 
+  if (type === "CLIPS_AUTH_SESSION") {
+    return handleAuthSession(
+      message as AuthSessionMessage,
+      sender?.tab?.url ?? sender?.url,
+    );
+  }
+
   if (type === "CLIPS_DIAGNOSTIC_INTERACTION") {
     const tabId = sender?.tab?.id;
     const sessionId =

package/corpus/templates/clips/chrome-extension/src/content-script.ts

@@ -141,6 +141,49 @@
     }
     sendDiagnosticNavigation(data.url);
   });
+
+  window.addEventListener("message", (event) => {
+    if (event.source !== window || event.origin !== window.location.origin) {
+      return;
+    }
+    const data = event.data as
+      | {
+          source?: unknown;
+          kind?: unknown;
+          token?: unknown;
+          email?: unknown;
+          clipsBaseUrl?: unknown;
+        }
+      | undefined;
+    if (
+      data?.source !== "clips-auth-bridge" ||
+      data.kind !== "session" ||
+      typeof data.token !== "string" ||
+      typeof data.clipsBaseUrl !== "string"
+    ) {
+      return;
+    }
+    chrome.runtime.sendMessage(
+      {
+        type: "CLIPS_AUTH_SESSION",
+        token: data.token,
+        ...(typeof data.email === "string" ? { email: data.email } : {}),
+        clipsBaseUrl: data.clipsBaseUrl,
+      },
+      (response?: { ok?: boolean; error?: string }) => {
+        void chrome.runtime.lastError;
+        window.postMessage(
+          {
+            source: "clips-auth-bridge",
+            kind: "session-result",
+            ok: response?.ok === true,
+            ...(response?.error ? { error: response.error } : {}),
+          },
+          window.location.origin,
+        );
+      },
+    );
+  });
   window.postMessage(
     { source: "clips-diagnostic-history", kind: "request-token" },
     "*",

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

@@ -43,6 +43,8 @@ mod util;
 mod whisper_model;
 mod whisper_speech;
 
+use std::time::Duration;
+
 use tauri::{Emitter, Manager};
 
 use clips::{position_popover, toggle_popover};
@@ -62,6 +64,12 @@ use util::{
 // should replace with their real icon.
 pub(crate) const TRAY_PNG: &[u8] = include_bytes!("../icons/tray.png");
 
+const POPOVER_BLUR_GUARD: Duration = Duration::from_millis(1500);
+
+fn popover_blur_delay(elapsed: Duration) -> Option<Duration> {
+    (elapsed < POPOVER_BLUR_GUARD).then(|| POPOVER_BLUR_GUARD - elapsed)
+}
+
 fn present_popover(app: &tauri::AppHandle) {
     if let Some(window) = app.get_webview_window("popover") {
         set_capture_excluded(&window);
@@ -480,7 +488,7 @@ pub fn run() {
             }
 
             // Hide the popover on blur so it feels like a real menu-bar popover.
-            // The 250ms guard is the important bit — during the tray-click
+            // The 1.5s guard is the important bit — during the tray-click
             // itself macOS briefly steals focus from the popover, which would
             // fire Focused(false) and hide the window we literally just showed.
             if let Some(window) = app.get_webview_window("popover") {
@@ -511,11 +519,37 @@ pub fn run() {
                         let shown_at = app_handle
                             .try_state::<PopoverShownAt>()
                             .and_then(|s| s.0.lock().ok().and_then(|g| *g));
-                        let elapsed_ms = shown_at
-                            .map(|t| t.elapsed().as_millis())
-                            .unwrap_or(u128::MAX);
-                        dlog!("[clips-tray] popover blur, elapsed_ms={}", elapsed_ms);
-                        if elapsed_ms >= 1500 {
+                        let elapsed = shown_at.map(|t| t.elapsed()).unwrap_or(Duration::MAX);
+                        dlog!(
+                            "[clips-tray] popover blur, elapsed_ms={}",
+                            elapsed.as_millis()
+                        );
+                        if let Some(delay) = popover_blur_delay(elapsed) {
+                            let Some(shown_at) = shown_at else {
+                                return;
+                            };
+                            let delayed_handle = handle.clone();
+                            let delayed_app_handle = app_handle.clone();
+                            tauri::async_runtime::spawn(async move {
+                                tokio::time::sleep(delay).await;
+                                let still_current = delayed_app_handle
+                                    .try_state::<PopoverShownAt>()
+                                    .and_then(|state| {
+                                        state.0.lock().ok().map(|guard| *guard == Some(shown_at))
+                                    })
+                                    .unwrap_or(false);
+                                if !still_current
+                                    || is_recording_active(&delayed_app_handle)
+                                    || !config::auto_hide_popover_enabled(&delayed_app_handle)
+                                    || delayed_handle.is_focused().unwrap_or(true)
+                                {
+                                    return;
+                                }
+                                let _ = delayed_handle.hide();
+                                clips::close_bubble_if_idle(&delayed_app_handle);
+                                let _ = delayed_app_handle.emit("clips:popover-visible", false);
+                            });
+                        } else {
                             let _ = handle.hide();
                             clips::close_bubble_if_idle(&app_handle);
                             let _ = app_handle.emit("clips:popover-visible", false);
@@ -623,3 +657,18 @@ pub fn run() {
             }
         });
 }
+
+#[cfg(test)]
+mod tests {
+    use super::{popover_blur_delay, POPOVER_BLUR_GUARD};
+    use std::time::Duration;
+
+    #[test]
+    fn retries_blur_until_guard_expires() {
+        assert_eq!(
+            popover_blur_delay(Duration::from_millis(400)),
+            Some(Duration::from_millis(1100))
+        );
+        assert_eq!(popover_blur_delay(POPOVER_BLUR_GUARD), None);
+    }
+}

package/corpus/templates/design/.generated/bridge/editor-chrome.generated.ts

@@ -3320,6 +3320,7 @@ export const editorChromeBridgeScript: string = `"use strict";
         alignItems: parentStyles.alignItems,
         justifyContent: parentStyles.justifyContent,
         gap: parentStyles.gap,
+        gridAutoFlow: parentStyles.gridAutoFlow,
         gridTemplateColumns: parentStyles.gridTemplateColumns,
         gridTemplateRows: parentStyles.gridTemplateRows,
         position: parentStyles.position

package/corpus/templates/design/actions/add-localhost-screens.ts

@@ -17,6 +17,7 @@ import {
 } from "../server/lib/design-data-mutation.js";
 import { snapshotDesignBeforeAgentEdit } from "../server/lib/design-versions.js";
 import { resolveLocalhostConnectionScope } from "../server/lib/localhost-connection.js";
+import { withDesignSourceMutationTransaction } from "../server/source-workspace.js";
 import {
   mergeCanvasFramePlacements,
   parseCanvasFrameGeometryById,
@@ -938,7 +939,7 @@ export default defineAction({
         )
           ? preferredExisting
           : undefined;
-      const existing =
+      let existing =
         matchingPreferredExisting ??
         routeCandidates.find((candidate) => {
           const frame = existingCanvasFrames[candidate.id];
@@ -997,27 +998,51 @@ export default defineAction({
       seenRouteRequestKeys.add(routeRequestKey);
 
       if (existing) {
-        await db
-          .update(schema.designFiles)
-          .set({ content: url, fileType: "html", updatedAt: now })
-          .where(eq(schema.designFiles.id, existing.id));
-        if (await hasCollabState(existing.id)) {
-          await applyText(existing.id, url, "content", "agent");
+        const updated = await withDesignSourceMutationTransaction(
+          designId,
+          async (tx) => {
+            const [current] = await tx
+              .select({ id: schema.designFiles.id })
+              .from(schema.designFiles)
+              .where(
+                and(
+                  eq(schema.designFiles.id, existing!.id),
+                  eq(schema.designFiles.designId, designId),
+                ),
+              )
+              .limit(1);
+            if (!current) return false;
+            await tx
+              .update(schema.designFiles)
+              .set({ content: url, fileType: "html", updatedAt: now })
+              .where(eq(schema.designFiles.id, existing!.id));
+            return true;
+          },
+        );
+        if (updated) {
+          if (await hasCollabState(existing.id)) {
+            await applyText(existing.id, url, "content", "agent");
+          } else {
+            await seedFromText(existing.id, url);
+          }
         } else {
-          await seedFromText(existing.id, url);
+          existing = undefined;
         }
-      } else {
+      }
+      if (!existing) {
         for (let attempt = 0; ; attempt += 1) {
           try {
-            await db.insert(schema.designFiles).values({
-              id: fileId,
-              designId,
-              filename,
-              fileType: "html",
-              content: url,
-              createdAt: now,
-              updatedAt: now,
-            });
+            await withDesignSourceMutationTransaction(designId, (tx) =>
+              tx.insert(schema.designFiles).values({
+                id: fileId,
+                designId,
+                filename,
+                fileType: "html",
+                content: url,
+                createdAt: now,
+                updatedAt: now,
+              }),
+            );
             await seedFromText(fileId, url);
             break;
           } catch (err) {
@@ -1048,10 +1073,17 @@ export default defineAction({
               routeUrlsMatch(winner.content, url)
             ) {
               fileId = winner.id;
-              await db
-                .update(schema.designFiles)
-                .set({ content: url, fileType: "html", updatedAt: now })
-                .where(eq(schema.designFiles.id, winner.id));
+              await withDesignSourceMutationTransaction(designId, (tx) =>
+                tx
+                  .update(schema.designFiles)
+                  .set({ content: url, fileType: "html", updatedAt: now })
+                  .where(
+                    and(
+                      eq(schema.designFiles.id, winner.id),
+                      eq(schema.designFiles.designId, designId),
+                    ),
+                  ),
+              );
               if (await hasCollabState(winner.id)) {
                 await applyText(winner.id, url, "content", "agent");
               } else {

package/corpus/templates/design/actions/apply-visual-edit.ts

@@ -1458,6 +1458,7 @@ export default defineAction({
 
       const workspace = await resolveSourceWorkspace(file.designId, {
         includeContent: true,
+        includeBoard: true,
       });
       if (workspace.sourceType !== "inline") {
         return noWrite(

package/corpus/templates/design/actions/create-design-from-template.ts

@@ -17,6 +17,7 @@ import {
   remapTemplateFileIds,
   templateFileDimensions,
 } from "../server/lib/design-template-data.js";
+import { withDesignSourceMutationTransaction } from "../server/source-workspace.js";
 import { BOARD_FILENAME } from "../shared/board-file.js";
 import { getDesignTemplatePreset } from "../shared/design-template-presets.js";
 import { countLockedLayersAcrossFiles } from "../shared/locked-layers.js";
@@ -24,6 +25,10 @@ import { annotateScreenHtmlForPersist } from "../shared/screen-annotation.js";
 import { sourceContentHash } from "../shared/source-workspace.js";
 import getDesignSystem from "./get-design-system.js";
 
+type DesignTransaction = Parameters<
+  Parameters<ReturnType<typeof getDb>["transaction"]>[0]
+>[0];
+
 interface TemplateFile {
   id: string;
   filename: string;
@@ -168,39 +173,6 @@ export default defineAction({
     let targetExistingData: Record<string, unknown> = {};
     if (targetDesignId) {
       await assertAccess("design", targetDesignId, "editor");
-      // The editor creates the board row on mount, so a design with nothing
-      // drawn in it already has one file. Screens are what count as content.
-      const [existingDesign] = await db
-        .select({ data: schema.designs.data })
-        .from(schema.designs)
-        .where(eq(schema.designs.id, targetDesignId))
-        .limit(1);
-      if (typeof existingDesign?.data === "string") {
-        try {
-          const parsed = JSON.parse(existingDesign.data);
-          if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-            targetExistingData = parsed as Record<string, unknown>;
-          }
-        } catch {
-          // coercion-ok: unreadable prior data is replaced wholesale below,
-          // which is the same outcome as the create path.
-        }
-      }
-      const [existing] = await db
-        .select({ id: schema.designFiles.id })
-        .from(schema.designFiles)
-        .where(
-          and(
-            eq(schema.designFiles.designId, targetDesignId),
-            ne(schema.designFiles.filename, BOARD_FILENAME),
-          ),
-        )
-        .limit(1);
-      if (existing) {
-        throw new Error(
-          "Target design already has files. Templates only fill an empty design.",
-        );
-      }
     }
     const designId = targetDesignId ?? nanoid();
     const now = new Date().toISOString();
@@ -244,8 +216,45 @@ export default defineAction({
       content: annotateScreenHtmlForPersist(file.content, file.fileType),
     }));
 
-    await db.transaction(async (tx) => {
+    const persist = async (tx: DesignTransaction) => {
       if (targetDesignId) {
+        // The editor creates the board row on mount, so a design with nothing
+        // drawn in it already has one file. Screens are what count as content.
+        const [existingDesign] = await tx
+          .select({ data: schema.designs.data })
+          .from(schema.designs)
+          .where(eq(schema.designs.id, targetDesignId))
+          .limit(1);
+        if (typeof existingDesign?.data === "string") {
+          try {
+            const parsed = JSON.parse(existingDesign.data);
+            if (
+              parsed &&
+              typeof parsed === "object" &&
+              !Array.isArray(parsed)
+            ) {
+              targetExistingData = parsed as Record<string, unknown>;
+            }
+          } catch {
+            // coercion-ok: unreadable prior data is replaced wholesale below,
+            // which is the same outcome as the create path.
+          }
+        }
+        const [existing] = await tx
+          .select({ id: schema.designFiles.id })
+          .from(schema.designFiles)
+          .where(
+            and(
+              eq(schema.designFiles.designId, targetDesignId),
+              ne(schema.designFiles.filename, BOARD_FILENAME),
+            ),
+          )
+          .limit(1);
+        if (existing) {
+          throw new Error(
+            "Target design already has files. Templates only fill an empty design.",
+          );
+        }
         await tx
           .update(schema.designs)
           .set({
@@ -285,7 +294,13 @@ export default defineAction({
           updatedAt: now,
         })),
       );
-    });
+    };
+
+    if (targetDesignId) {
+      await withDesignSourceMutationTransaction(targetDesignId, persist);
+    } else {
+      await db.transaction(persist);
+    }
 
     return {
       id: designId,

package/corpus/templates/design/actions/create-design-version.ts

@@ -0,0 +1,21 @@
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+import { createDesignVersionSnapshot } from "../server/lib/design-versions.js";
+
+export default defineAction({
+  description:
+    "Create one frontend editor history checkpoint before a grouped design mutation.",
+  agentTool: false,
+  mcpTool: false,
+  schema: z.object({
+    designId: z.string().describe("Design project ID"),
+  }),
+  run: async ({ designId }) => {
+    const version = await createDesignVersionSnapshot(designId, {
+      label: "Before editor screen delete",
+      chatContext: { surface: "editor", actionName: "delete-file" },
+    });
+    return version;
+  },
+});