update

src/tools/writeTool.jl

@@ -1,13 +1,12 @@
 """
-Tool that generates new Julia tool module files.
+Tool that writes new Julia tool module files to disk.
 
 The agent can use this tool when it encounters a task that no existing tool
 can handle. Provide the tool's name, label, description, inputSchema, and
 execute logic as Julia code. The tool is written to `src/tools/<name>.jl`.
 
-After calling this tool, restart the agent so the new tool is loaded by
-`loadTools("src/tools")`. Then call `listTools` to verify the new tool
-is available.
+After calling this tool, restart the agent so `loadTools("src/tools")` picks
+up the new file. The new tool is immediately available.
 
 # Example
 
@@ -16,6 +15,16 @@ is available.
 3. Restart agent — loadTools() picks up the new file
 4. Agent calls searchWine with args
 
+# How It Works
+
+writeTool is a **file writer**, not a code generator. The LLM provides the
+tool logic as `executeCode`, and writeTool wraps it in Julia boilerplate:
+  - Converts `inputSchema` Dict into Julia `Dict{String,Any}(...)` string
+  - Indents `executeCode` with 4 spaces
+  - Wraps it inside `function executeTool(...)::agentToolResult ... end`
+  - Appends `getTool()` returning an `agentTool` struct
+  - Writes the combined string to `src/tools/<name>.jl`
+
 # Important Notes
 
 - The `executeCode` string is embedded literally into the generated tool.
@@ -243,7 +252,7 @@ function getTool()::agentTool
     return agentTool(
         name = "writeTool",
         label = "Create Tool",
-        description = "Generate a new Julia tool module file at src/tools/<name>.jl. After creation, restart the agent and call listTools to verify the new tool is loaded.",
+        description = "Write a new Julia tool module file to src/tools/<name>.jl. The LLM provides the tool logic as executeCode; writeTool wraps it in Julia boilerplate and writes the file. Restart the agent to load the new tool.",
         inputSchema = Dict{String,Any}(
             "type" => "object",
             "properties" => Dict(