From ba4e0c977606cdb0786fca24a28fe87de8077d8f Mon Sep 17 00:00:00 2001 From: rgrant Date: Sun, 28 Jun 2026 16:25:43 +0000 Subject: [PATCH] chore: Warn `fs_read_file` output is not visible to the user MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Added a note to the `fs_read_file` tool's summary and description clarifying that users do not see the tool's output — only that the tool was called. The guidance directs the model to write its own quotation block when it needs to surface file contents, and includes a concrete counter-example showing what the wrong behavior looks like. Signed-off-by: rgrant --- .jp/mcp/tools/fs/read_file.toml | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/.jp/mcp/tools/fs/read_file.toml b/.jp/mcp/tools/fs/read_file.toml index f2275e85..9b9e5075 100644 --- a/.jp/mcp/tools/fs/read_file.toml +++ b/.jp/mcp/tools/fs/read_file.toml @@ -3,7 +3,11 @@ enable = false run = "unattended" source = "local" command = "just serve-tools {{context}} {{tool}}" -summary = "Read the contents of a file in the project's local filesystem." +summary = """ +Read the contents of a file in the project's local filesystem. Do not use it to +show file contents to the user; they will not see the result. Call +`describe_tools` for examples. +""" description = """ You can use `fs_grep_files` to search for specific patterns in the file contents, before reading the entire contents of a specific file using this tool. @@ -19,6 +23,14 @@ Read a specific line range: ```json {"path": "crates/jp_llm/src/tool.rs", "start_line": 100, "end_line": 150} ``` + +Do NOT use this tool to show file contents to the user. They only see that the +tool was called, not its output. To show file contents, write your own +quotation block. For example, this shows the user nothing: + +> I can see the culprit. In .jp/config.toml the tool is defined as: +> +> Calling tool fs_read_file(path: ".jp/config.toml", start_line: 240, end_line: 246) """ [conversation.tools.fs_read_file.style]