Jev TypeScript SDK: install, call, and read typed answers.

import { choice, noul, score, TypeSafeClient } from "@typesafe-ai/sdk";

const client = new TypeSafeClient();

const result = await client.systemOne({
  state: {
    subject: "Charged twice this month",
    body: "I see two $49 charges. Please fix this today.",
    customerPlan: "business",
  },
  questions: {
    queue: choice("Which queue should own this ticket?", {
      billing: "Charges, invoices, refunds, or payment methods",
      support: "Product usage or account help",
      security: "Suspicious access or compromised credentials",
    }),
    urgency: score("How urgent is the ticket?", [
      "Can wait",
      "Needs attention this week",
      "Needs attention today",
    ]),
    refundRequested: noul("Does the customer request a refund?", {
      true: "The customer explicitly asks for money back",
      false: "The customer asks only for investigation or correction",
    }),
  },
});

const queue = result.answers.queue.choice;
//    ^? "billing" | "support" | "security"

const queueProbability = result.answers.queue.probabilities[queue];
const urgency = result.answers.urgency.score;
const refundProbability = result.answers.refundRequested.noul;

console.log({
  queue,
  queueProbability,
  urgency,
  refundProbability,
  model: result.model,
  inputTokens: result.usage.input_tokens,
});

import {
  APIConnectionError,
  APIError,
  APIUserAbortError,
  noul,
  TypeSafeClient,
} from "@typesafe-ai/sdk";

const client = new TypeSafeClient();

export async function checkTicket(message: string) {
  const controller = new AbortController();
  const cancelTimer = setTimeout(() => controller.abort(), 5_000);

  try {
    return await client.systemOne(
      {
        state: { message },
        questions: {
          needsReview: noul("Does this ticket require human review?"),
        },
      },
      {
        signal: controller.signal,
        timeout: 10_000,
        retry: { maxRetries: 2 },
      },
    );
  } catch (error) {
    if (error instanceof APIUserAbortError) {
      throw new Error("Jev request exceeded the application time budget", {
        cause: error,
      });
    }

    if (error instanceof APIError) {
      console.error("TypeSafe API error", {
        status: error.status,
        requestId: error.requestId,
        body: error.body,
      });
      throw error;
    }

    if (error instanceof APIConnectionError) {
      console.error("Could not reach TypeSafe", error);
      throw error;
    }

    throw error;
  } finally {
    clearTimeout(cancelTimer);
  }
}

import { TypeSafeClient } from "@typesafe-ai/sdk";

const client = new TypeSafeClient({
  apiKey: process.env.TYPESAFE_API_KEY,
  baseURL: process.env.TYPESAFE_BASE_URL,
  defaultModel: process.env.TYPESAFE_DEFAULT_MODEL,
});