quantalogic 0.2.12__tar.gz → 0.2.13__tar.gz

quantalogic-0.2.12/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.12/PKG-INFO → quantalogic-0.2.13/README.md

@@ -1,41 +1,3 @@
-Metadata-Version: 2.1
-Name: quantalogic
-Version: 0.2.12
-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: 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)
@@ -130,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.
 
@@ -141,6 +103,8 @@ Commands:
 ### Commands
 task    Execute a task with the QuantaLogic AI Assistant
 
+
+
 ### Detailed Usage
 
 #### Agent Modes
@@ -380,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                 |
 
 ---
 
@@ -788,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
 
@@ -1017,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.12 → quantalogic-0.2.13}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "quantalogic"
-version = "0.2.12"
+version = "0.2.13"
 description = "QuantaLogic ReAct Agents"
 authors = ["Raphaël MANSUY <raphael.mansuy@gmail.com>"]
 readme = "README.md"
@@ -34,6 +34,8 @@ 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.12 → quantalogic-0.2.13}/quantalogic/main.py

@@ -32,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:
@@ -51,6 +52,8 @@ 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}")
 

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,
+    )

{quantalogic-0.2.12 → quantalogic-0.2.13}/quantalogic/tools/__init__.py

@@ -17,12 +17,16 @@ from .read_file_tool import ReadFileTool
 from .replace_in_file_tool import ReplaceInFileTool
 from .ripgrep_tool import RipgrepTool
 from .search_definition_names import SearchDefinitionNames
+from .serpapi_search_tool import SerpApiSearchTool
 from .task_complete_tool import TaskCompleteTool
 from .tool import Tool, ToolArgument
 from .unified_diff_tool import UnifiedDiffTool
+from .wikipedia_search_tool import WikipediaSearchTool
 from .write_file_tool import WriteFileTool
 
 __all__ = [
+    "WikipediaSearchTool",
+    "SerpApiSearchTool",
     "Tool",
     "ToolArgument",
     "TaskCompleteTool",

quantalogic-0.2.13/quantalogic/tools/serpapi_search_tool.py

@@ -0,0 +1,169 @@
+"""Tool for interacting with SerpApi for search results."""
+
+import os
+
+from serpapi.google_search import GoogleSearch
+
+from quantalogic.tools.tool import Tool, ToolArgument
+
+
+class SerpApiSearchTool(Tool):
+    """Tool for retrieving paginated search results from SerpApi.
+
+    This tool provides a convenient interface to SerpAPI's search capabilities,
+    supporting pagination and structured result formatting.
+
+    Example usage:
+    ```python
+    tool = SerpApiTool()
+    results = tool.execute(
+        query="machine learning",
+        page=1,
+        num_results=10
+    )
+    print(results)
+    ```
+
+    The tool handles:
+    - Query validation
+    - Pagination management
+    - API error handling
+    - Result formatting
+    """
+
+    name: str = "serpapi_tool"
+    description: str = (
+        "Retrieves search results from SerpAPI (Google Search) with pagination support. "
+        "Handles multiple pages of results and provides structured output."
+    )
+    arguments: list = [
+        ToolArgument(
+            name="query",
+            arg_type="string",
+            description="The search query to execute",
+            required=True,
+            example="machine learning",
+        ),
+        ToolArgument(
+            name="page",
+            arg_type="int",
+            description="The page number to retrieve (1-based)",
+            required=True,
+            default="1",
+            example="2",
+        ),
+        ToolArgument(
+            name="num_results",
+            arg_type="int",
+            description="Number of results to retrieve per page",
+            required=True,
+            default="10",
+            example="20",
+        ),
+    ]
+
+    def execute(self, query: str, page: int = 1, num_results: int = 10) -> str:
+        """Execute a search query using SerpAPI and return results.
+
+        Args:
+            query: The search query to execute
+            page: The page number to retrieve (1-based)
+            num_results: Number of results to retrieve per page (1-100)
+
+        Returns:
+            Formatted search results as a string with the following format:
+            ==== Page X of results ====
+            1. Title
+               URL
+               Description
+            2. Title
+               URL
+               Description
+            ==== End of page X ====
+
+        Raises:
+            ValueError: If any parameter is invalid
+            RuntimeError: If API request fails or environment variable is missing
+        """
+        # Validate and convert query
+        if not query:
+            raise ValueError("Query must be a non-empty string")
+        try:
+            query = str(query)
+        except (TypeError, ValueError) as e:
+            raise ValueError(f"Query must be convertible to string: {str(e)}")
+
+        # Validate and convert page
+        try:
+            page = int(page)
+            if page < 1:
+                raise ValueError("Page number must be positive")
+        except (TypeError, ValueError) as e:
+            raise ValueError(f"Invalid page number: {str(e)}")
+
+        # Validate and convert num_results
+        try:
+            num_results = int(num_results)
+            if num_results < 1 or num_results > 100:
+                raise ValueError("Number of results must be between 1 and 100")
+        except (TypeError, ValueError) as e:
+            raise ValueError(f"Invalid number of results: {str(e)}")
+
+        api_key = os.getenv("SERPAPI_API_KEY")
+        if not api_key:
+            raise RuntimeError("SERPAPI_API_KEY environment variable is not set")
+
+        try:
+            params = {"q": query, "start": (page - 1) * num_results, "num": num_results, "api_key": api_key}
+
+            search = GoogleSearch(params)
+            results = search.get_dict()
+
+            if "error" in results:
+                raise RuntimeError(f"API error: {results['error']}")
+
+            # Format results
+            output = []
+            if "organic_results" in results:
+                for idx, result in enumerate(results["organic_results"], 1):
+                    output.append(f"{idx}. {result.get('title', 'No title')}")
+                    output.append(f"   {result.get('link', 'No URL')}")
+                    output.append(f"   {result.get('snippet', 'No description')}")
+                    output.append("")
+
+            if not output:
+                return "No results found"
+
+            # Add pagination info
+            output.insert(0, f"==== Page {page} of results ====")
+            output.append(f"==== End of page {page} ====")
+
+            return "\n".join(output)
+
+        except Exception as e:
+            raise RuntimeError(f"Search failed: {str(e)}")
+
+
+def main():
+    """Demonstrate SerpApiTool functionality."""
+    try:
+        tool = SerpApiSearchTool()
+
+        # Test basic search functionality
+        print("Testing SerpApiTool with sample query...")
+        results = tool.execute(query="Python programming", page=1, num_results=3)
+        print(results)
+
+        # Test error handling
+        print("\nTesting error handling with invalid query...")
+        try:
+            tool.execute(query="")
+        except ValueError as e:
+            print(f"Caught expected ValueError: {e}")
+
+    except Exception as e:
+        print(f"Error in main: {e}")
+
+
+if __name__ == "__main__":
+    main()

quantalogic-0.2.13/quantalogic/tools/wikipedia_search_tool.py

@@ -0,0 +1,169 @@
+from typing import Union
+
+"""Tool for interacting with Wikipedia API for search results."""
+
+import requests  # noqa: E402
+
+from quantalogic.tools.tool import Tool, ToolArgument  # noqa: E402
+
+
+class WikipediaSearchTool(Tool):
+    """Tool for retrieving paginated search results from Wikipedia.
+
+    This tool provides a convenient interface to Wikipedia's search API,
+    supporting pagination and structured result formatting.
+
+    Example usage:
+    ```python
+    tool = WikipediaSearchTool()
+    results = tool.execute(
+        query="machine learning",
+        page=1,
+        num_results=10
+    )
+    print(results)
+    ```
+
+    The tool handles:
+    - Query validation
+    - Pagination management
+    - API error handling
+    - Result formatting
+    """
+
+    name: str = "wikipedia_tool"
+    description: str = (
+        "Retrieves search results from Wikipedia with pagination support. "
+        "Handles multiple pages of results and provides structured output."
+    )
+    arguments: list = [
+        ToolArgument(
+            name="query",
+            arg_type="string",
+            description="The search query to execute",
+            required=True,
+            example="machine learning",
+        ),
+        ToolArgument(
+            name="page",
+            arg_type="int",
+            description="The page number to retrieve (1-based)",
+            required=True,
+            default="1",
+            example="2",
+        ),
+        ToolArgument(
+            name="num_results",
+            arg_type="int",
+            description="Number of results to retrieve per page (1-50)",
+            required=True,
+            default="10",
+            example="20",
+        ),
+    ]
+
+    def execute(self, query: str, page: Union[str, int] = 1, num_results: Union[str, int] = 10) -> str:
+        """Execute a search query using Wikipedia API and return results.
+        
+        Args:
+            query: The search query to execute
+            page: The page number to retrieve (1-based)
+            num_results: Number of results to retrieve per page (1-50)
+            
+        Returns:
+            Formatted search results as a string with the following format:
+            ==== Page X of results ====
+            1. Title
+               URL
+               Description
+            2. Title
+               URL
+               Description
+            ==== End of page X ====
+            
+        Raises:
+            ValueError: If any parameter is invalid
+            RuntimeError: If API request fails
+        """
+        if not query or not isinstance(query, str):
+            raise ValueError("Query must be a non-empty string")
+
+        try:
+            page = int(page) if str(page).strip() else 1
+            num_results = int(num_results) if str(num_results).strip() else 10
+        except (ValueError, TypeError) as e:
+            raise ValueError(f"Invalid parameter type: {e}. Expected integers for page and num_results")
+
+        if page < 1:
+            raise ValueError("Page number must be positive")
+            
+        if num_results < 1 or num_results > 50:
+            raise ValueError("Number of results must be between 1 and 50")
+            
+        try:
+            # Wikipedia API endpoint
+            url = "https://en.wikipedia.org/w/api.php"
+            params = {
+                "action": "query",
+                "format": "json",
+                "list": "search",
+                "srsearch": query,
+                "srlimit": num_results,
+                "sroffset": (page - 1) * num_results
+            }
+            
+            response = requests.get(url, params=params)
+            response.raise_for_status()
+            data = response.json()
+            
+            output = []
+            if "query" in data and "search" in data["query"]:
+                for idx, result in enumerate(data["query"]["search"], 1):
+                    title = result.get("title", "No title")
+                    snippet = result.get("snippet", "No description")
+                    url = f"https://en.wikipedia.org/wiki/{title.replace(' ', '_')}"
+                    
+                    output.append(f"{idx}. {title}")
+                    output.append(f"   {url}")
+                    output.append(f"   {snippet}")
+                    output.append("")
+            
+            if not output:
+                return "No results found"
+                
+            output.insert(0, f"==== Page {page} of results ====")
+            output.append(f"==== End of page {page} ====")
+            
+            return "\n".join(output)
+            
+        except Exception as e:
+            raise RuntimeError(f"Search failed: {str(e)}")
+
+
+def main():
+    """Demonstrate WikipediaSearchTool functionality."""
+    try:
+        tool = WikipediaSearchTool()
+        
+        # Test basic search functionality
+        print("Testing WikipediaSearchTool with sample query...")
+        results = tool.execute(
+            query="Python programming",
+            page=1,
+            num_results=3
+        )
+        print(results)
+        
+        # Test error handling
+        print("\nTesting error handling with invalid query...")
+        try:
+            tool.execute(query="")
+        except ValueError as e:
+            print(f"Caught expected ValueError: {e}")
+            
+    except Exception as e:
+        print(f"Error in main: {e}")
+
+
+if __name__ == "__main__":
+    main()

{quantalogic-0.2.12 → quantalogic-0.2.13}/quantalogic/utils/check_version.py

@@ -16,7 +16,7 @@ def check_if_is_latest_version() -> (bool,str|None):
         response = requests.get("https://pypi.org/pypi/quantalogic/json", timeout=5)
         response.raise_for_status()
         latest_version = response.json()["info"]["version"]
-        return version.parse(current_version) <= version.parse(latest_version), latest_version
+        return version.parse(current_version) < version.parse(latest_version), latest_version
     except (requests.RequestException, KeyError):
         return False, None