@aisa-one/cli 0.6.9 → 0.6.10

package/dist/commands/connect.js

@@ -7,9 +7,9 @@ import { dirname, join } from "node:path";
 import chalk from "chalk";
 import { error } from "../utils/display.js";
 import { expandHome } from "../utils/file.js";
-import { MCP_CONFIGS, MCP_DEFAULT_SLUGS, AISA_PROVIDER_ID } from "../constants.js";
+import { MCP_CONFIGS, AISA_PROVIDER_ID } from "../constants.js";
 import { getAccessToken, getConfig, setConfig } from "../config.js";
-import { fetchLiveServers, writeClientConfig, buildEntry, stripped } from "./mcp.js";
+import { getMcpServers, writeClientConfig, buildEntry, stripped, isUnifiedMcpSelection } from "./mcp.js";
 import { INSTALLERS, installAgent, isInstalled, supported } from "./install.js";
 import { writeCodexLLM, writeClaudeCodeLLM, writeOpencodeLLM, writeCodexAisaProfile, writeOpencodeAisaBackup, defaultModelsFor, patchCodexMCPAuth, DEFAULT_MODELS, } from "./llm-config.js";
 import { writeClaudeAisaSettings, installWrappers } from "./wrappers.js";
@@ -257,6 +257,8 @@ export function cursorDeeplink(name, endpoint, key) {
     return `cursor://anysphere.cursor-deeplink/mcp/install?name=${encodeURIComponent(name)}&config=${encodeURIComponent(config)}`;
 }
 async function applySelection(clientIds, chosen, key, dryRun, state) {
+    if (!isUnifiedMcpSelection(chosen))
+        throw new Error("Only the unified AIsa Router MCP can be configured");
     const results = [];
     for (const id of clientIds) {
         if (id === "cursor" && state?.deeplinks) {
@@ -377,7 +379,7 @@ async function applySelection(clientIds, chosen, key, dryRun, state) {
         }
         else if (MCP_CONFIGS[id]) {
             if (dryRun) {
-                results.push({ client: id, ok: true, message: `would write ${chosen.length + 1} entries to ${MCP_CONFIGS[id].path}` });
+                results.push({ client: id, ok: true, message: `would write ${chosen.length} entries to ${MCP_CONFIGS[id].path}` });
                 continue;
             }
             const r = writeClientConfig(id, chosen, key);
@@ -1131,14 +1133,13 @@ function renderPage(servers, clients, token, keyed, canInstall) {
         .map(([cat, list]) => {
         const rows = list
             .map((s) => {
-            const checked = MCP_DEFAULT_SLUGS.includes(s.slug) ? "checked" : "";
             // The full manifest description, CSS-clamped to two lines; "more"
             // expands it and is hidden by the page script when the text already
             // fits — so short cards carry no dead link and long ones stay tidy.
-            return `<label class="card ${checked ? "on" : ""}" data-kind="server">
-  <input type="checkbox" name="server" value="${s.slug}" ${checked}>
+            return `<label class="card on" data-kind="server">
+  <input type="checkbox" name="server" value="${s.slug}" checked disabled>
   <span class="body"><span class="head"><span class="name">${stripped(s.name)}</span>
-    <span class="badge">${s.toolCount} tools</span></span>
+    </span>
     <span class="desc">${s.description}</span>
     <span class="more" data-more>more</span></span></label>`;
         })
@@ -1169,7 +1170,6 @@ function renderPage(servers, clients, token, keyed, canInstall) {
         (rest.length
             ? `<div class="chips">${rest.map((c) => `${c.label} <i>· not found</i>`).join(" &nbsp;&nbsp; ")}</div>`
             : "");
-    const totalTools = servers.reduce((n, s) => n + s.toolCount, 0);
     // Named per client so the page can say which model a pick actually gets.
     const modelByClient = Object.fromEntries(clients.map((c) => [c.id, defaultModelsFor(c.id).model]));
     const authCopy = keyed
@@ -1180,13 +1180,11 @@ function renderPage(servers, clients, token, keyed, canInstall) {
     const body = `
 <div class="eyebrow">Connect</div>
 <h1><em>AIsa MCP</em> — powerful real-world reach for your agent</h1>
-<p class="lede">One connection puts <b>${totalTools} live tools</b> — web search &amp; research,
-X/Twitter, Reddit, Instagram, stocks, crypto, prediction markets and B2B data — inside the
-coding agent you already use. Pick what you need, press Connect, approve in the browser. Done.</p>
+<p class="lede">One connection gives your coding agent access to AIsa tools. Press Connect and approve in the browser. Done.</p>
 
 <div class="cols">
 <div class="left">
-<h2><span class="n">1</span>Choose capabilities</h2>
+<h2><span class="n">1</span>Connect AIsa Router</h2>
 ${serverGroups}
 </div>
 
@@ -1461,7 +1459,7 @@ machine except the OAuth you approve. The process exits when everything is conne
     var servers = picked("server");
     var chosen = document.querySelector('input[name="client"]:checked');
     if (!servers.length || !chosen) {
-      result.textContent = "Pick at least one capability and one client."; return;
+      result.textContent = "Choose a client to connect to AIsa Router."; return;
     }
     var clients = [chosen.value];
     var install = chosen.dataset.install === "1" ? [chosen.value] : [];
@@ -1524,9 +1522,6 @@ export function renderDone(chosen, clientIds, steps, allServers, balanceMicros,
        Fix the above, then run <code>npx @aisa-one/cli connect</code> again — it is
        safe to re-run and picks up where things stand.</div></div>`
         : "";
-    const toolCount = chosen.reduce((n, s) => n + s.toolCount, 0);
-    const remaining = allServers.length - chosen.length;
-    const remainingTools = allServers.reduce((n, s) => n + s.toolCount, 0) - toolCount;
     // A run that installed an agent is a much bigger deal than one that only
     // added tools, and the headline must say so: the user walked in with
     // nothing and walked out with a working coding agent on AIsa models.
@@ -1537,12 +1532,12 @@ export function renderDone(chosen, clientIds, steps, allServers, balanceMicros,
     const model = defaultModelsFor(clientIds[0] ?? "");
     const successHeadline = installedAgents.length
         ? `<h1>Congratulations — <em>${installedAgents.join(" & ")}</em> is installed and armed
-with <em>${toolCount} powerful tool${toolCount > 1 ? "s" : ""}</em></h1>
+with <em>AIsa tools</em></h1>
 <p class="lede"><b>${installedAgents.join(" & ")}</b> is now on this machine, signed in to
 AIsa${llmOk ? `, running on <b>${model.model}</b> through AIsa,` : ","} with
 ${chosen.length} MCP server${chosen.length > 1 ? "s" : ""} wired in — a complete AI setup,
 nothing else to configure.</p>`
-        : `<h1>Congratulations — your agent just got <em>${toolCount} powerful new tool${toolCount > 1 ? "s" : ""}</em></h1>
+        : `<h1>Congratulations — your agent just got <em>access to AIsa tools</em></h1>
 <p class="lede">${chosen.length} AIsa MCP server${chosen.length > 1 ? "s are" : " is"} now
 installed and signed in for <b>${clientNames}</b> — nothing else to configure.</p>`;
     // Launchable only for the CLI agents, and only while the local process is
@@ -1618,7 +1613,7 @@ ${successHeadline}`;
     const recap = `
 <h2>Everything you just gained</h2>
 <div class="recap">
-  <div class="rsum">${chosen.length} capabilit${chosen.length === 1 ? "y" : "ies"} · ${toolCount} tools · ${clientNames}</div>
+  <div class="rsum">AIsa Router MCP · ${clientNames}</div>
 ${recapRows}
 </div>`;
     // ── the balance card: always shown, always with the top-up button — money
@@ -1696,10 +1691,7 @@ ${headline}
 ${mcpFailed
         ? failBlock + recap + balanceCard
         : `<p class="lede" style="margin-top:.6rem">You are now connected to <b>AIsa</b> — a powerful capability layer for agents: one account for
-<b>Claude, GPT, Gemini, DeepSeek, Kimi, GLM</b> and the live data behind them: <b>Twitter, SimilarWeb, CoinGecko, Apollo, Polymarket</b> and more.${remaining > 0
-            ? ` ${remaining} more MCP server${remaining > 1 ? "s" : ""} (${remainingTools} tools) are one
-<code>npx @aisa-one/cli connect</code> away.`
-            : ""}
+<b>Claude, GPT, Gemini, DeepSeek, Kimi, GLM</b> and the live data behind them: <b>Twitter, SimilarWeb, CoinGecko, Apollo, Polymarket</b> and more.
 Explore the platform at <a href="https://aisa.one" target="_blank" rel="noopener noreferrer">aisa.one</a> ·
 usage &amp; billing at <a href="https://console.aisa.one" target="_blank" rel="noopener noreferrer">console.aisa.one</a>.</p>
 ${failBlock}
@@ -2246,14 +2238,17 @@ export async function connectAction(options) {
     }
     let servers;
     try {
-        servers = resumed ? resumed.servers : await fetchLiveServers();
+        servers = resumed ? resumed.servers : getMcpServers();
+        if (!isUnifiedMcpSelection(servers))
+            throw new Error("This saved run uses retired MCP endpoints. Start again with aisa connect --force.");
     }
     catch (e) {
-        log.line("fail", "Could not read the MCP manifest", e.message);
-        log.note("check your network and try again");
+        log.line("fail", "Could not prepare the unified MCP connection", e.message);
+        log.note("Review your clients and models again with: aisa connect --force");
         process.exitCode = 1;
         return;
     }
+    log.note("Existing MCP entries are preserved. Remove old domain entries manually after connecting to aisa-router.");
     const clients = resumed ? resumed.clients : detectClients();
     // Rehearsal aid: in a dry run, pretend the listed clients are present so a
     // page can be reviewed for a client this machine does not have. Never
@@ -2313,7 +2308,7 @@ export async function connectAction(options) {
         // that never opens a browser starts from the same defaults rather than
         // from nothing.
         draft: {
-            servers: servers.filter((s) => MCP_DEFAULT_SLUGS.includes(s.slug)).map((s) => s.slug),
+            servers: servers.map((s) => s.slug),
             clients: [],
             install: [],
             llmMode: "backup",
@@ -2715,7 +2710,7 @@ export async function connectAction(options) {
             }
             // Who started this decides whether there is an animation to wait for.
             drivenByTerminal = req.headers["x-connect-source"] === "terminal";
-            chosenServers = servers.filter((s) => body.servers?.includes(s.slug));
+            chosenServers = servers;
             chosenClients = body.clients ?? [];
             const wantInstall = new Set(body.install ?? []);
             // Ticking "install" means "and connect it": nobody installs an agent
@@ -2995,7 +2990,7 @@ export async function connectAction(options) {
     // the real problem.
     if (resumed && state.selection) {
         chosenClients = [...state.selection.clients];
-        chosenServers = servers.filter((x) => state.selection.servers.includes(x.slug));
+        chosenServers = servers;
         // llmMode is not a local here — the routes read state.llmMode, which
         // travels with the run.
     }
@@ -3006,7 +3001,7 @@ export async function connectAction(options) {
         armRetry({
             install: [...sel.install],
             clients: [...sel.clients],
-            servers: servers.filter((x) => sel.servers.includes(x.slug)),
+            servers: servers,
             key: liveKey(),
             catcher: signInCatcher,
             signinShown: signinShownP,
@@ -3126,7 +3121,7 @@ export async function connectAction(options) {
     const missing = clients.filter((c) => !c.detected).map((c) => c.label);
     if (missing.length)
         log.record(`not found: ${missing.join(", ")}`);
-    log.line("info", `${servers.length} AIsa MCP servers are live`, "pick what you need");
+    log.line("info", "AIsa Router MCP", "one connection for all published tools");
     // The terminal walks the same six steps from the same definition. It is not
     // a fallback: on a machine with no browser, printing a localhost URL is a
     // dead end, and both surfaces share one draft so either can be used —

package/dist/commands/flow.d.ts

@@ -262,55 +262,13 @@ export declare const STEP_CAPS: {
         en: string;
         zh: string;
     };
-    pickArea: {
-        en: string;
-        zh: string;
-    };
-    selectAll: {
-        en: string;
-        zh: string;
-    };
-    /**
-     * The counts sentence as one string, because punctuation is not shared
-     * between languages: joining "N", "areas", ", " in code produced
-     * "2 个领域, 2 个 server, 48 个工具." — Chinese text with ASCII commas and a
-     * full stop. Whatever varies goes in as a placeholder instead.
-     */
     counts: {
         en: string;
         zh: string;
     };
-    /** Category tile meta: "3 servers · 47 tools". */
-    tileMeta: {
-        en: string;
-        zh: string;
-    };
-    /**
-     * A placeholder both renderers can fill. The page used to carry
-     * <b id="mModel"></b> here and fill it with script — which left the
-     * terminal printing "AIsa()" with nothing inside, because stripping tags is
-     * all it can do with markup meant for the other surface.
-     */
-    serversWord: {
-        en: string;
-        zh: string;
-    };
-    serverWord: {
-        en: string;
-        zh: string;
-    };
-    toolsWord: {
-        en: string;
-        zh: string;
-    };
 };
 /** Shown for a file-configured client that has no note of its own. */
 export declare const FILE_MODEL_FALLBACK: Text;
-export declare const CATEGORY_BLURB: Record<string, Text>;
-/** New host categories remain visible without waiting for a client release. */
-export declare function categoryBlurb(category: string, servers: Array<{
-    name: string;
-}>): Text;
 export declare const STEP_INSTALL: {
     h1: {
         en: string;
@@ -344,10 +302,6 @@ export declare const STEP_DONE: {
     };
 };
 export declare const RUNTIME_COPY: {
-    readonly nothingSelected: {
-        readonly en: "Nothing selected yet — pick at least one server.";
-        readonly zh: "还没有选择 —— 至少选一个 server。";
-    };
     readonly planBackup: {
         readonly "claude-code": {
             readonly en: "Install the claude-aisa command";

package/dist/commands/flow.js

@@ -136,12 +136,12 @@ export const AGENT_NOTES = {
         zh: "每个 server 一次点击:最后一步会给出 <b>Add to Cursor</b> 链接。Cursor 会打开、把确切的配置内容给你看,你确认后由它自己写进 MCP 设置。模型保持原样 —— Cursor 用它自己的。",
     },
     "claude-desktop": {
-        en: "Claude Desktop's config file only takes MCP servers over stdio, so each AIsa server is written in as a small <code>mcp-remote</code> bridge carrying your key (plus the free <code>aisa-docs</code> server). The bridges live and die with the app — no background service, no open ports. Models cannot be changed: Claude Desktop runs Anthropic's own. Restart the app and the servers appear under its tools menu.",
-        zh: "Claude Desktop 的配置文件只接受 stdio 形式的 MCP server,所以每个 AIsa server 都写成一个带你 key 的 <code>mcp-remote</code> 小桥接(外加免费的 <code>aisa-docs</code>)。桥接随 app 启停 —— 没有后台服务,不开端口。模型无法更改:Claude Desktop 跑的是 Anthropic 自家模型。重启 app 后就能在工具菜单里看到这些 server。",
+        en: "Claude Desktop's config file only takes MCP servers over stdio, so the AIsa Router is written in as a small <code>mcp-remote</code> bridge carrying your key. The bridge lives and dies with the app — no background service, no open ports. Models cannot be changed: Claude Desktop runs Anthropic's own. Restart the app and the Router appears under its tools menu.",
+        zh: "Claude Desktop 的配置文件只接受 stdio 形式的 MCP server,所以 AIsa Router 写成一个带你 key 的 <code>mcp-remote</code> 小桥接。桥接随 app 启停 —— 没有后台服务,不开端口。模型无法更改:Claude Desktop 跑的是 Anthropic 自家模型。重启 app 后就能在工具菜单里看到 AIsa Router。",
     },
     "claude-ai": {
-        en: "Nothing is installed. claude.ai takes remote MCP servers as <b>Connectors</b>: on the last step you get one URL per server with a Copy button, and add each under <b>Settings → Connectors → Add custom connector</b>, then press Connect — claude.ai runs the AIsa sign-in itself. Models cannot be changed: claude.ai runs Anthropic's own.",
-        zh: "不安装任何东西。claude.ai 以 <b>Connectors</b> 的形式接受远程 MCP server:最后一步会给出每个 server 的 URL 和复制按钮,在 <b>Settings → Connectors → Add custom connector</b> 里逐个添加,然后点 Connect —— claude.ai 会自己跑 AIsa 的登录流程。模型无法更改:claude.ai 跑的是 Anthropic 自家模型。",
+        en: "Nothing is installed. claude.ai takes remote MCP servers as <b>Connectors</b>: on the last step you get the Router URL with a Copy button, and add it under <b>Settings → Connectors → Add custom connector</b>, then press Connect — claude.ai runs the AIsa sign-in itself. Models cannot be changed: claude.ai runs Anthropic's own.",
+        zh: "不安装任何东西。claude.ai 以 <b>Connectors</b> 的形式接受远程 MCP server:最后一步会给出 Router 的 URL 和复制按钮,在 <b>Settings → Connectors → Add custom connector</b> 里添加,然后点 Connect —— claude.ai 会自己跑 AIsa 的登录流程。模型无法更改:claude.ai 跑的是 Anthropic 自家模型。",
     },
 };
 /**
@@ -176,8 +176,8 @@ export const AGENT_HAVE_NOTES = {
         zh: "你原有的东西一样都不会被替换。那两个文件里其他的 MCP server 和模型分组保持原样;只有 <code>aisa-*</code> 条目和 AIsa 那个分组是我们写的,要移除就是删掉它们。",
     },
     cursor: {
-        en: "Nothing of yours is replaced. Cursor adds each AIsa server beside your existing MCP entries under <code>aisa-*</code> names, and you approve every one inside Cursor first.",
-        zh: "你原有的东西一样都不会被替换。Cursor 会把每个 AIsa server 以 <code>aisa-*</code> 命名加在你已有的 MCP 条目旁边,而且每一个都要你在 Cursor 里先确认。",
+        en: "Nothing of yours is replaced. Cursor adds the AIsa Router beside your existing MCP entries under the <code>aisa-router</code> name, and you approve it inside Cursor first.",
+        zh: "你原有的东西一样都不会被替换。Cursor 会把 AIsa Router 以 <code>aisa-router</code> 命名加在你已有的 MCP 条目旁边,并需要你在 Cursor 里先确认。",
     },
 };
 // ── the rail: every step's name ─────────────────────────────────────────────
@@ -325,88 +325,21 @@ export const BACKUP_COPY = {
 };
 // ── step 4: capabilities ────────────────────────────────────────────────────
 export const STEP_CAPS = {
-    h1: { en: "What should your agent be able to reach?", zh: "你的 agent 需要够得着什么?" },
+    h1: { en: "Connect AIsa tools", zh: "连接 AIsa 工具" },
     ledeTail: {
-        en: "Open an area to pick the servers inside it. Everything here is live production data with licensed sources; you can add more later with one more <code>aisa connect</code>.",
-        zh: "点开一个领域来挑里面的 server。这里全都是有授权来源的生产环境实时数据;之后再跑一次 <code>aisa connect</code> 就能加更多。",
+        en: "One Router MCP connects your agent to AIsa tools. Existing MCP entries stay unchanged; remove old domain entries manually.",
+        zh: "通过一个 Router MCP 接入 AIsa 工具。已有 MCP 条目保持不变；旧的领域条目请自行删除。",
     },
-    pickArea: { en: "Pick an area above", zh: "先在上面选一个领域" },
-    selectAll: { en: "Select all in this area", zh: "全选这个领域" },
-    /**
-     * The counts sentence as one string, because punctuation is not shared
-     * between languages: joining "N", "areas", ", " in code produced
-     * "2 个领域, 2 个 server, 48 个工具." — Chinese text with ASCII commas and a
-     * full stop. Whatever varies goes in as a placeholder instead.
-     */
     counts: {
-        en: "{areas} areas, {servers} servers, {tools} tools.",
-        zh: "{areas} 个领域、{servers} 个 server、{tools} 个工具。",
-    },
-    /** Category tile meta: "3 servers · 47 tools". */
-    tileMeta: {
-        en: "{n} {noun} · {tools} tools",
-        zh: "{n} 个 {noun} · {tools} 个工具",
+        en: "One unified AIsa MCP connection.",
+        zh: "一个统一的 AIsa MCP 连接。",
     },
-    /**
-     * A placeholder both renderers can fill. The page used to carry
-     * <b id="mModel"></b> here and fill it with script — which left the
-     * terminal printing "AIsa()" with nothing inside, because stripping tags is
-     * all it can do with markup meant for the other surface.
-     */
-    serversWord: { en: "servers", zh: "server" },
-    serverWord: { en: "server", zh: "server" },
-    toolsWord: { en: "tools", zh: "个工具" },
 };
 /** Shown for a file-configured client that has no note of its own. */
 export const FILE_MODEL_FALLBACK = {
     en: "This client picks its own models inside the app, so nothing is changed here — only the MCP servers are added.",
     zh: "这个客户端在它自己的应用里选模型,所以这一步不做改动 —— 只添加 MCP server。",
 };
-export const CATEGORY_BLURB = {
-    "Search & Research": {
-        en: "Ranked web results with page text already extracted, plus YouTube.",
-        zh: "带排序的网页搜索结果,正文已经抽好,另有 YouTube。",
-    },
-    Finance: {
-        en: "US equities, crypto, prediction markets and what X is saying about a ticker.",
-        zh: "美股、加密货币、预测市场,以及 X 上关于某只票的讨论。",
-    },
-    Social: {
-        en: "Public X/Twitter, Reddit, Instagram and Pinterest — profiles, posts, engagement.",
-        zh: "公开的 X/Twitter、Reddit、Instagram 和 Pinterest —— 资料、帖子、互动数据。",
-    },
-    Sales: {
-        en: "Apollo B2B data — enrich people and companies, find prospects.",
-        zh: "Apollo 的 B2B 数据 —— 补全人和公司信息、找潜在客户。",
-    },
-    "SEO & Search Data": {
-        en: "Keywords, rankings, backlinks and on-page checks — and how a brand shows up in AI answers.",
-        zh: "关键词、排名、外链、页面检查 —— 还有一个品牌在 AI 回答里的露出情况。",
-    },
-    Communication: {
-        en: "An inbox an agent can actually use — its own address, sending and receiving.",
-        zh: "agent 能真正用起来的邮箱 —— 自己的地址,能收能发。",
-    },
-    Creators: {
-        en: "Find creators by audience, topic and reach, across platforms.",
-        zh: "按受众、话题和影响力找创作者,跨平台。",
-    },
-    Search: {
-        en: "YouTube search on its own.",
-        zh: "单独的 YouTube 搜索。",
-    },
-    "Market Intelligence": {
-        en: "Similarweb data — a site's traffic, engagement and where its visitors come from.",
-        zh: "Similarweb 数据 —— 网站流量、互动情况,以及访客从哪来。",
-    },
-};
-/** New host categories remain visible without waiting for a client release. */
-export function categoryBlurb(category, servers) {
-    if (Object.hasOwn(CATEGORY_BLURB, category))
-        return CATEGORY_BLURB[category];
-    const names = servers.map((server) => server.name).filter(Boolean).join(", ");
-    return { en: `Explore ${names || category}.`, zh: `查看 ${names || category} 的接口。` };
-}
 // ── step 5: install ─────────────────────────────────────────────────────────
 export const STEP_INSTALL = {
     h1: { en: "Ready to connect", zh: "准备接线" },
@@ -433,10 +366,6 @@ export const STEP_DONE = {
 // Resolved to the current language and injected as a single object, because
 // the browser has no access to this file. Same source, one hop later.
 export const RUNTIME_COPY = {
-    nothingSelected: {
-        en: "Nothing selected yet — pick at least one server.",
-        zh: "还没有选择 —— 至少选一个 server。",
-    },
     planBackup: {
         "claude-code": { en: "Install the claude-aisa command", zh: "安装 claude-aisa 命令" },
         codex: { en: "Add the aisa profile and codex-aisa", zh: "添加 aisa profile 和 codex-aisa" },

package/dist/commands/mcp.d.ts

@@ -1,47 +1,19 @@
-/**
- * `aisa mcp setup` — write real, per-client MCP entries from the live manifest.
- *
- * Three rules, each one a lesson from the version this replaces:
- *
- * 1. The server list comes from the platform's discovery manifest at setup
- *    time, never from this file. Servers ship without a CLI release.
- * 2. Nothing is written unless the manifest was actually fetched. The old
- *    command wrote first and verified never, which is how a dead hostname
- *    sat in users' configs across releases.
- * 3. Each client gets the shape it executes: `{url}` for clients that dial
- *    HTTP themselves, an `npx mcp-remote` stdio bridge for the ones that only
- *    spawn processes. One shape for all three was the old bug.
- *
- * Auth is a choice the user already made: with an API key configured, entries
- * carry it as a Bearer header (zero-interaction, but the key lands in each
- * client's config file); without one, entries carry no credentials and the
- * server's 401 challenge drives the client through the Clerk OAuth flow.
- */
+/** Configure the unified Router MCP. Existing client entries are preserved. */
 export interface LiveServer {
     slug: string;
     name: string;
     endpoint: string;
-    toolCount: number;
-    /** One-paragraph capability description from the manifest — the single
-     *  source of truth for what a server does; rendered on the connect page. */
+    toolCount?: number;
+    /** Capability description rendered on the connect page. */
     description: string;
     category: string;
 }
 export declare const stripped: (name: string) => string;
-/**
- * Which servers exist, asked of the host that runs them.
- *
- * The index is preferred and the manifest is the fallback, in that order for
- * one reason: the manifest is a snapshot committed by hand, and on 2026-08-25
- * it was three servers and 72 tools behind what the host was actually serving.
- * Anything derived from a running process cannot drift that way.
- *
- * The fallback is not defensive padding — the index is newer than some
- * deployments, and a self-hosted gateway configured through `baseUrl` may
- * never grow one. A user in either case should still get a working setup from
- * a slightly stale list rather than an error.
- */
-export declare function fetchLiveServers(): Promise<LiveServer[]>;
+/** Router's fixed public MCP contract, independent of the legacy module catalog. */
+export declare function unifiedMcpServer(): LiveServer;
+export declare function isUnifiedMcpSelection(servers: LiveServer[]): boolean;
+/** The unified entry is fixed; setup does not depend on a directory service. */
+export declare function getMcpServers(): LiveServer[];
 /** One config entry in the shape the client actually executes. */
 export declare function buildEntry(shape: "url" | "stdio", endpoint: string, key: string | undefined): Record<string, unknown>;
 export type WriteResult = {
@@ -51,12 +23,7 @@ export type WriteResult = {
     ok: false;
     reason: string;
 };
-/**
- * Write the chosen servers (plus the docs server) into one client's config
- * file. Shared by `aisa mcp setup` and `aisa connect` so the two entry points
- * cannot drift in how they treat existing files: unparseable JSON is refused,
- * never replaced, and only the known-dead legacy entry is cleaned up.
- */
+/** Add the unified entry without deleting old AIsa, docs, or unrelated entries. */
 export declare function writeClientConfig(agent: string, chosen: LiveServer[], key: string | undefined): WriteResult;
 export declare function mcpSetupAction(options: {
     agent?: string;