@agent-native/core 0.141.6 → 0.141.7

package/dist/client/settings/SettingsTabsPage.js

@@ -1,8 +1,9 @@
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Tabs, useDesignSystem } from "@agent-native/toolkit/design-system";
-import { IconArrowLeft, IconArrowUpRight, IconHistory, IconSearch, IconSettings, IconUserCircle, IconUsers, IconX, } from "@tabler/icons-react";
+import { IconArrowUpRight, IconHistory, IconSearch, IconSettings, IconUserCircle, IconUsers, IconX, } from "@tabler/icons-react";
 import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
 import { Link } from "react-router";
+import { buildSettingsRoute } from "../../navigation/index.js";
 import { cn } from "../utils.js";
 function normalizeTabId(value) {
     let decoded = value?.replace(/^#/, "").trim() ?? "";
@@ -61,17 +62,52 @@ function resolveTabId(tabs, value) {
     }
     return null;
 }
-function activeTabFromHash(tabs, defaultTab) {
+function activeTabFromLocation(tabs, defaultTab) {
     if (typeof window === "undefined")
         return defaultTab;
+    const settingsPrefix = "/settings";
+    if (window.location.pathname === settingsPrefix) {
+        return resolveTabId(tabs, window.location.hash) ?? defaultTab;
+    }
+    if (window.location.pathname.startsWith(`${settingsPrefix}/`)) {
+        const segments = window.location.pathname
+            .slice(`${settingsPrefix}/`.length)
+            .split("/")
+            .filter(Boolean)
+            .map((segment) => {
+            try {
+                return decodeURIComponent(segment);
+            }
+            catch {
+                return segment;
+            }
+        });
+        for (let length = segments.length; length > 0; length -= 1) {
+            const tabId = resolveTabId(tabs, segments.slice(0, length).join(":"));
+            if (tabId)
+                return tabId;
+        }
+    }
     return resolveTabId(tabs, window.location.hash) ?? defaultTab;
 }
-function updateHashForTab(tabId) {
+function buildSettingsEntryRoute(tabId, section) {
+    const normalizedSection = section?.replace(/^#/, "").trim();
+    if (!normalizedSection || normalizedSection === tabId) {
+        return buildSettingsRoute(tabId);
+    }
+    if (normalizedSection.startsWith("agent:")) {
+        return buildSettingsRoute(normalizedSection);
+    }
+    if (normalizedSection.startsWith(`${tabId}:`)) {
+        return buildSettingsRoute(normalizedSection);
+    }
+    return buildSettingsRoute(`${tabId}:${normalizedSection}`);
+}
+function updateRouteForTab(tabId, section) {
     if (typeof window === "undefined")
         return;
-    const { pathname, search } = window.location;
-    const hash = tabId === "general" ? "" : `#${tabId}`;
-    window.history.pushState(null, "", `${pathname}${search}${hash}`);
+    const route = buildSettingsEntryRoute(tabId, section);
+    window.history.pushState(null, "", `${route}${window.location.search}`);
 }
 function isEditableElement(element) {
     if (!(element instanceof HTMLElement))
@@ -82,7 +118,7 @@ function isEditableElement(element) {
         tagName === "select" ||
         element.isContentEditable);
 }
-export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs = [], generalLabel = "General", accountLabel = "Account", teamLabel = "Team", whatsNewLabel = "What's new", ariaLabel = "Settings sections", defaultTab = "integrations", className, navClassName, contentClassName, enableSearch = true, searchPlaceholder = "Search settings", searchEntries, generalSearchEntries, value, onValueChange, }) {
+export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs = [], generalLabel = "General", accountLabel = "Account", teamLabel = "Team", whatsNewLabel = "What's new", ariaLabel = "Settings sections", defaultTab = "general", className, navClassName, contentClassName, enableSearch = true, searchPlaceholder = "Search settings", searchEntries, generalSearchEntries, value, onValueChange, }) {
     const rootRef = useRef(null);
     const searchInputRef = useRef(null);
     const autoFocusedSearchRef = useRef(false);
@@ -166,7 +202,7 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
         agent: "Agent",
     };
     const isControlled = value !== undefined;
-    const [internalTab, setInternalTab] = useState(() => activeTabFromHash(tabs, fallbackTab));
+    const [internalTab, setInternalTab] = useState(() => activeTabFromLocation(tabs, fallbackTab));
     const activeTab = isControlled ? value : internalTab;
     const [query, setQuery] = useState("");
     const designSystem = useDesignSystem();
@@ -186,39 +222,55 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
         setInternalTab(fallbackTab);
     }, [fallbackTab, internalTab, isControlled, tabs]);
     useEffect(() => {
-        // Hash-driven tab tracking only applies to the uncontrolled mode. Only
-        // react to hashes that name a top-level tab. Section-level hashes
-        // (e.g. `#llm`, `#secrets`) are consumed by the inner panels, so leave
-        // the active tab untouched to avoid bouncing back to General.
         if (isControlled)
             return;
-        const handleHashChange = () => {
-            const fromHash = resolveTabId(tabs, window.location.hash);
-            if (fromHash) {
-                setInternalTab(fromHash);
-            }
+        const syncLocation = () => {
+            const fromPath = activeTabFromLocation(tabs, fallbackTab);
+            if (fromPath)
+                setInternalTab(fromPath);
+            if (window.location.pathname.startsWith("/settings/"))
+                return;
+            const hashValue = window.location.hash.replace(/^#/, "");
+            const fromHash = resolveTabId(tabs, hashValue);
+            if (!fromHash || !hashValue)
+                return;
+            const isTabHash = fromHash === hashValue;
+            updateRouteForTab(fromHash, isTabHash ? undefined : hashValue);
+        };
+        syncLocation();
+        window.addEventListener("hashchange", syncLocation);
+        window.addEventListener("popstate", syncLocation);
+        return () => {
+            window.removeEventListener("hashchange", syncLocation);
+            window.removeEventListener("popstate", syncLocation);
         };
-        window.addEventListener("hashchange", handleHashChange);
-        return () => window.removeEventListener("hashchange", handleHashChange);
-    }, [isControlled, tabs]);
+    }, [fallbackTab, isControlled, tabs]);
     useEffect(() => {
-        // Controlled pages retain ownership of their active state, but shared
-        // organization navigation uses a hash deep link. Report only recognized
-        // top-level tab hashes; section hashes remain available to inner panels.
         if (!isControlled)
             return;
-        const syncControlledHash = () => {
-            const hash = window.location.hash;
-            const fromHash = resolveTabId(tabs, hash);
-            if (!fromHash || controlledHashRef.current === hash)
+        const syncControlledLocation = () => {
+            const fromPath = window.location.pathname.startsWith("/settings/")
+                ? activeTabFromLocation(tabs, defaultTab)
+                : null;
+            const hashValue = window.location.hash.replace(/^#/, "");
+            const fromHash = hashValue ? resolveTabId(tabs, hashValue) : null;
+            const next = fromPath ?? fromHash;
+            const key = `${window.location.pathname}${window.location.hash}`;
+            if (!next || next === value || controlledHashRef.current === key) {
+                controlledHashRef.current = key;
                 return;
-            controlledHashRef.current = hash;
-            onValueChange?.(fromHash);
+            }
+            controlledHashRef.current = key;
+            onValueChange?.(next);
+        };
+        syncControlledLocation();
+        window.addEventListener("hashchange", syncControlledLocation);
+        window.addEventListener("popstate", syncControlledLocation);
+        return () => {
+            window.removeEventListener("hashchange", syncControlledLocation);
+            window.removeEventListener("popstate", syncControlledLocation);
         };
-        syncControlledHash();
-        window.addEventListener("hashchange", syncControlledHash);
-        return () => window.removeEventListener("hashchange", syncControlledHash);
-    }, [isControlled, onValueChange, tabs, value]);
+    }, [defaultTab, isControlled, onValueChange, tabs, value]);
     useEffect(() => {
         if (!enableSearch || autoFocusedSearchRef.current)
             return;
@@ -306,24 +358,24 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
         setQuery("");
         if (typeof window === "undefined")
             return;
-        const hash = entry.hash?.replace(/^#/, "");
-        if (hash) {
-            const { pathname, search } = window.location;
-            window.history.pushState(null, "", `${pathname}${search}#${hash}`);
+        const section = entry.hash?.replace(/^#/, "");
+        if (section) {
+            updateRouteForTab(entry.tabId, section);
             // Let the inner panels open + scroll to their section.
+            window.dispatchEvent(new Event("popstate"));
             window.dispatchEvent(new Event("hashchange"));
             window.requestAnimationFrame(() => {
                 document
-                    .getElementById(hash)
+                    .getElementById(section)
                     ?.scrollIntoView({ block: "start", behavior: "smooth" });
             });
         }
         else if (!isControlled) {
-            updateHashForTab(entry.tabId);
+            updateRouteForTab(entry.tabId);
         }
     };
     const searching = enableSearch && trimmedQuery.length > 0;
-    return (_jsxs("div", { ref: rootRef, className: cn("flex h-full min-h-0 w-full flex-col overflow-hidden bg-background sm:flex-row", className), children: [_jsxs("div", { className: cn("flex shrink-0 flex-col gap-2 bg-background p-2 sm:min-h-0 sm:w-60 sm:overflow-y-auto sm:p-4", navClassName), children: [_jsxs("a", { href: "/", className: "flex min-h-8 items-center gap-2 rounded-md px-2 text-sm text-muted-foreground transition-colors hover:bg-accent/50 hover:text-foreground", children: [_jsx(IconArrowLeft, { className: "size-4 shrink-0 rtl:-scale-x-100" }), _jsx("span", { children: "Back to app" })] }), enableSearch ? (_jsxs("div", { className: "relative sm:mb-2", children: [_jsx(IconSearch, { className: "pointer-events-none absolute start-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { ref: searchInputRef, type: "search", value: query, onChange: (event) => setQuery(event.target.value), onKeyDown: (event) => {
+    return (_jsxs("div", { ref: rootRef, className: cn("flex h-full min-h-0 w-full flex-col overflow-hidden bg-background sm:flex-row", className), children: [_jsxs("div", { className: cn("flex shrink-0 flex-col gap-2 bg-background p-2 sm:min-h-0 sm:w-60 sm:overflow-y-auto sm:p-4", navClassName), children: [enableSearch ? (_jsxs("div", { className: "relative sm:mb-2", children: [_jsx(IconSearch, { className: "pointer-events-none absolute start-2.5 top-1/2 size-3.5 -translate-y-1/2 text-muted-foreground" }), _jsx("input", { ref: searchInputRef, type: "search", value: query, onChange: (event) => setQuery(event.target.value), onKeyDown: (event) => {
                                     if (event.key === "Escape")
                                         setQuery("");
                                     if (event.key === "Enter" && results[0]) {
@@ -333,11 +385,12 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
                                 }, placeholder: searchPlaceholder, "aria-label": searchPlaceholder, className: "h-8 w-full rounded-md border border-border bg-background ps-8 pe-7 text-[13px] text-foreground outline-none transition-colors placeholder:text-muted-foreground focus:border-foreground/30 focus:ring-2 focus:ring-accent/40" }), query ? (_jsx("button", { type: "button", onClick: () => setQuery(""), "aria-label": "Clear search", className: "absolute end-1.5 top-1/2 flex size-5 -translate-y-1/2 items-center justify-center rounded text-muted-foreground hover:bg-accent/60 hover:text-foreground", children: _jsx(IconX, { className: "size-3.5" }) })) : null] })) : null, searching ? (_jsx("div", { role: "listbox", "aria-label": "Settings search results", className: "flex flex-col gap-0.5", children: results.length === 0 ? (_jsx("p", { className: "px-2 py-6 text-center text-[12px] text-muted-foreground", children: "No matching settings" })) : (results.map((entry) => {
                             const Icon = entry.icon;
                             const tab = tabs.find((candidate) => candidate.id === entry.tabId);
+                            const entryHash = entry.hash?.replace(/^#/, "");
                             const resultHref = tab?.href
-                                ? entry.hash
-                                    ? `${tab.href.split("#", 1)[0]}#${entry.hash.replace(/^#/, "")}`
+                                ? entryHash
+                                    ? buildSettingsEntryRoute(entry.tabId, entryHash)
                                     : tab.href
-                                : null;
+                                : buildSettingsEntryRoute(entry.tabId, entryHash);
                             const result = (_jsxs(_Fragment, { children: [Icon ? (_jsx(Icon, { className: "mt-0.5 size-4 shrink-0 text-muted-foreground" })) : null, _jsxs("span", { className: "flex min-w-0 flex-col", children: [_jsx("span", { className: "truncate font-medium", children: entry.label }), _jsx("span", { className: "truncate text-[11px] text-muted-foreground", children: entry.description ?? entry.tabLabel })] })] }));
                             return resultHref ? (_jsx(Link, { to: resultHref, role: "option", "aria-selected": false, className: "flex items-start gap-2 rounded-md px-2.5 py-2 text-start text-sm text-foreground transition-colors hover:bg-accent/60", children: result }, entry.id)) : (_jsx("button", { type: "button", role: "option", "aria-selected": false, onClick: () => selectEntry(entry), className: "flex items-start gap-2 rounded-md px-2.5 py-2 text-start text-sm text-foreground transition-colors hover:bg-accent/60", children: result }, entry.id));
                         })) })) : hasCustomTabs ? (_jsx(Tabs, { items: tabs.map((tab) => ({
@@ -351,7 +404,7 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
                             const nextTab = String(tabId);
                             changeTab(nextTab);
                             if (!isControlled)
-                                updateHashForTab(nextTab);
+                                updateRouteForTab(nextTab);
                         }, orientation: "vertical", "aria-label": ariaLabel, className: "flex gap-1 overflow-x-auto sm:flex-col sm:overflow-x-visible" })) : (_jsx("nav", { "aria-label": ariaLabel, role: "tablist", className: "flex gap-1 overflow-x-auto sm:flex-col sm:overflow-x-visible", children: tabGroups.map((group, groupIndex) => (_jsx("div", { "data-settings-tab-group": group.id, className: cn("contents sm:block", groupIndex > 0 && "sm:mt-3 sm:pt-1"), children: _jsxs("div", { className: "contents sm:flex sm:flex-col sm:gap-1", children: [_jsx("div", { className: "hidden px-3 pb-1 pt-1 text-[11px] font-medium text-muted-foreground sm:block", children: tabGroupLabels[group.id] ?? group.id }), group.tabs.map((tab) => {
                                         const Icon = tab.icon;
                                         const selected = tab.id === selectedTab?.id;
@@ -366,7 +419,7 @@ export function SettingsTabsPage({ general, account, team, whatsNew, extraTabs =
                                         return (_jsx("button", { type: "button", role: "tab", "aria-selected": selected, "aria-controls": `settings-tabpanel-${tab.id}`, id: `settings-tab-${tab.id}`, onClick: () => {
                                                 changeTab(tab.id);
                                                 if (!isControlled)
-                                                    updateHashForTab(tab.id);
+                                                    updateRouteForTab(tab.id);
                                             }, className: cn("flex min-h-9 shrink-0 items-center gap-2 rounded-md px-3 py-2 text-start text-sm font-medium transition-colors sm:w-full", selected
                                                 ? "bg-accent text-foreground"
                                                 : "text-muted-foreground hover:bg-accent/50 hover:text-foreground"), children: tabContent }, tab.id));

package/dist/client/settings/VoiceTranscriptionSection.js

@@ -13,6 +13,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Picker, Switch } from "@agent-native/toolkit/design-system";
 import { IconAlertCircle, IconCheck, IconChevronDown, IconChevronRight, IconExternalLink, IconLoader2, IconLockOpen, } from "@tabler/icons-react";
 import { useCallback, useEffect, useState } from "react";
+import { buildSettingsRoute } from "../../navigation/index.js";
 import { agentNativePath } from "../api-path.js";
 import { SettingsRow } from "./SettingsRow.js";
 import { openBuilderConnectPopup, useBuilderStatus, } from "./useBuilderStatus.js";
@@ -221,7 +222,8 @@ export function VoiceTranscriptionSection({ compact = false, } = {}) {
     const focusKey = (key) => {
         if (typeof window === "undefined")
             return;
-        window.location.hash = `#secrets:${key}`;
+        window.history.pushState(null, "", buildSettingsRoute(`integrations:secrets:${key}`));
+        window.dispatchEvent(new Event("popstate"));
     };
     const chooseSource = (next) => {
         if (next === transcriptionMode)
@@ -266,6 +268,9 @@ export function VoiceTranscriptionSection({ compact = false, } = {}) {
         }
     };
     if (transcriptionMode === null) {
+        if (compact) {
+            return (_jsx(SettingsRow, { label: "Voice transcription", description: "Choose how voice input is transcribed.", control: _jsx("div", { className: "h-9 w-44 animate-pulse rounded-md border border-border bg-muted-foreground/10", "aria-label": "Loading voice transcription" }) }));
+        }
         return (_jsxs("div", { className: "flex items-center gap-1.5 text-[10px] text-muted-foreground", children: [_jsx(IconLoader2, { size: 10, className: "animate-spin" }), "Loading\u2026"] }));
     }
     if (compact) {

package/dist/client/settings/useSettingsPanelController.js

@@ -34,13 +34,35 @@ function firstVisibleSection(sections) {
         return "llm";
     return sections[0] ?? "llm";
 }
+function settingsPathParts() {
+    if (typeof window === "undefined")
+        return [];
+    const pathParts = window.location.pathname.split("/").filter(Boolean);
+    const settingsIndex = pathParts.indexOf("settings");
+    return settingsIndex === -1 ? [] : pathParts.slice(settingsIndex + 1);
+}
+function secretKeyFromPath(pathParts) {
+    const secretsIndex = pathParts.findIndex((part) => part.toLowerCase() === "secrets");
+    if (secretsIndex === -1)
+        return undefined;
+    const key = pathParts.slice(secretsIndex + 1).join("/");
+    return key || undefined;
+}
 function initialOpenSection(sections) {
     const hashSection = typeof window === "undefined"
         ? null
         : normalizeSettingsSection(window.location.hash);
-    return hashSection && sections.includes(hashSection)
-        ? hashSection
-        : firstVisibleSection(sections);
+    if (hashSection && sections.includes(hashSection))
+        return hashSection;
+    if (typeof window !== "undefined") {
+        const routeParts = settingsPathParts();
+        for (let index = routeParts.length - 1; index >= 0; index -= 1) {
+            const pathSection = normalizeSettingsSection(routeParts[index]);
+            if (pathSection && sections.includes(pathSection))
+                return pathSection;
+        }
+    }
+    return firstVisibleSection(sections);
 }
 export function useSettingsPanelController({ sections = ALL_SETTINGS_SECTIONS, initialSection, sectionRequestKey, onScrollToSection, } = {}) {
     const visibleSections = useMemo(() => new Set(sections), [sections]);
@@ -72,23 +94,40 @@ export function useSettingsPanelController({ sections = ALL_SETTINGS_SECTIONS, i
     useEffect(() => {
         if (typeof window === "undefined")
             return;
-        const handleHashChange = () => {
+        const handleLocationChange = () => {
             const hash = window.location.hash?.replace(/^#/, "") ?? "";
-            const section = normalizeSettingsSection(hash);
+            let section = normalizeSettingsSection(hash);
+            const pathParts = settingsPathParts();
+            if (!section) {
+                for (let index = pathParts.length - 1; index >= 0; index -= 1) {
+                    const pathSection = normalizeSettingsSection(pathParts[index]);
+                    if (pathSection) {
+                        section = pathSection;
+                        break;
+                    }
+                }
+            }
             if (!section || !isSectionVisible(section))
                 return;
             if (hash.startsWith("secrets:") || hash === "secrets") {
                 const key = hash.slice("secrets:".length);
                 setFocusSecretKey(key || undefined);
             }
+            else if (section === "secrets") {
+                setFocusSecretKey(secretKeyFromPath(pathParts));
+            }
             else {
                 setFocusSecretKey(undefined);
             }
             openSettingsSection(section, { scroll: true });
         };
-        handleHashChange();
-        window.addEventListener("hashchange", handleHashChange);
-        return () => window.removeEventListener("hashchange", handleHashChange);
+        handleLocationChange();
+        window.addEventListener("hashchange", handleLocationChange);
+        window.addEventListener("popstate", handleLocationChange);
+        return () => {
+            window.removeEventListener("hashchange", handleLocationChange);
+            window.removeEventListener("popstate", handleLocationChange);
+        };
     }, [isSectionVisible, openSettingsSection]);
     return {
         sections,

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;

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

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

package/dist/ingestion/website.d.ts

@@ -15,6 +15,36 @@ export interface WebsiteDesignTokens {
     spacing: string[];
     radii: string[];
     cssVariables: Record<string, string>;
+    /**
+     * Semantic roles are inferred from visible rendered elements, not from
+     * variable names. They are optional so static HTML callers can keep their
+     * smaller result without inventing values that were never observed.
+     */
+    semanticColors?: Partial<Record<"primary" | "secondary" | "accent" | "background" | "surface" | "text" | "textMuted", string>>;
+    shadows?: string[];
+    backgrounds?: string[];
+    components?: Array<{
+        role: "heading" | "body" | "button" | "link" | "card" | "input" | "nav" | "hero";
+        fontFamily?: string;
+        fontSize?: string;
+        fontWeight?: string;
+        lineHeight?: string;
+        letterSpacing?: string;
+        color?: string;
+        backgroundColor?: string;
+        backgroundImage?: string;
+        border?: string;
+        borderRadius?: string;
+        boxShadow?: string;
+        padding?: string;
+        gap?: string;
+        textTransform?: string;
+    }>;
+    layout?: {
+        contentWidth?: string;
+        pagePadding?: string;
+        sectionGap?: string;
+    };
 }
 export interface WebsiteExtraction {
     title: string;

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

@@ -904,6 +904,11 @@ declare const messages: {
         addYourOwn: string;
         noMatches: string;
         connected: string;
+        connectionError: string;
+        connectionErrorReason: string;
+        reconnect: string;
+        reconnecting: string;
+        reconnectFailed: string;
         configure: string;
         connect: string;
         connectWithOAuth: string;

package/dist/localization/default-messages.js

@@ -909,6 +909,11 @@ const messages = {
         addYourOwn: "Add your own",
         noMatches: "No integrations match that search.",
         connected: "Connected",
+        connectionError: "Connection error",
+        connectionErrorReason: "Reason: {{reason}}",
+        reconnect: "Reconnect",
+        reconnecting: "Reconnecting…",
+        reconnectFailed: "Reconnect failed: {{error}}",
         configure: "Configure",
         connect: "Connect",
         connectWithOAuth: "Connect",

package/dist/mcp-client/oauth-routes.js

@@ -190,7 +190,7 @@ async function handleMcpOAuthCallback(event, options) {
         }
         await options.reconfigure();
         const returnPath = flow.returnUrl ??
-            `/settings?connected=mcp-${encodeURIComponent(flow.name)}#integrations`;
+            `/settings/integrations?connected=mcp-${encodeURIComponent(flow.name)}`;
         return redirectWithStagedCookies(event, getAppUrl(event, returnPath));
     }
     catch {

package/dist/mcp-client/routes.d.ts

@@ -9,6 +9,7 @@
  *   POST   /_agent-native/mcp/servers           add a server
  *   DELETE /_agent-native/mcp/servers/:id       remove a server (scope via ?scope=)
  *   POST   /_agent-native/mcp/servers/:id/test  dry-run connect (no persist)
+ *   POST   /_agent-native/mcp/servers/:id/reconnect retry connect + refresh
  *   POST   /_agent-native/mcp/servers/test      dry-run a URL before persisting
  *   GET    /_agent-native/mcp/builtin           list built-in capability toggles
  *   POST   /_agent-native/mcp/builtin           update built-in capability toggles

package/dist/mcp-client/routes.js

@@ -9,6 +9,7 @@
  *   POST   /_agent-native/mcp/servers           add a server
  *   DELETE /_agent-native/mcp/servers/:id       remove a server (scope via ?scope=)
  *   POST   /_agent-native/mcp/servers/:id/test  dry-run connect (no persist)
+ *   POST   /_agent-native/mcp/servers/:id/reconnect retry connect + refresh
  *   POST   /_agent-native/mcp/servers/test      dry-run a URL before persisting
  *   GET    /_agent-native/mcp/builtin           list built-in capability toggles
  *   POST   /_agent-native/mcp/builtin           update built-in capability toggles
@@ -63,6 +64,15 @@ function projectForClient(stored, scope, ownerId, status) {
         status,
     };
 }
+function reconnectStatusForClient(manager, mergedId) {
+    const status = statusFor(manager, mergedId);
+    if (status.state !== "error")
+        return status;
+    return {
+        state: "error",
+        error: formatMcpConnectError(status.error),
+    };
+}
 function statusFor(manager, mergedId) {
     const snap = manager.getStatus();
     if (snap.connectedServers.includes(mergedId)) {
@@ -328,6 +338,11 @@ export function mountMcpServersRoutes(nitroApp, manager, options = {}) {
                 if (parts.length === 2 && parts[1] === "test" && method === "POST") {
                     return handleTestExisting(event, manager, id);
                 }
+                if (parts.length === 2 &&
+                    parts[1] === "reconnect" &&
+                    method === "POST") {
+                    return handleReconnectExisting(event, manager, id);
+                }
                 if (parts.length === 1 && method === "DELETE") {
                     return handleDelete(event, manager, id);
                 }
@@ -803,6 +818,40 @@ async function handleTestExisting(event, _manager, id) {
     }
     return { ok: true, toolCount: result.toolCount, tools: result.tools };
 }
+async function handleReconnectExisting(event, manager, id) {
+    const scope = getQuery(event).scope;
+    const parsedScope = scope === "org" ? "org" : scope === "user" ? "user" : null;
+    if (!parsedScope) {
+        setResponseStatus(event, 400);
+        return { error: 'scope query param must be "user" or "org"' };
+    }
+    const { email, orgId } = await resolveContextForRequest(event);
+    let scopeId = null;
+    if (parsedScope === "user") {
+        scopeId = email;
+    }
+    else {
+        scopeId = orgId;
+    }
+    if (!scopeId) {
+        setResponseStatus(event, 401);
+        return { error: "Authentication required" };
+    }
+    const list = await listRemoteServers(parsedScope, scopeId);
+    const server = list.find((s) => s.id === id);
+    if (!server) {
+        setResponseStatus(event, 404);
+        return { error: "Server not found" };
+    }
+    await reconfigureManager(manager);
+    const mergedId = mergedConfigKey(parsedScope, server, scopeId);
+    const status = reconnectStatusForClient(manager, mergedId);
+    const projected = projectForClient(server, parsedScope, scopeId, status);
+    return {
+        ok: true,
+        server: projected,
+    };
+}
 async function tryConnect(url, headers) {
     try {
         const { Client, StreamableHTTPClientTransport } = await import("@modelcontextprotocol/client");

package/dist/navigation/index.js

@@ -22,12 +22,22 @@ function normalizeLeadingPath(path) {
     return `/${trimmed.replace(/^\/+/, "").replace(/\/+$/, "")}`;
 }
 function normalizeTabId(tab) {
-    return tab
+    const normalized = tab
         .trim()
         .replace(/^#/, "")
         .toLowerCase()
         .replace(/['"]/g, "")
         .replace(/[\s_]+/g, "-");
+    if (normalized === "connections")
+        return "integrations";
+    if (normalized === "team" || normalized === "org")
+        return "organization";
+    if (normalized === "changelog" ||
+        normalized === "what-s-new" ||
+        normalized === "updates") {
+        return "whats-new";
+    }
+    return normalized;
 }
 function pathSegment(value) {
     return encodeURIComponent(value.trim().replace(/^\/+|\/+$/g, ""));
@@ -40,10 +50,11 @@ function resolveOpenPathRoute(route, params) {
 export function buildSettingsRoute(tab, basePath = STANDARD_APP_ROUTES.settings) {
     const path = normalizeLeadingPath(basePath);
     const normalizedTab = tab ? normalizeTabId(tab) : null;
-    if (!normalizedTab || normalizedTab === STANDARD_SETTINGS_TABS.general) {
-        return path;
-    }
-    return `${path}#${encodeURIComponent(normalizedTab)}`;
+    const segments = (normalizedTab || STANDARD_SETTINGS_TABS.general)
+        .split(":")
+        .map((segment) => pathSegment(segment))
+        .filter(Boolean);
+    return `${path}/${segments.join("/")}`;
 }
 export function buildTeamRoute(options = {}) {
     return options.teamInSettings

package/dist/observability/routes.d.ts

@@ -41,27 +41,27 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
-    error?: undefined;
-    ok?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
-} | {
     error?: undefined;
     ok?: undefined;
+} | {
     summary?: undefined;
     spans?: undefined;
     id: string;
-} | {
+    error?: undefined;
     ok?: undefined;
+} | {
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
     error: any;
+    ok?: undefined;
 } | {
-    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;

package/dist/progress/routes.d.ts

@@ -15,6 +15,6 @@ export declare function createProgressHandler(): import("h3").EventHandlerWithFe
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>>;