@dreb/coding-agent 2.16.0 → 2.17.0

package/docs/extensions.md

@@ -569,7 +569,7 @@ In the default parallel tool execution mode, sibling tool calls from the same as
 import { isToolCallEventType } from "@dreb/coding-agent";
 
 dreb.on("tool_call", async (event, ctx) => {
-  // event.toolName - "bash", "read", "write", "edit", "grep", "find", "ls", "web_search", "web_fetch", "subagent", "search", "skill", "tasks_update", or custom tool names
+  // event.toolName - "bash", "read", "write", "edit", "grep", "find", "ls", "web_search", "web_fetch", "subagent", "search", "skill", "tasks_update", "suggest_next", or custom tool names
   // event.toolCallId
   // event.input - tool parameters
 
@@ -1474,7 +1474,7 @@ async execute(toolCallId, params) {
 
 ### Overriding Built-in Tools
 
-Extensions can override built-in tools (`read`, `bash`, `edit`, `write`, `grep`, `find`, `ls`, `web_search`, `web_fetch`, `subagent`, `search`) by registering a tool with the same name. Interactive mode displays a warning when this happens. The factory-only tools (`skill`, `tasks_update`) can also be overridden.
+Extensions can override built-in tools (`read`, `bash`, `edit`, `write`, `grep`, `find`, `ls`, `web_search`, `web_fetch`, `subagent`, `search`) by registering a tool with the same name. Interactive mode displays a warning when this happens. The factory-only tools (`skill`, `tasks_update`, `suggest_next`) can also be overridden.
 
 ```bash
 # Extension's read tool replaces built-in read

package/docs/json.md

@@ -19,7 +19,8 @@ type AgentSessionEvent =
   | { type: "auto_retry_end"; success: boolean; attempt: number; finalError?: string }
   | { type: "background_agent_start"; agentId: string; agentType: string; taskSummary: string }
   | { type: "background_agent_end"; agentId: string; agentType: string; success: boolean }
-  | { type: "tasks_update"; tasks: readonly SessionTask[] };
+  | { type: "tasks_update"; tasks: readonly SessionTask[] }
+  | { type: "suggest_next"; command: string };
 
 // SessionTask shape:
 interface SessionTask {

package/docs/rpc.md

@@ -535,6 +535,36 @@ Response:
 
 `contextUsage` is omitted when no model or context window is available. `contextUsage.tokens` and `contextUsage.percent` are `null` immediately after compaction until a fresh post-compaction assistant response provides valid usage data.
 
+#### get_performance_stats
+
+Get rolling performance statistics (tokens-per-second) for all models with recorded data.
+
+```json
+{"type": "get_performance_stats"}
+```
+
+Response:
+```json
+{
+  "type": "response",
+  "command": "get_performance_stats",
+  "success": true,
+  "data": {
+    "models": [
+      {
+        "provider": "anthropic",
+        "modelId": "claude-sonnet-4",
+        "median": 31,
+        "mean": 32,
+        "count": 100
+      }
+    ]
+  }
+}
+```
+
+`models` contains per-model rolling averages computed from the agent's performance log. Each entry includes the median TPS, mean TPS, and number of recorded turns for that model. Returns an empty `models` array when no performance data has been recorded.
+
 #### export_html
 
 Export session to an HTML file.

package/docs/session.md

@@ -416,3 +416,27 @@ Key methods for working with sessions programmatically.
 - `getSessionId()` - Session UUID
 - `getSessionFile()` - Session file path (undefined for in-memory)
 - `isPersisted()` - Whether session is saved to disk
+
+---
+
+## Performance Log
+
+Assistant response performance is recorded to a JSONL file for rolling TPS statistics:
+
+```
+~/.dreb/agent/performance.jsonl
+```
+
+Each line is a JSON object with the following fields:
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `timestamp` | ISO string | When the response completed |
+| `sessionId` | string | Session that produced the response |
+| `provider` | string | Model provider (e.g. `anthropic`) |
+| `modelId` | string | Model identifier (e.g. `claude-sonnet-4`) |
+| `outputTokens` | number | Output tokens from the response |
+| `durationMs` | number | Response duration in milliseconds |
+| `tps` | number | Computed tokens per second (`outputTokens * 1000 / durationMs`) |
+
+Entries are written atomically with file locking for safe concurrent access. The log is pruned daily, removing entries older than 30 days. Responses with `stopReason` of `error` or `aborted`, zero output tokens, or durations under 10ms are not recorded.

package/docs/tui.md

@@ -765,6 +765,14 @@ ctx.ui.setWidget("my-widget", undefined);
 
 **Examples:** [plan-mode.ts](../examples/extensions/plan-mode.ts)
 
+### Built-in Footer
+
+The default footer shows three lines (when space allows):
+
+1. **Path** — Current working directory (with `~` for home), git branch in parentheses, and session name if set. Dimmed.
+2. **Stats** — Cumulative token usage (↑input ↓output Rread Wwrite), cost (with daily total when cross-session), and context-window percentage (colored red above 90%, yellow above 70%). When a model is selected and enough turns have been recorded, a rolling TPS suffix appears: `~31 tok/s [100] · 10% ↑ median [10000]`. The recent median (last 10 turns) is compared against the long-term baseline (last 10,000 turns). Dimmed.
+3. **Extension statuses** — Alphabetical list of persistent status texts set by extensions via `ctx.ui.setStatus()`.
+
 ### Pattern 6: Custom Footer
 
 Replace the footer. `footerData` exposes data not otherwise accessible to extensions.

package/package.json

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