@f5xc-salesdemos/xcsh 18.72.0 → 18.77.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [18.75.0] - 2026-05-23
+
+### Added
+
+- Auto-validate credentials on context switch: SDK context change listener now fires a background `validateToken()` after emitting the switch notification, sending a follow-up `context_validation_result` custom message so the LLM knows whether the new context's credentials are valid
+
 ## [18.64.2] - 2026-05-16
 
 ### Fixed
@@ -20,11 +26,13 @@
 ### Changed
 
 - Regenerated API spec index from catalog v2.1.82: http_loadbalancer CRUD verification corrections (6 new server defaults, corrected minimum configs, cross-field dependencies, default_pool inline pool discovery, 5 composable routing approaches) and tcp_loadbalancer minimum config corrections (listen_port, origin_pools_weights, do_not_advertise format, 9 server defaults, forced hash_policy default) ([#753](https://github.com/f5xc-salesdemos/xcsh/issues/753), [#757](https://github.com/f5xc-salesdemos/xcsh/issues/757))
+
 ## [18.53.0] - 2026-05-09
 
 ### Changed
 
 - Autoresearch subsystem code quality: -513 lines (18.8% reduction), ~13% faster type checking. Un-exported internal symbols, relocated types, consolidated duplicate patterns, replaced manual deep copies with `structuredClone`, replaced `while(exec)` with `matchAll`, compressed control flow, extracted shared interfaces ([#734](https://github.com/f5xc-salesdemos/xcsh/pull/734))
+
 ## [18.53.0] - 2026-05-09
 
 ### Fixed
@@ -79,13 +87,11 @@
 
 ## [18.18.4] - 2026-04-26
 
-
 ### Fixed
 
 - Fixed gutter width propagation in the fallback tool renderer: `#formatToolExecution()` now receives the actual available width at render-time and uses it for line truncation instead of a hardcoded 80-column limit. On narrow terminals (<82 cols) this prevents content wider than the gutter-adjusted viewport; on wide terminals it allows longer output lines. ([#117](https://github.com/f5xc-salesdemos/xcsh/issues/117))
 - Fixed `resolveConfigValue` returning literal env var names (e.g. `"LITELLM_API_KEY"`) as API keys when the env var is unset, causing 401 errors on first launch. The resolver now rejects unresolved `ALL_CAPS_WITH_UNDERSCORES` patterns, matching the existing guard in `resolveYamlApiKeyConfig`. ([#241](https://github.com/f5xc-salesdemos/xcsh/issues/241))
 
-
 ### Changed
 
 - Renamed F5 XC credential system from "profile" to "context" to align with kubectl conventions. The `/profile` command is now `/context`, all types/classes use `Context*` naming (`ContextService`, `ContextStatus`, `F5XCContext`, etc.), on-disk paths changed from `profiles/` to `contexts/` and `active_profile` to `active_context`, and the status-line segment ID is now `context_f5xc`. ([#302](https://github.com/f5xc-salesdemos/xcsh/issues/302))

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5xc-salesdemos/xcsh",
-	"version": "18.72.0",
+	"version": "18.77.1",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5xc-salesdemos/xcsh",
 	"author": "Can Boluk",
@@ -48,12 +48,12 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5xc-salesdemos/xcsh-stats": "18.72.0",
-		"@f5xc-salesdemos/pi-agent-core": "18.72.0",
-		"@f5xc-salesdemos/pi-ai": "18.72.0",
-		"@f5xc-salesdemos/pi-natives": "18.72.0",
-		"@f5xc-salesdemos/pi-tui": "18.72.0",
-		"@f5xc-salesdemos/pi-utils": "18.72.0",
+		"@f5xc-salesdemos/xcsh-stats": "18.77.1",
+		"@f5xc-salesdemos/pi-agent-core": "18.77.1",
+		"@f5xc-salesdemos/pi-ai": "18.77.1",
+		"@f5xc-salesdemos/pi-natives": "18.77.1",
+		"@f5xc-salesdemos/pi-tui": "18.77.1",
+		"@f5xc-salesdemos/pi-utils": "18.77.1",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.18",

package/scripts/generate-api-spec-index.ts

@@ -10,6 +10,12 @@ interface SpecPathOperation {
 	[key: string]: unknown;
 }
 
+const DEDUP_SUFFIX_RE = /_(get|post|put|delete|patch)(_\d+)?$/;
+
+function normalizeOperationId(opId: string): string {
+	return opId.replace(DEDUP_SUFFIX_RE, "");
+}
+
 function findResourceSchemaComponents(
 	resourceName: string,
 	paths: Record<string, Record<string, SpecPathOperation>>,
@@ -25,7 +31,7 @@ function findResourceSchemaComponents(
 		for (const op of Object.values(methods)) {
 			const opId = op?.operationId;
 			if (!opId) continue;
-			const match = opId.match(/^ves\.io\.schema\.(.+?)\.(?:API|CustomAPI)\./);
+			const match = normalizeOperationId(opId).match(/^ves\.io\.schema\.(.+?)\.(?:API|CustomAPI)\./);
 			if (match) found.add(match[1]);
 		}
 	}
@@ -214,6 +220,29 @@ async function downloadCatalog(specsDir: string): Promise<Record<string, unknown
 	}
 }
 
+async function downloadValidation(specsDir: string): Promise<Record<string, unknown> | null> {
+	const validationPath = path.join(specsDir, "validation.json");
+	if (fs.existsSync(validationPath)) {
+		return JSON.parse(fs.readFileSync(validationPath, "utf-8"));
+	}
+
+	const validationTag = process.env.API_SPECS_TAG ?? (await resolveLatestTag());
+	const validationUrl = `https://github.com/${REPO}/releases/download/${validationTag}/validation.json`;
+	console.log(`Downloading validation.json from ${validationUrl}...`);
+	try {
+		const response = await fetchWithRetry(validationUrl, { redirect: "follow" });
+		if (!response.ok) {
+			console.warn(`validation.json not found (${response.status}), skipping validation data generation`);
+			return null;
+		}
+		const text = await response.text();
+		return JSON.parse(text);
+	} catch (err) {
+		console.warn(`Failed to download validation.json: ${err instanceof Error ? err.message : err}`);
+		return null;
+	}
+}
+
 function serializeEnrichment(key: string, value: unknown): string | undefined {
 	if (!value) return undefined;
 	return `\t${key}: ${JSON.stringify(value)},`;
@@ -238,6 +267,7 @@ if (!fs.existsSync(indexPath)) {
 const rawIndex: RawIndex = JSON.parse(fs.readFileSync(indexPath, "utf-8"));
 
 const catalog = await downloadCatalog(specsDir);
+const validation = await downloadValidation(specsDir);
 
 const pathToCatalogCategories = new Map<string, string[]>();
 if (catalog) {
@@ -441,8 +471,12 @@ for (const entry of rawIndex.specifications) {
 	const schemaEnrichments: Record<string, Record<string, unknown>> = {};
 	for (const [schemaName, schemaDef] of Object.entries(enrichSpecJson.components?.schemas ?? {})) {
 		const rec = schemaDef["x-f5xc-recommended-oneof-variant"] as Record<string, string> | undefined;
-		if (rec) {
-			schemaEnrichments[schemaName] = { recommendedOneofVariant: rec };
+		const minConfig = schemaDef["x-f5xc-minimum-configuration"] as Record<string, unknown> | undefined;
+		if (rec || minConfig) {
+			schemaEnrichments[schemaName] = {
+				...(rec ? { recommendedOneofVariant: rec } : {}),
+				...(minConfig ? { minimumConfiguration: minConfig } : {}),
+			};
 		}
 	}
 
@@ -456,7 +490,7 @@ for (const entry of rawIndex.specifications) {
 const output = [
 	"// Auto-generated by scripts/generate-api-spec-index.ts - DO NOT EDIT",
 	"",
-	`import type { ApiSpecDomainEnrichments, ApiSpecIndex } from "./api-spec-types";`,
+	`import type { ApiSpecDomainEnrichments, ApiSpecIndex, ApiSpecValidationResourceEntry } from "./api-spec-types";`,
 	"",
 	`export const API_SPEC_VERSION = ${JSON.stringify(rawIndex.version)};`,
 	"",
@@ -480,6 +514,12 @@ const output = [
 	...enrichmentEntries,
 	`};`,
 	"",
+	...(validation
+		? [
+				`export const API_VALIDATION_DATA: Readonly<Record<string, ApiSpecValidationResourceEntry>> = ${JSON.stringify((validation as { required_fields?: { resources?: Record<string, unknown> } }).required_fields?.resources ?? {})};`,
+				"",
+			]
+		: [`export const API_VALIDATION_DATA: Readonly<Record<string, ApiSpecValidationResourceEntry>> = {};`, ""]),
 ]
 	.filter(l => l !== undefined)
 	.join("\n");

package/src/config/settings-schema.ts

@@ -1199,6 +1199,16 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
+	"todo.verbose": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "tools",
+			label: "Show Todo Tool Output",
+			description: "Display todo_write tool calls and reminders in the chat transcript",
+		},
+	},
+
 	// Search and AST tools
 	"find.enabled": {
 		type: "boolean",

package/src/internal-urls/api-spec-resolve.ts

@@ -2,6 +2,8 @@ import type {
 	ApiSpecDomainEnrichments,
 	ApiSpecDomainEntry,
 	ApiSpecIndex,
+	ApiSpecMinimumConfiguration,
+	ApiSpecValidationResourceEntry,
 	OpenAPIPathOperation,
 	OpenAPISpec,
 } from "./api-spec-types";
@@ -10,6 +12,12 @@ import type { InternalResource, InternalUrl } from "./types";
 const SCHEMA_RENDER_MAX_DEPTH = 3;
 const CRUD_OPERATION_SUFFIXES = [".API.Create", ".API.Replace", ".API.Get", ".API.List", ".API.Delete"];
 
+const DEDUP_SUFFIX_RE = /_(get|post|put|delete|patch)(_\d+)?$/;
+
+function normalizeOperationId(opId: string): string {
+	return opId.replace(DEDUP_SUFFIX_RE, "");
+}
+
 const groupsCache = new WeakMap<OpenAPISpec, Map<string, Record<string, Record<string, OpenAPIPathOperation>>>>();
 
 function getCachedGroups(spec: OpenAPISpec): Map<string, Record<string, Record<string, OpenAPIPathOperation>>> {
@@ -28,6 +36,7 @@ export function createApiSpecResolver(
 	index: ApiSpecIndex,
 	data: Readonly<Record<string, OpenAPISpec>>,
 	enrichments?: Readonly<Record<string, ApiSpecDomainEnrichments>>,
+	validationData?: Readonly<Record<string, ApiSpecValidationResourceEntry>>,
 ): ApiSpecResolver {
 	function lookup(domain: string): OpenAPISpec {
 		const spec = data[domain];
@@ -59,6 +68,16 @@ export function createApiSpecResolver(
 				return makeResource(url, renderGlossary(index));
 			}
 
+			if (domain === "validation" || domain.startsWith("validation/")) {
+				const resourceKey = domain.replace(/^validation\/?/, "");
+				return makeResource(
+					url,
+					resourceKey
+						? renderValidationDetail(resourceKey, validationData)
+						: renderValidationIndex(validationData),
+				);
+			}
+
 			const entry = index.domains.find(d => d.domain === domain);
 			if (!entry) {
 				return makeResource(url, renderUnknownDomain(domain, index));
@@ -77,7 +96,15 @@ export function createApiSpecResolver(
 					}
 					return makeResource(
 						url,
-						renderResourceSpec(domain, resource, spec, entry, { crudOnly: crud }, enrichments?.[domain]),
+						renderResourceSpec(
+							domain,
+							resource,
+							spec,
+							entry,
+							{ crudOnly: crud },
+							enrichments?.[domain],
+							validationData,
+						),
 					);
 				}
 
@@ -244,7 +271,7 @@ function renderDomainDetail(domain: string, entry: ApiSpecDomainEntry, spec: Ope
 }
 
 function extractSchemaComponent(operationId: string): string | null {
-	const match = operationId.match(/^ves\.io\.schema\.(.+?)\.(?:API|CustomAPI)\./);
+	const match = normalizeOperationId(operationId).match(/^ves\.io\.schema\.(.+?)\.(?:API|CustomAPI)\./);
 	return match ? match[1] : null;
 }
 
@@ -348,6 +375,78 @@ function filterPathsByResource(
 	return result;
 }
 
+function lookupMinConfig(
+	schemaKey: string,
+	enrichments: ApiSpecDomainEnrichments,
+): ApiSpecMinimumConfiguration | undefined {
+	const direct = enrichments.schemaEnrichments[schemaKey]?.minimumConfiguration;
+	if (direct) return direct as ApiSpecMinimumConfiguration;
+	const createReq = enrichments.schemaEnrichments[`${schemaKey}CreateRequest`]?.minimumConfiguration;
+	if (createReq) return createReq as ApiSpecMinimumConfiguration;
+	const leaf = schemaKey.includes(".") ? schemaKey.split(".").at(-1) : undefined;
+	if (leaf) {
+		const leafDirect = enrichments.schemaEnrichments[leaf]?.minimumConfiguration;
+		if (leafDirect) return leafDirect as ApiSpecMinimumConfiguration;
+		const leafCreateReq = enrichments.schemaEnrichments[`${leaf}CreateRequest`]?.minimumConfiguration;
+		if (leafCreateReq) return leafCreateReq as ApiSpecMinimumConfiguration;
+	}
+	return undefined;
+}
+
+function findResourceMinConfig(
+	resource: string,
+	entry: ApiSpecDomainEntry | undefined,
+	matchingPaths: Record<string, Record<string, OpenAPIPathOperation>>,
+	domainEnrichments?: ApiSpecDomainEnrichments,
+): ApiSpecMinimumConfiguration | undefined {
+	if (!domainEnrichments) return undefined;
+
+	if (entry) {
+		const indexedResource = entry.resources.find(r => r.name === resource);
+		if (indexedResource?.schemaComponents?.length) {
+			const mc = lookupMinConfig(indexedResource.schemaComponents[0], domainEnrichments);
+			if (mc) return mc;
+		}
+	}
+
+	for (const methods of Object.values(matchingPaths)) {
+		for (const op of Object.values(methods)) {
+			if (typeof op !== "object" || !op) continue;
+			const opId = op.operationId;
+			if (!opId) continue;
+			const schema = extractSchemaComponent(opId);
+			if (schema) {
+				const mc = lookupMinConfig(schema, domainEnrichments);
+				if (mc) return mc;
+			}
+		}
+	}
+
+	return undefined;
+}
+
+function renderMinimumConfigSection(mc: ApiSpecMinimumConfiguration): string {
+	const sections: string[] = ["## Quick Start — Minimum Configuration", ""];
+
+	if (mc.required_fields.length > 0) {
+		sections.push(`**Required fields:** ${mc.required_fields.join(", ")}`, "");
+	}
+
+	if (mc.example_json) {
+		sections.push("### JSON Example", "", "```json", mc.example_json, "```", "");
+	}
+
+	if (mc.example_yaml) {
+		sections.push("### YAML Example", "", "```yaml", mc.example_yaml, "```", "");
+	}
+
+	if (mc.example_curl) {
+		sections.push("### curl Example", "", "```bash", mc.example_curl, "```", "");
+	}
+
+	return sections.join("\n");
+}
+
 function renderResourceSpec(
 	_domain: string,
 	resource: string,
@@ -355,6 +454,7 @@ function renderResourceSpec(
 	entry?: ApiSpecDomainEntry,
 	options?: { crudOnly?: boolean },
 	domainEnrichments?: ApiSpecDomainEnrichments,
+	validationData?: Readonly<Record<string, ApiSpecValidationResourceEntry>>,
 ): string {
 	const matchingPaths = filterPathsByResource(spec, resource, entry);
 	const label = options?.crudOnly ? "CRUD Operations" : "Full API Specification";
@@ -365,13 +465,16 @@ function renderResourceSpec(
 			if (typeof op !== "object" || !op) continue;
 			if (options?.crudOnly) {
 				const opId = op.operationId ?? "";
-				if (!CRUD_OPERATION_SUFFIXES.some(s => opId.endsWith(s))) continue;
+				if (!CRUD_OPERATION_SUFFIXES.some(s => normalizeOperationId(opId).endsWith(s))) continue;
 			}
 			const operation = op;
 			sections.push(`## ${method.toUpperCase()} ${pathKey}`, "");
 			if (operation.summary) sections.push(String(operation.summary), "");
 
-			const opEnrichment = domainEnrichments?.operationMeta[operation.operationId ?? ""];
+			const rawOpId = operation.operationId ?? "";
+			const opEnrichment =
+				domainEnrichments?.operationMeta[rawOpId] ??
+				domainEnrichments?.operationMeta[normalizeOperationId(rawOpId)];
 			if (opEnrichment) {
 				const badges: string[] = [];
 				if (opEnrichment.dangerLevel) badges.push(`Danger: **${opEnrichment.dangerLevel}**`);
@@ -468,6 +571,25 @@ function renderResourceSpec(
 		}
 	}
 
+	const minConfig = findResourceMinConfig(resource, entry, matchingPaths, domainEnrichments);
+	if (minConfig) {
+		sections.push(renderMinimumConfigSection(minConfig));
+	}
+
+	const validationEntry = validationData?.[resource];
+	if (validationEntry) {
+		sections.push("## Field Requirements", "");
+		if (validationEntry.create?.length) {
+			sections.push(`**Create:** ${validationEntry.create.join(", ")}`, "");
+		}
+		if (validationEntry.update?.length) {
+			sections.push(`**Update:** ${validationEntry.update.join(", ")}`, "");
+		}
+		if (validationEntry.minimum_config?.length) {
+			sections.push(`**Minimum config:** ${validationEntry.minimum_config.join(", ")}`, "");
+		}
+	}
+
 	return sections.join("\n");
 }
 
@@ -817,6 +939,71 @@ function renderGlossary(index: ApiSpecIndex): string {
 	return sections.join("\n");
 }
 
+function renderValidationIndex(validationData?: Readonly<Record<string, ApiSpecValidationResourceEntry>>): string {
+	if (!validationData || Object.keys(validationData).length === 0) {
+		return "# API Field Requirements\n\nNo validation data available.\n";
+	}
+
+	const rows = Object.entries(validationData)
+		.sort(([a], [b]) => a.localeCompare(b))
+		.map(([name, entry]) => {
+			const createFields = entry.create?.join(", ") ?? "—";
+			const updateFields = entry.update?.join(", ") ?? "—";
+			const minFields = entry.minimum_config?.join(", ") ?? "—";
+			return `| ${name} | ${createFields} | ${updateFields} | ${minFields} |`;
+		});
+
+	return [
+		"# API Field Requirements",
+		"",
+		`${Object.keys(validationData).length} resources. Read \`xcsh://api-spec/validation/{resource}\` for details.`,
+		"",
+		"| Resource | Create Fields | Update Fields | Minimum Config Fields |",
+		"|----------|--------------|---------------|----------------------|",
+		...rows,
+		"",
+	].join("\n");
+}
+
+function renderValidationDetail(
+	resource: string,
+	validationData?: Readonly<Record<string, ApiSpecValidationResourceEntry>>,
+): string {
+	if (!validationData || Object.keys(validationData).length === 0) {
+		return `# ${resource} — Field Requirements\n\nNo validation data available.\n`;
+	}
+
+	const entry = validationData[resource];
+	if (!entry) {
+		const available = Object.keys(validationData).sort().slice(0, 20);
+		return [
+			`# Resource not found: ${resource}`,
+			"",
+			"Available resources:",
+			...available.map(r => `- \`${r}\``),
+			"",
+			"Use `xcsh://api-spec/validation/{resource}` with one of the above.",
+			"",
+		].join("\n");
+	}
+
+	const sections = [`# ${resource} — Field Requirements`, ""];
+
+	if (entry.create?.length) {
+		sections.push("## Create (full)", "", ...entry.create.map(f => `- ${f}`), "");
+	}
+
+	if (entry.update?.length) {
+		sections.push("## Update", "", ...entry.update.map(f => `- ${f}`), "");
+	}
+
+	if (entry.minimum_config?.length) {
+		sections.push("## Minimum Configuration", "", ...entry.minimum_config.map(f => `- ${f}`), "");
+	}
+
+	return sections.join("\n");
+}
+
 function renderUnknownDomain(requested: string, index: ApiSpecIndex): string {
 	const suggestions = index.domains
 		.filter(d => d.domain.includes(requested) || requested.includes(d.domain.slice(0, 3)))

package/src/internal-urls/api-spec-types.ts

@@ -177,8 +177,19 @@ export interface ApiSpecOperationEnrichment {
 	};
 }
 
+export interface ApiSpecMinimumConfiguration {
+	readonly required_fields: readonly string[];
+	readonly example_yaml?: string;
+	readonly example_json?: string;
+	readonly example_curl?: string;
+	readonly description?: string;
+	readonly mutually_exclusive_groups?: readonly unknown[];
+	readonly [key: string]: unknown;
+}
+
 export interface ApiSpecSchemaEnrichment {
 	readonly recommendedOneofVariant?: Readonly<Record<string, string>>;
+	readonly minimumConfiguration?: ApiSpecMinimumConfiguration;
 }
 
 export interface ApiSpecDomainEnrichments {
@@ -186,6 +197,13 @@ export interface ApiSpecDomainEnrichments {
 	readonly schemaEnrichments: Readonly<Record<string, ApiSpecSchemaEnrichment>>;
 }
 
+export interface ApiSpecValidationResourceEntry {
+	readonly create?: readonly string[];
+	readonly update?: readonly string[];
+	readonly minimum_config?: readonly string[];
+	readonly [key: string]: unknown;
+}
+
 export interface ApiSpecIndex {
 	readonly version: string;
 	readonly timestamp: string;

package/src/internal-urls/build-info.generated.ts

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "18.72.0",
-	"commit": "ee865e583dfa21db5c5f5bf07001570c5f7f9086",
-	"shortCommit": "ee865e5",
+	"version": "18.77.1",
+	"commit": "892a2fd604ed3fe5dece27147eb4d9fb4d968450",
+	"shortCommit": "892a2fd",
 	"branch": "main",
-	"tag": "v18.72.0",
-	"commitDate": "2026-05-19T19:45:52Z",
-	"buildDate": "2026-05-19T20:24:28.090Z",
-	"dirty": false,
+	"tag": "v18.77.1",
+	"commitDate": "2026-05-23T17:07:44-04:00",
+	"buildDate": "2026-05-23T22:08:01.020Z",
+	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/ee865e583dfa21db5c5f5bf07001570c5f7f9086",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.72.0"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/892a2fd604ed3fe5dece27147eb4d9fb4d968450",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.77.1"
 };

package/src/internal-urls/xcsh-protocol.ts

@@ -25,7 +25,12 @@ import type { ContextStatus } from "../services/f5xc-context";
 import { type ApiCatalogResolver, createApiCatalogResolver } from "./api-catalog-resolve";
 import type { ApiCatalogCategory, ApiCatalogCategorySummary, ApiCatalogIndex } from "./api-catalog-types";
 import { type ApiSpecResolver, createApiSpecResolver } from "./api-spec-resolve";
-import type { ApiSpecDomainEnrichments, ApiSpecIndex, OpenAPISpec } from "./api-spec-types";
+import type {
+	ApiSpecDomainEnrichments,
+	ApiSpecIndex,
+	ApiSpecValidationResourceEntry,
+	OpenAPISpec,
+} from "./api-spec-types";
 import { getRuntimeBuildInfo, type RuntimeBuildInfo, renderAboutDoc } from "./build-info-runtime";
 import { loadComputerProfile, renderComputerProfileMarkdown, seedComputerProfile } from "./computer-profile";
 import { EMBEDDED_DOC_FILENAMES, EMBEDDED_DOCS } from "./docs-index.generated";
@@ -55,6 +60,7 @@ let _apiSpecCache: {
 	index: ApiSpecIndex;
 	data: Readonly<Record<string, OpenAPISpec>>;
 	enrichments: Readonly<Record<string, ApiSpecDomainEnrichments>>;
+	validationData: Readonly<Record<string, ApiSpecValidationResourceEntry>>;
 	version: string;
 } | null = null;
 
@@ -62,6 +68,7 @@ function loadApiSpecs(): {
 	index: ApiSpecIndex;
 	data: Readonly<Record<string, OpenAPISpec>>;
 	enrichments: Readonly<Record<string, ApiSpecDomainEnrichments>>;
+	validationData: Readonly<Record<string, ApiSpecValidationResourceEntry>>;
 	version: string;
 } {
 	if (_apiSpecCache) return _apiSpecCache;
@@ -71,6 +78,7 @@ function loadApiSpecs(): {
 			API_SPEC_DATA?: Readonly<Record<string, unknown>>;
 			API_SPEC_VERSION?: string;
 			API_SPEC_ENRICHMENTS?: Readonly<Record<string, ApiSpecDomainEnrichments>>;
+			API_VALIDATION_DATA?: Readonly<Record<string, ApiSpecValidationResourceEntry>>;
 		};
 		const index = mod.API_SPEC_INDEX ?? EMPTY_INDEX;
 		const version = mod.API_SPEC_VERSION ?? "unknown";
@@ -81,13 +89,14 @@ function loadApiSpecs(): {
 			index,
 			data: (mod.API_SPEC_DATA ?? {}) as Readonly<Record<string, OpenAPISpec>>,
 			enrichments: mod.API_SPEC_ENRICHMENTS ?? {},
+			validationData: (mod.API_VALIDATION_DATA ?? {}) as Readonly<Record<string, ApiSpecValidationResourceEntry>>,
 			version,
 		};
 	} catch (err) {
 		logger.warn("api-spec index unavailable, embedded specs disabled", {
 			error: err instanceof Error ? err.message : String(err),
 		});
-		_apiSpecCache = { index: EMPTY_INDEX, data: {}, enrichments: {}, version: "unavailable" };
+		_apiSpecCache = { index: EMPTY_INDEX, data: {}, enrichments: {}, validationData: {}, version: "unavailable" };
 	}
 	return _apiSpecCache;
 }
@@ -153,7 +162,12 @@ export class InternalDocsProtocolHandler implements ProtocolHandler {
 	#getApiSpecResolver(): ApiSpecResolver {
 		if (!this.#apiSpecResolver) {
 			const specs = loadApiSpecs();
-			this.#apiSpecResolver = createApiSpecResolver(specs.index, specs.data, specs.enrichments);
+			this.#apiSpecResolver = createApiSpecResolver(
+				specs.index,
+				specs.data,
+				specs.enrichments,
+				specs.validationData,
+			);
 		}
 		return this.#apiSpecResolver;
 	}