OptionalrangeHow much history to fetch, provider-specific (e.g. '1mo', '1y', '5y').
OptionaltimeoutPer-request timeout in milliseconds (default DEFAULT_TIMEOUT_MS). Without it a hung provider stalls the caller forever — reproduced in the 2026-07-31 audit: a silent socket hang kept the CLI waiting indefinitely.
The connector contract — providers are plugins, never core.
A connector knows how to turn one provider's API into the canonical dataset. Everything downstream (rules engine, comparison, reports) works on that schema and never learns where the data came from — except
source, which is mandatory provenance.