@farming-labs/docs 0.2.71 → 0.2.73

package/dist/{search-CozHzW7v.d.mts → search-D1n8Sf25.d.mts}

@@ -1,5 +1,5 @@
-import { $n as ResolvedDocsRelatedLink, Fn as OpenDocsProvider, Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Mn as McpDocsSearchConfig, Rn as OpenDocsTarget, at as DocsAnalyticsEventInput, cn as DocsSearchConfig, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, fn as DocsSearchResult, hn as DocsSitemapConfig, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, ln as DocsSearchDocument, lr as TypesenseDocsSearchConfig, mn as DocsSearchSourcePage, on as DocsSearchAdapterFactory, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, sn as DocsSearchChunkingConfig } from "./types-BQC05SQm.mjs";
-import { F as DocsDiscoveryApiRouteOptions } from "./standards-discovery-C0CIC4QI.mjs";
+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";
 
 //#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"];
@@ -35,11 +35,32 @@ declare function emitDocsAgentTraceEvent(observability: boolean | DocsObservabil
 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[];
 /**
@@ -214,6 +235,12 @@ interface DocsAskAIPackageHints {
   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;
+/** 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;
 declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig, audience?: DocsContentAudience): DocsSearchDocument[];
@@ -235,16 +262,20 @@ declare function resolveAskAISearchRequestConfig(options: {
 }): boolean | DocsSearchConfig | undefined;
 declare function createMcpSearchAdapter(config: McpDocsSearchConfig): DocsSearchAdapter;
 declare function createAlgoliaSearchAdapter(config: AlgoliaDocsSearchConfig): DocsSearchAdapter;
-declare function performDocsSearch(options: {
+interface PerformDocsSearchOptions {
   pages: DocsSearchSourcePage[];
   query: string;
-  search?: boolean | DocsSearchConfig; /** Selects which audience projection is searchable. Public site search defaults to human. */
+  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. */
+  siteTitle?: string;
+  /** Canonical docs URL used to distinguish same-site absolute hits from foreign MCP results. */
   baseUrl?: string;
   limit?: number;
+  /** 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
@@ -255,10 +286,14 @@ declare function performDocsSearch(options: {
    * Whether non-simple provider hits are supplemented with exact/local simple results.
    * 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. */
-  strictExternalOrigins?: boolean; /** Optional cancellation signal forwarded to adapters and their managed requests. */
+  supplementExternalResults?: boolean;
+  /** Fail closed on absolute provider hits when no canonical docs origin is available. */
+  strictExternalOrigins?: boolean;
+  /** Optional cancellation signal forwarded to adapters and their managed requests. */
   signal?: AbortSignal;
-}): Promise<DocsSearchResult[]>;
+}
+declare function performDocsSearch(options: PerformDocsSearchOptions): Promise<DocsSearchResult[]>;
+declare function performDocsSearchWithMetadata(options: PerformDocsSearchOptions): Promise<DocsSearchResponse>;
 declare function buildDocsAskAIContext(options: {
   pages: DocsSearchSourcePage[];
   query: string;
@@ -268,6 +303,7 @@ declare function buildDocsAskAIContext(options: {
   siteTitle?: string;
   baseUrl?: string;
   limit?: number;
+  filters?: DocsSearchFilterInput;
   maxContextChars?: number;
   maxResultChars?: number; /** See `performDocsSearch.failureMode`. Defaults to resilient runtime fallback. */
   searchFailureMode?: "fallback" | "throw"; /** See `performDocsSearch.strictExternalOrigins`. */
@@ -276,4 +312,4 @@ declare function buildDocsAskAIContext(options: {
 }): Promise<DocsAskAIContext>;
 declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
 //#endregion
-export { resolveDocsAudienceExposure as $, resolveDocsSitemapPageLastmod as A, SerializedOpenDocsProvider as B, DocsSitemapResolvedConfig as C, renderDocsSitemapMarkdown as D, readDocsSitemapManifestFromContentMap as E, DEFAULT_OPEN_DOCS_TARGET as F, serializeDocsIcon as G, parsePromptStringArray as H, DEFAULT_PROMPT_PROVIDER_TEMPLATES as I, serializeOpenDocsProviders as J, serializeDocsIconRegistry as K, PromptAction as L, toDocsSitemapMarkdownUrl as M, DEFAULT_OPEN_DOCS_PROMPT as N, renderDocsSitemapXml as O, DEFAULT_OPEN_DOCS_PROVIDER_IDS as P, resolveDocsAgentMdxContent as Q, PromptProviderChoice as R, DocsSitemapPageInput as S, createDocsSitemapResponse as T, resolvePromptProviderChoices as U, normalizePromptProviderName as V, sanitizePromptText as W, DocsContentAudience as X, DocsAudienceMdxIssue as Y, findDocsAudienceMdxIssues as Z, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as _, createMcpSearchAdapter as a, createDocsAgentTraceContext as at, DocsSitemapManifest as b, formatDocsAskAIPackageHints as c, emitDocsAnalyticsEvent as ct, resolveAskAISearchRequestConfig as d, resolveDocsAnalyticsConfig as dt, resolveDocsAudienceMdxContent as et, resolveDocsSearchAudience as f, resolveDocsObservabilityConfig as ft, DEFAULT_SITEMAP_MD_ROUTE as g, DEFAULT_SITEMAP_MD_DOCS_ROUTE as h, createCustomSearchAdapter as i, ResolvedDocsObservabilityConfig as it, resolveDocsSitemapRequest as j, resolveDocsSitemapConfig as k, inferDocsAskAIPackageHints as l, emitDocsObservabilityEvent as lt, DEFAULT_SITEMAP_MANIFEST_PATH as m, buildDocsSearchDocuments as n, DocsAgentTraceContext as nt, createSimpleSearchAdapter as o, createDocsAgentTraceId as ot, resolveSearchRequestConfig as p, serializeOpenDocsProvider as q, createAlgoliaSearchAdapter as r, ResolvedDocsAnalyticsConfig as rt, createTypesenseSearchAdapter as s, emitDocsAgentTraceEvent as st, buildDocsAskAIContext as t, DOCS_AGENT_TRACE_EVENT_TYPES as tt, performDocsSearch as u, getDocsRequestAnalyticsProperties as ut, DEFAULT_SITEMAP_XML_ROUTE as v, buildDocsSitemapManifest as w, DocsSitemapManifestPage as x, DocsSitemapFormat as y, SerializeOpenDocsProviderOptions as z };
+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 };

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

@@ -1,11 +1,12 @@
-import "./agent-FIyl4-Oa.mjs";
-import "./standards-discovery-CYfiQE13.mjs";
-import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-x5O0-9X3.mjs";
-import "./sitemap-server-D_hayOp6.mjs";
-import "./agent-evals-Cr9TAkmB.mjs";
+import "./agent-o9OTadrf.mjs";
+import "./markdown-sections-7OoA7ylx.mjs";
+import "./standards-discovery-BwL5ffGx.mjs";
+import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-RfPcG1if.mjs";
+import "./sitemap-server-VefDnzEB.mjs";
+import "./agent-evals-BFHGypqh.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-B4u3qy-1.mjs";
+import "./agent-skills-server-noFn1l_p.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, c as loadProjectEnv, g as resolveDocsConfigPath, h as readTopLevelStringProperty } from "./config-Wcdj-D0a.mjs";
 import { readFileSync } from "node:fs";