@agntn/harnesses 0.2.1 → 0.3.1

package/README.md

@@ -26,7 +26,7 @@ The rest of it sits on [harnesses.agntn.dev](https://harnesses.agntn.dev).
 - 🔗 **One AGENTS.md behind the global files.** Symlinks, so an edit through Claude or Gemini is the same bytes.
 - 🗂️ **One prompt folder, supported harnesses.** Markdown lives under XDG data; Gemini TOML is generated from it.
 - 📜 **Session types when the format is stable.** JSONL, SQLite, JSON. Unstable shapes stay `unknown`.
-- 🤖 **Ten tools, three doors.** MCP, Pi and OMP call the same executors.
+- 🤖 **Eleven tools, three doors.** MCP, Pi and OMP call the same executors.
 
 ## 📦 Install
 
@@ -74,9 +74,10 @@ harnesses run codex --read-only "review this"
 harnesses mcp-servers list
 harnesses agents sync --check
 harnesses prompts sync --check
+harnesses skills sync --check
 ```
 
-`run` without `--tools` is the advisor. `--tools` is the full agent. `--read-only` asks the CLI for a sandbox and implies tools. Timeouts, `--cwd` and `--model` sit in the [CLI guide](https://harnesses.agntn.dev/guide/cli).
+`run` without `--tools` is the advisor. `--tools` is the full agent. `--read-only` asks the CLI for a sandbox and implies tools, so pairing it with `--no-tools` is an error. Timeouts, `--cwd` and `--model` sit in the [CLI guide](https://harnesses.agntn.dev/guide/cli).
 
 ### Commands
 
@@ -91,6 +92,7 @@ harnesses prompts sync --check
 | `mcp-servers`  | MCP servers across the config dialects                 | `harnesses mcp-servers list`                |
 | `agents sync`  | Link global instructions files to one master           | `harnesses agents sync --check`             |
 | `prompts sync` | Sync one Markdown prompt directory across harnesses    | `harnesses prompts sync --check`            |
+| `skills sync`  | Link every skills directory to one shared folder       | `harnesses skills sync --check`             |
 | `mcp`          | The MCP server on stdio                                | `harnesses mcp`                             |
 
 `list`, `detect`, `info`, `paths` and `models` take `--json` or `--toon`. `run --json` is different: that one is the harness's own structured output.
@@ -103,14 +105,21 @@ import { getHarness, detectHarness } from "@agntn/harnesses";
 const claude = getHarness("claude");
 const paths = claude.resolve({ platform: "linux", homeDir: "/home/dev" });
 console.log(paths.skills);
+console.log(paths.temp, claude.envOverrides);
 
 const active = detectHarness();
 if (active) console.log(active.id);
 
 await getHarness("codex").invoke("Review this patch", { readOnly: true });
+
+const agy = getHarness("antigravity");
+const [model] = (await agy.listModels({ search: "gemini" })).models;
+if (model) await agy.invoke("Review this patch", { tools: true, model: agy.modelSelector(model) });
 ```
 
-That's most of it, really. `getHarness` wants an exact id. `detectHarness` uses env vars first, then a single project marker. `invoke()` talks to the CLI. A mode the CLI cannot run comes back as an error, not a quieter one. The rest: [Registry](https://harnesses.agntn.dev/guide/registry), [Invoke](https://harnesses.agntn.dev/guide/invoke), [MCP servers](https://harnesses.agntn.dev/guide/mcp-servers), [Instructions files](https://harnesses.agntn.dev/guide/agents-sync).
+`temp` is where a harness drops its own temp files, and `envOverrides` names the variables that move its directories. `claude.resolve().temp` follows `CLAUDE_CODE_TMPDIR` when it's set, which is handy when `/tmp` is tmpfs and Claude's scratchpads are quietly eating RAM.
+
+That's most of it, really. `getHarness` wants an exact id. `detectHarness` uses env vars first, then a single project marker. `invoke()` talks to the CLI. `listModels()` asks it what it can run, and `modelSelector()` turns one of those into what `model` takes, since Pi wants `provider/id` and Antigravity the bare id. A mode the CLI cannot run comes back as an error, not a quieter one. The rest: [Registry](https://harnesses.agntn.dev/guide/registry), [Invoke](https://harnesses.agntn.dev/guide/invoke), [MCP servers](https://harnesses.agntn.dev/guide/mcp-servers), [Instructions files](https://harnesses.agntn.dev/guide/agents-sync).
 
 ### Prompt templates
 
@@ -123,15 +132,45 @@ harnesses prompts sync --check
 harnesses prompts sync
 ```
 
-Markdown harnesses receive symlinks to those files. Gemini receives generated
-TOML commands, with `$ARGUMENTS` translated to `{{args}}`. Unmanaged files at a
-managed name are backed up under the same XDG data tree before replacement.
+For a Markdown harness, the whole prompt directory becomes one symlink to that
+directory, so a template added through any harness shows up in all of them.
+Gemini gets generated TOML commands, with `$ARGUMENTS` translated to `{{args}}`,
+and its commands directory keeps nothing else. Whatever was there before is
+backed up under the same XDG data tree first.
 
 `getHarness("pi").promptTemplates` still lists every verified reusable prompt
 location. `promptTemplateSyncTarget` is the single stable user destination the
 sync owns for that harness. Formats, frontmatter and CLI limits are in the
 [registry guide](https://harnesses.agntn.dev/guide/registry#prompt-templates).
 
+### Skills
+
+Skills live in `$XDG_DATA_HOME/agntn/skills/`, next to the prompts, one folder
+with a `SKILL.md` per skill:
+
+```bash
+harnesses skills sync --check
+harnesses skills sync
+```
+
+```ts
+import { getAllHarnesses, syncSkills } from "@agntn/harnesses";
+
+const report = syncSkills(getAllHarnesses(), true);
+console.log(report.skills, report.targets);
+```
+
+Every harness's user skills directory, `~/.claude/skills/`, `~/.agents/skills/`
+for Codex, `~/.pi/agent/skills/` and the rest, becomes one symlink to that
+folder. A skill written through Claude is already there when Pi looks. Old
+setups with a symlink per skill get replaced without ceremony, and a directory
+with real skills in it is backed up to `diverged/skills/` first. Already keep
+skills in a dotfiles repo? Make the XDG folder a symlink to it. The sync leaves
+a harness directory alone if the source points into it, instead of moving your
+only copy away. `skillsSyncTarget` names the directory it links for each
+harness, `null` for Copilot and Freebuff, which have no user skills directory
+in the registry.
+
 ## 🗺️ Harnesses
 
 | ID               | Name                   | Project skills         |
@@ -168,7 +207,7 @@ omp install @agntn/harnesses
 }
 ```
 
-Ten tools, the same ten on MCP, Pi and OMP. `harnesses_detect`, `harnesses_info` and `harnesses_mcp_list` only read. `harnesses_run` is the one that can spend tokens. `tools` is required, so the model has to pick advisor or agent. What each call returns is on the [Agents page](https://harnesses.agntn.dev/guide/agents).
+Eleven tools, the same eleven on MCP, Pi and OMP. `harnesses_detect`, `harnesses_info` and `harnesses_mcp_list` only read. `harnesses_run` is the one that can spend tokens. `tools` is required, so the model has to pick advisor or agent. What each call returns is on the [Agents page](https://harnesses.agntn.dev/guide/agents).
 
 ## 🚫 What this does not do
 
@@ -182,11 +221,11 @@ Want a fourteenth? One class extending `Harness`, then `registerHarness`. `getHa
 
 ```bash
 pnpm install
-pnpm lint        # builds first, then oxlint and oxfmt --check
+pnpm lint        # builds first, then vp lint and vp fmt --check
 pnpm lint:fix
 pnpm typecheck
 pnpm test:run
-pnpm build       # obuild
+pnpm build       # vp pack
 pnpm docs        # the Docus site, bundles src/ itself
 ```
 

package/dist/_chunks/agents.mjs

@@ -1,8 +1,9 @@
-import { isHarnessId, listHarnesses } from "./prompt-sync.mjs";
-import { agentsSync } from "./tool-operations.mjs";
-import { formatArgs, report } from "./output.mjs";
+import { v as isHarnessId, y as listHarnesses } from "./skills-sync.mjs";
+import { r as agentsSync } from "./tool-operations.mjs";
+import { n as formatArgs, r as report } from "./output.mjs";
 import { defineCommand } from "citty";
 import { consola } from "consola";
+//#region src/commands/agents.ts
 var agents_default = defineCommand({
 	meta: { description: "Manage the shared global instructions file across harnesses" },
 	subCommands: { sync: defineCommand({
@@ -29,6 +30,7 @@ var agents_default = defineCommand({
 		}
 	}) }
 });
+//#endregion
 export { agents_default as default };
 
 //# sourceMappingURL=agents.mjs.map

package/dist/_chunks/agents.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agents.mjs","names":[],"sources":["../../src/commands/agents.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { consola } from \"consola\";\nimport { isHarnessId, listHarnesses } from \"../registry.ts\";\nimport { agentsSync } from \"../tool-operations.ts\";\nimport { formatArgs, report } from \"./output.ts\";\n\nexport default defineCommand({\n  meta: { description: \"Manage the shared global instructions file across harnesses\" },\n  subCommands: {\n    sync: defineCommand({\n      meta: {\n        description:\n          \"Link global instructions and declared companions (agents.jsonc: source, companions, excludes)\",\n      },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: false },\n        check: {\n          type: \"boolean\" as const,\n          description: \"Report what would change without writing anything\",\n        },\n        ...formatArgs,\n      },\n      run({ args }) {\n        const id = args.id === undefined ? undefined : (args.id as string);\n        if (id !== undefined && !isHarnessId(id)) {\n          consola.error(`Unknown harness: ${id}\\nKnown: ${listHarnesses().join(\", \")}`);\n          process.exit(1);\n        }\n        report(agentsSync(id, args.check === true), args);\n      },\n    }),\n  },\n});\n"],"mappings":";;;;;AAMA,IAAA,iBAAe,cAAc;CAC3B,MAAM,EAAE,aAAa,8DAA8D;CACnF,aAAa,EACX,MAAM,cAAc;EAClB,MAAM,EACJ,aACE,gGACJ;EACA,MAAM;GACJ,IAAI;IAAE,MAAM;IAAuB,aAAa;IAAc,UAAU;GAAM;GAC9E,OAAO;IACL,MAAM;IACN,aAAa;GACf;GACA,GAAG;EACL;EACA,IAAI,EAAE,QAAQ;GACZ,MAAM,KAAK,KAAK,OAAO,KAAA,IAAY,KAAA,IAAa,KAAK;GACrD,IAAI,OAAO,KAAA,KAAa,CAAC,YAAY,EAAE,GAAG;IACxC,QAAQ,MAAM,oBAAoB,GAAG,WAAW,cAAc,CAAC,CAAC,KAAK,IAAI,GAAG;IAC5E,QAAQ,KAAK,CAAC;GAChB;GACA,OAAO,WAAW,IAAI,KAAK,UAAU,IAAI,GAAG,IAAI;EAClD;CACF,CAAC,EACH;AACF,CAAC"}
+{"version":3,"file":"agents.mjs","names":[],"sources":["../../src/commands/agents.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { consola } from \"consola\";\nimport { isHarnessId, listHarnesses } from \"../registry.ts\";\nimport { agentsSync } from \"../tool-operations.ts\";\nimport { formatArgs, report } from \"./output.ts\";\n\nexport default defineCommand({\n  meta: { description: \"Manage the shared global instructions file across harnesses\" },\n  subCommands: {\n    sync: defineCommand({\n      meta: {\n        description:\n          \"Link global instructions and declared companions (agents.jsonc: source, companions, excludes)\",\n      },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: false },\n        check: {\n          type: \"boolean\" as const,\n          description: \"Report what would change without writing anything\",\n        },\n        ...formatArgs,\n      },\n      run({ args }) {\n        const id = args.id === undefined ? undefined : (args.id as string);\n        if (id !== undefined && !isHarnessId(id)) {\n          consola.error(`Unknown harness: ${id}\\nKnown: ${listHarnesses().join(\", \")}`);\n          process.exit(1);\n        }\n        report(agentsSync(id, args.check === true), args);\n      },\n    }),\n  },\n});\n"],"mappings":";;;;;;AAMA,IAAA,iBAAe,cAAc;CAC3B,MAAM,EAAE,aAAa,8DAA8D;CACnF,aAAa,EACX,MAAM,cAAc;EAClB,MAAM,EACJ,aACE,gGACJ;EACA,MAAM;GACJ,IAAI;IAAE,MAAM;IAAuB,aAAa;IAAc,UAAU;GAAM;GAC9E,OAAO;IACL,MAAM;IACN,aAAa;GACf;GACA,GAAG;EACL;EACA,IAAI,EAAE,QAAQ;GACZ,MAAM,KAAK,KAAK,OAAO,KAAA,IAAY,KAAA,IAAa,KAAK;GACrD,IAAI,OAAO,KAAA,KAAa,CAAC,YAAY,EAAE,GAAG;IACxC,QAAQ,MAAM,oBAAoB,GAAG,WAAW,cAAc,CAAC,CAAC,KAAK,IAAI,GAAG;IAC5E,QAAQ,KAAK,CAAC;GAChB;GACA,OAAO,WAAW,IAAI,KAAK,UAAU,IAAI,GAAG,IAAI;EAClD;CACF,CAAC,EACH;AACF,CAAC"}

package/dist/_chunks/mcp-servers.mjs

@@ -1,8 +1,9 @@
-import { isHarnessId, listHarnesses } from "./prompt-sync.mjs";
-import { mcpAdd, mcpList, mcpRemove, mcpSync } from "./tool-operations.mjs";
-import { formatArgs, report } from "./output.mjs";
+import { v as isHarnessId, y as listHarnesses } from "./skills-sync.mjs";
+import { c as mcpList, l as mcpRemove, s as mcpAdd, u as mcpSync } from "./tool-operations.mjs";
+import { n as formatArgs, r as report } from "./output.mjs";
 import { defineCommand } from "citty";
 import { consola } from "consola";
+//#region src/commands/mcp-servers.ts
 function requireHarnessId(id) {
 	if (!isHarnessId(id)) {
 		consola.error(`Unknown harness: ${id}\nKnown: ${listHarnesses().join(", ")}`);
@@ -115,6 +116,7 @@ var mcp_servers_default = defineCommand({
 		})
 	}
 });
+//#endregion
 export { mcp_servers_default as default };
 
 //# sourceMappingURL=mcp-servers.mjs.map

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

@@ -1 +1 @@
-{"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"}
+{"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,5 +1,7 @@
+import { t as exitOnClosedPipe } from "./output.mjs";
 import { defineCommand } from "citty";
 import { LogLevels, consola } from "consola";
+//#region src/commands/mcp.ts
 var mcp_default = defineCommand({
 	meta: {
 		name: "mcp",
@@ -8,9 +10,16 @@ var mcp_default = defineCommand({
 	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());
+		const server = createMcpServer();
+		await server.connect(new StdioServerTransport());
+		process.stdin.once("end", () => void server.close());
+		process.stdout.off("error", exitOnClosedPipe).on("error", (error) => {
+			if (error.code !== "EPIPE") throw error;
+			server.close();
+		});
 	}
 });
+//#endregion
 export { mcp_default as default };
 
 //# sourceMappingURL=mcp.mjs.map

package/dist/_chunks/mcp.mjs.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"mcp.mjs","names":[],"sources":["../../src/commands/mcp.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { consola, LogLevels } from \"consola\";\nimport { exitOnClosedPipe } from \"./output.ts\";\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   * The SDK's stdio transport never watches for the end of stdin, so a client\n   * that exits would leave an in-flight `harnesses_run` going until its own\n   * deadline. Closing the server aborts every pending request signal, which\n   * stops each run's process group the same way a cancellation does, and the\n   * process then exits once that cleanup has nothing left to wait for. A\n   * write to a stdout the client already closed means the same, so it closes\n   * the server too instead of exiting past that cleanup.\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    const server = createMcpServer();\n    await server.connect(new StdioServerTransport());\n    process.stdin.once(\"end\", () => void server.close());\n    process.stdout\n      .off(\"error\", exitOnClosedPipe)\n      .on(\"error\", (error: Readonly<NodeJS.ErrnoException>) => {\n        if (error.code !== \"EPIPE\") throw error;\n        void server.close();\n      });\n  },\n});\n"],"mappings":";;;;AAIA,IAAA,cAAe,cAAc;CAC3B,MAAM;EACJ,MAAM;EACN,aAAa;CACf;CAkBA,MAAM,MAAM;EACV,QAAQ,QAAQ,UAAU;EAE1B,MAAM,CAAC,EAAE,mBAAmB,EAAE,0BAA0B,MAAM,QAAQ,IAAI,CACxE,OAAO,eACP,OAAO,4CACT,CAAC;EACD,MAAM,SAAS,gBAAgB;EAC/B,MAAM,OAAO,QAAQ,IAAI,qBAAqB,CAAC;EAC/C,QAAQ,MAAM,KAAK,aAAa,KAAK,OAAO,MAAM,CAAC;EACnD,QAAQ,OACL,IAAI,SAAS,gBAAgB,CAAC,CAC9B,GAAG,UAAU,UAA2C;GACvD,IAAI,MAAM,SAAS,SAAS,MAAM;GAClC,OAAY,MAAM;EACpB,CAAC;CACL;AACF,CAAC"}

package/dist/_chunks/output.mjs

@@ -1,6 +1,7 @@
 import { stripVTControlCharacters } from "node:util";
 import { consola } from "consola";
 import { encode } from "@toon-format/toon";
+//#region src/commands/output.ts
 const formatArgs = {
 	json: {
 		type: "boolean",
@@ -11,6 +12,10 @@ const formatArgs = {
 		description: "Output as TOON"
 	}
 };
+function exitOnClosedPipe(error) {
+	if (error.code !== "EPIPE") throw error;
+	process.exit();
+}
 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) {
@@ -23,6 +28,7 @@ function report(result, args) {
 	else console.log(sanitize(result.content[0]?.text));
 	if (result.isError) process.exitCode = 1;
 }
-export { formatArgs, report };
+//#endregion
+export { formatArgs as n, report as r, exitOnClosedPipe as t };
 
 //# sourceMappingURL=output.mjs.map

package/dist/_chunks/output.mjs.map

@@ -1 +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"}
+{"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\n/**\n * Ends the process once the reader of stdout or stderr is gone, as after\n * `| head -1` or a pager that quits early. Node ignores SIGPIPE, so without a\n * listener the next write throws `EPIPE` with a stack trace. The exit code\n * stays whatever the command set.\n *\n * @param error - The error the stream emitted.\n */\nexport function exitOnClosedPipe(error: Readonly<NodeJS.ErrnoException>): void {\n  if (error.code !== \"EPIPE\") throw error;\n  process.exit();\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;AAUA,SAAgB,iBAAiB,OAA8C;CAC7E,IAAI,MAAM,SAAS,SAAS,MAAM;CAClC,QAAQ,KAAK;AACf;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;AAQA,SAAgB,OAAO,QAA6B,MAA0B;CAC5E,IAAI,KAAK,MAAM,QAAQ,IAAI,KAAK,UAAU,OAAO,SAAS,MAAM,CAAC,CAAC;MAC7D,IAAI,KAAK,MAAM,QAAQ,IAAIA,OAAO,OAAO,OAAO,CAAC;MACjD,IAAI,OAAO,SAAS,QAAQ,MAAM,SAAS,OAAO,QAAQ,EAAE,EAAE,IAAI,CAAC;MACnE,QAAQ,IAAI,SAAS,OAAO,QAAQ,EAAE,EAAE,IAAI,CAAC;CAElD,IAAI,OAAO,SAAS,QAAQ,WAAW;AACzC"}

package/dist/_chunks/prompts.mjs

@@ -1,6 +1,7 @@
-import { promptsSync } from "./tool-operations.mjs";
-import { formatArgs, report } from "./output.mjs";
+import { d as promptsSync } from "./tool-operations.mjs";
+import { n as formatArgs, r as report } from "./output.mjs";
 import { defineCommand } from "citty";
+//#region src/commands/prompts.ts
 var prompts_default = defineCommand({
 	meta: { description: "Manage shared prompt templates across harnesses" },
 	subCommands: { sync: defineCommand({
@@ -23,6 +24,7 @@ var prompts_default = defineCommand({
 		}
 	}) }
 });
+//#endregion
 export { prompts_default as default };
 
 //# sourceMappingURL=prompts.mjs.map

package/dist/_chunks/prompts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.mjs","names":[],"sources":["../../src/commands/prompts.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { promptsSync } from \"../tool-operations.ts\";\nimport { formatArgs, report } from \"./output.ts\";\n\nexport default defineCommand({\n  meta: { description: \"Manage shared prompt templates across harnesses\" },\n  subCommands: {\n    sync: defineCommand({\n      meta: {\n        description:\n          \"Sync Markdown templates from the agntn XDG data directory into harness destinations\",\n      },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: false },\n        check: {\n          type: \"boolean\" as const,\n          description: \"Report what would change without writing anything\",\n        },\n        ...formatArgs,\n      },\n      run({ args }) {\n        const id = args.id === undefined ? undefined : (args.id as string);\n        report(promptsSync(id, args.check === true), args);\n      },\n    }),\n  },\n});\n"],"mappings":";;;AAIA,IAAA,kBAAe,cAAc;CAC3B,MAAM,EAAE,aAAa,kDAAkD;CACvE,aAAa,EACX,MAAM,cAAc;EAClB,MAAM,EACJ,aACE,sFACJ;EACA,MAAM;GACJ,IAAI;IAAE,MAAM;IAAuB,aAAa;IAAc,UAAU;GAAM;GAC9E,OAAO;IACL,MAAM;IACN,aAAa;GACf;GACA,GAAG;EACL;EACA,IAAI,EAAE,QAAQ;GACZ,MAAM,KAAK,KAAK,OAAO,KAAA,IAAY,KAAA,IAAa,KAAK;GACrD,OAAO,YAAY,IAAI,KAAK,UAAU,IAAI,GAAG,IAAI;EACnD;CACF,CAAC,EACH;AACF,CAAC"}
+{"version":3,"file":"prompts.mjs","names":[],"sources":["../../src/commands/prompts.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { promptsSync } from \"../tool-operations.ts\";\nimport { formatArgs, report } from \"./output.ts\";\n\nexport default defineCommand({\n  meta: { description: \"Manage shared prompt templates across harnesses\" },\n  subCommands: {\n    sync: defineCommand({\n      meta: {\n        description:\n          \"Sync Markdown templates from the agntn XDG data directory into harness destinations\",\n      },\n      args: {\n        id: { type: \"positional\" as const, description: \"Harness id\", required: false },\n        check: {\n          type: \"boolean\" as const,\n          description: \"Report what would change without writing anything\",\n        },\n        ...formatArgs,\n      },\n      run({ args }) {\n        const id = args.id === undefined ? undefined : (args.id as string);\n        report(promptsSync(id, args.check === true), args);\n      },\n    }),\n  },\n});\n"],"mappings":";;;;AAIA,IAAA,kBAAe,cAAc;CAC3B,MAAM,EAAE,aAAa,kDAAkD;CACvE,aAAa,EACX,MAAM,cAAc;EAClB,MAAM,EACJ,aACE,sFACJ;EACA,MAAM;GACJ,IAAI;IAAE,MAAM;IAAuB,aAAa;IAAc,UAAU;GAAM;GAC9E,OAAO;IACL,MAAM;IACN,aAAa;GACf;GACA,GAAG;EACL;EACA,IAAI,EAAE,QAAQ;GACZ,MAAM,KAAK,KAAK,OAAO,KAAA,IAAY,KAAA,IAAa,KAAK;GACrD,OAAO,YAAY,IAAI,KAAK,UAAU,IAAI,GAAG,IAAI;EACnD;CACF,CAAC,EACH;AACF,CAAC"}