fix: correct author name formatting in multiple files

.env.example

@@ -1,5 +1,5 @@
 # GAIA Benchmark Agent - Environment Configuration Template
-# Author: @mangobee
+# Author: @mangubee
 # Date: 2026-01-01
 #
 # Copy this file to .env and fill in your API keys

requirements.txt

@@ -1,5 +1,5 @@
 # GAIA Benchmark Agent - Dependencies
-# Author: @mangobee
+# Author: @mangubee
 # Date: 2026-01-01
 
 # ============================================================================

src/__init__.py

@@ -1,6 +1,6 @@
 """
 GAIA Benchmark Agent - Source Package
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-01
 """
 

src/agent/__init__.py

@@ -1,6 +1,6 @@
 """
 LangGraph agent core package
-Author: @mangobee
+Author: @mangubee
 """
 
 from .graph import GAIAAgent

src/agent/graph.py

@@ -1,6 +1,6 @@
 """
 LangGraph Agent Core - StateGraph Definition
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-01
 
 Stage 1: Skeleton with placeholder nodes
@@ -19,7 +19,15 @@ from pathlib import Path
 from typing import TypedDict, List, Optional
 from langgraph.graph import StateGraph, END
 from src.config import Settings
-from src.tools import TOOLS, search, parse_file, safe_eval, analyze_image, youtube_transcript, transcribe_audio
+from src.tools import (
+    TOOLS,
+    search,
+    parse_file,
+    safe_eval,
+    analyze_image,
+    youtube_transcript,
+    transcribe_audio,
+)
 from src.agent.llm_client import (
     plan_question,
     select_tools_with_function_calling,
@@ -35,6 +43,7 @@ logger = logging.getLogger(__name__)
 # Helper Functions
 # ============================================================================
 
+
 def is_vision_question(question: str) -> bool:
     """
     Detect if question requires vision analysis tool.
@@ -47,9 +56,19 @@ def is_vision_question(question: str) -> bool:
     Returns:
         True if question likely requires vision tool, False otherwise
     """
-    vision_keywords = ["image", "video", "youtube", "photo", "picture", "watch", "screenshot", "visual"]
+    vision_keywords = [
+        "image",
+        "video",
+        "youtube",
+        "photo",
+        "picture",
+        "watch",
+        "screenshot",
+        "visual",
+    ]
     return any(keyword in question.lower() for keyword in vision_keywords)
 
+
 # ============================================================================
 # Agent State Definition
 # ============================================================================
@@ -119,7 +138,9 @@ def fallback_tool_selection(
     Returns:
         List of tool calls with basic parameters
     """
-    logger.info("[fallback_tool_selection] Using keyword-based fallback for tool selection")
+    logger.info(
+        "[fallback_tool_selection] Using keyword-based fallback for tool selection"
+    )
 
     tool_calls = []
     question_lower = question.lower()
@@ -127,53 +148,88 @@ def fallback_tool_selection(
     combined = f"{question_lower} {plan_lower}"
 
     # Search tool: keywords like "search", "find", "look up", "who", "what", "when", "where"
-    search_keywords = ["search", "find", "look up", "who is", "what is", "when", "where", "google"]
+    search_keywords = [
+        "search",
+        "find",
+        "look up",
+        "who is",
+        "what is",
+        "when",
+        "where",
+        "google",
+    ]
     if any(keyword in combined for keyword in search_keywords):
         # Extract search query - use first sentence or full question
-        query = question.split('.')[0] if '.' in question else question
-        tool_calls.append({
-            "tool": "web_search",
-            "params": {"query": query}
-        })
-        logger.info(f"[fallback_tool_selection] Added web_search tool with query: {query}")
+        query = question.split(".")[0] if "." in question else question
+        tool_calls.append({"tool": "web_search", "params": {"query": query}})
+        logger.info(
+            f"[fallback_tool_selection] Added web_search tool with query: {query}"
+        )
 
     # Math tool: keywords like "calculate", "compute", "+", "-", "*", "/", "="
-    math_keywords = ["calculate", "compute", "math", "sum", "multiply", "divide", "+", "-", "*", "/", "="]
+    math_keywords = [
+        "calculate",
+        "compute",
+        "math",
+        "sum",
+        "multiply",
+        "divide",
+        "+",
+        "-",
+        "*",
+        "/",
+        "=",
+    ]
     if any(keyword in combined for keyword in math_keywords):
         # Try to extract expression - look for patterns with numbers and operators
         import re
+
         # Look for mathematical expressions
-        expr_match = re.search(r'[\d\s\+\-\*/\(\)\.]+', question)
+        expr_match = re.search(r"[\d\s\+\-\*/\(\)\.]+", question)
         if expr_match:
             expression = expr_match.group().strip()
-            tool_calls.append({
-                "tool": "calculator",
-                "params": {"expression": expression}
-            })
-            logger.info(f"[fallback_tool_selection] Added calculator tool with expression: {expression}")
+            tool_calls.append(
+                {"tool": "calculator", "params": {"expression": expression}}
+            )
+            logger.info(
+                f"[fallback_tool_selection] Added calculator tool with expression: {expression}"
+            )
 
     # File tool: if file_paths available, use them
     if file_paths:
         for file_path in file_paths:
             # Determine file type and appropriate tool
             file_ext = Path(file_path).suffix.lower()
-            if file_ext in ['.png', '.jpg', '.jpeg']:
-                tool_calls.append({
-                    "tool": "vision",
-                    "params": {"image_path": file_path}
-                })
-                logger.info(f"[fallback_tool_selection] Added vision tool for image: {file_path}")
-            elif file_ext in ['.pdf', '.xlsx', '.xls', '.csv', '.json', '.txt', '.docx', '.doc']:
-                tool_calls.append({
-                    "tool": "parse_file",
-                    "params": {"file_path": file_path}
-                })
-                logger.info(f"[fallback_tool_selection] Added parse_file tool for: {file_path}")
+            if file_ext in [".png", ".jpg", ".jpeg"]:
+                tool_calls.append(
+                    {"tool": "vision", "params": {"image_path": file_path}}
+                )
+                logger.info(
+                    f"[fallback_tool_selection] Added vision tool for image: {file_path}"
+                )
+            elif file_ext in [
+                ".pdf",
+                ".xlsx",
+                ".xls",
+                ".csv",
+                ".json",
+                ".txt",
+                ".docx",
+                ".doc",
+            ]:
+                tool_calls.append(
+                    {"tool": "parse_file", "params": {"file_path": file_path}}
+                )
+                logger.info(
+                    f"[fallback_tool_selection] Added parse_file tool for: {file_path}"
+                )
     else:
         # Keyword-based file detection (legacy)
         file_keywords = ["file", "parse", "read", "csv", "json", "txt", "document"]
         if any(keyword in combined for keyword in file_keywords):
-            logger.warning("[fallback_tool_selection] File operation detected but no file_paths available")
+            logger.warning(
+                "[fallback_tool_selection] File operation detected but no file_paths available"
+            )
 
     # Image tool: keywords like "image", "picture", "photo", "analyze", "vision"
     image_keywords = ["image", "picture", "photo", "analyze image", "vision"]
@@ -182,17 +238,20 @@ def fallback_tool_selection(
             # Already handled above in file_paths check
             pass
         else:
-            logger.warning("[fallback_tool_selection] Image operation detected but no file_paths available")
+            logger.warning(
+                "[fallback_tool_selection] Image operation detected but no file_paths available"
+            )
 
     if not tool_calls:
-        logger.warning("[fallback_tool_selection] No tools selected by fallback - adding default search")
+        logger.warning(
+            "[fallback_tool_selection] No tools selected by fallback - adding default search"
+        )
         # Default: just search the question
-        tool_calls.append({
-            "tool": "web_search",
-            "params": {"query": question}
-        })
+        tool_calls.append({"tool": "web_search", "params": {"query": question}})
 
-    logger.info(f"[fallback_tool_selection] Fallback selected {len(tool_calls)} tool(s)")
+    logger.info(
+        f"[fallback_tool_selection] Fallback selected {len(tool_calls)} tool(s)"
+    )
     return tool_calls
 
 
@@ -264,7 +323,9 @@ def execute_node(state: AgentState) -> AgentState:
             )
         elif not isinstance(tool_calls, list):
             logger.error(f"[execute] Invalid type: {type(tool_calls)}, using fallback")
-            state["errors"].append(f"Tool selection returned invalid type: {type(tool_calls)}")
+            state["errors"].append(
+                f"Tool selection returned invalid type: {type(tool_calls)}"
+            )
             tool_calls = fallback_tool_selection(
                 state["question"], state["plan"], state.get("file_paths")
             )
@@ -284,12 +345,14 @@ def execute_node(state: AgentState) -> AgentState:
                 result = tool_func(**params)
                 logger.info(f"[{idx}/{len(tool_calls)}] {tool_name} ✓")
 
-                tool_results.append({
-                    "tool": tool_name,
-                    "params": params,
-                    "result": result,
-                    "status": "success",
-                })
+                tool_results.append(
+                    {
+                        "tool": tool_name,
+                        "params": params,
+                        "result": result,
+                        "status": "success",
+                    }
+                )
 
                 # Extract evidence - handle different result formats
                 if isinstance(result, dict):
@@ -307,7 +370,9 @@ def execute_node(state: AgentState) -> AgentState:
                                 title = r.get("title", "")[:100]
                                 url = r.get("url", "")[:100]
                                 snippet = r.get("snippet", "")[:200]
-                                formatted.append(f"Title: {title}\nURL: {url}\nSnippet: {snippet}")
+                                formatted.append(
+                                    f"Title: {title}\nURL: {url}\nSnippet: {snippet}"
+                                )
                             evidence.append("\n\n".join(formatted))
                         else:
                             evidence.append(str(result))
@@ -320,13 +385,17 @@ def execute_node(state: AgentState) -> AgentState:
 
             except Exception as tool_error:
                 logger.error(f"[execute] ✗ {tool_name}: {tool_error}")
-                tool_results.append({
-                    "tool": tool_name,
-                    "params": params,
-                    "error": str(tool_error),
-                    "status": "failed",
-                })
-                if tool_name == "vision" and ("quota" in str(tool_error).lower() or "429" in str(tool_error)):
+                tool_results.append(
+                    {
+                        "tool": tool_name,
+                        "params": params,
+                        "error": str(tool_error),
+                        "status": "failed",
+                    }
+                )
+                if tool_name == "vision" and (
+                    "quota" in str(tool_error).lower() or "429" in str(tool_error)
+                ):
                     state["errors"].append(f"Vision failed: LLM quota exhausted")
                 else:
                     state["errors"].append(f"{tool_name}: {type(tool_error).__name__}")
@@ -336,7 +405,9 @@ def execute_node(state: AgentState) -> AgentState:
     except Exception as e:
         logger.error(f"[execute] ✗ {type(e).__name__}: {str(e)}")
 
-        if is_vision_question(state["question"]) and ("quota" in str(e).lower() or "429" in str(e)):
+        if is_vision_question(state["question"]) and (
+            "quota" in str(e).lower() or "429" in str(e)
+        ):
             state["errors"].append("Vision unavailable (quota exhausted)")
         else:
             state["errors"].append(f"Execution error: {type(e).__name__}")
@@ -364,12 +435,14 @@ def execute_node(state: AgentState) -> AgentState:
                         tool_func = TOOL_FUNCTIONS.get(tool_name)
                         if tool_func:
                             result = tool_func(**params)
-                            tool_results.append({
-                                "tool": tool_name,
-                                "params": params,
-                                "result": result,
-                                "status": "success"
-                            })
+                            tool_results.append(
+                                {
+                                    "tool": tool_name,
+                                    "params": params,
+                                    "result": result,
+                                    "status": "success",
+                                }
+                            )
                             if isinstance(result, dict):
                                 if "answer" in result:
                                     evidence.append(result["answer"])
@@ -381,7 +454,9 @@ def execute_node(state: AgentState) -> AgentState:
                                             title = r.get("title", "")[:100]
                                             url = r.get("url", "")[:100]
                                             snippet = r.get("snippet", "")[:200]
-                                            formatted.append(f"Title: {title}\nURL: {url}\nSnippet: {snippet}")
+                                            formatted.append(
+                                                f"Title: {title}\nURL: {url}\nSnippet: {snippet}"
+                                            )
                                         evidence.append("\n\n".join(formatted))
                                     else:
                                         evidence.append(str(result))
@@ -411,7 +486,9 @@ def answer_node(state: AgentState) -> AgentState:
 
     try:
         if not state["evidence"]:
-            error_summary = "; ".join(state["errors"]) if state["errors"] else "No errors logged"
+            error_summary = (
+                "; ".join(state["errors"]) if state["errors"] else "No errors logged"
+            )
             state["answer"] = f"ERROR: No evidence. {error_summary}"
             logger.error(f"[answer] ✗ No evidence - {error_summary}")
             return state
@@ -425,7 +502,9 @@ def answer_node(state: AgentState) -> AgentState:
     except Exception as e:
         logger.error(f"[answer] ✗ {type(e).__name__}: {str(e)}")
         state["errors"].append(f"Answer synthesis error: {type(e).__name__}: {str(e)}")
-        state["answer"] = f"ERROR: Answer synthesis failed - {type(e).__name__}: {str(e)}"
+        state["answer"] = (
+            f"ERROR: Answer synthesis failed - {type(e).__name__}: {str(e)}"
+        )
 
     return state
 
@@ -491,7 +570,9 @@ class GAIAAgent:
             warning_msg = f"⚠️  WARNING: Missing API keys: {', '.join(missing_keys)}"
             print(warning_msg)
             logger.warning(warning_msg)
-            print("   Agent may fail to answer questions. Set keys in environment variables.")
+            print(
+                "   Agent may fail to answer questions. Set keys in environment variables."
+            )
         else:
             print("✓ All API keys present")
 

src/agent/llm_client.py

@@ -1,6 +1,6 @@
 """
 LLM Client Module - Multi-Provider LLM Integration
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Handles all LLM calls for:

src/config/__init__.py

@@ -1,6 +1,6 @@
 """
 Configuration management package
-Author: @mangobee
+Author: @mangubee
 """
 
 from .settings import Settings

src/config/settings.py

@@ -1,6 +1,6 @@
 """
 Configuration Management
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-01
 
 Loads environment variables and defines configuration constants for GAIA agent.

src/tools/__init__.py

@@ -1,6 +1,6 @@
 """
 Tool implementations package
-Author: @mangobee
+Author: @mangubee
 
 This package contains all agent tools:
 - web_search: Web search using Tavily/Exa

src/tools/audio.py

@@ -1,6 +1,6 @@
 """
 Audio Transcription Tool - Whisper speech-to-text
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-13
 
 Provides audio transcription using OpenAI Whisper:

src/tools/calculator.py

@@ -1,6 +1,6 @@
 """
 Calculator Tool - Safe mathematical expression evaluation
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Provides safe evaluation of mathematical expressions with:

src/tools/file_parser.py

@@ -1,6 +1,6 @@
 """
 File Parser Tool - Multi-format file reading
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Provides file parsing for:

src/tools/vision.py

@@ -1,6 +1,6 @@
 """
 Vision Tool - Image analysis using multimodal LLMs
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Provides image analysis functionality using:

src/tools/web_search.py

@@ -1,6 +1,6 @@
 """
 Web Search Tool - Tavily and Exa implementations
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Provides web search functionality with:

src/tools/youtube.py

@@ -1,6 +1,6 @@
 """
 YouTube Video Analysis Tool - Extract transcripts or analyze frames from YouTube videos
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-13
 
 Provides two modes for YouTube video analysis:

src/utils/__init__.py

@@ -1,6 +1,6 @@
 """Utility modules for GAIA agent.
 
-Author: @mangobee
+Author: @mangubee
 """
 
 from .ground_truth import get_ground_truth, GAIAGroundTruth

src/utils/ground_truth.py

@@ -1,6 +1,6 @@
 """Ground truth comparison using GAIA validation dataset.
 
-Author: @mangobee
+Author: @mangubee
 
 Since the GAIA API only returns summary stats (X/Y correct) without per-question
 correctness, we load the public validation dataset to compare our answers locally.

test/__init__.py

@@ -1,6 +1,6 @@
 """
 Tests Package for GAIA Agent
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-01
 
 Test organization:

test/fixtures/generate_fixtures.py

@@ -1,6 +1,6 @@
 """
 Generate test fixtures for file parser tests
-Author: @mangobee
+Author: @mangubee
 """
 
 from pathlib import Path

test/test_agent_basic.py

@@ -1,6 +1,6 @@
 """
 Basic Tests for GAIA Agent - Stage 1 Validation
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-01
 
 Tests for Stage 1: Foundation Setup

test/test_calculator.py

@@ -1,6 +1,6 @@
 """
 Tests for calculator tool (safe mathematical evaluation)
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Tests cover:

test/test_file_parser.py

@@ -1,6 +1,6 @@
 """
 Tests for file parser tool
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Tests cover:

test/test_llm_integration.py

@@ -1,6 +1,6 @@
 """
 LLM Integration Tests - Stage 3 Validation
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Tests for Stage 3 LLM integration:

test/test_phase0_hf_vision_api.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
 Phase 0: HuggingFace Inference API Vision Validation
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-07
 
 Tests HF Inference API with vision models to validate multimodal support BEFORE

test/test_smoke_hf_vision.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
 Phase 2: Smoke Tests for HF Vision Integration
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-11
 
 Quick validation that HF vision works before GAIA evaluation.

test/test_stage1.py

@@ -1,6 +1,6 @@
 """
 Stage 1 Quick Verification Test
-Author: @mangobee
+Author: @mangubee
 
 Test that agent initialization and basic execution works.
 """

test/test_stage3_e2e.py

@@ -1,6 +1,6 @@
 """
 Stage 3 End-to-End Test with Real LLM API
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Manual test for Stage 3 workflow with actual Claude API.

test/test_vision.py

@@ -1,6 +1,6 @@
 """
 Tests for vision tool (multimodal image analysis)
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Tests cover:

test/test_web_search.py

@@ -1,6 +1,6 @@
 """
 Tests for web search tool (Tavily and Exa)
-Author: @mangobee
+Author: @mangubee
 Date: 2026-01-02
 
 Tests cover: