@farming-labs/docs 0.2.104 → 0.2.105

package/dist/{agent-NerpHcQB.mjs → agent-CaCWThBY.mjs}

@@ -1,8 +1,8 @@
-import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-PSrgiJD8.mjs";
-import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
-import { f as parseGeneratedAgentDocument, l as GENERATED_AGENT_PROVENANCE_VERSION, p as serializeGeneratedAgentDocument, u as hashGeneratedAgentContent } from "./openapi-mcp-B7u7Y0gB.mjs";
+import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-BKy4labo.mjs";
+import { V as findDocsMarkdownPage, ot as renderDocsMarkdownDocument } from "./agent-DCTGj6J7.mjs";
+import { d as GENERATED_AGENT_PROVENANCE_VERSION, f as hashGeneratedAgentContent, h as serializeGeneratedAgentDocument, m as parseGeneratedAgentDocument } from "./openapi-mcp-DQ3xptKo.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-BhF6J2N4.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-DrZ3fXgf.mjs";
 import { createRequire } from "node:module";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";

package/dist/{agent-PSrgiJD8.mjs → agent-DCTGj6J7.mjs}

@@ -1,6 +1,7 @@
-import { S as upsertPageAgentContractMarkdown, a as findDocsGeneratedAgentContractRanges, b as renderPageAgentFrontmatterYamlLines, d as PAGE_AGENT_CONTRACT_END_MARKER, l as stripDocsGeneratedAgentContractMarkers, m as PAGE_AGENT_CONTRACT_START_MARKER, o as findDocsMarkdownSection, p as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, s as parseDocsMarkdownSections, y as renderPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
-import { B as createDocsCacheableResponse, F as isDocsStandardsDiscoveryRequest, I as resolveDocsDiscoveryApiRoute, K as digestDocsRetrievalContent, M as createDocsStandardsResponse, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, W as resolveDocsHttpDate, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, k as buildDocsApiCatalog, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, q as isDocsRetrievalCanonicalUrl, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-Ckx0tN7B.mjs";
+import { C as filterDocsPagesByAccess, S as upsertPageAgentContractMarkdown, T as isDocsPageAccessAllowed, a as findDocsGeneratedAgentContractRanges, b as renderPageAgentFrontmatterYamlLines, d as PAGE_AGENT_CONTRACT_END_MARKER, l as stripDocsGeneratedAgentContractMarkers, m as PAGE_AGENT_CONTRACT_START_MARKER, o as findDocsMarkdownSection, p as PAGE_AGENT_CONTRACT_FIELD_SCHEMA, s as parseDocsMarkdownSections, y as renderPageAgentContractMarkdown } from "./markdown-sections-BKy4labo.mjs";
+import { n as digestDocsRetrievalContent, r as isDocsRetrievalCanonicalUrl } from "./retrieval-digest-B-SgtXKK.mjs";
 import { t as resolveDocsAudienceExposure } from "./audience-exposure-DVsfT9Sx.mjs";
+import { B as createDocsCacheableResponse, F as isDocsStandardsDiscoveryRequest, I as resolveDocsDiscoveryApiRoute, M as createDocsStandardsResponse, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, W as resolveDocsHttpDate, _ as DEFAULT_API_CATALOG_FORMAT, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, c as DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, k as buildDocsApiCatalog, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, w as DOCS_AGENT_MANIFEST_SCHEMA_URI } from "./standards-discovery-Bpz90VYq.mjs";
 import { createProcessor } from "@mdx-js/mdx";
 
 //#region src/okf.ts
@@ -3134,17 +3135,18 @@ async function buildDocsSearchIndexGeneration(pages, options) {
 * locale, base URL, and chunking policy.
 */
 async function buildDocsContentSnapshot(options) {
+	const pages = filterDocsPagesByAccess(options.pages, options.principal);
 	const audience = resolveDocsSearchAudience(options.audience);
 	const search = normalizeDocsSearchConfig(options.search);
 	const digestCache = /* @__PURE__ */ new Map();
-	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(options.pages, {
+	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(pages, {
 		audience,
 		chunking: search.chunking,
 		locale: options.locale,
 		baseUrl: options.baseUrl,
 		digestCache
 	});
-	const documents = await Promise.all(options.pages.map(async (page) => {
+	const documents = await Promise.all(pages.map(async (page) => {
 		const localizedPage = localizeDocsSearchPage(page, options.locale);
 		const source = await buildDocsRetrievalSource(page, localizedPage.url, {
 			audience,
@@ -5131,7 +5133,9 @@ async function performDocsSearchInternal(options) {
 	const audience = resolveDocsSearchAudience(options.audience);
 	const filters = normalizeDocsSearchFilters(options.filters);
 	const hasFilters = hasDocsSearchFilters(filters);
-	const corpusPages = options.pages.map((page) => localizeDocsSearchPage(page, options.locale));
+	const accessiblePages = filterDocsPagesByAccess(options.pages, options.principal);
+	const accessibleGenerationPages = filterDocsPagesByAccess(options.generationPages ?? options.pages, options.principal);
+	const corpusPages = accessiblePages.map((page) => localizeDocsSearchPage(page, options.locale));
 	const indexBaseUrl = options.syncBaseUrl === null ? void 0 : options.syncBaseUrl ?? options.baseUrl;
 	const scopedPages = hasFilters ? corpusPages.filter((page) => docsSearchPageMatchesFilters(resolveDocsSearchPageScope(page), filters)) : corpusPages;
 	let resolvedDocuments;
@@ -5170,7 +5174,7 @@ async function performDocsSearchInternal(options) {
 	};
 	let currentIndexGeneration;
 	const getCurrentIndexGeneration = () => {
-		currentIndexGeneration ??= options.indexGeneration ? Promise.resolve(options.indexGeneration) : buildDocsSearchIndexGeneration(options.generationPages ?? options.pages, {
+		currentIndexGeneration ??= options.indexGeneration ? Promise.resolve(options.indexGeneration) : buildDocsSearchIndexGeneration(accessibleGenerationPages, {
 			audience,
 			chunking: search.chunking,
 			locale: options.locale,
@@ -5181,7 +5185,7 @@ async function performDocsSearchInternal(options) {
 	const requireCurrentIndexGeneration = search.provider === "algolia" || search.provider === "typesense";
 	let hostedIndexGeneration;
 	const getHostedIndexGeneration = () => {
-		hostedIndexGeneration ??= audience === "human" ? getCurrentIndexGeneration() : buildDocsSearchIndexGeneration(options.generationPages ?? options.pages, {
+		hostedIndexGeneration ??= audience === "human" ? getCurrentIndexGeneration() : buildDocsSearchIndexGeneration(accessibleGenerationPages, {
 			audience: "human",
 			chunking: search.chunking,
 			locale: options.locale,
@@ -5435,8 +5439,9 @@ async function buildDocsSearchFacets(options) {
 	const requestedLimit = options.limit ?? MAX_SEARCH_FACET_VALUES;
 	if (!Number.isSafeInteger(requestedLimit) || requestedLimit < 1 || requestedLimit > MAX_SEARCH_FACET_VALUES) throw new DocsSearchRequestError("Search limit must be an integer between 1 and 100.");
 	if (options.cursor !== void 0 && options.facet === void 0) throw new DocsSearchRequestError("Facet continuation cursors require a `facet` field.");
-	const pages = options.pages.map((page) => localizeDocsSearchPage(page, options.locale)).map((page) => ({ scope: resolveDocsSearchPageScope(page) }));
-	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(options.pages, {
+	const accessiblePages = filterDocsPagesByAccess(options.pages, options.principal);
+	const pages = accessiblePages.map((page) => localizeDocsSearchPage(page, options.locale)).map((page) => ({ scope: resolveDocsSearchPageScope(page) }));
+	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(accessiblePages, {
 		audience,
 		chunking: search.chunking,
 		locale: options.locale,
@@ -5581,7 +5586,7 @@ async function performDocsSearchWithMetadata(options) {
 	const search = normalizeDocsSearchConfig(options.search);
 	const requestedLimit = options.limit ?? search.maxResults ?? DEFAULT_SEARCH_LIMIT;
 	const limit = Number.isFinite(requestedLimit) && requestedLimit > 0 ? Math.max(1, Math.floor(requestedLimit)) : DEFAULT_SEARCH_LIMIT;
-	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(options.generationPages ?? options.pages, {
+	const indexGeneration = options.indexGeneration ?? await buildDocsSearchIndexGeneration(filterDocsPagesByAccess(options.generationPages ?? options.pages, options.principal), {
 		audience,
 		chunking: search.chunking,
 		locale: options.locale,
@@ -7299,6 +7304,7 @@ function renderLlmsFullTxtPages(pages, baseUrl) {
 	return content;
 }
 function renderDocsLlmsTxt(pages, options = {}) {
+	pages = filterDocsPagesByAccess(pages);
 	const siteTitle = options.siteTitle ?? "Documentation";
 	const siteDescription = options.siteDescription;
 	const baseUrl = options.baseUrl ?? "";
@@ -8148,7 +8154,7 @@ function appendDocsMarkdownSectionQuery(value, sectionRequest) {
 }
 /** Build one standards-aware Markdown response for every framework adapter. */
 function createDocsMarkdownResponse(options) {
-	const { request, document, entry = "docs", requestedPath, origin = new URL(request.url).origin, pages, sitemap, locale } = options;
+	const { request, document, entry = "docs", requestedPath, origin = new URL(request.url).origin, pages: rawPages, sitemap, locale } = options;
 	const canonicalUrl = options.canonicalUrl ?? resolveDocsMarkdownCanonicalUrl({
 		origin,
 		entry,
@@ -8165,6 +8171,15 @@ function createDocsMarkdownResponse(options) {
 		...locale ? { "Content-Language": locale } : {},
 		...varyHeader ? { Vary: varyHeader } : {}
 	};
+	const pages = rawPages ? filterDocsPagesByAccess(rawPages, options.principal) : void 0;
+	if (!isDocsPageAccessAllowed(options.access, options.principal)) return new Response("Not Found", {
+		status: 404,
+		headers: {
+			...baseSharedHeaders,
+			"Cache-Control": "private, no-store",
+			"Content-Type": "text/plain; charset=utf-8"
+		}
+	});
 	if (!document) {
 		const recovery = resolveDocsMarkdownRecovery({
 			entry,
@@ -8512,6 +8527,12 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 		format: DOCS_AGENT_MANIFEST_FORMAT,
 		version: DOCS_AGENT_MANIFEST_VERSION,
 		name: "@farming-labs/docs",
+		profile: "full",
+		profiles: {
+			default: "full",
+			full: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
+			compact: `${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}?profile=compact`
+		},
 		baseUrl: origin,
 		site: {
 			title: llms?.siteTitle ?? "Documentation",
@@ -8829,6 +8850,21 @@ function buildDocsAgentDiscoverySpec({ origin, entry = "docs", apiRoute, apiCata
 		}
 	};
 }
+/** Remove first-hop file inventories while retaining every discovery route and capability. */
+function compactDocsAgentDiscoverySpec(spec) {
+	return {
+		...spec,
+		profile: "compact",
+		skills: {
+			...spec.skills,
+			published: spec.skills.published.map((skill) => ({
+				...skill,
+				fileCount: skill.files.length,
+				files: []
+			}))
+		}
+	};
+}
 function acceptsDocsMarkdown(request) {
 	const accept = request.headers.get("accept");
 	if (!accept) return false;
@@ -8921,4 +8957,4 @@ function toYamlString(value) {
 }
 
 //#endregion
-export { matchesDocsLlmsTxtSection as $, resolveDocsMcpProtectedResourceMetadataLocation as $n, buildDocsRetrievalDigestProjection as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentLocale as An, DEFAULT_SITEMAP_XML_ROUTE as At, findDocsMarkdownPage as B, DEFAULT_MCP_PUBLIC_ROUTE as Bn, DOCS_CONTENT_CHANGES_FORMAT as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, findDocsAudienceMdxTags as Cn, selectDocsMarkdownSection as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, agentVersionConstraintMatches as Dn, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, agentVersionConstraintGroupsOverlap as En, DEFAULT_SITEMAP_MANIFEST_PATH as Et, buildDocsMcpEndpointCandidates as F, paginateDocsItems as Fn, renderDocsSitemapXml as Ft, isDocsAgentDiscoveryRequest as G, getDocsMcpResourcePaths as Gn, createDocsContentChangesHttpResponse as Gt, getDocsMarkdownCanonicalLinkHeader as H, DEFAULT_MCP_WELL_KNOWN_ROUTE as Hn, DOCS_CONTENT_SNAPSHOT_FORMAT as Ht, collectDocsMarkdownSections as I, resolveDocsPaginationOffset as In, resolveDocsSitemapConfig as It, isDocsDiagnosticsRequest as J, isDocsMcpProtectedResourceMetadataPath as Jn, resolveDocsContentChangesConfig as Jt, isDocsAgentsRequest as K, hasDocsMcpProtectedResourceConfig as Kn, isDocsContentChangeGeneration as Kt, createDocsMarkdownResponse as L, normalizeDocsRelated as Ln, resolveDocsSitemapPageLastmod as Lt, buildDocsConfigMap as M, normalizeAgentVersion as Mn, createDocsSitemapResponse as Mt, buildDocsDiagnostics as N, DocsPaginationCursorError as Nn, readDocsSitemapManifestFromContentMap as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintsOverlap as On, DEFAULT_SITEMAP_MD_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, createDocsPaginationCursor as Pn, renderDocsSitemapMarkdown as Pt, isDocsSkillRequest as Q, normalizeDocsMcpEndpointPath as Qn, buildDocsContentSnapshot as Qt, createDocsStandardsDiscoveryResponse as R, renderDocsRelatedMarkdownLines as Rn, resolveDocsSitemapRequest as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, findDocsAudienceMdxIssues as Sn, selectDocsLlmsTxtContent as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, resolveDocsAudienceMdxContent as Tn, validateDocsAgentFeedbackPayload as Tt, getDocsMarkdownVaryHeader as U, buildDocsMcpProtectedResourceMetadataRoute as Un, DocsContentChangesRequestError as Ut, getDocsLlmsTxtMaxCharsIssue as V, DEFAULT_MCP_ROUTE as Vn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Vt, hasDocsMarkdownSignatureAgent as W, getDocsMcpProtectedResourceMetadataRoutes as Wn, createDocsContentChangeFeed as Wt, isDocsMarkdownSectionIndexRequest as X, isDocsMcpResourcePath as Xn, DocsSearchRequestError as Xt, isDocsLlmsTxtPublicRequest as Y, isDocsMcpRequest as Yn, resolveDocsContentChangesRequest as Yt, isDocsPublicGetRequest as Z, normalizeDocsMcpAuthorizationServerUrls as Zn, buildDocsAskAIContext as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsSearchFilters as _n, resolveDocsMarkdownRequest as _t, DEFAULT_AGENT_MD_ROUTE as a, createSimpleSearchAdapter as an, normalizeDocsOkfTrustMetadataInput as ar, renderDocsMarkdownDocument as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveSearchRequestConfig as bn, resolveDocsRequestApiRoute as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, formatDocsAskAIPackageHints as cn, resolveDocsAgentContractMcpTools as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, performDocsSearch as dn, resolveDocsAgentsFormat as dt, buildDocsSearchDocuments as en, resolveDocsMcpResourceLocation as er, normalizeDocsPathSegment as et, DEFAULT_DOCS_CONFIG_ROUTE as f, performDocsSearchWithMetadata as fn, resolveDocsLlmsTxtFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsSearchError as gn, resolveDocsMarkdownRecovery as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsSearchAudience as hn, resolveDocsMarkdownCanonicalUrl as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, createMcpSearchAdapter as in, buildDocsOkfBundle as ir, renderDocsLlmsTxt as it, buildDocsAgentFeedbackSchema as j, normalizeAgentScopeValues as jn, buildDocsSitemapManifest as jt, acceptsDocsMarkdown as k, normalizeAgentFramework as kn, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, inferDocsAskAIPackageHints as ln, resolveDocsAgentFeedbackConfig as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveDocsRetrievalLastModified as mn, resolveDocsLlmsTxtSections as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, createAlgoliaSearchAdapter as nn, DOCS_OKF_BUNDLE_FORMAT as nr, parseDocsAgentFeedbackData as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, createTypesenseSearchAdapter as on, resolveDocsOkfConfig as or, renderDocsMarkdownNotFound as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, resolveAskAISearchRequestConfig as pn, resolveDocsLlmsTxtRequest as pt, isDocsConfigRequest as q, isDocsMcpOAuthScopeToken as qn, isDocsContentChangesRequest as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, createCustomSearchAdapter as rn, DOCS_OKF_VERSION as rr, renderDocsAgentsDocument as rt, DEFAULT_AGENT_SPEC_ROUTE as s, enrichDocsSearchDocumentsWithProvenance as sn, resolveDocsOkfTrustMetadata as sr, renderDocsSkillDocument as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsSearchFacets as tn, DEFAULT_DOCS_OKF_ROUTE as tr, normalizeDocsUrlPath as tt, DEFAULT_DOCS_API_ROUTE as u, normalizeDocsSearchFilters as un, resolveDocsAgentFeedbackRequest as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSearchRequest as vn, resolveDocsMarkdownSectionRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, resolveDocsAgentMdxContent as wn, toDocsMarkdownUrl as wt, DEFAULT_SKILL_MD_ROUTE as x, extractDocsMarkdownPromptBlocks as xn, resolveDocsSkillFormat as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveLocalDocsMcpSearchConfig as yn, resolveDocsOpenApiDiscoveryConfig as yt, detectDocsMarkdownAgentRequest as z, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as zn, toDocsSitemapMarkdownUrl as zt };
+export { isDocsSkillRequest as $, normalizeDocsMcpEndpointPath as $n, buildDocsContentSnapshot as $t, buildDocsAgentDiscoverySpec as A, normalizeAgentFramework as An, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as At, detectDocsMarkdownAgentRequest as B, DEFAULT_MCP_PROTECTED_RESOURCE_METADATA_ROUTE as Bn, toDocsSitemapMarkdownUrl as Bt, DOCS_AI_AGENT_USER_AGENT_HEADER_PATTERN as C, findDocsAudienceMdxIssues as Cn, selectDocsLlmsTxtContent as Ct, DOCS_MARKDOWN_SIGNATURE_AGENT_HEADER as D, agentVersionConstraintGroupsOverlap as Dn, DEFAULT_SITEMAP_MANIFEST_PATH as Dt, DOCS_MARKDOWN_SECTION_INDEX_FORMAT as E, resolveDocsAudienceMdxContent as En, validateDocsAgentFeedbackPayload as Et, buildDocsMcpEndpointCandidates as F, createDocsPaginationCursor as Fn, renderDocsSitemapMarkdown as Ft, hasDocsMarkdownSignatureAgent as G, getDocsMcpProtectedResourceMetadataRoutes as Gn, createDocsContentChangeFeed as Gt, getDocsLlmsTxtMaxCharsIssue as H, DEFAULT_MCP_ROUTE as Hn, DOCS_CONTENT_CHANGES_RESPONSE_VALUE as Ht, collectDocsMarkdownSections as I, paginateDocsItems as In, renderDocsSitemapXml as It, isDocsConfigRequest as J, isDocsMcpOAuthScopeToken as Jn, isDocsContentChangesRequest as Jt, isDocsAgentDiscoveryRequest as K, getDocsMcpResourcePaths as Kn, createDocsContentChangesHttpResponse as Kt, compactDocsAgentDiscoverySpec as L, resolveDocsPaginationOffset as Ln, resolveDocsSitemapConfig as Lt, buildDocsConfigMap as M, normalizeAgentScopeValues as Mn, buildDocsSitemapManifest as Mt, buildDocsDiagnostics as N, normalizeAgentVersion as Nn, createDocsSitemapResponse as Nt, DOCS_TRADITIONAL_BOT_USER_AGENT_HEADER_PATTERN as O, agentVersionConstraintMatches as On, DEFAULT_SITEMAP_MD_DOCS_ROUTE as Ot, buildDocsMarkdownSectionIndex as P, DocsPaginationCursorError as Pn, readDocsSitemapManifestFromContentMap as Pt, isDocsPublicGetRequest as Q, normalizeDocsMcpAuthorizationServerUrls as Qn, buildDocsAskAIContext as Qt, createDocsMarkdownResponse as R, normalizeDocsRelated as Rn, resolveDocsSitemapPageLastmod as Rt, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as S, extractDocsMarkdownPromptBlocks as Sn, resolveDocsSkillFormat as St, DOCS_CONFIG_MAP_TOP_LEVEL_KEYS as T, resolveDocsAgentMdxContent as Tn, toDocsMarkdownUrl as Tt, getDocsMarkdownCanonicalLinkHeader as U, DEFAULT_MCP_WELL_KNOWN_ROUTE as Un, DOCS_CONTENT_SNAPSHOT_FORMAT as Ut, findDocsMarkdownPage as V, DEFAULT_MCP_PUBLIC_ROUTE as Vn, DOCS_CONTENT_CHANGES_FORMAT as Vt, getDocsMarkdownVaryHeader as W, buildDocsMcpProtectedResourceMetadataRoute as Wn, DocsContentChangesRequestError as Wt, isDocsLlmsTxtPublicRequest as X, isDocsMcpRequest as Xn, resolveDocsContentChangesRequest as Xt, isDocsDiagnosticsRequest as Y, isDocsMcpProtectedResourceMetadataPath as Yn, resolveDocsContentChangesConfig as Yt, isDocsMarkdownSectionIndexRequest as Z, isDocsMcpResourcePath as Zn, DocsSearchRequestError as Zt, DEFAULT_LLMS_TXT_MAX_CHARS as _, resolveDocsSearchError as _n, resolveDocsMarkdownRecovery as _t, DEFAULT_AGENT_MD_ROUTE as a, createMcpSearchAdapter as an, buildDocsOkfBundle as ar, renderDocsLlmsTxt as at, DEFAULT_OPENAPI_SCHEMA_ROUTE as b, resolveLocalDocsMcpSearchConfig as bn, resolveDocsOpenApiDiscoveryConfig as bt, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as c, enrichDocsSearchDocumentsWithProvenance as cn, resolveDocsOkfTrustMetadata as cr, renderDocsSkillDocument as ct, DEFAULT_DOCS_CONFIG_FORMAT as d, normalizeDocsSearchFilters as dn, resolveDocsAgentFeedbackRequest as dt, buildDocsRetrievalDigestProjection as en, resolveDocsMcpProtectedResourceMetadataLocation as er, matchesDocsLlmsTxtSection as et, DEFAULT_DOCS_CONFIG_ROUTE as f, performDocsSearch as fn, resolveDocsAgentsFormat as ft, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as g, resolveDocsSearchAudience as gn, resolveDocsMarkdownCanonicalUrl as gt, DEFAULT_LLMS_FULL_TXT_ROUTE as h, resolveDocsRetrievalLastModified as hn, resolveDocsLlmsTxtSections as ht, DEFAULT_AGENT_FEEDBACK_ROUTE as i, createCustomSearchAdapter as in, DOCS_OKF_VERSION as ir, renderDocsAgentsDocument as it, buildDocsAgentFeedbackSchema as j, normalizeAgentLocale as jn, DEFAULT_SITEMAP_XML_ROUTE as jt, acceptsDocsMarkdown as k, agentVersionConstraintsOverlap as kn, DEFAULT_SITEMAP_MD_ROUTE as kt, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as l, formatDocsAskAIPackageHints as ln, resolveDocsAgentContractMcpTools as lt, DEFAULT_DOCS_DIAGNOSTICS_ROUTE as m, resolveAskAISearchRequestConfig as mn, resolveDocsLlmsTxtRequest as mt, DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE as n, buildDocsSearchFacets as nn, DEFAULT_DOCS_OKF_ROUTE as nr, normalizeDocsUrlPath as nt, DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE as o, createSimpleSearchAdapter as on, normalizeDocsOkfTrustMetadataInput as or, renderDocsMarkdownDocument as ot, DEFAULT_DOCS_DIAGNOSTICS_FORMAT as p, performDocsSearchWithMetadata as pn, resolveDocsLlmsTxtFormat as pt, isDocsAgentsRequest as q, hasDocsMcpProtectedResourceConfig as qn, isDocsContentChangeGeneration as qt, DEFAULT_AGENT_FEEDBACK_PAYLOAD_SCHEMA as r, createAlgoliaSearchAdapter as rn, DOCS_OKF_BUNDLE_FORMAT as rr, parseDocsAgentFeedbackData as rt, DEFAULT_AGENT_SPEC_ROUTE as s, createTypesenseSearchAdapter as sn, resolveDocsOkfConfig as sr, renderDocsMarkdownNotFound as st, DEFAULT_AGENTS_MD_ROUTE as t, buildDocsSearchDocuments as tn, resolveDocsMcpResourceLocation as tr, normalizeDocsPathSegment as tt, DEFAULT_DOCS_API_ROUTE as u, inferDocsAskAIPackageHints as un, resolveDocsAgentFeedbackConfig as ut, DEFAULT_LLMS_TXT_ROUTE as v, resolveDocsSearchFilters as vn, resolveDocsMarkdownRequest as vt, DOCS_BOT_LIKE_USER_AGENT_HEADER_PATTERN as w, findDocsAudienceMdxTags as wn, selectDocsMarkdownSection as wt, DEFAULT_SKILL_MD_ROUTE as x, resolveSearchRequestConfig as xn, resolveDocsRequestApiRoute as xt, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as y, resolveDocsSearchRequest as yn, resolveDocsMarkdownSectionRequest as yt, createDocsStandardsDiscoveryResponse as z, renderDocsRelatedMarkdownLines as zn, resolveDocsSitemapRequest as zt };

package/dist/{agent-evals-U9d_db2u.mjs → agent-evals-D-sPJfXz.mjs}

@@ -1,9 +1,9 @@
-import { $t as buildDocsRetrievalDigestProjection, An as normalizeAgentLocale, Dn as agentVersionConstraintMatches, En as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentVersion, On as agentVersionConstraintsOverlap, Zt as buildDocsAskAIContext, bn as resolveSearchRequestConfig, dn as performDocsSearch, jn as normalizeAgentScopeValues, kn as normalizeAgentFramework, un as normalizeDocsSearchFilters } from "./agent-PSrgiJD8.mjs";
-import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-7OoA7ylx.mjs";
-import { K as digestDocsRetrievalContent } from "./standards-discovery-Ckx0tN7B.mjs";
-import { t as getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server-DFqQyO_V.mjs";
+import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-BKy4labo.mjs";
+import { An as normalizeAgentFramework, Dn as agentVersionConstraintGroupsOverlap, Mn as normalizeAgentScopeValues, Nn as normalizeAgentVersion, On as agentVersionConstraintMatches, Qt as buildDocsAskAIContext, dn as normalizeDocsSearchFilters, en as buildDocsRetrievalDigestProjection, fn as performDocsSearch, jn as normalizeAgentLocale, kn as agentVersionConstraintsOverlap, xn as resolveSearchRequestConfig } from "./agent-DCTGj6J7.mjs";
+import { n as digestDocsRetrievalContent } from "./retrieval-digest-B-SgtXKK.mjs";
+import { t as getDocsAgentSkillsConfiguredPaths } from "./agent-skills-server-Ddbf15pY.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
-import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-c3nIrWOM.mjs";
+import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-D90CCJFs.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative } from "node:path";
 import { createJiti } from "jiti";

package/dist/{agent-export-DlBUKkTt.mjs → agent-export-GcTZPLfB.mjs}

@@ -1,18 +1,18 @@
-import { A as buildDocsAgentDiscoverySpec, Ft as renderDocsSitemapXml, It as resolveDocsSitemapConfig, Pt as renderDocsSitemapMarkdown, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, ir as buildDocsOkfBundle, it as renderDocsLlmsTxt, jt as buildDocsSitemapManifest, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, or as resolveDocsOkfConfig, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-PSrgiJD8.mjs";
-import "./markdown-sections-7OoA7ylx.mjs";
-import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, V as formatDocsContentDigest, W as resolveDocsHttpDate, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-Ckx0tN7B.mjs";
-import "./openapi-mcp-B7u7Y0gB.mjs";
-import { t as resolveDocsI18n } from "./i18n-B3BIxShC.mjs";
-import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DNod0XKB.mjs";
-import "./sitemap-server-C2TauhKa.mjs";
-import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-DFqQyO_V.mjs";
-import "./agent-evals-U9d_db2u.mjs";
+import { w as isDocsAgentPageAccessible } from "./markdown-sections-BKy4labo.mjs";
+import { A as buildDocsAgentDiscoverySpec, Ft as renderDocsSitemapMarkdown, It as renderDocsSitemapXml, Lt as resolveDocsSitemapConfig, Mt as buildDocsSitemapManifest, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Tt as toDocsMarkdownUrl, a as DEFAULT_AGENT_MD_ROUTE, ar as buildDocsOkfBundle, at as renderDocsLlmsTxt, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, ct as renderDocsSkillDocument, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsAgentsDocument, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, ot as renderDocsMarkdownDocument, sr as resolveDocsOkfConfig, t as DEFAULT_AGENTS_MD_ROUTE, ut as resolveDocsAgentFeedbackConfig, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-DCTGj6J7.mjs";
+import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, V as formatDocsContentDigest, W as resolveDocsHttpDate, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-Bpz90VYq.mjs";
+import "./openapi-mcp-DQ3xptKo.mjs";
+import { t as resolveDocsI18n } from "./i18n-B1gJ9EW0.mjs";
+import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-BOjWB1ky.mjs";
+import "./sitemap-server-NeVu8W38.mjs";
+import { r as resolveConfiguredAgentSkills } from "./agent-skills-server-Ddbf15pY.mjs";
+import "./agent-evals-D-sPJfXz.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./authoring-mcp-BCM5CJbJ.mjs";
-import "./code-blocks-c3nIrWOM.mjs";
+import "./authoring-mcp-Be7quE5R.mjs";
+import "./code-blocks-D90CCJFs.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-BhF6J2N4.mjs";
-import { t as detectFramework } from "./utils-DcCUwxqS.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-DrZ3fXgf.mjs";
+import { t as detectFramework } from "./utils-Cc1SrVza.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { createHash, randomUUID } from "node:crypto";
@@ -685,7 +685,8 @@ async function exportAgentBundle(options = {}) {
 		};
 	});
 	if (localizedPages.length === 0) throw new Error(`No docs content was found under ${contentDir}.`);
-	const pages = localizedPages.map(({ page }) => page);
+	const publishablePages = localizedPages.filter(({ page }) => isDocsAgentPageAccessible(page));
+	const pages = publishablePages.map(({ page }) => page);
 	const okfConfig = resolveDocsOkfConfig(config?.agent?.okf);
 	const sitemap = resolveDocsSitemapConfig(sitemapInput, { baseUrl });
 	const robots = resolveDocsRobotsConfig(robotsInput, { baseUrl: typeof robotsInput === "object" ? robotsInput.baseUrl ?? sitemap.baseUrl : sitemap.baseUrl });
@@ -728,7 +729,7 @@ async function exportAgentBundle(options = {}) {
 	const configuredAgentSkills = await resolveConfiguredAgentSkills(config?.agent?.skills, { rootDir });
 	let outputs = [];
 	const internalOutputs = [];
-	for (const { page } of localizedPages) {
+	for (const { page } of publishablePages) {
 		const output = addOutput(outputs, publicDir, staticMarkdownRoute(page, sourceEntry, routeEntry), "page", "text/markdown", renderDocsMarkdownDocument({
 			...page,
 			markdownUrl: staticMarkdownRoute(page, sourceEntry, routeEntry)
@@ -758,7 +759,8 @@ async function exportAgentBundle(options = {}) {
 			agentContent: page.agentContent,
 			agentRawContent: page.agentRawContent,
 			agentFallbackContent: page.agentFallbackContent,
-			agentFallbackRawContent: page.agentFallbackRawContent
+			agentFallbackRawContent: page.agentFallbackRawContent,
+			agent: page.agent
 		})), llms);
 		for (const route of [DEFAULT_LLMS_TXT_ROUTE, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE]) addOutput(outputs, publicDir, route, "llms", "text/plain", llmsContent.llmsTxt);
 		for (const route of [DEFAULT_LLMS_FULL_TXT_ROUTE, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE]) addOutput(outputs, publicDir, route, "llms", "text/plain", llmsContent.llmsFullTxt);
@@ -888,7 +890,7 @@ async function exportAgentBundle(options = {}) {
 		internalOutputs,
 		orphanedFiles,
 		orphanedInternalFiles,
-		pages: localizedPages
+		pages: publishablePages
 	});
 	const manifestJson = `${JSON.stringify(manifest, null, 2)}\n`;
 	const changed = changedOutputs(outputs);

package/dist/agent-feedback-evaluations-DQCTFegz.mjs

@@ -0,0 +1,240 @@
+import { i as sha256DocsContent } from "./retrieval-digest-B-SgtXKK.mjs";
+
+//#region src/agent-feedback-evaluations.ts
+const DOCS_AGENT_FEEDBACK_EVALUATION_CANDIDATES_FORMAT = "farming-labs-agent-feedback-evaluation-candidates.v1";
+const DOCS_AGENT_FEEDBACK_EVALUATION_BASELINE_FORMAT = "farming-labs-agent-feedback-evaluation-baseline.v1";
+const DOCS_AGENT_FEEDBACK_EVALUATION_REGRESSION_FORMAT = "farming-labs-agent-feedback-evaluation-regression.v1";
+const SECRET_PATTERNS = [
+	{
+		pattern: /-----BEGIN [A-Z ]*PRIVATE KEY-----[\s\S]*?-----END [A-Z ]*PRIVATE KEY-----/gu,
+		replacement: "[redacted-private-key]"
+	},
+	{
+		pattern: /\b(?:sk-[A-Za-z0-9_-]{12,}|gh[pousr]_[A-Za-z0-9_]{12,}|github_pat_[A-Za-z0-9_]{12,}|xox[baprs]-[A-Za-z0-9-]{12,})\b/gu,
+		replacement: "[redacted-token]"
+	},
+	{
+		pattern: /\bBearer\s+[A-Za-z0-9._~+/=-]{12,}\b/giu,
+		replacement: "Bearer [redacted-token]"
+	},
+	{
+		pattern: /\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/giu,
+		replacement: "[redacted-email]"
+	},
+	{
+		pattern: /([?&](?:api[_-]?key|password|secret|signature|token)=)[^&#\s]+/giu,
+		replacement: (match) => `${match.slice(0, match.indexOf("=") + 1)}[redacted]`
+	}
+];
+function sanitizeText(value, maxLength) {
+	if (typeof value !== "string") return { redactions: 0 };
+	let output = value.split("").map((character) => {
+		const code = character.charCodeAt(0);
+		return code <= 31 || code === 127 ? " " : character;
+	}).join("").trim().replace(/\s+/g, " ");
+	let redactions = 0;
+	for (const { pattern, replacement } of SECRET_PATTERNS) {
+		pattern.lastIndex = 0;
+		output = output.replace(pattern, (match) => {
+			redactions += 1;
+			return typeof replacement === "function" ? replacement(match) : replacement;
+		});
+	}
+	return output ? {
+		value: output.slice(0, maxLength),
+		redactions
+	} : { redactions };
+}
+function sanitizeStringList(value, maxItems, maxLength) {
+	if (!Array.isArray(value)) return {
+		values: [],
+		redactions: 0
+	};
+	const values = [];
+	let redactions = 0;
+	for (const item of value.slice(0, maxItems)) {
+		const sanitized = sanitizeText(item, maxLength);
+		redactions += sanitized.redactions;
+		if (sanitized.value && !values.includes(sanitized.value)) values.push(sanitized.value);
+	}
+	return {
+		values,
+		redactions
+	};
+}
+function slugify(value) {
+	return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 96) || "feedback-evaluation";
+}
+function fingerprintTask(task) {
+	const sources = [...task.expect.relevantSources ?? []].sort();
+	return `sha256:${sha256DocsContent(JSON.stringify({
+		query: task.query.trim().toLowerCase(),
+		sources,
+		filters: task.filters ?? null
+	}))}`;
+}
+function sanitizeClusterTask(cluster) {
+	const rawTask = cluster.goldenTask;
+	if (!rawTask) return { redactions: 0 };
+	const query = sanitizeText(rawTask.query, 500);
+	const relevant = sanitizeStringList(rawTask.expect?.relevantSources, 20, 500);
+	const citations = sanitizeStringList(rawTask.expect?.requiredCitations, 20, 500);
+	const id = sanitizeText(rawTask.id, 120);
+	const redactions = query.redactions + relevant.redactions + citations.redactions + id.redactions;
+	if (!query.value || relevant.values.length === 0) return { redactions };
+	const taskId = slugify(id.value ?? `feedback-${cluster.id}`);
+	const topK = typeof rawTask.topK === "number" && Number.isFinite(rawTask.topK) ? Math.min(100, Math.max(1, Math.floor(rawTask.topK))) : 3;
+	return {
+		redactions,
+		task: {
+			id: taskId,
+			query: query.value,
+			tokenBudget: typeof rawTask.tokenBudget === "number" && Number.isFinite(rawTask.tokenBudget) ? Math.min(1e6, Math.max(1, Math.floor(rawTask.tokenBudget))) : 4e3,
+			topK,
+			expect: {
+				relevantSources: relevant.values,
+				requiredCitations: citations.values.length > 0 ? citations.values : relevant.values,
+				minRecallAtK: 1,
+				maxFirstRelevantRank: topK
+			}
+		}
+	};
+}
+function buildDocsAgentFeedbackEvaluationCandidates(report, options = {}) {
+	if (report.format !== "farming-labs-agent-feedback-improvements.v1") throw new Error("Input is not a supported agent feedback improvement report.");
+	const existingTasks = options.existingTasks ?? [];
+	const existingIds = new Set(existingTasks.map((task) => task.id));
+	const existingFingerprints = new Set(existingTasks.map(fingerprintTask));
+	const candidateFingerprints = /* @__PURE__ */ new Set();
+	const candidates = [];
+	const duplicates = [];
+	let redactionCount = 0;
+	for (const cluster of report.clusters) {
+		const clusterId = sanitizeText(cluster.id, 200);
+		const sanitized = sanitizeClusterTask(cluster);
+		redactionCount += clusterId.redactions + sanitized.redactions;
+		if (!sanitized.task) continue;
+		const fingerprint = fingerprintTask(sanitized.task);
+		const reason = existingIds.has(sanitized.task.id) ? "existing-id" : existingFingerprints.has(fingerprint) ? "existing-fingerprint" : candidateFingerprints.has(fingerprint) ? "duplicate-candidate" : void 0;
+		if (reason) {
+			duplicates.push({
+				clusterId: slugify(clusterId.value ?? "feedback"),
+				taskId: sanitized.task.id,
+				fingerprint,
+				reason
+			});
+			continue;
+		}
+		candidateFingerprints.add(fingerprint);
+		const page = sanitizeText(cluster.page, 500);
+		const outcomes = sanitizeStringList(cluster.outcomes, 20, 200);
+		redactionCount += page.redactions + outcomes.redactions;
+		candidates.push({
+			id: `candidate-${slugify(clusterId.value ?? "feedback")}`,
+			fingerprint,
+			state: "candidate",
+			task: sanitized.task,
+			evidence: {
+				clusterId: slugify(clusterId.value ?? "feedback"),
+				page: page.value ?? "(unknown page)",
+				occurrences: Math.max(1, Math.floor(cluster.occurrences)),
+				outcomes: outcomes.values
+			},
+			sanitization: { redactionCount: sanitized.redactions + clusterId.redactions + page.redactions + outcomes.redactions },
+			promotion: {
+				target: "agent.evaluations.tasks",
+				requiresHumanReview: true
+			}
+		});
+	}
+	candidates.sort((left, right) => left.id.localeCompare(right.id));
+	return {
+		format: DOCS_AGENT_FEEDBACK_EVALUATION_CANDIDATES_FORMAT,
+		generatedAt: options.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+		sourceFeedbackCount: report.feedbackCount,
+		sourceClusterCount: report.recurringClusterCount,
+		candidateCount: candidates.length,
+		duplicateCount: duplicates.length,
+		redactionCount,
+		candidates,
+		duplicates,
+		promotion: {
+			mode: "review-required",
+			automaticallyUpdatesConfig: false,
+			automaticallyPublishes: false
+		}
+	};
+}
+function createDocsAgentFeedbackEvaluationBaseline(report, generatedAt = (/* @__PURE__ */ new Date()).toISOString()) {
+	if (report.score === null || report.taskCount === 0) throw new Error("Cannot create a baseline from an unmeasured evaluation report.");
+	return {
+		format: DOCS_AGENT_FEEDBACK_EVALUATION_BASELINE_FORMAT,
+		generatedAt,
+		score: report.score,
+		taskCount: report.taskCount,
+		passedTaskCount: report.passedTaskCount,
+		tasks: report.tasks.map((task) => ({
+			id: task.id,
+			passed: task.passed,
+			score: task.score
+		})).sort((left, right) => left.id.localeCompare(right.id))
+	};
+}
+function round(value) {
+	return Math.round(value * 100) / 100;
+}
+function compareDocsAgentFeedbackEvaluationBaseline(current, baseline, options = {}) {
+	if (current.score === null) throw new Error("Current evaluation report is unmeasured.");
+	if (baseline.format !== DOCS_AGENT_FEEDBACK_EVALUATION_BASELINE_FORMAT) throw new Error("Evaluation baseline format is not supported.");
+	const requestedScoreDrop = options.maxScoreDrop ?? 0;
+	if (!Number.isFinite(requestedScoreDrop) || requestedScoreDrop < 0 || requestedScoreDrop > 100) throw new Error("maxScoreDrop must be a number from 0 through 100.");
+	const maxScoreDrop = requestedScoreDrop;
+	const regressions = [];
+	const scoreDelta = round(current.score - baseline.score);
+	if (scoreDelta < -maxScoreDrop) regressions.push({
+		kind: "suite-score-drop",
+		message: `Suite score dropped from ${baseline.score} to ${current.score}.`
+	});
+	const currentById = new Map(current.tasks.map((task) => [task.id, task]));
+	const baselineIds = new Set(baseline.tasks.map((task) => task.id));
+	for (const expected of baseline.tasks) {
+		const actual = currentById.get(expected.id);
+		if (!actual) {
+			regressions.push({
+				kind: "missing-task",
+				taskId: expected.id,
+				message: `Baseline task ${expected.id} is missing from the current report.`
+			});
+			continue;
+		}
+		if (expected.passed && !actual.passed) regressions.push({
+			kind: "pass-to-fail",
+			taskId: expected.id,
+			message: `Task ${expected.id} changed from passing to failing.`
+		});
+		if (actual.score < expected.score - maxScoreDrop) regressions.push({
+			kind: "score-drop",
+			taskId: expected.id,
+			message: `Task ${expected.id} score dropped from ${expected.score} to ${actual.score}.`
+		});
+	}
+	if (options.failOnNewFailures !== false) {
+		for (const task of current.tasks) if (!baselineIds.has(task.id) && !task.passed) regressions.push({
+			kind: "new-failure",
+			taskId: task.id,
+			message: `New task ${task.id} is failing.`
+		});
+	}
+	return {
+		format: DOCS_AGENT_FEEDBACK_EVALUATION_REGRESSION_FORMAT,
+		passed: regressions.length === 0,
+		baselineScore: baseline.score,
+		currentScore: current.score,
+		scoreDelta,
+		maxScoreDrop,
+		regressions
+	};
+}
+
+//#endregion
+export { compareDocsAgentFeedbackEvaluationBaseline as a, buildDocsAgentFeedbackEvaluationCandidates as i, DOCS_AGENT_FEEDBACK_EVALUATION_CANDIDATES_FORMAT as n, createDocsAgentFeedbackEvaluationBaseline as o, DOCS_AGENT_FEEDBACK_EVALUATION_REGRESSION_FORMAT as r, DOCS_AGENT_FEEDBACK_EVALUATION_BASELINE_FORMAT as t };