@agntn/harnesses 0.0.1

package/dist/_chunks/tool-operations.mjs

@@ -0,0 +1,361 @@
+import { addMcpServer, getAllHarnesses, getHarness, isHarnessId, listHarnesses, listMcpServers, readAgentsConfig, readMasterMcpServers, removeMcpServer, syncAgentsFiles, syncMcpServers } from "./agents-sync.mjs";
+import "./tool-schemas.mjs";
+import { encode } from "@toon-format/toon";
+const RUN_DEFAULT_TIMEOUT_SECONDS = 600;
+const RUN_MAX_OUTPUT_CHARS = 8e3;
+function text(data) {
+	return [{
+		type: "text",
+		text: encode(data)
+	}];
+}
+function unknownHarness(id) {
+	const details = {
+		error: `Unknown harness: ${id}`,
+		known: listHarnesses()
+	};
+	return {
+		content: text(details),
+		details,
+		isError: true
+	};
+}
+function errorMessage(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+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",
+	agent: "advisor",
+	agentStructured: "advisorStructured"
+};
+function selectedInvocationMode(structured, tools, readOnly) {
+	if (readOnly) return structured ? "readOnlyStructured" : "readOnly";
+	if (tools) return structured ? "agentStructured" : "agent";
+	return structured ? "advisorStructured" : "advisor";
+}
+function completedRun(harness, result, options) {
+	const details = {
+		id: harness.id,
+		command: result.command,
+		args: result.args,
+		...options.model === void 0 ? {} : { model: options.model },
+		structured: options.structured,
+		tools: options.tools,
+		readOnly: options.readOnly,
+		exitCode: result.exitCode,
+		timedOut: result.timedOut,
+		stdout: truncate(result.stdout),
+		stderr: truncate(result.stderr)
+	};
+	if (result.timedOut || result.exitCode !== 0) return {
+		content: text(details),
+		details,
+		isError: true
+	};
+	return {
+		content: text(details),
+		details
+	};
+}
+function unsupportedInvocation(harness, id, options) {
+	const error = harness.invocationError(options) ?? `Invalid ${id} invocation`;
+	const invocationModes = harness.invocationModes;
+	const mode = selectedInvocationMode(options.structured, options.tools, options.readOnly);
+	const modelUnsupported = options.model !== void 0 && harness.invocation?.modelArgs === void 0;
+	if (invocationModes[mode] || harness.invocation === null || modelUnsupported) {
+		const details = { error };
+		return {
+			content: text(details),
+			details,
+			isError: true
+		};
+	}
+	const alternateMode = ALTERNATE_INVOCATION_MODE[mode];
+	const details = {
+		error,
+		invocationModes,
+		...(alternateMode === void 0 ? false : invocationModes[alternateMode]) ? { retry: { tools: !options.tools } } : {}
+	};
+	return {
+		content: text(details),
+		details,
+		isError: true
+	};
+}
+function detectHarnesses() {
+	const details = { harnesses: getAllHarnesses().map((harness) => {
+		const installed = harness.isInstalled();
+		return {
+			id: harness.id,
+			name: harness.name,
+			installed,
+			version: installed ? harness.version : null
+		};
+	}) };
+	return {
+		content: text(details),
+		details
+	};
+}
+function harnessInfoResult(id) {
+	if (!isHarnessId(id)) return unknownHarness(id).details;
+	const harness = getHarness(id);
+	return {
+		id: harness.id,
+		name: harness.name,
+		binaries: harness.binaries,
+		capabilities: harness.capabilities,
+		invocationModes: harness.invocationModes,
+		modelListing: harness.modelListing !== null,
+		modelSelection: harness.invocation?.modelArgs !== void 0,
+		config: harness.config,
+		sessions: harness.sessions,
+		instructions: harness.instructions,
+		skills: harness.skills,
+		commands: harness.commands,
+		hooks: harness.hooks,
+		persistence: harness.persistence,
+		detection: harness.detection,
+		resolved: harness.resolve()
+	};
+}
+function harnessInfo(input) {
+	if (typeof input === "string") {
+		const details = harnessInfoResult(input);
+		return {
+			content: text(details),
+			details,
+			..."error" in details ? { isError: true } : {}
+		};
+	}
+	if (input.length < 1 || input.length > 20) {
+		const details = { error: `harnesses_info accepts between 1 and 20 ids` };
+		return {
+			content: text(details),
+			details,
+			isError: true
+		};
+	}
+	const details = input.map(harnessInfoResult);
+	return {
+		content: text(details),
+		details,
+		...details.some((result) => "error" in result) ? { isError: true } : {}
+	};
+}
+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);
+		return {
+			content: text(details),
+			details,
+			isError: true
+		};
+	}
+	const timeoutSeconds = options.timeoutSeconds ?? RUN_DEFAULT_TIMEOUT_SECONDS;
+	let result;
+	try {
+		result = await harness.listModels({
+			search: options.search,
+			cwd: options.cwd,
+			timeoutMs: timeoutSeconds * 1e3
+		});
+	} catch (error) {
+		const details = { error: `Failed to list ${id} models: ${errorMessage(error)}` };
+		return {
+			content: text(details),
+			details,
+			isError: true
+		};
+	}
+	const details = {
+		id: harness.id,
+		command: result.command,
+		args: result.args,
+		...options.search === void 0 ? {} : { search: options.search },
+		models: result.models,
+		exitCode: result.exitCode,
+		timedOut: result.timedOut,
+		stderr: truncate(result.stderr)
+	};
+	return {
+		content: text(details),
+		details,
+		...result.timedOut || result.exitCode !== 0 ? { isError: true } : {}
+	};
+}
+function normalizedRunAccess(options) {
+	const readOnly = options.readOnly ?? false;
+	return {
+		readOnly,
+		tools: readOnly ? true : options.tools ?? false
+	};
+}
+async function runHarness(id, prompt, options = {}) {
+	if (!isHarnessId(id)) return unknownHarness(id);
+	const harness = getHarness(id);
+	const structured = options.structured ?? false;
+	const { tools, readOnly } = normalizedRunAccess(options);
+	const invocationOptions = {
+		model: options.model,
+		structured,
+		tools,
+		readOnly
+	};
+	if (!harness.buildInvocation(prompt, invocationOptions)) return unsupportedInvocation(harness, id, invocationOptions);
+	const timeoutSeconds = options.timeoutSeconds ?? RUN_DEFAULT_TIMEOUT_SECONDS;
+	let result;
+	try {
+		result = await harness.invoke(prompt, {
+			cwd: options.cwd,
+			model: options.model,
+			timeoutMs: timeoutSeconds * 1e3,
+			structured,
+			tools,
+			readOnly
+		});
+	} catch (error) {
+		const details = { error: `Failed to run ${id}: ${errorMessage(error)}` };
+		return {
+			content: text(details),
+			details,
+			isError: true
+		};
+	}
+	return completedRun(harness, result, invocationOptions);
+}
+function toMcpServerConfig(params) {
+	const server = {
+		name: params.name,
+		transport: params.transport ?? (params.url ? "http" : "stdio")
+	};
+	if (params.command !== void 0) server.command = params.command;
+	if (params.args !== void 0) server.args = params.args;
+	if (params.env !== void 0) server.env = params.env;
+	if (params.url !== void 0) server.url = params.url;
+	if (params.headers !== void 0) server.headers = params.headers;
+	return server;
+}
+function mcpList(id) {
+	if (id !== void 0 && !isHarnessId(id)) return unknownHarness(id);
+	const details = { harnesses: (id !== void 0 && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses()).map((harness) => ({
+		id: harness.id,
+		configs: listMcpServers(harness)
+	})).filter((entry) => entry.configs.length > 0) };
+	return {
+		content: text(details),
+		details
+	};
+}
+function mcpMutate(id, mutate) {
+	if (!isHarnessId(id)) return unknownHarness(id);
+	try {
+		const { path, action } = mutate(getHarness(id));
+		const details = {
+			id,
+			path,
+			action
+		};
+		return {
+			content: text(details),
+			details,
+			...action === "noop" ? { isError: true } : {}
+		};
+	} catch (error) {
+		const details = { error: errorMessage(error) };
+		return {
+			content: text(details),
+			details,
+			isError: true
+		};
+	}
+}
+function mcpAdd(id, params, scope = "user") {
+	return mcpMutate(id, (harness) => {
+		const { path, replaced } = addMcpServer(harness, toMcpServerConfig(params), scope);
+		return {
+			path,
+			action: replaced ? "replaced" : "added"
+		};
+	});
+}
+function mcpRemove(id, name, scope = "user") {
+	return mcpMutate(id, (harness) => {
+		const { path, removed } = removeMcpServer(harness, name, scope);
+		return {
+			path,
+			action: removed ? "removed" : "noop"
+		};
+	});
+}
+function mcpSync(id) {
+	if (id !== void 0 && !isHarnessId(id)) return unknownHarness(id);
+	try {
+		const unknown = readMasterMcpServers().excludes.filter((entry) => !isHarnessId(entry));
+		if (unknown.length > 0) {
+			const details = {
+				error: `Master MCP list excludes unknown harnesses: ${unknown.join(", ")}`,
+				known: listHarnesses()
+			};
+			return {
+				content: text(details),
+				details,
+				isError: true
+			};
+		}
+		const details = syncMcpServers(id !== void 0 && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses());
+		return {
+			content: text(details),
+			details
+		};
+	} catch (error) {
+		const details = { error: errorMessage(error) };
+		return {
+			content: text(details),
+			details,
+			isError: true
+		};
+	}
+}
+function agentsSync(id, check = false) {
+	if (id !== void 0 && !isHarnessId(id)) return unknownHarness(id);
+	try {
+		const unknown = readAgentsConfig().excludes.filter((entry) => !isHarnessId(entry));
+		if (unknown.length > 0) {
+			const details = {
+				error: `Agents config excludes unknown harnesses: ${unknown.join(", ")}`,
+				known: listHarnesses()
+			};
+			return {
+				content: text(details),
+				details,
+				isError: true
+			};
+		}
+		const details = syncAgentsFiles(id !== void 0 && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses(), check);
+		return {
+			content: text(details),
+			details
+		};
+	} catch (error) {
+		const details = { error: errorMessage(error) };
+		return {
+			content: text(details),
+			details,
+			isError: true
+		};
+	}
+}
+export { RUN_DEFAULT_TIMEOUT_SECONDS, RUN_MAX_OUTPUT_CHARS, agentsSync, detectHarnesses, harnessInfo, listHarnessModels, mcpAdd, mcpList, mcpRemove, mcpSync, runHarness, toMcpServerConfig };
+
+//# sourceMappingURL=tool-operations.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-operations.mjs","names":["toToon"],"sources":["../../src/tool-operations.ts"],"sourcesContent":["/**\n * Tool executors behind the agent extensions.\n *\n * Each executor returns the text a caller reads plus the structured details a\n * harness can attach to the call. The text is TOON-encoded so the model sees\n * the same compact shape the CLI's --toon flag prints.\n */\nimport { encode as toToon } from \"@toon-format/toon\";\nimport { getAllHarnesses, getHarness, isHarnessId, listHarnesses } from \"./registry.ts\";\nimport {\n  addMcpServer,\n  listMcpServers,\n  readMasterMcpServers,\n  removeMcpServer,\n  syncMcpServers,\n} from \"./mcp-servers.ts\";\nimport type { McpConfigListing, SyncReport } from \"./mcp-servers.ts\";\nimport { readAgentsConfig, syncAgentsFiles } from \"./agents-sync.ts\";\nimport type { AgentsSyncReport } from \"./agents-sync.ts\";\nexport type { AgentsSyncReport } from \"./agents-sync.ts\";\nexport type { SyncReport } from \"./mcp-servers.ts\";\nexport type { HarnessInvocationModes } from \"./types.ts\";\nimport type { Harness } from \"./harness.ts\";\nimport type {\n  AvailableModel,\n  HarnessCapabilities,\n  HarnessDetection,\n  HarnessId,\n  HarnessInvocationModes,\n  InvokeResult,\n  ListModelsResult,\n  McpServerConfig,\n  PathCandidate,\n  ResolvedPaths,\n  StorageDescriptor,\n} from \"./types.ts\";\n\n/** Text for the model plus details for the harness, shared by every tool surface. */\nexport interface ToolResult<Details> {\n  content: Array<{ type: \"text\"; text: string }>;\n  details: Details;\n  /** Set when the tool could not answer. */\n  isError?: boolean;\n}\n\n/** Install state of one harness on this machine. */\nexport interface HarnessStatus {\n  id: HarnessId;\n  name: string;\n  installed: boolean;\n  version: string | null;\n}\n\n/** Every registered harness with its install state, as scanned by {@link detectHarnesses}. */\nexport interface HarnessListing {\n  harnesses: HarnessStatus[];\n}\n\n/** Full metadata for one harness, including paths resolved for this platform. */\nexport interface HarnessMetadata {\n  id: HarnessId;\n  name: string;\n  binaries: string[];\n  capabilities: HarnessCapabilities;\n  invocationModes: HarnessInvocationModes;\n  modelListing: boolean;\n  modelSelection: boolean;\n  config: PathCandidate[];\n  sessions: PathCandidate[];\n  instructions: PathCandidate[];\n  skills: PathCandidate[];\n  commands: PathCandidate[];\n  hooks: PathCandidate[];\n  persistence: StorageDescriptor[];\n  detection: HarnessDetection;\n  resolved: ResolvedPaths;\n}\n\n/** Returned when the requested harness id is not registered. */\nexport interface UnknownHarness {\n  error: string;\n  known: HarnessId[];\n}\n\n/** Returned when a direct batch call bypasses the tool schema limits. */\nexport interface HarnessInfoInputError {\n  error: string;\n}\n\n/** One harness lookup result. */\nexport type HarnessInfoResult = HarnessMetadata | UnknownHarness;\n\n/** Scalar, batch, or rejected batch details from {@link harnessInfo}. */\nexport type HarnessInfoDetails = HarnessInfoResult | HarnessInfoResult[] | HarnessInfoInputError;\n\nimport { HARNESS_INFO_MAX_ITEMS, RUN_TIMEOUT_DEFAULT_SECONDS } from \"./tool-schemas.ts\";\nexport { HARNESS_INFO_MAX_ITEMS } from \"./tool-schemas.ts\";\n\n/** Default wall-clock budget for one harness run, in seconds. */\nexport const RUN_DEFAULT_TIMEOUT_SECONDS = RUN_TIMEOUT_DEFAULT_SECONDS;\n\n/** The run tool's per-stream cap: harness output is unbounded, model context is not. */\nexport const RUN_MAX_OUTPUT_CHARS = 8000;\n\nfunction text(data: unknown): Array<{ type: \"text\"; text: string }> {\n  return [{ type: \"text\", text: toToon(data) }];\n}\n\nfunction unknownHarness(id: string): ToolResult<UnknownHarness> {\n  const details: UnknownHarness = { error: `Unknown harness: ${id}`, known: listHarnesses() };\n  return { content: text(details), details, isError: true };\n}\n\nfunction errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nfunction truncate(output: string): string {\n  if (output.length <= RUN_MAX_OUTPUT_CHARS) return output;\n  return `${output.slice(0, RUN_MAX_OUTPUT_CHARS)}\\n[truncated ${output.length - RUN_MAX_OUTPUT_CHARS} of ${output.length} characters]`;\n}\n\nfunction modelListingUnavailable(harness: Harness, id: string): RunFailure {\n  return {\n    error: harness.modelListing\n      ? `Harness ${id} does not support filtering its model listing`\n      : `Harness ${id} does not support model listing`,\n  };\n}\n\ntype RunInvocationOptions = Readonly<{\n  model?: string;\n  structured: boolean;\n  tools: boolean;\n  readOnly: boolean;\n}>;\n\ntype InvocationMode = keyof HarnessInvocationModes;\n\nconst ALTERNATE_INVOCATION_MODE: Partial<Record<InvocationMode, InvocationMode>> = {\n  advisor: \"agent\",\n  advisorStructured: \"agentStructured\",\n  agent: \"advisor\",\n  agentStructured: \"advisorStructured\",\n};\n\nfunction selectedInvocationMode(\n  structured: boolean,\n  tools: boolean,\n  readOnly: boolean,\n): InvocationMode {\n  if (readOnly) return structured ? \"readOnlyStructured\" : \"readOnly\";\n  if (tools) return structured ? \"agentStructured\" : \"agent\";\n  return structured ? \"advisorStructured\" : \"advisor\";\n}\n\nfunction completedRun(\n  harness: Harness,\n  result: InvokeResult,\n  options: RunInvocationOptions,\n): ToolResult<RunOutcome> {\n  const details: RunOutcome = {\n    id: harness.id,\n    command: result.command,\n    args: result.args,\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    stdout: truncate(result.stdout),\n    stderr: truncate(result.stderr),\n  };\n  if (result.timedOut || result.exitCode !== 0) {\n    return { content: text(details), details, isError: true };\n  }\n  return { content: text(details), details };\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 alternateMode = ALTERNATE_INVOCATION_MODE[mode];\n  const alternateAvailable = alternateMode === undefined ? false : invocationModes[alternateMode];\n  const details: RunFailure = {\n    error,\n    invocationModes,\n    ...(alternateAvailable ? { retry: { tools: !options.tools } } : {}),\n  };\n  return { content: text(details), details, isError: true };\n}\n\n/**\n * Scans every registered harness for its binaries and version.\n *\n * @returns {ToolResult<HarnessListing>} The complete installation listing.\n */\nexport function detectHarnesses(): ToolResult<HarnessListing> {\n  const details: HarnessListing = {\n    harnesses: getAllHarnesses().map((harness) => {\n      const installed = harness.isInstalled();\n      return {\n        id: harness.id,\n        name: harness.name,\n        installed,\n        version: installed ? harness.version : null,\n      };\n    }),\n  };\n\n  return { content: text(details), details };\n}\n\nfunction harnessInfoResult(id: string): HarnessInfoResult {\n  if (!isHarnessId(id)) return unknownHarness(id).details;\n\n  const harness = getHarness(id);\n  return {\n    id: harness.id,\n    name: harness.name,\n    binaries: harness.binaries,\n    capabilities: harness.capabilities,\n    invocationModes: harness.invocationModes,\n    modelListing: harness.modelListing !== null,\n    modelSelection: harness.invocation?.modelArgs !== undefined,\n    config: harness.config,\n    sessions: harness.sessions,\n    instructions: harness.instructions,\n    skills: harness.skills,\n    commands: harness.commands,\n    hooks: harness.hooks,\n    persistence: harness.persistence,\n    detection: harness.detection,\n    resolved: harness.resolve(),\n  };\n}\n\n/** 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 { content: text(details), details, ...(\"error\" in details ? { isError: true } : {}) };\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),\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}\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  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    });\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    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  /** 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  args: string[];\n  model?: string;\n  structured: boolean;\n  tools: boolean;\n  readOnly: boolean;\n  exitCode: number | null;\n  timedOut: 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?: { 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, and\n * caps the echoed output.\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  if (!harness.buildInvocation(prompt, invocationOptions)) {\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      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);\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/** 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) => ({ id: harness.id, configs: listMcpServers(harness) }))\n      .filter((entry) => entry.configs.length > 0),\n  };\n\n  return { content: text(details), details };\n}\n\nfunction mcpMutate(\n  id: string,\n  mutate: (harness: Harness) => { path: string; action: McpMutation[\"action\"] },\n): ToolResult<McpMutation | RunFailure> {\n  if (!isHarnessId(id)) return unknownHarness(id);\n\n  try {\n    const { path, action } = mutate(getHarness(id));\n    const details: McpMutation = { id, path, action };\n    return { content: text(details), details, ...(action === \"noop\" ? { isError: true } : {}) };\n  } catch (error) {\n    const details: RunFailure = { error: errorMessage(error) };\n    return { content: text(details), details, isError: true };\n  }\n}\n\n/**\n * Adds or replaces one MCP server in a harness's config.\n *\n * @param id - Target harness id.\n * @param params - Server parameters to normalize and write.\n * @param scope - User or project config scope.\n * @returns {ToolResult<McpMutation | RunFailure>} The mutation outcome or failure.\n */\nexport function mcpAdd(\n  id: string,\n  params: McpServerParams,\n  scope: \"user\" | \"project\" = \"user\",\n): ToolResult<McpMutation | RunFailure> {\n  return mcpMutate(id, (harness) => {\n    const { path, replaced } = addMcpServer(harness, toMcpServerConfig(params), scope);\n    return { path, action: replaced ? \"replaced\" : \"added\" };\n  });\n}\n\n/**\n * Removes one MCP server from a harness's config.\n *\n * @param id - Target harness id.\n * @param name - Server name to remove.\n * @param scope - User or project config scope.\n * @returns {ToolResult<McpMutation | RunFailure>} The mutation outcome or failure.\n */\nexport function mcpRemove(\n  id: string,\n  name: string,\n  scope: \"user\" | \"project\" = \"user\",\n): ToolResult<McpMutation | RunFailure> {\n  return mcpMutate(id, (harness) => {\n    const { path, removed } = removeMcpServer(harness, name, scope);\n    return { path, action: removed ? \"removed\" : \"noop\" };\n  });\n}\n\n/**\n * Pushes the master MCP list from ~/.config/agntn/mcp.jsonc into harness configs.\n *\n * @param id - Optional harness id; omission targets every harness.\n * @returns {ToolResult<SyncReport | RunFailure>} The sync report or failure.\n */\nexport function mcpSync(id?: string): ToolResult<SyncReport | RunFailure> {\n  if (id !== undefined && !isHarnessId(id)) return unknownHarness(id);\n\n  try {\n    // Preflight before any write: a typo in excludes must fail the whole run,\n    // not silently leave the misspelled harness unprotected.\n    const unknown = readMasterMcpServers().excludes.filter((entry) => !isHarnessId(entry));\n    if (unknown.length > 0) {\n      const details: RunFailure = {\n        error: `Master MCP list excludes unknown harnesses: ${unknown.join(\", \")}`,\n        known: listHarnesses(),\n      };\n      return { content: text(details), details, isError: true };\n    }\n    const details = syncMcpServers(\n      id !== undefined && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses(),\n    );\n    return { content: text(details), details };\n  } catch (error) {\n    const details: RunFailure = { error: errorMessage(error) };\n    return { content: text(details), details, isError: true };\n  }\n}\n\n/**\n * Links every harness's global instructions file to the master AGENTS.md.\n *\n * @param id - Optional harness id; omission targets every harness.\n * @param check - Report intended changes without writing them.\n * @returns {ToolResult<AgentsSyncReport | RunFailure>} The sync report or failure.\n */\nexport function agentsSync(id?: string, check = false): ToolResult<AgentsSyncReport | RunFailure> {\n  if (id !== undefined && !isHarnessId(id)) return unknownHarness(id);\n\n  try {\n    // Preflight before any write: a typo in excludes must fail the whole run,\n    // not silently adopt the harness it was meant to protect.\n    const unknown = readAgentsConfig().excludes.filter((entry) => !isHarnessId(entry));\n    if (unknown.length > 0) {\n      const details: RunFailure = {\n        error: `Agents config excludes unknown harnesses: ${unknown.join(\", \")}`,\n        known: listHarnesses(),\n      };\n      return { content: text(details), details, isError: true };\n    }\n    const details = syncAgentsFiles(\n      id !== undefined && isHarnessId(id) ? [getHarness(id)] : getAllHarnesses(),\n      check,\n    );\n    return { content: text(details), details };\n  } catch (error) {\n    const details: RunFailure = { error: errorMessage(error) };\n    return { content: text(details), details, isError: true };\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,94 @@
+/**
+ * Tool parameter schemas shared by every surface (MCP server, Pi and OMP
+ * extensions). Each surface owns a different TypeBox build (the extensions
+ * must use their host's facade), so the schemas are a factory over a minimal
+ * structural builder instead of importing typebox here.
+ */
+/**
+ * The subset of the TypeBox builder the tool schemas need. `I` is the schema
+ * type the builder accepts as input, `S` the (possibly narrower) type it
+ * returns; OMP's facade accepts its own `AnySchema` while producing schemas
+ * that satisfy the host's stricter `TSchema`.
+ */
+interface McpSchemaBuilder<I, S> {
+  Object(properties: Readonly<Record<string, I>>, options?: object): S;
+  String(options?: object): I;
+  Integer(options?: object): I;
+  Boolean(options?: object): I;
+  Array(item: I, options?: object): I;
+  Record(key: I, value: I, options?: object): I;
+  Union(schemas: readonly I[], options?: object): I;
+  Literal(value: string, options?: object): I;
+  Optional(schema: I): I;
+}
+declare const HARNESS_INFO_MAX_ITEMS = 20;
+declare const RUN_TIMEOUT_DEFAULT_SECONDS = 600;
+/**
+ * Builds the parameter schemas for all harness tools with the host's TypeBox.
+ *
+ * @param Type - Host-provided TypeBox-compatible schema builder.
+ * @returns {Record<string, S>} Schemas keyed by harness tool operation.
+ */
+declare function harnessToolSchemas<I, S>(Type: McpSchemaBuilder<I, S>): {
+  detect: S;
+  info: S;
+  models: S;
+  run: S;
+  mcpList: S;
+  mcpSync: S;
+  agentsSync: S;
+  mcpAdd: S;
+  mcpRemove: S;
+};
+/**
+ * Parameter types matching the schemas above. The generic factory erases the
+ * builders' literal types, so hosts annotate their execute callbacks with
+ * these instead of TypeBox Static inference.
+ */
+interface InfoParams {
+  id: string | string[];
+}
+interface ModelsParams {
+  id: string;
+  search?: string;
+  cwd?: string;
+  timeoutSeconds?: number;
+}
+interface RunParams {
+  id: string;
+  prompt: string;
+  cwd?: string;
+  model?: string;
+  timeoutSeconds?: number;
+  structured?: boolean;
+  tools: boolean;
+  readOnly?: boolean;
+}
+interface McpListParams {
+  id?: string;
+}
+interface McpSyncParams {
+  id?: string;
+}
+interface AgentsSyncParams {
+  id?: string;
+  check?: boolean;
+}
+interface McpAddParams {
+  id: string;
+  name: string;
+  command?: string;
+  args?: string[];
+  env?: Record<string, string>;
+  url?: string;
+  transport?: "stdio" | "http" | "sse";
+  headers?: Record<string, string>;
+  scope?: "user" | "project";
+}
+interface McpRemoveParams {
+  id: string;
+  name: string;
+  scope?: "user" | "project";
+}
+export { AgentsSyncParams, HARNESS_INFO_MAX_ITEMS, InfoParams, McpAddParams, McpListParams, McpRemoveParams, McpSchemaBuilder, McpSyncParams, ModelsParams, RUN_TIMEOUT_DEFAULT_SECONDS, RunParams, harnessToolSchemas };
+//# sourceMappingURL=tool-schemas.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schemas.d.mts","names":[],"sources":["../../src/tool-schemas.ts"],"mappings":"AAaA;;;;;;;;;;;;UAAiB,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;;cAGV;cACA;;;;;;;iBAQG,mBAAmB,GAAG,GAAG,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;UA2JlD;EACf;;UAGe;EACf;EACA;EACA;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;UAGe;EACf;;UAGe;EACf;;UAGe;EACf;EACA;;UAGe;EACf;EACA;EACA;EACA;EACA,MAAM;EACN;EACA;EACA,UAAU;EACV;;UAGe;EACf;EACA;EACA"}

package/dist/_chunks/tool-schemas.mjs

@@ -0,0 +1,112 @@
+const HARNESS_INFO_MAX_ITEMS = 20;
+const RUN_TIMEOUT_DEFAULT_SECONDS = 600;
+function harnessToolSchemas(Type) {
+	const harnessId = (description) => Type.String({
+		description,
+		minLength: 1,
+		maxLength: 50,
+		pattern: "^[a-z][a-z0-9-]*$"
+	});
+	const stringRecord = (description) => Type.Record(Type.String({ maxLength: 256 }), Type.String({ maxLength: 4096 }), { description });
+	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"), {
+			minItems: 1,
+			maxItems: 20
+		})], { description: "Harness id, or a list of ids to inspect in one call" }) }),
+		models: Type.Object({
+			id: harnessId("Harness id"),
+			search: Type.Optional(Type.String({
+				description: "Optional native model search filter",
+				minLength: 1,
+				maxLength: 1024
+			})),
+			cwd: Type.Optional(Type.String({
+				description: "Working directory used while loading harness configuration",
+				minLength: 1,
+				maxLength: 4096
+			})),
+			timeoutSeconds: Type.Optional(Type.Integer({
+				description: `Wall-clock budget in seconds (default 600)`,
+				minimum: 1,
+				maximum: 3600
+			}))
+		}),
+		run: Type.Object({
+			id: harnessId("Harness id"),
+			prompt: Type.String({
+				description: "Prompt to send to the harness",
+				minLength: 1,
+				maxLength: 1e5
+			}),
+			cwd: Type.Optional(Type.String({
+				description: "Working directory for the run",
+				minLength: 1,
+				maxLength: 4096
+			})),
+			model: Type.Optional(Type.String({
+				description: "Harness-native model id or selector",
+				minLength: 1,
+				maxLength: 512
+			})),
+			timeoutSeconds: Type.Optional(Type.Integer({
+				description: `Wall-clock budget in seconds (default 600)`,
+				minimum: 1,
+				maximum: 3600
+			})),
+			structured: Type.Optional(Type.Boolean({ description: "Use the harness's structured (JSON) output mode instead of plain text" })),
+			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({
+			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({
+			id: harnessId("Harness id"),
+			name: Type.String({
+				description: "Server name",
+				minLength: 1,
+				maxLength: 100,
+				pattern: "^[A-Za-z0-9][A-Za-z0-9_-]*$"
+			}),
+			command: Type.Optional(Type.String({
+				description: "Binary for a stdio server",
+				minLength: 1,
+				maxLength: 4096
+			})),
+			args: Type.Optional(Type.Array(Type.String({ maxLength: 4096 }), {
+				description: "Arguments for a stdio server",
+				maxItems: 64
+			})),
+			env: Type.Optional(stringRecord("Environment variables for a stdio server")),
+			url: Type.Optional(Type.String({
+				description: "URL for an http/sse server",
+				minLength: 1,
+				maxLength: 4096
+			})),
+			transport: Type.Optional(Type.Union([
+				Type.Literal("stdio"),
+				Type.Literal("http"),
+				Type.Literal("sse")
+			], { description: "Transport; inferred from url/command when omitted" })),
+			headers: Type.Optional(stringRecord("Headers for an http/sse server")),
+			scope
+		}),
+		mcpRemove: Type.Object({
+			id: harnessId("Harness id"),
+			name: Type.String({
+				description: "Server name",
+				minLength: 1,
+				maxLength: 100
+			}),
+			scope
+		})
+	};
+}
+export { HARNESS_INFO_MAX_ITEMS, RUN_TIMEOUT_DEFAULT_SECONDS, harnessToolSchemas };
+
+//# sourceMappingURL=tool-schemas.mjs.map

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

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

package/dist/_chunks/types.mjs

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