What are the JavaScript SDK retry defaults?

maxRetries 2, 500ms backoff doubling to 5000ms, jitter 0.25, retrying HTTP 408, 429, and 500-599, and honoring Retry-After up to 60 seconds. Full defaults live in src/client.ts and src/types.ts rather than the README.

What does the question DSL export?

choice(), score(), and noul() helpers from @typesafe-ai/sdk, with answer types inferred from the questions you pass. Node.js 20 or newer is required, and the package ships ESM, CommonJS, and declarations.

How do I install and initialize the JavaScript SDK?

Run npm install @typesafe-ai/sdk on Node.js 20 or newer, set TYPESAFE_API_KEY in your environment, then construct new TypeSafeClient(); the README shows no constructor arguments.

Can the state be an object rather than a string?

Yes. The README passes state as { document: "I was charged twice. Please fix this ASAP." }, an object with a document field, rather than a plain string.

What package formats does the JavaScript SDK ship?

ESM, CommonJS, and TypeScript declarations, so it works from both import and require styles and carries its own type information.

What is the repository for the JavaScript SDK?

github.com/typesafe-ai/typesafe-sdk-js; the README points to src/client.ts and src/types.ts for the full API options and defaults.

How does the client return the chosen answer?

As a typed field on the response, so a choice question read as response.answers.category.choice returns the winning option string, with the type inferred from the choice() you passed.

Jev directory

OfficialJev Repos & SDKs

TypeSafe JavaScript / TypeScript SDK

Official TypeScript/JavaScript client with inferred answer types, retries, and a question DSL. `npm install @typesafe-ai/sdk`.

See highlights Open github.com

Stars: 279
Language: TypeScript
License: MIT
Reading time: 2 min
Published by: TypeSafe AI
Last verified: Sep 2026

typesafe-ai/typesafe-sdk-js

Organization repository on GitHub

View on GitHub

The official TypeScript/JavaScript library for the TypeSafe API

Forks: 43
Last pushed: Updated Oct 2026

Repo stats from the GitHub API, cached Oct 2026.

About this project

JavaScript and TypeScript SDK for TypeSafe AI. Install the SDK (Node.js 20 or newer): Set TYPESAFEAPIKEY in your environment, then create and use the client: Answer types are inferred from your questions. The package includes ESM, CommonJS, and TypeScript declarations. Learn what TypeSafe can do in the TypeSafe docs. See the SDK's client and types for API options and defaults.

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

Tagsofficial sdk typescript javascript

Works forJev for Scoring

Used inJev for Software & DevTools

Highlights

Install with npm install @typesafe-ai/sdk; Node.js 20 or newer is required and the package ships ESM, CommonJS, and TypeScript declarations.
Answer types are inferred from your questions; the README reads the winner as response.answers.category.choice.
The question DSL exports choice(), score(), and noul() helpers from @typesafe-ai/sdk.
Retry defaults: maxRetries 2, backoff 500ms doubling to 5000ms, jitter 0.25, retrying HTTP 408, 429, and 500-599, honoring Retry-After up to 60s.
The client picks up TYPESAFE_API_KEY from the environment; full option defaults live in src/client.ts and src/types.ts.

Quickstart

import { choice, TypeSafeClient } from "@typesafe-ai/sdk";
const client = new TypeSafeClient();
const response = await client.systemOne({
  state: { document: "I was charged twice. Please fix this ASAP." },
  questions: {
    category: choice("What is this ticket about?", { billing: null, technical: null, other: null }),
  },
});
console.log(response.answers.category.choice);

Watch out

The README is a quickstart only; retry behavior and full API options are documented in the source files and generated API reference, not on the GitHub landing page.

Questions about this entry

Short answers drawn from the linked project or page.

From the Jev guides

Original write-ups on what this entry is for.

The Open Reimplementations: Local Models That Speak System One

Sep 22, 2026

Closed weights have not stopped the ecosystem from rebuilding the shape in the open. API-compatible servers, retrained heads on small models, and inference-time tricks that skip generation entirely.

Jev Repos & SDKs#open-models#research#local

Read article

From the Jev AI model community

Posts from builders shipping with Jev right now.

Follow @typesafeai