Compress a bloated tool output or long text so it fits a token budget while keeping what's relevant to an optional query. Returns a compact extract; the full output stays retrievable via the ref in its footer — call expand_tool_output with that ref to read it back.

Retrieve the full, uncompressed tool output behind a tooltrim reference (shown in a compressed result's footer as ref=XXXX). A compressed observation may have omitted fields you need — ids, amounts, individual list items, statuses. IMPORTANT: before you answer the user or take an action that depends on a compressed result, if any detail you need is not clearly present in it, call this tool with that ref to read the full output first. Returns a page of characters; use start/length to page through more.