micro-models-agent 2.16.0 → 2.16.1

package/CHANGELOG.md

@@ -21,6 +21,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/), and this
 - **Web UI boot was dead on 2.15.0** (`src/modules/webui/assets/js/settings.js`): a stray `}` in `setStaleBar` pushed `return` to top level (`Uncaught SyntaxError: Illegal return statement`), killing the whole `app.js` import graph — blank page, no feed, selectors stuck at `–`. One-line brace fix.
 - **Web e2e boot smoke** (`tests/e2e/web-boot.e2e-test.ts`): `mma web` boots in a real Chromium with zero console/page errors (live session tab, chrome skeleton, settings modal) and every served JS module in the live `/app.js` import graph answers 200; `web-helpers.launch` now names collected console errors when the feed never boots, so the next broken module fails with its `SyntaxError` in the message instead of a bare timeout.
 
+## [2.16.1] - 2026-10-01
+
+### Added
+
+- **Smooth streamed-text cascade** (`src/modules/webui/assets/js/feed.js`, `md.js`, `styles.css`): live markdown chunks are buffered and flushed once per animation frame (`requestAnimationFrame`, multi-feed safe) instead of write+scroll per SSE event, and each streamed text run renders in a `span.tk` with a short opacity-only `tkIn` fade (staggered `(n%4)*20ms`, `.15s`). History render and code blocks skip the animation; killed by `prefers-reduced-motion`.
+
 ## [2.16.0] - 2026-10-01
 
 ### Added

package/dist/assets/js/feed.js

@@ -246,16 +246,20 @@ function resetRun() {
 
 // Options passed to the streaming Markdown renderer: localized code-block
 // copy labels. Highlighting is applied by `md.js` once a fence closes.
-function mdOpts() {
+// `animate` wraps live-streamed text chunks in `span.tk` (CSS `tkIn` fade);
+// history render and code blocks skip it.
+function mdOpts(animate) {
   return {
     copyLabel: t("web.code.copy"),
     copiedLabel: t("web.code.copied"),
     copyFailedLabel: t("web.code.copy_failed"),
+    animate: animate === true,
   };
 }
 
 // Close the active Markdown segment (if any) and clear the text S.state.
 export function finishMd() {
+  flushText();
   if (S.curMd) {
     S.curMd.root.classList.remove("streaming");
     S.curMd.end();
@@ -264,6 +268,38 @@ export function finishMd() {
   S.curText = null;
 }
 
+// Text chunks arrive in bursts (several SSE `text` events per frame); writing
+// and scrolling on every one thrashes layout and stacks overlapping `tkIn`
+// fades ("рвано"). Buffer them and flush once per animation frame instead.
+let textBuf = "";
+let textFeed = null;
+let textScheduled = false;
+
+function flushText() {
+  textScheduled = false;
+  if (!textBuf || !S.curMd) {
+    textBuf = "";
+    textFeed = null;
+    return;
+  }
+  const buf = textBuf;
+  const feed = textFeed;
+  textBuf = "";
+  textFeed = null;
+  S.curMd.write(buf);
+  if (feed && feed === activeFeed()) scroll();
+}
+
+function scheduleText() {
+  if (textScheduled) return;
+  textScheduled = true;
+  if (typeof window !== "undefined" && typeof window.requestAnimationFrame === "function") {
+    window.requestAnimationFrame(flushText);
+  } else {
+    flushText();
+  }
+}
+
 export function onText(chunk, sid) {
   const feed = feedForEvent(sid);
   clearBusy(feed);
@@ -275,14 +311,17 @@ export function onText(chunk, sid) {
   if (S.curText == null) {
     flushRun();
     S.curText = "";
-    S.curMd = mountMarkdown(feed, mdOpts());
+    S.curMd = mountMarkdown(feed, mdOpts(true));
     S.curMd.root.classList.add("streaming");
     S.turnRoots.push(S.curMd.root);
   }
   S.curText += chunk;
   S.turnMd += chunk;
-  S.curMd.write(chunk);
-  if (feed === activeFeed()) scroll();
+  // A second session streaming concurrently must not merge into another feed's buffer.
+  if (textFeed && textFeed !== feed) flushText();
+  textFeed = feed;
+  textBuf += chunk;
+  scheduleText();
 }
 
 export function finishThink() {

package/dist/assets/md.js

@@ -198,6 +198,20 @@ function addText(data, text) {
     data.code.codeEl.appendChild(document.createTextNode(text));
     return;
   }
+  if (data.opts.animate) {
+    // Stagger cascade within a flush: each span starts before the previous
+    // one finishes ((n%4)*20ms delay, .15s duration). Modulo keeps long
+    // outputs cascading instead of settling on a permanent max delay.
+    const n = data.animN || 0;
+    data.animN = n + 1;
+    const span = document.createElement("span");
+    span.className = "tk";
+    const delay = (n % 4) * 20;
+    if (delay) span.style.animationDelay = delay + "ms";
+    span.appendChild(document.createTextNode(text));
+    data.nodes[data.index].appendChild(span);
+    return;
+  }
   smd.default_add_text(data, text);
 }
 

package/dist/assets/styles.css

@@ -656,6 +656,12 @@ body.light .sel > button { border: 1px solid var(--border); }
   content: "▌"; color: var(--accent); margin-left: 2px;
   animation: blink 1s steps(2, start) infinite;
 }
+/* per-chunk typewriter fade for live markdown (md.js wraps each streamed
+   text chunk in `span.tk` when `opts.animate` is set; history render and
+   code blocks skip it). Opacity-only: `.tk` stays inline so wrapping is
+   untouched. Killed by the `prefers-reduced-motion` block below. */
+@keyframes tkIn { from { opacity: 0; } }
+.md.streaming .tk { animation: tkIn .15s ease-out backwards; }
 /* alive labels: in-feed spinner, the *live* think block, rail phase,
    a running tool. Finished blocks stay static — a pulsing "думаю" after
    the turn reads as hung. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "micro-models-agent",
-  "version": "2.16.0",
+  "version": "2.16.1",
   "description": "Micro Models Agent (MMA) — LLM agent harness for small models (Qwen3.5-9B, 32K-64K context)",
   "type": "module",
   "bin": {