@farming-labs/docs 0.2.60 → 0.2.61

package/dist/{agent-export-BgUaiW8f.mjs → agent-export-D0zQhasD.mjs}

@@ -1,19 +1,21 @@
-import { Lt as renderDocsSitemapMarkdown, M as buildDocsAgentDiscoverySpec, Pt as buildDocsSitemapManifest, Rt as renderDocsSitemapXml, St as toDocsMarkdownUrl, T 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, en as buildDocsAgentSkillsIndex, 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, on as resolveDocsPublishedAgentSkill, qt as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, rt as renderDocsAgentsDocument, st as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, w as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE, zt as resolveDocsSitemapConfig } from "./agent-BFqyqEnC.mjs";
-import "./search-D57JXQLj.mjs";
-import { t as resolveDocsI18n } from "./i18n-CAlj1ADU.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-ltltiLJF.mjs";
-import "./sitemap-server-C1ibVKOy.mjs";
-import "./agent-evals-kJs2Y9xR.mjs";
+import { $ as renderDocsAgentsDocument, At as buildDocsSitemapManifest, Ft as resolveDocsSitemapConfig, Nt as renderDocsSitemapMarkdown, Pt as renderDocsSitemapXml, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, at as resolveDocsAgentFeedbackConfig, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, et as renderDocsLlmsTxt, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, k as buildDocsAgentDiscoverySpec, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, rt as renderDocsSkillDocument, t as DEFAULT_AGENTS_MD_ROUTE, tt as renderDocsMarkdownDocument, v as DEFAULT_LLMS_TXT_ROUTE, vt as toDocsMarkdownUrl, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-Fl0pjVNF.mjs";
+import { S as buildDocsAgentSkillsIndex, a as DEFAULT_A2A_AGENT_CARD_ROUTE, c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, k as resolveDocsPublishedAgentSkill, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, v as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, w as buildDocsLegacySkillsIndex, x as buildDocsA2AAgentCard, y as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-C54V_aJH.mjs";
+import "./search-9OnMGMvt.mjs";
+import { t as resolveDocsI18n } from "./i18n-CCaFUnAN.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-C08kDLsz.mjs";
+import "./sitemap-server-D_0Kzanj.mjs";
+import "./agent-evals-f4_OL10T.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
+import "./code-blocks-DnNVNK2M.mjs";
+import { t as resolveConfiguredAgentSkills } from "./agent-skills-server-CIeBszxp.mjs";
 import "./server.mjs";
-import { d as readStringProperty, f as readTopLevelBooleanProperty, h as resolveDocsContentDir, i as loadDocsConfigModule, l as readNavTitle, m as resolveDocsConfigPath, p as readTopLevelStringProperty, r as extractTopLevelConfigObject, s as readBooleanProperty, t as extractNestedObjectLiteral } from "./config-DASewQ0x.mjs";
-import { t as detectFramework } from "./utils-6UCLxv4B.mjs";
+import { _ as resolveDocsContentDir, a as loadDocsConfigModule, d as readNavTitle, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, lstatSync, mkdirSync, readFileSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import { execFileSync } from "node:child_process";
-import pc from "picocolors";
 import { createHash, randomUUID } from "node:crypto";
+import pc from "picocolors";
 
 //#region src/cli/agent-export.ts
 const AGENT_EXPORT_AGENTS_MARKER = "<!-- Generated by @farming-labs/docs agent export. -->";
@@ -67,8 +69,17 @@ function normalizePathSegment(value) {
 function normalizeContent(content) {
 	return `${content.trimEnd()}\n`;
 }
+function encodeRoutePath(relativePath) {
+	return relativePath.split("/").map((segment) => encodeURIComponent(segment)).join("/");
+}
 function publicFilePath(publicDir, route) {
-	const resolved = resolveContainedPath(publicDir, route.replace(/^\/+/, ""));
+	let relativeRoute;
+	try {
+		relativeRoute = route.replace(/^\/+/, "").split("/").map((segment) => decodeURIComponent(segment)).join("/");
+	} catch {
+		throw new Error(`Agent Bundle route contains invalid URL encoding: ${route}`);
+	}
+	const resolved = resolveContainedPath(publicDir, relativeRoute);
 	if (!resolved) throw new Error(`Agent Bundle route must stay inside the public directory: ${route}`);
 	return resolved;
 }
@@ -119,7 +130,7 @@ function sha256(content) {
 	return createHash("sha256").update(content).digest("hex");
 }
 function byteLength(content) {
-	return Buffer.byteLength(content, "utf-8");
+	return typeof content === "string" ? Buffer.byteLength(content, "utf-8") : content.byteLength;
 }
 function readExisting(filePath) {
 	return existsSync(filePath) ? readFileSync(filePath, "utf-8") : void 0;
@@ -128,7 +139,8 @@ function atomicWriteFile(filePath, content) {
 	mkdirSync(path.dirname(filePath), { recursive: true });
 	const temporaryPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
 	try {
-		writeFileSync(temporaryPath, content, "utf-8");
+		if (typeof content === "string") writeFileSync(temporaryPath, content, "utf-8");
+		else writeFileSync(temporaryPath, content);
 		renameSync(temporaryPath, filePath);
 	} finally {
 		if (existsSync(temporaryPath)) rmSync(temporaryPath, { force: true });
@@ -381,7 +393,7 @@ function findPublicAgentsSource(publicDir) {
 		if (content !== void 0 && !isManagedAgentsContent(content)) return normalizeContent(content);
 	}
 }
-function addOutput(outputs, publicDir, route, kind, mediaType, content, managed = true) {
+function addOutput(outputs, publicDir, route, kind, mediaType, content, managed = true, normalizeText = true) {
 	const absolutePath = publicFilePath(publicDir, route);
 	if (absolutePath === publicFilePath(publicDir, AGENT_BUNDLE_MANIFEST_ROUTE)) throw new Error(`Agent Bundle output collision at ${route} (reserved bundle manifest). Change the conflicting docs slug or configured route.`);
 	const collision = outputs.find((output) => output.absolutePath === absolutePath);
@@ -392,7 +404,7 @@ function addOutput(outputs, publicDir, route, kind, mediaType, content, managed
 		route,
 		kind,
 		mediaType,
-		content: normalizeContent(content),
+		content: typeof content === "string" && normalizeText ? normalizeContent(content) : content,
 		managed
 	});
 }
@@ -431,6 +443,8 @@ function resolveUserOwnedOverrides(outputs, previous) {
 	const previousByPath = new Map(previous?.files.map((file) => [file.path, file]) ?? []);
 	return outputs.map((output) => {
 		if (!preserveKinds.has(output.kind)) return output;
+		if (output.route.startsWith("/.well-known/agent-skills/") || output.route.startsWith("/.well-known/skills/") || output.route === DEFAULT_A2A_AGENT_CARD_ROUTE) return output;
+		if (typeof output.content !== "string") return output;
 		const current = readExisting(output.absolutePath);
 		if (current === void 0 || current === output.content) return output;
 		const previousFile = previousByPath.get(output.publicPath);
@@ -442,7 +456,7 @@ function resolveUserOwnedOverrides(outputs, previous) {
 		};
 	});
 }
-function resolveRobotsOutput(publicDir, entry, sitemap, robots) {
+function resolveRobotsOutput(publicDir, entry, sitemap, robots, agentCard = false) {
 	const route = "/robots.txt";
 	const absolutePath = publicFilePath(publicDir, route);
 	const existing = readExisting(absolutePath);
@@ -451,7 +465,8 @@ function resolveRobotsOutput(publicDir, entry, sitemap, robots) {
 		apiCatalog: false,
 		sitemap,
 		baseUrl: robots.baseUrl,
-		robots
+		robots,
+		agentCard
 	});
 	const hasManagedBlock = existing?.includes(DOCS_ROBOTS_GENERATED_BLOCK_START) === true && existing.includes(DOCS_ROBOTS_GENERATED_BLOCK_END);
 	if (existing !== void 0 && !hasManagedBlock) return {
@@ -544,8 +559,9 @@ function preservedStaleManifestFiles(publicDir, previous, outputs) {
 	const expected = new Set(outputs.map((output) => output.publicPath));
 	return previous.files.flatMap((file) => {
 		if (!file.managed && file.orphaned !== true || expected.has(file.path)) return [];
-		const current = readExisting(resolvePreviousOutputPath(publicDir, file.path, "public"));
-		if (current === void 0) return [];
+		const filePath = resolvePreviousOutputPath(publicDir, file.path, "public");
+		if (!existsSync(filePath)) return [];
+		const current = readFileSync(filePath);
 		if (file.orphaned !== true && sha256(current) === file.sha256) return [];
 		return [{
 			...file,
@@ -561,7 +577,8 @@ function preservedStaleInternalManifestFiles(rootDir, previous, outputs) {
 	const expected = new Set(outputs.map((output) => output.path));
 	return previous.internalFiles.flatMap((file) => {
 		if (expected.has(file.path)) return [];
-		const current = readExisting(resolvePreviousOutputPath(rootDir, file.path, "internal"));
+		const filePath = resolvePreviousOutputPath(rootDir, file.path, "internal");
+		const current = existsSync(filePath) ? readFileSync(filePath) : void 0;
 		if (current === void 0) return [];
 		if (file.orphaned !== true && sha256(current) === file.sha256) return [];
 		return [{
@@ -578,7 +595,7 @@ function removeStaleManagedFiles(publicDir, previous, stalePaths) {
 	const previousByPath = new Map(previous.files.map((file) => [resolvePreviousOutputPath(publicDir, file.path, "public"), file]));
 	for (const filePath of stalePaths) {
 		const previousFile = previousByPath.get(filePath);
-		const current = readExisting(filePath);
+		const current = existsSync(filePath) ? readFileSync(filePath) : void 0;
 		if (!previousFile?.managed || previousFile.orphaned === true || current === void 0 || sha256(current) !== previousFile.sha256) continue;
 		rmSync(filePath);
 		removed.push(filePath);
@@ -599,7 +616,13 @@ function removeStaleInternalFiles(rootDir, previous, stalePaths) {
 	return removed;
 }
 function changedOutputs(outputs) {
-	return outputs.filter((output) => readExisting(output.absolutePath) !== output.content);
+	return outputs.filter((output) => !outputMatchesExisting(output));
+}
+function outputMatchesExisting(output) {
+	if (!existsSync(output.absolutePath)) return false;
+	if (typeof output.content === "string") return readExisting(output.absolutePath) === output.content;
+	const current = readFileSync(output.absolutePath);
+	return current.byteLength === output.content.byteLength && current.equals(Buffer.from(output.content));
 }
 async function exportAgentBundle(options = {}) {
 	if (!options.public && !options.check) throw new Error("Pass --public to write the static Agent Bundle into the framework public directory.");
@@ -681,6 +704,7 @@ async function exportAgentBundle(options = {}) {
 		openapi,
 		markdown: { acceptHeader: false }
 	};
+	const configuredAgentSkills = await resolveConfiguredAgentSkills(config?.agent?.skills, { rootDir });
 	let outputs = [];
 	const internalOutputs = [];
 	for (const { page } of localizedPages) addOutput(outputs, publicDir, staticMarkdownRoute(page, sourceEntry, routeEntry), "page", "text/markdown", renderDocsMarkdownDocument({
@@ -719,23 +743,6 @@ async function exportAgentBundle(options = {}) {
 			addOutput(outputs, publicDir, section.fullRoute, "llms", "text/plain", section.llmsFullTxt);
 		}
 	}
-	const discoveryWithBundle = {
-		...buildDocsAgentDiscoverySpec({
-			...documentOptions,
-			i18n
-		}),
-		staticBundle: {
-			format: "farming-labs-agent-bundle.v1",
-			manifest: AGENT_BUNDLE_MANIFEST_ROUTE,
-			check: "docs agent export --check",
-			locales: i18n ? {
-				default: i18n.defaultLocale,
-				pathPattern: `${routeEntry ? `/${routeEntry}` : ""}/{locale}/{slug}.md`
-			} : void 0
-		}
-	};
-	const discoveryJson = JSON.stringify(discoveryWithBundle, null, 2);
-	for (const route of [DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE]) addOutput(outputs, publicDir, route, "discovery", "application/json", discoveryJson);
 	const generatedSkill = renderDocsSkillDocument(documentOptions);
 	const rootSkillPath = path.join(rootDir, "skill.md");
 	const publicSkill = existsSync(rootSkillPath) ? readFileSync(rootSkillPath, "utf-8") : generatedSkill;
@@ -787,14 +794,48 @@ async function exportAgentBundle(options = {}) {
 			]) if (route) addOutput(outputs, publicDir, route, "sitemap", "text/markdown", sitemapMarkdown);
 		}
 	}
-	if (robots.enabled) outputs.push(resolveRobotsOutput(publicDir, routeEntry || "docs", sitemapInput, robots));
+	if (robots.enabled) outputs.push(resolveRobotsOutput(publicDir, routeEntry || "docs", sitemapInput, robots, Boolean(config?.agent?.a2a)));
 	outputs = resolveUserOwnedOverrides(outputs, previous);
-	const publishedAgentSkill = await resolveDocsPublishedAgentSkill({
-		preferredDocument: outputs.find((output) => output.route === DEFAULT_SKILL_MD_ROUTE)?.content ?? normalizeContent(publicSkill),
+	const effectiveSkillOutput = outputs.find((output) => output.route === DEFAULT_SKILL_MD_ROUTE)?.content;
+	const allPublishedSkills = [await resolveDocsPublishedAgentSkill({
+		preferredDocument: typeof effectiveSkillOutput === "string" ? effectiveSkillOutput : normalizeContent(publicSkill),
 		fallbackDocument: normalizeContent(generatedSkill)
-	});
-	addOutput(outputs, publicDir, publishedAgentSkill.url, "skill", "text/markdown", publishedAgentSkill.content);
-	addOutput(outputs, publicDir, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, "discovery", "application/json", JSON.stringify(buildDocsAgentSkillsIndex(publishedAgentSkill), null, 2));
+	}), ...configuredAgentSkills];
+	const publishedNames = /* @__PURE__ */ new Set();
+	for (const skill of allPublishedSkills) {
+		if (publishedNames.has(skill.name)) throw new Error(`Duplicate published Agent Skill name: ${skill.name}`);
+		publishedNames.add(skill.name);
+		addOutput(outputs, publicDir, skill.url, "skill", skill.type === "archive" ? "application/gzip" : "text/markdown", skill.content, true, false);
+		for (const file of skill.files) {
+			if (file.url !== skill.url) addOutput(outputs, publicDir, file.url, "skill", file.mediaType, file.content, true, false);
+			if (file.path === "SKILL.md") addOutput(outputs, publicDir, `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(skill.name)}/skill.md`, "skill", file.mediaType, file.content, true, false);
+			const legacyPath = file.path === "SKILL.md" ? "skill.md" : encodeRoutePath(file.path);
+			addOutput(outputs, publicDir, `${DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(skill.name)}/${legacyPath}`, "skill", file.mediaType, file.content, true, false);
+		}
+	}
+	addOutput(outputs, publicDir, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, "discovery", "application/json", JSON.stringify(buildDocsAgentSkillsIndex(allPublishedSkills), null, 2));
+	addOutput(outputs, publicDir, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, "discovery", "application/json", JSON.stringify(buildDocsLegacySkillsIndex(allPublishedSkills), null, 2));
+	if (config?.agent?.a2a) addOutput(outputs, publicDir, DEFAULT_A2A_AGENT_CARD_ROUTE, "discovery", "application/json", JSON.stringify(buildDocsA2AAgentCard(config.agent.a2a, allPublishedSkills), null, 2));
+	const discoveryWithBundle = {
+		...buildDocsAgentDiscoverySpec({
+			...documentOptions,
+			i18n,
+			publishedSkills: allPublishedSkills,
+			agentCard: config?.agent?.a2a
+		}),
+		staticBundle: {
+			format: "farming-labs-agent-bundle.v1",
+			manifest: AGENT_BUNDLE_MANIFEST_ROUTE,
+			check: "docs agent export --check",
+			locales: i18n ? {
+				default: i18n.defaultLocale,
+				pathPattern: `${routeEntry ? `/${routeEntry}` : ""}/{locale}/{slug}.md`
+			} : void 0
+		}
+	};
+	const discoveryJson = JSON.stringify(discoveryWithBundle, null, 2);
+	for (const route of [DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE]) addOutput(outputs, publicDir, route, "discovery", "application/json", discoveryJson);
+	outputs = resolveUserOwnedOverrides(outputs, previous);
 	assertOutputPathsDoNotCollide({
 		outputs,
 		internalOutputs,
@@ -832,7 +873,7 @@ async function exportAgentBundle(options = {}) {
 	const internalChanged = readExisting(internalManifestPath) !== manifestJson;
 	if (options.check && (changed.length > 0 || changedInternalOutputs.length > 0 || internalChanged || stalePaths.length > 0 || staleInternal.length > 0)) throw new Error(`Static Agent Bundle is stale (${changed.length + changedInternalOutputs.length + (internalChanged ? 1 : 0) + stalePaths.length + staleInternal.length} output(s)). Run \`docs agent export --public\` to update it.`);
 	if (!options.check) {
-		for (const output of outputs) if (readExisting(output.absolutePath) !== output.content) atomicWriteFile(output.absolutePath, output.content);
+		for (const output of outputs) if (!outputMatchesExisting(output)) atomicWriteFile(output.absolutePath, output.content);
 		for (const output of internalOutputs) if (readExisting(output.absolutePath) !== output.content) atomicWriteFile(output.absolutePath, output.content);
 		atomicWriteFile(publicManifestPath, manifestJson);
 		atomicWriteFile(internalManifestPath, manifestJson);

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

@@ -0,0 +1,13 @@
+import { A as DocsPublishedAgentSkill } from "./standards-discovery-C4HUqMd2.mjs";
+
+//#region src/agent-skills-bundle.d.ts
+/**
+ * Build-time snapshot of configured Agent Skills.
+ *
+ * `docsAgentSkills()` replaces this module in production bundles. The undefined
+ * fallback keeps direct Node usage and development setups on the filesystem
+ * resolver when the build plugin is not installed.
+ */
+declare const bundledAgentSkills: readonly DocsPublishedAgentSkill[] | undefined;
+//#endregion
+export { bundledAgentSkills };

package/dist/agent-skills-bundle.mjs

@@ -0,0 +1,12 @@
+//#region src/agent-skills-bundle.ts
+/**
+* Build-time snapshot of configured Agent Skills.
+*
+* `docsAgentSkills()` replaces this module in production bundles. The undefined
+* fallback keeps direct Node usage and development setups on the filesystem
+* resolver when the build plugin is not installed.
+*/
+const bundledAgentSkills = void 0;
+
+//#endregion
+export { bundledAgentSkills };

package/dist/agent-skills-server-CIeBszxp.mjs

@@ -0,0 +1,263 @@
+import { k as resolveDocsPublishedAgentSkill, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX } from "./standards-discovery-C54V_aJH.mjs";
+import { existsSync, lstatSync, readFileSync, readdirSync, realpathSync, statSync } from "node:fs";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import { gzipSync } from "node:zlib";
+
+//#region src/agent-skills-server.ts
+const COMPANION_DIRECTORIES = new Set([
+	"references",
+	"scripts",
+	"assets"
+]);
+const IGNORED_COLLECTION_DIRECTORIES = new Set([".git", "node_modules"]);
+const MAX_COLLECTION_DEPTH = 12;
+const MAX_FILES_PER_SKILL = 256;
+const MAX_FILE_BYTES = 1024 * 1024;
+const MAX_SKILL_BYTES = 8 * 1024 * 1024;
+function isInside(parent, candidate) {
+	const relative = path.relative(parent, candidate);
+	return relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative);
+}
+function findWorkspaceRoot(rootDir) {
+	let current = realpathSync(rootDir);
+	for (;;) {
+		if (existsSync(path.join(current, ".git")) || existsSync(path.join(current, "pnpm-workspace.yaml")) || existsSync(path.join(current, "pnpm-workspace.yml"))) return current;
+		const parent = path.dirname(current);
+		if (parent === current) return realpathSync(rootDir);
+		current = parent;
+	}
+}
+function normalizeConfiguredPaths(input) {
+	if (!input) return [];
+	const value = typeof input === "string" || Array.isArray(input) ? input : input.paths;
+	return (typeof value === "string" ? [value] : [...value]).map((candidate) => candidate.trim()).filter(Boolean);
+}
+function resolveSafeConfiguredPath(configuredPath, rootDir, workspaceRoot) {
+	const candidate = path.resolve(rootDir, configuredPath);
+	if (!existsSync(candidate)) throw new Error(`Configured Agent Skill path does not exist: ${configuredPath}`);
+	if (lstatSync(candidate).isSymbolicLink()) throw new Error(`Configured Agent Skill paths may not be symlinks: ${configuredPath}`);
+	const resolved = realpathSync(candidate);
+	if (!isInside(workspaceRoot, resolved)) throw new Error(`Agent Skill symlink escapes the workspace: ${configuredPath}`);
+	return resolved;
+}
+function collectSkillDocuments(candidate, workspaceRoot, results, visited, depth = 0) {
+	if (depth > MAX_COLLECTION_DEPTH) throw new Error(`Agent Skill collection exceeds ${MAX_COLLECTION_DEPTH} directory levels.`);
+	const resolved = realpathSync(candidate);
+	if (!isInside(workspaceRoot, resolved)) throw new Error(`Agent Skill symlink escapes the workspace: ${candidate}`);
+	if (visited.has(resolved)) return;
+	visited.add(resolved);
+	const info = statSync(resolved);
+	if (info.isFile()) {
+		if (path.basename(resolved) !== "SKILL.md") throw new Error(`Agent Skill file must be named SKILL.md: ${candidate}`);
+		results.add(resolved);
+		return;
+	}
+	if (!info.isDirectory()) throw new Error(`Agent Skill path must be a regular file or directory: ${candidate}`);
+	const directSkill = path.join(resolved, "SKILL.md");
+	if (existsSync(directSkill)) {
+		const directInfo = lstatSync(directSkill);
+		if (!directInfo.isFile() || directInfo.isSymbolicLink()) throw new Error(`Agent Skill SKILL.md must be a non-symlink regular file: ${directSkill}`);
+		results.add(directSkill);
+		return;
+	}
+	for (const entry of readdirSync(resolved, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+		if (IGNORED_COLLECTION_DIRECTORIES.has(entry.name) || entry.name.startsWith(".") || COMPANION_DIRECTORIES.has(entry.name)) continue;
+		const entryPath = path.join(resolved, entry.name);
+		if (entry.isSymbolicLink()) throw new Error(`Agent Skill collections may not contain symlinks: ${entryPath}`);
+		else if (entry.isDirectory() || entry.isFile()) {
+			if (entry.isDirectory() || entry.name === "SKILL.md") collectSkillDocuments(entryPath, workspaceRoot, results, visited, depth + 1);
+		} else throw new Error(`Unsafe filesystem entry in Agent Skill collection: ${entryPath}`);
+	}
+}
+function encodeSkillFileUrl(name, relativePath) {
+	const encodedPath = relativePath.split("/").map((segment) => encodeURIComponent(segment)).join("/");
+	return `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(name)}/${encodedPath}`;
+}
+function mediaTypeFor(relativePath) {
+	const extension = path.extname(relativePath).toLowerCase();
+	if ([".md", ".mdx"].includes(extension)) return "text/markdown";
+	if ([
+		".txt",
+		".sh",
+		".bash",
+		".zsh",
+		".py",
+		".js",
+		".mjs",
+		".cjs",
+		".ts",
+		".tsx",
+		".jsx",
+		".css",
+		".html",
+		".svg",
+		".csv",
+		".yaml",
+		".yml"
+	].includes(extension)) return "text/plain";
+	if (extension === ".json") return "application/json";
+	if (extension === ".png") return "image/png";
+	if ([".jpg", ".jpeg"].includes(extension)) return "image/jpeg";
+	if (extension === ".gif") return "image/gif";
+	if (extension === ".webp") return "image/webp";
+	if (extension === ".pdf") return "application/pdf";
+	return "application/octet-stream";
+}
+function hashBytes(content) {
+	return createHash("sha256").update(content).digest("hex");
+}
+function preserveFileBytes(content, mediaType) {
+	if (mediaType.startsWith("text/") || mediaType === "application/json") {
+		const text = content.toString("utf8");
+		if (Buffer.from(text, "utf8").equals(content)) return text;
+	}
+	return new Uint8Array(content);
+}
+function compareSkillFilePath(left, right) {
+	if (left.path === "SKILL.md") return -1;
+	if (right.path === "SKILL.md") return 1;
+	return left.path.localeCompare(right.path);
+}
+function readCompanionFiles(skillDir, name, rootSkillBytes) {
+	const files = [];
+	let totalBytes = rootSkillBytes;
+	function visit(absoluteDir, relativeDir, depth = 0) {
+		if (depth > MAX_COLLECTION_DEPTH) throw new Error(`Agent Skill companion tree exceeds ${MAX_COLLECTION_DEPTH} levels: ${skillDir}`);
+		for (const entry of readdirSync(absoluteDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+			const absolutePath = path.join(absoluteDir, entry.name);
+			const relativePath = path.posix.join(relativeDir, entry.name);
+			if (entry.isSymbolicLink()) throw new Error(`Agent Skill companion files may not be symlinks: ${absolutePath}`);
+			if (entry.isDirectory()) {
+				visit(absolutePath, relativePath, depth + 1);
+				continue;
+			}
+			if (!entry.isFile()) throw new Error(`Unsafe filesystem entry in Agent Skill: ${absolutePath}`);
+			const executable = (statSync(absolutePath).mode & 73) !== 0;
+			const content = readFileSync(absolutePath);
+			if (content.byteLength > MAX_FILE_BYTES) throw new Error(`Agent Skill file exceeds ${MAX_FILE_BYTES} bytes: ${absolutePath}`);
+			totalBytes += content.byteLength;
+			if (totalBytes > MAX_SKILL_BYTES || files.length >= MAX_FILES_PER_SKILL - 1) throw new Error(`Agent Skill exceeds safe publication limits: ${skillDir}`);
+			const mediaType = mediaTypeFor(relativePath);
+			const value = preserveFileBytes(content, mediaType);
+			const sha256 = hashBytes(value);
+			files.push({
+				path: relativePath,
+				url: encodeSkillFileUrl(name, relativePath),
+				mediaType,
+				content: value,
+				sha256,
+				digest: `sha256:${sha256}`,
+				executable
+			});
+		}
+	}
+	for (const directory of [...COMPANION_DIRECTORIES].sort()) {
+		const absoluteDir = path.join(skillDir, directory);
+		if (!existsSync(absoluteDir)) continue;
+		const info = lstatSync(absoluteDir);
+		if (info.isSymbolicLink() || !info.isDirectory()) throw new Error(`Agent Skill ${directory}/ must be a non-symlink directory: ${absoluteDir}`);
+		visit(absoluteDir, directory);
+	}
+	return files;
+}
+function writeTarString(header, offset, length, value) {
+	const encoded = Buffer.from(value, "utf8");
+	if (encoded.byteLength > length) throw new Error(`Agent Skill archive path is too long: ${value}`);
+	header.set(encoded, offset);
+}
+function writeTarOctal(header, offset, length, value) {
+	writeTarString(header, offset, length, value.toString(8).padStart(length - 1, "0"));
+}
+function createTarHeader(name, size, executable) {
+	const header = new Uint8Array(512);
+	writeTarString(header, 0, 100, name);
+	writeTarOctal(header, 100, 8, executable ? 493 : 420);
+	writeTarOctal(header, 108, 8, 0);
+	writeTarOctal(header, 116, 8, 0);
+	writeTarOctal(header, 124, 12, size);
+	writeTarOctal(header, 136, 12, 0);
+	header.fill(32, 148, 156);
+	header[156] = "0".charCodeAt(0);
+	writeTarString(header, 257, 6, "ustar");
+	writeTarString(header, 263, 2, "00");
+	writeTarString(header, 148, 8, `${header.reduce((sum, byte) => sum + byte, 0).toString(8).padStart(6, "0")}\0 `);
+	return header;
+}
+function createDeterministicTarGzip(files) {
+	const chunks = [];
+	let total = 0;
+	for (const file of [...files].sort(compareSkillFilePath)) {
+		const content = typeof file.content === "string" ? Buffer.from(file.content) : file.content;
+		const header = createTarHeader(file.path, content.byteLength, file.executable === true);
+		chunks.push(header, content);
+		total += header.byteLength + content.byteLength;
+		const padding = (512 - content.byteLength % 512) % 512;
+		if (padding) {
+			chunks.push(new Uint8Array(padding));
+			total += padding;
+		}
+	}
+	chunks.push(new Uint8Array(1024));
+	total += 1024;
+	const tar = new Uint8Array(total);
+	let offset = 0;
+	for (const chunk of chunks) {
+		tar.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	const archive = new Uint8Array(gzipSync(tar, { level: 9 }));
+	if (archive.byteLength > 9) archive[9] = 255;
+	return archive;
+}
+async function publishSkillDocument(skillPath) {
+	const skillDir = path.dirname(skillPath);
+	const skillDocument = readFileSync(skillPath, "utf8");
+	const skillDocumentBytes = Buffer.byteLength(skillDocument, "utf8");
+	if (skillDocumentBytes > MAX_FILE_BYTES) throw new Error(`Agent Skill SKILL.md exceeds ${MAX_FILE_BYTES} bytes: ${skillPath}`);
+	const base = await resolveDocsPublishedAgentSkill({
+		preferredDocument: skillDocument,
+		fallbackDocument: skillDocument
+	});
+	if (base.name !== path.basename(skillDir)) throw new Error(`Agent Skill frontmatter name "${base.name}" must match its directory "${path.basename(skillDir)}".`);
+	const companions = readCompanionFiles(skillDir, base.name, skillDocumentBytes);
+	const files = [...base.files, ...companions].sort(compareSkillFilePath);
+	if (companions.length === 0) return {
+		...base,
+		files
+	};
+	const content = createDeterministicTarGzip(files);
+	const sha256 = hashBytes(content);
+	return {
+		name: base.name,
+		type: "archive",
+		description: base.description,
+		url: `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(base.name)}.tar.gz`,
+		digest: `sha256:${sha256}`,
+		content,
+		sha256,
+		skillDocument,
+		files
+	};
+}
+/** Resolve and safely package all project skills configured through `agent.skills`. */
+async function resolveConfiguredAgentSkills(input, options = {}) {
+	const configuredPaths = normalizeConfiguredPaths(input);
+	if (configuredPaths.length === 0) return [];
+	const rootDir = realpathSync(options.rootDir ?? process.cwd());
+	const workspaceRoot = realpathSync(options.workspaceRoot ?? findWorkspaceRoot(rootDir));
+	if (!isInside(workspaceRoot, rootDir)) throw new Error("Agent Skill rootDir must stay inside the configured workspace root.");
+	const documents = /* @__PURE__ */ new Set();
+	const visited = /* @__PURE__ */ new Set();
+	for (const configuredPath of configuredPaths) collectSkillDocuments(resolveSafeConfiguredPath(configuredPath, rootDir, workspaceRoot), workspaceRoot, documents, visited);
+	const published = await Promise.all([...documents].sort().map(publishSkillDocument));
+	const names = /* @__PURE__ */ new Set();
+	for (const skill of published) {
+		if (names.has(skill.name)) throw new Error(`Duplicate configured Agent Skill name: ${skill.name}`);
+		names.add(skill.name);
+	}
+	return published.sort((left, right) => left.name.localeCompare(right.name));
+}
+
+//#endregion
+export { resolveConfiguredAgentSkills as t };

package/dist/agent-skills-server-CKq3_jMj.d.mts

@@ -0,0 +1,12 @@
+import { A as DocsPublishedAgentSkill } from "./standards-discovery-C4HUqMd2.mjs";
+import { P as DocsAgentSkillsInput } from "./types-EhFhYGfr.mjs";
+
+//#region src/agent-skills-server.d.ts
+interface ResolveConfiguredAgentSkillsOptions {
+  rootDir?: string;
+  workspaceRoot?: string;
+}
+/** Resolve and safely package all project skills configured through `agent.skills`. */
+declare function resolveConfiguredAgentSkills(input: DocsAgentSkillsInput | undefined, options?: ResolveConfiguredAgentSkillsOptions): Promise<DocsPublishedAgentSkill[]>;
+//#endregion
+export { resolveConfiguredAgentSkills as n, ResolveConfiguredAgentSkillsOptions as t };

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

@@ -0,0 +1,31 @@
+import { A as DocsPublishedAgentSkill } from "./standards-discovery-C4HUqMd2.mjs";
+import { P as DocsAgentSkillsInput } from "./types-EhFhYGfr.mjs";
+import { t as ResolveConfiguredAgentSkillsOptions } from "./agent-skills-server-CKq3_jMj.mjs";
+
+//#region src/agent-skills-vite.d.ts
+declare const DOCS_AGENT_SKILLS_BUNDLE_MODULE = "@farming-labs/docs/agent-skills-bundle";
+interface DocsAgentSkillsBuildConfig {
+  agent?: {
+    skills?: DocsAgentSkillsInput;
+  };
+  rootDir?: string;
+}
+interface DocsAgentSkillsBuildPluginOptions extends ResolveConfiguredAgentSkillsOptions {}
+/** Minimal Rollup/Vite plugin surface, kept dependency-free for framework configs. */
+interface DocsAgentSkillsBuildPlugin {
+  name: string;
+  enforce: "pre";
+  resolveId(source: string): string | undefined;
+  load(id: string): Promise<string | undefined>;
+}
+/** Render a self-contained virtual module without relying on Node at runtime. */
+declare function renderDocsAgentSkillsBundle(skills: readonly DocsPublishedAgentSkill[]): string;
+/**
+ * Snapshot configured Agent Skills into the server bundle.
+ *
+ * The same plugin object works in Vite, Astro/Svelte/TanStack, and Nitro's
+ * Rollup build. Paths remain relative to the project root unless overridden.
+ */
+declare function docsAgentSkills(config: DocsAgentSkillsBuildConfig, options?: DocsAgentSkillsBuildPluginOptions): DocsAgentSkillsBuildPlugin;
+//#endregion
+export { DOCS_AGENT_SKILLS_BUNDLE_MODULE, DocsAgentSkillsBuildPlugin, DocsAgentSkillsBuildPluginOptions, docsAgentSkills, renderDocsAgentSkillsBundle };