perf: add read_file tool to drastically reduce token bloat for general chat context

Author: REACH-ARC

src/main/java/com/secai/ai/ToolExecutor.java

@@ -112,4 +112,18 @@ public static String webSearch(String query) {
             return "Web search failed: " + e.getMessage();
         }
     }
+
+    public static String readFile(String targetPath) {
+        Path path = Paths.get(targetPath);
+        if (!Files.exists(path)) {
+            return "Error: File " + targetPath + " does not exist.";
+        }
+        System.out.println("\033[36m[AI reading file: " + targetPath + " ...]\033[0m");
+        try {
+            String content = Files.readString(path);
+            return "File Contents of " + targetPath + ":\n```\n" + content + "\n```";
+        } catch (IOException e) {
+            return "Error reading file: " + e.getMessage();
+        }
+    }
 }

src/main/java/com/secai/cli/ChatCommand.java

@@ -84,6 +84,9 @@ public Integer call() {
                         "3. web_search\n" +
                         "   args: query\n" +
                         "   description: Searches the web.\n" + 
+                        "4. read_file\n" +
+                        "   args: path\n" +
+                        "   description: Reads the contents of a file to gain context.\n" +
                         "Only call ONE tool per response.";
 
                 String context = String.format("The user is asking questions about the following security finding:\n" +
@@ -107,24 +110,8 @@ public Integer call() {
                 StringBuilder contextBuilder = new StringBuilder();
                 contextBuilder.append("The user is asking questions about a recent security scan. The scan found the following issues:\n\n");
                 for (Finding f : findings) {
-                    String fileContent = "";
-                    if (f.getFile() != null && !f.getFile().isEmpty()) {
-                        try {
-                            java.nio.file.Path targetPath = java.nio.file.Paths.get(projectPath, f.getFile());
-                            if (java.nio.file.Files.exists(targetPath)) {
-                                fileContent = java.nio.file.Files.readString(targetPath);
-                            }
-                        } catch (Exception e) {
-                            // ignore
-                        }
-                    }
-                    contextBuilder.append(String.format("- ID %s: %s\n  Severity: %s\n  File: %s\n  Description: %s\n", 
+                    contextBuilder.append(String.format("- ID %s: %s\n  Severity: %s\n  File: %s\n  Description: %s\n\n", 
                             f.getId(), f.getTitle(), f.getSeverity(), f.getFile(), f.getDescription()));
-                    if (!fileContent.isEmpty()) {
-                        contextBuilder.append("  File Contents:\n```\n").append(fileContent).append("\n```\n\n");
-                    } else {
-                        contextBuilder.append("\n");
-                    }
                 }
 
                 String toolInstructions = "\n\nTo call a tool, you MUST use this exact XML format in your response:\n" +
@@ -148,6 +135,9 @@ public Integer call() {
                         "3. web_search\n" +
                         "   args: query\n" +
                         "   description: Searches the web.\n" + 
+                        "4. read_file\n" +
+                        "   args: path\n" +
+                        "   description: Reads the contents of a file to gain context.\n" +
                         "Only call ONE tool per response.";
 
                 contextBuilder.append("IMPORTANT INSTRUCTION: You are acting as an expert Penetration Tester and Security Educator. ");
@@ -213,6 +203,12 @@ public Integer call() {
                         String query = extractXmlTag(argsXml, "query");
 
                         toolResult = com.secai.ai.ToolExecutor.webSearch(query);
+                    } else if ("read_file".equals(toolName)) {
+                        String argsXml = extractXmlTag(toolCallXml, "args");
+                        String path = extractXmlTag(argsXml, "path");
+                        path = java.nio.file.Paths.get(projectPath, path).toString();
+                        
+                        toolResult = com.secai.ai.ToolExecutor.readFile(path);
                     } else {
                         toolResult = "Error: Unknown tool " + toolName;
                     }