@agntn/harnesses 0.0.1

package/dist/_chunks/mcp-servers.mjs

@@ -0,0 +1,149 @@
+import { isHarnessId, listHarnesses } from "./agents-sync.mjs";
+import { mcpAdd, mcpList, mcpRemove, mcpSync } from "./tool-operations.mjs";
+import { stripVTControlCharacters } from "node:util";
+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(", ")}`);
+		process.exit(1);
+	}
+	return id;
+}
+var mcp_servers_default = defineCommand({
+	meta: { description: "Manage MCP servers across harness configs" },
+	subCommands: {
+		list: defineCommand({
+			meta: { description: "List configured MCP servers, normalized" },
+			args: {
+				id: {
+					type: "positional",
+					description: "Harness id",
+					required: false
+				},
+				...formatArgs
+			},
+			run({ args }) {
+				const id = args.id === void 0 ? void 0 : requireHarnessId(args.id);
+				report(mcpList(id), args);
+			}
+		}),
+		add: defineCommand({
+			meta: { description: "Add or replace one MCP server in a harness config" },
+			args: {
+				id: {
+					type: "positional",
+					description: "Harness id",
+					required: true
+				},
+				name: {
+					type: "positional",
+					description: "Server name",
+					required: true
+				},
+				command: {
+					type: "string",
+					description: "Binary for a stdio server"
+				},
+				args: {
+					type: "string",
+					description: "Space-separated arguments for a stdio server"
+				},
+				env: {
+					type: "string",
+					description: "Comma-separated K=V environment variables"
+				},
+				url: {
+					type: "string",
+					description: "URL for an http/sse server"
+				},
+				scope: {
+					type: "string",
+					description: "user (default) or project"
+				},
+				...formatArgs
+			},
+			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), {
+					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);
+			}
+		}),
+		sync: defineCommand({
+			meta: { description: "Reset harness configs to the master list from ~/.config/agntn/mcp.jsonc" },
+			args: {
+				id: {
+					type: "positional",
+					description: "Harness id",
+					required: false
+				},
+				...formatArgs
+			},
+			run({ args }) {
+				const id = args.id === void 0 ? void 0 : requireHarnessId(args.id);
+				report(mcpSync(id), args);
+			}
+		}),
+		remove: defineCommand({
+			meta: { description: "Remove one MCP server from a harness config" },
+			args: {
+				id: {
+					type: "positional",
+					description: "Harness id",
+					required: true
+				},
+				name: {
+					type: "positional",
+					description: "Server name",
+					required: true
+				},
+				scope: {
+					type: "string",
+					description: "user (default) or project"
+				},
+				...formatArgs
+			},
+			run({ args }) {
+				report(mcpRemove(requireHarnessId(args.id), args.name, args.scope === "project" ? "project" : "user"), args);
+			}
+		})
+	}
+});
+export { mcp_servers_default as default };
+
+//# sourceMappingURL=mcp-servers.mjs.map

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

@@ -0,0 +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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"}

package/dist/_chunks/mcp.mjs

@@ -0,0 +1,164 @@
+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, scanned from the binaries on PATH.",
+		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) => listHarnessModels(args.id, {
+			search: args.search,
+			cwd: args.cwd,
+			timeoutSeconds: args.timeoutSeconds
+		})
+	},
+	{
+		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) => runHarness(args.id, args.prompt, {
+			cwd: args.cwd,
+			model: args.model,
+			timeoutSeconds: args.timeoutSeconds,
+			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")
+	}
+];
+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) => {
+		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));
+		} catch (error) {
+			return errorResult(`${tool.name} failed: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	});
+	return server;
+}
+export { createMcpServer };
+
+//# sourceMappingURL=mcp.mjs.map

package/dist/_chunks/mcp.mjs.map

@@ -0,0 +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  ): 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:\n      \"List every known AI coding harness with its install state and version, scanned from the binaries on PATH.\",\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) =>\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      }),\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) =>\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        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) => {\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));\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":";;;;;;AAoCA,MAAM,YAAiC;CACrC,cAAc;CACd,iBAAiB;CACjB,gBAAgB;CAChB,eAAe;AACjB;AAEA,MAAM,YAAiC;CACrC,cAAc;CACd,iBAAiB;CACjB,gBAAgB;CAChB,eAAe;AACjB;AAEA,MAAM,eAAoC;CACxC,cAAc;CACd,iBAAiB;CACjB,gBAAgB;CAChB,eAAe;AACjB;AAEA,MAAM,UAAU,mBAAqCA,eAAI;AAEzD,MAAM,QAA0B;CAC9B;EACE,MAAM;EACN,OAAO;EACP,aACE;EACF,aAAa,QAAQ;EACrB,aAAa;EACb,eAAe,gBAAgB;CACjC;CACA;EACE,MAAM;EACN,OAAO;EACP,aACE;EACF,aAAa,QAAQ;EACrB,aAAa;EACb,UAAU,SAAS,YAAY,KAAK,EAAuB;CAC7D;CACA;EACE,MAAM;EACN,OAAO;EACP,aACE;EACF,aAAa,QAAQ;EACrB,aAAa;EACb,UAAU,SACR,kBAAkB,KAAK,IAAc;GACnC,QAAQ,KAAK;GACb,KAAK,KAAK;GACV,gBAAgB,KAAK;EACvB,CAAC;CACL;CACA;EACE,MAAM;EACN,OAAO;EACP,aACE;EACF,aAAa,QAAQ;EACrB,aAAa;GACX,cAAc;GACd,iBAAiB;GACjB,gBAAgB;GAChB,eAAe;EACjB;EACA,UAAU,SACR,WAAW,KAAK,IAAc,KAAK,QAAkB;GACnD,KAAK,KAAK;GACV,OAAO,KAAK;GACZ,gBAAgB,KAAK;GACrB,YAAY,KAAK;GACjB,OAAO,KAAK;GACZ,UAAU,KAAK;EACjB,CAAC;CACL;CACA;EACE,MAAM;EACN,OAAO;EACP,aACE;EACF,aAAa,QAAQ;EACrB,aAAa;EACb,UAAU,SAAS,QAAQ,KAAK,EAAwB;CAC1D;CACA;EACE,MAAM;EACN,OAAO;EACP,aACE;EACF,aAAa,QAAQ;EACrB,aAAa;EACb,UAAU,SACR,OACE,KAAK,IACL,MACC,KAAK,SAAgC,MACxC;CACJ;CACA;EACE,MAAM;EACN,OAAO;EACP,aACE;EACF,aAAa,QAAQ;EACrB,aAAa;EACb,UAAU,SAAS,QAAQ,KAAK,EAAwB;CAC1D;CACA;EACE,MAAM;EACN,OAAO;EACP,aACE;EACF,aAAa,QAAQ;EACrB,aAAa;EACb,UAAU,SAAS,WAAW,KAAK,IAA0B,KAAK,UAAU,IAAI;CAClF;CACA;EACE,MAAM;EACN,OAAO;EACP,aACE;EACF,aAAa,QAAQ;EACrB,aAAa;EACb,UAAU,SACR,UACE,KAAK,IACL,KAAK,MACJ,KAAK,SAAgC,MACxC;CACJ;AACF;;;;;;AASA,SAAS,YAAA,MAAgB;CACvB,OAAM;EACN,SAAK,CAAA;GACL,MAAO;GACT,MAAA,KAAA,WAAA,YAAA,GAAA;;;;;;;;;;;AAcE,SAAO,kBAAA;CACL,MAAA,cAAU,IAAA,IAAA,MAAA,KAAA,SAAA,CAAA,KAAA,MAAA,IAAA,CAAA,CAAA;CAAE,MAAA,SAAM,IAAA,OAAA;EAAQ,MAAA;EAAuC;CACjE,GAAA,EAAA,cAAS,EAAA,OAAA,CAAA,EAAA,EAAA,CAAA;CACX,OAAA,kBAAA,+BAAA,EAAA,OAAA,MAAA,KAAA,UAAA;EACF,MAAA,KAAA;;;;;;;;;;EAWA,IAAA,CAAA,MAAS,KAAA,aAAiB,IAA6C,GAAA,OAAA,YAAA,gBAAA,KAAA,aAAA,IAAA,CAAA;EACrE,IAAA;GACE,OAAA,iBAAgB,MAAA,KAAA,QAAA,IAAA,CAAA;EAChB,SAAI,OAAO;GACb,OAAA,YAAA,GAAA,KAAA,KAAA,WAAA,iBAAA,QAAA,MAAA,UAAA,OAAA,KAAA,GAAA;EACF"}

package/dist/_chunks/mcp2.mjs

@@ -0,0 +1,17 @@
+import { createMcpServer } from "./mcp.mjs";
+import { defineCommand } from "citty";
+import { LogLevels, consola } from "consola";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+var mcp_default = defineCommand({
+	meta: {
+		name: "mcp",
+		description: "Run the harnesses MCP server over stdio"
+	},
+	async run() {
+		consola.level = LogLevels.warn;
+		await createMcpServer().connect(new StdioServerTransport());
+	}
+});
+export { mcp_default as default };
+
+//# sourceMappingURL=mcp2.mjs.map

package/dist/_chunks/mcp2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp2.mjs","names":[],"sources":["../../src/commands/mcp.ts"],"sourcesContent":["import { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { defineCommand } from \"citty\";\nimport { consola, LogLevels } from \"consola\";\nimport { createMcpServer } from \"../mcp.ts\";\n\nexport default defineCommand({\n  meta: {\n    name: \"mcp\",\n    description: \"Run the harnesses MCP server over stdio\",\n  },\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    await createMcpServer().connect(new StdioServerTransport());\n  },\n});\n"],"mappings":";;;;AAKA,IAAA,cAAe,cAAc;CAC3B,MAAM;EACJ,MAAM;EACN,aAAa;CACf;;;;;;AAQE,SAAA,eAAgB"}