@farming-labs/docs 0.2.62 → 0.2.64

package/dist/standards-discovery-jkykaXq1.mjs

@@ -0,0 +1,519 @@
+import matter from "gray-matter";
+
+//#region src/standards-discovery.ts
+const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";
+const DEFAULT_API_CATALOG_FORMAT = "api-catalog";
+const API_CATALOG_PROFILE_URI = "https://www.rfc-editor.org/info/rfc9727";
+const API_CATALOG_MEDIA_TYPE = "application/linkset+json";
+const DEFAULT_AGENT_SKILLS_INDEX_ROUTE = "/.well-known/agent-skills/index.json";
+const DEFAULT_AGENT_SKILLS_ROUTE_PREFIX = "/.well-known/agent-skills";
+const DEFAULT_AGENT_SKILLS_ROUTE_PATTERN = `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/{name}/SKILL.md`;
+const DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN = `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/{name}.tar.gz`;
+const DEFAULT_AGENT_SKILLS_INDEX_FORMAT = "agent-skills";
+const DEFAULT_AGENT_SKILL_FORMAT = "agent-skill";
+const DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT = "agent-skill-archive";
+const DEFAULT_AGENT_SKILL_FILE_FORMAT = "agent-skill-file";
+const DEFAULT_AGENT_SKILL_RESOURCE_FORMAT = "agent-skill-resource";
+const DEFAULT_LEGACY_SKILLS_INDEX_ROUTE = "/.well-known/skills/index.json";
+const DEFAULT_LEGACY_SKILLS_INDEX_FORMAT = "legacy-skills";
+const DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX = "/.well-known/skills";
+const DEFAULT_A2A_AGENT_CARD_ROUTE = "/.well-known/agent-card.json";
+const DEFAULT_A2A_AGENT_CARD_FORMAT = "agent-card";
+const AGENT_SKILLS_DISCOVERY_SCHEMA_URI = "https://schemas.agentskills.io/discovery/0.2.0/schema.json";
+const DEFAULT_DOCS_API_ROUTE = "/api/docs";
+const DEFAULT_AGENT_MANIFEST_ROUTE = "/.well-known/agent.json";
+const AGENT_SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const AGENT_SKILL_NAME_MAX_LENGTH = 64;
+const AGENT_SKILL_DESCRIPTION_MAX_LENGTH = 1024;
+const DISCOVERY_CACHE_CONTROL = "public, max-age=0, s-maxage=3600";
+function normalizeDocsRoute(value) {
+	const normalized = `/${value.trim()}`.replace(/\/{2,}/g, "/");
+	return normalized === "/" ? normalized : normalized.replace(/\/+$/, "");
+}
+/** Resolve the same-origin Docs API pathname used by query-form discovery routes. */
+function resolveDocsDiscoveryApiRoute(apiRoute) {
+	const candidate = apiRoute?.trim().split(/[?#]/, 1)[0];
+	return normalizeDocsRoute(candidate || DEFAULT_DOCS_API_ROUTE);
+}
+function resolveHttpUrl(value, origin) {
+	if (!value) return null;
+	try {
+		const base = new URL(origin);
+		const resolved = new URL(value, `${base.origin}/`);
+		if (resolved.protocol !== "http:" && resolved.protocol !== "https:") return null;
+		return resolved.toString();
+	} catch {
+		return null;
+	}
+}
+function compactUniqueTargets(targets) {
+	const seen = /* @__PURE__ */ new Set();
+	return targets.filter((target) => {
+		if (!target) return false;
+		const key = `${target.href}\u0000${target.type ?? ""}\u0000${target.title ?? ""}`;
+		if (seen.has(key)) return false;
+		seen.add(key);
+		return true;
+	});
+}
+function toTarget(route, origin, type, title) {
+	const href = resolveHttpUrl(route, origin);
+	return href ? {
+		href,
+		...type ? { type } : {},
+		...title ? { title } : {}
+	} : null;
+}
+/** Build an RFC 9727 API Catalog using the RFC 9264 JSON Linkset representation. */
+function buildDocsApiCatalog(options) {
+	const catalogUrl = resolveHttpUrl(DEFAULT_API_CATALOG_ROUTE, options.origin);
+	if (!catalogUrl) throw new Error(`Invalid HTTP(S) docs origin for API catalog: ${options.origin}`);
+	const apiRoute = options.apiRoute === null ? null : resolveDocsDiscoveryApiRoute(options.apiRoute);
+	const agentManifestRoute = options.agentManifestRoute === void 0 ? DEFAULT_AGENT_MANIFEST_ROUTE : options.agentManifestRoute;
+	const agentSkillsIndexRoute = options.agentSkillsIndexRoute === void 0 ? DEFAULT_AGENT_SKILLS_INDEX_ROUTE : options.agentSkillsIndexRoute;
+	const apiTargets = compactUniqueTargets([
+		toTarget(apiRoute, options.origin, "application/json", "Documentation API"),
+		...(options.apiRoutes ?? []).map((target) => toTarget(target.route, options.origin, target.type, target.title)),
+		toTarget(options.mcpRoute, options.origin, "application/json", "Documentation MCP endpoint"),
+		...(options.feedbackRoutes ?? []).map((route, index) => toTarget(route, options.origin, index === 0 ? "application/json" : "application/schema+json", index === 0 ? "Agent feedback endpoint" : "Agent feedback schema"))
+	]);
+	const serviceDocs = compactUniqueTargets([
+		toTarget(options.docsRoute ?? "/docs", options.origin, "text/html", "Documentation"),
+		toTarget(options.markdownRootRoute, options.origin, "text/markdown", "Documentation Markdown"),
+		toTarget(options.agentsRoute, options.origin, "text/markdown", "Agent instructions"),
+		toTarget(options.skillRoute, options.origin, "text/markdown", "Site skill"),
+		...(options.llmsRoutes ?? []).map((route) => toTarget(route, options.origin, "text/plain", "LLM documentation index")),
+		...(options.sitemapRoutes ?? []).map((route) => toTarget(route, options.origin, route.endsWith(".xml") ? "application/xml" : "text/markdown", "Documentation sitemap")),
+		toTarget(options.apiReferenceRoute, options.origin, "text/html", "API reference")
+	]);
+	const serviceMetadata = compactUniqueTargets([
+		toTarget(agentManifestRoute, options.origin, "application/json", "Agent discovery manifest"),
+		toTarget(agentSkillsIndexRoute, options.origin, "application/json", "Agent Skills discovery index"),
+		toTarget(options.legacySkillsIndexRoute === void 0 ? DEFAULT_LEGACY_SKILLS_INDEX_ROUTE : options.legacySkillsIndexRoute, options.origin, "application/json", "Legacy Agent Skills discovery index"),
+		toTarget(options.agentCardRoute, options.origin, "application/json", "A2A Agent Card"),
+		toTarget(options.configRoute, options.origin, "application/json", "Docs configuration map"),
+		toTarget(options.diagnosticsRoute, options.origin, "application/json", "Docs diagnostics"),
+		toTarget(options.robotsRoute, options.origin, "text/plain", "Robots policy"),
+		...(options.protectedResourceMetadataRoutes ?? []).map((route) => toTarget(route, options.origin, "application/json", "OAuth protected-resource metadata"))
+	]);
+	const serviceDescriptions = compactUniqueTargets([toTarget(options.openapiRoute, options.origin, "application/vnd.oai.openapi+json;version=3.1", "OpenAPI schema")]);
+	const catalogContext = {
+		anchor: catalogUrl,
+		"api-catalog": [{
+			href: catalogUrl,
+			type: API_CATALOG_MEDIA_TYPE,
+			title: "API catalog"
+		}]
+	};
+	if (apiTargets.length > 0) catalogContext.item = apiTargets;
+	if (serviceDocs.length > 0) catalogContext["service-doc"] = serviceDocs;
+	if (serviceMetadata.length > 0) catalogContext["service-meta"] = serviceMetadata;
+	if (serviceDescriptions.length > 0) catalogContext["service-desc"] = serviceDescriptions;
+	const linkset = [catalogContext];
+	for (const target of apiTargets) {
+		const context = { anchor: target.href };
+		if (serviceDocs.length > 0) context["service-doc"] = serviceDocs;
+		if (serviceMetadata.length > 0) context["service-meta"] = serviceMetadata;
+		if (serviceDescriptions.length > 0 && target.href === resolveHttpUrl(apiRoute, options.origin)) context["service-desc"] = serviceDescriptions;
+		linkset.push(context);
+	}
+	return { linkset };
+}
+function readAgentSkillFrontmatter(document) {
+	const normalized = document.startsWith("") ? document.slice(1) : document;
+	let data;
+	try {
+		data = matter(normalized).data;
+	} catch {
+		return null;
+	}
+	const name = typeof data.name === "string" ? data.name.trim() : "";
+	const description = typeof data.description === "string" ? data.description.trim() : "";
+	if (!name || name.length > AGENT_SKILL_NAME_MAX_LENGTH || !AGENT_SKILL_NAME_PATTERN.test(name) || !description || description.length > AGENT_SKILL_DESCRIPTION_MAX_LENGTH) return null;
+	return {
+		name,
+		description
+	};
+}
+function toDiscoveryBytes(content) {
+	if (typeof content === "string") return new TextEncoder().encode(content);
+	const bytes = new Uint8Array(new ArrayBuffer(content.byteLength));
+	bytes.set(content);
+	return bytes;
+}
+function toPublishedSkillArray(skills) {
+	return Array.isArray(skills) ? skills : [skills];
+}
+async function sha256DocsDiscoveryContent(content) {
+	const subtle = globalThis.crypto?.subtle;
+	if (!subtle) throw new Error("Web Crypto SHA-256 support is required for Agent Skills discovery.");
+	const digest = await subtle.digest("SHA-256", toDiscoveryBytes(content));
+	return [...new Uint8Array(digest)].map((value) => value.toString(16).padStart(2, "0")).join("");
+}
+function createDocsPublishedAgentSkill(content, metadata, sha256) {
+	return {
+		name: metadata.name,
+		type: "skill-md",
+		description: metadata.description,
+		url: `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${metadata.name}/SKILL.md`,
+		digest: `sha256:${sha256}`,
+		content,
+		sha256,
+		skillDocument: content,
+		files: [{
+			path: "SKILL.md",
+			url: `${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${metadata.name}/SKILL.md`,
+			mediaType: "text/markdown",
+			content,
+			sha256,
+			digest: `sha256:${sha256}`
+		}]
+	};
+}
+/** Build a published skill from an exact SKILL.md document and its precomputed SHA-256. */
+function buildDocsPublishedAgentSkill(document, sha256) {
+	const metadata = readAgentSkillFrontmatter(document);
+	if (!metadata) throw new Error("The generated Agent Skills fallback must contain valid name and description frontmatter.");
+	if (!/^[a-f0-9]{64}$/.test(sha256)) throw new Error("Agent Skill SHA-256 must be a lowercase 64-character hexadecimal digest.");
+	return createDocsPublishedAgentSkill(document, metadata, sha256);
+}
+/** Select a valid public skill and hash the exact bytes returned by its standards route. */
+async function resolveDocsPublishedAgentSkill({ preferredDocument, fallbackDocument }) {
+	const preferredMetadata = preferredDocument ? readAgentSkillFrontmatter(preferredDocument) : null;
+	const fallbackMetadata = readAgentSkillFrontmatter(fallbackDocument);
+	const content = preferredMetadata ? preferredDocument : fallbackDocument;
+	const metadata = preferredMetadata ?? fallbackMetadata;
+	if (!metadata) throw new Error("The generated Agent Skills fallback must contain valid name and description frontmatter.");
+	return createDocsPublishedAgentSkill(content, metadata, await sha256DocsDiscoveryContent(content));
+}
+function buildDocsAgentSkillsIndex(skills) {
+	return {
+		$schema: AGENT_SKILLS_DISCOVERY_SCHEMA_URI,
+		skills: toPublishedSkillArray(skills).map(({ name, type, description, url, digest }) => ({
+			name,
+			type,
+			description,
+			url,
+			digest
+		})).sort((left, right) => left.name.localeCompare(right.name))
+	};
+}
+/** Build the compatibility index used by older Agent Skills clients. */
+function buildDocsLegacySkillsIndex(skills) {
+	return { skills: toPublishedSkillArray(skills).map((skill) => ({
+		name: skill.name,
+		description: skill.description,
+		files: [...skill.files].sort((left, right) => {
+			if (left.path === "SKILL.md") return -1;
+			if (right.path === "SKILL.md") return 1;
+			return left.path.localeCompare(right.path);
+		}).map((file) => file.path)
+	})).sort((left, right) => left.name.localeCompare(right.name)) };
+}
+/** Build an A2A Agent Card only when a real A2A interface is explicitly configured. */
+function buildDocsA2AAgentCard(options, skills) {
+	const interfaceUrl = resolveHttpUrl(options.interfaceUrl, options.interfaceUrl);
+	const documentationUrl = resolveHttpUrl(options.documentationUrl, options.interfaceUrl);
+	const providerUrl = resolveHttpUrl(options.provider.url, options.interfaceUrl);
+	if (!interfaceUrl || !documentationUrl || !providerUrl) throw new Error("A2A Agent Card URLs must use HTTP(S).");
+	const protocolVersion = options.protocolVersion ?? "0.3";
+	const protocolBinding = options.protocolBinding ?? "HTTP+JSON";
+	return {
+		protocolVersion,
+		preferredTransport: protocolBinding,
+		supportedInterfaces: [{
+			url: interfaceUrl,
+			protocolBinding,
+			protocolVersion
+		}],
+		name: options.name,
+		description: options.description,
+		url: interfaceUrl,
+		provider: {
+			organization: options.provider.organization,
+			url: providerUrl
+		},
+		version: options.version ?? "1.0.0",
+		documentationUrl,
+		capabilities: {
+			streaming: false,
+			pushNotifications: false
+		},
+		defaultInputModes: ["text/plain"],
+		defaultOutputModes: ["text/plain"],
+		skills: toPublishedSkillArray(skills).map((skill) => ({
+			id: skill.name,
+			name: skill.name,
+			description: skill.description,
+			tags: ["documentation"],
+			examples: [],
+			url: skill.url
+		})).sort((left, right) => left.name.localeCompare(right.name))
+	};
+}
+function resolveDocsStandardsDiscoveryRequest(url, options = {}) {
+	const pathname = normalizeDocsRoute(url.pathname);
+	if (pathname === DEFAULT_API_CATALOG_ROUTE) return { kind: "api-catalog" };
+	if (pathname === DEFAULT_AGENT_SKILLS_INDEX_ROUTE) return { kind: "agent-skills-index" };
+	if (pathname === DEFAULT_LEGACY_SKILLS_INDEX_ROUTE) return { kind: "legacy-skills-index" };
+	if (pathname === DEFAULT_A2A_AGENT_CARD_ROUTE) return { kind: "agent-card" };
+	const archiveMatch = pathname.match(/^\/\.well-known\/agent-skills\/([^/]+)\.tar\.gz$/);
+	if (archiveMatch) try {
+		return {
+			kind: "agent-skill-archive",
+			name: decodeURIComponent(archiveMatch[1])
+		};
+	} catch {
+		return {
+			kind: "agent-skill-archive",
+			name: ""
+		};
+	}
+	const artifactMatch = pathname.match(/^\/\.well-known\/agent-skills\/([^/]+)\/skill\.md$/i);
+	if (artifactMatch) try {
+		return {
+			kind: "agent-skill",
+			name: decodeURIComponent(artifactMatch[1])
+		};
+	} catch {
+		return {
+			kind: "agent-skill",
+			name: ""
+		};
+	}
+	const fileMatch = pathname.match(/^\/\.well-known\/agent-skills\/([^/]+)\/(references|scripts|assets)\/(.+)$/);
+	if (fileMatch) try {
+		return {
+			kind: "agent-skill-file",
+			name: decodeURIComponent(fileMatch[1]),
+			path: `${fileMatch[2]}/${decodeURIComponent(fileMatch[3])}`
+		};
+	} catch {
+		return {
+			kind: "agent-skill-file",
+			name: "",
+			path: ""
+		};
+	}
+	const legacySkillMatch = pathname.match(/^\/\.well-known\/skills\/([^/]+)\/skill\.md$/i);
+	if (legacySkillMatch) try {
+		return {
+			kind: "agent-skill-file",
+			name: decodeURIComponent(legacySkillMatch[1]),
+			path: "SKILL.md"
+		};
+	} catch {
+		return {
+			kind: "agent-skill-file",
+			name: "",
+			path: ""
+		};
+	}
+	const legacyFileMatch = pathname.match(/^\/\.well-known\/skills\/([^/]+)\/(references|scripts|assets)\/(.+)$/);
+	if (legacyFileMatch) try {
+		return {
+			kind: "agent-skill-file",
+			name: decodeURIComponent(legacyFileMatch[1]),
+			path: `${legacyFileMatch[2]}/${decodeURIComponent(legacyFileMatch[3])}`
+		};
+	} catch {
+		return {
+			kind: "agent-skill-file",
+			name: "",
+			path: ""
+		};
+	}
+	if (pathname !== resolveDocsDiscoveryApiRoute(options.apiRoute)) return null;
+	const format = url.searchParams.get("format")?.trim();
+	if (format === DEFAULT_API_CATALOG_FORMAT) return { kind: "api-catalog" };
+	if (format === DEFAULT_AGENT_SKILLS_INDEX_FORMAT) return { kind: "agent-skills-index" };
+	if (format === DEFAULT_LEGACY_SKILLS_INDEX_FORMAT) return { kind: "legacy-skills-index" };
+	if (format === DEFAULT_A2A_AGENT_CARD_FORMAT) return { kind: "agent-card" };
+	if (format === DEFAULT_AGENT_SKILL_FORMAT) return {
+		kind: "agent-skill",
+		name: url.searchParams.get("name")?.trim() ?? ""
+	};
+	if (format === DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT) return {
+		kind: "agent-skill-archive",
+		name: url.searchParams.get("name")?.trim() ?? ""
+	};
+	if (format === DEFAULT_AGENT_SKILL_FILE_FORMAT || format === DEFAULT_AGENT_SKILL_RESOURCE_FORMAT) return {
+		kind: "agent-skill-file",
+		name: url.searchParams.get("name")?.trim() ?? "",
+		path: url.searchParams.get("path")?.trim() ?? "SKILL.md"
+	};
+	return null;
+}
+function isDocsStandardsDiscoveryRequest(url, options = {}) {
+	return resolveDocsStandardsDiscoveryRequest(url, options) !== null;
+}
+function formatLinkTarget(href, relation, options = {}) {
+	return [
+		`<${href}>`,
+		`rel="${relation}"`,
+		...options.type ? [`type="${options.type}"`] : [],
+		...options.profile ? [`profile="${options.profile}"`] : []
+	].join("; ");
+}
+/** Cross-link the standards endpoints without replacing an existing canonical Link value. */
+function getDocsDiscoveryLinkHeader(options = {}) {
+	return [
+		...options.includeApiCatalog === false ? [] : [formatLinkTarget(DEFAULT_API_CATALOG_ROUTE, "api-catalog", {
+			type: API_CATALOG_MEDIA_TYPE,
+			profile: API_CATALOG_PROFILE_URI
+		})],
+		...options.includeManifest === false ? [] : [formatLinkTarget(DEFAULT_AGENT_MANIFEST_ROUTE, "service-meta", { type: "application/json" })],
+		...options.includeSkills === false ? [] : [formatLinkTarget(DEFAULT_AGENT_SKILLS_INDEX_ROUTE, "service-meta", { type: "application/json" }), formatLinkTarget(DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, "service-meta", { type: "application/json" })],
+		...options.includeAgentCard ? [formatLinkTarget(DEFAULT_A2A_AGENT_CARD_ROUTE, "service-meta", { type: "application/json" })] : []
+	].join(", ");
+}
+function appendDocsDiscoveryLinkHeader(headers, value) {
+	const next = new Headers(headers);
+	const discoveryLinks = value ?? getDocsDiscoveryLinkHeader();
+	const existing = next.get("Link");
+	next.set("Link", existing ? `${existing}, ${discoveryLinks}` : discoveryLinks);
+	return next;
+}
+function requestMatchesEtag(request, etag) {
+	const value = request.headers.get("if-none-match");
+	if (!value) return false;
+	if (value.trim() === "*") return true;
+	return value.split(",").some((candidate) => candidate.trim().replace(/^W\//i, "") === etag);
+}
+async function createHashedDiscoveryResponse(options) {
+	const etag = `"${options.sha256 ?? await sha256DocsDiscoveryContent(options.content)}"`;
+	const headers = {
+		"Access-Control-Allow-Origin": "*",
+		"Access-Control-Expose-Headers": "ETag, Link",
+		Allow: "GET, HEAD",
+		"Cache-Control": DISCOVERY_CACHE_CONTROL,
+		"Content-Type": options.contentType,
+		ETag: etag,
+		Link: options.linkHeader,
+		"X-Robots-Tag": "noindex"
+	};
+	if (requestMatchesEtag(options.request, etag)) {
+		const { "Content-Type": _contentType, ...notModifiedHeaders } = headers;
+		return new Response(null, {
+			status: 304,
+			headers: notModifiedHeaders
+		});
+	}
+	const body = options.request.method.toUpperCase() === "HEAD" ? null : typeof options.content === "string" ? options.content : toDiscoveryBytes(options.content).buffer;
+	return new Response(body, { headers });
+}
+function standardsNotFoundResponse(request, linkHeader) {
+	return new Response(request.method.toUpperCase() === "HEAD" ? null : "Not Found", {
+		status: 404,
+		headers: {
+			"Access-Control-Allow-Origin": "*",
+			"Access-Control-Expose-Headers": "Link",
+			"Cache-Control": "no-store",
+			"Content-Type": "text/plain; charset=utf-8",
+			Link: linkHeader,
+			"X-Robots-Tag": "noindex"
+		}
+	});
+}
+function standardsMethodNotAllowedResponse(linkHeader) {
+	return new Response("Method Not Allowed", {
+		status: 405,
+		headers: {
+			"Access-Control-Allow-Origin": "*",
+			"Access-Control-Expose-Headers": "Link",
+			Allow: "GET, HEAD",
+			"Cache-Control": "no-store",
+			"Content-Type": "text/plain; charset=utf-8",
+			Link: linkHeader,
+			"X-Robots-Tag": "noindex"
+		}
+	});
+}
+/** Return one RFC 9727 or Agent Skills discovery response, or null for unrelated requests. */
+async function createDocsStandardsResponse({ request, apiCatalog, apiCatalogEnabled = true, apiRoute, preferredSkillDocument, fallbackSkillDocument, publishedSkills = [], agentCard }) {
+	const resolved = resolveDocsStandardsDiscoveryRequest(new URL(request.url), { apiRoute });
+	if (!resolved) return null;
+	const linkHeader = getDocsDiscoveryLinkHeader({
+		includeApiCatalog: apiCatalogEnabled,
+		includeAgentCard: Boolean(agentCard)
+	});
+	if (resolved.kind === "api-catalog" && (!apiCatalogEnabled || !apiCatalog)) return standardsNotFoundResponse(request, linkHeader);
+	const method = request.method.toUpperCase();
+	if (method !== "GET" && method !== "HEAD") return standardsMethodNotAllowedResponse(linkHeader);
+	if (resolved.kind === "api-catalog") return createHashedDiscoveryResponse({
+		request,
+		content: `${JSON.stringify(apiCatalog, null, 2)}\n`,
+		contentType: `${API_CATALOG_MEDIA_TYPE}; profile="${API_CATALOG_PROFILE_URI}"; charset=utf-8`,
+		linkHeader
+	});
+	const skills = [await resolveDocsPublishedAgentSkill({
+		preferredDocument: preferredSkillDocument,
+		fallbackDocument: fallbackSkillDocument
+	}), ...publishedSkills];
+	const skillsByName = /* @__PURE__ */ new Map();
+	for (const skill of skills) {
+		if (skillsByName.has(skill.name)) throw new Error(`Duplicate published Agent Skill name: ${skill.name}`);
+		skillsByName.set(skill.name, skill);
+	}
+	if (resolved.kind === "agent-skill") {
+		const skill = skillsByName.get(resolved.name);
+		if (!skill) return standardsNotFoundResponse(request, linkHeader);
+		const file = new URL(request.url).pathname.toLowerCase().endsWith(`${DEFAULT_AGENT_SKILLS_ROUTE_PREFIX}/${encodeURIComponent(skill.name)}/skill.md`.toLowerCase()) ? skill.files.find((candidate) => candidate.path === "SKILL.md") : void 0;
+		return createHashedDiscoveryResponse({
+			request,
+			content: file?.content ?? skill.content,
+			contentType: file ? "text/markdown; charset=utf-8" : skill.type === "archive" ? "application/gzip" : "text/markdown; charset=utf-8",
+			sha256: file?.sha256 ?? skill.sha256,
+			linkHeader: [linkHeader, formatLinkTarget(DEFAULT_AGENT_SKILLS_INDEX_ROUTE, "collection", { type: "application/json" })].join(", ")
+		});
+	}
+	if (resolved.kind === "agent-skill-archive") {
+		const skill = skillsByName.get(resolved.name);
+		if (!skill || skill.type !== "archive") return standardsNotFoundResponse(request, linkHeader);
+		return createHashedDiscoveryResponse({
+			request,
+			content: skill.content,
+			contentType: "application/gzip",
+			sha256: skill.sha256,
+			linkHeader: [linkHeader, formatLinkTarget(DEFAULT_AGENT_SKILLS_INDEX_ROUTE, "collection", { type: "application/json" })].join(", ")
+		});
+	}
+	if (resolved.kind === "agent-skill-file") {
+		const skill = skillsByName.get(resolved.name);
+		const normalizedPath = resolved.path.replace(/\\/g, "/").replace(/^\/+/, "");
+		if (!skill || normalizedPath.split("/").some((segment) => !segment || segment === "." || segment === "..")) return standardsNotFoundResponse(request, linkHeader);
+		const file = skill.files.find((candidate) => candidate.path === normalizedPath);
+		if (!file) return standardsNotFoundResponse(request, linkHeader);
+		return createHashedDiscoveryResponse({
+			request,
+			content: file.content,
+			contentType: `${file.mediaType}${file.mediaType.startsWith("text/") ? "; charset=utf-8" : ""}`,
+			sha256: file.sha256,
+			linkHeader: [linkHeader, formatLinkTarget(DEFAULT_AGENT_SKILLS_INDEX_ROUTE, "collection", { type: "application/json" })].join(", ")
+		});
+	}
+	if (resolved.kind === "agent-card") {
+		if (!agentCard) return standardsNotFoundResponse(request, linkHeader);
+		return createHashedDiscoveryResponse({
+			request,
+			content: `${JSON.stringify(buildDocsA2AAgentCard(agentCard, skills), null, 2)}\n`,
+			contentType: "application/json; charset=utf-8",
+			linkHeader
+		});
+	}
+	if (resolved.kind === "legacy-skills-index") return createHashedDiscoveryResponse({
+		request,
+		content: `${JSON.stringify(buildDocsLegacySkillsIndex(skills), null, 2)}\n`,
+		contentType: "application/json; charset=utf-8",
+		linkHeader
+	});
+	return createHashedDiscoveryResponse({
+		request,
+		content: `${JSON.stringify(buildDocsAgentSkillsIndex(skills), null, 2)}\n`,
+		contentType: "application/json; charset=utf-8",
+		linkHeader: [linkHeader, ...skills.map((skill) => formatLinkTarget(skill.url, "item", { type: skill.type === "archive" ? "application/gzip" : "text/markdown" }))].join(", ")
+	});
+}
+
+//#endregion
+export { resolveDocsPublishedAgentSkill as A, buildDocsApiCatalog as C, getDocsDiscoveryLinkHeader as D, createDocsStandardsResponse as E, sha256DocsDiscoveryContent as M, isDocsStandardsDiscoveryRequest as O, buildDocsAgentSkillsIndex as S, buildDocsPublishedAgentSkill as T, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as _, DEFAULT_A2A_AGENT_CARD_ROUTE as a, appendDocsDiscoveryLinkHeader as b, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as c, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as d, DEFAULT_AGENT_SKILL_FILE_FORMAT as f, DEFAULT_API_CATALOG_ROUTE as g, DEFAULT_API_CATALOG_FORMAT as h, DEFAULT_A2A_AGENT_CARD_FORMAT as i, resolveDocsStandardsDiscoveryRequest as j, resolveDocsDiscoveryApiRoute as k, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as l, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as o, DEFAULT_AGENT_SKILL_FORMAT as p, API_CATALOG_PROFILE_URI as r, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as u, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as v, buildDocsLegacySkillsIndex as w, buildDocsA2AAgentCard as x, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as y };