@agent-native/core 0.193.0 → 0.193.1-nightly-20260926224948

package/dist/client/onboarding/FirstRunOnboarding.js

@@ -1,5 +1,6 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Badge } from "@agent-native/toolkit/ui/badge";
+import { Button } from "@agent-native/toolkit/ui/button";
 import { Skeleton } from "@agent-native/toolkit/ui/skeleton";
 import { IconArrowRight, IconCheck, IconInfoCircle, IconKey, IconLoader2, IconX, } from "@tabler/icons-react";
 import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
@@ -10,6 +11,7 @@ import { Tooltip, TooltipContent, TooltipTrigger, } from "../components/ui/toolt
 import { useT } from "../i18n.js";
 import { useBuilderConnectFlow } from "../settings/useBuilderStatus.js";
 import { cn } from "../utils.js";
+import { resolveFirstRunOnboardingMode } from "./first-run-enabled.js";
 import { listFirstRunOnboardingExtensions } from "./first-run-registry.js";
 import { saveFirstRunOnboardingRole } from "./first-run-status.js";
 import { trackOnboardingEvent, useOnboarding } from "./use-onboarding.js";
@@ -70,6 +72,7 @@ const BUILDER_MORE_SERVICES = [
 ];
 export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
     const t = useT();
+    const connectFirstRun = resolveFirstRunOnboardingMode() === "connect";
     const { pathname } = useLocation();
     const previewMode = useOnboardingPreviewMode();
     const previewStep = useOnboardingPreviewStep();
@@ -108,17 +111,27 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
     const completionInFlightRef = useRef(false);
     const onboardingTerminalRef = useRef(false);
     const abandonmentTrackedRef = useRef(false);
-    const setupAttemptRef = useRef(null);
     const builderSetupAttemptRef = useRef(null);
+    const pendingHandoffFailureRef = useRef(null);
+    const flushPendingHandoffFailure = useCallback(() => {
+        const attempt = pendingHandoffFailureRef.current;
+        if (!attempt)
+            return;
+        pendingHandoffFailureRef.current = null;
+        trackFirstRunSetupOutcome(attempt, "handoff_failed", "onboarding_completion_error");
+    }, []);
     const startSetupMethod = useCallback((methodId, methodKind) => {
         if (previewMode || typeof window === "undefined")
             return null;
+        flushPendingHandoffFailure();
         const attempt = {
             id: window.crypto.randomUUID(),
             methodId,
             outcomeTracked: false,
         };
-        setupAttemptRef.current = attempt;
+        if (methodKind !== "builder") {
+            pendingHandoffFailureRef.current = attempt;
+        }
         const properties = {
             flow: "first_run",
             step_id: "choice",
@@ -129,20 +142,23 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
         trackOnboardingEvent("onboarding_method_clicked", properties);
         trackOnboardingEvent("onboarding_method_started", properties);
         return attempt;
-    }, [previewMode]);
-    const finishOnboarding = useCallback(async (completedScreen, completedExtensionIndex = extensionIndex) => {
-        completionAttemptRef.current = completedScreen
-            ? { screen: completedScreen, extensionIndex: completedExtensionIndex }
-            : { screen: null, extensionIndex: completedExtensionIndex };
+    }, [flushPendingHandoffFailure, previewMode]);
+    const finishOnboarding = useCallback(async (completedScreen, completedExtensionIndex = extensionIndex, onSuccess) => {
+        completionAttemptRef.current = {
+            screen: completedScreen,
+            extensionIndex: completedExtensionIndex,
+            ...(onSuccess ? { onSuccess } : {}),
+        };
         completionInFlightRef.current = true;
+        let onSuccessAfterCompletion;
         try {
             await completeFirstRun();
             if (completedScreen) {
                 trackFirstRunStepCompleted(completedScreen, completedExtensionIndex);
             }
             onboardingTerminalRef.current = true;
+            onSuccessAfterCompletion = completionAttemptRef.current?.onSuccess;
             completionAttemptRef.current = null;
-            return true;
         }
         catch {
             // coercion-ok: completeFirstRun exposes this failure as the inline retry state.
@@ -151,6 +167,8 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
         finally {
             completionInFlightRef.current = false;
         }
+        onSuccessAfterCompletion?.();
+        return true;
     }, [completeFirstRun, extensionIndex, trackFirstRunStepCompleted]);
     useEffect(() => {
         if (!previewMode && firstRun && !loading && profile) {
@@ -182,6 +200,7 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
                 completionInFlightRef.current)
                 return;
             abandonmentTrackedRef.current = true;
+            flushPendingHandoffFailure();
             trackOnboardingEvent("onboarding_abandoned", {
                 ...firstRunStepProperties(screen, extensions, extensionIndex),
                 reason: "page_exit",
@@ -197,6 +216,7 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
         previewMode,
         profile,
         screen,
+        flushPendingHandoffFailure,
     ]);
     const handleFinish = useCallback((completedScreen, track = true) => {
         if (extensions.length === 0) {
@@ -211,7 +231,6 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
     const handleBuilderConnected = useCallback(() => {
         trackFirstRunSetupOutcome(builderSetupAttemptRef.current, "connected");
         builderSetupAttemptRef.current = null;
-        setupAttemptRef.current = null;
         trackFirstRunStepCompleted("choice");
         trackFirstRunStepCompleted("connecting");
         handleFinish(null);
@@ -238,7 +257,7 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
     const canActivateBuilderFreeCredits = connectFlow.agentNativeProvisioningEnabled;
     const retryOnboardingCompletion = useCallback(() => {
         const attempt = completionAttemptRef.current;
-        void finishOnboarding(attempt?.screen ?? null, attempt?.extensionIndex ?? extensionIndex);
+        void finishOnboarding(attempt?.screen ?? null, attempt?.extensionIndex ?? extensionIndex, attempt?.onSuccess);
     }, [extensionIndex, finishOnboarding]);
     const completionErrorProps = {
         completionError: completeFirstRunError,
@@ -263,7 +282,6 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
         if (connectFlow.hasFetchedStatus && connectFlow.configured) {
             trackFirstRunSetupOutcome(attempt, "already_connected");
             builderSetupAttemptRef.current = null;
-            setupAttemptRef.current = null;
             trackFirstRunStepCompleted("choice");
             handleFinish(null);
             return;
@@ -278,16 +296,7 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
             provisionAccount,
         });
     };
-    const handleOpenSettings = async () => {
-        if (completionInFlightRef.current)
-            return;
-        const attempt = startSetupMethod("custom_keys", "manual");
-        const completed = await finishOnboarding("choice");
-        if (!completed) {
-            trackFirstRunSetupOutcome(attempt, "handoff_failed", "onboarding_completion_error");
-            return;
-        }
-        trackFirstRunSetupOutcome(attempt, "settings_opened");
+    const navigateToKeySettings = () => {
         if (typeof window === "undefined")
             return;
         // Drop the onboarding preview params — useOnboardingPreviewMode() reads
@@ -300,6 +309,31 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
         window.history.pushState(null, "", `${appMountedPath(buildSettingsRoute("keys"), pathname || STANDARD_APP_ROUTES.home)}${query ? `?${query}` : ""}`);
         window.dispatchEvent(new Event("popstate"));
     };
+    const handleOpenSettings = async () => {
+        if (completionInFlightRef.current)
+            return;
+        const attempt = startSetupMethod("custom_keys", "manual");
+        await finishOnboarding("choice", extensionIndex, () => {
+            if (pendingHandoffFailureRef.current === attempt) {
+                pendingHandoffFailureRef.current = null;
+            }
+            trackFirstRunSetupOutcome(attempt, "settings_opened");
+            navigateToKeySettings();
+        });
+    };
+    const handleSkipToApp = async () => {
+        if (completionInFlightRef.current)
+            return;
+        const attempt = startSetupMethod("skip_to_app", "skip");
+        await finishOnboarding(null, extensionIndex, () => {
+            if (pendingHandoffFailureRef.current === attempt) {
+                pendingHandoffFailureRef.current = null;
+            }
+            trackFirstRunStepSkipped("choice", "skip_to_app");
+            trackFirstRunSetupOutcome(attempt, "skipped_to_app");
+        });
+    };
+    const builderStatusPending = !previewMode && !connectFlow.statusResolved;
     const handleRoleContinue = async () => {
         const roleToSave = selectedRole === "other" ? customRole.trim() : selectedRole;
         if (!roleToSave || savingRole)
@@ -348,6 +382,9 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
                     void finishOnboarding(null);
                 } }) }));
     }
+    if (screen === "choice" && connectFirstRun) {
+        return (_jsx(OnboardingShell, { profile: profile, screen: "choice", ...completionErrorProps, children: _jsxs("div", { className: "mx-auto flex w-full max-w-md flex-col items-center gap-6", children: [_jsx("h1", { className: "text-xl font-semibold tracking-[-0.03em] text-foreground", children: t("agentChat.setup.connectBuilder") }), _jsxs("div", { className: "flex w-full flex-col items-center gap-3", children: [_jsxs(Button, { type: "button", "data-testid": "first-run-builder-continue", className: cn(primaryButtonClass, "w-full"), onClick: () => handleBuilder(canActivateBuilderFreeCredits), disabled: builderStatusPending || connectFlow.connecting, children: [t("agentChat.common.continue"), builderStatusPending || connectFlow.connecting ? (_jsx(IconLoader2, { size: 15, className: "animate-spin" })) : (_jsx(IconArrowRight, { size: 15 }))] }), _jsxs("p", { className: "text-center text-xs leading-5 text-muted-foreground", children: [t("agentChat.onboarding.builderConsentPrefix"), " ", _jsx("a", { href: "https://www.builder.io/legal/terms", target: "_blank", rel: "noreferrer", className: "text-foreground underline decoration-border underline-offset-2 hover:decoration-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: t("agentChat.onboarding.builderTerms") }), " ", t("agentChat.onboarding.builderConsentAnd"), " ", _jsx("a", { href: "https://www.builder.io/legal/privacy", target: "_blank", rel: "noreferrer", className: "text-foreground underline decoration-border underline-offset-2 hover:decoration-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: t("agentChat.onboarding.builderPrivacy") }), "."] })] }), connectFlow.error && !connectFlow.statusResolved && !previewMode && (_jsxs("div", { className: "flex flex-col items-center gap-2", children: [_jsx("p", { role: "status", "data-testid": "first-run-builder-status-error", className: "text-center text-xs text-destructive", children: t("agentChat.setup.providerStatusUnavailable") }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", className: "min-h-8 rounded-lg px-2.5 text-xs font-medium text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: () => connectFlow.retry(), children: t("agentChat.common.retry") })] })), _jsxs("div", { className: "flex flex-col items-center gap-2", children: [_jsx(Button, { type: "button", variant: "ghost", size: "sm", "data-testid": "first-run-open-key-settings", className: "min-h-9 rounded-lg px-2.5 text-sm font-medium text-muted-foreground underline underline-offset-4 transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: () => void handleOpenSettings(), children: t("agentChat.onboarding.useOwnApiKeys") }), _jsx(Button, { type: "button", variant: "ghost", size: "sm", "data-testid": "first-run-skip-to-app", className: "min-h-8 rounded-lg px-2.5 text-xs font-medium text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: () => void handleSkipToApp(), children: t("agentChat.onboarding.skipForNow") })] })] }) }));
+    }
     if (screen === "choice") {
         return (_jsx(OnboardingShell, { profile: profile, screen: "choice", ...completionErrorProps, children: _jsxs("div", { className: "mx-auto flex w-full max-w-3xl flex-col gap-9", children: [_jsxs("div", { className: "flex flex-col gap-6", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx("h1", { className: "text-[28px] font-bold leading-tight tracking-[-0.02em] text-foreground", children: "Choose your setup" }), _jsx("p", { className: "text-sm text-muted-foreground", children: "We recommend starting with Builder.io for the fastest setup." })] }), _jsxs("div", { className: "grid gap-6 sm:grid-cols-2", children: [_jsxs("section", { className: "flex flex-col gap-5 rounded-2xl border border-border bg-card p-6", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("h2", { className: "text-lg font-bold text-foreground", children: "Use Builder.io" }), _jsx(Badge, { variant: "secondary", className: "font-medium", children: "Recommended" })] }), _jsx("p", { className: "text-sm text-muted-foreground", children: "Configure using Builder.io and use your account credits to power the app\u2019s services." })] }), _jsxs("div", { className: "flex flex-col gap-1 rounded-[10px] bg-emerald-50 px-4 py-3 dark:bg-emerald-950/30", children: [_jsx("p", { className: "text-[13px] font-semibold text-foreground", children: "Included free with a Builder.io account" }), _jsx("p", { className: "text-xs font-medium text-emerald-700 dark:text-emerald-400", children: "60 monthly Agent Credits" })] }), _jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("p", { className: "text-sm text-muted-foreground/70", children: "What\u2019s included" }), builderCapabilities.map((capability) => {
                                                         const copy = getCapabilityCopy(t, capability);
@@ -355,7 +392,7 @@ export function FirstRunOnboarding({ initialFirstRun = false, } = {}) {
                                                                         defaultValue: "About {{label}}",
                                                                         label: copy.label,
                                                                     }) }))] }, capability.id));
-                                                    }), BUILDER_MORE_SERVICES.filter((service) => !builderCapabilities.some((capability) => getCapabilityCopy(t, capability).label.toLowerCase() === service.toLowerCase())).map((service) => (_jsxs("div", { className: "flex items-center gap-2 rounded-md px-2 py-1", children: [_jsx(IconCheck, { className: "shrink-0 text-muted-foreground", size: 15 }), _jsx("span", { className: "text-xs text-foreground", children: service })] }, service)))] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx("button", { type: "button", "data-testid": "first-run-builder-create-account", className: cn(primaryButtonClass, "w-full"), onClick: () => handleBuilder(true), disabled: connectFlow.connecting, children: t("agentChat.onboarding.builderCreateAccount") }), _jsx("button", { type: "button", "data-testid": "first-run-builder-sign-in", className: cn(mutedButtonClass, "w-full"), onClick: () => handleBuilder(false), disabled: connectFlow.connecting, children: t("agentChat.onboarding.builderSignInWithAccount") })] }), connectFlow.error && !connectFlow.statusResolved && (_jsx("p", { role: "status", "data-testid": "first-run-builder-status-error", className: "text-center text-xs text-destructive", children: connectFlow.error }))] }), _jsxs("section", { className: "flex flex-col gap-5 rounded-2xl border border-border bg-card p-6", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx("h2", { className: "text-lg font-bold text-foreground", children: "Configure manually" }), _jsx("p", { className: "text-sm text-muted-foreground", children: "Configure your own API keys and credentials to power the app\u2019s services." })] }), _jsxs("div", { className: "flex flex-col gap-1 rounded-xl bg-muted px-4 py-3", children: [_jsx("p", { className: "text-[13px] font-semibold text-foreground", children: "You configure and maintain everything" }), _jsx("p", { className: "text-xs text-muted-foreground", children: "Full control over your infrastructure" })] }), _jsx(CapabilityList, { capabilities: profile.capabilities, className: "flex-1" }), _jsx("button", { type: "button", "data-testid": "first-run-open-key-settings", className: cn(secondaryButtonClass, "w-full"), onClick: () => void handleOpenSettings(), children: "Skip and configure manually" })] })] })] }), _jsxs("p", { className: "text-center text-xs leading-5 text-muted-foreground", children: [t("agentChat.onboarding.builderConsentPrefix"), " ", _jsx("a", { href: "https://www.builder.io/legal/terms", target: "_blank", rel: "noreferrer", className: "text-foreground underline decoration-border underline-offset-2 hover:decoration-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: t("agentChat.onboarding.builderTerms") }), " ", t("agentChat.onboarding.builderConsentAnd"), " ", _jsx("a", { href: "https://www.builder.io/legal/privacy", target: "_blank", rel: "noreferrer", className: "text-foreground underline decoration-border underline-offset-2 hover:decoration-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: t("agentChat.onboarding.builderPrivacy") }), "."] })] }) }));
+                                                    }), BUILDER_MORE_SERVICES.filter((service) => !builderCapabilities.some((capability) => getCapabilityCopy(t, capability).label.toLowerCase() === service.toLowerCase())).map((service) => (_jsxs("div", { className: "flex items-center gap-2 rounded-md px-2 py-1", children: [_jsx(IconCheck, { className: "shrink-0 text-muted-foreground", size: 15 }), _jsx("span", { className: "text-xs text-foreground", children: service })] }, service)))] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx("button", { type: "button", "data-testid": "first-run-builder-create-account", className: cn(primaryButtonClass, "w-full"), onClick: () => handleBuilder(true), disabled: connectFlow.connecting, children: t("agentChat.onboarding.builderCreateAccount") }), _jsx("button", { type: "button", "data-testid": "first-run-builder-sign-in", className: cn(mutedButtonClass, "w-full"), onClick: () => handleBuilder(false), disabled: connectFlow.connecting, children: t("agentChat.onboarding.builderSignInWithAccount") })] }), connectFlow.error && !connectFlow.statusResolved && (_jsx("p", { role: "status", "data-testid": "first-run-builder-status-error", className: "text-center text-xs text-destructive", children: t("agentChat.setup.providerStatusUnavailable") }))] }), _jsxs("section", { className: "flex flex-col gap-5 rounded-2xl border border-border bg-card p-6", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx("h2", { className: "text-lg font-bold text-foreground", children: "Configure manually" }), _jsx("p", { className: "text-sm text-muted-foreground", children: "Configure your own API keys and credentials to power the app\u2019s services." })] }), _jsxs("div", { className: "flex flex-col gap-1 rounded-xl bg-muted px-4 py-3", children: [_jsx("p", { className: "text-[13px] font-semibold text-foreground", children: "You configure and maintain everything" }), _jsx("p", { className: "text-xs text-muted-foreground", children: "Full control over your infrastructure" })] }), _jsx(CapabilityList, { capabilities: profile.capabilities, className: "flex-1" }), _jsx("button", { type: "button", "data-testid": "first-run-open-key-settings", className: cn(secondaryButtonClass, "w-full"), onClick: () => void handleOpenSettings(), children: "Skip and configure manually" })] })] })] }), _jsxs("p", { className: "text-center text-xs leading-5 text-muted-foreground", children: [t("agentChat.onboarding.builderConsentPrefix"), " ", _jsx("a", { href: "https://www.builder.io/legal/terms", target: "_blank", rel: "noreferrer", className: "text-foreground underline decoration-border underline-offset-2 hover:decoration-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: t("agentChat.onboarding.builderTerms") }), " ", t("agentChat.onboarding.builderConsentAnd"), " ", _jsx("a", { href: "https://www.builder.io/legal/privacy", target: "_blank", rel: "noreferrer", className: "text-foreground underline decoration-border underline-offset-2 hover:decoration-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: t("agentChat.onboarding.builderPrivacy") }), "."] })] }) }));
     }
     if (screen === "role") {
         return (_jsx(OnboardingShell, { profile: profile, screen: "role", ...completionErrorProps, children: _jsxs("div", { className: "mx-auto flex w-full max-w-2xl flex-col", "data-testid": "first-run-role", children: [_jsxs("div", { className: "flex flex-col gap-2 pt-2", children: [_jsx("h1", { className: "text-[28px] font-bold leading-tight tracking-[-0.02em] text-foreground", children: t("agentChat.onboarding.roleQuestion") }), _jsx("p", { className: "text-sm text-muted-foreground", children: t("agentChat.onboarding.roleHelperText") })] }), _jsxs("fieldset", { className: "mt-7 flex flex-col gap-3", children: [_jsx("legend", { className: "sr-only", children: t("agentChat.onboarding.chooseRole") }), FIRST_RUN_ROLE_OPTIONS.map(({ value, labelKey }) => (_jsxs("label", { "data-testid": `first-run-role-${value}`, className: cn("flex cursor-pointer items-center gap-3 rounded-lg border border-border bg-card p-3 text-sm transition-colors focus-within:ring-2 focus-within:ring-ring", selectedRole === value

package/dist/client/ui/AppSidebar.d.ts

@@ -1,4 +1,5 @@
-import { type AppSidebarProps as ToolkitAppSidebarProps, type AppSidebarHeaderProps as ToolkitAppSidebarHeaderProps, type AppSidebarFooterProps as ToolkitAppSidebarFooterProps } from "@agent-native/toolkit/app-shell";
+import { type AppSidebarLinkProps, type AppSidebarProps as ToolkitAppSidebarProps, type AppSidebarHeaderProps as ToolkitAppSidebarHeaderProps, type AppSidebarFooterProps as ToolkitAppSidebarFooterProps } from "@agent-native/toolkit/app-shell";
+export declare const RouterSidebarLink: import("react").ForwardRefExoticComponent<AppSidebarLinkProps & import("react").RefAttributes<HTMLAnchorElement>>;
 export interface AppSidebarHeaderProps extends ToolkitAppSidebarHeaderProps {
     appId?: string;
     badgeText?: string;

package/dist/client/ui/AppSidebar.js

@@ -1,11 +1,20 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { AppSidebar as ToolkitAppSidebar, AppSidebarHeader as ToolkitAppSidebarHeader, AppSidebarFooter as ToolkitAppSidebarFooter, useAppSidebar, } from "@agent-native/toolkit/app-shell";
 import { forwardRef } from "react";
-import { Link } from "react-router";
+import { useHref, useLinkClickHandler } from "react-router";
 import { AgentNativeIcon } from "../components/icons/AgentNativeIcon.js";
 import { EnvironmentBadge } from "../EnvironmentBadge.js";
 import { FeedbackButton } from "../FeedbackButton.js";
-const RouterSidebarLink = forwardRef(({ to, href, children, ...props }, ref) => (_jsx(Link, { ref: ref, to: to ?? href ?? "/", ...props, children: children })));
+export const RouterSidebarLink = forwardRef(({ to, href, children, onClick, target, ...props }, ref) => {
+    const destination = to ?? href ?? "/";
+    const resolvedHref = useHref(destination);
+    const handleRouterClick = useLinkClickHandler(destination, { target });
+    return (_jsx("a", { ref: ref, href: resolvedHref, target: target, ...props, onClick: (event) => {
+            onClick?.(event);
+            if (!event.defaultPrevented)
+                handleRouterClick(event);
+        }, children: children }));
+});
 RouterSidebarLink.displayName = "RouterSidebarLink";
 export const AppSidebarHeader = forwardRef(({ brandIcon, badge, appId, badgeText, showBadge = true, brandLink, brandHref = "/", collapsed: propCollapsed, ...props }, ref) => {
     const context = useAppSidebar();

package/dist/client/ui/index.d.ts

@@ -19,4 +19,4 @@ export { applyEmbeddedThemeUpdate, buildEmbeddedThemeUpdate, EMBEDDED_THEME_CHAN
 export { APPEARANCE_PRESETS, applyAppearance, getStoredAppearance, useAppearance, useAppearanceSync, type AppearancePresetId, } from "../appearance.js";
 export { AppearancePicker, type AppearancePickerProps, } from "../AppearancePicker.js";
 export { AgentNativeIcon } from "../components/icons/AgentNativeIcon.js";
-export { AppSidebar, AppSidebarHeader, AppSidebarNavItem, AppSidebarNavGroup, AppSidebarSection, AppSidebarFeedbackButton, AppSidebarFooter, useAppSidebar, type AppSidebarProps, type AppSidebarHeaderProps, type AppSidebarNavItemProps, type AppSidebarNavGroupProps, type AppSidebarSectionProps, type AppSidebarFeedbackButtonProps, type AppSidebarFooterProps, type AppSidebarItemDefinition, type AppSidebarContextValue, } from "./AppSidebar.js";
+export { AppSidebar, RouterSidebarLink, AppSidebarHeader, AppSidebarNavItem, AppSidebarNavGroup, AppSidebarSection, AppSidebarFeedbackButton, AppSidebarFooter, useAppSidebar, type AppSidebarProps, type AppSidebarHeaderProps, type AppSidebarNavItemProps, type AppSidebarNavGroupProps, type AppSidebarSectionProps, type AppSidebarFeedbackButtonProps, type AppSidebarFooterProps, type AppSidebarItemDefinition, type AppSidebarContextValue, } from "./AppSidebar.js";

package/dist/client/ui/index.js

@@ -19,4 +19,4 @@ export { applyEmbeddedThemeUpdate, buildEmbeddedThemeUpdate, EMBEDDED_THEME_CHAN
 export { APPEARANCE_PRESETS, applyAppearance, getStoredAppearance, useAppearance, useAppearanceSync, } from "../appearance.js";
 export { AppearancePicker, } from "../AppearancePicker.js";
 export { AgentNativeIcon } from "../components/icons/AgentNativeIcon.js";
-export { AppSidebar, AppSidebarHeader, AppSidebarNavItem, AppSidebarNavGroup, AppSidebarSection, AppSidebarFeedbackButton, AppSidebarFooter, useAppSidebar, } from "./AppSidebar.js";
+export { AppSidebar, RouterSidebarLink, AppSidebarHeader, AppSidebarNavItem, AppSidebarNavGroup, AppSidebarSection, AppSidebarFeedbackButton, AppSidebarFooter, useAppSidebar, } from "./AppSidebar.js";

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/localization/core-messages/ar-SA.js

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "أخرى",
     "onboarding.roleOtherInputLabel": "صف دورك",
     "onboarding.skipForNow": "تخطي الآن",
+    "onboarding.useOwnApiKeys": "استخدام مفاتيح API الخاصة بي",
     "onboarding.saveRoleError": "تعذر حفظ دورك.",
     "onboarding.builderCreateAccount": "إنشاء حساب Builder.io",
     "onboarding.builderSignInWithAccount": "تسجيل الدخول بحساب Builder.io",

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

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "Andere",
     "onboarding.roleOtherInputLabel": "Beschreibe deine Rolle",
     "onboarding.skipForNow": "Vorerst überspringen",
+    "onboarding.useOwnApiKeys": "Meine eigenen API-Schlüssel verwenden",
     "onboarding.saveRoleError": "Deine Rolle konnte nicht gespeichert werden.",
     "onboarding.builderCreateAccount": "Builder.io-Konto erstellen",
     "onboarding.builderSignInWithAccount": "Mit Builder.io-Konto anmelden",

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

@@ -70,6 +70,7 @@ declare const messages: {
     readonly "onboarding.roleOther": "Other";
     readonly "onboarding.roleOtherInputLabel": "Describe your role";
     readonly "onboarding.skipForNow": "Skip for now";
+    readonly "onboarding.useOwnApiKeys": "Use my own API keys";
     readonly "onboarding.saveRoleError": "Could not save your role.";
     readonly "onboarding.builderCreateAccount": "Create Builder.io account";
     readonly "onboarding.builderSignInWithAccount": "Sign in with Builder.io account";

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

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "Other",
     "onboarding.roleOtherInputLabel": "Describe your role",
     "onboarding.skipForNow": "Skip for now",
+    "onboarding.useOwnApiKeys": "Use my own API keys",
     "onboarding.saveRoleError": "Could not save your role.",
     "onboarding.builderCreateAccount": "Create Builder.io account",
     "onboarding.builderSignInWithAccount": "Sign in with Builder.io account",

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

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "Otro",
     "onboarding.roleOtherInputLabel": "Describe tu función",
     "onboarding.skipForNow": "Omitir por ahora",
+    "onboarding.useOwnApiKeys": "Usar mis propias claves de API",
     "onboarding.saveRoleError": "No se pudo guardar tu rol.",
     "onboarding.builderCreateAccount": "Crear cuenta de Builder.io",
     "onboarding.builderSignInWithAccount": "Iniciar sesión con una cuenta de Builder.io",

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

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "Autre",
     "onboarding.roleOtherInputLabel": "Décrivez votre rôle",
     "onboarding.skipForNow": "Ignorer pour l’instant",
+    "onboarding.useOwnApiKeys": "Utiliser mes propres clés API",
     "onboarding.saveRoleError": "Impossible d’enregistrer votre rôle.",
     "onboarding.builderCreateAccount": "Créer un compte Builder.io",
     "onboarding.builderSignInWithAccount": "Se connecter avec un compte Builder.io",

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

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "अन्य",
     "onboarding.roleOtherInputLabel": "अपनी भूमिका बताएं",
     "onboarding.skipForNow": "अभी छोड़ें",
+    "onboarding.useOwnApiKeys": "मेरी अपनी API कुंजियाँ इस्तेमाल करें",
     "onboarding.saveRoleError": "आपकी भूमिका सहेजी नहीं जा सकी।",
     "onboarding.builderCreateAccount": "Builder.io खाता बनाएँ",
     "onboarding.builderSignInWithAccount": "Builder.io खाते से साइन इन करें",

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

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "その他",
     "onboarding.roleOtherInputLabel": "役割を入力してください",
     "onboarding.skipForNow": "今はスキップ",
+    "onboarding.useOwnApiKeys": "自分の API キーを使う",
     "onboarding.saveRoleError": "役割を保存できませんでした。",
     "onboarding.builderCreateAccount": "Builder.io アカウントを作成",
     "onboarding.builderSignInWithAccount": "Builder.io アカウントでサインイン",

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

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "기타",
     "onboarding.roleOtherInputLabel": "역할을 입력해 주세요",
     "onboarding.skipForNow": "지금 건너뛰기",
+    "onboarding.useOwnApiKeys": "내 API 키 사용",
     "onboarding.saveRoleError": "역할을 저장하지 못했습니다.",
     "onboarding.builderCreateAccount": "Builder.io 계정 만들기",
     "onboarding.builderSignInWithAccount": "Builder.io 계정으로 로그인",

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

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "Outro",
     "onboarding.roleOtherInputLabel": "Descreva sua função",
     "onboarding.skipForNow": "Pular por enquanto",
+    "onboarding.useOwnApiKeys": "Usar minhas próprias chaves de API",
     "onboarding.saveRoleError": "Não foi possível salvar sua função.",
     "onboarding.builderCreateAccount": "Criar conta do Builder.io",
     "onboarding.builderSignInWithAccount": "Entrar com uma conta do Builder.io",

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

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "其他",
     "onboarding.roleOtherInputLabel": "描述你的角色",
     "onboarding.skipForNow": "暂时跳过",
+    "onboarding.useOwnApiKeys": "使用我自己的 API 密钥",
     "onboarding.saveRoleError": "无法保存你的角色。",
     "onboarding.builderCreateAccount": "创建 Builder.io 账户",
     "onboarding.builderSignInWithAccount": "使用 Builder.io 账户登录",

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

@@ -70,6 +70,7 @@ const messages = {
     "onboarding.roleOther": "其他",
     "onboarding.roleOtherInputLabel": "描述你的角色",
     "onboarding.skipForNow": "暫時略過",
+    "onboarding.useOwnApiKeys": "使用我自己的 API 金鑰",
     "onboarding.saveRoleError": "無法儲存你的角色。",
     "onboarding.builderCreateAccount": "建立 Builder.io 帳戶",
     "onboarding.builderSignInWithAccount": "使用 Builder.io 帳戶登入",

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

@@ -72,6 +72,7 @@ export declare const englishAgentChatMessages: {
     readonly "onboarding.roleOther": "Other";
     readonly "onboarding.roleOtherInputLabel": "Describe your role";
     readonly "onboarding.skipForNow": "Skip for now";
+    readonly "onboarding.useOwnApiKeys": "Use my own API keys";
     readonly "onboarding.saveRoleError": "Could not save your role.";
     readonly "onboarding.builderCreateAccount": "Create Builder.io account";
     readonly "onboarding.builderSignInWithAccount": "Sign in with Builder.io account";

package/dist/observability/routes.d.ts

@@ -62,6 +62,6 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     summary?: undefined;
     spans?: undefined;
     id?: 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/agent-engine-ollama-models-route.d.ts

@@ -9,7 +9,7 @@ export declare function createAgentEngineOllamaModelsHandler(): import("h3").Eve
     ok?: undefined;
     models?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     models: string[];
+    error?: undefined;
 }>>;

package/dist/server/core-routes-plugin.d.ts

@@ -419,8 +419,8 @@ export declare function createPublicRemoteAgentsHandler(discover?: PublicAgentDi
     error: string;
     agents?: undefined;
 } | {
-    agents: Omit<import("./agent-discovery.js").DiscoveredAgent, "auth" | "kind">[];
     error?: undefined;
+    agents: Omit<import("./agent-discovery.js").DiscoveredAgent, "auth" | "kind">[];
 }>>;
 export declare function getBuilderConnectErrorDisposition(error: unknown, connectAttemptId: string | null): "correlated" | "legacy" | null;
 export declare function getBuilderConnectErrorKey(ownerEmail: string, connectAttemptId?: string | null): string;

package/dist/templates/chat/app/components/chat/ChatRouteContent.tsx

@@ -3,6 +3,8 @@ import type {
   AgentMessage,
 } from "@agent-native/agentkit";
 import {
+  AgentMessageView,
+  AgentRunFailure,
   AgentConnectionRequestCard,
   AgentKitChat,
 } from "@agent-native/agentkit/react/components";
@@ -10,9 +12,14 @@ import {
   useAgentKit,
   useAgentKitControl,
   useAgentThread,
+  type AgentRunFailureRenderProps,
   type AgentKitRenderProps,
 } from "@agent-native/agentkit/react/context";
 import { AgentKitRoot } from "@agent-native/agentkit/react/root";
+import {
+  BuilderSetupCard,
+  isMissingLlmProviderRunError,
+} from "@agent-native/core/client/agent-chat";
 import { CoreComposerRuntimeProvider } from "@agent-native/core/client/agentkit-chat/composer";
 import {
   McpAgentKitConnectionRequestCard,
@@ -120,7 +127,9 @@ function ChatThreadRouteContent({
             labels={{ composerPlaceholder: t("chat.composerPlaceholder") }}
             slots={{
               emptyState: ChatEmptyState,
+              message: ChatMessage,
               messageSupplement: ChatMcpConnectionSuggestion,
+              runFailure: ChatRunFailure,
               connectionRequest: ChatMcpConnectionRequest,
               footer: ChatAgentFooter,
             }}
@@ -153,6 +162,90 @@ function ChatThreadRouteContent({
   );
 }
 
+function ChatMessage({ value, threadId }: AgentKitRenderProps<AgentMessage>) {
+  const metadata = value.metadata as
+    | { custom?: { agentNativeRecoveryAction?: unknown } }
+    | undefined;
+  const recoveryAction = metadata?.custom?.agentNativeRecoveryAction;
+  if (
+    value.role === "user" &&
+    (recoveryAction === "continue" || recoveryAction === "retry")
+  ) {
+    return null;
+  }
+  return <AgentMessageView value={value} threadId={threadId} />;
+}
+
+function ChatRunFailure({
+  error,
+  runId,
+  threadId,
+}: AgentRunFailureRenderProps) {
+  const thread = useAgentThread(threadId);
+  const { controller } = useAgentKit();
+  const t = useT();
+  const recoveryMetadata = (message: (typeof thread.messages)[number]) =>
+    (
+      message.metadata as
+        | {
+            custom?: {
+              agentNativeRecoveryAction?: unknown;
+              agentNativeRecoveryOfRunId?: unknown;
+            };
+          }
+        | undefined
+    )?.custom;
+  const userRequests = thread.messages.filter((message) => {
+    if (message.role !== "user") return false;
+    const action = recoveryMetadata(message)?.agentNativeRecoveryAction;
+    return action !== "continue" && action !== "retry";
+  });
+  const originalRequest = userRequests[0];
+  const hasRetryForThisRun = thread.messages.some(
+    (message) =>
+      recoveryMetadata(message)?.agentNativeRecoveryAction === "retry" &&
+      recoveryMetadata(message)?.agentNativeRecoveryOfRunId === runId,
+  );
+  const retryFirstMessage = useCallback(() => {
+    const prompt =
+      originalRequest?.parts
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("\n") ?? "";
+    const attachments =
+      originalRequest?.parts.filter((part) => part.type === "file") ?? [];
+    void controller.sendMessage({
+      threadId,
+      text: prompt || t("chat.retryPreviousRequest"),
+      ...(attachments.length ? { attachments } : {}),
+      metadata: {
+        custom: {
+          agentNativeRecoveryAction: "retry",
+          agentNativeRecoveryOfRunId: runId,
+        },
+      },
+    });
+  }, [controller, originalRequest, runId, t, threadId]);
+  const isFirstMessage = userRequests.length === 1 && !hasRetryForThisRun;
+  if (
+    isFirstMessage &&
+    isMissingLlmProviderRunError({
+      message: error.message,
+      details: typeof error.details === "string" ? error.details : undefined,
+      errorCode: error.code,
+    })
+  ) {
+    return (
+      <BuilderSetupCard
+        fullWidth
+        layout="sidebar"
+        onRetry={retryFirstMessage}
+      />
+    );
+  }
+  return <AgentRunFailure error={error} runId={runId} threadId={threadId} />;
+}
+
 function ChatLifecycleTracking({ threadId }: { threadId: string }) {
   const thread = useAgentThread(threadId);
   const lifecycleRef = useRef({

package/dist/templates/chat/app/i18n/ar-SA.ts

@@ -32,6 +32,7 @@ const messages = {
     pinChat: "تثبيت المحادثة",
     pinned: "المثبتة",
     recents: "الأخيرة",
+    retryPreviousRequest: "أعِد محاولة طلبي السابق الآن بعد توصيل مزود النموذج.",
     renameChat: "إعادة تسمية المحادثة",
     renameFailed: "فشلت إعادة التسمية",
     renameThread: "إعادة تسمية السلسلة",

package/dist/templates/chat/app/i18n/de-DE.ts

@@ -34,6 +34,8 @@ const messages = {
     pinChat: "Chat anheften",
     pinned: "Angepinnt",
     recents: "Kürzlich",
+    retryPreviousRequest:
+      "Wiederhole meine vorherige Anfrage, jetzt wo der KI-Anbieter verbunden ist.",
     renameChat: "Chat umbenennen",
     renameFailed: "Umbenennen fehlgeschlagen",
     renameThread: "Thread umbenennen",

package/dist/templates/chat/app/i18n/en-US.ts

@@ -33,6 +33,8 @@ const messages = {
     pinChat: "Pin Chat",
     pinned: "Pinned",
     recents: "Recents",
+    retryPreviousRequest:
+      "Retry my previous request now that the model provider is connected.",
     renameChat: "Rename Chat",
     renameFailed: "Rename Failed",
     renameThread: "Rename Thread",

package/dist/templates/chat/app/i18n/es-ES.ts

@@ -34,6 +34,8 @@ const messages = {
     pinChat: "Fijar chat",
     pinned: "Fijados",
     recents: "Recientes",
+    retryPreviousRequest:
+      "Reintenta mi solicitud anterior ahora que el proveedor del modelo está conectado.",
     renameChat: "Renombrar chat",
     renameFailed: "No se pudo renombrar",
     renameThread: "Renombrar hilo",

package/dist/templates/chat/app/i18n/fr-FR.ts

@@ -34,6 +34,8 @@ const messages = {
     pinChat: "Épingler le chat",
     pinned: "Épinglés",
     recents: "Récents",
+    retryPreviousRequest:
+      "Réessaie ma demande précédente maintenant que le fournisseur du modèle est connecté.",
     renameChat: "Renommer le chat",
     renameFailed: "Échec du renommage",
     renameThread: "Renommer le fil",

package/dist/templates/chat/app/i18n/hi-IN.ts

@@ -32,6 +32,8 @@ const messages = {
     pinChat: "चैट पिन करें",
     pinned: "पिन की गई",
     recents: "हाल की",
+    retryPreviousRequest:
+      "मेरा पिछला अनुरोध फिर से आज़माएँ, अब जबकि मॉडल प्रदाता कनेक्ट हो गया है।",
     renameChat: "चैट का नाम बदलें",
     renameFailed: "नाम बदलना विफल",
     renameThread: "थ्रेड का नाम बदलें",