@agntn/harnesses 0.2.0 → 0.3.0

package/dist/_chunks/prompts.mjs

@@ -0,0 +1,28 @@
+import { promptsSync } from "./tool-operations.mjs";
+import { formatArgs, report } from "./output.mjs";
+import { defineCommand } from "citty";
+var prompts_default = defineCommand({
+	meta: { description: "Manage shared prompt templates across harnesses" },
+	subCommands: { sync: defineCommand({
+		meta: { description: "Sync Markdown templates from the agntn XDG data directory into harness destinations" },
+		args: {
+			id: {
+				type: "positional",
+				description: "Harness id",
+				required: false
+			},
+			check: {
+				type: "boolean",
+				description: "Report what would change without writing anything"
+			},
+			...formatArgs
+		},
+		run({ args }) {
+			const id = args.id === void 0 ? void 0 : args.id;
+			report(promptsSync(id, args.check === true), args);
+		}
+	}) }
+});
+export { prompts_default as default };
+
+//# sourceMappingURL=prompts.mjs.map

package/dist/_chunks/prompts.mjs.map

@@ -0,0 +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"}

package/dist/_chunks/tool-operations.mjs

@@ -1,5 +1,6 @@
-import { addMcpServer, getAllHarnesses, getHarness, isHarnessId, listHarnesses, listMcpServers, readAgentsConfig, readMasterMcpServers, removeMcpServer, syncAgentsFiles, syncMcpServers } from "./agents-sync.mjs";
+import { addMcpServer, getAllHarnesses, getHarness, isHarnessId, listHarnesses, listMcpServers, readAgentsConfig, readMasterMcpServers, removeMcpServer, syncAgentsFiles, syncMcpServers, syncPromptTemplates } from "./prompt-sync.mjs";
 import "./tool-schemas.mjs";
+import { stripVTControlCharacters } from "node:util";
 import { encode } from "@toon-format/toon";
 const RUN_DEFAULT_TIMEOUT_SECONDS = 600;
 const RUN_MAX_OUTPUT_CHARS = 8e3;
@@ -27,9 +28,6 @@ function truncate(output) {
 	if (output.length <= 8e3) return output;
 	return `${output.slice(0, RUN_MAX_OUTPUT_CHARS)}\n[truncated ${output.length - RUN_MAX_OUTPUT_CHARS} of ${output.length} characters]`;
 }
-function modelListingUnavailable(harness, id) {
-	return { error: harness.modelListing ? `Harness ${id} does not support filtering its model listing` : `Harness ${id} does not support model listing` };
-}
 const ALTERNATE_INVOCATION_MODE = {
 	advisor: "agent",
 	advisorStructured: "agentStructured",
@@ -54,6 +52,21 @@ function invocationRetry(invocationModes, mode, options) {
 	const alternateMode = ALTERNATE_INVOCATION_MODE[mode];
 	return alternateMode !== void 0 && invocationModes[alternateMode] ? { tools: !options.tools } : void 0;
 }
+const OUTPUT_CONTROLS = /[\u0000-\u0008\u000B-\u001F\u007F-\u009F]/g;
+function plainOutput(output) {
+	return stripVTControlCharacters(output).replaceAll("\r\n", "\n").replace(OUTPUT_CONTROLS, " ");
+}
+function runText(outcome, streams) {
+	const blocks = [encode(outcome)];
+	for (const name of ["stdout", "stderr"]) {
+		const output = streams[name];
+		if (output !== void 0 && output.length > 0) blocks.push(`${name}:\n${plainOutput(output)}`);
+	}
+	return [{
+		type: "text",
+		text: blocks.join("\n\n")
+	}];
+}
 function completedRun(harness, result, options, templateArgs) {
 	const contentOutcome = {
 		id: harness.id,
@@ -66,27 +79,26 @@ function completedRun(harness, result, options, templateArgs) {
 		exitCode: result.exitCode,
 		timedOut: result.timedOut,
 		aborted: result.aborted,
-		stdout: truncate(result.stdout)
+		...result.idleMs === void 0 ? {} : { idleMs: result.idleMs }
 	};
+	const stdout = truncate(result.stdout);
 	const stderr = truncate(result.stderr);
 	const details = {
 		...contentOutcome,
 		args: result.args,
+		stdout,
 		stderr
 	};
 	if (result.timedOut || result.exitCode !== 0) return {
-		content: text({
-			...contentOutcome,
+		content: runText(contentOutcome, {
+			stdout,
 			stderr
 		}),
 		details,
 		isError: true
 	};
 	return {
-		content: text(result.stdout.length > 0 ? contentOutcome : {
-			...contentOutcome,
-			stderr
-		}),
+		content: runText(contentOutcome, stdout.length > 0 ? { stdout } : { stderr }),
 		details
 	};
 }
@@ -146,7 +158,11 @@ function harnessInfoResult(id) {
 		instructions: harness.instructions,
 		skills: harness.skills,
 		commands: harness.commands,
+		promptTemplates: harness.promptTemplates,
+		promptTemplateSyncTarget: harness.promptTemplateSyncTarget,
 		hooks: harness.hooks,
+		temp: harness.temp,
+		envOverrides: harness.envOverrides,
 		persistence: harness.persistence,
 		detection: harness.detection,
 		resolved: harness.resolve()
@@ -154,7 +170,7 @@ function harnessInfoResult(id) {
 }
 function harnessInfoText(result) {
 	if ("error" in result) return result;
-	const { id, name, binaries, capabilities, invocationModes, modelListing, modelSelection, persistence, detection, resolved } = result;
+	const { id, name, binaries, capabilities, invocationModes, modelListing, modelSelection, envOverrides, persistence, detection, resolved } = result;
 	return {
 		id,
 		name,
@@ -163,6 +179,7 @@ function harnessInfoText(result) {
 		invocationModes,
 		modelListing,
 		modelSelection,
+		envOverrides: getHarness(id).resolveCandidates(envOverrides),
 		persistence,
 		detection,
 		resolved
@@ -196,7 +213,7 @@ async function listHarnessModels(id, options = {}) {
 	if (!isHarnessId(id)) return unknownHarness(id);
 	const harness = getHarness(id);
 	if (!harness.buildModelListInvocation(options.search)) {
-		const details = modelListingUnavailable(harness, id);
+		const details = { error: `Harness ${id} does not support model listing` };
 		return {
 			content: text(details),
 			details,
@@ -220,15 +237,19 @@ async function listHarnessModels(id, options = {}) {
 			isError: true
 		};
 	}
+	return completedListing(harness.id, result, result.models, options.search);
+}
+function completedListing(id, result, models, search) {
 	const details = {
-		id: harness.id,
+		id,
 		command: result.command,
-		args: result.args,
-		...options.search === void 0 ? {} : { search: options.search },
-		models: result.models,
+		args: [...result.args],
+		...search === void 0 ? {} : { search },
+		models: [...models],
 		exitCode: result.exitCode,
 		timedOut: result.timedOut,
 		aborted: result.aborted,
+		...result.idleMs === void 0 ? {} : { idleMs: result.idleMs },
 		stderr: truncate(result.stderr)
 	};
 	return {
@@ -241,7 +262,7 @@ function normalizedRunAccess(options) {
 	const readOnly = options.readOnly ?? false;
 	return {
 		readOnly,
-		tools: readOnly ? true : options.tools ?? false
+		tools: options.tools ?? readOnly
 	};
 }
 async function runHarness(id, prompt, options = {}) {
@@ -414,6 +435,23 @@ function agentsSync(id, check = false) {
 		};
 	}
 }
-export { RUN_DEFAULT_TIMEOUT_SECONDS, RUN_MAX_OUTPUT_CHARS, agentsSync, detectHarnesses, harnessInfo, listHarnessModels, mcpAdd, mcpList, mcpRemove, mcpSync, runHarness, toMcpServerConfig };
+function promptsSync(id, check = false) {
+	if (id !== void 0 && !isHarnessId(id)) return unknownHarness(id);
+	try {
+		const details = syncPromptTemplates(id !== void 0 && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses(), check);
+		return {
+			content: text(details),
+			details
+		};
+	} catch (error) {
+		const details = { error: errorMessage(error) };
+		return {
+			content: text(details),
+			details,
+			isError: true
+		};
+	}
+}
+export { RUN_DEFAULT_TIMEOUT_SECONDS, RUN_MAX_OUTPUT_CHARS, agentsSync, detectHarnesses, harnessInfo, listHarnessModels, mcpAdd, mcpList, mcpRemove, mcpSync, promptsSync, runHarness, toMcpServerConfig };
 
 //# sourceMappingURL=tool-operations.mjs.map

package/dist/_chunks/tool-operations.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tool-operations.mjs","names":["toToon"],"sources":["../../src/tool-operations.ts"],"sourcesContent":["/**\n * Tool executors behind the agent extensions.\n *\n * Each executor returns the text a caller reads plus the structured details a\n * harness can attach to the call. The text is TOON-encoded so the model sees\n * the same compact shape the CLI's --toon flag prints.\n */\nimport { encode as toToon } from \"@toon-format/toon\";\nimport { getAllHarnesses, getHarness, isHarnessId, listHarnesses } from \"./registry.ts\";\nimport {\n  addMcpServer,\n  listMcpServers,\n  readMasterMcpServers,\n  removeMcpServer,\n  syncMcpServers,\n} from \"./mcp-servers.ts\";\nimport type { McpConfigListing, SyncReport } from \"./mcp-servers.ts\";\nimport { readAgentsConfig, syncAgentsFiles } from \"./agents-sync.ts\";\nimport type { AgentsSyncReport } from \"./agents-sync.ts\";\nexport type { AgentsSyncReport } from \"./agents-sync.ts\";\nexport type { SyncReport } from \"./mcp-servers.ts\";\nexport type { HarnessInvocationModes } from \"./types.ts\";\nimport type { Harness } from \"./harness.ts\";\nimport type {\n  AvailableModel,\n  HarnessCapabilities,\n  HarnessDetection,\n  HarnessId,\n  HarnessInvocationModes,\n  InvokeResult,\n  ListModelsResult,\n  McpServerConfig,\n  PathCandidate,\n  ResolvedPaths,\n  StorageDescriptor,\n} from \"./types.ts\";\n\n/** Text for the model plus details for the harness, shared by every tool surface. */\nexport interface ToolResult<Details> {\n  content: Array<{ type: \"text\"; text: string }>;\n  details: Details;\n  /** Set when the tool could not answer. */\n  isError?: boolean;\n}\n\n/** Install state of one harness on this machine. */\nexport interface HarnessStatus {\n  id: HarnessId;\n  name: string;\n  installed: boolean;\n  version: string | null;\n}\n\n/** Every registered harness with its install state, as scanned by {@link detectHarnesses}. */\nexport interface HarnessListing {\n  harnesses: HarnessStatus[];\n}\n\n/** Full metadata for one harness, including paths resolved for this platform. */\nexport interface HarnessMetadata {\n  id: HarnessId;\n  name: string;\n  binaries: string[];\n  capabilities: HarnessCapabilities;\n  invocationModes: HarnessInvocationModes;\n  modelListing: boolean;\n  modelSelection: boolean;\n  config: PathCandidate[];\n  sessions: PathCandidate[];\n  instructions: PathCandidate[];\n  skills: PathCandidate[];\n  commands: PathCandidate[];\n  hooks: PathCandidate[];\n  persistence: StorageDescriptor[];\n  detection: HarnessDetection;\n  resolved: ResolvedPaths;\n}\n\n/** Returned when the requested harness id is not registered. */\nexport interface UnknownHarness {\n  error: string;\n  known: HarnessId[];\n}\n\n/** Returned when a direct batch call bypasses the tool schema limits. */\nexport interface HarnessInfoInputError {\n  error: string;\n}\n\n/** One harness lookup result. */\nexport type HarnessInfoResult = HarnessMetadata | UnknownHarness;\n\n/** Scalar, batch, or rejected batch details from {@link harnessInfo}. */\nexport type HarnessInfoDetails = HarnessInfoResult | HarnessInfoResult[] | HarnessInfoInputError;\n\nimport { HARNESS_INFO_MAX_ITEMS, RUN_TIMEOUT_DEFAULT_SECONDS } from \"./tool-schemas.ts\";\nexport { HARNESS_INFO_MAX_ITEMS } from \"./tool-schemas.ts\";\n\n/** Default wall-clock budget for one harness run, in seconds. */\nexport const RUN_DEFAULT_TIMEOUT_SECONDS = RUN_TIMEOUT_DEFAULT_SECONDS;\n\n/** The run tool's per-stream cap: harness output is unbounded, model context is not. */\nexport const RUN_MAX_OUTPUT_CHARS = 8000;\n\nfunction text(data: unknown): Array<{ type: \"text\"; text: string }> {\n  return [{ type: \"text\", text: toToon(data) }];\n}\n\nfunction unknownHarness(id: string): ToolResult<UnknownHarness> {\n  const details: UnknownHarness = { error: `Unknown harness: ${id}`, known: listHarnesses() };\n  return { content: text(details), details, isError: true };\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction truncate(output: string): string {\n  if (output.length <= RUN_MAX_OUTPUT_CHARS) return output;\n  return `${output.slice(0, RUN_MAX_OUTPUT_CHARS)}\\n[truncated ${output.length - RUN_MAX_OUTPUT_CHARS} of ${output.length} characters]`;\n}\n\nfunction modelListingUnavailable(harness: Harness, id: string): RunFailure {\n  return {\n    error: harness.modelListing\n      ? `Harness ${id} does not support filtering its model listing`\n      : `Harness ${id} does not support model listing`,\n  };\n}\n\ntype RunInvocationOptions = Readonly<{\n  model?: string;\n  structured: boolean;\n  tools: boolean;\n  readOnly: boolean;\n}>;\n\ntype InvocationMode = keyof HarnessInvocationModes;\n\nconst ALTERNATE_INVOCATION_MODE: Partial<Record<InvocationMode, InvocationMode>> = {\n  advisor: \"agent\",\n  advisorStructured: \"agentStructured\",\n  agent: \"advisor\",\n  agentStructured: \"advisorStructured\",\n};\n\nfunction selectedInvocationMode(\n  structured: boolean,\n  tools: boolean,\n  readOnly: boolean,\n): InvocationMode {\n  if (readOnly) return structured ? \"readOnlyStructured\" : \"readOnly\";\n  if (tools) return structured ? \"agentStructured\" : \"agent\";\n  return structured ? \"advisorStructured\" : \"advisor\";\n}\n\nfunction invocationRetry(\n  invocationModes: Readonly<HarnessInvocationModes>,\n  mode: InvocationMode,\n  options: RunInvocationOptions,\n): RunFailure[\"retry\"] {\n  const withoutStructured = selectedInvocationMode(false, options.tools, options.readOnly);\n  if (options.structured) {\n    if (invocationModes[withoutStructured]) return { structured: false };\n    const alternateWithoutStructured = ALTERNATE_INVOCATION_MODE[withoutStructured];\n    if (alternateWithoutStructured && invocationModes[alternateWithoutStructured]) {\n      return { structured: false, tools: !options.tools };\n    }\n  }\n\n  const alternateMode = ALTERNATE_INVOCATION_MODE[mode];\n  return alternateMode !== undefined && invocationModes[alternateMode]\n    ? { tools: !options.tools }\n    : undefined;\n}\n\nfunction completedRun(\n  harness: Harness,\n  result: InvokeResult,\n  options: RunInvocationOptions,\n  templateArgs: readonly string[],\n): ToolResult<RunOutcome> {\n  const contentOutcome: Omit<RunOutcome, \"stderr\"> = {\n    id: harness.id,\n    command: result.command,\n    args: [...templateArgs],\n    ...(options.model === undefined ? {} : { model: options.model }),\n    structured: options.structured,\n    tools: options.tools,\n    readOnly: options.readOnly,\n    exitCode: result.exitCode,\n    timedOut: result.timedOut,\n    aborted: result.aborted,\n    stdout: truncate(result.stdout),\n  };\n  const stderr = truncate(result.stderr);\n  const details: RunOutcome = { ...contentOutcome, args: result.args, stderr };\n  if (result.timedOut || result.exitCode !== 0) {\n    return { content: text({ ...contentOutcome, stderr }), details, isError: true };\n  }\n  return {\n    content: text(result.stdout.length > 0 ? contentOutcome : { ...contentOutcome, stderr }),\n    details,\n  };\n}\n\nfunction unsupportedInvocation(\n  harness: Harness,\n  id: string,\n  options: RunInvocationOptions,\n): ToolResult<RunFailure> {\n  const error = harness.invocationError(options) ?? `Invalid ${id} invocation`;\n  const invocationModes = harness.invocationModes;\n  const mode = selectedInvocationMode(options.structured, options.tools, options.readOnly);\n  const modelUnsupported =\n    options.model !== undefined && harness.invocation?.modelArgs === undefined;\n  if (invocationModes[mode] || harness.invocation === null || modelUnsupported) {\n    const details: RunFailure = { error };\n    return { content: text(details), details, isError: true };\n  }\n\n  const retry = invocationRetry(invocationModes, mode, options);\n  const details: RunFailure = {\n    error,\n    invocationModes,\n    ...(retry === undefined ? {} : { retry }),\n  };\n  return { content: text(details), details, isError: true };\n}\n\n/**\n * Scans every registered harness for its binaries and version.\n *\n * @returns {ToolResult<HarnessListing>} The complete installation listing.\n */\nexport function detectHarnesses(): ToolResult<HarnessListing> {\n  const details: HarnessListing = {\n    harnesses: getAllHarnesses().map((harness) => {\n      const installed = harness.isInstalled();\n      return {\n        id: harness.id,\n        name: harness.name,\n        installed,\n        version: installed ? harness.version : null,\n      };\n    }),\n  };\n\n  return { content: text(details), details };\n}\n\nfunction harnessInfoResult(id: string): HarnessInfoResult {\n  if (!isHarnessId(id)) return unknownHarness(id).details;\n\n  const harness = getHarness(id);\n  return {\n    id: harness.id,\n    name: harness.name,\n    binaries: harness.binaries,\n    capabilities: harness.capabilities,\n    invocationModes: harness.invocationModes,\n    modelListing: harness.modelListing !== null,\n    modelSelection: harness.invocation?.modelArgs !== undefined,\n    config: harness.config,\n    sessions: harness.sessions,\n    instructions: harness.instructions,\n    skills: harness.skills,\n    commands: harness.commands,\n    hooks: harness.hooks,\n    persistence: harness.persistence,\n    detection: harness.detection,\n    resolved: harness.resolve(),\n  };\n}\n\n/** One lookup as the model reads it: every path list once, in {@link HarnessMetadata.resolved}. */\ntype HarnessInfoText =\n  | Omit<HarnessMetadata, \"config\" | \"sessions\" | \"instructions\" | \"skills\" | \"commands\" | \"hooks\">\n  | UnknownHarness;\n\n/**\n * Leaves the path templates out of the text: `resolved` already carries each\n * of them for this machine, so they only doubled every answer.\n *\n * @param result - One lookup result.\n * @returns {HarnessInfoText} The lookup with its path lists shown once.\n */\nfunction harnessInfoText(result: HarnessInfoResult): HarnessInfoText {\n  if (\"error\" in result) return result;\n  const {\n    id,\n    name,\n    binaries,\n    capabilities,\n    invocationModes,\n    modelListing,\n    modelSelection,\n    persistence,\n    detection,\n    resolved,\n  } = result;\n  return {\n    id,\n    name,\n    binaries,\n    capabilities,\n    invocationModes,\n    modelListing,\n    modelSelection,\n    persistence,\n    detection,\n    resolved,\n  };\n}\n\n/** Full metadata for one harness, with paths resolved for the current platform. */\nexport function harnessInfo(id: string): ToolResult<HarnessInfoResult>;\n/** Full metadata for several harnesses, preserving input order and errors for each item. */\nexport function harnessInfo(\n  ids: readonly string[],\n): ToolResult<HarnessInfoResult[] | HarnessInfoInputError>;\nexport function harnessInfo(input: string | readonly string[]): ToolResult<HarnessInfoDetails>;\nexport function harnessInfo(input: string | readonly string[]): ToolResult<HarnessInfoDetails> {\n  if (typeof input === \"string\") {\n    const details = harnessInfoResult(input);\n    return {\n      content: text(harnessInfoText(details)),\n      details,\n      ...(\"error\" in details ? { isError: true } : {}),\n    };\n  }\n\n  if (input.length < 1 || input.length > HARNESS_INFO_MAX_ITEMS) {\n    const details: HarnessInfoInputError = {\n      error: `harnesses_info accepts between 1 and ${HARNESS_INFO_MAX_ITEMS} ids`,\n    };\n    return { content: text(details), details, isError: true };\n  }\n\n  const details = input.map(harnessInfoResult);\n  return {\n    content: text(details.map(harnessInfoText)),\n    details,\n    ...(details.some((result) => \"error\" in result) ? { isError: true } : {}),\n  };\n}\n\n/** Options accepted by {@link listHarnessModels}. */\nexport interface ModelsOptions {\n  search?: string;\n  cwd?: string;\n  /** Wall-clock budget in seconds; defaults to {@link RUN_DEFAULT_TIMEOUT_SECONDS}. */\n  timeoutSeconds?: number;\n  /** Cancel the owned command through the host request signal. */\n  signal?: AbortSignal;\n}\n\n/** One completed native model-listing query. */\nexport interface ModelsOutcome {\n  id: HarnessId;\n  command: string;\n  args: string[];\n  search?: string;\n  models: AvailableModel[];\n  exitCode: number | null;\n  timedOut: boolean;\n  aborted: boolean;\n  stderr: string;\n}\n\n/**\n * Lists the models currently available to one harness through its native CLI.\n *\n * @param id - Harness id to query.\n * @param options - Search, working-directory, and timeout options.\n * @returns {Promise<ToolResult<ModelsOutcome | RunFailure>>} The model listing or failure.\n */\nexport async function listHarnessModels(\n  id: string,\n  options: ModelsOptions = {},\n): Promise<ToolResult<ModelsOutcome | RunFailure>> {\n  if (!isHarnessId(id)) return unknownHarness(id);\n\n  const harness = getHarness(id);\n  const built = harness.buildModelListInvocation(options.search);\n  if (!built) {\n    const details = modelListingUnavailable(harness, id);\n    return { content: text(details), details, isError: true };\n  }\n\n  const timeoutSeconds = options.timeoutSeconds ?? RUN_DEFAULT_TIMEOUT_SECONDS;\n  let result: ListModelsResult;\n  try {\n    result = await harness.listModels({\n      search: options.search,\n      cwd: options.cwd,\n      timeoutMs: timeoutSeconds * 1000,\n      signal: options.signal,\n    });\n  } catch (error) {\n    const details: RunFailure = { error: `Failed to list ${id} models: ${errorMessage(error)}` };\n    return { content: text(details), details, isError: true };\n  }\n\n  const details: ModelsOutcome = {\n    id: harness.id,\n    command: result.command,\n    args: result.args,\n    ...(options.search === undefined ? {} : { search: options.search }),\n    models: result.models,\n    exitCode: result.exitCode,\n    timedOut: result.timedOut,\n    aborted: result.aborted,\n    stderr: truncate(result.stderr),\n  };\n\n  return {\n    content: text(details),\n    details,\n    ...(result.timedOut || result.exitCode !== 0 ? { isError: true } : {}),\n  };\n}\n\n/** Options accepted by {@link runHarness}. */\nexport interface RunOptions {\n  cwd?: string;\n  /** Harness-native model id or selector. */\n  model?: string;\n  /** Wall-clock budget in seconds; defaults to {@link RUN_DEFAULT_TIMEOUT_SECONDS}. */\n  timeoutSeconds?: number;\n  /** Cancel the owned command through the host request signal. */\n  signal?: AbortSignal;\n  /** Use the harness's structured (JSON) output mode instead of plain text. */\n  structured?: boolean;\n  /** Enable tools; defaults to a native advisor without tools invocation. */\n  tools?: boolean;\n  /** Require native enforcement of read-only tool access. Implies tools. */\n  readOnly?: boolean;\n}\n\n/** One completed (or failed) harness run, with output capped for the model. */\nexport interface RunOutcome {\n  id: HarnessId;\n  command: string;\n  /** Expanded arguments; the model's text keeps \"{prompt}\" instead, it wrote the prompt itself. */\n  args: string[];\n  model?: string;\n  structured: boolean;\n  tools: boolean;\n  readOnly: boolean;\n  exitCode: number | null;\n  timedOut: boolean;\n  aborted: boolean;\n  stdout: string;\n  stderr: string;\n}\n\n/** Returned when the harness cannot be run at all. */\nexport interface RunFailure {\n  error: string;\n  known?: HarnessId[];\n  /** Modes accepted by the selected harness when invocation mode caused the failure. */\n  invocationModes?: HarnessInvocationModes;\n  /** Explicit mode change that makes the same invocation shape executable. */\n  retry?: { structured: false; tools?: boolean } | { tools: boolean };\n}\n\nfunction normalizedRunAccess(options: Readonly<RunOptions>): {\n  tools: boolean;\n  readOnly: boolean;\n} {\n  const readOnly = options.readOnly ?? false;\n  return { readOnly, tools: readOnly ? true : (options.tools ?? false) };\n}\n\n/**\n * Runs one prompt through a harness's normalized non-interactive invocation.\n *\n * Tool use defaults to a native advisor without tools invocation. Harnesses that\n * cannot disable tools reject that mode; setting `tools` selects their full\n * agent invocation. `model` is translated through the harness-specific recipe.\n * This layer also closes stdin, enforces the timeout, caps the echoed output,\n * and leaves the prompt out of the echoed invocation.\n *\n * @param id - Harness id to run.\n * @param prompt - Prompt sent to the selected harness.\n * @param options - Model, mode, working-directory, and timeout options.\n * @returns {Promise<ToolResult<RunOutcome | RunFailure>>} The capped run outcome or failure.\n */\nexport async function runHarness(\n  id: string,\n  prompt: string,\n  options: RunOptions = {},\n): Promise<ToolResult<RunOutcome | RunFailure>> {\n  if (!isHarnessId(id)) return unknownHarness(id);\n\n  const harness = getHarness(id);\n  const structured = options.structured ?? false;\n  const { tools, readOnly } = normalizedRunAccess(options);\n  const invocationOptions = { model: options.model, structured, tools, readOnly };\n  const template = harness.buildInvocation(\"{prompt}\", invocationOptions);\n  if (!template) {\n    return unsupportedInvocation(harness, id, invocationOptions);\n  }\n\n  const timeoutSeconds = options.timeoutSeconds ?? RUN_DEFAULT_TIMEOUT_SECONDS;\n\n  let result: InvokeResult;\n  try {\n    result = await harness.invoke(prompt, {\n      cwd: options.cwd,\n      model: options.model,\n      timeoutMs: timeoutSeconds * 1000,\n      signal: options.signal,\n      structured,\n      tools,\n      readOnly,\n    });\n  } catch (error) {\n    const details: RunFailure = { error: `Failed to run ${id}: ${errorMessage(error)}` };\n    return { content: text(details), details, isError: true };\n  }\n\n  return completedRun(harness, result, invocationOptions, template.args);\n}\n\n/** MCP server listings for one harness or all of them. */\nexport interface McpListing {\n  harnesses: Array<{ id: HarnessId; configs: McpConfigListing[] }>;\n}\n\n/** Marker used only at the tool and CLI boundary, leaving config reads lossless for edits. */\nconst MCP_REDACTED_VALUE = \"<redacted>\";\nconst MCP_CONFIG_ERROR = \"Unable to read or parse MCP config\";\n\nfunction redactMcpValues(values: Readonly<Record<string, string>>): Record<string, string> {\n  return Object.fromEntries(Object.keys(values).map((key) => [key, MCP_REDACTED_VALUE]));\n}\n\n/** Result of one MCP config mutation. */\nexport interface McpMutation {\n  id: HarnessId;\n  path: string;\n  action: \"added\" | \"replaced\" | \"removed\" | \"noop\";\n}\n\n/** Flat tool parameters describing one MCP server, shared by every surface. */\nexport interface McpServerParams {\n  name: string;\n  transport?: McpServerConfig[\"transport\"];\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n  url?: string;\n  headers?: Record<string, string>;\n}\n\n/**\n * Builds the normalized server shape from flat tool parameters.\n *\n * @param params - Flat MCP server parameters.\n * @returns {McpServerConfig} The normalized server configuration.\n */\nexport function toMcpServerConfig(params: McpServerParams): McpServerConfig {\n  const server: McpServerConfig = {\n    name: params.name,\n    transport: params.transport ?? (params.url ? \"http\" : \"stdio\"),\n  };\n  if (params.command !== undefined) server.command = params.command;\n  if (params.args !== undefined) server.args = params.args;\n  if (params.env !== undefined) server.env = params.env;\n  if (params.url !== undefined) server.url = params.url;\n  if (params.headers !== undefined) server.headers = params.headers;\n  return server;\n}\n\n/**\n * Lists configured MCP servers, normalized across harness config dialects.\n *\n * @param id - Optional harness id; omission lists every harness.\n * @returns {ToolResult<McpListing | UnknownHarness>} The normalized listing or id error.\n */\nexport function mcpList(id?: string): ToolResult<McpListing | UnknownHarness> {\n  if (id !== undefined && !isHarnessId(id)) return unknownHarness(id);\n\n  const targets = id !== undefined && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses();\n  const details: McpListing = {\n    harnesses: targets\n      .map((harness) => ({\n        id: harness.id,\n        configs: listMcpServers(harness).map((listing) => ({\n          ...listing,\n          ...(listing.error === undefined ? {} : { error: MCP_CONFIG_ERROR }),\n          servers: listing.servers.map((server) => ({\n            ...server,\n            ...(server.env === undefined ? {} : { env: redactMcpValues(server.env) }),\n            ...(server.headers === undefined ? {} : { headers: redactMcpValues(server.headers) }),\n          })),\n        })),\n      }))\n      .filter((entry) => entry.configs.length > 0),\n  };\n\n  return { content: text(details), details };\n}\n\nfunction mcpMutate(\n  id: string,\n  mutate: (harness: Harness) => { path: string; action: McpMutation[\"action\"] },\n): ToolResult<McpMutation | RunFailure> {\n  if (!isHarnessId(id)) return unknownHarness(id);\n\n  try {\n    const { path, action } = mutate(getHarness(id));\n    const details: McpMutation = { id, path, action };\n    return { content: text(details), details, ...(action === \"noop\" ? { isError: true } : {}) };\n  } catch (error) {\n    const details: RunFailure = { error: errorMessage(error) };\n    return { content: text(details), details, isError: true };\n  }\n}\n\n/**\n * Adds or replaces one MCP server in a harness's config.\n *\n * @param id - Target harness id.\n * @param params - Server parameters to normalize and write.\n * @param scope - User or project config scope.\n * @returns {ToolResult<McpMutation | RunFailure>} The mutation outcome or failure.\n */\nexport function mcpAdd(\n  id: string,\n  params: McpServerParams,\n  scope: \"user\" | \"project\" = \"user\",\n): ToolResult<McpMutation | RunFailure> {\n  return mcpMutate(id, (harness) => {\n    const { path, replaced } = addMcpServer(harness, toMcpServerConfig(params), scope);\n    return { path, action: replaced ? \"replaced\" : \"added\" };\n  });\n}\n\n/**\n * Removes one MCP server from a harness's config.\n *\n * @param id - Target harness id.\n * @param name - Server name to remove.\n * @param scope - User or project config scope.\n * @returns {ToolResult<McpMutation | RunFailure>} The mutation outcome or failure.\n */\nexport function mcpRemove(\n  id: string,\n  name: string,\n  scope: \"user\" | \"project\" = \"user\",\n): ToolResult<McpMutation | RunFailure> {\n  return mcpMutate(id, (harness) => {\n    const { path, removed } = removeMcpServer(harness, name, scope);\n    return { path, action: removed ? \"removed\" : \"noop\" };\n  });\n}\n\n/**\n * Pushes the master MCP list from ~/.config/agntn/mcp.jsonc into harness configs.\n *\n * @param id - Optional harness id; omission targets every harness.\n * @returns {ToolResult<SyncReport | RunFailure>} The sync report or failure.\n */\nexport function mcpSync(id?: string): ToolResult<SyncReport | RunFailure> {\n  if (id !== undefined && !isHarnessId(id)) return unknownHarness(id);\n\n  try {\n    // Preflight before any write: a typo in excludes must fail the whole run,\n    // not silently leave the misspelled harness unprotected.\n    const unknown = readMasterMcpServers().excludes.filter((entry) => !isHarnessId(entry));\n    if (unknown.length > 0) {\n      const details: RunFailure = {\n        error: `Master MCP list excludes unknown harnesses: ${unknown.join(\", \")}`,\n        known: listHarnesses(),\n      };\n      return { content: text(details), details, isError: true };\n    }\n    const details = syncMcpServers(\n      id !== undefined && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses(),\n    );\n    return { content: text(details), details };\n  } catch (error) {\n    const details: RunFailure = { error: errorMessage(error) };\n    return { content: text(details), details, isError: true };\n  }\n}\n\n/**\n * Links every harness's global instructions file to the master AGENTS.md.\n *\n * @param id - Optional harness id; omission targets every harness.\n * @param check - Report intended changes without writing them.\n * @returns {ToolResult<AgentsSyncReport | RunFailure>} The sync report or failure.\n */\nexport function agentsSync(id?: string, check = false): ToolResult<AgentsSyncReport | RunFailure> {\n  if (id !== undefined && !isHarnessId(id)) return unknownHarness(id);\n\n  try {\n    // Preflight before any write: a typo in excludes must fail the whole run,\n    // not silently adopt the harness it was meant to protect.\n    const unknown = readAgentsConfig().excludes.filter((entry) => !isHarnessId(entry));\n    if (unknown.length > 0) {\n      const details: RunFailure = {\n        error: `Agents config excludes unknown harnesses: ${unknown.join(\", \")}`,\n        known: listHarnesses(),\n      };\n      return { content: text(details), details, isError: true };\n    }\n    const details = syncAgentsFiles(\n      id !== undefined && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses(),\n      check,\n    );\n    return { content: text(details), details };\n  } catch (error) {\n    const details: RunFailure = { error: errorMessage(error) };\n    return { content: text(details), details, isError: true };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"tool-operations.mjs","names":["toToon"],"sources":["../../src/tool-operations.ts"],"sourcesContent":["/**\n * Tool executors behind the agent extensions.\n *\n * Each executor returns the text a caller reads plus the structured details a\n * harness can attach to the call. The text is TOON-encoded so the model sees\n * the same compact shape the CLI's --toon flag prints. A run's output is the\n * exception: it follows the status block as plain text, not as one TOON string.\n */\nimport { stripVTControlCharacters } from \"node:util\";\nimport { encode as toToon } from \"@toon-format/toon\";\nimport { getAllHarnesses, getHarness, isHarnessId, listHarnesses } from \"./registry.ts\";\nimport {\n  addMcpServer,\n  listMcpServers,\n  readMasterMcpServers,\n  removeMcpServer,\n  syncMcpServers,\n} from \"./mcp-servers.ts\";\nimport type { McpConfigListing, SyncReport } from \"./mcp-servers.ts\";\nimport { readAgentsConfig, syncAgentsFiles } from \"./agents-sync.ts\";\nimport type { AgentsSyncReport } from \"./agents-sync.ts\";\nexport type { AgentsSyncReport } from \"./agents-sync.ts\";\nexport type { SyncReport } from \"./mcp-servers.ts\";\nexport type { PromptSyncReport } from \"./prompt-sync.ts\";\nexport type { HarnessInvocationModes } from \"./types.ts\";\nimport { syncPromptTemplates } from \"./prompt-sync.ts\";\nimport type { PromptSyncReport } from \"./prompt-sync.ts\";\nimport type { Harness } from \"./harness.ts\";\nimport type {\n  AvailableModel,\n  EnvOverride,\n  HarnessCapabilities,\n  HarnessDetection,\n  HarnessId,\n  HarnessInvocationModes,\n  InvokeResult,\n  ListModelsResult,\n  McpServerConfig,\n  PathCandidate,\n  PromptTemplateSyncTarget,\n  ResolvedPaths,\n  StorageDescriptor,\n} from \"./types.ts\";\n\n/** Text for the model plus details for the harness, shared by every tool surface. */\nexport interface ToolResult<Details> {\n  content: Array<{ type: \"text\"; text: string }>;\n  details: Details;\n  /** Set when the tool could not answer. */\n  isError?: boolean;\n}\n\n/** Install state of one harness on this machine. */\nexport interface HarnessStatus {\n  id: HarnessId;\n  name: string;\n  installed: boolean;\n  version: string | null;\n}\n\n/** Every registered harness with its install state, as scanned by {@link detectHarnesses}. */\nexport interface HarnessListing {\n  harnesses: HarnessStatus[];\n}\n\n/** Full metadata for one harness, including paths resolved for this platform. */\nexport interface HarnessMetadata {\n  id: HarnessId;\n  name: string;\n  binaries: string[];\n  capabilities: HarnessCapabilities;\n  invocationModes: HarnessInvocationModes;\n  modelListing: boolean;\n  modelSelection: boolean;\n  config: PathCandidate[];\n  sessions: PathCandidate[];\n  instructions: PathCandidate[];\n  skills: PathCandidate[];\n  commands: PathCandidate[];\n  promptTemplates: PathCandidate[];\n  promptTemplateSyncTarget: PromptTemplateSyncTarget | null;\n  hooks: PathCandidate[];\n  temp: PathCandidate[];\n  envOverrides: EnvOverride[];\n  persistence: StorageDescriptor[];\n  detection: HarnessDetection;\n  resolved: ResolvedPaths;\n}\n\n/** Returned when the requested harness id is not registered. */\nexport interface UnknownHarness {\n  error: string;\n  known: HarnessId[];\n}\n\n/** Returned when a direct batch call bypasses the tool schema limits. */\nexport interface HarnessInfoInputError {\n  error: string;\n}\n\n/** One harness lookup result. */\nexport type HarnessInfoResult = HarnessMetadata | UnknownHarness;\n\n/** Scalar, batch, or rejected batch details from {@link harnessInfo}. */\nexport type HarnessInfoDetails = HarnessInfoResult | HarnessInfoResult[] | HarnessInfoInputError;\n\nimport { HARNESS_INFO_MAX_ITEMS, RUN_TIMEOUT_DEFAULT_SECONDS } from \"./tool-schemas.ts\";\nexport { HARNESS_INFO_MAX_ITEMS } from \"./tool-schemas.ts\";\n\n/** Default wall-clock budget for one harness run, in seconds. */\nexport const RUN_DEFAULT_TIMEOUT_SECONDS = RUN_TIMEOUT_DEFAULT_SECONDS;\n\n/** The run tool's per-stream cap: harness output is unbounded, model context is not. */\nexport const RUN_MAX_OUTPUT_CHARS = 8000;\n\nfunction text(data: unknown): Array<{ type: \"text\"; text: string }> {\n  return [{ type: \"text\", text: toToon(data) }];\n}\n\nfunction unknownHarness(id: string): ToolResult<UnknownHarness> {\n  const details: UnknownHarness = { error: `Unknown harness: ${id}`, known: listHarnesses() };\n  return { content: text(details), details, isError: true };\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction truncate(output: string): string {\n  if (output.length <= RUN_MAX_OUTPUT_CHARS) return output;\n  return `${output.slice(0, RUN_MAX_OUTPUT_CHARS)}\\n[truncated ${output.length - RUN_MAX_OUTPUT_CHARS} of ${output.length} characters]`;\n}\n\ntype RunInvocationOptions = Readonly<{\n  model?: string;\n  structured: boolean;\n  tools: boolean;\n  readOnly: boolean;\n}>;\n\ntype InvocationMode = keyof HarnessInvocationModes;\n\nconst ALTERNATE_INVOCATION_MODE: Partial<Record<InvocationMode, InvocationMode>> = {\n  advisor: \"agent\",\n  advisorStructured: \"agentStructured\",\n  agent: \"advisor\",\n  agentStructured: \"advisorStructured\",\n};\n\nfunction selectedInvocationMode(\n  structured: boolean,\n  tools: boolean,\n  readOnly: boolean,\n): InvocationMode {\n  if (readOnly) return structured ? \"readOnlyStructured\" : \"readOnly\";\n  if (tools) return structured ? \"agentStructured\" : \"agent\";\n  return structured ? \"advisorStructured\" : \"advisor\";\n}\n\nfunction invocationRetry(\n  invocationModes: Readonly<HarnessInvocationModes>,\n  mode: InvocationMode,\n  options: RunInvocationOptions,\n): RunFailure[\"retry\"] {\n  const withoutStructured = selectedInvocationMode(false, options.tools, options.readOnly);\n  if (options.structured) {\n    if (invocationModes[withoutStructured]) return { structured: false };\n    const alternateWithoutStructured = ALTERNATE_INVOCATION_MODE[withoutStructured];\n    if (alternateWithoutStructured && invocationModes[alternateWithoutStructured]) {\n      return { structured: false, tools: !options.tools };\n    }\n  }\n\n  const alternateMode = ALTERNATE_INVOCATION_MODE[mode];\n  return alternateMode !== undefined && invocationModes[alternateMode]\n    ? { tools: !options.tools }\n    : undefined;\n}\n\n/** The run as its status block shows it: everything but the two streams. */\ntype RunStatus = Readonly<Omit<RunOutcome, \"args\" | \"stdout\" | \"stderr\">> & {\n  readonly args: readonly string[];\n};\n\ntype RunStreams = Readonly<Partial<Pick<RunOutcome, \"stdout\" | \"stderr\">>>;\n\n// oxlint-disable-next-line no-control-regex -- Terminal control bytes are precisely what this boundary removes.\nconst OUTPUT_CONTROLS = /[\\u0000-\\u0008\\u000B-\\u001F\\u007F-\\u009F]/g;\n\n/**\n * Strips what TOON quoting used to escape: terminal sequences and control bytes; CRLF becomes LF.\n *\n * @param output - One capped stream.\n * @returns {string} The stream as plain text.\n */\nfunction plainOutput(output: string): string {\n  return stripVTControlCharacters(output).replaceAll(\"\\r\\n\", \"\\n\").replace(OUTPUT_CONTROLS, \" \");\n}\n\n/**\n * Lays the run out for the model: the TOON status block, then each stream under\n * its name as plain text, since quoting a markdown answer into one TOON string\n * escaped every code block and cost about a tenth more tokens.\n *\n * @param outcome - The run without its output.\n * @param streams - The capped streams; empty ones are left out.\n * @returns {Array<{ type: \"text\"; text: string }>} The text handed to the model.\n */\nfunction runText(outcome: RunStatus, streams: RunStreams): Array<{ type: \"text\"; text: string }> {\n  const blocks = [toToon(outcome)];\n  for (const name of [\"stdout\", \"stderr\"] as const) {\n    const output = streams[name];\n    if (output !== undefined && output.length > 0) blocks.push(`${name}:\\n${plainOutput(output)}`);\n  }\n  return [{ type: \"text\", text: blocks.join(\"\\n\\n\") }];\n}\n\nfunction completedRun(\n  harness: Harness,\n  result: InvokeResult,\n  options: RunInvocationOptions,\n  templateArgs: readonly string[],\n): ToolResult<RunOutcome> {\n  const contentOutcome: Omit<RunOutcome, \"stdout\" | \"stderr\"> = {\n    id: harness.id,\n    command: result.command,\n    args: [...templateArgs],\n    ...(options.model === undefined ? {} : { model: options.model }),\n    structured: options.structured,\n    tools: options.tools,\n    readOnly: options.readOnly,\n    exitCode: result.exitCode,\n    timedOut: result.timedOut,\n    aborted: result.aborted,\n    ...(result.idleMs === undefined ? {} : { idleMs: result.idleMs }),\n  };\n  const stdout = truncate(result.stdout);\n  const stderr = truncate(result.stderr);\n  const details: RunOutcome = { ...contentOutcome, args: result.args, stdout, stderr };\n  if (result.timedOut || result.exitCode !== 0) {\n    return { content: runText(contentOutcome, { stdout, stderr }), details, isError: true };\n  }\n  return {\n    content: runText(contentOutcome, stdout.length > 0 ? { stdout } : { stderr }),\n    details,\n  };\n}\n\nfunction unsupportedInvocation(\n  harness: Harness,\n  id: string,\n  options: RunInvocationOptions,\n): ToolResult<RunFailure> {\n  const error = harness.invocationError(options) ?? `Invalid ${id} invocation`;\n  const invocationModes = harness.invocationModes;\n  const mode = selectedInvocationMode(options.structured, options.tools, options.readOnly);\n  const modelUnsupported =\n    options.model !== undefined && harness.invocation?.modelArgs === undefined;\n  if (invocationModes[mode] || harness.invocation === null || modelUnsupported) {\n    const details: RunFailure = { error };\n    return { content: text(details), details, isError: true };\n  }\n\n  const retry = invocationRetry(invocationModes, mode, options);\n  const details: RunFailure = {\n    error,\n    invocationModes,\n    ...(retry === undefined ? {} : { retry }),\n  };\n  return { content: text(details), details, isError: true };\n}\n\n/**\n * Scans every registered harness for its binaries and version.\n *\n * @returns {ToolResult<HarnessListing>} The complete installation listing.\n */\nexport function detectHarnesses(): ToolResult<HarnessListing> {\n  const details: HarnessListing = {\n    harnesses: getAllHarnesses().map((harness) => {\n      const installed = harness.isInstalled();\n      return {\n        id: harness.id,\n        name: harness.name,\n        installed,\n        version: installed ? harness.version : null,\n      };\n    }),\n  };\n\n  return { content: text(details), details };\n}\n\nfunction harnessInfoResult(id: string): HarnessInfoResult {\n  if (!isHarnessId(id)) return unknownHarness(id).details;\n\n  const harness = getHarness(id);\n  return {\n    id: harness.id,\n    name: harness.name,\n    binaries: harness.binaries,\n    capabilities: harness.capabilities,\n    invocationModes: harness.invocationModes,\n    modelListing: harness.modelListing !== null,\n    modelSelection: harness.invocation?.modelArgs !== undefined,\n    config: harness.config,\n    sessions: harness.sessions,\n    instructions: harness.instructions,\n    skills: harness.skills,\n    commands: harness.commands,\n    promptTemplates: harness.promptTemplates,\n    promptTemplateSyncTarget: harness.promptTemplateSyncTarget,\n    hooks: harness.hooks,\n    temp: harness.temp,\n    envOverrides: harness.envOverrides,\n    persistence: harness.persistence,\n    detection: harness.detection,\n    resolved: harness.resolve(),\n  };\n}\n\n/**\n * One lookup as the model reads it: every path list once, in\n * {@link HarnessMetadata.resolved}, and the env overrides with their default\n * roots resolved the same way.\n */\ntype HarnessInfoText =\n  | Omit<\n      HarnessMetadata,\n      | \"config\"\n      | \"sessions\"\n      | \"instructions\"\n      | \"skills\"\n      | \"commands\"\n      | \"promptTemplates\"\n      | \"promptTemplateSyncTarget\"\n      | \"hooks\"\n      | \"temp\"\n    >\n  | UnknownHarness;\n\n/**\n * Leaves the path templates out of the text: `resolved` already carries each\n * of them for this machine, so they only doubled every answer. Env overrides\n * have no resolved copy, so their own roots are resolved in place.\n *\n * @param result - One lookup result.\n * @returns {HarnessInfoText} The lookup with its path lists shown once.\n */\nfunction harnessInfoText(result: HarnessInfoResult): HarnessInfoText {\n  if (\"error\" in result) return result;\n  const {\n    id,\n    name,\n    binaries,\n    capabilities,\n    invocationModes,\n    modelListing,\n    modelSelection,\n    envOverrides,\n    persistence,\n    detection,\n    resolved,\n  } = result;\n  return {\n    id,\n    name,\n    binaries,\n    capabilities,\n    invocationModes,\n    modelListing,\n    modelSelection,\n    envOverrides: getHarness(id).resolveCandidates(envOverrides),\n    persistence,\n    detection,\n    resolved,\n  };\n}\n\n/** Full metadata for one harness, with paths resolved for the current platform. */\nexport function harnessInfo(id: string): ToolResult<HarnessInfoResult>;\n/** Full metadata for several harnesses, preserving input order and errors for each item. */\nexport function harnessInfo(\n  ids: readonly string[],\n): ToolResult<HarnessInfoResult[] | HarnessInfoInputError>;\nexport function harnessInfo(input: string | readonly string[]): ToolResult<HarnessInfoDetails>;\nexport function harnessInfo(input: string | readonly string[]): ToolResult<HarnessInfoDetails> {\n  if (typeof input === \"string\") {\n    const details = harnessInfoResult(input);\n    return {\n      content: text(harnessInfoText(details)),\n      details,\n      ...(\"error\" in details ? { isError: true } : {}),\n    };\n  }\n\n  if (input.length < 1 || input.length > HARNESS_INFO_MAX_ITEMS) {\n    const details: HarnessInfoInputError = {\n      error: `harnesses_info accepts between 1 and ${HARNESS_INFO_MAX_ITEMS} ids`,\n    };\n    return { content: text(details), details, isError: true };\n  }\n\n  const details = input.map(harnessInfoResult);\n  return {\n    content: text(details.map(harnessInfoText)),\n    details,\n    ...(details.some((result) => \"error\" in result) ? { isError: true } : {}),\n  };\n}\n\n/** Options accepted by {@link listHarnessModels}. */\nexport interface ModelsOptions {\n  search?: string;\n  cwd?: string;\n  /** Wall-clock budget in seconds; defaults to {@link RUN_DEFAULT_TIMEOUT_SECONDS}. */\n  timeoutSeconds?: number;\n  /** Cancel the owned command through the host request signal. */\n  signal?: AbortSignal;\n}\n\n/** One completed native model-listing query. */\nexport interface ModelsOutcome {\n  id: HarnessId;\n  command: string;\n  args: string[];\n  search?: string;\n  models: AvailableModel[];\n  exitCode: number | null;\n  timedOut: boolean;\n  aborted: boolean;\n  /** Milliseconds without output before the listing was stopped; absent when it exited on its own. */\n  idleMs?: number;\n  stderr: string;\n}\n\n/**\n * Lists the models currently available to one harness through its native CLI.\n *\n * @param id - Harness id to query.\n * @param options - Search, working-directory, and timeout options.\n * @returns {Promise<ToolResult<ModelsOutcome | RunFailure>>} The model listing or failure.\n */\nexport async function listHarnessModels(\n  id: string,\n  options: ModelsOptions = {},\n): Promise<ToolResult<ModelsOutcome | RunFailure>> {\n  if (!isHarnessId(id)) return unknownHarness(id);\n\n  const harness = getHarness(id);\n  const built = harness.buildModelListInvocation(options.search);\n  if (!built) {\n    const details: RunFailure = { error: `Harness ${id} does not support model listing` };\n    return { content: text(details), details, isError: true };\n  }\n\n  const timeoutSeconds = options.timeoutSeconds ?? RUN_DEFAULT_TIMEOUT_SECONDS;\n  let result: ListModelsResult;\n  try {\n    result = await harness.listModels({\n      search: options.search,\n      cwd: options.cwd,\n      timeoutMs: timeoutSeconds * 1000,\n      signal: options.signal,\n    });\n  } catch (error) {\n    const details: RunFailure = { error: `Failed to list ${id} models: ${errorMessage(error)}` };\n    return { content: text(details), details, isError: true };\n  }\n\n  return completedListing(harness.id, result, result.models, options.search);\n}\n\nfunction completedListing(\n  id: HarnessId,\n  result: InvokeResult,\n  models: readonly Readonly<AvailableModel>[],\n  search: string | undefined,\n): ToolResult<ModelsOutcome> {\n  const details: ModelsOutcome = {\n    id,\n    command: result.command,\n    args: [...result.args],\n    ...(search === undefined ? {} : { search }),\n    models: [...models],\n    exitCode: result.exitCode,\n    timedOut: result.timedOut,\n    aborted: result.aborted,\n    ...(result.idleMs === undefined ? {} : { idleMs: result.idleMs }),\n    stderr: truncate(result.stderr),\n  };\n\n  return {\n    content: text(details),\n    details,\n    ...(result.timedOut || result.exitCode !== 0 ? { isError: true } : {}),\n  };\n}\n\n/** Options accepted by {@link runHarness}. */\nexport interface RunOptions {\n  cwd?: string;\n  /** Harness-native model id or selector. */\n  model?: string;\n  /** Wall-clock budget in seconds; defaults to {@link RUN_DEFAULT_TIMEOUT_SECONDS}. */\n  timeoutSeconds?: number;\n  /** Cancel the owned command through the host request signal. */\n  signal?: AbortSignal;\n  /** Use the harness's structured (JSON) output mode instead of plain text. */\n  structured?: boolean;\n  /** Enable tools; defaults to a native advisor without tools invocation. */\n  tools?: boolean;\n  /** Require native enforcement of read-only tool access. Implies tools when `tools` is omitted; `tools: false` rejects the run. */\n  readOnly?: boolean;\n}\n\n/** One completed (or failed) harness run, with output capped for the model. */\nexport interface RunOutcome {\n  id: HarnessId;\n  command: string;\n  /** Expanded arguments; the model's text keeps \"{prompt}\" instead, it wrote the prompt itself. */\n  args: string[];\n  model?: string;\n  structured: boolean;\n  tools: boolean;\n  readOnly: boolean;\n  exitCode: number | null;\n  timedOut: boolean;\n  aborted: boolean;\n  /** Milliseconds without output before the run was stopped; absent when it exited on its own. */\n  idleMs?: number;\n  stdout: string;\n  stderr: string;\n}\n\n/** Returned when the harness cannot be run at all. */\nexport interface RunFailure {\n  error: string;\n  known?: HarnessId[];\n  /** Modes accepted by the selected harness when invocation mode caused the failure. */\n  invocationModes?: HarnessInvocationModes;\n  /** Explicit mode change that makes the same invocation shape executable. */\n  retry?: { structured: false; tools?: boolean } | { tools: boolean };\n}\n\nfunction normalizedRunAccess(options: Readonly<RunOptions>): {\n  tools: boolean;\n  readOnly: boolean;\n} {\n  const readOnly = options.readOnly ?? false;\n  return { readOnly, tools: options.tools ?? readOnly };\n}\n\n/**\n * Runs one prompt through a harness's normalized non-interactive invocation.\n *\n * Tool use defaults to a native advisor without tools invocation. Harnesses that\n * cannot disable tools reject that mode; setting `tools` selects their full\n * agent invocation. `model` is translated through the harness-specific recipe.\n * This layer also closes stdin, enforces the timeout, caps the echoed output,\n * and leaves the prompt out of the echoed invocation.\n *\n * @param id - Harness id to run.\n * @param prompt - Prompt sent to the selected harness.\n * @param options - Model, mode, working-directory, and timeout options.\n * @returns {Promise<ToolResult<RunOutcome | RunFailure>>} The capped run outcome or failure.\n */\nexport async function runHarness(\n  id: string,\n  prompt: string,\n  options: RunOptions = {},\n): Promise<ToolResult<RunOutcome | RunFailure>> {\n  if (!isHarnessId(id)) return unknownHarness(id);\n\n  const harness = getHarness(id);\n  const structured = options.structured ?? false;\n  const { tools, readOnly } = normalizedRunAccess(options);\n  const invocationOptions = { model: options.model, structured, tools, readOnly };\n  const template = harness.buildInvocation(\"{prompt}\", invocationOptions);\n  if (!template) {\n    return unsupportedInvocation(harness, id, invocationOptions);\n  }\n\n  const timeoutSeconds = options.timeoutSeconds ?? RUN_DEFAULT_TIMEOUT_SECONDS;\n\n  let result: InvokeResult;\n  try {\n    result = await harness.invoke(prompt, {\n      cwd: options.cwd,\n      model: options.model,\n      timeoutMs: timeoutSeconds * 1000,\n      signal: options.signal,\n      structured,\n      tools,\n      readOnly,\n    });\n  } catch (error) {\n    const details: RunFailure = { error: `Failed to run ${id}: ${errorMessage(error)}` };\n    return { content: text(details), details, isError: true };\n  }\n\n  return completedRun(harness, result, invocationOptions, template.args);\n}\n\n/** MCP server listings for one harness or all of them. */\nexport interface McpListing {\n  harnesses: Array<{ id: HarnessId; configs: McpConfigListing[] }>;\n}\n\n/** Marker used only at the tool and CLI boundary, leaving config reads lossless for edits. */\nconst MCP_REDACTED_VALUE = \"<redacted>\";\nconst MCP_CONFIG_ERROR = \"Unable to read or parse MCP config\";\n\nfunction redactMcpValues(values: Readonly<Record<string, string>>): Record<string, string> {\n  return Object.fromEntries(Object.keys(values).map((key) => [key, MCP_REDACTED_VALUE]));\n}\n\n/** Result of one MCP config mutation. */\nexport interface McpMutation {\n  id: HarnessId;\n  path: string;\n  action: \"added\" | \"replaced\" | \"removed\" | \"noop\";\n}\n\n/** Flat tool parameters describing one MCP server, shared by every surface. */\nexport interface McpServerParams {\n  name: string;\n  transport?: McpServerConfig[\"transport\"];\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n  url?: string;\n  headers?: Record<string, string>;\n}\n\n/**\n * Builds the normalized server shape from flat tool parameters.\n *\n * @param params - Flat MCP server parameters.\n * @returns {McpServerConfig} The normalized server configuration.\n */\nexport function toMcpServerConfig(params: McpServerParams): McpServerConfig {\n  const server: McpServerConfig = {\n    name: params.name,\n    transport: params.transport ?? (params.url ? \"http\" : \"stdio\"),\n  };\n  if (params.command !== undefined) server.command = params.command;\n  if (params.args !== undefined) server.args = params.args;\n  if (params.env !== undefined) server.env = params.env;\n  if (params.url !== undefined) server.url = params.url;\n  if (params.headers !== undefined) server.headers = params.headers;\n  return server;\n}\n\n/**\n * Lists configured MCP servers, normalized across harness config dialects.\n *\n * @param id - Optional harness id; omission lists every harness.\n * @returns {ToolResult<McpListing | UnknownHarness>} The normalized listing or id error.\n */\nexport function mcpList(id?: string): ToolResult<McpListing | UnknownHarness> {\n  if (id !== undefined && !isHarnessId(id)) return unknownHarness(id);\n\n  const targets = id !== undefined && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses();\n  const details: McpListing = {\n    harnesses: targets\n      .map((harness) => ({\n        id: harness.id,\n        configs: listMcpServers(harness).map((listing) => ({\n          ...listing,\n          ...(listing.error === undefined ? {} : { error: MCP_CONFIG_ERROR }),\n          servers: listing.servers.map((server) => ({\n            ...server,\n            ...(server.env === undefined ? {} : { env: redactMcpValues(server.env) }),\n            ...(server.headers === undefined ? {} : { headers: redactMcpValues(server.headers) }),\n          })),\n        })),\n      }))\n      .filter((entry) => entry.configs.length > 0),\n  };\n\n  return { content: text(details), details };\n}\n\nfunction mcpMutate(\n  id: string,\n  mutate: (harness: Harness) => { path: string; action: McpMutation[\"action\"] },\n): ToolResult<McpMutation | RunFailure> {\n  if (!isHarnessId(id)) return unknownHarness(id);\n\n  try {\n    const { path, action } = mutate(getHarness(id));\n    const details: McpMutation = { id, path, action };\n    return { content: text(details), details, ...(action === \"noop\" ? { isError: true } : {}) };\n  } catch (error) {\n    const details: RunFailure = { error: errorMessage(error) };\n    return { content: text(details), details, isError: true };\n  }\n}\n\n/**\n * Adds or replaces one MCP server in a harness's config.\n *\n * @param id - Target harness id.\n * @param params - Server parameters to normalize and write.\n * @param scope - User or project config scope.\n * @returns {ToolResult<McpMutation | RunFailure>} The mutation outcome or failure.\n */\nexport function mcpAdd(\n  id: string,\n  params: McpServerParams,\n  scope: \"user\" | \"project\" = \"user\",\n): ToolResult<McpMutation | RunFailure> {\n  return mcpMutate(id, (harness) => {\n    const { path, replaced } = addMcpServer(harness, toMcpServerConfig(params), scope);\n    return { path, action: replaced ? \"replaced\" : \"added\" };\n  });\n}\n\n/**\n * Removes one MCP server from a harness's config.\n *\n * @param id - Target harness id.\n * @param name - Server name to remove.\n * @param scope - User or project config scope.\n * @returns {ToolResult<McpMutation | RunFailure>} The mutation outcome or failure.\n */\nexport function mcpRemove(\n  id: string,\n  name: string,\n  scope: \"user\" | \"project\" = \"user\",\n): ToolResult<McpMutation | RunFailure> {\n  return mcpMutate(id, (harness) => {\n    const { path, removed } = removeMcpServer(harness, name, scope);\n    return { path, action: removed ? \"removed\" : \"noop\" };\n  });\n}\n\n/**\n * Pushes the master MCP list from ~/.config/agntn/mcp.jsonc into harness configs.\n *\n * @param id - Optional harness id; omission targets every harness.\n * @returns {ToolResult<SyncReport | RunFailure>} The sync report or failure.\n */\nexport function mcpSync(id?: string): ToolResult<SyncReport | RunFailure> {\n  if (id !== undefined && !isHarnessId(id)) return unknownHarness(id);\n\n  try {\n    // Preflight before any write: a typo in excludes must fail the whole run,\n    // not silently leave the misspelled harness unprotected.\n    const unknown = readMasterMcpServers().excludes.filter((entry) => !isHarnessId(entry));\n    if (unknown.length > 0) {\n      const details: RunFailure = {\n        error: `Master MCP list excludes unknown harnesses: ${unknown.join(\", \")}`,\n        known: listHarnesses(),\n      };\n      return { content: text(details), details, isError: true };\n    }\n    const details = syncMcpServers(\n      id !== undefined && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses(),\n    );\n    return { content: text(details), details };\n  } catch (error) {\n    const details: RunFailure = { error: errorMessage(error) };\n    return { content: text(details), details, isError: true };\n  }\n}\n\n/**\n * Links every harness's global instructions file to the master AGENTS.md.\n *\n * @param id - Optional harness id; omission targets every harness.\n * @param check - Report intended changes without writing them.\n * @returns {ToolResult<AgentsSyncReport | RunFailure>} The sync report or failure.\n */\nexport function agentsSync(id?: string, check = false): ToolResult<AgentsSyncReport | RunFailure> {\n  if (id !== undefined && !isHarnessId(id)) return unknownHarness(id);\n\n  try {\n    // Preflight before any write: a typo in excludes must fail the whole run,\n    // not silently adopt the harness it was meant to protect.\n    const unknown = readAgentsConfig().excludes.filter((entry) => !isHarnessId(entry));\n    if (unknown.length > 0) {\n      const details: RunFailure = {\n        error: `Agents config excludes unknown harnesses: ${unknown.join(\", \")}`,\n        known: listHarnesses(),\n      };\n      return { content: text(details), details, isError: true };\n    }\n    const details = syncAgentsFiles(\n      id !== undefined && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses(),\n      check,\n    );\n    return { content: text(details), details };\n  } catch (error) {\n    const details: RunFailure = { error: errorMessage(error) };\n    return { content: text(details), details, isError: true };\n  }\n}\n\n/**\n * Synchronizes canonical Markdown prompt templates into harness destinations.\n *\n * @param id - Optional harness id; omission targets every harness.\n * @param check - Report intended changes without writing them.\n * @returns {ToolResult<PromptSyncReport | RunFailure>} The sync report or failure.\n */\nexport function promptsSync(id?: string, check = false): ToolResult<PromptSyncReport | RunFailure> {\n  if (id !== undefined && !isHarnessId(id)) return unknownHarness(id);\n\n  try {\n    const details = syncPromptTemplates(\n      id !== undefined && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses(),\n      check,\n    );\n    return { content: text(details), details };\n  } catch (error) {\n    const details: RunFailure = { error: errorMessage(error) };\n    return { content: text(details), details, isError: true };\n  }\n}\n"],"mappings":"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"}

package/dist/_chunks/tool-schemas.d.mts

@@ -30,6 +30,7 @@ export declare const RUN_TIMEOUT_DEFAULT_SECONDS = 600;
  * @returns {Record<string, S>} Schemas keyed by harness tool operation.
  */
 export declare function harnessToolSchemas<I, S>(Type: McpSchemaBuilder<I, S>): {
+  /** Open on purpose: nothing to misread, and some models send a placeholder `_` here. */
   detect: S;
   info: S;
   models: S;
@@ -37,6 +38,7 @@ export declare function harnessToolSchemas<I, S>(Type: McpSchemaBuilder<I, S>):
   mcpList: S;
   mcpSync: S;
   agentsSync: S;
+  promptsSync: S;
   mcpAdd: S;
   mcpRemove: S;
 };
@@ -74,6 +76,10 @@ export interface AgentsSyncParams {
   id?: string;
   check?: boolean;
 }
+export interface PromptsSyncParams {
+  id?: string;
+  check?: boolean;
+}
 export interface McpAddParams {
   id: string;
   name: string;

package/dist/_chunks/tool-schemas.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-schemas.d.mts","names":[],"sources":["../../src/tool-schemas.ts"],"mappings":"AAaA;;;;;;;;;;;;iBAAiB,iBAAiB,GAAG;EACnC,OAAO,YAAY,SAAS,eAAe,KAAK,mBAAmB;EACnE,OAAO,mBAAmB;EAC1B,QAAQ,mBAAmB;EAC3B,QAAQ,mBAAmB;EAC3B,MAAM,MAAM,GAAG,mBAAmB;EAClC,OAAO,KAAK,GAAG,OAAO,GAAG,mBAAmB;EAC5C,MAAM,kBAAkB,KAAK,mBAAmB;EAChD,QAAQ,eAAe,mBAAmB;EAC1C,SAAS,QAAQ,IAAI;;qBAGV;qBACA;;;;;;;wBAQG,mBAAmB,GAAG,GAAG,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;iBA2JlD;EACf;;iBAGe;EACf;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;;iBAGe;EACf;;iBAGe;EACf;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA,MAAM;EACN;EACA;EACA,UAAU;EACV;;iBAGe;EACf;EACA;EACA"}
+{"version":3,"file":"tool-schemas.d.mts","names":[],"sources":["../../src/tool-schemas.ts"],"mappings":"AAaA;;;;;;;;;;;;iBAAiB,iBAAiB,GAAG;EACnC,OAAO,YAAY,SAAS,eAAe,KAAK,mBAAmB;EACnE,OAAO,mBAAmB;EAC1B,QAAQ,mBAAmB;EAC3B,QAAQ,mBAAmB;EAC3B,MAAM,MAAM,GAAG,mBAAmB;EAClC,OAAO,KAAK,GAAG,OAAO,GAAG,mBAAmB;EAC5C,MAAM,kBAAkB,KAAK,mBAAmB;EAChD,QAAQ,eAAe,mBAAmB;EAC1C,SAAS,QAAQ,IAAI;;qBAGV;qBACA;;;;;;;wBAQG,mBAAmB,GAAG,GAAG,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;iBA4KlD;EACf;;iBAGe;EACf;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;;iBAGe;EACf;;iBAGe;EACf;EACA;;iBAGe;EACf;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA,MAAM;EACN;EACA;EACA,UAAU;EACV;;iBAGe;EACf;EACA;EACA"}

package/dist/_chunks/tool-schemas.mjs

@@ -8,17 +8,18 @@ function harnessToolSchemas(Type) {
 		pattern: "^[a-z][a-z0-9-]*$"
 	});
 	const stringRecord = (description) => Type.Record(Type.String({ maxLength: 256 }), Type.String({ maxLength: 4096 }), { description });
+	const closed = (properties) => Type.Object(properties, { additionalProperties: false });
 	const scope = Type.Optional(Type.Union([Type.Literal("user"), Type.Literal("project")], { description: "Which config file to target (default user)" }));
 	return {
 		detect: Type.Object({}),
-		info: Type.Object({ id: Type.Union([harnessId("Harness id"), Type.Array(harnessId("Harness id"), {
+		info: closed({ id: Type.Union([harnessId("Harness id"), Type.Array(harnessId("Harness id"), {
 			minItems: 1,
 			maxItems: 20
 		})], { description: "Harness id, or a list of ids to inspect in one call" }) }),
-		models: Type.Object({
+		models: closed({
 			id: harnessId("Harness id"),
 			search: Type.Optional(Type.String({
-				description: "Optional native model search filter",
+				description: "Optional model search filter; without a native one, ids match ignoring case",
 				minLength: 1,
 				maxLength: 1024
 			})),
@@ -33,7 +34,7 @@ function harnessToolSchemas(Type) {
 				maximum: 3600
 			}))
 		}),
-		run: Type.Object({
+		run: closed({
 			id: harnessId("Harness id"),
 			prompt: Type.String({
 				description: "Prompt to send to the harness",
@@ -59,13 +60,17 @@ function harnessToolSchemas(Type) {
 			tools: Type.Boolean({ description: "Explicit execution mode. Set true when the task needs any harness tools, including Grok native X search. Set false only for an advisor without tools." }),
 			readOnly: Type.Optional(Type.Boolean({ description: "Set with tools=true to require native read-only tool enforcement. Unsupported harnesses reject the run instead of widening access." }))
 		}),
-		mcpList: Type.Object({ id: Type.Optional(harnessId("Harness id; omit to list every harness")) }),
-		mcpSync: Type.Object({ id: Type.Optional(harnessId("Harness id; omit to sync every harness")) }),
-		agentsSync: Type.Object({
+		mcpList: closed({ id: Type.Optional(harnessId("Harness id; omit to list every harness")) }),
+		mcpSync: closed({ id: Type.Optional(harnessId("Harness id; omit to sync every harness")) }),
+		agentsSync: closed({
 			id: Type.Optional(harnessId("Harness id; omit to sync every harness")),
 			check: Type.Optional(Type.Boolean({ description: "Report what would change without writing anything" }))
 		}),
-		mcpAdd: Type.Object({
+		promptsSync: closed({
+			id: Type.Optional(harnessId("Harness id; omit to sync every harness")),
+			check: Type.Optional(Type.Boolean({ description: "Report what would change without writing anything" }))
+		}),
+		mcpAdd: closed({
 			id: harnessId("Harness id"),
 			name: Type.String({
 				description: "Server name",
@@ -96,7 +101,7 @@ function harnessToolSchemas(Type) {
 			headers: Type.Optional(stringRecord("Headers for an http/sse server")),
 			scope
 		}),
-		mcpRemove: Type.Object({
+		mcpRemove: closed({
 			id: harnessId("Harness id"),
 			name: Type.String({
 				description: "Server name",

package/dist/_chunks/tool-schemas.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"tool-schemas.mjs","names":[],"sources":["../../src/tool-schemas.ts"],"sourcesContent":["/**\n * Tool parameter schemas shared by every surface (MCP server, Pi and OMP\n * extensions). Each surface owns a different TypeBox build (the extensions\n * must use their host's facade), so the schemas are a factory over a minimal\n * structural builder instead of importing typebox here.\n */\n\n/**\n * The subset of the TypeBox builder the tool schemas need. `I` is the schema\n * type the builder accepts as input, `S` the (possibly narrower) type it\n * returns; OMP's facade accepts its own `AnySchema` while producing schemas\n * that satisfy the host's stricter `TSchema`.\n */\nexport interface McpSchemaBuilder<I, S> {\n  Object(properties: Readonly<Record<string, I>>, options?: object): S;\n  String(options?: object): I;\n  Integer(options?: object): I;\n  Boolean(options?: object): I;\n  Array(item: I, options?: object): I;\n  Record(key: I, value: I, options?: object): I;\n  Union(schemas: readonly I[], options?: object): I;\n  Literal(value: string, options?: object): I;\n  Optional(schema: I): I;\n}\n\nexport const HARNESS_INFO_MAX_ITEMS = 20;\nexport const RUN_TIMEOUT_DEFAULT_SECONDS = 600;\n\n/**\n * Builds the parameter schemas for all harness tools with the host's TypeBox.\n *\n * @param Type - Host-provided TypeBox-compatible schema builder.\n * @returns {Record<string, S>} Schemas keyed by harness tool operation.\n */\nexport function harnessToolSchemas<I, S>(Type: McpSchemaBuilder<I, S>) {\n  const harnessId = (description: string) =>\n    Type.String({ description, minLength: 1, maxLength: 50, pattern: \"^[a-z][a-z0-9-]*$\" });\n\n  const stringRecord = (description: string) =>\n    Type.Record(Type.String({ maxLength: 256 }), Type.String({ maxLength: 4096 }), {\n      description,\n    });\n\n  const scope = Type.Optional(\n    Type.Union([Type.Literal(\"user\"), Type.Literal(\"project\")], {\n      description: \"Which config file to target (default user)\",\n    }),\n  );\n\n  return {\n    detect: Type.Object({}),\n    info: Type.Object({\n      id: Type.Union(\n        [\n          harnessId(\"Harness id\"),\n          Type.Array(harnessId(\"Harness id\"), {\n            minItems: 1,\n            maxItems: HARNESS_INFO_MAX_ITEMS,\n          }),\n        ],\n        { description: \"Harness id, or a list of ids to inspect in one call\" },\n      ),\n    }),\n    models: Type.Object({\n      id: harnessId(\"Harness id\"),\n      search: Type.Optional(\n        Type.String({\n          description: \"Optional native model search filter\",\n          minLength: 1,\n          maxLength: 1024,\n        }),\n      ),\n      cwd: Type.Optional(\n        Type.String({\n          description: \"Working directory used while loading harness configuration\",\n          minLength: 1,\n          maxLength: 4096,\n        }),\n      ),\n      timeoutSeconds: Type.Optional(\n        Type.Integer({\n          description: `Wall-clock budget in seconds (default ${RUN_TIMEOUT_DEFAULT_SECONDS})`,\n          minimum: 1,\n          maximum: 3600,\n        }),\n      ),\n    }),\n    run: Type.Object({\n      id: harnessId(\"Harness id\"),\n      prompt: Type.String({\n        description: \"Prompt to send to the harness\",\n        minLength: 1,\n        maxLength: 100000,\n      }),\n      cwd: Type.Optional(\n        Type.String({\n          description: \"Working directory for the run\",\n          minLength: 1,\n          maxLength: 4096,\n        }),\n      ),\n      model: Type.Optional(\n        Type.String({\n          description: \"Harness-native model id or selector\",\n          minLength: 1,\n          maxLength: 512,\n        }),\n      ),\n      timeoutSeconds: Type.Optional(\n        Type.Integer({\n          description: `Wall-clock budget in seconds (default ${RUN_TIMEOUT_DEFAULT_SECONDS})`,\n          minimum: 1,\n          maximum: 3600,\n        }),\n      ),\n      structured: Type.Optional(\n        Type.Boolean({\n          description: \"Use the harness's structured (JSON) output mode instead of plain text\",\n        }),\n      ),\n      tools: Type.Boolean({\n        description:\n          \"Explicit execution mode. Set true when the task needs any harness tools, including Grok native X search. Set false only for an advisor without tools.\",\n      }),\n      readOnly: Type.Optional(\n        Type.Boolean({\n          description:\n            \"Set with tools=true to require native read-only tool enforcement. Unsupported harnesses reject the run instead of widening access.\",\n        }),\n      ),\n    }),\n    mcpList: Type.Object({\n      id: Type.Optional(harnessId(\"Harness id; omit to list every harness\")),\n    }),\n    mcpSync: Type.Object({\n      id: Type.Optional(harnessId(\"Harness id; omit to sync every harness\")),\n    }),\n    agentsSync: Type.Object({\n      id: Type.Optional(harnessId(\"Harness id; omit to sync every harness\")),\n      check: Type.Optional(\n        Type.Boolean({ description: \"Report what would change without writing anything\" }),\n      ),\n    }),\n    mcpAdd: Type.Object({\n      id: harnessId(\"Harness id\"),\n      name: Type.String({\n        description: \"Server name\",\n        minLength: 1,\n        maxLength: 100,\n        pattern: \"^[A-Za-z0-9][A-Za-z0-9_-]*$\",\n      }),\n      command: Type.Optional(\n        Type.String({ description: \"Binary for a stdio server\", minLength: 1, maxLength: 4096 }),\n      ),\n      args: Type.Optional(\n        Type.Array(Type.String({ maxLength: 4096 }), {\n          description: \"Arguments for a stdio server\",\n          maxItems: 64,\n        }),\n      ),\n      env: Type.Optional(stringRecord(\"Environment variables for a stdio server\")),\n      url: Type.Optional(\n        Type.String({ description: \"URL for an http/sse server\", minLength: 1, maxLength: 4096 }),\n      ),\n      transport: Type.Optional(\n        Type.Union([Type.Literal(\"stdio\"), Type.Literal(\"http\"), Type.Literal(\"sse\")], {\n          description: \"Transport; inferred from url/command when omitted\",\n        }),\n      ),\n      headers: Type.Optional(stringRecord(\"Headers for an http/sse server\")),\n      scope,\n    }),\n    mcpRemove: Type.Object({\n      id: harnessId(\"Harness id\"),\n      name: Type.String({\n        description: \"Server name\",\n        minLength: 1,\n        maxLength: 100,\n      }),\n      scope,\n    }),\n  };\n}\n\n/**\n * Parameter types matching the schemas above. The generic factory erases the\n * builders' literal types, so hosts annotate their execute callbacks with\n * these instead of TypeBox Static inference.\n */\nexport interface InfoParams {\n  id: string | string[];\n}\n\nexport interface ModelsParams {\n  id: string;\n  search?: string;\n  cwd?: string;\n  timeoutSeconds?: number;\n}\n\nexport interface RunParams {\n  id: string;\n  prompt: string;\n  cwd?: string;\n  model?: string;\n  timeoutSeconds?: number;\n  structured?: boolean;\n  tools: boolean;\n  readOnly?: boolean;\n}\n\nexport interface McpListParams {\n  id?: string;\n}\n\nexport interface McpSyncParams {\n  id?: string;\n}\n\nexport interface AgentsSyncParams {\n  id?: string;\n  check?: boolean;\n}\n\nexport interface McpAddParams {\n  id: string;\n  name: string;\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n  url?: string;\n  transport?: \"stdio\" | \"http\" | \"sse\";\n  headers?: Record<string, string>;\n  scope?: \"user\" | \"project\";\n}\n\nexport interface McpRemoveParams {\n  id: string;\n  name: string;\n  scope?: \"user\" | \"project\";\n}\n"],"mappings":"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"}
+{"version":3,"file":"tool-schemas.mjs","names":[],"sources":["../../src/tool-schemas.ts"],"sourcesContent":["/**\n * Tool parameter schemas shared by every surface (MCP server, Pi and OMP\n * extensions). Each surface owns a different TypeBox build (the extensions\n * must use their host's facade), so the schemas are a factory over a minimal\n * structural builder instead of importing typebox here.\n */\n\n/**\n * The subset of the TypeBox builder the tool schemas need. `I` is the schema\n * type the builder accepts as input, `S` the (possibly narrower) type it\n * returns; OMP's facade accepts its own `AnySchema` while producing schemas\n * that satisfy the host's stricter `TSchema`.\n */\nexport interface McpSchemaBuilder<I, S> {\n  Object(properties: Readonly<Record<string, I>>, options?: object): S;\n  String(options?: object): I;\n  Integer(options?: object): I;\n  Boolean(options?: object): I;\n  Array(item: I, options?: object): I;\n  Record(key: I, value: I, options?: object): I;\n  Union(schemas: readonly I[], options?: object): I;\n  Literal(value: string, options?: object): I;\n  Optional(schema: I): I;\n}\n\nexport const HARNESS_INFO_MAX_ITEMS = 20;\nexport const RUN_TIMEOUT_DEFAULT_SECONDS = 600;\n\n/**\n * Builds the parameter schemas for all harness tools with the host's TypeBox.\n *\n * @param Type - Host-provided TypeBox-compatible schema builder.\n * @returns {Record<string, S>} Schemas keyed by harness tool operation.\n */\nexport function harnessToolSchemas<I, S>(Type: McpSchemaBuilder<I, S>) {\n  const harnessId = (description: string) =>\n    Type.String({ description, minLength: 1, maxLength: 50, pattern: \"^[a-z][a-z0-9-]*$\" });\n\n  const stringRecord = (description: string) =>\n    Type.Record(Type.String({ maxLength: 256 }), Type.String({ maxLength: 4096 }), {\n      description,\n    });\n\n  /**\n   * A closed object rejects a stray `read_only` instead of quietly running with every tool.\n   *\n   * @param properties - Declared tool arguments.\n   * @returns {S} An object schema that refuses undeclared keys.\n   */\n  const closed = (properties: Readonly<Record<string, I>>) =>\n    Type.Object(properties, { additionalProperties: false });\n\n  const scope = Type.Optional(\n    Type.Union([Type.Literal(\"user\"), Type.Literal(\"project\")], {\n      description: \"Which config file to target (default user)\",\n    }),\n  );\n\n  return {\n    /** Open on purpose: nothing to misread, and some models send a placeholder `_` here. */\n    detect: Type.Object({}),\n    info: closed({\n      id: Type.Union(\n        [\n          harnessId(\"Harness id\"),\n          Type.Array(harnessId(\"Harness id\"), {\n            minItems: 1,\n            maxItems: HARNESS_INFO_MAX_ITEMS,\n          }),\n        ],\n        { description: \"Harness id, or a list of ids to inspect in one call\" },\n      ),\n    }),\n    models: closed({\n      id: harnessId(\"Harness id\"),\n      search: Type.Optional(\n        Type.String({\n          description:\n            \"Optional model search filter; without a native one, ids match ignoring case\",\n          minLength: 1,\n          maxLength: 1024,\n        }),\n      ),\n      cwd: Type.Optional(\n        Type.String({\n          description: \"Working directory used while loading harness configuration\",\n          minLength: 1,\n          maxLength: 4096,\n        }),\n      ),\n      timeoutSeconds: Type.Optional(\n        Type.Integer({\n          description: `Wall-clock budget in seconds (default ${RUN_TIMEOUT_DEFAULT_SECONDS})`,\n          minimum: 1,\n          maximum: 3600,\n        }),\n      ),\n    }),\n    run: closed({\n      id: harnessId(\"Harness id\"),\n      prompt: Type.String({\n        description: \"Prompt to send to the harness\",\n        minLength: 1,\n        maxLength: 100000,\n      }),\n      cwd: Type.Optional(\n        Type.String({\n          description: \"Working directory for the run\",\n          minLength: 1,\n          maxLength: 4096,\n        }),\n      ),\n      model: Type.Optional(\n        Type.String({\n          description: \"Harness-native model id or selector\",\n          minLength: 1,\n          maxLength: 512,\n        }),\n      ),\n      timeoutSeconds: Type.Optional(\n        Type.Integer({\n          description: `Wall-clock budget in seconds (default ${RUN_TIMEOUT_DEFAULT_SECONDS})`,\n          minimum: 1,\n          maximum: 3600,\n        }),\n      ),\n      structured: Type.Optional(\n        Type.Boolean({\n          description: \"Use the harness's structured (JSON) output mode instead of plain text\",\n        }),\n      ),\n      tools: Type.Boolean({\n        description:\n          \"Explicit execution mode. Set true when the task needs any harness tools, including Grok native X search. Set false only for an advisor without tools.\",\n      }),\n      readOnly: Type.Optional(\n        Type.Boolean({\n          description:\n            \"Set with tools=true to require native read-only tool enforcement. Unsupported harnesses reject the run instead of widening access.\",\n        }),\n      ),\n    }),\n    mcpList: closed({\n      id: Type.Optional(harnessId(\"Harness id; omit to list every harness\")),\n    }),\n    mcpSync: closed({\n      id: Type.Optional(harnessId(\"Harness id; omit to sync every harness\")),\n    }),\n    agentsSync: closed({\n      id: Type.Optional(harnessId(\"Harness id; omit to sync every harness\")),\n      check: Type.Optional(\n        Type.Boolean({ description: \"Report what would change without writing anything\" }),\n      ),\n    }),\n    promptsSync: closed({\n      id: Type.Optional(harnessId(\"Harness id; omit to sync every harness\")),\n      check: Type.Optional(\n        Type.Boolean({ description: \"Report what would change without writing anything\" }),\n      ),\n    }),\n    mcpAdd: closed({\n      id: harnessId(\"Harness id\"),\n      name: Type.String({\n        description: \"Server name\",\n        minLength: 1,\n        maxLength: 100,\n        pattern: \"^[A-Za-z0-9][A-Za-z0-9_-]*$\",\n      }),\n      command: Type.Optional(\n        Type.String({ description: \"Binary for a stdio server\", minLength: 1, maxLength: 4096 }),\n      ),\n      args: Type.Optional(\n        Type.Array(Type.String({ maxLength: 4096 }), {\n          description: \"Arguments for a stdio server\",\n          maxItems: 64,\n        }),\n      ),\n      env: Type.Optional(stringRecord(\"Environment variables for a stdio server\")),\n      url: Type.Optional(\n        Type.String({ description: \"URL for an http/sse server\", minLength: 1, maxLength: 4096 }),\n      ),\n      transport: Type.Optional(\n        Type.Union([Type.Literal(\"stdio\"), Type.Literal(\"http\"), Type.Literal(\"sse\")], {\n          description: \"Transport; inferred from url/command when omitted\",\n        }),\n      ),\n      headers: Type.Optional(stringRecord(\"Headers for an http/sse server\")),\n      scope,\n    }),\n    mcpRemove: closed({\n      id: harnessId(\"Harness id\"),\n      name: Type.String({\n        description: \"Server name\",\n        minLength: 1,\n        maxLength: 100,\n      }),\n      scope,\n    }),\n  };\n}\n\n/**\n * Parameter types matching the schemas above. The generic factory erases the\n * builders' literal types, so hosts annotate their execute callbacks with\n * these instead of TypeBox Static inference.\n */\nexport interface InfoParams {\n  id: string | string[];\n}\n\nexport interface ModelsParams {\n  id: string;\n  search?: string;\n  cwd?: string;\n  timeoutSeconds?: number;\n}\n\nexport interface RunParams {\n  id: string;\n  prompt: string;\n  cwd?: string;\n  model?: string;\n  timeoutSeconds?: number;\n  structured?: boolean;\n  tools: boolean;\n  readOnly?: boolean;\n}\n\nexport interface McpListParams {\n  id?: string;\n}\n\nexport interface McpSyncParams {\n  id?: string;\n}\n\nexport interface AgentsSyncParams {\n  id?: string;\n  check?: boolean;\n}\n\nexport interface PromptsSyncParams {\n  id?: string;\n  check?: boolean;\n}\n\nexport interface McpAddParams {\n  id: string;\n  name: string;\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n  url?: string;\n  transport?: \"stdio\" | \"http\" | \"sse\";\n  headers?: Record<string, string>;\n  scope?: \"user\" | \"project\";\n}\n\nexport interface McpRemoveParams {\n  id: string;\n  name: string;\n  scope?: \"user\" | \"project\";\n}\n"],"mappings":"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"}

package/dist/_chunks/types.mjs

@@ -1,4 +1,4 @@
-const version = "0.2.0";
+const version = "0.3.0";
 export { version };
 
 //# sourceMappingURL=types.mjs.map

package/dist/_chunks/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":["pkg.version"],"sources":["../../package.json","../../src/types.ts"],"sourcesContent":["","import pkg from \"../package.json\" with { type: \"json\" };\n\nexport const version: string = pkg.version;\n\nexport type HarnessId =\n  | \"antigravity\"\n  | \"codex\"\n  | \"gemini\"\n  | \"grok\"\n  | \"claude\"\n  | \"opencode\"\n  | \"cursor\"\n  | \"freebuff\"\n  | \"github-copilot\"\n  | \"mastracode\"\n  | \"omp\"\n  | \"pi\"\n  | \"prime-agent\";\nexport type EvidenceLevel = \"official\" | \"community\" | \"inferred\";\nexport type Platform = \"linux\" | \"darwin\" | \"win32\";\n\nexport interface PathCandidate {\n  path: string;\n  scope: \"user\" | \"project\" | \"system\" | \"data\";\n  level: EvidenceLevel;\n  platforms?: Platform[];\n  note?: string;\n}\n\nexport interface StorageDescriptor {\n  format: string;\n  level: EvidenceLevel;\n  note?: string;\n}\n\nexport interface HarnessCapabilities {\n  mcp: boolean;\n  vision: boolean;\n  /** Audio reaches the model without conversion or MCP. */\n  audio: boolean;\n  /** Video reaches the model without conversion or MCP. */\n  video: boolean;\n  tools: boolean;\n  streaming: boolean;\n}\n\n/** How to run one prompt through the harness non-interactively. */\nexport interface HarnessInvocation {\n  /** Binary to spawn; defaults to the harness's first `binaries` entry. */\n  binary?: string;\n  /** Full agent argument template; every \"{prompt}\" is replaced with the prompt text. */\n  args: string[];\n  /** Structured full agent argument template. */\n  jsonArgs?: string[];\n  /** Advisor argument template without tools; absent when the CLI cannot disable tools. */\n  noToolsArgs?: string[];\n  /** Structured advisor argument template without tools. */\n  noToolsJsonArgs?: string[];\n  /** Agent argument template whose native sandbox enforces read-only tool access. */\n  readOnlyArgs?: string[];\n  /** Structured agent argument template with read-only tool access. */\n  readOnlyJsonArgs?: string[];\n  /** Lowest CLI version whose read-only enforcement was verified; older or unknown versions reject read-only runs. */\n  readOnlyMinVersion?: string;\n  /** Arguments appended when a model is selected; every \"{model}\" is replaced. */\n  modelArgs?: string[];\n  level: EvidenceLevel;\n  note?: string;\n}\n\n/** Invocation modes a harness supports without fallback or prompt-only restrictions. */\nexport interface HarnessInvocationModes {\n  advisor: boolean;\n  advisorStructured: boolean;\n  readOnly: boolean;\n  readOnlyStructured: boolean;\n  agent: boolean;\n  agentStructured: boolean;\n}\n\n/** How to ask one harness CLI for the models currently available to it. */\nexport interface HarnessModelListing {\n  /** Arguments used when no search filter is supplied. */\n  args: string[];\n  /** Optional argument template for a search filter; every \"{search}\" is replaced. */\n  searchArgs?: string[];\n  level: EvidenceLevel;\n  note?: string;\n}\n\n/** One model normalized from a harness's native model-listing output. */\nexport interface AvailableModel {\n  provider: string;\n  id: string;\n  contextWindow: number;\n  maxOutputTokens: number;\n  thinking: boolean;\n  images: boolean;\n}\n\n/** Options for querying the models available to one harness. */\nexport interface ListModelsOptions {\n  search?: string;\n  cwd?: string;\n  env?: Record<string, string>;\n  /** Milliseconds before cleanup starts. Unset or 0 disables the deadline. */\n  timeoutMs?: number;\n  /** Cancel with the same process cleanup as a timeout. */\n  signal?: AbortSignal;\n}\n\nexport interface InvokeOptions {\n  cwd?: string;\n  env?: Record<string, string>;\n  /** Harness-native model id or selector. */\n  model?: string;\n  /** Enable the spawned harness's tools; defaults to advisor without tools mode. */\n  tools?: boolean;\n  /** Require native enforcement of read-only tool access. Implies `tools: true`. */\n  readOnly?: boolean;\n  /** Milliseconds before cleanup starts. Unset or 0 disables the deadline. */\n  timeoutMs?: number;\n  /** Cancel with the same process cleanup as a timeout. */\n  signal?: AbortSignal;\n  /** Use the harness's structured (JSON) output mode instead of plain text. */\n  structured?: boolean;\n}\n\nexport interface InvokeResult {\n  command: string;\n  args: string[];\n  stdout: string;\n  stderr: string;\n  /** Process exit code; null when terminated by a signal, timeout, or cancellation. */\n  exitCode: number | null;\n  timedOut: boolean;\n  /** True when caller cancellation wins over the deadline or completion. */\n  aborted: boolean;\n}\n\n/** Result of one native model-listing command. */\nexport interface ListModelsResult extends InvokeResult {\n  /** Empty on a successful no-match response or when the command itself failed. */\n  models: AvailableModel[];\n}\n\n/** Normalized MCP server entry, shared across every harness dialect. */\nexport interface McpServerConfig {\n  name: string;\n  transport: \"stdio\" | \"http\" | \"sse\";\n  command?: string;\n  args?: string[];\n  /**\n   * Environment for stdio servers. A value that is exactly \"${NAME}\" refers to\n   * the variable NAME of the harness environment: dialects with native\n   * references keep it, the others resolve it when the entry is written.\n   */\n  env?: Record<string, string>;\n  url?: string;\n  headers?: Record<string, string>;\n  /** Present only when the harness tracks an on/off state per server. */\n  enabled?: boolean;\n}\n\n/** How one harness config file stores its MCP servers. */\nexport interface McpConfigFile extends PathCandidate {\n  format: \"json\" | \"toml\";\n  /** Object path to the server map inside the file, e.g. [\"mcpServers\"]. */\n  key: string[];\n  /**\n   * Shape of individual entries; \"standard\" is the {command, args, env, url}\n   * family and \"prime\" is that family with env values as {\"env\": \"NAME\"} references.\n   */\n  dialect: \"standard\" | \"antigravity\" | \"opencode\" | \"prime\" | \"vscode\";\n}\n\nexport interface HarnessDetection {\n  /** Environment variables that indicate running inside this agent. */\n  envVars: string[];\n  /** Project-level files or directories whose presence indicates this agent. */\n  projectMarkers: string[];\n}\n\nexport interface ResolveOptions {\n  homeDir?: string;\n  projectRoot?: string;\n  platform?: Platform;\n}\n\nexport interface ResolvedPaths {\n  config: PathCandidate[];\n  sessions: PathCandidate[];\n  instructions: PathCandidate[];\n  skills: PathCandidate[];\n  commands: PathCandidate[];\n  hooks: PathCandidate[];\n}\n"],"mappings":"ACEA,MAAa,UAAkBA"}
+{"version":3,"file":"types.mjs","names":["pkg.version"],"sources":["../../package.json","../../src/types.ts"],"sourcesContent":["","import pkg from \"../package.json\" with { type: \"json\" };\n\nexport const version: string = pkg.version;\n\nexport type HarnessId =\n  | \"antigravity\"\n  | \"codex\"\n  | \"gemini\"\n  | \"grok\"\n  | \"claude\"\n  | \"opencode\"\n  | \"cursor\"\n  | \"freebuff\"\n  | \"github-copilot\"\n  | \"mastracode\"\n  | \"omp\"\n  | \"pi\"\n  | \"prime-agent\";\nexport type EvidenceLevel = \"official\" | \"community\" | \"inferred\";\nexport type Platform = \"linux\" | \"darwin\" | \"win32\";\n\nexport interface PathCandidate {\n  path: string;\n  scope: \"user\" | \"project\" | \"system\" | \"data\";\n  level: EvidenceLevel;\n  platforms?: Platform[];\n  note?: string;\n}\n\n/** The path lists of a harness descriptor, as named in {@link ResolvedPaths}. */\nexport type PathCategory =\n  | \"config\"\n  | \"sessions\"\n  | \"instructions\"\n  | \"skills\"\n  | \"commands\"\n  | \"promptTemplates\"\n  | \"hooks\"\n  | \"temp\";\n\n/**\n * An environment variable the harness reads to move one of its roots. `path`\n * is the default root, used while the variable is unset or empty.\n */\nexport interface EnvOverride extends PathCandidate {\n  variable: string;\n  /** Categories with entries under this root, which move with it. */\n  relocates: PathCategory[];\n}\n\n/** One stable user-scope destination used by prompt template synchronization. */\nexport interface PromptTemplateSyncTarget extends PathCandidate {\n  scope: \"user\";\n  format: \"markdown\" | \"gemini-toml\";\n}\n\nexport interface StorageDescriptor {\n  format: string;\n  level: EvidenceLevel;\n  note?: string;\n}\n\nexport interface HarnessCapabilities {\n  mcp: boolean;\n  vision: boolean;\n  /** Audio reaches the model without conversion or MCP. */\n  audio: boolean;\n  /** Video reaches the model without conversion or MCP. */\n  video: boolean;\n  tools: boolean;\n  streaming: boolean;\n}\n\n/** How to run one prompt through the harness non-interactively. */\nexport interface HarnessInvocation {\n  /** Binary to spawn; defaults to the harness's first `binaries` entry. */\n  binary?: string;\n  /** Full agent argument template; every \"{prompt}\" is replaced with the prompt text. */\n  args: string[];\n  /** Structured full agent argument template. */\n  jsonArgs?: string[];\n  /** Advisor argument template without tools; absent when the CLI cannot disable tools. */\n  noToolsArgs?: string[];\n  /** Structured advisor argument template without tools. */\n  noToolsJsonArgs?: string[];\n  /** Agent argument template whose native sandbox enforces read-only tool access. */\n  readOnlyArgs?: string[];\n  /** Structured agent argument template with read-only tool access. */\n  readOnlyJsonArgs?: string[];\n  /** Lowest CLI version whose read-only enforcement was verified; older or unknown versions reject read-only runs. */\n  readOnlyMinVersion?: string;\n  /** Arguments appended when a model is selected; every \"{model}\" is replaced. */\n  modelArgs?: string[];\n  /**\n   * Arguments appended to a plain text run so a CLI that holds its answer until\n   * the end reports it as events instead; `invoke` folds them back into that text,\n   * so a stopped run keeps what the model had already written.\n   */\n  streamArgs?: string[];\n  level: EvidenceLevel;\n  note?: string;\n}\n\n/** Invocation modes a harness supports without fallback or prompt-only restrictions. */\nexport interface HarnessInvocationModes {\n  advisor: boolean;\n  advisorStructured: boolean;\n  readOnly: boolean;\n  readOnlyStructured: boolean;\n  agent: boolean;\n  agentStructured: boolean;\n}\n\n/** How to ask one harness CLI for the models currently available to it. */\nexport interface HarnessModelListing {\n  /** Arguments used when no search filter is supplied. */\n  args: string[];\n  /**\n   * Optional argument template for a native search filter; every \"{search}\" is replaced.\n   * Without it, a search runs `args` and keeps the ids containing the filter, ignoring case.\n   */\n  searchArgs?: string[];\n  level: EvidenceLevel;\n  note?: string;\n}\n\n/** One model normalized from a harness's native model-listing output. */\nexport interface AvailableModel {\n  provider: string;\n  id: string;\n  /** Absent when the native listing prints only ids, like Grok's. */\n  contextWindow?: number;\n  maxOutputTokens?: number;\n  thinking?: boolean;\n  images?: boolean;\n  /** Set on the model the harness picks when no model is given, when the listing marks one. */\n  default?: boolean;\n}\n\n/** Options for querying the models available to one harness. */\nexport interface ListModelsOptions {\n  search?: string;\n  cwd?: string;\n  env?: Record<string, string>;\n  /** Milliseconds before cleanup starts. Unset or 0 disables the deadline. */\n  timeoutMs?: number;\n  /** Cancel with the same process cleanup as a timeout. */\n  signal?: AbortSignal;\n}\n\nexport interface InvokeOptions {\n  cwd?: string;\n  env?: Record<string, string>;\n  /** Harness-native model id or selector. */\n  model?: string;\n  /** Enable the spawned harness's tools; defaults to advisor without tools mode. */\n  tools?: boolean;\n  /** Require native enforcement of read-only tool access. Implies `tools: true` when `tools` is omitted; `tools: false` rejects the run. */\n  readOnly?: boolean;\n  /** Milliseconds before cleanup starts. Unset or 0 disables the deadline. */\n  timeoutMs?: number;\n  /** Cancel with the same process cleanup as a timeout. */\n  signal?: AbortSignal;\n  /** Use the harness's structured (JSON) output mode instead of plain text. */\n  structured?: boolean;\n}\n\nexport interface InvokeResult {\n  command: string;\n  args: string[];\n  stdout: string;\n  stderr: string;\n  /** Process exit code; null when terminated by a signal, timeout, or cancellation. */\n  exitCode: number | null;\n  timedOut: boolean;\n  /** True when caller cancellation wins over the deadline or completion. */\n  aborted: boolean;\n  /** Milliseconds without output on either stream before a deadline or cancellation stopped the process. */\n  idleMs?: number;\n}\n\n/** Result of one native model-listing command. */\nexport interface ListModelsResult extends InvokeResult {\n  /** Empty on a successful no-match response or when the command itself failed. */\n  models: AvailableModel[];\n}\n\n/** Normalized MCP server entry, shared across every harness dialect. */\nexport interface McpServerConfig {\n  name: string;\n  transport: \"stdio\" | \"http\" | \"sse\";\n  command?: string;\n  args?: string[];\n  /**\n   * Environment for stdio servers. A value that is exactly \"${NAME}\" refers to\n   * the variable NAME of the harness environment: dialects with native\n   * references keep it, the others resolve it when the entry is written.\n   */\n  env?: Record<string, string>;\n  url?: string;\n  headers?: Record<string, string>;\n  /** Present only when the harness tracks an on/off state per server. */\n  enabled?: boolean;\n}\n\n/** How one harness config file stores its MCP servers. */\nexport interface McpConfigFile extends PathCandidate {\n  format: \"json\" | \"toml\";\n  /** Object path to the server map inside the file, e.g. [\"mcpServers\"]. */\n  key: string[];\n  /**\n   * Shape of individual entries; \"standard\" is the {command, args, env, url}\n   * family, \"prime\" is that family with env values as {\"env\": \"NAME\"} references\n   * and \"mastracode\" is that family read by its keys alone, type ignored.\n   */\n  dialect: \"standard\" | \"antigravity\" | \"mastracode\" | \"opencode\" | \"prime\" | \"vscode\";\n}\n\nexport interface HarnessDetection {\n  /** Environment variables that indicate running inside this agent. */\n  envVars: string[];\n  /** Project-level files or directories whose presence indicates this agent. */\n  projectMarkers: string[];\n}\n\nexport interface ResolveOptions {\n  homeDir?: string;\n  projectRoot?: string;\n  platform?: Platform;\n  /** Replaces `os.tmpdir()` as the value of `${TMPDIR}`. */\n  tempDir?: string;\n}\n\nexport interface ResolvedPaths {\n  config: PathCandidate[];\n  sessions: PathCandidate[];\n  instructions: PathCandidate[];\n  skills: PathCandidate[];\n  commands: PathCandidate[];\n  promptTemplates: PathCandidate[];\n  promptTemplateSyncTarget: PromptTemplateSyncTarget | null;\n  hooks: PathCandidate[];\n  /** Temp roots, moved by a set `temp` override from {@link EnvOverride}. */\n  temp: PathCandidate[];\n}\n"],"mappings":"ACEA,MAAa,UAAkBA"}