@farming-labs/docs 0.2.77 → 0.2.78

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

@@ -1,5 +1,5 @@
-import { Bn as LlmsTxtMaxCharsConfig, Cn as DocsSearchSourcePage, En as DocsSitemapConfig, Fn as FeedbackConfig, G as DocsAgentFeedbackData, Hn as LlmsTxtSectionConfig, Mt as DocsI18nConfig, Rt as DocsMcpConfig, Vn as LlmsTxtMaxCharsMode, an as DocsRobotsConfig, fn as DocsSearchConfig, kt as DocsConfig, nr as PageAgentFrontmatter, ur as ResolvedDocsRelatedLink, zn as LlmsTxtConfig } from "./types-B-5Kzmkn.mjs";
-import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-BbslY4id.mjs";
+import { $n as LlmsTxtMaxCharsMode, At as DocsConfig, F as DocsAgentContentChangesConfig, Fn as DocsSearchSourcePage, K as DocsAgentFeedbackData, Qn as LlmsTxtMaxCharsConfig, Rn as DocsSitemapConfig, Sr as ResolvedDocsRelatedLink, Vt as DocsI18nConfig, Zn as LlmsTxtConfig, er as LlmsTxtSectionConfig, mn as DocsRobotsConfig, mr as PageAgentFrontmatter, qn as FeedbackConfig, qt as DocsMcpConfig, xn as DocsSearchConfig } from "./types-CpLnwHak.mjs";
+import { O as DocsA2AAgentCardOptions, R as DocsDiscoveryApiRouteOptions, z as DocsPublishedAgentSkill } from "./standards-discovery-BWyNgZSs.mjs";
 import { DocsMcpPage, DocsMcpResolvedConfig } from "./mcp.mjs";
 
 //#region src/i18n.d.ts
@@ -204,6 +204,7 @@ interface DocsDiagnosticsFeature {
   routes?: Record<string, string | null>;
   agentEndpoint?: string | null;
   structuredAgentEndpoint?: string | null;
+  facetsEndpoint?: string | null;
   audienceParam?: string;
   defaultAudience?: "human" | "agent";
   supportedAudiences?: Array<"human" | "agent">;
@@ -214,8 +215,17 @@ interface DocsDiagnosticsFeature {
     tags: "tags";
   };
   responseFormat?: "docs-search.v1";
+  facetsResponseFormat?: "docs-search-facets.v1";
+  format?: string;
+  sinceParam?: string;
+  generationField?: string;
+  resetRequiredField?: string;
   warningsField?: "warnings";
-  /** Opaque continuation token accepted by structured search. */
+  /** Facet field selected for facet-value continuation. */
+  facetParam?: "facet";
+  /** Page-size parameter accepted by structured search and facet discovery. */
+  limitParam?: "limit";
+  /** Opaque continuation token accepted by structured search and facet discovery. */
   cursorParam?: "cursor";
   /** Optional continuation token returned when another result page is available. */
   nextCursorField?: "nextCursor";
@@ -248,6 +258,7 @@ interface DocsDiagnostics {
     skill: string;
     search: string | null;
     agentSearch: string | null;
+    contentChanges: string | null;
     askAi: string | null;
     mcp: string | null;
     llmsTxt: string | null;
@@ -264,6 +275,7 @@ interface DocsDiagnostics {
     diagnostics: DocsDiagnosticsFeature;
     apiCatalog: DocsDiagnosticsFeature;
     search: DocsDiagnosticsFeature;
+    contentChanges: DocsDiagnosticsFeature;
     ai: DocsDiagnosticsFeature;
     mcp: DocsDiagnosticsFeature;
     feedback: DocsDiagnosticsFeature;
@@ -348,6 +360,8 @@ interface DocsAgentDiscoverySpecOptions extends DocsDiscoveryApiRouteOptions {
   apiCatalog?: boolean;
   i18n?: ResolvedDocsI18n | null;
   search?: boolean | DocsSearchConfig;
+  /** Runtime metadata-only document synchronization feed. Defaults to enabled. */
+  contentChanges?: boolean | DocsAgentContentChangesConfig;
   mcp: DocsMcpResolvedConfig;
   feedback?: DocsAgentFeedbackDiscoveryConfig;
   llms?: DocsLlmsDiscoveryConfig;
@@ -372,6 +386,8 @@ interface DocsSkillDocumentOptions extends DocsDiscoveryApiRouteOptions {
   /** Whether this deployment actually serves the RFC 9727 API catalog. Defaults to true. */
   apiCatalog?: boolean;
   search?: boolean | DocsSearchConfig;
+  /** Runtime metadata-only document synchronization feed. Defaults to enabled. */
+  contentChanges?: boolean | DocsAgentContentChangesConfig;
   mcp: DocsMcpResolvedConfig;
   feedback?: DocsAgentFeedbackDiscoveryConfig;
   llms?: DocsLlmsDiscoveryConfig;
@@ -632,6 +648,7 @@ declare function buildDocsAgentDiscoverySpec({
   apiCatalog: explicitApiCatalog,
   i18n,
   search,
+  contentChanges,
   mcp,
   feedback,
   llms,
@@ -673,6 +690,7 @@ declare function buildDocsAgentDiscoverySpec({
     agentSkillsDiscovery: boolean;
     mcp: boolean;
     search: boolean;
+    contentChanges: boolean;
     sitemap: boolean;
     robots: boolean;
     structuredData: boolean;
@@ -682,6 +700,7 @@ declare function buildDocsAgentDiscoverySpec({
     locales: boolean;
   };
   api: {
+    contentChanges?: string | undefined;
     openapi: string;
     agentCard?: string | undefined;
     agentSkillsIndex: string;
@@ -818,6 +837,7 @@ declare function buildDocsAgentDiscoverySpec({
     endpoint: string;
     agentEndpoint: string;
     structuredAgentEndpoint: string;
+    facetsEndpoint: string;
     method: string;
     queryParam: string;
     localeParam: string;
@@ -826,7 +846,9 @@ declare function buildDocsAgentDiscoverySpec({
     supportedAudiences: string[];
     responseParam: string;
     structuredResponseValue: string;
+    facetsResponseValue: string;
     responseFormat: string;
+    facetsResponseFormat: string;
     filterParams: {
       framework: string;
       version: string;
@@ -835,11 +857,30 @@ declare function buildDocsAgentDiscoverySpec({
     };
     repeatedFilterParams: string[];
     warningsField: string;
+    facetParam: string;
+    limitParam: string;
     cursorParam: string;
     nextCursorField: string;
     hasMoreField: string;
     totalField: string;
   };
+  contentChanges: {
+    enabled: boolean;
+    endpoint: string | null;
+    method: string;
+    audienceParam: string;
+    defaultAudience: string;
+    supportedAudiences: string[];
+    responseParam: string;
+    responseValue: string;
+    sinceParam: string;
+    format: string;
+    generationField: string;
+    resetRequiredField: string;
+    modes: string[];
+    bodyFree: boolean;
+    etag: boolean;
+  };
   agents: {
     enabled: boolean;
     file: string;
@@ -911,6 +952,7 @@ declare function buildDocsAgentDiscoverySpec({
       listTasks?: boolean;
       readTask?: boolean;
       searchDocs: boolean;
+      searchFacets?: boolean;
       getNavigation: boolean;
       getCodeExamples: boolean;
       getConfigSchema: boolean;

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

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

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

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

package/dist/{agent-export-CM-p9_YD.mjs → agent-export-DdF-IVfg.mjs}

@@ -1,11 +1,11 @@
-import { A as buildDocsAgentDiscoverySpec, Bt as renderDocsSitemapMarkdown, Ht as resolveDocsSitemapConfig, Lt as buildDocsSitemapManifest, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, Vt as renderDocsSitemapXml, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsLlmsTxt, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-SRIJ-oF8.mjs";
+import { A as buildDocsAgentDiscoverySpec, Ft as renderDocsSitemapXml, It as resolveDocsSitemapConfig, Pt as renderDocsSitemapMarkdown, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as renderDocsMarkdownDocument, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, it as renderDocsLlmsTxt, jt as buildDocsSitemapManifest, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, lt as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, wt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-Ba94vwM2.mjs";
 import "./markdown-sections-7OoA7ylx.mjs";
 import { A as buildDocsLegacySkillsIndex, D as buildDocsA2AAgentCard, L as resolveDocsPublishedAgentSkill, O as buildDocsAgentSkillsIndex, a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-BKlEnK_H.mjs";
-import "./search-Da2AKaFJ.mjs";
+import "./agent-provenance-D8UBpnMc.mjs";
 import { t as resolveDocsI18n } from "./i18n-hHVWcflJ.mjs";
-import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-CgH6Stqn.mjs";
-import "./sitemap-server-DHaxyPAd.mjs";
-import "./agent-evals-DmFoKy_y.mjs";
+import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-C_v2HK43.mjs";
+import "./sitemap-server-Dgxs9V6S.mjs";
+import "./agent-evals-C8dkgJMN.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
 import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-B2EXn2QD.mjs";
@@ -697,6 +697,7 @@ async function exportAgentBundle(options = {}) {
 		apiRoute: config?.cloud?.apiRoute,
 		apiCatalog: false,
 		search: false,
+		contentChanges: false,
 		mcp,
 		feedback,
 		llms,

package/dist/agent-provenance-D8UBpnMc.mjs

@@ -0,0 +1,463 @@
+import { G as isDocsAgentDiscoveryRequest, K as isDocsAgentsRequest, Kt as isDocsContentChangesRequest, Q as isDocsSkillRequest, _t as resolveDocsMarkdownRequest, dt as resolveDocsAgentsFormat, lt as resolveDocsAgentFeedbackConfig, pt as resolveDocsLlmsTxtRequest, qt as resolveDocsContentChangesConfig, ut as resolveDocsAgentFeedbackRequest, xt as resolveDocsSkillFormat } from "./agent-Ba94vwM2.mjs";
+
+//#region src/telemetry.ts
+const DOCS_PACKAGE_NAME = "@farming-labs/docs";
+const DOCS_PACKAGE_VERSION = "0.2.25";
+const DEFAULT_DOCS_TELEMETRY_ENDPOINT = "https://docs.farming-labs.dev/api/telemetry/events";
+const PROJECT_TELEMETRY_CACHE_TTL_MS = 1440 * 60 * 1e3;
+const PROJECT_TELEMETRY_CACHE_MAX_KEYS = 256;
+function getRuntimeEnv() {
+	if (typeof process === "undefined" || !process.env) return;
+	return process.env;
+}
+function readRuntimeEnv(name) {
+	const value = getRuntimeEnv()?.[name]?.trim();
+	return value ? value : void 0;
+}
+function isTruthyEnv(value) {
+	return /^(1|true|yes|on)$/i.test(value ?? "");
+}
+function isFalsyEnv(value) {
+	return /^(0|false|no|off)$/i.test(value ?? "");
+}
+function isBrowserRuntime() {
+	return typeof window !== "undefined" && typeof document !== "undefined";
+}
+function isProductionTelemetryRuntime() {
+	if (isBrowserRuntime()) return false;
+	const env = getRuntimeEnv();
+	if (!env) return true;
+	if (env.NODE_ENV === "test") return false;
+	if (env.VERCEL_ENV === "production") return true;
+	if (env.CONTEXT === "production" && isTruthyEnv(env.NETLIFY)) return true;
+	if (isTruthyEnv(env.CF_PAGES)) return true;
+	if (env.RENDER_SERVICE_ID || env.FLY_APP_NAME || env.RAILWAY_ENVIRONMENT) return true;
+	return env.NODE_ENV === "production";
+}
+function resolveDocsTelemetryConfig(telemetry) {
+	const envToggle = readRuntimeEnv("DOCS_TELEMETRY");
+	const envDisabled = readRuntimeEnv("DOCS_TELEMETRY_DISABLED");
+	if (isFalsyEnv(envToggle) || isTruthyEnv(envDisabled) || telemetry === false) return { enabled: false };
+	const objectConfig = telemetry && typeof telemetry === "object" ? telemetry : void 0;
+	if (objectConfig?.enabled === false) return { enabled: false };
+	return {
+		enabled: telemetry === true || objectConfig?.enabled === true || isTruthyEnv(envToggle) || isProductionTelemetryRuntime(),
+		endpoint: objectConfig?.endpoint?.trim() || readRuntimeEnv("DOCS_TELEMETRY_ENDPOINT") || DEFAULT_DOCS_TELEMETRY_ENDPOINT
+	};
+}
+function readRequestOrigin(request) {
+	if (!request?.url) return void 0;
+	try {
+		return new URL(request.url).origin;
+	} catch {
+		return;
+	}
+}
+/** Normalize an HTTP(S) telemetry site value to its origin. */
+function normalizeDocsTelemetryOrigin(candidate) {
+	if (typeof candidate !== "string") return void 0;
+	const trimmed = candidate.trim();
+	if (!trimmed) return void 0;
+	try {
+		const hasScheme = /^[a-z][a-z\d+.-]*:(?!\d)/i.test(trimmed);
+		const url = new URL(hasScheme ? trimmed : `https://${trimmed}`);
+		if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
+		return url.origin;
+	} catch {
+		return;
+	}
+}
+/** Return whether a telemetry origin points at a local development server. */
+function isLocalDocsTelemetryOrigin(candidate) {
+	const origin = normalizeDocsTelemetryOrigin(candidate);
+	if (!origin) return false;
+	const hostname = new URL(origin).hostname.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.+$/, "");
+	if ([
+		"localhost",
+		"localhost.localdomain",
+		"localhost6",
+		"localhost6.localdomain6",
+		"ip6-localhost",
+		"ip6-loopback"
+	].includes(hostname) || hostname.endsWith(".localhost")) return true;
+	if (hostname === "::" || hostname === "::1") return true;
+	const ipv4 = hostname.split(".").map((part) => Number(part));
+	if (ipv4.length === 4 && ipv4.every((part) => Number.isInteger(part) && part >= 0 && part <= 255)) return ipv4[0] === 127 || ipv4.every((part) => part === 0);
+	return /^::ffff:7f[0-9a-f]{2}:/.test(hostname) || hostname === "::ffff:0:0";
+}
+function isBlockedDocsTelemetryOrigin(candidate) {
+	if (candidate === void 0) return false;
+	return !normalizeDocsTelemetryOrigin(candidate) || isLocalDocsTelemetryOrigin(candidate);
+}
+function readDeploymentOrigin() {
+	const candidates = [
+		readRuntimeEnv("DOCS_SITE_URL"),
+		readRuntimeEnv("NEXT_PUBLIC_BASE_URL"),
+		readRuntimeEnv("NEXT_PUBLIC_SITE_URL"),
+		readRuntimeEnv("SITE_URL"),
+		readRuntimeEnv("URL"),
+		readRuntimeEnv("CF_PAGES_URL"),
+		readRuntimeEnv("VERCEL_PROJECT_PRODUCTION_URL"),
+		readRuntimeEnv("VERCEL_URL"),
+		readRuntimeEnv("DEPLOY_PRIME_URL")
+	];
+	for (const candidate of candidates) {
+		const origin = normalizeDocsTelemetryOrigin(candidate);
+		if (origin) return origin;
+	}
+}
+function detectDeployment() {
+	const env = getRuntimeEnv();
+	if (!env) return void 0;
+	if (env.VERCEL || env.VERCEL_ENV) return {
+		provider: "vercel",
+		environment: env.VERCEL_ENV,
+		id: env.VERCEL_DEPLOYMENT_ID ?? env.VERCEL_GIT_COMMIT_SHA,
+		region: env.VERCEL_REGION
+	};
+	if (env.NETLIFY) return {
+		provider: "netlify",
+		environment: env.CONTEXT,
+		id: env.DEPLOY_ID ?? env.COMMIT_REF
+	};
+	if (env.CF_PAGES) return {
+		provider: "cloudflare-pages",
+		environment: env.CF_PAGES_BRANCH,
+		id: env.CF_PAGES_COMMIT_SHA
+	};
+	if (env.RENDER_SERVICE_ID) return {
+		provider: "render",
+		environment: env.RENDER_ENV,
+		id: env.RENDER_SERVICE_ID
+	};
+	if (env.FLY_APP_NAME) return {
+		provider: "fly",
+		environment: env.FLY_APP_NAME,
+		id: env.FLY_ALLOC_ID,
+		region: env.FLY_REGION
+	};
+	if (env.RAILWAY_ENVIRONMENT) return {
+		provider: "railway",
+		environment: env.RAILWAY_ENVIRONMENT,
+		id: env.RAILWAY_DEPLOYMENT_ID
+	};
+	return env.NODE_ENV === "production" ? { environment: "production" } : void 0;
+}
+function detectRuntime() {
+	if (typeof process !== "undefined" && process.versions?.node) return {
+		name: "node",
+		version: process.versions.node
+	};
+	if (typeof navigator !== "undefined" && navigator.userAgent) return { name: "web-standard" };
+}
+function isObjectConfigEnabled(value, defaultEnabled) {
+	if (value === false) return false;
+	if (value === true) return true;
+	if (value && typeof value === "object" && !Array.isArray(value)) {
+		const enabled = value.enabled;
+		return enabled === false ? false : defaultEnabled || enabled === true;
+	}
+	return defaultEnabled;
+}
+function hasObjectConfig(value) {
+	return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function getDocsTelemetryFeatures(config) {
+	const pageActions = config.pageActions;
+	const feedback = config.feedback;
+	return {
+		search: isObjectConfigEnabled(config.search, true),
+		contentChanges: resolveDocsContentChangesConfig(config.agent?.contentChanges, { staticExport: config.staticExport === true }).enabled,
+		ai: isObjectConfigEnabled(config.ai, false),
+		mcp: isObjectConfigEnabled(config.mcp, true),
+		llmsTxt: isObjectConfigEnabled(config.llmsTxt, true),
+		pageActions: hasObjectConfig(pageActions),
+		feedback: feedback === true || hasObjectConfig(feedback) && feedback.enabled !== false,
+		agentFeedback: feedback !== false && !(hasObjectConfig(feedback) && feedback.agent === false) && !(hasObjectConfig(feedback) && hasObjectConfig(feedback.agent) && feedback.agent.enabled === false),
+		sitemap: isObjectConfigEnabled(config.sitemap, true),
+		robots: isObjectConfigEnabled(config.robots, true),
+		apiReference: isObjectConfigEnabled(config.apiReference, false),
+		staticExport: config.staticExport === true,
+		changelog: isObjectConfigEnabled(config.changelog, false),
+		cloud: typeof config.cloud !== "undefined" && isObjectConfigEnabled(config.cloud, true),
+		review: isObjectConfigEnabled(config.review, true),
+		codeBlocksValidate: hasObjectConfig(config.codeBlocks) && Boolean(config.codeBlocks.validate)
+	};
+}
+function createDocsTelemetryEvent(config, input, context = {}) {
+	const telemetryConfig = config.telemetry && typeof config.telemetry === "object" ? config.telemetry : void 0;
+	const siteOriginCandidates = [
+		context.siteOrigin,
+		input.site?.origin,
+		telemetryConfig?.siteOrigin,
+		readRequestOrigin(context.request),
+		readDeploymentOrigin()
+	];
+	if (siteOriginCandidates.some(isBlockedDocsTelemetryOrigin)) return void 0;
+	const siteOrigin = siteOriginCandidates.map(normalizeDocsTelemetryOrigin).find((origin) => Boolean(origin));
+	const deployment = input.deployment ?? detectDeployment();
+	const properties = context.properties || input.properties ? {
+		...input.properties,
+		...context.properties
+	} : void 0;
+	return {
+		...input,
+		timestamp: input.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+		package: {
+			name: DOCS_PACKAGE_NAME,
+			version: DOCS_PACKAGE_VERSION,
+			...input.package
+		},
+		framework: input.framework ?? context.framework,
+		runtime: input.runtime ?? detectRuntime(),
+		site: siteOrigin ? { origin: siteOrigin } : input.site,
+		deployment,
+		features: input.features ?? getDocsTelemetryFeatures(config),
+		properties
+	};
+}
+function projectEventKey(event) {
+	return [
+		event.package.name,
+		event.package.version,
+		event.framework ?? "",
+		event.site?.origin ?? "",
+		event.deployment?.provider ?? "",
+		event.deployment?.environment ?? "",
+		event.deployment?.id ?? ""
+	].join("|");
+}
+function getSentProjectKeys() {
+	const globalValue = globalThis;
+	globalValue.__farmingLabsDocsTelemetryProjectKeys__ ??= /* @__PURE__ */ new Map();
+	return globalValue.__farmingLabsDocsTelemetryProjectKeys__;
+}
+function pruneSentProjectKeys(sent, now) {
+	for (const [key, expiresAt] of sent) if (expiresAt <= now) sent.delete(key);
+	while (sent.size >= PROJECT_TELEMETRY_CACHE_MAX_KEYS) {
+		const oldestKey = sent.keys().next().value;
+		if (!oldestKey) return;
+		sent.delete(oldestKey);
+	}
+}
+async function emitDocsTelemetryEvent(telemetry, event) {
+	const resolved = resolveDocsTelemetryConfig(telemetry);
+	const eventSiteOrigin = event.site?.origin;
+	const normalizedSiteOrigin = normalizeDocsTelemetryOrigin(eventSiteOrigin);
+	if (!resolved.enabled || !resolved.endpoint || typeof fetch !== "function" || eventSiteOrigin !== void 0 && (!normalizedSiteOrigin || isLocalDocsTelemetryOrigin(eventSiteOrigin))) return;
+	const eventToSend = normalizedSiteOrigin ? {
+		...event,
+		site: { origin: normalizedSiteOrigin }
+	} : event;
+	try {
+		const ingestKey = readRuntimeEnv("DOCS_TELEMETRY_INGEST_KEY");
+		const headers = { "content-type": "application/json" };
+		if (ingestKey) headers["x-docs-telemetry-key"] = ingestKey;
+		await fetch(resolved.endpoint, {
+			method: "POST",
+			headers,
+			body: JSON.stringify({ event: eventToSend }),
+			keepalive: true
+		});
+	} catch {}
+}
+function emitDocsTelemetryProjectEvent(config, context = {}) {
+	const event = createDocsTelemetryEvent(config, { type: "project_detected" }, context);
+	if (!event) return;
+	const key = projectEventKey(event);
+	const sent = getSentProjectKeys();
+	const now = Date.now();
+	const expiresAt = sent.get(key);
+	if (expiresAt && expiresAt > now) return;
+	if (typeof expiresAt === "number") sent.delete(key);
+	pruneSentProjectKeys(sent, now);
+	sent.set(key, now + PROJECT_TELEMETRY_CACHE_TTL_MS);
+	emitDocsTelemetryEvent(config.telemetry, event);
+}
+function emitDocsTelemetryAgentSurfaceEvent(config, context) {
+	const event = createDocsTelemetryEvent(config, {
+		type: context.surface === "mcp" ? "mcp_request" : "agent_surface_used",
+		properties: { surface: context.surface }
+	}, context);
+	if (!event) return;
+	emitDocsTelemetryEvent(config.telemetry, event);
+}
+function emitDocsTelemetryMcpToolEvent(config, context) {
+	const event = createDocsTelemetryEvent(config, {
+		type: "mcp_tool_used",
+		properties: {
+			tool: context.tool,
+			locale: context.locale,
+			resultCount: context.resultCount
+		}
+	}, context);
+	if (!event) return;
+	emitDocsTelemetryEvent(config.telemetry, event);
+}
+function inferDocsTelemetryAgentSurface(request, options) {
+	const url = new URL(request.url);
+	const method = request.method.toUpperCase();
+	const feedbackRequest = resolveDocsAgentFeedbackRequest(url, resolveDocsAgentFeedbackConfig(options.feedback));
+	if ((method === "GET" || method === "HEAD") && isDocsAgentDiscoveryRequest(url)) return "agent_spec";
+	if ((method === "GET" || method === "HEAD") && feedbackRequest?.kind === "schema") return "agent_feedback_schema";
+	if (method === "POST" && feedbackRequest?.kind === "submit") return "agent_feedback_submit";
+	if (method === "GET" || method === "HEAD") {
+		if (isDocsContentChangesRequest(url)) return "content_changes";
+		if (isDocsAgentsRequest(url) || resolveDocsAgentsFormat(url) === "agents") return "agents";
+		if (isDocsSkillRequest(url) || resolveDocsSkillFormat(url) === "skill") return "skill";
+		if (resolveDocsMarkdownRequest(options.entry, url, request)) return "markdown";
+		if (resolveDocsLlmsTxtRequest(url, options.llmsTxt, options.entry)) return "llms";
+	}
+	if (method === "POST") return "ask_ai";
+}
+
+//#endregion
+//#region src/sidebar.ts
+function resolvePageSidebarFolderIndexBehavior(sidebar) {
+	if (!sidebar || typeof sidebar !== "object") return void 0;
+	const value = sidebar.folderIndexBehavior;
+	return value === "link" || value === "toggle" || value === "hidden" ? value : void 0;
+}
+function normalizeSidebarFolderBehaviorPath(path) {
+	if (!path) return void 0;
+	let value = path.trim();
+	if (!value) return void 0;
+	if (/^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(value)) try {
+		value = new URL(value).pathname;
+	} catch {
+		return;
+	}
+	else value = value.split("#", 1)[0]?.split("?", 1)[0] ?? value;
+	if (!value.startsWith("/")) value = `/${value}`;
+	return value.replace(/\/$/, "") || "/";
+}
+function resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior = "link") {
+	if (sidebar === void 0 || sidebar === true || sidebar === false) return defaultBehavior;
+	if (sidebar.folderIndexBehavior === "toggle") return "toggle";
+	if (sidebar.folderIndexBehavior === "hidden") return "hidden";
+	if (sidebar.folderIndexBehavior === "link") return "link";
+	return defaultBehavior;
+}
+function resolveSidebarFolderIndexBehaviorForPath(sidebar, folderPath, defaultBehavior = "link") {
+	const fallback = resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior);
+	if (!sidebar || typeof sidebar !== "object") return fallback;
+	const normalizedPath = normalizeSidebarFolderBehaviorPath(folderPath);
+	if (!normalizedPath) return fallback;
+	for (const [rawPath, override] of Object.entries(sidebar.folderIndexBehaviorOverrides ?? {})) if (normalizeSidebarFolderBehaviorPath(rawPath) === normalizedPath) return override === "link" || override === "toggle" || override === "hidden" ? override : fallback;
+	return fallback;
+}
+function applySidebarFolderIndexBehavior(tree, behaviorOrOptions) {
+	const resolveBehavior = typeof behaviorOrOptions === "string" ? () => behaviorOrOptions : (folderPath) => resolveSidebarFolderIndexBehaviorForPath(behaviorOrOptions.sidebar, folderPath, behaviorOrOptions.defaultBehavior);
+	function mapNode(node) {
+		if (!node || typeof node !== "object") return node;
+		const candidate = node;
+		if (candidate.type !== "folder" || !Array.isArray(candidate.children)) return node;
+		const children = candidate.children.map(mapNode);
+		const index = candidate.index ? mapNode(candidate.index) : void 0;
+		const folderPath = (typeof candidate.url === "string" ? candidate.url : void 0) || (candidate.index && typeof candidate.index === "object" && "url" in candidate.index && typeof candidate.index.url === "string" ? candidate.index.url ?? void 0 : void 0);
+		const behavior = (candidate.folderIndexBehavior === "link" || candidate.folderIndexBehavior === "toggle" || candidate.folderIndexBehavior === "hidden" ? candidate.folderIndexBehavior : void 0) ?? resolveBehavior(folderPath);
+		if (behavior === "link") return {
+			...candidate,
+			folderIndexBehavior: void 0,
+			index,
+			children
+		};
+		if (behavior === "hidden") return {
+			...candidate,
+			folderIndexBehavior: void 0,
+			index: void 0,
+			url: void 0,
+			children
+		};
+		return {
+			...candidate,
+			folderIndexBehavior: void 0,
+			index: void 0,
+			url: void 0,
+			children: index ? [index, ...children] : children
+		};
+	}
+	return {
+		...tree,
+		children: tree.children.map(mapNode)
+	};
+}
+
+//#endregion
+//#region src/agent-provenance.ts
+const GENERATED_AGENT_PROVENANCE_MARKER = "@farming-labs/docs:generated";
+const GENERATED_AGENT_PROVENANCE_VERSION = 1;
+function normalizeLineEndings(value) {
+	return value.replace(/\r\n?/g, "\n").replace(/^\uFEFF/, "");
+}
+function normalizeGeneratedAgentContent(value) {
+	return normalizeLineEndings(value).trimEnd();
+}
+function hashGeneratedAgentContent(value) {
+	const normalized = normalizeGeneratedAgentContent(value);
+	const bytes = new TextEncoder().encode(normalized);
+	let hash = 14695981039346656037n;
+	for (const byte of bytes) {
+		hash ^= BigInt(byte);
+		hash = BigInt.asUintN(64, hash * 1099511628211n);
+	}
+	return `fnv1a64:${hash.toString(16).padStart(16, "0")}`;
+}
+function parseProvenanceBlock(rawBlock) {
+	const entries = /* @__PURE__ */ new Map();
+	for (const line of rawBlock.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed) continue;
+		const separatorIndex = trimmed.indexOf("=");
+		if (separatorIndex <= 0) continue;
+		const key = trimmed.slice(0, separatorIndex).trim();
+		const value = trimmed.slice(separatorIndex + 1).trim();
+		if (!key || !value) continue;
+		entries.set(key, value);
+	}
+	const version = Number.parseInt(entries.get("version") ?? "", 10);
+	const sourceKind = entries.get("sourceKind");
+	const sourceHash = entries.get("sourceHash");
+	const settingsHash = entries.get("settingsHash");
+	const outputHash = entries.get("outputHash");
+	const generatedAt = entries.get("generatedAt");
+	if (!Number.isFinite(version) || sourceKind !== "resolved-page" && sourceKind !== "agent-md" || !sourceHash || !settingsHash || !outputHash || !generatedAt) return;
+	return {
+		version,
+		sourceKind,
+		sourceHash,
+		settingsHash,
+		outputHash,
+		generatedAt
+	};
+}
+function parseGeneratedAgentDocument(raw) {
+	const normalized = normalizeLineEndings(raw);
+	const headerPattern = new RegExp(`^<!-- ${GENERATED_AGENT_PROVENANCE_MARKER}\\n([\\s\\S]*?)\\n-->\\n?`);
+	const match = normalized.match(headerPattern);
+	if (!match) return { content: normalized };
+	return {
+		provenance: parseProvenanceBlock(match[1]),
+		content: normalized.slice(match[0].length)
+	};
+}
+function stripGeneratedAgentProvenance(raw) {
+	return parseGeneratedAgentDocument(raw).content;
+}
+function serializeGeneratedAgentDocument(content, provenance) {
+	const normalizedContent = normalizeGeneratedAgentContent(content);
+	return `${[
+		`<!-- ${GENERATED_AGENT_PROVENANCE_MARKER}`,
+		`version=${provenance.version}`,
+		`sourceKind=${provenance.sourceKind}`,
+		`sourceHash=${provenance.sourceHash}`,
+		`settingsHash=${provenance.settingsHash}`,
+		`outputHash=${provenance.outputHash}`,
+		`generatedAt=${provenance.generatedAt}`,
+		"-->",
+		normalizedContent
+	].join("\n")}\n`;
+}
+
+//#endregion
+export { inferDocsTelemetryAgentSurface as _, parseGeneratedAgentDocument as a, resolveDocsTelemetryConfig as b, applySidebarFolderIndexBehavior as c, resolveSidebarFolderIndexBehaviorForPath as d, emitDocsTelemetryAgentSurfaceEvent as f, getDocsTelemetryFeatures as g, emitDocsTelemetryProjectEvent as h, normalizeGeneratedAgentContent as i, resolvePageSidebarFolderIndexBehavior as l, emitDocsTelemetryMcpToolEvent as m, GENERATED_AGENT_PROVENANCE_VERSION as n, serializeGeneratedAgentDocument as o, emitDocsTelemetryEvent as p, hashGeneratedAgentContent as r, stripGeneratedAgentProvenance as s, GENERATED_AGENT_PROVENANCE_MARKER as t, resolveSidebarFolderIndexBehavior as u, isLocalDocsTelemetryOrigin as v, normalizeDocsTelemetryOrigin as y };

package/dist/agent-skills-bundle.d.mts

@@ -1,4 +1,4 @@
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-BbslY4id.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-BWyNgZSs.mjs";
 
 //#region src/agent-skills-bundle.d.ts
 /**

package/dist/{agent-skills-server-CJ4D0G9P.d.mts → agent-skills-server-zvs0Yknt.d.mts}

@@ -1,5 +1,5 @@
-import { $ as DocsAgentSkillsInput } from "./types-B-5Kzmkn.mjs";
-import { z as DocsPublishedAgentSkill } from "./standards-discovery-BbslY4id.mjs";
+import { et as DocsAgentSkillsInput } from "./types-CpLnwHak.mjs";
+import { z as DocsPublishedAgentSkill } from "./standards-discovery-BWyNgZSs.mjs";
 
 //#region src/agent-skills-server.d.ts
 interface ResolveConfiguredAgentSkillsOptions {