@agntn/harnesses 0.2.0 → 0.2.1

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { version } from "./_chunks/types.mjs";
-import { Harness, McpEnvError, addMcpServer, detectHarness, detectHarnessFromEnv, detectProjectHarnesses, getAllHarnesses, getHarness, isHarnessId, listHarnesses, listMcpServers, masterMcpPath, parseJsonc, readAgentsConfig, readMasterMcpServers, registerHarness, removeMcpServer, resolvePathTemplate, syncAgentsFiles, syncMcpServers } from "./_chunks/agents-sync.mjs";
+import { Harness, McpEnvError, addMcpServer, agntnConfigDir, agntnDataDir, detectHarness, detectHarnessFromEnv, detectProjectHarnesses, getAllHarnesses, getHarness, isHarnessId, listHarnesses, listMcpServers, masterMcpPath, parseJsonc, readAgentsConfig, readMasterMcpServers, registerHarness, removeMcpServer, resolvePathTemplate, syncAgentsFiles, syncMcpServers, syncPromptTemplates } from "./_chunks/prompt-sync.mjs";
 const harnessIds = Object.freeze(listHarnesses());
-export { Harness, McpEnvError, addMcpServer, detectHarness, detectHarnessFromEnv, detectProjectHarnesses, getAllHarnesses, getHarness, harnessIds, isHarnessId, listHarnesses, listMcpServers, masterMcpPath, parseJsonc, readAgentsConfig, readMasterMcpServers, registerHarness, removeMcpServer, resolvePathTemplate, syncAgentsFiles, syncMcpServers, version };
+export { Harness, McpEnvError, addMcpServer, agntnConfigDir, agntnDataDir, detectHarness, detectHarnessFromEnv, detectProjectHarnesses, getAllHarnesses, getHarness, harnessIds, isHarnessId, listHarnesses, listMcpServers, masterMcpPath, parseJsonc, readAgentsConfig, readMasterMcpServers, registerHarness, removeMcpServer, resolvePathTemplate, syncAgentsFiles, syncMcpServers, syncPromptTemplates, version };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["export { version } from \"./types.ts\";\nexport type {\n  HarnessId,\n  EvidenceLevel,\n  Platform,\n  PathCandidate,\n  StorageDescriptor,\n  HarnessCapabilities,\n  HarnessDetection,\n  HarnessInvocation,\n  HarnessInvocationModes,\n  HarnessModelListing,\n  AvailableModel,\n  ListModelsOptions,\n  ListModelsResult,\n  InvokeOptions,\n  InvokeResult,\n  McpServerConfig,\n  McpConfigFile,\n  ResolveOptions,\n  ResolvedPaths,\n} from \"./types.ts\";\n\nexport { Harness } from \"./harness.ts\";\nexport type { HarnessConstructor } from \"./harness.ts\";\nexport {\n  registerHarness,\n  getHarness,\n  isHarnessId,\n  listHarnesses,\n  getAllHarnesses,\n  detectHarness,\n  detectHarnessFromEnv,\n  detectProjectHarnesses,\n} from \"./registry.ts\";\nexport { resolvePathTemplate } from \"./resolve.ts\";\nexport {\n  listMcpServers,\n  addMcpServer,\n  removeMcpServer,\n  syncMcpServers,\n  readMasterMcpServers,\n  masterMcpPath,\n  parseJsonc,\n  McpEnvError,\n} from \"./mcp-servers.ts\";\nexport type { McpConfigListing, SyncReport, SyncTargetResult } from \"./mcp-servers.ts\";\nexport { syncAgentsFiles, readAgentsConfig } from \"./agents-sync.ts\";\nexport type {\n  AgentsConfig,\n  AgentsSyncAction,\n  AgentsCompanionTargetResult,\n  AgentsSyncReport,\n  AgentsTargetResult,\n} from \"./agents-sync.ts\";\n\nexport type {\n  ClaudeContentBlock,\n  ClaudeTextBlock,\n  ClaudeThinkingBlock,\n  ClaudeToolUseBlock,\n  ClaudeToolResultBlock,\n  ClaudeUsage,\n  ClaudeBaseEntry,\n  ClaudeUserEntry,\n  ClaudeAssistantEntry,\n  ClaudeSummaryEntry,\n  ClaudeSessionEntry,\n  ClaudeHistoryEntry,\n  GeminiTokensSummary,\n  GeminiToolCallRecord,\n  GeminiThought,\n  GeminiMessageRecord,\n  GeminiConversationRecord,\n  CodexHistoryEntry,\n  CodexThread,\n  CodexLogEntry,\n  OpenCodeSession,\n  OpenCodeMessage,\n  OpenCodeTextPart,\n  OpenCodeReasoningPart,\n  OpenCodeToolPart,\n  OpenCodeFilePart,\n  OpenCodeSubtaskPart,\n  OpenCodeStepStartPart,\n  OpenCodeStepFinishPart,\n  OpenCodeSnapshotPart,\n  OpenCodePatchPart,\n  OpenCodeAgentPart,\n  OpenCodeRetryPart,\n  OpenCodeCompactionPart,\n  OpenCodePart,\n  OpenCodeTodo,\n  OpenCodeProject,\n} from \"./schemas/index.ts\";\n\nimport type { HarnessId } from \"./types.ts\";\nimport { listHarnesses } from \"./registry.ts\";\n\nexport const harnessIds: readonly HarnessId[] = Object.freeze(listHarnesses());\n"],"mappings":";;AAmGA,MAAa,aAAmC,OAAO,OAAO,cAAc,CAAC"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["export { version } from \"./types.ts\";\nexport type {\n  HarnessId,\n  EvidenceLevel,\n  Platform,\n  PathCandidate,\n  PromptTemplateSyncTarget,\n  StorageDescriptor,\n  HarnessCapabilities,\n  HarnessDetection,\n  HarnessInvocation,\n  HarnessInvocationModes,\n  HarnessModelListing,\n  AvailableModel,\n  ListModelsOptions,\n  ListModelsResult,\n  InvokeOptions,\n  InvokeResult,\n  McpServerConfig,\n  McpConfigFile,\n  ResolveOptions,\n  ResolvedPaths,\n} from \"./types.ts\";\n\nexport { Harness } from \"./harness.ts\";\nexport type { HarnessConstructor } from \"./harness.ts\";\nexport {\n  registerHarness,\n  getHarness,\n  isHarnessId,\n  listHarnesses,\n  getAllHarnesses,\n  detectHarness,\n  detectHarnessFromEnv,\n  detectProjectHarnesses,\n} from \"./registry.ts\";\nexport { agntnDataDir, agntnConfigDir, resolvePathTemplate } from \"./resolve.ts\";\nexport {\n  listMcpServers,\n  addMcpServer,\n  removeMcpServer,\n  syncMcpServers,\n  readMasterMcpServers,\n  masterMcpPath,\n  parseJsonc,\n  McpEnvError,\n} from \"./mcp-servers.ts\";\nexport type { McpConfigListing, SyncReport, SyncTargetResult } from \"./mcp-servers.ts\";\nexport { syncAgentsFiles, readAgentsConfig } from \"./agents-sync.ts\";\nexport type {\n  AgentsConfig,\n  AgentsSyncAction,\n  AgentsCompanionTargetResult,\n  AgentsSyncReport,\n  AgentsTargetResult,\n} from \"./agents-sync.ts\";\nexport { syncPromptTemplates } from \"./prompt-sync.ts\";\nexport type {\n  PromptSyncAction,\n  PromptSyncReport,\n  PromptSyncTargetResult,\n  PromptTemplateTargetResult,\n} from \"./prompt-sync.ts\";\n\nexport type {\n  ClaudeContentBlock,\n  ClaudeTextBlock,\n  ClaudeThinkingBlock,\n  ClaudeToolUseBlock,\n  ClaudeToolResultBlock,\n  ClaudeUsage,\n  ClaudeBaseEntry,\n  ClaudeUserEntry,\n  ClaudeAssistantEntry,\n  ClaudeSummaryEntry,\n  ClaudeSessionEntry,\n  ClaudeHistoryEntry,\n  GeminiTokensSummary,\n  GeminiToolCallRecord,\n  GeminiThought,\n  GeminiMessageRecord,\n  GeminiConversationRecord,\n  CodexHistoryEntry,\n  CodexThread,\n  CodexLogEntry,\n  OpenCodeSession,\n  OpenCodeMessage,\n  OpenCodeTextPart,\n  OpenCodeReasoningPart,\n  OpenCodeToolPart,\n  OpenCodeFilePart,\n  OpenCodeSubtaskPart,\n  OpenCodeStepStartPart,\n  OpenCodeStepFinishPart,\n  OpenCodeSnapshotPart,\n  OpenCodePatchPart,\n  OpenCodeAgentPart,\n  OpenCodeRetryPart,\n  OpenCodeCompactionPart,\n  OpenCodePart,\n  OpenCodeTodo,\n  OpenCodeProject,\n} from \"./schemas/index.ts\";\n\nimport type { HarnessId } from \"./types.ts\";\nimport { listHarnesses } from \"./registry.ts\";\n\nexport const harnessIds: readonly HarnessId[] = Object.freeze(listHarnesses());\n"],"mappings":";;AA2GA,MAAa,aAAmC,OAAO,OAAO,cAAc,CAAC"}

package/dist/mcp.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.mts","names":[],"sources":["../src/mcp.ts"],"mappings":";;;;;;;;;;;;wBAuOgB,mBAAmB"}
+{"version":3,"file":"mcp.d.mts","names":[],"sources":["../src/mcp.ts"],"mappings":";;;;;;;;;;;;wBAwOgB,mBAAmB"}

package/dist/mcp.mjs

@@ -1,2 +1,177 @@
-import { createMcpServer } from "./_chunks/mcp.mjs";
+import { Check, Errors, typebox_exports } from "./_chunks/libs/typebox.mjs";
+import { version } from "./_chunks/types.mjs";
+import { harnessToolSchemas } from "./_chunks/tool-schemas.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);
+let operationsPromise;
+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 }) => 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, prompt templates, hooks, and resolved paths.",
+		inputSchema: schemas.info,
+		annotations: READ_ONLY,
+		execute: ({ harnessInfo }, 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: ({ listHarnessModels }, 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: ({ runHarness }, 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: ({ mcpList }, 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: ({ mcpAdd }, 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: ({ mcpSync }, 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: ({ agentsSync }, args) => agentsSync(args.id, args.check === true)
+	},
+	{
+		name: "harnesses_prompts_sync",
+		title: "Harnesses Prompts Sync",
+		description: "Sync canonical Markdown prompt templates from the agntn XDG data directory into every supported harness. Markdown targets use links; Gemini receives generated TOML. Diverged files are backed up. Pass check to only report.",
+		inputSchema: schemas.promptsSync,
+		annotations: CONFIG_WRITE,
+		execute: ({ promptsSync }, args) => promptsSync(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: ({ mcpRemove }, 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, 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 {
+			operationsPromise ??= import("./tool-operations.mjs");
+			const operations = await operationsPromise;
+			extra.signal.throwIfAborted();
+			return toCallToolResult(await tool.execute(operations, args, extra.signal));
+		} catch (error) {
+			return errorResult(`${tool.name} failed: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	});
+	return server;
+}
 export { createMcpServer };
+
+//# sourceMappingURL=mcp.mjs.map

package/dist/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 type { McpServerParams, ToolResult } 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    operations: Readonly<typeof import(\"./tool-operations.ts\")>,\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);\nlet operationsPromise: Promise<typeof import(\"./tool-operations.ts\")> | undefined;\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 }) => 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, prompt templates, hooks, and resolved paths.\",\n    inputSchema: schemas.info,\n    annotations: READ_ONLY,\n    execute: ({ harnessInfo }, 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: ({ listHarnessModels }, 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: ({ runHarness }, 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: ({ mcpList }, 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: ({ mcpAdd }, 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: ({ mcpSync }, 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: ({ agentsSync }, args) =>\n      agentsSync(args.id as string | undefined, args.check === true),\n  },\n  {\n    name: \"harnesses_prompts_sync\",\n    title: \"Harnesses Prompts Sync\",\n    description:\n      \"Sync canonical Markdown prompt templates from the agntn XDG data directory into every supported harness. Markdown targets use links; Gemini receives generated TOML. Diverged files are backed up. Pass check to only report.\",\n    inputSchema: schemas.promptsSync,\n    annotations: CONFIG_WRITE,\n    execute: ({ promptsSync }, args) =>\n      promptsSync(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: ({ mcpRemove }, 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      operationsPromise ??= import(\"./tool-operations.ts\");\n      const operations = await operationsPromise;\n      extra.signal.throwIfAborted();\n      return toCallToolResult(await tool.execute(operations, 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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"}

package/dist/tool-operations.d.mts

@@ -1,4 +1,4 @@
-import { AgentsSyncReport, AvailableModel, HarnessCapabilities, HarnessDetection, HarnessId, HarnessInvocationModes, McpConfigListing, McpServerConfig, PathCandidate, ResolvedPaths, StorageDescriptor, SyncReport } from "./_chunks/agents-sync.mjs";
+import { AgentsSyncReport, AvailableModel, HarnessCapabilities, HarnessDetection, HarnessId, HarnessInvocationModes, McpConfigListing, McpServerConfig, PathCandidate, PromptSyncReport, PromptTemplateSyncTarget, ResolvedPaths, StorageDescriptor, SyncReport } from "./_chunks/prompt-sync.mjs";
 import { HARNESS_INFO_MAX_ITEMS } from "./_chunks/tool-schemas.mjs";
 /** Text for the model plus details for the harness, shared by every tool surface. */
 export interface ToolResult<Details> {
@@ -35,6 +35,8 @@ export interface HarnessMetadata {
   instructions: PathCandidate[];
   skills: PathCandidate[];
   commands: PathCandidate[];
+  promptTemplates: PathCandidate[];
+  promptTemplateSyncTarget: PromptTemplateSyncTarget | null;
   hooks: PathCandidate[];
   persistence: StorageDescriptor[];
   detection: HarnessDetection;
@@ -228,5 +230,13 @@ export declare function mcpSync(id?: string): ToolResult<SyncReport | RunFailure
  * @returns {ToolResult<AgentsSyncReport | RunFailure>} The sync report or failure.
  */
 export declare function agentsSync(id?: string, check?: boolean): ToolResult<AgentsSyncReport | RunFailure>;
-export { type AgentsSyncReport, HARNESS_INFO_MAX_ITEMS, type HarnessInvocationModes, type SyncReport };
+/**
+ * Synchronizes canonical Markdown prompt templates into harness destinations.
+ *
+ * @param id - Optional harness id; omission targets every harness.
+ * @param check - Report intended changes without writing them.
+ * @returns {ToolResult<PromptSyncReport | RunFailure>} The sync report or failure.
+ */
+export declare function promptsSync(id?: string, check?: boolean): ToolResult<PromptSyncReport | RunFailure>;
+export { type AgentsSyncReport, HARNESS_INFO_MAX_ITEMS, type HarnessInvocationModes, type PromptSyncReport, type SyncReport };
 //# sourceMappingURL=tool-operations.d.mts.map

package/dist/tool-operations.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-operations.d.mts","names":[],"sources":["../src/tool-operations.ts"],"mappings":";;;iBAsCiB,WAAW;EAC1B,SAAS;IAAQ;IAAc;;EAC/B,SAAS;;EAET;;;iBAIe;EACf,IAAI;EACJ;EACA;EACA;;;iBAIe;EACf,WAAW;;;iBAII;EACf,IAAI;EACJ;EACA;EACA,cAAc;EACd,iBAAiB;EACjB;EACA;EACA,QAAQ;EACR,UAAU;EACV,cAAc;EACd,QAAQ;EACR,UAAU;EACV,OAAO;EACP,aAAa;EACb,WAAW;EACX,UAAU;;;iBAIK;EACf;EACA,OAAO;;;iBAIQ;EACf;;;YAIU,oBAAoB,kBAAkB;;YAGtC,qBAAqB,oBAAoB,sBAAsB;;qBAM9D;;qBAGA;;;;;;wBAqIG,mBAAmB,WAAW;;wBAiF9B,YAAY,aAAa,WAAW;;wBAEpC,YACd,yBACC,WAAW,sBAAsB;wBACpB,YAAY,oCAAoC,WAAW;;iBA2B1D;EACf;EACA;;EAEA;;EAEA,SAAS;;;iBAIM;EACf,IAAI;EACJ;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;EACA;;;;;;;;;wBAUoB,kBACpB,YACA,UAAS,gBACR,QAAQ,WAAW,gBAAgB;;iBA4CrB;EACf;;EAEA;;EAEA;;EAEA,SAAS;;EAET;;EAEA;;EAEA;;;iBAIe;EACf,IAAI;EACJ;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;iBAIe;EACf;EACA,QAAQ;;EAER,kBAAkB;;EAElB;IAAU;IAAmB;;IAAsB;;;;;;;;;;;;;;;;;wBAyB/B,WACpB,YACA,gBACA,UAAS,aACR,QAAQ,WAAW,aAAa;;iBAkClB;EACf,WAAW;IAAQ,IAAI;IAAW,SAAS;;;;iBAY5B;EACf,IAAI;EACJ;EACA;;;iBAIe;EACf;EACA,YAAY;EACZ;EACA;EACA,MAAM;EACN;EACA,UAAU;;;;;;;;wBASI,kBAAkB,QAAQ,kBAAkB;;;;;;;wBAmB5C,QAAQ,cAAc,WAAW,aAAa;;;;;;;;;wBAgD9C,OACd,YACA,QAAQ,iBACR,6BACC,WAAW,cAAc;;;;;;;;;wBAeZ,UACd,YACA,cACA,6BACC,WAAW,cAAc;;;;;;;wBAaZ,QAAQ,cAAc,WAAW,aAAa;;;;;;;;wBA+B9C,WAAW,aAAa,kBAAgB,WAAW,mBAAmB"}
+{"version":3,"file":"tool-operations.d.mts","names":[],"sources":["../src/tool-operations.ts"],"mappings":";;;iBA4CiB,WAAW;EAC1B,SAAS;IAAQ;IAAc;;EAC/B,SAAS;;EAET;;;iBAIe;EACf,IAAI;EACJ;EACA;EACA;;;iBAIe;EACf,WAAW;;;iBAII;EACf,IAAI;EACJ;EACA;EACA,cAAc;EACd,iBAAiB;EACjB;EACA;EACA,QAAQ;EACR,UAAU;EACV,cAAc;EACd,QAAQ;EACR,UAAU;EACV,iBAAiB;EACjB,0BAA0B;EAC1B,OAAO;EACP,aAAa;EACb,WAAW;EACX,UAAU;;;iBAIK;EACf;EACA,OAAO;;;iBAIQ;EACf;;;YAIU,oBAAoB,kBAAkB;;YAGtC,qBAAqB,oBAAoB,sBAAsB;;qBAM9D;;qBAGA;;;;;;wBA2KG,mBAAmB,WAAW;;wBA6F9B,YAAY,aAAa,WAAW;;wBAEpC,YACd,yBACC,WAAW,sBAAsB;wBACpB,YAAY,oCAAoC,WAAW;;iBA2B1D;EACf;EACA;;EAEA;;EAEA,SAAS;;;iBAIM;EACf,IAAI;EACJ;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;EACA;;;;;;;;;wBAUoB,kBACpB,YACA,UAAS,gBACR,QAAQ,WAAW,gBAAgB;;iBA4CrB;EACf;;EAEA;;EAEA;;EAEA,SAAS;;EAET;;EAEA;;EAEA;;;iBAIe;EACf,IAAI;EACJ;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;;iBAIe;EACf;EACA,QAAQ;;EAER,kBAAkB;;EAElB;IAAU;IAAmB;;IAAsB;;;;;;;;;;;;;;;;;wBAyB/B,WACpB,YACA,gBACA,UAAS,aACR,QAAQ,WAAW,aAAa;;iBAkClB;EACf,WAAW;IAAQ,IAAI;IAAW,SAAS;;;;iBAY5B;EACf,IAAI;EACJ;EACA;;;iBAIe;EACf;EACA,YAAY;EACZ;EACA;EACA,MAAM;EACN;EACA,UAAU;;;;;;;;wBASI,kBAAkB,QAAQ,kBAAkB;;;;;;;wBAmB5C,QAAQ,cAAc,WAAW,aAAa;;;;;;;;;wBAgD9C,OACd,YACA,QAAQ,iBACR,6BACC,WAAW,cAAc;;;;;;;;;wBAeZ,UACd,YACA,cACA,6BACC,WAAW,cAAc;;;;;;;wBAaZ,QAAQ,cAAc,WAAW,aAAa;;;;;;;;wBA+B9C,WAAW,aAAa,kBAAgB,WAAW,mBAAmB;;;;;;;;wBAgCtE,YAAY,aAAa,kBAAgB,WAAW,mBAAmB"}

package/dist/tool-operations.mjs

@@ -1,3 +1,3 @@
 import { HARNESS_INFO_MAX_ITEMS } from "./_chunks/tool-schemas.mjs";
-import { RUN_DEFAULT_TIMEOUT_SECONDS, RUN_MAX_OUTPUT_CHARS, agentsSync, detectHarnesses, harnessInfo, listHarnessModels, mcpAdd, mcpList, mcpRemove, mcpSync, runHarness, toMcpServerConfig } from "./_chunks/tool-operations.mjs";
-export { HARNESS_INFO_MAX_ITEMS, RUN_DEFAULT_TIMEOUT_SECONDS, RUN_MAX_OUTPUT_CHARS, agentsSync, detectHarnesses, harnessInfo, listHarnessModels, mcpAdd, mcpList, mcpRemove, mcpSync, runHarness, toMcpServerConfig };
+import { RUN_DEFAULT_TIMEOUT_SECONDS, RUN_MAX_OUTPUT_CHARS, agentsSync, detectHarnesses, harnessInfo, listHarnessModels, mcpAdd, mcpList, mcpRemove, mcpSync, promptsSync, runHarness, toMcpServerConfig } from "./_chunks/tool-operations.mjs";
+export { HARNESS_INFO_MAX_ITEMS, RUN_DEFAULT_TIMEOUT_SECONDS, RUN_MAX_OUTPUT_CHARS, agentsSync, detectHarnesses, harnessInfo, listHarnessModels, mcpAdd, mcpList, mcpRemove, mcpSync, promptsSync, runHarness, toMcpServerConfig };

package/dist/tool-schemas.d.mts

@@ -1,2 +1,2 @@
-import { AgentsSyncParams, HARNESS_INFO_MAX_ITEMS, InfoParams, McpAddParams, McpListParams, McpRemoveParams, McpSchemaBuilder, McpSyncParams, ModelsParams, RUN_TIMEOUT_DEFAULT_SECONDS, RunParams, harnessToolSchemas } from "./_chunks/tool-schemas.mjs";
-export { AgentsSyncParams, HARNESS_INFO_MAX_ITEMS, InfoParams, McpAddParams, McpListParams, McpRemoveParams, McpSchemaBuilder, McpSyncParams, ModelsParams, RUN_TIMEOUT_DEFAULT_SECONDS, RunParams, harnessToolSchemas };
+import { AgentsSyncParams, HARNESS_INFO_MAX_ITEMS, InfoParams, McpAddParams, McpListParams, McpRemoveParams, McpSchemaBuilder, McpSyncParams, ModelsParams, PromptsSyncParams, RUN_TIMEOUT_DEFAULT_SECONDS, RunParams, harnessToolSchemas } from "./_chunks/tool-schemas.mjs";
+export { AgentsSyncParams, HARNESS_INFO_MAX_ITEMS, InfoParams, McpAddParams, McpListParams, McpRemoveParams, McpSchemaBuilder, McpSyncParams, ModelsParams, PromptsSyncParams, RUN_TIMEOUT_DEFAULT_SECONDS, RunParams, harnessToolSchemas };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agntn/harnesses",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Metadata registry for AI coding harnesses: binaries, configs, sessions, and capabilities.",
   "homepage": "https://harnesses.agntn.dev",
   "bugs": "https://github.com/agntn/harnesses/issues",
@@ -38,14 +38,15 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.30.0",
-    "@toon-format/toon": "^4.1.1",
-    "citty": "^0.2.2",
-    "consola": "^3.4.2",
-    "smol-toml": "^1.8.0",
-    "typebox": "^1.3.33"
+    "@toon-format/toon": "4.1.1",
+    "citty": "0.2.2",
+    "consola": "3.4.2",
+    "smol-toml": "1.8.0",
+    "typebox": "1.3.34",
+    "yaml": "2.9.1"
   },
   "devDependencies": {
-    "@agntn/ox": "^0.1.0",
+    "@agntn/ox": "0.1.0",
     "@earendil-works/pi-coding-agent": "0.85.1",
     "@earendil-works/pi-tui": "0.85.1",
     "@oh-my-pi/omptype": "18.2.5",
@@ -53,13 +54,13 @@
     "@oh-my-pi/pi-coding-agent": "18.2.5",
     "@types/node": "latest",
     "@typescript/native-preview": "latest",
-    "changelogen": "^0.6.2",
-    "obuild": "^0.4.40",
-    "oxfmt": "^0.68.0",
-    "oxlint": "^1.83.0",
-    "oxlint-tsgolint": "^7.0.2002",
+    "changelogen": "0.6.2",
+    "obuild": "0.4.40",
+    "oxfmt": "0.68.0",
+    "oxlint": "1.83.0",
+    "oxlint-tsgolint": "7.0.2002",
     "typescript": "6.0.3",
-    "vitest": "^5.0.1"
+    "vitest": "5.0.1"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": ">=0.84.2 <1",
@@ -88,7 +89,8 @@
   "pi": {
     "extensions": [
       "./packages/pi/extensions/harnesses.ts"
-    ]
+    ],
+    "image": "https://harnesses.agntn.dev/image.png"
   },
   "scripts": {
     "build": "obuild",

package/packages/omp/extensions/harnesses.ts

@@ -82,7 +82,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
     name: "harnesses_info",
     label: HARNESS_TOOL_LABELS.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",
+      "Full metadata for one or more AI coding harnesses, including supported invocation and model operations, configuration, sessions, instructions, skills, commands, prompt templates, hooks, and resolved paths",
     parameters: schemas.info,
     approval: HARNESS_TOOL_APPROVALS.harnesses_info,
     async execute(
@@ -239,6 +239,24 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
     ...statusRenderers("harnesses_agents_sync"),
   });
 
+  pi.registerTool({
+    name: "harnesses_prompts_sync",
+    label: HARNESS_TOOL_LABELS.harnesses_prompts_sync,
+    description:
+      "Sync canonical Markdown prompt templates from the agntn XDG data directory into supported harnesses; Gemini receives generated TOML. Diverged files are backed up. Pass check to only report",
+    parameters: schemas.promptsSync,
+    approval: HARNESS_TOOL_APPROVALS.harnesses_prompts_sync,
+    async execute(
+      _toolCallId,
+      params: Readonly<HarnessSchemas.PromptsSyncParams>,
+    ): Promise<AgentToolResult<HarnessTools.PromptSyncReport | HarnessTools.RunFailure>> {
+      const { promptsSync } = await loadToolOperations();
+      const { content, details, isError } = promptsSync(params.id, params.check === true);
+      return { content, details, isError };
+    },
+    ...statusRenderers("harnesses_prompts_sync"),
+  });
+
   pi.registerTool({
     name: "harnesses_mcp_remove",
     label: HARNESS_TOOL_LABELS.harnesses_mcp_remove,

package/packages/pi/extensions/harnesses.ts

@@ -97,7 +97,7 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
     name: "harnesses_info",
     label: HARNESS_TOOL_LABELS.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",
+      "Full metadata for one or more AI coding harnesses, including supported invocation and model operations, configuration, sessions, instructions, skills, commands, prompt templates, hooks, and resolved paths",
     promptSnippet: "Use harnesses_info to look up where coding harnesses store their data.",
     promptGuidelines: [
       "Pass one harness id from harnesses_detect, or batch several ids in one call.",
@@ -270,6 +270,28 @@ export default function harnessesExtension(pi: ExtensionAPI): void {
     },
   });
 
+  pi.registerTool({
+    name: "harnesses_prompts_sync",
+    label: HARNESS_TOOL_LABELS.harnesses_prompts_sync,
+    description:
+      "Sync canonical Markdown prompt templates from the agntn XDG data directory into supported harnesses; Gemini receives generated TOML. Diverged files are backed up. Pass check to only report",
+    parameters: schemas.promptsSync,
+    ...statusRenderers("harnesses_prompts_sync"),
+    async execute(
+      _toolCallId,
+      params: Readonly<HarnessSchemas.PromptsSyncParams>,
+    ): Promise<AgentToolResult<HarnessTools.PromptSyncReport | HarnessTools.RunFailure>> {
+      const { promptsSync } = await loadToolOperations();
+      const { content, details, isError } = promptsSync(params.id, params.check === true);
+      if (isError) {
+        throw new Error(
+          "error" in details ? details.error : (content[0]?.text ?? "Prompt sync failed"),
+        );
+      }
+      return { content, details };
+    },
+  });
+
   pi.registerTool({
     name: "harnesses_mcp_remove",
     label: HARNESS_TOOL_LABELS.harnesses_mcp_remove,

package/packages/shared/tui.ts

@@ -9,6 +9,7 @@ export const HARNESS_TOOL_LABELS = {
   harnesses_mcp_add: "Harnesses MCP Add",
   harnesses_mcp_sync: "Harnesses MCP Sync",
   harnesses_agents_sync: "Harnesses Agents Sync",
+  harnesses_prompts_sync: "Harnesses Prompts Sync",
   harnesses_mcp_remove: "Harnesses MCP Remove",
 } as const;
 
@@ -23,6 +24,7 @@ export const HARNESS_TOOL_APPROVALS: Record<HarnessToolName, "read" | "exec" | "
   harnesses_mcp_add: "write",
   harnesses_mcp_sync: "write",
   harnesses_agents_sync: "write",
+  harnesses_prompts_sync: "write",
   harnesses_mcp_remove: "write",
 };
 
@@ -93,8 +95,16 @@ function listLength(record: Readonly<Record<string, unknown>>, key: string): num
 
 function resultText(result: RenderedToolResult): string {
   const parts: string[] = [];
+  let length = 0;
   for (const part of result.content ?? []) {
-    if (isRecord(part) && typeof part.text === "string") parts.push(part.text);
+    if (!isRecord(part) || typeof part.text !== "string") continue;
+    const separator = parts.length === 0 ? 0 : 1;
+    const remaining = RESULT_BODY_LIMIT + 1 - length - separator;
+    if (remaining < 0) break;
+    const text = part.text.slice(0, remaining);
+    parts.push(text);
+    length += separator + text.length;
+    if (length > RESULT_BODY_LIMIT) break;
   }
   return parts.join("\n");
 }
@@ -150,6 +160,7 @@ const CALL_DESCRIPTIONS: Record<HarnessToolName, CallDescriptionRenderer> = {
   harnesses_mcp_add: mutationDescription,
   harnesses_mcp_sync: idDescription,
   harnesses_agents_sync: agentsDescription,
+  harnesses_prompts_sync: agentsDescription,
   harnesses_mcp_remove: mutationDescription,
 };
 
@@ -267,6 +278,15 @@ function agentsSyncMeta(details: ResultDetails): string[] {
   return [`${changed} targets`];
 }
 
+function promptsSyncMeta(details: ResultDetails): string[] {
+  const templates = listLength(details, "templates");
+  const targets = listLength(details, "targets");
+  return compactStrings([
+    templates === undefined ? undefined : `${templates} templates`,
+    targets === undefined ? undefined : `${targets} harnesses`,
+  ]);
+}
+
 const RESULT_META: Record<HarnessToolName, ResultMetaRenderer> = {
   harnesses_detect: detectMeta,
   harnesses_info: infoMeta,
@@ -276,6 +296,7 @@ const RESULT_META: Record<HarnessToolName, ResultMetaRenderer> = {
   harnesses_mcp_add: mutationMeta,
   harnesses_mcp_sync: mcpSyncMeta,
   harnesses_agents_sync: agentsSyncMeta,
+  harnesses_prompts_sync: promptsSyncMeta,
   harnesses_mcp_remove: mutationMeta,
 };
 

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

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