resolve_ref
Resolve fuzzy queries and nicknames into ranked candidate refs by checking exact slugs, aliases, and substrings.
Instructions
Resolve a fuzzy query ("the gateway", "gw", "auth-gw") to candidate refs.
Checks exact slug, exact alias, and case-insensitive name substring. Returns ranked candidates [{ref, source, score}] — call this before writing if the user refers to something by nickname or description.
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": {
"query": "<query>"
},
"name": "resolve_ref"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | free text. | |
| type_filter | No | optional — restrict to "component"|"repo"|"task"|"governance". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |