agent-from-zero 0.32.2 → 0.32.3

package/dist/ink/app.js

@@ -36,7 +36,10 @@ const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧",
 // <Static> (formatted as markdown) the moment it finishes.
 function liveTail(s) {
     const rows = process.stdout.rows || 24;
-    const maxLines = Math.max(3, rows - 14); // reserve rows for the input box + status bar + agent bar + margins
+    // Keep the preview SMALL (≤10 lines) even on a tall terminal: Ink repaints this
+    // whole region on every (throttled) update, and a smaller block repaints with
+    // far less flicker. The full reply still lands in <Static> on commit.
+    const maxLines = Math.max(3, Math.min(10, rows - 14)); // reserve rows for the input box + status bar + agent bar + margins
     const cols = process.stdout.columns || 80;
     const maxChars = maxLines * cols; // rough bound so one very long line can't blow past either
     let t = s.length > maxChars ? s.slice(-maxChars) : s;

package/dist/ink/sink.js

@@ -29,15 +29,28 @@ export function makeInkSink(api) {
         // The streamed answer accumulates in the dynamic region as raw text (live,
         // "it's typing"), then commits as ONE markdown-rendered item when it ends —
         // partial markdown mid-stream renders badly, so we format only once it's whole.
+        //
+        // THROTTLED on purpose: a fast stream delivers tokens dozens of times a
+        // second, and Ink erases+redraws the whole live region on every state change
+        // — repainting a multi-line block that often is what makes a long answer
+        // "shake" violently. So we coalesce a burst of tokens into ONE setLive every
+        // ~90ms (≈11 fps, smooth but cheap). The final, complete answer still commits
+        // to <Static> on end(), so nothing is lost or under-rendered.
         answer() {
             let buf = "";
+            let timer = null;
             api.setLive("");
             return {
                 push: (tok) => {
                     buf += tok;
-                    api.setLive(buf);
+                    if (!timer)
+                        timer = setTimeout(() => { timer = null; api.setLive(buf); }, 90); // leading-edge throttle: schedule one repaint, ignore the burst until it fires
                 },
                 end: () => {
+                    if (timer) {
+                        clearTimeout(timer);
+                        timer = null;
+                    } // drop the pending repaint — we're committing now
                     api.setLive(null); // clear the live preview first, then commit (no flicker/duplicate)
                     if (buf.trim())
                         api.pushItem({ kind: "answer", text: buf });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-from-zero",
-  "version": "0.32.2",
+  "version": "0.32.3",
   "description": "Build a Claude Code-style CLI agent from scratch, with AI as your pair programmer — companion code for a 10-day tutorial (DeepSeek by default, any OpenAI-compatible model)",
   "type": "module",
   "bin": {