@agent-native/core 0.168.11 → 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/design/app/components/layout/Layout.tsx

@@ -48,26 +48,51 @@ export function useOpenMobileSidebar() {
 const BARE_PREFIXES = ["/present/"];
 
 /**
- * Routes where the page renders its own toolbar instead of the global Header.
- * The Header is hidden so the page can supply richer custom chrome (e.g.
- * DesignEditor mode/zoom/device, shared ExtensionViewer / ExtensionsListPage
- * chrome). The editor owns its agent surface inside its Figma-style left rail.
+ * Routes where the page renders its own toolbar instead of the global Header
+ * on a standalone page. Embedded app surfaces keep the global shell so the
+ * host-provided chat rail can still be reopened from the app header.
  */
 const EDITOR_PREFIXES = ["/design/", "/visual-edit/", "/extensions"];
 
+type DesignLayoutMode = "host-bare" | "standalone-editor" | "app-shell";
+
+function resolveDesignLayoutMode(input: {
+  builderHostEmbed: boolean;
+  embedded: boolean;
+  hasSession: boolean;
+  isDesignEditor: boolean;
+}): DesignLayoutMode {
+  if (
+    input.builderHostEmbed ||
+    (input.isDesignEditor && !input.hasSession && !input.embedded)
+  ) {
+    return "host-bare";
+  }
+  if (input.isDesignEditor && !input.embedded) return "standalone-editor";
+  return "app-shell";
+}
+
 export function Layout({ children }: LayoutProps) {
   const location = useLocation();
   const t = useT();
   const { session } = useSession();
   const hasSession = Boolean(session?.email);
+  const builderHostEmbed = isBuilderHostEmbed();
   // The shell canvas is embedded without a session, so this cannot be the token
   // check alone or it renders Design's own nav inside Builder.
-  const embedded = isBuilderHostEmbed() || isEmbedAuthActive();
+  const embedded = builderHostEmbed || isEmbedAuthActive();
   useNavigationState(hasSession);
   const [mobileSidebarOpen, setMobileSidebarOpen] = useState(false);
   const openMobileSidebar = useCallback(() => setMobileSidebarOpen(true), []);
   const isDesignEditor = isDesignEditorRoute(location.pathname);
-  const showMobileTopBar = !isDesignEditor;
+  const layoutMode = resolveDesignLayoutMode({
+    builderHostEmbed,
+    embedded,
+    hasSession,
+    isDesignEditor,
+  });
+  const standaloneEditor = layoutMode === "standalone-editor";
+  const showMobileTopBar = !standaloneEditor;
   const browserTabId = getBrowserTabId();
   const {
     link: detectedFigmaComposerLink,
@@ -109,11 +134,10 @@ export function Layout({ children }: LayoutProps) {
     return <>{children}</>;
   }
 
-  const hideHeader = EDITOR_PREFIXES.some((p) =>
-    location.pathname.startsWith(p),
-  );
+  const hideHeader =
+    !embedded && EDITOR_PREFIXES.some((p) => location.pathname.startsWith(p));
 
-  if (embedded || (isDesignEditor && !hasSession)) {
+  if (layoutMode === "host-bare") {
     return (
       <HeaderActionsProvider>
         <MobileSidebarContext.Provider value={null}>
@@ -132,7 +156,7 @@ export function Layout({ children }: LayoutProps) {
     );
   }
 
-  if (isDesignEditor) {
+  if (layoutMode === "standalone-editor") {
     return (
       <HeaderActionsProvider>
         <MobileSidebarContext.Provider value={null}>
@@ -151,7 +175,7 @@ export function Layout({ children }: LayoutProps) {
   return (
     <HeaderActionsProvider>
       <MobileSidebarContext.Provider
-        value={isDesignEditor ? null : openMobileSidebar}
+        value={standaloneEditor ? null : openMobileSidebar}
       >
         <AgentSidebar
           position="right"
@@ -178,13 +202,13 @@ export function Layout({ children }: LayoutProps) {
           }
         >
           <div className="agent-layout-shell flex h-dvh w-full overflow-hidden bg-background text-foreground">
-            {!isDesignEditor && mobileSidebarOpen && (
+            {!standaloneEditor && mobileSidebarOpen && (
               <div
                 className="fixed inset-0 z-40 bg-black/50 md:hidden"
                 onClick={() => setMobileSidebarOpen(false)}
               />
             )}
-            {!isDesignEditor && (
+            {!standaloneEditor && (
               <div
                 className={cn(
                   "agent-layout-left-drawer fixed inset-y-0 start-0 z-50 transition-transform duration-200 ease-out md:static md:z-auto md:transition-none motion-reduce:transition-none",

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/observability/routes.d.ts

@@ -41,16 +41,16 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
+    error?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
-    error?: undefined;
     ok?: undefined;
 } | {
+    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
-    error?: undefined;
     ok?: undefined;
 } | {
     summary?: undefined;
@@ -59,9 +59,9 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     error: any;
     ok?: undefined;
 } | {
+    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: 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/secrets/routes.d.ts

@@ -37,17 +37,17 @@ export declare function createWriteSecretHandler(): import("h3").EventHandlerWit
     ok?: undefined;
     status?: undefined;
 } | {
+    error?: undefined;
     ok: boolean;
     status: string;
-    error?: undefined;
 } | {
     ok?: undefined;
     error: string;
     removed?: undefined;
 } | {
+    error?: undefined;
     ok: boolean;
     removed: boolean;
-    error?: undefined;
 }>>;
 /**
  * POST /_agent-native/secrets/:key/test — validate an optional candidate value
@@ -58,13 +58,13 @@ export declare function createTestSecretHandler(): import("h3").EventHandlerWith
     error: string;
     note?: undefined;
 } | {
+    error?: undefined;
     ok: boolean;
     note?: undefined;
-    error?: undefined;
 } | {
+    error?: undefined;
     ok: boolean;
     note: string;
-    error?: undefined;
 } | {
     note?: undefined;
     ok: boolean;
@@ -95,11 +95,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;
 } | {
+    error?: undefined;
     ok: boolean;
     removed: boolean;
-    error?: undefined;
 }>>;

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/dist/server/realtime-token.d.ts

@@ -26,8 +26,8 @@ export declare function createRealtimeTokenHandler(): import("h3").EventHandlerW
     expiresAt?: undefined;
     ttlSeconds?: undefined;
 } | {
+    error?: undefined;
     token: string;
     expiresAt: string;
     ttlSeconds: number;
-    error?: undefined;
 }>>;

package/dist/server/transcribe-voice.d.ts

@@ -20,6 +20,6 @@ export declare function createTranscribeVoiceHandler(): import("h3").EventHandle
     error: string;
     text?: undefined;
 } | {
-    text: string;
     error?: undefined;
+    text: string;
 }>>;

package/package.json

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