@duyquangnvx/create-agent-cli 0.11.1 → 0.12.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ What changed in each release of `@duyquangnvx/agent-cli` (the Runtime) and `@duy
 
 ## Unreleased
 
+## 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,9 @@ const CMD_SHIM = /\.cmd$/i;
 const CMD_META = /([()\][%!^"`<>&|;, *?])/g;
 const PATH_SEPARATOR = /[\\/]/;
 const TRAILING_CR = /\r$/;
+function isWhole(input) {
+	return typeof input === "string" || input instanceof Uint8Array;
+}
 function escapedForCmd(text) {
 	return text.replace(CMD_META, "^$1");
 }
@@ -6671,11 +6674,36 @@ function lineSplitter(onLine) {
 		}
 	};
 }
+/** 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,7 +6718,7 @@ async function spawnChild(command, args, { cwd, env, signal, onLine, detached =
 			shell: launch.shell,
 			windowsHide: true,
 			stdio: [
-				"ignore",
+				stdin === void 0 ? "ignore" : "pipe",
 				"pipe",
 				"pipe"
 			],
@@ -6700,11 +6728,11 @@ async function spawnChild(command, args, { cwd, env, signal, onLine, detached =
 		let stderr = "";
 		const stdoutLines = lineSplitter(onLine);
 		const stderrLines = lineSplitter(onLine);
-		child.stdout.setEncoding("utf8").on("data", (chunk) => {
+		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);
 		});
@@ -6713,6 +6741,11 @@ async function spawnChild(command, args, { cwd, env, signal, onLine, detached =
 			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();
+		});
 		child.on("error", (error) => {
 			signal.removeEventListener("abort", kill);
 			reject(error);
@@ -6723,6 +6756,11 @@ async function spawnChild(command, args, { cwd, env, signal, onLine, detached =
 				stopped.then(() => reject(signal.reason));
 				return;
 			}
+			if (inputFailure !== void 0) {
+				const { error } = inputFailure;
+				stopped.then(() => reject(error));
+				return;
+			}
 			stdoutLines.end();
 			stderrLines.end();
 			resolve({
@@ -6749,23 +6787,42 @@ 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);
+}
 /** `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 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: options.progress === true ? defaults.progress : void 0,
+				stdin: reporting(options.stdin, (error) => {
+					inputFailure = { error };
+				})
 			});
 		} catch (error) {
-			if (isMissingFile(error)) throw missingError(command, error);
-			throw fileError(error, {
-				path: command,
-				access: "read"
-			});
+			throw inputFailure?.error === error ? error : startError(command, error, fileError);
 		}
 		if (options.check === true && result.exitCode !== 0) throw failedError(command, result);
 		return result;
@@ -9675,14 +9732,14 @@ async function runProcess(cli) {
 }
 //#endregion
 //#region package.json
-var version$1 = "0.11.1";
+var version$1 = "0.12.0";
 var description = "Creates a new Agent CLI repository wired to @duyquangnvx/agent-cli.";
 //#endregion
 //#region src/build.ts
 const build = {
-	"sha": "92df9c6",
+	"sha": "cc95e77",
 	"dirty": false,
-	"builtAt": "2026-10-22T10:48:39.000Z"
+	"builtAt": "2026-10-23T01:20:23.000Z"
 };
 //#endregion
 //#region src/steps.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duyquangnvx/create-agent-cli",
-  "version": "0.11.1",
+  "version": "0.12.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.12.0",
     "tsdown": "0.23.0",
     "zod": "4.6.7"
   },