Skip to content

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.

Librarybeta

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

TypeQuestionAnswers
Yes / noIs the writer complaining?yes · no
ChoiceWhich team should answer this?billing · technical · other
ScoreHow urgent is this?can wait · this week · today

How it works

  1. composer require mzainzulifqar/jev-php-sdk
  2. Create a Jev client with your API key
  3. Call ask with the state and typed questions
  4. 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-sdk

At 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.

    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
  • Elixir library for unified LLM calls across providers, with an evaluate interface that calls Jev via TypeSafe or OpenRouter.

    ProjectproductionElixir
  • Self-hosted multi-tenant AI agent platform listed as including optional TypeSafe client tools for classification, scoring and yes/no.

    LibraryproductionPython
  • Provider-agnostic TypeScript AI SDK; per list sources, an @tanstack/ai-typesafe adapter exposes Jev decisions through decide().

    ServiceproductionTypeScript