@farming-labs/theme 0.2.74 → 0.2.77

package/dist/docs-api.mjs

@@ -4,8 +4,8 @@ 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_MARKDOWN_SECTION_INDEX_FORMAT, acceptsDocsMarkdown, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMcpProtectedResourceMetadataRoutes, hasDocsMarkdownSignatureAgent, inferDocsTelemetryAgentSurface, isDocsConfigRequest, isDocsDiagnosticsRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, performDocsSearch, performDocsSearchWithMetadata, renderDocsLlmsTxt, renderDocsMarkdownDocument, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAudienceMdxContent, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLlmsTxtSections, resolveDocsLocale, resolveDocsMetadataBaseUrl, resolveDocsPublishedAgentSkill, resolveDocsRequestApiRoute, resolveDocsRetrievalLastModified, resolveDocsSearchAudience, resolveDocsSearchFilters, resolveDocsSitemapConfig, resolveDocsStandardsDiscoveryRequest, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, selectDocsLlmsTxtContent, stripGeneratedAgentProvenance } from "@farming-labs/docs";
-import { buildApiReferenceOpenApiDocumentAsync, createDocsMcpHttpHandler, createFilesystemDocsMcpSource, readDocsSitemapManifest, resolveApiReferenceConfig, resolveConfiguredAgentSkills, resolveDocsMcpConfig } from "@farming-labs/docs/server";
+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_MARKDOWN_SECTION_INDEX_FORMAT, acceptsDocsMarkdown, buildDocsAskAIContext, buildDocsConfigMap, buildDocsDiagnostics, createDocsAgentTraceContext, createDocsAgentTraceId, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsStandardsDiscoveryResponse, detectDocsMarkdownAgentRequest, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, getDocsLlmsTxtMaxCharsIssue, getDocsMcpProtectedResourceMetadataRoutes, hasDocsMarkdownSignatureAgent, inferDocsTelemetryAgentSurface, isDocsConfigRequest, isDocsDiagnosticsRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, performDocsSearch, performDocsSearchWithMetadata, renderDocsLlmsTxt, renderDocsMarkdownDocument, resolveAskAISearchRequestConfig, resolveChangelogConfig, resolveDocsAgentContractMcpTools, resolveDocsAudienceMdxContent, 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, resolveApiReferenceOpenApiDiscovery, resolveConfiguredAgentSkills, resolveDocsMcpConfig } from "@farming-labs/docs/server";
 
 //#region src/docs-api.ts
 /**
@@ -197,18 +197,6 @@ function isRobotsDiscoveryEnabled(robots) {
 function isApiReferenceOpenApiRequest(url) {
 	return url.searchParams.get("format")?.trim() === "openapi";
 }
-function resolveApiReferenceOpenApiDiscovery(value) {
-	const apiReference = resolveApiReferenceConfig(value);
-	if (!apiReference.enabled) return { enabled: false };
-	return {
-		enabled: true,
-		url: `${DEFAULT_DOCS_API_ROUTE}?format=openapi`,
-		urlSource: "default",
-		source: apiReference.specUrl ? "configured" : "generated",
-		specUrl: apiReference.specUrl,
-		apiReferencePath: `/${apiReference.path}`
-	};
-}
 function buildAgentSpec({ origin, entry, apiRoute, apiCatalog, i18n, search, mcp, feedback, llms, sitemap, robots, openapi, publishedSkills = [], agentCard }) {
 	const normalizedEntry = normalizePathSegment(entry) || "docs";
 	const localesEnabled = i18n !== null;
@@ -426,6 +414,10 @@ function buildAgentSpec({ origin, entry, apiRoute, apiCatalog, i18n, search, mcp
 				"tags"
 			],
 			warningsField: "warnings",
+			cursorParam: "cursor",
+			nextCursorField: "nextCursor",
+			hasMoreField: "hasMore",
+			totalField: "total",
 			defaultAudience: "human",
 			supportedAudiences: ["human", "agent"]
 		},
@@ -742,6 +734,7 @@ function readMcpConfig(root, options = {}) {
 				tools: {
 					listDocs: readBooleanFromBlock(block, "listDocs"),
 					listPages: readBooleanFromBlock(block, "listPages"),
+					listPageSections: readBooleanFromBlock(block, "listPageSections"),
 					listTasks: readBooleanFromBlock(block, "listTasks"),
 					readTask: readBooleanFromBlock(block, "readTask"),
 					readPage: readBooleanFromBlock(block, "readPage"),
@@ -2461,8 +2454,10 @@ function readApiReferenceConfig(root) {
 			const pathMatch = block.match(/path\s*:\s*["']([^"']+)["']/);
 			const routeRootMatch = block.match(/routeRoot\s*:\s*["']([^"']+)["']/);
 			const specUrlMatch = block.match(/specUrl\s*:\s*["']([^"']+)["']/);
+			const catalogTargetsMatch = block.match(/catalogTargets\s*:\s*\[([\s\S]*?)\]/);
 			const rendererMatch = block.match(/renderer\s*:\s*["'](fumadocs|scalar)["']/);
 			const excludeMatch = block.match(/exclude\s*:\s*\[([\s\S]*?)\]/);
+			const catalogTargets = catalogTargetsMatch?.[1] === void 0 ? void 0 : Array.from(catalogTargetsMatch[1].matchAll(/["']([^"']+)["']/g)).map((match) => match[1]).filter(Boolean);
 			const exclude = excludeMatch?.[1] === void 0 ? void 0 : Array.from(excludeMatch[1].matchAll(/["']([^"']+)["']/g)).map((match) => match[1]).filter(Boolean);
 			const renderer = rendererMatch?.[1] === "fumadocs" || rendererMatch?.[1] === "scalar" ? rendererMatch[1] : void 0;
 			return {
@@ -2470,6 +2465,7 @@ function readApiReferenceConfig(root) {
 				path: pathMatch?.[1],
 				routeRoot: routeRootMatch?.[1],
 				specUrl: specUrlMatch?.[1],
+				catalogTargets,
 				renderer,
 				exclude
 			};
@@ -3165,8 +3161,15 @@ function createDocsAPI(options) {
 			}
 			const query = url.searchParams.get("query")?.trim();
 			const audience = resolveDocsSearchAudience(url.searchParams.get("audience"));
-			const filters = resolveDocsSearchFilters(url.searchParams);
-			const structured = url.searchParams.get("response") === "structured";
+			let searchRequest;
+			try {
+				searchRequest = resolveDocsSearchRequest(url.searchParams);
+			} catch (error) {
+				const searchError = resolveDocsSearchError(error);
+				if (!searchError) throw error;
+				return Response.json({ error: searchError }, { status: 400 });
+			}
+			const { filters, structured, cursor, limit } = searchRequest;
 			if (!query && !structured) return new Response("[]", { headers: { "Content-Type": "application/json" } });
 			const searchOptions = {
 				pages: getIndexes(ctx),
@@ -3178,19 +3181,25 @@ function createDocsAPI(options) {
 				pathname: url.searchParams.get("pathname") ?? void 0,
 				siteTitle: llmsConfig.siteTitle ?? "Documentation",
 				baseUrl: markdownMetadataBaseUrl || url.origin,
-				syncBaseUrl: markdownMetadataBaseUrl ?? null
+				syncBaseUrl: markdownMetadataBaseUrl ?? null,
+				cursor,
+				limit
 			};
-			if (!query) {
-				const searchResponse = structured ? await performDocsSearchWithMetadata(searchOptions) : [];
-				return new Response(JSON.stringify(searchResponse), { headers: { "Content-Type": "application/json" } });
-			}
 			const searchStartedAt = Date.now();
-			const searchResponse = structured ? await performDocsSearchWithMetadata(searchOptions) : await performDocsSearch(searchOptions);
+			let searchResponse;
+			try {
+				searchResponse = structured ? await performDocsSearchWithMetadata(searchOptions) : query ? await performDocsSearch(searchOptions) : [];
+			} catch (error) {
+				const searchError = resolveDocsSearchError(error);
+				if (!searchError) throw error;
+				return Response.json({ error: searchError }, { status: 400 });
+			}
+			if (!query) return Response.json(searchResponse);
 			const resultCount = Array.isArray(searchResponse) ? searchResponse.length : searchResponse.resultCount;
 			await emitDocsAnalyticsEvent(analytics, {
 				type: "api_search",
 				source: "server",
-				url: request.url,
+				url: `${url.origin}${url.pathname}`,
 				path: url.pathname,
 				locale: ctx.locale,
 				input: { query },

package/package.json

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