get_chunks
Retrieve specific chunks from a known document with filters: by content type, section, or entity mention. Use after search or find_methodology returned a relevant paper and you want more chunks from it without re-running search. Direct PG fetch — no vector search latency.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| detail | No | 'minimal' = section + summary only. 'standard' = + content. 'full' = + entities/selfContained/totalChunks | standard |
| run_id | No | Optional. The active methodist run_id (as returned by the methodist diagnose / get_current_dose door). Pass it whenever you call this tool while working inside a run, so the call is attributed to that run for the §8 usage crosscheck — attribution is run-anchored, so it stays correct even if your access token refreshes mid-run. Must be YOUR run: a run_id owned by a different principal, or a non-existent run_id, is rejected. | |
| section | No | Section name or path prefix (e.g. "Methods" or "3.") | |
| entities | No | Soft filter by entity (case-insensitive ANY match). Chunks mentioning a listed entity return first; chunks with NO entities recorded (legacy, ~23% of corpus) are included after as 'unknown' tier rather than dropped; only chunks that have entities none of which match are excluded. | |
| searchId | No | searchId from a prior search / search_keyword / search_semantic response. Required when chunkOrder=importance. | |
| chunkOrder | No | 'position' (default): document order. 'importance': search relevance order — requires searchId from a prior search response; falls back to position with a note when searchId is missing or expired. | position |
| documentId | Yes | Document UUID (from a prior search result) | |
| contentType | No | Soft filter chunks by type (methodology / results / theoretical / experimental / survey / background / other). Matched chunks return first; legacy chunks with NULL contentType are included as 'unknown' tier (sorted after matches) — they are not silently dropped. Chunks with an explicit different contentType are excluded. Response includes strictMatchedChunks + unknownChunksIncluded counts. |