@leanandmean/coding-agent 0.74.1-scramjet.24 → 0.74.1-scramjet.26

package/docs/settings.md

@@ -135,7 +135,6 @@ When a provider requests a retry delay longer than `retry.provider.maxRetryDelay
 |---------|------|---------|-------------|
 | `terminal.showImages` | boolean | `true` | Show images in terminal (if supported) |
 | `terminal.imageWidthCells` | number | `60` | Preferred inline image width in terminal cells |
-| `terminal.clearOnShrink` | boolean | `false` | Clear empty rows when content shrinks (can cause flicker) |
 | `images.autoResize` | boolean | `true` | Resize images to 2000x2000 max |
 | `images.blockImages` | boolean | `false` | Block all images from being sent to LLM |
 

package/docs/tui.md

@@ -6,6 +6,18 @@ Extensions and custom tools can render custom TUI components for interactive use
 
 **Source:** [`@leanandmean/tui`](https://github.com/earendil-works/pi-mono/tree/main/packages/tui)
 
+## Transcript Rendering
+
+**Scramjet divergence source:** [`packages/tui/src/tui.ts`](../../tui/src/tui.ts)
+
+The interactive mode separates terminal output into append-only committed history and a bounded live canvas. Finalized transcript components are retained for later rebuilds but written to native scrollback only once during routine rendering. Streaming messages, running tools, status, widgets, the editor, footer, autocomplete, and overlays stay live.
+
+Mutable output is tail-windowed to at most `terminal.rows - 1` rendered lines before it is written, so live content cannot push mutable rows into native scrollback. Finalization removes the mutable preview and commits the component's finalized presentation once. Pending tools form an ordering barrier, and image-backed tools commit only after their conversions settle.
+
+At the TUI API level, `setLiveRegionStart(component)` selects the first direct child in the live canvas, `commit()` atomically appends newly finalized rows, and `rebuild()` deliberately repaints retained history. Detaching the selected component safely resets committed rendering and returns the TUI to legacy full-repaint rendering. Routine updates, content shrink, temporary-UI dismissal, and height-only resize do not clear scrollback or replay committed history. Width and theme changes, session reconstruction, presentation-setting changes, reload, resume, and external-editor return use deliberate rebuilds because retained output must be reflowed or restyled; those rebuilds intentionally bottom-anchor the display.
+
+Overlays remain screen-relative and are composed over the bounded live canvas. Closing an overlay or autocomplete restores the underlying live rows without mutating committed history.
+
 ## Component Interface
 
 All components implement:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leanandmean/coding-agent",
-  "version": "0.74.1-scramjet.24",
+  "version": "0.74.1-scramjet.26",
   "publishConfig": {
     "access": "public"
   },
@@ -35,7 +35,7 @@
   "dependencies": {
     "@leanandmean/agent": "0.74.1-scramjet.13",
     "@leanandmean/ai": "0.74.1-scramjet.10",
-    "@leanandmean/tui": "0.74.1-scramjet.8",
+    "@leanandmean/tui": "0.74.1-scramjet.9",
     "@silvia-odwyer/photon-node": "^0.3.4",
     "chalk": "^5.5.0",
     "dictionary-en": "^4.0.0",