@agent-native/core 0.184.0 → 0.184.1-nightly-20260922203115

package/dist/client/LanguagePicker.js

@@ -0,0 +1,128 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Picker, useDesignSystemComponent, } from "@agent-native/toolkit/design-system";
+import * as PopoverPrimitive from "@radix-ui/react-popover";
+import { IconCheck, IconChevronDown, IconLanguage } from "@tabler/icons-react";
+import { useState } from "react";
+import { DEFAULT_LOCALE, localeDisplayName, normalizeLocalizationPreference, resolveLocaleFromCandidates, } from "../localization/shared.js";
+import { useLocale } from "./i18n.js";
+import { cn } from "./utils.js";
+const LANGUAGE_PICKER_COPY = {
+    "en-US": {
+        label: "Language",
+        system: "System",
+        systemDescription: "Use your browser language",
+    },
+    "zh-CN": {
+        label: "语言",
+        system: "系统",
+        systemDescription: "使用浏览器语言",
+    },
+    "zh-TW": {
+        label: "語言",
+        system: "系統",
+        systemDescription: "使用瀏覽器語言",
+    },
+    "es-ES": {
+        label: "Idioma",
+        system: "Sistema",
+        systemDescription: "Usar el idioma del navegador",
+    },
+    "fr-FR": {
+        label: "Langue",
+        system: "Système",
+        systemDescription: "Utiliser la langue du navigateur",
+    },
+    "de-DE": {
+        label: "Sprache",
+        system: "System",
+        systemDescription: "Browsersprache verwenden",
+    },
+    "ja-JP": {
+        label: "言語",
+        system: "システム",
+        systemDescription: "ブラウザーの言語を使用",
+    },
+    "ko-KR": {
+        label: "언어",
+        system: "시스템",
+        systemDescription: "브라우저 언어 사용",
+    },
+    "pt-BR": {
+        label: "Idioma",
+        system: "Sistema",
+        systemDescription: "Usar o idioma do navegador",
+    },
+    "hi-IN": {
+        label: "भाषा",
+        system: "सिस्टम",
+        systemDescription: "ब्राउज़र की भाषा का उपयोग करें",
+    },
+    "ar-SA": {
+        label: "اللغة",
+        system: "النظام",
+        systemDescription: "استخدام لغة المتصفح",
+    },
+};
+function browserLanguageCandidates() {
+    if (typeof navigator === "undefined")
+        return [];
+    return navigator.languages?.length
+        ? [...navigator.languages]
+        : navigator.language
+            ? [navigator.language]
+            : [];
+}
+export function LanguagePicker({ className, includeSystem = true, label, variant = "select", }) {
+    const { locale, preference, setPreference, supportedLocales, localeMetadata, } = useLocale();
+    const [open, setOpen] = useState(false);
+    const copy = LANGUAGE_PICKER_COPY[locale] ?? LANGUAGE_PICKER_COPY[DEFAULT_LOCALE];
+    const systemCopy = LANGUAGE_PICKER_COPY[resolveLocaleFromCandidates(browserLanguageCandidates())] ?? LANGUAGE_PICKER_COPY[DEFAULT_LOCALE];
+    const resolvedLabel = label ?? copy.label;
+    const options = [
+        ...(includeSystem
+            ? [
+                {
+                    value: "system",
+                    label: systemCopy.system,
+                    description: systemCopy.systemDescription,
+                },
+            ]
+            : []),
+        ...supportedLocales.map((code) => ({
+            value: code,
+            label: localeDisplayName(code, localeMetadata),
+            description: code,
+        })),
+    ];
+    const selected = options.find((option) => option.value === preference);
+    const selectedLabel = selected?.label ?? preference;
+    const triggerLabel = `${resolvedLabel}: ${selectedLabel}`;
+    const customPicker = useDesignSystemComponent("Picker");
+    function handleOptionClick(value) {
+        setOpen(false);
+        void setPreference(normalizeLocalizationPreference(value).locale);
+    }
+    if (variant === "select" && customPicker) {
+        return (_jsx(Picker, { mode: "select", options: options, value: preference, onChange: (value) => {
+                if (value == null)
+                    return;
+                void setPreference(normalizeLocalizationPreference(value).locale);
+            }, placeholder: selectedLabel, "aria-label": triggerLabel, className: className }));
+    }
+    return (_jsx("div", { className: className, children: _jsxs(PopoverPrimitive.Root, { open: open, onOpenChange: setOpen, children: [_jsx(PopoverPrimitive.Trigger, { asChild: true, children: _jsxs("button", { type: "button", "aria-label": triggerLabel, title: triggerLabel, "data-language-picker-trigger": true, className: cn("shrink-0 rounded-md outline-none transition-colors focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2", variant === "ghost-icon"
+                            ? "flex h-9 w-9 items-center justify-center text-muted-foreground hover:bg-accent hover:text-foreground data-[state=open]:bg-accent data-[state=open]:text-foreground"
+                            : "border border-border bg-background text-foreground hover:border-foreground/30 hover:bg-accent/40 hover:text-foreground data-[state=open]:border-foreground/30 data-[state=open]:bg-accent/40", variant === "icon"
+                            ? "flex h-8 w-8 items-center justify-center"
+                            : variant === "select"
+                                ? "flex h-9 w-full items-center justify-between gap-2 px-3 text-start text-sm"
+                                : null), children: [_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [_jsx(IconLanguage, { className: "h-4 w-4 shrink-0 text-muted-foreground" }), variant === "select" ? (_jsx("span", { className: "truncate", children: selectedLabel })) : (_jsx("span", { className: "sr-only", children: triggerLabel }))] }), variant === "select" ? (_jsx(IconChevronDown, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground", "aria-hidden": "true" })) : null] }) }), _jsx(PopoverPrimitive.Portal, { children: _jsx(PopoverPrimitive.Content, { align: variant === "select" ? "start" : "end", sideOffset: 6, role: "menu", className: cn(
+                        // compositing-ok: popover content unmounts on close.
+                        "z-[9999] max-h-[min(20rem,var(--radix-popover-content-available-height))] overflow-y-auto rounded-lg border border-border bg-popover p-1 text-popover-foreground shadow-lg outline-none will-change-[transform,opacity] data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[state=closed]:duration-100 data-[state=open]:duration-150 data-[state=closed]:ease-in data-[state=open]:ease-out data-[side=bottom]:slide-in-from-top-1 data-[side=left]:slide-in-from-right-1 data-[side=right]:slide-in-from-left-1 data-[side=top]:slide-in-from-bottom-1", variant === "icon" || variant === "ghost-icon"
+                            ? "min-w-56"
+                            : "w-[min(20rem,calc(100vw-2rem))] min-w-[var(--radix-popover-trigger-width)]"), children: options.map((option) => {
+                            const optionSelected = option.value === preference;
+                            return (_jsxs("button", { type: "button", role: "menuitemradio", "aria-checked": optionSelected, title: option.description, onClick: () => handleOptionClick(option.value), className: cn("flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-start text-sm outline-none transition-colors hover:bg-accent/60 hover:text-foreground focus-visible:bg-accent/60 focus-visible:text-foreground", optionSelected
+                                    ? "bg-accent/40 text-foreground"
+                                    : "text-muted-foreground"), children: [_jsx(IconCheck, { className: cn("h-3.5 w-3.5 shrink-0", optionSelected ? "opacity-100" : "opacity-0"), "aria-hidden": "true" }), _jsx("span", { className: "truncate", children: option.label })] }, option.value));
+                        }) }) })] }) }));
+}

package/dist/client/analytics.d.ts

@@ -4,8 +4,9 @@ export { clearAnalyticsSessionId, setAnalyticsSessionId, } from "./analytics-ses
 import type { SessionReplayOptions, SessionReplayStartResult } from "./session-replay.js";
 export { scrubUrl } from "./url-scrub.js";
 export { addErrorBreadcrumb, captureException, captureMessage, isErrorCaptureInstalled, type CaptureExceptionContext, type CapturedExceptionEvent, type ExceptionBreadcrumb, type ExceptionLevel, } from "./error-capture.js";
-export type { SessionReplayConsoleOptions, SessionReplayNetworkOptions, SessionReplayOptions, SessionReplayStartResult, SessionReplayContext, SessionReplayLinkOptions, SessionReplayUrlMatcher, } from "./session-replay.js";
-export { getSessionReplayContext, getSessionReplayUrl, } from "./session-replay.js";
+export type { SessionReplayConsoleOptions, SessionReplayNetworkOptions, SessionReplayOptions, SessionReplayStartResult, SessionReplayUrlMatcher, } from "./session-replay.js";
+export { getSessionReplayContext, getSessionReplayUrl, } from "./session-replay-context.js";
+export type { SessionReplayContext, SessionReplayLinkOptions, } from "./session-replay-context.js";
 declare global {
     interface Window {
         gtag?: (...args: any[]) => void;

package/dist/client/analytics.js

@@ -17,7 +17,7 @@ import { isDynamicImportFailureMessage } from "./route-chunk-recovery.js";
 import { scrubUrl } from "./url-scrub.js";
 export { scrubUrl } from "./url-scrub.js";
 export { addErrorBreadcrumb, captureException, captureMessage, isErrorCaptureInstalled, } from "./error-capture.js";
-export { getSessionReplayContext, getSessionReplayUrl, } from "./session-replay.js";
+export { getSessionReplayContext, getSessionReplayUrl, } from "./session-replay-context.js";
 let _getDefaultProps = null;
 let _configuredAnalyticsClientPlatform = null;
 let _agentNativeAnalyticsPublicKey = null;

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

@@ -17,7 +17,7 @@
  *     <AppProviders
  *       queryClient={queryClient}
  *       isPublicPath={isPublicBookingPath(location.pathname)}
- *       clientOnlyFallback={<DefaultSpinner />}
+ *       clientOnlyFallback={<AppShellSkeleton />}
  *     >
  *       ...
  *     </AppProviders>
@@ -27,7 +27,7 @@
  *   default), `<ClientOnly>` hydrates the shared SSR shell and
  *   `<RequireSession>` redirects signed-out visitors to the framework sign-in
  *   page before private app chrome mounts. When `clientOnlyFallback` is
- *   omitted, `<DefaultSpinner />` is used.
+ *   omitted, `<AppShellSkeleton />` is used.
  *
  * Customisation props:
  *   themeAttribute           — passed to next-themes ThemeProvider `attribute`.
@@ -116,7 +116,7 @@ export interface AppProvidersProps {
     isPublicPath?: boolean;
     /**
      * Fallback rendered by `<ClientOnly>` while JS hydrates on private paths.
-     * Defaults to `<DefaultSpinner />`.
+     * Defaults to `<AppShellSkeleton />`.
      */
     clientOnlyFallback?: React.ReactNode;
     /**

package/dist/client/app-providers.js

@@ -18,7 +18,7 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  *     <AppProviders
  *       queryClient={queryClient}
  *       isPublicPath={isPublicBookingPath(location.pathname)}
- *       clientOnlyFallback={<DefaultSpinner />}
+ *       clientOnlyFallback={<AppShellSkeleton />}
  *     >
  *       ...
  *     </AppProviders>
@@ -28,7 +28,7 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
  *   default), `<ClientOnly>` hydrates the shared SSR shell and
  *   `<RequireSession>` redirects signed-out visitors to the framework sign-in
  *   page before private app chrome mounts. When `clientOnlyFallback` is
- *   omitted, `<DefaultSpinner />` is used.
+ *   omitted, `<AppShellSkeleton />` is used.
  *
  * Customisation props:
  *   themeAttribute           — passed to next-themes ThemeProvider `attribute`.
@@ -61,9 +61,10 @@ import { useEffect, useRef } from "react";
 import { useInRouterContext } from "react-router";
 import { isHumanReadableDocumentTitle, normalizeDocumentTitle, } from "../shared/document-title.js";
 import { getSsrBetaRedirectScriptBody } from "../shared/ssr-beta-redirect.js";
+import { getSsrSessionBootstrapScriptBody } from "../shared/ssr-session-bootstrap.js";
 import { agentNativePath, frameworkRoutePrefix } from "./api-path.js";
+import { AppShellSkeleton } from "./AppShellSkeleton.js";
 import { ClientOnly } from "./ClientOnly.js";
-import { DefaultSpinner } from "./DefaultSpinner.js";
 import { EnvironmentBadge } from "./EnvironmentBadge.js";
 import { AgentNativeI18nProvider, } from "./i18n.js";
 import { FirstRunOnboardingStartupGate } from "./onboarding/first-run-startup-gate.js";
@@ -74,19 +75,27 @@ import { RuntimeConfigNotice } from "./RuntimeConfigNotice.js";
 import { EMBEDDED_THEME_CHANGE_EVENT, applyEmbeddedThemeUpdate, parseEmbeddedThemeUpdate, } from "./theme.js";
 import { scheduleAfterPaint } from "./use-after-paint.js";
 import { useSession } from "./use-session.js";
-import { createAgentNativeServerActionWebMcpRegistration } from "./webmcp.js";
 const DEFAULT_TOASTER = (_jsx(Toaster, { richColors: true, position: "bottom-left", offset: { bottom: 44, left: 32 }, mobileOffset: { bottom: 44, left: 16 } }));
 function EarlyBetaRedirectScript() {
     return (_jsx("script", { "data-agent-native-beta-redirect": "1", dangerouslySetInnerHTML: {
             __html: getSsrBetaRedirectScriptBody(agentNativePath("/_agent-native/auth/session"), frameworkRoutePrefix()),
         } }));
 }
+function EarlySessionBootstrapScript() {
+    return (_jsx("script", { "data-agent-native-session-bootstrap": "1", dangerouslySetInnerHTML: {
+            __html: getSsrSessionBootstrapScriptBody(agentNativePath("/_agent-native/auth/session")),
+        } }));
+}
 function RoutedAppEnhancements() {
     const isInRouter = useInRouterContext();
     if (!isInRouter)
         return null;
     return (_jsxs(_Fragment, { children: [_jsx(AgentNativeRouteWarmup, {}), _jsx(RouteTransitionIndicator, {})] }));
 }
+let webMcpModulePromise = null;
+function loadWebMcpModule() {
+    return (webMcpModulePromise ??= import("./webmcp.js"));
+}
 function AgentNativeWebMcpRegistration({ excludeActionNames, }) {
     const excludeActionNamesKey = JSON.stringify(excludeActionNames ?? []);
     useEffect(() => {
@@ -95,16 +104,27 @@ function AgentNativeWebMcpRegistration({ excludeActionNames, }) {
         // paint-aligned window — only the cookie-session-gated variant defers.
         // Ownership is local to this effect: two coexisting surfaces each stop
         // only the registration they created.
-        const registration = createAgentNativeServerActionWebMcpRegistration({
-            excludeActionNames,
-        });
-        void registration.start().catch(() => {
-            // WebMCP is progressive enhancement. Session expiry or a transient
-            // manifest failure must not prevent the authenticated app from
-            // loading.
+        let disposed = false;
+        let registration = null;
+        void loadWebMcpModule()
+            .then(({ createAgentNativeServerActionWebMcpRegistration }) => {
+            if (disposed)
+                return;
+            registration = createAgentNativeServerActionWebMcpRegistration({
+                excludeActionNames,
+            });
+            void registration.start().catch(() => {
+                // WebMCP is progressive enhancement. Session expiry or a transient
+                // manifest failure must not prevent the authenticated app from
+                // loading.
+            });
+        })
+            .catch(() => {
+            // A failed optional WebMCP chunk must not delay the app shell.
         });
         return () => {
-            registration.stop();
+            disposed = true;
+            registration?.stop();
         };
     }, [excludeActionNamesKey]);
     return null;
@@ -139,19 +159,29 @@ function SessionGatedAgentNativeWebMcpRegistration({ excludeActionNames, }) {
         registrationRef.current?.stop();
         registrationRef.current = null;
         registrationExcludeActionNamesKeyRef.current = null;
+        let disposed = false;
         const cancel = scheduleAfterPaint(() => {
-            const registration = createAgentNativeServerActionWebMcpRegistration({
-                excludeActionNames,
-            });
-            void registration.start().catch(() => {
-                // WebMCP is progressive enhancement. Session expiry or a transient
-                // manifest failure must not prevent the authenticated app from
-                // loading.
+            void loadWebMcpModule()
+                .then(({ createAgentNativeServerActionWebMcpRegistration }) => {
+                if (disposed)
+                    return;
+                const registration = createAgentNativeServerActionWebMcpRegistration({
+                    excludeActionNames,
+                });
+                void registration.start().catch(() => {
+                    // WebMCP is progressive enhancement. Session expiry or a transient
+                    // manifest failure must not prevent the authenticated app from
+                    // loading.
+                });
+                registrationRef.current = registration;
+                registrationExcludeActionNamesKeyRef.current = excludeActionNamesKey;
+            })
+                .catch(() => {
+                // A failed optional WebMCP chunk must not delay the app shell.
             });
-            registrationRef.current = registration;
-            registrationExcludeActionNamesKeyRef.current = excludeActionNamesKey;
         });
         return () => {
+            disposed = true;
             cancel();
         };
         // Unmount stops exactly the registration this surface created, whether
@@ -256,11 +286,11 @@ function publicPathI18n(i18n) {
     return { ...(i18n ?? {}), persistPreference: false };
 }
 export function AppProviders({ queryClient, isPublicPath = false, clientOnlyFallback, sessionBypass = false, disableWebMcp = false, webMcpExcludeActionNames, showEnvironmentBadge = false, defaultTheme, themeAttribute, tooltipDelayDuration, toaster, disableThemeTransitions, i18n, documentTitleFallback, children, }) {
-    const fallback = clientOnlyFallback ?? _jsx(DefaultSpinner, {});
+    const fallback = clientOnlyFallback ?? _jsx(AppShellSkeleton, {});
     if (isPublicPath) {
         return (_jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, disableWebMcp: disableWebMcp, webMcpExcludeActionNames: webMcpExcludeActionNames, sessionBypass: sessionBypass, i18n: publicPathI18n(i18n), documentTitleFallback: documentTitleFallback, showProductionEnvironmentBadge: false, showEnvironmentBadge: showEnvironmentBadge, children: children }));
     }
     // Keep the bootstrap outside ClientOnly so the HTML parser can run it before
     // the authenticated client bundle starts.
-    return (_jsxs(_Fragment, { children: [!sessionBypass && _jsx(EarlyBetaRedirectScript, {}), _jsx(ClientOnly, { fallback: fallback, children: _jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, disableWebMcp: disableWebMcp, webMcpExcludeActionNames: webMcpExcludeActionNames, sessionBypass: sessionBypass, i18n: i18n, documentTitleFallback: documentTitleFallback, showProductionEnvironmentBadge: !sessionBypass, showEnvironmentBadge: showEnvironmentBadge, children: _jsx(RequireSession, { bypass: sessionBypass, fallback: fallback, children: sessionBypass ? (children) : (_jsx(FirstRunOnboardingStartupGate, { children: children })) }) }) })] }));
+    return (_jsxs(_Fragment, { children: [!sessionBypass && (_jsxs(_Fragment, { children: [_jsx(EarlySessionBootstrapScript, {}), _jsx(EarlyBetaRedirectScript, {})] })), _jsx(ClientOnly, { fallback: fallback, children: _jsx(ProvidersInner, { queryClient: queryClient, defaultTheme: defaultTheme, themeAttribute: themeAttribute, tooltipDelayDuration: tooltipDelayDuration, toaster: toaster, disableThemeTransitions: disableThemeTransitions, disableWebMcp: disableWebMcp, webMcpExcludeActionNames: webMcpExcludeActionNames, sessionBypass: sessionBypass, i18n: i18n, documentTitleFallback: documentTitleFallback, showProductionEnvironmentBadge: !sessionBypass, showEnvironmentBadge: showEnvironmentBadge, children: _jsx(RequireSession, { bypass: sessionBypass, fallback: fallback, children: sessionBypass ? (children) : (_jsx(FirstRunOnboardingStartupGate, { children: children })) }) }) })] }));
 }

package/dist/client/client-status-requests.d.ts

@@ -5,6 +5,11 @@ export type ClientStatusResult<T> = {
     state: "unavailable";
     status?: number;
 };
+declare global {
+    interface Window {
+        __agentNativeSessionBootstrap?: Promise<ClientStatusResult<unknown>>;
+    }
+}
 export declare function invalidateClientStatusRequest(path: string): void;
 export declare function invalidateClientStatusRequests(): void;
 export declare function fetchAgentEngineStatus<T = unknown>(): Promise<ClientStatusResult<T>>;

package/dist/client/client-status-requests.js

@@ -2,6 +2,7 @@ import { agentNativePath } from "./api-path.js";
 import { agentNativeApiDisabledReason } from "./api-surface.js";
 const RESULT_TTL_MS = 500;
 const REQUEST_TIMEOUT_MS = 15_000;
+const SESSION_STATUS_PATH = "/_agent-native/auth/session";
 const cache = new Map();
 const requests = new Map();
 const requestControllers = new Map();
@@ -56,23 +57,29 @@ async function fetchClientStatus(path) {
             resolve({ state: "unavailable" });
         }, REQUEST_TIMEOUT_MS);
     });
-    const transport = fetch(url, {
-        cache: "no-store",
-        credentials: "same-origin",
-        ...(controller ? { signal: controller.signal } : {}),
-    })
-        .then(async (response) => {
-        if (!response.ok) {
-            return { state: "unavailable", status: response.status };
-        }
-        try {
-            return { state: "available", value: await response.json() };
-        }
-        catch {
-            return { state: "unavailable", status: response.status };
-        }
-    })
-        .catch(() => ({ state: "unavailable" }));
+    const bootstrappedSession = path === SESSION_STATUS_PATH && typeof window !== "undefined"
+        ? window.__agentNativeSessionBootstrap
+        : undefined;
+    if (bootstrappedSession)
+        delete window.__agentNativeSessionBootstrap;
+    const transport = bootstrappedSession ??
+        fetch(url, {
+            cache: "no-store",
+            credentials: "same-origin",
+            ...(controller ? { signal: controller.signal } : {}),
+        })
+            .then(async (response) => {
+            if (!response.ok) {
+                return { state: "unavailable", status: response.status };
+            }
+            try {
+                return { state: "available", value: await response.json() };
+            }
+            catch {
+                return { state: "unavailable", status: response.status };
+            }
+        })
+            .catch(() => ({ state: "unavailable" }));
     const request = Promise.race([transport, timeout])
         .then((result) => {
         if (generation === requestGeneration &&
@@ -101,6 +108,9 @@ async function fetchClientStatus(path) {
 }
 export function invalidateClientStatusRequest(path) {
     const url = agentNativePath(path);
+    if (path === SESSION_STATUS_PATH && typeof window !== "undefined") {
+        delete window.__agentNativeSessionBootstrap;
+    }
     requestGenerations.set(url, (requestGenerations.get(url) ?? 0) + 1);
     cache.delete(url);
     requestControllers.get(url)?.abort();
@@ -109,6 +119,9 @@ export function invalidateClientStatusRequest(path) {
 }
 export function invalidateClientStatusRequests() {
     generation += 1;
+    if (typeof window !== "undefined") {
+        delete window.__agentNativeSessionBootstrap;
+    }
     cache.clear();
     for (const controller of requestControllers.values()) {
         controller.abort();
@@ -126,5 +139,5 @@ export function fetchBuilderStatus() {
     return fetchClientStatus("/_agent-native/builder/status");
 }
 export function fetchAuthSessionStatus() {
-    return fetchClientStatus("/_agent-native/auth/session");
+    return fetchClientStatus(SESSION_STATUS_PATH);
 }

package/dist/client/i18n.d.ts

@@ -2,6 +2,7 @@ import React from "react";
 import { type LocaleCode, type LocaleMetadata, type LocaleMetadataMap, type LocalePreference, type LocalizationPreference } from "../localization/shared.js";
 export { DEFAULT_LOCALE, LOCALE_HYDRATION_GLOBAL, LOCALE_METADATA, LOCALE_STORAGE_KEY, SUPPORTED_LOCALES, isLocaleCode, isValidLocaleCode, localeDirection, localeMetadataFor, type BuiltinLocaleCode, normalizeLocaleCode, normalizeLocalePreference, normalizeLocalizationPreference, resolveLocaleFromCandidates, resolveLocaleFromPreference, type LocaleCode, type LocaleMetadata, type LocalePreference, type LocalizationPreference, } from "../localization/shared.js";
 export { getLocaleInitScript } from "../localization/server.js";
+export { LanguagePicker } from "./LanguagePicker.js";
 export type LocaleMessages = Record<string, unknown>;
 export type AgentNativeI18nLocaleLoader = () => Promise<LocaleMessages | {
     default: LocaleMessages;
@@ -76,9 +77,3 @@ export declare function useFormatters(): {
     formatRelativeTime(value: number, unit: Intl.RelativeTimeFormatUnit, options?: Intl.RelativeTimeFormatOptions): string;
     formatList(value: string[], options?: Intl.ListFormatOptions): string;
 };
-export declare function LanguagePicker({ className, includeSystem, label, variant, }: {
-    className?: string;
-    includeSystem?: boolean;
-    label?: string;
-    variant?: "select" | "icon" | "ghost-icon";
-}): React.JSX.Element;

package/dist/client/i18n.js

@@ -1,20 +1,17 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Picker, useDesignSystemComponent, } from "@agent-native/toolkit/design-system";
-import * as PopoverPrimitive from "@radix-ui/react-popover";
-import { IconCheck, IconChevronDown, IconLanguage } from "@tabler/icons-react";
+import { jsx as _jsx } from "react/jsx-runtime";
 import i18next from "i18next";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, } from "react";
 import { I18nextProvider, initReactI18next, useTranslation, } from "react-i18next";
 import { coreMessagesForLocale, englishAgentChatMessages, loadCoreMessagesForLocale, normalizeCoreMessageOverrides, } from "../localization/core-messages.js";
 import defaultEnglishMessages from "../localization/default-messages.js";
-import { DEFAULT_LOCALE, LOCALE_HYDRATION_GLOBAL, LOCALE_STORAGE_KEY, SUPPORTED_LOCALES, isValidLocaleCode, localeDisplayName, localeDirection, localeMetadataFor, normalizeLocaleCode, normalizeLocalizationPreference, resolveLocaleFromCandidates, resolveLocaleFromPreference, } from "../localization/shared.js";
+import { DEFAULT_LOCALE, LOCALE_HYDRATION_GLOBAL, LOCALE_STORAGE_KEY, SUPPORTED_LOCALES, isValidLocaleCode, localeDirection, localeMetadataFor, normalizeLocaleCode, normalizeLocalizationPreference, resolveLocaleFromCandidates, resolveLocaleFromPreference, } from "../localization/shared.js";
 import { injectedAgentNativeConfig } from "./app-config.js";
 import { setClientAppState } from "./application-state.js";
 import { callAction } from "./use-action.js";
 import { useSession } from "./use-session.js";
-import { cn } from "./utils.js";
 export { DEFAULT_LOCALE, LOCALE_HYDRATION_GLOBAL, LOCALE_METADATA, LOCALE_STORAGE_KEY, SUPPORTED_LOCALES, isLocaleCode, isValidLocaleCode, localeDirection, localeMetadataFor, normalizeLocaleCode, normalizeLocalePreference, normalizeLocalizationPreference, resolveLocaleFromCandidates, resolveLocaleFromPreference, } from "../localization/shared.js";
 export { getLocaleInitScript } from "../localization/server.js";
+export { LanguagePicker } from "./LanguagePicker.js";
 function isAgentNativeI18nModuleNamespace(value) {
     return Object.prototype.toString.call(value) === "[object Module]";
 }
@@ -48,63 +45,6 @@ function catalogLocaleMetadata(locales) {
 const LocaleContext = globalThis.__AGENT_NATIVE_LOCALE_CONTEXT__ ??
     (globalThis.__AGENT_NATIVE_LOCALE_CONTEXT__ =
         createContext(null));
-const LANGUAGE_PICKER_COPY = {
-    "en-US": {
-        label: "Language",
-        system: "System",
-        systemDescription: "Use your browser language",
-    },
-    "zh-CN": {
-        label: "语言",
-        system: "系统",
-        systemDescription: "使用浏览器语言",
-    },
-    "zh-TW": {
-        label: "語言",
-        system: "系統",
-        systemDescription: "使用瀏覽器語言",
-    },
-    "es-ES": {
-        label: "Idioma",
-        system: "Sistema",
-        systemDescription: "Usar el idioma del navegador",
-    },
-    "fr-FR": {
-        label: "Langue",
-        system: "Système",
-        systemDescription: "Utiliser la langue du navigateur",
-    },
-    "de-DE": {
-        label: "Sprache",
-        system: "System",
-        systemDescription: "Browsersprache verwenden",
-    },
-    "ja-JP": {
-        label: "言語",
-        system: "システム",
-        systemDescription: "ブラウザーの言語を使用",
-    },
-    "ko-KR": {
-        label: "언어",
-        system: "시스템",
-        systemDescription: "브라우저 언어 사용",
-    },
-    "pt-BR": {
-        label: "Idioma",
-        system: "Sistema",
-        systemDescription: "Usar o idioma do navegador",
-    },
-    "hi-IN": {
-        label: "भाषा",
-        system: "सिस्टम",
-        systemDescription: "ब्राउज़र की भाषा का उपयोग करें",
-    },
-    "ar-SA": {
-        label: "اللغة",
-        system: "النظام",
-        systemDescription: "استخدام لغة المتصفح",
-    },
-};
 function browserLanguageCandidates() {
     if (typeof navigator === "undefined")
         return [];
@@ -665,57 +605,3 @@ export function useFormatters() {
         },
     }), [locale]);
 }
-export function LanguagePicker({ className, includeSystem = true, label, variant = "select", }) {
-    const { locale, preference, setPreference, supportedLocales, localeMetadata, } = useLocale();
-    const [open, setOpen] = useState(false);
-    const copy = LANGUAGE_PICKER_COPY[locale] ?? LANGUAGE_PICKER_COPY[DEFAULT_LOCALE];
-    const systemCopy = LANGUAGE_PICKER_COPY[resolveLocaleFromCandidates(browserLanguageCandidates())] ?? LANGUAGE_PICKER_COPY[DEFAULT_LOCALE];
-    const resolvedLabel = label ?? copy.label;
-    const options = [
-        ...(includeSystem
-            ? [
-                {
-                    value: "system",
-                    label: systemCopy.system,
-                    description: systemCopy.systemDescription,
-                },
-            ]
-            : []),
-        ...supportedLocales.map((code) => ({
-            value: code,
-            label: localeDisplayName(code, localeMetadata),
-            description: code,
-        })),
-    ];
-    const selected = options.find((option) => option.value === preference);
-    const selectedLabel = selected?.label ?? preference;
-    const triggerLabel = `${resolvedLabel}: ${selectedLabel}`;
-    const customPicker = useDesignSystemComponent("Picker");
-    function handleOptionClick(value) {
-        setOpen(false);
-        void setPreference(normalizeLocalizationPreference(value).locale);
-    }
-    if (variant === "select" && customPicker) {
-        return (_jsx(Picker, { mode: "select", options: options, value: preference, onChange: (value) => {
-                if (value == null)
-                    return;
-                void setPreference(normalizeLocalizationPreference(value).locale);
-            }, placeholder: selectedLabel, "aria-label": triggerLabel, className: className }));
-    }
-    return (_jsx("div", { className: className, children: _jsxs(PopoverPrimitive.Root, { open: open, onOpenChange: setOpen, children: [_jsx(PopoverPrimitive.Trigger, { asChild: true, children: _jsxs("button", { type: "button", "aria-label": triggerLabel, title: triggerLabel, "data-language-picker-trigger": true, className: cn("shrink-0 rounded-md outline-none transition-colors focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2", variant === "ghost-icon"
-                            ? "flex h-9 w-9 items-center justify-center text-muted-foreground hover:bg-accent hover:text-foreground data-[state=open]:bg-accent data-[state=open]:text-foreground"
-                            : "border border-border bg-background text-foreground hover:border-foreground/30 hover:bg-accent/40 hover:text-foreground data-[state=open]:border-foreground/30 data-[state=open]:bg-accent/40", variant === "icon"
-                            ? "flex h-8 w-8 items-center justify-center"
-                            : variant === "select"
-                                ? "flex h-9 w-full items-center justify-between gap-2 px-3 text-start text-sm"
-                                : null), children: [_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [_jsx(IconLanguage, { className: "h-4 w-4 shrink-0 text-muted-foreground" }), variant === "select" ? (_jsx("span", { className: "truncate", children: selectedLabel })) : (_jsx("span", { className: "sr-only", children: triggerLabel }))] }), variant === "select" ? (_jsx(IconChevronDown, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground", "aria-hidden": "true" })) : null] }) }), _jsx(PopoverPrimitive.Portal, { children: _jsx(PopoverPrimitive.Content, { align: variant === "select" ? "start" : "end", sideOffset: 6, role: "menu", className: cn(
-                        // compositing-ok: popover content unmounts on close.
-                        "z-[9999] max-h-[min(20rem,var(--radix-popover-content-available-height))] overflow-y-auto rounded-lg border border-border bg-popover p-1 text-popover-foreground shadow-lg outline-none will-change-[transform,opacity] data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[state=closed]:duration-100 data-[state=open]:duration-150 data-[state=closed]:ease-in data-[state=open]:ease-out data-[side=bottom]:slide-in-from-top-1 data-[side=left]:slide-in-from-right-1 data-[side=right]:slide-in-from-left-1 data-[side=top]:slide-in-from-bottom-1", variant === "icon" || variant === "ghost-icon"
-                            ? "min-w-56"
-                            : "w-[min(20rem,calc(100vw-2rem))] min-w-[var(--radix-popover-trigger-width)]"), children: options.map((option) => {
-                            const optionSelected = option.value === preference;
-                            return (_jsxs("button", { type: "button", role: "menuitemradio", "aria-checked": optionSelected, title: option.description, onClick: () => handleOptionClick(option.value), className: cn("flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-start text-sm outline-none transition-colors hover:bg-accent/60 hover:text-foreground focus-visible:bg-accent/60 focus-visible:text-foreground", optionSelected
-                                    ? "bg-accent/40 text-foreground"
-                                    : "text-muted-foreground"), children: [_jsx(IconCheck, { className: cn("h-3.5 w-3.5 shrink-0", optionSelected ? "opacity-100" : "opacity-0"), "aria-hidden": "true" }), _jsx("span", { className: "truncate", children: option.label })] }, option.value));
-                        }) }) })] }) }));
-}

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

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Suspense, createContext, lazy, useContext, useEffect, useState, } from "react";
-import { DefaultSpinner } from "../DefaultSpinner.js";
+import { FIRST_RUN_ONBOARDING_COOKIE } from "../../shared/first-run-onboarding.js";
+import { AppShellSkeleton } from "../AppShellSkeleton.js";
 import { isFirstRunOnboardingEnabled } from "./first-run-enabled.js";
 import { fetchFirstRunOnboardingStatus } from "./first-run-status.js";
 import { trackOnboardingEvent } from "./use-onboarding.js";
@@ -9,12 +10,22 @@ const FirstRunOnboarding = lazy(() => import("./FirstRunOnboarding.js").then((mo
     default: module.FirstRunOnboarding,
 })));
 const FirstRunOnboardingGateContext = createContext(false);
+function hasFirstRunOnboardingCookie() {
+    if (typeof document === "undefined")
+        return true;
+    const prefix = `${FIRST_RUN_ONBOARDING_COOKIE}=`;
+    return document.cookie.split(";").some((cookie) => {
+        const entry = cookie.trim();
+        return entry.startsWith(prefix) && entry.slice(prefix.length) === "1";
+    });
+}
 export function useFirstRunOnboardingGateOwnsSurface() {
     return useContext(FirstRunOnboardingGateContext);
 }
 export function FirstRunOnboardingStartupGate({ children, }) {
     const previewMode = useOnboardingPreviewMode();
-    const shouldResolve = isFirstRunOnboardingEnabled() && !previewMode;
+    const [hadFirstRunCookie] = useState(hasFirstRunOnboardingCookie);
+    const shouldResolve = isFirstRunOnboardingEnabled() && !previewMode && hadFirstRunCookie;
     const [decision, setDecision] = useState(shouldResolve ? "pending" : "ineligible");
     useEffect(() => {
         if (!shouldResolve) {
@@ -55,5 +66,5 @@ export function FirstRunOnboardingStartupGate({ children, }) {
     return (_jsxs(FirstRunOnboardingGateContext.Provider, { value: ownsSurface, children: [app, decision === "pending" && _jsx(FirstRunOnboardingStartupLoading, {}), ownsSurface && (_jsx(Suspense, { fallback: _jsx(FirstRunOnboardingStartupLoading, {}), children: _jsx(FirstRunOnboarding, { initialFirstRun: true }) }))] }));
 }
 function FirstRunOnboardingStartupLoading() {
-    return (_jsx("div", { "data-first-run-startup-loading": "true", "aria-busy": "true", className: "fixed inset-0 z-[110] bg-background", children: _jsx(DefaultSpinner, {}) }));
+    return (_jsx("div", { "data-first-run-startup-loading": "true", "aria-busy": "true", className: "fixed inset-0 z-[110] bg-background", children: _jsx(AppShellSkeleton, {}) }));
 }

package/dist/client/require-session.d.ts

@@ -32,7 +32,7 @@ export interface RequireSessionProps {
     children: React.ReactNode;
     /**
      * Rendered while the session is being resolved and while a redirect is in
-     * flight. Defaults to the framework `<DefaultSpinner />`.
+     * flight. Defaults to the framework `<AppShellSkeleton />`.
      */
     fallback?: React.ReactNode;
     /**