@farming-labs/docs 0.2.104 → 0.2.105

package/dist/{agent-C9IdC__R.d.mts → content-change-hydration-CoYRs3pC.d.mts}

@@ -1,6 +1,6 @@
-import { $n as DocsSearchFilterInput, Ar as LlmsTxtSectionConfig, Cn as DocsPaginatedSearchResponse, Cr as FeedbackConfig, Dr as LlmsTxtConfig, F as DocsAgentContentChangesConfig, Fn as DocsSearchAdapter, Gt as DocsContentSnapshot, Hn as DocsSearchChunkingConfig, K as DocsAgentFeedbackData, Ln as DocsSearchAdapterFactory, Nn as DocsRobotsConfig, Or as LlmsTxtMaxCharsConfig, Qn as DocsSearchFilterField, Rt as DocsConfig, Un as DocsSearchConfig, Wn as DocsSearchDocument, Wt as DocsContentChangesResponse, Yn as DocsSearchFacetsResponse, Yt as DocsI18nConfig, di as TypesenseDocsSearchConfig, dr as DocsSearchSourcePage, er as DocsSearchFilters, f as CustomDocsSearchConfig, jr as McpDocsSearchConfig, kr as LlmsTxtMaxCharsMode, lr as DocsSearchResult, mn as DocsOkfConfig, mr as DocsSitemapConfig, qr as PageAgentFrontmatter, r as AlgoliaDocsSearchConfig, sr as DocsSearchRequest, ti as ResolvedDocsRelatedLink, tn as DocsMcpConfig, vn as DocsOkfTrustMetadataInput, wt as DocsAskAIMcpConfig } from "./types-BthCiAD9.mjs";
-import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-Cqq8QmlH.mjs";
-import { t as DocsContentAudience } from "./audience-exposure-BW13cI2O.mjs";
+import { Ar as LlmsTxtConfig, Bn as DocsSearchAdapterFactory, Bt as DocsConfig, En as DocsPaginatedSearchResponse, Er as FeedbackConfig, Et as DocsAskAIMcpConfig, Gn as DocsSearchChunkingConfig, In as DocsRobotsConfig, J as DocsAgentFeedbackData, Kn as DocsSearchConfig, Kt as DocsContentChangesResponse, L as DocsAgentContentChangesConfig, Mr as LlmsTxtMaxCharsMode, Nr as LlmsTxtSectionConfig, Pr as McpDocsSearchConfig, Qn as DocsSearchFacetsResponse, Rn as DocsSearchAdapter, Tn as DocsPageAccessPolicy, Xr as PageAgentFrontmatter, Zt as DocsI18nConfig, _r as DocsSitemapConfig, bn as DocsOkfTrustMetadataInput, f as CustomDocsSearchConfig, fr as DocsSearchResult, gn as DocsOkfConfig, ii as ResolvedDocsRelatedLink, jr as LlmsTxtMaxCharsConfig, m as DocsAccessPrincipal, mi as TypesenseDocsSearchConfig, mr as DocsSearchSourcePage, nr as DocsSearchFilterInput, qn as DocsSearchDocument, qt as DocsContentSnapshot, r as AlgoliaDocsSearchConfig, rn as DocsMcpConfig, rr as DocsSearchFilters, tr as DocsSearchFilterField, ur as DocsSearchRequest } from "./types-QhYMnKvb.mjs";
+import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-Xm84bS4M.mjs";
+import { t as DocsContentAudience } from "./audience-exposure-CkNZNeVX.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig, DocsMcpResolvedPromptsConfig } from "./mcp.mjs";
 
 //#region src/i18n.d.ts
@@ -18,6 +18,17 @@ declare function resolveDocsI18n(config?: DocsI18nConfig | null): ResolvedDocsI1
 declare function resolveDocsLocale(searchParams: URLSearchParams, i18n?: ResolvedDocsI18n | null): string | undefined;
 declare function resolveDocsPath(pathname: string, entry: string): DocsPathMatch;
 //#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/audience.d.ts
 interface DocsMarkdownPromptBlock {
   /** Raw JSX attributes between the Prompt name and opening bracket. */
@@ -59,714 +70,377 @@ declare function resolveDocsAudienceMdxContent(content: string, audience: DocsCo
 /** Backwards-compatible name retained for existing integrations. */
 declare function resolveDocsAgentMdxContent(content: string, audience: DocsContentAudience): string;
 //#endregion
-//#region src/search.d.ts
-interface DocsAskAIContextResult extends DocsSearchResult {
-  title: string;
-  contextContent: string;
+//#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_MARKDOWN_SECTION_INDEX_FORMAT = "docs-markdown-sections.v2";
+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 DocsAskAIContext {
-  context: string;
-  /** Structured production context blocks; avoids reparsing markdown horizontal rules. */
-  blocks: Array<{
-    text: string;
-    result: DocsAskAIContextResult;
-  }>;
-  results: DocsAskAIContextResult[];
-  searchResults: DocsSearchResult[];
-  packageHints: DocsAskAIPackageHints;
+interface DocsMcpEndpointCandidateOptions {
+  includeOriginFallback?: boolean;
+  includeRootDomainFallback?: boolean;
+  includeMcpSubdomainFallback?: boolean;
 }
-interface DocsAskAIPackageHints {
-  packages: string[];
-  imports: string[];
-  installCommands: string[];
+interface DocsAgentFeedbackResolvedConfig {
+  enabled: boolean;
+  route: string;
+  schemaRoute: string;
+  payloadSchema: Record<string, unknown>;
+  schema: Record<string, unknown>;
+  onFeedback?: (data: DocsAgentFeedbackData) => void | Promise<void>;
 }
-/** Normalize scalar or array-valued scope filters for programmatic, HTTP, and MCP callers. */
-declare function normalizeDocsSearchFilters(input?: DocsSearchFilterInput | DocsSearchFilters): DocsSearchFilters;
-/** Parse the public search scope parameters from a URL query string. */
-declare function resolveDocsSearchFilters(searchParams: URLSearchParams): DocsSearchFilters;
-declare class DocsSearchRequestError extends Error {
-  readonly code = "invalid_search_request";
-  constructor(message: string);
+interface DocsAgentFeedbackRequest {
+  kind: "schema" | "submit";
 }
-declare function resolveDocsSearchError(error: unknown): {
-  code: "invalid_cursor" | "invalid_search_request";
-  message: string;
-} | undefined;
-/** Resolve search filters and the backwards-compatible structured response opt-in. */
-declare function resolveDocsSearchRequest(searchParams: URLSearchParams): DocsSearchRequest;
-declare function inferDocsAskAIPackageHints(content: string): DocsAskAIPackageHints;
-declare function formatDocsAskAIPackageHints(hints: DocsAskAIPackageHints, packageName?: string): string | undefined;
-/**
- * Build the exact normalized-input projection represented by a retrieval source digest.
- * This is public so consumers can independently reproduce `source.digest`.
- */
-declare function buildDocsRetrievalDigestProjection(page: DocsSearchSourcePage, audience?: DocsContentAudience): string;
-declare function resolveDocsRetrievalLastModified(page: DocsSearchSourcePage, audience: DocsContentAudience): string | undefined;
-interface BuildDocsContentSnapshotOptions {
-  pages: readonly DocsSearchSourcePage[];
-  search?: boolean | DocsSearchConfig;
-  audience?: DocsContentAudience;
-  locale?: string;
-  baseUrl?: string;
-  /** @internal Precomputed complete-corpus generation for composed callers. */
-  indexGeneration?: string;
+interface DocsAgentFeedbackDiscoveryConfig {
+  enabled?: boolean;
+  route?: string;
+  schemaRoute?: string;
 }
-/**
- * Build a deterministic, body-free inventory for content-change synchronization.
- *
- * Its generation is identical to structured search for the same pages, audience,
- * locale, base URL, and chunking policy.
- */
-declare function buildDocsContentSnapshot(options: BuildDocsContentSnapshotOptions): Promise<DocsContentSnapshot>;
-interface EnrichDocsSearchDocumentsWithProvenanceOptions {
-  documents: readonly DocsSearchDocument[];
-  pages: readonly DocsSearchSourcePage[];
-  audience?: DocsContentAudience;
-  chunking?: DocsSearchChunkingConfig;
-  locale?: string;
+interface DocsLlmsDiscoveryConfig extends DocsDiscoveryApiRouteOptions {
+  enabled?: boolean;
+  /** Whether this deployment actually serves the RFC 9727 API catalog. Defaults to true. */
+  apiCatalog?: boolean;
   baseUrl?: string;
-  indexGeneration?: string;
+  siteTitle?: string;
+  siteDescription?: string;
+  maxChars?: LlmsTxtMaxCharsConfig;
+  sections?: LlmsTxtSectionConfig[];
+  openapi?: boolean | DocsOpenApiDiscoveryConfig;
 }
-/**
- * Attach the same canonical provenance used by built-in search providers.
- * Custom adapters can call this before persisting their own hosted records.
- */
-declare function enrichDocsSearchDocumentsWithProvenance(options: EnrichDocsSearchDocumentsWithProvenanceOptions): Promise<DocsSearchDocument[]>;
-declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig, audience?: DocsContentAudience): DocsSearchDocument[];
-declare function createSimpleSearchAdapter(): DocsSearchAdapter;
-declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
-declare function resolveSearchRequestConfig(search: boolean | DocsSearchConfig | undefined, requestUrl?: string, options?: DocsSearchRequestResolutionOptions): boolean | DocsSearchConfig | undefined;
-interface DocsLocalMcpSearchRuntimeConfig {
+interface DocsOpenApiDiscoveryConfig {
   enabled?: boolean;
-  route?: string;
-  tools?: {
-    searchDocs?: boolean;
-  };
+  url?: string;
+  /** Whether `url` came from the framework default or explicit configuration. */
+  urlSource?: "default" | "configured";
+  source?: "generated" | "configured";
+  specUrl?: string;
+  apiReferencePath?: string;
+  /** Product API targets described by this OpenAPI document. */
+  catalogTargets?: readonly string[];
 }
-type DocsLocalMcpSearchRuntimeInput = boolean | DocsLocalMcpSearchRuntimeConfig | null | undefined;
-interface DocsSearchRequestResolutionOptions {
-  /**
-   * The built-in MCP server colocated with this search handler. When the configured
-   * provider points at one of its local aliases, search runs directly instead of
-   * performing a loopback MCP handshake.
-   */
-  localMcp?: DocsLocalMcpSearchRuntimeInput;
+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;
+  /** Product API targets described by this OpenAPI document. */
+  catalogTargets?: readonly string[];
 }
-declare function resolveLocalDocsMcpSearchConfig(search: boolean | DocsSearchConfig | undefined, localMcp: DocsLocalMcpSearchRuntimeInput, requestUrl?: string): boolean | DocsSearchConfig | undefined;
-/**
- * Resolve the public search audience without allowing malformed values to opt into agent content.
- * Human search remains the default for omitted, legacy, and unknown query values.
- */
-declare function resolveDocsSearchAudience(value: string | null | undefined): DocsContentAudience;
-declare function resolveAskAISearchRequestConfig(options: {
-  search: boolean | DocsSearchConfig | undefined;
-  useMcp?: boolean | DocsAskAIMcpConfig;
-  mcpEndpoint?: string;
-  mcpEnabled?: boolean;
-  mcpSearchEnabled?: boolean;
-  requestUrl?: string;
-}): boolean | DocsSearchConfig | undefined;
-declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearchAdapter;
-declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
-interface PerformDocsSearchOptions {
-  pages: DocsSearchSourcePage[];
-  /** @internal Complete corpus used for generation when `pages` is pre-scoped by a caller. */
-  generationPages?: DocsSearchSourcePage[];
-  /** @internal Precomputed complete-corpus generation for structured callers. */
-  indexGeneration?: string;
-  query: string;
-  search?: boolean | DocsSearchConfig;
-  /** Selects which audience projection is searchable. Public site search defaults to human. */
-  audience?: DocsContentAudience;
-  locale?: string;
-  pathname?: string;
-  siteTitle?: string;
-  /** Canonical docs URL used to distinguish same-site absolute hits from foreign MCP results. */
-  baseUrl?: string;
-  /**
-   * Canonical origin safe to persist in a hosted index. Pass `null` when `baseUrl`
-   * came from the current request rather than trusted configuration.
-   * @internal
-   */
-  syncBaseUrl?: string | null;
-  limit?: number;
-  /** Opaque continuation cursor used by structured search responses. */
-  cursor?: string;
-  /** Optional framework, version, package, and tag constraints. */
-  filters?: DocsSearchFilterInput;
-  /** Include bounded explanations for the final ranked results. Defaults to false. */
-  explain?: boolean;
-  /**
-   * Controls provider failures. Runtime search keeps the resilient `fallback` default;
-   * diagnostics can request `throw` so a broken configured provider cannot be scored as
-   * successful simple search.
-   */
-  failureMode?: "fallback" | "throw";
-  /**
-   * Whether non-simple provider hits are supplemented with exact/local simple results.
-   * Runtime search defaults to true; provider diagnostics can disable supplementation.
-   */
-  supplementExternalResults?: boolean;
-  /** Keep absolute provider origins distinct when no canonical docs origin is available. */
-  strictExternalOrigins?: boolean;
-  /** Optional cancellation signal forwarded to adapters and their managed requests. */
-  signal?: AbortSignal;
+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;
 }
-declare function performDocsSearch(options: PerformDocsSearchOptions): Promise<DocsSearchResult[]>;
-interface BuildDocsSearchFacetsOptions {
-  pages: DocsSearchSourcePage[];
-  search?: boolean | DocsSearchConfig;
-  audience?: DocsContentAudience;
-  locale?: string;
-  baseUrl?: string;
-  filters?: DocsSearchFilterInput;
-  /** Facet field selected for cursor continuation. */
-  facet?: DocsSearchFilterField;
-  /** Opaque `nextCursor` returned for the selected facet. */
-  cursor?: string;
-  /** Maximum facet values returned per page. Defaults to 100. */
-  limit?: number;
-  /** @internal Precomputed complete-corpus generation for composed callers. */
-  indexGeneration?: 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>;
 }
-/**
- * Build a body-free index of valid search filter values and page counts.
- *
- * Each facet applies filters from the other fields while ignoring its own selected
- * values. This is the conventional faceted-search behavior and lets an agent discover
- * safe alternatives without guessing or fetching document bodies.
- */
-declare function buildDocsSearchFacets(options: BuildDocsSearchFacetsOptions): Promise<DocsSearchFacetsResponse>;
-declare function performDocsSearchWithMetadata(options: PerformDocsSearchOptions): Promise<DocsPaginatedSearchResponse>;
-declare function buildDocsAskAIContext(options: {
-  pages: DocsSearchSourcePage[];
-  query: string;
-  search?: boolean | DocsSearchConfig;
-  locale?: string;
-  pathname?: string;
-  siteTitle?: string;
-  baseUrl?: string; /** See `performDocsSearch.syncBaseUrl`. */
-  syncBaseUrl?: string | null;
-  limit?: number;
-  filters?: DocsSearchFilterInput;
-  maxContextChars?: number;
-  maxResultChars?: number; /** See `performDocsSearch.failureMode`. Defaults to resilient runtime fallback. */
-  searchFailureMode?: "fallback" | "throw"; /** See `performDocsSearch.strictExternalOrigins`. */
-  strictExternalOrigins?: boolean; /** Optional cancellation signal forwarded to the configured search provider. */
-  signal?: AbortSignal;
-}): Promise<DocsAskAIContext>;
-declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory, options?: {
-  paginationRevision?: string;
-}): CustomDocsSearchConfig;
-//#endregion
-//#region src/content-changes.d.ts
-declare const DOCS_CONTENT_CHANGES_FORMAT = "docs-content-changes.v1";
-declare const DOCS_CONTENT_SNAPSHOT_FORMAT = "docs-content-snapshot.v1";
-declare const DOCS_CONTENT_CHANGES_RESPONSE_VALUE = "changes";
-/** Whether a value is a valid content-index generation identifier. */
-declare function isDocsContentChangeGeneration(value: string): boolean;
-interface DocsContentChangesRequest {
-  audience: "human" | "agent";
-  since?: string;
+type DocsDiagnosticsStatus = "enabled" | "disabled";
+type DocsDiagnosticsIssueSeverity = "warning" | "error";
+interface DocsDiagnosticsIssue {
+  severity: DocsDiagnosticsIssueSeverity;
+  code: string;
+  path?: string;
+  message: string;
 }
-interface DocsResolvedContentChangesConfig {
-  enabled: boolean;
-  maxSnapshots: number;
-  loadSnapshot?: DocsAgentContentChangesConfig["loadSnapshot"];
-  saveSnapshot?: DocsAgentContentChangesConfig["saveSnapshot"];
+interface DocsDiagnosticsFeature {
+  status: DocsDiagnosticsStatus;
+  reason?: string;
+  route?: string | null;
+  routes?: Record<string, string | null>;
+  agentEndpoint?: string | null;
+  structuredAgentEndpoint?: string | null;
+  explainedAgentEndpoint?: string | null;
+  facetsEndpoint?: string | null;
+  audienceParam?: string;
+  defaultAudience?: "human" | "agent";
+  supportedAudiences?: Array<"human" | "agent">;
+  filterParams?: {
+    framework: "framework";
+    version: "version";
+    package: "package";
+    tags: "tags";
+  };
+  responseFormat?: "docs-search.v1";
+  explainParam?: "explain";
+  explainValue?: "true";
+  explanationField?: "explanation";
+  explanationFormat?: "docs-search-explanation.v1";
+  facetsResponseFormat?: "docs-search-facets.v1";
+  format?: string;
+  sinceParam?: string;
+  generationField?: string;
+  resetRequiredField?: string;
+  warningsField?: "warnings";
+  /** Facet field selected for facet-value continuation. */
+  facetParam?: "facet";
+  /** Page-size parameter accepted by structured search and facet discovery. */
+  limitParam?: "limit";
+  /** Opaque continuation token accepted by structured search and facet discovery. */
+  cursorParam?: "cursor";
+  /** Optional continuation token returned when another result page is available. */
+  nextCursorField?: "nextCursor";
+  /** Boolean structured-response field indicating whether another page is available. */
+  hasMoreField?: "hasMore";
+  /** Structured-response field containing the total matches across all pages. */
+  totalField?: "total";
+  provider?: string;
+  mode?: string;
+  transport?: "GET" | "POST" | "GET/HEAD" | "GET/POST";
+  tools?: Record<string, boolean>;
+  prompts?: DocsMcpResolvedConfig["prompts"];
+  human?: boolean;
+  agent?: boolean;
 }
-interface ResolveDocsContentChangesOptions extends Omit<BuildDocsContentSnapshotOptions, "pages"> {
-  pages: readonly DocsSearchSourcePage[];
-  since?: string;
-  request?: Request;
+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;
+    agentSearch: string | null;
+    contentChanges: 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;
+    contentChanges: 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 DocsContentChangeFeed {
-  resolve(options: ResolveDocsContentChangesOptions): Promise<DocsContentChangesResponse>;
+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;
 }
-declare class DocsContentChangesRequestError extends Error {
-  readonly code = "invalid_content_changes_request";
-  constructor(message: string);
+interface DocsLlmsTxtResolvedMaxChars {
+  mode: LlmsTxtMaxCharsMode;
+  chars: number;
 }
-declare function resolveDocsContentChangesConfig(input?: boolean | DocsAgentContentChangesConfig, options?: {
-  staticExport?: boolean;
-}): DocsResolvedContentChangesConfig;
-declare function isDocsContentChangesRequest(url: URL): boolean;
-declare function resolveDocsContentChangesRequest(url: URL): DocsContentChangesRequest;
-declare function createDocsContentChangeFeed(input?: boolean | DocsAgentContentChangesConfig): DocsContentChangeFeed;
-declare function createDocsContentChangesHttpResponse(options: {
-  request: Request;
-  feed: DocsContentChangeFeed;
-  pages: readonly DocsSearchSourcePage[];
-  search?: boolean | DocsSearchConfig;
-  locale?: string;
-  baseUrl?: string;
-}): Promise<Response>;
-//#endregion
-//#region src/content-change-hydration.d.ts
-declare const DOCS_CONTENT_CHANGE_HYDRATION_FORMAT = "docs-content-change-hydration.v1";
-declare const DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 5000;
-declare const MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 4;
-declare const MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 32000;
-interface DocsContentChangeHydrationSection {
-  id: string;
-  heading: string;
-  level: number;
+interface DocsLlmsTxtResolvedSection {
+  title: string;
+  description?: string;
+  match: string[];
+  route: string;
+  fullRoute: string;
+  maxChars: DocsLlmsTxtResolvedMaxChars;
 }
-interface DocsContentChangeHydrationContent {
-  type: "content";
-  change: "added" | "changed";
+interface DocsLlmsTxtRequest {
+  format: "llms" | "llms-full";
+  section?: DocsLlmsTxtResolvedSection;
+}
+interface DocsLlmsTxtPageInput {
   url: string;
-  canonicalUrl: string;
-  /** Digest from the body-free document change feed. */
-  digest: string;
-  previousDigest?: string;
-  lastModified?: string;
-  previousLastModified?: string;
-  section: DocsContentChangeHydrationSection;
-  /** Digest of the complete, non-overlapping section before chunking. */
-  sectionDigest: string;
-  /** Digest of the content bytes returned in this chunk. */
-  chunkDigest: string;
-  chunk: {
-    index: number;
-    count: number;
-  };
+  /** Override the Markdown link emitted in llms.txt. */
+  markdownUrl?: string;
+  title: string;
+  description?: string;
   content: string;
-  utf8Bytes: number;
+  rawContent?: string;
+  agentContent?: string;
+  agentRawContent?: string;
+  agentFallbackContent?: string;
+  agentFallbackRawContent?: string;
+  agent?: PageAgentFrontmatter;
 }
-interface DocsContentChangeHydrationTombstone {
-  type: "tombstone";
-  change: "deleted";
-  url: string;
-  canonicalUrl: string;
-  /** Last known digest for the deleted document. */
-  digest: string;
-  lastModified?: string;
-}
-interface DocsContentChangeHydrationBudget {
-  requestedTokens: number;
-  strategy: "utf8-bytes";
-  maxUtf8Bytes: number;
-  usedUtf8Bytes: number;
-  conservativeTokenUpperBound: number;
-  remainingUtf8Bytes: number;
-}
-interface DocsContentChangeHydrationResponse {
-  format: typeof DOCS_CONTENT_CHANGE_HYDRATION_FORMAT;
-  audience: "agent";
-  locale?: string;
-  since: string;
-  indexGeneration: string;
-  mode: DocsContentChangesResponse["mode"];
-  resetRequired: boolean;
-  documentCount: number;
-  counts: DocsContentChangesResponse["counts"];
-  budget: DocsContentChangeHydrationBudget;
-  resultCount: number;
-  total: number;
-  hasMore: boolean;
-  nextCursor?: string;
-  content: DocsContentChangeHydrationContent[];
-  tombstones: DocsContentChangeHydrationTombstone[];
+interface DocsLlmsTxtGeneratedSection extends DocsLlmsTxtResolvedSection {
+  llmsTxt: string;
+  llmsFullTxt: string;
 }
-interface HydrateDocsContentChangesOptions {
-  changes: DocsContentChangesResponse;
-  pages: readonly DocsSearchSourcePage[];
-  since: string;
-  tokenBudget?: number;
-  cursor?: string;
-  /** Stable MCP server identity mixed into opaque continuation cursors. */
-  cursorScope: string;
+interface DocsLlmsTxtGeneratedContent {
+  llmsTxt: string;
+  llmsFullTxt: string;
+  maxChars: DocsLlmsTxtResolvedMaxChars;
+  sections: DocsLlmsTxtGeneratedSection[];
 }
-/**
- * Hydrate only the current bodies named by a content-change delta.
- *
- * The conservative budget treats one UTF-8 byte as at most one token. Cursors are
- * bound to the requested generation, current generation, locale, and budget.
- */
-declare function hydrateDocsContentChanges(options: HydrateDocsContentChangesOptions): DocsContentChangeHydrationResponse;
-//#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_MARKDOWN_SECTION_INDEX_FORMAT = "docs-markdown-sections.v2";
-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;
+interface DocsLlmsTxtSelectedContent {
+  content: string;
   label: string;
+  maxChars: DocsLlmsTxtResolvedMaxChars;
 }
-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 DocsLlmsTxtMaxCharsIssue {
+  mode: Exclude<LlmsTxtMaxCharsMode, "off">;
+  chars: number;
+  actual: number;
+  label: string;
+  message: string;
 }
-interface DocsAgentFeedbackDiscoveryConfig {
-  enabled?: boolean;
-  route?: string;
-  schemaRoute?: 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;
+  /** Runtime metadata-only document synchronization feed. Defaults to enabled. */
+  contentChanges?: boolean | DocsAgentContentChangesConfig;
+  mcp: DocsMcpResolvedConfig;
+  feedback?: DocsAgentFeedbackDiscoveryConfig;
+  llms?: DocsLlmsDiscoveryConfig;
+  sitemap?: boolean | DocsSitemapConfig;
+  robots?: boolean | DocsRobotsConfig;
+  openapi?: boolean | DocsOpenApiDiscoveryConfig;
+  markdown?: {
+    acceptHeader?: boolean;
+    signatureAgentHeader?: boolean; /** Whether runtime Markdown routes support `?sections` metadata discovery. Defaults to true. */
+    sectionDiscovery?: 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 DocsLlmsDiscoveryConfig extends DocsDiscoveryApiRouteOptions {
-  enabled?: boolean;
+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;
-  baseUrl?: string;
-  siteTitle?: string;
-  siteDescription?: string;
-  maxChars?: LlmsTxtMaxCharsConfig;
-  sections?: LlmsTxtSectionConfig[];
+  search?: boolean | DocsSearchConfig;
+  /** Runtime metadata-only document synchronization feed. Defaults to enabled. */
+  contentChanges?: boolean | DocsAgentContentChangesConfig;
+  mcp: DocsMcpResolvedConfig;
+  feedback?: DocsAgentFeedbackDiscoveryConfig;
+  llms?: DocsLlmsDiscoveryConfig;
+  sitemap?: boolean | DocsSitemapConfig;
+  robots?: boolean | DocsRobotsConfig;
   openapi?: boolean | DocsOpenApiDiscoveryConfig;
+  markdown?: {
+    acceptHeader?: boolean;
+    signatureAgentHeader?: boolean; /** Whether runtime Markdown routes support `?sections` metadata discovery. Defaults to true. */
+    sectionDiscovery?: boolean;
+  };
 }
-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;
-  /** Product API targets described by this OpenAPI document. */
-  catalogTargets?: readonly string[];
+interface DocsAgentsDocumentOptions extends DocsSkillDocumentOptions {}
+interface DocsStandardsDiscoveryResponseOptions extends DocsAgentDiscoverySpecOptions {
+  request: Request;
+  preferredSkillDocument?: string | null;
+  fallbackSkillDocument: string;
+  /** Stable representation generation or source modification time. */
+  lastModified?: string | Date | null;
 }
-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;
-  /** Product API targets described by this OpenAPI document. */
-  catalogTargets?: readonly string[];
+interface DocsAgentContractMcpTools {
+  list?: "list_tasks";
+  read?: "read_task";
 }
-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 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;
+  sourcePath?: string;
+  okf?: DocsOkfTrustMetadataInput;
+  related?: ResolvedDocsRelatedLink[];
+  agent?: PageAgentFrontmatter;
+  content: string;
+  rawContent?: string;
+  agentContent?: string;
+  agentRawContent?: string;
+  agentFallbackContent?: string;
+  agentFallbackRawContent?: 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>;
-  agentEndpoint?: string | null;
-  structuredAgentEndpoint?: string | null;
-  explainedAgentEndpoint?: string | null;
-  facetsEndpoint?: string | null;
-  audienceParam?: string;
-  defaultAudience?: "human" | "agent";
-  supportedAudiences?: Array<"human" | "agent">;
-  filterParams?: {
-    framework: "framework";
-    version: "version";
-    package: "package";
-    tags: "tags";
-  };
-  responseFormat?: "docs-search.v1";
-  explainParam?: "explain";
-  explainValue?: "true";
-  explanationField?: "explanation";
-  explanationFormat?: "docs-search-explanation.v1";
-  facetsResponseFormat?: "docs-search-facets.v1";
-  format?: string;
-  sinceParam?: string;
-  generationField?: string;
-  resetRequiredField?: string;
-  warningsField?: "warnings";
-  /** Facet field selected for facet-value continuation. */
-  facetParam?: "facet";
-  /** Page-size parameter accepted by structured search and facet discovery. */
-  limitParam?: "limit";
-  /** Opaque continuation token accepted by structured search and facet discovery. */
-  cursorParam?: "cursor";
-  /** Optional continuation token returned when another result page is available. */
-  nextCursorField?: "nextCursor";
-  /** Boolean structured-response field indicating whether another page is available. */
-  hasMoreField?: "hasMore";
-  /** Structured-response field containing the total matches across all pages. */
-  totalField?: "total";
-  provider?: string;
-  mode?: string;
-  transport?: "GET" | "POST" | "GET/HEAD" | "GET/POST";
-  tools?: Record<string, boolean>;
-  prompts?: DocsMcpResolvedConfig["prompts"];
-  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;
-    agentSearch: string | null;
-    contentChanges: 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;
-    contentChanges: 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;
-  /** Runtime metadata-only document synchronization feed. Defaults to enabled. */
-  contentChanges?: boolean | DocsAgentContentChangesConfig;
-  mcp: DocsMcpResolvedConfig;
-  feedback?: DocsAgentFeedbackDiscoveryConfig;
-  llms?: DocsLlmsDiscoveryConfig;
-  sitemap?: boolean | DocsSitemapConfig;
-  robots?: boolean | DocsRobotsConfig;
-  openapi?: boolean | DocsOpenApiDiscoveryConfig;
-  markdown?: {
-    acceptHeader?: boolean;
-    signatureAgentHeader?: boolean; /** Whether runtime Markdown routes support `?sections` metadata discovery. Defaults to true. */
-    sectionDiscovery?: 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;
-  /** Runtime metadata-only document synchronization feed. Defaults to enabled. */
-  contentChanges?: boolean | DocsAgentContentChangesConfig;
-  mcp: DocsMcpResolvedConfig;
-  feedback?: DocsAgentFeedbackDiscoveryConfig;
-  llms?: DocsLlmsDiscoveryConfig;
-  sitemap?: boolean | DocsSitemapConfig;
-  robots?: boolean | DocsRobotsConfig;
-  openapi?: boolean | DocsOpenApiDiscoveryConfig;
-  markdown?: {
-    acceptHeader?: boolean;
-    signatureAgentHeader?: boolean; /** Whether runtime Markdown routes support `?sections` metadata discovery. Defaults to true. */
-    sectionDiscovery?: boolean;
-  };
-}
-interface DocsAgentsDocumentOptions extends DocsSkillDocumentOptions {}
-interface DocsStandardsDiscoveryResponseOptions extends DocsAgentDiscoverySpecOptions {
-  request: Request;
-  preferredSkillDocument?: string | null;
-  fallbackSkillDocument: string;
-  /** Stable representation generation or source modification time. */
-  lastModified?: string | Date | null;
-}
-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;
-  sourcePath?: string;
-  okf?: DocsOkfTrustMetadataInput;
-  related?: ResolvedDocsRelatedLink[];
-  agent?: PageAgentFrontmatter;
-  content: string;
-  rawContent?: string;
-  agentContent?: string;
-  agentRawContent?: string;
-  agentFallbackContent?: string;
-  agentFallbackRawContent?: string;
-}
-interface DocsMarkdownDocumentOptions {
-  llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig;
-  okf?: boolean | DocsOkfConfig;
-  origin?: string;
-  sitemap?: boolean | DocsSitemapConfig;
+interface DocsMarkdownDocumentOptions {
+  llms?: boolean | DocsLlmsDiscoveryConfig | LlmsTxtConfig;
+  okf?: boolean | DocsOkfConfig;
+  origin?: string;
+  sitemap?: boolean | DocsSitemapConfig;
 }
 interface DocsMarkdownSection {
   id: string;
@@ -863,6 +537,10 @@ interface DocsMarkdownResponseOptions extends DocsMarkdownNotFoundOptions {
   /** Exact source modification timestamp. Date-only values are intentionally ignored. */
   lastModified?: string | Date | null;
   cacheControl?: string;
+  /** Page policy evaluated before any body or recovery metadata is returned. */
+  access?: DocsPageAccessPolicy;
+  /** Authenticated identity; omitted public requests fail closed for protected pages. */
+  principal?: DocsAccessPrincipal;
 }
 declare function normalizeDocsPathSegment(value: string): string;
 declare function normalizeDocsUrlPath(value: string): string;
@@ -999,6 +677,12 @@ declare function buildDocsAgentDiscoverySpec({
   format: string;
   version: string;
   name: string;
+  profile: string;
+  profiles: {
+    default: string;
+    full: string;
+    compact: string;
+  };
   baseUrl: string;
   site: {
     title: string;
@@ -1086,6 +770,7 @@ declare function buildDocsAgentDiscoverySpec({
     usefulContractFields: string[];
     fields: {
       readonly tokenBudget: "number";
+      readonly access: "{visibility?,scopes?,claims?}";
       readonly task: "string";
       readonly outcome: "string";
       readonly appliesTo: {
@@ -1321,7 +1006,348 @@ declare function buildDocsAgentDiscoverySpec({
     doNotAssumeFeedbackPayloadShape: boolean;
   };
 };
+/** Remove first-hop file inventories while retaining every discovery route and capability. */
+declare function compactDocsAgentDiscoverySpec<T extends {
+  skills: {
+    published: Array<Record<string, unknown> & {
+      files: readonly unknown[];
+    }>;
+  };
+}>(spec: T): T;
 declare function acceptsDocsMarkdown(request: Request): boolean;
 declare function resolveDocsOpenApiDiscoveryConfig(openapi?: boolean | DocsOpenApiDiscoveryConfig): DocsOpenApiResolvedDiscoveryConfig;
 //#endregion
-export { DocsMarkdownPage as $, PerformDocsSearchOptions as $n, resolveDocsLlmsTxtRequest as $t, DocsAgentFeedbackDiscoveryConfig as A, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as An, resolveDocsAudienceMdxContent as Ar, hasDocsMarkdownSignatureAgent as At, DocsDiagnosticsIssueSeverity as B, createDocsContentChangeFeed as Bn, normalizeDocsPathSegment as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, DocsContentChangeHydrationBudget as Cn, resolveSearchRequestConfig as Cr, createDocsMarkdownResponse as Ct, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as D, DocsContentChangeHydrationTombstone as Dn, extractDocsMarkdownPromptBlocks as Dr, getDocsLlmsTxtMaxCharsIssue as Dt, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as E, DocsContentChangeHydrationSection as En, ExtractedDocsMarkdownPromptBlocks as Er, findDocsMarkdownPage as Et, DocsConfigMapJsonValue as F, DocsContentChangeFeed as Fn, resolveDocsPath as Fr, isDocsLlmsTxtPublicRequest as Ft, DocsLlmsTxtGeneratedSection as G, resolveDocsContentChangesRequest as Gn, renderDocsMarkdownDocument as Gt, DocsDiagnosticsStatus as H, isDocsContentChangeGeneration as Hn, parseDocsAgentFeedbackData as Ht, DocsConfigMapPointer as I, DocsContentChangesRequest as In, isDocsMarkdownSectionIndexRequest as It, DocsLlmsTxtRequest as J, DocsLocalMcpSearchRuntimeConfig as Jn, resolveDocsAgentContractMcpTools as Jt, DocsLlmsTxtMaxCharsIssue as K, BuildDocsContentSnapshotOptions as Kn, renderDocsMarkdownNotFound as Kt, DocsDiagnostics as L, DocsContentChangesRequestError as Ln, isDocsPublicGetRequest as Lt, DocsAgentFeedbackResolvedConfig as M, DOCS_CONTENT_CHANGES_FORMAT as Mn, ResolvedDocsI18n as Mr, isDocsAgentsRequest as Mt, DocsAgentsDocumentOptions as N, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Nn, resolveDocsI18n as Nr, isDocsConfigRequest as Nt, DocsAgentContractMcpTools as O, HydrateDocsContentChangesOptions as On, findDocsAudienceMdxIssues as Or, getDocsMarkdownCanonicalLinkHeader as Ot, DocsConfigMap as P, DOCS_CONTENT_SNAPSHOT_FORMAT as Pn, resolveDocsLocale as Pr, isDocsDiagnosticsRequest as Pt, DocsMarkdownAgentDetection as Q, EnrichDocsSearchDocumentsWithProvenanceOptions as Qn, resolveDocsLlmsTxtFormat as Qt, DocsDiagnosticsFeature as R, DocsResolvedContentChangesConfig as Rn, isDocsSkillRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT as Sn, resolveLocalDocsMcpSearchConfig as Sr, collectDocsMarkdownSections as St, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as T, DocsContentChangeHydrationResponse as Tn, DocsMarkdownPromptBlock as Tr, detectDocsMarkdownAgentRequest as Tt, DocsLlmsDiscoveryConfig as U, isDocsContentChangesRequest as Un, renderDocsAgentsDocument as Ut, DocsDiagnosticsOptions as V, createDocsContentChangesHttpResponse as Vn, normalizeDocsUrlPath as Vt, DocsLlmsTxtGeneratedContent as W, resolveDocsContentChangesConfig as Wn, renderDocsLlmsTxt as Wt, DocsLlmsTxtResolvedSection as X, DocsSearchRequestError as Xn, resolveDocsAgentFeedbackRequest as Xt, DocsLlmsTxtResolvedMaxChars as Y, DocsLocalMcpSearchRuntimeInput as Yn, resolveDocsAgentFeedbackConfig as Yt, DocsLlmsTxtSelectedContent as Z, DocsSearchRequestResolutionOptions as Zn, resolveDocsAgentsFormat as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, getDocsMcpProtectedResourceMetadataRoutes as _n, resolveDocsRetrievalLastModified as _r, buildDocsAgentFeedbackSchema as _t, DEFAULT_AGENT_MD_ROUTE as a, resolveDocsOpenApiDiscoveryConfig as an, createAlgoliaSearchAdapter as ar, DocsMarkdownSectionIndexOptions as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, isDocsMcpRequest as bn, resolveDocsSearchFilters as br, buildDocsMarkdownSectionIndex as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, selectDocsLlmsTxtContent as cn, createSimpleSearchAdapter as cr, DocsMarkdownSectionResult as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, validateDocsAgentFeedbackPayload as dn, formatDocsAskAIPackageHints as dr, DocsOpenApiDiscoveryConfig as dt, resolveDocsLlmsTxtSections as en, buildDocsAskAIContext as er, DocsMarkdownRecoveryMatch as et, DEFAULT_DOCS_CONFIG_ROUTE as f, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as fn, inferDocsAskAIPackageHints as fr, DocsOpenApiResolvedDiscoveryConfig as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, buildDocsMcpProtectedResourceMetadataRoute as gn, resolveAskAISearchRequestConfig as gr, buildDocsAgentDiscoverySpec as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, DEFAULT_MCP_WELL_KNOWN_ROUTE as hn, performDocsSearchWithMetadata as hr, acceptsDocsMarkdown as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, resolveDocsMarkdownSectionRequest as in, buildDocsSearchFacets as ir, DocsMarkdownSectionIndex as it, DocsAgentFeedbackRequest as j, hydrateDocsContentChanges as jn, DocsPathMatch as jr, isDocsAgentDiscoveryRequest as jt, DocsAgentDiscoverySpecOptions as k, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as kn, resolveDocsAgentMdxContent as kr, getDocsMarkdownVaryHeader as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, selectDocsMarkdownSection as ln, createTypesenseSearchAdapter as lr, DocsMcpEndpointCandidate as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, DEFAULT_MCP_ROUTE as mn, performDocsSearch as mr, DocsStandardsDiscoveryResponseOptions as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, resolveDocsMarkdownRecovery as nn, buildDocsRetrievalDigestProjection as nr, DocsMarkdownResponseOptions as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, resolveDocsRequestApiRoute as on, createCustomSearchAdapter as or, DocsMarkdownSectionMetadata as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, DEFAULT_MCP_PUBLIC_ROUTE as pn, normalizeDocsSearchFilters as pr, DocsSkillDocumentOptions as pt, DocsLlmsTxtPageInput as q, BuildDocsSearchFacetsOptions as qn, renderDocsSkillDocument as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, resolveDocsMarkdownRequest as rn, buildDocsSearchDocuments as rr, DocsMarkdownSection as rt, DEFAULT_AGENT_SPEC_ROUTE as s, resolveDocsSkillFormat as sn, createMcpSearchAdapter as sr, DocsMarkdownSectionRequest as st, DEFAULT_AGENTS_MD_ROUTE as t, resolveDocsMarkdownCanonicalUrl as tn, buildDocsContentSnapshot as tr, DocsMarkdownRecoveryResult as tt, DEFAULT_DOCS_API_ROUTE as u, toDocsMarkdownUrl as un, enrichDocsSearchDocumentsWithProvenance as ur, DocsMcpEndpointCandidateOptions as ut, DEFAULT_LLMS_TXT_ROUTE as v, getDocsMcpResourcePaths as vn, resolveDocsSearchAudience as vr, buildDocsConfigMap as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, DocsContentChangeHydrationContent as wn, DocsAudienceMdxIssue as wr, createDocsStandardsDiscoveryResponse as wt, DEFAULT_SKILL_MD_ROUTE as x, DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as xn, resolveDocsSearchRequest as xr, buildDocsMcpEndpointCandidates as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, hasDocsMcpProtectedResourceConfig as yn, resolveDocsSearchError as yr, buildDocsDiagnostics as yt, DocsDiagnosticsIssue as z, ResolveDocsContentChangesOptions as zn, matchesDocsLlmsTxtSection as zt };
+//#region src/search.d.ts
+interface DocsAskAIContextResult extends DocsSearchResult {
+  title: string;
+  contextContent: string;
+}
+interface DocsAskAIContext {
+  context: string;
+  /** Structured production context blocks; avoids reparsing markdown horizontal rules. */
+  blocks: Array<{
+    text: string;
+    result: DocsAskAIContextResult;
+  }>;
+  results: DocsAskAIContextResult[];
+  searchResults: DocsSearchResult[];
+  packageHints: DocsAskAIPackageHints;
+}
+interface DocsAskAIPackageHints {
+  packages: string[];
+  imports: string[];
+  installCommands: string[];
+}
+/** Normalize scalar or array-valued scope filters for programmatic, HTTP, and MCP callers. */
+declare function normalizeDocsSearchFilters(input?: DocsSearchFilterInput | DocsSearchFilters): DocsSearchFilters;
+/** Parse the public search scope parameters from a URL query string. */
+declare function resolveDocsSearchFilters(searchParams: URLSearchParams): DocsSearchFilters;
+declare class DocsSearchRequestError extends Error {
+  readonly code = "invalid_search_request";
+  constructor(message: string);
+}
+declare function resolveDocsSearchError(error: unknown): {
+  code: "invalid_cursor" | "invalid_search_request";
+  message: string;
+} | undefined;
+/** Resolve search filters and the backwards-compatible structured response opt-in. */
+declare function resolveDocsSearchRequest(searchParams: URLSearchParams): DocsSearchRequest;
+declare function inferDocsAskAIPackageHints(content: string): DocsAskAIPackageHints;
+declare function formatDocsAskAIPackageHints(hints: DocsAskAIPackageHints, packageName?: string): string | undefined;
+/**
+ * Build the exact normalized-input projection represented by a retrieval source digest.
+ * This is public so consumers can independently reproduce `source.digest`.
+ */
+declare function buildDocsRetrievalDigestProjection(page: DocsSearchSourcePage, audience?: DocsContentAudience): string;
+declare function resolveDocsRetrievalLastModified(page: DocsSearchSourcePage, audience: DocsContentAudience): string | undefined;
+interface BuildDocsContentSnapshotOptions {
+  pages: readonly DocsSearchSourcePage[];
+  search?: boolean | DocsSearchConfig;
+  audience?: DocsContentAudience;
+  locale?: string;
+  baseUrl?: string;
+  /** @internal Precomputed complete-corpus generation for composed callers. */
+  indexGeneration?: string;
+  /** Authenticated identity used to scope protected pages. */
+  principal?: DocsAccessPrincipal;
+}
+/**
+ * Build a deterministic, body-free inventory for content-change synchronization.
+ *
+ * Its generation is identical to structured search for the same pages, audience,
+ * locale, base URL, and chunking policy.
+ */
+declare function buildDocsContentSnapshot(options: BuildDocsContentSnapshotOptions): Promise<DocsContentSnapshot>;
+interface EnrichDocsSearchDocumentsWithProvenanceOptions {
+  documents: readonly DocsSearchDocument[];
+  pages: readonly DocsSearchSourcePage[];
+  audience?: DocsContentAudience;
+  chunking?: DocsSearchChunkingConfig;
+  locale?: string;
+  baseUrl?: string;
+  indexGeneration?: string;
+}
+/**
+ * Attach the same canonical provenance used by built-in search providers.
+ * Custom adapters can call this before persisting their own hosted records.
+ */
+declare function enrichDocsSearchDocumentsWithProvenance(options: EnrichDocsSearchDocumentsWithProvenanceOptions): Promise<DocsSearchDocument[]>;
+declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig, audience?: DocsContentAudience): DocsSearchDocument[];
+declare function createSimpleSearchAdapter(): DocsSearchAdapter;
+declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
+declare function resolveSearchRequestConfig(search: boolean | DocsSearchConfig | undefined, requestUrl?: string, options?: DocsSearchRequestResolutionOptions): boolean | DocsSearchConfig | undefined;
+interface DocsLocalMcpSearchRuntimeConfig {
+  enabled?: boolean;
+  route?: string;
+  tools?: {
+    searchDocs?: boolean;
+  };
+}
+type DocsLocalMcpSearchRuntimeInput = boolean | DocsLocalMcpSearchRuntimeConfig | null | undefined;
+interface DocsSearchRequestResolutionOptions {
+  /**
+   * The built-in MCP server colocated with this search handler. When the configured
+   * provider points at one of its local aliases, search runs directly instead of
+   * performing a loopback MCP handshake.
+   */
+  localMcp?: DocsLocalMcpSearchRuntimeInput;
+}
+declare function resolveLocalDocsMcpSearchConfig(search: boolean | DocsSearchConfig | undefined, localMcp: DocsLocalMcpSearchRuntimeInput, requestUrl?: string): boolean | DocsSearchConfig | undefined;
+/**
+ * Resolve the public search audience without allowing malformed values to opt into agent content.
+ * Human search remains the default for omitted, legacy, and unknown query values.
+ */
+declare function resolveDocsSearchAudience(value: string | null | undefined): DocsContentAudience;
+declare function resolveAskAISearchRequestConfig(options: {
+  search: boolean | DocsSearchConfig | undefined;
+  useMcp?: boolean | DocsAskAIMcpConfig;
+  mcpEndpoint?: string;
+  mcpEnabled?: boolean;
+  mcpSearchEnabled?: boolean;
+  requestUrl?: string;
+}): boolean | DocsSearchConfig | undefined;
+declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearchAdapter;
+declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
+interface PerformDocsSearchOptions {
+  pages: DocsSearchSourcePage[];
+  /** Authenticated identity used to scope protected pages before local or hosted indexing. */
+  principal?: DocsAccessPrincipal;
+  /** @internal Complete corpus used for generation when `pages` is pre-scoped by a caller. */
+  generationPages?: DocsSearchSourcePage[];
+  /** @internal Precomputed complete-corpus generation for structured callers. */
+  indexGeneration?: string;
+  query: string;
+  search?: boolean | DocsSearchConfig;
+  /** Selects which audience projection is searchable. Public site search defaults to human. */
+  audience?: DocsContentAudience;
+  locale?: string;
+  pathname?: string;
+  siteTitle?: string;
+  /** Canonical docs URL used to distinguish same-site absolute hits from foreign MCP results. */
+  baseUrl?: string;
+  /**
+   * Canonical origin safe to persist in a hosted index. Pass `null` when `baseUrl`
+   * came from the current request rather than trusted configuration.
+   * @internal
+   */
+  syncBaseUrl?: string | null;
+  limit?: number;
+  /** Opaque continuation cursor used by structured search responses. */
+  cursor?: string;
+  /** Optional framework, version, package, and tag constraints. */
+  filters?: DocsSearchFilterInput;
+  /** Include bounded explanations for the final ranked results. Defaults to false. */
+  explain?: boolean;
+  /**
+   * Controls provider failures. Runtime search keeps the resilient `fallback` default;
+   * diagnostics can request `throw` so a broken configured provider cannot be scored as
+   * successful simple search.
+   */
+  failureMode?: "fallback" | "throw";
+  /**
+   * Whether non-simple provider hits are supplemented with exact/local simple results.
+   * Runtime search defaults to true; provider diagnostics can disable supplementation.
+   */
+  supplementExternalResults?: boolean;
+  /** Keep absolute provider origins distinct when no canonical docs origin is available. */
+  strictExternalOrigins?: boolean;
+  /** Optional cancellation signal forwarded to adapters and their managed requests. */
+  signal?: AbortSignal;
+}
+declare function performDocsSearch(options: PerformDocsSearchOptions): Promise<DocsSearchResult[]>;
+interface BuildDocsSearchFacetsOptions {
+  pages: DocsSearchSourcePage[];
+  search?: boolean | DocsSearchConfig;
+  audience?: DocsContentAudience;
+  locale?: string;
+  baseUrl?: string;
+  filters?: DocsSearchFilterInput;
+  /** Facet field selected for cursor continuation. */
+  facet?: DocsSearchFilterField;
+  /** Opaque `nextCursor` returned for the selected facet. */
+  cursor?: string;
+  /** Maximum facet values returned per page. Defaults to 100. */
+  limit?: number;
+  /** @internal Precomputed complete-corpus generation for composed callers. */
+  indexGeneration?: string;
+  /** Authenticated identity used to scope protected pages. */
+  principal?: DocsAccessPrincipal;
+}
+/**
+ * Build a body-free index of valid search filter values and page counts.
+ *
+ * Each facet applies filters from the other fields while ignoring its own selected
+ * values. This is the conventional faceted-search behavior and lets an agent discover
+ * safe alternatives without guessing or fetching document bodies.
+ */
+declare function buildDocsSearchFacets(options: BuildDocsSearchFacetsOptions): Promise<DocsSearchFacetsResponse>;
+declare function performDocsSearchWithMetadata(options: PerformDocsSearchOptions): Promise<DocsPaginatedSearchResponse>;
+declare function buildDocsAskAIContext(options: {
+  pages: DocsSearchSourcePage[];
+  query: string;
+  search?: boolean | DocsSearchConfig;
+  locale?: string;
+  pathname?: string;
+  siteTitle?: string;
+  baseUrl?: string; /** See `performDocsSearch.syncBaseUrl`. */
+  syncBaseUrl?: string | null;
+  limit?: number;
+  filters?: DocsSearchFilterInput;
+  maxContextChars?: number;
+  maxResultChars?: number; /** See `performDocsSearch.failureMode`. Defaults to resilient runtime fallback. */
+  searchFailureMode?: "fallback" | "throw"; /** See `performDocsSearch.strictExternalOrigins`. */
+  strictExternalOrigins?: boolean; /** Optional cancellation signal forwarded to the configured search provider. */
+  signal?: AbortSignal;
+}): Promise<DocsAskAIContext>;
+declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory, options?: {
+  paginationRevision?: string;
+}): CustomDocsSearchConfig;
+//#endregion
+//#region src/content-changes.d.ts
+declare const DOCS_CONTENT_CHANGES_FORMAT = "docs-content-changes.v1";
+declare const DOCS_CONTENT_SNAPSHOT_FORMAT = "docs-content-snapshot.v1";
+declare const DOCS_CONTENT_CHANGES_RESPONSE_VALUE = "changes";
+/** Whether a value is a valid content-index generation identifier. */
+declare function isDocsContentChangeGeneration(value: string): boolean;
+interface DocsContentChangesRequest {
+  audience: "human" | "agent";
+  since?: string;
+}
+interface DocsResolvedContentChangesConfig {
+  enabled: boolean;
+  maxSnapshots: number;
+  loadSnapshot?: DocsAgentContentChangesConfig["loadSnapshot"];
+  saveSnapshot?: DocsAgentContentChangesConfig["saveSnapshot"];
+}
+interface ResolveDocsContentChangesOptions extends Omit<BuildDocsContentSnapshotOptions, "pages"> {
+  pages: readonly DocsSearchSourcePage[];
+  since?: string;
+  request?: Request;
+}
+interface DocsContentChangeFeed {
+  resolve(options: ResolveDocsContentChangesOptions): Promise<DocsContentChangesResponse>;
+}
+declare class DocsContentChangesRequestError extends Error {
+  readonly code = "invalid_content_changes_request";
+  constructor(message: string);
+}
+declare function resolveDocsContentChangesConfig(input?: boolean | DocsAgentContentChangesConfig, options?: {
+  staticExport?: boolean;
+}): DocsResolvedContentChangesConfig;
+declare function isDocsContentChangesRequest(url: URL): boolean;
+declare function resolveDocsContentChangesRequest(url: URL): DocsContentChangesRequest;
+declare function createDocsContentChangeFeed(input?: boolean | DocsAgentContentChangesConfig): DocsContentChangeFeed;
+declare function createDocsContentChangesHttpResponse(options: {
+  request: Request;
+  feed: DocsContentChangeFeed;
+  pages: readonly DocsSearchSourcePage[];
+  search?: boolean | DocsSearchConfig;
+  locale?: string;
+  baseUrl?: string;
+}): Promise<Response>;
+//#endregion
+//#region src/content-change-hydration.d.ts
+declare const DOCS_CONTENT_CHANGE_HYDRATION_FORMAT = "docs-content-change-hydration.v1";
+declare const DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 5000;
+declare const MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 4;
+declare const MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 32000;
+interface DocsContentChangeHydrationSection {
+  id: string;
+  heading: string;
+  level: number;
+}
+interface DocsContentChangeHydrationContent {
+  type: "content";
+  change: "added" | "changed";
+  url: string;
+  canonicalUrl: string;
+  /** Digest from the body-free document change feed. */
+  digest: string;
+  previousDigest?: string;
+  lastModified?: string;
+  previousLastModified?: string;
+  section: DocsContentChangeHydrationSection;
+  /** Digest of the complete, non-overlapping section before chunking. */
+  sectionDigest: string;
+  /** Digest of the content bytes returned in this chunk. */
+  chunkDigest: string;
+  chunk: {
+    index: number;
+    count: number;
+  };
+  content: string;
+  utf8Bytes: number;
+}
+interface DocsContentChangeHydrationTombstone {
+  type: "tombstone";
+  change: "deleted";
+  url: string;
+  canonicalUrl: string;
+  /** Last known digest for the deleted document. */
+  digest: string;
+  lastModified?: string;
+}
+interface DocsContentChangeHydrationBudget {
+  requestedTokens: number;
+  strategy: "utf8-bytes";
+  maxUtf8Bytes: number;
+  usedUtf8Bytes: number;
+  conservativeTokenUpperBound: number;
+  remainingUtf8Bytes: number;
+}
+interface DocsContentChangeHydrationResponse {
+  format: typeof DOCS_CONTENT_CHANGE_HYDRATION_FORMAT;
+  audience: "agent";
+  locale?: string;
+  since: string;
+  indexGeneration: string;
+  mode: DocsContentChangesResponse["mode"];
+  resetRequired: boolean;
+  documentCount: number;
+  counts: DocsContentChangesResponse["counts"];
+  budget: DocsContentChangeHydrationBudget;
+  resultCount: number;
+  total: number;
+  hasMore: boolean;
+  nextCursor?: string;
+  content: DocsContentChangeHydrationContent[];
+  tombstones: DocsContentChangeHydrationTombstone[];
+}
+interface HydrateDocsContentChangesOptions {
+  changes: DocsContentChangesResponse;
+  pages: readonly DocsSearchSourcePage[];
+  since: string;
+  tokenBudget?: number;
+  cursor?: string;
+  /** Stable MCP server identity mixed into opaque continuation cursors. */
+  cursorScope: string;
+}
+/**
+ * Hydrate only the current bodies named by a content-change delta.
+ *
+ * The conservative budget treats one UTF-8 byte as at most one token. Cursors are
+ * bound to the requested generation, current generation, locale, and budget.
+ */
+declare function hydrateDocsContentChanges(options: HydrateDocsContentChangesOptions): DocsContentChangeHydrationResponse;
+//#endregion
+export { resolveDocsSearchError as $, resolveDocsAgentFeedbackConfig as $n, DocsLlmsTxtResolvedSection as $t, DocsSearchRequestError as A, findDocsMarkdownPage as An, hasDocsMcpProtectedResourceConfig as Ar, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as At, createCustomSearchAdapter as B, isDocsMarkdownSectionIndexRequest as Bn, DocsDiagnostics as Bt, isDocsContentChangesRequest as C, buildDocsMarkdownSectionIndex as Cn, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as Cr, DEFAULT_OPENAPI_SCHEMA_ROUTE as Ct, BuildDocsSearchFacetsOptions as D, createDocsMarkdownResponse as Dn, buildDocsMcpProtectedResourceMetadataRoute as Dr, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as Dt, BuildDocsContentSnapshotOptions as E, compactDocsAgentDiscoverySpec as En, DEFAULT_MCP_WELL_KNOWN_ROUTE as Er, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as Et, buildDocsContentSnapshot as F, isDocsAgentDiscoveryRequest as Fn, resolveDocsLocale as Fr, DocsAgentFeedbackResolvedConfig as Ft, formatDocsAskAIPackageHints as G, normalizeDocsUrlPath as Gn, DocsDiagnosticsStatus as Gt, createSimpleSearchAdapter as H, isDocsSkillRequest as Hn, DocsDiagnosticsIssue as Ht, buildDocsRetrievalDigestProjection as I, isDocsAgentsRequest as In, resolveDocsPath as Ir, DocsAgentsDocumentOptions as It, performDocsSearch as J, renderDocsLlmsTxt as Jn, DocsLlmsTxtGeneratedSection as Jt, inferDocsAskAIPackageHints as K, parseDocsAgentFeedbackData as Kn, DocsLlmsDiscoveryConfig as Kt, buildDocsSearchDocuments as L, isDocsConfigRequest as Ln, DocsConfigMap as Lt, EnrichDocsSearchDocumentsWithProvenanceOptions as M, getDocsMarkdownCanonicalLinkHeader as Mn, DocsPathMatch as Mr, DocsAgentDiscoverySpecOptions as Mt, PerformDocsSearchOptions as N, getDocsMarkdownVaryHeader as Nn, ResolvedDocsI18n as Nr, DocsAgentFeedbackDiscoveryConfig as Nt, DocsLocalMcpSearchRuntimeConfig as O, createDocsStandardsDiscoveryResponse as On, getDocsMcpProtectedResourceMetadataRoutes as Or, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as Ot, buildDocsAskAIContext as P, hasDocsMarkdownSignatureAgent as Pn, resolveDocsI18n as Pr, DocsAgentFeedbackRequest as Pt, resolveDocsSearchAudience as Q, resolveDocsAgentContractMcpTools as Qn, DocsLlmsTxtResolvedMaxChars as Qt, buildDocsSearchFacets as R, isDocsDiagnosticsRequest as Rn, DocsConfigMapJsonValue as Rt, isDocsContentChangeGeneration as S, buildDocsDiagnostics as Sn, resolveDocsAudienceMdxContent as Sr, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as St, resolveDocsContentChangesRequest as T, collectDocsMarkdownSections as Tn, DEFAULT_MCP_ROUTE as Tr, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as Tt, createTypesenseSearchAdapter as U, matchesDocsLlmsTxtSection as Un, DocsDiagnosticsIssueSeverity as Ut, createMcpSearchAdapter as V, isDocsPublicGetRequest as Vn, DocsDiagnosticsFeature as Vt, enrichDocsSearchDocumentsWithProvenance as W, normalizeDocsPathSegment as Wn, DocsDiagnosticsOptions as Wt, resolveAskAISearchRequestConfig as X, renderDocsMarkdownNotFound as Xn, DocsLlmsTxtPageInput as Xt, performDocsSearchWithMetadata as Y, renderDocsMarkdownDocument as Yn, DocsLlmsTxtMaxCharsIssue as Yt, resolveDocsRetrievalLastModified as Z, renderDocsSkillDocument as Zn, DocsLlmsTxtRequest as Zt, DocsContentChangesRequestError as _, DocsStandardsDiscoveryResponseOptions as _n, DocsMarkdownPromptBlock as _r, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as _t, DocsContentChangeHydrationResponse as a, DocsMarkdownResponseOptions as an, resolveDocsMarkdownCanonicalUrl as ar, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as at, createDocsContentChangeFeed as b, buildDocsAgentFeedbackSchema as bn, findDocsAudienceMdxIssues as br, DEFAULT_LLMS_TXT_MAX_CHARS as bt, HydrateDocsContentChangesOptions as c, DocsMarkdownSectionIndexOptions as cn, resolveDocsMarkdownSectionRequest as cr, DEFAULT_AGENT_MD_ROUTE as ct, hydrateDocsContentChanges as d, DocsMarkdownSectionResult as dn, resolveDocsSkillFormat as dr, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as dt, DocsLlmsTxtSelectedContent as en, resolveDocsAgentFeedbackRequest as er, resolveDocsSearchFilters as et, DOCS_CONTENT_CHANGES_FORMAT as f, DocsMcpEndpointCandidate as fn, selectDocsLlmsTxtContent as fr, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as ft, DocsContentChangesRequest as g, DocsSkillDocumentOptions as gn, DocsAudienceMdxIssue as gr, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as gt, DocsContentChangeFeed as h, DocsOpenApiResolvedDiscoveryConfig as hn, validateDocsAgentFeedbackPayload as hr, DEFAULT_DOCS_CONFIG_ROUTE as ht, DocsContentChangeHydrationContent as i, DocsMarkdownRecoveryResult as in, resolveDocsLlmsTxtSections as ir, DEFAULT_AGENTS_MD_ROUTE as it, DocsSearchRequestResolutionOptions as j, getDocsLlmsTxtMaxCharsIssue as jn, isDocsMcpRequest as jr, DocsAgentContractMcpTools as jt, DocsLocalMcpSearchRuntimeInput as k, detectDocsMarkdownAgentRequest as kn, getDocsMcpResourcePaths as kr, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as kt, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as l, DocsMarkdownSectionMetadata as ln, resolveDocsOpenApiDiscoveryConfig as lr, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as lt, DOCS_CONTENT_SNAPSHOT_FORMAT as m, DocsOpenApiDiscoveryConfig as mn, toDocsMarkdownUrl as mr, DEFAULT_DOCS_CONFIG_FORMAT as mt, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT as n, DocsMarkdownPage as nn, resolveDocsLlmsTxtFormat as nr, resolveLocalDocsMcpSearchConfig as nt, DocsContentChangeHydrationSection as o, DocsMarkdownSection as on, resolveDocsMarkdownRecovery as or, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as ot, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as p, DocsMcpEndpointCandidateOptions as pn, selectDocsMarkdownSection as pr, DEFAULT_DOCS_API_ROUTE as pt, normalizeDocsSearchFilters as q, renderDocsAgentsDocument as qn, DocsLlmsTxtGeneratedContent as qt, DocsContentChangeHydrationBudget as r, DocsMarkdownRecoveryMatch as rn, resolveDocsLlmsTxtRequest as rr, resolveSearchRequestConfig as rt, DocsContentChangeHydrationTombstone as s, DocsMarkdownSectionIndex as sn, resolveDocsMarkdownRequest as sr, DEFAULT_AGENT_FEEDBACK_ROUTE as st, DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as t, DocsMarkdownAgentDetection as tn, resolveDocsAgentsFormat as tr, resolveDocsSearchRequest as tt, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as u, DocsMarkdownSectionRequest as un, resolveDocsRequestApiRoute as ur, DEFAULT_AGENT_SPEC_ROUTE as ut, DocsResolvedContentChangesConfig as v, acceptsDocsMarkdown as vn, ExtractedDocsMarkdownPromptBlocks as vr, DEFAULT_LLMS_FULL_TXT_ROUTE as vt, resolveDocsContentChangesConfig as w, buildDocsMcpEndpointCandidates as wn, DEFAULT_MCP_PUBLIC_ROUTE as wr, DEFAULT_SKILL_MD_ROUTE as wt, createDocsContentChangesHttpResponse as x, buildDocsConfigMap as xn, resolveDocsAgentMdxContent as xr, DEFAULT_LLMS_TXT_ROUTE as xt, ResolveDocsContentChangesOptions as y, buildDocsAgentDiscoverySpec as yn, extractDocsMarkdownPromptBlocks as yr, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as yt, createAlgoliaSearchAdapter as z, isDocsLlmsTxtPublicRequest as zn, DocsConfigMapPointer as zt };