@dreb/coding-agent 2.34.1 → 2.34.3

package/docs/buddy.md

@@ -33,7 +33,7 @@ The buddy won't react until a model is configured. The choice is persisted acros
 | `/buddy pet` | Pet your buddy |
 | `/buddy reroll` | Reroll for a new buddy (new species, name, personality) |
 | `/buddy stats` | Show buddy stats panel |
-| `/buddy off` | Hide the buddy (persists across sessions — it stays hidden on restart until you run `/buddy`) |
+| `/buddy off` | Hide the buddy (persists across sessions, and syncs to any other dreb instance running concurrently — see [Persistence & multiple instances](#persistence--multiple-instances)) |
 
 ## How It Works
 
@@ -42,6 +42,14 @@ The buddy won't react until a model is configured. The choice is persisted acros
 - **Reactions** are generated by the local Ollama model — short, in-character quips based on what just happened
 - **Activity indicator** shows "thinking..." in the buddy panel while waiting for Ollama to respond
 
+## Persistence & multiple instances
+
+The buddy's state — including whether it's hidden via `/buddy off` — lives in a shared file at `~/.dreb/agent/buddy.json`. All dreb instances on the machine (multiple TUIs, and the Telegram bridge) read and write the same file.
+
+Because the state is shared, `/buddy off` (and bringing the buddy back with `/buddy`) **converges across every concurrently-running instance**: each instance re-checks the persisted flag at turn boundaries (when you send a message and when the agent finishes responding), so a buddy you hide in one terminal disappears from the others within one interaction — no restart required. Deleting `~/.dreb/agent/buddy.json` removes the buddy entirely on the next interaction everywhere.
+
+> Note: convergence happens on the next interaction in each instance, not instantly while an instance sits completely idle.
+
 ## Troubleshooting
 
 ### Buddy never reacts / always shows fallback message

package/docs/tui.md

@@ -21,12 +21,12 @@ interface Component {
 
 | Method | Description |
 |--------|-------------|
-| `render(width)` | Return array of strings (one per line). Each line **must not exceed `width`**. |
+| `render(width)` | Return array of strings, one logical line per entry. Entries **must not contain raw `\n` or `\r`**; split multi-line content into separate entries. Each unmarked line **must not exceed `width`**. |
 | `handleInput?(data)` | Receive keyboard input when component has focus. |
 | `wantsKeyRelease?` | If true, component receives key release events (Kitty protocol). Default: false. |
 | `invalidate()` | Clear cached render state. Called on theme changes. |
 
-The TUI appends a full SGR reset and OSC 8 reset at the end of each rendered line. Styles do not carry across lines. If you emit multi-line text with styling, reapply styles per line or use `wrapTextWithAnsi()` so styles are preserved for each wrapped line.
+The TUI appends a full SGR reset and OSC 8 reset at the end of each rendered line. Styles do not carry across lines. If you emit multi-line text with styling, split it into separate render entries and reapply styles per line, or use `wrapTextWithAnsi()` so styles are preserved for each wrapped line.
 
 ## Focusable Interface (IME Support)
 
@@ -287,21 +287,21 @@ handleInput(data: string) {
 
 ## Line Width
 
-**Critical:** Each line from `render()` must not exceed the `width` parameter.
+**Critical:** Each entry from `render()` must represent one logical line and must not contain raw `\n` or `\r`. Split multi-line content before returning it. Unmarked lines must not exceed the `width` parameter.
 
 ```typescript
-import { visibleWidth, truncateToWidth } from "@dreb/tui";
+import { visibleWidth, truncateToWidth, wrapTextWithAnsi } from "@dreb/tui";
 
 render(width: number): string[] {
-  // Truncate long lines
-  return [truncateToWidth(this.text, width)];
+  // Split styled multi-line content into separate render entries.
+  return wrapTextWithAnsi(this.text.replace(/\r\n?/g, "\n"), width);
 }
 ```
 
 Utilities:
 - `visibleWidth(str)` - Get display width (ignores ANSI codes)
 - `truncateToWidth(str, width, ellipsis?)` - Truncate with optional ellipsis
-- `wrapTextWithAnsi(str, width)` - Word wrap preserving ANSI codes
+- `wrapTextWithAnsi(str, width)` - Word wrap preserving ANSI codes and splitting on raw line breaks
 
 ## Creating Custom Components
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@dreb/coding-agent",
-	"version": "2.34.1",
+	"version": "2.34.3",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"drebConfig": {