@farming-labs/docs 0.2.104 → 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-Cqq8QmlH.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-BthCiAD9.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-BthCiAD9.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. */
@@ -1312,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. */
@@ -2728,6 +2746,7 @@ interface DocsOpenApiMcpCredentialContext {
   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. */
@@ -2742,6 +2761,20 @@ interface DocsOpenApiMcpConfig {
   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 {
   /**
@@ -4100,4 +4133,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { DocsAgentGoldenQueryVariant as $, DocsSearchFilterInput as $n, ReadingTimeConfig as $r, DocsMcpAuthenticateContext as $t, DocsAgentA2ASecurityScheme as A, DocsReviewRulesConfig as An, LlmsTxtSectionConfig as Ar, DocsCodeBlocksConfig as At, DocsAgentEvaluationAnswerRunner as B, DocsSearchAmbiguityDecisionStatus as Bn, PageActionConnectMcpConfig as Br, DocsContentChangeSnapshotContext as Bt, DocsAgentA2AOAuthDeviceCodeFlow as C, DocsPaginatedSearchResponse as Cn, FeedbackConfig as Cr, DocsAskAIFeedbackValue as Ct, DocsAgentA2AOpenIdConnectSecurityScheme as D, DocsReviewCiConfig as Dn, LlmsTxtConfig as Dr, DocsCloudFeatureConfig as Dt, DocsAgentA2AOAuthPasswordFlow as E, DocsRetrievalSourceScope as En, LastUpdatedConfig as Er, DocsCloudConfig as Et, DocsAgentContentChangesConfig as F, DocsSearchAdapter as Fn, OpenDocsProviderConfig as Fr, DocsCodeBlocksValidateConfig as Ft, DocsAgentFeedbackContext as G, DocsSearchEmbeddingsConfig as Gn, PageAgentCommand as Gr, DocsContentSnapshot as Gt, DocsAgentEvaluationSurface as H, DocsSearchChunkingConfig as Hn, PageActionMcpProvider as Hr, DocsContentChangeSnapshotSaver as Ht, DocsAgentEvaluationAnswerInput as I, DocsSearchAdapterContext as In, OpenDocsProviderId as Ir, DocsCodeBlocksValidationMode as It, DocsAgentGoldenAuthenticatedContentExpectation as J, DocsSearchFacetValue as Jn, PageAgentVerification as Jr, DocsFeedbackValue as Jt, DocsAgentFeedbackData as K, DocsSearchExplanation as Kn, PageAgentFailureMode as Kr, DocsContentSnapshotDocument as Kt, DocsAgentEvaluationAnswerProvider as L, DocsSearchAdapterFactory as Ln, OpenDocsTarget as Lr, DocsCodeBlocksValidationPolicy as Lt, DocsAgentA2ASkill as M, DocsReviewSeverity as Mn, OGConfig as Mr, DocsCodeBlocksPlannerProvider as Mt, DocsAgentCompactConfig as N, DocsRobotsConfig as Nn, OpenDocsConfig as Nr, DocsCodeBlocksRunnerConfig as Nt, DocsAgentA2AProtocolBinding as O, DocsReviewCiMode as On, LlmsTxtMaxCharsConfig as Or, DocsCloudPreviewConfig as Ot, DocsAgentConfig as P, DocsRobotsRule as Pn, OpenDocsProvider as Pr, DocsCodeBlocksRunnerProvider as Pt, DocsAgentGoldenPromptInjectionExpectation as Q, DocsSearchFilterField as Qn, PageTwitter as Qr, DocsMcpAuthenticate as Qt, DocsAgentEvaluationAnswerRequest as R, DocsSearchAdapterPage as Rn, OpenGraphImage as Rr, DocsConfig as Rt, DocsAgentA2AOAuthClientCredentialsFlow as S, DocsOpenApiMcpHeaders as Sn, DocsTheme as Sr, DocsAskAIFeedbackMessage as St, DocsAgentA2AOAuthImplicitFlow as T, DocsRetrievalSourceProvenance as Tn, GithubConfig as Tr, DocsCloudApiKeyConfig as Tt, DocsAgentEvaluationTaskInput as U, DocsSearchConfig as Un, PageActionsConfig as Ur, DocsContentChangedDocument as Ut, DocsAgentEvaluationSourceReference as V, DocsSearchAmbiguityResolution as Vn, PageActionInstallSkillsConfig as Vr, DocsContentChangeSnapshotLoader as Vt, DocsAgentEvaluationsConfig as W, DocsSearchDocument as Wn, PageAgentAppliesTo as Wr, DocsContentChangesResponse as Wt, DocsAgentGoldenExpectedExample as X, DocsSearchFilterDecision as Xn, PageOpenGraph as Xr, DocsMcpAllowedOrigins as Xt, DocsAgentGoldenExampleVerification as Y, DocsSearchFacetsResponse as Yn, PageFrontmatter as Yr, DocsI18nConfig as Yt, DocsAgentGoldenFreshnessExpectation as Z, DocsSearchFilterDecisionOutcome as Zn, PageSidebarFrontmatter as Zr, DocsMcpAuthPrincipal as Zt, DocsAgentA2AHttpAuthSecurityScheme as _, DocsOkfTrustMetadata as _n, DocsTelemetryEvent as _r, DocsAnalyticsSource as _t, ApiReferenceRenderer as a, SidebarFolderNode as ai, DocsMcpProtectedResourceConfig as an, DocsSearchRankingReasonCode as ar, DocsAgentSkillsCompatibilityPolicy as at, DocsAgentA2AOAuth2SecurityScheme as b, DocsOpenApiMcpConfig as bn, DocsTelemetryFeatures as br, DocsAskAIFeedbackConfig as bt, ChangelogFrontmatter as c, SidebarTree as ci, DocsMetadata as cn, DocsSearchResponse as cr, DocsAgentSkillsProgressiveDisclosureConfig as ct, CopyMarkdownFormat as d, TypesenseDocsSearchConfig as di, DocsObservabilityEvent as dn, DocsSearchSourcePage as dr, DocsAgentTraceStatus as dt, ReadingTimeFormat as ei, DocsMcpAuthenticateResult as en, DocsSearchFilters as er, DocsAgentGoldenQueryVariantKind as et, CustomDocsSearchConfig as f, TypographyConfig as fi, DocsObservabilityEventInput as fn, DocsSearchWarning as fr, DocsAnalyticsConfig as ft, DocsAgentA2AExtension as g, DocsOkfStatus as gn, DocsTelemetryConfig as gr, DocsAnalyticsInput as gt, DocsAgentA2AConfig as h, DocsOkfSource as hn, DocsTelemetryAgentSurface as hr, DocsAnalyticsEventType as ht, ApiReferenceConfig as i, SidebarFolderIndexBehavior as ii, DocsMcpPromptsConfig as in, DocsSearchRankingReason as ir, DocsAgentGoldenTaskFilters as it, DocsAgentA2ASecurityScopeList as j, DocsReviewScoreConfig as jn, McpDocsSearchConfig as jr, DocsCodeBlocksPlannerConfig as jt, DocsAgentA2ASecurityRequirement as k, DocsReviewConfig as kn, LlmsTxtMaxCharsMode as kr, DocsCloudPublishConfig as kt, CodeBlockCopyData as l, SimpleDocsSearchConfig as li, DocsNav as ln, DocsSearchResult as lr, DocsAgentTraceEventInput as lt, DocsAgentA2ACapabilities as m, DocsOkfConfig as mn, DocsSitemapConfig as mr, DocsAnalyticsEventInput as mt, AgentFeedbackConfig as n, SidebarComponentProps as ni, DocsMcpCorsConfig as nn, DocsSearchMatchedTerm as nr, DocsAgentGoldenTask as nt, BreadcrumbConfig as o, SidebarNode as oi, DocsMcpSecurityConfig as on, DocsSearchRankingStrategy as or, DocsAgentSkillsConfig as ot, DocsAgentA2AApiKeySecurityScheme as p, UIConfig as pi, DocsOkfActorTimestamp as pn, DocsSearchWarningCode as pr, DocsAnalyticsEvent as pt, DocsAgentGoldenAnswerExpectation as q, DocsSearchFacet as qn, PageAgentFrontmatter as qr, DocsFeedbackData as qt, AlgoliaDocsSearchConfig as r, SidebarConfig as ri, DocsMcpOriginContext as rn, DocsSearchQuery as rr, DocsAgentGoldenTaskExpectation as rt, ChangelogConfig as s, SidebarPageNode as si, DocsMcpToolsConfig as sn, DocsSearchRequest as sr, DocsAgentSkillsInput as st, AIConfig as t, ResolvedDocsRelatedLink as ti, DocsMcpConfig as tn, DocsSearchMatchField as tr, DocsAgentGoldenSafetyExpectation as tt, CopyMarkdownConfig as u, ThemeToggleConfig as ui, DocsObservabilityConfig as un, DocsSearchResultType as ur, DocsAgentTraceEventType as ut, DocsAgentA2AInterfaceConfig as v, DocsOkfTrustMetadataInput as vn, DocsTelemetryEventInput as vr, DocsAskAIActionData as vt, DocsAgentA2AOAuthFlows as w, DocsRelatedItem as wn, FontStyle as wr, DocsAskAIMcpConfig as wt, DocsAgentA2AOAuthAuthorizationCodeFlow as x, DocsOpenApiMcpCredentialContext as xn, DocsTelemetryFramework as xr, DocsAskAIFeedbackData as xt, DocsAgentA2AMutualTlsSecurityScheme as y, DocsOkfTrustTier as yn, DocsTelemetryEventType as yr, DocsAskAIActionType as yt, DocsAgentEvaluationAnswerResult as z, DocsSearchAmbiguityDecision as zn, OrderingItem 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-B0OA_7jE.mjs → upgrade-B92U83xo.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec } from "./utils-DcCUwxqS.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-P4TT_9IO.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.104",
+  "version": "0.2.105",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",

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

@@ -1,164 +0,0 @@
-import { Lr as OpenDocsTarget, Pr as OpenDocsProvider, mr as DocsSitemapConfig, ti as ResolvedDocsRelatedLink } from "./types-BthCiAD9.mjs";
-import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-Cqq8QmlH.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 };