@f5-sales-demo/xcsh 19.58.0 → 19.58.1

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@f5-sales-demo/xcsh",
-	"version": "19.58.0",
+	"version": "19.58.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.58.0",
-		"@f5-sales-demo/pi-agent-core": "19.58.0",
-		"@f5-sales-demo/pi-ai": "19.58.0",
-		"@f5-sales-demo/pi-natives": "19.58.0",
-		"@f5-sales-demo/pi-resource-management": "19.58.0",
-		"@f5-sales-demo/pi-tui": "19.58.0",
-		"@f5-sales-demo/pi-utils": "19.58.0",
+		"@f5-sales-demo/xcsh-stats": "19.58.1",
+		"@f5-sales-demo/pi-agent-core": "19.58.1",
+		"@f5-sales-demo/pi-ai": "19.58.1",
+		"@f5-sales-demo/pi-natives": "19.58.1",
+		"@f5-sales-demo/pi-resource-management": "19.58.1",
+		"@f5-sales-demo/pi-tui": "19.58.1",
+		"@f5-sales-demo/pi-utils": "19.58.1",
 		"@sinclair/typebox": "^0.34",
 		"@xterm/headless": "^6.0",
 		"ajv": "^8.20",

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

@@ -17,17 +17,17 @@ export interface BuildInfo {
 }
 
 export const BUILD_INFO: BuildInfo = {
-	"version": "19.58.0",
-	"commit": "def3667fcf2f20c14de7b9ab37b29e85b390e5c4",
-	"shortCommit": "def3667",
+	"version": "19.58.1",
+	"commit": "f72a3fa845f24642e4db4d84aa427bb2e2d64538",
+	"shortCommit": "f72a3fa",
 	"branch": "main",
-	"tag": "v19.58.0",
-	"commitDate": "2026-07-05T03:37:49Z",
-	"buildDate": "2026-07-05T04:00:08.049Z",
+	"tag": "v19.58.1",
+	"commitDate": "2026-07-05T13:33:19Z",
+	"buildDate": "2026-07-05T13:53:37.495Z",
 	"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/def3667fcf2f20c14de7b9ab37b29e85b390e5c4",
-	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.58.0"
+	"commitUrl": "https://github.com/f5-sales-demo/xcsh/commit/f72a3fa845f24642e4db4d84aa427bb2e2d64538",
+	"releaseUrl": "https://github.com/f5-sales-demo/xcsh/releases/tag/v19.58.1"
 };

package/src/main.ts

@@ -57,6 +57,7 @@ import type { SubmittedUserInput } from "./modes/types";
 import { type CreateAgentSessionOptions, createAgentSession, discoverAuthStorage } from "./sdk";
 import type { AgentSession } from "./session/agent-session";
 import { resolveResumableSession, type SessionInfo, SessionManager } from "./session/session-manager";
+import { profileDump, profileMark } from "./startup-profile";
 import { resolvePromptInput } from "./system-prompt";
 import type { LspStartupServerInfo } from "./tools";
 import type { EventBus } from "./utils/event-bus";
@@ -146,8 +147,6 @@ export async function submitInteractiveInput(
 	}
 }
 
-const INITIAL_UPDATE_CHECK_TIMEOUT_MS = 500;
-
 async function runInteractiveMode(
 	session: AgentSession,
 	version: string,
@@ -161,23 +160,26 @@ async function runInteractiveMode(
 	initialMessage?: string,
 	initialImages?: ImageContent[],
 ): Promise<void> {
-	const initialUpdateVersion = await Promise.race([
-		versionCheckPromise.catch(() => undefined),
-		new Promise<string | undefined>(resolve => setTimeout(() => resolve(undefined), INITIAL_UPDATE_CHECK_TIMEOUT_MS)),
-	]);
+	profileMark("interactive: enter runInteractiveMode");
 
 	const mode = new InteractiveMode(session, version, setExtensionUIContext, lspServers, mcpManager, eventBus);
 
 	await mode.init();
+	profileMark("interactive: mode.init() done");
 
-	// 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 });
+	// Update notice: fully non-blocking. Startup never waits on the network version
+	// check; surface the notice whenever it resolves (typically after the prompt is
+	// already up). If it never resolves, the update is available on demand via /plugins.
+	if (settings.get("startup.checkUpdate")) {
+		void versionCheckPromise
+			.then(latest => {
+				if (latest) mode.showStatus(`Update available: v${latest} — run: xcsh update`, { dim: true });
+			})
+			.catch(() => {});
 	}
 
 	mode.renderInitialMessages();
+	profileMark("interactive: initial render requested");
 
 	for (const notify of notifs) {
 		if (!notify) {
@@ -210,6 +212,8 @@ async function runInteractiveMode(
 		}
 	}
 
+	profileMark("interactive: READY — awaiting first input");
+	profileDump();
 	while (true) {
 		const input = await mode.getUserInput();
 		await submitInteractiveInput(mode, session, input);
@@ -551,6 +555,7 @@ async function buildSessionOptions(
 
 export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<void> {
 	logger.startTiming();
+	profileMark("entry: runtime + module-graph loaded (pre-main)");
 
 	// Initialize theme early with defaults (CLI commands need symbols)
 	// Will be re-initialized with user preferences later
@@ -895,6 +900,7 @@ export async function runRootCommand(parsed: Args, rawArgs: string[]): Promise<v
 		sessionOptions,
 	);
 	logger.time("main:afterCreateSession");
+	profileMark("createAgentSession done");
 	if (parsedArgs.apiKey && !sessionOptions.model && session.model) {
 		authStorage.setRuntimeApiKey(session.model.provider, parsedArgs.apiKey);
 	}

package/src/modes/controllers/extension-ui-controller.ts

@@ -274,10 +274,12 @@ export class ExtensionUiController {
 			this.showExtensionError(error.extensionPath, error.error);
 		});
 
-		// Emit session_start event
-		await extensionRunner.emit({
-			type: "session_start",
-		});
+		// Emit session_start in the BACKGROUND so a slow hook (e.g. a plugin doing a
+		// network/CLI check) can never block the TUI paint. The runner discards
+		// session_start handler results, so nothing downstream depends on completion;
+		// hooks that update the UI (widgets/status) render progressively as they finish.
+		// Handler errors are still surfaced via the onError subscription above.
+		void extensionRunner.emit({ type: "session_start" });
 	}
 
 	setHookWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void {

package/src/modes/interactive-mode.ts

@@ -35,6 +35,7 @@ import planModeApprovedPrompt from "../prompts/system/plan-mode-approved.md" wit
 import type { AgentSession, AgentSessionEvent } from "../session/agent-session";
 import { HistoryStorage } from "../session/history-storage";
 import type { SessionContext, SessionManager } from "../session/session-manager";
+import { profileMark } from "../startup-profile";
 import { STTController, type SttState } from "../stt";
 import type { ExitPlanModeDetails } from "../tools";
 import type { EventBus } from "../utils/event-bus";
@@ -294,6 +295,7 @@ export class InteractiveMode implements InteractiveModeContext {
 	async init(): Promise<void> {
 		if (this.isInitialized) return;
 
+		profileMark("init: start");
 		logger.time("InteractiveMode.init:keybindings");
 		this.keybindings = KeybindingsManager.create();
 
@@ -305,6 +307,7 @@ export class InteractiveMode implements InteractiveModeContext {
 			this.refreshSlashCommandState.bind(this),
 			getProjectDir(),
 		);
+		profileMark("init: refreshSlashCommandState done");
 
 		// Refresh user profile in background — fire and forget
 		reconcileFromCollectors().catch(err => logger.warn("Background profile refresh failed", { error: String(err) }));
@@ -368,10 +371,12 @@ export class InteractiveMode implements InteractiveModeContext {
 
 		// Load initial todos
 		await this.#loadTodoList();
+		profileMark("init: loadTodoList done");
 
 		// Start the UI
 		const clearScreen = settings.get("startup.clearScreen");
 		this.ui.start(clearScreen);
+		profileMark("init: ui.start done");
 		pushTerminalTitle();
 		setSessionTerminalTitle(this.sessionManager.getSessionName(), this.sessionManager.getCwd());
 		this.#syncEditorMaxHeight();
@@ -379,9 +384,11 @@ export class InteractiveMode implements InteractiveModeContext {
 
 		// Initialize hooks with TUI-based UI context
 		await this.initHooksAndCustomTools();
+		profileMark("init: initHooksAndCustomTools done");
 
 		// Restore mode from session (e.g. plan mode on resume)
 		await this.#restoreModeFromSession();
+		profileMark("init: restoreModeFromSession done");
 
 		// Subscribe to agent events
 		this.#subscribeToAgent();

package/src/startup-profile.ts

@@ -0,0 +1,48 @@
+/**
+ * Opt-in startup profiler — `PI_STARTUP_PROFILE=1`.
+ *
+ * PI_TIMING exits before the TUI paints, so it cannot measure `runInteractiveMode`
+ * or the pre-`main` module-graph load. This records labeled timestamps (ms since
+ * process start, via `performance.now()`, which is measured from runtime start) and
+ * dumps the full boot timeline to a FILE at the input-ready point — so nothing
+ * corrupts the live TUI screen. Zero cost when the env var is unset.
+ *
+ * The FIRST mark's timestamp is the time from process start to that mark, i.e. it
+ * captures the runtime init + evaluation of the embedded module graph that happens
+ * before any of our code runs. Later marks show the per-step deltas through paint.
+ *
+ * Usage:  PI_STARTUP_PROFILE=1 xcsh   (then quit; read /tmp/xcsh-startup-profile.txt,
+ *         or set PI_STARTUP_PROFILE_FILE to choose the path).
+ */
+import { writeFileSync } from "node:fs";
+
+const ENABLED = !!process.env.PI_STARTUP_PROFILE;
+const marks: Array<[label: string, atMs: number]> = [];
+
+/** Record a labeled timestamp (no-op unless PI_STARTUP_PROFILE is set). */
+export function profileMark(label: string): void {
+	if (ENABLED) marks.push([label, performance.now()]);
+}
+
+/** Write the collected timeline to a file (no-op unless enabled / no marks). */
+export function profileDump(): void {
+	if (!ENABLED || marks.length === 0) return;
+	const lines = ["=== xcsh startup profile (ms since process start) ===", ""];
+	let prev = 0;
+	for (const [label, at] of marks) {
+		const delta = at - prev;
+		lines.push(`  ${at.toFixed(1).padStart(9)} ms   (+${delta.toFixed(1).padStart(8)} ms)   ${label}`);
+		prev = at;
+	}
+	lines.push(
+		"",
+		`  first mark = runtime + module-graph load; total to ready = ${marks[marks.length - 1][1].toFixed(1)} ms`,
+	);
+	const file = process.env.PI_STARTUP_PROFILE_FILE || "/tmp/xcsh-startup-profile.txt";
+	try {
+		writeFileSync(file, `${lines.join("\n")}\n`);
+		process.stderr.write(`[xcsh] startup profile written to ${file}\n`);
+	} catch {
+		/* best-effort diagnostic */
+	}
+}