@farming-labs/docs 0.2.65 → 0.2.67

package/dist/mcp.mjs

@@ -1,7 +1,7 @@
 import { a as emitDocsAnalyticsEvent, i as emitDocsAgentTraceEvent, n as createDocsAgentTraceContext, r as createDocsAgentTraceId } from "./analytics-Bx44lg6d.mjs";
-import { Bt as renderDocsRelatedMarkdownLines, Jt as normalizePageAgentFrontmatter, Qt as upsertPageAgentContractMarkdown, cn as isDocsMcpProtectedResourceMetadataPath, dn as normalizeDocsMcpAuthorizationServerUrls, fn as normalizeDocsMcpEndpointPath, mn as resolveDocsMcpResourceLocation, pn as resolveDocsMcpProtectedResourceMetadataLocation, qt as hasStructuredPageAgentContract, sn as isDocsMcpOAuthScopeToken, un as isDocsMcpResourcePath, wt as resolveDocsAudienceMdxContent, zt as normalizeDocsRelated } from "./agent-DKKptIgy.mjs";
-import "./standards-discovery-jkykaXq1.mjs";
-import { A as emitDocsTelemetryProjectEvent, D as emitDocsTelemetryAgentSurfaceEvent, S as stripGeneratedAgentProvenance, h as parseDocsMarkdownSections, k as emitDocsTelemetryMcpToolEvent, m as findDocsMarkdownSection, u as performDocsSearch, w as resolvePageSidebarFolderIndexBehavior } from "./search-B6V6qtiI.mjs";
+import { Bt as renderDocsRelatedMarkdownLines, Jt as normalizePageAgentFrontmatter, Qt as upsertPageAgentContractMarkdown, cn as isDocsMcpProtectedResourceMetadataPath, dn as normalizeDocsMcpAuthorizationServerUrls, fn as normalizeDocsMcpEndpointPath, mn as resolveDocsMcpResourceLocation, pn as resolveDocsMcpProtectedResourceMetadataLocation, qt as hasStructuredPageAgentContract, sn as isDocsMcpOAuthScopeToken, un as isDocsMcpResourcePath, wt as resolveDocsAudienceMdxContent, zt as normalizeDocsRelated } from "./agent-CcR8_Yyd.mjs";
+import "./standards-discovery-C7p5lBhc.mjs";
+import { A as emitDocsTelemetryProjectEvent, D as emitDocsTelemetryAgentSurfaceEvent, S as stripGeneratedAgentProvenance, h as parseDocsMarkdownSections, k as emitDocsTelemetryMcpToolEvent, m as findDocsMarkdownSection, u as performDocsSearch, w as resolvePageSidebarFolderIndexBehavior } from "./search-D0A9lRGJ.mjs";
 import { a as normalizeAgentScopeValues, i as normalizeAgentLocale, n as agentVersionConstraintsOverlap, r as normalizeAgentFramework, t as agentVersionConstraintMatches } from "./agent-scope-C_U--OZ7.mjs";
 import matter from "gray-matter";
 import fs from "node:fs";
@@ -246,11 +246,51 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 				type: "DocsAgentA2AConfig",
 				description: "Opt-in Agent Card metadata for a separately implemented real A2A service.",
 				children: [
+					{
+						path: "agent.a2a.supportedInterfaces",
+						name: "supportedInterfaces",
+						type: "readonly DocsAgentA2AInterfaceConfig[]",
+						description: "Ordered A2A v1 interfaces implemented by the service; the first entry is preferred.",
+						children: [
+							{
+								path: "agent.a2a.supportedInterfaces[]",
+								name: "interface",
+								type: "DocsAgentA2AInterfaceConfig",
+								description: "One implemented A2A protocol interface."
+							},
+							{
+								path: "agent.a2a.supportedInterfaces[].url",
+								name: "url",
+								type: "string",
+								description: "Absolute binding-appropriate URL; core bindings require HTTPS outside loopback development."
+							},
+							{
+								path: "agent.a2a.supportedInterfaces[].protocolBinding",
+								name: "protocolBinding",
+								type: "DocsAgentA2AProtocolBinding",
+								default: "HTTP+JSON",
+								description: "Core binding JSONRPC, GRPC, or HTTP+JSON, or an absolute URI for a custom binding."
+							},
+							{
+								path: "agent.a2a.supportedInterfaces[].protocolVersion",
+								name: "protocolVersion",
+								type: "string",
+								default: "1.0",
+								description: "A2A major.minor protocol version implemented by this interface."
+							},
+							{
+								path: "agent.a2a.supportedInterfaces[].tenant",
+								name: "tenant",
+								type: "string",
+								description: "Optional tenant identifier required by this interface."
+							}
+						]
+					},
 					{
 						path: "agent.a2a.interfaceUrl",
 						name: "interfaceUrl",
 						type: "string",
-						description: "HTTP(S) URL of the real A2A interface."
+						description: "Deprecated single-interface shorthand. Prefer supportedInterfaces for new A2A v1 configurations."
 					},
 					{
 						path: "agent.a2a.name",
@@ -268,19 +308,279 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 						path: "agent.a2a.documentationUrl",
 						name: "documentationUrl",
 						type: "string",
-						description: "HTTP(S) documentation URL for the A2A service."
+						description: "Optional absolute HTTPS documentation URL; HTTP is limited to loopback development."
 					},
 					{
-						path: "agent.a2a.provider.organization",
-						name: "organization",
-						type: "string",
-						description: "A2A service provider organization."
+						path: "agent.a2a.provider",
+						name: "provider",
+						type: "{ organization: string; url: string }",
+						description: "Optional A2A service provider identity.",
+						children: [{
+							path: "agent.a2a.provider.organization",
+							name: "organization",
+							type: "string",
+							description: "A2A service provider organization."
+						}, {
+							path: "agent.a2a.provider.url",
+							name: "url",
+							type: "string",
+							description: "Absolute HTTPS provider URL; HTTP is limited to loopback development."
+						}]
 					},
 					{
-						path: "agent.a2a.provider.url",
-						name: "url",
+						path: "agent.a2a.iconUrl",
+						name: "iconUrl",
 						type: "string",
-						description: "HTTP(S) provider URL."
+						description: "Optional absolute HTTPS icon URL; HTTP is limited to loopback development."
+					},
+					{
+						path: "agent.a2a.capabilities",
+						name: "capabilities",
+						type: "DocsAgentA2ACapabilities",
+						description: "Capabilities actually implemented by the A2A service.",
+						children: [
+							{
+								path: "agent.a2a.capabilities.streaming",
+								name: "streaming",
+								type: "boolean",
+								default: false,
+								description: "Whether the A2A service implements streaming."
+							},
+							{
+								path: "agent.a2a.capabilities.pushNotifications",
+								name: "pushNotifications",
+								type: "boolean",
+								default: false,
+								description: "Whether the A2A service implements push notifications."
+							},
+							{
+								path: "agent.a2a.capabilities.extensions",
+								name: "extensions",
+								type: "readonly DocsAgentA2AExtension[]",
+								description: "URI-identified A2A protocol extensions implemented by the service.",
+								children: [
+									{
+										path: "agent.a2a.capabilities.extensions[]",
+										name: "extension",
+										type: "DocsAgentA2AExtension",
+										description: "One protocol extension implemented by the service."
+									},
+									{
+										path: "agent.a2a.capabilities.extensions[].uri",
+										name: "uri",
+										type: "string",
+										description: "Absolute URI identifying the extension."
+									},
+									{
+										path: "agent.a2a.capabilities.extensions[].description",
+										name: "description",
+										type: "string",
+										description: "How this agent implements the extension."
+									},
+									{
+										path: "agent.a2a.capabilities.extensions[].required",
+										name: "required",
+										type: "boolean",
+										default: false,
+										description: "Whether clients must understand this extension."
+									},
+									{
+										path: "agent.a2a.capabilities.extensions[].params",
+										name: "params",
+										type: "Readonly<Record<string, unknown>>",
+										description: "Extension-specific JSON parameters."
+									}
+								]
+							},
+							{
+								path: "agent.a2a.capabilities.extendedAgentCard",
+								name: "extendedAgentCard",
+								type: "boolean",
+								description: "Whether the service implements authenticated GetExtendedAgentCard; requires a declared scheme and non-empty requirement."
+							}
+						]
+					},
+					{
+						path: "agent.a2a.defaultInputModes",
+						name: "defaultInputModes",
+						type: "readonly string[]",
+						description: "Agent-wide input media types; defaults to [\"text/plain\"]."
+					},
+					{
+						path: "agent.a2a.defaultOutputModes",
+						name: "defaultOutputModes",
+						type: "readonly string[]",
+						description: "Agent-wide output media types; defaults to [\"text/plain\"]."
+					},
+					{
+						path: "agent.a2a.skills",
+						name: "skills",
+						type: "readonly DocsAgentA2ASkill[]",
+						description: "A2A capabilities implemented by the service. Required with supportedInterfaces; distinct from published Agent Skill files.",
+						children: [
+							{
+								path: "agent.a2a.skills[]",
+								name: "skill",
+								type: "DocsAgentA2ASkill",
+								description: "One capability implemented by the A2A service."
+							},
+							{
+								path: "agent.a2a.skills[].id",
+								name: "id",
+								type: "string",
+								description: "Stable unique capability identifier."
+							},
+							{
+								path: "agent.a2a.skills[].name",
+								name: "name",
+								type: "string",
+								description: "Human-readable capability name."
+							},
+							{
+								path: "agent.a2a.skills[].description",
+								name: "description",
+								type: "string",
+								description: "Capability purpose and behavior."
+							},
+							{
+								path: "agent.a2a.skills[].tags",
+								name: "tags",
+								type: "readonly string[]",
+								description: "Non-empty discovery tags for the capability."
+							},
+							{
+								path: "agent.a2a.skills[].examples",
+								name: "examples",
+								type: "readonly string[]",
+								description: "Optional example prompts for this capability."
+							},
+							{
+								path: "agent.a2a.skills[].inputModes",
+								name: "inputModes",
+								type: "readonly string[]",
+								description: "Optional capability-specific input media types."
+							},
+							{
+								path: "agent.a2a.skills[].outputModes",
+								name: "outputModes",
+								type: "readonly string[]",
+								description: "Optional capability-specific output media types."
+							},
+							{
+								path: "agent.a2a.skills[].securityRequirements",
+								name: "securityRequirements",
+								type: "readonly DocsAgentA2ASecurityRequirement[]",
+								description: "Optional capability-specific alternatives over named security schemes."
+							}
+						]
+					},
+					{
+						path: "agent.a2a.securitySchemes",
+						name: "securitySchemes",
+						type: "Readonly<Record<string, DocsAgentA2ASecurityScheme>>",
+						description: "Optional named A2A v1 API key, HTTP auth, OAuth 2, OpenID Connect, or mutual TLS schemes.",
+						children: [
+							{
+								path: "agent.a2a.securitySchemes.<name>",
+								name: "scheme",
+								type: "DocsAgentA2ASecurityScheme",
+								description: "One named scheme containing exactly one wrapper: apiKeySecurityScheme, httpAuthSecurityScheme, oauth2SecurityScheme, openIdConnectSecurityScheme, or mtlsSecurityScheme."
+							},
+							{
+								path: "agent.a2a.securitySchemes.<name>.apiKeySecurityScheme",
+								name: "apiKeySecurityScheme",
+								type: "{ description?: string; location: \"query\" | \"header\" | \"cookie\"; name: string }",
+								description: "API key location and parameter name."
+							},
+							{
+								path: "agent.a2a.securitySchemes.<name>.httpAuthSecurityScheme",
+								name: "httpAuthSecurityScheme",
+								type: "{ description?: string; scheme: string; bearerFormat?: string }",
+								description: "HTTP authentication scheme such as bearer."
+							},
+							{
+								path: "agent.a2a.securitySchemes.<name>.oauth2SecurityScheme",
+								name: "oauth2SecurityScheme",
+								type: "DocsAgentA2AOAuth2SecurityScheme",
+								description: "OAuth 2 metadata with exactly one authorizationCode, clientCredentials, deviceCode, implicit, or password flow. Implicit and password are deprecated A2A v1 compatibility flows.",
+								children: [
+									{
+										path: "agent.a2a.securitySchemes.<name>.oauth2SecurityScheme.flows.authorizationCode",
+										name: "authorizationCode",
+										type: "DocsAgentA2AOAuthAuthorizationCodeFlow",
+										description: "Authorization code flow with HTTPS authorizationUrl, tokenUrl, scopes, and optional refreshUrl/pkceRequired."
+									},
+									{
+										path: "agent.a2a.securitySchemes.<name>.oauth2SecurityScheme.flows.clientCredentials",
+										name: "clientCredentials",
+										type: "DocsAgentA2AOAuthClientCredentialsFlow",
+										description: "Client credentials flow with HTTPS tokenUrl, scopes, and optional refreshUrl."
+									},
+									{
+										path: "agent.a2a.securitySchemes.<name>.oauth2SecurityScheme.flows.deviceCode",
+										name: "deviceCode",
+										type: "DocsAgentA2AOAuthDeviceCodeFlow",
+										description: "Device code flow with HTTPS deviceAuthorizationUrl, tokenUrl, scopes, and optional refreshUrl."
+									},
+									{
+										path: "agent.a2a.securitySchemes.<name>.oauth2SecurityScheme.flows.implicit",
+										name: "implicit",
+										type: "DocsAgentA2AOAuthImplicitFlow",
+										description: "Deprecated A2A v1 compatibility flow with HTTPS authorizationUrl, scopes, and optional refreshUrl."
+									},
+									{
+										path: "agent.a2a.securitySchemes.<name>.oauth2SecurityScheme.flows.password",
+										name: "password",
+										type: "DocsAgentA2AOAuthPasswordFlow",
+										description: "Deprecated A2A v1 compatibility flow with HTTPS tokenUrl, scopes, and optional refreshUrl."
+									},
+									{
+										path: "agent.a2a.securitySchemes.<name>.oauth2SecurityScheme.oauth2MetadataUrl",
+										name: "oauth2MetadataUrl",
+										type: "string",
+										description: "Optional HTTPS RFC 8414 authorization-server metadata URL."
+									}
+								]
+							},
+							{
+								path: "agent.a2a.securitySchemes.<name>.openIdConnectSecurityScheme",
+								name: "openIdConnectSecurityScheme",
+								type: "{ description?: string; openIdConnectUrl: string }",
+								description: "OpenID Connect scheme with an HTTPS discovery URL."
+							},
+							{
+								path: "agent.a2a.securitySchemes.<name>.mtlsSecurityScheme",
+								name: "mtlsSecurityScheme",
+								type: "{ description?: string }",
+								description: "Mutual TLS scheme."
+							}
+						]
+					},
+					{
+						path: "agent.a2a.securityRequirements",
+						name: "securityRequirements",
+						type: "readonly DocsAgentA2ASecurityRequirement[]",
+						description: "Optional agent-wide alternatives over named security schemes.",
+						children: [
+							{
+								path: "agent.a2a.securityRequirements[]",
+								name: "requirement",
+								type: "DocsAgentA2ASecurityRequirement",
+								description: "One alternative requirement; schemes inside the object are all required together."
+							},
+							{
+								path: "agent.a2a.securityRequirements[].schemes",
+								name: "schemes",
+								type: "Readonly<Record<string, DocsAgentA2ASecurityScopeList>>",
+								description: "Named security schemes and their required scopes."
+							},
+							{
+								path: "agent.a2a.securityRequirements[].schemes.<name>.list",
+								name: "list",
+								type: "readonly string[]",
+								description: "Required scopes for this named scheme; use an empty list for none."
+							}
+						]
 					},
 					{
 						path: "agent.a2a.version",
@@ -294,14 +594,14 @@ const DOCS_CONFIG_SCHEMA_OPTIONS_TEMPLATE = [
 						name: "protocolVersion",
 						type: "string",
 						default: "0.3",
-						description: "A2A protocol version implemented by the configured interface."
+						description: "Deprecated interfaceUrl shorthand option. It retains the historical 0.3 default; set it explicitly when that interface implements another version."
 					},
 					{
 						path: "agent.a2a.protocolBinding",
 						name: "protocolBinding",
 						type: "string",
 						default: "HTTP+JSON",
-						description: "A2A transport binding implemented by the configured interface."
+						description: "Deprecated interfaceUrl shorthand option. Binding implemented by that interface."
 					}
 				]
 			},

package/dist/{metadata-DWExHQnx.mjs → metadata-Cna0CtWZ.mjs}

@@ -1,4 +1,4 @@
-import { Jt as normalizePageAgentFrontmatter, qt as hasStructuredPageAgentContract } from "./agent-DKKptIgy.mjs";
+import { Jt as normalizePageAgentFrontmatter, qt as hasStructuredPageAgentContract } from "./agent-CcR8_Yyd.mjs";
 
 //#region src/metadata.ts
 /**

package/dist/{reading-time-CYZ5VvKU.mjs → reading-time-DsyUuHR4.mjs}

@@ -1,6 +1,6 @@
-import { Dt as DEFAULT_SITEMAP_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, kt as DEFAULT_SITEMAP_XML_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-DKKptIgy.mjs";
-import { c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, g as DEFAULT_API_CATALOG_ROUTE, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX } from "./standards-discovery-jkykaXq1.mjs";
-import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-BIpC4j4P.mjs";
+import { Dt as DEFAULT_SITEMAP_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, f as DEFAULT_DOCS_CONFIG_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, kt as DEFAULT_SITEMAP_XML_ROUTE, m as DEFAULT_DOCS_DIAGNOSTICS_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE } from "./agent-CcR8_Yyd.mjs";
+import { f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, n as API_CATALOG_MEDIA_TYPE, r as API_CATALOG_PROFILE_URI, t as AGENT_SKILLS_DISCOVERY_SCHEMA_URI, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-C7p5lBhc.mjs";
+import { n as DEFAULT_ROBOTS_TXT_ROUTE } from "./robots-DonzDfBW.mjs";
 import matter from "gray-matter";
 
 //#region src/define-docs.ts

package/dist/{review-CLoHTywU.mjs → review-CUo6iXMw.mjs}

@@ -1,13 +1,13 @@
-import { Ht as PAGE_AGENT_CONTRACT_FIELDS, Jt as normalizePageAgentFrontmatter, Kt as getPageAgentFrontmatterIssues, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, bt as findDocsAudienceMdxIssues, in as getDocsMcpProtectedResourceMetadataRoutes, j as buildDocsConfigMap, k as buildDocsAgentDiscoverySpec, qt as hasStructuredPageAgentContract } from "./agent-DKKptIgy.mjs";
-import { c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, g as DEFAULT_API_CATALOG_ROUTE, h as DEFAULT_API_CATALOG_FORMAT, k as resolveDocsDiscoveryApiRoute, l as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, p as DEFAULT_AGENT_SKILL_FORMAT, s as DEFAULT_AGENT_SKILLS_INDEX_FORMAT } from "./standards-discovery-jkykaXq1.mjs";
-import { d as resolveAskAISearchRequestConfig } from "./search-B6V6qtiI.mjs";
-import { a as resolveDocsMetadataBaseUrl } from "./metadata-DWExHQnx.mjs";
-import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-B7MIxuEX.mjs";
+import { Ht as PAGE_AGENT_CONTRACT_FIELDS, Jt as normalizePageAgentFrontmatter, Kt as getPageAgentFrontmatterIssues, T as DOCS_CONFIG_MAP_TOP_LEVEL_KEYS, bt as findDocsAudienceMdxIssues, in as getDocsMcpProtectedResourceMetadataRoutes, j as buildDocsConfigMap, k as buildDocsAgentDiscoverySpec, qt as hasStructuredPageAgentContract } from "./agent-CcR8_Yyd.mjs";
+import { _ as DEFAULT_API_CATALOG_FORMAT, d as DEFAULT_AGENT_SKILLS_ROUTE_PATTERN, h as DEFAULT_AGENT_SKILL_FORMAT, j as resolveDocsDiscoveryApiRoute, l as DEFAULT_AGENT_SKILLS_INDEX_FORMAT, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE } from "./standards-discovery-C7p5lBhc.mjs";
+import { d as resolveAskAISearchRequestConfig } from "./search-D0A9lRGJ.mjs";
+import { a as resolveDocsMetadataBaseUrl } from "./metadata-Cna0CtWZ.mjs";
+import { c as resolveDocsReviewConfig, o as ensureDocsReviewWorkflow, s as readDocsReviewConfigFromSource, t as runDocsGoldenTasks } from "./agent-evals-Bn_dA1_A.mjs";
 import { createFilesystemDocsMcpSource, getDocsConfigSchema, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
 import { _ as resolveDocsContentDir, g as resolveDocsConfigPath, h as readTopLevelStringProperty, s as loadDocsConfigModuleResultWithProjectEnv } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
-import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-Dj-9Eo3v.mjs";
+import { a as extractAgentBlocks, i as createAgentUsefulnessPagesFromMcp, n as analyzeAgentSurfaceDrift, r as analyzeAgentUsefulness, t as resolveGoldenEvaluationInput } from "./golden-evaluations-D7lSUeQl.mjs";
 import matter from "gray-matter";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";

package/dist/{robots-BIpC4j4P.mjs → robots-DonzDfBW.mjs}

@@ -1,5 +1,5 @@
-import { Ft as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, X as normalizeDocsPathSegment, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, en as DEFAULT_MCP_PUBLIC_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-DKKptIgy.mjs";
-import { a as DEFAULT_A2A_AGENT_CARD_ROUTE, c as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, g as DEFAULT_API_CATALOG_ROUTE, u as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, v as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, y as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-jkykaXq1.mjs";
+import { Ft as resolveDocsSitemapConfig, S as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE, X as normalizeDocsPathSegment, a as DEFAULT_AGENT_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, en as DEFAULT_MCP_PUBLIC_ROUTE, g as DEFAULT_LLMS_FULL_TXT_WELL_KNOWN_ROUTE, h as DEFAULT_LLMS_FULL_TXT_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, nn as DEFAULT_MCP_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_LLMS_TXT_ROUTE, x as DEFAULT_SKILL_MD_ROUTE, y as DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE } from "./agent-CcR8_Yyd.mjs";
+import { a as DEFAULT_A2A_AGENT_CARD_ROUTE, b as DEFAULT_LEGACY_SKILLS_INDEX_ROUTE, f as DEFAULT_AGENT_SKILLS_ROUTE_PREFIX, u as DEFAULT_AGENT_SKILLS_INDEX_ROUTE, v as DEFAULT_API_CATALOG_ROUTE, x as DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX } from "./standards-discovery-C7p5lBhc.mjs";
 
 //#region src/robots.ts
 const DEFAULT_ROBOTS_TXT_ROUTE = "/robots.txt";
@@ -61,13 +61,17 @@ function resolveDocsRobotsConfig(input, options = {}) {
 }
 function getDocsRobotsAllowRoutes(options = {}) {
 	const normalizedEntry = normalizeDocsPathSegment(options.entry ?? "docs") || "docs";
-	const sitemapConfig = resolveDocsSitemapConfig(options.sitemap);
-	const routes = [
+	return unique([
 		"/",
 		`/${normalizedEntry}`,
 		`/${normalizedEntry}/`,
 		`/${normalizedEntry}.md`,
 		`/${normalizedEntry}/*.md`,
+		...getDocsRobotsDiscoveryRoutes(options)
+	].map(normalizeRoute));
+}
+function getDocsRobotsDiscoveryRoutes(options = {}) {
+	const routes = [
 		DEFAULT_LLMS_TXT_ROUTE,
 		DEFAULT_LLMS_FULL_TXT_ROUTE,
 		DEFAULT_LLMS_TXT_WELL_KNOWN_ROUTE,
@@ -89,6 +93,7 @@ function getDocsRobotsAllowRoutes(options = {}) {
 		DEFAULT_MCP_PUBLIC_ROUTE,
 		DEFAULT_MCP_WELL_KNOWN_ROUTE
 	];
+	const sitemapConfig = resolveDocsSitemapConfig(options.sitemap);
 	if (sitemapConfig.enabled) {
 		if (sitemapConfig.xml.enabled) routes.push(sitemapConfig.xml.route);
 		if (sitemapConfig.markdown.enabled) {
@@ -169,30 +174,93 @@ function upsertDocsRobotsGeneratedBlock(existing, block) {
 	const prefix = existing.trimEnd();
 	return `${prefix}${prefix ? "\n\n" : ""}${block}`;
 }
-function blockForUserAgent(content, userAgent) {
-	const escaped = userAgent.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-	return content.match(new RegExp(`(?:^|\\n)\\s*User-agent:\\s*${escaped}\\s*(?:\\n[ \\t]*(?!User-agent:).*)*`, "i"))?.[0] ?? "";
+function parseRobotsGroups(content) {
+	const groups = [];
+	let current;
+	for (const rawLine of content.split(/\r?\n/)) {
+		const line = rawLine.replace(/#.*$/, "").trim();
+		const separator = line.indexOf(":");
+		if (separator === -1) continue;
+		const field = line.slice(0, separator).trim().toLowerCase();
+		const value = line.slice(separator + 1).trim();
+		if (field === "user-agent") {
+			if (!value) continue;
+			if (!current || current.hasRules) {
+				current = {
+					userAgents: /* @__PURE__ */ new Set(),
+					allowRoutes: /* @__PURE__ */ new Set(),
+					rules: [],
+					hasRules: false
+				};
+				groups.push(current);
+			}
+			current.userAgents.add(value.toLowerCase());
+			continue;
+		}
+		if (!current) continue;
+		if (field !== "allow" && field !== "disallow") continue;
+		current.hasRules = true;
+		if (!value) continue;
+		const pattern = normalizeRoute(value);
+		if (field === "allow") current.allowRoutes.add(pattern);
+		current.rules.push({
+			directive: field,
+			pattern
+		});
+	}
+	return groups;
+}
+function rulesForUserAgent(groups, userAgent) {
+	const normalizedUserAgent = userAgent.toLowerCase();
+	const explicitMatches = groups.filter((group) => group.userAgents.has(normalizedUserAgent));
+	const matches = explicitMatches.length > 0 ? explicitMatches : groups.filter((group) => group.userAgents.has("*"));
+	return {
+		found: explicitMatches.length > 0,
+		allowRoutes: new Set(matches.flatMap((group) => [...group.allowRoutes])),
+		rules: matches.flatMap((group) => group.rules)
+	};
+}
+function concreteDiscoveryRoute(route) {
+	return route.replace(/\*/g, "resource");
 }
-function disallowsRoute(content, route) {
-	const escapedRoute = route.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-	return new RegExp(`^\\s*Disallow:\\s*${escapedRoute}(?:\\s|$)`, "im").test(content);
+function robotsRuleMatches(pattern, route) {
+	const endAnchored = pattern.endsWith("$");
+	const expression = (endAnchored ? pattern.slice(0, -1) : pattern).split("*").map((part) => part.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join(".*");
+	return new RegExp(`^${expression}${endAnchored ? "$" : ""}`).test(route);
+}
+function robotsRuleSpecificity(pattern) {
+	return new TextEncoder().encode(pattern).byteLength;
+}
+function rulesAllowRoute(rules, route) {
+	const concreteRoute = concreteDiscoveryRoute(route);
+	let strongestMatch = -1;
+	let allowed = true;
+	for (const rule of rules) {
+		if (!robotsRuleMatches(rule.pattern, concreteRoute)) continue;
+		const specificity = robotsRuleSpecificity(rule.pattern);
+		if (specificity > strongestMatch) {
+			strongestMatch = specificity;
+			allowed = rule.directive === "allow";
+			continue;
+		}
+		if (specificity === strongestMatch && rule.directive === "allow") allowed = true;
+	}
+	return allowed;
 }
 function analyzeDocsRobotsTxt(content, options = {}) {
-	const expectedRoutes = getDocsRobotsAllowRoutes(options).filter((route) => [
-		DEFAULT_LLMS_TXT_ROUTE,
-		DEFAULT_LLMS_FULL_TXT_ROUTE,
-		DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE,
-		DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE,
-		DEFAULT_AGENTS_MD_ROUTE,
-		DEFAULT_SKILL_MD_ROUTE,
-		DEFAULT_MCP_PUBLIC_ROUTE
-	].includes(route) || route.includes("sitemap"));
-	const missingRoutes = expectedRoutes.filter((route) => !content.includes(route));
+	const expectedRoutes = options.sitemapRoutes === void 0 ? getDocsRobotsDiscoveryRoutes(options) : unique([...getDocsRobotsDiscoveryRoutes({
+		...options,
+		sitemap: false
+	}), ...options.sitemapRoutes].map(normalizeRoute));
+	const groups = parseRobotsGroups(content);
+	const wildcardRules = rulesForUserAgent(groups, "*");
+	const allowedRoutes = wildcardRules.allowRoutes;
+	const missingRoutes = expectedRoutes.filter((route) => !allowedRoutes.has(route));
 	return {
-		blocksAgentRoutes: /Disallow:\s*\/(?:\s|$)/i.test(blockForUserAgent(content, "*")) || expectedRoutes.some((route) => disallowsRoute(content, route)),
-		blocksAiAgents: DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS.some((userAgent) => /Disallow:\s*\/(?:\s|$)/i.test(blockForUserAgent(content, userAgent))),
+		blocksAgentRoutes: expectedRoutes.some((route) => !rulesAllowRoute(wildcardRules.rules, route)),
+		blocksAiAgents: DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS.some((userAgent) => expectedRoutes.some((route) => !rulesAllowRoute(rulesForUserAgent(groups, userAgent).rules, route))),
 		hasAgentRoutes: missingRoutes.length === 0,
-		hasAiPolicy: DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS.some((userAgent) => content.includes(userAgent)),
+		hasAiPolicy: DEFAULT_DOCS_AI_ROBOTS_USER_AGENTS.some((userAgent) => rulesForUserAgent(groups, userAgent).found),
 		missingRoutes
 	};
 }

package/dist/{robots-CUTahhoY.mjs → robots-rzriLh_d.mjs}

@@ -1,7 +1,7 @@
-import "./agent-DKKptIgy.mjs";
-import "./standards-discovery-jkykaXq1.mjs";
-import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-BIpC4j4P.mjs";
-import { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
+import "./agent-CcR8_Yyd.mjs";
+import "./standards-discovery-C7p5lBhc.mjs";
+import { c as renderDocsRobotsGeneratedBlock, f as upsertDocsRobotsGeneratedBlock, i as DOCS_ROBOTS_GENERATED_BLOCK_START, r as DOCS_ROBOTS_GENERATED_BLOCK_END, u as resolveDocsRobotsConfig } from "./robots-DonzDfBW.mjs";
+import { a as loadDocsConfigModule, g as resolveDocsConfigPath, h as readTopLevelStringProperty, l as readBooleanProperty, m as readTopLevelBooleanProperty, p as readStringProperty, t as extractNestedObjectLiteral } from "./config-Wcdj-D0a.mjs";
 import { t as detectFramework } from "./utils-DpiIioYb.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
@@ -70,15 +70,21 @@ function parseRobotsGenerateArgs(argv) {
 	if (parsed.append && parsed.force) throw new Error("Use either --append or --force, not both.");
 	return parsed;
 }
-function readTopLevelBooleanProperty(content, key) {
-	const match = content.match(new RegExp(`\\b${key}\\b\\s*:\\s*(true|false)`));
-	return match ? match[1] === "true" : void 0;
-}
 function readLlmsBaseUrlFromConfig(content, config) {
 	if (config?.llmsTxt && typeof config.llmsTxt === "object") return config.llmsTxt.baseUrl;
 	const block = extractNestedObjectLiteral(content, ["llmsTxt"]);
 	return block ? readStringProperty(block, "baseUrl") : void 0;
 }
+function isApiCatalogEnabled(content, config) {
+	if (config?.staticExport ?? readTopLevelBooleanProperty(content, "staticExport") ?? false) return false;
+	if (config?.llmsTxt && typeof config.llmsTxt === "object") return config.llmsTxt.apiCatalog !== false;
+	const block = extractNestedObjectLiteral(content, ["llmsTxt"]);
+	return block ? readBooleanProperty(block, "apiCatalog") !== false : true;
+}
+function isAgentCardEnabled(content, config) {
+	if (config) return Boolean(config.agent?.a2a);
+	return Boolean(extractNestedObjectLiteral(content, ["agent", "a2a"]));
+}
 function readSitemapConfigFromStatic(content) {
 	const topLevelBoolean = readTopLevelBooleanProperty(content, "sitemap");
 	if (typeof topLevelBoolean === "boolean") return topLevelBoolean;
@@ -134,6 +140,8 @@ async function generateRobots(options = {}) {
 	const sitemap = config?.sitemap ?? readSitemapConfigFromStatic(configContent) ?? true;
 	const sitemapBaseUrl = typeof sitemap === "object" ? sitemap.baseUrl : void 0;
 	const llmsBaseUrl = readLlmsBaseUrlFromConfig(configContent, config);
+	const apiCatalog = isApiCatalogEnabled(configContent, config);
+	const agentCard = isAgentCardEnabled(configContent, config);
 	const configuredRobots = resolveConfiguredRobots(configContent, config);
 	if (configuredRobots === false) throw new Error("Robots generation is disabled by `robots: false`.");
 	const robotsInput = typeof configuredRobots === "object" ? configuredRobots : {};
@@ -143,6 +151,8 @@ async function generateRobots(options = {}) {
 	const relativeRobotsPath = path.relative(rootDir, robotsPath).replace(/\\/g, "/");
 	const generatedBlock = renderDocsRobotsGeneratedBlock({
 		entry,
+		apiCatalog,
+		agentCard,
 		sitemap,
 		baseUrl: robots.baseUrl,
 		robots

package/dist/{search-CaSyi6H6.d.mts → search-B-BfnROL.d.mts}

@@ -1,5 +1,5 @@
-import { k as DocsDiscoveryApiRouteOptions } from "./standards-discovery-C4HUqMd2.mjs";
-import { B as DocsAnalyticsEventInput, Dt as DocsObservabilityConfig, F as DocsAgentTraceEventInput, Ht as DocsSearchChunkingConfig, Ot as DocsObservabilityEvent, Pn as ResolvedDocsRelatedLink, R as DocsAnalyticsConfig, Ut as DocsSearchConfig, Vt as DocsSearchAdapterFactory, Wn as TypesenseDocsSearchConfig, Wt as DocsSearchDocument, X as DocsAskAIMcpConfig, Xt as DocsSitemapConfig, Yt as DocsSearchSourcePage, f as CustomDocsSearchConfig, gn as OpenDocsProvider, kt as DocsObservabilityEventInput, pn as McpDocsSearchConfig, qt as DocsSearchResult, r as AlgoliaDocsSearchConfig, yn as OpenDocsTarget, z as DocsAnalyticsEvent, zt as DocsSearchAdapter } from "./types-lMBIdZg0.mjs";
+import { $n as ResolvedDocsRelatedLink, Fn as OpenDocsProvider, Jt as DocsObservabilityEventInput, Kt as DocsObservabilityConfig, Mn as McpDocsSearchConfig, Rn as OpenDocsTarget, at as DocsAnalyticsEventInput, cn as DocsSearchConfig, et as DocsAgentTraceEventInput, f as CustomDocsSearchConfig, fn as DocsSearchResult, hn as DocsSitemapConfig, ht as DocsAskAIMcpConfig, in as DocsSearchAdapter, it as DocsAnalyticsEvent, ln as DocsSearchDocument, lr as TypesenseDocsSearchConfig, mn as DocsSearchSourcePage, on as DocsSearchAdapterFactory, qt as DocsObservabilityEvent, r as AlgoliaDocsSearchConfig, rt as DocsAnalyticsConfig, sn as DocsSearchChunkingConfig } from "./types-BQC05SQm.mjs";
+import { M as DocsDiscoveryApiRouteOptions } from "./standards-discovery-iOmUel-o.mjs";
 
 //#region src/analytics.d.ts
 declare const DOCS_AGENT_TRACE_EVENT_TYPES: readonly ["run.start", "run.end", "run.error", "user.input", "prompt.build", "retrieval.query", "retrieval.result", "retrieval.error", "model.call", "model.response", "model.stream", "model.error", "tool.call", "tool.result", "tool.error", "retry", "timeout", "error", "agent.final"];

package/dist/{search-DSjCeOk7.mjs → search-B_CixCu9.mjs}

@@ -1,11 +1,11 @@
-import "./agent-DKKptIgy.mjs";
-import "./standards-discovery-jkykaXq1.mjs";
-import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-B6V6qtiI.mjs";
-import "./sitemap-server-C_6Wes83.mjs";
-import "./agent-evals-B7MIxuEX.mjs";
+import "./agent-CcR8_Yyd.mjs";
+import "./standards-discovery-C7p5lBhc.mjs";
+import { n as buildDocsSearchDocuments, r as createAlgoliaSearchAdapter, s as createTypesenseSearchAdapter } from "./search-D0A9lRGJ.mjs";
+import "./sitemap-server-atbbiVzW.mjs";
+import "./agent-evals-Bn_dA1_A.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./code-blocks-DnNVNK2M.mjs";
-import "./agent-skills-server-DraIb6FV.mjs";
+import "./agent-skills-server-Cuoqu8Jv.mjs";
 import "./server.mjs";
 import { _ as resolveDocsContentDir, c as loadProjectEnv, g as resolveDocsConfigPath, h as readTopLevelStringProperty } from "./config-Wcdj-D0a.mjs";
 import { readFileSync } from "node:fs";