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

package/corpus/README.md

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

package/corpus/templates/assets/changelog/2026-09-26-builder-is-the-primary-first-run-setup.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-26
+---
+
+New users can continue with Builder, choose their own API keys, or skip setup and start using Assets.

package/corpus/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/corpus/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/corpus/templates/chat/changelog/2026-09-26-builder-setup-retry.md

@@ -0,0 +1,6 @@
+---
+type: added
+date: 2026-09-26
+---
+
+Chat can connect Builder when model credentials are missing and retry the original request with its files.

package/corpus/templates/clips/changelog/2026-09-26-builder-is-the-primary-first-run-setup.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-26
+---
+
+New users can continue with Builder, choose their own API keys, or skip setup and start using Clips.

package/corpus/templates/design/changelog/2026-09-26-builder-is-the-primary-first-run-setup.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-26
+---
+
+New users can continue with Builder, choose their own API keys, or skip setup and start using Design.

package/corpus/templates/slides/changelog/2026-09-26-builder-is-the-primary-first-run-setup.md

@@ -0,0 +1,6 @@
+---
+type: improved
+date: 2026-09-26
+---
+
+New users can continue with Builder, choose their own API keys, or skip setup and start using Slides.

package/dist/client/agent-chat/index.d.ts

@@ -18,7 +18,7 @@ export { CodeRequiredDialog, type CodeRequiredDialogProps, } from "../components
 export { ChatFirstAgentActivityPanel, type ChatFirstAgentActivityPanelProps, } from "../chat-first-agent-activity.js";
 export { ChatFirstSurfacePanelToggle } from "../chat-first-surface-panel-toggle.js";
 export { useAgentEngineConfigured, type AgentEngineConfiguredState, type UseAgentEngineConfiguredResult, } from "../use-agent-engine-configured.js";
-export { BuilderSetupCard } from "../chat/run-recovery.js";
+export { BuilderSetupCard, isMissingLlmProviderRunError, type RunErrorInfo, } from "../chat/run-recovery.js";
 export { AgentConversation, AgentConversationMessageView, normalizeCodeAgentTranscriptForConversation, useNearBottomAutoscroll, type CodeAgentConversationTranscriptEvent, type CodeAgentConversationTranscriptEventType, type NormalizeCodeAgentTranscriptOptions, type AgentConversationArtifact, type AgentConversationAttachment, type AgentConversationMessage, type AgentConversationMessagePart, type AgentConversationMessageRole, type AgentConversationNotice, type AgentConversationNoticeTone, type AgentConversationToolCall, type AgentConversationToolState, } from "../conversation/index.js";
 export { McpAppRenderer } from "../mcp-apps/McpAppRenderer.js";
 export { AGENT_NATIVE_MCP_APP_HOST_MESSAGE_TYPES, getMcpAppHostContext, initializeMcpAppHost, openMcpAppHostLink, requestMcpAppDisplayMode, sendMcpAppHostMessage, updateMcpAppModelContext, useMcpAppHostContext, type AgentNativeMcpAppHostMessageType, type McpAppDisplayMode, type McpAppHostChatMessage, type McpAppHostCapabilities, type McpAppHostContext, type McpAppHostInfo, type McpAppHostContextSnapshot, type McpAppModelContextContentPart, type McpAppModelContextUpdate, } from "../mcp-app-host.js";

package/dist/client/agent-chat/index.js

@@ -18,7 +18,7 @@ export { CodeRequiredDialog, } from "../components/CodeRequiredDialog.js";
 export { ChatFirstAgentActivityPanel, } from "../chat-first-agent-activity.js";
 export { ChatFirstSurfacePanelToggle } from "../chat-first-surface-panel-toggle.js";
 export { useAgentEngineConfigured, } from "../use-agent-engine-configured.js";
-export { BuilderSetupCard } from "../chat/run-recovery.js";
+export { BuilderSetupCard, isMissingLlmProviderRunError, } from "../chat/run-recovery.js";
 export { AgentConversation, AgentConversationMessageView, normalizeCodeAgentTranscriptForConversation, useNearBottomAutoscroll, } from "../conversation/index.js";
 export { McpAppRenderer } from "../mcp-apps/McpAppRenderer.js";
 export { AGENT_NATIVE_MCP_APP_HOST_MESSAGE_TYPES, getMcpAppHostContext, initializeMcpAppHost, openMcpAppHostLink, requestMcpAppDisplayMode, sendMcpAppHostMessage, updateMcpAppModelContext, useMcpAppHostContext, } from "../mcp-app-host.js";

package/dist/client/chat/agentkit-protocol.js

@@ -1852,12 +1852,29 @@ export function createAgentKitProtocolAdapter(runtime, options = {}) {
             if (input.resume !== undefined) {
                 throw new AgentProtocolValidationError("startRun.resume", "Core requires approval continuations to use resumeRun");
             }
-            const turnMetadata = mergeTrustedProtocolMetadata(options.metadata, input.metadata, input.options?.metadata, input.options?.agentId ? { agentId: input.options.agentId } : undefined, input.options?.locale ? { locale: input.options.locale } : undefined, input.options?.mode ? { mode: input.options.mode } : undefined);
+            const latestUserMessage = [...input.messages]
+                .reverse()
+                .find((message) => message.role === "user");
+            const latestUserMetadata = asRecord(latestUserMessage?.metadata);
+            const recoveryMetadata = asRecord(latestUserMetadata?.custom);
+            const isRecoveryRetry = recoveryMetadata?.agentNativeRecoveryAction === "retry";
+            const turnMetadata = mergeTrustedProtocolMetadata(options.metadata, input.metadata, input.options?.metadata, input.options?.agentId ? { agentId: input.options.agentId } : undefined, input.options?.locale ? { locale: input.options.locale } : undefined, input.options?.mode ? { mode: input.options.mode } : undefined, isRecoveryRetry ? { agentNativeInternalContinuation: true } : undefined);
             const session = await getSession(input.threadId, turnMetadata);
             const messages = input.messages.map(protocolMessageToRuntimeMessage);
+            const attachments = latestUserMessage?.parts.flatMap((part) => part.type === "file"
+                ? [
+                    {
+                        name: part.name,
+                        ...(part.fileId ? { id: part.fileId } : {}),
+                        ...(part.mediaType ? { mediaType: part.mediaType } : {}),
+                        ...(part.url ? { url: part.url } : {}),
+                    },
+                ]
+                : []) ?? [];
             const turn = await session.startTurn({
                 prompt: latestUserPrompt(input.messages),
                 messages,
+                ...(attachments.length ? { attachments } : {}),
                 model: input.options?.model,
                 reasoningEffort: input.options?.reasoningEffort,
                 temperature: input.options?.temperature,

package/dist/client/chat/run-recovery.d.ts

@@ -22,6 +22,7 @@ export declare function runErrorHeadline(info: RunErrorInfo, labels?: {
 }): string;
 export declare function getRequestModeMetadata(message: unknown): "act" | "plan" | null;
 export declare function isBuilderReconnectRunError(info: RunErrorInfo): boolean;
+export declare function isMissingLlmProviderRunError(info: RunErrorInfo): boolean;
 export declare function BuilderConnectCta({ variant, onConnected, reconnect, }: {
     variant?: "primary" | "compact";
     onConnected?: () => void;

package/dist/client/chat/run-recovery.js

@@ -119,7 +119,7 @@ function isConnectionRecoveryRunError(info) {
         message.includes("connection kept failing") ||
         message.includes("automatic recovery attempts"));
 }
-function isMissingLlmProviderRunError(info) {
+export function isMissingLlmProviderRunError(info) {
     const code = (info.errorCode ?? "").toLowerCase();
     const text = [info.message, info.details].filter(Boolean).join("\n");
     const hasCredentialSetupText = /no llm provider(?: key)? (?:is connected|was found)|missing credentials|missing api key|missing_api_key|(?:api[_ -]?key|auth[_ -]?token)\s*(?:(?:is|was)\s+)?(?:not\s+(?:set|configured|available|present|provided|found)|missing|unavailable|empty|unset|unconfigured)/i.test(text);

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/collab/awareness.d.ts

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

package/dist/collab/routes.d.ts

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

package/dist/file-upload/actions/upload-image.d.ts

@@ -44,9 +44,9 @@ declare const _default: import("../../action.js").ActionDefinition<{
     url: string;
     id: string;
     provider: string;
+    error?: undefined;
     configured?: undefined;
     connectPath?: undefined;
-    error?: undefined;
 } | {
     url?: undefined;
     id?: undefined;

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 账户登录",