typesafe-sdk-ruby
Unofficial Ruby port of the official TypeSafe JavaScript SDK 0.6.0, with typed answers, retries, timeouts, cancellation and logging.
Overview
typesafe-sdk-ruby is a community-maintained Ruby client that ports the official JavaScript SDK (targeting version 0.6.0; Ruby release 0.6.0.1). It provides typed answer objects, retries, timeouts, cancellation and configurable logging, and reads TYPESAFE_API_KEY automatically.
It requires Ruby 3.1+, with CI testing Ruby 3.1 through 4.0. Version numbers track the JavaScript SDK, with a fourth component for Ruby-only fixes, and a changelog documents migrations. It is published on RubyGems. Some invalid requests raise TypeSafeError before any HTTP call, and the repository documents known upstream issues with evidence and limitations. Its examples include structured questions, such as a noul that separates an explicit cancellation request from a question about cancellation terms.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Choice | What is this ticket about? | billing · technical · other |
How it works
- gem install typesafe-sdk-ruby and set the key.
- Create Typesafe::SDK::Client.
- Call system_one with state and questions.
- Read typed answers.
Strengths
- Tracks the official JS SDK version.
- Broad Ruby version CI.
- Retries, timeouts and cancellation.
Caveats
- Unofficial port.
Getting started
gem install typesafe-sdk-rubyAt a glance
- Type
- Library
- Status
- beta
- Language
- Ruby
- Runtime
- library (gem)
- Has code
- yes
- Has tests
- yes
Use cases and integrations
How curated lists describe it
Unofficial Ruby SDK for the TypeSafe AI API (Jev model) - typed questions, retries, and typed errors. Community port of typesafe-sdk-js.
hellogumbo/awesome-jev
Frequently asked questions
What does it port?
The official JavaScript SDK, version 0.6.0.
Which Ruby versions are tested?
3.1, 3.2, 3.3, 3.4 and 4.0.
Is it official?
No.
Related projects
Hack Club's lightweight LLM proxy, listed for adding a Jev forwarding endpoint behind its auth, limits and usage logging.
MCP serverproductionTypeScriptAx, a DSPy-style multi-language LLM framework, listed with a native TypeSafe provider for Boolean, Choice, Score and raw Jev questions.
PluginproductionTypeScriptEffect TypeScript library whose @effect/ai-typesafe package maps classify, probability and rating operations to Jev questions.
ProjectproductionTypeScriptPHP monorepo whose Polyglot module adds a TypeSafe driver for typed Noul, Choice and Score decisions alongside LLM inference.
ProjectproductionPHPGo MCP server giving any client typed Jev decisions via OpenRouter or TypeSafe, with validated answers and no paid retries.
MCP serverproductionGoSimon Willison's LLM plugin that adds Jev as a model for yes/no, choice and score questions from the command line.
PluginproductionPython