@duyquangnvx/create-agent-cli 0.11.1 → 0.13.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@ What changed in each release of `@duyquangnvx/agent-cli` (the Runtime) and `@duy
 
 ## Unreleased
 
+## v0.13.0 (2026-10-23)
+
+### Changed
+
+- **Breaking:** `ctx.spawn`'s `progress: true` is now `onLine: ctx.progress`. `onLine` takes any callback, which receives each line of the child's stdout and stderr as it arrives, so a Command can parse a tool's progress output (`ffmpeg -progress pipe:1`) into its own `ctx.progress` lines; an `onLine` that throws kills the child and fails the run with its error. A lone `\r` now ends a line too, as in ffmpeg's `-stats` and curl's progress, instead of joining every status update into one line.
+
+## v0.12.0 (2026-10-23)
+
+### Added
+
+- `ctx.spawn`'s `stdin` option writes a child's stdin: a string or bytes, or an `AsyncIterable<Uint8Array>` written as the child reads it, so a large input streams without being held in memory. Writing stops on `ctx.signal`; a stream that throws kills the child and fails the run with its error; a child that exits before reading it all is judged by its exit code. A fake `spawn` given to `runCli` receives it as `stdin`.
+
 ## v0.11.1 (2026-10-22)
 
 ### Changed

package/dist/bin.js

@@ -6607,6 +6607,10 @@ const CMD_SHIM = /\.cmd$/i;
 const CMD_META = /([()\][%!^"`<>&|;, *?])/g;
 const PATH_SEPARATOR = /[\\/]/;
 const TRAILING_CR = /\r$/;
+const LINE_END = /\r\n|\r(?!$)|\n/;
+function isWhole(input) {
+	return typeof input === "string" || input instanceof Uint8Array;
+}
 function escapedForCmd(text) {
 	return text.replace(CMD_META, "^$1");
 }
@@ -6657,25 +6661,61 @@ function stop(child) {
 /** Calls `onLine` with each complete line pushed, and with the unterminated rest at the end. */
 function lineSplitter(onLine) {
 	let rest = "";
-	const emit = (line) => onLine?.(line.replace(TRAILING_CR, ""));
 	return {
 		push(text) {
 			if (onLine === void 0) return;
-			const lines = (rest + text).split("\n");
+			const lines = (rest + text).split(LINE_END);
 			rest = lines.pop() ?? "";
-			for (const line of lines) emit(line);
+			for (const line of lines) onLine(line);
 		},
 		end() {
-			if (rest !== "") emit(rest);
+			if (rest !== "") onLine?.(rest.replace(TRAILING_CR, ""));
 			rest = "";
 		}
 	};
 }
+/** `onLine`, passing what it throws to `fail` and called no more once `failed()`. */
+function guarded(onLine, failed, fail) {
+	if (onLine === void 0) return void 0;
+	return (line) => {
+		if (failed()) return;
+		try {
+			onLine(line);
+		} catch (error) {
+			fail(error);
+		}
+	};
+}
+/** Settles once the child has taken what was written, or its stdin has closed. */
+function drained(stdin) {
+	return new Promise((resolve) => {
+		const done = () => {
+			stdin.off("drain", done);
+			stdin.off("close", done);
+			resolve();
+		};
+		stdin.on("drain", done);
+		stdin.on("close", done);
+	});
+}
+/**
+* Writes `input` to the child's stdin and ends it, stopping once the child is gone or the run
+* aborts.
+*/
+async function feed(stdin, input, signal) {
+	stdin.on("error", () => void 0);
+	const chunks = isWhole(input) ? [input] : input;
+	for await (const chunk of chunks) {
+		if (signal.aborted || stdin.destroyed) return;
+		if (!stdin.write(chunk)) await drained(stdin);
+	}
+	stdin.end();
+}
 /**
 * Runs a child process to its end; it is killed on abort, and the promise settles only once it has
 * exited. A `detached` child leaves the terminal's process group on POSIX, and so its Ctrl-C.
 */
-async function spawnChild(command, args, { cwd, env, signal, onLine, detached = false }) {
+async function spawnChild(command, args, { cwd, env, signal, onLine, stdin, detached = false }) {
 	signal.throwIfAborted();
 	const launch = process.platform === "win32" ? await windowsLaunch(command, args, env) : {
 		command,
@@ -6690,29 +6730,37 @@ async function spawnChild(command, args, { cwd, env, signal, onLine, detached =
 			shell: launch.shell,
 			windowsHide: true,
 			stdio: [
-				"ignore",
+				stdin === void 0 ? "ignore" : "pipe",
 				"pipe",
 				"pipe"
 			],
 			detached: detached && process.platform !== "win32"
 		});
+		let stopped = Promise.resolve();
+		const kill = () => {
+			stopped = stop(child);
+		};
+		signal.addEventListener("abort", kill, { once: true });
+		let callerFailure;
+		const fail = (error) => {
+			if (callerFailure !== void 0) return;
+			callerFailure = { error };
+			kill();
+		};
 		let stdout = "";
 		let stderr = "";
-		const stdoutLines = lineSplitter(onLine);
-		const stderrLines = lineSplitter(onLine);
-		child.stdout.setEncoding("utf8").on("data", (chunk) => {
+		const lines = guarded(onLine, () => callerFailure !== void 0, fail);
+		const stdoutLines = lineSplitter(lines);
+		const stderrLines = lineSplitter(lines);
+		child.stdout?.setEncoding("utf8").on("data", (chunk) => {
 			stdout += chunk;
 			stdoutLines.push(chunk);
 		});
-		child.stderr.setEncoding("utf8").on("data", (chunk) => {
+		child.stderr?.setEncoding("utf8").on("data", (chunk) => {
 			stderr += chunk;
 			stderrLines.push(chunk);
 		});
-		let stopped = Promise.resolve();
-		const kill = () => {
-			stopped = stop(child);
-		};
-		signal.addEventListener("abort", kill, { once: true });
+		if (stdin !== void 0 && child.stdin !== null) feed(child.stdin, stdin, signal).catch(fail);
 		child.on("error", (error) => {
 			signal.removeEventListener("abort", kill);
 			reject(error);
@@ -6725,6 +6773,11 @@ async function spawnChild(command, args, { cwd, env, signal, onLine, detached =
 			}
 			stdoutLines.end();
 			stderrLines.end();
+			if (callerFailure !== void 0) {
+				const { error } = callerFailure;
+				stopped.then(() => reject(error));
+				return;
+			}
 			resolve({
 				stdout,
 				stderr,
@@ -6749,23 +6802,55 @@ function missingError(command, cause) {
 		hint: `install ${command}, then run the same command again`
 	}, { cause });
 }
+function startError(command, error, fileError) {
+	if (isMissingFile(error)) return missingError(command, error);
+	return fileError(error, {
+		path: command,
+		access: "read"
+	});
+}
+async function* reported(stream, onError) {
+	try {
+		yield* stream;
+	} catch (error) {
+		onError(error);
+		throw error;
+	}
+}
+/** `input`, a stream passing each error it throws to `onError` before the reader sees it. */
+function reporting(input, onError) {
+	return input === void 0 || isWhole(input) ? input : reported(input, onError);
+}
+/** `onLine`, passing each error it throws to `onError` before its caller sees it. */
+function reportingLines(onLine, onError) {
+	if (onLine === void 0) return void 0;
+	return (line) => {
+		try {
+			onLine(line);
+		} catch (error) {
+			onError(error);
+			throw error;
+		}
+	};
+}
 /** `ctx.spawn`: `spawn` bound to the run, its start failures classified by errno. */
 function contextSpawn(run, defaults, fileError) {
 	return async (command, args = [], options = {}) => {
+		let callerFailure;
+		const caller = (error) => {
+			callerFailure = { error };
+		};
 		let result;
 		try {
 			result = await run(command, args, {
 				cwd: options.cwd ?? defaults.cwd,
 				env: options.env ?? defaults.env,
 				signal: defaults.signal,
-				onLine: options.progress === true ? defaults.progress : void 0
+				onLine: reportingLines(options.onLine, caller),
+				stdin: reporting(options.stdin, caller)
 			});
 		} catch (error) {
-			if (isMissingFile(error)) throw missingError(command, error);
-			throw fileError(error, {
-				path: command,
-				access: "read"
-			});
+			throw callerFailure?.error === error ? error : startError(command, error, fileError);
 		}
 		if (options.check === true && result.exitCode !== 0) throw failedError(command, result);
 		return result;
@@ -9340,8 +9425,7 @@ function portsBaseOf(scope, signal) {
 		spawn: contextSpawn(options.spawn ?? realSpawn, {
 			cwd,
 			env,
-			signal,
-			progress
+			signal
 		}, fileError)
 	};
 }
@@ -9675,14 +9759,14 @@ async function runProcess(cli) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.11.1";
+var version$1 = "0.13.0";
 var description = "Creates a new Agent CLI repository wired to @duyquangnvx/agent-cli.";
 //#endregion
 //#region src/build.ts
 const build = {
-	"sha": "92df9c6",
+	"sha": "1c3a29e",
 	"dirty": false,
-	"builtAt": "2026-10-22T10:48:39.000Z"
+	"builtAt": "2026-10-23T05:43:49.000Z"
 };
 //#endregion
 //#region src/steps.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duyquangnvx/create-agent-cli",
-  "version": "0.11.1",
+  "version": "0.13.0",
   "description": "Creates a new Agent CLI repository wired to @duyquangnvx/agent-cli.",
   "type": "module",
   "engines": {
@@ -19,7 +19,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@duyquangnvx/agent-cli": "0.11.1",
+    "@duyquangnvx/agent-cli": "0.13.0",
     "tsdown": "0.23.0",
     "zod": "4.6.7"
   },