@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.
- package/dist/{agent-BJ0KXN-A.mjs → agent-BHqaZx-X.mjs} +2 -0
- package/dist/{agent-D0LEY2Vy.mjs → agent-DxTa3PLB.mjs} +2 -2
- package/dist/agent-cAPjC2jb.d.mts +922 -0
- package/dist/{agent-evals-LIScgQVm.mjs → agent-evals-21LZ_uEl.mjs} +1 -1
- package/dist/{agent-export-B92pNe6g.mjs → agent-export-3VheegEK.mjs} +5 -5
- package/dist/agent-skills-bundle.d.mts +1 -1
- package/dist/{agent-skills-server-BqvIGQb1.d.mts → agent-skills-server-Cix64aGB.d.mts} +2 -2
- package/dist/agent-skills-vite.d.mts +3 -3
- package/dist/{agents-C228QGbp.mjs → agents-ByTdP0Hl.mjs} +4 -4
- package/dist/cli/index.mjs +14 -14
- package/dist/client/react.d.mts +1 -1
- package/dist/{cloud-ask-ai-6X9pVjIY.d.mts → cloud-ask-ai-Bt0rzFbe.d.mts} +1 -1
- package/dist/docs-cloud-server.d.mts +2 -2
- package/dist/{doctor-CgrUZ3tY.mjs → doctor-C34VVF85.mjs} +9 -8
- package/dist/{golden-evaluations-DTEPZeb0.mjs → golden-evaluations-D_oDJwGv.mjs} +2 -2
- package/dist/index.d.mts +4 -875
- package/dist/index.mjs +4 -4
- package/dist/{mcp-YD37HlPY.mjs → mcp-Bnqfu8P5.mjs} +5 -4
- package/dist/mcp.d.mts +8 -4
- package/dist/mcp.mjs +236 -16
- package/dist/{prompt-references-BIS1eXt4.mjs → prompt-references-CfyYOa_W.mjs} +2 -2
- package/dist/{retrieval-digest-9Kp3uSaZ.d.mts → retrieval-digest-CFOcSKTo.d.mts} +4 -48
- package/dist/{review-Dbzkdl6K.mjs → review-Dw6oCQX3.mjs} +4 -4
- package/dist/{robots-RbgmSvPH.mjs → robots-DaYBoy_A.mjs} +1 -1
- package/dist/{robots-DUO0r4UI.mjs → robots-KWLujSLI.mjs} +2 -2
- package/dist/{search-DIyIl-tE.mjs → search-BmC8wVr0.mjs} +1 -1
- package/dist/{search-hcqaEZVN.mjs → search-DBdmbUkc.mjs} +4 -4
- package/dist/server.d.mts +7 -6
- package/dist/server.mjs +4 -4
- package/dist/{sitemap-jhkS_jYx.mjs → sitemap-CrzG5Wpf.mjs} +4 -4
- package/dist/{sitemap-server-BfyBM7_V.mjs → sitemap-server-B9LZQ1FE.mjs} +1 -1
- package/dist/{standards-discovery-CdrOE-05.d.mts → standards-discovery-DBI1PD7m.d.mts} +1 -1
- package/dist/{types-clg5J1R4.d.mts → types-BDRwrExu.d.mts} +5 -0
- 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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
4
|
+
import "./search-BmC8wVr0.mjs";
|
|
5
5
|
import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
|
|
6
|
-
import "./sitemap-server-
|
|
7
|
-
import "./agent-evals-
|
|
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-
|
|
2
|
-
import { L as DocsPublishedAgentSkill } from "./standards-discovery-
|
|
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-
|
|
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-
|
|
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 =
|
|
4820
|
-
const
|
|
4821
|
-
|
|
4822
|
-
|
|
4823
|
-
|
|
4824
|
-
|
|
4825
|
-
const normalizedSlug = normalizePathSegment(requestedPath.replace(
|
|
4826
|
-
|
|
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
|
|
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.
|
|
4834
|
-
return
|
|
5052
|
+
if (includeSearch) url.searchParams.sort();
|
|
5053
|
+
return `${normalizeRequestedPath(url.pathname, entry)}${includeSearch ? url.search : ""}`;
|
|
4835
5054
|
} catch {
|
|
4836
|
-
|
|
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-
|
|
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-
|
|
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-
|
|
2
|
-
import { I as DocsDiscoveryApiRouteOptions } from "./standards-discovery-
|
|
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,
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
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-
|
|
8
|
-
import "./agent-evals-
|
|
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";
|