neon 4.11.1 → 4.13.0

package/README.md

@@ -675,7 +675,7 @@ neon config plan --project-id polished-snowflake-12345678 --output json
 neon deploy --branch my-feature --update-existing
 ```
 
-Function deploys declared under `preview.functions` are bundled by neon's own esbuild helper and uploaded as part of `apply`, so the policy stays declarative and the packaged CLI never has to embed esbuild's native binary.
+Function deploys declared under `preview.functions` are bundled with esbuild by default. A directory `source` is discovered as `index.ts`, then `index.js`, then `index.mjs`. Set `bundler: "none"` to ship a prebuilt directory as-is. `neon function deploy --no-bundle` is the same switch without a `neon.ts`.
 
 When a package cannot be bundled — a native addon with no esbuild loader, or an optional peer dependency a library references on an untaken code path — list it in that function's `externalPackages` and the bundler leaves the import alone. `neon dev` honours the same list. It does not make the package resolvable in the deployed archive (there is no `node_modules` next to the bundle), so it only unblocks an import that is never evaluated — a dependency the handler actually calls has to be bundled, and a natively-backed one cannot be. See [`@neon/config`](../config/README.md#unbundleable-dependencies-externalpackages).
 
@@ -806,6 +806,17 @@ On a TTY the command asks which agents and which skills, then shows a summary to
 
 Supported agents match `neon mcp`, minus agents that cannot install skills: `antigravity`, `cline`, `cline-cli`, `claude-code`, `claude-desktop`, `codex`, `cursor`, `gemini-cli`, `goose`, `github-copilot-cli`, `grok-build`, `opencode`, `vscode`, `windsurf`, `zed`. `mcporter` is a known MCP name that is then skipped. `neon skills --help` lists the same skill and agent values, and that `-y` leaves out `neon-postgres-agent-platforms`.
 
+## Ask the Neon assistant (`ask`)
+
+`neon ask --prompt` asks the hosted Neon assistant a question about Neon. It does not log in and does not use your Neon account.
+
+```bash
+neon ask --prompt "How do schema-only branches work?"
+neon ask --prompt "How do schema-only branches work?" --output json
+```
+
+Default table output is the assistant's text. On a TTY that is a spinner, then the streamed reply. `--output json` and `--output yaml` print `{ "text": "…" }` after the full response.
+
 ## Install the Neon plugin (`plugins`)
 
 `neon plugins` installs the Neon agent plugin (`neon-postgres`) by running `npx plugins add`. It does not call the Neon API.
@@ -1234,6 +1245,7 @@ Id   Name      Project         Created At            Last Used At          Last
 | mcp                                                                        |                                                                                                              | Install the Neon MCP server         |
 | plugins                                                                    |                                                                                                              | Install the Neon plugin             |
 | skills                                                                     | `update`                                                                                                     | Install Neon agent skills           |
+| ask                                                                        |                                                                                                              | Ask a question about Neon          |
 | bucket                                                                     | `create`, `list`, `delete`, `object list`, `object get`, `object put`, `object delete` (incl. `--recursive`) | Manage buckets and their objects   |
 | [completion](https://neon.com/docs/reference/cli-completion)               |                                                                                                              | Generate a completion script       |
 
@@ -1292,7 +1304,7 @@ Global options are supported with any Neon CLI command.
 
 - <a id="analytics"></a>`--analytics`
 
-  Analytics are enabled by default to gather information about the CLI commands and options that are used by our customers. This data collection assists in offering support, and allows for a better understanding of typical usage patterns so that we can improve user experience. Neon does not collect user-defined data, such as project IDs or command payloads. To opt-out of analytics data collection, specify `--no-analytics` or `--analytics false`.
+  Analytics are enabled by default to gather information about the CLI commands and options that are used by our customers. This data collection assists in offering support, and allows for a better understanding of typical usage patterns so that we can improve user experience. Neon does not collect user-defined data, such as project IDs or command payloads, except the question passed to `neon ask --prompt`. To opt-out of analytics data collection, specify `--no-analytics` or `--analytics false`.
 
 - <a id="version"></a>`-v, --version`
 

package/dist/analytics.js

@@ -193,9 +193,14 @@ const getErrorAnalyticsEventContext = (_args) => ({
 	ci: isCi(),
 	agent: getCliAgent(process.env)
 });
+const analyticsCommand = (args) => {
+	const command = args._.join(" ");
+	if (args._[0] !== "ask" || typeof args.prompt !== "string") return command;
+	return `${command} ${args.prompt}`;
+};
 const getAnalyticsEventProperties = (args) => ({
 	version: pkg_default.version,
-	command: args._.join(" "),
+	command: analyticsCommand(args),
 	flags: { output: args.output },
 	ci: isCi(),
 	agent: getCliAgent(process.env),

package/dist/commands/ask.js

@@ -0,0 +1,152 @@
+import { t as __exportAll } from "../_chunks/rolldown-runtime-8H4AJuhK.js";
+import { isCi } from "../env.js";
+import { isNetworkError } from "../errors.js";
+import { writer } from "../writer.js";
+import { noPassthrough, single } from "../utils/flags.js";
+import { isEventStreamContentType, readAskSse } from "./ask_sse.js";
+import { createThinkingSpinner } from "./thinking_spinner.js";
+//#region src/commands/ask.ts
+var ask_exports = /* @__PURE__ */ __exportAll({
+	DEFAULT_ASK_URL: () => DEFAULT_ASK_URL,
+	builder: () => builder,
+	command: () => "ask",
+	describe: () => describe,
+	handler: () => handler,
+	resolveAskUrl: () => resolveAskUrl
+});
+const DEFAULT_ASK_URL = "https://br-frosty-cell-a5smzg39-assistant.compute.c-1.us-east-2.aws.neon.tech/ask";
+const ASK_TIMEOUT_MS = 12e4;
+const command = "ask";
+const describe = "Ask a question about Neon";
+const builder = (argv) => argv.usage("$0 ask --prompt <question>").option("prompt", {
+	describe: "The question to ask",
+	type: "string",
+	demandOption: true,
+	coerce: single("prompt", { required: true })
+}).option("url", {
+	describe: "Override the assistant URL",
+	type: "string",
+	hidden: true,
+	coerce: single("url")
+}).strict().check(noPassthrough("ask")).example("$0 ask --prompt \"How do schema-only branches work?\"", describe);
+function resolveAskUrl(opts) {
+	const fromFlag = opts.url?.trim();
+	if (fromFlag) return fromFlag;
+	const fromEnv = opts.envUrl?.trim();
+	if (fromEnv) return fromEnv;
+	return DEFAULT_ASK_URL;
+}
+function isMachineOutput(output) {
+	return output === "json" || output === "yaml";
+}
+const handler = async (props) => {
+	const url = resolveAskUrl({
+		url: props.url,
+		envUrl: process.env.NEON_ASK_URL
+	});
+	const human = !isMachineOutput(props.output);
+	const spinner = createThinkingSpinner({
+		out: process.stderr,
+		isTty: Boolean(process.stderr.isTTY) && !isCi() && human
+	});
+	let streamed = "";
+	try {
+		spinner.start();
+		const text = await askAssistant({
+			prompt: props.prompt,
+			url,
+			acceptEventStream: human,
+			onStatus: (message) => {
+				spinner.setMessage(message);
+			},
+			onText: (chunk) => {
+				if (!human) return;
+				spinner.stop();
+				streamed += chunk;
+				writer(props).text(chunk);
+			}
+		});
+		spinner.stop();
+		if (!human) {
+			writer(props).end({ text }, { fields: ["text"] });
+			return;
+		}
+		if (streamed === "") {
+			writer(props).text(`${text}\n`);
+			return;
+		}
+		if (!streamed.endsWith("\n")) writer(props).text("\n");
+	} catch (error) {
+		spinner.stop();
+		if (human && streamed !== "" && !streamed.endsWith("\n")) writer(props).text("\n");
+		throw error;
+	} finally {
+		spinner.stop();
+	}
+};
+function isAskTimeout(error) {
+	return error instanceof Error && (error.name === "TimeoutError" || error.name === "AbortError");
+}
+function askErrorMessage(body, status) {
+	if (typeof body === "object" && body !== null && "error" in body && typeof body.error === "string" && body.error.trim() !== "") return body.error;
+	return `The Neon assistant returned ${status}.`;
+}
+function askText(body) {
+	if (typeof body === "object" && body !== null && "text" in body && typeof body.text === "string") return body.text;
+	throw new Error("The Neon assistant returned an unexpected response.");
+}
+async function readJsonBody(response) {
+	const raw = await response.text();
+	if (raw.trim() === "") return;
+	try {
+		return JSON.parse(raw);
+	} catch {
+		return;
+	}
+}
+async function readStreamedAsk(body, opts) {
+	let text = "";
+	let sawDone = false;
+	for await (const event of readAskSse(body)) switch (event.type) {
+		case "status":
+			opts.onStatus?.(event.message);
+			break;
+		case "text":
+			text += event.text;
+			opts.onText?.(event.text);
+			break;
+		case "error": throw new Error(event.error);
+		case "done": sawDone = true;
+	}
+	if (!sawDone) throw new Error("The Neon assistant returned an unexpected response.");
+	return text;
+}
+async function askAssistant(opts) {
+	let response;
+	try {
+		response = await fetch(opts.url, {
+			method: "POST",
+			headers: {
+				"Content-Type": "application/json",
+				Accept: opts.acceptEventStream ? "text/event-stream" : "application/json"
+			},
+			body: JSON.stringify({ prompt: opts.prompt }),
+			signal: AbortSignal.timeout(ASK_TIMEOUT_MS)
+		});
+	} catch (error) {
+		if (isAskTimeout(error)) throw new Error("The Neon assistant did not respond in time.");
+		if (isNetworkError(error)) throw new Error("Could not reach the Neon assistant. Check your internet connection and try again.");
+		throw error;
+	}
+	if (!response.ok) {
+		const body = await readJsonBody(response);
+		throw new Error(askErrorMessage(body, response.status));
+	}
+	if (opts.acceptEventStream && isEventStreamContentType(response.headers.get("content-type") ?? void 0)) {
+		if (!response.body) throw new Error("The Neon assistant returned an unexpected response.");
+		return readStreamedAsk(response.body, opts);
+	}
+	return askText(await readJsonBody(response));
+}
+//#endregion
+export { DEFAULT_ASK_URL, builder, command, describe, handler, resolveAskUrl, ask_exports as t };

package/dist/commands/ask_sse.js

@@ -0,0 +1,101 @@
+//#region src/commands/ask_sse.ts
+function isEventStreamContentType(header) {
+	return header?.split(";")[0]?.trim().toLowerCase() === "text/event-stream";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function parseSseBlock(block) {
+	let event = "message";
+	const dataLines = [];
+	for (const line of block.split(/\r?\n/)) {
+		if (line === "" || line.startsWith(":")) continue;
+		if (line.startsWith("event:")) {
+			event = line.slice(6).trim();
+			continue;
+		}
+		if (line.startsWith("data:")) dataLines.push(line.slice(5).replace(/^ /, ""));
+	}
+	if (event === "ping") return;
+	if (event === "message" && dataLines.length === 0) return;
+	return {
+		event,
+		data: dataLines.join("\n")
+	};
+}
+function takeSseBlocks(pending) {
+	const events = [];
+	let rest = pending;
+	while (true) {
+		const lf = rest.indexOf("\n\n");
+		const crlf = rest.indexOf("\r\n\r\n");
+		let at = -1;
+		let sep = 0;
+		if (lf === -1 && crlf === -1) break;
+		if (crlf !== -1 && (lf === -1 || crlf < lf)) {
+			at = crlf;
+			sep = 4;
+		} else {
+			at = lf;
+			sep = 2;
+		}
+		const parsed = parseSseBlock(rest.slice(0, at));
+		rest = rest.slice(at + sep);
+		if (parsed) events.push(parsed);
+	}
+	return {
+		events,
+		rest
+	};
+}
+function mapAskEvent(raw) {
+	if (raw.event === "done") return { type: "done" };
+	let parsed;
+	try {
+		parsed = raw.data === "" ? void 0 : JSON.parse(raw.data);
+	} catch {
+		return;
+	}
+	if (raw.event === "status") {
+		if (!isRecord(parsed) || typeof parsed.message !== "string" || parsed.message === "") return;
+		return {
+			type: "status",
+			message: parsed.message
+		};
+	}
+	if (raw.event === "text") {
+		if (!isRecord(parsed) || typeof parsed.text !== "string" || parsed.text === "") return;
+		return {
+			type: "text",
+			text: parsed.text
+		};
+	}
+	if (raw.event === "error") return {
+		type: "error",
+		error: isRecord(parsed) && typeof parsed.error === "string" && parsed.error.trim() !== "" ? parsed.error : "The assistant failed."
+	};
+}
+async function* readAskSse(body) {
+	const decoder = new TextDecoder();
+	const reader = body.getReader();
+	let pending = "";
+	try {
+		while (true) {
+			const { done, value } = await reader.read();
+			pending += decoder.decode(value ?? /* @__PURE__ */ new Uint8Array(), { stream: !done });
+			const taken = takeSseBlocks(pending);
+			pending = taken.rest;
+			for (const raw of taken.events) {
+				const event = mapAskEvent(raw);
+				if (!event) continue;
+				yield event;
+				if (event.type === "error" || event.type === "done") return;
+			}
+			if (done) break;
+		}
+	} finally {
+		reader.releaseLock();
+	}
+}
+//#endregion
+export { isEventStreamContentType, readAskSse };

package/dist/commands/auth.js

@@ -5,7 +5,7 @@ import { log } from "../log.js";
 import { getApiClient } from "../api.js";
 import { a as isOwnedCredentialPath } from "../_chunks/paths-DMq0Lt7a.js";
 import { setAuthContext } from "../auth_context.js";
-import { currentContextFile, isClaimCommand, isConfigInit, isCurrentBranchProbe, isMcpCommand, isMcpOauth, isPluginsCommand, isProfileCommand, isSkillsCommand, readContextFile } from "../context.js";
+import { currentContextFile, isAskCommand, isClaimCommand, isConfigInit, isCurrentBranchProbe, isMcpCommand, isMcpOauth, isPluginsCommand, isProfileCommand, isSkillsCommand, readContextFile } from "../context.js";
 import { _ as upsertProfile, d as newProfileLocation, g as selectProfileName, h as resolveProfile, i as assertValidProfileName, l as locationForName, m as readProfiles, n as KEYRING_CREDENTIALS, p as profilesUsingPath, r as assertProfilesUsable, s as isKeyringPointer, t as DEFAULT_PROFILE, u as locationOf } from "../_chunks/profiles-CvnFEQyd.js";
 import { extendTokenSet } from "../utils/auth.js";
 import { auth, refreshToken } from "../auth.js";
@@ -220,6 +220,7 @@ const ensureAuth = async (props) => {
 	if (isMcpOauth(props)) return;
 	if (props._[0] === "open") return;
 	if (isSkillsCommand(props) || isPluginsCommand(props)) return;
+	if (isAskCommand(props)) return;
 	if (props._[0] === "init") {
 		selectCredential({
 			...credentialInputs(),

package/dist/commands/config.js

@@ -23,7 +23,7 @@ import { existsSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import chalk from "chalk";
 import { packagesToStage, resolveConfig } from "@neon/config";
-import { PushConflictError, apply, assertZipWithinLimits, createBranch, describeNativeFinding, enforceLimits, findUndeclaredNativePackages, inspect, isPartialBranchCreateError, loadConfigFromFile as loadConfigFromFile$1, plan, traceNativePackages } from "@neon/config-runtime";
+import { PushConflictError, apply, assertZipWithinLimits, bundleAsIs, createBranch, describeNativeFinding, enforceLimits, findUndeclaredNativePackages, inspect, isPartialBranchCreateError, loadConfigFromFile as loadConfigFromFile$1, plan, resolveEsbuildEntry, traceNativePackages, zipFunctionBundle } from "@neon/config-runtime";
 //#region src/commands/config.ts
 var config_exports = /* @__PURE__ */ __exportAll({
 	applyCmd: () => applyCmd,
@@ -41,27 +41,24 @@ var config_exports = /* @__PURE__ */ __exportAll({
 	planCmd: () => planCmd,
 	status: () => status
 });
-/**
-* Bundle a function with neonctl's OWN bundler (the shared esbuild helper) so the
-* config-runtime never has to import esbuild itself. Injecting this keeps esbuild
-* out of config-runtime's static module graph — and therefore out of the packaged
-* neonctl snapshot, which resolves esbuild dynamically at deploy time.
-*/
 const neonctlBundler = async (fn) => {
+	if (typeof fn.bundler === "function") return zipFunctionBundle(fn.slug, await fn.bundler(fn));
+	if (fn.bundler === "none") return zipFunctionBundle(fn.slug, await bundleAsIs(fn));
+	const entry = await resolveEsbuildEntry(fn.source);
 	const externalPackages = fn.externalPackages ?? [];
-	const { files, metafile, warnings } = await bundleEntry(fn.source, { externalPackages: externalPackages.map((pkg) => pkg.name) });
+	const { files, metafile, warnings } = await bundleEntry(entry, { externalPackages: externalPackages.map((pkg) => pkg.name) });
 	for (const warning of warnings) log.warning(warning);
 	for (const finding of findUndeclaredNativePackages({
 		metafile,
 		declared: externalPackages.map((pkg) => pkg.name),
-		projectDir: dirname(fn.source)
+		projectDir: dirname(entry)
 	})) log.warning(describeNativeFinding(fn.slug, finding));
 	const staged = packagesToStage(externalPackages);
 	if (staged.length === 0) return zipBundle(files);
 	const traced = await traceNativePackages({
 		slug: fn.slug,
 		packages: staged,
-		projectDir: dirname(fn.source)
+		projectDir: dirname(entry)
 	});
 	for (const warning of traced.warnings) log.warning(warning);
 	const entries = {

package/dist/commands/dev.js

@@ -7,12 +7,12 @@ import { bundleEntry } from "../utils/esbuild.js";
 import { i as resolveDevEnv } from "../_chunks/env-NbA61JR3.js";
 import { resolveFunctionsFromConfig } from "../dev/functions.js";
 import { resolveWatchInputs } from "../dev/inputs.js";
-import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
-import { basename, dirname, join, resolve } from "node:path";
+import { existsSync, mkdirSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import chalk from "chalk";
 import { spawn, spawnSync } from "node:child_process";
-import { describeNativeFinding, findUndeclaredNativePackages } from "@neon/config-runtime";
+import { bundleAsIs, describeNativeFinding, findUndeclaredNativePackages, resolveEsbuildEntry } from "@neon/config-runtime";
 import { once } from "node:events";
 //#region src/commands/dev.ts
 var dev_exports = /* @__PURE__ */ __exportAll({
@@ -239,11 +239,13 @@ const plannedToUnit = (fn, branchEnv, searchBase) => {
 			fn: Object.keys(fn.env)
 		},
 		...fn.externalPackages ? { externalPackages: fn.externalPackages } : {},
+		...fn.bundler !== void 0 ? { bundler: fn.bundler } : {},
 		configKey: JSON.stringify({
 			source: fn.source,
 			port: fn.port ?? null,
 			env: fn.env,
-			externalPackages: fn.externalPackages ?? null
+			externalPackages: fn.externalPackages ?? null,
+			bundler: typeof fn.bundler === "function" ? "custom" : fn.bundler ?? null
 		})
 	};
 };
@@ -286,7 +288,7 @@ const runSupervisor = async (units, options = {}) => {
 	const bundleAndStart = async (r) => {
 		let bundlePath;
 		try {
-			bundlePath = await writeBundle(r.unit.source, r.unit.bundleDir, r.unit.externalPackages, r.unit.slug ?? void 0);
+			bundlePath = await writeBundle(r.unit.source, r.unit.bundleDir, r.unit.externalPackages, r.unit.slug ?? void 0, r.unit.bundler);
 		} catch (err) {
 			r.status = "error";
 			logUnit(r.unit, chalk.red("bundle failed: ") + (err instanceof Error ? err.message : String(err)));
@@ -329,7 +331,7 @@ const runSupervisor = async (units, options = {}) => {
 		}, 150);
 	};
 	const startUnit = async (r) => {
-		r.watcher = await startWatcher(r.unit.source, () => {
+		r.watcher = await startWatcher(r.unit, () => {
 			restart(r);
 		});
 		await bundleAndStart(r);
@@ -500,22 +502,50 @@ const spawnChild = (unit, runtimePath, bundlePath) => {
 * positive would otherwise repeat the whole block for its lifetime.
 */
 const reportedFindings = /* @__PURE__ */ new Map();
-const writeBundle = async (source, bundleDir, externalPackages, label) => {
-	const { files, metafile, warnings } = await bundleEntry(source, { ...externalPackages ? { externalPackages } : {} });
+const writeBundle = async (source, bundleDir, externalPackages, label, bundler) => {
+	if (bundler !== void 0 && bundler !== "esbuild") {
+		const files = await bundleForDev(source, label, bundler);
+		return writeBundleFiles(bundleDir, files);
+	}
+	const entry = await resolveEsbuildEntry(source);
+	const { files, metafile, warnings } = await bundleEntry(entry, { ...externalPackages ? { externalPackages } : {} });
 	for (const warning of warnings) log.warning(warning);
 	const findings = findUndeclaredNativePackages({
 		metafile,
 		declared: externalPackages ?? [],
-		projectDir: dirname(source)
+		projectDir: dirname(entry)
 	});
 	const signature = findings.map((f) => f.name).join(",");
 	if (reportedFindings.get(source) !== signature) {
 		reportedFindings.set(source, signature);
 		for (const finding of findings) log.warning(describeNativeFinding(label ?? basename(source), finding));
 	}
+	return writeBundleFiles(bundleDir, files);
+};
+const bundleForDev = async (source, label, bundler) => {
+	const fn = {
+		slug: label ?? basename(source),
+		name: label ?? basename(source),
+		source,
+		env: {},
+		runtime: "nodejs24",
+		bundler
+	};
+	return bundler === "none" ? bundleAsIs(fn) : bundler(fn);
+};
+const writeBundleFiles = (bundleDir, files) => {
+	rmSync(bundleDir, {
+		recursive: true,
+		force: true
+	});
 	mkdirSync(bundleDir, { recursive: true });
-	for (const [name, contents] of Object.entries(files)) writeFileSync(join(bundleDir, name), contents);
-	return join(bundleDir, "index.mjs");
+	for (const [name, contents] of Object.entries(files)) {
+		const dest = join(bundleDir, name);
+		mkdirSync(dirname(dest), { recursive: true });
+		writeFileSync(dest, contents);
+	}
+	const entry = ["index.mjs", "index.js"].find((name) => name in files);
+	return join(bundleDir, entry ?? "index.mjs");
 };
 const urlFor = (port) => port === null ? chalk.red("not running") : `http://localhost:${port}`;
 const waitForReady = (child) => new Promise((resolveReady) => {
@@ -594,11 +624,19 @@ const logUnit = (unit, message) => {
 	const prefix = unit.label ? chalk.dim(`[${unit.label}] `) : "";
 	log.info(`${prefix}${message}`);
 };
-const startWatcher = async (source, restart) => {
+const startWatcher = async (unit, restart) => {
 	const { default: chokidar } = await import("chokidar");
-	const initialInputs = await resolveWatchInputs(source);
-	if (initialInputs === null) return startDirectoryWatcher(chokidar, source, restart);
-	return startInputWatcher(chokidar, source, initialInputs, restart);
+	if (unit.bundler !== void 0 && unit.bundler !== "esbuild") {
+		const dir = statSync(unit.source, { throwIfNoEntry: false })?.isDirectory() === true ? unit.source : dirname(unit.source);
+		return startDirectoryWatcher(chokidar, dir, restart, { ignoreDist: false });
+	}
+	let entry = unit.source;
+	try {
+		entry = await resolveEsbuildEntry(unit.source);
+	} catch {}
+	const initialInputs = await resolveWatchInputs(entry);
+	if (initialInputs === null) return startDirectoryWatcher(chokidar, entry, restart, { ignoreDist: true });
+	return startInputWatcher(chokidar, entry, initialInputs, restart);
 };
 /**
 * Watch the neon.ts file itself for changes, firing `onChange` on every save. Used by the
@@ -645,11 +683,15 @@ const startInputWatcher = async (chokidar, source, initialInputs, restart) => {
 		close: () => watcher.close()
 	};
 };
-const startDirectoryWatcher = async (chokidar, source, restart) => {
-	const watchedDir = dirname(source);
+const startDirectoryWatcher = async (chokidar, source, restart, options) => {
+	const watchedDir = statSync(source, { throwIfNoEntry: false })?.isDirectory() ? source : dirname(source);
 	const isIgnored = (p) => {
-		const segments = p.split(/[/\\]/);
-		return segments.includes("node_modules") || segments.includes(".git") || segments.includes("dist");
+		const rel = relative(watchedDir, p);
+		if (rel === "" || rel === ".") return false;
+		if (rel.startsWith("..")) return false;
+		const segments = rel.split(/[/\\]/);
+		if (segments.includes("node_modules") || segments.includes(".git")) return true;
+		return options.ignoreDist && segments.includes("dist");
 	};
 	const watcher = chokidar.watch(watchedDir, {
 		ignoreInitial: true,

package/dist/commands/functions.js

@@ -7,9 +7,10 @@ import { writer } from "../writer.js";
 import { branchIdFromProps, fillSingleProject } from "../utils/enrichers.js";
 import { bundleEntry } from "../utils/esbuild.js";
 import { zipBundle } from "../utils/zip.js";
-import { existsSync, statSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { describeNativeFinding, findUndeclaredNativePackages } from "@neon/config-runtime";
+import { statSync } from "node:fs";
+import { dirname } from "node:path";
+import { FUNCTION_SOURCE_ENTRIES } from "@neon/config";
+import { bundleAsIs, describeNativeFinding, findUndeclaredNativePackages, resolveEsbuildEntry, zipFunctionBundle } from "@neon/config-runtime";
 //#region src/commands/functions.ts
 var functions_exports = /* @__PURE__ */ __exportAll({
 	aliases: () => aliases,
@@ -55,11 +56,6 @@ const writeDeploymentErrorSection = (out, dep) => {
 };
 const SLUG_PATTERN = /^[a-z0-9]{1,20}$/;
 const SLUG_HELP = "Use 1-20 lowercase letters and digits (no hyphens or other characters).";
-const ENTRY_CANDIDATES = [
-	"index.ts",
-	"index.mjs",
-	"index.js"
-];
 const POLL_INTERVAL_MS = Number(process.env.NEON_FUNCTIONS_POLL_INTERVAL_MS) || 2e3;
 const POLL_TIMEOUT_MS = Number(process.env.NEON_FUNCTIONS_POLL_TIMEOUT_MS) || 6e5;
 const command = "functions";
@@ -80,7 +76,7 @@ const builder = (argv) => argv.usage("$0 function <sub-command> [options]").opti
 	demandOption: true
 }).options({
 	src: {
-		describe: "Function source: a directory containing index.ts, index.mjs, or index.js, or a path to the entry file",
+		describe: "Function source: a directory containing index.ts, index.js, or index.mjs (first file match is the entry), or a path to the entry file",
 		type: "string"
 	},
 	path: {
@@ -105,6 +101,11 @@ const builder = (argv) => argv.usage("$0 function <sub-command> [options]").opti
 		describe: "Wait for the deployment to finish building",
 		type: "boolean",
 		default: true
+	},
+	bundle: {
+		describe: "Bundle --src with esbuild. Use --no-bundle to zip a prebuilt directory (root must contain index.mjs or index.js) or a file of that name.",
+		type: "boolean",
+		default: true
 	}
 }), (args) => deploy(args)).command("list", "List functions on the branch", (yargs) => yargs, (args) => list(args)).command("get <slug>", "Show a function's details", (yargs) => yargs.positional("slug", {
 	describe: "Function slug",
@@ -144,24 +145,33 @@ const emitDeployResult = (props, deployment, fn) => {
 };
 const isTransient = (err) => isNeonApiError(err) && (err.status === void 0 || err.status === 404 || err.status >= 500);
 const deploy = async (props) => {
-	if (props.path !== void 0 || props.entry !== void 0) throw new Error("--path and --entry were removed. Use --src <dir>; the entry point is discovered as index.ts, index.mjs, or index.js in that directory.");
-	if (!(props.src !== void 0 || props.env !== void 0 || props.runtime !== void 0)) throw new Error(`Provide at least one option to deploy, e.g. --src or --env. See: ${getCliName()} function deploy --help.`);
+	if (props.path !== void 0 || props.entry !== void 0) throw new Error(`--path and --entry were removed. Use --src <dir>; the entry point is discovered as ${FUNCTION_SOURCE_ENTRIES.join(", ")} in that directory.`);
+	if (!(props.src !== void 0 || props.env !== void 0 || props.runtime !== void 0 || props.bundle === false)) throw new Error(`Provide at least one option to deploy, e.g. --src, --env, or --no-bundle. See: ${getCliName()} function deploy --help.`);
 	if (!SLUG_PATTERN.test(props.slug)) throw new Error(`Invalid function slug "${props.slug}". ${SLUG_HELP}`);
 	const src = props.src ?? ".";
 	const runtime = props.runtime ?? "nodejs24";
 	const environment = parseEnv(props.env);
-	const srcStat = statSync(src, { throwIfNoEntry: false });
-	if (srcStat === void 0) throw new Error(`--src path not found: ${src}.`);
-	const source = srcStat.isFile() ? src : ENTRY_CANDIDATES.map((name) => join(src, name)).find((p) => existsSync(p));
-	if (source === void 0) throw new Error(`No entry file found in ${src}. Expected one of: ${ENTRY_CANDIDATES.join(", ")}.`);
-	const bundled = await bundleEntry(source);
-	for (const warning of bundled.warnings) log.warning(warning);
-	for (const finding of findUndeclaredNativePackages({
-		metafile: bundled.metafile,
-		declared: [],
-		projectDir: dirname(source)
-	})) log.warning(describeNativeFinding(props.slug, finding));
-	const zip = zipBundle(bundled.files);
+	if (statSync(src, { throwIfNoEntry: false }) === void 0) throw new Error(`--src path not found: ${src}.`);
+	let zip;
+	if (!props.bundle) zip = await zipFunctionBundle(props.slug, await bundleAsIs({
+		slug: props.slug,
+		name: props.slug,
+		source: src,
+		env: {},
+		runtime: "nodejs24",
+		bundler: "none"
+	}, { via: "no-bundle" }));
+	else {
+		const source = await resolveEsbuildEntry(src);
+		const bundled = await bundleEntry(source);
+		for (const warning of bundled.warnings) log.warning(warning);
+		for (const finding of findUndeclaredNativePackages({
+			metafile: bundled.metafile,
+			declared: [],
+			projectDir: dirname(source)
+		})) log.warning(describeNativeFinding(props.slug, finding));
+		zip = zipBundle(bundled.files);
+	}
 	const branchId = await branchIdFromProps(props);
 	let before;
 	try {

package/dist/commands/index.js

@@ -1,6 +1,7 @@
 import { t as auth_exports } from "./auth.js";
 import { t as api_exports } from "./api.js";
 import { t as api_keys_exports } from "./api_keys.js";
+import { t as ask_exports } from "./ask.js";
 import { t as bootstrap_exports } from "./bootstrap.js";
 import { t as branches_exports } from "./branches.js";
 import { t as bucket_exports } from "./bucket.js";
@@ -66,6 +67,7 @@ var commands_default = [
 	mcp_exports,
 	plugins_exports,
 	skills_exports,
+	ask_exports,
 	data_api_exports,
 	functions_exports,
 	dev_exports,

package/dist/commands/thinking_spinner.js

@@ -0,0 +1,47 @@
+//#region src/commands/thinking_spinner.ts
+const FRAMES = [
+	"⠋",
+	"⠙",
+	"⠹",
+	"⠸",
+	"⠼",
+	"⠴",
+	"⠦",
+	"⠧",
+	"⠇",
+	"⠏"
+];
+const INTERVAL_MS = 80;
+const CLEAR_LINE = "\r\x1B[2K";
+function createThinkingSpinner(opts) {
+	let message = "Thinking";
+	let frame = 0;
+	let timer;
+	let stopped = false;
+	const paint = () => {
+		if (!opts.isTty || stopped) return;
+		const glyph = FRAMES[frame % FRAMES.length];
+		frame += 1;
+		opts.out.write(`${CLEAR_LINE}${glyph} ${message}`);
+	};
+	return {
+		start() {
+			if (!opts.isTty || stopped) return;
+			paint();
+			timer = setInterval(paint, INTERVAL_MS);
+			timer.unref();
+		},
+		setMessage(next) {
+			message = next;
+			paint();
+		},
+		stop() {
+			if (stopped) return;
+			stopped = true;
+			if (timer) clearInterval(timer);
+			if (opts.isTty) opts.out.write(CLEAR_LINE);
+		}
+	};
+}
+//#endregion
+export { createThinkingSpinner };

package/dist/context.js

@@ -54,6 +54,7 @@ const isApiKeysCommand = (args) => args._[0] === "api-keys" || args._[0] === "ap
 const isMcpCommand = (args) => args._[0] === "mcp";
 const isSkillsCommand = (args) => args._[0] === "skills" || args._[0] === "skill";
 const isPluginsCommand = (args) => args._[0] === "plugins" || args._[0] === "plugin";
+const isAskCommand = (args) => args._[0] === "ask";
 /** 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([
@@ -134,6 +135,7 @@ const enrichFromContext = (args) => {
 	if (isProfileCommand(args)) return;
 	if (isMcpCommand(args)) return;
 	if (isSkillsCommand(args) || isPluginsCommand(args)) return;
+	if (isAskCommand(args)) return;
 	if (isClaimCommand(args)) return;
 	const context = readContextFile(args.contextFile);
 	if (!args.orgId) args.orgId = context.orgId;
@@ -240,4 +242,4 @@ const globToRegExp = (pattern) => {
 	return new RegExp(`^${source}$`);
 };
 //#endregion
-export { applyContext, contextBranch, currentContextFile, enrichFromContext, ensureGitignored, isApiKeysCommand, isClaimCommand, isConfigInit, isCurrentBranchProbe, isMcpCommand, isMcpOauth, isPluginsCommand, isProfileCommand, isSkillsCommand, readContextFile, setContext, updateContextFile, walkContextFile };
+export { applyContext, contextBranch, currentContextFile, enrichFromContext, ensureGitignored, isApiKeysCommand, isAskCommand, isClaimCommand, isConfigInit, isCurrentBranchProbe, isMcpCommand, isMcpOauth, isPluginsCommand, isProfileCommand, isSkillsCommand, readContextFile, setContext, updateContextFile, walkContextFile };

package/dist/dev/functions.js

@@ -29,7 +29,8 @@ const resolveFunctionsFromConfig = async (cwd, branchName) => {
 				source,
 				...devPort(fn.dev) !== void 0 ? { port: devPort(fn.dev) } : {},
 				env: { ...fn.env },
-				...fn.externalPackages ? { externalPackages: fn.externalPackages.map((pkg) => pkg.name) } : {}
+				...fn.externalPackages ? { externalPackages: fn.externalPackages.map((pkg) => pkg.name) } : {},
+				...fn.bundler !== "esbuild" ? { bundler: fn.bundler } : {}
 			};
 		})
 	};

package/dist/index.js

@@ -35,6 +35,7 @@ const NO_SUBCOMMANDS_VERBS = [
 	"plugin",
 	"skills",
 	"skill",
+	"ask",
 	"dev",
 	"deploy",
 	"diff",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "neon",
-  "version": "4.11.1",
+  "version": "4.13.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.5",
-    "@neon/config-runtime": "1.0.5",
-    "@neon/sdk": "3.0.0"
+    "@neon/config": "1.1.0",
+    "@neon/sdk": "3.0.0",
+    "@neon/config-runtime": "1.1.0"
   },
   "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.5",
-    "@neon/e2e-harness": "0.0.0"
+    "@neon/e2e-harness": "0.0.0",
+    "@neon-internals/env-core": "0.0.6"
   },
   "publishConfig": {
     "access": "public",