feat(brains): api to get all brains

Author: ChrisCoder9000

src/adapters/data.py

@@ -76,3 +76,9 @@ def get_brain(self, name_key: str) -> Brain:
         Get a brain from the data client.
         """
         return self.data.get_brain(name_key)
+
+    def get_brains_list(self) -> List[Brain]:
+        """
+        Get the list of brains from the data client.
+        """
+        return self.data.get_brains_list()

src/adapters/interfaces/data.py

@@ -84,3 +84,10 @@ def get_brain(self, name_key: str) -> Brain:
         Get a brain from the data client.
         """
         raise NotImplementedError("get_brain method not implemented")
+
+    @abstractmethod
+    def get_brains_list(self) -> List[Brain]:
+        """
+        Get the list of brains from the data client.
+        """
+        raise NotImplementedError("get_brains_list method not implemented")

src/lib/mongo/client.py

@@ -144,5 +144,13 @@ def get_brain(self, name_key: str) -> Brain:
             return None
         return Brain(id=str(result["_id"]), name_key=result["name_key"])
 
+    def get_brains_list(self) -> List[Brain]:
+        collection = self.get_collection("brains", "system")
+        result = collection.find()
+        return [
+            Brain(id=str(result["_id"]), name_key=result["name_key"])
+            for result in result
+        ]
+
 
 _mongo_client = MongoClient()

src/services/api/app.py

@@ -19,6 +19,7 @@
 from src.services.api.routes.ingest import ingest_router
 from src.services.api.routes.retrieve import retrieve_router
 from src.services.api.routes.meta import meta_router
+from src.services.api.routes.system import system_router
 
 
 app = FastAPI()
@@ -36,6 +37,7 @@
 app.include_router(ingest_router)
 app.include_router(retrieve_router)
 app.include_router(meta_router)
+app.include_router(system_router)
 
 if __name__ == "__main__":
     run(app, host="0.0.0.0", port=8000, reload=os.getenv("ENV") == "development")

src/services/api/controllers/system.py

@@ -0,0 +1,20 @@
+"""
+File: /system.py
+Created Date: Monday December 1st 2025
+Author: Christian Nonis <[email protected]>
+-----
+Last Modified: Monday December 1st 2025 10:13:27 pm
+Modified By: the developer formerly known as Christian Nonis at <[email protected]>
+-----
+"""
+
+import asyncio
+from src.services.data.main import data_adapter
+
+
+async def get_brains_list():
+    """
+    Get the list of brains.
+    """
+    result = await asyncio.to_thread(data_adapter.get_brains_list)
+    return result

src/services/api/middlewares/brains.py

@@ -51,7 +51,7 @@ async def receive():
                 status_code=status.HTTP_400_BAD_REQUEST,
                 content={"detail": "System brain is not allowed to be used."},
             )
-        if not brain_id.isalnum():
+        if brain_id and not brain_id.isalnum():
             return JSONResponse(
                 status_code=status.HTTP_400_BAD_REQUEST,
                 content={"detail": "Brain ID must be alphanumeric."},

src/services/api/routes/system.py

@@ -0,0 +1,24 @@
+"""
+File: /system.py
+Created Date: Monday December 1st 2025
+Author: Christian Nonis <[email protected]>
+-----
+Last Modified: Monday December 1st 2025 10:12:48 pm
+Modified By: the developer formerly known as Christian Nonis at <[email protected]>
+-----
+"""
+
+from fastapi import APIRouter
+from src.services.api.controllers.system import (
+    get_brains_list as get_brains_list_controller,
+)
+
+system_router = APIRouter(prefix="/system", tags=["system"])
+
+
+@system_router.get(path="/brains-list")
+async def get_brains_list():
+    """
+    Get the list of brains.
+    """
+    return await get_brains_list_controller()