How is attribute mode different from building requests by hand?

Attribute mode declares questions on the result class and evaluate fills an instance directly. Manual mode builds SystemOneRequest with fluent noul, choice, and score calls and reads answers through typed accessors.

Can I pass structured data or only strings?

Both. State and instructions accept strings, arrays, objects, or null, and option descriptions accept the same range. Objects are sent with private properties; convert to an array first for full control.

What happens on auth, bad-request, or rate-limit errors?

Timeouts, rate limits, and server errors retry at most twice; other failures throw Guzzle exceptions. Expect auth errors for bad keys, bad-request for malformed choices, and validation hints naming the failed field.

How do I debug or tune timeouts and headers?

Default timeout is 10 seconds, tunable through client options with extra headers and retry settings. Any PSR-3 logger attaches via setLogger, and examples run with the env key.

How do I install it and build a client?

Requires PHP 8.2 or later; install with composer require sanmai/typesafe-ai-php. Build the client with TypeSafeClient::createInstance($apiKey), or call createInstance() with no arguments to read TYPESAFE_API_KEY; if neither is set it throws InvalidArgumentException, and TYPESAFE_BASE_URL overrides the API root.

What do the three question types return, and how do I read them?

Noul gives the probability of yes between 0 and 1, Choice gives the winning option plus probabilities and confidence, and Score gives a probability-weighted position plus a legend, per-level probabilities, and confidence. Read them by id with accessors like $response->noul('is_urgent'); an accessor throws UnexpectedValueException when the id is missing or the type differs.

Can I define my own question classes?

Yes. SystemOneRequest::ask() accepts any object implementing the TypeSafeAI\Question\Question marker interface; the noul(), choice(), and score() methods are shortcuts for ask() with the bundled classes. Questions are plain data objects, and the client serializes their properties to JSON with nulls included.

CommunityJev Repos & SDKs

TypeSafe AI Php

PHP 8.2+ client for Jev that sends a state with typed noul, choice, and score questions and returns one typed answer per question ID with probabilities and usage.

See highlights

Open github.com

Stars: 15
Language: PHP
License: APACHE-2.0
Published by: Community
Author: sanmai
Last verified: Oct 2026

sanmai/typesafe-ai-php

User repository on GitHub

View on GitHub

Jev for PHP, TypeSafe AI PHP SDK

Forks: 2
Last pushed: Updated Oct 2026

Repo stats from the GitHub API, cached Oct 2026.Homepage

About this project

A PHP client for the TypeSafe AI evaluation model, Jev. Give Jev a state and a set of typed questions, get back one typed answer for each question. As easy as that. Tested on PHP 8.2 and later. Install with: There are three kinds of objects you work with: TypeSafeClient sends requests. Build it with the static createInstance() factory. SystemOneRequest retains the state/questions to evaluate. Easy to build using a fluent interface.

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

Tagscommunity jevbest catalog-import

Works forJev for Classification Jev for Ranking

Used inJev for Software & DevTools

Languages: PHP

Highlights

Fluent SystemOneRequest builder plus attribute-driven evaluate that fills result classes directly.
State and descriptions accept strings, arrays, objects, or null, with private properties sent for objects.
Result accessors expose probabilities, confidence, legends, resolved model, and token usage.
Retries timeouts, rate limits, and server errors twice; auth and validation errors surface as Guzzle exceptions.

Watch out

The key is optional but falls back to TYPESAFE_API_KEY and raises when neither is set; base URL override follows the JS and Python SDKs. Default model is jev-latest. Accessors throw on missing IDs or type mismatch. 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.

More Jev resources like this

TypeSafe

SwiftPM client for the TypeSafe System One API that mirrors the official JavaScript SDK, with typed Choice, Noul, and Score questions over Codable answers.