Page, cancel or release a search
nas_search_resultsRetrieve more pages, cancel, or discard a NAS file search task started by nas_search_files, paginating with offset, sort_by and order so results neither overlap nor skip entries.
Instructions
Work with a search started by nas_search_files, identified by its task_id. action "page" returns another page: entries are in data.ordered_items[] (there is no results wrapper here, unlike nas_search_files). Pass the offset from the previous next_offset and the same sort_by and order as the original search, otherwise pages overlap or skip entries. The search is exhausted only when a page has no next_offset; do not use total_count to decide. "cancel" stops a search that is still running and keeps what was found. "remove" discards the stored search task and its results; it never touches any file. A task that was already removed reports "not found", which is not a failure worth retrying.
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": {
"task_id": "<task_id>"
},
"name": "nas_search_results"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Results per page (max 500). | |
| order | No | Sort direction. | |
| action | No | What to do with the search task. | page |
| offset | No | For "page": the next_offset of the previous page. | |
| sort_by | No | Sort key. Use the same sort_by and order on every page of one search. | name |
| task_id | Yes | data.task_id from nas_search_files. |