@lizard-build/sdk 0.1.31 → 0.1.32

package/dist/index.d.mts

@@ -25,7 +25,9 @@ interface ProcessOpts {
     envs?: Record<string, string>;
     user?: string;
     workdir?: string;
+    /** Called with each stdout line as it is produced, rather than at the end. */
     onStdout?: (data: string) => void;
+    /** Called with each stderr line as it is produced, rather than at the end. */
     onStderr?: (data: string) => void;
 }
 /**
@@ -62,6 +64,12 @@ declare class Process {
      * ```
      */
     exec(cmd: string, opts?: ProcessOpts): Promise<ProcessResult>;
+    /**
+     * Read an SSE exec stream, handing each line to the caller as it arrives while
+     * still accumulating the full result. Events are `{stream, line}` for output and
+     * `{exitCode}` at the end.
+     */
+    private consumeStream;
 }
 
 interface FsOpts {

package/dist/index.d.ts

@@ -25,7 +25,9 @@ interface ProcessOpts {
     envs?: Record<string, string>;
     user?: string;
     workdir?: string;
+    /** Called with each stdout line as it is produced, rather than at the end. */
     onStdout?: (data: string) => void;
+    /** Called with each stderr line as it is produced, rather than at the end. */
     onStderr?: (data: string) => void;
 }
 /**
@@ -62,6 +64,12 @@ declare class Process {
      * ```
      */
     exec(cmd: string, opts?: ProcessOpts): Promise<ProcessResult>;
+    /**
+     * Read an SSE exec stream, handing each line to the caller as it arrives while
+     * still accumulating the full result. Events are `{stream, line}` for output and
+     * `{exitCode}` at the end.
+     */
+    private consumeStream;
 }
 
 interface FsOpts {

package/dist/index.js

@@ -163,9 +163,10 @@ var Process = class {
    * ```
    */
   async exec(cmd, opts) {
+    const streaming = Boolean(opts?.onStdout || opts?.onStderr);
     const res = await fetch(`${this.config.apiUrl}/api/sandboxes/${this.sandboxId}/exec`, {
       method: "POST",
-      headers: this.config.headers,
+      headers: streaming ? { ...this.config.headers, Accept: "text/event-stream" } : this.config.headers,
       body: JSON.stringify({
         cmd,
         envs: opts?.envs,
@@ -176,7 +177,51 @@ var Process = class {
       signal: AbortSignal.timeout(opts?.timeoutMs ?? 6e4)
     });
     if (!res.ok) await handleApiError(res);
-    return res.json();
+    if (!streaming) return res.json();
+    return this.consumeStream(res, opts);
+  }
+  /**
+   * Read an SSE exec stream, handing each line to the caller as it arrives while
+   * still accumulating the full result. Events are `{stream, line}` for output and
+   * `{exitCode}` at the end.
+   */
+  async consumeStream(res, opts) {
+    const reader = res.body?.getReader();
+    if (!reader) return { stdout: "", stderr: "", exitCode: 0 };
+    const decoder = new TextDecoder();
+    let buf = "";
+    let stdout = "";
+    let stderr = "";
+    let exitCode = 0;
+    const handle = (raw) => {
+      if (!raw.startsWith("data:")) return;
+      let ev;
+      try {
+        ev = JSON.parse(raw.slice(5).trim());
+      } catch {
+        return;
+      }
+      if (ev.line !== void 0) {
+        if (ev.stream === "stderr") {
+          stderr += ev.line + "\n";
+          opts.onStderr?.(ev.line);
+        } else {
+          stdout += ev.line + "\n";
+          opts.onStdout?.(ev.line);
+        }
+      }
+      if (ev.exitCode !== void 0) exitCode = ev.exitCode;
+    };
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buf += decoder.decode(value, { stream: true });
+      const lines = buf.split("\n");
+      buf = lines.pop() ?? "";
+      for (const l of lines) handle(l);
+    }
+    if (buf) handle(buf);
+    return { stdout: stdout.trimEnd(), stderr: stderr.trimEnd(), exitCode };
   }
 };
 

package/dist/index.mjs

@@ -127,9 +127,10 @@ var Process = class {
    * ```
    */
   async exec(cmd, opts) {
+    const streaming = Boolean(opts?.onStdout || opts?.onStderr);
     const res = await fetch(`${this.config.apiUrl}/api/sandboxes/${this.sandboxId}/exec`, {
       method: "POST",
-      headers: this.config.headers,
+      headers: streaming ? { ...this.config.headers, Accept: "text/event-stream" } : this.config.headers,
       body: JSON.stringify({
         cmd,
         envs: opts?.envs,
@@ -140,7 +141,51 @@ var Process = class {
       signal: AbortSignal.timeout(opts?.timeoutMs ?? 6e4)
     });
     if (!res.ok) await handleApiError(res);
-    return res.json();
+    if (!streaming) return res.json();
+    return this.consumeStream(res, opts);
+  }
+  /**
+   * Read an SSE exec stream, handing each line to the caller as it arrives while
+   * still accumulating the full result. Events are `{stream, line}` for output and
+   * `{exitCode}` at the end.
+   */
+  async consumeStream(res, opts) {
+    const reader = res.body?.getReader();
+    if (!reader) return { stdout: "", stderr: "", exitCode: 0 };
+    const decoder = new TextDecoder();
+    let buf = "";
+    let stdout = "";
+    let stderr = "";
+    let exitCode = 0;
+    const handle = (raw) => {
+      if (!raw.startsWith("data:")) return;
+      let ev;
+      try {
+        ev = JSON.parse(raw.slice(5).trim());
+      } catch {
+        return;
+      }
+      if (ev.line !== void 0) {
+        if (ev.stream === "stderr") {
+          stderr += ev.line + "\n";
+          opts.onStderr?.(ev.line);
+        } else {
+          stdout += ev.line + "\n";
+          opts.onStdout?.(ev.line);
+        }
+      }
+      if (ev.exitCode !== void 0) exitCode = ev.exitCode;
+    };
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buf += decoder.decode(value, { stream: true });
+      const lines = buf.split("\n");
+      buf = lines.pop() ?? "";
+      for (const l of lines) handle(l);
+    }
+    if (buf) handle(buf);
+    return { stdout: stdout.trimEnd(), stderr: stderr.trimEnd(), exitCode };
   }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lizard-build/sdk",
-  "version": "0.1.31",
+  "version": "0.1.32",
   "description": "Firecracker microVM sandboxes for AI agents — boot Linux in milliseconds, run code, write files, expose ports over HTTPS, then pause a session with memory intact and resume it later. TypeScript SDK for Lizard Sandboxes (lizard.build).",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",