@farming-labs/docs 0.2.61 → 0.2.63

package/dist/{agent-DFHlw_JC.mjs → agent-CQTH7NFu.mjs}

@@ -1,5 +1,5 @@
-import { Jt as normalizePageAgentFrontmatter, L as findDocsMarkdownPage, Zt as stripGeneratedPageAgentContractMarkdown, tt as renderDocsMarkdownDocument } from "./agent-Fl0pjVNF.mjs";
-import { _ as hashGeneratedAgentContent, b as serializeGeneratedAgentDocument, g as GENERATED_AGENT_PROVENANCE_VERSION, y as parseGeneratedAgentDocument } from "./search-9OnMGMvt.mjs";
+import { Jt as normalizePageAgentFrontmatter, L as findDocsMarkdownPage, Zt as stripGeneratedPageAgentContractMarkdown, tt as renderDocsMarkdownDocument } from "./agent-DKKptIgy.mjs";
+import { _ as GENERATED_AGENT_PROVENANCE_VERSION, b as parseGeneratedAgentDocument, v as hashGeneratedAgentContent, x as serializeGeneratedAgentDocument } from "./search-B6V6qtiI.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-Wcdj-D0a.mjs";
 import { createRequire } from "node:module";

package/dist/{agent-Fl0pjVNF.mjs → agent-DKKptIgy.mjs}

@@ -1,4 +1,4 @@
-import { C as buildDocsApiCatalog, D as isDocsStandardsDiscoveryRequest, O as resolveDocsDiscoveryApiRoute, T as createDocsStandardsResponse, a as DEFAULT_A2A_AGENT_CARD_ROUTE, c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, g as DEFAULT_API_CATALOG_ROUTE, h as DEFAULT_API_CATALOG_FORMAT, l as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, n as API_CATALOG_MEDIA_TYPE, o as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, r as API_CATALOG_PROFILE_URI, s as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, v as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE } from "./standards-discovery-C54V_aJH.mjs";
+import { C as buildDocsApiCatalog, E as createDocsStandardsResponse, O as isDocsStandardsDiscoveryRequest, a as DEFAULT_A2A_AGENT_CARD_ROUTE, c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, g as DEFAULT_API_CATALOG_ROUTE, h as DEFAULT_API_CATALOG_FORMAT, k as resolveDocsDiscoveryApiRoute, l as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, n as API_CATALOG_MEDIA_TYPE, o as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, r as API_CATALOG_PROFILE_URI, s as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, v as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE } from "./standards-discovery-jkykaXq1.mjs";
 import { createProcessor } from "@mdx-js/mdx";
 
 //#region src/mcp-auth.ts
@@ -2433,6 +2433,7 @@ function buildDocsDiagnostics(config, options = {}) {
 			agents: apiQueryRoute("format=agents"),
 			skill: apiQueryRoute("format=skill"),
 			search: search.enabled ? apiQueryRoute("query={query}") : null,
+			agentSearch: search.enabled ? apiQueryRoute("query={query}&audience=agent") : null,
 			askAi: ai.enabled ? apiRoute : null,
 			mcp: mcp.enabled ? mcp.route : null,
 			llmsTxt: llms.enabled ? DEFAULT_LLMS_TXT_ROUTE : null,
@@ -2463,6 +2464,14 @@ function buildDocsDiagnostics(config, options = {}) {
 				status: search.enabled ? "enabled" : "disabled",
 				reason: search.reason,
 				route: search.enabled ? apiQueryRoute("query={query}") : null,
+				routes: {
+					human: search.enabled ? apiQueryRoute("query={query}") : null,
+					agent: search.enabled ? apiQueryRoute("query={query}&audience=agent") : null
+				},
+				agentEndpoint: search.enabled ? apiQueryRoute("query={query}&audience=agent") : null,
+				audienceParam: "audience",
+				defaultAudience: "human",
+				supportedAudiences: ["human", "agent"],
 				provider: search.provider,
 				transport: "GET"
 			},
@@ -3662,7 +3671,7 @@ function renderDocsMarkdownNotFound({ entry = "docs", apiRoute, requestedPath, o
 			lines.push(`- [${match.title}](${match.markdownUrl}) (${confidence} confidence)${match.description ? ` - ${match.description}` : ""}`);
 		}
 	}
-	lines.push("", "## Recovery", "", "- If a closest match looks right, fetch that markdown URL directly.", "- If the match is uncertain, search the docs first and then fetch the smallest page that answers the task.", "- Use the sitemap routes below to browse the full docs index before guessing another slug.", "", "## Discovery Routes", "", "Use these discovery routes to find the right page:", "", `- Agent discovery spec: \`${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}\``, `- Agent discovery fallback: \`${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE}\``, `- Agent discovery API: \`${agentSpecApiRoute}\``, `- API catalog: \`${DEFAULT_API_CATALOG_ROUTE}\``, `- Agent Skills index: \`${DEFAULT_AGENT_SKILLS_INDEX_ROUTE}\``, `- Agent instructions: \`${DEFAULT_AGENTS_MD_ROUTE}\``, `- Search endpoint: \`${resolvedApiRoute}?query={query}\``, `- Docs index markdown: \`/${normalizedEntry}.md\``, `- Requested markdown API route: \`${requestedApiRoute}\``);
+	lines.push("", "## Recovery", "", "- If a closest match looks right, fetch that markdown URL directly.", "- If the match is uncertain, search the docs first and then fetch the smallest page that answers the task.", "- Use the sitemap routes below to browse the full docs index before guessing another slug.", "", "## Discovery Routes", "", "Use these discovery routes to find the right page:", "", `- Agent discovery spec: \`${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}\``, `- Agent discovery fallback: \`${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE}\``, `- Agent discovery API: \`${agentSpecApiRoute}\``, `- API catalog: \`${DEFAULT_API_CATALOG_ROUTE}\``, `- Agent Skills index: \`${DEFAULT_AGENT_SKILLS_INDEX_ROUTE}\``, `- Agent instructions: \`${DEFAULT_AGENTS_MD_ROUTE}\``, `- Agent search endpoint: \`${resolvedApiRoute}?query={query}&audience=agent\``, `- Docs index markdown: \`/${normalizedEntry}.md\``, `- Requested markdown API route: \`${requestedApiRoute}\``);
 	if (sitemapConfig.enabled) {
 		if (sitemapConfig.markdown.enabled) {
 			lines.push(`- Semantic sitemap: \`${sitemapConfig.markdown.route}\``);
@@ -3840,7 +3849,7 @@ function appendDocsMarkdownNegotiationStartLines(lines, context, variant) {
 }
 function appendDocsSearchStartLine(lines, context, variant) {
 	if (!context.searchEnabled) return;
-	lines.push(variant === "skill" ? `- Search with ${context.apiRoute}?query={query} when you do not know the page.` : `- Search with ${context.apiRoute}?query={query} when the route is unknown.`);
+	lines.push(variant === "skill" ? `- Search with ${context.apiRoute}?query={query}&audience=agent when you do not know the page.` : `- Search with ${context.apiRoute}?query={query}&audience=agent when the route is unknown.`);
 }
 function appendDocsOpenApiStartLine(lines, context, variant) {
 	if (!context.openapiConfig.enabled || !context.openapiConfig.url) return;
@@ -4178,9 +4187,13 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 		search: {
 			enabled: searchEnabled,
 			endpoint: apiQueryRoute("query={query}"),
+			agentEndpoint: apiQueryRoute("query={query}&audience=agent"),
 			method: "GET",
 			queryParam: "query",
-			localeParam: "lang"
+			localeParam: "lang",
+			audienceParam: "audience",
+			defaultAudience: "human",
+			supportedAudiences: ["human", "agent"]
 		},
 		agents: {
 			enabled: true,

package/dist/{agent-evals-f4_OL10T.mjs → agent-evals-B7MIxuEX.mjs}

@@ -1,4 +1,4 @@
-import { f as resolveSearchRequestConfig, p as findDocsMarkdownSection, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-9OnMGMvt.mjs";
+import { m as findDocsMarkdownSection, p as resolveSearchRequestConfig, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-B6V6qtiI.mjs";
 import { a as normalizeAgentScopeValues, i as normalizeAgentLocale, n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework, t as agentVersionConstraintMatches } from "./agent-scope-C_U--OZ7.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
 import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";

package/dist/{agent-export-D0zQhasD.mjs → agent-export-CBgWgPvH.mjs}

@@ -1,13 +1,13 @@
-import { $ as renderDocsAgentsDocument, At as buildDocsSitemapManifest, Ft as resolveDocsSitemapConfig, Nt as renderDocsSitemapMarkdown, Pt as renderDocsSitemapXml, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackConfig, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as renderDocsLlmsTxt, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, k as buildDocsAgentDiscoverySpec, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, tt as renderDocsMarkdownDocument, v as DEFAULT_LLMS_TXT_ROUTE, vt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-Fl0pjVNF.mjs";
-import { S as buildDocsAgentSkillsIndex, a as DEFAULT_A2A_AGENT_CARD_ROUTE, c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, k as resolveDocsPublishedAgentSkill, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, v as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, w as buildDocsLegacySkillsIndex, x as buildDocsA2AAgentCard, y as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-C54V_aJH.mjs";
-import "./search-9OnMGMvt.mjs";
+import { $ as renderDocsAgentsDocument, At as buildDocsSitemapManifest, Ft as resolveDocsSitemapConfig, Nt as renderDocsSitemapMarkdown, Pt as renderDocsSitemapXml, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackConfig, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as renderDocsLlmsTxt, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, k as buildDocsAgentDiscoverySpec, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, tt as renderDocsMarkdownDocument, v as DEFAULT_LLMS_TXT_ROUTE, vt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-DKKptIgy.mjs";
+import { A as resolveDocsPublishedAgentSkill, S as buildDocsAgentSkillsIndex, a as DEFAULT_A2A_AGENT_CARD_ROUTE, c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, v as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, w as buildDocsLegacySkillsIndex, x as buildDocsA2AAgentCard, y as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-jkykaXq1.mjs";
+import "./search-B6V6qtiI.mjs";
 import { t as resolveDocsI18n } from "./i18n-CCaFUnAN.mjs";
-import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-C08kDLsz.mjs";
-import "./sitemap-server-D_0Kzanj.mjs";
-import "./agent-evals-f4_OL10T.mjs";
+import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-BIpC4j4P.mjs";
+import "./sitemap-server-C_6Wes83.mjs";
+import "./agent-evals-B7MIxuEX.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-CIeBszxp.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-DraIb6FV.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";

package/dist/agent-skills-server-CPja6Syt.d.mts

@@ -0,0 +1,14 @@
+import { A as DocsPublishedAgentSkill } from "./standards-discovery-C4HUqMd2.mjs";
+import { P as DocsAgentSkillsInput } from "./types-lMBIdZg0.mjs";
+
+//#region src/agent-skills-server.d.ts
+interface ResolveConfiguredAgentSkillsOptions {
+  rootDir?: string;
+  workspaceRoot?: string;
+}
+/** Resolve and safely package all project skills configured through `agent.skills` synchronously. */
+declare function resolveConfiguredAgentSkillsSync(input: DocsAgentSkillsInput | undefined, options?: ResolveConfiguredAgentSkillsOptions): DocsPublishedAgentSkill[];
+/** Resolve and package configured skills without blocking runtime filesystem or compression work. */
+declare function resolveConfiguredAgentSkills(input: DocsAgentSkillsInput | undefined, options?: ResolveConfiguredAgentSkillsOptions): Promise<DocsPublishedAgentSkill[]>;
+//#endregion
+export { resolveConfiguredAgentSkills as n, resolveConfiguredAgentSkillsSync as r, ResolveConfiguredAgentSkillsOptions as t };

package/dist/{agent-skills-server-CIeBszxp.mjs → agent-skills-server-DraIb6FV.mjs}

@@ -1,8 +1,9 @@
-import { k as resolveDocsPublishedAgentSkill, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX } from "./standards-discovery-C54V_aJH.mjs";
+import { T as buildDocsPublishedAgentSkill, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX } from "./standards-discovery-jkykaXq1.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";
-import { gzipSync } from "node:zlib";
+import { access, lstat, readFile, readdir, realpath, stat } from "node:fs/promises";
+import { gzip, gzipSync } from "node:zlib";
 
 //#region src/agent-skills-server.ts
 const COMPANION_DIRECTORIES = new Set([
@@ -28,6 +29,24 @@ function findWorkspaceRoot(rootDir) {
 		current = parent;
 	}
 }
+async function pathExists(candidate) {
+	try {
+		await access(candidate);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function findWorkspaceRootAsync(rootDir) {
+	const resolvedRoot = await realpath(rootDir);
+	let current = resolvedRoot;
+	for (;;) {
+		if (await pathExists(path.join(current, ".git")) || await pathExists(path.join(current, "pnpm-workspace.yaml")) || await pathExists(path.join(current, "pnpm-workspace.yml"))) return current;
+		const parent = path.dirname(current);
+		if (parent === current) return resolvedRoot;
+		current = parent;
+	}
+}
 function normalizeConfiguredPaths(input) {
 	if (!input) return [];
 	const value = typeof input === "string" || Array.isArray(input) ? input : input.paths;
@@ -41,6 +60,14 @@ function resolveSafeConfiguredPath(configuredPath, rootDir, workspaceRoot) {
 	if (!isInside(workspaceRoot, resolved)) throw new Error(`Agent Skill symlink escapes the workspace: ${configuredPath}`);
 	return resolved;
 }
+async function resolveSafeConfiguredPathAsync(configuredPath, rootDir, workspaceRoot) {
+	const candidate = path.resolve(rootDir, configuredPath);
+	if (!await pathExists(candidate)) throw new Error(`Configured Agent Skill path does not exist: ${configuredPath}`);
+	if ((await lstat(candidate)).isSymbolicLink()) throw new Error(`Configured Agent Skill paths may not be symlinks: ${configuredPath}`);
+	const resolved = await realpath(candidate);
+	if (!isInside(workspaceRoot, resolved)) throw new Error(`Agent Skill symlink escapes the workspace: ${configuredPath}`);
+	return resolved;
+}
 function collectSkillDocuments(candidate, workspaceRoot, results, visited, depth = 0) {
 	if (depth > MAX_COLLECTION_DEPTH) throw new Error(`Agent Skill collection exceeds ${MAX_COLLECTION_DEPTH} directory levels.`);
 	const resolved = realpathSync(candidate);
@@ -70,6 +97,36 @@ function collectSkillDocuments(candidate, workspaceRoot, results, visited, depth
 		} else throw new Error(`Unsafe filesystem entry in Agent Skill collection: ${entryPath}`);
 	}
 }
+async function collectSkillDocumentsAsync(candidate, workspaceRoot, results, visited, depth = 0) {
+	if (depth > MAX_COLLECTION_DEPTH) throw new Error(`Agent Skill collection exceeds ${MAX_COLLECTION_DEPTH} directory levels.`);
+	const resolved = await realpath(candidate);
+	if (!isInside(workspaceRoot, resolved)) throw new Error(`Agent Skill symlink escapes the workspace: ${candidate}`);
+	if (visited.has(resolved)) return;
+	visited.add(resolved);
+	const info = await stat(resolved);
+	if (info.isFile()) {
+		if (path.basename(resolved) !== "SKILL.md") throw new Error(`Agent Skill file must be named SKILL.md: ${candidate}`);
+		results.add(resolved);
+		return;
+	}
+	if (!info.isDirectory()) throw new Error(`Agent Skill path must be a regular file or directory: ${candidate}`);
+	const directSkill = path.join(resolved, "SKILL.md");
+	if (await pathExists(directSkill)) {
+		const directInfo = await lstat(directSkill);
+		if (!directInfo.isFile() || directInfo.isSymbolicLink()) throw new Error(`Agent Skill SKILL.md must be a non-symlink regular file: ${directSkill}`);
+		results.add(directSkill);
+		return;
+	}
+	const entries = await readdir(resolved, { withFileTypes: true });
+	for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+		if (IGNORED_COLLECTION_DIRECTORIES.has(entry.name) || entry.name.startsWith(".") || COMPANION_DIRECTORIES.has(entry.name)) continue;
+		const entryPath = path.join(resolved, entry.name);
+		if (entry.isSymbolicLink()) throw new Error(`Agent Skill collections may not contain symlinks: ${entryPath}`);
+		else if (entry.isDirectory() || entry.isFile()) {
+			if (entry.isDirectory() || entry.name === "SKILL.md") await collectSkillDocumentsAsync(entryPath, workspaceRoot, results, visited, depth + 1);
+		} else throw new Error(`Unsafe filesystem entry in Agent Skill collection: ${entryPath}`);
+	}
+}
 function encodeSkillFileUrl(name, relativePath) {
 	const encodedPath = relativePath.split("/").map((segment) => encodeURIComponent(segment)).join("/");
 	return `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(name)}/${encodedPath}`;
@@ -161,6 +218,49 @@ function readCompanionFiles(skillDir, name, rootSkillBytes) {
 	}
 	return files;
 }
+async function readCompanionFilesAsync(skillDir, name, rootSkillBytes) {
+	const files = [];
+	let totalBytes = rootSkillBytes;
+	async function visit(absoluteDir, relativeDir, depth = 0) {
+		if (depth > MAX_COLLECTION_DEPTH) throw new Error(`Agent Skill companion tree exceeds ${MAX_COLLECTION_DEPTH} levels: ${skillDir}`);
+		const entries = await readdir(absoluteDir, { withFileTypes: true });
+		for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
+			const absolutePath = path.join(absoluteDir, entry.name);
+			const relativePath = path.posix.join(relativeDir, entry.name);
+			if (entry.isSymbolicLink()) throw new Error(`Agent Skill companion files may not be symlinks: ${absolutePath}`);
+			if (entry.isDirectory()) {
+				await visit(absolutePath, relativePath, depth + 1);
+				continue;
+			}
+			if (!entry.isFile()) throw new Error(`Unsafe filesystem entry in Agent Skill: ${absolutePath}`);
+			const executable = ((await stat(absolutePath)).mode & 73) !== 0;
+			const content = await readFile(absolutePath);
+			if (content.byteLength > MAX_FILE_BYTES) throw new Error(`Agent Skill file exceeds ${MAX_FILE_BYTES} bytes: ${absolutePath}`);
+			totalBytes += content.byteLength;
+			if (totalBytes > MAX_SKILL_BYTES || files.length >= MAX_FILES_PER_SKILL - 1) throw new Error(`Agent Skill exceeds safe publication limits: ${skillDir}`);
+			const mediaType = mediaTypeFor(relativePath);
+			const value = preserveFileBytes(content, mediaType);
+			const sha256 = hashBytes(value);
+			files.push({
+				path: relativePath,
+				url: encodeSkillFileUrl(name, relativePath),
+				mediaType,
+				content: value,
+				sha256,
+				digest: `sha256:${sha256}`,
+				executable
+			});
+		}
+	}
+	for (const directory of [...COMPANION_DIRECTORIES].sort()) {
+		const absoluteDir = path.join(skillDir, directory);
+		if (!await pathExists(absoluteDir)) continue;
+		const info = await lstat(absoluteDir);
+		if (info.isSymbolicLink() || !info.isDirectory()) throw new Error(`Agent Skill ${directory}/ must be a non-symlink directory: ${absoluteDir}`);
+		await visit(absoluteDir, directory);
+	}
+	return files;
+}
 function writeTarString(header, offset, length, value) {
 	const encoded = Buffer.from(value, "utf8");
 	if (encoded.byteLength > length) throw new Error(`Agent Skill archive path is too long: ${value}`);
@@ -184,7 +284,7 @@ function createTarHeader(name, size, executable) {
 	writeTarString(header, 148, 8, `${header.reduce((sum, byte) => sum + byte, 0).toString(8).padStart(6, "0")}\0 `);
 	return header;
 }
-function createDeterministicTarGzip(files) {
+function createDeterministicTar(files) {
 	const chunks = [];
 	let total = 0;
 	for (const file of [...files].sort(compareSkillFilePath)) {
@@ -206,19 +306,30 @@ function createDeterministicTarGzip(files) {
 		tar.set(chunk, offset);
 		offset += chunk.byteLength;
 	}
-	const archive = new Uint8Array(gzipSync(tar, { level: 9 }));
+	return tar;
+}
+function normalizeGzipArchive(content) {
+	const archive = new Uint8Array(content);
 	if (archive.byteLength > 9) archive[9] = 255;
 	return archive;
 }
-async function publishSkillDocument(skillPath) {
+function createDeterministicTarGzip(files) {
+	return normalizeGzipArchive(gzipSync(createDeterministicTar(files), { level: 9 }));
+}
+function createDeterministicTarGzipAsync(files) {
+	return new Promise((resolve, reject) => {
+		gzip(createDeterministicTar(files), { level: 9 }, (error, content) => {
+			if (error) reject(error);
+			else resolve(normalizeGzipArchive(content));
+		});
+	});
+}
+function publishSkillDocumentSync(skillPath) {
 	const skillDir = path.dirname(skillPath);
 	const skillDocument = readFileSync(skillPath, "utf8");
 	const skillDocumentBytes = Buffer.byteLength(skillDocument, "utf8");
 	if (skillDocumentBytes > MAX_FILE_BYTES) throw new Error(`Agent Skill SKILL.md exceeds ${MAX_FILE_BYTES} bytes: ${skillPath}`);
-	const base = await resolveDocsPublishedAgentSkill({
-		preferredDocument: skillDocument,
-		fallbackDocument: skillDocument
-	});
+	const base = buildDocsPublishedAgentSkill(skillDocument, hashBytes(skillDocument));
 	if (base.name !== path.basename(skillDir)) throw new Error(`Agent Skill frontmatter name "${base.name}" must match its directory "${path.basename(skillDir)}".`);
 	const companions = readCompanionFiles(skillDir, base.name, skillDocumentBytes);
 	const files = [...base.files, ...companions].sort(compareSkillFilePath);
@@ -240,8 +351,43 @@ async function publishSkillDocument(skillPath) {
 		files
 	};
 }
-/** Resolve and safely package all project skills configured through `agent.skills`. */
-async function resolveConfiguredAgentSkills(input, options = {}) {
+async function publishSkillDocumentAsync(skillPath) {
+	const skillDir = path.dirname(skillPath);
+	const skillDocument = await readFile(skillPath, "utf8");
+	const skillDocumentBytes = Buffer.byteLength(skillDocument, "utf8");
+	if (skillDocumentBytes > MAX_FILE_BYTES) throw new Error(`Agent Skill SKILL.md exceeds ${MAX_FILE_BYTES} bytes: ${skillPath}`);
+	const base = buildDocsPublishedAgentSkill(skillDocument, hashBytes(skillDocument));
+	if (base.name !== path.basename(skillDir)) throw new Error(`Agent Skill frontmatter name "${base.name}" must match its directory "${path.basename(skillDir)}".`);
+	const companions = await readCompanionFilesAsync(skillDir, base.name, skillDocumentBytes);
+	const files = [...base.files, ...companions].sort(compareSkillFilePath);
+	if (companions.length === 0) return {
+		...base,
+		files
+	};
+	const content = await createDeterministicTarGzipAsync(files);
+	const sha256 = hashBytes(content);
+	return {
+		name: base.name,
+		type: "archive",
+		description: base.description,
+		url: `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(base.name)}.tar.gz`,
+		digest: `sha256:${sha256}`,
+		content,
+		sha256,
+		skillDocument,
+		files
+	};
+}
+function validateAndSortSkills(published) {
+	const names = /* @__PURE__ */ new Set();
+	for (const skill of published) {
+		if (names.has(skill.name)) throw new Error(`Duplicate configured Agent Skill name: ${skill.name}`);
+		names.add(skill.name);
+	}
+	return published.sort((left, right) => left.name.localeCompare(right.name));
+}
+/** Resolve and safely package all project skills configured through `agent.skills` synchronously. */
+function resolveConfiguredAgentSkillsSync(input, options = {}) {
 	const configuredPaths = normalizeConfiguredPaths(input);
 	if (configuredPaths.length === 0) return [];
 	const rootDir = realpathSync(options.rootDir ?? process.cwd());
@@ -250,14 +396,20 @@ async function resolveConfiguredAgentSkills(input, options = {}) {
 	const documents = /* @__PURE__ */ new Set();
 	const visited = /* @__PURE__ */ new Set();
 	for (const configuredPath of configuredPaths) collectSkillDocuments(resolveSafeConfiguredPath(configuredPath, rootDir, workspaceRoot), workspaceRoot, documents, visited);
-	const published = await Promise.all([...documents].sort().map(publishSkillDocument));
-	const names = /* @__PURE__ */ new Set();
-	for (const skill of published) {
-		if (names.has(skill.name)) throw new Error(`Duplicate configured Agent Skill name: ${skill.name}`);
-		names.add(skill.name);
-	}
-	return published.sort((left, right) => left.name.localeCompare(right.name));
+	return validateAndSortSkills([...documents].sort().map(publishSkillDocumentSync));
+}
+/** Resolve and package configured skills without blocking runtime filesystem or compression work. */
+async function resolveConfiguredAgentSkills(input, options = {}) {
+	const configuredPaths = normalizeConfiguredPaths(input);
+	if (configuredPaths.length === 0) return [];
+	const rootDir = await realpath(options.rootDir ?? process.cwd());
+	const workspaceRoot = options.workspaceRoot === void 0 ? await findWorkspaceRootAsync(rootDir) : await realpath(options.workspaceRoot);
+	if (!isInside(workspaceRoot, rootDir)) throw new Error("Agent Skill rootDir must stay inside the configured workspace root.");
+	const documents = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new Set();
+	for (const configuredPath of configuredPaths) await collectSkillDocumentsAsync(await resolveSafeConfiguredPathAsync(configuredPath, rootDir, workspaceRoot), workspaceRoot, documents, visited);
+	return validateAndSortSkills(await Promise.all([...documents].sort().map(publishSkillDocumentAsync)));
 }
 
 //#endregion
-export { resolveConfiguredAgentSkills as t };
+export { resolveConfiguredAgentSkillsSync as n, resolveConfiguredAgentSkills as t };

package/dist/agent-skills-vite.d.mts

@@ -1,6 +1,6 @@
 import { A as DocsPublishedAgentSkill } from "./standards-discovery-C4HUqMd2.mjs";
-import { P as DocsAgentSkillsInput } from "./types-EhFhYGfr.mjs";
-import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-CKq3_jMj.mjs";
+import { P as DocsAgentSkillsInput } from "./types-lMBIdZg0.mjs";
+import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-CPja6Syt.mjs";
 
 //#region src/agent-skills-vite.d.ts
 declare const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";

package/dist/agent-skills-vite.mjs

@@ -1,5 +1,5 @@
-import "./standards-discovery-C54V_aJH.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-CIeBszxp.mjs";
+import "./standards-discovery-jkykaXq1.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-DraIb6FV.mjs";
 
 //#region src/agent-skills-vite.ts
 const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";

package/dist/{agents-ibnXrWyp.mjs → agents-XWZBub6f.mjs}

@@ -1,11 +1,11 @@
-import { $ as renderDocsAgentsDocument, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackConfig, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-Fl0pjVNF.mjs";
-import "./standards-discovery-C54V_aJH.mjs";
-import "./search-9OnMGMvt.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-D_0Kzanj.mjs";
-import "./agent-evals-f4_OL10T.mjs";
+import { $ as renderDocsAgentsDocument, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackConfig, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-DKKptIgy.mjs";
+import "./standards-discovery-jkykaXq1.mjs";
+import "./search-B6V6qtiI.mjs";
+import { S as resolveApiReferenceConfig } from "./sitemap-server-C_6Wes83.mjs";
+import "./agent-evals-B7MIxuEX.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-CIeBszxp.mjs";
+import "./agent-skills-server-DraIb6FV.mjs";
 import "./server.mjs";
 import { a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";

package/dist/cli/index.mjs

@@ -139,10 +139,10 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-DyPcoLwm.mjs");
+		const { runMcp } = await import("../mcp-B9dcsivk.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-DFHlw_JC.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-CQTH7NFu.mjs").then((n) => n.t);
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -150,7 +150,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-D0zQhasD.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-CBgWgPvH.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -160,13 +160,13 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-DFHlw_JC.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-D0zQhasD.mjs");
+		const { printAgentCompactHelp } = await import("../agent-CQTH7NFu.mjs").then((n) => n.t);
+		const { printAgentExportHelp } = await import("../agent-export-CBgWgPvH.mjs");
 		printAgentCompactHelp();
 		printAgentExportHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-ibnXrWyp.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-XWZBub6f.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -176,11 +176,11 @@ async function main() {
 	} else if (parsedCommand.command === "agents") {
 		console.error(pc.red(`Unknown agents subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentsGenerateHelp } = await import("../agents-ibnXrWyp.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-XWZBub6f.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CXostbsI.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CJqtzKZT.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -188,7 +188,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-D2UBrxFq.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-Fndl5brR.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -210,7 +210,7 @@ async function main() {
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-CNsRpz90.mjs");
+		const { syncSearch } = await import("../search-DSjCeOk7.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -218,7 +218,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BpYnSsfJ.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-Cykpe3Tz.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -228,11 +228,11 @@ async function main() {
 	} else if (parsedCommand.command === "sitemap") {
 		console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSitemapGenerateHelp } = await import("../sitemap-BpYnSsfJ.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-Cykpe3Tz.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-5Yqz9mz7.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-CUTahhoY.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -242,7 +242,7 @@ async function main() {
 	} else if (parsedCommand.command === "robots") {
 		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printRobotsGenerateHelp } = await import("../robots-5Yqz9mz7.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-CUTahhoY.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {

package/dist/client/react.d.mts

@@ -1,4 +1,4 @@
-import { R as DocsAnalyticsConfig } from "../types-EhFhYGfr.mjs";
+import { R as DocsAnalyticsConfig } from "../types-lMBIdZg0.mjs";
 import { ReactNode } from "react";
 
 //#region src/docs-cloud-client.d.ts

package/dist/{cloud-ask-ai-D7ZgF47y.d.mts → cloud-ask-ai-zpwkdwnF.d.mts}

@@ -1,4 +1,4 @@
-import { Q as DocsCloudConfig, R as DocsAnalyticsConfig, t as AIConfig } from "./types-EhFhYGfr.mjs";
+import { Q as DocsCloudConfig, R as DocsAnalyticsConfig, t as AIConfig } from "./types-lMBIdZg0.mjs";
 
 //#region src/cloud-ask-ai.d.ts
 interface DocsCloudAskAIConfig {

package/dist/docs-cloud-server.d.mts

@@ -1,5 +1,5 @@
-import { B as DocsAnalyticsEventInput, R as DocsAnalyticsConfig, z as DocsAnalyticsEvent } from "./types-EhFhYGfr.mjs";
-import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-D7ZgF47y.mjs";
+import { B as DocsAnalyticsEventInput, R as DocsAnalyticsConfig, z as DocsAnalyticsEvent } from "./types-lMBIdZg0.mjs";
+import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-zpwkdwnF.mjs";
 
 //#region src/docs-cloud-server.d.ts
 type DocsCloudRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);

package/dist/{doctor-CXostbsI.mjs → doctor-CJqtzKZT.mjs}

@@ -1,19 +1,19 @@
-import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-DFHlw_JC.mjs";
-import { l as httpLinkHeaderHasTargetRelation } from "./reading-time-C-SAhQT9.mjs";
-import { Dt as DEFAULT_SITEMAP_MD_ROUTE, Ft as resolveDocsSitemapConfig, Ht as PAGE_AGENT_CONTRACT_FIELDS, N as buildDocsMcpEndpointCandidates, Ot as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, dn as normalizeDocsMcpAuthorizationServerUrls, en as DEFAULT_MCP_PUBLIC_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, in as getDocsMcpProtectedResourceMetadataRoutes, j as buildDocsConfigMap, k as buildDocsAgentDiscoverySpec, kt as DEFAULT_SITEMAP_XML_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, sn as isDocsMcpOAuthScopeToken, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-Fl0pjVNF.mjs";
-import { O as resolveDocsDiscoveryApiRoute, c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, g as DEFAULT_API_CATALOG_ROUTE, h as DEFAULT_API_CATALOG_FORMAT, l as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, n as API_CATALOG_MEDIA_TYPE, p as DEFAULT_AGENT_SKILL_FORMAT, r as API_CATALOG_PROFILE_URI, s as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX } from "./standards-discovery-C54V_aJH.mjs";
-import { d as resolveAskAISearchRequestConfig } from "./search-9OnMGMvt.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-C08kDLsz.mjs";
-import { a as resolveDocsMetadataBaseUrl } from "./metadata-Dv1ah0Aj.mjs";
-import "./sitemap-server-D_0Kzanj.mjs";
-import { t as runDocsGoldenTasks } from "./agent-evals-f4_OL10T.mjs";
+import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-CQTH7NFu.mjs";
+import { l as httpLinkHeaderHasTargetRelation } from "./reading-time-CYZ5VvKU.mjs";
+import { Dt as DEFAULT_SITEMAP_MD_ROUTE, Ft as resolveDocsSitemapConfig, Ht as PAGE_AGENT_CONTRACT_FIELDS, N as buildDocsMcpEndpointCandidates, Ot as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, dn as normalizeDocsMcpAuthorizationServerUrls, en as DEFAULT_MCP_PUBLIC_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, in as getDocsMcpProtectedResourceMetadataRoutes, j as buildDocsConfigMap, k as buildDocsAgentDiscoverySpec, kt as DEFAULT_SITEMAP_XML_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, sn as isDocsMcpOAuthScopeToken, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-DKKptIgy.mjs";
+import { c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, g as DEFAULT_API_CATALOG_ROUTE, h as DEFAULT_API_CATALOG_FORMAT, k as resolveDocsDiscoveryApiRoute, l as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, n as API_CATALOG_MEDIA_TYPE, p as DEFAULT_AGENT_SKILL_FORMAT, r as API_CATALOG_PROFILE_URI, s as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX } from "./standards-discovery-jkykaXq1.mjs";
+import { d as resolveAskAISearchRequestConfig } from "./search-B6V6qtiI.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-BIpC4j4P.mjs";
+import { a as resolveDocsMetadataBaseUrl } from "./metadata-DWExHQnx.mjs";
+import "./sitemap-server-C_6Wes83.mjs";
+import { t as runDocsGoldenTasks } from "./agent-evals-B7MIxuEX.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-CIeBszxp.mjs";
+import "./agent-skills-server-DraIb6FV.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, r as extractTopLevelConfigObject, s as loadDocsConfigModuleResultWithProjectEnv, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
-import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CBZ_JZjf.mjs";
+import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-Dsvh0etV.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";

package/dist/{golden-evaluations-CBZ_JZjf.mjs → golden-evaluations-Dsvh0etV.mjs}

@@ -1,4 +1,4 @@
-import { Jt as normalizePageAgentFrontmatter, qt as hasStructuredPageAgentContract, wt as resolveDocsAudienceMdxContent, xt as findDocsAudienceMdxTags } from "./agent-Fl0pjVNF.mjs";
+import { Jt as normalizePageAgentFrontmatter, qt as hasStructuredPageAgentContract, wt as resolveDocsAudienceMdxContent, xt as findDocsAudienceMdxTags } from "./agent-DKKptIgy.mjs";
 import { n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework } from "./agent-scope-C_U--OZ7.mjs";
 import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
@@ -1394,6 +1394,11 @@ function analyzeAgentSurfaceDrift(options) {
 	compareExpectedValue(issues, options.discovery, "search-enabled-mismatch", "search.enabled", options.expected.search.enabled, "Discovery search.enabled");
 	compareExpectedValue(issues, options.discovery, "search-capability-mismatch", "capabilities.search", options.expected.search.enabled, "Discovery capabilities.search");
 	compareExpectedValue(issues, options.discovery, "search-route-mismatch", "search.endpoint", options.expected.search.endpoint, "Discovery search.endpoint");
+	const expectedAgentSearchEndpoint = options.expected.search.endpoint === null ? null : `${options.expected.search.endpoint}${options.expected.search.endpoint.includes("?") ? "&" : "?"}audience=agent`;
+	compareExpectedValue(issues, options.discovery, "search-audience-mismatch", "search.agentEndpoint", expectedAgentSearchEndpoint, "Discovery search.agentEndpoint");
+	compareExpectedValue(issues, options.discovery, "search-audience-mismatch", "search.audienceParam", "audience", "Discovery search.audienceParam");
+	compareExpectedValue(issues, options.discovery, "search-audience-mismatch", "search.defaultAudience", "human", "Discovery search.defaultAudience");
+	compareExpectedValue(issues, options.discovery, "search-audience-mismatch", "search.supportedAudiences", ["human", "agent"], "Discovery search.supportedAudiences");
 	compareExpectedValue(issues, options.discovery, "mcp-enabled-mismatch", "mcp.enabled", options.expected.mcp.enabled, "Discovery mcp.enabled");
 	compareExpectedValue(issues, options.discovery, "mcp-capability-mismatch", "capabilities.mcp", options.expected.mcp.enabled, "Discovery capabilities.mcp");
 	compareExpectedValue(issues, options.discovery, "mcp-route-mismatch", "mcp.endpoint", options.expected.mcp.endpoint, "Discovery mcp.endpoint");