From c9ca0835ae1dfbd517b5226342dab73ab9c265e8 Mon Sep 17 00:00:00 2001
From: xj <gh-xj@users.noreply.github.com>
Date: Sun, 22 Feb 2026 02:21:18 -0800
Subject: [PATCH] docs(hooks): clarify BeforeToolCallEvent args non-nil
 contract

---
 pkg/hooks/types.go | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pkg/hooks/types.go b/pkg/hooks/types.go
index 7fd8bcc52..4a0f6697d 100644
--- a/pkg/hooks/types.go
+++ b/pkg/hooks/types.go
@@ -37,7 +37,7 @@ type MessageSendingEvent struct {
 // Handlers can modify Args, or set Cancel to block execution.
 type BeforeToolCallEvent struct {
 	ToolName     string
-	Args         map[string]any // Modifiable
+	Args         map[string]any // Modifiable; guaranteed non-nil when triggered via AgentLoop.
 	Channel      string
 	ChatID       string
 	Cancel       bool