@agntn/harnesses 0.2.0 → 0.3.0

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,22 @@ export interface PathCandidate {
   platforms?: Platform[];
   note?: string;
 }
+/** The path lists of a harness descriptor, as named in {@link ResolvedPaths}. */
+export type PathCategory = "config" | "sessions" | "instructions" | "skills" | "commands" | "promptTemplates" | "hooks" | "temp";
+/**
+ * An environment variable the harness reads to move one of its roots. `path`
+ * is the default root, used while the variable is unset or empty.
+ */
+export interface EnvOverride extends PathCandidate {
+  variable: string;
+  /** Categories with entries under this root, which move with it. */
+  relocates: PathCategory[];
+}
+/** 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;
@@ -44,6 +60,12 @@ export interface HarnessInvocation {
   readOnlyMinVersion?: string;
   /** Arguments appended when a model is selected; every "{model}" is replaced. */
   modelArgs?: string[];
+  /**
+   * Arguments appended to a plain text run so a CLI that holds its answer until
+   * the end reports it as events instead; `invoke` folds them back into that text,
+   * so a stopped run keeps what the model had already written.
+   */
+  streamArgs?: string[];
   level: EvidenceLevel;
   note?: string;
 }
@@ -60,7 +82,10 @@ export interface HarnessInvocationModes {
 export interface HarnessModelListing {
   /** Arguments used when no search filter is supplied. */
   args: string[];
-  /** Optional argument template for a search filter; every "{search}" is replaced. */
+  /**
+   * Optional argument template for a native search filter; every "{search}" is replaced.
+   * Without it, a search runs `args` and keeps the ids containing the filter, ignoring case.
+   */
   searchArgs?: string[];
   level: EvidenceLevel;
   note?: string;
@@ -69,10 +94,13 @@ export interface HarnessModelListing {
 export interface AvailableModel {
   provider: string;
   id: string;
-  contextWindow: number;
-  maxOutputTokens: number;
-  thinking: boolean;
-  images: boolean;
+  /** Absent when the native listing prints only ids, like Grok's. */
+  contextWindow?: number;
+  maxOutputTokens?: number;
+  thinking?: boolean;
+  images?: boolean;
+  /** Set on the model the harness picks when no model is given, when the listing marks one. */
+  default?: boolean;
 }
 /** Options for querying the models available to one harness. */
 export interface ListModelsOptions {
@@ -91,7 +119,7 @@ export interface InvokeOptions {
   model?: string;
   /** Enable the spawned harness's tools; defaults to advisor without tools mode. */
   tools?: boolean;
-  /** Require native enforcement of read-only tool access. Implies `tools: true`. */
+  /** Require native enforcement of read-only tool access. Implies `tools: true` when `tools` is omitted; `tools: false` rejects the run. */
   readOnly?: boolean;
   /** Milliseconds before cleanup starts. Unset or 0 disables the deadline. */
   timeoutMs?: number;
@@ -110,6 +138,8 @@ export interface InvokeResult {
   timedOut: boolean;
   /** True when caller cancellation wins over the deadline or completion. */
   aborted: boolean;
+  /** Milliseconds without output on either stream before a deadline or cancellation stopped the process. */
+  idleMs?: number;
 }
 /** Result of one native model-listing command. */
 export interface ListModelsResult extends InvokeResult {
@@ -140,9 +170,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. */
@@ -154,6 +185,8 @@ export interface ResolveOptions {
   homeDir?: string;
   projectRoot?: string;
   platform?: Platform;
+  /** Replaces `os.tmpdir()` as the value of `${TMPDIR}`. */
+  tempDir?: string;
 }
 export interface ResolvedPaths {
   config: PathCandidate[];
@@ -161,7 +194,11 @@ export interface ResolvedPaths {
   instructions: PathCandidate[];
   skills: PathCandidate[];
   commands: PathCandidate[];
+  promptTemplates: PathCandidate[];
+  promptTemplateSyncTarget: PromptTemplateSyncTarget | null;
   hooks: PathCandidate[];
+  /** Temp roots, moved by a set `temp` override from {@link EnvOverride}. */
+  temp: PathCandidate[];
 }
 type InvocationOptions = Readonly<{
   model?: string;
@@ -179,7 +216,15 @@ 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[];
+  /** Where the harness keeps its temp files; empty when not verified. */
+  readonly temp: PathCandidate[];
+  /** Environment variables that move a root of this harness; empty when none is verified. */
+  readonly envOverrides: EnvOverride[];
   abstract readonly capabilities: HarnessCapabilities;
   abstract readonly detection: HarnessDetection;
   /** Non-interactive invocation recipe; null when the harness has no headless mode. */
@@ -234,6 +279,15 @@ export declare abstract class Harness {
    * @returns {Promise<InvokeResult>} The completed process result.
    */
   invoke(prompt: string, options?: InvokeOptions): Promise<InvokeResult>;
+  /**
+   * Turns the events a `streamArgs` run printed back into the text the plain
+   * run would have printed.
+   *
+   * @param _stdout - Event output as captured, possibly cut short.
+   * @param _complete - False when a deadline or cancellation stopped the run.
+   * @returns {string} The answer text, or what the model had written so far.
+   */
+  protected foldStreamOutput(_stdout: string, _complete: boolean): string;
   /**
    * Explains why the installed CLI cannot run a read-only recipe that carries a
    * version floor, or returns null when no floor applies or the installed
@@ -246,7 +300,8 @@ export declare abstract class Harness {
   /**
    * Expands the native model-listing recipe without spawning anything.
    *
-   * @param search - Optional native model search filter.
+   * @param search - Optional model search filter; without native `searchArgs` it is applied
+   *   to the parsed output instead, so the command is the unfiltered one.
    * @returns {{ command: string, args: string[] } | null} The command, or null when unsupported.
    */
   buildModelListInvocation(search?: string): {
@@ -261,6 +316,14 @@ export declare abstract class Harness {
    * @returns {Promise<ListModelsResult>} The normalized command and model result.
    */
   listModels(options?: ListModelsOptions): Promise<ListModelsResult>;
+  /**
+   * The value `model` takes for one listed model: `provider/id` unless the
+   * harness overrides it.
+   *
+   * @param model - A model returned by {@link listModels}.
+   * @returns {string} The selector this harness's `modelArgs` accept.
+   */
+  modelSelector(model: Readonly<AvailableModel>): string;
   /**
    * Converts a successful native model-listing response to the shared shape.
    *
@@ -278,6 +341,14 @@ export declare abstract class Harness {
    */
   resolveCandidates<T extends PathCandidate>(entries: readonly T[], options?: ResolveOptions): T[];
   resolve(options?: ResolveOptions): ResolvedPaths;
+  /**
+   * Temp roots for the platform. A `temp` override set in the environment
+   * replaces its default root, the same move the harness makes itself.
+   *
+   * @param options - Platform and path-resolution overrides.
+   * @returns {PathCandidate[]} Resolved temp roots.
+   */
+  private resolveTemp;
 }
 export type HarnessConstructor = new () => Harness;
 /** One resolved config file together with the servers it declares. */
@@ -444,4 +515,45 @@ 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"];
+  /** Outcome for a Markdown destination, which is one link to the whole source directory. */
+  readonly action?: PromptSyncAction;
+  /** Backup path, skip reason, or a check-mode note. */
+  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. A Markdown harness's destination becomes one symlink
+ * to the source directory; Gemini's directory holds only TOML commands
+ * generated from it. Anything else found there is backed up first. 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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"}