@farming-labs/svelte 0.2.60 → 0.2.62

package/dist/server.js

@@ -30,8 +30,8 @@
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, buildDocsConfigMap, buildDocsDiagnostics, createDocsStandardsDiscoveryResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsDiscoveryLinkHeader, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, performDocsSearch, renderDocsMarkdownDocument, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAudienceMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsRequestApiRoute, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, inferDocsTelemetryAgentSurface, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
-import { buildApiReferenceOpenApiDocumentAsync, createDocsCloudAskAIResponse, createDocsMcpHttpHandler, isDocsCloudAskAIProvider, readDocsSitemapManifest, resolveApiReferenceConfig, resolveDocsMcpConfig, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
+import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, buildDocsConfigMap, buildDocsDiagnostics, createDocsStandardsDiscoveryResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsDiscoveryLinkHeader, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsSkillRequest, isDocsStandardsDiscoveryRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, performDocsSearch, renderDocsMarkdownDocument, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAudienceMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveDocsSearchAudience, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsRequestApiRoute, resolveDocsPublishedAgentSkill, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, inferDocsTelemetryAgentSurface, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
+import { buildApiReferenceOpenApiDocumentAsync, createDocsCloudAskAIResponse, createDocsMcpHttpHandler, isDocsCloudAskAIProvider, readDocsSitemapManifest, resolveApiReferenceConfig, resolveDocsMcpConfig, resolveConfiguredAgentSkills, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
 export { createSvelteApiReference } from "./api-reference.js";
@@ -405,6 +405,9 @@ export function createDocsServer(config = {}) {
     const observability = config.observability;
     const contentDirBase = config.contentDir ?? entry;
     const rootDir = path.resolve(config.rootDir ?? process.cwd());
+    const publishedAgentSkills = Array.isArray(config._preloadedAgentSkills)
+        ? Promise.resolve(config._preloadedAgentSkills)
+        : resolveConfiguredAgentSkills(config.agent?.skills, { rootDir });
     const i18n = resolveDocsI18n(config.i18n);
     const githubRaw = config.github;
     const github = typeof githubRaw === "string" ? { url: githubRaw } : (githubRaw ?? null);
@@ -646,6 +649,7 @@ export function createDocsServer(config = {}) {
         : undefined;
     const discoveryLinkHeader = getDocsDiscoveryLinkHeader({
         includeApiCatalog: apiCatalogEnabled,
+        includeAgentCard: Boolean(config.agent?.a2a),
     });
     const openapiDiscovery = resolveApiReferenceOpenApiDiscovery(config.apiReference);
     const mcpConfig = resolveDocsMcpConfig(config.mcp, {
@@ -773,12 +777,24 @@ export function createDocsServer(config = {}) {
                 ...discoveryOptions,
                 preferredSkillDocument: readRootSkillDocument(preloaded, rootDir),
                 fallbackSkillDocument: renderDocsSkillDocument(discoveryOptions),
+                publishedSkills: await publishedAgentSkills,
+                agentCard: config.agent?.a2a,
             });
             if (standardsDiscoveryResponse)
                 return standardsDiscoveryResponse;
         }
         if (isDocsAgentDiscoveryRequest(event.url, { apiRoute: discoveryApiRoute })) {
-            return new Response(JSON.stringify(buildDocsAgentDiscoverySpec(discoveryOptions), null, 2), {
+            return new Response(JSON.stringify(buildDocsAgentDiscoverySpec({
+                ...discoveryOptions,
+                publishedSkills: [
+                    await resolveDocsPublishedAgentSkill({
+                        preferredDocument: readRootSkillDocument(preloaded, rootDir),
+                        fallbackDocument: renderDocsSkillDocument(discoveryOptions),
+                    }),
+                    ...(await publishedAgentSkills),
+                ],
+                agentCard: config.agent?.a2a,
+            }), null, 2), {
                 headers: {
                     "Content-Type": "application/json; charset=utf-8",
                     "Cache-Control": "public, max-age=0, s-maxage=3600",
@@ -864,6 +880,7 @@ export function createDocsServer(config = {}) {
         if (sitemapResponse)
             return sitemapResponse;
         const robotsResponse = createDocsRobotsResponse({
+            agentCard: Boolean(config.agent?.a2a),
             request: event.request,
             entry,
             apiCatalog: apiCatalogEnabled,
@@ -942,13 +959,16 @@ export function createDocsServer(config = {}) {
             });
         }
         const searchStartedAt = Date.now();
+        const audience = resolveDocsSearchAudience(event.url.searchParams.get("audience"));
         const results = await performDocsSearch({
             pages: getSearchIndex(ctx),
             query,
             search: resolveSearchRequestConfig(config.search, event.request.url),
+            audience,
             locale: ctx.locale,
             pathname: event.url.searchParams.get("pathname") ?? undefined,
             siteTitle: llmsTitle,
+            baseUrl: markdownMetadataBaseUrl || event.url.origin,
         });
         await emitDocsAnalyticsEvent(analytics, {
             type: "api_search",
@@ -959,6 +979,7 @@ export function createDocsServer(config = {}) {
             input: { query },
             properties: {
                 queryLength: query.length,
+                audience,
                 resultCount: results.length,
                 pathname: event.url.searchParams.get("pathname") ?? undefined,
                 durationMs: Math.max(0, Date.now() - searchStartedAt),
@@ -1516,6 +1537,37 @@ export function createDocsServer(config = {}) {
                     defaultBehavior: "toggle",
                 });
             },
+            async getSkills(context) {
+                const origin = context?.request
+                    ? new URL(context.request.url).origin
+                    : llmsBaseUrl || "http://localhost";
+                const skillOptions = {
+                    origin,
+                    entry,
+                    apiRoute: configuredApiRoute,
+                    docsPath: config.docsPath,
+                    apiCatalog: apiCatalogEnabled,
+                    i18n,
+                    search: config.search,
+                    mcp: mcpConfig,
+                    feedback: agentFeedbackDiscovery,
+                    llms: {
+                        enabled: llmsEnabled,
+                        apiCatalog: apiCatalogEnabled,
+                        baseUrl: llmsBaseUrl || undefined,
+                        siteTitle: llmsTitle,
+                        siteDescription: llmsDesc,
+                    },
+                    sitemap: config.sitemap,
+                    robots: config.robots,
+                    openapi: openapiDiscovery,
+                };
+                const rootSkill = await resolveDocsPublishedAgentSkill({
+                    preferredDocument: readRootSkillDocument(preloaded, rootDir),
+                    fallbackDocument: renderDocsSkillDocument(skillOptions),
+                });
+                return [rootSkill, ...(await publishedAgentSkills)];
+            },
         },
         mcp: config.mcp,
         analytics,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/svelte",
-  "version": "0.2.60",
+  "version": "0.2.62",
   "description": "SvelteKit adapter for @farming-labs/docs — content loading and navigation utilities",
   "keywords": [
     "docs",
@@ -56,7 +56,7 @@
   "devDependencies": {
     "@types/node": "^22.10.0",
     "typescript": "^5.9.3",
-    "@farming-labs/docs": "0.2.60"
+    "@farming-labs/docs": "0.2.62"
   },
   "peerDependencies": {
     "@farming-labs/docs": "*"