@farming-labs/docs 0.2.77 → 0.2.79

package/dist/{types-B-5Kzmkn.d.mts → types-o-ULHPK6.d.mts}

@@ -825,7 +825,7 @@ interface DocsAnalyticsConfig {
 }
 type DocsTelemetryFramework = "next" | "tanstack-start" | "sveltekit" | "astro" | "nuxt" | "mcp" | (string & {});
 type DocsTelemetryEventType = "project_detected" | "agent_surface_used" | "mcp_request" | "mcp_tool_used" | (string & {});
-type DocsTelemetryAgentSurface = "agent_spec" | "agents" | "skill" | "markdown" | "llms" | "agent_feedback_schema" | "agent_feedback_submit" | "ask_ai" | "mcp";
+type DocsTelemetryAgentSurface = "agent_spec" | "agents" | "skill" | "markdown" | "llms" | "agent_feedback_schema" | "agent_feedback_submit" | "content_changes" | "ask_ai" | "mcp";
 interface DocsTelemetryConfig {
   /** Enable Farming Labs maintainer telemetry. Defaults to production-only enabled. */
   enabled?: boolean;
@@ -845,6 +845,7 @@ interface DocsTelemetryConfig {
 }
 interface DocsTelemetryFeatures {
   search: boolean;
+  contentChanges: boolean;
   ai: boolean;
   mcp: boolean;
   llmsTxt: boolean;
@@ -1201,6 +1202,13 @@ interface DocsMcpToolsConfig {
   readTask?: boolean;
   /** Expose a `search_docs` tool for keyword search over page content. */
   searchDocs?: boolean;
+  /**
+   * Expose a `list_search_facets` tool that returns valid framework, version,
+   * package, and tag values before an agent runs a scoped search.
+   */
+  searchFacets?: boolean;
+  /** Expose body-free document changes with polling through `list_content_changes`. */
+  listContentChanges?: boolean;
   /** Expose a `get_navigation` tool for the docs tree. */
   getNavigation?: boolean;
   /** Expose a `get_code_examples` tool for fenced code blocks and their metadata. */
@@ -1377,6 +1385,67 @@ interface DocsRetrievalSourceProvenance {
   digest: string;
   indexGeneration: string;
 }
+/** One canonical document in a content-change snapshot. */
+interface DocsContentSnapshotDocument {
+  /** Framework route that produced this canonical document. */
+  url: string;
+  canonicalUrl: string;
+  /** SHA-256 of the body digest plus fetch-relevant page metadata. */
+  digest: string;
+  lastModified?: string;
+}
+/**
+ * Serializable content inventory stored by the optional durable change-feed callbacks.
+ *
+ * The snapshot contains metadata only, never document bodies.
+ */
+interface DocsContentSnapshot {
+  format: "docs-content-snapshot.v1";
+  audience: "human" | "agent";
+  locale?: string;
+  baseUrl?: string;
+  indexGeneration: string;
+  documents: DocsContentSnapshotDocument[];
+}
+/** Added or removed document metadata in a content-change response. */
+type DocsContentChangeDocument = DocsContentSnapshotDocument;
+/** Changed document metadata, including the immediately compared prior digest. */
+interface DocsContentChangedDocument extends DocsContentChangeDocument {
+  previousDigest: string;
+  previousLastModified?: string;
+}
+/**
+ * Body-free synchronization response for documentation agents.
+ *
+ * `resetRequired` is explicit because a bare SHA-256 generation cannot reconstruct
+ * history that was never retained by this process or a configured durable store.
+ */
+interface DocsContentChangesResponse {
+  format: "docs-content-changes.v1";
+  audience: "human" | "agent";
+  locale?: string;
+  since: string | null;
+  indexGeneration: string;
+  mode: "snapshot" | "delta" | "reset";
+  resetRequired: boolean;
+  documentCount: number;
+  counts: {
+    added: number;
+    changed: number;
+    deleted: number;
+  };
+  added: DocsContentChangeDocument[];
+  changed: DocsContentChangedDocument[];
+  deleted: DocsContentChangeDocument[];
+}
+interface DocsContentChangeSnapshotContext {
+  audience: "human" | "agent";
+  locale?: string;
+  baseUrl?: string;
+  request?: Request;
+}
+type DocsContentChangeSnapshotLoader = (generation: string, context: DocsContentChangeSnapshotContext) => DocsContentSnapshot | null | undefined | Promise<DocsContentSnapshot | null | undefined>;
+type DocsContentChangeSnapshotSaver = (snapshot: DocsContentSnapshot, context: DocsContentChangeSnapshotContext) => void | Promise<void>;
 interface DocsSearchDocument {
   id: string;
   url: string;
@@ -1418,6 +1487,40 @@ interface DocsSearchFilters {
   package?: string[];
   tags?: string[];
 }
+/** One selectable search-scope value and the number of matching source pages. */
+interface DocsSearchFacetValue {
+  value: string;
+  count: number;
+}
+/** Cursor-aware values for one search-scope field. */
+interface DocsSearchFacet {
+  /** Number of distinct values before the response limit is applied. */
+  valueCount: number;
+  /** Total number of distinct values. Alias of `valueCount` for pagination clients. */
+  total: number;
+  /** Whether another page can be requested with `nextCursor`. */
+  hasMore: boolean;
+  /** Opaque cursor for the next page. Omitted when this is the final page. */
+  nextCursor?: string;
+  /** Whether this page omits any values from the complete facet. */
+  truncated: boolean;
+  values: DocsSearchFacetValue[];
+}
+/**
+ * Cheap, body-free discovery response for the search scopes available in an index.
+ *
+ * Counts for each facet apply the other selected filters but intentionally ignore
+ * the selected values for that same field, so agents can discover alternatives.
+ */
+interface DocsSearchFacetsResponse {
+  format: "docs-search-facets.v1";
+  audience: "human" | "agent";
+  filters: DocsSearchFilters;
+  indexGeneration: string;
+  /** Number of source pages matching every selected filter. */
+  matchedPageCount: number;
+  facets: Record<DocsSearchFilterField, DocsSearchFacet>;
+}
 type DocsSearchWarningCode = "ambiguous_scope" | "unknown_filter_value" | "missing_scope_metadata" | "conflicting_scope_metadata";
 interface DocsSearchWarning {
   code: DocsSearchWarningCode;
@@ -1468,9 +1571,13 @@ interface DocsPaginatedSearchResponse extends DocsSearchResponse {
 interface DocsSearchRequest {
   filters: DocsSearchFilters;
   structured: boolean;
-  /** Opaque cursor supplied by a previous structured response. */
+  /** Whether the caller requested the body-free search facet response. */
+  facets?: boolean;
+  /** Facet field selected for cursor continuation. */
+  facet?: DocsSearchFilterField;
+  /** Opaque cursor supplied by a previous structured or facet response. */
   cursor?: string;
-  /** Structured response page size. */
+  /** Structured result or facet value page size. */
   limit?: number;
 }
 interface DocsSearchQuery {
@@ -2954,9 +3061,25 @@ interface DocsAgentConfig {
   evaluations?: boolean | DocsAgentEvaluationsConfig;
   /** Publish reusable Agent Skills through standards discovery, static exports, and MCP. */
   skills?: DocsAgentSkillsInput;
+  /**
+   * Body-free document synchronization feed. Enabled for runtime adapters by default.
+   *
+   * Configure snapshot callbacks when exact deltas must survive server restarts or deployments.
+   */
+  contentChanges?: boolean | DocsAgentContentChangesConfig;
   /** Opt in to an A2A Agent Card for a separately implemented A2A service. */
   a2a?: DocsAgentA2AConfig;
 }
+interface DocsAgentContentChangesConfig {
+  /** Disable the runtime content-change endpoint. @default true */
+  enabled?: boolean;
+  /** Number of metadata-only snapshots retained in this server process. @default 8 */
+  maxSnapshots?: number;
+  /** Load an older snapshot from a durable store for exact cross-deployment deltas. */
+  loadSnapshot?: DocsContentChangeSnapshotLoader;
+  /** Persist the current snapshot to a durable store. */
+  saveSnapshot?: DocsContentChangeSnapshotSaver;
+}
 type DocsReviewSeverity = "off" | "suggestion" | "warn" | "error";
 type DocsReviewCiMode = "off" | "warn" | "block";
 interface DocsReviewRulesConfig {
@@ -3685,4 +3808,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-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 };
+export { DocsAgentSkillsConfig as $, LlmsTxtMaxCharsMode as $n, DocsMetadata as $t, DocsAgentA2ASecurityScheme as A, DocsSearchQuery as An, SimpleDocsSearchConfig as Ar, DocsConfig as At, DocsAgentEvaluationAnswerRunner as B, DocsTelemetryConfig as Bn, DocsFeedbackValue as Bt, DocsAgentA2AOAuthDeviceCodeFlow as C, DocsSearchEmbeddingsConfig as Cn, SidebarComponentProps as Cr, DocsCodeBlocksPlannerConfig as Ct, DocsAgentA2AOpenIdConnectSecurityScheme as D, DocsSearchFilterField as Dn, SidebarNode as Dr, DocsCodeBlocksValidateConfig as Dt, DocsAgentA2AOAuthPasswordFlow as E, DocsSearchFacetsResponse as En, SidebarFolderNode as Er, DocsCodeBlocksRunnerProvider as Et, DocsAgentContentChangesConfig as F, DocsSearchSourcePage as Fn, DocsContentChangedDocument as Ft, DocsAgentFeedbackContext as G, DocsTelemetryFramework as Gn, DocsMcpAuthenticateContext as Gt, DocsAgentEvaluationSurface as H, DocsTelemetryEventInput as Hn, DocsMcpAllowedOrigins as Ht, DocsAgentEvaluationAnswerInput as I, DocsSearchWarning as In, DocsContentChangesResponse as It, DocsAgentGoldenExampleVerification as J, FontStyle as Jn, DocsMcpCorsConfig as Jt, DocsAgentFeedbackData as K, DocsTheme as Kn, DocsMcpAuthenticateResult as Kt, DocsAgentEvaluationAnswerProvider as L, DocsSearchWarningCode as Ln, DocsContentSnapshot as Lt, DocsAgentA2ASkill as M, DocsSearchResponse as Mn, TypesenseDocsSearchConfig as Mr, DocsContentChangeSnapshotContext as Mt, DocsAgentCompactConfig as N, DocsSearchResult as Nn, TypographyConfig as Nr, DocsContentChangeSnapshotLoader as Nt, DocsAgentA2AProtocolBinding as O, DocsSearchFilterInput as On, SidebarPageNode as Or, DocsCodeBlocksValidationMode as Ot, DocsAgentConfig as P, DocsSearchResultType as Pn, UIConfig as Pr, DocsContentChangeSnapshotSaver as Pt, DocsAgentGoldenTaskFilters as Q, LlmsTxtMaxCharsConfig as Qn, DocsMcpToolsConfig as Qt, DocsAgentEvaluationAnswerRequest as R, DocsSitemapConfig as Rn, DocsContentSnapshotDocument as Rt, DocsAgentA2AOAuthClientCredentialsFlow as S, DocsSearchDocument as Sn, ResolvedDocsRelatedLink as Sr, DocsCodeBlocksConfig as St, DocsAgentA2AOAuthImplicitFlow as T, DocsSearchFacetValue as Tn, SidebarFolderIndexBehavior as Tr, DocsCodeBlocksRunnerConfig as Tt, DocsAgentEvaluationTaskInput as U, DocsTelemetryEventType as Un, DocsMcpAuthPrincipal as Ut, DocsAgentEvaluationSourceReference as V, DocsTelemetryEvent as Vn, DocsI18nConfig as Vt, DocsAgentEvaluationsConfig as W, DocsTelemetryFeatures as Wn, DocsMcpAuthenticate as Wt, DocsAgentGoldenTask as X, LastUpdatedConfig as Xn, DocsMcpProtectedResourceConfig as Xt, DocsAgentGoldenExpectedExample as Y, GithubConfig as Yn, DocsMcpOriginContext as Yt, DocsAgentGoldenTaskExpectation as Z, LlmsTxtConfig as Zn, DocsMcpSecurityConfig as Zt, DocsAgentA2AHttpAuthSecurityScheme as _, DocsSearchAdapterContext as _n, PageOpenGraph as _r, DocsCloudApiKeyConfig as _t, ApiReferenceRenderer as a, DocsRelatedItem as an, OpenDocsProviderConfig as ar, DocsAnalyticsEvent as at, DocsAgentA2AOAuth2SecurityScheme as b, DocsSearchChunkingConfig as bn, ReadingTimeConfig as br, DocsCloudPreviewConfig as bt, ChangelogFrontmatter as c, DocsReviewCiConfig as cn, OpenGraphImage as cr, DocsAnalyticsInput as ct, CopyMarkdownFormat as d, DocsReviewRulesConfig as dn, PageAgentAppliesTo as dr, DocsAskAIActionType as dt, DocsNav as en, LlmsTxtSectionConfig as er, DocsAgentSkillsInput as et, CustomDocsSearchConfig as f, DocsReviewScoreConfig as fn, PageAgentCommand as fr, DocsAskAIFeedbackConfig as ft, DocsAgentA2AExtension as g, DocsSearchAdapter as gn, PageFrontmatter as gr, DocsAskAIMcpConfig as gt, DocsAgentA2AConfig as h, DocsRobotsRule as hn, PageAgentVerification as hr, DocsAskAIFeedbackValue as ht, ApiReferenceConfig as i, DocsPaginatedSearchResponse as in, OpenDocsProvider as ir, DocsAnalyticsConfig as it, DocsAgentA2ASecurityScopeList as j, DocsSearchRequest as jn, ThemeToggleConfig as jr, DocsContentChangeDocument as jt, DocsAgentA2ASecurityRequirement as k, DocsSearchFilters as kn, SidebarTree as kr, DocsCodeBlocksValidationPolicy as kt, CodeBlockCopyData as l, DocsReviewCiMode as ln, OrderingItem as lr, DocsAnalyticsSource as lt, DocsAgentA2ACapabilities as m, DocsRobotsConfig as mn, PageAgentFrontmatter as mr, DocsAskAIFeedbackMessage as mt, AgentFeedbackConfig as n, DocsObservabilityEvent as nn, OGConfig as nr, DocsAgentTraceEventType as nt, BreadcrumbConfig as o, DocsRetrievalSourceProvenance as on, OpenDocsProviderId as or, DocsAnalyticsEventInput as ot, DocsAgentA2AApiKeySecurityScheme as p, DocsReviewSeverity as pn, PageAgentFailureMode as pr, DocsAskAIFeedbackData as pt, DocsAgentGoldenAnswerExpectation as q, FeedbackConfig as qn, DocsMcpConfig as qt, AlgoliaDocsSearchConfig as r, DocsObservabilityEventInput as rn, OpenDocsConfig as rr, DocsAgentTraceStatus as rt, ChangelogConfig as s, DocsRetrievalSourceScope as sn, OpenDocsTarget as sr, DocsAnalyticsEventType as st, AIConfig as t, DocsObservabilityConfig as tn, McpDocsSearchConfig as tr, DocsAgentTraceEventInput as tt, CopyMarkdownConfig as u, DocsReviewConfig as un, PageActionsConfig as ur, DocsAskAIActionData as ut, DocsAgentA2AInterfaceConfig as v, DocsSearchAdapterFactory as vn, PageSidebarFrontmatter as vr, DocsCloudConfig as vt, DocsAgentA2AOAuthFlows as w, DocsSearchFacet as wn, SidebarConfig as wr, DocsCodeBlocksPlannerProvider as wt, DocsAgentA2AOAuthAuthorizationCodeFlow as x, DocsSearchConfig as xn, ReadingTimeFormat as xr, DocsCloudPublishConfig as xt, DocsAgentA2AMutualTlsSecurityScheme as y, DocsSearchAdapterPage as yn, PageTwitter as yr, DocsCloudFeatureConfig as yt, DocsAgentEvaluationAnswerResult as z, DocsTelemetryAgentSurface as zn, DocsFeedbackData as zt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.77",
+  "version": "0.2.79",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -9,6 +9,9 @@
   ],
   "license": "MIT",
   "author": "Farming Labs",
+  "engines": {
+    "node": ">=20"
+  },
   "bin": {
     "docs": "./dist/cli/index.mjs"
   },
@@ -69,7 +72,7 @@
   "dependencies": {
     "@clack/prompts": "^0.9.1",
     "@mdx-js/mdx": "^3.1.1",
-    "@modelcontextprotocol/sdk": "1.29.0",
+    "@modelcontextprotocol/server": "2.0.0",
     "@scalar/core": "^0.4.3",
     "@vercel/sandbox": "^2.0.0",
     "github-slugger": "^2.0.0",
@@ -90,6 +93,7 @@
     }
   },
   "devDependencies": {
+    "@modelcontextprotocol/client": "2.0.0",
     "@types/node": "^22.10.0",
     "@types/react": "^19.2.2",
     "ajv": "^8.18.0",

package/dist/retrieval-digest-rponR4jM.d.mts

@@ -1,332 +0,0 @@
-import { Cn as DocsSearchSourcePage, En as DocsSitemapConfig, Jt as DocsObservabilityEventInput, Kn as OpenDocsProvider, Kt as DocsObservabilityConfig, Un as McpDocsSearchConfig, Yn as OpenDocsTarget, Yt as DocsPaginatedSearchResponse, _n as DocsSearchFilters, at as DocsAnalyticsEventInput, br as TypesenseDocsSearchConfig, dn as DocsSearchChunkingConfig, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, fn as DocsSearchConfig, gn as DocsSearchFilterInput, ht as DocsAskAIMcpConfig, it as DocsAnalyticsEvent, ln as DocsSearchAdapterFactory, pn as DocsSearchDocument, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, sn as DocsSearchAdapter, ur as ResolvedDocsRelatedLink, xn as DocsSearchResult, yn as DocsSearchRequest } from "./types-B-5Kzmkn.mjs";
-import { R as DocsDiscoveryApiRouteOptions } from "./standards-discovery-BbslY4id.mjs";
-import { pn as DocsContentAudience } from "./agent-DRKj42ht.mjs";
-
-//#region src/analytics.d.ts
-declare const DOCS_AGENT_TRACE_EVENT_TYPES: readonly ["run.start", "run.end", "run.error", "user.input", "prompt.build", "retrieval.query", "retrieval.result", "retrieval.error", "model.call", "model.response", "model.stream", "model.error", "tool.call", "tool.result", "tool.error", "retry", "timeout", "error", "agent.final"];
-interface DocsAgentTraceContext {
-  traceId: string;
-  name: string;
-  startedAt: string;
-  startedMs: number;
-}
-interface ResolvedDocsAnalyticsConfig {
-  enabled: boolean;
-  console: false | "log" | "info" | "debug";
-  includeInputs: boolean;
-  onEvent?: (event: DocsAnalyticsEvent) => void | Promise<void>;
-}
-interface ResolvedDocsObservabilityConfig {
-  enabled: boolean;
-  console: false | "log" | "info" | "debug";
-  includeInputs: boolean;
-  onEvent?: (event: DocsObservabilityEvent) => void | Promise<void>;
-}
-declare function createDocsAgentTraceId(prefix?: string): string;
-declare function createDocsAgentTraceContext(name?: string): DocsAgentTraceContext;
-declare function getDocsRequestAnalyticsProperties(request: Request): Record<string, unknown>;
-declare function resolveDocsAnalyticsConfig(analytics?: boolean | DocsAnalyticsConfig): ResolvedDocsAnalyticsConfig;
-declare function resolveDocsObservabilityConfig(observability?: boolean | DocsObservabilityConfig): ResolvedDocsObservabilityConfig;
-declare function emitDocsAnalyticsEvent(analytics: boolean | DocsAnalyticsConfig | undefined, event: DocsAnalyticsEventInput): Promise<void>;
-declare function emitDocsObservabilityEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsObservabilityEventInput): Promise<void>;
-declare function emitDocsAgentTraceEvent(observability: boolean | DocsObservabilityConfig | undefined, event: DocsAgentTraceEventInput): Promise<void>;
-//#endregion
-//#region src/prompt-utils.d.ts
-type PromptAction = "copy" | "open";
-interface SerializedOpenDocsProvider {
-  name: string;
-  iconHtml?: string;
-  urlTemplate: string;
-  promptUrlTemplate?: string;
-  target?: OpenDocsTarget;
-  prompt?: string;
-}
-interface PromptProviderChoice {
-  name: string;
-  iconHtml?: string;
-  urlTemplate: string;
-}
-type PromptProviderInput = Pick<SerializedOpenDocsProvider, "name" | "iconHtml"> & Partial<Pick<SerializedOpenDocsProvider, "promptUrlTemplate" | "urlTemplate">>;
-interface SerializeOpenDocsProviderOptions {
-  target?: OpenDocsTarget;
-  prompt?: string;
-}
-declare const DEFAULT_PROMPT_PROVIDER_TEMPLATES: Record<string, string>;
-declare const DEFAULT_OPEN_DOCS_TARGET: OpenDocsTarget;
-declare const DEFAULT_OPEN_DOCS_PROMPT = "Read this documentation: {url}";
-declare const DEFAULT_OPEN_DOCS_PROVIDER_IDS: readonly ["chatgpt", "claude"];
-declare function normalizePromptProviderName(name: string): string;
-declare function serializeDocsIcon(icon: unknown): string | undefined;
-declare function serializeDocsIconRegistry(icons?: Record<string, unknown>): Record<string, string> | undefined;
-declare function serializeOpenDocsProviders(providers?: OpenDocsProvider[], options?: SerializeOpenDocsProviderOptions): SerializedOpenDocsProvider[] | undefined;
-declare function serializeOpenDocsProvider(provider: OpenDocsProvider, options?: SerializeOpenDocsProviderOptions): SerializedOpenDocsProvider | undefined;
-declare function parsePromptStringArray(value: unknown): string[] | undefined;
-declare function resolvePromptProviderChoices(availableProviders?: PromptProviderInput[], preferredNames?: string[]): PromptProviderChoice[];
-declare function sanitizePromptText(text: string): string;
-//#endregion
-//#region src/sitemap.d.ts
-declare const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
-declare const DEFAULT_SITEMAP_MD_ROUTE = "/sitemap.md";
-declare const DEFAULT_SITEMAP_MD_DOCS_ROUTE = "/docs/sitemap.md";
-declare const DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE = "/.well-known/sitemap.md";
-declare const DEFAULT_SITEMAP_MANIFEST_PATH = ".farming-labs/sitemap-manifest.json";
-type DocsSitemapFormat = "xml" | "markdown";
-interface DocsSitemapPageInput {
-  slug?: string;
-  url: string;
-  /** Override the public Markdown representation URL when it differs from `${url}.md`. */
-  markdownUrl?: string;
-  title: string;
-  description?: string;
-  related?: ResolvedDocsRelatedLink[];
-  sourcePath?: string;
-  lastmod?: string;
-  lastModified?: string;
-}
-interface DocsSitemapManifestPage {
-  url: string;
-  absoluteUrl?: string;
-  markdownUrl: string;
-  title: string;
-  description?: string;
-  sourcePath?: string;
-  lastmod?: string;
-  lastmodSource?: "git" | "filesystem" | "frontmatter" | "manifest" | "unknown";
-  related?: string[];
-}
-interface DocsSitemapManifest {
-  version: 1;
-  generatedAt: string;
-  baseUrl?: string;
-  entry: string;
-  siteTitle?: string;
-  pages: DocsSitemapManifestPage[];
-}
-interface DocsSitemapResolvedConfig {
-  enabled: boolean;
-  routePrefix: string;
-  baseUrl?: string;
-  manifestPath: string;
-  xml: {
-    enabled: boolean;
-    includeLastmod: boolean;
-    route: string;
-  };
-  markdown: {
-    enabled: boolean;
-    includeDescriptions: boolean;
-    includeLastmod: boolean;
-    linkTarget: "html" | "markdown" | "both";
-    route: string;
-    docsRoute?: string;
-    wellKnownRoute: string;
-  };
-}
-interface CreateDocsSitemapResponseOptions extends DocsDiscoveryApiRouteOptions {
-  request: Request;
-  sitemap?: boolean | DocsSitemapConfig;
-  entry?: string;
-  siteTitle?: string;
-  baseUrl?: string;
-  pages: DocsSitemapPageInput[];
-  manifest?: DocsSitemapManifest | null;
-}
-declare function resolveDocsSitemapConfig(sitemap?: boolean | DocsSitemapConfig, defaults?: {
-  baseUrl?: string;
-}): DocsSitemapResolvedConfig;
-declare function resolveDocsSitemapRequest(url: URL, sitemap?: boolean | DocsSitemapConfig, options?: DocsDiscoveryApiRouteOptions): DocsSitemapFormat | null;
-declare function toDocsSitemapMarkdownUrl(url: string): string;
-declare function buildDocsSitemapManifest(options: {
-  pages: DocsSitemapPageInput[];
-  entry?: string;
-  siteTitle?: string;
-  baseUrl?: string;
-  generatedAt?: string;
-  resolveLastmod?: (page: DocsSitemapPageInput) => {
-    lastmod?: string;
-    lastmodSource?: DocsSitemapManifestPage["lastmodSource"];
-  } | undefined;
-}): DocsSitemapManifest;
-declare function renderDocsSitemapXml(manifest: DocsSitemapManifest, options?: {
-  baseUrl?: string;
-  includeLastmod?: boolean;
-}): string;
-declare function renderDocsSitemapMarkdown(manifest: DocsSitemapManifest, options?: {
-  baseUrl?: string;
-  includeDescriptions?: boolean;
-  includeLastmod?: boolean;
-  linkTarget?: "html" | "markdown" | "both";
-}): string;
-declare function readDocsSitemapManifestFromContentMap(contentMap?: Record<string, string> | null): DocsSitemapManifest | null;
-declare function resolveDocsSitemapPageLastmod(manifest: DocsSitemapManifest | null | undefined, url: string): string | undefined;
-declare function createDocsSitemapResponse({
-  request,
-  apiRoute,
-  sitemap,
-  entry,
-  siteTitle,
-  baseUrl,
-  pages,
-  manifest
-}: CreateDocsSitemapResponseOptions): Response | null;
-//#endregion
-//#region src/search.d.ts
-interface DocsAskAIContextResult extends DocsSearchResult {
-  title: string;
-  contextContent: string;
-}
-interface DocsAskAIContext {
-  context: string;
-  /** Structured production context blocks; avoids reparsing markdown horizontal rules. */
-  blocks: Array<{
-    text: string;
-    result: DocsAskAIContextResult;
-  }>;
-  results: DocsAskAIContextResult[];
-  searchResults: DocsSearchResult[];
-  packageHints: DocsAskAIPackageHints;
-}
-interface DocsAskAIPackageHints {
-  packages: string[];
-  imports: string[];
-  installCommands: string[];
-}
-/** Normalize scalar or array-valued scope filters for programmatic, HTTP, and MCP callers. */
-declare function normalizeDocsSearchFilters(input?: DocsSearchFilterInput | DocsSearchFilters): DocsSearchFilters;
-/** Parse the public search scope parameters from a URL query string. */
-declare function resolveDocsSearchFilters(searchParams: URLSearchParams): DocsSearchFilters;
-declare class DocsSearchRequestError extends Error {
-  readonly code = "invalid_search_request";
-  constructor(message: string);
-}
-declare function resolveDocsSearchError(error: unknown): {
-  code: "invalid_cursor" | "invalid_search_request";
-  message: string;
-} | undefined;
-/** Resolve search filters and the backwards-compatible structured response opt-in. */
-declare function resolveDocsSearchRequest(searchParams: URLSearchParams): DocsSearchRequest;
-declare function inferDocsAskAIPackageHints(content: string): DocsAskAIPackageHints;
-declare function formatDocsAskAIPackageHints(hints: DocsAskAIPackageHints, packageName?: string): string | undefined;
-/**
- * Build the exact normalized-input projection represented by a retrieval source digest.
- * This is public so consumers can independently reproduce `source.digest`.
- */
-declare function buildDocsRetrievalDigestProjection(page: DocsSearchSourcePage, audience?: DocsContentAudience): string;
-declare function resolveDocsRetrievalLastModified(page: DocsSearchSourcePage, audience: DocsContentAudience): string | undefined;
-interface EnrichDocsSearchDocumentsWithProvenanceOptions {
-  documents: readonly DocsSearchDocument[];
-  pages: readonly DocsSearchSourcePage[];
-  audience?: DocsContentAudience;
-  chunking?: DocsSearchChunkingConfig;
-  locale?: string;
-  baseUrl?: string;
-  indexGeneration?: string;
-}
-/**
- * Attach the same canonical provenance used by built-in search providers.
- * Custom adapters can call this before persisting their own hosted records.
- */
-declare function enrichDocsSearchDocumentsWithProvenance(options: EnrichDocsSearchDocumentsWithProvenanceOptions): Promise<DocsSearchDocument[]>;
-declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig, audience?: DocsContentAudience): DocsSearchDocument[];
-declare function createSimpleSearchAdapter(): DocsSearchAdapter;
-declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
-declare function resolveSearchRequestConfig(search: boolean | DocsSearchConfig | undefined, requestUrl?: string): boolean | DocsSearchConfig | undefined;
-/**
- * Resolve the public search audience without allowing malformed values to opt into agent content.
- * Human search remains the default for omitted, legacy, and unknown query values.
- */
-declare function resolveDocsSearchAudience(value: string | null | undefined): DocsContentAudience;
-declare function resolveAskAISearchRequestConfig(options: {
-  search: boolean | DocsSearchConfig | undefined;
-  useMcp?: boolean | DocsAskAIMcpConfig;
-  mcpEndpoint?: string;
-  mcpEnabled?: boolean;
-  mcpSearchEnabled?: boolean;
-  requestUrl?: string;
-}): boolean | DocsSearchConfig | undefined;
-declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearchAdapter;
-declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
-interface PerformDocsSearchOptions {
-  pages: DocsSearchSourcePage[];
-  /** @internal Complete corpus used for generation when `pages` is pre-scoped by a caller. */
-  generationPages?: DocsSearchSourcePage[];
-  /** @internal Precomputed complete-corpus generation for structured callers. */
-  indexGeneration?: string;
-  query: string;
-  search?: boolean | DocsSearchConfig;
-  /** Selects which audience projection is searchable. Public site search defaults to human. */
-  audience?: DocsContentAudience;
-  locale?: string;
-  pathname?: string;
-  siteTitle?: string;
-  /** Canonical docs URL used to distinguish same-site absolute hits from foreign MCP results. */
-  baseUrl?: string;
-  /**
-   * Canonical origin safe to persist in a hosted index. Pass `null` when `baseUrl`
-   * came from the current request rather than trusted configuration.
-   * @internal
-   */
-  syncBaseUrl?: string | null;
-  limit?: number;
-  /** Opaque continuation cursor used by structured search responses. */
-  cursor?: string;
-  /** Optional framework, version, package, and tag constraints. */
-  filters?: DocsSearchFilterInput;
-  /**
-   * Controls provider failures. Runtime search keeps the resilient `fallback` default;
-   * diagnostics can request `throw` so a broken configured provider cannot be scored as
-   * successful simple search.
-   */
-  failureMode?: "fallback" | "throw";
-  /**
-   * Whether non-simple provider hits are supplemented with exact/local simple results.
-   * Runtime search defaults to true; provider diagnostics can disable supplementation.
-   */
-  supplementExternalResults?: boolean;
-  /** Keep absolute provider origins distinct when no canonical docs origin is available. */
-  strictExternalOrigins?: boolean;
-  /** Optional cancellation signal forwarded to adapters and their managed requests. */
-  signal?: AbortSignal;
-}
-declare function performDocsSearch(options: PerformDocsSearchOptions): Promise<DocsSearchResult[]>;
-declare function performDocsSearchWithMetadata(options: PerformDocsSearchOptions): Promise<DocsPaginatedSearchResponse>;
-declare function buildDocsAskAIContext(options: {
-  pages: DocsSearchSourcePage[];
-  query: string;
-  search?: boolean | DocsSearchConfig;
-  locale?: string;
-  pathname?: string;
-  siteTitle?: string;
-  baseUrl?: string; /** See `performDocsSearch.syncBaseUrl`. */
-  syncBaseUrl?: string | null;
-  limit?: number;
-  filters?: DocsSearchFilterInput;
-  maxContextChars?: number;
-  maxResultChars?: number; /** See `performDocsSearch.failureMode`. Defaults to resilient runtime fallback. */
-  searchFailureMode?: "fallback" | "throw"; /** See `performDocsSearch.strictExternalOrigins`. */
-  strictExternalOrigins?: boolean; /** Optional cancellation signal forwarded to the configured search provider. */
-  signal?: AbortSignal;
-}): Promise<DocsAskAIContext>;
-declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory, options?: {
-  paginationRevision?: string;
-}): CustomDocsSearchConfig;
-//#endregion
-//#region src/pagination.d.ts
-declare class DocsPaginationCursorError extends Error {
-  readonly code = "invalid_cursor";
-  constructor();
-}
-//#endregion
-//#region src/retrieval-digest.d.ts
-/** Validate the bounded HTTP(S) URL or root-relative URI reference used by provenance. */
-declare function isDocsRetrievalCanonicalUrl(value: string): boolean;
-/**
- * Hash a retrieval source projection with portable SHA-256.
- *
- * The projection is normalized by removing one leading BOM, converting CRLF/CR
- * line endings to LF, and trimming trailing whitespace. The helper is exported so
- * agents can independently verify provenance in Node, edge, and browser runtimes.
- */
-declare function digestDocsRetrievalContent(value: string): `sha256:${string}`;
-//#endregion
-export { SerializeOpenDocsProviderOptions as $, DEFAULT_SITEMAP_MD_ROUTE as A, readDocsSitemapManifestFromContentMap as B, resolveDocsSearchAudience as C, resolveSearchRequestConfig as D, resolveDocsSearchRequest as E, DocsSitemapManifestPage as F, resolveDocsSitemapRequest as G, renderDocsSitemapXml as H, DocsSitemapPageInput as I, DEFAULT_OPEN_DOCS_PROVIDER_IDS as J, toDocsSitemapMarkdownUrl as K, DocsSitemapResolvedConfig as L, DEFAULT_SITEMAP_XML_ROUTE as M, DocsSitemapFormat as N, DEFAULT_SITEMAP_MANIFEST_PATH as O, DocsSitemapManifest as P, PromptProviderChoice as Q, buildDocsSitemapManifest as R, resolveDocsRetrievalLastModified as S, resolveDocsSearchFilters as T, resolveDocsSitemapConfig as U, renderDocsSitemapMarkdown as V, resolveDocsSitemapPageLastmod as W, DEFAULT_PROMPT_PROVIDER_TEMPLATES as X, DEFAULT_OPEN_DOCS_TARGET as Y, PromptAction as Z, inferDocsAskAIPackageHints as _, emitDocsObservabilityEvent as _t, EnrichDocsSearchDocumentsWithProvenanceOptions as a, serializeDocsIcon as at, performDocsSearchWithMetadata as b, resolveDocsObservabilityConfig as bt, buildDocsRetrievalDigestProjection as c, serializeOpenDocsProviders as ct, createCustomSearchAdapter as d, ResolvedDocsAnalyticsConfig as dt, SerializedOpenDocsProvider as et, createMcpSearchAdapter as f, ResolvedDocsObservabilityConfig as ft, formatDocsAskAIPackageHints as g, emitDocsAnalyticsEvent as gt, enrichDocsSearchDocumentsWithProvenance as h, emitDocsAgentTraceEvent as ht, DocsSearchRequestError as i, sanitizePromptText as it, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as j, DEFAULT_SITEMAP_MD_DOCS_ROUTE as k, buildDocsSearchDocuments as l, DOCS_AGENT_TRACE_EVENT_TYPES as lt, createTypesenseSearchAdapter as m, createDocsAgentTraceId as mt, isDocsRetrievalCanonicalUrl as n, parsePromptStringArray as nt, PerformDocsSearchOptions as o, serializeDocsIconRegistry as ot, createSimpleSearchAdapter as p, createDocsAgentTraceContext as pt, DEFAULT_OPEN_DOCS_PROMPT as q, DocsPaginationCursorError as r, resolvePromptProviderChoices as rt, buildDocsAskAIContext as s, serializeOpenDocsProvider as st, digestDocsRetrievalContent as t, normalizePromptProviderName as tt, createAlgoliaSearchAdapter as u, DocsAgentTraceContext as ut, normalizeDocsSearchFilters as v, getDocsRequestAnalyticsProperties as vt, resolveDocsSearchError as w, resolveAskAISearchRequestConfig as x, performDocsSearch as y, resolveDocsAnalyticsConfig as yt, createDocsSitemapResponse as z };