Update pkg/tooldiscovery/search.go

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: JoannaaKL

pkg/tooldiscovery/search.go

@@ -30,22 +30,19 @@ type SearchOptions struct {
 	MaxResults int `json:"maxResults"` // Maximum number of results to return (default: 3)
 }
 
-// Search returns the most relevant tools for a free-text query.
+// Search is a convenience wrapper for running a free-text tool search without
+// an explicit tool list.
 //
-// The search scans all tools in the local cache, assigns each tool a relevance
-// score based on how well its name, description, and parameters match the query,
-// and returns the highest-scoring results.
+// Currently, Search simply delegates to SearchTools with a nil tool slice:
+// it does not consult any cache or external inventory, and therefore
+// effectively performs no search unless and until tools are supplied by the
+// caller via SearchTools.
 //
-// Key behavior:
-//   - Matching strongly favors tool names, with softer boosts for descriptions,
-//     parameters, and fuzzy similarity.
-//   - Results are sorted by relevance, low-quality matches are filtered out,
-//     and the list is limited to MaxResults (default: 3).
-//   - Empty or whitespace-only queries return (nil, nil).
-//   - Errors listing servers abort the search; per-server read errors are skipped.
-//
-// Each SearchResult includes the tool, its score, and a short explanation of
-// where the match came from (MatchedIn) for debugging and tuning.
+// This function exists as a placeholder for potential future integrations
+// with a shared tool cache or inventory. Callers that already have a concrete
+// list of tools should prefer SearchTools, which scores and ranks the
+// provided tools by how well their names, descriptions, and parameters match
+// the query.
 func Search(query string, options ...SearchOptions) ([]SearchResult, error) {
 	return SearchTools(nil, query, options...)
 }