@farming-labs/docs 0.1.74 → 0.1.75

package/dist/search-D6uAGmiH.d.mts

@@ -0,0 +1,196 @@
+import { $ as DocsSitemapConfig, B as DocsObservabilityEventInput, G as DocsSearchChunkingConfig, H as DocsSearchAdapter, K as DocsSearchConfig, Ot as TypesenseDocsSearchConfig, Q as DocsSearchSourcePage, R as DocsObservabilityConfig, W as DocsSearchAdapterFactory, X as DocsSearchResult, _ as DocsAnalyticsConfig, d as CustomDocsSearchConfig, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, ot as McpDocsSearchConfig, q as DocsSearchDocument, r as AlgoliaDocsSearchConfig, v as DocsAnalyticsEvent, vt as ResolvedDocsRelatedLink, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-OAHZJ7NI.mjs";
+
+//#region src/cloud-analytics.d.ts
+interface DocsCloudAnalyticsOptions {
+  enabled?: boolean;
+  console?: DocsAnalyticsConfig["console"];
+  includeInputs?: boolean;
+  projectId?: string;
+  apiKey?: string;
+}
+declare function createDocsCloudAnalytics(options?: DocsCloudAnalyticsOptions): DocsAnalyticsConfig;
+//#endregion
+//#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 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/sitemap.d.ts
+declare const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
+declare const DEFAULT_SITEMAP_MD_ROUTE = "/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;
+  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;
+    wellKnownRoute: string;
+  };
+}
+interface CreateDocsSitemapResponseOptions {
+  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): 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 createDocsSitemapResponse({
+  request,
+  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;
+  results: DocsAskAIContextResult[];
+  searchResults: DocsSearchResult[];
+  packageHints: DocsAskAIPackageHints;
+}
+interface DocsAskAIPackageHints {
+  packages: string[];
+  imports: string[];
+  installCommands: string[];
+}
+declare function inferDocsAskAIPackageHints(content: string): DocsAskAIPackageHints;
+declare function formatDocsAskAIPackageHints(hints: DocsAskAIPackageHints, packageName?: string): string | undefined;
+declare function buildDocsSearchDocuments(pages: DocsSearchSourcePage[], chunking?: DocsSearchChunkingConfig): DocsSearchDocument[];
+declare function createSimpleSearchAdapter(): DocsSearchAdapter;
+declare function createTypesenseSearchAdapter(config: TypesenseDocsSearchConfig): DocsSearchAdapter;
+declare function resolveSearchRequestConfig(search: boolean | DocsSearchConfig | undefined, requestUrl?: string): boolean | DocsSearchConfig | undefined;
+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;
+declare function performDocsSearch(options: {
+  pages: DocsSearchSourcePage[];
+  query: string;
+  search?: boolean | DocsSearchConfig;
+  locale?: string;
+  pathname?: string;
+  siteTitle?: string;
+  limit?: number;
+}): Promise<DocsSearchResult[]>;
+declare function buildDocsAskAIContext(options: {
+  pages: DocsSearchSourcePage[];
+  query: string;
+  search?: boolean | DocsSearchConfig;
+  locale?: string;
+  pathname?: string;
+  siteTitle?: string;
+  baseUrl?: string;
+  limit?: number;
+  maxContextChars?: number;
+  maxResultChars?: number;
+}): Promise<DocsAskAIContext>;
+declare function createCustomSearchAdapter(adapter: DocsSearchAdapter | DocsSearchAdapterFactory): CustomDocsSearchConfig;
+//#endregion
+export { DOCS_AGENT_TRACE_EVENT_TYPES as A, resolveDocsObservabilityConfig as B, createDocsSitemapResponse as C, resolveDocsSitemapConfig as D, renderDocsSitemapXml as E, createDocsAgentTraceId as F, createDocsCloudAnalytics as H, emitDocsAgentTraceEvent as I, emitDocsAnalyticsEvent as L, ResolvedDocsAnalyticsConfig as M, ResolvedDocsObservabilityConfig as N, resolveDocsSitemapRequest as O, createDocsAgentTraceContext as P, emitDocsObservabilityEvent as R, buildDocsSitemapManifest as S, renderDocsSitemapMarkdown as T, DocsCloudAnalyticsOptions as V, DocsSitemapFormat as _, createMcpSearchAdapter as a, DocsSitemapPageInput as b, formatDocsAskAIPackageHints as c, resolveAskAISearchRequestConfig as d, resolveSearchRequestConfig as f, DEFAULT_SITEMAP_XML_ROUTE as g, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as h, createCustomSearchAdapter as i, DocsAgentTraceContext as j, toDocsSitemapMarkdownUrl as k, inferDocsAskAIPackageHints as l, DEFAULT_SITEMAP_MD_ROUTE as m, buildDocsSearchDocuments as n, createSimpleSearchAdapter as o, DEFAULT_SITEMAP_MANIFEST_PATH as p, createAlgoliaSearchAdapter as r, createTypesenseSearchAdapter as s, buildDocsAskAIContext as t, performDocsSearch as u, DocsSitemapManifest as v, readDocsSitemapManifestFromContentMap as w, DocsSitemapResolvedConfig as x, DocsSitemapManifestPage as y, resolveDocsAnalyticsConfig as z };

package/dist/{search-BxhAshfT.mjs → search-DD2SP_hD.mjs}

@@ -1,8 +1,8 @@
 import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-kP0mAXCp.mjs";
-import "./prompt-utils-8nmFLQVH.mjs";
+import "./sitemap-server-B370zkEo.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, d as readTopLevelStringProperty, f as resolveDocsConfigPath, p as resolveDocsContentDir } from "./config-Si-yUfM_.mjs";
+import { a as loadProjectEnv, d as readTopLevelStringProperty, f as resolveDocsConfigPath, p as resolveDocsContentDir } from "./config-C7sUsMkm.mjs";
 import { readFileSync } from "node:fs";
 import pc from "picocolors";
 

package/dist/server.d.mts

@@ -1,5 +1,5 @@
-import { A as DocsConfig, B as DocsObservabilityEventInput, D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, H as DocsSearchAdapter, K as DocsSearchConfig, O as DocsAskAIFeedbackValue, Q as DocsSearchSourcePage, R as DocsObservabilityConfig, T as DocsAskAIFeedbackConfig, U as DocsSearchAdapterContext, W as DocsSearchAdapterFactory, X as DocsSearchResult, Y as DocsSearchQuery, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, at as McpDocsSearchConfig, ct as OpenDocsProvider, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, k as DocsAskAIMcpConfig, m as DocsAgentTraceEventInput, q as DocsSearchDocument, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-OyUzNy83.mjs";
-import { C as resolveDocsObservabilityConfig, S as resolveDocsAnalyticsConfig, T as createDocsCloudAnalytics, _ as createDocsAgentTraceContext, a as createMcpSearchAdapter, b as emitDocsAnalyticsEvent, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as ResolvedDocsObservabilityConfig, h as ResolvedDocsAnalyticsConfig, i as createCustomSearchAdapter, l as inferDocsAskAIPackageHints, m as DocsAgentTraceContext, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as DOCS_AGENT_TRACE_EVENT_TYPES, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as createDocsAgentTraceId, w as DocsCloudAnalyticsOptions, x as emitDocsObservabilityEvent, y as emitDocsAgentTraceEvent } from "./search-K4fg0Zzw.mjs";
+import { $ as DocsSitemapConfig, A as DocsConfig, B as DocsObservabilityEventInput, D as DocsAskAIFeedbackMessage, E as DocsAskAIFeedbackData, H as DocsSearchAdapter, K as DocsSearchConfig, O as DocsAskAIFeedbackValue, Q as DocsSearchSourcePage, R as DocsObservabilityConfig, T as DocsAskAIFeedbackConfig, U as DocsSearchAdapterContext, W as DocsSearchAdapterFactory, X as DocsSearchResult, Y as DocsSearchQuery, _ as DocsAnalyticsConfig, a as ApiReferenceRenderer, g as DocsAgentTraceStatus, h as DocsAgentTraceEventType, k as DocsAskAIMcpConfig, lt as OpenDocsProvider, m as DocsAgentTraceEventInput, ot as McpDocsSearchConfig, q as DocsSearchDocument, v as DocsAnalyticsEvent, y as DocsAnalyticsEventInput, z as DocsObservabilityEvent } from "./types-OAHZJ7NI.mjs";
+import { A as DOCS_AGENT_TRACE_EVENT_TYPES, B as resolveDocsObservabilityConfig, C as createDocsSitemapResponse, D as resolveDocsSitemapConfig, E as renderDocsSitemapXml, F as createDocsAgentTraceId, H as createDocsCloudAnalytics, I as emitDocsAgentTraceEvent, L as emitDocsAnalyticsEvent, M as ResolvedDocsAnalyticsConfig, N as ResolvedDocsObservabilityConfig, O as resolveDocsSitemapRequest, P as createDocsAgentTraceContext, R as emitDocsObservabilityEvent, S as buildDocsSitemapManifest, T as renderDocsSitemapMarkdown, V as DocsCloudAnalyticsOptions, _ as DocsSitemapFormat, a as createMcpSearchAdapter, b as DocsSitemapPageInput, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, g as DEFAULT_SITEMAP_XML_ROUTE, h as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, i as createCustomSearchAdapter, j as DocsAgentTraceContext, k as toDocsSitemapMarkdownUrl, l as inferDocsAskAIPackageHints, m as DEFAULT_SITEMAP_MD_ROUTE, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, p as DEFAULT_SITEMAP_MANIFEST_PATH, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch, v as DocsSitemapManifest, w as readDocsSitemapManifestFromContentMap, x as DocsSitemapResolvedConfig, y as DocsSitemapManifestPage, z as resolveDocsAnalyticsConfig } from "./search-D6uAGmiH.mjs";
 import { DocsMcpHttpHandlers, DocsMcpNavigationNode, DocsMcpNavigationTree, DocsMcpPage, DocsMcpResolvedConfig, DocsMcpSource, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
 //#region src/api-reference.d.ts
@@ -63,4 +63,7 @@ declare function parsePromptStringArray(value: unknown): string[] | undefined;
 declare function resolvePromptProviderChoices(availableProviders?: PromptProviderInput[], preferredNames?: string[]): PromptProviderChoice[];
 declare function sanitizePromptText(text: string): string;
 //#endregion
-export { type ApiReferenceFramework, type ApiReferenceRenderer, type ApiReferenceRoute, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DOCS_AGENT_TRACE_EVENT_TYPES, 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 DocsCloudAnalyticsOptions, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpResolvedConfig, type DocsMcpSource, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, formatDocsAskAIPackageHints, inferDocsAskAIPackageHints, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders };
+//#region src/sitemap-server.d.ts
+declare function readDocsSitemapManifest(rootDir: string, sitemap?: boolean | DocsSitemapConfig): DocsSitemapManifest | null;
+//#endregion
+export { type ApiReferenceFramework, type ApiReferenceRenderer, type ApiReferenceRoute, DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, 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 DocsCloudAnalyticsOptions, type DocsMcpHttpHandlers, type DocsMcpNavigationNode, type DocsMcpNavigationTree, type DocsMcpPage, type DocsMcpResolvedConfig, type DocsMcpSource, type DocsObservabilityConfig, type DocsObservabilityEvent, type DocsObservabilityEventInput, type DocsSearchAdapter, type DocsSearchAdapterContext, type DocsSearchAdapterFactory, type DocsSearchConfig, type DocsSearchDocument, type DocsSearchQuery, type DocsSearchResult, type DocsSearchSourcePage, type DocsSitemapFormat, type DocsSitemapManifest, type DocsSitemapManifestPage, type DocsSitemapPageInput, type DocsSitemapResolvedConfig, type McpDocsSearchConfig, type PromptAction, type PromptProviderChoice, type ResolvedApiReferenceConfig, type ResolvedDocsAnalyticsConfig, type ResolvedDocsObservabilityConfig, type SerializedOpenDocsProvider, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, formatDocsAskAIPackageHints, inferDocsAskAIPackageHints, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsSitemapConfig, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };

package/dist/server.mjs

@@ -1,5 +1,6 @@
 import { A as emitDocsAnalyticsEvent, D as createDocsAgentTraceContext, E as DOCS_AGENT_TRACE_EVENT_TYPES, M as resolveDocsAnalyticsConfig, N as resolveDocsObservabilityConfig, O as createDocsAgentTraceId, P as createDocsCloudAnalytics, a as createMcpSearchAdapter, c as formatDocsAskAIPackageHints, d as resolveAskAISearchRequestConfig, f as resolveSearchRequestConfig, i as createCustomSearchAdapter, j as emitDocsObservabilityEvent, k as emitDocsAgentTraceEvent, l as inferDocsAskAIPackageHints, n as buildDocsSearchDocuments, o as createSimpleSearchAdapter, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter, t as buildDocsAskAIContext, u as performDocsSearch } from "./search-kP0mAXCp.mjs";
-import { a as sanitizePromptText, c as serializeOpenDocsProviders, d as buildApiReferenceOpenApiDocument, f as buildApiReferenceOpenApiDocumentAsync, g as resolveApiReferenceRenderer, h as resolveApiReferenceConfig, i as resolvePromptProviderChoices, l as buildApiReferenceHtmlDocument, m as buildApiReferenceScalarCss, n as normalizePromptProviderName, o as serializeDocsIcon, p as buildApiReferencePageTitle, r as parsePromptStringArray, s as serializeDocsIconRegistry, t as DEFAULT_PROMPT_PROVIDER_TEMPLATES, u as buildApiReferenceHtmlDocumentAsync } from "./prompt-utils-8nmFLQVH.mjs";
+import { a as buildDocsSitemapManifest, c as renderDocsSitemapMarkdown, d as resolveDocsSitemapRequest, f as toDocsSitemapMarkdownUrl, i as DEFAULT_SITEMAP_XML_ROUTE, l as renderDocsSitemapXml, n as DEFAULT_SITEMAP_MD_ROUTE, o as createDocsSitemapResponse, r as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, s as readDocsSitemapManifestFromContentMap, t as DEFAULT_SITEMAP_MANIFEST_PATH, u as resolveDocsSitemapConfig } from "./sitemap-Buobvabq.mjs";
+import { _ as resolveApiReferenceRenderer, a as resolvePromptProviderChoices, c as serializeDocsIconRegistry, d as buildApiReferenceHtmlDocumentAsync, f as buildApiReferenceOpenApiDocument, g as resolveApiReferenceConfig, h as buildApiReferenceScalarCss, i as parsePromptStringArray, l as serializeOpenDocsProviders, m as buildApiReferencePageTitle, n as DEFAULT_PROMPT_PROVIDER_TEMPLATES, o as sanitizePromptText, p as buildApiReferenceOpenApiDocumentAsync, r as normalizePromptProviderName, s as serializeDocsIcon, t as readDocsSitemapManifest, u as buildApiReferenceHtmlDocument } from "./sitemap-server-B370zkEo.mjs";
 import { createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, normalizeDocsMcpRoute, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
 
-export { DEFAULT_PROMPT_PROVIDER_TEMPLATES, DOCS_AGENT_TRACE_EVENT_TYPES, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsSearchDocuments, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, formatDocsAskAIPackageHints, inferDocsAskAIPackageHints, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders };
+export { DEFAULT_PROMPT_PROVIDER_TEMPLATES, DEFAULT_SITEMAP_MANIFEST_PATH, DEFAULT_SITEMAP_MD_ROUTE, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, DEFAULT_SITEMAP_XML_ROUTE, DOCS_AGENT_TRACE_EVENT_TYPES, buildApiReferenceHtmlDocument, buildApiReferenceHtmlDocumentAsync, buildApiReferenceOpenApiDocument, buildApiReferenceOpenApiDocumentAsync, buildApiReferencePageTitle, buildApiReferenceScalarCss, buildDocsAskAIContext, buildDocsSearchDocuments, buildDocsSitemapManifest, createAlgoliaSearchAdapter, createCustomSearchAdapter, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCloudAnalytics, createDocsMcpHttpHandler, createDocsMcpServer, createDocsSitemapResponse, createFilesystemDocsMcpSource, createMcpSearchAdapter, createSimpleSearchAdapter, createTypesenseSearchAdapter, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsObservabilityEvent, formatDocsAskAIPackageHints, inferDocsAskAIPackageHints, normalizeDocsMcpRoute, normalizePromptProviderName, parsePromptStringArray, performDocsSearch, readDocsSitemapManifest, readDocsSitemapManifestFromContentMap, renderDocsSitemapMarkdown, renderDocsSitemapXml, resolveApiReferenceConfig, resolveApiReferenceRenderer, resolveAskAISearchRequestConfig, resolveDocsAnalyticsConfig, resolveDocsMcpConfig, resolveDocsObservabilityConfig, resolveDocsSitemapConfig, resolveDocsSitemapRequest, resolvePromptProviderChoices, resolveSearchRequestConfig, runDocsMcpStdio, sanitizePromptText, serializeDocsIcon, serializeDocsIconRegistry, serializeOpenDocsProviders, toDocsSitemapMarkdownUrl };

package/dist/sitemap-Buobvabq.mjs

@@ -0,0 +1,244 @@
+//#region src/sitemap.ts
+const DEFAULT_SITEMAP_XML_ROUTE = "/sitemap.xml";
+const DEFAULT_SITEMAP_MD_ROUTE = "/sitemap.md";
+const DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE = "/.well-known/sitemap.md";
+const DEFAULT_SITEMAP_MANIFEST_PATH = ".farming-labs/sitemap-manifest.json";
+function normalizeUrlPath(value) {
+	const normalized = value.replace(/\/+/g, "/");
+	if (normalized === "/") return normalized;
+	return normalized.replace(/\/+$/, "");
+}
+function normalizeRoutePrefix(value) {
+	if (!value) return "";
+	const normalized = normalizeUrlPath(`/${value.replace(/^\/+|\/+$/g, "")}`);
+	return normalized === "/" ? "" : normalized;
+}
+function joinRoute(prefix, route) {
+	return normalizeUrlPath(`${prefix}/${route.replace(/^\/+/, "")}`);
+}
+function normalizeDateOnly(value) {
+	if (!value) return void 0;
+	const trimmed = value.trim();
+	if (!trimmed) return void 0;
+	const dateOnly = trimmed.match(/^(\d{4}-\d{2}-\d{2})/);
+	if (dateOnly) return dateOnly[1];
+	const parsed = new Date(trimmed);
+	if (Number.isNaN(parsed.getTime())) return void 0;
+	return parsed.toISOString().slice(0, 10);
+}
+function normalizeBaseUrl(value) {
+	if (!value) return void 0;
+	return value.trim().replace(/\/+$/, "") || void 0;
+}
+function isEnabledObject(config) {
+	if (config === false || config === void 0) return false;
+	if (config === true) return true;
+	return config.enabled !== false;
+}
+function resolveDocsSitemapConfig(sitemap, defaults = {}) {
+	const objectConfig = sitemap && typeof sitemap === "object" ? sitemap : {};
+	const routePrefix = normalizeRoutePrefix(objectConfig.routePrefix);
+	const xmlConfig = objectConfig.xml;
+	const markdownConfig = objectConfig.markdown;
+	const xmlEnabled = xmlConfig === false ? false : typeof xmlConfig === "object" ? xmlConfig.enabled ?? true : true;
+	const markdownEnabled = markdownConfig === false ? false : typeof markdownConfig === "object" ? markdownConfig.enabled ?? true : true;
+	return {
+		enabled: isEnabledObject(sitemap),
+		routePrefix,
+		baseUrl: normalizeBaseUrl(objectConfig.baseUrl ?? defaults.baseUrl),
+		manifestPath: objectConfig.manifestPath ?? DEFAULT_SITEMAP_MANIFEST_PATH,
+		xml: {
+			enabled: xmlEnabled,
+			includeLastmod: typeof xmlConfig === "object" ? xmlConfig.includeLastmod ?? true : true,
+			route: joinRoute(routePrefix, DEFAULT_SITEMAP_XML_ROUTE)
+		},
+		markdown: {
+			enabled: markdownEnabled,
+			includeDescriptions: typeof markdownConfig === "object" ? markdownConfig.includeDescriptions ?? true : true,
+			includeLastmod: typeof markdownConfig === "object" ? markdownConfig.includeLastmod ?? true : true,
+			linkTarget: typeof markdownConfig === "object" ? markdownConfig.linkTarget ?? "both" : "both",
+			route: joinRoute(routePrefix, DEFAULT_SITEMAP_MD_ROUTE),
+			wellKnownRoute: joinRoute(routePrefix, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE)
+		}
+	};
+}
+function resolveDocsSitemapRequest(url, sitemap) {
+	const pathname = normalizeUrlPath(url.pathname);
+	const format = url.searchParams.get("format")?.trim();
+	if (pathname === "/api/docs") {
+		if (format === "sitemap-xml") return "xml";
+		if (format === "sitemap-md" || format === "sitemap-markdown") return "markdown";
+	}
+	const resolved = resolveDocsSitemapConfig(sitemap);
+	if (!resolved.enabled) return null;
+	if (resolved.xml.enabled && pathname === resolved.xml.route) return "xml";
+	if (resolved.markdown.enabled && (pathname === resolved.markdown.route || pathname === resolved.markdown.wellKnownRoute)) return "markdown";
+	return null;
+}
+function toDocsSitemapMarkdownUrl(url) {
+	const normalized = normalizeUrlPath(url);
+	return normalized.endsWith(".md") ? normalized : `${normalized}.md`;
+}
+function absolutizeUrl(baseUrl, url) {
+	if (/^https?:\/\//i.test(url)) return url;
+	const base = normalizeBaseUrl(baseUrl);
+	return base ? `${base}${url.startsWith("/") ? url : `/${url}`}` : url;
+}
+function escapeXml(value) {
+	return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function hashString(value) {
+	let hash = 14695981039346656037n;
+	const bytes = new TextEncoder().encode(value);
+	for (const byte of bytes) {
+		hash ^= BigInt(byte);
+		hash = BigInt.asUintN(64, hash * 1099511628211n);
+	}
+	return `"fnv1a64-${hash.toString(16).padStart(16, "0")}"`;
+}
+function newestLastmod(pages) {
+	let newest;
+	for (const page of pages) {
+		const date = normalizeDateOnly(page.lastmod);
+		if (!date) continue;
+		if (!newest || date > newest) newest = date;
+	}
+	return newest;
+}
+function titleize(value) {
+	return value.replace(/-/g, " ").replace(/\b\w/g, (char) => char.toUpperCase());
+}
+function sitemapSectionName(entry, pageUrl) {
+	const normalizedEntry = `/${entry.replace(/^\/+|\/+$/g, "") || "docs"}`;
+	const normalizedUrl = normalizeUrlPath(pageUrl);
+	if (normalizedUrl === normalizedEntry) return "Overview";
+	const firstSegment = (normalizedUrl.startsWith(`${normalizedEntry}/`) ? normalizedUrl.slice(normalizedEntry.length + 1) : normalizedUrl.replace(/^\/+/, "")).split("/").filter(Boolean)[0];
+	return firstSegment ? titleize(firstSegment) : "Pages";
+}
+function buildDocsSitemapManifest(options) {
+	const baseUrl = normalizeBaseUrl(options.baseUrl);
+	const seen = /* @__PURE__ */ new Set();
+	const pages = [];
+	for (const page of options.pages) {
+		const url = normalizeUrlPath(page.url);
+		if (seen.has(url)) continue;
+		seen.add(url);
+		const resolvedLastmod = options.resolveLastmod?.(page);
+		const fallbackLastmod = normalizeDateOnly(page.lastmod ?? page.lastModified);
+		const lastmod = normalizeDateOnly(resolvedLastmod?.lastmod) ?? fallbackLastmod;
+		pages.push({
+			url,
+			absoluteUrl: absolutizeUrl(baseUrl, url),
+			markdownUrl: toDocsSitemapMarkdownUrl(url),
+			title: page.title,
+			description: page.description,
+			sourcePath: page.sourcePath,
+			lastmod,
+			lastmodSource: resolvedLastmod?.lastmodSource ?? (lastmod ? "unknown" : void 0),
+			related: page.related?.map((link) => link.href)
+		});
+	}
+	pages.sort((left, right) => left.url.localeCompare(right.url));
+	return {
+		version: 1,
+		generatedAt: options.generatedAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+		baseUrl,
+		entry: options.entry ?? "docs",
+		siteTitle: options.siteTitle,
+		pages
+	};
+}
+function renderDocsSitemapXml(manifest, options = {}) {
+	const baseUrl = normalizeBaseUrl(options.baseUrl ?? manifest.baseUrl);
+	const includeLastmod = options.includeLastmod ?? true;
+	const lines = ["<?xml version=\"1.0\" encoding=\"UTF-8\"?>", "<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">"];
+	for (const page of manifest.pages) {
+		lines.push("  <url>");
+		lines.push(`    <loc>${escapeXml(page.absoluteUrl ?? absolutizeUrl(baseUrl, page.url))}</loc>`);
+		const lastmod = normalizeDateOnly(page.lastmod);
+		if (includeLastmod && lastmod) lines.push(`    <lastmod>${lastmod}</lastmod>`);
+		lines.push("  </url>");
+	}
+	lines.push("</urlset>");
+	return `${lines.join("\n")}\n`;
+}
+function renderDocsSitemapMarkdown(manifest, options = {}) {
+	const siteTitle = manifest.siteTitle ?? "Documentation";
+	const includeDescriptions = options.includeDescriptions ?? true;
+	const includeLastmod = options.includeLastmod ?? true;
+	const linkTarget = options.linkTarget ?? "both";
+	const lines = [`# ${siteTitle} Sitemap`, ""];
+	const baseUrl = normalizeBaseUrl(options.baseUrl ?? manifest.baseUrl);
+	if (baseUrl) lines.push(`Base URL: ${baseUrl}`);
+	lines.push(`Docs entry: /${manifest.entry.replace(/^\/+|\/+$/g, "") || "docs"}`);
+	lines.push(`Generated: ${normalizeDateOnly(manifest.generatedAt) ?? manifest.generatedAt}`, "");
+	const groups = /* @__PURE__ */ new Map();
+	for (const page of manifest.pages) {
+		const sectionName = sitemapSectionName(manifest.entry, page.url);
+		groups.set(sectionName, [...groups.get(sectionName) ?? [], page]);
+	}
+	for (const [sectionName, pages] of groups) {
+		lines.push(`## ${sectionName}`, "");
+		for (const page of pages) {
+			const primaryHref = linkTarget === "markdown" ? page.markdownUrl : page.url;
+			lines.push(`- [${page.title}](${primaryHref})`);
+			if (linkTarget === "both" || linkTarget === "markdown") lines.push(`  Markdown: ${page.markdownUrl}`);
+			if (includeDescriptions && page.description) lines.push(`  Description: ${page.description}`);
+			const lastmod = normalizeDateOnly(page.lastmod);
+			if (includeLastmod && lastmod) lines.push(`  Last updated: ${lastmod}`);
+			if (page.related && page.related.length > 0) lines.push(`  Related: ${page.related.join(", ")}`);
+			lines.push("");
+		}
+	}
+	return lines.join("\n").replace(/\n{3,}/g, "\n\n");
+}
+function readDocsSitemapManifestFromContentMap(contentMap) {
+	if (!contentMap) return null;
+	const raw = contentMap[`/${DEFAULT_SITEMAP_MANIFEST_PATH}`] ?? contentMap[DEFAULT_SITEMAP_MANIFEST_PATH];
+	if (!raw) return null;
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return null;
+	}
+}
+function createDocsSitemapResponse({ request, sitemap, entry = "docs", siteTitle, baseUrl, pages, manifest }) {
+	const url = new URL(request.url);
+	const format = resolveDocsSitemapRequest(url, sitemap);
+	if (!format) return null;
+	const resolved = resolveDocsSitemapConfig(sitemap, { baseUrl });
+	if (!resolved.enabled) return null;
+	if (format === "xml" && !resolved.xml.enabled) return null;
+	if (format === "markdown" && !resolved.markdown.enabled) return null;
+	const nextManifest = manifest ?? buildDocsSitemapManifest({
+		pages,
+		entry,
+		siteTitle,
+		baseUrl: resolved.baseUrl ?? url.origin
+	});
+	const responseBaseUrl = resolved.baseUrl ?? nextManifest.baseUrl ?? url.origin;
+	const body = format === "xml" ? renderDocsSitemapXml(nextManifest, {
+		baseUrl: responseBaseUrl,
+		includeLastmod: resolved.xml.includeLastmod
+	}) : renderDocsSitemapMarkdown(nextManifest, {
+		baseUrl: responseBaseUrl,
+		includeDescriptions: resolved.markdown.includeDescriptions,
+		includeLastmod: resolved.markdown.includeLastmod,
+		linkTarget: resolved.markdown.linkTarget
+	});
+	const headers = new Headers({
+		"Content-Type": format === "xml" ? "application/xml; charset=utf-8" : "text/markdown; charset=utf-8",
+		"Cache-Control": "public, max-age=0, must-revalidate",
+		ETag: hashString(body)
+	});
+	const lastModified = newestLastmod(nextManifest.pages);
+	if (lastModified) headers.set("Last-Modified", (/* @__PURE__ */ new Date(`${lastModified}T00:00:00.000Z`)).toUTCString());
+	if (request.headers.get("if-none-match") === headers.get("ETag")) return new Response(null, {
+		status: 304,
+		headers
+	});
+	return new Response(body, { headers });
+}
+
+//#endregion
+export { buildDocsSitemapManifest as a, renderDocsSitemapMarkdown as c, resolveDocsSitemapRequest as d, toDocsSitemapMarkdownUrl as f, DEFAULT_SITEMAP_XML_ROUTE as i, renderDocsSitemapXml as l, DEFAULT_SITEMAP_MD_ROUTE as n, createDocsSitemapResponse as o, DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE as r, readDocsSitemapManifestFromContentMap as s, DEFAULT_SITEMAP_MANIFEST_PATH as t, resolveDocsSitemapConfig as u };