Update state.py

state.py

@@ -1,21 +1,22 @@
 # state.py — Shared State for Autonomous Python Coding Agent
 
-from typing import TypedDict
+from typing import TypedDict # pyhton class that lets us to define dictionary with specific key names 
 
 
 class State(TypedDict):
-    task:               str
-    plan:               str
-    code:               str
-    test_result:        str
-    error:              str
-    fixed_code:         str
+    task:               str # original user requests 
+    plan:               str # plans before writing code
+    code:               str # code generated by this 
+    test_result:        str # this stores what happened when code is generated it failed crashed or passed ?
+    error:              str # message if code execution failed or not ?
+    fixed_code:         str # fixed code 
     explanation:        str
     review:             str
     final_code:         str
     retries:            int
     security_retries:   int
     complexity_retries: int
+    reflection_retries: int  # own counter — reflection loop no longer piggybacks on "retries"
     passed:             bool
     is_secure:          bool
     is_simple:          bool
@@ -26,4 +27,3 @@ class State(TypedDict):
     reflection_ok:      bool
     reflection_notes:   str
     confidence_score:   int
-    feedback:           str