@machinen/runtime 0.1.1 → 0.2.0

package/API.md

@@ -1448,10 +1448,17 @@ Called with each stderr chunk as it arrives (pass-through tee).
 
 > **stdout**: `string`
 
+Concatenated stdout bytes, decoded as UTF-8. Always `""` when the
+caller passed `onStdout` — streaming callers already have the
+bytes and a parallel buffered copy would defeat the streaming
+(and at multi-GB volumes would crash with ERR_STRING_TOO_LONG).
+
 ##### stderr
 
 > **stderr**: `string`
 
+Same shape as `stdout` for the stderr channel + `onStderr`.
+
 ***
 
 ### VsockExecPtyOptions

package/dist/index.d.ts

@@ -19,7 +19,14 @@ interface VsockExecOptions {
 }
 interface VsockExecResult {
     exitCode: number;
+    /**
+     * Concatenated stdout bytes, decoded as UTF-8. Always `""` when the
+     * caller passed `onStdout` — streaming callers already have the
+     * bytes and a parallel buffered copy would defeat the streaming
+     * (and at multi-GB volumes would crash with ERR_STRING_TOO_LONG).
+     */
     stdout: string;
+    /** Same shape as `stdout` for the stderr channel + `onStderr`. */
     stderr: string;
 }
 declare const VsockExec: {

package/dist/index.js

@@ -877,11 +877,17 @@ async function runOnSocket(socket, cmd, opts) {
           buf = buf.subarray(take);
           awaitingBytes -= take;
           if (payloadTag === "O") {
-            stdoutBufs.push(chunk);
-            opts.onStdout?.(chunk);
+            if (opts.onStdout) {
+              opts.onStdout(chunk);
+            } else {
+              stdoutBufs.push(chunk);
+            }
           } else if (payloadTag === "E") {
-            stderrBufs.push(chunk);
-            opts.onStderr?.(chunk);
+            if (opts.onStderr) {
+              opts.onStderr(chunk);
+            } else {
+              stderrBufs.push(chunk);
+            }
           }
           if (awaitingBytes === 0) {
             payloadTag = null;