Skip to content
Metatext Decide — typed decisions for your agents, with a probability on every answerGet early access
Metatext
Sign Up

typesafe-sdk-go

Unofficial Go SDK for System One aiming for 1:1 parity with the official JS and Python SDKs, with generic typed decoding.

Librarybeta
View on GitHub ↗

Overview

valksor's typesafe-sdk-go is an idiomatic Go client for System One that aims for one-to-one feature parity with the official JavaScript and Python SDKs: the same wire contract, environment configuration, retry semantics, request metadata and typed errors. It requires Go 1.25+.

Features include typed Noul, Choice and Score questions and answers, a generic SystemOneAs[T] that decodes responses into your own structs, model discovery, per-attempt timeouts with exponential backoff, request IDs and raw metadata on every call, an injectable http.Client, status-specific errors usable with errors.As, and context cancellation throughout. It has CI and Go Report Card checks. Model discovery uses client.Models.List, and every call returns request IDs and raw response metadata for debugging.

What the decision model decides

TypeQuestionAnswers
ChoiceWhat is this ticket about?billing · technical · other

How it works

  1. go get the module and set TYPESAFE_API_KEY.
  2. Call SystemOne or SystemOneAs[T].
  3. Read typed answers or your decoded struct.
  4. Handle typed errors with errors.As.

Strengths

  • Parity with official SDKs.
  • Generic decoding into your own types.
  • Injectable HTTP client for tests.

Caveats

  • Unofficial.
  • Requires Go 1.25+.

Getting started

go get github.com/valksor/typesafe-sdk-go

At a glance

Type
Library
Status
beta
Language
Go
Runtime
library
Has code
yes
Has tests
yes

Use cases and integrations

How curated lists describe it

  • Unofficial Go SDK for the TypeSafe AI System One API — 1:1 parity with the official JS and Python SDKs. Not affiliated with TypeSafe AI.

    hellogumbo/awesome-jev

Frequently asked questions

What is SystemOneAs[T]?

A generic call that decodes the response into your own typed struct.

How close is it to the official SDKs?

It aims for 1:1 parity in contract, config, retries and errors.

Is it affiliated with TypeSafe?

No.

Related projects

  • ai

    Hack Club's lightweight LLM proxy, listed for adding a Jev forwarding endpoint behind its auth, limits and usage logging.

    MCP serverproductionTypeScript
  • Ax

    Ax, a DSPy-style multi-language LLM framework, listed with a native TypeSafe provider for Boolean, Choice, Score and raw Jev questions.

    PluginproductionTypeScript
  • Effect

    Effect TypeScript library whose @effect/ai-typesafe package maps classify, probability and rating operations to Jev questions.

    ProjectproductionTypeScript
  • instructor-php

    PHP monorepo whose Polyglot module adds a TypeSafe driver for typed Noul, Choice and Score decisions alongside LLM inference.

    ProjectproductionPHP
  • jev-mcp (freepik-company)

    Go MCP server giving any client typed Jev decisions via OpenRouter or TypeSafe, with validated answers and no paid retries.

    MCP serverproductionGo
  • llm-typesafe

    Simon Willison's LLM plugin that adds Jev as a model for yes/no, choice and score questions from the command line.

    PluginproductionPython