@f5xc-salesdemos/xcsh 19.10.0 → 19.11.0

package/package.json

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

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.10.0",
-	"commit": "d46f8e9c1e3828c21cfa36c04509b3ec562d3d07",
-	"shortCommit": "d46f8e9",
+	"version": "19.11.0",
+	"commit": "f1aa8804fd9d391462a8c13d4ff0de70b01e20b8",
+	"shortCommit": "f1aa880",
 	"branch": "main",
-	"tag": "v19.10.0",
-	"commitDate": "2026-06-05T04:49:35Z",
-	"buildDate": "2026-06-05T05:11:51.351Z",
+	"tag": "v19.11.0",
+	"commitDate": "2026-06-05T12:59:46Z",
+	"buildDate": "2026-06-05T13:30:16.635Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/d46f8e9c1e3828c21cfa36c04509b3ec562d3d07",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.10.0"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/f1aa8804fd9d391462a8c13d4ff0de70b01e20b8",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.11.0"
 };

package/src/modes/components/plugins/state-manager.ts

@@ -3,12 +3,9 @@ import type { MarketplaceManager } from "../../../extensibility/plugins/marketpl
 import type { InstalledPluginSummary, MarketplacePluginEntry } from "../../../extensibility/plugins/marketplace/types";
 import type { DashboardPlugin, PluginDashboardState, PluginTab, PluginTabId } from "./types";
 
-export function normalizePluginDisplayName(name: string): string {
-	let result = name;
-	if (result.startsWith("f5xc-")) result = result.slice(5);
-	if (result.length > 0 && result.endsWith("-status")) result = result.slice(0, -7);
-	return result || name;
-}
+export { normalizePluginDisplayName } from "./utils";
+
+import { normalizePluginDisplayName } from "./utils";
 
 function npmToDashboard(npm: { name: string; version: string; enabled: boolean }): DashboardPlugin {
 	return {

package/src/modes/components/plugins/utils.ts

@@ -0,0 +1,6 @@
+export function normalizePluginDisplayName(name: string): string {
+	let result = name;
+	if (result.startsWith("f5xc-")) result = result.slice(5);
+	if (result.length > 0 && result.endsWith("-status")) result = result.slice(0, -7);
+	return result || name;
+}

package/src/modes/components/welcome-checks.ts

@@ -1,9 +1,17 @@
 import type { Model } from "@f5xc-salesdemos/pi-ai";
 import { validateApiKeyAgainstModelsEndpoint } from "@f5xc-salesdemos/pi-ai/utils/oauth/api-key-validation";
 import { logger } from "@f5xc-salesdemos/pi-utils";
+import { MarketplaceManager } from "../../extensibility/plugins/marketplace";
+import {
+	getInstalledPluginsRegistryPath,
+	getMarketplacesCacheDir,
+	getMarketplacesRegistryPath,
+	getPluginsCacheDir,
+} from "../../extensibility/plugins/marketplace/registry";
 import { type AuthStatus, ContextService } from "../../services/f5xc-context";
 import { deriveTenantFromUrl } from "../../services/f5xc-env";
 import type { AuthStorage } from "../../session/auth-storage";
+import { normalizePluginDisplayName } from "./plugins/utils";
 
 // Startup validation budget. These are longer than validateToken's 3000ms default because
 // the welcome path runs during TLS/DNS cold-start — a single 3s shot races against warm-up
@@ -214,3 +222,45 @@ export interface FixableService {
 	command: string[];
 	recheck: () => Promise<ServiceStatus>;
 }
+
+export interface RecommendedPluginStatus {
+	name: string;
+	installed: boolean;
+}
+
+export async function checkRecommendedPlugins(): Promise<RecommendedPluginStatus[]> {
+	try {
+		const mgr = new MarketplaceManager({
+			marketplacesRegistryPath: getMarketplacesRegistryPath(),
+			installedRegistryPath: getInstalledPluginsRegistryPath(),
+			marketplacesCacheDir: getMarketplacesCacheDir(),
+			pluginsCacheDir: getPluginsCacheDir(),
+			clearPluginRootsCache: () => {},
+		});
+
+		const [marketplaces, installedSummaries] = await Promise.all([
+			mgr.listMarketplaces(),
+			mgr.listInstalledPlugins(),
+		]);
+
+		const installedIds = new Set(installedSummaries.map(s => s.id));
+		const results: RecommendedPluginStatus[] = [];
+
+		for (const mkt of marketplaces) {
+			const available = await mgr.listAvailablePlugins(mkt.name).catch(() => []);
+			for (const entry of available) {
+				if (!entry.recommended) continue;
+				const pluginId = `${entry.name}@${mkt.name}`;
+				results.push({
+					name: normalizePluginDisplayName(entry.name),
+					installed: installedIds.has(pluginId),
+				});
+			}
+		}
+
+		return results.sort((a, b) => a.name.localeCompare(b.name));
+	} catch (err) {
+		logger.debug("checkRecommendedPlugins failed", { error: String(err) });
+		return [];
+	}
+}

package/src/modes/components/welcome.ts

@@ -2,7 +2,7 @@ import { type Component, padding, truncateToWidth, visibleWidth } from "@f5xc-sa
 import { APP_NAME } from "@f5xc-salesdemos/pi-utils";
 import { theme } from "../../modes/theme/theme";
 import { formatStatusIcon } from "../../services/f5xc-context-indicators";
-import type { ModelStatus, ServiceStatus } from "./welcome-checks";
+import type { ModelStatus, RecommendedPluginStatus, ServiceStatus } from "./welcome-checks";
 
 export interface UpdateStatus {
 	available: boolean;
@@ -15,6 +15,7 @@ export class WelcomeComponent implements Component {
 		private modelStatus: ModelStatus,
 		private services: ServiceStatus[] = [],
 		private updateStatus?: UpdateStatus,
+		private recommendedPlugins: RecommendedPluginStatus[] = [],
 	) {}
 	invalidate(): void {}
 	setModelStatus(status: ModelStatus): void {
@@ -26,6 +27,9 @@ export class WelcomeComponent implements Component {
 	setUpdateStatus(status: UpdateStatus | undefined): void {
 		this.updateStatus = status;
 	}
+	setRecommendedPlugins(plugins: RecommendedPluginStatus[]): void {
+		this.recommendedPlugins = plugins;
+	}
 
 	render(termWidth: number): string[] {
 		const minLeftCol = 48;
@@ -136,6 +140,12 @@ export class WelcomeComponent implements Component {
 				lines.push(this.#renderServiceLine(svc));
 			}
 		}
+		if (this.recommendedPlugins.length > 0) {
+			lines.push(" Recommended Plugins");
+			for (const p of this.recommendedPlugins) {
+				lines.push(this.#renderRecommendedLine(p));
+			}
+		}
 		if (this.#showUpdateSection()) {
 			lines.push(this.#renderUpdateLine());
 		}
@@ -163,7 +173,11 @@ export class WelcomeComponent implements Component {
 		lines.push("");
 		const coreServices = this.services.filter(s => !s._isPlugin);
 		const pluginServices = this.services.filter(s => s._isPlugin);
-		const hasContent = coreServices.length > 0 || pluginServices.length > 0 || this.#showUpdateSection();
+		const hasContent =
+			coreServices.length > 0 ||
+			pluginServices.length > 0 ||
+			this.recommendedPlugins.length > 0 ||
+			this.#showUpdateSection();
 		if (hasContent) {
 			lines.push(separator);
 			for (const svc of coreServices) {
@@ -179,6 +193,18 @@ export class WelcomeComponent implements Component {
 					}
 				}
 			}
+			if (this.recommendedPlugins.length > 0) {
+				lines.push("");
+				lines.push(` ${theme.fg("dim", "Recommended Plugins")}`);
+				for (const p of this.recommendedPlugins) {
+					lines.push(this.#renderRecommendedLine(p));
+				}
+				const missing = this.recommendedPlugins.filter(p => !p.installed);
+				if (missing.length > 0) {
+					lines.push(`   ${theme.fg("dim", "run: /plugin setup")}`);
+				}
+			}
+
 			if (this.#showUpdateSection()) {
 				lines.push(this.#renderUpdateLine());
 			}
@@ -187,6 +213,13 @@ export class WelcomeComponent implements Component {
 		return lines;
 	}
 
+	#renderRecommendedLine(plugin: RecommendedPluginStatus): string {
+		if (plugin.installed) {
+			return ` ${formatStatusIcon("connected")} ${theme.fg("muted", plugin.name)}`;
+		}
+		return ` ${theme.fg("dim", "·")} ${theme.fg("dim", plugin.name)}`;
+	}
+
 	#showUpdateSection(): boolean {
 		return this.updateStatus?.available === true;
 	}

package/src/modes/interactive-mode.ts

@@ -53,6 +53,7 @@ import { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
 import { type UpdateStatus, WelcomeComponent } from "./components/welcome";
 import {
+	checkRecommendedPlugins,
 	type FixableService,
 	mapContextStatus,
 	runWelcomeChecks,
@@ -386,12 +387,15 @@ export class InteractiveMode implements InteractiveModeContext {
 			}
 		}
 
+		const recommendedPlugins = !startupQuiet ? await checkRecommendedPlugins().catch(() => []) : [];
+
 		if (!startupQuiet) {
 			this.#welcomeComponent = new WelcomeComponent(
 				this.#version,
 				welcomeResult.model,
 				services,
 				this.#initialUpdateStatus,
+				recommendedPlugins,
 			);
 
 			// Setup UI layout