@farming-labs/docs 0.2.74 → 0.2.77

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (38) hide show
  1. package/dist/{agent-D0LEY2Vy.mjs → agent-D4hNGatV.mjs} +2 -2
  2. package/dist/agent-DRKj42ht.d.mts +938 -0
  3. package/dist/{agent-BJ0KXN-A.mjs → agent-SRIJ-oF8.mjs} +28 -6
  4. package/dist/{agent-evals-LIScgQVm.mjs → agent-evals-DmFoKy_y.mjs} +1 -1
  5. package/dist/{agent-export-B92pNe6g.mjs → agent-export-CM-p9_YD.mjs} +7 -7
  6. package/dist/agent-skills-bundle.d.mts +1 -1
  7. package/dist/{agent-skills-server-noFn1l_p.mjs → agent-skills-server-B2EXn2QD.mjs} +1 -1
  8. package/dist/{agent-skills-server-BqvIGQb1.d.mts → agent-skills-server-CJ4D0G9P.d.mts} +2 -2
  9. package/dist/agent-skills-vite.d.mts +3 -3
  10. package/dist/agent-skills-vite.mjs +2 -2
  11. package/dist/{agents-C228QGbp.mjs → agents-BeLDNCnE.mjs} +7 -16
  12. package/dist/cli/index.mjs +15 -15
  13. package/dist/client/react.d.mts +1 -1
  14. package/dist/{cloud-ask-ai-6X9pVjIY.d.mts → cloud-ask-ai-BCgHPxew.d.mts} +1 -1
  15. package/dist/{dev-Cc1cFFj-.mjs → dev-kjaxOOla.mjs} +8 -2
  16. package/dist/docs-cloud-server.d.mts +2 -2
  17. package/dist/{doctor-CgrUZ3tY.mjs → doctor-DhMVKHjp.mjs} +57 -24
  18. package/dist/{golden-evaluations-DTEPZeb0.mjs → golden-evaluations-VzE6juQl.mjs} +7 -3
  19. package/dist/index.d.mts +5 -876
  20. package/dist/index.mjs +6 -6
  21. package/dist/{mcp-YD37HlPY.mjs → mcp-CZkQJXtA.mjs} +7 -6
  22. package/dist/mcp.d.mts +30 -5
  23. package/dist/mcp.mjs +594 -69
  24. package/dist/{prompt-references-BIS1eXt4.mjs → prompt-references-B6L3AD98.mjs} +3 -3
  25. package/dist/{retrieval-digest-9Kp3uSaZ.d.mts → retrieval-digest-rponR4jM.d.mts} +24 -50
  26. package/dist/{review-Dbzkdl6K.mjs → review-nxoV8jIm.mjs} +5 -5
  27. package/dist/{robots-RbgmSvPH.mjs → robots-CgH6Stqn.mjs} +2 -2
  28. package/dist/{robots-DUO0r4UI.mjs → robots-CiQT8mX2.mjs} +3 -3
  29. package/dist/{search-hcqaEZVN.mjs → search-BTUIkhnT.mjs} +6 -6
  30. package/dist/{search-DIyIl-tE.mjs → search-Da2AKaFJ.mjs} +624 -122
  31. package/dist/server.d.mts +9 -6
  32. package/dist/server.mjs +7 -7
  33. package/dist/{sitemap-jhkS_jYx.mjs → sitemap-e0_GeCWJ.mjs} +6 -6
  34. package/dist/{sitemap-server-BfyBM7_V.mjs → sitemap-server-DHaxyPAd.mjs} +12 -3
  35. package/dist/{standards-discovery-BwL5ffGx.mjs → standards-discovery-BKlEnK_H.mjs} +32 -4
  36. package/dist/{standards-discovery-CdrOE-05.d.mts → standards-discovery-BbslY4id.d.mts} +34 -7
  37. package/dist/{types-clg5J1R4.d.mts → types-B-5Kzmkn.d.mts} +73 -1
  38. package/package.json +1 -1
package/dist/server.d.mts CHANGED
@@ -1,10 +1,11 @@
1
- import { $t as DocsReviewCiMode, B as DocsAgentEvaluationSourceReference, Cn as DocsSearchWarningCode, 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, R as DocsAgentEvaluationAnswerResult, Sn as DocsSearchWarning, V as DocsAgentEvaluationSurface, Vn as McpDocsSearchConfig, X as DocsAgentGoldenTaskExpectation, Xt as DocsRetrievalSourceProvenance, Y as DocsAgentGoldenTask, Z as DocsAgentGoldenTaskFilters, Zt as DocsRetrievalSourceScope, _n as DocsSearchRequest, a as ApiReferenceRenderer, at as DocsAnalyticsEventInput, cn as DocsSearchAdapterFactory, dn as DocsSearchDocument, dt as DocsAskAIFeedbackConfig, en as DocsReviewConfig, et as DocsAgentTraceEventInput, ft as DocsAskAIFeedbackData, gn as DocsSearchQuery, hn as DocsSearchFilters, ht as DocsAskAIMcpConfig, it as DocsAnalyticsEvent, kt as DocsConfig, mn as DocsSearchFilterInput, mt as DocsAskAIFeedbackValue, nt as DocsAgentTraceStatus, on as DocsSearchAdapter, pn as DocsSearchFilterField, pt as DocsAskAIFeedbackMessage, q as DocsAgentGoldenExampleVerification, qt as DocsObservabilityEvent, rt as DocsAnalyticsConfig, sn as DocsSearchAdapterContext, tn as DocsReviewRulesConfig, tt as DocsAgentTraceEventType, un as DocsSearchConfig, vn as DocsSearchResponse, wn as DocsSitemapConfig, xn as DocsSearchSourcePage, yn as DocsSearchResult, z as DocsAgentEvaluationAnswerRunner } from "./types-clg5J1R4.mjs";
2
- import { n as resolveConfiguredAgentSkills, r as resolveConfiguredAgentSkillsSync, t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-BqvIGQb1.mjs";
1
+ import { B as DocsAgentEvaluationSourceReference, Cn as DocsSearchSourcePage, Ct as DocsCodeBlocksPlannerProvider, En as DocsSitemapConfig, 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 DocsRetrievalSourceScope, R as DocsAgentEvaluationAnswerResult, Tn as DocsSearchWarningCode, Un as McpDocsSearchConfig, V as DocsAgentEvaluationSurface, X as DocsAgentGoldenTaskExpectation, Y as DocsAgentGoldenTask, Yt as DocsPaginatedSearchResponse, Z as DocsAgentGoldenTaskFilters, Zt as DocsRetrievalSourceProvenance, _n as DocsSearchFilters, a as ApiReferenceRenderer, at as DocsAnalyticsEventInput, bn as DocsSearchResponse, cn as DocsSearchAdapterContext, dt as DocsAskAIFeedbackConfig, en as DocsReviewCiMode, et as DocsAgentTraceEventInput, fn as DocsSearchConfig, ft as DocsAskAIFeedbackData, gn as DocsSearchFilterInput, hn as DocsSearchFilterField, ht as DocsAskAIMcpConfig, it as DocsAnalyticsEvent, kt as DocsConfig, ln as DocsSearchAdapterFactory, mt as DocsAskAIFeedbackValue, nn as DocsReviewRulesConfig, nt as DocsAgentTraceStatus, pn as DocsSearchDocument, pt as DocsAskAIFeedbackMessage, q as DocsAgentGoldenExampleVerification, qt as DocsObservabilityEvent, rt as DocsAnalyticsConfig, sn as DocsSearchAdapter, tn as DocsReviewConfig, tt as DocsAgentTraceEventType, un as DocsSearchAdapterPage, vn as DocsSearchQuery, wn as DocsSearchWarning, xn as DocsSearchResult, yn as DocsSearchRequest, z as DocsAgentEvaluationAnswerRunner } from "./types-B-5Kzmkn.mjs";
2
+ import { n as resolveConfiguredAgentSkills, r as resolveConfiguredAgentSkillsSync, t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-CJ4D0G9P.mjs";
3
3
  import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
4
- import { i as isDocsCloudAskAIProvider, n as DocsCloudAskAIResponseOptions, r as createDocsCloudAskAIResponse, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-6X9pVjIY.mjs";
4
+ import { i as isDocsCloudAskAIProvider, n as DocsCloudAskAIResponseOptions, r as createDocsCloudAskAIResponse, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-BCgHPxew.mjs";
5
5
  import { DocsCloudAskAIOptions, DocsCloudPublicConfig, DocsCloudRouteHandlerOptions, DocsCloudRouteHandlers, DocsCloudRuntimeEnv, DocsCloudRuntimeValue, DocsCloudServer, DocsCloudServerOptions, DocsCloudTrackEventOptions, createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
6
- import { $ as parsePromptStringArray, A as DocsSitemapFormat, B as resolveDocsSitemapConfig, C as resolveDocsSearchRequest, Ct as emitDocsObservabilityEvent, D as DEFAULT_SITEMAP_MD_ROUTE, E as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Et as resolveDocsObservabilityConfig, F as buildDocsSitemapManifest, G as DEFAULT_OPEN_DOCS_PROVIDER_IDS, H as resolveDocsSitemapRequest, I as createDocsSitemapResponse, J as PromptAction, K as DEFAULT_OPEN_DOCS_TARGET, L as readDocsSitemapManifestFromContentMap, M as DocsSitemapManifestPage, N as DocsSitemapPageInput, O as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, P as DocsSitemapResolvedConfig, Q as normalizePromptProviderName, R as renderDocsSitemapMarkdown, S as resolveDocsSearchFilters, St as emitDocsAnalyticsEvent, T as DEFAULT_SITEMAP_MANIFEST_PATH, Tt as resolveDocsAnalyticsConfig, U as toDocsSitemapMarkdownUrl, V as resolveDocsSitemapPageLastmod, W as DEFAULT_OPEN_DOCS_PROMPT, X as SerializeOpenDocsProviderOptions, Y as PromptProviderChoice, Z as SerializedOpenDocsProvider, _ as performDocsSearch, _t as ResolvedDocsAnalyticsConfig, a as buildDocsAskAIContext, at as serializeOpenDocsProviders, b as resolveDocsRetrievalLastModified, bt as createDocsAgentTraceId, c as createAlgoliaSearchAdapter, ct as DocsMarkdownPromptBlock, d as createSimpleSearchAdapter, et as resolvePromptProviderChoices, f as createTypesenseSearchAdapter, g as normalizeDocsSearchFilters, gt as DocsAgentTraceContext, h as inferDocsAskAIPackageHints, ht as DOCS_AGENT_TRACE_EVENT_TYPES, i as PerformDocsSearchOptions, it as serializeOpenDocsProvider, j as DocsSitemapManifest, k as DEFAULT_SITEMAP_XML_ROUTE, l as createCustomSearchAdapter, lt as ExtractedDocsMarkdownPromptBlocks, m as formatDocsAskAIPackageHints, n as isDocsRetrievalCanonicalUrl, nt as serializeDocsIcon, o as buildDocsRetrievalDigestProjection, p as enrichDocsSearchDocumentsWithProvenance, q as DEFAULT_PROMPT_PROVIDER_TEMPLATES, r as EnrichDocsSearchDocumentsWithProvenanceOptions, rt as serializeDocsIconRegistry, s as buildDocsSearchDocuments, t as digestDocsRetrievalContent, tt as sanitizePromptText, u as createMcpSearchAdapter, ut as extractDocsMarkdownPromptBlocks, v as performDocsSearchWithMetadata, vt as ResolvedDocsObservabilityConfig, w as resolveSearchRequestConfig, wt as getDocsRequestAnalyticsProperties, x as resolveDocsSearchAudience, xt as emitDocsAgentTraceEvent, y as resolveAskAISearchRequestConfig, yt as createDocsAgentTraceContext, z as renderDocsSitemapXml } from "./retrieval-digest-9Kp3uSaZ.mjs";
7
- 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";
6
+ import { $ as SerializeOpenDocsProviderOptions, A as DEFAULT_SITEMAP_MD_ROUTE, B as readDocsSitemapManifestFromContentMap, C as resolveDocsSearchAudience, D as resolveSearchRequestConfig, E as resolveDocsSearchRequest, F as DocsSitemapManifestPage, G as resolveDocsSitemapRequest, H as renderDocsSitemapXml, I as DocsSitemapPageInput, J as DEFAULT_OPEN_DOCS_PROVIDER_IDS, K as toDocsSitemapMarkdownUrl, L as DocsSitemapResolvedConfig, M as DEFAULT_SITEMAP_XML_ROUTE, N as DocsSitemapFormat, O as DEFAULT_SITEMAP_MANIFEST_PATH, P as DocsSitemapManifest, Q as PromptProviderChoice, R as buildDocsSitemapManifest, S as resolveDocsRetrievalLastModified, T as resolveDocsSearchFilters, U as resolveDocsSitemapConfig, V as renderDocsSitemapMarkdown, W as resolveDocsSitemapPageLastmod, X as DEFAULT_PROMPT_PROVIDER_TEMPLATES, Y as DEFAULT_OPEN_DOCS_TARGET, Z as PromptAction, _ as inferDocsAskAIPackageHints, _t as emitDocsObservabilityEvent, a as EnrichDocsSearchDocumentsWithProvenanceOptions, at as serializeDocsIcon, b as performDocsSearchWithMetadata, bt as resolveDocsObservabilityConfig, c as buildDocsRetrievalDigestProjection, ct as serializeOpenDocsProviders, d as createCustomSearchAdapter, dt as ResolvedDocsAnalyticsConfig, et as SerializedOpenDocsProvider, f as createMcpSearchAdapter, ft as ResolvedDocsObservabilityConfig, g as formatDocsAskAIPackageHints, gt as emitDocsAnalyticsEvent, h as enrichDocsSearchDocumentsWithProvenance, ht as emitDocsAgentTraceEvent, i as DocsSearchRequestError, it as sanitizePromptText, j as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, k as DEFAULT_SITEMAP_MD_DOCS_ROUTE, l as buildDocsSearchDocuments, lt as DOCS_AGENT_TRACE_EVENT_TYPES, m as createTypesenseSearchAdapter, mt as createDocsAgentTraceId, n as isDocsRetrievalCanonicalUrl, nt as parsePromptStringArray, o as PerformDocsSearchOptions, ot as serializeDocsIconRegistry, p as createSimpleSearchAdapter, pt as createDocsAgentTraceContext, q as DEFAULT_OPEN_DOCS_PROMPT, r as DocsPaginationCursorError, rt as resolvePromptProviderChoices, s as buildDocsAskAIContext, st as serializeOpenDocsProvider, t as digestDocsRetrievalContent, tt as normalizePromptProviderName, u as createAlgoliaSearchAdapter, ut as DocsAgentTraceContext, v as normalizeDocsSearchFilters, vt as getDocsRequestAnalyticsProperties, w as resolveDocsSearchError, x as resolveAskAISearchRequestConfig, y as performDocsSearch, yt as resolveDocsAnalyticsConfig, z as createDocsSitemapResponse } from "./retrieval-digest-rponR4jM.mjs";
7
+ import { gn as extractDocsMarkdownPromptBlocks, hn as ExtractedDocsMarkdownPromptBlocks, mn as DocsMarkdownPromptBlock } from "./agent-DRKj42ht.mjs";
8
+ 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, DocsMcpPageSectionIndex, DocsMcpPageSectionList, DocsMcpPaginatedDocsList, DocsMcpPagination, DocsMcpRequestContext, DocsMcpResolvedConfig, DocsMcpResolvedCorsConfig, DocsMcpResolvedProtectedResourceConfig, DocsMcpResolvedSecurityConfig, DocsMcpSource, DocsMcpTaskSummary, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, getDocsConfigSchema, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
8
9
 
9
10
  //#region src/code-group-mdx.d.ts
10
11
  interface MarkdownNode {
@@ -33,6 +34,7 @@ interface ResolvedApiReferenceConfig {
33
34
  enabled: boolean;
34
35
  path: string;
35
36
  specUrl?: string;
37
+ catalogTargets?: string[];
36
38
  renderer?: ApiReferenceRenderer;
37
39
  routeRoot: string;
38
40
  exclude: string[];
@@ -44,6 +46,7 @@ interface ApiReferenceOpenApiDiscovery {
44
46
  source?: "generated" | "configured";
45
47
  specUrl?: string;
46
48
  apiReferencePath?: string;
49
+ catalogTargets?: string[];
47
50
  }
48
51
  interface BuildApiReferenceOptions {
49
52
  framework: ApiReferenceFramework;
@@ -348,4 +351,4 @@ declare function runDocsGoldenTasks(pages: readonly DocsMcpPage[], tasks: readon
348
351
  //#region src/sitemap-server.d.ts
349
352
  declare function readDocsSitemapManifest(rootDir: string, sitemap?: boolean | DocsSitemapConfig): DocsSitemapManifest | null;
350
353
  //#endregion
351
- 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 DocsMarkdownPromptBlock, 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 DocsRetrievalSourceProvenance, type DocsRetrievalSourceScope, 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 EnrichDocsSearchDocumentsWithProvenanceOptions, type ExtractedDocsMarkdownPromptBlocks, 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, buildDocsRetrievalDigestProjection, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, digestDocsRetrievalContent, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, enrichDocsSearchDocumentsWithProvenance, ensureDocsReviewWorkflow, extractDocsMarkdownPromptBlocks, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, isDocsRetrievalCanonicalUrl, normalizeDocsMcpRoute, normalizeDocsSearchFilters, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, performDocsSearchWithMetadata, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsAgentSkillsBundle, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveConfiguredAgentSkills, resolveConfiguredAgentSkillsSync, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsRetrievalLastModified, resolveDocsReviewConfig, resolveDocsSearchAudience, resolveDocsSearchFilters, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };
354
+ 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 DocsMarkdownPromptBlock, 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 DocsMcpPageSectionIndex, type DocsMcpPageSectionList, type DocsMcpPaginatedDocsList, type DocsMcpPagination, type DocsMcpRequestContext, type DocsMcpResolvedConfig, type DocsMcpResolvedCorsConfig, type DocsMcpResolvedProtectedResourceConfig, type DocsMcpResolvedSecurityConfig, type DocsMcpSource, type DocsMcpTaskSummary, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsPaginatedSearchResponse, DocsPaginationCursorError, type DocsRetrievalSourceProvenance, type DocsRetrievalSourceScope, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchAdapterPage, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchFilterField, type DocsSearchFilterInput, type DocsSearchFilters, type DocsSearchQuery, type DocsSearchRequest, DocsSearchRequestError, type DocsSearchResponse, type DocsSearchResult, type DocsSearchSourcePage, type DocsSearchWarning, type DocsSearchWarningCode, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type EnrichDocsSearchDocumentsWithProvenanceOptions, type ExtractedDocsMarkdownPromptBlocks, 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, buildDocsRetrievalDigestProjection, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, digestDocsRetrievalContent, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, enrichDocsSearchDocumentsWithProvenance, ensureDocsReviewWorkflow, extractDocsMarkdownPromptBlocks, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, isDocsRetrievalCanonicalUrl, normalizeDocsMcpRoute, normalizeDocsSearchFilters, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, performDocsSearchWithMetadata, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsAgentSkillsBundle, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveConfiguredAgentSkills, resolveConfiguredAgentSkillsSync, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsRetrievalLastModified, resolveDocsReviewConfig, resolveDocsSearchAudience, resolveDocsSearchError, resolveDocsSearchFilters, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };
package/dist/server.mjs CHANGED
@@ -1,15 +1,15 @@
1
1
  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";
2
- import { Bt as renderDocsSitemapMarkdown, Et as extractDocsMarkdownPromptBlocks, Ft as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Gt as toDocsSitemapMarkdownUrl, Ht as resolveDocsSitemapConfig, It as DEFAULT_SITEMAP_XML_ROUTE, Lt as buildDocsSitemapManifest, Mt as DEFAULT_SITEMAP_MANIFEST_PATH, Nt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Pt as DEFAULT_SITEMAP_MD_ROUTE, Rt as createDocsSitemapResponse, Ut as resolveDocsSitemapPageLastmod, Vt as renderDocsSitemapXml, Wt as resolveDocsSitemapRequest, zt as readDocsSitemapManifestFromContentMap } from "./agent-BJ0KXN-A.mjs";
2
+ import { Bt as renderDocsSitemapMarkdown, Et as extractDocsMarkdownPromptBlocks, Ft as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, Gt as toDocsSitemapMarkdownUrl, Ht as resolveDocsSitemapConfig, It as DEFAULT_SITEMAP_XML_ROUTE, Lt as buildDocsSitemapManifest, Mt as DEFAULT_SITEMAP_MANIFEST_PATH, Nt as DEFAULT_SITEMAP_MD_DOCS_ROUTE, Pt as DEFAULT_SITEMAP_MD_ROUTE, Rt as createDocsSitemapResponse, Ut as resolveDocsSitemapPageLastmod, Vt as renderDocsSitemapXml, Wt as resolveDocsSitemapRequest, zt as readDocsSitemapManifestFromContentMap } from "./agent-SRIJ-oF8.mjs";
3
3
  import "./markdown-sections-7OoA7ylx.mjs";
4
- import "./standards-discovery-BwL5ffGx.mjs";
5
- import { O as digestDocsRetrievalContent, _ as resolveDocsSearchAudience, a as createCustomSearchAdapter, b as resolveSearchRequestConfig, c as createTypesenseSearchAdapter, d as inferDocsAskAIPackageHints, f as normalizeDocsSearchFilters, g as resolveDocsRetrievalLastModified, h as resolveAskAISearchRequestConfig, i as createAlgoliaSearchAdapter, k as isDocsRetrievalCanonicalUrl, l as enrichDocsSearchDocumentsWithProvenance, m as performDocsSearchWithMetadata, n as buildDocsRetrievalDigestProjection, o as createMcpSearchAdapter, p as performDocsSearch, r as buildDocsSearchDocuments, s as createSimpleSearchAdapter, t as buildDocsAskAIContext, u as formatDocsAskAIPackageHints, v as resolveDocsSearchFilters, y as resolveDocsSearchRequest } from "./search-DIyIl-tE.mjs";
6
- 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-BfyBM7_V.mjs";
7
- 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-LIScgQVm.mjs";
4
+ import "./standards-discovery-BKlEnK_H.mjs";
5
+ import { A as DocsPaginationCursorError, M as digestDocsRetrievalContent, N as isDocsRetrievalCanonicalUrl, S as resolveSearchRequestConfig, _ as resolveDocsRetrievalLastModified, a as createAlgoliaSearchAdapter, b as resolveDocsSearchFilters, c as createSimpleSearchAdapter, d as formatDocsAskAIPackageHints, f as inferDocsAskAIPackageHints, g as resolveAskAISearchRequestConfig, h as performDocsSearchWithMetadata, i as buildDocsSearchDocuments, l as createTypesenseSearchAdapter, m as performDocsSearch, n as buildDocsAskAIContext, o as createCustomSearchAdapter, p as normalizeDocsSearchFilters, r as buildDocsRetrievalDigestProjection, s as createMcpSearchAdapter, t as DocsSearchRequestError, u as enrichDocsSearchDocumentsWithProvenance, v as resolveDocsSearchAudience, x as resolveDocsSearchRequest, y as resolveDocsSearchError } from "./search-Da2AKaFJ.mjs";
6
+ 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-DHaxyPAd.mjs";
7
+ 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-DmFoKy_y.mjs";
8
8
  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";
9
9
  import { n as isDocsCloudAskAIProvider, t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-sbpjOR2K.mjs";
10
10
  import { createDocsCloudRouteHandler, createDocsCloudServer } from "./docs-cloud-server.mjs";
11
11
  import "./code-blocks-DnNVNK2M.mjs";
12
- import { n as resolveConfiguredAgentSkillsSync, t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
12
+ import { n as resolveConfiguredAgentSkillsSync, t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.mjs";
13
13
  import { renderDocsAgentSkillsBundle } from "./agent-skills-vite.mjs";
14
14
 
15
- 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, buildDocsRetrievalDigestProjection, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, digestDocsRetrievalContent, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, enrichDocsSearchDocumentsWithProvenance, ensureDocsReviewWorkflow, extractDocsMarkdownPromptBlocks, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, isDocsRetrievalCanonicalUrl, normalizeDocsMcpRoute, normalizeDocsSearchFilters, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, performDocsSearchWithMetadata, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsAgentSkillsBundle, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveConfiguredAgentSkills, resolveConfiguredAgentSkillsSync, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsRetrievalLastModified, resolveDocsReviewConfig, resolveDocsSearchAudience, resolveDocsSearchFilters, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };
15
+ 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, DocsPaginationCursorError, DocsSearchRequestError, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsRetrievalDigestProjection, buildDocsReviewWorkflow, buildDocsReviewWorkflowPathFilters, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAskAIResponse, createDocsCloudRouteHandler, createDocsCloudServer, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, digestDocsRetrievalContent, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, enrichDocsSearchDocumentsWithProvenance, ensureDocsReviewWorkflow, extractDocsMarkdownPromptBlocks, formatDocsAskAIPackageHints, getDocsConfigSchema, getDocsRequestAnalyticsProperties, inferDocsAskAIPackageHints, isApiReferenceOpenApiRequest, isDocsCloudAskAIProvider, isDocsRetrievalCanonicalUrl, normalizeDocsMcpRoute, normalizeDocsSearchFilters, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, performDocsSearchWithMetadata, readDocsReviewConfigFromSource, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, remarkCodeGroup, renderDocsAgentSkillsBundle, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveConfiguredAgentSkills, resolveConfiguredAgentSkillsSync, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsRetrievalLastModified, resolveDocsReviewConfig, resolveDocsSearchAudience, resolveDocsSearchError, resolveDocsSearchFilters, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsSitemapPageLastmod, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsGoldenTasks, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProvider, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };
@@ -1,12 +1,12 @@
1
- import { Bt as renderDocsSitemapMarkdown, Ht as resolveDocsSitemapConfig, Lt as buildDocsSitemapManifest, Vt as renderDocsSitemapXml } from "./agent-BJ0KXN-A.mjs";
1
+ import { Bt as renderDocsSitemapMarkdown, Ht as resolveDocsSitemapConfig, Lt as buildDocsSitemapManifest, Vt as renderDocsSitemapXml } from "./agent-SRIJ-oF8.mjs";
2
2
  import "./markdown-sections-7OoA7ylx.mjs";
3
- import "./standards-discovery-BwL5ffGx.mjs";
4
- import "./search-DIyIl-tE.mjs";
5
- import "./sitemap-server-BfyBM7_V.mjs";
6
- import "./agent-evals-LIScgQVm.mjs";
3
+ import "./standards-discovery-BKlEnK_H.mjs";
4
+ import "./search-Da2AKaFJ.mjs";
5
+ import "./sitemap-server-DHaxyPAd.mjs";
6
+ import "./agent-evals-DmFoKy_y.mjs";
7
7
  import { createFilesystemDocsMcpSource } from "./mcp.mjs";
8
8
  import "./code-blocks-DnNVNK2M.mjs";
9
- import "./agent-skills-server-noFn1l_p.mjs";
9
+ import "./agent-skills-server-B2EXn2QD.mjs";
10
10
  import "./server.mjs";
11
11
  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";
12
12
  import { t as detectFramework } from "./utils-DpiIioYb.mjs";
@@ -1,4 +1,4 @@
1
- import { Ht as resolveDocsSitemapConfig } from "./agent-BJ0KXN-A.mjs";
1
+ import { Ht as resolveDocsSitemapConfig } from "./agent-SRIJ-oF8.mjs";
2
2
  import { createRequire } from "node:module";
3
3
  import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
4
4
  import path, { basename, join, relative } from "node:path";
@@ -85,6 +85,7 @@ function resolveApiReferenceConfig(value) {
85
85
  enabled: true,
86
86
  path: "api-reference",
87
87
  specUrl: void 0,
88
+ catalogTargets: void 0,
88
89
  renderer: void 0,
89
90
  routeRoot: "api",
90
91
  exclude: []
@@ -93,6 +94,7 @@ function resolveApiReferenceConfig(value) {
93
94
  enabled: false,
94
95
  path: "api-reference",
95
96
  specUrl: void 0,
97
+ catalogTargets: void 0,
96
98
  renderer: void 0,
97
99
  routeRoot: "api",
98
100
  exclude: []
@@ -101,6 +103,7 @@ function resolveApiReferenceConfig(value) {
101
103
  enabled: value.enabled !== false,
102
104
  path: normalizePathSegment(value.path ?? "api-reference"),
103
105
  specUrl: normalizeRemoteSpecUrl(value.specUrl),
106
+ catalogTargets: normalizeApiReferenceCatalogTargets(value.catalogTargets),
104
107
  renderer: normalizeApiReferenceRenderer(value.renderer),
105
108
  routeRoot: normalizePathSegment(value.routeRoot ?? "api") || "api",
106
109
  exclude: normalizeApiReferenceExcludes(value.exclude)
@@ -117,13 +120,15 @@ function resolveApiReferenceRenderer(value, framework) {
117
120
  function resolveApiReferenceOpenApiDiscovery(value, options = {}) {
118
121
  const config = resolveApiReferenceConfig(value);
119
122
  if (!config.enabled) return { enabled: false };
123
+ const catalogTargets = config.catalogTargets ?? (!config.specUrl || isRequestRelativeSpecUrl(config.specUrl) ? ["/"] : void 0);
120
124
  return {
121
125
  enabled: true,
122
126
  url: options.route ?? DEFAULT_API_REFERENCE_OPENAPI_ROUTE,
123
127
  urlSource: options.route === void 0 ? "default" : "configured",
124
128
  source: config.specUrl ? "configured" : "generated",
125
129
  specUrl: config.specUrl,
126
- apiReferencePath: `/${config.path}`
130
+ apiReferencePath: `/${config.path}`,
131
+ catalogTargets
127
132
  };
128
133
  }
129
134
  function isApiReferenceOpenApiRequest(url) {
@@ -134,8 +139,12 @@ function normalizeRemoteSpecUrl(value) {
134
139
  if (!trimmed) return void 0;
135
140
  return trimmed;
136
141
  }
142
+ function normalizeApiReferenceCatalogTargets(value) {
143
+ if (value === void 0) return void 0;
144
+ return Array.from(new Set(value.filter((target) => typeof target === "string").map((target) => target.trim()).filter(Boolean)));
145
+ }
137
146
  function isRequestRelativeSpecUrl(value) {
138
- return typeof value === "string" && value.startsWith("/");
147
+ return typeof value === "string" && value.startsWith("/") && !value.startsWith("//");
139
148
  }
140
149
  function buildApiReferencePageTitle(config, title = "API Reference") {
141
150
  const template = config.metadata?.titleTemplate;
@@ -60,6 +60,14 @@ function compactUniqueTargets(targets) {
60
60
  return true;
61
61
  });
62
62
  }
63
+ function compactUniqueTargetsByHref(targets) {
64
+ const seen = /* @__PURE__ */ new Set();
65
+ return targets.filter((target) => {
66
+ if (!target || seen.has(target.href)) return false;
67
+ seen.add(target.href);
68
+ return true;
69
+ });
70
+ }
63
71
  function toTarget(route, origin, type, title) {
64
72
  const href = resolveHttpUrl(route, origin);
65
73
  return href ? {
@@ -75,9 +83,30 @@ function buildDocsApiCatalog(options) {
75
83
  const apiRoute = options.apiRoute === null ? null : resolveDocsDiscoveryApiRoute(options.apiRoute);
76
84
  const agentManifestRoute = options.agentManifestRoute === void 0 ? DEFAULT_AGENT_MANIFEST_ROUTE : options.agentManifestRoute;
77
85
  const agentSkillsIndexRoute = options.agentSkillsIndexRoute === void 0 ? DEFAULT_AGENT_SKILLS_INDEX_ROUTE : options.agentSkillsIndexRoute;
78
- const apiTargets = compactUniqueTargets([
86
+ const legacyOpenapiTargetRoutes = options.openapiTargetRoutes === void 0 ? apiRoute ? [apiRoute] : [] : options.openapiTargetRoutes;
87
+ const openapiDefinitions = [...options.openapiDefinitions ?? [], ...options.openapiRoute && legacyOpenapiTargetRoutes.length ? [{
88
+ route: options.openapiRoute,
89
+ targets: legacyOpenapiTargetRoutes.map((route) => ({
90
+ route,
91
+ title: route === apiRoute ? "Documentation API" : "Product API"
92
+ }))
93
+ }] : []];
94
+ const openapiApiTargets = [];
95
+ const serviceDescriptionsByAnchor = /* @__PURE__ */ new Map();
96
+ for (const definition of openapiDefinitions) {
97
+ const targets = compactUniqueTargetsByHref(definition.targets.map((target) => toTarget(target.route, options.origin, target.type, target.title)));
98
+ openapiApiTargets.push(...targets);
99
+ const descriptor = toTarget(definition.route, options.origin, definition.type ?? "application/vnd.oai.openapi+json;version=3.1", definition.title ?? "OpenAPI schema");
100
+ if (!descriptor) continue;
101
+ for (const target of targets) {
102
+ const current = serviceDescriptionsByAnchor.get(target.href) ?? [];
103
+ serviceDescriptionsByAnchor.set(target.href, compactUniqueTargets([...current, descriptor]));
104
+ }
105
+ }
106
+ const apiTargets = compactUniqueTargetsByHref([
79
107
  toTarget(apiRoute, options.origin, "application/json", "Documentation API"),
80
108
  ...(options.apiRoutes ?? []).map((target) => toTarget(target.route, options.origin, target.type, target.title)),
109
+ ...openapiApiTargets,
81
110
  toTarget(options.mcpRoute, options.origin, "application/json", "Documentation MCP endpoint"),
82
111
  ...(options.feedbackRoutes ?? []).map((route, index) => toTarget(route, options.origin, index === 0 ? "application/json" : "application/schema+json", index === 0 ? "Agent feedback endpoint" : "Agent feedback schema"))
83
112
  ]);
@@ -100,7 +129,6 @@ function buildDocsApiCatalog(options) {
100
129
  toTarget(options.robotsRoute, options.origin, "text/plain", "Robots policy"),
101
130
  ...(options.protectedResourceMetadataRoutes ?? []).map((route) => toTarget(route, options.origin, "application/json", "OAuth protected-resource metadata"))
102
131
  ]);
103
- const serviceDescriptions = compactUniqueTargets([toTarget(options.openapiRoute, options.origin, "application/vnd.oai.openapi+json;version=3.1", "OpenAPI schema")]);
104
132
  const catalogContext = {
105
133
  anchor: catalogUrl,
106
134
  "api-catalog": [{
@@ -112,13 +140,13 @@ function buildDocsApiCatalog(options) {
112
140
  if (apiTargets.length > 0) catalogContext.item = apiTargets;
113
141
  if (serviceDocs.length > 0) catalogContext["service-doc"] = serviceDocs;
114
142
  if (serviceMetadata.length > 0) catalogContext["service-meta"] = serviceMetadata;
115
- if (serviceDescriptions.length > 0) catalogContext["service-desc"] = serviceDescriptions;
116
143
  const linkset = [catalogContext];
117
144
  for (const target of apiTargets) {
118
145
  const context = { anchor: target.href };
119
146
  if (serviceDocs.length > 0) context["service-doc"] = serviceDocs;
120
147
  if (serviceMetadata.length > 0) context["service-meta"] = serviceMetadata;
121
- if (serviceDescriptions.length > 0 && target.href === resolveHttpUrl(apiRoute, options.origin)) context["service-desc"] = serviceDescriptions;
148
+ const serviceDescriptions = serviceDescriptionsByAnchor.get(target.href);
149
+ if (serviceDescriptions?.length) context["service-desc"] = serviceDescriptions;
122
150
  linkset.push(context);
123
151
  }
124
152
  return { linkset };
@@ -1,4 +1,4 @@
1
- import { A as DocsAgentA2ASecurityScheme, M as DocsAgentA2ASkill, O as DocsAgentA2AProtocolBinding, h as DocsAgentA2AConfig, k as DocsAgentA2ASecurityRequirement, m as DocsAgentA2ACapabilities } from "./types-clg5J1R4.mjs";
1
+ import { A as DocsAgentA2ASecurityScheme, M as DocsAgentA2ASkill, O as DocsAgentA2AProtocolBinding, h as DocsAgentA2AConfig, k as DocsAgentA2ASecurityRequirement, m as DocsAgentA2ACapabilities } from "./types-B-5Kzmkn.mjs";
2
2
 
3
3
  //#region src/standards-discovery.d.ts
4
4
  declare const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";
@@ -97,6 +97,19 @@ interface DocsApiCatalogLinkTarget {
97
97
  type?: string;
98
98
  title?: string;
99
99
  }
100
+ interface DocsApiCatalogApiTarget {
101
+ route: string;
102
+ type?: string;
103
+ title?: string;
104
+ }
105
+ interface DocsApiCatalogOpenApiDefinition {
106
+ /** OpenAPI document URL, relative to the docs origin or absolute. */
107
+ route: string;
108
+ /** Product API targets described by this OpenAPI document. */
109
+ targets: readonly DocsApiCatalogApiTarget[];
110
+ type?: string;
111
+ title?: string;
112
+ }
100
113
  interface DocsApiCatalogLinkContext {
101
114
  anchor: string;
102
115
  item?: DocsApiCatalogLinkTarget[];
@@ -113,11 +126,7 @@ interface DocsApiCatalogOptions {
113
126
  docsRoute?: string;
114
127
  apiRoute?: string | null;
115
128
  /** Additional HTTP API endpoints to list as RFC 9727 `item` links. */
116
- apiRoutes?: readonly {
117
- route: string;
118
- type?: string;
119
- title?: string;
120
- }[];
129
+ apiRoutes?: readonly DocsApiCatalogApiTarget[];
121
130
  configRoute?: string | null;
122
131
  diagnosticsRoute?: string | null;
123
132
  agentManifestRoute?: string | null;
@@ -133,7 +142,25 @@ interface DocsApiCatalogOptions {
133
142
  mcpRoute?: string | null;
134
143
  protectedResourceMetadataRoutes?: readonly string[];
135
144
  feedbackRoutes?: readonly string[];
145
+ /** OpenAPI documents paired with the product API targets they describe. */
146
+ openapiDefinitions?: readonly DocsApiCatalogOpenApiDefinition[];
147
+ /**
148
+ * Legacy single OpenAPI document URL.
149
+ *
150
+ * By default this describes `apiRoute`, preserving the previous single-schema
151
+ * behavior without attaching it to the catalog itself. Set
152
+ * `openapiTargetRoutes` to associate product APIs or to `[]` to disable the
153
+ * association. Prefer `openapiDefinitions` for new integrations.
154
+ *
155
+ * @deprecated Use `openapiDefinitions`.
156
+ */
136
157
  openapiRoute?: string | null;
158
+ /**
159
+ * Product targets described by the legacy `openapiRoute`.
160
+ *
161
+ * @deprecated Use `openapiDefinitions`.
162
+ */
163
+ openapiTargetRoutes?: readonly string[];
137
164
  apiReferenceRoute?: string | null;
138
165
  }
139
166
  type DocsStandardsDiscoveryRequest = {
@@ -218,4 +245,4 @@ declare function createDocsStandardsResponse({
218
245
  agentCard
219
246
  }: CreateDocsStandardsResponseOptions): Promise<Response | null>;
220
247
  //#endregion
221
- export { resolveDocsStandardsDiscoveryRequest as $, DocsAgentSkillIndexEntry as A, DocsStandardsDiscoveryRequest as B, DOCS_AGENT_MANIFEST_FORMAT as C, DocsA2AAgentCard as D, DOCS_AGENT_MANIFEST_VERSION as E, DocsApiCatalogOptions as F, buildDocsApiCatalog as G, appendDocsDiscoveryLinkHeader as H, DocsDiscoveryApiRouteOptions as I, getDocsAgentManifestLinkHeader as J, buildDocsLegacySkillsIndex as K, DocsPublishedAgentSkill as L, DocsApiCatalog as M, DocsApiCatalogLinkContext as N, DocsA2AAgentCardOptions as O, DocsApiCatalogLinkTarget as P, resolveDocsPublishedAgentSkill as Q, DocsPublishedAgentSkillFile as R, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as S, DOCS_AGENT_MANIFEST_SCHEMA_URI as T, buildDocsA2AAgentCard as U, DocsStandardsDiscoveryRouteOptions as V, buildDocsAgentSkillsIndex as W, isDocsStandardsDiscoveryRequest as X, getDocsDiscoveryLinkHeader as Y, resolveDocsDiscoveryApiRoute as Z, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as _, DEFAULT_A2A_AGENT_CARD_FORMAT as a, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as b, DEFAULT_A2A_PROTOCOL_VERSION as c, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as d, sha256DocsDiscoveryContent as et, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as f, DEFAULT_AGENT_SKILL_FORMAT as g, DEFAULT_AGENT_SKILL_FILE_FORMAT as h, CreateDocsStandardsResponseOptions as i, DocsAgentSkillsIndex as j, DocsA2AAgentInterface as k, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as l, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, DEFAULT_A2A_AGENT_CARD_ROUTE as o, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as p, createDocsStandardsResponse as q, API_CATALOG_PROFILE_URI as r, DEFAULT_A2A_PROTOCOL_BINDING as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as u, DEFAULT_API_CATALOG_FORMAT as v, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE as w, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as x, DEFAULT_API_CATALOG_ROUTE as y, DocsPublishedAgentSkillOptions as z };
248
+ export { resolveDocsDiscoveryApiRoute as $, DocsAgentSkillIndexEntry as A, DocsPublishedAgentSkillFile as B, DOCS_AGENT_MANIFEST_FORMAT as C, DocsA2AAgentCard as D, DOCS_AGENT_MANIFEST_VERSION as E, DocsApiCatalogLinkTarget as F, buildDocsA2AAgentCard as G, DocsStandardsDiscoveryRequest as H, DocsApiCatalogOpenApiDefinition as I, buildDocsLegacySkillsIndex as J, buildDocsAgentSkillsIndex as K, DocsApiCatalogOptions as L, DocsApiCatalog as M, DocsApiCatalogApiTarget as N, DocsA2AAgentCardOptions as O, DocsApiCatalogLinkContext as P, isDocsStandardsDiscoveryRequest as Q, DocsDiscoveryApiRouteOptions as R, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as S, DOCS_AGENT_MANIFEST_SCHEMA_URI as T, DocsStandardsDiscoveryRouteOptions as U, DocsPublishedAgentSkillOptions as V, appendDocsDiscoveryLinkHeader as W, getDocsAgentManifestLinkHeader as X, createDocsStandardsResponse as Y, getDocsDiscoveryLinkHeader as Z, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as _, DEFAULT_A2A_AGENT_CARD_FORMAT as a, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as b, DEFAULT_A2A_PROTOCOL_VERSION as c, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as d, resolveDocsPublishedAgentSkill as et, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as f, DEFAULT_AGENT_SKILL_FORMAT as g, DEFAULT_AGENT_SKILL_FILE_FORMAT as h, CreateDocsStandardsResponseOptions as i, DocsAgentSkillsIndex as j, DocsA2AAgentInterface as k, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as l, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, sha256DocsDiscoveryContent as nt, DEFAULT_A2A_AGENT_CARD_ROUTE as o, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as p, buildDocsApiCatalog as q, API_CATALOG_PROFILE_URI as r, DEFAULT_A2A_PROTOCOL_BINDING as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, resolveDocsStandardsDiscoveryRequest as tt, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as u, DEFAULT_API_CATALOG_FORMAT as v, DOCS_AGENT_MANIFEST_SCHEMA_MEDIA_TYPE as w, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as x, DEFAULT_API_CATALOG_ROUTE as y, DocsPublishedAgentSkill as z };
@@ -1188,6 +1188,11 @@ interface DocsMcpToolsConfig {
1188
1188
  listDocs?: boolean;
1189
1189
  /** Expose a `list_pages` tool that returns the known docs pages. */
1190
1190
  listPages?: boolean;
1191
+ /**
1192
+ * Expose a `list_page_sections` tool that returns body-free section discovery metadata
1193
+ * for a page.
1194
+ */
1195
+ listPageSections?: boolean;
1191
1196
  /** Expose a `read_page` tool that returns a page by slug or URL path. */
1192
1197
  readPage?: boolean;
1193
1198
  /** Expose a `list_tasks` tool for pages with actionable agent contracts. */
@@ -1436,17 +1441,45 @@ interface DocsSearchResponse {
1436
1441
  * for callers that construct the versioned response object themselves.
1437
1442
  */
1438
1443
  indexGeneration?: string;
1444
+ /** Number of results in this response page. */
1439
1445
  resultCount: number;
1446
+ /**
1447
+ * Exact number of results available for the cursor-bound query.
1448
+ * Built-in structured endpoints always emit this; optionality preserves the v1
1449
+ * producer contract for existing integrations.
1450
+ */
1451
+ total?: number;
1452
+ /**
1453
+ * Whether another page can be requested with `nextCursor`.
1454
+ * Built-in structured endpoints always emit this; optionality preserves the v1
1455
+ * producer contract for existing integrations.
1456
+ */
1457
+ hasMore?: boolean;
1458
+ /** Opaque cursor for the next page. Omitted when this is the final page. */
1459
+ nextCursor?: string;
1440
1460
  results: DocsSearchResult[];
1441
1461
  warnings: DocsSearchWarning[];
1442
1462
  }
1463
+ /** Structured search response emitted by built-in cursor-aware endpoints. */
1464
+ interface DocsPaginatedSearchResponse extends DocsSearchResponse {
1465
+ total: number;
1466
+ hasMore: boolean;
1467
+ }
1443
1468
  interface DocsSearchRequest {
1444
1469
  filters: DocsSearchFilters;
1445
1470
  structured: boolean;
1471
+ /** Opaque cursor supplied by a previous structured response. */
1472
+ cursor?: string;
1473
+ /** Structured response page size. */
1474
+ limit?: number;
1446
1475
  }
1447
1476
  interface DocsSearchQuery {
1448
1477
  query: string;
1449
1478
  limit?: number;
1479
+ /** Zero-based provider offset used by the shared structured-search pipeline. */
1480
+ offset?: number;
1481
+ /** Provider cursor used by cursor-native remote adapters. */
1482
+ cursor?: string;
1450
1483
  locale?: string;
1451
1484
  pathname?: string;
1452
1485
  /** Requested content projection. Omitted callers retain the human-search default. */
@@ -1479,6 +1512,24 @@ interface DocsSearchAdapter {
1479
1512
  name: string;
1480
1513
  index?(context: DocsSearchAdapterContext): Promise<void>;
1481
1514
  search(query: DocsSearchQuery, context: DocsSearchAdapterContext): Promise<DocsSearchResult[]>;
1515
+ /**
1516
+ * Optional exact pagination contract. Built-in adapters implement this while legacy custom
1517
+ * adapters can continue exposing only `search`.
1518
+ */
1519
+ searchPage?(query: DocsSearchQuery, context: DocsSearchAdapterContext): Promise<DocsSearchAdapterPage>;
1520
+ }
1521
+ /**
1522
+ * Exact page metadata returned by pagination-aware search adapters.
1523
+ *
1524
+ * Legacy custom adapters may continue implementing only `search` for unpaginated callers.
1525
+ * Cursor-aware structured search uses the exact local fallback unless the custom adapter
1526
+ * also implements `searchPage` and declares a stable `paginationRevision`.
1527
+ */
1528
+ interface DocsSearchAdapterPage {
1529
+ results: DocsSearchResult[];
1530
+ total: number;
1531
+ /** Cursor-native providers can supply their own continuation token. */
1532
+ nextCursor?: string;
1482
1533
  }
1483
1534
  type DocsSearchAdapterFactory = (context: DocsSearchAdapterContext) => DocsSearchAdapter | Promise<DocsSearchAdapter>;
1484
1535
  interface DocsSearchChunkingConfig {
@@ -1574,6 +1625,13 @@ interface CustomDocsSearchConfig {
1574
1625
  provider: "custom";
1575
1626
  enabled?: boolean;
1576
1627
  adapter: DocsSearchAdapter | DocsSearchAdapterFactory;
1628
+ /**
1629
+ * Stable revision for the adapter's result ordering.
1630
+ *
1631
+ * Custom adapters must set this and implement `searchPage` to participate in cursor
1632
+ * pagination. Change it whenever ranking behavior changes so old cursors fail closed.
1633
+ */
1634
+ paginationRevision?: string;
1577
1635
  maxResults?: number;
1578
1636
  chunking?: DocsSearchChunkingConfig;
1579
1637
  }
@@ -2423,6 +2481,20 @@ interface ApiReferenceConfig {
2423
2481
  * ```
2424
2482
  */
2425
2483
  specUrl?: string;
2484
+ /**
2485
+ * Product API base URLs described by the OpenAPI document.
2486
+ *
2487
+ * These URLs become RFC 9727 API catalog targets, and the OpenAPI document is
2488
+ * associated with each target through `service-desc`. Relative URLs resolve
2489
+ * against the docs origin.
2490
+ *
2491
+ * Same-origin generated schemas default to the request origin. Set this for
2492
+ * remotely hosted schemas because the schema URL is not necessarily the API
2493
+ * URL. An explicit empty array disables the catalog association.
2494
+ *
2495
+ * @example ["https://api.example.com/v1"]
2496
+ */
2497
+ catalogTargets?: string[];
2426
2498
  /**
2427
2499
  * Which renderer to use for the API reference UI.
2428
2500
  *
@@ -3613,4 +3685,4 @@ interface DocsConfig {
3613
3685
  og?: OGConfig;
3614
3686
  }
3615
3687
  //#endregion
3616
- export { DocsAgentSkillsInput as $, PageAgentFailureMode as $n, DocsReviewCiMode as $t, DocsAgentA2ASecurityScheme as A, DocsTelemetryFeatures as An, DocsFeedbackData as At, DocsAgentEvaluationSourceReference as B, LlmsTxtSectionConfig as Bn, DocsMcpOriginContext as Bt, DocsAgentA2AOAuthDeviceCodeFlow as C, DocsSearchWarningCode as Cn, DocsCodeBlocksPlannerProvider as Ct, DocsAgentA2AOpenIdConnectSecurityScheme as D, DocsTelemetryEvent as Dn, DocsCodeBlocksValidationMode as Dt, DocsAgentA2AOAuthPasswordFlow as E, DocsTelemetryConfig as En, DocsCodeBlocksValidateConfig as Et, DocsAgentEvaluationAnswerInput as F, GithubConfig as Fn, DocsMcpAuthenticate as Ft, DocsAgentFeedbackData as G, OpenDocsProviderConfig as Gn, DocsNav as Gt, DocsAgentEvaluationTaskInput as H, OGConfig as Hn, DocsMcpSecurityConfig as Ht, DocsAgentEvaluationAnswerProvider as I, LastUpdatedConfig as In, DocsMcpAuthenticateContext as It, DocsAgentGoldenExpectedExample as J, OpenGraphImage as Jn, DocsObservabilityEventInput as Jt, DocsAgentGoldenAnswerExpectation as K, OpenDocsProviderId as Kn, DocsObservabilityConfig as Kt, DocsAgentEvaluationAnswerRequest as L, LlmsTxtConfig as Ln, DocsMcpAuthenticateResult as Lt, DocsAgentA2ASkill as M, DocsTheme as Mn, DocsI18nConfig as Mt, DocsAgentCompactConfig as N, FeedbackConfig as Nn, DocsMcpAllowedOrigins as Nt, DocsAgentA2AProtocolBinding as O, DocsTelemetryEventInput as On, DocsCodeBlocksValidationPolicy as Ot, DocsAgentConfig as P, FontStyle as Pn, DocsMcpAuthPrincipal as Pt, DocsAgentSkillsConfig as Q, PageAgentCommand as Qn, DocsReviewCiConfig as Qt, DocsAgentEvaluationAnswerResult as R, LlmsTxtMaxCharsConfig as Rn, DocsMcpConfig as Rt, DocsAgentA2AOAuthClientCredentialsFlow as S, DocsSearchWarning as Sn, DocsCodeBlocksPlannerConfig as St, DocsAgentA2AOAuthImplicitFlow as T, DocsTelemetryAgentSurface as Tn, DocsCodeBlocksRunnerProvider as Tt, DocsAgentEvaluationsConfig as U, OpenDocsConfig as Un, DocsMcpToolsConfig as Ut, DocsAgentEvaluationSurface as V, McpDocsSearchConfig as Vn, DocsMcpProtectedResourceConfig as Vt, DocsAgentFeedbackContext as W, OpenDocsProvider as Wn, DocsMetadata as Wt, DocsAgentGoldenTaskExpectation as X, PageActionsConfig as Xn, DocsRetrievalSourceProvenance as Xt, DocsAgentGoldenTask as Y, OrderingItem as Yn, DocsRelatedItem as Yt, DocsAgentGoldenTaskFilters as Z, PageAgentAppliesTo as Zn, DocsRetrievalSourceScope as Zt, DocsAgentA2AHttpAuthSecurityScheme as _, DocsSearchRequest as _n, ThemeToggleConfig as _r, DocsCloudConfig as _t, ApiReferenceRenderer as a, DocsRobotsRule as an, PageTwitter as ar, DocsAnalyticsEventInput as at, DocsAgentA2AOAuth2SecurityScheme as b, DocsSearchResultType as bn, UIConfig as br, DocsCloudPublishConfig as bt, ChangelogFrontmatter as c, DocsSearchAdapterFactory as cn, ResolvedDocsRelatedLink as cr, DocsAnalyticsSource as ct, CopyMarkdownFormat as d, DocsSearchDocument as dn, SidebarFolderIndexBehavior as dr, DocsAskAIFeedbackConfig as dt, DocsReviewConfig as en, PageAgentFrontmatter as er, DocsAgentTraceEventInput as et, CustomDocsSearchConfig as f, DocsSearchEmbeddingsConfig as fn, SidebarFolderNode as fr, DocsAskAIFeedbackData as ft, DocsAgentA2AExtension as g, DocsSearchQuery as gn, SimpleDocsSearchConfig as gr, DocsCloudApiKeyConfig as gt, DocsAgentA2AConfig as h, DocsSearchFilters as hn, SidebarTree as hr, DocsAskAIMcpConfig as ht, ApiReferenceConfig as i, DocsRobotsConfig as in, PageSidebarFrontmatter as ir, DocsAnalyticsEvent as it, DocsAgentA2ASecurityScopeList as j, DocsTelemetryFramework as jn, DocsFeedbackValue as jt, DocsAgentA2ASecurityRequirement as k, DocsTelemetryEventType as kn, DocsConfig as kt, CodeBlockCopyData as l, DocsSearchChunkingConfig as ln, SidebarComponentProps as lr, DocsAskAIActionData as lt, DocsAgentA2ACapabilities as m, DocsSearchFilterInput as mn, SidebarPageNode as mr, DocsAskAIFeedbackValue as mt, AgentFeedbackConfig as n, DocsReviewScoreConfig as nn, PageFrontmatter as nr, DocsAgentTraceStatus as nt, BreadcrumbConfig as o, DocsSearchAdapter as on, ReadingTimeConfig as or, DocsAnalyticsEventType as ot, DocsAgentA2AApiKeySecurityScheme as p, DocsSearchFilterField as pn, SidebarNode as pr, DocsAskAIFeedbackMessage as pt, DocsAgentGoldenExampleVerification as q, OpenDocsTarget as qn, DocsObservabilityEvent as qt, AlgoliaDocsSearchConfig as r, DocsReviewSeverity as rn, PageOpenGraph as rr, DocsAnalyticsConfig as rt, ChangelogConfig as s, DocsSearchAdapterContext as sn, ReadingTimeFormat as sr, DocsAnalyticsInput as st, AIConfig as t, DocsReviewRulesConfig as tn, PageAgentVerification as tr, DocsAgentTraceEventType as tt, CopyMarkdownConfig as u, DocsSearchConfig as un, SidebarConfig as ur, DocsAskAIActionType as ut, DocsAgentA2AInterfaceConfig as v, DocsSearchResponse as vn, TypesenseDocsSearchConfig as vr, DocsCloudFeatureConfig as vt, DocsAgentA2AOAuthFlows as w, DocsSitemapConfig as wn, DocsCodeBlocksRunnerConfig as wt, DocsAgentA2AOAuthAuthorizationCodeFlow as x, DocsSearchSourcePage as xn, DocsCodeBlocksConfig as xt, DocsAgentA2AMutualTlsSecurityScheme as y, DocsSearchResult as yn, TypographyConfig as yr, DocsCloudPreviewConfig as yt, DocsAgentEvaluationAnswerRunner as z, LlmsTxtMaxCharsMode as zn, DocsMcpCorsConfig as zt };
3688
+ export { DocsAgentSkillsInput as $, PageAgentAppliesTo as $n, DocsReviewCiConfig as $t, DocsAgentA2ASecurityScheme as A, DocsTelemetryEventInput as An, DocsFeedbackData as At, DocsAgentEvaluationSourceReference as B, LlmsTxtMaxCharsConfig as Bn, DocsMcpOriginContext as Bt, DocsAgentA2AOAuthDeviceCodeFlow as C, DocsSearchSourcePage as Cn, DocsCodeBlocksPlannerProvider as Ct, DocsAgentA2AOpenIdConnectSecurityScheme as D, DocsTelemetryAgentSurface as Dn, DocsCodeBlocksValidationMode as Dt, DocsAgentA2AOAuthPasswordFlow as E, DocsSitemapConfig as En, DocsCodeBlocksValidateConfig as Et, DocsAgentEvaluationAnswerInput as F, FeedbackConfig as Fn, DocsMcpAuthenticate as Ft, DocsAgentFeedbackData as G, OpenDocsConfig as Gn, DocsNav as Gt, DocsAgentEvaluationTaskInput as H, LlmsTxtSectionConfig as Hn, DocsMcpSecurityConfig as Ht, DocsAgentEvaluationAnswerProvider as I, FontStyle as In, DocsMcpAuthenticateContext as It, DocsAgentGoldenExpectedExample as J, OpenDocsProviderId as Jn, DocsObservabilityEventInput as Jt, DocsAgentGoldenAnswerExpectation as K, OpenDocsProvider as Kn, DocsObservabilityConfig as Kt, DocsAgentEvaluationAnswerRequest as L, GithubConfig as Ln, DocsMcpAuthenticateResult as Lt, DocsAgentA2ASkill as M, DocsTelemetryFeatures as Mn, DocsI18nConfig as Mt, DocsAgentCompactConfig as N, DocsTelemetryFramework as Nn, DocsMcpAllowedOrigins as Nt, DocsAgentA2AProtocolBinding as O, DocsTelemetryConfig as On, DocsCodeBlocksValidationPolicy as Ot, DocsAgentConfig as P, DocsTheme as Pn, DocsMcpAuthPrincipal as Pt, DocsAgentSkillsConfig as Q, PageActionsConfig as Qn, DocsRetrievalSourceScope as Qt, DocsAgentEvaluationAnswerResult as R, LastUpdatedConfig as Rn, DocsMcpConfig as Rt, DocsAgentA2AOAuthClientCredentialsFlow as S, DocsSearchResultType as Sn, UIConfig as Sr, DocsCodeBlocksPlannerConfig as St, DocsAgentA2AOAuthImplicitFlow as T, DocsSearchWarningCode as Tn, DocsCodeBlocksRunnerProvider as Tt, DocsAgentEvaluationsConfig as U, McpDocsSearchConfig as Un, DocsMcpToolsConfig as Ut, DocsAgentEvaluationSurface as V, LlmsTxtMaxCharsMode as Vn, DocsMcpProtectedResourceConfig as Vt, DocsAgentFeedbackContext as W, OGConfig as Wn, DocsMetadata as Wt, DocsAgentGoldenTaskExpectation as X, OpenGraphImage as Xn, DocsRelatedItem as Xt, DocsAgentGoldenTask as Y, OpenDocsTarget as Yn, DocsPaginatedSearchResponse as Yt, DocsAgentGoldenTaskFilters as Z, OrderingItem as Zn, DocsRetrievalSourceProvenance as Zt, DocsAgentA2AHttpAuthSecurityScheme as _, DocsSearchFilters as _n, SidebarTree as _r, DocsCloudConfig as _t, ApiReferenceRenderer as a, DocsRobotsConfig as an, PageOpenGraph as ar, DocsAnalyticsEventInput as at, DocsAgentA2AOAuth2SecurityScheme as b, DocsSearchResponse as bn, TypesenseDocsSearchConfig as br, DocsCloudPublishConfig as bt, ChangelogFrontmatter as c, DocsSearchAdapterContext as cn, ReadingTimeConfig as cr, DocsAnalyticsSource as ct, CopyMarkdownFormat as d, DocsSearchChunkingConfig as dn, SidebarComponentProps as dr, DocsAskAIFeedbackConfig as dt, DocsReviewCiMode as en, PageAgentCommand as er, DocsAgentTraceEventInput as et, CustomDocsSearchConfig as f, DocsSearchConfig as fn, SidebarConfig as fr, DocsAskAIFeedbackData as ft, DocsAgentA2AExtension as g, DocsSearchFilterInput as gn, SidebarPageNode as gr, DocsCloudApiKeyConfig as gt, DocsAgentA2AConfig as h, DocsSearchFilterField as hn, SidebarNode as hr, DocsAskAIMcpConfig as ht, ApiReferenceConfig as i, DocsReviewSeverity as in, PageFrontmatter as ir, DocsAnalyticsEvent as it, DocsAgentA2ASecurityScopeList as j, DocsTelemetryEventType as jn, DocsFeedbackValue as jt, DocsAgentA2ASecurityRequirement as k, DocsTelemetryEvent as kn, DocsConfig as kt, CodeBlockCopyData as l, DocsSearchAdapterFactory as ln, ReadingTimeFormat as lr, DocsAskAIActionData as lt, DocsAgentA2ACapabilities as m, DocsSearchEmbeddingsConfig as mn, SidebarFolderNode as mr, DocsAskAIFeedbackValue as mt, AgentFeedbackConfig as n, DocsReviewRulesConfig as nn, PageAgentFrontmatter as nr, DocsAgentTraceStatus as nt, BreadcrumbConfig as o, DocsRobotsRule as on, PageSidebarFrontmatter as or, DocsAnalyticsEventType as ot, DocsAgentA2AApiKeySecurityScheme as p, DocsSearchDocument as pn, SidebarFolderIndexBehavior as pr, DocsAskAIFeedbackMessage as pt, DocsAgentGoldenExampleVerification as q, OpenDocsProviderConfig as qn, DocsObservabilityEvent as qt, AlgoliaDocsSearchConfig as r, DocsReviewScoreConfig as rn, PageAgentVerification as rr, DocsAnalyticsConfig as rt, ChangelogConfig as s, DocsSearchAdapter as sn, PageTwitter as sr, DocsAnalyticsInput as st, AIConfig as t, DocsReviewConfig as tn, PageAgentFailureMode as tr, DocsAgentTraceEventType as tt, CopyMarkdownConfig as u, DocsSearchAdapterPage as un, ResolvedDocsRelatedLink as ur, DocsAskAIActionType as ut, DocsAgentA2AInterfaceConfig as v, DocsSearchQuery as vn, SimpleDocsSearchConfig as vr, DocsCloudFeatureConfig as vt, DocsAgentA2AOAuthFlows as w, DocsSearchWarning as wn, DocsCodeBlocksRunnerConfig as wt, DocsAgentA2AOAuthAuthorizationCodeFlow as x, DocsSearchResult as xn, TypographyConfig as xr, DocsCodeBlocksConfig as xt, DocsAgentA2AMutualTlsSecurityScheme as y, DocsSearchRequest as yn, ThemeToggleConfig as yr, DocsCloudPreviewConfig as yt, DocsAgentEvaluationAnswerRunner as z, LlmsTxtConfig as zn, DocsMcpCorsConfig as zt };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@farming-labs/docs",
3
- "version": "0.2.74",
3
+ "version": "0.2.77",
4
4
  "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
5
5
  "keywords": [
6
6
  "docs",