@agntn/harnesses 0.2.1 → 0.3.0

package/dist/_chunks/tool-operations.mjs

@@ -28,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",
@@ -81,7 +78,8 @@ function completedRun(harness, result, options, templateArgs) {
 		readOnly: options.readOnly,
 		exitCode: result.exitCode,
 		timedOut: result.timedOut,
-		aborted: result.aborted
+		aborted: result.aborted,
+		...result.idleMs === void 0 ? {} : { idleMs: result.idleMs }
 	};
 	const stdout = truncate(result.stdout);
 	const stderr = truncate(result.stderr);
@@ -163,6 +161,8 @@ function harnessInfoResult(id) {
 		promptTemplates: harness.promptTemplates,
 		promptTemplateSyncTarget: harness.promptTemplateSyncTarget,
 		hooks: harness.hooks,
+		temp: harness.temp,
+		envOverrides: harness.envOverrides,
 		persistence: harness.persistence,
 		detection: harness.detection,
 		resolved: harness.resolve()
@@ -170,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,
@@ -179,6 +179,7 @@ function harnessInfoText(result) {
 		invocationModes,
 		modelListing,
 		modelSelection,
+		envOverrides: getHarness(id).resolveCandidates(envOverrides),
 		persistence,
 		detection,
 		resolved
@@ -212,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,
@@ -236,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 {
@@ -257,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 = {}) {

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. 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  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  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\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  };\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    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<\n      HarnessMetadata,\n      | \"config\"\n      | \"sessions\"\n      | \"instructions\"\n      | \"skills\"\n      | \"commands\"\n      | \"promptTemplates\"\n      | \"promptTemplateSyncTarget\"\n      | \"hooks\"\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.\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\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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"}
+{"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;

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;;;;;;;;;;;;;;;;;iBAiKlD;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"}
+{"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,17 +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" }))
 		}),
-		promptsSync: 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: Type.Object({
+		mcpAdd: closed({
 			id: harnessId("Harness id"),
 			name: Type.String({
 				description: "Server name",
@@ -100,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    promptsSync: 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 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":"AAyBA,MAAa,yBAAyB;AACtC,MAAa,8BAA8B;;;;;;EAQ3C,SAAgB;CACd,CAAA;CACgB,MAAA,gBAAA,gBAAA,KAAA,OAAA,KAAA,OAAA,EAAA,WAAA,IAAA,CAAA,GAAA,KAAA,OAAA,EAAA,WAAA,KAAA,CAAA,GAAA,EAAA,YAAA,CAAA;CAAa,MAAA,QAAW,KAAA,SAAA,KAAA,MAAA,CAAA,KAAA,QAAA,MAAA,GAAA,KAAA,QAAA,SAAA,CAAA,GAAA,EAAA,aAAA,6CAAA,CAAA,CAAA;CAAG,OAAA;EAAe,QAAA,KAAS,OAAA,CAAA,CAAA;EAAqB,MAAA,KAAA,OAAA,EAAA,IAAA,KAAA,MAAA,CAAA,UAAA,YAAA,GAAA,KAAA,MAAA,UAAA,YAAA,GAAA;GAExF,UAAM;GAKN,UAAM;EAMN,CAAA,CAAA,GAAA,EAAO,aAAA,sDAAA,CAAA,EAAA,CAAA;EACL,QAAQ,KAAK,OAAO;GACpB,IAAA,UAAW,YACL;GAIE,QAAA,KAAU,SAAA,KAAA,OAAA;IACV,aAAA;IAEJ,WACE;IAGN,WAAa;GACX,CAAA,CAAA;GACA,KAAA,KAAQ,SAAK,KACX,OAAK;IACH,aAAa;IACb,WAAW;IACX,WAAW;GACb,CAAC,CACH;GACA,gBAAU,KACR,SAAK,KAAO,QAAA;IACV,aAAa;IACb,SAAA;IACA,SAAA;GACF,CAAC,CACH;EACA,CAAA;EAEI,KAAA,KAAA,OAAa;GACb,IAAA,UAAS,YAAA;GACT,QAAA,KAAS,OAAA;IACV,aACH;IACD,WAAA;IACD,WAAU;GACR,CAAA;GACA,KAAA,KAAQ,SAAK,KAAO,OAAA;IAClB,aAAa;IACb,WAAW;IACX,WAAW;GACb,CAAC,CAAA;GACD,OAAK,KAAK,SACR,KAAK,OAAO;IACV,aAAa;IACb,WAAW;IACX,WAAW;GACb,CAAC,CACH;GACA,gBAAY,KACV,SAAK,KAAO,QAAA;IACV,aAAa;IACb,SAAA;IACA,SAAA;GACF,CAAC,CACH;GACA,YAAA,KAAgB,SAAK,KACnB,QAAK,EAAA,aAAQ,wEAAA,CAAA,CAAA;GACX,OAAA,KAAA,QAAa,EAAA,aAAA,wJAAqE,CAAA;GAClF,UAAS,KAAA,SAAA,KAAA,QAAA,EAAA,aAAA,qIAAA,CAAA,CAAA;EACT,CAAA;EACF,SACF,KAAA,OAAA,EAAA,IAAA,KAAA,SAAA,UAAA,wCAAA,CAAA,EAAA,CAAA;EACA,SAAA,KAAY,OAAK,EAAA,IACf,KAAK,SAAQ,UACX,wCAAa,CAAA,EAAA,CAAA;EAGjB,YAAO,KAAK,OACV;GAGF,IAAA,KAAA,SAAe,UACb,wCAEI,CAAA;GAGP,OAAA,KAAA,SAAA,KAAA,QAAA,EAAA,aAAA,oDAAA,CAAA,CAAA;EACD,CAAA;EAGA,aAAS,KAAK,OACZ;GAEF,IAAA,KAAA,SAAiB,UAAO,wCAAA,CAAA;GACtB,OAAI,KAAK,SAAS,KAAA,QAAU,EAAA,aAAA,oDAAyC,CAAA,CAAA;EACrE,CAAA;EAGF,QAAC,KAAA,OAAA;GACD,IAAA,UAAa,YAAY;GACvB,MAAI,KAAK,OAAS;IAClB,aAAY;IAGb,WAAA;IACD,WAAa;IACX,SAAI;GACJ,CAAA;GACE,SAAA,KAAa,SAAA,KAAA,OAAA;IACb,aAAW;IACX,WAAW;IACX,WAAS;GACX,CAAC,CAAA;GACD,MAAA,KAAS,SAAK,KACZ,MAAK,KAAO,OAAA,EAAA,WAAA,KAAA,CAAA,GAAA;IAAE,aAAa;IAA6B,UAAA;GAAc,CAAA,CAAA;GAAgB,KACxF,KAAA,SAAA,aAAA,0CAAA,CAAA;GACA,KAAA,KAAM,SAAK,KACT,OAAW;IACT,aAAa;IACb,WAAU;IACX,WACH;GACA,CAAA,CAAA;GACA,WAAU,KAAA,SACH,KAAA,MAAO;IAAE,KAAA,QAAa,OAAA;IAA8B,KAAA,QAAW,MAAA;IAAG,KAAA,QAAW,KAAA;GAAK,GACzF,EAAA,aAAA,oDAAA,CAAA,CAAA;GACA,SAAA,KAAW,SAAK,aACH,gCAAA,CAAA;GAAC;EAAuB,CAAA;EAAsB,WAAK,KAAQ,OAAK;GAAC,IAAG,UAC7E,YAAa;GAGjB,MAAA,KAAS,OAAK;IACd,aAAA;IACD,WAAA;IACD,WAAW;GACT,CAAA;GACA;EACE,CAAA;CACA;AACA;AAEF,SAAA,wBAAA,6BAAA"}
+{"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.1";
+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\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  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, \"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}\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}\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"}

package/dist/cli.mjs

@@ -80,16 +80,21 @@ function modelFailureMessage(details) {
 	return "error" in details ? details.error : "Failed to list models";
 }
 function modelDescription(model) {
+	const parts = [];
+	if (model.default) parts.push("default");
+	if (model.contextWindow !== void 0) parts.push(`${model.contextWindow} context`);
+	if (model.maxOutputTokens !== void 0) parts.push(`${model.maxOutputTokens} max-out`);
 	const features = [];
 	if (model.thinking) features.push("thinking");
 	if (model.images) features.push("images");
-	const suffix = features.length > 0 ? ` · ${features.join(", ")}` : "";
-	return `${model.contextWindow} context · ${model.maxOutputTokens} max-out${suffix}`;
+	if (features.length > 0) parts.push(features.join(", "));
+	return parts.join(" · ");
 }
 function renderModels(details) {
+	const harness = getHarness(details.id);
 	consola.log(header(`${details.id} models`));
 	consola.log("");
-	for (const model of details.models) consola.log(entry(`${s.hi(`${model.provider}/${model.id}`)}  ${s.dim(modelDescription(model))}`));
+	for (const model of details.models) consola.log(entry(`${s.hi(harness.modelSelector(model))}  ${s.dim(modelDescription(model))}`));
 	if (details.models.length === 0) consola.log(entry(s.dim("No models found")));
 	consola.log("");
 }
@@ -97,7 +102,8 @@ function finishInvocation(result, timeoutSeconds) {
 	if (result.stdout) process.stdout.write(result.stdout);
 	if (result.stderr) process.stderr.write(result.stderr);
 	if (result.timedOut) {
-		consola.error(`Timed out after ${timeoutSeconds}s`);
+		const idle = result.idleMs === void 0 ? "" : `; last output ${Math.round(result.idleMs / 1e3)}s before`;
+		consola.error(`Timed out after ${timeoutSeconds}s${idle}`);
 		process.exit(124);
 	}
 	process.exit(result.exitCode ?? 1);
@@ -166,6 +172,8 @@ const info = defineCommand({
 			commands: harness.commands,
 			promptTemplates: harness.promptTemplates,
 			hooks: harness.hooks,
+			temp: harness.temp,
+			envOverrides: harness.envOverrides,
 			persistence: harness.persistence,
 			detection: harness.detection
 		}, args)) return;
@@ -191,6 +199,11 @@ const info = defineCommand({
 		renderPathSection("Commands", harness.commands);
 		renderPathSection("Prompt templates", harness.promptTemplates);
 		renderPathSection("Hooks", harness.hooks);
+		renderPathSection("Temp", harness.temp);
+		renderPathSection("Env overrides", harness.envOverrides.map((e) => ({
+			...e,
+			path: `${e.variable}  ${s.dim(`${e.path} → ${e.relocates.join(", ")}`)}`
+		})));
 		if (harness.persistence.length) {
 			consola.log(section("Persistence"));
 			for (const e of harness.persistence) {
@@ -219,6 +232,7 @@ const paths = defineCommand({
 		renderResolvedPathSection("Commands", resolved.commands);
 		renderResolvedPathSection("Prompt templates", resolved.promptTemplates);
 		renderResolvedPathSection("Hooks", resolved.hooks);
+		renderResolvedPathSection("Temp", resolved.temp);
 		consola.log("");
 	}
 });
@@ -296,14 +310,14 @@ const run = defineCommand({
 		},
 		"read-only": {
 			type: "boolean",
-			description: "Require native read-only tool enforcement; implies --tools"
+			description: "Require native read-only tool enforcement; implies --tools, rejected with --no-tools"
 		}
 	},
 	async run({ args }) {
 		const harness = resolveHarness(args.id);
 		const structured = args.json === true;
 		const readOnly = args["read-only"] === true;
-		const tools = readOnly || args.tools === true;
+		const tools = args.tools ?? readOnly;
 		const invocationOptions = {
 			model: args.model,
 			structured,