jev-fanout

Jev speculative fan-out

Ask every independent judgment over the same state in one POST /v1/systemone. Questions run in parallel and cannot see each other's answers. Code consumes the ones that apply.

Primitives and auth: skills/jev/SKILL.md. Official pattern: https://docs.typesafe.ai/patterns/fan-out

Do this

1. List the judgments the workflow might need, including speculative ones (category, compound, room, device, availability, action per device type).
2. Put each in questions with complete instructions. Write the speculative premise into the question (If this is a light command, …). Question IDs are not sent to the model.
3. Mix choice, score, and noul in that one request. Pin jev-1.13.0 once thresholds are tuned; jev-latest moves.
4. In code, branch on the answers that apply; leave the rest unused.
5. Make a second HTTP call only when the next options or next state cannot be built yet.

Do not

• One question per HTTP call
• Hide five judgments in one Choice
• Assume later questions saw earlier answers

Shape

{
  "state": "I've been trying to connect Stripe for 3 days. I'm losing sales. Help ASAP.",
  "model": "jev-latest",
  "questions": {
    "department": {
      "type": "choice",
      "instructions": "Which team should handle this message?",
      "criteria": {
        "billing": "Payments, invoicing, refunds",
        "technical": "Bugs, outages, integrations",
        "other": "Neither fits"
      }
    },
    "frustration": {
      "type": "score",
      "instructions": "How frustrated does the author appear?",
      "criteria": ["Calm, just stating facts", "Frustrated but civil", "Very angry, strong language"]
    },
    "is_urgent": {
      "type": "noul",
      "instructions": "Does the message convey urgency or time-sensitivity?"
    }
  }
}

This repo

• examples/04_parallel_fanout.py — Choice + Score + Noul in one call
• jev_lab/home.py and /home — ~13 speculative questions, then the dispatcher acts
• packages/js/src/turn.ts — npx jev turn (route + input guard, one call)
• docs/smart-home.md