@farming-labs/docs 0.2.69 → 0.2.71

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/dist/{agent-D2SsSct2.mjs → agent-FIyl4-Oa.mjs} +510 -11
  2. package/dist/{agent-BIzynBvk.mjs → agent-bof3qzKZ.mjs} +2 -2
  3. package/dist/{agent-evals-DZR4J7Iz.mjs → agent-evals-Cr9TAkmB.mjs} +2 -1
  4. package/dist/{agent-export-C_zd18VF.mjs → agent-export-7Ws4KqDE.mjs} +11 -8
  5. package/dist/agent-skills-bundle.d.mts +1 -1
  6. package/dist/{agent-skills-server-iBfCLPOt.mjs → agent-skills-server-B4u3qy-1.mjs} +9 -5
  7. package/dist/{agent-skills-server-DJXdK_hS.d.mts → agent-skills-server-DTwblsLu.d.mts} +1 -1
  8. package/dist/agent-skills-spec.d.mts +51 -0
  9. package/dist/agent-skills-spec.mjs +284 -0
  10. package/dist/agent-skills-vite.d.mts +2 -2
  11. package/dist/agent-skills-vite.mjs +2 -2
  12. package/dist/{agents-BR5tSkbq.mjs → agents-Be2ntaFr.mjs} +6 -6
  13. package/dist/cli/index.mjs +14 -14
  14. package/dist/docs-cloud-server.d.mts +1 -1
  15. package/dist/{doctor-CVhU0YKo.mjs → doctor-DoPAofVP.mjs} +32 -15
  16. package/dist/{golden-evaluations-DK1uqjlo.mjs → golden-evaluations-CPGGnXOV.mjs} +1 -1
  17. package/dist/index.d.mts +84 -6
  18. package/dist/index.mjs +8 -7
  19. package/dist/{mcp-YWlNI2d4.mjs → mcp-BLynUzE7.mjs} +6 -6
  20. package/dist/mcp.d.mts +1 -1
  21. package/dist/mcp.mjs +3 -3
  22. package/dist/{metadata-CNjcFhQN.mjs → metadata-bw8k-9x-.mjs} +1 -1
  23. package/dist/{reading-time-O8mYgLvH.mjs → reading-time-DtNegNiq.mjs} +119 -7
  24. package/dist/{review-DdfvxMh2.mjs → review-NFnYbMRI.mjs} +6 -6
  25. package/dist/{robots-CD14j-mU.mjs → robots-B3e-aWPy.mjs} +3 -3
  26. package/dist/{robots-Dz5XeT8F.mjs → robots-DOqBwQw8.mjs} +2 -2
  27. package/dist/{search-BBVD0A7O.d.mts → search-CozHzW7v.d.mts} +1 -1
  28. package/dist/{search-DjN1Gfid.mjs → search-DOGUUZvs.mjs} +6 -6
  29. package/dist/{search-DBlw9h3P.mjs → search-x5O0-9X3.mjs} +2 -142
  30. package/dist/server.d.mts +3 -3
  31. package/dist/server.mjs +6 -6
  32. package/dist/{sitemap-B0hlAZ8o.mjs → sitemap-BpMKdDUd.mjs} +6 -6
  33. package/dist/{sitemap-server-DQp8qUKN.mjs → sitemap-server-D_hayOp6.mjs} +1 -1
  34. package/dist/{standards-discovery-DSVKdQrl.mjs → standards-discovery-CYfiQE13.mjs} +8 -31
  35. package/package.json +7 -1
  36. /package/dist/{cloud-ask-ai-BD1SeVZv.d.mts → cloud-ask-ai-BfnX18rI.d.mts} +0 -0
  37. /package/dist/{standards-discovery-CQjJ-M2y.d.mts → standards-discovery-C0CIC4QI.d.mts} +0 -0
@@ -1,23 +1,25 @@
1
- import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-BIzynBvk.mjs";
2
- import { l as httpLinkHeaderHasTargetRelation } from "./reading-time-O8mYgLvH.mjs";
3
- import { Dt as DEFAULT_SITEMAP_MD_ROUTE, Ft as resolveDocsSitemapConfig, Ht as PAGE_AGENT_CONTRACT_FIELDS, N as buildDocsMcpEndpointCandidates, Ot as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, dn as normalizeDocsMcpAuthorizationServerUrls, en as DEFAULT_MCP_PUBLIC_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, in as getDocsMcpProtectedResourceMetadataRoutes, j as buildDocsConfigMap, k as buildDocsAgentDiscoverySpec, kt as DEFAULT_SITEMAP_XML_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, sn as isDocsMcpOAuthScopeToken, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-D2SsSct2.mjs";
4
- import { F as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-DSVKdQrl.mjs";
5
- import { d as resolveAskAISearchRequestConfig } from "./search-DBlw9h3P.mjs";
6
- import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-Dz5XeT8F.mjs";
7
- import { a as resolveDocsMetadataBaseUrl } from "./metadata-CNjcFhQN.mjs";
8
- import "./sitemap-server-DQp8qUKN.mjs";
9
- import { t as runDocsGoldenTasks } from "./agent-evals-DZR4J7Iz.mjs";
1
+ import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-bof3qzKZ.mjs";
2
+ import { d as readAgentSkillDocumentFromTar, l as httpLinkHeaderHasTargetRelation, u as AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES } from "./reading-time-DtNegNiq.mjs";
3
+ import { A as buildDocsAgentDiscoverySpec, F as buildDocsMcpEndpointCandidates, Ft as DEFAULT_SITEMAP_XML_ROUTE, M as buildDocsConfigMap, Nt as DEFAULT_SITEMAP_MD_ROUTE, Pt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Vt as resolveDocsSitemapConfig, Xt as PAGE_AGENT_CONTRACT_FIELDS, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, cn as DEFAULT_MCP_PUBLIC_ROUTE, fn as getDocsMcpProtectedResourceMetadataRoutes, h as DEFAULT_LLMS_FULL_TXT_ROUTE, hn as isDocsMcpOAuthScopeToken, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, un as DEFAULT_MCP_WELL_KNOWN_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, yn as normalizeDocsMcpAuthorizationServerUrls } from "./agent-FIyl4-Oa.mjs";
4
+ import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
5
+ import { F as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-CYfiQE13.mjs";
6
+ import { d as resolveAskAISearchRequestConfig } from "./search-x5O0-9X3.mjs";
7
+ import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-DOqBwQw8.mjs";
8
+ import { a as resolveDocsMetadataBaseUrl } from "./metadata-bw8k-9x-.mjs";
9
+ import "./sitemap-server-D_hayOp6.mjs";
10
+ import { t as runDocsGoldenTasks } from "./agent-evals-Cr9TAkmB.mjs";
10
11
  import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
11
12
  import "./code-blocks-DnNVNK2M.mjs";
12
- import "./agent-skills-server-iBfCLPOt.mjs";
13
+ import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B4u3qy-1.mjs";
13
14
  import "./server.mjs";
14
15
  import { _ as resolveDocsContentDir, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, r as extractTopLevelConfigObject, s as loadDocsConfigModuleResultWithProjectEnv, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
15
16
  import { t as detectFramework } from "./utils-DpiIioYb.mjs";
16
- import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-DK1uqjlo.mjs";
17
+ import { i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CPGGnXOV.mjs";
17
18
  import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
18
19
  import path from "node:path";
19
20
  import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";
20
21
  import { createHash } from "node:crypto";
22
+ import { gunzipSync } from "node:zlib";
21
23
  import pc from "picocolors";
22
24
 
23
25
  //#region src/cli/doctor.ts
@@ -602,6 +604,7 @@ function navigationScore(navigationCoverage) {
602
604
  }
603
605
  const AGENT_OPTIMIZATION_BLOCKING_CHECKS = new Set([
604
606
  "surface-drift",
607
+ "agent-skills-frontmatter",
605
608
  "agent-context-quality",
606
609
  "agent-task-completeness",
607
610
  "agent-applicability",
@@ -1288,7 +1291,7 @@ async function probeApiCatalogRoute(baseUrl) {
1288
1291
  }
1289
1292
  function isValidAgentSkillEntry(value) {
1290
1293
  const entry = asRecord(value);
1291
- return Boolean(entry && typeof entry.name === "string" && /^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(entry.name) && entry.name.length <= 64 && (entry.type === "skill-md" || entry.type === "archive") && isNonEmptyString(entry.description) && entry.description.length <= 1024 && isNonEmptyString(entry.url) && typeof entry.digest === "string" && /^sha256:[0-9a-f]{64}$/u.test(entry.digest));
1294
+ return Boolean(entry && typeof entry.name === "string" && isDocsAgentSkillName(entry.name) && (entry.type === "skill-md" || entry.type === "archive") && isNonEmptyString(entry.description) && Array.from(entry.description).length <= 1024 && isNonEmptyString(entry.url) && typeof entry.digest === "string" && /^sha256:[0-9a-f]{64}$/u.test(entry.digest));
1292
1295
  }
1293
1296
  async function probeAgentSkillsDiscovery(baseUrl) {
1294
1297
  const route = DEFAULT_AGENT_SKILLS_INDEX_ROUTE;
@@ -1328,7 +1331,7 @@ async function probeAgentSkillsDiscovery(baseUrl) {
1328
1331
  failures.push(`${skill.name} has an invalid artifact URL`);
1329
1332
  continue;
1330
1333
  }
1331
- const expectedPath = skill.type === "archive" ? `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${skill.name}.tar.gz` : DEFAULT_AGENT_SKILLS_ROUTE_PATTERN.replace("{name}", skill.name);
1334
+ const expectedPath = skill.type === "archive" ? `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(skill.name)}.tar.gz` : DEFAULT_AGENT_SKILLS_ROUTE_PATTERN.replace("{name}", encodeURIComponent(skill.name));
1332
1335
  const expectedMediaType = skill.type === "archive" ? "application/gzip" : "text/markdown";
1333
1336
  if (artifactUrl.origin !== baseOrigin) {
1334
1337
  failures.push(`${skill.name} artifact is not same-origin`);
@@ -1352,6 +1355,9 @@ async function probeAgentSkillsDiscovery(baseUrl) {
1352
1355
  else if (content.length === 0) failures.push(`${skill.name} artifact is empty`);
1353
1356
  else if (computedDigest !== skill.digest) failures.push(`${skill.name} artifact digest does not match the index`);
1354
1357
  else artifactDetails.push(`${skill.name} digest verified`);
1358
+ const validation = validateDocsAgentSkillFrontmatter(skill.type === "skill-md" ? new TextDecoder("utf-8", { fatal: true }).decode(content) : readAgentSkillDocumentFromTar(gunzipSync(content, { maxOutputLength: AGENT_SKILL_ARCHIVE_MAX_UNCOMPRESSED_BYTES })), { directoryName: skill.name });
1359
+ if (!validation.valid) failures.push(`${skill.name} has invalid SKILL.md frontmatter: ${validation.issues.map((issue) => issue.message).join("; ")}`);
1360
+ else if (validation.data.description !== skill.description) failures.push(`${skill.name} SKILL.md description does not match the index`);
1355
1361
  } catch (error) {
1356
1362
  failures.push(`${skill.name} artifact failed: ${error instanceof Error ? error.message : String(error)}`);
1357
1363
  }
@@ -1638,6 +1644,14 @@ async function inspectAgentReadiness(options = {}) {
1638
1644
  const configContent = readFileSync(configPath, "utf-8");
1639
1645
  const configLoad = await loadDocsConfigModuleResultWithProjectEnv(rootDir, options.configPath);
1640
1646
  const config = configLoad.status === "evaluated" ? configLoad.config : void 0;
1647
+ let configuredAgentSkillNames;
1648
+ let configuredAgentSkillsError;
1649
+ const configuredAgentSkills = config?.agent?.skills;
1650
+ if (configuredAgentSkills) try {
1651
+ configuredAgentSkillNames = (await resolveConfiguredAgentSkills(configuredAgentSkills, { rootDir })).map((skill) => skill.name);
1652
+ } catch (error) {
1653
+ configuredAgentSkillsError = error instanceof Error ? error.message : String(error);
1654
+ }
1641
1655
  const entry = config?.entry ?? readTopLevelStringProperty(configContent, "entry") ?? "docs";
1642
1656
  const contentDir = config?.contentDir ?? resolveDocsContentDir(rootDir, configContent, entry);
1643
1657
  const ordering = config?.ordering === "alphabetical" || config?.ordering === "numeric" || Array.isArray(config?.ordering) ? config.ordering : void 0;
@@ -1650,7 +1664,9 @@ async function inspectAgentReadiness(options = {}) {
1650
1664
  const mcpEnabled = resolveFeatureEnabled(config, configContent, "mcp");
1651
1665
  const agentFeedbackEnabled = resolveAgentFeedbackEnabled(config, configContent);
1652
1666
  const compactConfigured = hasAgentCompactDefaults(config, configContent);
1653
- const skillFileExists = existsSync(path.join(rootDir, "skill.md"));
1667
+ const skillFilePath = path.join(rootDir, "skill.md");
1668
+ const skillFileExists = existsSync(skillFilePath);
1669
+ const rootSkillValidation = skillFileExists ? validateDocsAgentSkillFrontmatter(readFileSync(skillFilePath, "utf8")) : void 0;
1654
1670
  const agentsFileExists = existsSync(path.join(rootDir, "AGENTS.md")) || existsSync(path.join(rootDir, "AGENT.md"));
1655
1671
  const source = createFilesystemDocsMcpSource({
1656
1672
  rootDir,
@@ -1761,6 +1777,7 @@ async function inspectAgentReadiness(options = {}) {
1761
1777
  });
1762
1778
  const checks = [];
1763
1779
  checks.push(makeCheck("config", "Docs config", configLoad.status === "evaluated" ? "pass" : "warn", configLoad.status === "evaluated" ? 10 : 2, configCheckMax, configLoad.status === "evaluated" ? `Resolved ${path.relative(rootDir, configLoad.path).replace(/\\/g, "/")} and evaluated the config module.` : `Resolved ${path.relative(rootDir, configPath).replace(/\\/g, "/")} using static parsing fallback.`, configLoad.status === "evaluated" ? void 0 : "Fix docs.config module evaluation before relying on resolved diagnostic scores."));
1780
+ checks.push(makeCheck("agent-skills-frontmatter", "Configured Agent Skills frontmatter", configLoad.status !== "evaluated" ? "warn" : configuredAgentSkillsError ? "fail" : "pass", configLoad.status === "evaluated" && !configuredAgentSkillsError ? 1 : 0, 1, configLoad.status !== "evaluated" ? "Not verified because docs.config could not be evaluated." : configuredAgentSkillsError ? configuredAgentSkillsError : configuredAgentSkillNames ? `${configuredAgentSkillNames.length} configured Agent Skill${configuredAgentSkillNames.length === 1 ? "" : "s"} passed full frontmatter validation: ${configuredAgentSkillNames.join(", ")}.` : "No configured Agent Skills require validation.", configuredAgentSkillsError ? "Fix every configured SKILL.md field reported here before building or publishing the docs site." : void 0));
1764
1781
  const canScoreSurfaceDrift = configLoad.status === "evaluated";
1765
1782
  checks.push(makeCheck("surface-drift", "Discovery/config/schema consistency", !canScoreSurfaceDrift ? "warn" : surfaceDrift.length === 0 ? "pass" : "fail", !canScoreSurfaceDrift ? 0 : surfaceDrift.length === 0 ? 10 : Math.max(0, 10 - surfaceDrift.length * 2), 10, !canScoreSurfaceDrift ? "Not scored because docs.config could not be evaluated; static parsing cannot prove discovery/config/schema consistency." : surfaceDrift.length === 0 ? "Resolved config, discovery metadata, MCP tool flags, config schema, and agent contract fields agree." : surfaceDrift.slice(0, 3).map((issue) => issue.message).join(" "), canScoreSurfaceDrift && surfaceDrift.length === 0 ? void 0 : canScoreSurfaceDrift ? "Align docs config, agent discovery (including API catalog and Agent Skills routes), MCP tools, config schema, and the canonical page agent contract before publishing." : "Fix docs.config module evaluation so doctor can compare resolved config with discovery and schema surfaces."));
1766
1783
  const dynamicStaticFallback = configLoad.status === "static-fallback" && /(?:\.\.\.|process\.env|import\.meta\.env|\[[^\]]+\]\s*:|:\s*[A-Za-z_$][\w$]*\s*[,}])/u.test(configContent);
@@ -1794,7 +1811,7 @@ async function inspectAgentReadiness(options = {}) {
1794
1811
  const complete = analysis.hasAgentRoutes && analysis.hasAiPolicy;
1795
1812
  checks.push(makeCheck("robots", "Robots agent policy", blocked ? "fail" : complete ? "pass" : "warn", blocked ? 0 : complete ? 5 : 3, 5, blocked ? `${relativeRobotsPath} blocks ${analysis.blocksAiAgents ? "common AI crawlers" : "agent-readable docs routes"}.` : complete ? `${relativeRobotsPath} advertises agent-readable routes and common AI crawler policy.` : `${relativeRobotsPath} exists, but is missing ${analysis.missingRoutes.length > 0 ? `agent routes (${analysis.missingRoutes.join(", ")})` : "common AI crawler policy"}.`, blocked || !complete ? `Run docs robots generate --append --path ${relativeRobotsPath} to add the generated agent policy without replacing the existing file.` : void 0));
1796
1813
  }
1797
- checks.push(skillFileExists ? makeCheck("skill", "Skill document", "pass", 5, 5, `Found root skill.md for ${DEFAULT_SKILL_MD_ROUTE} and ${DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE}.`) : makeCheck("skill", "Skill document", "pass", 5, 5, `No root skill.md found; the framework will serve the generated fallback at ${DEFAULT_SKILL_MD_ROUTE}.`));
1814
+ checks.push(skillFileExists ? rootSkillValidation?.valid ? makeCheck("skill", "Skill document", "pass", 5, 5, `Found a standards-compliant root skill.md for ${DEFAULT_SKILL_MD_ROUTE}, ${DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE}, and Agent Skills discovery.`) : makeCheck("skill", "Skill document", "warn", 4, 5, `Root skill.md remains available on the legacy routes, but Agent Skills discovery will publish the generated fallback because its frontmatter is invalid: ${rootSkillValidation?.issues.map((issue) => issue.message).join("; ")}`, "Add complete Agent Skills frontmatter to root skill.md if it should be published through standards discovery.") : makeCheck("skill", "Skill document", "pass", 5, 5, `No root skill.md found; the framework will serve the generated fallback at ${DEFAULT_SKILL_MD_ROUTE}.`));
1798
1815
  checks.push(agentsFileExists ? makeCheck("agents", "Agent instructions", "pass", 5, 5, `Found root AGENTS.md/AGENT.md for ${DEFAULT_AGENTS_MD_ROUTE} and ${DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE}.`) : makeCheck("agents", "Agent instructions", "pass", 5, 5, `No root AGENTS.md found; the framework will serve the generated fallback at ${DEFAULT_AGENTS_MD_ROUTE}.`));
1799
1816
  checks.push(mcpEnabled ? makeCheck("mcp", "MCP access", "pass", 10, 10, `Enabled with public aliases ${DEFAULT_MCP_PUBLIC_ROUTE} and ${DEFAULT_MCP_WELL_KNOWN_ROUTE} (canonical route ${mcpConfig.route}).`) : makeCheck("mcp", "MCP access", "warn", 0, 10, "MCP is disabled in docs config.", "Enable mcp so agents can use list/search/read tools directly instead of only scraping markdown routes."));
1800
1817
  checks.push(searchEnabled ? makeCheck("search", "Search surface", "pass", 5, 5, "Search is enabled for the shared docs API and agent flows.") : makeCheck("search", "Search surface", "warn", 0, 5, "Search is disabled in docs config.", "Enable search so agents can narrow retrieval before reading whole markdown pages."));
@@ -1,4 +1,4 @@
1
- import { Jt as normalizePageAgentFrontmatter, qt as hasStructuredPageAgentContract, wt as resolveDocsAudienceMdxContent, xt as findDocsAudienceMdxTags } from "./agent-D2SsSct2.mjs";
1
+ import { At as resolveDocsAudienceMdxContent, Dt as findDocsAudienceMdxTags, nn as normalizePageAgentFrontmatter, tn as hasStructuredPageAgentContract } from "./agent-FIyl4-Oa.mjs";
2
2
  import { n as agentVersionConstraintsOverlap, o as normalizeAgentVersion, r as normalizeAgentFramework } from "./agent-scope-C_U--OZ7.mjs";
3
3
  import { t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";
4
4
  import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
package/dist/index.d.mts CHANGED
@@ -1,6 +1,7 @@
1
1
  import { $ as DocsAgentSkillsInput, $n as ResolvedDocsRelatedLink, $t as DocsReviewRulesConfig, A as DocsAgentA2ASecurityScheme, An as LlmsTxtMaxCharsMode, At as DocsFeedbackData, B as DocsAgentEvaluationSourceReference, Bn as OrderingItem, Bt as DocsMcpOriginContext, C as DocsAgentA2AOAuthDeviceCodeFlow, Cn as DocsTheme, Ct as DocsCodeBlocksPlannerProvider, D as DocsAgentA2AOpenIdConnectSecurityScheme, Dn as LastUpdatedConfig, Dt as DocsCodeBlocksValidationMode, E as DocsAgentA2AOAuthPasswordFlow, En as GithubConfig, Et as DocsCodeBlocksValidateConfig, F as DocsAgentEvaluationAnswerInput, Fn as OpenDocsProvider, Ft as DocsMcpAuthenticate, G as DocsAgentFeedbackData, Gn as PageAgentFrontmatter, Gt as DocsNav, H as DocsAgentEvaluationTaskInput, Hn as PageAgentAppliesTo, Ht as DocsMcpSecurityConfig, I as DocsAgentEvaluationAnswerProvider, In as OpenDocsProviderConfig, It as DocsMcpAuthenticateContext, J as DocsAgentGoldenExpectedExample, Jn as PageOpenGraph, Jt as DocsObservabilityEventInput, K as DocsAgentGoldenAnswerExpectation, Kn as PageAgentVerification, Kt as DocsObservabilityConfig, L as DocsAgentEvaluationAnswerRequest, Ln as OpenDocsProviderId, Lt as DocsMcpAuthenticateResult, M as DocsAgentA2ASkill, Mn as McpDocsSearchConfig, Mt as DocsI18nConfig, N as DocsAgentCompactConfig, Nn as OGConfig, Nt as DocsMcpAllowedOrigins, O as DocsAgentA2AProtocolBinding, On as LlmsTxtConfig, Ot as DocsCodeBlocksValidationPolicy, P as DocsAgentConfig, Pn as OpenDocsConfig, Pt as DocsMcpAuthPrincipal, Q as DocsAgentSkillsConfig, Qn as ReadingTimeFormat, Qt as DocsReviewConfig, R as DocsAgentEvaluationAnswerResult, Rn as OpenDocsTarget, Rt as DocsMcpConfig, S as DocsAgentA2AOAuthClientCredentialsFlow, Sn as DocsTelemetryFramework, St as DocsCodeBlocksPlannerConfig, T as DocsAgentA2AOAuthImplicitFlow, Tn as FontStyle, Tt as DocsCodeBlocksRunnerProvider, U as DocsAgentEvaluationsConfig, Un as PageAgentCommand, Ut as DocsMcpToolsConfig, V as DocsAgentEvaluationSurface, Vn as PageActionsConfig, Vt as DocsMcpProtectedResourceConfig, W as DocsAgentFeedbackContext, Wn as PageAgentFailureMode, Wt as DocsMetadata, X as DocsAgentGoldenTaskExpectation, Xn as PageTwitter, Xt as DocsReviewCiConfig, Y as DocsAgentGoldenTask, Yn as PageSidebarFrontmatter, Yt as DocsRelatedItem, Z as DocsAgentGoldenTaskFilters, Zn as ReadingTimeConfig, Zt as DocsReviewCiMode, _ as DocsAgentA2AHttpAuthSecurityScheme, _n as DocsTelemetryConfig, _t as DocsCloudConfig, a as ApiReferenceRenderer, an as DocsSearchAdapterContext, ar as SidebarPageNode, at as DocsAnalyticsEventInput, b as DocsAgentA2AOAuth2SecurityScheme, bn as DocsTelemetryEventType, bt as DocsCloudPublishConfig, c as ChangelogFrontmatter, cn as DocsSearchConfig, cr as ThemeToggleConfig, ct as DocsAnalyticsSource, d as CopyMarkdownFormat, dn as DocsSearchQuery, dr as UIConfig, dt as DocsAskAIFeedbackConfig, en as DocsReviewScoreConfig, er as SidebarComponentProps, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, fn as DocsSearchResult, ft as DocsAskAIFeedbackData, g as DocsAgentA2AExtension, gn as DocsTelemetryAgentSurface, gt as DocsCloudApiKeyConfig, h as DocsAgentA2AConfig, hn as DocsSitemapConfig, ht as DocsAskAIMcpConfig, i as ApiReferenceConfig, in as DocsSearchAdapter, ir as SidebarNode, it as DocsAnalyticsEvent, j as DocsAgentA2ASecurityScopeList, jn as LlmsTxtSectionConfig, jt as DocsFeedbackValue, k as DocsAgentA2ASecurityRequirement, kn as LlmsTxtMaxCharsConfig, kt as DocsConfig, l as CodeBlockCopyData, ln as DocsSearchDocument, lr as TypesenseDocsSearchConfig, lt as DocsAskAIActionData, m as DocsAgentA2ACapabilities, mn as DocsSearchSourcePage, mt as DocsAskAIFeedbackValue, n as AgentFeedbackConfig, nn as DocsRobotsConfig, nr as SidebarFolderIndexBehavior, nt as DocsAgentTraceStatus, o as BreadcrumbConfig, on as DocsSearchAdapterFactory, or as SidebarTree, ot as DocsAnalyticsEventType, p as DocsAgentA2AApiKeySecurityScheme, pn as DocsSearchResultType, pt as DocsAskAIFeedbackMessage, q as DocsAgentGoldenExampleVerification, qn as PageFrontmatter, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rn as DocsRobotsRule, rr as SidebarFolderNode, rt as DocsAnalyticsConfig, s as ChangelogConfig, sn as DocsSearchChunkingConfig, sr as SimpleDocsSearchConfig, st as DocsAnalyticsInput, t as AIConfig, tn as DocsReviewSeverity, tr as SidebarConfig, tt as DocsAgentTraceEventType, u as CopyMarkdownConfig, un as DocsSearchEmbeddingsConfig, ur as TypographyConfig, ut as DocsAskAIActionType, v as DocsAgentA2AInterfaceConfig, vn as DocsTelemetryEvent, vt as DocsCloudFeatureConfig, w as DocsAgentA2AOAuthFlows, wn as FeedbackConfig, wt as DocsCodeBlocksRunnerConfig, x as DocsAgentA2AOAuthAuthorizationCodeFlow, xn as DocsTelemetryFeatures, xt as DocsCodeBlocksConfig, y as DocsAgentA2AMutualTlsSecurityScheme, yn as DocsTelemetryEventInput, yt as DocsCloudPreviewConfig, z as DocsAgentEvaluationAnswerRunner, zn as OpenGraphImage, zt as DocsMcpCorsConfig } from "./types-BQC05SQm.mjs";
2
- import { $ as sha256DocsDiscoveryContent, A as DocsAgentSkillsIndex, B as DocsStandardsDiscoveryRouteOptions, C as DOCS_AGENT_MANIFEST_FORMAT, D as DocsA2AAgentCardOptions, E as DocsA2AAgentCard, F as DocsDiscoveryApiRouteOptions, G as buildDocsLegacySkillsIndex, H as buildDocsA2AAgentCard, I as DocsPublishedAgentSkill, J as getDocsDiscoveryLinkHeader, K as createDocsStandardsResponse, L as DocsPublishedAgentSkillFile, M as DocsApiCatalogLinkContext, N as DocsApiCatalogLinkTarget, O as DocsA2AAgentInterface, P as DocsApiCatalogOptions, Q as resolveDocsStandardsDiscoveryRequest, R as DocsPublishedAgentSkillOptions, S as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, T as DOCS_AGENT_MANIFEST_SCHEMA_URI, U as buildDocsAgentSkillsIndex, V as appendDocsDiscoveryLinkHeader, W as buildDocsApiCatalog, X as resolveDocsDiscoveryApiRoute, Y as isDocsStandardsDiscoveryRequest, Z as resolveDocsPublishedAgentSkill, _ as DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, a as DEFAULT_A2A_AGENT_CARD_FORMAT, b as DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, c as DEFAULT_A2A_PROTOCOL_VERSION, d as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, g as DEFAULT_AGENT_SKILL_FORMAT, h as DEFAULT_AGENT_SKILL_FILE_FORMAT, i as CreateDocsStandardsResponseOptions, j as DocsApiCatalog, k as DocsAgentSkillIndexEntry, l as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, m as DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, n as API_CATALOG_MEDIA_TYPE, o as DEFAULT_A2A_AGENT_CARD_ROUTE, p as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, q as getDocsAgentManifestLinkHeader, r as API_CATALOG_PROFILE_URI, s as DEFAULT_A2A_PROTOCOL_BINDING, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, v as DEFAULT_API_CATALOG_FORMAT, w as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, x as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, y as DEFAULT_API_CATALOG_ROUTE, z as DocsStandardsDiscoveryRequest } from "./standards-discovery-CQjJ-M2y.mjs";
3
- import { $ as resolveDocsAudienceExposure, A as resolveDocsSitemapPageLastmod, B as SerializedOpenDocsProvider, C as DocsSitemapResolvedConfig, D as renderDocsSitemapMarkdown, E as readDocsSitemapManifestFromContentMap, L as PromptAction, M as toDocsSitemapMarkdownUrl, O as renderDocsSitemapXml, Q as resolveDocsAgentMdxContent, R as PromptProviderChoice, S as DocsSitemapPageInput, T as createDocsSitemapResponse, X as DocsContentAudience, Y as DocsAudienceMdxIssue, Z as findDocsAudienceMdxIssues, _ as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, a as createMcpSearchAdapter, at as createDocsAgentTraceContext, b as DocsSitemapManifest, c as formatDocsAskAIPackageHints, ct as emitDocsAnalyticsEvent, d as resolveAskAISearchRequestConfig, dt as resolveDocsAnalyticsConfig, et as resolveDocsAudienceMdxContent, f as resolveDocsSearchAudience, ft as resolveDocsObservabilityConfig, g as DEFAULT_SITEMAP_MD_ROUTE, h as DEFAULT_SITEMAP_MD_DOCS_ROUTE, i as createCustomSearchAdapter, it as ResolvedDocsObservabilityConfig, j as resolveDocsSitemapRequest, k as resolveDocsSitemapConfig, l as inferDocsAskAIPackageHints, lt as emitDocsObservabilityEvent, m as DEFAULT_SITEMAP_MANIFEST_PATH, n as buildDocsSearchDocuments, nt as DocsAgentTraceContext, o as createSimpleSearchAdapter, ot as createDocsAgentTraceId, p as resolveSearchRequestConfig, r as createAlgoliaSearchAdapter, rt as ResolvedDocsAnalyticsConfig, s as createTypesenseSearchAdapter, st as emitDocsAgentTraceEvent, t as buildDocsAskAIContext, tt as DOCS_AGENT_TRACE_EVENT_TYPES, u as performDocsSearch, ut as getDocsRequestAnalyticsProperties, v as DEFAULT_SITEMAP_XML_ROUTE, w as buildDocsSitemapManifest, x as DocsSitemapManifestPage, y as DocsSitemapFormat, z as SerializeOpenDocsProviderOptions } from "./search-BBVD0A7O.mjs";
2
+ import { AGENT_SKILL_COMPATIBILITY_MAX_LENGTH, AGENT_SKILL_DESCRIPTION_MAX_LENGTH, AGENT_SKILL_FRONTMATTER_FIELDS, AGENT_SKILL_NAME_MAX_LENGTH, DocsAgentSkillFrontmatter, DocsAgentSkillFrontmatterError, DocsAgentSkillFrontmatterField, DocsAgentSkillFrontmatterIssue, DocsAgentSkillFrontmatterValidation, DocsAgentSkillFrontmatterValidationOptions, isDocsAgentSkillName, parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
3
+ import { $ as sha256DocsDiscoveryContent, A as DocsAgentSkillsIndex, B as DocsStandardsDiscoveryRouteOptions, C as DOCS_AGENT_MANIFEST_FORMAT, D as DocsA2AAgentCardOptions, E as DocsA2AAgentCard, F as DocsDiscoveryApiRouteOptions, G as buildDocsLegacySkillsIndex, H as buildDocsA2AAgentCard, I as DocsPublishedAgentSkill, J as getDocsDiscoveryLinkHeader, K as createDocsStandardsResponse, L as DocsPublishedAgentSkillFile, M as DocsApiCatalogLinkContext, N as DocsApiCatalogLinkTarget, O as DocsA2AAgentInterface, P as DocsApiCatalogOptions, Q as resolveDocsStandardsDiscoveryRequest, R as DocsPublishedAgentSkillOptions, S as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, T as DOCS_AGENT_MANIFEST_SCHEMA_URI, U as buildDocsAgentSkillsIndex, V as appendDocsDiscoveryLinkHeader, W as buildDocsApiCatalog, X as resolveDocsDiscoveryApiRoute, Y as isDocsStandardsDiscoveryRequest, Z as resolveDocsPublishedAgentSkill, _ as DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, a as DEFAULT_A2A_AGENT_CARD_FORMAT, b as DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, c as DEFAULT_A2A_PROTOCOL_VERSION, d as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, g as DEFAULT_AGENT_SKILL_FORMAT, h as DEFAULT_AGENT_SKILL_FILE_FORMAT, i as CreateDocsStandardsResponseOptions, j as DocsApiCatalog, k as DocsAgentSkillIndexEntry, l as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, m as DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, n as API_CATALOG_MEDIA_TYPE, o as DEFAULT_A2A_AGENT_CARD_ROUTE, p as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, q as getDocsAgentManifestLinkHeader, r as API_CATALOG_PROFILE_URI, s as DEFAULT_A2A_PROTOCOL_BINDING, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, v as DEFAULT_API_CATALOG_FORMAT, w as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, x as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, y as DEFAULT_API_CATALOG_ROUTE, z as DocsStandardsDiscoveryRequest } from "./standards-discovery-C0CIC4QI.mjs";
4
+ import { $ as resolveDocsAudienceExposure, A as resolveDocsSitemapPageLastmod, B as SerializedOpenDocsProvider, C as DocsSitemapResolvedConfig, D as renderDocsSitemapMarkdown, E as readDocsSitemapManifestFromContentMap, L as PromptAction, M as toDocsSitemapMarkdownUrl, O as renderDocsSitemapXml, Q as resolveDocsAgentMdxContent, R as PromptProviderChoice, S as DocsSitemapPageInput, T as createDocsSitemapResponse, X as DocsContentAudience, Y as DocsAudienceMdxIssue, Z as findDocsAudienceMdxIssues, _ as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, a as createMcpSearchAdapter, at as createDocsAgentTraceContext, b as DocsSitemapManifest, c as formatDocsAskAIPackageHints, ct as emitDocsAnalyticsEvent, d as resolveAskAISearchRequestConfig, dt as resolveDocsAnalyticsConfig, et as resolveDocsAudienceMdxContent, f as resolveDocsSearchAudience, ft as resolveDocsObservabilityConfig, g as DEFAULT_SITEMAP_MD_ROUTE, h as DEFAULT_SITEMAP_MD_DOCS_ROUTE, i as createCustomSearchAdapter, it as ResolvedDocsObservabilityConfig, j as resolveDocsSitemapRequest, k as resolveDocsSitemapConfig, l as inferDocsAskAIPackageHints, lt as emitDocsObservabilityEvent, m as DEFAULT_SITEMAP_MANIFEST_PATH, n as buildDocsSearchDocuments, nt as DocsAgentTraceContext, o as createSimpleSearchAdapter, ot as createDocsAgentTraceId, p as resolveSearchRequestConfig, r as createAlgoliaSearchAdapter, rt as ResolvedDocsAnalyticsConfig, s as createTypesenseSearchAdapter, st as emitDocsAgentTraceEvent, t as buildDocsAskAIContext, tt as DOCS_AGENT_TRACE_EVENT_TYPES, u as performDocsSearch, ut as getDocsRequestAnalyticsProperties, v as DEFAULT_SITEMAP_XML_ROUTE, w as buildDocsSitemapManifest, x as DocsSitemapManifestPage, y as DocsSitemapFormat, z as SerializeOpenDocsProviderOptions } from "./search-CozHzW7v.mjs";
4
5
  import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
5
6
 
6
7
  //#region src/define-docs.d.ts
@@ -129,7 +130,7 @@ declare function resolveDocsLocale(searchParams: URLSearchParams, i18n?: Resolve
129
130
  declare function resolveDocsPath(pathname: string, entry: string): DocsPathMatch;
130
131
  //#endregion
131
132
  //#region src/agent-conformance.d.ts
132
- declare const DOCS_AGENT_CONTRACT_VERSION = "1.2";
133
+ declare const DOCS_AGENT_CONTRACT_VERSION = "1.3";
133
134
  type DocsAgentAdapter = "next" | "tanstack-start" | "sveltekit" | "astro" | "nuxt";
134
135
  type DocsAgentContractSurface = "discovery" | "api-catalog" | "api-catalog-head" | "agent-skills-index" | "agent-skills-index-head" | "agent-skill" | "agent-skill-head" | "config" | "diagnostics" | "feedback-schema" | "markdown" | "markdown-accept" | "markdown-locale" | "markdown-missing" | "llms" | "llms-full" | "agents" | "skill" | "sitemap-xml" | "sitemap-markdown" | "robots" | "mcp";
135
136
  interface DocsAgentContractRequest {
@@ -380,6 +381,7 @@ declare const DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE = "/.well-known/AGENT.md";
380
381
  declare const DEFAULT_AGENT_FEEDBACK_ROUTE = "/api/docs/agent/feedback";
381
382
  declare const DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA: Record<string, unknown>;
382
383
  declare const DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER = "Signature-Agent";
384
+ declare const DOCS_MARKDOWN_SECTION_INDEX_FORMAT = "docs-markdown-sections.v1";
383
385
  declare const DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN: string;
384
386
  declare const DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN: string;
385
387
  declare const DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN: string;
@@ -617,7 +619,8 @@ interface DocsAgentDiscoverySpecOptions extends DocsDiscoveryApiRouteOptions {
617
619
  openapi?: boolean | DocsOpenApiDiscoveryConfig;
618
620
  markdown?: {
619
621
  acceptHeader?: boolean;
620
- signatureAgentHeader?: boolean;
622
+ signatureAgentHeader?: boolean; /** Whether runtime Markdown routes support `?sections` metadata discovery. Defaults to true. */
623
+ sectionDiscovery?: boolean;
621
624
  };
622
625
  /** Additional validated project skills to cross-list in custom discovery. */
623
626
  publishedSkills?: readonly DocsPublishedAgentSkill[];
@@ -640,7 +643,8 @@ interface DocsSkillDocumentOptions extends DocsDiscoveryApiRouteOptions {
640
643
  openapi?: boolean | DocsOpenApiDiscoveryConfig;
641
644
  markdown?: {
642
645
  acceptHeader?: boolean;
643
- signatureAgentHeader?: boolean;
646
+ signatureAgentHeader?: boolean; /** Whether runtime Markdown routes support `?sections` metadata discovery. Defaults to true. */
647
+ sectionDiscovery?: boolean;
644
648
  };
645
649
  }
646
650
  interface DocsAgentsDocumentOptions extends DocsSkillDocumentOptions {}
@@ -676,6 +680,66 @@ interface DocsMarkdownDocumentOptions {
676
680
  origin?: string;
677
681
  sitemap?: boolean | DocsSitemapConfig;
678
682
  }
683
+ interface DocsMarkdownSection {
684
+ id: string;
685
+ heading: string;
686
+ level: number;
687
+ content: string;
688
+ startLine: number;
689
+ endLine: number;
690
+ }
691
+ interface DocsMarkdownSectionMetadata {
692
+ id: string;
693
+ heading: string;
694
+ level: number;
695
+ parentId?: string;
696
+ startLine: number;
697
+ endLine: number;
698
+ estimatedTokens: number;
699
+ utf8Bytes: number;
700
+ canonicalUrl: string;
701
+ markdownUrl: string;
702
+ }
703
+ interface DocsMarkdownSectionIndex {
704
+ schemaVersion: 1;
705
+ format: typeof DOCS_MARKDOWN_SECTION_INDEX_FORMAT;
706
+ canonicalUrl: string;
707
+ markdownUrl: string;
708
+ sectionIndexUrl: string;
709
+ lineNumbering: "body";
710
+ sectionCount: number;
711
+ estimatedTokens: number;
712
+ utf8Bytes: number;
713
+ fetchBudget?: {
714
+ tokenBudget?: number;
715
+ byteBudget?: number;
716
+ };
717
+ sections: DocsMarkdownSectionMetadata[];
718
+ }
719
+ interface DocsMarkdownSectionIndexOptions {
720
+ canonicalUrl: string;
721
+ markdownUrl: string;
722
+ sectionIndexUrl?: string;
723
+ tokenBudget?: number | null;
724
+ byteBudget?: number | null;
725
+ }
726
+ interface DocsMarkdownSectionRequest {
727
+ section?: string | null;
728
+ tokenBudget?: number | null;
729
+ byteBudget?: number | null;
730
+ }
731
+ interface DocsMarkdownSectionResult {
732
+ found: boolean;
733
+ requestedSection?: string;
734
+ section?: DocsMarkdownSection;
735
+ document: string;
736
+ truncated: boolean;
737
+ tokenBudget?: number;
738
+ byteBudget?: number;
739
+ estimatedTokens: number;
740
+ utf8Bytes: number;
741
+ availableSections: DocsMarkdownSection[];
742
+ }
679
743
  interface DocsMarkdownNotFoundOptions extends DocsDiscoveryApiRouteOptions {
680
744
  entry?: string;
681
745
  requestedPath: string;
@@ -802,6 +866,11 @@ declare function resolveDocsMarkdownRecovery({
802
866
  requestedPath,
803
867
  pages
804
868
  }: DocsMarkdownNotFoundOptions): DocsMarkdownRecoveryResult;
869
+ declare function resolveDocsMarkdownSectionRequest(url: URL): DocsMarkdownSectionRequest | null;
870
+ declare function isDocsMarkdownSectionIndexRequest(url: URL): boolean;
871
+ declare function collectDocsMarkdownSections(document: string): DocsMarkdownSection[];
872
+ declare function buildDocsMarkdownSectionIndex(document: string, options: DocsMarkdownSectionIndexOptions): DocsMarkdownSectionIndex;
873
+ declare function selectDocsMarkdownSection(document: string, request: DocsMarkdownSectionRequest): DocsMarkdownSectionResult;
805
874
  declare function renderDocsMarkdownNotFound({
806
875
  entry,
807
876
  apiRoute,
@@ -856,6 +925,7 @@ declare function buildDocsAgentDiscoverySpec({
856
925
  };
857
926
  capabilities: {
858
927
  markdownRoutes: boolean;
928
+ markdownSectionDiscovery: boolean;
859
929
  agentMdOverrides: boolean;
860
930
  agentBlocks: boolean;
861
931
  structuredAgentContracts: boolean;
@@ -910,6 +980,14 @@ declare function buildDocsAgentDiscoverySpec({
910
980
  pagePattern: string;
911
981
  rootPage: string;
912
982
  apiPattern: string;
983
+ sectionDiscovery: {
984
+ format?: string | undefined;
985
+ indexParam?: string | undefined;
986
+ sectionParam?: string | undefined;
987
+ tokenBudgetParam?: string | undefined;
988
+ byteBudgetParam?: string | undefined;
989
+ enabled: boolean;
990
+ };
913
991
  resolutionOrder: string[];
914
992
  };
915
993
  agentContract: {
@@ -1154,4 +1232,4 @@ declare function renderDocsRobotsGeneratedBlock(options?: DocsRobotsRenderOption
1154
1232
  declare function upsertDocsRobotsGeneratedBlock(existing: string, block: string): string;
1155
1233
  declare function analyzeDocsRobotsTxt(content: string, options?: DocsRobotsAnalysisOptions): DocsRobotsAnalysis;
1156
1234
  //#endregion
1157
- 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_A2A_PROTOCOL_BINDING, DEFAULT_A2A_PROTOCOL_VERSION, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_INDEX_FORMAT, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_AGENT_SKILL_FILE_FORMAT, DEFAULT_AGENT_SKILL_FORMAT, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_API_CATALOG_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_CONTRACT_VERSION, DOCS_AGENT_MANIFEST_FORMAT, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, DOCS_AGENT_MANIFEST_SCHEMA_URI, DOCS_AGENT_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 DocsA2AAgentInterface, type DocsAgentA2AApiKeySecurityScheme, type DocsAgentA2ACapabilities, type DocsAgentA2AConfig, type DocsAgentA2AExtension, type DocsAgentA2AHttpAuthSecurityScheme, type DocsAgentA2AInterfaceConfig, type DocsAgentA2AMutualTlsSecurityScheme, type DocsAgentA2AOAuth2SecurityScheme, type DocsAgentA2AOAuthAuthorizationCodeFlow, type DocsAgentA2AOAuthClientCredentialsFlow, type DocsAgentA2AOAuthDeviceCodeFlow, type DocsAgentA2AOAuthFlows, type DocsAgentA2AOAuthImplicitFlow, type DocsAgentA2AOAuthPasswordFlow, type DocsAgentA2AOpenIdConnectSecurityScheme, type DocsAgentA2AProtocolBinding, type DocsAgentA2ASecurityRequirement, type DocsAgentA2ASecurityScheme, type DocsAgentA2ASecurityScopeList, type DocsAgentA2ASkill, 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 DocsRobotsAnalysis, type DocsRobotsAnalysisOptions, 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, getDocsAgentManifestLinkHeader, 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, resolveDocsSearchAudience, 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 };
1235
+ export { AGENT_SKILLS_DISCOVERY_SCHEMA_URI, AGENT_SKILL_COMPATIBILITY_MAX_LENGTH, AGENT_SKILL_DESCRIPTION_MAX_LENGTH, AGENT_SKILL_FRONTMATTER_FIELDS, AGENT_SKILL_NAME_MAX_LENGTH, 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_A2A_PROTOCOL_BINDING, DEFAULT_A2A_PROTOCOL_VERSION, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_INDEX_FORMAT, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_AGENT_SKILL_FILE_FORMAT, DEFAULT_AGENT_SKILL_FORMAT, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_API_CATALOG_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_CONTRACT_VERSION, DOCS_AGENT_MANIFEST_FORMAT, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, DOCS_AGENT_MANIFEST_SCHEMA_URI, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SECTION_INDEX_FORMAT, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, type DocsA2AAgentCard, type DocsA2AAgentCardOptions, type DocsA2AAgentInterface, type DocsAgentA2AApiKeySecurityScheme, type DocsAgentA2ACapabilities, type DocsAgentA2AConfig, type DocsAgentA2AExtension, type DocsAgentA2AHttpAuthSecurityScheme, type DocsAgentA2AInterfaceConfig, type DocsAgentA2AMutualTlsSecurityScheme, type DocsAgentA2AOAuth2SecurityScheme, type DocsAgentA2AOAuthAuthorizationCodeFlow, type DocsAgentA2AOAuthClientCredentialsFlow, type DocsAgentA2AOAuthDeviceCodeFlow, type DocsAgentA2AOAuthFlows, type DocsAgentA2AOAuthImplicitFlow, type DocsAgentA2AOAuthPasswordFlow, type DocsAgentA2AOpenIdConnectSecurityScheme, type DocsAgentA2AProtocolBinding, type DocsAgentA2ASecurityRequirement, type DocsAgentA2ASecurityScheme, type DocsAgentA2ASecurityScopeList, type DocsAgentA2ASkill, 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 DocsAgentSkillFrontmatter, DocsAgentSkillFrontmatterError, type DocsAgentSkillFrontmatterField, type DocsAgentSkillFrontmatterIssue, type DocsAgentSkillFrontmatterValidation, type DocsAgentSkillFrontmatterValidationOptions, 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 DocsMarkdownSection, type DocsMarkdownSectionIndex, type DocsMarkdownSectionIndexOptions, type DocsMarkdownSectionMetadata, type DocsMarkdownSectionRequest, type DocsMarkdownSectionResult, 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 DocsRobotsAnalysis, type DocsRobotsAnalysisOptions, 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, buildDocsMarkdownSectionIndex, buildDocsMcpEndpointCandidates, buildDocsMcpProtectedResourceMetadataRoute, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, collectDocsMarkdownSections, 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, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsMcpProtectedResourceMetadataRoutes, getDocsMcpResourcePaths, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasDocsMcpProtectedResourceConfig, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentSkillName, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMarkdownSectionIndexRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseDocsAgentSkillFrontmatter, 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, resolveDocsMarkdownSectionRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSearchAudience, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsStandardsDiscoveryRequest, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, selectDocsMarkdownSection, serializeGeneratedAgentDocument, sha256DocsDiscoveryContent, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload, validateDocsAgentSkillFrontmatter };
package/dist/index.mjs CHANGED
@@ -1,10 +1,11 @@
1
- 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-O8mYgLvH.mjs";
1
+ import { a as resolveReadingTimeOptions, c as runDocsAgentConformance, f as createTheme, g as defineDocs, h as resolveChangelogConfig, i as resolveReadingTimeFromSource, m as deepMerge, n as resolvePageReadingTime, o as DOCS_AGENT_CONTRACT_VERSION, p as extendTheme, r as resolveReadingTimeFromContent, s as createDocsAgentContractCases, t as estimateReadingTimeMinutes } from "./reading-time-DtNegNiq.mjs";
2
2
  import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig, i as emitDocsAgentTraceEvent, l as resolveDocsObservabilityConfig, n as createDocsAgentTraceContext, o as emitDocsObservabilityEvent, r as createDocsAgentTraceId, s as getDocsRequestAnalyticsProperties, t as DOCS_AGENT_TRACE_EVENT_TYPES } from "./analytics-Bx44lg6d.mjs";
3
- import { $ as 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-D2SsSct2.mjs";
4
- import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, D as buildDocsAgentSkillsIndex, E as buildDocsA2AAgentCard, F as resolveDocsDiscoveryApiRoute, I as resolveDocsPublishedAgentSkill, L as resolveDocsStandardsDiscoveryRequest, M as getDocsAgentManifestLinkHeader, N as getDocsDiscoveryLinkHeader, O as buildDocsApiCatalog, P as isDocsStandardsDiscoveryRequest, R as sha256DocsDiscoveryContent, S as DOCS_AGENT_MANIFEST_FORMAT, T as appendDocsDiscoveryLinkHeader, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, g as DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, h as DEFAULT_AGENT_SKILL_FORMAT, i as DEFAULT_A2A_AGENT_CARD_FORMAT, j as createDocsStandardsResponse, k as buildDocsLegacySkillsIndex, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, m as DEFAULT_AGENT_SKILL_FILE_FORMAT, n as API_CATALOG_MEDIA_TYPE, o as DEFAULT_A2A_PROTOCOL_BINDING, p as DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, r as API_CATALOG_PROFILE_URI, s as DEFAULT_A2A_PROTOCOL_VERSION, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, y as DEFAULT_LEGACY_SKILLS_INDEX_FORMAT } from "./standards-discovery-DSVKdQrl.mjs";
5
- import { A as emitDocsTelemetryProjectEvent, C as applySidebarFolderIndexBehavior, D as emitDocsTelemetryAgentSurfaceEvent, E as resolveSidebarFolderIndexBehaviorForPath, F as resolveDocsTelemetryConfig, M as inferDocsTelemetryAgentSurface, N as isLocalDocsTelemetryOrigin, O as emitDocsTelemetryEvent, P as normalizeDocsTelemetryOrigin, S as stripGeneratedAgentProvenance, T as resolveSidebarFolderIndexBehavior, _ as GENERATED_AGENT_PROVENANCE_VERSION, a as createMcpSearchAdapter, b as parseGeneratedAgentDocument, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveDocsSearchAudience, g as GENERATED_AGENT_PROVENANCE_MARKER, i as createCustomSearchAdapter, j as getDocsTelemetryFeatures, k as emitDocsTelemetryMcpToolEvent, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as resolveSearchRequestConfig, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as hashGeneratedAgentContent, w as resolvePageSidebarFolderIndexBehavior, x as serializeGeneratedAgentDocument, y as normalizeGeneratedAgentContent } from "./search-DBlw9h3P.mjs";
3
+ import { $ as matchesDocsLlmsTxtSection, $t as PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, A as buildDocsAgentDiscoverySpec, At as resolveDocsAudienceMdxContent, B as findDocsMarkdownPage, Bt as renderDocsSitemapXml, C as DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, Ct as selectDocsMarkdownSection, D as DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, E as DOCS_MARKDOWN_SECTION_INDEX_FORMAT, Et as findDocsAudienceMdxIssues, F as buildDocsMcpEndpointCandidates, Ft as DEFAULT_SITEMAP_XML_ROUTE, G as isDocsAgentDiscoveryRequest, H as getDocsMarkdownCanonicalLinkHeader, Ht as resolveDocsSitemapPageLastmod, I as collectDocsMarkdownSections, It as buildDocsSitemapManifest, J as isDocsDiagnosticsRequest, Jt as renderDocsRelatedMarkdownLines, K as isDocsAgentsRequest, L as createDocsMarkdownResponse, Lt as createDocsSitemapResponse, M as buildDocsConfigMap, Mt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, N as buildDocsDiagnostics, Nt as DEFAULT_SITEMAP_MD_ROUTE, O as DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, Ot as resolveDocsAgentMdxContent, P as buildDocsMarkdownSectionIndex, Pt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Q as isDocsSkillRequest, Qt as PAGE_AGENT_CONTRACT_START_MARKER, R as createDocsStandardsDiscoveryResponse, Rt as readDocsSitemapManifestFromContentMap, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, St as selectDocsLlmsTxtContent, Tt as validateDocsAgentFeedbackPayload, U as getDocsMarkdownVaryHeader, Ut as resolveDocsSitemapRequest, V as getDocsLlmsTxtMaxCharsIssue, Vt as resolveDocsSitemapConfig, W as hasDocsMarkdownSignatureAgent, Wt as toDocsSitemapMarkdownUrl, X as isDocsMarkdownSectionIndexRequest, Xt as PAGE_AGENT_CONTRACT_FIELDS, Y as isDocsLlmsTxtPublicRequest, Yt as PAGE_AGENT_CONTRACT_END_MARKER, Z as isDocsPublicGetRequest, Zt as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, _ as DEFAULT_LLMS_TXT_MAX_CHARS, _n as isDocsMcpRequest, _t as resolveDocsMarkdownRequest, a as DEFAULT_AGENT_MD_ROUTE, an as stripGeneratedPageAgentContractMarkdown, at as renderDocsMarkdownDocument, b as DEFAULT_OPENAPI_SCHEMA_ROUTE, bt as resolveDocsRequestApiRoute, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, cn as DEFAULT_MCP_PUBLIC_ROUTE, ct as resolveDocsAgentContractMcpTools, d as DEFAULT_DOCS_CONFIG_FORMAT, dn as buildDocsMcpProtectedResourceMetadataRoute, dt as resolveDocsAgentsFormat, en as getPageAgentFrontmatterIssues, et as normalizeDocsPathSegment, f as DEFAULT_DOCS_CONFIG_ROUTE, fn as getDocsMcpProtectedResourceMetadataRoutes, ft as resolveDocsLlmsTxtFormat, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, gt as resolveDocsMarkdownRecovery, h as DEFAULT_LLMS_FULL_TXT_ROUTE, ht as resolveDocsMarkdownCanonicalUrl, i as DEFAULT_AGENT_FEEDBACK_ROUTE, in as renderPageAgentFrontmatterYamlLines, it as renderDocsLlmsTxt, j as buildDocsAgentFeedbackSchema, jt as DEFAULT_SITEMAP_MANIFEST_PATH, k as acceptsDocsMarkdown, kt as resolveDocsAudienceExposure, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, ln as DEFAULT_MCP_ROUTE, lt as resolveDocsAgentFeedbackConfig, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, mn as hasDocsMcpProtectedResourceConfig, mt as resolveDocsLlmsTxtSections, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as normalizePageAgentFrontmatter, nt as parseDocsAgentFeedbackData, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, on as upsertPageAgentContractMarkdown, ot as renderDocsMarkdownNotFound, p as DEFAULT_DOCS_DIAGNOSTICS_FORMAT, pn as getDocsMcpResourcePaths, pt as resolveDocsLlmsTxtRequest, q as isDocsConfigRequest, qt as normalizeDocsRelated, r as DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, rn as renderPageAgentContractMarkdown, rt as renderDocsAgentsDocument, s as DEFAULT_AGENT_SPEC_ROUTE, sn as DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, tn as hasStructuredPageAgentContract, tt as normalizeDocsUrlPath, u as DEFAULT_DOCS_API_ROUTE, un as DEFAULT_MCP_WELL_KNOWN_ROUTE, ut as resolveDocsAgentFeedbackRequest, v as DEFAULT_LLMS_TXT_ROUTE, vt as resolveDocsMarkdownSectionRequest, w as DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, xt as resolveDocsSkillFormat, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, yt as resolveDocsOpenApiDiscoveryConfig, z as detectDocsMarkdownAgentRequest, zt as renderDocsSitemapMarkdown } from "./agent-FIyl4-Oa.mjs";
4
+ import { AGENT_SKILL_COMPATIBILITY_MAX_LENGTH, AGENT_SKILL_DESCRIPTION_MAX_LENGTH, AGENT_SKILL_FRONTMATTER_FIELDS, AGENT_SKILL_NAME_MAX_LENGTH, DocsAgentSkillFrontmatterError, isDocsAgentSkillName, parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
5
+ import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, D as buildDocsAgentSkillsIndex, E as buildDocsA2AAgentCard, F as resolveDocsDiscoveryApiRoute, I as resolveDocsPublishedAgentSkill, L as resolveDocsStandardsDiscoveryRequest, M as getDocsAgentManifestLinkHeader, N as getDocsDiscoveryLinkHeader, O as buildDocsApiCatalog, P as isDocsStandardsDiscoveryRequest, R as sha256DocsDiscoveryContent, S as DOCS_AGENT_MANIFEST_FORMAT, T as appendDocsDiscoveryLinkHeader, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, g as DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, h as DEFAULT_AGENT_SKILL_FORMAT, i as DEFAULT_A2A_AGENT_CARD_FORMAT, j as createDocsStandardsResponse, k as buildDocsLegacySkillsIndex, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, m as DEFAULT_AGENT_SKILL_FILE_FORMAT, n as API_CATALOG_MEDIA_TYPE, o as DEFAULT_A2A_PROTOCOL_BINDING, p as DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, r as API_CATALOG_PROFILE_URI, s as DEFAULT_A2A_PROTOCOL_VERSION, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, y as DEFAULT_LEGACY_SKILLS_INDEX_FORMAT } from "./standards-discovery-CYfiQE13.mjs";
6
+ import { A as inferDocsTelemetryAgentSurface, C as resolveSidebarFolderIndexBehavior, D as emitDocsTelemetryMcpToolEvent, E as emitDocsTelemetryEvent, M as normalizeDocsTelemetryOrigin, N as resolveDocsTelemetryConfig, O as emitDocsTelemetryProjectEvent, S as resolvePageSidebarFolderIndexBehavior, T as emitDocsTelemetryAgentSurfaceEvent, _ as normalizeGeneratedAgentContent, a as createMcpSearchAdapter, b as stripGeneratedAgentProvenance, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveDocsSearchAudience, g as hashGeneratedAgentContent, h as GENERATED_AGENT_PROVENANCE_VERSION, i as createCustomSearchAdapter, j as isLocalDocsTelemetryOrigin, k as getDocsTelemetryFeatures, l as inferDocsAskAIPackageHints, m as GENERATED_AGENT_PROVENANCE_MARKER, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as resolveSearchRequestConfig, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as parseGeneratedAgentDocument, w as resolveSidebarFolderIndexBehaviorForPath, x as applySidebarFolderIndexBehavior, y as serializeGeneratedAgentDocument } from "./search-x5O0-9X3.mjs";
6
7
  import { n as resolveDocsLocale, r as resolveDocsPath, t as resolveDocsI18n } from "./i18n-CCaFUnAN.mjs";
7
- 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-Dz5XeT8F.mjs";
8
- import { a as resolveDocsMetadataBaseUrl, i as renderDocsPageStructuredDataJson, n as buildPageOpenGraph, o as resolveOGImage, r as buildPageTwitter, s as resolveTitle, t as buildDocsPageStructuredData } from "./metadata-CNjcFhQN.mjs";
8
+ 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-DOqBwQw8.mjs";
9
+ import { a as resolveDocsMetadataBaseUrl, i as renderDocsPageStructuredDataJson, n as buildPageOpenGraph, o as resolveOGImage, r as buildPageTwitter, s as resolveTitle, t as buildDocsPageStructuredData } from "./metadata-bw8k-9x-.mjs";
9
10
 
10
- 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_A2A_PROTOCOL_BINDING, DEFAULT_A2A_PROTOCOL_VERSION, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_INDEX_FORMAT, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_AGENT_SKILL_FILE_FORMAT, DEFAULT_AGENT_SKILL_FORMAT, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_API_CATALOG_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_CONTRACT_VERSION, DOCS_AGENT_MANIFEST_FORMAT, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, DOCS_AGENT_MANIFEST_SCHEMA_URI, DOCS_AGENT_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, getDocsAgentManifestLinkHeader, 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, resolveDocsSearchAudience, 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 };
11
+ export { AGENT_SKILLS_DISCOVERY_SCHEMA_URI, AGENT_SKILL_COMPATIBILITY_MAX_LENGTH, AGENT_SKILL_DESCRIPTION_MAX_LENGTH, AGENT_SKILL_FRONTMATTER_FIELDS, AGENT_SKILL_NAME_MAX_LENGTH, API_CATALOG_MEDIA_TYPE, API_CATALOG_PROFILE_URI, DEFAULT_A2A_AGENT_CARD_FORMAT, DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_A2A_PROTOCOL_BINDING, DEFAULT_A2A_PROTOCOL_VERSION, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_INDEX_FORMAT, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_AGENT_SKILL_FILE_FORMAT, DEFAULT_AGENT_SKILL_FORMAT, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_API_CATALOG_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_CONTRACT_VERSION, DOCS_AGENT_MANIFEST_FORMAT, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, DOCS_AGENT_MANIFEST_SCHEMA_URI, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SECTION_INDEX_FORMAT, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, DocsAgentSkillFrontmatterError, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, acceptsDocsMarkdown, analyzeDocsRobotsTxt, appendDocsDiscoveryLinkHeader, applySidebarFolderIndexBehavior, buildDocsA2AAgentCard, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAgentSkillsIndex, buildDocsApiCatalog, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsLegacySkillsIndex, buildDocsMarkdownSectionIndex, buildDocsMcpEndpointCandidates, buildDocsMcpProtectedResourceMetadataRoute, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, collectDocsMarkdownSections, 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, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsMcpProtectedResourceMetadataRoutes, getDocsMcpResourcePaths, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasDocsMcpProtectedResourceConfig, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentSkillName, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMarkdownSectionIndexRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseDocsAgentSkillFrontmatter, 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, resolveDocsMarkdownSectionRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSearchAudience, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsStandardsDiscoveryRequest, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, selectDocsMarkdownSection, serializeGeneratedAgentDocument, sha256DocsDiscoveryContent, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload, validateDocsAgentSkillFrontmatter };
@@ -1,11 +1,11 @@
1
- import "./agent-D2SsSct2.mjs";
2
- import { I as resolveDocsPublishedAgentSkill } from "./standards-discovery-DSVKdQrl.mjs";
3
- import "./search-DBlw9h3P.mjs";
4
- import "./sitemap-server-DQp8qUKN.mjs";
5
- import "./agent-evals-DZR4J7Iz.mjs";
1
+ import "./agent-FIyl4-Oa.mjs";
2
+ import { I as resolveDocsPublishedAgentSkill } from "./standards-discovery-CYfiQE13.mjs";
3
+ import "./search-x5O0-9X3.mjs";
4
+ import "./sitemap-server-D_hayOp6.mjs";
5
+ import "./agent-evals-Cr9TAkmB.mjs";
6
6
  import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
7
7
  import "./code-blocks-DnNVNK2M.mjs";
8
- import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-iBfCLPOt.mjs";
8
+ import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B4u3qy-1.mjs";
9
9
  import "./server.mjs";
10
10
  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";
11
11
  import { existsSync, readFileSync } from "node:fs";
package/dist/mcp.d.mts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { Bn as OrderingItem, Ft as DocsMcpAuthenticate, Gn as PageAgentFrontmatter, Kt as DocsObservabilityConfig, Nt as DocsMcpAllowedOrigins, Pt as DocsMcpAuthPrincipal, Rt as DocsMcpConfig, Sn as DocsTelemetryFramework, _n as DocsTelemetryConfig, cn as DocsSearchConfig, mn as DocsSearchSourcePage, rt as DocsAnalyticsConfig } from "./types-BQC05SQm.mjs";
2
- import { I as DocsPublishedAgentSkill } from "./standards-discovery-CQjJ-M2y.mjs";
2
+ import { I as DocsPublishedAgentSkill } from "./standards-discovery-C0CIC4QI.mjs";
3
3
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
4
4
 
5
5
  //#region src/mcp.d.ts
package/dist/mcp.mjs CHANGED
@@ -1,7 +1,7 @@
1
1
  import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
2
- import { Bt as renderDocsRelatedMarkdownLines, Jt as normalizePageAgentFrontmatter, Qt as upsertPageAgentContractMarkdown, cn as isDocsMcpProtectedResourceMetadataPath, dn as normalizeDocsMcpAuthorizationServerUrls, fn as normalizeDocsMcpEndpointPath, mn as resolveDocsMcpResourceLocation, pn as resolveDocsMcpProtectedResourceMetadataLocation, qt as hasStructuredPageAgentContract, sn as isDocsMcpOAuthScopeToken, un as isDocsMcpResourcePath, wt as resolveDocsAudienceMdxContent, zt as normalizeDocsRelated } from "./agent-D2SsSct2.mjs";
3
- import "./standards-discovery-DSVKdQrl.mjs";
4
- import { A as emitDocsTelemetryProjectEvent, D as emitDocsTelemetryAgentSurfaceEvent, S as stripGeneratedAgentProvenance, h as parseDocsMarkdownSections, k as emitDocsTelemetryMcpToolEvent, m as findDocsMarkdownSection, u as performDocsSearch, w as resolvePageSidebarFolderIndexBehavior } from "./search-DBlw9h3P.mjs";
2
+ import { At as resolveDocsAudienceMdxContent, Gt as findDocsMarkdownSection, Jt as renderDocsRelatedMarkdownLines, Kt as parseDocsMarkdownSections, Sn as resolveDocsMcpResourceLocation, bn as normalizeDocsMcpEndpointPath, gn as isDocsMcpProtectedResourceMetadataPath, hn as isDocsMcpOAuthScopeToken, nn as normalizePageAgentFrontmatter, on as upsertPageAgentContractMarkdown, qt as normalizeDocsRelated, tn as hasStructuredPageAgentContract, vn as isDocsMcpResourcePath, xn as resolveDocsMcpProtectedResourceMetadataLocation, yn as normalizeDocsMcpAuthorizationServerUrls } from "./agent-FIyl4-Oa.mjs";
3
+ import "./standards-discovery-CYfiQE13.mjs";
4
+ import { D as emitDocsTelemetryMcpToolEvent, O as emitDocsTelemetryProjectEvent, S as resolvePageSidebarFolderIndexBehavior, T as emitDocsTelemetryAgentSurfaceEvent, b as stripGeneratedAgentProvenance, u as performDocsSearch } from "./search-x5O0-9X3.mjs";
5
5
  import { a as normalizeAgentScopeValues, i as normalizeAgentLocale, n as agentVersionConstraintsOverlap, r as normalizeAgentFramework, t as agentVersionConstraintMatches } from "./agent-scope-C_U--OZ7.mjs";
6
6
  import matter from "gray-matter";
7
7
  import fs from "node:fs";
@@ -1,4 +1,4 @@
1
- import { Jt as normalizePageAgentFrontmatter, qt as hasStructuredPageAgentContract } from "./agent-D2SsSct2.mjs";
1
+ import { nn as normalizePageAgentFrontmatter, tn as hasStructuredPageAgentContract } from "./agent-FIyl4-Oa.mjs";
2
2
 
3
3
  //#region src/metadata.ts
4
4
  /**