Skip to content

Building AI agents, atomically

add bocha web search tool

Jintao Weic0a4606c99a6
diff --git a/atomic-forge/tools/bocha_search/.coveragerc b/atomic-forge/tools/bocha_search/.coveragerc
new file mode 100644
index 0000000..c45136e
--- /dev/null
+++ b/atomic-forge/tools/bocha_search/.coveragerc
@@ -0,0 +1,8 @@
+[run]
+source = tool
+omit = */tests/*
+
+[report]
+exclude_lines =
+ if __name__ == "__main__":
+show_missing = True
diff --git a/atomic-forge/tools/bocha_search/README.md b/atomic-forge/tools/bocha_search/README.md
new file mode 100644
index 0000000..057ce5d
--- /dev/null
+++ b/atomic-forge/tools/bocha_search/README.md
@@ -0,0 +1,85 @@
+# BoCha Search Tool
+
+## Overview
+The BoCha Search Tool is a powerful utility within the Atomic Agents ecosystem that allows you to perform searches using BoCha, a search engine built for AI Agents. This tool enables you to fetch search results from BoCha.
+
+## Prerequisites and Dependencies
+- Python 3.9 or later
+- atomic-agents (See [here](/README.md) for installation instructions)
+- pydantic
+- requests
+
+## Installation
+You can install the tool using any of the following options:
+
+1. Using the CLI tool that comes with Atomic Agents. Simply run `atomic` and select the tool from the list of available tools. After doing so you will be asked for a target directory to download the tool into.
+2. Good old fashioned copy/paste: Just like any other tool inside the Atomic Forge, you can copy the code from this repo directly into your own project, provided you already have atomic-agents installed according to the instructions in the main [README](/README.md).
+
+## Configuration
+
+### Parameters
+
+- `api_url` (str): The api key of the BoCha user.
+- `max_results` (int, optional): The maximum number of search results to return.
+
+### Example
+
+```python
+config = BoChaSearchToolConfig(
+ api_key="my-api-key",
+ max_results=5
+)
+```
+
+## Input & Output Structure
+
+### Input Schema
+- `queries` (List[str]): List of search queries.
+
+### Output Schema
+- `results` (List[BoChaSearchResultItemSchema]): List of search result items.
+
+Each `BoChaSearchResultItemSchema` contains:
+- `name` (str): The title of the search result.
+- `url` (str): The URL of the search result.
+- `snippet` (str): The content snippet of the search result.
+- `query` (str): The query used to obtain this search result.
+
+
+## Usage
+
+Here's an example of how to use the BoCha Search Tool:
+
+
+```python
+import os
+from tool.bocha_search import BoChaTool, BoChaSearchToolConfig
+
+# Initialize the tool with your BoCha instance URL
+config = BoChaSearchToolConfig(api_key=os.getenv("BOCHA_API_KEY"), max_results=5)
+search_tool = BoChaTool(config=config)
+
+# Define input data
+input_data = BoChaTool.input_schema(
+ queries=["Python programming", "Machine learning"],
+)
+
+# Perform the search
+result = search_tool.run(input_data)
+print(result)
+```
+
+## Contributing
+
+Contributions are welcome! To contribute:
+
+1. Fork the repository.
+2. Create a new feature branch.
+3. Commit your changes with clear messages.
+4. Open a pull request detailing your changes.
+
+Please ensure you follow the project's coding standards and include tests for any new features or bug fixes.
+
+## License
+
+This project is licensed under the same license as the main Atomic Agents project. See the [LICENSE](/LICENSE) file in the repository root for more details.
diff --git a/atomic-forge/tools/bocha_search/pyproject.toml b/atomic-forge/tools/bocha_search/pyproject.toml
new file mode 100644
index 0000000..75e4d6e
--- /dev/null
+++ b/atomic-forge/tools/bocha_search/pyproject.toml
@@ -0,0 +1,34 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["tool"]
+
+[project]
+name = "bocha-search"
+version = "1.0.0"
+description = "A tool for performing searches using BoCha"
+readme = "README.md"
+authors = [
+ { name = "Jintao Wei", email = "[email protected]" }
+]
+requires-python = ">=3.12"
+dependencies = [
+ "atomic-agents",
+ "pydantic>=2.10.3,<3.0.0",
+ "aiohttp>=3.9.0,<4.0.0",
+]
+
+[dependency-groups]
+dev = [
+ "coverage>=7.6.1,<8.0.0",
+ "pytest>=8.3.3,<9.0.0",
+ "pytest-asyncio>=0.23.5,<1.0.0",
+ "pytest-cov>=5.0.0,<6.0.0",
+ "python-dotenv>=1.0.0,<2.0.0",
+ "rich>=13.7.0,<14.0.0",
+]
+
+[tool.uv.sources]
+atomic-agents = { workspace = true }
diff --git a/atomic-forge/tools/bocha_search/requirements.txt b/atomic-forge/tools/bocha_search/requirements.txt
new file mode 100644
index 0000000..e7586f3
--- /dev/null
+++ b/atomic-forge/tools/bocha_search/requirements.txt
@@ -0,0 +1,4 @@
+atomic-agents>=1.0.0,<2.0.0
+pydantic>=2.8.2,<3.0.0
+sympy>=1.12,<2.0.0
+aiohttp>=3.9.0,<4.0.0
\ No newline at end of file
diff --git a/atomic-forge/tools/bocha_search/tests/test_bocha_seach.py b/atomic-forge/tools/bocha_search/tests/test_bocha_seach.py
new file mode 100644
index 0000000..7047b1b
--- /dev/null
+++ b/atomic-forge/tools/bocha_search/tests/test_bocha_seach.py
@@ -0,0 +1,172 @@
+import os
+import sys
+import pytest
+from unittest.mock import patch, AsyncMock, MagicMock
+from types import SimpleNamespace
+
+sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
+
+from tool.bocha_search import ( # noqa: E402
+ BoChaSearchTool,
+ BoChaSearchToolInputSchema,
+ BoChaSearchToolConfig,
+ BoChaSearchToolOutputSchema,
+ BoChaSearchResultItemSchema,
+)
+
+
+def mock_aiohttp_session():
+ """Mock aiohttp.ClientSession for all tests"""
+ with patch("tool.bocha_search.aiohttp.ClientSession") as mock_session_class:
+ mock_session = MagicMock()
+
+ # Default mock response
+ mock_response = SimpleNamespace(
+ status=200,
+ json=AsyncMock(
+ return_value={
+ "data": {
+ "webPages": {
+ "value": [
+ {
+ "name": "Mock Title",
+ "url": "https://example.com",
+ "snippet": "Mock content",
+ }
+ ]
+ }
+ }
+ }
+ ),
+ )
+ mock_session.post.return_value.__aenter__.return_value = mock_response
+ mock_session_class.return_value.__aenter__.return_value = mock_session
+ yield mock_session
+
+
+async def test_bocha_search_tool_missing_fields(mock_aiohttp_session):
+ """Test that results missing required fields are skipped"""
+ mock_api_key = "KEY"
+ mock_query = "test query"
+ mock_response_data = {
+ "data": {
+ "webPages": {
+ "value": [
+ {"name": "Missing URL", "snippet": "Content"},
+ {"url": "https://example.com", "snippet": "Content"},
+ {"name": "Valid Result", "url": "https://example.com/valid", "snippet": "Valid content"},
+ ]
+ }
+ }
+ }
+
+ mock_aiohttp_session.post.return_value.__aenter__.return_value.json.return_value = mock_response_data
+
+ tool = BoChaSearchTool(BoChaSearchToolConfig(api_key=mock_api_key))
+ input_schema = BoChaSearchToolInputSchema(queries=[mock_query])
+
+ result: BoChaSearchToolOutputSchema = await tool.run_async(input_schema)
+
+ assert len(result.results) == 1
+ assert result.results[0].name == "Valid Result"
+
+
+def test_bocha_search_tool_sync_run(mock_aiohttp_session):
+ """Test the synchronous run method"""
+ mock_api_key = "KEY"
+ mock_query = "sync query"
+ mock_response_data = {
+ "data": {"webPages": {"value": [{"name": "Sync Result", "url": "https://example.com", "snippet": "Sync content"}]}}
+ }
+
+ mock_response = AsyncMock()
+ mock_response.status = 200
+ mock_response.json.return_value = mock_response_data
+ mock_aiohttp_session.post.return_value.__aenter__.return_value = mock_response
+
+ tool = BoChaSearchTool(BoChaSearchToolConfig(api_key=mock_api_key))
+ input_schema = BoChaSearchToolInputSchema(queries=[mock_query])
+ result = tool.run(input_schema)
+
+ assert len(result.results) == 1
+ assert result.results[0].name == "Sync Result"
+
+
+async def test_bocha_search_tool_max_results(mock_aiohttp_session):
+ """Test max_results parameter"""
+ mock_api_key = "KEY"
+ mock_query = "max results query"
+
+ mock_response_data = {
+ "data": {
+ "webPages": {
+ "value": [
+ {"name": f"Result {i}", "url": f"https://example.com/{i}", "snippet": f"Content {i}"} for i in range(10)
+ ]
+ }
+ }
+ }
+
+ mock_response = AsyncMock()
+ mock_response.status = 200
+ mock_response.json.return_value = mock_response_data
+ mock_aiohttp_session.post.return_value.__aenter__.return_value = mock_response
+
+ tool = BoChaSearchTool(BoChaSearchToolConfig(api_key=mock_api_key, count=10))
+ input_schema = BoChaSearchToolInputSchema(queries=[mock_query])
+
+ # Test limiting to 5 results
+ result = await tool.run_async(input_schema, max_results=5)
+ assert len(result.results) == 5
+
+ # Test default count from config
+ mock_aiohttp_session.post.reset_mock()
+ result2 = await tool.run_async(input_schema)
+ assert len(result2.results) == 10
+
+
+async def test_bocha_search_tool_no_results(mock_aiohttp_session):
+ """Test behavior when no results returned"""
+ mock_api_key = "KEY"
+ mock_query = "empty query"
+
+ mock_response_data = {"data": {"webPages": {"value": []}}}
+ mock_response = AsyncMock()
+ mock_response.status = 200
+ mock_response.json.return_value = mock_response_data
+ mock_aiohttp_session.post.return_value.__aenter__.return_value = mock_response
+
+ tool = BoChaSearchTool(BoChaSearchToolConfig(api_key=mock_api_key))
+ input_schema = BoChaSearchToolInputSchema(queries=[mock_query])
+ result = await tool.run_async(input_schema)
+
+ assert len(result.results) == 0
+
+
+async def test_bocha_search_tool_http_error(mock_aiohttp_session):
+ """Test that HTTP errors raise an exception"""
+ mock_api_key = "KEY"
+ mock_query = "error query"
+
+ mock_response = AsyncMock()
+ mock_response.status = 500
+ mock_response.reason = "Internal Server Error"
+ mock_response.text = AsyncMock(return_value="Server error")
+ mock_aiohttp_session.post.return_value.__aenter__.return_value = mock_response
+
+ tool = BoChaSearchTool(BoChaSearchToolConfig(api_key=mock_api_key))
+ input_schema = BoChaSearchToolInputSchema(queries=[mock_query])
+
+ with pytest.raises(Exception) as excinfo:
+ await tool.run_async(input_schema)
+
+ assert "Failed to fetch search results" in str(excinfo.value)
+
+
+if __name__ == "__main__":
+ pytest.main([__file__])
diff --git a/atomic-forge/tools/bocha_search/tool/bocha_search.py b/atomic-forge/tools/bocha_search/tool/bocha_search.py
new file mode 100644
index 0000000..d17564d
--- /dev/null
+++ b/atomic-forge/tools/bocha_search/tool/bocha_search.py
@@ -0,0 +1,187 @@
+import os
+from typing import List, Literal, Optional
+import asyncio
+from concurrent.futures import ThreadPoolExecutor
+
+import aiohttp
+from pydantic import Field
+
+from atomic_agents import BaseIOSchema, BaseTool, BaseToolConfig
+
+
+################
+# INPUT SCHEMA #
+################
+class BoChaSearchToolInputSchema(BaseIOSchema):
+ """
+ Schema for input to a tool for searching for information, news, references, and other content using BoCha.
+ Returns a list of search results with a short description or content snippet and URLs for further exploration
+ """
+
+ queries: List[str] = Field(..., description="List of search queries.")
+
+
+####################
+# OUTPUT SCHEMA(S) #
+####################
+class BoChaSearchResultItemSchema(BaseIOSchema):
+ """This schema represents a single search result item"""
+
+ name: str = Field(..., description="The title of the search result")
+ url: str = Field(..., description="The URL of the search result")
+ snippet: str = Field(None, description="The content snippet of the search result")
+ query: Optional[str] = Field(None, description="The query used to obtain this search result")
+
+
+class BoChaSearchToolOutputSchema(BaseIOSchema):
+ """This schema represents the output of the BoCha search tool."""
+
+ results: List[BoChaSearchResultItemSchema] = Field(..., description="List of search result items")
+
+
+##############
+# TOOL LOGIC #
+##############
+class BoChaSearchToolConfig(BaseToolConfig):
+
+ api_key: str = ""
+ freshness: str = "noLimit"
+ include: Optional[str] = None
+ exclude: Optional[str] = None
+ count: int = 10
+
+
+class BoChaSearchTool(BaseTool[BoChaSearchResultItemSchema, BoChaSearchToolOutputSchema]):
+ """
+ Tool for performing searches using the BoCha search API.
+
+ Attributes:
+ input_schema (BoChaSearchToolInputSchema): The schema for the input data.
+ output_schema (BoChaSearchToolOutputSchema): The schema for the output data.
+ count (int): The number of search results to return.
+ api_key (str): The API key for the BoCha API.
+ """
+
+ def __init__(self, config: BoChaSearchToolConfig = BoChaSearchToolConfig()):
+ """
+ Initializes the BoChaSearchTool.
+
+ Args:
+ config (BoChaSearchToolConfig):
+ Configuration for the tool, including API key, max results, and optional title and description overrides.
+ """
+ super().__init__(config)
+ self.api_key = config.api_key or os.getenv("BoCha_API_KEY", "")
+ self.count = config.count
+ self.freshness = config.freshness
+ self.include = config.include
+ self.exclude = config.exclude
+
+ async def _fetch_search_results(self, session: aiohttp.ClientSession, query: str) -> dict:
+ headers = {
+ "content-type": "application/json",
+ "Authorization": f"Bearer {self.api_key}",
+ }
+
+ json_data = {
+ "query": query,
+ "count": self.count,
+ "freshness": self.freshness,
+ "include": self.include,
+ "exclude": self.exclude,
+ }
+
+ async with session.post("https://api.bochaai.com/v1/web-search", headers=headers, json=json_data) as response:
+ if response.status != 200:
+ error_message = await response.text()
+ raise Exception(
+ f"Failed to fetch search results for query '{query}': {response.status} {response.reason}. Details: {error_message}"
+ )
+ data = await response.json()
+
+ results = data["data"]["webPages"]["value"]
+
+ # Add query information to each result
+ for result in results:
+ result["query"] = query
+
+ return {"results": results}
+
+ async def run_async(
+ self, params: BoChaSearchToolInputSchema, max_results: Optional[int] = None
+ ) -> BoChaSearchToolOutputSchema:
+ async with aiohttp.ClientSession() as session:
+ # Fetch results for all queries
+ tasks = [self._fetch_search_results(session, query) for query in params.queries]
+ raw_responses = await asyncio.gather(*tasks)
+
+ # Process results for each query
+ processed_results = []
+ for response in raw_responses:
+ query_results = response["results"]
+ query_processed = []
+ for result in query_results:
+ if all(key in result for key in ["name", "url", "snippet"]):
+ query_processed.append(
+ BoChaSearchResultItemSchema(
+ name=result["name"],
+ url=result["url"],
+ snippet=result.get("snippet", ""),
+ query=result.get("query"),
+ )
+ )
+ else:
+ print(f"Skipping result due to missing keys: {result}")
+
+ # Limit results per query
+ query_processed = query_processed[: max_results or self.count]
+ processed_results.extend(query_processed)
+
+ return BoChaSearchToolOutputSchema(results=processed_results)
+
+ def run(self, params: BoChaSearchToolInputSchema, max_results: Optional[int] = None) -> BoChaSearchToolOutputSchema:
+ """
+ Runs the BoChaTool synchronously with the given parameters.
+
+ This method creates an event loop in a separate thread to run the asynchronous operations.
+
+ Args:
+ params (BoChaSearchToolInputSchema): The input parameters for the tool, adhering to the input schema.
+ max_results (Optional[int]): The maximum number of search results to return.
+
+ Returns:
+ BoChaSearchToolOutputSchema: The output of the tool, adhering to the output schema.
+
+ Raises:
+ ValueError: If the base URL is not provided.
+ Exception: If the request to BOCha fails.
+ """
+ with ThreadPoolExecutor() as executor:
+ result = executor.submit(
+ asyncio.run,
+ self.run_async(
+ params,
+ max_results,
+ ),
+ ).result()
+
+ return result
+
+
+####
+# Main entry point for testing
+if __name__ == "__main__":
+ from rich.console import Console
+ from dotenv import load_dotenv
+
+ load_dotenv()
+ rich_console = Console()
+
+ search_tool_instance = BoChaSearchTool(config=BoChaSearchToolConfig(api_key="sk-**************", max_results=2))
+
+ # search_input = BoChaSearchToolInputSchema(queries=["北京天气怎么样?", "天津天气怎么样?", "杭州天气怎么样?"])
+ search_input = BoChaSearchToolInputSchema(queries=["Python programming", "Machine learning"])
+
+ output = search_tool_instance.run(search_input)
+
+ rich_console.print(output)
diff --git a/docs/guides/tools.md b/docs/guides/tools.md
index 39ae847..2a9bd49 100644
--- a/docs/guides/tools.md
+++ b/docs/guides/tools.md
@@ -19,6 +19,7 @@ The Atomic Forge includes several pre-built tools:
- **Tavily Search**: AI-powered web search
- **YouTube Transcript Scraper**: Extract transcripts from YouTube videos
- **Webpage Scraper**: Extract content from web pages
+- **BoCha Search**: web search
## Using Tools
diff --git a/uv.lock b/uv.lock
index f01c794..0651c51 100644
--- a/uv.lock
+++ b/uv.lock
@@ -24,6 +24,7 @@ members = [
"rag-chatbot",
"searxng-search",
"tavily-search",
+ "bocha_search",
"web-search-agent",
"webpage-scraper",
"youtube-summarizer",
@@ -216,6 +217,7 @@ dev = [
{ name = "myst-parser" },
{ name = "openai" },
{ name = "pdoc3" },
+ { name = "pre-commit" },
{ name = "pytest" },
{ name = "pytest-asyncio" },
{ name = "pytest-cov" },
@@ -250,6 +252,7 @@ dev = [
{ name = "myst-parser", specifier = ">=2.0.0,<3.0.0" },
{ name = "openai", specifier = ">=2.0.0,<3.0.0" },
{ name = "pdoc3", specifier = ">=0.11.1,<1.0.0" },
+ { name = "pre-commit", specifier = ">=4.0.0,<5.0.0" },
{ name = "pytest", specifier = ">=8.3.3,<9.0.0" },
{ name = "pytest-asyncio", specifier = ">=0.24.0,<1.0.0" },
{ name = "pytest-cov", specifier = ">=5.0.0,<6.0.0" },
@@ -1416,7 +1419,6 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/f8/0a/a3871375c7b9727edaeeea994bfff7c63ff7804c9829c19309ba2e058807/greenlet-3.3.0-cp312-cp312-macosx_11_0_universal2.whl", hash = "sha256:b01548f6e0b9e9784a2c99c5651e5dc89ffcbe870bc5fb2e5ef864e9cc6b5dcb", size = 276379, upload-time = "2025-12-04T14:23:30.498Z" },
{ url = "https://files.pythonhosted.org/packages/43/ab/7ebfe34dce8b87be0d11dae91acbf76f7b8246bf9d6b319c741f99fa59c6/greenlet-3.3.0-cp312-cp312-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:349345b770dc88f81506c6861d22a6ccd422207829d2c854ae2af8025af303e3", size = 597294, upload-time = "2025-12-04T14:50:06.847Z" },
{ url = "https://files.pythonhosted.org/packages/a4/39/f1c8da50024feecd0793dbd5e08f526809b8ab5609224a2da40aad3a7641/greenlet-3.3.0-cp312-cp312-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e8e18ed6995e9e2c0b4ed264d2cf89260ab3ac7e13555b8032b25a74c6d18655", size = 607742, upload-time = "2025-12-04T14:57:42.349Z" },
- { url = "https://files.pythonhosted.org/packages/77/cb/43692bcd5f7a0da6ec0ec6d58ee7cddb606d055ce94a62ac9b1aa481e969/greenlet-3.3.0-cp312-cp312-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:c024b1e5696626890038e34f76140ed1daf858e37496d33f2af57f06189e70d7", size = 622297, upload-time = "2025-12-04T15:07:13.552Z" },
{ url = "https://files.pythonhosted.org/packages/75/b0/6bde0b1011a60782108c01de5913c588cf51a839174538d266de15e4bf4d/greenlet-3.3.0-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:047ab3df20ede6a57c35c14bf5200fcf04039d50f908270d3f9a7a82064f543b", size = 609885, upload-time = "2025-12-04T14:26:02.368Z" },
{ url = "https://files.pythonhosted.org/packages/49/0e/49b46ac39f931f59f987b7cd9f34bfec8ef81d2a1e6e00682f55be5de9f4/greenlet-3.3.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:2d9ad37fc657b1102ec880e637cccf20191581f75c64087a549e66c57e1ceb53", size = 1567424, upload-time = "2025-12-04T15:04:23.757Z" },
{ url = "https://files.pythonhosted.org/packages/05/f5/49a9ac2dff7f10091935def9165c90236d8f175afb27cbed38fb1d61ab6b/greenlet-3.3.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:83cd0e36932e0e7f36a64b732a6f60c2fc2df28c351bae79fbaf4f8092fe7614", size = 1636017, upload-time = "2025-12-04T14:27:29.688Z" },
@@ -1424,7 +1426,6 @@ wheels = [
{ url = "https://files.pythonhosted.org/packages/02/2f/28592176381b9ab2cafa12829ba7b472d177f3acc35d8fbcf3673d966fff/greenlet-3.3.0-cp313-cp313-macosx_11_0_universal2.whl", hash = "sha256:a1e41a81c7e2825822f4e068c48cb2196002362619e2d70b148f20a831c00739", size = 275140, upload-time = "2025-12-04T14:23:01.282Z" },
{ url = "https://files.pythonhosted.org/packages/2c/80/fbe937bf81e9fca98c981fe499e59a3f45df2a04da0baa5c2be0dca0d329/greenlet-3.3.0-cp313-cp313-manylinux_2_24_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9f515a47d02da4d30caaa85b69474cec77b7929b2e936ff7fb853d42f4bf8808", size = 599219, upload-time = "2025-12-04T14:50:08.309Z" },
{ url = "https://files.pythonhosted.org/packages/c2/ff/7c985128f0514271b8268476af89aee6866df5eec04ac17dcfbc676213df/greenlet-3.3.0-cp313-cp313-manylinux_2_24_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:7d2d9fd66bfadf230b385fdc90426fcd6eb64db54b40c495b72ac0feb5766c54", size = 610211, upload-time = "2025-12-04T14:57:43.968Z" },
- { url = "https://files.pythonhosted.org/packages/79/07/c47a82d881319ec18a4510bb30463ed6891f2ad2c1901ed5ec23d3de351f/greenlet-3.3.0-cp313-cp313-manylinux_2_24_s390x.manylinux_2_28_s390x.whl", hash = "sha256:30a6e28487a790417d036088b3bcb3f3ac7d8babaa7d0139edbaddebf3af9492", size = 624311, upload-time = "2025-12-04T15:07:14.697Z" },
{ url = "https://files.pythonhosted.org/packages/fd/8e/424b8c6e78bd9837d14ff7df01a9829fc883ba2ab4ea787d4f848435f23f/greenlet-3.3.0-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:087ea5e004437321508a8d6f20efc4cfec5e3c30118e1417ea96ed1d93950527", size = 612833, upload-time = "2025-12-04T14:26:03.669Z" },
{ url = "https://files.pythonhosted.org/packages/b5/ba/56699ff9b7c76ca12f1cdc27a886d0f81f2189c3455ff9f65246780f713d/greenlet-3.3.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ab97cf74045343f6c60a39913fa59710e4bd26a536ce7ab2397adf8b27e67c39", size = 1567256, upload-time = "2025-12-04T15:04:25.276Z" },
{ url = "https://files.pythonhosted.org/packages/1e/37/f31136132967982d698c71a281a8901daf1a8fbab935dce7c0cf15f942cc/greenlet-3.3.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:5375d2e23184629112ca1ea89a53389dddbffcf417dad40125713d88eb5f96e8", size = 1636483, upload-time = "2025-12-04T14:27:30.804Z" },
@@ -4008,6 +4009,43 @@ dev = [
{ name = "rich", specifier = ">=13.7.0,<14.0.0" },
]
+[[package]]
+name = "bocha-search"
+version = "1.0.0"
+source = { editable = "atomic-forge/tools/bocha_search" }
+dependencies = [
+ { name = "aiohttp" },
+ { name = "atomic-agents" },
+ { name = "pydantic" },
+]
+
+[package.dev-dependencies]
+dev = [
+ { name = "coverage" },
+ { name = "pytest" },
+ { name = "pytest-asyncio" },
+ { name = "pytest-cov" },
+ { name = "python-dotenv" },
+ { name = "rich" },
+]
+
+[package.metadata]
+requires-dist = [
+ { name = "aiohttp", specifier = ">=3.9.0,<4.0.0" },
+ { name = "atomic-agents", editable = "." },
+ { name = "pydantic", specifier = ">=2.10.3,<3.0.0" },
+]
+
+[package.metadata.requires-dev]
+dev = [
+ { name = "coverage", specifier = ">=7.6.1,<8.0.0" },
+ { name = "pytest", specifier = ">=8.3.3,<9.0.0" },
+ { name = "pytest-asyncio", specifier = ">=0.23.5,<1.0.0" },
+ { name = "pytest-cov", specifier = ">=5.0.0,<6.0.0" },
+ { name = "python-dotenv", specifier = ">=1.0.0,<2.0.0" },
+ { name = "rich", specifier = ">=13.7.0,<14.0.0" },
+]
+
[[package]]
name = "tenacity"
version = "9.1.2"