diff --git a/server-rs/crates/api-server/src/editor_agent/reconcile.rs b/server-rs/crates/api-server/src/editor_agent/reconcile.rs
index eeb057e56..3e7606d6e 100644
--- a/server-rs/crates/api-server/src/editor_agent/reconcile.rs
+++ b/server-rs/crates/api-server/src/editor_agent/reconcile.rs
@@ -115,6 +115,10 @@ pub async fn reconcile_editor_agent_tool_calls(
         }
 
         if let Some(error) = last_reconcile_error {
+            // unlikely.
+            // if we don't mark this as failed,
+            // the client will poll external job id -> found completed -> get conv and reconcile again,
+            // if here is fatal, it will be stuck in a loop.
             mark_result_reconcile_failed(&mut document.messages[message_index], error);
             reconciled.push(document.messages[message_index].clone());
         }