@agntn/harnesses 0.3.0 → 0.4.0

package/dist/_chunks/{prompt-sync.mjs → skills-sync.mjs}

@@ -8,6 +8,7 @@ import os, { homedir } from "node:os";
 import { stripVTControlCharacters } from "node:util";
 import { parse } from "smol-toml";
 import { randomUUID } from "node:crypto";
+//#region src/resolve.ts
 const PATH_MARKERS = /^~(?=\/|$)|\$\{HOME\}|\$\{PROJECT_ROOT\}|\$\{TMPDIR\}|%([^%]+)%/g;
 function resolvePathTemplate(template, options = {}) {
 	const homeDir = options.homeDir ?? os.homedir();
@@ -27,6 +28,8 @@ function agntnDataDir(options = {}) {
 	const base = process.env.XDG_DATA_HOME && process.env.XDG_DATA_HOME !== "" ? process.env.XDG_DATA_HOME : join(options.homeDir ?? os.homedir(), ".local", "share");
 	return join(base, "agntn");
 }
+//#endregion
+//#region src/harness.ts
 function moveRoot(path, root, value) {
 	if (path === root) return value;
 	const rest = path.slice(root.length);
@@ -37,6 +40,7 @@ const SUPPORTED_PLATFORMS = {
 	darwin: true,
 	win32: true
 };
+const PARENT_ENV = "AGNTN_HARNESSES_PARENT";
 const ALTERNATE_INVOCATION_MODE = {
 	advisor: "agent",
 	advisorStructured: "agentStructured",
@@ -249,6 +253,7 @@ function executeCommand(command, args, options) {
 	});
 }
 var Harness = class {
+	skillsSyncTarget = null;
 	promptTemplates = [];
 	promptTemplateSyncTarget = null;
 	temp = [];
@@ -324,6 +329,8 @@ var Harness = class {
 		return `${`Harness ${this.id} has no ${INVOCATION_MODE_DESCRIPTION[mode]} invocation`}${invocationRetryHint(this.invocation, mode, options)}`;
 	}
 	invoke(prompt, options = {}) {
+		const parent = process.env[PARENT_ENV];
+		if (parent) return Promise.reject(/* @__PURE__ */ new Error(`Nested run refused: this process already runs inside ${parent}, started by harnesses. ${this.id} under it would stack agents, and in a read-only sandbox it gets no network and hangs until the deadline. Answer without it`));
 		const invocationOptions = {
 			model: options.model,
 			structured: options.structured,
@@ -334,9 +341,16 @@ var Harness = class {
 		if (!built) return Promise.reject(new Error(this.invocationError(invocationOptions) ?? "Invalid invocation"));
 		const versionError = this.readOnlyVersionError(invocationOptions);
 		if (versionError) return Promise.reject(new Error(versionError));
+		const command = {
+			...options,
+			env: {
+				...options.env,
+				[PARENT_ENV]: this.id
+			}
+		};
 		const streamArgs = options.structured ? void 0 : this.invocation?.streamArgs;
-		if (!streamArgs) return executeCommand(built.command, built.args, options);
-		return executeCommand(built.command, [...built.args, ...streamArgs], options).then((result) => ({
+		if (!streamArgs) return executeCommand(built.command, built.args, command);
+		return executeCommand(built.command, [...built.args, ...streamArgs], command).then((result) => ({
 			...result,
 			stdout: this.foldStreamOutput(result.stdout, !result.timedOut && !result.aborted)
 		}));
@@ -402,6 +416,7 @@ var Harness = class {
 			sessions: this.resolveCandidates(this.sessions, options),
 			instructions: this.resolveCandidates(this.instructions, options),
 			skills: this.resolveCandidates(this.skills, options),
+			skillsSyncTarget: this.skillsSyncTarget === null ? null : this.resolveCandidates([this.skillsSyncTarget], options)[0] ?? null,
 			commands: this.resolveCandidates(this.commands, options),
 			promptTemplates: this.resolveCandidates(this.promptTemplates, options),
 			promptTemplateSyncTarget: this.promptTemplateSyncTarget === null ? null : this.resolveCandidates([this.promptTemplateSyncTarget], options)[0] ?? null,
@@ -420,6 +435,8 @@ var Harness = class {
 		}));
 	}
 };
+//#endregion
+//#region src/harnesses/antigravity.ts
 function parseAntigravityModels(stdout) {
 	const lines = stripVTControlCharacters(stdout).split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
 	if (lines.length === 0) throw new Error("Unexpected empty Antigravity model-list output");
@@ -553,6 +570,11 @@ var Antigravity = class extends Harness {
 		scope: "user",
 		level: "official"
 	}];
+	skillsSyncTarget = {
+		path: "~/.gemini/config/skills/",
+		scope: "user",
+		level: "official"
+	};
 	commands = [];
 	hooks = [{
 		path: ".agents/hooks.json",
@@ -600,6 +622,8 @@ var Antigravity = class extends Harness {
 		return model.id;
 	}
 };
+//#endregion
+//#region src/harnesses/claude.ts
 function parseStreamLine(line) {
 	try {
 		const parsed = JSON.parse(line);
@@ -752,6 +776,11 @@ var Claude = class extends Harness {
 		level: "official",
 		note: "Global user-level skills."
 	}];
+	skillsSyncTarget = {
+		path: "~/.claude/skills/",
+		scope: "user",
+		level: "official"
+	};
 	commands = [{
 		path: ".claude/commands/",
 		scope: "project",
@@ -922,6 +951,8 @@ var Claude = class extends Harness {
 		return foldClaudeStream(stdout, complete);
 	}
 };
+//#endregion
+//#region src/harnesses/codex.ts
 var Codex = class extends Harness {
 	id = "codex";
 	name = "OpenAI Codex CLI";
@@ -1044,6 +1075,11 @@ var Codex = class extends Harness {
 			platforms: ["linux", "darwin"]
 		}
 	];
+	skillsSyncTarget = {
+		path: "~/.agents/skills/",
+		scope: "user",
+		level: "official"
+	};
 	commands = [{
 		path: "~/.codex/prompts/",
 		scope: "user",
@@ -1129,6 +1165,8 @@ var Codex = class extends Harness {
 		]
 	};
 };
+//#endregion
+//#region src/harnesses/cursor.ts
 var Cursor = class extends Harness {
 	id = "cursor";
 	name = "Cursor";
@@ -1188,6 +1226,11 @@ var Cursor = class extends Harness {
 			note: "Cursor natively scans Codex skills directory."
 		}
 	];
+	skillsSyncTarget = {
+		path: "~/.cursor/skills/",
+		scope: "user",
+		level: "official"
+	};
 	commands = [];
 	hooks = [];
 	invocation = {
@@ -1222,6 +1265,8 @@ var Cursor = class extends Harness {
 		projectMarkers: [".cursor", ".cursorrules"]
 	};
 };
+//#endregion
+//#region src/harnesses/freebuff.ts
 var Freebuff = class extends Harness {
 	id = "freebuff";
 	name = "Freebuff";
@@ -1328,6 +1373,8 @@ var Freebuff = class extends Harness {
 		projectMarkers: [".agents", "knowledge.md"]
 	};
 };
+//#endregion
+//#region src/harnesses/gemini.ts
 var Gemini = class extends Harness {
 	id = "gemini";
 	name = "Google Gemini CLI";
@@ -1422,6 +1469,11 @@ var Gemini = class extends Harness {
 			level: "official"
 		}
 	];
+	skillsSyncTarget = {
+		path: "~/.gemini/skills/",
+		scope: "user",
+		level: "official"
+	};
 	commands = [{
 		path: ".gemini/commands/",
 		scope: "project",
@@ -1474,6 +1526,8 @@ var Gemini = class extends Harness {
 		projectMarkers: [".gemini", "GEMINI.md"]
 	};
 };
+//#endregion
+//#region src/harnesses/github-copilot.ts
 var GitHubCopilot = class extends Harness {
 	id = "github-copilot";
 	name = "GitHub Copilot";
@@ -1542,6 +1596,8 @@ var GitHubCopilot = class extends Harness {
 		]
 	};
 };
+//#endregion
+//#region src/harnesses/grok.ts
 function parseGrokModels(stdout) {
 	const lines = stripVTControlCharacters(stdout).split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
 	const start = lines.indexOf("Available models:");
@@ -1641,6 +1697,11 @@ var Grok = class extends Harness {
 		level: "official",
 		note: "Global user-level skills."
 	}];
+	skillsSyncTarget = {
+		path: "~/.grok/skills/",
+		scope: "user",
+		level: "official"
+	};
 	commands = [{
 		path: ".grok/commands/",
 		scope: "project",
@@ -1721,6 +1782,8 @@ var Grok = class extends Harness {
 		return parseGrokModels(stdout);
 	}
 };
+//#endregion
+//#region src/harnesses/mastracode.ts
 function packageVersion(commandPath) {
 	try {
 		const require = createRequire(realpathSync(commandPath));
@@ -1876,6 +1939,11 @@ var MastraCode = class extends Harness {
 			note: "Claude Code compatible."
 		}
 	];
+	skillsSyncTarget = {
+		path: "~/.mastracode/skills/",
+		scope: "user",
+		level: "official"
+	};
 	commands = [
 		{
 			path: ".mastracode/commands/",
@@ -1966,6 +2034,32 @@ var MastraCode = class extends Harness {
 		projectMarkers: [".mastracode"]
 	};
 };
+//#endregion
+//#region src/harnesses/omp.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseOmpModels(stdout) {
+	let parsed;
+	try {
+		parsed = JSON.parse(stdout);
+	} catch {
+		throw new Error(`Unexpected OMP model-list output: ${JSON.stringify(stdout.slice(0, 200))}`);
+	}
+	if (!isRecord(parsed) || !Array.isArray(parsed["models"])) throw new Error(`Unexpected OMP model-list output: ${JSON.stringify(stdout.slice(0, 200))}`);
+	return parsed["models"].map((entry) => {
+		if (!isRecord(entry) || typeof entry["provider"] !== "string" || typeof entry["id"] !== "string") throw new Error(`Unexpected OMP model-list entry: ${JSON.stringify(entry)}`);
+		const { contextWindow, maxTokens, reasoning, input } = entry;
+		return {
+			provider: entry["provider"],
+			id: entry["id"],
+			...typeof contextWindow === "number" ? { contextWindow } : {},
+			...typeof maxTokens === "number" ? { maxOutputTokens: maxTokens } : {},
+			...typeof reasoning === "boolean" ? { thinking: reasoning } : {},
+			...Array.isArray(input) ? { images: input.includes("image") } : {}
+		};
+	});
+}
 var Omp = class extends Harness {
 	id = "omp";
 	name = "OMP (oh-my-pi)";
@@ -2105,6 +2199,11 @@ var Omp = class extends Harness {
 			note: "Auto-generated managed skills."
 		}
 	];
+	skillsSyncTarget = {
+		path: "~/.omp/agent/skills/",
+		scope: "user",
+		level: "official"
+	};
 	commands = [{
 		path: ".omp/commands/",
 		scope: "project",
@@ -2150,6 +2249,27 @@ var Omp = class extends Harness {
 		level: "official",
 		note: "Add --mode json for structured event output. --no-tools disables only OMP's bundled tools, so it cannot provide an advisor mode without tools."
 	};
+	modelListing = {
+		args: [
+			"models",
+			"--json",
+			"--kind",
+			"chat",
+			"--no-extensions"
+		],
+		searchArgs: [
+			"models",
+			"find",
+			"--json",
+			"--kind",
+			"chat",
+			"--no-extensions",
+			"--",
+			"{search}"
+		],
+		level: "official",
+		note: "Lists chat models with configured provider authentication as JSON; find matches a substring of the provider, id or name, ignoring case. --no-extensions keeps extension load errors out of the run; verified with 18.4.10."
+	};
 	mcpConfigs = [{
 		path: "~/.omp/agent/mcp.json",
 		scope: "user",
@@ -2185,7 +2305,12 @@ var Omp = class extends Harness {
 		envVars: ["OMP_PROFILE", "PI_CODING_AGENT_DIR"],
 		projectMarkers: [".omp"]
 	};
+	parseModelListingOutput(stdout) {
+		return parseOmpModels(stdout);
+	}
 };
+//#endregion
+//#region src/harnesses/opencode.ts
 var OpenCode = class extends Harness {
 	id = "opencode";
 	name = "OpenCode CLI";
@@ -2282,6 +2407,11 @@ var OpenCode = class extends Harness {
 			scope: "project",
 			level: "official"
 		},
+		{
+			path: "~/.config/opencode/skills/",
+			scope: "user",
+			level: "official"
+		},
 		{
 			path: "~/.claude/skills/",
 			scope: "user",
@@ -2294,6 +2424,12 @@ var OpenCode = class extends Harness {
 			level: "official"
 		}
 	];
+	skillsSyncTarget = {
+		path: "~/.config/opencode/skills/",
+		scope: "user",
+		level: "official",
+		note: "OpenCode also scans ~/.claude/skills/ and ~/.agents/skills/; skill names must be unique across them."
+	};
 	commands = [{
 		path: ".opencode/commands/",
 		scope: "project",
@@ -2349,6 +2485,8 @@ var OpenCode = class extends Harness {
 		]
 	};
 };
+//#endregion
+//#region src/harnesses/pi.ts
 const MODEL_HEADERS = [
 	"provider",
 	"model",
@@ -2461,6 +2599,11 @@ var Pi = class extends Harness {
 		level: "official",
 		note: "Global user-level skills."
 	}];
+	skillsSyncTarget = {
+		path: "~/.pi/agent/skills/",
+		scope: "user",
+		level: "official"
+	};
 	commands = [{
 		path: ".pi/prompts/",
 		scope: "project",
@@ -2524,6 +2667,23 @@ var Pi = class extends Harness {
 		level: "official",
 		note: "Lists models with configured provider authentication; accepts an optional fuzzy search."
 	};
+	mcpConfigs = [{
+		path: "~/.pi/agent/mcp.json",
+		scope: "user",
+		level: "official",
+		format: "json",
+		key: ["mcpServers"],
+		dialect: "pi",
+		note: "Read by the built-in MCP extension, which -builtin:mcp in the extensions setting turns off."
+	}, {
+		path: ".pi/mcp.json",
+		scope: "project",
+		level: "official",
+		format: "json",
+		key: ["mcpServers"],
+		dialect: "pi",
+		note: "Read only after the project is trusted."
+	}];
 	envOverrides = [{
 		variable: "PI_CODING_AGENT_DIR",
 		path: "~/.pi/agent",
@@ -2559,6 +2719,8 @@ var Pi = class extends Harness {
 		return parsePiModelTable(stdout, "Pi");
 	}
 };
+//#endregion
+//#region src/harnesses/prime-agent.ts
 var PrimeAgent = class extends Harness {
 	id = "prime-agent";
 	name = "Prime Agent";
@@ -2660,6 +2822,11 @@ var PrimeAgent = class extends Harness {
 			note: "Shared skills directory; root .md files are ignored there."
 		}
 	];
+	skillsSyncTarget = {
+		path: "~/.prime/agent/skills/",
+		scope: "user",
+		level: "official"
+	};
 	commands = [{
 		path: ".prime/agent/prompts/",
 		scope: "project",
@@ -2731,6 +2898,8 @@ var PrimeAgent = class extends Harness {
 		return parsePiModelTable(stdout, "Prime Agent");
 	}
 };
+//#endregion
+//#region src/harnesses/index.ts
 const harnesses = [
 	Antigravity,
 	Claude,
@@ -2746,6 +2915,8 @@ const harnesses = [
 	PrimeAgent,
 	Pi
 ];
+//#endregion
+//#region src/registry.ts
 let registry;
 function getRegistry() {
 	if (!registry) {
@@ -2793,6 +2964,8 @@ function detectHarness(cwd) {
 	}
 	return match;
 }
+//#endregion
+//#region src/mcp-servers.ts
 function resolveConfigs(harness, options) {
 	return harness.resolveCandidates(harness.mcpConfigs, options).map((entry) => ({
 		entry,
@@ -2891,6 +3064,9 @@ const ENV_REFERENCE = /^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$/;
 var McpEnvError = class extends Error {
 	name = "McpEnvError";
 };
+var McpTransportError = class extends Error {
+	name = "McpTransportError";
+};
 function envReference(value) {
 	return ENV_REFERENCE.exec(value)?.[1];
 }
@@ -3006,6 +3182,7 @@ function resolveEnvReferences(server, dialect) {
 }
 function shapeForDialect(server, dialect) {
 	const shaped = resolveEnvReferences(server, dialect);
+	if (dialect === "pi" && shaped.transport === "sse") throw new McpTransportError(`${server.name}: Pi takes stdio and streamable HTTP servers, not sse; point url at the server's streamable HTTP endpoint`);
 	if (dialect !== "mastracode") return shaped;
 	return compact({
 		...shaped,
@@ -3020,6 +3197,26 @@ function denormalizeEntry(server, dialect) {
 	if (dialect === "prime") return denormalizePrime(server);
 	return denormalizeStandard(server);
 }
+const STANDARD_FIELDS = /* @__PURE__ */ new Set([
+	"type",
+	"command",
+	"args",
+	"env",
+	"url",
+	"httpUrl",
+	"headers",
+	"enabled"
+]);
+function replacementEntry(previous, server, dialect) {
+	const entry = denormalizeEntry(server, dialect);
+	if (dialect !== "pi" || !isObjectRecord(previous)) return entry;
+	if (normalizeStandard(server.name, previous).transport !== server.transport) return entry;
+	const kept = Object.entries(previous).filter(([key]) => !STANDARD_FIELDS.has(key));
+	return {
+		...entry,
+		...Object.fromEntries(kept)
+	};
+}
 function listingBase(entry, path) {
 	return compact({
 		path,
@@ -3160,7 +3357,7 @@ function addMcpServer(harness, server, scope = "user", options = {}) {
 	const map = drill(root, entry.key, "create");
 	if (!map) throw new Error(`Config at ${path} has a non-object at ${entry.key.join(".")}`);
 	const replaced = Object.hasOwn(map, server.name);
-	map[server.name] = denormalizeEntry(resolved, entry.dialect);
+	map[server.name] = replacementEntry(map[server.name], resolved, entry.dialect);
 	writeAtomically(path, `${JSON.stringify(root, null, 2)}\n`);
 	return {
 		path,
@@ -3366,6 +3563,9 @@ function withdrawMasterServersFromExcludedHarness(harness, existing, masterNames
 		results
 	};
 }
+function cannotHold(error) {
+	return error instanceof McpEnvError || error instanceof McpTransportError;
+}
 function syncIncludedHarness(harness, master, existing, masterNames, initialPath, options) {
 	const results = [];
 	let path = initialPath;
@@ -3386,7 +3586,7 @@ function syncIncludedHarness(harness, master, existing, masterNames, initialPath
 			action: written.replaced ? "replaced" : "added"
 		});
 	} catch (error) {
-		if (!(error instanceof McpEnvError)) throw error;
+		if (!cannotHold(error)) throw error;
 		results.push({
 			name: server.name,
 			action: "skipped",
@@ -3436,6 +3636,8 @@ function syncMcpServers(harnesses, options = {}) {
 		targets: harnesses.map((harness) => syncMcpTarget(harness, master, masterNames, options))
 	};
 }
+//#endregion
+//#region src/agents-sync.ts
 function readIfExists(path) {
 	try {
 		return readFileSync(path, "utf8");
@@ -3583,7 +3785,7 @@ function syncFileTarget(id, path, source, check, options) {
 	};
 	return applyFileTarget(id, path, source, state, options);
 }
-function syncTarget$1(harness, config, check, options) {
+function syncTarget$2(harness, config, check, options) {
 	if (config.excludes.includes(harness.id)) return {
 		id: harness.id,
 		action: "skipped",
@@ -3634,9 +3836,134 @@ function syncAgentsFiles(harnesses, check = false, options = {}) {
 	return {
 		source: config.source,
 		check,
-		targets: harnesses.map((harness) => syncTarget$1(harness, config, check, options))
+		targets: harnesses.map((harness) => syncTarget$2(harness, config, check, options))
 	};
 }
+//#endregion
+//#region src/directory-link.ts
+const CHECK_DETAIL = "check mode: not applied";
+function linkTarget(path) {
+	const target = readlinkSync(path);
+	return isAbsolute(target) ? target : resolve(dirname(path), target);
+}
+function isInsideDirectory(path, directory) {
+	const remainder = relative(directory, path);
+	return remainder !== "" && !remainder.startsWith("..") && !isAbsolute(remainder);
+}
+function tempPath(path, kind) {
+	return join(dirname(path), `.${basename(path)}-${randomUUID()}.${kind}.tmp`);
+}
+function realDirectory(path) {
+	try {
+		return realpathSync(path);
+	} catch {
+		return resolve(path);
+	}
+}
+function backupDestination(kind, id, path, options) {
+	const backupDir = join(agntnDataDir(options), "diverged", kind, id);
+	mkdirSync(backupDir, { recursive: true });
+	const backup = join(backupDir, `${basename(path)}-${Date.now()}-${randomUUID()}`);
+	if (lstatSync(path).isSymbolicLink()) {
+		symlinkSync(linkTarget(path), backup);
+		unlinkSync(path);
+		return backup;
+	}
+	moveFile(path, backup);
+	return backup;
+}
+function linkDirectory(path, source, kind) {
+	mkdirSync(dirname(path), { recursive: true });
+	const temp = tempPath(path, `${kind}-link`);
+	symlinkSync(source, temp, "junction");
+	renameSync(temp, path);
+}
+const DIRECTORY_ACTION = {
+	missing: "linked",
+	"correct-link": "unchanged",
+	"wrong-link": "relinked",
+	"legacy-links": "relinked",
+	"local-files": "adopted",
+	"not-directory": "skipped",
+	source: "skipped"
+};
+const SKIP_DETAIL = {
+	"not-directory": "destination exists and is not a directory or symlink",
+	source: "destination holds the source directory"
+};
+function isEntryLink(path, sourceDirs) {
+	if (!lstatSync(path).isSymbolicLink()) return false;
+	const target = linkTarget(path);
+	return sourceDirs.some((directory) => isInsideDirectory(target, directory));
+}
+function linksThrough(sourceDir, targetDir) {
+	let path = sourceDir;
+	for (let hop = 0; hop < 32; hop++) {
+		if (path === targetDir || isInsideDirectory(path, targetDir)) return true;
+		try {
+			if (!lstatSync(path).isSymbolicLink()) return false;
+		} catch {
+			return false;
+		}
+		path = linkTarget(path);
+	}
+	return false;
+}
+function inspectDirectory(targetDir, sourceDir) {
+	let stats;
+	try {
+		stats = lstatSync(targetDir);
+	} catch (error) {
+		if (error.code === "ENOENT") return { kind: "missing" };
+		throw error;
+	}
+	if (stats.isSymbolicLink()) {
+		if (linkTarget(targetDir) === sourceDir) return { kind: "correct-link" };
+		return { kind: linksThrough(sourceDir, targetDir) ? "source" : "wrong-link" };
+	}
+	if (!stats.isDirectory()) return { kind: "not-directory" };
+	return inspectLocalDirectory(targetDir, sourceDir);
+}
+function inspectLocalDirectory(targetDir, sourceDir) {
+	const realSource = realDirectory(sourceDir);
+	const realTarget = realpathSync(targetDir);
+	if (realSource === realTarget || isInsideDirectory(realSource, realTarget)) return { kind: "source" };
+	const sourceDirs = realSource === sourceDir ? [sourceDir] : [sourceDir, realSource];
+	const entries = readdirSync(targetDir).map((entry) => join(targetDir, entry));
+	return entries.every((entry) => isEntryLink(entry, sourceDirs)) ? {
+		kind: "legacy-links",
+		entries
+	} : { kind: "local-files" };
+}
+function clearDirectory(kind, id, targetDir, state, options) {
+	if (state.kind === "wrong-link" || state.kind === "local-files") return backupDestination(kind, id, targetDir, options);
+	if (state.kind === "legacy-links") {
+		for (const entry of state.entries) unlinkSync(entry);
+		rmdirSync(targetDir);
+	}
+}
+function syncDirectoryLink(kind, id, targetDir, sourceDir, check, options) {
+	const state = inspectDirectory(targetDir, sourceDir);
+	const action = DIRECTORY_ACTION[state.kind];
+	if (state.kind === "correct-link") return { action };
+	const skip = SKIP_DETAIL[state.kind];
+	if (skip !== void 0) return {
+		action,
+		detail: skip
+	};
+	if (check) return {
+		action,
+		detail: CHECK_DETAIL
+	};
+	const detail = clearDirectory(kind, id, targetDir, state, options);
+	linkDirectory(targetDir, sourceDir, kind);
+	return {
+		action,
+		detail
+	};
+}
+//#endregion
+//#region src/prompt-sync.ts
 const GENERATED_MARKER = "# Generated by @agntn/harnesses from ";
 const PORTABLE_PROMPT_NAME = /^[A-Za-z0-9][A-Za-z0-9_-]*$/u;
 const GEMINI_ACTION = {
@@ -3684,10 +4011,6 @@ function generatedSource(content) {
 		return null;
 	}
 }
-function linkTarget(path) {
-	const target = readlinkSync(path);
-	return isAbsolute(target) ? target : resolve(dirname(path), target);
-}
 function inspectDestination(path) {
 	let stats;
 	try {
@@ -3705,93 +4028,12 @@ function inspectDestination(path) {
 	};
 	return { kind: "unmanaged-file" };
 }
-function tempPath(path, kind) {
-	return join(dirname(path), `.${basename(path)}-${randomUUID()}.${kind}.tmp`);
-}
-function linkDirectory(path, source) {
-	mkdirSync(dirname(path), { recursive: true });
-	const temp = tempPath(path, "prompt-link");
-	symlinkSync(source, temp, "junction");
-	renameSync(temp, path);
-}
 function writeTemplate(path, content) {
 	mkdirSync(dirname(path), { recursive: true });
 	const temp = tempPath(path, "prompt-write");
 	writeFileSync(temp, content);
 	renameSync(temp, path);
 }
-function backupDestination(id, path, options) {
-	const backupDir = join(agntnDataDir(options), "diverged", "prompts", id);
-	mkdirSync(backupDir, { recursive: true });
-	const backup = join(backupDir, `${basename(path)}-${Date.now()}-${randomUUID()}`);
-	if (lstatSync(path).isSymbolicLink()) {
-		symlinkSync(linkTarget(path), backup);
-		unlinkSync(path);
-		return backup;
-	}
-	moveFile(path, backup);
-	return backup;
-}
-function checkDetail() {
-	return "check mode: not applied";
-}
-function isInsideDirectory(path, directory) {
-	const remainder = relative(directory, path);
-	return remainder !== "" && !remainder.startsWith("..") && !isAbsolute(remainder);
-}
-function isLegacyTemplateLink(path, sourceDir) {
-	return lstatSync(path).isSymbolicLink() && isInsideDirectory(linkTarget(path), sourceDir);
-}
-const DIRECTORY_ACTION = {
-	missing: "linked",
-	"correct-link": "unchanged",
-	"wrong-link": "relinked",
-	"legacy-links": "relinked",
-	"local-files": "adopted",
-	"not-directory": "skipped"
-};
-function inspectDirectory(targetDir, sourceDir) {
-	let stats;
-	try {
-		stats = lstatSync(targetDir);
-	} catch (error) {
-		if (error.code === "ENOENT") return { kind: "missing" };
-		throw error;
-	}
-	if (stats.isSymbolicLink()) return { kind: linkTarget(targetDir) === sourceDir ? "correct-link" : "wrong-link" };
-	if (!stats.isDirectory()) return { kind: "not-directory" };
-	const entries = readdirSync(targetDir).map((entry) => join(targetDir, entry));
-	return entries.every((entry) => isLegacyTemplateLink(entry, sourceDir)) ? {
-		kind: "legacy-links",
-		entries
-	} : { kind: "local-files" };
-}
-function clearDirectory(id, targetDir, state, options) {
-	if (state.kind === "wrong-link" || state.kind === "local-files") return backupDestination(id, targetDir, options);
-	if (state.kind === "legacy-links") {
-		for (const entry of state.entries) unlinkSync(entry);
-		rmdirSync(targetDir);
-	}
-}
-function syncMarkdownDirectory(id, targetDir, sourceDir, check, options) {
-	const state = inspectDirectory(targetDir, sourceDir);
-	const action = DIRECTORY_ACTION[state.kind];
-	if (state.kind === "correct-link") return { action };
-	if (state.kind === "not-directory") return {
-		action,
-		detail: "destination exists and is not a directory or symlink"
-	};
-	if (check) return {
-		action,
-		detail: checkDetail()
-	};
-	const detail = clearDirectory(id, targetDir, state, options);
-	linkDirectory(targetDir, sourceDir);
-	return {
-		action,
-		detail
-	};
-}
 function parseYaml(raw) {
 	return createRequire(import.meta.url)("yaml").parse(raw);
 }
@@ -3844,10 +4086,10 @@ function syncGeminiTemplate(id, targetDir, template, check, options) {
 		source: template.path,
 		path,
 		action,
-		detail: checkDetail()
+		detail: CHECK_DETAIL
 	};
 	let detail;
-	if (GEMINI_BACKUP[state.kind]) detail = backupDestination(id, path, options);
+	if (GEMINI_BACKUP[state.kind]) detail = backupDestination("prompts", id, path, options);
 	writeTemplate(path, content);
 	return {
 		name: template.name,
@@ -3885,7 +4127,7 @@ function pruneGeminiTarget(id, targetDir, sourceDir, activeNames, check, options
 			...source === null ? {} : { source },
 			path,
 			action: "removed",
-			detail: checkDetail()
+			detail: CHECK_DETAIL
 		};
 		if (source !== null) {
 			unlinkSync(path);
@@ -3900,11 +4142,11 @@ function pruneGeminiTarget(id, targetDir, sourceDir, activeNames, check, options
 			name,
 			path,
 			action: "removed",
-			detail: backupDestination(id, path, options)
+			detail: backupDestination("prompts", id, path, options)
 		};
 	});
 }
-function syncTarget(harness, templates, sourceDir, check, options) {
+function syncTarget$1(harness, templates, sourceDir, check, options) {
 	const target = harness.promptTemplateSyncTarget;
 	if (target === null) return {
 		id: harness.id,
@@ -3922,7 +4164,7 @@ function syncTarget(harness, templates, sourceDir, check, options) {
 		id: harness.id,
 		path: targetDir,
 		format: resolved.format,
-		...syncMarkdownDirectory(harness.id, targetDir, sourceDir, check, options),
+		...syncDirectoryLink("prompts", harness.id, targetDir, sourceDir, check, options),
 		templates: []
 	};
 	const results = templates.map((template) => syncGeminiTemplate(harness.id, targetDir, template, check, options));
@@ -3946,9 +4188,59 @@ function syncPromptTemplates(harnesses, check = false, options = {}) {
 		source,
 		check,
 		templates: prepared.map((template) => template.name),
-		targets: harnesses.map((harness) => syncTarget(harness, prepared, source, check, options))
+		targets: harnesses.map((harness) => syncTarget$1(harness, prepared, source, check, options))
+	};
+}
+//#endregion
+//#region src/skills-sync.ts
+function readSkills(sourceDir, check) {
+	let entries;
+	try {
+		entries = readdirSync(sourceDir);
+	} catch (error) {
+		if (error.code !== "ENOENT") throw error;
+		if (!check) mkdirSync(sourceDir, { recursive: true });
+		return [];
+	}
+	return entries.filter((entry) => {
+		const path = join(sourceDir, entry);
+		try {
+			return statSync(path).isDirectory() && existsSync(join(path, "SKILL.md"));
+		} catch {
+			return false;
+		}
+	}).sort((left, right) => left.localeCompare(right));
+}
+function syncTarget(harness, sourceDir, check, options) {
+	const target = harness.skillsSyncTarget;
+	if (target === null) return {
+		id: harness.id,
+		action: "skipped",
+		detail: "no stable user-scope skills directory"
+	};
+	const resolved = harness.resolveCandidates([target], options)[0];
+	if (resolved === void 0) return {
+		id: harness.id,
+		action: "skipped",
+		detail: "skills directory is unavailable on this platform"
+	};
+	const targetDir = resolve(resolved.path);
+	return {
+		id: harness.id,
+		path: targetDir,
+		...syncDirectoryLink("skills", harness.id, targetDir, sourceDir, check, options)
+	};
+}
+function syncSkills(harnesses, check = false, options = {}) {
+	const source = join(agntnDataDir(options), "skills");
+	return {
+		source,
+		check,
+		skills: readSkills(source, check),
+		targets: harnesses.map((harness) => syncTarget(harness, source, check, options))
 	};
 }
-export { Harness, McpEnvError, addMcpServer, agntnConfigDir, agntnDataDir, detectHarness, detectHarnessFromEnv, detectProjectHarnesses, getAllHarnesses, getHarness, isHarnessId, listHarnesses, listMcpServers, masterMcpPath, parseJsonc, readAgentsConfig, readMasterMcpServers, registerHarness, removeMcpServer, resolvePathTemplate, syncAgentsFiles, syncMcpServers, syncPromptTemplates };
+//#endregion
+export { agntnConfigDir as C, Harness as S, resolvePathTemplate as T, getAllHarnesses as _, McpEnvError as a, listHarnesses as b, listMcpServers as c, readMasterMcpServers as d, removeMcpServer as f, detectProjectHarnesses as g, detectHarnessFromEnv as h, syncAgentsFiles as i, masterMcpPath as l, detectHarness as m, syncPromptTemplates as n, McpTransportError as o, syncMcpServers as p, readAgentsConfig as r, addMcpServer as s, syncSkills as t, parseJsonc as u, getHarness as v, agntnDataDir as w, registerHarness as x, isHarnessId as y };
 
-//# sourceMappingURL=prompt-sync.mjs.map
+//# sourceMappingURL=skills-sync.mjs.map