@agntn/harnesses 0.1.0 → 0.2.0

package/dist/_chunks/agents-sync.mjs

@@ -1,5 +1,6 @@
+import { createRequire } from "node:module";
 import { addAbortListener } from "node:events";
-import { existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, renameSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, realpathSync, renameSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
 import { execFile, execFileSync, spawn } from "node:child_process";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
 import { basename, dirname, isAbsolute, join, posix, resolve, win32 } from "node:path";
@@ -963,6 +964,18 @@ var Freebuff = class extends Harness {
 	id = "freebuff";
 	name = "Freebuff";
 	binaries = ["freebuff"];
+	get version() {
+		const configDir = join(homedir(), ".config", "manicode");
+		const binaryName = process.platform === "win32" ? "freebuff.exe" : "freebuff";
+		if (!existsSync(join(configDir, binaryName))) return null;
+		try {
+			const metadata = JSON.parse(readFileSync(join(configDir, "freebuff-metadata.json"), "utf8"));
+			if (typeof metadata === "object" && metadata !== null && "version" in metadata && typeof metadata.version === "string" && metadata.version !== "") return metadata.version;
+		} catch {
+			return null;
+		}
+		return null;
+	}
 	capabilities = {
 		mcp: true,
 		vision: true,
@@ -1417,10 +1430,43 @@ var Grok = class extends Harness {
 		projectMarkers: [".grok"]
 	};
 };
+function packageVersion(commandPath) {
+	try {
+		const require = createRequire(realpathSync(commandPath));
+		const metadata = JSON.parse(readFileSync(require.resolve("mastracode/package.json"), "utf8"));
+		if (typeof metadata === "object" && metadata !== null && "version" in metadata && typeof metadata.version === "string" && metadata.version !== "") return metadata.version;
+	} catch {
+		return null;
+	}
+	return null;
+}
 var MastraCode = class extends Harness {
 	id = "mastracode";
 	name = "Mastra Code";
 	binaries = ["mastracode"];
+	get version() {
+		const locator = process.platform === "win32" ? "where" : "which";
+		let output;
+		try {
+			output = execFileSync(locator, [this.binaries[0] ?? "mastracode"], {
+				encoding: "utf8",
+				stdio: [
+					"pipe",
+					"pipe",
+					"pipe"
+				],
+				timeout: 5e3
+			});
+		} catch {
+			return null;
+		}
+		const paths = output.split(/\r?\n/u).filter((path) => path !== "");
+		for (const path of paths) {
+			const version = packageVersion(path);
+			if (version !== null) return version;
+		}
+		return null;
+	}
 	capabilities = {
 		mcp: true,
 		vision: true,
@@ -1896,16 +1942,37 @@ const MODEL_HEADERS = [
 	"thinking",
 	"images"
 ];
-function parseTokenCount(value) {
+function parseTokenCount(value, harness) {
 	const match = /^(\d+(?:\.\d+)?)([KM])?$/.exec(value);
-	if (!match?.[1]) throw new Error(`Invalid Pi token count: ${JSON.stringify(value)}`);
+	if (!match?.[1]) throw new Error(`Invalid ${harness} token count: ${JSON.stringify(value)}`);
 	const multiplier = match[2] === "M" ? 1e6 : match[2] === "K" ? 1e3 : 1;
 	return Number(match[1]) * multiplier;
 }
-function parseBoolean(value, column) {
+function parseBoolean(value, column, harness) {
 	if (value === "yes") return true;
 	if (value === "no") return false;
-	throw new Error(`Invalid Pi ${column} value: ${JSON.stringify(value)}`);
+	throw new Error(`Invalid ${harness} ${column} value: ${JSON.stringify(value)}`);
+}
+function parsePiModelTable(stdout, harness) {
+	const lines = stripVTControlCharacters(stdout).split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+	const first = lines[0];
+	if (!first) throw new Error(`Unexpected empty ${harness} model-list output`);
+	if (first.startsWith("No models available.") || first.startsWith("No models matching ")) return [];
+	const headers = first.split(/\s{2,}/);
+	if (headers.length !== MODEL_HEADERS.length || headers.some((value, i) => value !== MODEL_HEADERS[i])) throw new Error(`Unexpected ${harness} model-list header: ${JSON.stringify(first)}`);
+	return lines.slice(1).map((line) => {
+		const columns = line.split(/\s{2,}/);
+		const [provider, id, context, maxOutput, thinking, images] = columns;
+		if (columns.length !== MODEL_HEADERS.length || !provider || !id || !context || !maxOutput || !thinking || !images) throw new Error(`Unexpected ${harness} model-list row: ${JSON.stringify(line)}`);
+		return {
+			provider,
+			id,
+			contextWindow: parseTokenCount(context, harness),
+			maxOutputTokens: parseTokenCount(maxOutput, harness),
+			thinking: parseBoolean(thinking, "thinking", harness),
+			images: parseBoolean(images, "images", harness)
+		};
+	});
 }
 var Pi = class extends Harness {
 	id = "pi";
@@ -2046,25 +2113,172 @@ var Pi = class extends Harness {
 		projectMarkers: [".pi"]
 	};
 	parseModelListingOutput(stdout) {
-		const lines = stripVTControlCharacters(stdout).split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
-		const first = lines[0];
-		if (!first) throw new Error("Unexpected empty Pi model-list output");
-		if (first.startsWith("No models available.") || first.startsWith("No models matching ")) return [];
-		const headers = first.split(/\s{2,}/);
-		if (headers.length !== MODEL_HEADERS.length || headers.some((value, i) => value !== MODEL_HEADERS[i])) throw new Error(`Unexpected Pi model-list header: ${JSON.stringify(first)}`);
-		return lines.slice(1).map((line) => {
-			const columns = line.split(/\s{2,}/);
-			const [provider, id, context, maxOutput, thinking, images] = columns;
-			if (columns.length !== MODEL_HEADERS.length || !provider || !id || !context || !maxOutput || !thinking || !images) throw new Error(`Unexpected Pi model-list row: ${JSON.stringify(line)}`);
-			return {
-				provider,
-				id,
-				contextWindow: parseTokenCount(context),
-				maxOutputTokens: parseTokenCount(maxOutput),
-				thinking: parseBoolean(thinking, "thinking"),
-				images: parseBoolean(images, "images")
-			};
-		});
+		return parsePiModelTable(stdout, "Pi");
+	}
+};
+var PrimeAgent = class extends Harness {
+	id = "prime-agent";
+	name = "Prime Agent";
+	binaries = ["prime-agent"];
+	capabilities = {
+		mcp: true,
+		vision: true,
+		audio: false,
+		video: false,
+		tools: true,
+		streaming: true
+	};
+	config = [{
+		path: "~/.prime/agent/settings.json",
+		scope: "user",
+		level: "official",
+		note: "Config dir overridable with PRIME_AGENT_CODING_AGENT_DIR."
+	}, {
+		path: ".prime/agent/settings.json",
+		scope: "project",
+		level: "official"
+	}];
+	sessions = [{
+		path: "~/.prime/agent/sessions/<session-id>.jsonl",
+		scope: "data",
+		level: "official",
+		note: "Flat directory of JSONL transcripts whose header records the working directory; session ids are UUIDv7. Overridable with PRIME_AGENT_SESSION_DIR or --session-dir."
+	}, {
+		path: "~/.prime/agent/session-artifacts/<session-id>/",
+		scope: "data",
+		level: "official",
+		note: "Per-session Python kernel state, scheduled jobs, harness state and child session transcripts under sub-<id>/."
+	}];
+	persistence = [
+		{
+			format: "JSON",
+			level: "official",
+			note: "Settings, auth, telemetry, model cache and session artifact state files."
+		},
+		{
+			format: "JSONL",
+			level: "official",
+			note: "Session transcripts, the RLM spawn ledger and structured logs."
+		},
+		{
+			format: "dill",
+			level: "official",
+			note: "Pickled Python REPL state (kernel-state.dill) in session artifacts."
+		}
+	];
+	instructions = [
+		{
+			path: "AGENTS.md",
+			scope: "project",
+			level: "official",
+			note: "Loaded from parent directories and cwd; CLAUDE.md accepted as an alternative."
+		},
+		{
+			path: ".prime/agent/SYSTEM.md",
+			scope: "project",
+			level: "official",
+			note: "Replaces the default system prompt; APPEND_SYSTEM.md appends instead."
+		},
+		{
+			path: "~/.prime/agent/AGENTS.md",
+			scope: "user",
+			level: "official",
+			note: "Global user-level instructions; CLAUDE.md accepted as an alternative."
+		},
+		{
+			path: "~/.prime/agent/SYSTEM.md",
+			scope: "user",
+			level: "official",
+			note: "Global system prompt replacement; APPEND_SYSTEM.md appends instead."
+		}
+	];
+	skills = [
+		{
+			path: ".prime/agent/skills/",
+			scope: "project",
+			level: "official"
+		},
+		{
+			path: ".agents/skills/",
+			scope: "project",
+			level: "official",
+			note: "Also scanned in ancestor directories up to the Git repository root; root .md files are ignored there."
+		},
+		{
+			path: "~/.prime/agent/skills/",
+			scope: "user",
+			level: "official",
+			note: "Global user-level skills."
+		},
+		{
+			path: "~/.agents/skills/",
+			scope: "user",
+			level: "official",
+			note: "Shared skills directory; root .md files are ignored there."
+		}
+	];
+	commands = [{
+		path: ".prime/agent/prompts/",
+		scope: "project",
+		level: "official",
+		note: "Prompt templates invoked as slash commands."
+	}, {
+		path: "~/.prime/agent/prompts/",
+		scope: "user",
+		level: "official",
+		note: "Global user-level prompt templates."
+	}];
+	hooks = [];
+	invocation = {
+		args: ["-p", "{prompt}"],
+		jsonArgs: [
+			"-p",
+			"--mode",
+			"json",
+			"{prompt}"
+		],
+		noToolsArgs: [
+			"-p",
+			"--no-tools",
+			"{prompt}"
+		],
+		noToolsJsonArgs: [
+			"-p",
+			"--no-tools",
+			"--mode",
+			"json",
+			"{prompt}"
+		],
+		modelArgs: ["--model", "{model}"],
+		level: "official",
+		note: "Add --mode json for structured event output. No read-only mode: the only built-in tool is a Python REPL and the worker and kernel processes are not a security sandbox."
+	};
+	modelListing = {
+		args: ["model", "list"],
+		searchArgs: [
+			"model",
+			"list",
+			"{search}"
+		],
+		level: "official",
+		note: "Lists models with configured provider authentication; accepts an optional fuzzy search. --list-models was removed."
+	};
+	mcpConfigs = [{
+		path: "~/.prime/agent/settings.json",
+		scope: "user",
+		level: "official",
+		format: "json",
+		key: ["mcpServers"],
+		dialect: "prime",
+		note: "prime-agent mcp add/remove manage this map; project settings entries are ignored for execution. Stdio env values are {\"env\": \"NAME\"} references, written from \"${NAME}\" values; literals are refused because the kernel rejects them at connect time."
+	}];
+	agentsFile = "~/.prime/agent/AGENTS.md";
+	detection = {
+		envVars: ["PRIME_AGENT_KERNEL_OWNER_PID"],
+		projectMarkers: [".prime/agent"]
+	};
+	parseModelListingOutput(stdout) {
+		return parsePiModelTable(stdout, "Prime Agent");
 	}
 };
 const harnesses = [
@@ -2079,6 +2293,7 @@ const harnesses = [
 	MastraCode,
 	Omp,
 	OpenCode,
+	PrimeAgent,
 	Pi
 ];
 let registry;
@@ -2222,9 +2437,30 @@ function normalizeStandard(name, raw) {
 		enabled: booleanField(raw, "enabled")
 	});
 }
+const ENV_REFERENCE = /^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$/;
+var McpEnvError = class extends Error {
+	name = "McpEnvError";
+};
+function envReference(value) {
+	return ENV_REFERENCE.exec(value)?.[1];
+}
+function primeEnv(value) {
+	if (!isObjectRecord(value) || Array.isArray(value)) return void 0;
+	const out = {};
+	for (const [key, raw] of Object.entries(value)) if (typeof raw === "string") out[key] = raw;
+	else if (isObjectRecord(raw) && typeof raw.env === "string") out[key] = `\${${raw.env}}`;
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+function normalizePrime(name, raw) {
+	return compact({
+		...normalizeStandard(name, raw),
+		env: primeEnv(raw.env)
+	});
+}
 function normalizeEntry(name, raw, dialect) {
 	if (dialect === "antigravity") return normalizeAntigravity(name, raw);
 	if (dialect === "opencode") return normalizeOpenCode(name, raw);
+	if (dialect === "prime") return normalizePrime(name, raw);
 	return normalizeStandard(name, raw);
 }
 function denormalizeAntigravity(server) {
@@ -2260,9 +2496,44 @@ function denormalizeStandard(server) {
 		enabled: server.enabled
 	});
 }
+function denormalizePrime(server) {
+	const env = server.env ? Object.fromEntries(Object.entries(server.env).map(([key, value]) => [key, { env: requirePrimeReference(server, key, value) }])) : void 0;
+	return compact({
+		...denormalizeStandard(server),
+		env
+	});
+}
+function requirePrimeReference(server, key, value) {
+	const reference = envReference(value);
+	if (reference === void 0) throw new McpEnvError(`${server.name}: Prime Agent takes only environment references in env; write ${key} as "\${NAME}" and export NAME where prime-agent runs`);
+	return reference;
+}
+function resolveEnvReferences(server, dialect) {
+	if (!server.env) return server;
+	if (dialect === "prime") {
+		for (const [key, value] of Object.entries(server.env)) requirePrimeReference(server, key, value);
+		return server;
+	}
+	const env = {};
+	for (const [key, value] of Object.entries(server.env)) {
+		const reference = envReference(value);
+		if (reference === void 0) {
+			env[key] = value;
+			continue;
+		}
+		const resolved = Object.hasOwn(process.env, reference) ? process.env[reference] : void 0;
+		if (typeof resolved !== "string") throw new McpEnvError(`${server.name}: env ${key} references ${reference}, which is not set in this environment`);
+		env[key] = resolved;
+	}
+	return {
+		...server,
+		env
+	};
+}
 function denormalizeEntry(server, dialect) {
 	if (dialect === "antigravity") return denormalizeAntigravity(server);
 	if (dialect === "opencode") return denormalizeOpenCode(server);
+	if (dialect === "prime") return denormalizePrime(server);
 	return denormalizeStandard(server);
 }
 function listingBase(entry, path) {
@@ -2318,9 +2589,6 @@ function writeAtomically(path, content) {
 	writeFileSync(temp, content);
 	renameSync(temp, path);
 }
-function escapeRegExp(value) {
-	return value.replaceAll(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
 function tomlValue(value) {
 	return JSON.stringify(value);
 }
@@ -2342,8 +2610,8 @@ function tomlSections(key, server) {
 	return `${lines.join("\n")}\n`;
 }
 function stripTomlServer(raw, key, name) {
-	const prefix = escapeRegExp(key.map(tomlKeyPart).join("."));
-	const namePart = `(?:${escapeRegExp(tomlKeyPart(name))}|${escapeRegExp(JSON.stringify(name))})`;
+	const prefix = RegExp.escape(key.map(tomlKeyPart).join("."));
+	const namePart = `(?:${RegExp.escape(tomlKeyPart(name))}|${RegExp.escape(JSON.stringify(name))})`;
 	const sectionRe = new RegExp(`^\\s*\\[${prefix}\\.${namePart}(\\.[^\\]]+)?\\]`);
 	const bareTableRe = new RegExp(`^\\s*\\[${prefix}\\]\\s*(#.*)?$`);
 	const anyHeaderRe = /^\s*\[/;
@@ -2399,15 +2667,16 @@ function removeTomlServer(path, key, name) {
 }
 function addMcpServer(harness, server, scope = "user", options = {}) {
 	const { entry, path } = writableConfig(harness, scope, options);
+	const resolved = resolveEnvReferences(server, entry.dialect);
 	if (entry.format === "toml") return {
 		path,
-		replaced: addTomlServer(path, entry.key, server)
+		replaced: addTomlServer(path, entry.key, resolved)
 	};
 	const root = JSON.parse(readIfExists$1(path) ?? "{}");
 	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(server, entry.dialect);
+	map[server.name] = denormalizeEntry(resolved, entry.dialect);
 	writeAtomically(path, `${JSON.stringify(root, null, 2)}\n`);
 	return {
 		path,
@@ -2616,20 +2885,29 @@ function withdrawMasterServersFromExcludedHarness(harness, existing, masterNames
 function syncIncludedHarness(harness, master, existing, masterNames, initialPath, options) {
 	const results = [];
 	let path = initialPath;
-	for (const server of master.servers) {
-		if (existing.get(server.name) === canonical(server)) {
+	const { dialect } = writableConfig(harness, "user", options).entry;
+	for (const server of master.servers) try {
+		const resolved = resolveEnvReferences(server, dialect);
+		if (existing.get(server.name) === canonical(resolved)) {
 			results.push({
 				name: server.name,
 				action: "unchanged"
 			});
 			continue;
 		}
-		const written = addMcpServer(harness, server, "user", options);
+		const written = addMcpServer(harness, resolved, "user", options);
 		path = written.path;
 		results.push({
 			name: server.name,
 			action: written.replaced ? "replaced" : "added"
 		});
+	} catch (error) {
+		if (!(error instanceof McpEnvError)) throw error;
+		results.push({
+			name: server.name,
+			action: "skipped",
+			reason: error.message
+		});
 	}
 	for (const name of existing.keys()) {
 		if (masterNames.has(name)) continue;
@@ -2858,6 +3136,6 @@ function syncAgentsFiles(harnesses, check = false, options = {}) {
 		targets: harnesses.map((harness) => syncTarget(harness, config, check, options))
 	};
 }
-export { Harness, addMcpServer, detectHarness, detectHarnessFromEnv, detectProjectHarnesses, getAllHarnesses, getHarness, isHarnessId, listHarnesses, listMcpServers, masterMcpPath, parseJsonc, readAgentsConfig, readMasterMcpServers, registerHarness, removeMcpServer, resolvePathTemplate, syncAgentsFiles, syncMcpServers };
+export { Harness, McpEnvError, addMcpServer, detectHarness, detectHarnessFromEnv, detectProjectHarnesses, getAllHarnesses, getHarness, isHarnessId, listHarnesses, listMcpServers, masterMcpPath, parseJsonc, readAgentsConfig, readMasterMcpServers, registerHarness, removeMcpServer, resolvePathTemplate, syncAgentsFiles, syncMcpServers };
 
 //# sourceMappingURL=agents-sync.mjs.map