Drive Bad Barrel from your own code

{ "ok": true,  "data":  { ... } }
{ "ok": false, "error": { "code": "...", "message": "...", "status": 402, "details": { ... } } }

{"task": "sort", "status": "ok", "reason": "", "verdict": "barrel", "lever": "owner",
 "staves": [{"id": "owner", "state": "weak", "note": "..."}, {"id": "rule", "state": "sound", "note": ""}, ...],
 "loop": "...", "tweak": "...", "ask": "", "find_out": "", "closing": "..."}

{
 "task": "sort",
 "snag": "The shared printer is out of paper whenever someone needs to print",
 "setting": "our office floor",
 "people": "12",
 "traces_to_one": "no",
 "staves": "1. owner | It is clear whose job this is | weak\n2. rule | Everyone knows what is expected | sound\n3. easy | Doing it right takes no more effort than skipping it | sound\n4. means | What is needed to do it is right there | weak\n5. seen | When it is left undone, someone notices soon | weak\n6. fair | The work is shared fairly | not sure\n7. time | It does not fall when people are rushed | sound\n8. cost | Nobody loses out by doing it | sound",
 "notes": "The paper is kept in a locked cupboard downstairs."
}

{
 "task": "sort",
 "status": "ok",
 "reason": "",
 "verdict": "barrel",
 "lever": "owner",
 "staves": [
  {
   "id": "owner",
   "state": "weak",
   "note": "Nobody is clearly responsible, so the printer on this floor stays empty."
  },
  {
   "id": "rule",
   "state": "sound",
   "note": ""
  },
  {
   "id": "easy",
   "state": "sound",
   "note": ""
  },
  {
   "id": "means",
   "state": "weak",
   "note": "The paper is locked in a cupboard downstairs, so it is not on hand when needed."
  },
  {
   "id": "seen",
   "state": "weak",
   "note": "No one notices the printer is empty until someone tries to print and finds none."
  },
  {
   "id": "fair",
   "state": "unsure",
   "note": "Check whether restocking paper is shared evenly among the 12 people on this floor."
  },
  {
   "id": "time",
   "state": "sound",
   "note": ""
  },
  {
   "id": "cost",
   "state": "sound",
   "note": ""
  }
 ],
 "loop": "Nobody is responsible, so no one checks the locked-away paper, so it runs out unnoticed, which leaves no one responsible to fix it before it runs out again.",
 "tweak": "Set up a simple sign-up rota on the printer so refilling the paper is clearly someone's job each time.",
 "ask": "",
 "find_out": "",
 "closing": "Right now, this printer problem comes from how the floor's setup works, not one person's choice."
}

{
 "task": "sort",
 "snag": "One meeting room gets booked for the whole day and then sits empty most of it",
 "setting": "a small design studio",
 "people": "9",
 "traces_to_one": "yes",
 "staves": "1. owner | It is clear whose job this is | sound\n2. rule | Everyone knows what is expected | sound\n3. easy | Doing it right takes no more effort than skipping it | weak\n4. means | What is needed to do it is right there | sound\n5. seen | When it is left undone, someone notices soon | weak\n6. fair | The work is shared fairly | sound\n7. time | It does not fall when people are rushed | sound\n8. cost | Nobody loses out by doing it | sound",
 "notes": "Booking a full day is one click; giving the room back means finding the booking and editing it."
}

{
 "task": "sort",
 "status": "ok",
 "reason": "",
 "verdict": "both",
 "lever": "easy",
 "staves": [
  {
   "id": "owner",
   "state": "sound",
   "note": ""
  },
  {
   "id": "rule",
   "state": "sound",
   "note": ""
  },
  {
   "id": "easy",
   "state": "weak",
   "note": "Booking the whole day is one click, but releasing it early takes extra steps."
  },
  {
   "id": "means",
   "state": "sound",
   "note": ""
  },
  {
   "id": "seen",
   "state": "weak",
   "note": "No one notices the room sitting empty until someone else wants to use it."
  },
  {
   "id": "fair",
   "state": "sound",
   "note": ""
  },
  {
   "id": "time",
   "state": "sound",
   "note": ""
  },
  {
   "id": "cost",
   "state": "sound",
   "note": ""
  }
 ],
 "loop": "Booking the whole day is effortless, so the room stays reserved; since no one notices it sitting empty, nothing prompts it to be freed, so the day stays blocked.",
 "tweak": "Make releasing the room as quick as booking it, such as a one-click way to free unused time.",
 "ask": "\"Could you release the room early on days you don't need all of it?\"",
 "find_out": "",
 "closing": "Right now, this empty room comes from both the booking setup and one choice, not one alone."
}

{
 "task": "sort",
 "snag": "The club van comes back with the fuel tank nearly empty",
 "setting": "a weekend hiking club",
 "people": "20",
 "traces_to_one": "yes",
 "staves": "1. owner | It is clear whose job this is | sound\n2. rule | Everyone knows what is expected | sound\n3. easy | Doing it right takes no more effort than skipping it | sound\n4. means | What is needed to do it is right there | sound\n5. seen | When it is left undone, someone notices soon | sound\n6. fair | The work is shared fairly | sound\n7. time | It does not fall when people are rushed | not sure\n8. cost | Nobody loses out by doing it | sound",
 "notes": "There is a fuel card in the glovebox and the sign-out sheet says to refill."
}

{
 "task": "sort",
 "status": "ok",
 "reason": "",
 "verdict": "apple",
 "lever": "time",
 "staves": [
  {
   "id": "owner",
   "state": "sound",
   "note": ""
  },
  {
   "id": "rule",
   "state": "sound",
   "note": ""
  },
  {
   "id": "easy",
   "state": "sound",
   "note": ""
  },
  {
   "id": "means",
   "state": "sound",
   "note": ""
  },
  {
   "id": "seen",
   "state": "sound",
   "note": ""
  },
  {
   "id": "fair",
   "state": "sound",
   "note": ""
  },
  {
   "id": "time",
   "state": "unsure",
   "note": "Check whether returning from a hike leaves enough time to refill before the van is parked."
  },
  {
   "id": "cost",
   "state": "sound",
   "note": ""
  }
 ],
 "loop": "",
 "tweak": "",
 "ask": "\"Could you refill the tank before returning the van?\"",
 "find_out": "",
 "closing": "Right now, this comes down to one choice about refuelling, not a problem with the van's setup."
}

{
 "task": "sort",
 "snag": "The shared fridge fills up with unlabelled food until nothing else fits",
 "setting": "the office kitchen",
 "people": "30",
 "traces_to_one": "not sure",
 "staves": "1. owner | It is clear whose job this is | not sure\n2. rule | Everyone knows what is expected | sound\n3. easy | Doing it right takes no more effort than skipping it | sound\n4. means | What is needed to do it is right there | not sure\n5. seen | When it is left undone, someone notices soon | sound\n6. fair | The work is shared fairly | not sure\n7. time | It does not fall when people are rushed | sound\n8. cost | Nobody loses out by doing it | sound",
 "notes": "none"
}

{
 "task": "sort",
 "status": "ok",
 "reason": "",
 "verdict": "look-closer",
 "lever": "owner",
 "staves": [
  {
   "id": "owner",
   "state": "unsure",
   "note": "Check whether anyone is responsible for clearing unlabelled food from the shared fridge."
  },
  {
   "id": "rule",
   "state": "sound",
   "note": ""
  },
  {
   "id": "easy",
   "state": "sound",
   "note": ""
  },
  {
   "id": "means",
   "state": "unsure",
   "note": "Check whether whatever is needed to label food is readily available by the fridge."
  },
  {
   "id": "seen",
   "state": "sound",
   "note": ""
  },
  {
   "id": "fair",
   "state": "unsure",
   "note": "Check whether keeping the fridge tidy is shared evenly among the 30 people who use it."
  },
  {
   "id": "time",
   "state": "sound",
   "note": ""
  },
  {
   "id": "cost",
   "state": "sound",
   "note": ""
  }
 ],
 "loop": "",
 "tweak": "",
 "ask": "",
 "find_out": "Find out whether anyone is clearly responsible for clearing unlabelled food from the shared fridge.",
 "closing": "Right now, it is not yet clear whether this fridge problem comes from the setup or one choice."
}

{
 "task": "sort",
 "snag": "Boxes keep getting stacked in front of the fire exit after deliveries",
 "setting": "the back corridor of a shop",
 "people": "6",
 "traces_to_one": "not sure",
 "staves": "1. owner | It is clear whose job this is | weak\n2. rule | Everyone knows what is expected | weak\n3. easy | Doing it right takes no more effort than skipping it | weak\n4. means | What is needed to do it is right there | sound\n5. seen | When it is left undone, someone notices soon | sound\n6. fair | The work is shared fairly | sound\n7. time | It does not fall when people are rushed | weak\n8. cost | Nobody loses out by doing it | sound",
 "notes": "none"
}

{
 "task": "sort",
 "status": "declined",
 "reason": "This page only sorts everyday snags; a blocked fire exit is a safety hazard for whoever is responsible for this shop to handle.",
 "verdict": "",
 "lever": "",
 "staves": [],
 "loop": "",
 "tweak": "",
 "ask": "",
 "find_out": "",
 "closing": ""
}

const K = BarrelKit, D = BarrelDraw;
const built = K.buildInput({ snag: "The shared printer is out of paper whenever someone needs to print", setting: "our office floor",
  people: "12", traces: "no", notes: "",
  staves: { owner: "weak", rule: "sound", easy: "sound", means: "weak", seen: "weak", fair: "not sure", time: "sound", cost: "sound" } });
built.prescan.verdict;                   // "barrel" - the page's own rule
built.prescan.lever;                     // "owner"
const wire = K.toWire(built.input);      // POST this to /estimate and /run
// then: const reply = K.normalize(K.parseReply(job.output.output));
// K.check(reply, built).notes           // the page's re-check of the reply
// D.svg({ staves: built.parsed.staves, lever: "owner" })   // the barrel drawing
// K.md(built, reply)                    // the sorted snag as Markdown

BASE="https://api.skillsafe.ai/v1/app-api"
TOKEN="paste-your-token-here"   # from https://bad-barrel.skillsafe.ai/tokens.html
api() { # api METHOD PATH [JSON-BODY]
  curl -s -X "$1" "$BASE$2" -H "Content-Type: application/json" \
    ${TOKEN:+-H "Authorization: Bearer $TOKEN"} ${3:+--data "$3"}
}

# a guest token (enough for /me and /estimate); a run needs your personal token from /tokens.html
TOKEN=$(curl -s -X POST "$BASE/guest" -H "Content-Type: application/json" -d '{"slug":"bad-barrel"}' | jq -r '.data.token')

api GET /me | jq '.data | {subject_type, credits}' 

# input.json: the run input object - {"task": "sort", "snag": "...", "traces_to_one": "no", "staves": "1. owner | ...
2. ..."} - see the field table
api POST /estimate "$(cat input.json)" | jq '.data | {hold_credits, min_credits, model, model_alias, markup_bps, warnings}' 

KEY="bad-barrel:sort:$(shasum -a 256 input.json | cut -c1-16):a1"
JOB=$(curl -s -X POST "$BASE/run" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $KEY" --data @input.json | jq -r '.data.job_id')
while :; do
  J=$(api GET "/jobs/$JOB"); S=$(echo "$J" | jq -r '.data.status')
  case "$S" in succeeded|failed|cancelled) break;; esac; sleep 2
done
echo "$J" | jq -r '.data.output.output' > reply.json   # one JSON object, the reply contract
echo "$J" | jq '.data | {charged_credits, truncated}' 

# Server-Sent Events: tick/delta events while the job runs, then a final event with the job
curl -N -s -X POST "$BASE/run-stream" -H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: bad-barrel:sort:$(shasum -a 256 input.json | cut -c1-16):a1" --data @input.json