@farming-labs/docs 0.2.103 → 0.2.105

package/dist/{standards-discovery-Ckx0tN7B.mjs → standards-discovery-Bpz90VYq.mjs}

@@ -1,181 +1,6 @@
+import { i as sha256DocsContent } from "./retrieval-digest-B-SgtXKK.mjs";
 import { parseDocsAgentSkillFrontmatter, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
 
-//#region src/retrieval-digest.ts
-const SHA256_INITIAL_STATE = [
-	1779033703,
-	3144134277,
-	1013904242,
-	2773480762,
-	1359893119,
-	2600822924,
-	528734635,
-	1541459225
-];
-const SHA256_ROUND_CONSTANTS = [
-	1116352408,
-	1899447441,
-	3049323471,
-	3921009573,
-	961987163,
-	1508970993,
-	2453635748,
-	2870763221,
-	3624381080,
-	310598401,
-	607225278,
-	1426881987,
-	1925078388,
-	2162078206,
-	2614888103,
-	3248222580,
-	3835390401,
-	4022224774,
-	264347078,
-	604807628,
-	770255983,
-	1249150122,
-	1555081692,
-	1996064986,
-	2554220882,
-	2821834349,
-	2952996808,
-	3210313671,
-	3336571891,
-	3584528711,
-	113926993,
-	338241895,
-	666307205,
-	773529912,
-	1294757372,
-	1396182291,
-	1695183700,
-	1986661051,
-	2177026350,
-	2456956037,
-	2730485921,
-	2820302411,
-	3259730800,
-	3345764771,
-	3516065817,
-	3600352804,
-	4094571909,
-	275423344,
-	430227734,
-	506948616,
-	659060556,
-	883997877,
-	958139571,
-	1322822218,
-	1537002063,
-	1747873779,
-	1955562222,
-	2024104815,
-	2227730452,
-	2361852424,
-	2428436474,
-	2756734187,
-	3204031479,
-	3329325298
-];
-function rotateRight(value, bits) {
-	return value >>> bits | value << 32 - bits;
-}
-function normalizeDigestContent(value) {
-	return value.replace(/\r\n?/gu, "\n").replace(/^\uFEFF/u, "").trimEnd();
-}
-function toSha256Bytes(value) {
-	return typeof value === "string" ? new TextEncoder().encode(value) : value;
-}
-/** Validate the bounded HTTP(S) URL or root-relative URI reference used by provenance. */
-function isDocsRetrievalCanonicalUrl(value) {
-	const hasUnsafeCharacter = value.includes("\\") || Array.from(value).some((character) => {
-		const codePoint = character.codePointAt(0) ?? 0;
-		return codePoint <= 31 || codePoint === 127;
-	});
-	if (!value || value !== value.trim() || value.length > 4096 || hasUnsafeCharacter) return false;
-	if (/^\/(?!\/)/u.test(value)) try {
-		new URL(value, "https://docs.local");
-		return true;
-	} catch {
-		return false;
-	}
-	try {
-		const url = new URL(value);
-		return (url.protocol === "http:" || url.protocol === "https:") && !url.username && !url.password;
-	} catch {
-		return false;
-	}
-}
-/** Hash exact bytes with portable SHA-256 in Node, edge, and browser runtimes. */
-function sha256DocsContent(value) {
-	const input = toSha256Bytes(value);
-	const paddedLength = Math.ceil((input.length + 9) / 64) * 64;
-	const padded = new Uint8Array(paddedLength);
-	padded.set(input);
-	padded[input.length] = 128;
-	const bitLength = input.length * 8;
-	const dataView = new DataView(padded.buffer);
-	dataView.setUint32(paddedLength - 8, Math.floor(bitLength / 4294967296), false);
-	dataView.setUint32(paddedLength - 4, bitLength >>> 0, false);
-	const state = Uint32Array.from(SHA256_INITIAL_STATE);
-	const words = new Uint32Array(64);
-	for (let offset = 0; offset < padded.length; offset += 64) {
-		for (let index = 0; index < 16; index += 1) words[index] = dataView.getUint32(offset + index * 4, false);
-		for (let index = 16; index < 64; index += 1) {
-			const previous15 = words[index - 15];
-			const previous2 = words[index - 2];
-			const sigma0 = rotateRight(previous15, 7) ^ rotateRight(previous15, 18) ^ previous15 >>> 3;
-			const sigma1 = rotateRight(previous2, 17) ^ rotateRight(previous2, 19) ^ previous2 >>> 10;
-			words[index] = words[index - 16] + sigma0 + words[index - 7] + sigma1 >>> 0;
-		}
-		let a = state[0];
-		let b = state[1];
-		let c = state[2];
-		let d = state[3];
-		let e = state[4];
-		let f = state[5];
-		let g = state[6];
-		let h = state[7];
-		for (let index = 0; index < 64; index += 1) {
-			const sum1 = rotateRight(e, 6) ^ rotateRight(e, 11) ^ rotateRight(e, 25);
-			const choice = e & f ^ ~e & g;
-			const temporary1 = h + sum1 + choice + SHA256_ROUND_CONSTANTS[index] + words[index] >>> 0;
-			const temporary2 = (rotateRight(a, 2) ^ rotateRight(a, 13) ^ rotateRight(a, 22)) + (a & b ^ a & c ^ b & c) >>> 0;
-			h = g;
-			g = f;
-			f = e;
-			e = d + temporary1 >>> 0;
-			d = c;
-			c = b;
-			b = a;
-			a = temporary1 + temporary2 >>> 0;
-		}
-		state[0] = state[0] + a >>> 0;
-		state[1] = state[1] + b >>> 0;
-		state[2] = state[2] + c >>> 0;
-		state[3] = state[3] + d >>> 0;
-		state[4] = state[4] + e >>> 0;
-		state[5] = state[5] + f >>> 0;
-		state[6] = state[6] + g >>> 0;
-		state[7] = state[7] + h >>> 0;
-	}
-	return Array.from(state, (word) => word.toString(16).padStart(8, "0")).join("");
-}
-/** Hash exact message-content bytes with portable SHA-256. */
-function digestDocsContent(value) {
-	return `sha256:${sha256DocsContent(value)}`;
-}
-/**
-* Hash the normalized retrieval projection used by search provenance.
-*
-* The projection removes one leading BOM, normalizes line endings to LF, and trims
-* trailing whitespace. This deliberately differs from HTTP digests over exact bytes.
-*/
-function digestDocsRetrievalContent(value) {
-	return digestDocsContent(normalizeDigestContent(value));
-}
-
-//#endregion
 //#region src/http-cache.ts
 const BASE64_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
 const MAX_CACHED_TEXT_REPRESENTATIONS = 64;
@@ -1115,4 +940,4 @@ async function createDocsStandardsResponse({ request, apiCatalog, apiCatalogEnab
 }
 
 //#endregion
-export { buildDocsLegacySkillsIndex as A, createDocsCacheableResponse as B, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE as C, buildDocsA2AAgentCard as D, appendDocsDiscoveryLinkHeader as E, isDocsStandardsDiscoveryRequest as F, digestDocsContent as G, requestHasFreshDocsDate as H, resolveDocsDiscoveryApiRoute as I, sha256DocsContent as J, digestDocsRetrievalContent as K, resolveDocsPublishedAgentSkill as L, createDocsStandardsResponse as M, getDocsAgentManifestLinkHeader as N, buildDocsAgentSkillsIndex as O, getDocsDiscoveryLinkHeader as P, resolveDocsStandardsDiscoveryRequest as R, DOCS_AGENT_MANIFEST_FORMAT as S, DOCS_AGENT_MANIFEST_VERSION as T, requestMatchesDocsEtag as U, formatDocsContentDigest as V, resolveDocsHttpDate as W, DEFAULT_API_CATALOG_FORMAT as _, DEFAULT_A2A_AGENT_CARD_ROUTE as a, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as b, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as c, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as d, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as f, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as g, DEFAULT_AGENT_SKILL_FORMAT as h, DEFAULT_A2A_AGENT_CARD_FORMAT as i, buildDocsPublishedAgentSkill as j, buildDocsApiCatalog as k, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as l, DEFAULT_AGENT_SKILL_FILE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, DEFAULT_A2A_PROTOCOL_BINDING as o, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as p, isDocsRetrievalCanonicalUrl as q, API_CATALOG_PROFILE_URI as r, DEFAULT_A2A_PROTOCOL_VERSION as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as u, DEFAULT_API_CATALOG_ROUTE as v, DOCS_AGENT_MANIFEST_SCHEMA_URI as w, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as x, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as y, sha256DocsDiscoveryContent as z };
+export { buildDocsLegacySkillsIndex as A, createDocsCacheableResponse as B, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE as C, buildDocsA2AAgentCard as D, appendDocsDiscoveryLinkHeader as E, isDocsStandardsDiscoveryRequest as F, requestHasFreshDocsDate as H, resolveDocsDiscoveryApiRoute as I, resolveDocsPublishedAgentSkill as L, createDocsStandardsResponse as M, getDocsAgentManifestLinkHeader as N, buildDocsAgentSkillsIndex as O, getDocsDiscoveryLinkHeader as P, resolveDocsStandardsDiscoveryRequest as R, DOCS_AGENT_MANIFEST_FORMAT as S, DOCS_AGENT_MANIFEST_VERSION as T, requestMatchesDocsEtag as U, formatDocsContentDigest as V, resolveDocsHttpDate as W, DEFAULT_API_CATALOG_FORMAT as _, DEFAULT_A2A_AGENT_CARD_ROUTE as a, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as b, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as c, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as d, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as f, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as g, DEFAULT_AGENT_SKILL_FORMAT as h, DEFAULT_A2A_AGENT_CARD_FORMAT as i, buildDocsPublishedAgentSkill as j, buildDocsApiCatalog as k, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as l, DEFAULT_AGENT_SKILL_FILE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, DEFAULT_A2A_PROTOCOL_BINDING as o, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as p, API_CATALOG_PROFILE_URI as r, DEFAULT_A2A_PROTOCOL_VERSION as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as u, DEFAULT_API_CATALOG_ROUTE as v, DOCS_AGENT_MANIFEST_SCHEMA_URI as w, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as x, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as y, sha256DocsDiscoveryContent as z };

package/dist/{standards-discovery-D1Ys4J3h.d.mts → standards-discovery-Xm84bS4M.d.mts}

@@ -1,4 +1,4 @@
-import { A as DocsAgentA2ASecurityScheme, M as DocsAgentA2ASkill, O as DocsAgentA2AProtocolBinding, h as DocsAgentA2AConfig, k as DocsAgentA2ASecurityRequirement, m as DocsAgentA2ACapabilities } from "./types-DLLefoU5.mjs";
+import { A as DocsAgentA2AProtocolBinding, M as DocsAgentA2ASecurityScheme, P as DocsAgentA2ASkill, _ as DocsAgentA2AConfig, g as DocsAgentA2ACapabilities, j as DocsAgentA2ASecurityRequirement } from "./types-QhYMnKvb.mjs";
 
 //#region src/standards-discovery.d.ts
 declare const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";

package/dist/{types-DLLefoU5.d.mts → types-QhYMnKvb.d.mts}

@@ -276,12 +276,30 @@ interface PageAgentFailureMode {
   /** Recovery guidance for the symptom. */
   resolution?: string;
 }
+type DocsAccessClaimValue = string | number | boolean | readonly string[];
+/** Declarative, deny-by-default authorization requirements for agent-facing page surfaces. */
+interface DocsPageAccessPolicy {
+  /** Require an authenticated principal even when no scopes or claims are listed. */
+  visibility?: "public" | "authenticated";
+  /** Every listed scope must be present on the principal. */
+  scopes?: readonly string[];
+  /** Every listed claim must match; arrays match when at least one value overlaps. */
+  claims?: Readonly<Record<string, DocsAccessClaimValue>>;
+}
+/** Identity used when evaluating page access outside the MCP transport. */
+interface DocsAccessPrincipal {
+  id: string;
+  scopes?: readonly string[];
+  claims?: Readonly<Record<string, unknown>>;
+}
 interface PageAgentFrontmatter {
   /**
    * Approximate output token target for machine-readable compaction on this page.
    * Used by `docs agent compact` as a per-page override.
    */
   tokenBudget?: number;
+  /** Authorization requirements shared by Markdown, search, llms.txt, sync, export, and MCP. */
+  access?: DocsPageAccessPolicy;
   /** Concrete task the page helps an agent complete. */
   task?: string;
   /** Observable end state the agent should reach. */
@@ -311,6 +329,41 @@ interface PageSidebarFrontmatter {
    */
   folderIndexBehavior?: SidebarFolderIndexBehavior;
 }
+type DocsOkfStatus = "draft" | "stable" | "deprecated";
+interface DocsOkfSource {
+  resource: string;
+  id?: string;
+  title?: string;
+  author?: string;
+  usage_count?: number;
+  last_modified?: string;
+  usage_window?: {
+    start?: string;
+    end?: string;
+  };
+}
+interface DocsOkfActorTimestamp {
+  by: string;
+  at: string;
+}
+/** Authored OKF v0.2 trust metadata. Missing fields are derived conservatively at runtime. */
+interface DocsOkfTrustMetadataInput {
+  sources?: readonly DocsOkfSource[];
+  generated?: DocsOkfActorTimestamp;
+  verified?: readonly DocsOkfActorTimestamp[];
+  status?: DocsOkfStatus;
+  stale_after?: string;
+}
+type DocsOkfTrustTier = "unverified" | "machine-confirmed" | "human-reviewed";
+interface DocsOkfTrustMetadata {
+  sources: DocsOkfSource[];
+  generated: DocsOkfActorTimestamp;
+  verified: DocsOkfActorTimestamp[];
+  status: DocsOkfStatus;
+  stale_after?: string;
+  trust_tier: DocsOkfTrustTier;
+  stale: boolean;
+}
 interface PageFrontmatter {
   title: string;
   description?: string;
@@ -318,6 +371,8 @@ interface PageFrontmatter {
   related?: DocsRelatedItem[];
   /** Per-page agent-oriented metadata used by machine-readable docs features. */
   agent?: PageAgentFrontmatter;
+  /** OKF v0.2 source, generation, verification, lifecycle, and staleness metadata. */
+  okf?: DocsOkfTrustMetadataInput;
   /** Per-page sidebar metadata used when building the docs navigation tree. */
   sidebar?: PageSidebarFrontmatter;
   /** Override or disable the estimated reading time for this page. */
@@ -722,6 +777,10 @@ interface PageActionsConfig {
   copyMarkdown?: boolean | CopyMarkdownConfig;
   /** "Open in …" dropdown with LLM / tool providers */
   openDocs?: boolean | OpenDocsConfig;
+  /** One-click MCP connection instructions for supported coding agents. */
+  connectMcp?: boolean | PageActionConnectMcpConfig;
+  /** Agent Skills discovery and install dialog backed by the published skills index. */
+  installSkills?: boolean | PageActionInstallSkillsConfig;
   /**
    * Where to render the page action buttons relative to the page title.
    *
@@ -742,6 +801,27 @@ interface PageActionsConfig {
    */
   alignment?: "left" | "right";
 }
+type PageActionMcpProvider = "copy" | "claude-code" | "cursor" | "vscode" | "codex";
+interface PageActionConnectMcpConfig {
+  /** Show the connection menu. @default true */
+  enabled?: boolean;
+  /** Public MCP route or absolute URL. @default "/mcp" */
+  endpoint?: string;
+  /** Connection targets shown in the menu. */
+  providers?: readonly PageActionMcpProvider[];
+  /** Trigger label. @default "Connect MCP" */
+  label?: string;
+}
+interface PageActionInstallSkillsConfig {
+  /** Show the skills install dialog. @default true */
+  enabled?: boolean;
+  /** Agent Skills index route or absolute URL. */
+  index?: string;
+  /** Override the install command copied by the dialog. */
+  command?: string;
+  /** Trigger label. @default "Install skills" */
+  label?: string;
+}
 type DocsAnalyticsSource = "client" | "server" | "mcp";
 type DocsAgentTraceStatus = "started" | "success" | "error" | "retry" | "timeout";
 type DocsAgentTraceEventType = "run.start" | "run.end" | "run.error" | "user.input" | "prompt.build" | "retrieval.query" | "retrieval.result" | "retrieval.error" | "model.call" | "model.response" | "model.stream" | "model.error" | "tool.call" | "tool.result" | "tool.error" | "retry" | "timeout" | "error" | "agent.final";
@@ -1196,6 +1276,13 @@ interface DocsMcpToolsConfig {
   listPageSections?: boolean;
   /** Expose a `read_page` tool that returns a page by slug or URL path. */
   readPage?: boolean;
+  /** Expose a budget-aware `read_pages` tool for fetching several pages in one round trip. */
+  readPages?: boolean;
+  /**
+   * Expose `submit_feedback` when machine feedback is enabled. The tool validates
+   * payloads against `feedback.agent.schema` before invoking the configured callback.
+   */
+  submitFeedback?: boolean;
   /** Expose a `list_tasks` tool for pages with actionable agent contracts. */
   listTasks?: boolean;
   /** Expose a `read_task` tool that returns a page's full agent contract. */
@@ -1222,6 +1309,8 @@ interface DocsMcpToolsConfig {
   getConfigSchema?: boolean;
   /** Expose deterministic `get_context` retrieval with a conservative UTF-8 byte ceiling. */
   getContext?: boolean;
+  /** Expose OKF v0.2 source, verification, lifecycle, and staleness metadata. */
+  getTrustMetadata?: boolean;
 }
 /** Built-in MCP prompt templates projected from documentation contracts and golden tasks. */
 interface DocsMcpPromptsConfig {
@@ -1241,7 +1330,7 @@ interface DocsMcpPromptsConfig {
   goldenTasks?: readonly string[];
 }
 /** Authenticated identity returned by an MCP authentication callback. */
-interface DocsMcpAuthPrincipal {
+interface DocsMcpAuthPrincipal extends DocsAccessPrincipal {
   /** Stable identifier for the authenticated user, service, or agent. */
   id: string;
   /** Optional authorization scopes that source adapters can inspect. */
@@ -1365,6 +1454,7 @@ interface DocsSearchSourcePage {
   description?: string;
   related?: ResolvedDocsRelatedLink[];
   agent?: PageAgentFrontmatter;
+  okf?: DocsOkfTrustMetadataInput;
   sourcePath?: string;
   lastModified?: string;
   lastmod?: string;
@@ -1558,6 +1648,8 @@ interface DocsSearchResult {
   section?: string;
   /** Canonical, scope-aware provenance when supplied or recoverable locally. */
   source?: DocsRetrievalSourceProvenance;
+  /** OKF v0.2 trust metadata for the selected source. */
+  trust?: DocsOkfTrustMetadata;
   /** Present only when the caller opts into retrieval explanations. */
   explanation?: DocsSearchExplanation;
 }
@@ -2647,6 +2739,43 @@ interface ChangelogConfig {
   actionsComponent?: unknown;
 }
 type ApiReferenceRenderer = "fumadocs" | "scalar";
+interface DocsOpenApiMcpCredentialContext {
+  operationId: string;
+  method: string;
+  path: string;
+  security: readonly Record<string, readonly string[]>[];
+}
+type DocsOpenApiMcpHeaders = Readonly<Record<string, string>> | ((context: DocsOpenApiMcpCredentialContext) => Readonly<Record<string, string>> | Promise<Readonly<Record<string, string>>>);
+type DocsOpenApiMcpHostResolver = (hostname: string) => readonly string[] | Promise<readonly string[]>;
+/** Explicit, deny-by-default projection of OpenAPI operations into MCP tools. */
+interface DocsOpenApiMcpConfig {
+  /** Enable operation projection. No tools are exposed until an operation is explicitly allowed. */
+  enabled?: boolean;
+  /** Allowed operationIds or `METHOD /path` selectors. */
+  operations?: readonly string[];
+  /** Override the first OpenAPI server URL used for requests. */
+  baseUrl?: string;
+  /** Allow POST, PUT, PATCH, or DELETE operations. Defaults to false. */
+  allowMutations?: boolean;
+  /** Server-owned credentials added after user input is parsed. */
+  headers?: DocsOpenApiMcpHeaders;
+  /** Per-operation request timeout. @default 10000 */
+  timeoutMs?: number;
+  /** Permit plain HTTP destinations. Disabled by default. */
+  allowInsecureHttp?: boolean;
+  /** Permit loopback, private, link-local, and reserved network destinations. Disabled by default. */
+  allowPrivateNetwork?: boolean;
+  /** Server-owned DNS resolver used before every request and redirect. */
+  resolveHost?: DocsOpenApiMcpHostResolver;
+  /** Number of validated redirects to follow. @default 0 */
+  maxRedirects?: number;
+  /** Maximum downstream response bytes buffered into an MCP result. @default 1000000 */
+  maxResponseBytes?: number;
+  /** Per-principal operation calls allowed in a rolling minute. @default 60 */
+  requestsPerMinute?: number;
+  /** Concurrent downstream operation calls allowed per principal. @default 4 */
+  maxConcurrentRequests?: number;
+}
 interface ApiReferenceConfig {
   /**
    * Whether to enable generated API reference pages.
@@ -2705,6 +2834,11 @@ interface ApiReferenceConfig {
    * - TanStack Start / SvelteKit / Astro / Nuxt: `"scalar"`
    */
   renderer?: ApiReferenceRenderer;
+  /**
+   * Explicitly expose selected OpenAPI operations as MCP tools. This is deny-by-default:
+   * set `operations`, or mark an operation with `x-farming-labs-mcp.enabled: true`.
+   */
+  mcp?: boolean | DocsOpenApiMcpConfig;
   /**
    * Filesystem route root to scan for API handlers.
    *
@@ -3227,6 +3361,8 @@ interface DocsAgentA2AInterfacesConfig {
 /** Explicit A2A service metadata. Configure this only when the URL implements A2A. */
 type DocsAgentA2AConfig = DocsAgentA2ABaseConfig & (DocsAgentA2ASingleInterfaceConfig | DocsAgentA2AInterfacesConfig);
 interface DocsAgentConfig {
+  /** Publish OKF v0.2 trust metadata and a machine-readable knowledge bundle. */
+  okf?: boolean | DocsOkfConfig;
   /**
    * Defaults for `docs agent compact`.
    */
@@ -3247,6 +3383,16 @@ interface DocsAgentConfig {
   /** Opt in to an A2A Agent Card for a separately implemented A2A service. */
   a2a?: DocsAgentA2AConfig;
 }
+interface DocsOkfConfig extends DocsOkfTrustMetadataInput {
+  /** Enable OKF projection. @default true when configured */
+  enabled?: boolean;
+  /** Public bundle route. @default "/.well-known/okf.json" */
+  route?: string;
+  /** Generator actor used when a page has no authored `okf.generated`. */
+  generatedBy?: string;
+  /** Derive `stale_after` this many days after the best page timestamp. */
+  staleAfterDays?: number;
+}
 interface DocsAgentContentChangesConfig {
   /** Disable the runtime content-change endpoint. @default true */
   enabled?: boolean;
@@ -3987,4 +4133,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { DocsAgentGoldenQueryVariant as $, DocsSearchResult as $n, TypographyConfig as $r, DocsMcpAuthenticateContext as $t, DocsAgentA2ASecurityScheme as A, DocsSearchAmbiguityDecisionStatus as An, PageActionsConfig as Ar, DocsCodeBlocksConfig as At, DocsAgentEvaluationAnswerRunner as B, DocsSearchFilterDecision as Bn, ReadingTimeConfig as Br, DocsContentChangeSnapshotContext as Bt, DocsAgentA2AOAuthDeviceCodeFlow as C, DocsRobotsConfig as Cn, OpenDocsConfig as Cr, DocsAskAIFeedbackValue as Ct, DocsAgentA2AOpenIdConnectSecurityScheme as D, DocsSearchAdapterFactory as Dn, OpenDocsTarget as Dr, DocsCloudFeatureConfig as Dt, DocsAgentA2AOAuthPasswordFlow as E, DocsSearchAdapterContext as En, OpenDocsProviderId as Er, DocsCloudConfig as Et, DocsAgentContentChangesConfig as F, DocsSearchEmbeddingsConfig as Fn, PageAgentVerification as Fr, DocsCodeBlocksValidateConfig as Ft, DocsAgentFeedbackContext as G, DocsSearchMatchField as Gn, SidebarFolderIndexBehavior as Gr, DocsContentSnapshot as Gt, DocsAgentEvaluationSurface as H, DocsSearchFilterField as Hn, ResolvedDocsRelatedLink as Hr, DocsContentChangeSnapshotSaver as Ht, DocsAgentEvaluationAnswerInput as I, DocsSearchExplanation as In, PageFrontmatter as Ir, DocsCodeBlocksValidationMode as It, DocsAgentGoldenAuthenticatedContentExpectation as J, DocsSearchRankingReason as Jn, SidebarPageNode as Jr, DocsFeedbackValue as Jt, DocsAgentFeedbackData as K, DocsSearchMatchedTerm as Kn, SidebarFolderNode as Kr, DocsContentSnapshotDocument as Kt, DocsAgentEvaluationAnswerProvider as L, DocsSearchFacet as Ln, PageOpenGraph as Lr, DocsCodeBlocksValidationPolicy as Lt, DocsAgentA2ASkill as M, DocsSearchChunkingConfig as Mn, PageAgentCommand as Mr, DocsCodeBlocksPlannerProvider as Mt, DocsAgentCompactConfig as N, DocsSearchConfig as Nn, PageAgentFailureMode as Nr, DocsCodeBlocksRunnerConfig as Nt, DocsAgentA2AProtocolBinding as O, DocsSearchAdapterPage as On, OpenGraphImage as Or, DocsCloudPreviewConfig as Ot, DocsAgentConfig as P, DocsSearchDocument as Pn, PageAgentFrontmatter as Pr, DocsCodeBlocksRunnerProvider as Pt, DocsAgentGoldenPromptInjectionExpectation as Q, DocsSearchResponse as Qn, TypesenseDocsSearchConfig as Qr, DocsMcpAuthenticate as Qt, DocsAgentEvaluationAnswerRequest as R, DocsSearchFacetValue as Rn, PageSidebarFrontmatter as Rr, DocsConfig as Rt, DocsAgentA2AOAuthClientCredentialsFlow as S, DocsReviewSeverity as Sn, OGConfig as Sr, DocsAskAIFeedbackMessage as St, DocsAgentA2AOAuthImplicitFlow as T, DocsSearchAdapter as Tn, OpenDocsProviderConfig as Tr, DocsCloudApiKeyConfig as Tt, DocsAgentEvaluationTaskInput as U, DocsSearchFilterInput as Un, SidebarComponentProps as Ur, DocsContentChangedDocument as Ut, DocsAgentEvaluationSourceReference as V, DocsSearchFilterDecisionOutcome as Vn, ReadingTimeFormat as Vr, DocsContentChangeSnapshotLoader as Vt, DocsAgentEvaluationsConfig as W, DocsSearchFilters as Wn, SidebarConfig as Wr, DocsContentChangesResponse as Wt, DocsAgentGoldenExpectedExample as X, DocsSearchRankingStrategy as Xn, SimpleDocsSearchConfig as Xr, DocsMcpAllowedOrigins as Xt, DocsAgentGoldenExampleVerification as Y, DocsSearchRankingReasonCode as Yn, SidebarTree as Yr, DocsI18nConfig as Yt, DocsAgentGoldenFreshnessExpectation as Z, DocsSearchRequest as Zn, ThemeToggleConfig as Zr, DocsMcpAuthPrincipal as Zt, DocsAgentA2AHttpAuthSecurityScheme as _, DocsReviewCiConfig as _n, LlmsTxtConfig as _r, DocsAnalyticsSource as _t, ApiReferenceRenderer as a, DocsMcpProtectedResourceConfig as an, DocsTelemetryAgentSurface as ar, DocsAgentSkillsCompatibilityPolicy as at, DocsAgentA2AOAuth2SecurityScheme as b, DocsReviewRulesConfig as bn, LlmsTxtSectionConfig as br, DocsAskAIFeedbackConfig as bt, ChangelogFrontmatter as c, DocsMetadata as cn, DocsTelemetryEventInput as cr, DocsAgentSkillsProgressiveDisclosureConfig as ct, CopyMarkdownFormat as d, DocsObservabilityEvent as dn, DocsTelemetryFramework as dr, DocsAgentTraceStatus as dt, UIConfig as ei, DocsMcpAuthenticateResult as en, DocsSearchResultType as er, DocsAgentGoldenQueryVariantKind as et, CustomDocsSearchConfig as f, DocsObservabilityEventInput as fn, DocsTheme as fr, DocsAnalyticsConfig as ft, DocsAgentA2AExtension as g, DocsRetrievalSourceScope as gn, LastUpdatedConfig as gr, DocsAnalyticsInput as gt, DocsAgentA2AConfig as h, DocsRetrievalSourceProvenance as hn, GithubConfig as hr, DocsAnalyticsEventType as ht, ApiReferenceConfig as i, DocsMcpPromptsConfig as in, DocsSitemapConfig as ir, DocsAgentGoldenTaskFilters as it, DocsAgentA2ASecurityScopeList as j, DocsSearchAmbiguityResolution as jn, PageAgentAppliesTo as jr, DocsCodeBlocksPlannerConfig as jt, DocsAgentA2ASecurityRequirement as k, DocsSearchAmbiguityDecision as kn, OrderingItem as kr, DocsCloudPublishConfig as kt, CodeBlockCopyData as l, DocsNav as ln, DocsTelemetryEventType as lr, DocsAgentTraceEventInput as lt, DocsAgentA2ACapabilities as m, DocsRelatedItem as mn, FontStyle as mr, DocsAnalyticsEventInput as mt, AgentFeedbackConfig as n, DocsMcpCorsConfig as nn, DocsSearchWarning as nr, DocsAgentGoldenTask as nt, BreadcrumbConfig as o, DocsMcpSecurityConfig as on, DocsTelemetryConfig as or, DocsAgentSkillsConfig as ot, DocsAgentA2AApiKeySecurityScheme as p, DocsPaginatedSearchResponse as pn, FeedbackConfig as pr, DocsAnalyticsEvent as pt, DocsAgentGoldenAnswerExpectation as q, DocsSearchQuery as qn, SidebarNode as qr, DocsFeedbackData as qt, AlgoliaDocsSearchConfig as r, DocsMcpOriginContext as rn, DocsSearchWarningCode as rr, DocsAgentGoldenTaskExpectation as rt, ChangelogConfig as s, DocsMcpToolsConfig as sn, DocsTelemetryEvent as sr, DocsAgentSkillsInput as st, AIConfig as t, DocsMcpConfig as tn, DocsSearchSourcePage as tr, DocsAgentGoldenSafetyExpectation as tt, CopyMarkdownConfig as u, DocsObservabilityConfig as un, DocsTelemetryFeatures as ur, DocsAgentTraceEventType as ut, DocsAgentA2AInterfaceConfig as v, DocsReviewCiMode as vn, LlmsTxtMaxCharsConfig as vr, DocsAskAIActionData as vt, DocsAgentA2AOAuthFlows as w, DocsRobotsRule as wn, OpenDocsProvider as wr, DocsAskAIMcpConfig as wt, DocsAgentA2AOAuthAuthorizationCodeFlow as x, DocsReviewScoreConfig as xn, McpDocsSearchConfig as xr, DocsAskAIFeedbackData as xt, DocsAgentA2AMutualTlsSecurityScheme as y, DocsReviewConfig as yn, LlmsTxtMaxCharsMode as yr, DocsAskAIActionType as yt, DocsAgentEvaluationAnswerResult as z, DocsSearchFacetsResponse as zn, PageTwitter as zr, DocsContentChangeDocument as zt };
+export { DocsAgentGoldenFreshnessExpectation as $, DocsSearchFilterDecision as $n, PageOpenGraph as $r, DocsMcpAuthPrincipal as $t, DocsAgentA2AProtocolBinding as A, DocsReviewCiConfig as An, LlmsTxtConfig as Ar, DocsCloudPreviewConfig as At, DocsAgentEvaluationAnswerRequest as B, DocsSearchAdapterFactory as Bn, OpenDocsTarget as Br, DocsConfig as Bt, DocsAgentA2AOAuthAuthorizationCodeFlow as C, DocsOpenApiMcpCredentialContext as Cn, DocsTelemetryFeatures as Cr, DocsAskAIFeedbackData as Ct, DocsAgentA2AOAuthImplicitFlow as D, DocsRelatedItem as Dn, FontStyle as Dr, DocsCloudApiKeyConfig as Dt, DocsAgentA2AOAuthFlows as E, DocsPaginatedSearchResponse as En, FeedbackConfig as Er, DocsAskAIMcpConfig as Et, DocsAgentCompactConfig as F, DocsReviewSeverity as Fn, OGConfig as Fr, DocsCodeBlocksRunnerConfig as Ft, DocsAgentEvaluationTaskInput as G, DocsSearchChunkingConfig as Gn, PageActionMcpProvider as Gr, DocsContentChangedDocument as Gt, DocsAgentEvaluationAnswerRunner as H, DocsSearchAmbiguityDecision as Hn, OrderingItem as Hr, DocsContentChangeSnapshotContext as Ht, DocsAgentConfig as I, DocsRobotsConfig as In, OpenDocsConfig as Ir, DocsCodeBlocksRunnerProvider as It, DocsAgentFeedbackData as J, DocsSearchEmbeddingsConfig as Jn, PageAgentCommand as Jr, DocsContentSnapshotDocument as Jt, DocsAgentEvaluationsConfig as K, DocsSearchConfig as Kn, PageActionsConfig as Kr, DocsContentChangesResponse as Kt, DocsAgentContentChangesConfig as L, DocsRobotsRule as Ln, OpenDocsProvider as Lr, DocsCodeBlocksValidateConfig as Lt, DocsAgentA2ASecurityScheme as M, DocsReviewConfig as Mn, LlmsTxtMaxCharsMode as Mr, DocsCodeBlocksConfig as Mt, DocsAgentA2ASecurityScopeList as N, DocsReviewRulesConfig as Nn, LlmsTxtSectionConfig as Nr, DocsCodeBlocksPlannerConfig as Nt, DocsAgentA2AOAuthPasswordFlow as O, DocsRetrievalSourceProvenance as On, GithubConfig as Or, DocsCloudConfig as Ot, DocsAgentA2ASkill as P, DocsReviewScoreConfig as Pn, McpDocsSearchConfig as Pr, DocsCodeBlocksPlannerProvider as Pt, DocsAgentGoldenExpectedExample as Q, DocsSearchFacetsResponse as Qn, PageFrontmatter as Qr, DocsMcpAllowedOrigins as Qt, DocsAgentEvaluationAnswerInput as R, DocsSearchAdapter as Rn, OpenDocsProviderConfig as Rr, DocsCodeBlocksValidationMode as Rt, DocsAgentA2AOAuth2SecurityScheme as S, DocsOpenApiMcpConfig as Sn, DocsTelemetryEventType as Sr, DocsAskAIFeedbackConfig as St, DocsAgentA2AOAuthDeviceCodeFlow as T, DocsPageAccessPolicy as Tn, DocsTheme as Tr, DocsAskAIFeedbackValue as Tt, DocsAgentEvaluationSourceReference as U, DocsSearchAmbiguityDecisionStatus as Un, PageActionConnectMcpConfig as Ur, DocsContentChangeSnapshotLoader as Ut, DocsAgentEvaluationAnswerResult as V, DocsSearchAdapterPage as Vn, OpenGraphImage as Vr, DocsContentChangeDocument as Vt, DocsAgentEvaluationSurface as W, DocsSearchAmbiguityResolution as Wn, PageActionInstallSkillsConfig as Wr, DocsContentChangeSnapshotSaver as Wt, DocsAgentGoldenAuthenticatedContentExpectation as X, DocsSearchFacet as Xn, PageAgentFrontmatter as Xr, DocsFeedbackValue as Xt, DocsAgentGoldenAnswerExpectation as Y, DocsSearchExplanation as Yn, PageAgentFailureMode as Yr, DocsFeedbackData as Yt, DocsAgentGoldenExampleVerification as Z, DocsSearchFacetValue as Zn, PageAgentVerification as Zr, DocsI18nConfig as Zt, DocsAgentA2AConfig as _, DocsOkfSource as _n, DocsSitemapConfig as _r, DocsAnalyticsEventType as _t, ApiReferenceRenderer as a, SidebarComponentProps as ai, DocsMcpOriginContext as an, DocsSearchMatchedTerm as ar, DocsAgentGoldenTaskExpectation as at, DocsAgentA2AInterfaceConfig as b, DocsOkfTrustMetadataInput as bn, DocsTelemetryEvent as br, DocsAskAIActionData as bt, ChangelogFrontmatter as c, SidebarFolderNode as ci, DocsMcpSecurityConfig as cn, DocsSearchRankingReasonCode as cr, DocsAgentSkillsConfig as ct, CopyMarkdownFormat as d, SidebarTree as di, DocsNav as dn, DocsSearchResponse as dr, DocsAgentTraceEventInput as dt, PageSidebarFrontmatter as ei, DocsMcpAuthenticate as en, DocsSearchFilterDecisionOutcome as er, DocsAgentGoldenPromptInjectionExpectation as et, CustomDocsSearchConfig as f, SimpleDocsSearchConfig as fi, DocsObservabilityConfig as fn, DocsSearchResult as fr, DocsAgentTraceEventType as ft, DocsAgentA2ACapabilities as g, UIConfig as gi, DocsOkfConfig as gn, DocsSearchWarningCode as gr, DocsAnalyticsEventInput as gt, DocsAgentA2AApiKeySecurityScheme as h, TypographyConfig as hi, DocsOkfActorTimestamp as hn, DocsSearchWarning as hr, DocsAnalyticsEvent as ht, ApiReferenceConfig as i, ResolvedDocsRelatedLink as ii, DocsMcpCorsConfig as in, DocsSearchMatchField as ir, DocsAgentGoldenTask as it, DocsAgentA2ASecurityRequirement as j, DocsReviewCiMode as jn, LlmsTxtMaxCharsConfig as jr, DocsCloudPublishConfig as jt, DocsAgentA2AOpenIdConnectSecurityScheme as k, DocsRetrievalSourceScope as kn, LastUpdatedConfig as kr, DocsCloudFeatureConfig as kt, CodeBlockCopyData as l, SidebarNode as li, DocsMcpToolsConfig as ln, DocsSearchRankingStrategy as lr, DocsAgentSkillsInput as lt, DocsAccessPrincipal as m, TypesenseDocsSearchConfig as mi, DocsObservabilityEventInput as mn, DocsSearchSourcePage as mr, DocsAnalyticsConfig as mt, AgentFeedbackConfig as n, ReadingTimeConfig as ni, DocsMcpAuthenticateResult as nn, DocsSearchFilterInput as nr, DocsAgentGoldenQueryVariantKind as nt, BreadcrumbConfig as o, SidebarConfig as oi, DocsMcpPromptsConfig as on, DocsSearchQuery as or, DocsAgentGoldenTaskFilters as ot, DocsAccessClaimValue as p, ThemeToggleConfig as pi, DocsObservabilityEvent as pn, DocsSearchResultType as pr, DocsAgentTraceStatus as pt, DocsAgentFeedbackContext as q, DocsSearchDocument as qn, PageAgentAppliesTo as qr, DocsContentSnapshot as qt, AlgoliaDocsSearchConfig as r, ReadingTimeFormat as ri, DocsMcpConfig as rn, DocsSearchFilters as rr, DocsAgentGoldenSafetyExpectation as rt, ChangelogConfig as s, SidebarFolderIndexBehavior as si, DocsMcpProtectedResourceConfig as sn, DocsSearchRankingReason as sr, DocsAgentSkillsCompatibilityPolicy as st, AIConfig as t, PageTwitter as ti, DocsMcpAuthenticateContext as tn, DocsSearchFilterField as tr, DocsAgentGoldenQueryVariant as tt, CopyMarkdownConfig as u, SidebarPageNode as ui, DocsMetadata as un, DocsSearchRequest as ur, DocsAgentSkillsProgressiveDisclosureConfig as ut, DocsAgentA2AExtension as v, DocsOkfStatus as vn, DocsTelemetryAgentSurface as vr, DocsAnalyticsInput as vt, DocsAgentA2AOAuthClientCredentialsFlow as w, DocsOpenApiMcpHeaders as wn, DocsTelemetryFramework as wr, DocsAskAIFeedbackMessage as wt, DocsAgentA2AMutualTlsSecurityScheme as x, DocsOkfTrustTier as xn, DocsTelemetryEventInput as xr, DocsAskAIActionType as xt, DocsAgentA2AHttpAuthSecurityScheme as y, DocsOkfTrustMetadata as yn, DocsTelemetryConfig as yr, DocsAnalyticsSource as yt, DocsAgentEvaluationAnswerProvider as z, DocsSearchAdapterContext as zn, OpenDocsProviderId as zr, DocsCodeBlocksValidationPolicy as zt };

package/dist/{upgrade-kj2crJSk.mjs → upgrade-B92U83xo.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec } from "./utils-DOMeZW9V.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version--oQiHwZj.mjs";
+import { c as fileExists, o as exec } from "./utils-Cc1SrVza.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-Ci99L0yo.mjs";
 import path from "node:path";
 import pc from "picocolors";
 import * as p from "@clack/prompts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.103",
+  "version": "0.2.105",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",

package/dist/retrieval-digest-DYEsIeCE.d.mts

@@ -1,164 +0,0 @@
-import { Dr as OpenDocsTarget, Hr as ResolvedDocsRelatedLink, ir as DocsSitemapConfig, wr as OpenDocsProvider } from "./types-DLLefoU5.mjs";
-import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-D1Ys4J3h.mjs";
-
-//#region src/prompt-utils.d.ts
-type PromptAction = "copy" | "open";
-interface SerializedOpenDocsProvider {
-  name: string;
-  iconHtml?: string;
-  urlTemplate: string;
-  promptUrlTemplate?: string;
-  target?: OpenDocsTarget;
-  prompt?: string;
-}
-interface PromptProviderChoice {
-  name: string;
-  iconHtml?: string;
-  urlTemplate: string;
-}
-type PromptProviderInput = Pick<SerializedOpenDocsProvider, "name" | "iconHtml"> & Partial<Pick<SerializedOpenDocsProvider, "promptUrlTemplate" | "urlTemplate">>;
-interface SerializeOpenDocsProviderOptions {
-  target?: OpenDocsTarget;
-  prompt?: string;
-}
-declare const DEFAULT_PROMPT_PROVIDER_TEMPLATES: Record<string, string>;
-declare const DEFAULT_OPEN_DOCS_TARGET: OpenDocsTarget;
-declare const DEFAULT_OPEN_DOCS_PROMPT = "Read this documentation: {url}";
-declare const DEFAULT_OPEN_DOCS_PROVIDER_IDS: readonly ["chatgpt", "claude"];
-declare function normalizePromptProviderName(name: string): string;
-declare function serializeDocsIcon(icon: unknown): string | undefined;
-declare function serializeDocsIconRegistry(icons?: Record<string, unknown>): Record<string, string> | undefined;
-declare function serializeOpenDocsProviders(providers?: OpenDocsProvider[], options?: SerializeOpenDocsProviderOptions): SerializedOpenDocsProvider[] | undefined;
-declare function serializeOpenDocsProvider(provider: OpenDocsProvider, options?: SerializeOpenDocsProviderOptions): SerializedOpenDocsProvider | undefined;
-declare function parsePromptStringArray(value: unknown): string[] | undefined;
-declare function resolvePromptProviderChoices(availableProviders?: PromptProviderInput[], preferredNames?: string[]): PromptProviderChoice[];
-declare function sanitizePromptText(text: string): string;
-//#endregion
-//#region src/sitemap.d.ts
-declare const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
-declare const DEFAULT_SITEMAP_MD_ROUTE = "/sitemap.md";
-declare const DEFAULT_SITEMAP_MD_DOCS_ROUTE = "/docs/sitemap.md";
-declare const DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE = "/.well-known/sitemap.md";
-declare const DEFAULT_SITEMAP_MANIFEST_PATH = ".farming-labs/sitemap-manifest.json";
-type DocsSitemapFormat = "xml" | "markdown";
-interface DocsSitemapPageInput {
-  slug?: string;
-  url: string;
-  /** Override the public Markdown representation URL when it differs from `${url}.md`. */
-  markdownUrl?: string;
-  title: string;
-  description?: string;
-  related?: ResolvedDocsRelatedLink[];
-  sourcePath?: string;
-  lastmod?: string;
-  lastModified?: string;
-}
-interface DocsSitemapManifestPage {
-  url: string;
-  absoluteUrl?: string;
-  markdownUrl: string;
-  title: string;
-  description?: string;
-  sourcePath?: string;
-  lastmod?: string;
-  lastmodSource?: "git" | "filesystem" | "frontmatter" | "manifest" | "unknown";
-  related?: string[];
-}
-interface DocsSitemapManifest {
-  version: 1;
-  generatedAt: string;
-  baseUrl?: string;
-  entry: string;
-  siteTitle?: string;
-  pages: DocsSitemapManifestPage[];
-}
-interface DocsSitemapResolvedConfig {
-  enabled: boolean;
-  routePrefix: string;
-  baseUrl?: string;
-  manifestPath: string;
-  xml: {
-    enabled: boolean;
-    includeLastmod: boolean;
-    route: string;
-  };
-  markdown: {
-    enabled: boolean;
-    includeDescriptions: boolean;
-    includeLastmod: boolean;
-    linkTarget: "html" | "markdown" | "both";
-    route: string;
-    docsRoute?: string;
-    wellKnownRoute: string;
-  };
-}
-interface CreateDocsSitemapResponseOptions extends DocsDiscoveryApiRouteOptions {
-  request: Request;
-  sitemap?: boolean | DocsSitemapConfig;
-  entry?: string;
-  siteTitle?: string;
-  baseUrl?: string;
-  pages: DocsSitemapPageInput[];
-  manifest?: DocsSitemapManifest | null;
-}
-declare function resolveDocsSitemapConfig(sitemap?: boolean | DocsSitemapConfig, defaults?: {
-  baseUrl?: string;
-}): DocsSitemapResolvedConfig;
-declare function resolveDocsSitemapRequest(url: URL, sitemap?: boolean | DocsSitemapConfig, options?: DocsDiscoveryApiRouteOptions): DocsSitemapFormat | null;
-declare function toDocsSitemapMarkdownUrl(url: string): string;
-declare function buildDocsSitemapManifest(options: {
-  pages: DocsSitemapPageInput[];
-  entry?: string;
-  siteTitle?: string;
-  baseUrl?: string;
-  generatedAt?: string;
-  resolveLastmod?: (page: DocsSitemapPageInput) => {
-    lastmod?: string;
-    lastmodSource?: DocsSitemapManifestPage["lastmodSource"];
-  } | undefined;
-}): DocsSitemapManifest;
-declare function renderDocsSitemapXml(manifest: DocsSitemapManifest, options?: {
-  baseUrl?: string;
-  includeLastmod?: boolean;
-}): string;
-declare function renderDocsSitemapMarkdown(manifest: DocsSitemapManifest, options?: {
-  baseUrl?: string;
-  includeDescriptions?: boolean;
-  includeLastmod?: boolean;
-  linkTarget?: "html" | "markdown" | "both";
-}): string;
-declare function readDocsSitemapManifestFromContentMap(contentMap?: Record<string, string> | null): DocsSitemapManifest | null;
-declare function resolveDocsSitemapPageLastmod(manifest: DocsSitemapManifest | null | undefined, url: string): string | undefined;
-declare function createDocsSitemapResponse({
-  request,
-  apiRoute,
-  sitemap,
-  entry,
-  siteTitle,
-  baseUrl,
-  pages,
-  manifest
-}: CreateDocsSitemapResponseOptions): Response | null;
-//#endregion
-//#region src/pagination.d.ts
-declare class DocsPaginationCursorError extends Error {
-  readonly code = "invalid_cursor";
-  constructor();
-}
-//#endregion
-//#region src/retrieval-digest.d.ts
-/** Validate the bounded HTTP(S) URL or root-relative URI reference used by provenance. */
-declare function isDocsRetrievalCanonicalUrl(value: string): boolean;
-/** Hash exact bytes with portable SHA-256 in Node, edge, and browser runtimes. */
-declare function sha256DocsContent(value: string | Uint8Array): string;
-/** Hash exact message-content bytes with portable SHA-256. */
-declare function digestDocsContent(value: string | Uint8Array): `sha256:${string}`;
-/**
- * Hash the normalized retrieval projection used by search provenance.
- *
- * The projection removes one leading BOM, normalizes line endings to LF, and trims
- * trailing whitespace. This deliberately differs from HTTP digests over exact bytes.
- */
-declare function digestDocsRetrievalContent(value: string): `sha256:${string}`;
-//#endregion
-export { PromptProviderChoice as A, serializeOpenDocsProviders as B, resolveDocsSitemapRequest as C, DEFAULT_OPEN_DOCS_TARGET as D, DEFAULT_OPEN_DOCS_PROVIDER_IDS as E, resolvePromptProviderChoices as F, sanitizePromptText as I, serializeDocsIcon as L, SerializedOpenDocsProvider as M, normalizePromptProviderName as N, DEFAULT_PROMPT_PROVIDER_TEMPLATES as O, parsePromptStringArray as P, serializeDocsIconRegistry as R, resolveDocsSitemapPageLastmod as S, DEFAULT_OPEN_DOCS_PROMPT as T, createDocsSitemapResponse as _, DocsPaginationCursorError as a, renderDocsSitemapXml as b, DEFAULT_SITEMAP_MD_ROUTE as c, DocsSitemapFormat as d, DocsSitemapManifest as f, buildDocsSitemapManifest as g, DocsSitemapResolvedConfig as h, sha256DocsContent as i, SerializeOpenDocsProviderOptions as j, PromptAction as k, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as l, DocsSitemapPageInput as m, digestDocsRetrievalContent as n, DEFAULT_SITEMAP_MANIFEST_PATH as o, DocsSitemapManifestPage as p, isDocsRetrievalCanonicalUrl as r, DEFAULT_SITEMAP_MD_DOCS_ROUTE as s, digestDocsContent as t, DEFAULT_SITEMAP_XML_ROUTE as u, readDocsSitemapManifestFromContentMap as v, toDocsSitemapMarkdownUrl as w, resolveDocsSitemapConfig as x, renderDocsSitemapMarkdown as y, serializeOpenDocsProvider as z };