@f5xc-salesdemos/xcsh 18.33.2 → 18.33.3

package/package.json

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

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

@@ -42,6 +42,7 @@ export function createApiCatalogResolver(
 			const category = pathname.replace(/^\//, "").replace(/\/$/, "");
 			const search = url.searchParams.get("search");
 			const resourceName = url.searchParams.get("resource");
+			const compact = url.searchParams.get("compact") === "true";
 
 			if (!category) {
 				if (resourceName && specIndex) {
@@ -52,7 +53,7 @@ export function createApiCatalogResolver(
 							if (categorySummaries.some(c => c.name === catName)) {
 								try {
 									const cat = decompress(catName);
-									return makeResource(url, renderCatalogDetail(cat, index));
+									return makeResource(url, renderCatalogDetail(cat, index, { compact }));
 								} catch {
 									break;
 								}
@@ -75,7 +76,7 @@ export function createApiCatalogResolver(
 
 			try {
 				const cat = decompress(category);
-				return makeResource(url, renderCatalogDetail(cat, index));
+				return makeResource(url, renderCatalogDetail(cat, index, { compact }));
 			} catch (err) {
 				const message = err instanceof Error ? err.message : String(err);
 				return makeResource(url, `# Error loading ${category}\n\n${message}\n`);
@@ -182,8 +183,10 @@ function formatDefault(defaultVal: unknown, serverDefault: boolean | undefined):
 	return serverDefault ? `${val} (server)` : val;
 }
 
-function renderCatalogDetail(cat: ApiCatalogCategory, index: ApiCatalogIndex): string {
+function renderCatalogDetail(cat: ApiCatalogCategory, index: ApiCatalogIndex, options?: { compact?: boolean }): string {
 	const sections: string[] = [`# ${cat.displayName}`, "", `${cat.operations.length} operations.`];
+	let fieldConstraintsRenderedForOp: string | null = null;
+	let fieldConstraintsFingerprint: string | null = null;
 
 	for (const op of cat.operations) {
 		sections.push("", `## ${op.method.toUpperCase()} ${op.path}`, "");
@@ -230,17 +233,25 @@ function renderCatalogDetail(cat: ApiCatalogCategory, index: ApiCatalogIndex): s
 			sections.push("", "```json", JSON.stringify(op.minimumPayload.json, null, 2), "```");
 		}
 
-		// Field Constraints (Tier 2)
-		if (op.fieldMetadata && Object.keys(op.fieldMetadata).length > 0) {
-			sections.push("", "### Field Constraints", "");
-			sections.push("| Field | Type | Description | Constraint | Required For | Default |");
-			sections.push("|-------|------|-------------|-----------|--------------|---------|");
-			for (const [field, meta] of Object.entries(op.fieldMetadata)) {
-				const desc = sanitizeTableCell(meta.description ?? "");
-				const constraint = sanitizeTableCell(formatConstraints(meta.constraints));
-				const reqFor = formatRequiredFor(meta.required_for);
-				const def = sanitizeTableCell(formatDefault(meta.default, meta.serverDefault));
-				sections.push(`| ${field} | ${meta.type} | ${desc} | ${constraint} | ${reqFor} | ${def} |`);
+		// Field Constraints (Tier 2) — skipped in compact mode, deduped when identical across operations
+		if (op.fieldMetadata && Object.keys(op.fieldMetadata).length > 0 && !options?.compact) {
+			const currentFingerprint = JSON.stringify(op.fieldMetadata);
+			if (fieldConstraintsRenderedForOp && currentFingerprint === fieldConstraintsFingerprint) {
+				sections.push("", "### Field Constraints");
+				sections.push(`Same as ${fieldConstraintsRenderedForOp} — see above.`, "");
+			} else {
+				fieldConstraintsRenderedForOp = `${op.method.toUpperCase()} ${op.path}`;
+				fieldConstraintsFingerprint = currentFingerprint;
+				sections.push("", "### Field Constraints", "");
+				sections.push("| Field | Type | Description | Constraint | Required For | Default |");
+				sections.push("|-------|------|-------------|-----------|--------------|---------|");
+				for (const [field, meta] of Object.entries(op.fieldMetadata)) {
+					const desc = sanitizeTableCell(meta.description ?? "");
+					const constraint = sanitizeTableCell(formatConstraints(meta.constraints));
+					const reqFor = formatRequiredFor(meta.required_for);
+					const def = sanitizeTableCell(formatDefault(meta.default, meta.serverDefault));
+					sections.push(`| ${field} | ${meta.type} | ${desc} | ${constraint} | ${reqFor} | ${def} |`);
+				}
 			}
 		}
 

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "18.33.2",
-	"commit": "200cfabfba89adc2b4f81d5bb06d1de4450454fa",
-	"shortCommit": "200cfab",
+	"version": "18.33.3",
+	"commit": "ea081417a014b40c53422b3a51e062a13f035c5e",
+	"shortCommit": "ea08141",
 	"branch": "main",
-	"tag": "v18.33.2",
-	"commitDate": "2026-05-02T23:44:24Z",
-	"buildDate": "2026-05-03T00:06:13.623Z",
+	"tag": "v18.33.3",
+	"commitDate": "2026-05-03T05:25:43Z",
+	"buildDate": "2026-05-03T05:47:37.045Z",
 	"dirty": false,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/200cfabfba89adc2b4f81d5bb06d1de4450454fa",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.33.2"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/ea081417a014b40c53422b3a51e062a13f035c5e",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v18.33.3"
 };

package/src/prompts/system/system-prompt.md

@@ -197,22 +197,26 @@ Most tools resolve custom protocol URLs to internal resources (not web URLs):
   When the user needs to **make an API call** (create, read, update, delete):
 
   1. `xcsh://api-catalog/?search={term}` → find the operation
-  2. `xcsh://api-catalog/{category}` → get curl template, minimum payload,
-     field constraints, OneOf recommendations, and response summary
+  2. `xcsh://api-catalog/{category}?compact=true` → get curl template, minimum payload,
+     OneOf recommendations, and response summary
 
   For POST/PUT operations, the catalog includes a ready-to-use JSON payload.
   Customize the payload with user-specified values (name, namespace, etc.),
   substitute path parameters (`{namespace}`, `{name}`) with actual values,
   insert the payload as the `-d` body in the curl template, and execute.
 
+  When the user needs **field-level validation rules** (constraints, patterns, enums):
+
+  1. `xcsh://api-catalog/{category}` → full catalog with field constraints table
+
   When the user needs to **understand a schema** (field types, nested objects, request body structure):
 
   1. `xcsh://api-spec/{domain}?resource={name}` → full OpenAPI specification
   If the domain is unknown, read `xcsh://api-spec/` first to identify it.
 
   **MUST NOT** read proactively.
-  Never start at `xcsh://api-spec/` for CRUD operations — it returns the full schema (~40K tokens)
-  when the catalog provides the same endpoint with curl template (~700 tokens).
+  Never start at `xcsh://api-spec/` for CRUD operations — the catalog provides
+  the same endpoint with curl template at a fraction of the token cost.
   Never guess API paths or request schemas.
   Also available: `xcsh://api-spec/workflows/` (step-by-step guides),
   `xcsh://api-spec/errors/{code}` (error resolution), `xcsh://api-spec/glossary/` (acronym reference).