Is the output a real UUID v4?

No. The string uses the UUID layout and the version 4 marker, but the bytes come from Jev decisions, so it is not the standard v4 generation algorithm or a drop-in crypto.randomUUID() replacement.

Which providers can it use?

TypeSafe at api.typesafe.ai/v1/systemone with jev-latest, or OpenRouter at its decisions endpoint with typesafe/jev-1.13. The API key is sent only to the selected provider.

How are the bytes actually derived from the probabilities?

The prompt's Unicode code points are rearranged into 15 fixed variations, and for each Noul value p at zero-based index i it computes (Math.min(255, Math.floor(p * 256)) + i % 3) & 0xff. Those 15 bytes become 30 hex digits, combined with the version 4 marker and a Choice result of 8, 9, a or b for the variant bits.

What are the runtime requirements and failure modes?

Node.js 18.0.0 or later with native fetch and AbortSignal.timeout, ESM and CommonJS both supported with TypeScript declarations, and network access to the chosen provider. Each randomUUID call sends the original prompt and its variations, times out at 45 seconds with no automatic retries, and rejects on invalid input, network or HTTP errors, timeouts, invalid JSON, or missing or invalid decisions.

Is the output random enough to use for anything?

No, and the README says so plainly: it does not guarantee uniqueness or a uniform distribution and is unsuitable for secrets or security tokens. The same prompt may produce similar values, but neither repeatability nor similarity is guaranteed, and identical Jev decisions produce identical UUIDs with no extra randomness or hashing applied.

Where else is this usable, and what license applies?

Keep the API key on your server: browser, Bun and Deno compatibility is not verified. It is published on npm as jevcrypto under ISC, verified on Node.js 18.0.0 against a local test server with mocked responses, and development is pinned to a separate runtime. There is no automatic fallback between providers, so pick one explicitly.

What does the API surface look like, and what errors can I get?

new JevCrypto(apiKey, options?) then randomUUID(prompt) returning a Promise . The constructor requires a nonblank key and trims whitespace, randomUUID requires a nonblank string, preserves its whitespace and rejects unpaired Unicode surrogates. Non-2xx responses reject with TypeSafeHTTPError or OpenRouterHTTPError exposing a status property without the response body, while network and timeout errors propagate unchanged.

CommunityJev Tools & CLIs

JevCrypto

Novelty npm package whose crypto.randomUUID() look-alike sends 15 Noul questions plus one Choice to Jev and packs the returned probabilities into the bytes of a UUID v4-shaped string; explicitly not cryptographically random.

See highlights

Open github.com

Stars: 0
Language: TypeScript
License: ISC
Published by: Community
Last verified: Oct 2026

gignac-cha/jevcrypto

User repository on GitHub

View on GitHub

Generate prompt-influenced UUID strings with Jev through TypeSafe or OpenRouter.

Forks: 0
Last pushed: Updated Sep 2026

Repo stats from the GitHub API, cached Oct 2026.Homepage

About this project

Generate prompt-influenced UUID strings with a v4 marker using Jev. TypeSafe is the default provider; OpenRouter is also supported. Pass any question or sentence to randomUUID(). Jev evaluates variations of the prompt, and JevCrypto converts its numeric decisions into a UUID. The prompt does not need to ask for a UUID. Node.js 18.0.0 or later for the published JavaScript package; TypeScript execution support is not required. ESM and CommonJS are supported, with TypeScript declarations for both.

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

Tagscommunity npm uuid experiment

Works forJev for Classification

Used inJev for Software & DevTools

Languages: TypeScript
Capabilities: Open sourceRequires API key

Highlights

One request per randomUUID() call contains 15 Noul questions and one Choice; the timeout is 45 seconds with no automatic retries
Byte rule: (min(255, floor(p*256)) + i % 3) & 0xff per probability, then version 4 and the Choice result select the variant nibble
Supports TypeSafe direct (jev-latest) or OpenRouter (typesafe/jev-1.13); there is no automatic fallback between providers
Ships ESM and CommonJS builds with TypeScript declarations; verified on Node.js 18.0.0 with native fetch
Published on npm as jevcrypto under ISC; the README warns it is not an RFC 9562 implementation and not for secrets

Watch out

ISC license. Not cryptographically random and it promises neither uniqueness nor a uniform distribution, so it is unsuitable for secrets or security tokens; browser, Bun and Deno support is unverified.

Questions about this entry

Short answers drawn from the linked project or page.

More Jev resources like this

GenOffice

9.2k

An open-source AI office suite whose local file search reranks the top 20 FTS hits with TypeSafe Jev relevance scores before showing results.

Jev Tools & CLIs#community#typescript#desktop

Community

genspark-ai/genofficeTypeScript

Jev-Code-Reviewer

140

A local Chrome extension plus CLI that classifies each agent PR hunk as P0, P1, or P2 with Jev, showing P0 by default and human-readable diff summaries.

Jev Tools & CLIs#community#code-review#typescript

Community

egma-ai/jev-code-reviewerJavaScript

Pi TypeSafe Router

A Pi coding-agent extension that uses Jev to classify each request and route it to one of three configured models. Supports TypeSafe, Cloudflare AI Gateway, Vercel AI Gateway and OpenRouter backends, with doctor checks, shadow mode and an off-by-default setup.

Jev Tools & CLIs#community#coding-agents#routing

Community

jekozyra/pi-typesafe-routerTypeScript

decision-router

A CLI, Claude Code plugin and Pi extension that pick a model per task from one Jev call: a Choice over candidates asked in both orders plus a complexity Score that sets a minimum tier, with quota-aware filtering and fallback.

Jev Tools & CLIs#community#routing#claude-code

Community

Ruivalim/decision-routerTypeScript

TradingAgents

110.5k

Multi-agent trading research with optional Jev screening of StockTwits and Reddit posts for company relevance before sentiment analysis runs.

Jev Tools & CLIs#community#python#trading

Community

TauricResearch/TradingAgentsPython

XERJ

3.5k

An Elasticsearch-compatible autoindex search layer that optionally sends top hits to TypeSafe Jev and reorders results by relevance scores.

Jev Tools & CLIs#community#rust#search

Community

xerj-org/xerjRust

From the Jev guides

Original write-ups on what this entry is for.

Jev on the Gateways: Vercel, Workers AI, and OpenRouter

Oct 12, 2026

The request shape barely changes across surfaces; the surrounding contract does. When to call the API directly and when a gateway, a Worker binding, or a router entry earns its extra hop.

Jev Tools & CLIs#gateway#vercel#cloudflare

Read article

Exporting Decision Models: GGUF, ONNX, and Device Runtimes

Oct 10, 2026

Taking a decision checkpoint out of Python: what the GGUF and browser WebGPU exports preserve, what they change, and the parity evidence the model cards publish.

Jev Tools & CLIs#open-models#local#onnx

Read article

Records at Rest: Documents, Inboxes, and Risk Queues

Sep 28, 2026

Jev labels a record that already exists. Code moves, flags, or holds it. How the document, mail, and transfer tools keep the action out of the model.

Jev Tools & CLIs#classification#email#security

Read article

Back to all resources

From the Jev community

Posts from builders shipping with Jev right now.

Follow @typesafeai