When should I use the OpenRouter client instead of TypeSafe direct?

Direct TypeSafe uses TYPESAFE_API_KEY and the default endpoint, while OpenRouter needs the openrouter() builder call, base URL https://openrouter.ai/api/v1/systemone and model typesafe/jev-1.13 with stricter schema.

How do I embed this if my app owns its HTTP stack?

Set TYPESAFE_USE_LIBCURL OFF, add the subdirectory, then implement the Transport interface or enable the Boost.Beast backend for Asio applications. Default builds include libcurl transport.

How do I tell a bad request from a retryable failure?

ValidationError means fix the request, AuthenticationError means fix the key, RateLimitError means back off, APIError covers service failures with 5xx retries, and APIConnectionError means unreachable.

Can I unit-test my calling code without network access?

Include typesafe/testing.h and inject RecordingTransport to capture request bodies and script canned responses with no network. The suite itself uses GoogleTest with injected transports.

How do I add the SDK to a CMake project?

add_subdirectory(typesafe-sdk-cpp) then target_link_libraries(your_target PUBLIC typesafe_cpp). It depends on nlohmann/json and uses a target you already define if present. As a subdirectory it builds only the library; its tests and examples run only when it is the top-level project.

How do I swap out the built-in HTTP transport?

The default build uses a built-in libcurl transport. Set TYPESAFE_USE_LIBCURL OFF and implement the typesafe::Transport interface, passing it to the builder with .transport(...). If you are already on Boost.Asio, set TYPESAFE_USE_BOOST_ASIO ON and use BoostTransport instead.

How do I test calling code with no network?

Include and inject a typesafe::testing::RecordingTransport to script responses and inspect what your code sent. It is header-only with no test-framework dependency; an empty response queue makes the next request throw APIConnectionError, and it is not synchronized, so use one per test.

CommunityJev Repos & SDKs

TypeSafe SDK Cpp — pewriebontal

C++20 SDK for TypeSafe AI that configures clients via Builder and types Choice, Score and Noul questions so answers arrive as fields, targeting System One models like Jev.

See highlights

Open github.com

Stars: 3
Language: C++
License: MIT
Published by: Community
Author: pewriebontal
Last verified: Oct 2026

pewriebontal/typesafe-sdk-cpp

User repository on GitHub

View on GitHub

An unofficial CPP 20 SDK for the TypeSafe API

Forks: 0
Last pushed: Updated Sep 2026

Repo stats from the GitHub API, cached Oct 2026.

About this project

A C++20 SDK for TypeSafe AI. It configures clients through a Builder and types every question (Choice, Score, Noul) so answers arrive as fields, not strings to parse. It targets System One models such as Jev. The SDK uses standard CMake. It depends on nlohmann/json.

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

Tagscommunity awesomejev catalog-import c++

Works forJev for Classification

Used inJev for Software & DevTools

Highlights

Builder client with typed Choice, Score and Noul questions plus probabilities and usage.
Pluggable transports: built-in libcurl, optional Boost.Beast, or custom Transport.
Eleven single-idea examples cover classification, triage, async and error handling.
Header-only recording transport enables offline tests of request and response handling.

Watch out

OpenRouter use needs instructions on every question and both Noul criteria fields, and listModels throws there. 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.

Other listings of this project

Forks and copies of this project in the directory. This entry is the canonical one.

typesafe-sdk-cpp

Unofficial C++23 client for the TypeSafe AI API ported from the community Rust SDK: send named noul, choice, and score questions over `POST /v1/systemone` and read typed answers.

Jev Repos & SDKs#community#github

Community

yunusey/typesafe-sdk-cppC++

More Jev resources like this

go-jev

Go SDK plus a pipeline-friendly CLI for typed decisions, covering single questions, batched question maps, retries, and line-oriented filtering over stdin.

Jev Repos & SDKs#community#jevbest#catalog-import

Community

mattn/go-jevGo

swift-jev

Swift library and CLI for asking Jev typed Choice, Noul, and Score questions from Apple platforms, with answers returned alongside calibrated probabilities in one parallel request.

Jev Repos & SDKs#community#jevbest#catalog-import

Community

d-date/swift-jevSwift

typesafe-sdk-go

Go SDK for the TypeSafe API that asks typed Noul, Choice, and Score questions about a state and returns probability distributions with confidence and typed accessors.

Jev Repos & SDKs#community#jevbest#catalog-import

Community

Tangerg/typesafe-sdk-goGo

JevSwiftSDK

Dependency-free Swift package for the System One HTTP API with typed Choice, Score, and Noul questions, batched evaluation, and reusable question sets.

Jev Repos & SDKs#community#awesomejev#catalog-import

Community

NSStudent/JevSwiftSDKSwift

zod-jev

Zod 4 companion that adds Jev meaning checks to shape checks: one parseAsync call sends every semantic rule as noul questions in a single request and turns probabilities into ordinary Zod issues.

Jev Repos & SDKs#community#jevbest#catalog-import

Community

jomatsu/zod-jevTypeScript

jevgo

Unofficial Go client for the TypeSafe System One API that sends a state plus typed Noul, Choice, and Score questions in one call and returns typed answers with model, usage, and request ID.

Jev Repos & SDKs#community#awesomejev#catalog-import

Community

devbackend/jevgoGo

From the Jev guides

Original write-ups on what this entry is for.

The Open Reimplementations: Local Models That Speak System One

Sep 22, 2026

Closed weights have not stopped the ecosystem from rebuilding the shape in the open. API-compatible servers, retrained heads on small models, and inference-time tricks that skip generation entirely.

Jev Repos & SDKs#open-models#research#local

Read article

Back to all resources

From the Jev community

Posts from builders shipping with Jev right now.

Follow @typesafeai