From eb5145c5d14605d511f060428396841a237f8f7c Mon Sep 17 00:00:00 2001
From: Peter Steinberger <steipete@gmail.com>
Date: Tue, 20 Jan 2026 09:05:24 +0000
Subject: [PATCH] docs: mention tool_result_persist hook

---
 docs/hooks.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/hooks.md b/docs/hooks.md
index fa1780ec0..9870dda88 100644
--- a/docs/hooks.md
+++ b/docs/hooks.md
@@ -235,6 +235,12 @@ Triggered when the gateway starts:
 
 - **`gateway:startup`**: After channels start and hooks are loaded
 
+### Tool Result Hooks (Plugin API)
+
+These hooks are not event-stream listeners; they let plugins synchronously adjust tool results before Clawdbot persists them.
+
+- **`tool_result_persist`**: transform tool results before they are written to the session transcript. Must be synchronous; return the updated tool result payload or `undefined` to keep it as-is. See [Agent Loop](/concepts/agent-loop).
+
 ### Future Events
 
 Planned event types: