Jev API Integration Guide: 3 Production Endpoints & Protocol

// server/jev-typesafe.ts
// Native Endpoint: https://api.typesafe.ai/v1/systemone
export async function evaluateWithTypesafe(ticketText: string) {
  const apiKey = process.env.TYPESAFE_API_KEY;
  if (!apiKey) throw new Error('Missing TYPESAFE_API_KEY');

  const response = await fetch('https://api.typesafe.ai/v1/systemone', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${apiKey}`,
    },
    body: JSON.stringify({
      model: 'jev-latest',
      state: `Customer Ticket: "${ticketText}"`,
      questions: {
        intent: {
          type: 'choice',
          instructions: 'Classify incoming customer support intent',
          criteria: {
            billing: 'Subscription, invoice, or refund inquiries',
            technical: 'System bug, error code, or API issue',
            general: 'General inquiry or feature request',
          },
        },
      },
    }),
  });

  if (!response.ok) {
    const errorText = await response.text();
    throw new Error(`TypeSafe API failed [${response.status}]: ${errorText}`);
  }

  const result = await response.json();
  const decision = result.answers?.intent;

  return {
    selected: decision?.selected as 'billing' | 'technical' | 'general',
    confidence: decision?.confidence as number, // 0.0 ~ 1.0
    probabilities: decision?.probabilities as Record<string, number>,
    usage: result.usage,
  };
}