summer-engine 3.0.0 → 3.1.0

package/dist/installer/agent-config.js

@@ -2,56 +2,12 @@ import { existsSync, readFileSync } from "fs";
 import { copyFile, mkdir, readFile, writeFile } from "fs/promises";
 import { dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
+import { isMap, parseDocument } from "yaml";
 import { PACKAGE_ROOT } from "../core/package-root.js";
-import { homedir, platform } from "os";
+import { agentAliasMap, agentSpec, defaultPathContext, resolveMcpPath, supportedAgents, } from "./agent-table.js";
+export { supportedAgents } from "./agent-table.js";
 export const SUMMER_MCP_SERVER_NAME = "summer-engine";
-export const supportedAgents = [
-    "codex",
-    "claude-code",
-    "cursor",
-    "windsurf",
-    "cline",
-    "roo-code",
-    "kilo-code",
-    "gemini",
-    "github-copilot",
-    "vscode-copilot",
-    "opencode",
-    "lm-studio",
-];
-const agentAliases = {
-    claude: "claude-code",
-    "claude-code": "claude-code",
-    codex: "codex",
-    cursor: "cursor",
-    windsurf: "windsurf",
-    devin: "windsurf",
-    "devin-desktop": "windsurf",
-    devindesktop: "windsurf",
-    cline: "cline",
-    "roo-code": "roo-code",
-    roo: "roo-code",
-    roocode: "roo-code",
-    kilo: "kilo-code",
-    kilocode: "kilo-code",
-    "kilo-code": "kilo-code",
-    gemini: "gemini",
-    "gemini-cli": "gemini",
-    copilot: "github-copilot",
-    "copilot-cli": "github-copilot",
-    "github-copilot": "github-copilot",
-    "github-copilot-cli": "github-copilot",
-    vscode: "vscode-copilot",
-    "vs-code": "vscode-copilot",
-    "vscode-copilot": "vscode-copilot",
-    "vs-code-copilot": "vscode-copilot",
-    "github-copilot-vscode": "vscode-copilot",
-    opencode: "opencode",
-    "open-code": "opencode",
-    lmstudio: "lm-studio",
-    "lm-studio": "lm-studio",
-    "lm_studio": "lm-studio",
-};
+const agentAliases = agentAliasMap();
 export function parseAgent(value) {
     if (!value)
         return null;
@@ -90,31 +46,22 @@ export async function configureAgentMcp(options) {
     const cwd = resolve(options.cwd ?? process.cwd());
     const channel = normalizeChannel(options.channel);
     const server = createSummerMcpServerConfig(Boolean(options.localDev), process.platform, channel);
-    const target = resolveConfigTarget(options.agent, options.scope, cwd, env);
+    const spec = agentSpec(options.agent);
+    const target = resolveConfigTarget(spec, options.scope, cwd, env);
     const snippet = renderConfigSnippet(options.agent, server);
     const dryRun = Boolean(options.dryRun);
     const print = Boolean(options.print);
     const shouldWrite = !dryRun && !print;
     const update = print
         ? { changed: true }
-        : target.format === "toml"
-            ? await upsertCodexConfig(target.path, server, shouldWrite)
-            : target.format === "json-opencode"
-                ? await upsertOpencodeConfig(target.path, server, shouldWrite)
-                : target.format === "json-copilot"
-                    ? await upsertCopilotConfig(target.path, server, shouldWrite)
-                    : target.format === "json-vscode"
-                        ? await upsertVsCodeMcpConfig(target.path, server, shouldWrite)
-                        : options.agent === "gemini"
-                            ? await upsertGeminiExtension(target.path, server, shouldWrite)
-                            : await upsertJsonMcpConfig(target.path, server, shouldWrite);
+        : await upsertConfig(spec.format, target.path, server, shouldWrite);
     return {
         agent: options.agent,
         scope: options.scope,
         path: target.path,
         serverName: SUMMER_MCP_SERVER_NAME,
         server,
-        format: target.format,
+        format: spec.format,
         snippet,
         changed: update.changed,
         wrote: shouldWrite && update.changed,
@@ -123,9 +70,24 @@ export async function configureAgentMcp(options) {
         localDev: Boolean(options.localDev),
         channel,
         warnings: target.warnings,
-        nextSteps: createNextSteps(options.agent, options.scope, target.path),
+        nextSteps: [`Updated ${target.path}.`, spec.restart],
     };
 }
+async function upsertConfig(format, path, server, write) {
+    switch (format) {
+        case "toml":
+            return upsertCodexConfig(path, server, write);
+        case "toml-array":
+            return upsertTomlArrayConfig(path, server, write);
+        case "json-gemini":
+            return upsertGeminiExtension(path, server, write);
+        case "yaml-goose":
+        case "yaml-hermes":
+            return upsertYamlConfig(path, [topLevelKey(format), SUMMER_MCP_SERVER_NAME], mcpEntry(format, server), write);
+        default:
+            return upsertJsonEntry(path, format, server, write);
+    }
+}
 export const DEFAULT_CHANNEL = "latest";
 /** npm dist-tags are lowercase words like `latest`, `next`, `beta`, `v3-preview`;
  *  anything that could be read as a version or a path is refused (a bare
@@ -164,39 +126,87 @@ export function createSummerMcpServerConfig(localDev, platform = process.platfor
     };
 }
 export function renderConfigSnippet(agent, server) {
-    if (agent === "codex") {
+    const format = agentSpec(agent).format;
+    if (format === "toml")
         return renderCodexServerTable(server);
-    }
-    if (agent === "opencode") {
-        return (JSON.stringify({
-            $schema: "https://opencode.ai/config.json",
-            mcp: {
-                [SUMMER_MCP_SERVER_NAME]: opencodeServerEntry(server),
-            },
-        }, null, 2) + "\n");
-    }
-    if (agent === "github-copilot") {
-        return (JSON.stringify({
-            mcpServers: {
-                [SUMMER_MCP_SERVER_NAME]: copilotServerEntry(server),
-            },
-        }, null, 2) + "\n");
-    }
-    if (agent === "vscode-copilot") {
-        return (JSON.stringify({
-            servers: {
-                [SUMMER_MCP_SERVER_NAME]: vsCodeServerEntry(server),
-            },
-        }, null, 2) + "\n");
-    }
-    if (agent === "gemini") {
+    if (format === "toml-array")
+        return renderTomlArrayEntry(server);
+    if (format === "json-gemini") {
         return renderJsonFile(geminiExtensionManifest(server, readBundledGeminiManifestSync()));
     }
-    return (JSON.stringify({
-        mcpServers: {
-            [SUMMER_MCP_SERVER_NAME]: server,
-        },
-    }, null, 2) + "\n");
+    if (format === "yaml-goose" || format === "yaml-hermes") {
+        const doc = parseDocument("{}");
+        doc.setIn([topLevelKey(format), SUMMER_MCP_SERVER_NAME], doc.createNode(mcpEntry(format, server)));
+        return doc.toString();
+    }
+    const file = {};
+    if (format === "json-opencode" && agent === "opencode")
+        file.$schema = OPENCODE_SCHEMA;
+    file[topLevelKey(format)] = { [SUMMER_MCP_SERVER_NAME]: mcpEntry(format, server) };
+    return renderJsonFile(file);
+}
+const OPENCODE_SCHEMA = "https://opencode.ai/config.json";
+/** The key under which the file lists MCP servers (see McpFormat in agent-table.ts). */
+export function topLevelKey(format) {
+    switch (format) {
+        case "json-vscode":
+        case "json-servers":
+            return "servers";
+        case "json-opencode":
+        case "json-crush":
+            return "mcp";
+        case "json-zed":
+            return "context_servers";
+        case "json-amp":
+            return "amp.mcpServers";
+        case "yaml-goose":
+            return "extensions";
+        case "yaml-hermes":
+        case "toml":
+        case "toml-array":
+            return "mcp_servers";
+        default:
+            return "mcpServers";
+    }
+}
+/** One server entry in the shape the agent's file expects. */
+export function mcpEntry(format, server) {
+    const env = server.env && Object.keys(server.env).length > 0 ? { ...server.env } : undefined;
+    switch (format) {
+        case "json-opencode":
+            return {
+                type: "local",
+                command: [server.command, ...server.args],
+                enabled: true,
+                ...(env ? { environment: env } : {}),
+            };
+        case "json-copilot":
+            return { type: "local", command: server.command, args: server.args, tools: ["*"], ...(env ? { env } : {}) };
+        case "json-vscode":
+        case "json-stdio":
+        case "json-crush":
+            return { type: "stdio", command: server.command, args: server.args, ...(env ? { env } : {}) };
+        case "json-zed":
+            return { command: server.command, args: server.args, env: env ?? {} };
+        case "json-transport":
+            return { command: server.command, args: server.args, transport: "stdio", ...(env ? { env } : {}) };
+        case "toml-array":
+            return { name: SUMMER_MCP_SERVER_NAME, transport: "stdio", command: server.command, args: server.args, ...(env ? { env } : {}) };
+        case "yaml-goose":
+            return {
+                type: "stdio",
+                name: SUMMER_MCP_SERVER_NAME,
+                description: "Summer Engine: scenes, scripts, play mode and diagnostics over MCP",
+                cmd: server.command,
+                args: server.args,
+                enabled: true,
+                timeout: 300,
+                env_keys: [],
+                envs: env ?? {},
+            };
+        default:
+            return { command: server.command, args: server.args, ...(env ? { env } : {}) };
+    }
 }
 function resolveLocalCliPath() {
     const thisFile = fileURLToPath(import.meta.url);
@@ -210,205 +220,21 @@ export function resolvePackageRoot() {
 export const GEMINI_EXTENSION_DIR_NAME = "summer-engine";
 /** Files copied next to the extension manifest so `contextFileName` (GEMINI.md, which imports AGENTS.md) resolves. */
 const GEMINI_CONTEXT_FILES = ["GEMINI.md", "AGENTS.md"];
-function resolveConfigTarget(agent, scope, cwd, env) {
-    const override = getConfigPathOverride(agent, env);
-    const warnings = [];
-    if (override) {
-        if (scope === "project" &&
-            (agent === "cline" || agent === "roo-code" || agent === "gemini" || agent === "lm-studio")) {
-            warnings.push(`${agent} MCP config has no project scope today; treating as user scope.`);
-        }
-        return {
-            path: resolve(override),
-            format: agent === "codex"
-                ? "toml"
-                : agent === "opencode"
-                    ? "json-opencode"
-                    : agent === "github-copilot"
-                        ? "json-copilot"
-                        : agent === "vscode-copilot"
-                            ? "json-vscode"
-                            : "json",
-            warnings,
-        };
-    }
-    if (agent === "codex") {
-        return {
-            path: scope === "user"
-                ? join(homedir(), ".codex", "config.toml")
-                : join(cwd, ".codex", "config.toml"),
-            format: "toml",
-            warnings,
-        };
-    }
-    if (agent === "claude-code") {
-        return {
-            path: scope === "user"
-                ? join(homedir(), ".claude.json")
-                : join(cwd, ".mcp.json"),
-            format: "json",
-            warnings,
-        };
-    }
-    if (agent === "cursor") {
-        return {
-            path: scope === "user"
-                ? join(homedir(), ".cursor", "mcp.json")
-                : join(cwd, ".cursor", "mcp.json"),
-            format: "json",
-            warnings,
-        };
-    }
-    if (agent === "cline") {
-        if (scope === "project") {
-            warnings.push("Cline MCP config has no project scope today; writing to user-scope global VS Code storage instead.");
-        }
-        return {
-            path: vsCodeGlobalStoragePath(env, "saoudrizwan.claude-dev"),
-            format: "json",
-            warnings,
-        };
-    }
-    if (agent === "roo-code") {
-        if (scope === "project") {
-            warnings.push("Roo Code MCP config has no project scope today; writing to user-scope global VS Code storage instead.");
-        }
-        return {
-            path: vsCodeGlobalStoragePath(env, "rooveterinaryinc.roo-cline"),
-            format: "json",
-            warnings,
-        };
-    }
-    if (agent === "kilo-code") {
-        return {
-            path: scope === "user"
-                ? vsCodeGlobalStoragePath(env, "kilocode.kilo-code", "mcp_settings.json")
-                : join(cwd, ".kilocode", "mcp.json"),
-            format: "json",
-            warnings,
-        };
-    }
-    if (agent === "lm-studio") {
-        if (scope === "project") {
-            warnings.push("LM Studio's MCP config is app-global (~/.lmstudio/mcp.json); treating as user scope.");
-        }
-        return {
-            path: join(homedir(), ".lmstudio", "mcp.json"),
-            format: "json",
-            warnings,
-        };
-    }
-    if (agent === "gemini") {
-        if (scope === "project") {
-            warnings.push("Gemini extensions are user-scoped today; writing to ~/.gemini/extensions/summer-engine/ instead of project.");
-        }
-        return {
-            path: join(homedir(), ".gemini", "extensions", "summer-engine", "gemini-extension.json"),
-            format: "json",
-            warnings,
-        };
-    }
-    if (agent === "github-copilot") {
-        return {
-            path: scope === "user"
-                ? join(homedir(), ".copilot", "mcp-config.json")
-                : join(cwd, ".mcp.json"),
-            format: "json-copilot",
-            warnings,
-        };
-    }
-    if (agent === "vscode-copilot") {
-        return {
-            path: scope === "user"
-                ? vsCodeUserMcpPath(env)
-                : join(cwd, ".vscode", "mcp.json"),
-            format: "json-vscode",
-            warnings,
-        };
-    }
-    if (agent === "opencode") {
-        return {
-            path: scope === "user"
-                ? opencodeUserConfigPath(env)
-                : join(cwd, "opencode.json"),
-            format: "json-opencode",
-            warnings,
-        };
-    }
-    if (scope === "project") {
-        warnings.push("Devin Desktop (formerly Windsurf) documents MCP configuration as user-scoped; project scope writes .windsurf/mcp_config.json for teams that load workspace config.");
-    }
-    return {
-        path: scope === "user"
-            ? join(homedir(), ".codeium", "windsurf", "mcp_config.json")
-            : join(cwd, ".windsurf", "mcp_config.json"),
-        format: "json",
-        warnings,
-    };
+function resolveConfigTarget(spec, scope, cwd, env) {
+    const resolved = resolveMcpPath(spec, scope, defaultPathContext(env, cwd));
+    const override = env[spec.envOverride];
+    return { path: override ? resolve(override) : resolved.path, warnings: resolved.warnings };
 }
-function vsCodeGlobalStoragePath(env, extensionId, fileName = "cline_mcp_settings.json") {
-    const os = platform();
-    if (os === "win32") {
-        const appData = env.APPDATA ?? join(homedir(), "AppData", "Roaming");
-        return join(appData, "Code", "User", "globalStorage", extensionId, "settings", fileName);
-    }
-    if (os === "darwin") {
-        return join(homedir(), "Library", "Application Support", "Code", "User", "globalStorage", extensionId, "settings", fileName);
-    }
-    // Linux and other Unix
-    const xdg = env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
-    return join(xdg, "Code", "User", "globalStorage", extensionId, "settings", fileName);
-}
-function opencodeUserConfigPath(env) {
-    const os = platform();
-    if (os === "win32") {
-        const appData = env.APPDATA ?? join(homedir(), "AppData", "Roaming");
-        return join(appData, "opencode", "opencode.json");
-    }
-    const xdg = env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
-    return join(xdg, "opencode", "opencode.json");
-}
-function vsCodeUserMcpPath(env) {
-    const os = platform();
-    if (os === "win32") {
-        const appData = env.APPDATA ?? join(homedir(), "AppData", "Roaming");
-        return join(appData, "Code", "User", "mcp.json");
-    }
-    if (os === "darwin") {
-        return join(homedir(), "Library", "Application Support", "Code", "User", "mcp.json");
-    }
-    const xdg = env.XDG_CONFIG_HOME ?? join(homedir(), ".config");
-    return join(xdg, "Code", "User", "mcp.json");
-}
-function getConfigPathOverride(agent, env) {
-    if (agent === "codex")
-        return env.SUMMER_CODEX_CONFIG_FILE;
-    if (agent === "claude-code")
-        return env.SUMMER_CLAUDE_CONFIG_FILE;
-    if (agent === "cursor")
-        return env.SUMMER_CURSOR_MCP_CONFIG_FILE;
-    if (agent === "cline")
-        return env.SUMMER_CLINE_CONFIG_FILE;
-    if (agent === "roo-code")
-        return env.SUMMER_ROO_CODE_CONFIG_FILE;
-    if (agent === "kilo-code")
-        return env.SUMMER_KILO_CODE_CONFIG_FILE;
-    if (agent === "lm-studio")
-        return env.SUMMER_LM_STUDIO_CONFIG_FILE;
-    if (agent === "gemini")
-        return env.SUMMER_GEMINI_CONFIG_FILE;
-    if (agent === "github-copilot")
-        return env.SUMMER_GITHUB_COPILOT_CONFIG_FILE;
-    if (agent === "vscode-copilot")
-        return env.SUMMER_VSCODE_COPILOT_CONFIG_FILE;
-    if (agent === "opencode")
-        return env.SUMMER_OPENCODE_CONFIG_FILE;
-    return env.SUMMER_WINDSURF_MCP_CONFIG_FILE;
-}
-async function upsertJsonMcpConfig(path, server, write) {
+/** Merge one server entry into a JSON config file under the format's top-level key. */
+async function upsertJsonEntry(path, format, server, write) {
     const current = await readJsonConfig(path);
     const next = copyJsonObject(current);
-    next.mcpServers = mergeMcpServers(next.mcpServers, server);
+    const key = topLevelKey(format);
+    // OpenCode's file carries its schema; Kilo shares the shape but has its own.
+    if (format === "json-opencode" && typeof next.$schema !== "string" && /opencode\.json$/.test(path)) {
+        next.$schema = OPENCODE_SCHEMA;
+    }
+    next[key] = mergeNamedObject(next[key], SUMMER_MCP_SERVER_NAME, mcpEntry(format, server), key);
     const currentRendered = renderJsonFile(current);
     const nextRendered = renderJsonFile(next);
     const changed = currentRendered !== nextRendered;
@@ -417,14 +243,31 @@ async function upsertJsonMcpConfig(path, server, write) {
     }
     return { changed };
 }
-function mergeMcpServers(value, server) {
-    if (value !== undefined && !isJsonObject(value)) {
-        throw new Error("Existing mcpServers value must be a JSON object.");
+/**
+ * Merge one server entry into a YAML config (Goose, Hermes). Uses the yaml
+ * Document API so the user's comments and ordering survive; only the
+ * summer-engine node is replaced.
+ */
+async function upsertYamlConfig(path, keyPath, entry, write) {
+    const current = await readTextFileIfExists(path);
+    const doc = parseDocument(current.trim() === "" ? "{}" : current);
+    if (doc.errors.length > 0) {
+        throw new Error(`Could not parse YAML in ${path}: ${doc.errors[0].message}`);
     }
-    return {
-        ...(isJsonObject(value) ? value : {}),
-        [SUMMER_MCP_SERVER_NAME]: server,
-    };
+    if (!isMap(doc.contents)) {
+        throw new Error(`Expected ${path} to contain a YAML mapping.`);
+    }
+    const parent = doc.getIn(keyPath.slice(0, -1));
+    if (parent !== undefined && parent !== null && !isMap(parent)) {
+        throw new Error(`Existing ${keyPath[0]} value in ${path} must be a mapping.`);
+    }
+    doc.setIn(keyPath, doc.createNode(entry));
+    const next = doc.toString();
+    const changed = current !== next;
+    if (write && changed) {
+        await writeTextFile(path, next);
+    }
+    return { changed };
 }
 async function readJsonConfig(path) {
     if (!existsSync(path))
@@ -459,48 +302,67 @@ async function upsertCodexConfig(path, server, write) {
     }
     return { changed };
 }
-async function upsertOpencodeConfig(path, server, write) {
-    const current = await readJsonConfig(path);
-    const next = copyJsonObject(current);
-    if (typeof next.$schema !== "string") {
-        next.$schema = "https://opencode.ai/config.json";
-    }
-    const existingMcp = isJsonObject(next.mcp) ? next.mcp : {};
-    next.mcp = {
-        ...existingMcp,
-        [SUMMER_MCP_SERVER_NAME]: opencodeServerEntry(server),
-    };
-    const currentRendered = renderJsonFile(current);
-    const nextRendered = renderJsonFile(next);
-    const changed = currentRendered !== nextRendered;
+/**
+ * Mistral Vibe lists servers as a TOML array of tables:
+ *   [[mcp_servers]]
+ *   name = "summer-engine"
+ *   ...
+ * Replace the block whose name is ours, else append one.
+ */
+async function upsertTomlArrayConfig(path, server, write) {
+    const current = await readTextFileIfExists(path);
+    const next = upsertTomlArrayBlock(current, renderTomlArrayEntry(server));
+    const changed = current !== next;
     if (write && changed) {
-        await writeTextFile(path, nextRendered);
+        await writeTextFile(path, next);
     }
     return { changed };
 }
-async function upsertCopilotConfig(path, server, write) {
-    const current = await readJsonConfig(path);
-    const next = copyJsonObject(current);
-    next.mcpServers = mergeNamedObject(next.mcpServers, SUMMER_MCP_SERVER_NAME, copilotServerEntry(server), "mcpServers");
-    const currentRendered = renderJsonFile(current);
-    const nextRendered = renderJsonFile(next);
-    const changed = currentRendered !== nextRendered;
-    if (write && changed) {
-        await writeTextFile(path, nextRendered);
+export function upsertTomlArrayBlock(content, block) {
+    const lines = content.split(/\r?\n/);
+    const header = /^\s*\[\[mcp_servers\]\]\s*(?:#.*)?$/;
+    const nameLine = new RegExp(`^\\s*name\\s*=\\s*"${SUMMER_MCP_SERVER_NAME}"\\s*(?:#.*)?$`);
+    let start = -1;
+    let end = lines.length;
+    for (let index = 0; index < lines.length; index += 1) {
+        if (!header.test(lines[index]))
+            continue;
+        let blockEnd = lines.length;
+        for (let inner = index + 1; inner < lines.length; inner += 1) {
+            if (/^\s*\[/.test(lines[inner])) {
+                blockEnd = inner;
+                break;
+            }
+        }
+        if (lines.slice(index + 1, blockEnd).some((line) => nameLine.test(line))) {
+            start = index;
+            end = blockEnd;
+            break;
+        }
     }
-    return { changed };
+    if (start === -1) {
+        const trimmed = content.endsWith("\n") || content === "" ? content : `${content}\n`;
+        return `${trimmed}${trimmed === "" ? "" : "\n"}${block}`;
+    }
+    const replacement = block.trimEnd().split("\n");
+    if (lines[end] && lines[end].trim() !== "")
+        replacement.push("");
+    return ensureTrailingNewline([...lines.slice(0, start), ...replacement, ...lines.slice(end)].join("\n"));
 }
-async function upsertVsCodeMcpConfig(path, server, write) {
-    const current = await readJsonConfig(path);
-    const next = copyJsonObject(current);
-    next.servers = mergeNamedObject(next.servers, SUMMER_MCP_SERVER_NAME, vsCodeServerEntry(server), "servers");
-    const currentRendered = renderJsonFile(current);
-    const nextRendered = renderJsonFile(next);
-    const changed = currentRendered !== nextRendered;
-    if (write && changed) {
-        await writeTextFile(path, nextRendered);
+function renderTomlArrayEntry(server) {
+    const lines = [
+        "[[mcp_servers]]",
+        `name = ${tomlString(SUMMER_MCP_SERVER_NAME)}`,
+        `transport = "stdio"`,
+        `command = ${tomlString(server.command)}`,
+        `args = [${server.args.map(tomlString).join(", ")}]`,
+    ];
+    if (server.env && Object.keys(server.env).length > 0) {
+        lines.push(`env = { ${Object.entries(server.env)
+            .map(([key, value]) => `${key} = ${tomlString(value)}`)
+            .join(", ")} }`);
     }
-    return { changed };
+    return `${lines.join("\n")}\n`;
 }
 async function upsertGeminiExtension(path, server, write) {
     const current = await readJsonConfig(path);
@@ -596,39 +458,6 @@ function geminiExtensionManifest(server, bundled, base = {}) {
     };
     return manifest;
 }
-function opencodeServerEntry(server) {
-    const entry = {
-        type: "local",
-        command: [server.command, ...server.args],
-    };
-    if (server.env && Object.keys(server.env).length > 0) {
-        entry.environment = { ...server.env };
-    }
-    return entry;
-}
-function copilotServerEntry(server) {
-    const entry = {
-        type: "local",
-        command: server.command,
-        args: server.args,
-        tools: ["*"],
-    };
-    if (server.env && Object.keys(server.env).length > 0) {
-        entry.env = { ...server.env };
-    }
-    return entry;
-}
-function vsCodeServerEntry(server) {
-    const entry = {
-        type: "stdio",
-        command: server.command,
-        args: server.args,
-    };
-    if (server.env && Object.keys(server.env).length > 0) {
-        entry.env = { ...server.env };
-    }
-    return entry;
-}
 async function readTextFileIfExists(path) {
     if (!existsSync(path))
         return "";
@@ -706,35 +535,6 @@ async function writeTextFile(path, content) {
 function ensureTrailingNewline(value) {
     return value.endsWith("\n") ? value : `${value}\n`;
 }
-function createNextSteps(agent, scope, path) {
-    const restart = agent === "claude-code"
-        ? "Restart Claude Code or run /mcp in a new session."
-        : agent === "codex"
-            ? "Restart Codex or run /mcp in a new session."
-            : agent === "cursor"
-                ? "Restart Cursor and enable the summer-engine MCP server if prompted."
-                : agent === "cline"
-                    ? "Restart VS Code so Cline reloads its MCP config."
-                    : agent === "roo-code"
-                        ? "Restart VS Code so Roo Code reloads its MCP config."
-                        : agent === "kilo-code"
-                            ? "Restart VS Code so Kilo Code reloads its MCP config."
-                            : agent === "lm-studio"
-                                ? "Open LM Studio, toggle on the summer-engine MCP server in the Program tab, and raise the loaded model's context length to 32k or higher."
-                                : agent === "gemini"
-                                    ? "Run `summer skills install --all --agent gemini` if skills were not installed, then restart Gemini CLI (or `gemini extensions enable summer-engine` if it is disabled)."
-                                    : agent === "github-copilot"
-                                        ? "Restart Copilot CLI, or run /mcp reload and /skills reload in the active session."
-                                        : agent === "vscode-copilot"
-                                            ? "Restart VS Code or run MCP: List Servers, then start summer-engine in Copilot Agent mode."
-                                            : agent === "opencode"
-                                                ? "Restart OpenCode so it reloads opencode.json."
-                                                : "Restart Devin Desktop (formerly Windsurf) and refresh MCP servers from the agent settings.";
-    const projectTrust = scope === "project" && agent === "codex"
-        ? "Codex only loads project .codex/config.toml from trusted projects."
-        : null;
-    return [projectTrust, `Updated ${path}.`, restart].filter((step) => Boolean(step));
-}
 function formatError(error) {
     return error instanceof Error ? error.message : String(error);
 }