@agent-native/core 0.136.5 → 0.137.1

package/dist/client/AgentPanel.js

@@ -42,7 +42,7 @@ import { Link, useLocation, useNavigate } from "react-router";
 import { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
 import { consumeAgentSidebarUrlOpenOverride, dispatchAgentSidebarStateChange, getInitialAgentSidebarOpen, setAgentSidebarOpenPreference, subscribeAgentSidebarUrlChanges, SIDEBAR_STATE_CHANGE_EVENT, } from "./agent-sidebar-state.js";
 import { trackEvent } from "./analytics.js";
-import { agentNativePath, appPath } from "./api-path.js";
+import { agentNativePath, appPath, isWorkspaceAppPath } from "./api-path.js";
 import { readClientAppState } from "./application-state.js";
 import { assistantUiRecoverableRenderErrorKind } from "./assistant-ui-recovery.js";
 import { shouldParentFrameOwnAgentPanel } from "./builder-frame.js";
@@ -51,6 +51,7 @@ import { fetchBuilderStatus } from "./client-status-requests.js";
 import { RealtimeVoiceModeProvider } from "./composer/index.js";
 import { getFramePostMessageTargetOrigin, isTrustedFrameMessage, } from "./frame.js";
 import { useT } from "./i18n.js";
+import { isFirstRunOnboardingEnabled } from "./onboarding/first-run-enabled.js";
 import { recoverFromStaleChunkError } from "./route-chunk-recovery.js";
 import { AgentNativeRouteWarmup } from "./route-warmup.js";
 import { withBuilderConnectTrackingParams } from "./settings/useBuilderStatus.js";
@@ -103,6 +104,9 @@ const SettingsPanel = lazy(() => import("./settings/index.js").then((m) => ({
 const OnboardingPanel = lazy(() => import("./onboarding/OnboardingPanel.js").then((m) => ({
     default: m.OnboardingPanel,
 })));
+const FirstRunOnboarding = lazy(() => import("./onboarding/FirstRunOnboarding.js").then((m) => ({
+    default: m.FirstRunOnboarding,
+})));
 // Lazy-load SetupButton — the header entry-point that re-opens the
 // onboarding panel after the user has dismissed it.
 const SetupButton = lazy(() => import("./onboarding/SetupButton.js").then((m) => ({
@@ -113,6 +117,8 @@ const SetupButton = lazy(() => import("./onboarding/SetupButton.js").then((m) =>
 // GitHub, etc.) is surfaced in better places (the settings panel and the
 // per-feature setup affordances). Keep this off; do not re-enable globally.
 const SHOW_ONBOARDING = false;
+const SHOW_FIRST_RUN_ONBOARDING = isFirstRunOnboardingEnabled();
+const AgentSidebarOnboardingContext = React.createContext(false);
 const CLI_STORAGE_KEY = "agent-native-cli-command";
 const CLI_DEFAULT = "claude";
 const EXEC_MODE_KEY = "agent-native-exec-mode";
@@ -385,6 +391,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
     const t = useT();
     const navigate = useNavigate();
     const mounted = useClientOnly();
+    const insideAgentSidebar = React.useContext(AgentSidebarOnboardingContext);
     const feedbackEnabled = resolveFeedbackUrl(undefined, mounted ? undefined : null) !== null;
     const keyPrefix = storageKey ? `:${storageKey}` : "";
     const execModeKey = `${EXEC_MODE_KEY}${keyPrefix}`;
@@ -863,7 +870,7 @@ function AgentPanelInner({ defaultMode = "chat", className, style, apiUrl, empty
                         `[data-agent-fullscreen='true'] .agent-plan-mode-callout{` +
                         `max-width:${FULLSCREEN_CHAT_COLUMN_MAX_PX}px;` +
                         `margin-left:auto;margin-right:auto;width:100%;}`,
-                } }), SHOW_ONBOARDING && mounted && (_jsx(Suspense, { fallback: null, children: _jsx(OnboardingPanel, {}) })), _jsx("div", { className: cn("flex flex-col min-h-0", mode === "chat" ? "flex-1" : "shrink-0"), children: mounted && (_jsx(Suspense, { fallback: _jsx(ChatLoadingSkeleton, { renderHeader: showHeader ? renderChatHeader : undefined, centerComposerWhenEmpty: assistantChatProps.centerComposerWhenEmpty, composerSlot: assistantChatProps.composerSlot, composerAreaClassName: assistantChatProps.composerAreaClassName, composerLayoutVariant: assistantChatProps.composerLayoutVariant }), children: _jsx(MultiTabAssistantChatLazy, { ...assistantChatProps, agentChatSurface: effectiveAgentChatSurface, apiUrl: apiUrl, showHeader: false, renderHeader: showHeader ? renderChatHeader : undefined, showTabBar: showTabBar, renderOverlay: showPageNewChatButton && !showHeader
+                } }), SHOW_ONBOARDING && mounted && (_jsx(Suspense, { fallback: null, children: _jsx(OnboardingPanel, {}) })), SHOW_FIRST_RUN_ONBOARDING && mounted && !insideAgentSidebar && (_jsx(Suspense, { fallback: null, children: _jsx(FirstRunOnboarding, {}) })), _jsx("div", { className: cn("flex flex-col min-h-0", mode === "chat" ? "flex-1" : "shrink-0"), children: mounted && (_jsx(Suspense, { fallback: _jsx(ChatLoadingSkeleton, { renderHeader: showHeader ? renderChatHeader : undefined, centerComposerWhenEmpty: assistantChatProps.centerComposerWhenEmpty, composerSlot: assistantChatProps.composerSlot, composerAreaClassName: assistantChatProps.composerAreaClassName, composerLayoutVariant: assistantChatProps.composerLayoutVariant }), children: _jsx(MultiTabAssistantChatLazy, { ...assistantChatProps, agentChatSurface: effectiveAgentChatSurface, apiUrl: apiUrl, showHeader: false, renderHeader: showHeader ? renderChatHeader : undefined, showTabBar: showTabBar, renderOverlay: showPageNewChatButton && !showHeader
                             ? renderPageChatOverlay
                             : undefined, contentHidden: mode !== "chat", emptyStateText: emptyStateText, emptyStateAddon: emptyStateAddon, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, onSwitchToCli: () => switchMode("cli"), execMode: execMode, onExecModeChange: switchExecMode, storageKey: storageKey, restoreActiveThread: restoreActiveThread, scope: scope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync }) })) }), canUseCodeTools
                 ? mode === "cli" &&
@@ -1139,7 +1146,12 @@ function URLSync({ browserTabId }) {
             // Replace rather than push so repeated agent URL updates don't
             // clutter the history stack and can't trigger extra remounts from
             // router navigation lifecycle.
-            window.setTimeout(() => navigate(url, { replace: true }), 0);
+            if (isWorkspaceAppPath(url)) {
+                window.location.replace(url);
+            }
+            else {
+                window.setTimeout(() => navigate(url, { replace: true }), 0);
+            }
         }
         catch {
             // Malformed command — ignore.
@@ -1723,11 +1735,14 @@ export function AgentSidebar({ children, emptyStateText = "How can I help you?",
                         : undefined, "data-agent-sidebar-layout": panelLayout, "data-agent-sidebar-position": position, "data-agent-sidebar-state": panelOpen ? "open" : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, "data-agent-sidebar-chat-handoff": chatViewTransitionHandoff ? "true" : undefined, style: chatViewTransition
                     ? getAgentChatViewTransitionStyle(panelStyle)
                     : panelStyle, inert: sidebarAnimationEnabled && !panelOpen ? true : undefined, "aria-hidden": sidebarAnimationEnabled && !panelOpen ? true : undefined, children: _jsx("div", { className: "agent-sidebar-panel-inner flex min-h-0 flex-1 flex-col", children: _jsx(AgentPanel, { emptyStateText: emptyStateText, suggestions: suggestions, dynamicSuggestions: dynamicSuggestions, composerToolbarSlot: composerToolbarSlot, composerSlot: composerSlot, onComposerTextChange: onComposerTextChange, imageModelMenu: imageModelMenu, threadFooterSlot: threadFooterSlot, missingApiKeySetupLayout: "sidebar", onCollapse: () => setOpenPersisted(false), isFullscreen: effectiveFullscreen, onToggleFullscreen: isMobile ? undefined : (onFullscreenRequest ?? toggleFullscreen), storageKey: storageKey, scope: scope, showScopeBadge: showScopeBadge, browserTabId: browserTabId, threadUrlSync: threadUrlSync, agentPageHref: agentPageHref, allowSettingsMode: false, chatOnly: true }) }) }), showResizeHandle && isLeft && (_jsx(ResizeHandle, { position: position, onDrag: handleDrag, onResizeStart: handleResizeStart, onResizeEnd: handleResizeEnd }))] })) : null;
-    return (_jsx(RealtimeVoiceModeProvider, { browserTabId: browserTabId, children: _jsxs("div", { className: "agent-sidebar-shell flex min-w-0 flex-1 h-screen overflow-hidden", "data-agent-sidebar-position": position, "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: [_jsx(AgentNativeRouteWarmup, {}), isMobile &&
-                    !presentationMode &&
-                    (mobileAnimationEnabled ? shouldRenderPanel : open) && (_jsx("div", { className: cn("agent-sidebar-backdrop fixed inset-0 bg-black/40", mobileAnimationEnabled && !panelOpen && "pointer-events-none"), "data-agent-sidebar-animation": mobileAnimationEnabled ? "mobile" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", style: { zIndex: SIDEBAR_OVERLAY_Z_INDEX - 1 }, onClick: () => setOpenPersisted(false) })), shouldMountPanel ? _jsx(URLSync, { browserTabId: browserTabId }) : null, isLeft && !presentationMode ? sidebar : null, _jsx("div", { className: "agent-sidebar-main-surface flex flex-1 flex-col overflow-auto min-w-0", "data-agent-sidebar-main-position": position, "data-agent-sidebar-main-state": !isMobile && !effectiveFullscreen && !presentationMode && panelOpen
-                        ? "open"
-                        : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: _jsx(ScreenRefreshBoundary, { children: children }) }), !isLeft && !presentationMode ? sidebar : null] }) }));
+    return (_jsx(AgentSidebarOnboardingContext.Provider, { value: true, children: _jsxs(RealtimeVoiceModeProvider, { browserTabId: browserTabId, children: [SHOW_FIRST_RUN_ONBOARDING && (_jsx(Suspense, { fallback: null, children: _jsx(FirstRunOnboarding, {}) })), _jsxs("div", { className: "agent-sidebar-shell flex min-w-0 flex-1 h-screen overflow-hidden", "data-agent-sidebar-position": position, "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: [_jsx(AgentNativeRouteWarmup, {}), isMobile &&
+                            !presentationMode &&
+                            (mobileAnimationEnabled ? shouldRenderPanel : open) && (_jsx("div", { className: cn("agent-sidebar-backdrop fixed inset-0 bg-foreground/40", mobileAnimationEnabled && !panelOpen && "pointer-events-none"), "data-agent-sidebar-animation": mobileAnimationEnabled ? "mobile" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", style: { zIndex: SIDEBAR_OVERLAY_Z_INDEX - 1 }, onClick: () => setOpenPersisted(false) })), shouldMountPanel ? _jsx(URLSync, { browserTabId: browserTabId }) : null, isLeft && !presentationMode ? sidebar : null, _jsx("div", { className: "agent-sidebar-main-surface flex flex-1 flex-col overflow-auto min-w-0", "data-agent-sidebar-main-position": position, "data-agent-sidebar-main-state": !isMobile &&
+                                !effectiveFullscreen &&
+                                !presentationMode &&
+                                panelOpen
+                                ? "open"
+                                : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: _jsx(ScreenRefreshBoundary, { children: children }) }), !isLeft && !presentationMode ? sidebar : null] })] }) }));
 }
 /**
  * Focus the agent chat composer input.

package/dist/client/DefaultSpinner.d.ts

@@ -1,14 +1,2 @@
-/**
- * Full-screen loading spinner rendered during SSR and initial hydration.
- * Uses inline SVG + styles because Tailwind may not be loaded yet on the server.
- * Respects the user's OS color scheme so dark-mode users don't get a white flash.
- *
- * The stall hint is revealed by a pure-CSS `animation-delay`, never a timer:
- * the states that strand a user here (hydration never runs, the route module
- * 404s, a cold dev-server compile) are exactly the states where no JS of ours
- * executes, so a `setTimeout` fallback would never fire. A featureless spinner
- * is indistinguishable from a blank screen, and reads as "the app is broken"
- * rather than "look at the terminal" — that mis-read is what this text buys.
- */
 export declare function DefaultSpinner(): import("react").JSX.Element;
 //# sourceMappingURL=DefaultSpinner.d.ts.map

package/dist/client/DefaultSpinner.js

@@ -1,17 +1,33 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
 /**
  * Full-screen loading spinner rendered during SSR and initial hydration.
  * Uses inline SVG + styles because Tailwind may not be loaded yet on the server.
  * Respects the user's OS color scheme so dark-mode users don't get a white flash.
  *
- * The stall hint is revealed by a pure-CSS `animation-delay`, never a timer:
+ * In development builds, the stall hint is revealed by a pure-CSS
+ * `animation-delay`, never a timer:
  * the states that strand a user here (hydration never runs, the route module
  * 404s, a cold dev-server compile) are exactly the states where no JS of ours
  * executes, so a `setTimeout` fallback would never fire. A featureless spinner
  * is indistinguishable from a blank screen, and reads as "the app is broken"
  * rather than "look at the terminal" — that mis-read is what this text buys.
  */
+function isDevelopmentBuild() {
+    if (typeof process !== "undefined" &&
+        process.env?.NODE_ENV === "production") {
+        return false;
+    }
+    const viteEnv = import.meta.env;
+    if (viteEnv?.PROD === true)
+        return false;
+    return viteEnv?.DEV === true;
+}
 export function DefaultSpinner() {
+    const [showStallHint, setShowStallHint] = useState(false);
+    useEffect(() => {
+        setShowStallHint(isDevelopmentBuild());
+    }, []);
     return (_jsxs("div", { style: {
             display: "flex",
             flexDirection: "column",
@@ -20,8 +36,10 @@ export function DefaultSpinner() {
             gap: 16,
             height: "100vh",
             width: "100%",
-        }, children: [_jsx("svg", { role: "status", "aria-label": "Loading", width: 24, height: 24, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", style: { animation: "an-spin 1s linear infinite", opacity: 0.7 }, children: _jsx("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }) }), _jsx("p", { className: "an-stall-hint", children: "Still loading. A first run compiles dependencies and can take a minute \u2014 if it does not finish, check the terminal running the dev server for errors." }), _jsx("style", { children: `
+        }, children: [_jsx("svg", { role: "status", "aria-label": "Loading", width: 24, height: 24, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", style: { animation: "an-spin 1s linear infinite", opacity: 0.7 }, children: _jsx("path", { d: "M21 12a9 9 0 1 1-6.219-8.56" }) }), showStallHint && (_jsx("p", { className: "an-stall-hint", children: "Still loading. A first run compiles dependencies and can take a minute \u2014 if it does not finish, check the terminal running the dev server for errors." })), _jsx("style", { children: `
         @keyframes an-spin { to { transform: rotate(360deg) } }
+        ${showStallHint
+                    ? `
         @keyframes an-stall-in { to { opacity: 0.6 } }
         .an-stall-hint {
           opacity: 0;
@@ -37,6 +55,8 @@ export function DefaultSpinner() {
         @media (prefers-reduced-motion: reduce) {
           .an-stall-hint { animation-duration: 0s }
         }
+        `
+                    : ""}
         html {
           background: hsl(var(--background, 0 0% 100%));
           color: hsl(var(--foreground, 240 10% 3.9%));

package/dist/client/api-path.d.ts

@@ -1,4 +1,10 @@
 export declare function appBasePath(): string;
+/**
+ * Returns true for a same-origin path mounted at a sibling workspace app.
+ * React Router treats root paths as local to its basename, so these targets
+ * must use the browser location instead of the app-local router.
+ */
+export declare function isWorkspaceAppPath(path: string): boolean;
 export declare function appPath(path: string): string;
 export declare function appApiPath(path: string): string;
 export declare function agentNativePath(path: string): string;

package/dist/client/api-path.js

@@ -88,6 +88,61 @@ export function appBasePath() {
     // app build into another. Prefer the live mount path when they disagree.
     return derived || workspacePathBasePath() || configured;
 }
+function workspaceAppMountPaths() {
+    const raw = clientEnv()?.VITE_AGENT_NATIVE_WORKSPACE_APPS_JSON;
+    if (typeof raw !== "string" || !raw.trim())
+        return null;
+    try {
+        const parsed = JSON.parse(raw);
+        const entries = Array.isArray(parsed)
+            ? parsed
+            : parsed && typeof parsed === "object" && "apps" in parsed
+                ? parsed.apps
+                : null;
+        if (!Array.isArray(entries))
+            return null;
+        const paths = entries
+            .map((entry) => {
+            if (!entry || typeof entry !== "object")
+                return null;
+            const record = entry;
+            const rawPath = typeof record.path === "string"
+                ? record.path
+                : typeof record.id === "string"
+                    ? `/${record.id}`
+                    : null;
+            return rawPath?.startsWith("/") ? normalizeBasePath(rawPath) : null;
+        })
+            .filter((path) => Boolean(path));
+        return paths.length ? new Set(paths) : null;
+    }
+    catch {
+        // coercion-ok: malformed manifests cannot authorize cross-app navigation
+        return null;
+    }
+}
+/**
+ * Returns true for a same-origin path mounted at a sibling workspace app.
+ * React Router treats root paths as local to its basename, so these targets
+ * must use the browser location instead of the app-local router.
+ */
+export function isWorkspaceAppPath(path) {
+    if (typeof window === "undefined" || !path.startsWith("/"))
+        return false;
+    if (!isWorkspaceRuntime())
+        return false;
+    const targetPath = path.split(/[?#]/, 1)[0] || "/";
+    const basePath = appBasePath();
+    if (!basePath)
+        return false;
+    if (targetPath === basePath || targetPath.startsWith(`${basePath}/`)) {
+        return false;
+    }
+    const mounts = workspaceAppMountPaths();
+    if (!mounts)
+        return false;
+    return [...mounts].some((mount) => targetPath === mount || targetPath.startsWith(`${mount}/`));
+}
 export function appPath(path) {
     if (!path.startsWith("/"))
         return path;

package/dist/client/onboarding/FirstRunOnboarding.d.ts

@@ -0,0 +1,3 @@
+import React from "react";
+export declare function FirstRunOnboarding(): React.JSX.Element | null;
+//# sourceMappingURL=FirstRunOnboarding.d.ts.map

package/dist/client/onboarding/FirstRunOnboarding.js

@@ -0,0 +1,93 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Skeleton } from "@agent-native/toolkit/ui/skeleton";
+import { IconArrowRight, IconBrandGithub, IconCheck, IconExternalLink, IconInfoCircle, IconKey, IconLoader2, } from "@tabler/icons-react";
+import React, { useMemo, useState } from "react";
+import { appPath } from "../api-path.js";
+import { Tooltip, TooltipContent, TooltipTrigger, } from "../components/ui/tooltip.js";
+import { useBuilderConnectFlow } from "../settings/useBuilderStatus.js";
+import { cn } from "../utils.js";
+import { useOnboarding } from "./use-onboarding.js";
+const BUILDER_MORE_SERVICES = [
+    "Voice input",
+    "Background agents",
+    "Image generation",
+    "Video generation",
+    "Connected agents",
+    "Hosting and deployment",
+    "Browser automation",
+    "Embeddings",
+];
+export function FirstRunOnboarding() {
+    const { firstRun, loading, error, profile, completeFirstRun } = useOnboarding();
+    const [screen, setScreen] = useState("intro");
+    const showReady = () => setScreen("ready");
+    const connectFlow = useBuilderConnectFlow({
+        enabled: firstRun,
+        trackingSource: "first_run_onboarding",
+        trackingFlow: "connect_llm",
+        onConnected: showReady,
+    });
+    if (!firstRun)
+        return null;
+    if (error) {
+        return (_jsx(OnboardingShell, { profile: profile, screen: "choice", children: _jsxs("div", { className: "mx-auto flex w-full max-w-md flex-col items-center gap-4 text-center", children: [_jsx("h1", { className: "text-xl font-semibold tracking-[-0.03em]", children: "Setup is almost ready." }), _jsx("p", { className: "text-sm text-muted-foreground", children: "We could not load the connection options yet." }), _jsx("button", { type: "button", className: primaryButtonClass, onClick: () => window.location.reload(), children: "Try again" })] }) }));
+    }
+    if (loading || !profile) {
+        return _jsx(OnboardingSkeleton, {});
+    }
+    const builderCapabilities = profile.capabilities.filter((capability) => capability.builderIncluded);
+    const handleBuilder = () => {
+        if (connectFlow.hasFetchedStatus && connectFlow.configured) {
+            showReady();
+            return;
+        }
+        setScreen("connecting");
+        connectFlow.start({
+            trackingSource: "first_run_onboarding",
+            trackingFlow: "connect_llm",
+        });
+    };
+    const handleOpenSettings = async () => {
+        window.dispatchEvent(new CustomEvent("agent-panel:open-settings", {
+            detail: { section: "connections" },
+        }));
+        await completeFirstRun();
+    };
+    const handleFinish = async () => {
+        await completeFirstRun();
+    };
+    if (screen === "intro") {
+        return (_jsx(OnboardingShell, { profile: profile, screen: "intro", children: _jsxs("div", { className: "mx-auto flex w-full max-w-lg flex-col items-center text-center", children: [_jsxs("h1", { className: "text-3xl font-semibold tracking-[-0.05em] sm:text-4xl", children: ["Free forever.", _jsx("br", {}), _jsx("span", { className: "text-primary", children: "Open source for life." })] }), _jsxs("div", { className: "mt-7 grid w-full gap-2 text-left sm:grid-cols-3", children: [_jsxs("div", { className: "rounded-lg border border-border bg-card px-3 py-3", children: [_jsx("p", { className: "text-xs font-medium", children: "Fully customizable" }), _jsx("p", { className: "mt-1 text-[11px] leading-4 text-muted-foreground", children: "Change the UI, code, and behavior." })] }), _jsxs("div", { className: "rounded-lg border border-border bg-card px-3 py-3", children: [_jsx("p", { className: "text-xs font-medium", children: "Bring your own keys" }), _jsx("p", { className: "mt-1 text-[11px] leading-4 text-muted-foreground", children: "Use your own providers and accounts." })] }), _jsxs("div", { className: "rounded-lg border border-border bg-card px-3 py-3", children: [_jsx("p", { className: "text-xs font-medium", children: "Build your own" }), _jsx("p", { className: "mt-1 text-[11px] leading-4 text-muted-foreground", children: "Mix and match toolkit pieces in your own apps." })] })] }), _jsxs("button", { type: "button", className: cn(primaryButtonClass, "mt-6"), onClick: () => setScreen("choice"), children: ["Continue", _jsx(IconArrowRight, { size: 15 })] }), _jsxs("a", { href: "https://github.com/builderio/agent-native", target: "_blank", rel: "noreferrer", className: "mt-3 inline-flex items-center gap-1.5 text-xs text-muted-foreground transition-colors hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", children: [_jsx(IconBrandGithub, { size: 14 }), _jsx("span", { children: "View source" }), _jsx(IconExternalLink, { size: 13 })] })] }) }));
+    }
+    if (screen === "choice") {
+        return (_jsx(OnboardingShell, { profile: profile, screen: "choice", children: _jsxs("div", { className: "mx-auto flex w-full max-w-3xl flex-col gap-4", children: [_jsx("h1", { className: "text-center text-xl font-semibold tracking-[-0.04em] sm:text-2xl", children: "Choose your setup." }), _jsxs("div", { className: "grid gap-3 sm:grid-cols-2", children: [_jsxs("section", { className: "rounded-xl border border-primary/50 bg-primary/[0.06] p-4 shadow-sm", children: [_jsxs("div", { className: "flex items-start justify-between gap-3", children: [_jsxs("div", { children: [_jsx("h2", { className: "text-sm font-semibold", children: "Connect Builder.io" }), _jsxs("p", { className: "mt-1 max-w-xs text-xs leading-5 text-muted-foreground", children: ["One click connects", " ", _jsx("a", { href: "https://www.builder.io/", 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: "Builder.io's free tier" }), " ", "with the services this app needs."] })] }), _jsx(IconArrowRight, { className: "mt-0.5 text-primary", size: 17 })] }), _jsxs("div", { className: "mt-5 border-t border-primary/15 pt-3", children: [_jsx("p", { className: "text-[11px] font-medium text-muted-foreground", children: "Includes on the free tier" }), _jsxs("div", { className: "mt-2 flex flex-wrap items-center gap-x-1.5 gap-y-1 text-[11px]", children: [builderCapabilities.map((capability, index) => (_jsxs(React.Fragment, { children: [index > 0 && (_jsx("span", { "aria-hidden": "true", className: "text-muted-foreground", children: "\u00B7" })), _jsx("span", { children: capability.label })] }, capability.id))), _jsx("span", { "aria-hidden": "true", className: "text-muted-foreground", children: "\u00B7" }), _jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "text-primary underline-offset-2 hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "aria-label": `See ${BUILDER_MORE_SERVICES.length} more Builder.io services`, children: ["+", BUILDER_MORE_SERVICES.length, " more"] }) }), _jsxs(TooltipContent, { side: "top", className: "max-w-sm text-xs", children: [_jsx("p", { className: "font-medium", children: "Also included with Builder.io" }), _jsx("p", { className: "mt-1 leading-5", children: BUILDER_MORE_SERVICES.join(" · ") })] })] })] })] }), _jsxs("button", { type: "button", "data-testid": "first-run-connect-builder", className: cn(primaryButtonClass, "mt-5 w-full"), onClick: handleBuilder, children: ["Connect Builder.io", _jsx(IconArrowRight, { size: 15 })] })] }), _jsxs("div", { role: "button", tabIndex: 0, "aria-label": "Use my own keys", "data-testid": "first-run-use-own-keys", className: "rounded-xl border border-border bg-card p-4 text-left transition-colors hover:border-foreground/30 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: () => setScreen("manual"), onKeyDown: (event) => {
+                                    if (event.key !== "Enter" && event.key !== " ")
+                                        return;
+                                    event.preventDefault();
+                                    setScreen("manual");
+                                }, children: [_jsxs("div", { className: "flex items-start justify-between gap-3", children: [_jsxs("div", { children: [_jsx("h2", { className: "text-sm font-semibold", children: "Use my own keys" }), _jsx("p", { className: "mt-1 text-xs text-muted-foreground", children: "See what this app needs" })] }), _jsx(IconKey, { className: "text-muted-foreground", size: 17 })] }), _jsx(CapabilityList, { capabilities: profile.capabilities, compact: true, className: "mt-5 border-t border-border pt-3" })] })] })] }) }));
+    }
+    if (screen === "manual") {
+        return (_jsx(OnboardingShell, { profile: profile, screen: "choice", children: _jsxs("div", { className: "mx-auto flex w-full max-w-xl flex-col gap-4", children: [_jsxs("div", { children: [_jsx("button", { type: "button", className: "mb-4 text-xs text-muted-foreground hover:text-foreground", onClick: () => setScreen("choice"), children: "Back" }), _jsx("h1", { className: "text-xl font-semibold tracking-[-0.04em] sm:text-2xl", children: "Your keys" })] }), _jsxs("div", { className: "rounded-xl border border-border bg-card p-4", children: [_jsx(CapabilityList, { capabilities: profile.capabilities }), _jsxs("div", { className: "mt-5 flex flex-col-reverse gap-2 border-t border-border pt-4 sm:flex-row sm:justify-between", children: [_jsx("button", { type: "button", className: secondaryButtonClass, onClick: () => setScreen("choice"), children: "Back" }), _jsxs("button", { type: "button", className: primaryButtonClass, onClick: handleOpenSettings, children: ["Open key settings", _jsx(IconArrowRight, { size: 15 })] })] })] })] }) }));
+    }
+    if (screen === "connecting") {
+        return (_jsx(OnboardingShell, { profile: profile, screen: "choice", children: _jsxs("div", { className: "mx-auto flex w-full max-w-md flex-col items-center text-center", children: [_jsx("div", { className: "flex size-10 items-center justify-center rounded-full bg-primary/10 text-primary", children: _jsx(IconLoader2, { className: "animate-spin", size: 19 }) }), _jsx("h1", { className: "mt-5 text-xl font-semibold tracking-[-0.04em]", children: "Connecting Builder.io" }), _jsx("p", { className: "mt-2 text-sm text-muted-foreground", children: "Finish the one-click connection in the new window." }), _jsxs("div", { className: "mt-7 w-full rounded-xl border border-border bg-card p-4 text-left", children: [_jsxs("div", { className: "flex items-center justify-between gap-3", children: [_jsx(Skeleton, { className: "h-3 w-28" }), _jsx(Skeleton, { className: "h-5 w-16 rounded-full" })] }), _jsx(Skeleton, { className: "mt-4 h-8 w-full" }), _jsxs("div", { className: "mt-3 grid grid-cols-3 gap-2", children: [_jsx(Skeleton, { className: "h-7 w-full" }), _jsx(Skeleton, { className: "h-7 w-full" }), _jsx(Skeleton, { className: "h-7 w-full" })] })] }), connectFlow.error && (_jsxs("div", { className: "mt-4 flex flex-col items-center gap-2", children: [_jsx("p", { className: "text-xs text-destructive", children: connectFlow.error }), _jsx("button", { type: "button", className: secondaryButtonClass, onClick: () => setScreen("choice"), children: "Try again" })] }))] }) }));
+    }
+    return (_jsx(OnboardingShell, { profile: profile, screen: "choice", children: _jsxs("div", { className: "mx-auto flex w-full max-w-md flex-col items-center text-center", children: [_jsx("div", { className: "flex size-10 items-center justify-center rounded-full bg-primary/10 text-primary", children: _jsx(IconCheck, { size: 20 }) }), _jsx("h1", { className: "mt-5 text-xl font-semibold tracking-[-0.04em]", children: "Ready to go." }), _jsxs("button", { type: "button", "data-testid": "first-run-open-app", className: cn(primaryButtonClass, "mt-7"), onClick: handleFinish, children: ["Open app", _jsx(IconArrowRight, { size: 15 })] })] }) }));
+}
+function OnboardingShell({ profile, screen, children, }) {
+    return (_jsxs("div", { className: "fixed inset-0 z-[100] flex min-h-screen flex-col bg-background text-foreground", "data-onboarding-screen": screen, role: "dialog", "aria-modal": "true", "aria-label": `${profile?.appName ?? "Your app"} setup`, children: [_jsxs("header", { className: "flex items-center justify-between border-b border-border px-5 py-4 text-xs text-muted-foreground sm:px-8", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx("img", { src: appPath("/agent-native-icon-dark.svg"), alt: "", "aria-hidden": "true", className: "h-4 w-auto shrink-0" }), _jsx("span", { className: "font-medium text-foreground", children: profile?.appName ?? "Your app" })] }), _jsx("span", { children: screen === "intro" ? "1 / 2" : "2 / 2" })] }), _jsx("div", { className: "h-0.5 bg-muted", children: _jsx("div", { className: "h-full bg-primary transition-[width] duration-200", style: { width: screen === "intro" ? "50%" : "100%" } }) }), _jsx("main", { className: "flex min-h-0 flex-1 items-center overflow-y-auto px-5 py-10 sm:px-8", children: _jsx("div", { className: "mx-auto w-full max-w-3xl", children: children }) })] }));
+}
+function OnboardingSkeleton() {
+    return (_jsxs("div", { className: "fixed inset-0 z-[100] flex min-h-screen flex-col bg-background px-5 py-5 sm:px-8", "data-onboarding-loading": "true", "aria-busy": "true", children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx(Skeleton, { className: "h-4 w-20" }), _jsx(Skeleton, { className: "h-3 w-8" })] }), _jsx(Skeleton, { className: "mt-5 h-0.5 w-full" }), _jsxs("div", { className: "mx-auto flex w-full max-w-lg flex-1 flex-col items-center justify-center", children: [_jsx(Skeleton, { className: "h-10 w-64" }), _jsx(Skeleton, { className: "mt-3 h-10 w-52" }), _jsx(Skeleton, { className: "mt-7 h-3 w-44" }), _jsx(Skeleton, { className: "mt-7 h-10 w-24 rounded-lg" })] })] }));
+}
+function CapabilityList({ capabilities, compact = false, className, }) {
+    const visibleCapabilities = useMemo(() => (compact ? capabilities.slice(0, 4) : capabilities), [capabilities, compact]);
+    return (_jsxs("div", { className: cn("grid", className), children: [!compact && (_jsx("p", { className: "mb-2 text-xs font-medium text-muted-foreground", children: "Keys and connections" })), _jsx("div", { className: "divide-y divide-border", children: visibleCapabilities.map((capability) => (_jsx(CapabilityRow, { capability: capability, compact: compact }, capability.id))) })] }));
+}
+function CapabilityRow({ capability, compact, }) {
+    return (_jsxs("div", { className: cn("flex items-start justify-between gap-3", compact ? "py-2" : "py-3"), children: [_jsxs("div", { className: "min-w-0", children: [_jsxs("div", { className: "flex items-center gap-1.5", children: [_jsx("span", { className: cn("font-medium", compact ? "text-[11px]" : "text-sm"), children: capability.label }), _jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", "aria-label": `Why ${capability.label} is needed`, className: "inline-flex size-4 items-center justify-center rounded-full text-muted-foreground hover:text-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", onClick: (event) => event.stopPropagation(), onKeyDown: (event) => event.stopPropagation(), children: _jsx(IconInfoCircle, { size: 13 }) }) }), _jsx(TooltipContent, { side: "top", className: "max-w-xs text-xs", children: capability.why })] })] }), _jsx("p", { className: "mt-1 text-[11px] leading-4 text-muted-foreground", children: capability.keySummary })] }), _jsx("span", { className: cn("shrink-0 text-[10px] uppercase tracking-[0.08em]", capability.required ? "text-primary" : "text-muted-foreground"), children: capability.required ? "Required" : "Optional" })] }));
+}
+const primaryButtonClass = "inline-flex min-h-9 items-center justify-center gap-2 rounded-lg bg-primary px-4 text-xs font-medium text-primary-foreground shadow-sm transition-opacity hover:opacity-90 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring";
+const secondaryButtonClass = "inline-flex min-h-9 items-center justify-center gap-2 rounded-lg border border-border bg-background px-4 text-xs font-medium text-foreground transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring";
+//# sourceMappingURL=FirstRunOnboarding.js.map

package/dist/client/onboarding/first-run-enabled.d.ts

@@ -0,0 +1,2 @@
+export declare function isFirstRunOnboardingEnabled(env?: Record<string, string | boolean | undefined>): boolean;
+//# sourceMappingURL=first-run-enabled.d.ts.map

package/dist/client/onboarding/first-run-enabled.js

@@ -0,0 +1,9 @@
+const FIRST_RUN_ONBOARDING_ENV_KEY = "VITE_AGENT_NATIVE_FIRST_RUN_ONBOARDING";
+export function isFirstRunOnboardingEnabled(env = (import.meta.env ??
+    {})) {
+    const value = env[FIRST_RUN_ONBOARDING_ENV_KEY];
+    return (value === true ||
+        (typeof value === "string" &&
+            ["1", "true"].includes(value.trim().toLowerCase())));
+}
+//# sourceMappingURL=first-run-enabled.js.map

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

@@ -8,6 +8,7 @@ export { useOnboardingPreviewMode, ONBOARDING_PREVIEW_STORAGE_KEY, } from "./use
 export { OnboardingPanel } from "./OnboardingPanel.js";
 export { OnboardingBanner } from "./OnboardingBanner.js";
 export { SetupButton } from "./SetupButton.js";
-export type { OnboardingStep, OnboardingMethod, OnboardingMethodBadge, OnboardingFormField, OnboardingStepStatus, } from "../../onboarding/types.js";
+export { FirstRunOnboarding } from "./FirstRunOnboarding.js";
+export type { OnboardingStep, OnboardingMethod, OnboardingMethodBadge, OnboardingFormField, OnboardingStepStatus, OnboardingCapability, OnboardingAppProfile, } from "../../onboarding/types.js";
 export { registerOnboardingStep, listOnboardingSteps, } from "../../onboarding/registry.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/client/onboarding/index.js

@@ -8,5 +8,6 @@ export { useOnboardingPreviewMode, ONBOARDING_PREVIEW_STORAGE_KEY, } from "./use
 export { OnboardingPanel } from "./OnboardingPanel.js";
 export { OnboardingBanner } from "./OnboardingBanner.js";
 export { SetupButton } from "./SetupButton.js";
+export { FirstRunOnboarding } from "./FirstRunOnboarding.js";
 export { registerOnboardingStep, listOnboardingSteps, } from "../../onboarding/registry.js";
 //# sourceMappingURL=index.js.map

package/dist/client/onboarding/use-onboarding.d.ts

@@ -6,9 +6,10 @@
  * No polling — onboarding state changes are user-driven, so a poll loop just
  * burns the DB and amplifies transient network errors.
  */
-import type { OnboardingMethod, OnboardingStepStatus } from "../../onboarding/types.js";
+import type { OnboardingAppProfile, OnboardingMethod, OnboardingStepStatus } from "../../onboarding/types.js";
 export interface UseOnboardingResult {
     steps: OnboardingStepStatus[];
+    profile: OnboardingAppProfile | null;
     loading: boolean;
     error: string | null;
     /** Active step = first required+incomplete, else first incomplete. */
@@ -27,6 +28,10 @@ export interface UseOnboardingResult {
     dismiss: () => Promise<void>;
     /** Re-open the panel after dismissal. */
     reopen: () => Promise<void>;
+    /** True until the post-signup full-screen flow is completed. */
+    firstRun: boolean;
+    /** Clear the post-signup full-screen flow marker. */
+    completeFirstRun: () => Promise<void>;
 }
 export declare function useOnboarding(options?: {
     preview?: boolean;

package/dist/client/onboarding/use-onboarding.js

@@ -1,20 +1,31 @@
 import { useCallback, useEffect, useRef, useState } from "react";
+import { FIRST_RUN_ONBOARDING_COOKIE } from "../../shared/first-run-onboarding.js";
 import { agentNativePath } from "../api-path.js";
+function hasFirstRunCookie() {
+    if (typeof document === "undefined")
+        return false;
+    return document.cookie
+        .split(";")
+        .some((part) => part.trim().startsWith(`${FIRST_RUN_ONBOARDING_COOKIE}=`));
+}
 export function useOnboarding(options = {}) {
     const preview = options.preview === true;
     const [steps, setSteps] = useState([]);
+    const [profile, setProfile] = useState(null);
     const [loading, setLoading] = useState(true);
     const [error, setError] = useState(null);
     const [dismissed, setDismissed] = useState(false);
+    const [firstRun, setFirstRun] = useState(hasFirstRunCookie);
     const mountedRef = useRef(true);
     const fetchAll = useCallback(async () => {
         try {
             const stepsUrl = agentNativePath(preview
                 ? "/_agent-native/onboarding/steps?preview=1"
                 : "/_agent-native/onboarding/steps");
-            const [stepsRes, dismissRes] = await Promise.all([
+            const [stepsRes, dismissRes, profileRes] = await Promise.all([
                 fetch(stepsUrl),
                 fetch(agentNativePath("/_agent-native/onboarding/dismissed")),
+                fetch(agentNativePath("/_agent-native/onboarding/profile")),
             ]);
             if (!mountedRef.current)
                 return;
@@ -23,6 +34,10 @@ export function useOnboarding(options = {}) {
             }
             const stepsData = await stepsRes.json();
             setSteps(stepsData);
+            if (!profileRes.ok) {
+                throw new Error(`profile: ${profileRes.status}`);
+            }
+            setProfile((await profileRes.json()));
             if (dismissRes.ok) {
                 const d = (await dismissRes.json());
                 setDismissed(!!d.dismissed);
@@ -83,6 +98,22 @@ export function useOnboarding(options = {}) {
         });
         await fetchAll();
     }, [fetchAll]);
+    const completeFirstRun = useCallback(async () => {
+        const response = await fetch(agentNativePath("/_agent-native/onboarding/first-run/complete"), {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: "{}",
+        });
+        if (!response.ok) {
+            setError(`first-run completion: ${response.status}`);
+            return;
+        }
+        setFirstRun(false);
+        if (typeof window !== "undefined") {
+            window.dispatchEvent(new CustomEvent("agent-native:first-run-completed"));
+        }
+        await fetchAll();
+    }, [fetchAll]);
     const totalCount = steps.length;
     const completeCount = steps.filter((s) => s.complete).length;
     const allComplete = steps.filter((s) => s.required).every((s) => s.complete);
@@ -91,6 +122,7 @@ export function useOnboarding(options = {}) {
         null;
     return {
         steps,
+        profile,
         loading,
         error,
         currentStepId,
@@ -102,6 +134,8 @@ export function useOnboarding(options = {}) {
         complete,
         dismiss,
         reopen,
+        firstRun,
+        completeFirstRun,
     };
 }
 //# sourceMappingURL=use-onboarding.js.map

package/dist/client/route-state.js

@@ -1,6 +1,7 @@
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { useCallback, useEffect, useMemo, useRef } from "react";
 import { useLocation, useNavigate, } from "react-router";
+import { isWorkspaceAppPath } from "./api-path.js";
 import { deleteClientAppState, readClientAppState, setClientAppState, } from "./application-state.js";
 import { navigateWithAgentChatViewTransition, } from "./chat-view-transition.js";
 const SAFE_BROWSER_TAB_ID_RE = /^[A-Za-z0-9_-]{1,96}$/;
@@ -207,6 +208,15 @@ export function useAgentRouteState(options) {
             const resolvedOptions = typeof navigateOptions === "function"
                 ? navigateOptions(command)
                 : navigateOptions;
+            if (isWorkspaceAppPath(path)) {
+                if (resolvedOptions?.replace) {
+                    window.location.replace(path);
+                }
+                else {
+                    window.location.assign(path);
+                }
+                return;
+            }
             const transitionOptions = resolveAgentChatViewTransitionOption(options.agentChatViewTransition, command, path);
             const runNavigate = () => navigate(path, resolvedOptions);
             if (transitionOptions) {

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,10 +77,10 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
+    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
-    error?: undefined;
 }>>;
 //# sourceMappingURL=awareness.d.ts.map

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<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/connections/catalog.d.ts

@@ -1,5 +1,5 @@
 export type WorkspaceConnectionCapability = "search" | "import" | "messages" | "meetings" | "crm" | "code" | "docs";
-export type WorkspaceConnectionTemplateUse = "analytics" | "brain" | "calendar" | "clips" | "content" | "crm" | "design" | "dispatch" | "forms" | "mail" | "slides";
+export type WorkspaceConnectionTemplateUse = "analytics" | "brain" | "calendar" | "clips" | "content" | "crm" | "design" | "dispatch" | "factory" | "forms" | "mail" | "slides";
 export type WorkspaceConnectionProviderId = "slack" | "github" | "figma" | "notion" | "gmail" | "google_drive" | "hubspot" | "salesforce" | "jira" | "sentry" | "granola" | "clips" | "generic";
 export interface WorkspaceConnectionCredentialKey {
     key: string;
@@ -39,7 +39,7 @@ export declare const WORKSPACE_CONNECTION_PROVIDERS: readonly [{
         readonly required: true;
     }];
     readonly capabilities: readonly ["search", "import", "messages"];
-    readonly recommendedTemplateUses: readonly ["brain", "dispatch", "analytics"];
+    readonly recommendedTemplateUses: readonly ["brain", "dispatch", "analytics", "factory"];
 }, {
     readonly id: "github";
     readonly label: "GitHub";
@@ -57,7 +57,7 @@ export declare const WORKSPACE_CONNECTION_PROVIDERS: readonly [{
         readonly scopes: readonly ["repo", "read:org", "read:user", "user:email"];
     };
     readonly capabilities: readonly ["search", "import", "code", "docs"];
-    readonly recommendedTemplateUses: readonly ["brain", "analytics", "dispatch"];
+    readonly recommendedTemplateUses: readonly ["brain", "analytics", "dispatch", "factory"];
 }, {
     readonly id: "figma";
     readonly label: "Figma";
@@ -217,7 +217,7 @@ export declare const WORKSPACE_CONNECTION_PROVIDERS: readonly [{
         readonly scopes: readonly ["org:read", "project:read", "event:read", "team:read"];
     };
     readonly capabilities: readonly ["search", "import", "docs"];
-    readonly recommendedTemplateUses: readonly ["analytics", "brain", "dispatch"];
+    readonly recommendedTemplateUses: readonly ["analytics", "brain", "dispatch", "factory"];
 }, {
     readonly id: "granola";
     readonly label: "Granola";

package/dist/connections/catalog.js

@@ -15,7 +15,7 @@ export const WORKSPACE_CONNECTION_PROVIDERS = [
             },
         ],
         capabilities: ["search", "import", "messages"],
-        recommendedTemplateUses: ["brain", "dispatch", "analytics"],
+        recommendedTemplateUses: ["brain", "dispatch", "analytics", "factory"],
     }),
     defineWorkspaceConnectionProvider({
         id: "github",
@@ -36,7 +36,7 @@ export const WORKSPACE_CONNECTION_PROVIDERS = [
             scopes: ["repo", "read:org", "read:user", "user:email"],
         },
         capabilities: ["search", "import", "code", "docs"],
-        recommendedTemplateUses: ["brain", "analytics", "dispatch"],
+        recommendedTemplateUses: ["brain", "analytics", "dispatch", "factory"],
     }),
     defineWorkspaceConnectionProvider({
         id: "figma",
@@ -243,7 +243,7 @@ export const WORKSPACE_CONNECTION_PROVIDERS = [
             scopes: ["org:read", "project:read", "event:read", "team:read"],
         },
         capabilities: ["search", "import", "docs"],
-        recommendedTemplateUses: ["analytics", "brain", "dispatch"],
+        recommendedTemplateUses: ["analytics", "brain", "dispatch", "factory"],
     }),
     defineWorkspaceConnectionProvider({
         id: "granola",