@f5xc-salesdemos/xcsh 19.20.1 → 19.21.0

package/package.json

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

package/src/extensibility/plugins/marketplace/prerequisites.ts

@@ -204,7 +204,7 @@ export async function setupTool(prereq: Prerequisite): Promise<SetupResult> {
 			tool: prereq.tool,
 			wasInstalled: !installAttempted,
 			installAttempted,
-			installSuccess: installAttempted ? true : false,
+			installSuccess: !!installAttempted,
 			authenticated: true,
 		};
 	}
@@ -214,7 +214,7 @@ export async function setupTool(prereq: Prerequisite): Promise<SetupResult> {
 		tool: prereq.tool,
 		wasInstalled: !installAttempted,
 		installAttempted,
-		installSuccess: installAttempted ? true : false,
+		installSuccess: installSuccess,
 		authenticated: auth.authenticated,
 		user: auth.user,
 		authLoginCmd: auth.authenticated ? undefined : prereq.authLoginCmd,

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.20.1",
-	"commit": "0ecbb73107f9ece06f7f82f243ff413ff30d6f06",
-	"shortCommit": "0ecbb73",
+	"version": "19.21.0",
+	"commit": "b79f79549c5d8c7645ad7484d9231fd39de83c2e",
+	"shortCommit": "b79f795",
 	"branch": "main",
-	"tag": "v19.20.1",
-	"commitDate": "2026-06-09T12:19:32Z",
-	"buildDate": "2026-06-09T12:49:05.875Z",
+	"tag": "v19.21.0",
+	"commitDate": "2026-06-09T14:18:30-04:00",
+	"buildDate": "2026-06-09T18:46:50.615Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5xc-salesdemos/xcsh",
 	"repoSlug": "f5xc-salesdemos/xcsh",
-	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/0ecbb73107f9ece06f7f82f243ff413ff30d6f06",
-	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.20.1"
+	"commitUrl": "https://github.com/f5xc-salesdemos/xcsh/commit/b79f79549c5d8c7645ad7484d9231fd39de83c2e",
+	"releaseUrl": "https://github.com/f5xc-salesdemos/xcsh/releases/tag/v19.21.0"
 };

package/src/modes/interactive-mode.ts

@@ -196,6 +196,7 @@ export class InteractiveMode implements InteractiveModeContext {
 	#eventBus?: EventBus;
 	#eventBusUnsubscribers: Array<() => void> = [];
 	#welcomeComponent?: WelcomeComponent;
+	#currentPlugins: import("./components/welcome-checks").UnifiedPluginStatus[] = [];
 
 	constructor(
 		session: AgentSession,
@@ -343,6 +344,7 @@ export class InteractiveMode implements InteractiveModeContext {
 		// Build unified plugin list from service status contributions + marketplace
 		const pluginContributions = this.session.extensionRunner?.getAllRegisteredServiceStatuses() ?? [];
 		const plugins = !startupQuiet ? await buildUnifiedPluginList(pluginContributions).catch(() => []) : [];
+		this.#currentPlugins = plugins;
 
 		const fixableServices: FixableService[] = [];
 		for (const contribution of pluginContributions) {
@@ -953,8 +955,17 @@ export class InteractiveMode implements InteractiveModeContext {
 			if (idx !== -1) {
 				currentServices[idx] = updated;
 				this.#welcomeComponent?.setServices([...currentServices]);
-				this.ui.requestRender();
 			}
+			const pluginIdx = this.#currentPlugins.findIndex(p => p.name.toLowerCase() === service.name.toLowerCase());
+			if (pluginIdx !== -1) {
+				this.#currentPlugins[pluginIdx] = {
+					...this.#currentPlugins[pluginIdx],
+					state: updated.state,
+					hint: updated.hint,
+				};
+				this.#welcomeComponent?.setPlugins([...this.#currentPlugins]);
+			}
+			this.ui.requestRender();
 		}
 	}
 

package/src/prompts/tools/xcsh-api.md

@@ -43,6 +43,82 @@ API calls to the same F5 XC tenant reuse a single TLS connection — sequential
 
 For HTTPS: replace `"http": {"port": 80}` with `"https_auto_cert": {"http_redirect": true, "default_header": {}, "tls_config": {"default_security": {}}, "no_mtls": {}}`. For no pool (advertise only): omit `default_route_pools`.
 
+**HTTP LB advertising (`advertise_where`)** — Four mutually exclusive top-level choices:
+- `"advertise_on_public_default_vip": {}` — default public VIP on Regional Edges
+- `"advertise_on_public": {}` — public VIP (optionally specify `public_ip` ref); use when asked for "public VIP" WITHOUT "default"
+- `"do_not_advertise": {}` — disabled
+- `"advertise_custom": {"advertise_where": […]}` — custom CE/virtual site targeting (see below)
+
+**CRITICAL**: "public VIP" = `advertise_on_public`, "public default VIP" = `advertise_on_public_default_vip`. Do NOT conflate these.
+
+To advertise on **Customer Edge (CE) sites or virtual sites**, use `"advertise_custom"` with an `advertise_where` array. Each entry requires ONE site-targeting choice AND ONE port choice:
+
+|Site-targeting field|Required sub-fields|Notes|
+|---|---|---|
+|`virtual_site`|`virtual_site: {name, namespace}`, `network`|Ref NOT validated — use for CE virtual sites|
+|`site`|`site: {name, namespace}`, `network`|Ref IS validated (400 if site doesn't exist)|
+|`virtual_site_with_vip`|`virtual_site: {name, namespace}`, `ip` (required), `network`|Custom VIP address|
+|`vk8s_service`|oneOf: `site: {name, namespace}` OR `virtual_site: {name, namespace}`|vK8s service network|
+|`advertise_on_public`|`public_ip?: {name, namespace}`|RE public VIP|
+
+`network` values — map natural language precisely (6 valid for HTTP LB advertising):
+- "inside and outside" → `SITE_NETWORK_INSIDE_AND_OUTSIDE`
+- "inside only" or "inside network" (without "and outside") → `SITE_NETWORK_INSIDE`
+- "outside only" or "outside network" (without "and inside") → `SITE_NETWORK_OUTSIDE`
+- "outside with internet VIP" → `SITE_NETWORK_OUTSIDE_WITH_INTERNET_VIP`
+- "inside and outside with internet VIP" → `SITE_NETWORK_INSIDE_AND_OUTSIDE_WITH_INTERNET_VIP`
+- "service network" → `SITE_NETWORK_SERVICE`
+- **NOT valid for LB advertising**: `SITE_NETWORK_IP_FABRIC` (API rejects with 400)
+
+**CRITICAL**: "inside and outside" = `SITE_NETWORK_INSIDE_AND_OUTSIDE` (not `SITE_NETWORK_INSIDE`). Always check whether the phrase says both "inside AND outside" or just one.
+
+Port choices (orthogonal): `"use_default_port": {}` (default) | `"port": <int>` | `"port_ranges": "80,443,8080-8191"`
+
+**CRITICAL — "virtual site with VIP" or "using VIP address X"** → must use `virtual_site_with_vip` (NOT `virtual_site`). This requires `ip` field. Example: `{"virtual_site_with_vip": {"virtual_site": {"name": "<n>", "namespace": "<ns>"}, "ip": "10.0.0.100", "network": "SITE_NETWORK_SPECIFIED_VIP_OUTSIDE"}, "use_default_port": {}}`. Network options: `SITE_NETWORK_SPECIFIED_VIP_OUTSIDE` or `SITE_NETWORK_SPECIFIED_VIP_INSIDE`.
+
+**CRITICAL — port field**: The `advertise_where` port is a SEPARATE concept from the LB protocol port (`http.port` or `https_auto_cert.port`). When the phrase says "advertise on port X" or "on port X" or "using port X" in the context of custom advertising, set `"port": X` inside the `advertise_where` entry. Do NOT use `use_default_port`. Do NOT change the LB type to HTTPS because the advertise port is 8443.
+
+Example — port 8443 in advertise_where: `{"virtual_site": {…, "network": "SITE_NETWORK_INSIDE_AND_OUTSIDE"}, "port": 8443}`
+
+**CRITICAL — all 7 SiteNetwork values work with BOTH `virtual_site` AND `site`**. "IP fabric network" = `SITE_NETWORK_IP_FABRIC` — valid for `virtual_site` too. Do NOT ask for alternatives; immediately use the matching enum.
+
+Example — advertise on a Customer Edge virtual site, inside and outside:
+```json
+{
+  "metadata": {"name": "<lb-name>", "namespace": "<ns>"},
+  "spec": {
+    "domains": ["<domain>"],
+    "advertise_custom": {
+      "advertise_where": [
+        {
+          "virtual_site": {
+            "virtual_site": {"name": "<vsite-name>", "namespace": "<ns>"},
+            "network": "SITE_NETWORK_INSIDE_AND_OUTSIDE"
+          },
+          "use_default_port": {}
+        }
+      ]
+    },
+    "http": {"port": 80},
+    "default_route_pools": [
+      {"pool": {"namespace": "<ns>", "name": "<pool-name>"}, "weight": 1, "priority": 1}
+    ]
+  }
+}
+```
+
+**Virtual site resource** — When asked to create a virtual site targeting CE sites, POST to `/api/config/namespaces/{namespace}/virtual_sites`:
+```json
+{
+  "metadata": {"name": "<vsite-name>", "namespace": "<ns>"},
+  "spec": {
+    "site_type": "CUSTOMER_EDGE",
+    "site_selector": {"expressions": ["ves.io/siteName in (<ce-site-name>)"]}
+  }
+}
+```
+`site_type`: `CUSTOMER_EDGE` for CE/SMSv2 sites · `REGIONAL_EDGE` for PoPs · `NGINX_ONE` for NGINX One nodes. The `ves.io/siteName` label is automatically applied to all sites — use it in expressions to target specific CE sites by name.
+
 **Resource disambiguation**: Several F5 XC resource types have similar names but different API paths. When the user's intent maps to one of these, use the exact API path shown:
 
 |User says|Catalog category|API path segment|NOT|