What happens when the API adds an answer type this SDK does not model?

It is dropped with a warning so an older client keeps working, and you can reach the raw payload through result.HTTPResponse.

How do timeout and retries interact under a deadline?

Timeout applies per attempt with no separate retry budget, while a context deadline bounds the whole call including backoff. Pass a zero RetryPolicy to disable retries.

Is one client safe to share across goroutines?

Yes. The README states a Client is safe for concurrent use, with pooled connections and a context per request.

Will debug logs leak my API key?

Credential headers are redacted but bodies are not, so avoid debug level with real user data. Set TYPESAFE_LOG_LEVEL or pass your own logger with WithLogger.

How do I install it and make a first call?

It needs Go 1.26 or newer: go get serge.ax/go/typesafe-sdk-go. Set TYPESAFE_API_KEY, create a client with typesafe.New(), then call client.SystemOne with a context, a state string, and typesafe.Questions; read the answer with result.Choices()["category"].Choice. The import path and package name differ, so keep the typesafe alias.

How are questions typed and answers read back?

Mix Noul, Choice, and Score questions in one request; each answer comes back under the name you gave the question. result.Nouls()["billing"].Noul is the probability of yes, result.Choices()["tone"].Choice is the winning label with confidence and probabilities, and result.Scores()["urgency"].Score is the expected score, which may fall between levels.

What are the configuration precedence rules?

Options take precedence over environment variables, which take precedence over SDK defaults, and empty or whitespace-only environment values are ignored. WithAPIKey or TYPESAFE_API_KEY is required, TYPESAFE_BASE_URL sets the endpoint, TYPESAFE_DEFAULT_MODEL defaults to jev-latest, and TYPESAFE_LOG_LEVEL defaults to warn on standard error.

CommunityJev Repos & SDKs

TypeSafe SDK Go — SergeAx

Go SDK for TypeSafe AI that sends mixed noul, choice, and score questions in one SystemOne call, with retries, typed errors, and env-based configuration.

See highlights

Open github.com

Stars: 1
Language: Go
License: MIT
Published by: Community
Author: SergeAx
Last verified: Oct 2026

SergeAx/typesafe-sdk-go

User repository on GitHub

View on GitHub

TypeSafe.AI Go SDK

Forks: 1
Last pushed: Updated Sep 2026

Repo stats from the GitHub API, cached Oct 2026.

This is one of several Jev listings for the same project. The canonical entry is TypeSafe SDK Go — Tangerg.

About this project

Install the SDK (Go 1.26 or newer): Set TYPESAFEAPIKEY in your environment, then create and use the client: The import path and the package name differ, so the typesafe alias above is worth keeping for readability. Mix question types in one request; each answer comes back under the name you gave its question.

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

Tagscommunity github

Works forJev for Classification

Used inJev for Software & DevTools

Languages: Go

Highlights

Install with go get serge.ax/go/typesafe-sdk-go; import path and package name differ so alias as typesafe.
Client is safe for concurrent use with per-call model, timeout, retry, header, and extra-body overrides.
Retries twice by default with backoff and jitter for 408, 429, 5xx, honoring Retry-After up to a minute.
Typed errors separate config, API responses with request ID, validation, connection, and timeout failures.

Watch out

Requires TYPESAFE_API_KEY; debug logging includes bodies and unknown answer types are dropped with a warning. 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

jev

Go Unix CLI that pipes state on stdin into one Jev question — noul, choice, or score — across TypeSafe, Cloudflare, and Vercel providers, printing machine-readable JSON and signaling success by exit code.