@agntn/harnesses 0.2.0 → 0.3.0

package/README.md

@@ -24,8 +24,9 @@ The rest of it sits on [harnesses.agntn.dev](https://harnesses.agntn.dev).
 - ▶️ **Headless runs with real modes.** Advisor without tools, full agent, or a native read-only sandbox. A mode the CLI cannot enforce is rejected.
 - 🔌 **MCP across the dialects.** One master list at `~/.config/agntn/mcp.jsonc`. TOML edits keep the comments.
 - 🔗 **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`.
-- 🤖 **Nine tools, three doors.** MCP, Pi and OMP call the same executors.
+- 🤖 **Ten tools, three doors.** MCP, Pi and OMP call the same executors.
 
 ## 📦 Install
 
@@ -72,23 +73,25 @@ harnesses run claude "review this design"
 harnesses run codex --read-only "review this"
 harnesses mcp-servers list
 harnesses agents sync --check
+harnesses prompts 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
 
-| Command       | What it does                                           | Example                                     |
-| ------------- | ------------------------------------------------------ | ------------------------------------------- |
-| `list`        | Every known harness, id and name                       | `harnesses list`                            |
-| `detect`      | Which ones are installed, with versions                | `harnesses detect`                          |
-| `info`        | Registry entry: modes, capabilities, path templates    | `harnesses info claude`                     |
-| `paths`       | Those templates expanded for this machine              | `harnesses paths pi`                        |
-| `models`      | Models the harness can use, through its native listing | `harnesses models pi`                       |
-| `run`         | One prompt through headless mode                       | `harnesses run claude "review this design"` |
-| `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`             |
-| `mcp`         | The MCP server on stdio                                | `harnesses mcp`                             |
+| Command        | What it does                                           | Example                                     |
+| -------------- | ------------------------------------------------------ | ------------------------------------------- |
+| `list`         | Every known harness, id and name                       | `harnesses list`                            |
+| `detect`       | Which ones are installed, with versions                | `harnesses detect`                          |
+| `info`         | Registry entry: modes, capabilities, path templates    | `harnesses info claude`                     |
+| `paths`        | Those templates expanded for this machine              | `harnesses paths pi`                        |
+| `models`       | Models the harness can use, through its native listing | `harnesses models pi`                       |
+| `run`          | One prompt through headless mode                       | `harnesses run claude "review this design"` |
+| `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`            |
+| `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.
 
@@ -100,14 +103,43 @@ 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
+
+Put canonical Markdown templates in `$XDG_DATA_HOME/agntn/prompts/`, or
+`~/.local/share/agntn/prompts/` when `XDG_DATA_HOME` is unset. Then sync every
+supported harness:
+
+```bash
+harnesses prompts sync --check
+harnesses prompts sync
+```
+
+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).
 
 ## 🗺️ Harnesses
 
@@ -145,7 +177,7 @@ omp install @agntn/harnesses
 }
 ```
 
-Nine tools, the same nine 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).
+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).
 
 ## 🚫 What this does not do
 

package/dist/_chunks/agents.mjs

@@ -1,36 +1,8 @@
-import { isHarnessId, listHarnesses } from "./agents-sync.mjs";
+import { isHarnessId, listHarnesses } from "./prompt-sync.mjs";
 import { agentsSync } from "./tool-operations.mjs";
-import { stripVTControlCharacters } from "node:util";
+import { formatArgs, report } from "./output.mjs";
 import { defineCommand } from "citty";
 import { consola } from "consola";
-import { encode } from "@toon-format/toon";
-const formatArgs = {
-	json: {
-		type: "boolean",
-		description: "Output as JSON"
-	},
-	toon: {
-		type: "boolean",
-		description: "Output as TOON"
-	}
-};
-const UNSAFE_TERMINAL_CONTROLS = /[\u0000-\u0008\u000B-\u001F\u007F-\u009F]/g;
-function report(result, args) {
-	const sanitize = (text) => stripVTControlCharacters(text ?? "").replace(UNSAFE_TERMINAL_CONTROLS, " ");
-	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));
-}
 var agents_default = defineCommand({
 	meta: { description: "Manage the shared global instructions file across harnesses" },
 	subCommands: { sync: defineCommand({

package/dist/_chunks/agents.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"agents.mjs","names":["toToon"],"sources":["../../src/commands/agents.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 { agentsSync, 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// Sync reports echo backup paths and config values, so strip terminal controls.\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 report(\n  result: ToolResult<unknown>,\n  args: Readonly<{ json?: boolean; toon?: boolean }>,\n): void {\n  const sanitize = (text: string | undefined) =>\n    stripVTControlCharacters(text ?? \"\").replace(UNSAFE_TERMINAL_CONTROLS, \" \");\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\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":";;;;;;AAOA,MAAM,aAAa;CACjB,MAAM;EAAE,MAAM;EAAoB,aAAa;CAAiB;CAChE,MAAM;EAAE,MAAM;EAAoB,aAAa;CAAiB;AAClE;AAIA,MAAM,2BAA2B;AAEjC,SAAS,OACP,QACA,MACM;CACN,MAAM,YAAY,SAChB,yBAAyB,QAAQ,EAAE,CAAC,CAAC,QAAQ,0BAA0B,GAAG;CAC5E,IAAI,OAAO,SAAS;EAClB,QAAQ,MAAM,SAAS,OAAO,QAAQ,EAAE,EAAE,IAAI,CAAC;EAC/C,QAAQ,KAAK,CAAC;CAChB;CACA,IAAI,KAAK,MAAM;EACb,QAAQ,IAAI,KAAK,UAAU,OAAO,SAAS,MAAM,CAAC,CAAC;EACnD;CACF;CACA,IAAI,KAAK,MAAM;EACb,QAAQ,IAAIA,OAAO,OAAO,OAAO,CAAC;EAClC;CACF;CACA,QAAQ,IAAI,SAAS,OAAO,QAAQ,EAAE,EAAE,IAAI,CAAC;AAC/C;AAEA,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/libs/typebox.mjs

@@ -4176,6 +4176,9 @@ function ErrorAdditionalItems(stack, context, schemaPath, instancePath, schema,
 		return IsLessThan(index, schema.items.length) || ErrorSchemaPushStack(stack, context, nextSchemaPath, nextInstancePath, schema.additionalItems, item) && context.AddIndex(index);
 	});
 }
+function EncodeFragment(fragment) {
+	return fragment.replace(/~/g, "~0").replace(/\//g, "~1");
+}
 function UnicodeRegExp(pattern) {
 	return new RegExp(pattern, "u");
 }
@@ -4199,7 +4202,7 @@ function ErrorAdditionalProperties(stack, context, schemaPath, instancePath, sch
 	const additionalProperties = [];
 	return EveryAll(Keys(value), 0, (key, _index) => {
 		const nextSchemaPath = `${schemaPath}/additionalProperties`;
-		const nextInstancePath = `${instancePath}/${key}`;
+		const nextInstancePath = `${instancePath}/${EncodeFragment(key)}`;
 		const isAdditionalProperty = regexp.test(key) || ErrorSchemaPushStack(stack, context, nextSchemaPath, nextInstancePath, schema.additionalProperties, value[key]) && context.AddKey(key);
 		if (!isAdditionalProperty) additionalProperties.push(key);
 		return isAdditionalProperty;
@@ -4278,7 +4281,7 @@ function CheckDependencies(stack, context, schema, value) {
 function ErrorDependencies(stack, context, schemaPath, instancePath, schema, value) {
 	const isLength = IsEqual(Keys(value).length, 0);
 	const isEvery = EveryAll(Entries(schema.dependencies), 0, ([key, schema]) => {
-		const nextSchemaPath = `${schemaPath}/dependencies/${key}`;
+		const nextSchemaPath = `${schemaPath}/dependencies/${EncodeFragment(key)}`;
 		return !HasPropertyKey(value, key) || (IsArray$1(schema) ? schema.every((dependency) => HasPropertyKey(value, dependency) || context.AddError("dependencies", schemaPath, instancePath, {
 			property: key,
 			dependencies: schema
@@ -4313,7 +4316,7 @@ function CheckDependentSchemas(stack, context, schema, value) {
 function ErrorDependentSchemas(stack, context, schemaPath, instancePath, schema, value) {
 	const isLength = IsEqual(Keys(value).length, 0);
 	const isEvery = EveryAll(Entries(schema.dependentSchemas), 0, ([key, schema]) => {
-		const nextSchemaPath = `${schemaPath}/dependentSchemas/${key}`;
+		const nextSchemaPath = `${schemaPath}/dependentSchemas/${EncodeFragment(key)}`;
 		return !HasPropertyKey(value, key) || ErrorSchema(stack, context, nextSchemaPath, instancePath, schema, value);
 	});
 	return isLength || isEvery;
@@ -5167,10 +5170,10 @@ function CheckPatternProperties(stack, context, schema, value) {
 }
 function ErrorPatternProperties(stack, context, schemaPath, instancePath, schema, value) {
 	return EveryAll(Entries(schema.patternProperties), 0, ([pattern, schema]) => {
-		const nextSchemaPath = `${schemaPath}/patternProperties/${pattern}`;
+		const nextSchemaPath = `${schemaPath}/patternProperties/${EncodeFragment(pattern)}`;
 		const regexp = UnicodeRegExp(pattern);
 		return EveryAll(Entries(value), 0, ([key, value]) => {
-			const nextInstancePath = `${instancePath}/${key}`;
+			const nextInstancePath = `${instancePath}/${EncodeFragment(key)}`;
 			return !regexp.test(key) || ErrorSchemaPushStack(stack, context, nextSchemaPath, nextInstancePath, schema, value) && context.AddKey(key);
 		});
 	});
@@ -5203,8 +5206,8 @@ function CheckProperties(stack, context, schema, value) {
 function ErrorProperties(stack, context, schemaPath, instancePath, schema, value) {
 	const required = IsRequired(schema) ? schema.required : [];
 	return EveryAll(Entries(schema.properties), 0, ([key, schema]) => {
-		const nextSchemaPath = `${schemaPath}/properties/${key}`;
-		const nextInstancePath = `${instancePath}/${key}`;
+		const nextSchemaPath = `${schemaPath}/properties/${EncodeFragment(key)}`;
+		const nextInstancePath = `${instancePath}/${EncodeFragment(key)}`;
 		const isProperty = () => !HasPropertyKey(value, key) || ErrorSchemaPushStack(stack, context, nextSchemaPath, nextInstancePath, schema, value[key]) && context.AddKey(key);
 		return IsExactOptional(required, key) ? isProperty() : InexactOptionalCheck(value, key) || isProperty();
 	});
@@ -5215,7 +5218,7 @@ function CheckPropertyNames(stack, context, schema, value) {
 function ErrorPropertyNames(stack, context, schemaPath, instancePath, schema, value) {
 	const propertyNames = [];
 	return EveryAll(Keys(value), 0, (key, _index) => {
-		const nextInstancePath = `${instancePath}/${key}`;
+		const nextInstancePath = `${instancePath}/${EncodeFragment(key)}`;
 		const isPropertyName = ErrorSchema(stack, context, `${schemaPath}/propertyNames`, nextInstancePath, schema.propertyNames, key);
 		if (!isPropertyName) propertyNames.push(key);
 		return isPropertyName;
@@ -5431,6 +5434,6 @@ Union([
 		path: String$2()
 	})
 ]);
-export { Check, Errors, typebox_exports };
+export { Check, Errors, IsObject, typebox_exports };
 
 //# sourceMappingURL=typebox.mjs.map