Use Jev for voice turn-taking

curl -sS https://router.flatkey.ai/api/alpha/decisions \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "typesafe/jev-1.13",
  "state": "Agent'\''s last prompt:\n  \"What day and time would you like the table?\"\n\nCaller transcript (silence 420 ms):\n  \"Table for four on, uh…\"\n\nTask: next_move (respond_now / keep_listening / backchannel), turn_complete, completeness.",
  "questions": {
    "next_move": {
      "type": "choice",
      "instructions": "The caller has just gone quiet on a voice call. Based only on the agent'\''s last prompt and the caller'\''s transcript so far, what should the voice agent do now?",
      "criteria": {
        "respond_now": "The caller has finished a complete request, answer, or question; the agent should start replying immediately",
        "keep_listening": "The utterance is clearly unfinished—trailing filler, a dangling preposition or conjunction, a list in progress, or a self-correction—so the agent should stay silent and wait",
        "backchannel": "The caller is mid-story or giving details in pieces; a short acknowledgement like \"mm-hm\" keeps them talking without taking the turn"
      }
    },
    "turn_complete": {
      "type": "noul",
      "instructions": "The caller has finished their turn and expects the agent to speak now—true only when the transcript reads as a complete thought that needs a reply."
    },
    "completeness": {
      "type": "score",
      "instructions": "How semantically complete is the caller'\''s utterance as an answer to the agent'\''s last prompt?",
      "criteria": [
        "low",
        "medium",
        "high"
      ]
    }
  }
}'

// Node.js 18+ (built-in fetch). Run: FLATKEY_API_KEY=... node jev.mjs
const body = {
  "model": "typesafe/jev-1.13",
  "state": "Agent's last prompt:\n  \"What day and time would you like the table?\"\n\nCaller transcript (silence 420 ms):\n  \"Table for four on, uh…\"\n\nTask: next_move (respond_now / keep_listening / backchannel), turn_complete, completeness.",
  "questions": {
    "next_move": {
      "type": "choice",
      "instructions": "The caller has just gone quiet on a voice call. Based only on the agent's last prompt and the caller's transcript so far, what should the voice agent do now?",
      "criteria": {
        "respond_now": "The caller has finished a complete request, answer, or question; the agent should start replying immediately",
        "keep_listening": "The utterance is clearly unfinished—trailing filler, a dangling preposition or conjunction, a list in progress, or a self-correction—so the agent should stay silent and wait",
        "backchannel": "The caller is mid-story or giving details in pieces; a short acknowledgement like \"mm-hm\" keeps them talking without taking the turn"
      }
    },
    "turn_complete": {
      "type": "noul",
      "instructions": "The caller has finished their turn and expects the agent to speak now—true only when the transcript reads as a complete thought that needs a reply."
    },
    "completeness": {
      "type": "score",
      "instructions": "How semantically complete is the caller's utterance as an answer to the agent's last prompt?",
      "criteria": [
        "low",
        "medium",
        "high"
      ]
    }
  }
};

const res = await fetch("https://router.flatkey.ai/api/alpha/decisions", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.FLATKEY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(body),
});
if (!res.ok) throw new Error(`Jev request failed: ${res.status} ${await res.text()}`);
const { answers, usage } = await res.json();
console.log(JSON.stringify(answers, null, 2), usage);

# Python 3.8+ (pip install requests). Run: FLATKEY_API_KEY=... python jev.py
import json, os, requests

body = json.loads(r"""{
  "model": "typesafe/jev-1.13",
  "state": "Agent's last prompt:\n  \"What day and time would you like the table?\"\n\nCaller transcript (silence 420 ms):\n  \"Table for four on, uh…\"\n\nTask: next_move (respond_now / keep_listening / backchannel), turn_complete, completeness.",
  "questions": {
    "next_move": {
      "type": "choice",
      "instructions": "The caller has just gone quiet on a voice call. Based only on the agent's last prompt and the caller's transcript so far, what should the voice agent do now?",
      "criteria": {
        "respond_now": "The caller has finished a complete request, answer, or question; the agent should start replying immediately",
        "keep_listening": "The utterance is clearly unfinished—trailing filler, a dangling preposition or conjunction, a list in progress, or a self-correction—so the agent should stay silent and wait",
        "backchannel": "The caller is mid-story or giving details in pieces; a short acknowledgement like \"mm-hm\" keeps them talking without taking the turn"
      }
    },
    "turn_complete": {
      "type": "noul",
      "instructions": "The caller has finished their turn and expects the agent to speak now—true only when the transcript reads as a complete thought that needs a reply."
    },
    "completeness": {
      "type": "score",
      "instructions": "How semantically complete is the caller's utterance as an answer to the agent's last prompt?",
      "criteria": [
        "low",
        "medium",
        "high"
      ]
    }
  }
}""")

res = requests.post(
    "https://router.flatkey.ai/api/alpha/decisions",
    headers={"Authorization": f"Bearer {os.environ['FLATKEY_API_KEY']}"},
    json=body,
    timeout=60,
)
res.raise_for_status()
data = res.json()
print(json.dumps(data["answers"], indent=2), data.get("usage"))

No Flatkey key yet? Get one for Jev 1.13 →