@agent-native/core 0.168.12 → 0.168.13

package/corpus/templates/clips/app/lib/capture-install-options.ts

@@ -44,6 +44,21 @@ export function markDesktopAppDownloaded(): void {
   downloadedListeners.forEach((fn) => fn());
 }
 
+// A failed launch attempt (the protocol handler is gone, e.g. after an
+// uninstall) reverts both flags set by markDesktopAppDownloaded, so CTAs flip
+// back to the install/download state instead of staying stuck on "Open".
+export function clearDesktopAppDownloaded(): void {
+  try {
+    window.localStorage?.removeItem(DESKTOP_DOWNLOADED_STORAGE_KEY);
+    window.localStorage?.removeItem(DESKTOP_PROMO_DISMISSED_STORAGE_KEY);
+  } catch {
+    // coercion-ok: storage access is optional; the CTA falls back to the
+    // stale "downloaded" label this session, and the next failed launch
+    // attempt retries the reset.
+  }
+  downloadedListeners.forEach((fn) => fn());
+}
+
 export function hasDismissedDesktopPromo(): boolean {
   try {
     return (
@@ -69,7 +84,7 @@ export function markDesktopPromoDismissed(): void {
  * to query whether the protocol is registered, so we watch for the tab losing
  * focus (the app taking over) within a short window; if that never happens we
  * assume the app is not installed and navigate to the fallback. A successful
- * launch self-heals the stored "downloaded" flag.
+ * launch self-heals the stored "downloaded" flag, and a failed one clears it.
  */
 export function attemptOpenDesktopApp(fallbackHref = "/download"): void {
   if (typeof window === "undefined") return;
@@ -95,7 +110,10 @@ export function attemptOpenDesktopApp(fallbackHref = "/download"): void {
 
   window.setTimeout(() => {
     cleanup();
-    if (!launched) window.location.href = fallbackUrl;
+    if (!launched) {
+      clearDesktopAppDownloaded();
+      window.location.href = fallbackUrl;
+    }
   }, DESKTOP_APP_LAUNCH_FALLBACK_MS);
 
   try {

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

@@ -218,7 +218,15 @@ export default function Root() {
     <AppToolkitProvider>
       <AppProviders
         queryClient={queryClient}
-        toaster={<Toaster richColors position="bottom-left" closeButton />}
+        toaster={
+          <Toaster
+            richColors
+            position="bottom-left"
+            closeButton
+            offset={{ bottom: 44, left: 32 }}
+            mobileOffset={{ bottom: 44, left: 16 }}
+          />
+        }
         i18n={{ catalog: i18nCatalog }}
       >
         <AppContent />

package/dist/client/EnvironmentBadge.d.ts

@@ -2,12 +2,13 @@ import type { AgentNativeDeploymentEnvironment, AgentNativeConfig } from "../con
 export { BETA_OPT_OUT_DURATION_MS, BETA_OPT_OUT_QUERY_PARAM, BETA_OPT_OUT_STORAGE_KEY, buildEnvironmentOptOutUrl, buildEnvironmentUrl, resolveEnvironmentTargets, type EnvironmentBadgeTargets, } from "../shared/environment-lanes.js";
 export declare function isBuilderIoEmployee(email: string | null | undefined): boolean;
 export declare function isAgentNativeDesktopUserAgent(userAgent: string | undefined): boolean;
-export declare function resolveEnvironmentChannel(config: AgentNativeConfig, hostname: string | undefined): Extract<AgentNativeDeploymentEnvironment, "beta" | "production"> | null;
+export declare function resolveEnvironmentChannel(config: AgentNativeConfig, hostname: string | undefined): Extract<AgentNativeDeploymentEnvironment, "local" | "beta" | "production"> | null;
 export declare function isBetaOptOutActive(value: string | number | null | undefined, now?: number): boolean;
 /**
- * First-party hosted lane switcher. Beta is intentionally visible before
- * authentication so a visitor can always leave beta from the sign-in page.
- * Production remains an internal auto-redirect lane for authenticated staff.
+ * Environment indicator and first-party hosted lane switcher. Beta is
+ * intentionally visible before authentication so a visitor can always leave
+ * beta from the sign-in page. Production remains an internal auto-redirect
+ * lane for authenticated staff.
  */
 export declare function EnvironmentBadge({ showProduction, }?: {
     showProduction?: boolean;

package/dist/client/EnvironmentBadge.js

@@ -16,7 +16,9 @@ export function isAgentNativeDesktopUserAgent(userAgent) {
 }
 export function resolveEnvironmentChannel(config, hostname) {
     const configured = config.deployment?.environment;
-    if (configured === "beta" || configured === "production") {
+    if (configured === "local" ||
+        configured === "beta" ||
+        configured === "production") {
         return configured;
     }
     const targets = resolveEnvironmentTargets(hostname);
@@ -74,6 +76,7 @@ function consumeBetaOptOutQueryParam(sourceHref, now = Date.now()) {
     }
     return active;
 }
+const environmentBadgePlacementClasses = "fixed bottom-3 left-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";
 function EnvironmentLink({ label, href }) {
     return (_jsx(Button, { asChild: true, className: "w-full justify-center", size: "sm", variant: "outline", children: _jsx("a", { href: href, children: label }) }));
 }
@@ -89,9 +92,12 @@ 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: 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"
+    return (_jsxs(Popover, { children: [_jsx(PopoverTrigger, { asChild: true, children: _jsx(Button, { "aria-label": `Open ${title.toLowerCase()} switcher`, className: cn(environmentBadgePlacementClasses, 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" })) })] })] }));
+                        : "border-border/80 bg-background/95 text-foreground"), size: "sm", variant: environment === "beta" ? "default" : "outline", children: label }) }), _jsxs(PopoverContent, { align: "start", 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 LocalEnvironmentBadge() {
+    return (_jsx("div", { "aria-label": "Local development environment", className: cn(environmentBadgePlacementClasses, "inline-flex items-center justify-center border border-border/80 bg-background/95 text-foreground"), role: "status", children: "dev" }));
 }
 function ProductionEnvironmentBadge({ targets, }) {
     const { session, status } = useSession();
@@ -128,9 +134,10 @@ function ProductionEnvironmentBadge({ targets, }) {
     return _jsx(EnvironmentBadgeContent, { environment: "production", targets: targets });
 }
 /**
- * First-party hosted lane switcher. Beta is intentionally visible before
- * authentication so a visitor can always leave beta from the sign-in page.
- * Production remains an internal auto-redirect lane for authenticated staff.
+ * Environment indicator and first-party hosted lane switcher. Beta is
+ * intentionally visible before authentication so a visitor can always leave
+ * beta from the sign-in page. Production remains an internal auto-redirect
+ * lane for authenticated staff.
  */
 export function EnvironmentBadge({ showProduction = true, } = {}) {
     const config = useMemo(injectedAgentNativeConfig, []);
@@ -139,10 +146,14 @@ export function EnvironmentBadge({ showProduction = true, } = {}) {
     const targets = resolveEnvironmentTargets(hostname);
     if (typeof window === "undefined" ||
         window.parent !== window ||
-        !environment ||
-        !targets) {
+        !environment) {
         return null;
     }
+    if (environment === "local") {
+        return _jsx(LocalEnvironmentBadge, {});
+    }
+    if (!targets)
+        return null;
     if (environment === "beta") {
         return _jsx(EnvironmentBadgeContent, { environment: "beta", targets: targets });
     }

package/dist/client/app-providers.d.ts

@@ -39,7 +39,8 @@
  *   toaster                  — custom Toaster element rendered after children.
  *                              Pass `null` to suppress the built-in Toaster when
  *                              children already include a styled one.
- *                              Defaults to `<Toaster richColors position="bottom-left" />`.
+ *                              Defaults to a rich-color bottom-left toaster raised above
+ *                              the environment badge.
  *   disableThemeTransitions  — passed to next-themes ThemeProvider
  *                              `disableTransitionOnChange`. Defaults to `true`
  *                              (suppresses CSS transitions during theme switches,
@@ -75,7 +76,7 @@ export interface AppProvidersProps {
      * Custom Toaster element rendered after children inside TooltipProvider.
      * Pass `null` to suppress the built-in Toaster when children already
      * include a styled one.
-     * Defaults to `<Toaster richColors position="bottom-left" />`.
+     * Defaults to a rich-color bottom-left toaster raised above the environment badge.
      */
     toaster?: React.ReactNode | null;
     /**

package/dist/client/app-providers.js

@@ -40,7 +40,8 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  *   toaster                  — custom Toaster element rendered after children.
  *                              Pass `null` to suppress the built-in Toaster when
  *                              children already include a styled one.
- *                              Defaults to `<Toaster richColors position="bottom-left" />`.
+ *                              Defaults to a rich-color bottom-left toaster raised above
+ *                              the environment badge.
  *   disableThemeTransitions  — passed to next-themes ThemeProvider
  *                              `disableTransitionOnChange`. Defaults to `true`
  *                              (suppresses CSS transitions during theme switches,
@@ -65,7 +66,7 @@ import { AgentNativeRouteWarmup } from "./route-warmup.js";
 import { RouteTransitionIndicator } from "./RouteTransitionIndicator.js";
 import { RuntimeConfigNotice } from "./RuntimeConfigNotice.js";
 import { EMBEDDED_THEME_CHANGE_EVENT, applyEmbeddedThemeUpdate, parseEmbeddedThemeUpdate, } from "./theme.js";
-const DEFAULT_TOASTER = _jsx(Toaster, { richColors: true, position: "bottom-left" });
+const DEFAULT_TOASTER = (_jsx(Toaster, { richColors: true, position: "bottom-left", offset: { bottom: 44, left: 32 }, mobileOffset: { bottom: 44, left: 16 } }));
 function RoutedAppEnhancements() {
     const isInRouter = useInRouterContext();
     if (!isInRouter)

package/dist/collab/awareness.d.ts

@@ -62,11 +62,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
-    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
+    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -77,9 +77,9 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
-    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
+    error?: undefined;
 }>>;

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<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/notifications/routes.d.ts

@@ -11,14 +11,14 @@
  *   DELETE /_agent-native/notifications/:id         — delete
  */
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
-    error?: undefined;
     count: number;
     updated?: undefined;
+    error?: undefined;
     ok?: undefined;
 } | {
-    error?: undefined;
     count?: undefined;
     updated: number;
+    error?: undefined;
     ok?: undefined;
 } | {
     count?: undefined;
@@ -26,8 +26,8 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     count?: undefined;
     updated?: undefined;
+    error?: undefined;
     ok: boolean;
 }>>;

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/resources/handlers.d.ts

@@ -48,8 +48,8 @@ export declare function handleUpdateResource(event: any): Promise<import("./stor
 }>;
 /** DELETE /_agent-native/resources/:id — delete a resource */
 export declare function handleDeleteResource(event: any): Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/server/beta-opt-out-html.js

@@ -22,7 +22,7 @@ const environmentSwitcherStyles = `<style ${ENVIRONMENT_SWITCHER_STYLE_MARKER}>
   color-scheme: dark;
   .environment-switcher {
     position: fixed;
-    right: max(0.75rem, env(safe-area-inset-right));
+    left: max(0.75rem, env(safe-area-inset-left));
     bottom: max(0.75rem, env(safe-area-inset-bottom));
     z-index: 100;
   }
@@ -59,9 +59,10 @@ const environmentSwitcherStyles = `<style ${ENVIRONMENT_SWITCHER_STYLE_MARKER}>
   }
   .environment-popover {
     position: absolute;
-    right: 0;
+    left: 0;
     bottom: calc(100% + 0.5rem);
     width: min(17.5rem, calc(100vw - 1.5rem));
+    box-sizing: border-box;
     padding: 1.25rem;
     background: Canvas;
     color: CanvasText;

package/dist/server/onboarding-html.js

@@ -1639,7 +1639,7 @@ ${hasMarketing
   /* guard:allow-raw-color - standalone auth HTML has no app theme token layer */
   .environment-switcher {
     position: fixed;
-    right: max(0.75rem, env(safe-area-inset-right));
+    left: max(0.75rem, env(safe-area-inset-left));
     bottom: max(0.75rem, env(safe-area-inset-bottom));
     z-index: 100;
   }
@@ -1674,9 +1674,10 @@ ${hasMarketing
   }
   .environment-popover {
     position: absolute;
-    right: 0;
+    left: 0;
     bottom: calc(100% + 0.5rem);
     width: min(17.5rem, calc(100vw - 1.5rem));
+    box-sizing: border-box;
     padding: 1.25rem;
     background: #141414;
     color: #fff;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.168.12",
+  "version": "0.168.13",
   "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": {