topchester-ai 0.60.0 → 0.61.0

package/dist/bin.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { t as runTopchesterCli } from "./cli-BCDXfYWi.mjs";
+import { t as runTopchesterCli } from "./cli-YPKTdpQH.mjs";
 //#region src/bin.ts
 await runTopchesterCli();
 //#endregion

package/dist/{cli-BCDXfYWi.mjs → cli-YPKTdpQH.mjs}

@@ -6555,6 +6555,37 @@ async function addProjectBashAllowExactRule(workspaceRoot, command) {
 		allowExact
 	};
 }
+async function addMcpStdioServerConfig(configPath, options) {
+	const serverName = options.serverName.trim();
+	if (!isValidMcpServerName(serverName)) throw new Error(`invalid MCP server name "${options.serverName}" (use letters, numbers, "-", "_")`);
+	const command = options.command.trim();
+	if (!command) throw new Error("MCP stdio command is required.");
+	const config = readConfigObject(configPath);
+	const mcp = ensurePlainObjectProperty(config, "mcp");
+	const replaced = mcp[serverName] !== void 0;
+	const env = options.env ?? {};
+	const server = {
+		type: "stdio",
+		command,
+		args: options.args ?? [],
+		...Object.keys(env).length > 0 ? { env } : {}
+	};
+	mcp[serverName] = server;
+	mkdirSync(dirname(configPath), {
+		recursive: true,
+		mode: 448
+	});
+	parseConfigFile(configPath, config);
+	await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`);
+	return {
+		path: configPath,
+		serverName,
+		command,
+		args: server.args,
+		env,
+		replaced
+	};
+}
 function readProjectConfigObject(configPath) {
 	return readConfigObject(configPath);
 }
@@ -6592,6 +6623,9 @@ function ensureStringArrayProperty(parent, key) {
 	if (!Array.isArray(value) || !value.every((entry) => typeof entry === "string")) throw new Error(`Invalid Topchester config property '${key}': expected a string array.`);
 	return value;
 }
+function isValidMcpServerName(name) {
+	return name.length > 0 && /^[A-Za-z0-9_-]+$/u.test(name);
+}
 function readConfigFile(path) {
 	try {
 		return parseJsonc(readFileSync(path, "utf8"));
@@ -15729,6 +15763,25 @@ function createTopchesterProgram() {
 			process.exitCode = 1;
 		}
 	});
+	program.command("mcp").description("manage MCP servers").command("add").usage("[options] <server-name> -- <stdio server-command>").description("add or replace a stdio MCP server").argument("<server-name>", "server name").argument("<command...>", "stdio server command after --").option("--env <KEY=VALUE>", "environment variable for the server process", collectEnvPair, {}).addHelpText("after", formatMcpAddHelp).action(async (serverName, commandParts, options) => {
+		try {
+			const [command, ...args] = commandParts;
+			if (!command) throw new Error("Usage: topchester mcp add <server-name> -- <stdio server-command>");
+			const result = await addMcpStdioServerConfig(getWritableConfigPathFromProgram(program), {
+				serverName,
+				command,
+				args,
+				env: options.env
+			});
+			console.log(`${result.replaced ? "Updated" : "Added"} MCP stdio server "${result.serverName}".`);
+			console.log(`config: ${result.path}`);
+			console.log(`command: ${[result.command, ...result.args].join(" ")}`);
+			if (Object.keys(result.env).length > 0) console.log(`env: ${Object.keys(result.env).join(", ")}`);
+		} catch (error) {
+			console.error(formatStartupError(error));
+			process.exitCode = 1;
+		}
+	});
 	program.command("run").description("run one prompt or slash command without opening the TUI").argument("<prompt...>", "prompt text or slash command").option("--model <model>", "override the agent.primary model for this run").option("--timeout <ms>", "timeout for the run in milliseconds", parsePositiveInteger).option("--json", "write JSONL run events to stdout").option("--output-json <path>", "write JSONL run events to a file").action(async (promptParts, options) => {
 		const context = createContextFromOptions(program);
 		const globalOptions = program.opts();
@@ -15876,6 +15929,17 @@ function formatAuthLoginHelp() {
 		"  Topchester prints a browser URL and one-time code, waits for approval, then stores tokens in the global auth store."
 	].join("\n");
 }
+function formatMcpAddHelp() {
+	return [
+		"",
+		ui.label("Examples:"),
+		"  topchester mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .",
+		"  topchester mcp add github --env GITHUB_PERSONAL_ACCESS_TOKEN=ghp_xxx -- npx -y @modelcontextprotocol/server-github",
+		"",
+		ui.label("What happens:"),
+		"  Writes to --config when provided, otherwise to the global user config."
+	].join("\n");
+}
 function formatAuthLoginUsageError(reason) {
 	return [
 		ui.error(reason),
@@ -15950,6 +16014,10 @@ function getContextOptionsFromProgram(program) {
 		devFlags: options.dev
 	};
 }
+function getWritableConfigPathFromProgram(program) {
+	const options = program.opts();
+	return options.config ? isAbsolute(options.config) ? options.config : resolve(cwd(), options.config) : getGlobalTopchesterConfigPath();
+}
 async function executeKbSearchCommand(program, queryParts, options) {
 	const context = createContextFromOptions(program);
 	const query = queryParts.join(" ");
@@ -15983,6 +16051,16 @@ function formatStartupError(error) {
 function collectDevFlag(flag, flags) {
 	return [...flags, flag];
 }
+function collectEnvPair(raw, env) {
+	const separatorIndex = raw.indexOf("=");
+	if (separatorIndex <= 0) throw new Error("Environment entries must be in KEY=VALUE form.");
+	const key = raw.slice(0, separatorIndex).trim();
+	if (!key) throw new Error("Environment entries must be in KEY=VALUE form.");
+	return {
+		...env,
+		[key]: raw.slice(separatorIndex + 1)
+	};
+}
 function parsePositiveInteger(value) {
 	const parsed = Number(value);
 	if (!Number.isInteger(parsed) || parsed <= 0) throw new Error("Expected a positive integer.");
@@ -16004,4 +16082,4 @@ function formatDryRunSyncStatus(status) {
 //#endregion
 export { runTopchesterCli as t };
 
-//# sourceMappingURL=cli-BCDXfYWi.mjs.map
+//# sourceMappingURL=cli-YPKTdpQH.mjs.map