Question 1

Is this an official TypeSafe SDK I can file support tickets against?

Accepted Answer

No. The repo marks itself unofficial and unaffiliated with TypeSafe AI, so treat it as community-maintained: pin the version, read the HexDocs, and report issues to the repo.

Question 2

How should I share one client across processes in an Elixir app?

Accepted Answer

Build once with TypeSafe.new and share the immutable client value, or start it under your supervision tree with a name; explicit options win over TYPESAFE_API_KEY, base URL, model, timeout, and retry settings.

Question 3

What does a failed Jev call look like in my supervision logs?

Accepted Answer

You get {:ok, result} with typed noul, choice, and score answers plus token usage and request id, or {:error, exception} with per-status structs; the bang variants raise instead.

Question 4

Does it retry on its own, and how do I test without network?

Accepted Answer

Yes for transient 408, 429, 5xx, and transport errors, with exponential backoff honoring Retry-After; set max_retries to 0 to disable, and stub HTTP in tests with the :plug option and Req.Test.

Question 5

How do I install it, and what does Hex give me?

Accepted Answer

Add `{:ex_typesafe_ai, "~> 0.2"}` to the deps list in mix.exs and set TYPESAFE_API_KEY in the environment. The package is published on Hex with HexDocs generated from ExDoc via `mix docs`, and it is MIT-licensed. Because it is unofficial and community-maintained, pin the version and read the generated docs rather than assuming parity with the first-party SDKs.

Question 6

How do I write the three question types, and is there an escape hatch?

Accepted Answer

Question.noul takes instructions for a yes/no question, Question.choice requires a criteria map of named labels, and Question.score requires a non-empty ordered criteria list acting as a rubric. Each returns a struct. You can also pass a raw map with a "type" key directly, which is the documented escape hatch for API fields the SDK has not modelled yet.

Question 7

What comes back in a response?

Accepted Answer

A TypeSafe.Response.SystemOne with answers keyed by your question names and grouped by type: response.nouls, response.choices and response.scores return Noul, Choice and Score structs. Alongside them are response.usage.input_tokens and response.request_id, taken from the x-typesafe-request-id header. TypeSafe.list_models returns a ListModels struct when you want to enumerate what the endpoint offers.

Ex TypeSafe AI

About this project

Highlights

Questions about this entry

More Jev resources like this

From the Jev guides

From the Jev community