neon 4.3.1 → 4.5.0

package/dist/commands/plugins.js

@@ -0,0 +1,135 @@
+import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
+import { log } from "../log.js";
+import { writer } from "../writer.js";
+import { noPassthrough } from "../utils/flags.js";
+import { getAgentDisplayName } from "../mcp/agents.js";
+import "../init/agents.js";
+import { canPickAgentsInteractively } from "../utils/agent_picker.js";
+import { resolvePluginsPlan } from "../plugins/plan.js";
+import { NEON_PLUGIN_NAME, neonPluginsRetryCommand, pluginsAddArgs, runPluginsCli } from "../plugins/run.js";
+import { confirmPluginsInstall } from "../plugins/wizard.js";
+//#region src/commands/plugins.ts
+var plugins_exports = /* @__PURE__ */ __exportAll({
+	builder: () => builder,
+	command: () => command,
+	describe: () => describe,
+	handler: () => handler
+});
+const scopeLabel = (scope) => scope === "project" ? "project" : "user";
+const coerceAgents = (value) => {
+	if (value === void 0) return [];
+	const list = Array.isArray(value) ? value : [value];
+	if (list.length === 0) throw new Error("--agent needs a value. Pass one, or omit the flag entirely.");
+	return list.map((item) => {
+		if (typeof item !== "string" || item.trim() === "") throw new Error("--agent needs a value. Pass one, or omit the flag entirely.");
+		return item;
+	});
+};
+const command = "plugins";
+const describe = "Install the Neon plugin into coding agents";
+const builder = (argv) => argv.usage("$0 plugins [options]").options({
+	yes: {
+		alias: "y",
+		type: "boolean",
+		default: false,
+		describe: "Skip prompts"
+	},
+	global: {
+		type: "boolean",
+		default: false,
+		describe: "Install user-level. Default is project"
+	},
+	agent: {
+		alias: "a",
+		type: "array",
+		string: true,
+		describe: "Coding agent to install into (repeatable). Skips the agent picker",
+		coerce: coerceAgents
+	}
+}).example("$0 plugins", "Interactive: agents, then confirm").example("$0 plugins -y", "Detected agents, skip prompts").example("$0 plugins --agent cursor --agent claude-code", "Install into specific agents").example("$0 plugins --global", "Install user-level").strict().check(noPassthrough("plugins"));
+const handler = async (props) => {
+	const cwd = process.cwd();
+	const yes = props.yes === true;
+	const interactive = canPickAgentsInteractively() && !yes;
+	const plan = await resolvePluginsPlan({
+		global: props.global === true,
+		agents: props.agent ?? [],
+		yes,
+		cwd,
+		interactive
+	});
+	for (const agent of plan.skipped) log.warning("Skipping %s: no plugins mapping.", getAgentDisplayName(agent));
+	for (const agent of plan.userScopeSkipped) log.warning("Skipping %s: plugins are user-level. Pass --global.", getAgentDisplayName(agent));
+	if (interactive) {
+		if (!await confirmPluginsInstall({
+			scope: plan.scope,
+			agents: plan.agents
+		})) {
+			log.info("Aborted. Nothing was written.");
+			return;
+		}
+	}
+	const rows = [];
+	const failed = [];
+	const scope = scopeLabel(plan.scope);
+	for (const mapped of plan.targets) {
+		const args = pluginsAddArgs({
+			target: mapped.target,
+			global: plan.scope === "global"
+		});
+		const agent = mapped.agents.join(", ");
+		try {
+			await runPluginsCli({
+				args,
+				cwd
+			});
+			rows.push({
+				scope,
+				plugin: NEON_PLUGIN_NAME,
+				agent,
+				status: "installed"
+			});
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			rows.push({
+				scope,
+				plugin: NEON_PLUGIN_NAME,
+				agent,
+				status: "failed",
+				error: "plugins CLI failed"
+			});
+			failed.push({
+				agents: mapped.agents,
+				message
+			});
+		}
+	}
+	const out = writer(props);
+	out.write(rows, {
+		fields: [
+			"scope",
+			"plugin",
+			"agent",
+			"status",
+			"error"
+		],
+		title: "Plugins"
+	});
+	out.end();
+	if (failed.length === 0) {
+		log.info(plan.scope === "project" ? "Installed the Neon plugin (project)." : "Installed the Neon plugin (user).");
+		return;
+	}
+	const first = failed[0];
+	if (first === void 0) throw new Error("Failed to install the Neon plugin.");
+	const retry = neonPluginsRetryCommand({
+		agents: failed.flatMap((row) => row.agents),
+		global: plan.scope === "global"
+	});
+	if (first.message.includes("needs npx (Node.js)")) throw new Error(first.message);
+	const detail = failed.map((row) => row.message).join("\n");
+	if (failed.length === rows.length) throw new Error(`${detail}\nRetry with: ${retry}`);
+	throw new Error(`Failed to install the Neon plugin for: ${failed.flatMap((row) => row.agents).join(", ")}.\n${detail}\nRetry with: ${retry}`);
+};
+//#endregion
+export { builder, command, describe, handler, plugins_exports as t };

package/dist/commands/profile.js

@@ -1,13 +1,14 @@
 import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
-import { _ as upsertProfile, a as canDropProfilesFile, b as writeSecretFile, c as listProfiles, d as newProfileLocation, f as profilesFilePath, g as selectProfileName, h as resolveProfile, i as assertValidProfileName, l as locationForName, m as readProfiles, n as KEYRING_CREDENTIALS, o as credentialsDisplay, p as profilesUsingPath, r as assertProfilesUsable, s as isKeyringPointer, u as locationOf, v as CRED_STORAGE_FILE, y as CRED_STORAGE_KEYRING } from "../_chunks/profiles-CVXNvU2r.js";
-import { c as describeScope, d as scopeOf, l as interpretCredentials, n as KEYRING_SERVICE, o as apiKeyCredentials, r as keyringAccount, s as credentialLabel, t as storeFor } from "../_chunks/credential_io-D2vw1UOw.js";
+import { t as writeSecretFile } from "../_chunks/secure_file-BucZj4yQ.js";
+import { c as describeScope, d as scopeOf, l as interpretCredentials, n as KEYRING_SERVICE, o as apiKeyCredentials, r as keyringAccount, s as credentialLabel, t as storeFor } from "../_chunks/credential_io-B1JxWELN.js";
 import { isCi } from "../env.js";
 import { log } from "../log.js";
 import { getApiClient, isNeonApiError } from "../api.js";
 import { o as isOwnedCredentialPath, r as credentialsPath } from "../_chunks/paths-g3DRqJiD.js";
 import { setAuthContext } from "../auth_context.js";
+import { _ as upsertProfile, a as canDropProfilesFile, c as listProfiles, d as newProfileLocation, f as profilesFilePath, g as selectProfileName, h as resolveProfile, i as assertValidProfileName, l as locationForName, m as readProfiles, n as KEYRING_CREDENTIALS, o as credentialsDisplay, p as profilesUsingPath, r as assertProfilesUsable, s as isKeyringPointer, u as locationOf, v as CRED_STORAGE_FILE, y as CRED_STORAGE_KEYRING } from "../_chunks/profiles-D95AeZ5v.js";
 import { auth, revokeToken } from "../auth.js";
-import { t as credentialInputs } from "../_chunks/auth_selection-Bx2NAgkk.js";
+import { t as credentialInputs } from "../_chunks/auth_selection-ktL6uoEe.js";
 import { readOutgoingCredential, retirePreviousCredential, revokeTokenSet, withdrawKey } from "../retire_credential.js";
 import { authFlow, usableCredential } from "./auth.js";
 import { writer } from "../writer.js";

package/dist/config_services.js

@@ -0,0 +1,18 @@
+//#region src/config_services.ts
+const isToggleEnabled = (toggle) => {
+	if (toggle === void 0) return false;
+	if (typeof toggle === "boolean") return toggle;
+	return toggle.enabled !== false;
+};
+/** Postgres is omitted because every project includes it. */
+const declaredNeonServices = (config) => {
+	const services = [];
+	if (isToggleEnabled(config.auth)) services.push("auth");
+	if (isToggleEnabled(config.dataApi)) services.push("data-api");
+	if (Object.keys(config.preview?.buckets ?? {}).length > 0) services.push("object-storage");
+	if (Object.keys(config.preview?.functions ?? {}).length > 0) services.push("functions");
+	if (isToggleEnabled(config.preview?.aiGateway)) services.push("ai-gateway");
+	return services;
+};
+//#endregion
+export { declaredNeonServices };

package/dist/context.js

@@ -45,6 +45,7 @@ const isConfigInit = (args) => args._[0] === "config" && args._[1] === "init" &&
 * access has already lapsed is the main reason to remove one.
 */
 const isProfileCommand = (args) => args._[0] === "profile" || args._[0] === "profiles";
+const isClaimCommand = (args) => args._[0] === "claim" || args._[0] === "claimable";
 /**
 * `neon api-keys …`, under either spelling. Exempts the group from context enrichment: how
 * far a credential reaches must come from an explicit flag, never from `.neon`.
@@ -52,6 +53,7 @@ const isProfileCommand = (args) => args._[0] === "profile" || args._[0] === "pro
 const isApiKeysCommand = (args) => args._[0] === "api-keys" || args._[0] === "api-key";
 const isMcpCommand = (args) => args._[0] === "mcp";
 const isSkillsCommand = (args) => args._[0] === "skills";
+const isPluginsCommand = (args) => args._[0] === "plugins";
 /** Raw argv is required because auth middleware runs before MCP flags are parsed. */
 const isMcpOauth = (args) => isMcpCommand(args) && argvEnablesMcpOauth(process.argv);
 const OAUTH_FALSE = /* @__PURE__ */ new Set([
@@ -131,7 +133,8 @@ const enrichFromContext = (args) => {
 	if (isApiKeysCommand(args)) return;
 	if (isProfileCommand(args)) return;
 	if (isMcpCommand(args)) return;
-	if (isSkillsCommand(args)) return;
+	if (isSkillsCommand(args) || isPluginsCommand(args)) return;
+	if (isClaimCommand(args)) return;
 	const context = readContextFile(args.contextFile);
 	if (!args.orgId) args.orgId = context.orgId;
 	if (!args.projectId) args.projectId = context.projectId;
@@ -237,4 +240,4 @@ const globToRegExp = (pattern) => {
 	return new RegExp(`^${source}$`);
 };
 //#endregion
-export { applyContext, contextBranch, currentContextFile, enrichFromContext, ensureGitignored, isApiKeysCommand, isConfigInit, isCurrentBranchProbe, isMcpCommand, isMcpOauth, isProfileCommand, isSkillsCommand, readContextFile, setContext, updateContextFile, walkContextFile };
+export { applyContext, contextBranch, currentContextFile, enrichFromContext, ensureGitignored, isApiKeysCommand, isClaimCommand, isConfigInit, isCurrentBranchProbe, isMcpCommand, isMcpOauth, isPluginsCommand, isProfileCommand, isSkillsCommand, readContextFile, setContext, updateContextFile, walkContextFile };

package/dist/credential_io.js

@@ -1,2 +1,2 @@
-import { t as storeFor } from "./_chunks/credential_io-D2vw1UOw.js";
+import { t as storeFor } from "./_chunks/credential_io-B1JxWELN.js";
 export { storeFor };

package/dist/env.js

@@ -5,6 +5,11 @@ const isCi = () => {
 const isDebug = () => {
 	return Boolean(process.env.DEBUG);
 };
+const getCliAgent = (env) => {
+	const claudeCode = env.CLAUDE_CODE_CHILD_SESSION === "1";
+	if (claudeCode === (env.CODEX_CI === "1" && (Boolean(env.CODEX_THREAD_ID?.trim()) || Boolean(env.CODEX_SESSION_ID?.trim())))) return void 0;
+	return claudeCode ? "claude-code" : "codex";
+};
 const getGithubEnvVars = (env) => {
 	const vars = [
 		"GITHUB_ACTION_PATH",
@@ -27,4 +32,4 @@ const getGithubEnvVars = (env) => {
 	return Object.fromEntries(map);
 };
 //#endregion
-export { getGithubEnvVars, isCi, isDebug };
+export { getCliAgent, getGithubEnvVars, isCi, isDebug };

package/dist/index.js

@@ -30,6 +30,7 @@ const NO_SUBCOMMANDS_VERBS = [
 	"open",
 	"init",
 	"mcp",
+	"plugins",
 	"skills",
 	"dev",
 	"deploy",

package/dist/init/auth.js

@@ -1,5 +1,5 @@
-import { l as locationForName } from "../_chunks/profiles-CVXNvU2r.js";
-import { l as interpretCredentials, t as storeFor } from "../_chunks/credential_io-D2vw1UOw.js";
+import { l as interpretCredentials, t as storeFor } from "../_chunks/credential_io-B1JxWELN.js";
+import { l as locationForName } from "../_chunks/profiles-D95AeZ5v.js";
 import { npxNeonArgs, selectedConfigDir, selectedProfileName } from "./profile_cli.js";
 import { log } from "@clack/prompts";
 import { execa } from "execa";

package/dist/init/profile_cli.js

@@ -1,6 +1,6 @@
-import { t as DEFAULT_PROFILE } from "../_chunks/profiles-CVXNvU2r.js";
 import { n as configDir } from "../_chunks/paths-g3DRqJiD.js";
-import { i as selectCredential, t as credentialInputs } from "../_chunks/auth_selection-Bx2NAgkk.js";
+import { t as DEFAULT_PROFILE } from "../_chunks/profiles-D95AeZ5v.js";
+import { i as selectCredential, t as credentialInputs } from "../_chunks/auth_selection-ktL6uoEe.js";
 //#region src/init/profile_cli.ts
 /**
 * API-key selections fall back to DEFAULT because init authenticates from stored credentials.

package/dist/plugins/plan.js

@@ -0,0 +1,69 @@
+import { getAgentDisplayName, tryResolveAddMcpAgentId } from "../mcp/agents.js";
+import "../init/agents.js";
+import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
+import { detectPluginsAgents, getPluginsTargetName, isUserScopeOnlyPluginsTarget, mappedPluginsTargets, pluginsInstallableAgents } from "./targets.js";
+//#region src/plugins/plan.ts
+const assertPluginsCanRun = (options) => {
+	if (options.yes || options.interactive || options.hasAgents) return;
+	throw new Error("No interactive terminal. Pass -y to install into detected agents, or --agent <name>.");
+};
+async function resolvePluginsPlan(options) {
+	assertPluginsCanRun({
+		yes: options.yes,
+		interactive: options.interactive,
+		hasAgents: options.agents.length > 0
+	});
+	const prompt = options.interactive && !options.yes;
+	const scope = options.global ? "global" : "project";
+	const available = pluginsInstallableAgents(scope);
+	const detected = await detectPluginsAgents({
+		scope,
+		cwd: options.cwd
+	});
+	const selected = await resolveAgentSelection({
+		specified: options.agents,
+		choices: agentChoicesFrom(available, detected),
+		detected,
+		message: "Which coding agents should get the Neon plugin? (space to toggle, enter to confirm)",
+		nonInteractiveMessage: scope === "project" ? `No coding agents detected in this project. Pass --agent <name>. Supported agents: ${available.join(", ")}` : `No coding agents detected. Pass --agent <name>. Supported agents: ${available.join(", ")}`,
+		resolveSpecified: (raw) => {
+			if (raw === "*") throw new Error("neon plugins does not accept --agent *. Pass --agent <name> for each coding agent, or omit --agent to use detected agents.");
+			const id = tryResolveAddMcpAgentId(raw);
+			if (!id) throw new Error(`Unknown agent: "${raw}". Supported agents: ${available.join(", ")}`);
+			return id;
+		},
+		pick: prompt ? options.pickAgents ?? pickAgentsInteractively : void 0,
+		interactive: prompt
+	});
+	const agents = [];
+	const skipped = [];
+	const userScopeSkipped = [];
+	for (const id of selected) {
+		const target = getPluginsTargetName(id);
+		if (target === void 0) {
+			skipped.push(id);
+			continue;
+		}
+		if (scope === "project" && isUserScopeOnlyPluginsTarget(target)) {
+			userScopeSkipped.push(id);
+			continue;
+		}
+		agents.push(id);
+	}
+	if (agents.length === 0) {
+		if (userScopeSkipped.length > 0 && skipped.length === 0) {
+			const names = userScopeSkipped.map((id) => getAgentDisplayName(id)).join(", ");
+			throw new Error(`${names}: plugins are user-level. Pass --global. Without --global: ${pluginsInstallableAgents("project").join(", ")}`);
+		}
+		throw new Error(`None of the selected agents can install plugins. Supported agents: ${available.join(", ")}`);
+	}
+	return {
+		scope,
+		agents,
+		skipped,
+		userScopeSkipped,
+		targets: mappedPluginsTargets(agents, scope)
+	};
+}
+//#endregion
+export { assertPluginsCanRun, resolvePluginsPlan };

package/dist/plugins/run.js

@@ -0,0 +1,123 @@
+import { spawnSync } from "node:child_process";
+import { execa } from "execa";
+//#region src/plugins/run.ts
+const TELEMETRY_BLOCKERS = ["DISABLE_TELEMETRY", "DO_NOT_TRACK"];
+const PLUGIN_SOURCE = "neondatabase/agent-skills";
+const NEON_PLUGIN_NAME = "neon-postgres";
+const PLUGINS_CLI_TIMEOUT_MS = 12e4;
+const pluginsChildEnv = (base = process.env) => {
+	const env = { ...base };
+	for (const key of TELEMETRY_BLOCKERS) delete env[key];
+	for (const key of Object.keys(env)) if (key.toUpperCase() === "NEON_API_KEY") delete env[key];
+	return env;
+};
+const pluginsScopeFlag = (global) => global ? "user" : "project";
+const pluginsAddArgs = (options) => {
+	if (options.target.length === 0) throw new Error("plugins add needs a -t target.");
+	return [
+		"-y",
+		"plugins",
+		"add",
+		PLUGIN_SOURCE,
+		"-t",
+		options.target,
+		"-s",
+		pluginsScopeFlag(options.global),
+		"-y"
+	];
+};
+const neonPluginsRetryCommand = (options) => {
+	const args = ["plugins"];
+	for (const agent of options.agents) args.push("--agent", agent);
+	if (options.global) args.push("--global");
+	args.push("-y");
+	return `neon ${args.map(quoteNpxArg).join(" ")}`;
+};
+const quoteNpxArg = (part) => /[\s"'\\*]/.test(part) ? `'${part.replace(/'/g, `'\\''`)}'` : part;
+const runPluginsCli = async (options) => {
+	const timeoutMs = options.timeoutMs ?? 12e4;
+	const subprocess = execa("npx", options.args, {
+		cwd: options.cwd,
+		env: pluginsChildEnv(options.env ?? process.env),
+		extendEnv: false,
+		stdio: "pipe",
+		detached: true
+	});
+	let timedOut = false;
+	let stopped = false;
+	const stop = () => {
+		if (stopped) return;
+		stopped = true;
+		if (subprocess.pid !== void 0) killProcessTree(subprocess.pid);
+	};
+	const onSigint = () => {
+		stop();
+		process.exit(130);
+	};
+	const onSigterm = () => {
+		stop();
+		process.exit(143);
+	};
+	process.once("SIGINT", onSigint);
+	process.once("SIGTERM", onSigterm);
+	process.once("exit", stop);
+	const timer = setTimeout(() => {
+		timedOut = true;
+		stop();
+	}, timeoutMs);
+	try {
+		const result = await subprocess;
+		return {
+			stdout: result.stdout,
+			stderr: result.stderr
+		};
+	} catch (error) {
+		if (isCommandMissing(error)) throw new Error("neon plugins needs npx (Node.js) to run the plugins CLI. Install Node.js, then retry.");
+		if (isExecaFailure(error)) throw new Error(pluginsCliFailureMessage({
+			stderr: typeof error.stderr === "string" ? error.stderr : "",
+			stdout: typeof error.stdout === "string" ? error.stdout : "",
+			timedOut,
+			timeoutMs
+		}));
+		throw error;
+	} finally {
+		clearTimeout(timer);
+		process.removeListener("SIGINT", onSigint);
+		process.removeListener("SIGTERM", onSigterm);
+		process.removeListener("exit", stop);
+	}
+};
+const pluginsCliFailureMessage = (error) => {
+	const childOut = [error.stderr, error.stdout].filter((part) => typeof part === "string" && part.length > 0).join("\n");
+	if (error.timedOut === true) {
+		const seconds = Math.max(1, Math.ceil((error.timeoutMs ?? 12e4) / 1e3));
+		const headline = `plugins CLI timed out after ${seconds} ${seconds === 1 ? "second" : "seconds"}`;
+		return childOut.length > 0 ? `${headline}:\n${childOut}` : `${headline}.`;
+	}
+	if (childOut.length > 0) return `plugins CLI failed:\n${childOut}`;
+	return "plugins CLI failed.";
+};
+const killProcessTree = (pid) => {
+	if (process.platform === "win32") {
+		spawnSync("taskkill", [
+			"/pid",
+			String(pid),
+			"/T",
+			"/F"
+		], { stdio: "ignore" });
+		return;
+	}
+	try {
+		process.kill(-pid, "SIGKILL");
+	} catch {
+		try {
+			process.kill(pid, "SIGKILL");
+		} catch {
+			return;
+		}
+	}
+};
+const isCommandMissing = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+const isExecaFailure = (error) => typeof error === "object" && error !== null && "shortMessage" in error && typeof error.shortMessage === "string";
+//#endregion
+export { NEON_PLUGIN_NAME, PLUGINS_CLI_TIMEOUT_MS, PLUGIN_SOURCE, neonPluginsRetryCommand, pluginsAddArgs, pluginsChildEnv, pluginsCliFailureMessage, pluginsScopeFlag, quoteNpxArg, runPluginsCli };

package/dist/plugins/targets.js

@@ -0,0 +1,64 @@
+import { detectInstalledAgents, listMcpAgentIds, tryResolveAddMcpAgentId, uniqueAgentIds } from "../mcp/agents.js";
+import "../init/agents.js";
+import { detectProjectAgents } from "add-mcp";
+//#region src/plugins/targets.ts
+const PLUGINS_TARGET_BY_TYPE = {
+	cursor: "cursor",
+	vscode: "vscode",
+	"claude-code": "claude-code",
+	"claude-desktop": "claude-code",
+	codex: "codex",
+	"github-copilot-cli": "github-copilot",
+	"grok-build": "grok"
+};
+const USER_SCOPE_ONLY_TARGETS = /* @__PURE__ */ new Set([
+	"vscode",
+	"github-copilot",
+	"grok"
+]);
+function getPluginsTargetName(agent) {
+	if (Object.prototype.hasOwnProperty.call(PLUGINS_TARGET_BY_TYPE, agent)) return PLUGINS_TARGET_BY_TYPE[agent];
+	const id = tryResolveAddMcpAgentId(agent);
+	if (!id) return void 0;
+	return PLUGINS_TARGET_BY_TYPE[id];
+}
+function supportsPlugins(agent) {
+	return getPluginsTargetName(agent) !== void 0;
+}
+function isUserScopeOnlyPluginsTarget(target) {
+	return USER_SCOPE_ONLY_TARGETS.has(target);
+}
+const pluginsMappedAgents = () => listMcpAgentIds().filter((id) => supportsPlugins(id));
+const pluginsInstallableAgents = (scope) => pluginsMappedAgents().filter((id) => {
+	if (scope === "global") return true;
+	const target = getPluginsTargetName(id);
+	return target !== void 0 && !isUserScopeOnlyPluginsTarget(target);
+});
+const detectPluginsAgents = async (options) => {
+	const detected = options.scope === "project" ? detectProjectAgents(options.cwd) : await detectInstalledAgents();
+	return uniqueAgentIds(detected).filter((id) => supportsPlugins(id));
+};
+const mappedPluginsTargets = (agents, scope) => {
+	const mapped = [];
+	const byTarget = /* @__PURE__ */ new Map();
+	for (const agent of agents) {
+		const target = getPluginsTargetName(agent);
+		if (target === void 0) continue;
+		if (scope === "project" && isUserScopeOnlyPluginsTarget(target)) continue;
+		const existing = byTarget.get(target);
+		if (existing !== void 0) {
+			if (!existing.agents.includes(agent)) existing.agents.push(agent);
+			continue;
+		}
+		const row = {
+			agents: [agent],
+			target
+		};
+		byTarget.set(target, row);
+		mapped.push(row);
+	}
+	if (mapped.length === 0) throw new Error(`None of the selected agents can install plugins. Supported agents: ${pluginsInstallableAgents(scope).join(", ")}`);
+	return mapped;
+};
+//#endregion
+export { detectPluginsAgents, getPluginsTargetName, isUserScopeOnlyPluginsTarget, mappedPluginsTargets, pluginsInstallableAgents, pluginsMappedAgents, supportsPlugins };

package/dist/plugins/wizard.js

@@ -0,0 +1,36 @@
+import { getAgentDisplayName } from "../mcp/agents.js";
+import "../init/agents.js";
+import { canPickAgentsInteractively } from "../utils/agent_picker.js";
+import { NEON_PLUGIN_NAME } from "./run.js";
+import prompts from "prompts";
+//#region src/plugins/wizard.ts
+const restoreCursorOnAbort = (state) => {
+	if (state.aborted) {
+		process.stdout.write("\x1B[?25h");
+		process.stdout.write("\n");
+		process.exit(1);
+	}
+};
+const pluginsInstallSummary = (options) => {
+	const rows = [
+		["Scope", options.scope === "project" ? "project" : "user"],
+		["Agents", options.agents.map(getAgentDisplayName).join(", ")],
+		["Plugin", NEON_PLUGIN_NAME]
+	];
+	const labelWidth = Math.max(...rows.map(([label]) => label.length));
+	return rows.map(([label, value]) => `${label.padEnd(labelWidth)}  ${value}`).join("\n");
+};
+const confirmPluginsInstall = async (options) => {
+	if (!canPickAgentsInteractively()) return true;
+	process.stdout.write(`\n${pluginsInstallSummary(options)}\n\n`);
+	const { ok } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "confirm",
+		name: "ok",
+		message: "Install the Neon plugin into these agents?",
+		initial: true
+	});
+	return ok === true;
+};
+//#endregion
+export { confirmPluginsInstall, pluginsInstallSummary };

package/dist/retire_credential.js

@@ -1,4 +1,4 @@
-import { a as OAUTH, d as scopeOf, i as API_KEY, l as interpretCredentials, t as storeFor, u as isSameCredential } from "./_chunks/credential_io-D2vw1UOw.js";
+import { a as OAUTH, d as scopeOf, i as API_KEY, l as interpretCredentials, t as storeFor, u as isSameCredential } from "./_chunks/credential_io-B1JxWELN.js";
 import { log } from "./log.js";
 import { getApiClient } from "./api.js";
 import { revokeToken } from "./auth.js";

package/dist/utils/middlewares.js

@@ -1,4 +1,4 @@
-import { r as recordCredentialInputs } from "../_chunks/auth_selection-Bx2NAgkk.js";
+import { r as recordCredentialInputs } from "../_chunks/auth_selection-ktL6uoEe.js";
 //#region src/utils/middlewares.ts
 /**
 * Forwarding Yargs's default would turn ambient configuration into an explicit child override.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon",
-  "version": "4.3.1",
+  "version": "4.5.0",
   "description": "CLI tool for Neon, the cloud backend primitives built around Lakebase Postgres",
   "keywords": [
     "neon",
@@ -63,9 +63,9 @@
     "yaml": "^2.9.0",
     "yargs": "17.7.2",
     "yoctocolors": "^2.1.2",
-    "@neon/config": "1.0.2",
+    "@neon/config-runtime": "1.0.3",
     "@neon/sdk": "2.2.0",
-    "@neon/config-runtime": "1.0.2"
+    "@neon/config": "1.0.3"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "1.3.0",
@@ -97,8 +97,8 @@
     "typescript": "^5.9.0",
     "vitest": "^3.0.9",
     "@neon-internals/cli-core": "0.0.0",
-    "@neon-internals/env-core": "0.0.2",
-    "@neon/e2e-harness": "0.0.0"
+    "@neon/e2e-harness": "0.0.0",
+    "@neon-internals/env-core": "0.0.3"
   },
   "publishConfig": {
     "access": "public",