Clarify prerequisite usage of get_data_sources in tool documentation.

Author: rodion-m

src/tools/chat.py

@@ -24,6 +24,10 @@ async def codebase_consultant(
     """
     Consult with an AI expert about your codebase for insights, explanations, and architectural guidance.
 
+    **PREREQUISITE**: You MUST call `get_data_sources` FIRST to discover available data source names,
+    UNLESS the user has explicitly provided specific data source names OR you are continuing an
+    existing conversation with a `conversation_id`.
+
     This consultant understands your entire codebase and can help with:
     - Architecture and design decisions
     - Implementation strategies

src/tools/datasources.py

@@ -12,7 +12,10 @@
 
 async def get_data_sources(ctx: Context, alive_only: bool = True) -> str:
     """
-    Gets all available data sources (repositories and workspaces) for the user's account.
+    **CALL THIS FIRST**: Gets all available data sources (repositories and workspaces) for the user's account.
+
+    This tool MUST be called BEFORE using `codebase_search` or `codebase_consultant` to discover
+    available data source names, UNLESS the user has explicitly provided data source names.
 
     A data source is a code repository or workspace that has been indexed by CodeAlive
     and can be used for code search and chat completions.

src/tools/search.py

@@ -24,6 +24,9 @@ async def codebase_search(
     """
     Use `codebase_search` tool to search for code in the codebase.
 
+    **PREREQUISITE**: You MUST call `get_data_sources` FIRST to discover available data source names,
+    UNLESS the user has explicitly provided specific data source names (e.g., "search in my-repo").
+
     Semantic search (`codebase_search`) is your MAIN exploration tool for understanding the
     indexed codebase (typically main/master branch or the specific branch shown in data sources).