expand_result
Fetch the rest of a truncated result by supplying its ref, offset, and limit to page through the data. This retrieves the remaining items that a previous bounded view referenced.
Instructions
Fetch more of a result a previous tool showed you only a window of. Tools on this surface truncate the VIEW, never the DATA: when one prints a ref together with shown and total, the full result is held behind that ref and this is how you read the rest of it. Pass the ref plus offset and limit to page through it. Refs live in this server process only — they expire after 30 minutes and only the most recent handful are kept, so re-run the producing tool rather than storing a ref across sessions. A result that carried a secret is never retained and never has a ref, so nothing here can hand one back.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | Yes | The opaque handle a tool printed alongside its bounded view (res_ followed by 16 hex). Refs are per-process and short-lived — do not store one across sessions. | |
| limit | No | How many items to return, 100 by default and at most 1000. The window stays bounded even when expanded — page with offset rather than asking for everything at once. | |
| offset | No | Index of the first item to return. Defaults to 0. Page by adding the previous window's shown count. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | ||
| kind | No | ||
| error | No | ||
| items | No | ||
| shown | No | ||
| total | No | ||
| offset | No | ||
| status | Yes |