feat: add HIDE_TOOL_FILE_MESSAGES env var to suppress file edit documents (grinev#82)

- Add HIDE_TOOL_FILE_MESSAGES configuration option
- When set to true, hides file edit documents sent as .txt attachments
- Apply upstream commit 6009873

Author: Yingwen Luo

.env.example

@@ -70,6 +70,9 @@ OPENCODE_MODEL_ID=claude-opus-4.6
 # Hide tool call service messages (default: false)
 # HIDE_TOOL_CALL_MESSAGES=false
 
+# Hide tool file edit documents sent as .txt attachments (default: false)
+# HIDE_TOOL_FILE_MESSAGES=false
+
 # Assistant message formatting mode (default: markdown)
 # markdown = convert assistant replies to Telegram MarkdownV2
 # raw = show assistant replies as plain text

README.md

@@ -333,6 +333,7 @@ When installed via npm, the configuration wizard handles the initial setup. The
 | `SERVICE_MESSAGES_INTERVAL_SEC` | Service messages interval (thinking + tool calls); `>=2` to avoid rate limits, `0` = immediate |    No    | `5`                      |
 | `HIDE_THINKING_MESSAGES`        | Hide `💭 Thinking...` service messages                                                         |    No    | `false`                  |
 | `HIDE_TOOL_CALL_MESSAGES`       | Hide tool-call service messages (`💻 bash ...`, `📖 read ...`, etc.)                           |    No    | `false`                  |
+| `HIDE_TOOL_FILE_MESSAGES`       | Hide file edit documents sent as `.txt` attachments (`edit_*.txt`, `write_*.txt`)              |    No    | `false`                  |
 | `RESPONSE_STREAMING`            | Stream assistant replies while generated                                                       |    No    | `true`                   |
 | `RESPONSE_STREAM_THROTTLE_MS`   | Stream edit throttle (ms) for updates                                                          |    No    | `500`                    |
 | `MESSAGE_FORMAT_MODE`           | Assistant reply formatting: `markdown` (Telegram MarkdownV2) or `raw`                          |    No    | `markdown`               |

src/bot/index.ts

@@ -575,6 +575,10 @@ async function ensureEventSubscription(directory: string): Promise<void> {
       return;
     }
 
+    if (config.bot.hideToolFileMessages) {
+      return;
+    }
+
     try {
       await toolCallStreamer.breakSession(fileInfo.sessionId, "tool_file_boundary");
 

src/config.ts

@@ -103,6 +103,7 @@ export const config = {
     locale: getOptionalLocaleEnvVar("BOT_LOCALE", "en"),
     hideThinkingMessages: getOptionalBooleanEnvVar("HIDE_THINKING_MESSAGES", false),
     hideToolCallMessages: getOptionalBooleanEnvVar("HIDE_TOOL_CALL_MESSAGES", false),
+    hideToolFileMessages: getOptionalBooleanEnvVar("HIDE_TOOL_FILE_MESSAGES", false),
     messageFormatMode: getOptionalMessageFormatModeEnvVar("MESSAGE_FORMAT_MODE", "markdown"),
   },
   files: {

tests/config.test.ts

@@ -17,41 +17,49 @@ describe("config boolean env parsing", () => {
   it("uses false defaults for hide service message flags", async () => {
     vi.stubEnv("HIDE_THINKING_MESSAGES", "");
     vi.stubEnv("HIDE_TOOL_CALL_MESSAGES", "");
+    vi.stubEnv("HIDE_TOOL_FILE_MESSAGES", "");
 
     const config = await loadConfig();
 
     expect(config.bot.hideThinkingMessages).toBe(false);
     expect(config.bot.hideToolCallMessages).toBe(false);
+    expect(config.bot.hideToolFileMessages).toBe(false);
   });
 
   it("parses truthy values for hide service message flags", async () => {
     vi.stubEnv("HIDE_THINKING_MESSAGES", "YES");
     vi.stubEnv("HIDE_TOOL_CALL_MESSAGES", "1");
+    vi.stubEnv("HIDE_TOOL_FILE_MESSAGES", "true");
 
     const config = await loadConfig();
 
     expect(config.bot.hideThinkingMessages).toBe(true);
     expect(config.bot.hideToolCallMessages).toBe(true);
+    expect(config.bot.hideToolFileMessages).toBe(true);
   });
 
   it("parses falsy values for hide service message flags", async () => {
     vi.stubEnv("HIDE_THINKING_MESSAGES", "off");
     vi.stubEnv("HIDE_TOOL_CALL_MESSAGES", "0");
+    vi.stubEnv("HIDE_TOOL_FILE_MESSAGES", "false");
 
     const config = await loadConfig();
 
     expect(config.bot.hideThinkingMessages).toBe(false);
     expect(config.bot.hideToolCallMessages).toBe(false);
+    expect(config.bot.hideToolFileMessages).toBe(false);
   });
 
   it("falls back to defaults on invalid values", async () => {
     vi.stubEnv("HIDE_THINKING_MESSAGES", "banana");
     vi.stubEnv("HIDE_TOOL_CALL_MESSAGES", "nope");
+    vi.stubEnv("HIDE_TOOL_FILE_MESSAGES", "invalid");
 
     const config = await loadConfig();
 
     expect(config.bot.hideThinkingMessages).toBe(false);
     expect(config.bot.hideToolCallMessages).toBe(false);
+    expect(config.bot.hideToolFileMessages).toBe(false);
   });
 
   it("uses markdown as default message format mode", async () => {