@farming-labs/docs 0.2.64 → 0.2.66

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

@@ -831,6 +831,13 @@ export const Route = createFileRoute("${entryUrl}/$")({
         }
         return undefined;
       },
+      HEAD: async ({ request }) => {
+        const url = new URL(request.url);
+        if (isDocsPublicGetRequest(${JSON.stringify(opts.entry)}, url, request, { sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
+          return docsServer.HEAD({ request });
+        }
+        return undefined;
+      },
     },
   },
   loader: async ({ location }) => {
@@ -871,13 +878,28 @@ function DocsCatchAllPage() {
 function tanstackApiDocsRouteTemplate(useAlias, filePath) {
 	return `\
 import { createFileRoute } from "@tanstack/react-router";
+import { isDocsStandardsDiscoveryRequest } from "@farming-labs/docs";
 import { docsServer } from "${useAlias ? "@/lib/docs.server" : relativeImport(filePath, "src/lib/docs.server.ts")}";
+import docsConfig from "${tanstackDocsConfigImport(filePath)}";
+
+async function handleUnsupportedDocsMethod(request: Request) {
+  const url = new URL(request.url);
+  if (isDocsStandardsDiscoveryRequest(url, { apiRoute: docsConfig.cloud?.apiRoute })) {
+    return docsServer.GET({ request });
+  }
+  return new Response("Method Not Allowed", {
+    status: 405,
+    headers: { Allow: "GET, HEAD, POST" },
+  });
+}
 
 export const Route = createFileRoute("/api/docs")({
   server: {
     handlers: {
       GET: async ({ request }) => docsServer.GET({ request }),
+      HEAD: async ({ request }) => docsServer.HEAD({ request }),
       POST: async ({ request }) => docsServer.POST({ request }),
+      ANY: async ({ request }) => handleUnsupportedDocsMethod(request),
     },
   },
 });
@@ -886,7 +908,7 @@ export const Route = createFileRoute("/api/docs")({
 function tanstackDocsPublicRouteTemplate(useAlias, filePath, entry) {
 	return `\
 import { createFileRoute } from "@tanstack/react-router";
-import { isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
+import { isDocsMcpRequest, isDocsPublicGetRequest, isDocsStandardsDiscoveryRequest } from "@farming-labs/docs";
 import { docsServer } from "${useAlias ? "@/lib/docs.server" : relativeImport(filePath, "src/lib/docs.server.ts")}";
 import docsConfig from "${tanstackDocsConfigImport(filePath)}";
 
@@ -907,10 +929,16 @@ async function handlePublicDocsRequest(request: Request) {
     });
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, url, request, { sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
+  if (isDocsStandardsDiscoveryRequest(url, { apiRoute: docsConfig.cloud?.apiRoute })) {
+    if (method === "HEAD") return docsServer.HEAD({ request });
+    if (method === "POST") return docsServer.POST({ request });
     return docsServer.GET({ request });
   }
 
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, url, request, { apiRoute: docsConfig.cloud?.apiRoute, sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
+    return method === "HEAD" ? docsServer.HEAD({ request }) : docsServer.GET({ request });
+  }
+
   return new Response("Not Found", { status: 404 });
 }
 
@@ -918,9 +946,11 @@ export const Route = createFileRoute("/$")({
   server: {
     handlers: {
       GET: async ({ request }) => handlePublicDocsRequest(request),
+      HEAD: async ({ request }) => handlePublicDocsRequest(request),
       POST: async ({ request }) => handlePublicDocsRequest(request),
       DELETE: async ({ request }) => handlePublicDocsRequest(request),
       OPTIONS: async ({ request }) => handlePublicDocsRequest(request),
+      ANY: async ({ request }) => handlePublicDocsRequest(request),
     },
   },
 });
@@ -1288,7 +1318,7 @@ const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx,svx
   eager: true,
 }) as Record<string, string>;
 
-export const { load, GET, POST, MCP } = createDocsServer({
+export const { load, GET, HEAD, POST, MCP } = createDocsServer({
   ...config,
   _preloadedContent: contentFiles,
   _preloadedAgentSkills: bundledAgentSkills,
@@ -1336,16 +1366,16 @@ export const GET = createSvelteApiReference(config);
 }
 function svelteDocsApiRouteTemplate(filePath, useAlias) {
 	return `\
-export { GET, POST } from "${svelteRouteServerImport(filePath, useAlias)}";
+export { GET, HEAD, POST } from "${svelteRouteServerImport(filePath, useAlias)}";
 `;
 }
 function svelteDocsPublicHookTemplate(filePath, useAlias) {
 	const serverImport = svelteRouteServerImport(filePath, useAlias);
 	return `\
-import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
+import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsStandardsDiscoveryRequest } from "@farming-labs/docs";
 import type { Handle } from "@sveltejs/kit";
 import config from "${svelteRouteConfigImport(filePath, useAlias)}";
-import { GET, MCP } from "${serverImport}";
+import { GET, HEAD, POST, MCP } from "${serverImport}";
 
 const docsEntry = config.entry ?? "docs";
 
@@ -1363,13 +1393,21 @@ export const handle: Handle = async ({ event, resolve }) => {
     });
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(event.url, config.llmsTxt, docsEntry)) {
+  if (isDocsStandardsDiscoveryRequest(event.url, { apiRoute: config.cloud?.apiRoute })) {
+    if (method === "HEAD") return HEAD({ url: event.url, request: event.request });
+    if (method === "POST") return POST({ url: event.url, request: event.request });
+    return GET({ url: event.url, request: event.request });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(event.url, config.llmsTxt, docsEntry, { apiRoute: config.cloud?.apiRoute })) {
     const nativeResponse = await resolve(event);
     if (nativeResponse.status !== 404) return nativeResponse;
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request, { sitemap: config.sitemap, llms: config.llmsTxt, robots: config.robots })) {
-    return GET({ url: event.url, request: event.request });
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request, { apiRoute: config.cloud?.apiRoute, sitemap: config.sitemap, llms: config.llmsTxt, robots: config.robots })) {
+    return method === "HEAD"
+      ? HEAD({ url: event.url, request: event.request })
+      : GET({ url: event.url, request: event.request });
   }
 
   return resolve(event);
@@ -1394,11 +1432,11 @@ function injectSvelteDocsPublicHook(content, filePath, useAlias) {
 		break;
 	}
 	const imports = [
-		"import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest } from \"@farming-labs/docs\";",
+		"import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsStandardsDiscoveryRequest } from \"@farming-labs/docs\";",
 		...next.includes("Handle") ? [] : ["import type { Handle } from \"@sveltejs/kit\";"],
 		...hasExistingHandle && !next.includes("sequence") ? ["import { sequence } from \"@sveltejs/kit/hooks\";"] : [],
 		`import docsConfig from "${configImport}";`,
-		`import { GET as docsGET, MCP as docsMCP } from "${serverImport}";`
+		`import { GET as docsGET, HEAD as docsHEAD, POST as docsPOST, MCP as docsMCP } from "${serverImport}";`
 	];
 	const docsHandle = `\
 const docsEntry = docsConfig.entry ?? "docs";
@@ -1417,13 +1455,21 @@ const docsPublicHandle: Handle = async ({ event, resolve }) => {
     });
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(event.url, docsConfig.llmsTxt, docsEntry)) {
+  if (isDocsStandardsDiscoveryRequest(event.url, { apiRoute: docsConfig.cloud?.apiRoute })) {
+    if (method === "HEAD") return docsHEAD({ url: event.url, request: event.request });
+    if (method === "POST") return docsPOST({ url: event.url, request: event.request });
+    return docsGET({ url: event.url, request: event.request });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(event.url, docsConfig.llmsTxt, docsEntry, { apiRoute: docsConfig.cloud?.apiRoute })) {
     const nativeResponse = await resolve(event);
     if (nativeResponse.status !== 404) return nativeResponse;
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request, { sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
-    return docsGET({ url: event.url, request: event.request });
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, event.url, event.request, { apiRoute: docsConfig.cloud?.apiRoute, sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
+    return method === "HEAD"
+      ? docsHEAD({ url: event.url, request: event.request })
+      : docsGET({ url: event.url, request: event.request });
   }
 
   return resolve(event);
@@ -1706,7 +1752,7 @@ const contentFiles = import.meta.glob(["/${cfg.entry ?? "docs"}/**/*.{md,mdx}",
   eager: true,
 }) as Record<string, string>;
 
-export const { load, GET, POST, MCP } = createDocsServer({
+export const { load, GET, HEAD, POST, MCP } = createDocsServer({
   ...config,
   _preloadedContent: contentFiles,
   _preloadedAgentSkills: bundledAgentSkills,
@@ -1827,12 +1873,16 @@ const data = await load(Astro.url.pathname);
 function astroApiRouteTemplate(cfg) {
 	return `\
 import type { APIRoute } from "astro";
-import { GET as docsGET, POST as docsPOST } from "${astroPageServerImport(cfg.useAlias, 2)}";
+import { GET as docsGET, HEAD as docsHEAD, POST as docsPOST } from "${astroPageServerImport(cfg.useAlias, 2)}";
 
 export const GET: APIRoute = async ({ request }) => {
   return docsGET({ request });
 };
 
+export const HEAD: APIRoute = async ({ request }) => {
+  return docsHEAD({ request });
+};
+
 export const POST: APIRoute = async ({ request }) => {
   return docsPOST({ request });
 };
@@ -1841,10 +1891,10 @@ export const POST: APIRoute = async ({ request }) => {
 function astroDocsMiddlewareTemplate(filePath, useAlias) {
 	const serverImport = astroRouteServerImport(filePath, useAlias);
 	return `\
-import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest } from "@farming-labs/docs";
+import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsStandardsDiscoveryRequest } from "@farming-labs/docs";
 import type { MiddlewareHandler } from "astro";
 import config from "${astroRouteConfigImport(filePath, useAlias)}";
-import { GET, MCP } from "${serverImport}";
+import { GET, HEAD, POST, MCP } from "${serverImport}";
 
 const docsEntry = config.entry ?? "docs";
 
@@ -1862,13 +1912,21 @@ export const onRequest: MiddlewareHandler = async (context, next) => {
     });
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(context.url, config.llmsTxt, docsEntry)) {
+  if (isDocsStandardsDiscoveryRequest(context.url, { apiRoute: config.cloud?.apiRoute })) {
+    if (method === "HEAD") return HEAD({ request: context.request });
+    if (method === "POST") return POST({ request: context.request });
+    return GET({ request: context.request });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(context.url, config.llmsTxt, docsEntry, { apiRoute: config.cloud?.apiRoute })) {
     const nativeResponse = await next();
     if (nativeResponse.status !== 404) return nativeResponse;
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request, { sitemap: config.sitemap, llms: config.llmsTxt, robots: config.robots })) {
-    return GET({ request: context.request });
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request, { apiRoute: config.cloud?.apiRoute, sitemap: config.sitemap, llms: config.llmsTxt, robots: config.robots })) {
+    return method === "HEAD"
+      ? HEAD({ request: context.request })
+      : GET({ request: context.request });
   }
 
   return next();
@@ -1893,11 +1951,11 @@ function injectAstroDocsMiddleware(content, filePath, useAlias) {
 		break;
 	}
 	const imports = [
-		"import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest } from \"@farming-labs/docs\";",
+		"import { isDocsLlmsTxtPublicRequest, isDocsMcpRequest, isDocsPublicGetRequest, isDocsStandardsDiscoveryRequest } from \"@farming-labs/docs\";",
 		...next.includes("MiddlewareHandler") ? [] : ["import type { MiddlewareHandler } from \"astro\";"],
 		...hasExistingMiddleware && !next.includes("sequence") ? ["import { sequence } from \"astro:middleware\";"] : [],
 		`import docsConfig from "${configImport}";`,
-		`import { GET as docsGET, MCP as docsMCP } from "${serverImport}";`
+		`import { GET as docsGET, HEAD as docsHEAD, POST as docsPOST, MCP as docsMCP } from "${serverImport}";`
 	];
 	const docsMiddleware = `\
 const docsEntry = docsConfig.entry ?? "docs";
@@ -1916,13 +1974,21 @@ const docsPublicMiddleware: MiddlewareHandler = async (context, next) => {
     });
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(context.url, docsConfig.llmsTxt, docsEntry)) {
+  if (isDocsStandardsDiscoveryRequest(context.url, { apiRoute: docsConfig.cloud?.apiRoute })) {
+    if (method === "HEAD") return docsHEAD({ request: context.request });
+    if (method === "POST") return docsPOST({ request: context.request });
+    return docsGET({ request: context.request });
+  }
+
+  if ((method === "GET" || method === "HEAD") && isDocsLlmsTxtPublicRequest(context.url, docsConfig.llmsTxt, docsEntry, { apiRoute: docsConfig.cloud?.apiRoute })) {
     const nativeResponse = await next();
     if (nativeResponse.status !== 404) return nativeResponse;
   }
 
-  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request, { sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
-    return docsGET({ request: context.request });
+  if ((method === "GET" || method === "HEAD") && isDocsPublicGetRequest(docsEntry, context.url, context.request, { apiRoute: docsConfig.cloud?.apiRoute, sitemap: docsConfig.sitemap, llms: docsConfig.llmsTxt, robots: docsConfig.robots })) {
+    return method === "HEAD"
+      ? docsHEAD({ request: context.request })
+      : docsGET({ request: context.request });
   }
 
   return next();

package/dist/{types-lMBIdZg0.d.mts → types-BQC05SQm.d.mts}

@@ -2553,22 +2553,216 @@ interface DocsAgentSkillsConfig {
 }
 /** 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;
+/** Core A2A v1 bindings plus URI-identified custom bindings. */
+type DocsAgentA2AProtocolBinding = "JSONRPC" | "GRPC" | "HTTP+JSON" | (string & {});
+/** One A2A protocol interface advertised by an Agent Card. */
+interface DocsAgentA2AInterfaceConfig {
+  /** Absolute binding-appropriate URL. Core bindings require HTTPS outside loopback development. */
+  url: string;
+  /** A2A protocol binding implemented at this URL. @default "HTTP+JSON" */
+  protocolBinding?: DocsAgentA2AProtocolBinding;
+  /** A2A protocol version implemented at this URL. @default "1.0" */
+  protocolVersion?: string;
+  /** Optional tenant identifier clients must send when calling this interface. */
+  tenant?: string;
+}
+/** A protocol extension implemented by the configured A2A service. */
+interface DocsAgentA2AExtension {
+  /** Stable URI identifying the extension. */
+  uri: string;
+  /** How this agent implements the extension. */
+  description?: string;
+  /** Whether clients must understand the extension before using the agent. */
+  required?: boolean;
+  /** Extension-specific JSON configuration. */
+  params?: Readonly<Record<string, unknown>>;
+}
+/** Optional capabilities implemented by the configured A2A service. */
+interface DocsAgentA2ACapabilities {
+  streaming?: boolean;
+  pushNotifications?: boolean;
+  extensions?: readonly DocsAgentA2AExtension[];
+  /** Requires implemented GetExtendedAgentCard plus a declared scheme and security requirement. */
+  extendedAgentCard?: boolean;
+}
+/** A list of OAuth scopes associated with one named security scheme. */
+interface DocsAgentA2ASecurityScopeList {
+  list: readonly string[];
+}
+/** One alternative set of security schemes required to call an A2A service or skill. */
+interface DocsAgentA2ASecurityRequirement {
+  schemes: Readonly<Record<string, DocsAgentA2ASecurityScopeList>>;
+}
+interface DocsAgentA2AApiKeySecurityScheme {
+  description?: string;
+  location: "query" | "header" | "cookie";
+  name: string;
+}
+interface DocsAgentA2AHttpAuthSecurityScheme {
+  description?: string;
+  scheme: string;
+  bearerFormat?: string;
+}
+interface DocsAgentA2AOAuthAuthorizationCodeFlow {
+  authorizationUrl: string;
+  tokenUrl: string;
+  refreshUrl?: string;
+  scopes: Readonly<Record<string, string>>;
+  pkceRequired?: boolean;
+}
+interface DocsAgentA2AOAuthClientCredentialsFlow {
+  tokenUrl: string;
+  refreshUrl?: string;
+  scopes: Readonly<Record<string, string>>;
+}
+interface DocsAgentA2AOAuthDeviceCodeFlow {
+  deviceAuthorizationUrl: string;
+  tokenUrl: string;
+  refreshUrl?: string;
+  scopes: Readonly<Record<string, string>>;
+}
+/** @deprecated A2A v1 retains this OAuth flow for compatibility only. */
+interface DocsAgentA2AOAuthImplicitFlow {
+  authorizationUrl: string;
+  refreshUrl?: string;
+  scopes: Readonly<Record<string, string>>;
+}
+/** @deprecated A2A v1 retains this OAuth flow for compatibility only. */
+interface DocsAgentA2AOAuthPasswordFlow {
+  tokenUrl: string;
+  refreshUrl?: string;
+  scopes: Readonly<Record<string, string>>;
+}
+/** A2A v1 OAuth flow union. Exactly one flow is allowed by the protocol. */
+type DocsAgentA2AOAuthFlows = {
+  authorizationCode: DocsAgentA2AOAuthAuthorizationCodeFlow;
+  clientCredentials?: never;
+  deviceCode?: never;
+  implicit?: never;
+  password?: never;
+} | {
+  authorizationCode?: never;
+  clientCredentials: DocsAgentA2AOAuthClientCredentialsFlow;
+  deviceCode?: never;
+  implicit?: never;
+  password?: never;
+} | {
+  authorizationCode?: never;
+  clientCredentials?: never;
+  deviceCode: DocsAgentA2AOAuthDeviceCodeFlow;
+  implicit?: never;
+  password?: never;
+} | {
+  authorizationCode?: never;
+  clientCredentials?: never;
+  deviceCode?: never;
+  implicit: DocsAgentA2AOAuthImplicitFlow;
+  password?: never;
+} | {
+  authorizationCode?: never;
+  clientCredentials?: never;
+  deviceCode?: never;
+  implicit?: never;
+  password: DocsAgentA2AOAuthPasswordFlow;
+};
+interface DocsAgentA2AOAuth2SecurityScheme {
+  description?: string;
+  flows: DocsAgentA2AOAuthFlows;
+  oauth2MetadataUrl?: string;
+}
+interface DocsAgentA2AOpenIdConnectSecurityScheme {
+  description?: string;
+  openIdConnectUrl: string;
+}
+interface DocsAgentA2AMutualTlsSecurityScheme {
+  description?: string;
+}
+/** A2A v1 security scheme union. Exactly one scheme is allowed by the protocol. */
+type DocsAgentA2ASecurityScheme = {
+  apiKeySecurityScheme: DocsAgentA2AApiKeySecurityScheme;
+  httpAuthSecurityScheme?: never;
+  oauth2SecurityScheme?: never;
+  openIdConnectSecurityScheme?: never;
+  mtlsSecurityScheme?: never;
+} | {
+  apiKeySecurityScheme?: never;
+  httpAuthSecurityScheme: DocsAgentA2AHttpAuthSecurityScheme;
+  oauth2SecurityScheme?: never;
+  openIdConnectSecurityScheme?: never;
+  mtlsSecurityScheme?: never;
+} | {
+  apiKeySecurityScheme?: never;
+  httpAuthSecurityScheme?: never;
+  oauth2SecurityScheme: DocsAgentA2AOAuth2SecurityScheme;
+  openIdConnectSecurityScheme?: never;
+  mtlsSecurityScheme?: never;
+} | {
+  apiKeySecurityScheme?: never;
+  httpAuthSecurityScheme?: never;
+  oauth2SecurityScheme?: never;
+  openIdConnectSecurityScheme: DocsAgentA2AOpenIdConnectSecurityScheme;
+  mtlsSecurityScheme?: never;
+} | {
+  apiKeySecurityScheme?: never;
+  httpAuthSecurityScheme?: never;
+  oauth2SecurityScheme?: never;
+  openIdConnectSecurityScheme?: never;
+  mtlsSecurityScheme: DocsAgentA2AMutualTlsSecurityScheme;
+};
+/** One capability implemented by the configured A2A service. */
+interface DocsAgentA2ASkill {
+  id: string;
   name: string;
   description: string;
-  documentationUrl: string;
-  provider: {
+  tags: readonly string[];
+  examples?: readonly string[];
+  inputModes?: readonly string[];
+  outputModes?: readonly string[];
+  securityRequirements?: readonly DocsAgentA2ASecurityRequirement[];
+}
+interface DocsAgentA2ABaseConfig {
+  name: string;
+  description: string;
+  /** Absolute HTTPS documentation URL; HTTP is allowed only for loopback development. */
+  documentationUrl?: string;
+  /** Provider identity with an absolute HTTPS URL outside loopback development. */
+  provider?: {
     organization: string;
     url: string;
   };
   version?: string;
-  /** A2A protocol version exposed by the interface. @default "0.3" */
+  /** Absolute HTTPS icon URL; HTTP is allowed only for loopback development. */
+  iconUrl?: string;
+  capabilities?: DocsAgentA2ACapabilities;
+  /** Agent-wide supported input media types. @default ["text/plain"] */
+  defaultInputModes?: readonly string[];
+  /** Agent-wide supported output media types. @default ["text/plain"] */
+  defaultOutputModes?: readonly string[];
+  securitySchemes?: Readonly<Record<string, DocsAgentA2ASecurityScheme>>;
+  securityRequirements?: readonly DocsAgentA2ASecurityRequirement[];
+}
+interface DocsAgentA2ASingleInterfaceConfig {
+  /** @deprecated Prefer `supportedInterfaces` for new A2A v1 configurations. */
+  interfaceUrl: string;
+  supportedInterfaces?: never;
+  /** A2A protocol version exposed by the shorthand interface. @default "0.3" */
   protocolVersion?: string;
-  /** Transport binding exposed by the interface. @default "HTTP+JSON" */
-  protocolBinding?: string;
+  /** Transport binding exposed by the shorthand interface. @default "HTTP+JSON" */
+  protocolBinding?: DocsAgentA2AProtocolBinding;
+  /** Explicit A2A skills; published documentation skills are projected when omitted. */
+  skills?: readonly DocsAgentA2ASkill[];
+}
+interface DocsAgentA2AInterfacesConfig {
+  /** Ordered interfaces; the first entry is preferred. At least one is required. */
+  supportedInterfaces: readonly [DocsAgentA2AInterfaceConfig, ...DocsAgentA2AInterfaceConfig[]];
+  /** Capabilities actually implemented by the configured A2A interfaces. */
+  skills: readonly DocsAgentA2ASkill[];
+  interfaceUrl?: never;
+  protocolVersion?: never;
+  protocolBinding?: never;
 }
+/** Explicit A2A service metadata. Configure this only when the URL implements A2A. */
+type DocsAgentA2AConfig = DocsAgentA2ABaseConfig & (DocsAgentA2ASingleInterfaceConfig | DocsAgentA2AInterfacesConfig);
 interface DocsAgentConfig {
   /**
    * Defaults for `docs agent compact`.
@@ -3312,4 +3506,4 @@ interface DocsConfig {
   og?: OGConfig;
 }
 //#endregion
-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 };
+export { DocsAgentSkillsInput as $, ResolvedDocsRelatedLink as $n, DocsReviewRulesConfig as $t, DocsAgentA2ASecurityScheme as A, LlmsTxtMaxCharsMode as An, DocsFeedbackData as At, DocsAgentEvaluationSourceReference as B, OrderingItem as Bn, DocsMcpOriginContext as Bt, DocsAgentA2AOAuthDeviceCodeFlow as C, DocsTheme as Cn, DocsCodeBlocksPlannerProvider as Ct, DocsAgentA2AOpenIdConnectSecurityScheme as D, LastUpdatedConfig as Dn, DocsCodeBlocksValidationMode as Dt, DocsAgentA2AOAuthPasswordFlow as E, GithubConfig as En, DocsCodeBlocksValidateConfig as Et, DocsAgentEvaluationAnswerInput as F, OpenDocsProvider as Fn, DocsMcpAuthenticate as Ft, DocsAgentFeedbackData as G, PageAgentFrontmatter as Gn, DocsNav as Gt, DocsAgentEvaluationTaskInput as H, PageAgentAppliesTo as Hn, DocsMcpSecurityConfig as Ht, DocsAgentEvaluationAnswerProvider as I, OpenDocsProviderConfig as In, DocsMcpAuthenticateContext as It, DocsAgentGoldenExpectedExample as J, PageOpenGraph as Jn, DocsObservabilityEventInput as Jt, DocsAgentGoldenAnswerExpectation as K, PageAgentVerification as Kn, DocsObservabilityConfig as Kt, DocsAgentEvaluationAnswerRequest as L, OpenDocsProviderId as Ln, DocsMcpAuthenticateResult as Lt, DocsAgentA2ASkill as M, McpDocsSearchConfig as Mn, DocsI18nConfig as Mt, DocsAgentCompactConfig as N, OGConfig as Nn, DocsMcpAllowedOrigins as Nt, DocsAgentA2AProtocolBinding as O, LlmsTxtConfig as On, DocsCodeBlocksValidationPolicy as Ot, DocsAgentConfig as P, OpenDocsConfig as Pn, DocsMcpAuthPrincipal as Pt, DocsAgentSkillsConfig as Q, ReadingTimeFormat as Qn, DocsReviewConfig as Qt, DocsAgentEvaluationAnswerResult as R, OpenDocsTarget as Rn, DocsMcpConfig as Rt, DocsAgentA2AOAuthClientCredentialsFlow as S, DocsTelemetryFramework as Sn, DocsCodeBlocksPlannerConfig as St, DocsAgentA2AOAuthImplicitFlow as T, FontStyle as Tn, DocsCodeBlocksRunnerProvider as Tt, DocsAgentEvaluationsConfig as U, PageAgentCommand as Un, DocsMcpToolsConfig as Ut, DocsAgentEvaluationSurface as V, PageActionsConfig as Vn, DocsMcpProtectedResourceConfig as Vt, DocsAgentFeedbackContext as W, PageAgentFailureMode as Wn, DocsMetadata as Wt, DocsAgentGoldenTaskExpectation as X, PageTwitter as Xn, DocsReviewCiConfig as Xt, DocsAgentGoldenTask as Y, PageSidebarFrontmatter as Yn, DocsRelatedItem as Yt, DocsAgentGoldenTaskFilters as Z, ReadingTimeConfig as Zn, DocsReviewCiMode as Zt, DocsAgentA2AHttpAuthSecurityScheme as _, DocsTelemetryConfig as _n, DocsCloudConfig as _t, ApiReferenceRenderer as a, DocsSearchAdapterContext as an, SidebarPageNode as ar, DocsAnalyticsEventInput as at, DocsAgentA2AOAuth2SecurityScheme as b, DocsTelemetryEventType as bn, DocsCloudPublishConfig as bt, ChangelogFrontmatter as c, DocsSearchConfig as cn, ThemeToggleConfig as cr, DocsAnalyticsSource as ct, CopyMarkdownFormat as d, DocsSearchQuery as dn, UIConfig as dr, DocsAskAIFeedbackConfig as dt, DocsReviewScoreConfig as en, SidebarComponentProps as er, DocsAgentTraceEventInput as et, CustomDocsSearchConfig as f, DocsSearchResult as fn, DocsAskAIFeedbackData as ft, DocsAgentA2AExtension as g, DocsTelemetryAgentSurface as gn, DocsCloudApiKeyConfig as gt, DocsAgentA2AConfig as h, DocsSitemapConfig as hn, DocsAskAIMcpConfig as ht, ApiReferenceConfig as i, DocsSearchAdapter as in, SidebarNode as ir, DocsAnalyticsEvent as it, DocsAgentA2ASecurityScopeList as j, LlmsTxtSectionConfig as jn, DocsFeedbackValue as jt, DocsAgentA2ASecurityRequirement as k, LlmsTxtMaxCharsConfig as kn, DocsConfig as kt, CodeBlockCopyData as l, DocsSearchDocument as ln, TypesenseDocsSearchConfig as lr, DocsAskAIActionData as lt, DocsAgentA2ACapabilities as m, DocsSearchSourcePage as mn, DocsAskAIFeedbackValue as mt, AgentFeedbackConfig as n, DocsRobotsConfig as nn, SidebarFolderIndexBehavior as nr, DocsAgentTraceStatus as nt, BreadcrumbConfig as o, DocsSearchAdapterFactory as on, SidebarTree as or, DocsAnalyticsEventType as ot, DocsAgentA2AApiKeySecurityScheme as p, DocsSearchResultType as pn, DocsAskAIFeedbackMessage as pt, DocsAgentGoldenExampleVerification as q, PageFrontmatter as qn, DocsObservabilityEvent as qt, AlgoliaDocsSearchConfig as r, DocsRobotsRule as rn, SidebarFolderNode as rr, DocsAnalyticsConfig as rt, ChangelogConfig as s, DocsSearchChunkingConfig as sn, SimpleDocsSearchConfig as sr, DocsAnalyticsInput as st, AIConfig as t, DocsReviewSeverity as tn, SidebarConfig as tr, DocsAgentTraceEventType as tt, CopyMarkdownConfig as u, DocsSearchEmbeddingsConfig as un, TypographyConfig as ur, DocsAskAIActionType as ut, DocsAgentA2AInterfaceConfig as v, DocsTelemetryEvent as vn, DocsCloudFeatureConfig as vt, DocsAgentA2AOAuthFlows as w, FeedbackConfig as wn, DocsCodeBlocksRunnerConfig as wt, DocsAgentA2AOAuthAuthorizationCodeFlow as x, DocsTelemetryFeatures as xn, DocsCodeBlocksConfig as xt, DocsAgentA2AMutualTlsSecurityScheme as y, DocsTelemetryEventInput as yn, DocsCloudPreviewConfig as yt, DocsAgentEvaluationAnswerRunner as z, OpenGraphImage as zn, DocsMcpCorsConfig as zt };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.64",
+  "version": "0.2.66",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",