@agent-native/core 0.146.4 → 0.146.5

package/corpus/templates/tasks/app/routes/agent.tsx

@@ -1,4 +1,5 @@
-import { AgentTabsPage } from "@agent-native/core/client/agent-chat";
+import { buildLegacyAgentSettingsRoute } from "@agent-native/core/client/navigation";
+import { Navigate, useLocation } from "react-router";
 
 import { APP_TITLE } from "@/lib/app-config";
 
@@ -7,5 +8,12 @@ export function meta() {
 }
 
 export default function AgentRoute() {
-  return <AgentTabsPage appName={APP_TITLE} />;
+  const location = useLocation();
+
+  return (
+    <Navigate
+      to={buildLegacyAgentSettingsRoute(location.hash, location.search)}
+      replace
+    />
+  );
 }

package/dist/client/index.d.ts

@@ -13,7 +13,7 @@ export { AgentNativeI18nProvider, LanguagePicker, getLocaleInitScript, localeDir
 export { AgentNativeIcon } from "./components/icons/AgentNativeIcon.js";
 export { FeatureFlagsEditor, evaluatedFeatureFlagValues, featureFlagValue, useFeatureFlag, useFeatureFlags, type FeatureFlagActor, type FeatureFlagMetadata, type FeatureFlagRules, type SetFeatureFlagInput, } from "./feature-flags/index.js";
 export { withBuilderUtmTrackingParams } from "../shared/builder-link-tracking.js";
-export { SettingsPanel, SettingsTabsPage, SecretsSection, getAgentSettingsSearchTabs, openBuilderConnectPopup, useAgentSettingsTabs, useBuilderConnectFlow, useBuilderStatus, withBuilderConnectTrackingParams, type BuilderConnectFlow, type BuilderConnectFlowOptions, type BuilderConnectStartOptions, type BuilderStatus, type AgentSettingsSearchTab, type OpenBuilderConnectPopupOptions, type SecretsSectionProps, type SettingsPanelProps, type SettingsSearchEntry, type SettingsTabItem, type SettingsTabsPageProps, } from "./settings/index.js";
+export { SettingsPanel, SettingsTabsPage, SecretsSection, getAgentSettingsSearchTabs, openBuilderConnectPopup, useAgentSettingsTabs, type AgentSettingsTabFactory, type AgentSettingsTabFactoryContext, useBuilderConnectFlow, useBuilderStatus, withBuilderConnectTrackingParams, type BuilderConnectFlow, type BuilderConnectFlowOptions, type BuilderConnectStartOptions, type BuilderStatus, type AgentSettingsSearchTab, type OpenBuilderConnectPopupOptions, type SecretsSectionProps, type SettingsPanelProps, type SettingsSearchEntry, type SettingsTabItem, type SettingsTabsPageProps, } from "./settings/index.js";
 export { DevDatabaseLink, type DevDatabaseLinkProps, } from "./db-admin/DevDatabaseLink.js";
 export { DbAdminPage } from "./db-admin/DbAdminPage.js";
 export { installRouteChunkRecovery, reloadForStaleChunk, recoverFromStaleChunkError, } from "./route-chunk-recovery.js";

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

@@ -1,5 +1,5 @@
 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 { 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, 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 { 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,5 @@
 export { agentNativePath, appApiPath, appBasePath, appPath, } from "../api-path.js";
 export { useAgentRouteState, useSemanticNavigationState, } from "../route-state.js";
 export { COMMAND_MENU_OPEN_EVENT, CommandMenu, openAgentSidebar, openAgentSettings, openCommandMenu, submitToAgent, useCommandMenuShortcut, } from "../CommandMenu.js";
-export { buildOpenRouteLink, buildOpenRoutePath, buildResourceRoute, buildSettingsRoute, buildStandardAppRoute, buildTeamRoute, createStandardOpenPathResolver, STANDARD_APP_ROUTES, STANDARD_SETTINGS_TABS, } from "../../navigation/index.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/org/OrgSwitcher.js

@@ -32,7 +32,7 @@ const SWITCHER_BUTTON_CLASS = "flex w-full items-center gap-2 rounded-md border-
 const COMPACT_SWITCHER_BUTTON_CLASS = "flex items-center justify-center rounded-md border-0 bg-accent/50 p-1.5 text-muted-foreground hover:bg-accent/70 hover:text-foreground focus:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-60 cursor-pointer";
 const DEFAULT_ORGANIZATION_SETTINGS_PATH = "/settings/organization";
 const DEFAULT_PROFILE_PATH = "/settings/account";
-const DEFAULT_AGENT_PATH = "/agent";
+const DEFAULT_AGENT_PATH = "/settings/agent";
 const APP_ICON_MAP = {
     Mail: IconMail,
     CalendarDays: IconCalendar,

package/dist/client/settings/SettingsPanel.d.ts

@@ -26,7 +26,15 @@ export interface AgentSettingsTabsOptions {
     extensionTools?: boolean;
     /** Optional page-level settings to show in the Agent section. */
     agentAdditionalContent?: React.ReactNode;
+    /** Optional app-owned tabs that share the Agent settings scope. */
+    agentAdditionalTabFactories?: AgentSettingsTabFactory[];
 }
+export interface AgentSettingsTabFactoryContext {
+    scope: "user";
+    canManageOrg?: boolean;
+    scopeControl: React.ReactNode;
+}
+export type AgentSettingsTabFactory = (context: AgentSettingsTabFactoryContext) => SettingsTabItem;
 export declare function areExtensionSettingsEnabled(options?: AgentSettingsTabsOptions): boolean;
 export declare function SettingsPanel(props: SettingsPanelProps): React.JSX.Element;
 export declare function ConnectionsSettingsContent({ settingsPanelProps, }: {

package/dist/client/settings/SettingsPanel.js

@@ -13,6 +13,7 @@ import { BuilderBMark } from "../builder-mark.js";
 import { Popover, PopoverContent, PopoverTrigger, } from "../components/ui/popover.js";
 import { Tooltip, TooltipContent, TooltipTrigger, } from "../components/ui/tooltip.js";
 import { useT } from "../i18n.js";
+import { useOrg } from "../org/hooks.js";
 import { TeamPage } from "../org/TeamPage.js";
 import { BuilderConnectCard } from "../setup-connections/BuilderConnectCard.js";
 import { callAction } from "../use-action.js";
@@ -1073,8 +1074,11 @@ export function AgentSettingsContent({ className, sections = AGENT_SETTINGS_SECT
 }
 export function useAgentSettingsTabs(options = {}) {
     const { isDevMode, canToggle, setDevMode } = useDevMode();
+    const { data: org } = useOrg();
+    const canManageOrg = !org?.orgId || org.role === "owner" || org.role === "admin";
     const extensionToolsEnabled = areExtensionSettingsEnabled(options);
     const agentAdditionalContent = options.agentAdditionalContent;
+    const agentAdditionalTabFactories = options.agentAdditionalTabFactories ?? [];
     const baseProps = useMemo(() => ({
         isDevMode,
         onToggleDevMode: () => {
@@ -1082,6 +1086,11 @@ export function useAgentSettingsTabs(options = {}) {
         },
         showDevToggle: canToggle,
     }), [canToggle, isDevMode, setDevMode]);
+    const additionalTabs = useMemo(() => agentAdditionalTabFactories.map((factory) => factory({
+        scope: "user",
+        canManageOrg,
+        scopeControl: null,
+    })), [agentAdditionalTabFactories, canManageOrg]);
     return useMemo(() => {
         const searchTabs = getAgentSettingsSearchTabs();
         const searchTab = (id) => {
@@ -1247,6 +1256,12 @@ export function useAgentSettingsTabs(options = {}) {
                 ],
                 content: _jsx(AgentWorkspaceContent, { activeTab: "agents", overview: null }),
             },
+            ...additionalTabs,
         ];
-    }, [agentAdditionalContent, baseProps, extensionToolsEnabled]);
+    }, [
+        agentAdditionalContent,
+        additionalTabs,
+        baseProps,
+        extensionToolsEnabled,
+    ]);
 }

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

@@ -1,4 +1,4 @@
-export { AgentSettingsContent, areExtensionSettingsEnabled, SettingsPanel, useAgentSettingsTabs, type AgentSettingsTabsOptions, type SettingsPanelProps, } from "./SettingsPanel.js";
+export { AgentSettingsContent, areExtensionSettingsEnabled, SettingsPanel, useAgentSettingsTabs, type AgentSettingsTabFactory, type AgentSettingsTabFactoryContext, type AgentSettingsTabsOptions, type SettingsPanelProps, } from "./SettingsPanel.js";
 export { getAgentSettingsSearchTabs, type AgentSettingsSearchTab, } from "./agent-settings-search.js";
 export { SettingsTabsPage, type SettingsSearchEntry, type SettingsTabItem, type SettingsTabsPageProps, } from "./SettingsTabsPage.js";
 export { AccountSettingsCard, AccountSettingsForm, type AccountSettingsCardProps, type AccountSettingsFormProps, } from "./AccountSettingsCard.js";

package/dist/collab/awareness.d.ts

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

package/dist/navigation/index.d.ts

@@ -38,6 +38,7 @@ export interface StandardOpenPathResolverOptions {
     fallback?: StandardOpenPathRoute;
 }
 export declare function buildSettingsRoute(tab?: StandardSettingsTabId | string | null, basePath?: "/settings"): string;
+export declare function buildLegacyAgentSettingsRoute(hash?: string | null, search?: string): string;
 export declare function buildTeamRoute(options?: Pick<BuildStandardAppRouteOptions, "teamInSettings">): string;
 export declare function buildStandardAppRoute(route: StandardAppRouteId, options?: BuildStandardAppRouteOptions): string;
 export declare function buildResourceRoute(collection: string, resourceId: string, options?: BuildResourceRouteOptions): string;

package/dist/navigation/index.js

@@ -15,6 +15,21 @@ export const STANDARD_SETTINGS_TABS = {
     language: "language",
     whatsNew: "whats-new",
 };
+const LEGACY_AGENT_RESOURCE_TABS = new Set([
+    "files",
+    "instructions",
+    "agents",
+    "memory",
+    "skills",
+    "learnings",
+]);
+const LEGACY_AGENT_SETTINGS_TABS = new Set([
+    "llm",
+    "app-models",
+    "limits",
+    "voice",
+    "background",
+]);
 function normalizeLeadingPath(path) {
     const trimmed = path.trim();
     if (!trimmed || trimmed === "/")
@@ -56,6 +71,25 @@ export function buildSettingsRoute(tab, basePath = STANDARD_APP_ROUTES.settings)
         .filter(Boolean);
     return `${path}/${segments.join("/")}`;
 }
+export function buildLegacyAgentSettingsRoute(hash, search = "") {
+    const legacyTab = hash?.replace(/^#/, "").toLowerCase() ?? "";
+    const destination = LEGACY_AGENT_RESOURCE_TABS.has(legacyTab)
+        ? buildSettingsRoute(`agent:resources:${legacyTab}`)
+        : legacyTab === "remote-agents"
+            ? buildSettingsRoute("agent:agents")
+            : legacyTab === "connections"
+                ? buildSettingsRoute("connections")
+                : legacyTab === "jobs"
+                    ? buildSettingsRoute("agent:automations")
+                    : legacyTab === "library"
+                        ? buildSettingsRoute("library")
+                        : legacyTab === "access"
+                            ? buildSettingsRoute("agent")
+                            : LEGACY_AGENT_SETTINGS_TABS.has(legacyTab)
+                                ? buildSettingsRoute(`agent:${legacyTab}`)
+                                : buildSettingsRoute("agent");
+    return `${destination}${search}`;
+}
 export function buildTeamRoute(options = {}) {
     return options.teamInSettings
         ? buildSettingsRoute(STANDARD_SETTINGS_TABS.team)

package/dist/notifications/routes.d.ts

@@ -13,13 +13,13 @@
 export declare function createNotificationsHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<"" | import("./types.js").Notification[] | {
     count: number;
     updated?: undefined;
-    ok?: undefined;
     error?: undefined;
+    ok?: undefined;
 } | {
     count?: undefined;
     updated: number;
-    ok?: undefined;
     error?: undefined;
+    ok?: undefined;
 } | {
     count?: undefined;
     updated?: undefined;
@@ -28,6 +28,6 @@ export declare function createNotificationsHandler(): import("h3").EventHandlerW
 } | {
     count?: undefined;
     updated?: undefined;
-    ok: boolean;
     error?: undefined;
+    ok: boolean;
 }>>;

package/dist/observability/routes.d.ts

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

package/dist/server/transcribe-voice.d.ts

@@ -20,6 +20,6 @@ export declare function createTranscribeVoiceHandler(): import("h3").EventHandle
     error: string;
     text?: undefined;
 } | {
-    error?: undefined;
     text: string;
+    error?: undefined;
 }>>;

package/dist/templates/chat/app/hooks/use-navigation-state.ts

@@ -42,7 +42,10 @@ function viewForPath(pathname: string): string {
   if (pathname.startsWith("/database")) return "database";
   if (pathname.startsWith("/extensions")) return "extensions";
   if (pathname.startsWith("/observability")) return "observability";
-  if (pathname.startsWith("/agent")) return "agent";
+  if (pathname.startsWith("/settings/agent") || pathname.startsWith("/agent")) {
+    return "agent";
+  }
+  if (pathname.startsWith("/settings")) return "settings";
   if (pathname.startsWith("/team")) return "settings";
   return "chat";
 }
@@ -60,7 +63,7 @@ function pathForView(view?: string): string {
     case "observability":
       return "/observability";
     case "agent":
-      return "/agent";
+      return "/settings/agent";
     case "settings":
       return "/settings";
     case "team":

package/dist/templates/chat/app/routes/agent.tsx

@@ -1,5 +1,4 @@
-import { useT } from "@agent-native/core/client/i18n";
-import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+import { buildLegacyAgentSettingsRoute } from "@agent-native/core/client/navigation";
 import { Navigate, useLocation } from "react-router";
 
 export function meta() {
@@ -7,34 +6,11 @@ export function meta() {
 }
 
 export default function AgentRoute() {
-  const t = useT();
   const location = useLocation();
-  useSetPageTitle(t("settings.agentTitle"));
-
-  const legacyTab = location.hash.replace(/^#/, "").toLowerCase();
-  const resourceTabs = new Set([
-    "files",
-    "instructions",
-    "agents",
-    "memory",
-    "skills",
-    "learnings",
-  ]);
-  const destination = resourceTabs.has(legacyTab)
-    ? `/settings/agent/resources/${legacyTab}`
-    : legacyTab === "remote-agents"
-      ? "/settings/agent/agents"
-      : legacyTab === "connections"
-        ? "/settings/integrations"
-        : legacyTab === "jobs"
-          ? "/settings/agent/automations"
-          : legacyTab === "access"
-            ? "/settings/agent"
-            : ["llm", "app-models", "limits", "voice", "background"].includes(
-                  legacyTab,
-                )
-              ? `/settings/agent/${legacyTab}`
-              : "/settings/agent";
-
-  return <Navigate to={destination} replace />;
+  return (
+    <Navigate
+      to={buildLegacyAgentSettingsRoute(location.hash, location.search)}
+      replace
+    />
+  );
 }

package/dist/templates/default/app/routes/_index.tsx

@@ -76,7 +76,7 @@ export default function IndexPage() {
             </p>
           </Link>
           <Link
-            to="/agent"
+            to="/settings/agent"
             className="group rounded-lg border border-border/50 px-4 py-3 hover:bg-accent/50 transition-colors"
           >
             <p className="text-[13px] font-medium text-foreground">

package/dist/templates/default/app/routes/agent.tsx

@@ -1,34 +1,16 @@
-import { AgentTabsPage } from "@agent-native/core/client/agent-chat";
-import { useT } from "@agent-native/core/client/i18n";
-import { Link } from "react-router";
+import { buildLegacyAgentSettingsRoute } from "@agent-native/core/client/navigation";
+import { Navigate, useLocation } from "react-router";
 
 export function meta() {
   return [{ title: "Agent - {{APP_TITLE}}" }];
 }
 
 export default function AgentPage() {
-  const t = useT();
-
+  const location = useLocation();
   return (
-    <main className="min-h-screen bg-background px-6 py-10">
-      <div className="mx-auto w-full max-w-5xl space-y-6">
-        <div className="space-y-2">
-          <Link
-            to="/settings"
-            className="text-[13px] text-muted-foreground hover:text-foreground"
-          >
-            {t("settings.title")}
-          </Link>
-          <h1 className="text-2xl font-semibold tracking-tight text-foreground">
-            {t("settings.agentTitle")}
-          </h1>
-          <p className="text-[14px] leading-relaxed text-muted-foreground">
-            {t("settings.agentDescription")}
-          </p>
-        </div>
-
-        <AgentTabsPage className="min-h-[640px] rounded-lg border border-border/50" />
-      </div>
-    </main>
+    <Navigate
+      to={buildLegacyAgentSettingsRoute(location.hash, location.search)}
+      replace
+    />
   );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.146.4",
+  "version": "0.146.5",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -412,8 +412,8 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.31",
     "zod": "^4.3.6",
-    "@agent-native/recap-cli": "0.5.3",
-    "@agent-native/toolkit": "^0.13.5"
+    "@agent-native/toolkit": "^0.13.5",
+    "@agent-native/recap-cli": "0.5.3"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",

package/src/templates/chat/app/hooks/use-navigation-state.ts

@@ -42,7 +42,10 @@ function viewForPath(pathname: string): string {
   if (pathname.startsWith("/database")) return "database";
   if (pathname.startsWith("/extensions")) return "extensions";
   if (pathname.startsWith("/observability")) return "observability";
-  if (pathname.startsWith("/agent")) return "agent";
+  if (pathname.startsWith("/settings/agent") || pathname.startsWith("/agent")) {
+    return "agent";
+  }
+  if (pathname.startsWith("/settings")) return "settings";
   if (pathname.startsWith("/team")) return "settings";
   return "chat";
 }
@@ -60,7 +63,7 @@ function pathForView(view?: string): string {
     case "observability":
       return "/observability";
     case "agent":
-      return "/agent";
+      return "/settings/agent";
     case "settings":
       return "/settings";
     case "team":

package/src/templates/chat/app/routes/agent.tsx

@@ -1,5 +1,4 @@
-import { useT } from "@agent-native/core/client/i18n";
-import { useSetPageTitle } from "@agent-native/toolkit/app-shell";
+import { buildLegacyAgentSettingsRoute } from "@agent-native/core/client/navigation";
 import { Navigate, useLocation } from "react-router";
 
 export function meta() {
@@ -7,34 +6,11 @@ export function meta() {
 }
 
 export default function AgentRoute() {
-  const t = useT();
   const location = useLocation();
-  useSetPageTitle(t("settings.agentTitle"));
-
-  const legacyTab = location.hash.replace(/^#/, "").toLowerCase();
-  const resourceTabs = new Set([
-    "files",
-    "instructions",
-    "agents",
-    "memory",
-    "skills",
-    "learnings",
-  ]);
-  const destination = resourceTabs.has(legacyTab)
-    ? `/settings/agent/resources/${legacyTab}`
-    : legacyTab === "remote-agents"
-      ? "/settings/agent/agents"
-      : legacyTab === "connections"
-        ? "/settings/integrations"
-        : legacyTab === "jobs"
-          ? "/settings/agent/automations"
-          : legacyTab === "access"
-            ? "/settings/agent"
-            : ["llm", "app-models", "limits", "voice", "background"].includes(
-                  legacyTab,
-                )
-              ? `/settings/agent/${legacyTab}`
-              : "/settings/agent";
-
-  return <Navigate to={destination} replace />;
+  return (
+    <Navigate
+      to={buildLegacyAgentSettingsRoute(location.hash, location.search)}
+      replace
+    />
+  );
 }

package/src/templates/default/app/routes/_index.tsx

@@ -76,7 +76,7 @@ export default function IndexPage() {
             </p>
           </Link>
           <Link
-            to="/agent"
+            to="/settings/agent"
             className="group rounded-lg border border-border/50 px-4 py-3 hover:bg-accent/50 transition-colors"
           >
             <p className="text-[13px] font-medium text-foreground">

package/src/templates/default/app/routes/agent.tsx

@@ -1,34 +1,16 @@
-import { AgentTabsPage } from "@agent-native/core/client/agent-chat";
-import { useT } from "@agent-native/core/client/i18n";
-import { Link } from "react-router";
+import { buildLegacyAgentSettingsRoute } from "@agent-native/core/client/navigation";
+import { Navigate, useLocation } from "react-router";
 
 export function meta() {
   return [{ title: "Agent - {{APP_TITLE}}" }];
 }
 
 export default function AgentPage() {
-  const t = useT();
-
+  const location = useLocation();
   return (
-    <main className="min-h-screen bg-background px-6 py-10">
-      <div className="mx-auto w-full max-w-5xl space-y-6">
-        <div className="space-y-2">
-          <Link
-            to="/settings"
-            className="text-[13px] text-muted-foreground hover:text-foreground"
-          >
-            {t("settings.title")}
-          </Link>
-          <h1 className="text-2xl font-semibold tracking-tight text-foreground">
-            {t("settings.agentTitle")}
-          </h1>
-          <p className="text-[14px] leading-relaxed text-muted-foreground">
-            {t("settings.agentDescription")}
-          </p>
-        </div>
-
-        <AgentTabsPage className="min-h-[640px] rounded-lg border border-border/50" />
-      </div>
-    </main>
+    <Navigate
+      to={buildLegacyAgentSettingsRoute(location.hash, location.search)}
+      replace
+    />
   );
 }