@dreb/coding-agent 2.32.1 → 2.33.0

package/docs/settings.md

@@ -175,6 +175,26 @@ When a provider requests a retry delay longer than `maxDelayMs` (e.g., Google's
 }
 ```
 
+### Background Agents
+
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| `backgroundAgents.parentTurnGuardrail` | boolean | `true` | Pause the parent agent after `parentTurnLimit` turns while background subagents are still running |
+| `backgroundAgents.parentTurnLimit` | number | `3` | Parent turns allowed while background agents run before pausing |
+
+When you launch background subagents, the parent agent keeps working and returns control to you while subagents run. The guardrail pauses the parent after `parentTurnLimit` turns so it doesn't spin ahead of results — when this happens, dreb surfaces a friendly, non-error notification in the TUI and Telegram explaining that background agents are still working and the parent paused intentionally (it resumes when they report back, or you can send a message to steer it).
+
+Set `parentTurnGuardrail` to `false` to let the parent keep running with no turn limit while subagents work — an advanced opt-out with no upper bound on parent turns. Raise `parentTurnLimit` to relax the guardrail without fully disabling it.
+
+```json
+{
+  "backgroundAgents": {
+    "parentTurnGuardrail": true,
+    "parentTurnLimit": 3
+  }
+}
+```
+
 ### Message Delivery
 
 | Setting | Type | Default | Description |

package/package.json

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