@farming-labs/docs 0.2.61 → 0.2.62

package/dist/index.d.mts

@@ -1,1141 +0,0 @@
-import { A as DocsPublishedAgentSkill, B as createDocsStandardsResponse, C as DocsAgentSkillIndexEntry, D as DocsApiCatalogLinkTarget, E as DocsApiCatalogLinkContext, F as appendDocsDiscoveryLinkHeader, G as resolveDocsStandardsDiscoveryRequest, H as isDocsStandardsDiscoveryRequest, I as buildDocsA2AAgentCard, K as sha256DocsDiscoveryContent, L as buildDocsAgentSkillsIndex, M as DocsPublishedAgentSkillOptions, N as DocsStandardsDiscoveryRequest, O as DocsApiCatalogOptions, P as DocsStandardsDiscoveryRouteOptions, R as buildDocsApiCatalog, S as DocsA2AAgentCardOptions, T as DocsApiCatalog, U as resolveDocsDiscoveryApiRoute, V as getDocsDiscoveryLinkHeader, W as resolveDocsPublishedAgentSkill, _ as DEFAULT_API_CATALOG_ROUTE, a as DEFAULT_A2A_AGENT_CARD_FORMAT, b as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, c as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, f as DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, g as DEFAULT_API_CATALOG_FORMAT, h as DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, i as CreateDocsStandardsResponseOptions, j as DocsPublishedAgentSkillFile, k as DocsDiscoveryApiRouteOptions, l as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, m as DEFAULT_AGENT_SKILL_FORMAT, n as API_CATALOG_MEDIA_TYPE, o as DEFAULT_A2A_AGENT_CARD_ROUTE, p as DEFAULT_AGENT_SKILL_FILE_FORMAT, r as API_CATALOG_PROFILE_URI, s as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, v as DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, w as DocsAgentSkillsIndex, x as DocsA2AAgentCard, y as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, z as buildDocsLegacySkillsIndex } from "./standards-discovery-C4HUqMd2.mjs";
-import { $ as DocsCloudFeatureConfig, $t as DocsTelemetryEvent, A as DocsAgentGoldenTask, An as PageSidebarFrontmatter, At as DocsRelatedItem, B as DocsAnalyticsEventInput, Bn as SidebarPageNode, Bt as DocsSearchAdapterContext, C as DocsAgentEvaluationTaskInput, Cn as PageAgentAppliesTo, Ct as DocsMcpSecurityConfig, D as DocsAgentGoldenAnswerExpectation, Dn as PageAgentVerification, Dt as DocsObservabilityConfig, E as DocsAgentFeedbackData, En as PageAgentFrontmatter, Et as DocsNav, F as DocsAgentTraceEventInput, Fn as SidebarComponentProps, Ft as DocsReviewScoreConfig, G as DocsAskAIActionType, Gn as TypographyConfig, Gt as DocsSearchEmbeddingsConfig, H as DocsAnalyticsInput, Hn as SimpleDocsSearchConfig, Ht as DocsSearchChunkingConfig, I as DocsAgentTraceEventType, In as SidebarConfig, It as DocsReviewSeverity, J as DocsAskAIFeedbackMessage, Jt as DocsSearchResultType, K as DocsAskAIFeedbackConfig, Kn as UIConfig, Kt as DocsSearchQuery, L as DocsAgentTraceStatus, Ln as SidebarFolderIndexBehavior, Lt as DocsRobotsConfig, M as DocsAgentGoldenTaskFilters, Mn as ReadingTimeConfig, Mt as DocsReviewCiMode, N as DocsAgentSkillsConfig, Nn as ReadingTimeFormat, Nt as DocsReviewConfig, O as DocsAgentGoldenExampleVerification, On as PageFrontmatter, Ot as DocsObservabilityEvent, P as DocsAgentSkillsInput, Pn as ResolvedDocsRelatedLink, Pt as DocsReviewRulesConfig, Q as DocsCloudConfig, Qt as DocsTelemetryConfig, R as DocsAnalyticsConfig, Rn as SidebarFolderNode, Rt as DocsRobotsRule, S as DocsAgentEvaluationSurface, Sn as PageActionsConfig, St as DocsMcpProtectedResourceConfig, T as DocsAgentFeedbackContext, Tn as PageAgentFailureMode, Tt as DocsMetadata, U as DocsAnalyticsSource, Un as ThemeToggleConfig, Ut as DocsSearchConfig, V as DocsAnalyticsEventType, Vn as SidebarTree, Vt as DocsSearchAdapterFactory, W as DocsAskAIActionData, Wn as TypesenseDocsSearchConfig, Wt as DocsSearchDocument, X as DocsAskAIMcpConfig, Xt as DocsSitemapConfig, Y as DocsAskAIFeedbackValue, Yt as DocsSearchSourcePage, Z as DocsCloudApiKeyConfig, Zt as DocsTelemetryAgentSurface, _ as DocsAgentEvaluationAnswerProvider, _n as OpenDocsProviderConfig, _t as DocsMcpAuthenticateContext, a as ApiReferenceRenderer, an as FeedbackConfig, at as DocsCodeBlocksRunnerConfig, b as DocsAgentEvaluationAnswerRunner, bn as OpenGraphImage, bt as DocsMcpCorsConfig, c as ChangelogFrontmatter, cn as LastUpdatedConfig, ct as DocsCodeBlocksValidationMode, d as CopyMarkdownFormat, dn as LlmsTxtMaxCharsMode, dt as DocsFeedbackData, en as DocsTelemetryEventInput, et as DocsCloudPreviewConfig, f as CustomDocsSearchConfig, fn as LlmsTxtSectionConfig, ft as DocsFeedbackValue, g as DocsAgentEvaluationAnswerInput, gn as OpenDocsProvider, gt as DocsMcpAuthenticate, h as DocsAgentConfig, hn as OpenDocsConfig, ht as DocsMcpAuthPrincipal, i as ApiReferenceConfig, in as DocsTheme, it as DocsCodeBlocksPlannerProvider, j as DocsAgentGoldenTaskExpectation, jn as PageTwitter, jt as DocsReviewCiConfig, k as DocsAgentGoldenExpectedExample, kn as PageOpenGraph, kt as DocsObservabilityEventInput, l as CodeBlockCopyData, ln as LlmsTxtConfig, lt as DocsCodeBlocksValidationPolicy, m as DocsAgentCompactConfig, mn as OGConfig, mt as DocsMcpAllowedOrigins, n as AgentFeedbackConfig, nn as DocsTelemetryFeatures, nt as DocsCodeBlocksConfig, o as BreadcrumbConfig, on as FontStyle, ot as DocsCodeBlocksRunnerProvider, p as DocsAgentA2AConfig, pn as McpDocsSearchConfig, pt as DocsI18nConfig, q as DocsAskAIFeedbackData, qt as DocsSearchResult, r as AlgoliaDocsSearchConfig, rn as DocsTelemetryFramework, rt as DocsCodeBlocksPlannerConfig, s as ChangelogConfig, sn as GithubConfig, st as DocsCodeBlocksValidateConfig, t as AIConfig, tn as DocsTelemetryEventType, tt as DocsCloudPublishConfig, u as CopyMarkdownConfig, un as LlmsTxtMaxCharsConfig, ut as DocsConfig, v as DocsAgentEvaluationAnswerRequest, vn as OpenDocsProviderId, vt as DocsMcpAuthenticateResult, w as DocsAgentEvaluationsConfig, wn as PageAgentCommand, wt as DocsMcpToolsConfig, x as DocsAgentEvaluationSourceReference, xn as OrderingItem, xt as DocsMcpOriginContext, y as DocsAgentEvaluationAnswerResult, yn as OpenDocsTarget, yt as DocsMcpConfig, z as DocsAnalyticsEvent, zn as SidebarNode, zt as DocsSearchAdapter } from "./types-EhFhYGfr.mjs";
-import { $ as resolveDocsAudienceMdxContent, A as resolveDocsSitemapRequest, C as buildDocsSitemapManifest, D as renderDocsSitemapXml, E as renderDocsSitemapMarkdown, I as PromptAction, J as DocsAudienceMdxIssue, L as PromptProviderChoice, O as resolveDocsSitemapConfig, Q as resolveDocsAudienceExposure, R as SerializeOpenDocsProviderOptions, S as DocsSitemapResolvedConfig, T as readDocsSitemapManifestFromContentMap, X as findDocsAudienceMdxIssues, Y as DocsContentAudience, Z as resolveDocsAgentMdxContent, _ as DEFAULT_SITEMAP_XML_ROUTE, a as createMcpSearchAdapter, at as createDocsAgentTraceId, b as DocsSitemapManifestPage, c as formatDocsAskAIPackageHints, ct as emitDocsObservabilityEvent, d as resolveAskAISearchRequestConfig, dt as resolveDocsObservabilityConfig, et as DOCS_AGENT_TRACE_EVENT_TYPES, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, h as DEFAULT_SITEMAP_MD_ROUTE, i as createCustomSearchAdapter, it as createDocsAgentTraceContext, j as toDocsSitemapMarkdownUrl, k as resolveDocsSitemapPageLastmod, l as inferDocsAskAIPackageHints, lt as getDocsRequestAnalyticsProperties, m as DEFAULT_SITEMAP_MD_DOCS_ROUTE, n as buildDocsSearchDocuments, nt as ResolvedDocsAnalyticsConfig, o as createSimpleSearchAdapter, ot as emitDocsAgentTraceEvent, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, rt as ResolvedDocsObservabilityConfig, s as createTypesenseSearchAdapter, st as emitDocsAnalyticsEvent, t as buildDocsAskAIContext, tt as DocsAgentTraceContext, u as performDocsSearch, ut as resolveDocsAnalyticsConfig, v as DocsSitemapFormat, w as createDocsSitemapResponse, x as DocsSitemapPageInput, y as DocsSitemapManifest, z as SerializedOpenDocsProvider } from "./search-C6heDO8h.mjs";
-import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
-
-//#region src/define-docs.d.ts
-/**
- * Define docs configuration. Validates and returns the config.
- */
-declare function defineDocs(config: DocsConfig): DocsConfig;
-//#endregion
-//#region src/telemetry.d.ts
-interface ResolvedDocsTelemetryConfig {
-  enabled: boolean;
-  endpoint?: string;
-}
-interface DocsTelemetryContext {
-  framework?: DocsTelemetryFramework;
-  request?: Request;
-  siteOrigin?: string;
-  properties?: Record<string, unknown>;
-}
-interface DocsTelemetryAgentSurfaceContext extends DocsTelemetryContext {
-  surface: DocsTelemetryAgentSurface;
-}
-interface DocsTelemetryAgentSurfaceRequestOptions {
-  entry: string;
-  llmsTxt?: DocsConfig["llmsTxt"];
-  feedback?: DocsConfig["feedback"];
-}
-declare function resolveDocsTelemetryConfig(telemetry?: boolean | DocsTelemetryConfig): ResolvedDocsTelemetryConfig;
-/** Normalize an HTTP(S) telemetry site value to its origin. */
-declare function normalizeDocsTelemetryOrigin(candidate: string | undefined): string | undefined;
-/** Return whether a telemetry origin points at a local development server. */
-declare function isLocalDocsTelemetryOrigin(candidate: string | undefined): boolean;
-declare function getDocsTelemetryFeatures(config: Partial<DocsConfig>): DocsTelemetryFeatures;
-declare function emitDocsTelemetryEvent(telemetry: boolean | DocsTelemetryConfig | undefined, event: DocsTelemetryEvent): Promise<void>;
-declare function emitDocsTelemetryProjectEvent(config: Partial<DocsConfig>, context?: DocsTelemetryContext): void;
-declare function emitDocsTelemetryAgentSurfaceEvent(config: Partial<DocsConfig>, context: DocsTelemetryAgentSurfaceContext): void;
-declare function emitDocsTelemetryMcpToolEvent(config: Partial<DocsConfig>, context: DocsTelemetryContext & {
-  tool: string;
-  locale?: string;
-  resultCount?: number;
-}): void;
-declare function inferDocsTelemetryAgentSurface(request: Request, options: DocsTelemetryAgentSurfaceRequestOptions): DocsTelemetryAgentSurface | undefined;
-//#endregion
-//#region src/changelog.d.ts
-interface ResolvedChangelogConfig {
-  enabled: boolean;
-  path: string;
-  contentDir: string;
-  title: string;
-  description?: string;
-  search: boolean;
-  actionsComponent?: unknown;
-}
-interface ChangelogEntrySummary extends ChangelogFrontmatter {
-  slug: string;
-  date: string;
-  url: string;
-}
-declare function resolveChangelogConfig(value: DocsConfig["changelog"]): ResolvedChangelogConfig;
-//#endregion
-//#region src/utils.d.ts
-/**
- * Deep merge utility for theme overrides.
- * Merges objects recursively; later values override earlier ones.
- */
-declare function deepMerge<T extends Record<string, unknown>>(target: T, ...sources: Partial<T>[]): T;
-//#endregion
-//#region src/create-theme.d.ts
-/**
- * Create a theme preset factory.
- *
- * Returns a function that accepts optional overrides and deep-merges them
- * with the base theme defaults. This is the same pattern used by the
- * built-in `fumadocs()`, `darksharp()`, and `pixelBorder()` presets.
- *
- * @param baseTheme - The default theme configuration
- * @returns A factory function `(overrides?) => DocsTheme`
- *
- * @example
- * ```ts
- * import { createTheme } from "@farming-labs/docs";
- *
- * export const myTheme = createTheme({
- *   name: "my-theme",
- *   ui: {
- *     colors: { primary: "#6366f1" },
- *     layout: { contentWidth: 800 },
- *   },
- * });
- * ```
- */
-declare function createTheme(baseTheme: DocsTheme): (overrides?: Partial<DocsTheme>) => DocsTheme;
-/**
- * Extend an existing theme preset with additional defaults.
- *
- * Useful when you want to build on top of an existing theme (e.g. fumadocs)
- * rather than starting from scratch.
- *
- * @example
- * ```ts
- * import { extendTheme } from "@farming-labs/docs";
- * import { fumadocs } from "@farming-labs/theme/default";
- *
- * // Start with fumadocs defaults, override some values
- * export const myTheme = extendTheme(fumadocs(), {
- *   name: "my-custom-fumadocs",
- *   ui: { colors: { primary: "#22c55e" } },
- * });
- * ```
- */
-declare function extendTheme(baseTheme: DocsTheme, extensions: Partial<DocsTheme>): DocsTheme;
-//#endregion
-//#region src/i18n.d.ts
-interface ResolvedDocsI18n {
-  locales: string[];
-  defaultLocale: string;
-}
-interface DocsPathMatch {
-  /** Slug path relative to the docs root (no leading slash). */
-  slug: string;
-  /** Entry path used for URLs (no locale segment). */
-  entryPath: string;
-}
-declare function resolveDocsI18n(config?: DocsI18nConfig | null): ResolvedDocsI18n | null;
-declare function resolveDocsLocale(searchParams: URLSearchParams, i18n?: ResolvedDocsI18n | null): string | undefined;
-declare function resolveDocsPath(pathname: string, entry: string): DocsPathMatch;
-//#endregion
-//#region src/agent-conformance.d.ts
-declare const DOCS_AGENT_CONTRACT_VERSION = "1.1";
-type DocsAgentAdapter = "next" | "tanstack-start" | "sveltekit" | "astro" | "nuxt";
-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";
-interface DocsAgentContractRequest {
-  url: string;
-  init?: RequestInit;
-}
-interface DocsAgentContractExpectation {
-  statuses: readonly number[];
-  contentTypes: readonly string[];
-  bodyIncludes?: readonly string[];
-  bodyEmpty?: boolean;
-  headerIncludes?: Readonly<Record<string, readonly string[]>>;
-  linkRelations?: readonly {
-    href: string;
-    rel: string;
-  }[];
-}
-interface DocsAgentContractCase {
-  surface: DocsAgentContractSurface;
-  request: DocsAgentContractRequest;
-  expect: DocsAgentContractExpectation;
-}
-interface DocsAgentConformanceCaseResult {
-  surface: DocsAgentContractSurface;
-  passed: boolean;
-  status?: number;
-  contentType?: string;
-  issues: string[];
-}
-interface DocsAgentConformanceReport {
-  adapter: DocsAgentAdapter;
-  contractVersion: typeof DOCS_AGENT_CONTRACT_VERSION;
-  passed: boolean;
-  cases: DocsAgentConformanceCaseResult[];
-}
-interface RunDocsAgentConformanceOptions {
-  adapter: DocsAgentAdapter;
-  /** Origin used to construct requests. Defaults to http://localhost. */
-  origin?: string;
-  /** Public docs entry. Defaults to docs. */
-  entry?: string;
-  /** Locale fixture expected to render the word "Bonjour". Set false to skip. */
-  locale?: string | false;
-  handle(request: Request, surface: DocsAgentContractSurface): Response | Promise<Response>;
-}
-/**
- * The framework-neutral public surface every first-party adapter must implement.
- * Adapter tests consume this list so new routes and invariants are added once.
- */
-declare function createDocsAgentContractCases(options?: {
-  origin?: string;
-  entry?: string;
-  locale?: string | false;
-}): DocsAgentContractCase[];
-declare function runDocsAgentConformance(options: RunDocsAgentConformanceOptions): Promise<DocsAgentConformanceReport>;
-//#endregion
-//#region src/metadata.d.ts
-interface DocsStructuredDataBreadcrumb {
-  name: string;
-  url: string;
-}
-interface DocsPageStructuredDataInput {
-  title: string;
-  description?: string;
-  url: string;
-  baseUrl?: string;
-  entry?: string;
-  dateModified?: string;
-  breadcrumbs?: DocsStructuredDataBreadcrumb[];
-  /** Optional actionable page contract represented as a Schema.org HowTo. */
-  agent?: PageAgentFrontmatter;
-}
-/**
- * Resolve page title using metadata titleTemplate.
- * %s is replaced with page title.
- */
-declare function resolveTitle(pageTitle: string, metadata?: DocsMetadata): string;
-/**
- * Resolve OG image URL for a page.
- * Prefers page.openGraph.images[0], then page.ogImage, then config endpoint/default.
- */
-declare function resolveOGImage(page: PageFrontmatter, ogConfig?: OGConfig, baseUrl?: string): string | undefined;
-/**
- * Build the Open Graph metadata object for a page.
- * When the page has openGraph in frontmatter, uses it (with title/description filled from page if omitted).
- * Otherwise uses ogImage or config (dynamic endpoint / defaultImage).
- */
-declare function buildPageOpenGraph(page: Pick<PageFrontmatter, "title" | "description" | "ogImage" | "openGraph">, ogConfig?: OGConfig, baseUrl?: string): PageOpenGraph | undefined;
-/**
- * Build the Twitter card metadata object for a page.
- * When the page has twitter in frontmatter, uses it.
- * Otherwise builds from ogImage or config (dynamic endpoint).
- */
-declare function buildPageTwitter(page: Pick<PageFrontmatter, "title" | "description" | "ogImage" | "openGraph" | "twitter">, ogConfig?: OGConfig, baseUrl?: string): PageTwitter | undefined;
-/**
- * Resolve the public docs site URL from existing agent-facing config.
- *
- * The framework intentionally reuses `sitemap.baseUrl`, `llmsTxt.baseUrl`,
- * `robots.baseUrl`, or `ai.docsUrl` instead of requiring another setting.
- */
-declare function resolveDocsMetadataBaseUrl(config: DocsConfig): string | undefined;
-/**
- * Build Schema.org JSON-LD for a docs page.
- *
- * The shape follows Vercel's agent readability guidance: a `TechArticle`
- * with title, description, canonical URL, freshness, and breadcrumbs.
- */
-declare function buildDocsPageStructuredData(input: DocsPageStructuredDataInput): Record<string, unknown>;
-/**
- * Serialize Schema.org JSON-LD for safe insertion into a `<script>` tag.
- */
-declare function renderDocsPageStructuredDataJson(input: DocsPageStructuredDataInput): string;
-//#endregion
-//#region src/reading-time.d.ts
-interface ResolvedReadingTimeOptions {
-  enabled: boolean;
-  wordsPerMinute?: number;
-  format: ReadingTimeFormat;
-  includeCode: boolean;
-}
-interface ReadingTimeEstimateOptions {
-  includeCode?: boolean;
-}
-declare function estimateReadingTimeMinutes(content: string, wordsPerMinute?: number, options?: ReadingTimeEstimateOptions): number;
-declare function resolveReadingTimeOptions(readingTime: boolean | ReadingTimeConfig | null | undefined): ResolvedReadingTimeOptions;
-declare function resolveReadingTimeFromContent(frontmatter: Partial<PageFrontmatter> | undefined, content: string, wordsPerMinute?: number, options?: ReadingTimeEstimateOptions): number | null;
-declare function resolvePageReadingTime(frontmatter: Partial<PageFrontmatter> | undefined, content: string, options?: {
-  enabledByDefault?: boolean;
-  wordsPerMinute?: number;
-  includeCode?: boolean;
-}): number | null | undefined;
-declare function resolveReadingTimeFromSource(source: string, wordsPerMinute?: number, options?: ReadingTimeEstimateOptions): number | null;
-//#endregion
-//#region src/related.d.ts
-declare function normalizeDocsRelated(value: unknown): ResolvedDocsRelatedLink[];
-declare function renderDocsRelatedMarkdownLines(related: ResolvedDocsRelatedLink[] | undefined): string[];
-//#endregion
-//#region src/agent-contract.d.ts
-interface PageAgentFrontmatterIssue {
-  path: string;
-  message: string;
-}
-declare const PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS: readonly ["task", "outcome", "appliesTo", "prerequisites", "files", "commands", "sideEffects", "verification", "rollback", "failureModes"];
-declare const PAGE_AGENT_CONTRACT_FIELDS: readonly ["tokenBudget", "task", "outcome", "appliesTo", "prerequisites", "files", "commands", "sideEffects", "verification", "rollback", "failureModes"];
-declare const PAGE_AGENT_CONTRACT_FIELD_SCHEMA: {
-  readonly tokenBudget: "number";
-  readonly task: "string";
-  readonly outcome: "string";
-  readonly appliesTo: {
-    readonly framework: "string|string[]";
-    readonly version: "string|string[]";
-    readonly package: "string|string[]";
-  };
-  readonly prerequisites: "string[]";
-  readonly files: "string[]";
-  readonly commands: "Array<string|{run,cwd?,description?}>";
-  readonly sideEffects: "string[]";
-  readonly verification: "Array<string|{description?,run?,expect?}>";
-  readonly rollback: "string[]";
-  readonly failureModes: "Array<string|{symptom,resolution?}>";
-};
-declare const PAGE_AGENT_CONTRACT_START_MARKER = "<!-- farming-labs:agent-contract:start -->";
-declare const PAGE_AGENT_CONTRACT_END_MARKER = "<!-- farming-labs:agent-contract:end -->";
-/**
- * Normalize untrusted page frontmatter into the stable agent contract shape.
- * Invalid fields are omitted so malformed author input cannot break page delivery.
- */
-declare function normalizePageAgentFrontmatter(value: unknown): PageAgentFrontmatter | undefined;
-declare function hasStructuredPageAgentContract(value: unknown): boolean;
-/** Return author-facing validation issues without throwing. */
-declare function getPageAgentFrontmatterIssues(value: unknown): PageAgentFrontmatterIssue[];
-/** Render normalized `agent` YAML in a stable field order. */
-declare function renderPageAgentFrontmatterYamlLines(value: unknown, indentation?: number): string[];
-/** Render the structured contract as deterministic, compact machine-readable Markdown. */
-declare function renderPageAgentContractMarkdown(value: unknown): string;
-/** Remove generated contract blocks while preserving handwritten guidance. */
-declare function stripGeneratedPageAgentContractMarkdown(markdown: string): string;
-/** Insert one generated contract unless the document already has handwritten contract guidance. */
-declare function upsertPageAgentContractMarkdown(markdown: string, value: unknown): string;
-//#endregion
-//#region src/sidebar.d.ts
-interface SidebarFolderIndexBehaviorOptions {
-  sidebar: boolean | SidebarConfig | undefined;
-  defaultBehavior?: SidebarFolderIndexBehavior;
-}
-declare function resolvePageSidebarFolderIndexBehavior(sidebar: unknown): SidebarFolderIndexBehavior | undefined;
-declare function resolveSidebarFolderIndexBehavior(sidebar: boolean | SidebarConfig | undefined, defaultBehavior?: SidebarFolderIndexBehavior): SidebarFolderIndexBehavior;
-declare function resolveSidebarFolderIndexBehaviorForPath(sidebar: boolean | SidebarConfig | undefined, folderPath: string | undefined, defaultBehavior?: SidebarFolderIndexBehavior): SidebarFolderIndexBehavior;
-declare function applySidebarFolderIndexBehavior<TTree extends {
-  children: unknown[];
-}>(tree: TTree, behaviorOrOptions: SidebarFolderIndexBehavior | SidebarFolderIndexBehaviorOptions): TTree;
-//#endregion
-//#region src/agent-provenance.d.ts
-declare const GENERATED_AGENT_PROVENANCE_MARKER = "@farming-labs/docs:generated";
-declare const GENERATED_AGENT_PROVENANCE_VERSION = 1;
-type GeneratedAgentSourceKind = "resolved-page" | "agent-md";
-interface GeneratedAgentProvenance {
-  version: number;
-  sourceKind: GeneratedAgentSourceKind;
-  sourceHash: string;
-  settingsHash: string;
-  outputHash: string;
-  generatedAt: string;
-}
-interface ParsedGeneratedAgentDocument {
-  provenance?: GeneratedAgentProvenance;
-  content: string;
-}
-declare function normalizeGeneratedAgentContent(value: string): string;
-declare function hashGeneratedAgentContent(value: string): string;
-declare function parseGeneratedAgentDocument(raw: string): ParsedGeneratedAgentDocument;
-declare function stripGeneratedAgentProvenance(raw: string): string;
-declare function serializeGeneratedAgentDocument(content: string, provenance: GeneratedAgentProvenance): string;
-//#endregion
-//#region src/mcp-auth.d.ts
-declare const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
-declare const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
-declare const DEFAULT_MCP_WELL_KNOWN_ROUTE = "/.well-known/mcp";
-declare const DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE = "/.well-known/oauth-protected-resource";
-declare function getDocsMcpResourcePaths(route?: string): string[];
-declare function buildDocsMcpProtectedResourceMetadataRoute(resourcePath: string): string;
-declare function getDocsMcpProtectedResourceMetadataRoutes(route?: string): string[];
-declare function hasDocsMcpProtectedResourceConfig(mcp?: boolean | DocsMcpConfig): boolean;
-declare function isDocsMcpRequest(url: URL, mcp?: boolean | DocsMcpConfig): boolean;
-//#endregion
-//#region src/agent.d.ts
-declare const DEFAULT_DOCS_API_ROUTE = "/api/docs";
-declare const DEFAULT_DOCS_CONFIG_FORMAT = "docs-config-map.v1";
-declare const DEFAULT_DOCS_CONFIG_ROUTE = "/api/docs?format=config";
-declare const DEFAULT_DOCS_DIAGNOSTICS_FORMAT = "docs-diagnostics.v1";
-declare const DEFAULT_DOCS_DIAGNOSTICS_ROUTE = "/api/docs?format=diagnostics";
-declare const DEFAULT_OPENAPI_SCHEMA_ROUTE = "/api/docs?format=openapi";
-declare const DEFAULT_AGENT_SPEC_ROUTE = "/api/docs/agent/spec";
-declare const DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE = "/.well-known/agent";
-declare const DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE = "/.well-known/agent.json";
-declare const DEFAULT_LLMS_TXT_ROUTE = "/llms.txt";
-declare const DEFAULT_LLMS_FULL_TXT_ROUTE = "/llms-full.txt";
-declare const DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms.txt";
-declare const DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms-full.txt";
-declare const DEFAULT_LLMS_TXT_MAX_CHARS = 50000;
-declare const DEFAULT_SKILL_MD_ROUTE = "/skill.md";
-declare const DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE = "/.well-known/skill.md";
-declare const DEFAULT_AGENTS_MD_ROUTE = "/AGENTS.md";
-declare const DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE = "/.well-known/AGENTS.md";
-declare const DEFAULT_AGENT_MD_ROUTE = "/AGENT.md";
-declare const DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE = "/.well-known/AGENT.md";
-declare const DEFAULT_AGENT_FEEDBACK_ROUTE = "/api/docs/agent/feedback";
-declare const DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA: Record<string, unknown>;
-declare const DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER = "Signature-Agent";
-declare const DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN: string;
-declare const DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN: string;
-declare const DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN: string;
-interface DocsMcpEndpointCandidate {
-  baseUrl: string;
-  route: string;
-  url: string;
-  label: string;
-}
-interface DocsMcpEndpointCandidateOptions {
-  includeOriginFallback?: boolean;
-  includeRootDomainFallback?: boolean;
-  includeMcpSubdomainFallback?: boolean;
-}
-interface DocsAgentFeedbackResolvedConfig {
-  enabled: boolean;
-  route: string;
-  schemaRoute: string;
-  payloadSchema: Record<string, unknown>;
-  schema: Record<string, unknown>;
-  onFeedback?: (data: DocsAgentFeedbackData) => void | Promise<void>;
-}
-interface DocsAgentFeedbackRequest {
-  kind: "schema" | "submit";
-}
-interface DocsAgentFeedbackDiscoveryConfig {
-  enabled?: boolean;
-  route?: string;
-  schemaRoute?: string;
-}
-interface DocsLlmsDiscoveryConfig extends DocsDiscoveryApiRouteOptions {
-  enabled?: boolean;
-  /** Whether this deployment actually serves the RFC 9727 API catalog. Defaults to true. */
-  apiCatalog?: boolean;
-  baseUrl?: string;
-  siteTitle?: string;
-  siteDescription?: string;
-  maxChars?: LlmsTxtMaxCharsConfig;
-  sections?: LlmsTxtSectionConfig[];
-  openapi?: boolean | DocsOpenApiDiscoveryConfig;
-}
-interface DocsOpenApiDiscoveryConfig {
-  enabled?: boolean;
-  url?: string;
-  /** Whether `url` came from the framework default or explicit configuration. */
-  urlSource?: "default" | "configured";
-  source?: "generated" | "configured";
-  specUrl?: string;
-  apiReferencePath?: string;
-}
-interface DocsOpenApiResolvedDiscoveryConfig {
-  enabled: boolean;
-  url?: string;
-  /** Whether `url` came from the framework default or explicit configuration. */
-  urlSource?: "default" | "configured";
-  source?: "generated" | "configured";
-  specUrl?: string;
-  apiReferencePath?: string;
-}
-type DocsConfigMapJsonPrimitive = string | number | boolean | null;
-type DocsConfigMapJsonValue = DocsConfigMapJsonPrimitive | DocsConfigMapJsonValue[] | {
-  [key: string]: DocsConfigMapJsonValue;
-};
-interface DocsConfigMapPointer {
-  /** Dot-path form for humans and TypeScript users, e.g. `mcp.tools.readPage`. */
-  path: string;
-  /** Coarse value kind at this pointer. */
-  kind: string;
-}
-interface DocsConfigMap {
-  schemaVersion: 1;
-  format: typeof DEFAULT_DOCS_CONFIG_FORMAT;
-  source: {
-    /** Best-effort source label; adapters only receive the runtime config object. */file: string; /** Best-effort language hint based on serializing the runtime config object. */
-    language: "ts" | "tsx";
-  };
-  serialization: {
-    mode: "json-safe";
-    redacted: string;
-    nonSerializable: "described";
-  };
-  values: {
-    [key: string]: DocsConfigMapJsonValue;
-  };
-  /** RFC 6901 JSON Pointer index for mapping response values back to docs.config paths. */
-  pointers: Record<string, DocsConfigMapPointer>;
-}
-type DocsDiagnosticsStatus = "enabled" | "disabled";
-type DocsDiagnosticsIssueSeverity = "warning" | "error";
-interface DocsDiagnosticsIssue {
-  severity: DocsDiagnosticsIssueSeverity;
-  code: string;
-  path?: string;
-  message: string;
-}
-interface DocsDiagnosticsFeature {
-  status: DocsDiagnosticsStatus;
-  reason?: string;
-  route?: string | null;
-  routes?: Record<string, string | null>;
-  provider?: string;
-  mode?: string;
-  transport?: "GET" | "POST" | "GET/HEAD" | "GET/POST";
-  tools?: Record<string, boolean>;
-  human?: boolean;
-  agent?: boolean;
-}
-interface DocsDiagnostics {
-  schemaVersion: 1;
-  format: typeof DEFAULT_DOCS_DIAGNOSTICS_FORMAT;
-  ok: boolean;
-  adapter: string | null;
-  routes: {
-    docs: string;
-    api: string;
-    config: string;
-    diagnostics: string;
-    agentSpec: string;
-    apiCatalog: string | null;
-    agentSkillsIndex: string;
-    agentSkillsArtifact: string;
-    agents: string;
-    skill: string;
-    search: string | null;
-    askAi: string | null;
-    mcp: string | null;
-    llmsTxt: string | null;
-    llmsFullTxt: string | null;
-    sitemapXml: string | null;
-    sitemapMarkdown: string | null;
-    robots: string | null;
-    openapi: string | null;
-    apiReference: string | null;
-  };
-  features: {
-    staticExport: DocsDiagnosticsFeature;
-    config: DocsDiagnosticsFeature;
-    diagnostics: DocsDiagnosticsFeature;
-    apiCatalog: DocsDiagnosticsFeature;
-    search: DocsDiagnosticsFeature;
-    ai: DocsDiagnosticsFeature;
-    mcp: DocsDiagnosticsFeature;
-    feedback: DocsDiagnosticsFeature;
-    llmsTxt: DocsDiagnosticsFeature;
-    sitemap: DocsDiagnosticsFeature;
-    robots: DocsDiagnosticsFeature;
-    apiReference: DocsDiagnosticsFeature;
-    agents: DocsDiagnosticsFeature;
-    skills: DocsDiagnosticsFeature;
-    locales: DocsDiagnosticsFeature;
-  };
-  warnings: DocsDiagnosticsIssue[];
-  errors: DocsDiagnosticsIssue[];
-}
-interface DocsDiagnosticsOptions extends DocsDiscoveryApiRouteOptions {
-  adapter?: string;
-  /** Effective RFC 9727 catalog availability after runtime overrides are applied. */
-  apiCatalog?: boolean;
-  entry?: string;
-  i18n?: ResolvedDocsI18n | null;
-  mcp?: DocsMcpResolvedConfig;
-  feedback?: DocsAgentFeedbackDiscoveryConfig;
-  openapi?: boolean | DocsOpenApiDiscoveryConfig;
-}
-interface DocsLlmsTxtResolvedMaxChars {
-  mode: LlmsTxtMaxCharsMode;
-  chars: number;
-}
-interface DocsLlmsTxtResolvedSection {
-  title: string;
-  description?: string;
-  match: string[];
-  route: string;
-  fullRoute: string;
-  maxChars: DocsLlmsTxtResolvedMaxChars;
-}
-interface DocsLlmsTxtRequest {
-  format: "llms" | "llms-full";
-  section?: DocsLlmsTxtResolvedSection;
-}
-interface DocsLlmsTxtPageInput {
-  url: string;
-  /** Override the Markdown link emitted in llms.txt. */
-  markdownUrl?: string;
-  title: string;
-  description?: string;
-  content: string;
-  rawContent?: string;
-  agentContent?: string;
-  agentRawContent?: string;
-  agentFallbackContent?: string;
-  agentFallbackRawContent?: string;
-}
-interface DocsLlmsTxtGeneratedSection extends DocsLlmsTxtResolvedSection {
-  llmsTxt: string;
-  llmsFullTxt: string;
-}
-interface DocsLlmsTxtGeneratedContent {
-  llmsTxt: string;
-  llmsFullTxt: string;
-  maxChars: DocsLlmsTxtResolvedMaxChars;
-  sections: DocsLlmsTxtGeneratedSection[];
-}
-interface DocsLlmsTxtSelectedContent {
-  content: string;
-  label: string;
-  maxChars: DocsLlmsTxtResolvedMaxChars;
-}
-interface DocsLlmsTxtMaxCharsIssue {
-  mode: Exclude<LlmsTxtMaxCharsMode, "off">;
-  chars: number;
-  actual: number;
-  label: string;
-  message: string;
-}
-interface DocsAgentDiscoverySpecOptions extends DocsDiscoveryApiRouteOptions {
-  origin: string;
-  entry?: string;
-  /** Public rendered docs path when it differs from `entry`. */
-  docsPath?: string;
-  /** Whether this deployment actually serves the RFC 9727 API catalog. Defaults to true. */
-  apiCatalog?: boolean;
-  i18n?: ResolvedDocsI18n | null;
-  search?: boolean | DocsSearchConfig;
-  mcp: DocsMcpResolvedConfig;
-  feedback?: DocsAgentFeedbackDiscoveryConfig;
-  llms?: DocsLlmsDiscoveryConfig;
-  sitemap?: boolean | DocsSitemapConfig;
-  robots?: boolean | DocsRobotsConfig;
-  openapi?: boolean | DocsOpenApiDiscoveryConfig;
-  markdown?: {
-    acceptHeader?: boolean;
-    signatureAgentHeader?: boolean;
-  };
-  /** Additional validated project skills to cross-list in custom discovery. */
-  publishedSkills?: readonly DocsPublishedAgentSkill[];
-  /** Explicit metadata for a real A2A service; omitted sites do not publish an Agent Card. */
-  agentCard?: DocsA2AAgentCardOptions;
-}
-interface DocsSkillDocumentOptions extends DocsDiscoveryApiRouteOptions {
-  origin: string;
-  entry?: string;
-  /** Public rendered docs path when it differs from `entry`. */
-  docsPath?: string;
-  /** Whether this deployment actually serves the RFC 9727 API catalog. Defaults to true. */
-  apiCatalog?: boolean;
-  search?: boolean | DocsSearchConfig;
-  mcp: DocsMcpResolvedConfig;
-  feedback?: DocsAgentFeedbackDiscoveryConfig;
-  llms?: DocsLlmsDiscoveryConfig;
-  sitemap?: boolean | DocsSitemapConfig;
-  robots?: boolean | DocsRobotsConfig;
-  openapi?: boolean | DocsOpenApiDiscoveryConfig;
-  markdown?: {
-    acceptHeader?: boolean;
-    signatureAgentHeader?: boolean;
-  };
-}
-interface DocsAgentsDocumentOptions extends DocsSkillDocumentOptions {}
-interface DocsStandardsDiscoveryResponseOptions extends DocsAgentDiscoverySpecOptions {
-  request: Request;
-  preferredSkillDocument?: string | null;
-  fallbackSkillDocument: string;
-}
-interface DocsAgentContractMcpTools {
-  list?: "list_tasks";
-  read?: "read_task";
-}
-interface DocsMarkdownPage {
-  slug?: string;
-  url: string;
-  title: string;
-  description?: string;
-  /** Override the public Markdown representation URL when it differs from `${url}.md`. */
-  markdownUrl?: string;
-  lastModified?: string;
-  lastmod?: string;
-  related?: ResolvedDocsRelatedLink[];
-  agent?: PageAgentFrontmatter;
-  content: string;
-  rawContent?: string;
-  agentContent?: string;
-  agentRawContent?: string;
-  agentFallbackContent?: string;
-  agentFallbackRawContent?: string;
-}
-interface DocsMarkdownDocumentOptions {
-  llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig;
-  origin?: string;
-  sitemap?: boolean | DocsSitemapConfig;
-}
-interface DocsMarkdownNotFoundOptions extends DocsDiscoveryApiRouteOptions {
-  entry?: string;
-  requestedPath: string;
-  origin?: string;
-  pages?: DocsMarkdownPage[];
-  sitemap?: boolean | DocsSitemapConfig;
-}
-interface DocsMarkdownRecoveryMatch {
-  title: string;
-  url: string;
-  markdownUrl: string;
-  description?: string;
-  confidence: number;
-}
-interface DocsMarkdownRecoveryResult {
-  matches: DocsMarkdownRecoveryMatch[];
-  redirect?: DocsMarkdownRecoveryMatch;
-}
-interface DocsMarkdownCanonicalUrlOptions {
-  origin: string;
-  entry?: string;
-  requestedPath: string;
-  locale?: string | null;
-}
-interface DocsMarkdownResponseOptions extends DocsMarkdownNotFoundOptions {
-  request: Request;
-  document: string | null;
-  /** Override the human-readable canonical URL, for example when docsPath differs from entry. */
-  canonicalUrl?: string;
-  /** Override the selected Markdown representation URL. */
-  contentLocation?: string;
-  locale?: string | null;
-  /** Exact source modification timestamp. Date-only values are intentionally ignored. */
-  lastModified?: string | Date | null;
-  cacheControl?: string;
-}
-declare function normalizeDocsPathSegment(value: string): string;
-declare function normalizeDocsUrlPath(value: string): string;
-declare function isDocsConfigRequest(url: URL): boolean;
-declare function isDocsDiagnosticsRequest(url: URL): boolean;
-/** Prefer an explicitly configured API route; otherwise infer a query-form route from the request. */
-declare function resolveDocsRequestApiRoute(url: URL, configuredApiRoute?: string): string;
-declare function buildDocsConfigMap(config: DocsConfig | Record<string, unknown>, options?: {
-  file?: string;
-}): DocsConfigMap;
-declare function buildDocsDiagnostics(config: DocsConfig | Record<string, unknown>, options?: DocsDiagnosticsOptions): DocsDiagnostics;
-declare function buildDocsAgentFeedbackSchema(payloadSchema: Record<string, unknown>): Record<string, unknown>;
-declare function resolveDocsAgentFeedbackConfig(feedback?: boolean | FeedbackConfig): DocsAgentFeedbackResolvedConfig;
-declare function resolveDocsAgentFeedbackRequest(url: URL, feedback: DocsAgentFeedbackResolvedConfig): DocsAgentFeedbackRequest | null;
-declare function parseDocsAgentFeedbackData(request: Request): Promise<{
-  ok: true;
-  data: DocsAgentFeedbackData;
-} | {
-  ok: false;
-  response: Response;
-}>;
-declare function validateDocsAgentFeedbackPayload(value: unknown, schema: Record<string, unknown>, valuePath?: string): string | undefined;
-declare function toDocsMarkdownUrl(url: string, options?: {
-  locale?: string;
-}): string;
-declare function resolveDocsMarkdownCanonicalUrl({
-  origin,
-  entry,
-  requestedPath,
-  locale
-}: DocsMarkdownCanonicalUrlOptions): string;
-declare function getDocsMarkdownCanonicalLinkHeader(options: DocsMarkdownCanonicalUrlOptions): string;
-declare function resolveDocsLlmsTxtSections(llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig): DocsLlmsTxtResolvedSection[];
-declare function matchesDocsLlmsTxtSection(pageUrl: string, section: DocsLlmsTxtResolvedSection): boolean;
-declare function resolveDocsLlmsTxtRequest(url: URL, llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig, basePath?: string, options?: DocsDiscoveryApiRouteOptions): DocsLlmsTxtRequest | null;
-declare function renderDocsLlmsTxt(pages: DocsLlmsTxtPageInput[], options?: DocsLlmsDiscoveryConfig): DocsLlmsTxtGeneratedContent;
-declare function selectDocsLlmsTxtContent(content: DocsLlmsTxtGeneratedContent, request: DocsLlmsTxtRequest): DocsLlmsTxtSelectedContent | null;
-declare function getDocsLlmsTxtMaxCharsIssue(label: string, content: string, maxChars: DocsLlmsTxtResolvedMaxChars): DocsLlmsTxtMaxCharsIssue | null;
-/** Build and serve standards-based discovery without replacing the custom agent manifest. */
-declare function createDocsStandardsDiscoveryResponse({
-  request,
-  preferredSkillDocument,
-  fallbackSkillDocument,
-  origin,
-  entry,
-  docsPath,
-  apiCatalog: explicitApiCatalog,
-  apiRoute,
-  i18n: _i18n,
-  search: _search,
-  mcp,
-  feedback,
-  llms,
-  sitemap,
-  robots,
-  openapi,
-  markdown: _markdown,
-  publishedSkills,
-  agentCard
-}: DocsStandardsDiscoveryResponseOptions): Promise<Response | null>;
-declare function isDocsAgentDiscoveryRequest(url: URL, options?: DocsDiscoveryApiRouteOptions): boolean;
-declare function buildDocsMcpEndpointCandidates(baseUrl: string, routes?: readonly string[], options?: DocsMcpEndpointCandidateOptions): DocsMcpEndpointCandidate[];
-declare function isDocsSkillRequest(url: URL, options?: DocsDiscoveryApiRouteOptions): boolean;
-declare function resolveDocsSkillFormat(url: URL): "skill" | null;
-declare function isDocsAgentsRequest(url: URL, options?: DocsDiscoveryApiRouteOptions): boolean;
-declare function resolveDocsAgentsFormat(url: URL): "agents" | null;
-declare function isDocsPublicGetRequest(entry: string, url: URL, request: Request, options?: DocsDiscoveryApiRouteOptions & {
-  sitemap?: boolean | DocsSitemapConfig;
-  llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig;
-  robots?: boolean | DocsRobotsConfig;
-}): boolean;
-declare function isDocsLlmsTxtPublicRequest(url: URL, llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig, basePath?: string, options?: DocsDiscoveryApiRouteOptions): boolean;
-declare function resolveDocsLlmsTxtFormat(url: URL, basePath?: string, options?: DocsDiscoveryApiRouteOptions): "llms" | "llms-full" | null;
-declare function resolveDocsMarkdownRequest(entry: string, url: URL, request: Request, options?: DocsDiscoveryApiRouteOptions): {
-  requestedPath: string;
-} | null;
-declare function hasDocsMarkdownSignatureAgent(request: Request): boolean;
-type DocsMarkdownAgentDetection = {
-  detected: true;
-  method: "signature_agent" | "user_agent" | "heuristic";
-} | {
-  detected: false;
-  method: null;
-};
-declare function detectDocsMarkdownAgentRequest(request: Request): DocsMarkdownAgentDetection;
-declare function getDocsMarkdownVaryHeader(request: Request): string | null;
-declare function resolveDocsMarkdownRecovery({
-  entry,
-  requestedPath,
-  pages
-}: DocsMarkdownNotFoundOptions): DocsMarkdownRecoveryResult;
-declare function renderDocsMarkdownNotFound({
-  entry,
-  apiRoute,
-  requestedPath,
-  origin,
-  pages,
-  sitemap
-}: DocsMarkdownNotFoundOptions): string;
-/** Build one standards-aware Markdown response for every framework adapter. */
-declare function createDocsMarkdownResponse(options: DocsMarkdownResponseOptions): Response;
-declare function findDocsMarkdownPage<T extends DocsMarkdownPage>(entry: string, pages: T[], requestedPath: string): T | null;
-declare function renderDocsMarkdownDocument(page: DocsMcpPage | DocsSearchSourcePage, options?: DocsMarkdownDocumentOptions): string;
-declare function renderDocsMarkdownDocument(page: DocsMarkdownPage, options?: DocsMarkdownDocumentOptions): string;
-declare function renderDocsSkillDocument(options: DocsSkillDocumentOptions): string;
-declare function renderDocsAgentsDocument(options: DocsAgentsDocumentOptions): string;
-/** Resolve only the task tools that the advertised MCP endpoint actually exposes. */
-declare function resolveDocsAgentContractMcpTools(mcp: DocsMcpResolvedConfig): DocsAgentContractMcpTools | undefined;
-declare function buildDocsAgentDiscoverySpec({
-  origin,
-  entry,
-  apiRoute,
-  apiCatalog: explicitApiCatalog,
-  i18n,
-  search,
-  mcp,
-  feedback,
-  llms,
-  sitemap,
-  robots,
-  openapi,
-  markdown,
-  publishedSkills,
-  agentCard
-}: DocsAgentDiscoverySpecOptions): {
-  version: string;
-  name: string;
-  baseUrl: string;
-  site: {
-    title: string;
-    description: string | undefined;
-    entry: string;
-    baseUrl: string;
-  };
-  locales: {
-    enabled: boolean;
-    available: string[];
-    default: string | null;
-    queryParam: string;
-    fallbackQueryParam: string;
-  };
-  capabilities: {
-    markdownRoutes: boolean;
-    agentMdOverrides: boolean;
-    agentBlocks: boolean;
-    structuredAgentContracts: boolean;
-    agents: boolean;
-    llms: boolean;
-    skills: boolean;
-    apiCatalog: boolean;
-    agentSkillsDiscovery: boolean;
-    mcp: boolean;
-    search: boolean;
-    sitemap: boolean;
-    robots: boolean;
-    structuredData: boolean;
-    apiReference: boolean;
-    openapi: boolean;
-    agentFeedback: boolean;
-    locales: boolean;
-  };
-  api: {
-    openapi: string;
-    agentCard?: string | undefined;
-    agentSkillsIndex: string;
-    legacySkillsIndex: string;
-    apiCatalog?: string | undefined;
-    apiCatalogQuery?: string | undefined;
-    docs: string;
-    config: string;
-    diagnostics: string;
-    agentSpec: string;
-    agentSpecDefault: string;
-    agentSpecFallback: string;
-    agentSpecWellKnown: string;
-    agentSpecWellKnownJson: string;
-    agentSpecQuery: string;
-    agents: string;
-  };
-  apiCatalog: {
-    enabled: boolean;
-    route: string | null;
-    api: string | null;
-    mediaType: string;
-    profile: string;
-  };
-  config: {
-    format: string;
-    endpoint: string;
-  };
-  markdown: {
-    enabled: boolean;
-    acceptHeader: string | null;
-    signatureAgentHeader: string | null;
-    pagePattern: string;
-    rootPage: string;
-    apiPattern: string;
-    resolutionOrder: string[];
-  };
-  agentContract: {
-    usefulContractFields: string[];
-    fields: {
-      readonly tokenBudget: "number";
-      readonly task: "string";
-      readonly outcome: "string";
-      readonly appliesTo: {
-        readonly framework: "string|string[]";
-        readonly version: "string|string[]";
-        readonly package: "string|string[]";
-      };
-      readonly prerequisites: "string[]";
-      readonly files: "string[]";
-      readonly commands: "Array<string|{run,cwd?,description?}>";
-      readonly sideEffects: "string[]";
-      readonly verification: "Array<string|{description?,run?,expect?}>";
-      readonly rollback: "string[]";
-      readonly failureModes: "Array<string|{symptom,resolution?}>";
-    };
-    mcpTools?: DocsAgentContractMcpTools | undefined;
-    enabled: boolean;
-    schemaVersion: string;
-    source: string;
-    frontmatterPath: string;
-    markdownSection: string;
-    mcpField: string;
-  };
-  llms: {
-    sections?: {
-      title: string;
-      description: string | undefined;
-      match: string[];
-      txt: string;
-      full: string;
-    }[] | undefined;
-    enabled: boolean;
-    defaultTxt: string;
-    defaultFull: string;
-    txt: string;
-    full: string;
-    publicTxt: string;
-    publicFull: string;
-    wellKnownTxt: string;
-    wellKnownFull: string;
-  };
-  sitemap: {
-    enabled: boolean;
-    xml: {
-      enabled: boolean;
-      route: string;
-      api: string;
-      defaultRoute: string;
-    };
-    markdown: {
-      enabled: boolean;
-      route: string;
-      docsRoute: string | undefined;
-      wellKnownRoute: string;
-      api: string;
-      defaultRoute: string;
-      defaultDocsRoute: string;
-      defaultWellKnownRoute: string;
-    };
-  };
-  robots: {
-    enabled: boolean;
-    route: string;
-    defaultRoute: string;
-  };
-  structuredData: {
-    enabled: boolean;
-    format: string;
-    schema: string;
-    fields: string[];
-    canonicalUrlField: string;
-    breadcrumbType: string;
-    agentContractType: string;
-  };
-  openapi: {
-    enabled: boolean;
-    url: string | null;
-    source: "generated" | "configured" | null;
-    specUrl: string | null;
-    apiReferencePath: string | null;
-    format: string;
-  };
-  search: {
-    enabled: boolean;
-    endpoint: string;
-    method: string;
-    queryParam: string;
-    localeParam: string;
-  };
-  agents: {
-    enabled: boolean;
-    file: string;
-    route: string;
-    wellKnown: string;
-    api: string;
-    generatedFallback: boolean;
-    aliases: string[];
-  };
-  skills: {
-    enabled: boolean;
-    file: string;
-    route: string;
-    wellKnown: string;
-    api: string;
-    generatedFallback: boolean;
-    registry: string;
-    install: string;
-    discovery: {
-      schema: string;
-      index: string;
-      artifact: string;
-      archive: string;
-      file: string;
-      legacyIndex: string;
-      apiIndex: string;
-      apiArtifact: string;
-      apiFile: string;
-      digest: string;
-    };
-    published: {
-      name: string;
-      description: string;
-      type: "skill-md" | "archive";
-      url: string;
-      digest: `sha256:${string}`;
-      files: {
-        path: string;
-        url: string;
-        digest: `sha256:${string}`;
-      }[];
-    }[];
-    recommended: {
-      name: string;
-      description: string;
-    }[];
-  };
-  mcp: {
-    protectedResource?: {
-      metadataEndpoints: string[];
-      authorizationServers: string[];
-      scopesSupported: string[];
-      requiredScopes: string[];
-    } | undefined;
-    enabled: boolean;
-    endpoint: string;
-    defaultEndpoint: string;
-    publicEndpoint: string;
-    wellKnownEndpoint: string;
-    publicEndpoints: string[];
-    canonicalEndpoint: string;
-    name: string;
-    version: string;
-    tools: {
-      listDocs: boolean;
-      listPages: boolean;
-      readPage: boolean;
-      listTasks?: boolean;
-      readTask?: boolean;
-      searchDocs: boolean;
-      getNavigation: boolean;
-      getCodeExamples: boolean;
-      getConfigSchema: boolean;
-      getContext: boolean;
-    };
-  };
-  feedback: {
-    enabled: boolean;
-    schema: string;
-    submit: string;
-    schemaQuery: string;
-    submitQuery: string;
-  };
-  instructions: {
-    preferMarkdownRoutes: boolean;
-    useMcpWhenAvailable: boolean;
-    useOpenApiWhenAvailable: boolean;
-    readFeedbackSchemaBeforeSubmitting: boolean;
-    doNotAssumeFeedbackPayloadShape: boolean;
-  };
-};
-declare function acceptsDocsMarkdown(request: Request): boolean;
-declare function resolveDocsOpenApiDiscoveryConfig(openapi?: boolean | DocsOpenApiDiscoveryConfig): DocsOpenApiResolvedDiscoveryConfig;
-//#endregion
-//#region src/robots.d.ts
-declare const DEFAULT_ROBOTS_TXT_ROUTE = "/robots.txt";
-declare const DOCS_ROBOTS_GENERATED_BLOCK_START = "# BEGIN @farming-labs/docs robots";
-declare const DOCS_ROBOTS_GENERATED_BLOCK_END = "# END @farming-labs/docs robots";
-declare const DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS: readonly ["GPTBot", "ChatGPT-User", "OAI-SearchBot", "ClaudeBot", "Claude-User", "anthropic-ai", "CCBot", "Google-Extended"];
-interface DocsRobotsResolvedConfig {
-  enabled: boolean;
-  path?: string;
-  baseUrl?: string;
-  ai: "allow" | "disallow";
-  userAgents: string[];
-  extraRules: DocsRobotsRule[];
-}
-interface DocsRobotsRenderOptions {
-  entry?: string;
-  /** Include the RFC 9727 catalog route only when the deployment actually serves it. */
-  apiCatalog?: boolean;
-  /** Include an A2A Agent Card only when a real A2A service is configured. */
-  agentCard?: boolean;
-  sitemap?: boolean | DocsSitemapConfig;
-  baseUrl?: string;
-  robots?: boolean | DocsRobotsConfig;
-}
-interface DocsRobotsAnalysis {
-  blocksAgentRoutes: boolean;
-  blocksAiAgents: boolean;
-  hasAgentRoutes: boolean;
-  hasAiPolicy: boolean;
-  missingRoutes: string[];
-}
-interface CreateDocsRobotsResponseOptions extends DocsRobotsRenderOptions {
-  request: Request;
-}
-declare function resolveDocsRobotsConfig(input: boolean | DocsRobotsConfig | undefined, options?: {
-  baseUrl?: string;
-}): DocsRobotsResolvedConfig;
-declare function getDocsRobotsAllowRoutes(options?: DocsRobotsRenderOptions): string[];
-declare function renderDocsRobotsTxt(options?: DocsRobotsRenderOptions): string;
-declare function resolveDocsRobotsRequest(url: URL, robots?: boolean | DocsRobotsConfig): "robots" | null;
-declare function createDocsRobotsResponse({
-  request,
-  ...options
-}: CreateDocsRobotsResponseOptions): Response | null;
-declare function renderDocsRobotsGeneratedBlock(options?: DocsRobotsRenderOptions): string;
-declare function upsertDocsRobotsGeneratedBlock(existing: string, block: string): string;
-declare function analyzeDocsRobotsTxt(content: string, options?: DocsRobotsRenderOptions): DocsRobotsAnalysis;
-//#endregion
-export { AGENT_SKILLS_DISCOVERY_SCHEMA_URI, type AIConfig, API_CATALOG_MEDIA_TYPE, API_CATALOG_PROFILE_URI, type AgentFeedbackConfig, type AlgoliaDocsSearchConfig, type ApiReferenceConfig, type ApiReferenceRenderer, type BreadcrumbConfig, type ChangelogConfig, type ChangelogEntrySummary, type ChangelogFrontmatter, type CodeBlockCopyData, type CopyMarkdownConfig, type CopyMarkdownFormat, type CreateDocsStandardsResponseOptions, type CustomDocsSearchConfig, DEFAULT_A2A_AGENT_CARD_FORMAT, DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENTS_MD_ROUTE, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA, DEFAULT_AGENT_FEEDBACK_ROUTE, DEFAULT_AGENT_MD_ROUTE, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_INDEX_FORMAT, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT, DEFAULT_AGENT_SKILL_FILE_FORMAT, DEFAULT_AGENT_SKILL_FORMAT, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT, DEFAULT_AGENT_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_API_CATALOG_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_ROBOTS_TXT_ROUTE, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_AGENT_CONTRACT_VERSION, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DOCS_ROBOTS_GENERATED_BLOCK_END, DOCS_ROBOTS_GENERATED_BLOCK_START, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN, type DocsA2AAgentCard, type DocsA2AAgentCardOptions, type DocsAgentA2AConfig, type DocsAgentAdapter, type DocsAgentCompactConfig, type DocsAgentConfig, type DocsAgentConformanceCaseResult, type DocsAgentConformanceReport, type DocsAgentContractCase, type DocsAgentContractExpectation, type DocsAgentContractMcpTools, type DocsAgentContractRequest, type DocsAgentContractSurface, type DocsAgentDiscoverySpecOptions, type DocsAgentEvaluationAnswerInput, type DocsAgentEvaluationAnswerProvider, type DocsAgentEvaluationAnswerRequest, type DocsAgentEvaluationAnswerResult, type DocsAgentEvaluationAnswerRunner, type DocsAgentEvaluationSourceReference, type DocsAgentEvaluationSurface, type DocsAgentEvaluationTaskInput, type DocsAgentEvaluationsConfig, type DocsAgentFeedbackContext, type DocsAgentFeedbackData, type DocsAgentFeedbackDiscoveryConfig, type DocsAgentFeedbackRequest, type DocsAgentFeedbackResolvedConfig, type DocsAgentGoldenAnswerExpectation, type DocsAgentGoldenExampleVerification, type DocsAgentGoldenExpectedExample, type DocsAgentGoldenTask, type DocsAgentGoldenTaskExpectation, type DocsAgentGoldenTaskFilters, type DocsAgentSkillIndexEntry, type DocsAgentSkillsConfig, type DocsAgentSkillsIndex, type DocsAgentSkillsInput, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAgentsDocumentOptions, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAnalyticsEventType, type DocsAnalyticsInput, type DocsAnalyticsSource, type DocsApiCatalog, type DocsApiCatalogLinkContext, type DocsApiCatalogLinkTarget, type DocsApiCatalogOptions, type DocsAskAIActionData, type DocsAskAIActionType, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsAudienceMdxIssue, type DocsCloudApiKeyConfig, type DocsCloudConfig, type DocsCloudFeatureConfig, type DocsCloudPreviewConfig, type DocsCloudPublishConfig, type DocsCodeBlocksConfig, type DocsCodeBlocksPlannerConfig, type DocsCodeBlocksPlannerProvider, type DocsCodeBlocksRunnerConfig, type DocsCodeBlocksRunnerProvider, type DocsCodeBlocksValidateConfig, type DocsCodeBlocksValidationMode, type DocsCodeBlocksValidationPolicy, type DocsConfig, type DocsConfigMap, type DocsConfigMapJsonValue, type DocsConfigMapPointer, type DocsContentAudience, type DocsDiagnostics, type DocsDiagnosticsFeature, type DocsDiagnosticsIssue, type DocsDiagnosticsIssueSeverity, type DocsDiagnosticsOptions, type DocsDiagnosticsStatus, type DocsDiscoveryApiRouteOptions, type DocsFeedbackData, type DocsFeedbackValue, type DocsI18nConfig, type DocsLlmsDiscoveryConfig, type DocsLlmsTxtGeneratedContent, type DocsLlmsTxtGeneratedSection, type DocsLlmsTxtMaxCharsIssue, type DocsLlmsTxtPageInput, type DocsLlmsTxtRequest, type DocsLlmsTxtResolvedMaxChars, type DocsLlmsTxtResolvedSection, type DocsLlmsTxtSelectedContent, type DocsMarkdownAgentDetection, type DocsMarkdownPage, type DocsMarkdownRecoveryMatch, type DocsMarkdownRecoveryResult, type DocsMarkdownResponseOptions, type DocsMcpAllowedOrigins, type DocsMcpAuthPrincipal, type DocsMcpAuthenticate, type DocsMcpAuthenticateContext, type DocsMcpAuthenticateResult, type DocsMcpConfig, type DocsMcpCorsConfig, type DocsMcpEndpointCandidate, type DocsMcpEndpointCandidateOptions, type DocsMcpOriginContext, type DocsMcpProtectedResourceConfig, type DocsMcpSecurityConfig, type DocsMcpToolsConfig, type DocsMetadata, type DocsNav, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsOpenApiDiscoveryConfig, type DocsOpenApiResolvedDiscoveryConfig, type DocsPageStructuredDataInput, type DocsPathMatch, type DocsPublishedAgentSkill, type DocsPublishedAgentSkillFile, type DocsPublishedAgentSkillOptions, type DocsRelatedItem, type DocsReviewCiConfig, type DocsReviewCiMode, type DocsReviewConfig, type DocsReviewRulesConfig, type DocsReviewScoreConfig, type DocsReviewSeverity, type DocsRobotsConfig, type DocsRobotsRenderOptions, type DocsRobotsResolvedConfig, type DocsRobotsRule, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchChunkingConfig, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchEmbeddingsConfig, type DocsSearchQuery, type DocsSearchResult, type DocsSearchResultType, type DocsSearchSourcePage, type DocsSitemapConfig, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type DocsSkillDocumentOptions, type DocsStandardsDiscoveryRequest, type DocsStandardsDiscoveryResponseOptions, type DocsStandardsDiscoveryRouteOptions, type DocsStructuredDataBreadcrumb, type DocsTelemetryAgentSurface, type DocsTelemetryAgentSurfaceContext, type DocsTelemetryAgentSurfaceRequestOptions, type DocsTelemetryConfig, type DocsTelemetryContext, type DocsTelemetryEvent, type DocsTelemetryEventInput, type DocsTelemetryEventType, type DocsTelemetryFeatures, type DocsTelemetryFramework, type DocsTheme, type FeedbackConfig, type FontStyle, GENERATED_AGENT_PROVENANCE_MARKER, GENERATED_AGENT_PROVENANCE_VERSION, type GeneratedAgentProvenance, type GeneratedAgentSourceKind, type GithubConfig, type LastUpdatedConfig, type LlmsTxtConfig, type LlmsTxtMaxCharsConfig, type LlmsTxtMaxCharsMode, type LlmsTxtSectionConfig, type McpDocsSearchConfig, type OGConfig, type OpenDocsConfig, type OpenDocsProvider, type OpenDocsProviderConfig, type OpenDocsProviderId, type OpenDocsTarget, type OpenGraphImage, type OrderingItem, PAGE_AGENT_CONTRACT_END_MARKER, PAGE_AGENT_CONTRACT_FIELDS, PAGE_AGENT_CONTRACT_FIELD_SCHEMA, PAGE_AGENT_CONTRACT_START_MARKER, PAGE_AGENT_STRUCTURED_CONTRACT_FIELDS, type PageActionsConfig, type PageAgentAppliesTo, type PageAgentCommand, type PageAgentFailureMode, type PageAgentFrontmatter, type PageAgentFrontmatterIssue, type PageAgentVerification, type PageFrontmatter, type PageOpenGraph, type PageSidebarFrontmatter, type PageTwitter, type PromptAction, type PromptProviderChoice, type ReadingTimeConfig, type ReadingTimeFormat, type ResolvedChangelogConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsI18n, type ResolvedDocsObservabilityConfig, type ResolvedDocsRelatedLink, type ResolvedDocsTelemetryConfig, type RunDocsAgentConformanceOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, type SidebarComponentProps, type SidebarConfig, type SidebarFolderIndexBehavior, type SidebarFolderNode, type SidebarNode, type SidebarPageNode, type SidebarTree, type SimpleDocsSearchConfig, type ThemeToggleConfig, type TypesenseDocsSearchConfig, type TypographyConfig, type UIConfig, acceptsDocsMarkdown, analyzeDocsRobotsTxt, appendDocsDiscoveryLinkHeader, applySidebarFolderIndexBehavior, buildDocsA2AAgentCard, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsAgentSkillsIndex, buildDocsApiCatalog, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsLegacySkillsIndex, buildDocsMcpEndpointCandidates, buildDocsMcpProtectedResourceMetadataRoute, buildDocsPageStructuredData, buildDocsSearchDocuments, buildDocsSitemapManifest, buildPageOpenGraph, buildPageTwitter, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentContractCases, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, createDocsStandardsResponse, createMcpSearchAdapter, createSimpleSearchAdapter, createTheme, createTypesenseSearchAdapter, deepMerge, defineDocs, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryEvent, emitDocsTelemetryMcpToolEvent, emitDocsTelemetryProjectEvent, estimateReadingTimeMinutes, extendTheme, findDocsAudienceMdxIssues, findDocsMarkdownPage, formatDocsAskAIPackageHints, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, getDocsMcpProtectedResourceMetadataRoutes, getDocsMcpResourcePaths, getDocsRequestAnalyticsProperties, getDocsRobotsAllowRoutes, getDocsTelemetryFeatures, getPageAgentFrontmatterIssues, hasDocsMarkdownSignatureAgent, hasDocsMcpProtectedResourceConfig, hasStructuredPageAgentContract, hashGeneratedAgentContent, inferDocsAskAIPackageHints, inferDocsTelemetryAgentSurface, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, isLocalDocsTelemetryOrigin, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, normalizeDocsRelated, normalizeDocsTelemetryOrigin, normalizeDocsUrlPath, normalizeGeneratedAgentContent, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, parseGeneratedAgentDocument, performDocsSearch, readDocsSitemapManifestFromContentMap, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsPageStructuredDataJson, renderDocsRelatedMarkdownLines, renderDocsRobotsGeneratedBlock, renderDocsRobotsTxt, renderDocsSitemapMarkdown, renderDocsSitemapXml, renderDocsSkillDocument, renderPageAgentContractMarkdown, renderPageAgentFrontmatterYamlLines, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentMdxContent, resolveDocsAgentsFormat, resolveDocsAnalyticsConfig, resolveDocsAudienceExposure, resolveDocsAudienceMdxContent, resolveDocsDiscoveryApiRoute, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRecovery, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsObservabilityConfig, resolveDocsOpenApiDiscoveryConfig, resolveDocsPath, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRobotsConfig, resolveDocsRobotsRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolveDocsSkillFormat, resolveDocsStandardsDiscoveryRequest, resolveDocsTelemetryConfig, resolveOGImage, resolvePageReadingTime, resolvePageSidebarFolderIndexBehavior, resolveReadingTimeFromContent, resolveReadingTimeFromSource, resolveReadingTimeOptions, resolveSearchRequestConfig, resolveSidebarFolderIndexBehavior, resolveSidebarFolderIndexBehaviorForPath, resolveTitle, runDocsAgentConformance, selectDocsLlmsTxtContent, serializeGeneratedAgentDocument, sha256DocsDiscoveryContent, stripGeneratedAgentProvenance, stripGeneratedPageAgentContractMarkdown, toDocsMarkdownUrl, toDocsSitemapMarkdownUrl, upsertDocsRobotsGeneratedBlock, upsertPageAgentContractMarkdown, validateDocsAgentFeedbackPayload };