@f5xc-salesdemos/xcsh 18.40.2 → 18.41.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5xc-salesdemos/xcsh",
-	"version": "18.40.2",
+	"version": "18.41.0",
 	"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.40.2",
-		"@f5xc-salesdemos/pi-agent-core": "18.40.2",
-		"@f5xc-salesdemos/pi-ai": "18.40.2",
-		"@f5xc-salesdemos/pi-natives": "18.40.2",
-		"@f5xc-salesdemos/pi-tui": "18.40.2",
-		"@f5xc-salesdemos/pi-utils": "18.40.2",
+		"@f5xc-salesdemos/xcsh-stats": "18.41.0",
+		"@f5xc-salesdemos/pi-agent-core": "18.41.0",
+		"@f5xc-salesdemos/pi-ai": "18.41.0",
+		"@f5xc-salesdemos/pi-natives": "18.41.0",
+		"@f5xc-salesdemos/pi-tui": "18.41.0",
+		"@f5xc-salesdemos/pi-utils": "18.41.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.18",

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

@@ -334,6 +334,8 @@ function renderResourceSpec(
 				const jsonContent = content?.["application/json"];
 				if (jsonContent?.schema) {
 					const schema = resolveSchemaRef(jsonContent.schema as Record<string, unknown>, spec);
+					const oneOfStr = renderOneOfGroups(schema);
+					if (oneOfStr) sections.push(oneOfStr);
 					sections.push(renderSchemaAsTable(schema, spec));
 				}
 			}
@@ -394,6 +396,48 @@ function resolveSchemaRef(schema: Record<string, unknown>, spec: OpenAPISpec): R
 	return (resolved as Record<string, unknown>) ?? schema;
 }
 
+function formatFieldConstraints(prop: Record<string, unknown>): string {
+	const c = prop["x-f5xc-constraints"] as Record<string, unknown> | undefined;
+	if (!c) return "";
+	const parts: string[] = [];
+	if (c.pattern) {
+		const p = String(c.pattern);
+		parts.push(p.length > 30 ? `pattern: \`${p.slice(0, 30)}…\`` : `pattern: \`${p}\``);
+	}
+	if (c.maxLength != null) parts.push(`maxLength: ${c.maxLength}`);
+	if (c.minLength != null) parts.push(`minLength: ${c.minLength}`);
+	if (c.minimum != null) parts.push(`min: ${c.minimum}`);
+	if (c.maximum != null) parts.push(`max: ${c.maximum}`);
+	if (c.minItems != null) parts.push(`minItems: ${c.minItems}`);
+	if (c.maxItems != null) parts.push(`maxItems: ${c.maxItems}`);
+	if (c.format) parts.push(`format: ${c.format}`);
+	if (Array.isArray(c.enum)) parts.push(`enum: ${(c.enum as string[]).join(", ")}`);
+	return parts.join(", ");
+}
+
+function parseOneOfOptions(val: unknown): string[] {
+	if (Array.isArray(val)) return val as string[];
+	if (typeof val === "string") {
+		try {
+			const parsed = JSON.parse(val);
+			if (Array.isArray(parsed)) return parsed as string[];
+		} catch {}
+	}
+	return [String(val)];
+}
+
+function renderOneOfGroups(schema: Record<string, unknown>): string {
+	const groups: string[] = [];
+	for (const [key, val] of Object.entries(schema)) {
+		if (!key.startsWith("x-ves-oneof-field-")) continue;
+		const groupName = key.slice("x-ves-oneof-field-".length);
+		const options = parseOneOfOptions(val).join(" | ");
+		groups.push(`- **${groupName}**: ${options}`);
+	}
+	if (groups.length === 0) return "";
+	return ["**Mutually exclusive — choose one per group:**", ...groups, ""].join("\n");
+}
+
 function renderSchemaAsTable(schema: Record<string, unknown>, spec: OpenAPISpec, depth = 0, prefix = ""): string {
 	if (depth > SCHEMA_RENDER_MAX_DEPTH) return "";
 
@@ -407,9 +451,11 @@ function renderSchemaAsTable(schema: Record<string, unknown>, spec: OpenAPISpec,
 	const required = (resolved.required as string[]) ?? [];
 	const rows: string[] = [];
 
+	const oneOfStr = renderOneOfGroups(resolved);
 	if (depth === 0) {
-		rows.push("| Field | Type | Required | Description |");
-		rows.push("|-------|------|----------|-------------|");
+		if (oneOfStr) rows.push(oneOfStr);
+		rows.push("| Field | Type | Required | Constraints | Example | Description |");
+		rows.push("|-------|------|----------|-------------|---------|-------------|");
 	}
 
 	for (const [name, prop] of Object.entries(properties)) {
@@ -418,10 +464,15 @@ function renderSchemaAsTable(schema: Record<string, unknown>, spec: OpenAPISpec,
 		const type = (fieldProp.type as string) ?? "object";
 		const desc = (fieldProp.description as string) ?? "";
 		const isRequired = required.includes(name) ? "yes" : "no";
+		const constraints = formatFieldConstraints(fieldProp);
+		const rawExample = (fieldProp["x-ves-example"] as string) ?? (fieldProp["x-f5xc-example"] as string) ?? "";
+		const example = rawExample.length > 40 ? `${rawExample.slice(0, 37)}…` : rawExample;
 
-		rows.push(`| ${fieldName} | ${type} | ${isRequired} | ${desc} |`);
+		rows.push(`| ${fieldName} | ${type} | ${isRequired} | ${constraints} | ${example} | ${desc} |`);
 
 		if (type === "object" && fieldProp.properties && depth < SCHEMA_RENDER_MAX_DEPTH) {
+			const nestedOneOf = renderOneOfGroups(fieldProp);
+			if (nestedOneOf) rows.push("", nestedOneOf);
 			const nested = renderSchemaAsTable(fieldProp, spec, depth + 1, fieldName);
 			const nestedLines = nested.split("\n").filter(l => l.startsWith("|") && !l.startsWith("| Field"));
 			rows.push(...nestedLines);

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "18.40.2",
-	"commit": "6ca1f98f1f00603630d8240a71c9690c9b7a66fb",
-	"shortCommit": "6ca1f98",
+	"version": "18.41.0",
+	"commit": "2eabc9f73616e2cbbb131a319745c8a8d8b6a7c5",
+	"shortCommit": "2eabc9f",
 	"branch": "main",
-	"tag": "v18.40.2",
-	"commitDate": "2026-05-05T05:42:42Z",
-	"buildDate": "2026-05-05T06:04:10.736Z",
+	"tag": "v18.41.0",
+	"commitDate": "2026-05-05T14:02:48Z",
+	"buildDate": "2026-05-05T14:30:23.429Z",
 	"dirty": false,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/6ca1f98f1f00603630d8240a71c9690c9b7a66fb",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.40.2"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/2eabc9f73616e2cbbb131a319745c8a8d8b6a7c5",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.41.0"
 };