@farming-labs/docs 0.2.66 → 0.2.67

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.
@@ -2,7 +2,7 @@ import { $ as renderDocsAgentsDocument, At as buildDocsSitemapManifest, Ft as re
2
2
  import { C as buildDocsA2AAgentCard, E as buildDocsLegacySkillsIndex, M as resolveDocsPublishedAgentSkill, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, w as buildDocsAgentSkillsIndex, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-C7p5lBhc.mjs";
3
3
  import "./search-D0A9lRGJ.mjs";
4
4
  import { t as resolveDocsI18n } from "./i18n-CCaFUnAN.mjs";
5
- import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-vU80KRFy.mjs";
5
+ import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DonzDfBW.mjs";
6
6
  import "./sitemap-server-atbbiVzW.mjs";
7
7
  import "./agent-evals-Bn_dA1_A.mjs";
8
8
  import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
@@ -150,7 +150,7 @@ async function main() {
150
150
  }
151
151
  await compactAgentDocs(agentCompactOptions);
152
152
  } else if (parsedCommand.command === "agent" && subcommand === "export") {
153
- const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-CyhCaE8J.mjs");
153
+ const { exportAgentBundle, parseAgentExportArgs, printAgentExportHelp } = await import("../agent-export-COoZT--d.mjs");
154
154
  const agentExportOptions = parseAgentExportArgs(args.slice(2));
155
155
  if (agentExportOptions.help) {
156
156
  printAgentExportHelp();
@@ -161,7 +161,7 @@ async function main() {
161
161
  console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
162
162
  console.error();
163
163
  const { printAgentCompactHelp } = await import("../agent-B81ztzxZ.mjs").then((n) => n.t);
164
- const { printAgentExportHelp } = await import("../agent-export-CyhCaE8J.mjs");
164
+ const { printAgentExportHelp } = await import("../agent-export-COoZT--d.mjs");
165
165
  printAgentCompactHelp();
166
166
  printAgentExportHelp();
167
167
  process.exit(1);
@@ -180,7 +180,7 @@ async function main() {
180
180
  printAgentsGenerateHelp();
181
181
  process.exit(1);
182
182
  } else if (parsedCommand.command === "doctor") {
183
- const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-BJt0ZFkJ.mjs");
183
+ const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-C3NA15Kd.mjs");
184
184
  const doctorOptions = parseDoctorArgs(args.slice(1));
185
185
  if (doctorOptions.help) {
186
186
  printDoctorHelp();
@@ -232,7 +232,7 @@ async function main() {
232
232
  printSitemapGenerateHelp();
233
233
  process.exit(1);
234
234
  } else if (parsedCommand.command === "robots" && subcommand === "generate") {
235
- const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-NL_OsxEC.mjs");
235
+ const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-rzriLh_d.mjs");
236
236
  const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
237
237
  if (robotsOptions.help) {
238
238
  printRobotsGenerateHelp();
@@ -242,7 +242,7 @@ async function main() {
242
242
  } else if (parsedCommand.command === "robots") {
243
243
  console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
244
244
  console.error();
245
- const { printRobotsGenerateHelp } = await import("../robots-NL_OsxEC.mjs");
245
+ const { printRobotsGenerateHelp } = await import("../robots-rzriLh_d.mjs");
246
246
  printRobotsGenerateHelp();
247
247
  process.exit(1);
248
248
  } else if (parsedCommand.command === "downgrade") {
@@ -1,9 +1,9 @@
1
1
  import { i as scanDocsPageTargets, n as compactAgentDocs, r as inspectAgentCompactionState } from "./agent-B81ztzxZ.mjs";
2
- import { l as httpLinkHeaderHasTargetRelation } from "./reading-time-oAnc4Brq.mjs";
2
+ import { l as httpLinkHeaderHasTargetRelation } from "./reading-time-DsyUuHR4.mjs";
3
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-CcR8_Yyd.mjs";
4
4
  import { _ 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, j as resolveDocsDiscoveryApiRoute, 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-C7p5lBhc.mjs";
5
5
  import { d as resolveAskAISearchRequestConfig } from "./search-D0A9lRGJ.mjs";
6
- import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-vU80KRFy.mjs";
6
+ import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-DonzDfBW.mjs";
7
7
  import { a as resolveDocsMetadataBaseUrl } from "./metadata-Cna0CtWZ.mjs";
8
8
  import "./sitemap-server-atbbiVzW.mjs";
9
9
  import { t as runDocsGoldenTasks } from "./agent-evals-Bn_dA1_A.mjs";
@@ -308,6 +308,16 @@ function resolveStaticExport(config, content) {
308
308
  if (typeof config?.staticExport === "boolean") return config.staticExport;
309
309
  return readTopLevelBooleanProperty(content, "staticExport") ?? false;
310
310
  }
311
+ function resolveApiCatalogEnabled(config, content, staticExport) {
312
+ if (staticExport) return false;
313
+ if (config?.llmsTxt && typeof config.llmsTxt === "object") return config.llmsTxt.apiCatalog !== false;
314
+ const llmsBlock = extractNestedObjectLiteral(content, ["llmsTxt"]);
315
+ return llmsBlock ? readObjectBooleanProperty(llmsBlock, "apiCatalog") !== false : true;
316
+ }
317
+ function resolveAgentCardEnabled(config, content) {
318
+ if (config) return Boolean(config.agent?.a2a);
319
+ return Boolean(extractNestedObjectLiteral(content, ["agent", "a2a"]));
320
+ }
311
321
  function resolveAgentFeedbackEnabled(config, content) {
312
322
  const feedback = config?.feedback;
313
323
  if (feedback === false) return false;
@@ -1419,6 +1429,13 @@ function hostedCapability(discoveryBody, key) {
1419
1429
  const enabled = asRecord(root?.[key])?.enabled;
1420
1430
  return typeof enabled === "boolean" ? enabled : void 0;
1421
1431
  }
1432
+ function hostedRobotsAnalysisOptions(discoveryBody) {
1433
+ const api = asRecord(asRecord(discoveryBody)?.api);
1434
+ return {
1435
+ apiCatalog: hostedCapability(discoveryBody, "apiCatalog") !== false,
1436
+ agentCard: Boolean(readDiscoveryRoute(api?.agentCard))
1437
+ };
1438
+ }
1422
1439
  function hostedRootDocsRoute(discoveryBody) {
1423
1440
  const site = asRecord(asRecord(discoveryBody)?.site);
1424
1441
  return `/${(typeof site?.entry === "string" && site.entry.trim() ? site.entry.trim() : "docs").replace(/^\/+|\/+$/g, "") || "docs"}`;
@@ -1526,7 +1543,10 @@ async function buildHostedAgentChecks(url, pages) {
1526
1543
  const robotsRoute = hostedRobotsRoute(discovery.body);
1527
1544
  if (robotsRoute.enabled) {
1528
1545
  const robots = await probeRobotsRoute(baseUrl, robotsRoute.route);
1529
- const robotsAnalysis = robots.body ? analyzeDocsRobotsTxt(robots.body) : void 0;
1546
+ const robotsAnalysis = robots.body ? analyzeDocsRobotsTxt(robots.body, {
1547
+ ...hostedRobotsAnalysisOptions(discovery.body),
1548
+ sitemapRoutes: sitemapRoutes.enabled ? sitemapRoutes.routes : []
1549
+ }) : void 0;
1530
1550
  const robotsBlocked = robotsAnalysis?.blocksAgentRoutes || robotsAnalysis?.blocksAiAgents;
1531
1551
  const robotsComplete = robotsAnalysis?.hasAgentRoutes && robotsAnalysis?.hasAiPolicy;
1532
1552
  checks.push(makeCheck("hosted-robots", "Hosted robots.txt", robots.ok && !robotsBlocked && robotsComplete ? "pass" : robots.ok && !robotsBlocked ? "warn" : "fail", robots.ok && !robotsBlocked && robotsComplete ? 5 : robots.ok && !robotsBlocked ? 3 : 0, 5, robots.ok ? robotsBlocked ? `${robotsRoute.route} is reachable but blocks ${robotsAnalysis?.blocksAiAgents ? "common AI crawlers" : "agent-readable docs routes"}.` : robotsComplete ? `${robots.detail} It advertises agent-readable routes and common AI crawler policy.` : `${robots.detail} It is missing ${robotsAnalysis?.missingRoutes.length ? `agent routes (${robotsAnalysis.missingRoutes.join(", ")})` : "common AI crawler policy"}.` : robots.detail, robots.ok && !robotsBlocked && robotsComplete ? void 0 : "Publish an agent-friendly robots.txt with `docs robots generate`, or append the generated block to the existing file."));
@@ -1623,6 +1643,8 @@ async function inspectAgentReadiness(options = {}) {
1623
1643
  const ordering = config?.ordering === "alphabetical" || config?.ordering === "numeric" || Array.isArray(config?.ordering) ? config.ordering : void 0;
1624
1644
  const siteTitle = typeof config?.nav?.title === "string" ? config.nav.title : readNavTitle(configContent) ?? "Documentation";
1625
1645
  const staticExport = resolveStaticExport(config, configContent);
1646
+ const apiCatalogEnabled = resolveApiCatalogEnabled(config, configContent, staticExport);
1647
+ const agentCardEnabled = resolveAgentCardEnabled(config, configContent);
1626
1648
  const llmsEnabled = resolveFeatureEnabled(config, configContent, "llmsTxt");
1627
1649
  const searchEnabled = resolveFeatureEnabled(config, configContent, "search");
1628
1650
  const mcpEnabled = resolveFeatureEnabled(config, configContent, "mcp");
@@ -1762,6 +1784,8 @@ async function inspectAgentReadiness(options = {}) {
1762
1784
  else {
1763
1785
  const analysis = analyzeDocsRobotsTxt(readFileSync(robotsPath, "utf-8"), {
1764
1786
  entry,
1787
+ apiCatalog: apiCatalogEnabled,
1788
+ agentCard: agentCardEnabled,
1765
1789
  sitemap: sitemapConfig,
1766
1790
  baseUrl: robotsConfig.baseUrl,
1767
1791
  robots: robotsConfig
package/dist/index.d.mts CHANGED
@@ -1130,6 +1130,10 @@ interface DocsRobotsAnalysis {
1130
1130
  hasAiPolicy: boolean;
1131
1131
  missingRoutes: string[];
1132
1132
  }
1133
+ interface DocsRobotsAnalysisOptions extends DocsRobotsRenderOptions {
1134
+ /** Exact sitemap routes advertised by a fetched discovery manifest. */
1135
+ sitemapRoutes?: readonly string[];
1136
+ }
1133
1137
  interface CreateDocsRobotsResponseOptions extends DocsRobotsRenderOptions {
1134
1138
  request: Request;
1135
1139
  }
@@ -1145,6 +1149,6 @@ declare function createDocsRobotsResponse({
1145
1149
  }: CreateDocsRobotsResponseOptions): Response | null;
1146
1150
  declare function renderDocsRobotsGeneratedBlock(options?: DocsRobotsRenderOptions): string;
1147
1151
  declare function upsertDocsRobotsGeneratedBlock(existing: string, block: string): string;
1148
- declare function analyzeDocsRobotsTxt(content: string, options?: DocsRobotsRenderOptions): DocsRobotsAnalysis;
1152
+ declare function analyzeDocsRobotsTxt(content: string, options?: DocsRobotsAnalysisOptions): DocsRobotsAnalysis;
1149
1153
  //#endregion
1150
- 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_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 DocsRobotsConfig, type DocsRobotsRenderOptions, type DocsRobotsResolvedConfig, type DocsRobotsRule, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSitemapConfig, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type DocsSkillDocumentOptions, type DocsStandardsDiscoveryRequest, type DocsStandardsDiscoveryResponseOptions, type DocsStandardsDiscoveryRouteOptions, type DocsStructuredDataBreadcrumb, type DocsTelemetryAgentSurface, type DocsTelemetryAgentSurfaceContext, type DocsTelemetryAgentSurfaceRequestOptions, type DocsTelemetryConfig, type DocsTelemetryContext, type DocsTelemetryEvent, type DocsTelemetryEventInput, type DocsTelemetryEventType, type DocsTelemetryFeatures, type DocsTelemetryFramework, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type LlmsTxtMaxCharsConfig, type LlmsTxtMaxCharsMode, type LlmsTxtSectionConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenDocsProviderConfig, type OpenDocsProviderId, type OpenDocsTarget, type OpenGraphImage, type OrderingItem, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, type PageActionsConfig, type PageAgentAppliesTo, type PageAgentCommand, type PageAgentFailureMode, type PageAgentFrontmatter, type PageAgentFrontmatterIssue, type PageAgentVerification, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type PromptAction, type PromptProviderChoice, type ReadingTimeConfig, type ReadingTimeFormat, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsObservabilityConfig, type ResolvedDocsRelatedLink, type ResolvedDocsTelemetryConfig, type RunDocsAgentConformanceOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, acceptsDocsMarkdown, analyzeDocsRobotsTxt, appendDocsDiscoveryLinkHeader, applySidebarFolderIndexBehavior, buildDocsA2AAgentCard, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAgentSkillsIndex, buildDocsApiCatalog, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsLegacySkillsIndex, buildDocsMcpEndpointCandidates, buildDocsMcpProtectedResourceMetadataRoute, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, createDocsStandardsResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsAudienceMdxIssues, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsMcpProtectedResourceMetadataRoutes, getDocsMcpResourcePaths, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasDocsMcpProtectedResourceConfig, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, renderPageAgentContractMarkdown, renderPageAgentFrontmatterYamlLines, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsAudienceExposure, resolveDocsAudienceMdxContent, resolveDocsDiscoveryApiRoute, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRecovery, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRobotsConfig, resolveDocsRobotsRequest, 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 };
1154
+ 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_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, 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 };
package/dist/index.mjs CHANGED
@@ -1,10 +1,10 @@
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-oAnc4Brq.mjs";
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-DsyUuHR4.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
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-CcR8_Yyd.mjs";
4
4
  import { A as isDocsStandardsDiscoveryRequest, C as buildDocsA2AAgentCard, E as buildDocsLegacySkillsIndex, M as resolveDocsPublishedAgentSkill, N as resolveDocsStandardsDiscoveryRequest, O as createDocsStandardsResponse, P as sha256DocsDiscoveryContent, S as appendDocsDiscoveryLinkHeader, T as buildDocsApiCatalog, _ 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 resolveDocsDiscoveryApiRoute, k as getDocsDiscoveryLinkHeader, 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 buildDocsAgentSkillsIndex, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, y as DEFAULT_LEGACY_SKILLS_INDEX_FORMAT } from "./standards-discovery-C7p5lBhc.mjs";
5
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-D0A9lRGJ.mjs";
6
6
  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-vU80KRFy.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-DonzDfBW.mjs";
8
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-Cna0CtWZ.mjs";
9
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_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, acceptsDocsMarkdown, analyzeDocsRobotsTxt, appendDocsDiscoveryLinkHeader, applySidebarFolderIndexBehavior, buildDocsA2AAgentCard, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAgentSkillsIndex, buildDocsApiCatalog, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsLegacySkillsIndex, buildDocsMcpEndpointCandidates, buildDocsMcpProtectedResourceMetadataRoute, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, createDocsStandardsResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsAudienceMdxIssues, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsMcpProtectedResourceMetadataRoutes, getDocsMcpResourcePaths, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasDocsMcpProtectedResourceConfig, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, renderPageAgentContractMarkdown, renderPageAgentFrontmatterYamlLines, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsAudienceExposure, resolveDocsAudienceMdxContent, resolveDocsDiscoveryApiRoute, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRecovery, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRobotsConfig, resolveDocsRobotsRequest, 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 };
@@ -1,6 +1,6 @@
1
1
  import { Dt as DEFAULT_SITEMAP_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, kt as DEFAULT_SITEMAP_XML_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-CcR8_Yyd.mjs";
2
2
  import { f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-C7p5lBhc.mjs";
3
- import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-vU80KRFy.mjs";
3
+ import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-DonzDfBW.mjs";
4
4
  import matter from "gray-matter";
5
5
 
6
6
  //#region src/define-docs.ts
@@ -61,13 +61,17 @@ function resolveDocsRobotsConfig(input, options = {}) {
61
61
  }
62
62
  function getDocsRobotsAllowRoutes(options = {}) {
63
63
  const normalizedEntry = normalizeDocsPathSegment(options.entry ?? "docs") || "docs";
64
- const sitemapConfig = resolveDocsSitemapConfig(options.sitemap);
65
- const routes = [
64
+ return unique([
66
65
  "/",
67
66
  `/${normalizedEntry}`,
68
67
  `/${normalizedEntry}/`,
69
68
  `/${normalizedEntry}.md`,
70
69
  `/${normalizedEntry}/*.md`,
70
+ ...getDocsRobotsDiscoveryRoutes(options)
71
+ ].map(normalizeRoute));
72
+ }
73
+ function getDocsRobotsDiscoveryRoutes(options = {}) {
74
+ const routes = [
71
75
  DEFAULT_LLMS_TXT_ROUTE,
72
76
  DEFAULT_LLMS_FULL_TXT_ROUTE,
73
77
  DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE,
@@ -89,6 +93,7 @@ function getDocsRobotsAllowRoutes(options = {}) {
89
93
  DEFAULT_MCP_PUBLIC_ROUTE,
90
94
  DEFAULT_MCP_WELL_KNOWN_ROUTE
91
95
  ];
96
+ const sitemapConfig = resolveDocsSitemapConfig(options.sitemap);
92
97
  if (sitemapConfig.enabled) {
93
98
  if (sitemapConfig.xml.enabled) routes.push(sitemapConfig.xml.route);
94
99
  if (sitemapConfig.markdown.enabled) {
@@ -169,30 +174,93 @@ function upsertDocsRobotsGeneratedBlock(existing, block) {
169
174
  const prefix = existing.trimEnd();
170
175
  return `${prefix}${prefix ? "\n\n" : ""}${block}`;
171
176
  }
172
- function blockForUserAgent(content, userAgent) {
173
- const escaped = userAgent.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
174
- return content.match(new RegExp(`(?:^|\\n)\\s*User-agent:\\s*${escaped}\\s*(?:\\n[ \\t]*(?!User-agent:).*)*`, "i"))?.[0] ?? "";
177
+ function parseRobotsGroups(content) {
178
+ const groups = [];
179
+ let current;
180
+ for (const rawLine of content.split(/\r?\n/)) {
181
+ const line = rawLine.replace(/#.*$/, "").trim();
182
+ const separator = line.indexOf(":");
183
+ if (separator === -1) continue;
184
+ const field = line.slice(0, separator).trim().toLowerCase();
185
+ const value = line.slice(separator + 1).trim();
186
+ if (field === "user-agent") {
187
+ if (!value) continue;
188
+ if (!current || current.hasRules) {
189
+ current = {
190
+ userAgents: /* @__PURE__ */ new Set(),
191
+ allowRoutes: /* @__PURE__ */ new Set(),
192
+ rules: [],
193
+ hasRules: false
194
+ };
195
+ groups.push(current);
196
+ }
197
+ current.userAgents.add(value.toLowerCase());
198
+ continue;
199
+ }
200
+ if (!current) continue;
201
+ if (field !== "allow" && field !== "disallow") continue;
202
+ current.hasRules = true;
203
+ if (!value) continue;
204
+ const pattern = normalizeRoute(value);
205
+ if (field === "allow") current.allowRoutes.add(pattern);
206
+ current.rules.push({
207
+ directive: field,
208
+ pattern
209
+ });
210
+ }
211
+ return groups;
212
+ }
213
+ function rulesForUserAgent(groups, userAgent) {
214
+ const normalizedUserAgent = userAgent.toLowerCase();
215
+ const explicitMatches = groups.filter((group) => group.userAgents.has(normalizedUserAgent));
216
+ const matches = explicitMatches.length > 0 ? explicitMatches : groups.filter((group) => group.userAgents.has("*"));
217
+ return {
218
+ found: explicitMatches.length > 0,
219
+ allowRoutes: new Set(matches.flatMap((group) => [...group.allowRoutes])),
220
+ rules: matches.flatMap((group) => group.rules)
221
+ };
222
+ }
223
+ function concreteDiscoveryRoute(route) {
224
+ return route.replace(/\*/g, "resource");
175
225
  }
176
- function disallowsRoute(content, route) {
177
- const escapedRoute = route.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
178
- return new RegExp(`^\\s*Disallow:\\s*${escapedRoute}(?:\\s|$)`, "im").test(content);
226
+ function robotsRuleMatches(pattern, route) {
227
+ const endAnchored = pattern.endsWith("$");
228
+ const expression = (endAnchored ? pattern.slice(0, -1) : pattern).split("*").map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join(".*");
229
+ return new RegExp(`^${expression}${endAnchored ? "$" : ""}`).test(route);
230
+ }
231
+ function robotsRuleSpecificity(pattern) {
232
+ return new TextEncoder().encode(pattern).byteLength;
233
+ }
234
+ function rulesAllowRoute(rules, route) {
235
+ const concreteRoute = concreteDiscoveryRoute(route);
236
+ let strongestMatch = -1;
237
+ let allowed = true;
238
+ for (const rule of rules) {
239
+ if (!robotsRuleMatches(rule.pattern, concreteRoute)) continue;
240
+ const specificity = robotsRuleSpecificity(rule.pattern);
241
+ if (specificity > strongestMatch) {
242
+ strongestMatch = specificity;
243
+ allowed = rule.directive === "allow";
244
+ continue;
245
+ }
246
+ if (specificity === strongestMatch && rule.directive === "allow") allowed = true;
247
+ }
248
+ return allowed;
179
249
  }
180
250
  function analyzeDocsRobotsTxt(content, options = {}) {
181
- const expectedRoutes = getDocsRobotsAllowRoutes(options).filter((route) => [
182
- DEFAULT_LLMS_TXT_ROUTE,
183
- DEFAULT_LLMS_FULL_TXT_ROUTE,
184
- DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
185
- DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE,
186
- DEFAULT_AGENTS_MD_ROUTE,
187
- DEFAULT_SKILL_MD_ROUTE,
188
- DEFAULT_MCP_PUBLIC_ROUTE
189
- ].includes(route) || route.includes("sitemap"));
190
- const missingRoutes = expectedRoutes.filter((route) => !content.includes(route));
251
+ const expectedRoutes = options.sitemapRoutes === void 0 ? getDocsRobotsDiscoveryRoutes(options) : unique([...getDocsRobotsDiscoveryRoutes({
252
+ ...options,
253
+ sitemap: false
254
+ }), ...options.sitemapRoutes].map(normalizeRoute));
255
+ const groups = parseRobotsGroups(content);
256
+ const wildcardRules = rulesForUserAgent(groups, "*");
257
+ const allowedRoutes = wildcardRules.allowRoutes;
258
+ const missingRoutes = expectedRoutes.filter((route) => !allowedRoutes.has(route));
191
259
  return {
192
- blocksAgentRoutes: /Disallow:\s*\/(?:\s|$)/i.test(blockForUserAgent(content, "*")) || expectedRoutes.some((route) => disallowsRoute(content, route)),
193
- blocksAiAgents: DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS.some((userAgent) => /Disallow:\s*\/(?:\s|$)/i.test(blockForUserAgent(content, userAgent))),
260
+ blocksAgentRoutes: expectedRoutes.some((route) => !rulesAllowRoute(wildcardRules.rules, route)),
261
+ blocksAiAgents: DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS.some((userAgent) => expectedRoutes.some((route) => !rulesAllowRoute(rulesForUserAgent(groups, userAgent).rules, route))),
194
262
  hasAgentRoutes: missingRoutes.length === 0,
195
- hasAiPolicy: DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS.some((userAgent) => content.includes(userAgent)),
263
+ hasAiPolicy: DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS.some((userAgent) => rulesForUserAgent(groups, userAgent).found),
196
264
  missingRoutes
197
265
  };
198
266
  }
@@ -1,7 +1,7 @@
1
1
  import "./agent-CcR8_Yyd.mjs";
2
2
  import "./standards-discovery-C7p5lBhc.mjs";
3
- import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-vU80KRFy.mjs";
4
- import { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
3
+ import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DonzDfBW.mjs";
4
+ import { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
5
5
  import { t as detectFramework } from "./utils-DpiIioYb.mjs";
6
6
  import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
7
7
  import path from "node:path";
@@ -70,15 +70,21 @@ function parseRobotsGenerateArgs(argv) {
70
70
  if (parsed.append && parsed.force) throw new Error("Use either --append or --force, not both.");
71
71
  return parsed;
72
72
  }
73
- function readTopLevelBooleanProperty(content, key) {
74
- const match = content.match(new RegExp(`\\b${key}\\b\\s*:\\s*(true|false)`));
75
- return match ? match[1] === "true" : void 0;
76
- }
77
73
  function readLlmsBaseUrlFromConfig(content, config) {
78
74
  if (config?.llmsTxt && typeof config.llmsTxt === "object") return config.llmsTxt.baseUrl;
79
75
  const block = extractNestedObjectLiteral(content, ["llmsTxt"]);
80
76
  return block ? readStringProperty(block, "baseUrl") : void 0;
81
77
  }
78
+ function isApiCatalogEnabled(content, config) {
79
+ if (config?.staticExport ?? readTopLevelBooleanProperty(content, "staticExport") ?? false) return false;
80
+ if (config?.llmsTxt && typeof config.llmsTxt === "object") return config.llmsTxt.apiCatalog !== false;
81
+ const block = extractNestedObjectLiteral(content, ["llmsTxt"]);
82
+ return block ? readBooleanProperty(block, "apiCatalog") !== false : true;
83
+ }
84
+ function isAgentCardEnabled(content, config) {
85
+ if (config) return Boolean(config.agent?.a2a);
86
+ return Boolean(extractNestedObjectLiteral(content, ["agent", "a2a"]));
87
+ }
82
88
  function readSitemapConfigFromStatic(content) {
83
89
  const topLevelBoolean = readTopLevelBooleanProperty(content, "sitemap");
84
90
  if (typeof topLevelBoolean === "boolean") return topLevelBoolean;
@@ -134,6 +140,8 @@ async function generateRobots(options = {}) {
134
140
  const sitemap = config?.sitemap ?? readSitemapConfigFromStatic(configContent) ?? true;
135
141
  const sitemapBaseUrl = typeof sitemap === "object" ? sitemap.baseUrl : void 0;
136
142
  const llmsBaseUrl = readLlmsBaseUrlFromConfig(configContent, config);
143
+ const apiCatalog = isApiCatalogEnabled(configContent, config);
144
+ const agentCard = isAgentCardEnabled(configContent, config);
137
145
  const configuredRobots = resolveConfiguredRobots(configContent, config);
138
146
  if (configuredRobots === false) throw new Error("Robots generation is disabled by `robots: false`.");
139
147
  const robotsInput = typeof configuredRobots === "object" ? configuredRobots : {};
@@ -143,6 +151,8 @@ async function generateRobots(options = {}) {
143
151
  const relativeRobotsPath = path.relative(rootDir, robotsPath).replace(/\\/g, "/");
144
152
  const generatedBlock = renderDocsRobotsGeneratedBlock({
145
153
  entry,
154
+ apiCatalog,
155
+ agentCard,
146
156
  sitemap,
147
157
  baseUrl: robots.baseUrl,
148
158
  robots
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@farming-labs/docs",
3
- "version": "0.2.66",
3
+ "version": "0.2.67",
4
4
  "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
5
5
  "keywords": [
6
6
  "docs",