Skip to content

typesafe-sdk-java

Zero-dependency Java 21 client for System One with simple Question builders and typed answer accessors.

Librarybeta

Overview

kgonia's TypeSafe Java SDK is a zero-dependency client for the System One API, requiring Java 21+. You create a TypeSafeClient (closeable), pass state as a map and questions built with Question.noul, Question.choice and Question.score, and read typed answers: the yes probability for Noul, choice with probabilities and confidence, and score with legend, probabilities and confidence.

It is published to Maven Central at version 0.1.0 and reads TYPESAFE_API_KEY. The builder can pin a model version instead of the jev-latest alias, set per-attempt timeouts, retry policy, default headers and log level, all without adding dependencies. Configuration comes from TYPESAFE_API_KEY, TYPESAFE_DEFAULT_MODEL (default jev-latest) and TYPESAFE_LOG_LEVEL (default warn).

What the decision model decides

TypeQuestionAnswers
Yes / noIs this ticket about billing?yes · no
ChoiceWhat is the customer's tone?calm · frustrated · angry
ScoreHow urgent is this ticket?can wait · this week · today

How it works

  1. Add the Maven dependency.
  2. Create a client in try-with-resources.
  3. Call systemOne with state and questions.
  4. Read typed answers.

Strengths

  • No dependencies.
  • Simple API.

Caveats

  • Early version (0.1.0).
  • Community SDK; requires a key.

Getting started

Add io.github.kgonia:typesafe-sdk:0.1.0 and set TYPESAFE_API_KEY.

At a glance

Type
Library
Status
beta
Language
Java
Runtime
JVM library
Has code
yes

Use cases and integrations

How curated lists describe it

Frequently asked questions

Does it have dependencies?

No.

Which Java version?

Java 21 or newer.

Is it official?

No, it is a community SDK.

Related projects

  • Hack Club's lightweight LLM proxy, listed for adding a Jev forwarding endpoint behind its auth, limits and usage logging.

    MCP serverproductionTypeScript
  • Ax, a DSPy-style multi-language LLM framework, listed with a native TypeSafe provider for Boolean, Choice, Score and raw Jev questions.

    PluginproductionTypeScript
  • Effect TypeScript library whose @effect/ai-typesafe package maps classify, probability and rating operations to Jev questions.

    ProjectproductionTypeScript
  • PHP monorepo whose Polyglot module adds a TypeSafe driver for typed Noul, Choice and Score decisions alongside LLM inference.

    ProjectproductionPHP
  • Go MCP server giving any client typed Jev decisions via OpenRouter or TypeSafe, with validated answers and no paid retries.

    MCP serverproductionGo
  • Simon Willison's LLM plugin that adds Jev as a model for yes/no, choice and score questions from the command line.

    PluginproductionPython