@farming-labs/theme 0.2.62 → 0.2.63

package/dist/docs-api.d.mts

@@ -1,4 +1,4 @@
-import { ChangelogConfig, DocsAnalyticsConfig, DocsAskAIMcpConfig, DocsConfig, DocsI18nConfig, DocsMcpConfig, DocsObservabilityConfig, DocsRobotsConfig, DocsSearchConfig, DocsSitemapConfig, DocsTelemetryConfig, FeedbackConfig, LlmsTxtConfig, OrderingItem } from "@farming-labs/docs";
+import { ChangelogConfig, DocsAnalyticsConfig, DocsAskAIMcpConfig, DocsConfig, DocsI18nConfig, DocsMcpConfig, DocsObservabilityConfig, DocsPublishedAgentSkill, DocsRobotsConfig, DocsSearchConfig, DocsSitemapConfig, DocsTelemetryConfig, FeedbackConfig, LlmsTxtConfig, OrderingItem } from "@farming-labs/docs";
 
 //#region src/docs-api.d.ts
 interface AIProviderConfig {
@@ -80,6 +80,8 @@ interface DocsAPIOptions {
   metadata?: DocsConfig["metadata"];
   /** Reusable skill publication and optional real A2A service metadata. */
   agent?: DocsConfig["agent"];
+  /** @internal Build-time Agent Skills snapshot supplied by framework adapters. */
+  _preloadedAgentSkills?: readonly DocsPublishedAgentSkill[];
 }
 interface DocsMCPAPIOptions {
   rootDir?: string;
@@ -95,6 +97,8 @@ interface DocsMCPAPIOptions {
   telemetry?: boolean | DocsTelemetryConfig;
   observability?: boolean | DocsObservabilityConfig;
   agent?: DocsConfig["agent"];
+  /** @internal Build-time Agent Skills snapshot supplied by framework adapters. */
+  _preloadedAgentSkills?: readonly DocsPublishedAgentSkill[];
 }
 type LlmsTxtOptions = LlmsTxtConfig;
 /**

package/dist/docs-api.mjs

@@ -2463,7 +2463,11 @@ function generateLlmsTxt(indexes, options) {
 */
 function createDocsAPI(options) {
 	const root = options?.rootDir ?? process.cwd();
-	const publishedAgentSkills = resolveConfiguredAgentSkills(options?.agent?.skills, { rootDir: root });
+	let publishedAgentSkills;
+	function getPublishedAgentSkills() {
+		if (!publishedAgentSkills) publishedAgentSkills = Array.isArray(options?._preloadedAgentSkills) ? Promise.resolve([...options._preloadedAgentSkills]) : resolveConfiguredAgentSkills(options?.agent?.skills, { rootDir: root });
+		return publishedAgentSkills;
+	}
 	const entry = options?.entry ?? readEntry(root);
 	const docsPath = normalizeDocsPublicPath(options?.docsPath ?? readDocsPath(root), entry);
 	const analytics = options?.analytics;
@@ -2743,7 +2747,7 @@ function createDocsAPI(options) {
 			request,
 			preferredSkillDocument: needsSkill ? readRootSkillDocument(root) : null,
 			fallbackSkillDocument,
-			publishedSkills: await publishedAgentSkills,
+			publishedSkills: needsSkill ? await getPublishedAgentSkills() : [],
 			agentCard: options?.agent?.a2a,
 			origin: url.origin,
 			entry,
@@ -2839,7 +2843,7 @@ function createDocsAPI(options) {
 							robots: robotsConfig,
 							openapi: openapiDiscovery
 						})
-					}), ...await publishedAgentSkills],
+					}), ...await getPublishedAgentSkills()],
 					agentCard: options?.agent?.a2a
 				}), { headers: {
 					"Cache-Control": "public, max-age=0, s-maxage=3600",
@@ -3275,6 +3279,11 @@ function createDocsMCPAPI(options = {}) {
 	const contentDir = options.contentDir ?? path.join(appDir, entry);
 	const mcpConfig = options.mcp ?? readMcpConfig(rootDir, { rejectRuntimeSecurity: true });
 	const navTitle = typeof options.nav?.title === "string" && options.nav.title.trim().length > 0 ? options.nav.title : "Documentation";
+	let configuredAgentSkills;
+	function getConfiguredAgentSkills() {
+		if (!configuredAgentSkills) configuredAgentSkills = Array.isArray(options._preloadedAgentSkills) ? Promise.resolve([...options._preloadedAgentSkills]) : resolveConfiguredAgentSkills(options.agent?.skills, { rootDir });
+		return configuredAgentSkills;
+	}
 	const handlers = createDocsMcpHttpHandler({
 		source: {
 			...createFilesystemDocsMcpSource({
@@ -3285,7 +3294,7 @@ function createDocsMCPAPI(options = {}) {
 				ordering: options.ordering
 			}),
 			async getSkills() {
-				const configured = await resolveConfiguredAgentSkills(options.agent?.skills, { rootDir });
+				const configured = await getConfiguredAgentSkills();
 				return [await resolveDocsPublishedAgentSkill({
 					preferredDocument: readRootSkillDocument(rootDir),
 					fallbackDocument: `---\nname: docs\ndescription: Use the project documentation through MCP resources and tools.\n---\n\n# Documentation\n`

package/package.json

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