@agent-native/toolkit 0.200.0 → 0.200.1-nightly-20261002213029

package/src/app/settings/useBuilderStatus.spec.tsx

@@ -1,9 +1,11 @@
-import { openMcpAppHostLink } from "@agent-native/core/client/mcp-app-host";
 // @vitest-environment happy-dom
+import { AgentNativeI18nProvider } from "@agent-native/core/client/i18n";
+import { openMcpAppHostLink } from "@agent-native/core/client/mcp-app-host";
 import React, { act } from "react";
 import { createRoot, type Root } from "react-dom/client";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
+import { createToolkitI18nCatalog } from "../i18n.js";
 import { BuilderConnectPopover } from "./BuilderConnectPopover.js";
 import {
   isBuilderConnectComplete,
@@ -13,6 +15,8 @@ import {
   type BuilderConnectionScope,
 } from "./useBuilderStatus.js";
 
+const toolkitI18nCatalog = createToolkitI18nCatalog({ messages: {} });
+
 vi.mock("@agent-native/core/client/mcp-app-host", () => ({
   openMcpAppHostLink: vi.fn(() => false),
 }));
@@ -43,7 +47,7 @@ function setEmbeddedWindow(embedded: boolean) {
   });
 }
 
-function BuilderConnectProbe({
+function BuilderConnectProbeContent({
   enabled = true,
   popupUrl,
   provisionAccount = false,
@@ -103,7 +107,20 @@ function BuilderConnectProbe({
   );
 }
 
-function BuilderConnectPopoverProbe() {
+function BuilderConnectProbe(
+  props: React.ComponentProps<typeof BuilderConnectProbeContent>,
+) {
+  return (
+    <AgentNativeI18nProvider
+      catalog={toolkitI18nCatalog}
+      persistPreference={false}
+    >
+      <BuilderConnectProbeContent {...props} />
+    </AgentNativeI18nProvider>
+  );
+}
+
+function BuilderConnectPopoverProbeContent() {
   const flow = useBuilderConnectFlow();
   return (
     <BuilderConnectPopover flow={flow}>
@@ -112,6 +129,17 @@ function BuilderConnectPopoverProbe() {
   );
 }
 
+function BuilderConnectPopoverProbe() {
+  return (
+    <AgentNativeI18nProvider
+      catalog={toolkitI18nCatalog}
+      persistPreference={false}
+    >
+      <BuilderConnectPopoverProbeContent />
+    </AgentNativeI18nProvider>
+  );
+}
+
 function BuilderStatusProbe() {
   const { status, loading, stale, error } = useBuilderStatus();
   return (
@@ -816,7 +844,7 @@ describe("useBuilderConnectFlow", () => {
       expect(activationAttempts).toBe(1);
       expect(container.textContent).toContain("configured idle resolved");
       expect(container.textContent).not.toContain(
-        "Couldn't start Builder connect.",
+        "Couldn't start Builder.io setup.",
       );
       expect(onConnected).toHaveBeenCalled();
       expect(openSpy).not.toHaveBeenCalled();
@@ -852,7 +880,7 @@ describe("useBuilderConnectFlow", () => {
 
       expect(container.textContent).toContain("configured idle");
       expect(container.textContent).toContain(
-        "Couldn't start Builder connect. Refresh this page and try again.",
+        "Couldn't start Builder.io setup. Refresh this page and try again.",
       );
       expect(onConnected).not.toHaveBeenCalled();
     });
@@ -868,7 +896,7 @@ describe("useBuilderConnectFlow", () => {
 
       expect(container.textContent).toContain("not-configured idle");
       expect(container.textContent).toContain(
-        "Couldn't start Builder connect. Refresh this page and try again.",
+        "Couldn't start Builder.io setup. Refresh this page and try again.",
       );
     });
 
@@ -918,7 +946,7 @@ describe("useBuilderConnectFlow", () => {
       expect(posts).toHaveLength(2);
       expect(container.textContent).toContain("not-configured idle");
       expect(container.textContent).toContain(
-        "Couldn't start Builder connect. Refresh this page and try again.",
+        "Couldn't start Builder.io setup. Refresh this page and try again.",
       );
     });
 
@@ -1001,7 +1029,7 @@ describe("useBuilderConnectFlow", () => {
 
       expect(container.textContent).toContain("not-configured idle");
       expect(container.textContent).toContain(
-        "Couldn't start Builder connect. Refresh this page and try again.",
+        "Couldn't start Builder.io setup. Refresh this page and try again.",
       );
       expect(onConnected).not.toHaveBeenCalled();
       expect(openSpy).not.toHaveBeenCalled();
@@ -1063,33 +1091,41 @@ describe("useBuilderConnectFlow", () => {
     });
   });
 
-  it("uses the click-time provisioning capability instead of a stale closure", async () => {
-    setUserAgent("Mozilla/5.0 Chrome/140.0");
-    const popup = createPopupStub();
-    openSpy.mockReturnValue(popup);
+  it("refreshes stale provisioning capability and never opens OAuth to create", async () => {
     vi.mocked(fetch).mockReset();
-    vi.mocked(fetch)
-      .mockResolvedValueOnce(
-        jsonResponse({
+    let statusReads = 0;
+    let activationPosts = 0;
+    vi.mocked(fetch).mockImplementation(async (input) => {
+      const url = new URL(String(input));
+      if (url.pathname === "/_agent-native/builder/provision") {
+        activationPosts += 1;
+        return jsonResponse({ ok: true, scope: "personal" });
+      }
+      statusReads += 1;
+      if (statusReads === 1) {
+        return jsonResponse({
           configured: false,
           agentNativeProvisioningEnabled: false,
           envManaged: false,
           builderEnabled: true,
           orgName: null,
           connectUrl: signedConnectUrl,
-        }),
-      )
-      .mockResolvedValueOnce(
-        jsonResponse({
-          configured: false,
-          agentNativeProvisioningEnabled: true,
-          agentNativeProvisioningToken: provisioningToken,
-          envManaged: false,
-          builderEnabled: true,
-          orgName: null,
-          connectUrl: signedConnectUrl,
-        }),
+        });
+      }
+      return jsonResponse(
+        activationPosts
+          ? connectedBuilderStatus
+          : {
+              configured: false,
+              agentNativeProvisioningEnabled: true,
+              agentNativeProvisioningToken: provisioningToken,
+              envManaged: false,
+              builderEnabled: true,
+              orgName: null,
+              connectUrl: signedConnectUrl,
+            },
       );
+    });
 
     await act(async () => {
       root.render(<BuilderConnectProbe provisionAccount />);
@@ -1105,19 +1141,12 @@ describe("useBuilderConnectFlow", () => {
       await Promise.resolve();
     });
 
-    expect(withoutConnectAttempt(popup.location.href)).toBe(
-      expectedProvisionedConnectUrl(signedConnectUrl),
-    );
-    expect(
-      new URL(popup.location.href).searchParams.get("_an_connect_attempt"),
-    ).toMatch(/^[0-9a-f-]{36}$/);
+    expect(activationPosts).toBe(1);
+    expect(openSpy).not.toHaveBeenCalled();
+    expect(container.textContent).toContain("configured idle resolved");
   });
 
-  it("keeps account provisioning dormant when the server does not advertise it", async () => {
-    setUserAgent("Mozilla/5.0 Chrome/140.0");
-    const popup = createPopupStub();
-    openSpy.mockReturnValue(popup);
-
+  it("does not open OAuth when one-click provisioning is unavailable", async () => {
     await act(async () => {
       root.render(<BuilderConnectProbe provisionAccount />);
       await Promise.resolve();
@@ -1132,8 +1161,9 @@ describe("useBuilderConnectFlow", () => {
       await Promise.resolve();
     });
 
-    expect(withoutConnectAttempt(popup.location.href)).toBe(
-      expectedConnectUrl(signedConnectUrl),
+    expect(openSpy).not.toHaveBeenCalled();
+    expect(container.textContent).toContain(
+      "Couldn't start Builder.io setup. Refresh this page and try again.",
     );
   });
 
@@ -1286,7 +1316,7 @@ describe("useBuilderConnectFlow", () => {
       expectedConnectUrl(signedConnectUrl),
     );
     expect(container.textContent).not.toContain(
-      "Couldn't start Builder connect",
+      "Couldn't start Builder.io setup",
     );
   });
 
@@ -1807,7 +1837,7 @@ describe("useBuilderConnectFlow", () => {
       expectedConnectUrl(signedConnectUrl),
     );
     expect(container.textContent).not.toContain(
-      "Couldn't start Builder connect",
+      "Couldn't start Builder.io setup",
     );
 
     resolveInitialFetch(jsonResponse({ configured: false }));
@@ -1969,7 +1999,7 @@ describe("useBuilderConnectFlow", () => {
 
     expect(container.textContent).toContain("not-configured connecting");
     expect(container.textContent).not.toContain(
-      "Couldn't start Builder connect",
+      "Couldn't start Builder.io setup",
     );
   });
 
@@ -2055,7 +2085,7 @@ describe("useBuilderConnectFlow", () => {
 
     expect(container.textContent).toContain("configured idle resolved");
     expect(container.textContent).not.toContain(
-      "Couldn't start Builder connect",
+      "Couldn't start Builder.io setup",
     );
   });
 
@@ -2110,7 +2140,7 @@ describe("useBuilderConnectFlow", () => {
 
     expect(container.textContent).toContain("not-configured connecting");
     expect(container.textContent).not.toContain(
-      "Couldn't start Builder connect",
+      "Couldn't start Builder.io setup",
     );
 
     await act(async () => {
@@ -2272,7 +2302,7 @@ describe("useBuilderConnectFlow", () => {
 
     expect(container.textContent).toContain("not-configured idle");
     expect(container.textContent).toContain(
-      "Didn't finish connecting to Builder.io",
+      "Builder.io setup didn't finish. Try again, or use your own keys.",
     );
 
     const button = container.querySelector("button");
@@ -2339,7 +2369,7 @@ describe("useBuilderConnectFlow", () => {
 
     expect(container.textContent).toContain("not-configured idle");
     expect(container.textContent).toContain(
-      "Didn't finish connecting to Builder.io",
+      "Builder.io setup didn't finish. Try again, or use your own keys.",
     );
   });
 
@@ -2416,7 +2446,7 @@ describe("useBuilderConnectFlow", () => {
 
     expect(container.textContent).toContain("configured idle resolved");
     expect(container.textContent).not.toContain(
-      "Didn't finish connecting to Builder.io",
+      "Builder.io setup didn't finish. Try again, or use your own keys.",
     );
   });
 
@@ -2488,7 +2518,7 @@ describe("useBuilderConnectFlow", () => {
 
     expect(container.textContent).toContain("not-configured idle");
     expect(container.textContent).toContain(
-      "Didn't finish connecting to Builder.io",
+      "Builder.io setup didn't finish. Try again, or use your own keys.",
     );
   });
 
@@ -2592,7 +2622,7 @@ describe("useBuilderConnectFlow", () => {
 
     expect(container.textContent).toContain("not-configured idle");
     expect(container.textContent).toContain(
-      "Didn't finish connecting to Builder.io",
+      "Builder.io setup didn't finish. Try again, or use your own keys.",
     );
   });
 
@@ -2716,7 +2746,7 @@ describe("useBuilderConnectFlow", () => {
 
     expect(container.textContent).toContain("not-configured idle");
     expect(container.textContent).toContain(
-      "Didn't finish connecting to Builder.io",
+      "Builder.io setup didn't finish. Try again, or use your own keys.",
     );
   });
 
@@ -2802,7 +2832,7 @@ describe("useBuilderConnectFlow", () => {
     });
     expect(container.textContent).toContain("not-configured idle");
     expect(container.textContent).toContain(
-      "Didn't finish connecting to Builder.io",
+      "Builder.io setup didn't finish. Try again, or use your own keys.",
     );
     releaseStalledStatus?.();
   });

package/src/app/settings/useBuilderStatus.ts

@@ -3,6 +3,7 @@ import { agentNativePath } from "@agent-native/core/client/api-path";
 import { getCallbackOrigin } from "@agent-native/core/client/frame";
 import { scheduleAfterPaint } from "@agent-native/core/client/hooks";
 import { usePollLoop } from "@agent-native/core/client/hooks";
+import { useT } from "@agent-native/core/client/i18n";
 import { openMcpAppHostLink } from "@agent-native/core/client/mcp-app-host";
 import { oauthPopupWaitingUrl } from "@agent-native/core/client/oauth-popup";
 import { applyBuilderUtmTrackingParams } from "@agent-native/core/shared/builder-link-tracking";
@@ -216,6 +217,7 @@ export interface BuilderConnectStartOptions {
 
 export interface BuilderConnectFlow {
   configured: boolean;
+  provisionAccount?: boolean;
   statusResolved: boolean;
   statusReadSettledCount: number;
   envManaged: boolean;
@@ -253,14 +255,9 @@ const POPUP_LOAD_TIMEOUT_MS = 20_000;
 const STATUS_FETCH_ABORT_MS = 10_000;
 const BUILDER_STATUS_UNAVAILABLE_MESSAGE =
   "Couldn't reach Builder to check your account. Retrying.";
-const BUILDER_CONNECT_START_FAILED_MESSAGE =
-  "Couldn't start Builder connect. Refresh this page and try again.";
 const CALLBACK_SUCCESS_STATUS_RETRY_MS = 500;
 const CALLBACK_SUCCESS_STATUS_RETRIES = 10;
 const BUILDER_CONNECT_PARAM = "_an_connect";
-const BUILDER_CONNECT_MODE_PARAM = "_an_mode";
-const BUILDER_AGENT_NATIVE_PROVISION_MODE = "agent-native";
-const BUILDER_PROVISIONING_TOKEN_PARAM = "_an_provision";
 const BUILDER_CONNECT_ATTEMPT_PARAM = "_an_connect_attempt";
 const BUILDER_SIGNUP_SOURCE_PARAM = "signupSource";
 const BUILDER_AGENT_NATIVE_FLOW_PARAM = "agentNativeFlow";
@@ -778,6 +775,7 @@ export function isBuilderConnectComplete(
 export function useBuilderConnectFlow(
   opts: BuilderConnectFlowOptions = {},
 ): BuilderConnectFlow {
+  const t = useT();
   const {
     enabled = true,
     popupUrl,
@@ -1164,7 +1162,7 @@ export function useBuilderConnectFlow(
         ? statusConnectUrl
         : null;
 
-      if (provisionAccountForStart && agentNativeProvisioningEnabled) {
+      if (provisionAccountForStart) {
         const trackedFlow =
           cleanTrackingParam(clickTrackingFlow) ??
           inferBuilderConnectTrackingFlow(clickTrackingSource);
@@ -1201,29 +1199,39 @@ export function useBuilderConnectFlow(
         const freshProvisioningCredentials = async () => {
           // coercion-ok: no fresh token is sent as none and refused as provision_token_invalid
           const status = await fetchStatus();
+          if (!status?.agentNativeProvisioningEnabled) return null;
           const freshUrl = status?.connectUrl ?? null;
-          return {
-            provisioningToken: status?.agentNativeProvisioningToken ?? null,
-            connectToken: freshUrl
-              ? new URL(freshUrl, origin).searchParams.get(
-                  BUILDER_CONNECT_PARAM,
-                )
-              : null,
-          };
+          const freshConnectToken = freshUrl
+            ? new URL(freshUrl, origin).searchParams.get(BUILDER_CONNECT_PARAM)
+            : null;
+          return status.agentNativeProvisioningToken && freshConnectToken
+            ? {
+                provisioningToken: status.agentNativeProvisioningToken,
+                connectToken: freshConnectToken,
+              }
+            : null;
         };
         void (async () => {
           // The provisioning token outlives the signed connect URL by a
           // minute, so cached credentials count only when both are usable.
           const cachedCredentials =
-            agentNativeProvisioningToken && connectToken
+            agentNativeProvisioningEnabled &&
+            agentNativeProvisioningToken &&
+            connectToken
               ? {
                   provisioningToken: agentNativeProvisioningToken,
                   connectToken,
                 }
               : null;
-          let result = await activate(
-            cachedCredentials ?? (await freshProvisioningCredentials()),
-          );
+          const credentials =
+            cachedCredentials ?? (await freshProvisioningCredentials());
+          if (!credentials) {
+            connectStartedAtRef.current = null;
+            setConnecting(false);
+            setError(t("agentChat.settingsShell.builder.setupStartFailed"));
+            return;
+          }
+          let result = await activate(credentials);
           if (
             !result.ok &&
             cachedCredentials &&
@@ -1231,7 +1239,14 @@ export function useBuilderConnectFlow(
               result.code === "cross_origin") &&
             isCurrentAttempt()
           ) {
-            result = await activate(await freshProvisioningCredentials());
+            const freshCredentials = await freshProvisioningCredentials();
+            result = freshCredentials
+              ? await activate(freshCredentials)
+              : {
+                  ok: false,
+                  code: "provisioning_unavailable",
+                  message: null,
+                };
           }
           if (!isCurrentAttempt()) {
             notifyAgentEngineConfiguredChanged("builder-connect");
@@ -1273,7 +1288,7 @@ export function useBuilderConnectFlow(
           setError(
             result.message && result.code !== "provision_token_invalid"
               ? result.message
-              : BUILDER_CONNECT_START_FAILED_MESSAGE,
+              : t("agentChat.settingsShell.builder.setupStartFailed"),
           );
         })();
         return;
@@ -1289,11 +1304,7 @@ export function useBuilderConnectFlow(
         agentNativePath("/_agent-native/builder/connect"),
         origin,
       ).href;
-      const withProvisionMode = (
-        url: string,
-        provisioningEnabled = agentNativeProvisioningEnabled,
-        provisioningToken = agentNativeProvisioningToken,
-      ): string => {
+      const withConnectAttempt = (url: string): string => {
         const connectUrl = new URL(url, origin);
         connectUrl.searchParams.set(
           BUILDER_CONNECT_ATTEMPT_PARAM,
@@ -1305,24 +1316,9 @@ export function useBuilderConnectFlow(
             scopeForStart,
           );
         }
-        if (
-          !provisionAccountForStart ||
-          !provisioningEnabled ||
-          !provisioningToken
-        ) {
-          return connectUrl.toString();
-        }
-        connectUrl.searchParams.set(
-          BUILDER_CONNECT_MODE_PARAM,
-          BUILDER_AGENT_NATIVE_PROVISION_MODE,
-        );
-        connectUrl.searchParams.set(
-          BUILDER_PROVISIONING_TOKEN_PARAM,
-          provisioningToken,
-        );
         return connectUrl.toString();
       };
-      const directUrl = withProvisionMode(
+      const directUrl = withConnectAttempt(
         cachedFreshUrl ?? signedPropUrl ?? fallbackUrl,
       );
 
@@ -1388,10 +1384,8 @@ export function useBuilderConnectFlow(
               setOrgName(s.orgName ?? null);
             }
 
-            const hostUrl = withProvisionMode(
+            const hostUrl = withConnectAttempt(
               s?.connectUrl ?? cachedFreshUrl ?? directUrl,
-              !!s?.agentNativeProvisioningEnabled,
-              s?.agentNativeProvisioningToken ?? null,
             );
             const trackedHostUrl = withBuilderConnectTrackingParams(hostUrl, {
               source: clickTrackingSource,
@@ -1402,9 +1396,7 @@ export function useBuilderConnectFlow(
             if (!mountedRef.current || openedByHost) return;
             connectStartedAtRef.current = null;
             setConnecting(false);
-            setError(
-              "Couldn't open Builder from this chat host. Open this app in a browser tab and try Connect Builder (free tier available) again.",
-            );
+            setError(t("agentChat.settingsShell.builder.setupHostFailed"));
           })();
         } else {
           const isCurrentConnectAttempt = () =>
@@ -1455,10 +1447,8 @@ export function useBuilderConnectFlow(
               setOrgName(s.orgName ?? null);
             }
 
-            const freshUrl = withProvisionMode(
+            const freshUrl = withConnectAttempt(
               s?.connectUrl ?? cachedFreshUrl ?? signedPropUrl ?? fallbackUrl,
-              !!s?.agentNativeProvisioningEnabled,
-              s?.agentNativeProvisioningToken ?? null,
             );
             if (!freshUrl) {
               try {
@@ -1468,7 +1458,7 @@ export function useBuilderConnectFlow(
               }
               connectStartedAtRef.current = null;
               setConnecting(false);
-              setError(BUILDER_CONNECT_START_FAILED_MESSAGE);
+              setError(t("agentChat.settingsShell.builder.setupStartFailed"));
               return;
             }
             const popupLoaded = await popupReady;
@@ -1512,6 +1502,7 @@ export function useBuilderConnectFlow(
     },
     [
       enabled,
+      t,
       fetchStatus,
       agentNativeProvisioningEnabled,
       agentNativeProvisioningToken,
@@ -1608,9 +1599,7 @@ export function useBuilderConnectFlow(
               cleanTrackingParam(flow) ??
               inferBuilderConnectTrackingFlow(source),
           });
-          setError(
-            "Didn't finish connecting to Builder.io. Try again, or use your own keys.",
-          );
+          setError(t("agentChat.settingsShell.builder.setupFailed"));
         }
       } else if (Date.now() - started > POLL_TIMEOUT_MS) {
         connectStartedAtRef.current = null;
@@ -1878,6 +1867,7 @@ export function useBuilderConnectFlow(
 
   return {
     configured,
+    provisionAccount,
     codeChangeConfigured,
     statusResolved,
     statusReadSettledCount,

package/src/app/setup-connections/BuilderConnectCard.spec.tsx

@@ -60,16 +60,16 @@ describe("BuilderConnectCard", () => {
   beforeEach(() => {
     vi.stubGlobal("IS_REACT_ACT_ENVIRONMENT", true);
     viewModel = {
-      title: "Builder connect",
+      title: "Use Builder.io",
       description:
-        "Connect Builder.io for managed model access, browser automation, and workspace identity. Free tier available.",
+        "Model access, browser automation, file storage, and workspace identity. Free tier available.",
       status: { kind: "ready", label: "Ready to connect" },
       configured: false,
       pending: false,
       error: null,
       orgName: null,
       action: {
-        label: "Connect Builder.io",
+        label: "Use Builder.io",
         pending: false,
         disabled: false,
         onPress: vi.fn(),
@@ -111,7 +111,7 @@ describe("BuilderConnectCard", () => {
     expect(mocks.useBuilderConnectCardController).toHaveBeenCalledWith(
       expect.objectContaining({ trackingSource: "settings" }),
     );
-    expect(container.textContent).toContain("Builder connect");
+    expect(container.textContent).toContain("Use Builder.io");
     expect(container.textContent).toContain("Ready to connect");
     expect(container.querySelector("[data-semantic-action]")).not.toBeNull();
     expect(container.querySelector("[data-semantic-status]")).not.toBeNull();
@@ -257,7 +257,7 @@ describe("BuilderConnectCard", () => {
       ).click();
     });
     const reconnect = Array.from(document.body.querySelectorAll("button")).find(
-      (button) => button.textContent?.includes("Reconnect Builder.io"),
+      (button) => button.textContent?.includes("Use Builder.io"),
     );
     act(() => reconnect?.click());
 
@@ -312,7 +312,7 @@ describe("BuilderConnectCard", () => {
       ).click();
     });
 
-    expect(document.body.textContent).toContain("Reconnect Builder.io");
+    expect(document.body.textContent).toContain("Use Builder.io");
     expect(document.body.textContent).not.toContain("Disconnect");
   });
 
@@ -403,7 +403,7 @@ describe("BuilderConnectCard", () => {
       renderManaged(flow);
 
       openMenu();
-      act(() => menuButton("Reconnect Builder.io")?.click());
+      act(() => menuButton("Use Builder.io")?.click());
       expect(flow.start).toHaveBeenCalledWith(
         expect.objectContaining({ scope: "org", provisionAccount: false }),
       );
@@ -442,7 +442,7 @@ describe("BuilderConnectCard", () => {
       renderManaged(flow, "personal");
 
       openMenu();
-      act(() => menuButton("Reconnect Builder.io")?.click());
+      act(() => menuButton("Use Builder.io")?.click());
       expect(flow.start).toHaveBeenCalledWith(
         expect.objectContaining({ scope: "personal" }),
       );
@@ -482,7 +482,7 @@ describe("BuilderConnectCard", () => {
       renderManaged(flow);
 
       openMenu();
-      act(() => menuButton("Reconnect Builder.io")?.click());
+      act(() => menuButton("Use Builder.io")?.click());
       expect(flow.start).toHaveBeenCalledWith(
         expect.objectContaining({ scope: "org", provisionAccount: false }),
       );
@@ -517,7 +517,7 @@ describe("BuilderConnectCard", () => {
       renderManaged(flow);
 
       openMenu();
-      act(() => menuButton("Reconnect Builder.io")?.click());
+      act(() => menuButton("Use Builder.io")?.click());
       expect(flow.start).toHaveBeenCalledWith(
         expect.not.objectContaining({ scope: expect.anything() }),
       );
@@ -547,7 +547,7 @@ describe("BuilderConnectCard", () => {
       ),
     );
 
-    expect(container.textContent).toContain("Builder connect");
+    expect(container.textContent).toContain("Use Builder.io");
     expect(container.textContent).toContain("Ready to connect");
   });
 });

package/src/app/setup-connections/SetupConnectionsPage.tsx

@@ -1,3 +1,4 @@
+import { useT } from "@agent-native/core/client/i18n";
 import { cn } from "@agent-native/toolkit/utils";
 import type { ReactNode } from "react";
 
@@ -23,7 +24,7 @@ export interface SetupConnectionsPageProps {
 
 export function SetupConnectionsPage({
   title = "Setup & connections",
-  description = "Manage setup status, Builder connect, app secrets, and workspace connections from one standard surface.",
+  description,
   onboardingTitle = "Setup checklist",
   focusSecretKey,
   providerReadiness,
@@ -35,6 +36,7 @@ export function SetupConnectionsPage({
   showIntegrations = false,
   className,
 }: SetupConnectionsPageProps) {
+  const t = useT();
   return (
     <div className={cn("min-h-full bg-background p-4 sm:p-6", className)}>
       <div className="mx-auto flex w-full max-w-6xl flex-col gap-5">
@@ -43,7 +45,7 @@ export function SetupConnectionsPage({
             {title}
           </h1>
           <p className="max-w-3xl text-sm leading-6 text-muted-foreground">
-            {description}
+            {description ?? t("agentChat.setup.connectionsDescription")}
           </p>
         </header>