Update insert_content tool description for clarity and detail (#2892)

Author: hannesrudolph

src/core/prompts/__tests__/__snapshots__/system.test.ts.snap

@@ -180,7 +180,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path
@@ -647,7 +647,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path
@@ -1114,7 +1114,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path
@@ -1581,7 +1581,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path
@@ -2104,7 +2104,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path
@@ -2639,7 +2639,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path
@@ -3252,7 +3252,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path
@@ -3719,7 +3719,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path
@@ -4228,7 +4228,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path
@@ -4772,7 +4772,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path
@@ -5605,7 +5605,7 @@ Example: Requesting to write to frontend-config.json
 </write_to_file>
 
 ## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory /test/path

src/core/prompts/tools/insert-content.ts

@@ -2,7 +2,7 @@ import { ToolArgs } from "./types"
 
 export function getInsertContentDescription(args: ToolArgs): string {
 	return `## insert_content
-Description: Insert new content at a specific line position in a file.
+Description: Use this tool specifically for adding new lines of content into a file without modifying existing content. Specify the line number to insert before, or use line 0 to append to the end. Ideal for adding imports, functions, configuration blocks, log entries, or any multi-line text block.
 
 Parameters:
 - path: (required) File path relative to workspace directory ${args.cwd.toPosix()}