@farming-labs/docs 0.1.40 → 0.1.42

package/dist/agent-qcweNgy-.mjs

@@ -0,0 +1,588 @@
+import { u as renderDocsRelatedMarkdownLines } from "./search-8oEskRtz.mjs";
+
+//#region src/define-docs.ts
+/**
+* Define docs configuration. Validates and returns the config.
+*/
+function defineDocs(config) {
+	return {
+		entry: config.entry ?? "docs",
+		contentDir: config.contentDir,
+		i18n: config.i18n,
+		theme: config.theme,
+		nav: config.nav,
+		github: config.github,
+		themeToggle: config.themeToggle,
+		breadcrumb: config.breadcrumb,
+		sidebar: config.sidebar,
+		components: config.components,
+		onCopyClick: config.onCopyClick,
+		feedback: config.feedback,
+		search: config.search,
+		mcp: config.mcp,
+		icons: config.icons,
+		pageActions: config.pageActions,
+		lastUpdated: config.lastUpdated,
+		llmsTxt: config.llmsTxt,
+		ai: config.ai,
+		ordering: config.ordering,
+		metadata: config.metadata,
+		og: config.og,
+		changelog: config.changelog,
+		apiReference: config.apiReference,
+		agent: config.agent
+	};
+}
+
+//#endregion
+//#region src/changelog.ts
+function normalizePathSegment(value, fallback) {
+	return (value ?? fallback).trim().replace(/^\/+|\/+$/g, "") || fallback;
+}
+function normalizeContentDir(value) {
+	const trimmed = value?.trim();
+	if (!trimmed) return "changelog";
+	return trimmed.replace(/\/+$/, "") || "changelog";
+}
+function resolveChangelogConfig(value) {
+	if (value === false || value === void 0) return {
+		enabled: false,
+		path: "changelog",
+		contentDir: "changelog",
+		title: "Changelog",
+		description: void 0,
+		search: true
+	};
+	if (value === true) return {
+		enabled: true,
+		path: "changelog",
+		contentDir: "changelog",
+		title: "Changelog",
+		description: void 0,
+		search: true
+	};
+	return {
+		enabled: value.enabled !== false,
+		path: normalizePathSegment(value.path, "changelog"),
+		contentDir: normalizeContentDir(value.contentDir),
+		title: value.title?.trim() || "Changelog",
+		description: value.description?.trim() || void 0,
+		search: value.search !== false,
+		actionsComponent: value.actionsComponent
+	};
+}
+
+//#endregion
+//#region src/utils.ts
+/**
+* Deep merge utility for theme overrides.
+* Merges objects recursively; later values override earlier ones.
+*/
+function deepMerge(target, ...sources) {
+	if (!sources.length) return target;
+	const source = sources.shift();
+	if (!source) return target;
+	const result = { ...target };
+	for (const key of Object.keys(source)) {
+		const sourceVal = source[key];
+		const targetVal = result[key];
+		if (sourceVal && typeof sourceVal === "object" && !Array.isArray(sourceVal) && targetVal && typeof targetVal === "object" && !Array.isArray(targetVal)) result[key] = deepMerge(targetVal, sourceVal);
+		else if (sourceVal !== void 0) result[key] = sourceVal;
+	}
+	if (sources.length) return deepMerge(result, ...sources);
+	return result;
+}
+
+//#endregion
+//#region src/create-theme.ts
+/**
+* Create a theme preset factory.
+*
+* Returns a function that accepts optional overrides and deep-merges them
+* with the base theme defaults. This is the same pattern used by the
+* built-in `fumadocs()`, `darksharp()`, and `pixelBorder()` presets.
+*
+* @param baseTheme - The default theme configuration
+* @returns A factory function `(overrides?) => DocsTheme`
+*
+* @example
+* ```ts
+* import { createTheme } from "@farming-labs/docs";
+*
+* export const myTheme = createTheme({
+*   name: "my-theme",
+*   ui: {
+*     colors: { primary: "#6366f1" },
+*     layout: { contentWidth: 800 },
+*   },
+* });
+* ```
+*/
+function createTheme(baseTheme) {
+	return function themeFactory(overrides = {}) {
+		const merged = deepMerge(baseTheme, overrides);
+		if (overrides.ui?.colors) merged._userColorOverrides = { ...overrides.ui.colors };
+		return merged;
+	};
+}
+/**
+* Extend an existing theme preset with additional defaults.
+*
+* Useful when you want to build on top of an existing theme (e.g. fumadocs)
+* rather than starting from scratch.
+*
+* @example
+* ```ts
+* import { extendTheme } from "@farming-labs/docs";
+* import { fumadocs } from "@farming-labs/theme/default";
+*
+* // Start with fumadocs defaults, override some values
+* export const myTheme = extendTheme(fumadocs(), {
+*   name: "my-custom-fumadocs",
+*   ui: { colors: { primary: "#22c55e" } },
+* });
+* ```
+*/
+function extendTheme(baseTheme, extensions) {
+	return deepMerge(baseTheme, extensions);
+}
+
+//#endregion
+//#region src/i18n.ts
+function normalizeSegment(value) {
+	return value.replace(/^\/+|\/+$/g, "");
+}
+function splitSegments(value) {
+	const cleaned = normalizeSegment(value);
+	return cleaned ? cleaned.split("/").filter(Boolean) : [];
+}
+function resolveDocsI18n(config) {
+	if (!config || !Array.isArray(config.locales)) return null;
+	const locales = Array.from(new Set(config.locales.map((l) => l.trim()).filter(Boolean)));
+	if (locales.length === 0) return null;
+	return {
+		locales,
+		defaultLocale: config.defaultLocale && locales.includes(config.defaultLocale) ? config.defaultLocale : locales[0]
+	};
+}
+function resolveDocsLocale(searchParams, i18n) {
+	if (!i18n) return void 0;
+	const raw = searchParams.get("lang") ?? searchParams.get("locale");
+	if (!raw) return void 0;
+	if (i18n.locales.includes(raw)) return raw;
+	return i18n.defaultLocale;
+}
+function resolveDocsPath(pathname, entry) {
+	const entryBase = normalizeSegment(entry || "docs") || "docs";
+	const entryParts = splitSegments(entryBase);
+	const pathParts = splitSegments(pathname);
+	let rest = pathParts;
+	if (entryParts.length > 0) {
+		if (pathParts.slice(0, entryParts.length).join("/") === entryParts.join("/")) rest = pathParts.slice(entryParts.length);
+	}
+	return {
+		slug: rest.join("/"),
+		entryPath: entryBase
+	};
+}
+
+//#endregion
+//#region src/metadata.ts
+/**
+* Resolve page title using metadata titleTemplate.
+* %s is replaced with page title.
+*/
+function resolveTitle(pageTitle, metadata) {
+	return (metadata?.titleTemplate ?? "%s").replace("%s", pageTitle);
+}
+/**
+* Resolve OG image URL for a page.
+* Prefers page.openGraph.images[0], then page.ogImage, then config endpoint/default.
+*/
+function resolveOGImage(page, ogConfig, baseUrl) {
+	if (page.openGraph?.images?.length) return resolveImageUrl(page.openGraph.images[0].url, baseUrl);
+	if (!ogConfig?.enabled) return void 0;
+	if (page.ogImage) return resolveImageUrl(page.ogImage, baseUrl);
+	if (ogConfig.type === "dynamic" && ogConfig.endpoint) return `${baseUrl ?? ""}${ogConfig.endpoint}`;
+	return ogConfig.defaultImage;
+}
+function resolveImageUrl(url, baseUrl) {
+	if (url.startsWith("/") || url.startsWith("http")) return url;
+	const base = baseUrl ?? "";
+	return `${base}${base.length > 0 && !base.endsWith("/") ? "/" : ""}${url}`;
+}
+/**
+* Build the Open Graph metadata object for a page.
+* When the page has openGraph in frontmatter, uses it (with title/description filled from page if omitted).
+* Otherwise uses ogImage or config (dynamic endpoint / defaultImage).
+*/
+function buildPageOpenGraph(page, ogConfig, baseUrl) {
+	if (page.openGraph) {
+		const images = page.openGraph.images?.length ? page.openGraph.images.map((img) => ({
+			url: resolveImageUrl(img.url, baseUrl),
+			width: img.width ?? 1200,
+			height: img.height ?? 630
+		})) : void 0;
+		return {
+			title: page.openGraph.title ?? page.title,
+			description: page.openGraph.description ?? page.description,
+			...images && { images }
+		};
+	}
+	const url = resolveOGImage(page, ogConfig, baseUrl);
+	if (!url) return void 0;
+	return {
+		title: page.title,
+		...page.description && { description: page.description },
+		images: [{
+			url,
+			width: 1200,
+			height: 630
+		}]
+	};
+}
+/**
+* Build the Twitter card metadata object for a page.
+* When the page has twitter in frontmatter, uses it.
+* Otherwise builds from ogImage or config (dynamic endpoint).
+*/
+function buildPageTwitter(page, ogConfig, baseUrl) {
+	if (page.twitter) {
+		const images = page.twitter.images?.length ? page.twitter.images.map((url) => resolveImageUrl(url, baseUrl)) : void 0;
+		return {
+			...page.twitter.card && { card: page.twitter.card },
+			...page.twitter.title !== void 0 && { title: page.twitter.title },
+			...page.twitter.description !== void 0 && { description: page.twitter.description },
+			...images && { images }
+		};
+	}
+	const url = resolveOGImage(page, ogConfig, baseUrl);
+	if (!url) return void 0;
+	return {
+		card: "summary_large_image",
+		title: page.title,
+		...page.description && { description: page.description },
+		images: [url]
+	};
+}
+
+//#endregion
+//#region src/agent.ts
+const DEFAULT_DOCS_API_ROUTE = "/api/docs";
+const DEFAULT_AGENT_SPEC_ROUTE = "/api/docs/agent/spec";
+const DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE = "/.well-known/agent";
+const DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE = "/.well-known/agent.json";
+const DEFAULT_MCP_ROUTE = "/api/docs/mcp";
+const DEFAULT_MCP_PUBLIC_ROUTE = "/mcp";
+const DEFAULT_MCP_WELL_KNOWN_ROUTE = "/.well-known/mcp";
+const DEFAULT_LLMS_TXT_ROUTE = "/llms.txt";
+const DEFAULT_LLMS_FULL_TXT_ROUTE = "/llms-full.txt";
+const DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms.txt";
+const DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE = "/.well-known/llms-full.txt";
+const DEFAULT_SKILL_MD_ROUTE = "/skill.md";
+const DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE = "/.well-known/skill.md";
+const DEFAULT_AGENT_FEEDBACK_ROUTE = "/api/docs/agent/feedback";
+function normalizeDocsPathSegment(value) {
+	return value.replace(/^\/+|\/+$/g, "");
+}
+function normalizeDocsUrlPath(value) {
+	const normalized = value.replace(/\/+/g, "/");
+	if (normalized === "/") return normalized;
+	return normalized.replace(/\/+$/, "");
+}
+function isDocsAgentDiscoveryRequest(url) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	if (pathname === DEFAULT_DOCS_API_ROUTE && url.searchParams.get("agent")?.trim() === "spec") return true;
+	return pathname === DEFAULT_AGENT_SPEC_ROUTE || pathname === DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE || pathname === DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE;
+}
+function isDocsMcpRequest(url) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	return pathname === DEFAULT_MCP_ROUTE || pathname === DEFAULT_MCP_PUBLIC_ROUTE || pathname === DEFAULT_MCP_WELL_KNOWN_ROUTE;
+}
+function isDocsSkillRequest(url) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	if (pathname === DEFAULT_SKILL_MD_ROUTE || pathname === DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE) return true;
+	return pathname === DEFAULT_DOCS_API_ROUTE && resolveDocsSkillFormat(url) === "skill";
+}
+function resolveDocsSkillFormat(url) {
+	return url.searchParams.get("format")?.trim() === "skill" ? "skill" : null;
+}
+function isDocsPublicGetRequest(entry, url, request) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	if (pathname === DEFAULT_DOCS_API_ROUTE || pathname === DEFAULT_MCP_ROUTE) return false;
+	return isDocsAgentDiscoveryRequest(url) || isDocsSkillRequest(url) || resolveDocsLlmsTxtFormat(url) !== null || resolveDocsMarkdownRequest(entry, url, request) !== null;
+}
+function resolveDocsLlmsTxtFormat(url) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	if (pathname === DEFAULT_LLMS_TXT_ROUTE || pathname === DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE) return "llms";
+	if (pathname === DEFAULT_LLMS_FULL_TXT_ROUTE || pathname === DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE) return "llms-full";
+	const format = url.searchParams.get("format");
+	return pathname === DEFAULT_DOCS_API_ROUTE && (format === "llms" || format === "llms-full") ? format : null;
+}
+function resolveDocsMarkdownRequest(entry, url, request) {
+	const pathname = normalizeDocsUrlPath(url.pathname);
+	const format = url.searchParams.get("format")?.trim();
+	if (pathname === DEFAULT_DOCS_API_ROUTE && format === "markdown") return { requestedPath: url.searchParams.get("path")?.trim() ?? "" };
+	const normalizedEntry = `/${normalizeDocsPathSegment(entry) || "docs"}`;
+	if (pathname === `${normalizedEntry}.md`) return { requestedPath: "" };
+	const slugPrefix = `${normalizedEntry}/`;
+	if (pathname.startsWith(slugPrefix) && pathname.endsWith(".md")) return { requestedPath: pathname.slice(slugPrefix.length, -3) };
+	if (acceptsMarkdown(request)) {
+		if (pathname === normalizedEntry) return { requestedPath: "" };
+		if (pathname.startsWith(slugPrefix)) return { requestedPath: pathname.slice(slugPrefix.length) };
+	}
+	return null;
+}
+function findDocsMarkdownPage(entry, pages, requestedPath) {
+	const normalizedRequest = normalizeRequestedMarkdownPath(entry, requestedPath);
+	for (const page of pages) if (normalizeDocsUrlPath(page.url) === normalizedRequest) return page;
+	const normalizedSlug = normalizeDocsPathSegment(requestedPath.replace(/^\//, "").replace(/\.md$/i, ""));
+	for (const page of pages) if (page.slug !== void 0 && normalizeDocsPathSegment(page.slug) === normalizedSlug) return page;
+	return null;
+}
+function renderDocsMarkdownDocument(page) {
+	if (page.agentRawContent !== void 0) return page.agentRawContent;
+	const relatedLines = renderDocsRelatedMarkdownLines(page.related);
+	const lines = [`# ${page.title}`, `URL: ${page.url}`];
+	if (page.description) lines.push(`Description: ${page.description}`);
+	lines.push(...relatedLines);
+	lines.push("", page.agentFallbackRawContent ?? page.rawContent ?? page.content);
+	return lines.join("\n");
+}
+function renderDocsSkillDocument({ origin, entry = "docs", search, mcp, feedback, llms, markdown }) {
+	const normalizedEntry = normalizeDocsPathSegment(entry) || "docs";
+	const siteTitle = compactSkillText(llms?.siteTitle ?? "Documentation");
+	const siteDescription = llms?.siteDescription ? compactSkillText(llms.siteDescription) : void 0;
+	const llmsEnabled = llms?.enabled ?? true;
+	const searchEnabled = isSearchEnabled(search);
+	const feedbackEnabled = feedback?.enabled ?? false;
+	const feedbackRoute = feedback?.route ?? DEFAULT_AGENT_FEEDBACK_ROUTE;
+	const feedbackSchemaRoute = feedback?.schemaRoute ?? `${feedbackRoute}/schema`;
+	const description = truncateSkillDescription(`Use ${siteTitle} through markdown routes, llms.txt, agent discovery, search, and MCP when available.`);
+	const markdownAcceptHeader = markdown?.acceptHeader === false ? null : "text/markdown";
+	const lines = [
+		"---",
+		"name: docs",
+		`description: ${toYamlString(description)}`,
+		"---",
+		"",
+		`# ${siteTitle} Skill`,
+		"",
+		`Base URL: ${origin}`
+	];
+	if (siteDescription) lines.push(`Description: ${siteDescription}`);
+	lines.push("", "## When To Use", "Use this skill when you need to read or implement against this documentation site.", "", "## Start Here", `- Fetch ${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}; fall back to ${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE} or ${DEFAULT_AGENT_SPEC_ROUTE}.`, `- Fetch /${normalizedEntry}.md for the root docs page.`, `- Fetch /${normalizedEntry}/{slug}.md for page-specific context.`);
+	if (markdownAcceptHeader) lines.push(`- You can also request ${markdownAcceptHeader} from normal page URLs.`);
+	if (searchEnabled) lines.push(`- Search with ${DEFAULT_DOCS_API_ROUTE}?query={query} when you do not know the page.`);
+	if (llmsEnabled) lines.push(`- Use ${DEFAULT_LLMS_TXT_ROUTE} for a compact docs index.`, `- Use ${DEFAULT_LLMS_FULL_TXT_ROUTE} for full markdown context.`);
+	if (mcp.enabled) lines.push(`- Use ${DEFAULT_MCP_WELL_KNOWN_ROUTE} or ${DEFAULT_MCP_PUBLIC_ROUTE} for MCP tools when your environment supports MCP.`);
+	if (feedbackEnabled) lines.push(`- Read ${feedbackSchemaRoute} before posting agent feedback to ${feedbackRoute}.`);
+	lines.push("", "## Routes", `- Skill document: ${DEFAULT_SKILL_MD_ROUTE}`, `- Skill well-known alias: ${DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE}`, `- Skill API format: ${DEFAULT_DOCS_API_ROUTE}?format=skill`, `- Agent discovery: ${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}`, `- Agent discovery fallback: ${DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE}`, `- Markdown root: /${normalizedEntry}.md`, `- Markdown pages: /${normalizedEntry}/{slug}.md`);
+	if (llmsEnabled) lines.push(`- llms.txt: ${DEFAULT_LLMS_TXT_ROUTE}`, `- llms-full.txt: ${DEFAULT_LLMS_FULL_TXT_ROUTE}`, `- llms well-known aliases: ${DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE}, ${DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE}`);
+	if (mcp.enabled) lines.push(`- MCP: ${DEFAULT_MCP_PUBLIC_ROUTE}, ${DEFAULT_MCP_WELL_KNOWN_ROUTE}`);
+	lines.push("", "## Reusable Framework Skills", "For framework setup, CLI, page actions, Ask AI, or configuration work, install the reusable Farming Labs skills:", "", "```sh", "npx skills add farming-labs/docs", "```");
+	return lines.join("\n");
+}
+function resolveDocsAgentMdxContent(content, audience) {
+	const lines = content.split("\n");
+	const output = [];
+	let fenceMarker = null;
+	let agentDepth = 0;
+	for (const line of lines) {
+		const trimmed = line.trim();
+		const fenceMatch = trimmed.match(/^(`{3,}|~{3,})/);
+		if (fenceMatch) {
+			if (!fenceMarker) fenceMarker = fenceMatch[1];
+			else if (trimmed.startsWith(fenceMarker)) fenceMarker = null;
+			if (audience === "agent" || agentDepth === 0) output.push(line);
+			continue;
+		}
+		if (!fenceMarker) {
+			if (/^<Agent(?:\s[^>]*)?\/>$/.test(trimmed)) continue;
+			const singleLineMatch = line.match(/^(\s*)<Agent(?:\s[^>]*)?>([\s\S]*?)<\/Agent>\s*$/);
+			if (singleLineMatch) {
+				if (audience === "agent" && singleLineMatch[2]) output.push(`${singleLineMatch[1]}${singleLineMatch[2]}`);
+				continue;
+			}
+			if (line.match(/^(\s*)<Agent(?:\s[^>]*)?>\s*$/)) {
+				agentDepth += 1;
+				continue;
+			}
+			const openWithContentMatch = line.match(/^(\s*)<Agent(?:\s[^>]*)?>(.*)$/);
+			if (openWithContentMatch) {
+				agentDepth += 1;
+				if (audience === "agent" && openWithContentMatch[2]) output.push(`${openWithContentMatch[1]}${openWithContentMatch[2]}`);
+				continue;
+			}
+			const closeWithContentMatch = line.match(/^(.*)<\/Agent>\s*$/);
+			if (closeWithContentMatch && agentDepth > 0) {
+				if (audience === "agent" && closeWithContentMatch[1].trim()) output.push(closeWithContentMatch[1]);
+				agentDepth = Math.max(0, agentDepth - 1);
+				continue;
+			}
+			if (/^<\/Agent>\s*$/.test(trimmed) && agentDepth > 0) {
+				agentDepth = Math.max(0, agentDepth - 1);
+				continue;
+			}
+		}
+		if (agentDepth > 0 && audience === "human") continue;
+		output.push(line);
+	}
+	return output.join("\n").replace(/\n{3,}/g, "\n\n").trim();
+}
+function buildDocsAgentDiscoverySpec({ origin, entry = "docs", i18n = null, search, mcp, feedback, llms, markdown }) {
+	const normalizedEntry = normalizeDocsPathSegment(entry) || "docs";
+	const localesEnabled = i18n !== null;
+	const searchEnabled = isSearchEnabled(search);
+	const feedbackRoute = feedback?.route ?? DEFAULT_AGENT_FEEDBACK_ROUTE;
+	const feedbackSchemaRoute = feedback?.schemaRoute ?? `${feedbackRoute}/schema`;
+	const llmsEnabled = llms?.enabled ?? true;
+	return {
+		version: "1",
+		name: "@farming-labs/docs",
+		baseUrl: origin,
+		site: {
+			title: llms?.siteTitle ?? "Documentation",
+			description: llms?.siteDescription,
+			entry: normalizedEntry,
+			baseUrl: llms?.baseUrl ?? origin
+		},
+		locales: {
+			enabled: localesEnabled,
+			available: i18n?.locales ?? [],
+			default: i18n?.defaultLocale ?? null,
+			queryParam: "lang",
+			fallbackQueryParam: "locale"
+		},
+		capabilities: {
+			markdownRoutes: true,
+			agentMdOverrides: true,
+			agentBlocks: true,
+			llms: llmsEnabled,
+			skills: true,
+			mcp: mcp.enabled,
+			search: searchEnabled,
+			agentFeedback: feedback?.enabled ?? false,
+			locales: localesEnabled
+		},
+		api: {
+			docs: DEFAULT_DOCS_API_ROUTE,
+			agentSpec: DEFAULT_AGENT_SPEC_ROUTE,
+			agentSpecDefault: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
+			agentSpecFallback: DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE,
+			agentSpecWellKnown: DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE,
+			agentSpecWellKnownJson: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
+			agentSpecQuery: `${DEFAULT_DOCS_API_ROUTE}?agent=spec`
+		},
+		markdown: {
+			enabled: true,
+			acceptHeader: markdown?.acceptHeader === false ? null : "text/markdown",
+			pagePattern: `/${normalizedEntry}/{slug}.md`,
+			rootPage: `/${normalizedEntry}.md`,
+			apiPattern: `${DEFAULT_DOCS_API_ROUTE}?format=markdown&path={slug}`,
+			resolutionOrder: [
+				"agent.md",
+				"Agent blocks",
+				"page markdown"
+			]
+		},
+		llms: {
+			enabled: llmsEnabled,
+			defaultTxt: DEFAULT_LLMS_TXT_ROUTE,
+			defaultFull: DEFAULT_LLMS_FULL_TXT_ROUTE,
+			txt: `${DEFAULT_DOCS_API_ROUTE}?format=llms`,
+			full: `${DEFAULT_DOCS_API_ROUTE}?format=llms-full`,
+			publicTxt: DEFAULT_LLMS_TXT_ROUTE,
+			publicFull: DEFAULT_LLMS_FULL_TXT_ROUTE,
+			wellKnownTxt: DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE,
+			wellKnownFull: DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE
+		},
+		search: {
+			enabled: searchEnabled,
+			endpoint: `${DEFAULT_DOCS_API_ROUTE}?query={query}`,
+			method: "GET",
+			queryParam: "query",
+			localeParam: "lang"
+		},
+		skills: {
+			enabled: true,
+			file: "skill.md",
+			route: DEFAULT_SKILL_MD_ROUTE,
+			wellKnown: DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE,
+			api: `${DEFAULT_DOCS_API_ROUTE}?format=skill`,
+			generatedFallback: true,
+			registry: "skills.sh",
+			install: "npx skills add farming-labs/docs",
+			recommended: [{
+				name: "getting-started",
+				description: "Use for installation, init, framework setup, theme CSS, and first docs.config wiring."
+			}]
+		},
+		mcp: {
+			enabled: mcp.enabled,
+			endpoint: mcp.route,
+			defaultEndpoint: DEFAULT_MCP_PUBLIC_ROUTE,
+			publicEndpoint: DEFAULT_MCP_PUBLIC_ROUTE,
+			wellKnownEndpoint: DEFAULT_MCP_WELL_KNOWN_ROUTE,
+			publicEndpoints: [DEFAULT_MCP_PUBLIC_ROUTE, DEFAULT_MCP_WELL_KNOWN_ROUTE],
+			canonicalEndpoint: DEFAULT_MCP_ROUTE,
+			name: mcp.name,
+			version: mcp.version,
+			tools: mcp.tools
+		},
+		feedback: {
+			enabled: feedback?.enabled ?? false,
+			schema: feedbackSchemaRoute,
+			submit: feedbackRoute,
+			schemaQuery: `${DEFAULT_DOCS_API_ROUTE}?feedback=agent&schema=1`,
+			submitQuery: `${DEFAULT_DOCS_API_ROUTE}?feedback=agent`
+		},
+		instructions: {
+			preferMarkdownRoutes: true,
+			useMcpWhenAvailable: true,
+			readFeedbackSchemaBeforeSubmitting: true,
+			doNotAssumeFeedbackPayloadShape: true
+		}
+	};
+}
+function acceptsMarkdown(request) {
+	const accept = request.headers.get("accept");
+	if (!accept) return false;
+	return accept.split(",").map((value) => value.trim()).some((value) => {
+		const [mediaType, ...params] = value.split(";").map((part) => part.trim().toLowerCase());
+		if (mediaType !== "text/markdown") return false;
+		const qualityParam = params.find((param) => param.split("=", 1)[0]?.trim() === "q");
+		if (!qualityParam) return true;
+		const qualityValue = qualityParam.slice(qualityParam.indexOf("=") + 1).trim();
+		const quality = Number.parseFloat(qualityValue);
+		return Number.isFinite(quality) ? quality > 0 : true;
+	});
+}
+function normalizeRequestedMarkdownPath(entry, requestedPath) {
+	const normalizedEntry = `/${normalizeDocsPathSegment(entry) || "docs"}`;
+	const trimmed = requestedPath.trim().replace(/\.md$/i, "");
+	if (!trimmed) return normalizedEntry;
+	const normalized = normalizeDocsUrlPath(trimmed.startsWith("/") ? trimmed : `/${trimmed}`);
+	if (normalized === normalizedEntry || normalized.startsWith(`${normalizedEntry}/`)) return normalized;
+	const slug = normalizeDocsPathSegment(trimmed);
+	return slug ? normalizeDocsUrlPath(`${normalizedEntry}/${slug}`) : normalizedEntry;
+}
+function isSearchEnabled(search) {
+	if (search === false) return false;
+	if (search && typeof search === "object" && search.enabled === false) return false;
+	return true;
+}
+function compactSkillText(value) {
+	return value.replace(/\s+/g, " ").trim();
+}
+function truncateSkillDescription(value) {
+	const normalized = compactSkillText(value);
+	if (normalized.length <= 1024) return normalized;
+	return `${normalized.slice(0, 1021).trimEnd()}...`;
+}
+function toYamlString(value) {
+	return JSON.stringify(value);
+}
+
+//#endregion
+export { buildPageTwitter as A, defineDocs as B, renderDocsMarkdownDocument as C, resolveDocsMarkdownRequest as D, resolveDocsLlmsTxtFormat as E, resolveDocsPath as F, createTheme as I, extendTheme as L, resolveTitle as M, resolveDocsI18n as N, resolveDocsSkillFormat as O, resolveDocsLocale as P, deepMerge as R, normalizeDocsUrlPath as S, resolveDocsAgentMdxContent as T, isDocsAgentDiscoveryRequest as _, DEFAULT_DOCS_API_ROUTE as a, isDocsSkillRequest as b, DEFAULT_LLMS_TXT_ROUTE as c, DEFAULT_MCP_ROUTE as d, DEFAULT_MCP_WELL_KNOWN_ROUTE as f, findDocsMarkdownPage as g, buildDocsAgentDiscoverySpec as h, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE as i, resolveOGImage as j, buildPageOpenGraph as k, DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE as l, DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE as m, DEFAULT_AGENT_SPEC_ROUTE as n, DEFAULT_LLMS_FULL_TXT_ROUTE as o, DEFAULT_SKILL_MD_ROUTE as p, DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE as r, DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE as s, DEFAULT_AGENT_FEEDBACK_ROUTE as t, DEFAULT_MCP_PUBLIC_ROUTE as u, isDocsMcpRequest as v, renderDocsSkillDocument as w, normalizeDocsPathSegment as x, isDocsPublicGetRequest as y, resolveChangelogConfig as z };

package/dist/cli/index.mjs

@@ -69,13 +69,27 @@ async function main() {
 		searchApiKey: typeof flags["search-api-key"] === "string" ? flags["search-api-key"] : void 0
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-DHlRFytW.mjs");
+		const { init } = await import("../init-9U8AijRu.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-DLP94P1H.mjs");
+		const { runMcp } = await import("../mcp-1j3-_z66.mjs");
 		await runMcp(mcpOptions);
+	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-CoO9z8aW.mjs");
+		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
+		if (agentCompactOptions.help) {
+			printAgentCompactHelp();
+			return;
+		}
+		await compactAgentDocs(agentCompactOptions);
+	} else if (parsedCommand.command === "agent") {
+		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
+		console.error();
+		const { printAgentCompactHelp } = await import("../agent-CoO9z8aW.mjs");
+		printAgentCompactHelp();
+		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-CNesqs89.mjs");
+		const { syncSearch } = await import("../search-B2HvbbeE.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -83,7 +97,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-J_kkv-ti.mjs");
+		const { upgrade } = await import("../upgrade-BGWZ_NLh.mjs");
 		await upgrade({
 			framework: (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0),
 			tag: args.includes("--beta") ? "beta" : args.includes("--latest") ? "latest" : parsedCommand.tag ?? "latest"
@@ -106,6 +120,7 @@ ${pc.dim("Usage:")}
 
 ${pc.dim("Commands:")}
   ${pc.cyan("init")}     Scaffold docs in your project (default)
+  ${pc.cyan("agent")}    Agent utilities (${pc.dim("compact")} to generate sibling agent.md files)
   ${pc.cyan("mcp")}      Run the built-in docs MCP server over stdio
   ${pc.cyan("search")}   Search utilities (${pc.dim("sync")} for external indexes)
   ${pc.cyan("upgrade")}  Upgrade @farming-labs/* packages to latest (auto-detect or use --framework)
@@ -125,6 +140,16 @@ ${pc.dim("Options for init:")}
 ${pc.dim("Options for mcp:")}
   ${pc.cyan("--config <path>")}     Use a custom docs config path instead of ${pc.dim("docs.config.ts[x]")}
 
+${pc.dim("Options for agent compact:")}
+  ${pc.cyan("agent compact <page...>")}             Compact pages and write sibling ${pc.dim("agent.md")} files
+  ${pc.cyan("agent compact --all")}                 Compact every folder-based docs page
+  ${pc.cyan("--page <slug|path>")}                  Repeatable explicit page flag; positional page args work too
+  ${pc.cyan("--api-key <key>")}                     Token Company API key (or use ${pc.dim("TOKEN_COMPANY_API_KEY")})
+  ${pc.cyan("--api-key-env <name>")}                Custom env var name for the Token Company API key
+  ${pc.cyan("--base-url <url>")}                    Override the Token Company API base URL
+  ${pc.cyan("--aggressiveness <0-1>")}              Compression intensity for compacted output
+  ${pc.cyan("--dry-run")}                           Resolve and compress pages without writing files
+
 ${pc.dim("Options for search sync:")}
   ${pc.cyan("search sync --typesense")}             Sync docs content to Typesense using env/flags
   ${pc.cyan("search sync --algolia")}              Sync docs content to Algolia using env/flags