Reshape function/method signatures across the public API so that secondary parameters must be passed as keyword arguments. Primary "subject" arguments stay positional.
This mirrors what was done in the Apify client: apify/apify-client-python#766.
Why
Keyword-only parameters at API boundaries make call sites self-documenting and prevent breakage when new options are added between existing arguments.
Reshape function/method signatures across the public API so that secondary parameters must be passed as keyword arguments. Primary "subject" arguments stay positional.
This mirrors what was done in the Apify client: apify/apify-client-python#766.
Why
Keyword-only parameters at API boundaries make call sites self-documenting and prevent breakage when new options are added between existing arguments.