@farming-labs/docs 0.2.65 → 0.2.66

package/dist/{standards-discovery-jkykaXq1.mjs → standards-discovery-C7p5lBhc.mjs}

@@ -19,6 +19,8 @@ const DEFAULT_LEGACY_SKILLS_INDEX_FORMAT = "legacy-skills";
 const DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX = "/.well-known/skills";
 const DEFAULT_A2A_AGENT_CARD_ROUTE = "/.well-known/agent-card.json";
 const DEFAULT_A2A_AGENT_CARD_FORMAT = "agent-card";
+const DEFAULT_A2A_PROTOCOL_BINDING = "HTTP+JSON";
+const DEFAULT_A2A_PROTOCOL_VERSION = "1.0";
 const AGENT_SKILLS_DISCOVERY_SCHEMA_URI = "https://schemas.agentskills.io/discovery/0.2.0/schema.json";
 const DEFAULT_DOCS_API_ROUTE = "/api/docs";
 const DEFAULT_AGENT_MANIFEST_ROUTE = "/.well-known/agent.json";
@@ -26,6 +28,7 @@ const AGENT_SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
 const AGENT_SKILL_NAME_MAX_LENGTH = 64;
 const AGENT_SKILL_DESCRIPTION_MAX_LENGTH = 1024;
 const DISCOVERY_CACHE_CONTROL = "public, max-age=0, s-maxage=3600";
+const LEGACY_A2A_PROTOCOL_VERSION = "0.3";
 function normalizeDocsRoute(value) {
 	const normalized = `/${value.trim()}`.replace(/\/{2,}/g, "/");
 	return normalized === "/" ? normalized : normalized.replace(/\/+$/, "");
@@ -210,45 +213,319 @@ function buildDocsLegacySkillsIndex(skills) {
 		}).map((file) => file.path)
 	})).sort((left, right) => left.name.localeCompare(right.name)) };
 }
+function requireA2AText(value, label) {
+	const normalized = value.trim();
+	if (!normalized) throw new Error(`${label} must not be empty.`);
+	return normalized;
+}
+function isA2ALoopbackHostname(hostname) {
+	return hostname === "localhost" || hostname.endsWith(".localhost") || hostname === "[::1]" || hostname === "::1" || /^127(?:\.\d{1,3}){3}$/.test(hostname);
+}
+function parseAbsoluteA2AUrl(value, label) {
+	let url;
+	try {
+		url = new URL(value);
+	} catch {
+		throw new Error(`${label} must be an absolute URL.`);
+	}
+	if (url.username || url.password) throw new Error(`${label} must not contain credentials.`);
+	return url;
+}
+function resolveA2ASecureHttpUrl(value, label) {
+	const url = parseAbsoluteA2AUrl(value, label);
+	if (url.protocol !== "https:" && !(url.protocol === "http:" && isA2ALoopbackHostname(url.hostname))) throw new Error(`${label} must use HTTPS (HTTP is allowed only for loopback development).`);
+	return url.toString();
+}
+function resolveA2AInterfaceUrl(value, protocolBinding, label) {
+	const url = parseAbsoluteA2AUrl(value, label);
+	if ([
+		"JSONRPC",
+		"GRPC",
+		"HTTP+JSON"
+	].includes(protocolBinding)) {
+		if (url.protocol !== "https:" && !(url.protocol === "http:" && isA2ALoopbackHostname(url.hostname))) throw new Error(`${label} must use HTTPS for core A2A bindings (HTTP is allowed only for loopback development).`);
+	} else if (new Set([
+		"file:",
+		"data:",
+		"javascript:",
+		"blob:",
+		"ftp:",
+		"mqtt:",
+		"amqp:"
+	]).has(url.protocol) || (url.protocol === "http:" || url.protocol === "ws:") && !isA2ALoopbackHostname(url.hostname)) throw new Error(`${label} must use a secure binding-appropriate URL outside loopback development.`);
+	return url.toString();
+}
+function normalizeA2AStringList(values, label, options = {}) {
+	if (!Array.isArray(values) || !options.allowEmpty && values.length === 0) throw new Error(`${label} must contain at least one value.`);
+	return values.map((value, index) => requireA2AText(value, `${label}[${index}]`));
+}
+function normalizeA2AStringMap(values, label) {
+	if (!values || typeof values !== "object" || Array.isArray(values)) throw new Error(`${label} must be an object.`);
+	const normalized = [];
+	const normalizedKeys = /* @__PURE__ */ new Set();
+	for (const [key, value] of Object.entries(values)) {
+		const normalizedKey = requireA2AText(key, `${label} key`);
+		if (normalizedKeys.has(normalizedKey)) throw new Error(`${label} must not contain duplicate keys after trimming.`);
+		normalizedKeys.add(normalizedKey);
+		normalized.push([normalizedKey, requireA2AText(value, `${label}.${normalizedKey}`)]);
+	}
+	return Object.fromEntries(normalized);
+}
+function normalizeA2AInterface(value, index) {
+	const label = `agent.a2a.supportedInterfaces[${index}]`;
+	const protocolBinding = requireA2AText(value.protocolBinding ?? DEFAULT_A2A_PROTOCOL_BINDING, `${label}.protocolBinding`);
+	if (![
+		"JSONRPC",
+		"GRPC",
+		"HTTP+JSON"
+	].includes(protocolBinding)) try {
+		new URL(protocolBinding);
+	} catch {
+		throw new Error(`${label}.protocolBinding must be a core A2A binding or an absolute URI.`);
+	}
+	const url = resolveA2AInterfaceUrl(value.url, protocolBinding, `${label}.url`);
+	const protocolVersion = requireA2AText(value.protocolVersion ?? DEFAULT_A2A_PROTOCOL_VERSION, `${label}.protocolVersion`);
+	if (!/^\d+\.\d+$/.test(protocolVersion)) throw new Error(`${label}.protocolVersion must use A2A major.minor form (for example, "1.0").`);
+	const tenant = value.tenant === void 0 ? void 0 : requireA2AText(value.tenant, `${label}.tenant`);
+	return {
+		url,
+		protocolBinding,
+		protocolVersion,
+		...tenant ? { tenant } : {}
+	};
+}
+function normalizeA2AExtension(extension, index) {
+	const label = `agent.a2a.capabilities.extensions[${index}]`;
+	const uri = requireA2AText(extension.uri, `${label}.uri`);
+	try {
+		new URL(uri);
+	} catch {
+		throw new Error(`${label}.uri must be an absolute URI.`);
+	}
+	let params;
+	if (extension.params !== void 0) {
+		if (!extension.params || typeof extension.params !== "object" || Array.isArray(extension.params)) throw new Error(`${label}.params must be a JSON object.`);
+		try {
+			params = JSON.parse(JSON.stringify(extension.params));
+		} catch {
+			throw new Error(`${label}.params must be JSON serializable.`);
+		}
+	}
+	return {
+		uri,
+		...extension.description !== void 0 ? { description: requireA2AText(extension.description, `${label}.description`) } : {},
+		...extension.required !== void 0 ? { required: extension.required } : {},
+		...params ? { params } : {}
+	};
+}
+function normalizeA2ACapabilities(capabilities) {
+	return {
+		streaming: capabilities?.streaming ?? false,
+		pushNotifications: capabilities?.pushNotifications ?? false,
+		...capabilities?.extensions ? { extensions: capabilities.extensions.map((extension, index) => normalizeA2AExtension(extension, index)) } : {},
+		...capabilities?.extendedAgentCard !== void 0 ? { extendedAgentCard: capabilities.extendedAgentCard } : {}
+	};
+}
+function normalizeA2ASecurityRequirements(requirements, label) {
+	if (requirements === void 0) return void 0;
+	return requirements.map((requirement, requirementIndex) => {
+		if (!requirement.schemes || typeof requirement.schemes !== "object" || Array.isArray(requirement.schemes)) throw new Error(`${label}[${requirementIndex}].schemes must be an object.`);
+		const schemes = [];
+		const schemeNames = /* @__PURE__ */ new Set();
+		for (const [name, scopes] of Object.entries(requirement.schemes)) {
+			const schemeName = requireA2AText(name, `${label}[${requirementIndex}].schemes key`);
+			if (schemeNames.has(schemeName)) throw new Error(`${label}[${requirementIndex}].schemes must not contain duplicate keys after trimming.`);
+			schemeNames.add(schemeName);
+			schemes.push([schemeName, { list: normalizeA2AStringList(scopes.list, `${label}[${requirementIndex}].schemes.${schemeName}.list`, { allowEmpty: true }) }]);
+		}
+		return { schemes: Object.fromEntries(schemes) };
+	});
+}
+function normalizeA2AOAuthFlows(flows, label) {
+	if ([
+		flows.authorizationCode ? "authorizationCode" : null,
+		flows.clientCredentials ? "clientCredentials" : null,
+		flows.deviceCode ? "deviceCode" : null,
+		flows.implicit ? "implicit" : null,
+		flows.password ? "password" : null
+	].filter((name) => Boolean(name)).length !== 1) throw new Error(`${label} must configure exactly one OAuth flow.`);
+	if (flows.authorizationCode) {
+		const flow = flows.authorizationCode;
+		return { authorizationCode: {
+			authorizationUrl: resolveA2ASecureHttpUrl(flow.authorizationUrl, `${label}.authorizationCode.authorizationUrl`),
+			tokenUrl: resolveA2ASecureHttpUrl(flow.tokenUrl, `${label}.authorizationCode.tokenUrl`),
+			...flow.refreshUrl !== void 0 ? { refreshUrl: resolveA2ASecureHttpUrl(flow.refreshUrl, `${label}.authorizationCode.refreshUrl`) } : {},
+			scopes: normalizeA2AStringMap(flow.scopes, `${label}.authorizationCode.scopes`),
+			...flow.pkceRequired !== void 0 ? { pkceRequired: flow.pkceRequired } : {}
+		} };
+	}
+	if (flows.clientCredentials) {
+		const flow = flows.clientCredentials;
+		return { clientCredentials: {
+			tokenUrl: resolveA2ASecureHttpUrl(flow.tokenUrl, `${label}.clientCredentials.tokenUrl`),
+			...flow.refreshUrl !== void 0 ? { refreshUrl: resolveA2ASecureHttpUrl(flow.refreshUrl, `${label}.clientCredentials.refreshUrl`) } : {},
+			scopes: normalizeA2AStringMap(flow.scopes, `${label}.clientCredentials.scopes`)
+		} };
+	}
+	if (flows.deviceCode) {
+		const flow = flows.deviceCode;
+		return { deviceCode: {
+			deviceAuthorizationUrl: resolveA2ASecureHttpUrl(flow.deviceAuthorizationUrl, `${label}.deviceCode.deviceAuthorizationUrl`),
+			tokenUrl: resolveA2ASecureHttpUrl(flow.tokenUrl, `${label}.deviceCode.tokenUrl`),
+			...flow.refreshUrl !== void 0 ? { refreshUrl: resolveA2ASecureHttpUrl(flow.refreshUrl, `${label}.deviceCode.refreshUrl`) } : {},
+			scopes: normalizeA2AStringMap(flow.scopes, `${label}.deviceCode.scopes`)
+		} };
+	}
+	if (flows.implicit) {
+		const flow = flows.implicit;
+		return { implicit: {
+			authorizationUrl: resolveA2ASecureHttpUrl(flow.authorizationUrl, `${label}.implicit.authorizationUrl`),
+			...flow.refreshUrl !== void 0 ? { refreshUrl: resolveA2ASecureHttpUrl(flow.refreshUrl, `${label}.implicit.refreshUrl`) } : {},
+			scopes: normalizeA2AStringMap(flow.scopes, `${label}.implicit.scopes`)
+		} };
+	}
+	const flow = flows.password;
+	return { password: {
+		tokenUrl: resolveA2ASecureHttpUrl(flow.tokenUrl, `${label}.password.tokenUrl`),
+		...flow.refreshUrl !== void 0 ? { refreshUrl: resolveA2ASecureHttpUrl(flow.refreshUrl, `${label}.password.refreshUrl`) } : {},
+		scopes: normalizeA2AStringMap(flow.scopes, `${label}.password.scopes`)
+	} };
+}
+function normalizeA2ASecurityScheme(scheme, name) {
+	const label = `agent.a2a.securitySchemes.${name}`;
+	if ([
+		scheme.apiKeySecurityScheme ? "apiKeySecurityScheme" : null,
+		scheme.httpAuthSecurityScheme ? "httpAuthSecurityScheme" : null,
+		scheme.oauth2SecurityScheme ? "oauth2SecurityScheme" : null,
+		scheme.openIdConnectSecurityScheme ? "openIdConnectSecurityScheme" : null,
+		scheme.mtlsSecurityScheme ? "mtlsSecurityScheme" : null
+	].filter((key) => Boolean(key)).length !== 1) throw new Error(`${label} must configure exactly one A2A security scheme.`);
+	if (scheme.apiKeySecurityScheme) {
+		const value = scheme.apiKeySecurityScheme;
+		if (![
+			"query",
+			"header",
+			"cookie"
+		].includes(value.location)) throw new Error(`${label}.apiKeySecurityScheme.location is invalid.`);
+		return { apiKeySecurityScheme: {
+			...value.description !== void 0 ? { description: requireA2AText(value.description, `${label}.apiKeySecurityScheme.description`) } : {},
+			location: value.location,
+			name: requireA2AText(value.name, `${label}.apiKeySecurityScheme.name`)
+		} };
+	}
+	if (scheme.httpAuthSecurityScheme) {
+		const value = scheme.httpAuthSecurityScheme;
+		return { httpAuthSecurityScheme: {
+			...value.description !== void 0 ? { description: requireA2AText(value.description, `${label}.httpAuthSecurityScheme.description`) } : {},
+			scheme: requireA2AText(value.scheme, `${label}.httpAuthSecurityScheme.scheme`),
+			...value.bearerFormat !== void 0 ? { bearerFormat: requireA2AText(value.bearerFormat, `${label}.httpAuthSecurityScheme.bearerFormat`) } : {}
+		} };
+	}
+	if (scheme.oauth2SecurityScheme) {
+		const value = scheme.oauth2SecurityScheme;
+		return { oauth2SecurityScheme: {
+			...value.description !== void 0 ? { description: requireA2AText(value.description, `${label}.oauth2SecurityScheme.description`) } : {},
+			flows: normalizeA2AOAuthFlows(value.flows, `${label}.oauth2SecurityScheme.flows`),
+			...value.oauth2MetadataUrl !== void 0 ? { oauth2MetadataUrl: resolveA2ASecureHttpUrl(value.oauth2MetadataUrl, `${label}.oauth2SecurityScheme.oauth2MetadataUrl`) } : {}
+		} };
+	}
+	if (scheme.openIdConnectSecurityScheme) {
+		const value = scheme.openIdConnectSecurityScheme;
+		return { openIdConnectSecurityScheme: {
+			...value.description !== void 0 ? { description: requireA2AText(value.description, `${label}.openIdConnectSecurityScheme.description`) } : {},
+			openIdConnectUrl: resolveA2ASecureHttpUrl(value.openIdConnectUrl, `${label}.openIdConnectSecurityScheme.openIdConnectUrl`)
+		} };
+	}
+	const value = scheme.mtlsSecurityScheme;
+	return { mtlsSecurityScheme: value.description !== void 0 ? { description: requireA2AText(value.description, `${label}.mtlsSecurityScheme.description`) } : {} };
+}
+function validateA2ARequirementReferences(requirements, schemeNames, label) {
+	for (const [requirementIndex, requirement] of (requirements ?? []).entries()) for (const schemeName of Object.keys(requirement.schemes)) if (!schemeNames.has(schemeName)) throw new Error(`${label}[${requirementIndex}] references undefined security scheme "${schemeName}".`);
+}
+function normalizeA2ASkill(skill, index) {
+	const label = `agent.a2a.skills[${index}]`;
+	return {
+		id: requireA2AText(skill.id, `${label}.id`),
+		name: requireA2AText(skill.name, `${label}.name`),
+		description: requireA2AText(skill.description, `${label}.description`),
+		tags: normalizeA2AStringList(skill.tags, `${label}.tags`),
+		...skill.examples !== void 0 ? { examples: normalizeA2AStringList(skill.examples, `${label}.examples`, { allowEmpty: true }) } : {},
+		...skill.inputModes !== void 0 ? { inputModes: normalizeA2AStringList(skill.inputModes, `${label}.inputModes`) } : {},
+		...skill.outputModes !== void 0 ? { outputModes: normalizeA2AStringList(skill.outputModes, `${label}.outputModes`) } : {},
+		...skill.securityRequirements !== void 0 ? { securityRequirements: normalizeA2ASecurityRequirements(skill.securityRequirements, `${label}.securityRequirements`) } : {}
+	};
+}
 /** Build an A2A Agent Card only when a real A2A interface is explicitly configured. */
 function buildDocsA2AAgentCard(options, skills) {
-	const interfaceUrl = resolveHttpUrl(options.interfaceUrl, options.interfaceUrl);
-	const documentationUrl = resolveHttpUrl(options.documentationUrl, options.interfaceUrl);
-	const providerUrl = resolveHttpUrl(options.provider.url, options.interfaceUrl);
-	if (!interfaceUrl || !documentationUrl || !providerUrl) throw new Error("A2A Agent Card URLs must use HTTP(S).");
-	const protocolVersion = options.protocolVersion ?? "0.3";
-	const protocolBinding = options.protocolBinding ?? "HTTP+JSON";
+	const usesSupportedInterfaces = options.supportedInterfaces !== void 0;
+	if (usesSupportedInterfaces && ("interfaceUrl" in options || "protocolBinding" in options || "protocolVersion" in options)) throw new Error("agent.a2a.supportedInterfaces cannot be combined with the deprecated interfaceUrl shorthand.");
+	const interfaceConfigs = options.supportedInterfaces ?? ("interfaceUrl" in options ? [{
+		url: options.interfaceUrl,
+		protocolBinding: options.protocolBinding,
+		protocolVersion: options.protocolVersion ?? LEGACY_A2A_PROTOCOL_VERSION
+	}] : []);
+	if (interfaceConfigs.length === 0) throw new Error("agent.a2a.supportedInterfaces must contain at least one interface.");
+	const supportedInterfaces = interfaceConfigs.map(normalizeA2AInterface);
+	const interfaceKeys = /* @__PURE__ */ new Set();
+	for (const value of supportedInterfaces) {
+		const key = `${value.url}\u0000${value.protocolBinding}\u0000${value.protocolVersion}\u0000${value.tenant ?? ""}`;
+		if (interfaceKeys.has(key)) throw new Error("agent.a2a.supportedInterfaces must not contain duplicate interfaces.");
+		interfaceKeys.add(key);
+	}
+	const provider = options.provider ? {
+		organization: requireA2AText(options.provider.organization, "agent.a2a.provider.organization"),
+		url: resolveA2ASecureHttpUrl(options.provider.url, "agent.a2a.provider.url")
+	} : void 0;
+	const documentationUrl = options.documentationUrl !== void 0 ? resolveA2ASecureHttpUrl(options.documentationUrl, "agent.a2a.documentationUrl") : void 0;
+	const iconUrl = options.iconUrl !== void 0 ? resolveA2ASecureHttpUrl(options.iconUrl, "agent.a2a.iconUrl") : void 0;
+	const capabilities = normalizeA2ACapabilities(options.capabilities);
+	let securitySchemes;
+	if (options.securitySchemes !== void 0) {
+		const entries = Object.entries(options.securitySchemes);
+		if (entries.length === 0) throw new Error("agent.a2a.securitySchemes must contain at least one scheme when configured.");
+		const normalizedSchemes = [];
+		const normalizedNames = /* @__PURE__ */ new Set();
+		for (const [name, scheme] of entries) {
+			const normalizedName = requireA2AText(name, "agent.a2a.securitySchemes key");
+			if (normalizedNames.has(normalizedName)) throw new Error("agent.a2a.securitySchemes must not contain duplicate keys after trimming.");
+			normalizedNames.add(normalizedName);
+			normalizedSchemes.push([normalizedName, normalizeA2ASecurityScheme(scheme, normalizedName)]);
+		}
+		securitySchemes = Object.fromEntries(normalizedSchemes);
+	}
+	const securityRequirements = normalizeA2ASecurityRequirements(options.securityRequirements, "agent.a2a.securityRequirements");
+	const securitySchemeNames = new Set(Object.keys(securitySchemes ?? {}));
+	validateA2ARequirementReferences(securityRequirements, securitySchemeNames, "agent.a2a.securityRequirements");
+	if (capabilities.extendedAgentCard && (!securitySchemes || !securityRequirements?.some((requirement) => Object.keys(requirement.schemes).length > 0))) throw new Error("agent.a2a.capabilities.extendedAgentCard requires a configured security scheme and a non-empty security requirement.");
+	if (usesSupportedInterfaces && options.skills === void 0) throw new Error("agent.a2a.skills is required with supportedInterfaces so the card advertises only implemented A2A capabilities.");
+	const configuredSkills = options.skills === void 0 ? toPublishedSkillArray(skills).map((skill) => ({
+		id: skill.name,
+		name: skill.name,
+		description: skill.description,
+		tags: ["documentation"],
+		examples: []
+	})).sort((left, right) => left.name.localeCompare(right.name)) : options.skills.map(normalizeA2ASkill);
+	if (configuredSkills.length === 0) throw new Error("agent.a2a.skills must contain at least one skill.");
+	const skillIds = /* @__PURE__ */ new Set();
+	for (const [index, skill] of configuredSkills.entries()) {
+		if (skillIds.has(skill.id)) throw new Error(`agent.a2a.skills[${index}].id must be unique.`);
+		skillIds.add(skill.id);
+		validateA2ARequirementReferences(skill.securityRequirements, securitySchemeNames, `agent.a2a.skills[${index}].securityRequirements`);
+	}
 	return {
-		protocolVersion,
-		preferredTransport: protocolBinding,
-		supportedInterfaces: [{
-			url: interfaceUrl,
-			protocolBinding,
-			protocolVersion
-		}],
-		name: options.name,
-		description: options.description,
-		url: interfaceUrl,
-		provider: {
-			organization: options.provider.organization,
-			url: providerUrl
-		},
-		version: options.version ?? "1.0.0",
-		documentationUrl,
-		capabilities: {
-			streaming: false,
-			pushNotifications: false
-		},
-		defaultInputModes: ["text/plain"],
-		defaultOutputModes: ["text/plain"],
-		skills: toPublishedSkillArray(skills).map((skill) => ({
-			id: skill.name,
-			name: skill.name,
-			description: skill.description,
-			tags: ["documentation"],
-			examples: [],
-			url: skill.url
-		})).sort((left, right) => left.name.localeCompare(right.name))
+		name: requireA2AText(options.name, "agent.a2a.name"),
+		description: requireA2AText(options.description, "agent.a2a.description"),
+		supportedInterfaces,
+		...provider ? { provider } : {},
+		version: requireA2AText(options.version ?? "1.0.0", "agent.a2a.version"),
+		...documentationUrl ? { documentationUrl } : {},
+		capabilities,
+		defaultInputModes: normalizeA2AStringList(options.defaultInputModes ?? ["text/plain"], "agent.a2a.defaultInputModes"),
+		defaultOutputModes: normalizeA2AStringList(options.defaultOutputModes ?? ["text/plain"], "agent.a2a.defaultOutputModes"),
+		skills: configuredSkills,
+		...securitySchemes ? { securitySchemes } : {},
+		...securityRequirements ? { securityRequirements } : {},
+		...iconUrl ? { iconUrl } : {}
 	};
 }
 function resolveDocsStandardsDiscoveryRequest(url, options = {}) {
@@ -516,4 +793,4 @@ async function createDocsStandardsResponse({ request, apiCatalog, apiCatalogEnab
 }
 
 //#endregion
-export { resolveDocsPublishedAgentSkill as A, buildDocsApiCatalog as C, getDocsDiscoveryLinkHeader as D, createDocsStandardsResponse as E, sha256DocsDiscoveryContent as M, isDocsStandardsDiscoveryRequest as O, buildDocsAgentSkillsIndex as S, buildDocsPublishedAgentSkill as T, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as _, DEFAULT_A2A_AGENT_CARD_ROUTE as a, appendDocsDiscoveryLinkHeader as b, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as c, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as d, DEFAULT_AGENT_SKILL_FILE_FORMAT as f, DEFAULT_API_CATALOG_ROUTE as g, DEFAULT_API_CATALOG_FORMAT as h, DEFAULT_A2A_AGENT_CARD_FORMAT as i, resolveDocsStandardsDiscoveryRequest as j, resolveDocsDiscoveryApiRoute as k, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as l, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as o, DEFAULT_AGENT_SKILL_FORMAT as p, API_CATALOG_PROFILE_URI as r, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as u, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as v, buildDocsLegacySkillsIndex as w, buildDocsA2AAgentCard as x, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as y };
+export { isDocsStandardsDiscoveryRequest as A, buildDocsA2AAgentCard as C, buildDocsPublishedAgentSkill as D, buildDocsLegacySkillsIndex as E, resolveDocsPublishedAgentSkill as M, resolveDocsStandardsDiscoveryRequest as N, createDocsStandardsResponse as O, sha256DocsDiscoveryContent as P, appendDocsDiscoveryLinkHeader as S, buildDocsApiCatalog as T, DEFAULT_API_CATALOG_FORMAT as _, DEFAULT_A2A_AGENT_CARD_ROUTE as a, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as b, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as c, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as d, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as f, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as g, DEFAULT_AGENT_SKILL_FORMAT as h, DEFAULT_A2A_AGENT_CARD_FORMAT as i, resolveDocsDiscoveryApiRoute as j, getDocsDiscoveryLinkHeader as k, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as l, DEFAULT_AGENT_SKILL_FILE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, DEFAULT_A2A_PROTOCOL_BINDING as o, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as p, API_CATALOG_PROFILE_URI as r, DEFAULT_A2A_PROTOCOL_VERSION as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as u, DEFAULT_API_CATALOG_ROUTE as v, buildDocsAgentSkillsIndex as w, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as x, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as y };

package/dist/{standards-discovery-C4HUqMd2.d.mts → standards-discovery-iOmUel-o.d.mts}

@@ -1,3 +1,5 @@
+import { A as DocsAgentA2ASecurityScheme, M as DocsAgentA2ASkill, O as DocsAgentA2AProtocolBinding, h as DocsAgentA2AConfig, k as DocsAgentA2ASecurityRequirement, m as DocsAgentA2ACapabilities } from "./types-BQC05SQm.mjs";
+
 //#region src/standards-discovery.d.ts
 declare const DEFAULT_API_CATALOG_ROUTE = "/.well-known/api-catalog";
 declare const DEFAULT_API_CATALOG_FORMAT = "api-catalog";
@@ -17,6 +19,8 @@ declare const DEFAULT_LEGACY_SKILLS_INDEX_FORMAT = "legacy-skills";
 declare const DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX = "/.well-known/skills";
 declare const DEFAULT_A2A_AGENT_CARD_ROUTE = "/.well-known/agent-card.json";
 declare const DEFAULT_A2A_AGENT_CARD_FORMAT = "agent-card";
+declare const DEFAULT_A2A_PROTOCOL_BINDING = "HTTP+JSON";
+declare const DEFAULT_A2A_PROTOCOL_VERSION = "1.0";
 declare const AGENT_SKILLS_DISCOVERY_SCHEMA_URI = "https://schemas.agentskills.io/discovery/0.2.0/schema.json";
 interface DocsAgentSkillIndexEntry {
   name: string;
@@ -55,51 +59,30 @@ interface DocsLegacySkillsIndex {
     files: string[];
   }>;
 }
-interface DocsA2AAgentCardOptions {
-  /** URL of a real A2A interface. Merely exposing docs or MCP is not sufficient. */
-  interfaceUrl: string;
-  name: string;
-  description: string;
-  documentationUrl: string;
-  provider: {
-    organization: string;
-    url: string;
-  };
-  version?: string;
-  protocolVersion?: string;
-  protocolBinding?: string;
+type DocsA2AAgentCardOptions = DocsAgentA2AConfig;
+interface DocsA2AAgentInterface {
+  url: string;
+  protocolBinding: DocsAgentA2AProtocolBinding;
+  protocolVersion: string;
+  tenant?: string;
 }
 interface DocsA2AAgentCard {
-  protocolVersion: string;
-  preferredTransport: string;
-  supportedInterfaces: Array<{
-    url: string;
-    protocolBinding: string;
-    protocolVersion: string;
-  }>;
   name: string;
   description: string;
-  url: string;
-  provider: {
+  supportedInterfaces: DocsA2AAgentInterface[];
+  provider?: {
     organization: string;
     url: string;
   };
   version: string;
-  documentationUrl: string;
-  capabilities: {
-    streaming: false;
-    pushNotifications: false;
-  };
-  defaultInputModes: ["text/plain"];
-  defaultOutputModes: ["text/plain"];
-  skills: Array<{
-    id: string;
-    name: string;
-    description: string;
-    tags: string[];
-    examples: string[];
-    url: string;
-  }>;
+  documentationUrl?: string;
+  capabilities: DocsAgentA2ACapabilities;
+  defaultInputModes: string[];
+  defaultOutputModes: string[];
+  skills: DocsAgentA2ASkill[];
+  securitySchemes?: Record<string, DocsAgentA2ASecurityScheme>;
+  securityRequirements?: DocsAgentA2ASecurityRequirement[];
+  iconUrl?: string;
 }
 interface DocsPublishedAgentSkillOptions {
   preferredDocument?: string | null;
@@ -224,4 +207,4 @@ declare function createDocsStandardsResponse({
   agentCard
 }: CreateDocsStandardsResponseOptions): Promise<Response | null>;
 //#endregion
-export { DocsPublishedAgentSkill as A, createDocsStandardsResponse as B, DocsAgentSkillIndexEntry as C, DocsApiCatalogLinkTarget as D, DocsApiCatalogLinkContext as E, appendDocsDiscoveryLinkHeader as F, resolveDocsStandardsDiscoveryRequest as G, isDocsStandardsDiscoveryRequest as H, buildDocsA2AAgentCard as I, sha256DocsDiscoveryContent as K, buildDocsAgentSkillsIndex as L, DocsPublishedAgentSkillOptions as M, DocsStandardsDiscoveryRequest as N, DocsApiCatalogOptions as O, DocsStandardsDiscoveryRouteOptions as P, buildDocsApiCatalog as R, DocsA2AAgentCardOptions as S, DocsApiCatalog as T, resolveDocsDiscoveryApiRoute as U, getDocsDiscoveryLinkHeader as V, resolveDocsPublishedAgentSkill as W, DEFAULT_API_CATALOG_ROUTE as _, DEFAULT_A2A_AGENT_CARD_FORMAT as a, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as b, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as c, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as d, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as f, DEFAULT_API_CATALOG_FORMAT as g, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as h, CreateDocsStandardsResponseOptions as i, DocsPublishedAgentSkillFile as j, DocsDiscoveryApiRouteOptions as k, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as l, DEFAULT_AGENT_SKILL_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, DEFAULT_A2A_AGENT_CARD_ROUTE as o, DEFAULT_AGENT_SKILL_FILE_FORMAT as p, API_CATALOG_PROFILE_URI as r, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as u, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as v, DocsAgentSkillsIndex as w, DocsA2AAgentCard as x, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as y, buildDocsLegacySkillsIndex as z };
+export { DocsApiCatalogLinkTarget as A, buildDocsAgentSkillsIndex as B, DocsA2AAgentCard as C, DocsAgentSkillsIndex as D, DocsAgentSkillIndexEntry as E, DocsPublishedAgentSkillOptions as F, isDocsStandardsDiscoveryRequest as G, buildDocsLegacySkillsIndex as H, DocsStandardsDiscoveryRequest as I, resolveDocsStandardsDiscoveryRequest as J, resolveDocsDiscoveryApiRoute as K, DocsStandardsDiscoveryRouteOptions as L, DocsDiscoveryApiRouteOptions as M, DocsPublishedAgentSkill as N, DocsApiCatalog as O, DocsPublishedAgentSkillFile as P, appendDocsDiscoveryLinkHeader as R, DEFAULT_LEGACY_SKILLS_ROUTE_PREFIX as S, DocsA2AAgentInterface as T, createDocsStandardsResponse as U, buildDocsApiCatalog as V, getDocsDiscoveryLinkHeader as W, sha256DocsDiscoveryContent as Y, DEFAULT_AGENT_SKILL_RESOURCE_FORMAT as _, DEFAULT_A2A_AGENT_CARD_FORMAT as a, DEFAULT_LEGACY_SKILLS_INDEX_FORMAT as b, DEFAULT_A2A_PROTOCOL_VERSION as c, DEFAULT_AGENT_SKILLS_INDEX_ROUTE as d, DEFAULT_AGENT_SKILLS_ROUTE_PATTERN as f, DEFAULT_AGENT_SKILL_FORMAT as g, DEFAULT_AGENT_SKILL_FILE_FORMAT as h, CreateDocsStandardsResponseOptions as i, DocsApiCatalogOptions as j, DocsApiCatalogLinkContext as k, DEFAULT_AGENT_SKILLS_ARCHIVE_ROUTE_PATTERN as l, DEFAULT_AGENT_SKILL_ARCHIVE_FORMAT as m, API_CATALOG_MEDIA_TYPE as n, DEFAULT_A2A_AGENT_CARD_ROUTE as o, DEFAULT_AGENT_SKILLS_ROUTE_PREFIX as p, resolveDocsPublishedAgentSkill as q, API_CATALOG_PROFILE_URI as r, DEFAULT_A2A_PROTOCOL_BINDING as s, AGENT_SKILLS_DISCOVERY_SCHEMA_URI as t, DEFAULT_AGENT_SKILLS_INDEX_FORMAT as u, DEFAULT_API_CATALOG_FORMAT as v, DocsA2AAgentCardOptions as w, DEFAULT_LEGACY_SKILLS_INDEX_ROUTE as x, DEFAULT_API_CATALOG_ROUTE as y, buildDocsA2AAgentCard as z };