npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@formio/uag-jev

v2.0.0

Published

TypeSafe Jev decision engine for the Form.io Universal Agent Gateway (UAG): fast, confidence-scored Choice, Score and yes/no decisions for the Agent API.

Readme

@formio/uag-jev

Form.io UAG › Engines › this page

The TypeSafe Jev decision engine for the UAG Agent API. It answers a task's closed-set fields (radio, select, checkbox, select boxes, survey and small resource selects) in one request, typically in 70–500 ms, with a confidence for each answer.

It is included in the formio/uag Docker image. With the UAG installed from npm, install it next to it:

npm install @formio/uag-jev

Enable it by naming it, and set its key:

UAG_ENGINES=jev
TYPESAFE_API_KEY=...

Decisions are Agentic Formflow, so on a self-hosted project the UAG also needs a LICENSE_KEY that includes the UAG for the project's endpoint (see Licensing); a project on Form.io's hosted service needs none.

Settings

| Setting | Variables | Default | |---|---|---| | apiKey | UAG_ENGINE_<NAME>_API_KEY, TYPESAFE_API_KEY | required (secret) | | model | UAG_ENGINE_<NAME>_MODEL, TYPESAFE_MODEL | jev-1.13.0 | | baseURL | UAG_ENGINE_<NAME>_BASE_URL, TYPESAFE_BASE_URL | the SDK's default |

<NAME> is the instance name, upper-cased with - as _. An instance's own variable wins over the shared one.

The SDK's request timeout follows the instance's routing timeout (routing.timeouts.<name>, else agentApi.timeout, else 30 seconds; always 30 seconds on an engine server), so its retries of rate-limit and overload responses never outlast it. After the timeout, the UAG falls back to the next engine.

Instances

Run a second Jev model next to the first, for example to compare a new version on live traffic before switching:

UAG_ENGINES=jev,next:jev
TYPESAFE_API_KEY=...
UAG_ENGINE_NEXT_MODEL=jev-1.14.0

Routing lists name the instances: routing.decision: ["next", "jev"].

Pin the model

Behavior differs between Jev versions. Keep model at a dated version, and run uag-eval on your own labeled examples before changing it or any threshold. uag-eval --engine jev works from a checkout of the UAG repository or inside the formio/uag image:

docker run --rm --entrypoint node -v "$PWD:/data" -e TYPESAFE_API_KEY -e LICENSE_KEY formio/uag \
  --no-node-snapshot bin/uag-eval.js --form /data/claim.json --examples /data/claim-examples.json \
  --engine jev --project <your project URL>

uag-eval needs a LICENSE_KEY that includes the UAG for that project's endpoint.

How it works

The UAG builds the questions and interprets the answers; this package only maps them to and from @typesafe-ai/sdk. Answers outside the options asked are dropped, and scores are kept within their levels. Jev's confidence is already normalized against an even split, which is what the UAG's confidence threshold expects, so it is passed on unchanged.

Errors: a refused API key (401, 403), a rate limit (429) and a TypeSafe server failure (5xx) reach API callers as that, with no response body; any other failure is reported only as "the engine failed". Retries never wait longer than the request timeout for a Retry-After.

Data residency: Jev is a hosted service. Each request sends TypeSafe:

  • the task's criteria and today's date;
  • the values at its uagContext paths;
  • its input fields, or, for a task with no input, the whole submission except the fields being decided.

Deployments that cannot send data there should not enable this engine; decision fields then fall back to an agent engine.

Logging: leave TYPESAFE_LOG_LEVEL unset (or warn) in production. At debug, the TypeSafe SDK writes each request and response body, which hold submission data, to the console.

Using it in your own server

Name it in configuration instead of UAG_ENGINES, with options that take precedence over the environment:

const server = new UAGServer({ engines: [{ name: 'jev', type: 'jev', options: { model: 'jev-1.13.0' } }] });

License: MIT.