@mcpc-tech/unplugin-dev-inspector-mcp 0.0.36 → 0.0.38

package/dist/config-updater.cjs

@@ -21,6 +21,7 @@ let _modelcontextprotocol_sdk_inMemory_js = require("@modelcontextprotocol/sdk/i
 let node_process = require("node:process");
 node_process = require_chunk.__toESM(node_process);
 let os = require("os");
+let child_process = require("child_process");
 let fs = require("fs");
 fs = require_chunk.__toESM(fs);
 let http = require("http");
@@ -58015,9 +58016,9 @@ var require_utils$5 = /* @__PURE__ */ require_chunk.__commonJSMin(((exports) =>
 var require_execAsync$1 = /* @__PURE__ */ require_chunk.__commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.execAsync = void 0;
-	const child_process$1 = require("child_process");
+	const child_process$2 = require("child_process");
 	const util$1 = require("util");
-	exports.execAsync = util$1.promisify(child_process$1.exec);
+	exports.execAsync = util$1.promisify(child_process$2.exec);
 }));
 
 //#endregion
@@ -66167,9 +66168,9 @@ var require_utils$1 = /* @__PURE__ */ require_chunk.__commonJSMin(((exports) =>
 var require_execAsync = /* @__PURE__ */ require_chunk.__commonJSMin(((exports) => {
 	Object.defineProperty(exports, "__esModule", { value: true });
 	exports.execAsync = void 0;
-	const child_process = require("child_process");
+	const child_process$1 = require("child_process");
 	const util = require("util");
-	exports.execAsync = util.promisify(child_process.exec);
+	exports.execAsync = util.promisify(child_process$1.exec);
 }));
 
 //#endregion
@@ -83445,19 +83446,6 @@ async function getOrCreateMcpClient(defKey, def) {
 		mcpClientConnecting.delete(defKey);
 	}
 }
-async function releaseMcpClient(defKey) {
-	const entry = mcpClientPool.get(defKey);
-	if (!entry) return;
-	entry.refCount -= 1;
-	if (entry.refCount <= 0) {
-		mcpClientPool.delete(defKey);
-		try {
-			await entry.client.close();
-		} catch (err) {
-			console.error("Error closing MCP client:", err);
-		}
-	}
-}
 var cleanupAllPooledClients = async () => {
 	const entries = Array.from(mcpClientPool.entries());
 	mcpClientPool.clear();
@@ -83515,12 +83503,7 @@ async function composeMcpDepTools(mcpConfig, filterIn) {
 			console.error(`Error creating MCP client for ${name}:`, error);
 		}
 	}
-	const cleanupClients = async () => {
-		await Promise.all(acquiredKeys.map((k) => releaseMcpClient(k)));
-		acquiredKeys.length = 0;
-		Object.keys(allTools).forEach((key) => delete allTools[key]);
-		Object.keys(allClients).forEach((key) => delete allClients[key]);
-	};
+	const cleanupClients = async () => {};
 	return {
 		tools: allTools,
 		clients: allClients,
@@ -86322,17 +86305,6 @@ var ComposableMCPServer = class extends _modelcontextprotocol_sdk_server_index_j
 			server: this,
 			toolNames: Object.keys(allTools)
 		});
-		this.onclose = async () => {
-			await cleanupClients();
-			await this.disposePlugins();
-			await this.logger.info(`[${name}] Event: closed - cleaned up dependent clients and plugins`);
-		};
-		this.onerror = async (error) => {
-			await this.logger.error(`[${name}] Event: error - ${error?.stack ?? String(error)}`);
-			await cleanupClients();
-			await this.disposePlugins();
-			await this.logger.info(`[${name}] Action: cleaned up dependent clients and plugins`);
-		};
 		const toolNameToDetailList = Object.entries(allTools);
 		const publicToolNames = this.getPublicToolNames();
 		const hiddenToolNames = this.getHiddenToolNames();
@@ -86845,6 +86817,7 @@ var ConnectionManager = class {
 		transport.onclose = () => this.removeTransport(sessionId);
 	}
 	removeTransport(sessionId) {
+		console.log(`[dev-inspector] [connection-manager] Removing transport: ${sessionId}`);
 		delete this.transports[sessionId];
 		for (const [_clientId, sessionIds] of this.watchersByClientId) if (sessionIds.has(sessionId)) {
 			sessionIds.delete(sessionId);
@@ -86875,6 +86848,7 @@ var ConnectionManager = class {
 			}
 			sessionsToRemove.push(existingSessionId);
 		}
+		if (sessionsToRemove.length > 0) console.log(`[dev-inspector] [connection-manager] Cleaned up ${sessionsToRemove.length} previous sessions for clientId=${clientId} (new session=${newSessionId})`);
 		for (const sessionId of sessionsToRemove) sessionIds.delete(sessionId);
 	}
 	handleInspectorConnection(sessionId) {
@@ -86894,11 +86868,14 @@ var ConnectionManager = class {
 		}
 	}
 	/**
-	* Handle watcher connection.
-	* @param sessionId - unique session ID
-	* @param clientId - who is connecting (vscode, acp, cursor, etc.)
-	* @param puppetId - who to control (inspector)
-	* @param transport - the transport instance
+	* Get the currently active Inspector (browser) transport
+	*/
+	getInspectorTransport() {
+		if (!this.latestInspectorSessionId) return null;
+		return this.transports[this.latestInspectorSessionId] || null;
+	}
+	/**
+	* Bind watcher (e.g. VS Code/ACP) to Inspector (browser)
 	*/
 	handleWatcherConnection(sessionId, clientId, puppetId, transport) {
 		this.cleanupPreviousWatchers(clientId, sessionId);
@@ -87082,11 +87059,17 @@ async function handleSseConnection(req, res, serverContext, connectionManager) {
 		const url$1 = new URL(req.url ?? "", `http://${host}:${port}`);
 		const transport = new _modelcontextprotocol_sdk_server_sse_js.SSEServerTransport("/__mcp__/messages", res);
 		const sessionId = transport.sessionId;
-		const clientId = url$1.searchParams.get("clientId") || "agent";
+		const clientId = url$1.searchParams.get("clientId") || `agent-${sessionId}`;
 		const puppetId = url$1.searchParams.get("puppetId") || "inspector";
+		console.log(`[dev-inspector] [sse] New connection request: clientId=${clientId}, puppetId=${puppetId}, sessionId=${sessionId}`);
 		connectionManager.registerTransport(sessionId, transport);
-		if (clientId === "inspector") connectionManager.handleInspectorConnection(sessionId);
-		else connectionManager.handleWatcherConnection(sessionId, clientId, puppetId, transport);
+		if (clientId === "inspector") {
+			console.log(`[dev-inspector] [sse] Handling Inspector connection: ${sessionId}`);
+			connectionManager.handleInspectorConnection(sessionId);
+		} else {
+			console.log(`[dev-inspector] [sse] Handling Watcher connection: ${sessionId} (binding to ${puppetId})`);
+			connectionManager.handleWatcherConnection(sessionId, clientId, puppetId, transport);
+		}
 		await mcpServer.connect(transport);
 	} catch (error) {
 		console.error("Error establishing SSE connection:", error);
@@ -88100,6 +88083,7 @@ var ACPLanguageModel = class {
 		try {
 			await this.ensureConnected();
 			const promptContent = convertAiSdkMessagesToAcp(options, this.isFreshSession);
+			console.log(`###########`, promptContent);
 			this.isFreshSession = false;
 			let accumulatedText = "";
 			const toolCalls = [];
@@ -88309,6 +88293,19 @@ function createACPProvider(config) {
 //#endregion
 //#region src/middleware/acp-middleware.ts
 /**
+* Check if a command exists in the system PATH
+* Skips check for npx since it always exists
+*/
+function checkCommandExists(command) {
+	if (command === "npx" || command === "node") return true;
+	try {
+		(0, child_process.execSync)(`which ${command}`, { stdio: "ignore" });
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
 * Provider manager - stores one provider per agent config
 * Key: agentKey (command:args), Value: ProviderEntry
 */
@@ -88372,14 +88369,33 @@ async function loadMcpToolsV5(transport) {
 	return tools;
 }
 /**
+* Default system instructions for DevInspector - provides AI guidance
+*/
+const DEFAULT_SYSTEM_INSTRUCTIONS = `# DevInspector Context
+
+You are connected to a web app with DevInspector. Available tools:
+
+- **list_inspections**: Check pending element inspections from user
+- **capture_element_context**: Activate visual selector to capture UI elements
+- **update_inspection_status**: Update inspection status with progress/results
+- **execute_page_script**: Run JavaScript in browser context
+- **chrome_devtools**: Access Chrome DevTools for network, console, performance
+
+Workflow: Check \`list_inspections\` first. If there are pending items, help resolve them. Otherwise, assist with the user's request.`;
+/**
 * Get an active transport from the connection manager
 */
 function getActiveTransport() {
 	const connectionManager = getConnectionManager();
 	if (!connectionManager) return null;
-	const sessionIds = Object.keys(connectionManager.transports);
-	if (sessionIds.length === 0) return null;
-	return connectionManager.transports[sessionIds[0]];
+	return connectionManager.getInspectorTransport() || connectionManager.transports[Object.keys(connectionManager.transports)[0]];
+}
+/**
+* Get specifically the inspector transport for context and tools
+*/
+function getInspectorTransport() {
+	const connectionManager = getConnectionManager();
+	return connectionManager ? connectionManager.getInspectorTransport() : null;
 }
 function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 	/**
@@ -88426,6 +88442,14 @@ function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 					console.log(`[dev-inspector] [acp] Reusing existing provider for ${agent.name}`);
 					provider = providerEntry.provider;
 				} else {
+					if (!checkCommandExists(agent.command)) {
+						const hints = [`Agent "${agent.name}" command not found: "${agent.command}"`];
+						if (agent.installCommand) hints.push(`Install with: ${agent.installCommand}`);
+						if (agent.configHint) hints.push(agent.configHint);
+						if (agent.configLink) hints.push(`Documentation: ${agent.configLink}`);
+						console.error(`\n${hints.join("\n")}\n`);
+						return;
+					}
 					console.log(`[dev-inspector] [acp] Creating new global provider for ${agent.name}`);
 					provider = createACPProvider({
 						command: agent.command,
@@ -88452,7 +88476,7 @@ function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 				}
 				console.log(`[dev-inspector] [acp] Spawning new process/session for ${agent.name}`);
 				const initPromise = (async () => {
-					const transport = getActiveTransport();
+					const transport = getInspectorTransport() || getActiveTransport();
 					let initialTools = {};
 					if (transport) try {
 						const rawTools = await loadMcpToolsV5(transport);
@@ -88484,6 +88508,7 @@ function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 			res.setHeader("Content-Type", "application/json");
 			res.end(JSON.stringify({ sessionId }));
 		} catch (error) {
+			if (error instanceof Error && error.message.includes("command not found")) throw error;
 			console.error("ACP Init Session Error:", error);
 			if (!res.headersSent) {
 				res.statusCode = 500;
@@ -88578,7 +88603,7 @@ function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 				});
 				await provider.initSession();
 			}
-			const transport = getActiveTransport();
+			const transport = getInspectorTransport() || getActiveTransport();
 			let mcpTools = {};
 			if (transport) mcpTools = await loadMcpToolsV5(transport);
 			else console.warn("[dev-inspector] [acp] No active MCP transport available, tools will not be loaded");
@@ -88595,10 +88620,21 @@ function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 				abortController.abort();
 				if (shouldCleanupProvider) provider.cleanup();
 			});
+			const systemPrompt = agent.acpSystemPrompt ?? acpOptions?.acpSystemPrompt ?? DEFAULT_SYSTEM_INSTRUCTIONS;
+			const enhancedMessages = (0, ai.convertToModelMessages)(messages).map((msg, index$1) => {
+				if (index$1 === 0 && msg.role === "user" && Array.isArray(msg.content)) return {
+					...msg,
+					content: [{
+						type: "text",
+						text: `<system_instructions>\n${systemPrompt}\n</system_instructions>\n\n`
+					}, ...msg.content]
+				};
+				return msg;
+			});
 			const response = (0, ai.streamText)({
 				model: provider.languageModel(model, mode),
 				includeRawChunks: true,
-				messages: (0, ai.convertToModelMessages)(messages),
+				messages: enhancedMessages,
 				abortSignal: abortController.signal,
 				tools: acpTools(mcpTools),
 				onError: (error) => {

package/dist/config-updater.js

@@ -17,6 +17,7 @@ import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/
 import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
 import process$1, { cwd } from "node:process";
 import { homedir } from "os";
+import { execSync } from "child_process";
 import fs, { existsSync } from "fs";
 import * as http from "http";
 import * as https from "https";
@@ -83480,19 +83481,6 @@ async function getOrCreateMcpClient(defKey, def) {
 		mcpClientConnecting.delete(defKey);
 	}
 }
-async function releaseMcpClient(defKey) {
-	const entry = mcpClientPool.get(defKey);
-	if (!entry) return;
-	entry.refCount -= 1;
-	if (entry.refCount <= 0) {
-		mcpClientPool.delete(defKey);
-		try {
-			await entry.client.close();
-		} catch (err) {
-			console.error("Error closing MCP client:", err);
-		}
-	}
-}
 var cleanupAllPooledClients = async () => {
 	const entries = Array.from(mcpClientPool.entries());
 	mcpClientPool.clear();
@@ -83550,12 +83538,7 @@ async function composeMcpDepTools(mcpConfig, filterIn) {
 			console.error(`Error creating MCP client for ${name}:`, error);
 		}
 	}
-	const cleanupClients = async () => {
-		await Promise.all(acquiredKeys.map((k) => releaseMcpClient(k)));
-		acquiredKeys.length = 0;
-		Object.keys(allTools).forEach((key) => delete allTools[key]);
-		Object.keys(allClients).forEach((key) => delete allClients[key]);
-	};
+	const cleanupClients = async () => {};
 	return {
 		tools: allTools,
 		clients: allClients,
@@ -86357,17 +86340,6 @@ var ComposableMCPServer = class extends Server {
 			server: this,
 			toolNames: Object.keys(allTools)
 		});
-		this.onclose = async () => {
-			await cleanupClients();
-			await this.disposePlugins();
-			await this.logger.info(`[${name}] Event: closed - cleaned up dependent clients and plugins`);
-		};
-		this.onerror = async (error) => {
-			await this.logger.error(`[${name}] Event: error - ${error?.stack ?? String(error)}`);
-			await cleanupClients();
-			await this.disposePlugins();
-			await this.logger.info(`[${name}] Action: cleaned up dependent clients and plugins`);
-		};
 		const toolNameToDetailList = Object.entries(allTools);
 		const publicToolNames = this.getPublicToolNames();
 		const hiddenToolNames = this.getHiddenToolNames();
@@ -86880,6 +86852,7 @@ var ConnectionManager = class {
 		transport.onclose = () => this.removeTransport(sessionId);
 	}
 	removeTransport(sessionId) {
+		console.log(`[dev-inspector] [connection-manager] Removing transport: ${sessionId}`);
 		delete this.transports[sessionId];
 		for (const [_clientId, sessionIds] of this.watchersByClientId) if (sessionIds.has(sessionId)) {
 			sessionIds.delete(sessionId);
@@ -86910,6 +86883,7 @@ var ConnectionManager = class {
 			}
 			sessionsToRemove.push(existingSessionId);
 		}
+		if (sessionsToRemove.length > 0) console.log(`[dev-inspector] [connection-manager] Cleaned up ${sessionsToRemove.length} previous sessions for clientId=${clientId} (new session=${newSessionId})`);
 		for (const sessionId of sessionsToRemove) sessionIds.delete(sessionId);
 	}
 	handleInspectorConnection(sessionId) {
@@ -86929,11 +86903,14 @@ var ConnectionManager = class {
 		}
 	}
 	/**
-	* Handle watcher connection.
-	* @param sessionId - unique session ID
-	* @param clientId - who is connecting (vscode, acp, cursor, etc.)
-	* @param puppetId - who to control (inspector)
-	* @param transport - the transport instance
+	* Get the currently active Inspector (browser) transport
+	*/
+	getInspectorTransport() {
+		if (!this.latestInspectorSessionId) return null;
+		return this.transports[this.latestInspectorSessionId] || null;
+	}
+	/**
+	* Bind watcher (e.g. VS Code/ACP) to Inspector (browser)
 	*/
 	handleWatcherConnection(sessionId, clientId, puppetId, transport) {
 		this.cleanupPreviousWatchers(clientId, sessionId);
@@ -87117,11 +87094,17 @@ async function handleSseConnection(req, res, serverContext, connectionManager) {
 		const url = new URL(req.url ?? "", `http://${host}:${port}`);
 		const transport = new SSEServerTransport("/__mcp__/messages", res);
 		const sessionId = transport.sessionId;
-		const clientId = url.searchParams.get("clientId") || "agent";
+		const clientId = url.searchParams.get("clientId") || `agent-${sessionId}`;
 		const puppetId = url.searchParams.get("puppetId") || "inspector";
+		console.log(`[dev-inspector] [sse] New connection request: clientId=${clientId}, puppetId=${puppetId}, sessionId=${sessionId}`);
 		connectionManager.registerTransport(sessionId, transport);
-		if (clientId === "inspector") connectionManager.handleInspectorConnection(sessionId);
-		else connectionManager.handleWatcherConnection(sessionId, clientId, puppetId, transport);
+		if (clientId === "inspector") {
+			console.log(`[dev-inspector] [sse] Handling Inspector connection: ${sessionId}`);
+			connectionManager.handleInspectorConnection(sessionId);
+		} else {
+			console.log(`[dev-inspector] [sse] Handling Watcher connection: ${sessionId} (binding to ${puppetId})`);
+			connectionManager.handleWatcherConnection(sessionId, clientId, puppetId, transport);
+		}
 		await mcpServer.connect(transport);
 	} catch (error) {
 		console.error("Error establishing SSE connection:", error);
@@ -88135,6 +88118,7 @@ var ACPLanguageModel = class {
 		try {
 			await this.ensureConnected();
 			const promptContent = convertAiSdkMessagesToAcp(options, this.isFreshSession);
+			console.log(`###########`, promptContent);
 			this.isFreshSession = false;
 			let accumulatedText = "";
 			const toolCalls = [];
@@ -88344,6 +88328,19 @@ function createACPProvider(config) {
 //#endregion
 //#region src/middleware/acp-middleware.ts
 /**
+* Check if a command exists in the system PATH
+* Skips check for npx since it always exists
+*/
+function checkCommandExists(command) {
+	if (command === "npx" || command === "node") return true;
+	try {
+		execSync(`which ${command}`, { stdio: "ignore" });
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
 * Provider manager - stores one provider per agent config
 * Key: agentKey (command:args), Value: ProviderEntry
 */
@@ -88407,14 +88404,33 @@ async function loadMcpToolsV5(transport) {
 	return tools;
 }
 /**
+* Default system instructions for DevInspector - provides AI guidance
+*/
+const DEFAULT_SYSTEM_INSTRUCTIONS = `# DevInspector Context
+
+You are connected to a web app with DevInspector. Available tools:
+
+- **list_inspections**: Check pending element inspections from user
+- **capture_element_context**: Activate visual selector to capture UI elements
+- **update_inspection_status**: Update inspection status with progress/results
+- **execute_page_script**: Run JavaScript in browser context
+- **chrome_devtools**: Access Chrome DevTools for network, console, performance
+
+Workflow: Check \`list_inspections\` first. If there are pending items, help resolve them. Otherwise, assist with the user's request.`;
+/**
 * Get an active transport from the connection manager
 */
 function getActiveTransport() {
 	const connectionManager = getConnectionManager();
 	if (!connectionManager) return null;
-	const sessionIds = Object.keys(connectionManager.transports);
-	if (sessionIds.length === 0) return null;
-	return connectionManager.transports[sessionIds[0]];
+	return connectionManager.getInspectorTransport() || connectionManager.transports[Object.keys(connectionManager.transports)[0]];
+}
+/**
+* Get specifically the inspector transport for context and tools
+*/
+function getInspectorTransport() {
+	const connectionManager = getConnectionManager();
+	return connectionManager ? connectionManager.getInspectorTransport() : null;
 }
 function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 	/**
@@ -88461,6 +88477,14 @@ function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 					console.log(`[dev-inspector] [acp] Reusing existing provider for ${agent.name}`);
 					provider = providerEntry.provider;
 				} else {
+					if (!checkCommandExists(agent.command)) {
+						const hints = [`Agent "${agent.name}" command not found: "${agent.command}"`];
+						if (agent.installCommand) hints.push(`Install with: ${agent.installCommand}`);
+						if (agent.configHint) hints.push(agent.configHint);
+						if (agent.configLink) hints.push(`Documentation: ${agent.configLink}`);
+						console.error(`\n${hints.join("\n")}\n`);
+						return;
+					}
 					console.log(`[dev-inspector] [acp] Creating new global provider for ${agent.name}`);
 					provider = createACPProvider({
 						command: agent.command,
@@ -88487,7 +88511,7 @@ function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 				}
 				console.log(`[dev-inspector] [acp] Spawning new process/session for ${agent.name}`);
 				const initPromise = (async () => {
-					const transport = getActiveTransport();
+					const transport = getInspectorTransport() || getActiveTransport();
 					let initialTools = {};
 					if (transport) try {
 						const rawTools = await loadMcpToolsV5(transport);
@@ -88519,6 +88543,7 @@ function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 			res.setHeader("Content-Type", "application/json");
 			res.end(JSON.stringify({ sessionId }));
 		} catch (error) {
+			if (error instanceof Error && error.message.includes("command not found")) throw error;
 			console.error("ACP Init Session Error:", error);
 			if (!res.headersSent) {
 				res.statusCode = 500;
@@ -88613,7 +88638,7 @@ function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 				});
 				await provider.initSession();
 			}
-			const transport = getActiveTransport();
+			const transport = getInspectorTransport() || getActiveTransport();
 			let mcpTools = {};
 			if (transport) mcpTools = await loadMcpToolsV5(transport);
 			else console.warn("[dev-inspector] [acp] No active MCP transport available, tools will not be loaded");
@@ -88630,10 +88655,21 @@ function setupAcpMiddleware(middlewares, serverContext, acpOptions) {
 				abortController.abort();
 				if (shouldCleanupProvider) provider.cleanup();
 			});
+			const systemPrompt = agent.acpSystemPrompt ?? acpOptions?.acpSystemPrompt ?? DEFAULT_SYSTEM_INSTRUCTIONS;
+			const enhancedMessages = convertToModelMessages(messages).map((msg, index$1) => {
+				if (index$1 === 0 && msg.role === "user" && Array.isArray(msg.content)) return {
+					...msg,
+					content: [{
+						type: "text",
+						text: `<system_instructions>\n${systemPrompt}\n</system_instructions>\n\n`
+					}, ...msg.content]
+				};
+				return msg;
+			});
 			const response = streamText({
 				model: provider.languageModel(model, mode),
 				includeRawChunks: true,
-				messages: convertToModelMessages(messages),
+				messages: enhancedMessages,
 				abortSignal: abortController.signal,
 				tools: acpTools(mcpTools),
 				onError: (error) => {

package/dist/index.cjs

@@ -23,7 +23,7 @@ var browser_launcher_exports = /* @__PURE__ */ require_chunk.__export({ launchBr
 */
 async function launchBrowserWithDevTools(options) {
 	const { url, serverContext } = options;
-	const sseUrl = `http://${serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host || "localhost"}:${serverContext.port || 5173}/__mcp__/sse?clientId=auto-browser`;
+	const sseUrl = `http://${serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host || "localhost"}:${serverContext.port || 5173}/__mcp__/sse?clientId=temp-browser-launcher`;
 	let client = null;
 	try {
 		client = new _modelcontextprotocol_sdk_client_index_js.Client({
@@ -44,6 +44,8 @@ async function launchBrowserWithDevTools(options) {
 	} catch (error) {
 		console.error(`[dev-inspector] ⚠️  Failed to auto-open browser:`, error instanceof Error ? error.message : String(error));
 		return false;
+	} finally {
+		await client?.close().catch(() => {});
 	}
 }
 var init_browser_launcher = require_chunk.__esmMin((() => {}));

package/dist/index.d.cts

@@ -52,6 +52,11 @@ interface AcpOptions {
    * @default undefined (skipped if not specified)
    */
   acpDelay?: number;
+  /**
+   * Custom system instructions to prepend to user messages
+   * @default undefined (uses built-in DevInspector context)
+   */
+  acpSystemPrompt?: string;
 }
 interface Agent extends AcpOptions {
   name: string;
@@ -65,6 +70,18 @@ interface Agent extends AcpOptions {
   meta?: {
     icon?: string;
   };
+  /**
+   * Configuration hint text to help users set up the agent
+   */
+  configHint?: string;
+  /**
+   * Link to configuration documentation or setup guide
+   */
+  configLink?: string;
+  /**
+   * Installation command for the agent (shown in error messages)
+   */
+  installCommand?: string;
 }
 //#endregion
 //#region src/utils/create-plugin.d.ts

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import * as unplugin0 from "unplugin";
+import * as unplugin1 from "unplugin";
 
 //#region src/utils/config-updater.d.ts
 type EditorId = "cursor" | "vscode" | "windsurf" | "claude-code" | "antigravity";
@@ -52,6 +52,11 @@ interface AcpOptions {
    * @default undefined (skipped if not specified)
    */
   acpDelay?: number;
+  /**
+   * Custom system instructions to prepend to user messages
+   * @default undefined (uses built-in DevInspector context)
+   */
+  acpSystemPrompt?: string;
 }
 interface Agent extends AcpOptions {
   name: string;
@@ -65,6 +70,18 @@ interface Agent extends AcpOptions {
   meta?: {
     icon?: string;
   };
+  /**
+   * Configuration hint text to help users set up the agent
+   */
+  configHint?: string;
+  /**
+   * Link to configuration documentation or setup guide
+   */
+  configLink?: string;
+  /**
+   * Installation command for the agent (shown in error messages)
+   */
+  installCommand?: string;
 }
 //#endregion
 //#region src/utils/create-plugin.d.ts
@@ -134,10 +151,10 @@ interface DevInspectorOptions extends McpConfigOptions, AcpOptions {
 }
 //#endregion
 //#region src/core.d.ts
-declare const unplugin: unplugin0.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
+declare const unplugin: unplugin1.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
 //#endregion
 //#region src/core-external.d.ts
-declare const unpluginExternal: unplugin0.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
+declare const unpluginExternal: unplugin1.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
 //#endregion
 //#region src/turbopack.d.ts
 interface TurbopackDevInspectorOptions extends DevInspectorOptions {
@@ -162,7 +179,7 @@ interface TurbopackDevInspectorOptions extends DevInspectorOptions {
 declare function turbopackDevInspector(options?: TurbopackDevInspectorOptions): any;
 //#endregion
 //#region src/index.d.ts
-declare const external: unplugin0.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
+declare const external: unplugin1.UnpluginInstance<DevInspectorOptions | undefined, boolean>;
 declare module "virtual:dev-inspector-mcp" {}
 //#endregion
 export { type CustomEditorConfig, type DevInspectorOptions, type EditorId, type McpConfigOptions, type TurbopackDevInspectorOptions, unplugin as default, unplugin, external, turbopackDevInspector, unpluginExternal };

package/dist/index.js

@@ -19,7 +19,7 @@ var browser_launcher_exports = /* @__PURE__ */ __export({ launchBrowserWithDevTo
 */
 async function launchBrowserWithDevTools(options) {
 	const { url, serverContext } = options;
-	const sseUrl = `http://${serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host || "localhost"}:${serverContext.port || 5173}/__mcp__/sse?clientId=auto-browser`;
+	const sseUrl = `http://${serverContext.host === "0.0.0.0" ? "localhost" : serverContext.host || "localhost"}:${serverContext.port || 5173}/__mcp__/sse?clientId=temp-browser-launcher`;
 	let client = null;
 	try {
 		client = new Client({
@@ -40,6 +40,8 @@ async function launchBrowserWithDevTools(options) {
 	} catch (error) {
 		console.error(`[dev-inspector] ⚠️  Failed to auto-open browser:`, error instanceof Error ? error.message : String(error));
 		return false;
+	} finally {
+		await client?.close().catch(() => {});
 	}
 }
 var init_browser_launcher = __esmMin((() => {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpc-tech/unplugin-dev-inspector-mcp",
-  "version": "0.0.36",
+  "version": "0.0.38",
   "description": "Universal dev inspector plugin for React/Vue - inspect component sources and API calls in any bundler",
   "type": "module",
   "license": "MIT",
@@ -186,4 +186,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}