@agent-native/core 0.0.0-beta-20260820231735 → 0.0.0-beta-20260820233158

package/corpus/README.md

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

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

@@ -67,6 +67,7 @@ import {
   startBubbleWebrtc,
   type BubbleWebrtcHandle,
 } from "./lib/bubble-webrtc";
+import { openBoundOAuthWindow } from "./lib/desktop-oauth-window";
 import {
   getCameraStreamWithFallback,
   isMediaConstraintFailure,
@@ -2126,15 +2127,17 @@ export function App() {
     void tick();
   }
 
-  // Google verification stays in the bound Tauri WebView so the callback sees
-  // the same browser-binding cookie. Magic-link verification still completes
-  // in the system browser through its own exchange flow.
+  // Google verification stays in a child of the bound Tauri WebView so the
+  // callback sees the same browser-binding cookie. Magic-link verification
+  // still completes in the system browser through its own exchange flow.
   async function signInExternal() {
     if (signInInflightRef.current) return;
     signInInflightRef.current = true;
+    let oauthWindow: ReturnType<typeof openBoundOAuthWindow> | null = null;
 
     try {
       setSignInError(null);
+      oauthWindow = openBoundOAuthWindow();
       const flowId = crypto.randomUUID?.() ?? null;
       const verifier = (() => {
         const randomUuid = crypto.randomUUID;
@@ -2163,7 +2166,6 @@ export function App() {
       const authParams = new URLSearchParams({
         desktop: "1",
         flow_id: flowId,
-        webview: "1",
       });
       const authResponse = await fetch(
         `${base}/_agent-native/google/auth-url?${authParams.toString()}`,
@@ -2194,13 +2196,12 @@ export function App() {
               : "Could not start Google sign-in.";
         throw new Error(message);
       }
+      oauthWindow.location.href = authPayload.url;
       setSignInPending("google");
-      // Stay in this exact WebView: the auth bootstrap set the HttpOnly
-      // browser-binding cookie here, and the callback returns this page with
-      // the staged session cookie after Google completes.
-      window.location.href = authPayload.url;
+      startDesktopAuthExchange(flowId, "google", verifier);
     } catch (err) {
       console.error("[clips-tray] signInExternal failed:", err);
+      oauthWindow?.close();
       signInInflightRef.current = false;
       setSignInPending(null);
       setSignInError(
@@ -3962,8 +3963,8 @@ export function App() {
   // (not a separate Tauri window). This avoids Tauri 2's separate-WebKit-
   // data-store-per-WebviewWindow cookie-jar issue — the cookie is set in
   // the same webview that reads it on the next /auth/session poll.
-  // Google verification uses the bound WebView, while magic-link verification
-  // uses the system browser and password stays inline here.
+  // Google verification uses a popup in the bound WebView, while magic-link
+  // verification uses the system browser and password stays inline here.
   if (authStatus === "anon") {
     return (
       <div className="app" ref={appRef}>

package/corpus/templates/clips/desktop/src/lib/desktop-oauth-window.ts

@@ -0,0 +1,23 @@
+type OAuthWindow = Pick<Window, "close"> & {
+  location: Pick<Location, "href">;
+};
+
+type OpenOAuthWindow = (url: string, target: string) => OAuthWindow | null;
+
+/**
+ * Open a same-WebView OAuth child before awaiting the auth URL.
+ *
+ * The parent keeps polling the exchange while the child completes Google
+ * OAuth. Using window.open keeps both pages in the Tauri WebView cookie
+ * partition; the system-browser shell opener would lose the binding cookie.
+ */
+export function openBoundOAuthWindow(
+  openWindow: OpenOAuthWindow = (url, target) =>
+    window.open(url, target) as OAuthWindow | null,
+): OAuthWindow {
+  const oauthWindow = openWindow("about:blank", "_blank");
+  if (!oauthWindow) {
+    throw new Error("Could not open the Google sign-in window.");
+  }
+  return oauthWindow;
+}

package/dist/client/AboutAgentNativeDialog.d.ts

@@ -0,0 +1,5 @@
+export interface AboutAgentNativeDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+}
+export declare function AboutAgentNativeDialog({ open, onOpenChange, }: AboutAgentNativeDialogProps): import("react").JSX.Element;

package/dist/client/AboutAgentNativeDialog.js

@@ -0,0 +1,56 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from "@agent-native/toolkit/ui/button";
+import { IconCheck, IconCode, IconCopy, IconX } from "@tabler/icons-react";
+import { useEffect, useMemo, useRef, useState } from "react";
+import { formatAgentNativeDiagnostics, getAgentNativeDiagnostics, getAgentNativePackageVersions, } from "./agent-native-version.js";
+import { writeClipboardText } from "./clipboard.js";
+import { Dialog, DialogContent, DialogTitle } from "./components/ui/dialog.js";
+import { useT } from "./i18n.js";
+export function AboutAgentNativeDialog({ open, onOpenChange, }) {
+    const t = useT();
+    const [copyState, setCopyState] = useState("idle");
+    const copyResetTimer = useRef(null);
+    const packageVersions = getAgentNativePackageVersions();
+    const diagnostics = useMemo(() => formatAgentNativeDiagnostics(), []);
+    const { buildId, environment } = getAgentNativeDiagnostics();
+    useEffect(() => {
+        if (!open) {
+            setCopyState("idle");
+        }
+    }, [open]);
+    useEffect(() => () => {
+        if (copyResetTimer.current !== null) {
+            window.clearTimeout(copyResetTimer.current);
+        }
+    }, []);
+    const handleCopy = async () => {
+        const didCopy = await writeClipboardText(diagnostics);
+        setCopyState(didCopy ? "copied" : "failed");
+        if (copyResetTimer.current !== null) {
+            window.clearTimeout(copyResetTimer.current);
+        }
+        copyResetTimer.current = window.setTimeout(() => {
+            setCopyState("idle");
+            copyResetTimer.current = null;
+        }, 1600);
+    };
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { "aria-describedby": undefined, className: "max-w-md gap-5", children: [_jsxs(DialogTitle, { className: "flex items-center gap-2 text-base", children: [_jsx(IconCode, { className: "size-4 text-muted-foreground" }), t("agentChat.aboutAgentNative.title", {
+                            defaultValue: "About Agent Native",
+                        })] }), _jsx("div", { className: "overflow-hidden rounded-md border border-border", children: packageVersions.length > 0 ? (packageVersions.map(({ name, version }) => (_jsxs("div", { className: "flex items-center justify-between gap-4 border-b border-border px-3 py-2 last:border-b-0", children: [_jsx("span", { className: "min-w-0 truncate font-mono text-xs text-foreground", children: name }), _jsxs("span", { className: "shrink-0 font-mono text-xs text-muted-foreground", children: [_jsx("span", { className: "sr-only", children: t("agentChat.aboutAgentNative.version", {
+                                            defaultValue: "Version",
+                                        }) }), version] })] }, name)))) : (_jsxs("div", { className: "px-3 py-2 font-mono text-xs text-muted-foreground", children: ["@agent-native/core -", " ", t("agentChat.aboutAgentNative.unknown", {
+                                defaultValue: "Unknown",
+                            })] })) }), _jsxs("dl", { className: "grid gap-2 text-xs", children: [_jsxs("div", { className: "flex items-center justify-between gap-4", children: [_jsx("dt", { className: "text-muted-foreground", children: t("agentChat.aboutAgentNative.environment", {
+                                        defaultValue: "Environment",
+                                    }) }), _jsx("dd", { className: "font-mono text-foreground", children: environment })] }), _jsxs("div", { className: "flex items-center justify-between gap-4", children: [_jsx("dt", { className: "text-muted-foreground", children: t("agentChat.aboutAgentNative.build", {
+                                        defaultValue: "Build",
+                                    }) }), _jsx("dd", { className: "max-w-[16rem] truncate font-mono text-foreground", children: buildId })] })] }), _jsxs(Button, { className: "w-full", onClick: () => void handleCopy(), type: "button", variant: "outline", children: [copyState === "copied" ? (_jsx(IconCheck, {})) : copyState === "failed" ? (_jsx(IconX, {})) : (_jsx(IconCopy, {})), copyState === "copied"
+                            ? t("agentChat.common.copied", { defaultValue: "Copied" })
+                            : copyState === "failed"
+                                ? t("agentChat.recovery.copyFailed", {
+                                    defaultValue: "Copy failed",
+                                })
+                                : t("agentChat.aboutAgentNative.copyDiagnostics", {
+                                    defaultValue: "Copy diagnostics",
+                                })] })] }) }));
+}

package/dist/client/CommandMenu.d.ts

@@ -89,8 +89,13 @@ export interface CommandMenuProps {
      * multiple apps share an origin.
      */
     changelogKey?: string;
+    /**
+     * Whether to show the built-in "About Agent Native" entry. Defaults to true
+     * for app-shell menus that provide a changelog; set false for local menus.
+     */
+    showAbout?: boolean;
 }
-export declare function CommandMenu({ open, onOpenChange, children, renderResults, placeholder, emptyText: _emptyText, showAgentFallback, className, changelog, changelogLabel, changelogKey, }: CommandMenuProps): React.JSX.Element;
+export declare function CommandMenu({ open, onOpenChange, children, renderResults, placeholder, emptyText: _emptyText, showAgentFallback, className, changelog, changelogLabel, changelogKey, showAbout: showAboutProp, }: CommandMenuProps): React.JSX.Element;
 export declare namespace CommandMenu {
     export { CommandGroup as Group };
     export { CommandItem as Item };

package/dist/client/CommandMenu.js

@@ -16,12 +16,14 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  *   </CommandMenu>
  */
 import { Command as CommandPrimitive, CommandGroup as CommandGroupPrimitive, CommandInput as CommandInputPrimitive, CommandItem as CommandItemPrimitive, CommandList as CommandListPrimitive, CommandSeparator as CommandSeparatorPrimitive, CommandShortcut as CommandShortcutPrimitive, } from "@agent-native/toolkit/ui/command";
-import { IconBook2, IconExternalLink, IconMessage, IconHistory, } from "@tabler/icons-react";
+import { IconBook2, IconExternalLink, IconInfoCircle, IconMessage, IconHistory, } from "@tabler/icons-react";
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
 import { parseChangelog } from "../changelog/parse.js";
+import { AboutAgentNativeDialog } from "./AboutAgentNativeDialog.js";
 import { sendToAgentChat } from "./agent-chat.js";
 import { ChangelogDialog, useChangelogSeen } from "./changelog/Changelog.js";
 import { Dialog, DialogContent, DialogTitle } from "./components/ui/dialog.js";
+import { useT } from "./i18n.js";
 import { cn } from "./utils.js";
 const CommandMenuContext = createContext(null);
 function useCommandMenuContext() {
@@ -122,15 +124,18 @@ function CommandDocsGroup({ docs, heading = "Docs" }) {
         return null;
     return (_jsx(CommandGroup, { heading: heading, children: docs.map((doc) => (_jsxs(CommandItem, { onSelect: () => openDocsHref(doc.href), keywords: [doc.title, doc.description ?? "", ...(doc.keywords ?? [])], deferSelect: false, className: "items-start py-2", children: [_jsx(IconBook2, { className: "mt-0.5 h-4 w-4 shrink-0 text-muted-foreground" }), _jsxs("span", { className: "min-w-0 flex-1", children: [_jsx("span", { className: "block truncate font-medium", children: doc.title }), doc.description ? (_jsx("span", { className: "mt-0.5 block line-clamp-2 text-xs leading-snug text-muted-foreground", children: doc.description })) : null] }), _jsx(IconExternalLink, { className: "mt-0.5 h-3.5 w-3.5 shrink-0 text-muted-foreground" })] }, doc.href))) }));
 }
-export function CommandMenu({ open, onOpenChange, children, renderResults, placeholder = "Type a command or ask AI...", emptyText: _emptyText = "No commands found.", showAgentFallback = true, className, changelog, changelogLabel = "What's new", changelogKey, }) {
+export function CommandMenu({ open, onOpenChange, children, renderResults, placeholder = "Type a command or ask AI...", emptyText: _emptyText = "No commands found.", showAgentFallback = true, className, changelog, changelogLabel = "What's new", changelogKey, showAbout: showAboutProp, }) {
     const [search, setSearch] = useState("");
     const inputRef = useRef(null);
     const containerRef = useRef(null);
+    const t = useT();
     // Built-in "What's new" changelog surface (only active when `changelog` is
     // passed). The dialog is rendered alongside the menu so it survives the menu
     // closing; the unseen dot persists per browser via localStorage.
     const [changelogOpen, setChangelogOpen] = useState(false);
+    const [aboutOpen, setAboutOpen] = useState(false);
     const hasChangelog = typeof changelog === "string" && changelog.trim().length > 0;
+    const showAbout = showAboutProp ?? hasChangelog;
     const changelogEntries = useMemo(() => (hasChangelog ? parseChangelog(changelog) : []), [hasChangelog, changelog]);
     const latestChangelogId = changelogEntries[0]?.id;
     const { unseen: changelogUnseen, markSeen: markChangelogSeen } = useChangelogSeen(changelogKey ?? "app", latestChangelogId);
@@ -140,6 +145,11 @@ export function CommandMenu({ open, onOpenChange, children, renderResults, place
         // Let the menu close before the dialog opens (avoids overlay flicker).
         setTimeout(() => setChangelogOpen(true), 50);
     }, [onOpenChange, markChangelogSeen]);
+    const openAbout = useCallback(() => {
+        onOpenChange(false);
+        // Let the menu close before the dialog opens (avoids overlay flicker).
+        setTimeout(() => setAboutOpen(true), 50);
+    }, [onOpenChange]);
     // Focus input when opening; clear search while closed so reopen never renders
     // dynamic results for the previous query.
     useEffect(() => {
@@ -178,6 +188,36 @@ export function CommandMenu({ open, onOpenChange, children, renderResults, place
             .toLowerCase()
             .includes(search.toLowerCase());
     const showChangelogRow = hasChangelog && changelogRowMatches;
+    const aboutLabel = t("agentChat.aboutAgentNative.title", {
+        defaultValue: "About Agent Native",
+    });
+    const aboutVersionLabel = t("agentChat.aboutAgentNative.version", {
+        defaultValue: "Version",
+    });
+    const aboutEnvironmentLabel = t("agentChat.aboutAgentNative.environment", {
+        defaultValue: "Environment",
+    });
+    const aboutBuildLabel = t("agentChat.aboutAgentNative.build", {
+        defaultValue: "Build",
+    });
+    const aboutDiagnosticsLabel = t("agentChat.aboutAgentNative.copyDiagnostics", {
+        defaultValue: "Copy diagnostics",
+    });
+    const aboutRowMatches = !search ||
+        [
+            aboutLabel,
+            "agent native",
+            aboutVersionLabel,
+            "versions",
+            "package",
+            aboutEnvironmentLabel,
+            aboutBuildLabel,
+            aboutDiagnosticsLabel,
+        ]
+            .join(" ")
+            .toLowerCase()
+            .includes(search.toLowerCase());
+    const showAboutRow = showAbout && aboutRowMatches;
     // Filter children based on search
     const filterChildren = (nodes) => {
         return React.Children.map(nodes, (child) => {
@@ -242,7 +282,10 @@ export function CommandMenu({ open, onOpenChange, children, renderResults, place
                     }, className: cn("fixed left-1/2 top-[15vh] !z-50 !max-h-none -translate-x-1/2 !translate-y-0 !gap-0 w-full max-w-lg", "rounded-lg border border-border bg-popover p-0 text-popover-foreground shadow-lg", className), style: {
                         animation: "none",
                         transition: "none",
-                    }, children: [_jsx(DialogTitle, { className: "sr-only", children: placeholder }), _jsx(CommandPrimitive, { loop: true, shouldFilter: false, className: "h-auto rounded-lg", children: _jsxs(CommandMenuContext.Provider, { value: { search, onOpenChange }, children: [_jsx(CommandInputPrimitive, { ref: inputRef, value: search, onValueChange: setSearch, placeholder: placeholder }), _jsxs(CommandListPrimitive, { children: [dynamicResults, hasResults && filteredChildren, showChangelogRow && (_jsxs(_Fragment, { children: [hasResults && _jsx(CommandSeparator, {}), _jsx("div", { className: "p-1", children: _jsxs(CommandItemPrimitive, { className: "cursor-pointer gap-2 py-2", onSelect: openChangelog, children: [_jsx(IconHistory, { className: "h-4 w-4 text-muted-foreground" }), _jsx("span", { children: changelogLabel }), changelogUnseen && (_jsx("span", { className: "ms-auto h-2 w-2 rounded-full bg-primary", "aria-label": "New updates available" }))] }) })] })), showAgentFallback && (_jsxs(_Fragment, { children: [(hasResults || showChangelogRow || hasDynamicResults) && (_jsx(CommandSeparator, {})), _jsx("div", { className: "p-1", children: _jsxs(CommandItemPrimitive, { className: "cursor-pointer gap-2 py-2", onSelect: handleSubmitToAgent, children: [_jsx(IconMessage, { className: "h-4 w-4 text-muted-foreground" }), _jsx("span", { children: search.trim() ? (_jsxs(_Fragment, { children: ["Ask AI:", " ", _jsxs("span", { className: "text-muted-foreground", children: ["\"", search, "\""] })] })) : (_jsx("span", { className: "text-muted-foreground", children: "Ask AI anything..." })) }), search.trim() && (_jsx("span", { className: "ms-auto text-xs text-muted-foreground", children: "\u21B5" }))] }) })] }))] })] }) })] }) }), hasChangelog && (_jsx(ChangelogDialog, { open: changelogOpen, onOpenChange: setChangelogOpen, markdown: changelog, title: changelogLabel }))] }));
+                    }, children: [_jsx(DialogTitle, { className: "sr-only", children: placeholder }), _jsx(CommandPrimitive, { loop: true, shouldFilter: false, className: "h-auto rounded-lg", children: _jsxs(CommandMenuContext.Provider, { value: { search, onOpenChange }, children: [_jsx(CommandInputPrimitive, { ref: inputRef, value: search, onValueChange: setSearch, placeholder: placeholder }), _jsxs(CommandListPrimitive, { children: [dynamicResults, hasResults && filteredChildren, showChangelogRow && (_jsxs(_Fragment, { children: [hasResults && _jsx(CommandSeparator, {}), _jsx("div", { className: "p-1", children: _jsxs(CommandItemPrimitive, { className: "cursor-pointer gap-2 py-2", onSelect: openChangelog, children: [_jsx(IconHistory, { className: "h-4 w-4 text-muted-foreground" }), _jsx("span", { children: changelogLabel }), changelogUnseen && (_jsx("span", { className: "ms-auto h-2 w-2 rounded-full bg-primary", "aria-label": "New updates available" }))] }) })] })), showAboutRow && (_jsxs(_Fragment, { children: [(hasResults || showChangelogRow) && _jsx(CommandSeparator, {}), _jsx("div", { className: "p-1", children: _jsxs(CommandItemPrimitive, { className: "cursor-pointer gap-2 py-2", onSelect: openAbout, children: [_jsx(IconInfoCircle, { className: "h-4 w-4 text-muted-foreground" }), _jsx("span", { children: aboutLabel })] }) })] })), showAgentFallback && (_jsxs(_Fragment, { children: [(hasResults ||
+                                                        showChangelogRow ||
+                                                        showAboutRow ||
+                                                        hasDynamicResults) && _jsx(CommandSeparator, {}), _jsx("div", { className: "p-1", children: _jsxs(CommandItemPrimitive, { className: "cursor-pointer gap-2 py-2", onSelect: handleSubmitToAgent, children: [_jsx(IconMessage, { className: "h-4 w-4 text-muted-foreground" }), _jsx("span", { children: search.trim() ? (_jsxs(_Fragment, { children: ["Ask AI:", " ", _jsxs("span", { className: "text-muted-foreground", children: ["\"", search, "\""] })] })) : (_jsx("span", { className: "text-muted-foreground", children: "Ask AI anything..." })) }), search.trim() && (_jsx("span", { className: "ms-auto text-xs text-muted-foreground", children: "\u21B5" }))] }) })] }))] })] }) })] }) }), hasChangelog && (_jsx(ChangelogDialog, { open: changelogOpen, onOpenChange: setChangelogOpen, markdown: changelog, title: changelogLabel })), showAbout && (_jsx(AboutAgentNativeDialog, { open: aboutOpen, onOpenChange: setAboutOpen }))] }));
 }
 // Helper to extract text content from React children
 function getTextContent(children) {

package/dist/client/EnvironmentBadge.js

@@ -6,6 +6,7 @@ import { BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, buildEnvironmentOpt
 import { trackEvent } from "./analytics.js";
 import { injectedAgentNativeConfig } from "./app-config.js";
 import { useSession } from "./use-session.js";
+import { cn } from "./utils.js";
 export { BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, } from "../shared/environment-lanes.js";
 export function isBuilderIoEmployee(email) {
     return email?.trim().toLowerCase().endsWith("@builder.io") ?? false;
@@ -88,7 +89,9 @@ function EnvironmentBadgeContent({ environment, targets, }) {
     const title = environment === "beta"
         ? "You're on Agent Native Beta"
         : "You're on Agent Native Production";
-    return (_jsxs(Popover, { children: [_jsx(PopoverTrigger, { asChild: true, children: _jsx(Button, { "aria-label": `Open ${title.toLowerCase()} switcher`, className: "fixed bottom-3 right-3 z-[100] h-6 min-w-0 rounded-xl border-border/80 bg-background/95 px-2 text-[11px] font-semibold uppercase tracking-[0.5px] shadow-sm backdrop-blur-sm", size: "sm", variant: environment === "beta" ? "default" : "outline", children: label }) }), _jsxs(PopoverContent, { align: "center", className: "w-[280px] p-5", side: "top", sideOffset: 8, children: [_jsx("div", { className: "mb-1 text-sm font-semibold leading-5", children: title }), _jsx("div", { className: "mb-4 text-sm text-muted-foreground", children: "Choose where you want to continue." }), _jsx("div", { className: "grid gap-2", children: environment === "beta" ? (_jsx(EnvironmentLink, { href: productionHref, label: "Switch to production" })) : (_jsx(EnvironmentLink, { href: betaHref, label: "Go to beta" })) })] })] }));
+    return (_jsxs(Popover, { children: [_jsx(PopoverTrigger, { asChild: true, children: _jsx(Button, { "aria-label": `Open ${title.toLowerCase()} switcher`, className: cn("fixed bottom-3 right-3 z-[100] h-6 min-w-0 rounded-xl px-2 text-[11px] font-semibold uppercase tracking-[0.5px] shadow-sm backdrop-blur-sm", environment === "beta"
+                        ? "border-primary/80"
+                        : "border-border/80 bg-background/95 text-foreground"), size: "sm", variant: environment === "beta" ? "default" : "outline", children: label }) }), _jsxs(PopoverContent, { align: "center", className: "w-[280px] p-5", side: "top", sideOffset: 8, children: [_jsx("div", { className: "mb-1 text-sm font-semibold leading-5", children: title }), _jsx("div", { className: "mb-4 text-sm text-muted-foreground", children: "Choose where you want to continue." }), _jsx("div", { className: "grid gap-2", children: environment === "beta" ? (_jsx(EnvironmentLink, { href: productionHref, label: "Switch to production" })) : (_jsx(EnvironmentLink, { href: betaHref, label: "Go to beta" })) })] })] }));
 }
 function ProductionEnvironmentBadge({ targets, }) {
     const { session, status } = useSession();

package/dist/client/agent-native-version.d.ts

@@ -0,0 +1,12 @@
+export interface AgentNativePackageVersion {
+    name: string;
+    version: string;
+}
+export interface AgentNativeDiagnostics {
+    buildId: string;
+    environment: string;
+    packages: Record<string, string>;
+}
+export declare function getAgentNativePackageVersions(): AgentNativePackageVersion[];
+export declare function getAgentNativeDiagnostics(): AgentNativeDiagnostics;
+export declare function formatAgentNativeDiagnostics(): string;

package/dist/client/agent-native-version.js

@@ -0,0 +1,36 @@
+import { injectedAgentNativeConfig } from "./app-config.js";
+import { clientBuildId } from "./build-compatibility.js";
+function readPackageVersions(value) {
+    if (!value || typeof value !== "object") {
+        return {};
+    }
+    return Object.fromEntries(Object.entries(value)
+        .filter(([name, version]) => name.startsWith("@agent-native/") &&
+        typeof version === "string" &&
+        version.trim().length > 0)
+        .map(([name, version]) => [name, version.trim()]));
+}
+function injectedPackageVersions() {
+    if (typeof __AGENT_NATIVE_PACKAGE_VERSIONS__ !== "undefined") {
+        return readPackageVersions(__AGENT_NATIVE_PACKAGE_VERSIONS__);
+    }
+    return readPackageVersions(globalThis.__AGENT_NATIVE_PACKAGE_VERSIONS__);
+}
+export function getAgentNativePackageVersions() {
+    return Object.entries(injectedPackageVersions())
+        .sort(([left], [right]) => left.localeCompare(right))
+        .map(([name, version]) => ({ name, version }));
+}
+export function getAgentNativeDiagnostics() {
+    return {
+        buildId: clientBuildId() || "development",
+        environment: injectedAgentNativeConfig().deployment?.environment ?? "unknown",
+        packages: Object.fromEntries(getAgentNativePackageVersions().map(({ name, version }) => [
+            name,
+            version,
+        ])),
+    };
+}
+export function formatAgentNativeDiagnostics() {
+    return JSON.stringify(getAgentNativeDiagnostics(), null, 2);
+}

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

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

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/localization/core-messages/ar-SA.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "الإشارة إلى ملفات أو وكلاء أو موارد",
     "commands.new": "مثل /clear",
     "commands.plan": "التبديل إلى التخطيط للقراءة فقط",
+    "aboutAgentNative.title": "حول Agent Native",
+    "aboutAgentNative.version": "الإصدار",
+    "aboutAgentNative.environment": "البيئة",
+    "aboutAgentNative.build": "البنية",
+    "aboutAgentNative.copyDiagnostics": "نسخ بيانات التشخيص",
+    "aboutAgentNative.unknown": "غير معروف",
     "common.agent": "الوكيل",
     "common.cancel": "إلغاء",
     "common.collapse": "طي",

package/dist/localization/core-messages/de-DE.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "Dateien, Agenten oder Ressourcen erwähnen",
     "commands.new": "Entspricht /clear",
     "commands.plan": "Zum schreibgeschützten Planungsmodus wechseln",
+    "aboutAgentNative.title": "Über Agent Native",
+    "aboutAgentNative.version": "Version",
+    "aboutAgentNative.environment": "Umgebung",
+    "aboutAgentNative.build": "Build",
+    "aboutAgentNative.copyDiagnostics": "Diagnosedaten kopieren",
+    "aboutAgentNative.unknown": "Unbekannt",
     "common.agent": "Agent",
     "common.cancel": "Abbrechen",
     "common.collapse": "Einklappen",

package/dist/localization/core-messages/en-US.d.ts

@@ -24,6 +24,12 @@ declare const messages: {
     readonly "commands.mention": "Mention files, agents, or resources";
     readonly "commands.new": "Same as /clear";
     readonly "commands.plan": "Switch to read-only planning";
+    readonly "aboutAgentNative.title": "About Agent Native";
+    readonly "aboutAgentNative.version": "Version";
+    readonly "aboutAgentNative.environment": "Environment";
+    readonly "aboutAgentNative.build": "Build";
+    readonly "aboutAgentNative.copyDiagnostics": "Copy diagnostics";
+    readonly "aboutAgentNative.unknown": "Unknown";
     readonly "common.agent": "Agent";
     readonly "common.cancel": "Cancel";
     readonly "common.collapse": "Collapse";

package/dist/localization/core-messages/en-US.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "Mention files, agents, or resources",
     "commands.new": "Same as /clear",
     "commands.plan": "Switch to read-only planning",
+    "aboutAgentNative.title": "About Agent Native",
+    "aboutAgentNative.version": "Version",
+    "aboutAgentNative.environment": "Environment",
+    "aboutAgentNative.build": "Build",
+    "aboutAgentNative.copyDiagnostics": "Copy diagnostics",
+    "aboutAgentNative.unknown": "Unknown",
     "common.agent": "Agent",
     "common.cancel": "Cancel",
     "common.collapse": "Collapse",

package/dist/localization/core-messages/es-ES.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "Mencionar archivos, agentes o recursos",
     "commands.new": "Igual que /clear",
     "commands.plan": "Cambiar a la planificación de solo lectura",
+    "aboutAgentNative.title": "Acerca de Agent Native",
+    "aboutAgentNative.version": "Versión",
+    "aboutAgentNative.environment": "Entorno",
+    "aboutAgentNative.build": "Compilación",
+    "aboutAgentNative.copyDiagnostics": "Copiar diagnóstico",
+    "aboutAgentNative.unknown": "Desconocida",
     "common.agent": "Agente",
     "common.cancel": "Cancelar",
     "common.collapse": "Contraer",

package/dist/localization/core-messages/fr-FR.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "Mentionner des fichiers, des agents ou des ressources",
     "commands.new": "Identique à /clear",
     "commands.plan": "Passer à la planification en lecture seule",
+    "aboutAgentNative.title": "À propos d’Agent Native",
+    "aboutAgentNative.version": "Version",
+    "aboutAgentNative.environment": "Environnement",
+    "aboutAgentNative.build": "Build",
+    "aboutAgentNative.copyDiagnostics": "Copier les diagnostics",
+    "aboutAgentNative.unknown": "Inconnue",
     "common.agent": "Agent",
     "common.cancel": "Annuler",
     "common.collapse": "Réduire",

package/dist/localization/core-messages/hi-IN.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "फ़ाइलों, एजेंटों या संसाधनों का उल्लेख करें",
     "commands.new": "/clear के समान",
     "commands.plan": "केवल-पढ़ने योग्य योजना मोड पर जाएँ",
+    "aboutAgentNative.title": "Agent Native के बारे में",
+    "aboutAgentNative.version": "संस्करण",
+    "aboutAgentNative.environment": "पर्यावरण",
+    "aboutAgentNative.build": "बिल्ड",
+    "aboutAgentNative.copyDiagnostics": "डायग्नोस्टिक कॉपी करें",
+    "aboutAgentNative.unknown": "अज्ञात",
     "common.agent": "एजेंट",
     "common.cancel": "रद्द करें",
     "common.collapse": "समेटें",

package/dist/localization/core-messages/ja-JP.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "ファイル、エージェント、リソースをメンション",
     "commands.new": "/clear と同じ",
     "commands.plan": "読み取り専用の計画モードに切り替え",
+    "aboutAgentNative.title": "Agent Native について",
+    "aboutAgentNative.version": "バージョン",
+    "aboutAgentNative.environment": "環境",
+    "aboutAgentNative.build": "ビルド",
+    "aboutAgentNative.copyDiagnostics": "診断情報をコピー",
+    "aboutAgentNative.unknown": "不明",
     "common.agent": "エージェント",
     "common.cancel": "キャンセル",
     "common.collapse": "折りたたむ",

package/dist/localization/core-messages/ko-KR.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "파일, 에이전트 또는 리소스 멘션",
     "commands.new": "/clear와 동일",
     "commands.plan": "읽기 전용 계획 모드로 전환",
+    "aboutAgentNative.title": "Agent Native 정보",
+    "aboutAgentNative.version": "버전",
+    "aboutAgentNative.environment": "환경",
+    "aboutAgentNative.build": "빌드",
+    "aboutAgentNative.copyDiagnostics": "진단 정보 복사",
+    "aboutAgentNative.unknown": "알 수 없음",
     "common.agent": "에이전트",
     "common.cancel": "취소",
     "common.collapse": "접기",

package/dist/localization/core-messages/pt-BR.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "Mencionar arquivos, agentes ou recursos",
     "commands.new": "O mesmo que /clear",
     "commands.plan": "Mudar para o planejamento somente leitura",
+    "aboutAgentNative.title": "Sobre o Agent Native",
+    "aboutAgentNative.version": "Versão",
+    "aboutAgentNative.environment": "Ambiente",
+    "aboutAgentNative.build": "Build",
+    "aboutAgentNative.copyDiagnostics": "Copiar diagnósticos",
+    "aboutAgentNative.unknown": "Desconhecida",
     "common.agent": "Agente",
     "common.cancel": "Cancelar",
     "common.collapse": "Recolher",

package/dist/localization/core-messages/zh-CN.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "提及文件、智能体或资源",
     "commands.new": "与 /clear 相同",
     "commands.plan": "切换到只读规划模式",
+    "aboutAgentNative.title": "关于 Agent Native",
+    "aboutAgentNative.version": "版本",
+    "aboutAgentNative.environment": "环境",
+    "aboutAgentNative.build": "构建",
+    "aboutAgentNative.copyDiagnostics": "复制诊断信息",
+    "aboutAgentNative.unknown": "未知",
     "common.agent": "智能体",
     "common.cancel": "取消",
     "common.collapse": "收起",

package/dist/localization/core-messages/zh-TW.js

@@ -24,6 +24,12 @@ const messages = {
     "commands.mention": "提及檔案、代理或資源",
     "commands.new": "與 /clear 相同",
     "commands.plan": "切換到唯讀規劃模式",
+    "aboutAgentNative.title": "關於 Agent Native",
+    "aboutAgentNative.version": "版本",
+    "aboutAgentNative.environment": "環境",
+    "aboutAgentNative.build": "建置",
+    "aboutAgentNative.copyDiagnostics": "複製診斷資訊",
+    "aboutAgentNative.unknown": "未知",
     "common.agent": "代理",
     "common.cancel": "取消",
     "common.collapse": "收合",

package/dist/localization/core-messages.d.ts

@@ -26,6 +26,12 @@ export declare const englishAgentChatMessages: {
     readonly "commands.mention": "Mention files, agents, or resources";
     readonly "commands.new": "Same as /clear";
     readonly "commands.plan": "Switch to read-only planning";
+    readonly "aboutAgentNative.title": "About Agent Native";
+    readonly "aboutAgentNative.version": "Version";
+    readonly "aboutAgentNative.environment": "Environment";
+    readonly "aboutAgentNative.build": "Build";
+    readonly "aboutAgentNative.copyDiagnostics": "Copy diagnostics";
+    readonly "aboutAgentNative.unknown": "Unknown";
     readonly "common.agent": "Agent";
     readonly "common.cancel": "Cancel";
     readonly "common.collapse": "Collapse";

package/dist/observability/routes.d.ts

@@ -42,22 +42,22 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     avgEvalScore: number;
 } | {
     error?: undefined;
+    ok?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
-    ok?: undefined;
 } | {
     error?: undefined;
+    ok?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
-    ok?: undefined;
 } | {
+    ok?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
     error: any;
-    ok?: undefined;
 } | {
     error?: undefined;
     summary?: undefined;

package/dist/progress/routes.d.ts

@@ -15,6 +15,6 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>>;

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -93,29 +93,29 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
+    count?: undefined;
     id?: undefined;
     deleted?: undefined;
     providers?: undefined;
-    count?: undefined;
     found: boolean;
     provider: import("../custom-registry.js").CustomProviderConfig;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
+    count?: undefined;
     provider?: undefined;
     deleted?: undefined;
     providers?: undefined;
-    count?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
+    count?: undefined;
     provider?: undefined;
     providers?: undefined;
-    count?: undefined;
     found?: undefined;
     deleted: boolean;
     id: string;
@@ -123,10 +123,10 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
+    count?: undefined;
     provider?: undefined;
     deleted?: undefined;
     providers?: undefined;
-    count?: undefined;
     found?: undefined;
     registered: boolean;
     id: string;

package/dist/provider-api/actions/provider-api.d.ts

@@ -313,7 +313,6 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
     }, {
         id?: undefined;
         provider?: undefined;
-        deleted?: undefined;
         providers: {
             id: string;
             label: string;
@@ -325,33 +324,34 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         }[];
         count: number;
         found?: undefined;
+        deleted?: undefined;
         registered?: undefined;
         label?: undefined;
         message?: undefined;
     } | {
-        count?: undefined;
         id?: undefined;
-        deleted?: undefined;
         providers?: undefined;
+        count?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
+        deleted?: undefined;
         registered?: undefined;
         label?: undefined;
         message?: undefined;
     } | {
-        count?: undefined;
         provider?: undefined;
-        deleted?: undefined;
         providers?: undefined;
+        count?: undefined;
         found: boolean;
         id: string;
+        deleted?: undefined;
         registered?: undefined;
         label?: undefined;
         message?: undefined;
     } | {
-        count?: undefined;
         provider?: undefined;
         providers?: undefined;
+        count?: undefined;
         found?: undefined;
         deleted: boolean;
         id: string;
@@ -359,11 +359,11 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         label?: undefined;
         message?: undefined;
     } | {
-        count?: undefined;
         provider?: undefined;
-        deleted?: undefined;
         providers?: undefined;
+        count?: undefined;
         found?: undefined;
+        deleted?: undefined;
         registered: boolean;
         id: string;
         label: string;

package/dist/provider-api/corpus-jobs.d.ts

@@ -73,6 +73,7 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     offset?: unknown;
     limit?: unknown;
 }, {
+    deleted?: undefined;
     jobs: {
         id: string;
         name: string;
@@ -83,7 +84,6 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
         updatedAt: string;
     }[];
     total: number;
-    deleted?: undefined;
     jobId?: undefined;
 } | {
     jobs?: undefined;
@@ -91,9 +91,9 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     deleted: boolean;
     jobId: string;
 } | {
+    deleted?: undefined;
     jobs?: undefined;
     total?: undefined;
-    deleted?: undefined;
     jobId?: undefined;
     hits: Record<string, unknown>[];
     offset: number;

package/dist/resources/handlers.d.ts

@@ -51,8 +51,8 @@ export declare function handleDeleteResource(event: any): Promise<{
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>;
 /** POST /_agent-native/resources/upload — upload a file as a resource */
 export declare function handleUploadResource(event: any): Promise<import("./store.js").Resource | {
@@ -73,10 +73,10 @@ export declare function handleUploadResource(event: any): Promise<import("./stor
     runId: string | null;
     expiresAt: number | null;
     metadata: string | null;
-    error?: undefined;
     url: string;
     provider: string;
     storageSetupRequired?: undefined;
+    error?: undefined;
 } | {
     error: string;
     storageSetupRequired: boolean;

package/dist/vite/client.js

@@ -20,6 +20,7 @@ import { formatRuntimeConfigReport, getRuntimeConfigReport, isTruthyRuntimeValue
 import { actionTypesPlugin } from "./action-types-plugin.js";
 import { createAgentNativeConfigContext, loadAgentNativeConfigFile, loadWorkspaceAgentNativeConfigFile, readAgentNativeJsonConfig, } from "./agent-native-config-loader.js";
 import { agentsBundlePlugin } from "./agents-bundle-plugin.js";
+import { resolveAgentNativePackageVersions } from "./package-versions.js";
 const require = createRequire(import.meta.url);
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 let nitroFsWatchGuardInstalled = false;
@@ -2842,6 +2843,7 @@ function createAgentNativeConfig(options = {}, command, userConfig = {}, mode =
         process.env.CF_PAGES_COMMIT_SHA?.trim() ||
         process.env.AGENT_NATIVE_BUILD_SHA?.trim() ||
         "development";
+    const packageVersions = resolveAgentNativePackageVersions(cwd);
     // Preload workspace-root .env into process.env so Nitro server code sees
     // shared keys during dev (Nitro reads process.env, not vite's envDir).
     if (workspaceRoot && workspaceRoot !== cwd) {
@@ -2912,6 +2914,7 @@ function createAgentNativeConfig(options = {}, command, userConfig = {}, mode =
             ...(userConfig.define ?? {}),
             ...(options.define ?? {}),
             __AGENT_NATIVE_BUILD_ID__: JSON.stringify(buildId),
+            __AGENT_NATIVE_PACKAGE_VERSIONS__: JSON.stringify(packageVersions),
             __AGENT_NATIVE_CLIENT_COMPATIBILITY_VERSION__: JSON.stringify(options.clientCompatibilityVersion?.trim() || ""),
             __AGENT_NATIVE_APP_CONFIG__: JSON.stringify(resolvedAppConfig),
             __AGENT_NATIVE_BUILD_GA_MEASUREMENT_ID__: JSON.stringify(process.env.GA_MEASUREMENT_ID?.trim() || ""),

package/dist/vite/package-versions.d.ts

@@ -0,0 +1 @@
+export declare function resolveAgentNativePackageVersions(cwd: string): Record<string, string>;

package/dist/vite/package-versions.js

@@ -0,0 +1,97 @@
+import fs from "fs";
+import { createRequire } from "module";
+import path from "path";
+import { fileURLToPath } from "url";
+const AGENT_NATIVE_PACKAGE_PREFIX = "@agent-native/";
+function readPackageManifest(manifestPath) {
+    try {
+        const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+        return manifest && typeof manifest === "object"
+            ? manifest
+            : null;
+    }
+    catch {
+        // coercion-ok: missing or malformed manifests are typed absence from the optional version inventory.
+        return null;
+    }
+}
+function dependencyNames(manifest, includeDevDependencies = false) {
+    if (!manifest) {
+        return [];
+    }
+    return [
+        ...Object.keys(manifest.dependencies ?? {}),
+        ...Object.keys(manifest.optionalDependencies ?? {}),
+        ...Object.keys(manifest.peerDependencies ?? {}),
+        ...(includeDevDependencies
+            ? Object.keys(manifest.devDependencies ?? {})
+            : []),
+    ];
+}
+function resolvePackageManifest(packageName, resolutionBase) {
+    let entryPath;
+    const packageRequire = createRequire(path.join(resolutionBase, "package.json"));
+    try {
+        entryPath = packageRequire.resolve(packageName);
+    }
+    catch {
+        if (packageName !== "@agent-native/core") {
+            return null;
+        }
+        const coreManifestPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../package.json");
+        const coreManifest = readPackageManifest(coreManifestPath);
+        return coreManifest?.name === packageName
+            ? { manifest: coreManifest, manifestPath: coreManifestPath }
+            : null;
+    }
+    let directory = path.dirname(entryPath);
+    for (let depth = 0; depth < 20; depth += 1) {
+        const manifestPath = path.join(directory, "package.json");
+        const manifest = readPackageManifest(manifestPath);
+        if (manifest?.name === packageName) {
+            return { manifest, manifestPath };
+        }
+        const parent = path.dirname(directory);
+        if (parent === directory) {
+            break;
+        }
+        directory = parent;
+    }
+    return null;
+}
+export function resolveAgentNativePackageVersions(cwd) {
+    const appManifest = readPackageManifest(path.join(cwd, "package.json"));
+    const packageNames = new Set([
+        "@agent-native/core",
+        ...dependencyNames(appManifest, true).filter((name) => name.startsWith(AGENT_NATIVE_PACKAGE_PREFIX)),
+    ]);
+    const resolvedVersions = new Map();
+    const queuedPackages = [...packageNames].map((packageName) => ({
+        packageName,
+        resolutionBase: cwd,
+    }));
+    while (queuedPackages.length > 0) {
+        const queuedPackage = queuedPackages.shift();
+        if (!queuedPackage)
+            continue;
+        const resolvedPackage = resolvePackageManifest(queuedPackage.packageName, queuedPackage.resolutionBase);
+        if (!resolvedPackage) {
+            continue;
+        }
+        const { manifest } = resolvedPackage;
+        if (typeof manifest.version === "string" && manifest.version.trim()) {
+            resolvedVersions.set(queuedPackage.packageName, manifest.version.trim());
+        }
+        for (const dependencyName of dependencyNames(manifest)) {
+            if (dependencyName.startsWith(AGENT_NATIVE_PACKAGE_PREFIX) &&
+                !packageNames.has(dependencyName)) {
+                packageNames.add(dependencyName);
+                queuedPackages.push({
+                    packageName: dependencyName,
+                    resolutionBase: path.dirname(resolvedPackage.manifestPath),
+                });
+            }
+        }
+    }
+    return Object.fromEntries([...resolvedVersions.entries()].sort(([left], [right]) => left.localeCompare(right)));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.0.0-beta-20260820231735",
+  "version": "0.0.0-beta-20260820233158",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {