Skip to content

jev-docs

Unofficial, auto-synchronised history of Jev APIs, SDKs, agent skill and best practices tracked from official TypeSafe sources.

LibraryproductionMIT

This repository is mostly documentation or write-up rather than runnable code.

Overview

jev-docs is a community-maintained, unofficial reference that tracks the history of Jev and TypeSafe System One APIs, SDKs, agent guidance and engineering practices. A synchroniser watches only official sources: the docs llms.txt index and pages, the sitemap, the official typesafe-ai/skills agent skill, and the Python and JavaScript SDK repositories with their package metadata, tags and changelogs. TypeSafe's system-one-adapter-python is tracked separately as an evaluation tool.

Rather than copying the hosted documentation, which has no licence, it records URLs, metadata, hashes, timestamps and short excerpts. Readers get a concise BEST_PRACTICES.md for humans and coding agents, a MODEL_LIMITATIONS.md separating documented model weaknesses from the stable programming model, and state files listing official recipes by category and difficulty. It is useful for anyone needing to know what changed and when.

What the decision model decides

TypeQuestionAnswers
OtherWhat changed in Jev's documented APIs, SDKs and guidance over time?(inferred)—

How it works

  1. Synchroniser polls official TypeSafe sources
  2. Record metadata, hashes and small excerpts
  3. Regenerate state files and guides
  4. Publish best practices and model limitation notes

Strengths

  • Change history of official sources
  • Respects documentation licensing by not mirroring it
  • Agent-ready best-practices file

Caveats

  • Unofficial; does not speak for TypeSafe
  • Only tracks official sources, not community projects

Getting started

Read BEST_PRACTICES.md and MODEL_LIMITATIONS.md in the repository.

At a glance

Type
Library
Status
production
Runtime
Repository with synchroniser scripts
Has code
yes
License
MIT

Use cases and integrations

How curated lists describe it

Frequently asked questions

Is it official?

No, it is an unofficial community reference.

Does it copy TypeSafe's docs?

No. It records URLs, hashes and short excerpts because the hosted docs have no licence.

What should I read first?

BEST_PRACTICES.md, the concise guide for humans and coding agents.

Related projects

  • Server behind api.typesafe.pro, a free anonymous System One-compatible endpoint that forwards to TypeSafe on the operator's key.

    Serviceproduction
  • Browser form for building Jev requests from pasted text without hand-writing JSON, then rerunning to see how steady the answers are.

    ProjectbetaJavaScript
  • Terminal REPL for shaping System One requests before writing code, with lessons, a sketch editor, conversation turns and offline simulation.

    ServicebetaTypeScript
  • Nushell module for TypeSafe's System One API: pipe content in, ask noul, choice and score questions, and filter on the numbers.

    ServicebetaNushell
  • One-page playground and test bench for Jev with TypeSafe, OpenRouter, LLM-baseline and mock backends behind one /v1/systemone contract.

    ServiceprototypeTypeScript
  • Static browser interface for making structured Jev decisions through the Pollinations API, with multilingual READMEs.

    ServiceprototypeJavaScript