update

learning/02-AGENT_COMPONENT.md

@@ -243,16 +243,35 @@ followUp(agent, UserMessage(...))
 
 ```julia
 # Transform messages before sending to LLM
-function myConvertToLlm(messages::Vector{AgentMessage})
-    return filter(
-        m -> m.role in ["user", "assistant", "toolResult"],
-        messages
-    )
+function myConvertToLlm(messages::Vector{AgentMessage})::Vector{Message}
+    result::Vector{Message} = Message[]
+    for m in messages
+        converted = convertToLlmMessage(m)
+        if !isnothing(converted)
+            push!(result, converted)
+        end
+    end
+    return result
 end
 
 agent = Agent(Dict(:convertToLlm => myConvertToLlm))
 ```
 
+**Data Flow**:
+```
+Vector{AgentMessage}
+    │
+    │  convertToLlmMessage() dispatches on type:
+    │  • UserMessage → UserMessage (pass-through)
+    │  • AssistantMessage → AssistantMessage (pass-through)
+    │  • ToolResultMessage → ToolResultMessage (pass-through)
+    │  • BashExecutionMessage → UserMessage (bashExecutionToText)
+    │  • CompactionSummaryMessage → UserMessage (wrapped)
+    │  • BranchSummaryMessage → UserMessage (wrapped)
+    ▼
+Vector{Message} (for LLM API)
+```
+
 #### transform_context
 
 ```julia