@duyquangnvx/create-agent-cli 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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

package/dist/bin.js

@@ -6607,6 +6607,7 @@ 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;
 }
@@ -6660,20 +6661,31 @@ 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) => {
@@ -6724,10 +6736,22 @@ async function spawnChild(command, args, { cwd, env, signal, onLine, stdin, deta
 			],
 			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);
+		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);
@@ -6736,16 +6760,7 @@ async function spawnChild(command, args, { cwd, env, signal, onLine, stdin, deta
 			stderr += chunk;
 			stderrLines.push(chunk);
 		});
-		let stopped = Promise.resolve();
-		const kill = () => {
-			stopped = stop(child);
-		};
-		signal.addEventListener("abort", kill, { once: true });
-		let inputFailure;
-		if (stdin !== void 0 && child.stdin !== null) feed(child.stdin, stdin, signal).catch((error) => {
-			inputFailure = { error };
-			kill();
-		});
+		if (stdin !== void 0 && child.stdin !== null) feed(child.stdin, stdin, signal).catch(fail);
 		child.on("error", (error) => {
 			signal.removeEventListener("abort", kill);
 			reject(error);
@@ -6756,13 +6771,13 @@ async function spawnChild(command, args, { cwd, env, signal, onLine, stdin, deta
 				stopped.then(() => reject(signal.reason));
 				return;
 			}
-			if (inputFailure !== void 0) {
-				const { error } = inputFailure;
+			stdoutLines.end();
+			stderrLines.end();
+			if (callerFailure !== void 0) {
+				const { error } = callerFailure;
 				stopped.then(() => reject(error));
 				return;
 			}
-			stdoutLines.end();
-			stderrLines.end();
 			resolve({
 				stdout,
 				stderr,
@@ -6806,23 +6821,36 @@ async function* reported(stream, onError) {
 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 inputFailure;
+		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,
-				stdin: reporting(options.stdin, (error) => {
-					inputFailure = { error };
-				})
+				onLine: reportingLines(options.onLine, caller),
+				stdin: reporting(options.stdin, caller)
 			});
 		} catch (error) {
-			throw inputFailure?.error === error ? error : startError(command, error, fileError);
+			throw callerFailure?.error === error ? error : startError(command, error, fileError);
 		}
 		if (options.check === true && result.exitCode !== 0) throw failedError(command, result);
 		return result;
@@ -9397,8 +9425,7 @@ function portsBaseOf(scope, signal) {
 		spawn: contextSpawn(options.spawn ?? realSpawn, {
 			cwd,
 			env,
-			signal,
-			progress
+			signal
 		}, fileError)
 	};
 }
@@ -9732,14 +9759,14 @@ async function runProcess(cli) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.12.0";
+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": "cc95e77",
+	"sha": "1c3a29e",
 	"dirty": false,
-	"builtAt": "2026-10-23T01:20:23.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.12.0",
+  "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.12.0",
+    "@duyquangnvx/agent-cli": "0.13.0",
     "tsdown": "0.23.0",
     "zod": "4.6.7"
   },