@farming-labs/docs 0.2.74 → 0.2.77

package/dist/{agent-BJ0KXN-A.mjs → agent-SRIJ-oF8.mjs}

@@ -1,5 +1,5 @@
 import { S as upsertPageAgentContractMarkdown, b as renderPageAgentFrontmatterYamlLines, o as findDocsMarkdownSection, p as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, s as parseDocsMarkdownSections } from "./markdown-sections-7OoA7ylx.mjs";
-import { F as isDocsStandardsDiscoveryRequest, I as resolveDocsDiscoveryApiRoute, M as createDocsStandardsResponse, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, k as buildDocsApiCatalog, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, 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 { F as isDocsStandardsDiscoveryRequest, I as resolveDocsDiscoveryApiRoute, M as createDocsStandardsResponse, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, k as buildDocsApiCatalog, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, 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-BKlEnK_H.mjs";
 import { createProcessor } from "@mdx-js/mdx";
 
 //#region src/mcp-auth.ts
@@ -2117,6 +2117,7 @@ const DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA = {
 const DEFAULT_DOCS_DIAGNOSTICS_MCP_TOOLS = {
 	listDocs: true,
 	listPages: true,
+	listPageSections: true,
 	readPage: true,
 	listTasks: true,
 	readTask: true,
@@ -2434,6 +2435,10 @@ function buildDocsDiagnostics(config, options = {}) {
 				},
 				responseFormat: "docs-search.v1",
 				warningsField: "warnings",
+				cursorParam: "cursor",
+				nextCursorField: "nextCursor",
+				hasMoreField: "hasMore",
+				totalField: "total",
 				provider: search.provider,
 				transport: "GET"
 			},
@@ -2740,6 +2745,7 @@ function resolveDocsDiagnosticsMcp(mcp) {
 			...DEFAULT_DOCS_DIAGNOSTICS_MCP_TOOLS,
 			listDocs: tools.listDocs !== false,
 			listPages: tools.listPages !== false,
+			listPageSections: tools.listPageSections !== false,
 			readPage: tools.readPage !== false,
 			listTasks: tools.listTasks !== false,
 			readTask: tools.readTask !== false,
@@ -3273,7 +3279,13 @@ async function createDocsStandardsDiscoveryResponse({ request, preferredSkillDoc
 			mcpRoute: mcp.enabled ? mcp.route : null,
 			protectedResourceMetadataRoutes,
 			feedbackRoutes: feedback?.enabled ? [feedbackRoute, feedbackSchemaRoute] : [],
-			openapiRoute: openapiConfig.enabled ? openapiUrl ?? `${resolvedApiRoute}?format=openapi` : null,
+			openapiDefinitions: openapiConfig.enabled && openapiConfig.catalogTargets?.length ? [{
+				route: openapiUrl ?? `${resolvedApiRoute}?format=openapi`,
+				targets: openapiConfig.catalogTargets.map((route) => ({
+					route,
+					title: "Product API"
+				}))
+			}] : [],
 			apiReferenceRoute: openapiConfig.enabled && openapiConfig.apiReferencePath ? openapiConfig.apiReferencePath : null
 		}) : void 0
 	});
@@ -4539,7 +4551,11 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 				"package",
 				"tags"
 			],
-			warningsField: "warnings"
+			warningsField: "warnings",
+			cursorParam: "cursor",
+			nextCursorField: "nextCursor",
+			hasMoreField: "hasMore",
+			totalField: "total"
 		},
 		agents: {
 			enabled: true,
@@ -4680,16 +4696,22 @@ function resolveDocsOpenApiDiscoveryConfig(openapi) {
 		enabled: true,
 		url: DEFAULT_OPENAPI_SCHEMA_ROUTE,
 		urlSource: "default",
-		source: "generated"
+		source: "generated",
+		catalogTargets: ["/"]
 	};
 	if (openapi.enabled === false) return { enabled: false };
+	const specUrl = openapi.specUrl?.trim();
+	const source = openapi.source ?? (specUrl ? "configured" : "generated");
+	const requestRelativeSpecUrl = specUrl?.startsWith("/") && !specUrl.startsWith("//");
+	const catalogTargets = openapi.catalogTargets === void 0 ? source === "generated" || requestRelativeSpecUrl ? ["/"] : void 0 : Array.from(new Set(openapi.catalogTargets.filter((target) => typeof target === "string").map((target) => target.trim()).filter(Boolean)));
 	return {
 		enabled: true,
 		url: openapi.url ?? DEFAULT_OPENAPI_SCHEMA_ROUTE,
 		urlSource: openapi.urlSource ?? (openapi.url === void 0 ? "default" : "configured"),
-		source: openapi.source ?? "generated",
+		source,
 		specUrl: openapi.specUrl,
-		apiReferencePath: openapi.apiReferencePath
+		apiReferencePath: openapi.apiReferencePath,
+		catalogTargets
 	};
 }
 function resolveDocsOpenApiDiscoveryUrl(openapi, apiRoute) {

package/dist/{agent-evals-LIScgQVm.mjs → agent-evals-DmFoKy_y.mjs}

@@ -1,5 +1,5 @@
 import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-7OoA7ylx.mjs";
-import { C as agentVersionConstraintsOverlap, D as normalizeAgentVersion, E as normalizeAgentScopeValues, S as agentVersionConstraintMatches, T as normalizeAgentLocale, b as resolveSearchRequestConfig, f as normalizeDocsSearchFilters, p as performDocsSearch, t as buildDocsAskAIContext, w as normalizeAgentFramework, x as agentVersionConstraintGroupsOverlap } from "./search-DIyIl-tE.mjs";
+import { C as agentVersionConstraintGroupsOverlap, D as normalizeAgentLocale, E as normalizeAgentFramework, O as normalizeAgentScopeValues, S as resolveSearchRequestConfig, T as agentVersionConstraintsOverlap, k as normalizeAgentVersion, m as performDocsSearch, n as buildDocsAskAIContext, p as normalizeDocsSearchFilters, w as agentVersionConstraintMatches } from "./search-Da2AKaFJ.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
 import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";

package/dist/{agent-export-B92pNe6g.mjs → agent-export-CM-p9_YD.mjs}

@@ -1,14 +1,14 @@
-import { A as buildDocsAgentDiscoverySpec, Bt as renderDocsSitemapMarkdown, Ht as resolveDocsSitemapConfig, Lt as buildDocsSitemapManifest, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Vt as renderDocsSitemapXml, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsLlmsTxt, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-BJ0KXN-A.mjs";
+import { A as buildDocsAgentDiscoverySpec, Bt as renderDocsSitemapMarkdown, Ht as resolveDocsSitemapConfig, Lt as buildDocsSitemapManifest, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Vt as renderDocsSitemapXml, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsLlmsTxt, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-SRIJ-oF8.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
-import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, 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, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BwL5ffGx.mjs";
-import "./search-DIyIl-tE.mjs";
+import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, 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, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BKlEnK_H.mjs";
+import "./search-Da2AKaFJ.mjs";
 import { t as resolveDocsI18n } from "./i18n-hHVWcflJ.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-RbgmSvPH.mjs";
-import "./sitemap-server-BfyBM7_V.mjs";
-import "./agent-evals-LIScgQVm.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-CgH6Stqn.mjs";
+import "./sitemap-server-DHaxyPAd.mjs";
+import "./agent-evals-DmFoKy_y.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.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-bundle.d.mts

@@ -1,4 +1,4 @@
-import { L as DocsPublishedAgentSkill } from "./standards-discovery-CdrOE-05.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-BbslY4id.mjs";
 
 //#region src/agent-skills-bundle.d.ts
 /**

package/dist/{agent-skills-server-noFn1l_p.mjs → agent-skills-server-B2EXn2QD.mjs}

@@ -1,4 +1,4 @@
-import { f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, j as buildDocsPublishedAgentSkill } from "./standards-discovery-BwL5ffGx.mjs";
+import { f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, j as buildDocsPublishedAgentSkill } from "./standards-discovery-BKlEnK_H.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
 import path from "node:path";
 import { createHash } from "node:crypto";

package/dist/{agent-skills-server-BqvIGQb1.d.mts → agent-skills-server-CJ4D0G9P.d.mts}

@@ -1,5 +1,5 @@
-import { $ as DocsAgentSkillsInput } from "./types-clg5J1R4.mjs";
-import { L as DocsPublishedAgentSkill } from "./standards-discovery-CdrOE-05.mjs";
+import { $ as DocsAgentSkillsInput } from "./types-B-5Kzmkn.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-BbslY4id.mjs";
 
 //#region src/agent-skills-server.d.ts
 interface ResolveConfiguredAgentSkillsOptions {

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

@@ -1,6 +1,6 @@
-import { $ as DocsAgentSkillsInput } from "./types-clg5J1R4.mjs";
-import { L as DocsPublishedAgentSkill } from "./standards-discovery-CdrOE-05.mjs";
-import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-BqvIGQb1.mjs";
+import { $ as DocsAgentSkillsInput } from "./types-B-5Kzmkn.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-BbslY4id.mjs";
+import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-CJ4D0G9P.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-BwL5ffGx.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
+import "./standards-discovery-BKlEnK_H.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.mjs";
 
 //#region src/agent-skills-vite.ts
 const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";

package/dist/{agents-C228QGbp.mjs → agents-BeLDNCnE.mjs}

@@ -1,12 +1,12 @@
-import { a as DEFAULT_AGENT_MD_ROUTE, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-BJ0KXN-A.mjs";
+import { a as DEFAULT_AGENT_MD_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-SRIJ-oF8.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
-import "./standards-discovery-BwL5ffGx.mjs";
-import "./search-DIyIl-tE.mjs";
-import { S as resolveApiReferenceConfig } from "./sitemap-server-BfyBM7_V.mjs";
-import "./agent-evals-LIScgQVm.mjs";
+import "./standards-discovery-BKlEnK_H.mjs";
+import "./search-Da2AKaFJ.mjs";
+import { C as resolveApiReferenceOpenApiDiscovery } from "./sitemap-server-DHaxyPAd.mjs";
+import "./agent-evals-DmFoKy_y.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-noFn1l_p.mjs";
+import "./agent-skills-server-B2EXn2QD.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";
@@ -129,16 +129,7 @@ function writeIfNeeded(filePath, content, options) {
 	return "changed";
 }
 function resolveOpenApiDiscovery(config) {
-	const apiReference = resolveApiReferenceConfig(config?.apiReference);
-	if (!apiReference.enabled) return { enabled: false };
-	return {
-		enabled: true,
-		url: DEFAULT_OPENAPI_SCHEMA_ROUTE,
-		urlSource: "default",
-		source: apiReference.specUrl ? "configured" : "generated",
-		specUrl: apiReference.specUrl,
-		apiReferencePath: `/${apiReference.path}`
-	};
+	return resolveApiReferenceOpenApiDiscovery(config?.apiReference);
 }
 async function generateAgents(options = {}) {
 	const rootDir = process.cwd();

package/dist/cli/index.mjs

@@ -111,7 +111,7 @@ async function main() {
 		const { init } = await import("../init-DAkI0Lkf.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-Cc1cFFj-.mjs");
+		const { dev } = await import("../dev-kjaxOOla.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
 		const { runCloudDeploy } = await import("../cloud-pdNC-tyj.mjs");
@@ -141,10 +141,10 @@ async function main() {
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-YD37HlPY.mjs");
+		const { runMcp } = await import("../mcp-CZkQJXtA.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-D0LEY2Vy.mjs").then((n) => n.t);
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-D4hNGatV.mjs").then((n) => n.t);
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -152,7 +152,7 @@ async function main() {
 		}
 		await compactAgentDocs(agentCompactOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "export") {
-		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-B92pNe6g.mjs");
+		const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-CM-p9_YD.mjs");
 		const agentExportOptions = parseAgentExportArgs(args.slice(2));
 		if (agentExportOptions.help) {
 			printAgentExportHelp();
@@ -162,13 +162,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-D0LEY2Vy.mjs").then((n) => n.t);
-		const { printAgentExportHelp } = await import("../agent-export-B92pNe6g.mjs");
+		const { printAgentCompactHelp } = await import("../agent-D4hNGatV.mjs").then((n) => n.t);
+		const { printAgentExportHelp } = await import("../agent-export-CM-p9_YD.mjs");
 		printAgentCompactHelp();
 		printAgentExportHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-C228QGbp.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BeLDNCnE.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -178,11 +178,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-C228QGbp.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-BeLDNCnE.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-CgrUZ3tY.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-DhMVKHjp.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -190,7 +190,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-Dbzkdl6K.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-nxoV8jIm.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -212,7 +212,7 @@ async function main() {
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-hcqaEZVN.mjs");
+		const { syncSearch } = await import("../search-BTUIkhnT.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -220,7 +220,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-jhkS_jYx.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-e0_GeCWJ.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -230,11 +230,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-jhkS_jYx.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-e0_GeCWJ.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DUO0r4UI.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-CiQT8mX2.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -244,7 +244,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-DUO0r4UI.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-CiQT8mX2.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {

package/dist/client/react.d.mts

@@ -1,4 +1,4 @@
-import { rt as DocsAnalyticsConfig } from "../types-clg5J1R4.mjs";
+import { rt as DocsAnalyticsConfig } from "../types-B-5Kzmkn.mjs";
 import { ReactNode } from "react";
 
 //#region src/docs-cloud-client.d.ts

package/dist/{cloud-ask-ai-6X9pVjIY.d.mts → cloud-ask-ai-BCgHPxew.d.mts}

@@ -1,4 +1,4 @@
-import { _t as DocsCloudConfig, rt as DocsAnalyticsConfig, t as AIConfig } from "./types-clg5J1R4.mjs";
+import { _t as DocsCloudConfig, rt as DocsAnalyticsConfig, t as AIConfig } from "./types-B-5Kzmkn.mjs";
 
 //#region src/cloud-ask-ai.d.ts
 interface DocsCloudAskAIConfig {

package/dist/{dev-Cc1cFFj-.mjs → dev-kjaxOOla.mjs}

@@ -191,6 +191,7 @@ const managedConfigSchema = z.object({
 			name: z.string().optional(),
 			path: z.string(),
 			route: z.string().optional(),
+			catalogTargets: z.array(z.string()).optional(),
 			navigationLabel: z.string().optional()
 		}).passthrough()).optional()
 	}).passthrough().optional(),
@@ -240,11 +241,13 @@ function resolveManagedOpenApiSpec(projectRoot, openapi) {
 	if (configured) {
 		const rawPath = configured.path.trim();
 		const route = normalizeManagedRoutePath(configured.route);
+		const catalogTargets = configured.catalogTargets === void 0 ? void 0 : Array.from(new Set(configured.catalogTargets.map((target) => target.trim()).filter(Boolean)));
 		if (isRemoteManagedSpecPath(rawPath) || isRequestRelativeManagedSpecPath(rawPath)) return {
 			name: configured.name?.trim() || "API Reference",
 			route,
 			path: rawPath,
 			specUrl: rawPath,
+			catalogTargets,
 			navigationLabel: configured.navigationLabel?.trim() || void 0
 		};
 		return {
@@ -252,6 +255,7 @@ function resolveManagedOpenApiSpec(projectRoot, openapi) {
 			route,
 			path: rawPath,
 			specUrl: DEFAULT_MANAGED_OPENAPI_ENDPOINT,
+			catalogTargets,
 			sourcePath: path.resolve(projectRoot, rawPath),
 			navigationLabel: configured.navigationLabel?.trim() || void 0
 		};
@@ -585,12 +589,13 @@ function renderEmptyHomePage() {
 `;
 }
 function renderDocsConfigFile(options) {
+	const catalogTargetsLine = options.apiReference?.catalogTargets === void 0 ? "" : `    catalogTargets: ${JSON.stringify(options.apiReference.catalogTargets)},\n`;
 	const apiReferenceBlock = options.apiReference ? `  apiReference: {
     enabled: true,
     path: ${JSON.stringify(options.apiReference.path)},
     renderer: "fumadocs",
     specUrl: ${JSON.stringify(options.apiReference.specUrl)},
-  },
+${catalogTargetsLine}  },
 ` : "";
 	const analyticsBlock = renderManagedAnalyticsBlock(options.analytics);
 	return `import { defineDocs } from "@farming-labs/docs";
@@ -976,7 +981,8 @@ function materializeManagedRuntime(projectRoot) {
 		analytics: project.analytics,
 		apiReference: project.apiReferenceSpec ? {
 			path: apiReferenceRoute,
-			specUrl: project.apiReferenceSpec.specUrl
+			specUrl: project.apiReferenceSpec.specUrl,
+			catalogTargets: project.apiReferenceSpec.catalogTargets
 		} : void 0
 	}));
 	if (!project.apiReferenceSpec) writeFileIfChanged(path.join(project.runtimeDir, "api-reference.config.ts"), renderDocsConfigFile({

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

@@ -1,5 +1,5 @@
-import { at as DocsAnalyticsEventInput, it as DocsAnalyticsEvent, rt as DocsAnalyticsConfig } from "./types-clg5J1R4.mjs";
-import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-6X9pVjIY.mjs";
+import { at as DocsAnalyticsEventInput, it as DocsAnalyticsEvent, rt as DocsAnalyticsConfig } from "./types-B-5Kzmkn.mjs";
+import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-BCgHPxew.mjs";
 
 //#region src/docs-cloud-server.d.ts
 type DocsCloudRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);

package/dist/{doctor-CgrUZ3tY.mjs → doctor-DhMVKHjp.mjs}

@@ -1,21 +1,21 @@
-import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-D0LEY2Vy.mjs";
-import { d as httpLinkHeaderHasTargetRelation, f as AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES, p as readAgentSkillDocumentFromTar } from "./prompt-references-BIS1eXt4.mjs";
-import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, F as buildDocsMcpEndpointCandidates, Ft as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Ht as resolveDocsSitemapConfig, It as DEFAULT_SITEMAP_XML_ROUTE, M as buildDocsConfigMap, Pt as DEFAULT_SITEMAP_MD_ROUTE, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as isDocsMcpOAuthScopeToken, on as normalizeDocsMcpAuthorizationServerUrls, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-BJ0KXN-A.mjs";
+import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-D4hNGatV.mjs";
+import { d as httpLinkHeaderHasTargetRelation, f as AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES, p as readAgentSkillDocumentFromTar } from "./prompt-references-B6L3AD98.mjs";
+import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, F as buildDocsMcpEndpointCandidates, Ft as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Ht as resolveDocsSitemapConfig, It as DEFAULT_SITEMAP_XML_ROUTE, M as buildDocsConfigMap, Pt as DEFAULT_SITEMAP_MD_ROUTE, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as isDocsMcpOAuthScopeToken, on as normalizeDocsMcpAuthorizationServerUrls, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-SRIJ-oF8.mjs";
 import { f as PAGE_AGENT_CONTRACT_FIELDS } from "./markdown-sections-7OoA7ylx.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
-import { I as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, 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 } from "./standards-discovery-BwL5ffGx.mjs";
-import { h as resolveAskAISearchRequestConfig } from "./search-DIyIl-tE.mjs";
-import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-RbgmSvPH.mjs";
+import { I as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, 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 } from "./standards-discovery-BKlEnK_H.mjs";
+import { g as resolveAskAISearchRequestConfig } from "./search-Da2AKaFJ.mjs";
+import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-CgH6Stqn.mjs";
 import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
-import "./sitemap-server-BfyBM7_V.mjs";
-import { t as runDocsGoldenTasks } from "./agent-evals-LIScgQVm.mjs";
+import "./sitemap-server-DHaxyPAd.mjs";
+import { t as runDocsGoldenTasks } from "./agent-evals-DmFoKy_y.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.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-DTEPZeb0.mjs";
+import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-VzE6juQl.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";
@@ -1029,18 +1029,52 @@ async function probeMcpRoute(baseUrl, route, expectedTools) {
 			detail: `${route} initialize returned HTTP ${initializeResponse.status}: ${String(initializePayload.error?.message ?? "unknown MCP error")}.`
 		};
 		const sessionId = initializeResponse.headers.get("mcp-session-id") ?? void 0;
-		if (sessionId) await postMcpJson(baseUrl, route, {
+		await postMcpJson(baseUrl, route, {
 			jsonrpc: "2.0",
 			method: "notifications/initialized",
 			params: {}
 		}, sessionId).catch(() => void 0);
-		const toolsResponse = await postMcpJson(baseUrl, route, {
-			jsonrpc: "2.0",
-			id: "doctor-tools-list",
-			method: "tools/list",
-			params: {}
-		}, sessionId);
-		const toolsPayload = await parseMcpResponse(toolsResponse);
+		const toolNames = /* @__PURE__ */ new Set();
+		const seenCursors = /* @__PURE__ */ new Set();
+		let cursor;
+		let toolsListError;
+		let completedToolsList = false;
+		for (let page = 0; page < 20; page += 1) {
+			const toolsResponse = await postMcpJson(baseUrl, route, {
+				jsonrpc: "2.0",
+				id: `doctor-tools-list-${page + 1}`,
+				method: "tools/list",
+				params: cursor !== void 0 ? { cursor } : {}
+			}, sessionId);
+			const toolsPayload = await parseMcpResponse(toolsResponse);
+			if (!toolsResponse.ok || toolsPayload.error) {
+				toolsListError = {
+					status: toolsResponse.status,
+					message: String(toolsPayload.error?.message ?? "unknown MCP error")
+				};
+				break;
+			}
+			const result = toolsPayload.result;
+			for (const tool of result?.tools ?? []) if (typeof tool.name === "string") toolNames.add(tool.name);
+			const nextCursor = result?.nextCursor;
+			if (nextCursor === void 0) {
+				completedToolsList = true;
+				break;
+			}
+			if (typeof nextCursor !== "string" || seenCursors.has(nextCursor)) {
+				toolsListError = {
+					status: toolsResponse.status,
+					message: "server returned an invalid or repeated pagination cursor"
+				};
+				break;
+			}
+			seenCursors.add(nextCursor);
+			cursor = nextCursor;
+		}
+		if (!completedToolsList && !toolsListError) toolsListError = {
+			status: 200,
+			message: "server exceeded the 20-page tools/list safety limit"
+		};
 		if (sessionId) await fetchWithTimeout(joinDoctorUrl(baseUrl, route), {
 			method: "DELETE",
 			headers: {
@@ -1048,20 +1082,18 @@ async function probeMcpRoute(baseUrl, route, expectedTools) {
 				"mcp-session-id": sessionId
 			}
 		}).catch(() => void 0);
-		if (!toolsResponse.ok || toolsPayload.error) return {
+		if (toolsListError) return {
 			ok: false,
-			detail: `${route} tools/list returned HTTP ${toolsResponse.status}: ${String(toolsPayload.error?.message ?? "unknown MCP error")}.`
+			detail: `${route} tools/list returned HTTP ${toolsListError.status}: ${toolsListError.message}.`
 		};
-		const tools = toolsPayload.result?.tools;
-		const toolNames = Array.isArray(tools) ? tools.map((tool) => tool.name).filter((name) => typeof name === "string") : [];
-		const missingTools = expectedTools.filter((tool) => !toolNames.includes(tool));
+		const missingTools = expectedTools.filter((tool) => !toolNames.has(tool));
 		if (missingTools.length > 0) return {
 			ok: false,
 			detail: `${route} connected but is missing tools: ${missingTools.join(", ")}.`
 		};
 		return {
 			ok: true,
-			detail: `${route} initialized ${sessionId ? "with a session" : "statelessly"} and exposed ${toolNames.length} MCP tool${toolNames.length === 1 ? "" : "s"}.`
+			detail: `${route} initialized ${sessionId ? "with a session" : "statelessly"} and exposed ${toolNames.size} MCP tool${toolNames.size === 1 ? "" : "s"}.`
 		};
 	} catch (error) {
 		return {
@@ -1416,6 +1448,7 @@ function hostedMcpRoutes(discoveryBody) {
 const MCP_DISCOVERY_TOOL_NAMES = [
 	["listDocs", "list_docs"],
 	["listPages", "list_pages"],
+	["listPageSections", "list_page_sections"],
 	["listTasks", "list_tasks"],
 	["readTask", "read_task"],
 	["getNavigation", "get_navigation"],

package/dist/{golden-evaluations-DTEPZeb0.mjs → golden-evaluations-VzE6juQl.mjs}

@@ -1,6 +1,6 @@
-import { Ot as findDocsAudienceMdxTags, jt as resolveDocsAudienceMdxContent } from "./agent-BJ0KXN-A.mjs";
+import { Ot as findDocsAudienceMdxTags, jt as resolveDocsAudienceMdxContent } from "./agent-SRIJ-oF8.mjs";
 import { _ as hasStructuredPageAgentContract, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
-import { C as agentVersionConstraintsOverlap, D as normalizeAgentVersion, w as normalizeAgentFramework } from "./search-DIyIl-tE.mjs";
+import { E as normalizeAgentFramework, T as agentVersionConstraintsOverlap, k as normalizeAgentVersion } from "./search-Da2AKaFJ.mjs";
 import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
@@ -1700,7 +1700,11 @@ function analyzeAgentSurfaceDrift(options) {
 			"package",
 			"tags"
 		]],
-		["search.warningsField", "warnings"]
+		["search.warningsField", "warnings"],
+		["search.cursorParam", "cursor"],
+		["search.nextCursorField", "nextCursor"],
+		["search.hasMoreField", "hasMore"],
+		["search.totalField", "total"]
 	]) compareExpectedValue(issues, options.discovery, "search-scope-mismatch", path, expected, `Discovery ${path}`);
 	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");