Question 1

Why not just use the other community .NET client?

Accepted Answer

They make opposite trade-offs on purpose. This one optimizes for a single dependency and faithful parity with the Python SDK, down to the same exception hierarchy and the same message text. TypeSafeAI.Net goes the other way: IHttpClientFactory integration, enum-typed choices, a QuestionSet builder with typed handles, and Microsoft.Extensions.AI middleware. Both speak the same API, so pick by the shape of your app.

Question 2

Will it work in a trimmed or AOT-published app?

Accepted Answer

Yes. It targets net8.0 and net10.0 and is trim and Native AOT compatible, with a smoke app published as a native binary and run on every build. For a response type of your own, pass source-generated JSON metadata; in a trimmed app you need to hand it a JsonTypeInfo rather than relying on reflection.

Question 3

Does it check my choice options against the documented limits before sending?

Accepted Answer

No, and that is deliberate parity with the Python SDK. 255 choice options and 2-10 score levels are API-side limits and come back as a TypeSafeUnprocessableEntityException naming the field. What is rejected locally is structural rather than schema: a null or missing state, an empty question set, a null question, an empty score rubric, and a raw question with no type.

Question 4

How do I register it in DI without breaking connection rotation?

Accepted Answer

Use the SDK's own handler as a singleton, which recycles pooled connections every two minutes and still follows DNS changes. If you need your host's handlers, such as a proxy, extra resilience or outbound logging, register through IHttpClientFactory as transient. A singleton built from the factory pins the one HttpClient it was given, quietly undoing the DNS refresh the factory exists to provide.

Question 5

What happens when an answer is missing or the wrong type?

Accepted Answer

It throws TypeSafeApiResponseValidationException naming the field. Derive from SystemOneResponse and declare answer-typed properties, and each is filled from the answer of the same name, matched by JsonPropertyName, then the property name exactly, then case-insensitive, then snake_case. Every such property is required; mark one [OptionalAnswer] to let it be absent without failing the whole response.

Question 6

What type do I use for state, instructions and criteria?

Accepted Answer

JsonContent everywhere the API takes text, an object or an array. It converts implicitly from string and from JsonNode, and From(value) serializes anything else, taking a JsonTypeInfo in a trimmed or AOT app. Nodes are deep-cloned in and out, so one JsonObject can appear in several questions and the same question can be sent repeatedly without System.Text.Json's single-parent rule throwing on second use.

Question 7

Are there runnable examples, and what license is it under?

Accepted Answer

MIT, and installed with dotnet add package Jev.Net as a community package not affiliated with TypeSafe AI. Three samples ship in the shape of TypeSafe's cookbooks: IntentRouting picks a handler and asks for each branch's argument speculatively in one round trip, ValueSelection lets code find every candidate amount so the model can only point at the total, and CompositeScoring re-ranks under new weights with no further calls. The tests run all three offline.

Jev Net

About this project

Highlights

Questions about this entry

More Jev resources like this

From the Jev guides

From the Jev community