download.md

 1Download binary files from URL to local disk.
 2
 3<when_to_use>
 4Use Download when:
 5- Downloading images, PDFs, archives, binaries
 6- Saving files to disk (not just viewing content)
 7- Need the actual file, not just its content
 8
 9Do NOT use Download when:
10- Just reading web content → use `fetch`
11- Need to analyze content → use `agentic_fetch`
12- Downloading text/HTML to view → use `fetch`
13</when_to_use>
14
15<parameters>
16- url: URL to download from (required)
17- file_path: Local path to save file (required)
18- timeout: Seconds to wait (optional, max 600)
19</parameters>
20
21<behavior>
22- Creates parent directories automatically
23- Overwrites existing files without warning
24- Streams large files efficiently
25</behavior>
26
27<limits>
28- Max file size: 100MB
29- HTTP/HTTPS only
30- No authentication or cookies
31</limits>
32
33<example>
34Download an image:
35```
36url: "https://example.com/logo.png"
37file_path: "/project/assets/logo.png"
38```
39</example>