Skip to content

typesafe-go (cole-gillespie)

Unofficial Go SDK for System One modeled on the official clients, with typed answers, retries and context cancellation.

LibrarybetaMIT

Overview

This unofficial Go SDK, inspired by the official TypeScript and Python clients, calls TypeSafe's System One API with no third-party dependencies (Go 1.22+). A SystemOneRequest takes state and a Questions map built with Choice, Score and Noul constructors, and typed accessors such as Answers.Choice return the label, probabilities and confidence.

It supports context timeouts and cancellation and retries, and the README shows a triage example that keeps the key out of shell history. It does not load .env files. It is MIT licensed and independently maintained. Typed accessors return errors when an answer is missing or of the wrong kind, and a triage example in the repository can be run against your own messages.

What the decision model decides

TypeQuestionAnswers
ChoiceWhich team should handle this?billing · technical · other
ScoreHow soon is attention needed?can wait · today · immediately
Yes / noDoes this request express urgency?yes · no

How it works

  1. Create a client with NewClient.
  2. Send a SystemOneRequest under a context deadline.
  3. Read typed answers.
  4. Act on them in Go code.

Strengths

  • No dependencies.
  • Context-aware with retries.

Caveats

  • Unofficial.
  • Requires a TypeSafe key.

Getting started

go get github.com/cole-gillespie/typesafe-go

At a glance

Type
Library
Status
beta
Language
Go
Runtime
library
Has code
yes
License
MIT

Use cases and integrations

How curated lists describe it

Frequently asked questions

Is it official?

No, it is independently maintained.

Does it read .env files?

No.

Which Go version is required?

Go 1.22 or newer.

Related projects

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

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

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

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

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

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

    PluginproductionPython