@farming-labs/docs 0.2.71 → 0.2.72

package/dist/mcp.mjs

@@ -1,8 +1,7 @@
 import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
-import { At as resolveDocsAudienceMdxContent, Gt as findDocsMarkdownSection, Jt as renderDocsRelatedMarkdownLines, Kt as parseDocsMarkdownSections, Sn as resolveDocsMcpResourceLocation, bn as normalizeDocsMcpEndpointPath, gn as isDocsMcpProtectedResourceMetadataPath, hn as isDocsMcpOAuthScopeToken, nn as normalizePageAgentFrontmatter, on as upsertPageAgentContractMarkdown, qt as normalizeDocsRelated, tn as hasStructuredPageAgentContract, vn as isDocsMcpResourcePath, xn as resolveDocsMcpProtectedResourceMetadataLocation, yn as normalizeDocsMcpAuthorizationServerUrls } from "./agent-FIyl4-Oa.mjs";
+import { At as resolveDocsAudienceMdxContent, Gt as findDocsMarkdownSection, Jt as renderDocsRelatedMarkdownLines, Kt as parseDocsMarkdownSections, Sn as resolveDocsMcpResourceLocation, bn as normalizeDocsMcpEndpointPath, gn as isDocsMcpProtectedResourceMetadataPath, hn as isDocsMcpOAuthScopeToken, nn as normalizePageAgentFrontmatter, on as upsertPageAgentContractMarkdown, qt as normalizeDocsRelated, tn as hasStructuredPageAgentContract, vn as isDocsMcpResourcePath, xn as resolveDocsMcpProtectedResourceMetadataLocation, yn as normalizeDocsMcpAuthorizationServerUrls } from "./agent-pS2nNQS3.mjs";
 import "./standards-discovery-CYfiQE13.mjs";
-import { D as emitDocsTelemetryMcpToolEvent, O as emitDocsTelemetryProjectEvent, S as resolvePageSidebarFolderIndexBehavior, T as emitDocsTelemetryAgentSurfaceEvent, b as stripGeneratedAgentProvenance, u as performDocsSearch } from "./search-x5O0-9X3.mjs";
-import { a as normalizeAgentScopeValues, i as normalizeAgentLocale, n as agentVersionConstraintsOverlap, r as normalizeAgentFramework, t as agentVersionConstraintMatches } from "./agent-scope-C_U--OZ7.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-BbArHODP.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
 import path from "node:path";
@@ -801,7 +800,7 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 								path: "agent.evaluations.tasks[].filters",
 								name: "filters",
 								type: "DocsAgentGoldenTaskFilters",
-								description: "Framework, version, and locale retrieval scope.",
+								description: "Framework, version, package, tags, and locale retrieval scope.",
 								children: [
 									{
 										path: "agent.evaluations.tasks[].filters.framework",
@@ -815,6 +814,18 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 										type: "string",
 										description: "Exact version requested by the task."
 									},
+									{
+										path: "agent.evaluations.tasks[].filters.package",
+										name: "package",
+										type: "string | readonly string[]",
+										description: "Package name or names requested by the task."
+									},
+									{
+										path: "agent.evaluations.tasks[].filters.tags",
+										name: "tags",
+										type: "string | readonly string[]",
+										description: "Page tag or tags requested by the task."
+									},
 									{
 										path: "agent.evaluations.tasks[].filters.locale",
 										name: "locale",
@@ -876,7 +887,7 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 										path: "agent.evaluations.tasks[].expect.scope",
 										name: "scope",
 										type: "DocsAgentGoldenTaskFilters",
-										description: "Framework, version, and locale assertions checked against returned sources without pre-filtering retrieval.",
+										description: "Framework, version, package, tags, and locale assertions checked against returned sources without pre-filtering retrieval.",
 										children: [
 											{
 												path: "agent.evaluations.tasks[].expect.scope.framework",
@@ -890,6 +901,18 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 												type: "string",
 												description: "Version the returned sources must select."
 											},
+											{
+												path: "agent.evaluations.tasks[].expect.scope.package",
+												name: "package",
+												type: "string | readonly string[]",
+												description: "Package name or names the returned sources must select."
+											},
+											{
+												path: "agent.evaluations.tasks[].expect.scope.tags",
+												name: "tags",
+												type: "string | readonly string[]",
+												description: "Page tag or tags the returned sources must select."
+											},
 											{
 												path: "agent.evaluations.tasks[].expect.scope.locale",
 												name: "locale",
@@ -1663,11 +1686,16 @@ export default defineDocs({
 });`
 	}
 ]);
+const searchFilterValueSchema = z.union([z.string().trim().min(1).max(128), z.array(z.string().trim().min(1).max(128)).min(1).max(16)]);
 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(),
-	audience: z.enum(["human", "agent"]).optional()
+	audience: z.enum(["human", "agent"]).optional(),
+	framework: searchFilterValueSchema.optional(),
+	version: searchFilterValueSchema.optional(),
+	package: searchFilterValueSchema.optional(),
+	tags: searchFilterValueSchema.optional()
 });
 const readPageInputSchema = z.object({
 	path: z.string().min(1),
@@ -1763,6 +1791,8 @@ const getContextInputSchema = z.object({
 	query: z.string().trim().min(1),
 	framework: z.string().trim().min(1).optional(),
 	version: z.string().trim().min(1).optional(),
+	package: searchFilterValueSchema.optional(),
+	tags: searchFilterValueSchema.optional(),
 	locale: z.string().trim().min(1).optional(),
 	tokenBudget: z.number().int().min(MIN_MCP_CONTEXT_TOKEN_BUDGET).max(MAX_MCP_CONTEXT_TOKEN_BUDGET).default(DEFAULT_MCP_CONTEXT_TOKEN_BUDGET)
 });
@@ -1836,7 +1866,39 @@ const searchResultOutputSchema = z.object({
 	score: z.number().optional(),
 	section: z.string().optional()
 });
-const searchDocsOutputSchema = z.object({ results: z.array(searchResultOutputSchema) });
+const searchFiltersOutputSchema = z.object({
+	framework: z.array(z.string()).optional(),
+	version: z.array(z.string()).optional(),
+	package: z.array(z.string()).optional(),
+	tags: z.array(z.string()).optional()
+});
+const searchWarningOutputSchema = z.object({
+	code: z.enum([
+		"ambiguous_scope",
+		"unknown_filter_value",
+		"missing_scope_metadata",
+		"conflicting_scope_metadata"
+	]),
+	field: z.enum([
+		"framework",
+		"version",
+		"package",
+		"tags"
+	]),
+	message: z.string(),
+	values: z.array(z.string()).optional(),
+	pageUrls: z.array(z.string()).optional(),
+	count: z.number().int().nonnegative().optional()
+});
+const searchDocsOutputSchema = z.object({
+	format: z.literal("docs-search.v1"),
+	query: z.string(),
+	audience: z.enum(["human", "agent"]),
+	filters: searchFiltersOutputSchema,
+	resultCount: z.number().int().nonnegative(),
+	results: z.array(searchResultOutputSchema),
+	warnings: z.array(searchWarningOutputSchema)
+});
 const codeExampleOutputSchema = z.object({
 	id: z.string(),
 	page: z.object({
@@ -1920,6 +1982,7 @@ const contextSourceOutputSchema = z.object({
 	locale: z.string().optional(),
 	framework: z.string().optional(),
 	version: z.string().optional(),
+	package: z.array(z.string()).optional(),
 	tags: z.array(z.string()).optional(),
 	score: z.number().optional(),
 	content: z.string(),
@@ -1932,6 +1995,8 @@ const contextOutputSchema = z.object({
 	filters: z.object({
 		framework: z.string().optional(),
 		version: z.string().optional(),
+		package: z.array(z.string()).optional(),
+		tags: z.array(z.string()).optional(),
 		locale: z.string().optional()
 	}),
 	budget: z.object({
@@ -2737,14 +2802,20 @@ async function createDocsMcpServer(options) {
 	});
 	if (resolved.tools.searchDocs) server.registerTool("search_docs", {
 		title: "Search documentation",
-		description: "Search the docs by keyword across titles, descriptions, and page content.",
+		description: "Search the docs by keyword with optional framework, version, package, and tag filters. Returns structured ambiguity and metadata warnings.",
 		inputSchema: searchDocsInputSchema,
 		outputSchema: searchDocsOutputSchema,
 		annotations: { readOnlyHint: true }
-	}, async ({ query, limit, locale, audience }) => {
+	}, async ({ query, limit, locale, audience, framework, version, package: packageName, tags }) => {
 		const startedAt = nowMs();
 		const resolvedLimit = limit ?? 10;
 		const resolvedAudience = audience ?? "agent";
+		const filters = {
+			framework,
+			version,
+			package: packageName,
+			tags
+		};
 		const trace = createDocsAgentTraceContext("mcp.tool.search_docs");
 		const callSpanId = createDocsAgentTraceId("span");
 		await emitDocsAgentTraceEvent(options.observability, {
@@ -2760,16 +2831,18 @@ async function createDocsMcpServer(options) {
 				queryLength: query.length,
 				limit: resolvedLimit,
 				locale,
-				audience: resolvedAudience
+				audience: resolvedAudience,
+				filterFields: Object.entries(filters).filter(([, value]) => value !== void 0).map(([field]) => field)
 			},
 			metadata: { tool: "search_docs" }
 		});
 		try {
-			const results = await performDocsSearch({
+			const searchResponse = await performDocsSearchWithMetadata({
 				pages: toSearchSourcePages(dedupePages(await getSourcePages(locale))),
 				query,
 				search: toolSearchConfig ?? true,
 				audience: resolvedAudience,
+				filters,
 				locale,
 				siteTitle: options.source.siteTitle,
 				limit: resolvedLimit
@@ -2785,13 +2858,14 @@ async function createDocsMcpServer(options) {
 					queryLength: query.length,
 					limit: resolvedLimit,
 					audience: resolvedAudience,
-					resultCount: results.length,
+					resultCount: searchResponse.resultCount,
+					warningCount: searchResponse.warnings.length,
 					durationMs: elapsed
 				}
 			});
 			trackMcpTool("search_docs", {
 				locale,
-				resultCount: results.length
+				resultCount: searchResponse.resultCount
 			});
 			await emitDocsAgentTraceEvent(options.observability, {
 				type: "tool.result",
@@ -2804,10 +2878,13 @@ async function createDocsMcpServer(options) {
 				durationMs: elapsed,
 				status: "success",
 				locale,
-				outputPreview: { resultCount: results.length },
+				outputPreview: {
+					resultCount: searchResponse.resultCount,
+					warningCount: searchResponse.warnings.length
+				},
 				metadata: { tool: "search_docs" }
 			});
-			return createStructuredTextResult({ results });
+			return createStructuredTextResult(searchResponse);
 		} catch (error) {
 			const elapsed = durationMs(startedAt);
 			await emitDocsAgentTraceEvent(options.observability, {
@@ -2932,7 +3009,7 @@ async function createDocsMcpServer(options) {
 		inputSchema: getContextInputSchema,
 		outputSchema: contextOutputSchema,
 		annotations: { readOnlyHint: true }
-	}, async ({ query, framework, version, locale, tokenBudget }) => {
+	}, async ({ query, framework, version, package: packageName, tags, locale, tokenBudget }) => {
 		const startedAt = nowMs();
 		const trace = createDocsAgentTraceContext("mcp.tool.get_context");
 		const callSpanId = createDocsAgentTraceId("span");
@@ -2949,6 +3026,8 @@ async function createDocsMcpServer(options) {
 				queryLength: query.length,
 				framework,
 				version,
+				package: packageName,
+				tags,
 				locale,
 				tokenBudget
 			},
@@ -2960,6 +3039,8 @@ async function createDocsMcpServer(options) {
 				query,
 				framework,
 				version,
+				package: packageName,
+				tags,
 				locale,
 				tokenBudget,
 				entry: options.source.entry,
@@ -2976,6 +3057,8 @@ async function createDocsMcpServer(options) {
 					queryLength: query.length,
 					framework,
 					version,
+					package: packageName,
+					tags,
 					tokenBudget,
 					usedUtf8Bytes: result.budget.usedUtf8Bytes,
 					conservativeTokenUpperBound: result.budget.conservativeTokenUpperBound,
@@ -4504,16 +4587,26 @@ function resolveDocsMcpScopeField(pageValue, contractValue, filter, overlaps, ma
 	};
 }
 function resolveDocsMcpEffectiveScope(page, filters) {
+	const normalizedFilters = normalizeDocsSearchFilters({
+		package: filters.package,
+		tags: filters.tags
+	});
 	const framework = resolveDocsMcpScopeField(page.framework, page.agent?.appliesTo?.framework, filters.framework, (left, right) => normalizeAgentFramework(left) === normalizeAgentFramework(right), (filter, candidate) => normalizeAgentFramework(filter) === normalizeAgentFramework(candidate));
 	const version = resolveDocsMcpScopeField(page.version, page.agent?.appliesTo?.version, filters.version, agentVersionConstraintsOverlap, agentVersionConstraintMatches);
 	const locale = page.locale?.trim() || void 0;
 	const localeMatches = !filters.locale || !locale || normalizeAgentLocale(locale) === normalizeAgentLocale(filters.locale);
+	const packageValues = normalizeDocsSearchFilters({ package: page.agent?.appliesTo?.package }).package ?? [];
+	const tagValues = normalizeDocsSearchFilters({ tags: page.tags }).tags ?? [];
+	const packageMatches = !normalizedFilters.package || packageValues.length > 0 && normalizedFilters.package.some((value) => packageValues.includes(value));
+	const tagsMatch = !normalizedFilters.tags || tagValues.length > 0 && normalizedFilters.tags.some((value) => tagValues.includes(value));
 	return {
 		framework: framework.value,
 		version: version.value,
+		package: packageValues,
+		tags: tagValues,
 		locale,
 		conflict: framework.conflict || version.conflict,
-		matches: framework.matches && version.matches && localeMatches
+		matches: framework.matches && version.matches && packageMatches && tagsMatch && localeMatches
 	};
 }
 function getDocsMcpResultPageUrl(value) {
@@ -4533,6 +4626,8 @@ async function buildDocsMcpContext(options) {
 		const scope = resolveDocsMcpEffectiveScope(page, {
 			framework: options.framework,
 			version: options.version,
+			package: options.package,
+			tags: options.tags,
 			locale: options.locale
 		});
 		return scope.matches && !scope.conflict ? [{
@@ -4605,6 +4700,8 @@ async function buildDocsMcpContext(options) {
 		if (selectedSection?.title) headerLines.push(`Section: ${selectedSection.title}`);
 		if (scope.framework) headerLines.push(`Framework: ${scope.framework}`);
 		if (scope.version) headerLines.push(`Version: ${scope.version}`);
+		if (scope.package.length > 0) headerLines.push(`Package: ${scope.package.join(", ")}`);
+		if (scope.tags.length > 0) headerLines.push(`Tags: ${scope.tags.join(", ")}`);
 		if (scope.locale) headerLines.push(`Locale: ${scope.locale}`);
 		const header = headerLines.join("\n");
 		const separatorBytes = blocks.length === 0 ? 0 : separatorUtf8Bytes;
@@ -4629,7 +4726,8 @@ async function buildDocsMcpContext(options) {
 			locale: scope.locale,
 			framework: scope.framework,
 			version: scope.version,
-			tags: page.tags ? [...page.tags] : void 0,
+			package: scope.package.length > 0 ? [...scope.package] : void 0,
+			tags: scope.tags.length > 0 ? [...scope.tags] : void 0,
 			score: result.score,
 			content: limited.text,
 			chars: limited.text.length,
@@ -4642,11 +4740,17 @@ async function buildDocsMcpContext(options) {
 	usedUtf8Bytes = docsMcpUtf8Bytes(context);
 	const remainingUtf8Bytes = Math.max(0, maxUtf8Bytes - usedUtf8Bytes);
 	const truncated = sources.some((source) => source.truncated) || sources.length < resolvedCandidates.length;
+	const normalizedFilters = normalizeDocsSearchFilters({
+		package: options.package,
+		tags: options.tags
+	});
 	return {
 		query: options.query,
 		filters: {
 			framework: options.framework,
 			version: options.version,
+			package: normalizedFilters.package,
+			tags: normalizedFilters.tags,
 			locale: options.locale
 		},
 		budget: {

package/dist/{metadata-bw8k-9x-.mjs → metadata-D6qlWDu-.mjs}

@@ -1,4 +1,4 @@
-import { nn as normalizePageAgentFrontmatter, tn as hasStructuredPageAgentContract } from "./agent-FIyl4-Oa.mjs";
+import { nn as normalizePageAgentFrontmatter, tn as hasStructuredPageAgentContract } from "./agent-pS2nNQS3.mjs";
 
 //#region src/metadata.ts
 /**

package/dist/{package-version-n5AFur8a.mjs → package-version-BXHcIm1T.mjs}

@@ -1,4 +1,4 @@
-import { i as detectPackageManagerFromProject, l as formatPackageManagerDetection, t as detectFramework, u as installCommand } from "./utils-DpiIioYb.mjs";
+import { i as detectPackageManagerFromProject, l as formatPackageManagerDetection, t as detectFramework, u as installCommand } from "./utils-C4RC8Zq_.mjs";
 import pc from "picocolors";
 import * as p from "@clack/prompts";
 

package/dist/{reading-time-DtNegNiq.mjs → reading-time-DvTuW2Iy.mjs}

@@ -1,7 +1,7 @@
-import { Ft as DEFAULT_SITEMAP_XML_ROUTE, Nt as DEFAULT_SITEMAP_MD_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, un as DEFAULT_MCP_WELL_KNOWN_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-FIyl4-Oa.mjs";
+import { Ft as DEFAULT_SITEMAP_XML_ROUTE, Nt as DEFAULT_SITEMAP_MD_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, un as DEFAULT_MCP_WELL_KNOWN_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-pS2nNQS3.mjs";
 import { isDocsAgentSkillName, validateDocsAgentSkillFrontmatter } from "./agent-skills-spec.mjs";
 import { C as DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE, S as DOCS_AGENT_MANIFEST_FORMAT, 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-CYfiQE13.mjs";
-import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-DOqBwQw8.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-C2SindI5.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts

package/dist/{review-NFnYbMRI.mjs → review-Cace7A2c.mjs}

@@ -1,13 +1,13 @@
-import { A as buildDocsAgentDiscoverySpec, Et as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Xt as PAGE_AGENT_CONTRACT_FIELDS, en as getPageAgentFrontmatterIssues, fn as getDocsMcpProtectedResourceMetadataRoutes, nn as normalizePageAgentFrontmatter, tn as hasStructuredPageAgentContract } from "./agent-FIyl4-Oa.mjs";
+import { A as buildDocsAgentDiscoverySpec, Et as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, Xt as PAGE_AGENT_CONTRACT_FIELDS, en as getPageAgentFrontmatterIssues, fn as getDocsMcpProtectedResourceMetadataRoutes, nn as normalizePageAgentFrontmatter, tn as hasStructuredPageAgentContract } from "./agent-pS2nNQS3.mjs";
 import { F 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-CYfiQE13.mjs";
-import { d as resolveAskAISearchRequestConfig } from "./search-x5O0-9X3.mjs";
-import { a as resolveDocsMetadataBaseUrl } from "./metadata-bw8k-9x-.mjs";
-import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-Cr9TAkmB.mjs";
+import { p as resolveAskAISearchRequestConfig } from "./search-BbArHODP.mjs";
+import { a as resolveDocsMetadataBaseUrl } from "./metadata-D6qlWDu-.mjs";
+import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-CjYzCQMZ.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-CPGGnXOV.mjs";
+import "./code-blocks-qe0T8-xe.mjs";
+import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-z7_R0f86.mjs";
+import { t as detectFramework } from "./utils-C4RC8Zq_.mjs";
+import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-DGg_eHIY.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";

package/dist/{robots-DOqBwQw8.mjs → robots-C2SindI5.mjs}

@@ -1,4 +1,4 @@
-import { S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Vt as resolveDocsSitemapConfig, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, cn as DEFAULT_MCP_PUBLIC_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, un as DEFAULT_MCP_WELL_KNOWN_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-FIyl4-Oa.mjs";
+import { S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Vt as resolveDocsSitemapConfig, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, cn as DEFAULT_MCP_PUBLIC_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, un as DEFAULT_MCP_WELL_KNOWN_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-pS2nNQS3.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-CYfiQE13.mjs";
 
 //#region src/robots.ts

package/dist/{robots-B3e-aWPy.mjs → robots-DmE_wXvG.mjs}

@@ -1,8 +1,8 @@
-import "./agent-FIyl4-Oa.mjs";
+import "./agent-pS2nNQS3.mjs";
 import "./standards-discovery-CYfiQE13.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-DOqBwQw8.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 { 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-C2SindI5.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-z7_R0f86.mjs";
+import { t as detectFramework } from "./utils-C4RC8Zq_.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/{search-CozHzW7v.d.mts → search-1aftosa5.d.mts}

@@ -1,5 +1,5 @@
-import { $n as ResolvedDocsRelatedLink, Fn as OpenDocsProvider, Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Mn as McpDocsSearchConfig, Rn as OpenDocsTarget, at as DocsAnalyticsEventInput, cn as DocsSearchConfig, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, fn as DocsSearchResult, hn as DocsSitemapConfig, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, ln as DocsSearchDocument, lr as TypesenseDocsSearchConfig, mn as DocsSearchSourcePage, on as DocsSearchAdapterFactory, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, sn as DocsSearchChunkingConfig } from "./types-BQC05SQm.mjs";
-import { F as DocsDiscoveryApiRouteOptions } from "./standards-discovery-C0CIC4QI.mjs";
+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-B9DNNAdT.mjs";
+import { F as DocsDiscoveryApiRouteOptions } from "./standards-discovery-DRJ10g7B.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"];
@@ -214,6 +214,12 @@ interface DocsAskAIPackageHints {
   imports: string[];
   installCommands: string[];
 }
+/** Normalize scalar or array-valued scope filters for programmatic, HTTP, and MCP callers. */
+declare function normalizeDocsSearchFilters(input?: DocsSearchFilterInput | DocsSearchFilters): DocsSearchFilters;
+/** Parse the public search scope parameters from a URL query string. */
+declare function resolveDocsSearchFilters(searchParams: URLSearchParams): DocsSearchFilters;
+/** Resolve search filters and the backwards-compatible structured response opt-in. */
+declare function resolveDocsSearchRequest(searchParams: URLSearchParams): DocsSearchRequest;
 declare function inferDocsAskAIPackageHints(content: string): DocsAskAIPackageHints;
 declare function formatDocsAskAIPackageHints(hints: DocsAskAIPackageHints, packageName?: string): string | undefined;
 declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig, audience?: DocsContentAudience): DocsSearchDocument[];
@@ -235,16 +241,20 @@ declare function resolveAskAISearchRequestConfig(options: {
 }): boolean | DocsSearchConfig | undefined;
 declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearchAdapter;
 declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
-declare function performDocsSearch(options: {
+interface PerformDocsSearchOptions {
   pages: DocsSearchSourcePage[];
   query: string;
-  search?: boolean | DocsSearchConfig; /** Selects which audience projection is searchable. Public site search defaults to human. */
+  search?: boolean | DocsSearchConfig;
+  /** Selects which audience projection is searchable. Public site search defaults to human. */
   audience?: DocsContentAudience;
   locale?: string;
   pathname?: string;
-  siteTitle?: string; /** Canonical docs URL used to distinguish same-site absolute hits from foreign MCP results. */
+  siteTitle?: string;
+  /** Canonical docs URL used to distinguish same-site absolute hits from foreign MCP results. */
   baseUrl?: string;
   limit?: number;
+  /** Optional framework, version, package, and tag constraints. */
+  filters?: DocsSearchFilterInput;
   /**
    * Controls provider failures. Runtime search keeps the resilient `fallback` default;
    * diagnostics can request `throw` so a broken configured provider cannot be scored as
@@ -255,10 +265,14 @@ declare function performDocsSearch(options: {
    * Whether non-simple provider hits are supplemented with exact/local simple results.
    * 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. */
-  strictExternalOrigins?: boolean; /** Optional cancellation signal forwarded to adapters and their managed requests. */
+  supplementExternalResults?: boolean;
+  /** Fail closed on absolute provider hits when no canonical docs origin is available. */
+  strictExternalOrigins?: boolean;
+  /** Optional cancellation signal forwarded to adapters and their managed requests. */
   signal?: AbortSignal;
-}): Promise<DocsSearchResult[]>;
+}
+declare function performDocsSearch(options: PerformDocsSearchOptions): Promise<DocsSearchResult[]>;
+declare function performDocsSearchWithMetadata(options: PerformDocsSearchOptions): Promise<DocsSearchResponse>;
 declare function buildDocsAskAIContext(options: {
   pages: DocsSearchSourcePage[];
   query: string;
@@ -268,6 +282,7 @@ declare function buildDocsAskAIContext(options: {
   siteTitle?: string;
   baseUrl?: string;
   limit?: number;
+  filters?: DocsSearchFilterInput;
   maxContextChars?: number;
   maxResultChars?: number; /** See `performDocsSearch.failureMode`. Defaults to resilient runtime fallback. */
   searchFailureMode?: "fallback" | "throw"; /** See `performDocsSearch.strictExternalOrigins`. */
@@ -276,4 +291,4 @@ declare function buildDocsAskAIContext(options: {
 }): Promise<DocsAskAIContext>;
 declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
 //#endregion
-export { resolveDocsAudienceExposure as $, resolveDocsSitemapPageLastmod as A, SerializedOpenDocsProvider as B, DocsSitemapResolvedConfig as C, renderDocsSitemapMarkdown as D, readDocsSitemapManifestFromContentMap as E, DEFAULT_OPEN_DOCS_TARGET as F, serializeDocsIcon as G, parsePromptStringArray as H, DEFAULT_PROMPT_PROVIDER_TEMPLATES as I, serializeOpenDocsProviders as J, serializeDocsIconRegistry as K, PromptAction as L, toDocsSitemapMarkdownUrl as M, DEFAULT_OPEN_DOCS_PROMPT as N, renderDocsSitemapXml as O, DEFAULT_OPEN_DOCS_PROVIDER_IDS as P, resolveDocsAgentMdxContent as Q, PromptProviderChoice as R, DocsSitemapPageInput as S, createDocsSitemapResponse as T, resolvePromptProviderChoices as U, normalizePromptProviderName as V, sanitizePromptText as W, DocsContentAudience as X, DocsAudienceMdxIssue as Y, findDocsAudienceMdxIssues as Z, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as _, createMcpSearchAdapter as a, createDocsAgentTraceContext as at, DocsSitemapManifest as b, formatDocsAskAIPackageHints as c, emitDocsAnalyticsEvent as ct, resolveAskAISearchRequestConfig as d, resolveDocsAnalyticsConfig as dt, resolveDocsAudienceMdxContent as et, resolveDocsSearchAudience as f, resolveDocsObservabilityConfig as ft, DEFAULT_SITEMAP_MD_ROUTE as g, DEFAULT_SITEMAP_MD_DOCS_ROUTE as h, createCustomSearchAdapter as i, ResolvedDocsObservabilityConfig as it, resolveDocsSitemapRequest as j, resolveDocsSitemapConfig as k, inferDocsAskAIPackageHints as l, emitDocsObservabilityEvent as lt, DEFAULT_SITEMAP_MANIFEST_PATH as m, buildDocsSearchDocuments as n, DocsAgentTraceContext as nt, createSimpleSearchAdapter as o, createDocsAgentTraceId as ot, resolveSearchRequestConfig as p, serializeOpenDocsProvider as q, createAlgoliaSearchAdapter as r, ResolvedDocsAnalyticsConfig as rt, createTypesenseSearchAdapter as s, emitDocsAgentTraceEvent as st, buildDocsAskAIContext as t, DOCS_AGENT_TRACE_EVENT_TYPES as tt, performDocsSearch as u, getDocsRequestAnalyticsProperties as ut, DEFAULT_SITEMAP_XML_ROUTE as v, buildDocsSitemapManifest as w, DocsSitemapManifestPage as x, DocsSitemapFormat as y, SerializeOpenDocsProviderOptions as z };
+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 _, resolveDocsObservabilityConfig as _t, createCustomSearchAdapter as a, resolveDocsAudienceMdxContent as at, DEFAULT_SITEMAP_MD_DOCS_ROUTE as b, createTypesenseSearchAdapter as c, ResolvedDocsAnalyticsConfig as ct, normalizeDocsSearchFilters as d, createDocsAgentTraceId as dt, DocsAudienceMdxIssue as et, performDocsSearch as f, emitDocsAgentTraceEvent as ft, resolveDocsSearchFilters as g, resolveDocsAnalyticsConfig as gt, resolveDocsSearchAudience as h, getDocsRequestAnalyticsProperties as ht, createAlgoliaSearchAdapter as i, resolveDocsAudienceExposure as it, readDocsSitemapManifestFromContentMap as j, buildDocsSitemapManifest as k, formatDocsAskAIPackageHints as l, ResolvedDocsObservabilityConfig as lt, resolveAskAISearchRequestConfig as m, emitDocsObservabilityEvent as mt, buildDocsAskAIContext as n, findDocsAudienceMdxIssues as nt, createMcpSearchAdapter as o, DOCS_AGENT_TRACE_EVENT_TYPES as ot, performDocsSearchWithMetadata as p, emitDocsAnalyticsEvent as pt, parsePromptStringArray as q, buildDocsSearchDocuments as r, resolveDocsAgentMdxContent as rt, createSimpleSearchAdapter as s, DocsAgentTraceContext as st, PerformDocsSearchOptions as t, DocsContentAudience as tt, inferDocsAskAIPackageHints as u, createDocsAgentTraceContext as ut, resolveSearchRequestConfig as v, DocsSitemapFormat as w, DEFAULT_SITEMAP_MD_ROUTE as x, DEFAULT_SITEMAP_MANIFEST_PATH as y, DEFAULT_OPEN_DOCS_PROVIDER_IDS as z };