What a reader API should expose
The API surface should be small: input URL or HTML, output Markdown plus metrics. Complexity belongs inside the extraction layer, not in the consumer contract.
- Stable output format.
- Deterministic token counts.
- Structured errors when fetches fail or content is unsafe.