@f5-sales-demo/xcsh 21.41.5 → 21.43.0

package/CHANGELOG.md

@@ -6,6 +6,10 @@
 
 ### Added
 
+- Added current ChatGPT subscription roles for GPT-6 Luna/Sol, Claude Opus 5.5 selection, and an
+  opt-in Providers setting for the GPT-6 1.05M-token context window. The default remains 272K to
+  make long-context pricing explicit; LiteLLM retains its existing catalog
+  ([#4240](https://github.com/f5-sales-demo/xcsh/issues/4240)).
 - Added owner-scoped, capability-filtered plugin advisories that render machine-readable provenance,
   fail open on matcher errors, and refresh with plugin lifecycle changes
   ([#4175](https://github.com/f5-sales-demo/xcsh/issues/4175)).
@@ -53,6 +57,13 @@
 
 ### Fixed
 
+- Added the exact `/plugin setup <plugin>` next action after interactive installation of plugins
+  that require separately authorized setup ([#4253](https://github.com/f5-sales-demo/xcsh/issues/4253)).
+- Made marketplace plugin uninstall dry-runs return a deterministic preview without changing the
+  installed registry or cache ([#4251](https://github.com/f5-sales-demo/xcsh/issues/4251)).
+- Routed Platform plugin setup through the native interactive context wizard, rejected empty or
+  mixed setup plans, and made generated API catalogs enforce the `XCSH_*`-only environment contract
+  ([#4234](https://github.com/f5-sales-demo/xcsh/issues/4234)).
 - Added Herdr protocol 26 native-interaction compatibility and bounded idempotent retry for
   ambiguously acknowledged semantic reports without exposing interaction content
   ([#4161](https://github.com/f5-sales-demo/xcsh/issues/4161)).

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "21.41.5",
+	"version": "21.43.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",
@@ -64,13 +64,13 @@
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "1.4.0",
-		"@f5-sales-demo/pi-agent-core": "21.41.5",
-		"@f5-sales-demo/pi-ai": "21.41.5",
-		"@f5-sales-demo/pi-natives": "21.41.5",
-		"@f5-sales-demo/pi-resource-management": "21.41.5",
-		"@f5-sales-demo/pi-tui": "21.41.5",
-		"@f5-sales-demo/pi-utils": "21.41.5",
-		"@f5-sales-demo/xcsh-stats": "21.41.5",
+		"@f5-sales-demo/pi-agent-core": "21.43.0",
+		"@f5-sales-demo/pi-ai": "21.43.0",
+		"@f5-sales-demo/pi-natives": "21.43.0",
+		"@f5-sales-demo/pi-resource-management": "21.43.0",
+		"@f5-sales-demo/pi-tui": "21.43.0",
+		"@f5-sales-demo/pi-utils": "21.43.0",
+		"@f5-sales-demo/xcsh-stats": "21.43.0",
 		"@mozilla/readability": "^0.6",
 		"@sinclair/typebox": "0.34.52",
 		"@tobilu/qmd": "2.8.3",

package/src/cli/plugin-cli.ts

@@ -20,7 +20,12 @@ import {
 	MarketplaceManager,
 	resolvePluginDependencyPlan,
 } from "../extensibility/plugins/marketplace/index.js";
-import { describeSetupPlan, executeInstallAuthorizedSetup, executeReviewedSetup } from "../integrations/setup";
+import {
+	describeIntegrationSetupNextAction,
+	describeSetupPlan,
+	executeInstallAuthorizedSetup,
+	executeReviewedSetup,
+} from "../integrations/setup";
 import type { IntegrationHandle } from "../integrations/types";
 import { theme } from "../modes/theme/theme";
 import { personProfileService } from "../person-profile/service";
@@ -221,6 +226,8 @@ function matchesIntegration(handle: IntegrationHandle<unknown>, target: string):
 	return handle.id === target || handle.plugin === target || handle.plugin?.split("@")[0] === target;
 }
 
+export { describeIntegrationSetupNextAction } from "../integrations/setup";
+
 export function selectSetupIntegration(
 	handles: readonly IntegrationHandle<unknown>[],
 	target: string,
@@ -244,8 +251,7 @@ async function handleIntegrationStatus(args: string[], flags: { json?: boolean }
 			const { value: _, ...status } = await handle.get();
 			return {
 				...status,
-				nextAction:
-					status.state === "setup_required" ? `${APP_NAME} plugin setup ${handle.plugin ?? handle.id}` : undefined,
+				nextAction: status.state === "setup_required" ? describeIntegrationSetupNextAction(handle) : undefined,
 			};
 		}),
 	);
@@ -270,6 +276,10 @@ export async function reviewAndExecuteIntegrationSetup(handle: IntegrationHandle
 	if (!plan) throw new Error(`Integration ${handle.id} does not declare setup`);
 	const current = await handle.get();
 	if (current.state === "ready") return current;
+	if (plan.guidedAction?.kind === "context_wizard")
+		throw new Error(
+			`Plugin ${handle.plugin ?? handle.id} setup requires interactive xcsh; run /plugin setup ${handle.plugin ?? handle.id} in the xcsh TUI.`,
+		);
 	process.stdout.write(`${describeSetupPlan(handle)}\n`);
 	const prompt = createInterface({ input: process.stdin, output: process.stdout });
 	try {
@@ -335,7 +345,11 @@ async function reportMarketplaceInstallation(
 	const setupHandle = setupHandles.length === 1 ? setupHandles[0] : undefined;
 	const setupStatus = setupHandle ? statuses.find(status => status.id === setupHandle.id) : undefined;
 	const nextAction =
-		entry.setupRequired && setupStatus?.state !== "ready" ? `${APP_NAME} plugin setup ${plugin}` : undefined;
+		entry.setupRequired && setupStatus?.state !== "ready"
+			? setupHandle
+				? describeIntegrationSetupNextAction(setupHandle)
+				: `${APP_NAME} plugin setup ${plugin}`
+			: undefined;
 	if (flags.json || !process.stdin.isTTY || !process.stdout.isTTY) {
 		const result = {
 			installation: { state: "installed", plugin, marketplace, version: entry.version, scope: entry.scope },
@@ -759,7 +773,7 @@ async function handleInstall(
 async function handleUninstall(
 	manager: PluginManager,
 	packages: string[],
-	flags: { json?: boolean; scope?: "user" | "project" },
+	flags: { json?: boolean; dryRun?: boolean; scope?: "user" | "project" },
 ): Promise<void> {
 	if (packages.length === 0) {
 		console.error(chalk.red(`Usage: ${APP_NAME} plugin uninstall <package> ...`));
@@ -777,8 +791,30 @@ async function handleUninstall(
 		if (installedPlugins.has(name) || target.type === "marketplace") {
 			// Exact match against installed marketplace plugin IDs (name@marketplace)
 			try {
+				if (flags.dryRun) {
+					const preview = await mktMgr.previewUninstallPlugin(name, flags.scope);
+					if (flags.json) {
+						console.log(
+							JSON.stringify(
+								{
+									action: "uninstall",
+									target: preview.pluginId,
+									scope: preview.scope,
+									dryRun: true,
+									installPaths: preview.installPaths,
+								},
+								null,
+								2,
+							),
+						);
+					} else {
+						console.log(chalk.dim(`[dry-run] Would uninstall ${preview.pluginId} (${preview.scope})`));
+					}
+					continue;
+				}
 				await mktMgr.uninstallPlugin(name, flags.scope);
-				console.log(chalk.green(`${theme.status.success} Uninstalled ${name}`));
+				if (flags.json) console.log(JSON.stringify({ uninstalled: name }));
+				else console.log(chalk.green(`${theme.status.success} Uninstalled ${name}`));
 			} catch (err) {
 				console.error(chalk.red(`${theme.status.error} Failed to uninstall ${name}: ${err}`));
 				process.exit(1);
@@ -1292,8 +1328,8 @@ ${chalk.bold("Options:")}
   --json           Output as JSON
   --fix            Attempt automatic fixes (doctor)
   --force          Overwrite without prompting (install)
-  --scope <scope>  Install scope: user (default) or project (install name@marketplace)
-  --dry-run        Preview changes without applying (install)
+  --scope <scope>  Marketplace install/uninstall scope: user (default) or project
+  --dry-run        Preview supported install, uninstall, or upgrade changes
   -l, --local      Use project-local overrides
 
 ${chalk.bold("Examples:")}

package/src/config/keybindings.ts

@@ -45,7 +45,6 @@ interface AppKeybindings {
 	"app.session.deleteNoninvasive": true;
 	"app.tree.foldOrUp": true;
 	"app.tree.unfoldOrDown": true;
-	"app.plan.toggle": true;
 	"app.history.search": true;
 	"app.stt.toggle": true;
 }
@@ -78,7 +77,7 @@ export const KEYBINDINGS = {
 		description: "Suspend application",
 	},
 	"app.thinking.cycle": {
-		defaultKeys: "shift+tab",
+		defaultKeys: "alt+.",
 		description: "Cycle thinking level",
 	},
 	"app.thinking.toggle": {
@@ -177,10 +176,6 @@ export const KEYBINDINGS = {
 		defaultKeys: ["ctrl+right", "alt+right"],
 		description: "Unfold or move down",
 	},
-	"app.plan.toggle": {
-		defaultKeys: "alt+shift+p",
-		description: "Toggle plan mode",
-	},
 	"app.history.search": {
 		defaultKeys: "ctrl+r",
 		description: "Search history",
@@ -205,7 +200,6 @@ const KEYBINDING_NAME_MIGRATIONS = {
 	cycleModelBackward: "app.model.cycleBackward",
 	selectModel: "app.model.select",
 	selectModelTemporary: "app.model.selectTemporary",
-	togglePlanMode: "app.plan.toggle",
 	historySearch: "app.history.search",
 	expandTools: "app.tools.expand",
 	toggleThinking: "app.thinking.toggle",

package/src/config/model-catalog.ts

@@ -11,7 +11,7 @@ function compareVersions(left: string, right: string): number {
 }
 
 /** Keep historical catalogs available while presenting only current user-facing families. */
-const DEFAULT_OPENAI_CODEX_MODEL_IDS = new Set(["gpt-5.6-luna", "gpt-5.6-terra", "gpt-5.6-sol", "gpt-6-astra"]);
+const DEFAULT_OPENAI_CODEX_MODEL_IDS = new Set(["gpt-5.6-terra", "gpt-6-astra", "gpt-6-luna", "gpt-6-sol"]);
 
 /** Shared catalog boundary for the TUI and attached human interfaces. */
 export function filterCurrentBrowserModels(models: readonly Model[]): Model[] {

package/src/config/model-registry.ts

@@ -50,6 +50,10 @@ export type { CanonicalModelIndex, CanonicalModelRecord, CanonicalModelVariant,
 
 export const kNoAuth = NO_AUTH_API_KEY;
 
+const OPENAI_CODEX_STANDARD_CONTEXT_WINDOW = 272_000;
+const OPENAI_CODEX_MAX_CONTEXT_WINDOW = 1_050_000;
+const OPENAI_CODEX_MAX_CONTEXT_MODEL_IDS = new Set(["gpt-6-luna", "gpt-6-sol"]);
+
 export function isAuthenticated(apiKey: string | undefined | null): apiKey is string {
 	return Boolean(apiKey) && apiKey !== kNoAuth;
 }
@@ -871,6 +875,7 @@ export class ModelRegistry {
 	#lastDiscoveryWarnings: Map<string, string> = new Map();
 	#hasProbed = false;
 	#refreshQueue: Promise<void> = Promise.resolve();
+	#openAICodexMaxContext = false;
 
 	#enqueueRefresh(operation: () => Promise<void>): Promise<void> {
 		const pending = this.#refreshQueue.then(operation);
@@ -890,7 +895,10 @@ export class ModelRegistry {
 	constructor(
 		readonly authStorage: AuthStorage,
 		modelsPath?: string,
-		private readonly options: { getProviderOrder?: () => readonly string[] } = {},
+		private readonly options: {
+			getProviderOrder?: () => readonly string[];
+			getOpenAICodexMaxContext?: () => boolean;
+		} = {},
 	) {
 		this.#modelsConfigFile = ModelsConfigFile.relocate(modelsPath);
 		this.#cacheDbPath = modelsPath ? path.join(path.dirname(modelsPath), "models.db") : undefined;
@@ -1042,6 +1050,7 @@ export class ModelRegistry {
 	}
 
 	#loadModels() {
+		this.#openAICodexMaxContext = this.options.getOpenAICodexMaxContext?.() ?? this.#openAICodexMaxContext;
 		// Load custom models from models.json first (to know which providers to override)
 		const {
 			models: customModels = [],
@@ -1075,6 +1084,25 @@ export class ModelRegistry {
 		const combined = this.#mergeCustomModels(withConfigModels, this.#runtimeModelOverlays);
 
 		this.#models = this.#applyProviderModelAllowlists(this.#applyModelOverrides(combined, this.#modelOverrides));
+		this.#applyOpenAICodexContextWindow();
+		this.#rebuildCanonicalIndex();
+	}
+
+	#applyOpenAICodexContextWindow(): void {
+		const contextWindow = this.#openAICodexMaxContext
+			? OPENAI_CODEX_MAX_CONTEXT_WINDOW
+			: OPENAI_CODEX_STANDARD_CONTEXT_WINDOW;
+		for (const model of this.#models) {
+			if (model.provider === "openai-codex" && OPENAI_CODEX_MAX_CONTEXT_MODEL_IDS.has(model.id)) {
+				model.contextWindow = contextWindow;
+			}
+		}
+	}
+
+	/** Update GPT-6 subscription context limits without rebuilding the registry. */
+	setOpenAICodexMaxContext(enabled: boolean): void {
+		this.#openAICodexMaxContext = enabled;
+		this.#applyOpenAICodexContextWindow();
 		this.#rebuildCanonicalIndex();
 	}
 

package/src/config/settings-schema.ts

@@ -2102,6 +2102,17 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
+	"providers.openaiCodexMaxContext": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "providers",
+			label: "OpenAI Codex Maximum Context",
+			description:
+				"Use the 1.05M-token context window for GPT-6 Luna and Sol (long-context pricing applies above 272K)",
+		},
+	},
+
 	"providers.parallelFetch": {
 		type: "boolean",
 		default: true,

package/src/extensibility/plugins/marketplace/builtin-marketplace-snapshot.ts

@@ -1,4 +1,4 @@
 const builtinMarketplaceSnapshot =
-	'{\n  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",\n  "name": "f5-sales-demo-marketplace",\n  "version": "1.0.0",\n  "metadata": {\n    "description": "Claude Code plugins for f5-sales-demo documentation repositories"\n  },\n  "owner": {\n    "name": "f5-sales-demo",\n    "url": "https://github.com/f5-sales-demo"\n  },\n  "plugins": [\n    {\n      "name": "docs-tools",\n      "description": "MDX content validation and review tools for f5-sales-demo docs repos",\n      "version": "1.1.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/docs-tools",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/docs-tools",\n      "category": "productivity",\n      "keywords": ["mdx", "documentation", "validation", "starlight", "astro"],\n      "tags": ["docs", "linting", "content-review", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Documentation content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "sales-engineer",\n      "description": "Sales Engineer persona framework for F5 XC demo repositories — demo execution, environment operations, presentation, Q&A, post-session debrief",\n      "version": "1.0.12",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/sales-engineer",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/sales-engineer",\n      "category": "productivity",\n      "keywords": ["sales-engineer", "demo", "persona", "presentation", "f5xc"],\n      "tags": ["demo", "sales", "persona", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Sales engineering content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "docs-pipeline",\n      "description": "Documentation pipeline architecture — config ownership, release dispatch chain, content authoring, managed files, local preview",\n      "version": "1.0.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/docs-pipeline",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/docs-pipeline",\n      "category": "productivity",\n      "keywords": ["docs", "pipeline", "astro", "starlight", "content", "authoring"],\n      "tags": ["docs", "pipeline", "content", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Documentation pipeline content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "brand",\n      "description": "F5 corporate branding enforcement — colors, typography, logos, icons, accessibility, and visual identity standards across all content types",\n      "version": "1.0.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/brand",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/brand",\n      "category": "productivity",\n      "keywords": ["brand", "design-system", "colors", "typography", "accessibility"],\n      "tags": ["brand", "design", "visual-identity", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Brand guidance content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "meddpicc",\n      "description": "MEDDPICC sales qualification and deal-execution framework — evidence-based deal management, stakeholder mapping, mutual action plans, and forecast integrity for complex enterprise B2B sales",\n      "version": "7.5.9",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/meddpicc",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/meddpicc",\n      "category": "productivity",\n      "keywords": [\n        "meddpicc",\n        "sales-qualification",\n        "deal-management",\n        "enterprise-sales",\n        "forecast",\n        "champion",\n        "economic-buyer",\n        "mutual-action-plan",\n        "f5xc"\n      ],\n      "tags": ["sales", "qualification", "deal-management", "forecast", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["MEDDPICC content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "devcontainer",\n      "description": "Container awareness — tool catalog, self-identity, self-diagnosis, and maintenance for the f5-sales-demo devcontainer",\n      "version": "1.2.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/devcontainer",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/devcontainer",\n      "category": "productivity",\n      "keywords": ["devcontainer", "tools", "catalog", "cli", "inventory", "container"],\n      "tags": ["devcontainer", "tools", "catalog", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["devcontainer"],\n        "requirements": ["A supported development container runtime"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "platform",\n      "description": "Provider-neutral F5 Distributed Cloud Secure Mesh Site v2 capabilities, configuration, bootstrap, and status tools",\n      "version": "5.1.1",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/platform",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/platform",\n      "category": "productivity",\n      "keywords": [\n        "console",\n        "browser",\n        "automation",\n        "azure-sso",\n        "mcp",\n        "chrome-devtools",\n        "f5xc",\n        "api",\n        "rest",\n        "platform",\n        "openapi",\n        "crud",\n        "spec-aware"\n      ],\n      "tags": ["console", "browser", "automation", "f5xc", "api", "platform", "openapi"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["platform"],\n        "requirements": ["F5 Distributed Cloud API URL and token environment variables"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "osint-framework",\n      "description": "OSINT Framework tool catalog and investigation skills — 1,064 free intelligence-gathering tools across 34 categories, mapped from osintframework.com. Category-based skills, executable investigation pipelines, CLI tool execution, and OPSEC-aware workflows.",\n      "version": "1.0.8",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/osint-framework",\n      "keywords": ["osint", "reconnaissance", "intelligence", "investigation", "security"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/osint-framework",\n      "category": "security",\n      "tags": ["osint", "recon", "security", "intelligence"],\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["OSINT framework content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "firecrawl",\n      "description": "Local self-hosted firecrawl web scraping — scrape, crawl, and map websites via the local firecrawl API on port 3002. No API keys, no subscriptions, fully open-source.",\n      "version": "1.2.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/firecrawl",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/firecrawl",\n      "category": "productivity",\n      "keywords": ["firecrawl", "scrape", "crawl", "web-scraping", "markdown", "self-hosted", "local", "open-source"],\n      "tags": ["firecrawl", "scraping", "web", "local"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["firecrawl"],\n        "requirements": ["A reachable local Firecrawl service"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "salesforce",\n      "description": "Salesforce pipeline intelligence with shared lifecycle setup, account discovery, context, and reporting tools",\n      "version": "1.5.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/salesforce",\n      "keywords": [\n        "salesforce",\n        "sf",\n        "apex",\n        "lwc",\n        "soql",\n        "metadata",\n        "deploy",\n        "testing",\n        "sfdx",\n        "agentforce",\n        "pipeline",\n        "xcsh"\n      ],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/salesforce",\n      "category": "development",\n      "tags": ["salesforce", "development", "cli", "crm", "xcsh-extension"],\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["salesforce"],\n        "requirements": ["Salesforce CLI", "An authenticated default Salesforce org"],\n        "setupRequired": true,\n        "collectedData": ["accounts", "identifiers", "business_profile"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "cloudstatus",\n      "description": "Live cloud status and Internet network intelligence for xcsh — current incidents, routing, registration, RPKI, peering, facilities, F5 Regional Edge evidence, and bounded path diagnostics",\n      "version": "1.7.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/cloudstatus",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/cloudstatus",\n      "category": "productivity",\n      "keywords": [\n        "status",\n        "monitoring",\n        "incidents",\n        "maintenance",\n        "statuspage",\n        "operational-intelligence",\n        "network-intelligence",\n        "bgp",\n        "rdap",\n        "rpki",\n        "routing",\n        "location",\n        "peeringdb",\n        "facilities",\n        "f5xc",\n        "atlassian"\n      ],\n      "tags": ["status", "network-intelligence", "routing", "peering", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "on_demand",\n        "integrations": ["cloudstatus"],\n        "requirements": ["Network access when a cloud-status command is invoked"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "azure",\n      "description": "Azure CLI integration and deterministic F5 Customer Edge discovery, planning, lifecycle, and diagnostics",\n      "version": "4.4.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/azure",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/azure",\n      "category": "development",\n      "keywords": ["azure", "az", "cloud", "f5xc", "customer-edge", "secure-mesh-site"],\n      "tags": ["azure", "cloud", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["azure"],\n        "requirements": ["Azure CLI", "An authenticated Azure account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "aws",\n      "description": "AWS CLI integration and deterministic F5 Secure Mesh Site v2 Customer Edge discovery, planning, lifecycle, and diagnostics",\n      "version": "2.1.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/aws",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/aws",\n      "category": "development",\n      "keywords": ["aws", "amazon", "cloud", "f5xc", "customer-edge", "secure-mesh-site", "tgw", "nlb"],\n      "tags": ["aws", "cloud", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["aws"],\n        "requirements": ["AWS CLI", "AWS credentials or an authenticated SSO profile"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "kvm",\n      "description": "Deterministic F5 Distributed Cloud Secure Mesh Site v2 lifecycle for KVM, libvirt, and Terraform-owned FRR routing",\n      "version": "2.0.2",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/kvm",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/kvm",\n      "category": "development",\n      "keywords": ["kvm", "libvirt", "qemu", "f5xc", "customer-edge", "secure-mesh-site", "frr", "terraform"],\n      "tags": ["kvm", "libvirt", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["kvm"],\n        "requirements": [\n          "Terraform CLI",\n          "libvirt and qemu system access",\n          "Docker CLI",\n          "curl",\n          "F5 Distributed Cloud Platform integration"\n        ],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": [],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "gcloud",\n      "description": "Google Cloud CLI integration — container-adapted auth, context injection, CLI operator agent, token expiry detection, and welcome screen status",\n      "version": "1.3.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/gcloud",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/gcloud",\n      "category": "development",\n      "keywords": ["gcloud", "google", "cloud"],\n      "tags": ["gcloud", "google", "cloud", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["gcloud"],\n        "requirements": ["Google Cloud CLI", "An authenticated Google Cloud account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "gitlab",\n      "description": "GitLab CLI integration with shared lifecycle readiness, profile discovery, and issue management tools",\n      "version": "1.3.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "keywords": ["gitlab", "glab", "issues", "git"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/gitlab",\n      "category": "development",\n      "tags": ["gitlab", "development", "cli", "xcsh-extension"],\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/gitlab",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["gitlab"],\n        "requirements": ["GitLab CLI", "An authenticated GitLab account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "github",\n      "description": "GitHub and Git operations with typed lifecycle stages, normalized evidence, and advisory governance",\n      "version": "3.1.1",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/github",\n      "keywords": ["github", "gh", "git", "pr", "issues", "ci", "workflow", "git-sops", "github-ops"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/github",\n      "category": "development",\n      "tags": ["github", "development", "cli", "workflow", "xcsh-extension"],\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["github", "github_email"],\n        "requirements": ["GitHub CLI", "An authenticated GitHub account"],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": ["accounts", "email", "identifiers", "sameAs"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "herdr",\n      "description": "Install and operate the stable F5 Herdr fork with verified native xcsh health, explicit pairing, and complete pane-control guidance.",\n      "version": "1.1.2",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/herdr",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/herdr",\n      "category": "development",\n      "keywords": ["herdr", "terminal", "multiplexer", "panes", "agents"],\n      "tags": ["terminal", "orchestration", "agents", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["herdr"],\n        "requirements": [\n          "Supported 64-bit Linux, macOS, or Windows host",\n          "HTTPS access to the f5-sales-demo/herdr stable manifest and release"\n        ],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "asm-migration",\n      "description": "Deterministic BIG-IP ASM conversion and guarded F5 Distributed Cloud deployment",\n      "version": "2.1.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/asm-migration",\n      "keywords": ["asm", "waf", "migration", "f5xc", "xcsh-extension"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/asm-migration",\n      "category": "security",\n      "tags": ["asm", "waf", "security", "migration", "f5xc"],\n      "recommended": false,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["asm_migration"],\n        "requirements": ["ASM migration runtime dependencies", "F5 Distributed Cloud Platform integration"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "terraform",\n      "description": "Senior DevOps Infrastructure-as-Code plugin providing HashiCorp Registry proactive version checks, HCL authoring, testing frameworks, and troubleshooting playbooks.",\n      "version": "2.1.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/terraform",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/terraform",\n      "category": "development",\n      "keywords": ["terraform", "hcl", "iac", "devops", "hashicorp", "testing", "troubleshooting"],\n      "tags": ["terraform", "iac", "devops", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["terraform"],\n        "requirements": ["Terraform CLI"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "xorg",\n      "version": "1.1.0",\n      "description": "Ubuntu 24.04 Xorg desktop automation substrate",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Xorg",\n        "version": "1.1.0"\n      },\n      "source": "./plugins/xorg",\n      "category": "development",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/xorg",\n      "keywords": ["xorg", "at-spi", "xtest", "pipewire"],\n      "tags": ["linux", "desktop", "automation"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["xorg"],\n        "requirements": ["Ubuntu 24.04 with passwordless sudo"],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "zoom",\n      "version": "1.0.5",\n      "description": "Verified Zoom Workplace control through public xorgctl JSON",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Zoom",\n        "version": "1.0.5"\n      },\n      "source": "./plugins/zoom",\n      "category": "productivity",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/zoom",\n      "keywords": ["zoom", "meeting", "accessibility", "virtual-camera"],\n      "tags": ["zoom", "meeting", "automation"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["zoom"],\n        "requirements": ["Ubuntu 24.04", "Zoom Workplace", "Xorg plugin"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": ["xorg"]\n      }\n    }\n  ]\n}\n';
+	'{\n  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",\n  "name": "f5-sales-demo-marketplace",\n  "version": "1.0.0",\n  "metadata": {\n    "description": "Claude Code plugins for f5-sales-demo documentation repositories"\n  },\n  "owner": {\n    "name": "f5-sales-demo",\n    "url": "https://github.com/f5-sales-demo"\n  },\n  "plugins": [\n    {\n      "name": "docs-tools",\n      "description": "MDX content validation and review tools for f5-sales-demo docs repos",\n      "version": "1.1.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/docs-tools",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/docs-tools",\n      "category": "productivity",\n      "keywords": ["mdx", "documentation", "validation", "starlight", "astro"],\n      "tags": ["docs", "linting", "content-review", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Documentation content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "sales-engineer",\n      "description": "Sales Engineer persona framework for F5 XC demo repositories — demo execution, environment operations, presentation, Q&A, post-session debrief",\n      "version": "1.0.12",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/sales-engineer",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/sales-engineer",\n      "category": "productivity",\n      "keywords": ["sales-engineer", "demo", "persona", "presentation", "f5xc"],\n      "tags": ["demo", "sales", "persona", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Sales engineering content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "docs-pipeline",\n      "description": "Documentation pipeline architecture — config ownership, release dispatch chain, content authoring, managed files, local preview",\n      "version": "1.0.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/docs-pipeline",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/docs-pipeline",\n      "category": "productivity",\n      "keywords": ["docs", "pipeline", "astro", "starlight", "content", "authoring"],\n      "tags": ["docs", "pipeline", "content", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Documentation pipeline content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "brand",\n      "description": "F5 corporate branding enforcement — colors, typography, logos, icons, accessibility, and visual identity standards across all content types",\n      "version": "1.0.6",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/brand",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/brand",\n      "category": "productivity",\n      "keywords": ["brand", "design-system", "colors", "typography", "accessibility"],\n      "tags": ["brand", "design", "visual-identity", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["Brand guidance content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "meddpicc",\n      "description": "MEDDPICC sales qualification and deal-execution framework — evidence-based deal management, stakeholder mapping, mutual action plans, and forecast integrity for complex enterprise B2B sales",\n      "version": "7.5.9",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/meddpicc",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/meddpicc",\n      "category": "productivity",\n      "keywords": [\n        "meddpicc",\n        "sales-qualification",\n        "deal-management",\n        "enterprise-sales",\n        "forecast",\n        "champion",\n        "economic-buyer",\n        "mutual-action-plan",\n        "f5xc"\n      ],\n      "tags": ["sales", "qualification", "deal-management", "forecast", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["MEDDPICC content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "devcontainer",\n      "description": "Container awareness — tool catalog, self-identity, self-diagnosis, and maintenance for the f5-sales-demo devcontainer",\n      "version": "1.2.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/devcontainer",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/devcontainer",\n      "category": "productivity",\n      "keywords": ["devcontainer", "tools", "catalog", "cli", "inventory", "container"],\n      "tags": ["devcontainer", "tools", "catalog", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["devcontainer"],\n        "requirements": ["A supported development container runtime"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "platform",\n      "description": "Provider-neutral F5 Distributed Cloud Secure Mesh Site v2 capabilities, configuration, bootstrap, and status tools",\n      "version": "5.1.2",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/platform",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/platform",\n      "category": "productivity",\n      "keywords": [\n        "console",\n        "browser",\n        "automation",\n        "azure-sso",\n        "mcp",\n        "chrome-devtools",\n        "f5xc",\n        "api",\n        "rest",\n        "platform",\n        "openapi",\n        "crud",\n        "spec-aware"\n      ],\n      "tags": ["console", "browser", "automation", "f5xc", "api", "platform", "openapi"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["platform"],\n        "requirements": ["F5 Distributed Cloud API URL and token environment variables"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "osint-framework",\n      "description": "OSINT Framework tool catalog and investigation skills — 1,064 free intelligence-gathering tools across 34 categories, mapped from osintframework.com. Category-based skills, executable investigation pipelines, CLI tool execution, and OPSEC-aware workflows.",\n      "version": "1.0.8",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/osint-framework",\n      "keywords": ["osint", "reconnaissance", "intelligence", "investigation", "security"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/osint-framework",\n      "category": "security",\n      "tags": ["osint", "recon", "security", "intelligence"],\n      "lifecycle": {\n        "mode": "content",\n        "integrations": [],\n        "requirements": ["OSINT framework content only"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "firecrawl",\n      "description": "Local self-hosted firecrawl web scraping — scrape, crawl, and map websites via the local firecrawl API on port 3002. No API keys, no subscriptions, fully open-source.",\n      "version": "1.2.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/firecrawl",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/firecrawl",\n      "category": "productivity",\n      "keywords": ["firecrawl", "scrape", "crawl", "web-scraping", "markdown", "self-hosted", "local", "open-source"],\n      "tags": ["firecrawl", "scraping", "web", "local"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["firecrawl"],\n        "requirements": ["A reachable local Firecrawl service"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "salesforce",\n      "description": "Salesforce pipeline intelligence with shared lifecycle setup, account discovery, context, and reporting tools",\n      "version": "1.5.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/salesforce",\n      "keywords": [\n        "salesforce",\n        "sf",\n        "apex",\n        "lwc",\n        "soql",\n        "metadata",\n        "deploy",\n        "testing",\n        "sfdx",\n        "agentforce",\n        "pipeline",\n        "xcsh"\n      ],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/salesforce",\n      "category": "development",\n      "tags": ["salesforce", "development", "cli", "crm", "xcsh-extension"],\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["salesforce"],\n        "requirements": ["Salesforce CLI", "An authenticated default Salesforce org"],\n        "setupRequired": true,\n        "collectedData": ["accounts", "identifiers", "business_profile"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "cloudstatus",\n      "description": "Live cloud status and Internet network intelligence for xcsh — current incidents, routing, registration, RPKI, peering, facilities, F5 Regional Edge evidence, and bounded path diagnostics",\n      "version": "1.7.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/cloudstatus",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/cloudstatus",\n      "category": "productivity",\n      "keywords": [\n        "status",\n        "monitoring",\n        "incidents",\n        "maintenance",\n        "statuspage",\n        "operational-intelligence",\n        "network-intelligence",\n        "bgp",\n        "rdap",\n        "rpki",\n        "routing",\n        "location",\n        "peeringdb",\n        "facilities",\n        "f5xc",\n        "atlassian"\n      ],\n      "tags": ["status", "network-intelligence", "routing", "peering", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "on_demand",\n        "integrations": ["cloudstatus"],\n        "requirements": ["Network access when a cloud-status command is invoked"],\n        "setupRequired": false,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "azure",\n      "description": "Azure CLI integration and deterministic F5 Customer Edge discovery, planning, lifecycle, and diagnostics",\n      "version": "4.4.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/azure",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/azure",\n      "category": "development",\n      "keywords": ["azure", "az", "cloud", "f5xc", "customer-edge", "secure-mesh-site"],\n      "tags": ["azure", "cloud", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["azure"],\n        "requirements": ["Azure CLI", "An authenticated Azure account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "aws",\n      "description": "AWS CLI integration and deterministic F5 Secure Mesh Site v2 Customer Edge discovery, planning, lifecycle, and diagnostics",\n      "version": "2.1.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/aws",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/aws",\n      "category": "development",\n      "keywords": ["aws", "amazon", "cloud", "f5xc", "customer-edge", "secure-mesh-site", "tgw", "nlb"],\n      "tags": ["aws", "cloud", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["aws"],\n        "requirements": ["AWS CLI", "AWS credentials or an authenticated SSO profile"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "kvm",\n      "description": "Deterministic F5 Distributed Cloud Secure Mesh Site v2 lifecycle for KVM, libvirt, and Terraform-owned FRR routing",\n      "version": "2.0.2",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/kvm",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/kvm",\n      "category": "development",\n      "keywords": ["kvm", "libvirt", "qemu", "f5xc", "customer-edge", "secure-mesh-site", "frr", "terraform"],\n      "tags": ["kvm", "libvirt", "f5xc", "customer-edge", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["kvm"],\n        "requirements": [\n          "Terraform CLI",\n          "libvirt and qemu system access",\n          "Docker CLI",\n          "curl",\n          "F5 Distributed Cloud Platform integration"\n        ],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": [],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "gcloud",\n      "description": "Google Cloud CLI integration — container-adapted auth, context injection, CLI operator agent, token expiry detection, and welcome screen status",\n      "version": "1.3.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/gcloud",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/gcloud",\n      "category": "development",\n      "keywords": ["gcloud", "google", "cloud"],\n      "tags": ["gcloud", "google", "cloud", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["gcloud"],\n        "requirements": ["Google Cloud CLI", "An authenticated Google Cloud account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "gitlab",\n      "description": "GitLab CLI integration with shared lifecycle readiness, profile discovery, and issue management tools",\n      "version": "1.3.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "keywords": ["gitlab", "glab", "issues", "git"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/gitlab",\n      "category": "development",\n      "tags": ["gitlab", "development", "cli", "xcsh-extension"],\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/gitlab",\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["gitlab"],\n        "requirements": ["GitLab CLI", "An authenticated GitLab account"],\n        "setupRequired": true,\n        "collectedData": ["accounts"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "github",\n      "description": "GitHub and Git operations with typed lifecycle stages, normalized evidence, and advisory governance",\n      "version": "3.1.1",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/github",\n      "keywords": ["github", "gh", "git", "pr", "issues", "ci", "workflow", "git-sops", "github-ops"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/github",\n      "category": "development",\n      "tags": ["github", "development", "cli", "workflow", "xcsh-extension"],\n      "recommended": true,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["github", "github_email"],\n        "requirements": ["GitHub CLI", "An authenticated GitHub account"],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": ["accounts", "email", "identifiers", "sameAs"],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "herdr",\n      "description": "Install and operate the stable F5 Herdr fork with verified native xcsh health, explicit pairing, and complete pane-control guidance.",\n      "version": "1.1.2",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/herdr",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/herdr",\n      "category": "development",\n      "keywords": ["herdr", "terminal", "multiplexer", "panes", "agents"],\n      "tags": ["terminal", "orchestration", "agents", "xcsh-extension"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["herdr"],\n        "requirements": [\n          "Supported 64-bit Linux, macOS, or Windows host",\n          "HTTPS access to the f5-sales-demo/herdr stable manifest and release"\n        ],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "asm-migration",\n      "description": "Deterministic BIG-IP ASM conversion and guarded F5 Distributed Cloud deployment",\n      "version": "2.1.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/asm-migration",\n      "keywords": ["asm", "waf", "migration", "f5xc", "xcsh-extension"],\n      "license": "Apache-2.0",\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "source": "./plugins/asm-migration",\n      "category": "security",\n      "tags": ["asm", "waf", "security", "migration", "f5xc"],\n      "recommended": false,\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["asm_migration"],\n        "requirements": ["ASM migration runtime dependencies", "F5 Distributed Cloud Platform integration"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": ["platform"]\n      }\n    },\n    {\n      "name": "terraform",\n      "description": "Senior DevOps Infrastructure-as-Code plugin providing HashiCorp Registry proactive version checks, HCL authoring, testing frameworks, and troubleshooting playbooks.",\n      "version": "2.1.0",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/terraform",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "source": "./plugins/terraform",\n      "category": "development",\n      "keywords": ["terraform", "hcl", "iac", "devops", "hashicorp", "testing", "troubleshooting"],\n      "tags": ["terraform", "iac", "devops", "f5xc"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["terraform"],\n        "requirements": ["Terraform CLI"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "xorg",\n      "version": "1.1.0",\n      "description": "Ubuntu 24.04 Xorg desktop automation substrate",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Xorg",\n        "version": "1.1.0"\n      },\n      "source": "./plugins/xorg",\n      "category": "development",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/xorg",\n      "keywords": ["xorg", "at-spi", "xtest", "pipewire"],\n      "tags": ["linux", "desktop", "automation"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["xorg"],\n        "requirements": ["Ubuntu 24.04 with passwordless sudo"],\n        "setupRequired": true,\n        "setupAuthorization": "install",\n        "collectedData": [],\n        "pluginDependencies": []\n      }\n    },\n    {\n      "name": "zoom",\n      "version": "1.0.5",\n      "description": "Verified Zoom Workplace control through public xorgctl JSON",\n      "license": "Apache-2.0",\n      "author": {\n        "name": "f5-sales-demo"\n      },\n      "extensions": ["extensions/integration.ts"],\n      "xcsh": {\n        "name": "Zoom",\n        "version": "1.0.5"\n      },\n      "source": "./plugins/zoom",\n      "category": "productivity",\n      "homepage": "https://github.com/f5-sales-demo/marketplace/tree/main/plugins/zoom",\n      "keywords": ["zoom", "meeting", "accessibility", "virtual-camera"],\n      "tags": ["zoom", "meeting", "automation"],\n      "repository": "https://github.com/f5-sales-demo/marketplace",\n      "lifecycle": {\n        "mode": "integrated",\n        "integrations": ["zoom"],\n        "requirements": ["Ubuntu 24.04", "Zoom Workplace", "Xorg plugin"],\n        "setupRequired": true,\n        "collectedData": [],\n        "pluginDependencies": ["xorg"]\n      }\n    }\n  ]\n}\n';
 
 export default builtinMarketplaceSnapshot;

package/src/extensibility/plugins/marketplace/builtin-marketplace.provenance.json

@@ -1,7 +1,7 @@
 {
   "repository": "https://github.com/f5-sales-demo/marketplace",
   "sourcePath": ".xcsh-plugin/marketplace.json",
-  "commit": "f85837e95700ebe73bee7b5ffb6dd67fc46791c1",
-  "sha256": "46515b473992e35856a550d238581b02554627b75ce9d05aececc913fd423db0",
-  "capturedAt": "2026-09-23T07:09:59.120Z"
+  "commit": "512b3915e18e5bae247f58e2c7e3bbdb94656e7a",
+  "sha256": "7e3868a2afd6fbeb31e9d212c30947b9cc6b127ffa8412e9e4f9f06171834251",
+  "capturedAt": "2026-09-23T20:05:58.783Z"
 }

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

@@ -88,6 +88,12 @@ export interface PluginDependencyPlanItem {
 	dependency: boolean;
 }
 
+export interface PluginUninstallPreview {
+	pluginId: string;
+	scope: "user" | "project";
+	installPaths: string[];
+}
+
 function resolvePluginDependencyNames(catalog: MarketplaceCatalog, root: string): string[] {
 	const plugins = new Map(catalog.plugins.map(plugin => [plugin.name, plugin]));
 	const state = new Map<string, "visiting" | "visited">();
@@ -691,7 +697,7 @@ export class MarketplaceManager {
 		return "0.0.0";
 	}
 
-	async uninstallPlugin(pluginId: string, scope?: "user" | "project"): Promise<void> {
+	async #resolvePluginUninstall(pluginId: string, scope?: "user" | "project") {
 		const parsed = parsePluginId(pluginId);
 		if (!parsed) {
 			throw new Error(`Invalid plugin ID format: "${pluginId}". Expected "name@marketplace".`);
@@ -731,6 +737,23 @@ export class MarketplaceManager {
 		const targetReg = targetScope === "project" ? projectReg : userReg;
 		const registryPath = this.#registryPath(targetScope);
 		await this.#assertNoInstalledDependents(pluginId, targetReg);
+		return { targetEntries, targetReg, targetScope, registryPath };
+	}
+
+	async previewUninstallPlugin(pluginId: string, scope?: "user" | "project"): Promise<PluginUninstallPreview> {
+		const { targetEntries, targetScope } = await this.#resolvePluginUninstall(pluginId, scope);
+		return {
+			pluginId,
+			scope: targetScope,
+			installPaths: targetEntries.map(entry => entry.installPath),
+		};
+	}
+
+	async uninstallPlugin(pluginId: string, scope?: "user" | "project"): Promise<void> {
+		const { targetEntries, targetReg, targetScope, registryPath } = await this.#resolvePluginUninstall(
+			pluginId,
+			scope,
+		);
 
 		const updatedReg = removeInstalledPlugin(targetReg, pluginId);
 		await writeInstalledPluginsRegistry(registryPath, updatedReg);

package/src/integrations/registry.ts

@@ -48,6 +48,7 @@ function freezePlan(plan: IntegrationSetupPlan | undefined): IntegrationSetupPla
 		verification: Object.freeze(
 			plan.verification.map(step => Object.freeze({ ...step, argv: freezeStrings(step.argv) })),
 		),
+		...(plan.guidedAction ? { guidedAction: Object.freeze({ kind: plan.guidedAction.kind }) } : {}),
 	};
 	return Object.freeze(frozen);
 }
@@ -58,6 +59,16 @@ function validateArgv(argv: readonly string[]): boolean {
 
 function validatePlan(plan: IntegrationSetupPlan | undefined): void {
 	if (!plan) return;
+	const guidedActionValid =
+		plan.guidedAction === undefined ||
+		(typeof plan.guidedAction === "object" &&
+			plan.guidedAction !== null &&
+			plan.guidedAction.kind === "context_wizard" &&
+			Object.keys(plan.guidedAction).length === 1);
+	const hasExecutablePlan =
+		Array.isArray(plan.steps) &&
+		Array.isArray(plan.verification) &&
+		(plan.steps.length > 0 || plan.verification.length > 0);
 	if (
 		!Array.isArray(plan.pluginDependencies) ||
 		!Array.isArray(plan.requiredEnvironment) ||
@@ -65,6 +76,9 @@ function validatePlan(plan: IntegrationSetupPlan | undefined): void {
 		!Array.isArray(plan.profileFields) ||
 		!Array.isArray(plan.steps) ||
 		!Array.isArray(plan.verification) ||
+		!guidedActionValid ||
+		(!plan.guidedAction && !hasExecutablePlan) ||
+		(plan.guidedAction !== undefined && hasExecutablePlan) ||
 		plan.steps.some(
 			step =>
 				!step ||

package/src/integrations/setup.ts

@@ -17,10 +17,28 @@ export interface SetupStepRunnerOptions {
 	readonly nonInteractiveOutput?: "inherit" | "ignore";
 }
 
+export function describeIntegrationSetupNextAction(
+	handle: Pick<IntegrationHandle<unknown>, "id" | "plugin" | "setupPlan">,
+): string {
+	const target = handle.plugin ?? handle.id;
+	return handle.setupPlan?.guidedAction?.kind === "context_wizard"
+		? `Open xcsh interactively and run /plugin setup ${target}`
+		: `xcsh plugin setup ${target}`;
+}
+
+export function describeInteractiveInstallSetupNextAction(
+	plugin: string,
+	lifecycle: { readonly setupRequired: boolean; readonly setupAuthorization?: "separate" | "install" },
+): string | undefined {
+	if (!lifecycle.setupRequired || (lifecycle.setupAuthorization ?? "separate") === "install") return undefined;
+	return `/plugin setup ${plugin}`;
+}
+
 export function describeInstallSetupOutcome(
 	plugin: string,
 	status: Pick<IntegrationSnapshot<unknown>, "state" | "reason">,
 	dependencyPlan: readonly { readonly pluginId: string }[],
+	handles: readonly Pick<IntegrationHandle<unknown>, "id" | "plugin" | "setupPlan">[] = [],
 ): string {
 	const summary = `${plugin}: ${status.state}${status.reason ? ` (${status.reason})` : ""}`;
 	if (status.state === "ready") return summary;
@@ -28,7 +46,12 @@ export function describeInstallSetupOutcome(
 		status.reason === "dependency_missing"
 			? dependencyPlan.find(item => item.pluginId.split("@")[0] !== plugin)?.pluginId.split("@")[0]
 			: undefined;
-	return `${summary}\nnext: xcsh plugin setup ${blockingDependency ?? plugin}`;
+	const target = blockingDependency ?? plugin;
+	const handle = handles.find(
+		candidate => candidate.id === target || candidate.plugin === target || candidate.plugin?.split("@")[0] === target,
+	);
+	const nextAction = handle ? describeIntegrationSetupNextAction(handle) : `xcsh plugin setup ${target}`;
+	return `${summary}\nnext: ${nextAction}`;
 }
 
 export function describeSetupPlan(handle: IntegrationHandle<unknown>): string {
@@ -39,11 +62,17 @@ export function describeSetupPlan(handle: IntegrationHandle<unknown>): string {
 		`Plugin dependencies: ${plan.pluginDependencies.join(", ") || "none"}`,
 		`Required environment names: ${plan.requiredEnvironment.join(", ") || "none"}`,
 		`Person-profile categories: ${plan.profileFields.join(", ") || "none"}`,
-		"Commands:",
-		...plan.steps.map(step => `  ${step.kind}: ${JSON.stringify(step.argv)} (timeout ${step.timeoutMs}ms)`),
-		"Verification:",
-		...plan.verification.map(step => `  ${JSON.stringify(step.argv)} (timeout ${step.timeoutMs}ms)`),
 	];
+	if (plan.guidedAction?.kind === "context_wizard") {
+		lines.push("Guided action: native xcsh context wizard");
+	} else {
+		lines.push(
+			"Commands:",
+			...plan.steps.map(step => `  ${step.kind}: ${JSON.stringify(step.argv)} (timeout ${step.timeoutMs}ms)`),
+			"Verification:",
+			...plan.verification.map(step => `  ${JSON.stringify(step.argv)} (timeout ${step.timeoutMs}ms)`),
+		);
+	}
 	return lines.join("\n");
 }
 
@@ -86,6 +115,7 @@ export async function executeReviewedSetup<T>(
 	signal?: AbortSignal,
 ): Promise<IntegrationSnapshot<T>> {
 	if (reviewedPlan !== handle.setupPlan) throw new Error("Setup requires the current reviewed setup plan");
+	if (reviewedPlan.guidedAction) throw new Error("Guided setup must run through its native interactive action");
 	for (const step of reviewedPlan.steps) {
 		if (signal?.aborted) throw new Error("Integration setup cancelled");
 		if ((await run(step, signal)) !== 0) throw new Error(`Integration ${step.kind} step failed`);

package/src/integrations/types.ts

@@ -34,12 +34,17 @@ export interface IntegrationVerificationStep {
 	readonly timeoutMs: number;
 }
 
+export interface IntegrationGuidedSetupAction {
+	readonly kind: "context_wizard";
+}
+
 export interface IntegrationSetupPlan {
 	readonly pluginDependencies: readonly string[];
 	readonly requiredEnvironment: readonly string[];
 	readonly profileFields: readonly string[];
 	readonly steps: readonly IntegrationSetupStep[];
 	readonly verification: readonly IntegrationVerificationStep[];
+	readonly guidedAction?: IntegrationGuidedSetupAction;
 }
 
 export interface IntegrationDefinition<T> {