@farming-labs/docs 0.2.69 → 0.2.71

package/dist/{reading-time-O8mYgLvH.mjs → reading-time-DtNegNiq.mjs}

@@ -1,6 +1,7 @@
-import { Dt as DEFAULT_SITEMAP_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, kt as DEFAULT_SITEMAP_XML_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-D2SsSct2.mjs";
-import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-DSVKdQrl.mjs";
-import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-Dz5XeT8F.mjs";
+import { Ft as DEFAULT_SITEMAP_XML_ROUTE, Nt as DEFAULT_SITEMAP_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, un as DEFAULT_MCP_WELL_KNOWN_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-FIyl4-Oa.mjs";
+import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
+import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-CYfiQE13.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-DOqBwQw8.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts
@@ -160,6 +161,91 @@ function extendTheme(baseTheme, extensions) {
 	return deepMerge(baseTheme, extensions);
 }
 
+//#endregion
+//#region src/agent-skills-archive.ts
+const TAR_BLOCK_BYTES = 512;
+const TAR_NAME_BYTES = 100;
+const TAR_PREFIX_OFFSET = 345;
+const TAR_PREFIX_BYTES = 155;
+const AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES = 10 * 1024 * 1024;
+const AGENT_SKILL_DOCUMENT_MAX_BYTES = 1024 * 1024;
+function isZeroBlock(block) {
+	return block.every((byte) => byte === 0);
+}
+function readTarText(header, offset, length, field) {
+	const bytes = header.subarray(offset, offset + length);
+	const terminator = bytes.indexOf(0);
+	const value = terminator < 0 ? bytes : bytes.subarray(0, terminator);
+	try {
+		return new TextDecoder("utf-8", { fatal: true }).decode(value);
+	} catch {
+		throw new Error(`Agent Skill archive has invalid UTF-8 in its ${field}.`);
+	}
+}
+function readTarOctal(header, offset, length, field) {
+	const value = readTarText(header, offset, length, field).trim();
+	if (!/^[0-7]+$/u.test(value)) throw new Error(`Agent Skill archive has an invalid ${field}.`);
+	const parsed = Number.parseInt(value, 8);
+	if (!Number.isSafeInteger(parsed) || parsed < 0) throw new Error(`Agent Skill archive has an unsafe ${field}.`);
+	return parsed;
+}
+function validateTarChecksum(header) {
+	const expected = readTarOctal(header, 148, 8, "header checksum");
+	if (header.reduce((sum, byte, index) => {
+		return sum + (index >= 148 && index < 156 ? 32 : byte);
+	}, 0) !== expected) throw new Error("Agent Skill archive has an invalid tar header checksum.");
+}
+/**
+* Extract the root SKILL.md from an uncompressed Agent Skill tar archive.
+*
+* Only the regular-file payload is returned; duplicate, oversized, malformed,
+* or non-UTF-8 documents are rejected before frontmatter validation.
+*/
+function readAgentSkillDocumentFromTar(archive) {
+	if (archive.byteLength > AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES) throw new Error(`Agent Skill archive exceeds ${AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES} uncompressed bytes.`);
+	let skillDocument;
+	let offset = 0;
+	let foundEndOfArchive = false;
+	while (offset < archive.byteLength) {
+		if (offset + TAR_BLOCK_BYTES > archive.byteLength) throw new Error("Agent Skill archive contains a truncated tar header.");
+		const header = archive.subarray(offset, offset + TAR_BLOCK_BYTES);
+		if (isZeroBlock(header)) {
+			const secondZeroBlockStart = offset + TAR_BLOCK_BYTES;
+			const secondZeroBlockEnd = secondZeroBlockStart + TAR_BLOCK_BYTES;
+			if (secondZeroBlockEnd > archive.byteLength) throw new Error("Agent Skill archive contains a truncated end-of-archive marker.");
+			if (!isZeroBlock(archive.subarray(secondZeroBlockStart, secondZeroBlockEnd))) throw new Error("Agent Skill archive is missing the second end-of-archive block.");
+			if (!archive.subarray(secondZeroBlockEnd).every((byte) => byte === 0)) throw new Error("Agent Skill archive contains non-zero bytes after its end marker.");
+			foundEndOfArchive = true;
+			break;
+		}
+		validateTarChecksum(header);
+		const name = readTarText(header, 0, TAR_NAME_BYTES, "file name");
+		const prefix = readTarText(header, TAR_PREFIX_OFFSET, TAR_PREFIX_BYTES, "file prefix");
+		const path = prefix ? `${prefix}/${name}` : name;
+		const size = readTarOctal(header, 124, 12, "file size");
+		const contentStart = offset + TAR_BLOCK_BYTES;
+		const contentEnd = contentStart + size;
+		if (contentEnd > archive.byteLength) throw new Error(`Agent Skill archive entry ${JSON.stringify(path)} is truncated.`);
+		const typeFlag = header[156];
+		if (path === "SKILL.md") {
+			if (typeFlag !== 0 && typeFlag !== "0".charCodeAt(0)) throw new Error("Agent Skill archive root SKILL.md must be a regular file.");
+			if (skillDocument) throw new Error("Agent Skill archive contains more than one root SKILL.md.");
+			if (size > AGENT_SKILL_DOCUMENT_MAX_BYTES) throw new Error(`Agent Skill archive SKILL.md exceeds ${AGENT_SKILL_DOCUMENT_MAX_BYTES} bytes.`);
+			skillDocument = archive.subarray(contentStart, contentEnd);
+		}
+		const nextOffset = contentStart + Math.ceil(size / TAR_BLOCK_BYTES) * TAR_BLOCK_BYTES;
+		if (nextOffset > archive.byteLength) throw new Error(`Agent Skill archive entry ${JSON.stringify(path)} has truncated padding.`);
+		offset = nextOffset;
+	}
+	if (!foundEndOfArchive) throw new Error("Agent Skill archive is missing its end-of-archive marker.");
+	if (!skillDocument) throw new Error("Agent Skill archive does not contain a root SKILL.md.");
+	try {
+		return new TextDecoder("utf-8", { fatal: true }).decode(skillDocument);
+	} catch {
+		throw new Error("Agent Skill archive SKILL.md is not valid UTF-8.");
+	}
+}
+
 //#endregion
 //#region src/http-link.ts
 /** Split an HTTP list without treating delimiters inside quotes or URI references as separators. */
@@ -242,7 +328,7 @@ function httpLinkHeaderHasTargetRelation(header, href, rel, responseUrl) {
 
 //#endregion
 //#region src/agent-conformance.ts
-const DOCS_AGENT_CONTRACT_VERSION = "1.2";
+const DOCS_AGENT_CONTRACT_VERSION = "1.3";
 function normalizeOrigin(value) {
 	return value.replace(/\/+$/, "");
 }
@@ -636,6 +722,24 @@ async function sha256Content(content) {
 	const digest = await globalThis.crypto.subtle.digest("SHA-256", content);
 	return [...new Uint8Array(digest)].map((value) => value.toString(16).padStart(2, "0")).join("");
 }
+async function decompressAgentSkillArchive(content) {
+	if (typeof DecompressionStream !== "function") throw new Error("gzip decompression is unavailable in this runtime");
+	const stream = new Blob([content]).stream().pipeThrough(new DecompressionStream("gzip"));
+	const chunks = [];
+	let totalBytes = 0;
+	for await (const chunk of stream) {
+		totalBytes += chunk.byteLength;
+		if (totalBytes > AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES) throw new Error(`archive exceeds ${AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES} uncompressed bytes`);
+		chunks.push(chunk);
+	}
+	const archive = new Uint8Array(new ArrayBuffer(totalBytes));
+	let offset = 0;
+	for (const chunk of chunks) {
+		archive.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return archive;
+}
 async function validateAgentSkillsIndex(content, indexUrl, handle) {
 	const issues = [];
 	let parsed;
@@ -658,7 +762,7 @@ async function validateAgentSkillsIndex(content, indexUrl, handle) {
 		const description = skill?.description;
 		const artifactRoute = skill?.url;
 		const digest = skill?.digest;
-		if (!isNonEmptyString(name) || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(name) || name.length > 64 || skill?.type !== "skill-md" && skill?.type !== "archive" || !isNonEmptyString(description) || description.length > 1024 || !isNonEmptyString(artifactRoute) || typeof digest !== "string" || !/^sha256:[0-9a-f]{64}$/u.test(digest)) {
+		if (!isNonEmptyString(name) || !isDocsAgentSkillName(name) || skill?.type !== "skill-md" && skill?.type !== "archive" || !isNonEmptyString(description) || Array.from(description).length > 1024 || !isNonEmptyString(artifactRoute) || typeof digest !== "string" || !/^sha256:[0-9a-f]{64}$/u.test(digest)) {
 			issues.push("Agent Skills index contained an invalid skill entry");
 			continue;
 		}
@@ -674,11 +778,12 @@ async function validateAgentSkillsIndex(content, indexUrl, handle) {
 			issues.push(`Agent Skills artifact URL for ${JSON.stringify(name)} was invalid`);
 			continue;
 		}
-		const expectedPath = skill.type === "archive" ? `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${name}.tar.gz` : `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${name}/SKILL.md`;
+		const expectedPath = skill.type === "archive" ? `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(name)}.tar.gz` : `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(name)}/SKILL.md`;
 		if (artifactUrl.origin !== origin || !artifactUrl.pathname.endsWith(expectedPath)) {
 			issues.push(`Agent Skills artifact URL for ${JSON.stringify(name)} did not resolve to same-origin ${expectedPath}`);
 			continue;
 		}
+		let skillDocument = null;
 		try {
 			const response = await handle(new Request(artifactUrl), "agent-skill");
 			const artifact = new Uint8Array(await response.arrayBuffer());
@@ -687,9 +792,16 @@ async function validateAgentSkillsIndex(content, indexUrl, handle) {
 			if (!matchesContentType(contentType, [skill.type === "archive" ? "application/gzip" : "text/markdown"])) issues.push(`Agent Skills artifact ${JSON.stringify(artifactRoute)} returned content-type ${contentType || "<missing>"}`);
 			const actualDigest = `sha256:${await sha256Content(artifact)}`;
 			if (actualDigest !== digest) issues.push(`Agent Skills artifact ${JSON.stringify(artifactRoute)} digest ${actualDigest} did not match ${digest}`);
+			if (skill.type === "skill-md") skillDocument = new TextDecoder("utf-8", { fatal: true }).decode(artifact);
+			else skillDocument = readAgentSkillDocumentFromTar(await decompressAgentSkillArchive(artifact));
 		} catch (error) {
 			issues.push(`Agent Skills artifact ${JSON.stringify(artifactRoute)} failed: ${error instanceof Error ? error.message : String(error)}`);
 		}
+		if (skillDocument !== null) {
+			const validation = validateDocsAgentSkillFrontmatter(skillDocument, { directoryName: name });
+			if (!validation.valid) issues.push(`Agent Skill ${JSON.stringify(name)} has invalid SKILL.md frontmatter: ${validation.issues.map((issue) => issue.message).join("; ")}`);
+			else if (validation.data.description !== description) issues.push(`Agent Skill ${JSON.stringify(name)} SKILL.md description does not match the discovery index`);
+		}
 	}
 	return issues;
 }
@@ -797,4 +909,4 @@ function resolveReadingTimeFromSource(source, wordsPerMinute, options) {
 }
 
 //#endregion
-export { resolveReadingTimeOptions as a, runDocsAgentConformance as c, extendTheme as d, deepMerge as f, resolveReadingTimeFromSource as i, httpLinkHeaderHasTargetRelation as l, defineDocs as m, resolvePageReadingTime as n, DOCS_AGENT_CONTRACT_VERSION as o, resolveChangelogConfig as p, resolveReadingTimeFromContent as r, createDocsAgentContractCases as s, estimateReadingTimeMinutes as t, createTheme as u };
+export { resolveReadingTimeOptions as a, runDocsAgentConformance as c, readAgentSkillDocumentFromTar as d, createTheme as f, defineDocs as g, resolveChangelogConfig as h, resolveReadingTimeFromSource as i, httpLinkHeaderHasTargetRelation as l, deepMerge as m, resolvePageReadingTime as n, DOCS_AGENT_CONTRACT_VERSION as o, extendTheme as p, resolveReadingTimeFromContent as r, createDocsAgentContractCases as s, estimateReadingTimeMinutes as t, AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES as u };

package/dist/{review-DdfvxMh2.mjs → review-NFnYbMRI.mjs}

@@ -1,13 +1,13 @@
-import { Ht as PAGE_AGENT_CONTRACT_FIELDS, Jt as normalizePageAgentFrontmatter, Kt as getPageAgentFrontmatterIssues, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, bt as findDocsAudienceMdxIssues, in as getDocsMcpProtectedResourceMetadataRoutes, j as buildDocsConfigMap, k as buildDocsAgentDiscoverySpec, qt as hasStructuredPageAgentContract } from "./agent-D2SsSct2.mjs";
-import { F as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-DSVKdQrl.mjs";
-import { d as resolveAskAISearchRequestConfig } from "./search-DBlw9h3P.mjs";
-import { a as resolveDocsMetadataBaseUrl } from "./metadata-CNjcFhQN.mjs";
-import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-DZR4J7Iz.mjs";
+import { A as buildDocsAgentDiscoverySpec, Et as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Xt as PAGE_AGENT_CONTRACT_FIELDS, en as getPageAgentFrontmatterIssues, fn as getDocsMcpProtectedResourceMetadataRoutes, nn as normalizePageAgentFrontmatter, tn as hasStructuredPageAgentContract } from "./agent-FIyl4-Oa.mjs";
+import { F as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-CYfiQE13.mjs";
+import { d as resolveAskAISearchRequestConfig } from "./search-x5O0-9X3.mjs";
+import { a as resolveDocsMetadataBaseUrl } from "./metadata-bw8k-9x-.mjs";
+import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-Cr9TAkmB.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
 import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
-import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-DK1uqjlo.mjs";
+import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CPGGnXOV.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";

package/dist/{robots-CD14j-mU.mjs → robots-B3e-aWPy.mjs}

@@ -1,6 +1,6 @@
-import "./agent-D2SsSct2.mjs";
-import "./standards-discovery-DSVKdQrl.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-Dz5XeT8F.mjs";
+import "./agent-FIyl4-Oa.mjs";
+import "./standards-discovery-CYfiQE13.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-DOqBwQw8.mjs";
 import { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";

package/dist/{robots-Dz5XeT8F.mjs → robots-DOqBwQw8.mjs}

@@ -1,5 +1,5 @@
-import { Ft as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, X as normalizeDocsPathSegment, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, en as DEFAULT_MCP_PUBLIC_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-D2SsSct2.mjs";
-import { a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-DSVKdQrl.mjs";
+import { S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Vt as resolveDocsSitemapConfig, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, cn as DEFAULT_MCP_PUBLIC_ROUTE, et as normalizeDocsPathSegment, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, un as DEFAULT_MCP_WELL_KNOWN_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-FIyl4-Oa.mjs";
+import { a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-CYfiQE13.mjs";
 
 //#region src/robots.ts
 const DEFAULT_ROBOTS_TXT_ROUTE = "/robots.txt";

package/dist/{search-BBVD0A7O.d.mts → search-CozHzW7v.d.mts}

@@ -1,5 +1,5 @@
 import { $n as ResolvedDocsRelatedLink, Fn as OpenDocsProvider, Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Mn as McpDocsSearchConfig, Rn as OpenDocsTarget, at as DocsAnalyticsEventInput, cn as DocsSearchConfig, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, fn as DocsSearchResult, hn as DocsSitemapConfig, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, ln as DocsSearchDocument, lr as TypesenseDocsSearchConfig, mn as DocsSearchSourcePage, on as DocsSearchAdapterFactory, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, sn as DocsSearchChunkingConfig } from "./types-BQC05SQm.mjs";
-import { F as DocsDiscoveryApiRouteOptions } from "./standards-discovery-CQjJ-M2y.mjs";
+import { F as DocsDiscoveryApiRouteOptions } from "./standards-discovery-C0CIC4QI.mjs";
 
 //#region src/analytics.d.ts
 declare const DOCS_AGENT_TRACE_EVENT_TYPES: readonly ["run.start", "run.end", "run.error", "user.input", "prompt.build", "retrieval.query", "retrieval.result", "retrieval.error", "model.call", "model.response", "model.stream", "model.error", "tool.call", "tool.result", "tool.error", "retry", "timeout", "error", "agent.final"];

package/dist/{search-DjN1Gfid.mjs → search-DOGUUZvs.mjs}

@@ -1,11 +1,11 @@
-import "./agent-D2SsSct2.mjs";
-import "./standards-discovery-DSVKdQrl.mjs";
-import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-DBlw9h3P.mjs";
-import "./sitemap-server-DQp8qUKN.mjs";
-import "./agent-evals-DZR4J7Iz.mjs";
+import "./agent-FIyl4-Oa.mjs";
+import "./standards-discovery-CYfiQE13.mjs";
+import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-x5O0-9X3.mjs";
+import "./sitemap-server-D_hayOp6.mjs";
+import "./agent-evals-Cr9TAkmB.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-iBfCLPOt.mjs";
+import "./agent-skills-server-B4u3qy-1.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, c as loadProjectEnv, g as resolveDocsConfigPath, h as readTopLevelStringProperty } from "./config-Wcdj-D0a.mjs";
 import { readFileSync } from "node:fs";

package/dist/{search-DBlw9h3P.mjs → search-x5O0-9X3.mjs}

@@ -1,4 +1,4 @@
-import { H as isDocsAgentDiscoveryRequest, J as isDocsSkillRequest, Qt as upsertPageAgentContractMarkdown, U as isDocsAgentsRequest, Vt as PAGE_AGENT_CONTRACT_END_MARKER, Wt as PAGE_AGENT_CONTRACT_START_MARKER, Yt as renderPageAgentContractMarkdown, at as resolveDocsAgentFeedbackConfig, gt as resolveDocsSkillFormat, lt as resolveDocsLlmsTxtRequest, ot as resolveDocsAgentFeedbackRequest, pt as resolveDocsMarkdownRequest, st as resolveDocsAgentsFormat, wt as resolveDocsAudienceMdxContent } from "./agent-D2SsSct2.mjs";
+import { At as resolveDocsAudienceMdxContent, G as isDocsAgentDiscoveryRequest, Gt as findDocsMarkdownSection, K as isDocsAgentsRequest, Kt as parseDocsMarkdownSections, Q as isDocsSkillRequest, Qt as PAGE_AGENT_CONTRACT_START_MARKER, Yt as PAGE_AGENT_CONTRACT_END_MARKER, _t as resolveDocsMarkdownRequest, dt as resolveDocsAgentsFormat, lt as resolveDocsAgentFeedbackConfig, on as upsertPageAgentContractMarkdown, pt as resolveDocsLlmsTxtRequest, rn as renderPageAgentContractMarkdown, ut as resolveDocsAgentFeedbackRequest, xt as resolveDocsSkillFormat } from "./agent-FIyl4-Oa.mjs";
 
 //#region src/telemetry.ts
 const DOCS_PACKAGE_NAME = "@farming-labs/docs";
@@ -457,146 +457,6 @@ function serializeGeneratedAgentDocument(content, provenance) {
 	].join("\n")}\n`;
 }
 
-//#endregion
-//#region src/markdown-sections.ts
-const HTML_ENTITIES = {
-	amp: "&",
-	apos: "'",
-	gt: ">",
-	lt: "<",
-	nbsp: " ",
-	quot: "\""
-};
-/**
-* Reduce inline Markdown in a heading to the visible label used by search and anchors.
-* This intentionally covers the common inline constructs without adding a Markdown parser
-* dependency to the runtime package.
-*/
-function cleanDocsMarkdownHeadingLabel(value) {
-	return value.replace(/!\[([^\]]*)\]\([^)]*\)/gu, "$1").replace(/\[([^\]]+)\]\([^)]*\)/gu, "$1").replace(/!\[([^\]]*)\]\[[^\]]*\]/gu, "$1").replace(/\[([^\]]+)\]\[[^\]]*\]/gu, "$1").replace(/<((?:https?:\/\/|mailto:)[^>]+)>/giu, "$1").replace(/<[^>]+>/gu, "").replace(/`+([^`]*?)`+/gu, "$1").replace(/\\([!"#$%&'()*+,\-./:;<=>?@[\]^_`{|}~])/gu, "$1").replace(/[*_~]/gu, "").replace(/&(#(?:x[0-9a-f]+|\d+)|[a-z]+);/giu, (_match, entity) => {
-		if (entity.startsWith("#x") || entity.startsWith("#X")) {
-			const codePoint = Number.parseInt(entity.slice(2), 16);
-			return Number.isSafeInteger(codePoint) && codePoint >= 0 && codePoint <= 1114111 ? String.fromCodePoint(codePoint) : _match;
-		}
-		if (entity.startsWith("#")) {
-			const codePoint = Number.parseInt(entity.slice(1), 10);
-			return Number.isSafeInteger(codePoint) && codePoint >= 0 && codePoint <= 1114111 ? String.fromCodePoint(codePoint) : _match;
-		}
-		return HTML_ENTITIES[entity.toLowerCase()] ?? _match;
-	}).replace(/\s+/gu, " ").trim();
-}
-/** Keep anchors aligned with the framework's existing ASCII heading-slug behavior. */
-function slugifyDocsMarkdownHeading(value) {
-	return cleanDocsMarkdownHeadingLabel(value).toLowerCase().replace(/[`'"‘’“”]/gu, "").replace(/&/gu, " and ").replace(/[^a-z0-9\s-]/gu, "").replace(/\s+/gu, "-").replace(/-+/gu, "-").replace(/^-|-$/gu, "");
-}
-function readOpeningFence(line) {
-	const match = line.match(/^ {0,3}(`{3,}|~{3,})/u);
-	if (!match) return void 0;
-	return {
-		marker: match[1][0],
-		length: match[1].length
-	};
-}
-function isClosingFence(line, fence) {
-	const marker = fence.marker === "`" ? "`" : "~";
-	const match = line.match(new RegExp(`^ {0,3}(${marker}{${fence.length},})[\\t ]*$`, "u"));
-	return Boolean(match);
-}
-function readAtxHeading(line) {
-	const match = line.match(/^ {0,3}(#{1,6})(?:[\t ]+|$)(.*)$/u);
-	if (!match) return void 0;
-	return {
-		title: cleanDocsMarkdownHeadingLabel(match[2].replace(/[\t ]+#+[\t ]*$/u, "").trim()),
-		level: match[1].length
-	};
-}
-function readSetextLevel(line) {
-	const match = line.match(/^ {0,3}(=+|-+)[\t ]*$/u);
-	if (!match) return void 0;
-	return match[1][0] === "=" ? 1 : 2;
-}
-function normalizeDocsSectionSelector(value) {
-	let selector = value.trim();
-	const hashIndex = selector.lastIndexOf("#");
-	if (hashIndex >= 0) selector = selector.slice(hashIndex + 1);
-	try {
-		selector = decodeURIComponent(selector);
-	} catch {}
-	return cleanDocsMarkdownHeadingLabel(selector.replace(/^#+/u, "")).toLowerCase();
-}
-/**
-* Parse heading sections once for search, Ask AI hydration, and MCP tools.
-* Supports CommonMark ATX indentation, Setext headings, fenced-code exclusion,
-* visible inline labels, and stable duplicate anchors.
-*/
-function parseDocsMarkdownSections(markdown) {
-	const lines = markdown.split("\n");
-	const headings = [];
-	const headingCounts = /* @__PURE__ */ new Map();
-	let openFence;
-	let setextCandidate;
-	const pushHeading = (title, level, start) => {
-		const baseAnchor = slugifyDocsMarkdownHeading(title) || `section-${headings.length}`;
-		const seen = headingCounts.get(baseAnchor) ?? 0;
-		headingCounts.set(baseAnchor, seen + 1);
-		headings.push({
-			title,
-			anchor: seen === 0 ? baseAnchor : `${baseAnchor}-${seen}`,
-			level,
-			start
-		});
-	};
-	for (let index = 0; index < lines.length; index += 1) {
-		const line = lines[index];
-		if (openFence) {
-			if (isClosingFence(line, openFence)) openFence = void 0;
-			setextCandidate = void 0;
-			continue;
-		}
-		const openingFence = readOpeningFence(line);
-		if (openingFence) {
-			openFence = openingFence;
-			setextCandidate = void 0;
-			continue;
-		}
-		const setextLevel = readSetextLevel(line);
-		if (setextLevel && setextCandidate?.index === index - 1) {
-			const title = cleanDocsMarkdownHeadingLabel(setextCandidate.value.trim());
-			if (title) pushHeading(title, setextLevel, setextCandidate.index);
-			setextCandidate = void 0;
-			continue;
-		}
-		const atxHeading = readAtxHeading(line);
-		if (atxHeading) {
-			pushHeading(atxHeading.title, atxHeading.level, index);
-			setextCandidate = void 0;
-			continue;
-		}
-		if (!line.trim() || /^ {4}|^\t/u.test(line)) {
-			setextCandidate = void 0;
-			continue;
-		}
-		setextCandidate = {
-			index,
-			value: line
-		};
-	}
-	return headings.map((heading, index) => {
-		const end = headings.slice(index + 1).find((candidate) => candidate.level <= heading.level)?.start ?? lines.length;
-		return {
-			title: heading.title,
-			anchor: heading.anchor,
-			level: heading.level,
-			content: lines.slice(heading.start, end).join("\n").trim()
-		};
-	});
-}
-function findDocsMarkdownSection(markdown, requestedSection) {
-	const selector = normalizeDocsSectionSelector(requestedSection);
-	if (!selector) return void 0;
-	return parseDocsMarkdownSections(markdown).find((section) => normalizeDocsSectionSelector(section.title) === selector || section.anchor === selector);
-}
-
 //#endregion
 //#region src/search.ts
 const DEFAULT_SEARCH_LIMIT = 10;
@@ -1823,4 +1683,4 @@ function createCustomSearchAdapter(adapter) {
 }
 
 //#endregion
-export { emitDocsTelemetryProjectEvent as A, applySidebarFolderIndexBehavior as C, emitDocsTelemetryAgentSurfaceEvent as D, resolveSidebarFolderIndexBehaviorForPath as E, resolveDocsTelemetryConfig as F, inferDocsTelemetryAgentSurface as M, isLocalDocsTelemetryOrigin as N, emitDocsTelemetryEvent as O, normalizeDocsTelemetryOrigin as P, stripGeneratedAgentProvenance as S, resolveSidebarFolderIndexBehavior as T, GENERATED_AGENT_PROVENANCE_VERSION as _, createMcpSearchAdapter as a, parseGeneratedAgentDocument as b, formatDocsAskAIPackageHints as c, resolveAskAISearchRequestConfig as d, resolveDocsSearchAudience as f, GENERATED_AGENT_PROVENANCE_MARKER as g, parseDocsMarkdownSections as h, createCustomSearchAdapter as i, getDocsTelemetryFeatures as j, emitDocsTelemetryMcpToolEvent as k, inferDocsAskAIPackageHints as l, findDocsMarkdownSection as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, resolveSearchRequestConfig as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, hashGeneratedAgentContent as v, resolvePageSidebarFolderIndexBehavior as w, serializeGeneratedAgentDocument as x, normalizeGeneratedAgentContent as y };
+export { inferDocsTelemetryAgentSurface as A, resolveSidebarFolderIndexBehavior as C, emitDocsTelemetryMcpToolEvent as D, emitDocsTelemetryEvent as E, normalizeDocsTelemetryOrigin as M, resolveDocsTelemetryConfig as N, emitDocsTelemetryProjectEvent as O, resolvePageSidebarFolderIndexBehavior as S, emitDocsTelemetryAgentSurfaceEvent as T, normalizeGeneratedAgentContent as _, createMcpSearchAdapter as a, stripGeneratedAgentProvenance as b, formatDocsAskAIPackageHints as c, resolveAskAISearchRequestConfig as d, resolveDocsSearchAudience as f, hashGeneratedAgentContent as g, GENERATED_AGENT_PROVENANCE_VERSION as h, createCustomSearchAdapter as i, isLocalDocsTelemetryOrigin as j, getDocsTelemetryFeatures as k, inferDocsAskAIPackageHints as l, GENERATED_AGENT_PROVENANCE_MARKER as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, resolveSearchRequestConfig as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, parseGeneratedAgentDocument as v, resolveSidebarFolderIndexBehaviorForPath as w, applySidebarFolderIndexBehavior as x, serializeGeneratedAgentDocument as y };

package/dist/server.d.mts

@@ -1,9 +1,9 @@
 import { $t as DocsReviewRulesConfig, B as DocsAgentEvaluationSourceReference, Ct as DocsCodeBlocksPlannerProvider, Et as DocsCodeBlocksValidateConfig, F as DocsAgentEvaluationAnswerInput, H as DocsAgentEvaluationTaskInput, I as DocsAgentEvaluationAnswerProvider, J as DocsAgentGoldenExpectedExample, Jt as DocsObservabilityEventInput, K as DocsAgentGoldenAnswerExpectation, Kt as DocsObservabilityConfig, L as DocsAgentEvaluationAnswerRequest, Mn as McpDocsSearchConfig, Qt as DocsReviewConfig, R as DocsAgentEvaluationAnswerResult, V as DocsAgentEvaluationSurface, X as DocsAgentGoldenTaskExpectation, Y as DocsAgentGoldenTask, Z as DocsAgentGoldenTaskFilters, Zt as DocsReviewCiMode, a as ApiReferenceRenderer, an as DocsSearchAdapterContext, at as DocsAnalyticsEventInput, cn as DocsSearchConfig, dn as DocsSearchQuery, dt as DocsAskAIFeedbackConfig, et as DocsAgentTraceEventInput, fn as DocsSearchResult, ft as DocsAskAIFeedbackData, hn as DocsSitemapConfig, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, kt as DocsConfig, ln as DocsSearchDocument, mn as DocsSearchSourcePage, mt as DocsAskAIFeedbackValue, nt as DocsAgentTraceStatus, on as DocsSearchAdapterFactory, pt as DocsAskAIFeedbackMessage, q as DocsAgentGoldenExampleVerification, qt as DocsObservabilityEvent, rt as DocsAnalyticsConfig, tt as DocsAgentTraceEventType, z as DocsAgentEvaluationAnswerRunner } from "./types-BQC05SQm.mjs";
-import { n as resolveConfiguredAgentSkills, r as resolveConfiguredAgentSkillsSync, t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-DJXdK_hS.mjs";
+import { n as resolveConfiguredAgentSkills, r as resolveConfiguredAgentSkillsSync, t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-DTwblsLu.mjs";
 import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
-import { i as isDocsCloudAskAIProvider, n as DocsCloudAskAIResponseOptions, r as createDocsCloudAskAIResponse, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-BD1SeVZv.mjs";
+import { i as isDocsCloudAskAIProvider, n as DocsCloudAskAIResponseOptions, r as createDocsCloudAskAIResponse, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-BfnX18rI.mjs";
 import { DocsCloudAskAIOptions, DocsCloudPublicConfig, DocsCloudRouteHandlerOptions, DocsCloudRouteHandlers, DocsCloudRuntimeEnv, DocsCloudRuntimeValue, DocsCloudServer, DocsCloudServerOptions, DocsCloudTrackEventOptions, createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
-import { A as resolveDocsSitemapPageLastmod, B as SerializedOpenDocsProvider, C as DocsSitemapResolvedConfig, D as renderDocsSitemapMarkdown, E as readDocsSitemapManifestFromContentMap, F as DEFAULT_OPEN_DOCS_TARGET, G as serializeDocsIcon, H as parsePromptStringArray, I as DEFAULT_PROMPT_PROVIDER_TEMPLATES, J as serializeOpenDocsProviders, K as serializeDocsIconRegistry, L as PromptAction, M as toDocsSitemapMarkdownUrl, N as DEFAULT_OPEN_DOCS_PROMPT, O as renderDocsSitemapXml, P as DEFAULT_OPEN_DOCS_PROVIDER_IDS, R as PromptProviderChoice, S as DocsSitemapPageInput, T as createDocsSitemapResponse, U as resolvePromptProviderChoices, V as normalizePromptProviderName, W as sanitizePromptText, _ as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, a as createMcpSearchAdapter, at as createDocsAgentTraceContext, b as DocsSitemapManifest, c as formatDocsAskAIPackageHints, ct as emitDocsAnalyticsEvent, d as resolveAskAISearchRequestConfig, dt as resolveDocsAnalyticsConfig, f as resolveDocsSearchAudience, ft as resolveDocsObservabilityConfig, g as DEFAULT_SITEMAP_MD_ROUTE, h as DEFAULT_SITEMAP_MD_DOCS_ROUTE, i as createCustomSearchAdapter, it as ResolvedDocsObservabilityConfig, j as resolveDocsSitemapRequest, k as resolveDocsSitemapConfig, l as inferDocsAskAIPackageHints, lt as emitDocsObservabilityEvent, m as DEFAULT_SITEMAP_MANIFEST_PATH, n as buildDocsSearchDocuments, nt as DocsAgentTraceContext, o as createSimpleSearchAdapter, ot as createDocsAgentTraceId, p as resolveSearchRequestConfig, q as serializeOpenDocsProvider, r as createAlgoliaSearchAdapter, rt as ResolvedDocsAnalyticsConfig, s as createTypesenseSearchAdapter, st as emitDocsAgentTraceEvent, t as buildDocsAskAIContext, tt as DOCS_AGENT_TRACE_EVENT_TYPES, u as performDocsSearch, ut as getDocsRequestAnalyticsProperties, v as DEFAULT_SITEMAP_XML_ROUTE, w as buildDocsSitemapManifest, x as DocsSitemapManifestPage, y as DocsSitemapFormat, z as SerializeOpenDocsProviderOptions } from "./search-BBVD0A7O.mjs";
+import { A as resolveDocsSitemapPageLastmod, B as SerializedOpenDocsProvider, C as DocsSitemapResolvedConfig, D as renderDocsSitemapMarkdown, E as readDocsSitemapManifestFromContentMap, F as DEFAULT_OPEN_DOCS_TARGET, G as serializeDocsIcon, H as parsePromptStringArray, I as DEFAULT_PROMPT_PROVIDER_TEMPLATES, J as serializeOpenDocsProviders, K as serializeDocsIconRegistry, L as PromptAction, M as toDocsSitemapMarkdownUrl, N as DEFAULT_OPEN_DOCS_PROMPT, O as renderDocsSitemapXml, P as DEFAULT_OPEN_DOCS_PROVIDER_IDS, R as PromptProviderChoice, S as DocsSitemapPageInput, T as createDocsSitemapResponse, U as resolvePromptProviderChoices, V as normalizePromptProviderName, W as sanitizePromptText, _ as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, a as createMcpSearchAdapter, at as createDocsAgentTraceContext, b as DocsSitemapManifest, c as formatDocsAskAIPackageHints, ct as emitDocsAnalyticsEvent, d as resolveAskAISearchRequestConfig, dt as resolveDocsAnalyticsConfig, f as resolveDocsSearchAudience, ft as resolveDocsObservabilityConfig, g as DEFAULT_SITEMAP_MD_ROUTE, h as DEFAULT_SITEMAP_MD_DOCS_ROUTE, i as createCustomSearchAdapter, it as ResolvedDocsObservabilityConfig, j as resolveDocsSitemapRequest, k as resolveDocsSitemapConfig, l as inferDocsAskAIPackageHints, lt as emitDocsObservabilityEvent, m as DEFAULT_SITEMAP_MANIFEST_PATH, n as buildDocsSearchDocuments, nt as DocsAgentTraceContext, o as createSimpleSearchAdapter, ot as createDocsAgentTraceId, p as resolveSearchRequestConfig, q as serializeOpenDocsProvider, r as createAlgoliaSearchAdapter, rt as ResolvedDocsAnalyticsConfig, s as createTypesenseSearchAdapter, st as emitDocsAgentTraceEvent, t as buildDocsAskAIContext, tt as DOCS_AGENT_TRACE_EVENT_TYPES, u as performDocsSearch, ut as getDocsRequestAnalyticsProperties, v as DEFAULT_SITEMAP_XML_ROUTE, w as buildDocsSitemapManifest, x as DocsSitemapManifestPage, y as DocsSitemapFormat, z as SerializeOpenDocsProviderOptions } from "./search-CozHzW7v.mjs";
 import { CreateDocsMcpServerOptions, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DocsMcpAgentContractSummary, DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpContextResult, DocsMcpContextSource, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpRequestContext, DocsMcpResolvedConfig, DocsMcpResolvedCorsConfig, DocsMcpResolvedProtectedResourceConfig, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/code-group-mdx.d.ts

package/dist/server.mjs

@@ -1,14 +1,14 @@
 import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig, i as emitDocsAgentTraceEvent, l as resolveDocsObservabilityConfig, n as createDocsAgentTraceContext, o as emitDocsObservabilityEvent, r as createDocsAgentTraceId, s as getDocsRequestAnalyticsProperties, t as DOCS_AGENT_TRACE_EVENT_TYPES } from "./analytics-Bx44lg6d.mjs";
-import { At as buildDocsSitemapManifest, Dt as DEFAULT_SITEMAP_MD_ROUTE, Et as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Ft as resolveDocsSitemapConfig, It as resolveDocsSitemapPageLastmod, Lt as resolveDocsSitemapRequest, Mt as readDocsSitemapManifestFromContentMap, Nt as renderDocsSitemapMarkdown, Ot as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Pt as renderDocsSitemapXml, Rt as toDocsSitemapMarkdownUrl, Tt as DEFAULT_SITEMAP_MANIFEST_PATH, jt as createDocsSitemapResponse, kt as DEFAULT_SITEMAP_XML_ROUTE } from "./agent-D2SsSct2.mjs";
-import "./standards-discovery-DSVKdQrl.mjs";
-import { a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveDocsSearchAudience, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as resolveSearchRequestConfig, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-DBlw9h3P.mjs";
-import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-DQp8qUKN.mjs";
-import { a as buildDocsReviewWorkflowPathFilters, c as resolveDocsReviewConfig, i as buildDocsReviewWorkflow, n as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, o as ensureDocsReviewWorkflow, r as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-DZR4J7Iz.mjs";
+import { Bt as renderDocsSitemapXml, Ft as DEFAULT_SITEMAP_XML_ROUTE, Ht as resolveDocsSitemapPageLastmod, It as buildDocsSitemapManifest, Lt as createDocsSitemapResponse, Mt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Nt as DEFAULT_SITEMAP_MD_ROUTE, Pt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Rt as readDocsSitemapManifestFromContentMap, Ut as resolveDocsSitemapRequest, Vt as resolveDocsSitemapConfig, Wt as toDocsSitemapMarkdownUrl, jt as DEFAULT_SITEMAP_MANIFEST_PATH, zt as renderDocsSitemapMarkdown } from "./agent-FIyl4-Oa.mjs";
+import "./standards-discovery-CYfiQE13.mjs";
+import { a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveDocsSearchAudience, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as resolveSearchRequestConfig, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-x5O0-9X3.mjs";
+import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-D_hayOp6.mjs";
+import { a as buildDocsReviewWorkflowPathFilters, c as resolveDocsReviewConfig, i as buildDocsReviewWorkflow, n as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, o as ensureDocsReviewWorkflow, r as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-Cr9TAkmB.mjs";
 import { DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import { n as isDocsCloudAskAIProvider, t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-sbpjOR2K.mjs";
 import { createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import { n as resolveConfiguredAgentSkillsSync, t as resolveConfiguredAgentSkills } from "./agent-skills-server-iBfCLPOt.mjs";
+import { n as resolveConfiguredAgentSkillsSync, t as resolveConfiguredAgentSkills } from "./agent-skills-server-B4u3qy-1.mjs";
 import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
 
 export { DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsAgentSkillsBundle, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveConfiguredAgentSkills, resolveConfiguredAgentSkillsSync, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSearchAudience, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };

package/dist/{sitemap-B0hlAZ8o.mjs → sitemap-BpMKdDUd.mjs}

@@ -1,11 +1,11 @@
-import { At as buildDocsSitemapManifest, Ft as resolveDocsSitemapConfig, Nt as renderDocsSitemapMarkdown, Pt as renderDocsSitemapXml } from "./agent-D2SsSct2.mjs";
-import "./standards-discovery-DSVKdQrl.mjs";
-import "./search-DBlw9h3P.mjs";
-import "./sitemap-server-DQp8qUKN.mjs";
-import "./agent-evals-DZR4J7Iz.mjs";
+import { Bt as renderDocsSitemapXml, It as buildDocsSitemapManifest, Vt as resolveDocsSitemapConfig, zt as renderDocsSitemapMarkdown } from "./agent-FIyl4-Oa.mjs";
+import "./standards-discovery-CYfiQE13.mjs";
+import "./search-x5O0-9X3.mjs";
+import "./sitemap-server-D_hayOp6.mjs";
+import "./agent-evals-Cr9TAkmB.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-iBfCLPOt.mjs";
+import "./agent-skills-server-B4u3qy-1.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, 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/{sitemap-server-DQp8qUKN.mjs → sitemap-server-D_hayOp6.mjs}

@@ -1,4 +1,4 @@
-import { Ft as resolveDocsSitemapConfig } from "./agent-D2SsSct2.mjs";
+import { Vt as resolveDocsSitemapConfig } from "./agent-FIyl4-Oa.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import path, { basename, join, relative } from "node:path";

package/dist/{standards-discovery-DSVKdQrl.mjs → standards-discovery-CYfiQE13.mjs}

@@ -1,4 +1,4 @@
-import matter from "gray-matter";
+import { parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
 
 //#region src/standards-discovery.ts
 const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";
@@ -27,9 +27,6 @@ const DOCS_AGENT_MANIFEST_SCHEMA_URI = "https://docs.farming-labs.dev/schema/age
 const DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE = "application/schema+json";
 const DEFAULT_DOCS_API_ROUTE = "/api/docs";
 const DEFAULT_AGENT_MANIFEST_ROUTE = "/.well-known/agent.json";
-const AGENT_SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-const AGENT_SKILL_NAME_MAX_LENGTH = 64;
-const AGENT_SKILL_DESCRIPTION_MAX_LENGTH = 1024;
 const DISCOVERY_CACHE_CONTROL = "public, max-age=0, s-maxage=3600";
 const LEGACY_A2A_PROTOCOL_VERSION = "0.3";
 function normalizeDocsRoute(value) {
@@ -125,22 +122,6 @@ function buildDocsApiCatalog(options) {
 	}
 	return { linkset };
 }
-function readAgentSkillFrontmatter(document) {
-	const normalized = document.startsWith("") ? document.slice(1) : document;
-	let data;
-	try {
-		data = matter(normalized).data;
-	} catch {
-		return null;
-	}
-	const name = typeof data.name === "string" ? data.name.trim() : "";
-	const description = typeof data.description === "string" ? data.description.trim() : "";
-	if (!name || name.length > AGENT_SKILL_NAME_MAX_LENGTH || !AGENT_SKILL_NAME_PATTERN.test(name) || !description || description.length > AGENT_SKILL_DESCRIPTION_MAX_LENGTH) return null;
-	return {
-		name,
-		description
-	};
-}
 function toDiscoveryBytes(content) {
 	if (typeof content === "string") return new TextEncoder().encode(content);
 	const bytes = new Uint8Array(new ArrayBuffer(content.byteLength));
@@ -161,14 +142,14 @@ function createDocsPublishedAgentSkill(content, metadata, sha256) {
 		name: metadata.name,
 		type: "skill-md",
 		description: metadata.description,
-		url: `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${metadata.name}/SKILL.md`,
+		url: `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(metadata.name)}/SKILL.md`,
 		digest: `sha256:${sha256}`,
 		content,
 		sha256,
 		skillDocument: content,
 		files: [{
 			path: "SKILL.md",
-			url: `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${metadata.name}/SKILL.md`,
+			url: `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(metadata.name)}/SKILL.md`,
 			mediaType: "text/markdown",
 			content,
 			sha256,
@@ -177,20 +158,16 @@ function createDocsPublishedAgentSkill(content, metadata, sha256) {
 	};
 }
 /** Build a published skill from an exact SKILL.md document and its precomputed SHA-256. */
-function buildDocsPublishedAgentSkill(document, sha256) {
-	const metadata = readAgentSkillFrontmatter(document);
-	if (!metadata) throw new Error("The generated Agent Skills fallback must contain valid name and description frontmatter.");
+function buildDocsPublishedAgentSkill(document, sha256, options = {}) {
+	const metadata = parseDocsAgentSkillFrontmatter(document, options);
 	if (!/^[a-f0-9]{64}$/.test(sha256)) throw new Error("Agent Skill SHA-256 must be a lowercase 64-character hexadecimal digest.");
 	return createDocsPublishedAgentSkill(document, metadata, sha256);
 }
 /** Select a valid public skill and hash the exact bytes returned by its standards route. */
 async function resolveDocsPublishedAgentSkill({ preferredDocument, fallbackDocument }) {
-	const preferredMetadata = preferredDocument ? readAgentSkillFrontmatter(preferredDocument) : null;
-	const fallbackMetadata = readAgentSkillFrontmatter(fallbackDocument);
-	const content = preferredMetadata ? preferredDocument : fallbackDocument;
-	const metadata = preferredMetadata ?? fallbackMetadata;
-	if (!metadata) throw new Error("The generated Agent Skills fallback must contain valid name and description frontmatter.");
-	return createDocsPublishedAgentSkill(content, metadata, await sha256DocsDiscoveryContent(content));
+	const preferredValidation = preferredDocument ? validateDocsAgentSkillFrontmatter(preferredDocument) : null;
+	const content = preferredValidation?.valid ? preferredDocument : fallbackDocument;
+	return createDocsPublishedAgentSkill(content, preferredValidation?.valid ? preferredValidation.data : parseDocsAgentSkillFrontmatter(fallbackDocument, { source: "generated Agent Skills fallback" }), await sha256DocsDiscoveryContent(content));
 }
 function buildDocsAgentSkillsIndex(skills) {
 	return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.69",
+  "version": "0.2.71",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -35,6 +35,11 @@
       "import": "./dist/agent-skills-bundle.mjs",
       "default": "./dist/agent-skills-bundle.mjs"
     },
+    "./agent-skills": {
+      "types": "./dist/agent-skills-spec.d.mts",
+      "import": "./dist/agent-skills-spec.mjs",
+      "default": "./dist/agent-skills-spec.mjs"
+    },
     "./vite": {
       "types": "./dist/agent-skills-vite.d.mts",
       "import": "./dist/agent-skills-vite.mjs",
@@ -65,6 +70,7 @@
     "gray-matter": "^4.0.3",
     "jiti": "^2.7.0",
     "picocolors": "^1.1.1",
+    "yaml": "^2.8.2",
     "zod": "^4.3.6"
   },
   "peerDependencies": {