Exact Changes to Tool Descriptions

execute_command

OLD:

Execute a shell command inside the container and return output.

NEW:

Run commands with minimal output. Use sparingly and inspect only what is needed. Prefer precise paths, targeted filters (grep, grep -m, sed -n), and bounded output (head, tail, find with limits). Combine related checks concisely. Never dump entire large files, directories, logs, dependency trees, or recursive listings unless explicitly necessary. Avoid verbose flags and redundant output.

read_file

OLD:

Read an inclusive line range from a UTF-8 text file.

Line numbers are 1-based. If end_line is omitted, read through EOF.

NEW:

Read only the smallest useful line range. Lines are 1-based. Prefer bounded start_line/end_line ranges and avoid reading to EOF for large files unless necessary. If the relevant location is unknown, locate it first with a targeted search, then read only the surrounding lines.

write_file

No changes (output tool, not inspection).


Response Format

Preserved compact behavior:

return result.result ?? "";

No additional metadata, wrappers, or truncation added.


Files Modified

  • server.js (lines 75-76, 91-92)
  • deno-server.js (lines 74, 89-90)

Both implementations now have identical token-optimization guidance.