add optional tutorial parts

Author: neagualexa

src/agents/utils/parse_json_context_to_prompt.py

@@ -76,13 +76,15 @@ def __init__(
         publishedPartContent: Optional[str] = None,
         publishedPartAnswerContent: Optional[str] = None,
         publishedWorkedSolutionSections: Optional[List[dict]] = [],
+        publishedStructuredTutorialSections: Optional[List[dict]] = [],
         publishedResponseAreas: Optional[List[Optional[ResponseAreaDetails]]] = [],
     ):
         self.publishedPartId = publishedPartId
         self.publishedPartPosition = publishedPartPosition
         self.publishedPartContent = publishedPartContent
         self.publishedPartAnswerContent = publishedPartAnswerContent
         self.publishedWorkedSolutionSections = publishedWorkedSolutionSections
+        self.publishedStructuredTutorialSections = publishedStructuredTutorialSections
         self.publishedResponseAreas = [ResponseAreaDetails(**publishedResponseArea) for publishedResponseArea in publishedResponseAreas]
 
 class QuestionDetails:
@@ -277,9 +279,20 @@ def _format_single_part(
                 'content': ws.get('content', ''),
                 'position': ws.get('position', 0)
             })
+
+    #  6. Structured Tutorial Sections
+    tutorial_data = []
+    if part.publishedStructuredTutorialSections:
+        for ts in part.publishedStructuredTutorialSections:
+            tutorial_data.append({
+                'title': ts.get('title', ''),
+                'content': ts.get('content', ''),
+                'position': ts.get('position', 0)
+            })
 
     part_sections.append(PromptFormatter.format_worked_solutions(solutions_data))
-    
+    part_sections.append(PromptFormatter.format_structured_tutorials(tutorial_data))
+
     return "\n".join(part_sections) + "\n---\n"
 
 

src/agents/utils/prompt_context_templates.py

@@ -211,6 +211,22 @@ def format_worked_solutions(solutions: List[Dict[str, Any]]) -> str:
 
 {"\n".join(solution_texts)}"""
 
+    @staticmethod
+    def format_structured_tutorials(tutorials: List[Dict[str, Any]]) -> str:
+        """Format structured tutorials section."""
+        if not tutorials:
+            return "### Structured Tutorials\n\nNone available"
+        
+        tutorial_texts = []
+        for i, tutorial in enumerate(tutorials):
+            title = tutorial.get('title', f'Tutorial {i + 1}')
+            content = tutorial.get('content', '').strip() or 'No content available'
+            tutorial_texts.append(f"#### {title}\n\n{content}")
+        
+        return f"""### Structured Tutorials
+
+{"\n".join(tutorial_texts)}"""
+
     @staticmethod
     def format_complete_prompt(sections: List[str]) -> str:
         """Combine all sections into a complete, well-structured prompt."""