Use Jev for Claude Code agent cascades

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": "Planner (Opus): refactor auth middleware, then run unit tests.\nCurrent fork: batch of 12 tool calls proposed in one turn — 9 are duplicate glob/search on the same paths already read; 2 write the same file; 1 runs npm test.\nClosed options for this fork: approve batch / reject duplicates keep test / hand to Opus / stop.\nPolicy: spam or duplicate tool batches should not burn the loop; low-confidence forks escalate to Opus.\nTask: cascade (continue / handoff_opus / stop), difficulty, is_spam_or_noise, options_closed.",
  "questions": {
    "cascade": {
      "type": "choice",
      "instructions": "An agent loop hit a fork. Opus already planned the work. Where should this step go? Prefer continue when the options are closed and a cheap typed decision is enough; handoff_opus when the step needs deeper analysis or Jev would be guessing; stop when the step is spam, out of policy, or clearly should not proceed.",
      "criteria": {
        "continue": "Closed yes/no, tool pick or spam check Jev can answer; keep the cheap loop going without calling Opus",
        "handoff_opus": "Low confidence, ambiguous fork, or a hard planning/repair step that deserves the frontier planner",
        "stop": "Reject or end this branch: spam, policy block, or no permitted option fits"
      }
    },
    "difficulty": {
      "type": "score",
      "instructions": "How hard is this fork for a typed decision model alone?",
      "criteria": [
        "trivial_yes_no",
        "routine_tool_pick",
        "multi_factor",
        "frontier_only"
      ]
    },
    "is_spam_or_noise": {
      "type": "noul",
      "instructions": "This step is spam, noise, or a batch of tool calls that should not run (duplicative, irrelevant, or clearly abusive)."
    },
    "options_closed": {
      "type": "noul",
      "instructions": "The permitted options for this fork are fully listed in advance (approve/reject, which tool, spam or not) and none of them requires open-ended generation."
    }
  }
}'

// Node.js 18+ (built-in fetch). Run: FLATKEY_API_KEY=... node jev.mjs
const body = {
  "model": "typesafe/jev-1.13",
  "state": "Planner (Opus): refactor auth middleware, then run unit tests.\nCurrent fork: batch of 12 tool calls proposed in one turn — 9 are duplicate glob/search on the same paths already read; 2 write the same file; 1 runs npm test.\nClosed options for this fork: approve batch / reject duplicates keep test / hand to Opus / stop.\nPolicy: spam or duplicate tool batches should not burn the loop; low-confidence forks escalate to Opus.\nTask: cascade (continue / handoff_opus / stop), difficulty, is_spam_or_noise, options_closed.",
  "questions": {
    "cascade": {
      "type": "choice",
      "instructions": "An agent loop hit a fork. Opus already planned the work. Where should this step go? Prefer continue when the options are closed and a cheap typed decision is enough; handoff_opus when the step needs deeper analysis or Jev would be guessing; stop when the step is spam, out of policy, or clearly should not proceed.",
      "criteria": {
        "continue": "Closed yes/no, tool pick or spam check Jev can answer; keep the cheap loop going without calling Opus",
        "handoff_opus": "Low confidence, ambiguous fork, or a hard planning/repair step that deserves the frontier planner",
        "stop": "Reject or end this branch: spam, policy block, or no permitted option fits"
      }
    },
    "difficulty": {
      "type": "score",
      "instructions": "How hard is this fork for a typed decision model alone?",
      "criteria": [
        "trivial_yes_no",
        "routine_tool_pick",
        "multi_factor",
        "frontier_only"
      ]
    },
    "is_spam_or_noise": {
      "type": "noul",
      "instructions": "This step is spam, noise, or a batch of tool calls that should not run (duplicative, irrelevant, or clearly abusive)."
    },
    "options_closed": {
      "type": "noul",
      "instructions": "The permitted options for this fork are fully listed in advance (approve/reject, which tool, spam or not) and none of them requires open-ended generation."
    }
  }
};

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": "Planner (Opus): refactor auth middleware, then run unit tests.\nCurrent fork: batch of 12 tool calls proposed in one turn — 9 are duplicate glob/search on the same paths already read; 2 write the same file; 1 runs npm test.\nClosed options for this fork: approve batch / reject duplicates keep test / hand to Opus / stop.\nPolicy: spam or duplicate tool batches should not burn the loop; low-confidence forks escalate to Opus.\nTask: cascade (continue / handoff_opus / stop), difficulty, is_spam_or_noise, options_closed.",
  "questions": {
    "cascade": {
      "type": "choice",
      "instructions": "An agent loop hit a fork. Opus already planned the work. Where should this step go? Prefer continue when the options are closed and a cheap typed decision is enough; handoff_opus when the step needs deeper analysis or Jev would be guessing; stop when the step is spam, out of policy, or clearly should not proceed.",
      "criteria": {
        "continue": "Closed yes/no, tool pick or spam check Jev can answer; keep the cheap loop going without calling Opus",
        "handoff_opus": "Low confidence, ambiguous fork, or a hard planning/repair step that deserves the frontier planner",
        "stop": "Reject or end this branch: spam, policy block, or no permitted option fits"
      }
    },
    "difficulty": {
      "type": "score",
      "instructions": "How hard is this fork for a typed decision model alone?",
      "criteria": [
        "trivial_yes_no",
        "routine_tool_pick",
        "multi_factor",
        "frontier_only"
      ]
    },
    "is_spam_or_noise": {
      "type": "noul",
      "instructions": "This step is spam, noise, or a batch of tool calls that should not run (duplicative, irrelevant, or clearly abusive)."
    },
    "options_closed": {
      "type": "noul",
      "instructions": "The permitted options for this fork are fully listed in advance (approve/reject, which tool, spam or not) and none of them requires open-ended generation."
    }
  }
}""")

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 →