Route a support message in TypeScript.

// Recipe: Route a message. Classify a customer message into the department that should handle it.
// Requires Node.js 20+ and TYPESAFE_API_KEY in the environment.
//   npm install @typesafe-ai/sdk
// Source: https://jevguide.ai/recipes/message-routing. Not executed against the live API by Jev Guide.
import { choice, TypeSafeClient } from "@typesafe-ai/sdk";

const client = new TypeSafeClient(); // reads TYPESAFE_API_KEY, defaults to jev-latest

const message = "Hi, I was charged twice for my subscription this month. The two charges show up on my card statement on the 3rd and the 4th. Can you refund one of them?";

const { answers } = await client.systemOne({
  state: message,
  model: "jev-latest",
  questions: {
    department: choice(
      "Which department should handle this customer message?",
      {
        billing: "Charges, invoices, refunds, payment methods, subscription costs",
        account: "Login, password, profile, permissions, closing or changing an account",
        technical: "Bugs, errors, outages, integrations, something not working",
        sales: "Pricing questions, plan comparisons, upgrades, purchasing for a team",
        other: "Anything that does not fit the departments above",
      },
    ),
  },
});

const { choice: result, probabilities, confidence } = answers.department;

// Your code decides what to do with the answer.
if (confidence < 0.5) {
  console.log("Unsure. Route to a person.", probabilities);
} else {
  console.log("Route to " + result + " (confidence " + confidence.toFixed(2) + ")");
}

// Guide: typed response handling for the message-routing request.
// Requires Node.js 20+ and TYPESAFE_API_KEY in the environment.
//   npm install @typesafe-ai/sdk
// Source: https://jevguide.ai/guides/jev-typescript. Not executed against the live API by Jev Guide.
import { choice, TypeSafeClient } from "@typesafe-ai/sdk";

const client = new TypeSafeClient(); // reads TYPESAFE_API_KEY, defaults to jev-latest

const message = "Hi, I was charged twice for my subscription this month. Can you refund one of them?";

const { answers } = await client.systemOne({
  state: message,
  model: "jev-latest",
  questions: {
    department: choice("Which department should handle this customer message?", {
      billing: "Charges, invoices, refunds, payment methods, subscription costs",
      account: "Login, password, profile, permissions, closing or changing an account",
      technical: "Bugs, errors, outages, integrations, something not working",
      sales: "Pricing questions, plan comparisons, upgrades, purchasing for a team",
      other: "Anything that does not fit the departments above",
    }),
  },
});

const { choice: result, probabilities, confidence } = answers.department;

// TypeScript infers `result` as "billing" | "account" | "technical" | "sales" | "other"
// from the criteria keys passed to choice() above. No manual type annotation is needed.
function routeTo(department: typeof result): string {
  switch (department) {
    case "billing":
      return "billing-queue";
    case "account":
      return "account-queue";
    case "technical":
      return "technical-queue";
    case "sales":
      return "sales-queue";
    case "other":
      return "general-queue";
  }
}

// Missing a case above is a compile error here, not a silent runtime gap:
// the function must return a string on every path, and the switch is exhaustive
// only if every member of the union is handled.
console.log(routeTo(result), probabilities, confidence);

// Guide: error handling for the message-routing request.
// Requires Node.js 20+ and TYPESAFE_API_KEY in the environment.
//   npm install @typesafe-ai/sdk
// Source: https://jevguide.ai/guides/jev-typescript. Not executed against the live API by Jev Guide.
import { AuthenticationError, choice, RateLimitError, TypeSafeClient, TypeSafeError } from "@typesafe-ai/sdk";

const DEPARTMENT_CRITERIA = {
  billing: "Charges, invoices, refunds, payment methods, subscription costs",
  account: "Login, password, profile, permissions, closing or changing an account",
  technical: "Bugs, errors, outages, integrations, something not working",
  sales: "Pricing questions, plan comparisons, upgrades, purchasing for a team",
  other: "Anything that does not fit the departments above",
};

const client = new TypeSafeClient();
const message = "Hi, I was charged twice for my subscription this month. Can you refund one of them?";

try {
  const { answers } = await client.systemOne({
    state: message,
    model: "jev-latest",
    questions: {
      department: choice("Which department should handle this customer message?", DEPARTMENT_CRITERIA),
    },
  });
  console.log(answers.department.choice);
} catch (err) {
  if (err instanceof AuthenticationError) {
    console.error("Invalid or missing TYPESAFE_API_KEY.");
  } else if (err instanceof RateLimitError) {
    // The SDK has already retried with backoff by the time this is thrown.
    const wait = err.retryAfterMs === undefined ? "after a short delay" : `in ${err.retryAfterMs} ms`;
    console.error(`Rate limited. Retry ${wait}.`);
  } else if (err instanceof TypeSafeError) {
    console.error("Jev request failed:", err.message);
  } else {
    throw err;
  }
}