@farming-labs/docs 0.2.73 → 0.2.75

package/dist/{search-D1n8Sf25.d.mts → retrieval-digest-CFOcSKTo.d.mts}

@@ -1,5 +1,6 @@
-import { Gn as OpenDocsTarget, Hn as OpenDocsProvider, Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Sn as DocsSitemapConfig, _n as DocsSearchResult, at as DocsAnalyticsEventInput, cn as DocsSearchConfig, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, fn as DocsSearchFilterInput, gn as DocsSearchResponse, gr as TypesenseDocsSearchConfig, hn as DocsSearchRequest, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, ln as DocsSearchDocument, on as DocsSearchAdapterFactory, or as ResolvedDocsRelatedLink, pn as DocsSearchFilters, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, sn as DocsSearchChunkingConfig, yn as DocsSearchSourcePage, zn as McpDocsSearchConfig } from "./types-_HCPD4wc.mjs";
-import { I as DocsDiscoveryApiRouteOptions } from "./standards-discovery-83lp1lew.mjs";
+import { Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Vn as McpDocsSearchConfig, Wn as OpenDocsProvider, _n as DocsSearchRequest, at as DocsAnalyticsEventInput, cn as DocsSearchAdapterFactory, cr as ResolvedDocsRelatedLink, dn as DocsSearchDocument, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, hn as DocsSearchFilters, ht as DocsAskAIMcpConfig, it as DocsAnalyticsEvent, ln as DocsSearchChunkingConfig, mn as DocsSearchFilterInput, on as DocsSearchAdapter, qn as OpenDocsTarget, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, un as DocsSearchConfig, vn as DocsSearchResponse, vr as TypesenseDocsSearchConfig, wn as DocsSitemapConfig, xn as DocsSearchSourcePage, yn as DocsSearchResult } from "./types-BDRwrExu.mjs";
+import { I as DocsDiscoveryApiRouteOptions } from "./standards-discovery-DBI1PD7m.mjs";
+import { pn as DocsContentAudience } from "./agent-cAPjC2jb.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"];
@@ -30,51 +31,6 @@ declare function emitDocsAnalyticsEvent(analytics: boolean | DocsAnalyticsConfig
 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/audience.d.ts
-/** The two content projections emitted by the docs framework. */
-type DocsContentAudience = "human" | "agent";
-/** Resolve whether content with an optional audience restriction is visible. */
-declare function resolveDocsAudienceExposure(only: unknown, audience: DocsContentAudience): boolean;
-interface DocsMarkdownPromptBlock {
-  /** Raw JSX attributes between the Prompt name and opening bracket. */
-  attributes: string;
-  /** Literal source between the Prompt tags, with enclosing Markdown container prefixes removed. */
-  children: string;
-  /** Collision-safe placeholder carried through document-level rendering. */
-  token: string;
-}
-interface ExtractedDocsMarkdownPromptBlocks {
-  blocks: DocsMarkdownPromptBlock[];
-  markdown: string;
-}
-interface DocsAudienceMdxIssue {
-  code: "missing-only" | "invalid-only" | "dynamic-only" | "ignored-agent-only" | "ignored-human-only";
-  index: number;
-  message: string;
-}
-/**
- * Extract live MDX Prompt blocks while leaving Markdown literals untouched.
- *
- * Prompt bodies are copyable source, so callers can safely run audience,
- * reference-definition, and heading passes over `markdown`, then restore each
- * block from its token. Fences (including container fences), inline code, links,
- * comments, raw elements, and other literal contexts are never extracted.
- */
-declare function extractDocsMarkdownPromptBlocks(content: string): ExtractedDocsMarkdownPromptBlocks;
-/** Find audience declarations that cannot be projected consistently at build time. */
-declare function findDocsAudienceMdxIssues(content: string): DocsAudienceMdxIssue[];
-/**
- * Resolve MDX into its human or agent projection.
- *
- * `<Agent>` is shorthand for `<Audience only="agent">`, while `<Human>` is
- * shorthand for `<Audience only="human">`. Unknown `Audience.only` values are
- * treated as shared content so an authoring typo never silently deletes content.
- * These primitives shape content for each surface; they are not an access-control boundary.
- */
-declare function resolveDocsAudienceMdxContent(content: string, audience: DocsContentAudience): string;
-/** Backwards-compatible name retained for existing integrations. */
-declare function resolveDocsAgentMdxContent(content: string, audience: DocsContentAudience): string;
-//#endregion
 //#region src/prompt-utils.d.ts
 type PromptAction = "copy" | "open";
 interface SerializedOpenDocsProvider {
@@ -243,6 +199,26 @@ declare function resolveDocsSearchFilters(searchParams: URLSearchParams): DocsSe
 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;
@@ -264,6 +240,10 @@ declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearch
 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. */
@@ -273,6 +253,12 @@ interface PerformDocsSearchOptions {
   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;
   /** Optional framework, version, package, and tag constraints. */
   filters?: DocsSearchFilterInput;
@@ -287,7 +273,7 @@ interface PerformDocsSearchOptions {
    * Runtime search defaults to true; provider diagnostics can disable supplementation.
    */
   supplementExternalResults?: boolean;
-  /** Fail closed on absolute provider hits when no canonical docs origin is available. */
+  /** 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;
@@ -301,7 +287,8 @@ declare function buildDocsAskAIContext(options: {
   locale?: string;
   pathname?: string;
   siteTitle?: string;
-  baseUrl?: string;
+  baseUrl?: string; /** See `performDocsSearch.syncBaseUrl`. */
+  syncBaseUrl?: string | null;
   limit?: number;
   filters?: DocsSearchFilterInput;
   maxContextChars?: number;
@@ -312,4 +299,16 @@ declare function buildDocsAskAIContext(options: {
 }): Promise<DocsAskAIContext>;
 declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
 //#endregion
-export { serializeOpenDocsProviders as $, createDocsSitemapResponse as A, DEFAULT_OPEN_DOCS_TARGET as B, DEFAULT_SITEMAP_XML_ROUTE as C, DocsSitemapPageInput as D, DocsSitemapManifestPage as E, resolveDocsSitemapPageLastmod as F, SerializedOpenDocsProvider as G, PromptAction as H, resolveDocsSitemapRequest as I, resolvePromptProviderChoices as J, normalizePromptProviderName as K, toDocsSitemapMarkdownUrl as L, renderDocsSitemapMarkdown as M, renderDocsSitemapXml as N, DocsSitemapResolvedConfig as O, resolveDocsSitemapConfig as P, serializeOpenDocsProvider as Q, DEFAULT_OPEN_DOCS_PROMPT as R, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as S, DocsSitemapManifest as T, PromptProviderChoice as U, DEFAULT_PROMPT_PROVIDER_TEMPLATES as V, SerializeOpenDocsProviderOptions as W, serializeDocsIcon as X, sanitizePromptText as Y, serializeDocsIconRegistry as Z, resolveDocsSearchRequest as _, emitDocsObservabilityEvent as _t, createCustomSearchAdapter as a, findDocsAudienceMdxIssues as at, DEFAULT_SITEMAP_MD_DOCS_ROUTE as b, resolveDocsObservabilityConfig as bt, createTypesenseSearchAdapter as c, resolveDocsAudienceMdxContent as ct, normalizeDocsSearchFilters as d, ResolvedDocsAnalyticsConfig as dt, DocsAudienceMdxIssue as et, performDocsSearch as f, ResolvedDocsObservabilityConfig as ft, resolveDocsSearchFilters as g, emitDocsAnalyticsEvent as gt, resolveDocsSearchAudience as h, emitDocsAgentTraceEvent as ht, createAlgoliaSearchAdapter as i, extractDocsMarkdownPromptBlocks as it, readDocsSitemapManifestFromContentMap as j, buildDocsSitemapManifest as k, formatDocsAskAIPackageHints as l, DOCS_AGENT_TRACE_EVENT_TYPES as lt, resolveAskAISearchRequestConfig as m, createDocsAgentTraceId as mt, buildDocsAskAIContext as n, DocsMarkdownPromptBlock as nt, createMcpSearchAdapter as o, resolveDocsAgentMdxContent as ot, performDocsSearchWithMetadata as p, createDocsAgentTraceContext as pt, parsePromptStringArray as q, buildDocsSearchDocuments as r, ExtractedDocsMarkdownPromptBlocks as rt, createSimpleSearchAdapter as s, resolveDocsAudienceExposure as st, PerformDocsSearchOptions as t, DocsContentAudience as tt, inferDocsAskAIPackageHints as u, DocsAgentTraceContext as ut, resolveSearchRequestConfig as v, getDocsRequestAnalyticsProperties as vt, DocsSitemapFormat as w, DEFAULT_SITEMAP_MD_ROUTE as x, DEFAULT_SITEMAP_MANIFEST_PATH as y, resolveDocsAnalyticsConfig as yt, DEFAULT_OPEN_DOCS_PROVIDER_IDS as z };
+//#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 { parsePromptStringArray as $, DocsSitemapFormat as A, resolveDocsSitemapConfig as B, resolveDocsSearchRequest as C, DEFAULT_SITEMAP_MD_ROUTE as D, DEFAULT_SITEMAP_MD_DOCS_ROUTE as E, buildDocsSitemapManifest as F, DEFAULT_OPEN_DOCS_PROVIDER_IDS as G, resolveDocsSitemapRequest as H, createDocsSitemapResponse as I, PromptAction as J, DEFAULT_OPEN_DOCS_TARGET as K, readDocsSitemapManifestFromContentMap as L, DocsSitemapManifestPage as M, DocsSitemapPageInput as N, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as O, DocsSitemapResolvedConfig as P, normalizePromptProviderName as Q, renderDocsSitemapMarkdown as R, resolveDocsSearchFilters as S, DEFAULT_SITEMAP_MANIFEST_PATH as T, toDocsSitemapMarkdownUrl as U, resolveDocsSitemapPageLastmod as V, DEFAULT_OPEN_DOCS_PROMPT as W, SerializeOpenDocsProviderOptions as X, PromptProviderChoice as Y, SerializedOpenDocsProvider as Z, performDocsSearch as _, resolveDocsObservabilityConfig as _t, buildDocsAskAIContext as a, serializeOpenDocsProviders as at, resolveDocsRetrievalLastModified as b, createAlgoliaSearchAdapter as c, ResolvedDocsAnalyticsConfig as ct, createSimpleSearchAdapter as d, createDocsAgentTraceId as dt, resolvePromptProviderChoices as et, createTypesenseSearchAdapter as f, emitDocsAgentTraceEvent as ft, normalizeDocsSearchFilters as g, resolveDocsAnalyticsConfig as gt, inferDocsAskAIPackageHints as h, getDocsRequestAnalyticsProperties as ht, PerformDocsSearchOptions as i, serializeOpenDocsProvider as it, DocsSitemapManifest as j, DEFAULT_SITEMAP_XML_ROUTE as k, createCustomSearchAdapter as l, ResolvedDocsObservabilityConfig as lt, formatDocsAskAIPackageHints as m, emitDocsObservabilityEvent as mt, isDocsRetrievalCanonicalUrl as n, serializeDocsIcon as nt, buildDocsRetrievalDigestProjection as o, DOCS_AGENT_TRACE_EVENT_TYPES as ot, enrichDocsSearchDocumentsWithProvenance as p, emitDocsAnalyticsEvent as pt, DEFAULT_PROMPT_PROVIDER_TEMPLATES as q, EnrichDocsSearchDocumentsWithProvenanceOptions as r, serializeDocsIconRegistry as rt, buildDocsSearchDocuments as s, DocsAgentTraceContext as st, digestDocsRetrievalContent as t, sanitizePromptText as tt, createMcpSearchAdapter as u, createDocsAgentTraceContext as ut, performDocsSearchWithMetadata as v, resolveSearchRequestConfig as w, resolveDocsSearchAudience as x, resolveAskAISearchRequestConfig as y, renderDocsSitemapXml as z };

package/dist/{review-DaJLdPLh.mjs → review-Dw6oCQX3.mjs}

@@ -1,14 +1,14 @@
-import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, Dt as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS } from "./agent-o9OTadrf.mjs";
+import { $t as getDocsMcpProtectedResourceMetadataRoutes, A as buildDocsAgentDiscoverySpec, Dt as findDocsAudienceMdxIssues, M as buildDocsConfigMap, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS } from "./agent-BHqaZx-X.mjs";
 import { _ as hasStructuredPageAgentContract, f as PAGE_AGENT_CONTRACT_FIELDS, g as getPageAgentFrontmatterIssues, v as normalizePageAgentFrontmatter } from "./markdown-sections-7OoA7ylx.mjs";
 import { I as resolveDocsDiscoveryApiRoute, _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, h as DEFAULT_AGENT_SKILL_FORMAT, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-BwL5ffGx.mjs";
-import { p as resolveAskAISearchRequestConfig } from "./search-RfPcG1if.mjs";
+import { h as resolveAskAISearchRequestConfig } from "./search-BmC8wVr0.mjs";
 import { a as resolveDocsMetadataBaseUrl } from "./metadata-N252j5_a.mjs";
-import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-BFHGypqh.mjs";
+import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-21LZ_uEl.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
 import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
-import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-CloP0pAe.mjs";
+import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-D_oDJwGv.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";

package/dist/{robots-BcuxnZqZ.mjs → robots-DaYBoy_A.mjs}

@@ -1,4 +1,4 @@
-import { Ht as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as normalizeDocsPathSegment, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-o9OTadrf.mjs";
+import { Ht as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Yt as DEFAULT_MCP_PUBLIC_ROUTE, Zt as DEFAULT_MCP_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as normalizeDocsPathSegment, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-BHqaZx-X.mjs";
 import { a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BwL5ffGx.mjs";
 
 //#region src/robots.ts

package/dist/{robots-DI-9MZz1.mjs → robots-KWLujSLI.mjs}

@@ -1,7 +1,7 @@
-import "./agent-o9OTadrf.mjs";
+import "./agent-BHqaZx-X.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
 import "./standards-discovery-BwL5ffGx.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-BcuxnZqZ.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 { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";