Jev Agent Tools — npmjs.com

Run npm install @jkudish/jev-agent-tools. It requires Node.js 22 or newer. The package exports ask() plus the JevTransport type for callers that supply their own transport.

Four built-in carriers: TypeSafe, OpenRouter, Cloudflare, and Vercel AI Gateway. Auto-selection tries them in that order, and JEV_PROVIDER can be set to typesafe, openrouter, cloudflare, vercel, or auto to select strictly.

TYPESAFE_API_KEY with optional TYPESAFE_BASE_URL, OPENROUTER_API_KEY, JEV_CLOUDFLARE_API_TOKEN preferred over CLOUDFLARE_API_TOKEN plus CLOUDFLARE_ACCOUNT_ID, and AI_GATEWAY_API_KEY. With no provider configured, the diagnostic names every supported credential variable.

The call returns ok: false before any usage is credited, with codes such as answer_id_mismatch, invalid_distribution, invalid_noul, invalid_usage, or invalid_model. Transport failures return request_failed, rate_limited, or unavailable, and messages never include response bodies or credentials.

Yes. ask(input, { transport }) accepts any JevTransport with a name and an ask(input) returning answers, usage, and model, and the validator checks it exactly as it checks a built-in carrier. The built-in list itself is maintainer-curated, so new built-in carriers generally need demonstrated demand.

Set JEV_VERCEL_ZERO_DATA_RETENTION=1 or true to request Vercel's ZDR routing on every request; unset, empty, 0, or false leaves the body unchanged, and any other value is a configuration error before a request is sent. Use JEV_PROVIDER=vercel when every judgment must use that restriction.

It is MIT licensed and maintained by jkudish, with CI configured on GitHub. The built-in provider list is a fixed, maintainer-curated set; support for other providers is expected to arrive as third-party driver packages rather than new built-ins.