@f5-sales-demo/xcsh 19.51.6 → 19.52.0

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "19.51.6",
+	"version": "19.52.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://github.com/f5-sales-demo/xcsh",
 	"author": "Can Boluk",
@@ -31,11 +31,11 @@
 		"xcsh": "src/cli.ts"
 	},
 	"scripts": {
-		"build": "bun run generate-build-info && bun run generate-api-spec-index && bun run generate-branding-index && bun run generate-terraform-index && bun run generate-console-catalog && bun run generate-console-field-metadata && test -f src/internal-urls/api-spec-index.generated.ts && bun --cwd=../stats scripts/generate-client-bundle.ts --generate && bun --cwd=../natives run embed:native && bun build --compile --define PI_COMPILED=true --external mupdf --root ../.. ./src/cli.ts --outfile dist/xcsh && bun --cwd=../natives run embed:native --reset && bun --cwd=../stats scripts/generate-client-bundle.ts --reset",
+		"build": "bun run generate-build-info && bun run generate-extension-capabilities && bun run generate-api-spec-index && bun run generate-branding-index && bun run generate-terraform-index && bun run generate-console-catalog && bun run generate-console-field-metadata && test -f src/internal-urls/api-spec-index.generated.ts && bun --cwd=../stats scripts/generate-client-bundle.ts --generate && bun --cwd=../natives run embed:native && bun build --compile --define PI_COMPILED=true --external mupdf --root ../.. ./src/cli.ts --outfile dist/xcsh && bun --cwd=../natives run embed:native --reset && bun --cwd=../stats scripts/generate-client-bundle.ts --reset",
 		"check": "biome check . && bun run format-prompts -- --check && bun run check:types",
-		"check:types": "bun run generate-build-info && bun run generate-api-spec-index && bun run generate-branding-index && bun run generate-terraform-index && tsgo -p tsconfig.json --noEmit",
+		"check:types": "bun run generate-build-info && bun run generate-extension-capabilities && bun run generate-api-spec-index && bun run generate-branding-index && bun run generate-terraform-index && tsgo -p tsconfig.json --noEmit",
 		"lint": "biome lint .",
-		"test": "bun run generate-build-info && bun run generate-api-spec-index && bun run generate-console-catalog && bun run generate-console-field-metadata && bun test --max-concurrency 4",
+		"test": "bun run generate-build-info && bun run generate-extension-capabilities && bun run generate-api-spec-index && bun run generate-console-catalog && bun run generate-console-field-metadata && bun test --max-concurrency 4",
 		"fix": "biome check --write --unsafe . && bun run format-prompts && bun run generate-docs-index && bun run generate-api-spec-index && bun run generate-build-info",
 		"fmt": "biome format --write . && bun run format-prompts",
 		"format-prompts": "bun scripts/format-prompts.ts",
@@ -44,6 +44,7 @@
 		"generate-api-spec-index": "bun scripts/generate-api-spec-index.ts",
 		"generate-branding-index": "bun scripts/generate-branding-index.ts",
 		"generate-build-info": "bun scripts/generate-build-info.ts",
+		"generate-extension-capabilities": "bun scripts/generate-extension-capabilities.ts",
 		"generate-terraform-index": "bun scripts/generate-terraform-index.ts",
 		"generate-console-catalog": "bun scripts/generate-console-catalog.ts",
 		"generate-console-field-metadata": "bun scripts/generate-console-field-metadata.ts",
@@ -54,13 +55,13 @@
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.16.1",
 		"@mozilla/readability": "^0.6",
-		"@f5-sales-demo/xcsh-stats": "19.51.4",
-		"@f5-sales-demo/pi-agent-core": "19.51.4",
-		"@f5-sales-demo/pi-ai": "19.51.4",
-		"@f5-sales-demo/pi-natives": "19.51.4",
-		"@f5-sales-demo/pi-resource-management": "19.51.4",
-		"@f5-sales-demo/pi-tui": "19.51.4",
-		"@f5-sales-demo/pi-utils": "19.51.6",
+		"@f5-sales-demo/xcsh-stats": "19.52.0",
+		"@f5-sales-demo/pi-agent-core": "19.52.0",
+		"@f5-sales-demo/pi-ai": "19.52.0",
+		"@f5-sales-demo/pi-natives": "19.52.0",
+		"@f5-sales-demo/pi-resource-management": "19.52.0",
+		"@f5-sales-demo/pi-tui": "19.52.0",
+		"@f5-sales-demo/pi-utils": "19.52.0",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",

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

@@ -150,7 +150,7 @@ async function downloadFromRelease(): Promise<string> {
 	const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "api-specs-"));
 	downloadedTmpDir = tmpDir;
 	const tag = process.env.API_SPECS_TAG ?? (await resolveLatestTag());
-	const zipName = `xcsh-api-specs-${tag}.zip`;
+	const zipName = `f5xc-api-specs-${tag}.zip`;
 	const downloadUrl = `https://github.com/${REPO}/releases/download/${tag}/${zipName}`;
 
 	console.log(`Downloading API specs from ${downloadUrl}...`);

package/scripts/generate-extension-capabilities.ts

@@ -0,0 +1,73 @@
+#!/usr/bin/env bun
+
+/**
+ * Generate the typed, baked-in copy of the Chrome extension's capability contract.
+ *
+ * Source of truth is the extension's `capabilities.json`. When the sibling
+ * `xcsh-chrome-extension` repo is checked out (the ecosystem is built together),
+ * its freshly-built `capabilities.json` is copied into the vendored location so the
+ * two binaries ship the same contract; otherwise the committed vendored copy is
+ * used (CI / standalone). The result is emitted as `capabilities.generated.ts` and
+ * compiled into the xcsh binary.
+ *
+ *   bun scripts/generate-extension-capabilities.ts
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+const here = import.meta.dir; // packages/coding-agent/scripts
+const vendoredPath = path.resolve(here, "../src/browser/capabilities.json");
+const generatedPath = path.resolve(here, "../src/browser/capabilities.generated.ts");
+
+// Co-build refresh: prefer the sibling extension's freshly-built contract.
+const siblingPath =
+	process.env.XCSH_EXTENSION_CAPABILITIES ?? path.resolve(here, "../../../../xcsh-chrome-extension/capabilities.json");
+if (fs.existsSync(siblingPath) && path.resolve(siblingPath) !== vendoredPath) {
+	fs.copyFileSync(siblingPath, vendoredPath);
+}
+
+const manifest = JSON.parse(fs.readFileSync(vendoredPath, "utf8")) as {
+	contractVersion: string;
+	tools: Array<{ name: string }>;
+};
+const toolNames = manifest.tools.map(t => t.name);
+
+const output = [
+	"// Auto-generated by scripts/generate-extension-capabilities.ts - DO NOT EDIT",
+	"// Source: src/browser/capabilities.json (the Chrome extension's published contract).",
+	"",
+	"export interface ExtensionToolFlags {",
+	"\treadonly readOnly?: boolean;",
+	"\treadonly mutates?: boolean;",
+	"\treadonly requiresExplainMode?: boolean;",
+	"}",
+	"",
+	"export interface ExtensionToolDef {",
+	"\treadonly name: string;",
+	"\treadonly summary: string;",
+	"\treadonly category: string;",
+	"\treadonly params: Record<string, unknown>;",
+	"\treadonly flags?: ExtensionToolFlags;",
+	"}",
+	"",
+	"export interface ExtensionCapabilities {",
+	"\treadonly version: string;",
+	"\treadonly contractVersion: string;",
+	"\treadonly protocol: string;",
+	"\treadonly tools: readonly ExtensionToolDef[];",
+	"\treadonly features: Record<string, unknown>;",
+	"}",
+	"",
+	`export const EXTENSION_CAPABILITIES: ExtensionCapabilities = ${JSON.stringify(manifest, null, "\t")};`,
+	"",
+	`export const EXTENSION_CONTRACT_VERSION = ${JSON.stringify(manifest.contractVersion)};`,
+	"",
+	`export const EXTENSION_TOOL_NAMES: readonly string[] = ${JSON.stringify(toolNames)};`,
+	"",
+].join("\n");
+
+await Bun.write(generatedPath, output);
+console.log(
+	`Generated ${path.relative(process.cwd(), generatedPath)} (${toolNames.length} tools, contract ${manifest.contractVersion})`,
+);