@farming-labs/theme 0.2.104 → 0.2.105

package/dist/docs-api.mjs

@@ -4,7 +4,7 @@ import { BoundedRouteCache } from "./bounded-route-cache.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DOCS_AGENT_MANIFEST_FORMAT, DOCS_AGENT_MANIFEST_SCHEMA_URI, DOCS_AGENT_MANIFEST_VERSION, DOCS_CONTENT_CHANGES_FORMAT, DOCS_CONTENT_CHANGES_RESPONSE_VALUE, DOCS_MARKDOWN_SECTION_INDEX_FORMAT, acceptsDocsMarkdown, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsSearchFacets, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCacheableResponse, createDocsContentChangeFeed, createDocsContentChangesHttpResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMcpProtectedResourceMetadataRoutes, hasDocsMarkdownSignatureAgent, inferDocsTelemetryAgentSurface, isDocsConfigRequest, isDocsContentChangesRequest, isDocsDiagnosticsRequest, normalizeDocsOkfTrustMetadataInput, normalizeDocsRelated, normalizePageAgentFrontmatter, performDocsSearch, performDocsSearchWithMetadata, renderDocsLlmsTxt, renderDocsMarkdownDocument, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAudienceMdxContent, resolveDocsContentChangesConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMetadataBaseUrl, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRetrievalLastModified, resolveDocsSearchAudience, resolveDocsSearchError, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsStandardsDiscoveryRequest, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, selectDocsLlmsTxtContent, stripGeneratedAgentProvenance } from "@farming-labs/docs";
+import { DEFAULT_A2A_AGENT_CARD_ROUTE, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN, DEFAULT_AGENT_SKILLS_INDEX_ROUTE, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, DEFAULT_API_CATALOG_ROUTE, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, DEFAULT_SITEMAP_MD_DOCS_ROUTE, DOCS_AGENT_MANIFEST_FORMAT, DOCS_AGENT_MANIFEST_SCHEMA_URI, DOCS_AGENT_MANIFEST_VERSION, DOCS_CONTENT_CHANGES_FORMAT, DOCS_CONTENT_CHANGES_RESPONSE_VALUE, DOCS_MARKDOWN_SECTION_INDEX_FORMAT, acceptsDocsMarkdown, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, buildDocsSearchFacets, compactDocsAgentDiscoverySpec, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsCacheableResponse, createDocsContentChangeFeed, createDocsContentChangesHttpResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMcpProtectedResourceMetadataRoutes, hasDocsMarkdownSignatureAgent, inferDocsTelemetryAgentSurface, isDocsConfigRequest, isDocsContentChangesRequest, isDocsDiagnosticsRequest, normalizeDocsOkfTrustMetadataInput, normalizeDocsRelated, normalizePageAgentFrontmatter, performDocsSearch, performDocsSearchWithMetadata, renderDocsLlmsTxt, renderDocsMarkdownDocument, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAudienceMdxContent, resolveDocsContentChangesConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMetadataBaseUrl, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRetrievalLastModified, resolveDocsSearchAudience, resolveDocsSearchError, resolveDocsSearchRequest, resolveDocsSitemapConfig, resolveDocsStandardsDiscoveryRequest, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, selectDocsLlmsTxtContent, stripGeneratedAgentProvenance } from "@farming-labs/docs";
 import { buildApiReferenceOpenApiDocumentAsync, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsSitemapManifest, resolveApiReferenceConfig, resolveApiReferenceOpenApiDiscovery, resolveConfiguredAgentSkills, resolveDocsMcpConfig } from "@farming-labs/docs/server";
 
 //#region src/docs-api.ts
@@ -214,6 +214,12 @@ function buildAgentSpec({ origin, entry, apiRoute, apiCatalog, i18n, search, con
 		format: DOCS_AGENT_MANIFEST_FORMAT,
 		version: DOCS_AGENT_MANIFEST_VERSION,
 		name: "@farming-labs/docs",
+		profile: "full",
+		profiles: {
+			default: "full",
+			full: DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
+			compact: `${DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE}?profile=compact`
+		},
 		baseUrl: origin,
 		site: {
 			title: llms.siteTitle ?? "Documentation",
@@ -2777,7 +2783,8 @@ function createDocsAPI(options) {
 					sitemap: sitemapConfig,
 					okf: options?.agent?.okf
 				}),
-				lastModified: resolveDocsRetrievalLastModified(page, "agent")
+				lastModified: resolveDocsRetrievalLastModified(page, "agent"),
+				access: page.agent?.access
 			};
 		}
 		const fallbackPage = getIndexes(ctx).find((page) => {
@@ -2791,7 +2798,8 @@ function createDocsAPI(options) {
 				sitemap: sitemapConfig,
 				okf: options?.agent?.okf
 			}),
-			lastModified: resolveDocsRetrievalLastModified(fallbackPage, "agent")
+			lastModified: resolveDocsRetrievalLastModified(fallbackPage, "agent"),
+			access: fallbackPage.agent?.access
 		};
 		const requestedSlug = normalizePublicDocsSlug(ctx, normalizedPublicRequest);
 		for (const page of getIndexes(ctx)) if (normalizePublicDocsSlug(ctx, page.url) === requestedSlug) return {
@@ -2801,7 +2809,8 @@ function createDocsAPI(options) {
 				sitemap: sitemapConfig,
 				okf: options?.agent?.okf
 			}),
-			lastModified: resolveDocsRetrievalLastModified(page, "agent")
+			lastModified: resolveDocsRetrievalLastModified(page, "agent"),
+			access: page.agent?.access
 		};
 		return null;
 	}
@@ -2937,31 +2946,34 @@ function createDocsAPI(options) {
 						method: requestMethod
 					}
 				});
+				const fullSpec = buildAgentSpec({
+					origin: url.origin,
+					entry,
+					apiRoute: requestApiRoute,
+					apiCatalog: apiCatalogEnabled,
+					i18n,
+					search: searchConfig,
+					contentChanges: contentChangesConfig.enabled,
+					mcp: mcpConfig,
+					feedback: agentFeedbackConfig,
+					llms: llmsConfig,
+					sitemap: sitemapConfig,
+					robots: robotsConfig,
+					openapi: openapiDiscovery,
+					publishedSkills: [await resolveDocsPublishedAgentSkill({
+						preferredDocument: readRootSkillDocument(),
+						fallbackDocument: getGeneratedSkillDocument(url.origin, requestApiRoute)
+					}), ...await getPublishedAgentSkills()],
+					agentCard: options?.agent?.a2a
+				});
+				const compact = url.searchParams.get("profile") === "compact";
+				const spec = compact ? compactDocsAgentDiscoverySpec(fullSpec) : fullSpec;
 				return createDocsCacheableResponse({
 					request,
-					content: `${JSON.stringify(buildAgentSpec({
-						origin: url.origin,
-						entry,
-						apiRoute: requestApiRoute,
-						apiCatalog: apiCatalogEnabled,
-						i18n,
-						search: searchConfig,
-						contentChanges: contentChangesConfig.enabled,
-						mcp: mcpConfig,
-						feedback: agentFeedbackConfig,
-						llms: llmsConfig,
-						sitemap: sitemapConfig,
-						robots: robotsConfig,
-						openapi: openapiDiscovery,
-						publishedSkills: [await resolveDocsPublishedAgentSkill({
-							preferredDocument: readRootSkillDocument(),
-							fallbackDocument: getGeneratedSkillDocument(url.origin, requestApiRoute)
-						}), ...await getPublishedAgentSkills()],
-						agentCard: options?.agent?.a2a
-					}), null, 2)}\n`,
+					content: `${JSON.stringify(spec, null, compact ? void 0 : 2)}\n`,
 					headers: {
 						"Content-Type": "application/json; charset=utf-8",
-						"Cache-Control": "public, max-age=0, s-maxage=3600",
+						"Cache-Control": "public, max-age=0, s-maxage=3600, stale-while-revalidate=86400",
 						Link: agentManifestLinkHeader,
 						"X-Robots-Tag": "noindex"
 					}
@@ -3187,6 +3199,7 @@ function createDocsAPI(options) {
 					canonicalUrl,
 					locale: ctx.locale,
 					lastModified: representation?.lastModified,
+					access: representation?.access,
 					sitemap: sitemapConfig
 				});
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/theme",
-  "version": "0.2.104",
+  "version": "0.2.105",
   "description": "Theme package for @farming-labs/docs — layout, provider, MDX components, and styles",
   "keywords": [
     "docs",
@@ -161,7 +161,7 @@
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "vitest": "^4.1.8",
-    "@farming-labs/docs": "0.2.104"
+    "@farming-labs/docs": "0.2.105"
   },
   "peerDependencies": {
     "@farming-labs/docs": ">=0.0.1",