@farming-labs/docs 0.2.120 → 0.2.122

package/dist/client/react.d.mts

@@ -1,23 +1,7 @@
-import { vt as DocsAnalyticsConfig } from "../types-BJFeMXWZ.mjs";
+import { DocsAnalyticsConfig } from "../types.mjs";
+import { DocsCloudClientOptions, DocsCloudClientRuntimeValue } from "../docs-cloud-client.mjs";
 import { ReactNode } from "react";
 
-//#region src/docs-cloud-client.d.ts
-type DocsCloudClientRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);
-type DocsCloudClientRuntimeEnv = Record<string, string | undefined> | (() => Record<string, string | undefined>);
-interface DocsCloudClientOptions {
-  projectId?: DocsCloudClientRuntimeValue;
-  endpoint?: DocsCloudClientRuntimeValue;
-  analyticsEndpoint?: DocsCloudClientRuntimeValue;
-  apiBaseUrl?: DocsCloudClientRuntimeValue;
-  analyticsKey?: DocsCloudClientRuntimeValue;
-  enabled?: DocsCloudClientRuntimeValue<boolean | string>;
-  includeInputs?: DocsCloudClientRuntimeValue<boolean>;
-  env?: DocsCloudClientRuntimeEnv;
-  fetch?: typeof fetch;
-  metadata?: Record<string, unknown>;
-  properties?: Record<string, unknown>;
-}
-//#endregion
 //#region src/client/react.d.ts
 interface DocsCloudAnalyticsProps extends DocsCloudClientOptions {
   analytics?: boolean | DocsAnalyticsConfig;

package/dist/client/react.mjs

@@ -1,164 +1,8 @@
 "use client";
 
-import { n as sendDocsCloudAnalyticsEvent } from "../cloud-analytics-D14HplI7.mjs";
+import { createDocsCloudClient } from "../docs-cloud-client.mjs";
 import { useEffect } from "react";
 
-//#region src/docs-cloud-client.ts
-const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";
-const DOCS_CLOUD_PROJECT_ID_ENVS = [
-	"NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID",
-	"PUBLIC_DOCS_CLOUD_PROJECT_ID",
-	"DOCS_CLOUD_PROJECT_ID"
-];
-const DOCS_CLOUD_API_BASE_URL_ENVS = [
-	"NEXT_PUBLIC_DOCS_CLOUD_URL",
-	"PUBLIC_DOCS_CLOUD_URL",
-	"DOCS_CLOUD_API_BASE_URL",
-	"DOCS_CLOUD_API_URL"
-];
-const DOCS_CLOUD_ANALYTICS_ENDPOINT_ENVS = [
-	"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT",
-	"PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT",
-	"DOCS_CLOUD_ANALYTICS_ENDPOINT"
-];
-const DOCS_CLOUD_ANALYTICS_ENABLED_ENVS = [
-	"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED",
-	"PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED",
-	"DOCS_CLOUD_ANALYTICS_ENABLED"
-];
-const DOCS_CLOUD_ANALYTICS_KEY_ENVS = [
-	"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY",
-	"PUBLIC_DOCS_CLOUD_ANALYTICS_KEY",
-	"DOCS_CLOUD_ANALYTICS_KEY"
-];
-function normalizeRuntimeString(value) {
-	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
-}
-function resolveRuntimeValue(value) {
-	return (typeof value === "function" ? value() : value) ?? void 0;
-}
-function resolveRuntimeString(value) {
-	return normalizeRuntimeString(resolveRuntimeValue(value));
-}
-function resolveRuntimeEnv(env) {
-	return typeof env === "function" ? env() : env ?? {};
-}
-function readProcessEnv(name) {
-	if (typeof process === "undefined") return void 0;
-	if (!process.env) return void 0;
-	switch (name) {
-		case "NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID);
-		case "NEXT_PUBLIC_DOCS_CLOUD_URL": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_URL);
-		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT);
-		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED);
-		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY);
-		default: return;
-	}
-}
-function readEnv(name, env) {
-	return normalizeRuntimeString(env[name]) ?? readProcessEnv(name);
-}
-function readFirstEnv(names, env) {
-	for (const name of names) {
-		const value = readEnv(name, env);
-		if (value) return value;
-	}
-}
-function isFalsy(value) {
-	if (value === false) return true;
-	if (typeof value !== "string") return false;
-	return /^(0|false|no|off)$/i.test(value.trim());
-}
-function stripTrailingSlash(value) {
-	return value.replace(/\/+$/, "");
-}
-function mergeRecords(...records) {
-	const merged = {};
-	for (const record of records) {
-		if (!record) continue;
-		Object.assign(merged, record);
-	}
-	return Object.keys(merged).length > 0 ? merged : void 0;
-}
-function getBrowserLocation() {
-	return typeof window !== "undefined" ? window.location : void 0;
-}
-function getBrowserReferrer() {
-	if (typeof document === "undefined") return void 0;
-	return document.referrer || void 0;
-}
-function createDocsCloudClient(options = {}) {
-	function env() {
-		return resolveRuntimeEnv(options.env);
-	}
-	function projectId() {
-		const runtimeEnv = env();
-		return resolveRuntimeString(options.projectId) ?? readFirstEnv(DOCS_CLOUD_PROJECT_ID_ENVS, runtimeEnv);
-	}
-	function apiBaseUrl() {
-		const runtimeEnv = env();
-		return stripTrailingSlash(resolveRuntimeString(options.apiBaseUrl) ?? readFirstEnv(DOCS_CLOUD_API_BASE_URL_ENVS, runtimeEnv) ?? DEFAULT_DOCS_CLOUD_API_BASE_URL);
-	}
-	function endpoint() {
-		const runtimeEnv = env();
-		return resolveRuntimeString(options.endpoint) ?? resolveRuntimeString(options.analyticsEndpoint) ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_ENDPOINT_ENVS, runtimeEnv) ?? `${apiBaseUrl()}/v1/analytics/events`;
-	}
-	function analyticsKey() {
-		const runtimeEnv = env();
-		return resolveRuntimeString(options.analyticsKey) ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_KEY_ENVS, runtimeEnv);
-	}
-	function enabled() {
-		const runtimeEnv = env();
-		return !isFalsy(resolveRuntimeValue(options.enabled) ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_ENABLED_ENVS, runtimeEnv));
-	}
-	function includeInputs() {
-		return resolveRuntimeValue(options.includeInputs) === true;
-	}
-	function getConfig() {
-		const id = projectId();
-		return {
-			enabled: enabled(),
-			configured: Boolean(id),
-			...id ? { projectId: id } : {},
-			endpoint: endpoint()
-		};
-	}
-	async function trackEvent(event, trackOptions = {}) {
-		const config = getConfig();
-		if (!config.enabled || !config.projectId) return false;
-		const location = getBrowserLocation();
-		const normalized = {
-			...event,
-			source: event.source ?? "client",
-			timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
-			url: event.url ?? location?.href,
-			path: event.path ?? location?.pathname,
-			referrer: event.referrer ?? getBrowserReferrer(),
-			locale: event.locale ?? trackOptions.locale,
-			metadata: mergeRecords(options.metadata, trackOptions.metadata, event.metadata),
-			properties: mergeRecords(options.properties, trackOptions.properties, event.properties)
-		};
-		if (!includeInputs()) delete normalized.input;
-		await sendDocsCloudAnalyticsEvent({
-			endpoint: config.endpoint,
-			projectId: config.projectId,
-			apiKey: analyticsKey(),
-			fetch: options.fetch
-		}, normalized);
-		return true;
-	}
-	return {
-		analytics: { track: trackEvent },
-		trackEvent,
-		getConfig,
-		isConfigured() {
-			const config = getConfig();
-			return config.enabled && config.configured;
-		}
-	};
-}
-
-//#endregion
 //#region src/client/react.ts
 function isDocsCloudAnalyticsDisabled(analytics, enabled) {
 	return Boolean(enabled === false || analytics === false || analytics && typeof analytics === "object" && (analytics.enabled === false || analytics.cloud === false));

package/dist/{cloud-analytics-D14HplI7.mjs → cloud-analytics.mjs}

@@ -129,4 +129,4 @@ async function sendDocsCloudAnalyticsEvent(options, event) {
 }
 
 //#endregion
-export { sendDocsCloudAnalyticsEvent as n, resolveDocsCloudAnalyticsOptions as t };
+export { resolveDocsCloudAnalyticsOptions, sendDocsCloudAnalyticsEvent };

package/dist/{cloud-ask-ai-BrsTXQf6.d.mts → cloud-ask-ai.d.mts}

@@ -1,4 +1,4 @@
-import { Mt as DocsCloudConfig, t as AIConfig, vt as DocsAnalyticsConfig } from "./types-BJFeMXWZ.mjs";
+import { AIConfig, DocsAnalyticsConfig, DocsCloudConfig } from "./types.mjs";
 
 //#region src/cloud-ask-ai.d.ts
 interface DocsCloudAskAIConfig {
@@ -20,4 +20,4 @@ interface DocsCloudAskAIResponseOptions {
 declare function isDocsCloudAskAIProvider(config: Pick<AIConfig, "enabled" | "provider"> | undefined): boolean;
 declare function createDocsCloudAskAIResponse(request: Request, options?: DocsCloudAskAIResponseOptions): Promise<Response>;
 //#endregion
-export { isDocsCloudAskAIProvider as i, DocsCloudAskAIResponseOptions as n, createDocsCloudAskAIResponse as r, DocsCloudAskAIConfig as t };
+export { DocsCloudAskAIConfig, DocsCloudAskAIResponseOptions, createDocsCloudAskAIResponse, isDocsCloudAskAIProvider };

package/dist/{cloud-ask-ai-BqKhjpS5.mjs → cloud-ask-ai.mjs}

@@ -1,5 +1,5 @@
-import { n as readDocsJsonBody } from "./http-body-DkAPk6D5.mjs";
-import { a as emitDocsAnalyticsEvent } from "./analytics-p8Vhhu2P.mjs";
+import { readDocsJsonBody } from "./http-body.mjs";
+import { emitDocsAnalyticsEvent } from "./analytics.mjs";
 
 //#region src/cloud-ask-ai.ts
 const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";
@@ -380,4 +380,4 @@ async function createDocsCloudAskAIResponse(request, options = {}) {
 }
 
 //#endregion
-export { isDocsCloudAskAIProvider as n, createDocsCloudAskAIResponse as t };
+export { createDocsCloudAskAIResponse, isDocsCloudAskAIProvider };

package/dist/code-blocks.d.mts

@@ -0,0 +1,51 @@
+import { DocsCodeBlocksPlannerProvider } from "./types.mjs";
+
+//#region src/code-blocks.d.ts
+interface DocsCodeBlockTarget {
+  id: string;
+  filePath: string;
+  relativePath: string;
+  lineStart: number;
+  lineEnd: number;
+  language?: string;
+  title?: string;
+  framework?: string;
+  packageManager?: string;
+  runnable: boolean;
+  env: string[];
+  meta: Record<string, string | boolean>;
+  code: string;
+}
+interface DocsCodeBlockCommand {
+  cmd: string;
+  args: string[];
+}
+interface DocsCodeBlockExecutionPlan {
+  id: string;
+  target: DocsCodeBlockTarget;
+  action: "execute" | "validate-syntax" | "skip";
+  template: string;
+  runtime?: string;
+  filePath?: string;
+  command?: DocsCodeBlockCommand;
+  requiredEnv: string[];
+  reason?: string;
+  planner: DocsCodeBlocksPlannerProvider;
+}
+type DocsCodeBlockValidationStatus = "PLAN" | "PASS" | "SKIP" | "FAIL";
+interface DocsCodeBlockValidationResult {
+  id: string;
+  target: DocsCodeBlockTarget;
+  plan: DocsCodeBlockExecutionPlan;
+  status: DocsCodeBlockValidationStatus;
+  stdout?: string;
+  stderr?: string;
+  exitCode?: number | null;
+  reason?: string;
+}
+type OptionalModuleImporter = (specifier: string) => Promise<unknown>;
+declare global {
+  var __DOCS_CODE_BLOCKS_MODULE_IMPORTER__: OptionalModuleImporter | undefined;
+}
+//#endregion
+export { DocsCodeBlockValidationResult };

package/dist/{code-blocks-GYdvS3BH.mjs → code-blocks.mjs}

@@ -499,7 +499,7 @@ async function runPlansInVercelSandbox(plans, rootDir, config, env) {
 			await sandbox.stop().catch(() => {});
 		}
 	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
+		const message = error?.code === "ERR_MODULE_NOT_FOUND" && String(error.message).includes("@vercel/sandbox") ? "install \"@vercel/sandbox\" to run code blocks in a Vercel Sandbox" : error instanceof Error ? error.message : String(error);
 		return plans.map((plan) => skippedResult(plan, `vercel-sandbox unavailable: ${message}`));
 	}
 }
@@ -868,4 +868,4 @@ function skippedResult(plan, reason) {
 }
 
 //#endregion
-export { validateCodeBlocks as a, validateCodeBlockPlans as i, planCodeBlockTargets as n, resolveDocsCodeBlocksValidateConfig as r, extractCodeBlocksFromMarkdown as t };
+export { extractCodeBlocksFromMarkdown, planCodeBlockTargets, resolveDocsCodeBlocksValidateConfig, validateCodeBlockPlans, validateCodeBlocks };

package/dist/code-group-mdx.d.mts

@@ -0,0 +1,11 @@
+//#region src/code-group-mdx.d.ts
+interface MarkdownNode {
+  type: string;
+  name?: string;
+  children?: MarkdownNode[];
+  lang?: string | null;
+  meta?: string | null;
+}
+declare function remarkCodeGroup(): (tree: MarkdownNode) => void;
+//#endregion
+export { remarkCodeGroup };

package/dist/code-group-mdx.mjs

@@ -0,0 +1,57 @@
+//#region src/code-group-mdx.ts
+const codeGroupTitleAttributes = [
+	"title",
+	"filename",
+	"file",
+	"name",
+	"label"
+];
+const ignoredBareMetaTokens = new Set([
+	"copy",
+	"no-copy",
+	"nocopy",
+	"line-numbers",
+	"linenumbers",
+	"runnable",
+	"show-line-numbers",
+	"showlinenumbers",
+	"wrap"
+]);
+function escapeMetaAttribute(value) {
+	return value.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+}
+function readCodeGroupTitleAttribute(meta) {
+	for (const name of codeGroupTitleAttributes) {
+		const match = meta.match(new RegExp(`(?:^|\\s)${name}=["']([^"']+)["']`));
+		if (match?.[1]?.trim()) return match[1].trim();
+	}
+}
+function readBareCodeGroupTitle(meta) {
+	return meta.replace(/\{[^}]*\}/g, " ").split(/\s+/).find((part) => part && !part.includes("=") && !ignoredBareMetaTokens.has(part.toLowerCase()))?.replace(/^["']|["']$/g, "");
+}
+function resolveCodeGroupCodeTitle(meta) {
+	const trimmed = meta?.trim();
+	if (!trimmed) return void 0;
+	return readCodeGroupTitleAttribute(trimmed) ?? readBareCodeGroupTitle(trimmed);
+}
+function ensureCodeGroupCodeTitle(node) {
+	const title = resolveCodeGroupCodeTitle(node.meta);
+	if (!title) return;
+	const meta = node.meta?.trim() ?? "";
+	if (/(?:^|\s)title=["']/.test(meta)) return;
+	node.meta = `title="${escapeMetaAttribute(title)}"${meta ? ` ${meta}` : ""}`;
+}
+function visitCodeGroups(node) {
+	if (node.type === "mdxJsxFlowElement" && node.name === "CodeGroup") {
+		for (const child of node.children ?? []) if (child.type === "code") ensureCodeGroupCodeTitle(child);
+	}
+	for (const child of node.children ?? []) visitCodeGroups(child);
+}
+function remarkCodeGroup() {
+	return (tree) => {
+		visitCodeGroups(tree);
+	};
+}
+
+//#endregion
+export { remarkCodeGroup };

package/dist/content-change-hydration.d.mts

@@ -0,0 +1,87 @@
+import { DocsContentChangesResponse, DocsSearchSourcePage } from "./types.mjs";
+
+//#region src/content-change-hydration.d.ts
+declare const DOCS_CONTENT_CHANGE_HYDRATION_FORMAT = "docs-content-change-hydration.v1";
+declare const DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 5000;
+declare const MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 4;
+declare const MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 32000;
+interface DocsContentChangeHydrationSection {
+  id: string;
+  heading: string;
+  level: number;
+}
+interface DocsContentChangeHydrationContent {
+  type: "content";
+  change: "added" | "changed";
+  url: string;
+  canonicalUrl: string;
+  /** Digest from the body-free document change feed. */
+  digest: string;
+  previousDigest?: string;
+  lastModified?: string;
+  previousLastModified?: string;
+  section: DocsContentChangeHydrationSection;
+  /** Digest of the complete, non-overlapping section before chunking. */
+  sectionDigest: string;
+  /** Digest of the content bytes returned in this chunk. */
+  chunkDigest: string;
+  chunk: {
+    index: number;
+    count: number;
+  };
+  content: string;
+  utf8Bytes: number;
+}
+interface DocsContentChangeHydrationTombstone {
+  type: "tombstone";
+  change: "deleted";
+  url: string;
+  canonicalUrl: string;
+  /** Last known digest for the deleted document. */
+  digest: string;
+  lastModified?: string;
+}
+interface DocsContentChangeHydrationBudget {
+  requestedTokens: number;
+  strategy: "utf8-bytes";
+  maxUtf8Bytes: number;
+  usedUtf8Bytes: number;
+  conservativeTokenUpperBound: number;
+  remainingUtf8Bytes: number;
+}
+interface DocsContentChangeHydrationResponse {
+  format: typeof DOCS_CONTENT_CHANGE_HYDRATION_FORMAT;
+  audience: "agent";
+  locale?: string;
+  since: string;
+  indexGeneration: string;
+  mode: DocsContentChangesResponse["mode"];
+  resetRequired: boolean;
+  documentCount: number;
+  counts: DocsContentChangesResponse["counts"];
+  budget: DocsContentChangeHydrationBudget;
+  resultCount: number;
+  total: number;
+  hasMore: boolean;
+  nextCursor?: string;
+  content: DocsContentChangeHydrationContent[];
+  tombstones: DocsContentChangeHydrationTombstone[];
+}
+interface HydrateDocsContentChangesOptions {
+  changes: DocsContentChangesResponse;
+  pages: readonly DocsSearchSourcePage[];
+  since: string;
+  tokenBudget?: number;
+  cursor?: string;
+  /** Stable MCP server identity mixed into opaque continuation cursors. */
+  cursorScope: string;
+}
+/**
+ * Hydrate only the current bodies named by a content-change delta.
+ *
+ * The conservative budget treats one UTF-8 byte as at most one token. Cursors are
+ * bound to the requested generation, current generation, locale, and budget.
+ */
+declare function hydrateDocsContentChanges(options: HydrateDocsContentChangesOptions): DocsContentChangeHydrationResponse;
+//#endregion
+export { DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT, DocsContentChangeHydrationBudget, DocsContentChangeHydrationContent, DocsContentChangeHydrationResponse, DocsContentChangeHydrationSection, DocsContentChangeHydrationTombstone, HydrateDocsContentChangesOptions, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, hydrateDocsContentChanges };

package/dist/{openapi-mcp-BIOTLiA7.mjs → content-change-hydration.mjs}

@@ -1,85 +1,9 @@
-import { s as parseDocsMarkdownSections } from "./markdown-sections-9Oxr33b-.mjs";
-import { In as DocsPaginationCursorError, Ln as createDocsPaginationCursor, tn as buildDocsRetrievalDigestProjection, zn as resolveDocsPaginationOffset } from "./agent-DkAidqtV.mjs";
-import { n as digestDocsRetrievalContent } from "./retrieval-digest-CT-eIEcp.mjs";
-import { n as buildNormalizedOpenApiModel } from "./openapi-operations-DFpaqOqA.mjs";
+import { parseDocsMarkdownSections } from "./markdown-sections.mjs";
+import { digestDocsRetrievalContent } from "./retrieval-digest.mjs";
+import { DocsPaginationCursorError, createDocsPaginationCursor, resolveDocsPaginationOffset } from "./pagination.mjs";
+import { buildDocsRetrievalDigestProjection } from "./search.mjs";
 import matter from "gray-matter";
 
-//#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
 //#region src/content-change-hydration.ts
 const DOCS_CONTENT_CHANGE_HYDRATION_FORMAT = "docs-content-change-hydration.v1";
 const DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET = 5e3;
@@ -294,133 +218,4 @@ function hydrateDocsContentChanges(options) {
 }
 
 //#endregion
-//#region src/openapi-mcp.ts
-const OPENAPI_RATE_WINDOW_MS = 6e4;
-const openApiRateWindows = /* @__PURE__ */ new Map();
-function acquireDocsOpenApiMcpBudget(key, config, now = Date.now()) {
-	const requestsPerMinute = Math.max(1, config.requestsPerMinute ?? 60);
-	const maxConcurrentRequests = Math.max(1, config.maxConcurrentRequests ?? 4);
-	let window = openApiRateWindows.get(key);
-	if (!window || now - window.startedAt >= OPENAPI_RATE_WINDOW_MS) {
-		window = {
-			startedAt: now,
-			count: 0,
-			active: window?.active ?? 0
-		};
-		openApiRateWindows.set(key, window);
-	}
-	if (window.count >= requestsPerMinute) throw new Error("OpenAPI MCP rate limit exceeded for this principal and operation.");
-	if (window.active >= maxConcurrentRequests) throw new Error("OpenAPI MCP concurrency limit exceeded for this principal and operation.");
-	window.count += 1;
-	window.active += 1;
-	let released = false;
-	return () => {
-		if (released) return;
-		released = true;
-		window.active = Math.max(0, window.active - 1);
-	};
-}
-async function readDocsOpenApiMcpResponse(response, maxBytes = 1e6) {
-	const limit = Math.max(1, maxBytes);
-	if (!response.body) return {
-		text: "",
-		truncated: false
-	};
-	const reader = response.body.getReader();
-	const chunks = [];
-	let used = 0;
-	let truncated = false;
-	try {
-		while (true) {
-			const { done, value } = await reader.read();
-			if (done) break;
-			if (used + value.byteLength > limit) {
-				const remaining = limit - used;
-				if (remaining > 0) chunks.push(value.subarray(0, remaining));
-				used = limit;
-				truncated = true;
-				await reader.cancel("OpenAPI MCP response byte limit reached");
-				break;
-			}
-			chunks.push(value);
-			used += value.byteLength;
-		}
-	} finally {
-		reader.releaseLock();
-	}
-	const bytes = new Uint8Array(used);
-	let offset = 0;
-	for (const chunk of chunks) {
-		bytes.set(chunk, offset);
-		offset += chunk.byteLength;
-	}
-	return {
-		text: new TextDecoder().decode(bytes),
-		truncated
-	};
-}
-function asRecord(value) {
-	return value && typeof value === "object" && !Array.isArray(value) ? value : void 0;
-}
-function sanitizeToolName(value) {
-	return `api_${value.trim().replace(/[^a-zA-Z0-9_-]+/g, "_").replace(/^_+|_+$/g, "").slice(0, 56) || "operation"}`;
-}
-function operationExtensionEnabled(operation) {
-	const extension = operation.extensions["x-farming-labs-mcp"];
-	return extension === true || asRecord(extension)?.enabled === true;
-}
-function resolveDocsOpenApiMcpOperations(document, config) {
-	if (!config || config.enabled === false) return [];
-	const allow = new Set((config.operations ?? []).map((value) => value.trim()).filter(Boolean));
-	const model = buildNormalizedOpenApiModel(document);
-	const operations = [];
-	const names = /* @__PURE__ */ new Set();
-	for (const operation of model.operations) {
-		if (operation.method === "TRACE") continue;
-		if (!(allow.has(operation.operationId) || allow.has(operation.selector) || operationExtensionEnabled(operation))) continue;
-		if (![
-			"GET",
-			"HEAD",
-			"OPTIONS"
-		].includes(operation.method) && config.allowMutations !== true) continue;
-		const toolName = sanitizeToolName(operation.operationId);
-		if (names.has(toolName)) throw new Error(`OpenAPI MCP tool name collision: ${toolName}`);
-		names.add(toolName);
-		operations.push({
-			toolName,
-			operationId: operation.operationId,
-			method: operation.method,
-			path: operation.path,
-			title: operation.title,
-			...operation.description ? { description: operation.description } : {},
-			parameters: operation.parameters.flatMap((parameter) => {
-				if (parameter.in !== "path" && parameter.in !== "query" && parameter.in !== "header" && parameter.in !== "cookie") return [];
-				return [{
-					name: parameter.name,
-					in: parameter.in,
-					required: parameter.required
-				}];
-			}),
-			security: operation.security,
-			securitySchemes: operation.securitySchemes,
-			readOnly: operation.method === "GET" || operation.method === "HEAD",
-			destructive: operation.method === "DELETE",
-			idempotent: [
-				"GET",
-				"HEAD",
-				"PUT",
-				"DELETE",
-				"OPTIONS"
-			].includes(operation.method)
-		});
-	}
-	return operations.sort((left, right) => left.toolName.localeCompare(right.toolName));
-}
-function resolveDocsOpenApiMcpBaseUrl(document, config) {
-	const configured = config.baseUrl?.trim();
-	if (configured) return configured;
-	return buildNormalizedOpenApiModel(document).servers[0];
-}
-
-//#endregion
-export { DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as a, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as c, GENERATED_AGENT_PROVENANCE_VERSION as d, hashGeneratedAgentContent as f, stripGeneratedAgentProvenance as g, serializeGeneratedAgentDocument as h, resolveDocsOpenApiMcpOperations as i, hydrateDocsContentChanges as l, parseGeneratedAgentDocument as m, readDocsOpenApiMcpResponse as n, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT as o, normalizeGeneratedAgentContent as p, resolveDocsOpenApiMcpBaseUrl as r, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET as s, acquireDocsOpenApiMcpBudget as t, GENERATED_AGENT_PROVENANCE_MARKER as u };
+export { DEFAULT_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, DOCS_CONTENT_CHANGE_HYDRATION_FORMAT, MAX_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, MIN_DOCS_CONTENT_CHANGE_HYDRATION_TOKEN_BUDGET, hydrateDocsContentChanges };