@farming-labs/docs 0.2.71 → 0.2.72

package/dist/{search-DOGUUZvs.mjs → search-DB3svkNQ.mjs}

@@ -1,13 +1,13 @@
-import "./agent-FIyl4-Oa.mjs";
+import "./agent-pS2nNQS3.mjs";
 import "./standards-discovery-CYfiQE13.mjs";
-import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-x5O0-9X3.mjs";
-import "./sitemap-server-D_hayOp6.mjs";
-import "./agent-evals-Cr9TAkmB.mjs";
+import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-BbArHODP.mjs";
+import "./sitemap-server-PUoOhplO.mjs";
+import "./agent-evals-CjYzCQMZ.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-B4u3qy-1.mjs";
+import "./code-blocks-qe0T8-xe.mjs";
+import "./agent-skills-server-BPVv4gMg.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, c as loadProjectEnv, g as resolveDocsConfigPath, h as readTopLevelStringProperty } from "./config-Wcdj-D0a.mjs";
+import { _ as resolveDocsContentDir, c as loadProjectEnv, g as resolveDocsConfigPath, h as readTopLevelStringProperty } from "./config-z7_R0f86.mjs";
 import { readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/server.d.mts

@@ -1,9 +1,9 @@
-import { $t as DocsReviewRulesConfig, B as DocsAgentEvaluationSourceReference, Ct as DocsCodeBlocksPlannerProvider, Et as DocsCodeBlocksValidateConfig, F as DocsAgentEvaluationAnswerInput, H as DocsAgentEvaluationTaskInput, I as DocsAgentEvaluationAnswerProvider, J as DocsAgentGoldenExpectedExample, Jt as DocsObservabilityEventInput, K as DocsAgentGoldenAnswerExpectation, Kt as DocsObservabilityConfig, L as DocsAgentEvaluationAnswerRequest, Mn as McpDocsSearchConfig, Qt as DocsReviewConfig, R as DocsAgentEvaluationAnswerResult, V as DocsAgentEvaluationSurface, X as DocsAgentGoldenTaskExpectation, Y as DocsAgentGoldenTask, Z as DocsAgentGoldenTaskFilters, Zt as DocsReviewCiMode, a as ApiReferenceRenderer, an as DocsSearchAdapterContext, at as DocsAnalyticsEventInput, cn as DocsSearchConfig, dn as DocsSearchQuery, dt as DocsAskAIFeedbackConfig, et as DocsAgentTraceEventInput, fn as DocsSearchResult, ft as DocsAskAIFeedbackData, hn as DocsSitemapConfig, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, kt as DocsConfig, ln as DocsSearchDocument, mn as DocsSearchSourcePage, mt as DocsAskAIFeedbackValue, nt as DocsAgentTraceStatus, on as DocsSearchAdapterFactory, pt as DocsAskAIFeedbackMessage, q as DocsAgentGoldenExampleVerification, qt as DocsObservabilityEvent, rt as DocsAnalyticsConfig, tt as DocsAgentTraceEventType, z as DocsAgentEvaluationAnswerRunner } from "./types-BQC05SQm.mjs";
-import { n as resolveConfiguredAgentSkills, r as resolveConfiguredAgentSkillsSync, t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-DTwblsLu.mjs";
+import { $t as DocsReviewRulesConfig, B as DocsAgentEvaluationSourceReference, Ct as DocsCodeBlocksPlannerProvider, Et as DocsCodeBlocksValidateConfig, F as DocsAgentEvaluationAnswerInput, H as DocsAgentEvaluationTaskInput, I as DocsAgentEvaluationAnswerProvider, J as DocsAgentGoldenExpectedExample, Jt as DocsObservabilityEventInput, K as DocsAgentGoldenAnswerExpectation, Kt as DocsObservabilityConfig, L as DocsAgentEvaluationAnswerRequest, Qt as DocsReviewConfig, R as DocsAgentEvaluationAnswerResult, Sn as DocsSitemapConfig, V as DocsAgentEvaluationSurface, X as DocsAgentGoldenTaskExpectation, Y as DocsAgentGoldenTask, Z as DocsAgentGoldenTaskFilters, Zt as DocsReviewCiMode, _n as DocsSearchResult, a as ApiReferenceRenderer, an as DocsSearchAdapterContext, at as DocsAnalyticsEventInput, bn as DocsSearchWarning, cn as DocsSearchConfig, dn as DocsSearchFilterField, dt as DocsAskAIFeedbackConfig, et as DocsAgentTraceEventInput, fn as DocsSearchFilterInput, ft as DocsAskAIFeedbackData, gn as DocsSearchResponse, hn as DocsSearchRequest, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, kt as DocsConfig, ln as DocsSearchDocument, mn as DocsSearchQuery, mt as DocsAskAIFeedbackValue, nt as DocsAgentTraceStatus, on as DocsSearchAdapterFactory, pn as DocsSearchFilters, pt as DocsAskAIFeedbackMessage, q as DocsAgentGoldenExampleVerification, qt as DocsObservabilityEvent, rt as DocsAnalyticsConfig, tt as DocsAgentTraceEventType, xn as DocsSearchWarningCode, yn as DocsSearchSourcePage, z as DocsAgentEvaluationAnswerRunner, zn as McpDocsSearchConfig } from "./types-B9DNNAdT.mjs";
+import { n as resolveConfiguredAgentSkills, r as resolveConfiguredAgentSkillsSync, t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-DZnNB4_S.mjs";
 import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
-import { i as isDocsCloudAskAIProvider, n as DocsCloudAskAIResponseOptions, r as createDocsCloudAskAIResponse, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-BfnX18rI.mjs";
+import { i as isDocsCloudAskAIProvider, n as DocsCloudAskAIResponseOptions, r as createDocsCloudAskAIResponse, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-D9gIN4Vr.mjs";
 import { DocsCloudAskAIOptions, DocsCloudPublicConfig, DocsCloudRouteHandlerOptions, DocsCloudRouteHandlers, DocsCloudRuntimeEnv, DocsCloudRuntimeValue, DocsCloudServer, DocsCloudServerOptions, DocsCloudTrackEventOptions, createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
-import { A as resolveDocsSitemapPageLastmod, B as SerializedOpenDocsProvider, C as DocsSitemapResolvedConfig, D as renderDocsSitemapMarkdown, E as readDocsSitemapManifestFromContentMap, F as DEFAULT_OPEN_DOCS_TARGET, G as serializeDocsIcon, H as parsePromptStringArray, I as DEFAULT_PROMPT_PROVIDER_TEMPLATES, J as serializeOpenDocsProviders, K as serializeDocsIconRegistry, L as PromptAction, M as toDocsSitemapMarkdownUrl, N as DEFAULT_OPEN_DOCS_PROMPT, O as renderDocsSitemapXml, P as DEFAULT_OPEN_DOCS_PROVIDER_IDS, R as PromptProviderChoice, S as DocsSitemapPageInput, T as createDocsSitemapResponse, U as resolvePromptProviderChoices, V as normalizePromptProviderName, W as sanitizePromptText, _ as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, a as createMcpSearchAdapter, at as createDocsAgentTraceContext, b as DocsSitemapManifest, c as formatDocsAskAIPackageHints, ct as emitDocsAnalyticsEvent, d as resolveAskAISearchRequestConfig, dt as resolveDocsAnalyticsConfig, f as resolveDocsSearchAudience, ft as resolveDocsObservabilityConfig, g as DEFAULT_SITEMAP_MD_ROUTE, h as DEFAULT_SITEMAP_MD_DOCS_ROUTE, i as createCustomSearchAdapter, it as ResolvedDocsObservabilityConfig, j as resolveDocsSitemapRequest, k as resolveDocsSitemapConfig, l as inferDocsAskAIPackageHints, lt as emitDocsObservabilityEvent, m as DEFAULT_SITEMAP_MANIFEST_PATH, n as buildDocsSearchDocuments, nt as DocsAgentTraceContext, o as createSimpleSearchAdapter, ot as createDocsAgentTraceId, p as resolveSearchRequestConfig, q as serializeOpenDocsProvider, r as createAlgoliaSearchAdapter, rt as ResolvedDocsAnalyticsConfig, s as createTypesenseSearchAdapter, st as emitDocsAgentTraceEvent, t as buildDocsAskAIContext, tt as DOCS_AGENT_TRACE_EVENT_TYPES, u as performDocsSearch, ut as getDocsRequestAnalyticsProperties, v as DEFAULT_SITEMAP_XML_ROUTE, w as buildDocsSitemapManifest, x as DocsSitemapManifestPage, y as DocsSitemapFormat, z as SerializeOpenDocsProviderOptions } from "./search-CozHzW7v.mjs";
+import { $ as serializeOpenDocsProviders, A as createDocsSitemapResponse, B as DEFAULT_OPEN_DOCS_TARGET, C as DEFAULT_SITEMAP_XML_ROUTE, D as DocsSitemapPageInput, E as DocsSitemapManifestPage, F as resolveDocsSitemapPageLastmod, G as SerializedOpenDocsProvider, H as PromptAction, I as resolveDocsSitemapRequest, J as resolvePromptProviderChoices, K as normalizePromptProviderName, L as toDocsSitemapMarkdownUrl, M as renderDocsSitemapMarkdown, N as renderDocsSitemapXml, O as DocsSitemapResolvedConfig, P as resolveDocsSitemapConfig, Q as serializeOpenDocsProvider, R as DEFAULT_OPEN_DOCS_PROMPT, S as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, T as DocsSitemapManifest, U as PromptProviderChoice, V as DEFAULT_PROMPT_PROVIDER_TEMPLATES, W as SerializeOpenDocsProviderOptions, X as serializeDocsIcon, Y as sanitizePromptText, Z as serializeDocsIconRegistry, _ as resolveDocsSearchRequest, _t as resolveDocsObservabilityConfig, a as createCustomSearchAdapter, b as DEFAULT_SITEMAP_MD_DOCS_ROUTE, c as createTypesenseSearchAdapter, ct as ResolvedDocsAnalyticsConfig, d as normalizeDocsSearchFilters, dt as createDocsAgentTraceId, f as performDocsSearch, ft as emitDocsAgentTraceEvent, g as resolveDocsSearchFilters, gt as resolveDocsAnalyticsConfig, h as resolveDocsSearchAudience, ht as getDocsRequestAnalyticsProperties, i as createAlgoliaSearchAdapter, j as readDocsSitemapManifestFromContentMap, k as buildDocsSitemapManifest, l as formatDocsAskAIPackageHints, lt as ResolvedDocsObservabilityConfig, m as resolveAskAISearchRequestConfig, mt as emitDocsObservabilityEvent, n as buildDocsAskAIContext, o as createMcpSearchAdapter, ot as DOCS_AGENT_TRACE_EVENT_TYPES, p as performDocsSearchWithMetadata, pt as emitDocsAnalyticsEvent, q as parsePromptStringArray, r as buildDocsSearchDocuments, s as createSimpleSearchAdapter, st as DocsAgentTraceContext, t as PerformDocsSearchOptions, u as inferDocsAskAIPackageHints, ut as createDocsAgentTraceContext, v as resolveSearchRequestConfig, w as DocsSitemapFormat, x as DEFAULT_SITEMAP_MD_ROUTE, y as DEFAULT_SITEMAP_MANIFEST_PATH, z as DEFAULT_OPEN_DOCS_PROVIDER_IDS } from "./search-1aftosa5.mjs";
 import { CreateDocsMcpServerOptions, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, DocsMcpAgentContractSummary, DocsMcpCodeExample, DocsMcpConfigSchema, DocsMcpConfigSchemaOption, DocsMcpContextResult, DocsMcpContextSource, DocsMcpDocsList, DocsMcpDocsPageSummary, DocsMcpDocsSection, DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpRequestContext, DocsMcpResolvedConfig, DocsMcpResolvedCorsConfig, DocsMcpResolvedProtectedResourceConfig, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/code-group-mdx.d.ts
@@ -193,6 +193,8 @@ interface DocsGoldenRetrievedSource {
   title: string;
   framework?: string;
   version?: string;
+  package?: string[];
+  tags?: string[];
   utf8Bytes: number;
   relevant: boolean;
   truncated: boolean;
@@ -222,12 +224,18 @@ interface DocsGoldenCitationMetrics {
 interface DocsGoldenSelectionMetrics {
   requestedFramework?: string;
   requestedVersion?: string;
+  requestedPackage?: string | readonly string[];
+  requestedTags?: string | readonly string[];
   requestedLocale?: string;
   expectedFramework?: string;
   expectedVersion?: string;
+  expectedPackage?: string | readonly string[];
+  expectedTags?: string | readonly string[];
   expectedLocale?: string;
   firstFrameworkMatchRank: number | null;
   firstVersionMatchRank: number | null;
+  firstPackageMatchRank?: number | null;
+  firstTagsMatchRank?: number | null;
   firstLocaleMatchRank: number | null;
   conflictingSources: string[];
   ambiguousSources: string[];
@@ -340,4 +348,4 @@ declare function runDocsGoldenTasks(pages: readonly DocsMcpPage[], tasks: readon
 //#region src/sitemap-server.d.ts
 declare function readDocsSitemapManifest(rootDir: string, sitemap?: boolean | DocsSitemapConfig): DocsSitemapManifest | null;
 //#endregion
-export { type ApiReferenceFramework, type ApiReferenceOpenApiDiscovery, type ApiReferenceRenderer, type ApiReferenceRoute, type CreateDocsMcpServerOptions, DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, type DocsAgentEvaluationAnswerInput, type DocsAgentEvaluationAnswerProvider, type DocsAgentEvaluationAnswerRequest, type DocsAgentEvaluationAnswerResult, type DocsAgentEvaluationAnswerRunner, type DocsAgentEvaluationSourceReference, type DocsAgentEvaluationSurface, type DocsAgentEvaluationTaskInput, type DocsAgentGoldenAnswerExpectation, type DocsAgentGoldenExampleVerification, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsCloudAskAIConfig, type DocsCloudAskAIOptions, type DocsCloudAskAIResponseOptions, type DocsCloudPublicConfig, type DocsCloudRouteHandlerOptions, type DocsCloudRouteHandlers, type DocsCloudRuntimeEnv, type DocsCloudRuntimeValue, type DocsCloudServer, type DocsCloudServerOptions, type DocsCloudTrackEventOptions, type DocsGoldenAnswerMetrics, type DocsGoldenCitationMetrics, type DocsGoldenEvaluationStatus, type DocsGoldenExampleMetrics, type DocsGoldenExampleResult, type DocsGoldenExpectedExample, type DocsGoldenRetrievalMetrics, type DocsGoldenRetrievedSource, type DocsGoldenSelectionMetrics, type DocsGoldenTask, type DocsGoldenTaskExpectation, type DocsGoldenTaskFilters, type DocsGoldenTaskReport, type DocsGoldenTasksReport, type DocsGoldenUsageMetrics, type DocsMcpAgentContractSummary, type DocsMcpCodeExample, type DocsMcpConfigSchema, type DocsMcpConfigSchemaOption, type DocsMcpContextResult, type DocsMcpContextSource, type DocsMcpDocsList, type DocsMcpDocsPageSummary, type DocsMcpDocsSection, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpRequestContext, type DocsMcpResolvedConfig, type DocsMcpResolvedCorsConfig, type DocsMcpResolvedProtectedResourceConfig, type DocsMcpResolvedSecurityConfig, type DocsMcpSource, type DocsMcpTaskSummary, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolveConfiguredAgentSkillsOptions, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type ResolvedDocsReviewConfig, type RunDocsGoldenTasksOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsAgentSkillsBundle, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveConfiguredAgentSkills, resolveConfiguredAgentSkillsSync, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSearchAudience, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };
+export { type ApiReferenceFramework, type ApiReferenceOpenApiDiscovery, type ApiReferenceRenderer, type ApiReferenceRoute, type CreateDocsMcpServerOptions, DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, type DocsAgentEvaluationAnswerInput, type DocsAgentEvaluationAnswerProvider, type DocsAgentEvaluationAnswerRequest, type DocsAgentEvaluationAnswerResult, type DocsAgentEvaluationAnswerRunner, type DocsAgentEvaluationSourceReference, type DocsAgentEvaluationSurface, type DocsAgentEvaluationTaskInput, type DocsAgentGoldenAnswerExpectation, type DocsAgentGoldenExampleVerification, type DocsAgentTraceContext, type DocsAgentTraceEventInput, type DocsAgentTraceEventType, type DocsAgentTraceStatus, type DocsAnalyticsConfig, type DocsAnalyticsEvent, type DocsAnalyticsEventInput, type DocsAskAIFeedbackConfig, type DocsAskAIFeedbackData, type DocsAskAIFeedbackMessage, type DocsAskAIFeedbackValue, type DocsAskAIMcpConfig, type DocsCloudAskAIConfig, type DocsCloudAskAIOptions, type DocsCloudAskAIResponseOptions, type DocsCloudPublicConfig, type DocsCloudRouteHandlerOptions, type DocsCloudRouteHandlers, type DocsCloudRuntimeEnv, type DocsCloudRuntimeValue, type DocsCloudServer, type DocsCloudServerOptions, type DocsCloudTrackEventOptions, type DocsGoldenAnswerMetrics, type DocsGoldenCitationMetrics, type DocsGoldenEvaluationStatus, type DocsGoldenExampleMetrics, type DocsGoldenExampleResult, type DocsGoldenExpectedExample, type DocsGoldenRetrievalMetrics, type DocsGoldenRetrievedSource, type DocsGoldenSelectionMetrics, type DocsGoldenTask, type DocsGoldenTaskExpectation, type DocsGoldenTaskFilters, type DocsGoldenTaskReport, type DocsGoldenTasksReport, type DocsGoldenUsageMetrics, type DocsMcpAgentContractSummary, type DocsMcpCodeExample, type DocsMcpConfigSchema, type DocsMcpConfigSchemaOption, type DocsMcpContextResult, type DocsMcpContextSource, type DocsMcpDocsList, type DocsMcpDocsPageSummary, type DocsMcpDocsSection, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpRequestContext, type DocsMcpResolvedConfig, type DocsMcpResolvedCorsConfig, type DocsMcpResolvedProtectedResourceConfig, type DocsMcpResolvedSecurityConfig, type DocsMcpSource, type DocsMcpTaskSummary, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchFilterField, type DocsSearchFilterInput, type DocsSearchFilters, type DocsSearchQuery, type DocsSearchRequest, type DocsSearchResponse, type DocsSearchResult, type DocsSearchSourcePage, type DocsSearchWarning, type DocsSearchWarningCode, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type McpDocsSearchConfig, type PerformDocsSearchOptions, type PromptAction, type PromptProviderChoice, type ResolveConfiguredAgentSkillsOptions, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type ResolvedDocsReviewConfig, type RunDocsGoldenTasksOptions, type SerializeOpenDocsProviderOptions, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, normalizeDocsMcpRoute, normalizeDocsSearchFilters, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, performDocsSearchWithMetadata, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsAgentSkillsBundle, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveConfiguredAgentSkills, resolveConfiguredAgentSkillsSync, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSearchAudience, resolveDocsSearchFilters, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };

package/dist/server.mjs

@@ -1,14 +1,14 @@
 import { a as emitDocsAnalyticsEvent, c as resolveDocsAnalyticsConfig, i as emitDocsAgentTraceEvent, l as resolveDocsObservabilityConfig, n as createDocsAgentTraceContext, o as emitDocsObservabilityEvent, r as createDocsAgentTraceId, s as getDocsRequestAnalyticsProperties, t as DOCS_AGENT_TRACE_EVENT_TYPES } from "./analytics-Bx44lg6d.mjs";
-import { Bt as renderDocsSitemapXml, Ft as DEFAULT_SITEMAP_XML_ROUTE, Ht as resolveDocsSitemapPageLastmod, It as buildDocsSitemapManifest, Lt as createDocsSitemapResponse, Mt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Nt as DEFAULT_SITEMAP_MD_ROUTE, Pt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Rt as readDocsSitemapManifestFromContentMap, Ut as resolveDocsSitemapRequest, Vt as resolveDocsSitemapConfig, Wt as toDocsSitemapMarkdownUrl, jt as DEFAULT_SITEMAP_MANIFEST_PATH, zt as renderDocsSitemapMarkdown } from "./agent-FIyl4-Oa.mjs";
+import { Bt as renderDocsSitemapXml, Ft as DEFAULT_SITEMAP_XML_ROUTE, Ht as resolveDocsSitemapPageLastmod, It as buildDocsSitemapManifest, Lt as createDocsSitemapResponse, Mt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Nt as DEFAULT_SITEMAP_MD_ROUTE, Pt as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Rt as readDocsSitemapManifestFromContentMap, Ut as resolveDocsSitemapRequest, Vt as resolveDocsSitemapConfig, Wt as toDocsSitemapMarkdownUrl, jt as DEFAULT_SITEMAP_MANIFEST_PATH, zt as renderDocsSitemapMarkdown } from "./agent-pS2nNQS3.mjs";
 import "./standards-discovery-CYfiQE13.mjs";
-import { a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveDocsSearchAudience, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as resolveSearchRequestConfig, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-x5O0-9X3.mjs";
-import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-D_hayOp6.mjs";
-import { a as buildDocsReviewWorkflowPathFilters, c as resolveDocsReviewConfig, i as buildDocsReviewWorkflow, n as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, o as ensureDocsReviewWorkflow, r as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-Cr9TAkmB.mjs";
+import { _ as resolveSearchRequestConfig, a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as performDocsSearch, f as performDocsSearchWithMetadata, g as resolveDocsSearchRequest, h as resolveDocsSearchFilters, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, m as resolveDocsSearchAudience, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as resolveAskAISearchRequestConfig, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as normalizeDocsSearchFilters } from "./search-BbArHODP.mjs";
+import { C as resolveApiReferenceOpenApiDiscovery, S as resolveApiReferenceConfig, T as remarkCodeGroup, _ as buildApiReferenceOpenApiDocument, a as DEFAULT_PROMPT_PROVIDER_TEMPLATES, b as buildApiReferenceScalarCss, c as resolvePromptProviderChoices, d as serializeDocsIconRegistry, f as serializeOpenDocsProvider, g as buildApiReferenceHtmlDocumentAsync, h as buildApiReferenceHtmlDocument, i as DEFAULT_OPEN_DOCS_TARGET, l as sanitizePromptText, m as DEFAULT_API_REFERENCE_OPENAPI_ROUTE, n as DEFAULT_OPEN_DOCS_PROMPT, o as normalizePromptProviderName, p as serializeOpenDocsProviders, r as DEFAULT_OPEN_DOCS_PROVIDER_IDS, s as parsePromptStringArray, t as readDocsSitemapManifest, u as serializeDocsIcon, v as buildApiReferenceOpenApiDocumentAsync, w as resolveApiReferenceRenderer, x as isApiReferenceOpenApiRequest, y as buildApiReferencePageTitle } from "./sitemap-server-PUoOhplO.mjs";
+import { a as buildDocsReviewWorkflowPathFilters, c as resolveDocsReviewConfig, i as buildDocsReviewWorkflow, n as DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, o as ensureDocsReviewWorkflow, r as DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-CjYzCQMZ.mjs";
 import { DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DOCS_CONFIG_SCHEMA_OPTIONS, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
-import { n as isDocsCloudAskAIProvider, t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-sbpjOR2K.mjs";
+import { n as isDocsCloudAskAIProvider, t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-hnJfj8-X.mjs";
 import { createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
-import "./code-blocks-DnNVNK2M.mjs";
-import { n as resolveConfiguredAgentSkillsSync, t as resolveConfiguredAgentSkills } from "./agent-skills-server-B4u3qy-1.mjs";
+import "./code-blocks-qe0T8-xe.mjs";
+import { n as resolveConfiguredAgentSkillsSync, t as resolveConfiguredAgentSkills } from "./agent-skills-server-BPVv4gMg.mjs";
 import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
 
-export { DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsAgentSkillsBundle, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveConfiguredAgentSkills, resolveConfiguredAgentSkillsSync, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSearchAudience, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };
+export { DEFAULT_API_REFERENCE_OPENAPI_ROUTE, DEFAULT_DOCS_MCP_CORS_ALLOWED_HEADERS, DEFAULT_DOCS_MCP_CORS_EXPOSED_HEADERS, DEFAULT_DOCS_MCP_CORS_MAX_AGE_SECONDS, DEFAULT_DOCS_MCP_MAX_BODY_BYTES, DEFAULT_DOCS_REVIEW_SCORE_THRESHOLD, DEFAULT_DOCS_REVIEW_WORKFLOW_PATH, DEFAULT_OPEN_DOCS_PROMPT, DEFAULT_OPEN_DOCS_PROVIDER_IDS, DEFAULT_OPEN_DOCS_TARGET, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, DOCS_CONFIG_SCHEMA_OPTIONS, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, ensureDocsReviewWorkflow, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, normalizeDocsMcpRoute, normalizeDocsSearchFilters, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, performDocsSearchWithMetadata, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsAgentSkillsBundle, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveConfiguredAgentSkills, resolveConfiguredAgentSkillsSync, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsReviewConfig, resolveDocsSearchAudience, resolveDocsSearchFilters, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };

package/dist/{sitemap-BpMKdDUd.mjs → sitemap-DPTLh_26.mjs}

@@ -1,14 +1,14 @@
-import { Bt as renderDocsSitemapXml, It as buildDocsSitemapManifest, Vt as resolveDocsSitemapConfig, zt as renderDocsSitemapMarkdown } from "./agent-FIyl4-Oa.mjs";
+import { Bt as renderDocsSitemapXml, It as buildDocsSitemapManifest, Vt as resolveDocsSitemapConfig, zt as renderDocsSitemapMarkdown } from "./agent-pS2nNQS3.mjs";
 import "./standards-discovery-CYfiQE13.mjs";
-import "./search-x5O0-9X3.mjs";
-import "./sitemap-server-D_hayOp6.mjs";
-import "./agent-evals-Cr9TAkmB.mjs";
+import "./search-BbArHODP.mjs";
+import "./sitemap-server-PUoOhplO.mjs";
+import "./agent-evals-CjYzCQMZ.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
-import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-B4u3qy-1.mjs";
+import "./code-blocks-qe0T8-xe.mjs";
+import "./agent-skills-server-BPVv4gMg.mjs";
 import "./server.mjs";
-import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
-import { t as detectFramework } from "./utils-DpiIioYb.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-z7_R0f86.mjs";
+import { t as detectFramework } from "./utils-C4RC8Zq_.mjs";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";

package/dist/{sitemap-server-D_hayOp6.mjs → sitemap-server-PUoOhplO.mjs}

@@ -1,4 +1,4 @@
-import { Vt as resolveDocsSitemapConfig } from "./agent-FIyl4-Oa.mjs";
+import { Vt as resolveDocsSitemapConfig } from "./agent-pS2nNQS3.mjs";
 import { createRequire } from "node:module";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import path, { basename, join, relative } from "node:path";

package/dist/{standards-discovery-C0CIC4QI.d.mts → standards-discovery-DRJ10g7B.d.mts}

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

package/dist/{types-BQC05SQm.d.mts → types-B9DNNAdT.d.mts}

@@ -1348,6 +1348,7 @@ interface DocsSearchDocument {
   locale?: string;
   framework?: string;
   version?: string;
+  package?: string[];
   tags?: string[];
 }
 interface DocsSearchResult {
@@ -1359,6 +1360,45 @@ interface DocsSearchResult {
   score?: number;
   section?: string;
 }
+type DocsSearchFilterField = "framework" | "version" | "package" | "tags";
+interface DocsSearchFilterInput {
+  framework?: string | readonly string[];
+  version?: string | readonly string[];
+  package?: string | readonly string[];
+  tags?: string | readonly string[];
+}
+/** Normalized search scope. Values are ORed within a field and fields are ANDed together. */
+interface DocsSearchFilters {
+  framework?: string[];
+  version?: string[];
+  package?: string[];
+  tags?: string[];
+}
+type DocsSearchWarningCode = "ambiguous_scope" | "unknown_filter_value" | "missing_scope_metadata" | "conflicting_scope_metadata";
+interface DocsSearchWarning {
+  code: DocsSearchWarningCode;
+  field: DocsSearchFilterField;
+  message: string;
+  /** Bounded, normalized values relevant to this warning. */
+  values?: string[];
+  /** Bounded, deterministic sample of affected canonical page URLs. */
+  pageUrls?: string[];
+  /** Total number of affected values or pages before samples were bounded. */
+  count?: number;
+}
+interface DocsSearchResponse {
+  format: "docs-search.v1";
+  query: string;
+  audience: "human" | "agent";
+  filters: DocsSearchFilters;
+  resultCount: number;
+  results: DocsSearchResult[];
+  warnings: DocsSearchWarning[];
+}
+interface DocsSearchRequest {
+  filters: DocsSearchFilters;
+  structured: boolean;
+}
 interface DocsSearchQuery {
   query: string;
   limit?: number;
@@ -1366,6 +1406,8 @@ interface DocsSearchQuery {
   pathname?: string;
   /** Requested content projection. Omitted callers retain the human-search default. */
   audience?: "human" | "agent";
+  /** Normalized framework, version, package, and tag constraints. */
+  filters?: DocsSearchFilters;
 }
 interface DocsSearchAdapterContext {
   pages: DocsSearchSourcePage[];
@@ -2401,6 +2443,10 @@ interface DocsAgentGoldenTaskFilters {
   framework?: string;
   /** Limit retrieval to an exact documented version. */
   version?: string;
+  /** Limit retrieval to one or more documented package names. */
+  package?: string | readonly string[];
+  /** Limit retrieval to pages with one or more matching tags. */
+  tags?: string | readonly string[];
   /** Limit retrieval to a locale. */
   locale?: string;
 }
@@ -2482,6 +2528,8 @@ interface DocsAgentEvaluationSourceReference {
   title?: string;
   framework?: string;
   version?: string;
+  package?: readonly string[];
+  tags?: readonly string[];
   locale?: string;
 }
 /** Blind task input sent to answer providers. Golden expectations stay evaluator-only. */
@@ -3506,4 +3554,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { DocsAgentSkillsInput as $, ResolvedDocsRelatedLink as $n, DocsReviewRulesConfig as $t, DocsAgentA2ASecurityScheme as A, LlmsTxtMaxCharsMode as An, DocsFeedbackData as At, DocsAgentEvaluationSourceReference as B, OrderingItem as Bn, DocsMcpOriginContext as Bt, DocsAgentA2AOAuthDeviceCodeFlow as C, DocsTheme as Cn, DocsCodeBlocksPlannerProvider as Ct, DocsAgentA2AOpenIdConnectSecurityScheme as D, LastUpdatedConfig as Dn, DocsCodeBlocksValidationMode as Dt, DocsAgentA2AOAuthPasswordFlow as E, GithubConfig as En, DocsCodeBlocksValidateConfig as Et, DocsAgentEvaluationAnswerInput as F, OpenDocsProvider as Fn, DocsMcpAuthenticate as Ft, DocsAgentFeedbackData as G, PageAgentFrontmatter as Gn, DocsNav as Gt, DocsAgentEvaluationTaskInput as H, PageAgentAppliesTo as Hn, DocsMcpSecurityConfig as Ht, DocsAgentEvaluationAnswerProvider as I, OpenDocsProviderConfig as In, DocsMcpAuthenticateContext as It, DocsAgentGoldenExpectedExample as J, PageOpenGraph as Jn, DocsObservabilityEventInput as Jt, DocsAgentGoldenAnswerExpectation as K, PageAgentVerification as Kn, DocsObservabilityConfig as Kt, DocsAgentEvaluationAnswerRequest as L, OpenDocsProviderId as Ln, DocsMcpAuthenticateResult as Lt, DocsAgentA2ASkill as M, McpDocsSearchConfig as Mn, DocsI18nConfig as Mt, DocsAgentCompactConfig as N, OGConfig as Nn, DocsMcpAllowedOrigins as Nt, DocsAgentA2AProtocolBinding as O, LlmsTxtConfig as On, DocsCodeBlocksValidationPolicy as Ot, DocsAgentConfig as P, OpenDocsConfig as Pn, DocsMcpAuthPrincipal as Pt, DocsAgentSkillsConfig as Q, ReadingTimeFormat as Qn, DocsReviewConfig as Qt, DocsAgentEvaluationAnswerResult as R, OpenDocsTarget as Rn, DocsMcpConfig as Rt, DocsAgentA2AOAuthClientCredentialsFlow as S, DocsTelemetryFramework as Sn, DocsCodeBlocksPlannerConfig as St, DocsAgentA2AOAuthImplicitFlow as T, FontStyle as Tn, DocsCodeBlocksRunnerProvider as Tt, DocsAgentEvaluationsConfig as U, PageAgentCommand as Un, DocsMcpToolsConfig as Ut, DocsAgentEvaluationSurface as V, PageActionsConfig as Vn, DocsMcpProtectedResourceConfig as Vt, DocsAgentFeedbackContext as W, PageAgentFailureMode as Wn, DocsMetadata as Wt, DocsAgentGoldenTaskExpectation as X, PageTwitter as Xn, DocsReviewCiConfig as Xt, DocsAgentGoldenTask as Y, PageSidebarFrontmatter as Yn, DocsRelatedItem as Yt, DocsAgentGoldenTaskFilters as Z, ReadingTimeConfig as Zn, DocsReviewCiMode as Zt, DocsAgentA2AHttpAuthSecurityScheme as _, DocsTelemetryConfig as _n, DocsCloudConfig as _t, ApiReferenceRenderer as a, DocsSearchAdapterContext as an, SidebarPageNode as ar, DocsAnalyticsEventInput as at, DocsAgentA2AOAuth2SecurityScheme as b, DocsTelemetryEventType as bn, DocsCloudPublishConfig as bt, ChangelogFrontmatter as c, DocsSearchConfig as cn, ThemeToggleConfig as cr, DocsAnalyticsSource as ct, CopyMarkdownFormat as d, DocsSearchQuery as dn, UIConfig as dr, DocsAskAIFeedbackConfig as dt, DocsReviewScoreConfig as en, SidebarComponentProps as er, DocsAgentTraceEventInput as et, CustomDocsSearchConfig as f, DocsSearchResult as fn, DocsAskAIFeedbackData as ft, DocsAgentA2AExtension as g, DocsTelemetryAgentSurface as gn, DocsCloudApiKeyConfig as gt, DocsAgentA2AConfig as h, DocsSitemapConfig as hn, DocsAskAIMcpConfig as ht, ApiReferenceConfig as i, DocsSearchAdapter as in, SidebarNode as ir, DocsAnalyticsEvent as it, DocsAgentA2ASecurityScopeList as j, LlmsTxtSectionConfig as jn, DocsFeedbackValue as jt, DocsAgentA2ASecurityRequirement as k, LlmsTxtMaxCharsConfig as kn, DocsConfig as kt, CodeBlockCopyData as l, DocsSearchDocument as ln, TypesenseDocsSearchConfig as lr, DocsAskAIActionData as lt, DocsAgentA2ACapabilities as m, DocsSearchSourcePage as mn, DocsAskAIFeedbackValue as mt, AgentFeedbackConfig as n, DocsRobotsConfig as nn, SidebarFolderIndexBehavior as nr, DocsAgentTraceStatus as nt, BreadcrumbConfig as o, DocsSearchAdapterFactory as on, SidebarTree as or, DocsAnalyticsEventType as ot, DocsAgentA2AApiKeySecurityScheme as p, DocsSearchResultType as pn, DocsAskAIFeedbackMessage as pt, DocsAgentGoldenExampleVerification as q, PageFrontmatter as qn, DocsObservabilityEvent as qt, AlgoliaDocsSearchConfig as r, DocsRobotsRule as rn, SidebarFolderNode as rr, DocsAnalyticsConfig as rt, ChangelogConfig as s, DocsSearchChunkingConfig as sn, SimpleDocsSearchConfig as sr, DocsAnalyticsInput as st, AIConfig as t, DocsReviewSeverity as tn, SidebarConfig as tr, DocsAgentTraceEventType as tt, CopyMarkdownConfig as u, DocsSearchEmbeddingsConfig as un, TypographyConfig as ur, DocsAskAIActionType as ut, DocsAgentA2AInterfaceConfig as v, DocsTelemetryEvent as vn, DocsCloudFeatureConfig as vt, DocsAgentA2AOAuthFlows as w, FeedbackConfig as wn, DocsCodeBlocksRunnerConfig as wt, DocsAgentA2AOAuthAuthorizationCodeFlow as x, DocsTelemetryFeatures as xn, DocsCodeBlocksConfig as xt, DocsAgentA2AMutualTlsSecurityScheme as y, DocsTelemetryEventInput as yn, DocsCloudPreviewConfig as yt, DocsAgentEvaluationAnswerRunner as z, OpenGraphImage as zn, DocsMcpCorsConfig as zt };
+export { DocsAgentSkillsInput as $, PageAgentVerification as $n, DocsReviewRulesConfig as $t, DocsAgentA2ASecurityScheme as A, DocsTheme as An, DocsFeedbackData as At, DocsAgentEvaluationSourceReference as B, OGConfig as Bn, DocsMcpOriginContext as Bt, DocsAgentA2AOAuthDeviceCodeFlow as C, DocsTelemetryAgentSurface as Cn, DocsCodeBlocksPlannerProvider as Ct, DocsAgentA2AOpenIdConnectSecurityScheme as D, DocsTelemetryEventType as Dn, DocsCodeBlocksValidationMode as Dt, DocsAgentA2AOAuthPasswordFlow as E, DocsTelemetryEventInput as En, DocsCodeBlocksValidateConfig as Et, DocsAgentEvaluationAnswerInput as F, LlmsTxtConfig as Fn, DocsMcpAuthenticate as Ft, DocsAgentFeedbackData as G, OpenDocsTarget as Gn, DocsNav as Gt, DocsAgentEvaluationTaskInput as H, OpenDocsProvider as Hn, DocsMcpSecurityConfig as Ht, DocsAgentEvaluationAnswerProvider as I, LlmsTxtMaxCharsConfig as In, DocsMcpAuthenticateContext as It, DocsAgentGoldenExpectedExample as J, PageActionsConfig as Jn, DocsObservabilityEventInput as Jt, DocsAgentGoldenAnswerExpectation as K, OpenGraphImage as Kn, DocsObservabilityConfig as Kt, DocsAgentEvaluationAnswerRequest as L, LlmsTxtMaxCharsMode as Ln, DocsMcpAuthenticateResult as Lt, DocsAgentA2ASkill as M, FontStyle as Mn, DocsI18nConfig as Mt, DocsAgentCompactConfig as N, GithubConfig as Nn, DocsMcpAllowedOrigins as Nt, DocsAgentA2AProtocolBinding as O, DocsTelemetryFeatures as On, DocsCodeBlocksValidationPolicy as Ot, DocsAgentConfig as P, LastUpdatedConfig as Pn, DocsMcpAuthPrincipal as Pt, DocsAgentSkillsConfig as Q, PageAgentFrontmatter as Qn, DocsReviewConfig as Qt, DocsAgentEvaluationAnswerResult as R, LlmsTxtSectionConfig as Rn, DocsMcpConfig as Rt, DocsAgentA2AOAuthClientCredentialsFlow as S, DocsSitemapConfig as Sn, DocsCodeBlocksPlannerConfig as St, DocsAgentA2AOAuthImplicitFlow as T, DocsTelemetryEvent as Tn, DocsCodeBlocksRunnerProvider as Tt, DocsAgentEvaluationsConfig as U, OpenDocsProviderConfig as Un, DocsMcpToolsConfig as Ut, DocsAgentEvaluationSurface as V, OpenDocsConfig as Vn, DocsMcpProtectedResourceConfig as Vt, DocsAgentFeedbackContext as W, OpenDocsProviderId as Wn, DocsMetadata as Wt, DocsAgentGoldenTaskExpectation as X, PageAgentCommand as Xn, DocsReviewCiConfig as Xt, DocsAgentGoldenTask as Y, PageAgentAppliesTo as Yn, DocsRelatedItem as Yt, DocsAgentGoldenTaskFilters as Z, PageAgentFailureMode as Zn, DocsReviewCiMode as Zt, DocsAgentA2AHttpAuthSecurityScheme as _, DocsSearchResult as _n, TypographyConfig as _r, DocsCloudConfig as _t, ApiReferenceRenderer as a, DocsSearchAdapterContext as an, ReadingTimeFormat as ar, DocsAnalyticsEventInput as at, DocsAgentA2AOAuth2SecurityScheme as b, DocsSearchWarning as bn, DocsCloudPublishConfig as bt, ChangelogFrontmatter as c, DocsSearchConfig as cn, SidebarConfig as cr, DocsAnalyticsSource as ct, CopyMarkdownFormat as d, DocsSearchFilterField as dn, SidebarNode as dr, DocsAskAIFeedbackConfig as dt, DocsReviewScoreConfig as en, PageFrontmatter as er, DocsAgentTraceEventInput as et, CustomDocsSearchConfig as f, DocsSearchFilterInput as fn, SidebarPageNode as fr, DocsAskAIFeedbackData as ft, DocsAgentA2AExtension as g, DocsSearchResponse as gn, TypesenseDocsSearchConfig as gr, DocsCloudApiKeyConfig as gt, DocsAgentA2AConfig as h, DocsSearchRequest as hn, ThemeToggleConfig as hr, DocsAskAIMcpConfig as ht, ApiReferenceConfig as i, DocsSearchAdapter as in, ReadingTimeConfig as ir, DocsAnalyticsEvent as it, DocsAgentA2ASecurityScopeList as j, FeedbackConfig as jn, DocsFeedbackValue as jt, DocsAgentA2ASecurityRequirement as k, DocsTelemetryFramework as kn, DocsConfig as kt, CodeBlockCopyData as l, DocsSearchDocument as ln, SidebarFolderIndexBehavior as lr, DocsAskAIActionData as lt, DocsAgentA2ACapabilities as m, DocsSearchQuery as mn, SimpleDocsSearchConfig as mr, DocsAskAIFeedbackValue as mt, AgentFeedbackConfig as n, DocsRobotsConfig as nn, PageSidebarFrontmatter as nr, DocsAgentTraceStatus as nt, BreadcrumbConfig as o, DocsSearchAdapterFactory as on, ResolvedDocsRelatedLink as or, DocsAnalyticsEventType as ot, DocsAgentA2AApiKeySecurityScheme as p, DocsSearchFilters as pn, SidebarTree as pr, DocsAskAIFeedbackMessage as pt, DocsAgentGoldenExampleVerification as q, OrderingItem as qn, DocsObservabilityEvent as qt, AlgoliaDocsSearchConfig as r, DocsRobotsRule as rn, PageTwitter as rr, DocsAnalyticsConfig as rt, ChangelogConfig as s, DocsSearchChunkingConfig as sn, SidebarComponentProps as sr, DocsAnalyticsInput as st, AIConfig as t, DocsReviewSeverity as tn, PageOpenGraph as tr, DocsAgentTraceEventType as tt, CopyMarkdownConfig as u, DocsSearchEmbeddingsConfig as un, SidebarFolderNode as ur, DocsAskAIActionType as ut, DocsAgentA2AInterfaceConfig as v, DocsSearchResultType as vn, UIConfig as vr, DocsCloudFeatureConfig as vt, DocsAgentA2AOAuthFlows as w, DocsTelemetryConfig as wn, DocsCodeBlocksRunnerConfig as wt, DocsAgentA2AOAuthAuthorizationCodeFlow as x, DocsSearchWarningCode as xn, DocsCodeBlocksConfig as xt, DocsAgentA2AMutualTlsSecurityScheme as y, DocsSearchSourcePage as yn, DocsCloudPreviewConfig as yt, DocsAgentEvaluationAnswerRunner as z, McpDocsSearchConfig as zn, DocsMcpCorsConfig as zt };

package/dist/{upgrade-oz-GChgt.mjs → upgrade-DDJQ5l6n.mjs}

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

package/package.json

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

package/dist/agent-scope-C_U--OZ7.mjs

@@ -1,283 +0,0 @@
-//#region src/agent-scope.ts
-/** Normalize framework aliases used by page metadata, agent contracts, MCP, and evaluations. */
-function normalizeAgentFramework(value) {
-	const normalized = value.toLowerCase().replace(/[^a-z0-9]/gu, "");
-	if ([
-		"next",
-		"nextjs",
-		"nextjsapp",
-		"reactnext"
-	].includes(normalized)) return "nextjs";
-	if ([
-		"tanstack",
-		"tanstackstart",
-		"start"
-	].includes(normalized)) return "tanstackstart";
-	if (["svelte", "sveltekit"].includes(normalized)) return "sveltekit";
-	if (["nuxt", "nuxtjs"].includes(normalized)) return "nuxt";
-	return normalized;
-}
-function normalizeAgentLocale(value) {
-	return value.trim().toLowerCase().replace(/_/gu, "-");
-}
-function normalizeAgentVersion(value) {
-	return value.trim().toLowerCase().replace(/^v(?=\d)/u, "");
-}
-function normalizeAgentScopeValues(value) {
-	const values = Array.isArray(value) ? value : typeof value === "string" ? [value] : [];
-	return Array.from(new Set(values.map((item) => item.trim()).filter(Boolean)));
-}
-function compareVersions(left, right) {
-	for (let index = 0; index < 3; index += 1) if (left[index] !== right[index]) return left[index] > right[index] ? 1 : -1;
-	return 0;
-}
-function parseExactVersion(value) {
-	const match = normalizeAgentVersion(value).match(/^(\d+)(?:\.(\d+))?(?:\.(\d+))?(?:-[0-9a-z.-]+)?(?:\+[0-9a-z.-]+)?$/iu);
-	if (!match) return void 0;
-	return [
-		Number(match[1]),
-		Number(match[2] ?? 0),
-		Number(match[3] ?? 0)
-	];
-}
-function parseVersionOperand(value) {
-	const normalized = normalizeAgentVersion(value);
-	if (normalized === "*" || normalized === "x") return {
-		version: [
-			0,
-			0,
-			0
-		],
-		components: 0,
-		wildcard: true
-	};
-	const match = normalized.match(/^(\d+)(?:\.(\d+|x|\*))?(?:\.(\d+|x|\*))?$/iu);
-	if (!match) return void 0;
-	const raw = [
-		match[1],
-		match[2],
-		match[3]
-	];
-	const wildcardIndex = raw.findIndex((part, index) => index > 0 && (part?.toLowerCase() === "x" || part === "*"));
-	if (wildcardIndex >= 0 && raw.slice(wildcardIndex + 1).some((part) => part && part.toLowerCase() !== "x" && part !== "*")) return;
-	const components = wildcardIndex >= 0 ? wildcardIndex : raw.filter(Boolean).length;
-	return {
-		version: [
-			Number(raw[0]),
-			Number(raw[1] ?? 0) || 0,
-			Number(raw[2] ?? 0) || 0
-		],
-		components,
-		wildcard: wildcardIndex >= 0
-	};
-}
-function nextVersionBoundary(operand) {
-	const [major, minor] = operand.version;
-	if (operand.components <= 0) return void 0;
-	if (operand.components === 1) return [
-		major + 1,
-		0,
-		0
-	];
-	return [
-		major,
-		minor + 1,
-		0
-	];
-}
-function operandRange(operand) {
-	if (operand.components === 0) return {
-		minimumInclusive: true,
-		maximumInclusive: false
-	};
-	if (operand.components < 3 || operand.wildcard) return {
-		minimum: operand.version,
-		minimumInclusive: true,
-		maximum: nextVersionBoundary(operand),
-		maximumInclusive: false
-	};
-	return {
-		minimum: operand.version,
-		minimumInclusive: true,
-		maximum: operand.version,
-		maximumInclusive: true
-	};
-}
-function caretRange(operand) {
-	const [major, minor, patch] = operand.version;
-	let maximum;
-	if (major > 0) maximum = [
-		major + 1,
-		0,
-		0
-	];
-	else if (operand.components <= 1) maximum = [
-		1,
-		0,
-		0
-	];
-	else if (minor > 0 || operand.components === 2) maximum = [
-		0,
-		minor + 1,
-		0
-	];
-	else maximum = [
-		0,
-		0,
-		patch + 1
-	];
-	return {
-		minimum: operand.version,
-		minimumInclusive: true,
-		maximum,
-		maximumInclusive: false
-	};
-}
-function tildeRange(operand) {
-	const [major, minor] = operand.version;
-	const maximum = operand.components <= 1 ? [
-		major + 1,
-		0,
-		0
-	] : [
-		major,
-		minor + 1,
-		0
-	];
-	return {
-		minimum: operand.version,
-		minimumInclusive: true,
-		maximum,
-		maximumInclusive: false
-	};
-}
-function intersectRanges(left, right) {
-	let minimum = left.minimum;
-	let minimumInclusive = left.minimumInclusive;
-	if (!minimum || right.minimum && compareVersions(right.minimum, minimum) > 0) {
-		minimum = right.minimum;
-		minimumInclusive = right.minimumInclusive;
-	} else if (right.minimum && compareVersions(right.minimum, minimum) === 0) minimumInclusive = minimumInclusive && right.minimumInclusive;
-	let maximum = left.maximum;
-	let maximumInclusive = left.maximumInclusive;
-	if (!maximum || right.maximum && compareVersions(right.maximum, maximum) < 0) {
-		maximum = right.maximum;
-		maximumInclusive = right.maximumInclusive;
-	} else if (right.maximum && compareVersions(right.maximum, maximum) === 0) maximumInclusive = maximumInclusive && right.maximumInclusive;
-	if (minimum && maximum) {
-		const compared = compareVersions(minimum, maximum);
-		if (compared > 0 || compared === 0 && !(minimumInclusive && maximumInclusive)) return void 0;
-	}
-	return {
-		minimum,
-		minimumInclusive,
-		maximum,
-		maximumInclusive
-	};
-}
-function comparatorRange(operator, operand) {
-	if (!operator || operator === "=") return operandRange(operand);
-	if (operator === ">=") return {
-		minimum: operand.version,
-		minimumInclusive: true,
-		maximumInclusive: false
-	};
-	if (operator === ">") {
-		const partialBoundary = operand.components < 3 ? nextVersionBoundary(operand) : void 0;
-		return {
-			minimum: partialBoundary ?? operand.version,
-			minimumInclusive: Boolean(partialBoundary),
-			maximumInclusive: false
-		};
-	}
-	if (operator === "<") return {
-		minimumInclusive: true,
-		maximum: operand.version,
-		maximumInclusive: false
-	};
-	const partialBoundary = operand.components < 3 ? nextVersionBoundary(operand) : void 0;
-	return {
-		minimumInclusive: true,
-		maximum: partialBoundary ?? operand.version,
-		maximumInclusive: !partialBoundary
-	};
-}
-function parseVersionRangeBranch(value) {
-	const branch = normalizeAgentVersion(value).trim();
-	if (!branch) return void 0;
-	const hyphen = branch.match(/^(.+?)\s+-\s+(.+)$/u);
-	if (hyphen) {
-		const minimumOperand = parseVersionOperand(hyphen[1]);
-		const maximumOperand = parseVersionOperand(hyphen[2]);
-		if (!minimumOperand || !maximumOperand) return void 0;
-		const maximumBoundary = maximumOperand.components < 3 ? nextVersionBoundary(maximumOperand) : maximumOperand.version;
-		return intersectRanges({
-			minimum: minimumOperand.version,
-			minimumInclusive: true,
-			maximumInclusive: false
-		}, {
-			minimumInclusive: true,
-			maximum: maximumBoundary,
-			maximumInclusive: maximumOperand.components === 3
-		});
-	}
-	const special = branch.match(/^(\^|~)\s*(.+)$/u);
-	if (special) {
-		const operand = parseVersionOperand(special[2]);
-		if (!operand || operand.components === 0) return void 0;
-		return special[1] === "^" ? caretRange(operand) : tildeRange(operand);
-	}
-	const comparators = Array.from(branch.matchAll(/(>=|<=|>|<|=)\s*([^\s]+)/gu));
-	if (comparators.length > 0) {
-		if (comparators.map((match) => match[0]).join(" ").replace(/\s+/gu, " ") !== branch.replace(/\s+/gu, " ")) return void 0;
-		let range = {
-			minimumInclusive: true,
-			maximumInclusive: false
-		};
-		for (const comparator of comparators) {
-			const operand = parseVersionOperand(comparator[2]);
-			if (!operand) return void 0;
-			const next = intersectRanges(range, comparatorRange(comparator[1], operand));
-			if (!next) return void 0;
-			range = next;
-		}
-		return range;
-	}
-	const operand = parseVersionOperand(branch);
-	return operand ? operandRange(operand) : void 0;
-}
-function parseVersionRanges(value) {
-	return normalizeAgentVersion(value).split("||").map((branch) => parseVersionRangeBranch(branch)).filter((range) => Boolean(range));
-}
-function rangeContains(range, version) {
-	if (range.minimum) {
-		const compared = compareVersions(version, range.minimum);
-		if (compared < 0 || compared === 0 && !range.minimumInclusive) return false;
-	}
-	if (range.maximum) {
-		const compared = compareVersions(version, range.maximum);
-		if (compared > 0 || compared === 0 && !range.maximumInclusive) return false;
-	}
-	return true;
-}
-function rangesOverlap(left, right) {
-	return Boolean(intersectRanges(left, right));
-}
-/** Match an exact requested version against an exact or range-like documented constraint. */
-function agentVersionConstraintMatches(requested, constraint) {
-	if (normalizeAgentVersion(requested) === normalizeAgentVersion(constraint)) return Boolean(normalizeAgentVersion(requested));
-	const wanted = parseExactVersion(requested);
-	if (!wanted) return false;
-	return parseVersionRanges(constraint).some((range) => rangeContains(range, wanted));
-}
-/** Return true when two exact or range-like documented version constraints can select one version. */
-function agentVersionConstraintsOverlap(left, right) {
-	const normalizedLeft = normalizeAgentVersion(left);
-	if (normalizedLeft === normalizeAgentVersion(right)) return Boolean(normalizedLeft);
-	const leftRanges = parseVersionRanges(left);
-	const rightRanges = parseVersionRanges(right);
-	return leftRanges.some((leftRange) => rightRanges.some((rightRange) => rangesOverlap(leftRange, rightRange)));
-}
-
-//#endregion
-export { normalizeAgentScopeValues as a, normalizeAgentLocale as i, agentVersionConstraintsOverlap as n, normalizeAgentVersion as o, normalizeAgentFramework as r, agentVersionConstraintMatches as t };