@algosuite/vo-mcp 0.2.0-beta.59 → 0.2.0-beta.61

package/dist/install-cli.js

@@ -546,6 +546,43 @@ function installCodexMcpConfigAt(configPath, cliPath, controlPlaneUrl, log, mana
   log(`\u2713 Wrote AlgoHQ MCP to Codex: ${configPath}`);
 }
 
+// src/remote-mcp-entry.ts
+var REMOTE_MCP_SERVER_KEY = "vo-mcp-remote";
+var REMOTE_MCP_TOKEN_ENV = "VO_MCP_REMOTE_TOKEN";
+var REMOTE_MCP_ENDPOINT_PATH = "/api/v1/mcp";
+var REMOTE_MCP_AUTH_HEADER = `Bearer \${${REMOTE_MCP_TOKEN_ENV}}`;
+function remoteMcpOptIn(env) {
+  return (env["VO_REMOTE_MCP"] ?? "").trim() === "1";
+}
+function remoteMcpUrl(controlPlaneUrl) {
+  return `${controlPlaneUrl.trim().replace(/\/+$/, "")}${REMOTE_MCP_ENDPOINT_PATH}`;
+}
+function buildRemoteMcpEntry(controlPlaneUrl) {
+  return {
+    type: "http",
+    url: remoteMcpUrl(controlPlaneUrl),
+    headers: { Authorization: REMOTE_MCP_AUTH_HEADER }
+  };
+}
+function asRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : null;
+}
+function isManagedRemoteMcpEntry(value) {
+  const entry = asRecord(value);
+  if (!entry) return false;
+  if (entry["type"] !== "http") return false;
+  const url = entry["url"];
+  if (typeof url !== "string" || !url.endsWith(REMOTE_MCP_ENDPOINT_PATH)) return false;
+  const headers = asRecord(entry["headers"]);
+  return headers?.["Authorization"] === REMOTE_MCP_AUTH_HEADER;
+}
+function remoteMcpEntryIsCurrent(value, desired) {
+  const entry = asRecord(value);
+  if (!entry) return false;
+  const headers = asRecord(entry["headers"]);
+  return entry["type"] === desired.type && entry["url"] === desired.url && headers?.["Authorization"] === desired.headers["Authorization"];
+}
+
 // src/autostart.ts
 import { homedir as homedir3, platform as platform2 } from "node:os";
 import { isAbsolute as isAbsolute2, join as join5 } from "node:path";
@@ -810,7 +847,20 @@ function resolveVoMcpCliPath() {
 }
 var INSTALL_LAUNCHER = { sticky: false, onlyExisting: false };
 var HEAL_LAUNCHER = { sticky: true, onlyExisting: true };
-function installMcpConfigAt(configPath, cliPath, controlPlaneUrl, log, label, launcher = { launcherPath: null, ...INSTALL_LAUNCHER }) {
+function reconcileRemoteEntry(mcpServers, remote) {
+  const existing = mcpServers[REMOTE_MCP_SERVER_KEY];
+  if (remote) {
+    return {
+      fragment: { [REMOTE_MCP_SERVER_KEY]: remote },
+      current: remoteMcpEntryIsCurrent(existing, remote)
+    };
+  }
+  if (existing !== void 0 && isManagedRemoteMcpEntry(existing)) {
+    return { fragment: { [REMOTE_MCP_SERVER_KEY]: void 0 }, current: false };
+  }
+  return { fragment: {}, current: true };
+}
+function installMcpConfigAt(configPath, cliPath, controlPlaneUrl, log, label, launcher = { launcherPath: null, ...INSTALL_LAUNCHER }, remote = null) {
   if (launcher.onlyExisting && !existsSync6(configPath)) return;
   const read = readClaudeConfig(configPath);
   if (read.kind === "invalid" || read.kind === "empty" && launcher.onlyExisting) {
@@ -824,8 +874,9 @@ function installMcpConfigAt(configPath, cliPath, controlPlaneUrl, log, label, la
   const voEntry = managedEntry ?? mcpServers["vo"];
   const { launcherPath } = launcher;
   const fallbackCli = chooseFallbackCli(voEntry?.env?.[MCP_FALLBACK_CLI_ENV], cliPath, launcher.sticky, launcherPath ? dirname4(launcherPath) : null);
-  const current = launcherPath ? !isStaleVoMcpEntry(voEntry, launcherPath, fallbackCli) : Boolean(voEntry?.args?.some((a) => a.includes(cliPath)));
-  if (current) {
+  const localCurrent = launcherPath ? !isStaleVoMcpEntry(voEntry, launcherPath, fallbackCli) : Boolean(voEntry?.args?.some((a) => a.includes(cliPath)));
+  const remoteState = reconcileRemoteEntry(mcpServers, remote);
+  if (localCurrent && remoteState.current) {
     log(`  ${label} already current: ${configPath}`);
     return;
   }
@@ -845,7 +896,11 @@ function installMcpConfigAt(configPath, cliPath, controlPlaneUrl, log, label, la
           ...preservedEnv,
           ...launcherPath && fallbackCli ? { [MCP_FALLBACK_CLI_ENV]: fallbackCli } : {}
         }
-      }
+      },
+      // Additive remote entry (11.3 slice A) — or the removal of one we wrote,
+      // when the operator has opted back out. Spread LAST so it can delete its
+      // own key; it never names 'vo-mcp', so the stdio entry above is safe.
+      ...remoteState.fragment
     }
   };
   if (readMtime !== null && (!existsSync6(configPath) || statSync3(configPath).mtimeMs !== readMtime)) {
@@ -854,6 +909,12 @@ function installMcpConfigAt(configPath, cliPath, controlPlaneUrl, log, label, la
   }
   writeClaudeConfig(configPath, merged);
   log(`\u2713 Wrote vo-mcp to ${label}: ${configPath}`);
+  if (remote) {
+    log(`  + remote MCP entry '${REMOTE_MCP_SERVER_KEY}' \u2192 ${remote.url} (serves vo_skill_list; every other tool stays on the local vo-mcp entry)`);
+    log(`    Set ${REMOTE_MCP_TOKEN_ENV} in your environment to authenticate it \u2014 no token is written to this file.`);
+  } else if (!remoteState.current) {
+    log(`  - removed the remote MCP entry '${REMOTE_MCP_SERVER_KEY}' (VO_REMOTE_MCP is not set to 1)`);
+  }
 }
 function installMcpConfig(log, env, mode = "install") {
   const home = env["HOME"]?.trim() || env["USERPROFILE"]?.trim() || homedir4();
@@ -861,6 +922,7 @@ function installMcpConfig(log, env, mode = "install") {
   const plat = platform3();
   const cliPath = resolveVoMcpCliPath();
   const controlPlaneUrl = env["VO_CONTROL_PLANE_URL"]?.trim() || DEFAULT_CONTROL_PLANE_URL2;
+  const remote = remoteMcpOptIn(env) ? buildRemoteMcpEntry(controlPlaneUrl) : null;
   const launcherPath = writeMcpLauncherForEnv(env, log, { platform: plat, home });
   const launcher = { launcherPath, ...mode === "heal" ? HEAL_LAUNCHER : INSTALL_LAUNCHER };
   const leg = (label, run) => {
@@ -871,8 +933,8 @@ function installMcpConfig(log, env, mode = "install") {
       log(`  \u26A0 ${label}: could not update the MCP registration \u2014 ${err instanceof Error ? err.message : String(err)}`);
     }
   };
-  leg("Claude Code CLI", () => installMcpConfigAt(resolveCodeConfigPath(home), cliPath, controlPlaneUrl, log, "Claude Code CLI", launcher));
-  leg("Claude Desktop", () => installMcpConfigAt(resolveDesktopConfigPath(home, plat, appData), cliPath, controlPlaneUrl, log, "Claude Desktop", launcher));
+  leg("Claude Code CLI", () => installMcpConfigAt(resolveCodeConfigPath(home), cliPath, controlPlaneUrl, log, "Claude Code CLI", launcher, remote));
+  leg("Claude Desktop", () => installMcpConfigAt(resolveDesktopConfigPath(home, plat, appData), cliPath, controlPlaneUrl, log, "Claude Desktop", launcher, remote));
   const codexPath = resolveCodexConfigPath(home);
   if (launcher.onlyExisting && !existsSync6(codexPath)) return;
   leg("Codex", () => {