neon 5.0.1 → 6.1.0

package/dist/init/tooling.js

@@ -1,23 +1,109 @@
 import { log } from "../log.js";
 import { getCliName } from "../utils/cli_name.js";
-import { AUTH_CHILD } from "./child.js";
-import { initStepLabel } from "./chrome.js";
-import { assertNamedAgentTooling, childArgv, chooseYesAgentTooling, collectYesAgents, initYesSupportedAgents, noDetectedAgentsMessage, planAgentSteps, planToolingSteps, planYesAgentSteps, resolveInitAgentSetup } from "./plan.js";
-import { canPickAgentsInteractively } from "../utils/agent_picker.js";
+import { PROGRESS } from "./copy.js";
+import { assertNamedAgentTooling, chooseYesAgentTooling, collectYesAgents, initYesSupportedAgents, noDetectedAgentsMessage, planAgentSteps, planToolingSteps, planYesAgentSteps, resolveInitAgentSetup } from "./plan.js";
 import { detectAgent } from "./detect_host.js";
+import { canPickAgentsInteractively } from "../utils/agent_picker.js";
+import { mcpInstallError, reportMcpInstall } from "../commands/mcp.js";
+import { installPlugins, pluginsInstallError, reportPluginsInstall } from "../commands/plugins.js";
+import { installSkills, reportSkillsInstall, skillsInstallError } from "../commands/skills.js";
+import { runAuthenticatedMcp } from "./auth.js";
+import { raceSigint } from "./cancelled.js";
 import { pickAgentSetupInteractively } from "./wizard.js";
 import { detectProjectAgents } from "add-mcp";
 //#region src/init/tooling.ts
 const defaultProjectAgents = (cwd) => detectProjectAgents(cwd);
-const runInitSteps = async (steps, options) => {
+const TOOLING_STEP_LABELS = {
+	plugins: PROGRESS.plugins,
+	skills: PROGRESS.skills,
+	mcp: PROGRESS.mcp
+};
+/** Reconstructs a display-only, `neon <command> <flags>` style string for a step. Never executed — only ever logged. */
+const toolingStepCommandText = (step) => {
+	const flags = [];
+	switch (step.kind) {
+		case "plugins": {
+			const { options } = step;
+			if (options.yes) flags.push("-y");
+			if (options.global) flags.push("--global");
+			for (const agent of options.agents ?? []) flags.push("--agent", agent);
+			break;
+		}
+		case "skills": {
+			const { options } = step;
+			if (options.yes) flags.push("-y");
+			if (options.global) flags.push("--global");
+			for (const skill of options.skills ?? []) flags.push("--skill", skill);
+			for (const agent of options.agents ?? []) flags.push("--agent", agent);
+			break;
+		}
+		case "mcp": {
+			const { options } = step;
+			if (options.yes) flags.push("-y");
+			if (options.oauth) flags.push("--oauth");
+			if (options.project) flags.push("--project");
+			if (options.projectId !== void 0) flags.push("--project-id", options.projectId);
+			for (const agent of options.agent ?? []) flags.push("--agent", agent);
+			break;
+		}
+		default: return step;
+	}
+	return [step.kind, ...flags].join(" ");
+};
+/**
+* Runs plugins/skills/mcp installs in-process, in order, via {@link ToolingOperations}. This
+* replaces re-executing the `neon` binary as a child process (`neon plugins`, `neon skills`,
+* `neon mcp`) to reuse those commands — see `packages/cli/AGENTS.md`.
+*/
+const runToolingSteps = async (steps, options) => {
+	const ops = {
+		installPlugins,
+		installSkills,
+		installMcp: (stepOptions) => runAuthenticatedMcp({
+			...stepOptions,
+			...options.auth
+		}),
+		...options.operations
+	};
+	const reportProps = { output: options.output };
 	for (const step of steps) {
-		const label = options.narrate === "human" ? initStepLabel(step) : void 0;
-		if (label !== void 0) log.info(label);
-		else log.info("Running `%s %s`", getCliName(), step.join(" "));
-		log.debug("Running `%s %s`", getCliName(), step.join(" "));
-		const argv = childArgv(step, options.forward);
-		const command = step[0];
-		if (!await options.run(argv, options.cwd, command !== void 0 && AUTH_CHILD.has(command) ? options.authEnv : void 0)) throw new Error(`\`${getCliName()} ${step.join(" ")}\` failed.`);
+		const label = options.narrate === "human" ? TOOLING_STEP_LABELS[step.kind] : void 0;
+		if (label !== void 0) process.stdout.write(`${label}\n`);
+		else log.info("Running `%s %s`", getCliName(), toolingStepCommandText(step));
+		log.debug("Running `%s %s`", getCliName(), toolingStepCommandText(step));
+		switch (step.kind) {
+			case "plugins": {
+				const outcome = await raceSigint(ops.installPlugins({
+					...step.options,
+					cwd: options.cwd
+				}));
+				reportPluginsInstall(reportProps, outcome);
+				const error = pluginsInstallError(outcome);
+				if (error) throw error;
+				break;
+			}
+			case "skills": {
+				const outcome = await raceSigint(ops.installSkills({
+					...step.options,
+					cwd: options.cwd
+				}));
+				reportSkillsInstall(reportProps, outcome);
+				const error = skillsInstallError(outcome);
+				if (error) throw error;
+				break;
+			}
+			case "mcp": {
+				const outcome = await raceSigint(ops.installMcp({
+					...step.options,
+					cwd: options.cwd
+				}));
+				reportMcpInstall(reportProps, outcome);
+				const error = mcpInstallError(outcome);
+				if (error) throw error;
+				break;
+			}
+			default: return step;
+		}
 	}
 };
 const yesAgentsFromOptions = async (options) => collectYesAgents({
@@ -36,14 +122,14 @@ const runAgentTooling = async (options) => {
 	if (named.length > 0) {
 		assertNamedAgentTooling(named, options.command ?? "init");
 		const tooling = chooseYesAgentTooling(named);
-		await runInitSteps(planToolingSteps(tooling, {
+		await runToolingSteps(planToolingSteps(tooling, {
 			yes,
 			named: true
 		}), options);
 		return tooling.setup;
 	}
 	if (options.agentSetup !== void 0) {
-		await runInitSteps(planAgentSteps({
+		await runToolingSteps(planAgentSteps({
 			yes,
 			agentSetup: options.agentSetup
 		}), options);
@@ -52,7 +138,7 @@ const runAgentTooling = async (options) => {
 	if (yes) {
 		if (options.hasProjectPlugins !== void 0) {
 			const agentSetup = await options.hasProjectPlugins(options.cwd) ? "plugin" : "skills-mcp";
-			await runInitSteps(planAgentSteps({
+			await runToolingSteps(planAgentSteps({
 				yes: true,
 				agentSetup
 			}), options);
@@ -61,7 +147,7 @@ const runAgentTooling = async (options) => {
 		const agents = await yesAgentsFromOptions(options);
 		const tooling = chooseYesAgentTooling(agents);
 		if (tooling.setup === "skip") throw yesMiss();
-		await runInitSteps(planYesAgentSteps(tooling), options);
+		await runToolingSteps(planYesAgentSteps(tooling), options);
 		return tooling.setup;
 	}
 	const interactive = options.pickAgentSetup !== void 0 || canPickAgentsInteractively();
@@ -69,15 +155,11 @@ const runAgentTooling = async (options) => {
 		interactive,
 		pick: options.pickAgentSetup ?? pickAgentSetupInteractively
 	});
-	await runInitSteps(planAgentSteps({
+	await runToolingSteps(planAgentSteps({
 		yes,
 		agentSetup
 	}), options);
 	return agentSetup;
 };
-const runScaffoldFollowUp = async (options) => {
-	if (!options.skipAgentSetup) await runAgentTooling(options);
-	if (options.shouldLink) await runInitSteps([options.linkYes ? ["link", "--yes"] : ["link"]], options);
-};
 //#endregion
-export { runAgentTooling, runInitSteps, runScaffoldFollowUp };
+export { runAgentTooling, runToolingSteps };

package/dist/init/wizard.js

@@ -1,96 +1,254 @@
+import { CONFIG_INIT_SERVICES } from "../config_template.js";
+import { AGENT_DETECTED_DESCRIPTION, AGENT_OTHER_DESCRIPTION, AGENT_PICKER_MESSAGE, AGENT_SETUP_MESSAGE, AGENT_SETUP_PLUGIN_DESCRIPTION, AGENT_SETUP_PLUGIN_TITLE, AGENT_SETUP_SKILLS_DESCRIPTION, AGENT_SETUP_SKILLS_TITLE, AGENT_SETUP_SKIP_DESCRIPTION, AGENT_SETUP_SKIP_TITLE, CONFIG_CONFIRM_HINT, CONFIG_CONFIRM_MESSAGE, MCP_AUTH_API_KEY_DESCRIPTION, MCP_AUTH_API_KEY_TITLE, MCP_AUTH_MESSAGE, MCP_AUTH_OAUTH_DESCRIPTION, MCP_AUTH_OAUTH_TITLE, MCP_SCOPE_GLOBAL_DESCRIPTION, MCP_SCOPE_GLOBAL_TITLE, MCP_SCOPE_MESSAGE, MCP_SCOPE_PROJECT_DESCRIPTION, MCP_SCOPE_PROJECT_TITLE, MODE_CUSTOM_DESCRIPTION, MODE_CUSTOM_TITLE, MODE_MESSAGE, MODE_RECOMMENDED_DESCRIPTION, MODE_RECOMMENDED_TITLE, PACKAGE_MANAGER_MESSAGE, PROJECT_SETUP_CLAIMABLE_DESCRIPTION, PROJECT_SETUP_CLAIMABLE_TITLE, PROJECT_SETUP_LINK_DESCRIPTION, PROJECT_SETUP_LINK_TITLE, PROJECT_SETUP_MESSAGE, SERVICES_HINT, SERVICES_MESSAGE, SKILLS_PICKER_MESSAGE } from "./copy.js";
+import { installedPackageManagers } from "../utils/package_manager.js";
+import { POSTGRES_SERVICE_CHOICE, keepPostgresSelected } from "../utils/service_picker.js";
+import { getAgentDisplayName, listMcpAgentIds } from "../mcp/agents.js";
 import { INIT_NEEDS_YES_OR_TERMINAL } from "./plan.js";
-import { SKIP_TEMPLATE_VALUE, formatTemplateTitle } from "./template_title.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
-import { NEON_PLUGIN_NAME } from "../plugins/run.js";
+import { NEON_SKILL_CATALOG, listSkillIds } from "../skills/catalog.js";
+import { InitCancelled, restoreCursorVisibilityOnAbort } from "./cancelled.js";
 import chalk from "chalk";
 import prompts from "prompts";
 //#region src/init/wizard.ts
 const restoreCursorOnAbort = (state) => {
-	if (state.aborted) {
-		process.stdout.write("\x1B[?25h");
-		process.stdout.write("\n");
-		process.exit(1);
-	}
+	restoreCursorVisibilityOnAbort(state);
 };
 const requireInteractive = () => {
 	if (!canPickAgentsInteractively()) throw new Error(INIT_NEEDS_YES_OR_TERMINAL);
 };
+const aborted = () => {
+	throw new InitCancelled();
+};
+const pickInitModeInteractively = async () => {
+	requireInteractive();
+	const { mode } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "select",
+		name: "mode",
+		message: MODE_MESSAGE,
+		initial: 0,
+		choices: [{
+			title: MODE_RECOMMENDED_TITLE,
+			value: "recommended",
+			description: MODE_RECOMMENDED_DESCRIPTION
+		}, {
+			title: MODE_CUSTOM_TITLE,
+			value: "custom",
+			description: MODE_CUSTOM_DESCRIPTION
+		}]
+	});
+	if (mode !== "recommended" && mode !== "custom") return aborted();
+	return mode;
+};
 const pickAgentSetupInteractively = async () => {
 	requireInteractive();
 	const { setup } = await prompts({
 		onState: restoreCursorOnAbort,
 		type: "select",
 		name: "setup",
-		message: "How would you like to set up your coding agents?",
+		message: AGENT_SETUP_MESSAGE,
 		initial: 0,
 		choices: [
 			{
-				title: "Neon plugin (recommended)",
+				title: AGENT_SETUP_PLUGIN_TITLE,
 				value: "plugin",
-				description: `Install ${NEON_PLUGIN_NAME} (skills and MCP together)`
+				description: AGENT_SETUP_PLUGIN_DESCRIPTION
 			},
 			{
-				title: "Skills and MCP separately",
+				title: AGENT_SETUP_SKILLS_TITLE,
 				value: "skills-mcp",
-				description: "Install skills, then the MCP server"
+				description: AGENT_SETUP_SKILLS_DESCRIPTION
 			},
 			{
-				title: "Skip agent setup",
+				title: AGENT_SETUP_SKIP_TITLE,
 				value: "skip",
-				description: "Continue to project setup"
+				description: AGENT_SETUP_SKIP_DESCRIPTION
 			}
 		]
 	});
-	if (setup !== "plugin" && setup !== "skills-mcp" && setup !== "skip") throw new Error("Aborted.");
+	if (setup !== "plugin" && setup !== "skills-mcp" && setup !== "skip") return aborted();
 	return setup;
 };
-/** First catalog template; skip is index 0 so it stays on the first screen. */
-const INIT_TEMPLATE_PICKER_INITIAL = 1;
-const initTemplatePickerChoices = (templates) => {
-	if (templates.length === 0) throw new Error("No templates available to scaffold from.");
-	return [{
-		title: "Skip the template",
-		value: SKIP_TEMPLATE_VALUE,
-		description: "Set up agents and link a Neon project without copying template files."
-	}, ...templates.map((template) => ({
-		title: formatTemplateTitle(template),
-		value: template.id,
-		description: template.description ?? ""
-	}))];
+const pickInitAgentsInteractively = async (input) => {
+	requireInteractive();
+	if (input.available.length === 0) throw new Error("No coding agents are available to pick.");
+	const detected = new Set(input.detected);
+	const { agents } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "multiselect",
+		name: "agents",
+		message: AGENT_PICKER_MESSAGE,
+		instructions: false,
+		min: 1,
+		choices: input.available.map((id) => ({
+			value: id,
+			title: `${getAgentDisplayName(id)} (${id})`,
+			description: detected.has(id) ? AGENT_DETECTED_DESCRIPTION : AGENT_OTHER_DESCRIPTION,
+			selected: detected.has(id)
+		}))
+	});
+	if (!Array.isArray(agents)) return aborted();
+	return agents.filter((id) => typeof id === "string");
+};
+const pickInitSkillsInteractively = async () => {
+	requireInteractive();
+	const { skills } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "multiselect",
+		name: "skills",
+		message: SKILLS_PICKER_MESSAGE,
+		instructions: false,
+		min: 1,
+		choices: NEON_SKILL_CATALOG.map((entry) => ({
+			value: entry.skill,
+			title: entry.skill,
+			selected: entry.defaultSelected
+		}))
+	});
+	if (!Array.isArray(skills)) return aborted();
+	const allowed = new Set(listSkillIds());
+	return skills.filter((skill) => typeof skill === "string" && allowed.has(skill));
+};
+const pickInitMcpConfigLocationInteractively = async () => {
+	requireInteractive();
+	const { scope } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "select",
+		name: "scope",
+		message: MCP_SCOPE_MESSAGE,
+		initial: 0,
+		choices: [{
+			title: MCP_SCOPE_GLOBAL_TITLE,
+			value: "global",
+			description: MCP_SCOPE_GLOBAL_DESCRIPTION
+		}, {
+			title: MCP_SCOPE_PROJECT_TITLE,
+			value: "project",
+			description: MCP_SCOPE_PROJECT_DESCRIPTION
+		}]
+	});
+	if (scope !== "global" && scope !== "project") return aborted();
+	return scope;
+};
+const pickInitMcpAuthInteractively = async (input) => {
+	requireInteractive();
+	const { auth } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "select",
+		name: "auth",
+		message: MCP_AUTH_MESSAGE,
+		initial: input.authenticated ? 1 : 0,
+		choices: [{
+			title: MCP_AUTH_OAUTH_TITLE,
+			value: "oauth",
+			description: MCP_AUTH_OAUTH_DESCRIPTION
+		}, {
+			title: MCP_AUTH_API_KEY_TITLE,
+			value: "api-key",
+			description: MCP_AUTH_API_KEY_DESCRIPTION
+		}]
+	});
+	if (auth !== "oauth" && auth !== "api-key") return aborted();
+	return auth;
 };
-const pickInitTemplateInteractively = async (templates) => {
+const pickInitProjectSetupInteractively = async () => {
 	requireInteractive();
-	const choices = initTemplatePickerChoices(templates);
-	const { id } = await prompts({
+	const { setup } = await prompts({
 		onState: restoreCursorOnAbort,
 		type: "select",
-		name: "id",
-		message: "How would you like to set up this directory?",
-		initial: 1,
-		choices
+		name: "setup",
+		message: PROJECT_SETUP_MESSAGE,
+		initial: 0,
+		choices: [{
+			title: PROJECT_SETUP_LINK_TITLE,
+			value: "link",
+			description: PROJECT_SETUP_LINK_DESCRIPTION
+		}, {
+			title: PROJECT_SETUP_CLAIMABLE_TITLE,
+			value: "claimable",
+			description: PROJECT_SETUP_CLAIMABLE_DESCRIPTION
+		}]
 	});
-	if (id === "skip") return { kind: "skip" };
-	if (typeof id !== "string" || id.length === 0) throw new Error("Aborted.");
-	const selected = templates.find((template) => template.id === id);
-	if (selected === void 0) throw new Error("Aborted.");
-	return {
-		kind: "template",
-		template: selected
-	};
+	if (setup !== "link" && setup !== "claimable") return aborted();
+	return setup;
 };
 const pickInitConfigInteractively = async () => {
 	requireInteractive();
-	process.stdout.write(`${chalk.dim("Choose services, then edit neon.ts and apply changes with neon config apply.")}\n`);
+	process.stdout.write(`${chalk.dim(CONFIG_CONFIRM_HINT)}\n`);
 	const { value } = await prompts({
 		onState: restoreCursorOnAbort,
 		type: "confirm",
 		name: "value",
-		message: "Create neon.ts to manage this project's Neon setup as code?",
+		message: CONFIG_CONFIRM_MESSAGE,
 		initial: true
 	});
-	if (value === void 0) throw new Error("Aborted.");
+	if (value === void 0) return aborted();
 	return value === true;
 };
+const pickInitServicesInteractively = async () => {
+	requireInteractive();
+	process.stdout.write(`${chalk.dim(SERVICES_HINT)}\n`);
+	const { services } = await prompts({
+		onState: restoreCursorOnAbort,
+		onRender() {
+			keepPostgresSelected(this);
+		},
+		type: "multiselect",
+		name: "services",
+		message: SERVICES_MESSAGE,
+		instructions: false,
+		cursor: 1,
+		choices: [
+			POSTGRES_SERVICE_CHOICE,
+			{
+				value: "auth",
+				title: "Managed Better Auth",
+				description: "Declare managed authentication for users and sessions."
+			},
+			{
+				value: "data-api",
+				title: "Data API",
+				description: "Declare an HTTP API for Postgres. Also declares Managed Better Auth."
+			},
+			{
+				value: "functions",
+				title: "Functions",
+				description: "Declare a hello function and add its source file."
+			},
+			{
+				value: "object-storage",
+				title: "Object Storage",
+				description: "Declare a private S3-compatible bucket named assets."
+			},
+			{
+				value: "ai-gateway",
+				title: "AI Gateway",
+				description: "Declare AI Gateway access. Requires an eligible Neon plan."
+			}
+		]
+	});
+	if (!Array.isArray(services)) return aborted();
+	return CONFIG_INIT_SERVICES.filter((service) => services.includes(service));
+};
+const pickInitPackageManagerInteractively = async () => {
+	requireInteractive();
+	const available = installedPackageManagers();
+	if (available.length <= 1) return available[0];
+	const initial = Math.max(0, available.indexOf("npm"));
+	const { pm } = await prompts({
+		onState: restoreCursorOnAbort,
+		type: "select",
+		name: "pm",
+		message: PACKAGE_MANAGER_MESSAGE,
+		initial,
+		choices: available.map((id) => ({
+			title: id,
+			value: id
+		}))
+	});
+	if (pm !== "npm" && pm !== "pnpm" && pm !== "yarn" && pm !== "bun") return aborted();
+	return pm;
+};
 const pickInitLinkInteractively = async () => {
 	requireInteractive();
 	const { value } = await prompts({
@@ -100,8 +258,9 @@ const pickInitLinkInteractively = async () => {
 		message: "Link this project to a Neon project now?",
 		initial: true
 	});
-	if (value === void 0) throw new Error("Aborted.");
+	if (value === void 0) return aborted();
 	return value === true;
 };
+const initAgentIds = () => listMcpAgentIds();
 //#endregion
-export { INIT_TEMPLATE_PICKER_INITIAL, initTemplatePickerChoices, pickAgentSetupInteractively, pickInitConfigInteractively, pickInitLinkInteractively, pickInitTemplateInteractively };
+export { initAgentIds, pickAgentSetupInteractively, pickInitAgentsInteractively, pickInitConfigInteractively, pickInitLinkInteractively, pickInitMcpAuthInteractively, pickInitMcpConfigLocationInteractively, pickInitModeInteractively, pickInitPackageManagerInteractively, pickInitProjectSetupInteractively, pickInitServicesInteractively, pickInitSkillsInteractively };

package/dist/mcp/plan.js

@@ -1,8 +1,8 @@
 import { tryResolveAddMcpAgentId } from "./agents.js";
 import { detectMcpAgents, mcpInstallableAgents } from "./targets.js";
 import { collectYesAgents, noDetectedAgentsMessage } from "../init/plan.js";
-import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
 import { detectAgent } from "../init/detect_host.js";
+import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
 import { pickMcpAuth, pickMcpProjectPin, pickMcpScope } from "./wizard.js";
 //#region src/mcp/plan.ts
 async function resolveMcpPlan(options) {

package/dist/mcp/wizard.js

@@ -1,4 +1,3 @@
-import { getAgentDisplayName } from "./agents.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import prompts from "prompts";
 //#region src/mcp/wizard.ts
@@ -62,30 +61,5 @@ const pickMcpProjectPin = async (linkedProjectId, willMintKey = false) => {
 	});
 	return pin === true;
 };
-const mcpInstallSummary = (options) => {
-	const agents = options.install.map(getAgentDisplayName).join(", ");
-	const auth = options.auth === "oauth" ? "OAuth, agent signs in on first use" : options.reuse ? "reuse the API key already in agent config" : options.mintProjectId ? `mint an API key limited to ${options.mintProjectId}` : "mint an account-wide API key that reaches every organization";
-	const rows = [
-		["Config", options.scope === "project" ? "this directory" : "user-level"],
-		["Agents", agents],
-		["Auth", auth],
-		["URL", options.url]
-	];
-	if (options.skipped.length > 0) rows.push(["Skipped", options.skipped.map((row) => `${getAgentDisplayName(row.agent)} (${row.error})`).join("; ")]);
-	const labelWidth = Math.max(...rows.map(([label]) => label.length));
-	return rows.map(([label, value]) => `${label.padEnd(labelWidth)}  ${value}`).join("\n");
-};
-const confirmMcpInstall = async (options) => {
-	if (!canPickAgentsInteractively()) return true;
-	process.stdout.write(`\n${mcpInstallSummary(options)}\n\n`);
-	const { ok } = await prompts({
-		onState: restoreCursorOnAbort,
-		type: "confirm",
-		name: "ok",
-		message: "Write the Neon MCP server into these agents?",
-		initial: true
-	});
-	return ok === true;
-};
 //#endregion
-export { confirmMcpInstall, mcpInstallSummary, pickMcpAuth, pickMcpProjectPin, pickMcpScope };
+export { pickMcpAuth, pickMcpProjectPin, pickMcpScope };

package/dist/plugins/plan.js

@@ -2,8 +2,8 @@ import { getAgentDisplayName, tryResolveAddMcpAgentId } from "../mcp/agents.js";
 import "../init/agents.js";
 import { detectPluginsAgents, getPluginsTargetName, isUserScopeOnlyPluginsTarget, mappedPluginsTargets, pluginsInstallableAgents } from "./targets.js";
 import { collectYesAgents, noDetectedAgentsMessage } from "../init/plan.js";
-import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
 import { detectAgent } from "../init/detect_host.js";
+import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
 //#region src/plugins/plan.ts
 const assertPluginsCanRun = (options) => {
 	if (options.yes || options.interactive || options.hasAgents) return;

package/dist/skills/plan.js

@@ -2,8 +2,8 @@ import { tryResolveAddMcpAgentId } from "../mcp/agents.js";
 import "../init/agents.js";
 import { detectSkillsAgents, skillsInstallableAgents } from "./targets.js";
 import { collectYesAgents, noDetectedAgentsMessage } from "../init/plan.js";
-import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
 import { detectAgent } from "../init/detect_host.js";
+import { agentChoicesFrom, pickAgentsInteractively, resolveAgentSelection } from "../utils/agent_picker.js";
 import { invocationsForSelection, resolveSkillId, uniqueSkillEntries, yesInstallInvocations } from "./catalog.js";
 import { pickSkillsInteractively } from "./wizard.js";
 //#region src/skills/plan.ts

package/dist/skills/wizard.js

@@ -1,5 +1,3 @@
-import { getAgentDisplayName } from "../mcp/agents.js";
-import "../init/agents.js";
 import { canPickAgentsInteractively } from "../utils/agent_picker.js";
 import { NEON_SKILL_CATALOG } from "./catalog.js";
 import prompts from "prompts";
@@ -34,28 +32,6 @@ const isSkillEntry = (value) => {
 	if (!("source" in value) || !("skill" in value)) return false;
 	return typeof value.source === "string" && typeof value.skill === "string" && value.source.length > 0 && value.skill.length > 0;
 };
-const skillsInstallSummary = (options) => {
-	const skills = options.invocations.flatMap((invocation) => invocation.skills).join(", ");
-	const rows = [
-		["Config", options.scope === "project" ? "this directory" : "user-level"],
-		["Agents", options.agents.map(getAgentDisplayName).join(", ")],
-		["Skills", skills]
-	];
-	const labelWidth = Math.max(...rows.map(([label]) => label.length));
-	return rows.map(([label, value]) => `${label.padEnd(labelWidth)}  ${value}`).join("\n");
-};
-const confirmSkillsInstall = async (options) => {
-	if (!canPickAgentsInteractively()) return true;
-	process.stdout.write(`\n${skillsInstallSummary(options)}\n\n`);
-	const { ok } = await prompts({
-		onState: restoreCursorOnAbort,
-		type: "confirm",
-		name: "ok",
-		message: "Write Neon agent skills into these agents?",
-		initial: true
-	});
-	return ok === true;
-};
 const confirmSkillsUpdate = async (options) => {
 	if (!canPickAgentsInteractively()) return true;
 	const config = options.scope === "project" ? "this directory" : "user-level";
@@ -70,4 +46,4 @@ const confirmSkillsUpdate = async (options) => {
 	return ok === true;
 };
 //#endregion
-export { confirmSkillsInstall, confirmSkillsUpdate, pickSkillsInteractively, skillsInstallSummary };
+export { confirmSkillsUpdate, pickSkillsInteractively };

package/dist/test_utils/npm_env.js

@@ -0,0 +1,26 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+//#region src/test_utils/npm_env.ts
+const isNpmEnvKey = (key) => {
+	const lower = key.toLowerCase();
+	return lower.startsWith("npm_config_") || lower === "node_auth_token" || lower === "npm_token";
+};
+/**
+* Keep registry auth when a test replaces HOME. Isolated agent detection
+* otherwise drops ~/.npmrc and `npx`/skills fail with E401 or hang.
+*/
+const npmEnvForIsolatedHome = () => {
+	const env = {};
+	for (const [key, value] of Object.entries(process.env)) {
+		if (value === void 0 || !isNpmEnvKey(key)) continue;
+		env[key] = value;
+	}
+	if (env.npm_config_userconfig === void 0 && env.NPM_CONFIG_USERCONFIG === void 0) {
+		const src = join(homedir(), ".npmrc");
+		if (existsSync(src)) env.npm_config_userconfig = src;
+	}
+	return env;
+};
+//#endregion
+export { npmEnvForIsolatedHome };

package/dist/update_check_worker.js

@@ -0,0 +1,47 @@
+import { recordLatestVersion } from "./update_notifier.js";
+import { promisify } from "node:util";
+import { pathToFileURL } from "node:url";
+import { execFile } from "node:child_process";
+//#region src/update_check_worker.ts
+const execFileAsync = promisify(execFile);
+const LOOKUP_TIMEOUT_MS = 5e3;
+const npmViewInvocation = (platform) => ({
+	args: [
+		"view",
+		"neon",
+		"version",
+		"--json"
+	],
+	command: platform === "win32" ? "npm.cmd" : "npm",
+	shell: platform === "win32"
+});
+const npmLatestVersion = async () => {
+	const invocation = npmViewInvocation(process.platform);
+	const { stdout } = await execFileAsync(invocation.command, invocation.args, {
+		encoding: "utf8",
+		shell: invocation.shell,
+		timeout: LOOKUP_TIMEOUT_MS,
+		windowsHide: true
+	});
+	const value = JSON.parse(stdout);
+	return typeof value === "string" ? value : void 0;
+};
+const homebrewLatestVersion = async () => {
+	const response = await fetch("https://formulae.brew.sh/api/formula/neonctl.json", { signal: AbortSignal.timeout(LOOKUP_TIMEOUT_MS) });
+	if (!response.ok) return void 0;
+	const value = await response.json();
+	if (typeof value !== "object" || value === null || !("versions" in value) || typeof value.versions !== "object" || value.versions === null || !("stable" in value.versions) || typeof value.versions.stable !== "string") return;
+	return value.versions.stable;
+};
+const run = async () => {
+	const [cachePath, source] = process.argv.slice(2);
+	if (cachePath === void 0 || source !== "homebrew" && source !== "npm") return;
+	try {
+		const latestVersion = source === "homebrew" ? await homebrewLatestVersion() : await npmLatestVersion();
+		if (latestVersion !== void 0) recordLatestVersion(cachePath, source, latestVersion);
+	} catch {}
+};
+const entry = process.argv[1];
+if (entry !== void 0 && import.meta.url === pathToFileURL(entry).href) run();
+//#endregion
+export { npmViewInvocation };