@farming-labs/docs 0.2.59 → 0.2.61

package/dist/{templates-CfQjpDWW.mjs → templates-Bq_P7ctv.mjs}

@@ -752,11 +752,13 @@ export default defineDocs({
 function tanstackDocsServerTemplate() {
 	return `\
 import { createDocsServer } from "@farming-labs/tanstack-start/server";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
 import docsConfig from "../../docs.config";
 
 export const docsServer = createDocsServer({
   ...docsConfig,
   rootDir: process.cwd(),
+  _preloadedAgentSkills: bundledAgentSkills,
 });
 `;
 }
@@ -886,6 +888,7 @@ function tanstackDocsPublicRouteTemplate(useAlias, filePath, entry) {
 import { createFileRoute } from "@tanstack/react-router";
 import { isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
 import { docsServer } from "${useAlias ? "@/lib/docs.server" : relativeImport(filePath, "src/lib/docs.server.ts")}";
+import docsConfig from "${tanstackDocsConfigImport(filePath)}";
 
 const docsEntry = ${JSON.stringify(entry)};
 
@@ -893,7 +896,7 @@ async function handlePublicDocsRequest(request: Request) {
   const url = new URL(request.url);
   const method = request.method.toUpperCase();
 
-  if (isDocsMcpRequest(url)) {
+  if (isDocsMcpRequest(url, docsConfig.mcp)) {
     if (method === "OPTIONS") return docsServer.MCP.OPTIONS({ request });
     if (method === "POST") return docsServer.MCP.POST({ request });
     if (method === "DELETE") return docsServer.MCP.DELETE({ request });
@@ -989,22 +992,55 @@ function tanstackViteConfigTemplate(useAlias) {
 import { defineConfig } from "vite";
 import tailwindcss from "@tailwindcss/vite";
 ${useAlias ? "import tsconfigPaths from \"vite-tsconfig-paths\";\n" : ""}import { tanstackStart } from "@tanstack/react-start/plugin/vite";
+import { docsAgentSkills } from "@farming-labs/docs/vite";
 import { docsMdx } from "@farming-labs/tanstack-start/vite";
+import docsConfig from "./docs.config";
 
 export default defineConfig({
-  plugins: [tailwindcss(), docsMdx(), ${useAlias ? "tsconfigPaths({ ignoreConfigErrors: true }), " : ""}tanstackStart()],
+  plugins: [tailwindcss(), docsMdx(), docsAgentSkills(docsConfig), ${useAlias ? "tsconfigPaths({ ignoreConfigErrors: true }), " : ""}tanstackStart()],
 });
 `;
 }
+function svelteViteConfigTemplate() {
+	return `\
+import { sveltekit } from "@sveltejs/kit/vite";
+import { defineConfig } from "vite";
+import { docsAgentSkills } from "@farming-labs/docs/vite";
+import docsConfig from "./src/lib/docs.config";
+
+export default defineConfig({
+  plugins: [sveltekit(), docsAgentSkills(docsConfig)],
+});
+`;
+}
+/** Add the Agent Skills snapshot plugin to an existing Vite config. */
+function injectDocsAgentSkillsVitePlugin(content, configImportPath) {
+	if (!content) return null;
+	let out = addImportLine(content, "import { docsAgentSkills } from \"@farming-labs/docs/vite\";");
+	out = addImportLine(out, `import docsConfig from ${JSON.stringify(configImportPath)};`);
+	if (out.includes("docsAgentSkills(docsConfig)")) return out === content ? null : out;
+	const pluginsMatch = out.match(/plugins\s*:\s*\[([\s\S]*?)\]/m);
+	if (pluginsMatch) {
+		const current = pluginsMatch[1].trim();
+		const existing = current ? `${current}${current.endsWith(",") ? "" : ","}` : "";
+		return out.replace(pluginsMatch[0], `plugins: [${existing}${existing ? " " : ""}docsAgentSkills(docsConfig)]`);
+	}
+	const configMatch = out.match(/defineConfig\(\s*\{/);
+	if (!configMatch) return null;
+	return out.replace(configMatch[0], "defineConfig({\n  plugins: [docsAgentSkills(docsConfig)],");
+}
 function injectTanstackVitePlugins(content, useAlias) {
 	if (!content) return null;
 	let out = content;
 	out = addImportLine(out, "import tailwindcss from \"@tailwindcss/vite\";");
 	if (useAlias) out = addImportLine(out, "import tsconfigPaths from \"vite-tsconfig-paths\";");
 	out = addImportLine(out, "import { docsMdx } from \"@farming-labs/tanstack-start/vite\";");
+	out = addImportLine(out, "import { docsAgentSkills } from \"@farming-labs/docs/vite\";");
+	out = addImportLine(out, "import docsConfig from \"./docs.config\";");
 	const additions = [];
 	if (!out.includes("tailwindcss()")) additions.push("tailwindcss()");
 	if (!out.includes("docsMdx()")) additions.push("docsMdx()");
+	if (!out.includes("docsAgentSkills(")) additions.push("docsAgentSkills(docsConfig)");
 	if (useAlias && !out.includes("tsconfigPaths(")) additions.push("tsconfigPaths({ ignoreConfigErrors: true })");
 	if (additions.length === 0) return out === content ? null : out;
 	const pluginsMatch = out.match(/plugins\s*:\s*\[([\s\S]*?)\]/m);
@@ -1242,6 +1278,7 @@ export default defineDocs({
 function svelteDocsServerTemplate(cfg) {
 	return `\
 import { createDocsServer } from "@farming-labs/svelte/server";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
 import config from "${svelteServerConfigImport(cfg.useAlias)}";
 
 // preload for production
@@ -1254,6 +1291,7 @@ const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx,svx
 export const { load, GET, POST, MCP } = createDocsServer({
   ...config,
   _preloadedContent: contentFiles,
+  _preloadedAgentSkills: bundledAgentSkills,
 });
 `;
 }
@@ -1314,7 +1352,7 @@ const docsEntry = config.entry ?? "docs";
 export const handle: Handle = async ({ event, resolve }) => {
   const method = event.request.method.toUpperCase();
 
-  if (isDocsMcpRequest(event.url)) {
+  if (isDocsMcpRequest(event.url, config.mcp)) {
     if (method === "OPTIONS") return MCP.OPTIONS({ request: event.request });
     if (method === "POST") return MCP.POST({ request: event.request });
     if (method === "DELETE") return MCP.DELETE({ request: event.request });
@@ -1368,7 +1406,7 @@ const docsEntry = docsConfig.entry ?? "docs";
 const docsPublicHandle: Handle = async ({ event, resolve }) => {
   const method = event.request.method.toUpperCase();
 
-  if (isDocsMcpRequest(event.url)) {
+  if (isDocsMcpRequest(event.url, docsConfig.mcp)) {
     if (method === "OPTIONS") return docsMCP.OPTIONS({ request: event.request });
     if (method === "POST") return docsMCP.POST({ request: event.request });
     if (method === "DELETE") return docsMCP.DELETE({ request: event.request });
@@ -1659,6 +1697,7 @@ export default defineDocs({
 function astroDocsServerTemplate(cfg) {
 	return `\
 import { createDocsServer } from "@farming-labs/astro/server";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
 import config from "${astroServerConfigImport(cfg.useAlias)}";
 
 const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx}", "/AGENTS.md", "/AGENT.md", "/skill.md", "/.farming-labs/sitemap-manifest.json"], {
@@ -1670,6 +1709,7 @@ const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx}",
 export const { load, GET, POST, MCP } = createDocsServer({
   ...config,
   _preloadedContent: contentFiles,
+  _preloadedAgentSkills: bundledAgentSkills,
 });
 `;
 }
@@ -1700,13 +1740,34 @@ function astroConfigTemplate(adapter = "vercel") {
 	return `\
 import { defineConfig } from "astro/config";
 import ${adapter} from "${info.import}";
+import { docsAgentSkills } from "@farming-labs/docs/vite";
+import docsConfig from "./src/lib/docs.config";
 
 export default defineConfig({
   output: "server",
   adapter: ${adapterCall},
+  vite: { plugins: [docsAgentSkills(docsConfig)] },
 });
 `;
 }
+/** Add the Agent Skills snapshot plugin to an existing Astro config. */
+function injectAstroAgentSkillsPlugin(content) {
+	if (!content) return null;
+	let out = addImportLine(content, "import { docsAgentSkills } from \"@farming-labs/docs/vite\";");
+	out = addImportLine(out, "import docsConfig from \"./src/lib/docs.config\";");
+	if (out.includes("docsAgentSkills(docsConfig)")) return out === content ? null : out;
+	const vitePlugins = out.match(/(vite\s*:\s*\{[\s\S]*?plugins\s*:\s*\[)([\s\S]*?)(\])/m);
+	if (vitePlugins) {
+		const current = vitePlugins[2].trim();
+		const next = `${current}${current && !current.endsWith(",") ? "," : ""}${current ? " " : ""}docsAgentSkills(docsConfig)`;
+		return out.replace(vitePlugins[0], `${vitePlugins[1]}${next}${vitePlugins[3]}`);
+	}
+	const viteBlock = out.match(/vite\s*:\s*\{/);
+	if (viteBlock) return out.replace(viteBlock[0], `${viteBlock[0]}\n    plugins: [docsAgentSkills(docsConfig)],`);
+	const configMatch = out.match(/defineConfig\(\s*\{/);
+	if (!configMatch) return null;
+	return out.replace(configMatch[0], "defineConfig({\n  vite: { plugins: [docsAgentSkills(docsConfig)] },");
+}
 function astroDocsPageTemplate(cfg) {
 	return `\
 ---
@@ -1790,7 +1851,7 @@ const docsEntry = config.entry ?? "docs";
 export const onRequest: MiddlewareHandler = async (context, next) => {
   const method = context.request.method.toUpperCase();
 
-  if (isDocsMcpRequest(context.url)) {
+  if (isDocsMcpRequest(context.url, config.mcp)) {
     if (method === "OPTIONS") return MCP.OPTIONS({ request: context.request });
     if (method === "POST") return MCP.POST({ request: context.request });
     if (method === "DELETE") return MCP.DELETE({ request: context.request });
@@ -1844,7 +1905,7 @@ const docsEntry = docsConfig.entry ?? "docs";
 const docsPublicMiddleware: MiddlewareHandler = async (context, next) => {
   const method = context.request.method.toUpperCase();
 
-  if (isDocsMcpRequest(context.url)) {
+  if (isDocsMcpRequest(context.url, docsConfig.mcp)) {
     if (method === "OPTIONS") return docsMCP.OPTIONS({ request: context.request });
     if (method === "POST") return docsMCP.POST({ request: context.request });
     if (method === "DELETE") return docsMCP.DELETE({ request: context.request });
@@ -2116,17 +2177,25 @@ export default defineDocs({
 function nuxtServerApiDocsRouteTemplate(cfg) {
 	return `\
 import { defineDocsHandler } from "@farming-labs/nuxt/server";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
 import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
 
-export default defineDocsHandler(config, useStorage);
+export default defineDocsHandler(
+  { ...config, _preloadedAgentSkills: bundledAgentSkills },
+  useStorage,
+);
 `;
 }
 function nuxtServerDocsPublicMiddlewareTemplate(cfg) {
 	return `\
 import { defineDocsPublicHandler } from "@farming-labs/nuxt/server";
+import { bundledAgentSkills } from "@farming-labs/docs/agent-skills-bundle";
 import config from "${cfg.useAlias ? "~/docs.config" : "../../docs.config"}";
 
-export default defineDocsPublicHandler(config, useStorage);
+export default defineDocsPublicHandler(
+  { ...config, _preloadedAgentSkills: bundledAgentSkills },
+  useStorage,
+);
 `;
 }
 function nuxtServerApiReferenceRouteTemplate(filePath, useAlias) {
@@ -2171,6 +2240,9 @@ if (error.value) {
 }
 function nuxtConfigTemplate(cfg) {
 	return `\
+import { docsAgentSkills } from "@farming-labs/docs/vite";
+import docsConfig from "./docs.config";
+
 export default defineNuxtConfig({
   compatibilityDate: "2024-11-01",
 
@@ -2185,10 +2257,31 @@ export default defineNuxtConfig({
   nitro: {
     moduleSideEffects: ["@farming-labs/nuxt/server"],
     serverAssets: [{ baseName: "${cfg.entry}", dir: "${cfg.entry}" }],
+    rollupConfig: { plugins: [docsAgentSkills(docsConfig)] },
   },
 });
 `;
 }
+/** Add the Agent Skills snapshot plugin to Nitro's server Rollup build. */
+function injectNuxtAgentSkillsPlugin(content) {
+	if (!content) return null;
+	let out = addImportLine(content, "import { docsAgentSkills } from \"@farming-labs/docs/vite\";");
+	out = addImportLine(out, "import docsConfig from \"./docs.config\";");
+	if (out.includes("docsAgentSkills(docsConfig)")) return out === content ? null : out;
+	const rollupPlugins = out.match(/(rollupConfig\s*:\s*\{[\s\S]*?plugins\s*:\s*\[)([\s\S]*?)(\])/m);
+	if (rollupPlugins) {
+		const current = rollupPlugins[2].trim();
+		const next = `${current}${current && !current.endsWith(",") ? "," : ""}${current ? " " : ""}docsAgentSkills(docsConfig)`;
+		return out.replace(rollupPlugins[0], `${rollupPlugins[1]}${next}${rollupPlugins[3]}`);
+	}
+	const rollupBlock = out.match(/rollupConfig\s*:\s*\{/);
+	if (rollupBlock) return out.replace(rollupBlock[0], `${rollupBlock[0]}\n      plugins: [docsAgentSkills(docsConfig)],`);
+	const nitroBlock = out.match(/nitro\s*:\s*\{/);
+	if (nitroBlock) return out.replace(nitroBlock[0], `${nitroBlock[0]}\n    rollupConfig: { plugins: [docsAgentSkills(docsConfig)] },`);
+	const configMatch = out.match(/defineNuxtConfig\(\s*\{/);
+	if (!configMatch) return null;
+	return out.replace(configMatch[0], "defineNuxtConfig({\n  nitro: { rollupConfig: { plugins: [docsAgentSkills(docsConfig)] } },");
+}
 function nuxtWelcomePageTemplate(cfg) {
 	return `\
 ---
@@ -2369,4 +2462,4 @@ function injectNuxtCssImport(existingContent, theme, customThemeName, globalCssR
 }
 
 //#endregion
-export { svelteDocsPublicHookTemplate as $, nextConfigMergedTemplate as A, nuxtServerApiDocsRouteTemplate as B, injectRootProviderIntoLayout as C, injectTanstackVitePlugins as D, injectTanstackRootProviderIntoRoute as E, nuxtDocsConfigTemplate as F, quickstartPageTemplate as G, nuxtServerDocsPublicMiddlewareTemplate as H, nuxtDocsPageTemplate as I, svelteDocsApiRouteTemplate as J, rootLayoutTemplate as K, nuxtGlobalCssTemplate as L, nextLocaleDocPageTemplate as M, nextLocalizedPageTemplate as N, installationPageTemplate as O, nuxtConfigTemplate as P, svelteDocsPageTemplate as Q, nuxtInstallationPageTemplate as R, injectNuxtCssImport as S, injectSvelteDocsPublicHook as T, nuxtWelcomePageTemplate as U, nuxtServerApiReferenceRouteTemplate as V, postcssConfigTemplate as W, svelteDocsLayoutServerTemplate as X, svelteDocsConfigTemplate as Y, svelteDocsLayoutTemplate as Z, getAstroAdapterPkg as _, tanstackViteConfigTemplate as _t, astroDocsIndexTemplate as a, svelteWelcomePageTemplate as at, injectAstroDocsMiddleware as b, welcomePageTemplate as bt, astroDocsServerTemplate as c, tanstackDocsCatchAllRouteTemplate as ct, astroQuickstartPageTemplate as d, tanstackDocsIndexRouteTemplate as dt, svelteDocsServerTemplate as et, astroWelcomePageTemplate as f, tanstackDocsPublicRouteTemplate as ft, docsLayoutTemplate as g, tanstackRootRouteTemplate as gt, docsConfigTemplate as h, tanstackQuickstartPageTemplate as ht, astroDocsConfigTemplate as i, svelteRootLayoutTemplate as it, nextConfigTemplate as j, nextApiReferencePageTemplate as k, astroGlobalCssTemplate as l, tanstackDocsConfigTemplate as lt, customThemeTsTemplate as m, tanstackInstallationPageTemplate as mt, astroApiRouteTemplate as n, svelteInstallationPageTemplate as nt, astroDocsMiddlewareTemplate as o, tanstackApiDocsRouteTemplate as ot, customThemeCssTemplate as p, tanstackDocsServerTemplate as pt, svelteApiReferenceRouteTemplate as q, astroConfigTemplate as r, svelteQuickstartPageTemplate as rt, astroDocsPageTemplate as s, tanstackApiReferenceRouteTemplate as st, astroApiReferenceRouteTemplate as t, svelteGlobalCssTemplate as tt, astroInstallationPageTemplate as u, tanstackDocsFunctionsTemplate as ut, globalCssTemplate as v, tanstackWelcomePageTemplate as vt, injectSvelteCssImport as w, injectCssImport as x, injectAstroCssImport as y, tsconfigTemplate as yt, nuxtQuickstartPageTemplate as z };
+export { svelteDocsLayoutServerTemplate as $, injectTanstackVitePlugins as A, nuxtGlobalCssTemplate as B, injectDocsAgentSkillsVitePlugin as C, tsconfigTemplate as Ct, injectSvelteCssImport as D, injectRootProviderIntoLayout as E, nextLocaleDocPageTemplate as F, nuxtServerDocsPublicMiddlewareTemplate as G, nuxtQuickstartPageTemplate as H, nextLocalizedPageTemplate as I, quickstartPageTemplate as J, nuxtWelcomePageTemplate as K, nuxtConfigTemplate as L, nextApiReferencePageTemplate as M, nextConfigMergedTemplate as N, injectSvelteDocsPublicHook as O, nextConfigTemplate as P, svelteDocsConfigTemplate as Q, nuxtDocsConfigTemplate as R, injectCssImport as S, tanstackWelcomePageTemplate as St, injectNuxtCssImport as T, nuxtServerApiDocsRouteTemplate as U, nuxtInstallationPageTemplate as V, nuxtServerApiReferenceRouteTemplate as W, svelteApiReferenceRouteTemplate as X, rootLayoutTemplate as Y, svelteDocsApiRouteTemplate as Z, getAstroAdapterPkg as _, tanstackDocsServerTemplate as _t, astroDocsIndexTemplate as a, svelteInstallationPageTemplate as at, injectAstroCssImport as b, tanstackRootRouteTemplate as bt, astroDocsServerTemplate as c, svelteViteConfigTemplate as ct, astroQuickstartPageTemplate as d, tanstackApiReferenceRouteTemplate as dt, svelteDocsLayoutTemplate as et, astroWelcomePageTemplate as f, tanstackDocsCatchAllRouteTemplate as ft, docsLayoutTemplate as g, tanstackDocsPublicRouteTemplate as gt, docsConfigTemplate as h, tanstackDocsIndexRouteTemplate as ht, astroDocsConfigTemplate as i, svelteGlobalCssTemplate as it, installationPageTemplate as j, injectTanstackRootProviderIntoRoute as k, astroGlobalCssTemplate as l, svelteWelcomePageTemplate as lt, customThemeTsTemplate as m, tanstackDocsFunctionsTemplate as mt, astroApiRouteTemplate as n, svelteDocsPublicHookTemplate as nt, astroDocsMiddlewareTemplate as o, svelteQuickstartPageTemplate as ot, customThemeCssTemplate as p, tanstackDocsConfigTemplate as pt, postcssConfigTemplate as q, astroConfigTemplate as r, svelteDocsServerTemplate as rt, astroDocsPageTemplate as s, svelteRootLayoutTemplate as st, astroApiReferenceRouteTemplate as t, svelteDocsPageTemplate as tt, astroInstallationPageTemplate as u, tanstackApiDocsRouteTemplate as ut, globalCssTemplate as v, tanstackInstallationPageTemplate as vt, injectNuxtAgentSkillsPlugin as w, welcomePageTemplate as wt, injectAstroDocsMiddleware as x, tanstackViteConfigTemplate as xt, injectAstroAgentSkillsPlugin as y, tanstackQuickstartPageTemplate as yt, nuxtDocsPageTemplate as z };

package/dist/{types-XHABMh_f.d.mts → types-EhFhYGfr.d.mts}

@@ -1227,6 +1227,8 @@ interface DocsMcpAuthenticateContext {
   request: Request;
   /** Normalized pathname of the MCP endpoint being requested. */
   pathname: string;
+  /** Canonical OAuth resource identifier for exact token audience validation. */
+  resource: string;
 }
 type DocsMcpAllowedOrigins = "same-origin" | readonly string[] | ((context: DocsMcpOriginContext) => boolean | Promise<boolean>);
 type DocsMcpAuthenticateResult = DocsMcpAuthPrincipal | null | Response;
@@ -1242,6 +1244,22 @@ interface DocsMcpCorsConfig {
   /** Browser preflight cache lifetime in seconds. Defaults to 600. */
   maxAgeSeconds?: number;
 }
+/** RFC 9728 discovery and endpoint-wide OAuth scope requirements for protected HTTP MCP. */
+interface DocsMcpProtectedResourceConfig {
+  /**
+   * OAuth authorization server issuer identifiers advertised to MCP clients.
+   * Requires at least one HTTPS URL without query or fragment; loopback HTTP is accepted for development.
+   */
+  authorizationServers: readonly string[];
+  /** OAuth scopes advertised through RFC 9728 `scopes_supported` metadata. */
+  scopesSupported?: readonly string[];
+  /** Scopes every authenticated HTTP MCP principal must have. */
+  requiredScopes?: readonly string[];
+  /** Human-readable protected-resource name. Defaults to the resolved MCP server name. */
+  resourceName?: string;
+  /** Absolute HTTP(S) URL of human-readable authentication guidance for this MCP resource. */
+  resourceDocumentation?: string;
+}
 /** Security controls for the Streamable HTTP MCP transport. */
 interface DocsMcpSecurityConfig {
   /**
@@ -1254,6 +1272,11 @@ interface DocsMcpSecurityConfig {
    * returning `null` rejects the request with 401 and returning a Response passes it through.
    */
   authenticate?: DocsMcpAuthenticate;
+  /**
+   * Opt-in OAuth protected-resource discovery. Requires `authenticate` to protect HTTP MCP.
+   * When active, adapters publish RFC 9728 metadata and framework-generated Bearer challenges.
+   */
+  protectedResource?: DocsMcpProtectedResourceConfig;
   /** Maximum POST body size in bytes. Defaults to 1 MiB. */
   maxBodyBytes?: number;
   /**
@@ -2506,6 +2529,36 @@ interface DocsAgentEvaluationsConfig {
   /** Golden tasks evaluated by `docs doctor` and `docs review`. */
   tasks?: DocsAgentGoldenTask[];
 }
+/**
+ * Project-local Agent Skills published by the runtime, static Agent Bundle, and MCP server.
+ *
+ * Each path may point at a `SKILL.md`, a skill directory containing `SKILL.md`, or a
+ * collection directory whose descendants contain `SKILL.md` files. Paths are resolved
+ * inside the current project/workspace boundary. Only `SKILL.md` and files below the
+ * standard `references/`, `scripts/`, and `assets/` directories are published.
+ */
+interface DocsAgentSkillsConfig {
+  /** Project-relative skill file, skill directory, or collection directory paths. */
+  paths: string | readonly string[];
+}
+/** Concise array shorthand for `agent.skills.paths`. */
+type DocsAgentSkillsInput = string | readonly string[] | DocsAgentSkillsConfig;
+/** Explicit A2A service metadata. Configure this only when the URL implements A2A. */
+interface DocsAgentA2AConfig {
+  interfaceUrl: string;
+  name: string;
+  description: string;
+  documentationUrl: string;
+  provider: {
+    organization: string;
+    url: string;
+  };
+  version?: string;
+  /** A2A protocol version exposed by the interface. @default "0.3" */
+  protocolVersion?: string;
+  /** Transport binding exposed by the interface. @default "HTTP+JSON" */
+  protocolBinding?: string;
+}
 interface DocsAgentConfig {
   /**
    * Defaults for `docs agent compact`.
@@ -2516,6 +2569,10 @@ interface DocsAgentConfig {
    * External providers and runtime execution require explicit opt-in.
    */
   evaluations?: boolean | DocsAgentEvaluationsConfig;
+  /** Publish reusable Agent Skills through standards discovery, static exports, and MCP. */
+  skills?: DocsAgentSkillsInput;
+  /** Opt in to an A2A Agent Card for a separately implemented A2A service. */
+  a2a?: DocsAgentA2AConfig;
 }
 type DocsReviewSeverity = "off" | "suggestion" | "warn" | "error";
 type DocsReviewCiMode = "off" | "warn" | "block";
@@ -3245,4 +3302,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-export { DocsCodeBlocksConfig as $, DocsTelemetryFramework as $t, DocsAgentGoldenTaskExpectation as A, ResolvedDocsRelatedLink as An, DocsReviewRulesConfig as At, DocsAnalyticsSource as B, TypesenseDocsSearchConfig as Bn, DocsSearchDocument as Bt, DocsAgentEvaluationsConfig as C, PageAgentVerification as Cn, DocsObservabilityConfig as Ct, DocsAgentGoldenExampleVerification as D, PageTwitter as Dn, DocsReviewCiConfig as Dt, DocsAgentGoldenAnswerExpectation as E, PageSidebarFrontmatter as En, DocsRelatedItem as Et, DocsAnalyticsConfig as F, SidebarNode as Fn, DocsSearchAdapter as Ft, DocsAskAIFeedbackMessage as G, DocsSearchSourcePage as Gt, DocsAskAIActionType as H, UIConfig as Hn, DocsSearchQuery as Ht, DocsAnalyticsEvent as I, SidebarPageNode as In, DocsSearchAdapterContext as It, DocsCloudApiKeyConfig as J, DocsTelemetryConfig as Jt, DocsAskAIFeedbackValue as K, DocsSitemapConfig as Kt, DocsAnalyticsEventInput as L, SidebarTree as Ln, DocsSearchAdapterFactory as Lt, DocsAgentTraceEventInput as M, SidebarConfig as Mn, DocsReviewSeverity as Mt, DocsAgentTraceEventType as N, SidebarFolderIndexBehavior as Nn, DocsRobotsConfig as Nt, DocsAgentGoldenExpectedExample as O, ReadingTimeConfig as On, DocsReviewCiMode as Ot, DocsAgentTraceStatus as P, SidebarFolderNode as Pn, DocsRobotsRule as Pt, DocsCloudPublishConfig as Q, DocsTelemetryFeatures as Qt, DocsAnalyticsEventType as R, SimpleDocsSearchConfig as Rn, DocsSearchChunkingConfig as Rt, DocsAgentEvaluationTaskInput as S, PageAgentFrontmatter as Sn, DocsNav as St, DocsAgentFeedbackData as T, PageOpenGraph as Tn, DocsObservabilityEventInput as Tt, DocsAskAIFeedbackConfig as U, DocsSearchResult as Ut, DocsAskAIActionData as V, TypographyConfig as Vn, DocsSearchEmbeddingsConfig as Vt, DocsAskAIFeedbackData as W, DocsSearchResultType as Wt, DocsCloudFeatureConfig as X, DocsTelemetryEventInput as Xt, DocsCloudConfig as Y, DocsTelemetryEvent as Yt, DocsCloudPreviewConfig as Z, DocsTelemetryEventType as Zt, DocsAgentEvaluationAnswerRequest as _, OrderingItem as _n, DocsMcpCorsConfig as _t, ApiReferenceRenderer as a, LlmsTxtConfig as an, DocsCodeBlocksValidationMode as at, DocsAgentEvaluationSourceReference as b, PageAgentCommand as bn, DocsMcpToolsConfig as bt, ChangelogFrontmatter as c, LlmsTxtSectionConfig as cn, DocsFeedbackData as ct, CopyMarkdownFormat as d, OpenDocsConfig as dn, DocsMcpAllowedOrigins as dt, DocsTheme as en, DocsCodeBlocksPlannerConfig as et, CustomDocsSearchConfig as f, OpenDocsProvider as fn, DocsMcpAuthPrincipal as ft, DocsAgentEvaluationAnswerProvider as g, OpenGraphImage as gn, DocsMcpConfig as gt, DocsAgentEvaluationAnswerInput as h, OpenDocsTarget as hn, DocsMcpAuthenticateResult as ht, ApiReferenceConfig as i, LastUpdatedConfig as in, DocsCodeBlocksValidateConfig as it, DocsAgentGoldenTaskFilters as j, SidebarComponentProps as jn, DocsReviewScoreConfig as jt, DocsAgentGoldenTask as k, ReadingTimeFormat as kn, DocsReviewConfig as kt, CodeBlockCopyData as l, McpDocsSearchConfig as ln, DocsFeedbackValue as lt, DocsAgentConfig as m, OpenDocsProviderId as mn, DocsMcpAuthenticateContext as mt, AgentFeedbackConfig as n, FontStyle as nn, DocsCodeBlocksRunnerConfig as nt, BreadcrumbConfig as o, LlmsTxtMaxCharsConfig as on, DocsCodeBlocksValidationPolicy as ot, DocsAgentCompactConfig as p, OpenDocsProviderConfig as pn, DocsMcpAuthenticate as pt, DocsAskAIMcpConfig as q, DocsTelemetryAgentSurface as qt, AlgoliaDocsSearchConfig as r, GithubConfig as rn, DocsCodeBlocksRunnerProvider as rt, ChangelogConfig as s, LlmsTxtMaxCharsMode as sn, DocsConfig as st, AIConfig as t, FeedbackConfig as tn, DocsCodeBlocksPlannerProvider as tt, CopyMarkdownConfig as u, OGConfig as un, DocsI18nConfig as ut, DocsAgentEvaluationAnswerResult as v, PageActionsConfig as vn, DocsMcpOriginContext as vt, DocsAgentFeedbackContext as w, PageFrontmatter as wn, DocsObservabilityEvent as wt, DocsAgentEvaluationSurface as x, PageAgentFailureMode as xn, DocsMetadata as xt, DocsAgentEvaluationAnswerRunner as y, PageAgentAppliesTo as yn, DocsMcpSecurityConfig as yt, DocsAnalyticsInput as z, ThemeToggleConfig as zn, DocsSearchConfig as zt };
+export { DocsCloudFeatureConfig as $, DocsTelemetryEvent as $t, DocsAgentGoldenTask as A, PageSidebarFrontmatter as An, DocsRelatedItem as At, DocsAnalyticsEventInput as B, SidebarPageNode as Bn, DocsSearchAdapterContext as Bt, DocsAgentEvaluationTaskInput as C, PageAgentAppliesTo as Cn, DocsMcpSecurityConfig as Ct, DocsAgentGoldenAnswerExpectation as D, PageAgentVerification as Dn, DocsObservabilityConfig as Dt, DocsAgentFeedbackData as E, PageAgentFrontmatter as En, DocsNav as Et, DocsAgentTraceEventInput as F, SidebarComponentProps as Fn, DocsReviewScoreConfig as Ft, DocsAskAIActionType as G, TypographyConfig as Gn, DocsSearchEmbeddingsConfig as Gt, DocsAnalyticsInput as H, SimpleDocsSearchConfig as Hn, DocsSearchChunkingConfig as Ht, DocsAgentTraceEventType as I, SidebarConfig as In, DocsReviewSeverity as It, DocsAskAIFeedbackMessage as J, DocsSearchResultType as Jt, DocsAskAIFeedbackConfig as K, UIConfig as Kn, DocsSearchQuery as Kt, DocsAgentTraceStatus as L, SidebarFolderIndexBehavior as Ln, DocsRobotsConfig as Lt, DocsAgentGoldenTaskFilters as M, ReadingTimeConfig as Mn, DocsReviewCiMode as Mt, DocsAgentSkillsConfig as N, ReadingTimeFormat as Nn, DocsReviewConfig as Nt, DocsAgentGoldenExampleVerification as O, PageFrontmatter as On, DocsObservabilityEvent as Ot, DocsAgentSkillsInput as P, ResolvedDocsRelatedLink as Pn, DocsReviewRulesConfig as Pt, DocsCloudConfig as Q, DocsTelemetryConfig as Qt, DocsAnalyticsConfig as R, SidebarFolderNode as Rn, DocsRobotsRule as Rt, DocsAgentEvaluationSurface as S, PageActionsConfig as Sn, DocsMcpProtectedResourceConfig as St, DocsAgentFeedbackContext as T, PageAgentFailureMode as Tn, DocsMetadata as Tt, DocsAnalyticsSource as U, ThemeToggleConfig as Un, DocsSearchConfig as Ut, DocsAnalyticsEventType as V, SidebarTree as Vn, DocsSearchAdapterFactory as Vt, DocsAskAIActionData as W, TypesenseDocsSearchConfig as Wn, DocsSearchDocument as Wt, DocsAskAIMcpConfig as X, DocsSitemapConfig as Xt, DocsAskAIFeedbackValue as Y, DocsSearchSourcePage as Yt, DocsCloudApiKeyConfig as Z, DocsTelemetryAgentSurface as Zt, DocsAgentEvaluationAnswerProvider as _, OpenDocsProviderConfig as _n, DocsMcpAuthenticateContext as _t, ApiReferenceRenderer as a, FeedbackConfig as an, DocsCodeBlocksRunnerConfig as at, DocsAgentEvaluationAnswerRunner as b, OpenGraphImage as bn, DocsMcpCorsConfig as bt, ChangelogFrontmatter as c, LastUpdatedConfig as cn, DocsCodeBlocksValidationMode as ct, CopyMarkdownFormat as d, LlmsTxtMaxCharsMode as dn, DocsFeedbackData as dt, DocsTelemetryEventInput as en, DocsCloudPreviewConfig as et, CustomDocsSearchConfig as f, LlmsTxtSectionConfig as fn, DocsFeedbackValue as ft, DocsAgentEvaluationAnswerInput as g, OpenDocsProvider as gn, DocsMcpAuthenticate as gt, DocsAgentConfig as h, OpenDocsConfig as hn, DocsMcpAuthPrincipal as ht, ApiReferenceConfig as i, DocsTheme as in, DocsCodeBlocksPlannerProvider as it, DocsAgentGoldenTaskExpectation as j, PageTwitter as jn, DocsReviewCiConfig as jt, DocsAgentGoldenExpectedExample as k, PageOpenGraph as kn, DocsObservabilityEventInput as kt, CodeBlockCopyData as l, LlmsTxtConfig as ln, DocsCodeBlocksValidationPolicy as lt, DocsAgentCompactConfig as m, OGConfig as mn, DocsMcpAllowedOrigins as mt, AgentFeedbackConfig as n, DocsTelemetryFeatures as nn, DocsCodeBlocksConfig as nt, BreadcrumbConfig as o, FontStyle as on, DocsCodeBlocksRunnerProvider as ot, DocsAgentA2AConfig as p, McpDocsSearchConfig as pn, DocsI18nConfig as pt, DocsAskAIFeedbackData as q, DocsSearchResult as qt, AlgoliaDocsSearchConfig as r, DocsTelemetryFramework as rn, DocsCodeBlocksPlannerConfig as rt, ChangelogConfig as s, GithubConfig as sn, DocsCodeBlocksValidateConfig as st, AIConfig as t, DocsTelemetryEventType as tn, DocsCloudPublishConfig as tt, CopyMarkdownConfig as u, LlmsTxtMaxCharsConfig as un, DocsConfig as ut, DocsAgentEvaluationAnswerRequest as v, OpenDocsProviderId as vn, DocsMcpAuthenticateResult as vt, DocsAgentEvaluationsConfig as w, PageAgentCommand as wn, DocsMcpToolsConfig as wt, DocsAgentEvaluationSourceReference as x, OrderingItem as xn, DocsMcpOriginContext as xt, DocsAgentEvaluationAnswerResult as y, OpenDocsTarget as yn, DocsMcpConfig as yt, DocsAnalyticsEvent as z, SidebarNode as zn, DocsSearchAdapter as zt };

package/dist/{upgrade-BCJTCW3O.mjs → upgrade-oz-GChgt.mjs}

@@ -1,5 +1,5 @@
-import { c as fileExists, o as exec } from "./utils-6UCLxv4B.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-qik_4J6C.mjs";
+import { c as fileExists, o as exec } from "./utils-DpiIioYb.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, i as frameworkFromPreset, l as validateUpgradeVersion, n as PRESETS, o as presetFromFramework, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework, t as PACKAGES_BY_FRAMEWORK } from "./package-version-n5AFur8a.mjs";
 import path from "node:path";
 import pc from "picocolors";
 import * as p from "@clack/prompts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.59",
+  "version": "0.2.61",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",
@@ -30,6 +30,16 @@
       "import": "./dist/server.mjs",
       "default": "./dist/server.mjs"
     },
+    "./agent-skills-bundle": {
+      "types": "./dist/agent-skills-bundle.d.mts",
+      "import": "./dist/agent-skills-bundle.mjs",
+      "default": "./dist/agent-skills-bundle.mjs"
+    },
+    "./vite": {
+      "types": "./dist/agent-skills-vite.d.mts",
+      "import": "./dist/agent-skills-vite.mjs",
+      "default": "./dist/agent-skills-vite.mjs"
+    },
     "./cloud/server": {
       "types": "./dist/docs-cloud-server.d.mts",
       "import": "./dist/docs-cloud-server.mjs",

package/dist/mcp-BAJr3wC2.mjs

@@ -1,104 +0,0 @@
-import "./agent-BFqyqEnC.mjs";
-import "./search-D57JXQLj.mjs";
-import "./sitemap-server-C1ibVKOy.mjs";
-import "./agent-evals-kJs2Y9xR.mjs";
-import { createFilesystemDocsMcpSource, resolveDocsMcpConfig, runDocsMcpStdio } from "./mcp.mjs";
-import "./code-blocks-qe0T8-xe.mjs";
-import "./server.mjs";
-import { d as readStringProperty, h as resolveDocsContentDir, l as readNavTitle, m as resolveDocsConfigPath, n as extractObjectLiteral, s as readBooleanProperty } from "./config-DASewQ0x.mjs";
-import { readFileSync } from "node:fs";
-import pc from "picocolors";
-
-//#region src/cli/mcp.ts
-async function runMcp(options = {}) {
-	if (options.setup) {
-		printHostedMcpSetup(options);
-		return;
-	}
-	const rootDir = process.cwd();
-	const content = readFileSync(resolveDocsConfigPath(rootDir, options.configPath), "utf-8");
-	const entry = readStringProperty(content, "entry") ?? "docs";
-	const contentDir = resolveDocsContentDir(rootDir, content, entry);
-	const navTitle = readNavTitle(content);
-	const mcp = readMcpConfig(content);
-	await runDocsMcpStdio({
-		source: createFilesystemDocsMcpSource({
-			rootDir,
-			entry,
-			contentDir,
-			siteTitle: navTitle ?? "Documentation"
-		}),
-		mcp: resolveDocsMcpConfig(mcp ?? true, { defaultName: navTitle ?? "@farming-labs/docs" }),
-		defaultName: navTitle ?? "@farming-labs/docs"
-	});
-}
-function normalizeApiBaseUrl(value) {
-	return (value?.trim() || "https://api.farming-labs.dev").replace(/\/+$/g, "");
-}
-function printHostedMcpSetup(options) {
-	const deploymentId = options.deploymentId?.trim();
-	if (!deploymentId) {
-		console.error(pc.red("Missing MCP deployment id."));
-		console.error();
-		console.error(`Run ${pc.cyan("npx @farming-labs/docs mcp setup --deployment <deployment-id>")}.`);
-		process.exit(1);
-	}
-	const endpoint = `${normalizeApiBaseUrl(options.apiBaseUrl)}/v1/mcp/${deploymentId}`;
-	const jsonConfig = { mcpServers: { "docs-cloud": {
-		command: "npx",
-		args: [
-			"@farming-labs/docs",
-			"mcp",
-			"setup",
-			"--deployment",
-			deploymentId
-		]
-	} } };
-	if (options.json) {
-		console.log(JSON.stringify(jsonConfig, null, 2));
-		return;
-	}
-	console.log(pc.bold("Docs Cloud MCP deployment"));
-	console.log(pc.dim(`Deployment: ${deploymentId}`));
-	console.log();
-	console.log(pc.cyan("CLI stdio"));
-	console.log(`  npx @farming-labs/docs mcp setup --deployment ${deploymentId}`);
-	console.log();
-	console.log(pc.cyan("Streamable HTTP"));
-	console.log(`  ${endpoint}`);
-	console.log();
-	console.log(pc.cyan("SSE"));
-	console.log(`  ${endpoint}/sse`);
-	console.log();
-	console.log(pc.cyan("MCP client JSON"));
-	console.log(JSON.stringify(jsonConfig, null, 2));
-	console.log();
-	console.log(pc.dim("Set DOCS_CLOUD_API_KEY in the agent environment before connecting."));
-}
-function readMcpConfig(content) {
-	if (content.match(/mcp\s*:\s*false/)) return false;
-	if (content.match(/mcp\s*:\s*true/)) return true;
-	const block = extractObjectLiteral(content, "mcp");
-	if (!block) return void 0;
-	return {
-		enabled: readBooleanProperty(block, "enabled"),
-		route: readStringProperty(block, "route"),
-		name: readStringProperty(block, "name"),
-		version: readStringProperty(block, "version"),
-		tools: {
-			listDocs: readBooleanProperty(block, "listDocs"),
-			listPages: readBooleanProperty(block, "listPages"),
-			listTasks: readBooleanProperty(block, "listTasks"),
-			readTask: readBooleanProperty(block, "readTask"),
-			readPage: readBooleanProperty(block, "readPage"),
-			searchDocs: readBooleanProperty(block, "searchDocs"),
-			getNavigation: readBooleanProperty(block, "getNavigation"),
-			getCodeExamples: readBooleanProperty(block, "getCodeExamples"),
-			getConfigSchema: readBooleanProperty(block, "getConfigSchema"),
-			getContext: readBooleanProperty(block, "getContext")
-		}
-	};
-}
-
-//#endregion
-export { runMcp };