Jev Quickstart

TypeScript path · Node.js 20 or newer

1. 01

   Install

   Install the JavaScript SDK

   The official package includes TypeScript declarations. Run the example in your server-side Node.js application.

   TypeScriptCopy code

   npm install @typesafe-ai/sdk

2. 02

   API key

   Set your API key

   Create a key in the TypeSafe dashboard when your account has API access. Keep it in your server environment, never in browser code.

   TypeScriptCopy code

   export TYPESAFE_API_KEY="YOUR_KEY"

3. 03

   First Jev decision

   Ask one Choice question

   The SDK reads TYPESAFE_API_KEY and uses jev-latest by default. The question ID is category; its answer returns under the same ID.

   TypeScriptCopy code

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

4. 04

   Read the typed result

   Read the typed result

   A Choice answer contains choice, probabilities, and confidence. Here billing is an illustrative outcome; your actual result may differ.

   TypeScriptCopy code

   const category = response.answers.category.choice;
   // Example: "billing"

5. 05

   Use the decision in your application

   Route the ticket in application code

   Replace these handler names with your application's own functions. Keep routing policy in code.

   TypeScriptCopy code

   switch (category) {
     case "billing":
       await handleBilling(ticket);
       break;
     case "technical":
       await handleTechnical(ticket);
       break;
     default:
       await handleGeneral(ticket);
   }