@agent-native/core 0.195.0 → 0.195.1-nightly-20260927200151

package/corpus/README.md

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

package/corpus/templates/design/app/components/design/design-canvas/LocalNetworkAccessPrompt.tsx

@@ -4,7 +4,18 @@ import {
   IconPlugConnectedX,
   IconX,
 } from "@tabler/icons-react";
+import { useState } from "react";
 
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/components/ui/alert-dialog";
 import { Button } from "@/components/ui/button";
 import {
   Dialog,
@@ -30,6 +41,7 @@ export function LocalNetworkAccessPrompt({
   proactive?: boolean;
 }) {
   const t = useT();
+  const [confirmClose, setConfirmClose] = useState(false);
   // "unreachable" is the one confident case (permission is confirmed
   // granted, so it's confirmed NOT the cause) — every other kind is
   // deliberately hedged copy, never a diagnosed permission claim. See
@@ -69,35 +81,87 @@ export function LocalNetworkAccessPrompt({
     "designCanvas.localBridge.permissionPromptSettingsInstructions",
     {
       defaultValue:
-        "Click the site information icon to the left of the address bar, open Site settings, then set Local network access to Allow.",
+        "Click the site controls icon to the left of the address bar, open Site settings, then allow access to apps on your device.",
     },
   );
   const permissionHelp = showPermissionHelp ? (
     <details className="text-xs text-muted-foreground">
       <summary className="cursor-pointer">{noPromptLabel}</summary>
       <p className="mt-2 leading-relaxed">{permissionSettingsInstructions}</p>
+      <img
+        src="/local-network-access-settings.jpg"
+        alt={permissionSettingsInstructions}
+        className="mt-3 block w-full rounded-md border border-border"
+        width={200}
+        height={140}
+        loading="lazy"
+      />
     </details>
   ) : null;
 
   if (proactive) {
     return (
-      <Dialog
-        open
-        onOpenChange={(open) => {
-          if (!open) onDismiss();
-        }}
-      >
-        <DialogContent className="sm:max-w-md">
-          <DialogHeader>
-            <DialogTitle className="flex items-center gap-2">
-              <IconPlugConnected className="size-4" />
-              {title}
-            </DialogTitle>
-            <DialogDescription>{description}</DialogDescription>
-          </DialogHeader>
-          {permissionHelp}
-        </DialogContent>
-      </Dialog>
+      <>
+        <Dialog
+          open
+          onOpenChange={(open) => {
+            if (!open) setConfirmClose(true);
+          }}
+        >
+          <DialogContent
+            className="sm:max-w-md"
+            overlayClassName="bg-[color-mix(in_srgb,var(--design-editor-accent-color)_22%,transparent)] backdrop-blur-[2px]"
+          >
+            <DialogHeader>
+              <DialogTitle className="flex items-center gap-2">
+                <IconPlugConnected className="size-4" />
+                {title}
+              </DialogTitle>
+              <DialogDescription>{description}</DialogDescription>
+            </DialogHeader>
+            <img
+              src="/local-network-access-permission.jpg"
+              alt={description}
+              className="block w-full rounded-md border border-border"
+              width={240}
+              height={150}
+            />
+            {permissionHelp}
+          </DialogContent>
+        </Dialog>
+        <AlertDialog open={confirmClose} onOpenChange={setConfirmClose}>
+          <AlertDialogContent>
+            <AlertDialogHeader>
+              <AlertDialogTitle>
+                {t("designCanvas.localBridge.permissionCloseTitle", {
+                  defaultValue: "Close setup?",
+                })}
+              </AlertDialogTitle>
+              <AlertDialogDescription>
+                {t("designCanvas.localBridge.permissionCloseDescription", {
+                  defaultValue:
+                    "Live editing won't work until you allow access in Chrome.",
+                })}
+              </AlertDialogDescription>
+            </AlertDialogHeader>
+            <AlertDialogFooter>
+              <AlertDialogCancel>
+                {t("designCanvas.localBridge.permissionCloseStay", {
+                  defaultValue: "Keep setup open",
+                })}
+              </AlertDialogCancel>
+              <AlertDialogAction
+                className="bg-destructive text-destructive-foreground hover:bg-destructive/90"
+                onClick={onDismiss}
+              >
+                {t("designCanvas.localBridge.permissionCloseAnyway", {
+                  defaultValue: "Close anyway",
+                })}
+              </AlertDialogAction>
+            </AlertDialogFooter>
+          </AlertDialogContent>
+        </AlertDialog>
+      </>
     );
   }
 

package/corpus/templates/design/app/i18n/en-US.ts

@@ -1478,7 +1478,12 @@ export default {
         "Choose Allow in Chrome's prompt to enable live editing.",
       permissionPromptNoPrompt: "No Chrome prompt?",
       permissionPromptSettingsInstructions:
-        "Click the site information icon to the left of the address bar, open Site settings, then set Local network access to Allow.",
+        "Click the site controls icon to the left of the address bar, open Site settings, then allow access to apps on your device.",
+      permissionCloseTitle: "Close setup?",
+      permissionCloseDescription:
+        "Live editing won't work until you allow access in Chrome.",
+      permissionCloseStay: "Keep setup open",
+      permissionCloseAnyway: "Close anyway",
       permissionPromptRetry: "Retry connection",
       confirmationRetryExhausted:
         "Live editor bridge did not confirm after several attempts.",

package/corpus/templates/design/changelog/2026-09-27-local-access-setup-shows-chrome-permission-screenshots-and-c.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-27
+---
+
+Local access setup shows Chrome permission screenshots and confirms before closing

package/corpus/templates/mail/app/components/onboarding/AiInboxSetup.tsx

@@ -1,6 +1,7 @@
 import { sendToAgentChat } from "@agent-native/core/client/agent-chat";
 import { useActionQuery } from "@agent-native/core/client/hooks";
 import { useT } from "@agent-native/core/client/i18n";
+import { useFirstRunOnboardingGateOwnsSurface } from "@agent-native/core/client/onboarding";
 import { AI_FILTER_LABEL } from "@shared/ai-filter";
 import type { AiFilterBackfillStatus } from "@shared/ai-filter-backfill";
 import {
@@ -402,6 +403,7 @@ export function AiInboxSetup({
   onSkipSetup?: () => void;
 }) {
   const t = useT();
+  const firstRunOnboardingOwnsSurface = useFirstRunOnboardingGateOwnsSurface();
   const { data: settings } = useSettings();
   const { data: rules = [], isLoading: rulesLoading } = useAutomations();
   const googleStatus = useGoogleAuthStatus();
@@ -467,6 +469,7 @@ export function AiInboxSetup({
     [rules],
   );
   const visible =
+    !firstRunOnboardingOwnsSurface &&
     connected &&
     !googleStatus.isLoading &&
     !jevAvailability.isLoading &&
@@ -960,6 +963,7 @@ export function AiInboxSetup({
                 step < 3 &&
                 (saving ||
                   customTagIncomplete ||
+                  (step === 1 && !importantPrompt.trim()) ||
                   (step === 2 && (!jevConfigured || rulesLoading)))
               }
               aria-busy={saving || (step === 2 && rulesLoading)}

package/corpus/templates/mail/changelog/2026-09-27-mail-setup-waits-for-first-run-onboarding-and-empty-importan.md

@@ -0,0 +1,6 @@
+---
+type: fixed
+date: 2026-09-27
+---
+
+Mail setup waits for first-run onboarding, and empty importance prompts require an explicit skip.

package/dist/automation/index.d.ts

@@ -139,8 +139,8 @@ export declare function createAutomationCallbackHandler(runtime: AutomationRunti
     duplicate?: undefined;
     eventId?: undefined;
 } | {
-    error?: undefined;
     accepted: boolean;
     duplicate: boolean;
     eventId: string;
+    error?: undefined;
 }>;

package/dist/client/onboarding/first-run-startup-gate.js

@@ -71,12 +71,13 @@ export function FirstRunOnboardingStartupGate({ children, fallback = _jsx(AppShe
         };
     }, [shouldResolve]);
     const ownsSurface = decision === "eligible";
-    const hideApp = decision !== "ineligible";
+    const gateOwnsSurface = decision !== "ineligible";
+    const hideApp = gateOwnsSurface;
     const app = shouldResolve ? (_jsx("div", { "aria-hidden": hideApp ? "true" : undefined, "data-first-run-app-hidden": hideApp ? "true" : undefined, style: {
             display: "contents",
             ...(hideApp ? { visibility: "hidden" } : {}),
         }, children: children })) : (children);
-    return (_jsxs(FirstRunOnboardingGateContext.Provider, { value: ownsSurface, children: [app, decision === "pending" && (_jsx(FirstRunOnboardingStartupLoading, { fallback: fallback })), ownsSurface && (_jsx(Suspense, { fallback: _jsx(FirstRunOnboardingStartupLoading, { fallback: fallback }), children: _jsx(FirstRunOnboarding, { initialFirstRun: true }) }))] }));
+    return (_jsxs(FirstRunOnboardingGateContext.Provider, { value: gateOwnsSurface, children: [app, decision === "pending" && (_jsx(FirstRunOnboardingStartupLoading, { fallback: fallback })), ownsSurface && (_jsx(Suspense, { fallback: _jsx(FirstRunOnboardingStartupLoading, { fallback: fallback }), children: _jsx(FirstRunOnboarding, { initialFirstRun: true }) }))] }));
 }
 function FirstRunOnboardingStartupLoading({ fallback, }) {
     return (_jsx("div", { role: "status", "aria-label": "Loading application", "data-first-run-startup-loading": "true", className: "fixed inset-0 z-[110] bg-background", children: _jsx("div", { inert: true, children: fallback }) }));

package/dist/collab/struct-routes.d.ts

@@ -1,6 +1,6 @@
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/file-upload/actions/upload-image.d.ts

@@ -35,9 +35,9 @@ declare const _default: import("../../action.js").ActionDefinition<{
 } | {
     error: string;
     url?: undefined;
+    id?: undefined;
     provider?: undefined;
     configured?: undefined;
-    id?: undefined;
 } | {
     url: string;
     id: string;
@@ -46,9 +46,9 @@ declare const _default: import("../../action.js").ActionDefinition<{
     error?: undefined;
 } | {
     url?: undefined;
+    id?: undefined;
     provider?: undefined;
     error: string;
     configured: boolean;
-    id?: undefined;
 }>;
 export default _default;

package/dist/notifications/routes.d.ts

@@ -1,13 +1,13 @@
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
     count: number;
     updated?: undefined;
-    error?: undefined;
     ok?: undefined;
+    error?: undefined;
 } | {
     count?: undefined;
     updated: number;
-    error?: undefined;
     ok?: undefined;
+    error?: undefined;
 } | {
     count?: undefined;
     updated?: undefined;
@@ -16,6 +16,6 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
 } | {
     count?: undefined;
     updated?: undefined;
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;

package/dist/observability/routes.d.ts

@@ -20,9 +20,9 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
+    id?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
-    id?: undefined;
     error?: undefined;
     ok?: undefined;
 } | {
@@ -32,15 +32,15 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     error?: undefined;
     ok?: undefined;
 } | {
+    id?: undefined;
     summary?: undefined;
     spans?: undefined;
-    id?: undefined;
     error: any;
     ok?: undefined;
 } | {
+    id?: undefined;
     summary?: undefined;
     spans?: undefined;
-    id?: undefined;
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;

package/dist/secrets/routes.d.ts

@@ -32,33 +32,33 @@ export declare function createListSecretsHandler(): import("h3").EventHandlerWit
 }>>;
 export declare function createWriteSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: string;
-    ok?: undefined;
     status?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     status: string;
+    error?: undefined;
 } | {
-    ok?: undefined;
     error: string;
     removed?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;
 export declare function createTestSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
     note?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     note?: undefined;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     note: string;
+    error?: undefined;
 } | {
     note?: undefined;
     ok: boolean;
@@ -78,11 +78,11 @@ export interface AdHocSecretPayload {
 export declare function createAdHocSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<AdHocSecretPayload[] | {
     error: string;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;

package/dist/server/agent-engine-ollama-models-route.d.ts

@@ -1,6 +1,6 @@
 export declare function createAgentEngineOllamaModelsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
     models?: undefined;
 } | {
     error?: undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.195.0",
+  "version": "0.195.1-nightly-20260927200151",
   "description": "The agentic application framework for building autonomous agents with intuitive UIs",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -517,9 +517,9 @@
     "yaml": "^2.9.0",
     "yjs": "^13.6.32",
     "zod": "^4.3.6",
-    "@agent-native/recap-cli": "0.5.47",
     "@agent-native/agentkit": "^0.4.1",
-    "@agent-native/toolkit": "^0.22.3"
+    "@agent-native/toolkit": "^0.22.3",
+    "@agent-native/recap-cli": "0.5.47"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",