@farming-labs/docs 0.2.71 → 0.2.73

package/dist/{mcp-BLynUzE7.mjs → mcp-BLLXvEXB.mjs}

@@ -1,11 +1,12 @@
-import "./agent-FIyl4-Oa.mjs";
-import { I as resolveDocsPublishedAgentSkill } from "./standards-discovery-CYfiQE13.mjs";
-import "./search-x5O0-9X3.mjs";
-import "./sitemap-server-D_hayOp6.mjs";
-import "./agent-evals-Cr9TAkmB.mjs";
+import "./agent-o9OTadrf.mjs";
+import "./markdown-sections-7OoA7ylx.mjs";
+import { L as resolveDocsPublishedAgentSkill } from "./standards-discovery-BwL5ffGx.mjs";
+import "./search-RfPcG1if.mjs";
+import "./sitemap-server-VefDnzEB.mjs";
+import "./agent-evals-BFHGypqh.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B4u3qy-1.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, i as hasTopLevelProperty, l as readBooleanProperty, n as extractObjectLiteral, o as loadDocsConfigModuleResult, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { existsSync, readFileSync } from "node:fs";

package/dist/mcp.d.mts

@@ -1,5 +1,5 @@
-import { Bn as OrderingItem, Ft as DocsMcpAuthenticate, Gn as PageAgentFrontmatter, Kt as DocsObservabilityConfig, Nt as DocsMcpAllowedOrigins, Pt as DocsMcpAuthPrincipal, Rt as DocsMcpConfig, Sn as DocsTelemetryFramework, _n as DocsTelemetryConfig, cn as DocsSearchConfig, mn as DocsSearchSourcePage, rt as DocsAnalyticsConfig } from "./types-BQC05SQm.mjs";
-import { I as DocsPublishedAgentSkill } from "./standards-discovery-C0CIC4QI.mjs";
+import { Ft as DocsMcpAuthenticate, Kt as DocsObservabilityConfig, Nt as DocsMcpAllowedOrigins, Pt as DocsMcpAuthPrincipal, Qn as PageAgentFrontmatter, Rt as DocsMcpConfig, cn as DocsSearchConfig, kn as DocsTelemetryFramework, qn as OrderingItem, rt as DocsAnalyticsConfig, wn as DocsTelemetryConfig, yn as DocsSearchSourcePage } from "./types-_HCPD4wc.mjs";
+import { L as DocsPublishedAgentSkill } from "./standards-discovery-83lp1lew.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
@@ -124,6 +124,7 @@ interface DocsMcpContextSource {
   locale?: string;
   framework?: string;
   version?: string;
+  package?: string[];
   tags?: string[];
   score?: number;
   content: string;
@@ -138,6 +139,8 @@ interface DocsMcpContextResult {
   filters: {
     framework?: string;
     version?: string;
+    package?: string[];
+    tags?: string[];
     locale?: string;
   };
   budget: {
@@ -159,6 +162,8 @@ interface DocsMcpContextOptions {
   query: string;
   framework?: string;
   version?: string;
+  package?: string | readonly string[];
+  tags?: string | readonly string[];
   locale?: string;
   tokenBudget: number;
   entry?: string;

package/dist/mcp.mjs

@@ -1,8 +1,8 @@
 import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
-import { At as resolveDocsAudienceMdxContent, Gt as findDocsMarkdownSection, Jt as renderDocsRelatedMarkdownLines, Kt as parseDocsMarkdownSections, Sn as resolveDocsMcpResourceLocation, bn as normalizeDocsMcpEndpointPath, gn as isDocsMcpProtectedResourceMetadataPath, hn as isDocsMcpOAuthScopeToken, nn as normalizePageAgentFrontmatter, on as upsertPageAgentContractMarkdown, qt as normalizeDocsRelated, tn as hasStructuredPageAgentContract, vn as isDocsMcpResourcePath, xn as resolveDocsMcpProtectedResourceMetadataLocation, yn as normalizeDocsMcpAuthorizationServerUrls } from "./agent-FIyl4-Oa.mjs";
-import "./standards-discovery-CYfiQE13.mjs";
-import { D as emitDocsTelemetryMcpToolEvent, O as emitDocsTelemetryProjectEvent, S as resolvePageSidebarFolderIndexBehavior, T as emitDocsTelemetryAgentSurfaceEvent, b as stripGeneratedAgentProvenance, u as performDocsSearch } from "./search-x5O0-9X3.mjs";
-import { a as normalizeAgentScopeValues, i as normalizeAgentLocale, n as agentVersionConstraintsOverlap, r as normalizeAgentFramework, t as agentVersionConstraintMatches } from "./agent-scope-C_U--OZ7.mjs";
+import { Kt as normalizeDocsRelated, an as isDocsMcpResourcePath, cn as resolveDocsMcpProtectedResourceMetadataLocation, jt as resolveDocsAudienceMdxContent, ln as resolveDocsMcpResourceLocation, nn as isDocsMcpOAuthScopeToken, on as normalizeDocsMcpAuthorizationServerUrls, qt as renderDocsRelatedMarkdownLines, rn as isDocsMcpProtectedResourceMetadataPath, sn as normalizeDocsMcpEndpointPath } from "./agent-o9OTadrf.mjs";
+import { S as upsertPageAgentContractMarkdown, _ as hasStructuredPageAgentContract, o as findDocsMarkdownSection, s as parseDocsMarkdownSections, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
+import "./standards-discovery-BwL5ffGx.mjs";
+import { A as stripGeneratedAgentProvenance, F as emitDocsTelemetryAgentSurfaceEvent, L as emitDocsTelemetryMcpToolEvent, M as resolvePageSidebarFolderIndexBehavior, R as emitDocsTelemetryProjectEvent, S as normalizeAgentScopeValues, b as normalizeAgentFramework, d as performDocsSearch, f as performDocsSearchWithMetadata, u as normalizeDocsSearchFilters, v as agentVersionConstraintMatches, x as normalizeAgentLocale, y as agentVersionConstraintsOverlap } from "./search-RfPcG1if.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
 import path from "node:path";
@@ -801,7 +801,7 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 								path: "agent.evaluations.tasks[].filters",
 								name: "filters",
 								type: "DocsAgentGoldenTaskFilters",
-								description: "Framework, version, and locale retrieval scope.",
+								description: "Framework, version, package, tags, and locale retrieval scope.",
 								children: [
 									{
 										path: "agent.evaluations.tasks[].filters.framework",
@@ -815,6 +815,18 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 										type: "string",
 										description: "Exact version requested by the task."
 									},
+									{
+										path: "agent.evaluations.tasks[].filters.package",
+										name: "package",
+										type: "string | readonly string[]",
+										description: "Package name or names requested by the task."
+									},
+									{
+										path: "agent.evaluations.tasks[].filters.tags",
+										name: "tags",
+										type: "string | readonly string[]",
+										description: "Page tag or tags requested by the task."
+									},
 									{
 										path: "agent.evaluations.tasks[].filters.locale",
 										name: "locale",
@@ -876,7 +888,7 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 										path: "agent.evaluations.tasks[].expect.scope",
 										name: "scope",
 										type: "DocsAgentGoldenTaskFilters",
-										description: "Framework, version, and locale assertions checked against returned sources without pre-filtering retrieval.",
+										description: "Framework, version, package, tags, and locale assertions checked against returned sources without pre-filtering retrieval.",
 										children: [
 											{
 												path: "agent.evaluations.tasks[].expect.scope.framework",
@@ -890,6 +902,18 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 												type: "string",
 												description: "Version the returned sources must select."
 											},
+											{
+												path: "agent.evaluations.tasks[].expect.scope.package",
+												name: "package",
+												type: "string | readonly string[]",
+												description: "Package name or names the returned sources must select."
+											},
+											{
+												path: "agent.evaluations.tasks[].expect.scope.tags",
+												name: "tags",
+												type: "string | readonly string[]",
+												description: "Page tag or tags the returned sources must select."
+											},
 											{
 												path: "agent.evaluations.tasks[].expect.scope.locale",
 												name: "locale",
@@ -1663,11 +1687,16 @@ export default defineDocs({
 });`
 	}
 ]);
+const searchFilterValueSchema = z.union([z.string().trim().min(1).max(128), z.array(z.string().trim().min(1).max(128)).min(1).max(16)]);
 const searchDocsInputSchema = z.object({
 	query: z.string().trim().min(1),
 	limit: z.number().int().min(1).max(25).optional(),
 	locale: z.string().min(1).optional(),
-	audience: z.enum(["human", "agent"]).optional()
+	audience: z.enum(["human", "agent"]).optional(),
+	framework: searchFilterValueSchema.optional(),
+	version: searchFilterValueSchema.optional(),
+	package: searchFilterValueSchema.optional(),
+	tags: searchFilterValueSchema.optional()
 });
 const readPageInputSchema = z.object({
 	path: z.string().min(1),
@@ -1763,6 +1792,8 @@ const getContextInputSchema = z.object({
 	query: z.string().trim().min(1),
 	framework: z.string().trim().min(1).optional(),
 	version: z.string().trim().min(1).optional(),
+	package: searchFilterValueSchema.optional(),
+	tags: searchFilterValueSchema.optional(),
 	locale: z.string().trim().min(1).optional(),
 	tokenBudget: z.number().int().min(MIN_MCP_CONTEXT_TOKEN_BUDGET).max(MAX_MCP_CONTEXT_TOKEN_BUDGET).default(DEFAULT_MCP_CONTEXT_TOKEN_BUDGET)
 });
@@ -1836,7 +1867,39 @@ const searchResultOutputSchema = z.object({
 	score: z.number().optional(),
 	section: z.string().optional()
 });
-const searchDocsOutputSchema = z.object({ results: z.array(searchResultOutputSchema) });
+const searchFiltersOutputSchema = z.object({
+	framework: z.array(z.string()).optional(),
+	version: z.array(z.string()).optional(),
+	package: z.array(z.string()).optional(),
+	tags: z.array(z.string()).optional()
+});
+const searchWarningOutputSchema = z.object({
+	code: z.enum([
+		"ambiguous_scope",
+		"unknown_filter_value",
+		"missing_scope_metadata",
+		"conflicting_scope_metadata"
+	]),
+	field: z.enum([
+		"framework",
+		"version",
+		"package",
+		"tags"
+	]),
+	message: z.string(),
+	values: z.array(z.string()).optional(),
+	pageUrls: z.array(z.string()).optional(),
+	count: z.number().int().nonnegative().optional()
+});
+const searchDocsOutputSchema = z.object({
+	format: z.literal("docs-search.v1"),
+	query: z.string(),
+	audience: z.enum(["human", "agent"]),
+	filters: searchFiltersOutputSchema,
+	resultCount: z.number().int().nonnegative(),
+	results: z.array(searchResultOutputSchema),
+	warnings: z.array(searchWarningOutputSchema)
+});
 const codeExampleOutputSchema = z.object({
 	id: z.string(),
 	page: z.object({
@@ -1920,6 +1983,7 @@ const contextSourceOutputSchema = z.object({
 	locale: z.string().optional(),
 	framework: z.string().optional(),
 	version: z.string().optional(),
+	package: z.array(z.string()).optional(),
 	tags: z.array(z.string()).optional(),
 	score: z.number().optional(),
 	content: z.string(),
@@ -1932,6 +1996,8 @@ const contextOutputSchema = z.object({
 	filters: z.object({
 		framework: z.string().optional(),
 		version: z.string().optional(),
+		package: z.array(z.string()).optional(),
+		tags: z.array(z.string()).optional(),
 		locale: z.string().optional()
 	}),
 	budget: z.object({
@@ -2737,14 +2803,20 @@ async function createDocsMcpServer(options) {
 	});
 	if (resolved.tools.searchDocs) server.registerTool("search_docs", {
 		title: "Search documentation",
-		description: "Search the docs by keyword across titles, descriptions, and page content.",
+		description: "Search the docs by keyword with optional framework, version, package, and tag filters. Returns structured ambiguity and metadata warnings.",
 		inputSchema: searchDocsInputSchema,
 		outputSchema: searchDocsOutputSchema,
 		annotations: { readOnlyHint: true }
-	}, async ({ query, limit, locale, audience }) => {
+	}, async ({ query, limit, locale, audience, framework, version, package: packageName, tags }) => {
 		const startedAt = nowMs();
 		const resolvedLimit = limit ?? 10;
 		const resolvedAudience = audience ?? "agent";
+		const filters = {
+			framework,
+			version,
+			package: packageName,
+			tags
+		};
 		const trace = createDocsAgentTraceContext("mcp.tool.search_docs");
 		const callSpanId = createDocsAgentTraceId("span");
 		await emitDocsAgentTraceEvent(options.observability, {
@@ -2760,16 +2832,18 @@ async function createDocsMcpServer(options) {
 				queryLength: query.length,
 				limit: resolvedLimit,
 				locale,
-				audience: resolvedAudience
+				audience: resolvedAudience,
+				filterFields: Object.entries(filters).filter(([, value]) => value !== void 0).map(([field]) => field)
 			},
 			metadata: { tool: "search_docs" }
 		});
 		try {
-			const results = await performDocsSearch({
+			const searchResponse = await performDocsSearchWithMetadata({
 				pages: toSearchSourcePages(dedupePages(await getSourcePages(locale))),
 				query,
 				search: toolSearchConfig ?? true,
 				audience: resolvedAudience,
+				filters,
 				locale,
 				siteTitle: options.source.siteTitle,
 				limit: resolvedLimit
@@ -2785,13 +2859,14 @@ async function createDocsMcpServer(options) {
 					queryLength: query.length,
 					limit: resolvedLimit,
 					audience: resolvedAudience,
-					resultCount: results.length,
+					resultCount: searchResponse.resultCount,
+					warningCount: searchResponse.warnings.length,
 					durationMs: elapsed
 				}
 			});
 			trackMcpTool("search_docs", {
 				locale,
-				resultCount: results.length
+				resultCount: searchResponse.resultCount
 			});
 			await emitDocsAgentTraceEvent(options.observability, {
 				type: "tool.result",
@@ -2804,10 +2879,13 @@ async function createDocsMcpServer(options) {
 				durationMs: elapsed,
 				status: "success",
 				locale,
-				outputPreview: { resultCount: results.length },
+				outputPreview: {
+					resultCount: searchResponse.resultCount,
+					warningCount: searchResponse.warnings.length
+				},
 				metadata: { tool: "search_docs" }
 			});
-			return createStructuredTextResult({ results });
+			return createStructuredTextResult(searchResponse);
 		} catch (error) {
 			const elapsed = durationMs(startedAt);
 			await emitDocsAgentTraceEvent(options.observability, {
@@ -2932,7 +3010,7 @@ async function createDocsMcpServer(options) {
 		inputSchema: getContextInputSchema,
 		outputSchema: contextOutputSchema,
 		annotations: { readOnlyHint: true }
-	}, async ({ query, framework, version, locale, tokenBudget }) => {
+	}, async ({ query, framework, version, package: packageName, tags, locale, tokenBudget }) => {
 		const startedAt = nowMs();
 		const trace = createDocsAgentTraceContext("mcp.tool.get_context");
 		const callSpanId = createDocsAgentTraceId("span");
@@ -2949,6 +3027,8 @@ async function createDocsMcpServer(options) {
 				queryLength: query.length,
 				framework,
 				version,
+				package: packageName,
+				tags,
 				locale,
 				tokenBudget
 			},
@@ -2960,6 +3040,8 @@ async function createDocsMcpServer(options) {
 				query,
 				framework,
 				version,
+				package: packageName,
+				tags,
 				locale,
 				tokenBudget,
 				entry: options.source.entry,
@@ -2976,6 +3058,8 @@ async function createDocsMcpServer(options) {
 					queryLength: query.length,
 					framework,
 					version,
+					package: packageName,
+					tags,
 					tokenBudget,
 					usedUtf8Bytes: result.budget.usedUtf8Bytes,
 					conservativeTokenUpperBound: result.budget.conservativeTokenUpperBound,
@@ -3115,11 +3199,10 @@ async function createDocsMcpServer(options) {
 				};
 			}
 			const fullDocument = renderPageDocument(page);
-			const sectionDocument = getDocsMcpSourceMarkdown(page);
-			const selectedSection = section ? findDocsMarkdownSection(sectionDocument, section) ?? (sectionDocument !== fullDocument ? findDocsMarkdownSection(fullDocument, section) : void 0) : void 0;
+			const sectionDocument = upsertPageAgentContractMarkdown(getDocsMcpSourceMarkdown(page), page.agent);
+			const selectedSection = section ? findDocsMarkdownSection(sectionDocument, section) : void 0;
 			if (section && !selectedSection) {
-				const sourceSections = parseDocsMarkdownSections(sectionDocument);
-				const availableSections = (sourceSections.length > 0 ? sourceSections : parseDocsMarkdownSections(fullDocument)).map((item) => ({
+				const availableSections = parseDocsMarkdownSections(sectionDocument).map((item) => ({
 					title: item.title,
 					anchor: item.anchor
 				}));
@@ -4504,23 +4587,34 @@ function resolveDocsMcpScopeField(pageValue, contractValue, filter, overlaps, ma
 	};
 }
 function resolveDocsMcpEffectiveScope(page, filters) {
+	const normalizedFilters = normalizeDocsSearchFilters({
+		package: filters.package,
+		tags: filters.tags
+	});
 	const framework = resolveDocsMcpScopeField(page.framework, page.agent?.appliesTo?.framework, filters.framework, (left, right) => normalizeAgentFramework(left) === normalizeAgentFramework(right), (filter, candidate) => normalizeAgentFramework(filter) === normalizeAgentFramework(candidate));
 	const version = resolveDocsMcpScopeField(page.version, page.agent?.appliesTo?.version, filters.version, agentVersionConstraintsOverlap, agentVersionConstraintMatches);
 	const locale = page.locale?.trim() || void 0;
 	const localeMatches = !filters.locale || !locale || normalizeAgentLocale(locale) === normalizeAgentLocale(filters.locale);
+	const packageValues = normalizeDocsSearchFilters({ package: page.agent?.appliesTo?.package }).package ?? [];
+	const tagValues = normalizeDocsSearchFilters({ tags: page.tags }).tags ?? [];
+	const packageMatches = !normalizedFilters.package || packageValues.length > 0 && normalizedFilters.package.some((value) => packageValues.includes(value));
+	const tagsMatch = !normalizedFilters.tags || tagValues.length > 0 && normalizedFilters.tags.some((value) => tagValues.includes(value));
 	return {
 		framework: framework.value,
 		version: version.value,
+		package: packageValues,
+		tags: tagValues,
 		locale,
 		conflict: framework.conflict || version.conflict,
-		matches: framework.matches && version.matches && localeMatches
+		matches: framework.matches && version.matches && packageMatches && tagsMatch && localeMatches
 	};
 }
 function getDocsMcpResultPageUrl(value) {
 	return value.split("#", 1)[0] ?? value;
 }
 function getDocsMcpResultAnchor(value) {
-	const anchor = value.split("#", 2)[1];
+	const hashIndex = value.indexOf("#");
+	const anchor = hashIndex >= 0 ? value.slice(hashIndex + 1) : "";
 	if (!anchor) return void 0;
 	try {
 		return decodeURIComponent(anchor);
@@ -4533,6 +4627,8 @@ async function buildDocsMcpContext(options) {
 		const scope = resolveDocsMcpEffectiveScope(page, {
 			framework: options.framework,
 			version: options.version,
+			package: options.package,
+			tags: options.tags,
 			locale: options.locale
 		});
 		return scope.matches && !scope.conflict ? [{
@@ -4600,11 +4696,13 @@ async function buildDocsMcpContext(options) {
 	let usedUtf8Bytes = 0;
 	for (const { result, page, scope, selectedSection, rawContent } of resolvedCandidates) {
 		const anchor = selectedSection?.anchor;
-		const sourceUrl = anchor ? `${page.url}#${anchor}` : page.url;
+		const sourceUrl = anchor ? `${page.url.split("#", 1)[0]}#${encodeURIComponent(anchor)}` : page.url;
 		const headerLines = [`## ${page.title}`, `Source: ${sourceUrl}`];
 		if (selectedSection?.title) headerLines.push(`Section: ${selectedSection.title}`);
 		if (scope.framework) headerLines.push(`Framework: ${scope.framework}`);
 		if (scope.version) headerLines.push(`Version: ${scope.version}`);
+		if (scope.package.length > 0) headerLines.push(`Package: ${scope.package.join(", ")}`);
+		if (scope.tags.length > 0) headerLines.push(`Tags: ${scope.tags.join(", ")}`);
 		if (scope.locale) headerLines.push(`Locale: ${scope.locale}`);
 		const header = headerLines.join("\n");
 		const separatorBytes = blocks.length === 0 ? 0 : separatorUtf8Bytes;
@@ -4629,7 +4727,8 @@ async function buildDocsMcpContext(options) {
 			locale: scope.locale,
 			framework: scope.framework,
 			version: scope.version,
-			tags: page.tags ? [...page.tags] : void 0,
+			package: scope.package.length > 0 ? [...scope.package] : void 0,
+			tags: scope.tags.length > 0 ? [...scope.tags] : void 0,
 			score: result.score,
 			content: limited.text,
 			chars: limited.text.length,
@@ -4642,11 +4741,17 @@ async function buildDocsMcpContext(options) {
 	usedUtf8Bytes = docsMcpUtf8Bytes(context);
 	const remainingUtf8Bytes = Math.max(0, maxUtf8Bytes - usedUtf8Bytes);
 	const truncated = sources.some((source) => source.truncated) || sources.length < resolvedCandidates.length;
+	const normalizedFilters = normalizeDocsSearchFilters({
+		package: options.package,
+		tags: options.tags
+	});
 	return {
 		query: options.query,
 		filters: {
 			framework: options.framework,
 			version: options.version,
+			package: normalizedFilters.package,
+			tags: normalizedFilters.tags,
 			locale: options.locale
 		},
 		budget: {

package/dist/{metadata-bw8k-9x-.mjs → metadata-N252j5_a.mjs}

@@ -1,4 +1,4 @@
-import { nn as normalizePageAgentFrontmatter, tn as hasStructuredPageAgentContract } from "./agent-FIyl4-Oa.mjs";
+import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
 
 //#region src/metadata.ts
 /**

package/dist/{reading-time-DtNegNiq.mjs → prompt-references-Cz35rlOa.mjs}

@@ -1,7 +1,7 @@
-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 { It as DEFAULT_SITEMAP_XML_ROUTE, Pt as DEFAULT_SITEMAP_MD_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_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, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-o9OTadrf.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 { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, 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-BwL5ffGx.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-BcuxnZqZ.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts
@@ -683,6 +683,7 @@ function validateAgentManifest(content) {
 	const issues = [];
 	if (root?.$schema !== DOCS_AGENT_MANIFEST_SCHEMA_URI) issues.push(`Agent manifest did not declare top-level $schema ${DOCS_AGENT_MANIFEST_SCHEMA_URI}`);
 	if (root?.format !== DOCS_AGENT_MANIFEST_FORMAT) issues.push(`Agent manifest did not declare top-level format ${DOCS_AGENT_MANIFEST_FORMAT}`);
+	if (root?.version !== DOCS_AGENT_MANIFEST_VERSION) issues.push(`Agent manifest did not declare top-level version ${DOCS_AGENT_MANIFEST_VERSION}`);
 	return issues;
 }
 function httpLinkMatchesContractExpectation(header, expectation, responseUrl) {
@@ -909,4 +910,157 @@ function resolveReadingTimeFromSource(source, wordsPerMinute, options) {
 }
 
 //#endregion
-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 };
+//#region src/heading-toc.ts
+/**
+* Encode heading fragments emitted by a renderer's nested table of contents.
+*
+* Fumadocs stores fragment URLs as raw DOM ids. Encoding the fragment after its
+* heading visitor runs keeps links valid without changing path prefixes.
+*/
+function encodeDocsHeadingTocUrls(value) {
+	if (Array.isArray(value)) {
+		for (const item of value) encodeDocsHeadingTocUrls(item);
+		return;
+	}
+	if (!value || typeof value !== "object") return;
+	const item = value;
+	if (typeof item.url === "string") {
+		const hashIndex = item.url.indexOf("#");
+		if (hashIndex >= 0) item.url = `${item.url.slice(0, hashIndex)}#${encodeURIComponent(item.url.slice(hashIndex + 1))}`;
+	}
+	encodeDocsHeadingTocUrls(item.children);
+}
+
+//#endregion
+//#region src/prompt-references.ts
+function isDocsMarkdownPromptNode(node) {
+	return (node.type === "mdxJsxFlowElement" || node.type === "mdxJsxTextElement") && node.name === "Prompt";
+}
+function normalizeDocsMarkdownReferenceIdentifier(value) {
+	return typeof value === "string" ? value.trim().replace(/\s+/gu, " ").toLowerCase() : "";
+}
+function readDocsMarkdownPromptReferenceSource(value) {
+	const source = typeof value === "string" ? value : value instanceof Uint8Array ? new TextDecoder().decode(value) : void 0;
+	if (source === void 0) return void 0;
+	return source.startsWith("") ? source.slice(1) : source;
+}
+function sliceDocsMarkdownPromptReferenceSource(node, source) {
+	if (source === void 0) return void 0;
+	const start = node.position?.start?.offset;
+	const end = node.position?.end?.offset;
+	if (typeof start !== "number" || typeof end !== "number" || !Number.isInteger(start) || !Number.isInteger(end) || start < 0 || end < start || end > source.length) return;
+	return source.slice(start, end);
+}
+function sliceDocsMarkdownPromptChildrenSource(node, source) {
+	const nodeSource = sliceDocsMarkdownPromptReferenceSource(node, source);
+	if (nodeSource === void 0) return void 0;
+	const closingStart = nodeSource.lastIndexOf("</Prompt");
+	if (closingStart < 0) return void 0;
+	const children = node.children ?? [];
+	const isolatedChild = children.length === 1 ? children[0] : void 0;
+	if (isolatedChild?.type === "text" && typeof isolatedChild.value === "string" && isolatedChild.position === void 0) return isolatedChild.value;
+	const nodeStart = node.position?.start?.offset;
+	if (typeof nodeStart !== "number") return void 0;
+	let firstChildStart;
+	for (const child of children) {
+		const childStart = child.position?.start?.offset;
+		if (typeof childStart === "number" && Number.isInteger(childStart) && childStart >= nodeStart && (firstChildStart === void 0 || childStart - nodeStart < firstChildStart)) firstChildStart = childStart - nodeStart;
+	}
+	if (children.length > 0 && firstChildStart === void 0) return void 0;
+	const openingEnd = nodeSource.lastIndexOf(">", (firstChildStart ?? closingStart) - 1);
+	if (openingEnd < 0 || openingEnd >= closingStart) return void 0;
+	return nodeSource.slice(openingEnd + 1, closingStart);
+}
+function flattenDocsMarkdownPromptReferenceNode(node) {
+	if (typeof node.value === "string") return node.value;
+	return (node.children ?? []).map((child) => flattenDocsMarkdownPromptReferenceNode(child)).join("");
+}
+function formatDocsMarkdownPromptReference(node) {
+	const image = node.type === "imageReference";
+	const visibleLabel = image ? typeof node.alt === "string" ? node.alt : "" : flattenDocsMarkdownPromptReferenceNode(node);
+	const referenceLabel = typeof node.label === "string" ? node.label : typeof node.identifier === "string" ? node.identifier : visibleLabel;
+	const prefix = image ? "!" : "";
+	if (node.referenceType === "collapsed") return `${prefix}[${visibleLabel}][]`;
+	if (node.referenceType === "shortcut") return `${prefix}[${visibleLabel}]`;
+	return `${prefix}[${visibleLabel}][${referenceLabel}]`;
+}
+function formatDocsMarkdownPromptDefinition(node) {
+	const label = typeof node.label === "string" ? node.label : typeof node.identifier === "string" ? node.identifier : "";
+	const rawUrl = typeof node.url === "string" ? node.url : "";
+	return `[${label}]: ${/[<>\s]/u.test(rawUrl) ? `<${rawUrl.replace(/>/gu, "\\>")}>` : rawUrl}${typeof node.title === "string" ? ` "${node.title.replace(/"/gu, "\\\"")}"` : ""}`;
+}
+function createDocsMarkdownPromptReferenceText(node, source) {
+	return {
+		type: "text",
+		value: sliceDocsMarkdownPromptReferenceSource(node, source) ?? formatDocsMarkdownPromptReference(node),
+		position: node.position
+	};
+}
+function createDocsMarkdownPromptDefinitionParagraph(node, source) {
+	return {
+		type: "paragraph",
+		children: [{
+			type: "text",
+			value: sliceDocsMarkdownPromptReferenceSource(node, source) ?? formatDocsMarkdownPromptDefinition(node),
+			position: node.position
+		}],
+		position: node.position
+	};
+}
+/**
+* Keep `<Prompt>` children literal before Markdown reference definitions are
+* resolved by the MDX compiler.
+*
+* Definitions inside Prompt are copyable source, not page-level definitions.
+* References inside Prompt always remain source text, while references outside
+* Prompt only remain live when they have a definition outside Prompt.
+*/
+function isolateDocsMarkdownPromptReferences(root, value) {
+	if (!root || typeof root !== "object") return;
+	const source = readDocsMarkdownPromptReferenceSource(value);
+	const promptDefinitions = /* @__PURE__ */ new Set();
+	const pageDefinitions = /* @__PURE__ */ new Set();
+	let hasPrompt = false;
+	const collectDefinitions = (node, insidePrompt) => {
+		const prompt = isDocsMarkdownPromptNode(node);
+		const literal = insidePrompt || prompt;
+		if (prompt) hasPrompt = true;
+		if (node.type === "definition") {
+			const identifier = normalizeDocsMarkdownReferenceIdentifier(node.identifier);
+			if (identifier) (literal ? promptDefinitions : pageDefinitions).add(identifier);
+		}
+		for (const child of node.children ?? []) collectDefinitions(child, literal);
+	};
+	collectDefinitions(root, false);
+	if (!hasPrompt) return;
+	const isolateReferences = (node, insidePrompt) => {
+		const prompt = isDocsMarkdownPromptNode(node);
+		if (prompt) {
+			const promptSource = sliceDocsMarkdownPromptChildrenSource(node, source);
+			if (promptSource !== void 0) {
+				node.children = [{
+					type: "text",
+					value: promptSource
+				}];
+				return;
+			}
+		}
+		const literal = insidePrompt || prompt;
+		const children = node.children;
+		if (!children) return;
+		node.children = children.map((child) => {
+			const childInsidePrompt = literal || isDocsMarkdownPromptNode(child);
+			if (childInsidePrompt && child.type === "definition") return createDocsMarkdownPromptDefinitionParagraph(child, source);
+			if (child.type === "linkReference" || child.type === "imageReference") {
+				const identifier = normalizeDocsMarkdownReferenceIdentifier(child.identifier);
+				if (childInsidePrompt || promptDefinitions.has(identifier) && !pageDefinitions.has(identifier)) return createDocsMarkdownPromptReferenceText(child, source);
+			}
+			isolateReferences(child, childInsidePrompt);
+			return child;
+		});
+	};
+	isolateReferences(root, false);
+}
+
+//#endregion
+export { resolveChangelogConfig as _, resolveReadingTimeFromContent as a, DOCS_AGENT_CONTRACT_VERSION as c, httpLinkHeaderHasTargetRelation as d, AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES as f, deepMerge as g, extendTheme as h, resolvePageReadingTime as i, createDocsAgentContractCases as l, createTheme as m, encodeDocsHeadingTocUrls as n, resolveReadingTimeFromSource as o, readAgentSkillDocumentFromTar as p, estimateReadingTimeMinutes as r, resolveReadingTimeOptions as s, isolateDocsMarkdownPromptReferences as t, runDocsAgentConformance as u, defineDocs as v };

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

@@ -1,13 +1,14 @@
-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 { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, Dt as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS } from "./agent-o9OTadrf.mjs";
+import { _ as hasStructuredPageAgentContract, f as PAGE_AGENT_CONTRACT_FIELDS, g as getPageAgentFrontmatterIssues, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
+import { I 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-BwL5ffGx.mjs";
+import { p as resolveAskAISearchRequestConfig } from "./search-RfPcG1if.mjs";
+import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
+import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-BFHGypqh.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-CPGGnXOV.mjs";
+import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CloP0pAe.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";

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

@@ -1,5 +1,5 @@
-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";
+import { Ht as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_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, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-o9OTadrf.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-BwL5ffGx.mjs";
 
 //#region src/robots.ts
 const DEFAULT_ROBOTS_TXT_ROUTE = "/robots.txt";

package/dist/{robots-B3e-aWPy.mjs → robots-DI-9MZz1.mjs}

@@ -1,6 +1,7 @@
-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 "./agent-o9OTadrf.mjs";
+import "./markdown-sections-7OoA7ylx.mjs";
+import "./standards-discovery-BwL5ffGx.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-BcuxnZqZ.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";