neon-init 0.13.1 → 0.15.0

package/dist/lib/extension.js

@@ -1,8 +1,8 @@
+import { NEON_EXTENSION_ID, downloadVsix } from "./vsix.js";
 import { existsSync } from "node:fs";
 import { execa } from "execa";
-
+import { unlink } from "node:fs/promises";
 //#region src/lib/extension.ts
-const NEON_EXTENSION_ID = "databricks.neon-local-connect";
 /**
 * Uses macOS mdfind to locate an app by bundle identifier
 */
@@ -109,7 +109,7 @@ function getEditorUriScheme(editor) {
 /**
 * Checks if the extension is installed by querying the editor's extension list
 */
-async function isExtensionInList(editor) {
+async function isExtensionInstalled(editor) {
 	const command = await findEditorCommand(editor);
 	if (!command) return false;
 	try {
@@ -124,7 +124,7 @@ async function isExtensionInList(editor) {
 */
 async function waitForExtensionInstalled(editor, maxAttempts = 10, delayMs = 1e3) {
 	for (let attempt = 0; attempt < maxAttempts; attempt++) {
-		if (await isExtensionInList(editor)) {
+		if (await isExtensionInstalled(editor)) {
 			await new Promise((resolve) => setTimeout(resolve, 1e3));
 			return true;
 		}
@@ -133,17 +133,37 @@ async function waitForExtensionInstalled(editor, maxAttempts = 10, delayMs = 1e3
 	return false;
 }
 /**
-* Installs the Neon Local Connect extension for VS Code or Cursor
-* Returns success only if installation succeeds, fails silently otherwise
+* Installs the Neon Local Connect extension for VS Code or Cursor.
+*
+* Strategy:
+* 1. Try `--install-extension <id>` directly (uses the editor's configured marketplace)
+* 2. If that fails, download .vsix (from proxy or Open VSX) and install locally
+* 3. Set NEON_VSX_GALLERY_URL to use a corporate proxy for the download
 */
 async function installExtension(editor) {
 	const command = await findEditorCommand(editor);
 	if (!command) return false;
 	try {
-		await execa(command, ["--install-extension", NEON_EXTENSION_ID]);
+		await execa(command, ["--install-extension", NEON_EXTENSION_ID], {
+			stdio: "pipe",
+			timeout: 6e4
+		});
+		return true;
+	} catch {}
+	const vsixPath = await downloadVsix();
+	if (!vsixPath) return false;
+	try {
+		await execa(command, ["--install-extension", vsixPath], {
+			stdio: "pipe",
+			timeout: 6e4
+		});
 		return true;
 	} catch {
 		return false;
+	} finally {
+		try {
+			await unlink(vsixPath);
+		} catch {}
 	}
 }
 /**
@@ -176,7 +196,7 @@ async function configureExtension(editor, apiKey) {
 function usesExtension(editor) {
 	return editor === "VS Code" || editor === "Cursor";
 }
-
 //#endregion
-export { configureExtension, findEditorCommand, installExtension, usesExtension, waitForExtensionInstalled };
+export { configureExtension, findEditorCommand, installExtension, isExtensionInstalled, usesExtension, waitForExtensionInstalled };
+
 //# sourceMappingURL=extension.js.map

package/dist/lib/extension.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension.js","names":[],"sources":["../../src/lib/extension.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { execa } from \"execa\";\nimport type { Editor } from \"./types.js\";\n\nconst NEON_EXTENSION_ID = \"databricks.neon-local-connect\";\n\n/**\n * Uses macOS mdfind to locate an app by bundle identifier\n */\nasync function findAppWithMdfind(bundleId: string): Promise<string | null> {\n\ttry {\n\t\tconst result = await execa(\n\t\t\t\"mdfind\",\n\t\t\t[`kMDItemCFBundleIdentifier == '${bundleId}'`],\n\t\t\t{ timeout: 5000 },\n\t\t);\n\t\tconst paths = result.stdout.trim().split(\"\\n\").filter(Boolean);\n\t\treturn paths[0] || null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Known installation paths for VS Code CLI\n */\nfunction getVSCodePaths(): string[] {\n\tconst platform = process.platform;\n\tconst home = process.env.HOME || \"\";\n\n\tif (platform === \"darwin\") {\n\t\treturn [\n\t\t\t\"/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code\",\n\t\t\t\"/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/bin/code-insiders\",\n\t\t\t`${home}/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code`,\n\t\t\t`${home}/Downloads/Visual Studio Code.app/Contents/Resources/app/bin/code`,\n\t\t];\n\t}\n\n\tif (platform === \"linux\") {\n\t\treturn [\n\t\t\t\"/usr/share/code/bin/code\",\n\t\t\t\"/usr/bin/code\",\n\t\t\t\"/snap/bin/code\",\n\t\t\t\"/usr/share/code-insiders/bin/code-insiders\",\n\t\t];\n\t}\n\n\tif (platform === \"win32\") {\n\t\tconst localAppData = process.env.LOCALAPPDATA || \"\";\n\t\tconst programFiles = process.env.PROGRAMFILES || \"C:\\\\Program Files\";\n\t\treturn [\n\t\t\t`${localAppData}\\\\Programs\\\\Microsoft VS Code\\\\bin\\\\code.cmd`,\n\t\t\t`${programFiles}\\\\Microsoft VS Code\\\\bin\\\\code.cmd`,\n\t\t\t`${localAppData}\\\\Programs\\\\Microsoft VS Code Insiders\\\\bin\\\\code-insiders.cmd`,\n\t\t];\n\t}\n\n\treturn [];\n}\n\n/**\n * Known installation paths for Cursor CLI\n */\nfunction getCursorPaths(): string[] {\n\tconst platform = process.platform;\n\tconst home = process.env.HOME || \"\";\n\n\tif (platform === \"darwin\") {\n\t\treturn [\n\t\t\t\"/Applications/Cursor.app/Contents/Resources/app/bin/cursor\",\n\t\t\t`${home}/Applications/Cursor.app/Contents/Resources/app/bin/cursor`,\n\t\t\t`${home}/Downloads/Cursor.app/Contents/Resources/app/bin/cursor`,\n\t\t];\n\t}\n\n\tif (platform === \"linux\") {\n\t\treturn [\n\t\t\t\"/usr/share/cursor/bin/cursor\",\n\t\t\t\"/usr/bin/cursor\",\n\t\t\t`${home}/.local/bin/cursor`,\n\t\t\t\"/opt/cursor/bin/cursor\",\n\t\t];\n\t}\n\n\tif (platform === \"win32\") {\n\t\tconst localAppData = process.env.LOCALAPPDATA || \"\";\n\t\tconst programFiles = process.env.PROGRAMFILES || \"C:\\\\Program Files\";\n\t\treturn [\n\t\t\t`${localAppData}\\\\Programs\\\\Cursor\\\\resources\\\\app\\\\bin\\\\cursor.cmd`,\n\t\t\t`${localAppData}\\\\cursor\\\\Cursor.exe`,\n\t\t\t`${programFiles}\\\\Cursor\\\\resources\\\\app\\\\bin\\\\cursor.cmd`,\n\t\t];\n\t}\n\n\treturn [];\n}\n\n/**\n * Finds the CLI command for an editor by checking known installation paths\n * On macOS, also uses mdfind to locate the app if standard paths fail\n * Falls back to the simple command name if no full path is found (in case it's in PATH)\n */\nexport async function findEditorCommand(\n\teditor: Editor,\n): Promise<string | null> {\n\tlet paths: string[];\n\tlet fallbackCommand: string;\n\tlet bundleId: string | null = null;\n\n\tif (editor === \"VS Code\") {\n\t\tpaths = getVSCodePaths();\n\t\tfallbackCommand = \"code\";\n\t\tbundleId = \"com.microsoft.VSCode\";\n\t} else if (editor === \"Cursor\") {\n\t\tpaths = getCursorPaths();\n\t\tfallbackCommand = \"cursor\";\n\t\tbundleId = \"com.todesktop.230313mzl4w4u92\";\n\t} else {\n\t\treturn null;\n\t}\n\n\tfor (const path of paths) {\n\t\tif (existsSync(path)) {\n\t\t\treturn path;\n\t\t}\n\t}\n\n\t// On macOS, try mdfind to locate the app dynamically\n\tif (process.platform === \"darwin\" && bundleId) {\n\t\tconst appPath = await findAppWithMdfind(bundleId);\n\t\tif (appPath) {\n\t\t\tconst cliPath = `${appPath}/Contents/Resources/app/bin/${fallbackCommand}`;\n\t\t\tif (existsSync(cliPath)) {\n\t\t\t\treturn cliPath;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn fallbackCommand;\n}\n\n/**\n * Gets the URI scheme for an editor\n */\nfunction getEditorUriScheme(editor: Editor): string | null {\n\tif (editor === \"VS Code\") {\n\t\treturn \"vscode\";\n\t}\n\tif (editor === \"Cursor\") {\n\t\treturn \"cursor\";\n\t}\n\treturn null;\n}\n\n/**\n * Checks if the extension is installed by querying the editor's extension list\n */\nasync function isExtensionInList(editor: Editor): Promise<boolean> {\n\tconst command = await findEditorCommand(editor);\n\tif (!command) {\n\t\treturn false;\n\t}\n\n\ttry {\n\t\tconst result = await execa(command, [\"--list-extensions\"], {\n\t\t\ttimeout: 5000,\n\t\t});\n\t\treturn result.stdout.includes(NEON_EXTENSION_ID);\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Waits for the extension to appear in the installed extensions list\n * This ensures the extension is fully installed and activated before we try to configure it\n */\nexport async function waitForExtensionInstalled(\n\teditor: Editor,\n\tmaxAttempts = 10,\n\tdelayMs = 1000,\n): Promise<boolean> {\n\tfor (let attempt = 0; attempt < maxAttempts; attempt++) {\n\t\tconst isInstalled = await isExtensionInList(editor);\n\n\t\tif (isInstalled) {\n\t\t\t// Give the extension a moment to fully activate and register URI handlers\n\t\t\tawait new Promise((resolve) => setTimeout(resolve, 1000));\n\t\t\treturn true;\n\t\t}\n\n\t\t// Wait before checking again (unless this is the last attempt)\n\t\tif (attempt < maxAttempts - 1) {\n\t\t\tawait new Promise((resolve) => setTimeout(resolve, delayMs));\n\t\t}\n\t}\n\n\treturn false;\n}\n\n/**\n * Installs the Neon Local Connect extension for VS Code or Cursor\n * Returns success only if installation succeeds, fails silently otherwise\n */\nexport async function installExtension(editor: Editor): Promise<boolean> {\n\tconst command = await findEditorCommand(editor);\n\tif (!command) {\n\t\treturn false;\n\t}\n\n\ttry {\n\t\tawait execa(command, [\"--install-extension\", NEON_EXTENSION_ID]);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Configures the Neon Local Connect extension with the API key\n * Uses the extension's URI handler to trigger the import-api-key command\n */\nexport async function configureExtension(\n\teditor: Editor,\n\tapiKey: string,\n): Promise<boolean> {\n\tconst scheme = getEditorUriScheme(editor);\n\tif (!scheme) {\n\t\treturn false;\n\t}\n\n\t// Build the URI to trigger the extension's import-api-key handler\n\t// Format: vscode://databricks.neon-local-connect/import-api-key?token=xxx\n\tconst encodedApiKey = encodeURIComponent(apiKey);\n\tconst uri = `${scheme}://${NEON_EXTENSION_ID}/import-api-key?token=${encodedApiKey}`;\n\n\ttry {\n\t\tconst platform = process.platform;\n\n\t\tif (platform === \"darwin\") {\n\t\t\t// macOS: use 'open' command\n\t\t\tawait execa(\"open\", [uri], { timeout: 10000 });\n\t\t} else if (platform === \"linux\") {\n\t\t\t// Linux: use 'xdg-open' command\n\t\t\tawait execa(\"xdg-open\", [uri], { timeout: 10000 });\n\t\t} else if (platform === \"win32\") {\n\t\t\t// Windows: use 'start' command\n\t\t\tawait execa(\"cmd\", [\"/c\", \"start\", \"\", uri], { timeout: 10000 });\n\t\t} else {\n\t\t\treturn false;\n\t\t}\n\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Returns the editor types that should use extension installation (vs MCP)\n */\nexport function usesExtension(editor: Editor): boolean {\n\treturn editor === \"VS Code\" || editor === \"Cursor\";\n}\n"],"mappings":"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"}
+{"version":3,"file":"extension.js","names":[],"sources":["../../src/lib/extension.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { unlink } from \"node:fs/promises\";\nimport { execa } from \"execa\";\nimport type { Editor } from \"./types.js\";\nimport { downloadVsix, NEON_EXTENSION_ID } from \"./vsix.js\";\n\n/**\n * Uses macOS mdfind to locate an app by bundle identifier\n */\nasync function findAppWithMdfind(bundleId: string): Promise<string | null> {\n\ttry {\n\t\tconst result = await execa(\n\t\t\t\"mdfind\",\n\t\t\t[`kMDItemCFBundleIdentifier == '${bundleId}'`],\n\t\t\t{ timeout: 5000 },\n\t\t);\n\t\tconst paths = result.stdout.trim().split(\"\\n\").filter(Boolean);\n\t\treturn paths[0] || null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Known installation paths for VS Code CLI\n */\nfunction getVSCodePaths(): string[] {\n\tconst platform = process.platform;\n\tconst home = process.env.HOME || \"\";\n\n\tif (platform === \"darwin\") {\n\t\treturn [\n\t\t\t\"/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code\",\n\t\t\t\"/Applications/Visual Studio Code - Insiders.app/Contents/Resources/app/bin/code-insiders\",\n\t\t\t`${home}/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code`,\n\t\t\t`${home}/Downloads/Visual Studio Code.app/Contents/Resources/app/bin/code`,\n\t\t];\n\t}\n\n\tif (platform === \"linux\") {\n\t\treturn [\n\t\t\t\"/usr/share/code/bin/code\",\n\t\t\t\"/usr/bin/code\",\n\t\t\t\"/snap/bin/code\",\n\t\t\t\"/usr/share/code-insiders/bin/code-insiders\",\n\t\t];\n\t}\n\n\tif (platform === \"win32\") {\n\t\tconst localAppData = process.env.LOCALAPPDATA || \"\";\n\t\tconst programFiles = process.env.PROGRAMFILES || \"C:\\\\Program Files\";\n\t\treturn [\n\t\t\t`${localAppData}\\\\Programs\\\\Microsoft VS Code\\\\bin\\\\code.cmd`,\n\t\t\t`${programFiles}\\\\Microsoft VS Code\\\\bin\\\\code.cmd`,\n\t\t\t`${localAppData}\\\\Programs\\\\Microsoft VS Code Insiders\\\\bin\\\\code-insiders.cmd`,\n\t\t];\n\t}\n\n\treturn [];\n}\n\n/**\n * Known installation paths for Cursor CLI\n */\nfunction getCursorPaths(): string[] {\n\tconst platform = process.platform;\n\tconst home = process.env.HOME || \"\";\n\n\tif (platform === \"darwin\") {\n\t\treturn [\n\t\t\t\"/Applications/Cursor.app/Contents/Resources/app/bin/cursor\",\n\t\t\t`${home}/Applications/Cursor.app/Contents/Resources/app/bin/cursor`,\n\t\t\t`${home}/Downloads/Cursor.app/Contents/Resources/app/bin/cursor`,\n\t\t];\n\t}\n\n\tif (platform === \"linux\") {\n\t\treturn [\n\t\t\t\"/usr/share/cursor/bin/cursor\",\n\t\t\t\"/usr/bin/cursor\",\n\t\t\t`${home}/.local/bin/cursor`,\n\t\t\t\"/opt/cursor/bin/cursor\",\n\t\t];\n\t}\n\n\tif (platform === \"win32\") {\n\t\tconst localAppData = process.env.LOCALAPPDATA || \"\";\n\t\tconst programFiles = process.env.PROGRAMFILES || \"C:\\\\Program Files\";\n\t\treturn [\n\t\t\t`${localAppData}\\\\Programs\\\\Cursor\\\\resources\\\\app\\\\bin\\\\cursor.cmd`,\n\t\t\t`${localAppData}\\\\cursor\\\\Cursor.exe`,\n\t\t\t`${programFiles}\\\\Cursor\\\\resources\\\\app\\\\bin\\\\cursor.cmd`,\n\t\t];\n\t}\n\n\treturn [];\n}\n\n/**\n * Finds the CLI command for an editor by checking known installation paths\n * On macOS, also uses mdfind to locate the app if standard paths fail\n * Falls back to the simple command name if no full path is found (in case it's in PATH)\n */\nexport async function findEditorCommand(\n\teditor: Editor,\n): Promise<string | null> {\n\tlet paths: string[];\n\tlet fallbackCommand: string;\n\tlet bundleId: string | null = null;\n\n\tif (editor === \"VS Code\") {\n\t\tpaths = getVSCodePaths();\n\t\tfallbackCommand = \"code\";\n\t\tbundleId = \"com.microsoft.VSCode\";\n\t} else if (editor === \"Cursor\") {\n\t\tpaths = getCursorPaths();\n\t\tfallbackCommand = \"cursor\";\n\t\tbundleId = \"com.todesktop.230313mzl4w4u92\";\n\t} else {\n\t\treturn null;\n\t}\n\n\tfor (const path of paths) {\n\t\tif (existsSync(path)) {\n\t\t\treturn path;\n\t\t}\n\t}\n\n\t// On macOS, try mdfind to locate the app dynamically\n\tif (process.platform === \"darwin\" && bundleId) {\n\t\tconst appPath = await findAppWithMdfind(bundleId);\n\t\tif (appPath) {\n\t\t\tconst cliPath = `${appPath}/Contents/Resources/app/bin/${fallbackCommand}`;\n\t\t\tif (existsSync(cliPath)) {\n\t\t\t\treturn cliPath;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn fallbackCommand;\n}\n\n/**\n * Gets the URI scheme for an editor\n */\nfunction getEditorUriScheme(editor: Editor): string | null {\n\tif (editor === \"VS Code\") {\n\t\treturn \"vscode\";\n\t}\n\tif (editor === \"Cursor\") {\n\t\treturn \"cursor\";\n\t}\n\treturn null;\n}\n\n/**\n * Checks if the extension is installed by querying the editor's extension list\n */\nexport async function isExtensionInstalled(editor: Editor): Promise<boolean> {\n\tconst command = await findEditorCommand(editor);\n\tif (!command) {\n\t\treturn false;\n\t}\n\n\ttry {\n\t\tconst result = await execa(command, [\"--list-extensions\"], {\n\t\t\ttimeout: 5000,\n\t\t});\n\t\treturn result.stdout.includes(NEON_EXTENSION_ID);\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Waits for the extension to appear in the installed extensions list\n * This ensures the extension is fully installed and activated before we try to configure it\n */\nexport async function waitForExtensionInstalled(\n\teditor: Editor,\n\tmaxAttempts = 10,\n\tdelayMs = 1000,\n): Promise<boolean> {\n\tfor (let attempt = 0; attempt < maxAttempts; attempt++) {\n\t\tconst isInstalled = await isExtensionInstalled(editor);\n\n\t\tif (isInstalled) {\n\t\t\t// Give the extension a moment to fully activate and register URI handlers\n\t\t\tawait new Promise((resolve) => setTimeout(resolve, 1000));\n\t\t\treturn true;\n\t\t}\n\n\t\t// Wait before checking again (unless this is the last attempt)\n\t\tif (attempt < maxAttempts - 1) {\n\t\t\tawait new Promise((resolve) => setTimeout(resolve, delayMs));\n\t\t}\n\t}\n\n\treturn false;\n}\n\n/**\n * Installs the Neon Local Connect extension for VS Code or Cursor.\n *\n * Strategy:\n * 1. Try `--install-extension <id>` directly (uses the editor's configured marketplace)\n * 2. If that fails, download .vsix (from proxy or Open VSX) and install locally\n * 3. Set NEON_VSX_GALLERY_URL to use a corporate proxy for the download\n */\nexport async function installExtension(editor: Editor): Promise<boolean> {\n\tconst command = await findEditorCommand(editor);\n\tif (!command) {\n\t\treturn false;\n\t}\n\n\t// Try direct marketplace install first\n\ttry {\n\t\tawait execa(command, [\"--install-extension\", NEON_EXTENSION_ID], {\n\t\t\tstdio: \"pipe\",\n\t\t\ttimeout: 60000,\n\t\t});\n\t\treturn true;\n\t} catch {\n\t\t// Fall through to VSIX download\n\t}\n\n\t// Download .vsix and install locally\n\tconst vsixPath = await downloadVsix();\n\tif (!vsixPath) {\n\t\treturn false;\n\t}\n\n\ttry {\n\t\tawait execa(command, [\"--install-extension\", vsixPath], {\n\t\t\tstdio: \"pipe\",\n\t\t\ttimeout: 60000,\n\t\t});\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t} finally {\n\t\ttry {\n\t\t\tawait unlink(vsixPath);\n\t\t} catch {}\n\t}\n}\n\n/**\n * Configures the Neon Local Connect extension with the API key\n * Uses the extension's URI handler to trigger the import-api-key command\n */\nexport async function configureExtension(\n\teditor: Editor,\n\tapiKey: string,\n): Promise<boolean> {\n\tconst scheme = getEditorUriScheme(editor);\n\tif (!scheme) {\n\t\treturn false;\n\t}\n\n\t// Build the URI to trigger the extension's import-api-key handler\n\t// Format: vscode://databricks.neon-local-connect/import-api-key?token=xxx\n\tconst encodedApiKey = encodeURIComponent(apiKey);\n\tconst uri = `${scheme}://${NEON_EXTENSION_ID}/import-api-key?token=${encodedApiKey}`;\n\n\ttry {\n\t\tconst platform = process.platform;\n\n\t\tif (platform === \"darwin\") {\n\t\t\t// macOS: use 'open' command\n\t\t\tawait execa(\"open\", [uri], { timeout: 10000 });\n\t\t} else if (platform === \"linux\") {\n\t\t\t// Linux: use 'xdg-open' command\n\t\t\tawait execa(\"xdg-open\", [uri], { timeout: 10000 });\n\t\t} else if (platform === \"win32\") {\n\t\t\t// Windows: use 'start' command\n\t\t\tawait execa(\"cmd\", [\"/c\", \"start\", \"\", uri], { timeout: 10000 });\n\t\t} else {\n\t\t\treturn false;\n\t\t}\n\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Returns the editor types that should use extension installation (vs MCP)\n */\nexport function usesExtension(editor: Editor): boolean {\n\treturn editor === \"VS Code\" || editor === \"Cursor\";\n}\n"],"mappings":"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"}

package/dist/lib/inspect.d.ts

@@ -0,0 +1,28 @@
+import { AgentCheck } from "./types.js";
+
+//#region src/lib/inspect.d.ts
+interface InspectionResults {
+  [key: string]: unknown;
+  mcpConfigured?: boolean;
+  skillsInstalled?: boolean;
+  /** True if a Neon-specific connection string (DATABASE_URL with "neon" or PGHOST with "neon") is found */
+  connectionString?: boolean;
+  /** True if any DATABASE_URL is set in .env (regardless of provider) */
+  databaseUrl?: boolean;
+  framework?: string;
+  orm?: string;
+  migrationTool?: string;
+  migrationDir?: string;
+  isVscodeIde?: boolean;
+  agent?: string;
+  /** True if the directory contains an application (package.json with deps, or source files) */
+  hasApp?: boolean;
+}
+/**
+ * Runs filesystem checks based on the agent_check descriptors.
+ * Maps check IDs to concrete inspection functions.
+ */
+declare function inspectProject(checks: AgentCheck[]): Promise<InspectionResults>;
+//#endregion
+export { InspectionResults, inspectProject };
+//# sourceMappingURL=inspect.d.ts.map

package/dist/lib/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","names":[],"sources":["../../src/lib/inspect.ts"],"mappings":";;;UASiB,iBAAA;;EAAA,aAAA,CAAA,EAAA,OAAiB;EAsBZ,eAAA,CAAA,EAAc,OAAA;EAAA;kBAC3B,CAAA,EAAA,OAAA;;aACN,CAAA,EAAA,OAAA;EAAO,SAAA,CAAA,EAAA,MAAA;;;;;;;;;;;;;iBAFY,cAAA,SACb,eACN,QAAQ"}

package/dist/lib/inspect.js

@@ -0,0 +1,190 @@
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+//#region src/lib/inspect.ts
+/**
+* Filesystem-based project inspection for interactive (agentless) mode.
+* Replaces the "agent_check" pattern — instead of asking an agent to look,
+* we examine the filesystem directly.
+*/
+/**
+* Runs filesystem checks based on the agent_check descriptors.
+* Maps check IDs to concrete inspection functions.
+*/
+async function inspectProject(checks) {
+	const results = {};
+	const cwd = process.cwd();
+	for (const check of checks) switch (check.id) {
+		case "mcp_server":
+			results.mcpConfigured = checkMcpServer(cwd);
+			break;
+		case "connection_string":
+			results.connectionString = checkConnectionString(cwd);
+			break;
+		case "database_url":
+			results.databaseUrl = checkDatabaseUrl(cwd);
+			break;
+		case "project_stack": {
+			const stack = detectProjectStack(cwd);
+			results.framework = stack.framework;
+			results.orm = stack.orm;
+			break;
+		}
+		case "migrations": {
+			const migrations = detectMigrations(cwd);
+			results.migrationTool = migrations.tool;
+			results.migrationDir = migrations.dir;
+			break;
+		}
+		case "skills":
+			results.skillsInstalled = checkSkillsInstalled(cwd);
+			break;
+		case "ide_type":
+			results.isVscodeIde = checkVscodeIde();
+			break;
+		case "has_app":
+			results.hasApp = checkHasApp(cwd);
+			break;
+		case "agent_type": break;
+	}
+	return results;
+}
+function checkMcpServer(cwd) {
+	const cursorMcp = resolve(cwd, ".cursor", "mcp.json");
+	if (existsSync(cursorMcp)) try {
+		const content = readFileSync(cursorMcp, "utf-8");
+		if (content.includes("neon") || content.includes("mcp.neon.tech")) return true;
+	} catch {}
+	const home = process.env.HOME || process.env.USERPROFILE || "";
+	const globalCursorMcp = resolve(home, ".cursor", "mcp.json");
+	if (existsSync(globalCursorMcp)) try {
+		const content = readFileSync(globalCursorMcp, "utf-8");
+		if (content.includes("neon") || content.includes("mcp.neon.tech")) return true;
+	} catch {}
+	for (const claudeFile of ["settings.local.json", "settings.json"]) {
+		const claudeConfig = resolve(home, ".claude", claudeFile);
+		if (existsSync(claudeConfig)) try {
+			const content = readFileSync(claudeConfig, "utf-8");
+			if (content.includes("neon") || content.includes("mcp.neon.tech")) return true;
+		} catch {}
+	}
+	const vscodeSettings = resolve(cwd, ".vscode", "settings.json");
+	if (existsSync(vscodeSettings)) try {
+		const content = readFileSync(vscodeSettings, "utf-8");
+		if (content.includes("neon") || content.includes("mcp.neon.tech")) return true;
+	} catch {}
+	return false;
+}
+function checkConnectionString(cwd) {
+	for (const envFile of [".env", ".env.local"]) {
+		const envPath = resolve(cwd, envFile);
+		if (existsSync(envPath)) try {
+			const content = readFileSync(envPath, "utf-8");
+			if (/^DATABASE_URL=.*neon/m.test(content) || /^PGHOST=.*neon/m.test(content)) return true;
+		} catch {}
+	}
+	return false;
+}
+function detectProjectStack(cwd) {
+	const result = {
+		framework: "none",
+		orm: "none"
+	};
+	const pkgPath = resolve(cwd, "package.json");
+	if (!existsSync(pkgPath)) return result;
+	try {
+		const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+		const allDeps = {
+			...pkg.dependencies,
+			...pkg.devDependencies
+		};
+		if (allDeps.next) result.framework = "next";
+		else if (allDeps.remix || allDeps["@remix-run/node"]) result.framework = "remix";
+		else if (allDeps.express) result.framework = "express";
+		else if (allDeps.hono) result.framework = "hono";
+		else if (allDeps.fastify) result.framework = "fastify";
+		else if (allDeps["@sveltejs/kit"]) result.framework = "sveltekit";
+		else if (allDeps.nuxt) result.framework = "nuxt";
+		else if (allDeps.astro) result.framework = "astro";
+		if (allDeps.prisma || allDeps["@prisma/client"]) result.orm = "prisma";
+		else if (allDeps["drizzle-orm"]) result.orm = "drizzle";
+		else if (allDeps.knex) result.orm = "knex";
+		else if (allDeps.typeorm) result.orm = "typeorm";
+		else if (allDeps.sequelize) result.orm = "sequelize";
+		else if (allDeps["@neondatabase/serverless"]) result.orm = "neon-serverless";
+	} catch {}
+	return result;
+}
+function detectMigrations(cwd) {
+	if (existsSync(resolve(cwd, "prisma", "schema.prisma"))) return {
+		tool: "prisma",
+		dir: existsSync(resolve(cwd, "prisma", "migrations")) ? "prisma/migrations" : "none"
+	};
+	if (existsSync(resolve(cwd, "drizzle.config.ts")) || existsSync(resolve(cwd, "drizzle.config.js"))) return {
+		tool: "drizzle",
+		dir: existsSync(resolve(cwd, "drizzle")) ? "drizzle" : "none"
+	};
+	if (existsSync(resolve(cwd, "knexfile.js")) || existsSync(resolve(cwd, "knexfile.ts"))) return {
+		tool: "knex",
+		dir: existsSync(resolve(cwd, "migrations")) ? "migrations" : "none"
+	};
+	return {
+		tool: "none",
+		dir: "none"
+	};
+}
+function checkDatabaseUrl(cwd) {
+	const envPath = resolve(cwd, ".env");
+	if (existsSync(envPath)) try {
+		const content = readFileSync(envPath, "utf-8");
+		if (/^DATABASE_URL=/m.test(content)) return true;
+	} catch {}
+	return false;
+}
+function checkSkillsInstalled(cwd) {
+	const home = process.env.HOME || process.env.USERPROFILE || "";
+	const skillsDirs = [
+		resolve(cwd, ".cursor", "skills"),
+		resolve(cwd, ".claude", "skills"),
+		resolve(cwd, ".agents", "skills"),
+		resolve(home, ".cursor", "skills"),
+		resolve(home, ".claude", "skills")
+	];
+	for (const dir of skillsDirs) if (existsSync(resolve(dir, "neon-postgres", "SKILL.md"))) return true;
+	const claudeMd = resolve(cwd, "CLAUDE.md");
+	if (existsSync(claudeMd)) try {
+		if (readFileSync(claudeMd, "utf-8").includes("neon-postgres")) return true;
+	} catch {}
+	return false;
+}
+function checkVscodeIde() {
+	const env = process.env;
+	return !!(env.TERM_PROGRAM === "vscode" || env.TERM_PROGRAM === "cursor" || env.TERM_PROGRAM === "windsurf" || env.VSCODE_PID || env.VSCODE_CWD);
+}
+/**
+* Detects whether the current directory contains an application.
+* Returns true if package.json has dependencies or common source directories exist.
+*/
+function checkHasApp(cwd) {
+	const pkgPath = resolve(cwd, "package.json");
+	if (existsSync(pkgPath)) try {
+		const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+		const deps = Object.keys(pkg.dependencies ?? {});
+		const devDeps = Object.keys(pkg.devDependencies ?? {});
+		if (deps.length > 0 || devDeps.length > 0) return true;
+	} catch {}
+	for (const indicator of [
+		"src",
+		"app",
+		"pages",
+		"lib",
+		"index.ts",
+		"index.js",
+		"main.ts",
+		"main.js"
+	]) if (existsSync(resolve(cwd, indicator))) return true;
+	return false;
+}
+//#endregion
+export { inspectProject };
+
+//# sourceMappingURL=inspect.js.map

package/dist/lib/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","names":[],"sources":["../../src/lib/inspect.ts"],"sourcesContent":["/**\n * Filesystem-based project inspection for interactive (agentless) mode.\n * Replaces the \"agent_check\" pattern — instead of asking an agent to look,\n * we examine the filesystem directly.\n */\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\nimport type { AgentCheck } from \"./types.js\";\n\nexport interface InspectionResults {\n\t[key: string]: unknown;\n\tmcpConfigured?: boolean;\n\tskillsInstalled?: boolean;\n\t/** True if a Neon-specific connection string (DATABASE_URL with \"neon\" or PGHOST with \"neon\") is found */\n\tconnectionString?: boolean;\n\t/** True if any DATABASE_URL is set in .env (regardless of provider) */\n\tdatabaseUrl?: boolean;\n\tframework?: string;\n\torm?: string;\n\tmigrationTool?: string;\n\tmigrationDir?: string;\n\tisVscodeIde?: boolean;\n\tagent?: string;\n\t/** True if the directory contains an application (package.json with deps, or source files) */\n\thasApp?: boolean;\n}\n\n/**\n * Runs filesystem checks based on the agent_check descriptors.\n * Maps check IDs to concrete inspection functions.\n */\nexport async function inspectProject(\n\tchecks: AgentCheck[],\n): Promise<InspectionResults> {\n\tconst results: InspectionResults = {};\n\tconst cwd = process.cwd();\n\n\tfor (const check of checks) {\n\t\tswitch (check.id) {\n\t\t\tcase \"mcp_server\":\n\t\t\t\tresults.mcpConfigured = checkMcpServer(cwd);\n\t\t\t\tbreak;\n\t\t\tcase \"connection_string\":\n\t\t\t\tresults.connectionString = checkConnectionString(cwd);\n\t\t\t\tbreak;\n\t\t\tcase \"database_url\":\n\t\t\t\tresults.databaseUrl = checkDatabaseUrl(cwd);\n\t\t\t\tbreak;\n\t\t\tcase \"project_stack\": {\n\t\t\t\tconst stack = detectProjectStack(cwd);\n\t\t\t\tresults.framework = stack.framework;\n\t\t\t\tresults.orm = stack.orm;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"migrations\": {\n\t\t\t\tconst migrations = detectMigrations(cwd);\n\t\t\t\tresults.migrationTool = migrations.tool;\n\t\t\t\tresults.migrationDir = migrations.dir;\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tcase \"skills\":\n\t\t\t\tresults.skillsInstalled = checkSkillsInstalled(cwd);\n\t\t\t\tbreak;\n\t\t\tcase \"ide_type\":\n\t\t\t\tresults.isVscodeIde = checkVscodeIde();\n\t\t\t\tbreak;\n\t\t\tcase \"has_app\":\n\t\t\t\tresults.hasApp = checkHasApp(cwd);\n\t\t\t\tbreak;\n\t\t\tcase \"agent_type\":\n\t\t\t\t// Handled by the interactive runner (prompt or env detection)\n\t\t\t\tbreak;\n\t\t}\n\t}\n\n\treturn results;\n}\n\n// ---------------------------------------------------------------------------\n// Individual check implementations\n// ---------------------------------------------------------------------------\n\nfunction checkMcpServer(cwd: string): boolean {\n\t// Check project-level Cursor config\n\tconst cursorMcp = resolve(cwd, \".cursor\", \"mcp.json\");\n\tif (existsSync(cursorMcp)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(cursorMcp, \"utf-8\");\n\t\t\tif (content.includes(\"neon\") || content.includes(\"mcp.neon.tech\")) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t} catch {}\n\t}\n\n\t// Check global Cursor config\n\tconst home = process.env.HOME || process.env.USERPROFILE || \"\";\n\tconst globalCursorMcp = resolve(home, \".cursor\", \"mcp.json\");\n\tif (existsSync(globalCursorMcp)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(globalCursorMcp, \"utf-8\");\n\t\t\tif (content.includes(\"neon\") || content.includes(\"mcp.neon.tech\")) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t} catch {}\n\t}\n\n\t// Check Claude Code config (add-mcp writes to settings.local.json)\n\tfor (const claudeFile of [\"settings.local.json\", \"settings.json\"]) {\n\t\tconst claudeConfig = resolve(home, \".claude\", claudeFile);\n\t\tif (existsSync(claudeConfig)) {\n\t\t\ttry {\n\t\t\t\tconst content = readFileSync(claudeConfig, \"utf-8\");\n\t\t\t\tif (\n\t\t\t\t\tcontent.includes(\"neon\") ||\n\t\t\t\t\tcontent.includes(\"mcp.neon.tech\")\n\t\t\t\t) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t} catch {}\n\t\t}\n\t}\n\n\t// Check VS Code settings\n\tconst vscodeSettings = resolve(cwd, \".vscode\", \"settings.json\");\n\tif (existsSync(vscodeSettings)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(vscodeSettings, \"utf-8\");\n\t\t\tif (content.includes(\"neon\") || content.includes(\"mcp.neon.tech\")) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t} catch {}\n\t}\n\n\treturn false;\n}\n\nfunction checkConnectionString(cwd: string): boolean {\n\tfor (const envFile of [\".env\", \".env.local\"]) {\n\t\tconst envPath = resolve(cwd, envFile);\n\t\tif (existsSync(envPath)) {\n\t\t\ttry {\n\t\t\t\tconst content = readFileSync(envPath, \"utf-8\");\n\t\t\t\tif (\n\t\t\t\t\t/^DATABASE_URL=.*neon/m.test(content) ||\n\t\t\t\t\t/^PGHOST=.*neon/m.test(content)\n\t\t\t\t) {\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t} catch {}\n\t\t}\n\t}\n\treturn false;\n}\n\ninterface StackResult {\n\tframework: string;\n\torm: string;\n}\n\nfunction detectProjectStack(cwd: string): StackResult {\n\tconst result: StackResult = { framework: \"none\", orm: \"none\" };\n\n\tconst pkgPath = resolve(cwd, \"package.json\");\n\tif (!existsSync(pkgPath)) return result;\n\n\ttry {\n\t\tconst pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n\t\tconst allDeps = {\n\t\t\t...pkg.dependencies,\n\t\t\t...pkg.devDependencies,\n\t\t};\n\n\t\t// Framework detection\n\t\tif (allDeps.next) result.framework = \"next\";\n\t\telse if (allDeps.remix || allDeps[\"@remix-run/node\"])\n\t\t\tresult.framework = \"remix\";\n\t\telse if (allDeps.express) result.framework = \"express\";\n\t\telse if (allDeps.hono) result.framework = \"hono\";\n\t\telse if (allDeps.fastify) result.framework = \"fastify\";\n\t\telse if (allDeps[\"@sveltejs/kit\"]) result.framework = \"sveltekit\";\n\t\telse if (allDeps.nuxt) result.framework = \"nuxt\";\n\t\telse if (allDeps.astro) result.framework = \"astro\";\n\n\t\t// ORM detection\n\t\tif (allDeps.prisma || allDeps[\"@prisma/client\"]) result.orm = \"prisma\";\n\t\telse if (allDeps[\"drizzle-orm\"]) result.orm = \"drizzle\";\n\t\telse if (allDeps.knex) result.orm = \"knex\";\n\t\telse if (allDeps.typeorm) result.orm = \"typeorm\";\n\t\telse if (allDeps.sequelize) result.orm = \"sequelize\";\n\t\telse if (allDeps[\"@neondatabase/serverless\"])\n\t\t\tresult.orm = \"neon-serverless\";\n\t} catch {}\n\n\treturn result;\n}\n\ninterface MigrationResult {\n\ttool: string;\n\tdir: string;\n}\n\nfunction detectMigrations(cwd: string): MigrationResult {\n\t// Prisma\n\tif (existsSync(resolve(cwd, \"prisma\", \"schema.prisma\"))) {\n\t\tconst migrationsDir = resolve(cwd, \"prisma\", \"migrations\");\n\t\treturn {\n\t\t\ttool: \"prisma\",\n\t\t\tdir: existsSync(migrationsDir) ? \"prisma/migrations\" : \"none\",\n\t\t};\n\t}\n\n\t// Drizzle\n\tif (\n\t\texistsSync(resolve(cwd, \"drizzle.config.ts\")) ||\n\t\texistsSync(resolve(cwd, \"drizzle.config.js\"))\n\t) {\n\t\tconst drizzleDir = resolve(cwd, \"drizzle\");\n\t\treturn {\n\t\t\ttool: \"drizzle\",\n\t\t\tdir: existsSync(drizzleDir) ? \"drizzle\" : \"none\",\n\t\t};\n\t}\n\n\t// Knex\n\tif (\n\t\texistsSync(resolve(cwd, \"knexfile.js\")) ||\n\t\texistsSync(resolve(cwd, \"knexfile.ts\"))\n\t) {\n\t\tconst migrationsDir = resolve(cwd, \"migrations\");\n\t\treturn {\n\t\t\ttool: \"knex\",\n\t\t\tdir: existsSync(migrationsDir) ? \"migrations\" : \"none\",\n\t\t};\n\t}\n\n\treturn { tool: \"none\", dir: \"none\" };\n}\n\nfunction checkDatabaseUrl(cwd: string): boolean {\n\tconst envPath = resolve(cwd, \".env\");\n\tif (existsSync(envPath)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(envPath, \"utf-8\");\n\t\t\tif (/^DATABASE_URL=/m.test(content)) return true;\n\t\t} catch {}\n\t}\n\treturn false;\n}\n\nfunction checkSkillsInstalled(cwd: string): boolean {\n\tconst home = process.env.HOME || process.env.USERPROFILE || \"\";\n\n\t// Check for neon-postgres SKILL.md in known skill directories (project and global)\n\tconst skillsDirs = [\n\t\tresolve(cwd, \".cursor\", \"skills\"),\n\t\tresolve(cwd, \".claude\", \"skills\"),\n\t\tresolve(cwd, \".agents\", \"skills\"),\n\t\tresolve(home, \".cursor\", \"skills\"),\n\t\tresolve(home, \".claude\", \"skills\"),\n\t];\n\tfor (const dir of skillsDirs) {\n\t\t// Verify the actual skill content file exists, not just the directory\n\t\tconst skillMd = resolve(dir, \"neon-postgres\", \"SKILL.md\");\n\t\tif (existsSync(skillMd)) return true;\n\t}\n\n\t// Check CLAUDE.md for neon skill references (injected by skills CLI)\n\tconst claudeMd = resolve(cwd, \"CLAUDE.md\");\n\tif (existsSync(claudeMd)) {\n\t\ttry {\n\t\t\tconst content = readFileSync(claudeMd, \"utf-8\");\n\t\t\tif (content.includes(\"neon-postgres\")) return true;\n\t\t} catch {}\n\t}\n\n\treturn false;\n}\n\nfunction checkVscodeIde(): boolean {\n\tconst env = process.env;\n\treturn !!(\n\t\tenv.TERM_PROGRAM === \"vscode\" ||\n\t\tenv.TERM_PROGRAM === \"cursor\" ||\n\t\tenv.TERM_PROGRAM === \"windsurf\" ||\n\t\tenv.VSCODE_PID ||\n\t\tenv.VSCODE_CWD\n\t);\n}\n\n/**\n * Detects whether the current directory contains an application.\n * Returns true if package.json has dependencies or common source directories exist.\n */\nfunction checkHasApp(cwd: string): boolean {\n\tconst pkgPath = resolve(cwd, \"package.json\");\n\tif (existsSync(pkgPath)) {\n\t\ttry {\n\t\t\tconst pkg = JSON.parse(readFileSync(pkgPath, \"utf-8\"));\n\t\t\tconst deps = Object.keys(pkg.dependencies ?? {});\n\t\t\tconst devDeps = Object.keys(pkg.devDependencies ?? {});\n\t\t\tif (deps.length > 0 || devDeps.length > 0) return true;\n\t\t} catch {}\n\t}\n\n\t// Check for common source directories / entry files\n\tconst indicators = [\n\t\t\"src\",\n\t\t\"app\",\n\t\t\"pages\",\n\t\t\"lib\",\n\t\t\"index.ts\",\n\t\t\"index.js\",\n\t\t\"main.ts\",\n\t\t\"main.js\",\n\t];\n\tfor (const indicator of indicators) {\n\t\tif (existsSync(resolve(cwd, indicator))) return true;\n\t}\n\n\treturn false;\n}\n"],"mappings":"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"}

package/dist/lib/install.d.ts

@@ -1,11 +1,17 @@
 import { Editor, InstallStatus } from "./types.js";
 
 //#region src/lib/install.d.ts
-
+interface InstallNeonOptions {
+  json?: boolean;
+}
 /**
- * Installs Neon's Local Connect extension or MCP Server for specific editors
+ * Installs Neon's Local Connect extension or MCP Server for specific editors.
+ * Returns a map of editor → install status and whether auth succeeded.
  */
-declare function installNeon(homeDir: string, workspaceDir: string, selectedEditors: Editor[]): Promise<Map<Editor, InstallStatus>>;
+declare function installNeon(selectedEditors: Editor[], options?: InstallNeonOptions): Promise<{
+  results: Map<Editor, InstallStatus>;
+  authSuccess: boolean;
+}>;
 //#endregion
-export { installNeon };
+export { InstallNeonOptions, installNeon };
 //# sourceMappingURL=install.d.ts.map

package/dist/lib/install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","names":[],"sources":["../../src/lib/install.ts"],"sourcesContent":[],"mappings":";;;;;;AA4FA;AAAiC,iBAAX,WAAA,CAAW,OAAA,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,eAAA,EAGf,MAHe,EAAA,CAAA,EAI9B,OAJ8B,CAItB,GAJsB,CAIlB,MAJkB,EAIV,aAJU,CAAA,CAAA"}
+{"version":3,"file":"install.d.ts","names":[],"sources":["../../src/lib/install.ts"],"mappings":";;;UAkDiB,kBAAA;;AAAjB;AAQA;;;;AAG0B,iBAHJ,WAAA,CAGI,eAAA,EAFR,MAEQ,EAAA,EAAA,OAAA,CAAA,EADf,kBACe,CAAA,EAAvB,OAAuB,CAAA;SAAQ,EAAZ,GAAY,CAAR,MAAQ,EAAA,aAAA,CAAA;aAAZ,EAAA,OAAA"}

package/dist/lib/install.js

@@ -1,81 +1,71 @@
-import { configureExtension, installExtension, usesExtension, waitForExtensionInstalled } from "./extension.js";
+import { getAddMcpAgentId } from "./agents.js";
 import { createApiKeyFromNeonctl, ensureNeonctlAuth } from "./auth.js";
-import { getMCPConfig, writeMCPConfig } from "./mcp-config.js";
-import { confirm, isCancel, log, spinner } from "@clack/prompts";
-
+import { configureExtension, installExtension, usesExtension, waitForExtensionInstalled } from "./extension.js";
+import { log, spinner } from "@clack/prompts";
+import { execa } from "execa";
 //#region src/lib/install.ts
+const NEON_MCP_SERVER_URL = "https://mcp.neon.tech/mcp";
 /**
-* Checks if an editor needs MCP configuration
-* Returns true if configuration is needed, false otherwise
+* Installs Neon MCP Server for a single editor via the add-mcp CLI.
+* Uses API key authentication via the Authorization header.
 */
-async function shouldConfigureMCP(homeDir, workspaceDir, editor) {
-	const { config } = getMCPConfig(homeDir, workspaceDir, editor);
-	const serverKey = editor === "VS Code" ? config.servers : config.mcpServers;
-	if (Boolean(serverKey?.Neon)) {
-		const response = await confirm({
-			message: `Neon MCP Server is already configured for ${editor}. Would you like to reconfigure it? (Y/n)`,
-			initialValue: true
-		});
-		if (isCancel(response)) return false;
-		if (!response) {
-			log.info(`Keeping existing MCP server configuration for ${editor}.`);
-			return false;
-		}
-	}
-	return true;
-}
-/**
-* Installs Neon's MCP Server for specific editors
-*/
-async function installMCPServerForEditor(homeDir, workspaceDir, editor, apiKey) {
-	const { config, configPath } = getMCPConfig(homeDir, workspaceDir, editor);
-	const neonServerConfig = {
-		type: "http",
-		url: "https://mcp.neon.tech/mcp",
-		headers: { Authorization: `Bearer ${apiKey}` }
-	};
-	if (!config.mcpServers) config.mcpServers = {};
-	config.mcpServers.Neon = neonServerConfig;
-	try {
-		writeMCPConfig(configPath, config);
-		return "success";
-	} catch (error) {
-		log.error(`Failed to write configuration for ${editor}: ${error instanceof Error ? error.message : "Unknown error"}`);
-		return "failed";
-	}
+async function installMCPServerViaAddMcp(editor, apiKey) {
+	const agentId = getAddMcpAgentId(editor);
+	await execa("npx", [
+		"-y",
+		"add-mcp",
+		NEON_MCP_SERVER_URL,
+		"--header",
+		`Authorization: Bearer ${apiKey}`,
+		"-g",
+		"-n",
+		"Neon",
+		"-y",
+		"-a",
+		agentId
+	], {
+		stdio: "pipe",
+		timeout: 6e4
+	});
 }
 /**
-* Installs Neon's Local Connect extension or MCP Server for specific editors
+* Installs Neon's Local Connect extension or MCP Server for specific editors.
+* Returns a map of editor → install status and whether auth succeeded.
 */
-async function installNeon(homeDir, workspaceDir, selectedEditors) {
+async function installNeon(selectedEditors, options) {
+	const quiet = options?.json === true;
+	const authOptions = { json: quiet };
 	const results = /* @__PURE__ */ new Map();
 	const extensionEditors = selectedEditors.filter(usesExtension);
 	const mcpEditors = selectedEditors.filter((e) => !usesExtension(e));
-	const mcpEditorsToConfigureMap = /* @__PURE__ */ new Map();
-	for (const editor of mcpEditors) {
-		const needsConfig = await shouldConfigureMCP(homeDir, workspaceDir, editor);
-		mcpEditorsToConfigureMap.set(editor, needsConfig);
-		if (!needsConfig) results.set(editor, "success");
-	}
-	const mcpToConfigure = mcpEditors.filter((editor) => mcpEditorsToConfigureMap.get(editor) === true);
-	const extensionsToConfigure = extensionEditors;
-	if (extensionsToConfigure.length === 0 && mcpToConfigure.length === 0) return results;
-	const authSpinner = spinner();
-	authSpinner.start("Authenticating...");
-	if (!await ensureNeonctlAuth()) {
-		authSpinner.stop("Authentication failed");
-		for (const editor of [...extensionsToConfigure, ...mcpToConfigure]) results.set(editor, "failed");
-		return results;
+	if (extensionEditors.length === 0 && mcpEditors.length === 0) return {
+		results,
+		authSuccess: false
+	};
+	const authSpinner = quiet ? null : spinner();
+	authSpinner?.start("Authenticating...");
+	if (!await ensureNeonctlAuth(authOptions)) {
+		authSpinner?.stop("Authentication failed");
+		for (const editor of selectedEditors) results.set(editor, "failed");
+		return {
+			results,
+			authSuccess: false
+		};
 	}
-	authSpinner.stop("Authentication successful ✓");
-	const apiKey = await createApiKeyFromNeonctl();
+	authSpinner?.stop("Authentication successful ✓");
+	const apiKey = await createApiKeyFromNeonctl(authOptions);
 	if (!apiKey) {
-		log.error("Could not create API key after authentication.");
-		log.info("You can manually create one at: https://console.neon.tech/app/settings/api-keys");
-		for (const editor of [...extensionsToConfigure, ...mcpToConfigure]) results.set(editor, "failed");
-		return results;
+		if (!quiet) {
+			log.error("Could not create API key after authentication.");
+			log.info("You can manually create one at: https://console.neon.tech/app/settings/api-keys");
+		}
+		for (const editor of selectedEditors) results.set(editor, "failed");
+		return {
+			results,
+			authSuccess: true
+		};
 	}
-	for (const editor of extensionsToConfigure) {
+	for (const editor of extensionEditors) {
 		if (!await installExtension(editor)) {
 			results.set(editor, "failed");
 			continue;
@@ -85,15 +75,28 @@ async function installNeon(homeDir, workspaceDir, selectedEditors) {
 			continue;
 		}
 		if (await configureExtension(editor, apiKey)) results.set(editor, "success");
-		else results.set(editor, "success");
+		else results.set(editor, "failed");
 	}
-	for (const editor of mcpToConfigure) {
-		const status = await installMCPServerForEditor(homeDir, workspaceDir, editor, apiKey);
-		results.set(editor, status);
+	if (mcpEditors.length > 0) {
+		const mcpSpinner = quiet ? null : spinner();
+		mcpSpinner?.start("Installing and configuring Neon MCP Server...");
+		let mcpSuccessCount = 0;
+		for (const editor of mcpEditors) try {
+			await installMCPServerViaAddMcp(editor, apiKey);
+			results.set(editor, "success");
+			mcpSuccessCount++;
+		} catch (err) {
+			results.set(editor, "failed");
+			if (!quiet && err && typeof err === "object" && "stderr" in err && err.stderr) log.error(String(err.stderr).trim() || "failed to install MCP server via add-mcp");
+		}
+		mcpSpinner?.stop(mcpSuccessCount > 0 ? "Neon MCP Server configuration complete ✓" : "Failed to configure Neon MCP Server");
 	}
-	return results;
+	return {
+		results,
+		authSuccess: true
+	};
 }
-
 //#endregion
 export { installNeon };
+
 //# sourceMappingURL=install.js.map