docs: finalize next release docs

2 files changed, 14 insertions, 7 deletions

diff --git a/docs/next/CHANGELOG.md b/docs/next/CHANGELOG.md
index 32148d7b..e3435397 100644
--- a/docs/next/CHANGELOG.md
+++ b/docs/next/CHANGELOG.md
@@ -3,17 +3,25 @@
 ## Unreleased
 
 ### Added
-- Added `ui.prompt_new_tab_name = false` for creating new tabs immediately with generated names instead of opening the rename dialog.
-- Added optional `keys.edit_scrollback` to open the focused pane's retained scrollback in `$EDITOR` inside a temporary zoomed pane.
+- Added indexed keybind families under `[keys.indexed]` for jumping directly to workspace, tab, or visible agent positions 1-9.
+- Added hook-owned custom agent status labels, so integrations can show short visual states like `indexing` without changing semantic agent status.
+- Added terminal-backed agent commands and socket API methods for listing, reading, sending to, renaming, focusing, waiting on, attaching to, and starting agent terminals.
+- Added direct terminal attach with `herdr agent attach <target>` and `herdr terminal attach <terminal_id>`.
+- Added `ui.prompt_new_tab_name = false` for creating new tabs immediately with generated names instead of opening the rename dialog. (#123)
+- Added optional `keys.edit_scrollback` to open the focused pane's retained scrollback in `$EDITOR` inside a temporary zoomed pane. (#122)
 
 ### Changed
 - Renamed the focused pane fullscreen keybinding to `keys.zoom`; `keys.fullscreen` remains supported as a legacy alias.
 
 ### Fixed
 - Grok Build is now detected as `grok`, with basic working, blocked, and idle state detection. Conflicting known-agent hook labels are ignored once native foreground-process detection identifies a different known agent. (#133)
-- GitHub Copilot is now correctly detected when its process name is `copilot`.
-- Integration installs now respect `PI_CODING_AGENT_DIR`, `CLAUDE_CONFIG_DIR`, and `CODEX_HOME` when choosing Pi, Claude Code, and Codex config paths.
-- Split pane resize hit areas no longer overlap the first content column or row, making text selection work from the start of right and bottom panes.
+- Terminal cursor shapes now forward through attached clients. (#116)
+- Herdr now redraws immediately when the outer terminal regains focus.
+- GitHub Copilot is now correctly detected when its process name is `copilot`. (#118)
+- Integration installs now respect `PI_CODING_AGENT_DIR`, `CLAUDE_CONFIG_DIR`, and `CODEX_HOME` when choosing Pi, Claude Code, and Codex config paths. (#121)
+- Split pane resize hit areas no longer overlap the first content column or row, making text selection work from the start of right and bottom panes. (#120)
+- Dragging text selections near pane edges now autoscrolls into scrollback, and selection state now clears correctly when switching workspaces, tabs, or panes. (#128, #129, thanks @leeeanh)
+- Zoomed panes now keep their border visible in tabs that contain multiple panes. (#115)
 
 ## [0.5.9] - 2026-05-15
 
diff --git a/docs/next/SOCKET_API.md b/docs/next/SOCKET_API.md
index e639940e..7ffb276e 100644
--- a/docs/next/SOCKET_API.md
+++ b/docs/next/SOCKET_API.md
@@ -166,7 +166,6 @@ for backward compatibility, requests also accept the older positional forms like
   "name": "reviewer",
   "agent": "pi",
   "agent_status": "working",
-  "custom_status": "indexing",
   "workspace_id": "w64e95948145ed1",
   "tab_id": "w64e95948145ed1:1",
   "pane_id": "w64e95948145ed1-1",
@@ -184,7 +183,7 @@ for backward compatibility, requests also accept the older positional forms like
 - when a hook or plugin reports a custom agent through `pane.report_agent`, this can be any non-empty label like `hermes`
 - when no agent identity is known, it is omitted
 
-`custom_status` is an optional hook-owned display label. It is present only while hook authority is active. It does not change `agent_status`, `done` semantics, waits, notifications, or workspace/tab rollup priority.
+`custom_status` on `pane_info` and agent-status events is an optional hook-owned display label. It is present only while hook authority is active. It does not change `agent_status`, `done` semantics, waits, notifications, or workspace/tab rollup priority.
 
 `pane_read` responses contain objects like: