@dreb/coding-agent 2.25.4 → 2.27.3

package/CHANGELOG.md

@@ -42,6 +42,8 @@
 
 ### Fixed
 
+- Fixed ESC doing nothing during `stream_retry` / `length_retry` backoff. The old handlers stopped the working spinner (`loadingAnimation`) and swapped in a dedicated retry spinner that had no ESC wiring, so the default ESC handler's `if (this.loadingAnimation)` guard fell through to a no-op. The fix removes the retry spinner entirely, keeps the working spinner running throughout the retry, and surfaces retry feedback as a persistent warning in the chat scrollback instead. ESC now aborts via the pre-existing spinner-abort path — identical to cancelling normal generation. ([#262](https://github.com/aebrer/dreb/issues/262))
+
 - Fixed `/buddy off` not persisting across sessions — the buddy reappeared in the TUI on restart. The `hidden` flag was persisted correctly, but the startup auto-mount ignored it. The startup mount is now gated on the persisted `hidden` flag (extracted into `mountExistingBuddyIfVisible()`); a hidden buddy stays loaded but unmounted until you run `/buddy` to bring it back. ([#243](https://github.com/aebrer/dreb/issues/243))
 
 - Fixed subagents silently returning empty results when a child's final response was truncated at the model's token limit. The subagent spawn handler now inspects the last assistant message's `stopReason`: a clean exit with no output now surfaces a descriptive error (truncation, loud truncation failure, or "completed with no output") instead of a silent empty string, and a clean exit with partial output now flags the truncation via `errorMessage` while preserving the partial text — covering both raw `length` truncation and the loud `error` stopReason produced when the core agent loop exhausts its length retries. The parent renders these errors even on a clean (exit code 0) exit. ([#240](https://github.com/aebrer/dreb/issues/240))

package/README.md

@@ -43,6 +43,22 @@ What you get in exchange: a skill system, an extension API, custom agent definit
 
 ## Quick Start
 
+> **Node.js 22 LTS is required.** dreb relies on SSE streaming behavior that is stable in Node 22 LTS. Node 24 and Node 26 are known to break provider streaming due to changes in ReadableStream buffering, which causes every provider to fail with **"request ended without sending any chunks"**. If you see that error, switch to Node 22 LTS.
+
+### Building from source (recommended)
+
+```bash
+git clone https://github.com/aebrer/dreb.git
+cd dreb
+npm install
+npm run build
+npm link -w packages/coding-agent
+```
+
+---
+
+### Installing from npm
+
 ```bash
 npm install -g @dreb/coding-agent
 ```
@@ -71,17 +87,9 @@ Then just talk to dreb. All 11 built-in tools are enabled by default: `read`, `w
 
 **Bun users:** Bun's lockfile can cache stale `@dreb/*` versions after upgrades, causing missing-export errors. Fix with `bun pm cache rm && bunx --force dreb`.
 
----
+### Troubleshooting
 
-### Building from source
-
-```bash
-git clone https://github.com/aebrer/dreb.git
-cd dreb
-npm install
-npm run build
-npm link -w packages/coding-agent
-```
+- **"request ended without sending any chunks" on every provider** — Your Node version is likely too new. Switch to **Node.js 22 LTS**. Node 26 in particular changed ReadableStream buffering in a way that breaks the Anthropic and OpenAI SDK stream parsers dreb uses.
 
 ---
 
@@ -361,6 +369,8 @@ The `subagent` tool delegates tasks to independent child agent processes. Each s
 
 **Per-agent model overrides:** The model used by each agent type can be overridden via the `agentModels.models` setting (a map of agent name → ordered fallback list) without copying or editing the agent definition `.md` files. Configure it in `settings.json` or via `/settings` → **Agent Models**. Resolution order: per-invocation `model` override → `agentModels` setting → agent definition `model` → parent session model. See [docs/agent-models.md](docs/agent-models.md).
 
+**Model identity in system prompt:** The parent session's running model is exposed in its own system prompt as `You are running on: provider/id`. This lets the model make self-aware routing decisions (e.g. delegate vision tasks to a multimodal subagent, or use a differently-architected model as a critic). The line updates automatically on mid-session model switches.
+
 **Session metadata:** Each child process records its agent type in the session JSONL header (`agentType` field), providing an audit trail of which agent definition executed the work.
 
 ---