@farming-labs/docs 0.2.75 → 0.2.78

package/dist/{agent-cAPjC2jb.d.mts → agent-CHgWJcK_.d.mts}

@@ -1,5 +1,5 @@
-import { Bn as LlmsTxtSectionConfig, G as DocsAgentFeedbackData, Ln as LlmsTxtConfig, Mt as DocsI18nConfig, Nn as FeedbackConfig, Rn as LlmsTxtMaxCharsConfig, Rt as DocsMcpConfig, cr as ResolvedDocsRelatedLink, er as PageAgentFrontmatter, in as DocsRobotsConfig, kt as DocsConfig, un as DocsSearchConfig, wn as DocsSitemapConfig, xn as DocsSearchSourcePage, zn as LlmsTxtMaxCharsMode } from "./types-BDRwrExu.mjs";
-import { I as DocsDiscoveryApiRouteOptions, L as DocsPublishedAgentSkill, O as DocsA2AAgentCardOptions } from "./standards-discovery-DBI1PD7m.mjs";
+import { $n as LlmsTxtMaxCharsMode, At as DocsConfig, F as DocsAgentContentChangesConfig, Fn as DocsSearchSourcePage, K as DocsAgentFeedbackData, Qn as LlmsTxtMaxCharsConfig, Rn as DocsSitemapConfig, Sr as ResolvedDocsRelatedLink, Vt as DocsI18nConfig, Zn as LlmsTxtConfig, er as LlmsTxtSectionConfig, mn as DocsRobotsConfig, mr as PageAgentFrontmatter, qn as FeedbackConfig, qt as DocsMcpConfig, xn as DocsSearchConfig } from "./types-CpLnwHak.mjs";
+import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-BWyNgZSs.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/i18n.d.ts
@@ -147,6 +147,8 @@ interface DocsOpenApiDiscoveryConfig {
   source?: "generated" | "configured";
   specUrl?: string;
   apiReferencePath?: string;
+  /** Product API targets described by this OpenAPI document. */
+  catalogTargets?: readonly string[];
 }
 interface DocsOpenApiResolvedDiscoveryConfig {
   enabled: boolean;
@@ -156,6 +158,8 @@ interface DocsOpenApiResolvedDiscoveryConfig {
   source?: "generated" | "configured";
   specUrl?: string;
   apiReferencePath?: string;
+  /** Product API targets described by this OpenAPI document. */
+  catalogTargets?: readonly string[];
 }
 type DocsConfigMapJsonPrimitive = string | number | boolean | null;
 type DocsConfigMapJsonValue = DocsConfigMapJsonPrimitive | DocsConfigMapJsonValue[] | {
@@ -200,6 +204,7 @@ interface DocsDiagnosticsFeature {
   routes?: Record<string, string | null>;
   agentEndpoint?: string | null;
   structuredAgentEndpoint?: string | null;
+  facetsEndpoint?: string | null;
   audienceParam?: string;
   defaultAudience?: "human" | "agent";
   supportedAudiences?: Array<"human" | "agent">;
@@ -210,7 +215,24 @@ interface DocsDiagnosticsFeature {
     tags: "tags";
   };
   responseFormat?: "docs-search.v1";
+  facetsResponseFormat?: "docs-search-facets.v1";
+  format?: string;
+  sinceParam?: string;
+  generationField?: string;
+  resetRequiredField?: string;
   warningsField?: "warnings";
+  /** Facet field selected for facet-value continuation. */
+  facetParam?: "facet";
+  /** Page-size parameter accepted by structured search and facet discovery. */
+  limitParam?: "limit";
+  /** Opaque continuation token accepted by structured search and facet discovery. */
+  cursorParam?: "cursor";
+  /** Optional continuation token returned when another result page is available. */
+  nextCursorField?: "nextCursor";
+  /** Boolean structured-response field indicating whether another page is available. */
+  hasMoreField?: "hasMore";
+  /** Structured-response field containing the total matches across all pages. */
+  totalField?: "total";
   provider?: string;
   mode?: string;
   transport?: "GET" | "POST" | "GET/HEAD" | "GET/POST";
@@ -236,6 +258,7 @@ interface DocsDiagnostics {
     skill: string;
     search: string | null;
     agentSearch: string | null;
+    contentChanges: string | null;
     askAi: string | null;
     mcp: string | null;
     llmsTxt: string | null;
@@ -252,6 +275,7 @@ interface DocsDiagnostics {
     diagnostics: DocsDiagnosticsFeature;
     apiCatalog: DocsDiagnosticsFeature;
     search: DocsDiagnosticsFeature;
+    contentChanges: DocsDiagnosticsFeature;
     ai: DocsDiagnosticsFeature;
     mcp: DocsDiagnosticsFeature;
     feedback: DocsDiagnosticsFeature;
@@ -336,6 +360,8 @@ interface DocsAgentDiscoverySpecOptions extends DocsDiscoveryApiRouteOptions {
   apiCatalog?: boolean;
   i18n?: ResolvedDocsI18n | null;
   search?: boolean | DocsSearchConfig;
+  /** Runtime metadata-only document synchronization feed. Defaults to enabled. */
+  contentChanges?: boolean | DocsAgentContentChangesConfig;
   mcp: DocsMcpResolvedConfig;
   feedback?: DocsAgentFeedbackDiscoveryConfig;
   llms?: DocsLlmsDiscoveryConfig;
@@ -360,6 +386,8 @@ interface DocsSkillDocumentOptions extends DocsDiscoveryApiRouteOptions {
   /** Whether this deployment actually serves the RFC 9727 API catalog. Defaults to true. */
   apiCatalog?: boolean;
   search?: boolean | DocsSearchConfig;
+  /** Runtime metadata-only document synchronization feed. Defaults to enabled. */
+  contentChanges?: boolean | DocsAgentContentChangesConfig;
   mcp: DocsMcpResolvedConfig;
   feedback?: DocsAgentFeedbackDiscoveryConfig;
   llms?: DocsLlmsDiscoveryConfig;
@@ -620,6 +648,7 @@ declare function buildDocsAgentDiscoverySpec({
   apiCatalog: explicitApiCatalog,
   i18n,
   search,
+  contentChanges,
   mcp,
   feedback,
   llms,
@@ -661,6 +690,7 @@ declare function buildDocsAgentDiscoverySpec({
     agentSkillsDiscovery: boolean;
     mcp: boolean;
     search: boolean;
+    contentChanges: boolean;
     sitemap: boolean;
     robots: boolean;
     structuredData: boolean;
@@ -670,6 +700,7 @@ declare function buildDocsAgentDiscoverySpec({
     locales: boolean;
   };
   api: {
+    contentChanges?: string | undefined;
     openapi: string;
     agentCard?: string | undefined;
     agentSkillsIndex: string;
@@ -806,6 +837,7 @@ declare function buildDocsAgentDiscoverySpec({
     endpoint: string;
     agentEndpoint: string;
     structuredAgentEndpoint: string;
+    facetsEndpoint: string;
     method: string;
     queryParam: string;
     localeParam: string;
@@ -814,7 +846,9 @@ declare function buildDocsAgentDiscoverySpec({
     supportedAudiences: string[];
     responseParam: string;
     structuredResponseValue: string;
+    facetsResponseValue: string;
     responseFormat: string;
+    facetsResponseFormat: string;
     filterParams: {
       framework: string;
       version: string;
@@ -823,6 +857,29 @@ declare function buildDocsAgentDiscoverySpec({
     };
     repeatedFilterParams: string[];
     warningsField: string;
+    facetParam: string;
+    limitParam: string;
+    cursorParam: string;
+    nextCursorField: string;
+    hasMoreField: string;
+    totalField: string;
+  };
+  contentChanges: {
+    enabled: boolean;
+    endpoint: string | null;
+    method: string;
+    audienceParam: string;
+    defaultAudience: string;
+    supportedAudiences: string[];
+    responseParam: string;
+    responseValue: string;
+    sinceParam: string;
+    format: string;
+    generationField: string;
+    resetRequiredField: string;
+    modes: string[];
+    bodyFree: boolean;
+    etag: boolean;
   };
   agents: {
     enabled: boolean;
@@ -895,6 +952,7 @@ declare function buildDocsAgentDiscoverySpec({
       listTasks?: boolean;
       readTask?: boolean;
       searchDocs: boolean;
+      searchFacets?: boolean;
       getNavigation: boolean;
       getCodeExamples: boolean;
       getConfigSchema: boolean;

package/dist/{agent-DxTa3PLB.mjs → agent-CM-hzhfh.mjs}

@@ -1,6 +1,6 @@
-import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-BHqaZx-X.mjs";
+import { B as findDocsMarkdownPage, at as renderDocsMarkdownDocument } from "./agent-Ba94vwM2.mjs";
 import { v as normalizePageAgentFrontmatter, x as stripGeneratedPageAgentContractMarkdown } from "./markdown-sections-7OoA7ylx.mjs";
-import { F as serializeGeneratedAgentDocument, M as hashGeneratedAgentContent, P as parseGeneratedAgentDocument, j as GENERATED_AGENT_PROVENANCE_VERSION } from "./search-BmC8wVr0.mjs";
+import { a as parseGeneratedAgentDocument, n as GENERATED_AGENT_PROVENANCE_VERSION, o as serializeGeneratedAgentDocument, r as hashGeneratedAgentContent } from "./agent-provenance-D8UBpnMc.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import { _ as resolveDocsContentDir, a as loadDocsConfigModule, c as loadProjectEnv, d as readNavTitle, f as readNumberProperty, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral, u as readEnvReferenceProperty } from "./config-Wcdj-D0a.mjs";
 import { createRequire } from "node:module";

package/dist/{agent-evals-21LZ_uEl.mjs → agent-evals-C8dkgJMN.mjs}

@@ -1,5 +1,5 @@
+import { An as normalizeAgentScopeValues, Dn as agentVersionConstraintsOverlap, En as agentVersionConstraintMatches, On as normalizeAgentFramework, Tn as agentVersionConstraintGroupsOverlap, Xt as buildDocsAskAIContext, jn as normalizeAgentVersion, kn as normalizeAgentLocale, ln as normalizeDocsSearchFilters, un as performDocsSearch, vn as resolveSearchRequestConfig } from "./agent-Ba94vwM2.mjs";
 import { S as upsertPageAgentContractMarkdown, l as stripDocsGeneratedAgentContractMarkers, o as findDocsMarkdownSection } from "./markdown-sections-7OoA7ylx.mjs";
-import { C as agentVersionConstraintsOverlap, D as normalizeAgentVersion, E as normalizeAgentScopeValues, S as agentVersionConstraintMatches, T as normalizeAgentLocale, b as resolveSearchRequestConfig, f as normalizeDocsSearchFilters, p as performDocsSearch, t as buildDocsAskAIContext, w as normalizeAgentFramework, x as agentVersionConstraintGroupsOverlap } from "./search-BmC8wVr0.mjs";
 import { buildDocsMcpContext } from "./mcp.mjs";
 import { i as validateCodeBlockPlans, n as planCodeBlockTargets, r as resolveDocsCodeBlocksValidateConfig, t as extractCodeBlocksFromMarkdown } from "./code-blocks-DnNVNK2M.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";

package/dist/{agent-export-3VheegEK.mjs → agent-export-DdF-IVfg.mjs}

@@ -1,14 +1,14 @@
-import { A as buildDocsAgentDiscoverySpec, Bt as renderDocsSitemapMarkdown, Ht as resolveDocsSitemapConfig, Lt as buildDocsSitemapManifest, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Vt as renderDocsSitemapXml, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsLlmsTxt, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-BHqaZx-X.mjs";
+import { A as buildDocsAgentDiscoverySpec, Ft as renderDocsSitemapXml, It as resolveDocsSitemapConfig, Pt as renderDocsSitemapMarkdown, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsLlmsTxt, jt as buildDocsSitemapManifest, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-Ba94vwM2.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
-import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BwL5ffGx.mjs";
-import "./search-BmC8wVr0.mjs";
+import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BKlEnK_H.mjs";
+import "./agent-provenance-D8UBpnMc.mjs";
 import { t as resolveDocsI18n } from "./i18n-hHVWcflJ.mjs";
-import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DaYBoy_A.mjs";
-import "./sitemap-server-B9LZQ1FE.mjs";
-import "./agent-evals-21LZ_uEl.mjs";
+import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-C_v2HK43.mjs";
+import "./sitemap-server-Dgxs9V6S.mjs";
+import "./agent-evals-C8dkgJMN.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-noFn1l_p.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
@@ -697,6 +697,7 @@ async function exportAgentBundle(options = {}) {
 		apiRoute: config?.cloud?.apiRoute,
 		apiCatalog: false,
 		search: false,
+		contentChanges: false,
 		mcp,
 		feedback,
 		llms,