@farming-labs/docs 0.2.120 → 0.2.121

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

@@ -1,75 +1,14 @@
-import { An as DocsPaginatedSearchResponse, Ar as FeedbackConfig, At as DocsAskAIMcpConfig, B as DocsAgentContentChangesConfig, Bn as DocsRobotsConfig, Fr as LlmsTxtMaxCharsConfig, Hn as DocsSearchAdapter, Ir as LlmsTxtMaxCharsMode, Lr as LlmsTxtSectionConfig, Pr as LlmsTxtConfig, Rr as McpDocsSearchConfig, Wn as DocsSearchAdapterFactory, Wt as DocsConfig, Xn as DocsSearchConfig, Xt as DocsContentChangesResponse, Yn as DocsSearchChunkingConfig, Z as DocsAgentFeedbackData, Zn as DocsSearchDocument, Zt as DocsContentSnapshot, _ as DocsAccessPrincipal, ar as DocsSearchFilterField, bn as DocsOkfConfig, ci as ResolvedDocsRelatedLink, ei as PageAgentFrontmatter, gr as DocsSearchResult, h as CustomDocsSearchConfig, kn as DocsPageAccessPolicy, mr as DocsSearchRequest, nr as DocsSearchFacetsResponse, or as DocsSearchFilterInput, r as AlgoliaDocsSearchConfig, sn as DocsMcpConfig, sr as DocsSearchFilters, tn as DocsI18nConfig, vi as TypesenseDocsSearchConfig, vr as DocsSearchSourcePage, wn as DocsOkfTrustMetadataInput, xr as DocsSitemapConfig } from "./types-BJFeMXWZ.mjs";
-import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-BHPc7YIX.mjs";
-import { t as DocsContentAudience } from "./audience-exposure-DBrFWULA.mjs";
+import { DocsAccessPrincipal, DocsAgentContentChangesConfig, DocsAgentFeedbackData, DocsConfig, DocsOkfConfig, DocsOkfTrustMetadataInput, DocsPageAccessPolicy, DocsRobotsConfig, DocsSearchConfig, DocsSearchSourcePage, DocsSitemapConfig, FeedbackConfig, LlmsTxtConfig, LlmsTxtMaxCharsConfig, LlmsTxtMaxCharsMode, LlmsTxtSectionConfig, PageAgentFrontmatter, ResolvedDocsRelatedLink } from "./types.mjs";
+import { AGENT_SKILL_COMPATIBILITY_MAX_LENGTH, AGENT_SKILL_DESCRIPTION_MAX_LENGTH, AGENT_SKILL_FRONTMATTER_FIELDS, AGENT_SKILL_NAME_MAX_LENGTH, DocsAgentSkillFrontmatter, DocsAgentSkillFrontmatterError, DocsAgentSkillFrontmatterField, DocsAgentSkillFrontmatterIssue, DocsAgentSkillFrontmatterValidation, DocsAgentSkillFrontmatterValidationOptions, isDocsAgentSkillName, parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
+import { AGENT_SKILLS_DISCOVERY_SCHEMA_URI, API_CATALOG_MEDIA_TYPE, API_CATALOG_PROFILE_URI, CreateDocsStandardsResponseOptions, DEFAULT_A2A_AGENT_CARD_FORMAT, DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_A2A_PROTOCOL_BINDING, DEFAULT_A2A_PROTOCOL_VERSION, 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_API_CATALOG_FORMAT, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX, DOCS_AGENT_MANIFEST_FORMAT, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, DOCS_AGENT_MANIFEST_SCHEMA_URI, DOCS_AGENT_MANIFEST_VERSION, DocsA2AAgentCard, DocsA2AAgentCardOptions, DocsA2AAgentInterface, DocsAgentSkillIndexEntry, DocsAgentSkillsIndex, DocsApiCatalog, DocsApiCatalogApiTarget, DocsApiCatalogLinkContext, DocsApiCatalogLinkTarget, DocsApiCatalogOpenApiDefinition, DocsApiCatalogOptions, DocsDiscoveryApiRouteOptions, DocsLegacySkillsIndex, DocsPublishedAgentSkill, DocsPublishedAgentSkillFile, DocsPublishedAgentSkillOptions, DocsStandardsDiscoveryRequest, DocsStandardsDiscoveryRouteOptions, appendDocsDiscoveryLinkHeader, buildDocsA2AAgentCard, buildDocsAgentSkillsIndex, buildDocsApiCatalog, buildDocsLegacySkillsIndex, createDocsStandardsResponse, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, isDocsStandardsDiscoveryRequest, resolveDocsDiscoveryApiRoute, resolveDocsPublishedAgentSkill, resolveDocsStandardsDiscoveryRequest, sha256DocsDiscoveryContent } from "./standards-discovery.mjs";
+import { resolveDocsAudienceExposure } from "./audience-exposure.mjs";
+import { DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN } from "./agent-detection.mjs";
+import { ResolvedDocsI18n } from "./i18n.mjs";
+import { normalizeDocsUrlPath, toDocsMarkdownUrl } from "./urls.mjs";
+import { DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE, DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE, buildDocsMcpProtectedResourceMetadataRoute, getDocsMcpProtectedResourceMetadataRoutes, getDocsMcpResourcePaths, hasDocsMcpProtectedResourceConfig, isDocsMcpRequest } from "./mcp-auth.mjs";
+import { findDocsAudienceMdxIssues, resolveDocsAgentMdxContent, resolveDocsAudienceMdxContent } from "./audience.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig, DocsMcpResolvedPromptsConfig } from "./mcp.mjs";
 
-//#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/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. */
-  attributes: string;
-  /** Literal source between the Prompt tags, with enclosing Markdown container prefixes removed. */
-  children: string;
-  /** Collision-safe placeholder carried through document-level rendering. */
-  token: string;
-}
-interface ExtractedDocsMarkdownPromptBlocks {
-  blocks: DocsMarkdownPromptBlock[];
-  markdown: string;
-}
-interface DocsAudienceMdxIssue {
-  code: "missing-only" | "invalid-only" | "dynamic-only" | "ignored-agent-only" | "ignored-human-only";
-  index: number;
-  message: string;
-}
-/**
- * Extract live MDX Prompt blocks while leaving Markdown literals untouched.
- *
- * Prompt bodies are copyable source, so callers can safely run audience,
- * reference-definition, and heading passes over `markdown`, then restore each
- * block from its token. Fences (including container fences), inline code, links,
- * comments, raw elements, and other literal contexts are never extracted.
- */
-declare function extractDocsMarkdownPromptBlocks(content: string): ExtractedDocsMarkdownPromptBlocks;
-/** Find audience declarations that cannot be projected consistently at build time. */
-declare function findDocsAudienceMdxIssues(content: string): DocsAudienceMdxIssue[];
-/**
- * Resolve MDX into its human or agent projection.
- *
- * `<Agent>` is shorthand for `<Audience only="agent">`, while `<Human>` is
- * shorthand for `<Audience only="human">`. Unknown `Audience.only` values are
- * treated as shared content so an authoring typo never silently deletes content.
- * These primitives shape content for each surface; they are not an access-control boundary.
- */
-declare function resolveDocsAudienceMdxContent(content: string, audience: DocsContentAudience): string;
-/** Backwards-compatible name retained for existing integrations. */
-declare function resolveDocsAgentMdxContent(content: string, audience: DocsContentAudience): string;
-//#endregion
 //#region src/agent.d.ts
 declare const DEFAULT_DOCS_API_ROUTE = "/api/docs";
 declare const DEFAULT_DOCS_CONFIG_FORMAT = "docs-config-map.v1";
@@ -95,9 +34,6 @@ 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;
@@ -559,7 +495,6 @@ interface DocsMarkdownResponseOptions extends DocsMarkdownNotFoundOptions {
   principal?: DocsAccessPrincipal;
 }
 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. */
@@ -579,9 +514,6 @@ declare function parseDocsAgentFeedbackData(request: Request): Promise<{
   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,
@@ -1045,337 +977,4 @@ declare function resolveDocsOpenApiDiscoveryConfig(openapi?: boolean | DocsOpenA
 /** Attach operation totals from the same normalized pages used by search and Markdown. */
 declare function withDocsOpenApiOperationCounts(openapi: boolean | DocsOpenApiDiscoveryConfig | undefined, operationPages: readonly DocsSearchSourcePage[]): DocsOpenApiResolvedDiscoveryConfig;
 //#endregion
-//#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 $, resolveDocsAgentContractMcpTools as $n, DocsLlmsTxtResolvedSection as $t, DocsSearchRequestError as A, detectDocsMarkdownAgentRequest as An, getDocsMcpProtectedResourceMetadataRoutes as Ar, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as At, createCustomSearchAdapter as B, isDocsLlmsTxtPublicRequest as Bn, DocsDiagnostics as Bt, isDocsContentChangesRequest as C, buildDocsDiagnostics as Cn, resolveDocsAgentMdxContent as Cr, DEFAULT_OPENAPI_SCHEMA_ROUTE as Ct, BuildDocsSearchFacetsOptions as D, compactDocsAgentDiscoverySpec as Dn, DEFAULT_MCP_ROUTE as Dr, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as Dt, BuildDocsContentSnapshotOptions as E, collectDocsMarkdownSections as En, DEFAULT_MCP_PUBLIC_ROUTE as Er, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as Et, buildDocsContentSnapshot as F, hasDocsMarkdownSignatureAgent as Fn, ResolvedDocsI18n as Fr, DocsAgentFeedbackResolvedConfig as Ft, formatDocsAskAIPackageHints as G, normalizeDocsPathSegment as Gn, DocsDiagnosticsStatus as Gt, createSimpleSearchAdapter as H, isDocsPublicGetRequest as Hn, DocsDiagnosticsIssue as Ht, buildDocsRetrievalDigestProjection as I, isDocsAgentDiscoveryRequest as In, resolveDocsI18n as Ir, DocsAgentsDocumentOptions as It, performDocsSearch as J, renderDocsAgentsDocument as Jn, DocsLlmsTxtGeneratedSection as Jt, inferDocsAskAIPackageHints as K, normalizeDocsUrlPath as Kn, DocsLlmsDiscoveryConfig as Kt, buildDocsSearchDocuments as L, isDocsAgentsRequest as Ln, resolveDocsLocale as Lr, DocsConfigMap as Lt, EnrichDocsSearchDocumentsWithProvenanceOptions as M, getDocsLlmsTxtMaxCharsIssue as Mn, hasDocsMcpProtectedResourceConfig as Mr, DocsAgentDiscoverySpecOptions as Mt, PerformDocsSearchOptions as N, getDocsMarkdownCanonicalLinkHeader as Nn, isDocsMcpRequest as Nr, DocsAgentFeedbackDiscoveryConfig as Nt, DocsLocalMcpSearchRuntimeConfig as O, createDocsMarkdownResponse as On, DEFAULT_MCP_WELL_KNOWN_ROUTE as Or, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as Ot, buildDocsAskAIContext as P, getDocsMarkdownVaryHeader as Pn, DocsPathMatch as Pr, DocsAgentFeedbackRequest as Pt, resolveDocsSearchAudience as Q, renderDocsSkillDocument as Qn, DocsLlmsTxtResolvedMaxChars as Qt, buildDocsSearchFacets as R, isDocsConfigRequest as Rn, resolveDocsPath as Rr, DocsConfigMapJsonValue as Rt, isDocsContentChangeGeneration as S, buildDocsConfigMap as Sn, findDocsAudienceMdxIssues as Sr, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as St, resolveDocsContentChangesRequest as T, buildDocsMcpEndpointCandidates as Tn, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as Tr, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as Tt, createTypesenseSearchAdapter as U, isDocsSkillRequest as Un, DocsDiagnosticsIssueSeverity as Ut, createMcpSearchAdapter as V, isDocsMarkdownSectionIndexRequest as Vn, DocsDiagnosticsFeature as Vt, enrichDocsSearchDocumentsWithProvenance as W, matchesDocsLlmsTxtSection as Wn, DocsDiagnosticsOptions as Wt, resolveAskAISearchRequestConfig as X, renderDocsMarkdownDocument as Xn, DocsLlmsTxtPageInput as Xt, performDocsSearchWithMetadata as Y, renderDocsLlmsTxt as Yn, DocsLlmsTxtMaxCharsIssue as Yt, resolveDocsRetrievalLastModified as Z, renderDocsMarkdownNotFound as Zn, DocsLlmsTxtRequest as Zt, DocsContentChangesRequestError as _, DocsSkillDocumentOptions as _n, withDocsOpenApiOperationCounts as _r, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as _t, DocsContentChangeHydrationResponse as a, DocsMarkdownResponseOptions as an, resolveDocsLlmsTxtSections as ar, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as at, createDocsContentChangeFeed as b, buildDocsAgentDiscoverySpec as bn, ExtractedDocsMarkdownPromptBlocks as br, DEFAULT_LLMS_TXT_MAX_CHARS as bt, HydrateDocsContentChangesOptions as c, DocsMarkdownSectionIndexOptions as cn, resolveDocsMarkdownRequest as cr, DEFAULT_AGENT_MD_ROUTE as ct, hydrateDocsContentChanges as d, DocsMarkdownSectionResult as dn, resolveDocsRequestApiRoute as dr, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as dt, DocsLlmsTxtSelectedContent as en, resolveDocsAgentFeedbackConfig as er, resolveDocsSearchFilters as et, DOCS_CONTENT_CHANGES_FORMAT as f, DocsMcpEndpointCandidate as fn, resolveDocsSkillFormat as fr, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as ft, DocsContentChangesRequest as g, DocsOpenApiVersionDiscoveryConfig as gn, validateDocsAgentFeedbackPayload as gr, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as gt, DocsContentChangeFeed as h, DocsOpenApiResolvedDiscoveryConfig as hn, toDocsMarkdownUrl as hr, DEFAULT_DOCS_CONFIG_ROUTE as ht, DocsContentChangeHydrationContent as i, DocsMarkdownRecoveryResult as in, resolveDocsLlmsTxtRequest as ir, DEFAULT_AGENTS_MD_ROUTE as it, DocsSearchRequestResolutionOptions as j, findDocsMarkdownPage as jn, getDocsMcpResourcePaths as jr, DocsAgentContractMcpTools as jt, DocsLocalMcpSearchRuntimeInput as k, createDocsStandardsDiscoveryResponse as kn, buildDocsMcpProtectedResourceMetadataRoute as kr, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as kt, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as l, DocsMarkdownSectionMetadata as ln, resolveDocsMarkdownSectionRequest as lr, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as lt, DOCS_CONTENT_SNAPSHOT_FORMAT as m, DocsOpenApiDiscoveryConfig as mn, selectDocsMarkdownSection as mr, DEFAULT_DOCS_CONFIG_FORMAT as mt, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT as n, DocsMarkdownPage as nn, resolveDocsAgentsFormat as nr, resolveLocalDocsMcpSearchConfig as nt, DocsContentChangeHydrationSection as o, DocsMarkdownSection as on, resolveDocsMarkdownCanonicalUrl as or, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as ot, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as p, DocsMcpEndpointCandidateOptions as pn, selectDocsLlmsTxtContent as pr, DEFAULT_DOCS_API_ROUTE as pt, normalizeDocsSearchFilters as q, parseDocsAgentFeedbackData as qn, DocsLlmsTxtGeneratedContent as qt, DocsContentChangeHydrationBudget as r, DocsMarkdownRecoveryMatch as rn, resolveDocsLlmsTxtFormat as rr, resolveSearchRequestConfig as rt, DocsContentChangeHydrationTombstone as s, DocsMarkdownSectionIndex as sn, resolveDocsMarkdownRecovery as sr, DEFAULT_AGENT_FEEDBACK_ROUTE as st, DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as t, DocsMarkdownAgentDetection as tn, resolveDocsAgentFeedbackRequest as tr, resolveDocsSearchRequest as tt, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as u, DocsMarkdownSectionRequest as un, resolveDocsOpenApiDiscoveryConfig as ur, DEFAULT_AGENT_SPEC_ROUTE as ut, DocsResolvedContentChangesConfig as v, DocsStandardsDiscoveryResponseOptions as vn, DocsAudienceMdxIssue as vr, DEFAULT_LLMS_FULL_TXT_ROUTE as vt, resolveDocsContentChangesConfig as w, buildDocsMarkdownSectionIndex as wn, resolveDocsAudienceMdxContent as wr, DEFAULT_SKILL_MD_ROUTE as wt, createDocsContentChangesHttpResponse as x, buildDocsAgentFeedbackSchema as xn, extractDocsMarkdownPromptBlocks as xr, DEFAULT_LLMS_TXT_ROUTE as xt, ResolveDocsContentChangesOptions as y, acceptsDocsMarkdown as yn, DocsMarkdownPromptBlock as yr, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as yt, createAlgoliaSearchAdapter as z, isDocsDiagnosticsRequest as zn, DocsConfigMapPointer as zt };
+export { 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_SPEC_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, DEFAULT_DOCS_API_ROUTE, DEFAULT_DOCS_CONFIG_FORMAT, DEFAULT_DOCS_CONFIG_ROUTE, DEFAULT_DOCS_DIAGNOSTICS_FORMAT, DEFAULT_DOCS_DIAGNOSTICS_ROUTE, DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, DEFAULT_LLMS_TXT_MAX_CHARS, DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, DEFAULT_OPENAPI_SCHEMA_ROUTE, DEFAULT_SKILL_MD_ROUTE, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, DOCS_MARKDOWN_SECTION_INDEX_FORMAT, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER, DocsAgentContractMcpTools, DocsAgentDiscoverySpecOptions, DocsAgentFeedbackDiscoveryConfig, DocsAgentFeedbackRequest, DocsAgentFeedbackResolvedConfig, DocsAgentsDocumentOptions, DocsConfigMap, DocsConfigMapJsonValue, DocsConfigMapPointer, DocsDiagnostics, DocsDiagnosticsFeature, DocsDiagnosticsIssue, DocsDiagnosticsIssueSeverity, DocsDiagnosticsOptions, DocsDiagnosticsStatus, DocsLlmsDiscoveryConfig, DocsLlmsTxtGeneratedContent, DocsLlmsTxtGeneratedSection, DocsLlmsTxtMaxCharsIssue, DocsLlmsTxtPageInput, DocsLlmsTxtRequest, DocsLlmsTxtResolvedMaxChars, DocsLlmsTxtResolvedSection, DocsLlmsTxtSelectedContent, DocsMarkdownAgentDetection, DocsMarkdownPage, DocsMarkdownRecoveryMatch, DocsMarkdownRecoveryResult, DocsMarkdownResponseOptions, DocsMarkdownSection, DocsMarkdownSectionIndex, DocsMarkdownSectionIndexOptions, DocsMarkdownSectionMetadata, DocsMarkdownSectionRequest, DocsMarkdownSectionResult, DocsMcpEndpointCandidate, DocsMcpEndpointCandidateOptions, DocsOpenApiDiscoveryConfig, DocsOpenApiResolvedDiscoveryConfig, DocsOpenApiVersionDiscoveryConfig, DocsSkillDocumentOptions, DocsStandardsDiscoveryResponseOptions, acceptsDocsMarkdown, buildDocsAgentDiscoverySpec, buildDocsAgentFeedbackSchema, buildDocsConfigMap, buildDocsDiagnostics, buildDocsMarkdownSectionIndex, buildDocsMcpEndpointCandidates, collectDocsMarkdownSections, compactDocsAgentDiscoverySpec, createDocsMarkdownResponse, createDocsStandardsDiscoveryResponse, detectDocsMarkdownAgentRequest, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, hasDocsMarkdownSignatureAgent, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsLlmsTxtPublicRequest, isDocsMarkdownSectionIndexRequest, isDocsPublicGetRequest, isDocsSkillRequest, matchesDocsLlmsTxtSection, normalizeDocsPathSegment, parseDocsAgentFeedbackData, renderDocsAgentsDocument, renderDocsLlmsTxt, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsSkillDocument, resolveDocsAgentContractMcpTools, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolveDocsAgentsFormat, resolveDocsLlmsTxtFormat, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsMarkdownCanonicalUrl, resolveDocsMarkdownRecovery, resolveDocsMarkdownRequest, resolveDocsMarkdownSectionRequest, resolveDocsOpenApiDiscoveryConfig, resolveDocsRequestApiRoute, resolveDocsSkillFormat, selectDocsLlmsTxtContent, selectDocsMarkdownSection, validateDocsAgentFeedbackPayload, withDocsOpenApiOperationCounts };