User repository on GitHub
An unofficial, dependency-free Go (Golang) SDK for the TypeSafe System One API
- Forks
- 0
- Last pushed
- Updated Sep 2026
Repo stats from the GitHub API, cached Oct 2026.Homepage
Jev directory
CommunityJev Repos & SDKs
Typesafeai Go
An unofficial, dependency-free Go SDK for the System One API that uses only the standard library, validates question limits client-side, and retries rate limits and server errors.
- Stars
- 1
- Language
- Go
- License
- MIT
- Reading time
- 3 min
- Published by
- Community
- Author
- refaldyrk
- Last verified
- Sep 2026
About this project
An unofficial, dependency-free Go SDK for the TypeSafe System One API (API reference). System One evaluates a piece of content (state) against one or more typed questions and returns calibrated, probability-backed answers: Noul — a yes/no question, answered with a 0-1 probability. Choice — pick one option from a fixed set, with per-option probabilities and a confidence score. Score — rate content against an ordered list of descriptive levels.
Quoted from the project's README. Read the full README.
Works forJev for Scoring
Used inJev for Software & DevTools
Highlights
- Uses only the Go standard library, so nothing extra enters the dependency tree and nothing breaks on an upstream release.
- Validates Choice's 255-option limit and Score's 2-10 level bounds before a request ever leaves the process.
- Unknown answer types decode to RawAnswer instead of failing the whole response, so newer servers cannot break older clients.
- Retries 429 and 5xx responses, including TypeSafe's 529 overloaded status, with jittered exponential backoff honoring Retry-After.
- Typed errors mirror the JavaScript SDK hierarchy, including RateLimitError with RetryAfter and AuthenticationError for 401.
Quickstart
go
client, err := typesafe.NewClient()
resp, err := client.SystemOne(ctx, &typesafe.Request{
State: "Hi, I've been trying to connect my Stripe account for 3 days.",
Questions: map[string]typesafe.Question{
"is_urgent": typesafe.Noul{
Instructions: "The message conveys urgency or time-sensitivity.",
},
},
})
fmt.Println(resp.Answers["is_urgent"].(typesafe.NoulAnswer).Noul)Watch out
MIT-licensed. An unofficial SDK not affiliated with TypeSafe; requires Go 1.22 or newer and a TYPESAFE_API_KEY.
Questions about this entry
Short answers drawn from the linked project or page.
It adds client-side validation before a request leaves the process: the 255-option Choice limit and the 2-to-10 level bounds for Score. It also retries connection failures, timeouts, 429, and 5xx including the 529 overloaded status, with jittered backoff starting at 500 ms, capped at 8 s, honouring Retry-After.
It decodes to RawAnswer instead of failing the whole response, so a newer server cannot break an older client. The trade-off is that you have to handle it: the examples also show a blind type assertion that would panic on a mismatch, with a type switch offered as the safe alternative.
Yes. State and Instructions both accept a string or any JSON-serializable map or slice, and structured instructions can reference fields of a structured state using backtick notation, such as asking whether complaint_text warrants escalation given customer_tier.
Every error from SystemOne can be inspected with errors.As against a typed set mirroring the JavaScript SDK hierarchy: AuthenticationError, PermissionDeniedError, RateLimitError carrying RetryAfter, UnprocessableEntityError, and the rest. All HTTP-status errors wrap a shared APIError carrying StatusCode, Message, Code, Body, and Header.
go get github.com/refaldyrk/typesafeai-go, requires Go 1.22 or later; NewClient reads TYPESAFE_API_KEY, or pass WithAPIKey to set it explicitly. The key is only ever sent as a Bearer token over HTTPS and is never logged.
Every call takes a context.Context, so timeouts and cancellation are always yours to set rather than being fixed by the SDK.
Responses are decoded straight from the wire with no intermediate byte-slice buffering, and the underlying http.Client is reused and connection-pooled across calls; the README says each performance claim has a benchmark you can run.
More Jev resources like this
An unofficial, dependency-free Go SDK for Jev's System One API with direct TypeSafe and Vercel AI Gateway providers, an interactive CLI, and an installable agent skill that covers request and retry semantics.
Jev Repos & SDKs#community#go#sdk
Community
Stumble/jev-goGo
Stumble/jev-goGoA Go client for the TypeSafe System One API with zero dependencies outside the standard library: typed Noul, Choice and Score questions whose answers are read back through the handles that asked them.
Jev Repos & SDKs#community#catalog-import#logicrw
Community
2389-research/typesafe-goGo
2389-research/typesafe-goGoDependency-free Go 1.24+ client for Jev Noul, Choice, and Score questions: ChoiceOf[T] and ScoreOf[L] return the caller's own types and reject labels the question never offered, with validation before sending, retries that honor Retry-After, OpenRouter support, and eleven tested examples.
Jev Repos & SDKs#community#go#sdk
Community
HomayoonAlimohammadi/jev-sdk-goGo
HomayoonAlimohammadi/jev-sdk-goGoA small Go client for the System One API with typed Noul, Choice, and Score question structs, developed independently of the official Python and TypeScript SDKs.
Jev Repos & SDKs#community#sdk#go
Community
chez-shanpu/typesafeai-goGo
chez-shanpu/typesafeai-goGoA Go client for TypeSafe AI whose wire format and default retries follow the Python SDK v0.6.0 with a smaller Go-native API: send noul, choice and score questions in one SystemOne call and read typed results, usage counts and the request ID.
Jev Repos & SDKs#community#catalog-import#madewithjev
Community
radixils-dev/typesafe-sdk-goGo
radixils-dev/typesafe-sdk-goGoA hand-written Go client for the System One API, built against the vendored OpenAPI 3.1 specification with no third-party dependencies and typed Noul, Choice, and Score questions.
Jev Repos & SDKs#community#go#sdk
Community
mheers/typesafeai-systemone-jev-goGo
mheers/typesafeai-systemone-jev-goGoFrom the Jev guides
Original write-ups on what this entry is for.
From the Jev AI model community
Posts from builders shipping with Jev right now.