@farming-labs/docs 0.2.73 → 0.2.74

package/dist/mcp.mjs

@@ -1,8 +1,8 @@
 import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
-import { Kt as normalizeDocsRelated, an as isDocsMcpResourcePath, cn as resolveDocsMcpProtectedResourceMetadataLocation, jt as resolveDocsAudienceMdxContent, ln as resolveDocsMcpResourceLocation, nn as isDocsMcpOAuthScopeToken, on as normalizeDocsMcpAuthorizationServerUrls, qt as renderDocsRelatedMarkdownLines, rn as isDocsMcpProtectedResourceMetadataPath, sn as normalizeDocsMcpEndpointPath } from "./agent-o9OTadrf.mjs";
+import { Kt as normalizeDocsRelated, an as isDocsMcpResourcePath, cn as resolveDocsMcpProtectedResourceMetadataLocation, jt as resolveDocsAudienceMdxContent, ln as resolveDocsMcpResourceLocation, nn as isDocsMcpOAuthScopeToken, on as normalizeDocsMcpAuthorizationServerUrls, qt as renderDocsRelatedMarkdownLines, rn as isDocsMcpProtectedResourceMetadataPath, sn as normalizeDocsMcpEndpointPath } from "./agent-BJ0KXN-A.mjs";
 import { S as upsertPageAgentContractMarkdown, _ as hasStructuredPageAgentContract, o as findDocsMarkdownSection, s as parseDocsMarkdownSections, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
 import "./standards-discovery-BwL5ffGx.mjs";
-import { A as stripGeneratedAgentProvenance, F as emitDocsTelemetryAgentSurfaceEvent, L as emitDocsTelemetryMcpToolEvent, M as resolvePageSidebarFolderIndexBehavior, R as emitDocsTelemetryProjectEvent, S as normalizeAgentScopeValues, b as normalizeAgentFramework, d as performDocsSearch, f as performDocsSearchWithMetadata, u as normalizeDocsSearchFilters, v as agentVersionConstraintMatches, x as normalizeAgentLocale, y as agentVersionConstraintsOverlap } from "./search-RfPcG1if.mjs";
+import { C as agentVersionConstraintsOverlap, E as normalizeAgentScopeValues, I as stripGeneratedAgentProvenance, R as resolvePageSidebarFolderIndexBehavior, S as agentVersionConstraintMatches, T as normalizeAgentLocale, U as emitDocsTelemetryMcpToolEvent, V as emitDocsTelemetryAgentSurfaceEvent, W as emitDocsTelemetryProjectEvent, f as normalizeDocsSearchFilters, k as isDocsRetrievalCanonicalUrl, m as performDocsSearchWithMetadata, p as performDocsSearch, w as normalizeAgentFramework } from "./search-DIyIl-tE.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
 import path from "node:path";
@@ -1254,18 +1254,27 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 		default: true,
 		description: "Built-in simple search, Typesense, Algolia, MCP, or a custom adapter.",
 		docs: "/docs/customization/search",
-		children: [{
-			path: "search.provider",
-			name: "provider",
-			type: "\"simple\" | \"typesense\" | \"algolia\" | \"mcp\" | \"custom\"",
-			default: "simple",
-			description: "Search backend used by the docs UI and MCP search tool."
-		}, {
-			path: "search.maxResults",
-			name: "maxResults",
-			type: "number",
-			description: "Maximum result count returned by search requests."
-		}]
+		children: [
+			{
+				path: "search.provider",
+				name: "provider",
+				type: "\"simple\" | \"typesense\" | \"algolia\" | \"mcp\" | \"custom\"",
+				default: "simple",
+				description: "Search backend used by the docs UI and MCP search tool."
+			},
+			{
+				path: "search.maxResults",
+				name: "maxResults",
+				type: "number",
+				description: "Maximum result count returned by search requests."
+			},
+			{
+				path: "search.syncNamespace",
+				name: "syncNamespace",
+				type: "string",
+				description: "Stable ownership namespace used to isolate and safely prune this corpus in a shared hosted index."
+			}
+		]
 	},
 	{
 		path: "cloud",
@@ -1691,7 +1700,7 @@ const searchFilterValueSchema = z.union([z.string().trim().min(1).max(128), z.ar
 const searchDocsInputSchema = z.object({
 	query: z.string().trim().min(1),
 	limit: z.number().int().min(1).max(25).optional(),
-	locale: z.string().min(1).optional(),
+	locale: z.string().trim().min(1).max(128).optional(),
 	audience: z.enum(["human", "agent"]).optional(),
 	framework: searchFilterValueSchema.optional(),
 	version: searchFilterValueSchema.optional(),
@@ -1700,7 +1709,7 @@ const searchDocsInputSchema = z.object({
 });
 const readPageInputSchema = z.object({
 	path: z.string().min(1),
-	locale: z.string().min(1).optional(),
+	locale: z.string().trim().min(1).max(128).optional(),
 	section: z.string().trim().min(1).optional(),
 	maxChars: z.number().int().min(256).max(1e6).optional()
 });
@@ -1709,7 +1718,7 @@ const listTasksInputSchema = z.object({
 	framework: z.string().trim().min(1).optional(),
 	version: z.string().trim().min(1).optional(),
 	package: z.string().trim().min(1).optional(),
-	locale: z.string().min(1).optional()
+	locale: z.string().trim().min(1).max(128).optional()
 });
 const readTaskInputSchema = readPageInputSchema;
 const pageAgentAppliesToOutputSchema = z.object({
@@ -1768,12 +1777,12 @@ const readTaskOutputSchema = z.object({
 	}),
 	contract: pageAgentContractOutputSchema
 });
-const listPagesInputSchema = z.object({ locale: z.string().min(1).optional() });
+const listPagesInputSchema = z.object({ locale: z.string().trim().min(1).max(128).optional() });
 const listDocsInputSchema = z.object({
 	section: z.string().trim().min(1).optional(),
-	locale: z.string().min(1).optional()
+	locale: z.string().trim().min(1).max(128).optional()
 });
-const getNavigationInputSchema = z.object({ locale: z.string().min(1).optional() });
+const getNavigationInputSchema = z.object({ locale: z.string().trim().min(1).max(128).optional() });
 const getConfigSchemaInputSchema = z.object({
 	option: z.string().trim().min(1).optional(),
 	query: z.string().trim().min(1).optional()
@@ -1786,7 +1795,7 @@ const getCodeExamplesInputSchema = z.object({
 	language: z.string().trim().min(1).optional(),
 	runnable: z.boolean().optional(),
 	limit: z.number().int().min(1).max(50).optional(),
-	locale: z.string().min(1).optional()
+	locale: z.string().trim().min(1).max(128).optional()
 });
 const getContextInputSchema = z.object({
 	query: z.string().trim().min(1),
@@ -1794,7 +1803,7 @@ const getContextInputSchema = z.object({
 	version: z.string().trim().min(1).optional(),
 	package: searchFilterValueSchema.optional(),
 	tags: searchFilterValueSchema.optional(),
-	locale: z.string().trim().min(1).optional(),
+	locale: z.string().trim().min(1).max(128).optional(),
 	tokenBudget: z.number().int().min(MIN_MCP_CONTEXT_TOKEN_BUDGET).max(MAX_MCP_CONTEXT_TOKEN_BUDGET).default(DEFAULT_MCP_CONTEXT_TOKEN_BUDGET)
 });
 const relatedLinkOutputSchema = z.object({ href: z.string() });
@@ -1854,6 +1863,37 @@ const navigationOutputSchema = z.object({
 	}),
 	markdown: z.string()
 });
+const retrievalSourceValueOutputSchema = z.string().max(128);
+const retrievalSourceValuesOutputSchema = z.array(retrievalSourceValueOutputSchema).max(16);
+const retrievalSourceScopeOutputSchema = z.object({
+	audience: z.enum(["human", "agent"]),
+	locale: retrievalSourceValuesOutputSchema.optional(),
+	framework: retrievalSourceValuesOutputSchema.optional(),
+	version: retrievalSourceValuesOutputSchema.optional(),
+	versionGroups: z.array(retrievalSourceValuesOutputSchema).max(16).optional(),
+	package: retrievalSourceValuesOutputSchema.optional(),
+	tags: retrievalSourceValuesOutputSchema.optional(),
+	truncated: z.array(z.enum([
+		"framework",
+		"version",
+		"package",
+		"tags"
+	])).max(4).optional(),
+	conflicts: z.array(z.enum([
+		"framework",
+		"version",
+		"package",
+		"tags"
+	])).max(4).optional()
+});
+const retrievalSourceDigestOutputSchema = z.string().regex(/^sha256:[a-f\d]{64}$/iu);
+const retrievalSourceOutputSchema = z.object({
+	canonicalUrl: z.string().max(4096).refine(isDocsRetrievalCanonicalUrl, "Expected a safe HTTP(S) URL or root-relative path"),
+	scope: retrievalSourceScopeOutputSchema,
+	lastModified: z.string().max(256).refine((value) => Number.isFinite(Date.parse(value)), "Expected a parseable modified time").optional(),
+	digest: retrievalSourceDigestOutputSchema,
+	indexGeneration: retrievalSourceDigestOutputSchema
+});
 const searchResultOutputSchema = z.object({
 	id: z.string(),
 	url: z.string(),
@@ -1865,7 +1905,8 @@ const searchResultOutputSchema = z.object({
 		"text"
 	]),
 	score: z.number().optional(),
-	section: z.string().optional()
+	section: z.string().optional(),
+	source: retrievalSourceOutputSchema.optional()
 });
 const searchFiltersOutputSchema = z.object({
 	framework: z.array(z.string()).optional(),
@@ -1896,6 +1937,7 @@ const searchDocsOutputSchema = z.object({
 	query: z.string(),
 	audience: z.enum(["human", "agent"]),
 	filters: searchFiltersOutputSchema,
+	indexGeneration: retrievalSourceDigestOutputSchema,
 	resultCount: z.number().int().nonnegative(),
 	results: z.array(searchResultOutputSchema),
 	warnings: z.array(searchWarningOutputSchema)
@@ -1985,6 +2027,7 @@ const contextSourceOutputSchema = z.object({
 	version: z.string().optional(),
 	package: z.array(z.string()).optional(),
 	tags: z.array(z.string()).optional(),
+	source: retrievalSourceOutputSchema.optional(),
 	score: z.number().optional(),
 	content: z.string(),
 	chars: z.number().int().nonnegative(),
@@ -2156,6 +2199,8 @@ function createFilesystemDocsMcpSource(options = {}) {
 	return {
 		entry,
 		siteTitle: options.siteTitle ?? "Documentation",
+		baseUrl: options.baseUrl,
+		resolveLocale: () => void 0,
 		getPages,
 		getNavigation
 	};
@@ -2192,10 +2237,13 @@ async function createDocsMcpServer(options) {
 	};
 	const telemetryFramework = options.telemetryFramework ?? "mcp";
 	function getSourcePages(locale) {
-		return options.source.getPages(locale, options.requestContext);
+		return options.source.getPages(resolveSourceLocale(locale), options.requestContext);
 	}
 	function getSourceNavigation(locale) {
-		return options.source.getNavigation(locale, options.requestContext);
+		return options.source.getNavigation(resolveSourceLocale(locale), options.requestContext);
+	}
+	function resolveSourceLocale(locale) {
+		return options.source.resolveLocale ? options.source.resolveLocale(locale, options.requestContext) : locale;
 	}
 	function getSourceSkills() {
 		return options.source.getSkills?.(options.requestContext) ?? [];
@@ -2811,6 +2859,7 @@ async function createDocsMcpServer(options) {
 		const startedAt = nowMs();
 		const resolvedLimit = limit ?? 10;
 		const resolvedAudience = audience ?? "agent";
+		const resolvedLocale = resolveSourceLocale(locale);
 		const filters = {
 			framework,
 			version,
@@ -2839,13 +2888,15 @@ async function createDocsMcpServer(options) {
 		});
 		try {
 			const searchResponse = await performDocsSearchWithMetadata({
-				pages: toSearchSourcePages(dedupePages(await getSourcePages(locale))),
+				pages: toSearchSourcePages(dedupePages(await options.source.getPages(resolvedLocale, options.requestContext))),
 				query,
 				search: toolSearchConfig ?? true,
 				audience: resolvedAudience,
 				filters,
-				locale,
+				locale: resolvedLocale,
 				siteTitle: options.source.siteTitle,
+				baseUrl: options.source.baseUrl ?? (options.requestContext?.request ? new URL(options.requestContext.request.url).origin : void 0),
+				syncBaseUrl: options.source.baseUrl ?? null,
 				limit: resolvedLimit
 			});
 			const elapsed = durationMs(startedAt);
@@ -3012,6 +3063,7 @@ async function createDocsMcpServer(options) {
 		annotations: { readOnlyHint: true }
 	}, async ({ query, framework, version, package: packageName, tags, locale, tokenBudget }) => {
 		const startedAt = nowMs();
+		const resolvedLocale = resolveSourceLocale(locale);
 		const trace = createDocsAgentTraceContext("mcp.tool.get_context");
 		const callSpanId = createDocsAgentTraceId("span");
 		await emitDocsAgentTraceEvent(options.observability, {
@@ -3036,16 +3088,17 @@ async function createDocsMcpServer(options) {
 		});
 		try {
 			const result = await buildDocsMcpContext({
-				pages: dedupePages(await getSourcePages(locale)),
+				pages: dedupePages(await options.source.getPages(resolvedLocale, options.requestContext)),
 				query,
 				framework,
 				version,
 				package: packageName,
 				tags,
-				locale,
+				locale: resolvedLocale,
 				tokenBudget,
 				entry: options.source.entry,
-				siteTitle: options.source.siteTitle
+				siteTitle: options.source.siteTitle,
+				baseUrl: options.source.baseUrl ?? (options.requestContext?.request ? new URL(options.requestContext.request.url).origin : void 0)
 			});
 			const elapsed = durationMs(startedAt);
 			await emitDocsAnalyticsEvent(options.analytics, {
@@ -3831,6 +3884,10 @@ function hasVisibleDescendantFilesystemDocsPage(dir) {
 	}
 	return false;
 }
+function normalizeFrontmatterLastmod(value) {
+	if (typeof value === "string") return value;
+	return value instanceof Date && Number.isFinite(value.getTime()) ? value.toISOString() : void 0;
+}
 function scanFilesystemDocsPages(contentDirAbs, entry, rootDir) {
 	const pages = [];
 	function scan(dir, slugParts) {
@@ -3865,6 +3922,7 @@ function scanFilesystemDocsPages(contentDirAbs, entry, rootDir) {
 				agent: normalizePageAgentFrontmatter(data.agent),
 				icon: data.icon,
 				sourcePath: path.relative(rootDir, full).replace(/\\/g, "/"),
+				lastmod: normalizeFrontmatterLastmod(data.lastmod),
 				lastModified: stat.mtime.toISOString(),
 				locale: typeof data.locale === "string" ? data.locale : void 0,
 				framework: typeof data.framework === "string" ? data.framework : void 0,
@@ -3889,7 +3947,8 @@ function readFilesystemAgentDoc(dir) {
 	const agentContent = resolveDocsAudienceMdxContent(content, "agent");
 	return {
 		agentContent: stripMarkdownForMcp(agentContent),
-		agentRawContent: agentContent
+		agentRawContent: agentContent,
+		agentLastModified: fs.statSync(agentPath).mtime.toISOString()
 	};
 }
 function resolveRelatedForMcpPages(pages) {
@@ -4005,25 +4064,7 @@ function dedupePages(pages) {
 	return [...seen.values()];
 }
 function toSearchSourcePages(pages) {
-	return pages.map((page) => ({
-		title: page.title,
-		url: page.url,
-		content: page.content,
-		rawContent: page.rawContent,
-		sourcePath: page.sourcePath,
-		lastModified: page.lastModified,
-		locale: page.locale,
-		framework: page.framework,
-		version: page.version,
-		tags: page.tags,
-		agentContent: page.agentContent,
-		agentRawContent: page.agentRawContent,
-		agentFallbackContent: page.agentFallbackContent,
-		agentFallbackRawContent: page.agentFallbackRawContent,
-		description: page.description,
-		related: page.related,
-		agent: page.agent
-	}));
+	return pages;
 }
 function getDocsConfigSchema(filters = {}) {
 	const option = filters.option?.trim();
@@ -4637,10 +4678,13 @@ async function buildDocsMcpContext(options) {
 		}] : [];
 	});
 	const scopedPages = scopedPageEntries.map(({ page }) => page);
+	const allSearchPages = toSearchSourcePages([...options.pages]);
+	const searchPageBySource = new Map(options.pages.map((page, index) => [page, allSearchPages[index]]));
 	const scopeByPage = new Map(scopedPageEntries.map(({ page, scope }) => [page, scope]));
 	const maxResults = typeof options.maxResults === "number" && Number.isFinite(options.maxResults) ? Math.max(1, Math.min(50, Math.floor(options.maxResults))) : 50;
 	const orderedResults = [...await performDocsSearch({
-		pages: toSearchSourcePages(scopedPages),
+		pages: scopedPages.map((page) => searchPageBySource.get(page)),
+		generationPages: allSearchPages,
 		query: options.query,
 		search: {
 			enabled: true,
@@ -4651,6 +4695,7 @@ async function buildDocsMcpContext(options) {
 		audience: "agent",
 		locale: options.locale,
 		siteTitle: options.siteTitle,
+		baseUrl: options.baseUrl,
 		limit: 50
 	})].sort((left, right) => {
 		const scoreDelta = (right.score ?? 0) - (left.score ?? 0);
@@ -4696,7 +4741,7 @@ async function buildDocsMcpContext(options) {
 	let usedUtf8Bytes = 0;
 	for (const { result, page, scope, selectedSection, rawContent } of resolvedCandidates) {
 		const anchor = selectedSection?.anchor;
-		const sourceUrl = anchor ? `${page.url.split("#", 1)[0]}#${encodeURIComponent(anchor)}` : page.url;
+		const sourceUrl = result.source?.canonicalUrl ?? (anchor ? `${page.url.split("#", 1)[0]}#${encodeURIComponent(anchor)}` : page.url);
 		const headerLines = [`## ${page.title}`, `Source: ${sourceUrl}`];
 		if (selectedSection?.title) headerLines.push(`Section: ${selectedSection.title}`);
 		if (scope.framework) headerLines.push(`Framework: ${scope.framework}`);
@@ -4723,12 +4768,13 @@ async function buildDocsMcpContext(options) {
 			section: selectedSection?.title,
 			anchor,
 			sourcePath: page.sourcePath,
-			lastModified: page.lastModified,
+			lastModified: result.source?.lastModified ?? page.lastModified,
 			locale: scope.locale,
 			framework: scope.framework,
 			version: scope.version,
 			package: scope.package.length > 0 ? [...scope.package] : void 0,
 			tags: scope.tags.length > 0 ? [...scope.tags] : void 0,
+			source: result.source,
 			score: result.score,
 			content: limited.text,
 			chars: limited.text.length,
@@ -4771,11 +4817,25 @@ async function buildDocsMcpContext(options) {
 }
 function findDocsPage(pages, requestedPath, entry) {
 	const normalizedRequest = normalizeRequestedPath(requestedPath, entry);
-	for (const page of pages) if (normalizeUrlPath(page.url) === normalizedRequest) return page;
+	const normalizedRequestWithoutLocale = normalizeRequestedPath(removeDocsLocaleQuery(requestedPath), entry);
+	for (const page of pages) {
+		const normalizedPageUrl = normalizeUrlPath(page.url);
+		if (normalizedPageUrl === normalizedRequest || normalizedPageUrl === normalizedRequestWithoutLocale) return page;
+	}
 	const normalizedSlug = normalizePathSegment(requestedPath.replace(/^\//, ""));
 	for (const page of pages) if (normalizePathSegment(page.slug) === normalizedSlug) return page;
 	return null;
 }
+function removeDocsLocaleQuery(value) {
+	try {
+		const absolute = /^[a-z][a-z\d+.-]*:/iu.test(value);
+		const url = new URL(value, "https://docs.local");
+		url.searchParams.delete("lang");
+		return absolute ? url.toString() : `${url.pathname}${url.search}${url.hash}`;
+	} catch {
+		return value;
+	}
+}
 function normalizeRequestedPath(requestedPath, entry) {
 	const trimmed = requestedPath.trim();
 	if (!trimmed) return "/";

package/dist/{prompt-references-Cz35rlOa.mjs → prompt-references-BIS1eXt4.mjs}

@@ -1,7 +1,7 @@
-import { It as DEFAULT_SITEMAP_XML_ROUTE, Pt as DEFAULT_SITEMAP_MD_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-o9OTadrf.mjs";
+import { It as DEFAULT_SITEMAP_XML_ROUTE, Pt as DEFAULT_SITEMAP_MD_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-BJ0KXN-A.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
 import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, T as DOCS_AGENT_MANIFEST_VERSION, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, 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-BwL5ffGx.mjs";
-import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-BcuxnZqZ.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-RbgmSvPH.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts

package/dist/{search-D1n8Sf25.d.mts → retrieval-digest-9Kp3uSaZ.d.mts}

@@ -1,5 +1,5 @@
-import { Gn as OpenDocsTarget, Hn as OpenDocsProvider, Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Sn as DocsSitemapConfig, _n as DocsSearchResult, at as DocsAnalyticsEventInput, cn as DocsSearchConfig, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, fn as DocsSearchFilterInput, gn as DocsSearchResponse, gr as TypesenseDocsSearchConfig, hn as DocsSearchRequest, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, ln as DocsSearchDocument, on as DocsSearchAdapterFactory, or as ResolvedDocsRelatedLink, pn as DocsSearchFilters, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, sn as DocsSearchChunkingConfig, yn as DocsSearchSourcePage, zn as McpDocsSearchConfig } from "./types-_HCPD4wc.mjs";
-import { I as DocsDiscoveryApiRouteOptions } from "./standards-discovery-83lp1lew.mjs";
+import { Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Vn as McpDocsSearchConfig, Wn as OpenDocsProvider, _n as DocsSearchRequest, at as DocsAnalyticsEventInput, cn as DocsSearchAdapterFactory, cr as ResolvedDocsRelatedLink, dn as DocsSearchDocument, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, hn as DocsSearchFilters, ht as DocsAskAIMcpConfig, it as DocsAnalyticsEvent, ln as DocsSearchChunkingConfig, mn as DocsSearchFilterInput, on as DocsSearchAdapter, qn as OpenDocsTarget, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, un as DocsSearchConfig, vn as DocsSearchResponse, vr as TypesenseDocsSearchConfig, wn as DocsSitemapConfig, xn as DocsSearchSourcePage, yn as DocsSearchResult } from "./types-clg5J1R4.mjs";
+import { I as DocsDiscoveryApiRouteOptions } from "./standards-discovery-CdrOE-05.mjs";
 
 //#region src/analytics.d.ts
 declare const DOCS_AGENT_TRACE_EVENT_TYPES: readonly ["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"];
@@ -243,6 +243,26 @@ declare function resolveDocsSearchFilters(searchParams: URLSearchParams): DocsSe
 declare function resolveDocsSearchRequest(searchParams: URLSearchParams): DocsSearchRequest;
 declare function inferDocsAskAIPackageHints(content: string): DocsAskAIPackageHints;
 declare function formatDocsAskAIPackageHints(hints: DocsAskAIPackageHints, packageName?: string): string | undefined;
+/**
+ * Build the exact normalized-input projection represented by a retrieval source digest.
+ * This is public so consumers can independently reproduce `source.digest`.
+ */
+declare function buildDocsRetrievalDigestProjection(page: DocsSearchSourcePage, audience?: DocsContentAudience): string;
+declare function resolveDocsRetrievalLastModified(page: DocsSearchSourcePage, audience: DocsContentAudience): string | undefined;
+interface EnrichDocsSearchDocumentsWithProvenanceOptions {
+  documents: readonly DocsSearchDocument[];
+  pages: readonly DocsSearchSourcePage[];
+  audience?: DocsContentAudience;
+  chunking?: DocsSearchChunkingConfig;
+  locale?: string;
+  baseUrl?: string;
+  indexGeneration?: string;
+}
+/**
+ * Attach the same canonical provenance used by built-in search providers.
+ * Custom adapters can call this before persisting their own hosted records.
+ */
+declare function enrichDocsSearchDocumentsWithProvenance(options: EnrichDocsSearchDocumentsWithProvenanceOptions): Promise<DocsSearchDocument[]>;
 declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig, audience?: DocsContentAudience): DocsSearchDocument[];
 declare function createSimpleSearchAdapter(): DocsSearchAdapter;
 declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
@@ -264,6 +284,10 @@ declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearch
 declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
 interface PerformDocsSearchOptions {
   pages: DocsSearchSourcePage[];
+  /** @internal Complete corpus used for generation when `pages` is pre-scoped by a caller. */
+  generationPages?: DocsSearchSourcePage[];
+  /** @internal Precomputed complete-corpus generation for structured callers. */
+  indexGeneration?: string;
   query: string;
   search?: boolean | DocsSearchConfig;
   /** Selects which audience projection is searchable. Public site search defaults to human. */
@@ -273,6 +297,12 @@ interface PerformDocsSearchOptions {
   siteTitle?: string;
   /** Canonical docs URL used to distinguish same-site absolute hits from foreign MCP results. */
   baseUrl?: string;
+  /**
+   * Canonical origin safe to persist in a hosted index. Pass `null` when `baseUrl`
+   * came from the current request rather than trusted configuration.
+   * @internal
+   */
+  syncBaseUrl?: string | null;
   limit?: number;
   /** Optional framework, version, package, and tag constraints. */
   filters?: DocsSearchFilterInput;
@@ -287,7 +317,7 @@ interface PerformDocsSearchOptions {
    * Runtime search defaults to true; provider diagnostics can disable supplementation.
    */
   supplementExternalResults?: boolean;
-  /** Fail closed on absolute provider hits when no canonical docs origin is available. */
+  /** Keep absolute provider origins distinct when no canonical docs origin is available. */
   strictExternalOrigins?: boolean;
   /** Optional cancellation signal forwarded to adapters and their managed requests. */
   signal?: AbortSignal;
@@ -301,7 +331,8 @@ declare function buildDocsAskAIContext(options: {
   locale?: string;
   pathname?: string;
   siteTitle?: string;
-  baseUrl?: string;
+  baseUrl?: string; /** See `performDocsSearch.syncBaseUrl`. */
+  syncBaseUrl?: string | null;
   limit?: number;
   filters?: DocsSearchFilterInput;
   maxContextChars?: number;
@@ -312,4 +343,16 @@ declare function buildDocsAskAIContext(options: {
 }): Promise<DocsAskAIContext>;
 declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
 //#endregion
-export { serializeOpenDocsProviders as $, createDocsSitemapResponse as A, DEFAULT_OPEN_DOCS_TARGET as B, DEFAULT_SITEMAP_XML_ROUTE as C, DocsSitemapPageInput as D, DocsSitemapManifestPage as E, resolveDocsSitemapPageLastmod as F, SerializedOpenDocsProvider as G, PromptAction as H, resolveDocsSitemapRequest as I, resolvePromptProviderChoices as J, normalizePromptProviderName as K, toDocsSitemapMarkdownUrl as L, renderDocsSitemapMarkdown as M, renderDocsSitemapXml as N, DocsSitemapResolvedConfig as O, resolveDocsSitemapConfig as P, serializeOpenDocsProvider as Q, DEFAULT_OPEN_DOCS_PROMPT as R, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as S, DocsSitemapManifest as T, PromptProviderChoice as U, DEFAULT_PROMPT_PROVIDER_TEMPLATES as V, SerializeOpenDocsProviderOptions as W, serializeDocsIcon as X, sanitizePromptText as Y, serializeDocsIconRegistry as Z, resolveDocsSearchRequest as _, emitDocsObservabilityEvent as _t, createCustomSearchAdapter as a, findDocsAudienceMdxIssues as at, DEFAULT_SITEMAP_MD_DOCS_ROUTE as b, resolveDocsObservabilityConfig as bt, createTypesenseSearchAdapter as c, resolveDocsAudienceMdxContent as ct, normalizeDocsSearchFilters as d, ResolvedDocsAnalyticsConfig as dt, DocsAudienceMdxIssue as et, performDocsSearch as f, ResolvedDocsObservabilityConfig as ft, resolveDocsSearchFilters as g, emitDocsAnalyticsEvent as gt, resolveDocsSearchAudience as h, emitDocsAgentTraceEvent as ht, createAlgoliaSearchAdapter as i, extractDocsMarkdownPromptBlocks as it, readDocsSitemapManifestFromContentMap as j, buildDocsSitemapManifest as k, formatDocsAskAIPackageHints as l, DOCS_AGENT_TRACE_EVENT_TYPES as lt, resolveAskAISearchRequestConfig as m, createDocsAgentTraceId as mt, buildDocsAskAIContext as n, DocsMarkdownPromptBlock as nt, createMcpSearchAdapter as o, resolveDocsAgentMdxContent as ot, performDocsSearchWithMetadata as p, createDocsAgentTraceContext as pt, parsePromptStringArray as q, buildDocsSearchDocuments as r, ExtractedDocsMarkdownPromptBlocks as rt, createSimpleSearchAdapter as s, resolveDocsAudienceExposure as st, PerformDocsSearchOptions as t, DocsContentAudience as tt, inferDocsAskAIPackageHints as u, DocsAgentTraceContext as ut, resolveSearchRequestConfig as v, getDocsRequestAnalyticsProperties as vt, DocsSitemapFormat as w, DEFAULT_SITEMAP_MD_ROUTE as x, DEFAULT_SITEMAP_MANIFEST_PATH as y, resolveDocsAnalyticsConfig as yt, DEFAULT_OPEN_DOCS_PROVIDER_IDS as z };
+//#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 a retrieval source projection with portable SHA-256.
+ *
+ * The projection is normalized by removing one leading BOM, converting CRLF/CR
+ * line endings to LF, and trimming trailing whitespace. The helper is exported so
+ * agents can independently verify provenance in Node, edge, and browser runtimes.
+ */
+declare function digestDocsRetrievalContent(value: string): `sha256:${string}`;
+//#endregion
+export { parsePromptStringArray as $, DocsSitemapFormat as A, resolveDocsSitemapConfig as B, resolveDocsSearchRequest as C, emitDocsObservabilityEvent as Ct, DEFAULT_SITEMAP_MD_ROUTE as D, DEFAULT_SITEMAP_MD_DOCS_ROUTE as E, resolveDocsObservabilityConfig as Et, buildDocsSitemapManifest as F, DEFAULT_OPEN_DOCS_PROVIDER_IDS as G, resolveDocsSitemapRequest as H, createDocsSitemapResponse as I, PromptAction as J, DEFAULT_OPEN_DOCS_TARGET as K, readDocsSitemapManifestFromContentMap as L, DocsSitemapManifestPage as M, DocsSitemapPageInput as N, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as O, DocsSitemapResolvedConfig as P, normalizePromptProviderName as Q, renderDocsSitemapMarkdown as R, resolveDocsSearchFilters as S, emitDocsAnalyticsEvent as St, DEFAULT_SITEMAP_MANIFEST_PATH as T, resolveDocsAnalyticsConfig as Tt, toDocsSitemapMarkdownUrl as U, resolveDocsSitemapPageLastmod as V, DEFAULT_OPEN_DOCS_PROMPT as W, SerializeOpenDocsProviderOptions as X, PromptProviderChoice as Y, SerializedOpenDocsProvider as Z, performDocsSearch as _, ResolvedDocsAnalyticsConfig as _t, buildDocsAskAIContext as a, serializeOpenDocsProviders as at, resolveDocsRetrievalLastModified as b, createDocsAgentTraceId as bt, createAlgoliaSearchAdapter as c, DocsMarkdownPromptBlock as ct, createSimpleSearchAdapter as d, findDocsAudienceMdxIssues as dt, resolvePromptProviderChoices as et, createTypesenseSearchAdapter as f, resolveDocsAgentMdxContent as ft, normalizeDocsSearchFilters as g, DocsAgentTraceContext as gt, inferDocsAskAIPackageHints as h, DOCS_AGENT_TRACE_EVENT_TYPES as ht, PerformDocsSearchOptions as i, serializeOpenDocsProvider as it, DocsSitemapManifest as j, DEFAULT_SITEMAP_XML_ROUTE as k, createCustomSearchAdapter as l, ExtractedDocsMarkdownPromptBlocks as lt, formatDocsAskAIPackageHints as m, resolveDocsAudienceMdxContent as mt, isDocsRetrievalCanonicalUrl as n, serializeDocsIcon as nt, buildDocsRetrievalDigestProjection as o, DocsAudienceMdxIssue as ot, enrichDocsSearchDocumentsWithProvenance as p, resolveDocsAudienceExposure as pt, DEFAULT_PROMPT_PROVIDER_TEMPLATES as q, EnrichDocsSearchDocumentsWithProvenanceOptions as r, serializeDocsIconRegistry as rt, buildDocsSearchDocuments as s, DocsContentAudience as st, digestDocsRetrievalContent as t, sanitizePromptText as tt, createMcpSearchAdapter as u, extractDocsMarkdownPromptBlocks as ut, performDocsSearchWithMetadata as v, ResolvedDocsObservabilityConfig as vt, resolveSearchRequestConfig as w, getDocsRequestAnalyticsProperties as wt, resolveDocsSearchAudience as x, emitDocsAgentTraceEvent as xt, resolveAskAISearchRequestConfig as y, createDocsAgentTraceContext as yt, renderDocsSitemapXml as z };

package/dist/{review-DaJLdPLh.mjs → review-Dbzkdl6K.mjs}

@@ -1,14 +1,14 @@
-import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, Dt as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS } from "./agent-o9OTadrf.mjs";
+import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, Dt as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS } from "./agent-BJ0KXN-A.mjs";
 import { _ as hasStructuredPageAgentContract, f as PAGE_AGENT_CONTRACT_FIELDS, g as getPageAgentFrontmatterIssues, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
 import { I as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-BwL5ffGx.mjs";
-import { p as resolveAskAISearchRequestConfig } from "./search-RfPcG1if.mjs";
+import { h as resolveAskAISearchRequestConfig } from "./search-DIyIl-tE.mjs";
 import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
-import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-BFHGypqh.mjs";
+import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-LIScgQVm.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
 import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
-import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CloP0pAe.mjs";
+import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-DTEPZeb0.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";

package/dist/{robots-DI-9MZz1.mjs → robots-DUO0r4UI.mjs}

@@ -1,7 +1,7 @@
-import "./agent-o9OTadrf.mjs";
+import "./agent-BJ0KXN-A.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
 import "./standards-discovery-BwL5ffGx.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-BcuxnZqZ.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-RbgmSvPH.mjs";
 import { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";

package/dist/{robots-BcuxnZqZ.mjs → robots-RbgmSvPH.mjs}

@@ -1,4 +1,4 @@
-import { Ht as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as normalizeDocsPathSegment, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-o9OTadrf.mjs";
+import { Ht as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as normalizeDocsPathSegment, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-BJ0KXN-A.mjs";
 import { 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, v as DEFAULT_API_CATALOG_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BwL5ffGx.mjs";
 
 //#region src/robots.ts