parse_document
Parses a study report into section spans with character offsets and an evidence cue survey, enabling ROBINS-I bias assessment. Accepts text or server-readable path; supplements optional.
Instructions
PRIMARY entry point: parse a study report into a bundle with character-offset, source-tagged section spans. Every quote you later cite is resolved against THIS text, and every claim of absence is searched in it.
PASS citation=: the full bibliographic reference in APA style. It appears
on the rendered assessment so the study being judged is unambiguous.
document is EITHER the raw text OR a file path — but the path must be
readable on the SERVER host. If your files live on your own filesystem, paste
the TEXT instead, or use parse_pmcid for an open-access PMCID. A path-looking
string the server cannot find raises rather than being ingested as its own
text.
PASS THE SUPPLEMENT WHEN YOU HAVE IT. supplements is a list of
server-readable paths merged as supplementary material. This matters more for
ROBINS-I than for a reporting audit: the target-trial specification that
settles C1-C4, and the analysis detail domains 1 and 4 turn on, routinely live
only in the appendix. Without it those questions read NI when the answer was
merely in a file nobody passed. supplement_status defaults to 'user_provided'
when supplements are given; pass 'none_exists' to assert the article has none.
Returns the section map, the text hash that keys later calls, and a cue survey — hit counts for the 15 evidence patterns, so you can see before reading where each domain's evidence lives and which absences already look real.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| citation | No | ||
| document | Yes | ||
| supplements | No | ||
| manuscript_id | No | ||
| supplement_status | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | ||
| n_pages | No | ||
| citation | No | ||
| sections | No | ||
| warnings | No | ||
| documents | No | ||
| full_text | No | ||
| next_step | No | ||
| cue_survey | No | ||
| text_sha256 | No | ||
| manuscript_id | No | ||
| extractor_version | No | ||
| supplement_status | No |