fixx error

app.py

@@ -228,6 +228,14 @@ def generate_caption_and_hashtags(niche: str, persona: str, trend_label: str) ->
     """
     Generate a posting-ready caption, hashtags, and a tiny posting tip
     based on niche + persona + trend theme.
+
+    Args:
+        niche (str): Selected content niche (e.g. Motivation, Fitness).
+        persona (str): Selected persona (Coach, Philosopher, etc.).
+        trend_label (str): Short label describing the current trend theme.
+
+    Returns:
+        str: Formatted block containing caption, hashtags, and posting tip.
     """
     persona_instruction = get_persona_instruction(persona)
 
@@ -287,12 +295,12 @@ def generate_quote_tool(niche: str, style: str, persona: str) -> str:
     and persona-aware tone.
 
     Args:
-        niche: High-level niche/category (e.g. Motivation, Fitness, Mindfulness).
-        style: Visual style (e.g. Cinematic, Nature, Urban, Minimal, Abstract).
-        persona: Voice persona to influence tone (Coach, Philosopher, Poet, Mentor).
+        niche (str): High-level niche/category (e.g. Motivation, Fitness, Mindfulness).
+        style (str): Visual style for the video (e.g. Cinematic, Nature, Urban, Minimal, Abstract).
+        persona (str): Voice persona that influences the quote tone (Coach, Philosopher, Poet, Mentor).
 
     Returns:
-        A unique quote string generated by the hybrid Gemini/OpenAI system.
+        str: A unique quote string generated by the hybrid Gemini/OpenAI system.
     """
     persona_instruction = get_persona_instruction(persona)
     combined_style = f"{style} | persona={persona} | tone={persona_instruction}"
@@ -325,6 +333,20 @@ def search_pexels_video_tool(style: str, niche: str, trend_label: str = "") -> d
     """
     Search and fetch a matching vertical video from Pexels based on style, niche,
     and the current trend label.
+
+    Args:
+        style (str): Visual style for the background footage (e.g. Cinematic, Nature).
+        niche (str): Selected niche (Motivation, Business/Entrepreneurship, etc.).
+        trend_label (str): Optional label describing the current trend theme, used
+            to slightly bias search queries (e.g. "soft life", "discipline era").
+
+    Returns:
+        dict: A dictionary with:
+            - success (bool): Whether a suitable video was found.
+            - video_url (str or None): Direct URL to the chosen video file.
+            - search_query (str): The Pexels search query used.
+            - pexels_url (str or None): Public Pexels page for the chosen video.
+            - error (str, optional): Error message if success is False.
     """
     base_queries = {
         "Motivation": {
@@ -446,7 +468,22 @@ def create_quote_video_tool(
     text_style: str = "classic_center",
 ) -> dict:
     """
-    Create the final quote video via the Modal web endpoint.
+    Create the final quote video via the Modal web endpoint, overlaying the quote
+    and optionally adding an audio track.
+
+    Args:
+        video_url (str): Direct URL to the background video file (from Pexels).
+        quote_text (str): The quote text to render as an overlay on the video.
+        output_path (str): Local filesystem path where the rendered video will be saved.
+        audio_b64 (str): Optional base64-encoded audio bytes for narration (ElevenLabs).
+        text_style (str): Text layout style identifier (e.g. 'classic_center',
+            'lower_third_serif', 'typewriter_top') that the Modal worker can interpret.
+
+    Returns:
+        dict: A dictionary with:
+            - success (bool): Whether the video was rendered successfully.
+            - output_path (str or None): Path to the saved MP4 file if successful.
+            - message (str): Human-readable status or error description.
     """
     if not MODAL_ENDPOINT_URL:
         return {
@@ -652,8 +689,18 @@ def mcp_agent_pipeline(
     num_variations: int = 1,
 ) -> Tuple[str, List[str], str]:
     """
+    Run the full quote video pipeline: context fusion, quote, voice, video, caption.
+
+    Args:
+        niche (str): Selected content niche.
+        style (str): Visual style for video footage.
+        persona (str): Persona controlling tone.
+        text_style (str): Layout style for text overlay.
+        voice_profile (str): Chosen ElevenLabs voice profile.
+        num_variations (int): Number of video variants to generate.
+
     Returns:
-        status_log_str, created_videos, caption_block
+        Tuple[str, List[str], str]: (status_log, list of video paths, caption_block).
     """
     status_log: List[str] = []
     status_log.append("🤖 **MCP-STYLE AGENT PIPELINE START**\n")
@@ -785,7 +832,6 @@ def mcp_agent_pipeline(
     if mcp_enabled:
         status_log.append("   • MCP server – available for extended tools")
 
-    # Step 6 – Caption + hashtags block (returned separately for the UI)
     status_log.append(
         "\n📝 **Step 6 – Caption + Hashtags** (see the panel next to your videos to copy-paste)"
     )
@@ -1021,4 +1067,4 @@ with gr.Blocks(
     )
 
 if __name__ == "__main__":
-    demo.launch(allowed_paths=["/data/gallery_videos"])
+    demo.launch(allowed_paths=["/data/gallery_videos"])