feat: websearch tool added

Author: DataRohit

.github/workflows/publish.yml

@@ -34,7 +34,7 @@ jobs:
                   TAG_NAME="${{ github.event.release.tag_name }}"
                   if [ -z "$TAG_NAME" ]; then
                       echo "No release tag found. Generating dev version."
-                      VERSION="0.1.2.dev${{ github.run_number }}"
+                      VERSION="0.1.3.dev${{ github.run_number }}"
                   else
                       echo "GitHub Release Tag: $TAG_NAME"
                       VERSION=$(echo "$TAG_NAME" | sed 's/^v//')

nexus/tools/__init__.py

@@ -6,7 +6,8 @@
 from nexus.tools.file_ops import file_tools
 from nexus.tools.mode import mode_tools
 from nexus.tools.shell import shell_tools
+from nexus.tools.web_search import search_tools
 
-all_tools: list = file_tools + shell_tools + mode_tools
+all_tools: list = file_tools + shell_tools + mode_tools + search_tools
 
-__all__: list[str] = ["all_tools", "file_tools", "mode_tools", "shell_tools"]
+__all__: list[str] = ["all_tools", "file_tools", "mode_tools", "search_tools", "shell_tools"]

nexus/tools/web_search.py

@@ -0,0 +1,58 @@
+"""Web Search Tools.
+
+LangChain tools for web search functionality using DDGS.
+"""
+
+from typing import Annotated
+
+from ddgs import DDGS
+from langchain_core.tools import tool
+
+
+@tool
+def web_search(
+    query: Annotated[str, "Search query to execute"],
+    max_results: Annotated[int, "Maximum number of results to return"] = 5,
+) -> str:
+    """Web Search.
+
+    Execute a web search using DuckDuckGo and return formatted results.
+
+    Args:
+        query: str - The search query string.
+        max_results: int - Maximum number of results to return (default: 5).
+
+    Returns:
+        str - Formatted search results or error message.
+
+    Raises:
+        None
+    """
+
+    try:
+        results: list[str] = []
+        with DDGS() as ddgs:
+            search_results = ddgs.text(
+                keywords=query,
+                max_results=max_results,
+            )
+
+            for index, result in enumerate(search_results, start=1):
+                title = result.get("title", "No Title")
+                href = result.get("href", "No URL")
+                body = result.get("body", "No Description")
+                results.append(f"{index}. {title}\n   URL: {href}\n   {body}\n")
+
+        if not results:
+            return "No results found."
+
+        return "\n".join(results)
+
+    except Exception as e:  # noqa: BLE001
+        return f"Error performing web search: {e!s}"
+
+
+search_tools: list = [web_search]
+
+
+__all__: list[str] = ["search_tools", "web_search"]

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-nexus-cli"
-version = "0.1.2"
+version = "0.1.3"
 description = "Nexus is an autonomous CLI coding agent powered by LangGraph and MCP. It plans complex tasks, persists context via SQLite, and securely orchestrates tools. Features specialized Architect/Code modes, real-time metrics, and human-in-the-loop safety for production workflows."
 readme = "readme.md"
 requires-python = ">=3.14.2"
@@ -16,6 +16,7 @@ classifiers = [
 urls = { Homepage = "https://github.com/datarohit/nexus" }
 dependencies = [
     "aiosqlite==0.22.1",
+    "ddgs==9.10.0",
     "httpx==0.28.1",
     "langchain==1.2.7",
     "langchain-community==0.4.1",