query
Runs tier-aware codebase lookups through manifest, keyword, then vector tiers, escalating only when earlier signals are weak to return relevant project context at lower cost.
Instructions
Tier-aware project query. Cheaper than `search_codebase`.
Routes through L0 (manifest), then L1 (BM25), then L2 (vector embeddings),
escalating only when the previous tier yields a weak signal.
Args:
text: Free-form query.
intent: "overview" | "lookup" | "semantic" | "deep".
- overview: L0 only — paths and symbols. Always sub-second.
- lookup: L0 + L1 — keyword/lexical search.
- semantic: L0 + L1 + L2 — pulls in embeddings if signal is weak.
- deep: L0 + L1 + L2 — relaxed thresholds, more results.
n_results: Final number of merged hits to return (1-50).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"text": "<text>"
},
"name": "query"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| intent | No | lookup | |
| n_results | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |