@farming-labs/docs 0.2.74 → 0.2.75

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/dist/{agent-BJ0KXN-A.mjs → agent-BHqaZx-X.mjs} +2 -0
  2. package/dist/{agent-D0LEY2Vy.mjs → agent-DxTa3PLB.mjs} +2 -2
  3. package/dist/agent-cAPjC2jb.d.mts +922 -0
  4. package/dist/{agent-evals-LIScgQVm.mjs → agent-evals-21LZ_uEl.mjs} +1 -1
  5. package/dist/{agent-export-B92pNe6g.mjs → agent-export-3VheegEK.mjs} +5 -5
  6. package/dist/agent-skills-bundle.d.mts +1 -1
  7. package/dist/{agent-skills-server-BqvIGQb1.d.mts → agent-skills-server-Cix64aGB.d.mts} +2 -2
  8. package/dist/agent-skills-vite.d.mts +3 -3
  9. package/dist/{agents-C228QGbp.mjs → agents-ByTdP0Hl.mjs} +4 -4
  10. package/dist/cli/index.mjs +14 -14
  11. package/dist/client/react.d.mts +1 -1
  12. package/dist/{cloud-ask-ai-6X9pVjIY.d.mts → cloud-ask-ai-Bt0rzFbe.d.mts} +1 -1
  13. package/dist/docs-cloud-server.d.mts +2 -2
  14. package/dist/{doctor-CgrUZ3tY.mjs → doctor-C34VVF85.mjs} +9 -8
  15. package/dist/{golden-evaluations-DTEPZeb0.mjs → golden-evaluations-D_oDJwGv.mjs} +2 -2
  16. package/dist/index.d.mts +4 -875
  17. package/dist/index.mjs +4 -4
  18. package/dist/{mcp-YD37HlPY.mjs → mcp-Bnqfu8P5.mjs} +5 -4
  19. package/dist/mcp.d.mts +8 -4
  20. package/dist/mcp.mjs +236 -16
  21. package/dist/{prompt-references-BIS1eXt4.mjs → prompt-references-CfyYOa_W.mjs} +2 -2
  22. package/dist/{retrieval-digest-9Kp3uSaZ.d.mts → retrieval-digest-CFOcSKTo.d.mts} +4 -48
  23. package/dist/{review-Dbzkdl6K.mjs → review-Dw6oCQX3.mjs} +4 -4
  24. package/dist/{robots-RbgmSvPH.mjs → robots-DaYBoy_A.mjs} +1 -1
  25. package/dist/{robots-DUO0r4UI.mjs → robots-KWLujSLI.mjs} +2 -2
  26. package/dist/{search-DIyIl-tE.mjs → search-BmC8wVr0.mjs} +1 -1
  27. package/dist/{search-hcqaEZVN.mjs → search-DBdmbUkc.mjs} +4 -4
  28. package/dist/server.d.mts +7 -6
  29. package/dist/server.mjs +4 -4
  30. package/dist/{sitemap-jhkS_jYx.mjs → sitemap-CrzG5Wpf.mjs} +4 -4
  31. package/dist/{sitemap-server-BfyBM7_V.mjs → sitemap-server-B9LZQ1FE.mjs} +1 -1
  32. package/dist/{standards-discovery-CdrOE-05.d.mts → standards-discovery-DBI1PD7m.d.mts} +1 -1
  33. package/dist/{types-clg5J1R4.d.mts → types-BDRwrExu.d.mts} +5 -0
  34. package/package.json +1 -1
package/dist/index.mjs CHANGED
@@ -1,12 +1,12 @@
1
- import { _ as resolveChangelogConfig, a as resolveReadingTimeFromContent, c as DOCS_AGENT_CONTRACT_VERSION, g as deepMerge, h as extendTheme, i as resolvePageReadingTime, l as createDocsAgentContractCases, m as createTheme, n as encodeDocsHeadingTocUrls, o as resolveReadingTimeFromSource, r as estimateReadingTimeMinutes, s as resolveReadingTimeOptions, t as isolateDocsMarkdownPromptReferences, u as runDocsAgentConformance, v as defineDocs } from "./prompt-references-BIS1eXt4.mjs";
1
+ import { _ as resolveChangelogConfig, a as resolveReadingTimeFromContent, c as DOCS_AGENT_CONTRACT_VERSION, g as deepMerge, h as extendTheme, i as resolvePageReadingTime, l as createDocsAgentContractCases, m as createTheme, n as encodeDocsHeadingTocUrls, o as resolveReadingTimeFromSource, r as estimateReadingTimeMinutes, s as resolveReadingTimeOptions, t as isolateDocsMarkdownPromptReferences, u as runDocsAgentConformance, v as defineDocs } from "./prompt-references-CfyYOa_W.mjs";
2
2
  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";
3
- import { $ as matchesDocsLlmsTxtSection, $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, At as resolveDocsAudienceExposure, B as findDocsMarkdownPage, Bt as renderDocsSitemapMarkdown, C as DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, Ct as selectDocsMarkdownSection, D as DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, Dt as findDocsAudienceMdxIssues, E as DOCS_MARKDOWN_SECTION_INDEX_FORMAT, F as buildDocsMcpEndpointCandidates, Ft as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, G as isDocsAgentDiscoveryRequest, Gt as toDocsSitemapMarkdownUrl, H as getDocsMarkdownCanonicalLinkHeader, Ht as resolveDocsSitemapConfig, I as collectDocsMarkdownSections, It as DEFAULT_SITEMAP_XML_ROUTE, J as isDocsDiagnosticsRequest, Jt as DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, K as isDocsAgentsRequest, Kt as normalizeDocsRelated, L as createDocsMarkdownResponse, Lt as buildDocsSitemapManifest, M as buildDocsConfigMap, Mt as DEFAULT_SITEMAP_MANIFEST_PATH, N as buildDocsDiagnostics, Nt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, O as DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, P as buildDocsMarkdownSectionIndex, Pt as DEFAULT_SITEMAP_MD_ROUTE, Q as isDocsSkillRequest, Qt as buildDocsMcpProtectedResourceMetadataRoute, R as createDocsStandardsDiscoveryResponse, Rt as createDocsSitemapResponse, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, St as selectDocsLlmsTxtContent, Tt as validateDocsAgentFeedbackPayload, U as getDocsMarkdownVaryHeader, Ut as resolveDocsSitemapPageLastmod, V as getDocsLlmsTxtMaxCharsIssue, Vt as renderDocsSitemapXml, W as hasDocsMarkdownSignatureAgent, Wt as resolveDocsSitemapRequest, X as isDocsMarkdownSectionIndexRequest, Xt as DEFAULT_MCP_ROUTE, Y as isDocsLlmsTxtPublicRequest, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Z as isDocsPublicGetRequest, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, _ as DEFAULT_LLMS_TXT_MAX_CHARS, _t as resolveDocsMarkdownRequest, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, bt as resolveDocsRequestApiRoute, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsAgentContractMcpTools, d as DEFAULT_DOCS_CONFIG_FORMAT, dt as resolveDocsAgentsFormat, en as getDocsMcpResourcePaths, et as normalizeDocsPathSegment, f as DEFAULT_DOCS_CONFIG_ROUTE, ft as resolveDocsLlmsTxtFormat, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, gt as resolveDocsMarkdownRecovery, h as DEFAULT_LLMS_FULL_TXT_ROUTE, ht as resolveDocsMarkdownCanonicalUrl, i as DEFAULT_AGENT_FEEDBACK_ROUTE, in as isDocsMcpRequest, it as renderDocsLlmsTxt, j as buildDocsAgentFeedbackSchema, jt as resolveDocsAudienceMdxContent, k as acceptsDocsMarkdown, kt as resolveDocsAgentMdxContent, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, mt as resolveDocsLlmsTxtSections, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as parseDocsAgentFeedbackData, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsMarkdownNotFound, p as DEFAULT_DOCS_DIAGNOSTICS_FORMAT, pt as resolveDocsLlmsTxtRequest, q as isDocsConfigRequest, qt as renderDocsRelatedMarkdownLines, r as DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, rt as renderDocsAgentsDocument, s as DEFAULT_AGENT_SPEC_ROUTE, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, tn as hasDocsMcpProtectedResourceConfig, tt as normalizeDocsUrlPath, u as DEFAULT_DOCS_API_ROUTE, ut as resolveDocsAgentFeedbackRequest, v as DEFAULT_LLMS_TXT_ROUTE, vt as resolveDocsMarkdownSectionRequest, w as DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, xt as resolveDocsSkillFormat, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, yt as resolveDocsOpenApiDiscoveryConfig, z as detectDocsMarkdownAgentRequest, zt as readDocsSitemapManifestFromContentMap } from "./agent-BJ0KXN-A.mjs";
3
+ import { $ as matchesDocsLlmsTxtSection, $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, At as resolveDocsAudienceExposure, B as findDocsMarkdownPage, Bt as renderDocsSitemapMarkdown, C as DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, Ct as selectDocsMarkdownSection, D as DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, Dt as findDocsAudienceMdxIssues, E as DOCS_MARKDOWN_SECTION_INDEX_FORMAT, F as buildDocsMcpEndpointCandidates, Ft as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, G as isDocsAgentDiscoveryRequest, Gt as toDocsSitemapMarkdownUrl, H as getDocsMarkdownCanonicalLinkHeader, Ht as resolveDocsSitemapConfig, I as collectDocsMarkdownSections, It as DEFAULT_SITEMAP_XML_ROUTE, J as isDocsDiagnosticsRequest, Jt as DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, K as isDocsAgentsRequest, Kt as normalizeDocsRelated, L as createDocsMarkdownResponse, Lt as buildDocsSitemapManifest, M as buildDocsConfigMap, Mt as DEFAULT_SITEMAP_MANIFEST_PATH, N as buildDocsDiagnostics, Nt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, O as DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, P as buildDocsMarkdownSectionIndex, Pt as DEFAULT_SITEMAP_MD_ROUTE, Q as isDocsSkillRequest, Qt as buildDocsMcpProtectedResourceMetadataRoute, R as createDocsStandardsDiscoveryResponse, Rt as createDocsSitemapResponse, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, St as selectDocsLlmsTxtContent, Tt as validateDocsAgentFeedbackPayload, U as getDocsMarkdownVaryHeader, Ut as resolveDocsSitemapPageLastmod, V as getDocsLlmsTxtMaxCharsIssue, Vt as renderDocsSitemapXml, W as hasDocsMarkdownSignatureAgent, Wt as resolveDocsSitemapRequest, X as isDocsMarkdownSectionIndexRequest, Xt as DEFAULT_MCP_ROUTE, Y as isDocsLlmsTxtPublicRequest, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Z as isDocsPublicGetRequest, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, _ as DEFAULT_LLMS_TXT_MAX_CHARS, _t as resolveDocsMarkdownRequest, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, bt as resolveDocsRequestApiRoute, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsAgentContractMcpTools, d as DEFAULT_DOCS_CONFIG_FORMAT, dt as resolveDocsAgentsFormat, en as getDocsMcpResourcePaths, et as normalizeDocsPathSegment, f as DEFAULT_DOCS_CONFIG_ROUTE, ft as resolveDocsLlmsTxtFormat, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, gt as resolveDocsMarkdownRecovery, h as DEFAULT_LLMS_FULL_TXT_ROUTE, ht as resolveDocsMarkdownCanonicalUrl, i as DEFAULT_AGENT_FEEDBACK_ROUTE, in as isDocsMcpRequest, it as renderDocsLlmsTxt, j as buildDocsAgentFeedbackSchema, jt as resolveDocsAudienceMdxContent, k as acceptsDocsMarkdown, kt as resolveDocsAgentMdxContent, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, mt as resolveDocsLlmsTxtSections, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nt as parseDocsAgentFeedbackData, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsMarkdownNotFound, p as DEFAULT_DOCS_DIAGNOSTICS_FORMAT, pt as resolveDocsLlmsTxtRequest, q as isDocsConfigRequest, qt as renderDocsRelatedMarkdownLines, r as DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, rt as renderDocsAgentsDocument, s as DEFAULT_AGENT_SPEC_ROUTE, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, tn as hasDocsMcpProtectedResourceConfig, tt as normalizeDocsUrlPath, u as DEFAULT_DOCS_API_ROUTE, ut as resolveDocsAgentFeedbackRequest, v as DEFAULT_LLMS_TXT_ROUTE, vt as resolveDocsMarkdownSectionRequest, w as DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, xt as resolveDocsSkillFormat, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, yt as resolveDocsOpenApiDiscoveryConfig, z as detectDocsMarkdownAgentRequest, zt as readDocsSitemapManifestFromContentMap } from "./agent-BHqaZx-X.mjs";
4
4
  import { S as upsertPageAgentContractMarkdown, _ as hasStructuredPageAgentContract, b as renderPageAgentFrontmatterYamlLines, c as slugifyDocsMarkdownHeading, d as PAGE_AGENT_CONTRACT_END_MARKER, f as PAGE_AGENT_CONTRACT_FIELDS, g as getPageAgentFrontmatterIssues, h as PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, i as createDocsRenderedHeadingAnchorResolver, m as PAGE_AGENT_CONTRACT_START_MARKER, n as cleanDocsRenderedHeadingLabel, p as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, r as createDocsMarkdownHeadingAnchorResolver, t as applyDocsMarkdownHeadingAnchors, u as withDocsMarkdownRenderableHeadings, v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown, y as renderPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
5
5
  import { AGENT_SKILL_COMPATIBILITY_MAX_LENGTH, AGENT_SKILL_DESCRIPTION_MAX_LENGTH, AGENT_SKILL_FRONTMATTER_FIELDS, AGENT_SKILL_NAME_MAX_LENGTH, DocsAgentSkillFrontmatterError, isDocsAgentSkillName, parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
6
6
  import { A as buildDocsLegacySkillsIndex, C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, D as buildDocsA2AAgentCard, E as appendDocsDiscoveryLinkHeader, F as isDocsStandardsDiscoveryRequest, I as resolveDocsDiscoveryApiRoute, L as resolveDocsPublishedAgentSkill, M as createDocsStandardsResponse, N as getDocsAgentManifestLinkHeader, O as buildDocsAgentSkillsIndex, P as getDocsDiscoveryLinkHeader, R as resolveDocsStandardsDiscoveryRequest, 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, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, g as DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, h as DEFAULT_AGENT_SKILL_FORMAT, i as DEFAULT_A2A_AGENT_CARD_FORMAT, k as buildDocsApiCatalog, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, m as DEFAULT_AGENT_SKILL_FILE_FORMAT, n as API_CATALOG_MEDIA_TYPE, o as DEFAULT_A2A_PROTOCOL_BINDING, p as DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, r as API_CATALOG_PROFILE_URI, s as DEFAULT_A2A_PROTOCOL_VERSION, 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, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, y as DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, z as sha256DocsDiscoveryContent } from "./standards-discovery-BwL5ffGx.mjs";
7
- import { A as GENERATED_AGENT_PROVENANCE_MARKER, B as resolveSidebarFolderIndexBehaviorForPath, F as serializeGeneratedAgentDocument, G as getDocsTelemetryFeatures, H as emitDocsTelemetryEvent, I as stripGeneratedAgentProvenance, J as normalizeDocsTelemetryOrigin, K as inferDocsTelemetryAgentSurface, L as applySidebarFolderIndexBehavior, M as hashGeneratedAgentContent, N as normalizeGeneratedAgentContent, O as digestDocsRetrievalContent, P as parseGeneratedAgentDocument, R as resolvePageSidebarFolderIndexBehavior, U as emitDocsTelemetryMcpToolEvent, V as emitDocsTelemetryAgentSurfaceEvent, W as emitDocsTelemetryProjectEvent, Y as resolveDocsTelemetryConfig, _ as resolveDocsSearchAudience, a as createCustomSearchAdapter, b as resolveSearchRequestConfig, c as createTypesenseSearchAdapter, d as inferDocsAskAIPackageHints, f as normalizeDocsSearchFilters, g as resolveDocsRetrievalLastModified, h as resolveAskAISearchRequestConfig, i as createAlgoliaSearchAdapter, j as GENERATED_AGENT_PROVENANCE_VERSION, k as isDocsRetrievalCanonicalUrl, l as enrichDocsSearchDocumentsWithProvenance, m as performDocsSearchWithMetadata, n as buildDocsRetrievalDigestProjection, o as createMcpSearchAdapter, p as performDocsSearch, q as isLocalDocsTelemetryOrigin, r as buildDocsSearchDocuments, s as createSimpleSearchAdapter, t as buildDocsAskAIContext, u as formatDocsAskAIPackageHints, v as resolveDocsSearchFilters, y as resolveDocsSearchRequest, z as resolveSidebarFolderIndexBehavior } from "./search-DIyIl-tE.mjs";
7
+ import { A as GENERATED_AGENT_PROVENANCE_MARKER, B as resolveSidebarFolderIndexBehaviorForPath, F as serializeGeneratedAgentDocument, G as getDocsTelemetryFeatures, H as emitDocsTelemetryEvent, I as stripGeneratedAgentProvenance, J as normalizeDocsTelemetryOrigin, K as inferDocsTelemetryAgentSurface, L as applySidebarFolderIndexBehavior, M as hashGeneratedAgentContent, N as normalizeGeneratedAgentContent, O as digestDocsRetrievalContent, P as parseGeneratedAgentDocument, R as resolvePageSidebarFolderIndexBehavior, U as emitDocsTelemetryMcpToolEvent, V as emitDocsTelemetryAgentSurfaceEvent, W as emitDocsTelemetryProjectEvent, Y as resolveDocsTelemetryConfig, _ as resolveDocsSearchAudience, a as createCustomSearchAdapter, b as resolveSearchRequestConfig, c as createTypesenseSearchAdapter, d as inferDocsAskAIPackageHints, f as normalizeDocsSearchFilters, g as resolveDocsRetrievalLastModified, h as resolveAskAISearchRequestConfig, i as createAlgoliaSearchAdapter, j as GENERATED_AGENT_PROVENANCE_VERSION, k as isDocsRetrievalCanonicalUrl, l as enrichDocsSearchDocumentsWithProvenance, m as performDocsSearchWithMetadata, n as buildDocsRetrievalDigestProjection, o as createMcpSearchAdapter, p as performDocsSearch, q as isLocalDocsTelemetryOrigin, r as buildDocsSearchDocuments, s as createSimpleSearchAdapter, t as buildDocsAskAIContext, u as formatDocsAskAIPackageHints, v as resolveDocsSearchFilters, y as resolveDocsSearchRequest, z as resolveSidebarFolderIndexBehavior } from "./search-BmC8wVr0.mjs";
8
8
  import { n as resolveDocsLocale, r as resolveDocsPath, t as resolveDocsI18n } from "./i18n-hHVWcflJ.mjs";
9
- import { a as analyzeDocsRobotsTxt, c as renderDocsRobotsGeneratedBlock, d as resolveDocsRobotsRequest, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, l as renderDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, o as createDocsRobotsResponse, r as DOCS_ROBOTS_GENERATED_BLOCK_END, s as getDocsRobotsAllowRoutes, t as DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, u as resolveDocsRobotsConfig } from "./robots-RbgmSvPH.mjs";
9
+ import { a as analyzeDocsRobotsTxt, c as renderDocsRobotsGeneratedBlock, d as resolveDocsRobotsRequest, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, l as renderDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, o as createDocsRobotsResponse, r as DOCS_ROBOTS_GENERATED_BLOCK_END, s as getDocsRobotsAllowRoutes, t as DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, u as resolveDocsRobotsConfig } from "./robots-DaYBoy_A.mjs";
10
10
  import { a as resolveDocsMetadataBaseUrl, i as renderDocsPageStructuredDataJson, n as buildPageOpenGraph, o as resolveOGImage, r as buildPageTwitter, s as resolveTitle, t as buildDocsPageStructuredData } from "./metadata-N252j5_a.mjs";
11
11
 
12
12
  export { AGENT_SKILLS_DISCOVERY_SCHEMA_URI, AGENT_SKILL_COMPATIBILITY_MAX_LENGTH, AGENT_SKILL_DESCRIPTION_MAX_LENGTH, AGENT_SKILL_FRONTMATTER_FIELDS, AGENT_SKILL_NAME_MAX_LENGTH, API_CATALOG_MEDIA_TYPE, API_CATALOG_PROFILE_URI, DEFAULT_A2A_AGENT_CARD_FORMAT, DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_A2A_PROTOCOL_BINDING, DEFAULT_A2A_PROTOCOL_VERSION, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_INDEX_FORMAT, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_AGENT_SKILL_FILE_FORMAT, DEFAULT_AGENT_SKILL_FORMAT, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_API_CATALOG_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_CONTRACT_VERSION, DOCS_AGENT_MANIFEST_FORMAT, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, DOCS_AGENT_MANIFEST_SCHEMA_URI, DOCS_AGENT_MANIFEST_VERSION, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SECTION_INDEX_FORMAT, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, DocsAgentSkillFrontmatterError, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, acceptsDocsMarkdown, analyzeDocsRobotsTxt, appendDocsDiscoveryLinkHeader, applyDocsMarkdownHeadingAnchors, applySidebarFolderIndexBehavior, buildDocsA2AAgentCard, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAgentSkillsIndex, buildDocsApiCatalog, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsLegacySkillsIndex, buildDocsMarkdownSectionIndex, buildDocsMcpEndpointCandidates, buildDocsMcpProtectedResourceMetadataRoute, buildDocsPageStructuredData, buildDocsRetrievalDigestProjection, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, cleanDocsRenderedHeadingLabel, collectDocsMarkdownSections, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownHeadingAnchorResolver, createDocsMarkdownResponse, createDocsRenderedHeadingAnchorResolver, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, createDocsStandardsResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, digestDocsRetrievalContent, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, encodeDocsHeadingTocUrls, enrichDocsSearchDocumentsWithProvenance, estimateReadingTimeMinutes, extendTheme, findDocsAudienceMdxIssues, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsMcpProtectedResourceMetadataRoutes, getDocsMcpResourcePaths, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasDocsMcpProtectedResourceConfig, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentSkillName, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMarkdownSectionIndexRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsRetrievalCanonicalUrl, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, isLocalDocsTelemetryOrigin, isolateDocsMarkdownPromptReferences, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsSearchFilters, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseDocsAgentSkillFrontmatter, parseGeneratedAgentDocument, performDocsSearch, performDocsSearchWithMetadata, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, renderPageAgentContractMarkdown, renderPageAgentFrontmatterYamlLines, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsAudienceExposure, resolveDocsAudienceMdxContent, resolveDocsDiscoveryApiRoute, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRecovery, resolveDocsMarkdownRequest, resolveDocsMarkdownSectionRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRetrievalLastModified, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSearchAudience, resolveDocsSearchFilters, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsStandardsDiscoveryRequest, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, selectDocsMarkdownSection, serializeGeneratedAgentDocument, sha256DocsDiscoveryContent, slugifyDocsMarkdownHeading, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload, validateDocsAgentSkillFrontmatter, withDocsMarkdownRenderableHeadings };
@@ -1,10 +1,10 @@
1
- import "./agent-BJ0KXN-A.mjs";
1
+ import "./agent-BHqaZx-X.mjs";
2
2
  import "./markdown-sections-7OoA7ylx.mjs";
3
3
  import { L as resolveDocsPublishedAgentSkill } from "./standards-discovery-BwL5ffGx.mjs";
4
- import "./search-DIyIl-tE.mjs";
4
+ import "./search-BmC8wVr0.mjs";
5
5
  import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
6
- import "./sitemap-server-BfyBM7_V.mjs";
7
- import "./agent-evals-LIScgQVm.mjs";
6
+ import "./sitemap-server-B9LZQ1FE.mjs";
7
+ import "./agent-evals-21LZ_uEl.mjs";
8
8
  import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
9
9
  import "./code-blocks-DnNVNK2M.mjs";
10
10
  import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
@@ -143,6 +143,7 @@ function readMcpConfig(content) {
143
143
  tools: {
144
144
  listDocs: readBooleanProperty(block, "listDocs"),
145
145
  listPages: readBooleanProperty(block, "listPages"),
146
+ listPageSections: readBooleanProperty(block, "listPageSections"),
146
147
  listTasks: readBooleanProperty(block, "listTasks"),
147
148
  readTask: readBooleanProperty(block, "readTask"),
148
149
  readPage: readBooleanProperty(block, "readPage"),
package/dist/mcp.d.mts CHANGED
@@ -1,5 +1,6 @@
1
- import { En as DocsTelemetryConfig, Ft as DocsMcpAuthenticate, Kt as DocsObservabilityConfig, Nt as DocsMcpAllowedOrigins, Pt as DocsMcpAuthPrincipal, Rt as DocsMcpConfig, Xt as DocsRetrievalSourceProvenance, Yn as OrderingItem, er as PageAgentFrontmatter, jn as DocsTelemetryFramework, rt as DocsAnalyticsConfig, un as DocsSearchConfig, xn as DocsSearchSourcePage } from "./types-clg5J1R4.mjs";
2
- import { L as DocsPublishedAgentSkill } from "./standards-discovery-CdrOE-05.mjs";
1
+ import { En as DocsTelemetryConfig, Ft as DocsMcpAuthenticate, Kt as DocsObservabilityConfig, Nt as DocsMcpAllowedOrigins, Pt as DocsMcpAuthPrincipal, Rt as DocsMcpConfig, Xt as DocsRetrievalSourceProvenance, Yn as OrderingItem, er as PageAgentFrontmatter, jn as DocsTelemetryFramework, rt as DocsAnalyticsConfig, un as DocsSearchConfig, xn as DocsSearchSourcePage } from "./types-BDRwrExu.mjs";
2
+ import { L as DocsPublishedAgentSkill } from "./standards-discovery-DBI1PD7m.mjs";
3
+ import { it as DocsMarkdownSectionIndex } from "./agent-cAPjC2jb.mjs";
3
4
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
4
5
 
5
6
  //#region src/mcp.d.ts
@@ -26,6 +27,8 @@ interface DocsMcpPage {
26
27
  agentFallbackContent?: string;
27
28
  agentFallbackRawContent?: string;
28
29
  }
30
+ /** Body-free section discovery metadata returned by the `list_page_sections` MCP tool. */
31
+ type DocsMcpPageSectionIndex = DocsMarkdownSectionIndex;
29
32
  interface DocsMcpCodeExample {
30
33
  id: string;
31
34
  page: {
@@ -242,7 +245,8 @@ interface DocsMcpResolvedConfig {
242
245
  version: string;
243
246
  tools: {
244
247
  listDocs: boolean;
245
- listPages: boolean;
248
+ listPages: boolean; /** Optional so manually constructed resolved configs from older releases remain assignable. */
249
+ listPageSections?: boolean;
246
250
  readPage: boolean;
247
251
  listTasks?: boolean;
248
252
  readTask?: boolean;
@@ -311,4 +315,4 @@ declare function getDocsConfigSchema(filters?: {
311
315
  }): DocsMcpConfigSchema;
312
316
  declare function buildDocsMcpContext(options: DocsMcpContextOptions): Promise<DocsMcpContextResult>;
313
317
  //#endregion
314
- export { 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, DocsMcpContextOptions, DocsMcpContextResult, DocsMcpContextSource, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpFolderNode, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpPageNode, DocsMcpRequestContext, DocsMcpResolvedConfig, DocsMcpResolvedCorsConfig, DocsMcpResolvedProtectedResourceConfig, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, buildDocsMcpContext, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };
318
+ export { 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, DocsMcpContextOptions, DocsMcpContextResult, DocsMcpContextSource, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpFolderNode, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpPageNode, DocsMcpPageSectionIndex, DocsMcpRequestContext, DocsMcpResolvedConfig, DocsMcpResolvedCorsConfig, DocsMcpResolvedProtectedResourceConfig, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, buildDocsMcpContext, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };
package/dist/mcp.mjs CHANGED
@@ -1,8 +1,8 @@
1
1
  import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
2
- 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-BJ0KXN-A.mjs";
2
+ import { E as DOCS_MARKDOWN_SECTION_INDEX_FORMAT, Kt as normalizeDocsRelated, P as buildDocsMarkdownSectionIndex, 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, wt as toDocsMarkdownUrl } from "./agent-BHqaZx-X.mjs";
3
3
  import { S as upsertPageAgentContractMarkdown, _ as hasStructuredPageAgentContract, o as findDocsMarkdownSection, s as parseDocsMarkdownSections, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
4
4
  import "./standards-discovery-BwL5ffGx.mjs";
5
- import { C as agentVersionConstraintsOverlap, E as normalizeAgentScopeValues, I as stripGeneratedAgentProvenance, R as resolvePageSidebarFolderIndexBehavior, S as agentVersionConstraintMatches, T as normalizeAgentLocale, U as emitDocsTelemetryMcpToolEvent, V as emitDocsTelemetryAgentSurfaceEvent, W as emitDocsTelemetryProjectEvent, f as normalizeDocsSearchFilters, k as isDocsRetrievalCanonicalUrl, m as performDocsSearchWithMetadata, p as performDocsSearch, w as normalizeAgentFramework } from "./search-DIyIl-tE.mjs";
5
+ import { C as agentVersionConstraintsOverlap, E as normalizeAgentScopeValues, I as stripGeneratedAgentProvenance, R as resolvePageSidebarFolderIndexBehavior, S as agentVersionConstraintMatches, T as normalizeAgentLocale, U as emitDocsTelemetryMcpToolEvent, V as emitDocsTelemetryAgentSurfaceEvent, W as emitDocsTelemetryProjectEvent, f as normalizeDocsSearchFilters, k as isDocsRetrievalCanonicalUrl, m as performDocsSearchWithMetadata, p as performDocsSearch, w as normalizeAgentFramework } from "./search-BmC8wVr0.mjs";
6
6
  import matter from "gray-matter";
7
7
  import fs from "node:fs";
8
8
  import path from "node:path";
@@ -1488,6 +1488,13 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
1488
1488
  default: true,
1489
1489
  description: "Expose the list_pages tool."
1490
1490
  },
1491
+ {
1492
+ path: "mcp.tools.listPageSections",
1493
+ name: "listPageSections",
1494
+ type: "boolean",
1495
+ default: true,
1496
+ description: "Expose the body-free list_page_sections discovery tool for page headings, anchors, hierarchy, sizes, and follow-up fetch URLs."
1497
+ },
1491
1498
  {
1492
1499
  path: "mcp.tools.listTasks",
1493
1500
  name: "listTasks",
@@ -1713,6 +1720,12 @@ const readPageInputSchema = z.object({
1713
1720
  section: z.string().trim().min(1).optional(),
1714
1721
  maxChars: z.number().int().min(256).max(1e6).optional()
1715
1722
  });
1723
+ const listPageSectionsInputSchema = z.object({
1724
+ path: z.string().min(1),
1725
+ locale: z.string().trim().min(1).max(128).optional(),
1726
+ tokenBudget: z.number().int().min(1).max(1e6).optional(),
1727
+ byteBudget: z.number().int().min(1).max(1e6).optional()
1728
+ });
1716
1729
  const listTasksInputSchema = z.object({
1717
1730
  query: z.string().trim().min(1).optional(),
1718
1731
  framework: z.string().trim().min(1).optional(),
@@ -2013,6 +2026,34 @@ const readPageOutputSchema = z.object({
2013
2026
  totalChars: z.number().int().nonnegative(),
2014
2027
  truncated: z.boolean()
2015
2028
  });
2029
+ const pageSectionMetadataOutputSchema = z.object({
2030
+ id: z.string(),
2031
+ heading: z.string(),
2032
+ level: z.number().int().positive(),
2033
+ parentId: z.string().optional(),
2034
+ startLine: z.number().int().positive(),
2035
+ endLine: z.number().int().positive(),
2036
+ estimatedTokens: z.number().int().nonnegative(),
2037
+ utf8Bytes: z.number().int().nonnegative(),
2038
+ canonicalUrl: z.string(),
2039
+ markdownUrl: z.string()
2040
+ });
2041
+ const pageSectionIndexOutputSchema = z.object({
2042
+ schemaVersion: z.literal(2),
2043
+ format: z.literal(DOCS_MARKDOWN_SECTION_INDEX_FORMAT),
2044
+ canonicalUrl: z.string(),
2045
+ markdownUrl: z.string(),
2046
+ sectionIndexUrl: z.string(),
2047
+ lineNumbering: z.literal("body"),
2048
+ sectionCount: z.number().int().nonnegative(),
2049
+ estimatedTokens: z.number().int().nonnegative(),
2050
+ utf8Bytes: z.number().int().nonnegative(),
2051
+ fetchBudget: z.object({
2052
+ tokenBudget: z.number().int().positive().optional(),
2053
+ byteBudget: z.number().int().positive().optional()
2054
+ }).optional(),
2055
+ sections: z.array(pageSectionMetadataOutputSchema)
2056
+ });
2016
2057
  const contextSourceOutputSchema = z.object({
2017
2058
  id: z.string(),
2018
2059
  title: z.string(),
@@ -2069,6 +2110,7 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
2069
2110
  tools: {
2070
2111
  listDocs: true,
2071
2112
  listPages: true,
2113
+ listPageSections: true,
2072
2114
  readPage: true,
2073
2115
  listTasks: true,
2074
2116
  readTask: true,
@@ -2089,6 +2131,7 @@ function resolveDocsMcpConfig(mcp, defaults = {}) {
2089
2131
  tools: {
2090
2132
  listDocs: config.tools?.listDocs ?? true,
2091
2133
  listPages: config.tools?.listPages ?? true,
2134
+ listPageSections: config.tools?.listPageSections ?? true,
2092
2135
  readPage: config.tools?.readPage ?? true,
2093
2136
  listTasks: config.tools?.listTasks ?? true,
2094
2137
  readTask: config.tools?.readTask ?? true,
@@ -3165,6 +3208,154 @@ async function createDocsMcpServer(options) {
3165
3208
  throw error;
3166
3209
  }
3167
3210
  });
3211
+ if (resolved.tools.listPageSections !== false) server.registerTool("list_page_sections", {
3212
+ title: "List sections in a docs page",
3213
+ description: "Discover a page's canonical headings, anchors, hierarchy, line ranges, size estimates, and budget-aware fetch URLs without returning the page body.",
3214
+ inputSchema: listPageSectionsInputSchema,
3215
+ outputSchema: pageSectionIndexOutputSchema,
3216
+ annotations: { readOnlyHint: true }
3217
+ }, async ({ path: requestedPath, locale, tokenBudget, byteBudget }) => {
3218
+ const startedAt = nowMs();
3219
+ const resolvedLocale = resolveSourceLocale(locale);
3220
+ const trace = createDocsAgentTraceContext("mcp.tool.list_page_sections");
3221
+ const callSpanId = createDocsAgentTraceId("span");
3222
+ await emitDocsAgentTraceEvent(options.observability, {
3223
+ type: "tool.call",
3224
+ source: "mcp",
3225
+ traceId: trace.traceId,
3226
+ spanId: callSpanId,
3227
+ name: "list_page_sections",
3228
+ startedAt: trace.startedAt,
3229
+ status: "started",
3230
+ locale: resolvedLocale,
3231
+ inputPreview: {
3232
+ path: requestedPath,
3233
+ locale,
3234
+ resolvedLocale,
3235
+ tokenBudget,
3236
+ byteBudget
3237
+ },
3238
+ metadata: { tool: "list_page_sections" }
3239
+ });
3240
+ try {
3241
+ const page = findDocsPage(dedupePages(await options.source.getPages(resolvedLocale, options.requestContext)), requestedPath, options.source.entry);
3242
+ if (!page) {
3243
+ const elapsed = durationMs(startedAt);
3244
+ await emitDocsAnalyticsEvent(options.analytics, {
3245
+ type: "mcp_tool",
3246
+ source: "mcp",
3247
+ locale: resolvedLocale,
3248
+ properties: {
3249
+ tool: "list_page_sections",
3250
+ requestedPath,
3251
+ found: false,
3252
+ durationMs: elapsed
3253
+ }
3254
+ });
3255
+ trackMcpTool("list_page_sections", {
3256
+ locale: resolvedLocale,
3257
+ resultCount: 0
3258
+ });
3259
+ await emitDocsAgentTraceEvent(options.observability, {
3260
+ type: "tool.error",
3261
+ source: "mcp",
3262
+ traceId: trace.traceId,
3263
+ parentSpanId: callSpanId,
3264
+ name: "list_page_sections",
3265
+ startedAt: trace.startedAt,
3266
+ endedAt: (/* @__PURE__ */ new Date()).toISOString(),
3267
+ durationMs: elapsed,
3268
+ status: "error",
3269
+ locale: resolvedLocale,
3270
+ outputPreview: {
3271
+ found: false,
3272
+ path: requestedPath
3273
+ },
3274
+ metadata: {
3275
+ tool: "list_page_sections",
3276
+ reason: "not_found"
3277
+ }
3278
+ });
3279
+ return {
3280
+ content: [{
3281
+ type: "text",
3282
+ text: JSON.stringify({ error: `No docs page matched "${requestedPath}".` }, null, 2)
3283
+ }],
3284
+ isError: true
3285
+ };
3286
+ }
3287
+ const document = upsertPageAgentContractMarkdown(getDocsMcpSourceMarkdown(page), page.agent);
3288
+ const publicBaseUrl = options.source.baseUrl ?? (options.requestContext?.request ? new URL(options.requestContext.request.url).origin : void 0);
3289
+ const sectionIndex = buildDocsMarkdownSectionIndex(document, {
3290
+ canonicalUrl: resolveDocsMcpPublicUrl(withDocsMcpUrlLocale(page.url, resolvedLocale), publicBaseUrl),
3291
+ markdownUrl: resolveDocsMcpPublicUrl(toDocsMcpPageMarkdownUrl(page.url, resolvedLocale), publicBaseUrl),
3292
+ tokenBudget,
3293
+ byteBudget
3294
+ });
3295
+ const elapsed = durationMs(startedAt);
3296
+ await emitDocsAnalyticsEvent(options.analytics, {
3297
+ type: "mcp_tool",
3298
+ source: "mcp",
3299
+ locale: resolvedLocale,
3300
+ path: page.url,
3301
+ properties: {
3302
+ tool: "list_page_sections",
3303
+ requestedPath,
3304
+ slug: page.slug,
3305
+ found: true,
3306
+ sectionCount: sectionIndex.sectionCount,
3307
+ estimatedTokens: sectionIndex.estimatedTokens,
3308
+ utf8Bytes: sectionIndex.utf8Bytes,
3309
+ tokenBudget,
3310
+ byteBudget,
3311
+ durationMs: elapsed
3312
+ }
3313
+ });
3314
+ trackMcpTool("list_page_sections", {
3315
+ locale: resolvedLocale,
3316
+ resultCount: sectionIndex.sectionCount
3317
+ });
3318
+ await emitDocsAgentTraceEvent(options.observability, {
3319
+ type: "tool.result",
3320
+ source: "mcp",
3321
+ traceId: trace.traceId,
3322
+ parentSpanId: callSpanId,
3323
+ name: "list_page_sections",
3324
+ startedAt: trace.startedAt,
3325
+ endedAt: (/* @__PURE__ */ new Date()).toISOString(),
3326
+ durationMs: elapsed,
3327
+ status: "success",
3328
+ locale: resolvedLocale,
3329
+ path: page.url,
3330
+ outputPreview: {
3331
+ found: true,
3332
+ slug: page.slug,
3333
+ sectionCount: sectionIndex.sectionCount,
3334
+ estimatedTokens: sectionIndex.estimatedTokens,
3335
+ utf8Bytes: sectionIndex.utf8Bytes
3336
+ },
3337
+ metadata: { tool: "list_page_sections" }
3338
+ });
3339
+ return createStructuredTextResult(sectionIndex);
3340
+ } catch (error) {
3341
+ const elapsed = durationMs(startedAt);
3342
+ await emitDocsAgentTraceEvent(options.observability, {
3343
+ type: "tool.error",
3344
+ source: "mcp",
3345
+ traceId: trace.traceId,
3346
+ parentSpanId: callSpanId,
3347
+ name: "list_page_sections",
3348
+ startedAt: trace.startedAt,
3349
+ endedAt: (/* @__PURE__ */ new Date()).toISOString(),
3350
+ durationMs: elapsed,
3351
+ status: "error",
3352
+ locale: resolvedLocale,
3353
+ outputPreview: { message: error instanceof Error ? error.message : "Unknown error" },
3354
+ metadata: { tool: "list_page_sections" }
3355
+ });
3356
+ throw error;
3357
+ }
3358
+ });
3168
3359
  if (resolved.tools.readPage) server.registerTool("read_page", {
3169
3360
  title: "Read a docs page",
3170
3361
  description: "Read a documentation page by slug or URL path, optionally selecting one heading and limiting returned characters.",
@@ -4611,6 +4802,35 @@ function toStructuredDocsMcpPage(page) {
4611
4802
  tags: page.tags
4612
4803
  };
4613
4804
  }
4805
+ function withDocsMcpUrlLocale(value, locale) {
4806
+ if (!locale) return value;
4807
+ const absolute = /^[a-z][a-z\d+.-]*:/iu.test(value);
4808
+ try {
4809
+ const url = new URL(value, "https://docs.invalid");
4810
+ if (!url.searchParams.has("lang")) url.searchParams.set("lang", locale);
4811
+ return absolute ? url.toString() : `${url.pathname}${url.search}${url.hash}`;
4812
+ } catch {
4813
+ return value;
4814
+ }
4815
+ }
4816
+ function toDocsMcpPageMarkdownUrl(value, locale) {
4817
+ const absolute = /^[a-z][a-z\d+.-]*:/iu.test(value);
4818
+ try {
4819
+ const url = new URL(value, "https://docs.invalid");
4820
+ const markdownPath = toDocsMarkdownUrl(`${url.pathname}${url.search}${url.hash}`, { locale });
4821
+ return absolute ? new URL(markdownPath, url.origin).toString() : markdownPath;
4822
+ } catch {
4823
+ return toDocsMarkdownUrl(value, { locale });
4824
+ }
4825
+ }
4826
+ function resolveDocsMcpPublicUrl(value, baseUrl) {
4827
+ if (!baseUrl || /^[a-z][a-z\d+.-]*:/iu.test(value)) return value;
4828
+ try {
4829
+ return new URL(value, `${baseUrl.replace(/\/+$/u, "")}/`).toString();
4830
+ } catch {
4831
+ return value;
4832
+ }
4833
+ }
4614
4834
  function getDocsMcpSourceMarkdown(page) {
4615
4835
  return page.agentRawContent ?? page.agentFallbackRawContent ?? page.agentContent ?? page.agentFallbackContent ?? page.rawContent ?? page.content;
4616
4836
  }
@@ -4816,24 +5036,24 @@ async function buildDocsMcpContext(options) {
4816
5036
  };
4817
5037
  }
4818
5038
  function findDocsPage(pages, requestedPath, entry) {
4819
- const normalizedRequest = normalizeRequestedPath(requestedPath, entry);
4820
- const normalizedRequestWithoutLocale = normalizeRequestedPath(removeDocsLocaleQuery(requestedPath), entry);
4821
- for (const page of pages) {
4822
- const normalizedPageUrl = normalizeUrlPath(page.url);
4823
- if (normalizedPageUrl === normalizedRequest || normalizedPageUrl === normalizedRequestWithoutLocale) return page;
4824
- }
4825
- const normalizedSlug = normalizePathSegment(requestedPath.replace(/^\//, ""));
4826
- for (const page of pages) if (normalizePathSegment(page.slug) === normalizedSlug) return page;
4827
- return null;
5039
+ const normalizedRequest = normalizeDocsMcpPageIdentity(requestedPath, entry, true);
5040
+ for (const page of pages) if (normalizeDocsMcpPageIdentity(page.url, entry, true) === normalizedRequest) return page;
5041
+ const normalizedRequestPath = normalizeDocsMcpPageIdentity(requestedPath, entry, false);
5042
+ const pathMatches = pages.filter((page) => normalizeDocsMcpPageIdentity(page.url, entry, false) === normalizedRequestPath);
5043
+ if (pathMatches.length === 1) return pathMatches[0];
5044
+ if (pathMatches.length > 1) return null;
5045
+ const normalizedSlug = normalizePathSegment(normalizeDocsMcpPageIdentity(requestedPath, void 0, false).replace(/^\//u, ""));
5046
+ const slugMatches = pages.filter((page) => normalizePathSegment(page.slug) === normalizedSlug);
5047
+ return slugMatches.length === 1 ? slugMatches[0] : null;
4828
5048
  }
4829
- function removeDocsLocaleQuery(value) {
5049
+ function normalizeDocsMcpPageIdentity(value, entry, includeSearch) {
4830
5050
  try {
4831
- const absolute = /^[a-z][a-z\d+.-]*:/iu.test(value);
4832
5051
  const url = new URL(value, "https://docs.local");
4833
- url.searchParams.delete("lang");
4834
- return absolute ? url.toString() : `${url.pathname}${url.search}${url.hash}`;
5052
+ if (includeSearch) url.searchParams.sort();
5053
+ return `${normalizeRequestedPath(url.pathname, entry)}${includeSearch ? url.search : ""}`;
4835
5054
  } catch {
4836
- return value;
5055
+ const [pathname = value, search = ""] = value.split("?", 2);
5056
+ return `${normalizeRequestedPath(pathname, entry)}${includeSearch && search ? `?${search}` : ""}`;
4837
5057
  }
4838
5058
  }
4839
5059
  function normalizeRequestedPath(requestedPath, entry) {
@@ -1,7 +1,7 @@
1
- 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-BJ0KXN-A.mjs";
1
+ 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-BHqaZx-X.mjs";
2
2
  import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
3
3
  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";
4
- import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-RbgmSvPH.mjs";
4
+ import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-DaYBoy_A.mjs";
5
5
  import matter from "gray-matter";
6
6
 
7
7
  //#region src/define-docs.ts
@@ -1,5 +1,6 @@
1
- import { Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Vn as McpDocsSearchConfig, Wn as OpenDocsProvider, _n as DocsSearchRequest, at as DocsAnalyticsEventInput, cn as DocsSearchAdapterFactory, cr as ResolvedDocsRelatedLink, dn as DocsSearchDocument, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, hn as DocsSearchFilters, ht as DocsAskAIMcpConfig, it as DocsAnalyticsEvent, ln as DocsSearchChunkingConfig, mn as DocsSearchFilterInput, on as DocsSearchAdapter, qn as OpenDocsTarget, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, un as DocsSearchConfig, vn as DocsSearchResponse, vr as TypesenseDocsSearchConfig, wn as DocsSitemapConfig, xn as DocsSearchSourcePage, yn as DocsSearchResult } from "./types-clg5J1R4.mjs";
2
- import { I as DocsDiscoveryApiRouteOptions } from "./standards-discovery-CdrOE-05.mjs";
1
+ import { Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Vn as McpDocsSearchConfig, Wn as OpenDocsProvider, _n as DocsSearchRequest, at as DocsAnalyticsEventInput, cn as DocsSearchAdapterFactory, cr as ResolvedDocsRelatedLink, dn as DocsSearchDocument, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, hn as DocsSearchFilters, ht as DocsAskAIMcpConfig, it as DocsAnalyticsEvent, ln as DocsSearchChunkingConfig, mn as DocsSearchFilterInput, on as DocsSearchAdapter, qn as OpenDocsTarget, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, un as DocsSearchConfig, vn as DocsSearchResponse, vr as TypesenseDocsSearchConfig, wn as DocsSitemapConfig, xn as DocsSearchSourcePage, yn as DocsSearchResult } from "./types-BDRwrExu.mjs";
2
+ import { I as DocsDiscoveryApiRouteOptions } from "./standards-discovery-DBI1PD7m.mjs";
3
+ import { pn as DocsContentAudience } from "./agent-cAPjC2jb.mjs";
3
4
 
4
5
  //#region src/analytics.d.ts
5
6
  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"];
@@ -30,51 +31,6 @@ declare function emitDocsAnalyticsEvent(analytics: boolean | DocsAnalyticsConfig
30
31
  declare function emitDocsObservabilityEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsObservabilityEventInput): Promise<void>;
31
32
  declare function emitDocsAgentTraceEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsAgentTraceEventInput): Promise<void>;
32
33
  //#endregion
33
- //#region src/audience.d.ts
34
- /** The two content projections emitted by the docs framework. */
35
- type DocsContentAudience = "human" | "agent";
36
- /** Resolve whether content with an optional audience restriction is visible. */
37
- declare function resolveDocsAudienceExposure(only: unknown, audience: DocsContentAudience): boolean;
38
- interface DocsMarkdownPromptBlock {
39
- /** Raw JSX attributes between the Prompt name and opening bracket. */
40
- attributes: string;
41
- /** Literal source between the Prompt tags, with enclosing Markdown container prefixes removed. */
42
- children: string;
43
- /** Collision-safe placeholder carried through document-level rendering. */
44
- token: string;
45
- }
46
- interface ExtractedDocsMarkdownPromptBlocks {
47
- blocks: DocsMarkdownPromptBlock[];
48
- markdown: string;
49
- }
50
- interface DocsAudienceMdxIssue {
51
- code: "missing-only" | "invalid-only" | "dynamic-only" | "ignored-agent-only" | "ignored-human-only";
52
- index: number;
53
- message: string;
54
- }
55
- /**
56
- * Extract live MDX Prompt blocks while leaving Markdown literals untouched.
57
- *
58
- * Prompt bodies are copyable source, so callers can safely run audience,
59
- * reference-definition, and heading passes over `markdown`, then restore each
60
- * block from its token. Fences (including container fences), inline code, links,
61
- * comments, raw elements, and other literal contexts are never extracted.
62
- */
63
- declare function extractDocsMarkdownPromptBlocks(content: string): ExtractedDocsMarkdownPromptBlocks;
64
- /** Find audience declarations that cannot be projected consistently at build time. */
65
- declare function findDocsAudienceMdxIssues(content: string): DocsAudienceMdxIssue[];
66
- /**
67
- * Resolve MDX into its human or agent projection.
68
- *
69
- * `<Agent>` is shorthand for `<Audience only="agent">`, while `<Human>` is
70
- * shorthand for `<Audience only="human">`. Unknown `Audience.only` values are
71
- * treated as shared content so an authoring typo never silently deletes content.
72
- * These primitives shape content for each surface; they are not an access-control boundary.
73
- */
74
- declare function resolveDocsAudienceMdxContent(content: string, audience: DocsContentAudience): string;
75
- /** Backwards-compatible name retained for existing integrations. */
76
- declare function resolveDocsAgentMdxContent(content: string, audience: DocsContentAudience): string;
77
- //#endregion
78
34
  //#region src/prompt-utils.d.ts
79
35
  type PromptAction = "copy" | "open";
80
36
  interface SerializedOpenDocsProvider {
@@ -355,4 +311,4 @@ declare function isDocsRetrievalCanonicalUrl(value: string): boolean;
355
311
  */
356
312
  declare function digestDocsRetrievalContent(value: string): `sha256:${string}`;
357
313
  //#endregion
358
- export { parsePromptStringArray as $, DocsSitemapFormat as A, resolveDocsSitemapConfig as B, resolveDocsSearchRequest as C, emitDocsObservabilityEvent as Ct, DEFAULT_SITEMAP_MD_ROUTE as D, DEFAULT_SITEMAP_MD_DOCS_ROUTE as E, resolveDocsObservabilityConfig as Et, buildDocsSitemapManifest as F, DEFAULT_OPEN_DOCS_PROVIDER_IDS as G, resolveDocsSitemapRequest as H, createDocsSitemapResponse as I, PromptAction as J, DEFAULT_OPEN_DOCS_TARGET as K, readDocsSitemapManifestFromContentMap as L, DocsSitemapManifestPage as M, DocsSitemapPageInput as N, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as O, DocsSitemapResolvedConfig as P, normalizePromptProviderName as Q, renderDocsSitemapMarkdown as R, resolveDocsSearchFilters as S, emitDocsAnalyticsEvent as St, DEFAULT_SITEMAP_MANIFEST_PATH as T, resolveDocsAnalyticsConfig as Tt, toDocsSitemapMarkdownUrl as U, resolveDocsSitemapPageLastmod as V, DEFAULT_OPEN_DOCS_PROMPT as W, SerializeOpenDocsProviderOptions as X, PromptProviderChoice as Y, SerializedOpenDocsProvider as Z, performDocsSearch as _, ResolvedDocsAnalyticsConfig as _t, buildDocsAskAIContext as a, serializeOpenDocsProviders as at, resolveDocsRetrievalLastModified as b, createDocsAgentTraceId as bt, createAlgoliaSearchAdapter as c, DocsMarkdownPromptBlock as ct, createSimpleSearchAdapter as d, findDocsAudienceMdxIssues as dt, resolvePromptProviderChoices as et, createTypesenseSearchAdapter as f, resolveDocsAgentMdxContent as ft, normalizeDocsSearchFilters as g, DocsAgentTraceContext as gt, inferDocsAskAIPackageHints as h, DOCS_AGENT_TRACE_EVENT_TYPES as ht, PerformDocsSearchOptions as i, serializeOpenDocsProvider as it, DocsSitemapManifest as j, DEFAULT_SITEMAP_XML_ROUTE as k, createCustomSearchAdapter as l, ExtractedDocsMarkdownPromptBlocks as lt, formatDocsAskAIPackageHints as m, resolveDocsAudienceMdxContent as mt, isDocsRetrievalCanonicalUrl as n, serializeDocsIcon as nt, buildDocsRetrievalDigestProjection as o, DocsAudienceMdxIssue as ot, enrichDocsSearchDocumentsWithProvenance as p, resolveDocsAudienceExposure as pt, DEFAULT_PROMPT_PROVIDER_TEMPLATES as q, EnrichDocsSearchDocumentsWithProvenanceOptions as r, serializeDocsIconRegistry as rt, buildDocsSearchDocuments as s, DocsContentAudience as st, digestDocsRetrievalContent as t, sanitizePromptText as tt, createMcpSearchAdapter as u, extractDocsMarkdownPromptBlocks as ut, performDocsSearchWithMetadata as v, ResolvedDocsObservabilityConfig as vt, resolveSearchRequestConfig as w, getDocsRequestAnalyticsProperties as wt, resolveDocsSearchAudience as x, emitDocsAgentTraceEvent as xt, resolveAskAISearchRequestConfig as y, createDocsAgentTraceContext as yt, renderDocsSitemapXml as z };
314
+ export { parsePromptStringArray as $, DocsSitemapFormat as A, resolveDocsSitemapConfig as B, resolveDocsSearchRequest as C, DEFAULT_SITEMAP_MD_ROUTE as D, DEFAULT_SITEMAP_MD_DOCS_ROUTE as E, buildDocsSitemapManifest as F, DEFAULT_OPEN_DOCS_PROVIDER_IDS as G, resolveDocsSitemapRequest as H, createDocsSitemapResponse as I, PromptAction as J, DEFAULT_OPEN_DOCS_TARGET as K, readDocsSitemapManifestFromContentMap as L, DocsSitemapManifestPage as M, DocsSitemapPageInput as N, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as O, DocsSitemapResolvedConfig as P, normalizePromptProviderName as Q, renderDocsSitemapMarkdown as R, resolveDocsSearchFilters as S, DEFAULT_SITEMAP_MANIFEST_PATH as T, toDocsSitemapMarkdownUrl as U, resolveDocsSitemapPageLastmod as V, DEFAULT_OPEN_DOCS_PROMPT as W, SerializeOpenDocsProviderOptions as X, PromptProviderChoice as Y, SerializedOpenDocsProvider as Z, performDocsSearch as _, resolveDocsObservabilityConfig as _t, buildDocsAskAIContext as a, serializeOpenDocsProviders as at, resolveDocsRetrievalLastModified as b, createAlgoliaSearchAdapter as c, ResolvedDocsAnalyticsConfig as ct, createSimpleSearchAdapter as d, createDocsAgentTraceId as dt, resolvePromptProviderChoices as et, createTypesenseSearchAdapter as f, emitDocsAgentTraceEvent as ft, normalizeDocsSearchFilters as g, resolveDocsAnalyticsConfig as gt, inferDocsAskAIPackageHints as h, getDocsRequestAnalyticsProperties as ht, PerformDocsSearchOptions as i, serializeOpenDocsProvider as it, DocsSitemapManifest as j, DEFAULT_SITEMAP_XML_ROUTE as k, createCustomSearchAdapter as l, ResolvedDocsObservabilityConfig as lt, formatDocsAskAIPackageHints as m, emitDocsObservabilityEvent as mt, isDocsRetrievalCanonicalUrl as n, serializeDocsIcon as nt, buildDocsRetrievalDigestProjection as o, DOCS_AGENT_TRACE_EVENT_TYPES as ot, enrichDocsSearchDocumentsWithProvenance as p, emitDocsAnalyticsEvent as pt, DEFAULT_PROMPT_PROVIDER_TEMPLATES as q, EnrichDocsSearchDocumentsWithProvenanceOptions as r, serializeDocsIconRegistry as rt, buildDocsSearchDocuments as s, DocsAgentTraceContext as st, digestDocsRetrievalContent as t, sanitizePromptText as tt, createMcpSearchAdapter as u, createDocsAgentTraceContext as ut, performDocsSearchWithMetadata as v, resolveSearchRequestConfig as w, resolveDocsSearchAudience as x, resolveAskAISearchRequestConfig as y, renderDocsSitemapXml as z };
@@ -1,14 +1,14 @@
1
- import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, Dt as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS } from "./agent-BJ0KXN-A.mjs";
1
+ import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, Dt as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS } from "./agent-BHqaZx-X.mjs";
2
2
  import { _ as hasStructuredPageAgentContract, f as PAGE_AGENT_CONTRACT_FIELDS, g as getPageAgentFrontmatterIssues, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
3
3
  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";
4
- import { h as resolveAskAISearchRequestConfig } from "./search-DIyIl-tE.mjs";
4
+ import { h as resolveAskAISearchRequestConfig } from "./search-BmC8wVr0.mjs";
5
5
  import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
6
- import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-LIScgQVm.mjs";
6
+ import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-21LZ_uEl.mjs";
7
7
  import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
8
8
  import "./code-blocks-DnNVNK2M.mjs";
9
9
  import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-Wcdj-D0a.mjs";
10
10
  import { t as detectFramework } from "./utils-DpiIioYb.mjs";
11
- import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-DTEPZeb0.mjs";
11
+ import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-D_oDJwGv.mjs";
12
12
  import matter from "gray-matter";
13
13
  import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
14
14
  import path from "node:path";
@@ -1,4 +1,4 @@
1
- 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-BJ0KXN-A.mjs";
1
+ 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-BHqaZx-X.mjs";
2
2
  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";
3
3
 
4
4
  //#region src/robots.ts
@@ -1,7 +1,7 @@
1
- import "./agent-BJ0KXN-A.mjs";
1
+ import "./agent-BHqaZx-X.mjs";
2
2
  import "./markdown-sections-7OoA7ylx.mjs";
3
3
  import "./standards-discovery-BwL5ffGx.mjs";
4
- 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";
4
+ 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-DaYBoy_A.mjs";
5
5
  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";
6
6
  import { t as detectFramework } from "./utils-DpiIioYb.mjs";
7
7
  import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
@@ -1,4 +1,4 @@
1
- import { G as isDocsAgentDiscoveryRequest, K as isDocsAgentsRequest, Q as isDocsSkillRequest, _t as resolveDocsMarkdownRequest, dt as resolveDocsAgentsFormat, jt as resolveDocsAudienceMdxContent, lt as resolveDocsAgentFeedbackConfig, pt as resolveDocsLlmsTxtRequest, ut as resolveDocsAgentFeedbackRequest, xt as resolveDocsSkillFormat } from "./agent-BJ0KXN-A.mjs";
1
+ import { G as isDocsAgentDiscoveryRequest, K as isDocsAgentsRequest, Q as isDocsSkillRequest, _t as resolveDocsMarkdownRequest, dt as resolveDocsAgentsFormat, jt as resolveDocsAudienceMdxContent, lt as resolveDocsAgentFeedbackConfig, pt as resolveDocsLlmsTxtRequest, ut as resolveDocsAgentFeedbackRequest, xt as resolveDocsSkillFormat } from "./agent-BHqaZx-X.mjs";
2
2
  import { S as upsertPageAgentContractMarkdown, a as findDocsGeneratedAgentContractRanges, d as PAGE_AGENT_CONTRACT_END_MARKER, l as stripDocsGeneratedAgentContractMarkers, m as PAGE_AGENT_CONTRACT_START_MARKER, o as findDocsMarkdownSection, s as parseDocsMarkdownSections, y as renderPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
3
3
 
4
4
  //#region src/telemetry.ts
@@ -1,11 +1,11 @@
1
- import "./agent-BJ0KXN-A.mjs";
1
+ import "./agent-BHqaZx-X.mjs";
2
2
  import "./markdown-sections-7OoA7ylx.mjs";
3
3
  import "./standards-discovery-BwL5ffGx.mjs";
4
- import { c as createTypesenseSearchAdapter, i as createAlgoliaSearchAdapter, r as buildDocsSearchDocuments } from "./search-DIyIl-tE.mjs";
4
+ import { c as createTypesenseSearchAdapter, i as createAlgoliaSearchAdapter, r as buildDocsSearchDocuments } from "./search-BmC8wVr0.mjs";
5
5
  import { t as resolveDocsI18n } from "./i18n-hHVWcflJ.mjs";
6
6
  import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
7
- import "./sitemap-server-BfyBM7_V.mjs";
8
- import "./agent-evals-LIScgQVm.mjs";
7
+ import "./sitemap-server-B9LZQ1FE.mjs";
8
+ import "./agent-evals-21LZ_uEl.mjs";
9
9
  import { createFilesystemDocsMcpSource } from "./mcp.mjs";
10
10
  import "./code-blocks-DnNVNK2M.mjs";
11
11
  import "./agent-skills-server-noFn1l_p.mjs";