@kentcdodds/jev

@kentcdodds/jev

Intent

Call TypeSafe Jev (typesafe/jev) — a System One evaluation model — through Cloudflare AI Gateway, so other Kody packages can ask typed noul / choice / score questions and get calibrated answers. Reuses the same cloudflareApiToken and account/gateway setup as @kentcdodds/ai when local Jev storage is empty. Success means a tiny evaluate returns { ok, answers } without anyone pasting tokens into chat.

What it does

• Evaluate shared state against named questions (noul, choice, score)
• Return parsed answers, model, and usage
• Escape-hatch raw /ai/run for progressive disclosure
• Package storage for account/gateway ids, with fallback read from @kentcdodds/ai/settings

Prerequisites / setup

1. Save user secret cloudflareApiToken (do not paste the value in chat) with Workers AI access and host api.cloudflare.com (optional also gateway.ai.cloudflare.com if you already use @kentcdodds/ai):

   Create / update cloudflareApiToken

2. Set Cloudflare account id (and optionally gateway id) via this package's ./settings export — stored in package storage, no republish. If you already configured @kentcdodds/ai/settings, leave Jev storage empty: reads fall back to those values. Gateway defaults to kody.

3. AI Gateway Unified Billing — typesafe/jev is a third-party model on Cloudflare. The account needs AI Gateway credits (or BYOK for TypeSafe) or /ai/run returns HTTP 402 Insufficient balance.

4. Confirm readiness:

import overview from 'kody:@kentcdodds/jev'

export default async function main() {
  return await overview()
}

5. Smoke (live, cheap):

import smokeTest from 'kody:@kentcdodds/jev/smoke-test'

export default async function main() {
  return await smokeTest({ live: true })
}

Evaluate example

import evaluate from 'kody:@kentcdodds/jev/evaluate'

export default async function main() {
  return await evaluate({
    state: 'Help! My payouts have been failing for 3 days.',
    questions: {
      is_urgent: {
        type: 'noul',
        instructions: 'Does this convey urgency?',
        criteria: {
          true: 'Explicitly time-sensitive',
          false: 'No urgency expressed',
        },
      },
    },
  })
}

Auth / settings vs @kentcdodds/ai

Do not invent a second Cloudflare token secret for this package.

Alternate: Vercel AI Gateway

Vercel also exposes typesafe-ai/jev via AI SDK 7 experimental_evaluate. This package implements the Cloudflare path first to match @kentcdodds/ai. Prefer Cloudflare unless you already standardize on Vercel.

Docs: Cloudflare Jev · TypeSafe · Package

Done when

• cloudflareApiToken is saved with api.cloudflare.com host approval
• Account (and optional gateway) resolve via ./settings or @kentcdodds/ai
• Account has AI Gateway Unified Billing balance (or TypeSafe BYOK)
• ./smoke-test with { live: true } returns ok: true and a noul answer