@farming-labs/docs 0.2.60 → 0.2.61

package/dist/{golden-evaluations-BN9u2wxw.mjs → golden-evaluations-CBZ_JZjf.mjs}

@@ -1,6 +1,6 @@
-import { Ot as resolveDocsAudienceMdxContent, Tt as findDocsAudienceMdxTags, _n as hasStructuredPageAgentContract, vn as normalizePageAgentFrontmatter } from "./agent-BFqyqEnC.mjs";
-import { n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework } from "./agent-scope-CCaIY1aK.mjs";
-import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-qe0T8-xe.mjs";
+import { Jt as normalizePageAgentFrontmatter, qt as hasStructuredPageAgentContract, wt as resolveDocsAudienceMdxContent, xt as findDocsAudienceMdxTags } from "./agent-Fl0pjVNF.mjs";
+import { n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework } from "./agent-scope-C_U--OZ7.mjs";
+import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 
@@ -1324,7 +1324,10 @@ function displayValue(value, present = true) {
 	}
 }
 function valuesMatch(actual, expected) {
-	return actual.present && Object.is(actual.value, expected);
+	if (!actual.present) return false;
+	if (Object.is(actual.value, expected)) return true;
+	if ((Array.isArray(actual.value) || isRecord(actual.value)) && (Array.isArray(expected) || isRecord(expected))) return displayValue(actual.value) === displayValue(expected);
+	return false;
 }
 function mismatchIssue(code, path, expected, actual, label) {
 	const expectedDisplay = displayValue(expected);
@@ -1394,6 +1397,18 @@ function analyzeAgentSurfaceDrift(options) {
 	compareExpectedValue(issues, options.discovery, "mcp-enabled-mismatch", "mcp.enabled", options.expected.mcp.enabled, "Discovery mcp.enabled");
 	compareExpectedValue(issues, options.discovery, "mcp-capability-mismatch", "capabilities.mcp", options.expected.mcp.enabled, "Discovery capabilities.mcp");
 	compareExpectedValue(issues, options.discovery, "mcp-route-mismatch", "mcp.endpoint", options.expected.mcp.endpoint, "Discovery mcp.endpoint");
+	if (options.expected.mcp.protectedResource !== void 0) {
+		const expectedProtectedResource = options.expected.mcp.protectedResource;
+		const discoveredProtectedResource = readPath(options.discovery, "mcp.protectedResource");
+		if (expectedProtectedResource === null) {
+			if (discoveredProtectedResource.present) issues.push(mismatchIssue("mcp-protected-resource-mismatch", "mcp.protectedResource", void 0, discoveredProtectedResource, "Discovery mcp.protectedResource"));
+		} else for (const field of [
+			"metadataEndpoints",
+			"authorizationServers",
+			"scopesSupported",
+			"requiredScopes"
+		]) compareExpectedValue(issues, options.discovery, "mcp-protected-resource-mismatch", `mcp.protectedResource.${field}`, expectedProtectedResource[field], `Discovery mcp.protectedResource.${field}`);
+	}
 	const expectedToolNames = Object.keys(options.expected.mcp.tools).sort();
 	const expectedToolSet = new Set(expectedToolNames);
 	const discoveredToolsValue = readPath(options.discovery, "mcp.tools");

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-import { $ as DocsCodeBlocksConfig, $t as DocsTelemetryFramework, A as DocsAgentGoldenTaskExpectation, An as ResolvedDocsRelatedLink, At as DocsReviewRulesConfig, B as DocsAnalyticsSource, Bn as TypesenseDocsSearchConfig, Bt as DocsSearchDocument, C as DocsAgentEvaluationsConfig, Cn as PageAgentVerification, Ct as DocsObservabilityConfig, D as DocsAgentGoldenExampleVerification, Dn as PageTwitter, Dt as DocsReviewCiConfig, E as DocsAgentGoldenAnswerExpectation, En as PageSidebarFrontmatter, Et as DocsRelatedItem, F as DocsAnalyticsConfig, Fn as SidebarNode, Ft as DocsSearchAdapter, G as DocsAskAIFeedbackMessage, Gt as DocsSearchSourcePage, H as DocsAskAIActionType, Hn as UIConfig, Ht as DocsSearchQuery, I as DocsAnalyticsEvent, In as SidebarPageNode, It as DocsSearchAdapterContext, J as DocsCloudApiKeyConfig, Jt as DocsTelemetryConfig, K as DocsAskAIFeedbackValue, Kt as DocsSitemapConfig, L as DocsAnalyticsEventInput, Ln as SidebarTree, Lt as DocsSearchAdapterFactory, M as DocsAgentTraceEventInput, Mn as SidebarConfig, Mt as DocsReviewSeverity, N as DocsAgentTraceEventType, Nn as SidebarFolderIndexBehavior, Nt as DocsRobotsConfig, O as DocsAgentGoldenExpectedExample, On as ReadingTimeConfig, Ot as DocsReviewCiMode, P as DocsAgentTraceStatus, Pn as SidebarFolderNode, Pt as DocsRobotsRule, Q as DocsCloudPublishConfig, Qt as DocsTelemetryFeatures, R as DocsAnalyticsEventType, Rn as SimpleDocsSearchConfig, Rt as DocsSearchChunkingConfig, S as DocsAgentEvaluationTaskInput, Sn as PageAgentFrontmatter, St as DocsNav, T as DocsAgentFeedbackData, Tn as PageOpenGraph, Tt as DocsObservabilityEventInput, U as DocsAskAIFeedbackConfig, Ut as DocsSearchResult, V as DocsAskAIActionData, Vn as TypographyConfig, Vt as DocsSearchEmbeddingsConfig, W as DocsAskAIFeedbackData, Wt as DocsSearchResultType, X as DocsCloudFeatureConfig, Xt as DocsTelemetryEventInput, Y as DocsCloudConfig, Yt as DocsTelemetryEvent, Z as DocsCloudPreviewConfig, Zt as DocsTelemetryEventType, _ as DocsAgentEvaluationAnswerRequest, _n as OrderingItem, _t as DocsMcpCorsConfig, a as ApiReferenceRenderer, an as LlmsTxtConfig, at as DocsCodeBlocksValidationMode, b as DocsAgentEvaluationSourceReference, bn as PageAgentCommand, bt as DocsMcpToolsConfig, c as ChangelogFrontmatter, cn as LlmsTxtSectionConfig, ct as DocsFeedbackData, d as CopyMarkdownFormat, dn as OpenDocsConfig, dt as DocsMcpAllowedOrigins, en as DocsTheme, et as DocsCodeBlocksPlannerConfig, f as CustomDocsSearchConfig, fn as OpenDocsProvider, ft as DocsMcpAuthPrincipal, g as DocsAgentEvaluationAnswerProvider, gn as OpenGraphImage, gt as DocsMcpConfig, h as DocsAgentEvaluationAnswerInput, hn as OpenDocsTarget, ht as DocsMcpAuthenticateResult, i as ApiReferenceConfig, in as LastUpdatedConfig, it as DocsCodeBlocksValidateConfig, j as DocsAgentGoldenTaskFilters, jn as SidebarComponentProps, jt as DocsReviewScoreConfig, k as DocsAgentGoldenTask, kn as ReadingTimeFormat, kt as DocsReviewConfig, l as CodeBlockCopyData, ln as McpDocsSearchConfig, lt as DocsFeedbackValue, m as DocsAgentConfig, mn as OpenDocsProviderId, mt as DocsMcpAuthenticateContext, n as AgentFeedbackConfig, nn as FontStyle, nt as DocsCodeBlocksRunnerConfig, o as BreadcrumbConfig, on as LlmsTxtMaxCharsConfig, ot as DocsCodeBlocksValidationPolicy, p as DocsAgentCompactConfig, pn as OpenDocsProviderConfig, pt as DocsMcpAuthenticate, q as DocsAskAIMcpConfig, qt as DocsTelemetryAgentSurface, r as AlgoliaDocsSearchConfig, rn as GithubConfig, rt as DocsCodeBlocksRunnerProvider, s as ChangelogConfig, sn as LlmsTxtMaxCharsMode, st as DocsConfig, t as AIConfig, tn as FeedbackConfig, tt as DocsCodeBlocksPlannerProvider, u as CopyMarkdownConfig, un as OGConfig, ut as DocsI18nConfig, v as DocsAgentEvaluationAnswerResult, vn as PageActionsConfig, vt as DocsMcpOriginContext, w as DocsAgentFeedbackContext, wn as PageFrontmatter, wt as DocsObservabilityEvent, x as DocsAgentEvaluationSurface, xn as PageAgentFailureMode, xt as DocsMetadata, y as DocsAgentEvaluationAnswerRunner, yn as PageAgentAppliesTo, yt as DocsMcpSecurityConfig, z as DocsAnalyticsInput, zn as ThemeToggleConfig, zt as DocsSearchConfig } from "./types-XHABMh_f.mjs";
-import { $ as resolveDocsAudienceMdxContent, A as resolveDocsSitemapRequest, At as resolveDocsStandardsDiscoveryRequest, Bt as emitDocsObservabilityEvent, C as buildDocsSitemapManifest, Ct as buildDocsAgentSkillsIndex, D as renderDocsSitemapXml, Dt as isDocsStandardsDiscoveryRequest, E as renderDocsSitemapMarkdown, Et as getDocsDiscoveryLinkHeader, Ft as ResolvedDocsObservabilityConfig, Ht as resolveDocsAnalyticsConfig, I as PromptAction, It as createDocsAgentTraceContext, J as DocsAudienceMdxIssue, L as PromptProviderChoice, Lt as createDocsAgentTraceId, Mt as DOCS_AGENT_TRACE_EVENT_TYPES, Nt as DocsAgentTraceContext, O as resolveDocsSitemapConfig, Ot as resolveDocsDiscoveryApiRoute, Pt as ResolvedDocsAnalyticsConfig, Q as resolveDocsAudienceExposure, R as SerializeOpenDocsProviderOptions, Rt as emitDocsAgentTraceEvent, S as DocsSitemapResolvedConfig, St as appendDocsDiscoveryLinkHeader, T as readDocsSitemapManifestFromContentMap, Tt as createDocsStandardsResponse, Ut as resolveDocsObservabilityConfig, Vt as getDocsRequestAnalyticsProperties, X as findDocsAudienceMdxIssues, Y as DocsContentAudience, Z as resolveDocsAgentMdxContent, _ as DEFAULT_SITEMAP_XML_ROUTE, _t as DocsDiscoveryApiRouteOptions, a as createMcpSearchAdapter, at as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, b as DocsSitemapManifestPage, bt as DocsStandardsDiscoveryRequest, c as formatDocsAskAIPackageHints, ct as DEFAULT_AGENT_SKILL_FORMAT, d as resolveAskAISearchRequestConfig, dt as DocsAgentSkillIndexEntry, et as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, f as resolveSearchRequestConfig, ft as DocsAgentSkillsIndex, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, gt as DocsApiCatalogOptions, h as DEFAULT_SITEMAP_MD_ROUTE, ht as DocsApiCatalogLinkTarget, i as createCustomSearchAdapter, it as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, j as toDocsSitemapMarkdownUrl, jt as sha256DocsDiscoveryContent, k as resolveDocsSitemapPageLastmod, kt as resolveDocsPublishedAgentSkill, l as inferDocsAskAIPackageHints, lt as DEFAULT_API_CATALOG_FORMAT, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, mt as DocsApiCatalogLinkContext, n as buildDocsSearchDocuments, nt as API_CATALOG_PROFILE_URI, o as createSimpleSearchAdapter, ot as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, p as DEFAULT_SITEMAP_MANIFEST_PATH, pt as DocsApiCatalog, r as createAlgoliaSearchAdapter, rt as CreateDocsStandardsResponseOptions, s as createTypesenseSearchAdapter, st as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, t as buildDocsAskAIContext, tt as API_CATALOG_MEDIA_TYPE, u as performDocsSearch, ut as DEFAULT_API_CATALOG_ROUTE, v as DocsSitemapFormat, vt as DocsPublishedAgentSkill, w as createDocsSitemapResponse, wt as buildDocsApiCatalog, x as DocsSitemapPageInput, xt as DocsStandardsDiscoveryRouteOptions, y as DocsSitemapManifest, yt as DocsPublishedAgentSkillOptions, z as SerializedOpenDocsProvider, zt as emitDocsAnalyticsEvent } from "./search-C1JitPwi.mjs";
+import { A as DocsPublishedAgentSkill, B as createDocsStandardsResponse, C as DocsAgentSkillIndexEntry, D as DocsApiCatalogLinkTarget, E as DocsApiCatalogLinkContext, F as appendDocsDiscoveryLinkHeader, G as resolveDocsStandardsDiscoveryRequest, H as isDocsStandardsDiscoveryRequest, I as buildDocsA2AAgentCard, K as sha256DocsDiscoveryContent, L as buildDocsAgentSkillsIndex, M as DocsPublishedAgentSkillOptions, N as DocsStandardsDiscoveryRequest, O as DocsApiCatalogOptions, P as DocsStandardsDiscoveryRouteOptions, R as buildDocsApiCatalog, S as DocsA2AAgentCardOptions, T as DocsApiCatalog, U as resolveDocsDiscoveryApiRoute, V as getDocsDiscoveryLinkHeader, W as resolveDocsPublishedAgentSkill, _ as DEFAULT_API_CATALOG_ROUTE, a as DEFAULT_A2A_AGENT_CARD_FORMAT, b as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, c as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, f as DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, g as DEFAULT_API_CATALOG_FORMAT, h as DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, i as CreateDocsStandardsResponseOptions, j as DocsPublishedAgentSkillFile, k as DocsDiscoveryApiRouteOptions, l as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, m as DEFAULT_AGENT_SKILL_FORMAT, n as API_CATALOG_MEDIA_TYPE, o as DEFAULT_A2A_AGENT_CARD_ROUTE, p as DEFAULT_AGENT_SKILL_FILE_FORMAT, r as API_CATALOG_PROFILE_URI, s as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, v as DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, w as DocsAgentSkillsIndex, x as DocsA2AAgentCard, y as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, z as buildDocsLegacySkillsIndex } from "./standards-discovery-C4HUqMd2.mjs";
+import { $ as DocsCloudFeatureConfig, $t as DocsTelemetryEvent, A as DocsAgentGoldenTask, An as PageSidebarFrontmatter, At as DocsRelatedItem, B as DocsAnalyticsEventInput, Bn as SidebarPageNode, Bt as DocsSearchAdapterContext, C as DocsAgentEvaluationTaskInput, Cn as PageAgentAppliesTo, Ct as DocsMcpSecurityConfig, D as DocsAgentGoldenAnswerExpectation, Dn as PageAgentVerification, Dt as DocsObservabilityConfig, E as DocsAgentFeedbackData, En as PageAgentFrontmatter, Et as DocsNav, F as DocsAgentTraceEventInput, Fn as SidebarComponentProps, Ft as DocsReviewScoreConfig, G as DocsAskAIActionType, Gn as TypographyConfig, Gt as DocsSearchEmbeddingsConfig, H as DocsAnalyticsInput, Hn as SimpleDocsSearchConfig, Ht as DocsSearchChunkingConfig, I as DocsAgentTraceEventType, In as SidebarConfig, It as DocsReviewSeverity, J as DocsAskAIFeedbackMessage, Jt as DocsSearchResultType, K as DocsAskAIFeedbackConfig, Kn as UIConfig, Kt as DocsSearchQuery, L as DocsAgentTraceStatus, Ln as SidebarFolderIndexBehavior, Lt as DocsRobotsConfig, M as DocsAgentGoldenTaskFilters, Mn as ReadingTimeConfig, Mt as DocsReviewCiMode, N as DocsAgentSkillsConfig, Nn as ReadingTimeFormat, Nt as DocsReviewConfig, O as DocsAgentGoldenExampleVerification, On as PageFrontmatter, Ot as DocsObservabilityEvent, P as DocsAgentSkillsInput, Pn as ResolvedDocsRelatedLink, Pt as DocsReviewRulesConfig, Q as DocsCloudConfig, Qt as DocsTelemetryConfig, R as DocsAnalyticsConfig, Rn as SidebarFolderNode, Rt as DocsRobotsRule, S as DocsAgentEvaluationSurface, Sn as PageActionsConfig, St as DocsMcpProtectedResourceConfig, T as DocsAgentFeedbackContext, Tn as PageAgentFailureMode, Tt as DocsMetadata, U as DocsAnalyticsSource, Un as ThemeToggleConfig, Ut as DocsSearchConfig, V as DocsAnalyticsEventType, Vn as SidebarTree, Vt as DocsSearchAdapterFactory, W as DocsAskAIActionData, Wn as TypesenseDocsSearchConfig, Wt as DocsSearchDocument, X as DocsAskAIMcpConfig, Xt as DocsSitemapConfig, Y as DocsAskAIFeedbackValue, Yt as DocsSearchSourcePage, Z as DocsCloudApiKeyConfig, Zt as DocsTelemetryAgentSurface, _ as DocsAgentEvaluationAnswerProvider, _n as OpenDocsProviderConfig, _t as DocsMcpAuthenticateContext, a as ApiReferenceRenderer, an as FeedbackConfig, at as DocsCodeBlocksRunnerConfig, b as DocsAgentEvaluationAnswerRunner, bn as OpenGraphImage, bt as DocsMcpCorsConfig, c as ChangelogFrontmatter, cn as LastUpdatedConfig, ct as DocsCodeBlocksValidationMode, d as CopyMarkdownFormat, dn as LlmsTxtMaxCharsMode, dt as DocsFeedbackData, en as DocsTelemetryEventInput, et as DocsCloudPreviewConfig, f as CustomDocsSearchConfig, fn as LlmsTxtSectionConfig, ft as DocsFeedbackValue, g as DocsAgentEvaluationAnswerInput, gn as OpenDocsProvider, gt as DocsMcpAuthenticate, h as DocsAgentConfig, hn as OpenDocsConfig, ht as DocsMcpAuthPrincipal, i as ApiReferenceConfig, in as DocsTheme, it as DocsCodeBlocksPlannerProvider, j as DocsAgentGoldenTaskExpectation, jn as PageTwitter, jt as DocsReviewCiConfig, k as DocsAgentGoldenExpectedExample, kn as PageOpenGraph, kt as DocsObservabilityEventInput, l as CodeBlockCopyData, ln as LlmsTxtConfig, lt as DocsCodeBlocksValidationPolicy, m as DocsAgentCompactConfig, mn as OGConfig, mt as DocsMcpAllowedOrigins, n as AgentFeedbackConfig, nn as DocsTelemetryFeatures, nt as DocsCodeBlocksConfig, o as BreadcrumbConfig, on as FontStyle, ot as DocsCodeBlocksRunnerProvider, p as DocsAgentA2AConfig, pn as McpDocsSearchConfig, pt as DocsI18nConfig, q as DocsAskAIFeedbackData, qt as DocsSearchResult, r as AlgoliaDocsSearchConfig, rn as DocsTelemetryFramework, rt as DocsCodeBlocksPlannerConfig, s as ChangelogConfig, sn as GithubConfig, st as DocsCodeBlocksValidateConfig, t as AIConfig, tn as DocsTelemetryEventType, tt as DocsCloudPublishConfig, u as CopyMarkdownConfig, un as LlmsTxtMaxCharsConfig, ut as DocsConfig, v as DocsAgentEvaluationAnswerRequest, vn as OpenDocsProviderId, vt as DocsMcpAuthenticateResult, w as DocsAgentEvaluationsConfig, wn as PageAgentCommand, wt as DocsMcpToolsConfig, x as DocsAgentEvaluationSourceReference, xn as OrderingItem, xt as DocsMcpOriginContext, y as DocsAgentEvaluationAnswerResult, yn as OpenDocsTarget, yt as DocsMcpConfig, z as DocsAnalyticsEvent, zn as SidebarNode, zt as DocsSearchAdapter } from "./types-EhFhYGfr.mjs";
+import { $ as resolveDocsAudienceMdxContent, A as resolveDocsSitemapRequest, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, I as PromptAction, J as DocsAudienceMdxIssue, L as PromptProviderChoice, O as resolveDocsSitemapConfig, Q as resolveDocsAudienceExposure, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, X as findDocsAudienceMdxIssues, Y as DocsContentAudience, Z as resolveDocsAgentMdxContent, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as createDocsAgentTraceId, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, ct as emitDocsObservabilityEvent, d as resolveAskAISearchRequestConfig, dt as resolveDocsObservabilityConfig, et as DOCS_AGENT_TRACE_EVENT_TYPES, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as createDocsAgentTraceContext, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, lt as getDocsRequestAnalyticsProperties, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as ResolvedDocsAnalyticsConfig, o as createSimpleSearchAdapter, ot as emitDocsAgentTraceEvent, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, rt as ResolvedDocsObservabilityConfig, s as createTypesenseSearchAdapter, st as emitDocsAnalyticsEvent, t as buildDocsAskAIContext, tt as DocsAgentTraceContext, u as performDocsSearch, ut as resolveDocsAnalyticsConfig, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-C6heDO8h.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/define-docs.d.ts
@@ -343,6 +344,17 @@ declare function parseGeneratedAgentDocument(raw: string): ParsedGeneratedAgentD
 declare function stripGeneratedAgentProvenance(raw: string): string;
 declare function serializeGeneratedAgentDocument(content: string, provenance: GeneratedAgentProvenance): string;
 //#endregion
+//#region src/mcp-auth.d.ts
+declare const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
+declare const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
+declare const DEFAULT_MCP_WELL_KNOWN_ROUTE = "/.well-known/mcp";
+declare const DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE = "/.well-known/oauth-protected-resource";
+declare function getDocsMcpResourcePaths(route?: string): string[];
+declare function buildDocsMcpProtectedResourceMetadataRoute(resourcePath: string): string;
+declare function getDocsMcpProtectedResourceMetadataRoutes(route?: string): string[];
+declare function hasDocsMcpProtectedResourceConfig(mcp?: boolean | DocsMcpConfig): boolean;
+declare function isDocsMcpRequest(url: URL, mcp?: boolean | DocsMcpConfig): boolean;
+//#endregion
 //#region src/agent.d.ts
 declare const DEFAULT_DOCS_API_ROUTE = "/api/docs";
 declare const DEFAULT_DOCS_CONFIG_FORMAT = "docs-config-map.v1";
@@ -353,9 +365,6 @@ declare const DEFAULT_OPENAPI_SCHEMA_ROUTE = "/api/docs?format=openapi";
 declare const DEFAULT_AGENT_SPEC_ROUTE = "/api/docs/agent/spec";
 declare const DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE = "/.well-known/agent";
 declare const DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE = "/.well-known/agent.json";
-declare const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
-declare const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
-declare const DEFAULT_MCP_WELL_KNOWN_ROUTE = "/.well-known/mcp";
 declare const DEFAULT_LLMS_TXT_ROUTE = "/llms.txt";
 declare const DEFAULT_LLMS_FULL_TXT_ROUTE = "/llms-full.txt";
 declare const DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms.txt";
@@ -604,6 +613,10 @@ interface DocsAgentDiscoverySpecOptions extends DocsDiscoveryApiRouteOptions {
     acceptHeader?: boolean;
     signatureAgentHeader?: boolean;
   };
+  /** Additional validated project skills to cross-list in custom discovery. */
+  publishedSkills?: readonly DocsPublishedAgentSkill[];
+  /** Explicit metadata for a real A2A service; omitted sites do not publish an Agent Card. */
+  agentCard?: DocsA2AAgentCardOptions;
 }
 interface DocsSkillDocumentOptions extends DocsDiscoveryApiRouteOptions {
   origin: string;
@@ -748,10 +761,11 @@ declare function createDocsStandardsDiscoveryResponse({
   sitemap,
   robots,
   openapi,
-  markdown: _markdown
+  markdown: _markdown,
+  publishedSkills,
+  agentCard
 }: DocsStandardsDiscoveryResponseOptions): Promise<Response | null>;
 declare function isDocsAgentDiscoveryRequest(url: URL, options?: DocsDiscoveryApiRouteOptions): boolean;
-declare function isDocsMcpRequest(url: URL): boolean;
 declare function buildDocsMcpEndpointCandidates(baseUrl: string, routes?: readonly string[], options?: DocsMcpEndpointCandidateOptions): DocsMcpEndpointCandidate[];
 declare function isDocsSkillRequest(url: URL, options?: DocsDiscoveryApiRouteOptions): boolean;
 declare function resolveDocsSkillFormat(url: URL): "skill" | null;
@@ -812,7 +826,9 @@ declare function buildDocsAgentDiscoverySpec({
   sitemap,
   robots,
   openapi,
-  markdown
+  markdown,
+  publishedSkills,
+  agentCard
 }: DocsAgentDiscoverySpecOptions): {
   version: string;
   name: string;
@@ -851,8 +867,10 @@ declare function buildDocsAgentDiscoverySpec({
     locales: boolean;
   };
   api: {
-    agentSkillsIndex: string;
     openapi: string;
+    agentCard?: string | undefined;
+    agentSkillsIndex: string;
+    legacySkillsIndex: string;
     apiCatalog?: string | undefined;
     apiCatalogQuery?: string | undefined;
     docs: string;
@@ -1001,16 +1019,38 @@ declare function buildDocsAgentDiscoverySpec({
       schema: string;
       index: string;
       artifact: string;
+      archive: string;
+      file: string;
+      legacyIndex: string;
       apiIndex: string;
       apiArtifact: string;
+      apiFile: string;
       digest: string;
     };
+    published: {
+      name: string;
+      description: string;
+      type: "skill-md" | "archive";
+      url: string;
+      digest: `sha256:${string}`;
+      files: {
+        path: string;
+        url: string;
+        digest: `sha256:${string}`;
+      }[];
+    }[];
     recommended: {
       name: string;
       description: string;
     }[];
   };
   mcp: {
+    protectedResource?: {
+      metadataEndpoints: string[];
+      authorizationServers: string[];
+      scopesSupported: string[];
+      requiredScopes: string[];
+    } | undefined;
     enabled: boolean;
     endpoint: string;
     defaultEndpoint: string;
@@ -1068,6 +1108,8 @@ interface DocsRobotsRenderOptions {
   entry?: string;
   /** Include the RFC 9727 catalog route only when the deployment actually serves it. */
   apiCatalog?: boolean;
+  /** Include an A2A Agent Card only when a real A2A service is configured. */
+  agentCard?: boolean;
   sitemap?: boolean | DocsSitemapConfig;
   baseUrl?: string;
   robots?: boolean | DocsRobotsConfig;
@@ -1096,4 +1138,4 @@ declare function renderDocsRobotsGeneratedBlock(options?: DocsRobotsRenderOption
 declare function upsertDocsRobotsGeneratedBlock(existing: string, block: string): string;
 declare function analyzeDocsRobotsTxt(content: string, options?: DocsRobotsRenderOptions): DocsRobotsAnalysis;
 //#endregion
-export { AGENT_SKILLS_DISCOVERY_SCHEMA_URI, type AIConfig, API_CATALOG_MEDIA_TYPE, API_CATALOG_PROFILE_URI, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CopyMarkdownFormat, type CreateDocsStandardsResponseOptions, type CustomDocsSearchConfig, 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_INDEX_FORMAT, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_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_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_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_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, type DocsAgentAdapter, type DocsAgentCompactConfig, type DocsAgentConfig, type DocsAgentConformanceCaseResult, type DocsAgentConformanceReport, type DocsAgentContractCase, type DocsAgentContractExpectation, type DocsAgentContractMcpTools, type DocsAgentContractRequest, type DocsAgentContractSurface, type DocsAgentDiscoverySpecOptions, type DocsAgentEvaluationAnswerInput, type DocsAgentEvaluationAnswerProvider, type DocsAgentEvaluationAnswerRequest, type DocsAgentEvaluationAnswerResult, type DocsAgentEvaluationAnswerRunner, type DocsAgentEvaluationSourceReference, type DocsAgentEvaluationSurface, type DocsAgentEvaluationTaskInput, type DocsAgentEvaluationsConfig, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsAgentFeedbackRequest, type DocsAgentFeedbackResolvedConfig, type DocsAgentGoldenAnswerExpectation, type DocsAgentGoldenExampleVerification, type DocsAgentGoldenExpectedExample, type DocsAgentGoldenTask, type DocsAgentGoldenTaskExpectation, type DocsAgentGoldenTaskFilters, type DocsAgentSkillIndexEntry, type DocsAgentSkillsIndex, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAgentsDocumentOptions, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAnalyticsEventType, type DocsAnalyticsInput, type DocsAnalyticsSource, type DocsApiCatalog, type DocsApiCatalogLinkContext, type DocsApiCatalogLinkTarget, type DocsApiCatalogOptions, type DocsAskAIActionData, type DocsAskAIActionType, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsAudienceMdxIssue, type DocsCloudApiKeyConfig, type DocsCloudConfig, type DocsCloudFeatureConfig, type DocsCloudPreviewConfig, type DocsCloudPublishConfig, type DocsCodeBlocksConfig, type DocsCodeBlocksPlannerConfig, type DocsCodeBlocksPlannerProvider, type DocsCodeBlocksRunnerConfig, type DocsCodeBlocksRunnerProvider, type DocsCodeBlocksValidateConfig, type DocsCodeBlocksValidationMode, type DocsCodeBlocksValidationPolicy, type DocsConfig, type DocsConfigMap, type DocsConfigMapJsonValue, type DocsConfigMapPointer, type DocsContentAudience, type DocsDiagnostics, type DocsDiagnosticsFeature, type DocsDiagnosticsIssue, type DocsDiagnosticsIssueSeverity, type DocsDiagnosticsOptions, type DocsDiagnosticsStatus, type DocsDiscoveryApiRouteOptions, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsLlmsTxtGeneratedContent, type DocsLlmsTxtGeneratedSection, type DocsLlmsTxtMaxCharsIssue, type DocsLlmsTxtPageInput, type DocsLlmsTxtRequest, type DocsLlmsTxtResolvedMaxChars, type DocsLlmsTxtResolvedSection, type DocsLlmsTxtSelectedContent, type DocsMarkdownAgentDetection, type DocsMarkdownPage, type DocsMarkdownRecoveryMatch, type DocsMarkdownRecoveryResult, type DocsMarkdownResponseOptions, type DocsMcpAllowedOrigins, type DocsMcpAuthPrincipal, type DocsMcpAuthenticate, type DocsMcpAuthenticateContext, type DocsMcpAuthenticateResult, type DocsMcpConfig, type DocsMcpCorsConfig, type DocsMcpEndpointCandidate, type DocsMcpEndpointCandidateOptions, type DocsMcpOriginContext, type DocsMcpSecurityConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsOpenApiDiscoveryConfig, type DocsOpenApiResolvedDiscoveryConfig, type DocsPageStructuredDataInput, type DocsPathMatch, type DocsPublishedAgentSkill, type DocsPublishedAgentSkillOptions, type DocsRelatedItem, type DocsReviewCiConfig, type DocsReviewCiMode, type DocsReviewConfig, type DocsReviewRulesConfig, type DocsReviewScoreConfig, type DocsReviewSeverity, type DocsRobotsConfig, type DocsRobotsRenderOptions, type DocsRobotsResolvedConfig, type DocsRobotsRule, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSitemapConfig, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type DocsSkillDocumentOptions, type DocsStandardsDiscoveryRequest, type DocsStandardsDiscoveryResponseOptions, type DocsStandardsDiscoveryRouteOptions, type DocsStructuredDataBreadcrumb, type DocsTelemetryAgentSurface, type DocsTelemetryAgentSurfaceContext, type DocsTelemetryAgentSurfaceRequestOptions, type DocsTelemetryConfig, type DocsTelemetryContext, type DocsTelemetryEvent, type DocsTelemetryEventInput, type DocsTelemetryEventType, type DocsTelemetryFeatures, type DocsTelemetryFramework, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type LlmsTxtMaxCharsConfig, type LlmsTxtMaxCharsMode, type LlmsTxtSectionConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenDocsProviderConfig, type OpenDocsProviderId, type OpenDocsTarget, type OpenGraphImage, type OrderingItem, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, type PageActionsConfig, type PageAgentAppliesTo, type PageAgentCommand, type PageAgentFailureMode, type PageAgentFrontmatter, type PageAgentFrontmatterIssue, type PageAgentVerification, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type PromptAction, type PromptProviderChoice, type ReadingTimeConfig, type ReadingTimeFormat, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsObservabilityConfig, type ResolvedDocsRelatedLink, type ResolvedDocsTelemetryConfig, type RunDocsAgentConformanceOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, acceptsDocsMarkdown, analyzeDocsRobotsTxt, appendDocsDiscoveryLinkHeader, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAgentSkillsIndex, buildDocsApiCatalog, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsMcpEndpointCandidates, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, createDocsStandardsResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsAudienceMdxIssues, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, 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, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsStandardsDiscoveryRequest, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, sha256DocsDiscoveryContent, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload };
+export { AGENT_SKILLS_DISCOVERY_SCHEMA_URI, type AIConfig, API_CATALOG_MEDIA_TYPE, API_CATALOG_PROFILE_URI, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CopyMarkdownFormat, type CreateDocsStandardsResponseOptions, type CustomDocsSearchConfig, DEFAULT_A2A_AGENT_CARD_FORMAT, DEFAULT_A2A_AGENT_CARD_ROUTE, 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_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, type DocsA2AAgentCard, type DocsA2AAgentCardOptions, type DocsAgentA2AConfig, type DocsAgentAdapter, type DocsAgentCompactConfig, type DocsAgentConfig, type DocsAgentConformanceCaseResult, type DocsAgentConformanceReport, type DocsAgentContractCase, type DocsAgentContractExpectation, type DocsAgentContractMcpTools, type DocsAgentContractRequest, type DocsAgentContractSurface, type DocsAgentDiscoverySpecOptions, type DocsAgentEvaluationAnswerInput, type DocsAgentEvaluationAnswerProvider, type DocsAgentEvaluationAnswerRequest, type DocsAgentEvaluationAnswerResult, type DocsAgentEvaluationAnswerRunner, type DocsAgentEvaluationSourceReference, type DocsAgentEvaluationSurface, type DocsAgentEvaluationTaskInput, type DocsAgentEvaluationsConfig, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsAgentFeedbackRequest, type DocsAgentFeedbackResolvedConfig, type DocsAgentGoldenAnswerExpectation, type DocsAgentGoldenExampleVerification, type DocsAgentGoldenExpectedExample, type DocsAgentGoldenTask, type DocsAgentGoldenTaskExpectation, type DocsAgentGoldenTaskFilters, type DocsAgentSkillIndexEntry, type DocsAgentSkillsConfig, type DocsAgentSkillsIndex, type DocsAgentSkillsInput, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAgentsDocumentOptions, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAnalyticsEventType, type DocsAnalyticsInput, type DocsAnalyticsSource, type DocsApiCatalog, type DocsApiCatalogLinkContext, type DocsApiCatalogLinkTarget, type DocsApiCatalogOptions, type DocsAskAIActionData, type DocsAskAIActionType, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsAudienceMdxIssue, type DocsCloudApiKeyConfig, type DocsCloudConfig, type DocsCloudFeatureConfig, type DocsCloudPreviewConfig, type DocsCloudPublishConfig, type DocsCodeBlocksConfig, type DocsCodeBlocksPlannerConfig, type DocsCodeBlocksPlannerProvider, type DocsCodeBlocksRunnerConfig, type DocsCodeBlocksRunnerProvider, type DocsCodeBlocksValidateConfig, type DocsCodeBlocksValidationMode, type DocsCodeBlocksValidationPolicy, type DocsConfig, type DocsConfigMap, type DocsConfigMapJsonValue, type DocsConfigMapPointer, type DocsContentAudience, type DocsDiagnostics, type DocsDiagnosticsFeature, type DocsDiagnosticsIssue, type DocsDiagnosticsIssueSeverity, type DocsDiagnosticsOptions, type DocsDiagnosticsStatus, type DocsDiscoveryApiRouteOptions, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsLlmsTxtGeneratedContent, type DocsLlmsTxtGeneratedSection, type DocsLlmsTxtMaxCharsIssue, type DocsLlmsTxtPageInput, type DocsLlmsTxtRequest, type DocsLlmsTxtResolvedMaxChars, type DocsLlmsTxtResolvedSection, type DocsLlmsTxtSelectedContent, type DocsMarkdownAgentDetection, type DocsMarkdownPage, type DocsMarkdownRecoveryMatch, type DocsMarkdownRecoveryResult, type DocsMarkdownResponseOptions, type DocsMcpAllowedOrigins, type DocsMcpAuthPrincipal, type DocsMcpAuthenticate, type DocsMcpAuthenticateContext, type DocsMcpAuthenticateResult, type DocsMcpConfig, type DocsMcpCorsConfig, type DocsMcpEndpointCandidate, type DocsMcpEndpointCandidateOptions, type DocsMcpOriginContext, type DocsMcpProtectedResourceConfig, type DocsMcpSecurityConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsOpenApiDiscoveryConfig, type DocsOpenApiResolvedDiscoveryConfig, type DocsPageStructuredDataInput, type DocsPathMatch, type DocsPublishedAgentSkill, type DocsPublishedAgentSkillFile, type DocsPublishedAgentSkillOptions, type DocsRelatedItem, type DocsReviewCiConfig, type DocsReviewCiMode, type DocsReviewConfig, type DocsReviewRulesConfig, type DocsReviewScoreConfig, type DocsReviewSeverity, type DocsRobotsConfig, type DocsRobotsRenderOptions, type DocsRobotsResolvedConfig, type DocsRobotsRule, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSitemapConfig, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type DocsSkillDocumentOptions, type DocsStandardsDiscoveryRequest, type DocsStandardsDiscoveryResponseOptions, type DocsStandardsDiscoveryRouteOptions, type DocsStructuredDataBreadcrumb, type DocsTelemetryAgentSurface, type DocsTelemetryAgentSurfaceContext, type DocsTelemetryAgentSurfaceRequestOptions, type DocsTelemetryConfig, type DocsTelemetryContext, type DocsTelemetryEvent, type DocsTelemetryEventInput, type DocsTelemetryEventType, type DocsTelemetryFeatures, type DocsTelemetryFramework, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type LlmsTxtMaxCharsConfig, type LlmsTxtMaxCharsMode, type LlmsTxtSectionConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenDocsProviderConfig, type OpenDocsProviderId, type OpenDocsTarget, type OpenGraphImage, type OrderingItem, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, type PageActionsConfig, type PageAgentAppliesTo, type PageAgentCommand, type PageAgentFailureMode, type PageAgentFrontmatter, type PageAgentFrontmatterIssue, type PageAgentVerification, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type PromptAction, type PromptProviderChoice, type ReadingTimeConfig, type ReadingTimeFormat, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsObservabilityConfig, type ResolvedDocsRelatedLink, type ResolvedDocsTelemetryConfig, type RunDocsAgentConformanceOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, acceptsDocsMarkdown, analyzeDocsRobotsTxt, appendDocsDiscoveryLinkHeader, applySidebarFolderIndexBehavior, buildDocsA2AAgentCard, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAgentSkillsIndex, buildDocsApiCatalog, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsLegacySkillsIndex, buildDocsMcpEndpointCandidates, buildDocsMcpProtectedResourceMetadataRoute, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, createDocsStandardsResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsAudienceMdxIssues, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsMcpProtectedResourceMetadataRoutes, getDocsMcpResourcePaths, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasDocsMcpProtectedResourceConfig, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, 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, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsStandardsDiscoveryRequest, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, sha256DocsDiscoveryContent, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload };

package/dist/index.mjs

@@ -1,9 +1,10 @@
-import { a as resolveReadingTimeOptions, c as runDocsAgentConformance, d as extendTheme, f as deepMerge, i as resolveReadingTimeFromSource, m as defineDocs, n as resolvePageReadingTime, o as DOCS_AGENT_CONTRACT_VERSION, p as resolveChangelogConfig, r as resolveReadingTimeFromContent, s as createDocsAgentContractCases, t as estimateReadingTimeMinutes, u as createTheme } from "./reading-time-BkEft6SD.mjs";
+import { a as resolveReadingTimeOptions, c as runDocsAgentConformance, d as extendTheme, f as deepMerge, i as resolveReadingTimeFromSource, m as defineDocs, n as resolvePageReadingTime, o as DOCS_AGENT_CONTRACT_VERSION, p as resolveChangelogConfig, r as resolveReadingTimeFromContent, s as createDocsAgentContractCases, t as estimateReadingTimeMinutes, u as createTheme } from "./reading-time-C-SAhQT9.mjs";
 import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig, i as emitDocsAgentTraceEvent, l as resolveDocsObservabilityConfig, n as createDocsAgentTraceContext, o as emitDocsObservabilityEvent, r as createDocsAgentTraceId, s as getDocsRequestAnalyticsProperties, t as DOCS_AGENT_TRACE_EVENT_TYPES } from "./analytics-Bx44lg6d.mjs";
-import { $ as matchesDocsLlmsTxtSection, $t as appendDocsDiscoveryLinkHeader, A as DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, At as DEFAULT_SITEMAP_MD_DOCS_ROUTE, B as findDocsMarkdownPage, Bt as resolveDocsSitemapPageLastmod, C as DEFAULT_OPENAPI_SCHEMA_ROUTE, Ct as validateDocsAgentFeedbackPayload, D as DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, Dt as resolveDocsAudienceExposure, E as DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, Et as resolveDocsAgentMdxContent, F as buildDocsDiagnostics, Ft as createDocsSitemapResponse, G as isDocsAgentDiscoveryRequest, Gt as API_CATALOG_PROFILE_URI, H as getDocsMarkdownCanonicalLinkHeader, Ht as toDocsSitemapMarkdownUrl, I as buildDocsMcpEndpointCandidates, It as readDocsSitemapManifestFromContentMap, J as isDocsDiagnosticsRequest, Jt as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, K as isDocsAgentsRequest, Kt as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, L as createDocsMarkdownResponse, Lt as renderDocsSitemapMarkdown, M as buildDocsAgentDiscoverySpec, Mt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, N as buildDocsAgentFeedbackSchema, Nt as DEFAULT_SITEMAP_XML_ROUTE, Ot as resolveDocsAudienceMdxContent, P as buildDocsConfigMap, Pt as buildDocsSitemapManifest, Q as isDocsSkillRequest, Qt as DEFAULT_API_CATALOG_ROUTE, R as createDocsStandardsDiscoveryResponse, Rt as renderDocsSitemapXml, S as DEFAULT_MCP_WELL_KNOWN_ROUTE, Sn as upsertPageAgentContractMarkdown, St as toDocsMarkdownUrl, T as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, U as getDocsMarkdownVaryHeader, Ut as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, V as getDocsLlmsTxtMaxCharsIssue, Vt as resolveDocsSitemapRequest, W as hasDocsMarkdownSignatureAgent, Wt as API_CATALOG_MEDIA_TYPE, X as isDocsMcpRequest, Xt as DEFAULT_AGENT_SKILL_FORMAT, Y as isDocsLlmsTxtPublicRequest, Yt as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, Z as isDocsPublicGetRequest, Zt as DEFAULT_API_CATALOG_FORMAT, _ as DEFAULT_LLMS_TXT_MAX_CHARS, _n as hasStructuredPageAgentContract, _t as resolveDocsMarkdownRequest, a as DEFAULT_AGENT_MD_ROUTE, an as resolveDocsDiscoveryApiRoute, at as renderDocsMarkdownDocument, b as DEFAULT_MCP_PUBLIC_ROUTE, bn as renderPageAgentFrontmatterYamlLines, bt as resolveDocsSkillFormat, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, cn as sha256DocsDiscoveryContent, ct as resolveDocsAgentContractMcpTools, d as DEFAULT_DOCS_CONFIG_FORMAT, dn as PAGE_AGENT_CONTRACT_END_MARKER, dt as resolveDocsAgentsFormat, en as buildDocsAgentSkillsIndex, et as normalizeDocsPathSegment, f as DEFAULT_DOCS_CONFIG_ROUTE, fn as PAGE_AGENT_CONTRACT_FIELDS, ft as resolveDocsLlmsTxtFormat, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, gn as getPageAgentFrontmatterIssues, gt as resolveDocsMarkdownRecovery, h as DEFAULT_LLMS_FULL_TXT_ROUTE, hn as PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, ht as resolveDocsMarkdownCanonicalUrl, i as DEFAULT_AGENT_FEEDBACK_ROUTE, in as isDocsStandardsDiscoveryRequest, it as renderDocsLlmsTxt, j as acceptsDocsMarkdown, jt as DEFAULT_SITEMAP_MD_ROUTE, k as DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, kt as DEFAULT_SITEMAP_MANIFEST_PATH, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, ln as normalizeDocsRelated, lt as resolveDocsAgentFeedbackConfig, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, mn as PAGE_AGENT_CONTRACT_START_MARKER, mt as resolveDocsLlmsTxtSections, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as createDocsStandardsResponse, nt as parseDocsAgentFeedbackData, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, on as resolveDocsPublishedAgentSkill, ot as renderDocsMarkdownNotFound, p as DEFAULT_DOCS_DIAGNOSTICS_FORMAT, pn as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, pt as resolveDocsLlmsTxtRequest, q as isDocsConfigRequest, qt as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, r as DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, rn as getDocsDiscoveryLinkHeader, rt as renderDocsAgentsDocument, s as DEFAULT_AGENT_SPEC_ROUTE, sn as resolveDocsStandardsDiscoveryRequest, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, tn as buildDocsApiCatalog, tt as normalizeDocsUrlPath, u as DEFAULT_DOCS_API_ROUTE, un as renderDocsRelatedMarkdownLines, ut as resolveDocsAgentFeedbackRequest, v as DEFAULT_LLMS_TXT_ROUTE, vn as normalizePageAgentFrontmatter, vt as resolveDocsOpenApiDiscoveryConfig, w as DEFAULT_SKILL_MD_ROUTE, wt as findDocsAudienceMdxIssues, x as DEFAULT_MCP_ROUTE, xn as stripGeneratedPageAgentContractMarkdown, xt as selectDocsLlmsTxtContent, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, yn as renderPageAgentContractMarkdown, yt as resolveDocsRequestApiRoute, z as detectDocsMarkdownAgentRequest, zt as resolveDocsSitemapConfig } from "./agent-BFqyqEnC.mjs";
-import { A as getDocsTelemetryFeatures, C as resolvePageSidebarFolderIndexBehavior, D as emitDocsTelemetryEvent, E as emitDocsTelemetryAgentSurfaceEvent, M as isLocalDocsTelemetryOrigin, N as normalizeDocsTelemetryOrigin, O as emitDocsTelemetryMcpToolEvent, P as resolveDocsTelemetryConfig, S as applySidebarFolderIndexBehavior, T as resolveSidebarFolderIndexBehaviorForPath, _ as hashGeneratedAgentContent, a as createMcpSearchAdapter, b as serializeGeneratedAgentDocument, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as GENERATED_AGENT_PROVENANCE_VERSION, h as GENERATED_AGENT_PROVENANCE_MARKER, i as createCustomSearchAdapter, j as inferDocsTelemetryAgentSurface, k as emitDocsTelemetryProjectEvent, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as normalizeGeneratedAgentContent, w as resolveSidebarFolderIndexBehavior, x as stripGeneratedAgentProvenance, y as parseGeneratedAgentDocument } from "./search-D57JXQLj.mjs";
-import { n as resolveDocsLocale, r as resolveDocsPath, t as resolveDocsI18n } from "./i18n-CAlj1ADU.mjs";
-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-ltltiLJF.mjs";
-import { a as resolveDocsMetadataBaseUrl, i as renderDocsPageStructuredDataJson, n as buildPageOpenGraph, o as resolveOGImage, r as buildPageTwitter, s as resolveTitle, t as buildDocsPageStructuredData } from "./metadata-BDuewuzq.mjs";
+import { $ as renderDocsAgentsDocument, $t as DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, A as buildDocsAgentFeedbackSchema, At as buildDocsSitemapManifest, B as getDocsMarkdownVaryHeader, Bt as renderDocsRelatedMarkdownLines, C as DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, Ct as resolveDocsAudienceExposure, D as DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, Dt as DEFAULT_SITEMAP_MD_ROUTE, E as DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, Et as DEFAULT_SITEMAP_MD_DOCS_ROUTE, F as createDocsStandardsDiscoveryResponse, Ft as resolveDocsSitemapConfig, G as isDocsDiagnosticsRequest, Gt as PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, H as isDocsAgentDiscoveryRequest, Ht as PAGE_AGENT_CONTRACT_FIELDS, I as detectDocsMarkdownAgentRequest, It as resolveDocsSitemapPageLastmod, J as isDocsSkillRequest, Jt as normalizePageAgentFrontmatter, K as isDocsLlmsTxtPublicRequest, Kt as getPageAgentFrontmatterIssues, L as findDocsMarkdownPage, Lt as resolveDocsSitemapRequest, M as buildDocsDiagnostics, Mt as readDocsSitemapManifestFromContentMap, N as buildDocsMcpEndpointCandidates, Nt as renderDocsSitemapMarkdown, O as acceptsDocsMarkdown, Ot as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, P as createDocsMarkdownResponse, Pt as renderDocsSitemapXml, Q as parseDocsAgentFeedbackData, Qt as upsertPageAgentContractMarkdown, R as getDocsLlmsTxtMaxCharsIssue, Rt as toDocsSitemapMarkdownUrl, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, St as resolveDocsAgentMdxContent, Tt as DEFAULT_SITEMAP_MANIFEST_PATH, U as isDocsAgentsRequest, Ut as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, V as hasDocsMarkdownSignatureAgent, Vt as PAGE_AGENT_CONTRACT_END_MARKER, W as isDocsConfigRequest, Wt as PAGE_AGENT_CONTRACT_START_MARKER, X as normalizeDocsPathSegment, Xt as renderPageAgentFrontmatterYamlLines, Y as matchesDocsLlmsTxtSection, Yt as renderPageAgentContractMarkdown, Z as normalizeDocsUrlPath, Zt as stripGeneratedPageAgentContractMarkdown, _ as DEFAULT_LLMS_TXT_MAX_CHARS, _t as selectDocsLlmsTxtContent, a as DEFAULT_AGENT_MD_ROUTE, an as getDocsMcpResourcePaths, at as resolveDocsAgentFeedbackConfig, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, bt as findDocsAudienceMdxIssues, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as resolveDocsLlmsTxtFormat, d as DEFAULT_DOCS_CONFIG_FORMAT, dt as resolveDocsMarkdownCanonicalUrl, en as DEFAULT_MCP_PUBLIC_ROUTE, et as renderDocsLlmsTxt, f as DEFAULT_DOCS_CONFIG_ROUTE, ft as resolveDocsMarkdownRecovery, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, gt as resolveDocsSkillFormat, h as DEFAULT_LLMS_FULL_TXT_ROUTE, ht as resolveDocsRequestApiRoute, i as DEFAULT_AGENT_FEEDBACK_ROUTE, in as getDocsMcpProtectedResourceMetadataRoutes, it as resolveDocsAgentContractMcpTools, j as buildDocsConfigMap, jt as createDocsSitemapResponse, k as buildDocsAgentDiscoverySpec, kt as DEFAULT_SITEMAP_XML_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, ln as isDocsMcpRequest, lt as resolveDocsLlmsTxtRequest, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, mt as resolveDocsOpenApiDiscoveryConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, nt as renderDocsMarkdownNotFound, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, on as hasDocsMcpProtectedResourceConfig, ot as resolveDocsAgentFeedbackRequest, p as DEFAULT_DOCS_DIAGNOSTICS_FORMAT, pt as resolveDocsMarkdownRequest, q as isDocsPublicGetRequest, qt as hasStructuredPageAgentContract, r as DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, rn as buildDocsMcpProtectedResourceMetadataRoute, rt as renderDocsSkillDocument, s as DEFAULT_AGENT_SPEC_ROUTE, st as resolveDocsAgentsFormat, t as DEFAULT_AGENTS_MD_ROUTE, tn as DEFAULT_MCP_ROUTE, tt as renderDocsMarkdownDocument, u as DEFAULT_DOCS_API_ROUTE, ut as resolveDocsLlmsTxtSections, v as DEFAULT_LLMS_TXT_ROUTE, vt as toDocsMarkdownUrl, w as DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, wt as resolveDocsAudienceMdxContent, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, yt as validateDocsAgentFeedbackPayload, z as getDocsMarkdownCanonicalLinkHeader, zt as normalizeDocsRelated } from "./agent-Fl0pjVNF.mjs";
+import { A as resolveDocsStandardsDiscoveryRequest, C as buildDocsApiCatalog, D as isDocsStandardsDiscoveryRequest, E as getDocsDiscoveryLinkHeader, O as resolveDocsDiscoveryApiRoute, S as buildDocsAgentSkillsIndex, T as createDocsStandardsResponse, _ as DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as appendDocsDiscoveryLinkHeader, c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, d as DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, f as DEFAULT_AGENT_SKILL_FILE_FORMAT, g as DEFAULT_API_CATALOG_ROUTE, h as DEFAULT_API_CATALOG_FORMAT, i as DEFAULT_A2A_AGENT_CARD_FORMAT, j as sha256DocsDiscoveryContent, k as resolveDocsPublishedAgentSkill, l as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, m as DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, n as API_CATALOG_MEDIA_TYPE, o as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, p as DEFAULT_AGENT_SKILL_FORMAT, r as API_CATALOG_PROFILE_URI, s as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, v as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, w as buildDocsLegacySkillsIndex, x as buildDocsA2AAgentCard, y as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-C54V_aJH.mjs";
+import { A as getDocsTelemetryFeatures, C as resolvePageSidebarFolderIndexBehavior, D as emitDocsTelemetryEvent, E as emitDocsTelemetryAgentSurfaceEvent, M as isLocalDocsTelemetryOrigin, N as normalizeDocsTelemetryOrigin, O as emitDocsTelemetryMcpToolEvent, P as resolveDocsTelemetryConfig, S as applySidebarFolderIndexBehavior, T as resolveSidebarFolderIndexBehaviorForPath, _ as hashGeneratedAgentContent, a as createMcpSearchAdapter, b as serializeGeneratedAgentDocument, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as GENERATED_AGENT_PROVENANCE_VERSION, h as GENERATED_AGENT_PROVENANCE_MARKER, i as createCustomSearchAdapter, j as inferDocsTelemetryAgentSurface, k as emitDocsTelemetryProjectEvent, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as normalizeGeneratedAgentContent, w as resolveSidebarFolderIndexBehavior, x as stripGeneratedAgentProvenance, y as parseGeneratedAgentDocument } from "./search-9OnMGMvt.mjs";
+import { n as resolveDocsLocale, r as resolveDocsPath, t as resolveDocsI18n } from "./i18n-CCaFUnAN.mjs";
+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-C08kDLsz.mjs";
+import { a as resolveDocsMetadataBaseUrl, i as renderDocsPageStructuredDataJson, n as buildPageOpenGraph, o as resolveOGImage, r as buildPageTwitter, s as resolveTitle, t as buildDocsPageStructuredData } from "./metadata-Dv1ah0Aj.mjs";
 
-export { AGENT_SKILLS_DISCOVERY_SCHEMA_URI, API_CATALOG_MEDIA_TYPE, API_CATALOG_PROFILE_URI, 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_INDEX_FORMAT, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_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_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_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_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, 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, applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAgentSkillsIndex, buildDocsApiCatalog, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsMcpEndpointCandidates, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, createDocsStandardsResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsAudienceMdxIssues, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, 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, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsStandardsDiscoveryRequest, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, sha256DocsDiscoveryContent, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload };
+export { AGENT_SKILLS_DISCOVERY_SCHEMA_URI, API_CATALOG_MEDIA_TYPE, API_CATALOG_PROFILE_URI, DEFAULT_A2A_AGENT_CARD_FORMAT, DEFAULT_A2A_AGENT_CARD_ROUTE, 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_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, 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, applySidebarFolderIndexBehavior, buildDocsA2AAgentCard, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAgentSkillsIndex, buildDocsApiCatalog, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsLegacySkillsIndex, buildDocsMcpEndpointCandidates, buildDocsMcpProtectedResourceMetadataRoute, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, createDocsStandardsResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsAudienceMdxIssues, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsMcpProtectedResourceMetadataRoutes, getDocsMcpResourcePaths, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasDocsMcpProtectedResourceConfig, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, 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, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsStandardsDiscoveryRequest, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, sha256DocsDiscoveryContent, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload };

package/dist/{init-Bd_k06bR.mjs → init-CQY0Woe3.mjs}

@@ -1,5 +1,5 @@
-import { a as devInstallCommand, c as fileExists, d as readFileSafe, f as spawnAndWaitFor, i as detectPackageManagerFromProject, l as formatPackageManagerDetection, n as detectGlobalCssFiles, o as exec, p as writeFileSafe, r as detectNextAppDir, t as detectFramework, u as installCommand } from "./utils-6UCLxv4B.mjs";
-import { $ as svelteDocsPublicHookTemplate, A as nextConfigMergedTemplate, B as nuxtServerApiDocsRouteTemplate, C as injectRootProviderIntoLayout, D as injectTanstackVitePlugins, E as injectTanstackRootProviderIntoRoute, F as nuxtDocsConfigTemplate, G as quickstartPageTemplate, H as nuxtServerDocsPublicMiddlewareTemplate, I as nuxtDocsPageTemplate, J as svelteDocsApiRouteTemplate, K as rootLayoutTemplate, L as nuxtGlobalCssTemplate, M as nextLocaleDocPageTemplate, N as nextLocalizedPageTemplate, O as installationPageTemplate, P as nuxtConfigTemplate, Q as svelteDocsPageTemplate, R as nuxtInstallationPageTemplate, S as injectNuxtCssImport, T as injectSvelteDocsPublicHook, U as nuxtWelcomePageTemplate, V as nuxtServerApiReferenceRouteTemplate, W as postcssConfigTemplate, X as svelteDocsLayoutServerTemplate, Y as svelteDocsConfigTemplate, Z as svelteDocsLayoutTemplate, _ as getAstroAdapterPkg, _t as tanstackViteConfigTemplate, a as astroDocsIndexTemplate, at as svelteWelcomePageTemplate, b as injectAstroDocsMiddleware, bt as welcomePageTemplate, c as astroDocsServerTemplate, ct as tanstackDocsCatchAllRouteTemplate, d as astroQuickstartPageTemplate, dt as tanstackDocsIndexRouteTemplate, et as svelteDocsServerTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsPublicRouteTemplate, g as docsLayoutTemplate, gt as tanstackRootRouteTemplate, h as docsConfigTemplate, ht as tanstackQuickstartPageTemplate, i as astroDocsConfigTemplate, it as svelteRootLayoutTemplate, j as nextConfigTemplate, k as nextApiReferencePageTemplate, l as astroGlobalCssTemplate, lt as tanstackDocsConfigTemplate, m as customThemeTsTemplate, mt as tanstackInstallationPageTemplate, n as astroApiRouteTemplate, nt as svelteInstallationPageTemplate, o as astroDocsMiddlewareTemplate, ot as tanstackApiDocsRouteTemplate, p as customThemeCssTemplate, pt as tanstackDocsServerTemplate, q as svelteApiReferenceRouteTemplate, r as astroConfigTemplate, rt as svelteQuickstartPageTemplate, s as astroDocsPageTemplate, st as tanstackApiReferenceRouteTemplate, t as astroApiReferenceRouteTemplate, tt as svelteGlobalCssTemplate, u as astroInstallationPageTemplate, ut as tanstackDocsFunctionsTemplate, v as globalCssTemplate, vt as tanstackWelcomePageTemplate, w as injectSvelteCssImport, x as injectCssImport, y as injectAstroCssImport, yt as tsconfigTemplate, z as nuxtQuickstartPageTemplate } from "./templates-DNw15P-x.mjs";
+import { a as devInstallCommand, c as fileExists, d as readFileSafe, f as spawnAndWaitFor, i as detectPackageManagerFromProject, l as formatPackageManagerDetection, n as detectGlobalCssFiles, o as exec, p as writeFileSafe, r as detectNextAppDir, t as detectFramework, u as installCommand } from "./utils-DpiIioYb.mjs";
+import { $ as svelteDocsLayoutServerTemplate, A as injectTanstackVitePlugins, B as nuxtGlobalCssTemplate, C as injectDocsAgentSkillsVitePlugin, Ct as tsconfigTemplate, D as injectSvelteCssImport, E as injectRootProviderIntoLayout, F as nextLocaleDocPageTemplate, G as nuxtServerDocsPublicMiddlewareTemplate, H as nuxtQuickstartPageTemplate, I as nextLocalizedPageTemplate, J as quickstartPageTemplate, K as nuxtWelcomePageTemplate, L as nuxtConfigTemplate, M as nextApiReferencePageTemplate, N as nextConfigMergedTemplate, O as injectSvelteDocsPublicHook, P as nextConfigTemplate, Q as svelteDocsConfigTemplate, R as nuxtDocsConfigTemplate, S as injectCssImport, St as tanstackWelcomePageTemplate, T as injectNuxtCssImport, U as nuxtServerApiDocsRouteTemplate, V as nuxtInstallationPageTemplate, W as nuxtServerApiReferenceRouteTemplate, X as svelteApiReferenceRouteTemplate, Y as rootLayoutTemplate, Z as svelteDocsApiRouteTemplate, _ as getAstroAdapterPkg, _t as tanstackDocsServerTemplate, a as astroDocsIndexTemplate, at as svelteInstallationPageTemplate, b as injectAstroCssImport, bt as tanstackRootRouteTemplate, c as astroDocsServerTemplate, ct as svelteViteConfigTemplate, d as astroQuickstartPageTemplate, dt as tanstackApiReferenceRouteTemplate, et as svelteDocsLayoutTemplate, f as astroWelcomePageTemplate, ft as tanstackDocsCatchAllRouteTemplate, g as docsLayoutTemplate, gt as tanstackDocsPublicRouteTemplate, h as docsConfigTemplate, ht as tanstackDocsIndexRouteTemplate, i as astroDocsConfigTemplate, it as svelteGlobalCssTemplate, j as installationPageTemplate, k as injectTanstackRootProviderIntoRoute, l as astroGlobalCssTemplate, lt as svelteWelcomePageTemplate, m as customThemeTsTemplate, mt as tanstackDocsFunctionsTemplate, n as astroApiRouteTemplate, nt as svelteDocsPublicHookTemplate, o as astroDocsMiddlewareTemplate, ot as svelteQuickstartPageTemplate, p as customThemeCssTemplate, pt as tanstackDocsConfigTemplate, q as postcssConfigTemplate, r as astroConfigTemplate, rt as svelteDocsServerTemplate, s as astroDocsPageTemplate, st as svelteRootLayoutTemplate, t as astroApiReferenceRouteTemplate, tt as svelteDocsPageTemplate, u as astroInstallationPageTemplate, ut as tanstackApiDocsRouteTemplate, v as globalCssTemplate, vt as tanstackInstallationPageTemplate, w as injectNuxtAgentSkillsPlugin, wt as welcomePageTemplate, x as injectAstroDocsMiddleware, xt as tanstackViteConfigTemplate, y as injectAstroAgentSkillsPlugin, yt as tanstackQuickstartPageTemplate, z as nuxtDocsPageTemplate } from "./templates-Bq_P7ctv.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
@@ -188,7 +188,7 @@ async function configureDocsCloudOnboarding(options) {
 		enabled = cloudAnswer;
 	}
 	if (!enabled) return;
-	const { initCloudConfig } = await import("./cloud-BH_sHX64.mjs");
+	const { initCloudConfig } = await import("./cloud-pdNC-tyj.mjs");
 	printDocsCloudOnboardingInstructions(await initCloudConfig({
 		rootDir: options.rootDir,
 		configPath: getDocsCloudConfigPathForFramework(options.framework)
@@ -1073,6 +1073,17 @@ function scaffoldSvelteKit(cwd, cfg, globalCssRelPath, write, skipped, written)
 	}
 	write("src/lib/docs.config.ts", svelteDocsConfigTemplate(cfg));
 	write("src/lib/docs.server.ts", svelteDocsServerTemplate(cfg));
+	const viteConfigRel = fileExists(path.join(cwd, "vite.config.ts")) ? "vite.config.ts" : fileExists(path.join(cwd, "vite.config.mts")) ? "vite.config.mts" : fileExists(path.join(cwd, "vite.config.js")) ? "vite.config.js" : "vite.config.ts";
+	const viteConfigPath = path.join(cwd, viteConfigRel);
+	const existingViteConfig = readFileSafe(viteConfigPath);
+	if (!existingViteConfig) write(viteConfigRel, svelteViteConfigTemplate(), true);
+	else {
+		const injected = injectDocsAgentSkillsVitePlugin(existingViteConfig, "./src/lib/docs.config");
+		if (injected) {
+			writeFileSafe(viteConfigPath, injected, true);
+			written.push(`${viteConfigRel} (updated)`);
+		} else skipped.push(`${viteConfigRel} (already configured)`);
+	}
 	write(`src/routes/${cfg.entry}/+layout.svelte`, svelteDocsLayoutTemplate(cfg));
 	write(`src/routes/${cfg.entry}/+layout.server.js`, svelteDocsLayoutServerTemplate(cfg));
 	write(`src/routes/${cfg.entry}/[...slug]/+page.svelte`, svelteDocsPageTemplate(cfg));
@@ -1133,7 +1144,17 @@ function scaffoldAstro(cwd, cfg, globalCssRelPath, write, skipped, written) {
 	}
 	write("src/lib/docs.config.ts", astroDocsConfigTemplate(cfg));
 	write("src/lib/docs.server.ts", astroDocsServerTemplate(cfg));
-	if (!fileExists(path.join(cwd, "astro.config.mjs")) && !fileExists(path.join(cwd, "astro.config.ts"))) write("astro.config.mjs", astroConfigTemplate(cfg.astroAdapter ?? "vercel"));
+	const astroConfigRel = fileExists(path.join(cwd, "astro.config.mjs")) ? "astro.config.mjs" : fileExists(path.join(cwd, "astro.config.ts")) ? "astro.config.ts" : "astro.config.mjs";
+	const astroConfigPath = path.join(cwd, astroConfigRel);
+	const existingAstroConfig = readFileSafe(astroConfigPath);
+	if (!existingAstroConfig) write(astroConfigRel, astroConfigTemplate(cfg.astroAdapter ?? "vercel"));
+	else {
+		const injected = injectAstroAgentSkillsPlugin(existingAstroConfig);
+		if (injected) {
+			writeFileSafe(astroConfigPath, injected, true);
+			written.push(`${astroConfigRel} (updated)`);
+		} else skipped.push(`${astroConfigRel} (already configured)`);
+	}
 	write(`src/pages/${cfg.entry}/index.astro`, astroDocsIndexTemplate(cfg));
 	write(`src/pages/${cfg.entry}/[...slug].astro`, astroDocsPageTemplate(cfg));
 	write(`src/pages/api/${cfg.entry}.ts`, astroApiRouteTemplate(cfg));
@@ -1198,7 +1219,17 @@ function scaffoldNuxt(cwd, cfg, globalCssRelPath, write, skipped, written) {
 		write(apiReferenceIndexRoute, nuxtServerApiReferenceRouteTemplate(apiReferenceIndexRoute, cfg.useAlias));
 		write(apiReferenceCatchAllRoute, nuxtServerApiReferenceRouteTemplate(apiReferenceCatchAllRoute, cfg.useAlias));
 	}
-	if (!fileExists(path.join(cwd, "nuxt.config.ts")) && !fileExists(path.join(cwd, "nuxt.config.js"))) write("nuxt.config.ts", nuxtConfigTemplate(cfg));
+	const nuxtConfigRel = fileExists(path.join(cwd, "nuxt.config.ts")) ? "nuxt.config.ts" : fileExists(path.join(cwd, "nuxt.config.js")) ? "nuxt.config.js" : "nuxt.config.ts";
+	const nuxtConfigPath = path.join(cwd, nuxtConfigRel);
+	const existingNuxtConfig = readFileSafe(nuxtConfigPath);
+	if (!existingNuxtConfig) write(nuxtConfigRel, nuxtConfigTemplate(cfg));
+	else {
+		const injected = injectNuxtAgentSkillsPlugin(existingNuxtConfig);
+		if (injected) {
+			writeFileSafe(nuxtConfigPath, injected, true);
+			written.push(`${nuxtConfigRel} (updated)`);
+		} else skipped.push(`${nuxtConfigRel} (already configured)`);
+	}
 	const cssTheme = {
 		fumadocs: "fumadocs",
 		darksharp: "darksharp",

package/dist/{mcp-B_yXL5G5.mjs → mcp-DyPcoLwm.mjs}

@@ -1,12 +1,15 @@
-import "./agent-BFqyqEnC.mjs";
-import "./search-D57JXQLj.mjs";
-import "./sitemap-server-C1ibVKOy.mjs";
-import "./agent-evals-kJs2Y9xR.mjs";
+import "./agent-Fl0pjVNF.mjs";
+import { k as resolveDocsPublishedAgentSkill } from "./standards-discovery-C54V_aJH.mjs";
+import "./search-9OnMGMvt.mjs";
+import "./sitemap-server-D_0Kzanj.mjs";
+import "./agent-evals-f4_OL10T.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
+import "./code-blocks-DnNVNK2M.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-CIeBszxp.mjs";
 import "./server.mjs";
-import { d as readStringProperty, h as resolveDocsContentDir, l as readNavTitle, m as resolveDocsConfigPath, n as extractObjectLiteral, s as readBooleanProperty } from "./config-DASewQ0x.mjs";
-import { readFileSync } from "node:fs";
+import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, i as hasTopLevelProperty, l as readBooleanProperty, n as extractObjectLiteral, o as loadDocsConfigModuleResult, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
 import pc from "picocolors";
 
 //#region src/cli/mcp.ts
@@ -27,18 +30,34 @@ async function runMcp(options = {}) {
 	}
 	const rootDir = process.cwd();
 	const content = readFileSync(resolveDocsConfigPath(rootDir, options.configPath), "utf-8");
+	const configLoad = await loadDocsConfigModuleResult(rootDir, options.configPath);
+	const loadedConfig = configLoad.status === "evaluated" ? configLoad.config : void 0;
+	const staticAgent = extractNestedObjectLiteral(content, ["agent"]);
+	if (configLoad.status === "static-fallback" && staticAgent && hasTopLevelProperty(staticAgent, "skills")) throw new Error(`Could not evaluate ${configLoad.path}, so configured agent.skills cannot be published through MCP. ${configLoad.error}`);
 	const entry = readStringProperty(content, "entry") ?? "docs";
 	const contentDir = resolveDocsContentDir(rootDir, content, entry);
 	const navTitle = readNavTitle(content);
 	const mcp = readMcpConfig(content);
+	const filesystemSource = createFilesystemDocsMcpSource({
+		rootDir,
+		entry,
+		contentDir,
+		siteTitle: navTitle ?? "Documentation"
+	});
+	const resolvedMcp = resolveDocsMcpConfig(mcp ?? true, { defaultName: navTitle ?? "@farming-labs/docs" });
 	await runDocsMcpStdio({
-		source: createFilesystemDocsMcpSource({
-			rootDir,
-			entry,
-			contentDir,
-			siteTitle: navTitle ?? "Documentation"
-		}),
-		mcp: resolveDocsMcpConfig(mcp ?? true, { defaultName: navTitle ?? "@farming-labs/docs" }),
+		source: {
+			...filesystemSource,
+			async getSkills() {
+				const configured = await resolveConfiguredAgentSkills(loadedConfig?.agent?.skills, { rootDir });
+				const rootSkillPath = path.join(rootDir, "skill.md");
+				return [await resolveDocsPublishedAgentSkill({
+					preferredDocument: existsSync(rootSkillPath) ? readFileSync(rootSkillPath, "utf8") : null,
+					fallbackDocument: `---\nname: docs\ndescription: Use the project documentation through MCP resources and tools.\n---\n\n# Documentation\n`
+				}), ...configured];
+			}
+		},
+		mcp: resolvedMcp,
 		defaultName: navTitle ?? "@farming-labs/docs"
 	});
 }

package/dist/mcp.d.mts

@@ -1,4 +1,5 @@
-import { $t as DocsTelemetryFramework, Ct as DocsObservabilityConfig, F as DocsAnalyticsConfig, Gt as DocsSearchSourcePage, Jt as DocsTelemetryConfig, Sn as PageAgentFrontmatter, _n as OrderingItem, dt as DocsMcpAllowedOrigins, ft as DocsMcpAuthPrincipal, gt as DocsMcpConfig, pt as DocsMcpAuthenticate, zt as DocsSearchConfig } from "./types-XHABMh_f.mjs";
+import { A as DocsPublishedAgentSkill } from "./standards-discovery-C4HUqMd2.mjs";
+import { Dt as DocsObservabilityConfig, En as PageAgentFrontmatter, Qt as DocsTelemetryConfig, R as DocsAnalyticsConfig, Ut as DocsSearchConfig, Yt as DocsSearchSourcePage, gt as DocsMcpAuthenticate, ht as DocsMcpAuthPrincipal, mt as DocsMcpAllowedOrigins, rn as DocsTelemetryFramework, xn as OrderingItem, yt as DocsMcpConfig } from "./types-EhFhYGfr.mjs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
 //#region src/mcp.d.ts
@@ -189,6 +190,8 @@ interface DocsMcpSource {
   siteTitle?: string;
   getPages(locale?: string, context?: DocsMcpRequestContext): DocsMcpPage[] | Promise<DocsMcpPage[]>;
   getNavigation(locale?: string, context?: DocsMcpRequestContext): DocsMcpNavigationTree | Promise<DocsMcpNavigationTree>;
+  /** Reusable Agent Skills exposed as progressive-disclosure MCP resources. */
+  getSkills?(context?: DocsMcpRequestContext): readonly DocsPublishedAgentSkill[] | Promise<readonly DocsPublishedAgentSkill[]>;
 }
 /** Request-scoped identity available to custom MCP sources. */
 interface DocsMcpRequestContext {
@@ -199,9 +202,17 @@ interface DocsMcpRequestContext {
 interface DocsMcpResolvedSecurityConfig {
   allowedOrigins: DocsMcpAllowedOrigins;
   authenticate?: DocsMcpAuthenticate;
+  protectedResource?: DocsMcpResolvedProtectedResourceConfig;
   maxBodyBytes: number;
   cors: DocsMcpResolvedCorsConfig;
 }
+interface DocsMcpResolvedProtectedResourceConfig {
+  authorizationServers: string[];
+  scopesSupported: string[];
+  requiredScopes: string[];
+  resourceName?: string;
+  resourceDocumentation?: string;
+}
 interface DocsMcpResolvedCorsConfig {
   enabled: boolean;
   allowedHeaders: string[];
@@ -284,4 +295,4 @@ declare function getDocsConfigSchema(filters?: {
 }): DocsMcpConfigSchema;
 declare function buildDocsMcpContext(options: DocsMcpContextOptions): Promise<DocsMcpContextResult>;
 //#endregion
-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, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, buildDocsMcpContext, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio };
+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 };