jev-php-sdk
Framework-agnostic PHP SDK for TypeSafe's System One API with typed Noul, Choice and Score answers, PSR-18 and Laravel support.
Overview
Jev SDK for PHP is a small community client for TypeSafe's System One API. You send state and typed questions and get back a chosen option, a score or the odds a statement is true, with no prose to parse. It works with any PSR-18 HTTP client such as Guzzle or Symfony HttpClient, in plain PHP, Laravel 8-13 or Symfony.
The README doubles as practical guidance: ask everything about one state in a single call since questions are answered in parallel; a yes/no answer has no separate confidence because its probability already carries it, so confidence() returns the distance from 0.5; always include an other option in choices; and scores can land between levels, with a nearestLevel() helper. It also discusses acting on calibrated confidence with thresholds.
What the decision model decides
| Type | Question | Answers |
|---|---|---|
| Yes / no | Is the writer complaining? | yes · no |
| Choice | Which team should answer this? | billing · technical · other |
| Score | How urgent is this? | can wait · this week · today |
How it works
- composer require mzainzulifqar/jev-php-sdk
- Create a Jev client with your API key
- Call ask with the state and typed questions
- Read choice, noul and score results and act on confidence
Strengths
- Works with any PSR-18 client and major frameworks
- Consistent confidence interface across question types
- Clear guidance on question design
Caveats
- Community package, not affiliated with TypeSafe
- Requires a TypeSafe API key
Getting started
composer require mzainzulifqar/jev-php-sdkAt a glance
- Type
- Library
- Status
- beta
- Language
- PHP
- Runtime
- Library (Laravel, Symfony or plain PHP)
- Has code
- yes
Use cases and integrations
How curated lists describe it
PHP SDK for TypeSafe's Jev: send text and typed questions, get typed answers with calibrated confidence. PHP 8.1+, works with any PSR-18 client, Laravel 8–13.
hellogumbo/awesome-jev
Frequently asked questions
Which frameworks are supported?
Any Composer project; Laravel 8-13 and Symfony work out of the box with their HTTP clients.
Why does a yes/no answer have no confidence?
Its probability already expresses certainty; confidence() returns the distance from 0.5.
Should I include an 'other' option?
Yes. Without it the model must pick a wrong answer from the options given.
Related projects
Ax, 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.
ProjectproductionPHPElixir library for unified LLM calls across providers, with an evaluate interface that calls Jev via TypeSafe or OpenRouter.
ProjectproductionElixirSelf-hosted multi-tenant AI agent platform listed as including optional TypeSafe client tools for classification, scoring and yes/no.
LibraryproductionPythonProvider-agnostic TypeScript AI SDK; per list sources, an @tanstack/ai-typesafe adapter exposes Jev decisions through decide().
ServiceproductionTypeScript