quantalogic 0.2.10__tar.gz → 0.2.13__tar.gz

quantalogic-0.2.10/README.md → quantalogic-0.2.13/PKG-INFO

@@ -1,3 +1,43 @@
+Metadata-Version: 2.1
+Name: quantalogic
+Version: 0.2.13
+Summary: QuantaLogic ReAct Agents
+Author: Raphaël MANSUY
+Author-email: raphael.mansuy@gmail.com
+Requires-Python: >=3.12,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: boto3 (>=1.35.86,<2.0.0)
+Requires-Dist: click (>=8.1.8,<9.0.0)
+Requires-Dist: fastapi (>=0.115.6,<0.116.0)
+Requires-Dist: google-auth (>=2.20.0,<3.0.0)
+Requires-Dist: google-search-results (>=2.4.2,<3.0.0)
+Requires-Dist: litellm (>=1.56.4,<2.0.0)
+Requires-Dist: loguru (>=0.7.3,<0.8.0)
+Requires-Dist: markitdown (>=0.0.1a3,<0.0.2)
+Requires-Dist: pathspec (>=0.12.1,<0.13.0)
+Requires-Dist: prompt-toolkit (>=3.0.48,<4.0.0)
+Requires-Dist: pydantic (>=2.10.4,<3.0.0)
+Requires-Dist: rich (>=13.9.4,<14.0.0)
+Requires-Dist: serpapi (>=0.1.5,<0.2.0)
+Requires-Dist: tenacity (>=9.0.0,<10.0.0)
+Requires-Dist: toml (>=0.10.2,<0.11.0)
+Requires-Dist: tree-sitter (>=0.23.2,<0.24.0)
+Requires-Dist: tree-sitter-c (>=0.23.4,<0.24.0)
+Requires-Dist: tree-sitter-cpp (>=0.23.4,<0.24.0)
+Requires-Dist: tree-sitter-go (>=0.23.4,<0.24.0)
+Requires-Dist: tree-sitter-java (>=0.23.5,<0.24.0)
+Requires-Dist: tree-sitter-javascript (>=0.23.1,<0.24.0)
+Requires-Dist: tree-sitter-python (>=0.23.6,<0.24.0)
+Requires-Dist: tree-sitter-rust (>=0.23.2,<0.24.0)
+Requires-Dist: tree-sitter-scala (>=0.23.4,<0.24.0)
+Requires-Dist: tree-sitter-typescript (>=0.23.2,<0.24.0)
+Requires-Dist: types-requests (>=2.32.0.20241016,<3.0.0.0)
+Requires-Dist: uvicorn (>=0.34.0,<0.35.0)
+Requires-Dist: websocket (>=0.2.1,<0.3.0)
+Description-Content-Type: text/markdown
+
 # QuantaLogic
 
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
@@ -92,7 +132,7 @@ Options:
                                   e.g. "openrouter/A/gpt-4o-mini").
   --log [info|debug|warning]      Set logging level (info/debug/warning).
   --verbose                       Enable verbose output.
-  --mode [code|basic|interpreter|full|code-basic]
+  --mode [code|basic|interpreter|full|code-basic|search]
                                   Agent mode (code/search/full).
   --help                          Show this message and exit.
 
@@ -103,6 +143,8 @@ Commands:
 ### Commands
 task    Execute a task with the QuantaLogic AI Assistant
 
+
+
 ### Detailed Usage
 
 #### Agent Modes
@@ -342,16 +384,19 @@ By integrating these tools into its architecture, QuantaLogic allows agents to p
 
 ### Tools Documentation
 
+
+
 #### Overview of Tools
 
 | Category               | Tools                                                                                             |
 |-----------------------|---------------------------------------------------------------------------------------------------|
-| Task Automation        | Agent Tool, Task Complete Tool, Input Question Tool, Execute Bash Command Tool                  |
-| Script Execution       | Python Tool, Node.js Tool, Elixir Tool                                                            |
-| File Operations        | Read File Tool, Write File Tool, Edit Whole Content Tool, Replace In File Tool                   |
-| Code Analysis          | Search Definition Names Tool, Ripgrep Tool                                                        |
-| Content Generation      | LLM Tool, LLMVisionTool                                                                           |
-| Utility and Management  | Download HTTP File Tool, List Directory Tool, Markitdown Tool, Unified Diff Tool                 |
+| 1. Search Tools        | 1.1 SerpAPI Search Tool, 1.2 Wikipedia Search Tool                                               |
+| 2. Task Automation     | Agent Tool, Task Complete Tool, Input Question Tool, Execute Bash Command Tool                  |
+| 3. Script Execution    | Python Tool, Node.js Tool, Elixir Tool                                                            |
+| 4. File Operations     | Read File Tool, Write File Tool, Edit Whole Content Tool, Replace In File Tool                   |
+| 5. Code Analysis       | Search Definition Names Tool, Ripgrep Tool                                                        |
+| 6. Content Generation  | LLM Tool, LLMVisionTool                                                                           |
+| 7. Utility & Management| Download HTTP File Tool, List Directory Tool, Markitdown Tool, Unified Diff Tool                 |
 
 ---
 
@@ -750,6 +795,51 @@ result = markitdown_tool.execute(markdown_path="./path/to/file.md")
 print("Processed Markdown Output:", result)
 ```
 
+---
+
+### 19. SerpAPI Search Tool
+
+The **SerpAPI Search Tool** allows agents to perform web searches using the SerpAPI service.
+
+##### Parameters
+| Parameter | Type   | Description                     | Example                     |
+|-----------|--------|---------------------------------|-----------------------------|
+| query     | string | The search query to execute     | "latest AI research papers" |
+| location  | string | Geographic location for results | "United States"             |
+| num       | int    | Number of results to return     | 5                           |
+
+##### Example Usage
+```python
+from quantalogic.tools import SerpAPISearchTool
+
+search_tool = SerpAPISearchTool()
+results = search_tool.execute(query="latest AI research", location="United States", num=5)
+print(results)
+```
+
+---
+
+### 20. Wikipedia Search Tool
+
+The **Wikipedia Search Tool** enables agents to search and retrieve information from Wikipedia.
+
+##### Parameters
+
+| Parameter | Type   | Description                     | Example                     |
+|-----------|--------|---------------------------------|-----------------------------|
+| query     | string | The search query to execute     | "Artificial Intelligence"   |
+| lang      | string | Language code for results       | "en"                        |
+| sentences | int    | Number of summary sentences     | 3                           |
+
+##### Example Usage
+```python
+from quantalogic.tools import WikipediaSearchTool
+
+wiki_tool = WikipediaSearchTool()
+results = wiki_tool.execute(query="Artificial Intelligence", lang="en", sentences=3)
+print(results)
+```
+```
 
 #### Creating Custom Tools
 
@@ -979,3 +1069,4 @@ Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for detai
 [![Star History Chart](https://api.star-history.com/svg?repos=quantalogic/quantalogic&type=Date)](https://star-history.com/#quantalogic/quantalogic&Date)
 
 Initiated with ❤️ by Raphaël MANSUY. Founder of [Quantalogic](https://www.quantalogic.app). 
+

quantalogic-0.2.10/PKG-INFO → quantalogic-0.2.13/README.md

@@ -1,40 +1,3 @@
-Metadata-Version: 2.1
-Name: quantalogic
-Version: 0.2.10
-Summary: QuantaLogic ReAct Agents
-Author: Raphaël MANSUY
-Author-email: raphael.mansuy@gmail.com
-Requires-Python: >=3.12,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: boto3 (>=1.35.86,<2.0.0)
-Requires-Dist: click (>=8.1.8,<9.0.0)
-Requires-Dist: fastapi (>=0.115.6,<0.116.0)
-Requires-Dist: google-auth (>=2.20.0,<3.0.0)
-Requires-Dist: litellm (>=1.56.4,<2.0.0)
-Requires-Dist: loguru (>=0.7.3,<0.8.0)
-Requires-Dist: markitdown (>=0.0.1a3,<0.0.2)
-Requires-Dist: pathspec (>=0.12.1,<0.13.0)
-Requires-Dist: prompt-toolkit (>=3.0.48,<4.0.0)
-Requires-Dist: pydantic (>=2.10.4,<3.0.0)
-Requires-Dist: rich (>=13.9.4,<14.0.0)
-Requires-Dist: tenacity (>=9.0.0,<10.0.0)
-Requires-Dist: toml (>=0.10.2,<0.11.0)
-Requires-Dist: tree-sitter (>=0.23.2,<0.24.0)
-Requires-Dist: tree-sitter-c (>=0.23.4,<0.24.0)
-Requires-Dist: tree-sitter-cpp (>=0.23.4,<0.24.0)
-Requires-Dist: tree-sitter-go (>=0.23.4,<0.24.0)
-Requires-Dist: tree-sitter-java (>=0.23.5,<0.24.0)
-Requires-Dist: tree-sitter-javascript (>=0.23.1,<0.24.0)
-Requires-Dist: tree-sitter-python (>=0.23.6,<0.24.0)
-Requires-Dist: tree-sitter-rust (>=0.23.2,<0.24.0)
-Requires-Dist: tree-sitter-scala (>=0.23.4,<0.24.0)
-Requires-Dist: tree-sitter-typescript (>=0.23.2,<0.24.0)
-Requires-Dist: uvicorn (>=0.34.0,<0.35.0)
-Requires-Dist: websocket (>=0.2.1,<0.3.0)
-Description-Content-Type: text/markdown
-
 # QuantaLogic
 
 [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
@@ -129,7 +92,7 @@ Options:
                                   e.g. "openrouter/A/gpt-4o-mini").
   --log [info|debug|warning]      Set logging level (info/debug/warning).
   --verbose                       Enable verbose output.
-  --mode [code|basic|interpreter|full|code-basic]
+  --mode [code|basic|interpreter|full|code-basic|search]
                                   Agent mode (code/search/full).
   --help                          Show this message and exit.
 
@@ -140,6 +103,8 @@ Commands:
 ### Commands
 task    Execute a task with the QuantaLogic AI Assistant
 
+
+
 ### Detailed Usage
 
 #### Agent Modes
@@ -379,16 +344,19 @@ By integrating these tools into its architecture, QuantaLogic allows agents to p
 
 ### Tools Documentation
 
+
+
 #### Overview of Tools
 
 | Category               | Tools                                                                                             |
 |-----------------------|---------------------------------------------------------------------------------------------------|
-| Task Automation        | Agent Tool, Task Complete Tool, Input Question Tool, Execute Bash Command Tool                  |
-| Script Execution       | Python Tool, Node.js Tool, Elixir Tool                                                            |
-| File Operations        | Read File Tool, Write File Tool, Edit Whole Content Tool, Replace In File Tool                   |
-| Code Analysis          | Search Definition Names Tool, Ripgrep Tool                                                        |
-| Content Generation      | LLM Tool, LLMVisionTool                                                                           |
-| Utility and Management  | Download HTTP File Tool, List Directory Tool, Markitdown Tool, Unified Diff Tool                 |
+| 1. Search Tools        | 1.1 SerpAPI Search Tool, 1.2 Wikipedia Search Tool                                               |
+| 2. Task Automation     | Agent Tool, Task Complete Tool, Input Question Tool, Execute Bash Command Tool                  |
+| 3. Script Execution    | Python Tool, Node.js Tool, Elixir Tool                                                            |
+| 4. File Operations     | Read File Tool, Write File Tool, Edit Whole Content Tool, Replace In File Tool                   |
+| 5. Code Analysis       | Search Definition Names Tool, Ripgrep Tool                                                        |
+| 6. Content Generation  | LLM Tool, LLMVisionTool                                                                           |
+| 7. Utility & Management| Download HTTP File Tool, List Directory Tool, Markitdown Tool, Unified Diff Tool                 |
 
 ---
 
@@ -787,6 +755,51 @@ result = markitdown_tool.execute(markdown_path="./path/to/file.md")
 print("Processed Markdown Output:", result)
 ```
 
+---
+
+### 19. SerpAPI Search Tool
+
+The **SerpAPI Search Tool** allows agents to perform web searches using the SerpAPI service.
+
+##### Parameters
+| Parameter | Type   | Description                     | Example                     |
+|-----------|--------|---------------------------------|-----------------------------|
+| query     | string | The search query to execute     | "latest AI research papers" |
+| location  | string | Geographic location for results | "United States"             |
+| num       | int    | Number of results to return     | 5                           |
+
+##### Example Usage
+```python
+from quantalogic.tools import SerpAPISearchTool
+
+search_tool = SerpAPISearchTool()
+results = search_tool.execute(query="latest AI research", location="United States", num=5)
+print(results)
+```
+
+---
+
+### 20. Wikipedia Search Tool
+
+The **Wikipedia Search Tool** enables agents to search and retrieve information from Wikipedia.
+
+##### Parameters
+
+| Parameter | Type   | Description                     | Example                     |
+|-----------|--------|---------------------------------|-----------------------------|
+| query     | string | The search query to execute     | "Artificial Intelligence"   |
+| lang      | string | Language code for results       | "en"                        |
+| sentences | int    | Number of summary sentences     | 3                           |
+
+##### Example Usage
+```python
+from quantalogic.tools import WikipediaSearchTool
+
+wiki_tool = WikipediaSearchTool()
+results = wiki_tool.execute(query="Artificial Intelligence", lang="en", sentences=3)
+print(results)
+```
+```
 
 #### Creating Custom Tools
 
@@ -1016,4 +1029,3 @@ Licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for detai
 [![Star History Chart](https://api.star-history.com/svg?repos=quantalogic/quantalogic&type=Date)](https://star-history.com/#quantalogic/quantalogic&Date)
 
 Initiated with ❤️ by Raphaël MANSUY. Founder of [Quantalogic](https://www.quantalogic.app). 
-

{quantalogic-0.2.10 → quantalogic-0.2.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "quantalogic"
-version = "0.2.10"
+version = "0.2.13"
 description = "QuantaLogic ReAct Agents"
 authors = ["Raphaël MANSUY <raphael.mansuy@gmail.com>"]
 readme = "README.md"
@@ -33,6 +33,9 @@ google-auth = "^2.20.0"
 pathspec = "^0.12.1"
 click = "^8.1.8"
 toml = "^0.10.2"
+types-requests = "^2.32.0.20241016"
+google-search-results = "^2.4.2"
+serpapi = "^0.1.5"
 
 [tool.poetry.scripts]
 quantalogic = "quantalogic.main:cli"

{quantalogic-0.2.10 → quantalogic-0.2.13}/quantalogic/agent.py

@@ -1,7 +1,5 @@
 """Enhanced QuantaLogic agent implementing the ReAct framework."""
 
-import os
-import sys
 from collections.abc import Callable
 from datetime import datetime
 from typing import Any
@@ -583,7 +581,9 @@ class Agent(BaseModel):
             "\n"
             "Available variables:\n"
             "\n"
-            f"{', '.join(self.variable_store.keys())}\n" if len(self.variable_store.keys()) > 0 else "None\n"
+            f"{', '.join(self.variable_store.keys())}\n"
+            if len(self.variable_store.keys()) > 0
+            else "None\n"
         )
         return prompt_use_variables
 
@@ -630,10 +630,10 @@ class Agent(BaseModel):
 
     def _generate_task_summary(self, content: str) -> str:
         """Generate a concise summary of the given content using the generative model.
-        
+
         Args:
             content (str): The content to summarize
-            
+
         Returns:
             str: Generated summary
         """
@@ -670,5 +670,3 @@ class Agent(BaseModel):
             "session_add_message",
             {"role": "assistant", "content": assistant_content},
         )
-        
-

{quantalogic-0.2.10 → quantalogic-0.2.13}/quantalogic/agent_config.py

@@ -107,7 +107,7 @@ def create_full_agent(model_name: str, vision_model_name: str | None) -> Agent:
         Agent: An agent with the specified model and tools
 
     """
-    tools=[
+    tools = [
         TaskCompleteTool(),
         ReadFileTool(),
         ReadFileBlockTool(),

{quantalogic-0.2.10 → quantalogic-0.2.13}/quantalogic/coding_agent.py

@@ -18,7 +18,7 @@ from quantalogic.utils import get_coding_environment
 from quantalogic.utils.get_quantalogic_rules_content import get_quantalogic_rules_file_content
 
 
-def create_coding_agent(model_name: str,vision_model_name: str | None = None, basic: bool = False) -> Agent:
+def create_coding_agent(model_name: str, vision_model_name: str | None = None, basic: bool = False) -> Agent:
     """Creates and configures a coding agent with a comprehensive set of tools.
 
     Args:
@@ -69,7 +69,7 @@ def create_coding_agent(model_name: str,vision_model_name: str | None = None, ba
             LLMTool(
                 model_name=model_name,
                 system_prompt="You are a software expert, your role is to answer coding questions.",
-                name="coding_consultant",  # Handles implementation-level coding questions
+                name="coding_consultant",  # Handles implementation-level coding questions                
             )
         )
         tools.append(

{quantalogic-0.2.10 → quantalogic-0.2.13}/quantalogic/generative_model.py

@@ -107,7 +107,9 @@ class GenerativeModel:
     )
 
     # Retry on specific retriable exceptions
-    def generate_with_history(self, messages_history: list[Message], prompt: str, image_url: str | None = None) -> ResponseStats:
+    def generate_with_history(
+        self, messages_history: list[Message], prompt: str, image_url: str | None = None
+    ) -> ResponseStats:
         """Generate a response with conversation history and optional image.
 
         Generates a response based on previous conversation messages,
@@ -128,20 +130,17 @@ class GenerativeModel:
             Exception: For other unexpected errors.
         """
         messages = [{"role": msg.role, "content": str(msg.content)} for msg in messages_history]
-        
+
         if image_url:
-            messages.append({
-                "role": "user",
-                "content": [
-                    {"type": "text", "text": str(prompt)},
-                    {
-                        "type": "image_url",
-                        "image_url": {
-                            "url": image_url
-                        }
-                    }
-                ]
-            })
+            messages.append(
+                {
+                    "role": "user",
+                    "content": [
+                        {"type": "text", "text": str(prompt)},
+                        {"type": "image_url", "image_url": {"url": image_url}},
+                    ],
+                }
+            )
         else:
             messages.append({"role": "user", "content": str(prompt)})
 
@@ -249,7 +248,7 @@ class GenerativeModel:
             logger.debug(f"Model info retrieved: {model_info.keys()}")
         else:
             logger.debug("No model info available")
-            
+
         return model_info
 
     def get_model_max_input_tokens(self) -> int:

{quantalogic-0.2.10 → quantalogic-0.2.13}/quantalogic/main.py

@@ -2,6 +2,7 @@
 """Main module for the QuantaLogic agent."""
 
 # Standard library imports
+import random
 import sys
 from typing import Optional
 
@@ -9,6 +10,9 @@ from typing import Optional
 import click
 from loguru import logger
 
+from quantalogic.utils.check_version import check_if_is_latest_version
+from quantalogic.version import get_version
+
 # Configure logger
 logger.remove()  # Remove default logger
 
@@ -28,9 +32,10 @@ from quantalogic.agent_config import (  # noqa: E402
 )
 from quantalogic.interactive_text_editor import get_multiline_input  # noqa: E402
 from quantalogic.print_event import console_print_events  # noqa: E402
-from quantalogic.version import get_version  # noqa: E402
 
-AGENT_MODES = ["code", "basic", "interpreter", "full", "code-basic"]
+from quantalogic.search_agent import create_search_agent
+
+AGENT_MODES = ["code", "basic", "interpreter", "full", "code-basic","search"]
 
 
 def create_agent_for_mode(mode: str, model_name: str, vision_model_name: str | None) -> Agent:
@@ -47,9 +52,35 @@ def create_agent_for_mode(mode: str, model_name: str, vision_model_name: str | N
         return create_full_agent(model_name, vision_model_name)
     elif mode == "interpreter":
         return create_interpreter_agent(model_name, vision_model_name)
+    elif mode == "search":
+        return create_search_agent(model_name)
     else:
         raise ValueError(f"Unknown agent mode: {mode}")
 
+def check_new_version():
+    # Randomly check for updates (1 in 10 chance)
+    if random.randint(1, 10) == 1:
+        try:
+            current_version = get_version()
+            has_new_version, latest_version = check_if_is_latest_version()
+
+            if has_new_version:
+                console = Console()
+                console.print(
+                    Panel.fit(
+                        f"[yellow]⚠️  Update Available![/yellow]\n\n"
+                        f"Current version: [bold]{current_version}[/bold]\n"
+                        f"Latest version: [bold]{latest_version}[/bold]\n\n"
+                        "To update, run:\n"
+                        "[bold]pip install --upgrade quantalogic[/bold]\n"
+                        "or if using pipx:\n"
+                        "[bold]pipx upgrade quantalogic[/bold]",
+                        title="[bold]Update Available[/bold]",
+                        border_style="yellow",
+                    )
+                )
+        except Exception:
+            return
 
 def configure_logger(log_level: str) -> None:
     """Configure the logger with the specified log level and format."""
@@ -59,7 +90,7 @@ def configure_logger(log_level: str) -> None:
         level=log_level.upper(),
         format="<green>{time:YYYY-MM-DD HH:mm:ss.SSS}</green> | <level>{level: <8}</level> | <cyan>{process}</cyan> | <magenta>{file}:{line}</magenta> | {message}",
     )
-    logger.info(f"Log level set to: {log_level}")
+    logger.debug(f"Log level set to: {log_level}")
 
 
 def set_litellm_verbose(verbose_mode: bool) -> None:
@@ -192,17 +223,20 @@ def task(
     console = Console()
     switch_verbose(verbose, log)
 
+
     try:
         if file:
             task_content = get_task_from_file(file)
         else:
             if task:
+                check_new_version()
                 task_content = task
             else:
                 display_welcome_message(console, model_name, vision_model_name)
-                logger.info("Waiting for user input...")
+                check_new_version()
+                logger.debug("Waiting for user input...")
                 task_content = get_multiline_input(console).strip()
-                logger.info(f"User input received. Task content: {task_content}")
+                logger.debug(f"User input received. Task content: {task_content}")
                 if not task_content:
                     logger.info("No task provided. Exiting...")
                     console.print("[yellow]No task provided. Exiting...[/yellow]")
@@ -216,9 +250,17 @@ def task(
                     border_style="blue",
                 )
             )
-            if not Confirm.ask("[bold]Are you sure you want to submit this task?[/bold]"):
-                console.print("[yellow]Task submission cancelled. Exiting...[/yellow]")
-                sys.exit(0)
+        if not Confirm.ask("[bold]Are you sure you want to submit this task?[/bold]"):
+            console.print("[yellow]Task submission cancelled. Exiting...[/yellow]")
+            sys.exit(0)
+
+        console.print(
+            Panel.fit(
+                "[green]✓ Task successfully submitted! Processing...[/green]",
+                title="[bold]Status[/bold]",
+                border_style="green",
+            )
+        )
 
         logger.debug(f"Creating agent for mode: {mode} with model: {model_name}")
         agent = create_agent_for_mode(mode, model_name, vision_model_name=vision_model_name)
@@ -259,7 +301,7 @@ def task(
 
 
 def main():
-    """Entry point for the quantalogic CLI."""
+    """Main Entry point"""
     cli()
 
 

{quantalogic-0.2.10 → quantalogic-0.2.13}/quantalogic/print_event.py

@@ -1,12 +1,14 @@
 """Print events with rich formatting."""
 
+from typing import Any
+
 from rich import box
 from rich.console import Console
 from rich.panel import Panel
 from rich.tree import Tree
 
 
-def console_print_events(event: str, data: dict[str, any] = None):
+def console_print_events(event: str, data: dict[str, Any] | None = None):
     """Print events with rich formatting.
 
     Args:

quantalogic-0.2.13/quantalogic/search_agent.py

@@ -0,0 +1,41 @@
+from quantalogic.agent import Agent
+from quantalogic.tools import InputQuestionTool, SerpApiSearchTool, TaskCompleteTool, WikipediaSearchTool, ReadFileBlockTool,ReadFileTool, MarkitdownTool, RipgrepTool
+
+
+def create_search_agent(model_name: str) -> Agent:
+    """Creates and configures a search agent with web and knowledge search tools.
+
+    Args:
+        model_name (str): Name of the language model to use for the agent's core capabilities
+
+    Returns:
+        Agent: A fully configured search agent instance with:
+            - Web search capabilities (SerpAPI)
+            - Knowledge search capabilities (Wikipedia)
+            - Basic interaction tools
+    """
+    specific_expertise = (
+        "Search expert focused on web and knowledge search operations."
+        "Specializes in finding and summarizing information from various sources."
+    )
+
+    tools = [
+        # Search tools
+        SerpApiSearchTool(),  # Web search capabilities
+        WikipediaSearchTool(),  # Knowledge search capabilities
+        # Basic interaction tools
+        TaskCompleteTool(),  # Marks task completion
+        InputQuestionTool(),  # Handles user queries
+        # LLM tools
+        ReadFileBlockTool(),  # Reads specific file sections
+        ReadFileTool(),  # Reads entire file
+        MarkitdownTool(),  # Converts markdown to text
+        # Code search tools
+        RipgrepTool(),  # Code search capabilities
+    ]
+
+    return Agent(
+        model_name=model_name,
+        tools=tools,
+        specific_expertise=specific_expertise,
+    )