Does Jev enforce permissions or decide what success means?

No. Jev only points at choices you supply. Available actions, permissions, and the definition of success come from your application, with the route emerging from successive choices.

Can I call the Gateway directly from browser code?

Do not. Keep the key in the Node process environment and expose your own server endpoint that streams decisions back; examples never autoload env files or ship keys to pages.

Will the file-search agent modify files or crawl forever?

No. The search agent has no write, rename, delete, copy, or execute operation, skips symlinks, confines paths to chosen roots, and bounds depth, points, and result counts.

Must I wait for a published npm release to try it?

No published release is assumed. Build from source on recent Node, install the local path into your project, and import the kernel plus the Gateway provider.

How do I run it locally?

Use Node.js 22 or newer and npm. Clone the repository, then npm ci and npm run build. Set AI_GATEWAY_API_KEY in the environment of your Node process, then run node examples/quick-start.js. The examples read the environment and do not load a .env file, and there is no offline or heuristic fallback.

What does the courier example demonstrate?

It gives Jev a four-place map, a notebook at the archive and a goal to bring the notebook home. Jev selects each action, then uses numbers to select adjacent places, and legal actions are rebuilt from actual state every turn. The program checks the delivered state, and a STOP before delivery returns done: false.

What does the file-search agent do?

It is a read-only search agent that navigates one or more real filesystem roots, selects pages and entries through numbered boards, backtracks through unexplored branches, and returns only paths that still exist when verified. It has no write, rename, delete, copy or execute operation, skips symbolic links, confines resolved paths to their root, and separates verified_results, search_exhausted, max_points and aborted outcomes.

CommunityJev Tools & CLIs

Jev One

JavaScript library for stateful Jev applications where choices name words, places, tools, or vocabularies, and code validates effects while the runtime carries observations forward.

See highlights

Open github.com

Stars: 1
Language: TypeScript
Published by: Community
Author: thezem
Last verified: Oct 2026

thezem/jev-one

User repository on GitHub

View on GitHub

A vocabulary-driven TypeScript runtime for safe, stateful applications powered by TypeSafe AI Jev.

Forks: 0
Last pushed: Updated Oct 2026

Repo stats from the GitHub API, cached Oct 2026.

About this project

Give Jev a language. Connect its choices to a world. Watch what happens. Jev One is a JavaScript library for building stateful applications around TypeSafe AI's Jev, a model that answers by pointing to choices you supply. A choice can mean a word, a place, an object, a tool, another vocabulary, or a request to stop. Your code gives that choice its effect. The runtime carries the observation into the next decision, until an objective is verified or a limit is reached.

Quoted from the project's README. Read the full README.

Tagscommunity github

Works forJev for Classification

Used inJev for Software & DevTools

Languages: TypeScript

Highlights

Vocabularies bind IDs to labels, meanings, and payloads; include uncertainty so forced choices do not mislead.
Courier loop rebuilds legal actions from actual state each turn and verifies delivery before reporting done.
Read-only file agent navigates numbered boards with backtracking and returns only paths verified to still exist.
Live use runs through the Vercel AI Gateway with a server-side key and no offline or heuristic fallback.

Watch out

Experimental library with live Gateway calls only; keep credentials server-side and never in browser code or logs. Copy reviewed against the repository README on 2026-10-04, not from running it.

Questions about this entry

Short answers drawn from the linked project or page.

More Jev resources like this

Jevest

GitHub Action that reviews pull requests with a read-only finder agent plus a refuting verifier, using Jev only to triage, route, label, and gate merging.