@agntn/harnesses 0.2.0 → 0.2.1

package/dist/_chunks/mcp-servers.mjs

@@ -1,38 +1,8 @@
-import { isHarnessId, listHarnesses } from "./agents-sync.mjs";
+import { isHarnessId, listHarnesses } from "./prompt-sync.mjs";
 import { mcpAdd, mcpList, mcpRemove, mcpSync } from "./tool-operations.mjs";
-import { stripVTControlCharacters } from "node:util";
+import { formatArgs, report } from "./output.mjs";
 import { defineCommand } from "citty";
 import { consola } from "consola";
-import { encode } from "@toon-format/toon";
-const formatArgs = {
-	json: {
-		type: "boolean",
-		description: "Output as JSON"
-	},
-	toon: {
-		type: "boolean",
-		description: "Output as TOON"
-	}
-};
-const UNSAFE_TERMINAL_CONTROLS = /[\u0000-\u0008\u000B-\u001F\u007F-\u009F]/g;
-function sanitize(text) {
-	return stripVTControlCharacters(text ?? "").replace(UNSAFE_TERMINAL_CONTROLS, " ");
-}
-function report(result, args) {
-	if (result.isError) {
-		consola.error(sanitize(result.content[0]?.text));
-		process.exit(1);
-	}
-	if (args.json) {
-		console.log(JSON.stringify(result.details, null, 2));
-		return;
-	}
-	if (args.toon) {
-		console.log(encode(result.details));
-		return;
-	}
-	console.log(sanitize(result.content[0]?.text));
-}
 function requireHarnessId(id) {
 	if (!isHarnessId(id)) {
 		consola.error(`Unknown harness: ${id}\nKnown: ${listHarnesses().join(", ")}`);
@@ -95,13 +65,14 @@ var mcp_servers_default = defineCommand({
 			},
 			run({ args }) {
 				const env = args.env ? Object.fromEntries(args.env.split(",").map((pair) => pair.split(/=(.*)/s)).filter((pair) => pair[0]).map((pair) => [pair[0], pair[1] ?? ""])) : void 0;
-				report(mcpAdd(requireHarnessId(args.id), {
+				const result = mcpAdd(requireHarnessId(args.id), {
 					name: args.name,
 					...args.command ? { command: args.command } : {},
 					...args.args ? { args: args.args.split(" ").filter(Boolean) } : {},
 					...env ? { env } : {},
 					...args.url ? { url: args.url } : {}
-				}, args.scope === "project" ? "project" : "user"), args);
+				}, args.scope === "project" ? "project" : "user");
+				report(result, args);
 			}
 		}),
 		sync: defineCommand({

package/dist/_chunks/mcp-servers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-servers.mjs","names":["toToon"],"sources":["../../src/commands/mcp-servers.ts"],"sourcesContent":["import { stripVTControlCharacters } from \"node:util\";\nimport { defineCommand } from \"citty\";\nimport { consola } from \"consola\";\nimport { encode as toToon } from \"@toon-format/toon\";\nimport { isHarnessId, listHarnesses } from \"../registry.ts\";\nimport { mcpAdd, mcpList, mcpRemove, mcpSync, type ToolResult } from \"../tool-operations.ts\";\n\nconst formatArgs = {\n  json: { type: \"boolean\" as const, description: \"Output as JSON\" },\n  toon: { type: \"boolean\" as const, description: \"Output as TOON\" },\n};\n\n// MCP listings echo values read from project-controlled config files, so a\n// malicious server name could smuggle ANSI/OSC sequences into the terminal.\n// oxlint-disable-next-line no-control-regex -- Terminal control bytes are precisely what this boundary removes.\nconst UNSAFE_TERMINAL_CONTROLS = /[\\u0000-\\u0008\\u000B-\\u001F\\u007F-\\u009F]/g;\n\nfunction sanitize(text: string | undefined): string {\n  return stripVTControlCharacters(text ?? \"\").replace(UNSAFE_TERMINAL_CONTROLS, \" \");\n}\n\n/**\n * Emits one tool result: machine format when asked, sanitized text otherwise.\n *\n * @param result - Tool result to emit.\n * @param args - Selected output-format flags.\n */\nfunction report(\n  result: ToolResult<unknown>,\n  args: Readonly<{ json?: boolean; toon?: boolean }>,\n): void {\n  if (result.isError) {\n    consola.error(sanitize(result.content[0]?.text));\n    process.exit(1);\n  }\n  if (args.json) {\n    console.log(JSON.stringify(result.details, null, 2));\n    return;\n  }\n  if (args.toon) {\n    console.log(toToon(result.details));\n    return;\n  }\n  console.log(sanitize(result.content[0]?.text));\n}\n\nfunction requireHarnessId(id: string): string {\n  if (!isHarnessId(id)) {\n    consola.error(`Unknown harness: ${id}\\nKnown: ${listHarnesses().join(\", \")}`);\n    process.exit(1);\n  }\n  return id;\n}\n\nexport default defineCommand({\n  meta: { description: \"Manage MCP servers across harness configs\" },\n  subCommands: {\n    list: defineCommand({\n      meta: { description: \"List configured MCP servers, normalized\" },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: false },\n        ...formatArgs,\n      },\n      run({ args }) {\n        const id = args.id === undefined ? undefined : requireHarnessId(args.id as string);\n        report(mcpList(id), args);\n      },\n    }),\n    add: defineCommand({\n      meta: { description: \"Add or replace one MCP server in a harness config\" },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: true },\n        name: { type: \"positional\" as const, description: \"Server name\", required: true },\n        command: { type: \"string\" as const, description: \"Binary for a stdio server\" },\n        args: {\n          type: \"string\" as const,\n          description: \"Space-separated arguments for a stdio server\",\n        },\n        env: { type: \"string\" as const, description: \"Comma-separated K=V environment variables\" },\n        url: { type: \"string\" as const, description: \"URL for an http/sse server\" },\n        scope: { type: \"string\" as const, description: \"user (default) or project\" },\n        ...formatArgs,\n      },\n      run({ args }) {\n        const env = args.env\n          ? Object.fromEntries(\n              args.env\n                .split(\",\")\n                .map((pair) => pair.split(/=(.*)/s))\n                .filter((pair) => pair[0])\n                .map((pair) => [pair[0] as string, pair[1] ?? \"\"]),\n            )\n          : undefined;\n        const result = mcpAdd(\n          requireHarnessId(args.id as string),\n          {\n            name: args.name as string,\n            ...(args.command ? { command: args.command } : {}),\n            ...(args.args ? { args: args.args.split(\" \").filter(Boolean) } : {}),\n            ...(env ? { env } : {}),\n            ...(args.url ? { url: args.url } : {}),\n          },\n          args.scope === \"project\" ? \"project\" : \"user\",\n        );\n        report(result, args);\n      },\n    }),\n    sync: defineCommand({\n      meta: {\n        description: \"Reset harness configs to the master list from ~/.config/agntn/mcp.jsonc\",\n      },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: false },\n        ...formatArgs,\n      },\n      run({ args }) {\n        const id = args.id === undefined ? undefined : requireHarnessId(args.id as string);\n        report(mcpSync(id), args);\n      },\n    }),\n    remove: defineCommand({\n      meta: { description: \"Remove one MCP server from a harness config\" },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: true },\n        name: { type: \"positional\" as const, description: \"Server name\", required: true },\n        scope: { type: \"string\" as const, description: \"user (default) or project\" },\n        ...formatArgs,\n      },\n      run({ args }) {\n        report(\n          mcpRemove(\n            requireHarnessId(args.id as string),\n            args.name as string,\n            args.scope === \"project\" ? \"project\" : \"user\",\n          ),\n          args,\n        );\n      },\n    }),\n  },\n});\n"],"mappings":"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"}
+{"version":3,"file":"mcp-servers.mjs","names":[],"sources":["../../src/commands/mcp-servers.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { consola } from \"consola\";\nimport { isHarnessId, listHarnesses } from \"../registry.ts\";\nimport { mcpAdd, mcpList, mcpRemove, mcpSync } from \"../tool-operations.ts\";\nimport { formatArgs, report } from \"./output.ts\";\n\nfunction requireHarnessId(id: string): string {\n  if (!isHarnessId(id)) {\n    consola.error(`Unknown harness: ${id}\\nKnown: ${listHarnesses().join(\", \")}`);\n    process.exit(1);\n  }\n  return id;\n}\n\nexport default defineCommand({\n  meta: { description: \"Manage MCP servers across harness configs\" },\n  subCommands: {\n    list: defineCommand({\n      meta: { description: \"List configured MCP servers, normalized\" },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: false },\n        ...formatArgs,\n      },\n      run({ args }) {\n        const id = args.id === undefined ? undefined : requireHarnessId(args.id as string);\n        report(mcpList(id), args);\n      },\n    }),\n    add: defineCommand({\n      meta: { description: \"Add or replace one MCP server in a harness config\" },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: true },\n        name: { type: \"positional\" as const, description: \"Server name\", required: true },\n        command: { type: \"string\" as const, description: \"Binary for a stdio server\" },\n        args: {\n          type: \"string\" as const,\n          description: \"Space-separated arguments for a stdio server\",\n        },\n        env: { type: \"string\" as const, description: \"Comma-separated K=V environment variables\" },\n        url: { type: \"string\" as const, description: \"URL for an http/sse server\" },\n        scope: { type: \"string\" as const, description: \"user (default) or project\" },\n        ...formatArgs,\n      },\n      run({ args }) {\n        const env = args.env\n          ? Object.fromEntries(\n              args.env\n                .split(\",\")\n                .map((pair) => pair.split(/=(.*)/s))\n                .filter((pair) => pair[0])\n                .map((pair) => [pair[0] as string, pair[1] ?? \"\"]),\n            )\n          : undefined;\n        const result = mcpAdd(\n          requireHarnessId(args.id as string),\n          {\n            name: args.name as string,\n            ...(args.command ? { command: args.command } : {}),\n            ...(args.args ? { args: args.args.split(\" \").filter(Boolean) } : {}),\n            ...(env ? { env } : {}),\n            ...(args.url ? { url: args.url } : {}),\n          },\n          args.scope === \"project\" ? \"project\" : \"user\",\n        );\n        report(result, args);\n      },\n    }),\n    sync: defineCommand({\n      meta: {\n        description: \"Reset harness configs to the master list from ~/.config/agntn/mcp.jsonc\",\n      },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: false },\n        ...formatArgs,\n      },\n      run({ args }) {\n        const id = args.id === undefined ? undefined : requireHarnessId(args.id as string);\n        report(mcpSync(id), args);\n      },\n    }),\n    remove: defineCommand({\n      meta: { description: \"Remove one MCP server from a harness config\" },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: true },\n        name: { type: \"positional\" as const, description: \"Server name\", required: true },\n        scope: { type: \"string\" as const, description: \"user (default) or project\" },\n        ...formatArgs,\n      },\n      run({ args }) {\n        report(\n          mcpRemove(\n            requireHarnessId(args.id as string),\n            args.name as string,\n            args.scope === \"project\" ? \"project\" : \"user\",\n          ),\n          args,\n        );\n      },\n    }),\n  },\n});\n"],"mappings":";;;;;AAMA,SAAS,iBAAiB,IAAoB;CAC5C,IAAI,CAAC,YAAY,EAAE,GAAG;EACpB,QAAQ,MAAM,oBAAoB,GAAG,WAAW,cAAc,CAAC,CAAC,KAAK,IAAI,GAAG;EAC5E,QAAQ,KAAK,CAAC;CAChB;CACA,OAAO;AACT;AAEA,IAAA,sBAAe,cAAc;CAC3B,MAAM,EAAE,aAAa,4CAA4C;CACjE,aAAa;EACX,MAAM,cAAc;GAClB,MAAM,EAAE,aAAa,0CAA0C;GAC/D,MAAM;IACJ,IAAI;KAAE,MAAM;KAAuB,aAAa;KAAc,UAAU;IAAM;IAC9E,GAAG;GACL;GACA,IAAI,EAAE,QAAQ;IACZ,MAAM,KAAK,KAAK,OAAO,KAAA,IAAY,KAAA,IAAY,iBAAiB,KAAK,EAAY;IACjF,OAAO,QAAQ,EAAE,GAAG,IAAI;GAC1B;EACF,CAAC;EACD,KAAK,cAAc;GACjB,MAAM,EAAE,aAAa,oDAAoD;GACzE,MAAM;IACJ,IAAI;KAAE,MAAM;KAAuB,aAAa;KAAc,UAAU;IAAK;IAC7E,MAAM;KAAE,MAAM;KAAuB,aAAa;KAAe,UAAU;IAAK;IAChF,SAAS;KAAE,MAAM;KAAmB,aAAa;IAA4B;IAC7E,MAAM;KACJ,MAAM;KACN,aAAa;IACf;IACA,KAAK;KAAE,MAAM;KAAmB,aAAa;IAA4C;IACzF,KAAK;KAAE,MAAM;KAAmB,aAAa;IAA6B;IAC1E,OAAO;KAAE,MAAM;KAAmB,aAAa;IAA4B;IAC3E,GAAG;GACL;GACA,IAAI,EAAE,QAAQ;IACZ,MAAM,MAAM,KAAK,MACb,OAAO,YACL,KAAK,IACF,MAAM,GAAG,CAAC,CACV,KAAK,SAAS,KAAK,MAAM,QAAQ,CAAC,CAAC,CACnC,QAAQ,SAAS,KAAK,EAAE,CAAC,CACzB,KAAK,SAAS,CAAC,KAAK,IAAc,KAAK,MAAM,EAAE,CAAC,CACrD,IACA,KAAA;IACJ,MAAM,SAAS,OACb,iBAAiB,KAAK,EAAY,GAClC;KACE,MAAM,KAAK;KACX,GAAI,KAAK,UAAU,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;KAChD,GAAI,KAAK,OAAO,EAAE,MAAM,KAAK,KAAK,MAAM,GAAG,CAAC,CAAC,OAAO,OAAO,EAAE,IAAI,CAAC;KAClE,GAAI,MAAM,EAAE,IAAI,IAAI,CAAC;KACrB,GAAI,KAAK,MAAM,EAAE,KAAK,KAAK,IAAI,IAAI,CAAC;IACtC,GACA,KAAK,UAAU,YAAY,YAAY,MACzC;IACA,OAAO,QAAQ,IAAI;GACrB;EACF,CAAC;EACD,MAAM,cAAc;GAClB,MAAM,EACJ,aAAa,0EACf;GACA,MAAM;IACJ,IAAI;KAAE,MAAM;KAAuB,aAAa;KAAc,UAAU;IAAM;IAC9E,GAAG;GACL;GACA,IAAI,EAAE,QAAQ;IACZ,MAAM,KAAK,KAAK,OAAO,KAAA,IAAY,KAAA,IAAY,iBAAiB,KAAK,EAAY;IACjF,OAAO,QAAQ,EAAE,GAAG,IAAI;GAC1B;EACF,CAAC;EACD,QAAQ,cAAc;GACpB,MAAM,EAAE,aAAa,8CAA8C;GACnE,MAAM;IACJ,IAAI;KAAE,MAAM;KAAuB,aAAa;KAAc,UAAU;IAAK;IAC7E,MAAM;KAAE,MAAM;KAAuB,aAAa;KAAe,UAAU;IAAK;IAChF,OAAO;KAAE,MAAM;KAAmB,aAAa;IAA4B;IAC3E,GAAG;GACL;GACA,IAAI,EAAE,QAAQ;IACZ,OACE,UACE,iBAAiB,KAAK,EAAY,GAClC,KAAK,MACL,KAAK,UAAU,YAAY,YAAY,MACzC,GACA,IACF;GACF;EACF,CAAC;CACH;AACF,CAAC"}

package/dist/_chunks/mcp.mjs

@@ -1,166 +1,16 @@
-import { Check, Errors, typebox_exports } from "./libs/typebox.mjs";
-import { version } from "./types.mjs";
-import { harnessToolSchemas } from "./tool-schemas.mjs";
-import { agentsSync, detectHarnesses, harnessInfo, listHarnessModels, mcpAdd, mcpList, mcpRemove, mcpSync, runHarness } from "./tool-operations.mjs";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-const READ_ONLY = {
-	readOnlyHint: true,
-	destructiveHint: false,
-	idempotentHint: true,
-	openWorldHint: false
-};
-const EXEC_READ = {
-	readOnlyHint: false,
-	destructiveHint: false,
-	idempotentHint: false,
-	openWorldHint: true
-};
-const CONFIG_WRITE = {
-	readOnlyHint: false,
-	destructiveHint: true,
-	idempotentHint: true,
-	openWorldHint: false
-};
-const schemas = harnessToolSchemas(typebox_exports);
-const tools = [
-	{
-		name: "harnesses_detect",
-		title: "Harnesses Detect",
-		description: "List every known AI coding harness with its install state and version.",
-		inputSchema: schemas.detect,
-		annotations: READ_ONLY,
-		execute: () => detectHarnesses()
-	},
-	{
-		name: "harnesses_info",
-		title: "Harnesses Info",
-		description: "Full metadata for one or more AI coding harnesses, including supported invocation and model operations, configuration, sessions, instructions, skills, commands, hooks, and resolved paths.",
-		inputSchema: schemas.info,
-		annotations: READ_ONLY,
-		execute: (args) => harnessInfo(args.id)
-	},
-	{
-		name: "harnesses_models",
-		title: "Harnesses Models",
-		description: "List the models currently available to one AI coding harness through its native CLI, normalized across providers. An optional search filter is passed to harnesses that support it. The command may load project configuration and extensions.",
-		inputSchema: schemas.models,
-		annotations: EXEC_READ,
-		execute: (args, signal) => listHarnessModels(args.id, {
-			search: args.search,
-			cwd: args.cwd,
-			timeoutSeconds: args.timeoutSeconds,
-			signal
-		})
-	},
-	{
-		name: "harnesses_run",
-		title: "Harnesses Run",
-		description: "Run one prompt through an AI coding harness's normalized non-interactive invocation and return its output. Pass tools=true whenever the task needs harness tools, including Grok native X search. Add readOnly=true to require native read-only tool enforcement. Pass tools=false only for an advisor without tools. Unsupported modes never widen access.",
-		inputSchema: schemas.run,
-		annotations: {
-			readOnlyHint: false,
-			destructiveHint: true,
-			idempotentHint: false,
-			openWorldHint: true
-		},
-		execute: (args, signal) => runHarness(args.id, args.prompt, {
-			cwd: args.cwd,
-			model: args.model,
-			timeoutSeconds: args.timeoutSeconds,
-			signal,
-			structured: args.structured,
-			tools: args.tools,
-			readOnly: args.readOnly
-		})
-	},
-	{
-		name: "harnesses_mcp_list",
-		title: "Harnesses MCP List",
-		description: "List the MCP servers configured in each harness's config files, normalized across dialects. Omit id to scan every harness.",
-		inputSchema: schemas.mcpList,
-		annotations: READ_ONLY,
-		execute: (args) => mcpList(args.id)
-	},
-	{
-		name: "harnesses_mcp_add",
-		title: "Harnesses MCP Add",
-		description: "Add or replace one MCP server in a harness config. JSON configs are rewritten; TOML configs get a surgical, comment-preserving edit.",
-		inputSchema: schemas.mcpAdd,
-		annotations: CONFIG_WRITE,
-		execute: (args) => mcpAdd(args.id, args, args.scope ?? "user")
-	},
-	{
-		name: "harnesses_mcp_sync",
-		title: "Harnesses MCP Sync",
-		description: "Reset every harness's user-scope MCP config to exactly the master list from ~/.config/agntn/mcp.jsonc: servers are added, replaced, and extras removed. Excluded harnesses keep their own servers, but master-listed names are withdrawn from them.",
-		inputSchema: schemas.mcpSync,
-		annotations: CONFIG_WRITE,
-		execute: (args) => mcpSync(args.id)
-	},
-	{
-		name: "harnesses_agents_sync",
-		title: "Harnesses Agents Sync",
-		description: "Link every harness's global instructions file and declared companions to the master bundle, so edits made through any harness land in one place. Diverged copies are backed up and relinked. Pass check to only report.",
-		inputSchema: schemas.agentsSync,
-		annotations: CONFIG_WRITE,
-		execute: (args) => agentsSync(args.id, args.check === true)
-	},
-	{
-		name: "harnesses_mcp_remove",
-		title: "Harnesses MCP Remove",
-		description: "Remove one MCP server from a harness config. JSON configs are rewritten; TOML configs get a surgical, comment-preserving edit.",
-		inputSchema: schemas.mcpRemove,
-		annotations: CONFIG_WRITE,
-		execute: (args) => mcpRemove(args.id, args.name, args.scope ?? "user")
+import { defineCommand } from "citty";
+import { LogLevels, consola } from "consola";
+var mcp_default = defineCommand({
+	meta: {
+		name: "mcp",
+		description: "Run the harnesses MCP server over stdio"
+	},
+	async run() {
+		consola.level = LogLevels.warn;
+		const [{ createMcpServer }, { StdioServerTransport }] = await Promise.all([import("../mcp.mjs"), import("@modelcontextprotocol/sdk/server/stdio.js")]);
+		await createMcpServer().connect(new StdioServerTransport());
 	}
-];
-function validationError(schema, value) {
-	const first = Errors(schema, value)[0];
-	if (!first) return "Invalid arguments";
-	return `Invalid arguments at ${first.instancePath || "/"}: ${first.message}`;
-}
-function errorResult(text) {
-	return {
-		content: [{
-			type: "text",
-			text: text.replaceAll(/\p{Cc}/gu, " ")
-		}],
-		isError: true
-	};
-}
-function toCallToolResult(result) {
-	return {
-		content: result.content,
-		...result.isError === void 0 ? {} : { isError: result.isError }
-	};
-}
-function createMcpServer() {
-	const toolsByName = new Map(tools.map((tool) => [tool.name, tool]));
-	const server = new Server({
-		name: "harnesses",
-		version
-	}, { capabilities: { tools: {} } });
-	server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: tools.map((tool) => ({
-		name: tool.name,
-		title: tool.title,
-		description: tool.description,
-		inputSchema: tool.inputSchema,
-		annotations: tool.annotations
-	})) }));
-	server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
-		const tool = toolsByName.get(request.params.name);
-		if (!tool) return errorResult(`Unknown harnesses tool: ${JSON.stringify(request.params.name)}`);
-		const args = request.params.arguments ?? {};
-		if (!Check(tool.inputSchema, args)) return errorResult(validationError(tool.inputSchema, args));
-		try {
-			return toCallToolResult(await tool.execute(args, extra.signal));
-		} catch (error) {
-			return errorResult(`${tool.name} failed: ${error instanceof Error ? error.message : String(error)}`);
-		}
-	});
-	return server;
-}
-export { createMcpServer };
+});
+export { mcp_default as default };
 
 //# sourceMappingURL=mcp.mjs.map

package/dist/_chunks/mcp.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.mjs","names":["Type","Value.Errors","Value.Check"],"sources":["../../src/mcp.ts"],"sourcesContent":["import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n  type CallToolResult,\n  type Tool,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { Type, type TSchema } from \"typebox\";\nimport { Value } from \"typebox/value\";\nimport {\n  detectHarnesses,\n  harnessInfo,\n  listHarnessModels,\n  mcpAdd,\n  mcpList,\n  mcpRemove,\n  mcpSync,\n  agentsSync,\n  runHarness,\n  type McpServerParams,\n  type ToolResult,\n} from \"./tool-operations.ts\";\nimport { harnessToolSchemas } from \"./tool-schemas.ts\";\nimport { version } from \"./types.ts\";\n\ninterface ToolDefinition {\n  name: string;\n  title: string;\n  description: string;\n  inputSchema: TSchema;\n  annotations: Tool[\"annotations\"];\n  execute(\n    args: Readonly<Record<string, unknown>>,\n    signal: AbortSignal,\n  ): ToolResult<unknown> | Promise<ToolResult<unknown>>;\n}\n\nconst READ_ONLY: Tool[\"annotations\"] = {\n  readOnlyHint: true,\n  destructiveHint: false,\n  idempotentHint: true,\n  openWorldHint: false,\n};\n\nconst EXEC_READ: Tool[\"annotations\"] = {\n  readOnlyHint: false,\n  destructiveHint: false,\n  idempotentHint: false,\n  openWorldHint: true,\n};\n\nconst CONFIG_WRITE: Tool[\"annotations\"] = {\n  readOnlyHint: false,\n  destructiveHint: true,\n  idempotentHint: true,\n  openWorldHint: false,\n};\n\nconst schemas = harnessToolSchemas<TSchema, TSchema>(Type);\n\nconst tools: ToolDefinition[] = [\n  {\n    name: \"harnesses_detect\",\n    title: \"Harnesses Detect\",\n    description: \"List every known AI coding harness with its install state and version.\",\n    inputSchema: schemas.detect,\n    annotations: READ_ONLY,\n    execute: () => detectHarnesses(),\n  },\n  {\n    name: \"harnesses_info\",\n    title: \"Harnesses Info\",\n    description:\n      \"Full metadata for one or more AI coding harnesses, including supported invocation and model operations, configuration, sessions, instructions, skills, commands, hooks, and resolved paths.\",\n    inputSchema: schemas.info,\n    annotations: READ_ONLY,\n    execute: (args) => harnessInfo(args.id as string | string[]),\n  },\n  {\n    name: \"harnesses_models\",\n    title: \"Harnesses Models\",\n    description:\n      \"List the models currently available to one AI coding harness through its native CLI, normalized across providers. An optional search filter is passed to harnesses that support it. The command may load project configuration and extensions.\",\n    inputSchema: schemas.models,\n    annotations: EXEC_READ,\n    execute: (args, signal) =>\n      listHarnessModels(args.id as string, {\n        search: args.search as string | undefined,\n        cwd: args.cwd as string | undefined,\n        timeoutSeconds: args.timeoutSeconds as number | undefined,\n        signal,\n      }),\n  },\n  {\n    name: \"harnesses_run\",\n    title: \"Harnesses Run\",\n    description:\n      \"Run one prompt through an AI coding harness's normalized non-interactive invocation and return its output. Pass tools=true whenever the task needs harness tools, including Grok native X search. Add readOnly=true to require native read-only tool enforcement. Pass tools=false only for an advisor without tools. Unsupported modes never widen access.\",\n    inputSchema: schemas.run,\n    annotations: {\n      readOnlyHint: false,\n      destructiveHint: true,\n      idempotentHint: false,\n      openWorldHint: true,\n    },\n    execute: (args, signal) =>\n      runHarness(args.id as string, args.prompt as string, {\n        cwd: args.cwd as string | undefined,\n        model: args.model as string | undefined,\n        timeoutSeconds: args.timeoutSeconds as number | undefined,\n        signal,\n        structured: args.structured as boolean | undefined,\n        tools: args.tools as boolean | undefined,\n        readOnly: args.readOnly as boolean | undefined,\n      }),\n  },\n  {\n    name: \"harnesses_mcp_list\",\n    title: \"Harnesses MCP List\",\n    description:\n      \"List the MCP servers configured in each harness's config files, normalized across dialects. Omit id to scan every harness.\",\n    inputSchema: schemas.mcpList,\n    annotations: READ_ONLY,\n    execute: (args) => mcpList(args.id as string | undefined),\n  },\n  {\n    name: \"harnesses_mcp_add\",\n    title: \"Harnesses MCP Add\",\n    description:\n      \"Add or replace one MCP server in a harness config. JSON configs are rewritten; TOML configs get a surgical, comment-preserving edit.\",\n    inputSchema: schemas.mcpAdd,\n    annotations: CONFIG_WRITE,\n    execute: (args) =>\n      mcpAdd(\n        args.id as string,\n        args as unknown as McpServerParams,\n        (args.scope as \"user\" | \"project\") ?? \"user\",\n      ),\n  },\n  {\n    name: \"harnesses_mcp_sync\",\n    title: \"Harnesses MCP Sync\",\n    description:\n      \"Reset every harness's user-scope MCP config to exactly the master list from ~/.config/agntn/mcp.jsonc: servers are added, replaced, and extras removed. Excluded harnesses keep their own servers, but master-listed names are withdrawn from them.\",\n    inputSchema: schemas.mcpSync,\n    annotations: CONFIG_WRITE,\n    execute: (args) => mcpSync(args.id as string | undefined),\n  },\n  {\n    name: \"harnesses_agents_sync\",\n    title: \"Harnesses Agents Sync\",\n    description:\n      \"Link every harness's global instructions file and declared companions to the master bundle, so edits made through any harness land in one place. Diverged copies are backed up and relinked. Pass check to only report.\",\n    inputSchema: schemas.agentsSync,\n    annotations: CONFIG_WRITE,\n    execute: (args) => agentsSync(args.id as string | undefined, args.check === true),\n  },\n  {\n    name: \"harnesses_mcp_remove\",\n    title: \"Harnesses MCP Remove\",\n    description:\n      \"Remove one MCP server from a harness config. JSON configs are rewritten; TOML configs get a surgical, comment-preserving edit.\",\n    inputSchema: schemas.mcpRemove,\n    annotations: CONFIG_WRITE,\n    execute: (args) =>\n      mcpRemove(\n        args.id as string,\n        args.name as string,\n        (args.scope as \"user\" | \"project\") ?? \"user\",\n      ),\n  },\n];\n\n/**\n * Formats the first TypeBox validation failure for an MCP client.\n *\n * @param schema - Schema that rejected the value.\n * @param value - Rejected input value.\n * @returns {string} A client-facing validation message.\n */\nfunction validationError(schema: TSchema, value: unknown): string {\n  const first = Value.Errors(schema, value)[0];\n  if (!first) return \"Invalid arguments\";\n  return `Invalid arguments at ${first.instancePath || \"/\"}: ${first.message}`;\n}\n\n/**\n * Wraps error text for the MCP client, replacing control bytes with spaces.\n *\n * Every error branch goes through here because parts of these messages echo\n * client-controlled values (a tool name, an argument) or downstream error\n * messages: one raw newline or escape byte would forge extra lines that read\n * as the server's own answer.\n *\n * @param text - Untrusted error text.\n * @returns {CallToolResult} A sanitized MCP error result.\n */\nfunction errorResult(text: string): CallToolResult {\n  return {\n    content: [{ type: \"text\", text: text.replaceAll(/\\p{Cc}/gu, \" \") }],\n    isError: true,\n  };\n}\n\n/**\n * Converts a shared tool result to the MCP text-result contract.\n *\n * `details` is dropped and `structuredContent` is never set: clients that see\n * structured output prefer it over `content` and would hide the readable answer.\n *\n * @param result - Shared tool result to adapt.\n * @returns {CallToolResult} The MCP text-result envelope.\n */\nfunction toCallToolResult(result: ToolResult<unknown>): CallToolResult {\n  return {\n    content: result.content,\n    ...(result.isError === undefined ? {} : { isError: result.isError }),\n  };\n}\n\n/**\n * Creates an unconnected MCP server exposing the harness registry tools.\n *\n * Built on the low-level `Server` even though the SDK marks it `@deprecated`,\n * because `McpServer.registerTool` accepts Standard Schema (Zod) only. TypeBox 1.x\n * does not implement Standard Schema, and this package's tool schemas are TypeBox,\n * shared with the Pi and OMP extensions. The high-level API would force a second\n * definition of every parameter.\n *\n * @returns {Server} An unconnected MCP server.\n */\nexport function createMcpServer(): Server {\n  const toolsByName = new Map(tools.map((tool) => [tool.name, tool]));\n  const server = new Server({ name: \"harnesses\", version }, { capabilities: { tools: {} } });\n\n  server.setRequestHandler(ListToolsRequestSchema, () => ({\n    tools: tools.map((tool): Tool => ({\n      name: tool.name,\n      title: tool.title,\n      description: tool.description,\n      inputSchema: tool.inputSchema as Tool[\"inputSchema\"],\n      annotations: tool.annotations,\n    })),\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {\n    const tool = toolsByName.get(request.params.name);\n    if (!tool) {\n      return errorResult(`Unknown harnesses tool: ${JSON.stringify(request.params.name)}`);\n    }\n\n    const args = request.params.arguments ?? {};\n    if (!Value.Check(tool.inputSchema, args)) {\n      return errorResult(validationError(tool.inputSchema, args));\n    }\n\n    try {\n      return toCallToolResult(await tool.execute(args, extra.signal));\n    } catch (error) {\n      return errorResult(\n        `${tool.name} failed: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  });\n\n  return server;\n}\n"],"mappings":"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"}
+{"version":3,"file":"mcp.mjs","names":[],"sources":["../../src/commands/mcp.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { consola, LogLevels } from \"consola\";\n\nexport default defineCommand({\n  meta: {\n    name: \"mcp\",\n    description: \"Run the harnesses MCP server over stdio\",\n  },\n  /**\n   * The server and the SDK load here, because citty resolves every subcommand\n   * to print `harnesses --help` and to look for an alias of an unknown command.\n   *\n   * stdout carries the JSON-RPC frames. consola's default reporter sends\n   * anything at log level or below to that same descriptor, and `DEBUG` in the\n   * environment raises the level on import, so one stray line would corrupt\n   * the stream. Warnings and errors still reach stderr.\n   */\n  async run() {\n    consola.level = LogLevels.warn;\n\n    const [{ createMcpServer }, { StdioServerTransport }] = await Promise.all([\n      import(\"../mcp.ts\"),\n      import(\"@modelcontextprotocol/sdk/server/stdio.js\"),\n    ]);\n    await createMcpServer().connect(new StdioServerTransport());\n  },\n});\n"],"mappings":";;AAGA,IAAA,cAAe,cAAc;CAC3B,MAAM;EACJ,MAAM;EACN,aAAa;CACf"}

package/dist/_chunks/output.mjs

@@ -0,0 +1,28 @@
+import { stripVTControlCharacters } from "node:util";
+import { consola } from "consola";
+import { encode } from "@toon-format/toon";
+const formatArgs = {
+	json: {
+		type: "boolean",
+		description: "Output as JSON"
+	},
+	toon: {
+		type: "boolean",
+		description: "Output as TOON"
+	}
+};
+const UNSAFE_TERMINAL_CONTROLS = /[\u0000-\u0008\u000B-\u001F\u007F-\u009F]/g;
+const UNSAFE_UNICODE_FORMATTING = /[\p{Cf}\p{Zl}\p{Zp}]/gu;
+function sanitize(text) {
+	return stripVTControlCharacters(text ?? "").replace(UNSAFE_TERMINAL_CONTROLS, " ").replace(UNSAFE_UNICODE_FORMATTING, " ");
+}
+function report(result, args) {
+	if (args.json) console.log(JSON.stringify(result.details, null, 2));
+	else if (args.toon) console.log(encode(result.details));
+	else if (result.isError) consola.error(sanitize(result.content[0]?.text));
+	else console.log(sanitize(result.content[0]?.text));
+	if (result.isError) process.exitCode = 1;
+}
+export { formatArgs, report };
+
+//# sourceMappingURL=output.mjs.map

package/dist/_chunks/output.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.mjs","names":["toToon"],"sources":["../../src/commands/output.ts"],"sourcesContent":["import { stripVTControlCharacters } from \"node:util\";\nimport { encode as toToon } from \"@toon-format/toon\";\nimport { consola } from \"consola\";\nimport type { ToolResult } from \"../tool-operations.ts\";\n\nexport const formatArgs = {\n  json: { type: \"boolean\" as const, description: \"Output as JSON\" },\n  toon: { type: \"boolean\" as const, description: \"Output as TOON\" },\n};\n\ntype OutputFormat = Readonly<{ json?: boolean; toon?: boolean }>;\n\n/** Control bytes removed from reports because they can echo untrusted configuration values. */\n/* oxlint-disable-next-line no-control-regex */\nconst UNSAFE_TERMINAL_CONTROLS = /[\\u0000-\\u0008\\u000B-\\u001F\\u007F-\\u009F]/g;\nconst UNSAFE_UNICODE_FORMATTING = /[\\p{Cf}\\p{Zl}\\p{Zp}]/gu;\n\nfunction sanitize(text: string | undefined): string {\n  return stripVTControlCharacters(text ?? \"\")\n    .replace(UNSAFE_TERMINAL_CONTROLS, \" \")\n    .replace(UNSAFE_UNICODE_FORMATTING, \" \");\n}\n\n/**\n * Emits one tool result in the selected machine or human format.\n *\n * @param result - Shared executor result to emit.\n * @param args - Selected output format.\n */\nexport function report(result: ToolResult<unknown>, args: OutputFormat): void {\n  if (args.json) console.log(JSON.stringify(result.details, null, 2));\n  else if (args.toon) console.log(toToon(result.details));\n  else if (result.isError) consola.error(sanitize(result.content[0]?.text));\n  else console.log(sanitize(result.content[0]?.text));\n\n  if (result.isError) process.exitCode = 1;\n}\n"],"mappings":";;;AAKA,MAAa,aAAa;CACxB,MAAM;EAAE,MAAM;EAAoB,aAAa;CAAiB;CAChE,MAAM;EAAE,MAAM;EAAoB,aAAa;CAAiB;AAClE;AAMA,MAAM,2BAA2B;AACjC,MAAM,4BAA4B;AAElC,SAAS,SAAS,MAAkC;CAClD,OAAO,yBAAyB,QAAQ,EAAE,CAAC,CACxC,QAAQ,0BAA0B,GAAG,CAAC,CACtC,QAAQ,2BAA2B,GAAG;AAC3C;;;;;;CAQA,IAAA,OAAgB,SAAO,QAA6B,WAA0B;AAC5E;AAEK,SAAA,YAAW"}

package/dist/_chunks/{agents-sync.d.mts → prompt-sync.d.mts}

@@ -9,6 +9,11 @@ export interface PathCandidate {
   platforms?: Platform[];
   note?: string;
 }
+/** One stable user-scope destination used by prompt template synchronization. */
+export interface PromptTemplateSyncTarget extends PathCandidate {
+  scope: "user";
+  format: "markdown" | "gemini-toml";
+}
 export interface StorageDescriptor {
   format: string;
   level: EvidenceLevel;
@@ -140,9 +145,10 @@ export interface McpConfigFile extends PathCandidate {
   key: string[];
   /**
    * Shape of individual entries; "standard" is the {command, args, env, url}
-   * family and "prime" is that family with env values as {"env": "NAME"} references.
+   * family, "prime" is that family with env values as {"env": "NAME"} references
+   * and "mastracode" is that family read by its keys alone, type ignored.
    */
-  dialect: "standard" | "antigravity" | "opencode" | "prime" | "vscode";
+  dialect: "standard" | "antigravity" | "mastracode" | "opencode" | "prime" | "vscode";
 }
 export interface HarnessDetection {
   /** Environment variables that indicate running inside this agent. */
@@ -161,6 +167,8 @@ export interface ResolvedPaths {
   instructions: PathCandidate[];
   skills: PathCandidate[];
   commands: PathCandidate[];
+  promptTemplates: PathCandidate[];
+  promptTemplateSyncTarget: PromptTemplateSyncTarget | null;
   hooks: PathCandidate[];
 }
 type InvocationOptions = Readonly<{
@@ -179,6 +187,10 @@ export declare abstract class Harness {
   abstract readonly instructions: PathCandidate[];
   abstract readonly skills: PathCandidate[];
   abstract readonly commands: PathCandidate[];
+  /** Reusable prompt files; empty when no CLI template location is verified. */
+  readonly promptTemplates: PathCandidate[];
+  /** Stable user-scope destination used by prompt template synchronization. */
+  readonly promptTemplateSyncTarget: PromptTemplateSyncTarget | null;
   abstract readonly hooks: PathCandidate[];
   abstract readonly capabilities: HarnessCapabilities;
   abstract readonly detection: HarnessDetection;
@@ -444,4 +456,40 @@ export declare function readAgentsConfig(options?: ResolveOptions): AgentsConfig
  * @returns {AgentsSyncReport} Per-harness synchronization outcomes.
  */
 export declare function syncAgentsFiles(harnesses: readonly Harness[], check?: boolean, options?: ResolveOptions): AgentsSyncReport;
-//# sourceMappingURL=agents-sync.d.mts.map
+export type PromptSyncAction = "linked" | "generated" | "relinked" | "replaced" | "adopted" | "removed" | "unchanged" | "skipped";
+/** One prompt template's outcome at a harness destination. */
+export interface PromptTemplateTargetResult {
+  readonly name: string;
+  readonly source?: string;
+  readonly path: string;
+  readonly action: PromptSyncAction;
+  /** Backup path, skip reason, or a check-mode note. */
+  readonly detail?: string;
+}
+/** One harness's outcome of a prompt template sync run. */
+export interface PromptSyncTargetResult {
+  readonly id: string;
+  readonly path?: string;
+  readonly format?: PromptTemplateSyncTarget["format"];
+  readonly detail?: string;
+  readonly templates: readonly PromptTemplateTargetResult[];
+}
+/** Outcome of one prompt template sync run. */
+export interface PromptSyncReport {
+  readonly source: string;
+  readonly check: boolean;
+  readonly templates: readonly string[];
+  readonly targets: readonly PromptSyncTargetResult[];
+}
+/**
+ * Synchronizes canonical Markdown prompt templates into each harness's stable
+ * user-scope destination. Markdown harnesses receive symlinks; Gemini receives
+ * generated TOML commands. In check mode nothing is written.
+ *
+ * @param harnesses - Harnesses to inspect or update.
+ * @param check - Report intended changes without writing them.
+ * @param options - Path-resolution overrides.
+ * @returns {PromptSyncReport} Per-harness synchronization outcomes.
+ */
+export declare function syncPromptTemplates(harnesses: readonly Harness[], check?: boolean, options?: ResolveOptions): PromptSyncReport;
+//# sourceMappingURL=prompt-sync.d.mts.map

package/dist/_chunks/prompt-sync.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-sync.d.mts","names":[],"sources":["../../src/types.ts","../../src/harness.ts","../../src/mcp-servers.ts","../../src/agents-sync.ts","../../src/prompt-sync.ts"],"mappings":"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"}