@agent-native/core 0.169.0 → 0.170.0

package/dist/client/chat-first/apps-rail.js

@@ -44,7 +44,7 @@ function AppRows({ apps, defaultAppIds, activeAppId, layout, onDragStart, onDrop
             const pinned = layout.pinnedIds.includes(app.id);
             const index = orderedApps.indexOf(app);
             return (_jsxs(ContextMenu, { children: [_jsx(ContextMenuTrigger, { asChild: true, children: _jsxs("li", { draggable: true, "data-chat-first-app": true, "data-app-id": app.id, className: cn("group flex h-8 w-full min-w-0 items-center gap-1 rounded-md px-0 text-sm", active
-                                ? "font-medium text-sidebar-foreground"
+                                ? "bg-sidebar-accent font-medium text-sidebar-accent-foreground"
                                 : "text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onDragStart: (event) => {
                                 event.dataTransfer.effectAllowed = "move";
                                 onDragStart(app.id);
@@ -136,7 +136,7 @@ export const ChatFirstAppsRail = memo(function ChatFirstAppsRail({ apps, default
         return (_jsx(TooltipProvider, { children: _jsxs("section", { "data-chat-first-apps-rail": true, className: "flex flex-col items-center gap-1 px-1.5 pt-2", "aria-label": copy("workspaceApps"), children: [loading && apps.length === 0
                         ? [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "size-9 rounded-md" }, index)))
                         : visibleApps.map((app) => (_jsxs(Tooltip, { delayDuration: 0, children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", "data-chat-first-app": true, "data-app-id": app.id, className: cn("flex size-9 items-center justify-center rounded-md", activeAppId === app.id
-                                            ? "text-sidebar-foreground"
+                                            ? "bg-sidebar-accent text-sidebar-accent-foreground"
                                             : "text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground"), onClick: () => onOpenApp(app), "aria-label": copy("openApp", { name: app.name }), children: _jsx(ChatFirstRailAppIcon, { app: app, activeAppId: activeAppId, renderIcon: renderIcon }) }) }), _jsx(TooltipContent, { side: "right", children: app.name })] }, app.id))), onOpenAllApps ? (_jsxs(Tooltip, { delayDuration: 0, children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { type: "button", "data-chat-first-all-apps": true, className: "flex size-9 items-center justify-center rounded-md text-sidebar-foreground/70 hover:bg-sidebar-accent hover:text-sidebar-accent-foreground", onClick: onOpenAllApps, "aria-label": copy("allApps"), children: _jsx(IconApps, { size: 16, "aria-hidden": "true" }) }) }), _jsx(TooltipContent, { side: "right", children: copy("allApps") })] })) : null, error ? (_jsx("span", { className: "size-1.5 rounded-full bg-destructive", title: error, "aria-label": error })) : null] }) }));
     }
     return (_jsxs("section", { "data-chat-first-apps-rail": true, className: "mt-3 px-2 pb-2 pt-2", "aria-label": copy("workspaceApps"), children: [_jsxs("div", { className: "mb-1 flex items-center gap-1.5 px-2 text-[11px] font-medium text-sidebar-foreground/50", children: [_jsx("span", { children: copy("workspaceApps") }), _jsx("span", { className: "ml-auto", children: createTrigger })] }), loading && apps.length === 0 ? (_jsx("div", { className: "space-y-0.5 px-2", children: [0, 1, 2].map((index) => (_jsx(Skeleton, { className: "h-8 w-full rounded-md" }, index))) })) : apps.length === 0 ? (_jsxs("div", { className: "px-2", children: [_jsx("p", { className: "text-xs text-sidebar-foreground/55", children: copy("noWorkspaceApps") }), createAppTrigger ? (createTrigger) : onCreateApp ? (_jsxs("button", { type: "button", className: "mt-1 inline-flex h-6 items-center gap-1.5 rounded-md border border-sidebar-border px-2 text-xs text-sidebar-foreground/75 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onCreateApp, children: [_jsx(IconPlus, { size: 13, "aria-hidden": "true" }), copy("createApp")] })) : (createTrigger)] })) : (_jsx(AppRows, { apps: visibleApps, defaultAppIds: defaultAppIds, activeAppId: activeAppId, layout: layout, onDragStart: setDraggedAppId, onDrop: reorderApps, onDragEnd: () => setDraggedAppId(null), onOpenApp: onOpenApp, onRemoveApp: onRemoveApp, onTogglePinned: togglePinned, onMove: moveApp, renderIcon: renderIcon, copy: copy })), hasMoreApps || showAllApps ? (_jsxs("button", { type: "button", className: "mt-0.5 flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/50 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: () => setShowAllApps((value) => !value), children: [showAllApps ? (_jsx(IconChevronUp, { size: 14, "aria-hidden": "true" })) : (_jsx(IconChevronDown, { size: 14, "aria-hidden": "true" })), showAllApps ? copy("showLess") : copy("showMore")] })) : null, onOpenAllApps ? (_jsx("div", { className: "mt-1 border-t border-sidebar-border/60 pt-1", children: _jsxs("button", { type: "button", "data-chat-first-all-apps": true, className: "flex h-8 w-full items-center gap-2 rounded-md px-2 text-xs text-sidebar-foreground/55 hover:bg-sidebar-accent hover:text-sidebar-foreground", onClick: onOpenAllApps, children: [_jsx(IconApps, { size: 14, "aria-hidden": "true" }), _jsx("span", { children: copy("allApps") })] }) })) : null, error ? (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsxs("button", { type: "button", className: "mt-1 flex items-center gap-1 px-2 text-[10px] text-destructive/80", onClick: onRetry, "aria-label": error, children: [_jsx("span", { className: "size-1.5 rounded-full bg-destructive" }), onRetry ? copy("retry") : copy("appsLoadError")] }) }), _jsx(TooltipContent, { side: "right", children: error })] })) : null] }));

package/dist/client/chat-model-groups.d.ts

@@ -10,6 +10,18 @@ export interface ChatModelEngineEntry {
     supportedModels?: readonly string[];
     requiredEnvVars?: readonly string[];
     packageInstalled?: boolean;
+    /**
+     * Server-resolved readiness. The env-key fallback below cannot see
+     * vault-stored credentials or the deploy-injected Builder gateway lane, so
+     * an engine running on either is reported unconfigured without this.
+     *
+     * Undefined means the server could not resolve it — including a credential
+     * read that threw, reported in `configuredError`. That deliberately falls
+     * through to the env heuristic rather than reading as "needs an API key".
+     */
+    configured?: boolean;
+    /** Why readiness is unknown, when the server's lookup failed. */
+    configuredError?: string;
 }
 export interface BuildChatModelGroupsOptions {
     engines: readonly ChatModelEngineEntry[];

package/dist/client/chat-model-groups.js

@@ -143,8 +143,9 @@ export function buildChatModelGroups({ engines, configuredKeys, builderConnected
             engine: engine.name,
             label: engine.label,
             models: sortModelsByCost(addCurrentModel(engine.supportedModels ?? [], engine.name, currentEngineName, currentModel)),
-            configured: requiredEnvVars.length === 0 ||
-                requiredEnvVars.some((key) => configured.has(key)),
+            configured: engine.configured ??
+                (requiredEnvVars.length === 0 ||
+                    requiredEnvVars.some((key) => configured.has(key))),
         };
     })
         .filter((group) => group.models.length > 0);

package/dist/client/error-format.js

@@ -80,6 +80,18 @@ const KNOWN_CHAT_ERROR_KEYS = new Map([
         "No LLM provider is connected. Open this app's Manage agent > LLM, then connect Builder.io or add a provider key.",
         "agentChat.errorMessages.noProviderConnected",
     ],
+    [
+        "No LLM provider is connected. Open this app's Manage agent > LLM, then connect Builder.io (free tier available) or add a provider key.",
+        "agentChat.errorMessages.noProviderConnected",
+    ],
+    [
+        "No LLM provider is connected. Open Settings > Agent > AI providers, then connect Builder.io or add a provider key.",
+        "agentChat.errorMessages.noProviderConnected",
+    ],
+    [
+        "No LLM provider is connected. Open Settings > Agent > AI providers, then connect Builder.io (free tier available) or add a provider key.",
+        "agentChat.errorMessages.noProviderConnected",
+    ],
     [
         "The provider behind this model rejected the request. Pick a different model, then retry.",
         "agentChat.errorMessages.builderModelUnauthorized",

package/dist/client/integrations/GoogleProductLogo.d.ts

@@ -0,0 +1,5 @@
+import type { SVGProps } from "react";
+export type GoogleProduct = "calendar" | "docs" | "drive" | "gmail" | "sheets" | "slides";
+export declare function GoogleProductLogo({ product, className, ...props }: {
+    product: GoogleProduct;
+} & Omit<SVGProps<SVGSVGElement>, "children">): import("react").JSX.Element;

package/dist/client/integrations/GoogleProductLogo.js

@@ -0,0 +1,45 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const GOOGLE_MARK_COLORS = {
+    // guard:allow-raw-color - official Google product mark color
+    blue: "#4285F4",
+    // guard:allow-raw-color - official Google product mark color
+    blueDark: "#1A73E8",
+    // guard:allow-raw-color - official Google product mark color
+    blueLight: "#8AB4F8",
+    // guard:allow-raw-color - official Google product mark color
+    border: "#DADCE0",
+    // guard:allow-raw-color - official Google product mark color
+    green: "#34A853",
+    // guard:allow-raw-color - official Google product mark color
+    greenDark: "#188038",
+    // guard:allow-raw-color - official Google product mark color
+    red: "#EA4335",
+    // guard:allow-raw-color - official Google product mark color
+    yellow: "#FBBC04",
+    // guard:allow-raw-color - official Google product mark color
+    yellowDark: "#F9AB00",
+};
+const commonProps = {
+    viewBox: "0 0 24 24",
+    fill: "none",
+    xmlns: "http://www.w3.org/2000/svg",
+    "aria-hidden": true,
+    focusable: false,
+};
+export function GoogleProductLogo({ product, className, ...props }) {
+    const svgProps = { ...commonProps, className, ...props };
+    switch (product) {
+        case "gmail":
+            return (_jsxs("svg", { ...svgProps, children: [_jsx("path", { d: "M3.5 5.25h17A1.5 1.5 0 0 1 22 6.75v10.5a1.5 1.5 0 0 1-1.5 1.5h-17A1.5 1.5 0 0 1 2 17.25V6.75a1.5 1.5 0 0 1 1.5-1.5Z", fill: "white", stroke: GOOGLE_MARK_COLORS.border }), _jsx("path", { d: "m3 7 9 6.75L21 7", stroke: GOOGLE_MARK_COLORS.red, strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round" }), _jsx("path", { d: "M3 17.75V7m18 10.75V7", stroke: GOOGLE_MARK_COLORS.blue, strokeWidth: "2", strokeLinecap: "round" }), _jsx("path", { d: "m3 7 4.25 3.2", stroke: GOOGLE_MARK_COLORS.yellow, strokeWidth: "2", strokeLinecap: "round" }), _jsx("path", { d: "m21 7-4.25 3.2", stroke: GOOGLE_MARK_COLORS.green, strokeWidth: "2", strokeLinecap: "round" })] }));
+        case "calendar":
+            return (_jsxs("svg", { ...svgProps, children: [_jsx("rect", { x: "3", y: "4", width: "18", height: "17", rx: "2.5", fill: GOOGLE_MARK_COLORS.blue }), _jsx("path", { d: "M3 9h18", stroke: "white", strokeWidth: "2" }), _jsx("path", { d: "M7 3v3M17 3v3", stroke: GOOGLE_MARK_COLORS.blueDark, strokeWidth: "2", strokeLinecap: "round" }), _jsx("text", { x: "12", y: "17", textAnchor: "middle", fill: "white", fontFamily: "Arial, sans-serif", fontSize: "8", fontWeight: "700", children: "31" })] }));
+        case "drive":
+            return (_jsxs("svg", { ...svgProps, children: [_jsx("path", { d: "M8.1 3.5h4.65l8.45 14.65h-4.65L8.1 3.5Z", fill: GOOGLE_MARK_COLORS.yellow }), _jsx("path", { d: "M8.1 3.5 3.2 12l4.65 8.05 4.9-8.5L8.1 3.5Z", fill: GOOGLE_MARK_COLORS.green }), _jsx("path", { d: "M3.2 12h9.55l3.8 6.15H6.75L3.2 12Z", fill: GOOGLE_MARK_COLORS.blue })] }));
+        case "docs":
+            return (_jsxs("svg", { ...svgProps, children: [_jsx("path", { d: "M6 2.5h8l4 4v15H6a2 2 0 0 1-2-2v-15a2 2 0 0 1 2-2Z", fill: GOOGLE_MARK_COLORS.blue }), _jsx("path", { d: "M14 2.5v4h4", fill: GOOGLE_MARK_COLORS.blueLight }), _jsx("path", { d: "M8 11h8M8 14.5h8M8 18h5", stroke: "white", strokeWidth: "1.4", strokeLinecap: "round" })] }));
+        case "sheets":
+            return (_jsxs("svg", { ...svgProps, children: [_jsx("path", { d: "M6 2.5h8l4 4v15H6a2 2 0 0 1-2-2v-15a2 2 0 0 1 2-2Z", fill: GOOGLE_MARK_COLORS.green }), _jsx("path", { d: "M14 2.5v4h4", fill: GOOGLE_MARK_COLORS.greenDark }), _jsx("path", { d: "M8 10h8v8H8v-8Zm0 2.7h8M8 15.3h8M10.7 10v8", stroke: "white", strokeWidth: "1.2" })] }));
+        case "slides":
+            return (_jsxs("svg", { ...svgProps, children: [_jsx("path", { d: "M6 2.5h8l4 4v15H6a2 2 0 0 1-2-2v-15a2 2 0 0 1 2-2Z", fill: GOOGLE_MARK_COLORS.yellowDark }), _jsx("path", { d: "M14 2.5v4h4", fill: GOOGLE_MARK_COLORS.yellow }), _jsx("path", { d: "M8 17V11m3 6v-3m3 3v-7", stroke: "white", strokeWidth: "1.7", strokeLinecap: "round" })] }));
+    }
+}

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

@@ -1,6 +1,8 @@
 export { IntegrationsPanel, McpIntegrationsLanding, McpIntegrationsSection, type McpIntegrationsLandingProps, type McpIntegrationsSectionProps, } from "./IntegrationsPanel.js";
 export { IntegrationGrid, type IntegrationGridItem, type IntegrationGridProps, } from "./IntegrationGrid.js";
 export { IntegrationConnectionChoice, type IntegrationConnectionChoiceProps, } from "./IntegrationConnectionChoice.js";
+export { GoogleProductLogo, type GoogleProduct } from "./GoogleProductLogo.js";
+export { startWorkspaceProviderOAuth, workspaceProviderOAuthUrl, type WorkspaceProviderOAuthOptions, type WorkspaceProviderOAuthScope, } from "./workspace-provider-oauth.js";
 export { useIntegrationStatus } from "./useIntegrationStatus.js";
 export type { IntegrationStatus } from "./useIntegrationStatus.js";
 export { listIntegrationEnvStatuses, listIntegrationStatuses, saveIntegrationEnvVars, setIntegrationEnabled, setupIntegration, disconnectManagedIntegrationInstallation, listManagedIntegrationInstallations, managedIntegrationOAuthUrl, managedSlackAgentManifestUrl, listManagedIntegrationScopes, saveManagedIntegrationScope, listManagedIntegrationBudgets, listManagedIntegrationMemory, forgetManagedIntegrationMemory, saveManagedIntegrationBudget, testManagedIntegrationInstallation, IntegrationClientError, type ClientIntegrationInstallation, type ClientIntegrationScope, type ClientIntegrationUsageBudget, type ClientIntegrationMemory, type ClientIntegrationStatus, type IntegrationEnvStatus, type SavedEnvVarsResult, } from "./api.js";

package/dist/client/integrations/index.js

@@ -1,5 +1,7 @@
 export { IntegrationsPanel, McpIntegrationsLanding, McpIntegrationsSection, } from "./IntegrationsPanel.js";
 export { IntegrationGrid, } from "./IntegrationGrid.js";
 export { IntegrationConnectionChoice, } from "./IntegrationConnectionChoice.js";
+export { GoogleProductLogo } from "./GoogleProductLogo.js";
+export { startWorkspaceProviderOAuth, workspaceProviderOAuthUrl, } from "./workspace-provider-oauth.js";
 export { useIntegrationStatus } from "./useIntegrationStatus.js";
 export { listIntegrationEnvStatuses, listIntegrationStatuses, saveIntegrationEnvVars, setIntegrationEnabled, setupIntegration, disconnectManagedIntegrationInstallation, listManagedIntegrationInstallations, managedIntegrationOAuthUrl, managedSlackAgentManifestUrl, listManagedIntegrationScopes, saveManagedIntegrationScope, listManagedIntegrationBudgets, listManagedIntegrationMemory, forgetManagedIntegrationMemory, saveManagedIntegrationBudget, testManagedIntegrationInstallation, IntegrationClientError, } from "./api.js";

package/dist/client/integrations/workspace-provider-oauth.d.ts

@@ -0,0 +1,8 @@
+export type WorkspaceProviderOAuthScope = "user" | "organization" | "app";
+export interface WorkspaceProviderOAuthOptions {
+    appId: string;
+    returnPath?: string;
+    scope?: WorkspaceProviderOAuthScope;
+}
+export declare function workspaceProviderOAuthUrl(provider: string, options: WorkspaceProviderOAuthOptions): string;
+export declare function startWorkspaceProviderOAuth(provider: string, options: WorkspaceProviderOAuthOptions): void;

package/dist/client/integrations/workspace-provider-oauth.js

@@ -0,0 +1,13 @@
+import { agentNativePath } from "../api-path.js";
+export function workspaceProviderOAuthUrl(provider, options) {
+    const params = new URLSearchParams({
+        appId: options.appId,
+        scope: options.scope ?? "user",
+    });
+    if (options.returnPath)
+        params.set("return", options.returnPath);
+    return agentNativePath(`/_agent-native/connections/oauth/${provider}/start?${params.toString()}`);
+}
+export function startWorkspaceProviderOAuth(provider, options) {
+    window.location.assign(workspaceProviderOAuthUrl(provider, options));
+}

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

@@ -1,5 +1,6 @@
 export { agentNativePath, appApiPath, appBasePath, appPath, } from "../api-path.js";
 export { useAgentRouteState, useSemanticNavigationState, type AgentRouteLocation, type SemanticNavigationCommandEnvelope, type UseAgentRouteStateOptions, type UseAgentRouteStateResult, type UseSemanticNavigationStateOptions, type UseSemanticNavigationStateResult, } from "../route-state.js";
+export { AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE, postAgentNativeWorkspaceAppRoute, type AgentNativeWorkspaceAppRouteMessage, } from "../workspace-app-navigation.js";
 export { COMMAND_MENU_OPEN_EVENT, CommandMenu, openAgentSidebar, openAgentSettings, openCommandMenu, submitToAgent, useCommandMenuShortcut, type CommandMenuProps, type CommandMenuDoc, type CommandDocsGroupProps, type CommandGroupProps, type CommandItemProps, type CommandShortcutProps, } from "../CommandMenu.js";
 export { buildOpenRouteLink, buildOpenRoutePath, buildLegacyAgentSettingsRoute, buildResourceRoute, buildSettingsRoute, buildStandardAppRoute, buildTeamRoute, createStandardOpenPathResolver, STANDARD_APP_ROUTES, STANDARD_SETTINGS_TABS, type BuildResourceRouteOptions, type BuildStandardAppRouteOptions, type NavigationLink, type NavigationTarget, type StandardAppRouteId, type StandardOpenPathResolverOptions, type StandardOpenPathRoute, type StandardSettingsTabId, } from "../../navigation/index.js";
 export { postNavigate, isInAgentEmbed, AGENT_NAVIGATE_MESSAGE_TYPE, type AgentNavigateMessage, } from "../embed.js";

package/dist/client/navigation/index.js

@@ -1,5 +1,6 @@
 export { agentNativePath, appApiPath, appBasePath, appPath, } from "../api-path.js";
 export { useAgentRouteState, useSemanticNavigationState, } from "../route-state.js";
+export { AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE, postAgentNativeWorkspaceAppRoute, } from "../workspace-app-navigation.js";
 export { COMMAND_MENU_OPEN_EVENT, CommandMenu, openAgentSidebar, openAgentSettings, openCommandMenu, submitToAgent, useCommandMenuShortcut, } from "../CommandMenu.js";
 export { buildOpenRouteLink, buildOpenRoutePath, buildLegacyAgentSettingsRoute, buildResourceRoute, buildSettingsRoute, buildStandardAppRoute, buildTeamRoute, createStandardOpenPathResolver, STANDARD_APP_ROUTES, STANDARD_SETTINGS_TABS, } from "../../navigation/index.js";
 export { postNavigate, isInAgentEmbed, AGENT_NAVIGATE_MESSAGE_TYPE, } from "../embed.js";

package/dist/client/resources/mcp-integration-catalog.js

@@ -383,34 +383,6 @@ export const DEFAULT_MCP_INTEGRATIONS = [
             "Grafana Cloud",
         ],
     },
-    {
-        id: "google-workspace",
-        name: "Google Workspace",
-        provider: "google-workspace",
-        description: "Search Google Workspace data through its remote MCP server.",
-        descriptionKey: "mcpIntegrations.catalog.googleWorkspace.description",
-        useCase: "Workspace search across Gmail, Drive, Calendar, Chat, Docs, Sheets, Slides",
-        useCaseKey: "mcpIntegrations.catalog.googleWorkspace.useCase",
-        url: "https://workspacemcp.googleapis.com/mcp/v1",
-        authMode: "oauth",
-        connectionMode: "manual",
-        availability: "beta",
-        verification: "restricted",
-        logoUrl: mcpIntegrationLogo("google-workspace"),
-        docsUrl: "https://developers.google.com/workspace/guides/configure-mcp-servers",
-        setupNoteKey: "mcpIntegrations.catalog.googleWorkspace.setupNote",
-        brandAliases: ["Google", "Gmail", "Google Drive", "Google Calendar"],
-        keywords: [
-            "email",
-            "gmail",
-            "drive",
-            "calendar",
-            "chat",
-            "docs",
-            "sheets",
-            "slides",
-        ],
-    },
     {
         id: "gitlab",
         name: "GitLab",
@@ -900,7 +872,6 @@ const MCP_LINK_HOSTS = {
     sentry: ["sentry.io", "sentry.dev"],
     gong: ["gong.io"],
     grafana: ["grafana.com", "grafana.net"],
-    "google-workspace": ["google.com", "googleapis.com"],
     "builder-cms": ["builder.io"],
     notion: ["notion.so", "notion.site"],
     granola: ["granola.ai"],

package/dist/client/route-state.js

@@ -4,6 +4,7 @@ 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";
+import { postAgentNativeWorkspaceAppRoute } from "./workspace-app-navigation.js";
 const SAFE_BROWSER_TAB_ID_RE = /^[A-Za-z0-9_-]{1,96}$/;
 function normalizeBrowserTabId(browserTabId) {
     if (typeof browserTabId !== "string")
@@ -195,6 +196,11 @@ export function useAgentRouteState(options) {
     const location = useLocation();
     const navigate = useNavigate();
     const browserTabId = useMemo(() => normalizeBrowserTabId(options.browserTabId), [options.browserTabId]);
+    useEffect(() => {
+        if (options.enabled === false)
+            return;
+        postAgentNativeWorkspaceAppRoute(`${location.pathname}${location.search}${location.hash}`);
+    }, [location.hash, location.pathname, location.search, options.enabled]);
     const navigationKeys = useMemo(() => {
         const scopedKey = appStateKeyForBrowserTab(navigationKey, browserTabId);
         const keys = [scopedKey];

package/dist/client/settings/SettingsTabsPage.js

@@ -200,18 +200,22 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
         ? defaultTab
         : (tabs[0]?.id ?? "general");
     const tabGroups = useMemo(() => {
-        const groups = [];
+        // Keyed by group id so tabs sharing a group merge into one section even
+        // when another group's tabs sit between them in `tabs` — adjacency-only
+        // merging left same-id groups duplicated (and rendered with duplicate
+        // React keys) whenever the tab list interleaved groups.
+        const groupsById = new Map();
         for (const tab of tabs) {
             const groupId = tab.group ?? "app";
-            const previousGroup = groups.at(-1);
-            if (previousGroup?.id === groupId) {
-                previousGroup.tabs.push(tab);
+            const group = groupsById.get(groupId);
+            if (group) {
+                group.tabs.push(tab);
             }
             else {
-                groups.push({ id: groupId, tabs: [tab] });
+                groupsById.set(groupId, { id: groupId, tabs: [tab] });
             }
         }
-        return groups;
+        return Array.from(groupsById.values());
     }, [tabs]);
     const tabGroupLabels = {
         app: "Personal",

package/dist/client/sharing/ShareButton.js

@@ -133,7 +133,14 @@ function SharePanel(props) {
     const { controller } = props;
     const { inviteEmail, setInviteEmail: onInviteEmailChange, activeShareTab, handleShareTabChange, data, policy, visibility, canManage, role, setRole, notifyPeople, setNotifyPeople, shareMessage, setShareMessage, messageOpen, setMessageOpen, shareError, setShareError, suggestionsOpen, setSuggestionsOpen, inFlight, memberSearch, memberSuggestions, groupSuggestions, selectGroup, knownMembers, shares, handleVisibility, handleHideInSearch, handleAdd, handleChangeRole, handleRemove, } = controller;
     const hasInviteEmail = inviteEmail.trim().length > 0;
-    const isLoading = data === undefined;
+    // `data` stays undefined after a failed read, so a stuck skeleton is
+    // indistinguishable from loading unless the error comes off the query itself.
+    // `isError` alone is not that signal: it is also true when a refetch fails
+    // while React Query still holds usable data, and this panel refetches on open
+    // and after every mutation — blocking on that would swap a working panel for
+    // a retry screen on one transient failure.
+    const loadFailed = controller.sharesQuery.isError && data === undefined;
+    const isLoading = !loadFailed && data === undefined;
     const meta = visibilityMeta(visibility, t, props.visibilityCopy);
     const peopleAccessLabel = props.peopleAccessLabel ??
         t("agentChat.share.peopleWithAccess", {
@@ -151,7 +158,9 @@ function SharePanel(props) {
     const hasTabs = extraTabs.length > 0;
     const shareTabLabel = props.shareTabs?.shareLabel ??
         t("agentChat.share.shareLink", { defaultValue: "Share link" });
-    const sharePanel = isLoading ? (_jsxs("div", { children: [showShareLinks ? (_jsx("div", { className: "mb-4 h-9 rounded-md bg-muted animate-pulse" })) : null, _jsx("div", { className: "mb-2 text-sm font-semibold", children: generalAccessLabel }), _jsx("div", { className: "mb-4 h-9 rounded-md bg-muted animate-pulse" }), _jsx("div", { className: "mb-2 text-sm font-semibold", children: peopleAccessLabel }), _jsx("div", { className: "mb-4 h-7 rounded-md bg-muted animate-pulse" })] })) : (_jsxs("div", { children: [showShareLinks && shareUrlPlacement === "top" ? shareLinks : null, _jsxs("div", { className: "mb-4", children: [_jsx("div", { className: "mb-2 text-sm font-semibold", children: generalAccessLabel }), _jsxs("div", { className: "flex items-center gap-3", children: [_jsx("span", { "aria-hidden": true, className: "inline-flex h-9 w-9 shrink-0 items-center justify-center rounded-full bg-muted text-muted-foreground", children: _jsx(meta.Icon, { size: 16, strokeWidth: 1.75 }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx(VisibilitySelect, { value: visibility, onChange: handleVisibility, disabled: !canManage, visibilityCopy: props.visibilityCopy, allowPublic: policy.allowPublic }), _jsxs("div", { className: "mt-0.5 flex flex-wrap items-center gap-x-2 gap-y-1 text-xs text-muted-foreground", children: [_jsx("span", { className: "sr-only", children: meta.description }), visibility === "org" && props.hideInSearchControl ? (_jsx(AdvancedAccessPopover, { control: props.hideInSearchControl, canManage: canManage, onToggle: handleHideInSearch })) : null] })] })] })] }), _jsxs("div", { className: "mb-4 space-y-4", children: [_jsx("div", { className: "text-sm font-semibold", children: peopleAccessLabel }), canManage ? (_jsxs("div", { className: "space-y-2", children: [_jsxs("div", { className: "flex items-stretch gap-2", children: [_jsx(MemberAutocomplete, { value: inviteEmail, open: suggestionsOpen, onOpenChange: setSuggestionsOpen, onValueChange: (next) => {
+    const sharePanel = loadFailed ? (_jsxs("div", { children: [showShareLinks && shareUrlPlacement === "top" ? shareLinks : null, _jsxs("div", { role: "alert", className: "flex items-center justify-between gap-2 rounded-md border border-border bg-muted/30 px-3 py-2", children: [_jsx("span", { className: "text-xs text-muted-foreground", children: t("agentChat.share.loadFailed", {
+                            defaultValue: "Couldn't load sharing settings.",
+                        }) }), _jsx("button", { type: "button", onClick: () => controller.sharesQuery.refetch(), disabled: controller.sharesQuery.isFetching, className: cn(BUTTON_BASE, "h-7 px-2 text-xs text-muted-foreground hover:bg-accent hover:text-accent-foreground"), children: t("agentChat.common.retry") })] }), showShareLinks && shareUrlPlacement === "bottom" ? shareLinks : null] })) : isLoading ? (_jsxs("div", { children: [showShareLinks ? (_jsx("div", { className: "mb-4 h-9 rounded-md bg-muted animate-pulse" })) : null, _jsx("div", { className: "mb-2 text-sm font-semibold", children: generalAccessLabel }), _jsx("div", { className: "mb-4 h-9 rounded-md bg-muted animate-pulse" }), _jsx("div", { className: "mb-2 text-sm font-semibold", children: peopleAccessLabel }), _jsx("div", { className: "mb-4 h-7 rounded-md bg-muted animate-pulse" })] })) : (_jsxs("div", { children: [showShareLinks && shareUrlPlacement === "top" ? shareLinks : null, _jsxs("div", { className: "mb-4", children: [_jsx("div", { className: "mb-2 text-sm font-semibold", children: generalAccessLabel }), _jsxs("div", { className: "flex items-center gap-3", children: [_jsx("span", { "aria-hidden": true, className: "inline-flex h-9 w-9 shrink-0 items-center justify-center rounded-full bg-muted text-muted-foreground", children: _jsx(meta.Icon, { size: 16, strokeWidth: 1.75 }) }), _jsxs("div", { className: "min-w-0 flex-1", children: [_jsx(VisibilitySelect, { value: visibility, onChange: handleVisibility, disabled: !canManage, visibilityCopy: props.visibilityCopy, allowPublic: policy.allowPublic }), _jsxs("div", { className: "mt-0.5 flex flex-wrap items-center gap-x-2 gap-y-1 text-xs text-muted-foreground", children: [_jsx("span", { className: "sr-only", children: meta.description }), visibility === "org" && props.hideInSearchControl ? (_jsx(AdvancedAccessPopover, { control: props.hideInSearchControl, canManage: canManage, onToggle: handleHideInSearch })) : null] })] })] })] }), _jsxs("div", { className: "mb-4 space-y-4", children: [_jsx("div", { className: "text-sm font-semibold", children: peopleAccessLabel }), canManage ? (_jsxs("div", { className: "space-y-2", children: [_jsxs("div", { className: "flex items-stretch gap-2", children: [_jsx(MemberAutocomplete, { value: inviteEmail, open: suggestionsOpen, onOpenChange: setSuggestionsOpen, onValueChange: (next) => {
                                             onInviteEmailChange(next);
                                             if (shareError)
                                                 setShareError(null);

package/dist/client/use-chat-models.d.ts

@@ -24,6 +24,12 @@ interface Options {
      */
     enabled?: boolean;
 }
+/**
+ * `useChatModels` takes the raw localStorage key while `MultiTabAssistantChat`
+ * takes only the namespace suffix — a surface that hand-writes either one stops
+ * sharing the selection with the chat it sits next to.
+ */
+export declare function chatModelSelectionStorageKey(namespace?: string | null): string;
 export declare const CHAT_MODEL_SELECTION_CHANGED_EVENT = "agent-native:chat-model-selection-changed";
 /**
  * Fetches available engines/models from the agent server and exposes the same

package/dist/client/use-chat-models.js

@@ -5,6 +5,16 @@ import { buildChatModelGroups, } from "./chat-model-groups.js";
 import { fetchBuilderStatus, fetchEnvironmentStatus, } from "./client-status-requests.js";
 import { callAction } from "./use-action.js";
 const DEFAULT_STORAGE_KEY = "agent-native:chat-models:selection";
+/**
+ * `useChatModels` takes the raw localStorage key while `MultiTabAssistantChat`
+ * takes only the namespace suffix — a surface that hand-writes either one stops
+ * sharing the selection with the chat it sits next to.
+ */
+export function chatModelSelectionStorageKey(namespace) {
+    return namespace
+        ? `${DEFAULT_STORAGE_KEY}:${namespace}`
+        : DEFAULT_STORAGE_KEY;
+}
 export const CHAT_MODEL_SELECTION_CHANGED_EVENT = "agent-native:chat-model-selection-changed";
 const MODEL_DISCOVERY_RETRY_DELAYS_MS = [250, 1_000];
 async function fetchEngineCatalog() {

package/dist/client/use-db-sync.js

@@ -1,6 +1,7 @@
 import { useEffect, useRef, useState } from "react";
 import { ensureDemoModeFetchInterceptor } from "../demo/fetch-interceptor.js";
 import { parseHandshakeFrame, parseTokenFrame, REALTIME_PROTOCOL_VERSION, REALTIME_SSE_HANDSHAKE_EVENT, REALTIME_SSE_TOKEN_EVENT, } from "../realtime-protocol.js";
+import { addSurfaceVisibilityListener, isHostSurfaceHidden, isSurfaceHidden, } from "../shared/surface-visibility.js";
 import { agentNativePath } from "./api-path.js";
 import { getBrowserTabId } from "./browser-tab-id.js";
 import { ensureEmbedAuthFetchInterceptor, isEmbedAuthActive, } from "./embed-auth.js";
@@ -103,7 +104,7 @@ function getPollAbortMs(interval) {
     return Math.max(POLL_ABORT_MIN_MS, interval * 4);
 }
 function isDocumentHidden() {
-    return (typeof document !== "undefined" && document.visibilityState === "hidden");
+    return isSurfaceHidden();
 }
 function resolveSseUrl(sseUrl) {
     if (sseUrl === false)
@@ -269,6 +270,7 @@ class SyncTransport {
     subscribers = new Map();
     cursorRef = { ...INITIAL_SYNC_CURSOR };
     timer = null;
+    removeVisibilityListener;
     stopped = false;
     inFlight = false;
     eventSource = null;
@@ -470,6 +472,17 @@ class SyncTransport {
     // -------------------------------------------------------------------------
     // Derived settings (aggregate over active subscribers)
     // -------------------------------------------------------------------------
+    /**
+     * Whether this transport must do nothing at all right now. A host that has
+     * stashed the surface off screen is a stronger statement than a backgrounded
+     * browser tab, so it pauses regardless of `pauseWhenHidden` — an embedder
+     * only sets it for a surface the user genuinely cannot see.
+     */
+    shouldStayIdle() {
+        if (isHostSurfaceHidden())
+            return true;
+        return this.effectivePauseWhenHidden && isDocumentHidden();
+    }
     get effectivePauseWhenHidden() {
         // Pause only if every subscriber has opted in.
         for (const sub of this.subscribers.values()) {
@@ -550,7 +563,7 @@ class SyncTransport {
     schedulePoll() {
         if (this.stopped)
             return;
-        if (this.effectivePauseWhenHidden && isDocumentHidden())
+        if (this.shouldStayIdle())
             return;
         if (this.timer)
             clearTimeout(this.timer);
@@ -743,7 +756,7 @@ class SyncTransport {
         if (this.stopped ||
             this.eventSource ||
             typeof EventSource === "undefined" ||
-            (this.effectivePauseWhenHidden && isDocumentHidden())) {
+            this.shouldStayIdle()) {
             return;
         }
         // One tab per origin holds the stream; the rest follow it over
@@ -896,6 +909,10 @@ class SyncTransport {
     async poll() {
         if (this.stopped || this.inFlight)
             return;
+        // Re-checked here, not only at the schedule sites: whatever path
+        // reached poll(), a host-hidden surface must not issue a request.
+        if (this.shouldStayIdle())
+            return;
         this.inFlight = true;
         try {
             if (this.mode === "hosted" && this.gateway && !this.token) {
@@ -947,7 +964,7 @@ class SyncTransport {
         }
     }
     pollNow() {
-        if (this.effectivePauseWhenHidden && isDocumentHidden())
+        if (this.shouldStayIdle())
             return;
         if (this.authFailureDelayMs() > 0) {
             this.schedulePoll();
@@ -961,11 +978,11 @@ class SyncTransport {
         void this.poll();
     }
     handleVisibilityChange = () => {
-        if (document.visibilityState === "visible") {
+        if (!isSurfaceHidden()) {
             this.connectEvents();
             this.pollNow();
         }
-        else if (this.effectivePauseWhenHidden) {
+        else if (this.shouldStayIdle()) {
             this.closeEvents();
             // A hidden leader stops streaming, so it must not keep holding the
             // origin's stream slot — that would leave every visible tab following a
@@ -1030,13 +1047,13 @@ class SyncTransport {
         // already mounts useDbSync, so this needs zero per-template wiring.
         ensureEmbedAuthFetchInterceptor();
         ensureDemoModeFetchInterceptor();
-        if (!this.effectivePauseWhenHidden || !isDocumentHidden()) {
+        if (!this.shouldStayIdle()) {
             this.connectEvents();
             void this.poll();
         }
         window.addEventListener("focus", this.handleFocus);
         window.addEventListener("agentNative.chatRunning", this.handleChatRunning);
-        document.addEventListener("visibilitychange", this.handleVisibilityChange);
+        this.removeVisibilityListener = addSurfaceVisibilityListener(this.handleVisibilityChange);
     }
     teardown() {
         this.stopped = true;
@@ -1060,7 +1077,8 @@ class SyncTransport {
         }
         window.removeEventListener("focus", this.handleFocus);
         window.removeEventListener("agentNative.chatRunning", this.handleChatRunning);
-        document.removeEventListener("visibilitychange", this.handleVisibilityChange);
+        this.removeVisibilityListener?.();
+        this.removeVisibilityListener = undefined;
     }
 }
 /**

package/dist/client/workspace-app-navigation.d.ts

@@ -0,0 +1,10 @@
+export declare const AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE: "agent-native:workspace-app-route";
+export interface AgentNativeWorkspaceAppRouteMessage {
+    type: typeof AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE;
+    path: string;
+}
+/**
+ * Report an app-local route to its immediate embedding host. The host checks
+ * the iframe source and origin before applying the route to its own URL.
+ */
+export declare function postAgentNativeWorkspaceAppRoute(path: string): boolean;

package/dist/client/workspace-app-navigation.js

@@ -0,0 +1,38 @@
+export const AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE = "agent-native:workspace-app-route";
+function normalizeWorkspaceAppRoute(path) {
+    if (typeof path !== "string" ||
+        !path.startsWith("/") ||
+        path.startsWith("//")) {
+        return null;
+    }
+    if (/[\u0000-\u001f\u007f]/.test(path))
+        return null;
+    try {
+        const url = new URL(path, "http://agent-native.invalid");
+        return `${url.pathname}${url.search}${url.hash}`;
+    }
+    catch {
+        // coercion-ok: malformed route input is not reported to the host.
+        return null;
+    }
+}
+/**
+ * Report an app-local route to its immediate embedding host. The host checks
+ * the iframe source and origin before applying the route to its own URL.
+ */
+export function postAgentNativeWorkspaceAppRoute(path) {
+    if (typeof window === "undefined")
+        return false;
+    const parentWindow = window.parent;
+    if (!parentWindow || parentWindow === window)
+        return false;
+    const normalizedPath = normalizeWorkspaceAppRoute(path);
+    if (!normalizedPath)
+        return false;
+    const message = {
+        type: AGENT_NATIVE_WORKSPACE_APP_ROUTE_MESSAGE_TYPE,
+        path: normalizedPath,
+    };
+    parentWindow.postMessage(message, "*");
+    return true;
+}

package/dist/collab/struct-routes.d.ts

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;