@tangle-network/sdk-cli-runner 0.3.0 → 0.3.1

package/dist/index.d.mts

@@ -61,6 +61,13 @@ interface CliSpawnConfig {
    * may start a process meant to outlive it (a dev server a preview serves).
    */
   ownProcessGroup?: boolean;
+  /**
+   * What a child that rejects its stdin (closes the pipe early) gets. "stop"
+   * (default) stops it, because an adapter's turn cannot continue without its
+   * input. "report" lets it exit on its own and reports `stdinError`, for a
+   * caller that judges the exit itself.
+   */
+  stdinFailure?: "stop" | "report";
 }
 /** What a consumer-owned launch is asked to start, after env assembly. */
 interface CliLaunchSpec {
@@ -119,6 +126,8 @@ interface CliExitResult {
   spawnError?: string;
   /** The native child closed or rejected stdin before its input was delivered. */
   stdinError?: string;
+  /** The errno code of `stdinError` (EPIPE for a pipe the child closed). */
+  stdinErrorCode?: string;
   /** Raw evidence could not be written or flushed; the process is not a complete trace. */
   captureError?: string;
   /** The caller's abort signal fired before the process exited. */
@@ -229,6 +238,8 @@ interface CliExecResult<T> {
 interface CliExecOptions {
   /** Newest stdout and stderr bytes retained per stream. Default 64 MiB. */
   maxOutputBytes?: number;
+  /** Written to the child's stdin, which then closes. Omitted: stdin stays as the config leaves it. */
+  stdin?: string;
 }
 /**
  * One value the runner writes to a child process's standard input. A string

package/dist/index.mjs

@@ -1118,7 +1118,7 @@ function attachCliProcess(config, parserConfig, run) {
 	const { launch, killer, capture, detached } = run;
 	const child = launch.child;
 	const spawnedAt = Date.now();
-	const stdin = watchStdinFailure(child, killer);
+	const stdin = watchStdinFailure(child, killer, config.stdinFailure);
 	const group = config.ownProcessGroup && detached && process.platform !== "win32" && child.pid ? new CliProcessGroup(child.pid) : void 0;
 	child.stdout?.on("data", (chunk) => capture.frame("stdout", chunk));
 	child.stderr?.on("data", (chunk) => capture.frame("stderr", chunk));
@@ -1201,11 +1201,16 @@ function spawnChild(config, processEnv, detached) {
 		...isolated ? safeSpawnOptions : spawnOptions
 	});
 }
-function watchStdinFailure(child, killer) {
-	const failure = { error: void 0 };
+function watchStdinFailure(child, killer, mode = "stop") {
+	const failure = {
+		error: void 0,
+		code: void 0
+	};
 	child.stdin?.on("error", (error) => {
 		if (failure.error !== void 0) return;
 		failure.error = error.message;
+		failure.code = error.code;
+		if (mode === "report") return;
 		killer.kill("SIGTERM");
 		if (!killer.escalating) killer.escalate(() => child.exitCode === null && child.signalCode === null);
 	});
@@ -1280,6 +1285,7 @@ function createExitPromise(child, run) {
 				timeoutReason: deadlines.timeoutReason,
 				timeoutDiagnostic: deadlines.timeoutDiagnostic,
 				stdinError: stdin.error,
+				...stdin.code === void 0 ? {} : { stdinErrorCode: stdin.code },
 				captureError: capture.error,
 				...abort.aborted ? { aborted: true } : {},
 				...processGroupError === void 0 ? {} : { processGroupError },
@@ -1325,6 +1331,10 @@ async function execCli(config, parserConfig, options = {}) {
 	} : void 0);
 	cliProcess.process.stderr?.on("data", (chunk) => stderr.append(chunk));
 	if (!parserConfig) cliProcess.process.stdout?.on("data", (chunk) => stdout.append(chunk));
+	if (options.stdin !== void 0) {
+		if (options.stdin) cliProcess.write(options.stdin);
+		cliProcess.closeInput();
+	}
 	return {
 		exit: await cliProcess.exitPromise,
 		stderr: stderr.text(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/sdk-cli-runner",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Generic CLI process spawning with stdin/stdout streaming and JSONL parsing",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -26,8 +26,8 @@
     "registry": "https://registry.npmjs.org"
   },
   "tangleRelease": {
-    "sourceSha": "e962211a1ce5f2e11a99b60421e45fca5547ca2d",
-    "mergedAt": "2026-10-27T03:53:58-06:00"
+    "sourceSha": "eac50ce23f7e07901fb8d90150c8032bbc40d2b0",
+    "mergedAt": "2026-10-28T12:36:25-06:00"
   },
   "scripts": {
     "build": "tsdown",