Актуализация схем инструментов для LLM: новые возможности в описаниях

CodeRefactorTool:
- Добавлено описание CHANGE_SIGNATURE с примером params
- Добавлена секция BATCH INTEGRATION с affectedFiles и токенами
- Добавлен inputSchema для params (change_signature): name, type, action, newName, defaultValue

FileManageTool:
- Уточнено описание PATH ALIASING для move/rename
- Пример транзитивной цепочки: A.java -> B.java -> C.java

BatchToolsTool:
- Добавлена секция REFACTOR INTEGRATION с примерами интерполяции
- {{ref.affectedFiles[0].accessToken}}, {{ref.affectedFiles[0].path}}, {{ref.token}}
- Обновлён пример: refactor + edit chain
- Добавлено упоминание Virtual FS Context для refactor

Author: Nefrols

app/src/main/java/ru/nts/tools/mcp/tools/fs/FileManageTool.java

@@ -59,7 +59,8 @@ public String getDescription() {
 
             TOKEN BEHAVIOR:
             - create: Returns access token for immediate editing (no read needed!)
-            - move/rename: Tokens automatically transferred to new path
+            - move/rename: Tokens transferred via PATH ALIASING - even chains work!
+              Example: A.java -> B.java -> C.java - token from A.java still valid for C.java
             - delete: All tokens for the file are invalidated
 
             SAFETY:

app/src/main/java/ru/nts/tools/mcp/tools/refactoring/CodeRefactorTool.java

@@ -65,12 +65,21 @@ public String getDescription() {
                   path + symbol + newName [+ kind] [+ scope]
                   scope: file|directory|project (default: project)
 
+                CHANGE_SIGNATURE:
+                  path + symbol (method) + params: [{name, type, action: add|remove|rename|retype|reorder}]
+                  Automatically updates ALL call sites across the project!
+
                 GENERATE:
                   path + symbol (class name) + what (accessors|constructor|builder|toString)
 
                 LANGUAGES: Java, Kotlin, JS/TS/TSX, Python, Go, Rust, C/C++, C#, PHP, HTML
 
-                OTHER: delete, wrap, extract_method, inline, change_signature, move, batch
+                OTHER: delete, wrap, extract_method, inline, move, batch
+
+                BATCH INTEGRATION:
+                Returns 'affectedFiles' array with access tokens for each modified file.
+                Use in nts_batch_tools: {{step.affectedFiles[0].accessToken}} or {{step.token}} (single file shortcut).
+                Enables chains like: refactor -> edit without re-reading files!
                 """;
     }
 
@@ -215,6 +224,27 @@ public JsonNode getInputSchema() {
         options.put("type", "object");
         options.put("description", "Additional options specific to operation");
 
+        // params (for change_signature)
+        ObjectNode csParams = properties.putObject("params");
+        csParams.put("type", "array");
+        ObjectNode csItem = csParams.putObject("items");
+        csItem.put("type", "object");
+        ObjectNode csItemProps = csItem.putObject("properties");
+        csItemProps.putObject("name").put("type", "string").put("description", "Parameter name");
+        csItemProps.putObject("type").put("type", "string").put("description", "Parameter type (for add/retype)");
+        csItemProps.putObject("newName").put("type", "string").put("description", "New name (for rename)");
+        csItemProps.putObject("defaultValue").put("type", "string").put("description", "Default value for new parameter");
+        ObjectNode csAction = csItemProps.putObject("action");
+        csAction.put("type", "string");
+        ArrayNode csActionEnum = csAction.putArray("enum");
+        csActionEnum.add("add");
+        csActionEnum.add("remove");
+        csActionEnum.add("rename");
+        csActionEnum.add("retype");
+        csActionEnum.add("reorder");
+        csAction.put("description", "What to do with parameter");
+        csParams.put("description", "[change_signature] Parameter modifications: add, remove, rename, retype, reorder");
+
         // operations (for batch)
         ObjectNode operations = properties.putObject("operations");
         operations.put("type", "array");

app/src/main/java/ru/nts/tools/mcp/tools/system/BatchToolsTool.java

@@ -71,12 +71,18 @@ public String getDescription() {
             - All-or-nothing: If ANY action fails -> ALL rolled back
             - Session Tokens: CRC check skipped within batch (no re-read needed)
             - InfinityRange: Files created in batch have no line boundary checks
+            - Virtual FS Context: nts_code_refactor sees in-memory edits from previous steps
 
             VARIABLE INTERPOLATION (token & path passing):
-            - {{step1.token}}  - First LAT token from step 1
-            - {{step1.tokens}} - All tokens comma-separated
-            - {{myId.token}}   - Reference by action 'id'
-            - {{myId.path}}    - Current file path (auto-updates after rename/move!)
+            - {{step1.token}}   - First LAT token from step 1
+            - {{step1.tokens}}  - All tokens comma-separated
+            - {{myId.token}}    - Reference by action 'id'
+            - {{myId.path}}     - Current file path (auto-updates after rename/move!)
+
+            REFACTOR INTEGRATION (nts_code_refactor returns affectedFiles):
+            - {{ref.affectedFiles[0].accessToken}} - Token for first affected file
+            - {{ref.affectedFiles[0].path}}        - Path of first affected file
+            - {{ref.token}}                         - Shortcut when single file affected
 
             SESSION REFERENCES (path tracking after rename/move):
             Use {{id.path}} to reference a file that was renamed/moved:
@@ -86,17 +92,16 @@ SESSION REFERENCES (path tracking after rename/move):
               {tool: 'nts_edit_file', params: {path: '{{f.path}}', ...}}  // <- auto-resolves to 'New.java'!
             ]
 
-            SMART LINE ADDRESSING (Virtual FS Context):
+            SMART LINE ADDRESSING:
             For startLine/endLine, use special values that auto-calculate:
             - $LAST           - Last line of the file
             - $PREV_END       - End line of previous edit on this file
             - $PREV_END+N     - N lines after previous edit (e.g., $PREV_END+1)
 
-            EXAMPLE (create + rename + edit):
+            EXAMPLE (refactor + edit chain):
             actions: [
-              {id: 'svc', tool: 'nts_file_manage', params: {action: 'create', path: 'Service.java', content: 'class Service {}'}},
-              {tool: 'nts_file_manage', params: {action: 'rename', path: '{{svc.path}}', newName: 'UserService.java'}},
-              {tool: 'nts_edit_file', params: {path: '{{svc.path}}', startLine: 1, content: 'class UserService {}', accessToken: '{{svc.token}}'}}
+              {id: 'ref', tool: 'nts_code_refactor', params: {action: 'rename', path: 'User.java', symbol: 'getName', newName: 'getFullName'}},
+              {tool: 'nts_edit_file', params: {path: '{{ref.affectedFiles[0].path}}', startLine: 1, operation: 'insert_after', content: '// Renamed method', accessToken: '{{ref.affectedFiles[0].accessToken}}'}}
             ]
 
             LIMITATION: Only NTS MCP tools tracked in rollback.