@f5-sales-demo/xcsh 19.56.2 → 19.57.1

package/package.json

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

package/src/extensibility/extensions/loader.ts

@@ -284,7 +284,7 @@ async function loadExtension(
 	const resolvedPath = resolvePath(extensionPath, cwd);
 
 	try {
-		const module = await import(resolvedPath);
+		const module = await logger.time("ext:loadModule", () => import(resolvedPath));
 		const factory = (module.default ?? module) as ExtensionFactory;
 
 		if (typeof factory !== "function") {
@@ -295,7 +295,13 @@ async function loadExtension(
 		}
 
 		const extension = createExtension(extensionPath, resolvedPath);
-		const api = new ConcreteExtensionAPI(await import("@f5-sales-demo/xcsh"), extension, runtime, cwd, eventBus);
+		const api = new ConcreteExtensionAPI(
+			await logger.time("ext:barrelImport", () => import("@f5-sales-demo/xcsh")),
+			extension,
+			runtime,
+			cwd,
+			eventBus,
+		);
 		await factory(api);
 
 		return { extension, error: null };
@@ -316,7 +322,13 @@ export async function loadExtensionFromFactory(
 	name = "<inline>",
 ): Promise<Extension> {
 	const extension = createExtension(name, name);
-	const api = new ConcreteExtensionAPI(await import("@f5-sales-demo/xcsh"), extension, runtime, cwd, eventBus);
+	const api = new ConcreteExtensionAPI(
+		await logger.time("ext:barrelImport", () => import("@f5-sales-demo/xcsh")),
+		extension,
+		runtime,
+		cwd,
+		eventBus,
+	);
 	await factory(api);
 	return extension;
 }
@@ -540,7 +552,9 @@ export async function discoverAndLoadExtensions(
 	};
 
 	// 1. Discover extension modules via capability API (native .omp/.pi only)
-	const discovered = await loadCapability<ExtensionModule>(extensionModuleCapability.id, { cwd });
+	const discovered = await logger.time("ext:discoverCapability", () =>
+		loadCapability<ExtensionModule>(extensionModuleCapability.id, { cwd }),
+	);
 	for (const ext of discovered.items) {
 		if (ext._source.provider !== "native") continue;
 		if (isDisabledName(ext.name)) continue;
@@ -548,29 +562,31 @@ export async function discoverAndLoadExtensions(
 	}
 
 	// 2. Discover extension entry points from installed plugins (node_modules path)
-	addPaths(await getAllPluginExtensionPaths(cwd));
+	addPaths(await logger.time("ext:pluginPaths", () => getAllPluginExtensionPaths(cwd)));
 
 	// 2b. Discover extension entry points from marketplace-cached plugins
-	for (const root of getPreloadedPluginRoots()) {
-		try {
-			const pkgPath = path.join(root.path, "package.json");
-			const pkg = await Bun.file(pkgPath).json();
-			const manifest = pkg?.xcsh ?? pkg?.pi;
-			const extensions = manifest?.extensions;
-			if (Array.isArray(extensions)) {
-				for (const entry of extensions) {
-					if (typeof entry !== "string") continue;
-					if (path.isAbsolute(entry) || entry.includes("..")) continue;
-					const resolved = path.resolve(root.path, entry);
-					if (!resolved.startsWith(root.path + path.sep) && resolved !== root.path) continue;
-					if (isDisabledName(getExtensionNameFromPath(resolved))) continue;
-					addPath(resolved);
+	await logger.time("ext:marketplaceRoots", async () => {
+		for (const root of getPreloadedPluginRoots()) {
+			try {
+				const pkgPath = path.join(root.path, "package.json");
+				const pkg = await Bun.file(pkgPath).json();
+				const manifest = pkg?.xcsh ?? pkg?.pi;
+				const extensions = manifest?.extensions;
+				if (Array.isArray(extensions)) {
+					for (const entry of extensions) {
+						if (typeof entry !== "string") continue;
+						if (path.isAbsolute(entry) || entry.includes("..")) continue;
+						const resolved = path.resolve(root.path, entry);
+						if (!resolved.startsWith(root.path + path.sep) && resolved !== root.path) continue;
+						if (isDisabledName(getExtensionNameFromPath(resolved))) continue;
+						addPath(resolved);
+					}
 				}
+			} catch {
+				// No package.json or invalid — skip
 			}
-		} catch {
-			// No package.json or invalid — skip
 		}
-	}
+	});
 
 	// 3. Explicitly configured paths
 	for (const configuredPath of configuredPaths) {
@@ -601,7 +617,7 @@ export async function discoverAndLoadExtensions(
 	}
 
 	const resolvedEventBus = eventBus ?? new EventBus();
-	const result = await loadExtensions(allPaths, cwd, resolvedEventBus);
-	await loadBundledExtensions(result, cwd, resolvedEventBus, isDisabledName);
+	const result = await logger.time("ext:loadLoop", () => loadExtensions(allPaths, cwd, resolvedEventBus));
+	await logger.time("ext:loadBundled", () => loadBundledExtensions(result, cwd, resolvedEventBus, isDisabledName));
 	return result;
 }

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.56.2",
-	"commit": "864f91ecbd26a814dda896b5c402a0a30494e942",
-	"shortCommit": "864f91e",
+	"version": "19.57.1",
+	"commit": "afdece90c0203627849699502d77b189fd3fb320",
+	"shortCommit": "afdece9",
 	"branch": "main",
-	"tag": "v19.56.2",
-	"commitDate": "2026-07-04T00:19:20Z",
-	"buildDate": "2026-07-04T00:42:34.771Z",
+	"tag": "v19.57.1",
+	"commitDate": "2026-07-04T20:58:43Z",
+	"buildDate": "2026-07-04T21:21:44.204Z",
 	"dirty": true,
 	"prNumber": "",
 	"repoUrl": "https://github.com/f5-sales-demo/xcsh",
 	"repoSlug": "f5-sales-demo/xcsh",
-	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/864f91ecbd26a814dda896b5c402a0a30494e942",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.56.2"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/afdece90c0203627849699502d77b189fd3fb320",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.57.1"
 };

package/src/locales/ar.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "مثبتة",
 	"plugins.tabs.recommended": "موصى بها",
 	"plugins.tabs.discover": "استكشاف",

package/src/locales/de.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "Installiert",
 	"plugins.tabs.recommended": "Empfohlen",
 	"plugins.tabs.discover": "Entdecken",

package/src/locales/en.json

@@ -303,6 +303,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 
 	"plugins.tabs.installed": "Installed",
 	"plugins.tabs.recommended": "Recommended",

package/src/locales/es.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "Instalados",
 	"plugins.tabs.recommended": "Recomendados",
 	"plugins.tabs.discover": "Descubrir",

package/src/locales/fr.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "Installés",
 	"plugins.tabs.recommended": "Recommandés",
 	"plugins.tabs.discover": "Découvrir",

package/src/locales/hi.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "इंस्टॉल किए गए",
 	"plugins.tabs.recommended": "अनुशंसित",
 	"plugins.tabs.discover": "खोजें",

package/src/locales/it.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "Installati",
 	"plugins.tabs.recommended": "Consigliati",
 	"plugins.tabs.discover": "Scopri",

package/src/locales/ja.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "インストール済み",
 	"plugins.tabs.recommended": "推奨",
 	"plugins.tabs.discover": "検索",

package/src/locales/ko.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "설치됨",
 	"plugins.tabs.recommended": "권장",
 	"plugins.tabs.discover": "검색",

package/src/locales/pt-br.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "Instalados",
 	"plugins.tabs.recommended": "Recomendados",
 	"plugins.tabs.discover": "Descobrir",

package/src/locales/th.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "ติดตั้งแล้ว",
 	"plugins.tabs.recommended": "แนะนำ",
 	"plugins.tabs.discover": "ค้นหา",

package/src/locales/zh-cn.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "已安装",
 	"plugins.tabs.recommended": "推荐",
 	"plugins.tabs.discover": "发现",

package/src/locales/zh-tw.json

@@ -282,6 +282,8 @@
 	"login.wizard.configSaved": "Configuration saved. You're ready to go!",
 	"login.wizard.failed": "Connection failed — {error}",
 	"login.wizard.retryHint": "Press Escape to skip, or enter a new value:",
+	"gate.noProvider": "No LLM provider configured — run /login to connect one before sending a message.",
+	"gate.noProviderBlock": "No LLM provider configured. Run /login to connect one, then retry. (/help and /model still work.)",
 	"plugins.tabs.installed": "已安裝",
 	"plugins.tabs.recommended": "推薦",
 	"plugins.tabs.discover": "探索",

package/src/main.ts

@@ -165,33 +165,16 @@ async function runInteractiveMode(
 		versionCheckPromise.catch(() => undefined),
 		new Promise<string | undefined>(resolve => setTimeout(() => resolve(undefined), INITIAL_UPDATE_CHECK_TIMEOUT_MS)),
 	]);
-	const initialUpdateStatus = initialUpdateVersion
-		? { available: true, latestVersion: initialUpdateVersion }
-		: undefined;
-
-	const mode = new InteractiveMode(
-		session,
-		version,
-		initialUpdateStatus,
-		setExtensionUIContext,
-		lspServers,
-		mcpManager,
-		eventBus,
-	);
+
+	const mode = new InteractiveMode(session, version, setExtensionUIContext, lspServers, mcpManager, eventBus);
 
 	await mode.init();
 
-	if (!initialUpdateVersion) {
-		versionCheckPromise
-			.then(newVersion => {
-				if (!settings.get("startup.checkUpdate")) {
-					return;
-				}
-				if (newVersion) {
-					mode.setUpdateStatus({ available: true, latestVersion: newVersion });
-				}
-			})
-			.catch(() => {});
+	// Non-blocking, one-shot update notice: only surface it if the background check
+	// already resolved within the startup race (no waiting, no live re-render). If it
+	// resolves later, the update is available on demand via /plugins.
+	if (initialUpdateVersion && settings.get("startup.checkUpdate")) {
+		mode.showStatus(`Update available: v${initialUpdateVersion} — run: xcsh update`, { dim: true });
 	}
 
 	mode.renderInitialMessages();
@@ -717,34 +700,38 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 		sessionManager = await SessionManager.open(selectedPath);
 	}
 
-	// Refresh stale marketplace clones before loading plugins so extensions run latest code.
+	// Refresh stale marketplace clones in the background so startup never blocks on
+	// git/network. Upgraded plugin code applies on the next launch (same trade-off as
+	// the "notify" branch below). Offline/corrupt data is tolerated by the try/catch.
 	const autoUpdate = settings.get("marketplace.autoUpdate");
 	if (autoUpdate !== "off") {
-		try {
-			const startupMgr = new MarketplaceManager({
-				marketplacesRegistryPath: getMarketplacesRegistryPath(),
-				installedRegistryPath: getInstalledPluginsRegistryPath(),
-				projectInstalledRegistryPath: (await resolveActiveProjectRegistryPath(getProjectDir())) ?? undefined,
-				marketplacesCacheDir: getMarketplacesCacheDir(),
-				pluginsCacheDir: getPluginsCacheDir(),
-				clearPluginRootsCache: (extraPaths?: readonly string[]) => {
-					const h = os.homedir();
-					invalidateFsCache(path.join(h, getConfigDirName(), "plugins", "installed_plugins.json"));
-					for (const p of extraPaths ?? []) invalidateFsCache(p);
-					clearXcshPluginRootsCache();
-				},
-			});
-			await startupMgr.refreshStaleMarketplaces();
-			if (autoUpdate === "auto") {
-				const updates = await startupMgr.checkForUpdates();
-				if (updates.length > 0) {
-					await startupMgr.upgradeAllPlugins();
-					logger.debug(`Auto-upgraded ${updates.length} marketplace plugin(s) at startup`);
+		void (async () => {
+			try {
+				const startupMgr = new MarketplaceManager({
+					marketplacesRegistryPath: getMarketplacesRegistryPath(),
+					installedRegistryPath: getInstalledPluginsRegistryPath(),
+					projectInstalledRegistryPath: (await resolveActiveProjectRegistryPath(getProjectDir())) ?? undefined,
+					marketplacesCacheDir: getMarketplacesCacheDir(),
+					pluginsCacheDir: getPluginsCacheDir(),
+					clearPluginRootsCache: (extraPaths?: readonly string[]) => {
+						const h = os.homedir();
+						invalidateFsCache(path.join(h, getConfigDirName(), "plugins", "installed_plugins.json"));
+						for (const p of extraPaths ?? []) invalidateFsCache(p);
+						clearXcshPluginRootsCache();
+					},
+				});
+				await startupMgr.refreshStaleMarketplaces();
+				if (autoUpdate === "auto") {
+					const updates = await startupMgr.checkForUpdates();
+					if (updates.length > 0) {
+						await startupMgr.upgradeAllPlugins();
+						logger.debug(`Auto-upgraded ${updates.length} marketplace plugin(s) at startup`);
+					}
 				}
+			} catch {
+				// Network failure, corrupt data, offline — proceed with cached plugins.
 			}
-		} catch {
-			// Network failure, corrupt data, offline — proceed with cached plugins.
-		}
+		})();
 	}
 
 	// Wire --plugin-dir and preload plugin roots for sync consumers (LSP config)

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

@@ -1,17 +1,9 @@
 import type { Model } from "@f5-sales-demo/pi-ai";
 import { validateApiKeyAgainstModelsEndpoint } from "@f5-sales-demo/pi-ai/utils/oauth/api-key-validation";
 import { logger } from "@f5-sales-demo/pi-utils";
-import { MarketplaceManager } from "../../extensibility/plugins/marketplace";
-import {
-	getInstalledPluginsRegistryPath,
-	getMarketplacesCacheDir,
-	getMarketplacesRegistryPath,
-	getPluginsCacheDir,
-} from "../../extensibility/plugins/marketplace/registry";
 import { type AuthStatus, ContextService } from "../../services/xcsh-context";
 import { deriveTenantFromUrl } from "../../services/xcsh-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
@@ -75,6 +67,17 @@ export interface WelcomeCheckResult {
 /** Providers that don't store API keys (local inference servers) */
 const KEYLESS_PROVIDERS = new Set(["ollama", "llama.cpp", "lm-studio", "llamafile", "local"]);
 
+/**
+ * Instant, local check for whether the session has a usable LLM provider configured.
+ * Zero network: a model must be resolved and either be keyless (local inference) or
+ * have credentials present in the auth store. Used by the startup readiness gate to
+ * decide whether natural-language input can be processed.
+ */
+export function hasActiveLlmProvider(model: Model | undefined, authStorage: Pick<AuthStorage, "hasAuth">): boolean {
+	if (!model) return false;
+	return KEYLESS_PROVIDERS.has(model.provider) || authStorage.hasAuth(model.provider);
+}
+
 /**
  * Run blocking startup checks for the welcome screen.
  * Model check always runs. Context check only runs if model is connected.
@@ -215,99 +218,3 @@ export function mapContextStatus(status: WelcomeContextStatus): ServiceStatus {
 			}
 	}
 }
-
-export interface FixableService {
-	name: string;
-	prompt: string;
-	command: string[];
-	recheck: () => Promise<ServiceStatus>;
-}
-
-export type UnifiedPluginState = "connected" | "unauthenticated" | "unavailable" | "installed" | "not_installed";
-
-export interface UnifiedPluginStatus {
-	name: string;
-	state: UnifiedPluginState;
-	hint?: string;
-	group?: string;
-}
-
-export interface ServiceStatusContributionInput {
-	name: string;
-	group?: string;
-	check: () => Promise<{ state: ServiceState; hint?: string }>;
-}
-
-export async function buildUnifiedPluginList(
-	contributions: ServiceStatusContributionInput[],
-): Promise<UnifiedPluginStatus[]> {
-	const map = new Map<string, UnifiedPluginStatus>();
-
-	for (const contribution of contributions) {
-		try {
-			const status = await contribution.check();
-			map.set(contribution.name.toLowerCase(), {
-				name: contribution.name,
-				state: status.state,
-				hint: status.hint,
-				group: contribution.group,
-			});
-		} catch {
-			map.set(contribution.name.toLowerCase(), {
-				name: contribution.name,
-				state: "unavailable",
-				hint: "check failed",
-				group: contribution.group,
-			});
-		}
-	}
-
-	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));
-
-		for (const mkt of marketplaces) {
-			const available = await mgr.listAvailablePlugins(mkt.name).catch(() => []);
-			for (const entry of available) {
-				if (!entry.recommended) continue;
-				const displayName = normalizePluginDisplayName(entry.name);
-				const key = displayName.toLowerCase();
-				if (map.has(key)) continue;
-				const pluginId = `${entry.name}@${mkt.name}`;
-				map.set(key, {
-					name: displayName,
-					state: installedIds.has(pluginId) ? "installed" : "not_installed",
-					hint: installedIds.has(pluginId) ? undefined : "run: /plugin setup",
-				});
-			}
-		}
-	} catch (err) {
-		logger.debug("buildUnifiedPluginList marketplace check failed", { error: String(err) });
-	}
-
-	const stateOrder: Record<UnifiedPluginState, number> = {
-		connected: 0,
-		unauthenticated: 1,
-		unavailable: 2,
-		installed: 3,
-		not_installed: 4,
-	};
-
-	return [...map.values()].sort((a, b) => {
-		const orderDiff = stateOrder[a.state] - stateOrder[b.state];
-		if (orderDiff !== 0) return orderDiff;
-		return a.name.localeCompare(b.name);
-	});
-}

package/src/modes/components/welcome.ts

@@ -1,92 +1,53 @@
 import { type Component, padding, truncateToWidth, visibleWidth } from "@f5-sales-demo/pi-tui";
-import { APP_NAME, t } from "@f5-sales-demo/pi-utils";
+import { APP_NAME } from "@f5-sales-demo/pi-utils";
 import { theme } from "../../modes/theme/theme";
-import { formatStatusIcon } from "../../services/xcsh-context-indicators";
-import type { ModelStatus, ServiceStatus, UnifiedPluginStatus } from "./welcome-checks";
-
-export interface UpdateStatus {
-	available: boolean;
-	latestVersion?: string;
-}
 
+/**
+ * Startup splash: the F5 logo under a ` xcsh vX.Y.Z ` title bar. Intentionally
+ * static and status-free — session/provider/plugin status lives in on-demand
+ * commands (/plugins, /context) so startup stays instant and never blocks or
+ * live-updates. See docs/superpowers/specs for the fast-startup design.
+ */
 export class WelcomeComponent implements Component {
-	constructor(
-		private readonly version: string,
-		private modelStatus: ModelStatus,
-		private services: ServiceStatus[] = [],
-		private updateStatus?: UpdateStatus,
-		private plugins: UnifiedPluginStatus[] = [],
-	) {}
+	constructor(private readonly version: string) {}
 	invalidate(): void {}
-	setModelStatus(status: ModelStatus): void {
-		this.modelStatus = status;
-	}
-	setServices(services: ServiceStatus[]): void {
-		this.services = services;
-	}
-	setUpdateStatus(status: UpdateStatus | undefined): void {
-		this.updateStatus = status;
-	}
-	setPlugins(plugins: UnifiedPluginStatus[]): void {
-		this.plugins = plugins;
-	}
 
 	render(termWidth: number): string[] {
-		const minLeftCol = 48;
-		const minRightCol = 20;
 		const preferredLeftCol = 50;
+		const logoMaxWidth = 46;
 
-		// Content-driven right column width
-		const naturalRight = this.#measureStatusWidth() + 1; // +1 right padding
-		const idealRight = Math.max(naturalRight, minRightCol);
-		const idealBox = preferredLeftCol + idealRight + 3; // 3 border chars: │ + │ + │
-		const boxWidth = Math.min(idealBox, Math.max(0, termWidth - 2));
+		const boxWidth = Math.min(preferredLeftCol + 2, Math.max(0, termWidth - 2));
 		if (boxWidth < 4) return [];
-
-		const dualContentWidth = boxWidth - 3;
-		// When terminal is narrower than ideal, shrink left column toward minLeftCol first
-		const dualLeftCol =
-			dualContentWidth >= preferredLeftCol + idealRight
-				? preferredLeftCol
-				: Math.max(minLeftCol, dualContentWidth - idealRight);
-		const dualRightCol = Math.max(0, dualContentWidth - dualLeftCol);
-		// Only show dual column when both columns have enough room for their content
-		const showRightColumn = dualLeftCol >= minLeftCol && dualRightCol >= Math.max(minRightCol, naturalRight);
-		const leftCol = showRightColumn ? dualLeftCol : boxWidth - 2;
-		const rightCol = showRightColumn ? dualRightCol : 0;
+		const leftCol = boxWidth - 2;
 
 		// biome-ignore format: preserve ASCII art layout
 		const f5Logo = [
 			"                   ________",
-			"              (\u2592\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2592)",
-			"         (\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592)",
-			"      (\u2592\u2592\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588)",
-			"    (\u2592\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2592\u2592\u2592\u2592\u2592\u2588\u2588\u2588\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2592)",
-			"   (\u2592\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2592\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2593\u2588\u2588\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2593\u2592)",
-			"  (\u2592\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592)",
-			" (\u2592\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2592)",
-			"(\u2592\u2593\u2593\u2593\u2592\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2592\u2592\u2592\u2592\u2592\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2592)",
-			"|\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2592|",
-			"|\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2592|",
-			"(\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2592\u2592)",
-			" (\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2588\u2588\u2588\u2588\u2592\u2592)",
-			"  (\u2592\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2592\u2592)",
-			"   (\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2588\u2588\u2588\u2592\u2592\u2592)",
-			"    (\u2592\u2592\u2592\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2593\u2593\u2592\u2592\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2592\u2592\u2593\u2592)",
-			"      (\u2592\u2593\u2593\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2592\u2593\u2592)",
-			"         (\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592)",
-			"              (\u2592\u2592\u2592\u2592\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2593\u2592\u2592\u2592\u2592)",
+			"              (▒▒▒▒▓▓▓▓▓▓▓▓▒▒▒▒)",
+			"         (▒▒▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒)",
+			"      (▒▒▓▓▓▓██████████▓▓▓▓███████████████)",
+			"    (▒▓▓▓▓██████▒▒▒▒▒███▓▓█████████████████▒)",
+			"   (▒▓▓▓▓██████▒▓▓▓▓▓▒▒▒▓██▒▒▒▒▒▒▒▒▒▒▒▒▒▓▒)",
+			"  (▒▓▓▓▓▓██████▓▓▓▓▓▓▓▓▓██▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒)",
+			" (▒▓▓████████████████▓▓▓▓████████████▓▓▓▓▓▓▒)",
+			"(▒▓▓▓▒▒▒███████▒▒▒▒▒▓▓▓████████████████▓▓▓▓▓▒)",
+			"|▒▓▓▓▓▓▓▒██████▓▓▓▓▓▓▓████████████████████▓▓▒|",
+			"|▒▓▓▓▓▓▓▓██████▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒██████████▓▒|",
+			"(▒▓▓▓▓▓▓▓██████▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒██████████▒▒)",
+			" (▒▓▓▓▓▓▓██████▓▓▓▓▓▓▓███▓▓▓▓▓▓▓▓▓▒▒▒████▒▒)",
+			"  (▒▓▓▓▓▓██████▓▓▓▓▓▓██████▓▓▓▓▓▓▓▓▓▓▓▓████▒▒)",
+			"   (▒▒██████████▓▓▓▓▓▒██████▓▓▓▓▓▓▓▓██████▒▒▒)",
+			"    (▒▒▒▒▒██████████▓▓▒▒██████████████▒▒▓▒)",
+			"      (▒▓▓▒▒▒▒▒▒▒▒▒▒▒▓▓▓▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▒)",
+			"         (▒▒▒▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒)",
+			"              (▒▒▒▒▓▓▓▓▓▓▓▓▒▒▒▒)",
 		];
 
 		const logoColored = f5Logo.map(line => this.#f5ColorLine(line));
-		const logoMaxWidth = 46;
 		const logoBlockPad = Math.max(0, Math.floor((leftCol - logoMaxWidth) / 2));
 		const logoPadStr = padding(logoBlockPad);
-		const leftLines = [...logoColored.map(l => logoPadStr + l), ""];
-		const rightLines = this.#buildStatusLines(showRightColumn ? rightCol : leftCol);
-		if (!showRightColumn) {
-			leftLines.push(...rightLines);
-		}
+		const contentLines = [...logoColored.map(l => logoPadStr + l), ""];
+
 		const border = (s: string) => theme.fg("borderMuted", s);
 		const hChar = theme.boxRound.horizontal;
 		const h = border(hChar);
@@ -95,6 +56,7 @@ export class WelcomeComponent implements Component {
 		const tr = border(theme.boxRound.topRight);
 		const bl = border(theme.boxRound.bottomLeft);
 		const br = border(theme.boxRound.bottomRight);
+
 		const lines: string[] = [];
 		const title = ` ${APP_NAME} v${this.version} `;
 		const titlePrefixRaw = hChar.repeat(3);
@@ -106,125 +68,13 @@ export class WelcomeComponent implements Component {
 		} else {
 			lines.push(tl + titleStyled + border(hChar.repeat(titleSpace - titleVisLen)) + tr);
 		}
-		const maxRows = showRightColumn ? Math.max(leftLines.length, rightLines.length) : leftLines.length;
-		for (let i = 0; i < maxRows; i++) {
-			const left = this.#fitToWidth(leftLines[i] ?? "", leftCol);
-			if (showRightColumn) {
-				const right = this.#fitToWidth(rightLines[i] ?? "", rightCol);
-				lines.push(v + left + v + right + v);
-			} else {
-				lines.push(v + left + v);
-			}
-		}
-		if (showRightColumn) {
-			lines.push(bl + h.repeat(leftCol) + border(theme.boxSharp.teeUp) + h.repeat(rightCol) + br);
-		} else {
-			lines.push(bl + h.repeat(leftCol) + br);
-		}
-		return lines;
-	}
-
-	#measureStatusWidth(): number {
-		const lines: string[] = [` ${t("welcome.modelProvider")}`, ...this.#renderModelStatus()];
-		const coreServices = this.services.filter(s => !s._isPlugin);
-		for (const svc of coreServices) {
-			lines.push(this.#renderServiceLine(svc));
-		}
-		if (this.plugins.length > 0) {
-			lines.push(` ${t("welcome.plugins")}`);
-			for (const p of this.plugins) {
-				lines.push(this.#renderUnifiedPluginLine(p));
-			}
-		}
-		if (this.#showUpdateSection()) {
-			lines.push(this.#renderUpdateLine());
-		}
-		return Math.max(...lines.map(l => visibleWidth(l)));
-	}
-
-	#renderUnifiedPluginLine(plugin: UnifiedPluginStatus): string {
-		if (plugin.state === "connected" || plugin.state === "installed") {
-			return ` ${formatStatusIcon("connected")} ${theme.fg("muted", plugin.name)}`;
-		}
-		if (plugin.state === "not_installed") {
-			return ` ${theme.fg("dim", "·")} ${theme.fg("dim", plugin.name)}`;
+		for (const line of contentLines) {
+			lines.push(v + this.#fitToWidth(line, leftCol) + v);
 		}
-		const hint = plugin.hint ?? "";
-		return ` ${formatStatusIcon("warning")} ${theme.fg("muted", plugin.name)}  ${theme.fg("dim", hint)}`;
-	}
-
-	#buildStatusLines(rightCol: number): string[] {
-		const lines: string[] = [];
-		const separatorWidth = Math.max(0, rightCol - 2);
-		const separator = ` ${theme.fg("muted", theme.boxRound.horizontal.repeat(separatorWidth))}`;
-		lines.push("");
-		lines.push(` ${theme.bold(theme.fg("contentAccent", t("welcome.modelProvider")))}`);
-		lines.push(...this.#renderModelStatus());
-		lines.push("");
-		const coreServices = this.services.filter(s => !s._isPlugin);
-		const hasContent = coreServices.length > 0 || this.plugins.length > 0 || this.#showUpdateSection();
-		if (hasContent) {
-			lines.push(separator);
-			for (const svc of coreServices) {
-				lines.push(this.#renderServiceLine(svc));
-			}
-			if (this.plugins.length > 0) {
-				lines.push("");
-				lines.push(` ${theme.fg("dim", t("welcome.plugins"))}`);
-				for (const p of this.plugins) {
-					lines.push(this.#renderUnifiedPluginLine(p));
-				}
-				const missing = this.plugins.filter(p => p.state === "not_installed");
-				if (missing.length > 0) {
-					lines.push(`   ${theme.fg("dim", t("welcome.pluginSetupHint"))}`);
-				}
-			}
-
-			if (this.#showUpdateSection()) {
-				lines.push(this.#renderUpdateLine());
-			}
-		}
-		lines.push("");
+		lines.push(bl + h.repeat(leftCol) + br);
 		return lines;
 	}
 
-	#showUpdateSection(): boolean {
-		return this.updateStatus?.available === true;
-	}
-
-	#renderServiceLine(service: ServiceStatus): string {
-		if (service.state === "connected") {
-			return ` ${formatStatusIcon("connected")} ${theme.fg("muted", service.name)}`;
-		}
-		const hint = service.hint ?? "";
-		return ` ${formatStatusIcon("warning")} ${theme.fg("muted", service.name)}  ${theme.fg("dim", hint)}`;
-	}
-
-	#renderUpdateLine(): string {
-		const latest = this.updateStatus?.latestVersion;
-		const label = latest ? `v${latest}` : t("welcome.newVersion");
-		return ` ${theme.fg("warning", "↑")} ${theme.fg("muted", label)}  ${theme.fg("dim", t("welcome.updateHint"))}`;
-	}
-
-	#renderModelStatus(): string[] {
-		const { state, provider } = this.modelStatus;
-		const p = provider ?? "unknown";
-		switch (state) {
-			case "connected":
-				return [` ${formatStatusIcon("connected")} ${theme.fg("muted", p)}`];
-			case "auth_error":
-				return [
-					` ${formatStatusIcon("error")} ${theme.fg("muted", p)} ${theme.fg("error", t("welcome.connectionFailed"))}`,
-					`   ${theme.fg("dim", t("welcome.runLoginReconnect"))}`,
-				];
-			case "no_provider":
-				return [
-					` ${formatStatusIcon("error")} ${theme.fg("error", t("welcome.noModelProvider"))}`,
-					`   ${theme.fg("dim", t("welcome.runLoginConnect"))}`,
-				];
-		}
-	}
-
 	#f5ColorLine(line: string): string {
 		const red = "\x1b[38;5;160m";
 		const white = "\x1b[1;37m";
@@ -236,9 +86,9 @@ export class WelcomeComponent implements Component {
 		const reset = "\x1b[0m";
 		let result = "";
 		for (const char of line) {
-			if (char === "\u2593") result += `${red}\u2588${reset}`;
-			else if (char === "\u2588") result += `${white}\u2588${reset}`;
-			else if (char === "\u2592") result += `${red}${shadowBg}\u2592${reset}`;
+			if (char === "▓") result += `${red}█${reset}`;
+			else if (char === "█") result += `${white}█${reset}`;
+			else if (char === "▒") result += `${red}${shadowBg}▒${reset}`;
 			else if ("()|_".includes(char)) result += `${red}${char}${reset}`;
 			else result += char;
 		}
@@ -248,7 +98,7 @@ export class WelcomeComponent implements Component {
 	#fitToWidth(str: string, width: number): string {
 		const visLen = visibleWidth(str);
 		if (visLen > width) {
-			const ellipsis = "\u2026";
+			const ellipsis = "…";
 			const maxW = Math.max(0, width - visibleWidth(ellipsis));
 			let t = "";
 			let cw = 0;

package/src/modes/controllers/input-controller.ts

@@ -3,7 +3,7 @@ import * as path from "node:path";
 import { type AgentMessage, ThinkingLevel } from "@f5-sales-demo/pi-agent-core";
 import { sanitizeText } from "@f5-sales-demo/pi-natives";
 import { type AutocompleteProvider, ChordDispatcher, type SlashCommand } from "@f5-sales-demo/pi-tui";
-import { $env } from "@f5-sales-demo/pi-utils";
+import { $env, t } from "@f5-sales-demo/pi-utils";
 import { settings } from "../../config/settings";
 import { createStreamingAssistantGutter } from "../../modes/components/gutter-block";
 import { createPromptActionAutocompleteProvider } from "../../modes/prompt-action-autocomplete";
@@ -374,6 +374,16 @@ export class InputController {
 				}
 			}
 
+			// LLM readiness gate: without a configured provider, natural language
+			// cannot be processed. Slash/skill/bash/python commands are handled and
+			// returned above, so only genuine natural language reaches here — block it
+			// with a clear /login prompt and preserve the user's text.
+			if (!this.ctx.hasActiveLlmProvider()) {
+				this.ctx.showWarning(t("gate.noProviderBlock"));
+				this.ctx.editor.setText(text);
+				return;
+			}
+
 			// Queue input during compaction
 			if (this.ctx.session.isCompacting) {
 				if (this.ctx.pendingImages.length > 0) {
@@ -479,6 +489,12 @@ export class InputController {
 		const text = this.ctx.editor.getText().trim();
 		if (!text) return;
 
+		// LLM readiness gate — a follow-up is still natural language for the model.
+		if (!this.ctx.hasActiveLlmProvider()) {
+			this.ctx.showWarning(t("gate.noProviderBlock"));
+			return;
+		}
+
 		if (this.ctx.session.isCompacting) {
 			this.ctx.queueCompactionMessage(text, "followUp");
 			return;

package/src/modes/controllers/login-model.ts

@@ -0,0 +1,32 @@
+import type { Model } from "@f5-sales-demo/pi-ai";
+
+/**
+ * Minimal session surface needed to apply a model after a successful login.
+ * Kept structural so the login flow can call it without pulling in the full
+ * AgentSession type, and so it stays trivially unit-testable.
+ */
+interface ModelApplicableSession {
+	model: Model | undefined;
+	modelRegistry: { getAll(): Model[] };
+	setModel(model: Model, role: "default", options?: { selector?: string }): Promise<void>;
+}
+
+/**
+ * After a successful `/login`, make the freshly-configured provider immediately
+ * usable by setting it as the session's default model — but only when the session
+ * has no model yet, so we never override a model the user already chose.
+ *
+ * Returns true when a model was applied. The login wizard auto-selects a model id
+ * from the provider's /models list; resolving it here (post-registry-refresh) is
+ * what lets the LLM readiness gate lift without a manual `/model` step.
+ */
+export async function applyModelAfterLogin(
+	session: ModelApplicableSession,
+	selectedModelId: string | undefined,
+): Promise<boolean> {
+	if (session.model || !selectedModelId) return false;
+	const resolved = session.modelRegistry.getAll().find(m => m.id === selectedModelId);
+	if (!resolved) return false;
+	await session.setModel(resolved, "default", { selector: resolved.id });
+	return true;
+}

package/src/modes/controllers/selector-controller.ts

@@ -58,6 +58,7 @@ import { ToolExecutionComponent } from "../components/tool-execution";
 import { TreeSelectorComponent } from "../components/tree-selector";
 import { UserMessageSelectorComponent } from "../components/user-message-selector";
 import type { SessionObserverRegistry } from "../session-observer-registry";
+import { applyModelAfterLogin } from "./login-model";
 
 const CALLBACK_SERVER_PROVIDERS = new Set<OAuthProvider>([
 	"anthropic",
@@ -1173,6 +1174,9 @@ export class SelectorController {
 					healConfigYmlModelRoles(configPath);
 
 					await this.ctx.session.modelRegistry.refresh("online");
+					// Make the freshly-configured provider usable immediately so the LLM
+					// readiness gate lifts without requiring a manual /model selection.
+					await applyModelAfterLogin(this.ctx.session, selectedModel);
 					await this.ctx.refreshWelcomeAfterLogin();
 					probeSuccess = true;
 				} else {

package/src/modes/interactive-mode.ts

@@ -15,7 +15,7 @@ import {
 } from "@f5-sales-demo/pi-ai";
 import type { Component, SlashCommand } from "@f5-sales-demo/pi-tui";
 import { Container, Loader, Markdown, ProcessTerminal, Spacer, Text, TUI, visibleWidth } from "@f5-sales-demo/pi-tui";
-import { getProjectDir, hsvToRgb, isEnoent, logger, postmortem, prompt } from "@f5-sales-demo/pi-utils";
+import { getProjectDir, hsvToRgb, isEnoent, logger, postmortem, prompt, t } from "@f5-sales-demo/pi-utils";
 import chalk from "chalk";
 import { KeybindingsManager } from "../config/keybindings";
 import { type Settings, settings } from "../config/settings";
@@ -32,7 +32,6 @@ import { seedComputerProfile } from "../internal-urls/computer-profile";
 import { reconcileFromCollectors } from "../internal-urls/user-profile";
 import { renameApprovedPlanFile } from "../plan-mode/approved-plan";
 import planModeApprovedPrompt from "../prompts/system/plan-mode-approved.md" with { type: "text" };
-import { ContextService } from "../services/xcsh-context";
 import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
 import { HistoryStorage } from "../session/history-storage";
 import type { SessionContext, SessionManager } from "../session/session-manager";
@@ -52,14 +51,8 @@ import type { HookSelectorComponent } from "./components/hook-selector";
 import type { PythonExecutionComponent } from "./components/python-execution";
 import { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
-import { type UpdateStatus, WelcomeComponent } from "./components/welcome";
-import {
-	buildUnifiedPluginList,
-	type FixableService,
-	mapContextStatus,
-	runWelcomeChecks,
-	type ServiceStatus,
-} from "./components/welcome-checks";
+import { WelcomeComponent } from "./components/welcome";
+import { hasActiveLlmProvider } from "./components/welcome-checks";
 import { BtwController } from "./controllers/btw-controller";
 import { CommandController } from "./controllers/command-controller";
 import { EventController } from "./controllers/event-controller";
@@ -170,7 +163,6 @@ export class InteractiveMode implements InteractiveModeContext {
 	#pendingSlashCommands: SlashCommand[] = [];
 	#cleanupUnsubscribe?: () => void;
 	readonly #version: string;
-	readonly #initialUpdateStatus: UpdateStatus | undefined;
 	#planModePreviousTools: string[] | undefined;
 	#planModePreviousModelState: { model: Model; thinkingLevel?: ThinkingLevel } | undefined;
 	#pendingModelSwitch: { model: Model; thinkingLevel?: ThinkingLevel } | undefined;
@@ -197,12 +189,10 @@ export class InteractiveMode implements InteractiveModeContext {
 	#eventBus?: EventBus;
 	#eventBusUnsubscribers: Array<() => void> = [];
 	#welcomeComponent?: WelcomeComponent;
-	#currentPlugins: import("./components/welcome-checks").UnifiedPluginStatus[] = [];
 
 	constructor(
 		session: AgentSession,
 		version: string,
-		initialUpdateStatus: UpdateStatus | undefined = undefined,
 		setToolUIContext: (uiContext: ExtensionUIContext, hasUI: boolean) => void = () => {},
 		lspServers?: import("../tools").LspStartupServerInfo[],
 		mcpManager?: import("../mcp").MCPManager,
@@ -214,7 +204,6 @@ export class InteractiveMode implements InteractiveModeContext {
 		this.keybindings = KeybindingsManager.inMemory();
 		this.agent = session.agent;
 		this.#version = version;
-		this.#initialUpdateStatus = initialUpdateStatus;
 		this.#toolUiContextSetter = setToolUIContext;
 		this.lspServers = lspServers;
 		this.mcpManager = mcpManager;
@@ -317,11 +306,6 @@ export class InteractiveMode implements InteractiveModeContext {
 			getProjectDir(),
 		);
 
-		// Run blocking welcome screen status checks
-		const welcomeResult = await logger.time("InteractiveMode.init:welcomeChecks", () =>
-			runWelcomeChecks(this.session.model, this.session.modelRegistry.authStorage),
-		);
-
 		// Refresh user profile in background — fire and forget
 		reconcileFromCollectors().catch(err => logger.warn("Background profile refresh failed", { error: String(err) }));
 		// Refresh computer profile in background — fire and forget
@@ -337,60 +321,20 @@ export class InteractiveMode implements InteractiveModeContext {
 			this.ui.addChild(new Spacer(1));
 		}
 
-		// When model is not connected, the wizard will auto-launch — show a clean
-		// welcome screen without plugins or confusing provider names.
-		const needsLogin = welcomeResult.model.state === "no_provider" || welcomeResult.model.state === "auth_error";
-		const welcomeModelStatus = needsLogin
-			? { state: "no_provider" as const, provider: undefined }
-			: welcomeResult.model;
-
-		const services: ServiceStatus[] =
-			!startupQuiet && !needsLogin ? [mapContextStatus(welcomeResult.context ?? { state: "no_context" })] : [];
-
-		// Build unified plugin list from service status contributions + marketplace
-		// Skip when model is not configured — nothing works without a model.
-		const pluginContributions = this.session.extensionRunner?.getAllRegisteredServiceStatuses() ?? [];
-		const plugins =
-			!startupQuiet && !needsLogin ? await buildUnifiedPluginList(pluginContributions).catch(() => []) : [];
-		this.#currentPlugins = plugins;
-
-		const fixableServices: FixableService[] = [];
-		if (!needsLogin) {
-			for (const contribution of pluginContributions) {
-				if (contribution.fix) {
-					const plugin = plugins.find(p => p.name.toLowerCase() === contribution.name.toLowerCase());
-					if (plugin && plugin.state === "unauthenticated") {
-						fixableServices.push({
-							name: contribution.name,
-							prompt: contribution.fix.prompt,
-							command: contribution.fix.command,
-							recheck: async () => {
-								try {
-									const result = await contribution.check();
-									return { name: contribution.name, ...result };
-								} catch {
-									return { name: contribution.name, state: "unavailable" as const, hint: "recheck failed" };
-								}
-							},
-						});
-					}
-				}
-			}
-		}
+		// LLM readiness gate: instant, local check (no network). When no provider is
+		// configured we still initialize immediately, but warn the user to /login —
+		// natural-language input is blocked until then (enforced in input-controller).
+		const needsLogin = !hasActiveLlmProvider(this.session.model, this.session.modelRegistry.authStorage);
 
 		if (!startupQuiet) {
-			this.#welcomeComponent = new WelcomeComponent(
-				this.#version,
-				welcomeModelStatus,
-				services,
-				this.#initialUpdateStatus,
-				plugins,
-			);
-
-			// Setup UI layout
+			this.#welcomeComponent = new WelcomeComponent(this.#version);
 			this.ui.addChild(new Spacer(1));
 			this.ui.addChild(this.#welcomeComponent);
 			this.ui.addChild(new Spacer(1));
+			if (needsLogin) {
+				this.ui.addChild(new Text(theme.fg("warning", t("gate.noProvider")), 1, 0));
+				this.ui.addChild(new Spacer(1));
+			}
 		}
 
 		this.ui.addChild(this.chatContainer);
@@ -436,15 +380,6 @@ export class InteractiveMode implements InteractiveModeContext {
 		// Initialize hooks with TUI-based UI context
 		await this.initHooksAndCustomTools();
 
-		// Offer to fix expired cloud credentials before entering the main loop
-		if (fixableServices.length > 0) {
-			await this.#offerCredentialFixes(fixableServices, services);
-			// Clear any gibberish that accumulated in the editor during the
-			// stop/start cycles (Kitty protocol re-negotiation can leave
-			// raw escape sequences in the input buffer).
-			this.editor.setText("");
-		}
-
 		// Restore mode from session (e.g. plan mode on resume)
 		await this.#restoreModeFromSession();
 
@@ -944,52 +879,6 @@ export class InteractiveMode implements InteractiveModeContext {
 		}
 	}
 
-	async #offerCredentialFixes(fixable: FixableService[], currentServices: ServiceStatus[]): Promise<void> {
-		for (const service of fixable) {
-			const confirmed = await this.#extensionUiController.showHookConfirm(
-				`${service.name} login`,
-				`${service.prompt}. Fix now?`,
-			);
-			if (!confirmed) continue;
-
-			// Drain pending terminal input (e.g. an in-flight OSC 11 poll response)
-			// before dropping raw mode, so it is consumed here instead of echoed as
-			// gibberish by the terminal while the cooked-mode subprocess runs.
-			await this.ui.suspendForSubprocess();
-			try {
-				const proc = Bun.spawn(service.command, {
-					stdin: "inherit",
-					stdout: "inherit",
-					stderr: "inherit",
-				});
-				await proc.exited;
-			} catch (error) {
-				logger.warn(`Auto-fix for ${service.name} failed`, { error: String(error) });
-			} finally {
-				const clearScreen = settings.get("startup.clearScreen");
-				this.ui.start(clearScreen);
-				this.ui.requestRender(true);
-			}
-
-			const updated = await service.recheck();
-			const idx = currentServices.findIndex(s => s.name === service.name);
-			if (idx !== -1) {
-				currentServices[idx] = updated;
-				this.#welcomeComponent?.setServices([...currentServices]);
-			}
-			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();
-		}
-	}
-
 	async #approvePlan(
 		planContent: string,
 		options: { planFilePath: string; finalPlanFilePath: string },
@@ -1208,6 +1097,10 @@ export class InteractiveMode implements InteractiveModeContext {
 		this.#uiHelpers.showWarning(message);
 	}
 
+	hasActiveLlmProvider(): boolean {
+		return hasActiveLlmProvider(this.session.model, this.session.modelRegistry.authStorage);
+	}
+
 	ensureLoadingAnimation(): void {
 		if (!this.loadingAnimation) {
 			this.statusContainer.clear();
@@ -1251,11 +1144,6 @@ export class InteractiveMode implements InteractiveModeContext {
 		this.setWorkingMessage(message);
 	}
 
-	setUpdateStatus(status: UpdateStatus | undefined): void {
-		this.#welcomeComponent?.setUpdateStatus(status);
-		this.ui.requestRender();
-	}
-
 	clearEditor(): void {
 		this.#uiHelpers.clearEditor();
 	}
@@ -1471,42 +1359,8 @@ export class InteractiveMode implements InteractiveModeContext {
 	}
 
 	async refreshWelcomeAfterLogin(): Promise<void> {
-		this.#welcomeComponent?.setModelStatus({ state: "connected", provider: "anthropic" });
-
-		// Validate F5 XC Context independently — call validateToken() for a live
-		// check instead of reading cached state (which may be "unknown" if
-		// validation hasn't run yet in this session).
-		const services: ServiceStatus[] = [];
-		try {
-			const ctxService = ContextService.instance;
-			const ctxStatus = ctxService.getStatus();
-			if (ctxStatus.isConfigured) {
-				const name = ctxStatus.activeContextTenant ?? ctxStatus.activeContextName ?? undefined;
-				const result = await ctxService.validateToken({ timeoutMs: 5000 });
-				services.push(
-					mapContextStatus({
-						state:
-							result.status === "connected"
-								? "connected"
-								: result.status === "auth_error"
-									? "auth_error"
-									: "offline",
-						name,
-					}),
-				);
-			}
-		} catch {
-			// ContextService not initialized — skip
-		}
-		this.#welcomeComponent?.setServices(services);
-
-		// Run plugin checks and update the welcome screen
-		const pluginContributions = this.session.extensionRunner?.getAllRegisteredServiceStatuses() ?? [];
-		const plugins = await buildUnifiedPluginList(pluginContributions).catch(() => []);
-		this.#currentPlugins = plugins;
-		this.#welcomeComponent?.setPlugins(plugins);
-
-		// Restore editor
+		// The welcome splash is static (logo + version only); after login the model
+		// gate lifts on its own (see applyModelAfterLogin). Just restore the editor.
 		this.editorContainer.clear();
 		this.editorContainer.addChild(this.editor);
 		this.ui.setFocus(this.editor);

package/src/modes/types.ts

@@ -137,6 +137,8 @@ export interface InteractiveModeContext {
 	showStatus(message: string, options?: { dim?: boolean }): void;
 	showError(message: string): void;
 	showWarning(message: string): void;
+	/** Instant, local check for whether a usable LLM provider is configured (no network). */
+	hasActiveLlmProvider(): boolean;
 	clearEditor(): void;
 	updatePendingMessagesDisplay(): void;
 	queueCompactionMessage(text: string, mode: "steer" | "followUp"): void;