Feat(channels): unify animated tool feedback across chat channels and Pico (#2622)

* feat(channels): unify tool feedback animation across discord telegram and feishu

* fix(tool-feedback): unify fallback and single-message delivery

* fix(channels): finalize tool feedback in place

* fix ci

* feat: improve tool feedback

* fix review blockers in pico token cache and tool feedback

fix(provider): preserve function thought signatures

fix(feishu): recover tool feedback after edit fallback

* * delete dead code

* fix(pico): clean up tool feedback progress state

* fix ci

* fix(web): preserve tool feedback line breaks in chat

* fix(channels): preserve tool feedback progress state

fix(pico): preserve context usage when finalizing tool feedback

chore: record branch review pass

fix: preserve tool feedback finalization state

fix(web): handle pico history update fallback

* fix ci

pkg/utils/tool_feedback.go

@@ -1,9 +1,57 @@
 package utils
 
-import "fmt"
+import (
+	"fmt"
+	"strings"
+)
 
-// FormatToolFeedbackMessage renders the tool name and arguments preview in the
-// same markdown shape used by live tool feedback and session reconstruction.
-func FormatToolFeedbackMessage(toolName, argsPreview string) string {
-	return fmt.Sprintf("\U0001f527 `%s`\n```\n%s\n```", toolName, argsPreview)
+const ToolFeedbackContinuationHint = "Continuing the current task."
+
+// FormatToolFeedbackMessage renders the model-provided explanation for why a
+// tool is being executed. When the model does not provide one, it keeps only
+// the tool line and does not expose raw arguments or fallback text.
+func FormatToolFeedbackMessage(toolName, explanation string) string {
+	toolName = strings.TrimSpace(toolName)
+	explanation = strings.TrimSpace(explanation)
+
+	if toolName == "" {
+		return explanation
+	}
+	if explanation == "" {
+		return fmt.Sprintf("\U0001f527 `%s`", toolName)
+	}
+
+	return fmt.Sprintf("\U0001f527 `%s`\n%s", toolName, explanation)
+}
+
+// FitToolFeedbackMessage keeps tool feedback within a single outbound message.
+// It preserves the first line when possible and truncates the explanation body
+// instead of letting the message be split into multiple chunks.
+func FitToolFeedbackMessage(content string, maxLen int) string {
+	content = strings.TrimSpace(content)
+	if content == "" || maxLen <= 0 {
+		return ""
+	}
+	if len([]rune(content)) <= maxLen {
+		return content
+	}
+
+	firstLine, rest, hasRest := strings.Cut(content, "\n")
+	firstLine = strings.TrimSpace(firstLine)
+	rest = strings.TrimSpace(rest)
+
+	if !hasRest || rest == "" {
+		return Truncate(firstLine, maxLen)
+	}
+
+	if len([]rune(firstLine)) >= maxLen {
+		return Truncate(firstLine, maxLen)
+	}
+
+	remaining := maxLen - len([]rune(firstLine)) - 1
+	if remaining <= 0 {
+		return Truncate(firstLine, maxLen)
+	}
+
+	return firstLine + "\n" + Truncate(rest, remaining)
 }

pkg/utils/tool_feedback_test.go

@@ -3,9 +3,47 @@ package utils
 import "testing"
 
 func TestFormatToolFeedbackMessage(t *testing.T) {
-	got := FormatToolFeedbackMessage("read_file", "{\"path\":\"README.md\"}")
-	want := "\U0001f527 `read_file`\n```\n{\"path\":\"README.md\"}\n```"
+	got := FormatToolFeedbackMessage(
+		"read_file",
+		"I will read README.md first to confirm the current project structure.",
+	)
+	want := "\U0001f527 `read_file`\nI will read README.md first to confirm the current project structure."
 	if got != want {
 		t.Fatalf("FormatToolFeedbackMessage() = %q, want %q", got, want)
 	}
 }
+
+func TestFormatToolFeedbackMessage_EmptyExplanationKeepsOnlyToolLine(t *testing.T) {
+	got := FormatToolFeedbackMessage("read_file", "")
+	want := "\U0001f527 `read_file`"
+	if got != want {
+		t.Fatalf("FormatToolFeedbackMessage() = %q, want %q", got, want)
+	}
+}
+
+func TestFormatToolFeedbackMessage_EmptyToolNameOmitsToolLine(t *testing.T) {
+	got := FormatToolFeedbackMessage("", "Continue drafting the final response.")
+	want := "Continue drafting the final response."
+	if got != want {
+		t.Fatalf("FormatToolFeedbackMessage() = %q, want %q", got, want)
+	}
+}
+
+func TestFitToolFeedbackMessage_TruncatesBodyWithinSingleMessage(t *testing.T) {
+	got := FitToolFeedbackMessage(
+		"\U0001f527 `read_file`\nRead README.md first to confirm the current project structure.",
+		40,
+	)
+	want := "\U0001f527 `read_file`\nRead README.md first to..."
+	if got != want {
+		t.Fatalf("FitToolFeedbackMessage() = %q, want %q", got, want)
+	}
+}
+
+func TestFitToolFeedbackMessage_TruncatesSingleLineMessage(t *testing.T) {
+	got := FitToolFeedbackMessage("\U0001f527 `read_file`", 10)
+	want := "\U0001f527 `read..."
+	if got != want {
+		t.Fatalf("FitToolFeedbackMessage() = %q, want %q", got, want)
+	}
+}